geo-ai-search-optimization 1.3.2 → 1.3.4

package/README.md

@@ -851,6 +851,20 @@ geo-ai-search-optimization help
 - 新增 `src/cli-shared.js`，集中处理 flag 解析、输入校验和输出写回，降低后续继续加命令时的耦合
 - 主 `cli.js` 现在更像薄路由层，后续扩充 command family 会更稳
 
+## New in 1.3.3
+
+- 继续做 CLI 架构迭代，把 agent execution family 也从主 `cli.js` 拆出
+- 新增 `src/cli-agent-execution-commands.js`，接管 `agent-runbook / agent-executor / agent-batch-executor / agent-progress-tracker / agent-status-board / agent-checkpoint / agent-decision-log / agent-retrospective / agent-playbook-pack`
+- 主 `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.2",
+  "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-agent-execution-commands.js

@@ -0,0 +1,210 @@
+import {
+  createAgentBatchExecutor,
+  renderAgentBatchExecutorMarkdown,
+  writeAgentBatchExecutorOutput
+} from "./agent-batch-executor.js";
+import { createAgentExecutor, renderAgentExecutorMarkdown, writeAgentExecutorOutput } from "./agent-executor.js";
+import {
+  createAgentProgressTracker,
+  renderAgentProgressTrackerMarkdown,
+  writeAgentProgressTrackerOutput
+} from "./agent-progress-tracker.js";
+import { createAgentCheckpoint, renderAgentCheckpointMarkdown, writeAgentCheckpointOutput } from "./agent-checkpoint.js";
+import { createAgentDecisionLog, renderAgentDecisionLogMarkdown, writeAgentDecisionLogOutput } from "./agent-decision-log.js";
+import {
+  createAgentPlaybookPack,
+  renderAgentPlaybookPackMarkdown,
+  writeAgentPlaybookPackOutput
+} from "./agent-playbook-pack.js";
+import { createAgentRetrospective, renderAgentRetrospectiveMarkdown, writeAgentRetrospectiveOutput } from "./agent-retrospective.js";
+import { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
+import { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
+import {
+  getFlagValue,
+  getJsonCapableFormat,
+  getRequiredInput,
+  writeOrPrintArtifact
+} from "./cli-shared.js";
+
+export const AGENT_EXECUTION_HELP_LINES = [
+  "  geo-ai-search-optimization agent-runbook <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-batch-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--count <count>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-progress-tracker <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-status-board <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-checkpoint <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-decision-log <input> [--append-from <file>] [--note <text>] [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-retrospective <input> [--format <markdown|json>] [--out <file>]",
+  "  geo-ai-search-optimization agent-playbook-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]"
+];
+
+async function handleAgentRunbook(args) {
+  const input = getRequiredInput(args, "agent-runbook");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createAgentRunbook(input, {
+    intent: getFlagValue(args, "--intent"),
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent runbook",
+    artifact,
+    renderMarkdown: renderAgentRunbookMarkdown,
+    writeOutput: writeAgentRunbookOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleAgentExecutor(args) {
+  const input = getRequiredInput(args, "agent-executor");
+  const format = getFlagValue(args, "--format");
+  const artifact = await createAgentExecutor(input, {
+    intent: getFlagValue(args, "--intent"),
+    format,
+    taskId: getFlagValue(args, "--task")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent executor",
+    artifact,
+    renderMarkdown: renderAgentExecutorMarkdown,
+    writeOutput: writeAgentExecutorOutput,
+    outputJson: format === "json"
+  });
+}
+
+async function handleAgentBatchExecutor(args) {
+  const input = getRequiredInput(args, "agent-batch-executor");
+  const artifact = await createAgentBatchExecutor(input, {
+    intent: getFlagValue(args, "--intent"),
+    format: getJsonCapableFormat(args),
+    taskId: getFlagValue(args, "--task"),
+    count: getFlagValue(args, "--count")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent batch executor",
+    artifact,
+    renderMarkdown: renderAgentBatchExecutorMarkdown,
+    writeOutput: writeAgentBatchExecutorOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+async function handleAgentProgressTracker(args) {
+  const input = getRequiredInput(args, "agent-progress-tracker");
+  const artifact = await createAgentProgressTracker(input, {
+    format: getJsonCapableFormat(args),
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent progress tracker",
+    artifact,
+    renderMarkdown: renderAgentProgressTrackerMarkdown,
+    writeOutput: writeAgentProgressTrackerOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+async function handleAgentStatusBoard(args) {
+  const input = getRequiredInput(args, "agent-status-board");
+  const artifact = await createAgentStatusBoard(input, {
+    format: getJsonCapableFormat(args),
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent status board",
+    artifact,
+    renderMarkdown: renderAgentStatusBoardMarkdown,
+    writeOutput: writeAgentStatusBoardOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+async function handleAgentCheckpoint(args) {
+  const input = getRequiredInput(args, "agent-checkpoint");
+  const artifact = await createAgentCheckpoint(input, {
+    format: getJsonCapableFormat(args),
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent checkpoint",
+    artifact,
+    renderMarkdown: renderAgentCheckpointMarkdown,
+    writeOutput: writeAgentCheckpointOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+async function handleAgentDecisionLog(args) {
+  const input = getRequiredInput(args, "agent-decision-log");
+  const artifact = await createAgentDecisionLog(input, {
+    format: getJsonCapableFormat(args),
+    appendFrom: getFlagValue(args, "--append-from"),
+    note: getFlagValue(args, "--note"),
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent decision log",
+    artifact,
+    renderMarkdown: renderAgentDecisionLogMarkdown,
+    writeOutput: writeAgentDecisionLogOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+async function handleAgentRetrospective(args) {
+  const input = getRequiredInput(args, "agent-retrospective");
+  const artifact = await createAgentRetrospective(input, {
+    format: getJsonCapableFormat(args)
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent retrospective",
+    artifact,
+    renderMarkdown: renderAgentRetrospectiveMarkdown,
+    writeOutput: writeAgentRetrospectiveOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+async function handleAgentPlaybookPack(args) {
+  const input = getRequiredInput(args, "agent-playbook-pack");
+  const artifact = await createAgentPlaybookPack(input, {
+    format: getJsonCapableFormat(args),
+    taskId: getFlagValue(args, "--task")
+  });
+  return writeOrPrintArtifact({
+    args,
+    commandName: "agent playbook pack",
+    artifact,
+    renderMarkdown: renderAgentPlaybookPackMarkdown,
+    writeOutput: writeAgentPlaybookPackOutput,
+    outputJson: artifact.format === "json"
+  });
+}
+
+export const AGENT_EXECUTION_COMMAND_HANDLERS = {
+  "agent-runbook": handleAgentRunbook,
+  "agent-executor": handleAgentExecutor,
+  "agent-batch-executor": handleAgentBatchExecutor,
+  "agent-progress-tracker": handleAgentProgressTracker,
+  "agent-status-board": handleAgentStatusBoard,
+  "agent-checkpoint": handleAgentCheckpoint,
+  "agent-decision-log": handleAgentDecisionLog,
+  "agent-retrospective": handleAgentRetrospective,
+  "agent-playbook-pack": handleAgentPlaybookPack
+};

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

@@ -1,53 +1,22 @@
 import { fileURLToPath } from "node:url";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-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 {
-  createAgentBatchExecutor,
-  renderAgentBatchExecutorMarkdown,
-  writeAgentBatchExecutorOutput
-} from "./agent-batch-executor.js";
-import { createAgentExecutor, renderAgentExecutorMarkdown, writeAgentExecutorOutput } from "./agent-executor.js";
-import { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput } from "./agent-handoff.js";
 import {
-  createAgentProgressTracker,
-  renderAgentProgressTrackerMarkdown,
-  writeAgentProgressTrackerOutput
-} from "./agent-progress-tracker.js";
-import { createAgentCheckpoint, renderAgentCheckpointMarkdown, writeAgentCheckpointOutput } from "./agent-checkpoint.js";
-import { createAgentDecisionLog, renderAgentDecisionLogMarkdown, writeAgentDecisionLogOutput } from "./agent-decision-log.js";
-import {
-  createAgentPlaybookPack,
-  renderAgentPlaybookPackMarkdown,
-  writeAgentPlaybookPackOutput
-} from "./agent-playbook-pack.js";
-import { createAgentRetrospective, renderAgentRetrospectiveMarkdown, writeAgentRetrospectiveOutput } from "./agent-retrospective.js";
-import { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
-import { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
+  AGENT_EXECUTION_COMMAND_HANDLERS,
+  AGENT_EXECUTION_HELP_LINES
+} from "./cli-agent-execution-commands.js";
+import { FLOW_COMMAND_HANDLERS, FLOW_HELP_LINES } from "./cli-flow-commands.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,
@@ -55,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";
 
@@ -81,15 +49,8 @@ function printHelp() {
       "  geo-ai-search-optimization",
       "  geo-ai-search-optimization install [--target <dir>] [--json]",
       ...FLOW_HELP_LINES,
-      "  geo-ai-search-optimization agent-runbook <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-batch-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--count <count>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-progress-tracker <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-status-board <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-checkpoint <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-decision-log <input> [--append-from <file>] [--note <text>] [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-retrospective <input> [--format <markdown|json>] [--out <file>]",
-      "  geo-ai-search-optimization agent-playbook-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+      ...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]",
@@ -99,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",
@@ -137,253 +83,6 @@ async function handleInstall(args) {
   }
 }
 
-async function handleAgentRunbook(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-runbook 需要一个输入值，可以是任务描述、项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const runbook = await createAgentRunbook(input, {
-    intent: getFlagValue(args, "--intent"),
-    format,
-    taskId: getFlagValue(args, "--task")
-  });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(runbook, null, 2)}\n`
-    : renderAgentRunbookMarkdown(runbook);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentRunbookOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent runbook：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentExecutor(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-executor 需要一个输入值，可以是任务描述、项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format");
-  const executor = await createAgentExecutor(input, {
-    intent: getFlagValue(args, "--intent"),
-    format,
-    taskId: getFlagValue(args, "--task")
-  });
-  const outputJson = format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(executor, null, 2)}\n`
-    : renderAgentExecutorMarkdown(executor);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentExecutorOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent executor：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentBatchExecutor(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-batch-executor 需要一个输入值，可以是任务描述、项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const batch = await createAgentBatchExecutor(input, {
-    intent: getFlagValue(args, "--intent"),
-    format,
-    taskId: getFlagValue(args, "--task"),
-    count: getFlagValue(args, "--count")
-  });
-  const outputJson = batch.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(batch, null, 2)}\n`
-    : renderAgentBatchExecutorMarkdown(batch);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentBatchExecutorOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent batch executor：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentProgressTracker(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-progress-tracker 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const tracker = await createAgentProgressTracker(input, {
-    format,
-    currentTaskId: getFlagValue(args, "--current"),
-    completedPacketIds: getFlagValue(args, "--completed"),
-    blockedReasons: getFlagValue(args, "--blocked")
-  });
-  const outputJson = tracker.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(tracker, null, 2)}\n`
-    : renderAgentProgressTrackerMarkdown(tracker);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentProgressTrackerOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent progress tracker：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentStatusBoard(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-status-board 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const board = await createAgentStatusBoard(input, {
-    format,
-    currentTaskId: getFlagValue(args, "--current"),
-    completedPacketIds: getFlagValue(args, "--completed"),
-    blockedReasons: getFlagValue(args, "--blocked")
-  });
-  const outputJson = board.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(board, null, 2)}\n`
-    : renderAgentStatusBoardMarkdown(board);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentStatusBoardOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent status board：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentCheckpoint(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-checkpoint 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const checkpoint = await createAgentCheckpoint(input, {
-    format,
-    currentTaskId: getFlagValue(args, "--current"),
-    completedPacketIds: getFlagValue(args, "--completed"),
-    blockedReasons: getFlagValue(args, "--blocked")
-  });
-  const outputJson = checkpoint.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(checkpoint, null, 2)}\n`
-    : renderAgentCheckpointMarkdown(checkpoint);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentCheckpointOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent checkpoint：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentDecisionLog(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-decision-log 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const decisionLog = await createAgentDecisionLog(input, {
-    format,
-    appendFrom: getFlagValue(args, "--append-from"),
-    note: getFlagValue(args, "--note"),
-    currentTaskId: getFlagValue(args, "--current"),
-    completedPacketIds: getFlagValue(args, "--completed"),
-    blockedReasons: getFlagValue(args, "--blocked")
-  });
-  const outputJson = decisionLog.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(decisionLog, null, 2)}\n`
-    : renderAgentDecisionLogMarkdown(decisionLog);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentDecisionLogOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent decision log：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentRetrospective(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-retrospective 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const retrospective = await createAgentRetrospective(input, {
-    format
-  });
-  const outputJson = retrospective.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(retrospective, null, 2)}\n`
-    : renderAgentRetrospectiveMarkdown(retrospective);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentRetrospectiveOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent retrospective：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAgentPlaybookPack(args) {
-  const input = args.find((value) => !value.startsWith("-"));
-  if (!input) {
-    throw new Error("agent-playbook-pack 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
-  }
-
-  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
-  const pack = await createAgentPlaybookPack(input, {
-    format,
-    taskId: getFlagValue(args, "--task")
-  });
-  const outputJson = pack.format === "json";
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(pack, null, 2)}\n`
-    : renderAgentPlaybookPackMarkdown(pack);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAgentPlaybookPackOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 agent playbook pack：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
 function handleWhere() {
   process.stdout.write(
     [
@@ -576,339 +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();
@@ -930,48 +301,13 @@ 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);
+  if (agentExecutionHandler) {
+    await agentExecutionHandler(rest);
     return;
   }
 
-  if (command === "agent-playbook-pack") {
-    await handleAgentPlaybookPack(rest);
+  if (planningDeliveryHandler) {
+    await planningDeliveryHandler(rest);
     return;
   }
 
@@ -1020,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;