airgen-cli 0.18.0 → 0.19.0

package/dist/commands/requirements.js

@@ -180,7 +180,9 @@ export function registerRequirementCommands(program, client) {
         .option("--rationale <r>", "Rationale")
         .option("--compliance <status>", "Compliance status")
         .option("--section <id>", "Section ID")
-        .option("--tags <tags>", "Comma-separated tags")
+        .option("--tags <tags>", "Comma-separated tags (replaces all)")
+        .option("--add-tags <tags>", "Comma-separated tags to add (keeps existing)")
+        .option("--remove-tags <tags>", "Comma-separated tags to remove")
         .action(async (tenant, project, id, opts) => {
         const resolvedId = await resolveRequirementId(client, tenant, project, id);
         const body = {};
@@ -196,8 +198,23 @@ export function registerRequirementCommands(program, client) {
             body.complianceStatus = opts.compliance;
         if (opts.section)
             body.sectionId = opts.section;
-        if (opts.tags)
+        if (opts.addTags || opts.removeTags) {
+            // Read-modify-write for add/remove tags
+            const existing = await client.get(`/requirements/${tenant}/${project}/${resolvedId}`);
+            let currentTags = existing.record?.tags ?? [];
+            if (opts.addTags) {
+                const toAdd = opts.addTags.split(",").map(t => t.trim());
+                currentTags = [...new Set([...currentTags, ...toAdd])];
+            }
+            if (opts.removeTags) {
+                const toRemove = new Set(opts.removeTags.split(",").map(t => t.trim()));
+                currentTags = currentTags.filter(t => !toRemove.has(t));
+            }
+            body.tags = currentTags;
+        }
+        else if (opts.tags) {
             body.tags = opts.tags.split(",").map(t => t.trim());
+        }
         await client.patch(`/requirements/${tenant}/${project}/${resolvedId}`, body);
         if (isJsonMode()) {
             output({ ok: true });
@@ -299,7 +316,7 @@ export function registerRequirementCommands(program, client) {
         const data = await client.get(`/requirements/${tenant}/${project}`, params);
         const reqs = data.data ?? [];
         if (isJsonMode()) {
-            output(reqs);
+            output({ data: reqs, meta: { totalItems: reqs.length } });
         }
         else {
             console.log(`Filtered: ${reqs.length} requirements\n`);
@@ -396,22 +413,84 @@ export function registerRequirementCommands(program, client) {
         }
         console.log(`${opts.dryRun ? "Would create" : "Created"} ${created}. Skipped: ${skipped}. Errors: ${errors}.`);
     });
+    // ── bulk-update: update multiple requirements from JSON array ──
+    cmd
+        .command("bulk-update")
+        .description("Update multiple requirements from a JSON file (array of {ref, text?, rationale?, tags?, ...})")
+        .argument("<tenant>", "Tenant slug")
+        .argument("<project>", "Project slug")
+        .requiredOption("--file <path>", "Path to JSON file")
+        .option("--dry-run", "Validate without updating")
+        .action(async (tenant, project, opts) => {
+        const content = readFileSync(opts.file, "utf-8");
+        let items;
+        try {
+            items = JSON.parse(content);
+            if (!Array.isArray(items))
+                throw new Error("File must contain a JSON array");
+        }
+        catch (err) {
+            console.error(`Invalid JSON: ${err.message}`);
+            process.exit(1);
+        }
+        console.error(`Processing ${items.length} update(s)...`);
+        let updated = 0, errors = 0;
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            const ref = String(item.ref ?? item.id ?? "");
+            if (!ref) {
+                console.error(`  [${i}] Skipped: no ref or id`);
+                errors++;
+                continue;
+            }
+            if (opts.dryRun) {
+                console.log(`  [dry-run] ${ref}: would update ${Object.keys(item).filter(k => k !== "ref" && k !== "id").join(", ")}`);
+                updated++;
+                continue;
+            }
+            try {
+                const resolvedId = await resolveRequirementId(client, tenant, project, ref);
+                const body = {};
+                if (item.text)
+                    body.text = item.text;
+                if (item.pattern)
+                    body.pattern = item.pattern;
+                if (item.verification)
+                    body.verification = item.verification;
+                if (item.rationale)
+                    body.rationale = item.rationale;
+                if (item.complianceStatus || item.compliance)
+                    body.complianceStatus = item.complianceStatus ?? item.compliance;
+                if (item.sectionId || item.section)
+                    body.sectionId = item.sectionId ?? item.section;
+                if (item.tags)
+                    body.tags = Array.isArray(item.tags) ? item.tags : String(item.tags).split(",").map(t => t.trim());
+                await client.patch(`/requirements/${tenant}/${project}/${resolvedId}`, body);
+                updated++;
+            }
+            catch (err) {
+                console.error(`  [${i}] ${ref}: ${err.message}`);
+                errors++;
+            }
+        }
+        console.log(`${opts.dryRun ? "Would update" : "Updated"} ${updated}. Errors: ${errors}.`);
+    });
     // ── text-search: search requirements by text content ──
     cmd
         .command("text-search")
         .description("Search requirements by text content (case-insensitive substring match)")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .requiredOption("--text <query>", "Text to search for")
+        .requiredOption("-q, --query <text>", "Text to search for")
         .option("-l, --limit <n>", "Max results", "50")
         .action(async (tenant, project, opts) => {
-        const data = await client.get(`/requirements/${tenant}/${project}`, { textContains: opts.text, limit: opts.limit, sortBy: "ref", sortOrder: "asc" });
+        const data = await client.get(`/requirements/${tenant}/${project}`, { textContains: opts.query, limit: opts.limit, sortBy: "ref", sortOrder: "asc" });
         const reqs = data.data ?? [];
         if (isJsonMode()) {
             output(reqs);
         }
         else {
-            console.log(`Found ${reqs.length} requirement(s) matching "${opts.text}":\n`);
+            console.log(`Found ${reqs.length} requirement(s) matching "${opts.query}":\n`);
             printTable(["Ref", "Text", "Document", "QA"], reqs.map(r => [
                 r.ref ?? "?",
                 truncate(r.text ?? "", 55),

package/dist/commands/traceability.js

@@ -8,16 +8,24 @@ export function registerTraceabilityCommands(program, client) {
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
         .option("--requirement <id>", "Filter by requirement ID")
+        .option("-l, --limit <n>", "Max results to display")
+        .option("--type <type>", "Filter by link type")
         .action(async (tenant, project, opts) => {
         const path = opts.requirement
             ? `/trace-links/${tenant}/${project}/${opts.requirement}`
             : `/trace-links/${tenant}/${project}`;
         const data = await client.get(path);
-        const links = data.traceLinks ?? [];
+        let links = data.traceLinks ?? [];
+        if (opts.type)
+            links = links.filter(l => l.linkType === opts.type);
+        const total = links.length;
+        if (opts.limit)
+            links = links.slice(0, parseInt(opts.limit, 10));
         if (isJsonMode()) {
-            output(links);
+            output({ data: links, meta: { totalItems: total, showing: links.length } });
         }
         else {
+            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 ?? "",

package/package.json

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