geo-ai-search-optimization 1.3.11 → 1.3.13

package/README.md

@@ -917,6 +917,20 @@ geo-ai-search-optimization help
 - `export-pack / html-pack / publish-pack` 也开始复用共享 output-dir / task builder
 - CLI 更接近统一的 command registry，而不是混合少数特例 handler
 
+## New in 1.3.12
+
+- 开始把命令说明与 handler 收敛成同源 registry metadata
+- `src/cli-shared.js` 新增 `buildCommandRegistry`
+- `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.2.20
 
 - 新增 `agent-continue`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "geo-ai-search-optimization",
-  "version": "1.3.11",
+  "version": "1.3.13",
   "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-flow-commands.js

@@ -17,6 +17,7 @@ import {
 } from "./agent-state-pack.js";
 import { createAgentSession, renderAgentSessionMarkdown, writeAgentSessionOutput } from "./agent-session.js";
 import {
+  buildCommandRegistry,
   buildIntentFormatOptions,
   buildIntentProgressFormatOptions,
   createArtifactCommandHandler,
@@ -26,15 +27,6 @@ import {
   hasFlag
 } from "./cli-shared.js";
 
-export const FLOW_HELP_LINES = [
-  "  geo-ai-search-optimization agent-orchestrator <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
-  "  geo-ai-search-optimization agent-resume <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
-  "  geo-ai-search-optimization agent-continue <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
-  "  geo-ai-search-optimization agent-state-pack <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
-  "  geo-ai-search-optimization auto-flow <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--json] [--out <file>]",
-  "  geo-ai-search-optimization agent-session <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--json] [--out <file>]"
-];
-
 const handleAutoFlow = createStructuredOutputCommandHandler({
   commandLabel: "auto-flow",
   execute: async (args) => {
@@ -96,11 +88,38 @@ const handleAgentSession = createArtifactCommandHandler({
   })
 });
 
-export const FLOW_COMMAND_HANDLERS = {
-  "auto-flow": handleAutoFlow,
-  "agent-orchestrator": handleAgentOrchestrator,
-  "agent-resume": handleAgentResume,
-  "agent-continue": handleAgentContinue,
-  "agent-state-pack": handleAgentStatePack,
-  "agent-session": handleAgentSession
-};
+const FLOW_COMMAND_REGISTRY = buildCommandRegistry([
+  {
+    name: "agent-orchestrator",
+    help: "  geo-ai-search-optimization agent-orchestrator <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentOrchestrator
+  },
+  {
+    name: "agent-resume",
+    help: "  geo-ai-search-optimization agent-resume <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentResume
+  },
+  {
+    name: "agent-continue",
+    help: "  geo-ai-search-optimization agent-continue <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentContinue
+  },
+  {
+    name: "agent-state-pack",
+    help: "  geo-ai-search-optimization agent-state-pack <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--current <id>] [--completed <id,id>] [--blocked <reason,reason>] [--format <markdown|json>] [--out <file>]",
+    handler: handleAgentStatePack
+  },
+  {
+    name: "auto-flow",
+    help: "  geo-ai-search-optimization auto-flow <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--json] [--out <file>]",
+    handler: handleAutoFlow
+  },
+  {
+    name: "agent-session",
+    help: "  geo-ai-search-optimization agent-session <input> [--intent <auto|diagnose|guide|execute|share|closeout>] [--json] [--out <file>]",
+    handler: handleAgentSession
+  }
+]);
+
+export const FLOW_HELP_LINES = FLOW_COMMAND_REGISTRY.helpLines;
+export const FLOW_COMMAND_HANDLERS = FLOW_COMMAND_REGISTRY.handlers;

package/src/cli-shared.js

@@ -244,3 +244,10 @@ export function createContentCommandHandler({
     process.stdout.write(content);
   };
 }
+
+export function buildCommandRegistry(commandEntries) {
+  return {
+    helpLines: commandEntries.map((entry) => entry.help),
+    handlers: Object.fromEntries(commandEntries.map((entry) => [entry.name, entry.handler]))
+  };
+}

package/src/cli-shell-commands.js

@@ -1,14 +1,8 @@
-import { createActionCommandHandler, getFlagValue, hasFlag } from "./cli-shared.js";
+import { buildCommandRegistry, createActionCommandHandler, getFlagValue, hasFlag } from "./cli-shared.js";
 import { installSkill } from "./install-skill.js";
 import { getBundledSkillPath, getInstalledSkillPath, getSkillName, getSkillsDir } from "./paths.js";
 import { listBundledSkills, renderBundledSkillsMarkdown } from "./skills.js";
 
-export const SHELL_HELP_LINES = [
-  "  geo-ai-search-optimization install [--target <dir>] [--json]",
-  "  geo-ai-search-optimization skills [--json]",
-  "  geo-ai-search-optimization where"
-];
-
 const handleInstall = createActionCommandHandler({
   execute: async (args) => {
     const outputJson = hasFlag(args, "--json");
@@ -41,8 +35,23 @@ function handleWhere() {
   );
 }
 
-export const SHELL_COMMAND_HANDLERS = {
-  install: handleInstall,
-  skills: handleSkills,
-  where: handleWhere
-};
+const SHELL_COMMAND_REGISTRY = buildCommandRegistry([
+  {
+    name: "install",
+    help: "  geo-ai-search-optimization install [--target <dir>] [--json]",
+    handler: handleInstall
+  },
+  {
+    name: "skills",
+    help: "  geo-ai-search-optimization skills [--json]",
+    handler: handleSkills
+  },
+  {
+    name: "where",
+    help: "  geo-ai-search-optimization where",
+    handler: handleWhere
+  }
+]);
+
+export const SHELL_HELP_LINES = SHELL_COMMAND_REGISTRY.helpLines;
+export const SHELL_COMMAND_HANDLERS = SHELL_COMMAND_REGISTRY.handlers;