@iamdevlinph/codex-kit 1.0.12 → 1.0.14

package/LICENSE

@@ -0,0 +1,18 @@
+This license applies only to files included in the published
+@iamdevlinph/codex-kit npm package. It does not apply to repository-only files.
+
+ISC License
+
+Copyright (c) 2026 Devlin Pajaron
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -143,47 +143,41 @@ hooks. Modified managed files are preserved unless `--force` is supplied.
 
 ## Apply to a project
 
-For a project without `AGENTS.md`:
+### First-time setup
+
+For a new blank project, scaffold its initial stack first. Then initialize
+codex-kit once from the project root:
 
 ```sh
 cd /path/to/project
 pnpm dlx @iamdevlinph/codex-kit@latest project init
 ```
 
-This creates:
+`project init` performs the initial template sync, so do not run `project sync`
+immediately afterward. It creates or updates:
 
-- `AGENTS.md`, containing a project-specific section ready for reconciliation
+- `AGENTS.md`, only when missing; an existing file is preserved
 - `TEMPLATE_AGENTS.md`, a local reference copy used for future comparisons
 - `.codex-kit-state.json`, reconciliation bookkeeping
 
-Add repository commands, paths, architecture, integrations, and exceptions to
-the project-specific section of `AGENTS.md`.
-
-### Generate project-specific guidance
+If `AGENTS.md` is missing or still contains only the untouched codex-kit
+scaffold, the CLI prints a clearly marked initialization prompt. Copy everything
+between `BEGIN CODEX INITIALIZATION PROMPT` and
+`END CODEX INITIALIZATION PROMPT` into a Codex task opened at the project root.
+The prompt asks Codex to verify that the project has enough substantive code,
+dependencies, configuration, and scripts to derive reliable guidance. If not,
+Codex stops without inventing rules or marking the template applied. Finish
+scaffolding the project, rerun `project init`, and send the new CLI prompt.
 
-For an existing project, use this prompt after initialization. For a new
-project, scaffold the initial stack first.
-
-```txt
-Explore this repository before changing code. Identify its languages,
-frameworks, package manager, scripts, directory structure, styling and component
-systems, form and validation libraries, data-access patterns, testing tools, and
-generated files.
-
-Update only the project-specific section of AGENTS.md with concise guidelines
-derived from the repository's actual dependencies, configuration, scripts, and
-established code patterns. Include exact verification commands. Preserve the
-managed shared-template block, avoid speculative preferences, and do not add
-rules for tools the repository does not use.
-```
+When `AGENTS.md` already contains guidance, `project init` preserves it and
+prints the reconciliation prompt described below instead.
 
 ## Synchronize template updates
 
-Refresh a project's local template reference:
+After a newer codex-kit template is released, refresh an initialized project:
 
 ```sh
 pnpm dlx @iamdevlinph/codex-kit@latest project sync
-codex-kit project status
 ```
 
 `project sync` never edits `AGENTS.md` or project skills. It routes Codex to the
@@ -195,10 +189,17 @@ database, deployment, and destructive-operation rules remain in `AGENTS.md`;
 do not copy the complete template or introduce managed markers. After semantic
 reconciliation and validation, record the applied template hash:
 
+The CLI prints a clearly marked reconciliation prompt. Copy everything between
+`BEGIN CODEX RECONCILIATION PROMPT` and `END CODEX RECONCILIATION PROMPT` into a
+Codex task opened at the project root. That prompt tells Codex to validate and
+then run:
+
 ```sh
 codex-kit project mark-applied
 ```
 
+You normally do not run that command manually.
+
 `mark-applied` updates only `.codex-kit-state.json`; it does not validate or
 modify `AGENTS.md`.
 
@@ -244,8 +245,9 @@ standard-library modules.
 
 ## License
 
-`UNLICENSED`. Public availability on npm does not grant permission to reuse or
-redistribute the package beyond applicable law and npm's service terms.
+Files included in the published `@iamdevlinph/codex-kit` npm package are
+licensed under the [ISC License](LICENSE). Repository-only files remain
+proprietary and are not covered by that license.
 
 ## References
 

package/assets/TEMPLATE_AGENTS.md

@@ -113,6 +113,8 @@ conditional procedures into validated project skills.
   this rule. If automated coverage is impractical, explain why and perform the
   strongest targeted verification available.
 - Run the relevant focused tests after changing tested behavior.
+- When adding or updating dependencies, pin exact versions rather than ranges.
+  With pnpm, use `pnpm add -E` (`--save-exact`).
 - Do not change dependencies, global tools, or the environment by default.
 - Do not run local or remote database inspection, generation, migration, or SQL
   commands unless the task requires them.

package/bin/codex-kit.js

@@ -1,813 +1,61 @@
 #!/usr/bin/env node
-import { copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, readdirSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
-import { createHash } from "node:crypto";
-import { spawnSync } from "node:child_process";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-const isRecord = (value) => typeof value === "object" && value !== null;
-const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const ASSETS = join(ROOT, "assets");
-const AGENTS_DIR = join(ASSETS, "agents");
-const SKILLS_DIR = join(ASSETS, "skills");
-const RECONCILE_SKILL = "codex-kit-reconcile-agents";
-const RECONCILE_SKILL_FILE = join(SKILLS_DIR, RECONCILE_SKILL, "SKILL.md");
-const RECONCILE_SKILL_METADATA_FILE = join(SKILLS_DIR, RECONCILE_SKILL, "agents", "openai.yaml");
-const ROUTING_FILE = join(ASSETS, "SUBAGENT_ROUTING.md");
-const ROUTING_HOOK_FILE = join(ROOT, "bin", "routing-hook.js");
-const TEMPLATE_FILE = join(ASSETS, "TEMPLATE_AGENTS.md");
-const PACKAGE = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8"));
-const GLOBAL_BEGIN = "<!-- BEGIN codex-kit:subagent-routing -->";
-const GLOBAL_END = "<!-- END codex-kit:subagent-routing -->";
-const PROJECT_BEGIN = "<!-- BEGIN codex-kit:shared-template -->";
-const PROJECT_END = "<!-- END codex-kit:shared-template -->";
-const STATE_FILE = ".codex-kit-state.json";
-const PROJECT_STATE_FILE = ".codex-kit-state.json";
-const REGISTRY = PACKAGE.publishConfig?.registry ?? "https://registry.npmjs.org";
-const DEFAULT_ORCHESTRATOR = "gpt-5.6-sol";
-const DEFAULT_REASONING_EFFORT = "low";
-const DEFAULT_PLAN_REASONING_EFFORT = "high";
-const sha256 = (data) => createHash("sha256").update(data).digest("hex");
-const read = (file) => readFileSync(file);
-const readText = (file) => readFileSync(file, "utf8");
-function timestamp() {
-    return new Date().toISOString().replace(/[-:TZ.]/g, "");
-}
-function backup(file) {
-    if (!existsSync(file))
-        return null;
-    let destination = `${file}.codex-kit.bak-${timestamp()}`;
-    let suffix = 1;
-    while (existsSync(destination))
-        destination = `${file}.codex-kit.bak-${timestamp()}-${suffix++}`;
-    copyFileSync(file, destination);
-    console.log(`backup: ${destination}`);
-    return destination;
-}
-function write(file, data) {
-    mkdirSync(dirname(file), { recursive: true });
-    const temporary = `${file}.codex-kit.tmp-${process.pid}`;
-    writeFileSync(temporary, data);
-    renameSync(temporary, file);
-}
-function readJsonObject(file) {
-    if (!existsSync(file))
-        return {};
-    try {
-        const value = JSON.parse(readText(file));
-        if (isRecord(value))
-            return value;
-    }
-    catch {
-        // Use the actionable error below for invalid JSON and non-object roots.
-    }
-    throw new Error(`${file} must contain a JSON object; fix or move it before installing.`);
-}
-function shellQuote(value) {
-    return `'${value.replaceAll("'", `'"'"'`)}'`;
-}
-function hookCommands(file) {
-    return {
-        command: `/usr/bin/env node ${shellQuote(file)}`,
-        commandWindows: `node ${JSON.stringify(file)}`,
-    };
-}
-function removeHookHandlers(root, state) {
-    const hooks = root.hooks;
-    if (!isRecord(hooks))
-        return;
-    for (const [event, groupsValue] of Object.entries(hooks)) {
-        if (!Array.isArray(groupsValue))
-            continue;
-        const groups = groupsValue.flatMap((groupValue) => {
-            if (!isRecord(groupValue) || !Array.isArray(groupValue.hooks))
-                return [groupValue];
-            const handlers = groupValue.hooks.filter((handler) => {
-                if (!isRecord(handler))
-                    return true;
-                return handler.command !== state.command && handler.commandWindows !== state.commandWindows;
-            });
-            return handlers.length ? [{ ...groupValue, hooks: handlers }] : [];
-        });
-        if (groups.length)
-            hooks[event] = groups;
-        else
-            delete hooks[event];
-    }
-}
-function installRoutingHooks(home, previous) {
-    const target = join(home, "hooks.json");
-    const hookFile = join(home, "codex-kit", "routing-hook.js");
-    const commands = hookCommands(hookFile);
-    const created = previous?.created ?? !existsSync(target);
-    const root = readJsonObject(target);
-    if (previous)
-        removeHookHandlers(root, previous);
-    const hooks = isRecord(root.hooks) ? root.hooks : {};
-    root.hooks = hooks;
-    const handler = {
-        type: "command",
-        command: commands.command,
-        commandWindows: commands.commandWindows,
-        timeout: 5,
-    };
-    const promptGroups = Array.isArray(hooks.UserPromptSubmit) ? hooks.UserPromptSubmit : [];
-    hooks.UserPromptSubmit = [
-        ...promptGroups,
-        { hooks: [{ ...handler, statusMessage: "Loading subagent routing" }] },
-    ];
-    const startGroups = Array.isArray(hooks.SubagentStart) ? hooks.SubagentStart : [];
-    hooks.SubagentStart = [
-        ...startGroups,
-        { hooks: [{ ...handler, statusMessage: "Briefing delegated worker" }] },
-    ];
-    const updated = `${JSON.stringify(root, null, 2)}\n`;
-    const original = existsSync(target) ? readText(target) : "";
-    if (updated !== original) {
-        backup(target);
-        write(target, updated);
-        console.log(`updated: ${target}`);
-    }
-    return { target, ...commands, created };
-}
-function uninstallRoutingHooks(state) {
-    if (!existsSync(state.target)) {
-        console.warn(`preserved missing hooks file: ${state.target}`);
-        return;
-    }
-    const root = readJsonObject(state.target);
-    removeHookHandlers(root, state);
-    const hooks = root.hooks;
-    if (isRecord(hooks) && !Object.keys(hooks).length)
-        delete root.hooks;
-    backup(state.target);
-    if (state.created && !Object.keys(root).length)
-        rmSync(state.target);
-    else
-        write(state.target, `${JSON.stringify(root, null, 2)}\n`);
-    console.log(`removed managed routing hooks from: ${state.target}`);
-}
-function loadState(home) {
-    const file = join(home, STATE_FILE);
-    if (!existsSync(file))
-        return { version: PACKAGE.version, files: {} };
-    try {
-        const state = JSON.parse(readText(file));
-        return isRecord(state) && isRecord(state.files)
-            ? state
-            : { version: PACKAGE.version, files: {} };
-    }
-    catch {
-        throw new Error(`${file} is not valid JSON; move it aside before reinstalling.`);
-    }
-}
-function saveState(home, state) {
-    write(join(home, STATE_FILE), `${JSON.stringify(state, null, 2)}\n`);
-}
-function topLevelConfigEntries(contents) {
-    const entries = new Map();
-    let inTable = false;
-    for (const line of contents.split("\n")) {
-        if (/^\s*\[/.test(line)) {
-            inTable = true;
-            continue;
-        }
-        if (inTable)
-            continue;
-        const match = /^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
-        const key = match?.[2];
-        const value = match?.[3];
-        if (key && value !== undefined && !entries.has(key))
-            entries.set(key, { value, line });
-    }
-    return entries;
-}
-function tomlString(value) {
-    return JSON.stringify(value);
-}
-function setTopLevelConfig(contents, desired) {
-    const lines = contents.split("\n");
-    const seen = new Set();
-    let firstTable = lines.length;
-    for (let index = 0; index < lines.length; index++) {
-        const line = lines[index];
-        if (line !== undefined && /^\s*\[/.test(line)) {
-            firstTable = index;
-            break;
-        }
-    }
-    for (let index = 0; index < firstTable; index++) {
-        const line = lines[index];
-        if (line === undefined)
-            continue;
-        const match = /^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
-        const key = match?.[2];
-        if (!match || !key || seen.has(key))
-            continue;
-        lines[index] = `${match[1]}${key} = ${tomlString(desired[key])}`;
-        seen.add(key);
-    }
-    const missing = Object.keys(desired)
-        .filter((key) => !seen.has(key))
-        .map((key) => `${key} = ${tomlString(desired[key])}`);
-    if (missing.length)
-        lines.splice(0, 0, ...missing, "");
-    return lines.join("\n");
-}
-function restoreTopLevelConfig(contents, config) {
-    const desired = config.desired ?? {};
-    const previous = config.previous ?? {};
-    const lines = contents.split("\n");
-    let firstTable = lines.length;
-    for (let index = 0; index < lines.length; index++) {
-        const line = lines[index];
-        if (line !== undefined && /^\s*\[/.test(line)) {
-            firstTable = index;
-            break;
-        }
-    }
-    const restored = new Set();
-    for (let index = 0; index < firstTable; index++) {
-        const line = lines[index];
-        if (line === undefined)
-            continue;
-        const match = /^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
-        const key = match?.[2];
-        if (!match || !key || restored.has(key))
-            continue;
-        if (match[3] !== tomlString(desired[key]))
-            continue;
-        const prior = previous[key];
-        if (prior?.present) {
-            lines[index] = `${match[1]}${key} = ${prior.value}`;
-        }
-        else {
-            lines.splice(index, 1);
-            index--;
-            firstTable--;
-        }
-        restored.add(key);
-    }
-    if (Object.values(previous).some((entry) => entry && !entry.present) && lines[0] === "")
-        lines.shift();
-    return lines.join("\n");
-}
-function loadProjectState(cwd) {
-    const file = join(cwd, PROJECT_STATE_FILE);
-    if (!existsSync(file))
-        return { version: 1, template: {} };
-    try {
-        const state = JSON.parse(readText(file));
-        return isRecord(state) && isRecord(state.template)
-            ? state
-            : { version: 1, template: {} };
-    }
-    catch {
-        throw new Error(`${file} is not valid JSON; move it aside before syncing.`);
-    }
-}
-function saveProjectState(cwd, state) {
-    write(join(cwd, PROJECT_STATE_FILE), `${JSON.stringify(state, null, 2)}\n`);
-}
-function templatePrompt() {
-    return `Template reference updated. Use the global $${RECONCILE_SKILL} skill to reconcile it semantically.
+import{realpathSync as $e}from"node:fs";import{resolve as lo}from"node:path";import{fileURLToPath as co}from"node:url";import{copyFileSync as Ve,existsSync as m,mkdirSync as Xe,readdirSync as N,rmSync as A,statSync as ge}from"node:fs";import{join as f}from"node:path";import{createHash as Oe}from"node:crypto";import{copyFileSync as Ce,existsSync as H,mkdirSync as _e,readFileSync as Q,renameSync as Ne,writeFileSync as Ie}from"node:fs";import{dirname as Le}from"node:path";var k=o=>typeof o=="object"&&o!==null,E=o=>Oe("sha256").update(o).digest("hex"),y=o=>Q(o),g=o=>Q(o,"utf8");function S(o){if(!H(o))return null;let e=()=>new Date().toISOString().replace(/[-:TZ.]/g,""),t=`${o}.codex-kit.bak-${e()}`,n=1;for(;H(t);)t=`${o}.codex-kit.bak-${e()}-${n++}`;return Ce(o,t),console.log(`backup: ${t}`),t}function u(o,e){_e(Le(o),{recursive:!0});let t=`${o}.codex-kit.tmp-${process.pid}`;Ie(t,e),Ne(t,o)}function K(o){if(!H(o))return{};try{let e=JSON.parse(g(o));if(k(e))return e}catch{}throw new Error(`${o} must contain a JSON object; fix or move it before installing.`)}import{readFileSync as je}from"node:fs";import{dirname as Ge,join as w,resolve as Re}from"node:path";import{fileURLToPath as Pe}from"node:url";var M=Re(Ge(Pe(import.meta.url)),".."),L=w(M,"assets"),D=w(L,"agents"),ee=w(L,"skills"),h="codex-kit-reconcile-agents",oe=w(ee,h,"SKILL.md"),te=w(ee,h,"agents","openai.yaml"),F=w(L,"SUBAGENT_ROUTING.md"),ne=w(M,"bin","routing-hook.js"),U=w(L,"TEMPLATE_AGENTS.md"),p=JSON.parse(je(w(M,"package.json"),"utf8")),J=p.publishConfig?.registry??"https://registry.npmjs.org";import{existsSync as ie,rmSync as Me}from"node:fs";import{join as De}from"node:path";import{copyFileSync as He,existsSync as j,rmSync as Ke}from"node:fs";import{join as re}from"node:path";var C=".codex-kit-state.json";function O(o){let e=re(o,C);if(!j(e))return{version:p.version,files:{}};try{let t=JSON.parse(g(e));return k(t)&&k(t.files)?t:{version:p.version,files:{}}}catch{throw new Error(`${e} is not valid JSON; move it aside before reinstalling.`)}}function G(o,e){u(re(o,C),`${JSON.stringify(e,null,2)}
+`)}function B(o,e,t,n,r){let i=y(o),s=E(i),a=n.files[t];if(!j(e))return u(e,i),console.log(`installed: ${e}`),{target:e,hash:s,ownership:"created",backup:null};let c=E(y(e));if(c===s)return console.log(`unchanged: ${e}`),a??{target:e,hash:s,ownership:"preexisting",backup:null};let d=a&&a.target===e&&a.ownership!=="preexisting"&&a.hash===c;if(!d&&!r)return console.warn(`preserved modified or pre-existing file: ${e} (use --force to replace)`),a??null;let l=S(e);return u(e,i),console.log(`updated: ${e}`),{target:e,hash:s,ownership:d?a.ownership:"replaced",backup:d?a.backup:l}}function se(o){let{target:e}=o;!j(e)||E(y(e))!==o.hash?console.warn(`preserved modified or missing file: ${e}`):o.ownership==="created"?(Ke(e),console.log(`removed: ${e}`)):o.ownership==="replaced"&&o.backup&&j(o.backup)?(He(o.backup,e),console.log(`restored: ${e}`)):console.log(`preserved pre-existing file: ${e}`)}function R(o){let e=new Map,t=!1;for(let n of o.split(`
+`)){if(/^\s*\[/.test(n)){t=!0;continue}if(t)continue;let r=/^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(n),i=r?.[2],s=r?.[3];i&&s!==void 0&&!e.has(i)&&e.set(i,{value:s,line:n})}return e}var _=o=>JSON.stringify(o);function Fe(o,e){let t=o.split(`
+`),n=new Set,r=t.findIndex(s=>/^\s*\[/.test(s));r<0&&(r=t.length);for(let s=0;s<r;s++){let a=/^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(t[s]??""),c=a?.[2];!a||!c||n.has(c)||(t[s]=`${a[1]}${c} = ${_(e[c])}`,n.add(c))}let i=Object.keys(e).filter(s=>!n.has(s)).map(s=>`${s} = ${_(e[s])}`);return i.length&&t.splice(0,0,...i,""),t.join(`
+`)}function Ue(o,e){let t=o.split(`
+`),n=t.findIndex(i=>/^\s*\[/.test(i));n<0&&(n=t.length);let r=new Set;for(let i=0;i<n;i++){let s=/^(\s*)(model|model_reasoning_effort|plan_mode_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(t[i]??""),a=s?.[2];if(!s||!a||r.has(a)||s[3]!==_(e.desired[a]))continue;let c=e.previous[a];c?.present?t[i]=`${s[1]}${a} = ${c.value}`:(t.splice(i,1),i--,n--),r.add(a)}return Object.values(e.previous).some(i=>i&&!i.present)&&t[0]===""&&t.shift(),t.join(`
+`)}function z(o){let e=o.codexHome,t=De(e,"config.toml"),n={model:o.orchestrator,model_reasoning_effort:o.reasoningEffort,plan_mode_reasoning_effort:o.planReasoningEffort},r=O(e),i=ie(t)?g(t):"",s=R(i);if(r.config?.target===t&&Object.entries(r.config.desired).some(([l,v])=>s.get(l)?.value!==_(v))&&!o.force){console.warn(`preserved modified config: ${t} (use --force to replace)`);return}let a=Fe(i,n);a!==i?(S(t),u(t,a),console.log(`configured orchestrator: ${t}`)):console.log(`unchanged: ${t}`);let c=r.config?.previous??{};for(let d of Object.keys(n)){if(d in c)continue;let l=s.get(d);c[d]=l?{present:!0,value:l.value}:{present:!1}}r.version=p.version,r.config={target:t,desired:n,previous:c},G(e,r),console.log(`Orchestrator: ${n.model}`),console.log(`Reasoning effort: ${n.model_reasoning_effort}`),console.log(`Plan mode reasoning effort: ${n.plan_mode_reasoning_effort}`)}function ae(o){if(!ie(o.target)){console.warn(`preserved missing config: ${o.target}`);return}let e=g(o.target),t=R(e);if(Object.entries(o.desired).some(([i,s])=>t.get(i)?.value!==_(s))){console.warn(`preserved modified config: ${o.target}`);return}let r=Ue(e,o);r!==e&&(S(o.target),r.trim()?u(o.target,r):Me(o.target),console.log(`restored config: ${o.target}`))}import{existsSync as V,rmSync as Je}from"node:fs";import{join as le}from"node:path";var Be=o=>`'${o.replaceAll("'",`'"'"'`)}'`,ze=o=>({command:`/usr/bin/env node ${Be(o)}`,commandWindows:`node ${JSON.stringify(o)}`});function ce(o,e){let t=o.hooks;if(k(t))for(let[n,r]of Object.entries(t)){if(!Array.isArray(r))continue;let i=r.flatMap(s=>{if(!k(s)||!Array.isArray(s.hooks))return[s];let a=s.hooks.filter(c=>!k(c)||c.command!==e.command&&c.commandWindows!==e.commandWindows);return a.length?[{...s,hooks:a}]:[]});i.length?t[n]=i:delete t[n]}}function de(o,e){let t=le(o,"hooks.json"),n=ze(le(o,"codex-kit","routing-hook.js")),r=e?.created??!V(t),i=K(t);e&&ce(i,e);let s=k(i.hooks)?i.hooks:{};i.hooks=s;let a={type:"command",...n,timeout:5};s.UserPromptSubmit=[...Array.isArray(s.UserPromptSubmit)?s.UserPromptSubmit:[],{hooks:[{...a,statusMessage:"Loading subagent routing"}]}],s.SubagentStart=[...Array.isArray(s.SubagentStart)?s.SubagentStart:[],{hooks:[{...a,statusMessage:"Briefing delegated worker"}]}];let c=`${JSON.stringify(i,null,2)}
+`,d=V(t)?g(t):"";return c!==d&&(S(t),u(t,c),console.log(`updated: ${t}`)),{target:t,...n,created:r}}function fe(o){if(!V(o.target)){console.warn(`preserved missing hooks file: ${o.target}`);return}let e=K(o.target);ce(e,o),k(e.hooks)&&!Object.keys(e.hooks).length&&delete e.hooks,S(o.target),o.created&&!Object.keys(e).length?Je(o.target):u(o.target,`${JSON.stringify(e,null,2)}
+`),console.log(`removed managed routing hooks from: ${o.target}`)}var X="<!-- BEGIN codex-kit:subagent-routing -->",pe="<!-- END codex-kit:subagent-routing -->",We=(o,e,t)=>`${e}
+${o.trimEnd()}
+${t}`;function qe(o,e,t,n){let r=o.indexOf(t),i=o.indexOf(n);if(r>=0!=i>=0||r>=0&&i<r)throw new Error(`Malformed managed block: expected both ${t} and ${n}.`);let s=We(e,t,n);return r>=0?`${o.slice(0,r)}${s}${o.slice(i+n.length)}`:`${o.trimEnd()}${o.trim()?`
+
+`:""}${s}
+`}function Ze(o,e,t){let n=o.indexOf(e),r=o.indexOf(t);if(n<0&&r<0)return o;if(n<0||r<n)throw new Error("Malformed managed block in AGENTS.md.");let i=o.slice(0,n).trimEnd(),s=o.slice(r+t.length).trimStart();return`${i}${i&&s?`
+
+`:""}${s}${i||s?`
+`:""}`}function me(o){let e=o.codexHome;Xe(e,{recursive:!0});let t=O(e),n={version:p.version,files:{},globalAgents:null,hooks:null,config:t.config??null};for(let d of N(D).filter(l=>l.endsWith(".toml")).sort()){let l=`agents/${d}`,v=B(f(D,d),f(e,"agents",d),l,t,o.force);v&&(n.files[l]=v)}let r=[[F,f(e,"SUBAGENT_ROUTING.md"),"routing"],[oe,f(e,"skills",h,"SKILL.md"),`skills/${h}/SKILL.md`],[te,f(e,"skills",h,"agents","openai.yaml"),`skills/${h}/agents/openai.yaml`],[ne,f(e,"codex-kit","routing-hook.js"),"routing-hook"]];for(let[d,l,v]of r){let I=B(d,l,v,t,o.force);I&&(n.files[v]=I)}for(let[d,l]of Object.entries(t.files))d in n.files||(!m(l.target)||E(y(l.target))!==l.hash?(console.warn(`preserved stale modified or missing file: ${l.target}`),n.files[d]=l):l.ownership==="created"?(A(l.target),console.log(`removed stale: ${l.target}`)):l.ownership==="replaced"&&l.backup&&m(l.backup)&&(Ve(l.backup,l.target),console.log(`restored stale: ${l.target}`)));let i=f(e,"AGENTS.md"),s=m(i)?g(i):"",a=qe(s,g(F),X,pe);a!==s&&(S(i),u(i,a),console.log(`updated: ${i}`)),n.globalAgents={target:i},n.hooks=de(e,t.hooks),G(e,n);let c=f(e,"agents","commit-pusher.toml");m(c)&&console.warn(`warning: existing unmanaged commit-pusher remains at ${c}`),console.log(`Codex kit ${p.version} installed under ${e}`)}function ue(o){let e=o.codexHome,t=f(e,"config.toml"),n=f(e,"AGENTS.md"),r=O(e),i=m(t)?R(g(t)):new Map,s=b=>{let x=i.get(b)?.value;if(!x)return"not set";try{return String(JSON.parse(x))}catch{return x}};console.log(`Codex home: ${e}`),console.log(`Config: ${t}${m(t)?"":" (missing)"}`),console.log(`Orchestrator: ${s("model")}`),console.log(`Reasoning effort: ${s("model_reasoning_effort")}`),console.log(`Plan mode reasoning effort: ${s("plan_mode_reasoning_effort")}`),console.log(`Kit state: ${m(f(e,C))?r.version:"not installed"}`),console.log(`Global routing: ${m(n)&&g(n).includes(X)?"installed":"not installed"}`),console.log(`Routing file: ${m(f(e,"SUBAGENT_ROUTING.md"))?f(e,"SUBAGENT_ROUTING.md"):"missing"}`);let a=r.hooks;console.log(`Routing hook: ${a&&m(a.target)&&g(a.target).includes(a.command)?"installed":"not installed"}`);let c=[[f(e,"skills",h,"SKILL.md"),r.files[`skills/${h}/SKILL.md`]],[f(e,"skills",h,"agents","openai.yaml"),r.files[`skills/${h}/agents/openai.yaml`]]],d=c.every(([b,x])=>m(b)&&x&&E(y(b))===x.hash)?"installed":c.some(([b])=>m(b))?"modified or incomplete":"missing";console.log(`Reconciliation skill: ${d}`),console.log("Custom agents:");let l=f(e,"agents"),v=m(l)?N(l).filter(b=>b.endsWith(".toml")).sort():[];if(!v.length){console.log("  (none)");return}let I=new Set(Object.values(r.files).map(b=>b.target));for(let b of v){let x=f(l,b),Te=g(x),P=Ae=>new RegExp(`^${Ae}\\s*=\\s*"([^"]*)"`,"m").exec(Te)?.[1]??"not set";console.log(`  ${P("name")} \u2014 ${P("model")}, ${P("model_reasoning_effort")} (${I.has(x)?"managed":"unmanaged"})`)}}function he(o){let e=o.codexHome,t=f(e,C);if(!m(t)){console.log(`No installer state at ${t}; nothing removed.`);return}let n=O(e);for(let d of Object.values(n.files))se(d);let r=n.globalAgents?.target??f(e,"AGENTS.md");if(m(r)){let d=g(r),l=Ze(d,X,pe);l!==d&&(S(r),l?u(r,l):A(r),console.log(`removed managed routing from: ${r}`))}n.config&&ae(n.config),n.hooks&&fe(n.hooks);let i=f(e,"skills",h),s=f(i,"agents");m(s)&&ge(s).isDirectory()&&!N(s).length&&A(s,{recursive:!0}),m(i)&&ge(i).isDirectory()&&!N(i).length&&A(i,{recursive:!0});let a=f(e,"codex-kit","allowances");m(a)&&A(a,{recursive:!0,force:!0});let c=f(e,"codex-kit");m(c)&&!N(c).length&&A(c,{recursive:!0}),A(t),console.log(`Codex kit uninstalled from ${e}`)}import{existsSync as $,statSync as Ye}from"node:fs";import{join as T}from"node:path";var Ee=".codex-kit-state.json",Qe="<!-- BEGIN codex-kit:shared-template -->",eo="<!-- END codex-kit:shared-template -->",ke=`# Project-Specific Instructions
+
+<!-- Add repository-specific commands, architecture, and exceptions here. -->
+`;function W(o){let e=T(o,Ee);if(!$(e))return{version:1,template:{}};try{let t=JSON.parse(g(e));return k(t)&&k(t.template)?t:{version:1,template:{}}}catch{throw new Error(`${e} is not valid JSON; move it aside before syncing.`)}}var Se=(o,e)=>u(T(o,Ee),`${JSON.stringify(e,null,2)}
+`),q=o=>{if(!$(o)||!Ye(o).isDirectory())throw new Error(`Not a directory: ${o}`)};function oo(){return`Project guidance needs initialization. Copy everything between the markers into Codex.
+
+===== BEGIN CODEX INITIALIZATION PROMPT =====
+Explore this repository before changing code. First determine whether it has a
+substantially scaffolded implementation with enough dependency, configuration,
+script, and source evidence to derive reliable project guidance.
+
+If evidence is insufficient, do not add speculative rules or mark the template
+applied. Report what still needs to be scaffolded, then stop.
+
+If evidence is sufficient, identify the stack, package manager, scripts,
+structure, established patterns, testing tools, and generated files. Add concise
+project-specific guidance to AGENTS.md based only on repository evidence,
+including exact verification commands. Then use the global
+$${h} skill to merge applicable reusable guidance from
+TEMPLATE_AGENTS.md while preserving AGENTS.md organization and local rules.
+Validate the final instruction changes, mark the template applied only after
+validation succeeds, and confirm codex-kit project status is up to date.
+===== END CODEX INITIALIZATION PROMPT =====`}function to(){return`Template reference updated. Copy everything between the markers into Codex.
+
+===== BEGIN CODEX RECONCILIATION PROMPT =====
+Use the global $${h} skill to reconcile the existing AGENTS.md
+with the refreshed TEMPLATE_AGENTS.md.
 
 Inspect TEMPLATE_AGENTS.md, AGENTS.md, .codex-kit-state.json, existing
 .agents/skills, and codex-kit project status. Preserve local adaptations and
 AGENTS.md organization; merge only applicable reusable guidance. Keep critical
 always-on safety and authorization rules in AGENTS.md, extract only concrete
 conditional procedures into validated skills, and do not copy the complete
-template or introduce managed markers. Mark applied only after reconciliation
-and validation, then report any template-worthy generalized promotion.`;
-}
-function managedBlock(content, begin, end) {
-    return `${begin}\n${content.trimEnd()}\n${end}`;
-}
-function replaceOrAppendBlock(original, content, begin, end) {
-    const start = original.indexOf(begin);
-    const finish = original.indexOf(end);
-    if ((start >= 0) !== (finish >= 0) || (start >= 0 && finish < start)) {
-        throw new Error(`Malformed managed block: expected both ${begin} and ${end}.`);
-    }
-    const block = managedBlock(content, begin, end);
-    if (start >= 0)
-        return `${original.slice(0, start)}${block}${original.slice(finish + end.length)}`;
-    return `${original.trimEnd()}${original.trim() ? "\n\n" : ""}${block}\n`;
-}
-function removeBlock(original, begin, end) {
-    const start = original.indexOf(begin);
-    const finish = original.indexOf(end);
-    if (start < 0 && finish < 0)
-        return original;
-    if (start < 0 || finish < start)
-        throw new Error(`Malformed managed block in AGENTS.md.`);
-    const before = original.slice(0, start).trimEnd();
-    const after = original.slice(finish + end.length).trimStart();
-    return `${before}${before && after ? "\n\n" : ""}${after}${before || after ? "\n" : ""}`;
-}
-function installFile(source, target, key, prior, force) {
-    const sourceData = read(source);
-    const sourceHash = sha256(sourceData);
-    const previous = prior.files[key];
-    if (!existsSync(target)) {
-        write(target, sourceData);
-        console.log(`installed: ${target}`);
-        return { target, hash: sourceHash, ownership: "created", backup: null };
-    }
-    const targetHash = sha256(read(target));
-    if (targetHash === sourceHash) {
-        console.log(`unchanged: ${target}`);
-        return previous ?? { target, hash: sourceHash, ownership: "preexisting", backup: null };
-    }
-    const safelyOwned = previous &&
-        previous.target === target &&
-        previous.ownership !== "preexisting" &&
-        previous.hash === targetHash;
-    if (!safelyOwned && !force) {
-        console.warn(`preserved modified or pre-existing file: ${target} (use --force to replace)`);
-        return previous ?? null;
-    }
-    const newBackup = backup(target);
-    write(target, sourceData);
-    console.log(`updated: ${target}`);
-    return {
-        target,
-        hash: sourceHash,
-        ownership: safelyOwned ? previous.ownership : "replaced",
-        backup: safelyOwned ? previous.backup : newBackup,
-    };
-}
-function installGlobal(options) {
-    const home = options.codexHome;
-    mkdirSync(home, { recursive: true });
-    const prior = loadState(home);
-    const next = {
-        version: PACKAGE.version,
-        files: {},
-        globalAgents: null,
-        hooks: null,
-        config: prior.config ?? null,
-    };
-    for (const name of readdirSync(AGENTS_DIR).filter((name) => name.endsWith(".toml")).sort()) {
-        const key = `agents/${name}`;
-        const record = installFile(join(AGENTS_DIR, name), join(home, "agents", name), key, prior, options.force);
-        if (record)
-            next.files[key] = record;
-    }
-    const routingRecord = installFile(ROUTING_FILE, join(home, "SUBAGENT_ROUTING.md"), "routing", prior, options.force);
-    if (routingRecord)
-        next.files.routing = routingRecord;
-    const reconciliationSkill = installFile(RECONCILE_SKILL_FILE, join(home, "skills", RECONCILE_SKILL, "SKILL.md"), `skills/${RECONCILE_SKILL}/SKILL.md`, prior, options.force);
-    if (reconciliationSkill)
-        next.files[`skills/${RECONCILE_SKILL}/SKILL.md`] = reconciliationSkill;
-    const reconciliationSkillMetadata = installFile(RECONCILE_SKILL_METADATA_FILE, join(home, "skills", RECONCILE_SKILL, "agents", "openai.yaml"), `skills/${RECONCILE_SKILL}/agents/openai.yaml`, prior, options.force);
-    if (reconciliationSkillMetadata)
-        next.files[`skills/${RECONCILE_SKILL}/agents/openai.yaml`] = reconciliationSkillMetadata;
-    const hookRecord = installFile(ROUTING_HOOK_FILE, join(home, "codex-kit", "routing-hook.js"), "routing-hook", prior, options.force);
-    if (hookRecord)
-        next.files["routing-hook"] = hookRecord;
-    for (const [key, record] of Object.entries(prior.files)) {
-        if (key in next.files)
-            continue;
-        const target = record.target;
-        if (!existsSync(target) || sha256(read(target)) !== record.hash) {
-            console.warn(`preserved stale modified or missing file: ${target}`);
-            next.files[key] = record;
-            continue;
-        }
-        if (record.ownership === "created") {
-            rmSync(target);
-            console.log(`removed stale: ${target}`);
-        }
-        else if (record.ownership === "replaced" && record.backup && existsSync(record.backup)) {
-            copyFileSync(record.backup, target);
-            console.log(`restored stale: ${target}`);
-        }
-    }
-    const globalAgents = join(home, "AGENTS.md");
-    const original = existsSync(globalAgents) ? readText(globalAgents) : "";
-    const updated = replaceOrAppendBlock(original, readText(ROUTING_FILE), GLOBAL_BEGIN, GLOBAL_END);
-    if (updated !== original) {
-        backup(globalAgents);
-        write(globalAgents, updated);
-        console.log(`updated: ${globalAgents}`);
-    }
-    next.globalAgents = { target: globalAgents };
-    next.hooks = installRoutingHooks(home, prior.hooks);
-    saveState(home, next);
-    const commitPusher = join(home, "agents", "commit-pusher.toml");
-    if (existsSync(commitPusher)) {
-        console.warn(`warning: existing unmanaged commit-pusher remains at ${commitPusher}`);
-    }
-    console.log(`Codex kit ${PACKAGE.version} installed under ${home}`);
-}
-function configureGlobal(options) {
-    const home = options.codexHome;
-    mkdirSync(home, { recursive: true });
-    const configFile = join(home, "config.toml");
-    const desired = {
-        model: options.orchestrator,
-        model_reasoning_effort: options.reasoningEffort,
-        plan_mode_reasoning_effort: options.planReasoningEffort,
-    };
-    const priorState = loadState(home);
-    const original = existsSync(configFile) ? readText(configFile) : "";
-    const current = topLevelConfigEntries(original);
-    const priorConfig = priorState.config;
-    if (priorConfig?.target === configFile) {
-        const changedByUser = Object.entries(priorConfig.desired).some(([key, value]) => {
-            const entry = current.get(key);
-            return !entry || entry.value !== tomlString(value);
-        });
-        if (changedByUser && !options.force) {
-            console.warn(`preserved modified config: ${configFile} (use --force to replace)`);
-            return;
-        }
-    }
-    const updated = setTopLevelConfig(original, desired);
-    if (updated !== original) {
-        backup(configFile);
-        write(configFile, updated);
-        console.log(`configured orchestrator: ${configFile}`);
-    }
-    else
-        console.log(`unchanged: ${configFile}`);
-    const previous = priorConfig?.previous ?? {};
-    for (const key of Object.keys(desired)) {
-        if (key in previous)
-            continue;
-        const entry = current.get(key);
-        previous[key] = entry
-            ? { present: true, value: entry.value }
-            : { present: false };
-    }
-    priorState.version = PACKAGE.version;
-    priorState.config = {
-        target: configFile,
-        desired,
-        previous,
-    };
-    saveState(home, priorState);
-    console.log(`Orchestrator: ${desired.model}`);
-    console.log(`Reasoning effort: ${desired.model_reasoning_effort}`);
-    console.log(`Plan mode reasoning effort: ${desired.plan_mode_reasoning_effort}`);
-}
-function listGlobal(options) {
-    const home = options.codexHome;
-    const configFile = join(home, "config.toml");
-    const globalAgents = join(home, "AGENTS.md");
-    const routingFile = join(home, "SUBAGENT_ROUTING.md");
-    const agentsDir = join(home, "agents");
-    const stateFile = join(home, STATE_FILE);
-    const state = loadState(home);
-    const config = existsSync(configFile) ? topLevelConfigEntries(readText(configFile)) : new Map();
-    const value = (key) => {
-        const raw = config.get(key)?.value;
-        if (!raw)
-            return "not set";
-        try {
-            return String(JSON.parse(raw));
-        }
-        catch {
-            return raw;
-        }
-    };
-    const managedTargets = new Set(Object.values(state.files).map((record) => record.target));
-    console.log(`Codex home: ${home}`);
-    console.log(`Config: ${configFile}${existsSync(configFile) ? "" : " (missing)"}`);
-    console.log(`Orchestrator: ${value("model")}`);
-    console.log(`Reasoning effort: ${value("model_reasoning_effort")}`);
-    console.log(`Plan mode reasoning effort: ${value("plan_mode_reasoning_effort")}`);
-    console.log(`Kit state: ${existsSync(stateFile) ? state.version : "not installed"}`);
-    const hasRoutingBlock = existsSync(globalAgents) && readText(globalAgents).includes(GLOBAL_BEGIN);
-    console.log(`Global routing: ${hasRoutingBlock ? "installed" : "not installed"}`);
-    console.log(`Routing file: ${existsSync(routingFile) ? routingFile : "missing"}`);
-    const routingHook = state.hooks;
-    const hooksInstalled = Boolean(routingHook &&
-        existsSync(routingHook.target) &&
-        readText(routingHook.target).includes(routingHook.command));
-    console.log(`Routing hook: ${hooksInstalled ? "installed" : "not installed"}`);
-    const skillTargets = [
-        [join(home, "skills", RECONCILE_SKILL, "SKILL.md"), state.files[`skills/${RECONCILE_SKILL}/SKILL.md`]],
-        [join(home, "skills", RECONCILE_SKILL, "agents", "openai.yaml"), state.files[`skills/${RECONCILE_SKILL}/agents/openai.yaml`]],
-    ];
-    const skillStatus = skillTargets.every(([target, record]) => existsSync(target) && record && sha256(read(target)) === record.hash)
-        ? "installed"
-        : skillTargets.some(([target]) => existsSync(target))
-            ? "modified or incomplete"
-            : "missing";
-    console.log(`Reconciliation skill: ${skillStatus}`);
-    console.log("Custom agents:");
-    const agents = existsSync(agentsDir)
-        ? readdirSync(agentsDir).filter((name) => name.endsWith(".toml")).sort()
-        : [];
-    if (!agents.length)
-        return console.log("  (none)");
-    for (const filename of agents) {
-        const file = join(agentsDir, filename);
-        const contents = readText(file);
-        const field = (key) => new RegExp(`^${key}\\s*=\\s*"([^"]*)"`, "m").exec(contents)?.[1] ?? "not set";
-        const ownership = managedTargets.has(file) ? "managed" : "unmanaged";
-        console.log(`  ${field("name")} — ${field("model")}, ${field("model_reasoning_effort")} (${ownership})`);
-    }
-}
-function uninstallGlobal(options) {
-    const home = options.codexHome;
-    const statePath = join(home, STATE_FILE);
-    if (!existsSync(statePath)) {
-        console.log(`No installer state at ${statePath}; nothing removed.`);
-        return;
-    }
-    const state = loadState(home);
-    for (const record of Object.values(state.files)) {
-        const target = record.target;
-        if (!existsSync(target) || sha256(read(target)) !== record.hash) {
-            console.warn(`preserved modified or missing file: ${target}`);
-            continue;
-        }
-        if (record.ownership === "created") {
-            rmSync(target);
-            console.log(`removed: ${target}`);
-        }
-        else if (record.ownership === "replaced" && record.backup && existsSync(record.backup)) {
-            copyFileSync(record.backup, target);
-            console.log(`restored: ${target}`);
-        }
-        else {
-            console.log(`preserved pre-existing file: ${target}`);
-        }
-    }
-    const globalAgents = state.globalAgents?.target ?? join(home, "AGENTS.md");
-    if (existsSync(globalAgents)) {
-        const original = readText(globalAgents);
-        const updated = removeBlock(original, GLOBAL_BEGIN, GLOBAL_END);
-        if (updated !== original) {
-            backup(globalAgents);
-            if (updated)
-                write(globalAgents, updated);
-            else
-                rmSync(globalAgents);
-            console.log(`removed managed routing from: ${globalAgents}`);
-        }
-    }
-    if (state.config?.target) {
-        const configFile = state.config.target;
-        if (!existsSync(configFile)) {
-            console.warn(`preserved missing config: ${configFile}`);
-        }
-        else {
-            const originalConfig = readText(configFile);
-            const current = topLevelConfigEntries(originalConfig);
-            const changed = Object.entries(state.config.desired).some(([key, value]) => {
-                const entry = current.get(key);
-                return !entry || entry.value !== tomlString(value);
-            });
-            if (changed) {
-                console.warn(`preserved modified config: ${configFile}`);
-            }
-            else {
-                const restored = restoreTopLevelConfig(originalConfig, state.config);
-                if (restored !== originalConfig) {
-                    backup(configFile);
-                    if (restored.trim())
-                        write(configFile, restored);
-                    else
-                        rmSync(configFile);
-                    console.log(`restored config: ${configFile}`);
-                }
-            }
-        }
-    }
-    if (state.hooks)
-        uninstallRoutingHooks(state.hooks);
-    const skillDir = join(home, "skills", RECONCILE_SKILL);
-    const skillMetadataDir = join(skillDir, "agents");
-    if (existsSync(skillMetadataDir) && statSync(skillMetadataDir).isDirectory() && !readdirSync(skillMetadataDir).length) {
-        rmSync(skillMetadataDir, { recursive: true });
-    }
-    if (existsSync(skillDir) && statSync(skillDir).isDirectory() && !readdirSync(skillDir).length) {
-        rmSync(skillDir, { recursive: true });
-    }
-    const allowancesDir = join(home, "codex-kit", "allowances");
-    if (existsSync(allowancesDir))
-        rmSync(allowancesDir, { recursive: true, force: true });
-    const kitDir = join(home, "codex-kit");
-    if (existsSync(kitDir) && !readdirSync(kitDir).length)
-        rmSync(kitDir, { recursive: true });
-    rmSync(statePath);
-    console.log(`Codex kit uninstalled from ${home}`);
-}
-function syncProject(options) {
-    const cwd = options.cwd;
-    if (!existsSync(cwd) || !statSync(cwd).isDirectory())
-        throw new Error(`Not a directory: ${cwd}`);
-    const agentsFile = join(cwd, "AGENTS.md");
-    const stagedTemplate = join(cwd, "TEMPLATE_AGENTS.md");
-    const template = readText(TEMPLATE_FILE);
-    const desired = Buffer.from(template);
-    const sourceHash = sha256(desired);
-    const state = loadProjectState(cwd);
-    const previousAvailable = state.template.availableHash;
-    if (existsSync(stagedTemplate)) {
-        const currentHash = sha256(read(stagedTemplate));
-        const locallyModified = currentHash !== sourceHash && (!previousAvailable || currentHash !== previousAvailable);
-        if (locallyModified && currentHash !== sourceHash && !options.force) {
-            console.warn(`preserved locally modified template: ${stagedTemplate} (use --force to replace)`);
-            console.log(`The installed kit has template ${PACKAGE.version}; review the local change before syncing.`);
-            return;
-        }
-        if (currentHash === sourceHash)
-            console.log(`unchanged: ${stagedTemplate}`);
-        else {
-            backup(stagedTemplate);
-            write(stagedTemplate, desired);
-            console.log(`refreshed template reference: ${stagedTemplate}`);
-        }
-    }
-    else {
-        write(stagedTemplate, desired);
-        console.log(`created template reference: ${stagedTemplate}`);
-    }
-    state.version = 1;
-    state.template = {
-        ...state.template,
-        availableHash: sourceHash,
-        availableVersion: PACKAGE.version,
-    };
-    saveProjectState(cwd, state);
-    if (!existsSync(agentsFile)) {
-        const contents = `# Project-Specific Instructions
+template or introduce managed markers.
 
-<!-- Add repository-specific commands, architecture, and exceptions here. -->
-`;
-        write(agentsFile, contents);
-        console.log(`created project instructions file: ${agentsFile}`);
-    }
-    else if (readText(agentsFile).includes(PROJECT_BEGIN) || readText(agentsFile).includes(PROJECT_END)) {
-        console.warn(`preserved legacy managed template in: ${agentsFile}`);
-        console.warn("Ask Codex to migrate it to semantic template reconciliation before applying updates.");
-    }
-    console.log(templatePrompt());
-}
-function projectStatus(options) {
-    const cwd = options.cwd;
-    if (!existsSync(cwd) || !statSync(cwd).isDirectory())
-        throw new Error(`Not a directory: ${cwd}`);
-    const stagedTemplate = join(cwd, "TEMPLATE_AGENTS.md");
-    const agentsFile = join(cwd, "AGENTS.md");
-    const state = loadProjectState(cwd);
-    const availableHash = state.template.availableHash ?? null;
-    const appliedHash = state.template.appliedHash ?? null;
-    const sourceHash = sha256(read(TEMPLATE_FILE));
-    const localHash = existsSync(stagedTemplate) ? sha256(read(stagedTemplate)) : null;
-    console.log(`Project: ${cwd}`);
-    if (!localHash)
-        return console.log("Status: not initialized (run codex-kit project sync)");
-    if (!existsSync(agentsFile))
-        return console.log("Status: AGENTS.md missing (reconcile the template first)");
-    console.log(`Available: ${state.template.availableVersion ?? "unknown"} (${availableHash ?? "untracked"})`);
-    console.log(`Applied:   ${appliedHash ?? "never"}`);
-    if (sourceHash !== availableHash)
-        return console.log("Status: kit template update available; run project sync");
-    if (localHash !== availableHash)
-        return console.log("Status: local template changed; review it before syncing");
-    if (appliedHash !== localHash)
-        return console.log("Status: reconciliation required");
-    console.log("Status: up to date");
-}
-function markApplied(options) {
-    const cwd = options.cwd;
-    if (!existsSync(cwd) || !statSync(cwd).isDirectory())
-        throw new Error(`Not a directory: ${cwd}`);
-    const stagedTemplate = join(cwd, "TEMPLATE_AGENTS.md");
-    const agentsFile = join(cwd, "AGENTS.md");
-    if (!existsSync(stagedTemplate))
-        throw new Error(`Missing ${stagedTemplate}; run project sync first.`);
-    if (!existsSync(agentsFile))
-        throw new Error(`Missing ${agentsFile}; reconcile the template into AGENTS.md first.`);
-    const state = loadProjectState(cwd);
-    const appliedHash = sha256(read(stagedTemplate));
-    state.version = 1;
-    state.template = {
-        ...state.template,
-        appliedHash,
-        appliedAt: new Date().toISOString(),
-    };
-    saveProjectState(cwd, state);
-    console.log(`recorded template reconciliation: ${stagedTemplate}`);
-}
-function compareVersions(left, right) {
-    const parseVersion = (value) => {
-        const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(value);
-        if (!match)
-            throw new Error(`Invalid package version: ${value}`);
-        return {
-            numbers: [Number(match[1]), Number(match[2]), Number(match[3])],
-            prerelease: match[4] ?? null,
-        };
-    };
-    const a = parseVersion(left);
-    const b = parseVersion(right);
-    for (let index = 0; index < 3; index++) {
-        const leftNumber = a.numbers[index];
-        const rightNumber = b.numbers[index];
-        if (leftNumber !== rightNumber)
-            return Math.sign(leftNumber - rightNumber);
-    }
-    if (a.prerelease === b.prerelease)
-        return 0;
-    if (!a.prerelease)
-        return 1;
-    if (!b.prerelease)
-        return -1;
-    return Math.sign(a.prerelease.localeCompare(b.prerelease, "en", { numeric: true }));
-}
-function checkVersion() {
-    let latest = process.env.CODEX_KIT_LATEST_VERSION;
-    if (!latest) {
-        const executable = process.platform === "win32" ? "pnpm.cmd" : "pnpm";
-        const result = spawnSync(executable, ["view", PACKAGE.name, "version", "--json", `--registry=${REGISTRY}`], { encoding: "utf8", timeout: 15_000 });
-        if (result.error)
-            throw new Error(`Unable to run pnpm: ${result.error.message}`);
-        if (result.status !== 0) {
-            const detail = result.stderr.trim() || "pnpm view failed";
-            throw new Error(`Unable to check ${REGISTRY}: ${detail}`);
-        }
-        try {
-            const value = JSON.parse(result.stdout);
-            latest = Array.isArray(value) && typeof value.at(-1) === "string"
-                ? value.at(-1)
-                : typeof value === "string"
-                    ? value
-                    : undefined;
-        }
-        catch {
-            latest = result.stdout.trim();
-        }
-    }
-    if (typeof latest !== "string" || !latest)
-        throw new Error("Registry returned no package version.");
-    console.log(`Installed: ${PACKAGE.version}`);
-    console.log(`Latest:    ${latest}`);
-    const comparison = compareVersions(PACKAGE.version, latest);
-    if (comparison === 0)
-        return console.log("codex-kit is up to date.");
-    if (comparison > 0)
-        return console.log("This local build is newer than the published package.");
-    console.log(`Update available. Run:
-  pnpm add --global ${PACKAGE.name}@latest
-  codex-kit global install`);
-}
-function parse(argv) {
-    const options = {
-        cwd: process.cwd(),
-        codexHome: resolve(process.env.CODEX_HOME || join(homedir(), ".codex")),
-        orchestrator: DEFAULT_ORCHESTRATOR,
-        reasoningEffort: DEFAULT_REASONING_EFFORT,
-        planReasoningEffort: DEFAULT_PLAN_REASONING_EFFORT,
-        force: false,
-        positionals: [],
-    };
-    for (let index = 0; index < argv.length; index++) {
-        const arg = argv[index];
-        if (arg === undefined)
-            continue;
-        if (arg === "--force")
-            options.force = true;
-        else if (arg === "--cwd" || arg === "--codex-home") {
-            const value = argv[++index];
-            if (!value)
-                throw new Error(`${arg} requires a path.`);
-            if (arg === "--cwd")
-                options.cwd = resolve(value);
-            else
-                options.codexHome = resolve(value);
-        }
-        else if (arg === "--orchestrator" || arg === "--model") {
-            const value = argv[++index];
-            if (!value)
-                throw new Error(`${arg} requires a model.`);
-            options.orchestrator = value;
-        }
-        else if (arg === "--reasoning-effort") {
-            const value = argv[++index];
-            if (!value)
-                throw new Error(`${arg} requires a value.`);
-            options.reasoningEffort = value;
-        }
-        else if (arg === "--plan-reasoning-effort") {
-            const value = argv[++index];
-            if (!value)
-                throw new Error(`${arg} requires a value.`);
-            options.planReasoningEffort = value;
-        }
-        else
-            options.positionals.push(arg);
-    }
-    return options;
-}
-function help() {
-    console.log(`codex-kit ${PACKAGE.version}
+Validate the final instruction changes. Mark applied only after reconciliation
+and validation succeed, confirm codex-kit project status is up to date, then
+report any template-worthy generalized promotion.
+===== END CODEX RECONCILIATION PROMPT =====`}function be(o){let{cwd:e}=o;q(e);let t=T(e,"AGENTS.md"),n=T(e,"TEMPLATE_AGENTS.md"),r=Buffer.from(g(U)),i=E(r),s=W(e);if($(n)){let d=E(y(n));if(d!==i&&(!s.template.availableHash||d!==s.template.availableHash)&&!o.force){console.warn(`preserved locally modified template: ${n} (use --force to replace)`),console.log(`The installed kit has template ${p.version}; review the local change before syncing.`);return}d===i?console.log(`unchanged: ${n}`):(S(n),u(n,r),console.log(`refreshed template reference: ${n}`))}else u(n,r),console.log(`created template reference: ${n}`);if(s.version=1,s.template={...s.template,availableHash:i,availableVersion:p.version},Se(e,s),!$(t))u(t,ke),console.log(`created project instructions file: ${t}`);else{let d=g(t);(d.includes(Qe)||d.includes(eo))&&(console.warn(`preserved legacy managed template in: ${t}`),console.warn("Ask Codex to migrate it to semantic template reconciliation before applying updates."))}let c=g(t).trim()===ke.trim();console.log(c?oo():to())}function ye(o){let{cwd:e}=o;q(e);let t=T(e,"TEMPLATE_AGENTS.md"),n=W(e),r=n.template.availableHash??null,i=$(t)?E(y(t)):null;if(console.log(`Project: ${e}`),!i){console.log("Status: not initialized (run codex-kit project sync)");return}if(!$(T(e,"AGENTS.md"))){console.log("Status: AGENTS.md missing (reconcile the template first)");return}if(console.log(`Available: ${n.template.availableVersion??"unknown"} (${r??"untracked"})`),console.log(`Applied:   ${n.template.appliedHash??"never"}`),E(y(U))!==r){console.log("Status: kit template update available; run project sync");return}if(i!==r){console.log("Status: local template changed; review it before syncing");return}if(n.template.appliedHash!==i){console.log("Status: reconciliation required");return}console.log("Status: up to date")}function ve(o){let{cwd:e}=o;q(e);let t=T(e,"TEMPLATE_AGENTS.md"),n=T(e,"AGENTS.md");if(!$(t))throw new Error(`Missing ${t}; run project sync first.`);if(!$(n))throw new Error(`Missing ${n}; reconcile the template into AGENTS.md first.`);let r=W(e);r.version=1,r.template={...r.template,appliedHash:E(y(t)),appliedAt:new Date().toISOString()},Se(e,r),console.log(`recorded template reconciliation: ${t}`)}import{spawnSync as no}from"node:child_process";function ro(o,e){let t=i=>{let s=/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(i);if(!s)throw new Error(`Invalid package version: ${i}`);return{numbers:[Number(s[1]),Number(s[2]),Number(s[3])],prerelease:s[4]??null}},n=t(o),r=t(e);for(let[i,s]of[[n.numbers[0],r.numbers[0]],[n.numbers[1],r.numbers[1]],[n.numbers[2],r.numbers[2]]])if(i!==s)return Math.sign(i-s);return n.prerelease===r.prerelease?0:n.prerelease?r.prerelease?Math.sign(n.prerelease.localeCompare(r.prerelease,"en",{numeric:!0})):-1:1}function xe(){let o=process.env.CODEX_KIT_LATEST_VERSION;if(!o){let t=no(process.platform==="win32"?"pnpm.cmd":"pnpm",["view",p.name,"version","--json",`--registry=${J}`],{encoding:"utf8",timeout:15e3});if(t.error)throw new Error(`Unable to run pnpm: ${t.error.message}`);if(t.status!==0)throw new Error(`Unable to check ${J}: ${t.stderr.trim()||"pnpm view failed"}`);try{let n=JSON.parse(t.stdout);o=Array.isArray(n)&&typeof n.at(-1)=="string"?n.at(-1):typeof n=="string"?n:void 0}catch{o=t.stdout.trim()}}if(!o)throw new Error("Registry returned no package version.");console.log(`Installed: ${p.version}`),console.log(`Latest:    ${o}`);let e=ro(p.version,o);if(e===0){console.log("codex-kit is up to date.");return}if(e>0){console.log("This local build is newer than the published package.");return}console.log(`Update available. Run:
+  pnpm add --global ${p.name}@latest
+  codex-kit global install`)}import{homedir as so}from"node:os";import{join as io,resolve as Z}from"node:path";function we(o){let e={cwd:process.cwd(),codexHome:Z(process.env.CODEX_HOME||io(so(),".codex")),orchestrator:"gpt-5.6-sol",reasoningEffort:"low",planReasoningEffort:"high",force:!1,positionals:[]};for(let t=0;t<o.length;t++){let n=o[t];if(n!==void 0)if(n==="--force")e.force=!0;else if(n==="--cwd"||n==="--codex-home"){let r=o[++t];if(!r)throw new Error(`${n} requires a path.`);n==="--cwd"?e.cwd=Z(r):e.codexHome=Z(r)}else if(n==="--orchestrator"||n==="--model"){let r=o[++t];if(!r)throw new Error(`${n} requires a model.`);e.orchestrator=r}else if(n==="--reasoning-effort"||n==="--plan-reasoning-effort"){let r=o[++t];if(!r)throw new Error(`${n} requires a value.`);n==="--reasoning-effort"?e.reasoningEffort=r:e.planReasoningEffort=r}else e.positionals.push(n)}return e}function ao(){console.log(`codex-kit ${p.version}
 
 Usage:
   codex-kit <command> [options]
@@ -852,40 +100,4 @@ Examples:
   codex-kit global install --force
   codex-kit global configure --reasoning-effort low --plan-reasoning-effort high
   codex-kit project sync --cwd /path/to/project --force
-  codex-kit project status --cwd /path/to/project`);
-}
-export function main(argv = process.argv.slice(2)) {
-    const options = parse(argv);
-    if (options.positionals.includes("--version"))
-        return console.log(PACKAGE.version);
-    if (!options.positionals.length || options.positionals.includes("--help"))
-        return help();
-    const [scope, action] = options.positionals;
-    if (scope === "global" && action === "install")
-        return installGlobal(options);
-    if (scope === "global" && action === "configure")
-        return configureGlobal(options);
-    if (scope === "global" && action === "list")
-        return listGlobal(options);
-    if (scope === "global" && action === "uninstall")
-        return uninstallGlobal(options);
-    if (scope === "project" && (action === "init" || action === "sync"))
-        return syncProject(options);
-    if (scope === "project" && action === "status")
-        return projectStatus(options);
-    if (scope === "project" && action === "mark-applied")
-        return markApplied(options);
-    if (scope === "version" && action === "check")
-        return checkVersion();
-    throw new Error(`Unknown command: ${options.positionals.join(" ")}`);
-}
-if (process.argv[1] &&
-    realpathSync(resolve(process.argv[1])) === realpathSync(fileURLToPath(import.meta.url))) {
-    try {
-        main();
-    }
-    catch (error) {
-        console.error(`error: ${error instanceof Error ? error.message : String(error)}`);
-        process.exitCode = 1;
-    }
-}
+  codex-kit project status --cwd /path/to/project`)}function Y(o=process.argv.slice(2)){let e=we(o);if(e.positionals.includes("--version")){console.log(p.version);return}if(!e.positionals.length||e.positionals.includes("--help")){ao();return}let[t,n]=e.positionals;if(t==="global"&&n==="install")me(e);else if(t==="global"&&n==="configure")z(e);else if(t==="global"&&n==="list")ue(e);else if(t==="global"&&n==="uninstall")he(e);else if(t==="project"&&(n==="init"||n==="sync"))be(e);else if(t==="project"&&n==="status")ye(e);else if(t==="project"&&n==="mark-applied")ve(e);else if(t==="version"&&n==="check")xe();else throw new Error(`Unknown command: ${e.positionals.join(" ")}`)}if(process.argv[1]&&$e(lo(process.argv[1]))===$e(co(import.meta.url)))try{Y()}catch(o){console.error(`error: ${o instanceof Error?o.message:String(o)}`),process.exitCode=1}export{Y as main};

package/bin/routing-hook.js

@@ -1,26 +1,6 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-const home = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const routingFile = join(home, "SUBAGENT_ROUTING.md");
-const input = JSON.parse(readFileSync(0, "utf8"));
-function hookContext(event, context) {
-    return JSON.stringify({
-        hookSpecificOutput: {
-            hookEventName: event,
-            additionalContext: context,
-        },
-    });
-}
-if (input.hook_event_name === "UserPromptSubmit" && existsSync(routingFile)) {
-    const routing = readFileSync(routingFile, "utf8").trim();
-    process.stdout.write(`Codex-kit routing policy for this turn:\n\n${routing}\n\n` +
-        "Classify the task using this policy before acting. When it requires delegation, " +
-        "spawn the exact named role before doing that role's work. Agent definitions, not " +
-        "this policy, determine each role's model and reasoning effort.");
-}
-if (input.hook_event_name === "SubagentStart") {
-    process.stdout.write(hookContext("SubagentStart", `You are the delegated ${input.agent_type ?? "worker"}. ` +
-        "Follow the assigned scope, perform the role's work directly without further delegation, validate it, and return concise evidence."));
-}
+import{existsSync as r,readFileSync as n}from"node:fs";import{dirname as s,join as a,resolve as u}from"node:path";import{fileURLToPath as d}from"node:url";var c=u(s(d(import.meta.url)),".."),o=a(c,"SUBAGENT_ROUTING.md"),e=JSON.parse(n(0,"utf8"));function g(t,i){return JSON.stringify({hookSpecificOutput:{hookEventName:t,additionalContext:i}})}if(e.hook_event_name==="UserPromptSubmit"&&r(o)){let t=n(o,"utf8").trim();process.stdout.write(`Codex-kit routing policy for this turn:
+
+${t}
+
+Classify the task using this policy before acting. When it requires delegation, spawn the exact named role before doing that role's work. Agent definitions, not this policy, determine each role's model and reasoning effort.`)}e.hook_event_name==="SubagentStart"&&process.stdout.write(g("SubagentStart",`You are the delegated ${e.agent_type??"worker"}. Follow the assigned scope, perform the role's work directly without further delegation, validate it, and return concise evidence.`));

package/package.json

@@ -1,40 +1,58 @@
 {
-  "name": "@iamdevlinph/codex-kit",
-  "version": "1.0.12",
-  "description": "Portable Codex subagents and project AGENTS.md defaults.",
-  "type": "module",
-  "bin": {
-    "codex-kit": "bin/codex-kit.js"
-  },
-  "files": [
-    "assets/agents",
-    "assets/SUBAGENT_ROUTING.md",
-    "assets/TEMPLATE_AGENTS.md",
-    "assets/skills",
-    "bin"
-  ],
-  "scripts": {
-    "build": "pnpm exec tsc -p tsconfig.json",
-    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit && pnpm exec tsc -p tsconfig.test.json --noEmit",
-    "test": "pnpm run build && pnpm exec tsc -p tsconfig.test.json && node --test .test-dist/test/*.test.js",
-    "prepack": "pnpm run build",
-    "pack:check": "pnpm pack --dry-run"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/iamdevlinph/codex-kit.git"
-  },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
-  },
-  "devDependencies": {
-    "@types/node": "20.19.43",
-    "typescript": "7.0.1-rc"
-  },
-  "packageManager": "pnpm@11.5.2",
-  "license": "UNLICENSED"
+	"name": "@iamdevlinph/codex-kit",
+	"version": "1.0.14",
+	"description": "Portable Codex subagents and project AGENTS.md defaults.",
+	"type": "module",
+	"bin": {
+		"codex-kit": "bin/codex-kit.js"
+	},
+	"files": [
+		"assets/agents",
+		"assets/SUBAGENT_ROUTING.md",
+		"assets/TEMPLATE_AGENTS.md",
+		"assets/skills",
+		"bin"
+	],
+	"scripts": {
+		"build": "pnpm exec tsc -p tsconfig.json --noEmit && node scripts/build.mjs",
+		"typecheck": "pnpm exec tsc -p tsconfig.json --noEmit && pnpm exec tsc -p tsconfig.test.json --noEmit",
+		"test": "pnpm run build && pnpm exec vitest run",
+		"prepack": "pnpm run build",
+		"pack:check": "pnpm pack --dry-run",
+		"format": "biome check --write .",
+		"format:check": "biome check .",
+		"lint": "biome lint .",
+		"lint:fix": "biome lint --write .",
+		"check": "biome check",
+		"fix": "biome check --fix",
+		"prepare": "husky",
+		"precommit": "lint-staged"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/iamdevlinph/codex-kit.git"
+	},
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org",
+		"access": "public"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.5.3",
+		"@types/node": "20.19.43",
+		"esbuild": "0.28.1",
+		"husky": "9.1.7",
+		"lint-staged": "17.0.8",
+		"typescript": "7.0.1-rc",
+		"vitest": "4.1.10"
+	},
+	"packageManager": "pnpm@11.5.2",
+	"license": "ISC",
+	"lint-staged": {
+		"*": [
+			"biome check --write --no-errors-on-unmatched --files-ignore-unknown=true"
+		]
+	}
 }