@libar-dev/architect 1.0.0-pre.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +50 -0
- package/LICENSE +25 -0
- package/LICENSE-MCP +62 -0
- package/README.md +147 -0
- package/dist/api/arch-queries.d.ts +95 -0
- package/dist/api/arch-queries.d.ts.map +1 -0
- package/dist/api/arch-queries.js +310 -0
- package/dist/api/arch-queries.js.map +1 -0
- package/dist/api/context-assembler.d.ts +124 -0
- package/dist/api/context-assembler.d.ts.map +1 -0
- package/dist/api/context-assembler.js +472 -0
- package/dist/api/context-assembler.js.map +1 -0
- package/dist/api/context-formatter.d.ts +26 -0
- package/dist/api/context-formatter.d.ts.map +1 -0
- package/dist/api/context-formatter.js +183 -0
- package/dist/api/context-formatter.js.map +1 -0
- package/dist/api/coverage-analyzer.d.ts +38 -0
- package/dist/api/coverage-analyzer.d.ts.map +1 -0
- package/dist/api/coverage-analyzer.js +117 -0
- package/dist/api/coverage-analyzer.js.map +1 -0
- package/dist/api/fuzzy-match.d.ts +75 -0
- package/dist/api/fuzzy-match.d.ts.map +1 -0
- package/dist/api/fuzzy-match.js +150 -0
- package/dist/api/fuzzy-match.js.map +1 -0
- package/dist/api/handoff-generator.d.ts +45 -0
- package/dist/api/handoff-generator.d.ts.map +1 -0
- package/dist/api/handoff-generator.js +139 -0
- package/dist/api/handoff-generator.js.map +1 -0
- package/dist/api/index.d.ts +61 -0
- package/dist/api/index.d.ts.map +1 -0
- package/dist/api/index.js +54 -0
- package/dist/api/index.js.map +1 -0
- package/dist/api/pattern-helpers.d.ts +51 -0
- package/dist/api/pattern-helpers.d.ts.map +1 -0
- package/dist/api/pattern-helpers.js +84 -0
- package/dist/api/pattern-helpers.js.map +1 -0
- package/dist/api/process-state.d.ts +224 -0
- package/dist/api/process-state.d.ts.map +1 -0
- package/dist/api/process-state.js +308 -0
- package/dist/api/process-state.js.map +1 -0
- package/dist/api/rules-query.d.ts +60 -0
- package/dist/api/rules-query.d.ts.map +1 -0
- package/dist/api/rules-query.js +154 -0
- package/dist/api/rules-query.js.map +1 -0
- package/dist/api/scope-validator.d.ts +56 -0
- package/dist/api/scope-validator.d.ts.map +1 -0
- package/dist/api/scope-validator.js +293 -0
- package/dist/api/scope-validator.js.map +1 -0
- package/dist/api/stub-resolver.d.ts +117 -0
- package/dist/api/stub-resolver.d.ts.map +1 -0
- package/dist/api/stub-resolver.js +154 -0
- package/dist/api/stub-resolver.js.map +1 -0
- package/dist/api/summarize.d.ts +75 -0
- package/dist/api/summarize.d.ts.map +1 -0
- package/dist/api/summarize.js +97 -0
- package/dist/api/summarize.js.map +1 -0
- package/dist/api/types.d.ts +221 -0
- package/dist/api/types.d.ts.map +1 -0
- package/dist/api/types.js +57 -0
- package/dist/api/types.js.map +1 -0
- package/dist/cache/file-cache.d.ts +72 -0
- package/dist/cache/file-cache.d.ts.map +1 -0
- package/dist/cache/file-cache.js +80 -0
- package/dist/cache/file-cache.js.map +1 -0
- package/dist/cache/index.d.ts +5 -0
- package/dist/cache/index.d.ts.map +1 -0
- package/dist/cache/index.js +5 -0
- package/dist/cache/index.js.map +1 -0
- package/dist/cli/cli-schema.d.ts +83 -0
- package/dist/cli/cli-schema.d.ts.map +1 -0
- package/dist/cli/cli-schema.js +505 -0
- package/dist/cli/cli-schema.js.map +1 -0
- package/dist/cli/dataset-cache.d.ts +66 -0
- package/dist/cli/dataset-cache.d.ts.map +1 -0
- package/dist/cli/dataset-cache.js +179 -0
- package/dist/cli/dataset-cache.js.map +1 -0
- package/dist/cli/error-handler.d.ts +84 -0
- package/dist/cli/error-handler.d.ts.map +1 -0
- package/dist/cli/error-handler.js +197 -0
- package/dist/cli/error-handler.js.map +1 -0
- package/dist/cli/generate-docs.d.ts +30 -0
- package/dist/cli/generate-docs.d.ts.map +1 -0
- package/dist/cli/generate-docs.js +370 -0
- package/dist/cli/generate-docs.js.map +1 -0
- package/dist/cli/lint-patterns.d.ts +57 -0
- package/dist/cli/lint-patterns.d.ts.map +1 -0
- package/dist/cli/lint-patterns.js +257 -0
- package/dist/cli/lint-patterns.js.map +1 -0
- package/dist/cli/lint-process.d.ts +54 -0
- package/dist/cli/lint-process.d.ts.map +1 -0
- package/dist/cli/lint-process.js +319 -0
- package/dist/cli/lint-process.js.map +1 -0
- package/dist/cli/lint-steps.d.ts +32 -0
- package/dist/cli/lint-steps.d.ts.map +1 -0
- package/dist/cli/lint-steps.js +172 -0
- package/dist/cli/lint-steps.js.map +1 -0
- package/dist/cli/mcp-server.d.ts +22 -0
- package/dist/cli/mcp-server.d.ts.map +1 -0
- package/dist/cli/mcp-server.js +57 -0
- package/dist/cli/mcp-server.js.map +1 -0
- package/dist/cli/output-pipeline.d.ts +130 -0
- package/dist/cli/output-pipeline.d.ts.map +1 -0
- package/dist/cli/output-pipeline.js +234 -0
- package/dist/cli/output-pipeline.js.map +1 -0
- package/dist/cli/process-api.d.ts +37 -0
- package/dist/cli/process-api.d.ts.map +1 -0
- package/dist/cli/process-api.js +1550 -0
- package/dist/cli/process-api.js.map +1 -0
- package/dist/cli/repl.d.ts +38 -0
- package/dist/cli/repl.d.ts.map +1 -0
- package/dist/cli/repl.js +239 -0
- package/dist/cli/repl.js.map +1 -0
- package/dist/cli/validate-patterns.d.ts +115 -0
- package/dist/cli/validate-patterns.d.ts.map +1 -0
- package/dist/cli/validate-patterns.js +707 -0
- package/dist/cli/validate-patterns.js.map +1 -0
- package/dist/cli/version.d.ts +35 -0
- package/dist/cli/version.d.ts.map +1 -0
- package/dist/cli/version.js +64 -0
- package/dist/cli/version.js.map +1 -0
- package/dist/config/config-loader.d.ts +167 -0
- package/dist/config/config-loader.d.ts.map +1 -0
- package/dist/config/config-loader.js +294 -0
- package/dist/config/config-loader.js.map +1 -0
- package/dist/config/defaults.d.ts +92 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defaults.js +103 -0
- package/dist/config/defaults.js.map +1 -0
- package/dist/config/define-config.d.ts +37 -0
- package/dist/config/define-config.d.ts.map +1 -0
- package/dist/config/define-config.js +38 -0
- package/dist/config/define-config.js.map +1 -0
- package/dist/config/factory.d.ts +79 -0
- package/dist/config/factory.d.ts.map +1 -0
- package/dist/config/factory.js +116 -0
- package/dist/config/factory.js.map +1 -0
- package/dist/config/index.d.ts +45 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +48 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/merge-sources.d.ts +47 -0
- package/dist/config/merge-sources.d.ts.map +1 -0
- package/dist/config/merge-sources.js +61 -0
- package/dist/config/merge-sources.js.map +1 -0
- package/dist/config/presets.d.ts +115 -0
- package/dist/config/presets.d.ts.map +1 -0
- package/dist/config/presets.js +119 -0
- package/dist/config/presets.js.map +1 -0
- package/dist/config/project-config-schema.d.ts +192 -0
- package/dist/config/project-config-schema.d.ts.map +1 -0
- package/dist/config/project-config-schema.js +231 -0
- package/dist/config/project-config-schema.js.map +1 -0
- package/dist/config/project-config.d.ts +229 -0
- package/dist/config/project-config.d.ts.map +1 -0
- package/dist/config/project-config.js +37 -0
- package/dist/config/project-config.js.map +1 -0
- package/dist/config/regex-builders.d.ts +49 -0
- package/dist/config/regex-builders.d.ts.map +1 -0
- package/dist/config/regex-builders.js +85 -0
- package/dist/config/regex-builders.js.map +1 -0
- package/dist/config/resolve-config.d.ts +65 -0
- package/dist/config/resolve-config.d.ts.map +1 -0
- package/dist/config/resolve-config.js +150 -0
- package/dist/config/resolve-config.js.map +1 -0
- package/dist/config/types.d.ts +81 -0
- package/dist/config/types.d.ts.map +1 -0
- package/dist/config/types.js +22 -0
- package/dist/config/types.js.map +1 -0
- package/dist/config/workflow-loader.d.ts +90 -0
- package/dist/config/workflow-loader.d.ts.map +1 -0
- package/dist/config/workflow-loader.js +167 -0
- package/dist/config/workflow-loader.js.map +1 -0
- package/dist/extractor/doc-extractor.d.ts +233 -0
- package/dist/extractor/doc-extractor.d.ts.map +1 -0
- package/dist/extractor/doc-extractor.js +481 -0
- package/dist/extractor/doc-extractor.js.map +1 -0
- package/dist/extractor/dual-source-extractor.d.ts +161 -0
- package/dist/extractor/dual-source-extractor.d.ts.map +1 -0
- package/dist/extractor/dual-source-extractor.js +407 -0
- package/dist/extractor/dual-source-extractor.js.map +1 -0
- package/dist/extractor/gherkin-extractor.d.ts +170 -0
- package/dist/extractor/gherkin-extractor.d.ts.map +1 -0
- package/dist/extractor/gherkin-extractor.js +543 -0
- package/dist/extractor/gherkin-extractor.js.map +1 -0
- package/dist/extractor/index.d.ts +7 -0
- package/dist/extractor/index.d.ts.map +1 -0
- package/dist/extractor/index.js +11 -0
- package/dist/extractor/index.js.map +1 -0
- package/dist/extractor/layer-inference.d.ts +66 -0
- package/dist/extractor/layer-inference.d.ts.map +1 -0
- package/dist/extractor/layer-inference.js +93 -0
- package/dist/extractor/layer-inference.js.map +1 -0
- package/dist/extractor/shape-extractor.d.ts +79 -0
- package/dist/extractor/shape-extractor.d.ts.map +1 -0
- package/dist/extractor/shape-extractor.js +966 -0
- package/dist/extractor/shape-extractor.js.map +1 -0
- package/dist/generators/built-in/cli-recipe-generator.d.ts +30 -0
- package/dist/generators/built-in/cli-recipe-generator.d.ts.map +1 -0
- package/dist/generators/built-in/cli-recipe-generator.js +155 -0
- package/dist/generators/built-in/cli-recipe-generator.js.map +1 -0
- package/dist/generators/built-in/codec-generators.d.ts +29 -0
- package/dist/generators/built-in/codec-generators.d.ts.map +1 -0
- package/dist/generators/built-in/codec-generators.js +195 -0
- package/dist/generators/built-in/codec-generators.js.map +1 -0
- package/dist/generators/built-in/decision-doc-generator.d.ts +204 -0
- package/dist/generators/built-in/decision-doc-generator.d.ts.map +1 -0
- package/dist/generators/built-in/decision-doc-generator.js +654 -0
- package/dist/generators/built-in/decision-doc-generator.js.map +1 -0
- package/dist/generators/built-in/design-review-generator.d.ts +26 -0
- package/dist/generators/built-in/design-review-generator.d.ts.map +1 -0
- package/dist/generators/built-in/design-review-generator.js +94 -0
- package/dist/generators/built-in/design-review-generator.js.map +1 -0
- package/dist/generators/built-in/index.d.ts +22 -0
- package/dist/generators/built-in/index.d.ts.map +1 -0
- package/dist/generators/built-in/index.js +23 -0
- package/dist/generators/built-in/index.js.map +1 -0
- package/dist/generators/built-in/process-api-reference-generator.d.ts +18 -0
- package/dist/generators/built-in/process-api-reference-generator.d.ts.map +1 -0
- package/dist/generators/built-in/process-api-reference-generator.js +85 -0
- package/dist/generators/built-in/process-api-reference-generator.js.map +1 -0
- package/dist/generators/built-in/reference-generators.d.ts +51 -0
- package/dist/generators/built-in/reference-generators.d.ts.map +1 -0
- package/dist/generators/built-in/reference-generators.js +320 -0
- package/dist/generators/built-in/reference-generators.js.map +1 -0
- package/dist/generators/codec-based.d.ts +63 -0
- package/dist/generators/codec-based.d.ts.map +1 -0
- package/dist/generators/codec-based.js +88 -0
- package/dist/generators/codec-based.js.map +1 -0
- package/dist/generators/content-deduplicator.d.ts +114 -0
- package/dist/generators/content-deduplicator.d.ts.map +1 -0
- package/dist/generators/content-deduplicator.js +356 -0
- package/dist/generators/content-deduplicator.js.map +1 -0
- package/dist/generators/index.d.ts +50 -0
- package/dist/generators/index.d.ts.map +1 -0
- package/dist/generators/index.js +54 -0
- package/dist/generators/index.js.map +1 -0
- package/dist/generators/orchestrator.d.ts +265 -0
- package/dist/generators/orchestrator.d.ts.map +1 -0
- package/dist/generators/orchestrator.js +570 -0
- package/dist/generators/orchestrator.js.map +1 -0
- package/dist/generators/pipeline/build-pipeline.d.ts +131 -0
- package/dist/generators/pipeline/build-pipeline.d.ts.map +1 -0
- package/dist/generators/pipeline/build-pipeline.js +248 -0
- package/dist/generators/pipeline/build-pipeline.js.map +1 -0
- package/dist/generators/pipeline/context-inference.d.ts +55 -0
- package/dist/generators/pipeline/context-inference.d.ts.map +1 -0
- package/dist/generators/pipeline/context-inference.js +76 -0
- package/dist/generators/pipeline/context-inference.js.map +1 -0
- package/dist/generators/pipeline/index.d.ts +27 -0
- package/dist/generators/pipeline/index.d.ts.map +1 -0
- package/dist/generators/pipeline/index.js +34 -0
- package/dist/generators/pipeline/index.js.map +1 -0
- package/dist/generators/pipeline/merge-patterns.d.ts +33 -0
- package/dist/generators/pipeline/merge-patterns.d.ts.map +1 -0
- package/dist/generators/pipeline/merge-patterns.js +50 -0
- package/dist/generators/pipeline/merge-patterns.js.map +1 -0
- package/dist/generators/pipeline/relationship-resolver.d.ts +47 -0
- package/dist/generators/pipeline/relationship-resolver.d.ts.map +1 -0
- package/dist/generators/pipeline/relationship-resolver.js +132 -0
- package/dist/generators/pipeline/relationship-resolver.js.map +1 -0
- package/dist/generators/pipeline/sequence-utils.d.ts +49 -0
- package/dist/generators/pipeline/sequence-utils.d.ts.map +1 -0
- package/dist/generators/pipeline/sequence-utils.js +235 -0
- package/dist/generators/pipeline/sequence-utils.js.map +1 -0
- package/dist/generators/pipeline/transform-dataset.d.ts +82 -0
- package/dist/generators/pipeline/transform-dataset.d.ts.map +1 -0
- package/dist/generators/pipeline/transform-dataset.js +355 -0
- package/dist/generators/pipeline/transform-dataset.js.map +1 -0
- package/dist/generators/pipeline/transform-types.d.ts +96 -0
- package/dist/generators/pipeline/transform-types.d.ts.map +1 -0
- package/dist/generators/pipeline/transform-types.js +18 -0
- package/dist/generators/pipeline/transform-types.js.map +1 -0
- package/dist/generators/registry.d.ts +64 -0
- package/dist/generators/registry.d.ts.map +1 -0
- package/dist/generators/registry.js +77 -0
- package/dist/generators/registry.js.map +1 -0
- package/dist/generators/source-mapper.d.ts +143 -0
- package/dist/generators/source-mapper.d.ts.map +1 -0
- package/dist/generators/source-mapper.js +602 -0
- package/dist/generators/source-mapper.js.map +1 -0
- package/dist/generators/source-mapping-validator.d.ts +118 -0
- package/dist/generators/source-mapping-validator.d.ts.map +1 -0
- package/dist/generators/source-mapping-validator.js +334 -0
- package/dist/generators/source-mapping-validator.js.map +1 -0
- package/dist/generators/types.d.ts +104 -0
- package/dist/generators/types.d.ts.map +1 -0
- package/dist/generators/types.js +5 -0
- package/dist/generators/types.js.map +1 -0
- package/dist/generators/warning-collector.d.ts +144 -0
- package/dist/generators/warning-collector.d.ts.map +1 -0
- package/dist/generators/warning-collector.js +166 -0
- package/dist/generators/warning-collector.js.map +1 -0
- package/dist/git/branch-diff.d.ts +44 -0
- package/dist/git/branch-diff.d.ts.map +1 -0
- package/dist/git/branch-diff.js +57 -0
- package/dist/git/branch-diff.js.map +1 -0
- package/dist/git/helpers.d.ts +46 -0
- package/dist/git/helpers.d.ts.map +1 -0
- package/dist/git/helpers.js +67 -0
- package/dist/git/helpers.js.map +1 -0
- package/dist/git/index.d.ts +18 -0
- package/dist/git/index.d.ts.map +1 -0
- package/dist/git/index.js +18 -0
- package/dist/git/index.js.map +1 -0
- package/dist/git/name-status.d.ts +32 -0
- package/dist/git/name-status.d.ts.map +1 -0
- package/dist/git/name-status.js +66 -0
- package/dist/git/name-status.js.map +1 -0
- package/dist/index.d.ts +107 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +122 -0
- package/dist/index.js.map +1 -0
- package/dist/lint/engine.d.ts +113 -0
- package/dist/lint/engine.d.ts.map +1 -0
- package/dist/lint/engine.js +228 -0
- package/dist/lint/engine.js.map +1 -0
- package/dist/lint/index.d.ts +26 -0
- package/dist/lint/index.d.ts.map +1 -0
- package/dist/lint/index.js +24 -0
- package/dist/lint/index.js.map +1 -0
- package/dist/lint/process-guard/decider.d.ts +166 -0
- package/dist/lint/process-guard/decider.d.ts.map +1 -0
- package/dist/lint/process-guard/decider.js +412 -0
- package/dist/lint/process-guard/decider.js.map +1 -0
- package/dist/lint/process-guard/derive-state.d.ts +96 -0
- package/dist/lint/process-guard/derive-state.d.ts.map +1 -0
- package/dist/lint/process-guard/derive-state.js +368 -0
- package/dist/lint/process-guard/derive-state.js.map +1 -0
- package/dist/lint/process-guard/detect-changes.d.ts +109 -0
- package/dist/lint/process-guard/detect-changes.d.ts.map +1 -0
- package/dist/lint/process-guard/detect-changes.js +487 -0
- package/dist/lint/process-guard/detect-changes.js.map +1 -0
- package/dist/lint/process-guard/index.d.ts +35 -0
- package/dist/lint/process-guard/index.d.ts.map +1 -0
- package/dist/lint/process-guard/index.js +39 -0
- package/dist/lint/process-guard/index.js.map +1 -0
- package/dist/lint/process-guard/types.d.ts +255 -0
- package/dist/lint/process-guard/types.d.ts.map +1 -0
- package/dist/lint/process-guard/types.js +31 -0
- package/dist/lint/process-guard/types.js.map +1 -0
- package/dist/lint/rules.d.ts +147 -0
- package/dist/lint/rules.d.ts.map +1 -0
- package/dist/lint/rules.js +289 -0
- package/dist/lint/rules.js.map +1 -0
- package/dist/lint/steps/cross-checks.d.ts +66 -0
- package/dist/lint/steps/cross-checks.d.ts.map +1 -0
- package/dist/lint/steps/cross-checks.js +290 -0
- package/dist/lint/steps/cross-checks.js.map +1 -0
- package/dist/lint/steps/feature-checks.d.ts +78 -0
- package/dist/lint/steps/feature-checks.d.ts.map +1 -0
- package/dist/lint/steps/feature-checks.js +279 -0
- package/dist/lint/steps/feature-checks.js.map +1 -0
- package/dist/lint/steps/index.d.ts +22 -0
- package/dist/lint/steps/index.d.ts.map +1 -0
- package/dist/lint/steps/index.js +26 -0
- package/dist/lint/steps/index.js.map +1 -0
- package/dist/lint/steps/pair-resolver.d.ts +29 -0
- package/dist/lint/steps/pair-resolver.d.ts.map +1 -0
- package/dist/lint/steps/pair-resolver.js +76 -0
- package/dist/lint/steps/pair-resolver.js.map +1 -0
- package/dist/lint/steps/runner.d.ts +28 -0
- package/dist/lint/steps/runner.d.ts.map +1 -0
- package/dist/lint/steps/runner.js +143 -0
- package/dist/lint/steps/runner.js.map +1 -0
- package/dist/lint/steps/step-checks.d.ts +41 -0
- package/dist/lint/steps/step-checks.d.ts.map +1 -0
- package/dist/lint/steps/step-checks.js +164 -0
- package/dist/lint/steps/step-checks.js.map +1 -0
- package/dist/lint/steps/types.d.ts +95 -0
- package/dist/lint/steps/types.d.ts.map +1 -0
- package/dist/lint/steps/types.js +79 -0
- package/dist/lint/steps/types.js.map +1 -0
- package/dist/lint/steps/utils.d.ts +22 -0
- package/dist/lint/steps/utils.d.ts.map +1 -0
- package/dist/lint/steps/utils.js +57 -0
- package/dist/lint/steps/utils.js.map +1 -0
- package/dist/mcp/file-watcher.d.ts +24 -0
- package/dist/mcp/file-watcher.d.ts.map +1 -0
- package/dist/mcp/file-watcher.js +75 -0
- package/dist/mcp/file-watcher.js.map +1 -0
- package/dist/mcp/index.d.ts +19 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +21 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/pipeline-session.d.ts +33 -0
- package/dist/mcp/pipeline-session.d.ts.map +1 -0
- package/dist/mcp/pipeline-session.js +149 -0
- package/dist/mcp/pipeline-session.js.map +1 -0
- package/dist/mcp/server.d.ts +28 -0
- package/dist/mcp/server.d.ts.map +1 -0
- package/dist/mcp/server.js +197 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/tool-registry.d.ts +4 -0
- package/dist/mcp/tool-registry.d.ts.map +1 -0
- package/dist/mcp/tool-registry.js +525 -0
- package/dist/mcp/tool-registry.js.map +1 -0
- package/dist/renderable/codecs/adr.d.ts +4730 -0
- package/dist/renderable/codecs/adr.d.ts.map +1 -0
- package/dist/renderable/codecs/adr.js +590 -0
- package/dist/renderable/codecs/adr.js.map +1 -0
- package/dist/renderable/codecs/architecture.d.ts +4760 -0
- package/dist/renderable/codecs/architecture.d.ts.map +1 -0
- package/dist/renderable/codecs/architecture.js +524 -0
- package/dist/renderable/codecs/architecture.js.map +1 -0
- package/dist/renderable/codecs/business-rules.d.ts +4777 -0
- package/dist/renderable/codecs/business-rules.d.ts.map +1 -0
- package/dist/renderable/codecs/business-rules.js +648 -0
- package/dist/renderable/codecs/business-rules.js.map +1 -0
- package/dist/renderable/codecs/claude-module.d.ts +4710 -0
- package/dist/renderable/codecs/claude-module.d.ts.map +1 -0
- package/dist/renderable/codecs/claude-module.js +214 -0
- package/dist/renderable/codecs/claude-module.js.map +1 -0
- package/dist/renderable/codecs/composite.d.ts +84 -0
- package/dist/renderable/codecs/composite.d.ts.map +1 -0
- package/dist/renderable/codecs/composite.js +124 -0
- package/dist/renderable/codecs/composite.js.map +1 -0
- package/dist/renderable/codecs/convention-extractor.d.ts +105 -0
- package/dist/renderable/codecs/convention-extractor.d.ts.map +1 -0
- package/dist/renderable/codecs/convention-extractor.js +353 -0
- package/dist/renderable/codecs/convention-extractor.js.map +1 -0
- package/dist/renderable/codecs/decision-doc.d.ts +308 -0
- package/dist/renderable/codecs/decision-doc.d.ts.map +1 -0
- package/dist/renderable/codecs/decision-doc.js +485 -0
- package/dist/renderable/codecs/decision-doc.js.map +1 -0
- package/dist/renderable/codecs/design-review.d.ts +55 -0
- package/dist/renderable/codecs/design-review.d.ts.map +1 -0
- package/dist/renderable/codecs/design-review.js +532 -0
- package/dist/renderable/codecs/design-review.js.map +1 -0
- package/dist/renderable/codecs/diagram-utils.d.ts +62 -0
- package/dist/renderable/codecs/diagram-utils.d.ts.map +1 -0
- package/dist/renderable/codecs/diagram-utils.js +70 -0
- package/dist/renderable/codecs/diagram-utils.js.map +1 -0
- package/dist/renderable/codecs/helpers.d.ts +553 -0
- package/dist/renderable/codecs/helpers.d.ts.map +1 -0
- package/dist/renderable/codecs/helpers.js +913 -0
- package/dist/renderable/codecs/helpers.js.map +1 -0
- package/dist/renderable/codecs/index-codec.d.ts +4714 -0
- package/dist/renderable/codecs/index-codec.d.ts.map +1 -0
- package/dist/renderable/codecs/index-codec.js +250 -0
- package/dist/renderable/codecs/index-codec.js.map +1 -0
- package/dist/renderable/codecs/index.d.ts +46 -0
- package/dist/renderable/codecs/index.d.ts.map +1 -0
- package/dist/renderable/codecs/index.js +70 -0
- package/dist/renderable/codecs/index.js.map +1 -0
- package/dist/renderable/codecs/patterns.d.ts +4757 -0
- package/dist/renderable/codecs/patterns.d.ts.map +1 -0
- package/dist/renderable/codecs/patterns.js +462 -0
- package/dist/renderable/codecs/patterns.js.map +1 -0
- package/dist/renderable/codecs/planning.d.ts +14055 -0
- package/dist/renderable/codecs/planning.d.ts.map +1 -0
- package/dist/renderable/codecs/planning.js +449 -0
- package/dist/renderable/codecs/planning.js.map +1 -0
- package/dist/renderable/codecs/pr-changes.d.ts +4742 -0
- package/dist/renderable/codecs/pr-changes.d.ts.map +1 -0
- package/dist/renderable/codecs/pr-changes.js +425 -0
- package/dist/renderable/codecs/pr-changes.js.map +1 -0
- package/dist/renderable/codecs/reference.d.ts +215 -0
- package/dist/renderable/codecs/reference.d.ts.map +1 -0
- package/dist/renderable/codecs/reference.js +1578 -0
- package/dist/renderable/codecs/reference.js.map +1 -0
- package/dist/renderable/codecs/reporting.d.ts +14026 -0
- package/dist/renderable/codecs/reporting.d.ts.map +1 -0
- package/dist/renderable/codecs/reporting.js +365 -0
- package/dist/renderable/codecs/reporting.js.map +1 -0
- package/dist/renderable/codecs/requirements.d.ts +4743 -0
- package/dist/renderable/codecs/requirements.d.ts.map +1 -0
- package/dist/renderable/codecs/requirements.js +428 -0
- package/dist/renderable/codecs/requirements.js.map +1 -0
- package/dist/renderable/codecs/session.d.ts +9410 -0
- package/dist/renderable/codecs/session.d.ts.map +1 -0
- package/dist/renderable/codecs/session.js +848 -0
- package/dist/renderable/codecs/session.js.map +1 -0
- package/dist/renderable/codecs/shape-matcher.d.ts +54 -0
- package/dist/renderable/codecs/shape-matcher.d.ts.map +1 -0
- package/dist/renderable/codecs/shape-matcher.js +106 -0
- package/dist/renderable/codecs/shape-matcher.js.map +1 -0
- package/dist/renderable/codecs/shared-schema.d.ts +44 -0
- package/dist/renderable/codecs/shared-schema.d.ts.map +1 -0
- package/dist/renderable/codecs/shared-schema.js +43 -0
- package/dist/renderable/codecs/shared-schema.js.map +1 -0
- package/dist/renderable/codecs/taxonomy.d.ts +4733 -0
- package/dist/renderable/codecs/taxonomy.d.ts.map +1 -0
- package/dist/renderable/codecs/taxonomy.js +570 -0
- package/dist/renderable/codecs/taxonomy.js.map +1 -0
- package/dist/renderable/codecs/timeline.d.ts +14094 -0
- package/dist/renderable/codecs/timeline.d.ts.map +1 -0
- package/dist/renderable/codecs/timeline.js +906 -0
- package/dist/renderable/codecs/timeline.js.map +1 -0
- package/dist/renderable/codecs/types/base.d.ts +81 -0
- package/dist/renderable/codecs/types/base.d.ts.map +1 -0
- package/dist/renderable/codecs/types/base.js +56 -0
- package/dist/renderable/codecs/types/base.js.map +1 -0
- package/dist/renderable/codecs/types/index.d.ts +5 -0
- package/dist/renderable/codecs/types/index.d.ts.map +1 -0
- package/dist/renderable/codecs/types/index.js +5 -0
- package/dist/renderable/codecs/types/index.js.map +1 -0
- package/dist/renderable/codecs/validation-rules.d.ts +4773 -0
- package/dist/renderable/codecs/validation-rules.d.ts.map +1 -0
- package/dist/renderable/codecs/validation-rules.js +537 -0
- package/dist/renderable/codecs/validation-rules.js.map +1 -0
- package/dist/renderable/generate.d.ts +338 -0
- package/dist/renderable/generate.d.ts.map +1 -0
- package/dist/renderable/generate.js +437 -0
- package/dist/renderable/generate.js.map +1 -0
- package/dist/renderable/index.d.ts +36 -0
- package/dist/renderable/index.d.ts.map +1 -0
- package/dist/renderable/index.js +58 -0
- package/dist/renderable/index.js.map +1 -0
- package/dist/renderable/load-preamble.d.ts +56 -0
- package/dist/renderable/load-preamble.d.ts.map +1 -0
- package/dist/renderable/load-preamble.js +298 -0
- package/dist/renderable/load-preamble.js.map +1 -0
- package/dist/renderable/render.d.ts +61 -0
- package/dist/renderable/render.d.ts.map +1 -0
- package/dist/renderable/render.js +346 -0
- package/dist/renderable/render.js.map +1 -0
- package/dist/renderable/schema.d.ts +194 -0
- package/dist/renderable/schema.d.ts.map +1 -0
- package/dist/renderable/schema.js +197 -0
- package/dist/renderable/schema.js.map +1 -0
- package/dist/renderable/utils.d.ts +146 -0
- package/dist/renderable/utils.d.ts.map +1 -0
- package/dist/renderable/utils.js +362 -0
- package/dist/renderable/utils.js.map +1 -0
- package/dist/scanner/ast-parser.d.ts +75 -0
- package/dist/scanner/ast-parser.d.ts.map +1 -0
- package/dist/scanner/ast-parser.js +835 -0
- package/dist/scanner/ast-parser.js.map +1 -0
- package/dist/scanner/gherkin-ast-parser.d.ts +166 -0
- package/dist/scanner/gherkin-ast-parser.d.ts.map +1 -0
- package/dist/scanner/gherkin-ast-parser.js +507 -0
- package/dist/scanner/gherkin-ast-parser.js.map +1 -0
- package/dist/scanner/gherkin-scanner.d.ts +106 -0
- package/dist/scanner/gherkin-scanner.d.ts.map +1 -0
- package/dist/scanner/gherkin-scanner.js +149 -0
- package/dist/scanner/gherkin-scanner.js.map +1 -0
- package/dist/scanner/index.d.ts +85 -0
- package/dist/scanner/index.d.ts.map +1 -0
- package/dist/scanner/index.js +102 -0
- package/dist/scanner/index.js.map +1 -0
- package/dist/scanner/pattern-scanner.d.ts +83 -0
- package/dist/scanner/pattern-scanner.d.ts.map +1 -0
- package/dist/scanner/pattern-scanner.js +110 -0
- package/dist/scanner/pattern-scanner.js.map +1 -0
- package/dist/taxonomy/categories.d.ts +47 -0
- package/dist/taxonomy/categories.d.ts.map +1 -0
- package/dist/taxonomy/categories.js +175 -0
- package/dist/taxonomy/categories.js.map +1 -0
- package/dist/taxonomy/claude-section-values.d.ts +12 -0
- package/dist/taxonomy/claude-section-values.d.ts.map +1 -0
- package/dist/taxonomy/claude-section-values.js +17 -0
- package/dist/taxonomy/claude-section-values.js.map +1 -0
- package/dist/taxonomy/conventions.d.ts +13 -0
- package/dist/taxonomy/conventions.d.ts.map +1 -0
- package/dist/taxonomy/conventions.js +27 -0
- package/dist/taxonomy/conventions.js.map +1 -0
- package/dist/taxonomy/deliverable-status.d.ts +99 -0
- package/dist/taxonomy/deliverable-status.d.ts.map +1 -0
- package/dist/taxonomy/deliverable-status.js +131 -0
- package/dist/taxonomy/deliverable-status.js.map +1 -0
- package/dist/taxonomy/format-types.d.ts +17 -0
- package/dist/taxonomy/format-types.d.ts.map +1 -0
- package/dist/taxonomy/format-types.js +23 -0
- package/dist/taxonomy/format-types.js.map +1 -0
- package/dist/taxonomy/generator-options.d.ts +67 -0
- package/dist/taxonomy/generator-options.d.ts.map +1 -0
- package/dist/taxonomy/generator-options.js +75 -0
- package/dist/taxonomy/generator-options.js.map +1 -0
- package/dist/taxonomy/hierarchy-levels.d.ts +23 -0
- package/dist/taxonomy/hierarchy-levels.d.ts.map +1 -0
- package/dist/taxonomy/hierarchy-levels.js +22 -0
- package/dist/taxonomy/hierarchy-levels.js.map +1 -0
- package/dist/taxonomy/index.d.ts +35 -0
- package/dist/taxonomy/index.d.ts.map +1 -0
- package/dist/taxonomy/index.js +56 -0
- package/dist/taxonomy/index.js.map +1 -0
- package/dist/taxonomy/layer-types.d.ts +22 -0
- package/dist/taxonomy/layer-types.d.ts.map +1 -0
- package/dist/taxonomy/layer-types.js +28 -0
- package/dist/taxonomy/layer-types.js.map +1 -0
- package/dist/taxonomy/normalized-status.d.ts +99 -0
- package/dist/taxonomy/normalized-status.d.ts.map +1 -0
- package/dist/taxonomy/normalized-status.js +113 -0
- package/dist/taxonomy/normalized-status.js.map +1 -0
- package/dist/taxonomy/registry-builder.d.ts +104 -0
- package/dist/taxonomy/registry-builder.d.ts.map +1 -0
- package/dist/taxonomy/registry-builder.js +561 -0
- package/dist/taxonomy/registry-builder.js.map +1 -0
- package/dist/taxonomy/risk-levels.d.ts +16 -0
- package/dist/taxonomy/risk-levels.d.ts.map +1 -0
- package/dist/taxonomy/risk-levels.js +15 -0
- package/dist/taxonomy/risk-levels.js.map +1 -0
- package/dist/taxonomy/severity-types.d.ts +6 -0
- package/dist/taxonomy/severity-types.d.ts.map +1 -0
- package/dist/taxonomy/severity-types.js +5 -0
- package/dist/taxonomy/severity-types.js.map +1 -0
- package/dist/taxonomy/status-values.d.ts +39 -0
- package/dist/taxonomy/status-values.d.ts.map +1 -0
- package/dist/taxonomy/status-values.js +42 -0
- package/dist/taxonomy/status-values.js.map +1 -0
- package/dist/types/branded.d.ts +89 -0
- package/dist/types/branded.d.ts.map +1 -0
- package/dist/types/branded.js +57 -0
- package/dist/types/branded.js.map +1 -0
- package/dist/types/errors.d.ts +342 -0
- package/dist/types/errors.d.ts.map +1 -0
- package/dist/types/errors.js +251 -0
- package/dist/types/errors.js.map +1 -0
- package/dist/types/index.d.ts +41 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +5 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/result.d.ts +78 -0
- package/dist/types/result.d.ts.map +1 -0
- package/dist/types/result.js +78 -0
- package/dist/types/result.js.map +1 -0
- package/dist/utils/collection-utils.d.ts +49 -0
- package/dist/utils/collection-utils.d.ts.map +1 -0
- package/dist/utils/collection-utils.js +58 -0
- package/dist/utils/collection-utils.js.map +1 -0
- package/dist/utils/id-utils.d.ts +46 -0
- package/dist/utils/id-utils.d.ts.map +1 -0
- package/dist/utils/id-utils.js +51 -0
- package/dist/utils/id-utils.js.map +1 -0
- package/dist/utils/index.d.ts +21 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +21 -0
- package/dist/utils/index.js.map +1 -0
- package/dist/utils/string-utils.d.ts +150 -0
- package/dist/utils/string-utils.d.ts.map +1 -0
- package/dist/utils/string-utils.js +281 -0
- package/dist/utils/string-utils.js.map +1 -0
- package/dist/validation/anti-patterns.d.ts +134 -0
- package/dist/validation/anti-patterns.d.ts.map +1 -0
- package/dist/validation/anti-patterns.js +307 -0
- package/dist/validation/anti-patterns.js.map +1 -0
- package/dist/validation/dod-validator.d.ts +94 -0
- package/dist/validation/dod-validator.d.ts.map +1 -0
- package/dist/validation/dod-validator.js +198 -0
- package/dist/validation/dod-validator.js.map +1 -0
- package/dist/validation/fsm/index.d.ts +59 -0
- package/dist/validation/fsm/index.d.ts.map +1 -0
- package/dist/validation/fsm/index.js +64 -0
- package/dist/validation/fsm/index.js.map +1 -0
- package/dist/validation/fsm/states.d.ts +93 -0
- package/dist/validation/fsm/states.d.ts.map +1 -0
- package/dist/validation/fsm/states.js +98 -0
- package/dist/validation/fsm/states.js.map +1 -0
- package/dist/validation/fsm/transitions.d.ts +100 -0
- package/dist/validation/fsm/transitions.d.ts.map +1 -0
- package/dist/validation/fsm/transitions.js +122 -0
- package/dist/validation/fsm/transitions.js.map +1 -0
- package/dist/validation/fsm/validator.d.ts +163 -0
- package/dist/validation/fsm/validator.d.ts.map +1 -0
- package/dist/validation/fsm/validator.js +205 -0
- package/dist/validation/fsm/validator.js.map +1 -0
- package/dist/validation/index.d.ts +23 -0
- package/dist/validation/index.d.ts.map +1 -0
- package/dist/validation/index.js +25 -0
- package/dist/validation/index.js.map +1 -0
- package/dist/validation/types.d.ts +136 -0
- package/dist/validation/types.d.ts.map +1 -0
- package/dist/validation/types.js +56 -0
- package/dist/validation/types.js.map +1 -0
- package/dist/validation-schemas/codec-utils.d.ts +188 -0
- package/dist/validation-schemas/codec-utils.d.ts.map +1 -0
- package/dist/validation-schemas/codec-utils.js +258 -0
- package/dist/validation-schemas/codec-utils.js.map +1 -0
- package/dist/validation-schemas/config.d.ts +99 -0
- package/dist/validation-schemas/config.d.ts.map +1 -0
- package/dist/validation-schemas/config.js +178 -0
- package/dist/validation-schemas/config.js.map +1 -0
- package/dist/validation-schemas/doc-directive.d.ts +195 -0
- package/dist/validation-schemas/doc-directive.d.ts.map +1 -0
- package/dist/validation-schemas/doc-directive.js +239 -0
- package/dist/validation-schemas/doc-directive.js.map +1 -0
- package/dist/validation-schemas/dual-source.d.ts +167 -0
- package/dist/validation-schemas/dual-source.d.ts.map +1 -0
- package/dist/validation-schemas/dual-source.js +168 -0
- package/dist/validation-schemas/dual-source.js.map +1 -0
- package/dist/validation-schemas/export-info.d.ts +53 -0
- package/dist/validation-schemas/export-info.d.ts.map +1 -0
- package/dist/validation-schemas/export-info.js +101 -0
- package/dist/validation-schemas/export-info.js.map +1 -0
- package/dist/validation-schemas/extracted-pattern.d.ts +351 -0
- package/dist/validation-schemas/extracted-pattern.d.ts.map +1 -0
- package/dist/validation-schemas/extracted-pattern.js +459 -0
- package/dist/validation-schemas/extracted-pattern.js.map +1 -0
- package/dist/validation-schemas/extracted-shape.d.ts +200 -0
- package/dist/validation-schemas/extracted-shape.d.ts.map +1 -0
- package/dist/validation-schemas/extracted-shape.js +182 -0
- package/dist/validation-schemas/extracted-shape.js.map +1 -0
- package/dist/validation-schemas/feature.d.ts +554 -0
- package/dist/validation-schemas/feature.d.ts.map +1 -0
- package/dist/validation-schemas/feature.js +262 -0
- package/dist/validation-schemas/feature.js.map +1 -0
- package/dist/validation-schemas/index.d.ts +15 -0
- package/dist/validation-schemas/index.d.ts.map +1 -0
- package/dist/validation-schemas/index.js +32 -0
- package/dist/validation-schemas/index.js.map +1 -0
- package/dist/validation-schemas/lint.d.ts +46 -0
- package/dist/validation-schemas/lint.d.ts.map +1 -0
- package/dist/validation-schemas/lint.js +45 -0
- package/dist/validation-schemas/lint.js.map +1 -0
- package/dist/validation-schemas/master-dataset.d.ts +8299 -0
- package/dist/validation-schemas/master-dataset.d.ts.map +1 -0
- package/dist/validation-schemas/master-dataset.js +275 -0
- package/dist/validation-schemas/master-dataset.js.map +1 -0
- package/dist/validation-schemas/output-schemas.d.ts +183 -0
- package/dist/validation-schemas/output-schemas.d.ts.map +1 -0
- package/dist/validation-schemas/output-schemas.js +149 -0
- package/dist/validation-schemas/output-schemas.js.map +1 -0
- package/dist/validation-schemas/scenario-ref.d.ts +80 -0
- package/dist/validation-schemas/scenario-ref.d.ts.map +1 -0
- package/dist/validation-schemas/scenario-ref.js +73 -0
- package/dist/validation-schemas/scenario-ref.js.map +1 -0
- package/dist/validation-schemas/tag-registry.d.ts +210 -0
- package/dist/validation-schemas/tag-registry.d.ts.map +1 -0
- package/dist/validation-schemas/tag-registry.js +248 -0
- package/dist/validation-schemas/tag-registry.js.map +1 -0
- package/dist/validation-schemas/workflow-config.d.ts +125 -0
- package/dist/validation-schemas/workflow-config.d.ts.map +1 -0
- package/dist/validation-schemas/workflow-config.js +138 -0
- package/dist/validation-schemas/workflow-config.js.map +1 -0
- package/docs/ANNOTATION-GUIDE.md +271 -0
- package/docs/ARCHITECTURE.md +1636 -0
- package/docs/CONFIGURATION.md +337 -0
- package/docs/DOCS-GAP-ANALYSIS.md +811 -0
- package/docs/GHERKIN-PATTERNS.md +366 -0
- package/docs/INDEX.md +345 -0
- package/docs/MCP-SETUP.md +140 -0
- package/docs/METHODOLOGY.md +240 -0
- package/docs/PROCESS-API.md +65 -0
- package/docs/PROCESS-GUARD.md +341 -0
- package/docs/SESSION-GUIDES.md +391 -0
- package/docs/TAXONOMY.md +106 -0
- package/docs/VALIDATION.md +418 -0
- package/docs-live/ARCHITECTURE.md +362 -0
- package/docs-live/BUSINESS-RULES.md +24 -0
- package/docs-live/CHANGELOG-GENERATED.md +375 -0
- package/docs-live/DECISIONS.md +78 -0
- package/docs-live/INDEX.md +231 -0
- package/docs-live/PRODUCT-AREAS.md +255 -0
- package/docs-live/TAXONOMY.md +202 -0
- package/docs-live/VALIDATION-RULES.md +119 -0
- package/docs-live/_claude-md/annotation/annotation-overview.md +26 -0
- package/docs-live/_claude-md/annotation/annotation-reference.md +213 -0
- package/docs-live/_claude-md/architecture/architecture-codecs.md +160 -0
- package/docs-live/_claude-md/architecture/architecture-types.md +32 -0
- package/docs-live/_claude-md/architecture/reference-sample.md +162 -0
- package/docs-live/_claude-md/authoring/gherkin-authoring-guide.md +245 -0
- package/docs-live/_claude-md/configuration/configuration-guide.md +216 -0
- package/docs-live/_claude-md/configuration/configuration-overview.md +37 -0
- package/docs-live/_claude-md/core-types/core-types-overview.md +20 -0
- package/docs-live/_claude-md/data-api/data-api-overview.md +39 -0
- package/docs-live/_claude-md/generation/generation-overview.md +30 -0
- package/docs-live/_claude-md/process/process-overview.md +127 -0
- package/docs-live/_claude-md/validation/process-guard.md +185 -0
- package/docs-live/_claude-md/validation/validation-overview.md +37 -0
- package/docs-live/_claude-md/validation/validation-tools-guide.md +242 -0
- package/docs-live/_claude-md/workflow/session-workflow-guide.md +141 -0
- package/docs-live/business-rules/annotation.md +1462 -0
- package/docs-live/business-rules/configuration.md +465 -0
- package/docs-live/business-rules/core-types.md +531 -0
- package/docs-live/business-rules/data-api.md +1403 -0
- package/docs-live/business-rules/generation.md +4726 -0
- package/docs-live/business-rules/process.md +122 -0
- package/docs-live/business-rules/validation.md +998 -0
- package/docs-live/decisions/adr-001-taxonomy-canonical-values.md +197 -0
- package/docs-live/decisions/adr-002-gherkin-only-testing.md +57 -0
- package/docs-live/decisions/adr-003-source-first-pattern-architecture.md +147 -0
- package/docs-live/decisions/adr-004-session-workflow-commands.md +137 -0
- package/docs-live/decisions/adr-005-codec-based-markdown-rendering.md +150 -0
- package/docs-live/decisions/adr-006-single-read-model-architecture.md +136 -0
- package/docs-live/decisions/adr-021-doc-generation-proof-of-concept.md +489 -0
- package/docs-live/product-areas/ANNOTATION.md +591 -0
- package/docs-live/product-areas/CONFIGURATION.md +1048 -0
- package/docs-live/product-areas/CORE-TYPES.md +221 -0
- package/docs-live/product-areas/DATA-API.md +850 -0
- package/docs-live/product-areas/GENERATION.md +1200 -0
- package/docs-live/product-areas/PROCESS.md +351 -0
- package/docs-live/product-areas/VALIDATION.md +1135 -0
- package/docs-live/reference/ANNOTATION-REFERENCE.md +232 -0
- package/docs-live/reference/ARCHITECTURE-CODECS.md +675 -0
- package/docs-live/reference/ARCHITECTURE-TYPES.md +436 -0
- package/docs-live/reference/CONFIGURATION-GUIDE.md +235 -0
- package/docs-live/reference/GHERKIN-AUTHORING-GUIDE.md +270 -0
- package/docs-live/reference/PROCESS-API-RECIPES.md +476 -0
- package/docs-live/reference/PROCESS-API-REFERENCE.md +63 -0
- package/docs-live/reference/PROCESS-GUARD-REFERENCE.md +258 -0
- package/docs-live/reference/REFERENCE-SAMPLE.md +1135 -0
- package/docs-live/reference/SESSION-WORKFLOW-GUIDE.md +384 -0
- package/docs-live/reference/VALIDATION-TOOLS-GUIDE.md +263 -0
- package/docs-live/taxonomy/categories.md +33 -0
- package/docs-live/taxonomy/format-types.md +67 -0
- package/docs-live/taxonomy/metadata-tags.md +693 -0
- package/docs-live/validation/error-catalog.md +78 -0
- package/docs-live/validation/fsm-transitions.md +50 -0
- package/docs-live/validation/protection-levels.md +51 -0
- package/package.json +233 -0
package/docs/INDEX.md
ADDED
|
@@ -0,0 +1,345 @@
|
|
|
1
|
+
# Documentation Index
|
|
2
|
+
|
|
3
|
+
> **Deprecated:** This document is superseded by the auto-generated [Documentation Index](../docs-live/INDEX.md) which includes live statistics, audience-based navigation, and document roles. This file is preserved for reference only.
|
|
4
|
+
|
|
5
|
+
**Navigate the full documentation set for `@libar-dev/architect`.** Use section links below for targeted reading.
|
|
6
|
+
|
|
7
|
+
## Package Metadata
|
|
8
|
+
|
|
9
|
+
| Field | Value |
|
|
10
|
+
| ---------------- | ---------------------------------------------------- |
|
|
11
|
+
| **Package** | @libar-dev/architect |
|
|
12
|
+
| **Version** | 1.0.0-pre.0 |
|
|
13
|
+
| **Purpose** | Context engineering for AI-assisted codebases |
|
|
14
|
+
| **Key Features** | Living docs, FSM enforcement, AI-native Data API CLI |
|
|
15
|
+
| **Node.js** | >= 18.0.0 |
|
|
16
|
+
| **License** | MIT |
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Quick Navigation
|
|
21
|
+
|
|
22
|
+
| If you want to... | Read this | Lines |
|
|
23
|
+
| --------------------------- | -------------------------------------------- | ------ |
|
|
24
|
+
| Get started quickly | [README.md](../README.md) | 1-504 |
|
|
25
|
+
| Configure presets and tags | [CONFIGURATION.md](./CONFIGURATION.md) | 1-357 |
|
|
26
|
+
| Understand the "why" | [METHODOLOGY.md](./METHODOLOGY.md) | 1-238 |
|
|
27
|
+
| Learn the architecture | [ARCHITECTURE.md](./ARCHITECTURE.md) | 1-1638 |
|
|
28
|
+
| Run AI coding sessions | [SESSION-GUIDES.md](./SESSION-GUIDES.md) | 1-389 |
|
|
29
|
+
| Write Gherkin specs | [GHERKIN-PATTERNS.md](./GHERKIN-PATTERNS.md) | 1-515 |
|
|
30
|
+
| Enforce process rules | [PROCESS-GUARD.md](./PROCESS-GUARD.md) | 1-341 |
|
|
31
|
+
| Validate annotation quality | [VALIDATION.md](./VALIDATION.md) | 1-281 |
|
|
32
|
+
| Query process state via CLI | [PROCESS-API.md](./PROCESS-API.md) | 1-507 |
|
|
33
|
+
| Understand the taxonomy | [TAXONOMY.md](./TAXONOMY.md) | 1-105 |
|
|
34
|
+
| Publish to npm | [MAINTAINERS.md](../MAINTAINERS.md) | — |
|
|
35
|
+
| Learn annotation patterns | [ANNOTATION-GUIDE.md](./ANNOTATION-GUIDE.md) | 1-268 |
|
|
36
|
+
| Review the changelog | [CHANGELOG.md](../CHANGELOG.md) | 1-26 |
|
|
37
|
+
| Security policy | [SECURITY.md](../SECURITY.md) | 1-21 |
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Reading Order
|
|
42
|
+
|
|
43
|
+
### For New Users
|
|
44
|
+
|
|
45
|
+
1. **[README.md](../README.md)** — Installation, quick start, Data API CLI overview
|
|
46
|
+
2. **[CONFIGURATION.md](./CONFIGURATION.md)** — Presets, tag prefixes, config files
|
|
47
|
+
3. **[METHODOLOGY.md](./METHODOLOGY.md)** — Core thesis, dual-source architecture
|
|
48
|
+
|
|
49
|
+
### For Developers / AI
|
|
50
|
+
|
|
51
|
+
4. **[ARCHITECTURE.md](./ARCHITECTURE.md)** — Four-stage pipeline, codecs, MasterDataset
|
|
52
|
+
5. **[PROCESS-API.md](./PROCESS-API.md)** — Data API CLI query interface
|
|
53
|
+
6. **[SESSION-GUIDES.md](./SESSION-GUIDES.md)** — Planning/Design/Implementation workflows
|
|
54
|
+
7. **[GHERKIN-PATTERNS.md](./GHERKIN-PATTERNS.md)** — Writing effective Gherkin specs
|
|
55
|
+
8. **[ANNOTATION-GUIDE.md](./ANNOTATION-GUIDE.md)** — Annotation mechanics, shape extraction, tag quick reference
|
|
56
|
+
|
|
57
|
+
### For Team Leads / CI
|
|
58
|
+
|
|
59
|
+
9. **[PROCESS-GUARD.md](./PROCESS-GUARD.md)** — FSM enforcement, pre-commit hooks
|
|
60
|
+
10. **[VALIDATION.md](./VALIDATION.md)** — Lint rules, DoD checks, anti-patterns
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Detailed Table of Contents
|
|
65
|
+
|
|
66
|
+
### README.md (Lines 1-504)
|
|
67
|
+
|
|
68
|
+
| Section | Lines | Key Topics |
|
|
69
|
+
| ------------------------- | ------- | --------------------------------------------- |
|
|
70
|
+
| Why This Exists | 17-31 | AI context failure, code as source of truth |
|
|
71
|
+
| Built for AI-Assisted Dev | 33-50 | Data API CLI typed queries |
|
|
72
|
+
| Quick Start | 52-109 | Install, annotate, generate, lint |
|
|
73
|
+
| How It Works | 111-165 | Annotation examples, pipeline one-liner |
|
|
74
|
+
| What Gets Generated | 167-184 | Content block types, config-driven generation |
|
|
75
|
+
| CLI Commands | 186-254 | architect-generate, architect:query |
|
|
76
|
+
| Proven at Scale | 256-303 | Discovery, real results, 3-session MVP |
|
|
77
|
+
| FSM-Enforced Workflow | 305-337 | State diagram, protection levels |
|
|
78
|
+
| Data API CLI | 339-365 | CLI example, context cost comparison |
|
|
79
|
+
| Rich Relationship Model | 367-390 | Dependency tags, Mermaid graph |
|
|
80
|
+
| How It Compares | 392-414 | Comparison with Backstage, Mintlify, etc. |
|
|
81
|
+
| Design-First Development | 416-420 | Stub pattern summary + link |
|
|
82
|
+
| Document Durability Model | 422-426 | Durability hierarchy summary + link |
|
|
83
|
+
| Use Cases | 428-439 | Multi-phase roadmaps, AI sessions, validation |
|
|
84
|
+
| Configuration | 441-475 | Presets table, custom config |
|
|
85
|
+
| Documentation | 477-500 | Doc links table |
|
|
86
|
+
| License | 502-504 | MIT license |
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
### CONFIGURATION.md (Lines 1-357)
|
|
91
|
+
|
|
92
|
+
| Section | Lines | Key Topics |
|
|
93
|
+
| --------------------- | ------- | ----------------------------------------------- |
|
|
94
|
+
| Quick Reference | 10-56 | Preset comparison, defineConfig() examples |
|
|
95
|
+
| Presets | 84-151 | Generic vs DDD-ES-CQRS preset details |
|
|
96
|
+
| Unified Config File | 154-244 | defineConfig(), sources, output, gen overrides |
|
|
97
|
+
| Custom Configuration | 248-295 | Custom tag prefix, custom categories |
|
|
98
|
+
| Programmatic Config | 299-331 | loadProjectConfig(), mergeSourcesForGenerator() |
|
|
99
|
+
| Related Documentation | 350-357 | Links to README, TAXONOMY, ARCHITECTURE |
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
### METHODOLOGY.md (Lines 1-238)
|
|
104
|
+
|
|
105
|
+
| Section | Lines | Key Topics |
|
|
106
|
+
| -------------------------- | ------- | ---------------------------------------- |
|
|
107
|
+
| Core Thesis | 9-30 | USDP inversion, event sourcing analogy |
|
|
108
|
+
| Dogfooding | 34-68 | Real annotation examples from codebase |
|
|
109
|
+
| Session Workflow | 72-87 | Planning → Design → Implementation |
|
|
110
|
+
| Annotation Ownership | 91-140 | Split-ownership principle, example split |
|
|
111
|
+
| Two-Tier Spec Architecture | 144-156 | Roadmap tier vs Package tier |
|
|
112
|
+
| Code Stubs | 160-180 | Minimal, Interface, Partial levels |
|
|
113
|
+
| Stubs Architecture | 184-226 | Design stubs + planning stubs locations |
|
|
114
|
+
| Related Documentation | 230-238 | Links to PROCESS-GUARD, CONFIG, GHERKIN |
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
### ARCHITECTURE.md (Lines 1-1638)
|
|
119
|
+
|
|
120
|
+
| Section | Lines | Key Topics |
|
|
121
|
+
| -------------------------- | --------- | ----------------------------------------------------------------- |
|
|
122
|
+
| Executive Summary | 28-69 | What it does, key principles (incl. Single Read Model), overview |
|
|
123
|
+
| Configuration Architecture | 70-139 | Entry point, pipeline effects, resolution |
|
|
124
|
+
| Four-Stage Pipeline | 140-343 | Scanner → Extractor → Pipeline Factory → Transformer → Codec |
|
|
125
|
+
| Unified Transformation | 345-478 | MasterDataset schema (relationshipIndex + archIndex), single-pass |
|
|
126
|
+
| Codec Architecture | 481-527 | Concepts, block vocabulary, factory, 3 renderers |
|
|
127
|
+
| Available Codecs | 529-870 | All 20 codecs with options tables |
|
|
128
|
+
| Progressive Disclosure | 871-917 | Split logic, detail levels |
|
|
129
|
+
| Source Systems | 919-1024 | TypeScript scanner, Gherkin scanner |
|
|
130
|
+
| Key Design Patterns | 1026-1105 | Result monad, schema-first, tag registry |
|
|
131
|
+
| Data Flow Diagrams | 1107-1290 | Pipeline flow, factory entry point, MasterDataset views, codecs |
|
|
132
|
+
| Workflow Integration | 1292-1401 | Planning, implementing, release workflows |
|
|
133
|
+
| Programmatic Usage | 1403-1458 | Direct codec usage, generateDocument |
|
|
134
|
+
| Extending the System | 1460-1527 | Custom codec, custom generator |
|
|
135
|
+
| Quick Reference | 1529-1604 | Codec-to-generator mapping, CLI, filters |
|
|
136
|
+
|
|
137
|
+
#### Available Codecs Reference
|
|
138
|
+
|
|
139
|
+
| Codec | Lines | Output Files |
|
|
140
|
+
| ------------------------- | ------- | ------------------------------------- |
|
|
141
|
+
| PatternsDocumentCodec | 536-556 | PATTERNS.md, patterns/\*.md |
|
|
142
|
+
| RequirementsDocumentCodec | 557-578 | PRODUCT-REQUIREMENTS.md |
|
|
143
|
+
| RoadmapDocumentCodec | 581-598 | ROADMAP.md, phases/\*.md |
|
|
144
|
+
| CompletedMilestonesCodec | 600-607 | COMPLETED-MILESTONES.md |
|
|
145
|
+
| CurrentWorkCodec | 609-616 | CURRENT-WORK.md |
|
|
146
|
+
| ChangelogCodec | 618-634 | CHANGELOG.md |
|
|
147
|
+
| SessionContextCodec | 638-645 | SESSION-CONTEXT.md |
|
|
148
|
+
| RemainingWorkCodec | 647-667 | REMAINING-WORK.md |
|
|
149
|
+
| PlanningChecklistCodec | 671-675 | PLANNING-CHECKLIST.md |
|
|
150
|
+
| SessionPlanCodec | 677-681 | SESSION-PLAN.md |
|
|
151
|
+
| SessionFindingsCodec | 683-696 | SESSION-FINDINGS.md |
|
|
152
|
+
| AdrDocumentCodec | 700-707 | DECISIONS.md |
|
|
153
|
+
| PrChangesCodec | 709-713 | working/PR-CHANGES.md |
|
|
154
|
+
| TraceabilityCodec | 715-719 | TRACEABILITY.md |
|
|
155
|
+
| OverviewCodec | 721-725 | OVERVIEW.md |
|
|
156
|
+
| BusinessRulesCodec | 727-749 | BUSINESS-RULES.md |
|
|
157
|
+
| ArchitectureDocumentCodec | 751-766 | ARCHITECTURE.md (generated) |
|
|
158
|
+
| TaxonomyDocumentCodec | 768-784 | TAXONOMY.md, taxonomy/\*.md |
|
|
159
|
+
| ValidationRulesCodec | 786-804 | VALIDATION-RULES.md, validation/\*.md |
|
|
160
|
+
| ReferenceCodec | 808-850 | Configured per-instance |
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
### SESSION-GUIDES.md (Lines 1-389)
|
|
165
|
+
|
|
166
|
+
| Section | Lines | Key Topics |
|
|
167
|
+
| ------------------------ | ------- | ------------------------------------------ |
|
|
168
|
+
| Session Decision Tree | 7-25 | Which session type to use |
|
|
169
|
+
| Planning Session | 27-91 | Context gathering, checklist, do NOT |
|
|
170
|
+
| Design Session | 93-161 | Context gathering, when required, stubs |
|
|
171
|
+
| Implementation Session | 163-235 | scope-validate, execution, FSM transitions |
|
|
172
|
+
| Planning + Design | 237-317 | Combined workflow, handoff complete when |
|
|
173
|
+
| Handoff Documentation | 319-365 | CLI handoff, template, discovery tags |
|
|
174
|
+
| FSM Protection Quick Ref | 367-376 | State protection levels table |
|
|
175
|
+
| Related Documentation | 380-389 | Links to Methodology, Gherkin, Config, etc |
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
### GHERKIN-PATTERNS.md (Lines 1-515)
|
|
180
|
+
|
|
181
|
+
| Section | Lines | Key Topics |
|
|
182
|
+
| --------------------------- | ------- | ------------------------------------------------------- |
|
|
183
|
+
| Essential Patterns | 9-152 | Roadmap spec, Rule blocks, Scenario Outline |
|
|
184
|
+
| — Roadmap Spec Structure | 11-45 | Tags, Problem/Solution, Background table |
|
|
185
|
+
| — Rule Blocks | 47-79 | Business constraints, ScenarioOutline |
|
|
186
|
+
| — Scenario Outline | 82-98 | Examples table for variations |
|
|
187
|
+
| — Executable Test Feature | 101-150 | Section dividers, behavior verification |
|
|
188
|
+
| DataTable & DocString Usage | 155-202 | Background vs Scenario tables, code blocks |
|
|
189
|
+
| Tag Conventions | 205-243 | Semantic tags, convention tags, combining |
|
|
190
|
+
| Feature File Rich Content | 246-344 | Code-first, Rule annotations, syntax notes |
|
|
191
|
+
| Step Linting | 346-493 | lint-steps rules, CLI, feature/step/cross-file checks |
|
|
192
|
+
| Quick Reference | 495-506 | Element-to-use-case mapping table |
|
|
193
|
+
| Related Documentation | 508-515 | Links to ANNOTATION-GUIDE, TAXONOMY, CONFIG, VALIDATION |
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
### PROCESS-API.md (Lines 1-507)
|
|
198
|
+
|
|
199
|
+
| Section | Lines | Key Topics |
|
|
200
|
+
| ------------------------- | ------- | ----------------------------------------------------------- |
|
|
201
|
+
| Why Use This | 12-28 | Context cost comparison, AI agent tiers, two output modes |
|
|
202
|
+
| Quick Start | 30-63 | Session recipe (overview → scope-validate → context) |
|
|
203
|
+
| Session Types | 65-77 | planning/design/implement decision tree |
|
|
204
|
+
| Session Workflow Commands | 79-204 | overview, scope-validate, context, dep-tree, files, handoff |
|
|
205
|
+
| Pattern Discovery | 206-302 | status, list, search, pattern, stubs, decisions, pdr, rules |
|
|
206
|
+
| Architecture Queries | 304-333 | 11 arch subcommands table, examples |
|
|
207
|
+
| Metadata & Inventory | 335-375 | tags, sources, unannotated, query escape hatch |
|
|
208
|
+
| Output Reference | 377-465 | Options, modifiers, filters, JSON envelope, exit codes |
|
|
209
|
+
| Common Recipes | 467-507 | Starting, finding work, investigating, design, ending |
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
### PROCESS-GUARD.md (Lines 1-341)
|
|
214
|
+
|
|
215
|
+
| Section | Lines | Key Topics |
|
|
216
|
+
| -------------------------------- | ------- | ----------------------------------------------- |
|
|
217
|
+
| Quick Reference | 9-37 | Protection levels, transitions, escapes |
|
|
218
|
+
| Error: completed-protection | 40-72 | Fix with unlock reason, validation requirements |
|
|
219
|
+
| Error: invalid-status-transition | 74-105 | Follow FSM path, common invalid table |
|
|
220
|
+
| Error: scope-creep | 107-131 | Remove deliverable or revert status |
|
|
221
|
+
| Warning: session-scope | 133-153 | Add to scope or --ignore-session |
|
|
222
|
+
| Error: session-excluded | 155-175 | Remove from exclusion or override |
|
|
223
|
+
| Warning: deliverable-removed | 177-191 | Informational, document if intentional |
|
|
224
|
+
| CLI Usage | 193-243 | Modes, options (incl. --base-dir), exit codes |
|
|
225
|
+
| Pre-commit Setup | 246-269 | Husky, package.json scripts |
|
|
226
|
+
| Programmatic API | 271-318 | Full code example, API functions table |
|
|
227
|
+
| Architecture | 321-333 | Decider pattern diagram |
|
|
228
|
+
| Related Documentation | 335-341 | Links to METHODOLOGY, TAXONOMY, VALIDATION |
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
### VALIDATION.md (Lines 1-281)
|
|
233
|
+
|
|
234
|
+
| Section | Lines | Key Topics |
|
|
235
|
+
| --------------------- | ------- | ------------------------------------------------- |
|
|
236
|
+
| Which Command? | 7-24 | Decision tree for validation commands |
|
|
237
|
+
| Command Summary | 26-35 | lint-patterns, lint-steps, lint-process, validate |
|
|
238
|
+
| lint-patterns | 37-74 | 8 rules table, CLI flags |
|
|
239
|
+
| lint-steps | 76-98 | 12 rules, 3 categories, vitest-cucumber traps |
|
|
240
|
+
| lint-process | 100-121 | What it validates, reference links |
|
|
241
|
+
| validate-patterns | 123-197 | CLI flags, checks, anti-patterns, DoD |
|
|
242
|
+
| CI/CD Integration | 199-238 | Consumer scripts, hooks, GitHub Actions |
|
|
243
|
+
| Exit Codes | 240-248 | Per-command exit code table |
|
|
244
|
+
| Programmatic API | 250-272 | Import paths for all validators |
|
|
245
|
+
| Related Documentation | 274-281 | Links to GHERKIN-PATTERNS, PROCESS-GUARD, CONFIG |
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
### TAXONOMY.md (Lines 1-105)
|
|
250
|
+
|
|
251
|
+
| Section | Lines | Key Topics |
|
|
252
|
+
| --------------------- | ------- | -------------------------------------------- |
|
|
253
|
+
| Concept | 7-18 | What taxonomy defines, FSM states |
|
|
254
|
+
| Architecture | 22-65 | File structure, TagRegistry, presets |
|
|
255
|
+
| Format Types | 69-80 | flag, value, enum, csv, number, quoted-value |
|
|
256
|
+
| Generating Reference | 84-96 | docs:taxonomy, architect-generate |
|
|
257
|
+
| Related Documentation | 100-105 | Links to CONFIGURATION, METHODOLOGY |
|
|
258
|
+
|
|
259
|
+
---
|
|
260
|
+
|
|
261
|
+
### MAINTAINERS.md (repo root)
|
|
262
|
+
|
|
263
|
+
Publishing and maintainer workflows have moved to [MAINTAINERS.md](../MAINTAINERS.md) at the repository root.
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
### ANNOTATION-GUIDE.md (Lines 1-268)
|
|
268
|
+
|
|
269
|
+
| Section | Lines | Key Topics |
|
|
270
|
+
| -------------------------------- | ------- | ------------------------------------------------------ |
|
|
271
|
+
| Getting Started | 9-67 | Opt-in marker, TS/Gherkin examples, presets, ownership |
|
|
272
|
+
| Shape Extraction | 69-125 | 3 modes: explicit, wildcard, declaration-level |
|
|
273
|
+
| Annotation Patterns by File Type | 127-191 | Zod, interface, function, Gherkin examples |
|
|
274
|
+
| Tag Groups Quick Reference | 193-223 | 12 groups with representative tags and format types |
|
|
275
|
+
| Verification | 225-257 | CLI commands, common issues table |
|
|
276
|
+
| Related Documentation | 259-268 | Links to TAXONOMY, CONFIGURATION, ARCHITECTURE |
|
|
277
|
+
|
|
278
|
+
---
|
|
279
|
+
|
|
280
|
+
## Key Concepts Quick Reference
|
|
281
|
+
|
|
282
|
+
### Dual-Source Architecture
|
|
283
|
+
|
|
284
|
+
| Source | Owns | Tags |
|
|
285
|
+
| ----------------- | ---------------------------------------- | ---------------------------------------- |
|
|
286
|
+
| **Feature files** | Planning: status, phase, quarter, effort | `@*-status`, `@*-phase`, `@*-depends-on` |
|
|
287
|
+
| **TypeScript** | Implementation: uses, used-by, category | `@*-uses`, `@*-used-by`, `@*-core` |
|
|
288
|
+
|
|
289
|
+
### Delivery Workflow FSM
|
|
290
|
+
|
|
291
|
+
```
|
|
292
|
+
roadmap ──→ active ──→ completed
|
|
293
|
+
│ │
|
|
294
|
+
│ ↓
|
|
295
|
+
│ roadmap (blocked)
|
|
296
|
+
↓
|
|
297
|
+
deferred ──→ roadmap
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
### Data API CLI — Primary Context Source
|
|
301
|
+
|
|
302
|
+
The CLI is the **recommended way** to gather context in any session type.
|
|
303
|
+
It queries annotated sources in real time — not generated snapshots.
|
|
304
|
+
See [PROCESS-API.md](./PROCESS-API.md).
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
pnpm architect:query -- scope-validate MyPattern implement # ALWAYS run first
|
|
308
|
+
pnpm architect:query -- context MyPattern --session implement # Curated context bundle
|
|
309
|
+
pnpm architect:query -- files MyPattern --related # Implementation paths
|
|
310
|
+
pnpm architect:query -- handoff --pattern MyPattern # Capture session end state
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
---
|
|
314
|
+
|
|
315
|
+
## Document Roles Summary
|
|
316
|
+
|
|
317
|
+
| Document | Audience | Focus |
|
|
318
|
+
| ------------------- | ----------- | --------------------------------- |
|
|
319
|
+
| README.md | Everyone | Quick start, value proposition |
|
|
320
|
+
| METHODOLOGY.md | Everyone | Why — core thesis, principles |
|
|
321
|
+
| CONFIGURATION.md | Users | Setup — presets, tags, config |
|
|
322
|
+
| ARCHITECTURE.md | Developers | How — pipeline, codecs, schemas |
|
|
323
|
+
| PROCESS-API.md | AI/Devs | Data API CLI query interface |
|
|
324
|
+
| SESSION-GUIDES.md | AI/Devs | Workflow — day-to-day usage |
|
|
325
|
+
| GHERKIN-PATTERNS.md | Writers | Specs — writing effective Gherkin |
|
|
326
|
+
| PROCESS-GUARD.md | Team Leads | Governance — enforcement rules |
|
|
327
|
+
| VALIDATION.md | CI/CD | Quality — automated checks |
|
|
328
|
+
| TAXONOMY.md | Reference | Lookup — tag taxonomy and API |
|
|
329
|
+
| ANNOTATION-GUIDE.md | Developers | Reference — annotation mechanics |
|
|
330
|
+
| MAINTAINERS.md | Maintainers | Release — npm publishing |
|
|
331
|
+
| CHANGELOG.md | Everyone | Version history and changes |
|
|
332
|
+
| SECURITY.md | Everyone | Security policy and reporting |
|
|
333
|
+
|
|
334
|
+
---
|
|
335
|
+
|
|
336
|
+
## Auto-Generated Documentation
|
|
337
|
+
|
|
338
|
+
The `docs-live/` directory contains documentation **generated from annotated sources** using the codec pipeline. These files should not be edited manually — regenerate with `pnpm docs:all` or `pnpm docs:product-areas`.
|
|
339
|
+
|
|
340
|
+
| Directory | Contents | Generated By |
|
|
341
|
+
| -------------------------- | ---------------------------------------------------- | -------------------- |
|
|
342
|
+
| `docs-live/product-areas/` | 7 product area docs with diagrams and shapes | `docs:product-areas` |
|
|
343
|
+
| `docs-live/decisions/` | Architecture Decision Records (ADR-001–006, ADR-021) | `docs:all` |
|
|
344
|
+
| `docs-live/_claude-md/` | Compact AI context modules per product area | `docs:product-areas` |
|
|
345
|
+
| `docs-live/` | DECISIONS.md, PRODUCT-AREAS.md (indexes) | `docs:all` |
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# MCP Server Setup
|
|
2
|
+
|
|
3
|
+
> Architect MCP server exposes ProcessStateAPI as native Claude Code tools with sub-millisecond dispatch.
|
|
4
|
+
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
### Claude Code (`.mcp.json`)
|
|
8
|
+
|
|
9
|
+
Add to your project's `.mcp.json`:
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"mcpServers": {
|
|
14
|
+
"architect": {
|
|
15
|
+
"command": "npx",
|
|
16
|
+
"args": ["architect-mcp"],
|
|
17
|
+
"cwd": "${workspaceFolder}"
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### Claude Desktop (`claude_desktop_config.json`)
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"mcpServers": {
|
|
28
|
+
"architect": {
|
|
29
|
+
"command": "npx",
|
|
30
|
+
"args": ["architect-mcp"],
|
|
31
|
+
"cwd": "/path/to/your/project"
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### With File Watching
|
|
38
|
+
|
|
39
|
+
Auto-rebuild the dataset when source files change:
|
|
40
|
+
|
|
41
|
+
```json
|
|
42
|
+
{
|
|
43
|
+
"mcpServers": {
|
|
44
|
+
"architect": {
|
|
45
|
+
"command": "npx",
|
|
46
|
+
"args": ["architect-mcp", "--watch"],
|
|
47
|
+
"cwd": "${workspaceFolder}"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### With Explicit Globs (Monorepo)
|
|
54
|
+
|
|
55
|
+
Override config auto-detection for monorepo setups:
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"mcpServers": {
|
|
60
|
+
"architect": {
|
|
61
|
+
"command": "npx",
|
|
62
|
+
"args": [
|
|
63
|
+
"architect-mcp",
|
|
64
|
+
"--input",
|
|
65
|
+
"packages/core/src/**/*.ts",
|
|
66
|
+
"--features",
|
|
67
|
+
"packages/core/specs/**/*.feature",
|
|
68
|
+
"--base-dir",
|
|
69
|
+
"packages/core"
|
|
70
|
+
]
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## How It Works
|
|
77
|
+
|
|
78
|
+
The MCP server:
|
|
79
|
+
|
|
80
|
+
1. **Loads the pipeline once** — config detection, scanning, extraction, transformation (~1-2s)
|
|
81
|
+
2. **Keeps MasterDataset in memory** — all subsequent queries are O(1) lookups
|
|
82
|
+
3. **Exposes 25 tools** — each wrapping a ProcessStateAPI method or CLI subcommand
|
|
83
|
+
4. **Optionally watches files** — auto-rebuilds on source changes (500ms debounce)
|
|
84
|
+
|
|
85
|
+
## Available Tools
|
|
86
|
+
|
|
87
|
+
| Tool | Description |
|
|
88
|
+
| ----------------------------- | ---------------------------------------------------- |
|
|
89
|
+
| `architect_overview` | Project health summary (start here) |
|
|
90
|
+
| `architect_context` | Session-aware context bundle for a pattern |
|
|
91
|
+
| `architect_pattern` | Full pattern metadata |
|
|
92
|
+
| `architect_list` | List patterns with filters (status, phase, category) |
|
|
93
|
+
| `architect_search` | Fuzzy search patterns by name |
|
|
94
|
+
| `architect_status` | Status counts and completion percentage |
|
|
95
|
+
| `architect_files` | File reading list for a pattern |
|
|
96
|
+
| `architect_dep_tree` | Dependency chain with status |
|
|
97
|
+
| `architect_scope_validate` | Pre-flight check for implementation |
|
|
98
|
+
| `architect_handoff` | Session-end state for continuity |
|
|
99
|
+
| `architect_rules` | Business rules and invariants |
|
|
100
|
+
| `architect_tags` | Tag usage report |
|
|
101
|
+
| `architect_sources` | Source file inventory |
|
|
102
|
+
| `architect_stubs` | Design stubs with resolution status |
|
|
103
|
+
| `architect_decisions` | Design decisions from stubs |
|
|
104
|
+
| `architect_arch_context` | Bounded contexts with members |
|
|
105
|
+
| `architect_arch_layer` | Architecture layers with members |
|
|
106
|
+
| `architect_arch_neighborhood` | Pattern uses/used-by/peers |
|
|
107
|
+
| `architect_arch_blocking` | Patterns blocked by dependencies |
|
|
108
|
+
| `architect_arch_dangling` | Broken pattern references |
|
|
109
|
+
| `architect_arch_coverage` | Annotation coverage analysis |
|
|
110
|
+
| `architect_unannotated` | Files missing @architect |
|
|
111
|
+
| `architect_rebuild` | Force dataset rebuild |
|
|
112
|
+
| `architect_config` | Show current configuration |
|
|
113
|
+
| `architect_help` | List all tools |
|
|
114
|
+
|
|
115
|
+
## CLI Options
|
|
116
|
+
|
|
117
|
+
```text
|
|
118
|
+
architect-mcp [options]
|
|
119
|
+
|
|
120
|
+
-i, --input <glob> TypeScript source globs (repeatable)
|
|
121
|
+
-f, --features <glob> Gherkin feature globs (repeatable)
|
|
122
|
+
-b, --base-dir <dir> Base directory (default: cwd)
|
|
123
|
+
-w, --watch Watch source files for changes
|
|
124
|
+
-h, --help Show help
|
|
125
|
+
-v, --version Show version
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Troubleshooting
|
|
129
|
+
|
|
130
|
+
### Server fails to start
|
|
131
|
+
|
|
132
|
+
Check that `architect.config.ts` exists in your project root, or provide explicit `--input` and `--features` globs.
|
|
133
|
+
|
|
134
|
+
### Tools return stale data
|
|
135
|
+
|
|
136
|
+
Call `architect_rebuild` to force a dataset refresh, or start the server with `--watch` for automatic rebuilds.
|
|
137
|
+
|
|
138
|
+
### Config not found in monorepo
|
|
139
|
+
|
|
140
|
+
Use `--base-dir` to point to the package root and `--input`/`--features` for explicit glob patterns.
|