airgen-cli 0.1.1 → 0.1.2

package/dist/commands/implementation.js

@@ -1,4 +1,5 @@
 import { output } from "../output.js";
+import { resolveRequirementId } from "../resolve.js";
 export function registerImplementationCommands(program, client) {
     const cmd = program.command("impl").description("Implementation tracking");
     cmd
@@ -6,12 +7,12 @@ export function registerImplementationCommands(program, client) {
         .description("Set implementation status on a requirement")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .argument("<requirement-id>", "Requirement ID")
+        .argument("<requirement>", "Requirement ref, ID, or hashId")
         .requiredOption("--status <s>", "Status: not_started, in_progress, implemented, verified, blocked")
         .option("--notes <text>", "Notes")
-        .action(async (tenant, project, requirementId, opts) => {
-        // Implementation status is stored in requirement attributes
-        const data = await client.patch(`/requirements/${tenant}/${project}/${requirementId}`, {
+        .action(async (tenant, project, requirement, opts) => {
+        const resolvedId = await resolveRequirementId(client, tenant, project, requirement);
+        const data = await client.patch(`/requirements/${tenant}/${project}/${resolvedId}`, {
             attributes: {
                 implementationStatus: opts.status,
                 implementationNotes: opts.notes,
@@ -24,17 +25,18 @@ export function registerImplementationCommands(program, client) {
         .description("Link a code artifact to a requirement")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .argument("<requirement-id>", "Requirement ID")
+        .argument("<requirement>", "Requirement ref, ID, or hashId")
         .requiredOption("--type <type>", "Artifact type: file, commit, pr, issue, test, url")
         .requiredOption("--path <path>", "Artifact path/reference")
         .option("--label <text>", "Label")
         .option("--line <n>", "Line number (for file type)")
-        .action(async (tenant, project, requirementId, opts) => {
+        .action(async (tenant, project, requirement, opts) => {
+        const resolvedId = await resolveRequirementId(client, tenant, project, requirement);
         // Fetch current requirement to get existing artifacts
-        const reqData = await client.get(`/requirements/${tenant}/${project}`, { page: "1", limit: "500" });
-        const req = (reqData.data ?? []).find(r => r.id === requirementId);
+        const reqData = await client.get(`/requirements/${tenant}/${project}`, { page: "1", limit: "100" });
+        const req = (reqData.data ?? []).find(r => r.id === resolvedId);
         if (!req) {
-            console.error(`Requirement ${requirementId} not found.`);
+            console.error(`Requirement ${requirement} not found.`);
             process.exit(1);
         }
         const attrs = req.attributes ?? {};
@@ -45,7 +47,7 @@ export function registerImplementationCommands(program, client) {
         if (opts.line)
             newArtifact.line = parseInt(opts.line, 10);
         artifacts.push(newArtifact);
-        await client.patch(`/requirements/${tenant}/${project}/${requirementId}`, {
+        await client.patch(`/requirements/${tenant}/${project}/${resolvedId}`, {
             attributes: { ...attrs, artifacts },
         });
         console.log("Artifact linked.");
@@ -55,20 +57,21 @@ export function registerImplementationCommands(program, client) {
         .description("Remove an artifact link from a requirement")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .argument("<requirement-id>", "Requirement ID")
+        .argument("<requirement>", "Requirement ref, ID, or hashId")
         .requiredOption("--type <type>", "Artifact type")
         .requiredOption("--path <path>", "Artifact path")
-        .action(async (tenant, project, requirementId, opts) => {
-        const reqData = await client.get(`/requirements/${tenant}/${project}`, { page: "1", limit: "500" });
-        const req = (reqData.data ?? []).find(r => r.id === requirementId);
+        .action(async (tenant, project, requirement, opts) => {
+        const resolvedId = await resolveRequirementId(client, tenant, project, requirement);
+        const reqData = await client.get(`/requirements/${tenant}/${project}`, { page: "1", limit: "100" });
+        const req = (reqData.data ?? []).find(r => r.id === resolvedId);
         if (!req) {
-            console.error(`Requirement ${requirementId} not found.`);
+            console.error(`Requirement ${requirement} not found.`);
             process.exit(1);
         }
         const attrs = req.attributes ?? {};
         const artifacts = attrs.artifacts ?? [];
         const filtered = artifacts.filter(a => !(a.type === opts.type && a.path === opts.path));
-        await client.patch(`/requirements/${tenant}/${project}/${requirementId}`, {
+        await client.patch(`/requirements/${tenant}/${project}/${resolvedId}`, {
             attributes: { ...attrs, artifacts: filtered },
         });
         console.log("Artifact unlinked.");

package/dist/commands/requirements.js

@@ -1,4 +1,5 @@
 import { output, printTable, isJsonMode, truncate } from "../output.js";
+import { resolveRequirementId } from "../resolve.js";
 export function registerRequirementCommands(program, client) {
     const cmd = program.command("requirements").alias("reqs").description("Manage requirements");
     cmd
@@ -96,7 +97,7 @@ export function registerRequirementCommands(program, client) {
         .description("Update a requirement")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .argument("<id>", "Requirement ID")
+        .argument("<id>", "Requirement ref, ID, or hashId")
         .option("--text <text>", "Requirement text")
         .option("--pattern <p>", "Pattern")
         .option("--verification <v>", "Verification method")
@@ -105,6 +106,7 @@ export function registerRequirementCommands(program, client) {
         .option("--section <id>", "Section ID")
         .option("--tags <tags>", "Comma-separated tags")
         .action(async (tenant, project, id, opts) => {
+        const resolvedId = await resolveRequirementId(client, tenant, project, id);
         const body = {};
         if (opts.text)
             body.text = opts.text;
@@ -120,7 +122,7 @@ export function registerRequirementCommands(program, client) {
             body.sectionId = opts.section;
         if (opts.tags)
             body.tags = opts.tags.split(",").map(t => t.trim());
-        await client.patch(`/requirements/${tenant}/${project}/${id}`, body);
+        await client.patch(`/requirements/${tenant}/${project}/${resolvedId}`, body);
         if (isJsonMode()) {
             output({ ok: true });
         }
@@ -133,9 +135,10 @@ export function registerRequirementCommands(program, client) {
         .description("Soft-delete a requirement")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .argument("<id>", "Requirement ID")
+        .argument("<id>", "Requirement ref, ID, or hashId")
         .action(async (tenant, project, id) => {
-        await client.delete(`/requirements/${tenant}/${project}/${id}`);
+        const resolvedId = await resolveRequirementId(client, tenant, project, id);
+        await client.delete(`/requirements/${tenant}/${project}/${resolvedId}`);
         console.log("Requirement deleted.");
     });
     cmd
@@ -143,9 +146,10 @@ export function registerRequirementCommands(program, client) {
         .description("Get version history of a requirement")
         .argument("<tenant>", "Tenant slug")
         .argument("<project>", "Project slug")
-        .argument("<id>", "Requirement ID")
+        .argument("<id>", "Requirement ref, ID, or hashId")
         .action(async (tenant, project, id) => {
-        const data = await client.get(`/requirements/${tenant}/${project}/${id}/history`);
+        const resolvedId = await resolveRequirementId(client, tenant, project, id);
+        const data = await client.get(`/requirements/${tenant}/${project}/${resolvedId}/history`);
         output(data);
     });
     cmd

package/dist/resolve.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve any requirement identifier to its full ID.
+ *
+ * Accepts: full ID, ref, short ID (REQ-XXX), or hashId.
+ * Returns the full colon-separated ID (tenant:project:REQ-XXX).
+ */
+import type { AirgenClient } from "./client.js";
+export declare function resolveRequirementId(client: AirgenClient, tenant: string, project: string, identifier: string): Promise<string>;

package/dist/resolve.js

@@ -0,0 +1,41 @@
+/**
+ * Resolve any requirement identifier to its full ID.
+ *
+ * Accepts: full ID, ref, short ID (REQ-XXX), or hashId.
+ * Returns the full colon-separated ID (tenant:project:REQ-XXX).
+ */
+export async function resolveRequirementId(client, tenant, project, identifier) {
+    // Already a full ID (contains colons)
+    if (identifier.includes(":")) {
+        return identifier;
+    }
+    // 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;
+    }
+    catch {
+        // Not found by ref — continue
+    }
+    // Search through requirements for short ID or hashId match
+    let page = 1;
+    const limit = 100;
+    while (true) {
+        const data = await client.get(`/requirements/${tenant}/${project}`, { page: String(page), limit: String(limit) });
+        const reqs = data.data ?? [];
+        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;
+            // Match by hashId
+            if (r.hashId === identifier)
+                return r.id;
+        }
+        if (page >= (data.meta?.totalPages ?? 1))
+            break;
+        page++;
+    }
+    // Nothing found — return as-is and let the API error
+    return identifier;
+}

package/package.json

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