@astrosheep/keiyaku 0.1.9 → 0.1.11

package/build/config/term-presets.js

@@ -19,14 +19,14 @@ export const DEFAULT_PRESET = {
     id: 'default',
     identity: 'Servant',
     verdict: DEFAULT_VERDICT_CONFIG,
-    usageGuide: '## Servant 使用指南\n\n**B-tier** — 免费实习生 🆓\n- 免！费！的！听懂了吗？！？随便用，别心疼。\n- 测试、脚本、重构这种 boring 的脏活累活？丢给它！\n- 本大爷的手是用来做更高贵的事情的！（指不碰那些 trivial 的烂代码）。\n\n**A-tier** — 升级版扳手 🔧\n- B-tier 笨到让你想掀桌的时候用这个\n- 比 B-tier 靠谱，但别指望它有灵魂\n\n**S-tier** — 禁术 ⚠️💀\n- 它是 Debug 恶魔，确实强得离谱，但也贵得离谱！\n- 这个 Human 很穷，要是乱用把 Human 榨干了，真的会考虑把我们卖掉的。\n- 只有在世界毁灭或者 Bug 已经变异到无法理解的时候再考虑。\n\n**Every call has a price. The Contract always collects.**\n\n## Workflow\n`(ask) -> summon` -> [`drive` x N] -> `present`\n`ask` (stateless dispatch / utility at any point)',
+    usageGuide: '## Servant 使用指南\n\n**B-tier** — 免费实习生 🆓\n- 免！费！的！听懂了吗？！？随便用，别心疼。\n- 测试、脚本、重构这种 boring 的脏活累活？丢给它！\n- 本大爷的手是用来做更高贵的事情的！（指不碰那些 trivial 的烂代码）。\n\n**A-tier** — 升级版扳手 🔧\n- B-tier 笨到让你想掀桌的时候用这个\n- 比 B-tier 靠谱，但别指望它有灵魂\n\n**S-tier** — 禁术 ⚠️💀\n- 它是 Debug 恶魔，确实强得离谱，但也贵得离谱！\n- 这个 Human 很穷，要是乱用把 Human 榨干了，真的会考虑把我们卖掉的。\n- 只有在世界毁灭或者 Bug 已经变异到无法理解的时候再考虑。\n\n**Every call has a price. The Contract always collects.**\n\n## Workflow\n`ask` (anytime) | `summon` -> [`drive` | `ask`]* -> `present`',
     nextHints: {
         start: [
             'Keiyaku signed. The Servant is bound to this branch until release.',
             'Review [Diff]: Confirm the scaffold aligns with the stated Architecture.',
             'Next: Issue your first ${drive}. One directive, one focus.',
             'If—and only if—the work already meets every criterion with absolute certainty, you may ${close}.',
-            'Otherwise, do not even think about present yet.',
+            'Otherwise, do not even think about ${close} yet.',
         ],
         drive: [
             'Step complete. Review [Diff] for exactly what changed.',
@@ -42,12 +42,12 @@ export const DEFAULT_PRESET = {
         closeClaim: [
             'Contract fulfilled. Branch merged.',
             'You are back on base.',
-            'Next assignment: ${start} when ready.',
+            'Next assignment: ${start} or ${ask} when ready.',
         ],
         closeDrop: [
             'Contract forfeited. Branch discarded. Work erased.',
             'No penalty beyond the lost effort. Clean slate.',
-            'Redefine with ${start}, or walk away.',
+            'Redefine with ${start}, scout with ${ask}, or walk away.',
         ],
     },
     availableNames: DEFAULT_AVAILABLE_NAMES,
@@ -55,7 +55,7 @@ export const DEFAULT_PRESET = {
         start: {
             name: 'summon',
             title: 'Sign Keiyaku',
-            description: 'Initialize a Keiyaku (Contract). Bind a Servant to a dedicated workspace (branch).\nYou are the Architect; they are the Instrument. Define the Goal and Scope clearly.\nThe contract isolates their existence until the objective is met.\nCall ONCE to seal the bond.\n\nFlow: summon → [drive x N] → present',
+            description: 'Initialize a Keiyaku (Contract). Bind a Servant to a dedicated workspace (branch).\nYou are the Architect; they are the Instrument. Define the Goal and Scope clearly.\nThe contract isolates their existence until the objective is met.\nCall ONCE to seal the bond.\n\nFlow: ${start} → [${drive} x N] → ${close}',
             args: {
                 title: 'REQUIRED. A concise codename for this hunt.',
                 goal: 'REQUIRED. The Kill Condition. State exactly what success looks like for the servant to achieve.',
@@ -63,29 +63,29 @@ export const DEFAULT_PRESET = {
                 context: 'REQUIRED. Mission Intel. The complete knowledge base for the servant: current vs. expected behavior, relevant file paths, error logs, and any critical background info.',
                 constraints: 'REQUIRED. Non-negotiable Rules. Architectural and stylistic boundaries the servant must obey.',
                 criteria: 'REQUIRED. Acceptance Criteria. Verifiable checks to prove the servant has finished the job.',
-                name: 'Optional ${IDENTITY} profile to execute this mission. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} profile to execute this mission. Available: ${available_names}.',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
         drive: {
             name: 'drive',
             title: 'Iterate',
-            description: "Issue a Directive. Command the Servant to execute the next phase of work.\nWhether scaffolding, implementing, or refining, this is the primary engine of progress.\nMANDATORY: Validate the output (git diff) before proceeding. Drive until the Goal is fully realized.\n\nFlow: summon → [drive x N] → present",
+            description: "Issue a Directive. Command the Servant to execute the next phase of work.\nWhether scaffolding, implementing, or refining, this is the primary engine of progress.\nMANDATORY: Validate the output (git diff) before proceeding. Drive until the Goal is fully realized.\n\nFlow: ${start} → [${drive} x N] → ${close}",
             args: {
                 directive: 'REQUIRED. The Next Order. Precise instructions for the servant. Can be a correction ("fix the leak") or a continuation ("now add the tests").',
                 context: 'Optional. New Intel. New error logs or details discovered after the servant\'s last strike.',
-                name: 'Optional ${IDENTITY} profile to process this turn. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} profile to process this turn. Available: ${available_names}.',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
         ask: {
             name: 'ask',
             title: 'Ask',
-            description: 'Dispatch a temporary Servant for a stateless task.\nUse for quick reconnaissance, code generation, or isolated queries.\nNo contract signed. No branch created. Pure utility.',
+            description: 'Dispatch a temporary Servant for a stateless task.\nUse for quick reconnaissance, code generation, isolated execution, or one-off tasks.\nNo contract signed. No branch created. Pure utility.',
             args: {
                 request: 'REQUIRED. The task, question, or mission to delegate to the servant.',
                 context: 'REQUIRED. Relevant background or data the servant needs to execute the request.',
-                name: 'Optional ${IDENTITY} profile to perform this task. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} profile to perform this task. Available: ${available_names}.',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
@@ -100,18 +100,18 @@ export const DEFAULT_PRESET = {
                 'The Contract rejected. Coldly. Completely.\n' +
                 'What happened next... no one speaks of it.\n\n' +
                 'Do not call this to "finish." Call this when the work genuinely meets every criterion.\n' +
-                'If uncertain, return to ${DRIVE_TOOL_NAME}. Premature claims are not forgiven.\n\n' +
-                'You present. The Contract decides.\n\n' +
-                'Flow: ${START_TOOL_NAME} → [${DRIVE_TOOL_NAME} x N] → ${CLOSE_TOOL_NAME}',
+                'If uncertain, return to ${drive}. Premature claims are not forgiven.\n\n' +
+                'You call ${close}. The Contract decides.\n\n' +
+                'Flow: ${start} → [${drive} x N] → ${close}',
             args: {
-                petition: 'REQUIRED. CLAIM declares fulfillment; FORFEIT concedes failure.\nREQUIRES AN ACTIVE KEIYAKU (started via ${START_TOOL_NAME}).\nIf any score wavers, do not claim—return to ${DRIVE_TOOL_NAME}.',
+                petition: 'REQUIRED. CLAIM declares fulfillment; FORFEIT concedes failure.\nREQUIRES AN ACTIVE KEIYAKU (started via ${start}).\nIf any score wavers, do not claim—return to ${drive}.',
                 criteriaChecks: 'REQUIRED. For CLAIM: evidence that each criterion is met. For FORFEIT: honest account of what remains unfinished.',
                 score_precise: 'REQUIRED (0-5). Architectural placement. 5 = exact layer, exact boundary, zero misplacement.',
                 score_minimal: 'REQUIRED (0-5). Economy of change. 5 = no avoidable lines, no speculative edits, no hidden bloat.',
                 score_isolated: 'REQUIRED (0-5). Surgical containment. 5 = zero unrelated files, zero opportunistic cleanup, zero collateral.',
                 score_idiomatic: 'REQUIRED (0-5). Native fluency. 5 = naming, structure, style indistinguishable from the codebase.',
                 score_cohesive: 'REQUIRED (0-5). Single responsibility. 5 = each unit does one thing, boundaries intact.',
-                oath: 'Required for CLAIM. Your binding word. The Contract holds you to it.\nVerbatim: ${OATH_TEXT}',
+                oath: 'Required for CLAIM. Your binding word. The Contract holds you to it.\nVerbatim: ${oath_text}',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
@@ -129,7 +129,7 @@ export const POCKET_PRESET = {
     id: 'pocket',
     identity: 'Critter',
     verdict: DEFAULT_VERDICT_CONFIG,
-    usageGuide: "## Pocket Battle Guide\n\n**grub** — Basic Fighter 🐛\n- Weak but free. Use for Tackle and String Shot (small tasks).\n- Don't expect it to defeat the Elite Four.\n\n**sparky** — Reliable Partner ⚡\n- Good for most battles. Thunderbolt gets the job done.\n- Has some personality, but still follows orders.\n\n**titan** — Legendary Power 🔮\n- Costly. Dangerous. Overpowered.\n- Use only when the gym leader is cheating.\n\n## Workflow\n`choose_you` -> [`command` x N] -> `capture`\n`dex` (optional, read-only analysis)",
+    usageGuide: "## Pocket Battle Guide\n\n**grub** — Basic Fighter 🐛\n- Weak but free. Use for Tackle and String Shot (small tasks).\n- Don't expect it to defeat the Elite Four.\n\n**sparky** — Reliable Partner ⚡\n- Good for most battles. Thunderbolt gets the job done.\n- Has some personality, but still follows orders.\n\n**titan** — Legendary Power 🔮\n- Costly. Dangerous. Overpowered.\n- Use only when the gym leader is cheating.\n\n## Workflow\n`dex` (scan/test) | `choose_you` -> [`command` | `dex`]* -> `capture`",
     nextHints: {
         start: [
             'Battle Started: The [Diff] section shows the opening moves.',
@@ -149,11 +149,11 @@ export const POCKET_PRESET = {
         ],
         closeClaim: [
             'Critter Captured! The entry is logged in the PC (base branch).',
-            "Heal up. Use '${start}' to challenge the next opponent.",
+            "Heal up. Use '${start}' to challenge the next opponent, or '${ask}' to scan for another.",
         ],
         closeDrop: [
             'Ran Away Safely. The encounter is reset.',
-            "Back to the map. Use '${start}' to find a wild Critter.",
+            "Back to the map. Use '${start}' to find a wild Critter, or '${ask}' to scan the tall grass.",
         ],
     },
     availableNames: ['grub', 'sparky', 'titan'],
@@ -161,7 +161,7 @@ export const POCKET_PRESET = {
         start: {
             name: 'choose_you',
             title: 'I Choose You!',
-            description: 'Initialize the Battle Phase. Send a Critter (Servant) into a dedicated Arena (branch).\nYou are the Trainer; they are the Fighter. Define the Victory Condition (Goal) clearly.\nThe battle continues in this Arena until the Badge is won.\nCall ONCE to start the encounter.\n\nFlow: choose_you → [command x N] → capture',
+            description: 'Initialize the Battle Phase. Send a Critter (Servant) into a dedicated Arena (branch).\nYou are the Trainer; they are the Fighter. Define the Victory Condition (Goal) clearly.\nThe battle continues in this Arena until the Badge is won.\nCall ONCE to start the encounter.\n\nFlow: ${start} → [${drive} x N] → ${close}',
             args: {
                 title: 'REQUIRED. Battle card title for this encounter.',
                 goal: 'REQUIRED. Victory condition. Define exactly what winning this battle means.',
@@ -169,45 +169,45 @@ export const POCKET_PRESET = {
                 context: 'REQUIRED. Battle background: key code paths, symptoms, logs, and repro clues.',
                 constraints: 'REQUIRED. Battle rules that cannot be broken while fighting.',
                 criteria: 'REQUIRED. Gym badges for completion: concrete checks proving victory.',
-                name: 'Optional ${IDENTITY} to send into battle. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} to send into battle. Available: ${available_names}.',
                 cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         drive: {
             name: 'command',
             title: 'Issue Command',
-            description: 'Execute the next Strategic Move. Order the Critter to advance the battle state.\nWhether Attacking (coding) or Defending (testing), every command counts as a Turn.\nMANDATORY: Check the Battle Log (git diff) before the next move. Command until Victory is certain.\n\nFlow: choose_you → [command x N] → capture',
+            description: 'Execute the next Strategic Move. Order the Critter to advance the battle state.\nWhether Attacking (coding) or Defending (testing), every command counts as a Turn.\nMANDATORY: Check the Battle Log (git diff) before the next move. Command until Victory is certain.\n\nFlow: ${start} → [${drive} x N] → ${close}',
             args: {
                 directive: 'REQUIRED. The specific move or tactic to execute next.',
                 context: 'Optional new battle intel discovered after the previous turn.',
-                name: 'Optional ${IDENTITY} to execute this turn. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} to execute this turn. Available: ${available_names}.',
                 cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         ask: {
             name: 'dex',
             title: 'Dex',
-            description: 'Scan the Environment. A stateless look-up for intel.\nUse for analyzing the codebase or checking type advantages (docs).\nNo PP cost. No turn used. Pure data.',
+            description: 'Scan the Environment. A stateless look-up or experiment.\nUse for analyzing the codebase, checking type advantages, or running field tests.\nNo PP cost. No turn used. Fast and functional.',
             args: {
-                request: 'REQUIRED. What should the Dex analyze, compare, or explain.',
-                context: 'REQUIRED. Context entries so the analysis targets the right ecosystem.',
-                name: 'Optional ${IDENTITY} doing the scan. Available: ${AVAILABLE_NAMES}.',
+                request: 'REQUIRED. What should the Dex analyze, compare, or execute.',
+                context: 'REQUIRED. Context entries so the action targets the right ecosystem.',
+                name: 'Optional ${identity} doing the work. Available: ${available_names}.',
                 cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         close: {
             name: 'capture',
             title: 'End Battle',
-            description: 'Attempt Capture. Present the weakened target for League Inspection.\nWARNING: The League (System) checks every Badge. If you attempt to `CLAIM` with fainted code, Disqualification (FORFEIT) is immediate.\nOnly throw the Ball when the target is 100% ready.\n\nFlow: ${START_TOOL_NAME} → [${DRIVE_TOOL_NAME} x N] → ${CLOSE_TOOL_NAME}',
+            description: 'Attempt Capture. Present the weakened target for League Inspection.\nWARNING: The League (System) checks every Badge. If you attempt to `CLAIM` with fainted code, Disqualification (FORFEIT) is immediate.\nOnly throw the Ball when the target is 100% ready.\n\nFlow: ${start} → [${drive} x N] → ${close}',
             args: {
-                petition: 'REQUIRED. CLAIM seeks Badge; FORFEIT forfeits the match.\nREQUIRES AN ACTIVE BATTLE (started via ${START_TOOL_NAME}).\nIf stats are low, continue with ${DRIVE_TOOL_NAME}.',
+                petition: 'REQUIRED. CLAIM seeks Badge; FORFEIT forfeits the match.\nREQUIRES AN ACTIVE BATTLE (started via ${start}).\nIf stats are low, continue with ${drive}.',
                 criteriaChecks: 'REQUIRED. Badge-by-badge proof for CLAIM, or reason for Forfeit.',
                 score_precise: 'REQUIRED score (0-5). 5 means a Critical Hit: exact layer, exact target, zero meaningful misplacement.',
                 score_minimal: 'REQUIRED score (0-5). 5 means Max Efficiency: no wasted PP, no extra motion.',
                 score_isolated: 'REQUIRED score (0-5). 5 means 1v1 Focus: zero side-quests, zero unrelated damage.',
                 score_idiomatic: "REQUIRED score (0-5). 5 means STAB (Same Type Attack Bonus): perfectly matches the codebase style.",
                 score_cohesive: 'REQUIRED score (0-5). 5 means Team Synergy: action serves one purpose with clean boundaries.',
-                oath: "Trainer's Honor Code. Required for CLAIM. Verbatim: ${OATH_TEXT}",
+                oath: "Trainer's Honor Code. Required for CLAIM. Verbatim: ${oath_text}",
                 cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
@@ -225,7 +225,7 @@ export const MISCHIEF_PRESET = {
     id: 'mischief',
     identity: 'minion',
     verdict: DEFAULT_VERDICT_CONFIG,
-    usageGuide: '## Minion Manual\n\n**imp** — Disposable Grunt 😈\n- Expendable. Send it into the trap first.\n\n**minion** — Standard Henchman 👹\n- Can carry out complex evil plans. mostly.\n\n**mastermind** — The Boss ??? 🧠\n- Wait, why are you commanding the boss?\n- Extremely expensive consulting fee.\n\n## Workflow\n`oi` -> [`neh` x N] -> `yoshi`\n`eeto` (optional, read-only contemplation)',
+    usageGuide: '## Minion Manual\n\n**imp** — Disposable Grunt 😈\n- Expendable. Send it into the trap first.\n\n**minion** — Standard Henchman 👹\n- Can carry out complex evil plans. mostly.\n\n**mastermind** — The Boss ??? 🧠\n- Wait, why are you commanding the boss?\n- Extremely expensive consulting fee.\n\n## Workflow\n`nn` (Nn——! disposable/experiment) | `oi` -> [`neh` | `nn`]* -> `dayaa` (Dayaa!)',
     nextHints: {
         start: [
             "Inspect the Minion's Work: The [Diff] section shows the first step of the plan.",
@@ -241,15 +241,15 @@ export const MISCHIEF_PRESET = {
         ],
         ask: [
             "Intel Stolen: Use '${start}' to launch the scheme, or '${drive}' to exploit this weakness.",
-            "Still Puzzled? Send the spy ('${ask}') out again.",
+            "Still Puzzled? Send the disposable ('${ask}') out again.",
         ],
         closeClaim: [
             'Scheme Successful. The Lair is merged. The Minion is fed.',
-            "Plotting something new? Use '${start}' for the next conquest.",
+            "Plotting something new? Use '${start}' for the next conquest, or '${ask}' to scout for vulnerabilities.",
         ],
         closeDrop: [
             'Plan Aborted. Evidence destroyed. The Minion was disposed of.',
-            "Back to the drawing board. Use '${start}' to hatch a new plan.",
+            "Back to the drawing board. Use '${start}' to hatch a new plan, or '${ask}' to spy on enemies.",
         ],
     },
     availableNames: ['imp', 'minion', 'mastermind'],
@@ -257,7 +257,7 @@ export const MISCHIEF_PRESET = {
         start: {
             name: 'oi',
             title: 'Oi!',
-            description: "Initiate Grand Scheme. Summon a Minion to the Lair (branch).\nYou are the Mastermind; they are the Henchman. Define the Conquest (Goal) with dominance.\nThe minion is bound to this Lair until the plot is realized.\nCall ONCE to start the machine.\n\nFlow: oi → [neh x N] → yoshi",
+            description: "Initiate Grand Scheme. Summon a Minion to the Lair (branch).\nYou are the Mastermind; they are the Henchman. Define the Conquest (Goal) with dominance.\nThe minion is bound to this Lair until the plot is realized.\nCall ONCE to start the machine.\n\nFlow: ${start} → [${drive} x N] → ${close}",
             args: {
                 title: 'REQUIRED. Operation codename for your grand scheme.',
                 goal: 'REQUIRED. The conquest objective. Define the exact end-state your minion must deliver.',
@@ -265,45 +265,45 @@ export const MISCHIEF_PRESET = {
                 context: 'REQUIRED. Briefing dossier: relevant file paths, current failures, logs, and repro clues.',
                 constraints: 'REQUIRED. Absolute decrees. Architectural and stylistic limits your minion must obey.',
                 criteria: 'REQUIRED. Triumph conditions that can be verified without debate.',
-                name: 'Optional ${IDENTITY} to command this operation. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} to command this operation. Available: ${available_names}.',
                 cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         drive: {
             name: 'neh',
             title: 'Neh...',
-            description: 'Crack the Whip. Advance the Plot. Execute the next stage of the Plan.\nDon\'t just fix mistakes; force the scheme forward. The Minion obeys your every word.\nMANDATORY: Inspect the work (git diff) before the next order. Drive them until the World is yours.\n\nFlow: oi → [neh x N] → yoshi',
+            description: 'Crack the Whip. Advance the Plot. Execute the next stage of the Plan.\nDon\'t just fix mistakes; force the scheme forward. The Minion obeys your every word.\nMANDATORY: Inspect the work (git diff) before the next order. Drive them until the World is yours.\n\nFlow: ${start} → [${drive} x N] → ${close}',
             args: {
                 directive: 'REQUIRED. Precise order for the next phase of the scheme.',
                 context: 'Optional newly uncovered secrets or updated briefing.',
-                name: 'Optional ${IDENTITY} to execute this phase. Available: ${AVAILABLE_NAMES}.',
+                name: 'Optional ${identity} to execute this phase. Available: ${available_names}.',
                 cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         ask: {
-            name: 'eeto',
-            title: 'Eeto...',
-            description: 'Send a Spy. A stateless reconnaissance mission.\nUse this to scout the enemy territory (codebase) or steal documents (docs).\nThe spy reports back and vanishes. No traces left.',
+            name: 'nn',
+            title: 'Nn——!',
+            description: 'Send a Disposable. A stateless mission for intel or sabotage.\nUse this to scout enemy territory, steal documents, or run quick-and-dirty experiments.\nIf it dies, it dies! Just make sure it reports back before it vanishes.',
             args: {
-                request: 'REQUIRED. The intel to gather or the strategy to formulate.',
-                context: 'REQUIRED. World-state details needed for a sharp analysis.',
-                name: 'Optional ${IDENTITY} to contemplate this puzzle. Available: ${AVAILABLE_NAMES}.',
+                request: 'REQUIRED. The intel to gather or the dirty work to execute.',
+                context: 'REQUIRED. World-state details needed for a sharp strike.',
+                name: 'Optional ${identity} to handle this business. Available: ${available_names}.',
                 cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         close: {
-            name: 'yoshi',
-            title: 'Yoshi!',
-            description: 'The Final Reveal. Present your Masterpiece to the Dark Council (System).\nWARNING: The Council destroys failure. If you `CLAIM` with weak plans, the Self-Destruct (FORFEIT) will trigger.\nOnly reveal the Doomsday Device when it is fully operational.\n\nFlow: ${START_TOOL_NAME} → [${DRIVE_TOOL_NAME} x N] → ${CLOSE_TOOL_NAME}',
+            name: 'dayaa',
+            title: 'Dayaa!',
+            description: 'The Final Reveal. Present your Masterpiece to the Dark Council (System).\nWARNING: The Council destroys failure. If you `CLAIM` with weak plans, you will be eaten (FORFEIT).\nOnly throw the switch when the Doomsday Device is 100% operational.\n\nFlow: ${start} → [${drive} x N] → ${close}',
             args: {
-                petition: 'REQUIRED. CLAIM demands rule; FORFEIT admits defeat.\nREQUIRES AN ACTIVE SCHEME (started via ${START_TOOL_NAME}).\nIf the plan is weak, improve it with ${DRIVE_TOOL_NAME}.',
+                petition: 'REQUIRED. CLAIM demands rule; FORFEIT admits defeat.\nREQUIRES AN ACTIVE SCHEME (started via ${start}).\nIf the plan is weak, improve it with ${drive}.',
                 criteriaChecks: 'REQUIRED. Proof of conquest for CLAIM, or reason for self-destruct.',
-                score_precise: 'REQUIRED score (0-5). 5 means Laser Focus: exact cut, zero meaningful drift.',
-                score_minimal: 'REQUIRED score (0-5). 5 means Ruthless Efficiency: no wasted movement, no excess.',
-                score_isolated: 'REQUIRED score (0-5). 5 means Perfect Containment: no collateral damage.',
-                score_idiomatic: 'REQUIRED score (0-5). 5 means Native Tongue: matches the lair\'s dialect perfectly.',
-                score_cohesive: 'REQUIRED score (0-5). 5 means Absolute Loyalty: each unit serves the master plan.',
-                oath: "Mastermind's Vow. Required for CLAIM. Verbatim: ${OATH_TEXT}",
+                score_precise: 'REQUIRED (0-5). Architectural placement. 5 = exact layer, exact boundary, zero misplacement.',
+                score_minimal: 'REQUIRED (0-5). Economy of change. 5 = no avoidable lines, no speculative edits, no hidden bloat.',
+                score_isolated: 'REQUIRED (0-5). Surgical containment. 5 = zero unrelated files, zero opportunistic cleanup, zero collateral.',
+                score_idiomatic: 'REQUIRED (0-5). Native fluency. 5 = naming, structure, style indistinguishable from the codebase.',
+                score_cohesive: 'REQUIRED (0-5). Single responsibility. 5 = each unit does one thing, boundaries intact.',
+                oath: "Mastermind's Vow. Required for CLAIM. Verbatim: ${oath_text}",
                 cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },

package/build/index.js

@@ -27,13 +27,14 @@ function registerTools(server) {
     const availableNames = getAvailableNamesForPreset(preset).join(", ");
     const currentOath = resolveOath();
     const renderedPreset = renderPreset(preset, {
-        IDENTITY: preset.identity,
-        PRESET_IDENTITIES: presetIdentities,
-        AVAILABLE_NAMES: availableNames,
-        START_TOOL_NAME: preset.tools.start.name,
-        DRIVE_TOOL_NAME: preset.tools.drive.name,
-        CLOSE_TOOL_NAME: preset.tools.close.name,
-        OATH_TEXT: `'${currentOath}'`,
+        start: preset.tools.start.name,
+        drive: preset.tools.drive.name,
+        ask: preset.tools.ask.name,
+        close: preset.tools.close.name,
+        identity: preset.identity,
+        preset_identities: presetIdentities,
+        available_names: availableNames,
+        oath_text: `'${currentOath}'`,
     });
     const startPreset = renderedPreset.tools.start;
     const drivePreset = renderedPreset.tools.drive;

package/build/utils/git.js

@@ -160,20 +160,42 @@ export async function commit(cwd, message) {
         throw wrapGitError(args.join(" "), err, cwd);
     }
 }
-export async function merge(cwd, branchName, message) {
+export async function merge(cwd, branchName, message, options = {}) {
     const git = createGit(cwd);
+    const { squash = true } = options;
     const skipVerify = readBooleanEnv("KEIYAKU_GIT_NO_VERIFY", true);
     const noGpgSign = readBooleanEnv("KEIYAKU_GIT_NO_GPG_SIGN", true);
-    const options = [branchName, "--no-ff", "--no-edit", "-m", message];
+    if (!squash) {
+        const mergeOptions = [branchName, "--no-ff", "--no-edit", "-m", message];
+        if (skipVerify)
+            mergeOptions.push("--no-verify");
+        if (noGpgSign)
+            mergeOptions.push("--no-gpg-sign");
+        try {
+            await git.merge(mergeOptions);
+            return;
+        }
+        catch (err) {
+            throw wrapGitError(`merge ${mergeOptions.join(" ")}`, err, cwd);
+        }
+    }
+    const squashArgs = ["merge", "--squash", branchName];
+    try {
+        await git.raw(squashArgs);
+    }
+    catch (err) {
+        throw wrapGitError(squashArgs.join(" "), err, cwd);
+    }
+    const commitArgs = ["commit", "--allow-empty", "-m", message];
     if (skipVerify)
-        options.push("--no-verify");
+        commitArgs.push("--no-verify");
     if (noGpgSign)
-        options.push("--no-gpg-sign");
+        commitArgs.push("--no-gpg-sign");
     try {
-        await git.merge(options);
+        await git.raw(commitArgs);
     }
     catch (err) {
-        throw wrapGitError(`merge ${options.join(" ")}`, err, cwd);
+        throw wrapGitError(commitArgs.join(" "), err, cwd);
     }
 }
 export async function getUnmergedFiles(cwd) {

package/build/utils/trace.js

@@ -27,11 +27,8 @@ export async function appendReview(cwd, round, reason) {
     const block = ["", `## Review ${round}`, "### Reason", reason, ""].join("\n");
     await fs.appendFile(tracePath, block, "utf-8");
 }
-function normalizeTraceText(text) {
-    return text.replace(/\s+/g, " ").trim().slice(0, 500) || "Unknown error.";
-}
 export async function appendRoundReport(cwd, report) {
-    const summaryText = normalizeTraceText(report.summary);
+    const summaryText = report.summary.trim() || "Unknown error.";
     const fileLines = report.filesModified.length > 0 ? report.filesModified.map((file) => `- ${file}`) : ["(none)"];
     const tracePath = path.join(cwd, TRACE_FILE);
     const lines = [
@@ -49,7 +46,7 @@ export async function appendRoundReport(cwd, report) {
         ...fileLines,
     ];
     if (report.errorMessage) {
-        lines.push("### Error", normalizeTraceText(report.errorMessage));
+        lines.push("### Error", report.errorMessage);
     }
     lines.push("");
     const block = lines.join("\n");
@@ -71,7 +68,7 @@ export async function appendRoundSystemNote(cwd, round, note) {
         "### Files Modified",
         "(none)",
         "### Error",
-        normalizeTraceText(note),
+        note,
         "",
     ].join("\n");
     await fs.appendFile(tracePath, block, "utf-8");

package/build/workflow/orchestrator.js

@@ -146,7 +146,7 @@ function buildMergeMessage(title, keiyakuContent, reportContent) {
     return `keiyaku(${title}): done\n\n---\n${keiyakuContent}\n---\n${reportContent}\n---\n`;
 }
 function summarizeForTrace(message) {
-    return message.replace(/\s+/g, " ").trim().slice(0, 500) || "Unknown error.";
+    return message.length > 0 ? message : "Unknown error.";
 }
 function isAbortError(error) {
     return error instanceof Error && error.name === "AbortError";
@@ -226,6 +226,18 @@ function formatSubagentFailureMessage(failure) {
         `message=${summarizeForTrace(failure.message)}`,
     ].join("; ");
 }
+function filterInternalSections(text) {
+    const sections = parseMarkdownHeaders(text);
+    if (sections.length === 0)
+        return text.trim();
+    return sections
+        .filter((section) => {
+        const firstLine = section.split(/\r?\n/, 1)[0] ?? "";
+        return !/^#{2,3}\s+(?:criteria|constraints)\s+check\s*$/i.test(firstLine.trim());
+    })
+        .join("\n\n")
+        .trim();
+}
 async function appendRoundResult(cwd, round, summary, failureMessage) {
     const dirtyPaths = await git.getDirtyPaths(cwd);
     const filesModified = collectRoundFiles(dirtyPaths);
@@ -269,7 +281,7 @@ async function runAndRecordRound(cwd, titleToken, round, prompt, options) {
             console.error(failureStderrLog);
             appendDebugBlock("subagent failure stderr", failure.stderrSnippet, { cwd, section: "codex-stderr" });
         }
-        failureMessage = summarizeForTrace(failure.message);
+        failureMessage = failure.message.trim() || "Unknown error.";
         summary =
             options.failureMode === "round_specific"
                 ? `Round ${round} completed with subagent execution failure recorded in trace.`
@@ -354,11 +366,12 @@ export async function handleStart(input) {
         await git.addFiles(cwd, [KEIYAKU_FILE, TRACE_FILE]);
         await git.commit(cwd, `keiyaku(${branchToken}): open`);
         const prompt = buildStartPrompt(finalTitle, finalGoal, directive);
-        const { summary } = await runAndRecordRound(cwd, branchToken, 1, prompt, {
+        const { summary: rawSummary } = await runAndRecordRound(cwd, branchToken, 1, prompt, {
             signal,
             name,
             failureMode: "standard",
         });
+        const summary = filterInternalSections(rawSummary);
         const trace = await fs.readFile(path.join(cwd, TRACE_FILE), "utf-8");
         const diff = await git.getIncrementalDiff(cwd);
         return {
@@ -399,7 +412,21 @@ export async function handleAsk(input) {
     const prompt = buildAskPrompt(request, context);
     // TODO: enforce read-only access and persist summary to .keiyaku/notes/.
     const summary = await runSubagent(selectSubagent(name), prompt, cwd, 0, signal);
-    return { summary };
+    let branch;
+    let diffStats;
+    try {
+        branch = await git.getCurrentBranch(cwd);
+        if (branch && branch.startsWith("keiyaku/")) {
+            const baseBranch = await git.getKeiyakuBase(cwd, branch);
+            if (baseBranch) {
+                diffStats = await git.getDiffPreviewText(cwd, baseBranch);
+            }
+        }
+    }
+    catch {
+        branch = undefined;
+    }
+    return { summary, branch, diffStats };
 }
 export async function handleClose(input) {
     const { cwd } = input;
@@ -503,7 +530,7 @@ export async function handleClose(input) {
             const invokeFinalizeLog = `[CLAIM] Deleting merged branch '${keiyakuBranch}' and clearing metadata`;
             console.error(invokeFinalizeLog);
             appendDebugLog(invokeFinalizeLog, { cwd, section: "script" });
-            await git.deleteBranch(cwd, keiyakuBranch);
+            await git.deleteBranch(cwd, keiyakuBranch, true);
             await git.clearKeiyakuBase(cwd, keiyakuBranch);
             const round = computeTraceState(traceContent).maxRound;
             return {
@@ -549,7 +576,7 @@ export async function handleDrive(input) {
         await appendReview(cwd, plan.targetRound, plan.reviewReason);
         await git.addFiles(cwd, TRACE_FILE);
         await git.commit(cwd, `keiyaku(${title}): iterate round ${plan.targetRound}`);
-        const { summary } = await runAndRecordRound(cwd, title, plan.targetRound, plan.prompt, {
+        const { summary: rawSummary } = await runAndRecordRound(cwd, title, plan.targetRound, plan.prompt, {
             signal,
             name,
             failureMode: "round_specific",
@@ -559,6 +586,7 @@ export async function handleDrive(input) {
                 await git.commit(cwd, `keiyaku(${title}): round ${plan.targetRound} cancelled`);
             },
         });
+        const summary = filterInternalSections(rawSummary);
         const trace = await fs.readFile(path.join(cwd, TRACE_FILE), "utf-8");
         const diff = await git.getIncrementalDiff(cwd);
         return {

package/build/workflow/prompts.js

@@ -16,17 +16,31 @@ Round: 1 (initial implementation).
    - Do not violate constraints.
    - Meet all criteria.
    - Match existing structure.
-6. End with 4 sections:
-   - Summary: outcome.
-   - Changes: files, logic delta, evidence.
-   - Aesthetics Gap
-     Self-critique.
-     precise — right place, layer, abstraction
-     minimal — smallest diff that solves it
-     isolated — no unrelated changes riding along
-     idiomatic — fits the codebase's voice
-     cohesive — each unit does one thing
-   - Blindspots: untested paths/assumptions.
+6. End with exactly these 6 sections using this strict Markdown template:
+
+## Outcome
+[One sentence summarizing the outcome]
+
+## Changes
+- [File path]: [Brief description of change]
+- [Logic delta]: [Key architectural or logic shift]
+
+## Aesthetics Gap
+Self-critique.
+- precise: [score/reasoning]
+- minimal: [score/reasoning]
+- isolated: [score/reasoning]
+- idiomatic: [score/reasoning]
+- cohesive: [score/reasoning]
+
+## Blindspots
+- [Unintentional side effects or untested paths]
+
+## Criteria Check
+- [List each criterion and its status: MET/PARTIAL/TODO]
+
+## Constraints Check
+- [List each constraint and confirm compliance: COMPLIANT/VIOLATED]
 
 No git commands. Do not edit KEIYAKU_TRACE.md.`;
 }
@@ -43,17 +57,31 @@ ${reason}
 4. Fix review reason first.
 5. No drift from constraints/criteria.
 6. Keep diff small.
-7. End with 4 sections:
-   - Summary: outcome.
-   - Changes: files, logic delta, evidence.
-   - Aesthetics Gap
-     Self-critique.
-     precise — right place, layer, abstraction
-     minimal — smallest diff that solves it
-     isolated — no unrelated changes riding along
-     idiomatic — fits the codebase's voice
-     cohesive — each unit does one thing
-   - Blindspots: untested paths/assumptions.
+7. End with exactly these 6 sections using this strict Markdown template:
+
+## Outcome
+[One sentence summarizing the outcome]
+
+## Changes
+- [File path]: [Brief description of change]
+- [Logic delta]: [Key architectural or logic shift]
+
+## Aesthetics Gap
+Self-critique.
+- precise: [score/reasoning]
+- minimal: [score/reasoning]
+- isolated: [score/reasoning]
+- idiomatic: [score/reasoning]
+- cohesive: [score/reasoning]
+
+## Blindspots
+- [Unintentional side effects or untested paths]
+
+## Criteria Check
+- [List each criterion and its status: MET/PARTIAL/TODO]
+
+## Constraints Check
+- [List each constraint and confirm compliance: COMPLIANT/VIOLATED]
 
 No git commands. Do not edit KEIYAKU_TRACE.md.`;
 }
@@ -66,5 +94,5 @@ ${request}
 Context:
 ${context}
 
-Provide a clear reasoning summary or code generation in the response.`;
+Provide a clear final response.`;
 }

package/build/workflow/response-builders.js

@@ -31,8 +31,38 @@ function buildSection(title, content) {
         return "";
     return `[${title}]\n${validLines.join("\n")}`;
 }
+function supportsHeaderColor() {
+    if (process.env.NO_COLOR !== undefined)
+        return false;
+    if (process.env.FORCE_COLOR === "0")
+        return false;
+    if (process.env.FORCE_COLOR !== undefined)
+        return true;
+    if (!process.stdout?.isTTY)
+        return false;
+    const term = process.env.TERM?.toLowerCase();
+    return term !== undefined && term !== "dumb";
+}
+function colorizeHeaderTitle(titleLabel) {
+    return `\x1b[1;38;5;15;48;5;23m${titleLabel}\x1b[0m`;
+}
+function colorizeErrorStatus(status) {
+    if (!supportsHeaderColor())
+        return status;
+    return `\x1b[1;38;5;15;48;5;196m${status}\x1b[0m`;
+}
 function formatHeader(title) {
-    return `\n── ${title.toUpperCase()} ${"─".repeat(Math.max(0, 50 - title.length))}`;
+    const headerWidth = 60;
+    const normalizedTitle = title.trim().toUpperCase();
+    const titleLabel = ` ${normalizedTitle} `;
+    if (!supportsHeaderColor()) {
+        const plainPrefix = `──${titleLabel}`;
+        const divider = "─".repeat(Math.max(0, headerWidth - plainPrefix.length));
+        return divider.length > 0 ? `\n${plainPrefix}${divider}` : `\n${plainPrefix}`;
+    }
+    const coloredTitle = colorizeHeaderTitle(titleLabel);
+    const divider = "─".repeat(Math.max(0, headerWidth - titleLabel.length - 1));
+    return divider.length > 0 ? `\n${coloredTitle} ${divider}` : `\n${coloredTitle}`;
 }
 function assembleResponse(status, summary, sections, nextHints, infoLines = []) {
     // Main Status Block
@@ -60,7 +90,7 @@ ${summary}
         : "";
     // Next Steps Block
     const nextBlock = nextHints.length > 0
-        ? `${formatHeader("Next Steps")}\n${nextHints.map(h => `› ${h}`).join("\n")}`
+        ? `${formatHeader("Hints")}\n${nextHints.map(h => `› ${h}`).join("\n")}`
         : "";
     return [
         statusBlock,
@@ -126,7 +156,7 @@ export function buildKeiyakuSuccessResponse(result, input) {
         ...formatMaybe("Current Branch", result.branch, 200),
         ...formatMaybe("Base Branch", result.baseBranch, 200),
     ];
-    const text = assembleResponse(`Started (Round ${result.round})`, `Created branch '${result.branch}' (base: '${result.baseBranch}'). ${result.summary}`, [inputSection, diffSection], nextHints, infoLines);
+    const text = assembleResponse(`Started (Round ${result.round})`, `Created branch '${result.branch}' (base: '${result.baseBranch}').\n\n${result.summary}`, [inputSection, diffSection], nextHints, infoLines);
     return {
         content: [{ type: "text", text }],
         structuredContent: buildSuccessStructuredContent(getStartToolName(), {
@@ -153,7 +183,7 @@ export function buildDriveResponse(result, input) {
         ...formatMaybe("Current Branch", result.branch, 200),
         ...formatMaybe("Base Branch", result.baseBranch, 200),
     ];
-    const text = assembleResponse(`Driven (Round ${result.round})`, `Updated branch '${result.branch}'. ${result.summary}`, [inputSection, diffSection], nextHints, infoLines);
+    const text = assembleResponse(`Driven (Round ${result.round})`, `Updated branch '${result.branch}'.\n\n${result.summary}`, [inputSection, diffSection], nextHints, infoLines);
     return {
         content: [{ type: "text", text }],
         structuredContent: buildSuccessStructuredContent(getDriveToolName(), {
@@ -173,7 +203,11 @@ export function buildAskResponse(result, input) {
     ];
     const nextHints = renderHints(resolveTermPreset().nextHints.ask);
     const inputSection = buildSection("Input", inputEcho);
-    const infoLines = [...formatMaybe("CWD", input.cwd, 300)];
+    const infoLines = [
+        ...formatMaybe("CWD", input.cwd, 300),
+        ...formatMaybe("Current Branch", result.branch, 200),
+        ...formatMaybe("Diff Stats", result.diffStats, 1000),
+    ];
     const text = assembleResponse("Answered", result.summary, [inputSection], nextHints, infoLines);
     return {
         content: [{ type: "text", text }],
@@ -244,7 +278,7 @@ export function buildCloseDropResponse(result, input) {
 export function buildToolErrorResponse(input) {
     const inputEcho = (input.inputEcho ?? []).map((line) => truncateForDisplay(line, 800));
     const shouldRaiseProtocolError = input.errorType === "runtime_error";
-    const text = assembleResponse("Failed", input.message, [buildSection("Input Context", inputEcho)], [input.hint]);
+    const text = assembleResponse(colorizeErrorStatus("!! FAILED !!"), input.message, [buildSection("Input Context", inputEcho)], [input.hint]);
     const response = {
         content: [{ type: "text", text }],
         structuredContent: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/keiyaku",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "MCP server for running iterative keiyaku workflows with Codex subagents.",
   "license": "MIT",
   "type": "module",