airgen-cli 0.20.2 → 0.20.4

package/dist/commands/requirements.js

@@ -139,8 +139,10 @@ export function registerRequirementCommands(program, client) {
         .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.");
+            console.error("Error: --section or --document is required. Without it, the requirement gets a project-level ref");
+            console.error("       (e.g., REQ-SEEMERGENCYDIESEL...-001) that breaks delete/reassign on long project slugs.");
+            console.error("       Use: airgen docs sections list <tenant> <project> <document> to find section IDs.");
+            process.exit(1);
         }
         const data = await client.post("/requirements", {
             tenant,
@@ -199,8 +201,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 — use original ref for GET (resolvedId may be composite)
-            const existing = await client.get(`/requirements/${tenant}/${project}/${encodeURIComponent(id)}`);
+            // Read-modify-write for add/remove tags
+            const existing = await client.get(`/requirements/${tenant}/${project}/${encodeURIComponent(resolvedId)}`);
             let currentTags = existing.record?.tags ?? [];
             if (opts.addTags) {
                 const toAdd = opts.addTags.split(",").map(t => t.trim());
@@ -378,6 +380,11 @@ export function registerRequirementCommands(program, client) {
                 skipped++;
                 continue;
             }
+            if (!item.document && !item.documentSlug && !item.section && !item.sectionId) {
+                console.error(`  [${i}] Skipped: missing document/section (would create homeless requirement)`);
+                skipped++;
+                continue;
+            }
             if (opts.dryRun) {
                 console.log(`  [dry-run] ${truncate(text, 80)}`);
                 created++;

package/dist/commands/traceability.js

@@ -211,6 +211,12 @@ export function registerTraceabilityCommands(program, client) {
                 try {
                     // Delete old link, create reversed
                     await client.delete(`/trace-links/${tenant}/${project}/${link.id}`);
+                }
+                catch {
+                    console.error(`    Skipped: link ${link.id} not deletable (may be an embedded linkset link)`);
+                    continue;
+                }
+                try {
                     await client.post("/trace-links", {
                         tenant, projectKey: project,
                         sourceRequirementId: link.targetRequirementId,
@@ -222,7 +228,7 @@ export function registerTraceabilityCommands(program, client) {
                     console.log(`    Fixed: reversed to ${targetRef(link)} --${link.linkType}--> ${sourceRef(link)}`);
                 }
                 catch (err) {
-                    console.error(`    Failed to fix: ${err.message}`);
+                    console.error(`    Delete succeeded but reverse create failed: ${err.message}`);
                 }
             }
         }

package/dist/resolve.d.ts

@@ -1,8 +1,11 @@
 /**
- * Resolve any requirement identifier to its full ID.
+ * Resolve any requirement identifier to a ref suitable for API paths.
  *
- * Accepts: full ID, ref, short ID (REQ-XXX), or hashId.
- * Returns the full colon-separated ID (tenant:project:REQ-XXX).
+ * Accepts: full composite ID (tenant:project:REF), ref (STK-REQ-001),
+ * short ID, or hashId.
+ *
+ * Returns the ref string (e.g. STK-REQ-001) — NOT the full composite ID,
+ * since the API route already includes tenant and project in the path.
  */
 import type { AirgenClient } from "./client.js";
 export declare function resolveRequirementId(client: AirgenClient, tenant: string, project: string, identifier: string): Promise<string>;

package/dist/resolve.js

@@ -1,19 +1,23 @@
 /**
- * Resolve any requirement identifier to its full ID.
+ * Resolve any requirement identifier to a ref suitable for API paths.
  *
- * Accepts: full ID, ref, short ID (REQ-XXX), or hashId.
- * Returns the full colon-separated ID (tenant:project:REQ-XXX).
+ * Accepts: full composite ID (tenant:project:REF), ref (STK-REQ-001),
+ * short ID, or hashId.
+ *
+ * Returns the ref string (e.g. STK-REQ-001) — NOT the full composite ID,
+ * since the API route already includes tenant and project in the path.
  */
 export async function resolveRequirementId(client, tenant, project, identifier) {
-    // Already a full ID (contains colons)
+    // Full composite ID (tenant:project:REF) — extract the ref part
     if (identifier.includes(":")) {
-        return identifier;
+        const parts = identifier.split(":");
+        return parts[parts.length - 1];
     }
     // Try as ref first (GET /requirements/{tenant}/{project}/{ref})
     try {
-        const data = await client.get(`/requirements/${tenant}/${project}/${identifier}`);
-        if (data.record?.id)
-            return data.record.id;
+        const data = await client.get(`/requirements/${tenant}/${project}/${encodeURIComponent(identifier)}`);
+        if (data.record?.ref)
+            return data.record.ref;
     }
     catch {
         // Not found by ref — continue
@@ -27,10 +31,10 @@ export async function resolveRequirementId(client, tenant, project, identifier)
         for (const r of reqs) {
             // Match by short ID (the REQ-XXX part of tenant:project:REQ-XXX)
             if (r.id?.endsWith(`:${identifier}`))
-                return r.id;
+                return r.ref ?? identifier;
             // Match by hashId
             if (r.hashId === identifier)
-                return r.id;
+                return r.ref ?? identifier;
         }
         if (page >= (data.meta?.totalPages ?? 1))
             break;

package/package.json

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