@aisdlc/cli 1.4.2 → 1.5.1

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,10 +64,23 @@ 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. `--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` |
67
+ | `aisdlc init [directory]` | Bootstraps a repository with AI-SDLC folders, all 29 canonical JSON schemas (Draft 2020-12), 32 base starter templates (Product, Security, Safety, Manuals, Compliance, SDD, CI), Pull Request templates, policies (`quality-policy.yaml`, `license-policy.yaml`), and AI agent configs. Unconditionally generates universal MCP configurations (`antigravity.mcp.json`, `.vscode/mcp.json`, `.cursor/mcp.json`). Non-destructively injects standard npm scripts into consumer `package.json`. In interactive TTY mode, prompts for CI/CD provider, architecture level, and AI agent targets. | `-d, --dry-run`, `--ci <github\|gitlab\|azure\|bitbucket\|none>`, `--agents <all\|cursor\|claude\|antigravity\|copilot\|mcp\|none>`, `--arch <minimal\|full\|none>`, `--json`, `-F, --format <format>` |
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
 
71
+ #### Repository Bootstrapping (`aisdlc init`)
72
+
73
+ Running `aisdlc init` (or `npx @aisdlc/cli init`) delivers a turnkey governance environment:
74
+ 1. **Interactive Guided Prompts (TTY mode)**:
75
+ - **CI/CD Provider**: GitHub Actions (default / recommended), GitLab CI, Azure DevOps Pipelines, Bitbucket Pipelines, or None.
76
+ - **Architecture Granularity**: Minimal / Baseline (default: `ARCH-INTRO-*`, `CMP-*`, `ADR-*`), Full (all 12 arc42 sections), or None.
77
+ - **AI Agents**: All (Cursor, Claude Code, Antigravity, Copilot, MCP - recommended) or granular environments.
78
+ 2. **Universal MCP Integration**: Regardless of CI provider or agent selection, automatically scaffolds `.cursor/mcp.json`, `antigravity.mcp.json`, and `.vscode/mcp.json` preconfigured for `@aisdlc/mcp`.
79
+ 3. **Canonical Starter Templates**: Deploys 32 templates into `templates/` (product, security, safety, manuals, compliance, SDD, and CI/CD reference templates).
80
+ 4. **JSON Schemas (Draft 2020-12)**: Scaffolds all 29 schemas under `schemas/` and provides automatic in-memory fallback during verification if disk files are deleted.
81
+ 5. **Pull Request Templates**: Deposits `.github/PULL_REQUEST_TEMPLATE.md` with non-negotiable Plan Execution Matrix (`[X]` vs `[O]`), Weak Points hotspots, and automated KPI tables.
82
+ 6. **Automatic Script Injection**: Non-destructively registers standard shortcuts in consumer `package.json` (`check`, `check:fix`, `verify:quality`, `verify:all`, `change:new`).
83
+
71
84
  ### 2. Spec-Driven Development (SDD) & Change Management
72
85
 
73
86
  | Command | Description | Key Options |
package/dist/index.js CHANGED
@@ -49,24 +49,30 @@ function isJsonOutput(options = {}) {
49
49
  const env = process.env.AISDLC_FORMAT?.trim().toLowerCase() || process.env.AISDLC_OUTPUT?.trim().toLowerCase();
50
50
  return env === "json";
51
51
  }
52
- function buildQualityViolations(results) {
52
+ function buildFunctionMetricViolations(results) {
53
53
  return results.filter((r) => r.status === "FAIL").flatMap(
54
54
  (r) => r.violations.map((v) => ({
55
55
  file: r.relPath,
56
56
  function: r.functionName,
57
57
  metric: "quality",
58
58
  message: v,
59
- metrics: {
60
- loc: r.loc,
61
- cyclomatic: r.cyclomatic,
62
- cognitive: r.cognitive,
63
- maintainability: r.maintainability
64
- }
59
+ metrics: { loc: r.loc, cyclomatic: r.cyclomatic, cognitive: r.cognitive, maintainability: r.maintainability }
65
60
  }))
66
61
  );
67
62
  }
63
+ function buildQualityViolations(result) {
64
+ const fnViolations = buildFunctionMetricViolations(result.results);
65
+ const untested = (result.untestedFunctions || []).map((u) => ({
66
+ file: u.file,
67
+ function: u.functionName,
68
+ metric: "unit-test",
69
+ message: `Function [${u.functionName}] lacks direct unit test`
70
+ }));
71
+ const cov = (result.coverageViolations || []).map((message) => ({ metric: "coverage", message }));
72
+ return [...fnViolations, ...untested, ...cov];
73
+ }
68
74
  function emitQualityJson(result) {
69
- const violations = buildQualityViolations(result.results);
75
+ const violations = buildQualityViolations(result);
70
76
  const payload = {
71
77
  gate: "quality",
72
78
  success: result.success,
@@ -75,7 +81,9 @@ function emitQualityJson(result) {
75
81
  totalFiles: result.totalFiles,
76
82
  totalFunctions: result.totalFunctions,
77
83
  passCount: result.passCount,
78
- failCount: result.failCount
84
+ failCount: result.failCount,
85
+ untestedFunctionsCount: result.untestedFunctions?.length || 0,
86
+ coverageViolationsCount: result.coverageViolations?.length || 0
79
87
  },
80
88
  violations
81
89
  };
@@ -93,6 +101,18 @@ function printQualityFailingDetails(failing, isPermissive) {
93
101
  console.log(colorFn(` ... and ${failing.length - maxToShow} more functions exceeding thresholds.`));
94
102
  }
95
103
  }
104
+ function printQualityTestAndCoverageGaps(result) {
105
+ const untested = result.untestedFunctions || [];
106
+ if (untested.length > 0) {
107
+ console.log(pc.red("\n Functions lacking unit tests:"));
108
+ for (const u of untested.slice(0, 15)) {
109
+ console.log(` ${pc.red("\u2716")} ${pc.bold(u.file)} [${u.functionName}]`);
110
+ }
111
+ }
112
+ for (const cv of result.coverageViolations || []) {
113
+ console.log(` ${pc.red("\u2716")} ${cv}`);
114
+ }
115
+ }
96
116
  function printQualityConsole(result) {
97
117
  const isPermissive = result.policy.enforce_mode === "PERMISSIVE";
98
118
  console.log(
@@ -105,6 +125,7 @@ function printQualityConsole(result) {
105
125
  if (result.failCount > 0) {
106
126
  printQualityFailingDetails(result.results.filter((r) => r.status === "FAIL"), isPermissive);
107
127
  }
128
+ printQualityTestAndCoverageGaps(result);
108
129
  const tag = isPermissive && result.failCount > 0 ? " (PERMISSIVE mode)" : "";
109
130
  console.log(result.success ? pc.green(`
110
131
  \u2714 Release Gate PASSED${tag}
@@ -137,6 +158,23 @@ function runVerifyQuality(options = {}) {
137
158
  }
138
159
  return result.success;
139
160
  }
161
+ function buildTraceabilityViolations(result) {
162
+ const orphanViolations = result.orphans.map((o) => ({
163
+ id: o.id,
164
+ title: o.title,
165
+ productStatus: o.productStatus,
166
+ archStatus: o.archStatus,
167
+ testStatus: o.testStatus,
168
+ message: `Orphan requirement [${o.id}]`
169
+ }));
170
+ const contractViolations = (result.contractAudits || []).filter((c) => c.status !== "COMPLIANT").map((c) => ({
171
+ id: c.designId,
172
+ method: c.method,
173
+ status: c.status,
174
+ message: `Design contract [${c.designId}] method '${c.method}': ${c.status}`
175
+ }));
176
+ return [...orphanViolations, ...contractViolations];
177
+ }
140
178
  function emitTraceabilityJson(result) {
141
179
  const payload = {
142
180
  gate: "traceability",
@@ -145,19 +183,21 @@ function emitTraceabilityJson(result) {
145
183
  summary: {
146
184
  totalRequirements: result.totalRequirements,
147
185
  conformingCount: result.totalRequirements - result.orphanCount,
148
- orphanCount: result.orphanCount
186
+ orphanCount: result.orphanCount,
187
+ missingContractsCount: result.missingContractsCount || 0
149
188
  },
150
- violations: result.orphans.map((o) => ({
151
- id: o.id,
152
- title: o.title,
153
- productStatus: o.productStatus,
154
- archStatus: o.archStatus,
155
- testStatus: o.testStatus,
156
- message: `Orphan requirement [${o.id}]`
157
- }))
189
+ violations: buildTraceabilityViolations(result)
158
190
  };
159
191
  console.log(JSON.stringify(payload, null, 2));
160
192
  }
193
+ function printMissingContractAudits(result) {
194
+ const failingContracts = (result.contractAudits || []).filter((c) => c.status !== "COMPLIANT");
195
+ if (failingContracts.length === 0) return;
196
+ console.log(pc.red("\n Unfulfilled design contracts (design.md -> src/ & tests/):"));
197
+ for (const c of failingContracts) {
198
+ console.log(` ${pc.red("\u2716")} [${c.designId}] ${c.interfaceName ? `${c.interfaceName}.` : ""}${c.method}: ${c.status}`);
199
+ }
200
+ }
161
201
  function printTraceabilityConsole(result) {
162
202
  console.log(` Total requirements: ${pc.bold(String(result.totalRequirements))}`);
163
203
  console.log(` Compliant requirements: ${pc.green(String(result.totalRequirements - result.orphanCount))}`);
@@ -168,6 +208,7 @@ function printTraceabilityConsole(result) {
168
208
  console.log(` ${pc.red("\u2716")} [${o.id}] Product: ${o.productStatus}, Architecture: ${o.archStatus}, Testing: ${o.testStatus}`);
169
209
  }
170
210
  }
211
+ printMissingContractAudits(result);
171
212
  console.log(result.success ? pc.green("\n\u2714 360\xB0 Traceability COMPLIANT (100%)\n") : pc.red("\n\u2716 Traceability BLOCKED\n"));
172
213
  }
173
214
  function runVerifyTraceability(options = {}) {
@@ -237,22 +278,40 @@ function runVerifyGovernance(options = {}) {
237
278
  }
238
279
  return result.success;
239
280
  }
240
- function buildTestingViolations(result) {
241
- const reqViolations = result.requirements.filter((r) => r.status !== "VERIFICADO_CON_PRUEBA").map((r) => ({
281
+ function formatReqTestingViolationMsg(r) {
282
+ if (r.missingVariants && r.missingVariants.length > 0) {
283
+ return `Requirement [${r.id}] missing BDD variant categories: ${r.missingVariants.join(", ")}`;
284
+ }
285
+ return `Requirement without verifiable test [${r.id}]`;
286
+ }
287
+ function mapReqViolations(requirements) {
288
+ return requirements.filter((r) => r.status !== "VERIFICADO_CON_PRUEBA").map((r) => ({
242
289
  type: "REQUIREMENT",
243
290
  id: r.id,
244
291
  title: r.title,
245
292
  file: r.file,
246
- message: `Requirement without verifiable test [${r.id}]`
293
+ missingVariants: r.missingVariants,
294
+ message: formatReqTestingViolationMsg(r)
247
295
  }));
248
- const taskViolations = result.tasks.filter((t) => t.status !== "VERIFICADO_CON_PRUEBA").map((t) => ({
296
+ }
297
+ function mapTaskViolations(tasks) {
298
+ return tasks.filter((t) => t.status !== "VERIFICADO_CON_PRUEBA").map((t) => ({
249
299
  type: "TASK",
250
300
  id: t.id,
251
301
  title: t.title,
252
302
  file: t.file,
253
303
  message: `Task without test verification [${t.id}]`
254
304
  }));
255
- return [...reqViolations, ...taskViolations];
305
+ }
306
+ function buildTestingViolations(result) {
307
+ const flowViolations = (result.useCaseFlows || []).filter((u) => u.status !== "VERIFICADO_CON_PRUEBA").map((u) => ({
308
+ type: "USE_CASE_FLOW",
309
+ id: u.id,
310
+ file: u.file,
311
+ missingFlows: u.missingFlows,
312
+ message: `Use Case [${u.id}] missing tests for flows: ${u.missingFlows.join(", ")}`
313
+ }));
314
+ return [...mapReqViolations(result.requirements), ...mapTaskViolations(result.tasks), ...flowViolations];
256
315
  }
257
316
  function emitTestingJson(result) {
258
317
  const payload = {
@@ -265,23 +324,31 @@ function emitTestingJson(result) {
265
324
  failedRequirements: result.failedRequirements,
266
325
  totalTasks: result.totalTasks,
267
326
  passedTasks: result.passedTasks,
268
- failedTasks: result.failedTasks
327
+ failedTasks: result.failedTasks,
328
+ failedUseCaseFlows: result.failedUseCaseFlows || 0
269
329
  },
270
330
  violations: buildTestingViolations(result)
271
331
  };
272
332
  console.log(JSON.stringify(payload, null, 2));
273
333
  }
334
+ function printTestingFailures(result) {
335
+ for (const r of result.requirements.filter((req) => req.status !== "VERIFICADO_CON_PRUEBA")) {
336
+ const varHint = r.missingVariants?.length ? ` [Missing BDD variants: ${r.missingVariants.join(", ")}]` : "";
337
+ console.log(` ${pc.red("\u2716")} [Requirement: ${r.id}] ${r.title} (${r.file})${varHint}`);
338
+ }
339
+ for (const t of result.tasks.filter((tsk) => tsk.status !== "VERIFICADO_CON_PRUEBA")) {
340
+ console.log(` ${pc.red("\u2716")} [Task: ${t.id}] ${t.title} (${t.file})`);
341
+ }
342
+ for (const u of (result.useCaseFlows || []).filter((uc) => uc.status !== "VERIFICADO_CON_PRUEBA")) {
343
+ console.log(` ${pc.red("\u2716")} [Use Case Flows: ${u.id}] Missing tests for: ${u.missingFlows.join(", ")} (${u.file})`);
344
+ }
345
+ }
274
346
  function printTestingConsole(result) {
275
347
  console.log(` Verified requirements: ${pc.green(`${result.passedRequirements}/${result.totalRequirements}`)}`);
276
348
  console.log(` Verified tasks: ${pc.green(`${result.passedTasks}/${result.totalTasks}`)}`);
277
- if (result.failedRequirements > 0 || result.failedTasks > 0) {
349
+ if (result.failedRequirements > 0 || result.failedTasks > 0 || (result.failedUseCaseFlows || 0) > 0) {
278
350
  console.log(pc.red("\n Items lacking executable tests:"));
279
- for (const r of result.requirements.filter((r2) => r2.status !== "VERIFICADO_CON_PRUEBA")) {
280
- console.log(` ${pc.red("\u2716")} [Requirement: ${r.id}] ${r.title} (${r.file})`);
281
- }
282
- for (const t of result.tasks.filter((t2) => t2.status !== "VERIFICADO_CON_PRUEBA")) {
283
- console.log(` ${pc.red("\u2716")} [Task: ${t.id}] ${t.title} (${t.file})`);
284
- }
351
+ printTestingFailures(result);
285
352
  }
286
353
  console.log(result.success ? pc.green("\n\u2714 Test Coverage COMPLIANT (100%)\n") : pc.red("\n\u2716 Test Coverage INSUFFICIENT\n"));
287
354
  }
@@ -1381,6 +1448,41 @@ function runGitDetectAuthor(options = {}) {
1381
1448
  import * as readline from "readline/promises";
1382
1449
  import { initProject } from "@aisdlc/core";
1383
1450
  import pc5 from "picocolors";
1451
+ var CI_MENU = [
1452
+ pc5.bold(pc5.cyan("\n\u{1F680} [AI-SDLC] CI/CD Pipeline Provider:")),
1453
+ " 1) " + pc5.green("GitHub Actions") + " (.github/workflows/) " + pc5.yellow("[Recommended]"),
1454
+ " 2) GitLab CI (.gitlab-ci.yml)",
1455
+ " 3) Azure DevOps Pipelines (azure-pipelines.yml)",
1456
+ " 4) Bitbucket Pipelines (bitbucket-pipelines.yml)",
1457
+ " 5) " + pc5.gray("None") + " (Reference templates in templates/ci/ only)"
1458
+ ].join("\n");
1459
+ var CI_CHOICE_MAP = {
1460
+ "1": "github",
1461
+ "2": "gitlab",
1462
+ "3": "azure",
1463
+ "4": "bitbucket",
1464
+ "5": void 0,
1465
+ github: "github",
1466
+ gitlab: "gitlab",
1467
+ azure: "azure",
1468
+ bitbucket: "bitbucket",
1469
+ none: void 0
1470
+ };
1471
+ function parseCiChoice(answer) {
1472
+ const trimmed = answer.trim().toLowerCase();
1473
+ if (!trimmed) return "github";
1474
+ return trimmed in CI_CHOICE_MAP ? CI_CHOICE_MAP[trimmed] : trimmed;
1475
+ }
1476
+ async function promptForCi() {
1477
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
1478
+ console.log(CI_MENU);
1479
+ try {
1480
+ const answer = await rl.question(pc5.bold("\nWhich CI/CD provider do you wish to configure? [1-5] (default 1): "));
1481
+ return parseCiChoice(answer);
1482
+ } finally {
1483
+ rl.close();
1484
+ }
1485
+ }
1384
1486
  function parseArchitectureChoice(answer) {
1385
1487
  const trimmed = answer.trim().toLowerCase();
1386
1488
  if (!trimmed || trimmed === "1" || trimmed === "minimal") return "minimal";
@@ -2087,7 +2189,7 @@ function runChangeNew(options) {
2087
2189
 
2088
2190
  // src/index.ts
2089
2191
  var program = new Command();
2090
- program.name("aisdlc").description("AI-SDLC: Spec-Driven Development, Governance & Quality Gates for AI & Humans").version("1.4.1");
2192
+ program.name("aisdlc").description("AI-SDLC: Spec-Driven Development, Governance & Quality Gates for AI & Humans").version("1.5.1");
2091
2193
  program.command("check").description("Unified pre-flight command: validates Quality Gates with optional non-destructive auto-fix").option("--fix", "Automatically synchronize Gherkin scenarios (.feature) and cryptographic digests of PDaC citations").option("-r, --root <path>", "Project root directory").option("--json", "Emit verification results in structured JSON format").option("-F, --format <format>", "Output format: text or json").action((opts) => {
2092
2194
  const passed = runCheck({
2093
2195
  fix: opts.fix,
@@ -2355,7 +2457,11 @@ sddCommand.command("integrate").description("Integrate and synchronize implement
2355
2457
  program.command("init [directory]").description("Initialize a new repository with AI-SDLC guidelines, schemas, and policies").option("-d, --dry-run", "Simulate file and directory creation without writing to disk").option("--ci <provider>", "CI/CD provider for pipeline generation (github, gitlab, azure, bitbucket)").option("--agents [targets]", "AI agent environments to configure (all, cursor, claude, antigravity, copilot, mcp, or comma-separated combination)").option("--arch, --architecture <granularity>", "Architecture templates granularity level (minimal, full, complete, none)").option("--json", "Structured JSON format output").option("-F, --format <format>", "Output format: text or json").action(async (directory, opts) => {
2356
2458
  let agents = opts.agents;
2357
2459
  let arch = opts.architecture || opts.arch;
2460
+ let ci = opts.ci;
2358
2461
  const isJson = opts.json || opts.format === "json" || process.env.AISDLC_FORMAT === "json" || process.env.AISDLC_OUTPUT === "json";
2462
+ if (ci === void 0 && process.stdin.isTTY && !opts.dryRun && !isJson) {
2463
+ ci = await promptForCi();
2464
+ }
2359
2465
  if (arch === void 0 && process.stdin.isTTY && !opts.dryRun && !isJson) {
2360
2466
  arch = await promptForArchitecture();
2361
2467
  }
@@ -2364,7 +2470,7 @@ program.command("init [directory]").description("Initialize a new repository wit
2364
2470
  }
2365
2471
  const passed = runInit(directory, {
2366
2472
  dryRun: opts.dryRun,
2367
- ci: opts.ci,
2473
+ ci,
2368
2474
  agents,
2369
2475
  architecture: arch,
2370
2476
  json: opts.json,