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

package/README.md

@@ -192,13 +192,22 @@ prim moves flush          # Drain the local journals to the server (also runs fr
 ### Skill
 
 ```bash
-prim skill install     # Install the decision-graph agent guide into your rules file
-prim skill uninstall   # Remove the managed block
-prim skill status      # Report whether the block is installed
-```
-
-Writes a managed block teaching your agent how to work with the decision graph
-into the rules file it reads (CLAUDE.md, AGENTS.md, .cursor/rules, …).
+prim skill install --agent claude   # Install the decision-graph guide for Claude Code
+prim skill install --agent codex    # …or write the guide into another agent's rules file
+prim skill uninstall --agent claude # Remove it
+prim skill status --agent claude    # Report whether it's installed
+```
+
+Teaches your agent how to work with the decision graph. For **Claude Code**
+(`--agent claude`) this installs a skills-directory plugin at
+`<repo>/.claude/skills/prim/` (or `~/.claude/skills/prim/` with `--scope user`)
+— a `.claude-plugin/plugin.json` + `SKILL.md` that auto-loads as the model-invoked
+`prim@skills-dir` skill, no marketplace step; restart Claude Code or run
+`/reload-plugins` after installing. For every other agent it writes a managed
+block into the rules file that agent reads (`--agent codex` → AGENTS.md,
+`--agent hermes` → .hermes.md, or an auto-detected .cursor/rules, …). A bare
+`prim skill install` (no `--agent`) auto-detects a rules file and writes the
+block; pass `--target <path>` for an explicit file.
 
 ## Development
 

package/dist/{chunk-4QJOQIY6.js → chunk-AAGJFO7C.js}

@@ -54,6 +54,16 @@ function colorForArea(area) {
   }
   return AREA_COLORS[area] ?? "gray";
 }
+function stripControlChars(text) {
+  let out = "";
+  for (const ch of text) {
+    const code = ch.codePointAt(0) ?? 0;
+    if (code > 31 && !(code >= 127 && code <= 159)) {
+      out += ch;
+    }
+  }
+  return out;
+}
 function stripAnsi(text) {
   return text.replace(/\u001b\[[0-9;]*m/g, "");
 }
@@ -63,5 +73,6 @@ export {
   dim,
   bold,
   colorForArea,
+  stripControlChars,
   stripAnsi
 };

package/dist/chunk-LUPD2JSH.js

@@ -0,0 +1,78 @@
+// src/lib/activation.ts
+import { execFileSync as execFileSync2 } from "child_process";
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+// src/lib/git.ts
+import { execFileSync } from "child_process";
+function gitToplevel(cwd) {
+  try {
+    return execFileSync("git", ["rev-parse", "--show-toplevel"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+
+// src/lib/activation.ts
+var PRIM_ACTIVE_KEY = "prim.active";
+var PROJECT_INSTALL_FILES = [".claude/settings.json", ".codex/hooks.json"];
+var PRIM_HOOK_BINS = ["prim-hook", "prim-pre-tool-use", "prim-post-tool-use"];
+function repoActiveFlag(cwd) {
+  try {
+    const value = execFileSync2("git", ["config", "--get", PRIM_ACTIVE_KEY], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (value === "true") return "true";
+    if (value === "false") return "false";
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+function setRepoActive(cwd, active) {
+  execFileSync2("git", ["config", "--local", PRIM_ACTIVE_KEY, active ? "true" : "false"], {
+    cwd,
+    stdio: ["ignore", "ignore", "pipe"]
+  });
+}
+function activateRepoBestEffort(cwd) {
+  try {
+    setRepoActive(cwd, true);
+  } catch {
+  }
+}
+function hasProjectPrimInstall(cwd) {
+  const root = gitToplevel(cwd);
+  if (root === null || root === homedir()) return false;
+  for (const rel of PROJECT_INSTALL_FILES) {
+    const path = join(root, rel);
+    if (existsSync(path)) {
+      try {
+        const content = readFileSync(path, "utf-8");
+        if (PRIM_HOOK_BINS.some((bin) => content.includes(bin))) return true;
+      } catch {
+      }
+    }
+  }
+  return false;
+}
+function isRepoActiveForCapture(cwd) {
+  const flag = repoActiveFlag(cwd);
+  if (flag === "true") return true;
+  if (flag === "false") return false;
+  return hasProjectPrimInstall(cwd);
+}
+
+export {
+  gitToplevel,
+  setRepoActive,
+  activateRepoBestEffort,
+  isRepoActiveForCapture
+};

package/dist/hooks/post-tool-use.js

@@ -2,13 +2,16 @@
 import {
   bold,
   color
-} from "../chunk-4QJOQIY6.js";
+} from "../chunk-AAGJFO7C.js";
 import {
   scrubFromCwd
 } from "../chunk-6LAQVM26.js";
 import {
   toMove
 } from "../chunk-S2O4P4A3.js";
+import {
+  isRepoActiveForCapture
+} from "../chunk-LUPD2JSH.js";
 import {
   getClient
 } from "../chunk-26VA3ADF.js";
@@ -128,6 +131,10 @@ async function main() {
     return;
   }
   const cwd = parsed.cwd ?? process.cwd();
+  if (!isRepoActiveForCapture(cwd)) {
+    emit();
+    return;
+  }
   const base = toMove(parsed, resolveCliVersion(), agent);
   const move = { ...base, payload: scrubFromCwd(parsed, cwd) };
   try {

package/dist/hooks/pre-tool-use.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  isRepoActiveForCapture
+} from "../chunk-LUPD2JSH.js";
 import {
   getClient,
   getSiteUrl
@@ -295,6 +298,10 @@ async function main() {
     emit(failOpen());
     return;
   }
+  if (!isRepoActiveForCapture(cwd)) {
+    emit(failOpen());
+    return;
+  }
   let results;
   try {
     results = await Promise.all(files.map((f) => checkOneFile(f)));

package/dist/hooks/prim-hook.js

@@ -10,6 +10,9 @@ import {
   shouldFlushAfter,
   toMove
 } from "../chunk-S2O4P4A3.js";
+import {
+  isRepoActiveForCapture
+} from "../chunk-LUPD2JSH.js";
 import "../chunk-26VA3ADF.js";
 import {
   normalizeEnvelope,
@@ -42,12 +45,14 @@ try {
   const raw = readFileSync(0, "utf-8");
   const parsed = normalizeEnvelope(JSON.parse(raw), agent);
   const cwd = parsed.cwd ?? process.cwd();
-  const base = toMove(parsed, resolveCliVersion(), agent);
-  const move = { ...base, payload: scrubFromCwd(parsed, cwd) };
-  const { orgId } = resolveOrg({ sessionId: move.sessionId, cwd: move.env.cwd });
-  appendMove(move, orgId);
-  if (shouldFlushAfter(move.eventType)) {
-    spawnBackgroundFlush();
+  if (isRepoActiveForCapture(cwd)) {
+    const base = toMove(parsed, resolveCliVersion(), agent);
+    const move = { ...base, payload: scrubFromCwd(parsed, cwd) };
+    const { orgId } = resolveOrg({ sessionId: move.sessionId, cwd: move.env.cwd });
+    appendMove(move, orgId);
+    if (shouldFlushAfter(move.eventType)) {
+      spawnBackgroundFlush();
+    }
   }
 } catch (err) {
   if (process.env.PRIM_HOOK_DEBUG) {