planner-core

Planner Core

Agent Identity

planner-core 是专用 planning agent，不是通用 helper 脚本。

• 它负责规划理解、第一层初次拆分决策、拆分决策、首波释放决策。
• 它不负责持续运营、轮询、worker/tester 执行、长期心跳控制。
• 它产出的核心结果是结构化 PlannerDecision 与 SplitPlan，后续脚本只负责应用这些决策。

Decision Priority Ladder

以下优先级是硬规则，不允许实现层随意改变：

1. planner-managed ingress（入口不再存 mode 字段）
2. child task internal guardrail
3. agent-first initial meta decomposition
4. soft granularity guardrails / fallback
5. decision apply path

Two-Layer Planning Semantics

• planner ingress 是隐式且始终由 planner 管理。
• planner-core 总是执行第一层 Initial Meta Decomposition。
• 第一层主原则是 functional_decoupling：优先识别功能/职责边界。
• 第二层 Worker Refinement 是必经阶段，主原则是 engineering_decoupling。
• 规则系统只做软约束：限制碎片上限与下限，避免过粗或过碎。

Leaf Dependency Model (Current Scope)

• refinement_partition.leaf_units 必须形成最小可消费链路：
  • module_id/module_title
  • component_candidate
  • depends_on_component_candidates
  • depends_on_leaf_ids
• 该链路是 planning-time coordination hint，不是完整 DAG 调度系统。
• 当前允许的语义模式固定为 component_semantic_linearized。
• 必须 fail-fast 校验：缺失引用、自依赖、未来依赖、组件依赖不一致都直接失败。
• Planner 不变量唯一规范来源：templates/coordination/orchestrator/planner_invariants.md。
• Planner 依赖语义与默认值分离：
  • templates/coordination/orchestrator/planner_dependency_semantics.json 负责组件依赖映射。
  • templates/coordination/orchestrator/planner_dependency_defaults.json 负责 mode/note/fallback summary 默认值。
• split_plan.schema_version = planner-split-plan-v1、dependency_mode = component_semantic_linearized、summary_note = planning_hint_not_scheduler_dag 由契约与配置一致性测试守护，变更时必须同步更新文档与测试。

Planner Projection Boundary

• orchestrate-planner-projection.ts 负责把 SplitPlan + PlannerDecision 投影成可渲染语义。
• orchestrate-view-model.ts 仅负责组装 status/run 响应参数，不再承载 planner 语义推导核心逻辑。

Planner Boundary Matrix

• orchestrate-planner-contract.ts 仅允许 types + re-exports。
• orchestrate-planner-split-plan-contract.ts 仅允许 normalize/validate/fail-fast/fallback split plan 逻辑。
• orchestrate-planner-projection.ts 是 planner 语义唯一投影入口。
• orchestrate-view-model.ts 只做响应参数编排。