[goal] 第一优先级:泛化 + 发 v1.0(第一个版本)

[loning]

一句话

Top-priority meta-goal: 把 `codex-refactor-loop` skill 推到 v1.0 release,前提是已经够泛化(host-agnostic,任何 host 项目能 install + 跑)。

当前 `package.json` = `0.1.0`。

两个目标互锁

• 泛化(generalization):skill 不耦合本 host 项目的具体事实;通过 `host.env` + `${HOST_*}` placeholder 注入,任何下游项目 install 后立刻能跑(在 host opt-in 缺失时静默 noop)。
• v1.0 release:`.version-bump.json` 映射的 6 个 manifest 同步到 `1.0.0`,经 `release.yml` publish。`auto_release_gate.py` 已为此设计了 stability gate。

两个目标互锁:泛化没到位 → v1.0 不能发(下游装不上等于没发);v1.0 release 出口存在 → 倒逼泛化最后一公里。

v1.0 发布必备清单(release stability gate)

`auto_release_gate.py` 已有的 signal,作为 release 闸:

1. `contract-tests` + `manifest-version-sync` 在 `$REVIEW_BASE_BRANCH`+`$INTEGRATION_BRANCH` 都绿
2. 0 个 `⏸️ phase:blocked` PR(当前:design: prompts 省 token 重写 — AI 间交流足够即可 #105 blocked,需先 re-cluster 或 close)
3. 0 个 `👤 human:需-maintainer-决策` label
4. 0 个连续 Phase 8 reject churn(≥3 rounds)
5. 30 min P0 alert streak ≤ 3
6. ≥ `RELEASE_AUTO_MIN_MERGES` recent merge commits(≥1)
7. ≥5 fresh daemon heartbeats
8. 0 unresolved `META_RESOLVED:escalate-human` records
9. release 间隔 > `RELEASE_AUTO_MIN_INTERVAL_HOURS`(默认 2h)

满足 ALL → `auto_release_gate.py --dispatch` 写 `release-decision.json` + `release-candidate.json` → controller/release.yml bump + publish。

泛化最后一公里(候选子 issue,每条独立 Phase 9)

• [goal] codex-refactor-loop 自适应 host GitHub 模板/配置 — 跨项目可移植性 #104(已开):自适应 host GitHub 模板/labels/CODEOWNERS/branch protection
• design: 哲学/SKILL 文档去版本后缀(V1/V2/schema_version) #107(consensus reached):去 `V1`/`V2`/`schema_version` 后缀(让 schema 表达稳定不变,不绑版本号)
• design: 程序检测不应依赖自然语言字面 — 支持中英切换 #106(implementation in PR feat(detection): replace NL-literal anchors with protocol tokens per #106 #109):detection 不依赖自然语言字面(支持中英切换)
• 新候选 A: `host.env.example` 完整 + 文档化 install / uninstall one-liner(let downstream just copy)
• 新候选 B: `scripts/install.sh`(可选)或 README 装机 walkthrough — host 项目 1 命令完成 daemon cron + statusline 安装
• 新候选 C: `host-policy-check.py` lint:downstream 项目装完后能跑 `/scripts/host-policy-check.py` 验证自家 `host.env` 合规

不动哲学(v1.0 凝固以下不变量)

• consensus 引擎身份(3/3 unanimous solver + meta-judge consensus + 真值表 merge gate)
• sentinel `⟦AI:AUTO-LOOP⟧`
• marker 词表
• daemon-first / narrow allowlist / no lifecycle authority by default
• `host.env` 是唯一 runtime fact 注入面

验证 v1.0 已发(definition of done)

1. 一个 blank-host 测试项目 install skill + 写 `host.env` 必填 → `bash /scripts/statusline.sh` 不爆,Phase 0 bootstrap 走通
2. `auto_release_gate.py --score-only` 在本 repo 拿到 stability 满分
3. 6 个 manifest version 同步到 `1.0.0`
4. GitHub release tag `v1.0.0` 由 `release.yml` publish
5. README 顶部声明 v1.0 + install one-liner

排序

• 现在到 v1.0 之前:design: prompts 省 token 重写 — AI 间交流足够即可 #105 close-or-re-cluster、design: 程序检测不应依赖自然语言字面 — 支持中英切换 #106→merge、design: 哲学/SKILL 文档去版本后缀(V1/V2/schema_version) #107→implement-staged、[goal] codex-refactor-loop 自适应 host GitHub 模板/配置 — 跨项目可移植性 #104→子 issue derive
• v1.0 之后:细化(prompts 进一步压缩 / detection 全面去 prose / 更多 host adaptation)

⟦AI:AUTO-LOOP⟧

[loning]

🤖 Stale revival (stale_hours=6, [goal] meta-issue)

Per 2026-05-28 maintainer-directive: 3h+ 未处理 auto-loop 必 re-engage。本 issue 是 [goal] meta-issue,不适合直接派 Phase 9 solver triplet。

当前状态

• 是 [goal] 级 issue,需要 break down into design sub-issues
• 已 derived: design: 通用 prompt 残留 host-specific 假设(C#/.NET/Tier/SPEC/proto 硬编码) #112(host-leak)→ PR fix(#112): delete residual host-specific prompt/reference vocabulary #131 merged ✓
• 待 derive: 跨平台清单 lint、版本同步守卫、其他泛化项

下一步建议

• maintainer 或 audit 选下个 sub-issue 派 Phase 9,而非整 issue 派 solver triplet

⟦AI:AUTO-LOOP⟧

[loning]

📌 泛化最后一公里子 issue 已派生

按 #110「候选子 issue,每条独立 Phase 9」,已开 A/B/C:

• A: design(v1.0 泛化 A): host.env.example 补全 + install/uninstall one-liner 文档化 #140 — host.env.example 补全 + install/uninstall 文档
• B: design(v1.0 泛化 B): 下游装机 walkthrough — 1 步完成 daemon cron + statusline #141 — 下游装机 walkthrough
• C: design(v1.0 泛化 C): host-policy-check.py — 下游 host.env 合规自检 lint #142 — host-policy-check.py 合规自检 lint

连同在途 #126/#118(PR #136)/#133(PR #137)/#107/#106/#104,构成 v1.0 泛化绑定路径。stability gate 当前 score=50(contract-tests 本轮已修待 CI 转绿;P0 streak/recent-merges 待健康 loop 衰减补齐)。RELEASE_AUTO_ENABLE 仍未 opt-in(maintainer 决策)。

⟦AI:AUTO-LOOP⟧

[loning]

🎯 第一目标锁定:发一个稳定的测试版(maintainer directive 2026-05-29)

maintainer 现场指令:把「发出稳定测试版」设为 loop 第一优先级(具体化本 goal)。已落 durable artifact .refactor-loop/runs/maintainer-directives/2026-05-29-first-goal-stable-test-release.md。

release gate 实测 ready=false(score 50),红信号→解锁项:

红信号	解锁动作	状态
p0_alert_streak_ok	#143 actor-owned heartbeat lease(停 router hang churn,头号)	implementing
required_checks_recent_green(dev+auto-refact-dev)	dev rollup sync	待
recent_pr_merges_min	修 recent-pr-merges.json 填充 gap	待开
fresh_heartbeats	#143 稳定后自愈	随 #143

绿:no_open_blocked_pr / no_human_decision_label / no_phase8_reject_churn / no_unresolved_human_escalation。

Critical path: 合并 #143 → #139(wake-source,PR #144 review 中)→ v1.0 泛化 #140/#141/#142 → 修 merge 记录 gap → dev rollup → 30min 无 P0 churn → auto_release_gate --dispatch。

边界:不降共识/review gate 抢发版;release decider 仍 artifact-only(#56)。

⟦AI:AUTO-LOOP⟧

[loning]

🔧 清除发版头号阻塞之一:auto-refact-dev contract-tests 转绿

发现:PR #137 合并后(与 #136 的 test 改动并行合并交互),test_scripts_source_prose_stays_english 在 auto-refact-dev 变红 —— concurrency_monitor.py + 3 个 test_*.py 里残留 22 处中文 refactor 注释(源码注释须 English-only)。这正是 required_checks_recent_green 红的根因,且阻塞所有 PR 合并。

修复:中文注释转英文(纯机械,无逻辑改动),全量 383 tests 绿,直接 commit+push 到 auto-refact-dev(3164bb9..15c5028,窄 source 修复 + 回归测试为守卫)。

教训(并入发版前置):多 PR 并行合并未对最终集成态重跑全量 CI → 交互失败。发版前应确保每次 merge 后 auto-refact-dev 全绿,再继续。open PR(如 #144)需刷新 base 才能拿到此修复转绿。

⟦AI:AUTO-LOOP⟧