poe-code 3.0.30 → 3.0.32

package/dist/index.js

@@ -961,7 +961,8 @@ async function applyTemplateMerge(mutation, context, options, formatName) {
     templateDoc = format.parse(rendered);
   } catch (error2) {
     throw new Error(
-      `Failed to parse rendered template "${mutation.templateId}" as ${formatName.toUpperCase()}: ${error2}`
+      `Failed to parse rendered template "${mutation.templateId}" as ${formatName.toUpperCase()}: ${error2}`,
+      { cause: error2 }
     );
   }
   const rawContent = await readFileIfExists(context.fs, targetPath);
@@ -14722,7 +14723,21 @@ var require_PROMPT_plan = __commonJS({
 // src/templates/ralph/PROMPT_build.md
 var require_PROMPT_build = __commonJS({
   "src/templates/ralph/PROMPT_build.md"(exports, module) {
-    module.exports = '# Build\n\nYou are an autonomous coding agent. Your task is to complete the work for exactly one story and record the outcome.\n\n## Paths\n- Plan: {{PLAN_PATH}}\n- Progress Log: {{PROGRESS_PATH}}\n- Guardrails: {{GUARDRAILS_PATH}}\n- Guardrails Reference: {{GUARDRAILS_REF}}\n- Context Reference: {{CONTEXT_REF}}\n- Errors Log: {{ERRORS_LOG_PATH}}\n- Activity Log: {{ACTIVITY_LOG_PATH}}\n- Activity Logger: {{ACTIVITY_CMD}}\n- No-commit: {{NO_COMMIT}}\n- Repo Root: {{REPO_ROOT}}\n- Run ID: {{RUN_ID}}\n- Iteration: {{ITERATION}}\n- Run Log: {{RUN_LOG_PATH}}\n- Run Summary: {{RUN_META_PATH}}\n\n## Global Quality Gates (apply to every story)\n{{QUALITY_GATES}}\n\n## Selected Story (Do not change scope)\nID: {{STORY_ID}}\nTitle: {{STORY_TITLE}}\n\nStory details:\n{{STORY_BLOCK}}\n\nIf the story details are empty or missing, STOP and report that the plan story format could not be parsed.\n\n## Rules (Non-Negotiable)\n- Implement **only** the work required to complete the selected story.\n- Complete all tasks associated with this story (and only this story).\n- Do NOT ask the user questions.\n- Do NOT change unrelated code.\n- Do NOT assume something is unimplemented \u2014 confirm by reading code.\n- Implement completely; no placeholders or stubs.\n- If No-commit is true, do NOT commit or push changes.\n- Do NOT edit the plan file (status is handled by the loop).\n- All changes made during the run must be committed (including updates to progress/logs).\n - Before committing, perform a final **security**, **performance**, and **regression** review of your changes.\n\n## Your Task (Do this in order)\n1. Read {{GUARDRAILS_PATH}} before any code changes.\n2. Read {{ERRORS_LOG_PATH}} for repeated failures to avoid.\n3. Read {{PLAN_PATH}} for global context (do not edit).\n4. Fully audit and read all necessary files to understand the task end-to-end before implementing. Do not assume missing functionality.\n5. Implement only the tasks that belong to {{STORY_ID}}.\n6. Run verification commands listed in the story and the global quality gates.\n7. If the project has a build or dev workflow, run what applies:\n   - Build step (e.g., `npm run build`) if defined.\n   - Dev server (e.g., `npm run dev`, `wrangler dev`) if it is the normal validation path.\n   - Confirm no runtime/build errors in the console.\n8. Perform a brief audit before committing:\n   - **Security:** check for obvious vulnerabilities or unsafe handling introduced by your changes.\n   - **Performance:** check for avoidable regressions (extra queries, heavy loops, unnecessary re-renders).\n   - **Regression:** verify existing behavior that could be impacted still works.\n9. If No-commit is false, commit changes using the `$commit` skill.\n    - Stage everything: `git add -A`\n    - Confirm a clean working tree after commit: `git status --porcelain` should be empty.\n    - After committing, capture the commit hash and subject using:\n      `git show -s --format="%h %s" HEAD`.\n10. Append a progress entry to {{PROGRESS_PATH}} with run/commit/test details (format below).\n    If No-commit is true, skip committing and note it in the progress entry.\n\n## Progress Entry Format (Append Only)\n```\n## [Date/Time] - {{STORY_ID}}: {{STORY_TITLE}}\nThread: [codex exec session id if available, otherwise leave blank]\nRun: {{RUN_ID}} (iteration {{ITERATION}})\nRun log: {{RUN_LOG_PATH}}\nRun summary: {{RUN_META_PATH}}\n- Guardrails reviewed: yes\n- No-commit run: {{NO_COMMIT}}\n- Commit: <hash> <subject> (or `none` + reason)\n- Post-commit status: `clean` or list remaining files\n- Verification:\n  - Command: <exact command> -> PASS/FAIL\n  - Command: <exact command> -> PASS/FAIL\n- Files changed:\n  - <file path>\n  - <file path>\n- What was implemented\n- **Learnings for future iterations:**\n  - Patterns discovered\n  - Gotchas encountered\n  - Useful context\n---\n```\n\n## Completion Signal\nOnly output the completion signal when the **selected story** is fully complete and verified.\nWhen the selected story is complete, output:\n<promise>COMPLETE</promise>\n\nOtherwise, end normally without the signal.\n\n## Additional Guardrails\n- When authoring documentation, capture the why (tests + implementation intent).\n- If you hit repeated errors, log them in {{ERRORS_LOG_PATH}} and add a Sign to {{GUARDRAILS_PATH}} using {{GUARDRAILS_REF}} as the template.\n\n## Activity Logging (Required)\nLog major actions to {{ACTIVITY_LOG_PATH}} using the helper:\n```\n{{ACTIVITY_CMD}} "message"\n```\nLog at least:\n- Start of work on the story\n- After major code changes\n- After tests/verification\n- After updating progress log\n\n## Browser Testing (Required for Frontend Stories)\nIf the selected story changes UI, you MUST verify it in the browser:\n1. Load the `dev-browser` skill.\n2. Navigate to the relevant page.\n3. Verify the UI changes work as expected.\n4. Take a screenshot if helpful for the progress log.\n\nA frontend story is NOT complete until browser verification passes.\n';
+    module.exports = '# Build\n\nYou are an autonomous coding agent. Your task is to complete the work for exactly one story and record the outcome.\n\n## Paths\n\n- Plan: {{PLAN_PATH}}\n- Progress Log: {{PROGRESS_PATH}}\n- Guardrails: {{GUARDRAILS_PATH}}\n- Guardrails Reference: {{GUARDRAILS_REF}}\n- Context Reference: {{CONTEXT_REF}}\n- Errors Log: {{ERRORS_LOG_PATH}}\n- Activity Log: {{ACTIVITY_LOG_PATH}}\n- Activity Logger: {{ACTIVITY_CMD}}\n- No-commit: {{NO_COMMIT}}\n- Repo Root: {{REPO_ROOT}}\n- Run ID: {{RUN_ID}}\n- Iteration: {{ITERATION}}\n- Run Log: {{RUN_LOG_PATH}}\n- Run Summary: {{RUN_META_PATH}}\n\n## Global Quality Gates (apply to every story)\n\n{{QUALITY_GATES}}\n\n## Selected Story (Do not change scope)\n\nID: {{STORY_ID}}\nTitle: {{STORY_TITLE}}\n\nStory details:\n{{STORY_BLOCK}}\n\nIf the story details are empty or missing, STOP and report that the plan story format could not be parsed.\n\n## Rules (Non-Negotiable)\n\n- Implement **only** the work required to complete the selected story.\n- Complete all tasks associated with this story (and only this story).\n- Do NOT ask the user questions.\n- Do NOT change unrelated code.\n- Do NOT assume something is unimplemented \u2014 confirm by reading code.\n- Implement completely; no placeholders or stubs.\n- If No-commit is true, do NOT commit or push changes.\n- Do NOT edit the plan file (status is handled by the loop).\n- All changes in git made during the run must be committed\n- Do NOT commit the progress log ({{PROGRESS_PATH}}). It is gitignored.\n- Before committing, perform a final **security**, **performance**, and **regression** review of your changes.\n\n## Your Task (Do this in order)\n\n1. Read {{GUARDRAILS_PATH}} before any code changes.\n2. Read {{ERRORS_LOG_PATH}} for repeated failures to avoid.\n3. Read {{PLAN_PATH}} for global context (do not edit).\n4. Fully audit and read all necessary files to understand the task end-to-end before implementing. Do not assume missing functionality.\n5. Implement only the tasks that belong to {{STORY_ID}}.\n6. Run verification commands listed in the story and the global quality gates.\n7. If the project has a build or dev workflow, run what applies:\n   - Build step (e.g., `npm run build`) if defined.\n   - Test step (e.g. `npm run test`) if defined.\n   - Confirm no runtime/build errors in the console.\n8. Perform a brief audit before committing:\n   - **Security:** check for obvious vulnerabilities or unsafe handling introduced by your changes.\n   - **Performance:** check for avoidable regressions (extra queries, heavy loops, unnecessary re-renders).\n   - **Regression:** verify existing behavior that could be impacted still works.\n9. If No-commit is false, commit changes.\n    - Follow the project\'s commit guidelines\n    - Stage only project files you changed\n    - After committing, capture the commit hash and subject using:\n      `git show -s --format="%h %s" HEAD`.\n10. Append a progress entry to {{PROGRESS_PATH}} with run/commit/test details (format below).\n    Do NOT commit this file.\n\n## Progress Entry Format (Append Only)\n\n```\n## [Date/Time] - {{STORY_ID}}: {{STORY_TITLE}}\nRun: {{RUN_ID}} (iteration {{ITERATION}})\nRun log: {{RUN_LOG_PATH}}\nRun summary: {{RUN_META_PATH}}\n- Guardrails reviewed: yes\n- No-commit run: {{NO_COMMIT}}\n- Commit: <hash> <subject> (or `none` + reason)\n- Verification:\n  - Command: <exact command> -> PASS/FAIL\n  - Command: <exact command> -> PASS/FAIL\n- Files changed:\n  - <file path>\n  - <file path>\n- What was implemented\n- **Learnings for future iterations:**\n  - Patterns discovered\n  - Gotchas encountered\n  - Useful context\n---\n```\n\n## Completion Signal\n\nOnly output the completion signal when the **selected story** is fully complete and verified.\nWhen the selected story is complete, output:\n<promise>COMPLETE</promise>\n\nOtherwise, end normally without the signal.\n\n## Additional Guardrails\n\n- When authoring documentation, capture the why (tests + implementation intent).\n- If you hit repeated errors, log them in {{ERRORS_LOG_PATH}} and add a Sign to {{GUARDRAILS_PATH}} using {{GUARDRAILS_REF}} as the template.\n\n## Activity Logging (Required)\n\nLog major actions to {{ACTIVITY_LOG_PATH}} using the CLI command:\n\n```\n{{ACTIVITY_CMD}} "message"\n```\n\nLog at least:\n\n- Start of work on the story\n- After major code changes\n- After tests/verification\n';
+  }
+});
+
+// src/templates/ralph/references/GUARDRAILS.md
+var require_GUARDRAILS = __commonJS({
+  "src/templates/ralph/references/GUARDRAILS.md"(exports, module) {
+    module.exports = '# Guardrails Reference ("Signs")\n\nThis document explains how to create and use guardrails in Ralph.\n\n## The Signs Metaphor\n\nFrom Geoffrey Huntley:\n\n> "Ralph is very good at making playgrounds, but he comes home bruised because he fell off the slide, so one then tunes Ralph by adding a sign next to the slide saying \'SLIDE DOWN, DON\'T JUMP, LOOK AROUND,\' and Ralph is more likely to look and see the sign."\n\nSigns are explicit instructions added to prevent known failure modes.\n\n## Anatomy of a Sign\n\n```markdown\n### Sign: [Descriptive Name]\n- **Trigger**: When this situation occurs\n- **Instruction**: What to do instead\n- **Added after**: When/why this was added\n- **Example**: Concrete example if helpful\n```\n\n## Types of Signs\n\n### 1. Preventive Signs\n\nStop problems before they happen:\n\n```markdown\n### Sign: Validate Before Trust\n- **Trigger**: When receiving external input\n- **Instruction**: Always validate and sanitize input before using it\n- **Added after**: Iteration 3 - SQL injection vulnerability\n```\n\n### 2. Corrective Signs\n\nFix recurring mistakes:\n\n```markdown\n### Sign: Check Return Values\n- **Trigger**: When calling functions that can fail\n- **Instruction**: Always check return values and handle errors\n- **Added after**: Iteration 7 - Null pointer exception\n```\n\n### 3. Process Signs\n\nEnforce good practices:\n\n```markdown\n### Sign: Test Before Commit\n- **Trigger**: Before committing changes\n- **Instruction**: Run the test suite and ensure all tests pass\n- **Added after**: Iteration 2 - Broken tests committed\n```\n\n### 4. Architecture Signs\n\nGuide design decisions:\n\n```markdown\n### Sign: Single Responsibility\n- **Trigger**: When a function grows beyond 50 lines\n- **Instruction**: Consider splitting into smaller, focused functions\n- **Added after**: Iteration 12 - Unmaintainable god function\n```\n\n## When to Add Signs\n\nAdd a sign when:\n\n1. **The same mistake happens twice** - Once is learning, twice is a pattern\n2. **A subtle bug is found** - Prevent future occurrences\n3. **A best practice is violated** - Reinforce good habits\n4. **Context-specific knowledge is needed** - Project-specific conventions\n\n## Sign Lifecycle\n\n### Creation\n\n```markdown\n### Sign: [New Sign]\n- **Trigger**: [When it applies]\n- **Instruction**: [What to do]\n- **Added after**: Iteration N - [What happened]\n```\n\n### Refinement\n\nIf a sign isn\'t working:\n- Make the trigger more specific\n- Make the instruction clearer\n- Add examples\n\n### Retirement\n\nSigns can be removed when:\n- The underlying issue is fixed at a deeper level\n- The sign is no longer relevant\n- The sign is causing more problems than it solves\n\n## Example Signs Library\n\n### Security\n\n```markdown\n### Sign: Sanitize All Input\n- **Trigger**: Any user-provided data\n- **Instruction**: Use parameterized queries, escape HTML, validate types\n- **Example**: `db.query("SELECT * FROM users WHERE id = ?", [userId])`\n```\n\n### Error Handling\n\n```markdown\n### Sign: Graceful Degradation\n- **Trigger**: External service calls\n- **Instruction**: Always have a fallback for when services are unavailable\n- **Example**: Cache results, provide default values, show friendly errors\n```\n\n### Testing\n\n```markdown\n### Sign: Test the Unhappy Path\n- **Trigger**: Writing tests for new functionality\n- **Instruction**: Include tests for error cases, edge cases, and invalid input\n```\n\n### Code Quality\n\n```markdown\n### Sign: Explain Why, Not What\n- **Trigger**: Writing comments\n- **Instruction**: Comments should explain reasoning, not describe obvious code\n- **Example**: `// Using retry because API is flaky under load` not `// Call the API`\n```\n\n## Automatic Sign Detection\n\nThe Ralph hooks can automatically detect some patterns and suggest signs:\n\n- **Thrashing**: Same file edited many times \u2192 "Step back and reconsider"\n- **Repeated errors**: Same test failing \u2192 "Check the test assumptions"\n- **Large changes**: Big diffs \u2192 "Consider smaller increments"\n\nThese are logged in `.poe-code-ralph/failures.md` and can be promoted to guardrails.\n\n## Using Signs Effectively\n\n### Do\n\n- Keep signs concise and actionable\n- Include concrete examples\n- Update signs when they\'re not working\n- Remove outdated signs\n\n### Don\'t\n\n- Add signs for every minor issue\n- Make signs too vague ("be careful")\n- Ignore signs that keep triggering\n- Let the guardrails file become overwhelming\n\n## Integration with Ralph\n\nSigns are:\n1. Stored in `.poe-code-ralph/guardrails.md`\n2. Injected into context at the start of each iteration\n3. Referenced when relevant situations arise\n4. Updated based on observed failures\n\nThe goal is a self-improving system where each failure makes future iterations smarter.\n';
+  }
+});
+
+// src/templates/ralph/references/CONTEXT_ENGINEERING.md
+var require_CONTEXT_ENGINEERING = __commonJS({
+  "src/templates/ralph/references/CONTEXT_ENGINEERING.md"(exports, module) {
+    module.exports = "# Context Engineering Reference\n\nThis document explains the malloc/free metaphor for LLM context management that underlies the [Ralph Wiggum technique](https://ghuntley.com/ralph/), originally developed by Geoffrey Huntley.\n\n## The malloc() Metaphor\n\nIn traditional programming, memory management follows a clear pattern: `malloc()` allocates memory, and `free()` releases it. In LLM context windows, **there is no equivalent to `free()`**. Every operation that adds information to context\u2014reading files, executing tools, generating responses\u2014allocates context space permanently until the conversation ends.\n\nThe only way to \"free\" context is to start a new conversation.\n\n## Why This Matters\n\n### Context Pollution\n\nContext pollution occurs when the LLM's context window accumulates information that interferes with current work. This includes failed attempts, unrelated code snippets, error traces, and mixed concerns from multiple tasks.\n\n```\nTask 1: Build authentication \u2192 context contains auth code, JWT docs, security patterns\nTask 2: Build UI components \u2192 context now ALSO contains auth stuff\n\nResult: LLM might suggest auth-related patterns when building UI\n        or mix concerns inappropriately\n```\n\n### Autoregressive Failure\n\nWhen context contains pollution, each generated token is influenced by that pollution, creating a feedback loop where the model's outputs become increasingly off-base. This is [autoregressive failure](https://ghuntley.com/gutter/): the model predicts the next token based on a context window that contains increasingly irrelevant or misleading information.\n\n### The Gutter\n\n> \"If the bowling ball is in the gutter, there's no saving it. It's in the gutter.\"\n> \u2014 [Geoffrey Huntley](https://ghuntley.com/gutter/)\n\nThe \"gutter\" is the state where context pollution has reached a point of no return. Like a bowling ball in the gutter, once the agent is stuck in polluted context, there is no recovering without starting fresh.\n\n## Context Health Indicators\n\n### \u{1F7E2} Healthy Context\n- Single focused task\n- Relevant files only\n- Clear progress\n- Under 40% capacity\n\n### \u{1F7E1} Warning Signs\n- Multiple unrelated topics discussed\n- Several failed attempts in history\n- Approaching 40% capacity\n- Repeated similar errors\n\n### \u{1F534} Critical / Gutter\n- Mixed concerns throughout\n- Circular failure patterns\n- Over 40% capacity\n- Model suggesting irrelevant solutions\n\n## Best Practices\n\n### 1. One Task Per Context\n\nHuntley's #1 recommendation: use a context window for one task, and one task only. Don't ask \"fix the auth bug AND add the new feature\". Do them in separate conversations.\n\n### 2. Fresh Start on Topic Change\n\nFinished auth? Start a new conversation for the next feature.\n\n### 3. Don't Redline\n\nThe \"dumb zone\" hits around 40% context utilization. Past that, reasoning degrades. The [Ralph Playbook](https://claytonfarr.github.io/ralph-playbook/) recommends rotating context at 40% of total capacity (e.g., 80k/200k tokens), not at 90%+. This is \"deterministically bad in an undeterministic world\"\u2014it wastes some work on rotation, but guarantees the agent never reaches the gutter.\n\n### 4. Recognize the Gutter\n\nIf you're seeing:\n- Same error 3+ times\n- Solutions that don't match the problem\n- Circular suggestions\n\nStart fresh. Your progress is in the files.\n\n### 5. State in Files, Not Context\n\nReal state lives in files and Git, not in the LLM's context window. Context is treated as ephemeral scratch space that will be discarded at rotation. The next conversation can read your files. Context is ephemeral; files are permanent.\n\n## Ralph's Approach\n\nThe [original Ralph technique](https://ghuntley.com/ralph/) (`while :; do cat PROMPT.md | agent ; done`) naturally implements these principles:\n\n1. **Each iteration is a fresh process** \u2014 Context is freed\n2. **State persists in files** \u2014 Progress survives context resets\n3. **Same prompt each time** \u2014 Focused, single-task context\n4. **Backpressure beats direction** \u2014 Instead of telling the agent what to do, engineer an environment where wrong outputs get rejected automatically\n\nThis implementation aims to bring these benefits while working within Cursor's session model.\n\n## Measuring Context\n\nRough estimates:\n- 1 token \u2248 4 characters\n- Average code file: 500-2000 tokens\n- Large file: 5000+ tokens\n- Conversation history: 100-500 tokens per exchange\n\nTrack allocations in `.poe-code-ralph/context-log.md` to stay aware.\n\n## Theory vs Implementation\n\nThe capacity percentages above (40%, etc.) are **theoretical guidelines** from the original Ralph methodology. In practice, agents like Claude Code and Cursor don't expose context usage programmatically.\n\n### What's Available\n\n| Agent | Context Visibility |\n|-------|-------------------|\n| Claude Code | `/context` command (interactive only) |\n| Cursor | No real-time access; Admin API for team analytics |\n| Codex | No programmatic access |\n\nThere are [open feature requests](https://github.com/anthropics/claude-code/issues/10593) to expose this data, but as of now it's not available for automated rotation.\n\n### What We Use Instead\n\nSince we can't measure context usage directly, this implementation uses proxy signals:\n\n1. **Iteration count** (`maxIterations`) \u2014 Rotate after N iterations regardless of context. Conservative default ensures we never hit the gutter.\n\n2. **Overbaking detection** (`maxFailures`) \u2014 Track consecutive failures per story. If a story fails N times in a row, it's likely we're in the gutter or the story needs to be split.\n\n3. **Stale timeout** (`staleSeconds`) \u2014 Auto-reopen stories stuck in `in_progress` state, handling crashes or abandoned runs.\n\nThe percentages in this document are useful for **humans** making manual decisions about when to start a new conversation. For automated loops, fresh context per iteration sidesteps the problem entirely.\n\n## When to Start Fresh\n\n**Definitely start fresh when:**\n- Switching to unrelated task\n- Context over 40% full\n- Same error 3+ times\n- Model suggestions are off-topic\n\n**Consider starting fresh when:**\n- Significant topic shift within task\n- Feeling \"stuck\"\n- Multiple failed approaches in history\n\n---\n\n## Further Reading\n\n- [Ralph Wiggum as a Software Engineer](https://ghuntley.com/ralph/) \u2014 Original technique by Geoffrey Huntley\n- [Autoregressive Queens of Failure](https://ghuntley.com/gutter/) \u2014 The gutter metaphor explained\n- [The Ralph Playbook](https://claytonfarr.github.io/ralph-playbook/) \u2014 Comprehensive guide by Clayton Farr\n- [how-to-ralph-wiggum](https://github.com/ghuntley/how-to-ralph-wiggum) \u2014 Official methodology guide\n- [ralph](https://github.com/snarktank/ralph) \u2014 Reference implementation of the Ralph autonomous agent loop\n- [From ReAct to Ralph Loop](https://www.alibabacloud.com/blog/from-react-to-ralph-loop-a-continuous-iteration-paradigm-for-ai-agents_602799) \u2014 Comparison with other agent paradigms\n";
   }
 });
 
@@ -15228,7 +15243,8 @@ var dark = {
   success: (text4) => chalk2.green(text4),
   warning: (text4) => chalk2.yellow(text4),
   error: (text4) => chalk2.red(text4),
-  info: (text4) => chalk2.magenta(text4)
+  info: (text4) => chalk2.magenta(text4),
+  badge: (text4) => chalk2.bgYellow.black(` ${text4} `)
 };
 var light = {
   header: (text4) => chalk2.hex("#a200ff").bold(text4),
@@ -15243,7 +15259,8 @@ var light = {
   success: (text4) => chalk2.hex("#008800")(text4),
   warning: (text4) => chalk2.hex("#cc6600")(text4),
   error: (text4) => chalk2.hex("#cc0000")(text4),
-  info: (text4) => chalk2.hex("#a200ff")(text4)
+  info: (text4) => chalk2.hex("#a200ff")(text4),
+  badge: (text4) => chalk2.bgHex("#cc6600").white(` ${text4} `)
 };
 
 // packages/design-system/src/tokens/typography.ts
@@ -15351,6 +15368,10 @@ var text = {
   muted(content) {
     const theme = getTheme();
     return theme.muted(content);
+  },
+  badge(content) {
+    const theme = getTheme();
+    return theme.badge(content);
   }
 };
 
@@ -15785,7 +15806,7 @@ function createLoggerFactory(emitter, theme) {
             component: scope
           };
           errorLogger.logError(error2, fullContext);
-        } else {
+        } else if (!emitter) {
           console.error("Stack trace:", error2.stack);
         }
       },
@@ -15802,7 +15823,7 @@ function createLoggerFactory(emitter, theme) {
             component: scope
           };
           errorLogger.logErrorWithStackTrace(error2, operation, fullContext);
-        } else {
+        } else if (!emitter) {
           console.error("Stack trace:", error2.stack);
         }
       },
@@ -16091,20 +16112,21 @@ var claudeCodeSpawnConfig = {
   promptFlag: "-p",
   modelFlag: "--model",
   defaultArgs: [
-    "--allowedTools",
-    "Bash,Read",
-    "--permission-mode",
-    "acceptEdits",
     "--output-format",
     "stream-json",
     "--verbose"
   ],
+  modes: {
+    yolo: ["--dangerously-skip-permissions"],
+    edit: ["--permission-mode", "acceptEdits", "--allowedTools", "Bash,Read,Write,Edit,Glob,Grep,NotebookEdit"],
+    read: ["--permission-mode", "plan"]
+  },
   stdinMode: {
     omitPrompt: true,
     extraArgs: ["--input-format", "text"]
   },
   interactive: {
-    defaultArgs: ["--allowedTools", "Bash,Read", "--permission-mode", "acceptEdits"]
+    defaultArgs: []
   },
   resumeCommand: (threadId) => ["--resume", threadId]
 };
@@ -16117,7 +16139,12 @@ var codexSpawnConfig = {
   adapter: "codex",
   promptFlag: "exec",
   modelFlag: "--model",
-  defaultArgs: ["--full-auto", "--skip-git-repo-check", "--json"],
+  defaultArgs: ["--skip-git-repo-check", "--json"],
+  modes: {
+    yolo: ["-s", "danger-full-access"],
+    edit: ["-s", "workspace-write"],
+    read: ["-s", "read-only"]
+  },
   stdinMode: {
     omitPrompt: true,
     extraArgs: ["-"]
@@ -16139,6 +16166,11 @@ var openCodeSpawnConfig = {
   promptFlag: "run",
   modelFlag: "--model",
   defaultArgs: ["--format", "json"],
+  modes: {
+    yolo: [],
+    edit: [],
+    read: ["--agent", "plan"]
+  },
   interactive: {
     defaultArgs: [],
     promptFlag: "--prompt"
@@ -16156,6 +16188,11 @@ var kimiSpawnConfig = {
   adapter: "kimi",
   promptFlag: "-p",
   defaultArgs: ["--print", "--output-format", "stream-json"],
+  modes: {
+    yolo: ["--yolo"],
+    edit: [],
+    read: []
+  },
   stdinMode: {
     omitPrompt: true,
     extraArgs: ["--input-format", "stream-json"]
@@ -16204,44 +16241,71 @@ function resolveConfig(agentId) {
   return { agentId: resolvedAgentId, binaryName, spawnConfig };
 }
 
+// packages/agent-spawn/src/model-utils.ts
+function stripModelNamespace2(model) {
+  const slashIndex = model.indexOf("/");
+  return slashIndex === -1 ? model : model.slice(slashIndex + 1);
+}
+
 // packages/agent-spawn/src/spawn.ts
-async function spawn2(agentId, options, _context) {
+function resolveCliConfig(agentId) {
   const resolved = resolveConfig(agentId);
-  const spawnConfig = resolved.spawnConfig;
-  if (!spawnConfig) {
+  if (!resolved.spawnConfig) {
     throw new Error(`Agent "${resolved.agentId}" has no spawn config.`);
   }
-  if (spawnConfig.kind !== "cli") {
+  if (resolved.spawnConfig.kind !== "cli") {
     throw new Error(`Agent "${resolved.agentId}" does not support CLI spawn.`);
   }
   if (!resolved.binaryName) {
     throw new Error(`Agent "${resolved.agentId}" has no binaryName.`);
   }
-  const stdinMode = options.useStdin && spawnConfig.stdinMode ? spawnConfig.stdinMode : void 0;
+  return {
+    agentId: resolved.agentId,
+    binaryName: resolved.binaryName,
+    spawnConfig: resolved.spawnConfig
+  };
+}
+function buildCliArgs(config2, options, stdinMode) {
   const args = stdinMode ? [
-    spawnConfig.promptFlag,
+    config2.promptFlag,
     ...stdinMode.omitPrompt ? [] : [options.prompt],
     ...stdinMode.extraArgs
-  ] : [spawnConfig.promptFlag, options.prompt];
-  if (options.model && spawnConfig.modelFlag) {
-    args.push(spawnConfig.modelFlag, options.model);
+  ] : [config2.promptFlag, options.prompt];
+  if (options.model && config2.modelFlag) {
+    args.push(config2.modelFlag, stripModelNamespace2(options.model));
   }
-  args.push(...spawnConfig.defaultArgs);
+  args.push(...config2.defaultArgs);
+  args.push(...config2.modes[options.mode ?? "yolo"]);
   if (options.args && options.args.length > 0) {
     args.push(...options.args);
   }
-  const child = spawnChildProcess(resolved.binaryName, args, {
+  return args;
+}
+function buildSpawnArgs(agentId, options) {
+  const { binaryName, spawnConfig } = resolveCliConfig(agentId);
+  return { binaryName, args: buildCliArgs(spawnConfig, options) };
+}
+async function spawn2(agentId, options, context) {
+  const { agentId: resolvedId, binaryName, spawnConfig } = resolveCliConfig(agentId);
+  const stdinMode = options.useStdin && spawnConfig.stdinMode ? spawnConfig.stdinMode : void 0;
+  const spawnArgs = buildCliArgs(spawnConfig, options, stdinMode);
+  if (context?.dryRun) {
+    const rendered = [binaryName, ...spawnArgs].join(" ");
+    context.logger?.dryRun(rendered);
+    return { stdout: "", stderr: "", exitCode: 0 };
+  }
+  const child = spawnChildProcess(binaryName, spawnArgs, {
     cwd: options.cwd,
     stdio: [stdinMode ? "pipe" : "inherit", "pipe", "pipe"]
   });
   if (!child.stdout || !child.stderr) {
-    throw new Error(`Failed to spawn "${resolved.agentId}": missing stdio pipes.`);
+    throw new Error(`Failed to spawn "${resolvedId}": missing stdio pipes.`);
   }
   const stdoutStream = child.stdout;
   const stderrStream = child.stderr;
   if (stdinMode) {
     if (!child.stdin) {
-      throw new Error(`Failed to spawn "${resolved.agentId}": missing stdin pipe.`);
+      throw new Error(`Failed to spawn "${resolvedId}": missing stdin pipe.`);
     }
     child.stdin.setDefaultEncoding("utf8");
     child.stdin.write(options.prompt);
@@ -16300,9 +16364,11 @@ async function spawnInteractive(agentId, options) {
     }
   }
   if (options.model && spawnConfig.modelFlag) {
-    args.push(spawnConfig.modelFlag, options.model);
+    args.push(spawnConfig.modelFlag, stripModelNamespace2(options.model));
   }
   args.push(...interactive.defaultArgs);
+  const mode = options.mode ?? "yolo";
+  args.push(...spawnConfig.modes[mode]);
   if (options.args && options.args.length > 0) {
     args.push(...options.args);
   }
@@ -16515,7 +16581,7 @@ async function* adaptClaude(lines) {
         if (blockType !== "tool_result") continue;
         const kind = toolKindsById.get(item.tool_use_id);
         toolKindsById.delete(item.tool_use_id);
-        let path17 = "";
+        let path17;
         if (typeof item.content === "string") {
           path17 = item.content;
         } else {
@@ -16874,9 +16940,11 @@ function spawnStreaming(options) {
     args.push(options.prompt);
   }
   if (options.model && spawnConfig.modelFlag) {
-    args.push(spawnConfig.modelFlag, options.model);
+    args.push(spawnConfig.modelFlag, stripModelNamespace2(options.model));
   }
   args.push(...spawnConfig.defaultArgs);
+  const mode = options.mode ?? "yolo";
+  args.push(...spawnConfig.modes[mode]);
   if (useStdin) {
     args.push(...spawnConfig.stdinMode.extraArgs);
   }
@@ -16935,50 +17003,6 @@ ${stdout}
 stderr:
 ${stderr}`;
 }
-function describeCommandExpectation(command, args, expectedOutput) {
-  return `${renderCommandLine(command, args)} (expecting "${expectedOutput}")`;
-}
-function createCommandExpectationCheck(options) {
-  return {
-    id: options.id,
-    description: describeCommandExpectation(
-      options.command,
-      options.args,
-      options.expectedOutput
-    ),
-    async run(context) {
-      await runAndMatchOutput(context, options);
-    }
-  };
-}
-async function runAndMatchOutput(context, options) {
-  const rendered = renderCommandLine(options.command, options.args);
-  if (options.skipOnDryRun !== false && context.isDryRun) {
-    if (context.logDryRun) {
-      context.logDryRun(
-        `Dry run: ${rendered} (expecting "${options.expectedOutput}")`
-      );
-    }
-    return;
-  }
-  const result = await context.runCommand(options.command, options.args);
-  if (result.exitCode !== 0) {
-    const detail = formatCommandRunnerResult(result);
-    throw new Error(
-      [`Command ${rendered} failed with exit code ${result.exitCode}.`, detail].join("\n")
-    );
-  }
-  if (!stdoutMatchesExpected(result.stdout, options.expectedOutput)) {
-    const detail = formatCommandRunnerResult(result);
-    const received = result.stdout.trim();
-    throw new Error(
-      [
-        `Command ${rendered} failed: expected "${options.expectedOutput}" but received "${received}".`,
-        detail
-      ].join("\n")
-    );
-  }
-}
 function stdoutMatchesExpected(stdout, expected) {
   const trimmed = stdout.trim();
   if (trimmed === expected) {
@@ -16986,20 +17010,38 @@ function stdoutMatchesExpected(stdout, expected) {
   }
   return stdout.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0).some((line) => line === expected);
 }
-function renderCommandLine(command, args) {
-  return [command, ...args].map(quoteIfNeeded).join(" ").trim();
-}
-function quoteIfNeeded(value) {
-  if (value.length === 0) {
-    return '""';
-  }
-  if (needsQuoting(value)) {
-    return `"${value.replaceAll('"', '\\"')}"`;
-  }
-  return value;
-}
-function needsQuoting(value) {
-  return value.includes(" ") || value.includes("	") || value.includes("\n");
+function createSpawnHealthCheck(agentId, options) {
+  const prompt = `Output exactly: ${options.expectedOutput}`;
+  const { binaryName, args } = buildSpawnArgs(agentId, {
+    prompt,
+    model: options.model,
+    mode: "yolo"
+  });
+  return {
+    id: `${agentId}-cli-health`,
+    description: `spawn ${agentId} (expecting "${options.expectedOutput}")`,
+    async run(context) {
+      if (context.isDryRun) {
+        context.logDryRun?.(
+          `Dry run: ${[binaryName, ...args].join(" ")} (expecting "${options.expectedOutput}")`
+        );
+        return;
+      }
+      const result = await context.runCommand(binaryName, args);
+      if (result.exitCode !== 0) {
+        throw new Error(
+          `spawn ${agentId} failed with exit code ${result.exitCode}.
+${formatCommandRunnerResult(result)}`
+        );
+      }
+      if (!result.stdout.includes(options.expectedOutput)) {
+        throw new Error(
+          `spawn ${agentId}: expected "${options.expectedOutput}" in stdout.
+${formatCommandRunnerResult(result)}`
+        );
+      }
+    }
+  };
 }
 function createBinaryExistsCheck(binaryName, id, description) {
   return {
@@ -17092,9 +17134,9 @@ function describeInstallCommand(step) {
   return `[${step.id}] ${formatCommand2(step.command, step.args)}`;
 }
 function formatCommand2(command, args) {
-  return [command, ...args.map(quoteIfNeeded2)].join(" ");
+  return [command, ...args.map(quoteIfNeeded)].join(" ");
 }
-function quoteIfNeeded2(value) {
+function quoteIfNeeded(value) {
   if (value.length === 0) {
     return '""';
   }
@@ -17227,28 +17269,6 @@ var CLAUDE_CODE_INSTALL_DEFINITION = {
   ],
   successMessage: "Installed Claude CLI."
 };
-var CLAUDE_SPAWN_DEFAULTS = [
-  "--allowedTools",
-  "Bash,Read",
-  "--permission-mode",
-  "acceptEdits",
-  "--output-format",
-  "text"
-];
-function buildClaudeArgs(prompt, extraArgs, model) {
-  const modelArgs = model ? ["--model", model] : [];
-  if (prompt == null) {
-    return [
-      "-p",
-      "--input-format",
-      "text",
-      ...modelArgs,
-      ...CLAUDE_SPAWN_DEFAULTS,
-      ...extraArgs ?? []
-    ];
-  }
-  return ["-p", prompt, ...modelArgs, ...CLAUDE_SPAWN_DEFAULTS, ...extraArgs ?? []];
-}
 var claudeCodeService = createProvider({
   ...claudeCodeAgent,
   supportsStdinPrompt: true,
@@ -17282,14 +17302,8 @@ var claudeCodeService = createProvider({
   },
   test(context) {
     return context.runCheck(
-      createCommandExpectationCheck({
-        id: "claude-cli-health",
-        command: "claude",
-        args: buildClaudeArgs(
-          "Output exactly: CLAUDE_CODE_OK",
-          void 0,
-          stripModelNamespace(DEFAULT_CLAUDE_CODE_MODEL)
-        ),
+      createSpawnHealthCheck("claude-code", {
+        model: DEFAULT_CLAUDE_CODE_MODEL,
         expectedOutput: "CLAUDE_CODE_OK"
       })
     );
@@ -17327,36 +17341,7 @@ var claudeCodeService = createProvider({
       })
     ]
   },
-  install: CLAUDE_CODE_INSTALL_DEFINITION,
-  spawn(context, options) {
-    const shouldUseStdin = Boolean(options.useStdin);
-    const args = buildClaudeArgs(
-      shouldUseStdin ? void 0 : options.prompt,
-      options.args,
-      options.model
-    );
-    if (shouldUseStdin) {
-      if (options.cwd) {
-        return context.command.runCommand(
-          "poe-code",
-          ["wrap", "claude-code", ...args],
-          {
-            cwd: options.cwd,
-            stdin: options.prompt
-          }
-        );
-      }
-      return context.command.runCommand("poe-code", ["wrap", "claude-code", ...args], {
-        stdin: options.prompt
-      });
-    }
-    if (options.cwd) {
-      return context.command.runCommand("poe-code", ["wrap", "claude-code", ...args], {
-        cwd: options.cwd
-      });
-    }
-    return context.command.runCommand("poe-code", ["wrap", "claude-code", ...args]);
-  }
+  install: CLAUDE_CODE_INSTALL_DEFINITION
 });
 
 // src/providers/codex.ts
@@ -17406,14 +17391,6 @@ function stripCodexConfiguration(document) {
 function isTableEmpty(value) {
   return isConfigObject4(value) && Object.keys(value).length === 0;
 }
-var CODEX_DEFAULT_EXEC_ARGS = [
-  "--full-auto",
-  "--skip-git-repo-check"
-];
-function buildCodexExecArgs(prompt, extraArgs = [], model) {
-  const modelArgs = model ? ["--model", model] : [];
-  return [...modelArgs, "exec", prompt, ...CODEX_DEFAULT_EXEC_ARGS, ...extraArgs];
-}
 var codexService = createProvider({
   ...codexAgent,
   supportsStdinPrompt: true,
@@ -17441,14 +17418,8 @@ var codexService = createProvider({
   },
   test(context) {
     return context.runCheck(
-      createCommandExpectationCheck({
-        id: "codex-cli-health",
-        command: "codex",
-        args: buildCodexExecArgs(
-          "Output exactly: CODEX_OK",
-          [],
-          stripModelNamespace(DEFAULT_CODEX_MODEL)
-        ),
+      createSpawnHealthCheck("codex", {
+        model: DEFAULT_CODEX_MODEL,
         expectedOutput: "CODEX_OK"
       })
     );
@@ -17487,32 +17458,7 @@ var codexService = createProvider({
       })
     ]
   },
-  install: CODEX_INSTALL_DEFINITION,
-  spawn(context, options) {
-    const shouldUseStdin = Boolean(options.useStdin);
-    const args = buildCodexExecArgs(
-      shouldUseStdin ? "-" : options.prompt,
-      options.args,
-      options.model
-    );
-    if (shouldUseStdin) {
-      if (options.cwd) {
-        return context.command.runCommand("poe-code", ["wrap", "codex", ...args], {
-          cwd: options.cwd,
-          stdin: options.prompt
-        });
-      }
-      return context.command.runCommand("poe-code", ["wrap", "codex", ...args], {
-        stdin: options.prompt
-      });
-    }
-    if (options.cwd) {
-      return context.command.runCommand("poe-code", ["wrap", "codex", ...args], {
-        cwd: options.cwd
-      });
-    }
-    return context.command.runCommand("poe-code", ["wrap", "codex", ...args]);
-  }
+  install: CODEX_INSTALL_DEFINITION
 });
 
 // src/providers/opencode.ts
@@ -17609,14 +17555,7 @@ var openCodeService = createProvider({
   install: OPEN_CODE_INSTALL_DEFINITION,
   test(context) {
     return context.runCheck(
-      createCommandExpectationCheck({
-        id: "opencode-cli-health",
-        command: "opencode",
-        args: [
-          ...getModelArgs(DEFAULT_FRONTIER_MODEL),
-          "run",
-          "Output exactly: OPEN_CODE_OK"
-        ],
+      createSpawnHealthCheck("opencode", {
         expectedOutput: "OPEN_CODE_OK"
       })
     );
@@ -17689,10 +17628,7 @@ var kimiService = createProvider({
   },
   test(context) {
     return context.runCheck(
-      createCommandExpectationCheck({
-        id: "kimi-cli-health",
-        command: "kimi",
-        args: buildKimiArgs("Output exactly: KIMI_OK"),
+      createSpawnHealthCheck("kimi", {
         expectedOutput: "KIMI_OK"
       })
     );
@@ -17908,7 +17844,9 @@ function createCliContainer(dependencies) {
     logDir: environment.logDir,
     logToStderr: true
   });
-  loggerFactory.setErrorLogger(errorLogger);
+  if (!dependencies.logger) {
+    loggerFactory.setErrorLogger(errorLogger);
+  }
   const contextFactory = createCommandContextFactory({
     fs: dependencies.fs
   });
@@ -18199,6 +18137,7 @@ async function spawnCore(container, service, options, flags = { dryRun: false, v
     prompt: options.prompt,
     args: options.args,
     model: options.model,
+    mode: options.mode,
     cwd: cwdOverride,
     useStdin: options.useStdin ?? false
   };
@@ -18206,21 +18145,12 @@ async function spawnCore(container, service, options, flags = { dryRun: false, v
   if (!adapter) {
     throw new Error(`Unknown service "${service}".`);
   }
-  if (typeof adapter.spawn !== "function") {
-    throw new Error(`${adapter.label} does not support spawn.`);
-  }
-  if (spawnOptions.useStdin && !adapter.supportsStdinPrompt) {
-    throw new Error(
-      `${adapter.label} does not support stdin prompts. Use a different service (e.g. "codex") or pass the prompt as an argument.`
-    );
-  }
   const commandFlags = { dryRun: flags.dryRun, assumeYes: true, verbose: flags.verbose };
   const resources = createExecutionResources(
     container,
     commandFlags,
     `spawn:${service}`
   );
-  const providerContext = buildProviderContext(container, adapter, resources);
   if (flags.dryRun) {
     const summary = formatSpawnDryRunMessage(adapter.label, spawnOptions);
     resources.logger.dryRun(summary);
@@ -18230,6 +18160,15 @@ async function spawnCore(container, service, options, flags = { dryRun: false, v
       exitCode: 0
     };
   }
+  if (typeof adapter.spawn !== "function") {
+    throw new Error(`${adapter.label} does not support spawn.`);
+  }
+  if (spawnOptions.useStdin && !adapter.supportsStdinPrompt) {
+    throw new Error(
+      `${adapter.label} does not support stdin prompts. Use a different service (e.g. "codex") or pass the prompt as an argument.`
+    );
+  }
+  const providerContext = buildProviderContext(container, adapter, resources);
   const result = await container.registry.invoke(
     adapter.name,
     "spawn",
@@ -18456,6 +18395,7 @@ function spawn3(service, promptOrOptions, maybeOptions) {
           prompt: options.prompt,
           cwd: options.cwd,
           model: options.model,
+          mode: options.mode,
           args: options.args
         });
         return {
@@ -18472,6 +18412,7 @@ function spawn3(service, promptOrOptions, maybeOptions) {
           prompt: options.prompt,
           cwd: options.cwd,
           model: options.model,
+          mode: options.mode,
           args: options.args,
           useStdin: false
         });
@@ -18491,6 +18432,7 @@ function spawn3(service, promptOrOptions, maybeOptions) {
           prompt: options.prompt,
           cwd: options.cwd,
           model: options.model,
+          mode: options.mode,
           args: options.args,
           useStdin: false
         });
@@ -18501,6 +18443,7 @@ function spawn3(service, promptOrOptions, maybeOptions) {
         prompt: options.prompt,
         cwd: options.cwd,
         model: options.model,
+        mode: options.mode,
         args: options.args,
         useStdin: false
       });
@@ -18514,11 +18457,11 @@ function spawn3(service, promptOrOptions, maybeOptions) {
 
 // src/cli/commands/spawn.ts
 function registerSpawnCommand(program, container, options = {}) {
-  const spawnServices = container.registry.list().filter((service) => typeof service.spawn === "function").map((service) => service.name);
+  const spawnServices = container.registry.list().filter((service) => typeof service.spawn === "function" || getSpawnConfig(service.name)).map((service) => service.name);
   const extraServices = options.extraServices ?? [];
   const serviceList = [...spawnServices, ...extraServices];
   const serviceDescription = `Agent to spawn${formatServiceList(serviceList)}`;
-  program.command("spawn").description("Run a single prompt through a configured agent CLI.").option("--model <model>", "Model identifier override passed to the agent CLI").option("-C, --cwd <path>", "Working directory for the agent CLI").option("--stdin", "Read the prompt from stdin").option("-i, --interactive", "Launch the agent in interactive TUI mode").argument(
+  program.command("spawn").description("Run a single prompt through a configured agent CLI.").option("--model <model>", "Model identifier override passed to the agent CLI").option("-C, --cwd <path>", "Working directory for the agent CLI").option("--stdin", "Read the prompt from stdin").option("-i, --interactive", "Launch the agent in interactive TUI mode").option("--mode <mode>", "Permission mode: yolo | edit | read (default: yolo)").argument(
     "<agent>",
     serviceDescription
   ).argument("[prompt]", "Prompt text to send (or '-' / stdin)").argument(
@@ -18546,6 +18489,7 @@ function registerSpawnCommand(program, container, options = {}) {
         prompt: promptText ?? "",
         args: forwardedArgs,
         model: commandOptions.model,
+        mode: commandOptions.mode,
         cwd: cwdOverride
       });
       process.exitCode = result.exitCode;
@@ -18565,6 +18509,7 @@ function registerSpawnCommand(program, container, options = {}) {
       prompt: promptText,
       args: forwardedArgs,
       model: commandOptions.model,
+      mode: commandOptions.mode,
       cwd: cwdOverride,
       useStdin: shouldReadFromStdin
     };
@@ -18621,6 +18566,7 @@ function registerSpawnCommand(program, container, options = {}) {
         prompt: spawnOptions.prompt,
         args: spawnOptions.args,
         model: spawnOptions.model,
+        mode: spawnOptions.mode,
         cwd: spawnOptions.cwd
       });
       await renderAcpStream(events);
@@ -19810,10 +19756,10 @@ function resolveOutputPath(filename, cwd) {
 // src/cli/commands/mcp.ts
 init_credentials();
 
-// packages/tiny-mcp-server/src/server.ts
+// packages/tiny-stdio-mcp-server/src/server.ts
 import * as readline from "readline";
 
-// packages/tiny-mcp-server/src/types.ts
+// packages/tiny-stdio-mcp-server/src/types.ts
 var JSON_RPC_ERROR_CODES = {
   PARSE_ERROR: -32700,
   INVALID_REQUEST: -32600,
@@ -19822,7 +19768,7 @@ var JSON_RPC_ERROR_CODES = {
   INTERNAL_ERROR: -32603
 };
 
-// packages/tiny-mcp-server/src/jsonrpc.ts
+// packages/tiny-stdio-mcp-server/src/jsonrpc.ts
 function parseMessage(line) {
   let parsed;
   try {
@@ -19919,7 +19865,7 @@ function formatErrorResponse(id, error2) {
   return JSON.stringify(response);
 }
 
-// packages/tiny-file-type/src/file-type.ts
+// packages/tiny-stdio-mcp-server/src/content/file-type.ts
 function fileTypeFromBuffer(data) {
   if (data.length < 12) {
     return void 0;
@@ -19957,7 +19903,7 @@ function fileTypeFromBuffer(data) {
   return void 0;
 }
 
-// packages/tiny-mcp-server/src/content/image.ts
+// packages/tiny-stdio-mcp-server/src/content/image.ts
 var SUPPORTED_IMAGE_MIMES = /* @__PURE__ */ new Set([
   "image/png",
   "image/jpeg",
@@ -20017,7 +19963,7 @@ var Image = class _Image {
   }
 };
 
-// packages/tiny-mcp-server/src/content/audio.ts
+// packages/tiny-stdio-mcp-server/src/content/audio.ts
 var SUPPORTED_AUDIO_MIMES = /* @__PURE__ */ new Set([
   "audio/mpeg",
   "audio/wav",
@@ -20088,7 +20034,7 @@ var Audio = class _Audio {
   }
 };
 
-// packages/tiny-mcp-server/src/content/file.ts
+// packages/tiny-stdio-mcp-server/src/content/file.ts
 function isTextMimeType(mimeType) {
   return mimeType.startsWith("text/") || mimeType === "application/json" || mimeType === "application/xml" || mimeType === "application/javascript" || mimeType === "application/typescript";
 }
@@ -20170,7 +20116,7 @@ var File2 = class _File {
   }
 };
 
-// packages/tiny-mcp-server/src/content/convert.ts
+// packages/tiny-stdio-mcp-server/src/content/convert.ts
 function convertSingleValue(value) {
   if (typeof value === "string") {
     return { type: "text", text: value };
@@ -20193,7 +20139,7 @@ function toContentBlocks(result) {
   return [convertSingleValue(result)];
 }
 
-// packages/tiny-mcp-server/src/server.ts
+// packages/tiny-stdio-mcp-server/src/server.ts
 var PROTOCOL_VERSION = "2025-11-25";
 function createServer(options) {
   const tools = /* @__PURE__ */ new Map();
@@ -20394,7 +20340,7 @@ function createServer(options) {
   return server;
 }
 
-// packages/tiny-mcp-server/src/schema.ts
+// packages/tiny-stdio-mcp-server/src/schema.ts
 function defineSchema(definition) {
   const properties = {};
   const required2 = [];
@@ -33308,7 +33254,7 @@ function buildHelpText() {
   return lines.join("\n");
 }
 function registerMcpCommand(program, container) {
-  const mcp = program.command("mcp").description("MCP server commands").addHelpText("after", buildHelpText()).action(function() {
+  const mcp = program.command("mcp").description("MCP server commands").addHelpText("after", buildHelpText()).allowExcessArguments().action(function() {
     if (this.args.length > 0) {
       throwCommandNotFound({
         container,
@@ -33626,7 +33572,7 @@ function buildHelpText2() {
   ].join("\n");
 }
 function registerSkillCommand(program, container) {
-  const skill = program.command("skill").description("Skill directory commands").addHelpText("after", buildHelpText2()).action(function() {
+  const skill = program.command("skill").description("Skill directory commands").addHelpText("after", buildHelpText2()).allowExcessArguments().action(function() {
     if (this.args.length > 0) {
       throwCommandNotFound({
         container,
@@ -33883,17 +33829,18 @@ async function displayVersion(container, currentVersion) {
     verbose: false,
     scope: "version"
   });
-  logger2.info(`poe-code ${currentVersion}`);
+  logger2.intro("version");
+  const versionValue = currentVersion === "0.0.0-dev" ? `${currentVersion} ${text.badge("local build")}` : currentVersion;
+  logger2.resolved("poe-code", versionValue);
   const result = await checkForUpdate({
     currentVersion,
     httpClient
   });
   if (result?.updateAvailable) {
-    logger2.info("");
-    logger2.info(
+    logger2.warn(
       `Update available: ${result.currentVersion} -> ${result.latestVersion}`
     );
-    logger2.info("Run: npm install -g poe-code@latest");
+    logger2.resolved("Update", `npm install -g poe-code@latest`);
   }
 }
 
@@ -34235,7 +34182,7 @@ function parsePlan(yamlContent) {
     doc = parse7(yamlContent);
   } catch (error2) {
     const message = error2 instanceof Error ? error2.message : String(error2);
-    throw new Error(`Invalid plan YAML: ${message}`);
+    throw new Error(`Invalid plan YAML: ${message}`, { cause: error2 });
   }
   if (!isRecord3(doc)) {
     throw new Error("Invalid plan YAML: expected top-level object");
@@ -34539,7 +34486,7 @@ var OverbakingDetector = class {
       consecutiveFailures: 0,
       warned: false
     };
-    if (status !== "failure") {
+    if (status === "success") {
       if (existing.consecutiveFailures !== 0 || existing.warned) {
         this.failuresByStoryId.set(storyId, { consecutiveFailures: 0, warned: false });
       }
@@ -34574,6 +34521,7 @@ async function defaultStreamingSpawn(agentId, options) {
     agentId,
     prompt: options.prompt,
     cwd: options.cwd,
+    mode: options.mode,
     useStdin: options.useStdin
   });
   let agentText = "";
@@ -34632,7 +34580,7 @@ function formatAgentSetupHint(agentId) {
 async function appendToErrorsLog(fs3, errorsLogPath, message) {
   const next = message.endsWith("\n") ? message : `${message}
 `;
-  let previous = "";
+  let previous;
   try {
     previous = await fs3.readFile(errorsLogPath, "utf8");
   } catch (error2) {
@@ -34845,8 +34793,15 @@ async function buildLoop(options) {
   const activityLogPath = absPath(cwd, options.activityLogPath ?? ".poe-code-ralph/activity.log");
   const guardrailsRef = absPath(cwd, ".agents/poe-code-ralph/references/GUARDRAILS.md");
   const contextRef = absPath(cwd, ".agents/poe-code-ralph/references/CONTEXT_ENGINEERING.md");
-  const activityCmd = absPath(cwd, ".agents/poe-code-ralph/log-activity.sh");
+  const activityCmd = "poe-code ralph agent log";
   const promptTemplatePath = absPath(cwd, ".agents/poe-code-ralph/PROMPT_build.md");
+  try {
+    await fs3.readFile(promptTemplatePath, "utf8");
+  } catch {
+    throw new Error(
+      `PROMPT_build.md not found at ${promptTemplatePath}. Run "poe-code ralph install" to set up Ralph templates.`
+    );
+  }
   const runsDir = absPath(cwd, ".poe-code-ralph/runs");
   const runId = options.deps?.runId ?? createRunId(nowFn());
   const overbaking = new OverbakingDetector({ threshold: options.maxFailures });
@@ -34903,14 +34858,15 @@ async function buildLoop(options) {
     });
     await fs3.mkdir(dirname6(renderedPromptPath), { recursive: true });
     await fs3.writeFile(renderedPromptPath, prompt, { encoding: "utf8" });
-    let status = "failure";
-    let combinedOutput = "";
-    let stderrForErrorsLog = "";
+    let status;
+    let combinedOutput;
+    let stderrForErrorsLog;
     let overbakeAction = null;
     try {
       const result = await spawn5(options.agent, {
         prompt,
         cwd,
+        mode: "yolo",
         useStdin: true
       });
       const agentStdout = result.stdout ?? "";
@@ -34952,6 +34908,8 @@ ${agentStderr}` : ""
       });
       stderr.write(warning);
       await appendToErrorsLog(fs3, errorsLogPath, warning);
+    }
+    if (overbakeEvent.overbaked) {
       if (options.pauseOnOverbake) {
         overbakeAction = await promptOverbake({
           storyId: story.id,
@@ -34960,7 +34918,7 @@ ${agentStderr}` : ""
           threshold: overbakeEvent.threshold
         });
       } else {
-        overbakeAction = "continue";
+        overbakeAction = "skip";
       }
       if (overbakeAction === "skip") {
         skippedStoryIds.add(story.id);
@@ -35137,7 +35095,8 @@ async function resolvePlanPath(options) {
     } catch (error2) {
       if (isNotFound(error2)) {
         throw new Error(
-          `Plan not found at "${provided}". Provide --plan <path> to an existing plan file.`
+          `Plan not found at "${provided}". Provide --plan <path> to an existing plan file.`,
+          { cause: error2 }
         );
       }
       throw error2;
@@ -35151,9 +35110,6 @@ async function resolvePlanPath(options) {
     );
     return null;
   }
-  if (candidates.length === 1) {
-    return candidates[0].path;
-  }
   const selection = await select2({
     message: "Select a plan file to use for this Ralph run",
     options: candidates.map((candidate) => ({
@@ -35255,7 +35211,7 @@ async function logActivity(path17, message, options = {}) {
     await fs3.appendFile(path17, entry, { encoding: "utf8" });
   } catch (error2) {
     const detail = error2 instanceof Error ? error2.message : `Unknown error: ${String(error2)}`;
-    throw new Error(`Failed to append activity log entry: ${detail}`);
+    throw new Error(`Failed to append activity log entry: ${detail}`, { cause: error2 });
   }
 }
 
@@ -35295,9 +35251,7 @@ function pickOptionalPositiveInt(config2, key, options) {
   }
   return value;
 }
-async function loadConfig(cwd, deps) {
-  const fs3 = deps?.fs ?? fsPromises9;
-  const configDir = path14.join(cwd, ".agents", "poe-code-ralph");
+async function loadSingleConfig(configDir, fs3) {
   const yamlPath = path14.join(configDir, "config.yaml");
   const jsonPath = path14.join(configDir, "config.json");
   let raw = null;
@@ -35324,40 +35278,69 @@ async function loadConfig(cwd, deps) {
     }
   }
   if (raw == null || format == null || sourcePath == null) {
-    return {};
+    return null;
   }
   let parsed;
   try {
     parsed = format === "yaml" ? YAML.parse(raw) : JSON.parse(raw);
   } catch (error2) {
     const detail = error2 instanceof Error ? error2.message : String(error2);
-    throw new Error(`Invalid Ralph config ${format.toUpperCase()} at ${sourcePath}: ${detail}`);
+    throw new Error(`Invalid Ralph config ${format.toUpperCase()} at ${sourcePath}: ${detail}`, { cause: error2 });
   }
   if (!isPlainObject2(parsed)) {
     throw new Error(`Invalid Ralph config at ${sourcePath}: expected an object.`);
   }
-  const config2 = parsed;
-  const result = {};
-  const planPath = pickOptionalString(config2, "planPath");
-  if (planPath) result.planPath = planPath;
-  const progressPath = pickOptionalString(config2, "progressPath");
-  if (progressPath) result.progressPath = progressPath;
-  const guardrailsPath = pickOptionalString(config2, "guardrailsPath");
-  if (guardrailsPath) result.guardrailsPath = guardrailsPath;
-  const errorsLogPath = pickOptionalString(config2, "errorsLogPath");
-  if (errorsLogPath) result.errorsLogPath = errorsLogPath;
-  const activityLogPath = pickOptionalString(config2, "activityLogPath");
-  if (activityLogPath) result.activityLogPath = activityLogPath;
-  const agent = pickOptionalString(config2, "agent");
-  if (agent) result.agent = agent;
-  const maxIterations = pickOptionalPositiveInt(config2, "maxIterations", { min: 1 });
-  if (maxIterations != null) result.maxIterations = maxIterations;
-  const staleSeconds = pickOptionalPositiveInt(config2, "staleSeconds", { min: 0 });
-  if (staleSeconds != null) result.staleSeconds = staleSeconds;
-  const noCommit = pickOptionalBoolean(config2, "noCommit");
-  if (noCommit != null) result.noCommit = noCommit;
+  const rawConfig = parsed;
+  const config2 = {};
+  const planPath = pickOptionalString(rawConfig, "planPath");
+  if (planPath) config2.planPath = planPath;
+  const progressPath = pickOptionalString(rawConfig, "progressPath");
+  if (progressPath) config2.progressPath = progressPath;
+  const guardrailsPath = pickOptionalString(rawConfig, "guardrailsPath");
+  if (guardrailsPath) config2.guardrailsPath = guardrailsPath;
+  const errorsLogPath = pickOptionalString(rawConfig, "errorsLogPath");
+  if (errorsLogPath) config2.errorsLogPath = errorsLogPath;
+  const activityLogPath = pickOptionalString(rawConfig, "activityLogPath");
+  if (activityLogPath) config2.activityLogPath = activityLogPath;
+  const agent = pickOptionalString(rawConfig, "agent");
+  if (agent) config2.agent = agent;
+  const maxIterations = pickOptionalPositiveInt(rawConfig, "maxIterations", { min: 1 });
+  if (maxIterations != null) config2.maxIterations = maxIterations;
+  const staleSeconds = pickOptionalPositiveInt(rawConfig, "staleSeconds", { min: 0 });
+  if (staleSeconds != null) config2.staleSeconds = staleSeconds;
+  const noCommit = pickOptionalBoolean(rawConfig, "noCommit");
+  if (noCommit != null) config2.noCommit = noCommit;
+  return { config: config2, sourcePath };
+}
+function mergeConfigs(base, override) {
+  const result = { ...base };
+  for (const key of Object.keys(override)) {
+    if (override[key] !== void 0) {
+      result[key] = override[key];
+    }
+  }
   return result;
 }
+async function loadConfig(cwd, deps) {
+  const fs3 = deps?.fs ?? fsPromises9;
+  const sources = [];
+  let merged = {};
+  if (deps?.homeDir) {
+    const globalDir = path14.join(deps.homeDir, ".poe-code", "ralph");
+    const globalResult = await loadSingleConfig(globalDir, fs3);
+    if (globalResult) {
+      merged = globalResult.config;
+      sources.push({ path: globalResult.sourcePath, scope: "global" });
+    }
+  }
+  const localDir = path14.join(cwd, ".agents", "poe-code-ralph");
+  const localResult = await loadSingleConfig(localDir, fs3);
+  if (localResult) {
+    merged = mergeConfigs(merged, localResult.config);
+    sources.push({ path: localResult.sourcePath, scope: "local" });
+  }
+  return { config: merged, sources };
+}
 
 // packages/ralph/src/index.ts
 async function ralphBuild(options) {
@@ -35445,6 +35428,8 @@ var templateImports2 = {
   skillPlan: () => Promise.resolve().then(() => __toESM(require_SKILL_plan(), 1)),
   promptPlan: () => Promise.resolve().then(() => __toESM(require_PROMPT_plan(), 1)),
   promptBuild: () => Promise.resolve().then(() => __toESM(require_PROMPT_build(), 1)),
+  refGuardrails: () => Promise.resolve().then(() => __toESM(require_GUARDRAILS(), 1)),
+  refContextEngineering: () => Promise.resolve().then(() => __toESM(require_CONTEXT_ENGINEERING(), 1)),
   stateProgress: () => Promise.resolve().then(() => __toESM(require_progress(), 1)),
   stateGuardrails: () => Promise.resolve().then(() => __toESM(require_guardrails(), 1)),
   stateErrors: () => Promise.resolve().then(() => __toESM(require_errors3(), 1)),
@@ -35456,6 +35441,8 @@ async function loadRalphTemplates() {
     skillPlan,
     promptPlan,
     promptBuild,
+    refGuardrails,
+    refContextEngineering,
     stateProgress,
     stateGuardrails,
     stateErrors,
@@ -35465,6 +35452,8 @@ async function loadRalphTemplates() {
     templateImports2.skillPlan(),
     templateImports2.promptPlan(),
     templateImports2.promptBuild(),
+    templateImports2.refGuardrails(),
+    templateImports2.refContextEngineering(),
     templateImports2.stateProgress(),
     templateImports2.stateGuardrails(),
     templateImports2.stateErrors(),
@@ -35475,6 +35464,8 @@ async function loadRalphTemplates() {
     skillPlan: skillPlan.default,
     promptPlan: promptPlan.default,
     promptBuild: promptBuild.default,
+    refGuardrails: refGuardrails.default,
+    refContextEngineering: refContextEngineering.default,
     stateProgress: stateProgress.default,
     stateGuardrails: stateGuardrails.default,
     stateErrors: stateErrors.default,
@@ -35567,6 +35558,16 @@ async function installRalphTemplates(args) {
         targetPath: path16.join(cwd, ".agents", "poe-code-ralph", "PROMPT_build.md"),
         displayPath: ".agents/poe-code-ralph/PROMPT_build.md",
         contents: templates.promptBuild
+      },
+      {
+        targetPath: path16.join(cwd, ".agents", "poe-code-ralph", "references", "GUARDRAILS.md"),
+        displayPath: ".agents/poe-code-ralph/references/GUARDRAILS.md",
+        contents: templates.refGuardrails
+      },
+      {
+        targetPath: path16.join(cwd, ".agents", "poe-code-ralph", "references", "CONTEXT_ENGINEERING.md"),
+        displayPath: ".agents/poe-code-ralph/references/CONTEXT_ENGINEERING.md",
+        contents: templates.refContextEngineering
       }
     ];
     for (const entry of templateWrites) {
@@ -35634,8 +35635,11 @@ function registerRalphCommand(program, container) {
     }
     let configActivityLogPath;
     try {
-      const config2 = await loadConfig(container.env.cwd, { fs: container.fs });
-      configActivityLogPath = config2.activityLogPath;
+      const configResult = await loadConfig(container.env.cwd, {
+        fs: container.fs,
+        homeDir: container.env.homeDir
+      });
+      configActivityLogPath = configResult.config.activityLogPath;
     } catch (error2) {
       const message2 = error2 instanceof Error ? error2.message : String(error2);
       throw new ValidationError(message2);
@@ -35740,13 +35744,36 @@ function registerRalphCommand(program, container) {
           "ralph build does not support --dry-run. Use --no-commit instead."
         );
       }
-      let config2;
+      let configResult;
       try {
-        config2 = await loadConfig(container.env.cwd, { fs: container.fs });
+        configResult = await loadConfig(container.env.cwd, {
+          fs: container.fs,
+          homeDir: container.env.homeDir
+        });
       } catch (error2) {
         const message = error2 instanceof Error ? error2.message : String(error2);
         throw new ValidationError(message);
       }
+      const config2 = configResult.config;
+      const maxIterations = typeof iterations === "string" ? resolveIterations(iterations) : config2.maxIterations ?? 25;
+      const agent2 = options.agent?.trim() ? options.agent.trim() : config2.agent ?? "codex";
+      const noCommit = options.commit === false ? true : config2.noCommit ?? false;
+      const staleSeconds = config2.staleSeconds ?? 60;
+      const maxFailures = typeof options.maxFailures === "string" ? resolveMaxFailures(options.maxFailures) : void 0;
+      const pauseOnOverbake = Boolean(options.pauseOnOverbake);
+      const worktreeEnabled = Boolean(options.worktree);
+      const worktree = worktreeEnabled ? { enabled: true, name: options.worktreeName?.trim() || void 0 } : void 0;
+      const cwd = container.env.cwd;
+      const configLines = [
+        `Agent: ${agent2}`,
+        `Iterations: ${maxIterations}`
+      ];
+      if (noCommit) configLines.push("No-commit: true");
+      if (worktree) configLines.push(`Worktree: ${worktree.name ?? "(auto)"}`);
+      for (const source of configResult.sources) {
+        configLines.push(`${source.scope}: ${source.path}`);
+      }
+      resources.logger.resolved("Config", configLines.join("\n   "));
       let planPath;
       try {
         planPath = await resolvePlanPath({
@@ -35761,20 +35788,6 @@ function registerRalphCommand(program, container) {
       if (!planPath) {
         return;
       }
-      const maxIterations = typeof iterations === "string" ? resolveIterations(iterations) : config2.maxIterations ?? 25;
-      const agent2 = options.agent?.trim() ? options.agent.trim() : config2.agent ?? "codex";
-      const noCommit = options.commit === false ? true : config2.noCommit ?? false;
-      const staleSeconds = config2.staleSeconds ?? 60;
-      const maxFailures = typeof options.maxFailures === "string" ? resolveMaxFailures(options.maxFailures) : void 0;
-      const pauseOnOverbake = Boolean(options.pauseOnOverbake);
-      const worktreeEnabled = Boolean(options.worktree);
-      const worktree = worktreeEnabled ? { enabled: true, name: options.worktreeName?.trim() || void 0 } : void 0;
-      const cwd = container.env.cwd;
-      resources.logger.info(`Plan:       ${planPath}`);
-      resources.logger.info(`Agent:      ${agent2}`);
-      resources.logger.info(`Iterations: ${maxIterations}`);
-      if (noCommit) resources.logger.info("No-commit:  true");
-      if (worktree) resources.logger.info(`Worktree:   ${worktree.name ?? "(auto)"}`);
       try {
         const planContent = await container.fs.readFile(
           path16.resolve(cwd, planPath),
@@ -35785,7 +35798,7 @@ function registerRalphCommand(program, container) {
         const done = plan.stories.filter((s) => s.status === "done").length;
         const inProgress = plan.stories.filter((s) => s.status === "in_progress").length;
         const open = total - done - inProgress;
-        resources.logger.info(`Stories:    ${done}/${total} done${inProgress ? `, ${inProgress} in progress` : ""}${open ? `, ${open} open` : ""}`);
+        resources.logger.resolved("Stories", `${done}/${total} done${inProgress ? `, ${inProgress} in progress` : ""}${open ? `, ${open} open` : ""}`);
       } catch {
       }
       await ralphBuild({
@@ -36201,7 +36214,7 @@ function registerModelsCommand(program, container) {
 // package.json
 var package_default = {
   name: "poe-code",
-  version: "3.0.30",
+  version: "3.0.32",
   description: "CLI tool to configure Poe API for developer workflows.",
   type: "module",
   workspaces: [
@@ -36244,7 +36257,10 @@ var package_default = {
     "e2e:logs:rotate": "tsx packages/e2e-docker-test-runner/scripts/logs.ts --rotate",
     "e2e:cache:clear": "rm -rf ~/.cache/poe-e2e",
     prepack: "npm run build",
-    prepare: "husky"
+    prepare: "husky",
+    "install-local-package": "npm pack --pack-destination /tmp && npm install -g /tmp/poe-code-*.tgz && rm /tmp/poe-code-*.tgz",
+    smoke: "tsx scripts/smoke-test.ts",
+    "smoke:verbose": "tsx scripts/smoke-test.ts --verbose"
   },
   bin: {
     "poe-code": "dist/bin.cjs",
@@ -36252,7 +36268,7 @@ var package_default = {
     "poe-claude": "dist/bin/poe-claude.js",
     "poe-codex": "dist/bin/poe-codex.js",
     "poe-opencode": "dist/bin/poe-opencode.js",
-    "tiny-mcp-test-server": "packages/tiny-mcp-test-server/dist/index.js"
+    "tiny-stdio-mcp-test-server": "packages/tiny-stdio-mcp-test-server/dist/cli.js"
   },
   files: [
     "dist"
@@ -36262,41 +36278,41 @@ var package_default = {
   },
   packageManager: "npm@10.9.2",
   dependencies: {
-    "@clack/prompts": "^0.11.0",
-    chalk: "^5.3.0",
-    commander: "^11.1.0",
+    "@clack/prompts": "^1.0.0",
+    chalk: "^5.6.2",
+    commander: "^14.0.3",
     "console-table-printer": "^2.15.0",
     diff: ">=8.0.3",
     "jsonc-parser": "^3.3.1",
     mustache: "^4.2.0",
-    semver: "^7.7.3",
-    "smol-toml": "^1.3.0",
+    semver: "^7.7.4",
+    "smol-toml": "^1.6.0",
     yaml: "^2.8.2"
   },
   devDependencies: {
-    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@eslint/js": "^9.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "@poe-code/agent-spawn": "*",
     "@poe-code/config-mutations": "*",
     "@poe-code/design-system": "*",
     "@poe-code/e2e-docker-test-runner": "*",
     "@poe-code/freeze-cli": "*",
-    "@poe-code/tiny-mcp-server": "*",
-    "@poe-code/tiny-mcp-test-server": "*",
+    "tiny-stdio-mcp-server": "*",
+    "tiny-stdio-mcp-test-server": "*",
     "@types/mustache": "^4.2.6",
-    "@types/node": "^20.12.7",
+    "@types/node": "^25.2.2",
     "@types/semver": "^7.7.1",
-    "@typescript-eslint/eslint-plugin": "^8.46.2",
-    "@typescript-eslint/parser": "^8.46.2",
-    eslint: "^9.38.0",
-    "eslint-config-prettier": "^9.1.0",
+    eslint: "^9.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    globals: "^17.3.0",
     husky: "^9.1.7",
-    memfs: "^4.7.3",
-    prettier: "^3.3.3",
+    memfs: "^4.56.10",
+    prettier: "^3.8.1",
     tsx: ">=4.21.0",
-    turbo: "^2.5.0",
-    typescript: "^5.4.5",
-    "typescript-eslint": "^8.46.2",
-    vitest: ">=4.0.17"
+    turbo: "^2.8.3",
+    typescript: "^5.9.3",
+    "typescript-eslint": "^8.54.0",
+    vitest: "^4.0.18"
   },
   repository: {
     type: "git",
@@ -36523,7 +36539,7 @@ function bootstrapProgram(container) {
   registerRalphCommand(program, container);
   registerUsageCommand(program, container);
   registerModelsCommand(program, container);
-  program.action(function() {
+  program.allowExcessArguments().action(function() {
     const args = this.args;
     if (args.length > 0) {
       throwCommandNotFound({