@iamdevlinph/codex-kit 1.0.2 → 1.0.4

package/README.md

@@ -27,13 +27,23 @@ For one-off use without a global installation, prefix a command with
 `global install` copies reusable agents to `${CODEX_HOME:-~/.codex}` and
 maintains a marked routing section in the global `AGENTS.md`.
 
+The Sol root agent plans, coordinates, and validates. All project-file changes,
+including small one-file edits, are delegated to a Luna `quick-implementer` or
+`implementer`; the selected implementation agent edits directly without further
+delegation.
+
 `global configure` sets these defaults while preserving unrelated settings:
 
 ```toml
 model = "gpt-5.6-sol"
 model_reasoning_effort = "high"
+plan_mode_reasoning_effort = "high"
 ```
 
+Before changing these keys, codex-kit creates a timestamped `config.toml`
+backup and records their previous values. `global uninstall` restores those
+values without replacing unrelated configuration changed afterward.
+
 Use a different Codex home when needed:
 
 ```sh
@@ -49,8 +59,9 @@ Inspect the installed setup:
 pnpm dlx @iamdevlinph/codex-kit@latest global list
 ```
 
-The summary shows the Codex home, orchestrator, reasoning effort, routing
-status, and installed custom agents without dumping unrelated configuration.
+The summary shows the Codex home, orchestrator, normal and Plan-mode reasoning
+effort, routing status, and installed custom agents without dumping unrelated
+configuration.
 
 Uninstall package-managed global files:
 

package/assets/SUBAGENT_ROUTING.md

@@ -1,18 +1,24 @@
 # Subagent Routing
 
-Keep focused, tightly coupled work in the parent task. Delegate only bounded,
-independent work when it materially reduces parent-context growth, latency, or
-cost. The user does not need to request subagents explicitly.
+The root parent is the Sol planner and orchestrator. It must delegate all
+file-changing implementation to a Luna implementation agent. The user does not
+need to request subagents explicitly.
 
 The parent owns requirements, architecture, integration, and final validation.
 Never delegate the overall objective. Avoid parallel write-heavy work and never
 assign overlapping files to multiple agents.
 
-Do not delegate trivial conversation, known-target edits limited to one or two
-files, or straightforward commands. A slow command alone is not a reason to
-delegate.
+For any task that creates, edits, or deletes project files, delegate the work to
+exactly one of `quick-implementer` or `implementer`. Include bookkeeping commands
+that write project state in that assignment. The parent may perform read-only
+inspection and final validation, but must not make the project-file changes itself.
 
-When delegation is worthwhile:
+These routing rules apply to the root parent. An implementation subagent performs
+its assigned edits directly and must not delegate them again. Do not delegate
+trivial conversation or straightforward read-only commands. A slow command alone
+is not a reason to delegate.
+
+For delegated work:
 
 - Prefer one subagent. Add more only for independent, non-overlapping work.
 - Give each agent a bounded task and request a concise, decision-ready report.
@@ -27,9 +33,9 @@ Select custom agents by exact name:
 - Multi-file behavior change, debugging, or substantial tests: `implementer`
 - Independent review of high-risk or difficult-to-validate changes: `code-reviewer`
 
-Use either `quick-implementer` or `implementer` for a change, not both. Use the
-lowest reasoning effort that reliably fits the work. Do not substitute a generic
-agent when a matching custom role is available.
+Use either `quick-implementer` or `implementer` for a change, not both. Both roles
+run Luna; use the lowest reasoning effort that reliably fits the work. Do not
+substitute a generic agent when a matching custom role is available.
 
 There is no commit-pusher role. Never delegate Git publishing. Do not stage,
 commit, or push unless the user explicitly requests that operation in the current

package/bin/codex-kit.js

@@ -71,7 +71,7 @@ function topLevelConfigEntries(contents) {
         }
         if (inTable)
             continue;
-        const match = /^(\s*)(model|model_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
+        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))
@@ -97,7 +97,7 @@ function setTopLevelConfig(contents, desired) {
         const line = lines[index];
         if (line === undefined)
             continue;
-        const match = /^(\s*)(model|model_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
+        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;
@@ -128,7 +128,7 @@ function restoreTopLevelConfig(contents, config) {
         const line = lines[index];
         if (line === undefined)
             continue;
-        const match = /^(\s*)(model|model_reasoning_effort)\s*=\s*(.*?)\s*$/.exec(line);
+        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;
@@ -286,6 +286,7 @@ function configureGlobal(options) {
     const desired = {
         model: options.orchestrator,
         model_reasoning_effort: options.reasoningEffort,
+        plan_mode_reasoning_effort: options.reasoningEffort,
     };
     const priorState = loadState(home);
     const original = existsSync(configFile) ? readText(configFile) : "";
@@ -327,6 +328,7 @@ function configureGlobal(options) {
     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;
@@ -353,6 +355,7 @@ function listGlobal(options) {
     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"}`);
@@ -644,22 +647,30 @@ function help() {
     console.log(`codex-kit ${PACKAGE.version}
 
 Usage:
-  codex-kit global install [--codex-home PATH] [--force]
-  codex-kit global configure [--orchestrator MODEL] [--reasoning-effort LEVEL]
-  codex-kit global list [--codex-home PATH]
-  codex-kit global uninstall [--codex-home PATH]
-  codex-kit project init [--cwd PATH]
-  codex-kit project sync [--cwd PATH]
-  codex-kit project status [--cwd PATH]
-  codex-kit project mark-applied [--cwd PATH]
-  codex-kit version check
-  codex-kit --help
-  codex-kit --version
+  codex-kit <command> [options]
 
-Global configure defaults to gpt-5.6-sol with high reasoning and edits only
-the top-level model settings in CODEX_HOME/config.toml.
-Global install manages custom agents and a marked routing block under CODEX_HOME.
-Project sync refreshes TEMPLATE_AGENTS.md and never merges it into AGENTS.md.`);
+Commands:
+  global install       Install or update package-owned agents and routing guidance.
+  global configure     Set the orchestrator and normal/Plan reasoning defaults.
+  global list          Show model settings, routing status, and custom agents.
+  global uninstall     Restore managed config values and remove package-owned files.
+  project init         Initialize AGENTS.md, TEMPLATE_AGENTS.md, and project state.
+  project sync         Refresh TEMPLATE_AGENTS.md without editing AGENTS.md.
+  project status       Show whether template changes still need reconciliation.
+  project mark-applied Record the current template as reconciled with AGENTS.md.
+  version check        Compare the installed version with the latest npm release.
+  --help               Show this help.
+  --version            Print the installed version.
+
+Options:
+  --codex-home PATH         Use a Codex home other than CODEX_HOME or ~/.codex.
+  --cwd PATH                Use a project directory other than the current directory.
+  --force                   Replace modified files or config managed by codex-kit.
+  --orchestrator MODEL      Set the root/orchestrator model (default: gpt-5.6-sol).
+  --model MODEL             Alias for --orchestrator.
+  --reasoning-effort LEVEL  Set normal and Plan-mode effort (default: high).
+
+Run a command with only its applicable options.`);
 }
 export function main(argv = process.argv.slice(2)) {
     const options = parse(argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamdevlinph/codex-kit",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Portable Codex subagents and project AGENTS.md defaults.",
   "type": "module",
   "bin": {