panoma 0.10.6 → 0.12.0

package/dist/index.js

@@ -1,15 +1,20 @@
 #!/usr/bin/env node
 import {
-  entryCommand,
-  helpText,
-  todayCommand
-} from "./chunk-TXXI7WVK.js";
+  entrypointFromEnvironment,
+  hookOutput,
+  printHookOutput,
+  within
+} from "./chunk-R4EMO3Y2.js";
 import {
   openAllCommand,
   openCommand
-} from "./chunk-FI2ZMO24.js";
+} from "./chunk-UHJA5TUC.js";
+import {
+  entryCommand,
+  helpText,
+  todayCommand
+} from "./chunk-ZRNEAPVY.js";
 import {
-  catalogFetch,
   cliEntry,
   cliVersion,
   downCommand,
@@ -19,43 +24,48 @@ import {
   panomaCommand,
   unreachable,
   upCommand
-} from "./chunk-R3D5NBHW.js";
+} from "./chunk-T7S3VVFE.js";
+import {
+  catalogFetch
+} from "./chunk-6L6WBPRZ.js";
 import {
   plural,
   riskText,
   say
-} from "./chunk-CTWQQWH7.js";
+} from "./chunk-KZILTAZL.js";
 import "./chunk-DITTKJ7U.js";
 import {
-  HOOKS_BRAND,
+  MANAGED_EVENTS,
   MCP_FILE_MODE,
   McpMergeError,
   McpTomlError,
   analyzeProject,
-  asShellLine,
   classifyOrigin,
   deduceIdentity,
   discoverProjects,
   evidenceText,
   expandTilde,
   findDuplicateFamilies,
+  gitScanOrder,
   hookIsOurs,
+  hookStateOf,
   isNewerVersion,
   isProjectRoot,
+  managedHooks,
   mcpProjectTarget,
   mcpSnippet,
+  mergeManagedHooks,
   mergeMcp,
   mergeMcpToml,
-  mergePreToolUse,
-  mergeStop,
   neutralizeInline,
   panomaPath,
   postCommitScript,
-  removeStop,
+  removeManagedHooks,
+  settingsText,
   trackedByGit,
   workRisks,
   wrapUntrusted
-} from "./chunk-3T3WTSPS.js";
+} from "./chunk-RD7TE2IA.js";
 import "./chunk-MLKGABMK.js";
 
 // src/index.ts
@@ -99,6 +109,10 @@ var KNOWN_FLAGS = [
   "--project",
   "--source",
   "--dry-run",
+  "--yes",
+  "--from",
+  "--purpose",
+  "--notice",
   "--to",
   "--tier",
   "--digest",
@@ -131,6 +145,7 @@ function parseArgs(argv) {
     network: false,
     rotateKey: false,
     dryRun: false,
+    yes: false,
     all: false,
     positionals: []
   };
@@ -173,6 +188,7 @@ function parseArgs(argv) {
     else if (arg === "--network") flags.network = true;
     else if (arg === "--rotate-key") flags.rotateKey = true;
     else if (arg === "--dry-run") flags.dryRun = true;
+    else if (arg === "--yes") flags.yes = true;
     else if (arg === "--all") flags.all = true;
     else if (arg === "--api") flags.api = takeValue() ?? flags.api;
     else if (arg === "--depth") flags.depth = Number.parseInt(takeValue() ?? "3", 10) || 3;
@@ -188,6 +204,9 @@ function parseArgs(argv) {
     else if (arg === "--digest") flags.digest = takeValue();
     else if (arg === "--keep") flags.keep = Number.parseInt(takeValue() ?? "", 10);
     else if (arg === "--target-home") flags.targetHome = takeValue();
+    else if (arg === "--from") flags.from = takeValue();
+    else if (arg === "--purpose") flags.purpose = takeValue();
+    else if (arg === "--notice") flags.notice = Number.parseInt(takeValue() ?? "", 10);
     else if (arg.startsWith("-")) unknown.push(arg);
     else positionals.push(arg);
   }
@@ -231,6 +250,16 @@ function parseArgs(argv) {
   if (flags.keep !== void 0 && !(Number.isInteger(flags.keep) && flags.keep > 0)) {
     return { error: say("error.badKeep") };
   }
+  const PURPOSES = ["capture", "extract", "twin"];
+  if (flags.purpose !== void 0 && !PURPOSES.includes(flags.purpose)) {
+    return {
+      error: `${say("error.unknownPurpose", { value: flags.purpose })}
+` + say("error.purposeKinds", { list: PURPOSES.join(" \xB7 ") })
+    };
+  }
+  if (flags.notice !== void 0 && flags.notice !== 1 && flags.notice !== 2) {
+    return { error: say("error.badNotice") };
+  }
   if (flags.folder && flags.terminal) {
     return { error: say("error.folderAndTerminal") };
   }
@@ -240,6 +269,16 @@ function parseArgs(argv) {
   if (flags.install && flags.remove) {
     return { error: say("error.installAndRemove") };
   }
+  if (flags.dryRun && flags.yes) {
+    return { error: say("error.dryRunAndYes") };
+  }
+  if (flags.project !== void 0 && flags.all) {
+    return { error: say("error.projectAndAll") };
+  }
+  const scoped = positionals[0] === "memory" && ["allow", "revoke", "backfill"].includes(positionals[1] ?? "");
+  if (scoped && flags.project === void 0 && !flags.all) {
+    return { error: say("error.projectOrAll", { sub: positionals[1] ?? "" }) };
+  }
   flags.path = positionals[1] ?? ".";
   if (positionals[0] === "video" && !["auto", "scout", "story", "render", "review", "revise", "doctor"].includes(positionals[1] ?? "")) {
     return { error: say("apps.videoVerb", { verb: positionals[1] ?? "" }) };
@@ -277,8 +316,7 @@ import { isAbsolute, join, resolve } from "path";
 import { promisify } from "util";
 import pc from "picocolors";
 var run = promisify(execFile);
-var BRAND = HOOKS_BRAND;
-async function hooksCommand(directory, api, action) {
+async function hooksCommand(directory, api, action, options = {}) {
   const root = resolve(directory);
   const hooks = await hooksDir(root);
   if (!hooks) {
@@ -292,7 +330,7 @@ async function hooksCommand(directory, api, action) {
   const postCommit = join(hooks, "post-commit");
   const anterior = await readFile(postCommit, "utf8").catch(() => void 0);
   const settings = await claudeSettings(root);
-  if (action === "status") return countState(root, postCommit, anterior, settings);
+  if (action === "status") return reportState(root, postCommit, anterior, settings);
   if (action === "remove") return remove(postCommit, anterior, settings);
   if (anterior !== void 0 && !isOurs(anterior)) {
     process.stderr.write(
@@ -304,7 +342,8 @@ async function hooksCommand(directory, api, action) {
     );
     return 1;
   }
-  const { argv, aviso, efimero } = await panomaCommand();
+  const resolved = await (options.command ?? panomaCommand)();
+  const { argv, aviso, efimero } = resolved;
   if (efimero) {
     process.stderr.write(
       `
@@ -317,22 +356,22 @@ async function hooksCommand(directory, api, action) {
     );
     return 1;
   }
-  if (aviso) process.stderr.write(`${pc.yellow("!")} ${pc.dim(aviso)}
+  if (!resolved.durable) {
+    if (aviso) process.stderr.write(`${pc.yellow("!")} ${pc.dim(aviso)}
 `);
-  const paraGit = asShellLine([...argv, "scan", ".", "--save", "--api", api]);
-  const paraClaude = `${asShellLine([...argv, "scan", root, "--save", "--api", api])}  ${BRAND}`;
-  const paraSignal = `${asShellLine([...argv, "signal", root, "--api", api])}  ${BRAND}`;
+    else process.stderr.write(pc.yellow(`${say("hooks.undurable", { detail: undurableDetail(resolved) })}
+`));
+    process.stderr.write(pc.dim(`${say("hooks.undurableHint")}
+`));
+    return 1;
+  }
+  const managed = managedHooks(argv, root, api);
+  const before = hookStateOf({ postCommit: anterior, settings: settings?.content });
   let pending;
   if (settings) {
     try {
-      const stopMerge = mergeStop(settings.content, paraClaude);
-      const { result, updatedAt } = mergePreToolUse(stopMerge.result, paraSignal);
-      pending = {
-        path: settings.path,
-        text: `${JSON.stringify(result, null, 2)}
-`,
-        updatedAt: stopMerge.updatedAt || updatedAt
-      };
+      const { result } = mergeManagedHooks(settings.content, managed);
+      pending = { path: settings.path, text: settingsText(result) };
     } catch (error) {
       process.stderr.write(
         pc.yellow(`${say("hooks.cantWrite", { path: settings.path, reason: error.message })}
@@ -342,17 +381,19 @@ async function hooksCommand(directory, api, action) {
     }
   }
   await mkdir(hooks, { recursive: true });
-  await writeFile(postCommit, postCommitScript(paraGit), "utf8");
+  await writeFile(postCommit, postCommitScript(gitScanOrder(argv, api)), "utf8");
   await chmod(postCommit, 493);
   const facts = [
     `${pc.green("\u2713")} ${say("hooks.postCommit", { path: pc.dim(postCommit) })}`
   ];
   if (pending) {
     await writeFile(pending.path, pending.text, "utf8");
-    facts.push(
-      `${pc.green("\u2713")} ${say("hooks.stopInstalled", { path: pc.dim(pending.path) })}${pending.updatedAt ? pc.dim(say("hooks.updated")) : ""}`,
-      `${pc.green("\u2713")} ${say("hooks.signalInstalled", { path: pc.dim(pending.path) })}`
-    );
+    for (const event of MANAGED_EVENTS) {
+      const updated = before.events[event] !== "missing";
+      facts.push(
+        `${pc.green("\u2713")} ${say(EVENT_LINE[event], { path: pc.dim(pending.path) })}${updated ? pc.dim(say("hooks.updated")) : ""}`
+      );
+    }
   }
   process.stdout.write(
     ["", ...facts.map((line) => `  ${line}`), "", pc.dim(`      ${say("hooks.removeWith")}`), "", ""].join(
@@ -362,6 +403,20 @@ async function hooksCommand(directory, api, action) {
   return 0;
 }
 var isOurs = hookIsOurs;
+var EVENT_LINE = {
+  Stop: "hooks.stopInstalled",
+  PreToolUse: "hooks.signalInstalled",
+  SessionStart: "hooks.briefInstalled",
+  SessionEnd: "hooks.sessionInstalled"
+};
+function undurableDetail(resolved) {
+  const entry = resolved.argv[1] ?? resolved.argv[0] ?? "panoma";
+  if (resolved.reason === "ephemeral") return say("hooks.undurableEphemeral", { entry });
+  if (resolved.reason === "probe_failed") {
+    return say("hooks.undurableProbe", { entry, detail: resolved.detail ?? "no answer" });
+  }
+  return say("hooks.undurableMissing", { entry });
+}
 async function hooksDir(root) {
   try {
     const { stdout } = await run("git", ["rev-parse", "--git-path", "hooks"], {
@@ -376,8 +431,8 @@ async function hooksDir(root) {
   }
 }
 async function scanOrder(api) {
-  const { argv } = await panomaCommand();
-  return `${asShellLine([...argv, "scan", ".", "--save", "--api", api])} >/dev/null 2>&1 &`;
+  const { argv } = await panomaCommand({ probe: false });
+  return `${gitScanOrder(argv, api)} >/dev/null 2>&1 &`;
 }
 async function claudeSettings(root) {
   for (const name of ["settings.local.json", "settings.json"]) {
@@ -411,11 +466,10 @@ async function remove(postCommit, anterior, settings) {
     facts.push(`${pc.green("\u2713")} ${say("hooks.postCommitRemoved", { path: pc.dim(postCommit) })}`);
   }
   if (settings) {
-    const { result, removed } = removeStop(settings.content);
+    const { result, removed } = removeManagedHooks(settings.content);
     if (removed > 0) {
-      await writeFile(settings.path, `${JSON.stringify(result, null, 2)}
-`, "utf8");
-      facts.push(`${pc.green("\u2713")} ${say("hooks.stopRemoved", { path: pc.dim(settings.path) })}`);
+      await writeFile(settings.path, settingsText(result), "utf8");
+      facts.push(`${pc.green("\u2713")} ${say("hooks.claudeRemoved", { path: pc.dim(settings.path), n: removed })}`);
     } else {
       facts.push(pc.dim(say("hooks.noPanomaHook", { path: settings.path })));
     }
@@ -423,22 +477,29 @@ async function remove(postCommit, anterior, settings) {
   process.stdout.write(["", ...facts.map((line) => `  ${line}`), "", ""].join("\n"));
   return 0;
 }
-function countState(root, postCommit, anterior, settings) {
-  const brand = (present) => present ? pc.green("\u2713") : pc.dim("\xB7");
-  const stopPresent = settings ? JSON.stringify(settings.content).includes(BRAND) : false;
-  process.stdout.write(
-    [
-      "",
-      `  ${pc.bold(say("hooks.statusTitle"))} ${pc.cyan(root)}`,
-      "",
-      `      ${brand(anterior !== void 0 && isOurs(anterior))} ${say("hooks.gitPostCommit", { path: pc.dim(postCommit) })}`,
-      settings ? `      ${brand(stopPresent)} ${say("hooks.stopInstalled", { path: pc.dim(settings.path) })}` : `      ${pc.dim(say("hooks.noSettings"))}`,
-      "",
-      pc.dim(`      ${say("hooks.statusHint")}`),
-      "",
-      ""
-    ].join("\n")
-  );
+function reportState(root, postCommit, anterior, settings) {
+  const state = hookStateOf({ postCommit: anterior, settings: settings?.content });
+  const mark = (present) => present ? pc.green("\u2713") : pc.dim("\xB7");
+  const lines = [
+    "",
+    `  ${pc.bold(say("hooks.statusTitle"))} ${pc.cyan(root)}`,
+    "",
+    `      ${mark(state.postCommit)} ${say("hooks.gitPostCommit", { path: pc.dim(postCommit) })}`
+  ];
+  if (settings) {
+    for (const event of MANAGED_EVENTS) {
+      const eventState = state.events[event];
+      const suffix = eventState === "legacy" ? pc.yellow(say("hooks.eventLegacy")) : eventState === "missing" ? pc.dim(say("hooks.eventMissing")) : "";
+      const symbol = eventState === "installed" ? pc.green("\u2713") : eventState === "legacy" ? pc.yellow("!") : pc.dim("\xB7");
+      lines.push(`      ${symbol} ${say(EVENT_LINE[event], { path: pc.dim(settings.path) })}${suffix}`);
+    }
+  } else {
+    lines.push(`      ${pc.dim(say("hooks.noSettings"))}`);
+  }
+  if (state.durable === true) lines.push(`      ${pc.green("\u2713")} ${say("hooks.durable")}`);
+  else if (state.durable === false) lines.push(`      ${pc.yellow("!")} ${say("hooks.notDurable")}`);
+  lines.push("", pc.dim(`      ${say("hooks.statusHint")}`), "", "");
+  process.stdout.write(lines.join("\n"));
   return 0;
 }
 
@@ -521,8 +582,39 @@ async function readStdin() {
   for await (const chunk of process.stdin) chunks.push(chunk);
   return Buffer.concat(chunks).toString("utf8");
 }
-async function signalCommand(root, api) {
+async function signalV2(root, path, session, api, deadline, fd) {
+  const remaining = deadline - Date.now();
+  if (remaining <= 0) return "done";
+  const entrypoint = entrypointFromEnvironment();
+  const response = await catalogFetch(new URL("/api/hook/context", api), {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      cwd: root,
+      harness: "claude-code",
+      channel: "signal",
+      ...entrypoint === void 0 ? {} : { entrypoint },
+      ...session === void 0 ? {} : { nativeSessionId: session },
+      paths: [path],
+      operation: "edit"
+    }),
+    signal: AbortSignal.timeout(remaining)
+  });
+  if (response.status === 409 || response.status === 404) {
+    const refusal = await within(response.json().catch(() => void 0), deadline - Date.now());
+    const code = typeof refusal?.code === "string" ? refusal.code : void 0;
+    if (response.status === 409) return code === "unsupported_host" ? "fallback" : "done";
+    return code === void 0 ? "fallback" : "done";
+  }
+  if (!response.ok) return "done";
+  const reply = await within(response.json().catch(() => void 0), deadline - Date.now());
+  const output = hookOutput(reply, "hook-signal-v1");
+  if (output !== void 0) printHookOutput(output, fd);
+  return "done";
+}
+async function signalCommand(root, api, options = {}) {
   try {
+    const started = Date.now();
     const raw = await readStdin();
     const touched = pathFromHookInput(raw);
     if (touched === void 0) return 0;
@@ -531,10 +623,18 @@ async function signalCommand(root, api) {
     const nativeRelative = relative(projectRoot, absolute);
     if (nativeRelative.startsWith("..") || isAbsolute2(nativeRelative)) return 0;
     const relativePath2 = portablePath(nativeRelative);
+    let budget = TIMEOUT_MS;
+    if (options.v2 ?? process.env["PANOMA_SIGNAL_V2"] === "1") {
+      const deadline = started + TIMEOUT_MS;
+      const outcome = await signalV2(projectRoot, relativePath2, sessionFromHookInput(raw), api, deadline, options.fd);
+      if (outcome === "done") return 0;
+      budget = deadline - Date.now();
+      if (budget <= 0) return 0;
+    }
     const url = new URL("/api/agent/notes", api);
     url.searchParams.set("cwd", projectRoot);
     url.searchParams.set("touching", relativePath2);
-    const response = await catalogFetch(url, { signal: AbortSignal.timeout(TIMEOUT_MS) });
+    const response = await catalogFetch(url, { signal: AbortSignal.timeout(budget) });
     if (!response.ok) return 0;
     const payload = await response.json().catch(() => void 0);
     const notes = (payload?.notes ?? []).filter((note) => typeof note?.body === "string").map((note) => ({ id: typeof note.id === "string" ? note.id : void 0, body: note.body }));
@@ -544,14 +644,15 @@ async function signalCommand(root, api) {
     const served = seen === void 0 || session === void 0 ? /* @__PURE__ */ new Set() : new Set(seen[session] ?? []);
     const fresh = notes.filter((note) => note.id === void 0 || !served.has(note.id));
     if (fresh.length === 0) return 0;
-    process.stdout.write(
+    printHookOutput(
       `${JSON.stringify({
         hookSpecificOutput: {
           hookEventName: "PreToolUse",
           additionalContext: signalContext(relativePath2, fresh)
         }
       })}
-`
+`,
+      options.fd
     );
     if (session !== void 0 && seen !== void 0) {
       const delivered = fresh.map((note) => note.id).filter((id) => id !== void 0);
@@ -1057,19 +1158,19 @@ ${pc3.dim(say("error.seeHelp"))}
   if (command === void 0) return conAviso(await entryCommand(parsed.api));
   if (command === "today") return todayCommand(parsed.api);
   if (command === "apps") {
-    const { appsCommand } = await import("./apps-FBC65DRJ.js");
+    const { appsCommand } = await import("./apps-JIBB353S.js");
     return appsCommand(parsed);
   }
   if (command === "video") {
-    const { videoCommand } = await import("./video-UUJXJTLD.js");
+    const { videoCommand } = await import("./video-AFYY2VSI.js");
     return videoCommand(parsed);
   }
   if (command === "next") {
-    const { nextCommand } = await import("./next-command-PUKTGFHC.js");
+    const { nextCommand } = await import("./next-command-RKJV6BCU.js");
     return nextCommand(parsed.api, parsed.positionals.slice(1));
   }
   if (command === "north") {
-    const { northCommand } = await import("./north-command-GFPTPOXX.js");
+    const { northCommand } = await import("./north-command-ZZ3TWEDY.js");
     return northCommand(parsed);
   }
   if (command === "open") {
@@ -1090,7 +1191,7 @@ ${pc3.dim(say("error.seeHelp"))}
 `));
       return 1;
     }
-    const { checkCommand } = await import("./check-command-GBIFTYMC.js");
+    const { checkCommand } = await import("./check-command-RADN7EQ2.js");
     return checkCommand(parsed.api, query);
   }
   let escanear = command === "scan";
@@ -1109,6 +1210,10 @@ ${pc3.dim(say("error.seeHelp"))}
   if (command === "signal") {
     return signalCommand(resolve3(expandTilde(parsed.path)), parsed.api);
   }
+  if (command === "brief") {
+    const { briefCommand } = await import("./brief-QRIDN6ND.js");
+    return briefCommand(resolve3(expandTilde(parsed.path)), parsed.api);
+  }
   if (command === "hooks") {
     const target2 = resolve3(expandTilde(parsed.path));
     return hooksCommand(
@@ -1118,14 +1223,14 @@ ${pc3.dim(say("error.seeHelp"))}
     );
   }
   if (command === "ai") {
-    const { aiCommand } = await import("./ai-command-QEXAVD5A.js");
+    const { aiCommand } = await import("./ai-command-KHHP7M3P.js");
     return aiCommand(parsed);
   }
   if (command === "md") {
     const target2 = resolve3(
       expandTilde(parsed.positionals[2] ?? ".")
     );
-    const { mdCommand } = await import("./md-command-QFRCVG3N.js");
+    const { mdCommand } = await import("./md-command-4DLP6YD6.js");
     return mdCommand(parsed.positionals[1], target2, parsed.api, { force: parsed.force });
   }
   if (command === "disk") return reportDisk(parsed.api);
@@ -1176,24 +1281,24 @@ ${pc3.dim(say("error.seeHelp"))}
     return createAgentKey(parsed.api, name, parsed.install);
   }
   if (command === "twin") {
-    const { twinCommand } = await import("./twin-command-K42J3VLZ.js");
+    const { twinCommand } = await import("./twin-command-M4ENHXMZ.js");
     return twinCommand(parsed);
   }
   if (command === "memory") {
-    const { memoryCommand } = await import("./memory-command-PETERVDN.js");
+    const { memoryCommand } = await import("./memory-command-WNZOQUPW.js");
     return memoryCommand(parsed);
   }
   if (command === "spend") {
-    const { spendCommand } = await import("./spend-command-7KF2TMUR.js");
+    const { spendCommand } = await import("./spend-command-NQ5LQLIH.js");
     return spendCommand(parsed);
   }
   if (command === "handoff") {
-    const { handoffCommand } = await import("./handoff-command-LT7XVHWZ.js");
+    const { handoffCommand } = await import("./handoff-command-EMWYQVOX.js");
     return handoffCommand(parsed);
   }
   if (command === "review") {
     const target2 = resolve3(expandTilde(parsed.positionals[1] ?? "."));
-    const { reviewCommand } = await import("./review-command-AMGBA6JJ.js");
+    const { reviewCommand } = await import("./review-command-7UOAO3SN.js");
     return reviewCommand(target2);
   }
   if (!escanear) {
@@ -1861,7 +1966,10 @@ async function dispatchRun(api, slug, packageName, targetVersion, options) {
   return result.status === "failed" ? 1 : 0;
 }
 main().then(
-  (code) => process.exit(code),
+  // A pipe takes the standard output in chunks of 64 KiB and the rest waits in the process; an
+  // exit right after the write cut `memory status --json` at that size (probe of 14-Sep-2026).
+  // The empty write's callback fires once everything before it has left the process.
+  (code) => process.stdout.write("", () => process.exit(code)),
   (error) => {
     const failure = error;
     process.stderr.write(pc3.red(`${failure.message ?? String(error)}

package/dist/{md-command-QFRCVG3N.js → md-command-4DLP6YD6.js}

@@ -1,11 +1,13 @@
 import {
-  catalogFetch,
   unreachable
-} from "./chunk-R3D5NBHW.js";
+} from "./chunk-T7S3VVFE.js";
+import {
+  catalogFetch
+} from "./chunk-6L6WBPRZ.js";
 import {
   plural,
   say
-} from "./chunk-CTWQQWH7.js";
+} from "./chunk-KZILTAZL.js";
 import "./chunk-DITTKJ7U.js";
 import {
   CLAUDE_BRIDGE,
@@ -27,7 +29,7 @@ import {
   shotsOpen,
   tasteDigest,
   upsertPanomaBlock
-} from "./chunk-3T3WTSPS.js";
+} from "./chunk-RD7TE2IA.js";
 import "./chunk-MLKGABMK.js";
 
 // src/md-command.ts