@bartolli/kmd 0.10.0 → 0.11.0

package/dist/kmd.mjs

@@ -248,6 +248,12 @@ var init_vault_config = __esm({
       }).optional(),
       "handoff-gate": z.strictObject({
         reason: z.string().min(1).optional().describe("Stop-block preamble; the engine appends the error lines.")
+      }).optional(),
+      orient: z.strictObject({
+        text: z.string().min(1).optional().describe("Session-start prime instruction; the engine prepends the resolved scope.")
+      }).optional(),
+      reorient: z.strictObject({
+        text: z.string().min(1).optional().describe("Post-compaction re-orientation; the engine prepends the resolved scope.")
       }).optional()
     });
     VaultConfigSchema = z.strictObject({
@@ -269,7 +275,7 @@ var init_vault_config = __esm({
         'Full-replace of the trigger base per scope \u2014 escape hatch. "_all" is reserved for triggers_extra.'
       ),
       builtin_hooks: BuiltinHooksSchema.optional().describe(
-        "Message overrides for the fixed-function hooks (resync, handoff-gate) by public id."
+        "Message overrides for the fixed-function hooks (resync, handoff-gate, orient, reorient) by public id."
       ),
       triggers_extra: TriggersSchema.optional().describe(
         'Appended per scope after the engine defaults; the reserved "_all" key fires in every session.'
@@ -2366,15 +2372,18 @@ __export(hook_exports, {
   matchPromptTriggers: () => matchPromptTriggers,
   parsePretoolEvent: () => parsePretoolEvent,
   parsePromptEvent: () => parsePromptEvent,
+  parseSessionStartEvent: () => parseSessionStartEvent,
   parseStopEvent: () => parseStopEvent,
   renderPosttool: () => renderPosttool,
   renderPretool: () => renderPretool,
   renderPrompt: () => renderPrompt,
+  renderSessionStart: () => renderSessionStart,
   renderStop: () => renderStop,
   resolveScope: () => resolveScope,
   runHookPosttool: () => runHookPosttool,
   runHookPretool: () => runHookPretool,
   runHookPrompt: () => runHookPrompt,
+  runHookSessionStart: () => runHookSessionStart,
   runHookStop: () => runHookStop,
   vaultPathTouched: () => vaultPathTouched
 });
@@ -3118,6 +3127,42 @@ async function runHookStop() {
     diag2(err instanceof Error ? err.message : String(err));
   }
 }
+function parseSessionStartEvent(raw) {
+  const fields = eventFields(raw);
+  if (fields === null) return null;
+  const { session_id, cwd, source } = fields;
+  if (typeof session_id !== "string") return null;
+  return {
+    session_id,
+    ...typeof cwd === "string" && { cwd },
+    ...typeof source === "string" && { source }
+  };
+}
+function renderSessionStart(scope, source, messages = {}) {
+  const text = source === "compact" ? messages.reorient?.text ?? REORIENT_TEXT : messages.orient?.text ?? ORIENT_TEXT;
+  return `Wiki scope "${scope}": ${text}`;
+}
+async function runHookSessionStart() {
+  try {
+    const invocation = hookInvocation();
+    if (invocation === null) return;
+    if (invocation.dryRun) {
+      diag2("--dry-run/--explain support prompt and pretool events only");
+      return;
+    }
+    const event = parseSessionStartEvent(await readStdin());
+    if (event === null) {
+      diag2("stdin is not a session-start event ({session_id})");
+      return;
+    }
+    const config = await loadVaultConfig(invocation.vaultRoot);
+    const scope = invocation.scope ?? resolveScope(config, event.cwd);
+    if (scope === void 0) return;
+    console.log(renderSessionStart(scope, event.source, config.builtin_hooks ?? {}));
+  } catch (err) {
+    diag2(err instanceof Error ? err.message : String(err));
+  }
+}
 async function readStdin() {
   process.stdin.setEncoding("utf8");
   let input = "";
@@ -3129,7 +3174,7 @@ async function readStdin() {
 function diag2(message) {
   console.error(`kmd hook: ${message}`);
 }
-var DEFAULT_TRIGGERS, SESSION_STATE_MAX_AGE_MS, KIRO_IDE_BUCKET_MS, ALL_SCOPES_KEY, PATCH_FILE_RE, COMMAND_TOKEN_RE, PATHISH_RE, RESYNC_REASON, RESYNC_TEXT, HANDOFF_GATE_REASON;
+var DEFAULT_TRIGGERS, SESSION_STATE_MAX_AGE_MS, KIRO_IDE_BUCKET_MS, ALL_SCOPES_KEY, PATCH_FILE_RE, COMMAND_TOKEN_RE, PATHISH_RE, RESYNC_REASON, RESYNC_TEXT, HANDOFF_GATE_REASON, ORIENT_TEXT, REORIENT_TEXT;
 var init_hook = __esm({
   "../cli/src/hook.ts"() {
     "use strict";
@@ -3148,6 +3193,8 @@ var init_hook = __esm({
     RESYNC_REASON = "Edit landed; the index sync is held until these validate errors are fixed";
     RESYNC_TEXT = "kmd sync failed \u2014 index not updated; see hook stderr";
     HANDOFF_GATE_REASON = "Validate errors are outstanding and the index sync is held \u2014 fix them, let the resync run, then finish";
+    ORIENT_TEXT = "prime via the wiki MCP prime tool before substantive work \u2014 the primer carries current focus, book of work, and invariants.";
+    REORIENT_TEXT = "context was compacted and transcript detail is lost \u2014 re-read the primer via the wiki MCP prime tool and route uncaptured findings into the wiki before continuing.";
   }
 });
 
@@ -3168,7 +3215,7 @@ commands:
   mcp [<vault-root>]       start the stdio MCP server (default: $WIKI_VAULT)
   config [<vault-root>]    print vault + index resolution; with no vault, list known vaults
   db reset [<vault-root>]  delete the vault's index (default: $WIKI_VAULT)
-  hook <prompt|pretool|posttool|stop> [<vault-root>] [--scope <s>] [--harness <claude|kiro-ide>] [--triggers <file>]
+  hook <prompt|pretool|posttool|stop|session-start> [<vault-root>] [--scope <s>] [--harness <claude|kiro-ide>] [--triggers <file>]
                            harness gate engine: JSON event on stdin, decision/context on stdout;
                            posttool auto-runs validate + sync after a vault write;
                            stop blocks the handoff once while validate errors hold the sync
@@ -3249,11 +3296,14 @@ async function run() {
       } else if (sub === "stop") {
         const { runHookStop: runHookStop2 } = await Promise.resolve().then(() => (init_hook(), hook_exports));
         await runHookStop2();
+      } else if (sub === "session-start") {
+        const { runHookSessionStart: runHookSessionStart2 } = await Promise.resolve().then(() => (init_hook(), hook_exports));
+        await runHookSessionStart2();
       } else if (sub) {
         console.error(`kmd hook: unknown event: ${sub}`);
       } else {
         console.error(
-          "usage: kmd hook <prompt|pretool|posttool|stop> [<vault-root>] [--scope <scope>] [--harness <claude|kiro-ide>]"
+          "usage: kmd hook <prompt|pretool|posttool|stop|session-start> [<vault-root>] [--scope <scope>] [--harness <claude|kiro-ide>]"
         );
         process.exit(2);
       }