helloloop 0.1.0 → 0.1.2

package/src/shell_invocation.mjs

@@ -0,0 +1,211 @@
+import { spawnSync } from "node:child_process";
+
+function createUnavailableInvocation(message) {
+  return {
+    command: "",
+    argsPrefix: [],
+    shell: false,
+    error: message,
+  };
+}
+
+function parseWindowsCommandMatches(output) {
+  return String(output || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+}
+
+function hasCommand(command, platform = process.platform) {
+  if (platform === "win32") {
+    const result = spawnSync("where.exe", [command], {
+      encoding: "utf8",
+      shell: false,
+    });
+    return result.status === 0;
+  }
+
+  const result = spawnSync("sh", ["-lc", `command -v ${command}`], {
+    encoding: "utf8",
+    shell: false,
+  });
+  return result.status === 0;
+}
+
+function findWindowsCommandPaths(command, resolver) {
+  const lookup = resolver || ((name) => {
+    const result = spawnSync("where.exe", [name], {
+      encoding: "utf8",
+      shell: false,
+    });
+    return result.status === 0 ? parseWindowsCommandMatches(result.stdout) : [];
+  });
+
+  return lookup(command);
+}
+
+function resolveWindowsPowerShellHost(options = {}) {
+  const commandExists = options.commandExists || ((command) => hasCommand(command, "win32"));
+
+  if (commandExists("pwsh")) {
+    return {
+      command: "pwsh",
+      shell: false,
+    };
+  }
+
+  if (commandExists("powershell")) {
+    return {
+      command: "powershell",
+      shell: false,
+    };
+  }
+
+  return null;
+}
+
+function resolveWindowsCommandShell(options = {}) {
+  const commandExists = options.commandExists || ((command) => hasCommand(command, "win32"));
+  const preferredHosts = [
+    {
+      check: "pwsh",
+      invocation: {
+        command: "pwsh",
+        argsPrefix: ["-NoLogo", "-NoProfile", "-Command"],
+        shell: false,
+      },
+    },
+    {
+      check: "bash",
+      invocation: {
+        command: "bash",
+        argsPrefix: ["-lc"],
+        shell: false,
+      },
+    },
+    {
+      check: "powershell",
+      invocation: {
+        command: "powershell",
+        argsPrefix: ["-NoLogo", "-NoProfile", "-Command"],
+        shell: false,
+      },
+    },
+  ];
+
+  for (const host of preferredHosts) {
+    if (commandExists(host.check)) {
+      return host.invocation;
+    }
+  }
+
+  return null;
+}
+
+function resolvePosixCommandShell(options = {}) {
+  const platform = options.platform || process.platform;
+  const commandExists = options.commandExists || ((command) => hasCommand(command, platform));
+
+  if (commandExists("bash")) {
+    return {
+      command: "bash",
+      argsPrefix: ["-lc"],
+      shell: false,
+    };
+  }
+
+  return {
+    command: "sh",
+    argsPrefix: ["-lc"],
+    shell: false,
+  };
+}
+
+function isCmdLikeExecutable(executable) {
+  return /\.(cmd|bat)$/i.test(String(executable || ""));
+}
+
+function resolveWindowsCodexExecutable(options = {}) {
+  const explicitExecutable = String(options.explicitExecutable || "").trim();
+  const findCommandPaths = options.findCommandPaths || ((command) => findWindowsCommandPaths(command));
+
+  if (explicitExecutable) {
+    return explicitExecutable;
+  }
+
+  const searchOrder = ["codex.ps1", "codex.exe", "codex"];
+  for (const query of searchOrder) {
+    const safeMatch = findCommandPaths(query).find((candidate) => !isCmdLikeExecutable(candidate));
+    if (safeMatch) {
+      return safeMatch;
+    }
+  }
+
+  return "";
+}
+
+export function resolveVerifyShellInvocation(options = {}) {
+  const platform = options.platform || process.platform;
+
+  if (platform === "win32") {
+    const host = resolveWindowsCommandShell(options);
+    if (!host) {
+      return createUnavailableInvocation(
+        "Windows 环境需要 pwsh、bash（如 Git Bash）或 powershell 才能安全执行验证命令；HelloLoop 已禁止回退到 cmd.exe。",
+      );
+    }
+    return host;
+  }
+
+  return resolvePosixCommandShell(options);
+}
+
+export function resolveCodexInvocation(options = {}) {
+  const platform = options.platform || process.platform;
+  const explicitExecutable = String(options.explicitExecutable || "").trim();
+
+  if (platform !== "win32") {
+    return {
+      command: explicitExecutable || "codex",
+      argsPrefix: [],
+      shell: false,
+    };
+  }
+
+  const executable = resolveWindowsCodexExecutable({
+    explicitExecutable,
+    findCommandPaths: options.findCommandPaths,
+  });
+  if (!executable) {
+    return createUnavailableInvocation(
+      "未找到可安全执行的 codex 入口。Windows 环境需要 codex.ps1、codex.exe 或其他非 cmd 的可执行入口。",
+    );
+  }
+
+  if (isCmdLikeExecutable(executable)) {
+    return createUnavailableInvocation(
+      `HelloLoop 在 Windows 已禁止通过 cmd/bat 启动 Codex：${executable}`,
+    );
+  }
+
+  if (/\.ps1$/i.test(executable)) {
+    const host = resolveWindowsPowerShellHost(options);
+    if (!host) {
+      return createUnavailableInvocation(
+        `需要 pwsh 或 powershell 才能安全执行 ${executable}；HelloLoop 不会回退到 cmd.exe。`,
+      );
+    }
+
+    return {
+      command: host.command,
+      argsPrefix: ["-NoLogo", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", executable],
+      shell: host.shell,
+    };
+  }
+
+  return {
+    command: executable,
+    argsPrefix: [],
+    shell: false,
+  };
+}

package/templates/STATE.template.md

@@ -9,4 +9,4 @@
 - 当前任务：无
 - 最近结果：HelloLoop 已初始化
 - 下一建议：先完善 backlog.json
-
+

package/templates/analysis-output.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "project",
+    "summary",
+    "tasks"
+  ],
+  "properties": {
+    "project": {
+      "type": "string",
+      "minLength": 1
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "currentState",
+        "implemented",
+        "remaining",
+        "nextAction"
+      ],
+      "properties": {
+        "currentState": {
+          "type": "string",
+          "minLength": 1
+        },
+        "implemented": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "remaining": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "nextAction": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "constraints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "title",
+          "status",
+          "priority",
+          "risk",
+          "goal",
+          "docs",
+          "paths",
+          "acceptance"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "done",
+              "blocked"
+            ]
+          },
+          "priority": {
+            "type": "string",
+            "enum": [
+              "P0",
+              "P1",
+              "P2",
+              "P3"
+            ]
+          },
+          "risk": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "goal": {
+            "type": "string",
+            "minLength": 1
+          },
+          "docs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "paths": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "acceptance": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            }
+          },
+          "dependsOn": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "verify": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/templates/status.template.json

@@ -15,4 +15,4 @@
   "message": "HelloLoop 已初始化。",
   "updatedAt": "2026-03-27T00:00:00.000Z"
 }
-
+