@primitive.ai/prim 0.1.0-alpha.68 → 0.1.0-alpha.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitive.ai/prim",
-  "version": "0.1.0-alpha.68",
+  "version": "0.1.0-alpha.69",
   "description": "CLI for Primitive's decision graph — passive decision capture, conflict gate, and team presence",
   "type": "module",
   "license": "MIT",
@@ -48,13 +48,17 @@
     "SKILL.md"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/hooks/pre-commit.ts src/hooks/post-commit.ts src/hooks/post-rewrite.ts src/hooks/prim-hook.ts src/hooks/pre-tool-use.ts src/hooks/post-tool-use.ts src/hooks/session-start.ts src/hooks/session-end.ts --format esm --clean && tsup src/statusline-main.ts src/daemon/server.ts --format esm --splitting false",
+    "build": "tsup src/index.ts src/hooks/pre-commit.ts src/hooks/post-commit.ts src/hooks/post-rewrite.ts src/hooks/prim-hook.ts src/hooks/pre-tool-use.ts src/hooks/post-tool-use.ts src/hooks/session-start.ts src/hooks/session-end.ts --format esm --clean && tsup src/statusline-main.ts src/daemon/server.ts --format esm --splitting false && tsup --config tsup.hook-runtime.config.ts",
+    "contracts:generate": "node scripts/generate-cli-contract.mjs --write",
+    "contracts:check": "node scripts/generate-cli-contract.mjs --check",
+    "contracts:provenance": "node scripts/update-cli-contract.mjs --check",
+    "contracts:update": "node scripts/update-cli-contract.mjs",
     "postbuild": "chmod +x ./dist/index.js ./dist/statusline-main.js ./dist/hooks/pre-commit.js ./dist/hooks/post-commit.js ./dist/hooks/post-rewrite.js ./dist/hooks/prim-hook.js ./dist/hooks/pre-tool-use.js ./dist/hooks/post-tool-use.js ./dist/hooks/session-start.js ./dist/hooks/session-end.js ./dist/daemon/server.js",
     "dev": "tsup src/index.ts src/statusline-main.ts src/hooks/pre-commit.ts src/hooks/post-commit.ts src/hooks/post-rewrite.ts src/hooks/prim-hook.ts src/hooks/pre-tool-use.ts src/hooks/post-tool-use.ts src/hooks/session-start.ts src/hooks/session-end.ts src/daemon/server.ts --format esm --watch --clean --splitting false",
     "clean": "rm -rf dist coverage",
-    "lint": "biome check src/",
-    "format": "biome check --fix src/",
-    "format:check": "biome check src/",
+    "lint": "biome check src/ scripts/",
+    "format": "biome check --fix src/ scripts/",
+    "format:check": "biome check src/ scripts/",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -73,6 +77,8 @@
     "@types/node": "^25.5.0",
     "@types/update-notifier": "^6.0.8",
     "@vitest/coverage-v8": "^3.1.0",
+    "ajv": "8.20.0",
+    "json-schema-to-typescript": "15.0.4",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",
     "vitest": "^3.1.0"

package/dist/chunk-K3AYW6VZ.js

@@ -1,300 +0,0 @@
-// src/lib/bin-path.ts
-import { existsSync, readFileSync } from "fs";
-import { dirname, isAbsolute, join } from "path";
-import { fileURLToPath } from "url";
-var PKG_NAME = "@primitive.ai/prim";
-var ROOT_WALK_LIMIT = 6;
-var NPX_FALLBACK = `npx --yes -p ${PKG_NAME}@latest`;
-var resolvedRoot;
-function locateRoot() {
-  if (resolvedRoot !== void 0) {
-    return resolvedRoot;
-  }
-  let dir = dirname(fileURLToPath(import.meta.url));
-  for (let depth = 0; depth < ROOT_WALK_LIMIT; depth++) {
-    const manifestPath = join(dir, "package.json");
-    if (existsSync(manifestPath)) {
-      try {
-        const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
-        if (manifest.name === PKG_NAME && manifest.bin) {
-          resolvedRoot = { dir, version: manifest.version, bin: manifest.bin };
-          return resolvedRoot;
-        }
-      } catch {
-      }
-    }
-    const parent = dirname(dir);
-    if (parent === dir) {
-      break;
-    }
-    dir = parent;
-  }
-  resolvedRoot = null;
-  return resolvedRoot;
-}
-function binFile(bin) {
-  const root = locateRoot();
-  const rel = root?.bin[bin];
-  if (!root || !rel) {
-    return null;
-  }
-  return isAbsolute(rel) ? rel : join(root.dir, rel);
-}
-function packageVersion() {
-  return locateRoot()?.version ?? null;
-}
-function shellQuote(value) {
-  return `'${value.replaceAll("'", `'"'"'`)}'`;
-}
-function pinnedHookCommand(bin, args = "") {
-  const version = packageVersion();
-  if (!version) throw new Error("cannot determine Primitive package version");
-  const suffix = args ? ` ${args}` : "";
-  const fallback = `npx --yes -p ${PKG_NAME}@${version} ${bin}${suffix}`;
-  const file = binFile(bin);
-  if (!file) return fallback;
-  return `if [ -x ${shellQuote(process.execPath)} ] && [ -f ${shellQuote(file)} ]; then ${shellQuote(process.execPath)} ${shellQuote(file)}${suffix}; else ${fallback}; 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" | { ${pinnedHookCommand(bin, args)}; }; } </dev/null >/dev/null 2>&1 &`;
-}
-function commandMatchesBin(command, bin) {
-  if (!command) {
-    return false;
-  }
-  const c = command.trim();
-  if (c === bin || c.startsWith(`${bin} `)) {
-    return true;
-  }
-  const exactBin = new RegExp(`(?:^|\\s)${bin.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:\\s|;|$)`);
-  return c.includes(`command -v ${bin} `) || c.includes(`-p ${PKG_NAME}@`) && exactBin.test(c);
-}
-
-// src/lib/bin-cache.ts
-import { chmodSync, mkdirSync, renameSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join as join2 } from "path";
-var CACHED_BINS = [
-  "prim",
-  "prim-hook",
-  "prim-pre-tool-use",
-  "prim-post-tool-use",
-  "prim-post-commit",
-  "prim-post-rewrite"
-];
-function binCacheDir() {
-  const base = process.env.XDG_CACHE_HOME || join2(homedir(), ".cache");
-  return join2(base, "prim", "bin");
-}
-function writeAtomic(path, content) {
-  const tmp = `${path}.${process.pid}.tmp`;
-  writeFileSync(tmp, content, { mode: 384 });
-  renameSync(tmp, path);
-}
-function warmBinCache() {
-  try {
-    if (process.env.PRIM_BIN_CACHE_HIT) {
-      return;
-    }
-    if (process.env.PRIM_BIN_CACHE === "0") {
-      return;
-    }
-    const dir = binCacheDir();
-    mkdirSync(dir, { recursive: true, mode: 448 });
-    chmodSync(dir, 448);
-    writeAtomic(join2(dir, "node"), process.execPath);
-    for (const bin of CACHED_BINS) {
-      const file = binFile(bin);
-      if (file) {
-        writeAtomic(join2(dir, bin), file);
-      }
-    }
-  } catch {
-  }
-}
-
-// src/lib/ansi.ts
-var ANSI_CODES = {
-  yellow: "\x1B[33m",
-  magenta: "\x1B[35m",
-  blue: "\x1B[34m",
-  cyan: "\x1B[36m",
-  green: "\x1B[32m",
-  red: "\x1B[31m",
-  // 256-color approximation of the orange trigger marker (xterm 208).
-  orange: "\x1B[38;5;208m",
-  gray: "\x1B[90m"
-};
-var ANSI_RESET = "\x1B[0m";
-var ANSI_DIM = "\x1B[2m";
-var ANSI_BOLD = "\x1B[1m";
-function supportsColor() {
-  if (process.env.NO_COLOR !== void 0 && process.env.NO_COLOR !== "") {
-    return false;
-  }
-  return process.stderr.isTTY === true;
-}
-function color(text, c) {
-  if (!supportsColor()) {
-    return text;
-  }
-  return `${ANSI_CODES[c]}${text}${ANSI_RESET}`;
-}
-function dim(text) {
-  if (!supportsColor()) {
-    return text;
-  }
-  return `${ANSI_DIM}${text}${ANSI_RESET}`;
-}
-function bold(text) {
-  if (!supportsColor()) {
-    return text;
-  }
-  return `${ANSI_BOLD}${text}${ANSI_RESET}`;
-}
-var AREA_COLORS = {
-  auth: "yellow",
-  data: "magenta",
-  mobile: "blue",
-  infra: "cyan",
-  ui: "green",
-  billing: "orange",
-  api: "blue",
-  docs: "gray",
-  testing: "gray"
-};
-function colorForArea(area) {
-  if (!area) {
-    return "gray";
-  }
-  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;
-}
-var MAX_HEALTH_ERROR_LENGTH = 240;
-function boundedHealthError(value) {
-  if (!value) return void 0;
-  const clean = stripControlChars(value).replace(/\s+/g, " ").trim();
-  if (!clean) return void 0;
-  return clean.length <= MAX_HEALTH_ERROR_LENGTH ? clean : `${clean.slice(0, MAX_HEALTH_ERROR_LENGTH - 1)}\u2026`;
-}
-function stripAnsi(text) {
-  return text.replace(/\u001b\[[0-9;]*m/g, "");
-}
-
-// src/lib/presence.ts
-var DECISION_ORIGIN = "https://app.getprimitive.ai";
-function validDecisionUrl(value) {
-  if (typeof value !== "string" || stripControlChars(value) !== value) {
-    return void 0;
-  }
-  try {
-    const url = new URL(value);
-    if (url.origin !== DECISION_ORIGIN || url.username !== "" || url.password !== "" || url.search !== "" || url.hash !== "" || !/^\/decisions\/[^/]+$/u.test(url.pathname)) {
-      return void 0;
-    }
-    return url.href;
-  } catch {
-    return void 0;
-  }
-}
-function decisionLink(label, decisionUrl, plain) {
-  const url = validDecisionUrl(decisionUrl);
-  if (plain || !url) {
-    return label;
-  }
-  return `\x1B]8;;${url}\x07\x1B[34;4m${label}\x1B[0m\x1B]8;;\x07`;
-}
-function formatLabeled(labels, cap) {
-  if (labels === void 0) {
-    return "\u2014";
-  }
-  if (labels.length === 0) {
-    return "just you";
-  }
-  if (labels.length <= cap) {
-    return labels.join(", ");
-  }
-  return `${labels.slice(0, cap).join(", ")} +${String(labels.length - cap)}`;
-}
-function formatTeammates(names, cap) {
-  return formatLabeled(names?.map(stripControlChars), cap);
-}
-function formatTeammatesWithArea(teammates, cap, plainLinks = false) {
-  return formatLabeled(
-    teammates?.map((t) => {
-      const name = stripControlChars(t.name);
-      const area = stripControlChars(t.area ?? "").trim();
-      const label = area ? `${name} - ${area}` : name;
-      return decisionLink(label, t.decisionUrl, plainLinks);
-    }),
-    cap
-  );
-}
-
-// src/lib/statusline-render.ts
-var STATUSLINE_NAME_CAP = 3;
-function formatStatusline(version, snapshot, resolveIngestionStatus, options = {}) {
-  const ingestionSuffix = (status) => status === void 0 ? "" : ` \xB7 Decision ingestion ${status}`;
-  const ingestionStatus = snapshot === null || snapshot.healthy === false ? options.includeIngestionWhenUnavailable ? resolveIngestionStatus() : void 0 : resolveIngestionStatus();
-  if (!snapshot) {
-    return `primitive ${version} (daemon: down${ingestionSuffix(ingestionStatus)})`;
-  }
-  if (snapshot.healthy === false) {
-    if (snapshot.needsReauth) {
-      return `primitive ${version} (daemon: paused \xB7 run \`prim auth login\`${ingestionSuffix(ingestionStatus)})`;
-    }
-    if (snapshot.ingestion?.healthy === false) {
-      const pending = snapshot.ingestion.pendingCount;
-      const qualifier = snapshot.ingestion.pendingSampled ? "at least " : "";
-      return `primitive ${version} (daemon: degraded \xB7 delivery: stalled${typeof pending === "number" ? ` \xB7 ${qualifier}${String(pending)} pending` : ""}${ingestionSuffix(ingestionStatus)})`;
-    }
-    if (snapshot.heartbeat?.healthy === false) {
-      return `primitive ${version} (daemon: degraded \xB7 presence: unavailable${ingestionSuffix(ingestionStatus)})`;
-    }
-    return `primitive ${version} (daemon: starting${ingestionSuffix(ingestionStatus)})`;
-  }
-  if (snapshot.envMismatch) {
-    return `primitive ${version} (daemon: live, Decision ingestion ${ingestionStatus} \xB7 presence: other env)`;
-  }
-  if (snapshot.presenceStale) {
-    return `primitive ${version} (daemon: live, Decision ingestion ${ingestionStatus} \xB7 presence: stale)`;
-  }
-  let team;
-  if (snapshot.onlineTeammates !== void 0) {
-    team = `team: ${formatTeammatesWithArea(snapshot.onlineTeammates, STATUSLINE_NAME_CAP, options.plainLinks === true)}`;
-  } else 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, Decision ingestion ${ingestionStatus} \xB7 ${team})`;
-}
-
-export {
-  color,
-  dim,
-  bold,
-  colorForArea,
-  stripControlChars,
-  boundedHealthError,
-  stripAnsi,
-  binFile,
-  packageVersion,
-  pinnedHookCommand,
-  detachedHookShimCommand,
-  commandMatchesBin,
-  formatTeammates,
-  warmBinCache,
-  formatStatusline
-};