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

package/README.md

@@ -58,9 +58,14 @@ graph, conflicting edits are gated, and presence is reported. Each hook
 self-resolves the CLI at run time (PATH, then a local install, then
 `npx --yes @latest`), so it keeps working with no global install.
 
+Installs into the current project by default — the repo's `.claude/settings.json`
+/ `.codex/hooks.json`, resolved from the git root (so any subdirectory works);
+pass `--scope user` to install machine-wide.
+
 ```bash
-prim claude install    # Install Claude Code hooks   (uninstall / status)
-prim codex install     # Install OpenAI Codex hooks   (uninstall / status)
+prim claude install                # Install Claude Code hooks (project scope; uninstall / status)
+prim claude install --scope user   # Install machine-wide instead
+prim codex install                 # Install OpenAI Codex hooks (project scope)
 ```
 
 ### Daemon

package/dist/index.js

@@ -281,6 +281,7 @@ async function exchangeCode(siteUrl, code, codeVerifier, redirectUri) {
 }
 
 // src/commands/claude-install.ts
+import { execSync } from "child_process";
 import {
   closeSync,
   existsSync as existsSync3,
@@ -370,7 +371,17 @@ var PRIM_BINS = [
 ];
 var JSON_INDENT = 2;
 var USER_SCOPE_PATH = join2(homedir(), ".claude", "settings.json");
-var PROJECT_SCOPE_PATH = join2(process.cwd(), ".claude", "settings.json");
+function projectRoot() {
+  try {
+    return execSync("git rev-parse --show-toplevel", {
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return process.cwd();
+  }
+}
+var projectScopePath = () => join2(projectRoot(), ".claude", "settings.json");
 var CAPTURE_EVENTS = [
   "SessionStart",
   "UserPromptSubmit",
@@ -391,7 +402,7 @@ var REGISTRATIONS = [
   makeRegistration("SessionEnd", "*", SESSION_END_BIN)
 ];
 function settingsPathFor(scope) {
-  return scope === "user" ? USER_SCOPE_PATH : PROJECT_SCOPE_PATH;
+  return scope === "user" ? USER_SCOPE_PATH : projectScopePath();
 }
 function readSettings(path) {
   if (!existsSync3(path)) {
@@ -548,15 +559,15 @@ function performStatus() {
       statusline: statuslineInstalled(settings)
     };
   };
-  return { user: statusFor(USER_SCOPE_PATH), project: statusFor(PROJECT_SCOPE_PATH) };
+  return { user: statusFor(USER_SCOPE_PATH), project: statusFor(projectScopePath()) };
 }
 function resolveScope(input) {
-  if (input === void 0 || input === "user") {
-    return "user";
-  }
-  if (input === "project") {
+  if (input === void 0 || input === "project") {
     return "project";
   }
+  if (input === "user") {
+    return "user";
+  }
   console.error(`[prim] unknown --scope "${input}" (expected: user or project)`);
   process.exit(1);
 }
@@ -564,7 +575,7 @@ function registerClaudeCommands(program2) {
   const claude = program2.command("claude").description("Manage the prim Claude Code integration (capture, gate, ingest, presence)");
   claude.command("install").description("Register the prim hooks + statusline in Claude Code's settings.json").option(
     "--scope <scope>",
-    "user (default, ~/.claude/settings.json) or project (./.claude/settings.json)"
+    "project (default, the repo's .claude/settings.json) or user (~/.claude/settings.json)"
   ).option("--force", "Replace any drifted prim hook entries").action((opts) => {
     const scope = resolveScope(opts.scope);
     const result = performInstall(scope, opts.force ?? false);
@@ -581,7 +592,7 @@ function registerClaudeCommands(program2) {
   });
   claude.command("uninstall").description("Remove all prim hooks + the prim statusline from settings.json").option(
     "--scope <scope>",
-    "user (default, ~/.claude/settings.json) or project (./.claude/settings.json)"
+    "project (default, the repo's .claude/settings.json) or user (~/.claude/settings.json)"
   ).action((opts) => {
     const scope = resolveScope(opts.scope);
     const result = performUninstall(scope);
@@ -629,9 +640,9 @@ var CODEX_REGISTRATIONS = [
   makeRegistration("SessionStart", "*", SESSION_START_BIN2, CODEX_ARGS)
 ];
 var USER_SCOPE_PATH2 = join3(homedir2(), ".codex", "hooks.json");
-var PROJECT_SCOPE_PATH2 = join3(process.cwd(), ".codex", "hooks.json");
+var projectScopePath2 = () => join3(projectRoot(), ".codex", "hooks.json");
 function settingsPathFor2(scope) {
-  return scope === "user" ? USER_SCOPE_PATH2 : PROJECT_SCOPE_PATH2;
+  return scope === "user" ? USER_SCOPE_PATH2 : projectScopePath2();
 }
 function applyInstall2(settings, options = {}) {
   const hooks = { ...settings.hooks ?? {} };
@@ -696,24 +707,24 @@ function performStatus2() {
     const settings = readSettings(path);
     return { path, gate: isGateInstalled2(settings), capture: captureInstalled2(settings) };
   };
-  return { user: statusFor(USER_SCOPE_PATH2), project: statusFor(PROJECT_SCOPE_PATH2) };
+  return { user: statusFor(USER_SCOPE_PATH2), project: statusFor(projectScopePath2()) };
 }
 function resolveScope2(input) {
-  if (input === void 0 || input === "user") {
-    return "user";
-  }
-  if (input === "project") {
+  if (input === void 0 || input === "project") {
     return "project";
   }
+  if (input === "user") {
+    return "user";
+  }
   console.error(`[prim] unknown --scope "${input}" (expected: user or project)`);
   process.exit(1);
 }
 var TRUST_NOTICE = "[prim] Codex requires hook trust: run `/hooks` in Codex to review and trust these hooks (or start Codex with --dangerously-bypass-hook-trust). Until trusted, the hooks will not fire.";
 function registerCodexCommands(program2) {
   const codex = program2.command("codex").description("Manage the prim Codex integration (capture, gate, ingest, presence)");
-  codex.command("install").description("Register the prim hooks in Codex's ~/.codex/hooks.json").option(
+  codex.command("install").description("Register the prim hooks in Codex's hooks.json (project scope by default)").option(
     "--scope <scope>",
-    "user (default, ~/.codex/hooks.json) or project (./.codex/hooks.json)"
+    "project (default, the repo's .codex/hooks.json) or user (~/.codex/hooks.json)"
   ).option("--force", "Replace any drifted prim hook entries").action((opts) => {
     const scope = resolveScope2(opts.scope);
     const result = performInstall2(scope, opts.force ?? false);
@@ -725,9 +736,9 @@ function registerCodexCommands(program2) {
     console.error(TRUST_NOTICE);
     console.log(JSON.stringify(result, null, JSON_INDENT2));
   });
-  codex.command("uninstall").description("Remove all prim hooks from ~/.codex/hooks.json").option(
+  codex.command("uninstall").description("Remove all prim hooks from Codex's hooks.json").option(
     "--scope <scope>",
-    "user (default, ~/.codex/hooks.json) or project (./.codex/hooks.json)"
+    "project (default, the repo's .codex/hooks.json) or user (~/.codex/hooks.json)"
   ).action((opts) => {
     const scope = resolveScope2(opts.scope);
     const result = performUninstall2(scope);
@@ -1208,8 +1219,8 @@ async function fetchRecent(args, deps = defaultDeps2) {
   if (args.since !== void 0) {
     params.set("since", args.since);
   }
-  const client = deps.getClient();
   try {
+    const client = deps.getClient();
     const res = await daemonOrDirectGet(
       "decisions_recent",
       `/api/cli/decisions/recent?${params.toString()}`,
@@ -1255,9 +1266,18 @@ function authorLabel(row) {
   }
 }
 var AUTHOR_WIDTH = 18;
+var AREA_WIDTH = 12;
 function padRight(s, width) {
   return s.length >= width ? `${s.slice(0, width - 1)} ` : s.padEnd(width, " ");
 }
+function formatRecentRow(row) {
+  const clock = formatClock(row.classifiedAt);
+  const author = padRight(authorLabel(row), AUTHOR_WIDTH);
+  const areaText = row.area ? `\u2022 ${row.area}` : "\u2022";
+  const areaPlain = padRight(areaText, AREA_WIDTH);
+  const areaCol = row.area ? areaPlain.replace("\u2022", color("\u2022", colorForArea(row.area))) : areaPlain;
+  return `  ${clock}  ${author}${areaCol}${row.intent}`;
+}
 function formatRecentHuman(result) {
   if (result.unavailable !== void 0) {
     return `[prim] recent \xB7 feed not verified \u2014 ${result.unavailable}`;
@@ -1267,12 +1287,7 @@ function formatRecentHuman(result) {
   }
   const lines = [`[prim] recent \xB7 ${String(result.decisions.length)} decision(s)`];
   for (const row of result.decisions) {
-    const clock = formatClock(row.classifiedAt);
-    const author = padRight(authorLabel(row), AUTHOR_WIDTH);
-    const areaText = row.area ? `\u2022 ${row.area}` : "\u2022";
-    const areaPlain = padRight(areaText, 12);
-    const areaCol = row.area ? areaPlain.replace("\u2022", color("\u2022", colorForArea(row.area))) : areaPlain;
-    lines.push(`  ${clock}  ${author}${areaCol}${row.intent}`);
+    lines.push(formatRecentRow(row));
   }
   return lines.join("\n");
 }
@@ -1642,7 +1657,7 @@ function registerDecisionsCommands(program2) {
 }
 
 // src/commands/hooks.ts
-import { execSync } from "child_process";
+import { execSync as execSync2 } from "child_process";
 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";
@@ -1680,7 +1695,7 @@ ${hookShim(spec.binName)}
 ${end}`;
 }
 function getGitRoot() {
-  return execSync("git rev-parse --show-toplevel", {
+  return execSync2("git rev-parse --show-toplevel", {
     encoding: "utf-8"
   }).trim();
 }
@@ -2325,10 +2340,26 @@ function registerStatuslineCommands(program2) {
 
 // src/commands/welcome.ts
 var CMD_GUTTER = 38;
-function formatWelcome() {
+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(" ");
+function welcomeStateFromRecent(result) {
+  if (result.unavailable !== void 0) {
+    return { org: "unknown" };
+  }
+  if (result.decisions.length === 0) {
+    return { org: "empty" };
+  }
+  return { org: "active", recent: result.decisions.slice(0, RECENT_LIMIT) };
+}
+function formatWelcome(state) {
   const cmd = (command, desc) => `  ${dim(command.padEnd(CMD_GUTTER))}${desc}`;
   const bullet = (text) => `  ${color("\u2022", "green")} ${text}`;
-  return [
+  const head = [
     bold(color("Welcome to Primitive", "green")),
     "",
     "Primitive captures the decisions your team makes while coding into a",
@@ -2342,20 +2373,53 @@ function formatWelcome() {
     "    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");
+    ""
+  ];
+  let body;
+  if (state.org === "active") {
+    body = [
+      bold("Recent team decisions"),
+      ...state.recent.map(formatRecentRow),
+      "",
+      bold("Get started"),
+      cmd("prim decisions check --files <files>", "what governs files you're about to change"),
+      cmd("prim --help", "everything else")
+    ];
+  } else if (state.org === "empty") {
+    body = [
+      bold("Let's seed your decision graph"),
+      "Your team has no decisions recorded yet. Tell me, in your own words:",
+      "",
+      ...REVERSE_PROMPT_LINES.map((line) => `  ${line}`),
+      "",
+      "Share your answer and I'll record each goal as a decision."
+    ];
+  } else {
+    body = [
+      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")
+    ];
+  }
+  return [...head, ...body, "", dim("App: https://app.getprimitive.ai")].join("\n");
+}
+function welcomeJson(state) {
+  if (state.org === "active") {
+    return { welcomed: true, org: "active", recent: state.recent };
+  }
+  if (state.org === "empty") {
+    return { welcomed: true, org: "empty", reversePrompt: REVERSE_PROMPT };
+  }
+  return { welcomed: true, org: "unknown" };
 }
-function registerWelcomeCommand(program2) {
-  program2.command("welcome").description("Print a brief orientation to Primitive's decision graph").action(() => {
-    process.stderr.write(`${formatWelcome()}
+function registerWelcomeCommand(program2, deps = { getClient }) {
+  program2.command("welcome").description("Print a brief orientation to Primitive's decision graph").action(async () => {
+    const result = await fetchRecent({ limit: RECENT_LIMIT }, deps);
+    const state = welcomeStateFromRecent(result);
+    process.stderr.write(`${formatWelcome(state)}
 `);
-    printJson({ welcomed: true });
+    printJson(welcomeJson(state));
   });
 }
 

package/package.json

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