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