heyspex 0.2.0 → 0.2.1

package/vendor/heyspex-mcp/tool-dispatch.mjs

@@ -5,8 +5,10 @@
 
 import { executeHook, finalizeToolResultWithHooks, listHookConfig, loadHooksConfig, matchHooks, runHooks } from './hooks-engine.mjs';
 import { detectAgentIdentity, getConfig } from './mcp-config.mjs';
+import { setWriteOutboxRoot } from './write-outbox.mjs';
 import { existsSync, readFileSync } from 'node:fs';
 import { evaluatePreflightGate } from './preflight-gate.mjs';
+import { evaluateObligationBackstop } from './obligation-backstop.mjs';
 import { TOOLS, handleLoadTools } from './tool-catalog.mjs';
 import { handleNextOnDeck, handleNextResolution, handleNextReview, handleResolvePrerequisite, handleSuggestPillar } from './on-deck-brief.mjs';
 import { handleFileSpec, handleGroundPlan, handlePlanQc, handlePlanReview, handlePushPlan, handleRegisterSpec, handleValidateLinkage, handleValidateUserSkills } from './filing-tools.mjs';
@@ -169,6 +171,9 @@ const TOOLS_BY_NAME = new Map(TOOLS.map((t) => [t.name, t]));
  * A tool without a budget is dispatched untouched.
  */
 export function dispatchHeySpexTool(name, args, vaultRoot, config) {
+  // Lets deep writers (createSpecViaConsole & co.) and the first-success drain
+  // find the write outbox without every caller threading a vaultRoot.
+  setWriteOutboxRoot(vaultRoot);
   return applyToolBudget(
     name,
     args,
@@ -460,6 +465,19 @@ export function handleToolsCall(params) {
     };
   }
 
+  // Capture-obligation backstop ([[HS-20SW-DRSM-DIAG-heyspex-capture-on-idea-and-workflow]]): holds on surfaces where
+  // no hook loads. Fail open; break-glass HEYSPEX_OBLIGATION_BACKSTOP_OFF=1.
+  const obligationVerdict = evaluateObligationBackstop(name, args, {
+    sessionId: detectAgentIdentity(args.agent, args.session_id).sessionId,
+    vaultRoot,
+  });
+  if (obligationVerdict) {
+    return {
+      isError: true,
+      content: [{ type: 'text', text: JSON.stringify(obligationVerdict, null, 2) }],
+    };
+  }
+
   const result = dispatchHeySpexTool(name, args, vaultRoot, config);
   const finalized = finalizeToolResultWithHooks(name, args, result, hooksCfg, preResult);
   return preflightVerdict && preflightVerdict.level === 'warn'