Skip to content

feat: DataAPICLIErgonomics — caching, REPL, help, dry-run, metadata #35

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
darko-mijic merged 3 commits into from
Mar 14, 2026
Merged

feat: DataAPICLIErgonomics — caching, REPL, help, dry-run, metadata #35

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
a5ed6aa
feat: implement DataAPICLIErgonomics — caching, REPL, help, dry-run, …
darko-mijic Mar 14, 2026
d4dc018
docs: regenerate all docs after DataAPICLIErgonomics completion
darko-mijic Mar 14, 2026
6db28e8
fix: address PR #35 review comments — cache safety, input validation,…
darko-mijic Mar 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions delivery-process/specs/data-api-cli-ergonomics.feature
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
@libar-docs
@libar-docs-pattern:DataAPICLIErgonomics
@libar-docs-status:roadmap
@libar-docs-status:completed
@libar-docs-unlock-reason:Final-deliverable-status-update
@libar-docs-phase:25d
@libar-docs-product-area:DataAPI
@libar-docs-effort:2d
Expand Down Expand Up @@ -35,12 +36,12 @@ Feature: Data API CLI Ergonomics - Performance and Interactive Mode
Background: Deliverables
Given the following deliverables:
| Deliverable | Status | Location | Tests | Test Type |
| MasterDataset cache with mtime invalidation | pending | src/cli/dataset-cache.ts | Yes | unit |
| REPL mode handler | pending | src/cli/repl.ts | Yes | integration |
| MasterDataset cache with mtime invalidation | complete | src/cli/dataset-cache.ts | Yes | unit |
| REPL mode handler | complete | src/cli/repl.ts | Yes | integration |
| FSM short-circuit for static queries | complete | src/cli/process-api.ts | Yes | unit |
| Per-subcommand help system | pending | src/cli/process-api.ts | Yes | integration |
| Dry-run mode | pending | src/cli/process-api.ts | Yes | integration |
| Validation summary in metadata | pending | src/cli/process-api.ts | Yes | unit |
| Per-subcommand help system | complete | src/cli/process-api.ts | Yes | integration |
| Dry-run mode | complete | src/cli/process-api.ts | Yes | integration |
| Validation summary in metadata | complete | src/cli/process-api.ts | Yes | unit |

# ============================================================================
# RULE 1: Pipeline Caching
Expand Down
92 changes: 50 additions & 42 deletions docs-live/ARCHITECTURE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@

## Overview

This diagram was auto-generated from 158 annotated source files across 11 bounded contexts.
This diagram was auto-generated from 160 annotated source files across 11 bounded contexts.

| Metric | Count |
| ---------------- | ----- |
| Total Components | 158 |
| Total Components | 160 |
| Bounded Contexts | 11 |
| Component Roles | 5 |

Expand Down Expand Up @@ -43,13 +43,15 @@ graph TB
subgraph cli["Cli BC"]
CLIVersionHelper["CLIVersionHelper"]
ValidatePatternsCLI["ValidatePatternsCLI"]
ReplMode["ReplMode[service]"]
ProcessAPICLIImpl["ProcessAPICLIImpl[service]"]
OutputPipelineImpl["OutputPipelineImpl[service]"]
LintProcessCLI["LintProcessCLI"]
LintPatternsCLI["LintPatternsCLI"]
TagTaxonomyCLI["TagTaxonomyCLI"]
Documentation_Generator_CLI["Documentation Generator CLI"]
CLIErrorHandler["CLIErrorHandler"]
DatasetCache["DatasetCache[infrastructure]"]
CLISchema["CLISchema"]
end
subgraph config["Config BC"]
Expand Down Expand Up @@ -179,7 +181,6 @@ graph TB
FSMModule["FSMModule"]
end
subgraph shared["Shared Infrastructure"]
Convention_Annotation_Example___DD_3_Decision["Convention Annotation Example — DD-3 Decision[decider]"]
WorkflowConfigSchema["WorkflowConfigSchema"]
Tag_Registry_Configuration["Tag Registry Configuration"]
OutputSchemas["OutputSchemas"]
Expand All @@ -190,6 +191,8 @@ graph TB
CodecUtils["CodecUtils"]
ResultMonadTypes["ResultMonadTypes"]
ErrorFactoryTypes["ErrorFactoryTypes"]
DoDValidationTypes["DoDValidationTypes"]
ValidationModule["ValidationModule"]
StatusValues["StatusValues"]
RiskLevels["RiskLevels"]
NormalizedStatus["NormalizedStatus"]
Expand All @@ -203,24 +206,24 @@ graph TB
GeneratorTypes["GeneratorTypes"]
SourceMappingValidator["SourceMappingValidator"]
GeneratorRegistry["GeneratorRegistry"]
RenderableUtils["RenderableUtils"]
SectionBlock["SectionBlock"]
RenderableDocumentModel_RDM_["RenderableDocumentModel(RDM)"]
ShapeExtractor["ShapeExtractor"]
LayerInference["LayerInference"]
ProcessStateTypes["ProcessStateTypes"]
StubResolverImpl["StubResolverImpl"]
RulesQueryModule["RulesQueryModule"]
APIModule["APIModule"]
CLIVersionHelper["CLIVersionHelper"]
ValidatePatternsCLI["ValidatePatternsCLI"]
LintProcessCLI["LintProcessCLI"]
LintPatternsCLI["LintPatternsCLI"]
TagTaxonomyCLI["TagTaxonomyCLI"]
Documentation_Generator_CLI["Documentation Generator CLI"]
CLIErrorHandler["CLIErrorHandler"]
ProcessStateTypes["ProcessStateTypes"]
StubResolverImpl["StubResolverImpl"]
RulesQueryModule["RulesQueryModule"]
APIModule["APIModule"]
RenderableUtils["RenderableUtils"]
SectionBlock["SectionBlock"]
RenderableDocumentModel_RDM_["RenderableDocumentModel(RDM)"]
DoDValidationTypes["DoDValidationTypes"]
ValidationModule["ValidationModule"]
Convention_Annotation_Example___DD_3_Decision["Convention Annotation Example — DD-3 Decision[decider]"]
FSMModule["FSMModule"]
ProcessGuardTypes["ProcessGuardTypes"]
ProcessGuardModule["ProcessGuardModule"]
DetectChanges["DetectChanges"]
Expand All @@ -246,7 +249,6 @@ graph TB
ClaudeModuleCodec["ClaudeModuleCodec"]
BusinessRulesCodec["BusinessRulesCodec"]
AdrDocumentCodec["AdrDocumentCodec"]
FSMModule["FSMModule"]
CodecBaseOptions["CodecBaseOptions"]
ADR006SingleReadModelArchitecture["ADR006SingleReadModelArchitecture"]
ADR005CodecBasedMarkdownRendering["ADR005CodecBasedMarkdownRendering"]
Expand All @@ -264,10 +266,10 @@ graph TB
EffortVarianceTracking["EffortVarianceTracking"]
ConfigBasedWorkflowDefinition["ConfigBasedWorkflowDefinition"]
CliBehaviorTesting["CliBehaviorTesting"]
StringUtils["StringUtils"]
ProcessGuardTesting["ProcessGuardTesting"]
ResultMonad["ResultMonad"]
ErrorFactories["ErrorFactories"]
StringUtils["StringUtils"]
SessionHandoffs["SessionHandoffs"]
SessionFileLifecycle["SessionFileLifecycle"]
KebabCaseSlugs["KebabCaseSlugs"]
Expand All @@ -278,22 +280,22 @@ graph TB
DocDirectiveSchema ..-> MvpWorkflowImplementation
ResultMonadTypes ..-> ResultMonad
ErrorFactoryTypes ..-> ErrorFactories
DoDValidator --> DoDValidationTypes
DoDValidator --> DualSourceExtractor
AntiPatternDetector --> DoDValidationTypes
CategoryDefinition ..-> CategoryDefinitions
GherkinScanner --> GherkinASTParser
TypeScript_AST_Parser --> DocDirectiveSchema
LintModule --> LintRules
LintModule --> LintEngine
LintEngine --> LintRules
LintEngine --> CodecUtils
GherkinScanner --> GherkinASTParser
TypeScript_AST_Parser --> DocDirectiveSchema
SourceMapper -.-> DecisionDocCodec
SourceMapper -.-> ShapeExtractor
SourceMapper -.-> GherkinASTParser
GeneratorRegistry --> GeneratorTypes
Documentation_Generation_Orchestrator --> Pattern_Scanner
GherkinExtractor --> GherkinASTParser
DualSourceExtractor --> GherkinExtractor
DualSourceExtractor --> GherkinScanner
Document_Extractor --> Pattern_Scanner
SectionBlock ..-> RenderableDocument
WorkflowLoader --> WorkflowConfigSchema
WorkflowLoader --> CodecUtils
ConfigResolver --> ProjectConfigTypes
Expand All @@ -311,22 +313,10 @@ graph TB
DefineConfig --> ProjectConfigTypes
ConfigLoader --> DeliveryProcessFactory
ConfigLoader --> ConfigurationTypes
ValidatePatternsCLI --> GherkinScanner
ValidatePatternsCLI --> GherkinExtractor
ValidatePatternsCLI --> MasterDataset
ValidatePatternsCLI --> CodecUtils
ProcessAPICLIImpl --> ProcessStateAPI
ProcessAPICLIImpl --> MasterDataset
ProcessAPICLIImpl --> PipelineFactory
ProcessAPICLIImpl --> RulesQueryModule
ProcessAPICLIImpl --> PatternSummarizerImpl
ProcessAPICLIImpl --> FuzzyMatcherImpl
ProcessAPICLIImpl --> OutputPipelineImpl
OutputPipelineImpl --> PatternSummarizerImpl
LintProcessCLI --> ProcessGuardModule
LintPatternsCLI --> LintEngine
LintPatternsCLI --> LintRules
TagTaxonomyCLI --> ConfigLoader
GherkinExtractor --> GherkinASTParser
DualSourceExtractor --> GherkinExtractor
DualSourceExtractor --> GherkinScanner
Document_Extractor --> Pattern_Scanner
PatternSummarizerImpl --> ProcessStateAPI
StubResolverImpl --> ProcessStateAPI
ScopeValidatorImpl --> ProcessStateAPI
Expand All @@ -349,10 +339,28 @@ graph TB
ContextAssemblerImpl --> StubResolverImpl
ArchQueriesImpl --> ProcessStateAPI
ArchQueriesImpl --> MasterDataset
SectionBlock ..-> RenderableDocument
DoDValidator --> DoDValidationTypes
DoDValidator --> DualSourceExtractor
AntiPatternDetector --> DoDValidationTypes
ValidatePatternsCLI --> GherkinScanner
ValidatePatternsCLI --> GherkinExtractor
ValidatePatternsCLI --> MasterDataset
ValidatePatternsCLI --> CodecUtils
ReplMode --> PipelineFactory
ReplMode --> ProcessStateAPI
ProcessAPICLIImpl --> ProcessStateAPI
ProcessAPICLIImpl --> MasterDataset
ProcessAPICLIImpl --> PipelineFactory
ProcessAPICLIImpl --> RulesQueryModule
ProcessAPICLIImpl --> PatternSummarizerImpl
ProcessAPICLIImpl --> FuzzyMatcherImpl
ProcessAPICLIImpl --> OutputPipelineImpl
OutputPipelineImpl --> PatternSummarizerImpl
LintProcessCLI --> ProcessGuardModule
LintPatternsCLI --> LintEngine
LintPatternsCLI --> LintRules
TagTaxonomyCLI --> ConfigLoader
DatasetCache --> PipelineFactory
DatasetCache --> WorkflowConfigSchema
FSMValidator --> FSMTransitions
FSMValidator --> FSMStates
DetectChanges --> DeriveProcessState
DeriveProcessState --> GherkinScanner
DeriveProcessState --> FSMValidator
Expand Down Expand Up @@ -381,8 +389,6 @@ graph TB
DesignReviewCodec --> MasterDataset
DesignReviewCodec --> MermaidDiagramUtils
ArchitectureCodec --> MasterDataset
FSMValidator --> FSMTransitions
FSMValidator --> FSMStates
ADR006SingleReadModelArchitecture -.-> ADR005CodecBasedMarkdownRendering
ADR003SourceFirstPatternArchitecture -.-> ADR001TaxonomyCanonicalValues
ValidatorReadModelConsolidation -.-> ADR006SingleReadModelArchitecture
Expand Down Expand Up @@ -431,8 +437,10 @@ All components with architecture annotations:
| 🚧 Process State API | api | service | application | src/api/process-state.ts |
| ✅ Scope Validator Impl | api | service | application | src/api/scope-validator.ts |
| ✅ CLI Schema | cli | - | domain | src/cli/cli-schema.ts |
| 🚧 Dataset Cache | cli | infrastructure | infrastructure | src/cli/dataset-cache.ts |
| 🚧 Output Pipeline Impl | cli | service | application | src/cli/output-pipeline.ts |
| 🚧 Process API CLI Impl | cli | service | application | src/cli/process-api.ts |
| 🚧 Repl Mode | cli | service | application | src/cli/repl.ts |
| ✅ Configuration Defaults | config | - | domain | src/config/defaults.ts |
| ✅ Configuration Presets | config | - | domain | src/config/presets.ts |
| ✅ Configuration Types | config | - | domain | src/config/types.ts |
Expand Down
4 changes: 2 additions & 2 deletions docs-live/BUSINESS-RULES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

---

**Domain constraints and invariants extracted from feature specifications. 592 rules from 126 features across 7 product areas.**
**Domain constraints and invariants extracted from feature specifications. 598 rules from 131 features across 7 product areas.**

---

Expand All @@ -16,7 +16,7 @@
| [Annotation](business-rules/annotation.md) | 20 | 88 | 88 |
| [Configuration](business-rules/configuration.md) | 7 | 32 | 32 |
| [Core Types](business-rules/core-types.md) | 5 | 22 | 22 |
| [Data API](business-rules/data-api.md) | 21 | 89 | 89 |
| [Data API](business-rules/data-api.md) | 26 | 95 | 95 |
| [Generation](business-rules/generation.md) | 60 | 300 | 300 |
| [Process](business-rules/process.md) | 2 | 7 | 7 |
| [Validation](business-rules/validation.md) | 11 | 54 | 54 |
Expand Down
Loading
Loading