geo-ai-search-optimization 1.3.8 → 1.3.9

package/README.md

@@ -894,6 +894,14 @@ geo-ai-search-optimization help
 - `src/cli-site-ops-commands.js` 现在统一通过组合器编排 `doctor / quick-start / onboard / onboard-url / audit / scan`
 - CLI 架构进一步收敛到“命令族 adapter + shared composition primitives”的模式
 
+## New in 1.3.9
+
+- 继续把“直接执行型命令”也纳入共享组合模式
+- `src/cli-shared.js` 新增 `createActionCommandHandler`
+- `src/cli-shell-commands.js` 里的 `install` 已改成声明式 action 组合
+- `src/cli-site-ops-commands.js` 里的 `init-llms / init-schema` 已改成声明式 action 组合
+- CLI 现在同时覆盖 artifact、structured-output、action 三类共享 composition primitives
+
 ## New in 1.2.20
 
 - 新增 `agent-continue`

package/package.json

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

package/src/cli-shared.js

@@ -113,3 +113,23 @@ export function createStructuredOutputCommandHandler({
     process.stdout.write(renderedOutput);
   };
 }
+
+export function createActionCommandHandler({
+  execute,
+  getOutputJson,
+  renderText
+}) {
+  return async function actionCommandHandler(args) {
+    const result = await execute(args);
+    const outputJson = getOutputJson ? getOutputJson(args, result) : hasFlag(args, "--json");
+
+    if (outputJson) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+      return;
+    }
+
+    if (renderText) {
+      process.stdout.write(renderText(result, args));
+    }
+  };
+}

package/src/cli-shell-commands.js

@@ -1,4 +1,4 @@
-import { getFlagValue, hasFlag } from "./cli-shared.js";
+import { 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";
@@ -9,15 +9,16 @@ export const SHELL_HELP_LINES = [
   "  geo-ai-search-optimization where"
 ];
 
-async function handleInstall(args) {
-  const targetDir = getFlagValue(args, "--target");
-  const outputJson = hasFlag(args, "--json");
-  const result = await installSkill({ targetDir, silent: outputJson });
-
-  if (outputJson) {
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-  }
-}
+const handleInstall = createActionCommandHandler({
+  execute: async (args) => {
+    const outputJson = hasFlag(args, "--json");
+    return installSkill({
+      targetDir: getFlagValue(args, "--target"),
+      silent: outputJson
+    });
+  },
+  getOutputJson: (args) => hasFlag(args, "--json")
+});
 
 async function handleSkills(args) {
   const bundle = await listBundledSkills();

package/src/cli-site-ops-commands.js

@@ -1,5 +1,6 @@
 import { auditProject, renderAuditMarkdown, writeAuditOutput } from "./audit.js";
 import {
+  createActionCommandHandler,
   createStructuredOutputCommandHandler,
   getFlagValue,
   hasFlag,
@@ -74,46 +75,35 @@ const handleOnboardUrl = createStructuredOutputCommandHandler({
   getOutputJson: (args) => hasFlag(args, "--json")
 });
 
-async function handleInitLlms(args) {
-  const targetDir = args.find((value) => !value.startsWith("-")) || ".";
-  const outputJson = hasFlag(args, "--json");
-  const result = await createLlmsTxt({
-    targetDir,
-    siteName: getFlagValue(args, "--site-name"),
-    siteUrl: getFlagValue(args, "--site-url"),
-    overwrite: hasFlag(args, "--overwrite")
-  });
-
-  if (outputJson) {
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return;
-  }
-
-  process.stdout.write(`Created llms.txt at ${result.outputPath}\n`);
-}
-
-async function handleInitSchema(args) {
-  const [schemaType, ...rest] = args;
-  if (!schemaType || schemaType.startsWith("-")) {
-    throw new Error("init-schema requires a schema type");
-  }
-
-  const targetDir = rest.find((value) => !value.startsWith("-")) || ".";
-  const outputJson = hasFlag(rest, "--json");
-  const result = await createSchemaTemplate({
-    schemaType,
-    targetDir,
-    siteUrl: getFlagValue(rest, "--site-url"),
-    overwrite: hasFlag(rest, "--overwrite")
-  });
-
-  if (outputJson) {
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-    return;
-  }
-
-  process.stdout.write(`Created ${result.schemaType} schema template at ${result.outputPath}\n`);
-}
+const handleInitLlms = createActionCommandHandler({
+  execute: async (args) =>
+    createLlmsTxt({
+      targetDir: args.find((value) => !value.startsWith("-")) || ".",
+      siteName: getFlagValue(args, "--site-name"),
+      siteUrl: getFlagValue(args, "--site-url"),
+      overwrite: hasFlag(args, "--overwrite")
+    }),
+  getOutputJson: (args) => hasFlag(args, "--json"),
+  renderText: (result) => `Created llms.txt at ${result.outputPath}\n`
+});
+
+const handleInitSchema = createActionCommandHandler({
+  execute: async (args) => {
+    const [schemaType, ...rest] = args;
+    if (!schemaType || schemaType.startsWith("-")) {
+      throw new Error("init-schema requires a schema type");
+    }
+
+    return createSchemaTemplate({
+      schemaType,
+      targetDir: rest.find((value) => !value.startsWith("-")) || ".",
+      siteUrl: getFlagValue(rest, "--site-url"),
+      overwrite: hasFlag(rest, "--overwrite")
+    });
+  },
+  getOutputJson: (args) => hasFlag(args, "--json"),
+  renderText: (result) => `Created ${result.schemaType} schema template at ${result.outputPath}\n`
+});
 
 const handleAudit = createStructuredOutputCommandHandler({
   commandLabel: "审计",