@aisdlc/cli 1.3.1 → 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 +34 -5
- package/dist/index.js +1285 -1122
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
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
|
|
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
|
|
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
|