@aisdlc/cli 1.3.2 → 1.4.0

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/README.md CHANGED
@@ -64,7 +64,7 @@ The `aisdlc` CLI provides comprehensive commands across 6 functional categories
64
64
 
65
65
  | Command | Description | Key Options |
66
66
  | --- | --- | --- |
67
- | `aisdlc init [directory]` | Bootstraps a repository with AI-SDLC folders, JSON schemas, policy files (`quality-policy.yaml`, `license-policy.yaml`), CI/CD templates, and AI agent rules. | `-d, --dry-run`, `--ci <github\|gitlab\|azure\|bitbucket>`, `--agents <all\|cursor\|claude\|antigravity\|copilot\|mcp>`, `--arch <minimal\|full\|none>`, `--json` |
67
+ | `aisdlc init [directory]` | Bootstraps a repository with AI-SDLC folders, JSON schemas, policy files (`quality-policy.yaml`, `license-policy.yaml`), CI/CD templates, and AI agent rules. `--arch minimal` (default) scaffolds 3 architecture templates: Phase 0 Vision & Goals (`ARCH-INTRO-*`), components (`CMP-*`), and ADRs (`ADR-*`); `full` scaffolds all arc42 sections. | `-d, --dry-run`, `--ci <github\|gitlab\|azure\|bitbucket>`, `--agents <all\|cursor\|claude\|antigravity\|copilot\|mcp>`, `--arch <minimal\|full\|none>`, `--json` |
68
68
  | `aisdlc check` | Unified pre-flight gate: runs Quality Gate checks with optional auto-repair (syncs Gherkin to `.feature` and recalculates PDaC SHA-256 digests). | `--fix`, `-r, --root <path>`, `--json`, `-F, --format <format>` |
69
69
  | `aisdlc mcp` | Starts the native Model Context Protocol (MCP) server over `stdio` exposing 23 deterministic tools and 5 context resources. | `-r, --root <path>` |
70
70
 
@@ -82,19 +82,20 @@ The `aisdlc` CLI provides comprehensive commands across 6 functional categories
82
82
 
83
83
  | Command | Description | Key Options |
84
84
  | --- | --- | --- |
85
- | `aisdlc verify [all]` | Executes the consolidated CI/CD suite evaluating all 9 quality and governance gates simultaneously. | `-r, --root <path>`, `-p, --policy <path>`, `-C <max-cc>`, `-K <max-cog>`, `-M <min-mi>`, `-L <max-lines>`, `-m <mode>`, `--json` |
85
+ | `aisdlc verify [all]` | Executes the consolidated CI/CD suite evaluating all 11 quality and governance gates simultaneously. | `-r, --root <path>`, `-p, --policy <path>`, `-C <max-cc>`, `-K <max-cog>`, `-M <min-mi>`, `-L <max-lines>`, `-m <mode>`, `--json` |
86
86
  | `aisdlc verify quality` | AST-based release gate evaluating Cyclomatic Complexity ($\le 10$), Cognitive ($\le 15$), Maintainability ($\ge 50$), and function length ($\le 40$). | `-p, --policy <path>`, `-C, --max-cyclomatic <n>`, `-K, --max-cognitive <n>`, `-M, --min-maintainability <n>`, `-m <STRICT\|PERMISSIVE>`, `--json` |
87
87
  | `aisdlc verify traceability` | Audits the 360° Requirements Traceability Matrix (Product HOF $\leftrightarrow$ Architecture CMP $\leftrightarrow$ Tests `.feature`). | `-r, --root <path>`, `--json` |
88
88
  | `aisdlc verify governance` | Audits task governance, human review plans, and autonomy modes (`AUTONOMOUS`, `HUMAN_REVIEW_PLAN`, etc.). | `-r, --root <path>`, `--json` |
89
89
  | `aisdlc verify testing` | Audits that 100% of requirements and tasks have corresponding verifiable tests on disk. | `-r, --root <path>`, `--json` |
90
+ | `aisdlc verify gherkin` | Verifies that `.feature` files match specification Gherkin scenarios with identical SHA-256 digests. | `-p, --path <path>`, `-a, --all`, `-r, --root <path>`, `--json` |
90
91
  | `aisdlc verify licenses` | Audits Open Source license compliance against `license-policy.yaml` with dynamic SCA scan, CycloneDX 1.5 SBOM, and legal notices. | `-p, --policy <path>`, `--sbom [path]`, `--notices [path]`, `--tool <native\|trivy\|syft>`, `--depth <direct\|transitive>`, `--json` |
91
92
  | `aisdlc verify pdac` | Verifies the Product Definition as Code graph and checks for cryptographic drift against SHA-256 digests. | `-r, --root <path>`, `--json` |
92
- | `aisdlc verify schemas` | Validates specification Markdown artifacts against canonical JSON Schemas (Draft 2020-12). | `-p, --path <path>`, `-r, --root <path>`, `--json` |
93
+ | `aisdlc verify schemas` | Validates specification Markdown artifacts and `handoff.yaml` sidecars against canonical JSON Schemas (Draft 2020-12). | `-p, --path <path>`, `-r, --root <path>`, `--json` |
93
94
  | `aisdlc verify duplicates` | Detects redundant requirements, ID collisions, title lexical redundancy ($\ge 85\%$), and BDD overlaps before coding. | `-s, --similarity <number>` *(default: 0.85)*, `-r, --root <path>`, `--json` |
95
+ | `aisdlc verify friction [change]` | Evaluates progressive friction and Anti-Bypass rules (verifies change scope matches risk profile: `patch`, `standard`, `critical`). | `-r, --root <path>`, `--json` |
94
96
  | `aisdlc verify security` | Unified shift-left security gate: deterministic secret scanning (Gitleaks) and SAST (OWASP Top 10 vulnerabilities). | `-d, --diff`, `-b, --base <branch>`, `-g, --gitleaks`, `-s, --semgrep`, `-e, --entropy <n>`, `-m, --min-severity <level>`, `--json` |
95
97
  | `aisdlc verify secrets` | Scans for exposed credentials, API keys, tokens, and high-entropy secrets (Shannon entropy $\ge 4.3$). Fails with exit code 4. | `-d, --diff`, `-b, --base <branch>`, `-g, --gitleaks`, `-e, --entropy <n>`, `--json` |
96
98
  | `aisdlc verify sast` | Static Application Security Testing for SQL injection, command injection, eval, SSRF, path traversal, and prompt injection. | `-s, --semgrep`, `-m, --min-severity <CRITICAL\|HIGH\|MEDIUM>`, `--json` |
97
- | `aisdlc verify friction [change]` | Evaluates progressive friction and Anti-Bypass rules (verifies change scope matches risk profile: `patch`, `standard`, `critical`). | `-r, --root <path>`, `--json` |
98
99
 
99
100
  ### 4. Git 4-Tier Branch Management (`aisdlc git`)
100
101
 
@@ -121,6 +122,34 @@ The `aisdlc` CLI provides comprehensive commands across 6 functional categories
121
122
  | --- | --- | --- |
122
123
  | `aisdlc gherkin extract` | Extracts ````gherkin```` blocks from Markdown specifications and synchronizes them to `.feature` files under `tests/features/`. | `-p, --path <path>`, `-a, --all`, `--json`, `-F, --format <format>` |
123
124
 
125
+ ### Automated Code Coverage Ingestion (.NET / Polyglot)
126
+
127
+ `aisdlc report quality` and `aisdlc report dashboard` passively ingest test coverage from standard locations:
128
+ - `coverage/lcov.info` or `reports/lcov.info` (LCOV format)
129
+ - `coverage/coverage-summary.json` or `reports/coverage-summary.json` (Istanbul/JSON summary format)
130
+
131
+ #### Setting up .NET / C# projects:
132
+ 1. Ensure `coverlet.collector` is installed in your test project (`*.Tests.csproj`):
133
+ ```xml
134
+ <PackageReference Include="coverlet.collector" Version="6.*">
135
+ <PrivateAssets>all</PrivateAssets>
136
+ <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
137
+ </PackageReference>
138
+ ```
139
+ 2. Collect coverage and convert Cobertura XML to LCOV format via **ReportGenerator**:
140
+ ```bash
141
+ # Run tests collecting coverage
142
+ dotnet test --collect:"XPlat Code Coverage"
143
+
144
+ # Convert to LCOV for AI-SDLC ingestion
145
+ reportgenerator -reports:"**/coverage.cobertura.xml" -targetdir:"coverage" -reporttypes:lcov
146
+ ```
147
+ 3. Generate reports:
148
+ ```bash
149
+ aisdlc report quality
150
+ aisdlc report dashboard --open
151
+ ```
152
+
124
153
  ### Common Workflow Examples
125
154
 
126
155
  ```bash
@@ -136,7 +165,7 @@ aisdlc git checkout TSK-001
136
165
  # 4. Run pre-flight check with auto-fix (syncs Gherkin and digests)
137
166
  aisdlc check --fix
138
167
 
139
- # 5. Run the consolidated CI/CD verification suite (all 9 gates)
168
+ # 5. Run the consolidated CI/CD verification suite (all 11 gates)
140
169
  aisdlc verify all
141
170
 
142
171
  # 6. Generate the interactive web dashboard and open it in the browser