v1.0.0-pre.3 — First release as @libar-dev/architect

First publication under the new name

This is the first npm release as @libar-dev/architect (renamed from @libar-dev/delivery-process). It includes every change since v1.0.0-pre.2 — the MCP server, annotation rebrand, CLI rename, and six feature PRs.

npm install @libar-dev/architect@1.0.0-pre.3

---

Highlights

MCP Server — 25 tools wrapping the Process Data API, stdio transport, file watcher with 500ms debounce, sub-millisecond dispatch. Ships as the architect-mcp bin entry. (#37)

Full Rebrand — Package renamed, annotation prefix changed from @libar-docs-* to @architect-*, all CLI bins renamed (process-api → architect, lint-process → architect-guard, etc.), MCP tools use architect_* prefix, config file is now architect.config.ts. (#38)

BSL 1.1 Licensing — src/mcp/ directory is now Business Source License 1.1 (converts to MIT after 4 years). All other code remains MIT. LICENSE-MCP added. (#38)

---

What's Changed

Features

• MCP server for native Claude Code / Cursor tool integration — 25 tools, watch mode, in-memory MasterDataset (#37)
• Design review documents auto-generated from spec annotations — sequence + component diagrams, phase-scoped nodes (#34)
• Data API CLI ergonomics — pipeline caching, REPL mode, per-subcommand help, dry-run, metadata queries (#35)
• Documentation consolidation — 5 new codecs, 900+ manual lines replaced by auto-generation, three-tier doc architecture (#32)

Rebrand

• Package renamed from @libar-dev/delivery-process to @libar-dev/architect (#38)
• All annotations, CLI commands, MCP tools, and config use architect naming (#38)
• Backward-compatibility artifacts fully removed (#38)

Process & Planning

• 6 spec closures, 3 new roadmap specs, FSM short-circuit for unlock-reason bypass (#33)
• Pre-rebranding cleanup — refactored shared helpers, improved test coverage, regenerated docs (#36)

---

Migration from @libar-dev/delivery-process

# Remove old package
npm uninstall @libar-dev/delivery-process

# Install new package
npm install @libar-dev/architect@1.0.0-pre.3

Update imports and config:

• delivery-process.config.ts → architect.config.ts
• @libar-docs-* annotations → @architect-*
• CLI commands: process-api → architect, lint-process → architect-guard

Full Changelog: v1.0.0-pre.2...v1.0.0-pre.3

v1.0.0-pre.2

Documentation Consolidation

Replaces manually maintained documentation with auto-generated equivalents driven by annotated source code. Establishes docs-live/ as the single output directory, builds 5 new generation codecs, and reduces manual doc maintenance by ~900 lines.

67 commits across 184 files (+22,184 / -5,442 lines)

Highlights

• Unified output directory — all generated docs now go to docs-live/ (57+ files). docs-generated/ eliminated from tracking.
• 5 new codecs — IndexCodec, CliRecipeGenerator, ProcessApiReferenceGenerator, ClaudeModuleCodec, Architecture generator
• Declarative CLI schema — src/cli/cli-schema.ts is the single source of truth for both runtime help text and generated reference docs
• Session workflows as queryable rules — 7 Rule blocks in session-guides-module-source.feature replace hand-authored CLAUDE.md session content
• loadPreambleFromMarkdown() — editorial content authored as Markdown in docs-sources/, parsed into structured blocks at config time, reducing per-codec config boilerplate by ~540 lines

Manual Docs Impact

Document	Reduction	Generated Replacement
PROCESS-API.md	87%	PROCESS-API-REFERENCE.md + PROCESS-API-RECIPES.md
README.md	72%	Website components + docs-live/INDEX.md hub
CLAUDE.md	38%	Process Data API queries
GHERKIN-PATTERNS.md	29%	Step Linting → VALIDATION.md

New Generated Output

Generator	Output	Lines
IndexCodec	docs-live/INDEX.md	226
CliRecipeGenerator	PROCESS-API-RECIPES.md	476
ProcessApiReferenceGenerator	PROCESS-API-REFERENCE.md	63
Architecture generator	ARCHITECTURE.md	564
Changelog generator	CHANGELOG-GENERATED.md	328

Plus 4 new reference documents: PROCESS-GUARD-REFERENCE.md, SESSION-WORKFLOW-GUIDE.md, ANNOTATION-REFERENCE.md, and enhanced ARCHITECTURE-CODECS.md / ARCHITECTURE-TYPES.md.

Test Coverage

14 new test files (+2,524 lines), all Gherkin .feature + step definitions. Full suite: 4,637 tests passing.

Related: #32

Full Changelog: v1.0.0-pre.1...v1.0.0-pre.2

v1.0.0-pre.1

What's Changed

• Include docs-live/ and docs-generated/ directories in the published npm package

Full Changelog: v1.0.0-pre.0...v1.0.0-pre.1

v1.0.0-pre.0

Context engineering for AI-assisted codebases.

Turn TypeScript annotations and Gherkin specs into a structured, queryable delivery state — living documentation, architecture graphs, and FSM-enforced workflows that AI agents consume without hallucinating.

Install

npm install @libar-dev/delivery-process@pre

Requires Node.js >= 18.0.0 and ESM ("type": "module").

Highlights

• 12 subpath exports — granular imports for scanner, extractor, codecs, validation, taxonomy, and more
• 7 CLI commands — generate-docs, process-api, lint-process, lint-patterns, validate-patterns, lint-steps, generate-tag-taxonomy
• 27 CLI subcommands via the Data API — typed JSON queries for AI coding sessions (Claude Code, Cursor, Copilot Workspace)
• FSM-enforced workflows — lint-process --staged validates status transitions at commit time, not weeks later
• Dual-source architecture — TypeScript annotations own runtime relationships, Gherkin specs own planning constraints
• Codec-based generation — patterns, roadmaps, architecture decisions, product areas, business rules, and more from a single ReferenceDocConfig
• 6 Mermaid diagram types — C4Context, sequence, class, state, flowchart, and dependency graphs generated from @docs-uses and @docs-depends-on annotations
• 3 presets — generic (@docs-*), libar-generic (@libar-docs-*), and ddd-es-cqrs (21 categories for DDD/Event Sourcing)

Proven at Scale

Validated across 422 executable specifications and an 8.8M line monorepo. AI context usage dropped from ~100% to 50-65% during heavy editing sessions. Work completed per session increased 5X. 106 custom ESLint rules replaced with structured specs: 106 → 0.

Quick Start

/** @docs */

/**
 * @docs-pattern UserAuthentication
 * @docs-status roadmap
 * @docs-uses SessionManager, TokenValidator
 */
export class UserAuthentication { /* ... */ }

npx generate-docs -g patterns -i "src/**/*.ts" -o docs -f
npx lint-process --staged

Documentation

Full docs ship with the package and are available in the repo:

• README — Installation and quick start
• ARCHITECTURE — Pipeline, codecs, schemas
• PROCESS-API — Data API CLI reference
• PROCESS-GUARD — FSM enforcement rules
• CONFIGURATION — Presets and custom tags
• METHODOLOGY — Design-first development philosophy

---

npm: https://www.npmjs.com/package/@libar-dev/delivery-process
License: MIT