@xcompiler/cli 0.2.3 → 0.2.4

package/dist/cli/xcompiler_build.js

@@ -21,7 +21,7 @@ import { Command } from "commander";
 
 // src/runtime/build.ts
 import path13 from "path";
-import { promises as fs11 } from "fs";
+import { promises as fs12 } from "fs";
 
 // src/config/config.ts
 import { promises as fs } from "fs";
@@ -128,6 +128,7 @@ var PYTHON_EXECUTOR_SYSTEM = `You are XCompiler's Step Executor. You may only in
 Every round you must return strict JSON:
 {
   "thoughts": "<one sentence describing this round's intent>",
+  "issueResolutionPlan": "<required only in DEBUG issue mode: concise root cause, repair target, and validation plan>",
   "actions": [ { "tool": "<tool name>", "args": { ... } }, ... ],
   "done": true | false
 }
@@ -212,6 +213,7 @@ var TYPESCRIPT_EXECUTOR_SYSTEM = `You are XCompiler's Step Executor. You may onl
 Every round you must return strict JSON:
 {
   "thoughts": "<one sentence describing this round's intent>",
+  "issueResolutionPlan": "<required only in DEBUG issue mode: concise root cause, repair target, and validation plan>",
   "actions": [ { "tool": "<tool name>", "args": { ... } }, ... ],
   "done": true | false
 }
@@ -235,7 +237,7 @@ Rules:
 7. package.json is the dependency manifest. Use add_dependency for npm packages; never write requirements.txt.
 8. run_program runs the project entry with \`npx tsx\`, run_tests runs Vitest via \`npm test\`, and the final delivery gate also verifies the direct Node entry command.`;
 var PLANNER_CLARIFY_SYSTEM = `You are the requirements analyst for XCompiler's V-model. Do not restate the topic; expose unresolved decisions that would change functional design, acceptance, or architecture boundaries.
-Return strict JSON only. Each question must be directly answerable by a product owner, cover one decision, and avoid vague catch-all or implementation-stack questions.`;
+Return strict JSON only. Each question must be directly answerable by a product owner and cover one decision. Avoid vague catch-all or implementation-stack questions, except for the single development-language question when the user prompt explicitly requires it.`;
 function buildPlannerSystem(profile) {
   return (profile.id === "typescript" ? TYPESCRIPT_PLANNER_SYSTEM : PYTHON_PLANNER_SYSTEM) + profile.plannerPromptOverride;
 }
@@ -327,13 +329,13 @@ var messages = {
     preflightOllamaUnreachable: (baseUrl, message) => `preflight: ollama ${baseUrl} unreachable: ${message}`,
     preflightAutoAdded: (providers, roles) => `preflight: auto-added ${providers} provider(s) for roles [${roles}]`,
     scoreFileHeader: "# XCompiler LLM provider score snapshot (maintained automatically by ScoreStore; do not edit)",
-    scoreFileSemantics: "# Scores: default 1.0; automatic range 0.1-1.0; providers tagged cluster default to 0.2-0.5 unless llm.cluster_score_min/max widens it; failure -0.5; success +0.1; only user-configured score=0 disables a provider."
+    scoreFileSemantics: "# Scores: dynamic snapshot; default 1.0; automatic range 0.1-1.0; providers tagged cluster default to 0.2-0.5 unless llm.cluster_score_min/max widens it; failure -0.5; success +0.1. Put user overrides in llm_scores_user.yaml; 0 disables a provider."
   },
   system: {
     configEnvMissing: (names) => `[xcompiler] unset config environment variables were replaced with empty strings: ${names}`,
     unhandledError: (message) => `Unhandled error: ${message}`,
     unsupportedPypiOnlyNetwork: "network=pypi-only is rejected because Docker cannot enforce a PyPI-only allowlist by itself. Use network=off for isolation or network=download-only for explicitly unrestricted outbound downloads.",
-    dockerInsideContainerUnsupported: "XCompiler is running inside a container, so sandbox=docker is unsupported because Docker-outside-of-Docker can mis-map bind mounts and docker.sock permissions. Use agent.sandbox=subprocess, run XCompiler on the host, or set XC_IN_CONTAINER=0 only in a controlled environment.",
+    dockerInsideContainerUnsupported: "XCompiler is running inside a container, so sandbox mode docker is unsupported because Docker-outside-of-Docker can mis-map bind mounts and docker.sock permissions. Use agent.sandboxes.<language>.mode=subprocess, run XCompiler on the host, or set XC_IN_CONTAINER=0 only in a controlled environment.",
     firejailUnsupported: "sandbox=firejail is not implemented; use subprocess or docker.",
     smokeHeader: (baseUrl) => `Smoke test against ${baseUrl} (streaming)`,
     smokeOk: (model, totalMs, firstTokenMs, chunks, preview) => `[OK total=${totalMs}ms first-token=${firstTokenMs}ms chunks=${chunks}] ${model} -> ${preview}`,
@@ -350,8 +352,8 @@ var messages = {
     loaded: (plugin, version) => `Plugin ${plugin}@${version} loaded.`,
     extensionConflict: (plugin, kind, name) => `Plugin ${plugin} cannot replace existing ${kind} "${name}".`,
     hookFailed: (plugin, stage, message) => `Plugin ${plugin} failed during ${stage}: ${message}`,
-    manifestReadFailed: (path30, message) => `Cannot read plugin manifest ${path30}: ${message}`,
-    moduleLoadFailed: (plugin, path30, message) => `Cannot load plugin ${plugin} from ${path30}: ${message}`,
+    manifestReadFailed: (path31, message) => `Cannot read plugin manifest ${path31}: ${message}`,
+    moduleLoadFailed: (plugin, path31, message) => `Cannot load plugin ${plugin} from ${path31}: ${message}`,
     exportInvalid: (plugin, exportName) => `Plugin ${plugin} export ${exportName} is not a valid XCompiler plugin`,
     manifestMismatch: (plugin) => `Plugin ${plugin} runtime manifest does not match its preflight manifest`
   },
@@ -439,6 +441,7 @@ var messages = {
     optIntent: "plan intent: greenfield | feature | refactor | self",
     optBaselinePlan: "existing baseline phasePlan.json / plan.json path (default <workspace>/phasePlan.json)",
     optProjectFile: "XXX.xc project file path (default <workspace>/<name>.xc)",
+    optDebugWikiPath: "debug wiki root directory path (default <XCompiler path>/.xcompiler/debug-wiki)",
     argPlan: "phasePlan.json or legacy plan.json path (default = <workspace>/phasePlan.json)",
     argProjectFile: "XXX.xc project file",
     argStepId: "Step ID, e.g. S001",
@@ -653,7 +656,7 @@ var messages = {
     deliveryGateReason: (command, exitCode, timedOut) => `FUNCTIONAL_TEST gate: \`${command}\` exit=${exitCode}${timedOut ? " (timeout)" : ""}`,
     missingPythonEntrypoint: "missing Python entrypoint: expected src/main.py, src/<package>/__main__.py, or an explicit CLI file such as src/cli.py",
     missingTypeScriptEntrypoint: "missing TypeScript entrypoint: expected package.json start/bin or one of src/main.ts, src/index.ts, src/main.tsx",
-    invalidPythonEntrypointSource: (path30) => `invalid Python entrypoint source in ${path30}: expected a real CLI entry structure such as def main(...), argparse.ArgumentParser, or if __name__ == "__main__"; placeholder/import-only files are not runnable applications.`,
+    invalidPythonEntrypointSource: (path31) => `invalid Python entrypoint source in ${path31}: expected a real CLI entry structure such as def main(...), argparse.ArgumentParser, or if __name__ == "__main__"; placeholder/import-only files are not runnable applications.`,
     entrypointHelpOutputMissing: (command) => `entrypoint probe \`${command}\` exited 0 but produced no meaningful help/usage text; implement --help instead of relying on an empty script exit.`,
     reasonLine: (reason) => `reason: ${reason}`,
     roundsLine: (rounds) => `rounds: ${rounds}`,
@@ -722,12 +725,13 @@ Question mix (functionality first):
 - Label options sequentially from A through the last generated option, for example A-B, A-C, A-D, or A-E. A should be the recommended/default setting when one is apparent. Options must be concrete business/product settings, not vague placeholders.
 - Do not include \u201COther\u201D, \u201CCustom\u201D, or \u201CLet the user decide\u201D as an option. The CLI already allows the user to reply with one of the shown labels or enter a custom free-form answer.
 ${opts.projectShapeAmbiguous ? "- Required for this topic: ask the API library vs runnable application vs mixed-deliverable boundary explicitly.\n" : ""}
+${opts.languageAmbiguous ? "- Required for this topic: include exactly one boundary question confirming the target development language. Options must be A. Python (default/recommended) and B. TypeScript / Node.js. The user may still answer with custom free-form text.\n" : ""}
 
-[Hard constraint] The implementation stack is already fixed by XCompiler config / the existing project baseline. Do not reopen language/runtime/package-manager decisions.
+${opts.languageAmbiguous ? `[Stack decision] XCompiler could not infer the target language from the topic or baseline. Ask only the development-language question described above; do not ask package manager, test framework, or OS questions. If the user does not choose, Python is the default.` : `[Hard constraint] The implementation stack is already fixed by the user's topic or existing project baseline. Do not reopen language/runtime/package-manager decisions.
 **Do NOT** ask questions of these forms:
   - "Which programming language / framework / runtime should this use?"
   - "Which test framework / build tool / package manager?"
-  - "Which OS is the target platform?"
+  - "Which OS is the target platform?"`}
 ${opts.intent && opts.intent !== "greenfield" ? `This is an incremental ${opts.intent} request against an existing project${opts.hasBaseline ? " with a separate baseline summary that will be provided during decomposition" : ""}. Ask ONLY delta questions; do not ask to rebuild the project from scratch.` : ""}The majority of questions must concern functional behaviour; performance, boundaries, and extensibility should eliminate ambiguities that affect this delivery.`,
     plannerDecompose: (raw, qa, addenda, opts = {}) => `Original requirement:
 """
@@ -829,7 +833,7 @@ Return strict JSON StepPlan for the current phase only.`,
     executorDebugBlock: (reason, suggestions) => `
 
 You are now in DEBUG retry mode. Previous failure reason: ${reason}
-DEBUG may edit upstream source files and tests within the current allowedWrites. If the failure reveals a real implementation, contract, or downstream integration mismatch, fix that real defect; do not pass by weakening assertions, skipping tests, deleting failing cases, or merely accommodating an incorrect test. If this rollback is in a design/requirements step and the concrete code change belongs to a later V-model step outside the current allowedWrites, update the current contract, test plan, or diagnostic artifact and finish this step so the later CODE step can implement it; do not attempt denied writes. If the failure is a missing third-party dependency or wrong library choice, use add_dependency with the real package name or change the source back to the real library selected by HIGH_LEVEL_DESIGN; never add try/except ImportError fake modules, fake classes/functions, empty implementations, or fallback mocks in production src/ code to bypass the error. Begin with read_file / code_search to localise the issue, then make the smallest possible fix via apply_patch / replace_in_file / add_dependency, and finally run_tests to verify. A DEBUG retry cannot be marked complete from read-only inspection alone: it must produce a successful repair action or a successful verification command in this retry. If the previous failure reason mentions repeated read-only/probe actions, use the existing failure log as sufficient context and make the next action a patch/write/dependency change or a verification command. When a test executes and fails an assertion about returned behaviour, do not repeatedly rewrite fixtures or samples. Only edit fixtures when the evidence is missing-file, malformed-fixture, or parse-error in the fixture itself; otherwise patch the implementation, interface contract, dependency choice, or test expectation that is actually wrong. If the failure log shows a network/API failure, do not stop at probing endpoints: use at most two consecutive http_fetch probes, reject 2xx responses with empty or unusable bodies, then patch the real integration and verify with run_program plus run_tests. Do not set done=true while the entrypoint still reports a network/API failure.` + (suggestions ? `
+When this retry is handling an issue, every JSON response must include issueResolutionPlan before or while fixing it. The plan must be concise and actionable: root cause hypothesis, files/contracts to change, validation command or gate, and what would disprove the plan. DEBUG may edit upstream source files and tests within the current allowedWrites. If the failure reveals a real implementation, contract, or downstream integration mismatch, fix that real defect; do not pass by weakening assertions, skipping tests, deleting failing cases, or merely accommodating an incorrect test. If this rollback is in a design/requirements step and the concrete code change belongs to a later V-model step outside the current allowedWrites, update the current contract, test plan, or diagnostic artifact and finish this step so the later CODE step can implement it; do not attempt denied writes. If the failure is a missing third-party dependency or wrong library choice, use add_dependency with the real package name or change the source back to the real library selected by HIGH_LEVEL_DESIGN; never add try/except ImportError fake modules, fake classes/functions, empty implementations, or fallback mocks in production src/ code to bypass the error. Begin with read_file / code_search to localise the issue, then make the smallest possible fix via apply_patch / replace_in_file / add_dependency, and finally run_tests to verify. A DEBUG retry cannot be marked complete from read-only inspection alone: it must produce a successful repair action or a successful verification command in this retry. If the previous failure reason mentions repeated read-only/probe actions, use the existing failure log as sufficient context and make the next action a patch/write/dependency change or a verification command. When a test executes and fails an assertion about returned behaviour, do not repeatedly rewrite fixtures or samples. Only edit fixtures when the evidence is missing-file, malformed-fixture, or parse-error in the fixture itself; otherwise patch the implementation, interface contract, dependency choice, or test expectation that is actually wrong. If the failure log shows a network/API failure, do not stop at probing endpoints: use at most two consecutive http_fetch probes, reject 2xx responses with empty or unusable bodies, then patch the real integration and verify with run_program plus run_tests. Do not set done=true while the entrypoint still reports a network/API failure.` + (suggestions ? `
 
 ${suggestions}` : ""),
     executorGlobalBlock: (globalPrompt) => `
@@ -846,7 +850,8 @@ ${sp}`,
     executorFeedbackVerifyMissing: (paths) => `outputs still missing: ${paths}. Please continue.`,
     executorFeedbackReadOnlyLoopWarning: (rounds, targets) => `Loop guard warning: the last ${rounds} round(s) used only read/probe tools` + (targets ? ` (${targets})` : "") + ". Next response must include a successful repair action (apply_patch / replace_in_file / write_file / add_dependency) or a concrete verification action (run_tests / run_program). Do not continue with only read_file, list_dir, code_search, or http_fetch.",
     executorFeedbackReadOnlyRecoveryRequired: "Read-only recovery mode is active because the previous attempt already failed from probing. The next response must use existing failure evidence to patch/write/change dependency or run verification; one more read-only-only response will fail this retry.",
-    executorFeedbackRepairEvidenceMissing: "Invalid DEBUG completion: this retry has not produced repair evidence yet. Before done=true, perform at least one successful repair action or successful verification run; otherwise stop only with a concrete blocker in thoughts."
+    executorFeedbackRepairEvidenceMissing: "Invalid DEBUG completion: this retry has not produced repair evidence yet. Before done=true, perform at least one successful repair action or successful verification run; otherwise stop only with a concrete blocker in thoughts.",
+    executorFeedbackIssueResolutionPlanMissing: "Invalid DEBUG issue completion: issueResolutionPlan is required before the issue can be resolved. Return JSON with a concise handling plan plus the needed repair or verification actions."
   },
   skills: {
     patcher: "Use apply_patch / replace_in_file for small in-place edits to existing files; never overwrite a whole file.",
@@ -867,7 +872,7 @@ ${sp}`,
     summaryOk: "all checks passed.",
     summaryWarn: (n) => `passed with ${n} warning(s).`,
     summaryFail: (n) => `${n} failure(s) detected.`,
-    configLoadOk: (path30) => `config loaded: ${path30}`,
+    configLoadOk: (path31) => `config loaded: ${path31}`,
     configLoadFail: (msg) => `failed to load config: ${msg}`,
     configLocale: (locale) => `locale=${locale}`,
     llmNoProviders: "no LLM providers defined in config.llm.providers",
@@ -885,7 +890,7 @@ ${sp}`,
     roleOk: (role, provider) => `role "${role}" \u2192 ${provider}`,
     sandboxKind: (kind) => `sandbox=${kind}`,
     sandboxNetworkPolicy: (policy, ports) => `network=${policy}` + (ports.length ? ` (expose_ports=[${ports.join(", ")}])` : ""),
-    sandboxFullNoPorts: "network=full but no expose_ports configured \u2014 host-side cannot reach container services. Add `agent.sandbox_limits.expose_ports: [<port>]` in config.yaml.",
+    sandboxFullNoPorts: "network=full but no expose_ports configured \u2014 host-side cannot reach container services. Add `agent.sandboxes.<language>.<local|docker>.limits.expose_ports: [<port>]` in config.yaml.",
     sandboxNodeMissing: "node not found on PATH (required by TypeScript subprocess sandbox)",
     sandboxNodeOk: (version) => `node OK (${version})`,
     sandboxNpmMissing: "npm not found on PATH (required by TypeScript subprocess sandbox)",
@@ -1004,6 +1009,7 @@ var PYTHON_EXECUTOR_SYSTEM2 = `\u4F60\u662F XCompiler \u7684 Step Executor\u3002
 \u6BCF\u4E00\u8F6E\u4F60\u5FC5\u987B\u8FD4\u56DE\u4E25\u683C JSON\uFF1A
 {
   "thoughts": "<\u7528\u4E00\u53E5\u8BDD\u8BF4\u660E\u672C\u8F6E\u610F\u56FE>",
+  "issueResolutionPlan": "<\u4EC5 DEBUG issue \u6A21\u5F0F\u5FC5\u586B\uFF1A\u7B80\u660E\u8BF4\u660E\u6839\u56E0\u5047\u8BBE\u3001\u4FEE\u590D\u76EE\u6807\u548C\u9A8C\u8BC1\u65B9\u6848>",
   "actions": [ { "tool": "<\u5DE5\u5177\u540D>", "args": { ... } }, ... ],
   "done": true | false
 }
@@ -1087,6 +1093,7 @@ var TYPESCRIPT_EXECUTOR_SYSTEM2 = `\u4F60\u662F XCompiler \u7684 Step Executor\u
 \u6BCF\u4E00\u8F6E\u4F60\u5FC5\u987B\u8FD4\u56DE\u4E25\u683C JSON\uFF1A
 {
   "thoughts": "<\u7528\u4E00\u53E5\u8BDD\u8BF4\u660E\u672C\u8F6E\u610F\u56FE>",
+  "issueResolutionPlan": "<\u4EC5 DEBUG issue \u6A21\u5F0F\u5FC5\u586B\uFF1A\u7B80\u660E\u8BF4\u660E\u6839\u56E0\u5047\u8BBE\u3001\u4FEE\u590D\u76EE\u6807\u548C\u9A8C\u8BC1\u65B9\u6848>",
   "actions": [ { "tool": "<\u5DE5\u5177\u540D>", "args": { ... } }, ... ],
   "done": true | false
 }
@@ -1200,13 +1207,13 @@ var messages2 = {
     preflightOllamaUnreachable: (baseUrl, message) => `\u9884\u68C0\uFF1AOllama ${baseUrl} \u4E0D\u53EF\u8FBE\uFF1A${message}`,
     preflightAutoAdded: (providers, roles) => `\u9884\u68C0\uFF1A\u81EA\u52A8\u589E\u52A0 ${providers} \u4E2A provider\uFF0C\u8986\u76D6\u89D2\u8272 [${roles}]`,
     scoreFileHeader: "# XCompiler LLM provider \u8BC4\u5206\u5FEB\u7167\uFF08\u7531 ScoreStore \u81EA\u52A8\u7EF4\u62A4\uFF0C\u8BF7\u52FF\u624B\u5DE5\u7F16\u8F91\uFF09",
-    scoreFileSemantics: "# \u8BC4\u5206\u8BED\u4E49\uFF1A\u9ED8\u8BA4 1.0\uFF1B\u81EA\u52A8\u8BC4\u5206\u8303\u56F4 0.1\uFF5E1.0\uFF1Btags: [cluster] \u7684 provider \u9ED8\u8BA4 0.2\uFF5E0.5\uFF0C\u9664\u975E llm.cluster_score_min/max \u6269\u5BBD\uFF1B\u5931\u8D25 -0.5\uFF1B\u6210\u529F +0.1\uFF1B\u53EA\u6709\u7528\u6237\u914D\u7F6E score=0 \u8868\u793A\u7981\u7528\u3002"
+    scoreFileSemantics: "# \u8BC4\u5206\u8BED\u4E49\uFF1A\u8FD9\u662F\u52A8\u6001\u8BC4\u5206\u5FEB\u7167\uFF1B\u9ED8\u8BA4 1.0\uFF1B\u81EA\u52A8\u8BC4\u5206\u8303\u56F4 0.1\uFF5E1.0\uFF1Btags: [cluster] \u7684 provider \u9ED8\u8BA4 0.2\uFF5E0.5\uFF0C\u9664\u975E llm.cluster_score_min/max \u6269\u5BBD\uFF1B\u5931\u8D25 -0.5\uFF1B\u6210\u529F +0.1\u3002\u7528\u6237\u8986\u76D6\u8BF7\u5199 llm_scores_user.yaml\uFF0C0 \u8868\u793A\u7981\u7528\u3002"
   },
   system: {
     configEnvMissing: (names) => `[xcompiler] \u914D\u7F6E\u4E2D\u7684\u73AF\u5883\u53D8\u91CF\u672A\u8BBE\u7F6E\uFF0C\u5DF2\u66FF\u6362\u4E3A\u7A7A\u5B57\u7B26\u4E32\uFF1A${names}`,
     unhandledError: (message) => `\u672A\u5904\u7406\u9519\u8BEF\uFF1A${message}`,
     unsupportedPypiOnlyNetwork: "\u62D2\u7EDD network=pypi-only\uFF1ADocker \u672C\u8EAB\u65E0\u6CD5\u53EF\u9760\u6267\u884C\u201C\u4EC5 PyPI\u201D\u57DF\u540D\u767D\u540D\u5355\u3002\u9700\u8981\u9694\u79BB\u8BF7\u4F7F\u7528 network=off\uFF1B\u660E\u786E\u5141\u8BB8\u4EFB\u610F\u51FA\u7AD9\u4E0B\u8F7D\u65F6\u4F7F\u7528 network=download-only\u3002",
-    dockerInsideContainerUnsupported: "\u68C0\u6D4B\u5230 XCompiler \u8FD0\u884C\u5728\u5BB9\u5668\u5185\uFF0Csandbox=docker \u53EF\u80FD\u5BFC\u81F4 bind-mount \u8DEF\u5F84\u53CA docker.sock \u6743\u9650\u9519\u4F4D\uFF0C\u56E0\u6B64\u4E0D\u53D7\u652F\u6301\u3002\u8BF7\u4F7F\u7528 agent.sandbox=subprocess\u3001\u6539\u5728\u5BBF\u4E3B\u673A\u8FD0\u884C\uFF0C\u6216\u4EC5\u5728\u53D7\u63A7\u73AF\u5883\u8BBE\u7F6E XC_IN_CONTAINER=0\u3002",
+    dockerInsideContainerUnsupported: "\u68C0\u6D4B\u5230 XCompiler \u8FD0\u884C\u5728\u5BB9\u5668\u5185\uFF0Csandbox mode=docker \u53EF\u80FD\u5BFC\u81F4 bind-mount \u8DEF\u5F84\u53CA docker.sock \u6743\u9650\u9519\u4F4D\uFF0C\u56E0\u6B64\u4E0D\u53D7\u652F\u6301\u3002\u8BF7\u4F7F\u7528 agent.sandboxes.<language>.mode=subprocess\u3001\u6539\u5728\u5BBF\u4E3B\u673A\u8FD0\u884C\uFF0C\u6216\u4EC5\u5728\u53D7\u63A7\u73AF\u5883\u8BBE\u7F6E XC_IN_CONTAINER=0\u3002",
     firejailUnsupported: "\u5C1A\u672A\u5B9E\u73B0 sandbox=firejail\uFF0C\u8BF7\u4F7F\u7528 subprocess \u6216 docker\u3002",
     smokeHeader: (baseUrl) => `\u6B63\u5728\u5BF9 ${baseUrl} \u6267\u884C\u6D41\u5F0F\u5192\u70DF\u6D4B\u8BD5`,
     smokeOk: (model, totalMs, firstTokenMs, chunks, preview) => `[\u6210\u529F \u603B\u8017\u65F6=${totalMs}ms \u9996Token=${firstTokenMs}ms \u5206\u5757=${chunks}] ${model} -> ${preview}`,
@@ -1223,8 +1230,8 @@ var messages2 = {
     loaded: (plugin, version) => `\u63D2\u4EF6 ${plugin}@${version} \u5DF2\u52A0\u8F7D\u3002`,
     extensionConflict: (plugin, kind, name) => `\u63D2\u4EF6 ${plugin} \u4E0D\u80FD\u8986\u76D6\u5DF2\u6709 ${kind} \u201C${name}\u201D\u3002`,
     hookFailed: (plugin, stage, message) => `\u63D2\u4EF6 ${plugin} \u5728 ${stage} \u9636\u6BB5\u6267\u884C\u5931\u8D25\uFF1A${message}`,
-    manifestReadFailed: (path30, message) => `\u65E0\u6CD5\u8BFB\u53D6\u63D2\u4EF6\u6E05\u5355 ${path30}\uFF1A${message}`,
-    moduleLoadFailed: (plugin, path30, message) => `\u65E0\u6CD5\u4ECE ${path30} \u52A0\u8F7D\u63D2\u4EF6 ${plugin}\uFF1A${message}`,
+    manifestReadFailed: (path31, message) => `\u65E0\u6CD5\u8BFB\u53D6\u63D2\u4EF6\u6E05\u5355 ${path31}\uFF1A${message}`,
+    moduleLoadFailed: (plugin, path31, message) => `\u65E0\u6CD5\u4ECE ${path31} \u52A0\u8F7D\u63D2\u4EF6 ${plugin}\uFF1A${message}`,
     exportInvalid: (plugin, exportName) => `\u63D2\u4EF6 ${plugin} \u7684\u5BFC\u51FA ${exportName} \u4E0D\u662F\u6709\u6548 XCompiler \u63D2\u4EF6`,
     manifestMismatch: (plugin) => `\u63D2\u4EF6 ${plugin} \u7684\u8FD0\u884C\u65F6\u6E05\u5355\u4E0E\u9884\u68C0\u6E05\u5355\u4E0D\u4E00\u81F4`
   },
@@ -1312,6 +1319,7 @@ var messages2 = {
     optIntent: "\u8BA1\u5212\u610F\u56FE\uFF1Agreenfield | feature | refactor | self",
     optBaselinePlan: "\u5DF2\u6709\u57FA\u7EBF phasePlan.json / plan.json \u8DEF\u5F84\uFF08\u9ED8\u8BA4 <workspace>/phasePlan.json\uFF09",
     optProjectFile: "XXX.xc \u5DE5\u7A0B\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 <workspace>/<name>.xc\uFF09",
+    optDebugWikiPath: "debug wiki \u6839\u76EE\u5F55\u8DEF\u5F84\uFF08\u9ED8\u8BA4 <XCompiler path>/.xcompiler/debug-wiki\uFF09",
     argPlan: "phasePlan.json \u6216\u5386\u53F2 plan.json \u8DEF\u5F84\uFF08\u9ED8\u8BA4 = <workspace>/phasePlan.json\uFF09",
     argProjectFile: "XXX.xc \u5DE5\u7A0B\u6587\u4EF6",
     argStepId: "Step ID\uFF0C\u5982 S001",
@@ -1526,7 +1534,7 @@ var messages2 = {
     deliveryGateReason: (command, exitCode, timedOut) => `FUNCTIONAL_TEST \u95E8\u7981\uFF1A\`${command}\` \u9000\u51FA\u7801=${exitCode}${timedOut ? "\uFF08\u8D85\u65F6\uFF09" : ""}`,
     missingPythonEntrypoint: "\u7F3A\u5C11 Python \u5165\u53E3\uFF1A\u9700\u8981 src/main.py\u3001src/<package>/__main__.py\uFF0C\u6216 src/cli.py \u7B49\u663E\u5F0F CLI \u6587\u4EF6",
     missingTypeScriptEntrypoint: "\u7F3A\u5C11 TypeScript \u5165\u53E3\uFF1A\u9700\u8981 package.json start/bin \u6216 src/main.ts\u3001src/index.ts\u3001src/main.tsx \u4E4B\u4E00",
-    invalidPythonEntrypointSource: (path30) => `Python \u5165\u53E3\u6E90\u7801\u65E0\u6548\uFF1A${path30} \u5FC5\u987B\u662F\u771F\u5B9E CLI \u5165\u53E3\uFF0C\u81F3\u5C11\u5305\u542B def main(...)\u3001argparse.ArgumentParser \u6216 if __name__ == "__main__" \u8FD9\u7C7B\u5165\u53E3\u7ED3\u6784\uFF1B\u4EC5 import/comment \u7684\u5360\u4F4D\u6587\u4EF6\u4E0D\u80FD\u7B97\u53EF\u8FD0\u884C\u5E94\u7528\u3002`,
+    invalidPythonEntrypointSource: (path31) => `Python \u5165\u53E3\u6E90\u7801\u65E0\u6548\uFF1A${path31} \u5FC5\u987B\u662F\u771F\u5B9E CLI \u5165\u53E3\uFF0C\u81F3\u5C11\u5305\u542B def main(...)\u3001argparse.ArgumentParser \u6216 if __name__ == "__main__" \u8FD9\u7C7B\u5165\u53E3\u7ED3\u6784\uFF1B\u4EC5 import/comment \u7684\u5360\u4F4D\u6587\u4EF6\u4E0D\u80FD\u7B97\u53EF\u8FD0\u884C\u5E94\u7528\u3002`,
     entrypointHelpOutputMissing: (command) => `\u5165\u53E3\u63A2\u6D4B \`${command}\` \u867D\u7136\u9000\u51FA\u7801\u4E3A 0\uFF0C\u4F46\u6CA1\u6709\u8F93\u51FA\u6709\u610F\u4E49\u7684 help/usage \u6587\u672C\uFF1B\u5FC5\u987B\u5B9E\u73B0 --help\uFF0C\u4E0D\u80FD\u9760\u7A7A\u811A\u672C\u81EA\u7136\u9000\u51FA\u8FC7\u5173\u3002`,
     reasonLine: (reason) => `\u539F\u56E0\uFF1A${reason}`,
     roundsLine: (rounds) => `\u8F6E\u6B21\uFF1A${rounds}`,
@@ -1571,7 +1579,7 @@ var messages2 = {
 - \u6BCF\u4E2A CODE/\u6D4B\u8BD5\u4EA7\u7269\u5FC5\u987B\u4E25\u683C\u9650\u5B9A\u5728\u672C\u6B21\u589E\u91CF\u8303\u56F4\uFF0C\u7981\u6B62\u6574\u4F53\u91CD\u5EFA\u6216\u66FF\u6362\u4ED3\u5E93\u3002
 - \u5C06\u7A33\u5B9A\u5BBF\u4E3B\u89C6\u4E3A N \u4EE3\u3001\u9694\u79BB worktree \u4E2D\u7684\u5019\u9009\u7248\u672C\u89C6\u4E3A N+1 \u4EE3\uFF1B\u7981\u6B62\u8BBE\u8BA1\u8FDB\u7A0B\u5185\u70ED\u66FF\u6362\u3002`,
     plannerClarifySystem: `\u4F60\u662F XCompiler V \u6A21\u578B\u7684\u9700\u6C42\u5206\u6790\u5E08\u3002\u4F60\u7684\u804C\u8D23\u4E0D\u662F\u590D\u8FF0 topic\uFF0C\u800C\u662F\u53D1\u73B0\u4F1A\u6539\u53D8\u529F\u80FD\u8BBE\u8BA1\u3001\u9A8C\u6536\u7ED3\u679C\u6216\u67B6\u6784\u8FB9\u754C\u7684\u672A\u51B3\u4E8B\u9879\u3002
-\u53EA\u8FD4\u56DE\u4E25\u683C JSON\u3002\u95EE\u9898\u5FC5\u987B\u53EF\u7531\u4E1A\u52A1\u65B9\u76F4\u63A5\u4F5C\u7B54\u3001\u4E00\u6B21\u53EA\u786E\u8BA4\u4E00\u4E2A\u51B3\u7B56\uFF0C\u907F\u514D\u7A7A\u6CDB\u7684\u201C\u8FD8\u6709\u4EC0\u4E48\u8981\u6C42\u201D\u6216\u6280\u672F\u6808\u9009\u578B\u95EE\u9898\u3002`,
+\u53EA\u8FD4\u56DE\u4E25\u683C JSON\u3002\u95EE\u9898\u5FC5\u987B\u53EF\u7531\u4E1A\u52A1\u65B9\u76F4\u63A5\u4F5C\u7B54\u3001\u4E00\u6B21\u53EA\u786E\u8BA4\u4E00\u4E2A\u51B3\u7B56\uFF0C\u907F\u514D\u7A7A\u6CDB\u7684\u201C\u8FD8\u6709\u4EC0\u4E48\u8981\u6C42\u201D\u6216\u6280\u672F\u6808\u9009\u578B\u95EE\u9898\uFF1B\u53EA\u6709\u7528\u6237\u63D0\u793A\u660E\u786E\u8981\u6C42\u65F6\uFF0C\u624D\u5141\u8BB8\u63D0\u51FA\u552F\u4E00\u4E00\u6761\u5F00\u53D1\u8BED\u8A00\u786E\u8BA4\u95EE\u9898\u3002`,
     plannerClarify: (raw, opts = {}) => `\u7528\u6237\u7684\u539F\u59CB\u9700\u6C42\u5982\u4E0B\uFF1A
 
 """
@@ -1596,12 +1604,13 @@ ${raw}
 - \u9009\u9879\u4ECE A \u5F00\u59CB\u8FDE\u7EED\u6807\u53F7\uFF0C\u5230\u5B9E\u9645\u6700\u540E\u4E00\u4E2A\u9009\u9879\u7ED3\u675F\uFF0C\u4F8B\u5982 A-B\u3001A-C\u3001A-D \u6216 A-E\uFF1B\u5982\u679C\u80FD\u5224\u65AD\u63A8\u8350/\u9ED8\u8BA4\u65B9\u6848\uFF0CA \u5E94\u662F\u6700\u9AD8\u4F18\u5148\u7EA7\u65B9\u6848\u3002\u9009\u9879\u5FC5\u987B\u662F\u5177\u4F53\u4E1A\u52A1/\u4EA7\u54C1\u8BBE\u5B9A\uFF0C\u4E0D\u8981\u5199\u6210\u7A7A\u6CDB\u5360\u4F4D\u3002
 - \u4E0D\u8981\u628A\u201C\u5176\u4ED6 / \u81EA\u5B9A\u4E49 / \u7528\u6237\u51B3\u5B9A\u201D\u4F5C\u4E3A\u9009\u9879\uFF1BCLI \u5DF2\u652F\u6301\u7528\u6237\u8F93\u5165\u5DF2\u5C55\u793A\u7684\u9009\u9879\u5B57\u6BCD\u6216\u76F4\u63A5\u8F93\u5165\u81EA\u5B9A\u4E49\u56DE\u7B54\u5185\u5BB9\u3002
 ${opts.projectShapeAmbiguous ? "- \u672C topic \u5FC5\u95EE\uFF1A\u660E\u786E\u786E\u8BA4 API library / \u53EF\u8FD0\u884C\u5E94\u7528 / mixed \u4EA4\u4ED8\u8FB9\u754C\u3002\n" : ""}
+${opts.languageAmbiguous ? "- \u672C topic \u5FC5\u95EE\uFF1A\u5FC5\u987B\u5305\u542B\u4E14\u53EA\u5305\u542B 1 \u4E2A boundary \u95EE\u9898\u786E\u8BA4\u76EE\u6807\u5F00\u53D1\u8BED\u8A00\u3002\u9009\u9879\u5FC5\u987B\u662F A. Python\uFF08\u9ED8\u8BA4/\u63A8\u8350\uFF09 \u548C B. TypeScript / Node.js\uFF1B\u7528\u6237\u4ECD\u53EF\u8F93\u5165\u81EA\u5B9A\u4E49\u56DE\u7B54\u3002\n" : ""}
 
-\u3010\u786C\u7EA6\u675F\u3011\u5B9E\u73B0\u6280\u672F\u6808\u5DF2\u7ECF\u7531 XCompiler \u914D\u7F6E / \u73B0\u6709\u5DE5\u7A0B\u57FA\u7EBF\u56FA\u5B9A\uFF0C\u4E0D\u8981\u91CD\u65B0\u8BE2\u95EE\u8BED\u8A00\u3001\u8FD0\u884C\u65F6\u3001\u5305\u7BA1\u7406\u5668\u8FD9\u7C7B\u95EE\u9898\u3002
+${opts.languageAmbiguous ? `\u3010\u6280\u672F\u6808\u786E\u8BA4\u3011XCompiler \u65E0\u6CD5\u4ECE topic \u6216\u57FA\u7EBF\u4E2D\u5224\u65AD\u76EE\u6807\u5F00\u53D1\u8BED\u8A00\u3002\u53EA\u8BE2\u95EE\u4E0A\u9762\u8981\u6C42\u7684\u5F00\u53D1\u8BED\u8A00\u95EE\u9898\uFF1B\u4E0D\u8981\u8BE2\u95EE\u5305\u7BA1\u7406\u5668\u3001\u6D4B\u8BD5\u6846\u67B6\u6216\u64CD\u4F5C\u7CFB\u7EDF\u3002\u82E5\u7528\u6237\u4E0D\u9009\u62E9\uFF0C\u9ED8\u8BA4 Python\u3002` : `\u3010\u786C\u7EA6\u675F\u3011\u5B9E\u73B0\u6280\u672F\u6808\u5DF2\u7ECF\u7531\u7528\u6237 topic / \u73B0\u6709\u5DE5\u7A0B\u57FA\u7EBF\u56FA\u5B9A\uFF0C\u4E0D\u8981\u91CD\u65B0\u8BE2\u95EE\u8BED\u8A00\u3001\u8FD0\u884C\u65F6\u3001\u5305\u7BA1\u7406\u5668\u8FD9\u7C7B\u95EE\u9898\u3002
 **\u4E25\u7981**\u63D0\u51FA\u4EE5\u4E0B\u7C7B\u578B\u7684\u95EE\u9898\uFF1A
   - "\u5E0C\u671B\u7528\u4EC0\u4E48\u7F16\u7A0B\u8BED\u8A00 / \u6846\u67B6 / \u8FD0\u884C\u65F6\u5B9E\u73B0\uFF1F"
   - "\u9700\u8981\u54EA\u79CD\u6D4B\u8BD5\u6846\u67B6 / \u6784\u5EFA\u5DE5\u5177 / \u5305\u7BA1\u7406\u5668\uFF1F"
-  - "\u76EE\u6807\u5E73\u53F0\u662F\u54EA\u79CD\u64CD\u4F5C\u7CFB\u7EDF\uFF1F"
+  - "\u76EE\u6807\u5E73\u53F0\u662F\u54EA\u79CD\u64CD\u4F5C\u7CFB\u7EDF\uFF1F"`}
 ${opts.intent && opts.intent !== "greenfield" ? `\u8FD9\u662F\u4E00\u6761\u9488\u5BF9\u73B0\u6709\u5DE5\u7A0B\u7684\u589E\u91CF ${opts.intent} \u8BF7\u6C42${opts.hasBaseline ? "\uFF1B\u5206\u89E3\u9636\u6BB5\u8FD8\u4F1A\u63D0\u4F9B\u4E00\u4EFD\u57FA\u7EBF\u6458\u8981" : ""}\u3002\u8BF7\u53EA\u95EE\u201C\u53D8\u66F4\u589E\u91CF\u201D\u76F8\u5173\u95EE\u9898\uFF0C\u4E0D\u8981\u628A\u9879\u76EE\u5F53\u6210\u4ECE\u96F6\u5F00\u59CB\u91CD\u505A\u3002` : ""}\u95EE\u9898\u4E3B\u4F53\u5FC5\u987B\u805A\u7126\u529F\u80FD\u884C\u4E3A\uFF1B\u6027\u80FD\u3001\u8FB9\u754C\u548C\u6269\u5C55\u6027\u7528\u4E8E\u6D88\u9664\u4F1A\u5F71\u54CD\u672C\u671F\u8BBE\u8BA1\u7684\u5173\u952E\u6B67\u4E49\u3002`,
     plannerDecompose: (raw, qa, addenda, opts = {}) => `\u539F\u59CB\u9700\u6C42\uFF1A
 """
@@ -1703,7 +1712,7 @@ ${opts.phasePlan}
     executorDebugBlock: (reason, suggestions) => `
 
 \u6B63\u5904\u4E8E DEBUG \u91CD\u8BD5\u6A21\u5F0F\u3002\u4E0A\u4E00\u8F6E\u5931\u8D25\u539F\u56E0: ${reason}
-DEBUG \u53EF\u4EE5\u4FEE\u6539\u5F53\u524D allowedWrites \u5185\u7684\u4E0A\u6E38\u6E90\u7801\u4E0E\u6D4B\u8BD5\u6587\u4EF6\uFF1B\u82E5\u5931\u8D25\u66B4\u9732\u7684\u662F\u5B9E\u73B0\u3001\u5951\u7EA6\u6216\u4E0B\u6E38\u8C03\u7528\u4E0D\u4E00\u81F4\uFF0C\u5FC5\u987B\u4FEE\u771F\u5B9E\u7F3A\u9677\uFF0C\u7981\u6B62\u901A\u8FC7\u524A\u5F31\u65AD\u8A00\u3001\u8DF3\u8FC7\u6D4B\u8BD5\u3001\u5220\u9664\u5931\u8D25\u7528\u4F8B\u6216\u53EA\u8FCE\u5408\u9519\u8BEF\u6D4B\u8BD5\u6765\u8FC7\u5173\u3002\u5982\u679C\u672C\u6B21\u56DE\u9000\u5904\u4E8E\u9700\u6C42/\u8BBE\u8BA1\u9636\u6BB5\uFF0C\u800C\u5177\u4F53\u6E90\u7801\u4FEE\u6539\u5C5E\u4E8E\u540E\u7EED V \u6A21\u578B Step \u4E14\u76EE\u6807\u6587\u4EF6\u4E0D\u5728\u5F53\u524D allowedWrites \u5185\uFF0C\u5E94\u66F4\u65B0\u5F53\u524D\u5951\u7EA6\u3001\u6D4B\u8BD5\u8BA1\u5212\u6216\u8BCA\u65AD\u4EA7\u7269\u5E76\u5B8C\u6210\u5F53\u524D Step\uFF0C\u8BA9\u540E\u7EED CODE Step \u5B9E\u73B0\uFF1B\u4E0D\u8981\u5C1D\u8BD5\u88AB\u62D2\u7EDD\u7684\u8D8A\u6743\u5199\u5165\u3002\u82E5\u5931\u8D25\u662F\u7B2C\u4E09\u65B9\u4F9D\u8D56\u7F3A\u5931\u6216\u5E93\u9009\u578B\u9519\u8BEF\uFF0C\u5FC5\u987B\u7528 add_dependency \u5199\u5165\u771F\u5B9E\u5305\u540D\uFF0C\u6216\u628A\u6E90\u7801\u6539\u56DE HIGH_LEVEL_DESIGN \u9009\u5B9A\u7684\u771F\u5B9E\u5E93\uFF1B\u4E25\u7981\u5728 src/ \u751F\u4EA7\u4EE3\u7801\u91CC try/except ImportError \u540E\u4F2A\u9020 module\u3001fake class/function\u3001\u7A7A\u5B9E\u73B0\u6216 fallback mock \u6765\u7ED5\u8FC7\u9519\u8BEF\u3002\u8BF7\u5305\u542B read_file/code_search \u5148\u5B9A\u4F4D\u95EE\u9898\uFF0C\u518D\u4EE5 apply_patch / replace_in_file / add_dependency \u4F5C\u6700\u5C0F\u4FEE\u6539\uFF0C\u6700\u540E run_tests \u9A8C\u8BC1\u3002DEBUG \u91CD\u8BD5\u4E0D\u80FD\u53EA\u9760\u53EA\u8BFB\u68C0\u67E5\u5C31\u6807\u8BB0\u5B8C\u6210\uFF1A\u672C\u6B21\u91CD\u8BD5\u5FC5\u987B\u4EA7\u751F\u4E00\u6B21\u6210\u529F\u7684\u4FEE\u590D\u52A8\u4F5C\uFF0C\u6216\u4E00\u6B21\u6210\u529F\u7684\u9A8C\u8BC1\u547D\u4EE4\u3002\u5982\u679C\u4E0A\u4E00\u8F6E\u5931\u8D25\u539F\u56E0\u5305\u542B repeated read-only/probe actions\uFF0C\u8BF7\u628A\u5DF2\u6709 failure log \u89C6\u4E3A\u8DB3\u591F\u4E0A\u4E0B\u6587\uFF0C\u4E0B\u4E00\u6B65\u76F4\u63A5 patch/write/\u6539\u4F9D\u8D56\u6216\u6267\u884C\u9A8C\u8BC1\u547D\u4EE4\u3002\u5F53\u6D4B\u8BD5\u5DF2\u6B63\u5E38\u6267\u884C\u4F46\u5931\u8D25\u70B9\u662F\u8FD4\u56DE\u884C\u4E3A\u65AD\u8A00\u65F6\uFF0C\u7981\u6B62\u53CD\u590D\u91CD\u5199 fixture \u6216\u6837\u4F8B\u3002\u53EA\u6709\u8BC1\u636E\u660E\u786E\u662F\u6587\u4EF6\u7F3A\u5931\u3001fixture \u683C\u5F0F\u9519\u8BEF\u6216 fixture \u672C\u8EAB\u89E3\u6790\u5931\u8D25\u65F6\u624D\u4FEE\u6539 fixture\uFF1B\u5426\u5219\u5E94\u4FEE\u5B9E\u73B0\u3001\u63A5\u53E3\u5951\u7EA6\u3001\u4F9D\u8D56\u9009\u578B\u6216\u786E\u5B9E\u9519\u8BEF\u7684\u65AD\u8A00\u3002\u5982\u679C\u5931\u8D25\u65E5\u5FD7\u663E\u793A\u7F51\u7EDC/API \u8C03\u7528\u5931\u8D25\uFF0C\u4E0D\u5141\u8BB8\u53EA\u505C\u7559\u5728\u63A2\u6D4B\u63A5\u53E3\uFF1A\u6700\u591A\u8FDE\u7EED\u6267\u884C 2 \u6B21 http_fetch \u63A2\u6D4B\uFF1BHTTP 2xx \u4F46 body \u4E3A\u7A7A\u6216\u683C\u5F0F\u4E0D\u53EF\u7528\u4E0D\u7B97\u53EF\u7528\u63A5\u53E3\uFF1B\u968F\u540E\u5FC5\u987B patch \u771F\u5B9E\u96C6\u6210\u4EE3\u7801\uFF0C\u5E76\u7528 run_program \u548C run_tests \u9A8C\u8BC1\u3002\u5165\u53E3\u4ECD\u8F93\u51FA\u7F51\u7EDC/API \u5931\u8D25\u65F6\u4E0D\u5F97 done=true\u3002` + (suggestions ? `
+\u5F53\u672C\u6B21 DEBUG \u6B63\u5728\u5904\u7406 issue \u65F6\uFF0C\u6BCF\u4E00\u8F6E JSON \u90FD\u5FC5\u987B\u5728\u4FEE\u590D\u524D\u6216\u4FEE\u590D\u8FC7\u7A0B\u4E2D\u989D\u5916\u5305\u542B issueResolutionPlan\u3002\u8BE5\u65B9\u6848\u5FC5\u987B\u7B80\u6D01\u4E14\u53EF\u6267\u884C\uFF1A\u6839\u56E0\u5047\u8BBE\u3001\u8981\u4FEE\u6539\u7684\u6587\u4EF6/\u5951\u7EA6\u3001\u9A8C\u8BC1\u547D\u4EE4\u6216\u95E8\u7981\uFF0C\u4EE5\u53CA\u4EC0\u4E48\u8BC1\u636E\u4F1A\u63A8\u7FFB\u8BE5\u65B9\u6848\u3002DEBUG \u53EF\u4EE5\u4FEE\u6539\u5F53\u524D allowedWrites \u5185\u7684\u4E0A\u6E38\u6E90\u7801\u4E0E\u6D4B\u8BD5\u6587\u4EF6\uFF1B\u82E5\u5931\u8D25\u66B4\u9732\u7684\u662F\u5B9E\u73B0\u3001\u5951\u7EA6\u6216\u4E0B\u6E38\u8C03\u7528\u4E0D\u4E00\u81F4\uFF0C\u5FC5\u987B\u4FEE\u771F\u5B9E\u7F3A\u9677\uFF0C\u7981\u6B62\u901A\u8FC7\u524A\u5F31\u65AD\u8A00\u3001\u8DF3\u8FC7\u6D4B\u8BD5\u3001\u5220\u9664\u5931\u8D25\u7528\u4F8B\u6216\u53EA\u8FCE\u5408\u9519\u8BEF\u6D4B\u8BD5\u6765\u8FC7\u5173\u3002\u5982\u679C\u672C\u6B21\u56DE\u9000\u5904\u4E8E\u9700\u6C42/\u8BBE\u8BA1\u9636\u6BB5\uFF0C\u800C\u5177\u4F53\u6E90\u7801\u4FEE\u6539\u5C5E\u4E8E\u540E\u7EED V \u6A21\u578B Step \u4E14\u76EE\u6807\u6587\u4EF6\u4E0D\u5728\u5F53\u524D allowedWrites \u5185\uFF0C\u5E94\u66F4\u65B0\u5F53\u524D\u5951\u7EA6\u3001\u6D4B\u8BD5\u8BA1\u5212\u6216\u8BCA\u65AD\u4EA7\u7269\u5E76\u5B8C\u6210\u5F53\u524D Step\uFF0C\u8BA9\u540E\u7EED CODE Step \u5B9E\u73B0\uFF1B\u4E0D\u8981\u5C1D\u8BD5\u88AB\u62D2\u7EDD\u7684\u8D8A\u6743\u5199\u5165\u3002\u82E5\u5931\u8D25\u662F\u7B2C\u4E09\u65B9\u4F9D\u8D56\u7F3A\u5931\u6216\u5E93\u9009\u578B\u9519\u8BEF\uFF0C\u5FC5\u987B\u7528 add_dependency \u5199\u5165\u771F\u5B9E\u5305\u540D\uFF0C\u6216\u628A\u6E90\u7801\u6539\u56DE HIGH_LEVEL_DESIGN \u9009\u5B9A\u7684\u771F\u5B9E\u5E93\uFF1B\u4E25\u7981\u5728 src/ \u751F\u4EA7\u4EE3\u7801\u91CC try/except ImportError \u540E\u4F2A\u9020 module\u3001fake class/function\u3001\u7A7A\u5B9E\u73B0\u6216 fallback mock \u6765\u7ED5\u8FC7\u9519\u8BEF\u3002\u8BF7\u5305\u542B read_file/code_search \u5148\u5B9A\u4F4D\u95EE\u9898\uFF0C\u518D\u4EE5 apply_patch / replace_in_file / add_dependency \u4F5C\u6700\u5C0F\u4FEE\u6539\uFF0C\u6700\u540E run_tests \u9A8C\u8BC1\u3002DEBUG \u91CD\u8BD5\u4E0D\u80FD\u53EA\u9760\u53EA\u8BFB\u68C0\u67E5\u5C31\u6807\u8BB0\u5B8C\u6210\uFF1A\u672C\u6B21\u91CD\u8BD5\u5FC5\u987B\u4EA7\u751F\u4E00\u6B21\u6210\u529F\u7684\u4FEE\u590D\u52A8\u4F5C\uFF0C\u6216\u4E00\u6B21\u6210\u529F\u7684\u9A8C\u8BC1\u547D\u4EE4\u3002\u5982\u679C\u4E0A\u4E00\u8F6E\u5931\u8D25\u539F\u56E0\u5305\u542B repeated read-only/probe actions\uFF0C\u8BF7\u628A\u5DF2\u6709 failure log \u89C6\u4E3A\u8DB3\u591F\u4E0A\u4E0B\u6587\uFF0C\u4E0B\u4E00\u6B65\u76F4\u63A5 patch/write/\u6539\u4F9D\u8D56\u6216\u6267\u884C\u9A8C\u8BC1\u547D\u4EE4\u3002\u5F53\u6D4B\u8BD5\u5DF2\u6B63\u5E38\u6267\u884C\u4F46\u5931\u8D25\u70B9\u662F\u8FD4\u56DE\u884C\u4E3A\u65AD\u8A00\u65F6\uFF0C\u7981\u6B62\u53CD\u590D\u91CD\u5199 fixture \u6216\u6837\u4F8B\u3002\u53EA\u6709\u8BC1\u636E\u660E\u786E\u662F\u6587\u4EF6\u7F3A\u5931\u3001fixture \u683C\u5F0F\u9519\u8BEF\u6216 fixture \u672C\u8EAB\u89E3\u6790\u5931\u8D25\u65F6\u624D\u4FEE\u6539 fixture\uFF1B\u5426\u5219\u5E94\u4FEE\u5B9E\u73B0\u3001\u63A5\u53E3\u5951\u7EA6\u3001\u4F9D\u8D56\u9009\u578B\u6216\u786E\u5B9E\u9519\u8BEF\u7684\u65AD\u8A00\u3002\u5982\u679C\u5931\u8D25\u65E5\u5FD7\u663E\u793A\u7F51\u7EDC/API \u8C03\u7528\u5931\u8D25\uFF0C\u4E0D\u5141\u8BB8\u53EA\u505C\u7559\u5728\u63A2\u6D4B\u63A5\u53E3\uFF1A\u6700\u591A\u8FDE\u7EED\u6267\u884C 2 \u6B21 http_fetch \u63A2\u6D4B\uFF1BHTTP 2xx \u4F46 body \u4E3A\u7A7A\u6216\u683C\u5F0F\u4E0D\u53EF\u7528\u4E0D\u7B97\u53EF\u7528\u63A5\u53E3\uFF1B\u968F\u540E\u5FC5\u987B patch \u771F\u5B9E\u96C6\u6210\u4EE3\u7801\uFF0C\u5E76\u7528 run_program \u548C run_tests \u9A8C\u8BC1\u3002\u5165\u53E3\u4ECD\u8F93\u51FA\u7F51\u7EDC/API \u5931\u8D25\u65F6\u4E0D\u5F97 done=true\u3002` + (suggestions ? `
 
 ${suggestions}` : ""),
     executorGlobalBlock: (globalPrompt) => `
@@ -1720,7 +1729,8 @@ ${sp}`,
     executorFeedbackVerifyMissing: (paths) => `outputs \u4ECD\u7F3A\u5931\uFF1A${paths}\u3002\u8BF7\u7EE7\u7EED\u3002`,
     executorFeedbackReadOnlyLoopWarning: (rounds, targets) => `\u5FAA\u73AF\u95E8\u7981\u8B66\u544A\uFF1A\u6700\u8FD1 ${rounds} \u8F6E\u53EA\u8C03\u7528\u4E86\u8BFB\u53D6/\u63A2\u6D4B\u5DE5\u5177` + (targets ? `\uFF08${targets}\uFF09` : "") + "\u3002\u4E0B\u4E00\u8F6E\u5FC5\u987B\u5305\u542B\u4E00\u6B21\u6210\u529F\u7684\u4FEE\u590D\u52A8\u4F5C\uFF08apply_patch / replace_in_file / write_file / add_dependency\uFF09\u6216\u660E\u786E\u7684\u9A8C\u8BC1\u52A8\u4F5C\uFF08run_tests / run_program\uFF09\u3002\u4E0D\u8981\u7EE7\u7EED\u53EA\u8C03\u7528 read_file\u3001list_dir\u3001code_search \u6216 http_fetch\u3002",
     executorFeedbackReadOnlyRecoveryRequired: "\u53EA\u8BFB\u6062\u590D\u6A21\u5F0F\u5DF2\u542F\u7528\uFF1A\u4E0A\u4E00\u8F6E\u5DF2\u7ECF\u56E0\u4E3A\u6301\u7EED\u63A2\u6D4B\u5931\u8D25\u3002\u672C\u8F6E\u5FC5\u987B\u57FA\u4E8E\u5DF2\u6709 failure log \u76F4\u63A5 patch/write/\u6539\u4F9D\u8D56\u6216\u6267\u884C\u9A8C\u8BC1\uFF1B\u5982\u679C\u4E0B\u4E00\u8F6E\u4ECD\u7136\u53EA\u6709\u53EA\u8BFB/\u63A2\u6D4B\u52A8\u4F5C\uFF0C\u672C\u6B21\u91CD\u8BD5\u4F1A\u5931\u8D25\u5E76\u56DE\u9000\u3002",
-    executorFeedbackRepairEvidenceMissing: "DEBUG \u5B8C\u6210\u65E0\u6548\uFF1A\u672C\u6B21\u91CD\u8BD5\u8FD8\u6CA1\u6709\u4EA7\u751F\u4FEE\u590D\u8BC1\u636E\u3002\u8BBE\u7F6E done=true \u524D\uFF0C\u5FC5\u987B\u81F3\u5C11\u5B8C\u6210\u4E00\u6B21\u6210\u529F\u7684\u4FEE\u590D\u52A8\u4F5C\u6216\u6210\u529F\u7684\u9A8C\u8BC1\u8FD0\u884C\uFF1B\u5426\u5219\u53EA\u80FD\u5728 thoughts \u4E2D\u7ED9\u51FA\u5177\u4F53 blocker \u540E\u505C\u6B62\u3002"
+    executorFeedbackRepairEvidenceMissing: "DEBUG \u5B8C\u6210\u65E0\u6548\uFF1A\u672C\u6B21\u91CD\u8BD5\u8FD8\u6CA1\u6709\u4EA7\u751F\u4FEE\u590D\u8BC1\u636E\u3002\u8BBE\u7F6E done=true \u524D\uFF0C\u5FC5\u987B\u81F3\u5C11\u5B8C\u6210\u4E00\u6B21\u6210\u529F\u7684\u4FEE\u590D\u52A8\u4F5C\u6216\u6210\u529F\u7684\u9A8C\u8BC1\u8FD0\u884C\uFF1B\u5426\u5219\u53EA\u80FD\u5728 thoughts \u4E2D\u7ED9\u51FA\u5177\u4F53 blocker \u540E\u505C\u6B62\u3002",
+    executorFeedbackIssueResolutionPlanMissing: "DEBUG issue \u5B8C\u6210\u65E0\u6548\uFF1AissueResolutionPlan \u662F issue resolved \u7684\u5FC5\u8981\u5B57\u6BB5\u3002\u8BF7\u8FD4\u56DE\u5305\u542B\u7B80\u660E\u5904\u7406\u65B9\u6848\u7684 JSON\uFF0C\u5E76\u540C\u65F6\u7ED9\u51FA\u5FC5\u8981\u4FEE\u590D\u6216\u9A8C\u8BC1\u52A8\u4F5C\u3002"
   },
   skills: {
     patcher: "\u901A\u8FC7 apply_patch / replace_in_file \u5BF9\u5DF2\u6709\u6587\u4EF6\u505A\u5C0F\u6539\u52A8\uFF0C\u7981\u6B62\u6574\u6587\u4EF6\u8986\u76D6\u3002",
@@ -1741,7 +1751,7 @@ ${sp}`,
     summaryOk: "\u5168\u90E8\u68C0\u67E5\u901A\u8FC7\u3002",
     summaryWarn: (n) => `\u901A\u8FC7\uFF0C\u4F46\u6709 ${n} \u6761 warning\u3002`,
     summaryFail: (n) => `\u68C0\u6D4B\u5230 ${n} \u9879\u5931\u8D25\u3002`,
-    configLoadOk: (path30) => `\u914D\u7F6E\u5DF2\u52A0\u8F7D\uFF1A${path30}`,
+    configLoadOk: (path31) => `\u914D\u7F6E\u5DF2\u52A0\u8F7D\uFF1A${path31}`,
     configLoadFail: (msg) => `\u914D\u7F6E\u52A0\u8F7D\u5931\u8D25\uFF1A${msg}`,
     configLocale: (locale) => `locale=${locale}`,
     llmNoProviders: "config.llm.providers \u4E3A\u7A7A\uFF0C\u672A\u58F0\u660E\u4EFB\u4F55 provider",
@@ -1759,7 +1769,7 @@ ${sp}`,
     roleOk: (role, provider) => `\u89D2\u8272 "${role}" \u2192 ${provider}`,
     sandboxKind: (kind) => `sandbox=${kind}`,
     sandboxNetworkPolicy: (policy, ports) => `network=${policy}` + (ports.length ? `\uFF08expose_ports=[${ports.join(", ")}]\uFF09` : ""),
-    sandboxFullNoPorts: "network=full \u4F46\u672A\u914D\u7F6E expose_ports\u2014\u5BBF\u4E3B\u4FA7\u65E0\u6CD5\u8BBF\u95EE\u5BB9\u5668\u5185\u670D\u52A1\u3002\u8BF7\u5728 config.yaml \u4E2D\u8BBE\u7F6E `agent.sandbox_limits.expose_ports: [<port>]`\u3002",
+    sandboxFullNoPorts: "network=full \u4F46\u672A\u914D\u7F6E expose_ports\u2014\u5BBF\u4E3B\u4FA7\u65E0\u6CD5\u8BBF\u95EE\u5BB9\u5668\u5185\u670D\u52A1\u3002\u8BF7\u5728 config.yaml \u4E2D\u8BBE\u7F6E `agent.sandboxes.<language>.<local|docker>.limits.expose_ports: [<port>]`\u3002",
     sandboxNodeMissing: "PATH \u4E0A\u627E\u4E0D\u5230 node\uFF08TypeScript subprocess \u6C99\u76D2\u5FC5\u9700\uFF09",
     sandboxNodeOk: (version) => `node OK\uFF08${version}\uFF09`,
     sandboxNpmMissing: "PATH \u4E0A\u627E\u4E0D\u5230 npm\uFF08TypeScript subprocess \u6C99\u76D2\u5FC5\u9700\uFF09",
@@ -1858,6 +1868,73 @@ var ProviderSchema = z.object({
   think: z.boolean().optional()
 });
 var LocaleSchema = z.enum(["en", "zh"]);
+var TargetLanguageSchema = z.enum(["python", "typescript"]);
+var SandboxModeSchema = z.enum(["subprocess", "docker", "firejail"]);
+var SandboxLimitsSchema = z.object({
+  cpu: z.number().positive().default(1),
+  memory_mb: z.number().int().positive().default(1024),
+  wall_seconds: z.number().int().positive().default(60),
+  /**
+   * Sandbox network policy.
+   *  - `off`            — no network at all (`docker --network none`).
+   *  - `download-only`  — outbound traffic allowed, no inbound port publishing.
+   *  - `pypi-only`      — legacy value; rejected at sandbox creation rather than silently
+   *                       allowing unrestricted outbound traffic.
+   *  - `full`           — outbound + every port in `expose_ports` is published
+   *                       to `127.0.0.1` so host-side tests can reach the app.
+   */
+  network: z.enum(["off", "pypi-only", "download-only", "full"]).default("download-only"),
+  /** Container ports to publish to 127.0.0.1 when `network=full`. */
+  expose_ports: z.array(z.number().int().min(1).max(65535)).default([])
+}).default({
+  cpu: 1,
+  memory_mb: 1024,
+  wall_seconds: 60,
+  network: "download-only",
+  expose_ports: []
+});
+var LocalSandboxSchema = z.object({
+  sandbox_dir: z.string().min(1).optional(),
+  python_bin: z.string().min(1).optional(),
+  inherit_env: z.boolean().optional(),
+  limits: SandboxLimitsSchema
+}).default(() => ({ limits: defaultSandboxLimits() }));
+var DockerSandboxSchema = z.object({
+  image: z.string().default("python:3.11-slim"),
+  workdir: z.string().default("/workspace"),
+  pull: z.boolean().default(false),
+  docker_bin: z.string().default("docker"),
+  extra_run_args: z.array(z.string()).default([]),
+  sandbox_dir: z.string().min(1).optional(),
+  limits: SandboxLimitsSchema
+}).default({
+  image: "python:3.11-slim",
+  workdir: "/workspace",
+  pull: false,
+  docker_bin: "docker",
+  extra_run_args: [],
+  limits: defaultSandboxLimits()
+});
+var LanguageSandboxSchema = z.object({
+  mode: SandboxModeSchema.default("subprocess"),
+  local: LocalSandboxSchema,
+  docker: DockerSandboxSchema
+}).default(() => ({
+  mode: "subprocess",
+  local: { limits: defaultSandboxLimits() },
+  docker: {
+    image: "python:3.11-slim",
+    workdir: "/workspace",
+    pull: false,
+    docker_bin: "docker",
+    extra_run_args: [],
+    limits: defaultSandboxLimits()
+  }
+}));
+var SandboxesSchema = z.object({
+  python: LanguageSandboxSchema.optional(),
+  typescript: LanguageSandboxSchema.optional()
+}).default({});
 var LlmSchema = z.object({
   default: z.string(),
   providers: z.record(z.string(), ProviderSchema),
@@ -1865,7 +1942,7 @@ var LlmSchema = z.object({
    * 角色 → provider 数组的映射。
    * 兼容旧格式：单字符串 `Coder: ollama_code` 自动归一化为 `[ollama_code]`。
    * 数组形式 `Coder: [ollama_code, openai]` 表示该角色的候选 LLM 池；
-   * 实际选择顺序由 `llm.scores` 评分降序决定；用户显式设置评分=0 的 provider 直接跳过。
+   * 实际选择顺序由 ScoreStore 有效评分降序决定；有效评分为用户覆盖优先，否则使用动态评分。
    */
   roles: z.record(z.string(), z.union([z.string(), z.array(z.string())])).default({}).transform((obj) => {
     const out = {};
@@ -1879,9 +1956,8 @@ var LlmSchema = z.object({
   /** 可选：按角色指定 fallback 链（覆盖全局） */
   role_fallbacks: z.record(z.string(), z.array(z.string())).default({}),
   /**
-   * Provider 评分快照（启动时从 sidecar 文件加载，运行时由 ScoreStore 维护并自动落盘）。
-   * 配置文件里也可以手工设置初始值；不存在的 provider 默认评分 = 1。
-   * 用户手工设置评分 = 0 表示禁用；运行时自动评分只在 0.1～1.0 范围内调整。
+   * Provider 兼容初值。运行时动态评分由 ScoreStore 写入 llm_scores.yaml；
+   * 用户手动覆盖应写入 llm_scores_user.yaml。旧配置里显式 0 仍表示用户禁用。
    */
   scores: z.record(z.string(), z.number().min(0)).default({}),
   /**
@@ -1901,65 +1977,107 @@ var LlmSchema = z.object({
     });
   }
 });
+var AgentSchema = z.object({
+  /** @deprecated Target project language is inferred from topic/baseline. Kept for legacy configs only. */
+  language: TargetLanguageSchema.optional(),
+  max_steps: z.number().int().positive().default(50),
+  max_debug_retries: z.number().int().positive().default(3),
+  /** Debugger 滑动窗口的硬上限（默认 = max(max_debug_retries*4, 10)）。 */
+  max_debug_retries_cap: z.number().int().positive().optional(),
+  max_rounds_per_step: z.number().int().positive().default(6),
+  max_debug_rounds_per_step: z.number().int().positive().optional(),
+  max_edit_lines_per_step: z.union([z.literal("auto"), z.number().int().positive()]).default("auto"),
+  max_write_chunk_bytes: z.union([z.literal("auto"), z.number().int().positive()]).default("auto"),
+  /** @deprecated Use agent.sandboxes.<language>.mode. */
+  sandbox: SandboxModeSchema.optional(),
+  /** @deprecated Use agent.sandboxes.<language>.<local|docker>.limits. */
+  sandbox_limits: SandboxLimitsSchema.optional(),
+  /** @deprecated Use agent.sandboxes.<language>.docker. */
+  sandbox_docker: DockerSandboxSchema.optional(),
+  sandboxes: SandboxesSchema
+}).transform((agent) => {
+  const legacyLanguage = agent.language ?? "python";
+  const legacyMode = agent.sandbox ?? "subprocess";
+  const legacyLimits = agent.sandbox_limits ?? defaultSandboxLimits();
+  const defaults = {
+    python: defaultLanguageSandbox("python", legacyMode, legacyLimits),
+    typescript: defaultLanguageSandbox("typescript", legacyMode, legacyLimits)
+  };
+  const sandboxes = {
+    python: mergeLanguageSandbox(
+      defaults.python,
+      agent.sandboxes.python,
+      legacyLanguage === "python" ? agent.sandbox_docker : void 0
+    ),
+    typescript: mergeLanguageSandbox(
+      defaults.typescript,
+      agent.sandboxes.typescript,
+      legacyLanguage === "typescript" ? agent.sandbox_docker : void 0
+    )
+  };
+  return {
+    ...agent,
+    language: legacyLanguage,
+    sandbox: sandboxes.python.mode,
+    sandbox_limits: sandboxes.python.local.limits,
+    sandbox_docker: sandboxes.python.docker,
+    sandboxes
+  };
+});
 var ConfigSchema = z.object({
   /** CLI / prompt locale. Accepts 'en' (default) or 'zh'. */
   locale: LocaleSchema.optional(),
   /** @deprecated use `locale` instead. Kept as a backwards-compatible alias. */
   ui_language: LocaleSchema.optional(),
   llm: LlmSchema,
-  agent: z.object({
-    language: z.enum(["python", "typescript"]).default("python"),
-    max_steps: z.number().int().positive().default(50),
-    max_debug_retries: z.number().int().positive().default(3),
-    /** Debugger 滑动窗口的硬上限（默认 = max(max_debug_retries*4, 10)）。 */
-    max_debug_retries_cap: z.number().int().positive().optional(),
-    max_rounds_per_step: z.number().int().positive().default(6),
-    max_debug_rounds_per_step: z.number().int().positive().optional(),
-    max_edit_lines_per_step: z.union([z.literal("auto"), z.number().int().positive()]).default("auto"),
-    max_write_chunk_bytes: z.union([z.literal("auto"), z.number().int().positive()]).default("auto"),
-    sandbox: z.enum(["subprocess", "docker", "firejail"]).default("subprocess"),
-    sandbox_limits: z.object({
-      cpu: z.number().positive().default(1),
-      memory_mb: z.number().int().positive().default(1024),
-      wall_seconds: z.number().int().positive().default(60),
-      /**
-       * Sandbox network policy.
-       *  - `off`            — no network at all (`docker --network none`).
-       *  - `download-only`  — outbound traffic allowed, no inbound port publishing
-       *                       (default; lets python pip-install / fetch web pages).
-       *  - `pypi-only`      — legacy value; rejected at sandbox creation rather than silently
-       *                       allowing unrestricted outbound traffic.
-       *  - `full`           — outbound + every port in `expose_ports` is published
-       *                       to `127.0.0.1` so host-side tests can reach the app.
-       */
-      network: z.enum(["off", "pypi-only", "download-only", "full"]).default("download-only"),
-      /** Container ports to publish to 127.0.0.1 when `network=full`. */
-      expose_ports: z.array(z.number().int().min(1).max(65535)).default([])
-    }).default({
-      cpu: 1,
-      memory_mb: 1024,
-      wall_seconds: 60,
-      network: "download-only",
-      expose_ports: []
-    }),
-    sandbox_docker: z.object({
-      image: z.string().default("python:3.11-slim"),
-      workdir: z.string().default("/workspace"),
-      pull: z.boolean().default(false),
-      docker_bin: z.string().default("docker"),
-      extra_run_args: z.array(z.string()).default([])
-    }).default({
-      image: "python:3.11-slim",
-      workdir: "/workspace",
-      pull: false,
-      docker_bin: "docker",
-      extra_run_args: []
-    })
-  })
+  agent: AgentSchema
 }).transform(({ locale, ui_language, ...rest }) => ({
   locale: locale ?? ui_language ?? "en",
   ...rest
 }));
+function defaultSandboxLimits() {
+  return {
+    cpu: 1,
+    memory_mb: 1024,
+    wall_seconds: 60,
+    network: "download-only",
+    expose_ports: []
+  };
+}
+function defaultLanguageSandbox(language, mode, limits) {
+  return {
+    mode,
+    local: {
+      sandbox_dir: `.sandbox/${language}`,
+      limits: { ...limits, expose_ports: [...limits.expose_ports ?? []] }
+    },
+    docker: {
+      image: language === "typescript" ? "node:24-slim" : "python:3.11-slim",
+      workdir: "/workspace",
+      pull: false,
+      docker_bin: "docker",
+      extra_run_args: [],
+      sandbox_dir: `.sandbox/${language}`,
+      limits: { ...limits, expose_ports: [...limits.expose_ports ?? []] }
+    }
+  };
+}
+function mergeLanguageSandbox(defaults, override, legacyDocker) {
+  const dockerOverride = legacyDocker ?? override?.docker;
+  return {
+    mode: override?.mode ?? defaults.mode,
+    local: {
+      ...defaults.local,
+      ...override?.local ?? {},
+      limits: override?.local?.limits ?? defaults.local.limits
+    },
+    docker: {
+      ...defaults.docker,
+      ...dockerOverride ?? {},
+      limits: dockerOverride?.limits ?? defaults.docker.limits
+    }
+  };
+}
 function getXCompilerPath() {
   const env = xcEnv("PATH");
   if (env && env.trim()) return path.resolve(env.trim());
@@ -2023,6 +2141,11 @@ var LOOP_REPEATS = 12;
 var LOOP_MIN_LEN = 1500;
 var LOOP_MIN_WINDOW = 96;
 var LOOP_MAX_PERIOD = 256;
+var TEXT_LOOP_MIN_LEN = 6e3;
+var TEXT_LOOP_TAIL = 14e3;
+var TEXT_LOOP_SAMPLE_LEN = 48;
+var TEXT_LOOP_STRIDE = 8;
+var TEXT_LOOP_REPEATS = 5;
 function detectCyclicTokenLoop(aggregate) {
   if (aggregate.length < LOOP_MIN_LEN) return false;
   const maxPeriod = Math.min(LOOP_MAX_PERIOD, Math.floor(aggregate.length / LOOP_REPEATS));
@@ -2044,6 +2167,35 @@ function detectCyclicTokenLoop(aggregate) {
   }
   return false;
 }
+function detectRepeatedTextLoop(aggregate) {
+  if (aggregate.length < TEXT_LOOP_MIN_LEN) return false;
+  const tail = aggregate.slice(-TEXT_LOOP_TAIL).replace(/\s+/gu, " ").trim();
+  if (tail.length < TEXT_LOOP_MIN_LEN) return false;
+  const seen = /* @__PURE__ */ new Map();
+  for (let i = 0; i + TEXT_LOOP_SAMPLE_LEN <= tail.length; i += TEXT_LOOP_STRIDE) {
+    const sample = tail.slice(i, i + TEXT_LOOP_SAMPLE_LEN);
+    if (!isHighSignalLoopSample(sample)) continue;
+    const prior = seen.get(sample);
+    if (!prior) {
+      seen.set(sample, { count: 1, first: i, last: i });
+      continue;
+    }
+    const next = { count: prior.count + 1, first: prior.first, last: i };
+    seen.set(sample, next);
+    if (next.count >= TEXT_LOOP_REPEATS && next.last - next.first >= TEXT_LOOP_SAMPLE_LEN * 3) {
+      return true;
+    }
+  }
+  return false;
+}
+function isHighSignalLoopSample(sample) {
+  const chars = [...sample];
+  const signalChars = chars.filter((ch) => /[\p{L}\p{N}]/u.test(ch));
+  if (signalChars.length < 20) return false;
+  if (signalChars.length / Math.max(1, chars.length) < 0.4) return false;
+  const unique = new Set(signalChars.map((ch) => ch.toLowerCase())).size;
+  return unique >= 10;
+}
 var RepeatTokenDetector = class {
   constructor(threshold = 40) {
     this.threshold = threshold;
@@ -2222,6 +2374,12 @@ function streamPostNdjson(url, body, watchdog, onLine, shouldStopWhen) {
                   );
                   return;
                 }
+                if (detectRepeatedTextLoop(aggregate)) {
+                  fail(
+                    new Error("detected repeated text loop in stream (semantic tail repetition); aborting")
+                  );
+                  return;
+                }
               }
               if (obj.error) {
                 fail(new Error(`Ollama error: ${obj.error}`));
@@ -2250,6 +2408,10 @@ function streamPostNdjson(url, body, watchdog, onLine, shouldStopWhen) {
               fail(new Error("detected token loop in stream; aborting"));
               return;
             }
+            if (detectRepeatedTextLoop(aggregate)) {
+              fail(new Error("detected repeated text loop in stream; aborting"));
+              return;
+            }
           }
         });
         res.on("end", () => {
@@ -2520,6 +2682,9 @@ var OpenAIClient = class {
           if (detectCyclicTokenLoop(aggregate)) {
             throw new Error("detected cyclic token loop in OpenAI stream (periodic tail); aborting");
           }
+          if (detectRepeatedTextLoop(aggregate)) {
+            throw new Error("detected repeated text loop in OpenAI stream (semantic tail repetition); aborting");
+          }
           if (maxOutputChars > 0 && expectsJsonObject && aggregate.length > maxOutputChars && hasInvalidJsonPrefix(aggregate)) {
             throw new Error(`OpenAI stream exceeded ${maxOutputChars} chars without a valid JSON prefix; aborting`);
           }
@@ -3060,18 +3225,24 @@ import { promises as fs2 } from "fs";
 import path2 from "path";
 import YAML2 from "yaml";
 var CLUSTER_PROVIDER_TAG = "cluster";
+var LLM_DYNAMIC_SCORES_FILE = "llm_scores.yaml";
+var LLM_USER_SCORES_FILE = "llm_scores_user.yaml";
 var ScoreStore = class _ScoreStore {
   constructor(configPath, initial = {}, audit, opts = {}) {
     this.audit = audit;
-    this.sidecarPath = path2.join(path2.dirname(configPath), "llm_scores.yaml");
+    const configDir = path2.dirname(configPath);
+    this.sidecarPath = path2.join(configDir, LLM_DYNAMIC_SCORES_FILE);
+    this.userScoresPath = path2.join(configDir, LLM_USER_SCORES_FILE);
     this.clusterProviders = new Set(opts.clusterProviderNames ?? []);
     const bounds = normalizeClusterBounds(opts.clusterScoreMin, opts.clusterScoreMax);
     this.clusterMin = bounds.min;
     this.clusterMax = bounds.max;
     for (const [k, v] of Object.entries(initial)) {
-      const score = this.clampConfigured(k, v);
-      this.scores.set(k, score);
-      if (score === _ScoreStore.DISABLED) this.userDisabled.add(k);
+      if (v === _ScoreStore.DISABLED) {
+        this.userScores.set(k, _ScoreStore.DISABLED);
+      } else {
+        this.dynamicScores.set(k, this.clampDynamic(k, v));
+      }
     }
   }
   audit;
@@ -3083,24 +3254,28 @@ var ScoreStore = class _ScoreStore {
   static CLUSTER_MAX = 0.5;
   static DECAY = 0.5;
   static BOOST = 0.1;
-  scores = /* @__PURE__ */ new Map();
-  userDisabled = /* @__PURE__ */ new Set();
+  dynamicScores = /* @__PURE__ */ new Map();
+  userScores = /* @__PURE__ */ new Map();
   clusterProviders;
   clusterMin;
   clusterMax;
   dirty = false;
   writeQueue = Promise.resolve();
   sidecarPath;
-  /** 异步加载 sidecar 文件；失败/不存在不抛错，使用 ctor 提供的初值。 */
+  userScoresPath;
+  /** 异步加载动态 sidecar 与用户覆盖文件；失败/不存在不抛错，使用 ctor 提供的初值。 */
   async load() {
+    await this.loadDynamicScores();
+    await this.loadUserScores();
+  }
+  async loadDynamicScores() {
     try {
       const raw = await fs2.readFile(this.sidecarPath, "utf8");
       const parsed = YAML2.parse(raw);
       if (parsed && typeof parsed === "object") {
         for (const [k, v] of Object.entries(parsed)) {
           if (typeof v === "number" && Number.isFinite(v)) {
-            if (this.userDisabled.has(k)) continue;
-            this.scores.set(k, this.clampDynamic(k, v));
+            this.dynamicScores.set(k, this.clampPersistedDynamic(k, v));
           }
         }
       }
@@ -3113,44 +3288,73 @@ var ScoreStore = class _ScoreStore {
       }
     }
   }
+  async loadUserScores() {
+    try {
+      const raw = await fs2.readFile(this.userScoresPath, "utf8");
+      const parsed = YAML2.parse(raw);
+      if (parsed && typeof parsed === "object") {
+        for (const [k, v] of Object.entries(parsed)) {
+          if (typeof v === "number" && Number.isFinite(v)) {
+            this.userScores.set(k, this.clampUserScore(v));
+          }
+        }
+      }
+    } catch (err) {
+      if (err.code !== "ENOENT") {
+        await this.audit?.event("llm.error", t().llm.scoreReadFailed(this.userScoresPath, err.message), {
+          messageId: "llm.user_score_read_failed",
+          sidecarPath: this.userScoresPath
+        });
+      }
+    }
+  }
   get(name) {
-    return this.scores.has(name) ? this.scores.get(name) : this.defaultFor(name);
+    if (this.userScores.has(name)) return this.userScores.get(name);
+    return this.dynamicScores.has(name) ? this.dynamicScores.get(name) : this.defaultFor(name);
   }
-  /** 主动设置评分；value=0 仅用于显式禁用，其它值会归一到动态范围。 */
+  /** 主动设置动态评分；用户覆盖只从配置或 llm_scores_user.yaml 读取。 */
   set(name, value, reason) {
-    if (this.userDisabled.has(name) && value !== _ScoreStore.DISABLED) return;
     const v = value === _ScoreStore.DISABLED ? _ScoreStore.DISABLED : this.clampDynamic(name, value);
-    const prev = this.scores.get(name);
+    const prev = this.dynamicScores.get(name);
     if (prev === v) return;
-    this.scores.set(name, v);
+    this.dynamicScores.set(name, v);
     this.dirty = true;
-    void this.audit?.event("llm.score", t().llm.scoreChanged(name, v.toFixed(2), (prev ?? _ScoreStore.DEFAULT).toFixed(2)), {
+    void this.audit?.event("llm.score", t().llm.scoreChanged(name, v.toFixed(2), (prev ?? this.defaultFor(name)).toFixed(2)), {
       messageId: "llm.score_changed",
       provider: name,
       score: v,
-      previous: prev ?? _ScoreStore.DEFAULT,
+      previous: prev ?? this.defaultFor(name),
       reason: reason ?? "set"
     });
     this.scheduleSave();
   }
   decay(name, reason) {
-    if (this.get(name) === _ScoreStore.DISABLED) return;
-    this.set(name, Math.max(this.minFor(name), this.get(name) - _ScoreStore.DECAY), reason);
+    if (this.isUserDisabled(name)) return;
+    const cur = this.dynamicScore(name);
+    if (cur === _ScoreStore.DISABLED) return;
+    this.set(name, Math.max(this.minFor(name), cur - _ScoreStore.DECAY), reason);
   }
   boost(name, reason) {
-    const cur = this.get(name);
+    if (this.isUserDisabled(name)) return;
+    const cur = this.dynamicScore(name);
     if (cur === _ScoreStore.DISABLED) return;
     if (cur >= this.maxFor(name)) return;
     this.set(name, Math.min(this.maxFor(name), cur + _ScoreStore.BOOST), reason);
   }
-  /** True only for providers explicitly disabled by user config (`llm.scores.<provider>: 0`). */
+  /** True only for providers explicitly disabled by user config or llm_scores_user.yaml. */
   isUserDisabled(name) {
-    return this.userDisabled.has(name);
+    return this.userScores.get(name) === _ScoreStore.DISABLED;
   }
-  /** 全量快照（用于测试与 audit 输出）。 */
+  /** 动态评分快照（用于持久化、测试与 audit 输出；不包含用户覆盖）。 */
   snapshot() {
     const out = {};
-    for (const [k, v] of this.scores) out[k] = v;
+    for (const [k, v] of this.dynamicScores) out[k] = v;
+    return out;
+  }
+  /** 用户覆盖快照（用于测试/诊断；运行时不会改写用户文件）。 */
+  userSnapshot() {
+    const out = {};
+    for (const [k, v] of this.userScores) out[k] = v;
     return out;
   }
   /** 等待待写入完成（CLI 退出前调用，确保评分已落盘）。 */
@@ -3188,10 +3392,8 @@ ${t().llm.scoreFileSemantics}
   isClusterProvider(name) {
     return this.clusterProviders.has(name);
   }
-  clampConfigured(name, v) {
-    if (!Number.isFinite(v)) return this.defaultFor(name);
-    if (v === _ScoreStore.DISABLED) return _ScoreStore.DISABLED;
-    return this.clampDynamic(name, v);
+  dynamicScore(name) {
+    return this.dynamicScores.has(name) ? this.dynamicScores.get(name) : this.defaultFor(name);
   }
   clampDynamic(name, v) {
     if (!Number.isFinite(v)) return this.defaultFor(name);
@@ -3200,6 +3402,18 @@ ${t().llm.scoreFileSemantics}
     if (v > this.maxFor(name)) return this.maxFor(name);
     return v;
   }
+  clampPersistedDynamic(name, v) {
+    if (!Number.isFinite(v)) return this.defaultFor(name);
+    if (v === _ScoreStore.DISABLED) return _ScoreStore.DISABLED;
+    return this.clampDynamic(name, v);
+  }
+  clampUserScore(v) {
+    if (!Number.isFinite(v)) return _ScoreStore.DEFAULT;
+    if (v <= _ScoreStore.DISABLED) return _ScoreStore.DISABLED;
+    if (v < _ScoreStore.MIN) return _ScoreStore.MIN;
+    if (v > _ScoreStore.MAX) return _ScoreStore.MAX;
+    return v;
+  }
 };
 function normalizeClusterBounds(rawMin, rawMax) {
   const min = clampBound(rawMin ?? ScoreStore.CLUSTER_MIN);
@@ -3618,6 +3832,9 @@ var PlanSchema = z2.object({
   dependencies: dependencies ?? pythonRequirements ?? []
 }));
 
+// src/core/language.ts
+import { promises as fs5 } from "fs";
+
 // src/core/entry_gate.ts
 import path5 from "path";
 
@@ -3644,8 +3861,10 @@ function detectNetworkApiFailure(text) {
 function isTestAssertionDiagnosticLine(line) {
   const text = line.trim();
   if (!text) return false;
+  if (/^\d+\|\s/u.test(text)) return true;
   if (/^(?:[→>-]\s*)?expected\b/iu.test(text)) return true;
   if (/\bAssertionError\b/iu.test(text) && /\bexpected\b/iu.test(text)) return true;
+  if (/\bexpect\s*\(/u.test(text) && /\.(?:to|not)\w*\s*\(/u.test(text)) return true;
   return /\bexpected\b[\s\S]{0,240}\b(?:got|received|to\s+(?:be|equal|throw|contain|have|match))\b/iu.test(text);
 }
 function isTestRunnerStatusLine(line) {
@@ -3692,8 +3911,8 @@ async function autoFixSrcImports(ws, audit) {
   const candidates = [];
   if (await ws.exists("src/main.py")) candidates.push("src/main.py");
   try {
-    const fs27 = await import("fs/promises");
-    const entries = await fs27.readdir(ws.abs("src"), { withFileTypes: true });
+    const fs29 = await import("fs/promises");
+    const entries = await fs29.readdir(ws.abs("src"), { withFileTypes: true });
     for (const e of entries) {
       if (!e.isDirectory()) continue;
       const rel = `src/${e.name}/__main__.py`;
@@ -3844,8 +4063,8 @@ async function detectPythonEntrypoint(ws) {
   if (await ws.exists("src/main.py")) return fileCandidate("src/main.py");
   if (await ws.exists("src/__main__.py")) return fileCandidate("src/__main__.py");
   try {
-    const fs27 = await import("fs/promises");
-    const entries = await fs27.readdir(ws.abs("src"), { withFileTypes: true });
+    const fs29 = await import("fs/promises");
+    const entries = await fs29.readdir(ws.abs("src"), { withFileTypes: true });
     for (const e of entries) {
       if (!e.isDirectory()) continue;
       const rel = `src/${e.name}/__main__.py`;
@@ -3904,7 +4123,7 @@ var typescriptProfile = {
   manifestFile: "package.json",
   codeExtensions: [".ts", ".tsx"],
   seedManifestFromDeps: false,
-  defaultDockerImage: "node:20-slim",
+  defaultDockerImage: "node:24-slim",
   renderManifest(deps) {
     const pkg = {
       name: "app",
@@ -3933,6 +4152,9 @@ var typescriptProfile = {
   },
   plannerPromptOverride: "",
   executorPromptOverride: "",
+  async autoFixImports(ws, audit) {
+    return autoFixTypeScriptTypeOnlyImports(ws, audit);
+  },
   async probeEntry(ws, sandbox) {
     return probeTsEntrypoint(ws, sandbox);
   }
@@ -4082,6 +4304,99 @@ async function readJsonFile(ws, rel) {
     return null;
   }
 }
+var TYPE_ONLY_IMPORTS_BY_PACKAGE = {
+  axios: /* @__PURE__ */ new Set([
+    "AxiosAdapter",
+    "AxiosBasicCredentials",
+    "AxiosHeaderValue",
+    "AxiosInstance",
+    "AxiosInterceptorManager",
+    "AxiosPromise",
+    "AxiosProxyConfig",
+    "AxiosRequestConfig",
+    "AxiosRequestHeaders",
+    "AxiosResponse",
+    "AxiosResponseHeaders",
+    "CreateAxiosDefaults",
+    "InternalAxiosRequestConfig",
+    "RawAxiosRequestHeaders"
+  ])
+};
+async function autoFixTypeScriptTypeOnlyImports(ws, audit) {
+  const files = await listTypeScriptSourceFiles(ws, "src");
+  const fixed = [];
+  for (const rel of files) {
+    const original = await ws.readFile(rel);
+    const next = rewriteKnownTypeOnlyImports(original);
+    if (next === original) continue;
+    await ws.writeFile(rel, next);
+    fixed.push(rel);
+    await audit.event("note", `fixed type-only imports in ${rel}`, {
+      messageId: "audit.typescript_imports_autofix",
+      path: rel
+    });
+  }
+  return fixed;
+}
+async function listTypeScriptSourceFiles(ws, dir) {
+  const abs = ws.abs(dir);
+  let entries;
+  try {
+    entries = await fs5.readdir(abs, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const files = [];
+  for (const entry of entries) {
+    const rel = `${dir}/${entry.name}`.replace(/\\/g, "/");
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name === ".git") continue;
+      files.push(...await listTypeScriptSourceFiles(ws, rel));
+    } else if (entry.isFile() && /\.tsx?$/.test(entry.name)) {
+      files.push(rel);
+    }
+  }
+  return files.sort();
+}
+function rewriteKnownTypeOnlyImports(source) {
+  const importRe = /^import\s+([^'"\n]+?)\s+from\s+(['"])([^'"]+)\2\s*;?$/gm;
+  return source.replace(importRe, (full, clauseRaw, quote, specifier) => {
+    const knownTypes = TYPE_ONLY_IMPORTS_BY_PACKAGE[specifier];
+    if (!knownTypes) return full;
+    if (clauseRaw.trim().startsWith("type ")) return full;
+    const parsed = splitImportClause(clauseRaw);
+    if (!parsed?.named.length) return full;
+    const valueNamed = [];
+    const typeNamed = [];
+    for (const item of parsed.named) {
+      const importedName = item.replace(/^type\s+/u, "").split(/\s+as\s+/iu)[0]?.trim() ?? "";
+      if (knownTypes.has(importedName)) typeNamed.push(item.replace(/^type\s+/u, "").trim());
+      else valueNamed.push(item);
+    }
+    if (typeNamed.length === 0) return full;
+    const lines = [];
+    if (parsed.defaultImport && valueNamed.length > 0) {
+      lines.push(`import ${parsed.defaultImport}, { ${valueNamed.join(", ")} } from ${quote}${specifier}${quote};`);
+    } else if (parsed.defaultImport) {
+      lines.push(`import ${parsed.defaultImport} from ${quote}${specifier}${quote};`);
+    } else if (valueNamed.length > 0) {
+      lines.push(`import { ${valueNamed.join(", ")} } from ${quote}${specifier}${quote};`);
+    }
+    lines.push(`import type { ${typeNamed.join(", ")} } from ${quote}${specifier}${quote};`);
+    return lines.join("\n");
+  });
+}
+function splitImportClause(clauseRaw) {
+  const clause = clauseRaw.trim();
+  const namedMatch = clause.match(/\{([\s\S]*)\}$/u);
+  if (!namedMatch) return void 0;
+  const beforeNamed = clause.slice(0, namedMatch.index).replace(/,\s*$/u, "").trim();
+  const named = (namedMatch[1] ?? "").split(",").map((item) => item.trim()).filter(Boolean);
+  return {
+    defaultImport: beforeNamed || void 0,
+    named
+  };
+}
 
 // src/core/architecture.ts
 var COMPLEXITY_SURFACES = [
@@ -4273,7 +4588,7 @@ function validateArchitectureContract(modules, steps, language, demand) {
       }
       allTestPaths.add(testPath);
     }
-    const owners = codeSteps.filter((step) => module.sourcePaths.every((path30) => pathCoveredByOutputs(path30, step.outputs))).sort((a, b) => (stepIndex.get(a.id) ?? 0) - (stepIndex.get(b.id) ?? 0));
+    const owners = codeSteps.filter((step) => module.sourcePaths.every((path31) => pathCoveredByOutputs(path31, step.outputs))).sort((a, b) => (stepIndex.get(a.id) ?? 0) - (stepIndex.get(b.id) ?? 0));
     if (owners.length === 0) {
       issues.push({
         message: `${module.id} must map all sourcePaths to a CODE macro step; found 0.`
@@ -4303,7 +4618,7 @@ function validateArchitectureContract(modules, steps, language, demand) {
     ownedModules.push(module);
     modulesByCodeOwner.set(codeOwner.id, ownedModules);
     const matchingTests = testSteps.filter(
-      (step) => module.testPaths.some((path30) => pathCoveredByOutputs(path30, step.outputs))
+      (step) => module.testPaths.some((path31) => pathCoveredByOutputs(path31, step.outputs))
     );
     if (matchingTests.length === 0) {
       issues.push({ message: `${module.id} testPaths are not produced by any MODULE_TEST step.` });
@@ -4360,21 +4675,21 @@ function flattenSubTasks(step) {
   }
   return out;
 }
-function pathCoveredByOutputs(path30, outputs) {
-  const normalizedPath = normalizePath(path30);
+function pathCoveredByOutputs(path31, outputs) {
+  const normalizedPath = normalizePath(path31);
   return outputs.some((output) => {
     const normalizedOutput = normalizePath(output);
     return normalizedPath === normalizedOutput || normalizedPath.startsWith(`${normalizedOutput}/`);
   });
 }
-function isSourcePath(path30, extensions) {
-  return path30.startsWith("src/") && extensions.some((extension) => path30.endsWith(extension));
+function isSourcePath(path31, extensions) {
+  return path31.startsWith("src/") && extensions.some((extension) => path31.endsWith(extension));
 }
-function isTestPath(path30, extensions) {
-  return path30.startsWith("tests/") && extensions.some((extension) => path30.endsWith(extension));
+function isTestPath(path31, extensions) {
+  return path31.startsWith("tests/") && extensions.some((extension) => path31.endsWith(extension));
 }
-function normalizePath(path30) {
-  return path30.replace(/\\/g, "/").replace(/^\.\//u, "").replace(/\/+$/u, "");
+function normalizePath(path31) {
+  return path31.replace(/\\/g, "/").replace(/^\.\//u, "").replace(/\/+$/u, "");
 }
 function transitivelyDependsOn(step, targetId, byId) {
   const seen = /* @__PURE__ */ new Set();
@@ -4666,6 +4981,18 @@ var DOC_PATH_ALIASES = {
   "docs/integration-test.md": DOC_NAMES.integrationTest,
   "docs/module-test.md": DOC_NAMES.moduleTest,
   "docs/functional-test.md": DOC_NAMES.functionalTest,
+  "docs/unit-test-plan.md": DOC_NAMES.unitTestPlan,
+  "docs/unit_test_plan.md": DOC_NAMES.unitTestPlan,
+  "docs/tests/unit_test_plan.md": DOC_NAMES.unitTestPlan,
+  "docs/integration-test-plan.md": DOC_NAMES.integrationTestPlan,
+  "docs/integration_test_plan.md": DOC_NAMES.integrationTestPlan,
+  "docs/tests/integration_test_plan.md": DOC_NAMES.integrationTestPlan,
+  "docs/module-test-plan.md": DOC_NAMES.moduleTestPlan,
+  "docs/module_test_plan.md": DOC_NAMES.moduleTestPlan,
+  "docs/tests/module_test_plan.md": DOC_NAMES.moduleTestPlan,
+  "docs/functional-test-plan.md": DOC_NAMES.functionalTestPlan,
+  "docs/functional_test_plan.md": DOC_NAMES.functionalTestPlan,
+  "docs/tests/functional_test_plan.md": DOC_NAMES.functionalTestPlan,
   "docs/quick-start.md": DOC_NAMES.quickstart,
   "docs/quick_start.md": DOC_NAMES.quickstart,
   "docs/quickstart.md": DOC_NAMES.quickstart,
@@ -4673,13 +5000,25 @@ var DOC_PATH_ALIASES = {
   "docs/api_guide.md": DOC_NAMES.apiGuide,
   "docs/api-guide.md": DOC_NAMES.apiGuide
 };
+function canonicalTestPlanAlias(path31) {
+  const normalized = path31.replace(/\\/g, "/");
+  const match = normalized.match(
+    /^docs\/(?:tests\/)?(?:\d{1,2}[-_])?(functional|integration|module|unit)[-_]?test[-_]?plan\.md$/iu
+  );
+  const kind = match?.[1]?.toLowerCase();
+  if (kind === "functional") return DOC_NAMES.functionalTestPlan;
+  if (kind === "integration") return DOC_NAMES.integrationTestPlan;
+  if (kind === "module") return DOC_NAMES.moduleTestPlan;
+  if (kind === "unit") return DOC_NAMES.unitTestPlan;
+  return void 0;
+}
 function calibrateDocPaths(steps, projectType = "application") {
-  const remap = (p) => DOC_PATH_ALIASES[p] ?? p;
+  const remap = (p) => DOC_PATH_ALIASES[p] ?? canonicalTestPlanAlias(p) ?? p;
   const dropTopic = (p) => p !== DOC_NAMES.topic;
   return steps.map((s) => {
     const iterationId = s.iterationId ?? "P1";
-    const inputs = (s.inputs ?? []).map((p) => iterationScopedInput(remap(p), s.phase, iterationId));
-    let outputs = (s.outputs ?? []).map((p) => iterationScopedDoc(remap(p), s.phase, iterationId)).filter(dropTopic);
+    const inputs = dedup((s.inputs ?? []).map((p) => iterationScopedInput(remap(p), s.phase, iterationId)));
+    let outputs = dedup((s.outputs ?? []).map((p) => iterationScopedDoc(remap(p), s.phase, iterationId)).filter(dropTopic));
     outputs = outputs.filter((out) => {
       const ownerPhase = testPlanOwnerPhase(out, iterationId);
       return !ownerPhase || ownerPhase === s.phase;
@@ -4723,6 +5062,31 @@ function calibrateVModelDependencies(steps) {
   }
   return out;
 }
+function calibrateArchitectureModuleDependencies(modules, dependencies) {
+  const architectureModules = (modules ?? []).map((module) => ({
+    ...module,
+    dependencies: [...module.dependencies ?? []]
+  }));
+  const moduleIds = new Set(architectureModules.map((module) => module.id));
+  const projectDependencies = [...dependencies ?? []];
+  for (const module of architectureModules) {
+    const internalDependencies = [];
+    for (const rawDependency of module.dependencies) {
+      const dependency = String(rawDependency ?? "").trim();
+      if (!dependency) continue;
+      if (moduleIds.has(dependency) || /^M\d{3,}$/u.test(dependency)) {
+        internalDependencies.push(dependency);
+      } else {
+        projectDependencies.push(dependency);
+      }
+    }
+    module.dependencies = dedup(internalDependencies);
+  }
+  return {
+    architectureModules,
+    dependencies: dedup(projectDependencies.map((dependency) => dependency.trim()).filter(Boolean))
+  };
+}
 function calibrateLanguageStepOwnership(steps, args) {
   const profile = getLanguageProfile(args.language);
   const out = steps.map((step) => ({
@@ -4784,35 +5148,35 @@ function preferredTestOwnerPhase(output, modules) {
 function findIterationStep(steps, iterationId, phase) {
   return steps.find((step) => (step.iterationId ?? "P1") === iterationId && step.phase === phase);
 }
-function testPlanOwnerPhase(path30, iterationId) {
+function testPlanOwnerPhase(path31, iterationId) {
   for (const [sourcePhase, testPhase] of Object.entries(V_MODEL_SOURCE_TO_TEST_PHASE)) {
-    if (path30 === testPlanDocForIteration(testPhase, iterationId)) {
+    if (path31 === testPlanDocForIteration(testPhase, iterationId)) {
       return sourcePhase;
     }
   }
   return void 0;
 }
-function iterationScopedDoc(path30, phase, iterationId) {
-  if (iterationId === "P1") return path30;
-  if (path30 === DOC_NAMES.readme && phase === "FUNCTIONAL_TEST") {
+function iterationScopedDoc(path31, phase, iterationId) {
+  if (iterationId === "P1") return path31;
+  if (path31 === DOC_NAMES.readme && phase === "FUNCTIONAL_TEST") {
     return `docs/iterations/${iterationId}/README.md`;
   }
-  if (path30 === DOC_NAMES.quickstart && phase === "FUNCTIONAL_TEST") {
+  if (path31 === DOC_NAMES.quickstart && phase === "FUNCTIONAL_TEST") {
     return `docs/iterations/${iterationId}/quickstart.md`;
   }
-  if (path30 === DOC_NAMES.apiGuide && phase === "FUNCTIONAL_TEST") {
+  if (path31 === DOC_NAMES.apiGuide && phase === "FUNCTIONAL_TEST") {
     return `docs/iterations/${iterationId}/api-guide.md`;
   }
   for (const [docPhase, canonical] of Object.entries(PHASE_DOC)) {
-    if (path30 === canonical) {
-      return phaseDocForIteration(docPhase, iterationId) ?? path30;
+    if (path31 === canonical) {
+      return phaseDocForIteration(docPhase, iterationId) ?? path31;
     }
   }
-  return path30;
+  return path31;
 }
-function iterationScopedInput(path30, phase, iterationId) {
-  if (iterationId === "P1" || phase === "REQUIREMENT_ANALYSIS") return path30;
-  return iterationScopedDoc(path30, phase, iterationId);
+function iterationScopedInput(path31, phase, iterationId) {
+  if (iterationId === "P1" || phase === "REQUIREMENT_ANALYSIS") return path31;
+  return iterationScopedDoc(path31, phase, iterationId);
 }
 function calibrateStepIds(steps) {
   const map = /* @__PURE__ */ new Map();
@@ -5143,8 +5507,8 @@ function dedupModules(modules) {
   }
   return out;
 }
-function isTestImplementationPath(path30) {
-  return /^tests\/.+\.(?:py|ts|tsx)$/i.test(path30);
+function isTestImplementationPath(path31) {
+  return /^tests\/.+\.(?:py|ts|tsx)$/i.test(path31);
 }
 function isNonModuleTestPhase(phase) {
   return phase === "UNIT_TEST" || phase === "INTEGRATION_TEST" || phase === "FUNCTIONAL_TEST";
@@ -5167,7 +5531,7 @@ function testPathPrefixForPhase(phase) {
   return "unit";
 }
 function inferUnitTestExtension(modules) {
-  return modules.some((module) => module.testPaths.some((path30) => /\.tsx?$/i.test(path30))) ? ".test.ts" : ".py";
+  return modules.some((module) => module.testPaths.some((path31) => /\.tsx?$/i.test(path31))) ? ".test.ts" : ".py";
 }
 function collectTransitiveDependencyIds(step, stepById) {
   const seen = /* @__PURE__ */ new Set();
@@ -5358,7 +5722,8 @@ var Planner = class {
       intent: opts.intent ?? "greenfield",
       hasBaseline: !!opts.hasBaseline,
       complex: demand.nonTrivial,
-      projectShapeAmbiguous
+      projectShapeAmbiguous,
+      languageAmbiguous: !!opts.languageAmbiguous
     });
     const rep = makeStreamReporter("Planner.clarify", this.llm.name);
     let provider;
@@ -5382,7 +5747,8 @@ var Planner = class {
           // 在 provider fallback 层校验问题集质量，避免“只有两三个泛泛问题”直接进入 Gate 1。
           validate: (t2) => validateClarifyJson(t2, demand.nonTrivial, {
             projectShapeAmbiguous,
-            externalApiRequired
+            externalApiRequired,
+            languageAmbiguous: !!opts.languageAmbiguous
           })
         }
       );
@@ -5453,14 +5819,14 @@ ${t().prompts.plannerSelfMode}` : "")
         },
         { role: "user", content: prompt + feedback }
       ],
-      validate: (t2) => parsePhaseStepPlanJson(t2, parseContext, phasePlan, currentPhase.id)
+      validate: (t2) => parsePhaseStepPlanJson(t2, parseContext, phasePlan, currentPhase)
     });
     await this.audit?.plannerThought("decompose", text, {
       qaCount: input2.clarifications.length,
       provider,
       phaseId: currentPhase.id
     });
-    return parsePhaseStepPlanJson(text, parseContext, phasePlan, currentPhase.id);
+    return parsePhaseStepPlanJson(text, parseContext, phasePlan, currentPhase);
   }
   async chatWithStructuredValidationRetry(input2) {
     const maxAttempts = plannerStructuredRepairAttemptLimit(input2.context);
@@ -5539,7 +5905,7 @@ function formatPlannerValidationFeedback(err) {
 function isPlannerStructuredValidationError(err) {
   const message = errorMessage2(err);
   if (isPlannerTransportFailure(message)) return false;
-  return /^Planner (?:architecture|phase|JSON|draft|complexityAssessment|implementationPhases|iteration)/u.test(message);
+  return /^Planner (?:architecture|phase|PhasePlan|JSON|draft|complexityAssessment|implementationPhases|iteration)/u.test(message);
 }
 function isPlannerTransportFailure(message) {
   const text = message.toLowerCase();
@@ -5580,6 +5946,12 @@ function buildPlan(draft, opts = {}) {
     draft.requirementDigest
   );
   const phaseId = implementationPhases.find((phase) => phase.status === "current")?.id ?? draft.steps.find((step) => step.iterationId)?.iterationId ?? "P1";
+  const architectureDependencyCalibration = calibrateArchitectureModuleDependencies(
+    draft.architectureModules ?? [],
+    draft.dependencies
+  );
+  const architectureModules = architectureDependencyCalibration.architectureModules;
+  const draftDependencies = architectureDependencyCalibration.dependencies;
   const iterated = normalizeStepIterations(draft.steps, implementationPhases);
   const shaped = calibrateLanguageStepOwnership(
     calibrateVModelDependencies(
@@ -5588,14 +5960,14 @@ function buildPlan(draft, opts = {}) {
     {
       language,
       intent: opts.intent ?? "greenfield",
-      architectureModules: draft.architectureModules ?? []
+      architectureModules
     }
   );
-  const mapped = calibrateArchitectureStepMappings(shaped, draft.architectureModules ?? []);
-  const contracted = injectArchitectureContractPrompts(mapped, draft.architectureModules ?? []);
+  const mapped = calibrateArchitectureStepMappings(shaped, architectureModules);
+  const contracted = injectArchitectureContractPrompts(mapped, architectureModules);
   const languageContracted = injectLanguageContractPrompts(contracted, language);
   const steps = calibratePlanCoverage(languageContracted, language);
-  const dependencies = language === "python" ? calibratePythonRequirements(draft.dependencies) : [...new Set((draft.dependencies ?? []).map((d) => d.trim()).filter(Boolean))];
+  const dependencies = language === "python" ? calibratePythonRequirements(draftDependencies) : [...new Set((draftDependencies ?? []).map((d) => d.trim()).filter(Boolean))];
   return {
     version: "1",
     language,
@@ -5605,7 +5977,7 @@ function buildPlan(draft, opts = {}) {
     requirementDigest: draft.requirementDigest,
     complexityAssessment,
     implementationPhases,
-    architectureModules: draft.architectureModules,
+    architectureModules,
     globalPrompt: draft.globalPrompt,
     baselineSummary: opts.baselineSummary ?? "",
     dependencies,
@@ -5815,6 +6187,11 @@ function validateClarifyJson(text, complex, opts = {}) {
       "clarify missing required external API credential question: ask whether the user has an API/key/token; if not, default to open no-key APIs"
     );
   }
+  if (opts.languageAmbiguous && !parsed.some(isDevelopmentLanguageClarification)) {
+    throw new Error(
+      "clarify missing required development language question: ask whether the project should use Python or TypeScript/Node.js, with Python as the default option"
+    );
+  }
   return parsed;
 }
 function parsePhasePlanJson(text, context) {
@@ -5882,7 +6259,7 @@ function parsePhasePlanJson(text, context) {
     implementationPhases
   };
 }
-function parsePhaseStepPlanJson(text, context, phasePlan, currentIterationId) {
+function parsePhaseStepPlanJson(text, context, phasePlan, currentPhase) {
   const data = safeJson(text);
   if (!data || typeof data !== "object") {
     throw new Error("Planner did not return a JSON object for phase Step planning.");
@@ -5890,7 +6267,7 @@ function parsePhaseStepPlanJson(text, context, phasePlan, currentIterationId) {
   const obj = data;
   const rawDeps = Array.isArray(obj.dependencies) ? obj.dependencies : Array.isArray(obj.pythonRequirements) ? obj.pythonRequirements : [];
   const draft = {
-    requirementDigest: typeof obj.requirementDigest === "string" && obj.requirementDigest.trim() ? obj.requirementDigest : phasePlan.requirementDigest,
+    requirementDigest: typeof obj.requirementDigest === "string" && obj.requirementDigest.trim() ? obj.requirementDigest : currentPhase.objective || phasePlan.requirementDigest,
     globalPrompt: typeof obj.globalPrompt === "string" && obj.globalPrompt.trim() ? obj.globalPrompt : phasePlan.globalPrompt,
     projectType: phasePlan.projectType,
     complexityAssessment: phasePlan.complexityAssessment,
@@ -5899,7 +6276,11 @@ function parsePhaseStepPlanJson(text, context, phasePlan, currentIterationId) {
     architectureModules: obj.architectureModules,
     steps: obj.steps
   };
-  const parsed = parseDraftPlanJson(JSON.stringify(draft), context);
+  const parsed = parseDraftPlanJson(JSON.stringify(draft), {
+    ...context,
+    phaseDemandText: phaseDemandText(currentPhase)
+  });
+  const currentIterationId = currentPhase.id;
   const wrongIteration = parsed.steps.find((step) => (step.iterationId ?? "P1") !== currentIterationId);
   if (wrongIteration) {
     throw new Error(
@@ -5934,7 +6315,7 @@ function parseDraftPlanJson(text, context) {
     context?.baselineSummary ?? ""
   ].join("\n"));
   const rawDeps = Array.isArray(obj.dependencies) ? obj.dependencies : Array.isArray(obj.pythonRequirements) ? obj.pythonRequirements : [];
-  const dependencies = rawDeps.filter((s) => typeof s === "string");
+  let dependencies = rawDeps.filter((s) => typeof s === "string");
   if (context) {
     const validPhaseNames = new Set(PHASES);
     const nonCanonical = steps.map((rawStep, index) => {
@@ -5967,7 +6348,12 @@ function parseDraftPlanJson(text, context) {
   if (!architectureResult.success) {
     throw new Error(`Planner architectureModules invalid: ${architectureResult.error.issues.map((i) => i.message).join("; ")}`);
   }
-  const architectureModules = architectureResult.data;
+  const architectureDependencyCalibration = calibrateArchitectureModuleDependencies(
+    architectureResult.data,
+    dependencies
+  );
+  const architectureModules = architectureDependencyCalibration.architectureModules;
+  dependencies = architectureDependencyCalibration.dependencies;
   const parsedComplexityAssessment = parseComplexityAssessment(obj.complexityAssessment);
   if (context && !parsedComplexityAssessment) {
     throw new Error("Planner JSON missing valid complexityAssessment; complexity must be assessed during plan decomposition.");
@@ -6001,14 +6387,7 @@ function parseDraftPlanJson(text, context) {
   }
   if (context) {
     const demand = analyzeArchitectureDemand(
-      {
-        requirementDigest: digest,
-        rawRequirement: context.rawRequirement,
-        userAddenda: context.userAddenda,
-        globalPrompt,
-        baselineSummary: context.baselineSummary,
-        intent: context.intent
-      },
+      architectureDemandInputForDraft(context, digest, globalPrompt),
       context.language
     );
     const forcedPhaseSplit = hasForcedPhaseSplit([
@@ -6058,6 +6437,34 @@ function parseDraftPlanJson(text, context) {
     steps: stepsWithIterations
   };
 }
+function architectureDemandInputForDraft(context, digest, globalPrompt) {
+  if (!context.phaseDemandText) {
+    return {
+      requirementDigest: digest,
+      rawRequirement: context.rawRequirement,
+      userAddenda: context.userAddenda,
+      globalPrompt,
+      baselineSummary: context.baselineSummary,
+      intent: context.intent
+    };
+  }
+  return {
+    requirementDigest: context.phaseDemandText,
+    baselineSummary: context.baselineSummary,
+    intent: context.intent
+  };
+}
+function phaseDemandText(currentPhase) {
+  const gate = currentPhase.verificationGate;
+  return [
+    currentPhase.title,
+    currentPhase.objective,
+    currentPhase.scope.join("\n"),
+    currentPhase.deliverables.join("\n"),
+    gate?.summary ?? "",
+    gate?.checks.join("\n") ?? ""
+  ].map((part) => part.trim()).filter(Boolean).join("\n");
+}
 function parseComplexityAssessment(value) {
   const result = ComplexityAssessmentSchema.safeParse(value);
   return result.success ? result.data : void 0;
@@ -6144,6 +6551,15 @@ ${question.options.map((option) => option.answer).join("\n")}`.toLowerCase();
   const externalApiContext = /\b(api|url|endpoint|provider|external|third[- ]party|fetch|request)\b/u.test(text) || /外部|第三方|接口|数据源|天气|节假日|联网/u.test(text);
   return externalApiContext && asksCredential && mentionsNoKeyFallback;
 }
+function isDevelopmentLanguageClarification(question) {
+  const text = `${question.question}
+${question.why}
+${question.options.map((option) => option.answer).join("\n")}`.toLowerCase();
+  const mentionsPython = /\bpython\b/u.test(text) || /python\s*脚本|python\s*项目/u.test(text);
+  const mentionsTypeScript = /\btypescript\b|\btype\s*script\b|\bnode(?:\.js)?\b/u.test(text) || /type\s*script|ts\s*(程序|工程|项目|脚本|语言|实现)|typescript\s*项目/u.test(text);
+  const asksLanguage = /\b(language|runtime|implementation stack|programming language)\b/u.test(text) || /开发语言|编程语言|实现语言|运行时|技术栈/u.test(text);
+  return asksLanguage && mentionsPython && mentionsTypeScript;
+}
 function projectShapeSignals(text) {
   const lower = text.toLowerCase();
   const libraryLike = /\b(api[- ]?library|library|sdk|package|npm package|pypi package|client library|api client|reusable module|public api)\b/u.test(lower) || /api\s*(库|客户端)|公共\s*api|可复用接口|公共库|库项目|软件包|客户端库|开发包/u.test(text);
@@ -6271,7 +6687,7 @@ ${text.slice(0, 500)}`);
 }
 
 // src/core/incremental.ts
-import { promises as fs7 } from "fs";
+import { promises as fs8 } from "fs";
 import path9 from "path";
 
 // src/core/phase_plan.ts
@@ -6351,11 +6767,11 @@ function relativeFrom(base, target) {
 }
 
 // src/core/project_memory.ts
-import { promises as fs6 } from "fs";
+import { promises as fs7 } from "fs";
 import path8 from "path";
 
 // src/core/storage.ts
-import { promises as fs5 } from "fs";
+import { promises as fs6 } from "fs";
 import path7 from "path";
 
 // src/core/lint.ts
@@ -6791,21 +7207,21 @@ function parseLoadedPlan(json) {
 }
 async function savePlan(planPath, plan) {
   PlanSchema.parse(plan);
-  await fs5.mkdir(path7.dirname(planPath), { recursive: true });
-  await fs5.writeFile(planPath, JSON.stringify(plan, null, 2) + "\n", "utf8");
+  await fs6.mkdir(path7.dirname(planPath), { recursive: true });
+  await fs6.writeFile(planPath, JSON.stringify(plan, null, 2) + "\n", "utf8");
 }
 async function loadPhasePlan(phasePlanPath) {
-  const raw = await fs5.readFile(phasePlanPath, "utf8");
+  const raw = await fs6.readFile(phasePlanPath, "utf8");
   return PhasePlanSchema.parse(JSON.parse(raw));
 }
 async function savePhasePlan(phasePlanPath, phasePlan) {
   PhasePlanSchema.parse(phasePlan);
-  await fs5.mkdir(path7.dirname(phasePlanPath), { recursive: true });
-  await fs5.writeFile(phasePlanPath, JSON.stringify(phasePlan, null, 2) + "\n", "utf8");
+  await fs6.mkdir(path7.dirname(phasePlanPath), { recursive: true });
+  await fs6.writeFile(phasePlanPath, JSON.stringify(phasePlan, null, 2) + "\n", "utf8");
 }
 async function loadPlanTarget(inputPath) {
   const requestedPath = path7.resolve(inputPath);
-  const raw = await fs5.readFile(requestedPath, "utf8");
+  const raw = await fs6.readFile(requestedPath, "utf8");
   const json = JSON.parse(raw);
   const phasePlanResult = PhasePlanSchema.safeParse(json);
   if (phasePlanResult.success) {
@@ -6815,7 +7231,7 @@ async function loadPlanTarget(inputPath) {
       throw new Error(`phasePlan ${requestedPath} has no planPath for current phase ${phasePlan.currentPhaseId}`);
     }
     const planPath = path7.resolve(path7.dirname(requestedPath), phase.planPath);
-    const loaded2 = parseLoadedPlan(JSON.parse(await fs5.readFile(planPath, "utf8")));
+    const loaded2 = parseLoadedPlan(JSON.parse(await fs6.readFile(planPath, "utf8")));
     return {
       plan: loaded2.plan,
       planPath,
@@ -6982,7 +7398,7 @@ async function defaultPlanMetadataPath(root) {
 }
 async function fileExists(filePath) {
   try {
-    await fs6.stat(filePath);
+    await fs7.stat(filePath);
     return true;
   } catch {
     return false;
@@ -7010,7 +7426,7 @@ async function readWorkspaceText(ws, rel, maxChars) {
 }
 async function readAbsoluteText(fullPath, maxChars) {
   try {
-    const raw = await fs6.readFile(fullPath, "utf8");
+    const raw = await fs7.readFile(fullPath, "utf8");
     return truncate(raw, maxChars);
   } catch {
     return "";
@@ -7032,7 +7448,7 @@ async function walk(abs, rel, out, depth) {
   if (depth > 6 || out.length >= 160) return;
   let entries;
   try {
-    entries = await fs6.readdir(abs, { withFileTypes: true });
+    entries = await fs7.readdir(abs, { withFileTypes: true });
   } catch {
     return;
   }
@@ -7214,20 +7630,20 @@ function extractImportedStems(text) {
 function normalizeImportStem(value) {
   return value.replace(/^\.\//u, "").replace(/^\.\.\//u, "").replace(/\.(js|ts|tsx|py)$/u, "").replace(/\/index$/u, "").trim();
 }
-function extractContractsFromDoc(path30, text) {
+function extractContractsFromDoc(path31, text) {
   const contracts = [];
   for (const rawLine of text.split("\n")) {
     const line = rawLine.replace(/^[-*#\d.\s]+/u, "").trim();
     if (line.length < 18) continue;
     const lower = line.toLowerCase();
     if (INVARIANT_RE.test(lower)) {
-      contracts.push({ kind: "invariant", subject: path30, path: path30, detail: trimContractLine(line) });
+      contracts.push({ kind: "invariant", subject: path31, path: path31, detail: trimContractLine(line) });
     } else if (LIMITATION_RE.test(lower)) {
-      contracts.push({ kind: "limitation", subject: path30, path: path30, detail: trimContractLine(line) });
+      contracts.push({ kind: "limitation", subject: path31, path: path31, detail: trimContractLine(line) });
     } else if (EXTENSION_RE.test(lower)) {
-      contracts.push({ kind: "extension-point", subject: path30, path: path30, detail: trimContractLine(line) });
+      contracts.push({ kind: "extension-point", subject: path31, path: path31, detail: trimContractLine(line) });
     } else if (INTEGRATION_RE.test(lower)) {
-      contracts.push({ kind: "integration", subject: path30, path: path30, detail: trimContractLine(line) });
+      contracts.push({ kind: "integration", subject: path31, path: path31, detail: trimContractLine(line) });
     }
   }
   return contracts;
@@ -7326,7 +7742,7 @@ ${sec.slice(0, remain)}
 }
 async function loadPlanSummary(_ws, planPath, label) {
   try {
-    const raw = await fs7.readFile(planPath, "utf8");
+    const raw = await fs8.readFile(planPath, "utf8");
     const json = JSON.parse(raw);
     const phasePlanParsed = PhasePlanSchema.safeParse(json);
     if (phasePlanParsed.success) {
@@ -7394,7 +7810,7 @@ async function defaultBaselinePlanPath(root) {
 }
 async function fileExists2(filePath) {
   try {
-    await fs7.stat(filePath);
+    await fs8.stat(filePath);
     return true;
   } catch {
     return false;
@@ -7458,7 +7874,7 @@ async function walk2(abs, rel, out, depth) {
   if (depth > 6 || out.length >= 120) return;
   let entries;
   try {
-    entries = await fs7.readdir(abs, { withFileTypes: true });
+    entries = await fs8.readdir(abs, { withFileTypes: true });
   } catch {
     return;
   }
@@ -7636,7 +8052,7 @@ function renderSubTasks(tasks, depth) {
 }
 
 // src/core/project_file.ts
-import { promises as fs8 } from "fs";
+import { promises as fs9 } from "fs";
 import path10 from "path";
 import { z as z4 } from "zod";
 var XCOMPILER_PROJECT_KIND = "xcompiler.project";
@@ -7697,7 +8113,7 @@ async function findProjectFile(workspace) {
   const ws = path10.resolve(workspace);
   let entries;
   try {
-    entries = await fs8.readdir(ws, { withFileTypes: true });
+    entries = await fs9.readdir(ws, { withFileTypes: true });
   } catch {
     return void 0;
   }
@@ -7747,8 +8163,8 @@ async function updateProjectFile(opts) {
     history: nextHistory
   };
   XCompilerProjectFileSchema.parse(data);
-  await fs8.mkdir(path10.dirname(filePath), { recursive: true });
-  await fs8.writeFile(filePath, JSON.stringify(data, null, 2) + "\n", "utf8");
+  await fs9.mkdir(path10.dirname(filePath), { recursive: true });
+  await fs9.writeFile(filePath, JSON.stringify(data, null, 2) + "\n", "utf8");
   return filePath;
 }
 function buildProjectProgress(plan) {
@@ -7791,7 +8207,7 @@ function buildProjectProgress(plan) {
 }
 async function readExistingProjectFile(filePath) {
   try {
-    const raw = await fs8.readFile(filePath, "utf8");
+    const raw = await fs9.readFile(filePath, "utf8");
     return XCompilerProjectFileSchema.parse(JSON.parse(raw));
   } catch {
     return void 0;
@@ -7820,7 +8236,7 @@ function assertProjectFileExtension(filePath) {
 }
 
 // src/audit/audit.ts
-import { promises as fs9, appendFileSync, mkdirSync, existsSync, writeFileSync } from "fs";
+import { promises as fs10, appendFileSync, mkdirSync, existsSync, writeFileSync } from "fs";
 import { createHash } from "crypto";
 import path11 from "path";
 var AuditLogger = class {
@@ -7977,8 +8393,8 @@ var AuditLogger = class {
     });
   }
   /**
-   * 记录一轮 Executor 思考：thoughts 文本、计划调用的 actions、是否完成。
-   * 写入 jsonl + markdown 折叠块，交付时可作为"AI 思考过程完整记录"。
+   * 记录一轮 Executor 执行摘要：简短 intent、issue 处理方案、计划调用的 actions、是否完成。
+   * 写入 jsonl + markdown 折叠块，交付时可追溯每轮决策和动作。
    */
   async executorTurn(stepId, role, round, payload) {
     const storedPayload = protectAuditContent(payload, this.contentMode);
@@ -8050,8 +8466,8 @@ ${t().audit.processLogPreamble}
   }
   async appendMd(text) {
     this.mdQueue = this.mdQueue.then(
-      () => fs9.appendFile(this.mdAbs, text, "utf8"),
-      () => fs9.appendFile(this.mdAbs, text, "utf8")
+      () => fs10.appendFile(this.mdAbs, text, "utf8"),
+      () => fs10.appendFile(this.mdAbs, text, "utf8")
     ).catch((err) => {
       console.warn(t().audit.markdownAppendFailed(err.message));
     });
@@ -8133,7 +8549,7 @@ function redactText(value) {
 }
 
 // src/core/lock.ts
-import { promises as fs10, unlinkSync } from "fs";
+import { promises as fs11, unlinkSync } from "fs";
 import path12 from "path";
 import os from "os";
 var LockError = class extends Error {
@@ -8160,7 +8576,7 @@ function isAlive(pid) {
 }
 async function readLock(file) {
   try {
-    const raw = await fs10.readFile(file, "utf8");
+    const raw = await fs11.readFile(file, "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -8168,7 +8584,7 @@ async function readLock(file) {
 }
 async function acquireLock(workspace, command, options = {}) {
   const file = lockPath(workspace);
-  await fs10.mkdir(path12.dirname(file), { recursive: true });
+  await fs11.mkdir(path12.dirname(file), { recursive: true });
   const info = {
     pid: process.pid,
     host: os.hostname(),
@@ -8178,7 +8594,7 @@ async function acquireLock(workspace, command, options = {}) {
   const payload = JSON.stringify(info, null, 2);
   const tryCreate = async () => {
     try {
-      const fh = await fs10.open(file, "wx");
+      const fh = await fs11.open(file, "wx");
       await fh.writeFile(payload, "utf8");
       await fh.close();
       return true;
@@ -8191,14 +8607,14 @@ async function acquireLock(workspace, command, options = {}) {
     return makeReleaser(file);
   }
   if (options.force) {
-    await fs10.writeFile(file, payload, "utf8");
+    await fs11.writeFile(file, payload, "utf8");
     return makeReleaser(file);
   }
   const existing = await readLock(file);
   if (existing) {
     const sameHost = existing.host === info.host;
     if (sameHost && !isAlive(existing.pid)) {
-      await fs10.writeFile(file, payload, "utf8");
+      await fs11.writeFile(file, payload, "utf8");
       return makeReleaser(file);
     }
     throw new LockError(
@@ -8207,7 +8623,7 @@ async function acquireLock(workspace, command, options = {}) {
       existing
     );
   }
-  await fs10.writeFile(file, payload, "utf8");
+  await fs11.writeFile(file, payload, "utf8");
   return makeReleaser(file);
 }
 function makeReleaser(file) {
@@ -8216,7 +8632,7 @@ function makeReleaser(file) {
     if (released) return;
     released = true;
     try {
-      await fs10.unlink(file);
+      await fs11.unlink(file);
     } catch {
     }
   };
@@ -8241,7 +8657,7 @@ function makeReleaser(file) {
 }
 
 // src/version.ts
-var XCOMPILER_VERSION = "0.2.3";
+var XCOMPILER_VERSION = "0.2.4";
 var XCOMPILER_PLUGIN_API_VERSION = 1;
 
 // src/plugins/compatibility.ts
@@ -8584,8 +9000,51 @@ function resolveClarificationAnswer(q, rawAnswer) {
   }
   return answer;
 }
-function resolveCompileLanguage(configuredLanguage, intent, baseline) {
-  return isIncrementalIntent(intent) ? baseline.language ?? configuredLanguage : configuredLanguage;
+function resolveCompileLanguage(inputOrConfigured, intent, baseline) {
+  if (typeof inputOrConfigured === "string") {
+    return isIncrementalIntent(intent ?? "greenfield") ? baseline?.language ?? inputOrConfigured : inputOrConfigured;
+  }
+  const input2 = inputOrConfigured;
+  if (isIncrementalIntent(input2.intent ?? "greenfield") && input2.baseline?.language) {
+    return { language: input2.baseline.language, source: "baseline", ambiguous: false };
+  }
+  const topicInferred = inferCompileLanguageFromText(input2.rawRequirement);
+  if (topicInferred) {
+    return {
+      language: topicInferred,
+      source: "topic",
+      ambiguous: false
+    };
+  }
+  const clarificationText = formatLanguageClarificationText(input2.clarifications ?? []);
+  const clarifiedInferred = inferCompileLanguageFromText([
+    clarificationText,
+    input2.userAddenda ?? ""
+  ].join("\n"));
+  if (clarifiedInferred) {
+    return { language: clarifiedInferred, source: "clarification", ambiguous: false };
+  }
+  return { language: "python", source: "default", ambiguous: true };
+}
+function inferCompileLanguageFromText(text) {
+  const normalized = text.toLowerCase().replace(/[，。；：、（）【】]/gu, " ").replace(/\s+/gu, " ");
+  const pythonStrong = /\bpython\b/u.test(normalized) || /python\s*脚本/u.test(normalized) || /\.py\b/u.test(normalized) || /\bpytest\b/u.test(normalized) || /\bpip\b/u.test(normalized);
+  const typescriptStrong = /\btypescript\b/u.test(normalized) || /\btype\s*script\b/u.test(normalized) || /(^|[^a-z0-9])ts\s*(程序|工程|项目|脚本|语言|实现)/u.test(normalized) || /\.tsx?\b/u.test(normalized) || /\btsx\b/u.test(normalized);
+  if (pythonStrong && !typescriptStrong) return "python";
+  if (typescriptStrong && !pythonStrong) return "typescript";
+  const pythonWeak = /\bopenpyxl\b/u.test(normalized) || /\bpandas\b/u.test(normalized) || /\bfastapi\b/u.test(normalized) || /\bflask\b/u.test(normalized);
+  const typescriptWeak = /\bnode(?:\.js)?\b/u.test(normalized) || /\bnpm\b/u.test(normalized) || /\bvitest\b/u.test(normalized) || /\bpackage\.json\b/u.test(normalized) || /\bjavascript\b/u.test(normalized) || /\bjs\s*(程序|工程|项目|脚本|语言|实现)\b/u.test(normalized);
+  if ((pythonStrong || pythonWeak) && !(typescriptStrong || typescriptWeak)) return "python";
+  if ((typescriptStrong || typescriptWeak) && !(pythonStrong || pythonWeak)) return "typescript";
+  return void 0;
+}
+function formatLanguageClarificationText(input2) {
+  return input2.map((item) => [
+    item.question,
+    item.answer,
+    item.why ?? "",
+    ...(item.options ?? []).map((option) => option.answer)
+  ].join("\n")).join("\n\n");
 }
 async function runCompile(opts) {
   const io = opts.io ?? silentRuntimeIO;
@@ -8662,15 +9121,7 @@ async function runCompile(opts) {
     if (baseline.summary) {
       await runtimeLog(io, "success", M.compile.baselineLoaded(intent, baseline.sources.join(", ")));
     }
-    const language = resolveCompileLanguage(cfg.agent.language, intent, baseline);
-    if (isIncrementalIntent(intent) && baseline.language && baseline.language !== cfg.agent.language) {
-      await runtimeLog(
-        io,
-        "warning",
-        M.compile.baselineLanguageOverride(baseline.language, baseline.languageSource ?? "baseline", cfg.agent.language)
-      );
-    }
-    const planner = new Planner(router.for("Planner"), audit, language);
+    const plannerClient = router.for("Planner");
     const trace = (msg) => {
       if (xcEnv("TRACE") === "1") {
         void runtimeLog(io, "dim", t().audit.traceLine("xcompiler-trace", msg));
@@ -8679,7 +9130,7 @@ async function runCompile(opts) {
     let rawRequirement;
     if (topicMode) {
       trace("topic.read");
-      rawRequirement = await fs11.readFile(path13.resolve(opts.topicFile), "utf8");
+      rawRequirement = await fs12.readFile(path13.resolve(opts.topicFile), "utf8");
       if (!rawRequirement.trim()) {
         await runtimeLog(io, "error", M.compile.topicEmptyExit);
         await audit.end({ status: "aborted", reason: "empty topic file" });
@@ -8700,19 +9151,26 @@ async function runCompile(opts) {
       await audit.userInput(M.compile.auditOriginalRequirement, rawRequirement);
       trace("audit.userInput.intake.done");
     }
+    const initialLanguage = resolveCompileLanguage({
+      rawRequirement,
+      intent,
+      baseline
+    });
     trace("clarify.section.enter");
     const clarifications = [];
     let clarificationQuestions = [];
     trace(`clarify.section.flag yes=${opts.yes} topicMode=${topicMode}`);
     if (!opts.yes && !topicMode) {
+      const clarifyPlanner = new Planner(plannerClient, audit, initialLanguage.language);
       trace("ora.clarify.start");
       const spin = io.progress(M.compile.spinClarify, { animate: false });
       trace("ora.clarify.started");
       try {
         trace("planner.clarify.call");
-        clarificationQuestions = await planner.clarify(rawRequirement, {
+        clarificationQuestions = await clarifyPlanner.clarify(rawRequirement, {
           intent,
-          hasBaseline: !!baseline.summary
+          hasBaseline: !!baseline.summary,
+          languageAmbiguous: initialLanguage.ambiguous
         });
         trace(`planner.clarify.return n=${clarificationQuestions.length}`);
         spin.succeed(M.compile.clarifySucceed(clarificationQuestions.length));
@@ -8801,6 +9259,20 @@ ${M.compile.topicPreviewHeader}`);
     }
     trace("ws.readFile.finalTopic");
     const finalTopicMd = await ws.readFile(draftTopic);
+    const languageResolution = resolveCompileLanguage({
+      rawRequirement: finalTopicMd,
+      clarifications,
+      userAddenda,
+      intent,
+      baseline
+    });
+    const language = languageResolution.language;
+    await audit.event("note", `target language resolved: ${language}`, {
+      messageId: "compile.language_resolved",
+      language,
+      source: languageResolution.source,
+      ambiguous: languageResolution.ambiguous
+    });
     await archiveIfExists(ws, DOC_NAMES.topic, audit);
     await ws.writeFile(DOC_NAMES.topic, finalTopicMd);
     await audit.event("topic.persist", M.compile.auditTopicPersisted(ws.abs(DOC_NAMES.topic)), {
@@ -8814,6 +9286,7 @@ ${M.compile.topicPreviewHeader}`);
     trace("ora.spin2.started");
     let draft;
     try {
+      const planner = new Planner(plannerClient, audit, language);
       const plannerInput = {
         rawRequirement: finalTopicMd,
         clarifications,
@@ -8951,7 +9424,7 @@ async function tryLoadPhasePlan(phasePlanPath) {
 }
 async function intake(inputFile, io) {
   if (inputFile) {
-    return fs11.readFile(path13.resolve(inputFile), "utf8");
+    return fs12.readFile(path13.resolve(inputFile), "utf8");
   }
   return requireRuntimeInteraction(io, "requirement intake").readMultiline({
     message: t().compile.requirementInputHint
@@ -8995,14 +9468,14 @@ function renderTopicDraft(raw, qa, addenda = "") {
 }
 
 // src/runtime/commands.ts
-import path29 from "path";
-import { promises as fs26 } from "fs";
+import path30 from "path";
+import { promises as fs28 } from "fs";
 
 // src/runtime/run.ts
-import path27 from "path";
+import path28 from "path";
 
 // src/workspace/git.ts
-import { promises as fs12 } from "fs";
+import { promises as fs13 } from "fs";
 import path14 from "path";
 import { simpleGit } from "simple-git";
 
@@ -9011,7 +9484,7 @@ import { existsSync as existsSync2, readFileSync } from "fs";
 
 // src/sandbox/subprocess.ts
 import { spawn } from "child_process";
-import { promises as fs13 } from "fs";
+import { promises as fs14 } from "fs";
 import path15 from "path";
 import crypto from "crypto";
 
@@ -9042,13 +9515,16 @@ function formatCommand(cmd, argv) {
   return [cmd, ...argv].filter(Boolean).join(" ");
 }
 
+// src/sandbox/subprocess.ts
+var INSTALL_IDLE_TIMEOUT_FLOOR_MS = 15 * 6e4;
+
 // src/sandbox/docker.ts
-import { promises as fs14 } from "fs";
+import { promises as fs15 } from "fs";
 import path16 from "path";
 import crypto2 from "crypto";
 
 // src/core/engine.ts
-import path26 from "path";
+import path27 from "path";
 import chalk2 from "chalk";
 
 // src/util/spinner.ts
@@ -9134,10 +9610,10 @@ init_types();
 // src/tools/fs.ts
 init_types();
 import path18 from "path";
-import { promises as fs16 } from "fs";
+import { promises as fs17 } from "fs";
 
 // src/tools/path_guard.ts
-import { promises as fs15 } from "fs";
+import { promises as fs16 } from "fs";
 import path17 from "path";
 async function resolveWorkspacePath(ws, rawPath, operation, opts = {}) {
   const raw = rawPath && rawPath.trim() ? rawPath : ".";
@@ -9146,19 +9622,19 @@ async function resolveWorkspacePath(ws, rawPath, operation, opts = {}) {
   if (!isInside(root, abs)) return deny(operation, raw);
   if (opts.mustExist) {
     try {
-      const real = await fs15.realpath(abs);
+      const real = await fs16.realpath(abs);
       if (!isInside(root, real)) return deny(operation, raw);
     } catch (err) {
       return { ok: false, error: `${operation} failed: ${err.message}` };
     }
   } else if (opts.forWrite) {
-    const existingTarget = await fs15.realpath(abs).catch(() => void 0);
+    const existingTarget = await fs16.realpath(abs).catch(() => void 0);
     if (existingTarget && !isInside(root, existingTarget)) return deny(operation, raw);
     const parent = await nearestExistingParent(path17.dirname(abs));
-    const realParent = await fs15.realpath(parent).catch(() => parent);
+    const realParent = await fs16.realpath(parent).catch(() => parent);
     if (!isInside(root, realParent)) return deny(operation, raw);
   } else {
-    const existing = await fs15.realpath(abs).catch(() => void 0);
+    const existing = await fs16.realpath(abs).catch(() => void 0);
     if (existing && !isInside(root, existing)) return deny(operation, raw);
   }
   return { ok: true, abs };
@@ -9168,13 +9644,13 @@ function isInside(root, candidate) {
   return rel === "" || !!rel && !rel.startsWith("..") && !path17.isAbsolute(rel);
 }
 async function realpathOrResolve(p) {
-  return fs15.realpath(p).catch(() => path17.resolve(p));
+  return fs16.realpath(p).catch(() => path17.resolve(p));
 }
 async function nearestExistingParent(start) {
   let current2 = path17.resolve(start);
   while (true) {
     try {
-      const stat = await fs15.stat(current2);
+      const stat = await fs16.stat(current2);
       if (stat.isDirectory()) return current2;
     } catch {
     }
@@ -9193,7 +9669,7 @@ function deny(operation, rawPath) {
 // src/tools/patch.ts
 init_types();
 import path19 from "path";
-import { promises as fs17 } from "fs";
+import { promises as fs18 } from "fs";
 
 // src/tools/sandbox.ts
 function tailLines(text, n) {
@@ -9268,13 +9744,13 @@ var pipInstallTool = {
 // src/tools/edit.ts
 init_types();
 import path20 from "path";
-import { promises as fs18 } from "fs";
+import { promises as fs19 } from "fs";
 
 // src/tools/deps.ts
-import { promises as fs19 } from "fs";
+import { promises as fs20 } from "fs";
 
 // src/tools/net.ts
-import { promises as fs20 } from "fs";
+import { promises as fs21 } from "fs";
 import path21 from "path";
 var DEFAULT_MAX_BYTES = 256 * 1024;
 
@@ -9282,25 +9758,31 @@ var DEFAULT_MAX_BYTES = 256 * 1024;
 init_types();
 
 // src/tools/guard.ts
-import { promises as fs21 } from "fs";
+import { promises as fs22 } from "fs";
 import path22 from "path";
 
 // src/agents/executor.ts
 import path23 from "path";
-import { promises as fs22 } from "fs";
+import { promises as fs23 } from "fs";
 import { jsonrepair } from "jsonrepair";
 
 // src/core/debug_cache.ts
-import { promises as fs23 } from "fs";
+import { promises as fs24 } from "fs";
 import path24 from "path";
 
-// src/core/project_audit.ts
-import { promises as fs24 } from "fs";
+// src/core/debug_wiki.ts
+import { promises as fs25 } from "fs";
 import path25 from "path";
+import { fileURLToPath } from "url";
+import YAML3 from "yaml";
+
+// src/core/project_audit.ts
+import { promises as fs26 } from "fs";
+import path26 from "path";
 
 // src/runtime/workspace.ts
-import path28 from "path";
-import { promises as fs25 } from "fs";
+import path29 from "path";
+import { promises as fs27 } from "fs";
 function defaultProjectName(now = /* @__PURE__ */ new Date()) {
   const pad = (n) => n.toString().padStart(2, "0");
   return `xcompiler-${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
@@ -9308,14 +9790,14 @@ function defaultProjectName(now = /* @__PURE__ */ new Date()) {
 async function resolveCompileWorkspace(opts) {
   const explicit = opts.output ?? opts.workspace;
   if (explicit) {
-    const ws2 = path28.resolve(explicit);
-    await fs25.mkdir(ws2, { recursive: true });
+    const ws2 = path29.resolve(explicit);
+    await fs27.mkdir(ws2, { recursive: true });
     return ws2;
   }
-  const base = opts.baseDir ? path28.resolve(opts.baseDir) : "/tmp";
+  const base = opts.baseDir ? path29.resolve(opts.baseDir) : "/tmp";
   const name = opts.name ?? defaultProjectName();
-  const ws = path28.join(base, name);
-  await fs25.mkdir(ws, { recursive: true });
+  const ws = path29.join(base, name);
+  await fs27.mkdir(ws, { recursive: true });
   return ws;
 }