simt-dev 0.7.1 → 0.8.0

package/harnesses/gemini.json

@@ -0,0 +1,122 @@
+{
+  "id": "gemini",
+  "loaderOrder": 6,
+  "loader": {
+    "id": "gemini",
+    "label": "Gemini CLI",
+    "readers": "Gemini CLI (google-gemini/gemini-cli)",
+    "surface": null,
+    "start": [
+      {
+        "scope": "project",
+        "path": "GEMINI.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "Gemini CLI context docs (docs/cli/gemini-md/): GEMINI.md is collected from the working directory upward through parent directories until the first directory holding a boundary marker (.git by default) or home"
+      },
+      {
+        "scope": "user",
+        "path": "~/.gemini/GEMINI.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "Gemini CLI context docs: the user-global ~/.gemini/GEMINI.md opens the concatenation, before any project file"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": "the context file under another name — settings.json context.fileName, a string or an array",
+        "atStart": true,
+        "why": "Gemini CLI configuration docs: context.fileName renames the context file (a string or an array), so an installation listing AGENTS.md there reads AGENTS.md as its GEMINI.md"
+      },
+      {
+        "what": "GEMINI.md (or the renamed context file) in subdirectories below the working directory",
+        "atStart": false,
+        "why": "Gemini CLI context docs: directories a tool touches are scanned for a context file up to a trusted root, bounded by context.discoveryMaxDirs (200) - not at session start"
+      }
+    ],
+    "order": "user-global ~/.gemini/GEMINI.md first, then the project chain general to specific - project-root side first (upward traversal stops at the first directory holding a boundary marker, .git by default) down through each directory to the working directory - then just-in-time files a tool touch discovered; the whole result is one concatenation with origin separators",
+    "cap": null,
+    "capNote": "no byte cap is published for the merged Gemini CLI context (checked 2026-10-26)",
+    "imports": {
+      "syntax": "@path",
+      "depth": 5,
+      "why": "Gemini CLI context docs: @path imports resolve relative or absolute to a maximum depth of 5, with cycles prevented by skipping files already on the stack"
+    },
+    "nested": "general to specific, all loaded — unlike Codex, every context file on the walk contributes; a nearer file cannot hide a parent one, it just concatenates after it; subdirectory files wait for a tool touch",
+    "skills": [],
+    "skillsNote": "no project skill directory is documented for Gemini CLI; extensions are the distribution mechanism, and they are tooling not context",
+    "hooks": {
+      "path": ".gemini/settings.json",
+      "verified": "Gemini CLI hooks reference (geminicli.com/docs/hooks/reference/, read 2026-10-26): a project .gemini/settings.json carries a top-level hooks object whose events are arrays of {matcher, hooks:[{type:\"command\",command,timeout? (milliseconds)}]} — the same shape Claude and Codex use; BeforeTool denies with {decision:\"deny\",reason}, BeforeAgent and AfterTool inject via hookSpecificOutput.additionalContext"
+    },
+    "agents": {
+      "dir": ".gemini/agents",
+      "ext": ".md",
+      "verified": "Gemini CLI subagents docs (geminicli.com/docs/core/subagents, read 2026-10-30): project subagents are markdown files with name and description frontmatter under .gemini/agents/"
+    },
+    "mcp": {
+      "path": ".gemini/settings.json",
+      "key": "mcpServers",
+      "verified": "Gemini CLI configuration docs (docs/reference/configuration/, read 2026-10-26): a project .gemini/settings.json (a user ~/.gemini/settings.json merged behind it, objects merged key by key) carries a top-level mcpServers object whose entries name a command, a url or an httpUrl"
+    },
+    "verified": "Gemini CLI context and configuration docs (geminicli.com/docs/cli/gemini-md/ and docs/reference/configuration/, read 2026-10-26) — settings live at project .gemini/settings.json and user ~/.gemini/settings.json, merged for objects; the context is user ~/.gemini/GEMINI.md plus the context file (GEMINI.md unless context.fileName renames it, an array is allowed) from the working directory upward through parents to the first .git or home, with @path imports to depth 5; server registration is the mcpServers object in those same settings files; no byte cap is published",
+    "note": "The configuration reference this table once recorded as 404ing is live again as of 2026-10-26, which is why the row is full instead of thin. What still shapes a byte count is the pair of absences the docs confirm rather than deny: no cap, and no promise that AGENTS.md is read at all — context.fileName decides that, and it may name anything."
+  },
+  "hooks": {
+    "id": "gemini",
+    "event": "BeforeTool",
+    "matcher": "run_shell_command|write_file|replace",
+    "timeout": 10000,
+    "denyExit": 0,
+    "verified": "geminicli.com/docs/hooks/reference/, read 2026-10-26",
+    "prompt": {
+      "event": "BeforeAgent",
+      "verified": "geminicli.com/docs/hooks/reference/, read 2026-10-26",
+      "delivery": {
+        "hookSpecificOutput": {
+          "additionalContext": "__SIMT_TEXT__"
+        }
+      }
+    },
+    "post": {
+      "event": "AfterTool",
+      "verified": "geminicli.com/docs/hooks/reference/, read 2026-10-26",
+      "delivery": {
+        "hookSpecificOutput": {
+          "additionalContext": "__SIMT_TEXT__"
+        }
+      }
+    },
+    "deny": {
+      "decision": "deny",
+      "reason": "__SIMT_TEXT__"
+    }
+  },
+  "payload": {
+    "toolKey": "tool_name",
+    "inputKey": "tool_input",
+    "shellTools": [
+      "run_shell_command"
+    ],
+    "commandKey": "command",
+    "writeTools": [
+      "write_file",
+      "replace"
+    ],
+    "pathKeys": [
+      "file_path"
+    ],
+    "rootKeys": [
+      [
+        "cwd"
+      ]
+    ]
+  },
+  "pluginOrder": 2,
+  "plugin": {
+    "rootVar": "extensionPath",
+    "projectVar": null,
+    "hooksPath": "hooks/hooks.json",
+    "runtimeDir": "."
+  }
+}

package/harnesses/opencode.json

@@ -0,0 +1,173 @@
+{
+  "id": "opencode",
+  "loaderOrder": 1,
+  "surfaceOrder": 1,
+  "surface": {
+    "id": "opencode",
+    "label": "opencode (AGENTS.md + .agents/skills)",
+    "readers": "OpenCode v2, and AGENTS.md is also read natively by Codex, Cursor, Windsurf, Zed, Amp, Jules, Copilot CLI and the DeepSeek harness; Claude Code falls back to it, Antigravity and Gemini CLI accept GEMINI.md as an equal name",
+    "primary": "AGENTS.md",
+    "kind": "region",
+    "rule": null,
+    "foldRules": true,
+    "readsAgentsMd": "all",
+    "configDirs": [
+      ".opencode"
+    ],
+    "skills": ".agents/skills",
+    "documentedSkillsPaths": [
+      ".opencode/skills",
+      ".claude/skills",
+      ".agents/skills"
+    ],
+    "readLimits": [
+      {
+        "reader": "Codex",
+        "bytes": 32768,
+        "verified": "Codex project_doc_max_bytes defaults to 32 KiB"
+      }
+    ],
+    "verified": "OpenCode v2 instructions and skills docs (opencode.ai/v2/docs, read 2026-10-14) — AGENTS.md only, combined from the workspace up to the project root; CLAUDE.md is not a fallback; skills at .opencode/skills/, .claude/skills/ and .agents/skills/<name>/SKILL.md, with the model shown name and description",
+    "note": ".agents/skills is one of the three skill locations opencode documents, so the same directory serves the standard surface without a symlink."
+  },
+  "loader": {
+    "id": "opencode",
+    "label": "OpenCode v2",
+    "readers": "OpenCode v2",
+    "surface": "opencode",
+    "start": [
+      {
+        "scope": "project",
+        "path": "AGENTS.md",
+        "tree": "chain",
+        "atStart": true,
+        "why": "OpenCode v2 instructions docs: every AGENTS.md from the workspace directory up to the project root is loaded and combined; V2 recognizes AGENTS.md only and does not fall back to CLAUDE.md"
+      },
+      {
+        "scope": "user",
+        "path": "~/.config/opencode/AGENTS.md",
+        "tree": "single",
+        "atStart": true,
+        "why": "OpenCode v2 instructions docs: the global file is loaded first, before the project chain"
+      },
+      {
+        "scope": "project",
+        "path": ".claude/skills/{name}/SKILL.md",
+        "tree": "nested",
+        "dir": ".claude/skills",
+        "suffix": "/SKILL.md",
+        "atStart": true,
+        "metadata": true,
+        "why": "OpenCode v2 skills docs: .claude/skills is a project compatibility source, registered before .agents/skills"
+      },
+      {
+        "scope": "project",
+        "path": ".agents/skills/{name}/SKILL.md",
+        "tree": "nested",
+        "dir": ".agents/skills",
+        "suffix": "/SKILL.md",
+        "atStart": true,
+        "metadata": true,
+        "why": "OpenCode v2 skills docs: .agents/skills is a project compatibility source; the model is shown the id, name and description, not the body"
+      },
+      {
+        "scope": "project",
+        "path": ".opencode/skills/{name}/SKILL.md",
+        "tree": "nested",
+        "dir": ".opencode/skills",
+        "suffix": "/SKILL.md",
+        "atStart": true,
+        "metadata": true,
+        "why": "OpenCode v2 skills docs: .opencode/skills is the project source and outranks .agents/skills and .claude/skills for the same id"
+      }
+    ],
+    "alsoReads": [
+      {
+        "what": "AGENTS.md below the workspace",
+        "atStart": false,
+        "why": "OpenCode v2 instructions docs: instruction files below the workspace load when the agent reads or lists that area, not at session start"
+      },
+      {
+        "what": "opencode.json `instructions` array",
+        "atStart": false,
+        "why": "OpenCode v2 instructions docs: the config schema accepts an instructions array, but V2 does not resolve its files, globs or URLs"
+      }
+    ],
+    "order": "global ~/.config/opencode/AGENTS.md, then project AGENTS.md files from the workspace directory up to the project root (nearest first); files are combined, not overridden",
+    "cap": null,
+    "capNote": "no byte cap published for AGENTS.md; V2 accepts an instructions array and does not load it, so there is no fetch timeout to apply",
+    "imports": {
+      "syntax": null,
+      "depth": 0,
+      "why": "OpenCode v2 instructions docs: an AGENTS.md reference to another file is not an include; V2 loads AGENTS.md files by discovery, not by @path expansion"
+    },
+    "nested": "cumulative up to the project root at session start; files below the workspace load when that area is read",
+    "skills": [
+      ".agents/skills",
+      ".opencode/skills",
+      ".claude/skills"
+    ],
+    "hooks": {
+      "path": ".opencode/plugins/simt-dev.js",
+      "verified": "OpenCode v2 plugins docs: direct .ts and .js files and immediate plugin packages are loaded from every discovered .opencode/plugins/ directory, and the plugins array in opencode.json(c)"
+    },
+    "agents": {
+      "dir": ".opencode/agents",
+      "ext": ".md",
+      "verified": "OpenCode v2 agents docs (opencode.ai/v2/docs/agents, read 2026-10-30): subagents are markdown files with a description frontmatter under .opencode/agents/"
+    },
+    "mcp": {
+      "path": "opencode.json",
+      "key": "mcp.servers",
+      "verified": "OpenCode v2 MCP servers docs (read 2026-10-14): servers are named under mcp.servers; V2 does not place server names directly under mcp"
+    },
+    "verified": "OpenCode v2 instructions, skills, plugins and MCP docs (opencode.ai/v2/docs, read 2026-10-14) — V2 loads AGENTS.md only, combining the global file with every project AGENTS.md from the workspace up to the project root; CLAUDE.md is not a fallback; the instructions array is accepted and not loaded; skills advertise name and description from .opencode/skills, .claude/skills and .agents/skills",
+    "note": "This row is OpenCode v2. V1 read CLAUDE.md when AGENTS.md was absent and loaded the instructions array; V2 does neither, so a meter that still did would bill bytes this reader does not pay."
+  },
+  "hooks": {
+    "id": "opencode",
+    "event": "execute.before",
+    "matcher": "shell|write|edit",
+    "file": true,
+    "denyExit": 2,
+    "verified": "opencode.ai/v2/docs/build/plugins/server, read 2026-10-29",
+    "prompt": {
+      "event": "prompt",
+      "verified": "opencode.ai/v2/docs/build/plugins/server, read 2026-10-29",
+      "delivery": {
+        "text": "__SIMT_TEXT__"
+      }
+    },
+    "post": null,
+    "deny": {
+      "reason": "__SIMT_TEXT__"
+    }
+  },
+  "payload": {
+    "toolKey": "tool",
+    "inputKey": "input",
+    "shellTools": [
+      "shell"
+    ],
+    "commandKey": "command",
+    "writeTools": [
+      "write",
+      "edit"
+    ],
+    "pathKeys": [
+      "path"
+    ],
+    "rootKeys": [
+      [
+        "cwd"
+      ]
+    ]
+  },
+  "pluginOrder": 4,
+  "plugin": {
+    "rootVar": null,
+    "projectVar": null,
+    "hooksPath": "server.js",
+    "runtimeDir": "."
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simt-dev",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "An intelligence amplifier for AI coding agents: rules and dual gates adopted by one command, plus local retrieval, task briefs, benches and repo memory — deterministic by default, with local-model adapters that propose and never select.",
   "license": "Apache-2.0",
   "author": "Said Elimam",
@@ -27,6 +27,8 @@
     "templates",
     "agents",
     "skills",
+    "ecosystems",
+    "harnesses",
     "docs/decisions",
     "CHANGELOG.md"
   ],

package/rules/mdc/intake-questions.mdc

@@ -41,6 +41,14 @@ the list to reach it, and never split one decision into several questions to fit
 - If that is not available, present numbered choices with `(recommended)` on the first option.
 - Do not ask operational or procedural choices; apply the best documented option.
 
+## Small work (no plan file)
+
+When the whole of the work is small — fewer than three slices — do not create a plan file.
+Plan it and implement it directly, in a single slice: state the slice and its acceptance
+checks, resolve any material decisions, and build it. The `{{plansGlob}}` tracker table and
+its `NNNN-slug.md` deliverable are for work that spans multiple slices; a single slice has
+nothing to track. The slice-commit procedure still applies to the one commit it produces.
+
 ## Required First Turn
 
 1. State the smallest independently valuable slice, the owning repo, the active plan

package/src/advice/advice.mjs

@@ -21,8 +21,9 @@
 // records or a prices table price the tokens, total tokens otherwise. Ordering by a number
 // that does not exist for any run would be nondeterminism, not economics.
 import { classifyTask } from '../brief/kind.mjs';
-import { computeRunCost, isRunResolved, loadPrices, loadRunRecords } from '../bench/report.mjs';
-import { loadTasks } from '../bench/tasks.mjs';
+import { computeRunCost, isRunResolved, loadPrices } from '../measure/metrics.mjs';
+import { loadRunRecords } from '../measure/records.mjs';
+import { loadTasks } from '../measure/tasks.mjs';
 import { CONFIG_DIR } from '../name.mjs';
 
 /**

package/src/agenthooks/render.mjs

@@ -48,6 +48,7 @@
 
 import { CLI } from '../name.mjs';
 import { LOADERS } from '../projection/loaders.mjs';
+import { harnessHooks, harnessPayloads } from '../harness/records.mjs';
 import { renderOpencodePlugin } from './opencode.mjs';
 import { EVENTS } from './policy.mjs';
 import { AGENT_HOOK_SHIM } from './shim.mjs';
@@ -183,188 +184,93 @@ function patchFiles(text) {
   return files.filter((f) => f.path !== '');
 }
 
-const ADAPTERS = {
-  claude: {
-    id: 'claude',
-    event: 'PreToolUse',
-    matcher: 'Bash|Edit|Write|MultiEdit|NotebookEdit',
-    denyExit: 2,
-    verified: 'docs.claude.com/en/docs/claude-code/hooks, read 2026-10-16',
-    root: (p) => p.cwd,
-    extract: (p) => ({
-      command: p.tool_name === 'Bash' ? (p.tool_input?.command ?? null) : null,
-      // NotebookEdit spells its target `notebook_path`, not `file_path`: a key list
-      // that misses it is a lease the notebook can walk straight through (review
-      // 0003 Q16). Edit details travel with the path so the generated-region
-      // check can tell an edit outside the region from one inside it (Q17).
-      writes: ['Edit', 'Write', 'MultiEdit'].includes(p.tool_name)
-        ? [writeOf(p.tool_input?.file_path, p.tool_input)].filter(Boolean)
-        : p.tool_name === 'NotebookEdit'
-          ? [writeOf(p.tool_input?.notebook_path, p.tool_input)].filter(Boolean)
-          : [],
-    }),
-    deny: (message) => ({
-      hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: message },
-    }),
-    // The delivery door. `additionalContext` is documented for this event and is
-    // wrapped into the conversation at the point the hook fired, which is why the
-    // packet goes here rather than into a system prompt: the cached prefix survives.
-    prompt: {
-      event: 'UserPromptSubmit',
-      verified: 'code.claude.com/docs/en/hooks, read 2026-10-19',
-      context: (text) => ({ hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext: text } }),
-    },
-    post: {
-      event: 'PostToolUse',
-      matcher: 'Bash',
-      verified: 'code.claude.com/docs/en/hooks, read 2026-10-19',
-      context: (text) => ({ hookSpecificOutput: { hookEventName: 'PostToolUse', additionalContext: text } }),
-    },
-  },
-  codex: {
-    id: 'codex',
-    event: 'PreToolUse',
-    matcher: 'Bash|apply_patch',
-    denyExit: 2,
-    verified: 'developers.openai.com/codex/hooks, read 2026-10-16',
-    // Codex is the one harness that will not run a hook until a person has approved the
-    // exact definition, keyed by its hash — so an install that does not say this leaves
-    // the repository with a hook that never fires and no way to tell why.
-    trust: 'Codex skips a hook nobody has trusted: review it with /hooks, or the entry stays inert.',
-    root: (p) => p.cwd,
-    extract: (p) => ({
-      command: p.tool_name === 'Bash' ? (p.tool_input?.command ?? null) : null,
-      // apply_patch carries its targets inside the patch text, one header line per file;
-      // a move names its destination on the `+++` line after `*** Move File:`, and the
-      // destination is the file the move writes (review 0003 Q16).
-      writes:
-        p.tool_name === 'apply_patch'
-          ? patchWrites(String(p.tool_input?.command ?? ''))
-          : [], // entries carry {path, patch} so the region check maps hunks (Q17)
-    }),
-    deny: (message) => ({
-      hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: message },
-    }),
-    prompt: {
-      event: 'UserPromptSubmit',
-      verified: 'developers.openai.com/codex/hooks, read 2026-10-19',
-      context: (text) => ({ hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext: text } }),
-    },
-    post: {
-      event: 'PostToolUse',
-      matcher: 'Bash',
-      verified: 'developers.openai.com/codex/hooks, read 2026-10-19',
-      context: (text) => ({ hookSpecificOutput: { hookEventName: 'PostToolUse', additionalContext: text } }),
-    },
-  },
-  cursor: {
-    id: 'cursor',
-    event: 'preToolUse',
-    matcher: 'Shell|Write|Edit',
-    denyExit: 2,
-    verified: 'cursor.com/docs/agent/hooks, read 2026-10-16',
-    root: (p) => p.working_directory ?? p.cwd,
-    extract: (p) => ({
-      command: p.tool_name === 'Shell' ? (p.tool_input?.command ?? null) : null,
-      writes: ['Write', 'Edit'].includes(p.tool_name)
-        ? [writeOf(p.tool_input?.file_path ?? p.tool_input?.path, p.tool_input)].filter(Boolean)
-        : [],
-    }),
-    deny: (message) => ({ permission: 'deny', user_message: message, agent_message: message }),
-    // beforeSubmitPrompt is documented as continue/block and nothing else, so there is no
-    // key to deliver a packet in. Writing the entry anyway would put a command that reads
-    // a repository on the path of every prompt a person types, to say nothing.
-    prompt: null,
-    post: null,
-  },
-  antigravity: {
-    id: 'antigravity',
-    event: 'PreToolUse',
-    matcher: 'run_command|write_to_file|replace_file_content|multi_replace_file_content',
-    // The page documents the decision JSON and not an exit code, so the denial travels
-    // in the JSON only: a non-zero exit whose meaning the vendor has not stated is not
-    // a block, it is a guess that happens to be loud.
-    denyExit: 0,
-    verified: 'antigravity.google/docs/hooks, read 2026-10-16',
-    root: (p) => p.workspacePaths?.[0] ?? p.cwd,
-    extract: (p) => {
-      const call = p.toolCall ?? {};
-      const args = call.args ?? {};
-      return {
-        command: call.name === 'run_command' ? (args.CommandLine ?? null) : null,
-        writes: ['write_to_file', 'replace_file_content', 'multi_replace_file_content'].includes(call.name)
-          ? [writeOf(args.TargetFile, args)].filter(Boolean)
-          : [], // CodeContent/old/new travel with the path for the region check (Q17)
-      };
-    },
-    deny: (message) => ({ decision: 'deny', reason: message }),
-    // No prompt event is documented for this harness's hooks file, and a guessed event
-    // name is a hook that never fires while its config says it does.
-    prompt: null,
-    post: null,
-  },
-  gemini: {
-    id: 'gemini',
-    event: 'BeforeTool',
-    matcher: 'run_shell_command|write_file|replace',
-    // The vendor's timeout unit is milliseconds (default 60000), not the seconds every
-    // other row uses; a bare 10 here would be a ten-millisecond budget, which is a hook
-    // that never finishes. The row carries its own value so the shared constant stays
-    // honest for the four vendors that measure in seconds.
-    timeout: 10000,
-    // The reference documents the decision JSON and an exit-2 system block; the denial
-    // travels in the JSON, as antigravity does.
-    denyExit: 0,
-    verified: 'geminicli.com/docs/hooks/reference/, read 2026-10-26',
-    root: (p) => p.cwd,
-    extract: (p) => ({
-      command: p.tool_name === 'run_shell_command' ? (p.tool_input?.command ?? null) : null,
-      writes: ['write_file', 'replace'].includes(p.tool_name)
-        ? [writeOf(p.tool_input?.file_path, p.tool_input)].filter(Boolean)
+// The payload a hook reads: where the tool name and its input sit, and the keys that
+// name a command and a file. A record cannot carry a function, so the engine reads the
+// record's keys and applies them: a harness that puts a field somewhere new is a new
+// record, not a new branch here (Q71).
+function pick(obj, keys) {
+  if (!obj || typeof obj !== 'object') return null;
+  for (const k of keys) {
+    const v = obj[k];
+    if (v !== undefined && v !== null) return v;
+  }
+  return null;
+}
+
+function extractOf(spec) {
+  return (p) => {
+    const payload = p ?? {};
+    // antigravity nests the call under `toolCall`; the rest name the tool at the top
+    // level. `toolNameKey` is present only on the nested shape, so its presence is
+    // the detector.
+    const nested = spec.toolNameKey !== undefined;
+    const call = nested ? (payload[spec.toolKey] ?? {}) : null;
+    const toolName = nested ? call[spec.toolNameKey] : payload[spec.toolKey];
+    const input = nested ? (call[spec.inputSubKey] ?? {}) : (payload[spec.inputKey] ?? {});
+    return {
+      command: (spec.shellTools ?? []).includes(toolName) ? (input[spec.commandKey] ?? null) : null,
+      // apply_patch carries its targets inside the patch text (writesFrom: "patch");
+      // every other write tool names its file through the path keys.
+      writes: (spec.writeTools ?? []).includes(toolName)
+        ? spec.writesFrom === 'patch'
+          ? patchWrites(String(input[spec.commandKey] ?? ''))
+          : [writeOf(pick(input, spec.pathOverrides?.[toolName] ?? spec.pathKeys), input)].filter(Boolean)
         : [],
-    }),
-    deny: (message) => ({ decision: 'deny', reason: message }),
-    // BeforeAgent appends text to the prompt for this turn only — the same lifetime as a
-    // brief. The documented output has no hookEventName field, unlike Claude's.
-    prompt: {
-      event: 'BeforeAgent',
-      verified: 'geminicli.com/docs/hooks/reference/, read 2026-10-26',
-      context: (text) => ({ hookSpecificOutput: { additionalContext: text } }),
-    },
-    // AfterTool appends to the tool result; its input carries tool_response, which is
-    // what the lesson recall reads.
-    post: {
-      event: 'AfterTool',
-      verified: 'geminicli.com/docs/hooks/reference/, read 2026-10-26',
-      context: (text) => ({ hookSpecificOutput: { additionalContext: text } }),
-    },
-  },
-  opencode: {
-    id: 'opencode',
-    event: 'execute.before',
-    matcher: 'shell|write|edit',
-    // The plugin is a file the tool owns whole, not a config entry to merge:
-    // `file` routes `rendered` and `hookDocument` to its source (opencode.mjs).
-    file: true,
-    // A thrown error is the block; exit 2 is how the entry point signals it,
-    // and the reason the plugin throws is what `deny` prints.
-    denyExit: 2,
-    verified: 'opencode.ai/v2/docs/build/plugins/server, read 2026-10-29',
-    root: (p) => p.cwd,
-    extract: (p) => ({
-      command: p.tool === 'shell' ? (p.input?.command ?? null) : null,
-      writes: ['write', 'edit'].includes(p.tool) ? [writeOf(p.input?.path, p.input)].filter(Boolean) : [],
-    }),
-    deny: (message) => ({ reason: message }),
-    // session.hook('prompt') admits the prompt; the packet goes in front of it.
-    prompt: {
-      event: 'prompt',
-      verified: 'opencode.ai/v2/docs/build/plugins/server, read 2026-10-29',
-      context: (text) => ({ text }),
+    };
+  };
+}
+
+// The record's `rootKeys`: a list of accessor paths, first non-null wins. The caller
+// applies its `?? process.cwd()` floor (factsFrom).
+function rootOf(spec) {
+  return (p) => {
+    for (const path of spec.rootKeys ?? []) {
+      let v = p;
+      for (const seg of path) v = v?.[seg];
+      if (v !== undefined && v !== null) return v;
+    }
+    return null;
+  };
+}
+
+// The `__SIMT_TEXT__` sentinel in a record's deny and delivery templates: the text a
+// decision or a delivery carries is substituted for it, and JSON.stringify downstream
+// escapes whatever it carries.
+const TEXT = '__SIMT_TEXT__';
+
+function applyText(value, text) {
+  if (typeof value === 'string') return value === TEXT ? text : value;
+  if (Array.isArray(value)) return value.map((v) => applyText(v, text));
+  if (value && typeof value === 'object') {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) out[k] = applyText(v, text);
+    return out;
+  }
+  return value;
+}
+
+// The hooks dialect per harness, as records (Q71): the data a config document and a
+// decision are shaped by, with the page each shape was read from. What a record cannot
+// carry is attached here — `root` and `extract` read the record's payload keys, and
+// `deny`, `prompt.context` and `post.context` apply its templates. Module-internal on
+// purpose: `adapters()` and `adapter()` are the only doors in, and both check the
+// reader table, so an id with no hooks file is no adapter.
+const HOOKS = harnessHooks();
+const PAYLOADS = harnessPayloads();
+
+const ADAPTERS = Object.fromEntries(
+  Object.entries(HOOKS).map(([id, h]) => [
+    id,
+    {
+      ...h,
+      root: rootOf(PAYLOADS[id]),
+      extract: extractOf(PAYLOADS[id]),
+      deny: (message) => applyText(h.deny, message),
+      ...(h.prompt ? { prompt: { ...h.prompt, context: (text) => applyText(h.prompt.delivery, text) } } : {}),
+      ...(h.post ? { post: { ...h.post, context: (text) => applyText(h.post.delivery, text) } } : {}),
     },
-    post: null,
-  },
-};
+  ]),
+);
 
 /** The six adapters, in the order the reader table lists them. */
 export function adapters() {