geo-ai-search-optimization 1.2.13 → 1.2.15

package/src/cli.js

@@ -14,6 +14,8 @@ import {
   renderAgentProgressTrackerMarkdown,
   writeAgentProgressTrackerOutput
 } from "./agent-progress-tracker.js";
+import { createAgentCheckpoint, renderAgentCheckpointMarkdown, writeAgentCheckpointOutput } from "./agent-checkpoint.js";
+import { createAgentDecisionLog, renderAgentDecisionLogMarkdown, writeAgentDecisionLogOutput } from "./agent-decision-log.js";
 import { createAgentStatusBoard, renderAgentStatusBoardMarkdown, writeAgentStatusBoardOutput } from "./agent-status-board.js";
 import { createAgentRunbook, renderAgentRunbookMarkdown, writeAgentRunbookOutput } from "./agent-runbook.js";
 import { createAgentSession, renderAgentSessionMarkdown, writeAgentSessionOutput } from "./agent-session.js";
@@ -79,6 +81,8 @@ function printHelp() {
       "  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 skills [--json]",
       "  geo-ai-search-optimization where",
       "  geo-ai-search-optimization doctor [--json]",
@@ -333,6 +337,64 @@ async function handleAgentStatusBoard(args) {
   process.stdout.write(renderedOutput);
 }
 
+async function handleAgentCheckpoint(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("agent-checkpoint 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
+  }
+
+  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
+  const checkpoint = await createAgentCheckpoint(input, {
+    format,
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  const outputJson = checkpoint.format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(checkpoint, null, 2)}\n`
+    : renderAgentCheckpointMarkdown(checkpoint);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeAgentCheckpointOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 agent checkpoint：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
+async function handleAgentDecisionLog(args) {
+  const input = args.find((value) => !value.startsWith("-"));
+  if (!input) {
+    throw new Error("agent-decision-log 需要一个输入值，可以是项目路径、网站网址或已导出的工件");
+  }
+
+  const format = getFlagValue(args, "--format") || (hasFlag(args, "--json") ? "json" : undefined);
+  const decisionLog = await createAgentDecisionLog(input, {
+    format,
+    appendFrom: getFlagValue(args, "--append-from"),
+    note: getFlagValue(args, "--note"),
+    currentTaskId: getFlagValue(args, "--current"),
+    completedPacketIds: getFlagValue(args, "--completed"),
+    blockedReasons: getFlagValue(args, "--blocked")
+  });
+  const outputJson = decisionLog.format === "json";
+  const renderedOutput = outputJson
+    ? `${JSON.stringify(decisionLog, null, 2)}\n`
+    : renderAgentDecisionLogMarkdown(decisionLog);
+
+  const outputPath = getFlagValue(args, "--out");
+  if (outputPath) {
+    const resolvedOutputPath = await writeAgentDecisionLogOutput(outputPath, renderedOutput);
+    process.stdout.write(`已保存 agent decision log：${resolvedOutputPath}\n`);
+    return;
+  }
+
+  process.stdout.write(renderedOutput);
+}
+
 function handleWhere() {
   process.stdout.write(
     [
@@ -908,6 +970,16 @@ export async function runCli(args = []) {
     return;
   }
 
+  if (command === "agent-checkpoint") {
+    await handleAgentCheckpoint(rest);
+    return;
+  }
+
+  if (command === "agent-decision-log") {
+    await handleAgentDecisionLog(rest);
+    return;
+  }
+
   if (command === "skills") {
     await handleSkills(rest);
     return;

package/src/index.js

@@ -8,6 +8,8 @@ export {
 export { createAutoFlow, renderAutoFlowMarkdown, writeAutoFlowOutput } from "./auto-flow.js";
 export { createApplyPlan, renderApplyPlanMarkdown, writeApplyPlanOutput } from "./apply-plan.js";
 export { createAgentBatchExecutor, renderAgentBatchExecutorMarkdown, writeAgentBatchExecutorOutput } from "./agent-batch-executor.js";
+export { createAgentCheckpoint, renderAgentCheckpointMarkdown, writeAgentCheckpointOutput } from "./agent-checkpoint.js";
+export { createAgentDecisionLog, renderAgentDecisionLogMarkdown, writeAgentDecisionLogOutput } from "./agent-decision-log.js";
 export { createAgentHandoff, renderAgentHandoffMarkdown, writeAgentHandoffOutput } from "./agent-handoff.js";
 export { createAgentExecutor, renderAgentExecutorMarkdown, writeAgentExecutorOutput } from "./agent-executor.js";
 export {

package/src/skills.js

@@ -11,6 +11,8 @@ const SKILL_ORDER = [
   "geo-ai-search-optimization-agent-batch-executor",
   "geo-ai-search-optimization-agent-progress-tracker",
   "geo-ai-search-optimization-agent-status-board",
+  "geo-ai-search-optimization-agent-checkpoint",
+  "geo-ai-search-optimization-agent-decision-log",
   "geo-ai-search-optimization-usage",
   "geo-ai-search-optimization-agent-handoff",
   "geo-ai-search-optimization-repair-loop",
@@ -31,6 +33,8 @@ const SKILL_CATEGORY = {
   "geo-ai-search-optimization-agent-batch-executor": "execution",
   "geo-ai-search-optimization-agent-progress-tracker": "execution",
   "geo-ai-search-optimization-agent-status-board": "execution",
+  "geo-ai-search-optimization-agent-checkpoint": "execution",
+  "geo-ai-search-optimization-agent-decision-log": "execution",
   "geo-ai-search-optimization-usage": "guidance",
   "geo-ai-search-optimization-agent-handoff": "execution",
   "geo-ai-search-optimization-repair-loop": "execution",
@@ -170,6 +174,8 @@ export function renderBundledSkillsMarkdown(bundle) {
     "- 如果要连续推进前 2 到 3 包，但仍然一次只做一包，再进入 agent-batch-executor。",
     "- 如果要追踪目前做到第几包、卡在哪、下一包是什么，再进入 agent-progress-tracker。",
     "- 如果要把当前执行状态直接整理成看板，再进入 agent-status-board。",
+    "- 如果要在每轮结束时做继续 / 阻塞 / 收尾决策，再进入 agent-checkpoint。",
+    "- 如果要把多轮决策沉淀成可继承的历史，再进入 agent-decision-log。",
     "- 再看 usage skill，知道什么时候该跑哪个命令。",
     "- 如果要交给 agent 执行，再进入 handoff / apply / completion 这一条执行链。",
     "- 如果要产出给团队分发，再进入 share / export / html / publish 这一条交付链。",