oh-my-codex 0.13.2 → 0.14.1

package/dist/hooks/__tests__/debugger-log-recency-contract.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugger-log-recency-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/debugger-log-recency-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,KAAK,MAAM,OAAO,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,EAAE,CAAC;YAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,+DAA+D,CAAC,CAAC;QACzF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,OAAO,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,yEAAyE,CAAC,CAAC;QACjG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"debugger-log-recency-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/debugger-log-recency-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAE1F,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,KAAK,MAAM,OAAO,IAAI,wBAAwB,EAAE,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,+DAA+D,CAAC,CAAC;QACzF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,OAAO,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,yEAAyE,CAAC,CAAC;QACjG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,qCAAqC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hooks/__tests__/deep-interview-contract.test.js

@@ -24,8 +24,11 @@ function readProjectAgents(startDir) {
 }
 const deepInterviewSkill = readFileSync(join(__dirname, "../../../skills/deep-interview/SKILL.md"), "utf-8");
 const autopilotSkill = readFileSync(join(__dirname, "../../../skills/autopilot/SKILL.md"), "utf-8");
-const rootAgents = readProjectAgents(join(__dirname, "../../.."));
 const templateAgents = readFileSync(join(__dirname, "../../../templates/AGENTS.md"), "utf-8");
+const rootAgentsPath = join(__dirname, "../../../AGENTS.md");
+const rootAgents = existsSync(rootAgentsPath)
+    ? readProjectAgents(join(__dirname, "../../.."))
+    : null;
 describe("deep-interview Ouroboros contract", () => {
     it("includes ambiguity gate math and intent-first scoring", () => {
         assert.match(deepInterviewSkill, /ambiguity/i);
@@ -89,6 +92,43 @@ describe("deep-interview Ouroboros contract", () => {
         assert.match(deepInterviewSkill, /Residual-Risk Rule/i);
         assert.match(deepInterviewSkill, /Do NOT implement directly/i);
     });
+    it("documents omx question as the required structured questioning path with no fallback", () => {
+        assert.match(deepInterviewSkill, /omx question/i);
+        assert.match(deepInterviewSkill, /required `AskUserQuestion` equivalent/i);
+        assert.match(deepInterviewSkill, /requires the OMX question tool rather than falling back to another questioning path/i);
+        assert.doesNotMatch(deepInterviewSkill, /prefer `omx question` when available/i);
+        assert.doesNotMatch(deepInterviewSkill, /else, use `request_user_input` to present concise multiple-choice options/i);
+        assert.doesNotMatch(deepInterviewSkill, /fall back to concise plain-text one-question turns/i);
+    });
+    it("teaches canonical single-choice vs multi-answerable omx question payloads", () => {
+        assert.match(deepInterviewSkill, /Use canonical `type` values instead of authoring raw `multi_select` flags by hand/i);
+        assert.match(deepInterviewSkill, /type: "single-answerable"/i);
+        assert.match(deepInterviewSkill, /type: "multi-answerable"/i);
+        assert.match(deepInterviewSkill, /Use `single-answerable` when exactly one answer should drive the next branch/i);
+        assert.match(deepInterviewSkill, /Use `multi-answerable` when multiple options may all be true at once/i);
+        assert.match(deepInterviewSkill, /If one selected option would immediately require a follow-up question to disambiguate the others, prefer a `single-answerable` round now/i);
+        assert.match(deepInterviewSkill, /Keep interview options bounded and concrete\./i);
+        assert.match(deepInterviewSkill, /Canonical bounded single-choice payload:/i);
+        assert.match(deepInterviewSkill, /Which execution lane should own this once the interview is complete\?/i);
+        assert.match(deepInterviewSkill, /"value": "ralplan"/i);
+        assert.match(deepInterviewSkill, /"value": "autopilot"/i);
+        assert.match(deepInterviewSkill, /"value": "refine"/i);
+        assert.match(deepInterviewSkill, /Canonical bounded multi-select payload:/i);
+        assert.match(deepInterviewSkill, /Which non-goals must stay out of scope for the first pass\?/i);
+        assert.match(deepInterviewSkill, /"value": "no-ui-redesign"/i);
+        assert.match(deepInterviewSkill, /"value": "no-new-dependencies"/i);
+        assert.match(deepInterviewSkill, /"value": "no-api-contract-changes"/i);
+    });
+    it("locks canonical omx question answer shapes for single and multi rounds", () => {
+        assert.match(deepInterviewSkill, /Canonical answer-shape reminders:/i);
+        assert.match(deepInterviewSkill, /"kind": "option"/i);
+        assert.match(deepInterviewSkill, /"value": "ralplan"/i);
+        assert.match(deepInterviewSkill, /"selected_values": \["ralplan"\]/i);
+        assert.match(deepInterviewSkill, /"kind": "multi"/i);
+        assert.match(deepInterviewSkill, /"value": \["no-new-dependencies", "no-api-contract-changes"\]/i);
+        assert.match(deepInterviewSkill, /"selected_values": \["no-new-dependencies", "no-api-contract-changes"\]/i);
+        assert.match(deepInterviewSkill, /For `multi-answerable`, treat `answer\.selected_values` as the source of truth/i);
+    });
     it("preserves clarified intent and boundary constraints across execution handoff", () => {
         assert.match(deepInterviewSkill, /preserve intent, non-goals, decision boundaries, acceptance criteria/i);
         assert.match(deepInterviewSkill, /binding context/i);
@@ -121,7 +161,7 @@ describe("deep-interview Ouroboros contract", () => {
         assert.match(deepInterviewSkill, /Confirmation Bridge/i);
         assert.match(deepInterviewSkill, /refine further/i);
         assert.match(deepInterviewSkill, /launch/i);
-        assert.match(deepInterviewSkill, /do not launch detached tmux until the user explicitly confirms/i);
+        assert.match(deepInterviewSkill, /do not run direct CLI launch or detached\/split tmux launch, and only hand off to `\$autoresearch` after explicit confirmation/i);
         assert.match(deepInterviewSkill, /<\.\.\.>/i);
         assert.match(deepInterviewSkill, /TODO/i);
         assert.match(deepInterviewSkill, /TBD/i);
@@ -135,11 +175,17 @@ describe("cross-skill and AGENTS coherence for deep-interview", () => {
         assert.match(autopilotSkill, /deep-interview/i);
         assert.match(autopilotSkill, /Socratic/i);
     });
-    it("root and template AGENTS include ouroboros keyword and updated description", () => {
-        assert.match(rootAgents, /ouroboros/i);
+    it("tracked AGENTS surfaces include ouroboros keyword and updated description", () => {
+        if (rootAgents != null) {
+            assert.match(rootAgents, /ouroboros/i);
+            assert.match(rootAgents, /Socratic deep interview/i);
+        }
         assert.match(templateAgents, /ouroboros/i);
-        assert.match(rootAgents, /Socratic deep interview/i);
         assert.match(templateAgents, /Socratic deep interview/i);
     });
+    it("makes template AGENTS explicit about omx question for deep-interview", () => {
+        assert.match(templateAgents, /deep-interview is active.*`omx question`/i);
+        assert.match(templateAgents, /do not substitute `request_user_input` or ad hoc plain-text questioning/i);
+    });
 });
 //# sourceMappingURL=deep-interview-contract.test.js.map

package/dist/hooks/__tests__/deep-interview-contract.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-interview-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/deep-interview-contract.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deep-interview-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/deep-interview-contract.test.ts"],"names":[],"mappings":"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"}

package/dist/hooks/__tests__/explicit-terminal-stop-docs-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=explicit-terminal-stop-docs-contract.test.d.ts.map

package/dist/hooks/__tests__/explicit-terminal-stop-docs-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit-terminal-stop-docs-contract.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/explicit-terminal-stop-docs-contract.test.ts"],"names":[],"mappings":""}

package/dist/hooks/__tests__/explicit-terminal-stop-docs-contract.test.js

@@ -0,0 +1,43 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { loadSurface } from "./prompt-guidance-test-helpers.js";
+describe("explicit terminal stop model docs contract", () => {
+    it("locks the canonical lifecycle vocabulary and legacy boundaries", () => {
+        const doc = loadSurface("docs/contracts/explicit-terminal-stop-model.md");
+        for (const outcome of ["finished", "blocked", "failed", "userinterlude", "askuserQuestion"]) {
+            assert.equal(doc.includes(`| \`${outcome}\``), true);
+        }
+        assert.match(doc, /blocked_on_user/i);
+        assert.match(doc, /cancelled.*internal legacy\/admin/i);
+        assert.match(doc, /do \*\*not\*\* present as a canonical user-facing lifecycle outcome/i);
+        assert.match(doc, /If you want, I can/i);
+        assert.match(doc, /Would you like me to continue\?/i);
+    });
+    it("documents lifecycle precedence in the state model", () => {
+        const doc = loadSurface("docs/STATE_MODEL.md");
+        assert.match(doc, /Terminal lifecycle outcome compatibility/i);
+        assert.match(doc, /`finished`/i);
+        assert.match(doc, /`askuserQuestion`/i);
+        assert.match(doc, /Prefer a dedicated canonical lifecycle field over legacy `run_outcome`/i);
+        assert.match(doc, /Keep `cancelled` as an internal legacy\/admin phase/i);
+    });
+    it("keeps native hook docs aligned with lifecycle metadata precedence", () => {
+        const doc = loadSurface("docs/codex-native-hooks.md");
+        assert.match(doc, /Explicit terminal stop model note/i);
+        assert.match(doc, /prefer explicit lifecycle metadata over assistant-text heuristics/i);
+        assert.match(doc, /legacy `blocked_on_user` still suppresses continuation/i);
+        assert.match(doc, /`cancelled` should be treated as internal legacy\/admin compatibility/i);
+        assert.match(doc, /no distinct native Codex `ask-user-question` hook today/i);
+    });
+    it("extends prompt guidance docs with the explicit terminal handoff rule", () => {
+        const doc = loadSurface("docs/prompt-guidance-contract.md");
+        assert.match(doc, /Active workflow terminal handoff contract/i);
+        assert.match(doc, /name an explicit outcome such as `finished`, `blocked`, `failed`, `userinterlude`, or `askuserQuestion`/i);
+        assert.match(doc, /should not end in permission-seeking softeners/i);
+        assert.match(doc, /If you want, I can/i);
+        assert.match(doc, /If you'd like, I can/i);
+        assert.match(doc, /Would you like me to continue\?/i);
+        assert.match(doc, /dist\/hooks\/__tests__\/explicit-terminal-stop-docs-contract\.test\.js/i);
+    });
+});
+//# sourceMappingURL=explicit-terminal-stop-docs-contract.test.js.map

package/dist/hooks/__tests__/explicit-terminal-stop-docs-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit-terminal-stop-docs-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/explicit-terminal-stop-docs-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,GAAG,GAAG,WAAW,CAAC,gDAAgD,CAAC,CAAC;QAC1E,KAAK,MAAM,OAAO,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,CAAC;YAC5F,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,OAAO,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oCAAoC,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,sEAAsE,CAAC,CAAC;QAC1F,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,GAAG,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,2CAA2C,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,yEAAyE,CAAC,CAAC;QAC7F,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,sDAAsD,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,GAAG,GAAG,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oCAAoC,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oEAAoE,CAAC,CAAC;QACxF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,yDAAyD,CAAC,CAAC;QAC7E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,wEAAwE,CAAC,CAAC;QAC5F,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,0DAA0D,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,GAAG,GAAG,WAAW,CAAC,kCAAkC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,4CAA4C,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,0GAA0G,CAAC,CAAC;QAC9H,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,iDAAiD,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,yEAAyE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hooks/__tests__/explicit-terminal-stop-model-docs-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=explicit-terminal-stop-model-docs-contract.test.d.ts.map

package/dist/hooks/__tests__/explicit-terminal-stop-model-docs-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit-terminal-stop-model-docs-contract.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/explicit-terminal-stop-model-docs-contract.test.ts"],"names":[],"mappings":""}

package/dist/hooks/__tests__/explicit-terminal-stop-model-docs-contract.test.js

@@ -0,0 +1,38 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { loadSurface } from './prompt-guidance-test-helpers.js';
+describe('explicit terminal stop model docs contract', () => {
+    it('documents the canonical terminal lifecycle vocabulary', () => {
+        const doc = loadSurface('docs/contracts/explicit-terminal-stop-model.md');
+        assert.match(doc, /`finished`/);
+        assert.match(doc, /`blocked`/);
+        assert.match(doc, /`failed`/);
+        assert.match(doc, /`userinterlude`/);
+        assert.match(doc, /`askuserQuestion`/);
+    });
+    it('keeps cancelled internal-only and preserves blocked_on_user as a legacy compatibility value', () => {
+        const doc = loadSurface('docs/contracts/explicit-terminal-stop-model.md');
+        assert.match(doc, /`blocked_on_user` \| compatibility-only user-wait signal/i);
+        assert.match(doc, /`cancelled`, `canceled`, `abort`, `aborted` \| internal legacy\/admin stop compatibility only/i);
+        assert.match(doc, /It is \*\*not\*\* a canonical user-facing terminal lifecycle outcome/i);
+    });
+    it('distinguishes userinterlude from askuserQuestion', () => {
+        const doc = loadSurface('docs/contracts/explicit-terminal-stop-model.md');
+        assert.match(doc, /`userinterlude` \| The user intentionally interrupted or paused the run\./i);
+        assert.match(doc, /`askuserQuestion` \| OMX must ask the user a blocking question before safe progress can continue\./i);
+        assert.match(doc, /should normally be backed by `omx question`/i);
+    });
+    it('forbids optional terminal handoff softeners in active workflow outputs', () => {
+        const doc = loadSurface('docs/contracts/explicit-terminal-stop-model.md');
+        assert.match(doc, /the handoff should be explicit and structured/i);
+        assert.match(doc, /If you want, I can/i);
+        assert.match(doc, /Would you like me to continue\?/i);
+        assert.match(doc, /If you'd like, I can/i);
+    });
+    it('documents canonical-field precedence over legacy compatibility fields', () => {
+        const doc = loadSurface('docs/contracts/explicit-terminal-stop-model.md');
+        assert.match(doc, /a dedicated canonical lifecycle field such as `lifecycle_outcome`/i);
+        assert.match(doc, /the canonical lifecycle field wins/i);
+    });
+});
+//# sourceMappingURL=explicit-terminal-stop-model-docs-contract.test.js.map

package/dist/hooks/__tests__/explicit-terminal-stop-model-docs-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explicit-terminal-stop-model-docs-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/explicit-terminal-stop-model-docs-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,WAAW,CAAC,gDAAgD,CAAC,CAAC;QAE1E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6FAA6F,EAAE,GAAG,EAAE;QACrG,MAAM,GAAG,GAAG,WAAW,CAAC,gDAAgD,CAAC,CAAC;QAE1E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,2DAA2D,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gGAAgG,CAAC,CAAC;QACpH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,uEAAuE,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,WAAW,CAAC,gDAAgD,CAAC,CAAC;QAE1E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,4EAA4E,CAAC,CAAC;QAChG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,qGAAqG,CAAC,CAAC;QACzH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,8CAA8C,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,GAAG,GAAG,WAAW,CAAC,gDAAgD,CAAC,CAAC;QAE1E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,gDAAgD,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,uBAAuB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,GAAG,GAAG,WAAW,CAAC,gDAAgD,CAAC,CAAC;QAE1E,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oEAAoE,CAAC,CAAC;QACxF,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,qCAAqC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hooks/__tests__/explore-sparkshell-guidance-contract.test.js

@@ -1,6 +1,6 @@
 import { describe, it } from 'node:test';
 import assert from 'node:assert/strict';
-import { loadSurface } from './prompt-guidance-test-helpers.js';
+import { listTrackedAgentSurfaces, loadSurface } from './prompt-guidance-test-helpers.js';
 function expectPatterns(path, patterns) {
     const content = loadSurface(path);
     for (const pattern of patterns) {
@@ -19,7 +19,7 @@ describe('explore + sparkshell guidance contract', () => {
             /explicit opt-?in/i,
             /When to use what/i,
         ];
-        for (const surface of ['AGENTS.md', 'templates/AGENTS.md']) {
+        for (const surface of listTrackedAgentSurfaces()) {
             expectPatterns(surface, patterns);
         }
     });

package/dist/hooks/__tests__/explore-sparkshell-guidance-contract.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"explore-sparkshell-guidance-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/explore-sparkshell-guidance-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAEhE,SAAS,cAAc,CAAC,IAAY,EAAE,QAAkB;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,8BAA8B,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,sGAAsG,EAAE,GAAG,EAAE;QAC9G,MAAM,QAAQ,GAAG;YACf,sBAAsB;YACtB,2DAA2D;YAC3D,WAAW;YACX,gFAAgF;YAChF,0CAA0C;YAC1C,6BAA6B;YAC7B,mBAAmB;YACnB,mBAAmB;SACpB,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,EAAE,CAAC;YAC3D,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,cAAc,CAAC,oBAAoB,EAAE;YACnC,sBAAsB;YACtB,0BAA0B;YAC1B,sCAAsC;SACvC,CAAC,CAAC;QAEH,cAAc,CAAC,4BAA4B,EAAE;YAC3C,2CAA2C;YAC3C,+BAA+B;YAC/B,sCAAsC;SACvC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,KAAK,MAAM,OAAO,IAAI;YACpB,oBAAoB;YACpB,qBAAqB;YACrB,0BAA0B;YAC1B,gCAAgC;YAChC,sBAAsB;YACtB,yBAAyB;YACzB,uBAAuB;YACvB,sBAAsB;SACvB,EAAE,CAAC;YACF,cAAc,CAAC,OAAO,EAAE;gBACtB,sBAAsB;gBACtB,+CAA+C;gBAC/C,oFAAoF;aACrF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,cAAc,CAAC,sBAAsB,EAAE;YACrC,wBAAwB;YACxB,oDAAoD;YACpD,mBAAmB;SACpB,CAAC,CAAC;QAEH,cAAc,CAAC,sBAAsB,EAAE;YACrC,6BAA6B;YAC7B,mBAAmB;YACnB,mCAAmC;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"explore-sparkshell-guidance-contract.test.js","sourceRoot":"","sources":["../../../src/hooks/__tests__/explore-sparkshell-guidance-contract.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAE1F,SAAS,cAAc,CAAC,IAAY,EAAE,QAAkB;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,8BAA8B,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,sGAAsG,EAAE,GAAG,EAAE;QAC9G,MAAM,QAAQ,GAAG;YACf,sBAAsB;YACtB,2DAA2D;YAC3D,WAAW;YACX,gFAAgF;YAChF,0CAA0C;YAC1C,6BAA6B;YAC7B,mBAAmB;YACnB,mBAAmB;SACpB,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,wBAAwB,EAAE,EAAE,CAAC;YACjD,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,cAAc,CAAC,oBAAoB,EAAE;YACnC,sBAAsB;YACtB,0BAA0B;YAC1B,sCAAsC;SACvC,CAAC,CAAC;QAEH,cAAc,CAAC,4BAA4B,EAAE;YAC3C,2CAA2C;YAC3C,+BAA+B;YAC/B,sCAAsC;SACvC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,KAAK,MAAM,OAAO,IAAI;YACpB,oBAAoB;YACpB,qBAAqB;YACrB,0BAA0B;YAC1B,gCAAgC;YAChC,sBAAsB;YACtB,yBAAyB;YACzB,uBAAuB;YACvB,sBAAsB;SACvB,EAAE,CAAC;YACF,cAAc,CAAC,OAAO,EAAE;gBACtB,sBAAsB;gBACtB,+CAA+C;gBAC/C,oFAAoF;aACrF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,cAAc,CAAC,sBAAsB,EAAE;YACrC,wBAAwB;YACxB,oDAAoD;YACpD,mBAAmB;SACpB,CAAC,CAAC;QAEH,cAAc,CAAC,sBAAsB,EAAE;YACrC,6BAA6B;YAC7B,mBAAmB;YACnB,mCAAmC;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}