airgen-cli 0.15.0 → 0.16.0

package/dist/commands/diagrams.js

@@ -225,9 +225,13 @@ export function registerDiagramCommands(program, client) {
         .description("List all diagrams in a project")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .action(async (tenant, project) => {
+        .option("--name <name>", "Filter by exact name match")
+        .action(async (tenant, project, opts) => {
         const data = await client.get(`/architecture/diagrams/${tenant}/${project}`);
-        const diagrams = data.diagrams ?? [];
+        let diagrams = data.diagrams ?? [];
+        if (opts.name) {
+            diagrams = diagrams.filter(d => d.name === opts.name);
+        }
         if (isJsonMode()) {
             output(diagrams);
         }
@@ -283,7 +287,11 @@ export function registerDiagramCommands(program, client) {
         if (opts.format === "mermaid") {
             rendered = renderMermaid(blocks, connectors, opts.direction);
             if (opts.clean) {
-                rendered = rendered.split("\n").filter(l => !l.trim().startsWith("classDef ") && !l.trim().startsWith("class ") && !l.trim().startsWith("style ")).join("\n");
+                rendered = rendered
+                    .split("\n")
+                    .filter(l => !l.trim().startsWith("classDef ") && !l.trim().startsWith("class ") && !l.trim().startsWith("style "))
+                    .map(l => l.replace(/<<[^>]+>><br\/>/g, "")) // Strip <<stereotype>><br/> from node labels
+                    .join("\n");
             }
             if (isJsonMode()) {
                 output({ mermaid: rendered, blocks: blocks.length, connectors: connectors.length });

package/dist/commands/requirements.js

@@ -14,7 +14,29 @@ export function registerRequirementCommands(program, client) {
         .option("--order <dir>", "Sort order: asc, desc")
         .option("--tags <tags>", "Comma-separated tags to filter by (server-side)")
         .option("--document <slug>", "Filter by document slug (server-side)")
+        .option("--homeless", "Show only requirements not assigned to any document")
         .action(async (tenant, project, opts) => {
+        // Handle --homeless: fetch all and filter to unassigned
+        if (opts.homeless) {
+            const all = [];
+            for (let page = 1; page <= 50; page++) {
+                const data = await client.get(`/requirements/${tenant}/${project}`, { page: String(page), limit: "500" });
+                all.push(...(data.data ?? []));
+                if (page >= (data.meta?.totalPages ?? 1))
+                    break;
+            }
+            const homeless = all.filter(r => !r.documentSlug);
+            if (isJsonMode()) {
+                output({ data: homeless, meta: { totalItems: homeless.length } });
+            }
+            else {
+                console.log(`Homeless requirements (no document): ${homeless.length}/${all.length}\n`);
+                if (homeless.length > 0) {
+                    printTable(["Ref", "Text", "QA"], homeless.map(r => [r.ref ?? "?", truncate(r.text ?? "", 65), r.qaScore != null ? String(r.qaScore) : "-"]));
+                }
+            }
+            return;
+        }
         // Handle --limit all: fetch all pages
         if (opts.limit.toLowerCase() === "all") {
             const all = [];
@@ -116,6 +138,10 @@ export function registerRequirementCommands(program, client) {
         .option("--tags <tags>", "Comma-separated tags")
         .option("--idempotency-key <key>", "Prevent duplicates on retry — returns existing if key was already used")
         .action(async (tenant, projectKey, opts) => {
+        if (!opts.section && !opts.document) {
+            console.error("Warning: No --section or --document specified. Requirement will be project-level with a generic ref (e.g., REQ-PROJECTNAME-001).");
+            console.error("         Use --section <id> to assign to a document section for proper ref prefixing.");
+        }
         const data = await client.post("/requirements", {
             tenant,
             projectKey,

package/dist/commands/verify.js

@@ -268,31 +268,61 @@ export function registerVerifyCommands(program, client) {
     // ── Engine ─────────────────────────────────────────────
     cmd
         .command("run")
-        .description("Run the verification engine — check for gaps, conflicts, and drift")
+        .description("Run the verification engine — checks both verification activities and 'verifies' trace links")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
         .action(async (tenant, project) => {
-        const data = await client.get(`/verification/engine/${tenant}/${project}`);
-        const report = data.report;
+        // Fetch engine report (activities-based) and trace links in parallel
+        const [engineData, linkData, reqData] = await Promise.all([
+            client.get(`/verification/engine/${tenant}/${project}`).catch(() => ({ report: null })),
+            client.get(`/trace-links/${tenant}/${project}`).catch(() => ({ traceLinks: [] })),
+            client.get(`/requirements/${tenant}/${project}`, { page: "1", limit: "1" }).catch(() => ({ meta: { totalItems: 0 } })),
+        ]);
+        const report = engineData.report;
+        const totalReqs = reqData.meta?.totalItems ?? 0;
+        // Compute trace-link-based coverage (requirements targeted by 'verifies' links)
+        const verifiedByLinks = new Set();
+        for (const link of linkData.traceLinks ?? []) {
+            if (link.linkType === "verifies" && link.targetRequirementId) {
+                verifiedByLinks.add(link.targetRequirementId);
+            }
+        }
+        const traceCoverage = totalReqs > 0 ? Math.round((verifiedByLinks.size / totalReqs) * 100) : 0;
         if (isJsonMode()) {
-            output(report);
+            output({
+                activities: report,
+                traceLinkCoverage: {
+                    totalRequirements: totalReqs,
+                    verifiedByTraceLinks: verifiedByLinks.size,
+                    coveragePercent: traceCoverage,
+                },
+            });
             return;
         }
-        const s = report.summary;
-        console.log(`Verification Report\n`);
-        console.log(`Coverage: ${s.coveragePercent}%  (${s.verified}/${s.totalRequirements} verified)`);
-        console.log(`Unverified: ${s.unverified}  |  Incomplete: ${s.incomplete}  |  Drifted: ${s.driftedEvidence}\n`);
-        if (report.findings.length === 0) {
-            console.log("No findings. All clear.");
+        console.log("Verification Report\n");
+        // Trace link coverage (most common approach)
+        console.log(`Trace Link Coverage: ${traceCoverage}%  (${verifiedByLinks.size}/${totalReqs} have 'verifies' links)`);
+        // Activities coverage (formal V&V workflow)
+        if (report) {
+            const s = report.summary;
+            console.log(`Activity Coverage:   ${s.coveragePercent}%  (${s.verified}/${s.totalRequirements} have verification activities)`);
+            console.log(`  Unverified: ${s.unverified}  |  Incomplete: ${s.incomplete}  |  Drifted: ${s.driftedEvidence}`);
+            if (report.findings.length > 0) {
+                console.log(`\nFindings (${report.findings.length}):`);
+                printTable(["Severity", "Type", "Req", "Message"], report.findings.map(f => [
+                    severityIcon(f.severity) + " " + f.severity,
+                    f.type,
+                    f.requirementRef ?? "",
+                    truncate(f.message, 60),
+                ]));
+            }
         }
         else {
-            printTable(["Severity", "Type", "Req", "Message"], report.findings.map(f => [
-                severityIcon(f.severity) + " " + f.severity,
-                f.type,
-                f.requirementRef ?? "",
-                truncate(f.message, 60),
-            ]));
-            console.log(`\n${report.findings.length} finding(s) total.`);
+            console.log("Activity Coverage:   N/A (no verification activities configured)");
+        }
+        if (traceCoverage === 0 && (!report || report.summary.coveragePercent === 0)) {
+            console.log("\nTip: Create 'verifies' trace links from VER requirements to SYS/SUB requirements,");
+            console.log("or set up verification activities via 'airgen verify activities create'.");
         }
     });
     // ── Matrix ─────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airgen-cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "AIRGen CLI — requirements engineering from the command line",
   "type": "module",
   "main": "dist/index.js",