geo-ai-search-optimization 1.3.10 → 1.3.11

package/README.md

@@ -909,6 +909,14 @@ geo-ai-search-optimization help
 - `src/cli-agent-execution-commands.js`、`src/cli-flow-commands.js`、`src/cli-planning-delivery-commands.js` 现在统一复用这些 builder
 - CLI 架构进一步接近“adapter registry + shared option builders + shared composition primitives”的模式
 
+## New in 1.3.11
+
+- 继续收敛原本仍较特殊的命令编排
+- `src/cli-shared.js` 新增 `buildTaskOutputDirOptions / buildTaskFormatOutputDirOptions / createContentCommandHandler`
+- `src/cli-planning-delivery-commands.js` 中的 `report` 已改成统一 content handler
+- `export-pack / html-pack / publish-pack` 也开始复用共享 output-dir / task builder
+- CLI 更接近统一的 command registry，而不是混合少数特例 handler
+
 ## New in 1.2.20
 
 - 新增 `agent-continue`

package/package.json

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

@@ -19,11 +19,13 @@ import { createRoadmap, renderRoadmapMarkdown, writeRoadmapOutput } from "./road
 import { createSharePack, renderSharePackMarkdown, writeSharePackOutput } from "./share-pack.js";
 import {
   buildFormatOptions,
+  buildTaskFormatOutputDirOptions,
+  buildTaskOutputDirOptions,
+  createContentCommandHandler,
   buildTaskFormatOptions,
   createArtifactCommandHandler,
   createPackCommandHandler,
   getFlagValue,
-  getRequiredInput,
   parsePositiveInteger
 } from "./cli-shared.js";
 
@@ -94,31 +96,21 @@ const handleExportPack = createPackCommandHandler({
   commandName: "export-pack",
   writePack: writeExportPack,
   renderMarkdown: renderExportPackMarkdown,
-  getOptions: (args) => ({
-    format: getFlagValue(args, "--format"),
-    taskId: getFlagValue(args, "--task"),
-    outputDir: getFlagValue(args, "--out-dir")
-  })
+  getOptions: buildTaskFormatOutputDirOptions
 });
 
 const handleHtmlPack = createPackCommandHandler({
   commandName: "html-pack",
   writePack: writeHtmlPack,
   renderMarkdown: renderHtmlPackMarkdown,
-  getOptions: (args) => ({
-    taskId: getFlagValue(args, "--task"),
-    outputDir: getFlagValue(args, "--out-dir")
-  })
+  getOptions: buildTaskOutputDirOptions
 });
 
 const handlePublishPack = createPackCommandHandler({
   commandName: "publish-pack",
   writePack: writePublishPack,
   renderMarkdown: renderPublishPackMarkdown,
-  getOptions: (args) => ({
-    taskId: getFlagValue(args, "--task"),
-    outputDir: getFlagValue(args, "--out-dir")
-  })
+  getOptions: buildTaskOutputDirOptions
 });
 
 const handleExecSummary = createArtifactCommandHandler({
@@ -175,26 +167,22 @@ const handleRoadmap = createArtifactCommandHandler({
   getOptions: buildFormatOptions
 });
 
-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);
-}
+const handleReport = createContentCommandHandler({
+  commandName: "report",
+  execute: async (input, args) => {
+    const maxFileSizeValue = getFlagValue(args, "--max-file-size");
+    const maxExamplesValue = getFlagValue(args, "--max-examples");
+
+    return 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
+    });
+  },
+  getContent: (report) => report.content,
+  writeOutput: writeReportOutput
+});
 
 export const PLANNING_DELIVERY_COMMAND_HANDLERS = {
   "agent-handoff": handleAgentHandoff,

package/src/cli-shared.js

@@ -57,6 +57,12 @@ export function buildTaskOptions(args) {
   };
 }
 
+export function buildOutputDirOptions(args) {
+  return {
+    outputDir: getFlagValue(args, "--out-dir")
+  };
+}
+
 export function buildProgressOptions(args) {
   return {
     currentTaskId: getFlagValue(args, "--current"),
@@ -79,6 +85,20 @@ export function buildTaskFormatOptions(args) {
   };
 }
 
+export function buildTaskOutputDirOptions(args) {
+  return {
+    ...buildTaskOptions(args),
+    ...buildOutputDirOptions(args)
+  };
+}
+
+export function buildTaskFormatOutputDirOptions(args) {
+  return {
+    ...buildFormatOptions(args),
+    ...buildTaskOutputDirOptions(args)
+  };
+}
+
 export function buildIntentTaskFormatOptions(args) {
   return {
     ...buildIntentOptions(args),
@@ -202,3 +222,25 @@ export function createActionCommandHandler({
     }
   };
 }
+
+export function createContentCommandHandler({
+  commandName,
+  execute,
+  getContent,
+  writeOutput
+}) {
+  return async function contentCommandHandler(args) {
+    const input = getRequiredInput(args, commandName);
+    const result = await execute(input, args);
+    const content = getContent(result);
+    const outputPath = getFlagValue(args, "--out");
+
+    if (outputPath) {
+      const resolvedOutputPath = await writeOutput(outputPath, content);
+      process.stdout.write(`已保存${commandName === "report" ? "报告" : ` ${commandName} 结果`}：${resolvedOutputPath}\n`);
+      return;
+    }
+
+    process.stdout.write(content);
+  };
+}