@ai-content-space/loopx 0.1.1 → 0.1.3

package/src/plan-runtime.mjs

@@ -33,38 +33,36 @@ function paragraphFromSection(section, fallback) {
 
 function buildSourceSummary(sourceText) {
   return {
-    intent: paragraphFromSection(extractSection(sourceText, 'Intent'), 'Translate the approved requirements into a build-ready plan package.'),
-    outcome: paragraphFromSection(extractSection(sourceText, 'Desired Outcome'), 'Produce an approved plan package and stop before execution.'),
+    intent: paragraphFromSection(extractSection(sourceText, 'Intent'), '将已批准的需求整理成可进入 build 的计划包。'),
+    outcome: paragraphFromSection(extractSection(sourceText, 'Desired Outcome'), '产出已批准的计划工件，并在执行前停止。'),
     inScope: bulletsFromSection(extractSection(sourceText, 'In Scope'), [
-      'Create the approved planning artifacts.',
-      'Keep runtime state machine-checkable.',
-      'Preserve explicit execution approval boundaries.',
+      '生成已批准的规划工件。',
+      '保持 runtime 状态机可检查。',
+      '保留显式的执行审批边界。',
     ]),
     nonGoals: bulletsFromSection(extractSection(sourceText, 'Out of Scope / Non-goals'), [
-      'Do not launch execution from plan.',
-      'Do not widen the task beyond approved planning scope.',
+      '不要从 plan 直接启动执行。',
+      '不要把任务扩展到已批准范围之外。',
     ]),
     acceptance: bulletsFromSection(extractSection(sourceText, 'Testable Acceptance Criteria'), [
-      'Planning outputs are complete and reviewable.',
-      'Verification steps are explicit.',
+      '规划输出完整且可审阅。',
+      '验证步骤明确可执行。',
     ]),
     constraints: bulletsFromSection(extractSection(sourceText, 'Constraints'), [
-      'Preserve existing workflow sequencing.',
-      'Keep planning outputs deterministic and reviewable.',
+      '保留既有 workflow 顺序。',
+      '保持规划输出稳定且可审阅。',
     ]),
     decisions: bulletsFromSection(extractSection(sourceText, 'Decision Boundaries'), [
-      'Plan stops after approved planning artifacts exist.',
-      'Execution requires explicit downstream approval.',
+      'plan 在生成已批准规划工件后停止。',
+      '执行需要显式下游批准。',
     ]),
   };
 }
 
-function chineseBulletList(items) {
-  return items.map((item) => `- ${item}`).join('\n');
-}
-
 function plannerDraftFromSource({ slug, sourceText, deliberateMode }) {
   const summary = buildSourceSummary(sourceText);
+  const executionInputs = bulletsFromSection(extractSection(sourceText, 'Execution Inputs'), []);
+  const executionInputsResolved = executionInputs.length > 0 && executionInputs.every((item) => !/\b(TBD|待定|unknown|later)\b/i.test(item));
   const preMortem = deliberateMode
     ? [
         '如果运行时没有独立的规划适配层，真实编排与测试替身会相互污染。',
@@ -88,159 +86,121 @@ function plannerDraftFromSource({ slug, sourceText, deliberateMode }) {
     ],
     options: [
       {
-        name: 'Embed orchestration in plan runtime',
-        pros: ['runtime truth and product contract stay aligned', 'one state machine owns gating and artifacts'],
-        cons: ['requires new adapter seam for deterministic testing'],
+        name: '在 plan runtime 内嵌编排',
+        pros: ['runtime 真相与产品契约保持一致', '由同一个状态机管理 gate 与工件'],
+        cons: ['需要额外的 adapter 边界来支撑确定性测试'],
       },
       {
-        name: 'Wrapper consensus around lightweight plan',
-        pros: ['smaller immediate diff'],
-        cons: ['preserves split truth between wrapper and runtime', 'status/debugging remains fragmented'],
+        name: '在轻量 plan 外包一层共识流程',
+        pros: ['短期 diff 更小'],
+        cons: ['wrapper 与 runtime 的事实仍然分裂', 'status 与调试信息继续碎片化'],
       },
     ],
     planText: [
-      `# loopx Plan: ${slug}`,
+      `# loopx 计划: ${slug}`,
       '',
-      '## Requirements Summary',
+      '## 需求摘要',
       '',
       `- ${summary.intent}`,
       `- ${summary.outcome}`,
       '',
-      '## Deliverables',
+      '## 交付物',
       '',
       ...summary.acceptance.map((item, index) => `${index + 1}. ${item}`),
       '',
-      '## Implementation Steps',
+      '## 实施步骤',
+      '',
+      '1. 为 planner、architect、critic 增加 plan orchestration adapter。',
+      '2. 在 workflow state 中记录 plan iteration、review verdict 和 execution-input blockers。',
+      '3. 从已批准的 planning source 生成中文主规划工件与 canonical plan artifacts。',
+      '4. 在 CLI status 中暴露 plan 阶段进度。',
+      '5. 为 happy path、iterate path 和 execution input 未收口路径补 deterministic regression coverage。',
       '',
-      '1. Add a plan orchestration adapter for planner, architect, and critic.',
-      '2. Record plan iteration, review verdicts, and docs blockers in workflow state.',
-      '3. Generate canonical plan artifacts and Chinese docs outputs from the approved planning source.',
-      '4. Expose plan-stage progress in CLI status.',
-      '5. Add deterministic regression coverage for happy path, iterate path, and docs blockers.',
+      '## 执行输入',
       '',
-      '## Risks',
+      ...(executionInputs.length > 0 ? executionInputs.map((item) => `- ${item}`) : ['- TBD: execution inputs not yet mapped to concrete sources.']),
+      '',
+      '## 风险',
       '',
       ...summary.constraints.map((item) => `- ${item}`),
       '',
-      '## Verification',
+      '## 验证',
       '',
-      '- run workflow tests',
-      '- run CLI status checks',
-      '- prove docs blocking and iteration paths',
+      '- 运行 workflow tests',
+      '- 运行 CLI status checks',
+      '- 证明 execution input blockers 与 iterate path 生效',
     ].join('\n'),
     architectureText: [
-      `# loopx Architecture: ${slug}`,
+      `# 架构文档: ${slug}`,
       '',
-      '## Intent',
+      '## 目标',
       '',
       `- ${summary.intent}`,
       '',
-      '## Boundaries',
+      '## 边界',
       '',
       ...summary.decisions.map((item) => `- ${item}`),
       '',
-      '## Chosen Design',
+      '## 选定方案',
       '',
-      '- plan runtime owns the planner -> architect -> critic loop',
-      '- a dedicated adapter separates production orchestration from deterministic tests',
-      '- canonical plan artifacts remain under `.loopx/plans/`',
-      '- required Chinese docs are emitted under `docs/<slug>/`',
+      '- plan runtime 负责 planner -> architect -> critic 闭环',
+      '- 通过专用 adapter 隔离生产编排与确定性测试',
+      '- canonical plan artifacts 保持写入 `.loopx/plans/`',
+      '- `.loopx/workflows/<slug>/` 下的主规划工件直接作为中文产物',
       '',
-      '## Alternatives Considered',
+      '## 备选方案',
       '',
-      '- keep plan lightweight and wrap it externally',
-      '- delay runtime alignment and keep the skill contract aspirational',
+      '- 保持 plan 轻量并在外层包一层流程',
+      '- 推迟 runtime 对齐，仅把 skill contract 当目标状态',
     ].join('\n'),
     developmentPlanText: [
-      `# loopx Development Plan: ${slug}`,
+      `# 开发计划: ${slug}`,
       '',
-      '## Execution Breakdown',
+      '## 执行拆解',
       '',
-      '1. Extend plan state schema and status output.',
-      '2. Implement planner/architect/critic orchestration with bounded iteration.',
-      '3. Emit canonical and docs planning artifacts.',
-      '4. Add deterministic test seams and regression coverage.',
+      '1. 扩展 plan state schema 与 status 输出。',
+      '2. 实现带有有界迭代的 planner/architect/critic 编排。',
+      '3. 直接输出中文主规划工件与 canonical plan artifacts。',
+      '4. 增加 deterministic test seams 与 regression coverage。',
       '',
-      '## Staffing Guidance',
+      '## 责任分工',
       '',
       '- owner: plan runtime',
       '- reviewer: architect and critic',
-      '- downstream execution: explicit later approval only',
+      '- downstream execution: 仅在后续显式批准后进入',
       '',
-      '## Sequencing',
+      '## 时序要求',
       '',
-      '- do not run critic before architect completes',
-      '- do not approve build until plan blockers are gone',
-      '- do not auto-launch execution from plan',
+      '- architect 未完成前不得运行 critic',
+      '- plan blockers 清除前不得批准 build',
+      '- plan 阶段不得自动启动执行',
     ].join('\n'),
     testPlanText: [
-      `# loopx Test Plan: ${slug}`,
+      `# 测试计划: ${slug}`,
       '',
-      '## Unit',
+      '## 单元测试',
       '',
-      '- state initialization for plan consensus mode',
-      '- docs artifact path and blocking checks',
-      '- planner/architect/critic review artifact recording',
+      '- plan consensus mode 的 state 初始化',
+      '- 中文主规划工件的 blocking checks',
+      '- planner/architect/critic review artifact 记录',
       '',
-      '## Integration',
+      '## 集成测试',
       '',
       '- clarify -> plan happy path',
-      '- critic iterate then approve path',
-      '- docs missing or non-Chinese blocking path',
+      '- critic iterate 再 approve 的路径',
+      '- 主规划工件缺失或非中文时的 blocking 路径',
+      '- execution inputs 缺失或标记 TBD 的 blocking 路径',
       '',
-      '## Observability',
+      '## 可观测性',
       '',
-      '- status exposes iteration, architect review status, critic verdict, and docs blockers',
+      '- status 输出 iteration、architect review status、critic verdict 与 execution input blockers',
     ].join('\n'),
-    docs: {
-      architecture: [
-        '# 架构文档',
-        '',
-        '## 目标',
-        '',
-        '- 将 plan 运行时升级为真实的 Planner / Architect / Critic 规划闭环。',
-        '- 在 approved plan 产出后停止，不进入执行阶段。',
-        '',
-        '## 关键边界',
-        '',
-        ...summary.decisions.map((item) => `- ${item}`),
-        '',
-        '## 关键约束',
-        '',
-        ...summary.constraints.map((item) => `- ${item}`),
-      ].join('\n'),
-      design: [
-        '# 设计文档',
-        '',
-        '## 设计要点',
-        '',
-        '- 引入 plan orchestration adapter，隔离真实编排与测试替身。',
-        '- 在 workflow state 中记录 iteration、architect review、critic verdict 和 docs blockers。',
-        '- 以 `.loopx/plans/` 为 canonical，以 `docs/<slug>/` 为中文规划文档输出。',
-        '',
-        '## 非目标',
-        '',
-        ...summary.nonGoals.map((item) => `- ${item}`),
-      ].join('\n'),
-      testPlan: [
-        '# 测试计划',
-        '',
-        '## 验证范围',
-        '',
-        ...summary.acceptance.map((item) => `- ${item}`),
-        '',
-        '## 核心回归',
-        '',
-        '- happy path: 一轮 approve 完成',
-        '- iterate path: Critic 先 iterate 后 approve',
-        '- docs blocker: 缺文件或英文占位内容都不能完成',
-      ].join('\n'),
-    },
     preMortem,
     principlesResolved: true,
     optionsReviewed: true,
     acceptanceCriteriaTestable: true,
     verificationStepsResolved: true,
+    executionInputsResolved,
   };
 }
 
@@ -257,7 +217,7 @@ function reviewArtifact(kind, iteration, verdict, findings, extras = {}) {
 function defaultArchitectReview({ plannerDraft, iteration }) {
   const findings = [
     'Real planning orchestration needs an adapter seam so production runtime and deterministic tests can share one state machine.',
-    'Plan completion should depend on blocking docs outputs, not only canonical plan artifacts.',
+    'Plan completion should depend on blocking workflow planning artifacts, not only canonical plan artifacts.',
   ];
   return reviewArtifact('architect', iteration, 'approve', findings, {
     status: 'complete',
@@ -267,7 +227,13 @@ function defaultArchitectReview({ plannerDraft, iteration }) {
 }
 
 function containsChinese(text) {
-  return /[\u3400-\u9fff]/.test(text);
+  const chineseChars = text.match(/[\u3400-\u9fff]/g) || [];
+  const latinChars = text.match(/[A-Za-z]/g) || [];
+  const signalChars = chineseChars.length + latinChars.length;
+  if (signalChars === 0) {
+    return false;
+  }
+  return chineseChars.length >= 40 || (chineseChars.length >= 8 && chineseChars.length / signalChars >= 0.2);
 }
 
 function defaultCriticReview({ plannerDraft, iteration }) {
@@ -284,12 +250,16 @@ function defaultCriticReview({ plannerDraft, iteration }) {
   if (!plannerDraft.verificationStepsResolved) {
     findings.push('Verification steps are not concrete.');
   }
-  if (!containsChinese(plannerDraft.docs.architecture) || !containsChinese(plannerDraft.docs.design) || !containsChinese(plannerDraft.docs.testPlan)) {
-    findings.push('Required docs outputs are not Chinese.');
+  if (!plannerDraft.executionInputsResolved) {
+    findings.push('Execution inputs are not fully mapped to concrete sources.');
+  }
+  if (!containsChinese(plannerDraft.planText) || !containsChinese(plannerDraft.architectureText) || !containsChinese(plannerDraft.developmentPlanText) || !containsChinese(plannerDraft.testPlanText)) {
+    findings.push('Required workflow planning artifacts are not Chinese.');
   }
   return reviewArtifact('critic', iteration, findings.length > 0 ? 'iterate' : 'approve', findings, {
     acceptanceCriteriaTestable: plannerDraft.acceptanceCriteriaTestable,
     verificationStepsResolved: plannerDraft.verificationStepsResolved,
+    executionInputsResolved: plannerDraft.executionInputsResolved,
   });
 }
 
@@ -302,6 +272,9 @@ function scriptedVerdict(script, index, fallback) {
 }
 
 function scriptedCriticReview({ plannerDraft, iteration }, script, index) {
+  if (!Array.isArray(script) || script.length === 0) {
+    return defaultCriticReview({ plannerDraft, iteration });
+  }
   const verdict = scriptedVerdict(script, index, 'approve');
   const findings = verdict === 'approve'
     ? ['Structured planning outputs satisfy the scripted approval path.']
@@ -309,6 +282,7 @@ function scriptedCriticReview({ plannerDraft, iteration }, script, index) {
   return reviewArtifact('critic', iteration, verdict, findings, {
     acceptanceCriteriaTestable: plannerDraft.acceptanceCriteriaTestable,
     verificationStepsResolved: plannerDraft.verificationStepsResolved,
+    executionInputsResolved: plannerDraft.executionInputsResolved,
   });
 }
 
@@ -321,6 +295,9 @@ export function createScriptedPlanAdapter(script = {}) {
     },
     async architect(context) {
       const base = defaultArchitectReview(context);
+      if (!Array.isArray(script.architect) || script.architect.length === 0) {
+        return base;
+      }
       const mode = scriptedVerdict(script.architect, architectIndex, 'approve');
       architectIndex += 1;
       return {
@@ -359,15 +336,15 @@ export function createRealPlanAdapter({ model } = {}) {
         '  "architectureText": string,',
         '  "developmentPlanText": string,',
         '  "testPlanText": string,',
-        '  "docs": {"architecture": string, "design": string, "testPlan": string},',
         '  "principlesResolved": boolean,',
         '  "optionsReviewed": boolean,',
         '  "acceptanceCriteriaTestable": boolean,',
-        '  "verificationStepsResolved": boolean',
+        '  "verificationStepsResolved": boolean,',
+        '  "executionInputsResolved": boolean',
         '}',
         `Deliberate mode: ${Boolean(context.deliberateMode)}`,
         '',
-        'Use Chinese for docs.architecture / docs.design / docs.testPlan.',
+        'Use Chinese for planText / architectureText / developmentPlanText / testPlanText.',
         'Do not ask questions. Do not wrap JSON in markdown.',
         '',
         'Source requirements:',
@@ -433,7 +410,8 @@ export function createRealPlanAdapter({ model } = {}) {
         '  "verdict": "approve" | "iterate" | "reject",',
         '  "findings": string[],',
         '  "acceptanceCriteriaTestable": boolean,',
-        '  "verificationStepsResolved": boolean',
+        '  "verificationStepsResolved": boolean,',
+        '  "executionInputsResolved": boolean',
         '}',
         'Do not ask questions. Do not wrap JSON in markdown.',
         '',