oh-my-codex 0.20.0 → 0.20.2

package/dist/config/generator.js

@@ -13,11 +13,10 @@ import { readFile, writeFile } from "fs/promises";
 import { existsSync } from "fs";
 import { join, resolve } from "path";
 import TOML from "@iarna/toml";
-import { AGENT_DEFINITIONS } from "../agents/definitions.js";
 import { DEFAULT_FRONTIER_MODEL } from "./models.js";
 import { DEFAULT_CODEX_HOOK_FEATURE_FLAG, CODEX_HOOK_FEATURE_FLAGS, CODEX_PLUGIN_SCOPED_HOOKS_FEATURE_FLAG, formatCodexHookFeatureFlagLine, normalizeCodexHookFeatureFlag, } from "./codex-feature-flags.js";
 import { OMX_FIRST_PARTY_MCP_SERVER_NAMES, getOmxFirstPartySetupMcpServers, } from "./omx-first-party-mcp.js";
-import { buildManagedCodexHookTrustState, escapeTomlBasicString, } from "./codex-hooks.js";
+import { buildManagedCodexHookTrustState, escapeTomlBasicString, ManagedCodexHooksPlanError, scanManagedCodexHookTrustStateFromContent, } from "./codex-hooks.js";
 function escapeTomlString(value) {
     return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }
@@ -34,25 +33,65 @@ const OMX_TOP_LEVEL_KEYS = [
     "developer_instructions",
 ];
 export const DEFAULT_SETUP_MODEL = DEFAULT_FRONTIER_MODEL;
-export const DEFAULT_SETUP_MODEL_CONTEXT_WINDOW = 250000;
-export const DEFAULT_SETUP_MODEL_AUTO_COMPACT_TOKEN_LIMIT = 200000;
-export function getModelContextRecommendation(model) {
-    if (model !== DEFAULT_SETUP_MODEL)
-        return null;
-    return {
-        model,
-        modelContextWindow: DEFAULT_SETUP_MODEL_CONTEXT_WINDOW,
-        modelAutoCompactTokenLimit: DEFAULT_SETUP_MODEL_AUTO_COMPACT_TOKEN_LIMIT,
-    };
-}
+const LEGACY_SEEDED_MODEL_CONTEXT_WINDOW = 250000;
+const LEGACY_SEEDED_MODEL_AUTO_COMPACT_TOKEN_LIMIT = 200000;
 const OMX_SEEDED_BEHAVIORAL_DEFAULTS_START_MARKER = "# oh-my-codex seeded behavioral defaults (uninstall removes unchanged defaults)";
 const OMX_SEEDED_BEHAVIORAL_DEFAULTS_END_MARKER = "# End oh-my-codex seeded behavioral defaults";
-export const OMX_DEVELOPER_INSTRUCTIONS = "You have oh-my-codex installed. AGENTS.md is the orchestration brain and main control surface. Follow AGENTS.md for skill/keyword routing, $name workflow invocation, and role-specialized subagents; when spawning native subagents, set `agent_type` to an installed role and never omit it for OMX work. Use outcome-first, concise progress updates: state the target result, constraints, validation evidence, and stop condition before adding process detail. Native subagents live in .codex/agents and may handle independent parallel subtasks within one Codex session or team pane. Skills load from .codex/skills, not native-agent TOMLs. Treat installed prompts as narrower execution surfaces under AGENTS.md authority.";
-export const OMX_PLUGIN_DEVELOPER_INSTRUCTIONS = '<omx version="1">You have oh-my-codex installed through Codex plugin mode. AGENTS.md is the orchestration brain and main control surface. Follow AGENTS.md for skill/keyword routing and $name workflow invocation. When spawning native subagents, set `agent_type` to an installed role and never omit it for OMX work. Registered Codex plugin marketplace surfaces supply OMX workflows and plugin-scoped companion resources when the plugin is installed; native agent roles are installed as setup-owned Codex agent TOML files in plugin mode so agent_type routing works. User-installed skills may still live under ~/.codex/skills. Use outcome-first, concise progress updates: state the target result, constraints, validation evidence, and stop condition before adding process detail.</omx>';
+export const OMX_DEVELOPER_INSTRUCTIONS = "You have oh-my-codex installed. AGENTS.md is the orchestration brain and main control surface. Follow AGENTS.md for skill/keyword routing, $name workflow invocation, and role-specialized subagents; when the native surface exposes `agent_type` role routing, set `agent_type` to an installed role and never omit it for OMX work. When it does not (`role_routing_unavailable`, for example a Codex App `spawn_agent` surface exposing only `task_name`, `message`, and `fork_turns`), do not fabricate `agent_type`; follow the OMX adapted role-pass protocol by recording a pre-validated role intent in the OMX subagent ledger, and never fake the role via a prompt label. Use outcome-first, concise progress updates: state the target result, constraints, validation evidence, and stop condition before adding process detail. Native subagents live in .codex/agents and may handle independent parallel subtasks within one Codex session or team pane. Skills load from .codex/skills, not native-agent TOMLs. Treat installed prompts as narrower execution surfaces under AGENTS.md authority.";
+export const OMX_PLUGIN_DEVELOPER_INSTRUCTIONS = '<omx version="1">You have oh-my-codex installed through Codex plugin mode. AGENTS.md is the orchestration brain and main control surface. Follow AGENTS.md for skill/keyword routing and $name workflow invocation. When the native surface exposes `agent_type` role routing, set `agent_type` to an installed role and never omit it for OMX work. When it does not (`role_routing_unavailable`, for example a Codex App `spawn_agent` surface exposing only `task_name`, `message`, and `fork_turns`), do not fabricate `agent_type`; follow the OMX adapted role-pass protocol by recording a pre-validated role intent in the OMX subagent ledger, and never fake the role via a prompt label. Registered Codex plugin marketplace surfaces supply OMX workflows and plugin-scoped companion resources when the plugin is installed; native agent roles are installed as setup-owned Codex agent TOML files in plugin mode so agent_type routing works. User-installed skills may still live under ~/.codex/skills. Use outcome-first, concise progress updates: state the target result, constraints, validation evidence, and stop condition before adding process detail.</omx>';
 const SHARED_MCP_REGISTRY_MARKER = "oh-my-codex (OMX) Shared MCP Registry Sync";
 const SHARED_MCP_REGISTRY_END_MARKER = "# End oh-my-codex shared MCP registry sync";
-const OMX_AGENTS_MAX_THREADS = 6;
-const OMX_AGENTS_MAX_DEPTH = 2;
+const LEGACY_MULTI_AGENT_KEYS = [
+    "features.multi_agent",
+    "agents.max_threads",
+    "agents.max_depth",
+];
+const LEGACY_MULTI_AGENT_VALUES = {
+    "features.multi_agent": true,
+    "agents.max_threads": 6,
+    "agents.max_depth": 2,
+};
+export function analyzeLegacyMultiAgentConfig(configText) {
+    let parsed;
+    try {
+        parsed = TOML.parse(configText);
+    }
+    catch (error) {
+        const reasonCode = /duplicate|redefine|already defined/i.test(String(error))
+            ? "toml-duplicate-key"
+            : "toml-parse-error";
+        return {
+            assessments: Object.fromEntries(LEGACY_MULTI_AGENT_KEYS.map((key) => [
+                key,
+                { key, state: "invalid/duplicate", reasonCode },
+            ])),
+        };
+    }
+    return {
+        assessments: Object.fromEntries(LEGACY_MULTI_AGENT_KEYS.map((key) => {
+            const [table, entry] = key.split(".");
+            const value = isRecord(parsed[table]) ? parsed[table][entry] : undefined;
+            if (value === undefined) {
+                return [key, { key, state: "absent", reasonCode: "key-absent" }];
+            }
+            if (value === LEGACY_MULTI_AGENT_VALUES[key]) {
+                return [
+                    key,
+                    {
+                        key,
+                        state: "retained-legacy",
+                        reasonCode: "exact-legacy-value",
+                        value,
+                    },
+                ];
+            }
+            return [
+                key,
+                { key, state: "custom", reasonCode: "custom-value", value },
+            ];
+        })),
+    };
+}
 const OMX_EXPLORE_ROUTING_DEFAULT = "0";
 const OMX_EXPLORE_CMD_ENV = "USE_OMX_EXPLORE_CMD";
 const DEFAULT_LAUNCHER_MCP_STARTUP_TIMEOUT_SEC = 15;
@@ -97,6 +136,7 @@ const LEGACY_OMX_STATUS_LINE = statusLineForPreset(DEFAULT_STATUS_LINE_PRESET);
 const OMX_PRESET_STATUS_LINE_VALUES = new Set(Object.keys(STATUS_LINE_PRESETS).map((preset) => statusLineForPreset(preset)));
 const LEGACY_OMX_TEAM_RUN_TABLE_PATTERN = /^\s*\[mcp_servers\.(?:"omx_team_run"|omx_team_run)\]\s*$/m;
 const OMX_CONFIG_MARKER = "oh-my-codex (OMX) Configuration";
+const OMX_CONFIG_START_MARKER = `# ${OMX_CONFIG_MARKER}`;
 const OMX_CONFIG_END_MARKER = "# End oh-my-codex";
 const CODEX_MODEL_AVAILABILITY_NUX_TABLE_PATTERN = /^\s*\[tui\.model_availability_nux\]\s*(?:#.*)?$/;
 const TOML_TABLE_HEADER_PATTERN = /^\s*\[\[?[^\]]+\]?\]\s*(?:#.*)?$/;
@@ -343,71 +383,117 @@ function getOmxTopLevelLines(pkgRoot, existingConfig = "", modelOverride, notify
         `developer_instructions = "${escapeTomlString(OMX_DEVELOPER_INSTRUCTIONS)}"`,
     ];
     const existingModel = rootValues.get("model");
-    const existingContextWindow = rootValues.get("model_context_window");
-    const existingAutoCompact = rootValues.get("model_auto_compact_token_limit");
     const selectedModel = modelOverride ?? unwrapTomlString(existingModel) ?? DEFAULT_SETUP_MODEL;
     if (modelOverride || !existingModel) {
         lines.push(`model = "${selectedModel}"`);
     }
-    if (selectedModel === DEFAULT_SETUP_MODEL) {
-        const seededBehavioralDefaults = [];
-        if (!existingContextWindow) {
-            seededBehavioralDefaults.push(`model_context_window = ${DEFAULT_SETUP_MODEL_CONTEXT_WINDOW}`);
-        }
-        if (!existingAutoCompact) {
-            seededBehavioralDefaults.push(`model_auto_compact_token_limit = ${DEFAULT_SETUP_MODEL_AUTO_COMPACT_TOKEN_LIMIT}`);
-        }
-        if (seededBehavioralDefaults.length > 0) {
-            lines.push(OMX_SEEDED_BEHAVIORAL_DEFAULTS_START_MARKER);
-            lines.push(...seededBehavioralDefaults);
-            lines.push(OMX_SEEDED_BEHAVIORAL_DEFAULTS_END_MARKER);
-        }
-    }
     return lines;
 }
-function isUnchangedOmxSeededBehavioralDefaultsBlock(lines) {
-    const relevant = lines.filter((line) => {
-        const trimmed = line.trim();
-        return trimmed.length > 0 && !trimmed.startsWith("#");
-    });
-    if (relevant.length !== 2)
-        return false;
-    const parsed = parseRootKeyValues(relevant.join("\n"));
-    return (parsed.size === 2 &&
-        parsed.get("model_context_window") ===
-            String(DEFAULT_SETUP_MODEL_CONTEXT_WINDOW) &&
-        parsed.get("model_auto_compact_token_limit") ===
-            String(DEFAULT_SETUP_MODEL_AUTO_COMPACT_TOKEN_LIMIT));
+function sourceLines(config) {
+    const lines = [];
+    let start = 0;
+    for (let index = 0; index < config.length; index += 1) {
+        if (config[index] !== "\n")
+            continue;
+        lines.push({
+            content: config.slice(start, index - (index > start && config[index - 1] === "\r" ? 1 : 0)),
+            start,
+            end: index + 1,
+        });
+        start = index + 1;
+    }
+    if (start < config.length)
+        lines.push({ content: config.slice(start), start, end: config.length });
+    return lines;
 }
-export function stripOmxSeededBehavioralDefaults(config) {
-    const lines = config.split(/\r?\n/);
-    const firstTable = lines.findIndex((line) => /^\s*\[/.test(line));
-    const boundary = firstTable >= 0 ? firstTable : lines.length;
-    const result = [];
-    for (let index = 0; index < lines.length; index += 1) {
-        const trimmed = lines[index].trim();
-        if (index < boundary &&
-            trimmed === OMX_SEEDED_BEHAVIORAL_DEFAULTS_START_MARKER) {
-            const endIndex = lines.findIndex((line, candidateIndex) => candidateIndex > index &&
-                candidateIndex < boundary &&
-                line.trim() === OMX_SEEDED_BEHAVIORAL_DEFAULTS_END_MARKER);
-            if (endIndex < 0) {
-                continue;
-            }
-            const blockLines = lines.slice(index + 1, endIndex);
-            if (!isUnchangedOmxSeededBehavioralDefaultsBlock(blockLines)) {
-                result.push(...blockLines);
+function analyzeOmxSeededBehavioralDefaults(config) {
+    const lines = sourceLines(config);
+    const firstTable = lines.findIndex((line) => TOML_TABLE_HEADER_PATTERN.test(line.content));
+    const boundary = firstTable < 0 ? lines.length : firstTable;
+    const starts = lines.map((line, index) => ({ line, index }))
+        .filter(({ line }) => line.content === OMX_SEEDED_BEHAVIORAL_DEFAULTS_START_MARKER);
+    const ends = lines.map((line, index) => ({ line, index }))
+        .filter(({ line }) => line.content === OMX_SEEDED_BEHAVIORAL_DEFAULTS_END_MARKER);
+    if (starts.length === 0 && ends.length === 0)
+        return { state: "absent", spans: [] };
+    if (starts.length !== 1 || ends.length !== 1 || starts[0].index >= ends[0].index) {
+        return { state: "malformed-or-ambiguous", spans: [] };
+    }
+    const rootText = lines.slice(0, boundary).map((line) => line.content).join("\n");
+    let entryStart = 0;
+    const rootEntries = splitRootLevelEntries(rootText).entries.map((entry) => {
+        const indexed = { entry, start: entryStart, end: entryStart + entry.lines.length };
+        entryStart = indexed.end;
+        return indexed;
+    });
+    const isStandaloneRootMarker = (index) => index < boundary && rootEntries.some(({ entry, start, end }) => !entry.key && start === index && end === index + 1);
+    const start = starts[0];
+    const end = ends[0];
+    if (!isStandaloneRootMarker(start.index) || !isStandaloneRootMarker(end.index)) {
+        return { state: "malformed-or-ambiguous", spans: [] };
+    }
+    const block = lines.slice(start.index, end.index + 1);
+    const exact = (body) => block.length === body.length + 2 &&
+        block[0].content === OMX_SEEDED_BEHAVIORAL_DEFAULTS_START_MARKER &&
+        block.at(-1)?.content === OMX_SEEDED_BEHAVIORAL_DEFAULTS_END_MARKER &&
+        body.every((line, index) => block[index + 1].content === line);
+    const blockSpan = [{ start: start.line.start, end: end.line.end }];
+    const markerSpans = [
+        { start: start.line.start, end: start.line.end },
+        { start: end.line.start, end: end.line.end },
+    ];
+    if (exact([
+        `model_context_window = ${LEGACY_SEEDED_MODEL_CONTEXT_WINDOW}`,
+        `model_auto_compact_token_limit = ${LEGACY_SEEDED_MODEL_AUTO_COMPACT_TOKEN_LIMIT}`,
+    ])) {
+        const hasOutsideDuplicate = rootEntries.some(({ entry, start: entryStart, end: entryEnd }) => (entryEnd <= start.index || entryStart > end.index) &&
+            (entry.key === "model_context_window" || entry.key === "model_auto_compact_token_limit"));
+        return hasOutsideDuplicate
+            ? { state: "malformed-or-ambiguous", spans: [] }
+            : { state: "exact-pair", spans: blockSpan };
+    }
+    const singletonState = (singletonKey, siblingKey) => {
+        let singletonDuplicates = 0;
+        let siblingCount = 0;
+        let invalidSibling = false;
+        for (const { entry, start: entryStart, end: entryEnd } of rootEntries) {
+            const outside = entryEnd <= start.index || entryStart > end.index;
+            if (outside && entry.key === singletonKey)
+                singletonDuplicates += 1;
+            if (outside && entry.key === siblingKey) {
+                siblingCount += 1;
+                invalidSibling ||= !parseStandaloneToml(entry.lines.join("\n"));
             }
-            index = endIndex;
-            continue;
-        }
-        if (index < boundary &&
-            trimmed === OMX_SEEDED_BEHAVIORAL_DEFAULTS_END_MARKER) {
-            continue;
         }
-        result.push(lines[index]);
-    }
-    return result.join("\n");
+        if (singletonDuplicates > 0 || siblingCount > 1 || invalidSibling)
+            return "malformed-or-ambiguous";
+        return siblingCount === 1 ? "exact" : "bounded-nonremovable";
+    };
+    if (exact([`model_context_window = ${LEGACY_SEEDED_MODEL_CONTEXT_WINDOW}`])) {
+        const state = singletonState("model_context_window", "model_auto_compact_token_limit");
+        return state === "exact"
+            ? { state: "exact-context-singleton", spans: blockSpan }
+            : state === "bounded-nonremovable"
+                ? { state, spans: markerSpans }
+                : { state, spans: [] };
+    }
+    if (exact([`model_auto_compact_token_limit = ${LEGACY_SEEDED_MODEL_AUTO_COMPACT_TOKEN_LIMIT}`])) {
+        const state = singletonState("model_auto_compact_token_limit", "model_context_window");
+        return state === "exact"
+            ? { state: "exact-auto-singleton", spans: blockSpan }
+            : state === "bounded-nonremovable"
+                ? { state, spans: markerSpans }
+                : { state, spans: [] };
+    }
+    return { state: "bounded-nonremovable", spans: markerSpans };
+}
+export function hasExactOmxSeededBehavioralDefaultsPair(config) {
+    return analyzeOmxSeededBehavioralDefaults(config).state === "exact-pair";
+}
+export function stripOmxSeededBehavioralDefaults(config) {
+    return [...analyzeOmxSeededBehavioralDefaults(config).spans]
+        .sort((left, right) => right.start - left.start)
+        .reduce((result, span) => result.slice(0, span.start) + result.slice(span.end), config);
 }
 function stripRootLevelKeys(config, keys) {
     const { entries, remainder } = splitRootLevelEntries(config);
@@ -511,7 +597,6 @@ function upsertFeatureFlags(config, codexHookFeatureFlag = DEFAULT_CODEX_HOOK_FE
         const base = config.trimEnd();
         const featureBlock = [
             "[features]",
-            "multi_agent = true",
             "child_agents_md = true",
             hookFeatureFlagLine,
             "goals = true",
@@ -529,31 +614,19 @@ function upsertFeatureFlags(config, codexHookFeatureFlag = DEFAULT_CODEX_HOOK_FE
             break;
         }
     }
-    // Remove deprecated 'collab' key (superseded by multi_agent) and
-    // the misspelled singular 'goal' flag written by unreleased PR builds.
+    // Remove deprecated collab and unreleased singular goal flags.
     for (let i = sectionEnd - 1; i > featuresStart; i--) {
         if (/^\s*(?:collab|goal)\s*=/.test(lines[i])) {
             lines.splice(i, 1);
             sectionEnd -= 1;
         }
     }
-    let multiAgentIdx = -1;
     let childAgentsIdx = -1;
     for (let i = featuresStart + 1; i < sectionEnd; i++) {
-        if (/^\s*multi_agent\s*=/.test(lines[i])) {
-            multiAgentIdx = i;
-        }
-        else if (/^\s*child_agents_md\s*=/.test(lines[i])) {
+        if (/^\s*child_agents_md\s*=/.test(lines[i])) {
             childAgentsIdx = i;
         }
     }
-    if (multiAgentIdx >= 0) {
-        lines[multiAgentIdx] = "multi_agent = true";
-    }
-    else {
-        lines.splice(sectionEnd, 0, "multi_agent = true");
-        sectionEnd += 1;
-    }
     if (childAgentsIdx >= 0) {
         lines[childAgentsIdx] = "child_agents_md = true";
     }
@@ -721,105 +794,845 @@ export function syncProjectScopeTrustStateFromRuntime(projectConfig, runtimeConf
         return block;
     return `${stripped}\n\n${block}`;
 }
-function decodeTomlBasicString(raw) {
-    try {
-        const parsed = TOML.parse(`value = "${raw}"`);
-        return typeof parsed.value === "string" ? parsed.value : undefined;
+function isMultilineTomlString(mode) {
+    return mode === "multiline-basic" || mode === "multiline-literal";
+}
+/**
+ * Tracks only lexical boundaries needed to safely associate source lines with
+ * TOML statements. TOML's parser gives us semantics; this prevents source
+ * repair from treating table-like text in a multiline value as syntax.
+ */
+function analyzeTomlSource(config) {
+    const lines = config.split(/\r?\n/);
+    const lineStartsOutsideMultiline = [];
+    const lineHasTomlComment = [];
+    let mode;
+    let isUnambiguous = true;
+    for (const line of lines) {
+        lineStartsOutsideMultiline.push(!isMultilineTomlString(mode));
+        let hasComment = false;
+        for (let index = 0; index < line.length; index += 1) {
+            const character = line[index];
+            if (mode === "basic") {
+                if (character === "\\") {
+                    index += 1;
+                }
+                else if (character === "\"") {
+                    mode = undefined;
+                }
+                continue;
+            }
+            if (mode === "literal") {
+                if (character === "'")
+                    mode = undefined;
+                continue;
+            }
+            if (mode === "multiline-basic" || mode === "multiline-literal") {
+                const delimiter = mode === "multiline-basic" ? "\"" : "'";
+                if (mode === "multiline-basic" && character === "\\") {
+                    index += 1;
+                    continue;
+                }
+                if (character !== delimiter)
+                    continue;
+                let runEnd = index + 1;
+                while (line[runEnd] === delimiter)
+                    runEnd += 1;
+                if (runEnd - index >= 3) {
+                    // TOML permits one or two delimiter characters immediately before
+                    // the closing triple delimiter as string content.
+                    mode = undefined;
+                    index = runEnd - 1;
+                }
+                continue;
+            }
+            if (character === "#") {
+                hasComment = true;
+                break;
+            }
+            if (character !== "\"" && character !== "'")
+                continue;
+            const isMultiline = line[index + 1] === character && line[index + 2] === character;
+            if (isMultiline) {
+                mode = character === "\"" ? "multiline-basic" : "multiline-literal";
+                index += 2;
+            }
+            else {
+                mode = character === "\"" ? "basic" : "literal";
+            }
+        }
+        lineHasTomlComment.push(hasComment);
+        if (mode === "basic" || mode === "literal")
+            isUnambiguous = false;
     }
-    catch {
+    if (isMultilineTomlString(mode))
+        isUnambiguous = false;
+    return { lines, lineStartsOutsideMultiline, lineHasTomlComment, isUnambiguous };
+}
+function skipTomlSourceWhitespace(line, index) {
+    let cursor = index;
+    while (line[cursor] === " " || line[cursor] === "\t")
+        cursor += 1;
+    return cursor;
+}
+function parseTomlSourceKeySegment(line, index) {
+    const start = skipTomlSourceWhitespace(line, index);
+    const first = line[start];
+    if (!first)
+        return undefined;
+    if (first !== '"' && first !== "'") {
+        const match = /^[A-Za-z0-9_-]+/.exec(line.slice(start));
+        if (!match)
+            return undefined;
+        return { key: match[0], end: start + match[0].length, incomplete: false };
+    }
+    let cursor = start + 1;
+    let escaped = false;
+    for (; cursor < line.length; cursor += 1) {
+        const character = line[cursor];
+        if (first === '"' && escaped) {
+            escaped = false;
+            continue;
+        }
+        if (first === '"' && character === "\\") {
+            escaped = true;
+            continue;
+        }
+        if (character !== first)
+            continue;
+        const token = line.slice(start, cursor + 1);
+        const parsed = safeParseToml(`${token} = true`);
+        const keys = parsed ? Object.keys(parsed) : [];
+        const hasKey = keys.length === 1;
+        return {
+            ...(hasKey ? { key: keys[0] } : {}),
+            end: cursor + 1,
+            incomplete: !hasKey,
+        };
+    }
+    return { end: line.length, incomplete: true };
+}
+function isTomlSourceKey(segment, key) {
+    return segment.key === key;
+}
+function findTomlSourceAssignmentSeparator(line) {
+    let segment = parseTomlSourceKeySegment(line, 0);
+    if (!segment || segment.incomplete)
+        return undefined;
+    let cursor = skipTomlSourceWhitespace(line, segment.end);
+    while (line[cursor] === ".") {
+        segment = parseTomlSourceKeySegment(line, cursor + 1);
+        if (!segment || segment.incomplete)
+            return undefined;
+        cursor = skipTomlSourceWhitespace(line, segment.end);
+    }
+    return line[cursor] === "=" ? cursor : undefined;
+}
+function advancePastInlineTomlValue(line, index) {
+    let braces = 0;
+    let brackets = 0;
+    let quote;
+    let escaped = false;
+    for (let cursor = index; cursor < line.length; cursor += 1) {
+        const character = line[cursor];
+        if (quote) {
+            if (quote === '"' && escaped) {
+                escaped = false;
+            }
+            else if (quote === '"' && character === "\\") {
+                escaped = true;
+            }
+            else if (character === quote) {
+                quote = undefined;
+            }
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            continue;
+        }
+        if (character === "#")
+            return line.length;
+        if (character === "{") {
+            braces += 1;
+            continue;
+        }
+        if (character === "}") {
+            if (braces === 0 && brackets === 0)
+                return cursor;
+            braces = Math.max(0, braces - 1);
+            continue;
+        }
+        if (character === "[") {
+            brackets += 1;
+            continue;
+        }
+        if (character === "]") {
+            brackets = Math.max(0, brackets - 1);
+            continue;
+        }
+        if (character === "," && braces === 0 && brackets === 0)
+            return cursor + 1;
+    }
+    return line.length;
+}
+function inlineTomlTableMaySpellStateKey(line, index) {
+    let cursor = index;
+    while (cursor < line.length) {
+        cursor = skipTomlSourceWhitespace(line, cursor);
+        // A comment cannot close the surrounding inline table.
+        if (line[cursor] === "#")
+            return true;
+        if (line[cursor] === "}")
+            return false;
+        const segment = parseTomlSourceKeySegment(line, cursor);
+        if (!segment)
+            return true;
+        if (segment.incomplete || isTomlSourceKey(segment, "state"))
+            return true;
+        cursor = skipTomlSourceWhitespace(line, segment.end);
+        if (line[cursor] !== "=")
+            return true;
+        cursor = advancePastInlineTomlValue(line, cursor + 1);
+        if (line[cursor] === "}")
+            return false;
+    }
+    // The unclosed inline table can acquire a state member on a following
+    // unparsed line, so it is not safe to strip the containing marker block.
+    return true;
+}
+function lineMaySpellHooksState(line) {
+    let cursor = skipTomlSourceWhitespace(line, 0);
+    if (line[cursor] === "[") {
+        if (line[cursor + 1] === "[") {
+            cursor = skipTomlSourceWhitespace(line, cursor + 2);
+        }
+        else {
+            cursor = skipTomlSourceWhitespace(line, cursor + 1);
+        }
+    }
+    const hooks = parseTomlSourceKeySegment(line, cursor);
+    if (!hooks || !isTomlSourceKey(hooks, "hooks"))
+        return false;
+    cursor = skipTomlSourceWhitespace(line, hooks.end);
+    if (line[cursor] === ".") {
+        const state = parseTomlSourceKeySegment(line, cursor + 1);
+        // A dangling dot can be completed by a following unparsed state key.
+        return state === undefined || state.incomplete || isTomlSourceKey(state, "state");
+    }
+    if (line[cursor] !== "=")
+        return false;
+    cursor = skipTomlSourceWhitespace(line, cursor + 1);
+    // A bare assignment or comment cannot prove that a following unparsed line
+    // does not continue an inline hooks table with a state member.
+    if (cursor >= line.length || line[cursor] === "#")
+        return true;
+    return line[cursor] === "{" && inlineTomlTableMaySpellStateKey(line, cursor + 1);
+}
+/**
+ * Detects a potential array-table opener without accepting malformed spacing
+ * or extra opening brackets as TOML syntax. Array tables rooted at `hooks`
+ * have no proof-owned representation, so their first key segment is enough
+ * to retain a managed marker block rather than strip it.
+ */
+function parseTomlSourceArrayTableOpener(line) {
+    let cursor = skipTomlSourceWhitespace(line, 0);
+    if (line[cursor] !== "[")
         return undefined;
+    const hasExactAdjacentOpener = line[cursor + 1] === "[";
+    if (hasExactAdjacentOpener) {
+        cursor += 2;
+    }
+    else {
+        cursor = skipTomlSourceWhitespace(line, cursor + 1);
+        if (line[cursor] !== "[")
+            return undefined;
+        cursor += 1;
+    }
+    cursor = skipTomlSourceWhitespace(line, cursor);
+    while (line[cursor] === "[") {
+        cursor = skipTomlSourceWhitespace(line, cursor + 1);
     }
+    const firstKey = parseTomlSourceKeySegment(line, cursor);
+    return {
+        firstKey,
+        openerOnly: firstKey === undefined &&
+            (cursor >= line.length || line[cursor] === "#"),
+    };
+}
+function hasIncompleteTomlSourceHooksKeyPrefix(line) {
+    let cursor = skipTomlSourceWhitespace(line, 0);
+    let tableHeader = false;
+    let arrayTableHeader = false;
+    if (line[cursor] === "[") {
+        tableHeader = true;
+        if (line[cursor + 1] === "[") {
+            arrayTableHeader = true;
+            cursor = skipTomlSourceWhitespace(line, cursor + 2);
+        }
+        else {
+            cursor = skipTomlSourceWhitespace(line, cursor + 1);
+        }
+    }
+    const hooks = parseTomlSourceKeySegment(line, cursor);
+    if (!hooks || !isTomlSourceKey(hooks, "hooks"))
+        return false;
+    cursor = skipTomlSourceWhitespace(line, hooks.end);
+    if (!tableHeader)
+        return cursor >= line.length || line[cursor] === "#";
+    if (line[cursor] !== "]" || (arrayTableHeader && line[cursor + 1] !== "]")) {
+        return true;
+    }
+    const suffix = line.slice(cursor + (arrayTableHeader ? 2 : 1)).trimStart();
+    return suffix.length > 0 && !suffix.startsWith("#");
+}
+function isTomlSourceHooksKeyContinuationSeparator(line) {
+    const cursor = skipTomlSourceWhitespace(line, 0);
+    return line[cursor] === "." || line[cursor] === "=" || line[cursor] === "[";
 }
-function parseHooksStateHeader(line) {
-    const match = line.match(/^\s*\[hooks\.state\."((?:\\.|[^"\\])*)"\]\s*(#.*)?$/);
-    if (!match)
+function isTomlSourceBlankOrComment(line) {
+    return /^\s*(?:#.*)?$/.test(line);
+}
+function isTomlSourceStandaloneOpeningBracket(line) {
+    const cursor = skipTomlSourceWhitespace(line, 0);
+    if (line[cursor] !== "[")
+        return false;
+    const next = skipTomlSourceWhitespace(line, cursor + 1);
+    return next >= line.length || line[next] === "#";
+}
+function firstTomlSourceKeyFollowingOpeningBrackets(line) {
+    let cursor = skipTomlSourceWhitespace(line, 0);
+    while (line[cursor] === "[") {
+        cursor = skipTomlSourceWhitespace(line, cursor + 1);
+    }
+    return parseTomlSourceKeySegment(line, cursor);
+}
+function lineMaySpellStateKey(line) {
+    const state = parseTomlSourceKeySegment(line, 0);
+    return state !== undefined && (state.incomplete || isTomlSourceKey(state, "state"));
+}
+function isTomlSourceHooksTableHeader(parsed) {
+    const hooks = parsed?.hooks;
+    return parsed !== undefined &&
+        Object.keys(parsed).length === 1 &&
+        isPlainTomlRecord(hooks) &&
+        Object.keys(hooks).length === 0;
+}
+function hasUnprovenManagedMarkerHooksStateSyntax(source, managedMarkerRanges, parsedStatementSpans, parsedAssignmentSpans) {
+    const parsedLines = new Set();
+    const parsedStatementStartLines = new Set();
+    for (const span of parsedStatementSpans) {
+        parsedStatementStartLines.add(span.start);
+        for (let index = span.start; index < span.end; index += 1)
+            parsedLines.add(index);
+    }
+    const parsedAssignmentLines = new Set();
+    for (const span of parsedAssignmentSpans) {
+        for (let index = span.start; index < span.end; index += 1) {
+            parsedAssignmentLines.add(index);
+        }
+    }
+    const managedContentLines = new Set();
+    for (const range of managedMarkerRanges) {
+        for (let index = range.start + 1; index < range.end; index += 1) {
+            managedContentLines.add(index);
+        }
+    }
+    let insideHooksTable = false;
+    let hasIncompleteHooksKeyPrefix = false;
+    let hasIncompleteHooksArrayTableOpener = false;
+    for (let index = 0; index < source.lines.length; index += 1) {
+        if (!source.lineStartsOutsideMultiline[index]) {
+            hasIncompleteHooksKeyPrefix = false;
+            hasIncompleteHooksArrayTableOpener = false;
+            continue;
+        }
+        const line = source.lines[index] ?? "";
+        const isParsedAssignmentLine = parsedAssignmentLines.has(index);
+        if (!isParsedAssignmentLine) {
+            const header = parseTomlSourceTableHeader(line);
+            if (header?.parsed) {
+                insideHooksTable = isTomlSourceHooksTableHeader(header.parsed);
+            }
+        }
+        if (!managedContentLines.has(index)) {
+            hasIncompleteHooksKeyPrefix = false;
+            hasIncompleteHooksArrayTableOpener = false;
+            continue;
+        }
+        const isParsedStatementLine = parsedLines.has(index);
+        const isParsedStatementStartLine = parsedStatementStartLines.has(index);
+        if (hasIncompleteHooksKeyPrefix) {
+            if (isTomlSourceBlankOrComment(line))
+                continue;
+            if (isTomlSourceHooksKeyContinuationSeparator(line))
+                return true;
+            hasIncompleteHooksKeyPrefix = false;
+        }
+        // Parsed statements can contain nested arrays whose standalone brackets and
+        // quoted "hooks" values must not contribute to malformed-header tracking.
+        if (hasIncompleteHooksArrayTableOpener && !isParsedStatementLine) {
+            if (isTomlSourceBlankOrComment(line))
+                continue;
+            const firstKey = firstTomlSourceKeyFollowingOpeningBrackets(line);
+            if (firstKey) {
+                if (isTomlSourceKey(firstKey, "hooks"))
+                    return true;
+                hasIncompleteHooksArrayTableOpener = false;
+            }
+        }
+        const arrayTableOpener = !isParsedStatementLine || isParsedStatementStartLine
+            ? parseTomlSourceArrayTableOpener(line)
+            : undefined;
+        if (arrayTableOpener?.firstKey && isTomlSourceKey(arrayTableOpener.firstKey, "hooks")) {
+            return true;
+        }
+        if (arrayTableOpener?.openerOnly && !isParsedStatementLine) {
+            hasIncompleteHooksArrayTableOpener = true;
+        }
+        if (!isParsedStatementLine && isTomlSourceStandaloneOpeningBracket(line)) {
+            hasIncompleteHooksArrayTableOpener = true;
+        }
+        if (isParsedStatementLine)
+            continue;
+        if (lineMaySpellHooksState(line) || (insideHooksTable && lineMaySpellStateKey(line))) {
+            return true;
+        }
+        const hasIncompleteHooksPrefix = hasIncompleteTomlSourceHooksKeyPrefix(line);
+        if (hasIncompleteHooksPrefix && /^\s*\[\[?/.test(line))
+            return true;
+        hasIncompleteHooksKeyPrefix = hasIncompleteHooksPrefix;
+    }
+    return false;
+}
+function managedHookTrustStateExpectations(...states) {
+    const expectations = new Map();
+    for (const state of states) {
+        if (!state)
+            continue;
+        for (const [key, entry] of Object.entries(state)) {
+            const hashes = expectations.get(key) ?? new Set();
+            hashes.add(entry.trusted_hash);
+            expectations.set(key, hashes);
+        }
+    }
+    return expectations;
+}
+function managedHookTrustCoordinateFamily(key) {
+    const match = /^(.*):([a-z_]+):\d+:\d+$/.exec(key);
+    return match ? `${match[1]}:${match[2]}` : undefined;
+}
+function expectedManagedHookTrustHashes(expectations, key, allowCoordinateDrift) {
+    const exact = expectations.get(key);
+    if (exact || !allowCoordinateDrift)
+        return exact;
+    const family = managedHookTrustCoordinateFamily(key);
+    if (!family)
         return undefined;
-    const key = decodeTomlBasicString(match[1] ?? "");
-    if (key === undefined)
+    const hashes = new Set();
+    for (const [expectedKey, expectedHashes] of expectations) {
+        if (managedHookTrustCoordinateFamily(expectedKey) !== family)
+            continue;
+        for (const hash of expectedHashes)
+            hashes.add(hash);
+    }
+    return hashes.size > 0 ? hashes : undefined;
+}
+function tomlHooksStateValue(parsed) {
+    if (!parsed)
         return undefined;
-    return { key, hasInlineComment: match[2] !== undefined };
+    const hooks = parsed.hooks;
+    if (!isPlainTomlRecord(hooks) || !Object.hasOwn(hooks, "state")) {
+        return undefined;
+    }
+    return hooks.state;
 }
-function isTomlTableHeader(line) {
-    return /^\s*\[\[?[^\]]+\]?\]\s*(?:#.*)?$/.test(line);
+function tomlHooksStateEntries(parsed) {
+    const state = tomlHooksStateValue(parsed);
+    return isPlainTomlRecord(state) ? state : undefined;
 }
-function isExactlyManagedHookTrustBody(bodyLines, expectedHash) {
-    const nonBlank = bodyLines.filter((line) => line.trim().length > 0);
-    if (nonBlank.length !== 1)
+function hasOnlyManagedHookTrustStateField(parsed, key) {
+    if (!parsed || Object.keys(parsed).length !== 1 || !Object.hasOwn(parsed, "hooks")) {
         return false;
-    const expected = expectedHash.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    return new RegExp(`^\\s*trusted_hash\\s*=\\s*"${expected}"\\s*$`).test(nonBlank[0] ?? "");
+    }
+    const hooks = parsed.hooks;
+    if (!isPlainTomlRecord(hooks) || Object.keys(hooks).length !== 1 || !Object.hasOwn(hooks, "state")) {
+        return false;
+    }
+    const state = hooks.state;
+    return isPlainTomlRecord(state) &&
+        Object.keys(state).length === 1 &&
+        Object.hasOwn(state, key);
 }
-function stripProofManagedCodexHookTrustStateTables(config, managedTrustState) {
-    if (Object.keys(managedTrustState).length === 0) {
-        return { config, preservedConflictKeys: new Set() };
+function parseTomlSourceTableHeader(line) {
+    const start = line.search(/\S/);
+    if (start === -1 || line[start] !== "[")
+        return undefined;
+    const array = line[start + 1] === "[";
+    let quote;
+    let escaped = false;
+    for (let index = start + (array ? 2 : 1); index < line.length; index += 1) {
+        const character = line[index];
+        if (quote === "\"") {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (character === "\\") {
+                escaped = true;
+            }
+            else if (character === quote) {
+                quote = undefined;
+            }
+            continue;
+        }
+        if (quote === "'") {
+            if (character === quote)
+                quote = undefined;
+            continue;
+        }
+        if (character === "\"" || character === "'") {
+            quote = character;
+            continue;
+        }
+        if (character !== "]")
+            continue;
+        const end = array ? index + 2 : index + 1;
+        if (array && line[index + 1] !== "]")
+            return undefined;
+        const suffix = line.slice(end).trimStart();
+        if (suffix.length > 0 && !suffix.startsWith("#"))
+            return undefined;
+        return { parsed: safeParseToml(line.slice(start, end)) };
     }
-    const lines = config.split(/\r?\n/);
-    const kept = [];
-    const preservedConflictKeys = new Set();
-    for (let i = 0; i < lines.length;) {
-        const header = parseHooksStateHeader(lines[i] ?? "");
-        if (!header) {
-            kept.push(lines[i]);
-            i += 1;
+    return undefined;
+}
+function sourceRangeHasTomlComment(source, start, end) {
+    for (let index = start; index < end; index += 1) {
+        if (source.lineHasTomlComment[index])
+            return true;
+    }
+    return false;
+}
+function collectMarkerRanges(source, startMarker, endMarker, includeUnterminatedRange = false, inertAssignmentSpans = []) {
+    const isInsideInertAssignment = (line) => inertAssignmentSpans.some((span) => span.start <= line && line < span.end);
+    const ranges = [];
+    for (let start = 0; start < source.lines.length; start += 1) {
+        if (!source.lineStartsOutsideMultiline[start] ||
+            isInsideInertAssignment(start) ||
+            source.lines[start]?.trim() !== startMarker)
+            continue;
+        const end = source.lines.findIndex((line, index) => index > start &&
+            source.lineStartsOutsideMultiline[index] &&
+            !isInsideInertAssignment(index) &&
+            line.trim() === endMarker);
+        const nestedStart = source.lines.findIndex((line, index) => index > start &&
+            source.lineStartsOutsideMultiline[index] &&
+            !isInsideInertAssignment(index) &&
+            line.trim() === startMarker);
+        if (end === -1 || (nestedStart !== -1 && nestedStart < end)) {
+            if (includeUnterminatedRange)
+                ranges.push({ start, end: source.lines.length });
             continue;
         }
-        let tableEnd = lines.length;
-        for (let next = i + 1; next < lines.length; next += 1) {
-            if (isTomlTableHeader(lines[next] ?? "")) {
-                tableEnd = next;
-                break;
+        ranges.push({ start, end });
+        start = end;
+    }
+    return ranges;
+}
+function recordManagedMarkerHooksStateSourceSpan(spans, invalidSpans, start, end, parsed, insideManagedMarkerBlock) {
+    if (!insideManagedMarkerBlock)
+        return;
+    const state = tomlHooksStateValue(parsed);
+    if (state === undefined)
+        return;
+    const span = { start, end };
+    spans.push(span);
+    if (!isPlainTomlRecord(state) || Object.keys(state).length === 0) {
+        invalidSpans.push(span);
+    }
+}
+function addManagedHookTrustStateSourceRepresentations(representations, markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, source, start, end, parsed, insideManagedMarkerBlock, containingTableScope, fallbackKeys = []) {
+    recordManagedMarkerHooksStateSourceSpan(markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, start, end, parsed, insideManagedMarkerBlock);
+    const state = tomlHooksStateEntries(parsed);
+    const hasComment = sourceRangeHasTomlComment(source, start, end);
+    if (state) {
+        const stateEntryCount = Object.keys(state).length;
+        for (const [key, value] of Object.entries(state)) {
+            const hasExactSemanticScope = hasOnlyManagedHookTrustStateField(parsed, key) &&
+                (!containingTableScope ||
+                    (!containingTableScope.hasComment &&
+                        hasOnlyManagedHookTrustStateField(containingTableScope.parsed, key)));
+            const entries = representations.get(key) ?? [];
+            entries.push({
+                start,
+                end,
+                stateEntryCount,
+                value,
+                hasComment,
+                hasExactSemanticScope,
+                insideManagedMarkerBlock,
+            });
+            representations.set(key, entries);
+        }
+        return;
+    }
+    for (const key of fallbackKeys) {
+        const entries = representations.get(key) ?? [];
+        entries.push({
+            start,
+            end,
+            stateEntryCount: 0,
+            value: undefined,
+            hasComment,
+            hasExactSemanticScope: false,
+            insideManagedMarkerBlock,
+        });
+        representations.set(key, entries);
+    }
+}
+function collectManagedHookTrustStateSourceRepresentations(config) {
+    const source = analyzeTomlSource(config);
+    const { lines } = source;
+    const parsedAssignmentSpans = [];
+    for (let cursor = 0; cursor < lines.length; cursor += 1) {
+        if (!source.lineStartsOutsideMultiline[cursor])
+            continue;
+        const line = lines[cursor] ?? "";
+        if (findTomlSourceAssignmentSeparator(line) === undefined)
+            continue;
+        for (let statementEnd = cursor + 1; statementEnd <= lines.length; statementEnd += 1) {
+            if (!safeParseToml(lines.slice(cursor, statementEnd).join("\n")))
+                continue;
+            parsedAssignmentSpans.push({ start: cursor, end: statementEnd });
+            cursor = statementEnd - 1;
+            break;
+        }
+    }
+    const headers = [];
+    for (const [index, line] of lines.entries()) {
+        if (!source.lineStartsOutsideMultiline[index])
+            continue;
+        const header = parseTomlSourceTableHeader(line);
+        if (parsedAssignmentSpans.some((span) => span.start < index && index < span.end))
+            continue;
+        if (header)
+            headers.push({ index, header });
+    }
+    const boundaries = new Set(headers.map(({ index }) => index));
+    for (const [index, line] of lines.entries()) {
+        if (source.lineStartsOutsideMultiline[index] &&
+            (line.trim() === OMX_HOOK_TRUST_END_MARKER ||
+                line.trim() === OMX_CONFIG_END_MARKER)) {
+            boundaries.add(index);
+        }
+    }
+    const sortedBoundaries = [...boundaries].sort((left, right) => left - right);
+    const representations = new Map();
+    const markerContainedHooksStateSpans = [];
+    const invalidMarkerContainedHooksStateSpans = [];
+    const parsedStatementSpans = [];
+    const managedMarkerRanges = [
+        ...collectMarkerRanges(source, OMX_HOOK_TRUST_START_MARKER, OMX_HOOK_TRUST_END_MARKER, false, parsedAssignmentSpans),
+        ...collectMarkerRanges(source, OMX_CONFIG_START_MARKER, OMX_CONFIG_END_MARKER, true, parsedAssignmentSpans),
+    ];
+    const isInsideManagedMarkerBlock = (start, end) => managedMarkerRanges.some((range) => start > range.start && end <= range.end);
+    const collectAssignments = (start, end, prefix, containingTableScope) => {
+        for (let cursor = start; cursor < end;) {
+            const line = lines[cursor] ?? "";
+            if (!source.lineStartsOutsideMultiline[cursor] ||
+                line.trim().length === 0 ||
+                line.trim() === OMX_HOOK_TRUST_START_MARKER ||
+                line.trim() === OMX_CONFIG_START_MARKER) {
+                cursor += 1;
+                continue;
+            }
+            let parsed;
+            let statementEnd = cursor + 1;
+            for (; statementEnd <= end; statementEnd += 1) {
+                const statement = lines.slice(cursor, statementEnd).join("\n");
+                parsed = safeParseToml(prefix ? `${prefix}\n${statement}` : statement);
+                if (parsed)
+                    break;
             }
+            if (!parsed) {
+                cursor += 1;
+                continue;
+            }
+            parsedStatementSpans.push({ start: cursor, end: statementEnd });
+            addManagedHookTrustStateSourceRepresentations(representations, markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, source, cursor, statementEnd, parsed, isInsideManagedMarkerBlock(cursor, statementEnd), containingTableScope);
+            cursor = statementEnd;
         }
-        const expectedState = managedTrustState[header.key];
-        const removable = expectedState !== undefined &&
-            !header.hasInlineComment &&
-            isExactlyManagedHookTrustBody(lines.slice(i + 1, tableEnd), expectedState.trusted_hash);
-        if (removable) {
-            i = tableEnd;
+    };
+    const rootEnd = sortedBoundaries[0] ?? lines.length;
+    collectAssignments(0, rootEnd, undefined);
+    for (const { index, header } of headers) {
+        const boundaryIndex = sortedBoundaries.findIndex((boundary) => boundary === index);
+        const end = boundaryIndex === -1
+            ? lines.length
+            : (sortedBoundaries[boundaryIndex + 1] ?? lines.length);
+        const tableScope = {
+            parsed: safeParseToml(lines.slice(index, end).join("\n")),
+            hasComment: sourceRangeHasTomlComment(source, index, end),
+        };
+        if (tableScope.parsed)
+            parsedStatementSpans.push({ start: index, end });
+        const insideManagedMarkerBlock = isInsideManagedMarkerBlock(index, end);
+        recordManagedMarkerHooksStateSourceSpan(markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, index, end, tableScope.parsed, insideManagedMarkerBlock);
+        const headerState = tomlHooksStateEntries(header.parsed);
+        const directKeys = Object.keys(headerState ?? {});
+        if (directKeys.length > 0) {
+            addManagedHookTrustStateSourceRepresentations(representations, markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, source, index, end, tableScope.parsed, insideManagedMarkerBlock, undefined, directKeys);
             continue;
         }
-        if (expectedState !== undefined) {
-            preservedConflictKeys.add(header.key);
+        collectAssignments(index + 1, end, lines[index], tableScope);
+    }
+    return {
+        source,
+        representations,
+        managedMarkerRanges,
+        markerContainedHooksStateSpans,
+        invalidMarkerContainedHooksStateSpans,
+        parsedStatementSpans,
+        parsedAssignmentSpans,
+    };
+}
+function isExactlyManagedHookTrustStateValue(value, expectedHashes) {
+    return isPlainTomlRecord(value) &&
+        Object.keys(value).length === 1 &&
+        Object.hasOwn(value, "trusted_hash") &&
+        typeof value.trusted_hash === "string" &&
+        expectedHashes.has(value.trusted_hash);
+}
+function managedMarkerTrustStateConflicts(source, representations, managedMarkerRanges, markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, parsedStatementSpans, parsedAssignmentSpans, expectations) {
+    const conflicts = new Set();
+    const isInsideManagedMarkerRange = (span) => managedMarkerRanges.some((range) => span.start > range.start && span.end <= range.end);
+    if (invalidMarkerContainedHooksStateSpans.some(isInsideManagedMarkerRange) ||
+        hasUnprovenManagedMarkerHooksStateSyntax(source, managedMarkerRanges, [...markerContainedHooksStateSpans, ...parsedStatementSpans], parsedAssignmentSpans)) {
+        conflicts.add("marker-contained hooks.state");
+    }
+    for (const [key, sourceRepresentations] of representations) {
+        for (const representation of sourceRepresentations) {
+            if (!isInsideManagedMarkerRange(representation))
+                continue;
+            const expectedHashes = expectedManagedHookTrustHashes(expectations, key, true);
+            const isExactOwnedRepresentation = expectedHashes !== undefined &&
+                representation.stateEntryCount === 1 &&
+                !representation.hasComment &&
+                representation.hasExactSemanticScope &&
+                isExactlyManagedHookTrustStateValue(representation.value, expectedHashes);
+            if (!source.isUnambiguous || !isExactOwnedRepresentation)
+                conflicts.add(key);
         }
-        kept.push(...lines.slice(i, tableEnd));
-        i = tableEnd;
     }
-    return { config: kept.join("\n"), preservedConflictKeys };
+    return conflicts;
 }
-function stripManagedCodexHookTrustStateWithResult(config, options = {}) {
-    const lines = config.split(/\r?\n/);
-    const kept = [];
-    for (let i = 0; i < lines.length;) {
-        const trimmed = lines[i].trim();
-        if (trimmed !== OMX_HOOK_TRUST_START_MARKER) {
-            kept.push(lines[i]);
-            i += 1;
+function removeEmptyManagedHookTrustStateMarkerBlocks(source, removed) {
+    const { lines } = source;
+    for (let start = 0; start < lines.length; start += 1) {
+        if (!source.lineStartsOutsideMultiline[start] ||
+            lines[start]?.trim() !== OMX_HOOK_TRUST_START_MARKER)
             continue;
+        const end = lines.findIndex((line, index) => index > start &&
+            source.lineStartsOutsideMultiline[index] &&
+            line.trim() === OMX_HOOK_TRUST_END_MARKER);
+        const nestedStart = lines.findIndex((line, index) => index > start &&
+            source.lineStartsOutsideMultiline[index] &&
+            line.trim() === OMX_HOOK_TRUST_START_MARKER);
+        if (end === -1 || (nestedStart !== -1 && nestedStart < end))
+            continue;
+        let onlyOwnedMarkerContent = true;
+        for (let index = start + 1; index < end; index += 1) {
+            const trimmed = lines[index].trim();
+            if (removed.has(index) ||
+                trimmed.length === 0 ||
+                trimmed === "# Trusts only setup-managed native hook wrappers.")
+                continue;
+            onlyOwnedMarkerContent = false;
+            break;
         }
-        const nextEndIdx = lines.findIndex((line, index) => index > i && line.trim() === OMX_HOOK_TRUST_END_MARKER);
-        const nextStartIdx = lines.findIndex((line, index) => index > i && line.trim() === OMX_HOOK_TRUST_START_MARKER);
-        if (nextEndIdx === -1 || (nextStartIdx !== -1 && nextStartIdx < nextEndIdx)) {
-            kept.push(lines[i]);
-            i += 1;
+        if (!onlyOwnedMarkerContent)
+            continue;
+        removed.add(start);
+        removed.add(end);
+        for (let index = start + 1; index < end; index += 1) {
+            if (lines[index]?.trim() === "# Trusts only setup-managed native hook wrappers.") {
+                removed.add(index);
+            }
+        }
+        start = end;
+    }
+}
+function stripProofManagedCodexHookTrustStateTables(config, expectations) {
+    const { source, representations, managedMarkerRanges, markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, parsedStatementSpans, parsedAssignmentSpans, } = collectManagedHookTrustStateSourceRepresentations(config);
+    const preservedConflictKeys = managedMarkerTrustStateConflicts(source, representations, managedMarkerRanges, markerContainedHooksStateSpans, invalidMarkerContainedHooksStateSpans, parsedStatementSpans, parsedAssignmentSpans, expectations);
+    if (!source.isUnambiguous) {
+        return { config, preservedConflictKeys };
+    }
+    const { lines } = source;
+    const removals = new Map();
+    const parsedConfigState = tomlHooksStateEntries(safeParseToml(config));
+    for (const key of Object.keys(parsedConfigState ?? {})) {
+        if (expectations.has(key) && !representations.has(key)) {
+            preservedConflictKeys.add(key);
+        }
+    }
+    for (const [key, sourceRepresentations] of representations) {
+        const isExactOwnedRepresentation = (representation) => {
+            const expectedHashes = expectedManagedHookTrustHashes(expectations, key, representation.insideManagedMarkerBlock);
+            return expectedHashes !== undefined &&
+                representation.stateEntryCount === 1 &&
+                !representation.hasComment &&
+                representation.hasExactSemanticScope &&
+                isExactlyManagedHookTrustStateValue(representation.value, expectedHashes);
+        };
+        if (!sourceRepresentations.some((representation) => expectedManagedHookTrustHashes(expectations, key, representation.insideManagedMarkerBlock) !== undefined))
+            continue;
+        const mayRemoveAll = sourceRepresentations.length === 1
+            ? isExactOwnedRepresentation(sourceRepresentations[0])
+            : sourceRepresentations.every((representation) => representation.insideManagedMarkerBlock &&
+                isExactOwnedRepresentation(representation));
+        if (!mayRemoveAll) {
+            preservedConflictKeys.add(key);
             continue;
         }
-        i = nextEndIdx + 1;
+        for (const representation of sourceRepresentations) {
+            removals.set(`${representation.start}:${representation.end}`, {
+                start: representation.start,
+                end: representation.end,
+            });
+        }
+    }
+    if (removals.size === 0) {
+        return { config, preservedConflictKeys };
+    }
+    const removed = new Set();
+    for (const range of removals.values()) {
+        for (let index = range.start; index < range.end; index += 1) {
+            removed.add(index);
+        }
     }
-    const withoutFenced = kept.join("\n");
-    const proofStripped = options.managedTrustState
-        ? stripProofManagedCodexHookTrustStateTables(withoutFenced, options.managedTrustState)
-        : { config: withoutFenced, preservedConflictKeys: new Set() };
+    removeEmptyManagedHookTrustStateMarkerBlocks(source, removed);
     return {
-        config: proofStripped.config.replace(/\n{3,}/g, "\n\n").trimEnd(),
-        preservedConflictKeys: proofStripped.preservedConflictKeys,
+        config: lines.filter((_, index) => !removed.has(index)).join("\n").trimEnd(),
+        preservedConflictKeys,
     };
 }
+function stripManagedCodexHookTrustStateForRefresh(config, priorManagedTrustState, finalManagedTrustState) {
+    return stripProofManagedCodexHookTrustStateTables(config, managedHookTrustStateExpectations(priorManagedTrustState, finalManagedTrustState));
+}
+function rejectManagedCodexHookTrustStateConflicts(conflicts) {
+    if (conflicts.size === 0)
+        return;
+    const keys = [...conflicts].sort((left, right) => left.localeCompare(right));
+    throw new ManagedCodexHooksPlanError("managed_trust_key_conflict", `Refusing to replace existing Codex hook trust state for ${keys.join(", ")}. Remove or reconcile the conflicting [hooks.state] entry before running setup.`, { keys });
+}
 export function stripManagedCodexHookTrustState(config, options = {}) {
-    return stripManagedCodexHookTrustStateWithResult(config, options).config;
+    const stripped = stripManagedCodexHookTrustStateForRefresh(config, options.priorManagedHookTrustState, options.managedTrustState ?? {});
+    rejectManagedCodexHookTrustStateConflicts(stripped.preservedConflictKeys);
+    return stripped.config;
 }
-function renderManagedCodexHookTrustToml(managedTrustState, excludedKeys = new Set()) {
+function renderManagedCodexHookTrustToml(managedTrustState) {
     return Object.entries(managedTrustState)
-        .filter(([key]) => !excludedKeys.has(key))
         .sort(([left], [right]) => left.localeCompare(right))
         .flatMap(([key, hookState]) => [
         `[hooks.state."${escapeTomlBasicString(key)}"]`,
@@ -829,21 +1642,92 @@ function renderManagedCodexHookTrustToml(managedTrustState, excludedKeys = new S
         .join("\n")
         .trimEnd();
 }
-function buildManagedCodexHookTrustStateForConfig(codexHooksFile, pkgRoot, options = {}) {
+function identicalLegacyHookTrustStateEntry(existing, expected) {
+    if (!isPlainTomlRecord(existing))
+        return false;
+    if (!Object.hasOwn(existing, "trusted_hash") ||
+        typeof existing.trusted_hash !== "string" ||
+        existing.trusted_hash !== expected.trusted_hash ||
+        Object.keys(existing).some((key) => key !== "trusted_hash" && key !== "enabled")) {
+        return false;
+    }
+    return Object.hasOwn(existing, "enabled") === Object.hasOwn(expected, "enabled") &&
+        existing.enabled === expected.enabled;
+}
+function legacyHookTrustStateConflict(keys, reason) {
+    throw new ManagedCodexHooksPlanError("managed_trust_key_conflict", `Refusing to migrate legacy Codex hook trust state into conflicting config.toml entries for ${keys.join(", ")}.`, { keys: [...keys], ...(reason ? { reason } : {}) });
+}
+function appendLegacyHookTrustState(config, legacyTrustState) {
+    if (!legacyTrustState || Object.keys(legacyTrustState).length === 0) {
+        return config;
+    }
+    const parsed = safeParseToml(config);
+    const keys = Object.keys(legacyTrustState).sort((left, right) => left.localeCompare(right));
+    if (!parsed)
+        legacyHookTrustStateConflict(keys, "config_parse_failure");
+    const hooks = parsed.hooks;
+    if (hooks !== undefined && !isPlainTomlRecord(hooks)) {
+        legacyHookTrustStateConflict(keys, "hooks_table_invalid");
+    }
+    const hookState = isPlainTomlRecord(hooks) ? hooks.state : undefined;
+    if (hookState !== undefined && !isPlainTomlRecord(hookState)) {
+        legacyHookTrustStateConflict(keys, "hooks_state_table_invalid");
+    }
+    const existingTrustState = isPlainTomlRecord(hookState) ? hookState : {};
+    const entriesToAppend = Object.entries(legacyTrustState)
+        .filter(([key]) => !Object.hasOwn(existingTrustState, key));
+    const conflictingKeys = Object.entries(legacyTrustState)
+        .filter(([key, expected]) => Object.hasOwn(existingTrustState, key) &&
+        !identicalLegacyHookTrustStateEntry(existingTrustState[key], expected))
+        .map(([key]) => key)
+        .sort((left, right) => left.localeCompare(right));
+    if (conflictingKeys.length > 0)
+        legacyHookTrustStateConflict(conflictingKeys);
+    const trustToml = entriesToAppend
+        .sort(([left], [right]) => left.localeCompare(right))
+        .flatMap(([key, state]) => [
+        `[hooks.state."${escapeTomlBasicString(key)}"]`,
+        `trusted_hash = "${escapeTomlBasicString(state.trusted_hash)}"`,
+        ...(typeof state.enabled === "boolean" ? [`enabled = ${state.enabled}`] : []),
+        "",
+    ])
+        .join("\n")
+        .trimEnd();
+    if (!trustToml)
+        return config;
+    const base = config.trimEnd();
+    return [
+        base,
+        base ? "" : null,
+        "# Migrated from legacy hooks.json state; kept in Codex config.toml because Codex 0.140 rejects top-level hooks.json state.",
+        trustToml,
+        "",
+    ].filter((line) => line !== null).join("\n");
+}
+function managedCodexHookOptionsFromMergeOptions(options) {
+    return {
+        codexHomeDir: options.codexHomeDir,
+        platform: options.hookCommandPlatform,
+        hooksContent: options.codexHooksContent,
+    };
+}
+function buildManagedCodexHookTrustStateForConfig(codexHooksFile, pkgRoot, options = {}, precomputedTrustState) {
+    if (precomputedTrustState)
+        return precomputedTrustState;
     if (!codexHooksFile)
         return {};
     return buildManagedCodexHookTrustState(codexHooksFile, pkgRoot, options);
 }
 export function upsertManagedCodexHookTrustState(config, pkgRoot, codexHooksFile, options = {}) {
-    const managedTrustState = buildManagedCodexHookTrustStateForConfig(codexHooksFile, pkgRoot, options);
-    const strippedResult = stripManagedCodexHookTrustStateWithResult(config, {
-        managedTrustState,
-    });
-    const stripped = strippedResult.config;
-    const hookTrustToml = renderManagedCodexHookTrustToml(managedTrustState, strippedResult.preservedConflictKeys);
-    if (!hookTrustToml)
-        return `${stripped}\n`;
-    return [
+    const managedTrustState = buildManagedCodexHookTrustStateForConfig(codexHooksFile, pkgRoot, options, options.managedTrustState);
+    const strippedResult = stripManagedCodexHookTrustStateForRefresh(config, options.priorManagedHookTrustState, managedTrustState);
+    rejectManagedCodexHookTrustStateConflicts(strippedResult.preservedConflictKeys);
+    const stripped = strippedResult.config.trimEnd();
+    const hookTrustToml = renderManagedCodexHookTrustToml(managedTrustState);
+    if (!hookTrustToml) {
+        return appendLegacyHookTrustState(`${stripped}\n`, options.legacyHookTrustState);
+    }
+    return appendLegacyHookTrustState([
         stripped,
         "",
         OMX_HOOK_TRUST_START_MARKER,
@@ -851,7 +1735,7 @@ export function upsertManagedCodexHookTrustState(config, pkgRoot, codexHooksFile
         hookTrustToml,
         OMX_HOOK_TRUST_END_MARKER,
         "",
-    ].filter((line, index) => index !== 0 || line.length > 0).join("\n");
+    ].filter((line, index) => index !== 0 || line.length > 0).join("\n"), options.legacyHookTrustState);
 }
 export function upsertPluginModeRuntimeFeatureFlags(config, codexHookFeatureFlag = DEFAULT_CODEX_HOOK_FEATURE_FLAG, options = {}) {
     const lines = config.split(/\r?\n/);
@@ -864,6 +1748,9 @@ export function upsertPluginModeRuntimeFeatureFlags(config, codexHookFeatureFlag
         const featureBlock = [
             "[features]",
             hookFeatureFlagLine,
+            ...(options.pluginScopedHooks && options.preserveNativeHooks
+                ? [formatCodexHookFeatureFlagLine(codexHookFeatureFlag)]
+                : []),
             "goals = true",
             "",
         ].join("\n");
@@ -887,9 +1774,15 @@ export function upsertPluginModeRuntimeFeatureFlags(config, codexHookFeatureFlag
             sectionEnd -= 1;
         }
     }
-    ({ sectionEnd } = options.pluginScopedHooks
-        ? upsertPluginScopedHookFeatureFlagInSection(lines, featuresStart, sectionEnd)
-        : upsertCodexHookFeatureFlagInSection(lines, featuresStart, sectionEnd, codexHookFeatureFlag));
+    if (options.pluginScopedHooks) {
+        ({ sectionEnd } = upsertPluginScopedHookFeatureFlagInSection(lines, featuresStart, sectionEnd));
+        if (options.preserveNativeHooks) {
+            ({ sectionEnd } = upsertCodexHookFeatureFlagInSection(lines, featuresStart, sectionEnd, codexHookFeatureFlag));
+        }
+    }
+    else {
+        ({ sectionEnd } = upsertCodexHookFeatureFlagInSection(lines, featuresStart, sectionEnd, codexHookFeatureFlag));
+    }
     let goalsIdx = -1;
     for (let i = featuresStart + 1; i < sectionEnd; i++) {
         if (/^\s*goals\s*=/.test(lines[i])) {
@@ -1015,52 +1908,12 @@ function upsertEnvSettings(config) {
     }
     return lines.join("\n");
 }
-function upsertAgentsSettings(config) {
-    const lines = config.split(/\r?\n/);
-    const agentsStart = lines.findIndex((line) => /^\s*\[agents\]\s*$/.test(line));
-    if (agentsStart < 0) {
-        const base = config.trimEnd();
-        const agentsBlock = [
-            "[agents]",
-            `max_threads = ${OMX_AGENTS_MAX_THREADS}`,
-            `max_depth = ${OMX_AGENTS_MAX_DEPTH}`,
-            "",
-        ].join("\n");
-        if (base.length === 0)
-            return agentsBlock;
-        return `${base}\n\n${agentsBlock}`;
-    }
-    let sectionEnd = lines.length;
-    for (let i = agentsStart + 1; i < lines.length; i++) {
-        if (/^\s*\[\[?[^\]]+\]?\]\s*$/.test(lines[i])) {
-            sectionEnd = i;
-            break;
-        }
-    }
-    let maxThreadsIdx = -1;
-    let maxDepthIdx = -1;
-    for (let i = agentsStart + 1; i < sectionEnd; i++) {
-        if (/^\s*max_threads\s*=/.test(lines[i])) {
-            maxThreadsIdx = i;
-        }
-        else if (/^\s*max_depth\s*=/.test(lines[i])) {
-            maxDepthIdx = i;
-        }
-    }
-    if (maxThreadsIdx < 0) {
-        lines.splice(sectionEnd, 0, `max_threads = ${OMX_AGENTS_MAX_THREADS}`);
-        sectionEnd += 1;
-    }
-    if (maxDepthIdx < 0) {
-        lines.splice(sectionEnd, 0, `max_depth = ${OMX_AGENTS_MAX_DEPTH}`);
-    }
-    return lines.join("\n");
-}
 /**
  * Remove OMX-owned feature flags from the [features] section.
+ * If `preserveMultiAgent` is set, retain multi_agent unchanged.
  * If the section becomes empty after removal, remove the section header too.
  */
-export function stripOmxFeatureFlags(config) {
+export function stripOmxFeatureFlags(config, options = {}) {
     const lines = config.split(/\r?\n/);
     const featuresStart = lines.findIndex((line) => /^\s*\[features\]\s*$/.test(line));
     if (featuresStart < 0)
@@ -1073,7 +1926,7 @@ export function stripOmxFeatureFlags(config) {
         }
     }
     const omxFlags = [
-        "multi_agent",
+        ...(options.preserveMultiAgent ? [] : ["multi_agent"]),
         "child_agents_md",
         "hooks",
         "codex_hooks",
@@ -1139,10 +1992,6 @@ export function stripOmxEnvSettings(config) {
 // ---------------------------------------------------------------------------
 // Orphaned OMX table sections (no marker block)
 // ---------------------------------------------------------------------------
-/**
- * Check whether a TOML table name belongs to a legacy OMX-managed agent entry.
- * Handles both `agents.name` and `agents."name"` forms.
- */
 function isOmxFirstPartyMcpSection(tableName) {
     const match = tableName.match(/^mcp_servers\.(?:"([^"]+)"|([A-Za-z0-9_-]+))$/);
     const name = match?.[1] ?? match?.[2];
@@ -1150,20 +1999,10 @@ function isOmxFirstPartyMcpSection(tableName) {
         (OMX_FIRST_PARTY_MCP_SERVER_NAMES.includes(name) ||
             name === "omx_team_run"));
 }
-function isLegacyOmxAgentSection(tableName) {
-    const m = tableName.match(/^agents\.(?:"([^"]+)"|(\w[\w-]*))$/);
-    if (!m)
-        return false;
-    const name = m[1] || m[2] || "";
-    return Object.prototype.hasOwnProperty.call(AGENT_DEFINITIONS, name);
-}
 /**
- * Strip OMX-owned table sections that exist outside the marker block.
+ * Strip first-party OMX MCP table sections that exist outside the marker block.
  * This covers legacy configs that were written before markers were added,
  * or configs where the marker was accidentally removed.
- *
- * Targets: exact first-party [mcp_servers.<name>] entries, retired
- * [mcp_servers.omx_team_run], and legacy [agents.<name>] entries.
  */
 function stripOrphanedOmxSections(config) {
     const lines = config.split(/\r?\n/);
@@ -1177,8 +2016,7 @@ function stripOrphanedOmxSections(config) {
             // Note: [tui] is NOT stripped here because it could be user-owned.
             // The marker-based stripExistingOmxBlocks already handles [tui]
             // when it lives inside the OMX marker block.
-            const isOmxSection = isOmxFirstPartyMcpSection(tableName) ||
-                isLegacyOmxAgentSection(tableName);
+            const isOmxSection = isOmxFirstPartyMcpSection(tableName);
             if (isOmxSection) {
                 // Remove preceding OMX comment lines and blank lines
                 while (result.length > 0) {
@@ -1408,35 +2246,45 @@ function upsertTuiStatusLine(config, preset = DEFAULT_STATUS_LINE_PRESET, option
 // ---------------------------------------------------------------------------
 // OMX [table] sections block (appended at end of file)
 // ---------------------------------------------------------------------------
-export function stripExistingOmxBlocks(config) {
-    let cleaned = config;
-    let removed = 0;
-    while (true) {
-        const markerIdx = cleaned.indexOf(OMX_CONFIG_MARKER);
-        if (markerIdx < 0)
-            break;
-        let blockStart = cleaned.lastIndexOf("\n", markerIdx);
-        blockStart = blockStart >= 0 ? blockStart + 1 : 0;
-        const previousLineEnd = blockStart - 1;
-        if (previousLineEnd >= 0) {
-            const previousLineStart = cleaned.lastIndexOf("\n", previousLineEnd - 1);
-            const previousLine = cleaned.slice(previousLineStart + 1, previousLineEnd);
-            if (/^# =+$/.test(previousLine.trim())) {
-                blockStart = previousLineStart >= 0 ? previousLineStart + 1 : 0;
-            }
-        }
-        let blockEnd = cleaned.length;
-        const endIdx = cleaned.indexOf(OMX_CONFIG_END_MARKER, markerIdx);
-        if (endIdx >= 0) {
-            const endLineBreak = cleaned.indexOf("\n", endIdx);
-            blockEnd = endLineBreak >= 0 ? endLineBreak + 1 : cleaned.length;
-        }
-        const before = cleaned.slice(0, blockStart).trimEnd();
-        const after = cleaned.slice(blockEnd).trimStart();
-        cleaned = [before, after].filter(Boolean).join("\n\n");
-        removed += 1;
-    }
-    return { cleaned, removed };
+export function stripExistingOmxBlocks(config, options = {}) {
+    const inventory = collectManagedHookTrustStateSourceRepresentations(config);
+    const { source } = inventory;
+    const markerRanges = collectMarkerRanges(source, OMX_CONFIG_START_MARKER, OMX_CONFIG_END_MARKER, false, inventory.parsedAssignmentSpans);
+    if (markerRanges.length === 0)
+        return { cleaned: config, removed: 0 };
+    const conflicts = managedMarkerTrustStateConflicts(source, inventory.representations, markerRanges, inventory.markerContainedHooksStateSpans, inventory.invalidMarkerContainedHooksStateSpans, inventory.parsedStatementSpans, inventory.parsedAssignmentSpans, managedHookTrustStateExpectations(options.priorManagedHookTrustState, options.managedTrustState));
+    rejectManagedCodexHookTrustStateConflicts(conflicts);
+    if (!source.isUnambiguous)
+        return { cleaned: config, removed: 0 };
+    const lines = sourceLines(config);
+    if (markerRanges.some((range) => !lines[range.start] || !lines[range.end])) {
+        return { cleaned: config, removed: 0 };
+    }
+    const removalRanges = markerRanges.map((range) => {
+        const startLine = lines[range.start];
+        const endLine = lines[range.end];
+        const previousLine = lines[range.start - 1];
+        const start = previousLine && /^# =+$/.test(previousLine.content.trim())
+            ? previousLine.start
+            : startLine.start;
+        return { start, end: endLine.end };
+    });
+    const segments = [];
+    let cursor = 0;
+    for (const range of removalRanges) {
+        segments.push(config.slice(cursor, range.start));
+        cursor = range.end;
+    }
+    segments.push(config.slice(cursor));
+    const cleaned = segments
+        .map((segment, index) => index === 0
+        ? segment.trimEnd()
+        : index === segments.length - 1
+            ? segment.trimStart()
+            : segment.trim())
+        .filter(Boolean)
+        .join("\n\n");
+    return { cleaned, removed: markerRanges.length };
 }
 export function stripExistingSharedMcpRegistryBlock(config) {
     let cleaned = config;
@@ -1671,7 +2519,7 @@ export function mergeSharedMcpRegistryBlock(config, servers, sourcePath) {
  * OMX table-section block (MCP servers, TUI).
  * Contains ONLY [table] sections — no bare keys.
  */
-function getOmxTablesBlock(pkgRoot, includeTui = true, statusLinePreset = DEFAULT_STATUS_LINE_PRESET, codexHooksFile, hookOptions = {}, includeFirstPartyMcp = false, excludedHookTrustStateKeys = new Set()) {
+function getOmxTablesBlock(pkgRoot, includeTui = true, statusLinePreset = DEFAULT_STATUS_LINE_PRESET, codexHooksFile, hookOptions = {}, managedHookTrustState, includeFirstPartyMcp = false) {
     const lines = [
         "",
         "# ============================================================",
@@ -1694,7 +2542,7 @@ function getOmxTablesBlock(pkgRoot, includeTui = true, statusLinePreset = DEFAUL
             }
         }
     }
-    const hookTrustToml = renderManagedCodexHookTrustToml(buildManagedCodexHookTrustStateForConfig(codexHooksFile, pkgRoot, hookOptions), excludedHookTrustStateKeys);
+    const hookTrustToml = renderManagedCodexHookTrustToml(buildManagedCodexHookTrustStateForConfig(codexHooksFile, pkgRoot, hookOptions, managedHookTrustState));
     if (hookTrustToml) {
         lines.push("");
         lines.push("# OMX-owned Codex hook trust state");
@@ -1726,13 +2574,17 @@ function getOmxTablesBlock(pkgRoot, includeTui = true, statusLinePreset = DEFAUL
  *
  * Layout:
  *   1. OMX top-level keys (notify, model_reasoning_effort, developer_instructions)
- *   2. [features] with multi_agent + child_agents_md + hooks + goals
+ *   2. [features] with child_agents_md + hooks + goals
  *   3. [shell_environment_policy.set] with defaulted deprecated explore-routing opt-out
  *   4. … user sections …
  *   5. OMX [table] sections (mcp_servers, tui)
  */
 export function buildMergedConfig(existingConfig, pkgRoot, options = {}) {
-    let existing = existingConfig;
+    let existing = stripOmxSeededBehavioralDefaults(existingConfig);
+    const hookOptions = managedCodexHookOptionsFromMergeOptions(options);
+    const managedTrustState = buildManagedCodexHookTrustStateForConfig(options.codexHooksFile, pkgRoot, hookOptions, options.managedHookTrustState);
+    const preflightHookTrustStrip = stripManagedCodexHookTrustStateForRefresh(existing, options.priorManagedHookTrustState, managedTrustState);
+    rejectManagedCodexHookTrustStateConflicts(preflightHookTrustStrip.preservedConflictKeys);
     const preservedFirstPartyMcpSections = options.preserveExistingFirstPartyMcp === true &&
         options.includeFirstPartyMcp !== true
         ? extractFirstPartyOmxMcpSections(existing)
@@ -1741,7 +2593,10 @@ export function buildMergedConfig(existingConfig, pkgRoot, options = {}) {
     const statusLinePreset = options.statusLinePreset ?? DEFAULT_STATUS_LINE_PRESET;
     const customizedManagedTuiSections = extractCustomizedTuiSectionsFromOmxBlocks(existing);
     if (existing.includes(OMX_CONFIG_MARKER)) {
-        const stripped = stripExistingOmxBlocks(existing);
+        const stripped = stripExistingOmxBlocks(existing, {
+            managedTrustState,
+            priorManagedHookTrustState: options.priorManagedHookTrustState,
+        });
         existing = stripped.cleaned;
         if (customizedManagedTuiSections.length > 0) {
             existing = `${existing.trimEnd()}\n\n${customizedManagedTuiSections.join("\n\n")}\n`;
@@ -1755,18 +2610,13 @@ export function buildMergedConfig(existingConfig, pkgRoot, options = {}) {
         !isOmxManagedNotifyCommand(getRootTomlArray(existing, "notify"), pkgRoot)
         ? getRootTomlArray(existing, "notify")
         : null;
-    existing = stripOmxTopLevelKeys(existing);
+    existing = stripOmxTopLevelKeys(existing).trimStart();
     if (userNotifyToPreserve) {
         existing = `${`notify = ${formatTomlStringArray(userNotifyToPreserve)}`}\n${existing.trimStart()}`;
     }
-    existing = stripOrphanedManagedNotify(existing, pkgRoot);
-    const managedTrustState = buildManagedCodexHookTrustStateForConfig(options.codexHooksFile, pkgRoot, {
-        codexHomeDir: options.codexHomeDir,
-        platform: options.hookCommandPlatform,
-    });
-    const hookTrustStrip = stripManagedCodexHookTrustStateWithResult(existing, {
-        managedTrustState,
-    });
+    existing = stripOrphanedManagedNotify(existing, pkgRoot).trimStart();
+    const hookTrustStrip = stripManagedCodexHookTrustStateForRefresh(existing, options.priorManagedHookTrustState, managedTrustState);
+    rejectManagedCodexHookTrustStateConflicts(hookTrustStrip.preservedConflictKeys);
     existing = hookTrustStrip.config;
     if (options.modelOverride) {
         existing = stripRootLevelKeys(existing, ["model"]);
@@ -1777,7 +2627,6 @@ export function buildMergedConfig(existingConfig, pkgRoot, options = {}) {
     }
     existing = upsertFeatureFlags(existing, options.codexHookFeatureFlag);
     existing = upsertEnvSettings(existing);
-    existing = upsertAgentsSettings(existing);
     const tuiUpsert = includeTui
         ? upsertTuiStatusLine(existing, statusLinePreset, {
             forceStatusLinePreset: options.forceStatusLinePreset,
@@ -1787,16 +2636,15 @@ export function buildMergedConfig(existingConfig, pkgRoot, options = {}) {
     const topLines = getOmxTopLevelLines(pkgRoot, existing, options.modelOverride, options.notifyCommand === undefined
         ? getDefaultNotifyCommand(pkgRoot)
         : options.notifyCommand);
-    const tablesBlock = getOmxTablesBlock(pkgRoot, includeTui && !tuiUpsert.hadExistingTui, statusLinePreset, options.codexHooksFile, {
-        codexHomeDir: options.codexHomeDir,
-        platform: options.hookCommandPlatform,
-    }, options.includeFirstPartyMcp === true, hookTrustStrip.preservedConflictKeys);
+    const tablesBlock = getOmxTablesBlock(pkgRoot, includeTui && !tuiUpsert.hadExistingTui, statusLinePreset, options.codexHooksFile, hookOptions, managedTrustState, options.includeFirstPartyMcp === true);
     const sharedRegistryBlock = getSharedMcpRegistryBlock(options.sharedMcpServers ?? [], options.sharedMcpRegistrySource, existing);
-    let body = existing.trimEnd();
+    let body = existing.trim();
     if (sharedRegistryBlock) {
         body = body ? `${body}\n\n${sharedRegistryBlock}` : sharedRegistryBlock;
     }
-    return addDefaultLauncherMcpStartupTimeouts(topLines.join("\n") + "\n\n" + body + "\n" + tablesBlock);
+    const bodySeparator = body.length > 0 && !/^\s*\[/.test(body) ? "\n" : "\n\n";
+    const merged = addDefaultLauncherMcpStartupTimeouts(topLines.join("\n") + bodySeparator + body + "\n" + tablesBlock);
+    return appendLegacyHookTrustState(merged, options.legacyHookTrustState);
 }
 /**
  * Detect and repair upgrade-era managed config incompatibilities in config.toml.
@@ -1809,6 +2657,33 @@ export function buildMergedConfig(existingConfig, pkgRoot, options = {}) {
  *
  * Returns `true` if a repair was performed.
  */
+function managedHookTrustProofRequiredForRepair(config) {
+    const inventory = collectManagedHookTrustStateSourceRepresentations(config);
+    return managedMarkerTrustStateConflicts(inventory.source, inventory.representations, inventory.managedMarkerRanges, inventory.markerContainedHooksStateSpans, inventory.invalidMarkerContainedHooksStateSpans, inventory.parsedStatementSpans, inventory.parsedAssignmentSpans, managedHookTrustStateExpectations()).size > 0;
+}
+async function launchRepairOptionsWithManagedHookTrustProof(configPath, config, options) {
+    if (!managedHookTrustProofRequiredForRepair(config)) {
+        return options;
+    }
+    const hooksPath = options.codexHooksFile ?? resolve(configPath, "..", "hooks.json");
+    let hooksContent;
+    try {
+        hooksContent = await readFile(hooksPath, "utf-8");
+    }
+    catch (error) {
+        throw new ManagedCodexHooksPlanError("invalid_document", `Cannot safely repair config.toml because the current hooks artifact at ${hooksPath} could not be read.`, { cause: String(error), hooksPath });
+    }
+    const trustScan = scanManagedCodexHookTrustStateFromContent(hooksContent, hooksPath, managedCodexHookOptionsFromMergeOptions(options));
+    if (!trustScan.ok)
+        throw trustScan.error;
+    return {
+        ...options,
+        codexHooksFile: hooksPath,
+        codexHooksContent: hooksContent,
+        managedHookTrustState: trustScan.trustState,
+        priorManagedHookTrustState: trustScan.trustState,
+    };
+}
 export async function repairConfigIfNeeded(configPath, pkgRoot, options = {}) {
     if (!existsSync(configPath))
         return false;
@@ -1818,8 +2693,10 @@ export async function repairConfigIfNeeded(configPath, pkgRoot, options = {}) {
     const hasLauncherTimeoutGap = findLauncherTimeoutRepairTargets(content).length > 0;
     if (tuiCount <= 1 && !hasLegacyTeamRunTable && !hasLauncherTimeoutGap)
         return false;
-    // Managed config compatibility issue detected — run full merge to repair
-    const repaired = buildMergedConfig(content, pkgRoot, options);
+    // Managed config compatibility issue detected — derive proof from the current
+    // hooks artifact before any marker stripping can replace managed trust state.
+    const repairOptions = await launchRepairOptionsWithManagedHookTrustProof(configPath, content, options);
+    const repaired = buildMergedConfig(content, pkgRoot, repairOptions);
     if (repaired === content)
         return false;
     await writeFile(configPath, repaired);
@@ -1830,12 +2707,6 @@ export async function mergeConfig(configPath, pkgRoot, options = {}) {
     if (existsSync(configPath)) {
         existing = await readFile(configPath, "utf-8");
     }
-    if (existing.includes("oh-my-codex (OMX) Configuration")) {
-        const stripped = stripExistingOmxBlocks(existing);
-        if (options.verbose && stripped.removed > 0) {
-            console.log("  Updating existing OMX config block.");
-        }
-    }
     const finalConfig = buildMergedConfig(existing, pkgRoot, options);
     await writeFile(configPath, finalConfig);
     if (options.verbose) {