@primitive.ai/prim 0.1.0-alpha.32 → 0.1.0-alpha.34

package/README.md

@@ -127,7 +127,7 @@ prim daemon start      # start (stop / restart / status)
 Read and respond to the decision graph.
 
 ```bash
-prim decisions recent                    # Recent decisions feed
+prim decisions recent                    # Recent decisions feed (--author <name> for one teammate's)
 prim decisions show <id>                 # Drill into one decision
 prim decisions cascade <id>              # Blast radius of a decision
 prim decisions check --files <…>         # Active decisions referencing files (warn-only)

package/SKILL.md

@@ -44,7 +44,7 @@ The gate fail-opens on its *own* infrastructure errors (no daemon, network blip,
 ## Read the graph before large or load-bearing edits
 
 - `npx --yes @primitive.ai/prim decisions check --files "src/a.ts,src/b.ts"` -- which active decisions reference the files you're about to touch (comma-separated paths, one `--files` value). Run it before a big change.
-- `npx --yes @primitive.ai/prim decisions recent` -- the team's recent decisions, each row badged by author and agent (`Your Claude Code` / `Your Codex` / `Your Hermes`); `--limit <n>` and `--since <dur>` narrow it.
+- `npx --yes @primitive.ai/prim decisions recent` -- the team's recent decisions, each row badged by author and agent (`Your Claude Code` / `Your Codex` / `Your Hermes`); `--limit <n>` and `--since <dur>` narrow it. `--author "<name>"` filters to one teammate (feed name, `"First Last"`, last name, username, email, or email local-part) -- the way to answer "what has X decided?"; an unknown or ambiguous name comes back as `unavailable` with the reason, and `authorHasDecisions` in the JSON distinguishes "no feed-visible decisions" (false) from "has decisions, none in this window" (true).
 - `npx --yes @primitive.ai/prim decisions show <idOrShortId>` and `npx --yes @primitive.ai/prim decisions cascade <idOrShortId>` -- full detail, and the downstream blast radius a change would disturb.
 
 ## Reconcile and the verdict footer
@@ -130,6 +130,7 @@ Examples:
 
 - `npx --yes @primitive.ai/prim auth status --json | jq -r .authenticated` — boolean; the exit code remains the authoritative signal
 - `npx --yes @primitive.ai/prim decisions recent | jq -r '.decisions[].shortId'` — list recent decision short ids (STDOUT is already JSON)
+- `npx --yes @primitive.ai/prim decisions recent --author "Maya" | jq -r 'if .unavailable then "UNAVAILABLE: \(.unavailable)" else .decisions[].intent end'` — one teammate's latest decisions (check `.unavailable` first; empty output alone is not "no decisions")
 - `npx --yes @primitive.ai/prim decisions show <id> | jq .` — full decision detail
 
 ## Pitfalls

package/dist/index.js

@@ -342,6 +342,9 @@ function hookShimCommand(bin, args = "") {
   const invoke = (cmd) => args ? `${cmd} ${args}` : cmd;
   return `if command -v ${bin} >/dev/null 2>&1; then ${invoke(bin)}; elif [ -f "./node_modules/.bin/${bin}" ]; then ${invoke(`./node_modules/.bin/${bin}`)}; else ${invoke(`${NPX_FALLBACK} ${bin}`)}; fi`;
 }
+function detachedHookShimCommand(bin, args = "") {
+  return `payload=$(cat); { trap '' HUP; export npm_config_fetch_retries=2 npm_config_fetch_retry_mintimeout=10000 npm_config_fetch_retry_maxtimeout=10000 npm_config_fetch_timeout=60000; printf '%s' "$payload" | { ${hookShimCommand(bin, args)}; }; } </dev/null >/dev/null 2>&1 &`;
+}
 function commandMatchesBin(command, bin) {
   if (!command) {
     return false;
@@ -395,12 +398,17 @@ var CAPTURE_EVENTS = [
 function makeRegistration(event, matcher, bin, args = "") {
   return { event, matcher, bin, command: hookShimCommand(bin, args) };
 }
+function makeDetachedRegistration(event, matcher, bin, args = "") {
+  return { event, matcher, bin, command: detachedHookShimCommand(bin, args) };
+}
 var REGISTRATIONS = [
-  ...CAPTURE_EVENTS.map((event) => makeRegistration(event, "*", CAPTURE_BIN)),
+  ...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),
   makeRegistration("SessionStart", "*", SESSION_START_BIN),
-  makeRegistration("SessionEnd", "*", SESSION_END_BIN)
+  makeDetachedRegistration("SessionEnd", "*", SESSION_END_BIN)
 ];
 var PRIM_PERMISSION_RULE = "Bash(npx --yes @primitive.ai/prim*)";
 var LEGACY_PRIM_PERMISSION_RULES = [
@@ -445,10 +453,9 @@ function stripCommand(list, bin) {
   return out;
 }
 function ensureRegistration(list, reg, force) {
-  const hasCanonical = list.some(
-    (e) => e.matcher === reg.matcher && e.hooks?.length === 1 && e.hooks[0].command === reg.command
-  );
-  if (hasCanonical && !force) {
+  const isCanonical = (e) => e.matcher === reg.matcher && e.hooks?.length === 1 && e.hooks[0].command === reg.command;
+  const hasStray = (e) => !isCanonical(e) && (e.hooks ?? []).some((h) => commandMatchesBin(h.command, reg.bin));
+  if (list.some(isCanonical) && !list.some(hasStray) && !force) {
     return list;
   }
   return [...stripCommand(list, reg.bin), canonicalEntry(reg)];
@@ -1325,6 +1332,12 @@ function formatCascadeJson(result) {
 var RECENT_TIMEOUT_MS = 1e4;
 var defaultDeps2 = { getClient };
 async function fetchRecent(args, deps = defaultDeps2) {
+  if (args.author !== void 0 && args.author.trim() === "") {
+    return {
+      decisions: [],
+      unavailable: "--author must be a non-empty name"
+    };
+  }
   const params = new URLSearchParams();
   if (args.limit !== void 0) {
     params.set("limit", String(args.limit));
@@ -1332,6 +1345,9 @@ async function fetchRecent(args, deps = defaultDeps2) {
   if (args.since !== void 0) {
     params.set("since", args.since);
   }
+  if (args.author !== void 0) {
+    params.set("author", args.author);
+  }
   try {
     const client = deps.getClient();
     const res = await daemonOrDirectGet(
@@ -1340,10 +1356,22 @@ async function fetchRecent(args, deps = defaultDeps2) {
       client,
       RECENT_TIMEOUT_MS
     );
+    if (args.author !== void 0 && res.author === void 0 && res.unavailable === void 0) {
+      return {
+        decisions: [],
+        unavailable: "--author requires a newer Primitive backend (no author echo in response); retry without --author for the team-wide feed"
+      };
+    }
     const result = { decisions: res.decisions };
     if (res.viewerHasDecisions !== void 0) {
       result.viewerHasDecisions = res.viewerHasDecisions;
     }
+    if (res.author !== void 0) {
+      result.author = res.author;
+    }
+    if (res.authorHasDecisions !== void 0) {
+      result.authorHasDecisions = res.authorHasDecisions;
+    }
     if (res.unavailable !== void 0) {
       result.unavailable = res.unavailable;
     }
@@ -1400,10 +1428,20 @@ function formatRecentHuman(result) {
   if (result.unavailable !== void 0) {
     return `[prim] recent \xB7 feed not verified \u2014 ${result.unavailable}`;
   }
+  if (result.author !== void 0 && result.decisions.length === 0) {
+    if (result.authorHasDecisions === true) {
+      return `[prim] recent \xB7 ${result.author.name} \xB7 0 decisions in this window (older decisions exist \u2014 widen --since or raise --limit)`;
+    }
+    if (result.authorHasDecisions === false) {
+      return `[prim] recent \xB7 ${result.author.name} \xB7 no feed-visible decisions yet (if unexpected, check prim setup/doctor on their machine and the repo they work in)`;
+    }
+    return `[prim] recent \xB7 ${result.author.name} \xB7 0 decisions`;
+  }
+  const label = result.author === void 0 ? "recent" : `recent \xB7 ${result.author.name}`;
   if (result.decisions.length === 0) {
     return "[prim] recent \xB7 0 decisions";
   }
-  const lines = [`[prim] recent \xB7 ${String(result.decisions.length)} decision(s)`];
+  const lines = [`[prim] ${label} \xB7 ${String(result.decisions.length)} decision(s)`];
   for (const row of result.decisions) {
     lines.push(formatRecentRow(row));
   }
@@ -1764,10 +1802,14 @@ function registerDecisionsCommands(program2) {
   decisions.command("recent").description("Show the team-wide chronological decision feed").option("--limit <n>", "Maximum number of rows to return (default 10)").option(
     "--since <duration>",
     "Lookback window \u2014 accepts `Nm`, `Nh`, `Nd` (minutes / hours / days) or absolute epoch ms"
+  ).option(
+    "--author <name>",
+    `Filter to one teammate's decisions \u2014 feed name, "First Last", last name, username, email, or email local-part`
   ).action(async (opts) => {
     const result = await fetchRecent({
       limit: opts.limit ? Number.parseInt(opts.limit, 10) : void 0,
-      since: opts.since
+      since: opts.since,
+      author: opts.author
     });
     console.error(formatRecentHuman(result));
     console.log(formatRecentJson(result));
@@ -2882,7 +2924,7 @@ function planSetupSteps(opts) {
     });
   }
   steps.push({ key: "hooks", label: "Git hooks", args: ["hooks", "install"], required: true });
-  const skillArgs = opts.agent === "hermes" ? ["skill", "install", "--target", ".hermes.md"] : ["skill", "install"];
+  const skillArgs = ["skill", "install", "--agent", opts.agent];
   steps.push({ key: "skill", label: "Agent skill", args: skillArgs, required: true });
   return steps;
 }
@@ -2993,6 +3035,11 @@ var TARGET_CANDIDATES = [
   ".github/instructions/primitive.md"
 ];
 var DEFAULT_TARGET = "CLAUDE.md";
+var AGENT_TARGET = {
+  claude: "CLAUDE.md",
+  codex: "AGENTS.md",
+  hermes: ".hermes.md"
+};
 function loadSkill() {
   let dir = __dirname;
   while (dir !== dirname5(dir)) {
@@ -3040,8 +3087,14 @@ function atomicWrite2(target, content) {
   }
   renameSync4(tmp, target);
 }
-function resolveTarget(cwd, override) {
-  if (override) return resolve2(cwd, override);
+function resolveTarget(cwd, opts) {
+  if (opts.target) return resolve2(cwd, opts.target);
+  if (opts.agent) {
+    const mapped = AGENT_TARGET[opts.agent];
+    if (typeof mapped === "string") return resolve2(cwd, mapped);
+    console.error(`Unknown --agent "${opts.agent}" (expected claude, codex, or hermes)`);
+    return null;
+  }
   const matches = detectTargets(cwd);
   if (matches.length === 0) return resolve2(cwd, DEFAULT_TARGET);
   if (matches.length === 1) return resolve2(cwd, matches[0]);
@@ -3050,7 +3103,7 @@ function resolveTarget(cwd, override) {
   return null;
 }
 function runInstall(cwd, opts) {
-  const target = resolveTarget(cwd, opts.target);
+  const target = resolveTarget(cwd, opts);
   if (target === null) return 1;
   const existing = existsSync10(target) ? readFileSync8(target, "utf-8") : "";
   const eol = existing ? detectNewline(existing) : "\n";
@@ -3069,7 +3122,7 @@ function runInstall(cwd, opts) {
   return 0;
 }
 function runUninstall(cwd, opts) {
-  const target = resolveTarget(cwd, opts.target);
+  const target = resolveTarget(cwd, opts);
   if (target === null) return 1;
   if (!existsSync10(target)) {
     console.log(`Skill block not present at ${target}`);
@@ -3086,7 +3139,7 @@ function runUninstall(cwd, opts) {
   return 0;
 }
 function runStatus(cwd, opts) {
-  const target = resolveTarget(cwd, opts.target);
+  const target = resolveTarget(cwd, opts);
   if (target === null) return 1;
   const fileExists = existsSync10(target);
   let installed = false;
@@ -3111,7 +3164,7 @@ function runStatus(cwd, opts) {
 }
 function registerSkillCommands(program2) {
   const skill = program2.command("skill").description("Manage the prim skill in your project rules file");
-  skill.command("install").description("Install the prim skill block into your project rules file").option("--target <path>", "Path to the rules file (overrides auto-detection)").option("--dry-run", "Print a unified diff without writing").action((opts) => {
+  skill.command("install").description("Install the prim skill block into your project rules file").option("--target <path>", "Path to the rules file (overrides auto-detection)").option("--agent <agent>", "claude, codex, or hermes (selects the default rules file)").option("--dry-run", "Print a unified diff without writing").action((opts) => {
     try {
       process.exit(runInstall(process.cwd(), opts));
     } catch (err) {
@@ -3119,10 +3172,10 @@ function registerSkillCommands(program2) {
       process.exit(2);
     }
   });
-  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) => {
+  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)").option("--agent <agent>", "claude, codex, or hermes (selects the default rules file)").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)").option("--json", "Output as JSON").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("--agent <agent>", "claude, codex, or hermes (selects the default rules file)").option("--json", "Output as JSON").action((opts) => {
     process.exit(runStatus(process.cwd(), opts));
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitive.ai/prim",
-  "version": "0.1.0-alpha.32",
+  "version": "0.1.0-alpha.34",
   "description": "CLI for Primitive's decision graph — passive decision capture, conflict gate, and team presence",
   "type": "module",
   "license": "MIT",