@event4u/agent-config 14.2.0 → 14.5.0

package/src/scripts/decision_memo.ts

@@ -0,0 +1,325 @@
+/**
+ * decision_memo — the decision-memo channel (UOTL Phase 4.3, sequenced by
+ * road-to-long-horizon-execution Phase 2.2).
+ *
+ * ## What this is for
+ *
+ * A question the agent resolves without contacting the user is only
+ * legitimate if the resolution is REVIEWABLE afterwards. Before this, a
+ * medium-impact resolution left no trace at all: the run either halted (a
+ * contact) or decided silently (no record). Neither is what the ladder wants
+ * between those two — the memo is.
+ *
+ * One file per resolution under
+ * `agents/runtime/state/decisions/<run>/NNN.md`, monotonic index per run.
+ * Local-only: the whole `agents/runtime/` tree is gitignored, so a memo never
+ * reaches a commit unless a human copies it out.
+ *
+ * ## Why a writer script rather than "the agent writes a markdown file"
+ *
+ * Two properties a prose instruction cannot give:
+ *
+ * - **The shape cannot drift.** Every memo carries the same five fields the
+ *   roadmap names — question, chosen option, reasoning, resolver, confidence —
+ *   because the writer refuses a memo missing any of them. A directory of
+ *   free-form notes is not a channel, it is a folder.
+ * - **The index is monotonic and gap-free per run**, so "003 exists but 002
+ *   does not" is impossible and a reader can tell a pruned memo from an
+ *   unwritten one.
+ *
+ * ## What it deliberately does NOT do
+ *
+ * It does not decide anything, and it does not gate. A memo is a record of a
+ * resolution that already happened; making the writer refuse a resolution
+ * would put a decision gate in an observability surface, which is the shape
+ * `roadmap-progress` and the interruption ledger both stay clear of.
+ *
+ * It also carries no locked-class check, and that is not an omission to fix
+ * here: `high_impact` and `user_required` are refused at the SCHEMA
+ * (`config.ts::_build_decision_resolution`), before any model sees a route.
+ * A second check in the writer would read as the enforcement point and put
+ * the real one out of mind — the schema is the gate, this is the ledger.
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+export const DECISIONS_DIR_REL = path.join('agents', 'runtime', 'state', 'decisions');
+
+/** The five fields the roadmap names, and nothing optional among them. */
+export interface DecisionMemo {
+    /** The question as it was actually open — not a summary of the answer. */
+    question: string;
+    /** The option taken, stated so a reader can see what was NOT taken. */
+    chosen: string;
+    /** Why. The load-bearing field: without it the memo is a log line. */
+    reasoning: string;
+    /** Which rung resolved it — `agent`, `second-model:<provider>`, `council`. */
+    resolver: string;
+    /** Self-assessed, `high` | `medium` | `low`. Never a number. */
+    confidence: 'high' | 'medium' | 'low';
+}
+
+const CONFIDENCE: ReadonlySet<string> = new Set(['high', 'medium', 'low']);
+
+/**
+ * A run id has to be a filename component. `safe` here is deliberately
+ * narrow rather than a sanitiser: a run id that needs escaping is a caller
+ * bug, and silently rewriting it would put two runs in one directory.
+ */
+export function isSafeRunId(runId: string): boolean {
+    return /^[A-Za-z0-9_-]{1,64}$/.test(runId);
+}
+
+export function runDir(repoRoot: string, runId: string): string {
+    return path.join(repoRoot, DECISIONS_DIR_REL, runId);
+}
+
+/**
+ * The next index for this run — one past the highest `NNN.md` present.
+ *
+ * Reads the directory rather than a counter file: a counter that drifts from
+ * the directory is a second source of truth, and the directory is the one a
+ * human reads.
+ */
+export function nextIndex(dir: string): number {
+    let entries: string[];
+    try {
+        entries = fs.readdirSync(dir);
+    } catch {
+        return 1;
+    }
+    let max = 0;
+    for (const name of entries) {
+        const m = /^(\d{3})\.md$/.exec(name);
+        if (m === null) continue;
+        const n = Number.parseInt(m[1] as string, 10);
+        if (Number.isFinite(n) && n > max) max = n;
+    }
+    return max + 1;
+}
+
+/** Refusal reasons, as a list so a caller can report all of them at once. */
+export function validate(memo: Partial<DecisionMemo>): string[] {
+    const problems: string[] = [];
+    for (const field of ['question', 'chosen', 'reasoning', 'resolver'] as const) {
+        const v = memo[field];
+        if (typeof v !== 'string' || v.trim() === '') {
+            problems.push(`${field} is required and must be non-empty`);
+        }
+    }
+    const c = memo.confidence;
+    if (typeof c !== 'string' || !CONFIDENCE.has(c)) {
+        problems.push(`confidence must be one of high | medium | low (got ${String(c)})`);
+    }
+    return problems;
+}
+
+export function render(memo: DecisionMemo, index: number, stampedAt: string): string {
+    return [
+        `# Decision ${String(index).padStart(3, '0')}`,
+        '',
+        `- **Resolver:** ${memo.resolver}`,
+        `- **Confidence:** ${memo.confidence}`,
+        `- **Recorded:** ${stampedAt}`,
+        '',
+        '## Question',
+        '',
+        memo.question.trim(),
+        '',
+        '## Chosen',
+        '',
+        memo.chosen.trim(),
+        '',
+        '## Reasoning',
+        '',
+        memo.reasoning.trim(),
+        '',
+    ].join('\n');
+}
+
+export interface WriteResult {
+    path: string;
+    index: number;
+}
+
+/**
+ * Write one memo. Throws on a validation failure — a memo that cannot be
+ * written is a caller bug and must not degrade into a partial record.
+ */
+export function writeMemo(
+    repoRoot: string,
+    runId: string,
+    memo: DecisionMemo,
+    opts: { now?: () => Date } = {},
+): WriteResult {
+    if (!isSafeRunId(runId)) {
+        throw new Error(
+            `decision_memo: run id ${JSON.stringify(runId)} is not a safe filename ` +
+                `component (letters, digits, _ and - only, 1..64 chars)`,
+        );
+    }
+    const problems = validate(memo);
+    if (problems.length > 0) {
+        throw new Error(`decision_memo: refusing an incomplete memo — ${problems.join('; ')}`);
+    }
+    const dir = runDir(repoRoot, runId);
+    fs.mkdirSync(dir, { recursive: true });
+    const stamp = (opts.now ?? ((): Date => new Date()))().toISOString();
+    // Claim the slot with `wx` and retry on collision, rather than
+    // read-then-write.
+    //
+    // R2 review, finding 10. `nextIndex` followed by a plain `writeFileSync`
+    // is a read-then-write with no lock: two memos written for the same run
+    // concurrently — the unattended or parallel lane this module exists for,
+    // or simply two shell calls — compute the same index and the second
+    // silently overwrites the first. That breaks the exact property the header
+    // sells as this module's reason to exist ("monotonic and gap-free per run,
+    // so a reader can tell a pruned memo from an unwritten one"), because a
+    // LOST memo leaves no gap at all.
+    //
+    // The bound is generous and finite: a loop that cannot fail would hide a
+    // permission error as a hang.
+    const MAX_ATTEMPTS = 64;
+    for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+        const index = nextIndex(dir);
+        const file = path.join(dir, `${String(index).padStart(3, '0')}.md`);
+        try {
+            fs.writeFileSync(file, render(memo, index, stamp), { encoding: 'utf-8', flag: 'wx' });
+            return { path: file, index };
+        } catch (err) {
+            // EEXIST means another writer took this index between the read and
+            // the write — re-read and take the next one. Anything else (EACCES,
+            // ENOSPC) is a real failure and must not be retried into a hang.
+            if ((err as NodeJS.ErrnoException).code !== 'EEXIST') throw err;
+        }
+    }
+    throw new Error(
+        `decision_memo: could not claim an index for run ${JSON.stringify(runId)} ` +
+            `after ${MAX_ATTEMPTS} attempts — another writer is taking every slot`,
+    );
+}
+
+/** Every memo of one run, in index order. */
+export function listMemos(repoRoot: string, runId: string): string[] {
+    const dir = runDir(repoRoot, runId);
+    let entries: string[];
+    try {
+        entries = fs.readdirSync(dir);
+    } catch {
+        return [];
+    }
+    return entries
+        .filter((n) => /^\d{3}\.md$/.test(n))
+        .sort()
+        .map((n) => path.join(dir, n));
+}
+
+const USAGE = `usage: decision_memo write --run <id> --question <q> --chosen <c> \\
+                        --reasoning <r> --resolver <who> --confidence <high|medium|low>
+       decision_memo list --run <id>
+
+Records one autonomously-resolved question so it is reviewable after the run.
+Writes agents/runtime/state/decisions/<run>/NNN.md — local-only (gitignored).
+
+--run takes ANY slug, and that freedom has a cost worth stating (R2 round 4,
+finding 3): interruption_report attributes memos to a run by joining on the
+session-derived run id, so a memo written under a hand-picked slug is counted
+by 'run:supervise --digest' (which counts directories) and NOT by the report's
+median_memos_per_run (which joins). The two disagree about the same files, and
+the report's zero reads as "no memos" rather than "no join".
+
+To be attributable, pass the id the ledger uses:
+  agent-config run:supervise --digest    # lists the session ids in play
+A free-form slug is still valid and still recorded — it is simply a memo about
+a run the report cannot name.
+
+Locked classes (high_impact, user_required) are refused at the CONFIG SCHEMA,
+never here: this is the ledger, not the gate.
+`;
+
+function argValue(argv: string[], flag: string): string | null {
+    const i = argv.indexOf(flag);
+    if (i === -1 || i + 1 >= argv.length) return null;
+    return argv[i + 1] ?? null;
+}
+
+export function main(argv: string[] = process.argv.slice(2)): number {
+    const sub = argv[0] ?? '';
+    if (sub === '' || sub === '--help' || sub === '-h') {
+        process.stdout.write(USAGE);
+        return sub === '' ? 2 : 0;
+    }
+    const repoRoot = argValue(argv, '--root') ?? process.cwd();
+    const runId = argValue(argv, '--run');
+    if (runId === null) {
+        process.stderr.write('decision_memo: --run <id> is required\n');
+        return 2;
+    }
+
+    if (sub === 'list') {
+        const memos = listMemos(repoRoot, runId);
+        if (memos.length === 0) {
+            process.stdout.write(`decision_memo: no memos for run ${runId}\n`);
+            return 0;
+        }
+        for (const m of memos) {
+            process.stdout.write(`${path.relative(repoRoot, m)}\n`);
+        }
+        return 0;
+    }
+
+    if (sub !== 'write') {
+        process.stderr.write(`decision_memo: unknown subcommand '${sub}'\n${USAGE}`);
+        return 2;
+    }
+
+    const memo: Partial<DecisionMemo> = {
+        question: argValue(argv, '--question') ?? '',
+        chosen: argValue(argv, '--chosen') ?? '',
+        reasoning: argValue(argv, '--reasoning') ?? '',
+        resolver: argValue(argv, '--resolver') ?? '',
+        confidence: (argValue(argv, '--confidence') ?? '') as DecisionMemo['confidence'],
+    };
+    const problems = validate(memo);
+    if (problems.length > 0) {
+        process.stderr.write(`decision_memo: ${problems.join('; ')}\n`);
+        return 2;
+    }
+    try {
+        const res = writeMemo(repoRoot, runId, memo as DecisionMemo);
+        process.stdout.write(`${path.relative(repoRoot, res.path)}\n`);
+        return 0;
+    } catch (exc) {
+        process.stderr.write(`${exc instanceof Error ? exc.message : String(exc)}\n`);
+        return 2;
+    }
+}
+
+/**
+ * The realpath-comparing form, not a `basename` test: an installed projection
+ * and macOS `/var` → `/private/var` both make `argv[1]` a symlink whose URL
+ * differs from `import.meta.url`, and a naive comparison silently no-ops the
+ * CLI. Same shape as `interruption_report.ts::_isCliEntry`.
+ */
+function _isCliEntry(): boolean {
+    if (process.argv[1] === undefined) {
+        return false;
+    }
+    const argvUrl = pathToFileURL(path.resolve(process.argv[1])).href;
+    if (import.meta.url === argvUrl) {
+        return true;
+    }
+    try {
+        const here = fs.realpathSync(fileURLToPath(import.meta.url));
+        const argv = fs.realpathSync(path.resolve(process.argv[1]));
+        return here === argv;
+    } catch {
+        return false;
+    }
+}
+
+if (_isCliEntry()) {
+    process.exit(main());
+}

package/src/scripts/hook_manifest.json

@@ -0,0 +1 @@
+{"fingerprint":"4834904a:65187","manifest":{"schema_version":1,"concerns":{"chat-history":{"script":"src/scripts/chat_history.ts","args":["hook-dispatch"],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["result"]},"hot-context":{"script":"src/scripts/hot_context_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"handoff-context":{"script":"src/scripts/handoff_context_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"roadmap-progress":{"script":"src/scripts/roadmap_progress_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input"]},"onboarding-gate":{"script":"src/scripts/onboarding_gate_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"context-hygiene":{"script":"src/scripts/context_hygiene_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"verify-before-complete":{"script":"src/scripts/before_complete_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input","result"]},"ship-diff-volume":{"script":"src/scripts/hooks/ship_diff_volume_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input"]},"minimal-safe-diff":{"script":"src/scripts/minimal_safe_diff_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input"]},"injection-scan":{"script":"src/scripts/injection_scan_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input","result"]},"block-no-verify":{"script":"src/scripts/hooks/block_no_verify.ts","args":[],"fail_closed":true,"severity":"blocking","needs_payload_bodies":["input"]},"block-kernel-rule-writes":{"script":"src/scripts/hooks/block_kernel_rule_writes.ts","args":[],"fail_closed":true,"severity":"blocking","needs_payload_bodies":["input"]},"block-config-weakening":{"script":"src/scripts/hooks/block_config_weakening.ts","args":[],"fail_closed":false,"severity":"blocking","needs_payload_bodies":["input"]},"rtk-wrap":{"script":"src/scripts/hooks/rtk_wrap_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input"]},"design-slop":{"script":"src/scripts/hooks/design_slop_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input"]},"ui-route-nudge":{"script":"src/scripts/hooks/ui_route_nudge_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input"]},"code-graph-nudge":{"script":"src/scripts/hooks/code_graph_nudge_hook.ts","args":[],"fail_closed":false,"severity":"advisory","tools":["Grep","Glob","Read"],"needs_payload_bodies":["input"]},"memory-learn":{"script":"src/scripts/memory_learn_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"first-run-gate":{"script":"src/scripts/first_run_gate_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"profile-staleness":{"script":"src/scripts/profile_staleness_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"wrapper-freshness":{"script":"src/scripts/wrapper_freshness_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"surface-probe":{"script":"src/scripts/surface_probe_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"team-review-gate":{"script":"src/scripts/team_review_gate_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"pr-url-reminder":{"script":"src/scripts/pr_url_reminder_hook.ts","args":[],"fail_closed":false,"severity":"advisory","needs_payload_bodies":["input","result"]},"language-mirror":{"script":"src/scripts/language_mirror_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"git-authorization":{"script":"src/scripts/git_authorization_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"block-unauthorized-git":{"script":"src/scripts/hooks/block_unauthorized_git.ts","args":[],"fail_closed":true,"severity":"blocking","needs_payload_bodies":["input"]},"evidence-independence":{"script":"src/scripts/hooks/evidence_independence.ts","args":[],"fail_closed":false,"severity":"blocking","needs_payload_bodies":["input"]},"session-canary":{"script":"src/scripts/session_canary_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"council-availability":{"script":"src/scripts/council_availability_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"telemetry-disclosure":{"script":"src/scripts/telemetry_disclosure_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"self-repair":{"script":"src/scripts/self_repair_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"session-register":{"script":"src/scripts/session_register_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"orchestration-record":{"script":"src/scripts/hooks/orchestration_record_hook.ts","args":[],"fail_closed":false,"severity":"advisory","tools":["Agent","Task"],"needs_payload_bodies":["input","result"]},"telemetry-usage":{"script":"src/scripts/hooks/telemetry_usage_hook.ts","args":[],"fail_closed":false,"severity":"advisory","tools":["Skill"],"needs_payload_bodies":["input"]},"delegation-nudge":{"script":"src/scripts/hooks/delegation_nudge_hook.ts","args":[],"fail_closed":false,"severity":"advisory","nudge_rank":1},"skill-route":{"script":"src/scripts/hooks/skill_route_hook.ts","args":[],"fail_closed":false,"severity":"advisory","nudge_rank":2},"end-review-nudge":{"script":"src/scripts/hooks/end_review_nudge_hook.ts","args":[],"fail_closed":false,"severity":"advisory","skip_on_refusal_retry":true},"turn-end-gate":{"script":"src/scripts/hooks/turn_end_gate_hook.ts","args":[],"fail_closed":false,"severity":"blocking"},"edit-shape":{"script":"src/scripts/hooks/edit_shape_hook.ts","args":[],"fail_closed":false,"severity":"advisory","tools":["Write"],"needs_payload_bodies":["input"]},"reread-guard":{"script":"src/scripts/hooks/reread_guard_hook.ts","args":[],"fail_closed":false,"severity":"advisory","tools":["Read","Edit","Write"],"needs_payload_bodies":["input"]},"session-eol":{"script":"src/scripts/hooks/session_eol_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"run-continuation":{"script":"src/scripts/hooks/run_continuation_hook.ts","args":[],"fail_closed":false,"severity":"blocking"},"interruption-ledger":{"script":"src/scripts/hooks/interruption_ledger_hook.ts","args":[],"fail_closed":false,"severity":"advisory","skip_on_refusal_retry":true},"subagent-ledger":{"script":"src/scripts/hooks/subagent_ledger_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"tool-result-bytes":{"script":"src/scripts/hooks/tool_result_bytes_hook.ts","args":[],"fail_closed":false,"severity":"advisory"},"spawn-guard-shadow":{"script":"src/scripts/hooks/spawn_guard_shadow_hook.ts","args":[],"fail_closed":false,"severity":"advisory","tools":["Agent","Task"]}},"roles":{"worker":{"drop":["delegation-nudge","skill-route","end-review-nudge","council-availability","team-review-gate","self-repair","session-eol","interruption-ledger"]}},"platforms":{"augment":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","minimal-safe-diff","profile-staleness","wrapper-freshness","surface-probe","session-register"],"session_end":["chat-history","memory-learn","session-register","roadmap-progress"],"stop":["chat-history","hot-context","verify-before-complete","self-repair","session-register","roadmap-progress"],"pre_tool_use":["block-no-verify","block-unauthorized-git","evidence-independence","block-kernel-rule-writes","block-config-weakening","rtk-wrap","design-slop","ui-route-nudge","code-graph-nudge","ship-diff-volume","reread-guard"],"post_tool_use":["chat-history","roadmap-progress","context-hygiene","verify-before-complete","minimal-safe-diff","injection-scan","pr-url-reminder","orchestration-record","telemetry-usage","tool-result-bytes","edit-shape"]},"claude":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","minimal-safe-diff","profile-staleness","wrapper-freshness","surface-probe","session-register"],"session_end":["chat-history","memory-learn","session-register","roadmap-progress"],"stop":["chat-history","hot-context","verify-before-complete","team-review-gate","end-review-nudge","turn-end-gate","self-repair","session-register","session-eol","interruption-ledger","roadmap-progress","run-continuation"],"user_prompt_submit":["chat-history","verify-before-complete","minimal-safe-diff","language-mirror","delegation-nudge","skill-route","git-authorization","session-canary","self-repair","session-register"],"pre_tool_use":["block-no-verify","block-unauthorized-git","evidence-independence","block-kernel-rule-writes","block-config-weakening","rtk-wrap","design-slop","ui-route-nudge","code-graph-nudge","ship-diff-volume","reread-guard","spawn-guard-shadow"],"post_tool_use":["chat-history","roadmap-progress","context-hygiene","verify-before-complete","minimal-safe-diff","injection-scan","pr-url-reminder","orchestration-record","telemetry-usage","tool-result-bytes","edit-shape","language-mirror"],"pre_compact":["language-mirror","hot-context"],"subagent_start":["subagent-ledger"],"subagent_stop":["subagent-ledger"]},"cowork":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","minimal-safe-diff","profile-staleness","wrapper-freshness","surface-probe","session-register"],"session_end":["chat-history","memory-learn","session-register","roadmap-progress"],"stop":["chat-history","hot-context","verify-before-complete","self-repair","session-register","roadmap-progress"],"user_prompt_submit":["chat-history","verify-before-complete","minimal-safe-diff","language-mirror","git-authorization","session-canary","self-repair","session-register"],"pre_tool_use":["block-no-verify","block-unauthorized-git","evidence-independence","block-kernel-rule-writes","block-config-weakening","rtk-wrap","design-slop","ui-route-nudge","code-graph-nudge","ship-diff-volume","reread-guard","spawn-guard-shadow"],"post_tool_use":["chat-history","roadmap-progress","context-hygiene","verify-before-complete","minimal-safe-diff","injection-scan","pr-url-reminder","orchestration-record","telemetry-usage","tool-result-bytes","edit-shape"],"subagent_start":["subagent-ledger"],"subagent_stop":["subagent-ledger"]},"cursor":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","minimal-safe-diff","profile-staleness","wrapper-freshness","surface-probe","session-register"],"session_end":["chat-history","memory-learn","session-register","roadmap-progress"],"stop":["chat-history","hot-context","verify-before-complete","self-repair","session-register","roadmap-progress"],"user_prompt_submit":["chat-history","verify-before-complete","minimal-safe-diff","language-mirror","git-authorization","session-canary","self-repair","session-register"],"post_tool_use":["chat-history","roadmap-progress","context-hygiene","verify-before-complete","minimal-safe-diff","injection-scan","pr-url-reminder","orchestration-record","telemetry-usage","tool-result-bytes","edit-shape"]},"cline":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","minimal-safe-diff","profile-staleness","wrapper-freshness","surface-probe","session-register"],"session_end":["chat-history","memory-learn","session-register","roadmap-progress"],"stop":["chat-history","hot-context","verify-before-complete","self-repair","session-register","roadmap-progress"],"user_prompt_submit":["chat-history","verify-before-complete","minimal-safe-diff","language-mirror","git-authorization","session-canary","self-repair","session-register"],"post_tool_use":["chat-history","roadmap-progress","context-hygiene","verify-before-complete","minimal-safe-diff","injection-scan","pr-url-reminder","orchestration-record","telemetry-usage","tool-result-bytes","edit-shape"]},"windsurf":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","profile-staleness","wrapper-freshness","surface-probe","session-register"],"stop":["chat-history","hot-context","verify-before-complete","self-repair","session-register"],"user_prompt_submit":["chat-history","verify-before-complete","language-mirror","git-authorization","session-canary","self-repair","session-register"]},"gemini":{"session_start":["chat-history","hot-context","handoff-context","session-canary","council-availability","telemetry-disclosure","first-run-gate","onboarding-gate","verify-before-complete","minimal-safe-diff","profile-staleness","wrapper-freshness","surface-probe","session-register"],"session_end":["chat-history","memory-learn","session-register","roadmap-progress"],"stop":["chat-history","hot-context","verify-before-complete","self-repair","session-register","roadmap-progress"],"user_prompt_submit":["chat-history","verify-before-complete","minimal-safe-diff","language-mirror","git-authorization","session-canary","self-repair","session-register"],"post_tool_use":["chat-history","roadmap-progress","context-hygiene","verify-before-complete","minimal-safe-diff","injection-scan","pr-url-reminder","orchestration-record","telemetry-usage","tool-result-bytes","edit-shape"]},"copilot":{"fallback_only":true}},"native_event_aliases":{"augment":{"SessionStart":"session_start","SessionEnd":"session_end","Stop":"stop","PostToolUse":"post_tool_use","PreToolUse":"pre_tool_use"},"claude":{"SessionStart":"session_start","SessionEnd":"session_end","Stop":"stop","UserPromptSubmit":"user_prompt_submit","PostToolUse":"post_tool_use","PreToolUse":"pre_tool_use","PreCompact":"pre_compact","SubagentStart":"subagent_start","SubagentStop":"subagent_stop"},"cowork":{"SessionStart":"session_start","SessionEnd":"session_end","Stop":"stop","UserPromptSubmit":"user_prompt_submit","PostToolUse":"post_tool_use","PreToolUse":"pre_tool_use","PreCompact":"pre_compact","SubagentStart":"subagent_start","SubagentStop":"subagent_stop"},"cursor":{"sessionStart":"session_start","sessionEnd":"session_end","stop":"stop","beforeSubmitPrompt":"user_prompt_submit","postToolUse":"post_tool_use","preToolUse":"pre_tool_use","preCompact":"pre_compact"},"cline":{"TaskStart":"session_start","TaskResume":"session_start","TaskComplete":"session_end","TaskCancel":"stop","UserPromptSubmit":"user_prompt_submit","PostToolUse":"post_tool_use","PreToolUse":"pre_tool_use","PreCompact":"pre_compact"},"windsurf":{"pre_user_prompt":"user_prompt_submit","post_cascade_response":"stop","post_setup_worktree":"session_start"},"gemini":{"SessionStart":"session_start","SessionEnd":"session_end","BeforeAgent":"user_prompt_submit","AfterAgent":"stop","BeforeTool":"pre_tool_use","AfterTool":"post_tool_use"}}}}