helloloop 0.1.1 → 0.2.0

package/src/cli.mjs

@@ -1,16 +1,44 @@
 import path from "node:path";
-import { spawnSync } from "node:child_process";
 
+import { analyzeExecution } from "./backlog.mjs";
+import { renderAnalyzeConfirmation, resolveAutoRunMaxTasks } from "./analyze_confirmation.mjs";
+import {
+  confirmAutoExecution,
+  renderAnalyzeStopMessage,
+  renderAutoRunSummary,
+  runDoctor,
+} from "./cli_support.mjs";
 import { createContext } from "./context.mjs";
-import { fileExists } from "./common.mjs";
-import { scaffoldIfMissing } from "./config.mjs";
+import { analyzeWorkspace } from "./analyzer.mjs";
+import { loadBacklog, scaffoldIfMissing } from "./config.mjs";
+import { resolveRepoRoot } from "./discovery.mjs";
 import { installPluginBundle } from "./install.mjs";
 import { runLoop, runOnce, renderStatusText } from "./runner.mjs";
 
 const REPO_ROOT_PLACEHOLDER = "<REPO_ROOT>";
+const DOCS_PATH_PLACEHOLDER = "<DOCS_PATH>";
+const KNOWN_COMMANDS = new Set([
+  "analyze",
+  "install",
+  "init",
+  "status",
+  "next",
+  "run-once",
+  "run-loop",
+  "doctor",
+  "help",
+  "--help",
+  "-h",
+]);
 
 function parseArgs(argv) {
-  const [command = "status", ...rest] = argv;
+  const [first = "", ...restArgs] = argv;
+  const command = !first
+    ? "analyze"
+    : (KNOWN_COMMANDS.has(first) ? first : "analyze");
+  const rest = !first
+    ? []
+    : (KNOWN_COMMANDS.has(first) ? restArgs : argv);
   const options = {
     requiredDocs: [],
     constraints: [],
@@ -19,6 +47,7 @@ function parseArgs(argv) {
   for (let index = 0; index < rest.length; index += 1) {
     const arg = rest[index];
     if (arg === "--dry-run") options.dryRun = true;
+    else if (arg === "--yes" || arg === "-y") options.yes = true;
     else if (arg === "--allow-high-risk") options.allowHighRisk = true;
     else if (arg === "--force") options.force = true;
     else if (arg === "--task-id") { options.taskId = rest[index + 1]; index += 1; }
@@ -26,10 +55,15 @@ function parseArgs(argv) {
     else if (arg === "--max-attempts") { options.maxAttempts = Number(rest[index + 1]); index += 1; }
     else if (arg === "--max-strategies") { options.maxStrategies = Number(rest[index + 1]); index += 1; }
     else if (arg === "--repo") { options.repoRoot = rest[index + 1]; index += 1; }
+    else if (arg === "--docs") { options.docsPath = rest[index + 1]; index += 1; }
+    else if (arg === "--host") { options.host = rest[index + 1]; index += 1; }
     else if (arg === "--codex-home") { options.codexHome = rest[index + 1]; index += 1; }
+    else if (arg === "--claude-home") { options.claudeHome = rest[index + 1]; index += 1; }
+    else if (arg === "--gemini-home") { options.geminiHome = rest[index + 1]; index += 1; }
     else if (arg === "--config-dir") { options.configDirName = rest[index + 1]; index += 1; }
     else if (arg === "--required-doc") { options.requiredDocs.push(rest[index + 1]); index += 1; }
     else if (arg === "--constraint") { options.constraints.push(rest[index + 1]); index += 1; }
+    else if (!options.inputPath) { options.inputPath = arg; }
     else {
       throw new Error(`未知参数：${arg}`);
     }
@@ -40,9 +74,10 @@ function parseArgs(argv) {
 
 function helpText() {
   return [
-    "用法：helloloop <command> [options]",
+    "用法：helloloop [command] [path] [options]",
     "",
     "命令：",
+    "  analyze               自动分析并生成执行确认单；确认后继续自动接续开发（默认）",
     "  install               安装插件到 Codex Home（适合 npx / npm bin 分发）",
     "  init                  初始化 .helloloop 配置",
     "  status                查看 backlog 与下一任务",
@@ -52,10 +87,15 @@ function helpText() {
     "  doctor                检查 Codex、当前插件 bundle 与目标仓库 .helloloop 配置是否可用",
     "",
     "选项：",
+    "  --host <name>        安装宿主：codex | claude | gemini | all（默认 codex）",
     "  --codex-home <dir>    Codex Home，install 默认使用 ~/.codex",
-    "  --repo <dir>          目标仓库根目录，默认当前目录",
+    "  --claude-home <dir>   Claude Home，install 默认使用 ~/.claude",
+    "  --gemini-home <dir>   Gemini Home，install 默认使用 ~/.gemini",
+    "  --repo <dir>          高级选项：显式指定项目仓库根目录",
+    "  --docs <dir|file>     高级选项：显式指定开发文档目录或文件",
     "  --config-dir <dir>    配置目录，默认 .helloloop",
-    "  --dry-run             只生成提示与预览，不真正调用 codex",
+    "  -y, --yes             跳过交互确认，分析后直接开始自动执行",
+    "  --dry-run             只分析并输出确认单，不真正开始自动执行",
     "  --task-id <id>        指定任务 id",
     "  --max-tasks <n>       run-loop 最多执行 n 个任务",
     "  --max-attempts <n>    每种策略内最多重试 n 次",
@@ -73,90 +113,55 @@ function printHelp() {
 function renderFollowupExamples() {
   return [
     "下一步示例：",
-    `npx helloloop doctor --repo ${REPO_ROOT_PLACEHOLDER}`,
-    `如已全局安装，也可直接运行：helloloop doctor --repo ${REPO_ROOT_PLACEHOLDER}`,
+    `npx helloloop`,
+    `npx helloloop <PATH>`,
+    `npx helloloop --dry-run`,
+    `npx helloloop install --host all`,
+    `npx helloloop next`,
+    `如需显式补充路径：npx helloloop --repo ${REPO_ROOT_PLACEHOLDER} --docs ${DOCS_PATH_PLACEHOLDER}`,
   ].join("\n");
 }
 
-function probeCodexVersion() {
-  const codexVersion = process.platform === "win32"
-    ? spawnSync("codex --version", {
-        encoding: "utf8",
-        shell: true,
-      })
-    : spawnSync("codex", ["--version"], {
-        encoding: "utf8",
-        shell: false,
-      });
-  const ok = codexVersion.status === 0;
-  return {
-    ok,
-    detail: ok
-      ? String(codexVersion.stdout || "").trim()
-      : String(codexVersion.stderr || codexVersion.error || "无法执行 codex --version").trim(),
-  };
-}
-
-function collectDoctorChecks(context) {
-  const codexVersion = probeCodexVersion();
-  return [
-    {
-      name: "codex CLI",
-      ok: codexVersion.ok,
-      detail: codexVersion.detail,
-    },
-    {
-      name: "backlog.json",
-      ok: fileExists(context.backlogFile),
-      detail: context.backlogFile,
-    },
-    {
-      name: "policy.json",
-      ok: fileExists(context.policyFile),
-      detail: context.policyFile,
-    },
-    {
-      name: "verify.yaml",
-      ok: fileExists(context.repoVerifyFile),
-      detail: context.repoVerifyFile,
-    },
-    {
-      name: "project.json",
-      ok: fileExists(context.projectFile),
-      detail: context.projectFile,
-    },
-    {
-      name: "plugin manifest",
-      ok: fileExists(context.pluginManifestFile),
-      detail: context.pluginManifestFile,
-    },
-    {
-      name: "plugin skill",
-      ok: fileExists(context.skillFile),
-      detail: context.skillFile,
-    },
-    {
-      name: "install script",
-      ok: fileExists(context.installScriptFile),
-      detail: context.installScriptFile,
-    },
+function renderInstallSummary(result) {
+  const lines = [
+    "HelloLoop 已安装到以下宿主：",
   ];
-}
-
-async function runDoctor(context) {
-  const checks = collectDoctorChecks(context);
 
-  for (const item of checks) {
-    console.log(`${item.ok ? "OK" : "FAIL"}  ${item.name}  ${item.detail}`);
+  for (const item of result.installedHosts) {
+    lines.push(`- ${item.displayName}：${item.targetRoot}`);
+    if (item.marketplaceFile) {
+      lines.push(`  marketplace：${item.marketplaceFile}`);
+    }
+    if (item.settingsFile) {
+      lines.push(`  settings：${item.settingsFile}`);
+    }
   }
 
-  if (checks.every((item) => item.ok)) {
-    console.log("\nDoctor 结论：当前 HelloLoop bundle 与目标仓库已具备基本运行条件。");
-  }
+  lines.push("");
+  lines.push("使用入口：");
+  lines.push("- Codex：`$helloloop` / `npx helloloop`");
+  lines.push("- Claude：`/helloloop`");
+  lines.push("- Gemini：`/helloloop`");
+  lines.push("");
+  lines.push(renderFollowupExamples());
+  return lines.join("\n");
+}
+
+function resolveContextFromOptions(options) {
+  const resolvedRepo = resolveRepoRoot({
+    cwd: process.cwd(),
+    repoRoot: options.repoRoot,
+    inputPath: options.inputPath,
+  });
 
-  if (checks.some((item) => !item.ok)) {
-    process.exitCode = 1;
+  if (!resolvedRepo.ok) {
+    throw new Error(resolvedRepo.message);
   }
+
+  return createContext({
+    repoRoot: resolvedRepo.repoRoot,
+    configDirName: options.configDirName,
+  });
 }
 
 export async function runCli(argv) {
@@ -167,24 +172,76 @@ export async function runCli(argv) {
     return;
   }
 
-  const context = createContext({
-    repoRoot: options.repoRoot,
-    configDirName: options.configDirName,
-  });
-
   if (command === "install") {
+    const context = createContext({
+      repoRoot: options.repoRoot,
+      configDirName: options.configDirName,
+    });
     const result = installPluginBundle({
       bundleRoot: context.bundleRoot,
+      host: options.host,
       codexHome: options.codexHome,
+      claudeHome: options.claudeHome,
+      geminiHome: options.geminiHome,
       force: options.force,
     });
-    console.log(`HelloLoop 已安装到：${result.targetPluginRoot}`);
-    console.log(`Marketplace 已更新：${result.marketplaceFile}`);
+    console.log(renderInstallSummary(result));
+    return;
+  }
+
+  if (command === "analyze") {
+    const result = await analyzeWorkspace({
+      cwd: process.cwd(),
+      inputPath: options.inputPath,
+      repoRoot: options.repoRoot,
+      docsPath: options.docsPath,
+      configDirName: options.configDirName,
+    });
+
+    if (!result.ok) {
+      console.error(result.summary);
+      process.exitCode = 1;
+      return;
+    }
+
+    const confirmationText = renderAnalyzeConfirmation(result.context, result.analysis, result.backlog, options);
+    const execution = analyzeExecution(result.backlog, options);
+
+    console.log(confirmationText);
+    console.log("");
+
+    if (options.dryRun) {
+      console.log("已按 --dry-run 跳过自动执行。");
+      return;
+    }
+
+    if (execution.state !== "ready") {
+      console.log(renderAnalyzeStopMessage(execution.blockedReason || "当前 backlog 已无可自动执行任务。"));
+      return;
+    }
+
+    const approved = options.yes ? true : await confirmAutoExecution();
+    if (!approved) {
+      console.log("已取消自动执行；分析结果与 backlog 已保留在 .helloloop/。");
+      return;
+    }
+
     console.log("");
-    console.log(renderFollowupExamples());
+    console.log("开始自动接续执行...");
+    const results = await runLoop(result.context, {
+      ...options,
+      maxTasks: resolveAutoRunMaxTasks(result.backlog, options),
+    });
+    const refreshedBacklog = loadBacklog(result.context);
+    console.log(renderAutoRunSummary(result.context, refreshedBacklog, results, options));
+    if (results.some((item) => !item.ok)) {
+      process.exitCode = 1;
+    }
     return;
   }
 
+  const context = resolveContextFromOptions(options);
+
   if (command === "init") {
     const created = scaffoldIfMissing(context);
     if (!created.length) {
@@ -199,7 +256,7 @@ export async function runCli(argv) {
   }
 
   if (command === "doctor") {
-    await runDoctor(context);
+    await runDoctor(context, options);
     return;
   }
 

package/src/cli_support.mjs

@@ -0,0 +1,307 @@
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { createInterface } from "node:readline/promises";
+
+import { analyzeExecution, summarizeBacklog } from "./backlog.mjs";
+import { fileExists, readJson } from "./common.mjs";
+import { resolveCliInvocation, resolveCodexInvocation } from "./shell_invocation.mjs";
+
+function probeCodexVersion() {
+  const invocation = resolveCodexInvocation();
+  if (invocation.error) {
+    return {
+      ok: false,
+      detail: invocation.error,
+    };
+  }
+
+  const codexVersion = spawnSync(invocation.command, [...invocation.argsPrefix, "--version"], {
+    encoding: "utf8",
+    shell: invocation.shell,
+  });
+  const ok = codexVersion.status === 0;
+  return {
+    ok,
+    detail: ok
+      ? String(codexVersion.stdout || "").trim()
+      : String(codexVersion.stderr || codexVersion.error || "无法执行 codex --version").trim(),
+  };
+}
+
+export function collectDoctorChecks(context) {
+  const codexVersion = probeCodexVersion();
+  return [
+    {
+      name: "codex CLI",
+      ok: codexVersion.ok,
+      detail: codexVersion.detail,
+    },
+    {
+      name: "backlog.json",
+      ok: fileExists(context.backlogFile),
+      detail: context.backlogFile,
+    },
+    {
+      name: "policy.json",
+      ok: fileExists(context.policyFile),
+      detail: context.policyFile,
+    },
+    {
+      name: "verify.yaml",
+      ok: fileExists(context.repoVerifyFile),
+      detail: context.repoVerifyFile,
+    },
+    {
+      name: "project.json",
+      ok: fileExists(context.projectFile),
+      detail: context.projectFile,
+    },
+    {
+      name: "plugin manifest",
+      ok: fileExists(context.pluginManifestFile),
+      detail: context.pluginManifestFile,
+    },
+    {
+      name: "plugin skill",
+      ok: fileExists(context.skillFile),
+      detail: context.skillFile,
+    },
+    {
+      name: "install script",
+      ok: fileExists(context.installScriptFile),
+      detail: context.installScriptFile,
+    },
+  ];
+}
+
+function probeNamedCliVersion(commandName, toolDisplayName) {
+  const invocation = resolveCliInvocation({
+    commandName,
+    toolDisplayName,
+  });
+  if (invocation.error) {
+    return {
+      ok: false,
+      detail: invocation.error,
+    };
+  }
+
+  const result = spawnSync(invocation.command, [...invocation.argsPrefix, "--version"], {
+    encoding: "utf8",
+    shell: invocation.shell,
+  });
+  const ok = result.status === 0;
+  return {
+    ok,
+    detail: ok
+      ? String(result.stdout || "").trim()
+      : String(result.stderr || result.error || `无法执行 ${commandName} --version`).trim(),
+  };
+}
+
+function normalizeDoctorHosts(hostOption) {
+  const normalized = String(hostOption || "codex").trim().toLowerCase();
+  if (normalized === "all") {
+    return ["codex", "claude", "gemini"];
+  }
+  return [normalized];
+}
+
+function collectCodexDoctorChecks(context, options = {}) {
+  const checks = collectDoctorChecks(context);
+  if (options.codexHome) {
+    checks.push({
+      name: "codex installed plugin",
+      ok: fileExists(path.join(options.codexHome, "plugins", "helloloop", ".codex-plugin", "plugin.json")),
+      detail: path.join(options.codexHome, "plugins", "helloloop", ".codex-plugin", "plugin.json"),
+    });
+    checks.push({
+      name: "codex marketplace",
+      ok: fileExists(path.join(options.codexHome, ".agents", "plugins", "marketplace.json")),
+      detail: path.join(options.codexHome, ".agents", "plugins", "marketplace.json"),
+    });
+  }
+  return checks;
+}
+
+function collectClaudeDoctorChecks(context, options = {}) {
+  const claudeVersion = probeNamedCliVersion("claude", "Claude");
+  const checks = [
+    {
+      name: "claude CLI",
+      ok: claudeVersion.ok,
+      detail: claudeVersion.detail,
+    },
+    {
+      name: "claude plugin manifest",
+      ok: fileExists(path.join(context.bundleRoot, ".claude-plugin", "plugin.json")),
+      detail: path.join(context.bundleRoot, ".claude-plugin", "plugin.json"),
+    },
+    {
+      name: "claude marketplace manifest",
+      ok: fileExists(path.join(context.bundleRoot, "hosts", "claude", "marketplace", ".claude-plugin", "marketplace.json")),
+      detail: path.join(context.bundleRoot, "hosts", "claude", "marketplace", ".claude-plugin", "marketplace.json"),
+    },
+    {
+      name: "claude command",
+      ok: fileExists(path.join(context.bundleRoot, "hosts", "claude", "marketplace", "plugins", "helloloop", "commands", "helloloop.md")),
+      detail: path.join(context.bundleRoot, "hosts", "claude", "marketplace", "plugins", "helloloop", "commands", "helloloop.md"),
+    },
+  ];
+
+  if (options.claudeHome) {
+    const settingsFile = path.join(options.claudeHome, "settings.json");
+    const settings = fileExists(settingsFile) ? readJson(settingsFile) : {};
+    checks.push({
+      name: "claude installed marketplace",
+      ok: fileExists(path.join(options.claudeHome, "marketplaces", "helloloop-local", ".claude-plugin", "marketplace.json")),
+      detail: path.join(options.claudeHome, "marketplaces", "helloloop-local", ".claude-plugin", "marketplace.json"),
+    });
+    checks.push({
+      name: "claude installed plugin",
+      ok: fileExists(path.join(options.claudeHome, "marketplaces", "helloloop-local", "plugins", "helloloop", ".claude-plugin", "plugin.json")),
+      detail: path.join(options.claudeHome, "marketplaces", "helloloop-local", "plugins", "helloloop", ".claude-plugin", "plugin.json"),
+    });
+    checks.push({
+      name: "claude settings enabled",
+      ok: settings?.enabledPlugins?.["helloloop@helloloop-local"] === true,
+      detail: settingsFile,
+    });
+  }
+
+  return checks;
+}
+
+function collectGeminiDoctorChecks(context, options = {}) {
+  const geminiVersion = probeNamedCliVersion("gemini", "Gemini");
+  const checks = [
+    {
+      name: "gemini CLI",
+      ok: geminiVersion.ok,
+      detail: geminiVersion.detail,
+    },
+    {
+      name: "gemini extension manifest",
+      ok: fileExists(path.join(context.bundleRoot, "hosts", "gemini", "extension", "gemini-extension.json")),
+      detail: path.join(context.bundleRoot, "hosts", "gemini", "extension", "gemini-extension.json"),
+    },
+    {
+      name: "gemini command",
+      ok: fileExists(path.join(context.bundleRoot, "hosts", "gemini", "extension", "commands", "helloloop.toml")),
+      detail: path.join(context.bundleRoot, "hosts", "gemini", "extension", "commands", "helloloop.toml"),
+    },
+    {
+      name: "gemini context file",
+      ok: fileExists(path.join(context.bundleRoot, "hosts", "gemini", "extension", "GEMINI.md")),
+      detail: path.join(context.bundleRoot, "hosts", "gemini", "extension", "GEMINI.md"),
+    },
+  ];
+
+  if (options.geminiHome) {
+    checks.push({
+      name: "gemini installed extension",
+      ok: fileExists(path.join(options.geminiHome, "extensions", "helloloop", "gemini-extension.json")),
+      detail: path.join(options.geminiHome, "extensions", "helloloop", "gemini-extension.json"),
+    });
+  }
+
+  return checks;
+}
+
+export async function runDoctor(context, options = {}) {
+  const hosts = normalizeDoctorHosts(options.host);
+  const checks = hosts.flatMap((host) => {
+    if (host === "codex") return collectCodexDoctorChecks(context, options);
+    if (host === "claude") return collectClaudeDoctorChecks(context, options);
+    if (host === "gemini") return collectGeminiDoctorChecks(context, options);
+    return [];
+  });
+
+  for (const item of checks) {
+    console.log(`${item.ok ? "OK" : "FAIL"}  ${item.name}  ${item.detail}`);
+  }
+
+  if (checks.every((item) => item.ok)) {
+    console.log("\nDoctor 结论：当前 HelloLoop 所选宿主与目标仓库已具备基本运行条件。");
+  }
+
+  if (checks.some((item) => !item.ok)) {
+    process.exitCode = 1;
+  }
+}
+
+function isAffirmativeAnswer(answer) {
+  const raw = String(answer || "").trim();
+  const normalized = raw.toLowerCase();
+  return [
+    "y",
+    "yes",
+    "ok",
+    "确认",
+    "是",
+    "继续",
+    "好的",
+  ].includes(normalized) || ["确认", "是", "继续", "好的"].includes(raw);
+}
+
+export async function confirmAutoExecution() {
+  const readline = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    const answer = await readline.question("是否开始自动接续执行？输入 y / yes / 确认 继续，其它任意输入取消：");
+    return isAffirmativeAnswer(answer);
+  } finally {
+    readline.close();
+  }
+}
+
+export function renderAnalyzeStopMessage(reason) {
+  return reason || "当前没有可自动执行的任务。";
+}
+
+export function renderAutoRunSummary(context, backlog, results, options = {}) {
+  const summary = summarizeBacklog(backlog);
+  const execution = analyzeExecution(backlog, options);
+  const lines = [
+    "自动执行结果",
+    "============",
+  ];
+
+  if (!results.length) {
+    lines.push("- 本轮未执行任何任务");
+  } else {
+    for (const item of results) {
+      if (!item.task) {
+        lines.push(`- 已停止：${item.summary || item.kind || "没有更多任务"}`);
+        continue;
+      }
+      lines.push(`- ${item.ok ? "完成任务" : "失败任务"}：${item.task.title}`);
+      if (!item.ok && item.summary) {
+        lines.push(item.summary);
+      }
+    }
+  }
+
+  lines.push("");
+  lines.push("当前统计：");
+  lines.push(`- 已完成：${summary.done}`);
+  lines.push(`- 待处理：${summary.pending}`);
+  lines.push(`- 进行中：${summary.inProgress}`);
+  lines.push(`- 阻塞：${summary.blocked}`);
+  lines.push(`- 失败：${summary.failed}`);
+  lines.push(`- 状态文件：${context.statusFile.replaceAll("\\", "/")}`);
+  lines.push("");
+  lines.push("结论：");
+  if (execution.state === "done") {
+    lines.push("- backlog 已全部完成");
+  } else if (execution.blockedReason) {
+    lines.push(`- 当前停止原因：${execution.blockedReason}`);
+  } else {
+    lines.push("- 当前轮次已结束，可继续查看 status 或下一任务");
+  }
+
+  return lines.join("\n");
+}