@iamdevlinph/codex-kit 1.0.12 → 1.0.13

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

@@ -244,8 +244,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,276 +1,22 @@
 #!/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 io}from"node:path";import{fileURLToPath as ao}from"node:url";import{copyFileSync as Ve,existsSync as m,mkdirSync as We,readdirSync as j,rmSync as T,statSync as ge}from"node:fs";import{join as d}from"node:path";import{createHash as Te}from"node:crypto";import{copyFileSync as Oe,existsSync as H,mkdirSync as _e,readFileSync as Q,renameSync as Ce,writeFileSync as je}from"node:fs";import{dirname as Le}from"node:path";var k=o=>typeof o=="object"&&o!==null,S=o=>Te("sha256").update(o).digest("hex"),b=o=>Q(o),g=o=>Q(o,"utf8");function E(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 Oe(o,t),console.log(`backup: ${t}`),t}function u(o,e){_e(Le(o),{recursive:!0});let t=`${o}.codex-kit.tmp-${process.pid}`;je(t,e),Ce(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 Ne}from"node:fs";import{dirname as Ge,join as $,resolve as Re}from"node:path";import{fileURLToPath as Ie}from"node:url";var M=Re(Ge(Ie(import.meta.url)),".."),N=$(M,"assets"),F=$(N,"agents"),ee=$(N,"skills"),h="codex-kit-reconcile-agents",oe=$(ee,h,"SKILL.md"),te=$(ee,h,"agents","openai.yaml"),U=$(N,"SUBAGENT_ROUTING.md"),ne=$(M,"bin","routing-hook.js"),D=$(N,"TEMPLATE_AGENTS.md"),p=JSON.parse(Ne($(M,"package.json"),"utf8")),J=p.publishConfig?.registry??"https://registry.npmjs.org";import{existsSync as ie,rmSync as Ke}from"node:fs";import{join as Me}from"node:path";import{copyFileSync as Pe,existsSync as G,rmSync as He}from"node:fs";import{join as re}from"node:path";var _=".codex-kit-state.json";function O(o){let e=re(o,_);if(!G(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 R(o,e){u(re(o,_),`${JSON.stringify(e,null,2)}
+`)}function B(o,e,t,n,r){let i=b(o),s=S(i),a=n.files[t];if(!G(e))return u(e,i),console.log(`installed: ${e}`),{target:e,hash:s,ownership:"created",backup:null};let c=S(b(e));if(c===s)return console.log(`unchanged: ${e}`),a??{target:e,hash:s,ownership:"preexisting",backup:null};let f=a&&a.target===e&&a.ownership!=="preexisting"&&a.hash===c;if(!f&&!r)return console.warn(`preserved modified or pre-existing file: ${e} (use --force to replace)`),a??null;let l=E(e);return u(e,i),console.log(`updated: ${e}`),{target:e,hash:s,ownership:f?a.ownership:"replaced",backup:f?a.backup:l}}function se(o){let{target:e}=o;!G(e)||S(b(e))!==o.hash?console.warn(`preserved modified or missing file: ${e}`):o.ownership==="created"?(He(e),console.log(`removed: ${e}`)):o.ownership==="replaced"&&o.backup&&G(o.backup)?(Pe(o.backup,e),console.log(`restored: ${e}`)):console.log(`preserved pre-existing file: ${e}`)}function I(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 C=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} = ${C(e[c])}`,n.add(c))}let i=Object.keys(e).filter(s=>!n.has(s)).map(s=>`${s} = ${C(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]!==C(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 V(o){let e=o.codexHome,t=Me(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=I(i);if(r.config?.target===t&&Object.entries(r.config.desired).some(([l,x])=>s.get(l)?.value!==C(x))&&!o.force){console.warn(`preserved modified config: ${t} (use --force to replace)`);return}let a=Fe(i,n);a!==i?(E(t),u(t,a),console.log(`configured orchestrator: ${t}`)):console.log(`unchanged: ${t}`);let c=r.config?.previous??{};for(let f of Object.keys(n)){if(f in c)continue;let l=s.get(f);c[f]=l?{present:!0,value:l.value}:{present:!1}}r.version=p.version,r.config={target:t,desired:n,previous:c},R(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=I(e);if(Object.entries(o.desired).some(([i,s])=>t.get(i)?.value!==C(s))){console.warn(`preserved modified config: ${o.target}`);return}let r=Ue(e,o);r!==e&&(E(o.target),r.trim()?u(o.target,r):Ke(o.target),console.log(`restored config: ${o.target}`))}import{existsSync as W,rmSync as De}from"node:fs";import{join as le}from"node:path";var Je=o=>`'${o.replaceAll("'",`'"'"'`)}'`,Be=o=>({command:`/usr/bin/env node ${Je(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 fe(o,e){let t=le(o,"hooks.json"),n=Be(le(o,"codex-kit","routing-hook.js")),r=e?.created??!W(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)}
+`,f=W(t)?g(t):"";return c!==f&&(E(t),u(t,c),console.log(`updated: ${t}`)),{target:t,...n,created:r}}function de(o){if(!W(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,E(o.target),o.created&&!Object.keys(e).length?De(o.target):u(o.target,`${JSON.stringify(e,null,2)}
+`),console.log(`removed managed routing hooks from: ${o.target}`)}var z="<!-- BEGIN codex-kit:subagent-routing -->",pe="<!-- END codex-kit:subagent-routing -->",ze=(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=ze(e,t,n);return r>=0?`${o.slice(0,r)}${s}${o.slice(i+n.length)}`:`${o.trimEnd()}${o.trim()?`
+
+`:""}${s}
+`}function Xe(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;We(e,{recursive:!0});let t=O(e),n={version:p.version,files:{},globalAgents:null,hooks:null,config:t.config??null};for(let f of j(F).filter(l=>l.endsWith(".toml")).sort()){let l=`agents/${f}`,x=B(d(F,f),d(e,"agents",f),l,t,o.force);x&&(n.files[l]=x)}let r=[[U,d(e,"SUBAGENT_ROUTING.md"),"routing"],[oe,d(e,"skills",h,"SKILL.md"),`skills/${h}/SKILL.md`],[te,d(e,"skills",h,"agents","openai.yaml"),`skills/${h}/agents/openai.yaml`],[ne,d(e,"codex-kit","routing-hook.js"),"routing-hook"]];for(let[f,l,x]of r){let L=B(f,l,x,t,o.force);L&&(n.files[x]=L)}for(let[f,l]of Object.entries(t.files))f in n.files||(!m(l.target)||S(b(l.target))!==l.hash?(console.warn(`preserved stale modified or missing file: ${l.target}`),n.files[f]=l):l.ownership==="created"?(T(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=d(e,"AGENTS.md"),s=m(i)?g(i):"",a=qe(s,g(U),z,pe);a!==s&&(E(i),u(i,a),console.log(`updated: ${i}`)),n.globalAgents={target:i},n.hooks=fe(e,t.hooks),R(e,n);let c=d(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=d(e,"config.toml"),n=d(e,"AGENTS.md"),r=O(e),i=m(t)?I(g(t)):new Map,s=y=>{let v=i.get(y)?.value;if(!v)return"not set";try{return String(JSON.parse(v))}catch{return v}};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(d(e,_))?r.version:"not installed"}`),console.log(`Global routing: ${m(n)&&g(n).includes(z)?"installed":"not installed"}`),console.log(`Routing file: ${m(d(e,"SUBAGENT_ROUTING.md"))?d(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=[[d(e,"skills",h,"SKILL.md"),r.files[`skills/${h}/SKILL.md`]],[d(e,"skills",h,"agents","openai.yaml"),r.files[`skills/${h}/agents/openai.yaml`]]],f=c.every(([y,v])=>m(y)&&v&&S(b(y))===v.hash)?"installed":c.some(([y])=>m(y))?"modified or incomplete":"missing";console.log(`Reconciliation skill: ${f}`),console.log("Custom agents:");let l=d(e,"agents"),x=m(l)?j(l).filter(y=>y.endsWith(".toml")).sort():[];if(!x.length){console.log("  (none)");return}let L=new Set(Object.values(r.files).map(y=>y.target));for(let y of x){let v=d(l,y),we=g(v),P=Ae=>new RegExp(`^${Ae}\\s*=\\s*"([^"]*)"`,"m").exec(we)?.[1]??"not set";console.log(`  ${P("name")} \u2014 ${P("model")}, ${P("model_reasoning_effort")} (${L.has(v)?"managed":"unmanaged"})`)}}function he(o){let e=o.codexHome,t=d(e,_);if(!m(t)){console.log(`No installer state at ${t}; nothing removed.`);return}let n=O(e);for(let f of Object.values(n.files))se(f);let r=n.globalAgents?.target??d(e,"AGENTS.md");if(m(r)){let f=g(r),l=Xe(f,z,pe);l!==f&&(E(r),l?u(r,l):T(r),console.log(`removed managed routing from: ${r}`))}n.config&&ae(n.config),n.hooks&&de(n.hooks);let i=d(e,"skills",h),s=d(i,"agents");m(s)&&ge(s).isDirectory()&&!j(s).length&&T(s,{recursive:!0}),m(i)&&ge(i).isDirectory()&&!j(i).length&&T(i,{recursive:!0});let a=d(e,"codex-kit","allowances");m(a)&&T(a,{recursive:!0,force:!0});let c=d(e,"codex-kit");m(c)&&!j(c).length&&T(c,{recursive:!0}),T(t),console.log(`Codex kit uninstalled from ${e}`)}import{existsSync as w,statSync as Ye}from"node:fs";import{join as A}from"node:path";var ke=".codex-kit-state.json",Ze="<!-- BEGIN codex-kit:shared-template -->",Qe="<!-- END codex-kit:shared-template -->";function q(o){let e=A(o,ke);if(!w(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(A(o,ke),`${JSON.stringify(e,null,2)}
+`),X=o=>{if(!w(o)||!Ye(o).isDirectory())throw new Error(`Not a directory: ${o}`)};function eo(){return`Template reference updated. Use the global $${h} skill to reconcile it semantically.
 
 Inspect TEMPLATE_AGENTS.md, AGENTS.md, .codex-kit-state.json, existing
 .agents/skills, and codex-kit project status. Preserve local adaptations and
@@ -278,536 +24,12 @@ 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
+and validation, then report any template-worthy generalized promotion.`}function Ee(o){let{cwd:e}=o;X(e);let t=A(e,"AGENTS.md"),n=A(e,"TEMPLATE_AGENTS.md"),r=Buffer.from(g(D)),i=S(r),s=q(e);if(w(n)){let a=S(b(n));if(a!==i&&(!s.template.availableHash||a!==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}a===i?console.log(`unchanged: ${n}`):(E(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),!w(t))u(t,`# Project-Specific Instructions
 
 <!-- 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}
+`),console.log(`created project instructions file: ${t}`);else{let a=g(t);(a.includes(Ze)||a.includes(Qe))&&(console.warn(`preserved legacy managed template in: ${t}`),console.warn("Ask Codex to migrate it to semantic template reconciliation before applying updates."))}console.log(eo())}function ye(o){let{cwd:e}=o;X(e);let t=A(e,"TEMPLATE_AGENTS.md"),n=q(e),r=n.template.availableHash??null,i=w(t)?S(b(t)):null;if(console.log(`Project: ${e}`),!i){console.log("Status: not initialized (run codex-kit project sync)");return}if(!w(A(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"}`),S(b(D))!==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 be(o){let{cwd:e}=o;X(e);let t=A(e,"TEMPLATE_AGENTS.md"),n=A(e,"AGENTS.md");if(!w(t))throw new Error(`Missing ${t}; run project sync first.`);if(!w(n))throw new Error(`Missing ${n}; reconcile the template into AGENTS.md first.`);let r=q(e);r.version=1,r.template={...r.template,appliedHash:S(b(t)),appliedAt:new Date().toISOString()},Se(e,r),console.log(`recorded template reconciliation: ${t}`)}import{spawnSync as oo}from"node:child_process";function to(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=oo(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=to(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 no}from"node:os";import{join as ro,resolve as Y}from"node:path";function ve(o){let e={cwd:process.cwd(),codexHome:Y(process.env.CODEX_HOME||ro(no(),".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=Y(r):e.codexHome=Y(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 so(){console.log(`codex-kit ${p.version}
 
 Usage:
   codex-kit <command> [options]
@@ -852,40 +74,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 Z(o=process.argv.slice(2)){let e=ve(o);if(e.positionals.includes("--version")){console.log(p.version);return}if(!e.positionals.length||e.positionals.includes("--help")){so();return}let[t,n]=e.positionals;if(t==="global"&&n==="install")me(e);else if(t==="global"&&n==="configure")V(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"))Ee(e);else if(t==="project"&&n==="status")ye(e);else if(t==="project"&&n==="mark-applied")be(e);else if(t==="version"&&n==="check")xe();else throw new Error(`Unknown command: ${e.positionals.join(" ")}`)}if(process.argv[1]&&$e(io(process.argv[1]))===$e(ao(import.meta.url)))try{Z()}catch(o){console.error(`error: ${o instanceof Error?o.message:String(o)}`),process.exitCode=1}export{Z 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.13",
+	"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"
+		]
+	}
 }