geo-ai-search-optimization 1.3.3 → 1.3.4

package/README.md

@@ -858,6 +858,13 @@ geo-ai-search-optimization help
 - 主 `cli.js` 进一步收敛成更薄的 command router
 - 现在 flow family 和 execution family 都有独立 adapter 模块，后续继续拆 planning / delivery 会更顺
 
+## New in 1.3.4
+
+- 继续做 CLI 架构迭代，把 planning / reporting / delivery family 也从主 `cli.js` 拆出
+- 新增 `src/cli-planning-delivery-commands.js`，接管 `agent-handoff / apply-plan / completion-report / handoff-bundle / share-pack / export-pack / html-pack / publish-pack / exec-summary / fix-plan / owner-board / meeting-pack / pm-brief / roadmap / report`
+- 主 `cli.js` 现在更接近纯路由层
+- CLI 已经形成 `flow / execution / planning-delivery / shared` 四层 command adapter 结构
+
 ## New in 1.2.20
 
 - 新增 `agent-continue`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Install and run a Generative Engine Optimization (GEO)-first, SEO-supported Codex skill for website optimization.",
   "type": "module",
   "bin": {

package/src/cli-planning-delivery-commands.js

@@ -0,0 +1,268 @@
+import { createApplyPlan, renderApplyPlanMarkdown, writeApplyPlanOutput } from "./apply-plan.js";
+import { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput } from "./agent-handoff.js";
+import {
+  createCompletionReport,
+  renderCompletionReportMarkdown,
+  writeCompletionReportOutput
+} from "./completion-report.js";
+import { createHandoffBundle, renderHandoffBundleMarkdown, writeHandoffBundleOutput } from "./handoff-bundle.js";
+import { renderHtmlPackMarkdown, writeHtmlPack } from "./html-pack.js";
+import { createExecSummary, renderExecSummaryMarkdown, writeExecSummaryOutput } from "./exec-summary.js";
+import { renderExportPackMarkdown, writeExportPack } from "./export-pack.js";
+import { createFixPlan, renderFixPlanMarkdown, writeFixPlanOutput } from "./fix-plan.js";
+import { createMeetingPack, renderMeetingPackMarkdown, writeMeetingPackOutput } from "./meeting-pack.js";
+import { createOwnerBoard, renderOwnerBoardMarkdown, writeOwnerBoardOutput } from "./owner-board.js";
+import { createPmBrief, renderPmBriefMarkdown, writePmBriefOutput } from "./pm-brief.js";
+import { renderPublishPackMarkdown, writePublishPack } from "./publish-pack.js";
+import { generateReport, writeReportOutput } from "./report.js";
+import { createRoadmap, renderRoadmapMarkdown, writeRoadmapOutput } from "./roadmap.js";
+import { createSharePack, renderSharePackMarkdown, writeSharePackOutput } from "./share-pack.js";
+import { getFlagValue, getRequiredInput, parsePositiveInteger, writeOrPrintArtifact } from "./cli-shared.js";
+
+export const PLANNING_DELIVERY_HELP_LINES = [
+  "  geo-ai-search-optimization agent-handoff <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization apply-plan <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization completion-report <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization handoff-bundle <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization share-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization export-pack <input> [--task <id>] [--format <markdown|json>] [--out-dir <dir>]",
+  "  geo-ai-search-optimization html-pack <input> [--task <id>] [--out-dir <dir>]",
+  "  geo-ai-search-optimization publish-pack <input> [--task <id>] [--out-dir <dir>]",
+  "  geo-ai-search-optimization exec-summary <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization fix-plan <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization owner-board <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization meeting-pack <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization pm-brief <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization roadmap <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization report <input> [--mode <auto|audit|onboarding|scan>] [--format <markdown|html|json>] [--out <file>]"
+];
+
+async function handleAgentHandoff(args) {
+  const input = getRequiredInput(args, "agent-handoff");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createAgentHandoff(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent handoff",
+    artifact,
+    renderMarkdown: renderAgentHandoffMarkdown,
+    writeOutput: writeAgentHandoffOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleApplyPlan(args) {
+  const input = getRequiredInput(args, "apply-plan");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createApplyPlan(input, {
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "apply plan",
+    artifact,
+    renderMarkdown: renderApplyPlanMarkdown,
+    writeOutput: writeApplyPlanOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleCompletionReport(args) {
+  const input = getRequiredInput(args, "completion-report");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createCompletionReport(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "completion report",
+    artifact,
+    renderMarkdown: renderCompletionReportMarkdown,
+    writeOutput: writeCompletionReportOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleHandoffBundle(args) {
+  const input = getRequiredInput(args, "handoff-bundle");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createHandoffBundle(input, {
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "handoff bundle",
+    artifact,
+    renderMarkdown: renderHandoffBundleMarkdown,
+    writeOutput: writeHandoffBundleOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleSharePack(args) {
+  const input = getRequiredInput(args, "share-pack");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createSharePack(input, {
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "share pack",
+    artifact,
+    renderMarkdown: renderSharePackMarkdown,
+    writeOutput: writeSharePackOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleExportPack(args) {
+  const input = getRequiredInput(args, "export-pack");
+  const pack = await writeExportPack(input, {
+    format: getFlagValue(args, "--format"),
+    taskId: getFlagValue(args, "--task"),
+    outputDir: getFlagValue(args, "--out-dir")
+  });
+  process.stdout.write(renderExportPackMarkdown(pack));
+}
+
+async function handleHtmlPack(args) {
+  const input = getRequiredInput(args, "html-pack");
+  const pack = await writeHtmlPack(input, {
+    taskId: getFlagValue(args, "--task"),
+    outputDir: getFlagValue(args, "--out-dir")
+  });
+  process.stdout.write(renderHtmlPackMarkdown(pack));
+}
+
+async function handlePublishPack(args) {
+  const input = getRequiredInput(args, "publish-pack");
+  const pack = await writePublishPack(input, {
+    taskId: getFlagValue(args, "--task"),
+    outputDir: getFlagValue(args, "--out-dir")
+  });
+  process.stdout.write(renderPublishPackMarkdown(pack));
+}
+
+async function handleExecSummary(args) {
+  const input = getRequiredInput(args, "exec-summary");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createExecSummary(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "exec summary",
+    artifact,
+    renderMarkdown: renderExecSummaryMarkdown,
+    writeOutput: writeExecSummaryOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleFixPlan(args) {
+  const input = getRequiredInput(args, "fix-plan");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createFixPlan(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "fix plan",
+    artifact,
+    renderMarkdown: renderFixPlanMarkdown,
+    writeOutput: writeFixPlanOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleOwnerBoard(args) {
+  const input = getRequiredInput(args, "owner-board");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createOwnerBoard(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "owner board",
+    artifact,
+    renderMarkdown: renderOwnerBoardMarkdown,
+    writeOutput: writeOwnerBoardOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleMeetingPack(args) {
+  const input = getRequiredInput(args, "meeting-pack");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createMeetingPack(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "meeting pack",
+    artifact,
+    renderMarkdown: renderMeetingPackMarkdown,
+    writeOutput: writeMeetingPackOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handlePmBrief(args) {
+  const input = getRequiredInput(args, "pm-brief");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createPmBrief(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "PM brief",
+    artifact,
+    renderMarkdown: renderPmBriefMarkdown,
+    writeOutput: writePmBriefOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleRoadmap(args) {
+  const input = getRequiredInput(args, "roadmap");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createRoadmap(input, { format });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "roadmap",
+    artifact,
+    renderMarkdown: renderRoadmapMarkdown,
+    writeOutput: writeRoadmapOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleReport(args) {
+  const input = getRequiredInput(args, "report");
+  const maxFileSizeValue = getFlagValue(args, "--max-file-size");
+  const maxExamplesValue = getFlagValue(args, "--max-examples");
+  const report = await generateReport(input, {
+    mode: getFlagValue(args, "--mode"),
+    format: getFlagValue(args, "--format"),
+    maxFileSize: maxFileSizeValue ? parsePositiveInteger(maxFileSizeValue, "--max-file-size") : undefined,
+    maxExamples: maxExamplesValue ? parsePositiveInteger(maxExamplesValue, "--max-examples") : undefined
+  });
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeReportOutput(outputPath, report.content);
+    process.stdout.write(`已保存报告：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(report.content);
+}
+
+export const PLANNING_DELIVERY_COMMAND_HANDLERS = {
+  "agent-handoff": handleAgentHandoff,
+  "apply-plan": handleApplyPlan,
+  "completion-report": handleCompletionReport,
+  "handoff-bundle": handleHandoffBundle,
+  "share-pack": handleSharePack,
+  "export-pack": handleExportPack,
+  "html-pack": handleHtmlPack,
+  "publish-pack": handlePublishPack,
+  "exec-summary": handleExecSummary,
+  "fix-plan": handleFixPlan,
+  "owner-board": handleOwnerBoard,
+  "meeting-pack": handleMeetingPack,
+  "pm-brief": handlePmBrief,
+  roadmap: handleRoadmap,
+  report: handleReport
+};

package/src/cli.js

@@ -6,31 +6,17 @@ import {
   AGENT_EXECUTION_HELP_LINES
 } from "./cli-agent-execution-commands.js";
 import { FLOW_COMMAND_HANDLERS, FLOW_HELP_LINES } from "./cli-flow-commands.js";
-import { getFlagValue, hasFlag, parsePositiveInteger } from "./cli-shared.js";
-import { createApplyPlan, renderApplyPlanMarkdown, writeApplyPlanOutput } from "./apply-plan.js";
-import { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput } from "./agent-handoff.js";
 import {
-  createCompletionReport,
-  renderCompletionReportMarkdown,
-  writeCompletionReportOutput
-} from "./completion-report.js";
-import { createHandoffBundle, renderHandoffBundleMarkdown, writeHandoffBundleOutput } from "./handoff-bundle.js";
+  PLANNING_DELIVERY_COMMAND_HANDLERS,
+  PLANNING_DELIVERY_HELP_LINES
+} from "./cli-planning-delivery-commands.js";
+import { getFlagValue, hasFlag, parsePositiveInteger } from "./cli-shared.js";
 import { installSkill } from "./install-skill.js";
 import { getBundledSkillPath, getInstalledSkillPath, getSkillName, getSkillsDir } from "./paths.js";
 import { renderScanMarkdown, scanProject, writeScanOutput } from "./scan.js";
 import { renderDoctorMarkdown, runDoctor } from "./doctor.js";
 import { createLlmsTxt } from "./llms-txt.js";
 import { auditProject, renderAuditMarkdown, writeAuditOutput } from "./audit.js";
-import { createFixPlan, renderFixPlanMarkdown, writeFixPlanOutput } from "./fix-plan.js";
-import { createExecSummary, renderExecSummaryMarkdown, writeExecSummaryOutput } from "./exec-summary.js";
-import { renderExportPackMarkdown, writeExportPack } from "./export-pack.js";
-import { renderHtmlPackMarkdown, writeHtmlPack } from "./html-pack.js";
-import { createOwnerBoard, renderOwnerBoardMarkdown, writeOwnerBoardOutput } from "./owner-board.js";
-import { createMeetingPack, renderMeetingPackMarkdown, writeMeetingPackOutput } from "./meeting-pack.js";
-import { createPmBrief, renderPmBriefMarkdown, writePmBriefOutput } from "./pm-brief.js";
-import { renderPublishPackMarkdown, writePublishPack } from "./publish-pack.js";
-import { generateReport, writeReportOutput } from "./report.js";
-import { createRoadmap, renderRoadmapMarkdown, writeRoadmapOutput } from "./roadmap.js";
 import {
   renderInteractiveOnboardingMarkdown,
   runInteractiveOnboarding,
@@ -38,7 +24,6 @@ import {
 } from "./interactive-onboarding.js";
 import { createQuickStartPlan, renderQuickStartMarkdown, writeQuickStartOutput } from "./quick-start.js";
 import { createSchemaTemplate } from "./schema.js";
-import { createSharePack, renderSharePackMarkdown, writeSharePackOutput } from "./share-pack.js";
 import { listBundledSkills, renderBundledSkillsMarkdown } from "./skills.js";
 import { analyzeWebsiteUrl, renderWebsiteOnboardingMarkdown, writeWebsiteOnboardingOutput } from "./url-onboarding.js";
 
@@ -65,6 +50,7 @@ function printHelp() {
       "  geo-ai-search-optimization install [--target <dir>] [--json]",
       ...FLOW_HELP_LINES,
       ...AGENT_EXECUTION_HELP_LINES,
+      ...PLANNING_DELIVERY_HELP_LINES,
       "  geo-ai-search-optimization skills [--json]",
       "  geo-ai-search-optimization where",
       "  geo-ai-search-optimization doctor [--json]",
@@ -74,21 +60,6 @@ function printHelp() {
       "  geo-ai-search-optimization init-llms [target-dir] [--site-name <name>] [--site-url <url>] [--overwrite] [--json]",
       "  geo-ai-search-optimization init-schema <type> [target-dir] [--site-url <url>] [--overwrite] [--json]",
       "  geo-ai-search-optimization audit <project-path> [--json] [--out <file>] [--max-file-size <bytes>] [--max-examples <count>]",
-      "  geo-ai-search-optimization agent-handoff <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization apply-plan <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization completion-report <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization handoff-bundle <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization share-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization export-pack <input> [--task <id>] [--format <markdown|json>] [--out-dir <dir>]",
-      "  geo-ai-search-optimization html-pack <input> [--task <id>] [--out-dir <dir>]",
-      "  geo-ai-search-optimization publish-pack <input> [--task <id>] [--out-dir <dir>]",
-      "  geo-ai-search-optimization exec-summary <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization fix-plan <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization owner-board <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization meeting-pack <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization pm-brief <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization roadmap <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization report <input> [--mode <auto|audit|onboarding|scan>] [--format <markdown|html|json>] [--out <file>]",
       "  geo-ai-search-optimization scan <project-path> [--json] [--out <file>] [--max-file-size <bytes>] [--max-examples <count>]",
       "  geo-ai-search-optimization version",
       "  geo-ai-search-optimization help",
@@ -304,340 +275,11 @@ async function handleAudit(args) {
   process.stdout.write(renderedOutput);
 }
 
-async function handleReport(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("report 需要一个输入值，可以是本地项目路径或网站网址");
-  }
-
-  const maxFileSizeValue = getFlagValue(args, "--max-file-size");
-  const maxExamplesValue = getFlagValue(args, "--max-examples");
-  const report = await generateReport(input, {
-    mode: getFlagValue(args, "--mode"),
-    format: getFlagValue(args, "--format"),
-    maxFileSize: maxFileSizeValue ? parsePositiveInteger(maxFileSizeValue, "--max-file-size") : undefined,
-    maxExamples: maxExamplesValue ? parsePositiveInteger(maxExamplesValue, "--max-examples") : undefined
-  });
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeReportOutput(outputPath, report.content);
-    process.stdout.write(`已保存报告：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(report.content);
-}
-
-async function handleFixPlan(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("fix-plan 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const plan = await createFixPlan(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(plan, null, 2)}\n`
-    : renderFixPlanMarkdown(plan);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeFixPlanOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 fix plan：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentHandoff(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-handoff 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const handoff = await createAgentHandoff(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(handoff, null, 2)}\n`
-    : renderAgentHandoffMarkdown(handoff);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentHandoffOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent handoff：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleApplyPlan(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("apply-plan 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const plan = await createApplyPlan(input, {
-    format,
-    taskId: getFlagValue(args, "--task")
-  });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(plan, null, 2)}\n`
-    : renderApplyPlanMarkdown(plan);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeApplyPlanOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 apply plan：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleCompletionReport(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("completion-report 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const report = await createCompletionReport(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(report, null, 2)}\n`
-    : renderCompletionReportMarkdown(report);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeCompletionReportOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 completion report：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleHandoffBundle(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("handoff-bundle 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const bundle = await createHandoffBundle(input, {
-    format,
-    taskId: getFlagValue(args, "--task")
-  });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(bundle, null, 2)}\n`
-    : renderHandoffBundleMarkdown(bundle);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeHandoffBundleOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 handoff bundle：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleSharePack(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("share-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const pack = await createSharePack(input, {
-    format,
-    taskId: getFlagValue(args, "--task")
-  });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(pack, null, 2)}\n`
-    : renderSharePackMarkdown(pack);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeSharePackOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 share pack：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleExportPack(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("export-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
-  }
-
-  const pack = await writeExportPack(input, {
-    format: getFlagValue(args, "--format"),
-    taskId: getFlagValue(args, "--task"),
-    outputDir: getFlagValue(args, "--out-dir")
-  });
-
-  process.stdout.write(renderExportPackMarkdown(pack));
-}
-
-async function handleHtmlPack(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("html-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
-  }
-
-  const pack = await writeHtmlPack(input, {
-    taskId: getFlagValue(args, "--task"),
-    outputDir: getFlagValue(args, "--out-dir")
-  });
-
-  process.stdout.write(renderHtmlPackMarkdown(pack));
-}
-
-async function handlePublishPack(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("publish-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 工件");
-  }
-
-  const pack = await writePublishPack(input, {
-    taskId: getFlagValue(args, "--task"),
-    outputDir: getFlagValue(args, "--out-dir")
-  });
-
-  process.stdout.write(renderPublishPackMarkdown(pack));
-}
-
-async function handleExecSummary(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("exec-summary 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const summary = await createExecSummary(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(summary, null, 2)}\n`
-    : renderExecSummaryMarkdown(summary);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeExecSummaryOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 exec summary：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleOwnerBoard(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("owner-board 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const board = await createOwnerBoard(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(board, null, 2)}\n`
-    : renderOwnerBoardMarkdown(board);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeOwnerBoardOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 owner board：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleMeetingPack(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("meeting-pack 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const pack = await createMeetingPack(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(pack, null, 2)}\n`
-    : renderMeetingPackMarkdown(pack);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeMeetingPackOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 meeting pack：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handlePmBrief(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("pm-brief 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const brief = await createPmBrief(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(brief, null, 2)}\n`
-    : renderPmBriefMarkdown(brief);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writePmBriefOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 PM brief：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleRoadmap(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("roadmap 需要一个输入值，可以是项目路径、网站网址或已导出的 JSON 报告");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const roadmap = await createRoadmap(input, { format });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(roadmap, null, 2)}\n`
-    : renderRoadmapMarkdown(roadmap);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeRoadmapOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 roadmap：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
 export async function runCli(args = []) {
   const [command = "install", ...rest] = args;
   const flowHandler = FLOW_COMMAND_HANDLERS[command];
   const agentExecutionHandler = AGENT_EXECUTION_COMMAND_HANDLERS[command];
+  const planningDeliveryHandler = PLANNING_DELIVERY_COMMAND_HANDLERS[command];
 
   if (command === "help" || command === "--help" || command === "-h") {
     printHelp();
@@ -664,48 +306,8 @@ export async function runCli(args = []) {
     return;
   }
 
-  if (command === "agent-runbook") {
-    await handleAgentRunbook(rest);
-    return;
-  }
-
-  if (command === "agent-executor") {
-    await handleAgentExecutor(rest);
-    return;
-  }
-
-  if (command === "agent-batch-executor") {
-    await handleAgentBatchExecutor(rest);
-    return;
-  }
-
-  if (command === "agent-progress-tracker") {
-    await handleAgentProgressTracker(rest);
-    return;
-  }
-
-  if (command === "agent-status-board") {
-    await handleAgentStatusBoard(rest);
-    return;
-  }
-
-  if (command === "agent-checkpoint") {
-    await handleAgentCheckpoint(rest);
-    return;
-  }
-
-  if (command === "agent-decision-log") {
-    await handleAgentDecisionLog(rest);
-    return;
-  }
-
-  if (command === "agent-retrospective") {
-    await handleAgentRetrospective(rest);
-    return;
-  }
-
-  if (command === "agent-playbook-pack") {
-    await handleAgentPlaybookPack(rest);
+  if (planningDeliveryHandler) {
+    await planningDeliveryHandler(rest);
     return;
   }
 
@@ -754,81 +356,6 @@ export async function runCli(args = []) {
     return;
   }
 
-  if (command === "agent-handoff") {
-    await handleAgentHandoff(rest);
-    return;
-  }
-
-  if (command === "apply-plan") {
-    await handleApplyPlan(rest);
-    return;
-  }
-
-  if (command === "completion-report") {
-    await handleCompletionReport(rest);
-    return;
-  }
-
-  if (command === "handoff-bundle") {
-    await handleHandoffBundle(rest);
-    return;
-  }
-
-  if (command === "share-pack") {
-    await handleSharePack(rest);
-    return;
-  }
-
-  if (command === "export-pack") {
-    await handleExportPack(rest);
-    return;
-  }
-
-  if (command === "html-pack") {
-    await handleHtmlPack(rest);
-    return;
-  }
-
-  if (command === "publish-pack") {
-    await handlePublishPack(rest);
-    return;
-  }
-
-  if (command === "exec-summary") {
-    await handleExecSummary(rest);
-    return;
-  }
-
-  if (command === "fix-plan") {
-    await handleFixPlan(rest);
-    return;
-  }
-
-  if (command === "owner-board") {
-    await handleOwnerBoard(rest);
-    return;
-  }
-
-  if (command === "meeting-pack") {
-    await handleMeetingPack(rest);
-    return;
-  }
-
-  if (command === "pm-brief") {
-    await handlePmBrief(rest);
-    return;
-  }
-
-  if (command === "roadmap") {
-    await handleRoadmap(rest);
-    return;
-  }
-
-  if (command === "report") {
-    await handleReport(rest);
-    return;
-  }
-
   if (command === "scan") {
     await handleScan(rest);
     return;