@primitive.ai/prim 0.1.0-alpha.56 → 0.1.0-alpha.58

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   checkAffectedDecisions,
   daemonOrDirectGet,
   formatDecisionsWarning
-} from "./chunk-VDLAAUWV.js";
+} from "./chunk-YITJ2H3B.js";
 import {
   JOURNAL_DIR,
   SESSIONS_DIR,
@@ -21,14 +21,14 @@ import {
   listFlushing,
   pendingJournalStats,
   readMovesFromPath
-} from "./chunk-BOTKPLTI.js";
+} from "./chunk-S4LFRVGD.js";
 import {
   printJson,
   registerSkillCommands
-} from "./chunk-ROL7SDXX.js";
+} from "./chunk-UBEBEBLM.js";
 import {
   fetchFeedbackCapability
-} from "./chunk-WELBNODJ.js";
+} from "./chunk-R4CUX6FY.js";
 import {
   inspectWorkspaceId
 } from "./chunk-IMAIBPUC.js";
@@ -36,16 +36,21 @@ import {
   binFile,
   commandMatchesBin,
   detachedHookShimCommand,
-  hookShimCommand,
+  packageVersion,
+  pinnedHookCommand,
   warmBinCache
-} from "./chunk-HSZPTVKU.js";
+} from "./chunk-YIMUIPMD.js";
 import {
-  activateRepoBestEffort,
+  canonicalGitRoot,
+  canonicalRepositoryPath,
   decisionIngestionStatus,
   gitToplevel,
+  githubRepositoryFullName,
   isRepoActiveForCapture,
-  setRepoActive
-} from "./chunk-R5ZJRSLV.js";
+  repoSyncId,
+  setRepoActive,
+  setRepoSyncId
+} from "./chunk-LDQZASIF.js";
 import {
   HttpError,
   REFRESH_TOKEN_PATH,
@@ -60,7 +65,7 @@ import {
   resolveAuthCredential,
   setStoredToken,
   withFileLock
-} from "./chunk-DWDEQRWN.js";
+} from "./chunk-I3HIPAIR.js";
 import {
   daemonIsLive,
   daemonRequest
@@ -74,7 +79,7 @@ import { Command } from "commander";
 import updateNotifier from "update-notifier";
 
 // src/commands/activation.ts
-function applyActivation(active) {
+async function applyActivation(active) {
   const root = gitToplevel();
   if (!root) {
     process.stderr.write(
@@ -84,16 +89,33 @@ function applyActivation(active) {
     process.exit(1);
   }
   try {
-    setRepoActive(process.cwd(), active);
+    let bound;
+    if (active) {
+      const repositoryFullName = githubRepositoryFullName(root);
+      if (!repositoryFullName) {
+        throw new Error("origin must be a GitHub HTTPS/SSH remote in owner/name form");
+      }
+      const response = await getClient().post("/api/cli/repositories/bind", {
+        repositoryFullName
+      });
+      if (typeof response.repoSyncId !== "string" || response.repoSyncId.length === 0) {
+        throw new Error("server returned no repository binding");
+      }
+      setRepoSyncId(root, response.repoSyncId);
+      bound = { repoSyncId: response.repoSyncId, repositoryFullName };
+    }
+    setRepoActive(root, active);
+    process.stderr.write(`[prim] prim ${active ? "enabled" : "disabled"} in ${root}
+`);
+    printJson({ active, repo: root, ...bound });
   } catch (err) {
     const detail = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`[prim] failed to set prim.active: ${detail}
-`);
+    process.stderr.write(
+      `[prim] failed to ${active ? "bind and enable" : "disable"} prim: ${detail}
+`
+    );
     process.exit(1);
   }
-  process.stderr.write(`[prim] prim ${active ? "enabled" : "disabled"} in ${root}
-`);
-  printJson({ active, repo: root });
 }
 function registerActivationCommands(program2) {
   program2.command("enable").description("Activate prim's hooks in this repo (git config prim.active=true)").action(() => applyActivation(true));
@@ -1068,7 +1090,7 @@ var SESSION_START_BIN = "prim-session-start";
 var SESSION_END_BIN = "prim-session-end";
 var STATUSLINE_BIN = "prim";
 var STATUSLINE_ARGS = "statusline";
-var STATUSLINE_COMMAND = hookShimCommand(STATUSLINE_BIN, STATUSLINE_ARGS);
+var STATUSLINE_COMMAND = pinnedHookCommand(STATUSLINE_BIN, STATUSLINE_ARGS);
 var STATUSLINE_REFRESH_SECONDS = 5;
 var PRIM_BINS = [
   CAPTURE_BIN,
@@ -1092,8 +1114,13 @@ var CAPTURE_EVENTS = [
   "SessionEnd",
   "SubagentStop"
 ];
-function makeRegistration(event, matcher, bin, args = "", opts = {}) {
-  return { event, matcher, bin, command: hookShimCommand(bin, args, opts) };
+function makeRegistration(event, matcher, bin, args = "") {
+  return {
+    event,
+    matcher,
+    bin,
+    command: pinnedHookCommand(bin, args)
+  };
 }
 function makeDetachedRegistration(event, matcher, bin, args = "") {
   return { event, matcher, bin, command: detachedHookShimCommand(bin, args) };
@@ -1102,11 +1129,9 @@ var REGISTRATIONS = [
   ...CAPTURE_EVENTS.map(
     (event) => event === "SessionEnd" ? makeDetachedRegistration(event, "*", CAPTURE_BIN) : makeRegistration(event, "*", CAPTURE_BIN)
   ),
-  makeRegistration("PreToolUse", "Edit|Write|MultiEdit", GATE_BIN),
-  makeRegistration("PostToolUse", "Edit|Write|MultiEdit", POST_TOOL_USE_BIN),
-  // Bare ladder (no branch-0): SessionStart must re-resolve @latest each session
-  // to refresh the bin cache the other hooks read. See lib/bin-cache.ts.
-  makeRegistration("SessionStart", "*", SESSION_START_BIN, "", { cacheRead: false }),
+  makeRegistration("PreToolUse", "Edit|Write|MultiEdit|NotebookEdit|Bash", GATE_BIN),
+  makeRegistration("PostToolUse", "Edit|Write|MultiEdit|NotebookEdit|Bash", POST_TOOL_USE_BIN),
+  makeRegistration("SessionStart", "*", SESSION_START_BIN),
   makeDetachedRegistration("SessionEnd", "*", SESSION_END_BIN)
 ];
 var PRIM_PERMISSION_RULE = "Bash(npx --yes @primitive.ai/prim*)";
@@ -1347,9 +1372,6 @@ function performInstall(scope, force) {
   if (changed) {
     atomicWrite2(path, after);
   }
-  if (scope === "project") {
-    activateRepoBestEffort(process.cwd());
-  }
   return {
     scope,
     path,
@@ -1507,9 +1529,7 @@ var CODEX_REGISTRATIONS = [
   ...CODEX_CAPTURE_EVENTS.map((event) => makeRegistration(event, "*", CAPTURE_BIN2, CODEX_ARGS)),
   makeRegistration("PreToolUse", "apply_patch", GATE_BIN2, CODEX_ARGS),
   makeRegistration("PostToolUse", "apply_patch", POST_TOOL_USE_BIN2, CODEX_ARGS),
-  // Bare ladder (no branch-0): SessionStart re-resolves @latest each session to
-  // refresh the bin cache the other hooks read. See lib/bin-cache.ts.
-  makeRegistration("SessionStart", "*", SESSION_START_BIN2, CODEX_ARGS, { cacheRead: false })
+  makeRegistration("SessionStart", "*", SESSION_START_BIN2, CODEX_ARGS)
 ];
 var USER_SCOPE_PATH2 = join3(homedir3(), ".codex", "hooks.json");
 var projectScopePath2 = () => join3(projectRoot(), ".codex", "hooks.json");
@@ -1562,9 +1582,6 @@ function performInstall2(scope, force) {
   if (changed) {
     atomicWrite2(path, after);
   }
-  if (scope === "project") {
-    activateRepoBestEffort(process.cwd());
-  }
   return resultFor(scope, path, after, changed);
 }
 function performUninstall2(scope) {
@@ -2775,7 +2792,9 @@ function toRequestBody(request) {
     alternatives: request.alternatives,
     confidence: request.confidence,
     reversibility: request.reversibility,
-    files: request.files
+    files: request.files,
+    protocolVersion: request.protocolVersion,
+    repoSyncId: request.repoSyncId
   };
   const body = {};
   for (const [key, value] of Object.entries(candidate)) {
@@ -3035,14 +3054,16 @@ var CREATE_INACTIVE_PROMPT = "[prim] Decision ingestion is disabled here. Create
 var CREATE_INACTIVE_APPROVED = "[prim] one-time Decision creation approved; passive ingestion remains disabled here";
 var CREATE_INACTIVE_REJECTED = "[prim] decision not created: Decision ingestion is disabled here; rerun with prim's --yes to approve this one Decision, or run `prim enable` in a Git project";
 var splitList = (value) => (value ?? "").split(",").map((item) => item.trim()).filter(Boolean);
+var collectItem = (value, previous) => previous.concat(value);
+var collectPaths = (value, previous = []) => previous.concat(splitList(value));
 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"
+    "Comma-separated file paths to check against the Decision Graph (repeatable)",
+    collectPaths
   ).action(async (opts) => {
-    const filePaths = splitList(opts.files);
-    const result = await checkAffectedDecisions(filePaths);
+    const result = await checkAffectedDecisions(opts.files);
     const warning = formatDecisionsWarning(result);
     if (warning) {
       console.error(warning);
@@ -3115,10 +3136,43 @@ function registerDecisionsCommands(program2) {
   ).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(
+  ).option(
+    "--decided <item>",
+    "One adopted constraint, verbatim; repeat the flag for each bullet",
+    collectItem,
+    []
+  ).option(
+    "--alternatives <item>",
+    "One rejected option, verbatim; repeat the flag for each",
+    collectItem,
+    []
+  ).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 (the files Conflict Gates would check \u2014 not currently enabled)"
+    "Comma-separated exact repo-relative paths this decision governs (repeatable)",
+    collectPaths
   ).action(async (opts, command) => {
+    const requestedFiles = opts.files ?? [];
+    let explicitScope = {};
+    if (requestedFiles.length > 0) {
+      const binding = repoSyncId(process.cwd());
+      const root = canonicalGitRoot(process.cwd());
+      const canonical = requestedFiles.map(
+        (path) => canonicalRepositoryPath(path, root ?? process.cwd(), root)
+      );
+      if (!binding || canonical.some((path) => !path)) {
+        console.error(
+          "[prim] scoped decision rejected: run `prim enable` and provide exact in-repository file paths"
+        );
+        console.log(JSON.stringify({ ok: false, error: "invalid_repository_scope" }, null, 2));
+        process.exitCode = EXIT_USAGE;
+        return;
+      }
+      explicitScope = {
+        protocolVersion: 3,
+        repoSyncId: binding,
+        files: canonical
+      };
+    }
     if (!isRepoActiveForCapture(process.cwd())) {
       const globals = command.optsWithGlobals();
       const nonInteractive = isNonInteractive(globals);
@@ -3137,11 +3191,11 @@ function registerDecisionsCommands(program2) {
       kind: opts.kind,
       rationale: opts.rationale,
       area: opts.area,
-      decided: splitList(opts.decided),
-      alternatives: splitList(opts.alternatives),
+      decided: opts.decided,
+      alternatives: opts.alternatives,
       confidence: opts.confidence,
       reversibility: opts.reversibility,
-      files: splitList(opts.files)
+      ...explicitScope
     };
     try {
       const outcome = await fetchCreate(request);
@@ -3562,13 +3616,19 @@ var HERMES_ARGS = "--agent hermes";
 var EDIT_MATCHER = "write_file|patch";
 var JSON_INDENT3 = 2;
 var SHIM_MODE = 493;
-var PRIM_BINS3 = [
-  CAPTURE_BIN3,
-  GATE_BIN3,
-  POST_TOOL_USE_BIN3,
-  SESSION_START_BIN3,
-  SESSION_END_BIN2
-];
+var PRIM_BINS3 = [CAPTURE_BIN3, GATE_BIN3, POST_TOOL_USE_BIN3, SESSION_START_BIN3, SESSION_END_BIN2];
+var PINNED_VERSION = packageVersion();
+if (!PINNED_VERSION) throw new Error("cannot determine Primitive package version");
+var sh = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+var PINNED_NODE = sh(process.execPath);
+var PINNED_CASES = PRIM_BINS3.map((bin) => {
+  const file = binFile(bin);
+  if (!file) throw new Error(`cannot locate Primitive hook binary: ${bin}`);
+  return `  ${bin})
+    if [ -x ${PINNED_NODE} ] && [ -f ${sh(file)} ]; then exec ${PINNED_NODE} ${sh(file)} "$@"; fi
+    exec npx --yes -p @primitive.ai/prim@${PINNED_VERSION} "$bin" "$@"
+    ;;`;
+}).join("\n");
 function hermesHome() {
   return process.env.HERMES_HOME ?? join5(homedir5(), ".hermes");
 }
@@ -3580,17 +3640,13 @@ function shimPath() {
 }
 var SHIM_SCRIPT = `#!/bin/sh
 # prim Hermes hook shim \u2014 managed by \`prim hermes install\`. Hermes runs hooks
-# with shell=False, so the PATH \u2192 local node_modules \u2192 npx @latest resolution a
-# shell does for the Claude Code / Codex installs lives here instead.
+# with shell=False, so exact package entrypoints are selected here.
 bin="$1"
 shift
-if command -v "$bin" >/dev/null 2>&1; then
-  exec "$bin" "$@"
-fi
-if [ -x "./node_modules/.bin/$bin" ]; then
-  exec "./node_modules/.bin/$bin" "$@"
-fi
-exec npx --yes -p @primitive.ai/prim@latest "$bin" "$@"
+case "$bin" in
+${PINNED_CASES}
+esac
+exit 64
 `;
 function commandFor(bin) {
   return `"${shimPath()}" ${bin} ${HERMES_ARGS}`;
@@ -3899,13 +3955,7 @@ var PRIM_BLOCK_END = blockMarkers(PRE_COMMIT).end;
 var PRIM_MANAGED_MARK = "prim-managed-hook";
 var PRIM_CREATED_MARK = "prim-created-hook";
 function hookShim(binName) {
-  return `if command -v ${binName} >/dev/null 2>&1; then
-  ${binName} || true
-elif [ -f "./node_modules/.bin/${binName}" ]; then
-  ./node_modules/.bin/${binName} || true
-else
-  npx --yes -p @primitive.ai/prim ${binName} 2>/dev/null || true
-fi`;
+  return `{ ${pinnedHookCommand(binName)}; } || true`;
 }
 function gatedShim(binName) {
   return `if [ "$(git config --get prim.active 2>/dev/null)" = "true" ]; then
@@ -4170,7 +4220,6 @@ function installHooks(gitRoot, target) {
       installToDotGit(gitRoot, spec);
     }
   }
-  activateRepoBestEffort(gitRoot);
 }
 function registerHooksCommands(program2) {
   const hooks = program2.command("hooks").description("Manage git hooks");
@@ -4588,9 +4637,7 @@ async function performReconcile(idOrShortId, opts = {}) {
   process.exitCode = EXIT_SERVER;
 }
 function registerReconcileCommands(program2) {
-  program2.command("reconcile <idOrShortId>").description(
-    "Issue a single-use bypass for a decision flagged by Conflict Gates Enforcement (not currently enabled)"
-  ).option(
+  program2.command("reconcile <idOrShortId>").description("Issue a single-use bypass for a decision flagged by Conflict Gates Enforcement").option(
     "--flag <conflictFlagId>",
     "Specific flag id to bind the bypass to (default: the decision's latest unack'd flag)"
   ).option("--json", "(reserved; STDOUT is always JSON)").action(async (idOrShortId, opts) => {
@@ -4712,9 +4759,12 @@ function planSetupSteps(opts) {
   });
   const skillArgs = ["skill", "install", "--agent", opts.agent, ...scopeArgs];
   steps.push({ key: "skill", label: "Agent skill", args: skillArgs, required: true });
-  if (opts.scope === "user") {
-    steps.push({ key: "enable", label: "Activate this repo", args: ["enable"], required: false });
-  }
+  steps.push({
+    key: "enable",
+    label: "Bind and activate this repo",
+    args: ["enable"],
+    required: true
+  });
   return steps;
 }
 var CONFLICT_SESSION = "session";
@@ -4870,7 +4920,7 @@ function registerSetupCommand(program2, dependencies = {}) {
       }
     }
     note("welcome");
-    results.welcome = run(["welcome"]).code === 0 ? "ok" : "failed";
+    results.welcome = run(["welcome", "--agent", agent]).code === 0 ? "ok" : "failed";
     const failed = Object.entries(results).filter(([, v]) => v === "failed").map(([k]) => k);
     const trail = Object.entries(results).map(([k, v]) => `${k}:${v}`).join(" \xB7 ");
     note(
@@ -4976,28 +5026,58 @@ function registerStatuslineCommands(program2) {
 // src/commands/welcome.ts
 var CMD_GUTTER = 38;
 var RECENT_LIMIT = 5;
-var REVERSE_PROMPT_LINES = [
-  "What are the most important goals in your organization that you're",
-  "responsible for, right now? What are you not focusing on, in order",
-  "to focus on those goals?"
-];
-var REVERSE_PROMPT = REVERSE_PROMPT_LINES.join(" ");
-var REVERSE_PROMPT_TEMPLATE = "We're interested in learning your current goals, as well as what you're not focusing on to achieve those goals. We found the following:\n\n$FOUND_GOALS\n\nHow do these look to you? Would you like to change these goals?";
-var CALLOUT_TITLE = "Your turn";
-var CALLOUT_INDENT = "  ";
-function ruledQuestion(lines) {
-  const prefix = `\u250C\u2500 ${CALLOUT_TITLE} `;
-  const width = Math.max(
-    `${prefix}\u2510`.length,
-    ...lines.map((line) => CALLOUT_INDENT.length + line.length + 1)
-  );
-  const top = `${prefix}${"\u2500".repeat(width - prefix.length - 1)}\u2510`;
-  const bottom = `\u2514${"\u2500".repeat(top.length - 2)}\u2518`;
+var WELCOME_AGENTS = ["claude", "codex", "hermes"];
+function resolveWelcomeAgent(agentFlag, env) {
+  if (agentFlag !== void 0 && WELCOME_AGENTS.includes(agentFlag)) {
+    return agentFlag;
+  }
+  if (agentFlag === void 0 && env.HERMES_INTERACTIVE) {
+    return "hermes";
+  }
+  return void 0;
+}
+var CAPTURE_LINES = {
+  claude: ["Capture is automatic \u2014 keep coding; your decisions are recorded for you."],
+  codex: [
+    "Capture starts once you trust the prim hooks \u2014 run /hooks in Codex;",
+    "until then nothing is recorded."
+  ],
+  hermes: [
+    "Capture starts once you approve the prim hooks when Hermes prompts;",
+    "until then nothing is recorded."
+  ],
+  generic: [
+    "Capture is automatic once your agent's prim hooks are active \u2014 keep",
+    "coding; your decisions are recorded for you."
+  ]
+};
+var PASSIVE_LINES = {
+  claude: ["Otherwise Primitive captures decisions passively while you work."],
+  codex: [
+    "Once you trust the prim hooks (/hooks in Codex), Primitive captures",
+    "decisions passively while you work."
+  ],
+  hermes: [
+    "Once you approve the prim hooks, Primitive captures decisions",
+    "passively while you work."
+  ],
+  generic: [
+    "Once your agent's prim hooks are active, Primitive captures decisions",
+    "passively while you work."
+  ]
+};
+var GUIDANCE_PASSIVE = {
+  claude: "Otherwise, Primitive passively captures decisions in the background while you work.",
+  codex: "Otherwise, once you trust the prim hooks (run /hooks in Codex), Primitive passively captures decisions in the background while you work.",
+  hermes: "Otherwise, once you approve the prim hooks when Hermes prompts, Primitive passively captures decisions in the background while you work.",
+  generic: "Otherwise, once your agent's prim hooks are active, Primitive passively captures decisions in the background while you work."
+};
+function seedGuidanceFor(agent) {
   return [
-    color(top, "green"),
-    ...lines.map((line) => `${CALLOUT_INDENT}${line}`),
-    color(bottom, "green")
-  ];
+    "You can tell your agent to add any decision to your Primitive decision graph at any time.",
+    GUIDANCE_PASSIVE[agent ?? "generic"],
+    "To capture decisions in other repositories, enable Primitive there too: run `prim enable` in each one."
+  ].join(" ");
 }
 function welcomeStateFromRecent(result) {
   if (result.unavailable !== void 0) {
@@ -5010,9 +5090,14 @@ function welcomeStateFromRecent(result) {
   }
   return { org: "active", recent };
 }
-function formatWelcome(state) {
+function formatWelcome(state, agent) {
   const cmd = (command, desc) => `  ${dim(command.padEnd(CMD_GUTTER))}${desc}`;
   const bullet = (text) => `  ${color("\u2022", "green")} ${text}`;
+  const asBullet = ([first, ...rest]) => [
+    bullet(first),
+    ...rest.map((line) => `    ${line}`)
+  ];
+  const copyKey = agent ?? "generic";
   const head = [
     bold(color("Welcome to Primitive", "green")),
     "",
@@ -5020,10 +5105,9 @@ function formatWelcome(state) {
     "shared graph \u2014 automatically, as you work.",
     "",
     bold("How it works"),
-    bullet("Capture is automatic \u2014 keep coding; your decisions are recorded for you."),
-    bullet("Conflict Gates (with Enforcement) flag or block edits that conflict"),
-    "    with a load-bearing decision \u2014 not currently enabled. Contact",
-    "    support@getprimitive.ai to turn them on for your team.",
+    ...asBullet(CAPTURE_LINES[copyKey]),
+    bullet("Conflict Gates can warn, ask, or block edits that conflict"),
+    "    with a load-bearing decision when Enforcement is enabled.",
     bullet('Occasional yes/no prompts confirm the "why" behind a decision \u2014'),
     "    answering keeps the graph trustworthy.",
     ""
@@ -5043,10 +5127,16 @@ function formatWelcome(state) {
     body = [
       ...teamContext,
       bold("Let's seed your decision graph"),
-      "You haven't recorded a decision yet \u2014 answer this and I'll record",
-      "each goal as a decision:",
+      "You haven't recorded a decision yet. Your agent will look through",
+      "what you've told it and this repo's shared memory files, and propose",
+      "any decisions it finds \u2014 approve, revise, or reject each one, and",
+      'share the "why" when it asks. Approved decisions become part of',
+      "your team's shared graph, visible to any teammates.",
       "",
-      ...ruledQuestion(REVERSE_PROMPT_LINES)
+      bold("From here on"),
+      bullet("Tell your agent to add any decision to Primitive, any time."),
+      ...asBullet(PASSIVE_LINES[copyKey]),
+      bullet("Run `prim enable` in each additional repo you want captured.")
     ];
   } else {
     body = [
@@ -5056,10 +5146,9 @@ function formatWelcome(state) {
       cmd("prim --help", "everything else")
     ];
   }
-  const footer = state.org === "seed" ? [] : ["", dim("App: https://app.getprimitive.ai")];
-  return [...head, ...body, ...footer].join("\n");
+  return [...head, ...body, "", dim("App: https://app.getprimitive.ai")].join("\n");
 }
-function welcomeJson(state) {
+function welcomeJson(state, agent) {
   if (state.org === "active") {
     return { welcomed: true, org: "active", recent: state.recent };
   }
@@ -5067,20 +5156,23 @@ function welcomeJson(state) {
     return {
       welcomed: true,
       org: "seed",
-      reversePrompt: REVERSE_PROMPT,
-      reversePromptTemplate: REVERSE_PROMPT_TEMPLATE,
+      seedGuidance: seedGuidanceFor(agent),
       recent: state.recent
     };
   }
   return { welcomed: true, org: "unknown" };
 }
 function registerWelcomeCommand(program2, deps = { getClient }) {
-  program2.command("welcome").description("Print a brief orientation to Primitive's decision graph").action(async () => {
+  program2.command("welcome").description("Print a brief orientation to Primitive's decision graph").option(
+    "--agent <agent>",
+    "claude, codex, or hermes \u2014 tailors the capture guidance (Hermes auto-detected)"
+  ).action(async (options) => {
+    const agent = resolveWelcomeAgent(options.agent, process.env);
     const result = await fetchRecent({ limit: RECENT_LIMIT }, deps);
     const state = welcomeStateFromRecent(result);
-    process.stderr.write(`${formatWelcome(state)}
+    process.stderr.write(`${formatWelcome(state, agent)}
 `);
-    printJson(welcomeJson(state));
+    printJson(welcomeJson(state, agent));
   });
 }
 

package/dist/statusline-main.js

@@ -2,7 +2,7 @@
 
 // src/commands/statusline.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { dirname as dirname4, resolve as resolve2 } from "path";
+import { dirname as dirname5, resolve as resolve3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/client.ts
@@ -63,7 +63,7 @@ function daemonRequest(method, params = {}, opts = {}) {
   const id = nextRequestId++;
   const request = { id, method, params };
   const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     let settled = false;
     let socket;
     let buffer = "";
@@ -78,7 +78,7 @@ function daemonRequest(method, params = {}, opts = {}) {
         } catch {
         }
       }
-      resolve3(value);
+      resolve4(value);
     };
     const timer = setTimeout(() => settle(null), timeoutMs);
     timer.unref();
@@ -140,6 +140,8 @@ import { join as join4 } from "path";
 
 // src/lib/git.ts
 import { execFileSync } from "child_process";
+import { lstatSync, realpathSync } from "fs";
+import { basename, dirname as dirname3, isAbsolute, relative, resolve as resolve2, sep } from "path";
 function gitToplevel(cwd) {
   try {
     return execFileSync("git", ["rev-parse", "--show-toplevel"], {
@@ -202,7 +204,7 @@ import { join as join6 } from "path";
 
 // src/lib/bin-path.ts
 import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
-import { dirname as dirname3, isAbsolute, join as join5 } from "path";
+import { dirname as dirname4, isAbsolute as isAbsolute2, join as join5 } from "path";
 import { fileURLToPath } from "url";
 var PKG_NAME = "@primitive.ai/prim";
 var NPX_FALLBACK = `npx --yes -p ${PKG_NAME}@latest`;
@@ -271,13 +273,13 @@ var STATUSLINE_TIMEOUT_MS = 200;
 var STATUSLINE_NAME_CAP = 3;
 function readPackageVersion() {
   try {
-    const here = dirname4(fileURLToPath2(import.meta.url));
+    const here = dirname5(fileURLToPath2(import.meta.url));
     const candidates = [
       // The supervised runtime stages a tiny manifest beside the standalone
       // statusline bundle, so it remains versioned without loading the package.
-      resolve2(here, "manifest.json"),
-      resolve2(here, "../../package.json"),
-      resolve2(here, "../package.json")
+      resolve3(here, "manifest.json"),
+      resolve3(here, "../../package.json"),
+      resolve3(here, "../package.json")
     ];
     for (const path of candidates) {
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitive.ai/prim",
-  "version": "0.1.0-alpha.56",
+  "version": "0.1.0-alpha.58",
   "description": "CLI for Primitive's decision graph — passive decision capture, conflict gate, and team presence",
   "type": "module",
   "license": "MIT",
@@ -62,6 +62,7 @@
   "dependencies": {
     "commander": "^12.1.0",
     "diff": "^5.2.0",
+    "unbash": "4.0.3",
     "update-notifier": "^7.3.1",
     "yaml": "^2.9.0"
   },