helloloop 0.8.2 → 0.8.4

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "HelloLoop 的 Claude Code 原生插件元数据，用于多 CLI 宿主分发。",
   "author": {
     "name": "HelloLoop"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件，Codex 路径为首发与参考实现。",
   "author": {
     "name": "HelloLoop"

package/README.md

@@ -1,5 +1,9 @@
 # HelloLoop
 
+> [!WARNING]
+> **风险提示**
+> 使用 `HelloLoop` 执行持续 / 持久型任务仍存在不可完全控制的风险。虽然项目已经加入高危行为管控与防护策略，但仍不能排除误删数据、误改文件、异常覆盖或其他不可预期后果。请在使用前务必先备份重要数据，并自行通过人工或借助 AI 对 `HelloLoop` 的安全风险做评估与审计；因使用本插件造成的数据丢失或其他损失，项目方不承担责任。
+
 `HelloLoop` 是一个面向 `Codex CLI`、`Claude Code`、`Gemini CLI` 的多宿主开发工作流插件，用来把“根据开发文档持续接续开发、测试、验收，直到最终目标完成”收敛成一条统一、可确认、可追踪的标准流程。
 
 它的核心原则很简单：
@@ -421,6 +425,46 @@ npx helloloop doctor --host all
 npx helloloop doctor --host all --codex-home <CODEX_HOME> --claude-home <CLAUDE_HOME> --gemini-home <GEMINI_HOME>
 ```
 
+## 发布流程
+
+`HelloLoop` 当前采用 **tag 驱动发布**：
+
+1. 先在源码仓库完成版本号更新（`package.json` 与各宿主 manifest 保持一致）
+2. 本地先执行：
+
+```bash
+npm test
+npm pack --dry-run
+```
+
+3. 推送 Git tag：
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+或 beta 版本：
+
+```bash
+git tag vX.Y.Z-beta.N
+git push origin vX.Y.Z-beta.N
+```
+
+随后 GitHub Actions `Publish to npm` 会自动执行：
+
+- tag / 版本一致性校验
+- `npm test`
+- `npm pack --dry-run`
+- `npm publish`
+- GitHub Release
+
+补充说明：
+
+- 正式版本使用 npm `latest` 渠道，beta 版本使用 npm `beta` 渠道
+- 如果测试、版本校验或打包检查失败，npm 发布与 GitHub Release 都不会继续执行
+- `0.8.4` 起已补齐 Codex Structured Outputs 严格 schema 兼容，并修复快退出 CLI 在 CI 中可能触发的 `stdin EPIPE` 问题，避免发布工作流被非业务性故障打断
+
 ## 宿主写入范围
 
 为了方便排查安装 / 更新 / 卸载问题，下面是默认写入位置：

package/hosts/claude/marketplace/plugins/helloloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "HelloLoop 的 Claude Code 原生插件元数据，用于多 CLI 宿主分发。",
   "author": {
     "name": "HelloLoop"

package/hosts/gemini/extension/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "HelloLoop 的 Gemini CLI 原生扩展，用于按开发文档接续推进项目开发。",
   "contextFileName": "GEMINI.md",
   "excludeTools": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件",
   "author": "HelloLoop",
   "license": "Apache-2.0",
@@ -30,7 +30,7 @@
     "templates"
   ],
   "scripts": {
-    "test": "node --test tests/analyze_cli.test.mjs tests/analyze_intent_cli.test.mjs tests/engine_selection_cli.test.mjs tests/cli_surface.test.mjs tests/cli_doctor_surface.test.mjs tests/host_lifecycle_integrity.test.mjs tests/host_single_host_integrity.test.mjs tests/install_script.test.mjs tests/mainline_continuation.test.mjs tests/multi_host_runtime.test.mjs tests/process_shell.test.mjs tests/prompt_guardrails.test.mjs tests/ralph_loop.test.mjs tests/runtime_recovery.test.mjs tests/plugin_bundle.test.mjs"
+    "test": "node --test tests/analyze_cli.test.mjs tests/analyze_intent_cli.test.mjs tests/analyze_runtime_failure.test.mjs tests/output_schema_contract.test.mjs tests/engine_process_support.test.mjs tests/engine_selection_cli.test.mjs tests/cli_surface.test.mjs tests/cli_doctor_surface.test.mjs tests/host_lifecycle_integrity.test.mjs tests/host_single_host_integrity.test.mjs tests/install_script.test.mjs tests/mainline_continuation.test.mjs tests/multi_host_runtime.test.mjs tests/process_shell.test.mjs tests/prompt_guardrails.test.mjs tests/ralph_loop.test.mjs tests/runtime_recovery.test.mjs tests/plugin_bundle.test.mjs"
   },
   "engines": {
     "node": ">=20"

package/src/analyzer.mjs

@@ -2,7 +2,14 @@ import path from "node:path";
 
 import { summarizeBacklog, selectNextTask } from "./backlog.mjs";
 import { nowIso, writeJson, writeText, readTextIfExists } from "./common.mjs";
-import { loadPolicy, loadProjectConfig, scaffoldIfMissing, writeStateMarkdown, writeStatus } from "./config.mjs";
+import {
+  loadBacklog,
+  loadPolicy,
+  loadProjectConfig,
+  scaffoldIfMissing,
+  writeStateMarkdown,
+  writeStatus,
+} from "./config.mjs";
 import { createContext } from "./context.mjs";
 import { discoverWorkspace } from "./discovery.mjs";
 import { readDocumentPackets } from "./doc_loader.mjs";
@@ -32,6 +39,84 @@ function renderAnalysisState(context, backlog, analysis) {
   ].join("\n");
 }
 
+function createEmptyBacklogSummary() {
+  return {
+    total: 0,
+    pending: 0,
+    inProgress: 0,
+    done: 0,
+    failed: 0,
+    blocked: 0,
+  };
+}
+
+function getExistingBacklogSnapshot(context) {
+  try {
+    const backlog = loadBacklog(context);
+    return {
+      summary: summarizeBacklog(backlog),
+      nextTask: selectNextTask(backlog),
+    };
+  } catch {
+    return {
+      summary: createEmptyBacklogSummary(),
+      nextTask: null,
+    };
+  }
+}
+
+function firstMeaningfulLine(text, fallback) {
+  return String(text || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .find(Boolean) || fallback;
+}
+
+function summarizeFailedAnalysisResult(result, fallback) {
+  const combined = [
+    String(result?.stdout || "").trim(),
+    String(result?.stderr || "").trim(),
+  ].filter(Boolean).join("\n\n").trim();
+  return combined || fallback;
+}
+
+function renderAnalysisFailureState(context, backlogSummary, nextTask, failureSummary, runDir = "") {
+  const runDirHint = runDir
+    ? path.relative(context.repoRoot, runDir).replaceAll("\\", "/")
+    : "";
+
+  return [
+    "## 当前状态",
+    `- backlog 文件：${path.relative(context.repoRoot, context.backlogFile).replaceAll("\\", "/")}`,
+    `- 总任务数：${backlogSummary.total}`,
+    `- 已完成：${backlogSummary.done}`,
+    `- 待处理：${backlogSummary.pending}`,
+    `- 进行中：${backlogSummary.inProgress}`,
+    `- 失败：${backlogSummary.failed}`,
+    `- 阻塞：${backlogSummary.blocked}`,
+    `- 当前任务：${nextTask ? nextTask.title : "无"}`,
+    `- 最近结果：${firstMeaningfulLine(failureSummary, "HelloLoop 分析失败")}`,
+    `- 下一建议：${runDirHint ? `先检查 ${runDirHint} 中的日志后再重新执行 npx helloloop` : "修复错误后重新执行 npx helloloop"}`,
+  ].join("\n");
+}
+
+function persistAnalysisFailure(context, failureSummary, runDir = "") {
+  const snapshot = getExistingBacklogSnapshot(context);
+  writeStatus(context, {
+    ok: false,
+    stage: "analysis_failed",
+    taskId: null,
+    taskTitle: "",
+    runDir,
+    summary: snapshot.summary,
+    message: failureSummary,
+  });
+  writeStateMarkdown(
+    context,
+    renderAnalysisFailureState(context, snapshot.summary, snapshot.nextTask, failureSummary, runDir),
+  );
+}
+
 function sanitizeTask(task) {
   return {
     id: String(task.id || "").trim(),
@@ -186,10 +271,19 @@ async function analyzeResolvedWorkspace(context, discovery, options = {}) {
   });
 
   if (!analysisResult.ok) {
+    const failureSummary = summarizeFailedAnalysisResult(
+      analysisResult,
+      `${engineResolution.displayName} 接续分析失败。`,
+    );
+    persistAnalysisFailure(
+      context,
+      failureSummary,
+      runDir,
+    );
     return {
       ok: false,
       code: "analysis_failed",
-      summary: analysisResult.stderr || analysisResult.stdout || `${engineResolution.displayName} 接续分析失败。`,
+      summary: failureSummary,
       engineResolution,
       discovery,
     };
@@ -199,6 +293,11 @@ async function analyzeResolvedWorkspace(context, discovery, options = {}) {
   try {
     payload = JSON.parse(analysisResult.finalMessage);
   } catch (error) {
+    persistAnalysisFailure(
+      context,
+      `${engineResolution.displayName} 分析结果无法解析为 JSON：${String(error?.message || error || "")}`,
+      runDir,
+    );
     return {
       ok: false,
       code: "invalid_analysis_json",
@@ -208,7 +307,24 @@ async function analyzeResolvedWorkspace(context, discovery, options = {}) {
     };
   }
 
-  const analysis = normalizeAnalysisPayload(payload, discovery.docsEntries);
+  let analysis;
+  try {
+    analysis = normalizeAnalysisPayload(payload, discovery.docsEntries);
+  } catch (error) {
+    persistAnalysisFailure(
+      context,
+      `${engineResolution.displayName} 分析结果无效：${String(error?.message || error || "")}`,
+      runDir,
+    );
+    return {
+      ok: false,
+      code: "invalid_analysis_payload",
+      summary: `${engineResolution.displayName} 分析结果无效：${String(error?.message || error || "")}`,
+      engineResolution,
+      discovery,
+    };
+  }
+
   const backlog = {
     version: 1,
     project: analysis.project,

package/src/engine_process_support.mjs

@@ -7,6 +7,15 @@ import {
   resolveVerifyShellInvocation,
 } from "./shell_invocation.mjs";
 
+export function isIgnorableStdinError(error) {
+  const code = String(error?.code || "").trim();
+  const message = String(error?.message || "").toLowerCase();
+  return code === "EPIPE"
+    || code === "ERR_STREAM_DESTROYED"
+    || message.includes("broken pipe")
+    || message.includes("write after end");
+}
+
 export function runChild(command, args, options = {}) {
   return new Promise((resolve) => {
     const child = spawn(command, args, {
@@ -98,10 +107,29 @@ export function runChild(command, args, options = {}) {
       emitHeartbeat("running");
     });
 
-    if (options.stdin) {
-      child.stdin.write(options.stdin);
+    child.stdin.on("error", (error) => {
+      if (isIgnorableStdinError(error)) {
+        return;
+      }
+      stderr = [
+        stderr.trim(),
+        `[HelloLoop stdin] ${String(error?.stack || error || "")}`,
+      ].filter(Boolean).join("\n");
+    });
+
+    try {
+      if (options.stdin) {
+        child.stdin.write(options.stdin);
+      }
+      child.stdin.end();
+    } catch (error) {
+      if (!isIgnorableStdinError(error)) {
+        stderr = [
+          stderr.trim(),
+          `[HelloLoop stdin] ${String(error?.stack || error || "")}`,
+        ].filter(Boolean).join("\n");
+      }
     }
-    child.stdin.end();
 
     child.on("error", (error) => {
       if (heartbeatTimer) {

package/src/runtime_recovery.mjs

@@ -21,6 +21,8 @@ const HARD_STOP_MATCHERS = [
       "400 bad request",
       "bad request",
       "invalid request",
+      "invalid schema",
+      "invalid_json_schema",
       "invalid argument",
       "invalid_argument",
       "failed to parse",
@@ -28,6 +30,7 @@ const HARD_STOP_MATCHERS = [
       "malformed",
       "schema validation",
       "json schema",
+      "response_format",
       "unexpected argument",
       "unknown option",
     ],

package/templates/analysis-output.schema.json

@@ -5,6 +5,9 @@
   "required": [
     "project",
     "summary",
+    "constraints",
+    "requestInterpretation",
+    "repoDecision",
     "tasks"
   ],
   "properties": {
@@ -45,13 +48,19 @@
       }
     },
     "constraints": {
-      "type": "array",
+      "type": [
+        "array",
+        "null"
+      ],
       "items": {
         "type": "string"
       }
     },
     "requestInterpretation": {
-      "type": "object",
+      "type": [
+        "object",
+        "null"
+      ],
       "additionalProperties": false,
       "required": [
         "summary",
@@ -78,7 +87,10 @@
       }
     },
     "repoDecision": {
-      "type": "object",
+      "type": [
+        "object",
+        "null"
+      ],
       "additionalProperties": false,
       "required": [
         "compatibility",
@@ -122,7 +134,9 @@
           "goal",
           "docs",
           "paths",
-          "acceptance"
+          "acceptance",
+          "dependsOn",
+          "verify"
         ],
         "properties": {
           "id": {

package/templates/task-review-output.schema.json

@@ -7,6 +7,7 @@
     "summary",
     "acceptanceChecks",
     "missing",
+    "blockerReason",
     "nextAction"
   ],
   "properties": {
@@ -60,7 +61,10 @@
       }
     },
     "blockerReason": {
-      "type": "string"
+      "type": [
+        "string",
+        "null"
+      ]
     },
     "nextAction": {
       "type": "string",