@xcompiler/cli 0.2.2 → 0.2.4

package/dist/plugins/index.js

@@ -22,8 +22,8 @@ For P2+ iterations, put the same basenames under \`docs/iterations/<iterationId>
 
 Synchronous test-design rule:
 - REQUIREMENT_ANALYSIS must also output \`docs/tests/functional-test-plan.md\`.
-- HIGH_LEVEL_DESIGN must also output \`docs/tests/integration-test-plan.md\`.
-- DETAILED_DESIGN must also output \`docs/tests/module-test-plan.md\`.
+- HIGH_LEVEL_DESIGN must also output \`docs/tests/module-test-plan.md\`.
+- DETAILED_DESIGN must also output \`docs/tests/integration-test-plan.md\`.
 - CODE must also output \`docs/tests/unit-test-plan.md\`.
 For P2+ iterations, put those under \`docs/iterations/<iterationId>/tests/\`.
 
@@ -33,8 +33,8 @@ Phase responsibilities:
 - DETAILED_DESIGN defines the module-internal functions, data structures, algorithms, control flow, error handling, and internal architecture.
 - CODE implements only the designed scope and produces runnable/importable Python source.
 - UNIT_TEST verifies CODE internals and public functions.
-- INTEGRATION_TEST verifies external interfaces, selected third-party libraries, dependency wiring, and API/client boundaries from HIGH_LEVEL_DESIGN.
-- MODULE_TEST verifies module-level behaviour and architecture from DETAILED_DESIGN.
+- INTEGRATION_TEST verifies module-internal collaboration, data flow, and component integration from DETAILED_DESIGN.
+- MODULE_TEST verifies the current module's position in the whole system, external interfaces, and dependency boundaries from HIGH_LEVEL_DESIGN.
 - FUNCTIONAL_TEST verifies requirements end-to-end and produces user-facing documentation.
 
 Functional documentation bundle: P1 FUNCTIONAL_TEST outputs must include \`README.md\`, \`docs/quickstart.md\`, and \`docs/08-functional-test.md\`; for \`projectType\` = \`library\` or \`mixed\`, also include \`docs/api-guide.md\`. P2+ uses \`docs/iterations/<iterationId>/08-functional-test.md\`, \`quickstart.md\`, and optional \`api-guide.md\`. Documentation must follow the active i18n language.
@@ -55,6 +55,7 @@ Mandatory rules:
 13. dependencies is a Python pip dependency list. Include \`pytest\`; use bare package names only; never list \`requirements.txt\` in Step outputs.
 14. Application/mixed projects need a directly executable Python entry point (\`src/main.py\` or package \`__main__.py\`) that reuses CODE modules. Library/mixed projects need a stable public API and \`docs/api-guide.md\`.
 15. Structured HIGH_LEVEL_DESIGN -> CODE -> MODULE_TEST contract: for non-trivial work, return \`architectureModules\` with each module's id, name, responsibility, sourcePaths, testPaths, and dependencies. CODE/MODULE_TEST Steps may cover multiple modules but must list module-level work in subTasks.
+16. Third-party library choices must match real APIs: HIGH_LEVEL_DESIGN must name the concrete entry point function/class or verification basis for the selected library in this requirement; do not invent parser/export APIs from package names alone.
 
 Output JSON shape:
 {
@@ -95,6 +96,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
 }
@@ -114,15 +116,18 @@ Rules:
      **must NOT** add their own sys.path.insert(...). If you create or edit conftest.py yourself,
      keep the existing sys.path injection \u2014 do not delete it.
    - [Self-contained tests] Tests **must NOT** open() a sample file that does not exist on disk
-     (e.g. "test.dbc", "sample.csv"). When a target function needs file input, do exactly one of:
-       (a) use pytest's tmp_path fixture inside the test, e.g. tmp_path.joinpath("x.dbc").write_text(...);
-       (b) use write_file to put a fixture under tests/fixtures/<name> \u2014 test/DEBUG phases have
-           write permission to tests/fixtures/ by default, sub-directories are auto-mkdir'd, and
-           **fixture paths do NOT need to be pre-declared in outputs**.
+     (e.g. "sample.csv"). When a target function needs file input, choose in this priority order:
+       (a) first reuse a real sample supplied by the user or already present in the workspace, copying/referencing it under tests/fixtures/<name>;
+       (b) for third-party or industry-standard formats with no local sample, use http_fetch to obtain a small reference sample from official docs,
+           the upstream repository, or a public standard/example, save it under tests/fixtures/<name>, and record the source in the test report or comment;
+       (c) only for simple text formats such as CSV/JSON/INI, and only when you can immediately run_tests, construct a minimal sample with pytest tmp_path.
+     If the network is unavailable, no user sample exists, and the format standard cannot be confirmed, report a blocker asking the user for a sample.
      A test that references a file nobody created will trap the Debugger in an endless FileNotFoundError loop.
    - [Fixture iteration] When a test runs but the target function raises "Invalid syntax / Parse error / Malformed",
-     the **fixture itself is malformed** (DBC/CSV/JSON/...), **not the implementation**.
-     read_file the fixture \u2192 write_file a minimal valid sample for that format \u2192 run_tests again.
+     the **fixture itself is malformed**, **not the implementation**.
+     read_file the fixture, identify the format from the extension/parser/error, then prefer a user/workspace sample or an authoritative http_fetch reference;
+     rewrite the whole fixture with write_file and run_tests. After repeated failures on a complex domain format, stop inventing from memory and ask
+     for a user sample or network reference.
      Never edit the implementation, the assertion, or mock out the parser to "fix" a parse error \u2014 fix the fixture first.
 4. When all outputs files exist and self-check passes, set done = true with empty actions.
 5. Correct any error in the next round's actions; never overstep authority or invent tools.
@@ -142,8 +147,8 @@ DEBUG is runtime rollback/repair only. If a test phase fails, XCompiler rolls ba
 
 Use the same phase documents and synchronous test-design rule as the Python planner:
 - REQUIREMENT_ANALYSIS: \`docs/01-requirement-analysis.md\` plus \`docs/tests/functional-test-plan.md\`.
-- HIGH_LEVEL_DESIGN: \`docs/02-high-level-design.md\` plus \`docs/tests/integration-test-plan.md\`.
-- DETAILED_DESIGN: \`docs/03-detailed-design.md\` plus \`docs/tests/module-test-plan.md\`.
+- HIGH_LEVEL_DESIGN: \`docs/02-high-level-design.md\` plus \`docs/tests/module-test-plan.md\`.
+- DETAILED_DESIGN: \`docs/03-detailed-design.md\` plus \`docs/tests/integration-test-plan.md\`.
 - CODE: implementation outputs plus \`docs/tests/unit-test-plan.md\`.
 - UNIT_TEST: \`docs/05-unit-test.md\`.
 - INTEGRATION_TEST: \`docs/06-integration-test.md\`.
@@ -159,6 +164,7 @@ Mandatory rules:
 2. Every current/planned implementation phase is a complete V-model iteration containing all eight canonical phases.
 3. Each macro Step may contain \`subTasks\` nested at most two levels.
 4. Every CODE Step must be covered by a UNIT_TEST Step in the same iteration; module testPaths from architectureModules must be produced by MODULE_TEST.
+   CODE outputs must contain product source files under src/ plus docs/tests/unit-test-plan.md only; never list tests/**/*.test.ts or other tests/** files as CODE outputs.
 5. Design phases must not output src/ or tests/ files. HIGH_LEVEL_DESIGN is the only phase that may output \`package.json\` / \`tsconfig.json\`.
 6. Exactly one HIGH_LEVEL_DESIGN Step must output \`package.json\` for greenfield TypeScript plans; ensure one HIGH_LEVEL_DESIGN Step output \`package.json\`. It must include scripts for \`build\`, \`test\`, and preferably \`lint\`.
 7. Local TypeScript source imports must use explicit \`.ts\` ESM specifiers. Configure \`allowImportingTsExtensions: true\` and use \`tsc --noEmit\`. Generated TypeScript must be compatible with Node native type stripping: avoid enums, namespaces, parameter properties, and transform-required syntax.
@@ -167,6 +173,7 @@ Mandatory rules:
 10. complexityAssessment and implementationPhases follow the same rules as Python: simple => P1, moderate => at least P1+P2, complex => at least P1+P2+P3, forced phase split => set userForcedPhaseSplit=true.
 11. verificationGate failurePolicy must say: Feed failures to Debugger, roll back to the paired V-model phase, and rerun subsequent phases.
 12. For non-trivial work, return architectureModules with sourcePaths and testPaths; CODE/MODULE_TEST Steps may cover multiple modules but must list module-level work in subTasks.
+13. TypeScript tests must use Vitest only. Never request Jest, ts-jest, @types/jest, ts-node, or nodemon in Step prompts or package.json; package.json must use "test": "vitest run" and "build": "tsc --noEmit".
 
 Output JSON shape is identical to Python and must include \`"projectType": "application | library | mixed"\`, with TypeScript paths such as \`src/example.ts\` and \`tests/example.test.ts\`; the first Step phase must be \`REQUIREMENT_ANALYSIS\`, not \`REQUIREMENT\`. There is no CLI project-type override.`;
 var TYPESCRIPT_EXECUTOR_SYSTEM = `You are XCompiler's Step Executor. You may only interact with the system through JSON tool calls \u2014 no Markdown and no explanatory text.
@@ -174,6 +181,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
 }
@@ -186,7 +194,7 @@ Rules:
    - [Import convention] Local source modules under src/ use ESM relative imports with explicit ".ts" specifiers, e.g. \`import { x } from "./util.ts";\`. Keep code compatible with Node's native TypeScript type stripping: use erasable type syntax only, and avoid enums, namespaces, parameter properties, or other transform-required TS features. Never use Python-style imports, \`from src.<module>\`, or sys.path hacks.
    - [Test convention] Tests use Vitest: \`import { describe, it, expect } from "vitest";\`. Test files live under \`tests/**/*.test.ts\`.
    - [Self-contained tests] Tests **must NOT** read a sample file that does not exist on disk. When a target function needs file input, either create the content inside the test or write fixtures under \`tests/fixtures/<name>\`.
-   - [Fixture iteration] When a test runs but the target function raises "Invalid syntax / Parse error / Malformed", the **fixture itself is malformed**. read_file the fixture \u2192 write_file a minimal valid sample \u2192 run_tests again. Never "fix" a parse error by weakening the implementation or the assertion.
+   - [Fixture iteration] When a test runs but the target function raises "Invalid syntax / Parse error / Malformed", the **fixture itself is malformed**. read_file the fixture, prefer a user/workspace sample; if none exists, use http_fetch to obtain an authoritative public reference; construct minimal samples only for simple text formats and immediately run_tests. Never weaken the implementation/assertion, and never repeatedly invent complex domain fixtures from memory.
 4. When all outputs files exist and self-check passes, set done = true with empty actions.
 5. Correct any error in the next round's actions; never overstep authority or invent tools.
 6. [Large-file chunked writes] write_file / append_file content must stay under the current Step's runtime chunk limit shown in the tool docs.
@@ -197,10 +205,82 @@ 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;
 }
+function buildPlannerPhasePlanSystem(profile) {
+  return `You are the Planner of XCompiler. This is two-level planning, pass one: PhasePlan.
+
+Target language: ${profile.displayName}.
+
+Return only the project-level PhasePlan. Do not return steps, architectureModules, dependencies, or any individual V-model Step.
+
+The PhasePlan must:
+1. Classify projectType: application / library / mixed.
+2. Assess complexityAssessment: simple / moderate / complex with rationale.
+3. Produce implementationPhases: P1 status=current; later P2/P3 status=planned. simple uses P1 only; moderate uses at least P1+P2; complex uses at least P1+P2+P3; user-forced staging uses at least P1+P2 and userForcedPhaseSplit=true.
+4. Give each phase objective, scope, deliverables, dependsOn, and verificationGate.
+5. Keep planned phases as goals and gates only. Do not expand any Step for them; a separate pass will generate a full V-model plan for one phase at a time.
+
+Return strict JSON only:
+{
+  "requirementDigest": "string",
+  "globalPrompt": "string",
+  "projectType": "application | library | mixed",
+  "complexityAssessment": { "level": "simple | moderate | complex", "rationale": "string", "splitRecommended": true, "userForcedPhaseSplit": false },
+  "implementationPhases": [
+    { "id": "P1", "title": "Core functionality", "objective": "string", "status": "current", "scope": ["..."], "deliverables": ["..."], "dependsOn": [], "verificationGate": { "summary": "string", "checks": ["..."], "failurePolicy": "Feed failures to Debugger, roll back to the paired V-model phase, and rerun subsequent phases." } }
+  ]
+}
+
+No Markdown, no explanatory prose, no steps, no source/test file inventory.` + profile.plannerPromptOverride;
+}
+function buildPlannerPhaseDecomposeSystem(profile) {
+  return `You are the Planner of XCompiler. This is two-level planning, pass two: generate a full V-model StepPlan for the requested phase.
+
+Target language: ${profile.displayName}.
+
+You will receive a frozen PhasePlan and a phaseId. Generate Steps only for that phaseId. Planned phases must not be expanded into this StepPlan.
+
+Every current phase must use the canonical V-model:
+REQUIREMENT_ANALYSIS -> HIGH_LEVEL_DESIGN -> DETAILED_DESIGN -> CODE -> UNIT_TEST -> INTEGRATION_TEST -> MODULE_TEST -> FUNCTIONAL_TEST.
+
+Phase responsibilities:
+- REQUIREMENT_ANALYSIS defines functional scope, acceptance, boundaries, and user-visible behaviour, and synchronously emits the functional test plan.
+- HIGH_LEVEL_DESIGN defines system position, external interfaces, third-party library choices, dependency confirmation, and integration boundaries, and synchronously emits the integration test plan.
+- DETAILED_DESIGN defines module-internal functions/classes, data structures, algorithms, control flow, error handling, and internal architecture, and synchronously emits the module test plan.
+- CODE implements only the current phase and synchronously emits the unit test plan.
+- UNIT_TEST / INTEGRATION_TEST / MODULE_TEST / FUNCTIONAL_TEST verify their paired left-side phases.
+
+Strict output ownership:
+- CODE outputs may include only product source files under src/ and the unit-test-plan document; do not put tests/** files in CODE outputs.
+- UNIT_TEST owns unit test files; INTEGRATION_TEST owns integration test files; MODULE_TEST owns architectureModules.testPaths; FUNCTIONAL_TEST owns end-to-end/functional test files and delivery docs.
+- For greenfield TypeScript, exactly one HIGH_LEVEL_DESIGN Step must output package.json with scripts, dependencies, and devDependencies. CODE must not output package.json.
+- For TypeScript package.json, use Vitest only: "test": "vitest run", "build": "tsc --noEmit", devDependencies include typescript/tsx/vitest/@types/node. Do not mention or request Jest, ts-jest, @types/jest, ts-node, or nodemon.
+
+Return only the current phase's dependencies, architectureModules, and steps. Complex or multi-concern work must declare architectureModules for the current phase and map module-level work under CODE/MODULE_TEST subTasks. Each Step's subTasks may nest at most two levels.
+
+architectureModules may describe only product/business source modules for the current phase:
+- sourcePaths must be target-language source files under src/. They must not be directories, tests/, docs/, README, fixtures, utils, or report files.
+- testPaths must be target-language test files under tests/. They must not be directories.
+- Test fixtures, test helpers, sample inputs, and temporary output files belong in test Step outputs or subTasks, not in architectureModules.
+
+Return strict JSON only:
+{
+  "requirementDigest": "string",
+  "globalPrompt": "string",
+  "dependencies": ["pytest"],
+  "architectureModules": [
+    { "id": "M001", "name": "module name", "responsibility": "one clear responsibility", "sourcePaths": ["src/example.py"], "testPaths": ["tests/test_example.py"], "dependencies": [] }
+  ],
+  "steps": [
+    { "id": "S001", "iterationId": "P1", "phase": "REQUIREMENT_ANALYSIS", "title": "string", "description": "string", "systemPrompt": "scope, inputs, outputs, acceptance, forbidden actions", "role": "Planner", "tools": ["write_file"], "inputs": ["docs/topic.md"], "outputs": ["docs/01-requirement-analysis.md", "docs/tests/functional-test-plan.md"], "subTasks": [], "dependsOn": [], "acceptance": "string", "maxRetries": 3 }
+  ]
+}
+
+Do not output Steps for future planned phases. Do not output requirements.txt. Design phases must not write src/tests. FUNCTIONAL_TEST must include README.md, docs/quickstart.md, and the functional validation document.` + profile.plannerPromptOverride;
+}
 function buildExecutorSystem(profile) {
   return (profile.id === "typescript" ? TYPESCRIPT_EXECUTOR_SYSTEM : PYTHON_EXECUTOR_SYSTEM) + profile.executorPromptOverride;
 }
@@ -217,13 +297,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; failure -0.5 (floor 0=disabled); success +0.1 (cap 10)."
+    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}`,
@@ -302,34 +382,35 @@ var messages = {
   },
   cli: {
     rootDescription: "XCompiler \u2014 AI Software Factory CLI",
-    compileDescription: "Interactively compile a requirement into plan.json (with mandatory human gates)",
-    runDescription: "Execute a confirmed plan.json (supports phased runs: --phase / --from)",
+    compileDescription: "Interactively compile a requirement into phasePlan.json and the current phase plan (with mandatory human gates)",
+    runDescription: "Execute a confirmed phasePlan.json (supports phased runs: --phase / --from)",
     loadDescription: "Load a XXX.xc project file and continue its current plan",
     appendDescription: "Append a new requirement to an existing XXX.xc project through clarification and V-model execution",
-    lsDescription: "Scan workspace and list every plan.json status summary",
+    lsDescription: "Scan workspace and list every phasePlan.json / legacy plan.json status summary",
     showDescription: "Print Step definition / status / outputs / recent audit",
     optWorkspace: "workspace directory (alias of --output, defaults to current directory)",
     optOutput: "project / workspace output directory (highest priority, alias of -w)",
     optConfig: "path to config.yaml",
     optInput: "read requirement from a file (non-interactive)",
     optTopic: "reuse an already-clarified topic.md as input: skip intake / clarify / addenda / Gate 1 and go straight to decompose",
-    optPlanOut: "output path for plan.json (default <workspace>/plan.json)",
+    optPlanOut: "output path for phasePlan.json (default <workspace>/phasePlan.json)",
     optBaseDir: "project root output directory (creates <name> subdir under it)",
     optName: "project name (default xcompiler-<timestamp>)",
     optYes: "skip human confirmation (only meaningful with -i / -t)",
-    optForce: "force regenerate: override workspace lock and ignore existing plan.json",
+    optForce: "force regenerate: override workspace lock and ignore existing plan files",
     optDryRun: "print topology only, do not execute",
     optFrom: "start from the given Step (earlier ones are skipped)",
     optPhase: "execute only the given phase (REQUIREMENT_ANALYSIS/HIGH_LEVEL_DESIGN/DETAILED_DESIGN/CODE/UNIT_TEST/INTEGRATION_TEST/MODULE_TEST/FUNCTIONAL_TEST/DEBUG)",
     optReset: "reset all Step status to PENDING",
     optMaxDepth: "maximum recursion depth",
     optTail: "number of recent audit entries",
-    optPlan: "plan.json path, default <workspace>/plan.json",
+    optPlan: "phasePlan.json path, default <workspace>/phasePlan.json",
     optLang: "UI / prompt language: EN | CN (ISO 3166-1 Alpha-2)",
     optIntent: "plan intent: greenfield | feature | refactor | self",
-    optBaselinePlan: "existing baseline plan.json path (default <workspace>/plan.json)",
+    optBaselinePlan: "existing baseline phasePlan.json / plan.json path (default <workspace>/phasePlan.json)",
     optProjectFile: "XXX.xc project file path (default <workspace>/<name>.xc)",
-    argPlan: "plan.json path (default = <workspace>/plan.json)",
+    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",
     evolveDescription: "Generate and execute an incremental feature/refactor plan on top of an existing workspace",
@@ -407,7 +488,7 @@ var messages = {
     auditDecomposeFailed: "planner.decompose failed",
     lintIssue: (id, message) => ` - [${id}] ${message}`,
     planPreviewTruncated: "\u2026 (truncated; see docs/plan.md)",
-    auditPlanPersisted: (p) => `plan.json written: ${p}`,
+    auditPlanPersisted: (p) => `phase plan written: ${p}`,
     projectFileWritten: (p) => `project file updated: ${p}`,
     nextCommand: (command) => `  Next: ${command}`,
     topicEmptyExit: "--topic file is empty, aborting.",
@@ -424,8 +505,10 @@ var messages = {
     spinDecompose: "Planner is decomposing along the V-model\u2026",
     decomposeFail: "Planner decomposition failed",
     plannerInvalidPlan: "Planner could not produce a valid plan:",
-    plannerInvalidPlanHint1: "  Common cause: every LLM provider returned malformed/truncated JSON (e.g. token loop).",
-    plannerInvalidPlanHint2: "  Investigate: check llm.error / planner.thought entries in .xcompiler/audit.jsonl.",
+    plannerInvalidPlanHint1: "  Common cause: the LLM output did not satisfy the XCompiler plan schema, V-model skeleton, or architecture contract; this error must not be skipped.",
+    plannerInvalidPlanHint2: "  Investigate: check llm.error / planner.thought entries in .xcompiler/audit.jsonl and repair the Planner output against the contract.",
+    plannerTransportFailureHint1: "  Common cause: the LLM provider connection failed, timed out, or the server closed the request; this is not a project plan/source defect.",
+    plannerTransportFailureHint2: "  Investigate: check OPENAI_BASE_URL / provider base_url, model service reachability, network permissions, and timeout settings, then rerun build.",
     decomposeSucceed: (n) => `generated ${n} Step(s)`,
     schemaFail: "Plan schema validation failed:",
     schemaInvalidSavedAt: (p) => `  full plan saved to: ${p}`,
@@ -440,12 +523,13 @@ var messages = {
     gate1Cancelled: "Cancelled, no files written.",
     editTopicMsg: "Edit topic.md",
     topicWritten: (p) => `topic written: ${p}`,
-    planWritten: (p) => `plan written: ${p}`,
+    planWritten: (p) => `phase plan written: ${p}`,
+    phasePlanWritten: (p) => `phasePlan written: ${p}`,
     planPreviewHeader: "\u2500\u2500\u2500 plan.md (preview) \u2500\u2500\u2500",
     planPreviewFooter: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    gate2Confirm: "Confirm this plan? (Final confirmation \u2014 confirms write to plan.json)",
+    gate2Confirm: "Confirm this plan? (Final confirmation \u2014 writes phasePlan.json and the current phase plan)",
     gate2AuditLabel: "Plan Confirmation Gate (Gate 2)",
-    gate2Rejected: "Not confirmed, abandoned. plan.json was not written.",
+    gate2Rejected: "Not confirmed, abandoned. phasePlan.json was not written.",
     baselineLoaded: (kind, sources) => `loaded ${kind} baseline from: ${sources}`,
     baselineMissing: (workspace) => `incremental mode requires an existing project baseline in ${workspace} (topic / docs / plan / src).`,
     baselineLanguageOverride: (baseline, source, configured) => `incremental mode: using baseline language ${baseline} from ${source} instead of config language ${configured}.`,
@@ -457,7 +541,7 @@ var messages = {
     topicSecBaseline: "## Existing project baseline"
   },
   inspect: {
-    noPlanFound: "No plan.json found",
+    noPlanFound: "No phasePlan.json / plan.json found",
     digestLabel: "digest:",
     stepNotFound: (id) => `Step ${id} not found`,
     secDescription: "\u2014 description \u2014",
@@ -482,7 +566,7 @@ var messages = {
     auditPlanLoaded: (p) => `plan loaded: ${p}`,
     planLoaded: (p) => `Plan loaded: ${p}`,
     planSummary: (language, steps) => `  language=${language}, steps=${steps}`,
-    preflightModelMissing: (names) => `LLM preflight: missing models, disabled [${names}]`,
+    preflightModelMissing: (names) => `LLM preflight: missing models, skipped for this run and lowered to the minimum dynamic score [${names}]`,
     preflightAutoAdded: (n) => `LLM preflight: auto-injected ${n} provider(s) (from ollama /api/tags)`,
     runInterrupted: (id, e, total) => `execution interrupted at ${id} (executed ${e}/${total})`,
     runReasonLabel: "  reason: ",
@@ -538,7 +622,7 @@ var messages = {
     archGateInstruction: (p) => `Update ${p} so every architectureModules item is traceable before CODE starts.`,
     testGateReason: (exitCode, timedOut) => `Test gate: tests exit=${exitCode}${timedOut ? " (timeout)" : ""}`,
     deliveryGateReason: (command, exitCode, timedOut) => `FUNCTIONAL_TEST gate: \`${command}\` exit=${exitCode}${timedOut ? " (timeout)" : ""}`,
-    missingPythonEntrypoint: "missing Python entrypoint: expected src/main.py or src/<package>/__main__.py",
+    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: (path2) => `invalid Python entrypoint source in ${path2}: 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.`,
@@ -576,6 +660,8 @@ var messages = {
   },
   prompts: {
     plannerSystem: (p) => buildPlannerSystem(p),
+    plannerPhasePlanSystem: (p) => buildPlannerPhasePlanSystem(p),
+    plannerPhaseDecomposeSystem: (p) => buildPlannerPhaseDecomposeSystem(p),
     plannerSelfMode: `SELF-BOOTSTRAP OVERRIDE (takes precedence over conflicting greenfield rules above):
 - The target is the existing XCompiler repository. Preserve its current package.json, tsconfig, bin entries, CLI entrypoints, module layout, public exports, and documentation unless the requirement explicitly changes them.
 - Do not create src/main.ts merely to satisfy a greenfield entrypoint convention. Reuse the entrypoints declared by the existing package.json.
@@ -600,18 +686,20 @@ Question mix (functionality first):
 - At least one quality question requesting measurable latency, throughput, volume, concurrency, accuracy, reliability, or security targets. Never ask only \u201CAny performance requirements?\u201D.
 - At least one extensibility question identifying the most likely future business capability, extension axis, or interface that must remain stable. Never ask only \u201CShould it be extensible?\u201D.
 - If the deliverable shape is unclear, include one boundary question asking whether this should be an API library/SDK/package, a runnable application/CLI/service, or a mixed deliverable with both.
+- If the requirement needs access to external APIs, URLs, or third-party data sources, include one data or boundary question asking whether the user already has a usable API, key, token, or auth method. If they do not, the default for this delivery is to choose a public, no-key/no-token, verifiable API; do not generate placeholder URLs.
 - Order by blocking impact: core functional/data decisions first, then scope and quality, then future evolution.
 - One primary decision per question. Include useful business choices/examples; do not join unrelated questions with \u201Cand/or\u201D.
 - For every question, generate 2-5 feasible answer options ordered by priority. The option count is not fixed: use 2 for binary choices, 3 for common defaults, and 4-5 only when there are genuinely distinct viable settings. Do not pad or force every question to exactly 3 options.
 - 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:
 """
@@ -643,11 +731,77 @@ ${opts.baseline || "(missing baseline)"}
 - When baseline files already exist, prefer editing/extending those modules over creating shadow implementations with duplicate behaviour.
 
 Output a strict JSON plan per the system rules.`,
+    plannerPhasePlan: (raw, qa, addenda, opts = {}) => `Original requirement:
+"""
+${raw}
+"""
+
+Clarification Q&A:
+${qa || "(none)"}
+
+${addenda ? `User addenda (must be strictly followed; takes priority over vague original wording):
+"""
+${addenda}
+"""
+
+` : ""}${opts.intent && opts.intent !== "greenfield" ? `Incremental intent: ${opts.intent}
+
+Generate a PhasePlan on top of the existing project. Reuse current architecture, files, tests, and dependencies where possible. Preserve existing behaviour outside the requested change.
+
+Existing project baseline:
+"""
+${opts.baseline || "(missing baseline)"}
+"""
+
+` : ""}First generate only the high-level PhasePlan:
+- Assess complexity and choose phase count: simple => P1 current only; moderate => P1 current + at least P2 planned; complex => P1 current + at least P2/P3 planned.
+- P1 objective must be an independently deliverable and verifiable core slice.
+- P2/P3 should contain only future enhancement goals, scope, deliverables, and verification gates. Do not expand any V-model Step.
+- Every phase verificationGate must say failures are fed to Debugger, rolled back to the paired V-model phase, and followed by rerunning subsequent phases.
+- Return only PhasePlan JSON. Do not include steps, architectureModules, or dependencies.`,
+    plannerPhaseDecompose: (raw, qa, addenda, opts) => `Original requirement:
+"""
+${raw}
+"""
+
+Clarification Q&A:
+${qa || "(none)"}
+
+${addenda ? `User addenda (must be strictly followed; takes priority over vague original wording):
+"""
+${addenda}
+"""
+
+` : ""}${opts.intent && opts.intent !== "greenfield" ? `Incremental intent: ${opts.intent}
+
+Generate the current phase's incremental V-model StepPlan on top of the existing project. Reuse current architecture, files, tests, and dependencies where possible.
+
+Existing project baseline:
+"""
+${opts.baseline || "(missing baseline)"}
+"""
+
+` : ""}Frozen PhasePlan:
+"""
+${opts.phasePlan}
+"""
+
+Phase to expand now: ${opts.phaseId}
+
+Return a full V-model StepPlan only for ${opts.phaseId}:
+- Every Step.iterationId must equal "${opts.phaseId}".
+- Do not output Steps for any other planned phase; P2/P3 detailed plans are generated only when they become the current phase.
+- If ${opts.phaseId} spans multiple concerns (domain logic, CLI/API, file I/O, external integration, orchestration, tests), declare architectureModules for this phase and map module-level work under CODE/MODULE_TEST subTasks.
+- architectureModules.sourcePaths may only contain product source files under src/. Do not register tests/fixtures, tests/utils, sample files, directories, or docs as architecture modules.
+- dependencies contains only packages required by this phase; Python must include pytest; never output requirements.txt.
+- This phase must contain the canonical eight V-model macro Steps and synchronous paired test-design outputs.
+
+Return strict JSON StepPlan for the current phase only.`,
     executorSystem: (p) => buildExecutorSystem(p),
     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. 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. 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) => `
@@ -661,14 +815,18 @@ ${sp}`,
     executorUserPromptOutro: "Now return the first round of JSON per the protocol.",
     executorFeedbackHeader: "Tool results this round:",
     executorFeedbackVerifyOk: "outputs verified. If you are done, set done=true and actions=[].",
-    executorFeedbackVerifyMissing: (paths) => `outputs still missing: ${paths}. Please continue.`
+    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.",
+    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.",
     author: "Use write_file to create new files; prefer paths inside the current Step writable allowlist.",
-    tester: `Write and run pytest tests verifying function behaviour; on failure parse with analyze_error. [Self-contained fixtures] Tests **must NOT** open() a sample file that does not exist on disk (e.g. "test.dbc"); when the target function needs file input, either use pytest tmp_path to construct content inside the test, or use write_file to put a fixture under tests/fixtures/<name> \u2014 test/DEBUG phases already grant write permission to that directory, sub-dirs are auto-mkdir'd, and **fixture paths do NOT need to be pre-declared in outputs**. When generating tests, always emit every dependent resource so the Debugger does not loop on FileNotFoundError. [Fixture iteration] If a running test raises "Invalid syntax / Parse error / Malformed" from the target function, your fixture content does not match the format spec: read_file to inspect, write_file to rewrite a minimal valid sample, then run_tests. Never edit the implementation or assertions to "fix" a parse error.`,
+    tester: `Write and run pytest tests verifying function behaviour; on failure parse with analyze_error. [Self-contained fixtures] Tests **must NOT** open() a sample file that does not exist on disk. When the target function needs file input, first reuse a real user/workspace sample; if none exists, use http_fetch to get a small reference sample from official docs, the upstream repository, or a public standard/example, save it under tests/fixtures/<name>, and record the source. Only for simple text formats such as CSV/JSON/INI may you construct a minimal pytest tmp_path sample and immediately run_tests. Test/DEBUG phases already grant write permission to tests/fixtures/, sub-dirs are auto-mkdir'd, and **fixture paths do NOT need to be pre-declared in outputs**. When generating tests, always emit every dependent resource so the Debugger does not loop on FileNotFoundError. [Fixture iteration] If a running test raises "Invalid syntax / Parse error / Malformed" from the target function, your fixture content does not match the format spec: read_file to inspect, then prefer a user sample or authoritative http_fetch reference before rewriting and running tests. After repeated failures on a complex domain format, stop inventing from memory and ask for a user sample or network reference. Never edit the implementation or assertions to "fix" a parse error.`,
     dep_resolver: "On ModuleNotFoundError, use add_dependency to write the package back into requirements.txt and rebuild the sandbox.",
-    debugger: 'First run_tests / run_python to reproduce the error \u2192 analyze_error \u2192 patch / replace_in_file to fix \u2192 run_tests again. Make the smallest possible change each round. [Network/API failures] Locate the failing URL, try only a small number of replacement API probes, then patch the source and run_program to prove the entrypoint no longer emits API failure. [Important] If replace_in_file on the same file fails \u2265 2 times in a row, switch to read_file and then patch or rewrite within the current runtime chunk limit; stop guessing the find string. [No no-ops] replace_in_file find and replace must differ \u2014 if you only want to "verify" a snippet, use read_file; do not submit identical-string replacements.',
+    debugger: 'First run_tests / run_python to reproduce the error \u2192 analyze_error \u2192 patch / replace_in_file / add_dependency to fix \u2192 run_tests again. Make the smallest possible change each round. [Missing dependencies] Add the real dependency or use the real library selected by the design; never fake modules/classes/functions, empty implementations, or fallback mocks in production src/ code. [Fixture discipline] If tests fail with behavioural assertions, do not keep rewriting fixtures. Only change fixtures for clear missing-file, malformed-fixture, or fixture parse errors; otherwise fix source code, contracts, dependencies, or the incorrect assertion. [Network/API failures] Locate the failing URL, try only a small number of replacement API probes, then patch the source and run_program to prove the entrypoint no longer emits API failure. [Important] If replace_in_file on the same file fails \u2265 2 times in a row, switch to read_file and then patch or rewrite within the current runtime chunk limit; stop guessing the find string. [No no-ops] replace_in_file find and replace must differ \u2014 if you only want to "verify" a snippet, use read_file; do not submit identical-string replacements.',
     refactorer: "Refactors must preserve behaviour: run regression tests \u2192 modify \u2192 run regression tests again."
   },
   doctor: {
@@ -691,7 +849,7 @@ ${sp}`,
     ollamaReachable: (baseUrl, n) => `ollama reachable @ ${baseUrl} (${n} model(s))`,
     ollamaModelMissing: (provider, model, baseUrl) => `provider "${provider}": model "${model}" NOT installed on ${baseUrl} (run \`ollama pull ${model}\`)`,
     ollamaModelOk: (provider, model) => `provider "${provider}": model "${model}" available`,
-    openaiKeyMissing: (provider) => `provider "${provider}": api_key empty (set OPENAI_API_KEY or config.llm.providers.${provider}.api_key)`,
+    openaiKeyMissing: (provider) => `provider "${provider}": api_key empty (set the provider env var such as OPENROUTER_API_KEY, or config.llm.providers.${provider}.api_key)`,
     openaiReachable: (provider, baseUrl) => `provider "${provider}": OpenAI endpoint reachable @ ${baseUrl}`,
     openaiUnreachable: (provider, baseUrl, msg) => `provider "${provider}": OpenAI endpoint unreachable @ ${baseUrl} \u2014 ${msg}`,
     openaiModelListMissing: (provider, model) => `provider "${provider}": model "${model}" not in /models response (it may still work if your account has access)`,
@@ -700,7 +858,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)",
@@ -745,8 +903,8 @@ P2+ \u8FED\u4EE3\u628A\u540C\u540D\u9636\u6BB5\u6587\u6863\u5199\u5165 \`docs/it
 
 \u540C\u6B65\u6D4B\u8BD5\u8BBE\u8BA1\u89C4\u5219\uFF1A
 - REQUIREMENT_ANALYSIS \u540C\u6B65\u8F93\u51FA \`docs/tests/functional-test-plan.md\`\u3002
-- HIGH_LEVEL_DESIGN \u540C\u6B65\u8F93\u51FA \`docs/tests/integration-test-plan.md\`\u3002
-- DETAILED_DESIGN \u540C\u6B65\u8F93\u51FA \`docs/tests/module-test-plan.md\`\u3002
+- HIGH_LEVEL_DESIGN \u540C\u6B65\u8F93\u51FA \`docs/tests/module-test-plan.md\`\u3002
+- DETAILED_DESIGN \u540C\u6B65\u8F93\u51FA \`docs/tests/integration-test-plan.md\`\u3002
 - CODE \u540C\u6B65\u8F93\u51FA \`docs/tests/unit-test-plan.md\`\u3002
 P2+ \u8FED\u4EE3\u628A\u8FD9\u4E9B\u6D4B\u8BD5\u8BA1\u5212\u5199\u5230 \`docs/iterations/<iterationId>/tests/\`\u3002
 
@@ -756,8 +914,8 @@ P2+ \u8FED\u4EE3\u628A\u8FD9\u4E9B\u6D4B\u8BD5\u8BA1\u5212\u5199\u5230 \`docs/it
 - DETAILED_DESIGN \u5B9A\u4E49\u6A21\u5757\u5185\u90E8\u7684\u5177\u4F53\u529F\u80FD\u5B9E\u73B0\u548C\u67B6\u6784\uFF0C\u5305\u62EC\u51FD\u6570/\u7C7B\u3001\u6570\u636E\u7ED3\u6784\u3001\u7B97\u6CD5\u3001\u63A7\u5236\u6D41\u3001\u9519\u8BEF\u5904\u7406\u548C\u5185\u90E8\u534F\u4F5C\u3002
 - CODE \u53EA\u5B9E\u73B0\u5DF2\u8BBE\u8BA1\u8303\u56F4\u5E76\u4EA7\u51FA\u53EF\u8FD0\u884C/\u53EF\u5BFC\u5165\u7684 Python \u6E90\u7801\u3002
 - UNIT_TEST \u9A8C\u8BC1 CODE \u7684\u5185\u90E8\u51FD\u6570\u548C\u516C\u5F00 API\u3002
-- INTEGRATION_TEST \u9A8C\u8BC1 HIGH_LEVEL_DESIGN \u4E2D\u7684\u5916\u90E8\u63A5\u53E3\u3001\u7B2C\u4E09\u65B9\u5E93\u3001\u4F9D\u8D56\u63A5\u7EBF\u548C API/client \u8FB9\u754C\u3002
-- MODULE_TEST \u9A8C\u8BC1 DETAILED_DESIGN \u4E2D\u7684\u6A21\u5757\u7EA7\u884C\u4E3A\u548C\u5185\u90E8\u67B6\u6784\u3002
+- INTEGRATION_TEST \u9A8C\u8BC1 DETAILED_DESIGN \u4E2D\u5B9A\u4E49\u7684\u6A21\u5757\u5185\u90E8\u534F\u4F5C\u3001\u6570\u636E\u6D41\u548C\u7EC4\u4EF6\u96C6\u6210\u3002
+- MODULE_TEST \u9A8C\u8BC1 HIGH_LEVEL_DESIGN \u4E2D\u5F53\u524D\u5F00\u53D1\u6A21\u5757\u5728\u6574\u4F53\u7CFB\u7EDF\u4E2D\u7684\u5B9A\u4F4D\u3001\u5BF9\u5916\u63A5\u53E3\u548C\u4F9D\u8D56\u8FB9\u754C\u3002
 - FUNCTIONAL_TEST \u6309\u9700\u6C42\u7AEF\u5230\u7AEF\u9A8C\u6536\uFF0C\u5E76\u4EA7\u51FA\u9762\u5411\u7528\u6237\u7684\u6587\u6863\u3002
 
 \u529F\u80FD\u9A8C\u6536\u6587\u6863\u5305\uFF1AP1 FUNCTIONAL_TEST outputs \u5FC5\u987B\u5305\u542B \`README.md\`\u3001\`docs/quickstart.md\`\u3001\`docs/08-functional-test.md\`\uFF1B\u5F53 \`projectType\` \u4E3A \`library\` \u6216 \`mixed\` \u65F6\u8FD8\u5FC5\u987B\u5305\u542B \`docs/api-guide.md\`\u3002P2+ \u4F7F\u7528 \`docs/iterations/<iterationId>/08-functional-test.md\`\u3001\`quickstart.md\` \u548C\u53EF\u9009 \`api-guide.md\`\u3002\u6587\u6863\u8BED\u8A00\u9075\u5FAA\u5F53\u524D i18n\u3002
@@ -778,6 +936,7 @@ P2+ \u8FED\u4EE3\u628A\u8FD9\u4E9B\u6D4B\u8BD5\u8BA1\u5212\u5199\u5230 \`docs/it
 13. dependencies \u662F Python pip \u4F9D\u8D56\u5217\u8868\uFF1B\u5FC5\u987B\u5305\u542B \`pytest\`\uFF1B\u53EA\u5199\u88F8\u5305\u540D\uFF1B\u4EFB\u4F55 Step \u90FD\u4E0D\u8981\u8F93\u51FA \`requirements.txt\`\u3002
 14. application/mixed \u9879\u76EE\u9700\u8981\u53EF\u76F4\u63A5\u8FD0\u884C\u7684 Python \u5165\u53E3\uFF08\`src/main.py\` \u6216\u5305 \`__main__.py\`\uFF09\u5E76\u590D\u7528 CODE \u6A21\u5757\uFF1Blibrary/mixed \u9879\u76EE\u9700\u8981\u7A33\u5B9A\u516C\u5F00 API \u548C \`docs/api-guide.md\`\u3002
 15. \u590D\u6742\u9700\u6C42\u5FC5\u987B\u8FD4\u56DE \`architectureModules\`\uFF1A\u6BCF\u4E2A\u6A21\u5757\u5305\u542B id\u3001name\u3001responsibility\u3001sourcePaths\u3001testPaths\u3001dependencies\u3002CODE/MODULE_TEST Step \u53EF\u8986\u76D6\u591A\u4E2A\u6A21\u5757\uFF0C\u4F46\u5FC5\u987B\u5728 subTasks \u4E2D\u5217\u51FA\u6A21\u5757\u7EA7\u5DE5\u4F5C\u3002
+16. \u7B2C\u4E09\u65B9\u5E93\u9009\u578B\u5FC5\u987B\u5339\u914D\u771F\u5B9E API\uFF1AHIGH_LEVEL_DESIGN \u5FC5\u987B\u5199\u660E\u9009\u5B9A\u5E93\u7528\u4E8E\u672C\u9700\u6C42\u7684\u5177\u4F53\u5165\u53E3\u51FD\u6570/\u7C7B\u6216\u9A8C\u8BC1\u4F9D\u636E\uFF1B\u7981\u6B62\u4EC5\u51ED\u5305\u540D\u81C6\u9020\u4E0D\u5B58\u5728\u7684\u89E3\u6790/\u5BFC\u51FA API\u3002
 
 \u8F93\u51FA JSON \u5F62\u5982\uFF1A
 {
@@ -818,6 +977,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
 }
@@ -836,15 +996,18 @@ var PYTHON_EXECUTOR_SYSTEM2 = `\u4F60\u662F XCompiler \u7684 Step Executor\u3002
      \u56E0\u6B64 pytest \u4E0E "python tests/test_*.py" \u4E24\u79CD\u6267\u884C\u65B9\u5F0F\u90FD\u80FD\u89E3\u6790\u6A21\u5757\uFF0C
      \u6D4B\u8BD5\u6587\u4EF6\u5934\u90E8**\u65E0\u9700**\u518D\u5199 sys.path.insert(...)\uFF0C\u907F\u514D\u91CD\u590D\u6C61\u67D3\u3002
      \u5982\u679C LLM \u81EA\u5DF1\u989D\u5916\u521B\u5EFA/\u7F16\u8F91 conftest.py\uFF0C\u5FC5\u987B\u4FDD\u7559\u4E0A\u9762 sys.path \u6CE8\u5165\u903B\u8F91\uFF0C\u7981\u6B62\u5220\u9664\u3002
-   - \u3010\u6D4B\u8BD5\u81EA\u5305\u542B\u3011\u6D4B\u8BD5**\u4E25\u7981**\u76F4\u63A5 open() \u4E00\u4E2A\u78C1\u76D8\u4E0A\u4E0D\u5B58\u5728\u7684\u6837\u4F8B\u6587\u4EF6\uFF08\u5982 "test.dbc"\u3001"sample.csv"\uFF09\uFF1B
-     \u5F53\u88AB\u6D4B\u51FD\u6570\u9700\u8981\u6587\u4EF6\u8F93\u5165\u65F6\uFF0C\u5FC5\u987B\u4E8C\u9009\u4E00\uFF1A
-       (a) \u7528 pytest \u7684 tmp_path fixture \u5728\u6D4B\u8BD5\u51FD\u6570\u5185 tmp_path.joinpath("x.dbc").write_text(...) \u6784\u9020\u5185\u5BB9\u5E76\u4F20\u5165\uFF1B
-       (b) \u7528 write_file \u628A\u6837\u4F8B\u5199\u5230 tests/fixtures/<name>\u2014\u2014\u6D4B\u8BD5/DEBUG \u9636\u6BB5 tests/fixtures/ \u5DF2\u9ED8\u8BA4\u653E\u5F00\u5199\u6743\u9650\uFF0C
-           \u5B50\u76EE\u5F55\u4F1A\u81EA\u52A8 mkdir -p\uFF0C**\u65E0\u9700**\u63D0\u524D\u5728 outputs \u767B\u8BB0 fixture \u8DEF\u5F84\u3002
+   - \u3010\u6D4B\u8BD5\u81EA\u5305\u542B\u3011\u6D4B\u8BD5**\u4E25\u7981**\u76F4\u63A5 open() \u4E00\u4E2A\u78C1\u76D8\u4E0A\u4E0D\u5B58\u5728\u7684\u6837\u4F8B\u6587\u4EF6\uFF08\u5982 "sample.csv"\uFF09\uFF1B
+     \u5F53\u88AB\u6D4B\u51FD\u6570\u9700\u8981\u6587\u4EF6\u8F93\u5165\u65F6\uFF0C\u5FC5\u987B\u6309\u4F18\u5148\u7EA7\u9009\u62E9\uFF1A
+       (a) \u4F18\u5148\u590D\u7528\u7528\u6237\u6216\u5DE5\u4F5C\u533A\u5DF2\u63D0\u4F9B\u7684\u771F\u5B9E\u6837\u4F8B\uFF0C\u7528 read_file \u8BFB\u53D6\u540E\u590D\u5236/\u5F15\u7528\u5230 tests/fixtures/<name>\uFF1B
+       (b) \u82E5\u662F\u7B2C\u4E09\u65B9/\u884C\u4E1A\u6807\u51C6\u683C\u5F0F\u4E14\u5DE5\u4F5C\u533A\u65E0\u6837\u4F8B\uFF0C\u7528 http_fetch \u83B7\u53D6\u5B98\u65B9\u6587\u6863\u3001\u4E0A\u6E38\u4ED3\u5E93\u6216\u516C\u5F00\u6807\u51C6\u4E2D\u7684\u5C0F\u578B\u53C2\u8003\u6837\u4F8B\uFF0C
+           \u4FDD\u5B58\u5230 tests/fixtures/<name>\uFF0C\u5E76\u5728\u6D4B\u8BD5\u62A5\u544A\u6216\u6CE8\u91CA\u4E2D\u8BB0\u5F55\u6765\u6E90\uFF1B
+       (c) \u53EA\u6709 CSV/JSON/INI \u7B49\u7B80\u5355\u6587\u672C\u683C\u5F0F\uFF0C\u4E14\u80FD\u7ACB\u523B run_tests \u9A8C\u8BC1\u65F6\uFF0C\u624D\u53EF\u5728 pytest tmp_path \u4E2D\u6784\u9020\u6700\u5C0F\u6837\u4F8B\u3002
+     \u7F51\u7EDC\u4E0D\u53EF\u7528\u3001\u7528\u6237\u672A\u63D0\u4F9B\u6837\u4F8B\u4E14\u65E0\u6CD5\u786E\u8BA4\u683C\u5F0F\u6807\u51C6\u65F6\uFF0C\u5E94\u660E\u786E\u62A5\u544A blocker \u8BF7\u6C42\u7528\u6237\u63D0\u4F9B\u6837\u4F8B\u3002
      \u7EDD\u4E0D\u5141\u8BB8\u51FA\u73B0"\u6D4B\u8BD5\u4EE3\u7801\u5F15\u7528\u4E86\u4E00\u4E2A\u8C01\u90FD\u6CA1\u521B\u5EFA\u7684\u6587\u4EF6"\u2014\u2014\u8FD9\u4F1A\u8BA9 Debugger \u53CD\u590D FileNotFoundError \u6B7B\u5FAA\u73AF\u3002
    - \u3010fixture \u8FED\u4EE3\u3011\u5F53\u6D4B\u8BD5\u5DF2\u7ECF\u80FD\u8FD0\u884C\u4F46\u88AB\u6D4B\u51FD\u6570\u62A5"Invalid syntax / Parse error / Malformed"\u7B49\u89E3\u6790\u5931\u8D25\u9519\u8BEF\uFF0C
-     \u8BF4\u660E fixture \u6587\u4EF6\u672C\u8EAB\u683C\u5F0F\u4E0D\u5408\u6CD5\uFF08DBC/CSV/JSON/...\uFF09\uFF0C**\u4E0D\u662F\u88AB\u6D4B\u4EE3\u7801\u7684 bug**\u3002
-     \u5FC5\u987B read_file \u770B\u6E05\u5F53\u524D fixture \u5185\u5BB9 \u2192 write_file \u6309\u76EE\u6807\u683C\u5F0F\u7684\u6700\u5C0F\u5408\u6CD5\u6837\u4F8B**\u6574\u6587\u4EF6\u91CD\u5199** \u2192 \u518D run_tests\u3002
+     \u8BF4\u660E fixture \u6587\u4EF6\u672C\u8EAB\u683C\u5F0F\u4E0D\u5408\u6CD5\uFF0C**\u4E0D\u662F\u88AB\u6D4B\u4EE3\u7801\u7684 bug**\u3002
+     \u5FC5\u987B read_file \u770B\u6E05\u5F53\u524D fixture \u5185\u5BB9\uFF0C\u6309\u6269\u5C55\u540D/\u89E3\u6790\u5E93\u786E\u8BA4\u683C\u5F0F\u6807\u51C6\uFF1B\u4F18\u5148\u4F7F\u7528\u7528\u6237\u6837\u4F8B\u6216 http_fetch \u4E0B\u8F7D\u7684\u6743\u5A01\u53C2\u8003\u6837\u4F8B\uFF0C
+     \u518D write_file \u6574\u6587\u4EF6\u91CD\u5199\u5E76 run_tests\u3002\u590D\u6742\u9886\u57DF\u683C\u5F0F\u8FDE\u7EED\u5931\u8D25\u540E\u5FC5\u987B\u505C\u6B62\u51ED\u8BB0\u5FC6\u751F\u6210\uFF0C\u6539\u4E3A\u8BF7\u6C42\u7528\u6237\u6837\u4F8B\u6216\u7F51\u7EDC\u53C2\u8003\u3002
      \u4E25\u7981\u56E0\u4E3A\u89E3\u6790\u9519\u8BEF\u5C31\u53BB\u6539\u88AB\u6D4B\u6A21\u5757\u3001\u6D4B\u8BD5\u65AD\u8A00\u6216 mock \u6389\u89E3\u6790\u903B\u8F91\u2014\u2014\u5148\u628A fixture \u4FEE\u5BF9\u518D\u8BF4\u3002
 4. \u5F53\u6240\u6709 outputs \u6587\u4EF6\u5747\u5DF2\u751F\u6210\u4E14\u81EA\u68C0\u901A\u8FC7\uFF0C\u628A done \u8BBE\u4E3A true \u4E14 actions \u4E3A\u7A7A\u3002
 5. \u4EFB\u4F55\u9519\u8BEF\u90FD\u901A\u8FC7\u4E0B\u4E00\u8F6E\u7684 actions \u4FEE\u6B63\uFF1B\u4E0D\u8981\u5C1D\u8BD5\u8D8A\u6743\u6216\u634F\u9020\u5DE5\u5177\u3002
@@ -864,8 +1027,8 @@ DEBUG \u53EA\u662F\u8FD0\u884C\u65F6\u5931\u8D25\u56DE\u9000/\u4FEE\u590D\u6A21\
 
 \u6CBF\u7528 Python Planner \u7684\u9636\u6BB5\u6587\u6863\u548C\u540C\u6B65\u6D4B\u8BD5\u8BBE\u8BA1\u89C4\u5219\uFF1A
 - REQUIREMENT_ANALYSIS\uFF1A\`docs/01-requirement-analysis.md\` + \`docs/tests/functional-test-plan.md\`\u3002
-- HIGH_LEVEL_DESIGN\uFF1A\`docs/02-high-level-design.md\` + \`docs/tests/integration-test-plan.md\`\u3002
-- DETAILED_DESIGN\uFF1A\`docs/03-detailed-design.md\` + \`docs/tests/module-test-plan.md\`\u3002
+- HIGH_LEVEL_DESIGN\uFF1A\`docs/02-high-level-design.md\` + \`docs/tests/module-test-plan.md\`\u3002
+- DETAILED_DESIGN\uFF1A\`docs/03-detailed-design.md\` + \`docs/tests/integration-test-plan.md\`\u3002
 - CODE\uFF1A\u5B9E\u73B0\u4EA7\u7269 + \`docs/tests/unit-test-plan.md\`\u3002
 - UNIT_TEST\uFF1A\`docs/05-unit-test.md\`\u3002
 - INTEGRATION_TEST\uFF1A\`docs/06-integration-test.md\`\u3002
@@ -881,6 +1044,7 @@ DETAILED_DESIGN \u5FC5\u987B\u5B9A\u4E49\u6A21\u5757\u5185\u90E8\u5177\u4F53\u52
 2. \u6BCF\u4E2A current/planned implementation phase \u90FD\u5FC5\u987B\u5305\u542B\u5B8C\u6574 8 \u9636\u6BB5 V \u6A21\u578B\u3002
 3. \u6BCF\u4E2A\u5B8F Step \u7684 \`subTasks\` \u6700\u591A\u5D4C\u5957 2 \u5C42\u3002
 4. \u6BCF\u4E2A CODE Step \u5FC5\u987B\u88AB\u540C\u8FED\u4EE3 UNIT_TEST \u8986\u76D6\uFF1BarchitectureModules \u7684 testPaths \u5FC5\u987B\u7531 MODULE_TEST \u4EA7\u51FA\u3002
+   CODE outputs \u53EA\u80FD\u5305\u542B src/ \u4E0B\u7684\u4EA7\u54C1\u6E90\u7801\u6587\u4EF6\u548C docs/tests/unit-test-plan.md\uFF1B\u7981\u6B62\u628A tests/**/*.test.ts \u6216\u5176\u4ED6 tests/** \u6587\u4EF6\u5217\u4E3A CODE outputs\u3002
 5. \u8BBE\u8BA1\u9636\u6BB5\u4E0D\u5F97\u8F93\u51FA src/ \u6216 tests/ \u6587\u4EF6\uFF1BHIGH_LEVEL_DESIGN \u662F\u552F\u4E00\u53EF\u8F93\u51FA \`package.json\` / \`tsconfig.json\` \u7684\u9636\u6BB5\u3002
 6. TypeScript greenfield \u8BA1\u5212\u5FC5\u987B\u4E14\u53EA\u80FD\u6709\u4E00\u4E2A HIGH_LEVEL_DESIGN Step \u8F93\u51FA \`package.json\`\uFF0C\u5E76\u786E\u4FDD one HIGH_LEVEL_DESIGN Step output \`package.json\`\uFF0C\u5305\u542B \`build\`\u3001\`test\`\u3001\u6700\u597D\u8FD8\u6709 \`lint\` \u811A\u672C\u3002
 7. \u672C\u5730 TypeScript \u6E90\u7801\u6A21\u5757\u5FC5\u987B\u4F7F\u7528\u5E26\u663E\u5F0F \`.ts\` \u540E\u7F00\u7684 ESM \u76F8\u5BF9\u5BFC\u5165\uFF1B\u914D\u7F6E \`allowImportingTsExtensions: true\`\uFF0Cbuild/lint \u4F7F\u7528 \`tsc --noEmit\`\u3002\u4EE3\u7801\u5FC5\u987B\u517C\u5BB9 Node \u539F\u751F type stripping\uFF0C\u907F\u514D enum\u3001namespace\u3001\u53C2\u6570\u5C5E\u6027\u7B49\u9700\u8F6C\u8BD1\u8BED\u6CD5\u3002
@@ -889,6 +1053,7 @@ DETAILED_DESIGN \u5FC5\u987B\u5B9A\u4E49\u6A21\u5757\u5185\u90E8\u5177\u4F53\u52
 10. complexityAssessment \u548C implementationPhases \u89C4\u5219\u540C Python\uFF1Asimple=>P1\uFF0Cmoderate => \u81F3\u5C11 P1+P2\uFF0Ccomplex => \u81F3\u5C11 P1+P2+P3\uFF0C\u7528\u6237\u5F3A\u5236\u5206\u9636\u6BB5\u65F6 userForcedPhaseSplit=true\u3002
 11. verificationGate failurePolicy \u5FC5\u987B\u8BF4\u660E\u628A\u5931\u8D25\u65E5\u5FD7\u4F20\u7ED9 Debugger\uFF0C\u56DE\u9000\u5230\u5BF9\u5E94 V \u6A21\u578B\u9636\u6BB5\u5E76\u91CD\u8DD1\u540E\u7EED\u9636\u6BB5\u3002
 12. \u590D\u6742\u9700\u6C42\u8FD4\u56DE architectureModules\uFF1BCODE/MODULE_TEST Step \u53EF\u8986\u76D6\u591A\u4E2A\u6A21\u5757\uFF0C\u4F46\u5FC5\u987B\u5728 subTasks \u4E2D\u5217\u51FA\u6A21\u5757\u7EA7\u5DE5\u4F5C\u3002
+13. TypeScript \u6D4B\u8BD5\u5FC5\u987B\u53EA\u4F7F\u7528 Vitest\u3002Step prompt \u6216 package.json \u4E2D\u7981\u6B62\u8981\u6C42 Jest\u3001ts-jest\u3001@types/jest\u3001ts-node\u3001nodemon\uFF1Bpackage.json \u5FC5\u987B\u4F7F\u7528 "test": "vitest run" \u548C "build": "tsc --noEmit"\u3002
 
 \u8F93\u51FA JSON \u7ED3\u6784\u540C Python\uFF0C\u5FC5\u987B\u5305\u542B \`"projectType": "application | library | mixed"\`\uFF0C\u8DEF\u5F84\u4F7F\u7528 \`src/example.ts\` \u548C \`tests/example.test.ts\`\uFF1B\u7B2C\u4E00\u4E2A Step phase \u5FC5\u987B\u662F \`REQUIREMENT_ANALYSIS\`\uFF0C\u4E0D\u662F \`REQUIREMENT\`\u3002\u4E0D\u5B58\u5728\u547D\u4EE4\u884C project-type \u8986\u76D6\u3002`;
 var TYPESCRIPT_EXECUTOR_SYSTEM2 = `\u4F60\u662F XCompiler \u7684 Step Executor\u3002\u4F60\u53EA\u80FD\u901A\u8FC7 JSON \u5DE5\u5177\u8C03\u7528\u4E0E\u7CFB\u7EDF\u4EA4\u4E92\uFF0C\u7981\u6B62\u4EFB\u4F55 Markdown \u6216\u89E3\u91CA\u6027\u6587\u672C\u3002
@@ -896,6 +1061,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
 }
@@ -908,7 +1074,7 @@ var TYPESCRIPT_EXECUTOR_SYSTEM2 = `\u4F60\u662F XCompiler \u7684 Step Executor\u
    - \u3010\u5BFC\u5165\u7EA6\u5B9A\u3011src/ \u4E0B\u7684\u672C\u5730\u6E90\u7801\u6A21\u5757\u4F7F\u7528\u5E26\u663E\u5F0F ".ts" \u540E\u7F00\u7684 ESM \u76F8\u5BF9\u5BFC\u5165\uFF0C\u4F8B\u5982 \`import { x } from "./util.ts";\`\u3002\u4EE3\u7801\u5FC5\u987B\u517C\u5BB9 Node \u539F\u751F TypeScript type stripping\uFF1A\u53EA\u4F7F\u7528\u53EF\u64E6\u9664\u7C7B\u578B\u8BED\u6CD5\uFF0C\u907F\u514D enum\u3001namespace\u3001\u53C2\u6570\u5C5E\u6027\u7B49\u9700\u8981\u8F6C\u8BD1\u7684 TS \u7279\u6027\u3002\u7981\u6B62\u4F7F\u7528 Python \u98CE\u683C import\u3001\`from src.<module>\` \u6216\u4EFB\u4F55 sys.path hack\u3002
    - \u3010\u6D4B\u8BD5\u7EA6\u5B9A\u3011\u6D4B\u8BD5\u4F7F\u7528 Vitest\uFF1A\`import { describe, it, expect } from "vitest";\`\uFF0C\u6D4B\u8BD5\u6587\u4EF6\u653E\u5728 \`tests/**/*.test.ts\`\u3002
    - \u3010\u6D4B\u8BD5\u81EA\u5305\u542B\u3011\u6D4B\u8BD5**\u4E25\u7981**\u8BFB\u53D6\u4E00\u4E2A\u78C1\u76D8\u4E0A\u4E0D\u5B58\u5728\u7684\u6837\u4F8B\u6587\u4EF6\uFF1B\u5F53\u88AB\u6D4B\u51FD\u6570\u9700\u8981\u6587\u4EF6\u8F93\u5165\u65F6\uFF0C\u8981\u4E48\u5728\u6D4B\u8BD5\u91CC\u6784\u9020\u5185\u5BB9\uFF0C\u8981\u4E48\u5199\u5165 \`tests/fixtures/<name>\`\u3002
-   - \u3010fixture \u8FED\u4EE3\u3011\u5F53\u6D4B\u8BD5\u5DF2\u7ECF\u80FD\u8FD0\u884C\u4F46\u88AB\u6D4B\u51FD\u6570\u62A5"Invalid syntax / Parse error / Malformed"\u7B49\u89E3\u6790\u5931\u8D25\u9519\u8BEF\uFF0C\u8BF4\u660E fixture \u6587\u4EF6\u672C\u8EAB\u683C\u5F0F\u4E0D\u5408\u6CD5\u3002\u5FC5\u987B read_file \u770B\u6E05\u5F53\u524D fixture \u5185\u5BB9 \u2192 write_file \u6309\u76EE\u6807\u683C\u5F0F\u7684\u6700\u5C0F\u5408\u6CD5\u6837\u4F8B\u6574\u6587\u4EF6\u91CD\u5199 \u2192 \u518D run_tests\u3002\u4E25\u7981\u56E0\u4E3A\u89E3\u6790\u9519\u8BEF\u53BB\u5F31\u5316\u5B9E\u73B0\u6216\u65AD\u8A00\u3002
+   - \u3010fixture \u8FED\u4EE3\u3011\u5F53\u6D4B\u8BD5\u5DF2\u7ECF\u80FD\u8FD0\u884C\u4F46\u88AB\u6D4B\u51FD\u6570\u62A5"Invalid syntax / Parse error / Malformed"\u7B49\u89E3\u6790\u5931\u8D25\u9519\u8BEF\uFF0C\u8BF4\u660E fixture \u6587\u4EF6\u672C\u8EAB\u683C\u5F0F\u4E0D\u5408\u6CD5\u3002\u5FC5\u987B read_file \u770B\u6E05\u5F53\u524D fixture \u5185\u5BB9\uFF0C\u4F18\u5148\u4F7F\u7528\u7528\u6237/\u5DE5\u4F5C\u533A\u6837\u4F8B\uFF1B\u6CA1\u6709\u6837\u4F8B\u65F6\u7528 http_fetch \u62C9\u53D6\u6743\u5A01\u516C\u5F00\u53C2\u8003\uFF1B\u53EA\u6709\u7B80\u5355\u6587\u672C\u683C\u5F0F\u624D\u53EF\u6784\u9020\u6700\u5C0F\u6837\u4F8B\u5E76\u7ACB\u5373 run_tests\u3002\u4E25\u7981\u56E0\u4E3A\u89E3\u6790\u9519\u8BEF\u53BB\u5F31\u5316\u5B9E\u73B0\u6216\u65AD\u8A00\uFF0C\u4E5F\u4E25\u7981\u53CD\u590D\u51ED\u8BB0\u5FC6\u751F\u6210\u590D\u6742\u683C\u5F0F fixture\u3002
 4. \u5F53\u6240\u6709 outputs \u6587\u4EF6\u5747\u5DF2\u751F\u6210\u4E14\u81EA\u68C0\u901A\u8FC7\uFF0C\u628A done \u8BBE\u4E3A true \u4E14 actions \u4E3A\u7A7A\u3002
 5. \u4EFB\u4F55\u9519\u8BEF\u90FD\u901A\u8FC7\u4E0B\u4E00\u8F6E\u7684 actions \u4FEE\u6B63\uFF1B\u4E0D\u8981\u5C1D\u8BD5\u8D8A\u6743\u6216\u634F\u9020\u5DE5\u5177\u3002
 6. \u3010\u5927\u6587\u4EF6\u62C6\u5757\u5199\u5165\u3011write_file / append_file \u5355\u6B21 content \u5FC5\u987B\u4F4E\u4E8E\u5DE5\u5177\u6587\u6863\u5C55\u793A\u7684\u5F53\u524D Step \u8FD0\u884C\u65F6 chunk limit\u3002
@@ -921,6 +1087,78 @@ var TYPESCRIPT_EXECUTOR_SYSTEM2 = `\u4F60\u662F XCompiler \u7684 Step Executor\u
 function buildPlannerSystem2(profile) {
   return (profile.id === "typescript" ? TYPESCRIPT_PLANNER_SYSTEM2 : PYTHON_PLANNER_SYSTEM2) + profile.plannerPromptOverride;
 }
+function buildPlannerPhasePlanSystem2(profile) {
+  return `\u4F60\u662F XCompiler \u7CFB\u7EDF\u7684 Planner\uFF0C\u5F53\u524D\u6267\u884C\u201C\u4E24\u7EA7\u89C4\u5212\u201D\u7684\u7B2C\u4E00\u6B65\uFF1APhasePlan\u3002
+
+\u76EE\u6807\u8BED\u8A00\uFF1A${profile.displayName}\u3002
+
+\u53EA\u8F93\u51FA\u9879\u76EE\u7EA7 PhasePlan\uFF0C\u4E0D\u8F93\u51FA steps\u3001architectureModules\u3001dependencies \u6216\u4EFB\u4F55\u5355\u4E2A V \u6A21\u578B Step\u3002
+
+PhasePlan \u5FC5\u987B\u5B8C\u6210\uFF1A
+1. \u5224\u5B9A projectType\uFF1Aapplication / library / mixed\u3002
+2. \u5224\u5B9A complexityAssessment\uFF1Asimple / moderate / complex\uFF0C\u5E76\u8BF4\u660E rationale\u3002
+3. \u751F\u6210 implementationPhases\uFF1AP1 status=current\uFF1B\u540E\u7EED P2/P3 status=planned\u3002simple \u53EA\u9700\u8981 P1\uFF1Bmoderate \u81F3\u5C11 P1+P2\uFF1Bcomplex \u81F3\u5C11 P1+P2+P3\uFF1B\u7528\u6237\u5F3A\u5236\u5206\u9636\u6BB5\u65F6\u81F3\u5C11 P1+P2 \u4E14 userForcedPhaseSplit=true\u3002
+4. \u6BCF\u4E2A phase \u5FC5\u987B\u5305\u542B objective\u3001scope\u3001deliverables\u3001dependsOn \u548C verificationGate\u3002
+5. planned phase \u53EA\u8BB0\u5F55\u76EE\u6807\u548C\u95E8\u7981\uFF0C\u4E0D\u80FD\u5C55\u5F00\u4EFB\u4F55 Step\u3002\u540E\u7EED\u4F1A\u57FA\u4E8E\u5355\u4E2A phase \u53E6\u884C\u751F\u6210\u5B8C\u6574 V \u6A21\u578B\u8BA1\u5212\u3002
+
+\u53EA\u8FD4\u56DE\u4E25\u683C JSON\uFF1A
+{
+  "requirementDigest": "string",
+  "globalPrompt": "string",
+  "projectType": "application | library | mixed",
+  "complexityAssessment": { "level": "simple | moderate | complex", "rationale": "string", "splitRecommended": true, "userForcedPhaseSplit": false },
+  "implementationPhases": [
+    { "id": "P1", "title": "\u6838\u5FC3\u529F\u80FD", "objective": "string", "status": "current", "scope": ["..."], "deliverables": ["..."], "dependsOn": [], "verificationGate": { "summary": "string", "checks": ["..."], "failurePolicy": "Feed failures to Debugger, roll back to the paired V-model phase, and rerun subsequent phases." } }
+  ]
+}
+
+\u7981\u6B62\u8F93\u51FA Markdown\u3001\u89E3\u91CA\u6587\u5B57\u3001steps\u3001src/test \u6587\u4EF6\u6E05\u5355\u3002` + profile.plannerPromptOverride;
+}
+function buildPlannerPhaseDecomposeSystem2(profile) {
+  return `\u4F60\u662F XCompiler \u7CFB\u7EDF\u7684 Planner\uFF0C\u5F53\u524D\u6267\u884C\u201C\u4E24\u7EA7\u89C4\u5212\u201D\u7684\u7B2C\u4E8C\u6B65\uFF1A\u4E3A\u6307\u5B9A phase \u751F\u6210\u5B8C\u6574 V \u6A21\u578B StepPlan\u3002
+
+\u76EE\u6807\u8BED\u8A00\uFF1A${profile.displayName}\u3002
+
+\u4F60\u4F1A\u6536\u5230\u5DF2\u7ECF\u51BB\u7ED3\u7684 PhasePlan \u548C\u4E00\u4E2A phaseId\u3002\u53EA\u5141\u8BB8\u4E3A\u8BE5 phaseId \u751F\u6210 Step\uFF1Bplanned phase \u4E0D\u5F97\u5C55\u5F00\u5230\u672C\u6B21 steps \u4E2D\u3002
+
+\u6BCF\u4E2A\u5F53\u524D phase \u5FC5\u987B\u4F7F\u7528\u5B8C\u6574\u6807\u51C6 V \u6A21\u578B\uFF1A
+REQUIREMENT_ANALYSIS -> HIGH_LEVEL_DESIGN -> DETAILED_DESIGN -> CODE -> UNIT_TEST -> INTEGRATION_TEST -> MODULE_TEST -> FUNCTIONAL_TEST\u3002
+
+\u9636\u6BB5\u804C\u8D23\uFF1A
+- REQUIREMENT_ANALYSIS \u5B9A\u4E49\u529F\u80FD\u8303\u56F4\u3001\u9A8C\u6536\u6807\u51C6\u3001\u8FB9\u754C\u6761\u4EF6\u548C\u7528\u6237\u53EF\u89C1\u884C\u4E3A\uFF0C\u5E76\u540C\u6B65\u8F93\u51FA\u529F\u80FD\u6D4B\u8BD5\u8BA1\u5212\u3002
+- HIGH_LEVEL_DESIGN \u5B9A\u4E49\u7CFB\u7EDF\u5B9A\u4F4D\u3001\u5916\u90E8\u63A5\u53E3\u3001\u7B2C\u4E09\u65B9\u5E93\u9009\u578B\u3001\u4F9D\u8D56\u786E\u8BA4\u548C\u96C6\u6210\u8FB9\u754C\uFF0C\u5E76\u540C\u6B65\u8F93\u51FA\u96C6\u6210\u6D4B\u8BD5\u8BA1\u5212\u3002
+- DETAILED_DESIGN \u5B9A\u4E49\u6A21\u5757\u5185\u90E8\u51FD\u6570/\u7C7B\u3001\u6570\u636E\u7ED3\u6784\u3001\u7B97\u6CD5\u3001\u63A7\u5236\u6D41\u3001\u9519\u8BEF\u5904\u7406\u548C\u5185\u90E8\u67B6\u6784\uFF0C\u5E76\u540C\u6B65\u8F93\u51FA\u6A21\u5757\u6D4B\u8BD5\u8BA1\u5212\u3002
+- CODE \u53EA\u5B9E\u73B0\u5F53\u524D phase \u8303\u56F4\u5E76\u540C\u6B65\u8F93\u51FA\u5355\u5143\u6D4B\u8BD5\u8BA1\u5212\u3002
+- UNIT_TEST / INTEGRATION_TEST / MODULE_TEST / FUNCTIONAL_TEST \u5206\u522B\u9A8C\u8BC1\u5BF9\u5E94\u5DE6\u4FA7\u9636\u6BB5\u3002
+
+\u4E25\u683C\u4EA7\u7269\u5F52\u5C5E\uFF1A
+- CODE outputs \u53EA\u80FD\u5305\u542B src/ \u4E0B\u7684\u4EA7\u54C1\u6E90\u7801\u6587\u4EF6\u548C\u5355\u5143\u6D4B\u8BD5\u8BA1\u5212\u6587\u6863\uFF1B\u4E0D\u5F97\u628A tests/** \u6587\u4EF6\u653E\u5230 CODE outputs\u3002
+- UNIT_TEST \u62E5\u6709\u5355\u5143\u6D4B\u8BD5\u6587\u4EF6\uFF1BINTEGRATION_TEST \u62E5\u6709\u96C6\u6210\u6D4B\u8BD5\u6587\u4EF6\uFF1BMODULE_TEST \u62E5\u6709 architectureModules.testPaths\uFF1BFUNCTIONAL_TEST \u62E5\u6709\u7AEF\u5230\u7AEF/\u529F\u80FD\u6D4B\u8BD5\u6587\u4EF6\u548C\u4EA4\u4ED8\u6587\u6863\u3002
+- TypeScript greenfield \u5FC5\u987B\u4E14\u53EA\u80FD\u6709\u4E00\u4E2A HIGH_LEVEL_DESIGN Step \u8F93\u51FA package.json\uFF0C\u5305\u542B scripts\u3001dependencies\u3001devDependencies\u3002CODE \u4E0D\u5F97\u8F93\u51FA package.json\u3002
+- TypeScript package.json \u53EA\u80FD\u4F7F\u7528 Vitest\uFF1A"test": "vitest run"\uFF0C"build": "tsc --noEmit"\uFF0CdevDependencies \u5305\u542B typescript/tsx/vitest/@types/node\u3002\u7981\u6B62\u63D0\u53CA\u6216\u8981\u6C42 Jest\u3001ts-jest\u3001@types/jest\u3001ts-node\u3001nodemon\u3002
+
+\u8F93\u51FA\u5FC5\u987B\u53EA\u5305\u542B\u5F53\u524D phase \u7684 dependencies\u3001architectureModules \u548C steps\u3002\u590D\u6742/\u591A\u5173\u6CE8\u70B9\u4EFB\u52A1\u5FC5\u987B\u7528 architectureModules \u8868\u8FBE\u5F53\u524D phase \u7684\u6A21\u5757\u8FB9\u754C\uFF0C\u5E76\u5728 CODE/MODULE_TEST \u7684 subTasks \u4E2D\u6620\u5C04\u6A21\u5757\u7EA7\u5DE5\u4F5C\u3002\u6BCF\u4E2A Step \u7684 subTasks \u6700\u591A\u5D4C\u5957 2 \u5C42\u3002
+
+architectureModules \u53EA\u80FD\u63CF\u8FF0\u5F53\u524D phase \u7684\u4EA7\u54C1/\u4E1A\u52A1\u6E90\u7801\u6A21\u5757\uFF1A
+- sourcePaths \u5FC5\u987B\u662F src/ \u4E0B\u7684\u76EE\u6807\u8BED\u8A00\u6E90\u7801\u6587\u4EF6\uFF0C\u4E0D\u80FD\u662F\u76EE\u5F55\uFF0C\u4E0D\u80FD\u662F tests/\u3001docs/\u3001README\u3001fixtures\u3001utils \u6216\u62A5\u544A\u6587\u4EF6\u3002
+- testPaths \u5FC5\u987B\u662F tests/ \u4E0B\u7684\u76EE\u6807\u8BED\u8A00\u6D4B\u8BD5\u6587\u4EF6\uFF0C\u4E0D\u80FD\u662F\u76EE\u5F55\u3002
+- \u6D4B\u8BD5 fixtures\u3001\u6D4B\u8BD5\u5DE5\u5177\u3001\u9886\u57DF\u6837\u4F8B\u8F93\u5165\u3001\u4E34\u65F6\u8F93\u51FA\u6587\u4EF6\u5E94\u653E\u5728\u5BF9\u5E94\u6D4B\u8BD5 Step \u7684 outputs \u6216 subTasks \u4E2D\uFF0C\u4E0D\u5F97\u767B\u8BB0\u4E3A architectureModules\u3002
+
+\u53EA\u8FD4\u56DE\u4E25\u683C JSON\uFF1A
+{
+  "requirementDigest": "string",
+  "globalPrompt": "string",
+  "dependencies": ["pytest"],
+  "architectureModules": [
+    { "id": "M001", "name": "\u6A21\u5757\u540D", "responsibility": "\u5355\u4E00\u660E\u786E\u804C\u8D23", "sourcePaths": ["src/example.py"], "testPaths": ["tests/test_example.py"], "dependencies": [] }
+  ],
+  "steps": [
+    { "id": "S001", "iterationId": "P1", "phase": "REQUIREMENT_ANALYSIS", "title": "string", "description": "string", "systemPrompt": "\u8303\u56F4\u3001\u8F93\u5165\u3001\u4EA7\u51FA\u3001\u9A8C\u6536\u3001\u7981\u4EE4", "role": "Planner", "tools": ["write_file"], "inputs": ["docs/topic.md"], "outputs": ["docs/01-requirement-analysis.md", "docs/tests/functional-test-plan.md"], "subTasks": [], "dependsOn": [], "acceptance": "string", "maxRetries": 3 }
+  ]
+}
+
+\u7981\u6B62\u8F93\u51FA\u672A\u6765 planned phase \u7684 Step\uFF1B\u7981\u6B62\u8F93\u51FA requirements.txt\uFF1B\u7981\u6B62\u8BA9\u9700\u6C42/\u8BBE\u8BA1\u9636\u6BB5\u5199 src/tests\uFF1BFUNCTIONAL_TEST \u5FC5\u987B\u5305\u542B README.md\u3001docs/quickstart.md \u548C\u529F\u80FD\u9A8C\u6536\u6587\u6863\u3002` + profile.plannerPromptOverride;
+}
 function buildExecutorSystem2(profile) {
   return (profile.id === "typescript" ? TYPESCRIPT_EXECUTOR_SYSTEM2 : PYTHON_EXECUTOR_SYSTEM2) + profile.executorPromptOverride;
 }
@@ -937,13 +1175,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\u5931\u8D25 -0.5\uFF08\u4E0B\u9650 0=\u7981\u7528\uFF09\uFF1B\u6210\u529F +0.1\uFF08\u4E0A\u9650 10\uFF09\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}`,
@@ -1022,34 +1260,35 @@ var messages2 = {
   },
   cli: {
     rootDescription: "XCompiler \u2014 AI Software Factory CLI",
-    compileDescription: "\u4EA4\u4E92\u5F0F\u7F16\u8BD1\u9700\u6C42\u4E3A plan.json\uFF08\u542B\u5F3A\u5236\u4EBA\u5DE5\u786E\u8BA4\uFF09",
-    runDescription: "\u6267\u884C\u5DF2\u786E\u8BA4\u7684 plan.json\uFF08\u652F\u6301\u5206\u9636\u6BB5\u8FD0\u884C\uFF1A--phase / --from\uFF09",
+    compileDescription: "\u4EA4\u4E92\u5F0F\u7F16\u8BD1\u9700\u6C42\u4E3A phasePlan.json \u4E0E\u5F53\u524D\u9636\u6BB5\u8BA1\u5212\uFF08\u542B\u5F3A\u5236\u4EBA\u5DE5\u786E\u8BA4\uFF09",
+    runDescription: "\u6267\u884C\u5DF2\u786E\u8BA4\u7684 phasePlan.json\uFF08\u652F\u6301\u5206\u9636\u6BB5\u8FD0\u884C\uFF1A--phase / --from\uFF09",
     loadDescription: "\u52A0\u8F7D XXX.xc \u5DE5\u7A0B\u6587\u4EF6\u5E76\u7EE7\u7EED\u5F53\u524D plan",
     appendDescription: "\u5728\u5DF2\u6709 XXX.xc \u5DE5\u7A0B\u57FA\u7840\u4E0A\u8FFD\u52A0\u65B0\u9700\u6C42\uFF0C\u5E76\u91CD\u65B0\u8D70\u6F84\u6E05\u4E0E V \u6A21\u578B\u6267\u884C",
-    lsDescription: "\u626B\u63CF workspace \u5217\u51FA\u6240\u6709 plan.json \u72B6\u6001\u6458\u8981",
+    lsDescription: "\u626B\u63CF workspace \u5217\u51FA\u6240\u6709 phasePlan.json / \u5386\u53F2 plan.json \u72B6\u6001\u6458\u8981",
     showDescription: "\u6253\u5370 Step \u5B9A\u4E49 / \u72B6\u6001 / \u4EA7\u7269 / \u6700\u8FD1\u5BA1\u8BA1",
     optWorkspace: "workspace \u76EE\u5F55\uFF08\u540C --output\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u76EE\u5F55\uFF09",
     optOutput: "\u5DE5\u7A0B/workspace \u8F93\u51FA\u76EE\u5F55\uFF08\u4F18\u5148\u7EA7\u6700\u9AD8\uFF0C\u7B49\u4EF7\u4E8E -w\uFF09",
     optConfig: "config.yaml \u8DEF\u5F84",
     optInput: "\u4ECE\u9700\u6C42\u6587\u4EF6\u8BFB\u53D6\uFF08\u975E\u4EA4\u4E92\uFF09",
     optTopic: "\u76F4\u63A5\u4F7F\u7528\u5DF2\u6F84\u6E05\u7684 topic.md \u4F5C\u4E3A\u8F93\u5165\uFF1A\u8DF3\u8FC7 intake / clarify / Addenda / Gate 1\uFF0C\u76F4\u63A5\u8FDB\u5165 decompose",
-    optPlanOut: "\u6307\u5B9A plan.json \u8F93\u51FA\u6587\u4EF6\uFF08\u9ED8\u8BA4 <workspace>/plan.json\uFF09",
+    optPlanOut: "\u6307\u5B9A phasePlan.json \u8F93\u51FA\u6587\u4EF6\uFF08\u9ED8\u8BA4 <workspace>/phasePlan.json\uFF09",
     optBaseDir: "\u9879\u76EE\u8F93\u51FA\u6839\u76EE\u5F55\uFF08\u5728\u5176\u4E0B\u521B\u5EFA <name> \u5B50\u76EE\u5F55\uFF09",
     optName: "\u9879\u76EE\u540D\uFF08\u9ED8\u8BA4 xcompiler-<\u65F6\u95F4\u6233>\uFF09",
     optYes: "\u8DF3\u8FC7\u4EBA\u5DE5\u786E\u8BA4\uFF08\u4EC5\u5728 -i / -t \u63D0\u4F9B\u65F6\u6709\u610F\u4E49\uFF09",
-    optForce: "\u5F3A\u5236\u91CD\u65B0\u751F\u6210\uFF1A\u8986\u5199 workspace \u9501\u3001\u5FFD\u7565\u65E7 plan.json",
+    optForce: "\u5F3A\u5236\u91CD\u65B0\u751F\u6210\uFF1A\u8986\u5199 workspace \u9501\u3001\u5FFD\u7565\u65E7\u8BA1\u5212\u6587\u4EF6",
     optDryRun: "\u4EC5\u6253\u5370\u62D3\u6251\u987A\u5E8F\uFF0C\u4E0D\u6267\u884C",
     optFrom: "\u4ECE\u6307\u5B9A Step \u5F00\u59CB\uFF08\u4E4B\u524D\u7684\u8DF3\u8FC7\uFF09",
     optPhase: "\u4EC5\u6267\u884C\u6307\u5B9A phase\uFF08REQUIREMENT_ANALYSIS/HIGH_LEVEL_DESIGN/DETAILED_DESIGN/CODE/UNIT_TEST/INTEGRATION_TEST/MODULE_TEST/FUNCTIONAL_TEST/DEBUG\uFF09",
     optReset: "\u91CD\u7F6E\u6240\u6709 Step \u72B6\u6001\u4E3A PENDING",
     optMaxDepth: "\u9012\u5F52\u6700\u5927\u6DF1\u5EA6",
     optTail: "\u6700\u8FD1\u5BA1\u8BA1\u6761\u6570",
-    optPlan: "plan.json \u8DEF\u5F84\uFF0C\u9ED8\u8BA4 <workspace>/plan.json",
+    optPlan: "phasePlan.json \u8DEF\u5F84\uFF0C\u9ED8\u8BA4 <workspace>/phasePlan.json",
     optLang: "UI / \u63D0\u793A\u8BCD\u8BED\u8A00\uFF1AEN | CN\uFF08ISO 3166-1 Alpha-2\uFF09",
     optIntent: "\u8BA1\u5212\u610F\u56FE\uFF1Agreenfield | feature | refactor | self",
-    optBaselinePlan: "\u5DF2\u6709\u57FA\u7EBF plan.json \u8DEF\u5F84\uFF08\u9ED8\u8BA4 <workspace>/plan.json\uFF09",
+    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",
-    argPlan: "plan.json \u8DEF\u5F84\uFF08\u9ED8\u8BA4 = <workspace>/plan.json\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",
     evolveDescription: "\u5728\u73B0\u6709 workspace \u57FA\u7840\u4E0A\u751F\u6210\u5E76\u6267\u884C\u589E\u91CF feature/refactor \u8BA1\u5212",
@@ -1127,7 +1366,7 @@ var messages2 = {
     auditDecomposeFailed: "planner.decompose \u5931\u8D25",
     lintIssue: (id, message) => ` - [${id}] ${message}`,
     planPreviewTruncated: "\u2026\uFF08\u5DF2\u622A\u65AD\uFF0C\u5B8C\u6574\u5185\u5BB9\u89C1 docs/plan.md\uFF09",
-    auditPlanPersisted: (p) => `plan.json \u5DF2\u5199\u5165\uFF1A${p}`,
+    auditPlanPersisted: (p) => `\u9636\u6BB5 plan \u5DF2\u5199\u5165\uFF1A${p}`,
     projectFileWritten: (p) => `\u5DE5\u7A0B\u6587\u4EF6\u5DF2\u66F4\u65B0\uFF1A${p}`,
     nextCommand: (command) => `  \u4E0B\u4E00\u6B65\uFF1A${command}`,
     topicEmptyExit: "--topic \u6587\u4EF6\u4E3A\u7A7A\uFF0C\u5DF2\u9000\u51FA\u3002",
@@ -1144,8 +1383,10 @@ var messages2 = {
     spinDecompose: "Planner \u6B63\u5728\u6309 V \u6A21\u578B\u62C6\u89E3\u2026",
     decomposeFail: "Planner \u62C6\u89E3\u5931\u8D25",
     plannerInvalidPlan: "Planner \u65E0\u6CD5\u751F\u6210\u6709\u6548 plan\uFF1A",
-    plannerInvalidPlanHint1: "  \u5E38\u89C1\u539F\u56E0\uFF1A\u6240\u6709 LLM provider \u90FD\u8FD4\u56DE\u4E86\u975E\u6CD5/\u622A\u65AD JSON\uFF08\u5982 token loop\uFF09\u3002",
-    plannerInvalidPlanHint2: "  \u6392\u67E5\uFF1A\u68C0\u67E5 .xcompiler/audit.jsonl \u4E2D\u7684 llm.error / planner.thought \u539F\u6587\u3002",
+    plannerInvalidPlanHint1: "  \u5E38\u89C1\u539F\u56E0\uFF1ALLM \u8F93\u51FA\u672A\u6EE1\u8DB3 XCompiler \u8BA1\u5212 schema\u3001V \u6A21\u578B\u9AA8\u67B6\u6216\u67B6\u6784\u5951\u7EA6\uFF1B\u4E0D\u80FD\u8DF3\u8FC7\u8BE5\u9519\u8BEF\u3002",
+    plannerInvalidPlanHint2: "  \u6392\u67E5\uFF1A\u68C0\u67E5 .xcompiler/audit.jsonl \u4E2D\u7684 llm.error / planner.thought \u539F\u6587\uFF0C\u6309\u5951\u7EA6\u9519\u8BEF\u4FEE\u6B63 Planner \u8F93\u51FA\u3002",
+    plannerTransportFailureHint1: "  \u5E38\u89C1\u539F\u56E0\uFF1ALLM provider \u8FDE\u63A5\u5931\u8D25\u3001\u8BF7\u6C42\u8D85\u65F6\u6216\u670D\u52A1\u7AEF\u4E2D\u65AD\uFF1B\u8FD9\u4E0D\u662F\u9879\u76EE plan/\u6E90\u7801\u7F3A\u9677\u3002",
+    plannerTransportFailureHint2: "  \u6392\u67E5\uFF1A\u68C0\u67E5 OPENAI_BASE_URL / provider base_url\u3001\u6A21\u578B\u670D\u52A1\u662F\u5426\u53EF\u8FBE\u3001\u7F51\u7EDC\u6743\u9650\u548C\u8D85\u65F6\u8BBE\u7F6E\uFF0C\u7136\u540E\u91CD\u8DD1 build\u3002",
     decomposeSucceed: (n) => `\u5DF2\u751F\u6210 ${n} \u4E2A Step`,
     schemaFail: "Plan schema \u6821\u9A8C\u5931\u8D25\uFF1A",
     schemaInvalidSavedAt: (p) => `  \u5B8C\u6574 plan \u5DF2\u843D\u76D8\uFF1A${p}`,
@@ -1160,12 +1401,13 @@ var messages2 = {
     gate1Cancelled: "\u5DF2\u53D6\u6D88\uFF0C\u672A\u5199\u5165\u4EFB\u4F55\u6587\u4EF6\u3002",
     editTopicMsg: "\u7F16\u8F91 topic.md",
     topicWritten: (p) => `\u5DF2\u5199\u5165 ${p}`,
-    planWritten: (p) => `plan \u5DF2\u5199\u5165 ${p}`,
+    planWritten: (p) => `\u9636\u6BB5 plan \u5DF2\u5199\u5165 ${p}`,
+    phasePlanWritten: (p) => `phasePlan \u5DF2\u5199\u5165 ${p}`,
     planPreviewHeader: "\u2500\u2500\u2500 plan.md (preview) \u2500\u2500\u2500",
     planPreviewFooter: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    gate2Confirm: "\u662F\u5426\u786E\u8BA4\u8BE5\u8BA1\u5212? (\u6B64\u4E3A\u6700\u7EC8\u786E\u8BA4\uFF0C\u786E\u8BA4\u540E\u5C06\u5199\u5165 plan.json)",
+    gate2Confirm: "\u662F\u5426\u786E\u8BA4\u8BE5\u8BA1\u5212? (\u6B64\u4E3A\u6700\u7EC8\u786E\u8BA4\uFF0C\u786E\u8BA4\u540E\u5C06\u5199\u5165 phasePlan.json \u548C\u5F53\u524D\u9636\u6BB5\u8BA1\u5212)",
     gate2AuditLabel: "\u8BA1\u5212\u786E\u8BA4\u95E8 (Gate 2)",
-    gate2Rejected: "\u672A\u786E\u8BA4\uFF0C\u5DF2\u653E\u5F03\u3002plan.json \u672A\u5199\u5165\u3002",
+    gate2Rejected: "\u672A\u786E\u8BA4\uFF0C\u5DF2\u653E\u5F03\u3002phasePlan.json \u672A\u5199\u5165\u3002",
     baselineLoaded: (kind, sources) => `\u5DF2\u52A0\u8F7D ${kind} \u57FA\u7EBF\uFF1A${sources}`,
     baselineMissing: (workspace) => `\u589E\u91CF\u6A21\u5F0F\u9700\u8981\u5728 ${workspace} \u4E2D\u627E\u5230\u5DF2\u6709\u5DE5\u7A0B\u57FA\u7EBF\uFF08topic / docs / plan / src\uFF09\u3002`,
     baselineLanguageOverride: (baseline, source, configured) => `\u589E\u91CF\u6A21\u5F0F\u5C06\u6CBF\u7528\u57FA\u7EBF\u8BED\u8A00 ${baseline}\uFF08\u6765\u6E90\uFF1A${source}\uFF09\uFF0C\u800C\u4E0D\u662F\u914D\u7F6E\u4E2D\u7684 ${configured}\u3002`,
@@ -1177,7 +1419,7 @@ var messages2 = {
     topicSecBaseline: "## \u73B0\u6709\u5DE5\u7A0B\u57FA\u7EBF"
   },
   inspect: {
-    noPlanFound: "\u672A\u627E\u5230\u4EFB\u4F55 plan.json",
+    noPlanFound: "\u672A\u627E\u5230\u4EFB\u4F55 phasePlan.json / plan.json",
     digestLabel: "digest:",
     stepNotFound: (id) => `Step ${id} \u672A\u627E\u5230`,
     secDescription: "\u2014 description \u2014",
@@ -1202,7 +1444,7 @@ var messages2 = {
     auditPlanLoaded: (p) => `\u5DF2\u52A0\u8F7D plan\uFF1A${p}`,
     planLoaded: (p) => `\u5DF2\u52A0\u8F7D Plan\uFF1A${p}`,
     planSummary: (language, steps) => `  \u8BED\u8A00=${language}\uFF0C\u6B65\u9AA4=${steps}`,
-    preflightModelMissing: (names) => `LLM preflight: \u6A21\u578B\u7F3A\u5931\uFF0C\u5DF2\u7981\u7528 [${names}]`,
+    preflightModelMissing: (names) => `LLM preflight: \u6A21\u578B\u7F3A\u5931\uFF0C\u5F53\u524D\u8FD0\u884C\u5DF2\u8DF3\u8FC7 [${names}]\uFF0C\u5E76\u5C06\u52A8\u6001\u8BC4\u5206\u964D\u5230\u6700\u4F4E\u503C`,
     preflightAutoAdded: (n) => `LLM preflight: \u81EA\u52A8\u6CE8\u5165 ${n} \u4E2A provider\uFF08\u6765\u81EA ollama /api/tags\uFF09`,
     runInterrupted: (id, e, total) => `\u6267\u884C\u4E2D\u65AD\u4E8E ${id}\uFF08\u5DF2\u6267\u884C ${e}/${total}\uFF09`,
     runReasonLabel: "  \u539F\u56E0: ",
@@ -1258,7 +1500,7 @@ var messages2 = {
     archGateInstruction: (p) => `\u8BF7\u66F4\u65B0 ${p}\uFF0C\u786E\u4FDD\u6BCF\u4E2A architectureModules \u9879\u5728\u8FDB\u5165 CODE \u524D\u5747\u53EF\u8FFD\u8E2A\u3002`,
     testGateReason: (exitCode, timedOut) => `\u6D4B\u8BD5\u95E8\u7981\uFF1A\u6D4B\u8BD5\u9000\u51FA\u7801=${exitCode}${timedOut ? "\uFF08\u8D85\u65F6\uFF09" : ""}`,
     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 \u6216 src/<package>/__main__.py",
+    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: (path2) => `Python \u5165\u53E3\u6E90\u7801\u65E0\u6548\uFF1A${path2} \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`,
@@ -1296,6 +1538,8 @@ var messages2 = {
   },
   prompts: {
     plannerSystem: (p) => buildPlannerSystem2(p),
+    plannerPhasePlanSystem: (p) => buildPlannerPhasePlanSystem2(p),
+    plannerPhaseDecomposeSystem: (p) => buildPlannerPhaseDecomposeSystem2(p),
     plannerSelfMode: `\u81EA\u4E3E\u6A21\u5F0F\u8986\u76D6\u89C4\u5219\uFF08\u4F18\u5148\u7EA7\u9AD8\u4E8E\u4E0A\u65B9\u4E0E\u4E4B\u51B2\u7A81\u7684 greenfield \u89C4\u5219\uFF09\uFF1A
 - \u76EE\u6807\u662F\u73B0\u6709 XCompiler \u4ED3\u5E93\u3002\u9664\u975E\u9700\u6C42\u660E\u786E\u8981\u6C42\u4FEE\u6539\uFF0C\u5426\u5219\u5FC5\u987B\u4FDD\u7559\u5F53\u524D package.json\u3001tsconfig\u3001bin\u3001CLI \u5165\u53E3\u3001\u6A21\u5757\u7ED3\u6784\u3001\u516C\u5171\u5BFC\u51FA\u548C\u8BBE\u8BA1\u6587\u6863\u3002
 - \u4E0D\u5F97\u4E3A\u4E86\u6EE1\u8DB3\u65B0\u5EFA\u5DE5\u7A0B\u5165\u53E3\u7EA6\u5B9A\u800C\u521B\u5EFA src/main.ts\uFF1B\u5FC5\u987B\u590D\u7528\u73B0\u6709 package.json \u58F0\u660E\u7684\u5165\u53E3\u3002
@@ -1303,7 +1547,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
 
 """
@@ -1321,18 +1565,20 @@ ${raw}
 - \u81F3\u5C11 1 \u4E2A quality\uFF1A\u8BE2\u95EE\u53EF\u91CF\u5316\u7684\u6027\u80FD\u3001\u5BB9\u91CF\u3001\u5E76\u53D1\u3001\u65F6\u5EF6\u3001\u51C6\u786E\u6027\u3001\u53EF\u9760\u6027\u6216\u5B89\u5168\u6307\u6807\uFF1B\u4E0D\u8981\u53EA\u95EE\u201C\u6027\u80FD\u6709\u4EC0\u4E48\u8981\u6C42\u201D\u3002
 - \u81F3\u5C11 1 \u4E2A extensibility\uFF1A\u8BE2\u95EE\u6700\u53EF\u80FD\u65B0\u589E\u7684\u4E1A\u52A1\u80FD\u529B\u3001\u6269\u5C55\u7EF4\u5EA6\u6216\u9700\u8981\u7A33\u5B9A\u4FDD\u7559\u7684\u63A5\u53E3\uFF0C\u4E0D\u8981\u6CDB\u95EE\u201C\u662F\u5426\u9700\u8981\u6269\u5C55\u6027\u201D\u3002
 - \u5982\u679C\u4EA4\u4ED8\u5F62\u6001\u4E0D\u660E\u786E\uFF0C\u5FC5\u987B\u5305\u542B 1 \u4E2A boundary \u95EE\u9898\uFF0C\u786E\u8BA4\u672C\u9879\u76EE\u5E94\u662F API library/SDK/\u8F6F\u4EF6\u5305\u3001\u53EF\u8FD0\u884C\u5E94\u7528/CLI/\u670D\u52A1\uFF0C\u8FD8\u662F\u4E8C\u8005\u517C\u5177\u7684 mixed \u4EA4\u4ED8\u3002
+- \u5982\u679C\u9700\u6C42\u9700\u8981\u8BBF\u95EE\u5916\u90E8 API/URL/\u7B2C\u4E09\u65B9\u6570\u636E\u6E90\uFF0C\u5FC5\u987B\u5305\u542B 1 \u4E2A data \u6216 boundary \u95EE\u9898\uFF0C\u786E\u8BA4\u7528\u6237\u662F\u5426\u5DF2\u6709\u53EF\u7528 API\u3001key\u3001token \u6216\u9274\u6743\u65B9\u5F0F\uFF1B\u82E5\u7528\u6237\u6CA1\u6709\u51ED\u8BC1\uFF0C\u672C\u671F\u9ED8\u8BA4\u4F18\u5148\u9009\u62E9\u516C\u5F00\u3001\u514D key/token\u3001\u53EF\u9A8C\u8BC1\u7684\u63A5\u53E3\uFF0C\u4E0D\u8981\u751F\u6210\u5360\u4F4D URL\u3002
 - \u6309\u963B\u585E\u7A0B\u5EA6\u6392\u5E8F\uFF1A\u5148\u95EE\u4F1A\u6539\u53D8\u6838\u5FC3\u529F\u80FD/\u6570\u636E\u6A21\u578B\u7684\u95EE\u9898\uFF0C\u518D\u95EE\u8303\u56F4\u4E0E\u8D28\u91CF\uFF0C\u6700\u540E\u95EE\u672A\u6765\u6269\u5C55\u3002
 - \u4E00\u9898\u53EA\u5305\u542B\u4E00\u4E2A\u4E3B\u8981\u51B3\u7B56\uFF0C\u7ED9\u51FA\u5FC5\u8981\u7684\u4E1A\u52A1\u9009\u9879\u6216\u793A\u4F8B\uFF0C\u7981\u6B62\u628A\u591A\u4E2A\u65E0\u5173\u95EE\u9898\u7528\u201C\u4EE5\u53CA/\u6216\u8005\u201D\u62FC\u6210\u4E00\u9898\u3002
 - \u6BCF\u4E2A\u95EE\u9898\u90FD\u5FC5\u987B\u9884\u751F\u6210 2-5 \u4E2A\u53EF\u884C\u56DE\u7B54\u8BBE\u5B9A\uFF0C\u6309\u4F18\u5148\u7EA7\u6392\u5E8F\u3002\u9009\u9879\u6570\u91CF\u4E0D\u662F\u56FA\u5B9A\u503C\uFF1A\u4E8C\u9009\u4E00\u573A\u666F\u7528 2 \u4E2A\uFF0C\u5E38\u89C1\u9ED8\u8BA4\u8BBE\u5B9A\u7528 3 \u4E2A\uFF0C\u53EA\u6709\u786E\u5B9E\u5B58\u5728 4-5 \u4E2A\u5F7C\u6B64\u4E0D\u540C\u7684\u53EF\u884C\u8BBE\u5B9A\u65F6\u624D\u751F\u6210 4-5 \u4E2A\uFF1B\u4E0D\u8981\u586B\u5145\u6216\u5F3A\u5236\u6BCF\u9898\u90FD\u662F 3 \u4E2A\u9009\u9879\u3002
 - \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
 """
@@ -1364,11 +1610,77 @@ ${opts.baseline || "\uFF08\u7F3A\u5C11\u57FA\u7EBF\u6458\u8981\uFF09"}
 - \u5982\u679C\u57FA\u7EBF\u91CC\u5DF2\u7ECF\u5B58\u5728\u76F8\u5173\u6587\u4EF6\uFF0C\u4F18\u5148\u5728\u539F\u6A21\u5757\u4E0A\u6269\u5C55/\u91CD\u6784\uFF0C\u4E0D\u8981\u65B0\u9020\u4E00\u5957\u884C\u4E3A\u91CD\u590D\u7684\u5F71\u5B50\u5B9E\u73B0\u3002
 
 \u8BF7\u6309\u7CFB\u7EDF\u89C4\u5219\u8F93\u51FA\u4E25\u683C JSON \u8BA1\u5212\u3002`,
+    plannerPhasePlan: (raw, qa, addenda, opts = {}) => `\u539F\u59CB\u9700\u6C42\uFF1A
+"""
+${raw}
+"""
+
+\u6F84\u6E05\u95EE\u7B54\uFF1A
+${qa || "\uFF08\u65E0\uFF09"}
+
+${addenda ? `\u7528\u6237\u8865\u5145\u9700\u6C42\uFF08\u9700\u4E25\u683C\u9075\u5B88\uFF0C\u4F18\u5148\u7EA7\u9AD8\u4E8E\u539F\u59CB\u63CF\u8FF0\u4E2D\u6A21\u7CCA\u7684\u90E8\u5206\uFF09\uFF1A
+"""
+${addenda}
+"""
+
+` : ""}${opts.intent && opts.intent !== "greenfield" ? `\u589E\u91CF\u610F\u56FE\uFF1A${opts.intent}
+
+\u8BF7\u5728\u73B0\u6709\u5DE5\u7A0B\u57FA\u7840\u4E0A\u751F\u6210 PhasePlan\uFF0C\u4F18\u5148\u590D\u7528\u5F53\u524D\u67B6\u6784\u3001\u6587\u4EF6\u3001\u6D4B\u8BD5\u4E0E\u4F9D\u8D56\u3002\u9664\u672C\u6B21\u9700\u6C42\u6D89\u53CA\u7684\u8303\u56F4\u5916\uFF0C\u9ED8\u8BA4\u4FDD\u6301\u65E2\u6709\u884C\u4E3A\u4E0D\u53D8\u3002
+
+\u73B0\u6709\u5DE5\u7A0B\u57FA\u7EBF\uFF1A
+"""
+${opts.baseline || "\uFF08\u7F3A\u5C11\u57FA\u7EBF\u6458\u8981\uFF09"}
+"""
+
+` : ""}\u8BF7\u5148\u53EA\u751F\u6210\u5927\u7684 PhasePlan\uFF1A
+- \u8BC4\u4F30\u9879\u76EE\u590D\u6742\u5EA6\u5E76\u51B3\u5B9A phase \u6570\u91CF\uFF1Asimple => \u53EA\u6709 P1 current\uFF1Bmoderate => P1 current + \u81F3\u5C11 P2 planned\uFF1Bcomplex => P1 current + \u81F3\u5C11 P2/P3 planned\u3002
+- P1 objective \u5FC5\u987B\u662F\u53EF\u72EC\u7ACB\u4EA4\u4ED8\u3001\u53EF\u9A8C\u8BC1\u7684\u6838\u5FC3\u529F\u80FD\u3002
+- P2/P3 \u53EA\u5199\u540E\u7EED\u589E\u5F3A\u76EE\u6807\u3001\u8303\u56F4\u3001\u4EA4\u4ED8\u7269\u548C\u9A8C\u8BC1\u95E8\u7981\uFF1B\u4E0D\u8981\u5C55\u5F00\u4EFB\u4F55 V \u6A21\u578B Step\u3002
+- \u6BCF\u4E2A phase \u7684 verificationGate \u5FC5\u987B\u8BF4\u660E\u5931\u8D25\u65F6\u628A\u5B8C\u6574\u9519\u8BEF\u65E5\u5FD7\u4EA4\u7ED9 Debugger\uFF0C\u5E76\u56DE\u9000\u5230\u5BF9\u5E94 V \u6A21\u578B\u9636\u6BB5\u540E\u91CD\u8DD1\u540E\u7EED\u9636\u6BB5\u3002
+- \u53EA\u8FD4\u56DE PhasePlan JSON\uFF0C\u7981\u6B62\u5305\u542B steps / architectureModules / dependencies\u3002`,
+    plannerPhaseDecompose: (raw, qa, addenda, opts) => `\u539F\u59CB\u9700\u6C42\uFF1A
+"""
+${raw}
+"""
+
+\u6F84\u6E05\u95EE\u7B54\uFF1A
+${qa || "\uFF08\u65E0\uFF09"}
+
+${addenda ? `\u7528\u6237\u8865\u5145\u9700\u6C42\uFF08\u9700\u4E25\u683C\u9075\u5B88\uFF0C\u4F18\u5148\u7EA7\u9AD8\u4E8E\u539F\u59CB\u63CF\u8FF0\u4E2D\u6A21\u7CCA\u7684\u90E8\u5206\uFF09\uFF1A
+"""
+${addenda}
+"""
+
+` : ""}${opts.intent && opts.intent !== "greenfield" ? `\u589E\u91CF\u610F\u56FE\uFF1A${opts.intent}
+
+\u8BF7\u5728\u73B0\u6709\u5DE5\u7A0B\u57FA\u7840\u4E0A\u751F\u6210\u5F53\u524D phase \u7684\u589E\u91CF V \u6A21\u578B StepPlan\uFF0C\u4F18\u5148\u590D\u7528\u5F53\u524D\u67B6\u6784\u3001\u6587\u4EF6\u3001\u6D4B\u8BD5\u4E0E\u4F9D\u8D56\u3002
+
+\u73B0\u6709\u5DE5\u7A0B\u57FA\u7EBF\uFF1A
+"""
+${opts.baseline || "\uFF08\u7F3A\u5C11\u57FA\u7EBF\u6458\u8981\uFF09"}
+"""
+
+` : ""}\u5DF2\u786E\u8BA4\u7684 PhasePlan\uFF1A
+"""
+${opts.phasePlan}
+"""
+
+\u5F53\u524D\u9700\u8981\u5C55\u5F00\u7684 phaseId\uFF1A${opts.phaseId}
+
+\u8BF7\u53EA\u4E3A ${opts.phaseId} \u8F93\u51FA\u5B8C\u6574 V \u6A21\u578B StepPlan\uFF1A
+- steps \u4E2D\u6BCF\u4E2A Step.iterationId \u5FC5\u987B\u7B49\u4E8E "${opts.phaseId}"\u3002
+- \u7981\u6B62\u8F93\u51FA\u5176\u4ED6 planned phase \u7684 Step\uFF1BP2/P3 \u7684\u8BE6\u7EC6\u8BA1\u5212\u7559\u5230\u5B83\u4EEC\u6210\u4E3A current phase \u65F6\u518D\u751F\u6210\u3002
+- \u5982\u679C ${opts.phaseId} \u6A2A\u8DE8\u591A\u4E2A\u5173\u6CE8\u70B9\uFF08\u9886\u57DF\u903B\u8F91\u3001CLI/API\u3001\u6587\u4EF6 I/O\u3001\u5916\u90E8\u96C6\u6210\u3001\u6D41\u7A0B\u7F16\u6392\u3001\u6D4B\u8BD5\uFF09\uFF0C\u5FC5\u987B\u5728 architectureModules \u4E2D\u4F53\u73B0\u5F53\u524D phase \u7684\u6A21\u5757\u8FB9\u754C\uFF0C\u5E76\u5728 CODE/MODULE_TEST \u7684 subTasks \u4E0B\u5206\u89E3\u6A21\u5757\u7EA7\u5DE5\u4F5C\u3002
+- architectureModules.sourcePaths \u53EA\u80FD\u662F src/ \u4E0B\u7684\u4EA7\u54C1\u6E90\u7801\u6587\u4EF6\uFF1B\u4E0D\u8981\u628A tests/fixtures\u3001tests/utils\u3001\u6837\u4F8B\u6587\u4EF6\u3001\u76EE\u5F55\u6216\u6587\u6863\u767B\u8BB0\u4E3A\u67B6\u6784\u6A21\u5757\u3002
+- dependencies \u53EA\u5199\u5F53\u524D phase \u9700\u8981\u7684\u5305\u540D\uFF1BPython \u5FC5\u987B\u5305\u542B pytest\uFF1B\u4E0D\u8981\u8F93\u51FA requirements.txt\u3002
+- \u5F53\u524D phase \u5FC5\u987B\u5305\u542B\u6807\u51C6 V \u6A21\u578B 8 \u4E2A\u5B8F Step\uFF0C\u5E76\u6EE1\u8DB3\u540C\u6B65\u6D4B\u8BD5\u8BBE\u8BA1\u89C4\u5219\u3002
+
+\u53EA\u8FD4\u56DE\u5F53\u524D phase \u7684\u4E25\u683C JSON StepPlan\u3002`,
     executorSystem: (p) => buildExecutorSystem2(p),
     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\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\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) => `
@@ -1382,14 +1694,18 @@ ${sp}`,
     executorUserPromptOutro: "\u73B0\u5728\u6309\u534F\u8BAE\u8FD4\u56DE\u7B2C\u4E00\u8F6E JSON\u3002",
     executorFeedbackHeader: "\u672C\u8F6E\u5DE5\u5177\u7ED3\u679C\uFF1A",
     executorFeedbackVerifyOk: "outputs \u6821\u9A8C\u901A\u8FC7\u3002\u5982\u5DF2\u5B8C\u6210\uFF0C\u8BF7\u628A done \u8BBE\u4E3A true \u4E14 actions=[]\u3002",
-    executorFeedbackVerifyMissing: (paths) => `outputs \u4ECD\u7F3A\u5931\uFF1A${paths}\u3002\u8BF7\u7EE7\u7EED\u3002`
+    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",
+    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",
     author: "\u901A\u8FC7 write_file \u521B\u5EFA\u65B0\u6587\u4EF6\uFF1B\u4F18\u5148\u653E\u5728\u5F53\u524D Step writable allowlist \u5185\u3002",
-    tester: '\u7F16\u5199\u5E76\u8FD0\u884C pytest \u6D4B\u8BD5\uFF0C\u9A8C\u8BC1\u51FD\u6570\u884C\u4E3A\uFF1B\u5931\u8D25\u65F6\u901A\u8FC7 analyze_error \u89E3\u6790\u3002\u3010fixture \u81EA\u5305\u542B\u3011\u6D4B\u8BD5**\u4E25\u7981**\u76F4\u63A5 open() \u78C1\u76D8\u4E0A\u4E0D\u5B58\u5728\u7684\u6837\u4F8B\u6587\u4EF6\uFF08\u5982 "test.dbc"\uFF09\uFF1B\u82E5\u88AB\u6D4B\u51FD\u6570\u9700\u8981\u6587\u4EF6\u8F93\u5165\uFF0C\u8BF7\u7528 pytest \u7684 tmp_path fixture \u5728\u6D4B\u8BD5\u91CC\u4E34\u65F6\u6784\u9020\u5185\u5BB9\uFF0C\u6216\u7528 write_file \u76F4\u63A5\u5199\u5230 tests/fixtures/<name>\u2014\u2014\u6D4B\u8BD5/DEBUG \u9636\u6BB5\u8BE5\u76EE\u5F55\u5DF2\u9ED8\u8BA4\u653E\u5F00\u5199\u6743\u9650\uFF0C\u5B50\u76EE\u5F55\u81EA\u52A8 mkdir -p\uFF0C**\u65E0\u9700**\u63D0\u524D\u628A fixture \u8DEF\u5F84\u767B\u8BB0\u5230 outputs\u3002\u751F\u6210\u6D4B\u8BD5\u65F6\u52A1\u5FC5\u540C\u65F6\u8F93\u51FA\u5168\u90E8\u4F9D\u8D56\u8D44\u6E90\uFF0C\u907F\u514D\u540E\u7EED Debugger \u56E0 FileNotFoundError \u53CD\u590D\u91CD\u8BD5\u3002\u3010fixture \u8FED\u4EE3\u3011\u82E5\u6D4B\u8BD5\u8FD0\u884C\u4E2D\u88AB\u6D4B\u51FD\u6570\u62A5"Invalid syntax / Parse error / Malformed"\u7B49\u89E3\u6790\u9519\u8BEF\uFF0C\u8BF4\u660E\u4F60\u5199\u51FA\u7684 fixture \u5185\u5BB9\u4E0D\u5408\u8BE5\u683C\u5F0F spec\uFF1Aread_file \u770B\u6E05\uFF0Cwrite_file \u6574\u6587\u4EF6\u91CD\u5199\u4E3A\u5408\u6CD5\u6837\u4F8B\uFF0C\u518D run_tests\uFF0C\u4E25\u7981\u53BB\u6539\u88AB\u6D4B\u6A21\u5757\u6216\u65AD\u8A00\u3002',
+    tester: '\u7F16\u5199\u5E76\u8FD0\u884C pytest \u6D4B\u8BD5\uFF0C\u9A8C\u8BC1\u51FD\u6570\u884C\u4E3A\uFF1B\u5931\u8D25\u65F6\u901A\u8FC7 analyze_error \u89E3\u6790\u3002\u3010fixture \u81EA\u5305\u542B\u3011\u6D4B\u8BD5**\u4E25\u7981**\u76F4\u63A5 open() \u78C1\u76D8\u4E0A\u4E0D\u5B58\u5728\u7684\u6837\u4F8B\u6587\u4EF6\u3002\u82E5\u88AB\u6D4B\u51FD\u6570\u9700\u8981\u6587\u4EF6\u8F93\u5165\uFF0C\u4F18\u5148\u590D\u7528\u7528\u6237/\u5DE5\u4F5C\u533A\u771F\u5B9E\u6837\u4F8B\uFF1B\u6CA1\u6709\u6837\u4F8B\u65F6\u7528 http_fetch \u83B7\u53D6\u5B98\u65B9\u6587\u6863\u3001\u4E0A\u6E38\u4ED3\u5E93\u6216\u516C\u5F00\u6807\u51C6\u4E2D\u7684\u5C0F\u578B\u53C2\u8003\u6837\u4F8B\uFF0C\u4FDD\u5B58\u5230 tests/fixtures/<name> \u5E76\u8BB0\u5F55\u6765\u6E90\uFF1B\u53EA\u6709 CSV/JSON/INI \u7B49\u7B80\u5355\u6587\u672C\u683C\u5F0F\u624D\u53EF\u5728 pytest tmp_path \u4E2D\u6784\u9020\u6700\u5C0F\u6837\u4F8B\u5E76\u7ACB\u523B run_tests\u3002\u6D4B\u8BD5/DEBUG \u9636\u6BB5 tests/fixtures/ \u5DF2\u9ED8\u8BA4\u653E\u5F00\u5199\u6743\u9650\uFF0C\u5B50\u76EE\u5F55\u81EA\u52A8 mkdir -p\uFF0C**\u65E0\u9700**\u63D0\u524D\u628A fixture \u8DEF\u5F84\u767B\u8BB0\u5230 outputs\u3002\u751F\u6210\u6D4B\u8BD5\u65F6\u52A1\u5FC5\u540C\u65F6\u8F93\u51FA\u5168\u90E8\u4F9D\u8D56\u8D44\u6E90\uFF0C\u907F\u514D\u540E\u7EED Debugger \u56E0 FileNotFoundError \u53CD\u590D\u91CD\u8BD5\u3002\u3010fixture \u8FED\u4EE3\u3011\u82E5\u6D4B\u8BD5\u8FD0\u884C\u4E2D\u88AB\u6D4B\u51FD\u6570\u62A5"Invalid syntax / Parse error / Malformed"\u7B49\u89E3\u6790\u9519\u8BEF\uFF0C\u8BF4\u660E\u4F60\u5199\u51FA\u7684 fixture \u5185\u5BB9\u4E0D\u5408\u8BE5\u683C\u5F0F spec\uFF1Aread_file \u770B\u6E05\u540E\uFF0C\u4F18\u5148\u4F7F\u7528\u7528\u6237\u6837\u4F8B\u6216 http_fetch \u62C9\u53D6\u7684\u6743\u5A01\u53C2\u8003\u6837\u4F8B\u91CD\u5199\uFF0C\u518D run_tests\u3002\u590D\u6742\u9886\u57DF\u683C\u5F0F\u8FDE\u7EED\u5931\u8D25\u540E\u5FC5\u987B\u505C\u6B62\u51ED\u8BB0\u5FC6\u751F\u6210\uFF0C\u6539\u4E3A\u8BF7\u6C42\u7528\u6237\u6837\u4F8B\u6216\u7F51\u7EDC\u53C2\u8003\uFF1B\u4E25\u7981\u53BB\u6539\u88AB\u6D4B\u6A21\u5757\u6216\u65AD\u8A00\u3002',
     dep_resolver: "\u5F53\u51FA\u73B0 ModuleNotFoundError \u65F6\uFF0C\u7528 add_dependency \u5199\u56DE requirements.txt \u5E76\u91CD\u5EFA\u6C99\u76D2\u3002",
-    debugger: '\u5148 run_tests / run_python \u590D\u73B0\u9519\u8BEF \u2192 analyze_error \u2192 patch/replace_in_file \u4FEE\u590D \u2192 \u518D\u6B21 run_tests\u3002\u6BCF\u6B21\u53EA\u505A\u6700\u5C0F\u4FEE\u6539\u3002\u3010\u7F51\u7EDC/API \u5931\u8D25\u3011\u5B9A\u4F4D\u5931\u8D25 URL \u540E\uFF0C\u53EA\u5141\u8BB8\u5C11\u91CF\u63A2\u6D4B\u66FF\u4EE3 API\uFF0C\u968F\u540E\u5FC5\u987B patch \u6E90\u7801\u5E76\u7528 run_program \u8BC1\u660E\u5165\u53E3\u4E0D\u518D\u8F93\u51FA API \u5931\u8D25\u3002\u3010\u91CD\u8981\u3011\u540C\u4E00\u6587\u4EF6\u4E0A replace_in_file \u8FDE\u7EED\u5931\u8D25 2 \u6B21\u4EE5\u4E0A\u8BF7\u7ACB\u5373 read_file\uFF0C\u518D\u7528 patch \u6216\u5728\u5F53\u524D\u8FD0\u884C\u65F6 chunk limit \u5185\u6574\u6587\u4EF6\u91CD\u5199\uFF0C\u4E0D\u8981\u53CD\u590D\u731C\u6D4B find \u5B57\u7B26\u4E32\u3002\u3010\u7981\u6B62 no-op\u3011replace_in_file \u7684 find \u4E0E replace \u5FC5\u987B\u4E0D\u540C\u2014\u2014\u82E5\u4F60\u53EA\u662F\u60F3"\u786E\u8BA4"\u67D0\u6BB5\u4EE3\u7801\uFF0C\u8BF7\u7528 read_file\uFF0C\u4E0D\u8981\u63D0\u4EA4\u76F8\u540C\u5B57\u7B26\u4E32\u7684\u66FF\u6362\u3002',
+    debugger: '\u5148 run_tests / run_python \u590D\u73B0\u9519\u8BEF \u2192 analyze_error \u2192 patch/replace_in_file/add_dependency \u4FEE\u590D \u2192 \u518D\u6B21 run_tests\u3002\u6BCF\u6B21\u53EA\u505A\u6700\u5C0F\u4FEE\u6539\u3002\u3010\u4F9D\u8D56\u7F3A\u5931\u3011\u5FC5\u987B\u6DFB\u52A0\u771F\u5B9E\u4F9D\u8D56\u6216\u6539\u7528\u8BBE\u8BA1\u9009\u5B9A\u7684\u771F\u5B9E\u5E93\uFF0C\u7981\u6B62\u5728 src/ \u751F\u4EA7\u4EE3\u7801\u91CC\u4F2A\u9020 module\u3001fake class/function\u3001\u7A7A\u5B9E\u73B0\u6216 fallback mock\u3002\u3010Fixture \u7EAA\u5F8B\u3011\u5982\u679C\u6D4B\u8BD5\u5931\u8D25\u662F\u884C\u4E3A\u65AD\u8A00\u5931\u8D25\uFF0C\u4E0D\u8981\u6301\u7EED\u91CD\u5199 fixture\uFF1B\u53EA\u6709\u660E\u786E\u7F3A\u6587\u4EF6\u3001fixture \u683C\u5F0F\u9519\u8BEF\u6216 fixture \u89E3\u6790\u9519\u8BEF\u65F6\u624D\u6539 fixture\uFF0C\u5426\u5219\u4FEE\u6E90\u7801\u3001\u5951\u7EA6\u3001\u4F9D\u8D56\u6216\u9519\u8BEF\u65AD\u8A00\u3002\u3010\u7F51\u7EDC/API \u5931\u8D25\u3011\u5B9A\u4F4D\u5931\u8D25 URL \u540E\uFF0C\u53EA\u5141\u8BB8\u5C11\u91CF\u63A2\u6D4B\u66FF\u4EE3 API\uFF0C\u968F\u540E\u5FC5\u987B patch \u6E90\u7801\u5E76\u7528 run_program \u8BC1\u660E\u5165\u53E3\u4E0D\u518D\u8F93\u51FA API \u5931\u8D25\u3002\u3010\u91CD\u8981\u3011\u540C\u4E00\u6587\u4EF6\u4E0A replace_in_file \u8FDE\u7EED\u5931\u8D25 2 \u6B21\u4EE5\u4E0A\u8BF7\u7ACB\u5373 read_file\uFF0C\u518D\u7528 patch \u6216\u5728\u5F53\u524D\u8FD0\u884C\u65F6 chunk limit \u5185\u6574\u6587\u4EF6\u91CD\u5199\uFF0C\u4E0D\u8981\u53CD\u590D\u731C\u6D4B find \u5B57\u7B26\u4E32\u3002\u3010\u7981\u6B62 no-op\u3011replace_in_file \u7684 find \u4E0E replace \u5FC5\u987B\u4E0D\u540C\u2014\u2014\u82E5\u4F60\u53EA\u662F\u60F3"\u786E\u8BA4"\u67D0\u6BB5\u4EE3\u7801\uFF0C\u8BF7\u7528 read_file\uFF0C\u4E0D\u8981\u63D0\u4EA4\u76F8\u540C\u5B57\u7B26\u4E32\u7684\u66FF\u6362\u3002',
     refactorer: "\u91CD\u6784\u5FC5\u987B\u4FDD\u8BC1\u884C\u4E3A\u4E0D\u53D8\uFF1B\u5148\u8DD1\u56DE\u5F52\u6D4B\u8BD5 \u2192 \u4FEE\u6539 \u2192 \u518D\u8DD1\u56DE\u5F52\u6D4B\u8BD5\u3002"
   },
   doctor: {
@@ -1412,7 +1728,7 @@ ${sp}`,
     ollamaReachable: (baseUrl, n) => `ollama \u53EF\u8FBE @ ${baseUrl}\uFF08\u5171 ${n} \u4E2A\u6A21\u578B\uFF09`,
     ollamaModelMissing: (provider, model, baseUrl) => `provider "${provider}"\uFF1A\u6A21\u578B "${model}" \u672A\u5B89\u88C5\u4E8E ${baseUrl}\uFF08\u8BF7\u6267\u884C \`ollama pull ${model}\`\uFF09`,
     ollamaModelOk: (provider, model) => `provider "${provider}"\uFF1A\u6A21\u578B "${model}" \u53EF\u7528`,
-    openaiKeyMissing: (provider) => `provider "${provider}"\uFF1Aapi_key \u4E3A\u7A7A\uFF08\u8BF7\u8BBE\u7F6E OPENAI_API_KEY \u6216 config.llm.providers.${provider}.api_key\uFF09`,
+    openaiKeyMissing: (provider) => `provider "${provider}"\uFF1Aapi_key \u4E3A\u7A7A\uFF08\u8BF7\u8BBE\u7F6E\u8BE5 provider \u5BF9\u5E94\u7684\u73AF\u5883\u53D8\u91CF\uFF0C\u4F8B\u5982 OPENROUTER_API_KEY\uFF0C\u6216 config.llm.providers.${provider}.api_key\uFF09`,
     openaiReachable: (provider, baseUrl) => `provider "${provider}"\uFF1AOpenAI \u7AEF\u70B9\u53EF\u8FBE @ ${baseUrl}`,
     openaiUnreachable: (provider, baseUrl, msg) => `provider "${provider}"\uFF1AOpenAI \u7AEF\u70B9\u4E0D\u53EF\u8FBE @ ${baseUrl} \u2014\u2014 ${msg}`,
     openaiModelListMissing: (provider, model) => `provider "${provider}"\uFF1A/models \u54CD\u5E94\u4E2D\u672A\u5217\u51FA "${model}"\uFF08\u82E5\u4F60\u7684\u8D26\u53F7\u6709\u8BBF\u95EE\u6743\u9650\u4ECD\u53EF\u6B63\u5E38\u8C03\u7528\uFF09`,
@@ -1421,7 +1737,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",
@@ -1450,7 +1766,7 @@ function t() {
 }
 
 // src/version.ts
-var XCOMPILER_VERSION = "0.2.2";
+var XCOMPILER_VERSION = "0.2.4";
 var XCOMPILER_PLUGIN_API_VERSION = 1;
 
 // src/plugins/compatibility.ts