@primitive.ai/prim 0.1.0-alpha.13 → 0.1.0-alpha.14

package/SKILL.md

@@ -83,9 +83,13 @@ npx --yes @primitive.ai/prim project create -n "<name>" --spec <contextId>     #
 
 ### Install the pre-commit hook
 ```
-npx --yes @primitive.ai/prim hooks install     # auto-detects Husky and prompts
+npx --yes @primitive.ai/prim hooks install                       # auto-detects Husky and prompts
+npx --yes @primitive.ai/prim hooks install --yes                 # confirm Husky (non-interactive)
+npx --yes @primitive.ai/prim hooks install --target=git-hooks    # force .git/hooks (skip Husky detection)
 npx --yes @primitive.ai/prim hooks uninstall
 ```
+Under `CI=1` (or with `--non-interactive`), `hooks install` fails fast in a Husky repo unless `--yes` or `--target` is set. The error message names both escapes.
+
 **Note:** `hooks uninstall` only removes `.git/hooks/pre-commit`. If the hook was installed into `.husky/pre-commit`, you must remove the prim block from that file manually.
 
 ## How the pre-commit hook behaves
@@ -106,17 +110,26 @@ What that means:
 
 ## Output formats
 
-| Command | Output | Where the ID is |
+Every data-returning command accepts `--json`. With `--json` set, stdout is a single JSON document — pipe to `jq` instead of parsing text:
+
+- `id=$(npx --yes @primitive.ai/prim context create -s global -n foo --text "x" --json | jq -r ._id)` — capture an ID
+- `npx --yes @primitive.ai/prim spec list --json | jq -r '.[]._id'` — list every spec ID
+- `npx --yes @primitive.ai/prim auth status --json | jq -r .authenticated` — boolean; the exit code remains the authoritative signal
+
+Without `--json`, mutating commands (`context create/update/delete/link/unlink`, `spec update/sync/map/unmap/auto-map`, `project create`) emit the bare resource `_id` to **stdout** (one line, no prefix) and human-readable diagnostics to **stderr**. So this also works as a one-liner without `jq`:
+
+- `id=$(npx --yes @primitive.ai/prim context create -s global -n foo --text "x")`
+
+| Command | Without `--json` | With `--json` |
 |---|---|---|
-| `npx --yes @primitive.ai/prim context create` | `Created context: <id>` | Match `^Created context: (\S+)` |
-| `npx --yes @primitive.ai/prim project create` | `Created project: <id>` | Match `^Created project: (\S+)` |
-| `npx --yes @primitive.ai/prim spec update` | `Updated spec: <id>` | Match `^Updated spec: (\S+)` |
-| `npx --yes @primitive.ai/prim spec sync` | `Triggered sync for spec: <id>` | Match `^Triggered sync for spec: (\S+)` |
-| `npx --yes @primitive.ai/prim context list`, `npx --yes @primitive.ai/prim spec list` | Table with trailing count line | First token of each row (skip the final `N spec(s)` / `N context(s)` summary line) |
-| `npx --yes @primitive.ai/prim spec list --project-id <pid>` | Single-spec block (key:value) | `ID:` line |
-| `npx --yes @primitive.ai/prim context get <id>` | Pretty-printed JSON | `._id` field |
-| `npx --yes @primitive.ai/prim spec get <id>` | Human-readable key:value block | `ID:` line |
-| `npx --yes @primitive.ai/prim spec get <id> --text-only` | Raw spec markdown, nothing else | n/a |
+| Mutators above | stdout: bare `_id`; stderr: `Created/Updated/...` prefix (plus secondary lines: `Root project:`, `Linked spec:`, pattern lists) | stdout: `{ "_id": "<id>", … }` with extras where applicable (`spec sync` adds `specRootTaskId`; `context link/unlink` add `project`; `project create --spec` adds `spec`; `spec map/unmap` add `filePatterns`) |
+| `context list`, `spec list` (non-empty) | stdout: rows (first token = `_id`); stderr: `N context(s)` / `N spec(s)` summary | stdout: JSON array |
+| `context list`, `spec list` (empty) | stdout: (empty); stderr: `No contexts found.` / `No spec documents found.` | stdout: `[]` |
+| `spec list --project-id <pid>` | stdout: key:value block (or stdout empty + stderr `No spec document found for this project.` if none) | stdout: single object or `null` |
+| `context get <id>` | stdout: pretty-printed JSON (always JSON; `--json` accepted for symmetry) | stdout: pretty-printed JSON |
+| `spec get <id>` | stdout: human-readable key:value block (`ID:` line first) | stdout: JSON object |
+| `spec get <id> --text-only` | stdout: raw spec markdown, nothing else | stdout: JSON object (`--json` wins over `--text-only`) |
+| `auth status` | stdout: human readout; **exit code is the authoritative signal** (0 = authed) | stdout: JSON; exit code unchanged |
 
 ## Pitfalls
 

package/dist/index.js

@@ -24,6 +24,13 @@ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { createServer } from "http";
 import { platform } from "os";
 import { dirname } from "path";
+
+// src/output.ts
+function printJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+// src/commands/auth.ts
 var FILE_MODE = 384;
 var LOCALHOST = "127.0.0.1";
 var CALLBACK_PORT = 19876;
@@ -174,8 +181,22 @@ ${authUrl.toString()}
       console.log("No saved tokens found.");
     }
   });
-  auth.command("status").description("Check authentication status and token expiry").action(() => {
+  auth.command("status").description("Check authentication status and token expiry").option("--json", "Output as JSON").action((opts) => {
     const token = getAuthToken();
+    if (opts.json) {
+      const expiresAt2 = getTokenExpiresAt();
+      const expiresInMs = expiresAt2 ? expiresAt2 - Date.now() : null;
+      const refreshPresent = existsSync(REFRESH_TOKEN_PATH);
+      printJson({
+        authenticated: !!token,
+        tokenFile: token ? TOKEN_FILE_PATH : null,
+        accessTokenExpiresInMs: expiresInMs,
+        accessTokenExpired: expiresInMs !== null && expiresInMs <= 0,
+        refreshTokenPresent: refreshPresent,
+        warnings: !token || refreshPresent ? [] : ["no refresh token"]
+      });
+      process.exit(token ? 0 : 1);
+    }
     if (!token) {
       console.log("Not authenticated. Run `prim auth login` to authenticate.");
       process.exit(1);
@@ -238,7 +259,7 @@ async function exchangeCode(siteUrl, code, codeVerifier, redirectUri) {
 import { readFileSync as readFileSync2 } from "fs";
 function registerContextCommands(program2) {
   const context = program2.command("context").description("Manage contexts");
-  context.command("list").description("List contexts").option("-s, --scope <scope>", "Filter by scope: project, global, external").option("-t, --project-id <projectId>", "List contexts linked to a specific project").action(async (opts) => {
+  context.command("list").description("List contexts").option("-s, --scope <scope>", "Filter by scope: project, global, external").option("-t, --project-id <projectId>", "List contexts linked to a specific project").option("--json", "Output as JSON").action(async (opts) => {
     const client = getClient();
     const params = new URLSearchParams();
     if (opts.projectId) {
@@ -248,14 +269,18 @@ function registerContextCommands(program2) {
       params.set("scope", opts.scope === "project" ? "task" : opts.scope);
     }
     const contexts = await client.get(`/api/cli/contexts?${params.toString()}`);
+    if (opts.json) {
+      printJson(contexts);
+      return;
+    }
     printContextList(contexts);
   });
-  context.command("get <contextId>").description("Get a context by ID").action(async (contextId) => {
+  context.command("get <contextId>").description("Get a context by ID").option("--json", "Output as JSON (default behavior; accepted for symmetry)").action(async (contextId) => {
     const client = getClient();
     const ctx = await client.get(`/api/cli/contexts/${contextId}`);
-    console.log(JSON.stringify(ctx, null, 2));
+    printJson(ctx);
   });
-  context.command("create").description("Create a new context").requiredOption("-s, --scope <scope>", "Scope: project, global, external").requiredOption("-n, --name <name>", "Context name").option("-t, --text <text>", "Context text content").option("-f, --file <path>", "Read text content from file").option("--project-id <projectId>", "Link to project(s), comma-separated").option("--spec", "Mark as a spec document").action(
+  context.command("create").description("Create a new context").requiredOption("-s, --scope <scope>", "Scope: project, global, external").requiredOption("-n, --name <name>", "Context name").option("-t, --text <text>", "Context text content").option("-f, --file <path>", "Read text content from file").option("--project-id <projectId>", "Link to project(s), comma-separated").option("--spec", "Mark as a spec document").option("--json", "Output as JSON").action(
     async (opts) => {
       const client = getClient();
       let text = opts.text;
@@ -270,44 +295,71 @@ function registerContextCommands(program2) {
         taskIds,
         isSpecDocument: opts.spec ?? false
       });
-      console.log(`Created context: ${result._id}`);
+      if (opts.json) {
+        printJson({ _id: result._id });
+        return;
+      }
+      console.error(`Created context: ${result._id}`);
+      console.log(result._id);
     }
   );
-  context.command("update <contextId>").description("Update a context").option("-n, --name <name>", "New name").option("-t, --text <text>", "New text content").option("-f, --file <path>", "Read text content from file").action(async (contextId, opts) => {
-    const client = getClient();
-    let text = opts.text;
-    if (opts.file) {
-      text = readFileSync2(opts.file, "utf-8");
+  context.command("update <contextId>").description("Update a context").option("-n, --name <name>", "New name").option("-t, --text <text>", "New text content").option("-f, --file <path>", "Read text content from file").option("--json", "Output as JSON").action(
+    async (contextId, opts) => {
+      const client = getClient();
+      let text = opts.text;
+      if (opts.file) {
+        text = readFileSync2(opts.file, "utf-8");
+      }
+      await client.patch(`/api/cli/contexts/${contextId}`, {
+        name: opts.name,
+        text
+      });
+      if (opts.json) {
+        printJson({ _id: contextId });
+        return;
+      }
+      console.error(`Updated context: ${contextId}`);
+      console.log(contextId);
     }
-    await client.patch(`/api/cli/contexts/${contextId}`, {
-      name: opts.name,
-      text
-    });
-    console.log(`Updated context: ${contextId}`);
-  });
-  context.command("delete <contextId>").description("Delete a context").action(async (contextId) => {
+  );
+  context.command("delete <contextId>").description("Delete a context").option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     await client.delete(`/api/cli/contexts/${contextId}`);
-    console.log(`Deleted context: ${contextId}`);
+    if (opts.json) {
+      printJson({ _id: contextId });
+      return;
+    }
+    console.error(`Deleted context: ${contextId}`);
+    console.log(contextId);
   });
-  context.command("link <contextId>").description("Link a context to a project").requiredOption("--project <projectId>", "Project ID to link to").action(async (contextId, opts) => {
+  context.command("link <contextId>").description("Link a context to a project").requiredOption("--project <projectId>", "Project ID to link to").option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     await client.post(`/api/cli/contexts/${contextId}/link`, {
       taskId: opts.project
     });
-    console.log(`Linked context ${contextId} to project ${opts.project}`);
+    if (opts.json) {
+      printJson({ _id: contextId, project: opts.project });
+      return;
+    }
+    console.error(`Linked context ${contextId} to project ${opts.project}`);
+    console.log(contextId);
   });
-  context.command("unlink <contextId>").description("Unlink a context from a project").requiredOption("--project <projectId>", "Project ID to unlink from").action(async (contextId, opts) => {
+  context.command("unlink <contextId>").description("Unlink a context from a project").requiredOption("--project <projectId>", "Project ID to unlink from").option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     await client.post(`/api/cli/contexts/${contextId}/unlink`, {
       taskId: opts.project
     });
-    console.log(`Unlinked context ${contextId} from project ${opts.project}`);
+    if (opts.json) {
+      printJson({ _id: contextId, project: opts.project });
+      return;
+    }
+    console.error(`Unlinked context ${contextId} from project ${opts.project}`);
+    console.log(contextId);
   });
 }
 function printContextList(contexts) {
   if (contexts.length === 0) {
-    console.log("No contexts found.");
+    console.error("No contexts found.");
     return;
   }
   for (const ctx of contexts) {
@@ -316,7 +368,7 @@ function printContextList(contexts) {
     const name = ctx.name ?? ctx.title ?? "(unnamed)";
     console.log(`${ctx._id}  ${scope.padEnd(8)} ${name}${spec}`);
   }
-  console.log(`
+  console.error(`
 ${contexts.length} context(s)`);
 }
 
@@ -324,6 +376,7 @@ ${contexts.length} context(s)`);
 import { execSync } from "child_process";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
+import { Option } from "commander";
 var HOOK_SCRIPT = `#!/bin/sh
 # prim pre-commit hook \u2014 auto-syncs affected specs on commit
 # Installed by: prim hooks install
@@ -431,17 +484,37 @@ function installToDotGit(gitRoot) {
 }
 function registerHooksCommands(program2) {
   const hooks = program2.command("hooks").description("Manage git hooks");
-  hooks.command("install").description("Install the prim pre-commit hook").action(async () => {
+  hooks.command("install").description("Install the prim pre-commit hook (auto-detects Husky; use --target to override)").addOption(
+    new Option("--target <where>", "install destination; bypasses Husky detection").choices([
+      "husky",
+      "git-hooks"
+    ])
+  ).action(async (opts, command) => {
+    const globals = command.optsWithGlobals();
+    const nonInteractive = Boolean(
+      globals.nonInteractive || process.env.CI || process.env.PRIM_NON_INTERACTIVE
+    );
     const gitRoot = getGitRoot();
+    if (opts.target === "husky") return installToHusky(gitRoot);
+    if (opts.target === "git-hooks") return installToDotGit(gitRoot);
     if (detectHusky(gitRoot)) {
-      const confirmed = await askConfirmation(
+      if (globals.yes) return installToHusky(gitRoot);
+      if (nonInteractive) {
+        throw new Error(
+          "--non-interactive set, refusing to prompt for Husky-hook installation. Pass --yes to confirm or --target=git-hooks to choose."
+        );
+      }
+      if (!process.stdin.isTTY) {
+        console.error(
+          "Note: Husky detected but stdin is not a TTY \u2014 falling back to .git/hooks. Pass --yes for Husky or --non-interactive to fail fast."
+        );
+      } else if (await askConfirmation(
         "Husky detected. Install prim hook into .husky/pre-commit instead of .git/hooks/pre-commit?"
-      );
-      if (confirmed) {
-        installToHusky(gitRoot);
-        return;
+      )) {
+        return installToHusky(gitRoot);
+      } else {
+        console.log("Falling back to .git/hooks/pre-commit install.");
       }
-      console.log("Falling back to .git/hooks/pre-commit install.");
     }
     installToDotGit(gitRoot);
   });
@@ -460,17 +533,22 @@ function registerHooksCommands(program2) {
 // src/commands/project.ts
 function registerProjectCommands(program2) {
   const project = program2.command("project").description("Manage projects");
-  project.command("create").description("Create a new project").requiredOption("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("--spec <contextId>", "Link an existing spec as this project's spec").action(async (opts) => {
+  project.command("create").description("Create a new project").requiredOption("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("--spec <contextId>", "Link an existing spec as this project's spec").option("--json", "Output as JSON").action(async (opts) => {
     const client = getClient();
     const result = await client.post("/api/cli/tasks", {
       name: opts.name,
       description: opts.description,
       specContextId: opts.spec
     });
-    console.log(`Created project: ${result._id}`);
+    if (opts.json) {
+      printJson(opts.spec ? { _id: result._id, spec: opts.spec } : { _id: result._id });
+      return;
+    }
+    console.error(`Created project: ${result._id}`);
     if (opts.spec) {
-      console.log(`Linked spec: ${opts.spec}`);
+      console.error(`Linked spec: ${opts.spec}`);
     }
+    console.log(result._id);
   });
 }
 
@@ -592,12 +670,21 @@ function runUninstall(cwd, opts) {
 function runStatus(cwd, opts) {
   const target = resolveTarget(cwd, opts.target);
   if (target === null) return 1;
-  if (!existsSync3(target)) {
+  const fileExists = existsSync3(target);
+  let installed = false;
+  if (fileExists) {
+    const content = readFileSync4(target, "utf-8");
+    installed = content.includes(SKILL_BEGIN) && content.includes(SKILL_END);
+  }
+  if (opts.json) {
+    printJson({ installed, target });
+    return installed ? 0 : 1;
+  }
+  if (!fileExists) {
     console.log(`No rules file at ${target}`);
     return 1;
   }
-  const content = readFileSync4(target, "utf-8");
-  if (content.includes(SKILL_BEGIN) && content.includes(SKILL_END)) {
+  if (installed) {
     console.log(`PRIM SKILL v1 installed at ${target}`);
     return 0;
   }
@@ -617,7 +704,7 @@ function registerSkillCommands(program2) {
   skill.command("uninstall").description("Remove the prim skill block from your project rules file").option("--target <path>", "Path to the rules file (overrides auto-detection)").action((opts) => {
     process.exit(runUninstall(process.cwd(), opts));
   });
-  skill.command("status").description("Report whether the prim skill block is installed").option("--target <path>", "Path to the rules file (overrides auto-detection)").action((opts) => {
+  skill.command("status").description("Report whether the prim skill block is installed").option("--target <path>", "Path to the rules file (overrides auto-detection)").option("--json", "Output as JSON").action((opts) => {
     process.exit(runStatus(process.cwd(), opts));
   });
 }
@@ -626,20 +713,28 @@ function registerSkillCommands(program2) {
 import { readFileSync as readFileSync5 } from "fs";
 function registerSpecCommands(program2) {
   const spec = program2.command("spec").description("Manage spec documents");
-  spec.command("list").description("List spec documents").option("-t, --project-id <projectId>", "List spec for a specific root project").action(async (opts) => {
+  spec.command("list").description("List spec documents").option("-t, --project-id <projectId>", "List spec for a specific root project").option("--json", "Output as JSON").action(async (opts) => {
     const client = getClient();
     if (opts.projectId) {
       const specs = await client.get(`/api/cli/specs?rootTaskId=${opts.projectId}`);
+      if (opts.json) {
+        printJson(specs[0] ?? null);
+        return;
+      }
       if (specs.length === 0) {
-        console.log("No spec document found for this project.");
+        console.error("No spec document found for this project.");
         return;
       }
       printSpec(specs[0]);
       return;
     }
     const contexts = await client.get("/api/cli/specs");
+    if (opts.json) {
+      printJson(contexts);
+      return;
+    }
     if (contexts.length === 0) {
-      console.log("No spec documents found.");
+      console.error("No spec documents found.");
       return;
     }
     for (const ctx of contexts) {
@@ -648,39 +743,50 @@ function registerSpecCommands(program2) {
       const name = ctx.name ?? "(unnamed)";
       console.log(`${ctx._id}  ${scope.padEnd(8)} ${String(review).padEnd(10)} ${name}`);
     }
-    console.log(`
+    console.error(`
 ${contexts.length} spec(s)`);
   });
-  spec.command("get <contextId>").description("Get a spec document by ID").option("--text-only", "Print only the text content (no metadata)").action(async (contextId, opts) => {
+  spec.command("get <contextId>").description("Get a spec document by ID").option("--text-only", "Print only the text content (no metadata)").option("--json", "Output as JSON (overrides --text-only)").action(async (contextId, opts) => {
     const client = getClient();
     const ctx = await client.get(`/api/cli/contexts/${contextId}`);
+    if (opts.json) {
+      printJson(ctx);
+      return;
+    }
     if (opts.textOnly) {
       console.log(ctx.text ?? "");
       return;
     }
     printSpec(ctx);
   });
-  spec.command("update <contextId>").description("Update a spec document's text content").option("-t, --text <text>", "New text content").option("-f, --file <path>", "Read text content from file").option("-n, --name <name>", "New name").action(async (contextId, opts) => {
-    const client = getClient();
-    let text = opts.text;
-    if (opts.file) {
-      text = readFileSync5(opts.file, "utf-8");
-    }
-    if (!(text || opts.name)) {
-      console.error("Provide --text, --file, or --name to update.");
-      process.exit(1);
-    }
-    await client.patch(`/api/cli/contexts/${contextId}`, {
-      name: opts.name,
-      text,
-      skipTiptapLifecycle: !!text
-    });
-    if (text) {
-      await client.post(`/api/cli/contexts/${contextId}/inject`);
+  spec.command("update <contextId>").description("Update a spec document's text content").option("-t, --text <text>", "New text content").option("-f, --file <path>", "Read text content from file").option("-n, --name <name>", "New name").option("--json", "Output as JSON").action(
+    async (contextId, opts) => {
+      const client = getClient();
+      let text = opts.text;
+      if (opts.file) {
+        text = readFileSync5(opts.file, "utf-8");
+      }
+      if (!(text || opts.name)) {
+        console.error("Provide --text, --file, or --name to update.");
+        process.exit(1);
+      }
+      await client.patch(`/api/cli/contexts/${contextId}`, {
+        name: opts.name,
+        text,
+        skipTiptapLifecycle: !!text
+      });
+      if (text) {
+        await client.post(`/api/cli/contexts/${contextId}/inject`);
+      }
+      if (opts.json) {
+        printJson({ _id: contextId });
+        return;
+      }
+      console.error(`Updated spec: ${contextId}`);
+      console.log(contextId);
     }
-    console.log(`Updated spec: ${contextId}`);
-  });
-  spec.command("sync <contextId>").description("Trigger spec \u2194 project DAG synchronization").action(async (contextId) => {
+  );
+  spec.command("sync <contextId>").description("Trigger spec \u2194 project DAG synchronization").option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     const ctx = await client.get(`/api/cli/contexts/${contextId}`);
     if (!ctx.isSpecDocument) {
@@ -688,42 +794,64 @@ ${contexts.length} spec(s)`);
       process.exit(1);
     }
     await client.post(`/api/cli/contexts/${contextId}/sync`);
-    console.log(`Triggered sync for spec: ${contextId}`);
+    if (opts.json) {
+      printJson(
+        ctx.specRootTaskId ? { _id: contextId, specRootTaskId: ctx.specRootTaskId } : { _id: contextId }
+      );
+      return;
+    }
+    console.error(`Triggered sync for spec: ${contextId}`);
     if (ctx.specRootTaskId) {
-      console.log(`Root project: ${ctx.specRootTaskId}`);
+      console.error(`Root project: ${ctx.specRootTaskId}`);
     }
+    console.log(contextId);
   });
   spec.command("map <contextId>").description("Map file patterns to a spec (used by pre-commit hook to detect affected specs)").requiredOption(
     "-p, --pattern <patterns...>",
     'Glob pattern(s) to associate, e.g. "src/auth/**"'
-  ).action(async (contextId, opts) => {
+  ).option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     const result = await client.post(`/api/cli/contexts/${contextId}/map`, {
       patterns: opts.pattern
     });
-    console.log(`Mapped patterns to spec ${contextId}:`);
+    if (opts.json) {
+      printJson({ _id: contextId, filePatterns: result.filePatterns });
+      return;
+    }
+    console.error(`Mapped patterns to spec ${contextId}:`);
     for (const p of result.filePatterns) {
-      console.log(`  ${p}`);
+      console.error(`  ${p}`);
     }
+    console.log(contextId);
   });
-  spec.command("unmap <contextId>").description("Remove file pattern mappings from a spec (omit --pattern to clear all)").option("-p, --pattern <patterns...>", "Specific pattern(s) to remove (omit to clear all)").action(async (contextId, opts) => {
+  spec.command("unmap <contextId>").description("Remove file pattern mappings from a spec (omit --pattern to clear all)").option("-p, --pattern <patterns...>", "Specific pattern(s) to remove (omit to clear all)").option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     const result = await client.post(`/api/cli/contexts/${contextId}/unmap`, {
       patterns: opts.pattern
     });
+    if (opts.json) {
+      printJson({ _id: contextId, filePatterns: result.filePatterns });
+      return;
+    }
     if (result.filePatterns.length === 0) {
-      console.log(`Cleared all file patterns from spec ${contextId}`);
+      console.error(`Cleared all file patterns from spec ${contextId}`);
     } else {
-      console.log(`Updated patterns for spec ${contextId}:`);
+      console.error(`Updated patterns for spec ${contextId}:`);
       for (const p of result.filePatterns) {
-        console.log(`  ${p}`);
+        console.error(`  ${p}`);
       }
     }
+    console.log(contextId);
   });
-  spec.command("auto-map <contextId>").description("Trigger auto-mapping of file patterns for a spec").action(async (contextId) => {
+  spec.command("auto-map <contextId>").description("Trigger auto-mapping of file patterns for a spec").option("--json", "Output as JSON").action(async (contextId, opts) => {
     const client = getClient();
     await client.post(`/api/cli/contexts/${contextId}/auto-map`);
-    console.log(`Auto-mapping triggered for spec: ${contextId}`);
+    if (opts.json) {
+      printJson({ _id: contextId });
+      return;
+    }
+    console.error(`Auto-mapping triggered for spec: ${contextId}`);
+    console.log(contextId);
   });
 }
 function printSpec(ctx) {
@@ -752,7 +880,10 @@ var __dirname2 = dirname3(fileURLToPath2(import.meta.url));
 var pkg = JSON.parse(readFileSync6(resolve3(__dirname2, "../package.json"), "utf-8"));
 updateNotifier({ pkg }).notify();
 var program = new Command();
-program.name("prim").description("CLI for managing Primitive specs and contexts").version(pkg.version);
+program.name("prim").description("CLI for managing Primitive specs and contexts").version(pkg.version).option("-y, --yes", "auto-confirm prompts").option(
+  "--non-interactive",
+  "fail fast instead of prompting (also: CI=1, PRIM_NON_INTERACTIVE=1)"
+);
 registerAuthCommands(program);
 registerContextCommands(program);
 registerSpecCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitive.ai/prim",
-  "version": "0.1.0-alpha.13",
+  "version": "0.1.0-alpha.14",
   "description": "CLI for managing Primitive specs, contexts, and git hooks",
   "type": "module",
   "license": "MIT",