geo-ai-search-optimization 1.3.4 → 1.3.5

package/README.md

@@ -865,6 +865,13 @@ geo-ai-search-optimization help
 - 主 `cli.js` 现在更接近纯路由层
 - CLI 已经形成 `flow / execution / planning-delivery / shared` 四层 command adapter 结构
 
+## New in 1.3.5
+
+- 继续做 CLI 架构迭代，把 onboarding / audit / scan / doctor / init family 也从主 `cli.js` 拆出
+- 新增 `src/cli-site-ops-commands.js`，接管 `doctor / quick-start / onboard / onboard-url / init-llms / init-schema / audit / scan`
+- 主 `cli.js` 现在只保留 install / skills / where / version / help 与 command routing
+- CLI 已经形成 `flow / execution / planning-delivery / site-ops / 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.4",
+  "version": "1.3.5",
   "description": "Install and run a Generative Engine Optimization (GEO)-first, SEO-supported Codex skill for website optimization.",
   "type": "module",
   "bin": {

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

@@ -0,0 +1,201 @@
+import { auditProject, renderAuditMarkdown, writeAuditOutput } from "./audit.js";
+import { getFlagValue, hasFlag, parsePositiveInteger } from "./cli-shared.js";
+import { renderDoctorMarkdown, runDoctor } from "./doctor.js";
+import {
+  renderInteractiveOnboardingMarkdown,
+  runInteractiveOnboarding,
+  writeInteractiveOnboardingOutput
+} from "./interactive-onboarding.js";
+import { createLlmsTxt } from "./llms-txt.js";
+import { createQuickStartPlan, renderQuickStartMarkdown, writeQuickStartOutput } from "./quick-start.js";
+import { renderScanMarkdown, scanProject, writeScanOutput } from "./scan.js";
+import { createSchemaTemplate } from "./schema.js";
+import { analyzeWebsiteUrl, renderWebsiteOnboardingMarkdown, writeWebsiteOnboardingOutput } from "./url-onboarding.js";
+
+export const SITE_OPS_HELP_LINES = [
+  "  geo-ai-search-optimization doctor [--json]",
+  "  geo-ai-search-optimization quick-start [--json] [--out <file>]",
+  "  geo-ai-search-optimization onboard [--url <website-url>] [--goal <goal>] [--existing-assets <list>] [--json] [--out <file>]",
+  "  geo-ai-search-optimization onboard-url <website-url> [--json] [--out <file>]",
+  "  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 scan <project-path> [--json] [--out <file>] [--max-file-size <bytes>] [--max-examples <count>]"
+];
+
+async function handleDoctor(args) {
+  const report = await runDoctor();
+  if (hasFlag(args, "--json")) {
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    return;
+  }
+
+  process.stdout.write(renderDoctorMarkdown(report));
+}
+
+async function handleQuickStart(args) {
+  const outputJson = hasFlag(args, "--json");
+  const plan = createQuickStartPlan({});
+  const renderedOutput = outputJson ? `${JSON.stringify(plan, null, 2)}\n` : renderQuickStartMarkdown(plan);
+  const outputPath = getFlagValue(args, "--out");
+
+  if (outputPath) {
+    const resolvedOutputPath = await writeQuickStartOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 quick start 输出：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+async function handleInteractiveOnboard(args) {
+  const report = await runInteractiveOnboarding({
+    url: getFlagValue(args, "--url"),
+    goal: getFlagValue(args, "--goal"),
+    existingAssets: getFlagValue(args, "--existing-assets")
+  });
+
+  const outputJson = hasFlag(args, "--json");
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(report, null, 2)}\n`
+    : renderInteractiveOnboardingMarkdown(report);
+  const outputPath = getFlagValue(args, "--out");
+
+  if (outputPath) {
+    const resolvedOutputPath = await writeInteractiveOnboardingOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存交互式 onboarding 结果：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+async function handleOnboardUrl(args) {
+  const inputUrl = args.find((value) => !value.startsWith("-"));
+  if (!inputUrl) {
+    throw new Error("onboard-url requires a website URL");
+  }
+
+  const report = await analyzeWebsiteUrl(inputUrl, {});
+  const outputJson = hasFlag(args, "--json");
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(report, null, 2)}\n`
+    : `${renderWebsiteOnboardingMarkdown(report)}\n`;
+  const outputPath = getFlagValue(args, "--out");
+
+  if (outputPath) {
+    const resolvedOutputPath = await writeWebsiteOnboardingOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 onboarding 结果：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+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`);
+}
+
+async function handleAudit(args) {
+  const projectPath = args.find((value) => !value.startsWith("-"));
+  if (!projectPath) {
+    throw new Error("audit requires a project path");
+  }
+
+  const report = await auditProject(projectPath, {
+    maxFileSize: getFlagValue(args, "--max-file-size")
+      ? parsePositiveInteger(getFlagValue(args, "--max-file-size"), "--max-file-size")
+      : undefined,
+    maxExamples: getFlagValue(args, "--max-examples")
+      ? parsePositiveInteger(getFlagValue(args, "--max-examples"), "--max-examples")
+      : undefined
+  });
+
+  const outputJson = hasFlag(args, "--json");
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(report, null, 2)}\n`
+    : `${renderAuditMarkdown(report)}\n`;
+  const outputPath = getFlagValue(args, "--out");
+
+  if (outputPath) {
+    const resolvedOutputPath = await writeAuditOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存审计结果：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+async function handleScan(args) {
+  const projectPath = args.find((value) => !value.startsWith("-"));
+  if (!projectPath) {
+    throw new Error("scan requires a project path");
+  }
+
+  const maxFileSizeValue = getFlagValue(args, "--max-file-size");
+  const maxExamplesValue = getFlagValue(args, "--max-examples");
+  const summary = await scanProject(projectPath, {
+    maxFileSize: maxFileSizeValue ? parsePositiveInteger(maxFileSizeValue, "--max-file-size") : undefined,
+    maxExamples: maxExamplesValue ? parsePositiveInteger(maxExamplesValue, "--max-examples") : undefined
+  });
+
+  const outputJson = hasFlag(args, "--json");
+  const renderedOutput = outputJson ? `${JSON.stringify(summary, null, 2)}\n` : renderScanMarkdown(summary);
+  const outputPath = getFlagValue(args, "--out");
+
+  if (outputPath) {
+    const resolvedOutputPath = await writeScanOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存扫描结果：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+export const SITE_OPS_COMMAND_HANDLERS = {
+  doctor: handleDoctor,
+  "quick-start": handleQuickStart,
+  onboard: handleInteractiveOnboard,
+  "onboard-url": handleOnboardUrl,
+  "init-llms": handleInitLlms,
+  "init-schema": handleInitSchema,
+  audit: handleAudit,
+  scan: handleScan
+};

package/src/cli.js

@@ -1,6 +1,6 @@
-import { fileURLToPath } from "node:url";
 import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import {
   AGENT_EXECUTION_COMMAND_HANDLERS,
   AGENT_EXECUTION_HELP_LINES
@@ -10,22 +10,11 @@ import {
   PLANNING_DELIVERY_COMMAND_HANDLERS,
   PLANNING_DELIVERY_HELP_LINES
 } from "./cli-planning-delivery-commands.js";
-import { getFlagValue, hasFlag, parsePositiveInteger } from "./cli-shared.js";
+import { SITE_OPS_COMMAND_HANDLERS, SITE_OPS_HELP_LINES } from "./cli-site-ops-commands.js";
+import { getFlagValue, hasFlag } 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 {
-  renderInteractiveOnboardingMarkdown,
-  runInteractiveOnboarding,
-  writeInteractiveOnboardingOutput
-} from "./interactive-onboarding.js";
-import { createQuickStartPlan, renderQuickStartMarkdown, writeQuickStartOutput } from "./quick-start.js";
-import { createSchemaTemplate } from "./schema.js";
 import { listBundledSkills, renderBundledSkillsMarkdown } from "./skills.js";
-import { analyzeWebsiteUrl, renderWebsiteOnboardingMarkdown, writeWebsiteOnboardingOutput } from "./url-onboarding.js";
 
 let cachedVersion;
 
@@ -51,16 +40,9 @@ function printHelp() {
       ...FLOW_HELP_LINES,
       ...AGENT_EXECUTION_HELP_LINES,
       ...PLANNING_DELIVERY_HELP_LINES,
+      ...SITE_OPS_HELP_LINES,
       "  geo-ai-search-optimization skills [--json]",
       "  geo-ai-search-optimization where",
-      "  geo-ai-search-optimization doctor [--json]",
-      "  geo-ai-search-optimization quick-start [--json] [--out <file>]",
-      "  geo-ai-search-optimization onboard [--url <website-url>] [--goal <goal>] [--existing-assets <list>] [--json] [--out <file>]",
-      "  geo-ai-search-optimization onboard-url <website-url> [--json] [--out <file>]",
-      "  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 scan <project-path> [--json] [--out <file>] [--max-file-size <bytes>] [--max-examples <count>]",
       "  geo-ai-search-optimization version",
       "  geo-ai-search-optimization help",
       "",
@@ -104,182 +86,12 @@ async function handleSkills(args) {
   process.stdout.write(renderBundledSkillsMarkdown(bundle));
 }
 
-async function handleDoctor(args) {
-  const report = await runDoctor();
-  if (hasFlag(args, "--json")) {
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    return;
-  }
-  process.stdout.write(renderDoctorMarkdown(report));
-}
-
-async function handleScan(args) {
-  const projectPath = args.find((value) => !value.startsWith("-"));
-  if (!projectPath) {
-    throw new Error("scan requires a project path");
-  }
-
-  const maxFileSizeValue = getFlagValue(args, "--max-file-size");
-  const maxExamplesValue = getFlagValue(args, "--max-examples");
-  const summary = await scanProject(projectPath, {
-    maxFileSize: maxFileSizeValue ? parsePositiveInteger(maxFileSizeValue, "--max-file-size") : undefined,
-    maxExamples: maxExamplesValue ? parsePositiveInteger(maxExamplesValue, "--max-examples") : undefined
-  });
-
-  const outputJson = hasFlag(args, "--json");
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(summary, null, 2)}\n`
-    : renderScanMarkdown(summary);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeScanOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存扫描结果：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-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 handleQuickStart(args) {
-  const outputJson = hasFlag(args, "--json");
-  const plan = createQuickStartPlan({});
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(plan, null, 2)}\n`
-    : renderQuickStartMarkdown(plan);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeQuickStartOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 quick start 输出：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-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`);
-}
-
-async function handleOnboardUrl(args) {
-  const inputUrl = args.find((value) => !value.startsWith("-"));
-  if (!inputUrl) {
-    throw new Error("onboard-url requires a website URL");
-  }
-
-  const report = await analyzeWebsiteUrl(inputUrl, {
-  });
-
-  const outputJson = hasFlag(args, "--json");
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(report, null, 2)}\n`
-    : `${renderWebsiteOnboardingMarkdown(report)}\n`;
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeWebsiteOnboardingOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存 onboarding 结果：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleInteractiveOnboard(args) {
-  const report = await runInteractiveOnboarding({
-    url: getFlagValue(args, "--url"),
-    goal: getFlagValue(args, "--goal"),
-    existingAssets: getFlagValue(args, "--existing-assets")
-  });
-
-  const outputJson = hasFlag(args, "--json");
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(report, null, 2)}\n`
-    : renderInteractiveOnboardingMarkdown(report);
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeInteractiveOnboardingOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存交互式 onboarding 结果：${resolvedOutputPath}\n`);
-    return;
-  }
-
-  process.stdout.write(renderedOutput);
-}
-
-async function handleAudit(args) {
-  const projectPath = args.find((value) => !value.startsWith("-"));
-  if (!projectPath) {
-    throw new Error("audit requires a project path");
-  }
-
-  const report = await auditProject(projectPath, {
-    maxFileSize: getFlagValue(args, "--max-file-size")
-      ? parsePositiveInteger(getFlagValue(args, "--max-file-size"), "--max-file-size")
-      : undefined,
-    maxExamples: getFlagValue(args, "--max-examples")
-      ? parsePositiveInteger(getFlagValue(args, "--max-examples"), "--max-examples")
-      : undefined
-  });
-
-  const outputJson = hasFlag(args, "--json");
-  const renderedOutput = outputJson
-    ? `${JSON.stringify(report, null, 2)}\n`
-    : `${renderAuditMarkdown(report)}\n`;
-
-  const outputPath = getFlagValue(args, "--out");
-  if (outputPath) {
-    const resolvedOutputPath = await writeAuditOutput(outputPath, renderedOutput);
-    process.stdout.write(`已保存审计结果：${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];
+  const siteOpsHandler = SITE_OPS_COMMAND_HANDLERS[command];
 
   if (command === "help" || command === "--help" || command === "-h") {
     printHelp();
@@ -311,6 +123,11 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (siteOpsHandler) {
+    await siteOpsHandler(rest);
+    return;
+  }
+
   if (command === "skills") {
     await handleSkills(rest);
     return;
@@ -321,46 +138,6 @@ export async function runCli(args = []) {
     return;
   }
 
-  if (command === "doctor") {
-    await handleDoctor(rest);
-    return;
-  }
-
-  if (command === "quick-start") {
-    await handleQuickStart(rest);
-    return;
-  }
-
-  if (command === "onboard") {
-    await handleInteractiveOnboard(rest);
-    return;
-  }
-
-  if (command === "onboard-url") {
-    await handleOnboardUrl(rest);
-    return;
-  }
-
-  if (command === "init-llms") {
-    await handleInitLlms(rest);
-    return;
-  }
-
-  if (command === "init-schema") {
-    await handleInitSchema(rest);
-    return;
-  }
-
-  if (command === "audit") {
-    await handleAudit(rest);
-    return;
-  }
-
-  if (command === "scan") {
-    await handleScan(rest);
-    return;
-  }
-
   throw new Error(`Unknown command: ${command}`);
 }