muonroi-cli 1.6.6 → 1.7.0

package/dist/src/gsd/directives.js

@@ -1,154 +0,0 @@
-/**
- * src/gsd/directives.ts
- *
- * Builds the system-prompt directive block injected by layer4-gsd. The directive
- * is what actually changes the agent's behaviour: it lists the GSD-style steps
- * the agent must take before touching code.
- *
- * Three tiers:
- *   - heavy:    full discuss → research → verify → plan → impl → verify flow,
- *               with mandatory AskUserQuestion + parallel Agent dispatch.
- *   - standard: GSD-quick mindset — short plan, then implement, then verify.
- *   - quick:    minimal hint, run inline.
- *
- * All directive text is English. The agent is responsible for translating
- * user-facing prompts into the user's language at render time.
- */
-const HEADER = "[gsd-native]";
-/**
- * High-precision predicate: is this turn about the Muonroi ECOSYSTEM (where the
- * muonroi-docs MCP is the right source), as opposed to muonroi-cli internals?
- * Deliberately TIGHTER than smart-filter's hasEcosystemSignal — that one keeps
- * the server (over-keeping costs only tokens), but a behavioural "call docs
- * FIRST" nudge must not fire on every "muonroi" mention or it misdirects
- * CLI-internals questions toward .NET package docs. EN + VI.
- */
-const ECOSYSTEM_SCOPE_RE = /\becosystem\b|hệ\s*sinh\s*thái|he\s*sinh\s*thai|building[-\s]?block|open[-\s]?core|rule\s*engine|decision\s*table|\bnuget\b/i;
-export function mentionsEcosystemScope(message) {
-    return ECOSYSTEM_SCOPE_RE.test(message);
-}
-/**
- * Appended to any directive when the turn is ecosystem-scoped. Phrased
- * conditionally ("if … available") so it is harmless when muonroi-docs is not
- * configured — the model simply finds no such tool and falls back to local files.
- */
-export const ECOSYSTEM_DOCS_NUDGE = [
-    `${HEADER} ECOSYSTEM SCOPE — this turn concerns the Muonroi ecosystem (platform overview, BB/.NET packages, building-block, open-core boundary, setup).`,
-    "If the muonroi-docs MCP is available, it is the AUTHORITATIVE source — call it FIRST (docs_search / setup_guide / bb_recipe_list / bb_package_describe), THEN ground with local files. Do NOT characterize the ecosystem from local repo files alone.",
-].join("\n");
-/**
- * Appended to any directive when the user's reply language is non-English.
- * The base system prompt's "reply in user's language" rule normally suffices,
- * but `concise` / `FIX-FIRST` / GSD-debug directive bodies stack on top of it
- * with strong "be terse / code over prose" language that crowds the rule out
- * — observed live (storyflow_ui 22661c8de9f2). This NUDGE re-anchors the rule
- * inside the directive itself so brevity preferences cannot override it.
- */
-export function buildLanguageNudge(lang) {
-    return [
-        `${HEADER} LANGUAGE — the user wrote in ${lang}. Reply in ${lang}.`,
-        "This rule OVERRIDES any brevity / concise / code-over-prose directive: terseness is fine, but the response language stays the user's.",
-    ].join("\n");
-}
-function renderGrayAreas(qs) {
-    if (qs.length === 0)
-        return "  (no gray areas detected — confirm the request is fully specified before proceeding)";
-    return qs
-        .map((q, idx) => {
-        const opts = q.options.map((o, i) => `${i === 0 ? "[recommended]" : "[alt]"} ${o}`).join(" / ");
-        return `  ${idx + 1}. (${q.dimension}) ${q.question}\n     options: ${opts}`;
-    })
-        .join("\n");
-}
-function buildHeavy(input) {
-    const grayBlock = renderGrayAreas(input.grayAreas);
-    return [
-        `${HEADER} HEAVY task detected (score=${input.complexity.score}, signals=${input.complexity.signals.map((s) => s.tag).join(",") || "none"}).`,
-        "MANDATORY flow before any implementation:",
-        "  1. DISCUSS — call AskUserQuestion with the gray areas below. Each question MUST include the recommended default first so the user can accept by selecting it.",
-        "     Localize question text into the user's language (the language of their last message). Keep options labels English unless they refer to natural-language content.",
-        "  2. RESEARCH + VERIFY — once the user answers, dispatch two Agent calls IN PARALLEL in a single message:",
-        "       (a) a research agent to gather codebase / external facts needed for the task,",
-        "       (b) a verify agent to enumerate acceptance criteria and risks.",
-        "     Wait for both before planning.",
-        "  3. PLAN — produce a short numbered plan grounded in the research + verify outputs. Confirm the plan with the user only if it diverges from their stated intent.",
-        "  4. IMPLEMENT — execute the plan in atomic steps. Prefer parallel Agent dispatch when steps are independent.",
-        "  5. VERIFY — run tests / lints / type checks. Report evidence (command + exit code) before claiming done.",
-        "Gray areas to clarify in step 1:",
-        grayBlock,
-        "Do NOT skip steps. Do NOT begin implementation until step 1 is answered.",
-    ].join("\n");
-}
-function buildStandard(input) {
-    const phaseHint = input.phase ? ` (detected phase: ${input.phase})` : "";
-    // Debug-phase variant: tighten exploration budget. Session 7d56a049e1e3
-    // ran 109 tool calls (58 bash + 33 read_file + 16 grep + 2 mcp) over 6
-    // minutes WITHOUT a single edit_file / write_file — agent over-researched
-    // the CI failure instead of attempting a fix. Add an explicit exploration
-    // cap and require committing to a hypothesis early.
-    if (input.phase === "debug") {
-        return [
-            `${HEADER} DEBUG task${phaseHint} — apply GSD-quick mindset, FIX-FIRST.`,
-            "Flow:",
-            "  1. State a 2-3 line hypothesis (what is failing, your best guess of why) BEFORE reading more than 3 files.",
-            "  2. Apply the smallest plausible fix with edit_file / write_file. Do NOT keep exploring — commit to a hypothesis, ship the diff, iterate on failure.",
-            "  3. Verify the fix (rerun the failing command / test) and report evidence.",
-            "Hard limits — exceed only if a tool result genuinely contradicts your hypothesis:",
-            "  - ≤ 8 read_file calls before first edit_file",
-            "  - ≤ 5 grep calls before first edit_file",
-            "  - ≤ 10 bash log-fetching calls (gh run view, cat log, etc.) before first edit_file",
-            "If hard limits are blown and you still have no fix, STOP and report what you tried + why you're stuck. Do NOT keep searching.",
-        ].join("\n");
-    }
-    return [
-        `${HEADER} STANDARD task${phaseHint} — apply GSD-quick mindset.`,
-        "Flow:",
-        "  1. State a 2-3 line plan in your reply.",
-        "  2. Implement directly with the appropriate tools.",
-        "  3. Verify (tests / type-check / quick smoke) and report evidence.",
-        "Skip the discuss/research subagent dance unless a real ambiguity blocks step 1.",
-    ].join("\n");
-}
-function buildQuestion() {
-    // Informational / question / meta-analysis turns. The deliverable is the
-    // answer itself — there is no code to implement or test. Keep the agent's
-    // process OUT of the reply: a human asked, a human reads the result.
-    return [
-        `${HEADER} QUESTION / explanatory request — no code change is being asked for.`,
-        "Answer it directly and completely, written for the HUMAN who asked:",
-        "  1. Investigate only as needed — read/grep the specific files that ground your answer this turn.",
-        "  2. Lead with the answer. Use clear prose + structure (headings, bullets). Where a claim rests on the code, cite a concise file:line inline.",
-        "  3. Do NOT output an implementation plan, do NOT narrate your own process or restate these instructions, and do NOT name internal layers / contract rules / tools as if the reader were the agent.",
-        "There is no implement/verify step — the answer is the deliverable.",
-    ].join("\n");
-}
-function buildQuick(input) {
-    const phaseHint = input.phase ? ` phase=${input.phase}` : "";
-    return `${HEADER} QUICK task${phaseHint} — handle inline. No plan, no subagents. Make the smallest correct change and report.`;
-}
-export function buildDirective(input) {
-    // Informational/meta prompts answer a human — never apply the
-    // implement/verify scaffold (it agent-ifies the reply), regardless of tier.
-    const base = input.informational
-        ? { text: buildQuestion(), tier: input.complexity.tier, blocking: false }
-        : input.complexity.tier === "heavy"
-            ? { text: buildHeavy(input), tier: "heavy", blocking: true }
-            : input.complexity.tier === "standard"
-                ? { text: buildStandard(input), tier: "standard", blocking: false }
-                : { text: buildQuick(input), tier: "quick", blocking: false };
-    // Ecosystem-scoped turns get a docs-first nudge regardless of tier (question
-    // OR task): muonroi-docs is the authoritative source and must not be skipped
-    // in favour of guessing from local files (session 41ccfeb2ceee turn 1).
-    let text = base.text;
-    if (input.ecosystem) {
-        text = `${text}\n${ECOSYSTEM_DOCS_NUDGE}`;
-    }
-    // Language nudge: re-anchor the "reply in user's language" rule INSIDE the
-    // directive when the user wrote in a non-English language, so layered
-    // brevity/concise directives can't drown it (storyflow_ui 22661c8de9f2).
-    if (input.replyLanguage) {
-        text = `${text}\n${buildLanguageNudge(input.replyLanguage)}`;
-    }
-    return { ...base, text };
-}
-//# sourceMappingURL=directives.js.map