geo-ai-search-optimization 1.3.12 → 1.3.14

package/README.md

@@ -924,6 +924,20 @@ geo-ai-search-optimization help
 - `src/cli-shell-commands.js` 与 `src/cli-flow-commands.js` 现在由同一份声明同时生成 help lines 和 handlers
 - CLI 开始从“多个 handler 文件”进一步推进到“显式 command registry”模式
 
+## New in 1.3.13
+
+- 把 registry metadata 推广到 `agent-execution` 命令族
+- `src/cli-agent-execution-commands.js` 现在由同一份 registry 同时生成 help lines 和 handlers
+- `agent-runbook / agent-executor / agent-batch-executor / agent-progress-tracker / agent-status-board / agent-checkpoint / agent-decision-log / agent-retrospective / agent-playbook-pack` 已统一进入 registry
+- CLI 距离“所有命令族都使用显式 registry metadata”又更近一步
+
+## New in 1.3.14
+
+- 把 registry metadata 推广到 `planning-delivery` 命令族
+- `src/cli-planning-delivery-commands.js` 现在由同一份 registry 同时生成 help lines 和 handlers
+- `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` 已统一进入 registry
+- CLI 更接近所有命令族都使用显式 registry metadata 的结构
+
 ## New in 1.2.20
 
 - 新增 `agent-continue`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.3.12",
+  "version": "1.3.14",
   "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

@@ -20,6 +20,7 @@ import { createAgentRetrospective, renderAgentRetrospectiveMarkdown, writeAgentR
 import { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
 import { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
 import {
+  buildCommandRegistry,
   buildIntentTaskFormatOptions,
   buildJsonCapableFormatOptions,
   buildProgressFormatOptions,
@@ -28,18 +29,6 @@ import {
   getFlagValue
 } 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>]"
-];
-
 const handleAgentRunbook = createArtifactCommandHandler({
   commandName: "agent-runbook",
   commandLabel: "agent runbook",
@@ -131,14 +120,53 @@ const handleAgentPlaybookPack = createArtifactCommandHandler({
   })
 });
 
-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
-};
+const AGENT_EXECUTION_COMMAND_REGISTRY = buildCommandRegistry([
+  {
+    name: "agent-runbook",
+    help: "  geo-ai-search-optimization agent-runbook <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentRunbook
+  },
+  {
+    name: "agent-executor",
+    help: "  geo-ai-search-optimization agent-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentExecutor
+  },
+  {
+    name: "agent-batch-executor",
+    help: "  geo-ai-search-optimization agent-batch-executor <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--task <id>] [--count <count>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentBatchExecutor
+  },
+  {
+    name: "agent-progress-tracker",
+    help: "  geo-ai-search-optimization agent-progress-tracker <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentProgressTracker
+  },
+  {
+    name: "agent-status-board",
+    help: "  geo-ai-search-optimization agent-status-board <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentStatusBoard
+  },
+  {
+    name: "agent-checkpoint",
+    help: "  geo-ai-search-optimization agent-checkpoint <input> [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentCheckpoint
+  },
+  {
+    name: "agent-decision-log",
+    help: "  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>]",
+    handler: handleAgentDecisionLog
+  },
+  {
+    name: "agent-retrospective",
+    help: "  geo-ai-search-optimization agent-retrospective <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentRetrospective
+  },
+  {
+    name: "agent-playbook-pack",
+    help: "  geo-ai-search-optimization agent-playbook-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentPlaybookPack
+  }
+]);
+
+export const AGENT_EXECUTION_HELP_LINES = AGENT_EXECUTION_COMMAND_REGISTRY.helpLines;
+export const AGENT_EXECUTION_COMMAND_HANDLERS = AGENT_EXECUTION_COMMAND_REGISTRY.handlers;

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

@@ -18,6 +18,7 @@ import { generateReport, writeReportOutput } from "./report.js";
 import { createRoadmap, renderRoadmapMarkdown, writeRoadmapOutput } from "./roadmap.js";
 import { createSharePack, renderSharePackMarkdown, writeSharePackOutput } from "./share-pack.js";
 import {
+  buildCommandRegistry,
   buildFormatOptions,
   buildTaskFormatOutputDirOptions,
   buildTaskOutputDirOptions,
@@ -29,24 +30,6 @@ import {
   parsePositiveInteger
 } 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>]"
-];
-
 const handleAgentHandoff = createArtifactCommandHandler({
   commandName: "agent-handoff",
   commandLabel: "agent handoff",
@@ -184,20 +167,83 @@ const handleReport = createContentCommandHandler({
   writeOutput: writeReportOutput
 });
 
-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
-};
+const PLANNING_DELIVERY_COMMAND_REGISTRY = buildCommandRegistry([
+  {
+    name: "agent-handoff",
+    help: "  geo-ai-search-optimization agent-handoff <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentHandoff
+  },
+  {
+    name: "apply-plan",
+    help: "  geo-ai-search-optimization apply-plan <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+    handler: handleApplyPlan
+  },
+  {
+    name: "completion-report",
+    help: "  geo-ai-search-optimization completion-report <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleCompletionReport
+  },
+  {
+    name: "handoff-bundle",
+    help: "  geo-ai-search-optimization handoff-bundle <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+    handler: handleHandoffBundle
+  },
+  {
+    name: "share-pack",
+    help: "  geo-ai-search-optimization share-pack <input> [--task <id>] [--format <markdown|json>] [--out <file>]",
+    handler: handleSharePack
+  },
+  {
+    name: "export-pack",
+    help: "  geo-ai-search-optimization export-pack <input> [--task <id>] [--format <markdown|json>] [--out-dir <dir>]",
+    handler: handleExportPack
+  },
+  {
+    name: "html-pack",
+    help: "  geo-ai-search-optimization html-pack <input> [--task <id>] [--out-dir <dir>]",
+    handler: handleHtmlPack
+  },
+  {
+    name: "publish-pack",
+    help: "  geo-ai-search-optimization publish-pack <input> [--task <id>] [--out-dir <dir>]",
+    handler: handlePublishPack
+  },
+  {
+    name: "exec-summary",
+    help: "  geo-ai-search-optimization exec-summary <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleExecSummary
+  },
+  {
+    name: "fix-plan",
+    help: "  geo-ai-search-optimization fix-plan <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleFixPlan
+  },
+  {
+    name: "owner-board",
+    help: "  geo-ai-search-optimization owner-board <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleOwnerBoard
+  },
+  {
+    name: "meeting-pack",
+    help: "  geo-ai-search-optimization meeting-pack <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleMeetingPack
+  },
+  {
+    name: "pm-brief",
+    help: "  geo-ai-search-optimization pm-brief <input> [--format <markdown|json>] [--out <file>]",
+    handler: handlePmBrief
+  },
+  {
+    name: "roadmap",
+    help: "  geo-ai-search-optimization roadmap <input> [--format <markdown|json>] [--out <file>]",
+    handler: handleRoadmap
+  },
+  {
+    name: "report",
+    help: "  geo-ai-search-optimization report <input> [--mode <auto|audit|onboarding|scan>] [--format <markdown|html|json>] [--out <file>]",
+    handler: handleReport
+  }
+]);
+
+export const PLANNING_DELIVERY_HELP_LINES = PLANNING_DELIVERY_COMMAND_REGISTRY.helpLines;
+export const PLANNING_DELIVERY_COMMAND_HANDLERS = PLANNING_DELIVERY_COMMAND_REGISTRY.handlers;