airgen-cli 0.20.3 → 0.21.0

package/dist/commands/requirements.js

@@ -137,10 +137,13 @@ export function registerRequirementCommands(program, client) {
         .option("--section <id>", "Section ID")
         .option("--tags <tags>", "Comma-separated tags")
         .option("--idempotency-key <key>", "Prevent duplicates on retry — returns existing if key was already used")
+        .option("--verifies <ref>", "Atomically create a 'verifies' trace link to this requirement ref")
         .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,
@@ -154,6 +157,7 @@ export function registerRequirementCommands(program, client) {
             sectionId: opts.section,
             tags: opts.tags?.split(",").map(t => t.trim()),
             idempotencyKey: opts.idempotencyKey,
+            verifiesRef: opts.verifies,
         });
         if (isJsonMode()) {
             output(data);
@@ -164,6 +168,8 @@ export function registerRequirementCommands(program, client) {
             }
             else {
                 console.log("Requirement created.");
+                if (data.traceLink)
+                    console.log("Trace link (verifies) created.");
             }
             output(data);
         }
@@ -378,6 +384,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/package.json

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