airgen-cli 0.19.0 → 0.20.0

package/dist/commands/requirements.js

@@ -199,8 +199,8 @@ export function registerRequirementCommands(program, client) {
         if (opts.section)
             body.sectionId = opts.section;
         if (opts.addTags || opts.removeTags) {
-            // Read-modify-write for add/remove tags
-            const existing = await client.get(`/requirements/${tenant}/${project}/${resolvedId}`);
+            // Read-modify-write for add/remove tags — use original ref for GET (resolvedId may be composite)
+            const existing = await client.get(`/requirements/${tenant}/${project}/${encodeURIComponent(id)}`);
             let currentTags = existing.record?.tags ?? [];
             if (opts.addTags) {
                 const toAdd = opts.addTags.split(",").map(t => t.trim());

package/dist/commands/traceability.js

@@ -1,5 +1,11 @@
 import { readFileSync } from "node:fs";
 import { output, printTable, isJsonMode } from "../output.js";
+function sourceRef(l) {
+    return l.sourceRequirement?.ref ?? l.sourceRequirementId ?? "";
+}
+function targetRef(l) {
+    return l.targetRequirement?.ref ?? l.targetRequirementId ?? "";
+}
 export function registerTraceabilityCommands(program, client) {
     const cmd = program.command("traces").alias("trace").description("Traceability links");
     cmd
@@ -28,8 +34,8 @@ export function registerTraceabilityCommands(program, client) {
             console.log(`Trace links: ${links.length}${total > links.length ? ` of ${total}` : ""}\n`);
             printTable(["ID", "Source", "Target", "Type", "Description"], links.map(l => [
                 l.id,
-                l.sourceRef ?? l.sourceRequirementId ?? "",
-                l.targetRef ?? l.targetRequirementId ?? "",
+                sourceRef(l),
+                targetRef(l),
                 l.linkType ?? "",
                 l.description ?? "",
             ]));
@@ -164,6 +170,66 @@ export function registerTraceabilityCommands(program, client) {
         }
         console.log(`${opts.dryRun ? "Would create" : "Created"} ${created} trace links. Errors: ${errors}.`);
     });
+    // ── trace validate: check link direction conventions ──
+    cmd
+        .command("validate")
+        .description("Validate trace link directions against SE conventions (derives: parent→child, verifies: VER→target)")
+        .argument("<tenant>", "Tenant slug")
+        .argument("<project>", "Project slug")
+        .option("--fix", "Reverse incorrectly directed links")
+        .action(async (tenant, project, opts) => {
+        const data = await client.get(`/trace-links/${tenant}/${project}`);
+        const links = data.traceLinks ?? [];
+        // Infer document tier from ref prefix
+        const tierOrder = { STK: 0, SYS: 1, IFC: 2, SUB: 3, ARC: 2, VER: 4, HAZ: 1 };
+        function refTier(ref) {
+            const prefix = ref.split("-")[0];
+            return tierOrder[prefix] ?? -1;
+        }
+        const issues = [];
+        for (const l of links) {
+            const src = sourceRef(l);
+            const tgt = targetRef(l);
+            const srcTier = refTier(src);
+            const tgtTier = refTier(tgt);
+            if (l.linkType === "derives" && srcTier > tgtTier && srcTier >= 0 && tgtTier >= 0) {
+                issues.push({ link: l, reason: `derives should flow parent→child (${src} tier ${srcTier} > ${tgt} tier ${tgtTier})` });
+            }
+            if (l.linkType === "verifies" && !src.startsWith("VER-") && tgt.startsWith("VER-")) {
+                issues.push({ link: l, reason: `verifies should flow VER→target, not ${src}→${tgt}` });
+            }
+        }
+        if (issues.length === 0) {
+            console.log(`All ${links.length} trace links pass direction validation.`);
+            return;
+        }
+        console.log(`Found ${issues.length} direction issue(s):\n`);
+        for (const { link, reason } of issues) {
+            console.log(`  ${sourceRef(link)} --${link.linkType}--> ${targetRef(link)}`);
+            console.log(`    ${reason}`);
+            if (opts.fix) {
+                try {
+                    // Delete old link, create reversed
+                    await client.delete(`/trace-links/${tenant}/${project}/${link.id}`);
+                    await client.post("/trace-links", {
+                        tenant, projectKey: project,
+                        sourceRequirementId: link.targetRequirementId,
+                        targetRequirementId: link.sourceRequirementId,
+                        linkType: link.linkType,
+                        description: link.description,
+                        rationale: link.rationale,
+                    });
+                    console.log(`    Fixed: reversed to ${targetRef(link)} --${link.linkType}--> ${sourceRef(link)}`);
+                }
+                catch (err) {
+                    console.error(`    Failed to fix: ${err.message}`);
+                }
+            }
+        }
+        if (!opts.fix) {
+            console.log(`\nUse --fix to reverse these links.`);
+        }
+    });
     // Linksets
     const linksets = cmd.command("linksets").description("Document linksets");
     linksets

package/package.json

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