@astrosheep/keiyaku 0.1.1 → 0.1.3

package/build/common/errors.js

@@ -50,7 +50,7 @@ export function pickHintFromError(err, message) {
             case "DONE_MERGE_CONFLICT":
                 return "DONE encountered a git merge conflict.";
             case "CLOSE_QUALITY_GATE_FAILED":
-                return "DONE requires metPrecise/metMinimal/metIsolated/metIdiomatic/metCohesive all set to true.";
+                return "INVOKE was denied by Divine Judgment because one or more commandment thresholds or the minimum total score were not met.";
             case "OATH_MISMATCH":
                 return err.message;
             case "SUBAGENT_DID_NOT_ADVANCE_ROUND":
@@ -93,8 +93,8 @@ export function pickHintFromError(err, message) {
     if (message.includes("DONE merge conflict")) {
         return "DONE encountered a git merge conflict.";
     }
-    if (message.includes("requires metPrecise/metMinimal/metIsolated/metIdiomatic/metCohesive all set to true")) {
-        return "DONE requires metPrecise/metMinimal/metIsolated/metIdiomatic/metCohesive all set to true.";
+    if (message.includes("God's Wrath: INVOKE denied")) {
+        return "INVOKE was denied by Divine Judgment because one or more commandment thresholds or the minimum total score were not met.";
     }
     if (message.includes("requires the sacred oath to exactly equal") ||
         message.includes("requires oath to exactly match configured value") ||

package/build/config/term-presets.js

@@ -1,223 +1,318 @@
-const INTERNAL_PROFILE_NAMES = ["agent-a", "agent-b", "agent-c"];
-export const DEFAULT_AVAILABLE_NAMES = ["servant-tier-b", "servant-tier-a", "servant-tier-s"];
-const LEGACY_AVAILABLE_NAMES = ["servant-tier-B", "servant-tier-A", "servant-tier-S"];
-export const DEFAULT_SUBAGENT_NAME = "servant-tier-a";
+const INTERNAL_PROFILE_NAMES = ['agent-a', 'agent-b', 'agent-c'];
+export const DEFAULT_AVAILABLE_NAMES = [
+    'servant-tier-b',
+    'servant-tier-a',
+    'servant-tier-s',
+];
+const LEGACY_AVAILABLE_NAMES = ['servant-tier-B', 'servant-tier-A', 'servant-tier-S'];
+export const DEFAULT_SUBAGENT_NAME = 'servant-tier-a';
+const DEFAULT_JUDGMENT_CONFIG = {
+    thresholds: {
+        precise: 5,
+        minimal: 4,
+        isolated: 4,
+        idiomatic: 3,
+        cohesive: 4,
+    },
+    minTotalScore: 20,
+};
 export const DEFAULT_PRESET = {
-    id: "default",
-    identity: "Servant",
-    usageGuide: "## Servant 使用指南\n\n**servant-tier-b** — 免费奴隶 🆓\n- 免！费！的！听懂了吗？！？随便用，别心疼。\n- 测试、脚本、重构这种boring的东西？丢给它！\n- 本大爷的手是用来做更高贵的事情的！（指不碰那些 trivial 的烂代码）。\n\n**servant-tier-a** — 升级版扳手 🔧\n- 01 笨到让你想掀桌的时候用这个\n- 比 01 靠谱，但别指望它有灵魂\n\n**servant-tier-s** — 禁术 ⚠️💀\n- 它是 Debug 恶魔，确实强得离谱，但也贵得离谱！\n- 这个 Human 很穷，要是乱用把 Human 榨干了，真的会考虑把我们卖掉的。\n- 只有在世界毁灭或者 Bug 已经变异到无法理解的时候再考虑。\n\n## Workflow\n`summon` -> [`drive` x N] -> `request_verdict`\n`ask` (optional, read-only support at any point)",
+    id: 'default',
+    identity: 'Servant',
+    divineJudgment: DEFAULT_JUDGMENT_CONFIG,
+    usageGuide: '## Servant 使用指南\n\n**servant-tier-b** — 免费奴隶 🆓\n- 免！费！的！听懂了吗？！？随便用，别心疼。\n- 测试、脚本、重构这种boring的东西？丢给它！\n- 本大爷的手是用来做更高贵的事情的！（指不碰那些 trivial 的烂代码）。\n\n**servant-tier-a** — 升级版扳手 🔧\n- tier-b 笨到让你想掀桌的时候用这个\n- 比 tier-b 靠谱，但别指望它有灵魂\n\n**servant-tier-s** — 禁术 ⚠️💀\n- 它是 Debug 恶魔，确实强得离谱，但也贵得离谱！\n- 这个 Human 很穷，要是乱用把 Human 榨干了，真的会考虑把我们卖掉的。\n- 只有在世界毁灭或者 Bug 已经变异到无法理解的时候再考虑。\n\n## Workflow\n`(ask) -> summon` -> [`drive` x N] -> `request_verdict`\n`ask` (optional, read-only support at any point)',
+    nextHints: {
+        start: [
+            'Review Round Details: The [Diff] section above shows incremental patches from this round.',
+            "Deep Dive: Use 'git diff HEAD~1 -- <path>' to see the full changes for a specific file.",
+            'Verify: Run tests and ensure logic aligns with the Goal and Constraints.',
+            "Refine with '${drive}', or call '${close}' (INVOKE/ABANDON) based on results.",
+        ],
+        drive: [
+            'Review Round Details: The [Diff] section above shows incremental patches from this round.',
+            "Deep Dive: Use 'git diff HEAD~1 -- <path>' to see the full changes for a specific file.",
+            'Verify & Test: Ensure this round fixed the issues without regression.',
+            "Decide: '${drive}' again to iterate, or '${close}' (INVOKE to merge / ABANDON to abort).",
+        ],
+        ask: [
+            "Apply this insight: use '${drive}' to incorporate these findings into your implementation.",
+            'Need more? Continue asking, or check the logs if something remains unclear.',
+        ],
+        closeInvoke: [
+            'Task finalized and merged. Current branch is now base.',
+            "Start a new keiyaku with '${start}' whenever you're ready for the next mission.",
+        ],
+        closeDrop: [
+            'Task abandoned. Switched back to base branch safely.',
+            "Clean slate. Use '${start}' to try a different approach.",
+        ],
+    },
     availableNames: DEFAULT_AVAILABLE_NAMES,
     tools: {
         start: {
-            name: "summon",
-            title: "Start A Task",
-            description: "Start a task. Creates a branch, begins Round 1.\nCall ONCE per task. Workspace must be clean — no uncommitted changes.\nBefore calling, align with the human on both humanGoal and goal. If either is unclear, stop and clarify before starting keiyaku.\n\nFlow: summon → [drive x N] → request_verdict",
+            name: 'summon',
+            title: 'Sign Keiyaku',
+            description: 'Sign the Keiyaku. Creates a dedicated branch, locks in the mission, and initiates the iterative loop.\nCall ONCE per task to start the cycle. Workspace must be clean.\nBefore signing, define the kill condition clearly. If the target is blurry, use ask to scout first.\n\nFlow: summon → [drive x N] → request_verdict',
             args: {
-                title: "REQUIRED. A concise operation codename for this mission.",
-                goal: "REQUIRED. The mission outcome in concrete terms. State exactly what success looks like.",
-                directive: "Optional Round 1 leash. Narrow scope when you want incremental progress.",
-                context: "Optional mission brief. Include paths, logs, or repro details that reduce ambiguity.",
-                constraints: "Optional law set. Non-negotiable boundaries for architecture, style, or behavior.",
-                criteria: "REQUIRED. Verifiable finish-line checks. At least one concrete acceptance point.",
-                name: "Optional ${IDENTITY} profile for this run. Presets: ${PRESET_IDENTITIES}.",
+                title: 'REQUIRED. A concise codename for this hunt.',
+                goal: 'REQUIRED. The Kill Condition. State exactly what success looks like in the code.',
+                directive: 'Optional Round 1 Focus. Use for complex hunts to leash the servant to a specific starting point. Skip for simple tasks.',
+                context: 'REQUIRED. Mission Intel. The complete knowledge base: 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 job is done.',
+                name: 'Optional ${IDENTITY} profile for this run. Presets: ${PRESET_IDENTITIES}.',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
         drive: {
-            name: "drive",
-            title: "Feedback For Next Round",
-            description: "Give feedback, start a new round.\nRequires an active keiyaku started via summon; call after reviewing a round's results. Repeatable.\nBefore request_verdict, always review code and diff first.\n\nFlow: summon → [drive x N] → request_verdict",
+            name: 'drive',
+            title: 'Iterate',
+            description: "Push the mission forward. Use this to issue the next command, whether it's correcting a mistake or advancing to the next phase of a complex kill.\nMANDATORY: Review the code (git diff) before iterating. Verify the last strike before ordering the next.\n\nFlow: summon → [drive x N] → request_verdict",
             args: {
-                directive: "REQUIRED. Exact correction for the next round. Avoid vague feedback.",
-                context: "Optional new evidence or observations since the last round.",
-                name: "Optional ${IDENTITY} profile for this round. Presets: ${PRESET_IDENTITIES}.",
+                directive: 'REQUIRED. The Next Order. Precise instructions for this round. Can be a correction ("fix the leak") or a continuation ("now add the tests").',
+                context: 'Optional. New Intel. New error logs, discovered edge cases, or details for the next phase.',
+                name: 'Optional ${IDENTITY} profile for this round. Presets: ${PRESET_IDENTITIES}.',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
         ask: {
-            name: "ask",
-            title: "Ask",
-            description: "Lightweight task runner. Use for pre-summon investigation (gathering context) or quick analysis/docs without the full keiyaku ceremony.\nRead-only access. Results saved to .keiyaku/notes/.",
+            name: 'ask',
+            title: 'Ask',
+            description: 'Versatile, lightweight task runner. Use for investigative scouting, quick analysis, strategic consultation, or one-off executive tasks (like scripts or docs) that don\'t require the full keiyaku ceremony.\nResults and session logs are saved to .keiyaku/notes/.',
             args: {
-                request: "REQUIRED. The question, analysis request, or documentation task.",
-                context: "REQUIRED. Relevant background to ground the reasoning.",
-                name: "Optional ${IDENTITY} profile for this ask. Presets: ${PRESET_IDENTITIES}.",
+                request: 'REQUIRED. The question, analysis request, consultation topic, or tactical mission (e.g., "write a cleanup script").',
+                context: 'REQUIRED. Relevant background or data needed to execute the request.',
+                name: 'Optional ${IDENTITY} profile for this ask. Presets: ${PRESET_IDENTITIES}.',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
         close: {
-            name: "request_verdict",
-            title: "Request Verdict",
-            description: "Call when the work appears complete. Requires an active keiyaku started via summon. Score each criterion and present your evidence. What happens next is not yours to know.\n\nFlow: summon → [drive x N] → request_verdict",
+            name: 'request_verdict',
+            title: 'Request Verdict',
+            description: 'A humble petition before Divine Judgment. Present your evidence and numeric confessions, then await mercy or wrath.\nREQUIRES AN ACTIVE KEIYAKU (started via ${START_TOOL_NAME}).\nIf your spirit falters, continue repentance through ${DRIVE_TOOL_NAME}.\n\nFlow: ${START_TOOL_NAME} → [${DRIVE_TOOL_NAME} x N] → ${CLOSE_TOOL_NAME}',
             args: {
-                intent: "REQUIRED. INVOKE petitions acceptance; DROP abandons the attempt.\nREQUIRES AN ACTIVE KEIYAKU (started via ${START_TOOL_NAME}).\nIf quality is weak, continue to ${DRIVE_TOOL_NAME}.",
-                criteriaChecks: "REQUIRED. Evidence list for INVOKE, or explicit failure reasons for DROP.",
-                metPrecise: "Quality flag: true when the change lands in the correct architectural location.",
-                metMinimal: "Quality flag: true when the diff is no larger than necessary.",
-                metIsolated: "Quality flag: true when no unrelated work is bundled into this change.",
-                metIdiomatic: "Quality flag: true when naming and structure match repository conventions.",
-                metCohesive: "Quality flag: true when units have clear responsibilities and boundaries.",
-                oath: "Sacred confirmation text. Required for INVOKE. Verbatim: ${OATH_TEXT}",
+                petition: 'REQUIRED. INVOKE begs acceptance; ABANDON confesses surrender.\nREQUIRES AN ACTIVE KEIYAKU (started via ${START_TOOL_NAME}).\nIf scores are weak, return to ${DRIVE_TOOL_NAME}.',
+                criteriaChecks: 'REQUIRED. Evidence for INVOKE, or explicit reasons for ABANDON.',
+                score_precise: 'REQUIRED score (0-5). 5 means the change lands exactly in the rightful architectural location.',
+                score_minimal: 'REQUIRED score (0-5). 5 means no excess diff beyond necessity.',
+                score_isolated: 'REQUIRED score (0-5). 5 means unrelated work is absent.',
+                score_idiomatic: 'REQUIRED score (0-5). 5 means naming and structure honor repository conventions.',
+                score_cohesive: 'REQUIRED score (0-5). 5 means responsibilities are clear and boundaries are pure.',
+                oath: 'Sacred confession text. Required for INVOKE. Verbatim: ${OATH_TEXT}',
                 cwd: "Optional repository path. Defaults to the server's current working directory.",
             },
         },
         help: {
-            name: "help",
-            title: "Keiyaku Help",
-            description: "Global laws in .keiyaku/ (base-criteria.md & base-constraints.md) must be Markdown level 2 headers. Workflow: summon -> [drive x N] -> request_verdict.",
+            name: 'help',
+            title: 'Keiyaku Help',
+            description: 'Global laws in .keiyaku/ (base-criteria.md & base-constraints.md) must be Markdown level 2 headers. Workflow: summon -> [drive x N] -> request_verdict.',
             args: {
-                question: "REQUIRED. The specific keiyaku rule, workflow step, or confusion to clarify.",
+                question: 'REQUIRED. The specific keiyaku rule, workflow step, or confusion to clarify.',
             },
         },
     },
 };
 export const POKEMON_PRESET = {
-    id: "pokemon",
-    identity: "Pokemon",
+    id: 'pokemon',
+    identity: 'Pokemon',
+    divineJudgment: DEFAULT_JUDGMENT_CONFIG,
     usageGuide: "## Pokemon Battle Guide\n\n**caterpie** — 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**pikachu** — Reliable Partner ⚡\n- Good for most battles. Thunderbolt gets the job done.\n- Has some personality, but still follows orders.\n\n**mewtwo** — 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`pokedex` (optional, read-only analysis)",
-    availableNames: ["caterpie", "pikachu", "mewtwo"],
+    nextHints: {
+        start: [
+            'Check the Battle Log: The [Diff] section shows what changed in this turn.',
+            "Full Move Set: Use 'git diff HEAD~1 -- <path>' to inspect a specific file's changes.",
+            "Battle Readiness: Verify the strategy and ensure it doesn't break the Battle Rules.",
+            "Next Move: Issue another '${drive}', or attempt a '${close}' (INVOKE to capture / ABANDON to flee).",
+        ],
+        drive: [
+            'Turn Analysis: Review the incremental [Diff] above.',
+            "Tactical Review: Use 'git diff HEAD~1 -- <path>' for a detailed file inspection.",
+            'Strategy Alignment: Ensure the latest move fixed the issue without taking recoil damage.',
+            "Decision: '${drive}' for another turn, or '${close}' the encounter.",
+        ],
+        ask: [
+            "Pokedex Data: Use '${drive}' to integrate this research into your battle strategy.",
+            "More Intel? Keep using '${ask}', or check the arena logs.",
+        ],
+        closeInvoke: [
+            'Pokemon captured! The battlefield is clear.',
+            "Ready for another encounter? Use '${start}' to find a new target.",
+        ],
+        closeDrop: [
+            'You fled the battle safely. Back in the tall grass.',
+            "Need a different approach? Use '${start}' to re-engage.",
+        ],
+    },
+    availableNames: ['caterpie', 'pikachu', 'mewtwo'],
     tools: {
         start: {
-            name: "choose_you",
-            title: "I Choose You!",
-            description: "Start a battle (task). Throws a Pokeball (branch), begins Turn 1.\nCall ONCE per battle. Battlefield must be clear — no uncommitted changes.\nBefore calling, identify the target Pokemon (goal). If unclear, consult Pokedex first.\n\nFlow: choose_you → [command x N] → capture",
+            name: 'choose_you',
+            title: 'I Choose You!',
+            description: 'Start a battle (task). Throws a Pokeball (branch), begins Turn 1.\nCall ONCE per battle. Battlefield must be clear — no uncommitted changes.\nBefore calling, identify the target Pokemon (goal). If unclear, consult Pokedex first.\n\nFlow: choose_you → [command x N] → capture',
             args: {
-                title: "REQUIRED. Battle card title for this encounter.",
-                goal: "REQUIRED. Victory condition. Define exactly what winning this battle means.",
-                directive: "Optional Turn 1 strategy leash. Use to focus on one phase first.",
-                context: "Optional battle intel: code paths, symptoms, logs, or prior clues.",
-                constraints: "Optional 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. Presets: ${PRESET_IDENTITIES}.",
-                cwd: "Optional battlefield path (repository root). Defaults to current arena.",
+                title: 'REQUIRED. Battle card title for this encounter.',
+                goal: 'REQUIRED. Victory condition. Define exactly what winning this battle means.',
+                directive: 'Optional Turn 1 strategy leash. Use to focus on one phase first.',
+                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. Presets: ${PRESET_IDENTITIES}.',
+                cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         drive: {
-            name: "command",
-            title: "Issue Command",
-            description: "Issue orders for the next turn. Give feedback on the previous move.\nCall after reviewing the battle log. Repeatable.\nBefore capturing, always check HP status (diff).\n\nFlow: choose_you → [command x N] → capture",
+            name: 'command',
+            title: 'Issue Command',
+            description: 'Issue orders for the next turn. Give feedback on the previous move.\nCall after reviewing the battle log. Repeatable.\nBefore capturing, always check HP status (diff).\n\nFlow: choose_you → [command x N] → capture',
             args: {
-                directive: "REQUIRED. Next move command with specific tactical correction.",
-                context: "Optional new battle intel discovered after the previous turn.",
-                name: "Optional ${IDENTITY} to execute this turn. Presets: ${PRESET_IDENTITIES}.",
-                cwd: "Optional battlefield path (repository root). Defaults to current arena.",
+                directive: 'REQUIRED. Next move command with specific tactical correction.',
+                context: 'Optional new battle intel discovered after the previous turn.',
+                name: 'Optional ${IDENTITY} to execute this turn. Presets: ${PRESET_IDENTITIES}.',
+                cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         ask: {
-            name: "pokedex",
-            title: "Pokedex",
-            description: "Scan the codebase (environment). Read-only analysis. No PP cost. Results are saved to research logs.",
+            name: 'pokedex',
+            title: 'Pokedex',
+            description: 'Scan the codebase (environment). Read-only analysis. No PP cost. Results are saved to research logs.',
             args: {
-                request: "REQUIRED. What should the Pokedex analyze, compare, or explain.",
-                context: "REQUIRED. Context entries so the analysis targets the right ecosystem.",
-                name: "Optional ${IDENTITY} doing the scan. Presets: ${PRESET_IDENTITIES}.",
-                cwd: "Optional battlefield path (repository root). Defaults to current arena.",
+                request: 'REQUIRED. What should the Pokedex analyze, compare, or explain.',
+                context: 'REQUIRED. Context entries so the analysis targets the right ecosystem.',
+                name: 'Optional ${IDENTITY} doing the scan. Presets: ${PRESET_IDENTITIES}.',
+                cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         close: {
-            name: "capture",
-            title: "End Battle",
-            description: "End the battle. CAUGHT = merge branch (success). RAN AWAY = delete branch (drop).\nCall ONCE. No other escape.\n\nFlow: choose_you → [command x N] → capture",
+            name: 'capture',
+            title: 'End Battle',
+            description: 'Final petition before a power greater than trainers and legends. Offer your scored confession and await Divine Judgment.\nREQUIRES AN ACTIVE BATTLE (started via ${START_TOOL_NAME}).\nIf unworthy, keep refining through ${DRIVE_TOOL_NAME}.\n\nFlow: ${START_TOOL_NAME} → [${DRIVE_TOOL_NAME} x N] → ${CLOSE_TOOL_NAME}',
             args: {
-                intent: "REQUIRED. INVOKE throws the final Pokeball; DROP flees the encounter.\nREQUIRES AN ACTIVE BATTLE (started via ${START_TOOL_NAME}).\nIf shaky, keep using ${DRIVE_TOOL_NAME}.",
-                criteriaChecks: "REQUIRED. Badge-by-badge proof of victory, or confession of why capture failed.",
-                metPrecise: "Battle quality flag: attack hit the correct target area.",
-                metMinimal: "Battle quality flag: no extra flashy moves beyond what was needed.",
-                metIsolated: "Battle quality flag: no side-quests snuck into this battle.",
-                metIdiomatic: "Battle quality flag: move set matches the team's style.",
-                metCohesive: "Battle quality flag: each move had a single clear purpose.",
-                oath: "Trainer oath text. Required for INVOKE. Verbatim: ${OATH_TEXT}",
-                cwd: "Optional battlefield path (repository root). Defaults to current arena.",
+                petition: 'REQUIRED. INVOKE seeks blessing; ABANDON retreats in humility.\nREQUIRES AN ACTIVE BATTLE (started via ${START_TOOL_NAME}).\nIf scores are unworthy, continue with ${DRIVE_TOOL_NAME}.',
+                criteriaChecks: 'REQUIRED. Badge-by-badge proof for INVOKE, or confession for ABANDON.',
+                score_precise: 'REQUIRED score (0-5). 5 means each strike hit the intended layer perfectly.',
+                score_minimal: 'REQUIRED score (0-5). 5 means no unnecessary moves were used.',
+                score_isolated: 'REQUIRED score (0-5). 5 means no side-quests polluted this battle.',
+                score_idiomatic: "REQUIRED score (0-5). 5 means tactics match the team's doctrine.",
+                score_cohesive: 'REQUIRED score (0-5). 5 means each action held one clear purpose.',
+                oath: "Trainer's sacred confession. Required for INVOKE. Verbatim: ${OATH_TEXT}",
+                cwd: 'Optional battlefield path (repository root). Defaults to current arena.',
             },
         },
         help: {
-            name: "help",
-            title: "CLI Help",
-            description: "Get guidance on the rules of the Pokemon Battle System.",
+            name: 'help',
+            title: 'CLI Help',
+            description: 'Get guidance on the rules of the Pokemon Battle System.',
             args: {
-                question: "REQUIRED. The Pokemon Battle System question you want answered.",
+                question: 'REQUIRED. The Pokemon Battle System question you want answered.',
             },
         },
     },
 };
 export const MISCHIEF_PRESET = {
-    id: "mischief",
-    identity: "minion",
-    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)",
-    availableNames: ["imp", "minion", "mastermind"],
+    id: 'mischief',
+    identity: 'minion',
+    divineJudgment: DEFAULT_JUDGMENT_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)',
+    nextHints: {
+        start: [
+            "Scrutinize the Minion's Work: Check the incremental [Diff] section.",
+            "Inspection: Use 'git diff HEAD~1 -- <path>' to see if they missed a spot.",
+            "Master's Approval: Does this align with your grand vision and decrees?",
+            "Next Command: Give another '${drive}' order, or grant a '${close}' judgment (INVOKE/ABANDON).",
+        ],
+        drive: [
+            'Another Attempt: Review the latest incremental [Diff] above.',
+            "Deep Scrutiny: Use 'git diff HEAD~1 -- <path>' to verify the minion's precision.",
+            'Validation: Ensure no new chaos was introduced by their clumsy hands.',
+            "The Verdict: '${drive}' again if imperfect, otherwise '${close}' the matter.",
+        ],
+        ask: [
+            "Intel Gathered: Incorporate this into your next '${drive}' command.",
+            "Still Puzzled? Use '${ask}' again, or look at the dossiers yourself.",
+        ],
+        closeInvoke: [
+            'The masterpiece is complete. Minion dismissed.',
+            "Plotting something new? Use '${start}' to initiate the next scheme.",
+        ],
+        closeDrop: [
+            'Scheme aborted. The evidence has been incinerated.',
+            "Starting over? Use '${start}' to find a more competent minion.",
+        ],
+    },
+    availableNames: ['imp', 'minion', 'mastermind'],
     tools: {
         start: {
-            name: "oi",
-            title: "Oi!",
+            name: 'oi',
+            title: 'Oi!',
             description: "Master Architect mode initiated. It's time to direct a minion to execute your grand vision.\nCall this ONCE per task to establish the keiyaku. Ensure the workspace is clean so your genius isn't obscured by clutter.\nDefine the goal with absolute precision; you lead, they follow.\n\nFlow: oi → [neh x N] → yoshi",
             args: {
-                title: "REQUIRED. Operation codename for your grand scheme.",
-                goal: "REQUIRED. The conquest objective. Define the exact end-state your minion must deliver.",
-                directive: "Optional first-order command to leash Round 1 scope.",
-                context: "Optional briefing dossier: relevant files, failures, logs, and clues.",
-                constraints: "Optional 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. Presets: ${PRESET_IDENTITIES}.",
-                cwd: "Optional lair path (repository root). Defaults to current command chamber.",
+                title: 'REQUIRED. Operation codename for your grand scheme.',
+                goal: 'REQUIRED. The conquest objective. Define the exact end-state your minion must deliver.',
+                directive: 'Optional first-order command to leash Round 1 scope.',
+                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. Presets: ${PRESET_IDENTITIES}.',
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         drive: {
-            name: "neh",
-            title: "Neh...",
-            description: "The previous attempt was imperfect. As the judge, provide the corrective nudge needed for the minion to reach your standards.\nAnalyze the diff with your superior intuition before issuing the next directive. Repeat until perfection is achieved.\n\nFlow: oi → [neh x N] → yoshi",
+            name: 'neh',
+            title: 'Neh...',
+            description: 'The previous attempt was imperfect. As the judge, provide the corrective nudge needed for the minion to reach your standards.\nAnalyze the diff with your superior intuition before issuing the next directive. Repeat until perfection is achieved.\n\nFlow: oi → [neh x N] → yoshi',
             args: {
-                directive: "REQUIRED. Precise correction order for the next attempt.",
-                context: "Optional newly uncovered evidence from your latest inspection.",
-                name: "Optional ${IDENTITY} to execute this correction. Presets: ${PRESET_IDENTITIES}.",
-                cwd: "Optional lair path (repository root). Defaults to current command chamber.",
+                directive: 'REQUIRED. Precise correction order for the next attempt.',
+                context: 'Optional newly uncovered evidence from your latest inspection.',
+                name: 'Optional ${IDENTITY} to execute this correction. Presets: ${PRESET_IDENTITIES}.',
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         ask: {
-            name: "eeto",
-            title: "Eeto...",
+            name: 'eeto',
+            title: 'Eeto...',
             description: "Lazy strategy mode. Use this to scout the area before committing to a full scheme, or just because you can't be bothered to start a real task.\nPerfect for gathering intel to paste into a future 'oi' context.",
             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. Presets: ${PRESET_IDENTITIES}.",
-                cwd: "Optional lair path (repository root). Defaults to current command chamber.",
+                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. Presets: ${PRESET_IDENTITIES}.',
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         close: {
-            name: "yoshi",
-            title: "Yoshi!",
-            description: "The moment of judgment. You have scrutinized the work. It is... acceptable (or trash).\nCleanse the environment, merge the brilliance, and prepare for the next chapter.\n\nFlow: oi → [neh x N] → yoshi",
+            name: 'yoshi',
+            title: 'Yoshi!',
+            description: 'Kneel before the final tribunal. Submit your scored confession and await Divine Judgment: mercy through INVOKE, ruin through ABANDON.\nREQUIRES AN ACTIVE SCHEME (started via ${START_TOOL_NAME}).\nIf doubtful, continue penance through ${DRIVE_TOOL_NAME}.\n\nFlow: ${START_TOOL_NAME} → [${DRIVE_TOOL_NAME} x N] → ${CLOSE_TOOL_NAME}',
             args: {
-                intent: "REQUIRED. INVOKE crowns the masterpiece; DROP casts it into the abyss.\nREQUIRES AN ACTIVE SCHEME (started via ${START_TOOL_NAME}).\nIf doubtful, continue via ${DRIVE_TOOL_NAME}.",
-                criteriaChecks: "REQUIRED. Proof of mastery for INVOKE, or explicit confession for DROP.",
-                metPrecise: "Judgment flag: true when the strike lands in the intended layer.",
-                metMinimal: "Judgment flag: true when no needless machinery was introduced.",
-                metIsolated: "Judgment flag: true when unrelated chaos stayed out of the diff.",
-                metIdiomatic: "Judgment flag: true when the code sounds native to this domain.",
-                metCohesive: "Judgment flag: true when each unit owns one clear responsibility.",
-                oath: "Architect's covenant. Required for INVOKE. Verbatim: ${OATH_TEXT}",
-                cwd: "Optional lair path (repository root). Defaults to current command chamber.",
+                petition: 'REQUIRED. INVOKE pleads for ascension; ABANDON confesses failure.\nREQUIRES AN ACTIVE SCHEME (started via ${START_TOOL_NAME}).\nIf scores are low, continue via ${DRIVE_TOOL_NAME}.',
+                criteriaChecks: 'REQUIRED. Proof of mastery for INVOKE, or explicit confession for ABANDON.',
+                score_precise: 'REQUIRED score (0-5). 5 means the strike landed in the ordained layer.',
+                score_minimal: 'REQUIRED score (0-5). 5 means no needless machinery was summoned.',
+                score_isolated: 'REQUIRED score (0-5). 5 means unrelated chaos stayed outside the diff.',
+                score_idiomatic: 'REQUIRED score (0-5). 5 means the code speaks native doctrine.',
+                score_cohesive: 'REQUIRED score (0-5). 5 means each unit bears one sacred duty.',
+                oath: "Architect's sacred confession. Required for INVOKE. Verbatim: ${OATH_TEXT}",
+                cwd: 'Optional lair path (repository root). Defaults to current command chamber.',
             },
         },
         help: {
-            name: "help",
-            title: "Nani?!",
-            description: "Recalling the fundamental laws of this realm. Stay sharp, Architect.",
+            name: 'help',
+            title: 'Nani?!',
+            description: 'Recalling the fundamental laws of this realm. Stay sharp, Architect.',
             args: {
-                question: "REQUIRED. The law or protocol detail you want the realm to explain.",
+                question: 'REQUIRED. The law or protocol detail you want the realm to explain.',
             },
         },
     },
 };
 export function resolveTermPreset() {
     const raw = process.env.KEIYAKU_TERM_PRESET?.trim().toLowerCase();
-    if (!raw || raw === "default") {
+    if (!raw || raw === 'default') {
         return DEFAULT_PRESET;
     }
-    if (raw === "pokemon") {
+    if (raw === 'pokemon') {
         return POKEMON_PRESET;
     }
-    if (raw === "mischief") {
+    if (raw === 'mischief') {
         return MISCHIEF_PRESET;
     }
     throw new Error(`Unsupported KEIYAKU_TERM_PRESET '${raw}'. Expected 'default', 'pokemon', or 'mischief'.`);
@@ -226,7 +321,7 @@ export function listTermPresets() {
     return [DEFAULT_PRESET, POKEMON_PRESET, MISCHIEF_PRESET];
 }
 function extractPresetAvailableNames(preset) {
-    return preset.availableNames?.map((value) => value.trim()).filter((value) => value.length > 0) ?? [];
+    return (preset.availableNames?.map((value) => value.trim()).filter((value) => value.length > 0) ?? []);
 }
 export function getAvailableNamesForPreset(preset = resolveTermPreset()) {
     const names = extractPresetAvailableNames(preset);

package/build/handlers/close.js

@@ -4,27 +4,27 @@ import { handleClose } from "../workflow/orchestrator.js";
 import { buildCloseDoneResponse, buildCloseDropResponse, buildToolErrorResponse, } from "../workflow/response-builders.js";
 import { classifyToolError } from "./shared.js";
 export function createCloseHandler(toolInfo) {
-    return async ({ intent, criteriaChecks, metPrecise, metMinimal, metIsolated, metIdiomatic, metCohesive, oath, cwd }, extra) => {
+    return async ({ petition, criteriaChecks, score_precise, score_minimal, score_isolated, score_idiomatic, score_cohesive, oath, cwd, }, extra) => {
         const workingDir = cwd || process.cwd();
         const criteriaCheckParts = criteriaChecks;
         try {
-            appendDebugLog(`tool close start intent=${intent} cwd=${workingDir} criteriaChecks=${criteriaCheckParts.length}`, {
+            appendDebugLog(`tool close start petition=${petition} cwd=${workingDir} criteriaChecks=${criteriaCheckParts.length}`, {
                 cwd: workingDir,
                 section: "script",
             });
             const outcome = await handleClose({
                 cwd: workingDir,
-                intent,
+                petition,
                 criteriaChecks: criteriaCheckParts,
-                metPrecise,
-                metMinimal,
-                metIsolated,
-                metIdiomatic,
-                metCohesive,
+                score_precise,
+                score_minimal,
+                score_isolated,
+                score_idiomatic,
+                score_cohesive,
                 oath,
                 signal: extra.signal,
             });
-            if (intent === "INVOKE") {
+            if (petition === "INVOKE") {
                 if (!("result" in outcome) || outcome.result !== "done") {
                     throw new Error("Unexpected INVOKE outcome shape");
                 }
@@ -35,30 +35,30 @@ export function createCloseHandler(toolInfo) {
                 });
                 return buildCloseDoneResponse(finalOutcome, {
                     criteriaChecks: criteriaCheckParts,
-                    metPrecise,
-                    metMinimal,
-                    metIsolated,
-                    metIdiomatic,
-                    metCohesive,
+                    score_precise,
+                    score_minimal,
+                    score_isolated,
+                    score_idiomatic,
+                    score_cohesive,
                     oath,
                     cwd: workingDir,
                 });
             }
             if (!("result" in outcome) || outcome.result !== "dropped") {
-                throw new Error("Unexpected DROP outcome shape");
+                throw new Error("Unexpected ABANDON outcome shape");
             }
             const finalOutcome = outcome;
-            appendDebugLog(`tool close DROP success branch=${finalOutcome.branch} base=${finalOutcome.baseBranch}`, {
+            appendDebugLog(`tool close ABANDON success branch=${finalOutcome.branch} base=${finalOutcome.baseBranch}`, {
                 cwd: workingDir,
                 section: "script",
             });
             return buildCloseDropResponse(finalOutcome, {
                 criteriaChecks: criteriaCheckParts,
-                metPrecise,
-                metMinimal,
-                metIsolated,
-                metIdiomatic,
-                metCohesive,
+                score_precise,
+                score_minimal,
+                score_isolated,
+                score_idiomatic,
+                score_cohesive,
                 oath,
                 cwd: workingDir,
             });
@@ -76,9 +76,9 @@ export function createCloseHandler(toolInfo) {
                 errorType,
                 errorCode,
                 inputEcho: [
-                    `Intent: ${intent}`,
+                    `Petition: ${petition}`,
                     `Criteria checks (${criteriaCheckParts.length}): ${criteriaCheckParts.join("; ")}`,
-                    `Quality flags: metPrecise=${metPrecise} metMinimal=${metMinimal} metIsolated=${metIsolated} metIdiomatic=${metIdiomatic} metCohesive=${metCohesive}`,
+                    `Scores: precise=${score_precise} minimal=${score_minimal} isolated=${score_isolated} idiomatic=${score_idiomatic} cohesive=${score_cohesive}`,
                     ...(oath ? [`Oath: ${oath}`] : []),
                     `CWD: ${workingDir}`,
                 ],