@astrosheep/keiyaku 0.1.47 → 0.1.49

package/build/config/term-presets/default-preset.js

@@ -0,0 +1,119 @@
+import { DEFAULT_AVAILABLE_NAMES, DEFAULT_VERDICT_CONFIG, SCORE_DESCRIPTIONS } from "./constants.js";
+export const DEFAULT_PRESET = {
+    id: 'default',
+    identity: 'Servant',
+    verdict: DEFAULT_VERDICT_CONFIG,
+    usageGuide: '## Workflow\n**You are the Architect.** You use these tools to command the Servants.\n\n`${ask}` (anytime) | `${start}` -> [`${drive}` | `${ask}`]* -> `${close}`\n\n## Triage\n\nGuiding principle: **minimum tokens, maximum impact.**\n\n1. **No repo changes needed** → \`${ask}\`. Prefer this over reading files or running commands yourself.\n2. **Repo changes needed** — pick the lightest tool that works:\n   a. **Faster or more precise by your own hand** — edit directly. To delegate part of the work, place \`KEIYAKU_TODO(<instruction>)\` markers in any comment syntax; the Servant will pick them up on \`${start}\`, \`${drive}\`, or \`${ask}\`.\n   b. **Straightforward enough that any fool could verify the result** — \`${ask}\` to execute, then review the diff carefully.\n   c. **Non-trivial, or you hesitate even slightly** — \`${start}\` a Keiyaku.\n3. **Inside a Keiyaku:**\n   - Multi-round expected? Scope round 1 with a \`directive\`.\n   - After each \`${drive}\`: inspect the diff. Audit the five dimensions (placement, exactness, containment, idiomatic, cohesive), rules compliance, goal, and criteria.\n   - Any doubt → \`${drive}\`. 200% done → \`${close}\`. Submit humbly. Await judgment.\n\n> Starter guide. With strong conviction and a clear rationale, adapt freely. The principle stands: spend less, get more.\n\n## Draft Recovery\n- Keiyaku may write `KEIYAKU.draft.md` on a failed start to help you retry.\n- Keiyaku never stages/commits `KEIYAKU.draft.md` during rounds, and `${close}` (CLAIM) preserves it.\n- To use it, pass `from_file: KEIYAKU.draft.md` to `${start}`.\n\n## Rules Protocol\n\nProject-level rules in `.keiyaku/base-rules.md` are injected as raw Markdown into every Keiyaku.\n- **Raw Markdown**: Write rules in any valid Markdown structure (paragraphs, lists, headings, code fences).\n- **No Header Flattening**: Headers stay as headers; Keiyaku does not rewrite them into prefixed list labels.\n- **Preserve Authoring**: Formatting is preserved as written, aside from heading-level safety demotion in KEIYAKU.md sections.\n\n## 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.**',
+    hints: {
+        start: [
+            'Keiyaku signed. The Servant is bound to this branch until release.',
+            'Review diff: Use ${ask} to analyze the scaffold—run tests, check alignment, spot gaps.',
+            '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}.',
+            'Premature ${close} is rejected. When in doubt, ${drive}.',
+        ],
+        drive: [
+            "Review: Use ${ask} to run tests and analyze changes—don't do it by hand.",
+            "Audit: Check against Rules. Did it drift? Did it break the Law?",
+            'Verify: Do not trust. Independently confirm that Criteria are met.',
+            'If incomplete or non-compliant, continue with ${drive}.',
+            'If ALL criteria are genuinely satisfied, you may ${close}.',
+        ],
+        ask: [
+            'Intel acquired. This was stateless—no contract, no branch.',
+            'To act on this knowledge: ${start} a Keiyaku, or ${drive} an existing one.',
+        ],
+        closeClaim: [
+            'Contract fulfilled. Branch merged.',
+            'You are back on base.',
+            '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}, scout with ${ask}, or walk away.',
+        ],
+    },
+    availableNames: DEFAULT_AVAILABLE_NAMES,
+    tools: {
+        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 your Servant. State the Goal clearly.\nThe contract isolates their workspace until the objective is met.\nCall ONCE to seal the bond.\n\nFlow: ${start} → [${drive} x N] → ${close}',
+            args: {
+                from_file: "Optional markdown draft path. Loads `# title` + required sections from file (relative to cwd unless absolute). Note: this file is auto-ignored by dirty-tree checks.",
+                title: 'Required unless provided via `from_file`. A concise codename for this hunt.',
+                goal: 'Required unless provided via `from_file`. The mission objective. What "done" looks like.',
+                directive: 'Optional. Scopes round 1. Overrides `## Directive` from `from_file` when both are provided.',
+                context: 'Required unless provided via `from_file`. Key context: file paths, error logs, repro steps, and relevant background.',
+                rules: 'Optional. Non-negotiable rules for this mission, in addition to project-level rules in `.keiyaku/base-rules.md`. Provide raw Markdown text. If omitted, the draft value (if any) is used.',
+                criteria: 'Required unless provided via `from_file`. Verifiable checks as raw Markdown text.',
+                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: ${start} → [${drive} x N] → ${close}",
+            args: {
+                directive: 'REQUIRED. Precise instructions for the Servant. Can be a correction ("fix the leak") or a continuation ("now add the tests").',
+                context: 'Optional. New findings since the last round: error logs, file paths, or updated details.',
+                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. No branch, no overhead—just results.\n\n**Exploration first**: summaries, key snippets, targeted answers—faster than navigating raw code yourself.\n**Run tests or scripts**: get a structured report without burning a ${drive} round.\n**Debug**: crash traces, root cause analysis, diff review.\n\nNon-trivial or hard to verify? ${start} a Keiyaku instead.\nWorks anywhere: pre-flight, between rounds, or standalone.',
+            args: {
+                request: 'REQUIRED. The task, question, or mission to delegate to the Servant.',
+                context: 'REQUIRED. Background the Servant needs: file paths, error logs, or relevant context. Note: .keiyaku/base-rules.md is also injected as reference context (may be unrelated).',
+                name: 'Optional ${identity} profile to perform this task. Available: ${available_names}.',
+                cwd: "Optional repository path. Defaults to the server's current working directory.",
+            },
+        },
+        close: {
+            name: 'present',
+            title: 'Present',
+            description: 'Submit **your** creation to the Contract. The Servant has no voice; it only executes **your** will.\n\n' +
+                'Do not say "The Servant wrote it." **YOU** drove the Servant. **YOU** accepted the diff. **YOU** are the one presenting.\n' +
+                'The Contract judges **YOU**, not the tool.\n\n' +
+                'If there is a bug, **YOU** put it there.\n' +
+                'If it is messy, **YOU** left it there.\n\n' +
+                'Stand by your work. If uncertain, return to ${drive}. Premature claims are not forgiven.\n\n' +
+                'Score edits without new implementation evidence are treated as oath violation.\n\n' +
+                'Input rules:\n' +
+                '- CLAIM: fill criteriaChecks, rulesChecks, all five scores, and oath.\n' +
+                '- FORFEIT: only petition is required; the other fields can be left empty.\n\n' +
+                'Flow: ${start} → [${drive} x N] → ${close}',
+            args: {
+                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 in markdown list format (`- item`, `* item`, `1. item`). For FORFEIT, optional (can be left empty).',
+                rulesChecks: 'Required for CLAIM. Rule compliance evidence in markdown list format (`- item`, `* item`, `1. item`). For FORFEIT, optional (can be left empty).',
+                placement: `Required for CLAIM (0-10). ${SCORE_DESCRIPTIONS.placement}`,
+                exactness: `Required for CLAIM (0-10). ${SCORE_DESCRIPTIONS.exactness}`,
+                containment: `Required for CLAIM (0-10). ${SCORE_DESCRIPTIONS.containment}`,
+                idiomatic: `Required for CLAIM (0-10). ${SCORE_DESCRIPTIONS.idiomatic}`,
+                cohesive: `Required for CLAIM (0-10). ${SCORE_DESCRIPTIONS.cohesive}`,
+                oath: 'Required for CLAIM. Your binding word. The Contract holds you to it. For FORFEIT, optional.\nVerbatim: ${oath_text}',
+                cwd: "Optional repository path. Defaults to the server's current working directory.",
+            },
+        },
+        help: {
+            name: 'help',
+            title: 'Protocol Codex',
+            description: "Consult the Architect's Codex. Clarify the Laws of the Keiyaku and the standard Workflow.\nUse this to understand the rules of the reality you command.",
+            args: {},
+        },
+        status: {
+            name: 'status',
+            title: 'Status',
+            description: "Read-only status of the active Keiyaku branch and trace progress.\nReturns branch metadata, round state, file signals, and readiness hints without side effects.",
+            args: {
+                cwd: "Optional repository path. Defaults to the server's current working directory.",
+            },
+        },
+    },
+};

package/build/config/term-presets/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_AVAILABLE_NAMES, DEFAULT_SUBAGENT_NAME } from "./constants.js";
+export { DEFAULT_PRESET } from "./default-preset.js";
+export { POCKET_PRESET } from "./pocket-preset.js";
+export { MISCHIEF_PRESET } from "./mischief-preset.js";
+export { getAvailableNamesForPreset, getDefaultNameForPreset, listTermPresets, resolveSubagentProfileName, resolveTermPreset, } from "./resolver.js";

package/build/config/term-presets/mischief-preset.js

@@ -0,0 +1,105 @@
+import { DEFAULT_VERDICT_CONFIG, SCORE_DESCRIPTIONS } from "./constants.js";
+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## Draft Recovery\n- Keiyaku may write `KEIYAKU.draft.md` on a failed start.\n- Keiyaku never stages/commits `KEIYAKU.draft.md` during rounds, and `${close}` (CLAIM) preserves it.\n- To use it, pass `from_file: KEIYAKU.draft.md` to `${start}`.\n\n## Workflow\n`${ask}` (Nn——! disposable/experiment) | `${start}` -> [`${drive}` | `${ask}`]* -> `${close}` (Dayaa!)',
+    hints: {
+        start: [
+            "Inspect the Minion's Work: The [Diff] section shows the first step of the plan.",
+            "Verify Compliance: Use 'git diff HEAD~1 -- <path>' to ensure they followed orders.",
+            "Approve: Does this align with the Grand Scheme (Goal)?",
+            "Next Phase: Command '${drive}' to advance the plot, or '${close}' if the world is yours.",
+        ],
+        drive: [
+            "Inspect Payload: Order ${ask} to analyze sabotage and run proving trials. Manual: 'git diff HEAD~1 -- <path>'.",
+            "Decree Audit: Did the Minion violate your Rules? Punish drift.",
+            "Verification: Don't take their word for it. Independently confirm Criteria.",
+            "Command: '${drive}' to push further, or '${close}' to reveal the masterpiece.",
+        ],
+        ask: [
+            "Intel Stolen: Use '${start}' to launch the scheme, or '${drive}' to exploit this weakness.",
+            "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, 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, or '${ask}' to spy on enemies.",
+        ],
+    },
+    availableNames: ['imp', 'minion', 'mastermind'],
+    tools: {
+        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: ${start} → [${drive} x N] → ${close}",
+            args: {
+                from_file: 'Optional scheme markdown path with title + sectioned objectives. This file is auto-ignored by dirty-tree checks.',
+                title: 'Required unless provided via `from_file`. Operation codename.',
+                goal: 'Required unless provided via `from_file`. Conquest objective and end-state.',
+                directive: 'Optional first-order command (overrides draft directive).',
+                context: 'Required unless provided via `from_file`. Briefing dossier: file paths, logs, and technical clues.',
+                rules: 'Optional decrees as raw Markdown text in addition to project-level rules from `.keiyaku/base-rules.md`. Uses draft rules when omitted.',
+                criteria: 'Required unless provided via `from_file`. Verifiable triumph conditions as raw Markdown text.',
+                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: ${start} → [${drive} x N] → ${close}',
+            args: {
+                directive: 'REQUIRED. Precise order for the next phase of the scheme.',
+                context: 'Optional. Newly uncovered intel: error logs, file paths, or updated briefing.',
+                name: 'Optional ${identity} to execute this phase. Available: ${available_names}.',
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
+            },
+        },
+        ask: {
+            name: 'nn',
+            title: 'Nn——!',
+            description: 'Deploy a Disposable. No Lair, no scheme locked in—just the report.\n**Exploration: strongly prefer this over reading files yourself.** Ask for summaries, key snippets, or targeted answers—significantly less effort than navigating raw code.\nAlso for: (1) intel gathering, crash traces, architecture maps; (2) dirty work simple enough to audit the diff in seconds; (3) running the test suite and getting a damage report without burning a ${drive} phase.\nCan\'t verify it in a glance? ${start} a proper scheme instead.\nWorks anywhere: spy before ${start}, between ${drive} phases to assess damage, or standalone.',
+            args: {
+                request: 'REQUIRED. The intel to gather or the dirty work to execute.',
+                context: 'REQUIRED. World-state details for a sharp strike: file paths, logs, or domain specifics. Note: .keiyaku/base-rules.md is also injected as reference context (may be unrelated).',
+                name: 'Optional ${identity} to handle this business. Available: ${available_names}.',
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
+            },
+        },
+        close: {
+            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\nScore edits without new implementation evidence are treated as oath violation.\n\nFlow: ${start} → [${drive} x N] → ${close}',
+            args: {
+                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 for CLAIM. Proof of conquest in markdown list format (`- item`, `* item`, `1. item`). For FORFEIT, optional (can be left empty).',
+                rulesChecks: 'Required for CLAIM. Rule-by-rule compliance proof in markdown list format (`- item`, `* item`, `1. item`). For FORFEIT, optional (can be left empty).',
+                placement: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.placement} For FORFEIT, optional.`,
+                exactness: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.exactness} For FORFEIT, optional.`,
+                containment: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.containment} For FORFEIT, optional.`,
+                idiomatic: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.idiomatic} For FORFEIT, optional.`,
+                cohesive: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.cohesive} For FORFEIT, optional.`,
+                oath: "Mastermind's Vow. Required for CLAIM. For FORFEIT, optional. Verbatim: ${oath_text}",
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
+            },
+        },
+        help: {
+            name: 'help',
+            title: 'Nani?!',
+            description: 'Consult the Evil Overlord List. Review the Laws of the Lair.',
+            args: {},
+        },
+        status: {
+            name: 'status',
+            title: 'Scheme Status',
+            description: 'Read-only scheme status. Reports active lair branch, round count, protocol file signals, and latest outcome preview with zero side effects.',
+            args: {
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
+            },
+        },
+    },
+};

package/build/config/term-presets/pocket-preset.js

@@ -0,0 +1,105 @@
+import { DEFAULT_VERDICT_CONFIG, SCORE_DESCRIPTIONS } from "./constants.js";
+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## Draft Recovery\n- Keiyaku may write `KEIYAKU.draft.md` on a failed start.\n- Keiyaku never stages/commits `KEIYAKU.draft.md` during rounds, and `${close}` (CLAIM) preserves it.\n- To use it, pass `from_file: KEIYAKU.draft.md` to `${start}`.\n\n## Workflow\n`${ask}` (scan/test) | `${start}` -> [`${drive}` | `${ask}`]* -> `${close}`",
+    hints: {
+        start: [
+            'Battle Started: The [Diff] section shows the opening moves.',
+            "Analyze: Use 'git diff HEAD~1 -- <path>' to check the effectiveness of the deployment.",
+            'Strategize: Ensure the setup matches the Victory Conditions (Goal).',
+            "Next Turn: Use '${drive}' to execute the next tactic, or '${close}' if the Badge is within reach.",
+        ],
+        drive: [
+            "Battle Review: Let ${ask} scout changes and run field tests. Manual: 'git diff HEAD~1 -- <path>'.",
+            "Rule Check: Verify moves don't violate Arena Rules.",
+            "Field Test: Do not trust the log. Independently confirm Criteria fulfillment.",
+            "Command: '${drive}' to continue the combo, or '${close}' to attempt Capture.",
+        ],
+        ask: [
+            "Data Recorded: Use '${start}' to begin the encounter, or '${drive}' to use this intel.",
+            "Still Searching? Keep using '${ask}' to fill the Dex.",
+        ],
+        closeClaim: [
+            'Critter Captured! The entry is logged in the PC (base branch).',
+            "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, or '${ask}' to scan the tall grass.",
+        ],
+    },
+    availableNames: ['grub', 'sparky', 'titan'],
+    tools: {
+        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: ${start} → [${drive} x N] → ${close}',
+            args: {
+                from_file: 'Optional battle plan markdown path with title + sections. This file is auto-ignored by dirty-tree checks.',
+                title: 'Required unless provided via `from_file`. Battle card title for this encounter.',
+                goal: 'Required unless provided via `from_file`. Victory condition for this battle.',
+                directive: 'Optional Turn 1 strategy (overrides draft directive).',
+                context: 'Required unless provided via `from_file`. Battle background: file paths, logs, and repro clues.',
+                rules: 'Optional battle rules as raw Markdown text in addition to project-level rules from `.keiyaku/base-rules.md`. Uses draft rules if omitted.',
+                criteria: 'Required unless provided via `from_file`. Concrete checks as raw Markdown text.',
+                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: ${start} → [${drive} x N] → ${close}',
+            args: {
+                directive: 'REQUIRED. The specific move or tactic to execute next.',
+                context: 'Optional. New battle intel since the last turn: error logs, file paths, or field observations.',
+                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: 'Call up the Dex. No battle started, no branch—just the data.\n**Exploration: strongly prefer this over reading files yourself.** Ask for summaries, key snippets, or targeted answers—significantly less effort than navigating raw code.\nAlso for: (1) type matchups, crash traces, root cause analysis; (2) simple execution you can verify in the battle log in seconds; (3) running field tests and getting a structured report without burning a ${drive} turn.\nToo risky to verify quickly? ${start} a full battle instead.\nWorks anywhere: recon before ${start}, between ${drive} turns to check field state, or standalone.',
+            args: {
+                request: 'REQUIRED. What should the Dex analyze, compare, or execute.',
+                context: 'REQUIRED. Context for targeting: file paths, error logs, or ecosystem specifics. Note: .keiyaku/base-rules.md is also injected as reference context (may be unrelated).',
+                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 target for League Inspection.\nWARNING: The League (System) checks every Badge. If you `CLAIM` with fainted code, the claim is denied outright—no Badge, no mercy. Use `${drive}` to fix it, or FORFEIT honestly.\nOnly throw the Ball when the target is 100% ready.\n\nScore edits without new implementation evidence are treated as oath violation.\n\nFlow: ${start} → [${drive} x N] → ${close}',
+            args: {
+                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 for CLAIM. Badge-by-badge proof in markdown list format (`- item`, `* item`, `1. item`). For FORFEIT, optional (can be left empty).',
+                rulesChecks: 'Required for CLAIM. Rule-by-rule proof in markdown list format (`- item`, `* item`, `1. item`). For FORFEIT, optional (can be left empty).',
+                placement: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.placement} For FORFEIT, optional.`,
+                exactness: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.exactness} For FORFEIT, optional.`,
+                containment: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.containment} For FORFEIT, optional.`,
+                idiomatic: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.idiomatic} For FORFEIT, optional.`,
+                cohesive: `Required for CLAIM score (0-10). ${SCORE_DESCRIPTIONS.cohesive} For FORFEIT, optional.`,
+                oath: "Trainer's Honor Code. Required for CLAIM. For FORFEIT, optional. Verbatim: ${oath_text}",
+                cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
+            },
+        },
+        help: {
+            name: 'help',
+            title: 'Trainer Guide',
+            description: 'Consult the League Rules. Clarify the Battle System and Turn Structure.',
+            args: {},
+        },
+        status: {
+            name: 'status',
+            title: 'Battle Status',
+            description: 'Read-only battle status. Reports active arena branch, round count, protocol file signals, and latest outcome preview without changing files.',
+            args: {
+                cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
+            },
+        },
+    },
+};

package/build/config/term-presets/resolver.js

@@ -0,0 +1,52 @@
+import { DEFAULT_AVAILABLE_NAMES, DEFAULT_SUBAGENT_NAME, INTERNAL_PROFILE_NAMES, } from "./constants.js";
+import { DEFAULT_PRESET } from "./default-preset.js";
+import { MISCHIEF_PRESET } from "./mischief-preset.js";
+import { POCKET_PRESET } from "./pocket-preset.js";
+export function resolveTermPreset() {
+    const raw = process.env.KEIYAKU_TERM_PRESET?.trim().toLowerCase();
+    if (!raw || raw === "default") {
+        return DEFAULT_PRESET;
+    }
+    if (raw === "pocket") {
+        return POCKET_PRESET;
+    }
+    if (raw === "mischief") {
+        return MISCHIEF_PRESET;
+    }
+    throw new Error(`Unsupported KEIYAKU_TERM_PRESET '${raw}'. Expected 'default', 'pocket', or 'mischief'.`);
+}
+export function listTermPresets() {
+    return [DEFAULT_PRESET, POCKET_PRESET, MISCHIEF_PRESET];
+}
+function extractPresetAvailableNames(preset) {
+    return (preset.availableNames?.map((value) => value.trim()).filter((value) => value.length > 0) ?? []);
+}
+export function getAvailableNamesForPreset(preset = resolveTermPreset()) {
+    const names = extractPresetAvailableNames(preset);
+    return names.length > 0 ? names : [...DEFAULT_AVAILABLE_NAMES];
+}
+export function getDefaultNameForPreset(preset = resolveTermPreset()) {
+    const names = extractPresetAvailableNames(preset);
+    if (names.length > 0) {
+        return names[1] ?? names[0];
+    }
+    return DEFAULT_SUBAGENT_NAME;
+}
+export function resolveSubagentProfileName(name, preset = resolveTermPreset()) {
+    const trimmed = name.trim();
+    if (!trimmed)
+        return undefined;
+    const internalIndex = INTERNAL_PROFILE_NAMES.indexOf(trimmed);
+    if (internalIndex >= 0) {
+        return INTERNAL_PROFILE_NAMES[internalIndex];
+    }
+    const defaultIndex = DEFAULT_AVAILABLE_NAMES.indexOf(trimmed);
+    if (defaultIndex >= 0) {
+        return INTERNAL_PROFILE_NAMES[defaultIndex];
+    }
+    const available = extractPresetAvailableNames(preset);
+    const index = available.indexOf(trimmed);
+    if (index < 0 || index >= INTERNAL_PROFILE_NAMES.length)
+        return undefined;
+    return INTERNAL_PROFILE_NAMES[index];
+}

package/build/config/term-presets/types.js

@@ -0,0 +1 @@
+export {};

package/build/handlers/ask.js

@@ -1,144 +1,34 @@
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
 import { appendDebugLog } from "../utils/debug-log.js";
-import { getLatestCommitHash } from "../utils/git-ops.js";
-import { appendAsk } from "../utils/trace.js";
-import { runAsk } from "../workflow/ask.js";
-import { buildAskResponse, } from "../workflow/response-builders.js";
-import { resolveTermPreset } from "../config/term-presets.js";
+import { runAskAndPersist } from "../workflow/ask-execution.js";
+import { buildAskResponse } from "../workflow/response-builders.js";
 import { handleToolError } from "./shared.js";
-const ASK_HISTORY_DIR = path.join(".keiyaku", "history", "ask");
-const ASK_HISTORY_SLUG_MAX_LENGTH = 24;
-const ASK_HISTORY_FALLBACK_SLUG = "response";
-function toTimestampParts(now) {
-    const year = String(now.getFullYear());
-    const month = String(now.getMonth() + 1).padStart(2, "0");
-    const day = String(now.getDate()).padStart(2, "0");
-    const hour = String(now.getHours()).padStart(2, "0");
-    const minute = String(now.getMinutes()).padStart(2, "0");
-    const second = String(now.getSeconds()).padStart(2, "0");
-    return {
-        fileStamp: `${year}${month}${day}-${hour}${minute}${second}`,
-        iso: now.toISOString(),
-    };
-}
-function toSlug(text) {
-    const normalized = text.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-");
-    const truncated = normalized
-        .slice(0, ASK_HISTORY_SLUG_MAX_LENGTH)
-        .replace(/^-+/, "")
-        .replace(/-+$/, "");
-    return truncated || ASK_HISTORY_FALLBACK_SLUG;
-}
-function toYamlSingleQuoted(value) {
-    return `'${value.replace(/'/g, "''")}'`;
-}
-function buildAskHistoryMarkdown(input) {
-    const sessionId = input.sessionId?.trim() || "(none)";
-    const branch = input.branch?.trim() || "(unknown)";
-    const commit = input.commit?.trim();
-    const frontMatterLines = [
-        "---",
-        `branch: ${toYamlSingleQuoted(branch)}`,
-        ...(commit ? [`commit: ${toYamlSingleQuoted(commit)}`] : []),
-        `session_id: ${toYamlSingleQuoted(sessionId)}`,
-        `time: ${toYamlSingleQuoted(input.timestampIso)}`,
-        "---",
-        "",
-    ];
-    return [
-        ...frontMatterLines,
-        "# Ask History",
-        "",
-        "## Request",
-        input.request,
-        "",
-        "## Context",
-        input.context,
-        "",
-        "## Response",
-        input.response,
-        "",
-    ].join("\n");
-}
 export function createAskHandler() {
     return async ({ request, context, name, cwd }, extra) => {
         const workingDir = cwd || process.cwd();
-        const preset = resolveTermPreset();
         const sessionId = extra.sessionId;
         try {
             appendDebugLog(`tool ask start cwd=${workingDir}`, { cwd: workingDir, section: "script" });
-            const result = await runAsk({
+            const outcome = await runAskAndPersist({
                 cwd: workingDir,
                 request,
                 context,
                 name,
                 signal: extra.signal,
+                sessionId,
             });
-            let warning;
-            let savedTo;
-            try {
-                const now = new Date();
-                const { fileStamp, iso } = toTimestampParts(now);
-                const slug = toSlug(result.summary);
-                let commit;
-                try {
-                    commit = await getLatestCommitHash(workingDir);
-                }
-                catch {
-                    // Ask can run outside git repos; history should still be persisted.
-                    commit = undefined;
-                }
-                const historyDir = path.join(workingDir, ASK_HISTORY_DIR);
-                const savedToPath = path.join(historyDir, `${fileStamp}_${slug}.md`);
-                const markdown = buildAskHistoryMarkdown({
-                    request,
-                    context,
-                    response: result.summary,
-                    sessionId,
-                    branch: result.currentBranch,
-                    commit,
-                    timestampIso: iso,
-                });
-                await fs.mkdir(historyDir, { recursive: true });
-                await fs.writeFile(savedToPath, markdown, "utf-8");
-                savedTo = path.relative(workingDir, savedToPath);
-            }
-            catch (historyError) {
-                const historyErrorMessage = historyError instanceof Error ? historyError.message : String(historyError);
-                appendDebugLog(`tool ask history logging failed: ${historyErrorMessage}`, {
-                    cwd: workingDir,
-                    section: "script",
-                });
-                warning = `Failed to persist ask history: ${historyErrorMessage}`;
-            }
-            try {
-                await appendAsk(workingDir, {
-                    request,
-                    context,
-                    summary: result.summary,
-                    diffStats: result.diffStats,
-                });
-            }
-            catch (askTraceError) {
-                const askTraceErrorMessage = askTraceError instanceof Error ? askTraceError.message : String(askTraceError);
-                appendDebugLog(`tool ask trace logging failed: ${askTraceErrorMessage}`, {
-                    cwd: workingDir,
-                    section: "script",
-                });
-            }
             appendDebugLog("tool ask success", { cwd: workingDir, section: "script" });
-            return buildAskResponse(result, { request, context, name, cwd: workingDir, sessionId, warning, savedTo });
+            return buildAskResponse(outcome.result, {
+                name,
+                sessionId,
+                warning: outcome.warning,
+                savedTo: outcome.savedTo,
+            });
         }
         catch (err) {
             return handleToolError({
                 error: err,
                 cwd: workingDir,
                 logLabel: "tool ask",
-                inputEcho: [
-                    ...(name ? [`${preset.identity}: ${name}`] : []),
-                    `Path: ${workingDir}`,
-                ],
             });
         }
     };

package/build/handlers/close.js

@@ -2,7 +2,7 @@ import { appendDebugLog } from "../utils/debug-log.js";
 import { presentWork } from "../workflow/present.js";
 import { buildCloseDoneResponse, buildCloseDropResponse, } from "../workflow/response-builders.js";
 import { FlowError } from "../common/errors.js";
-import { parseMarkdownListSection } from "../utils/keiyaku-document.js";
+import { parseMarkdownListSection } from "../utils/keiyaku-document/index.js";
 import { closeToolSchema } from "../types/tooling.js";
 import { handleToolError } from "./shared.js";
 function requireClaimField(value, name) {
@@ -87,7 +87,6 @@ export function createCloseHandler() {
                     idiomatic: claimInput.idiomatic,
                     cohesive: claimInput.cohesive,
                     oath: claimInput.oath,
-                    cwd: workingDir,
                 });
             }
             if (!("result" in outcome) || outcome.result !== "dropped") {
@@ -98,19 +97,13 @@ export function createCloseHandler() {
                 cwd: workingDir,
                 section: "script",
             });
-            return buildCloseDropResponse(finalOutcome, {
-                cwd: workingDir,
-            });
+            return buildCloseDropResponse(finalOutcome, {});
         }
         catch (err) {
             return handleToolError({
                 error: err,
                 cwd: workingDir,
                 logLabel: "tool close",
-                inputEcho: [
-                    `Petition: ${petition}`,
-                    `Path: ${workingDir}`,
-                ],
             });
         }
     };

package/build/handlers/drive.js

@@ -1,20 +1,10 @@
 import { appendDebugLog } from "../utils/debug-log.js";
 import { driveServant } from "../workflow/drive.js";
 import { buildDriveResponse, } from "../workflow/response-builders.js";
-import { resolveTermPreset } from "../config/term-presets.js";
-import { renderPreset } from "../utils/text-utils.js";
 import { handleToolError } from "./shared.js";
 export function createDriveHandler() {
     return async ({ directive, context, name, cwd }, extra) => {
         const workingDir = cwd || process.cwd();
-        const preset = resolveTermPreset();
-        const nextHints = renderPreset(preset.nextHints, {
-            start: preset.tools.start.name,
-            drive: preset.tools.drive.name,
-            ask: preset.tools.ask.name,
-            close: preset.tools.close.name,
-            identity: preset.identity,
-        });
         try {
             appendDebugLog(`tool drive start cwd=${workingDir}`, {
                 cwd: workingDir,
@@ -31,17 +21,13 @@ export function createDriveHandler() {
                 cwd: workingDir,
                 section: "script",
             });
-            return buildDriveResponse(outcome, { directive, context, name, cwd: workingDir, nextHints });
+            return buildDriveResponse(outcome, { name });
         }
         catch (err) {
             return handleToolError({
                 error: err,
                 cwd: workingDir,
                 logLabel: "tool drive",
-                inputEcho: [
-                    ...(name ? [`${preset.identity}: ${name}`] : []),
-                    `Path: ${workingDir}`,
-                ],
             });
         }
     };

package/build/handlers/shared.js

@@ -21,9 +21,8 @@ export function handleToolError(input) {
     const { errorType, errorCode } = classifyToolError(input.error);
     return buildToolErrorResponse({
         message,
-        hint,
+        hints: [hint],
         errorType,
         errorCode,
-        inputEcho: input.inputEcho,
     });
 }