@primitive.ai/prim 0.1.0-alpha.19 → 0.1.0-alpha.21

package/dist/index.js

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
 import {
+  bold,
   color,
   colorForArea,
+  dim,
   stripAnsi
-} from "./chunk-BEEGFDGU.js";
+} from "./chunk-4QJOQIY6.js";
 import {
   checkAffectedDecisions,
   daemonOrDirectGet,
-  formatDecisionsWarning,
-  getGitContext
-} from "./chunk-TPQ3X244.js";
+  formatDecisionsWarning
+} from "./chunk-E5UZXMZL.js";
 import {
   HttpError,
   REFRESH_TOKEN_PATH,
@@ -20,7 +21,7 @@ import {
   getSiteUrl,
   getTokenExpiresAt,
   saveTokenExpiry
-} from "./chunk-6SIEWWUL.js";
+} from "./chunk-26VA3ADF.js";
 import {
   JOURNAL_DIR,
   SESSIONS_DIR,
@@ -34,7 +35,7 @@ import {
 } from "./chunk-UTKQTZHL.js";
 
 // src/index.ts
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 import { dirname as dirname6, resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command } from "commander";
@@ -747,128 +748,27 @@ ${line("project", result.project)}`);
   });
 }
 
-// src/commands/context.ts
-import { readFileSync as readFileSync4 } 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").option("--json", "Output as JSON").action(async (opts) => {
-    const client = getClient();
-    const params = new URLSearchParams();
-    if (opts.projectId) {
-      params.set("taskId", opts.projectId);
-    }
-    if (opts.scope) {
-      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").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}`);
-    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").option("--json", "Output as JSON").action(
-    async (opts) => {
-      const client = getClient();
-      let text = opts.text;
-      if (opts.file) {
-        text = readFileSync4(opts.file, "utf-8");
-      }
-      const taskIds = opts.projectId ? opts.projectId.split(",").map((id) => id.trim()) : void 0;
-      const result = await client.post("/api/cli/contexts", {
-        scope: opts.scope === "project" ? "task" : opts.scope,
-        name: opts.name,
-        text,
-        taskIds,
-        isSpecDocument: opts.spec ?? false
-      });
-      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").option("--json", "Output as JSON").action(
-    async (contextId, opts) => {
-      const client = getClient();
-      let text = opts.text;
-      if (opts.file) {
-        text = readFileSync4(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);
-    }
-  );
-  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}`);
-    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").option("--json", "Output as JSON").action(async (contextId, opts) => {
-    const client = getClient();
-    await client.post(`/api/cli/contexts/${contextId}/link`, {
-      taskId: 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").option("--json", "Output as JSON").action(async (contextId, opts) => {
-    const client = getClient();
-    await client.post(`/api/cli/contexts/${contextId}/unlink`, {
-      taskId: 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.error("No contexts found.");
-    return;
+// src/commands/daemon.ts
+import { spawn } from "child_process";
+import { existsSync as existsSync4, readFileSync as readFileSync4, unlinkSync } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join4 } from "path";
+
+// src/lib/presence.ts
+function formatTeammates(names, cap) {
+  if (names === void 0) {
+    return "\u2014";
   }
-  for (const ctx of contexts) {
-    const scope = ctx.scope === "task" ? "project" : ctx.scope ?? "project";
-    const spec = ctx.isSpecDocument ? " [SPEC]" : "";
-    const name = ctx.name ?? ctx.title ?? "(unnamed)";
-    console.log(`${ctx._id}  ${scope.padEnd(8)} ${name}${spec}`);
+  if (names.length === 0) {
+    return "just you";
+  }
+  if (names.length <= cap) {
+    return names.join(", ");
   }
-  console.error(`
-${contexts.length} context(s)`);
+  return `${names.slice(0, cap).join(", ")} +${String(names.length - cap)}`;
 }
 
 // src/commands/daemon.ts
-import { spawn } from "child_process";
-import { existsSync as existsSync4, readFileSync as readFileSync5, unlinkSync } from "fs";
-import { homedir as homedir3 } from "os";
-import { join as join4 } from "path";
 var DAEMON_BIN = "prim-daemon-server";
 var PID_PATH = join4(homedir3(), ".config", "prim", "daemon.pid");
 var SOCK_PATH = join4(homedir3(), ".config", "prim", "sock");
@@ -885,7 +785,7 @@ function readPidfile() {
   if (!existsSync4(PID_PATH)) {
     return null;
   }
-  const raw = readFileSync5(PID_PATH, "utf-8").trim();
+  const raw = readFileSync4(PID_PATH, "utf-8").trim();
   const pid = Number(raw);
   if (!Number.isInteger(pid) || pid <= 0) {
     return null;
@@ -1042,8 +942,9 @@ async function daemonStatus() {
   } else if (!snapshot) {
     process.stderr.write("[prim] \u2713 daemon live (no snapshot)\n");
   } else {
+    const team = snapshot.onlineNames !== void 0 ? ` \xB7 team: ${formatTeammates(snapshot.onlineNames, Number.POSITIVE_INFINITY)}` : "";
     process.stderr.write(
-      `[prim] \u2713 daemon live \xB7 pid=${snapshot.pid} \xB7 uptime=${Math.round(snapshot.uptimeMs / 1e3)}s \xB7 session=${snapshot.sessionId}
+      `[prim] \u2713 daemon live \xB7 pid=${snapshot.pid} \xB7 uptime=${Math.round(snapshot.uptimeMs / 1e3)}s \xB7 session=${snapshot.sessionId}${team}
 `
     );
   }
@@ -1460,6 +1361,44 @@ function formatConfirmJson(result) {
   return JSON.stringify(result.outcome, null, 2);
 }
 
+// src/decisions/create.ts
+var CREATE_TIMEOUT_MS = 1e4;
+var defaultDeps4 = { getClient };
+function toRequestBody(request) {
+  const candidate = {
+    intent: request.intent,
+    kind: request.kind,
+    rationale: request.rationale,
+    area: request.area,
+    decided: request.decided,
+    alternatives: request.alternatives,
+    confidence: request.confidence,
+    reversibility: request.reversibility,
+    files: request.files
+  };
+  const body = {};
+  for (const [key, value] of Object.entries(candidate)) {
+    const isEmpty = value === void 0 || Array.isArray(value) && value.length === 0;
+    if (!isEmpty) {
+      body[key] = value;
+    }
+  }
+  return body;
+}
+async function fetchCreate(request, deps = defaultDeps4) {
+  const client = deps.getClient();
+  return await client.post("/api/cli/decisions/create", toRequestBody(request), {
+    signal: AbortSignal.timeout(CREATE_TIMEOUT_MS)
+  });
+}
+function formatCreateHuman(outcome) {
+  const id = renderIdentifier({ shortId: outcome.shortId, id: outcome.decisionId });
+  return `[prim] created ${id}.`;
+}
+function formatCreateJson(outcome) {
+  return JSON.stringify(outcome, null, 2);
+}
+
 // src/decisions/show.ts
 var NOT_FOUND_RE3 = /not found/i;
 function colorStatus(status) {
@@ -1472,14 +1411,14 @@ function colorStatus(status) {
   return color(status, "gray");
 }
 var SHOW_TIMEOUT_MS = 1e4;
-var defaultDeps4 = { getClient };
+var defaultDeps5 = { getClient };
 var DecisionNotFoundError = class extends Error {
   constructor(idOrShortId) {
     super(`Decision not found: ${idOrShortId}`);
     this.name = "DecisionNotFoundError";
   }
 };
-async function fetchShow(idOrShortId, deps = defaultDeps4) {
+async function fetchShow(idOrShortId, deps = defaultDeps5) {
   const params = new URLSearchParams({ id: idOrShortId });
   const client = deps.getClient();
   try {
@@ -1596,13 +1535,15 @@ function formatShowJson(result) {
 
 // src/commands/decisions.ts
 var EXIT_NOT_FOUND = 4;
+var EXIT_USAGE = 2;
+var splitList = (value) => (value ?? "").split(",").map((item) => item.trim()).filter(Boolean);
 function registerDecisionsCommands(program2) {
   const decisions = program2.command("decisions").description("Inspect the project Decision Graph");
   decisions.command("check").description("Look up active decisions that reference one or more file paths").requiredOption(
     "--files <files>",
     "Comma-separated file paths to check against the Decision Graph"
   ).action(async (opts) => {
-    const filePaths = opts.files.split(",").map((s) => s.trim()).filter(Boolean);
+    const filePaths = splitList(opts.files);
     const result = await checkAffectedDecisions(filePaths);
     const warning = formatDecisionsWarning(result);
     if (warning) {
@@ -1664,11 +1605,45 @@ function registerDecisionsCommands(program2) {
       throw err;
     }
   });
+  decisions.command("create").description("Author a decision directly \u2014 the deliberate manual path around automatic capture").requiredOption("--intent <text>", "What was decided (required)").option("--kind <kind>", "change | exploration | task_execution | unclear (default change)").option("--rationale <text>", "Why the decision was made").option(
+    "--area <area>",
+    "Functional area (auth, data, infra, ui, api, billing, mobile, docs, testing)"
+  ).option("--decided <items>", "Comma-separated option(s) chosen").option("--alternatives <items>", "Comma-separated options considered but rejected").option("--confidence <level>", "high | medium | low (default high)").option("--reversibility <level>", "high | low (default high)").option(
+    "--files <paths>",
+    "Comma-separated repo-relative paths this decision governs (gates edits to them)"
+  ).action(async (opts) => {
+    const request = {
+      intent: opts.intent,
+      kind: opts.kind,
+      rationale: opts.rationale,
+      area: opts.area,
+      decided: splitList(opts.decided),
+      alternatives: splitList(opts.alternatives),
+      confidence: opts.confidence,
+      reversibility: opts.reversibility,
+      files: splitList(opts.files)
+    };
+    try {
+      const outcome = await fetchCreate(request);
+      console.error(formatCreateHuman(outcome));
+      console.log(formatCreateJson(outcome));
+    } catch (err) {
+      if (err instanceof HttpError && err.status >= 400 && err.status < 500) {
+        console.error(`[prim] create rejected: ${err.message}`);
+        console.log(
+          JSON.stringify({ ok: false, status: err.status, error: err.message }, null, 2)
+        );
+        process.exitCode = EXIT_USAGE;
+        return;
+      }
+      throw err;
+    }
+  });
 }
 
 // src/commands/hooks.ts
 import { execSync } from "child_process";
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync6, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync5, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
 import { resolve } from "path";
 import { Option } from "commander";
 var PRE_COMMIT = { hookName: "pre-commit", binName: "prim-pre-commit" };
@@ -1717,7 +1692,7 @@ function detectHusky(gitRoot) {
   const pkgPath = resolve(gitRoot, "package.json");
   if (existsSync5(pkgPath)) {
     try {
-      const pkg2 = JSON.parse(readFileSync6(pkgPath, "utf-8"));
+      const pkg2 = JSON.parse(readFileSync5(pkgPath, "utf-8"));
       const scripts = pkg2.scripts ?? {};
       if (/husky/i.test(scripts.prepare ?? "") || /husky/i.test(scripts.postinstall ?? "")) {
         return true;
@@ -1745,7 +1720,7 @@ async function askConfirmation(question) {
 function installToHusky(gitRoot, spec = PRE_COMMIT) {
   const hookPath = resolve(gitRoot, ".husky", spec.hookName);
   if (existsSync5(hookPath)) {
-    const existing = readFileSync6(hookPath, "utf-8");
+    const existing = readFileSync5(hookPath, "utf-8");
     if (containsPrimHook(existing, spec.binName)) {
       console.log(`Prim ${spec.hookName} hook is already installed in .husky/${spec.hookName}.`);
       return;
@@ -1773,7 +1748,7 @@ function installToDotGit(gitRoot, spec = PRE_COMMIT) {
     mkdirSync3(hooksDir, { recursive: true });
   }
   if (existsSync5(hookPath)) {
-    const existing = readFileSync6(hookPath, "utf-8");
+    const existing = readFileSync5(hookPath, "utf-8");
     if (containsPrimHook(existing, spec.binName)) {
       console.log(`Prim ${spec.hookName} hook is already installed at ${hookPath}.`);
       return;
@@ -1840,7 +1815,7 @@ function registerHooksCommands(program2) {
         console.log(`No ${spec.hookName} hook found.`);
         continue;
       }
-      if (containsPrimHook(readFileSync6(hookPath, "utf-8"), spec.binName)) {
+      if (containsPrimHook(readFileSync5(hookPath, "utf-8"), spec.binName)) {
         unlinkSync2(hookPath);
         console.log(`Removed ${spec.hookName} hook at ${hookPath}`);
       } else {
@@ -1982,31 +1957,9 @@ function registerMovesCommands(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").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
-    });
-    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.error(`Linked spec: ${opts.spec}`);
-    }
-    console.log(result._id);
-  });
-}
-
 // src/commands/reconcile.ts
 var EXIT_OK2 = 0;
-var EXIT_USAGE = 2;
+var EXIT_USAGE2 = 2;
 var EXIT_SERVER = 3;
 var HTTP_CLIENT_ERROR_MIN = 400;
 var HTTP_SERVER_ERROR_MIN = 500;
@@ -2050,7 +2003,7 @@ async function performReconcile(idOrShortId, opts = {}) {
       process.stderr.write(`[prim] reconcile rejected: ${err.message}
 `);
       console.log(JSON.stringify({ ok: false, status: err.status, error: err.message }, null, 2));
-      process.exitCode = EXIT_USAGE;
+      process.exitCode = EXIT_USAGE2;
       return;
     }
     const message = err instanceof Error ? err.message : String(err);
@@ -2090,7 +2043,7 @@ function registerReconcileCommands(program2) {
 import {
   existsSync as existsSync7,
   mkdirSync as mkdirSync5,
-  readFileSync as readFileSync7,
+  readFileSync as readFileSync6,
   readdirSync,
   unlinkSync as unlinkSync5,
   writeFileSync as writeFileSync5
@@ -2132,7 +2085,7 @@ function registerSessionCommands(program2) {
     for (const f of files) {
       const sessionId = f.replace(/\.json$/, "");
       try {
-        const m = JSON.parse(readFileSync7(join6(SESSIONS_DIR, f), "utf-8"));
+        const m = JSON.parse(readFileSync6(join6(SESSIONS_DIR, f), "utf-8"));
         console.log(`${sessionId}  org=${m.orgId}`);
       } catch {
       }
@@ -2155,7 +2108,7 @@ import {
   existsSync as existsSync8,
   fsyncSync as fsyncSync2,
   openSync as openSync2,
-  readFileSync as readFileSync8,
+  readFileSync as readFileSync7,
   renameSync as renameSync3,
   writeFileSync as writeFileSync6
 } from "fs";
@@ -2177,7 +2130,7 @@ function loadSkill() {
   let dir = __dirname;
   while (dir !== dirname4(dir)) {
     const p = resolve2(dir, "SKILL.md");
-    if (existsSync8(p)) return readFileSync8(p, "utf-8");
+    if (existsSync8(p)) return readFileSync7(p, "utf-8");
     dir = dirname4(dir);
   }
   throw new Error("SKILL.md not found in package");
@@ -2232,7 +2185,7 @@ function resolveTarget(cwd, override) {
 function runInstall(cwd, opts) {
   const target = resolveTarget(cwd, opts.target);
   if (target === null) return 1;
-  const existing = existsSync8(target) ? readFileSync8(target, "utf-8") : "";
+  const existing = existsSync8(target) ? readFileSync7(target, "utf-8") : "";
   const eol = existing ? detectNewline(existing) : "\n";
   const block = composeBlock(loadSkill(), eol);
   const next = applyBlock(existing, block, eol);
@@ -2255,7 +2208,7 @@ function runUninstall(cwd, opts) {
     console.log(`Skill block not present at ${target}`);
     return 0;
   }
-  const existing = readFileSync8(target, "utf-8");
+  const existing = readFileSync7(target, "utf-8");
   const next = removeBlock(existing);
   if (next === null) {
     console.log(`Skill block not present at ${target}`);
@@ -2271,7 +2224,7 @@ function runStatus(cwd, opts) {
   const fileExists = existsSync8(target);
   let installed = false;
   if (fileExists) {
-    const content = readFileSync8(target, "utf-8");
+    const content = readFileSync7(target, "utf-8");
     installed = content.includes(SKILL_BEGIN) && content.includes(SKILL_END);
   }
   if (opts.json) {
@@ -2307,284 +2260,19 @@ function registerSkillCommands(program2) {
   });
 }
 
-// src/commands/spec.ts
-import { readFileSync as readFileSync9 } 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").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.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.error("No spec documents found.");
-      return;
-    }
-    for (const ctx of contexts) {
-      const scope = ctx.scope === "task" ? "project" : ctx.scope ?? "project";
-      const review = ctx.specReviewStatus ?? "\u2014";
-      const name = ctx.name ?? "(unnamed)";
-      console.log(`${ctx._id}  ${scope.padEnd(8)} ${String(review).padEnd(10)} ${name}`);
-    }
-    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)").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("create").description("Create a new spec document").requiredOption("-s, --scope <scope>", "Scope: project, global, external").requiredOption("-n, --name <name>", "Spec name").option("-t, --text <text>", "Spec text content").option("-f, --file <path>", "Read text content from file").option("--project-id <projectId>", "Link to project(s), comma-separated").option("--branch <branch>", "Link spec to this branch on the current repo").option("--pr <prNumber>", "Optional PR number to attach to the link").option("--json", "Output as JSON").action(
-    async (opts) => {
-      const client = getClient();
-      let text = opts.text;
-      if (opts.file) {
-        text = readFileSync9(opts.file, "utf-8");
-      }
-      const taskIds = opts.projectId ? opts.projectId.split(",").map((id) => id.trim()) : void 0;
-      let linkedBranch;
-      if (opts.branch) {
-        const { repoFullName } = getGitContext();
-        if (!repoFullName) {
-          console.warn(
-            "[prim] --branch supplied but origin remote is not GitHub; skipping link."
-          );
-        } else {
-          linkedBranch = { repoFullName, branch: opts.branch };
-          if (opts.pr) {
-            const n = Number.parseInt(opts.pr, 10);
-            if (Number.isFinite(n)) linkedBranch.prNumber = n;
-          }
-        }
-      }
-      const result = await client.post("/api/cli/contexts", {
-        scope: opts.scope === "project" ? "task" : opts.scope,
-        name: opts.name,
-        text,
-        taskIds,
-        isSpecDocument: true,
-        linkedBranch
-      });
-      if (opts.json) {
-        printJson({ _id: result._id });
-        return;
-      }
-      console.error(
-        `Created spec: ${result._id}${linkedBranch ? ` (linked to ${linkedBranch.branch})` : ""}`
-      );
-      console.log(result._id);
-    }
-  );
-  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 = readFileSync9(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);
-    }
-  );
-  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) {
-      console.error("Context is not a spec document. Use `prim context` instead.");
-      process.exit(1);
-    }
-    await client.post(`/api/cli/contexts/${contextId}/sync`);
-    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.error(`Root project: ${ctx.specRootTaskId}`);
-    }
-    console.log(contextId);
-  });
-  spec.command("review <contextId>").description("Manually trigger the PR Intent Review bot for a spec").requiredOption("--pr <prNumber>", "PR number to review against").option("--sha <headSha>", "Commit SHA the review runs against (defaults to current HEAD)").action(async (contextId, opts) => {
-    const prNumber = Number.parseInt(opts.pr, 10);
-    if (!Number.isFinite(prNumber)) {
-      console.error("--pr must be an integer.");
-      process.exit(1);
-    }
-    const headSha = opts.sha ?? getGitContext().sha;
-    if (!headSha) {
-      console.error("Could not determine head SHA \u2014 pass --sha or run inside a git checkout.");
-      process.exit(1);
-    }
-    const client = getClient();
-    await client.post(`/api/cli/contexts/${contextId}/review`, {
-      prNumber,
-      headSha
-    });
-    console.log(
-      `Scheduled review: ${contextId} against PR #${String(prNumber)} @ ${headSha.slice(0, 7)}`
-    );
-  });
-  spec.command("drift <contextId>").description("Dispatch the Claude Code drift-fix workflow against a PR").requiredOption("--pr <prNumber>", "PR number to dispatch the drift-fix workflow against").action(async (contextId, opts) => {
-    const prNumber = Number.parseInt(opts.pr, 10);
-    if (!Number.isFinite(prNumber)) {
-      console.error("--pr must be an integer.");
-      process.exit(1);
-    }
-    const client = getClient();
-    const result = await client.post(`/api/cli/contexts/${contextId}/drift`, {
-      prNumber
-    });
-    if (result.dispatched) {
-      const ref = result.runUrl ? `: ${result.runUrl}` : "";
-      console.log(`Dispatched drift-fix workflow${ref}`);
-    } else {
-      console.error(
-        "Drift-fix dispatch failed. Likely causes: actions:write App scope not granted, primitive-drift-fix.yml workflow file missing, or no findings on the latest review."
-      );
-      process.exit(1);
-    }
-  });
-  spec.command("status <taskId>").description(
-    "Show task status, auto-complete suppression flag, and the most-recent bot auto-completion"
-  ).action(async (taskId) => {
-    const client = getClient();
-    const result = await client.get(`/api/cli/tasks/${taskId}/status`);
-    console.log(`status: ${result.status}`);
-    console.log(`auto-complete suppressed: ${result.autoCompleteSuppressed ? "yes" : "no"}`);
-    const last = result.lastAutoCompleteActivity;
-    if (last) {
-      const when = last.createdAt ? new Date(last.createdAt).toISOString() : "\u2014";
-      const pr = last.prNumber ? `#${String(last.prNumber)}` : "\u2014";
-      console.log(`last auto-complete: ${when} (PR ${pr})`);
-      if (last.explanation) {
-        console.log(`  ${last.explanation}`);
-      }
-    } else {
-      console.log("last auto-complete: \u2014");
-    }
-  });
-  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/**"'
-  ).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
-    });
-    if (opts.json) {
-      printJson({ _id: contextId, filePatterns: result.filePatterns });
-      return;
-    }
-    console.error(`Mapped patterns to spec ${contextId}:`);
-    for (const p of result.filePatterns) {
-      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)").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.error(`Cleared all file patterns from spec ${contextId}`);
-    } else {
-      console.error(`Updated patterns for spec ${contextId}:`);
-      for (const p of result.filePatterns) {
-        console.error(`  ${p}`);
-      }
-    }
-    console.log(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`);
-    if (opts.json) {
-      printJson({ _id: contextId });
-      return;
-    }
-    console.error(`Auto-mapping triggered for spec: ${contextId}`);
-    console.log(contextId);
-  });
-}
-function printSpec(ctx) {
-  const name = ctx.name ?? ctx.title ?? "(unnamed)";
-  const review = ctx.specReviewStatus ?? "\u2014";
-  const patterns = ctx.filePatterns;
-  console.log(`ID:              ${ctx._id}`);
-  console.log(`Name:            ${name}`);
-  console.log(`Scope:           ${ctx.scope === "task" ? "project" : ctx.scope ?? "project"}`);
-  console.log(`Review Status:   ${review}`);
-  console.log(`Root Project:    ${ctx.specRootTaskId ?? "\u2014"}`);
-  console.log(`Sync Version:    ${ctx.syncVersion ?? 0}`);
-  console.log(`Index Status:    ${ctx.indexStatus ?? "\u2014"}`);
-  console.log(`File Patterns:   ${patterns?.length ? patterns.join(", ") : "\u2014"}`);
-  if (ctx.text) {
-    const text = ctx.text;
-    const preview = text.length > 500 ? `${text.slice(0, 500)}\u2026` : text;
-    console.log(`
---- Text ---
-${preview}`);
-  }
-}
-
 // src/commands/statusline.ts
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync8 } from "fs";
 import { dirname as dirname5, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var STATUSLINE_TIMEOUT_MS = 200;
+var STATUSLINE_NAME_CAP = 3;
 function readPackageVersion() {
   try {
     const here = dirname5(fileURLToPath3(import.meta.url));
     const candidates = [resolve3(here, "../../package.json"), resolve3(here, "../package.json")];
     for (const path of candidates) {
       try {
-        const pkg2 = JSON.parse(readFileSync10(path, "utf-8"));
+        const pkg2 = JSON.parse(readFileSync8(path, "utf-8"));
         if (pkg2.version) {
           return pkg2.version;
         }
@@ -2615,7 +2303,14 @@ async function renderStatusline() {
   if (snapshot.presenceStale) {
     return `primitive ${version} (daemon: live \xB7 presence: stale)`;
   }
-  const team = typeof snapshot.onlineCount === "number" ? `team: ${String(snapshot.onlineCount)} online` : "team: \u2014";
+  let team;
+  if (snapshot.onlineNames !== void 0) {
+    team = `team: ${formatTeammates(snapshot.onlineNames, STATUSLINE_NAME_CAP)}`;
+  } else if (typeof snapshot.onlineCount === "number") {
+    team = `team: ${String(snapshot.onlineCount)} online`;
+  } else {
+    team = "team: \u2014";
+  }
   return `primitive ${version} (daemon: live \xB7 ${team})`;
 }
 function registerStatuslineCommands(program2) {
@@ -2628,19 +2323,52 @@ function registerStatuslineCommands(program2) {
   });
 }
 
+// src/commands/welcome.ts
+var CMD_GUTTER = 38;
+function formatWelcome() {
+  const cmd = (command, desc) => `  ${dim(command.padEnd(CMD_GUTTER))}${desc}`;
+  const bullet = (text) => `  ${color("\u2022", "green")} ${text}`;
+  return [
+    bold(color("Welcome to Primitive", "green")),
+    "",
+    "Primitive captures the decisions your team makes while coding into a",
+    "shared graph \u2014 and flags edits that conflict with earlier ones before",
+    "they land.",
+    "",
+    bold("How it works"),
+    bullet("Capture is automatic \u2014 keep coding; your decisions are recorded for you."),
+    bullet("The conflict gate has your back: when an edit conflicts with a"),
+    "    load-bearing decision, prim surfaces it. Run `prim reconcile dec_<id>` to clear",
+    "    that decision and retry.",
+    bullet('Occasional yes/no prompts confirm the "why" behind a decision \u2014'),
+    "    answering keeps the graph trustworthy.",
+    "",
+    bold("Get started"),
+    cmd("prim decisions recent", "what your team has decided lately"),
+    cmd("prim decisions check --files <files>", "what governs files you're about to change"),
+    cmd("prim --help", "everything else"),
+    "",
+    dim("App: https://app.getprimitive.ai")
+  ].join("\n");
+}
+function registerWelcomeCommand(program2) {
+  program2.command("welcome").description("Print a brief orientation to Primitive's decision graph").action(() => {
+    process.stderr.write(`${formatWelcome()}
+`);
+    printJson({ welcomed: true });
+  });
+}
+
 // src/index.ts
 var __dirname2 = dirname6(fileURLToPath4(import.meta.url));
-var pkg = JSON.parse(readFileSync11(resolve4(__dirname2, "../package.json"), "utf-8"));
+var pkg = JSON.parse(readFileSync9(resolve4(__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).option("-y, --yes", "auto-confirm prompts").option(
+program.name("prim").description("CLI for Primitive's decision graph").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);
-registerProjectCommands(program);
 registerHooksCommands(program);
 registerSkillCommands(program);
 registerMovesCommands(program);
@@ -2651,6 +2379,7 @@ registerCodexCommands(program);
 registerDaemonCommands(program);
 registerReconcileCommands(program);
 registerStatuslineCommands(program);
+registerWelcomeCommand(program);
 process.on("unhandledRejection", (err) => {
   const msg = err instanceof Error ? err.message : String(err);
   console.error(msg);