jj-flow

外观

更新日志归档 ​

较早的发布记录。来源是仓库根的 CHANGELOG.md，与更新日志同源。

0.2.0 — 2026-09-07 17:02 ​

  • Ralph 需求确认不了先问：ANALYZE 以及 MUST / 范围 / 验收事后仍确认不了时禁止凭猜测推进。写 ## 存疑，停在当前阶段（或 BLOCKED），不触发当前/下一阶段 gate，不回滚到 ANALYZE。tiny init 只跳过空存疑；确认不了仍写存疑。合约：tests/jj-ralph-contract.test.mjs。
  • jj-review 同会话 follow-up 只审 delta：同一 bound run 已有 REV-* / 宿主审查文件时，禁止再 spawn 全量 reviewer 子代理（Grok /review 每次都是 effective_context_source=new）。复用上一份 findings，只审相对 reviewed_commit 的改动。G-review-1。样本：docs/evaluations/EP-20260907-grok-review-subagent-waves-report.md。合约：tests/jj-review-contract.test.mjs；回归：evals/regression/EP-20260907-grok-review-subagent-waves.json。
  • 实验场锁定新不变量：Loop gym L1-S9/S10（审查切片拒 init、同会话 thread_id 拒第二份）；Family gym L2-S7/S8（reuse-sibling、same 不调 ensureDispatchRalphRuns）。findLiveRalphSibling 同时识别 active 与 leftover tasks/，按 run_id 去重，布局混杂时优先唯一 active 切片。L1-S9 --force 同需求提示须先 seed 非切片 live run。合约：tests/task-artifacts.test.mjs；本地 npm run lab:check。
  • Dispatch 同会话复用 Ralph（已批准）：同一 delivery + 同会话 / 唯一审查切片走 reuse-sibling，禁止再 init 空占位；same 先复用目标仓 live run，不调 ensureDispatchRalphRuns。多轮对话不能推进控制面。回归：evals/regression/EP-20260904-h5-enter-dual-ralph.json。
  • jj-end 完成回复：落地或回退结束只回一行——已合并：<工作分支> → <目标> · 当前在 <HEAD>（合完默认回到工作分支） / 已回退：<原因> · 当前在 <HEAD>。合约：tests/jj-end-contract.test.mjs。
  • 审查保持只读：$jj-review / /review 只出 findings，不在同一轮改代码；等用户说「按审查改」再 DELIVER。合约：tests/jj-ralph-contract.test.mjs、tests/jj-review-contract.test.mjs。
  • 统筹 task.md 绑定实际 Ralph：Goal/Steps 列出实际绑定的 run_id（reuse-sibling 不以 delivery slug 冒充）；jj ralph init --thread-id / host.thread_id 纳入同会话守卫。合约：tests/task-artifacts.test.mjs、tests/jj-ralph-contract.test.mjs。
  • Ralph lean 验收仍拦截弱证据：## 验收 checkbox（[x]=PASS）也走 inspectAcceptanceEvidence；write-then-read / cross-path / runtime-env 仅 static/diff/rg 或无证据仍拦截 accept PASS。合约：tests/jj-ralph-contract.test.mjs。
  • Ralph 审查切片不是新任务：场景 task-h5-enter-review-fix 与 task-enter-form-h5 是同一需求。init 拒绝 审查修复 / 按审查 / review-fix 新 slug；index.md 写 ## 同需求提示（同会话或审查切片并排），只提示不自动合并。Dispatch 对同会话或唯一审查切片走 reuse-sibling。合约：tests/jj-ralph-contract.test.mjs、tests/task-artifacts.test.mjs。
  • jj-init 推断现有家族：preview / 无 --family 的 join 按地图已有家族建议（同父目录已入册仓，或名称/别名含该家族且最长唯一，如「中国大集管理后台」→ 大集）。不发明新家族名。无家族 join 写入 Ungrouped，不再落到文件最后一个 ## 表。合约：tests/jj-init.test.mjs。
  • jj-end 合入方向 + 两边意图：只许 work → integration，禁止把 dev 合进功能分支；冲突必须对照两个父提交的独有行为都留下，禁止 --ours/--theirs 整文件取一侧（40e3f959 审核详情 / 外综服入口被盖）。G-end-3。任务 / 合并 / 需求说不清先问（G-end-4），不臆造、不挑一边。合约：tests/jj-end-contract.test.mjs。
  • jj-same 写面对齐 Ralph：迁协议仍只进目标仓 Ralph（先复用同会话 / 审查切片 live run，否则 dispatch task-<slug>；task_plan = Goal / 验收 / Steps + ADAPT）；ANL-TARGET 只当 id，禁止把正文写进 ~/.jj-flow TASK-* 或再造 csv-wave 实施本。same 不调用 ensureDispatchRalphRuns。handoff 路径改为扁平 ralph/<run_id>/（不再写错 ralph/tasks/<task_key>）。
  • Dispatch 统筹 / 项目 Ralph 分轨：~/.jj-flow 只写 plane / 回执 / TASK-* 索引（Goal / 验收 / Steps）；jj task scaffold / DISPATCH 必须在每个 lead/target 业务仓 init 或 resume 完整 Ralph task-<slug>。禁止再用 control 目录的 ANL-LEAD / ANL-TARGET / 「分发提示词」当作实施本。合约：tests/task-artifacts.test.mjs、tests/jj-dispatch-contract.test.mjs。
  • Ralph next + index 归档提示：jj ralph status / locate 带 next（NEEDS_CHANGES→review，accept PASS 且 latest 为 working_tree PASS→commit-scoped-review，可落地→finalize；resume 后有 run.archive 不误报必须立刻 finalize）。index.md 在活跃 task-* 超过 5 条或任一条 5 天未更新时写 ## 归档提示，只提示不自动归档；PAUSED/BLOCKED/进行到一半先问用户。saveRun 刷新 index（写失败不影响 run.json）。合约：tests/jj-ralph-contract.test.mjs。
  • jj-review 不依赖 ralph：未点名 run_id 且没有 run 时审工作区 / HEAD（不 init、不落盘 REV-*）；只有显式 run_id 找不到才 BLOCKED。未点名时先读 .workflow/ralph/index.md 的「活跃」表找正在做的任务，没有活跃行再 glob。合约：tests/jj-review-contract.test.mjs。
  • jj-review 完成回复：无问题回 通过。 + 一句总结；有问题列出每条问题 + 修改意见。审查仍只读，等用户说「按审查改」。合约：tests/jj-review-contract.test.mjs。
  • Ralph migrate 整理存量 .migrated-*：根上 .migrated-RALPH-* 移入 migrated/；tasks/ 遗留上提到根目录；COMPLETED/ABANDONED 再移入 completed/。幂等，不自动删除残骸。合约：tests/jj-ralph-contract.test.mjs。
  • Ralph 人读产物收敛为短合同：task_plan.md 只留 Goal / 验收 / Steps（当前合约）；progress.md 按日追加人读叙事；机器事件只写 .state/events.jsonl。findings.md 改动摘要 + 行为 + 实际踩坑 + 验证，禁止空 F-00N。map-find 不再把 title/goal 切成 keywords 写入 business-map.json。Skill 约定：并行读、offset/limit、禁止重读已注入内容、禁止整文件读取 business-map；Grok 默认不调 MasterGo MCP。Loop gym L1-S7a 改为同一合同（重写 live Goal，历史进 progress；不再要求 已落地/Landed）。jj-review 对照 ## Steps（leftover ## 计划 → ### 当前）；review-record 机器记录写入 events.jsonl，compliance 关闭条件不再要求往 live plan 追加已落地。合约：tests/jj-ralph-contract.test.mjs、tests/memory-hot-layer.test.mjs。
  • jj-ralph 对话路径弃用 lite：真实口语几乎不用 lite / 随手修。$jj-ralph 一律五 gate，不传 --lite / brief / close，忽略 init gate_set?。只留 intensity tiny|standard|strict（tiny 只缩短计划）。补真实说法：截图 / 「这里」先当需求；「先不写代码」停在 ANALYZE；同会话「继续 / 按审查改 / 改坏后」resume 禁止 init。机械 CLI --lite 仍兼容旧 run，本轮不拆 src/ralph。合约：tests/jj-ralph-contract.test.mjs。
  • jj-end 冲突默认自行合并：分类从 simple/complex 改为 self-merge/unhandleable。两边都在演进、能一句话说清如何合并的（Vue/文档/条件守卫不同，如 feat/dynamic-form 的 AGENTS.md、readonly vs uploadDisabled、草稿 helper、LOGO 条件）必须自行合完继续收工；只有同一产品开关两边相反且无法判断、二进制/密钥、读完仍无法陈述解法才整段 abort。禁止「看起来像逻辑就停」和子集可解再 abort。G-end-2 改写。合约：tests/jj-end-contract.test.mjs。
  • Ralph 自动结案补录（§4.5 / §4.9.4–5）：仓内补录 ralph-auto-closeout（标明非修订 10 原文；表格外 code span 用 |）。locate 行带 next / warning / closeout。jj install-skill --platform agents（--platform all 含此端）写入 ~/.agents/skills + commands，安装时清理 retired。jj ralph remediate 默认 dry-run，--yes 只处理 finalize 与 migrate。主路径仍见 PR #30。
  • Ralph 自动结案（auto-closeout）：accept PASS 后 MUST finalize。status 带 next；phase=ARCHIVE 仍在活跃根标记「未完成收尾」。writeRalphIndex 写失败降级。jj ralph locate 覆盖扁平 task-* 与 completed/。合入：PR #30 / d377acb。
  • 文档站迁移 VitePress：站点声明移到 docs/.vitepress/；交互演示下线；docs:check 改为侧栏覆盖 + 构建校验。合约：tests/docs-site.test.mjs、tests/harness-check.test.mjs。
  • Ralph 工作区目录对齐 exec-plans 与 progress 双轨（规划草案，Proposed）：docs/design-docs/ralph-workspace-layout.md。推荐保留 tasks/ 作为活跃层（≡ exec-plans active/），根上加 CLI 生成的 index.md，finalize / abandon 把任务目录 rename 进 completed/、resume 移回；.migrated-RALPH-* 移入 migrated/ 并由 migrate --prune --yes 人工删除。progress 分轨：机器事件改写 .state/events.log，progress.md 只留按轮次追加的人读叙事，resume 自动开新轮。附二次纠正场景的改写样本、Phase 0–2 方案与验收要点。本轮不改 src/ralph/，schema 仍 1.2。
  • Ralph 自动收尾（accept → finalize 同回合闭环）（规划草案，Proposed）：docs/design-docs/ralph-auto-closeout.md。finalize 改为同回合 MUST + gate 输出 next 提示（含 ralph_ops.mjs 输出层）+ jj ralph status 第二道告警；解析链按当前宿主排序（本宿主 → 仓内安装 → 其它宿主 → 全局 jj → npx）；.state 禁止手写；gate_set=undefined 修复；index 刷新下沉 saveRun（run.json 先落盘、index 写失败降级不影响主写入；migrate 批路径豁免；jj-ralph Locate 与 jj-review 找任务都先读 index 活跃表，本修复是两者的共同依赖）；init 模板删 > Status: 叙事头，状态只存在于 run.json + index + progress 当日轮次。本轮不改 src/ralph/。
  • Ralph P0 热层知识闭环：findings.md 作为现有布局附加文件；archive 从 ## 可复用结论 晋升 ~/.jj-flow/memory/<project_key>.md；init / resume / dispatch 词法注入（cap 5，confirmed 置顶）。jj ralph finding + DELIVER 软提示；省略 --rule 时用对策（适用范围）写入可复用结论。不改 run.json schema。合约：tests/memory-hot-layer.test.mjs、tests/jj-ralph-contract.test.mjs、tests/jj-dispatch-contract.test.mjs。
  • Ralph 工作区 P2 身份稳定化：run_id ≡ task_key ≡ task-<slug>；新 run 写 .workflow/ralph/tasks/<id>/{task_plan,progress,findings}.md + .state/{run.json,reviews/,handoff.json}（schema 1.2）。活跃 RALPH-* load/gate/save 报错并提示 jj ralph migrate；listRuns 标 needs_migrate。jj ralph adopt --task 绑定；--absorb 拒绝自动合并。主路径不再认 ## Current/## Tasks。sample-run.json 保持 1.0。不做 lite 档。
  • Ralph P2 review-fix：adopt --task 遇已有 live dest 拒绝覆盖；leftover archive/ 产物从快照目录读；status 列表标 needs_migrate；init 打印 reuse 候选。合约：tests/jj-ralph-contract.test.mjs。
  • Ralph 工作区 P2+a lite 档：jj ralph init --lite|--full（ralph_ops 同）显式覆写 gate_set，默认仍 full，与 intensity 正交（tiny ≠ lite）；lite budget.max_deliver_loops ≤ 3，stagnation 照常执行。setGate 接受别名 brief（analyze+plan）/ close（accept+archive），内部仍写五键；close 照常走 accept/archive 证据门与 judgment 层，弱证据仍拦截，可接 finalize。任一 lite gate FAIL/BLOCKED（setGate / rollbackPhase）或 jj ralph scope --in 新增 scope.in → 自动升 full（恢复 intensity 预算，不小于已用次数），同目录不换 run_id，progress 追 promoted lite→full。schema 不升 1.3。合约：tests/jj-ralph-contract.test.mjs。
  • Ralph 工作区 P2+b 启发式判档 + 文案：jj ralph init 无 --lite/--full 时按规模只建议（suggestGateSet：scope.in ≤ 2 个具体文件或小改口语说法 ∧ 无架构词 ∧ 单一验收项才建议 lite，拿不准即 full；不读 intensity，tiny ≠ lite）；建议附在返回对象 run.gate_set_suggestion（applied=false）+ progress 一行，文本模式输出 gate_set? lite …，ralph_ops init 透出；run.json.gate_set 无显式 --lite 永不变 lite。skill / docs/commands/jj-ralph.md / claude-commands：「小改 / 随手修」→ --lite，「完整走一遍」→ --full，没说 = full；phases.md 新增「Gate set (full / lite)」。合约：tests/jj-ralph-contract.test.mjs（P2+b 两例 + 文案标记）。
  • Ralph 工作区 P2+ lite exec-plan 关闭：docs/exec-plans/completed/2026-09-03-ralph-plans-workspace-p2-lite.md（P2+a + P2+b 勾选完成并附验收证据）；设计 Ralph 任务工作区 .plans 化改造 §3.8 / §4 P2+ 标落地，整体标 Implemented。
  • Ralph lite 预算出口解除过期 BLOCKED：lite 在 max_deliver_loops=3 到顶后走 gate deliver FAIL（或 scope --in 膨胀）升 full 时，promoteGateSetToFull 同时把这条因预算而起的 MAX_ITERATIONS BLOCKED 翻回 IN_PROGRESS 并清理过期的 intervention_needed（progress 行带 status=BLOCKED→IN_PROGRESS）；显式写 BLOCKED 的 gate 与 STAGNATION 不解除。此前升 full 后 run 仍显示 BLOCKED + 过期原因，与「继续走五 gate」不符。skill / 文档同步：预算到顶不自动升档，出口才升。合约：tests/jj-ralph-contract.test.mjs（P2+a 升档用例 d3–d5）。
  • CI：sibling gym pin 升到 P2 布局：.github/actions/prepare-lab-roots 的默认 pin 从 loop 1dc1493 / family 9c2eb5b 升到 loop ed72b08 / family 0b8ec50（gym 侧已对齐 tasks/<task-*>/.state 布局与 task-* 身份）。此前 main 的 verify / lab-windows 在 lab:check 报 LAB-ORACLE-FAIL（loop acceptance.md ENOENT、family legacy RALPH run layout），是 pin 过旧，不是产品缺陷。本地按 CI 同法 clone + seed 后 npm run verify 全绿。pin 维护说明见 docs/jj-lab-siblings.md。
  • Ralph 工作区 P1 exec-plan：docs/exec-plans/completed/2026-09-02-ralph-plans-workspace-p1.md。P1a 已拆 src/ralph/{state,gates,map,knowledge,archive}.mjs，src/ralph.mjs 仅门面 re-export。P1b 布局 8→4 + schema 1.1：活跃 run 写 task_plan.md / progress.md / findings.md / run.json；停写 knowledge-attach.json / knowledge-contribution.json（home ingest 显式降级，热层替代）；validateRun 仍读 1.0。P1c 归档原地翻转：run.archive / archive_history 内联 sha256 清单，停写 archive-manifest.json，不再复制到 .workflow/ralph/archive/（旧副本只读保留）。
  • Ralph P1c 归档反转：archiveRun 把活跃目录 status 置 COMPLETED（仍可 resume）；last_archive_path 指向 live .workflow/ralph/<run_id>；再归档追加 archive_history[]（时间 + git HEAD + 清单哈希）。CLI result.manifest 仍返回内存兼容对象（jj-flow/ralph-archive/1.1）。合约：tests/jj-ralph-contract.test.mjs。
  • Ralph P1b 布局：init 只写中文段名（## 目标/分析/计划/验收 + ### 当前/已落地/已取代）；extractMarkdownSection 层级感知；计划当前两跳 计划→当前，回退 当前→Current→Tasks→全文；artifact_refs 禁 # 锚点。jj-review 对照 task_plan.md 三 section。合约：tests/jj-ralph-contract.test.mjs、tests/memory-hot-layer.test.mjs。
  • 全局知识库默认 ~/.jj-flow：install-skill / jj home init 生成 naming.json、map.md、knowledge/index/search.json（已有文件不覆盖）。产品默认不再依赖本机 /portfolio。
  • $jj-init：接入全局地图、梳理项目、补知识库。机械步骤 jj init preview|join|ingest；ralph / same / dispatch / doctor 只读地图，不在进场写入。用户点头后才 join / ingest。
  • 用户同意才写入：新项目不自动进全局索引。jj map lookup 只读；写入走 $jj-init。单轮归档后的「投喂知识库」仍可在 ralph 做增量。
  • 家族检索：同一 map.md 家族可共享知识挂载；未分组项目仍仅同仓。无自定义 hook 时，「投喂知识库」走内置 home ingest（当前 project_key）。
  • Grok Mode P（Phase 2c）：opt-in 子会话 1:1（非默认）。PREVIEW proposed_mode=P；写责任 BIND 不得共享 session；placeholder 拒 BIND；Mode P + isolation → PREFLIGHT #5 BLOCKED（改用 Mode W）。不升 A3/A4。
  • Autonomy A2：人工审查认定 real-host-acceptance 清单 1–4 PASS。max_unattended_level=A2（default_level 仍 A1）。Grok Wave 2 关闭条件是里程碑 completed + manifest A2 + 试跑 JSON evaluable；JSON 不得自关。未升 A3/A4。
  • Grok Host Wave 2 真试跑：jj grok-trial run 绑定真实 GROK_SESSION_ID（拒绝 placeholder / host:trial），协议含中断 RECONCILE、exclusive-worktree、Review 返工。已写入 docs/milestones/real-host-trial-grok.json（evaluable）。real-host-acceptance 为 in_progress。不进 verify，不关 Wave 2，不升 A2。
  • Grok Host Adapter Phase 2：项目注册表（path + git identity）、bindGrokSessionTask / reconcileGrokSession、jj doctor 检测 grok 与 skill 安装。Wave 2 评估器拒绝 lab-harness / host:trial / skill-only / placeholder session。不写 real-host-trial-grok.json PASS，不升 A2。
  • Grok Mode W（Phase 2b）：isolation 时 exclusive-worktree。PREVIEW workspace_table.proposed_mode=S|W；DISPATCH PREFLIGHT #5（Mode S + isolation → 平面不变 BLOCKED）；attestation execution_mode=W 不得绑 project.path；git worktree 必须落在命名分支 tip，禁止 silent detached。不关闭 Host Wave 2，不升 A2。
  • AI-native SDLC 对齐（切片 0–7）：把 playbook 控制习惯翻译进 same / ralph / dispatch，不开第六阶段或第四条主路径。
    • 可选 intent.md（tiny 跳过）；声称路径与审查对照只认 plan.md ## Current。
    • 审查政策：bugs / security / compliance；finding 可选 pass / importance；nit 上限 5；PASS 时 nit WAIVED。
    • 两次打脸写 instruction-correction.md（Reviewer 不写 AGENTS.md）；修缺陷不得删/掏空测试。
    • 派生 jj ralph metrics；缺时钟为 null，不挡 ACCEPT。
    • 确定性 evals/regression/ + npm run evaluated:check 进入 verify；事故加考题，禁止自动 promote。
    • 宿主护栏样例 examples/host-guardrails/（不是协议）；并行 2–3 路，审查跟不上就停。
    • 同需求 resume；新需求才新 intent。设计 Implemented：docs/design-docs/ai-native-sdlc.md。
  • 测试入口：npm test 改为 node --test tests（Windows 下 npm 会把 tests/*.test.mjs 当字面路径）。
  • 实验场协议后续（PR10）：evaluateAcceptArchiveGate 把 evidence_class 过弱的 ACCEPT PASS 挡掉；dispatch 新增 gym-only lab-harness host（session，不关 Wave 2）；CI 增加 windows-latest lab:check job。
  • 实验场进 verify（PR9）：npm run verify 含 lab:check。CI / NPM Publish 在 verify 前 clone beerui/jj-lab-loop 与 beerui/jj-lab-family 到不落在 $HOME 下的绝对路径并 seed，注入 JJ_LAB_*_ROOT（默认 $RUNNER_TEMP；GitHub-hosted Ubuntu 的 $RUNNER_TEMP 在 $HOME 下，改用 /tmp/jj-flow-labs）。缺根 fail-closed；不猜 ../jj-lab-*。
  • 实验场机械闭环（PR3–PR8）：产品 scripts/lab-check.mjs + npm run lab:check（缺根 fail-closed）。Loop gym 种子/env-print/ralph 机械 oracle；Family gym 种子/copy-CREATE/dispatch attestation。Agent 场景说明书在各 lab scenarios/。
  • 实验场 sibling 仓（PR2）：产品 pointer docs/jj-lab-siblings.md + lab-roots.json.example；.gitignore 忽略 lab-roots.json；HNS-PUBLISH-LABS 禁止把 labs/ 打进 npm files / pack。gym 本体在旁路仓 jj-lab-loop / jj-lab-family，不进产品树。
  • 实验场设计（Implemented）：两个 sibling 仓 jj-lab-loop / jj-lab-family 专门测工程能力、红灯边界与三条主路径闭环；不进 npm、不改检查点、不把 gym 放进产品 labs/。设计：docs/design-docs/jj-flow-labs.md。exec-plan 已关闭。

0.1.3 — 2026-08-29 16:37 ​

  • ralph 知识挂载：init attach 改用 jj-multica 已实测的词法检索（CJK 相邻/跳一字 bigram、单字不计 strong、MinRelatedScore=5、软顶 5 条）。同项目灌水与空 query 不再填配额；0 命中就是 empty。
  • 知识抽取 Gate B：lesson 须可迁移（换一张卡还得遵守）。人审锁定 keep/drop 见 tests/fixtures/extract-future-reuse.golden.json：本卡现象、只加感叹号、字段备忘丢掉；必须/不要/勿/协议 留下。capability 仍作 L2 档案，不自动 promote。
  • 全量评测：eval/ralph-memory/run-eval.mjs 扫业务仓 Ralph 归档。对照旧 attach：打满配额 23/23→3/23，Jaccard 0.15→0.02，无关领域 3 次误召回→0。合约：tests/jj-ralph-contract.test.mjs、tests/memory-retrieve.test.mjs、tests/memory-extract.test.mjs。

0.1.2 — 2026-08-28 22:26 ​

  • jj-end 合入目标：有 dev 且未写 integration=、文档也未点名集成分支时，只合 dev。git log / Merge #N into staging 不算约定（EP-20260828）。
  • jj-end 冲突：agent 判断 simple/complex（拿不准当 complex）。全部 simple 则解完继续收工；有一条 complex 则整段 abort，不分解子集（G-end-2）。
  • 复盘：docs/evaluations/EP-20260828-jj-end-staging-not-dev.md；踩坑 §9 / §10。

0.1.1 — 2026-08-25 14:29 ​

  • 正式版：由 0.1.1-beta.52 去掉预发布后缀；npm latest 应对准本号。安装示例改为 npx @brewer/jj-flow@latest。
  • jj-ralph 任务变更保留历史：live plan.md / analyze.md / acceptance.md 以 ## Current 为当前合约；改方案时先挪到 ## Landed / ## Superseded，禁止整文件覆盖。
  • 旧标题兼容：已有 ## Tasks 且无 ## Current 时，先改名为 Current 再挪；analyze 仍用 ## MUST，acceptance 仍用表格。
  • init 骨架：ralph_ops init 的 plan.md 写入 ## Current（不再写 ## Tasks）；合约测试覆盖。

0.1.1-beta.52 — 2026-08-10 17:57 ​

  • Skill 可执行性（darwin）：jj-same / jj-dispatch / jj-ralph / jj-evaluated 等补齐 In→Out 或门控路径、Failure recovery 三段式、🔴 CHECKPOINT / 🛑 STOP、用户可见 closeout/PREVIEW 模板；附 test-prompts.json（同/dispatch）。
  • jj-same：Ralph 指针化、LITE/FULL 单点、STALE/多目标部分失败/control-scope 失败行；paired 3-0 keep。
  • jj-dispatch：PREVIEW→approve→DISPATCH 逐步 I/O、假 VERIFIED / 未批准 DISPATCH / CREATE 基线恢复表；paired 3-0 keep。
  • 说明：控制面语义与 CREATE 本地 master 纪律不变；本批为 skill SSOT 文案与门控清晰度。

0.1.1-beta.51 — 2026-08-10 14:56 ​

  • CREATE 仅从最新本地 master：jj-dispatch / jj-same 新建 feature 分支前必须 git fetch，在 local master 干净且 behind 时 FF_LOCAL_MASTER（checkout master + merge --ff-only origin/master），再 CREATE_FROM_LOCAL_MASTER（checkout -b <feat> master）。
  • 移除 CREATE_FROM_ORIGIN 主路径：禁止在 local master 仍旧时从 origin/master 直接建分支；禁止静默从 dev/develop CREATE；脏/分叉 master 仅 NEEDS_CONFIRM/BLOCKED（禁止静默 reset --hard）。
  • 决策表枚举对齐：base_action = FF_LOCAL_MASTER | CREATE_FROM_LOCAL_MASTER | NEEDS_CONFIRM | BLOCKED（happy-path / preflight G6 / grok PREFLIGHT / host-action-contract）。

0.1.1-beta.50 — 2026-08-07 ​

  • jj-team-lifecycle：可选固定 SDLC 会话执行引擎（TLV4-*；vendor team-lifecycle-v4；固定角色 + spec-only/impl-only/full-lifecycle；CHECKPOINT supervisor；Codex degraded；嵌套 ralph/review/dispatch 时一句「开启 lifecycle 模式…」；不推进 checkpoint）。
  • 用户文档：docs/commands 增加 coordinate / lifecycle / swarm 页；首页 / 命令总览 / 术语 / jj 路由分流同步。
  • 交叉引用：coordinate / swarm design 与 zh-bridge 补齐 TLV4 与三引擎选型；ralph integrations 接缝。
  • 合约：tests/jj-team-skills-contract.test.mjs 覆盖 lifecycle inventory/路由/前缀。

0.1.1-beta.49 — 2026-08-06 ​

  • CodeGraph soft prefer：jj 入口与 ralph phases / integrations 约定——宿主已挂 CodeGraph MCP 且仓内索引可用时，结构探索（调用链、影响面、跨文件入口）可优先走图谱；缺省/失败立即回退 Read/Grep；图谱不推进 checkpoint、不替代验证证据。非硬依赖，jj-flow 不随包安装 CodeGraph。
  • AGENTS：代码定位规则与上述 soft prefer 对齐。

0.1.1-beta.48 — 2026-08-05 ​

  • jj-team-coordinate：可选多角色执行引擎（TC-* session）；catalog fail-closed；Codex degraded（tasks.json / 文件消息总线）；嵌套 ralph/review/dispatch 时一句提示「开启 team 模式，开始任务… 约…」；直接调用无强制 banner。
  • jj-team-swarm：可选对抗蚁群搜索（TAS-*，Python aco.py + explore/score/converge/synthesize）；默认 3×3 与非 adversarial 评分；嵌套时「开启 swarm 模式，开始任务… 约…」；合约测 + aco 回归。
  • 路由 / 文档：jj 与 inventory / Claude 薄入口；design + skill-zh-bridge 中文对照；ralph integrations 接缝；不推进 checkpoint。

0.1.1-beta.47 — 2026-08-03 ​

  • Skill SSOT 顶层化：完整 skill 编辑/发布源为 skills/（不再以仓库内 .codex/skills 为权威源）；install-skill 仍分发到各宿主 skills 目录
  • Claude 安装目标：--platform claude|all 同时安装完整 skill 到 ~/.claude/skills 与薄入口到 ~/.claude/commands
  • 打包源与宿主目录分离：
    • 仓库跟踪：skills/、agents/（Codex agent 配置）、claude-commands/（Claude 薄入口）
    • git 忽略且从远端移除：.claude/、.codex/、.cursor/（宿主安装/本机配置，禁止再当 SSOT 推送）
  • Skill 正文英文化：产品 skill 协议改为英文 SSOT；中文对照见 docs/skill-zh-bridge/
  • must-evidence：ralph ACCEPT 证据形状契约（evidence_class）

0.1.1-beta.46 — 2026-08-03 ​

  • CREATE 基线新鲜度（EP-20260803）：jj-same / jj-dispatch 新建功能分支前必须 git fetch 集成基线，报告 behind_count；禁止从陈旧 local master tip 静默 checkout -b；允许 ff-only 或从 origin/master 建分支；仍禁止对脏/分叉 master 做 hard-reset。
  • same 收工短总结：五项门禁改为 agent 内心自检，禁止对用户展示「稳健/剃刀/…」清单；聊天只输出决策/改动/验证/Git 小结；recipes.mjs 与合约测试对齐。
  • 评测：docs/evaluations/2026-08-03-dispatch-stale-master-branch.md（stale local master CREATE 负例与 C-base-freshness-v1 推广）。

0.1.1-beta.45 — 2026-08-01 ​

  • npm 包迁移到 @brewer/jj-flow
    • package.json name / publishConfig.access=public / release-please package-name
    • 文档与 CLI help 示例：npx @brewer/jj-flow@beta …
    • ralph_ops 解析优先 @brewer/jj-flow
  • 信息保护 / 示例脱敏：文档、skill、评测与样例中的业务项目角色统一改为 项目A / 项目B / 项目C（及项目D/E），路径改为 /portfolio/* 或 /path/to/*；去掉真实仓名、本机绝对路径与开发者缩写示例

0.1.1-beta.44 — 2026-08-01 14:21 ​

  • ralph 归档提升 E1–E3：
    • process_lessons 与 durable lessons 分桶（默认 STAGNATION 不进主 lessons）
    • finalize 写 knowledge-contribution.json（全局 candidate 包，不 auto-promote）
    • jj ralph knowledge-contribute [--hook]；env RALPH_KNOWLEDGE_HOOK / RALPH_KNOWLEDGE_HOOK_CMD；fail-open
    • skill / 用户文档：口语「投喂知识库」；设计稿 ralph-archive-elevation / ralph-knowledge-contribute
  • docs(ralph)：用户口语优先，禁止逼报 RALPH- 编号

0.1.1-beta.43 — 2026-08-01 10:55 ​

  • jj-ralph 无终态冻结（同任务持续交付）：
    • 归档 = 快照 + map（可再归档），不是任务作废；COMPLETED 可 resume 同 run_id
    • ABANDONED：半途丢弃（禁 map-merge），可再 resume；close deprecated
    • rollbackPhase 含 ARCHIVE→ACCEPT；resume / abandon CLI；合约测试对齐
    • 文档重整：用户命令页 / skill / design / demo；jj-end 边界（只 Git）；Claude 薄入口
    • exec-plan：2026-07-31-dispatch-ralph-rollback → completed（R3-3 supersede）
  • 说明：0.1.1-beta.41 中「归档后新 run / 禁止 reopen COMPLETED」已被本项取代（历史版本记录保留）

0.1.1-beta.42 — 2026-07-31 21:01 ​

  • jj-ralph 强度档 + 双层 ACCEPT + 停滞早停（速度×质量，不引入多 agent/ACO）：
    • init --intensity tiny|standard|strict：默认 budget / stagnation / accept_layers
    • deliver-attempt：连续无改进 → BLOCKED + STAGNATION；触顶 max_iterations/budget；可省略 --improved 用 diff+signal 指纹自动判定
    • accept-layer：mechanical/judgment；strict 验收前 judgment 必 PASS；gate_issues error 挡 accept
    • recordReview 自动同步 accept_layers.judgment；map-merge 派生 STAGNATION/strict lessons（弱信息素）
    • schema/skill/CLI/phases.md/设计文档/样例/合约测试同步
  • docs（ralph）：用户文档用项目A/项目B/项目C、控制项目、RALPH-*/DEL-*/CAP-* 真实话术；续作说人话；cli.md 补新子命令；内部机制交互演示 milestones/ralph-demo.html（根路径重定向）
  • docs（end）：收工机制可交互演示 milestones/end-demo.html
  • docs（dispatch）：调度演示通俗化 + 输出到 milestones/dispatch-demo.html，根路径保留重定向
  • jj-ralph 续作协议 nits（随 41 后主线一并进包）：supersedes_run_id / parent_run_id 规范键；progress.md 链；合约锁定

0.1.1-beta.41 — 2026-07-31 18:23 ​

  • jj-ralph 续作协议（改错 / 加子需求）：归档前同 run_id 扩 scope 或按相邻边回退；归档后新 run + progress.md 链（纠正用 supersedes_run_id，纯子需求用 parent_run_id）；禁止 reopen COMPLETED / invent 未 schema 的 run.json 字段。
  • Skill：skills/jj-ralph/references/post-complete-continue.md；rollback.md / SKILL.md 交叉引用。
  • 文档：docs/commands/jj-ralph.md §1；docs/design-docs/jj-ralph.md 站点链接 command-jj-ralph.html。

0.1.1-beta.40 — 2026-07-31 14:45 ​

  • 技能面 90+ 三波优化（Wave0–2）
    • Wave0：可移植命名/map 解析（去掉 ralph 立即动作 /portfolio 硬编码）；jj 路由补全 /jj-end、dispatch 多端、evaluated experimental、不确定不默认 same；Claude jj-same 瘦身；jj-review 去幽灵 /jj-dispatch + host 矩阵；jj-end monorepo/dry_run 加固；ARCHITECTURE / inventory 平台文案对齐。
    • Wave1：jj-same / jj-dispatch progressive disclosure（主 SKILL 压缩 + happy-path / workflow-core / agent-write-plane references）；Claude 薄入口行数门禁 SKI-CLAUDE-005（≤40 行）。
    • Wave2：jj-evaluated experimental MVP runner（episode-validate.mjs / evaluated_ops.mjs：validate、init-report、check-split）+ 合约测试；design 状态 Implemented（验收证据链）。
  • 测试：tests/jj-evaluated-contract.test.mjs；skill-inventory thinness；install/harness 断言适配 progressive disclosure。
  • 文档：docs/commands/jj-same.md 补准备交接 / freshness 入口说明。

0.1.1-beta.39 — 2026-07-31 10:58 ​

  • T-lead-outside-schema + T-task-result-sync：lead∉targets 时可用完整 reference_implementation 代替空 lead_responsibilities；checkpoint/last_result 不再强制 recorded_at 相等；recordTargetResult 同步该 lead 逻辑。skill 要求 VERIFIED 同批刷新 task result.md/progress.md。telemetry Codex 实战 plane 现通过 validateControlPlane。
  • 评估：Codex 实战 dispatch docs/evaluations/2026-07-31-telemetry-image-codex-dispatch.md（候选已 promote）。
  • C4–C6 加深：dispatchAttestation.mjs（含 review 的 attestation 路径/写文件）；schema 可选 integrity_grade / remote_closeout / closeout；skill 硬门禁 C 段改为文件 ref；用户文档与 sample；合约测试。
  • 收尾 R4 + C4–C6 + closeDelivery：dispatchRollbackPrep.mjs；closeDelivery / setRemoteCloseout / setIntegrityGrade；plane-self-check；readme-pnpm ROLLED_BACK 关闭。
  • R-soft-reopen + G-menu：Mode S session 共享；prepareModeSReopen；reopenTarget 默认 prepareSoft；未 push 干净 tip Recommended=reset。
  • 任务回退（R1–R4）：Dispatch reopen/block + Ralph phase/status + rollback-prep；plane-self-check VERIFIED_REOPEN_SUGGESTED。默认不自动 unmerge/force-push。
  • 评估：DEL-readme-pnpm-install-20260731 Mode S 控制面闭环（plane-self-check OK）；docs/evaluations/2026-07-31-readme-pnpm-dispatch.md；Mode S exec plan live checkbox 勾选；acceptor-tag 保留 integrity FAIL 负例。
  • 升级 backlog：docs/exec-plans/active/2026-07-31-dispatch-upgrade-backlog.md — C4–C6 已完成；Mode W/P / Host Wave 2 仍后置。

0.1.1-beta.38 — 2026-07-30 19:30 ​

  • Grok dispatch Mode S（skill MVP）：默认单会话串行 + project-branch；缺多 session API 时降级 Mode S，禁止合成 session id；用户不执行 CLI。
  • 新增 skills/jj-dispatch/references/grok-dispatch-execution.md（PREFLIGHT / attestation / receipt / Mode S·W·P / 与 Workflow 边界）。
  • Agent 写 plane 硬门禁（C3）：无 produced_commit 最多 EVIDENCE_READY；scripts/plane-self-check.mjs + 合约测试。
  • 文档：docs/commands/jj-dispatch.md、usage、grok-host-adapter 脚注；exec plan docs/exec-plans/active/2026-07-30-grok-dispatch-execution.md；评估 docs/evaluations/2026-07-30-acceptor-tag-color-dispatch.md。

0.1.1-beta.37 — 2026-07-30 18:29 ​

  • 目录配置一等公民：naming.json 支持 dispatch.control_root / portfolio_root / knowledge_root 与 project_map；产品默认 control_root=~/.jj-flow。解析顺序：CLI --control-root/--manifest → env → naming.json → 默认。jj doctor 打印 paths；jj dispatch-tick --delivery / jj task scaffold --delivery 可省略 --manifest。
  • 修复 skill/docs 真源漂移：去掉「默认 /portfolio/dispatch-control / 独占 worktree 才能 DISPATCH」矛盾；dispatch-demo 改为业务仓发起。
  • CREATE_THREAD 动作尊重 intent.environment（隔离时可升级 exclusive-worktree）；host-trial 写绑定与 exclusive worktree 语义一致。
  • 文档：明确 jj-dispatch 支持 Grok（/jj-dispatch，host_id=grok-build / session）；命令总览补全多端平台列，删除「已移除（非活入口）」段落。
  • dispatch write workspace 默认改为 project-branch（与 same 一致：命名 feature 分支 + 项目主路径）；exclusive-worktree 仅在并发写 / 主仓脏 / 用户显式隔离时启用。host-action-contract + control-plane 校验与 skill 同步（EP-20260730 worktree transfer 负例）。
  • dispatch 分支/workspace 不确定时先问再派：PREVIEW 输出判断表；NEEDS_CONFIRM 时禁止 DISPATCH / create_thread / 写 intent，用户确认后以用户改判为准。
  • dispatch 状态默认 ~/.jj-flow：产品默认用户主目录；/portfolio 仅为可选本机 portfolio（map/业务仓布局），须用 naming.json 才能把 control_root 指到 /portfolio/dispatch-control。

0.1.1-beta.36 — 2026-07-30 17:26 ​

  • 文档站全局顶栏：快捷入口改为「安装 / 使用 / Changelog / GitHub」；移除 same / dispatch 快捷标签。
  • 新增站内 changelog.html（由根目录 CHANGELOG.md 生成）；GitHub 外链 https://github.com/beerui/jj-flow。

0.1.1-beta.35 — 2026-07-30 17:11 ​

  • $jj-same：开干前强制 branch purpose preflight（任务用途 vs 当前分支用途）；新增 references/branch-purpose-preflight.md 与 EP-20260730-S1 五题 golden（错误 train 分支、恢复、staging tip 树判定）。
  • $jj-end：记录 branch_purpose；明显落错 feature/发布线时停并报告，避免错线 merge 进 integration。
  • jj-evaluated：记录 docs/evaluations/2026-07-30-grok-episodes.md（今日 Grok episode 标签、split、candidate v5 晋升状态）。
  • docs/commands/jj-same.md：执行过程补充分支用途 preflight。
  • chore：清理本地 scratch；保留 docs/other/dispatch-demo/make_frames.py；gitignore 生成媒体与一次性脚本。

0.1.1-beta.34 — 2026-07-30 16:34 ​

  • Fix npm package homepage: publish workflow now aligns latest dist-tag (npmjs.com defaults to latest, which was stuck on Maestro-era 0.1.1-beta.0).
  • $jj-review / /jj-review 改为宿主内置 review 优先的适配器：发现并调用当前宿主 review/code-review，将结论映射为 reviews/REV-*.json（source/host_review 溯源）；仅在宿主不可用时最小内联回退。
  • jj ralph review-record / ralph_ops review-record 支持 --source 与 --host-review-json，progress 写入 source=；校验可选 provenance 枚举。
  • $jj-end：强制 fetch → 同步 work → push → 同步 integration → merge → push → 回切；提交前/推送前必须拉远端；禁止中途只 commit 不 merge；integration 回退链 dev→develop→main；冲突 abort 后回 work 并明确失败。
  • Skill 多端统一：新增 skill-inventory.json + src/skillInventory.mjs；harness 对账磁盘 skill ↔ 清单 ↔ Claude commands；补 .claude/commands/jj-end.md；安装文档写明 SSOT（skills）与 reinstall 纪律。

0.1.1-beta.33 — 2026-07-29 17:52 ​

  • Remove residual Maestro product framing: rename ADR 0001 to external-tool-boundary; scrub reviewer agent wording; docs site paths no longer reference Maestro.
  • Ralph v2: review_scope (working_tree|commit) + fix_commit; ARCHIVE requires commit-scoped PASS review when a review exists.
  • Ralph v4: accept/archive require gates.deliver=PASS/N/A; block deliver-outside-ledger when progress/diff shows deliver while deliver gate pending.
  • Ralph host metadata: optional run.host (host_id/thread_id/model_id/export_path); jj ralph host-record + init flags for session binding/evaluation (not a checkpoint).
  • Contract tests covering v2/v4/host; phases.md and ralph-run schema updated.

0.1.1-beta.32 — 2026-07-29 17:13 ​

  • Ralph accept/archive product-consistency gate: block PASS when latest review is NEEDS_CHANGES/BLOCKED or plan/acceptance path set drifts from actual diff (EP-04 false-complete class).
  • Contract tests for ledger path extraction and accept/archive gate refusal.
  • jj-same multi-env collect-port-evidence (Node primary + sh/ps1 wrappers) and tests.
  • jj-evaluated: record 2026-07-29 Grok episodes baseline under docs/evaluations; exclude that tree from docs-site orphan GC.
  • Refresh source-evidence-map paths to /portfolio role mapping.

0.1.1-beta.31 — 2026-07-27 21:41 ​

  • Ralph 硬接线 Portfolio KB: init auto-writes knowledge_refs / knowledge_summary (--no-knowledge-refs / --project / --knowledge-query).
  • Add src/portfolioKnowledge.mjs to read /portfolio/knowledge indexes into run/analyze/status.
  • Skill portable lib syncs portfolioKnowledge.mjs; ralph:sync/check covers 3 files.
  • knowledge loop package emits knowledge_refs + portfolio_knowledge.
  • schema/sample/skill skeleton + contract tests cover knowledge fields.
  • design-docs index links external portfolio KB at /portfolio/knowledge.

0.1.1-beta.30 — 2026-07-27 18:00 ​

  • 精简 Ralph handoff：交接状态并入 run.handoff（ready/must/targets/source_head），accept/finalize 自动维护。
  • handoff 包改为 run 内薄镜像 .workflow/ralph/RALPH-*/handoff/handoff.json；停写外部 handoffs/csv-wave 大包为默认。
  • $jj-same 优先消费当前会话 Ralph handoff；用户只说「交接到 …」，不填路径参数。
  • 更新 schema/skill/布局与合约测试（ralph-handoff/1.1）。

0.1.1-beta.29 — 2026-07-27 16:24 ​

  • 统一全局命名配置：新增 src/namingConfig.mjs，支持读取 /portfolio/config/naming.json（schema_version: jj-flow/naming/1.0）。
  • jj-same 分支派生规则升级：以领头分支为模板，只替换项目 role；req_suffix / 开发者缩写不得擅自增减；role 从 /portfolio/map.md 解析。
  • jj-ralph 新建 run 强制 RALPH-{kebab}-{YYYYMMDD}，archive 目录强制 YYYY-MM-DD-{kebab}；portable lib 同步 namingConfig.mjs。
  • Grok Host Adapter Phase 1 契约扩展：host_ids / handle_kinds / host_profiles 进入 host-action-contract；control-plane intent 支持 handle_kind；validateHostBindAttestation fail-closed；新增 tests/grok-host-contract.test.mjs 与 harness attestation 反例。
  • 完成并归档 Phase 1 exec plan：docs/exec-plans/completed/2026-07-27-grok-host-adapter.md（契约扩展；不升 A2；Phase 2/3 另开）。
  • 新增 Grok Host Adapter 设计（Proposed）：Wave 2 可选第二宿主路径，与 Codex 并列；skill 安装不推进 A2。
  • 真实 Host 验收里程碑改为支持 Codex / Grok 双路径；补充 install-skill --platform grok 使用说明边界。

0.1.1-beta.28 — 2026-07-27 11:19 ​

  • 新增 Grok 平台安装支持：install-skill --platform grok 将 skills 安装到 ~/.grok/skills/（GROK_HOME 可覆盖）。
  • --platform all 现在同时安装 Codex、Claude Code、Qoder 和 Grok 四端资产；--project 支持 ./.grok/skills/。
  • 安装文档补充 Grok skill 发现优先级、AGENTS.md 自动加载与真实 Host 边界说明。
  • 新增 /jj-evaluated 设计文档与 skill：用真实 episode/trace 做离线评估与泛化学习（Proposed）。
  • Harness Wave 0/2 收口：fresh clone 验证通过；真实 Codex App Host 单列为 PENDING 里程碑；max_unattended_level 保持 A1。

0.1.1-beta.27 — 2026-07-24 13:36 ​

  • 新增 Qoder 平台安装支持：install-skill --platform qoder 将 skills 安装到 ~/.qoder/skills/。
  • --platform all 现在同时安装 Codex、Claude Code 和 Qoder 三端资产。
  • 项目级安装 --project 同步支持 ./.qoder/skills/ 目标。

0.1.1-beta.26 — 2026-07-23 18:51 ​

  • 新增 $jj-end 任务收尾 skill：提交、推送、合并到 dev/develop 并切回工作分支；$jj 路由接入收尾入口。
  • $jj-ralph 可移植机械步骤：skill 内同步实现与 finalize/gate/map-find，业务仓无需安装 jj-flow 包。
  • $jj-dispatch 对齐 runtime 门禁优先级与状态语义：capability 失败不改 plane，UNKNOWN 禁止同 key 重建。
  • $jj-review 收敛为直接写 reviews/REV-*.json 的只读审查；无 run 时 BLOCKED，PASS/NEEDS_CHANGES 强制 reviewed_commit。
  • 统一 skill agents/openai.yaml 展示名为 jj-*，补齐 $jj 路由 agent 元数据，并收紧 $jj-end 边界说明。

0.1.1-beta.25 — 2026-07-23 16:47 ​

  • 精简 $jj-ralph skill：Codex 直写产物、短路径约束、失败预算与 skeleton 模板。
  • Ralph 产物路径压扁为 .workflow/ralph/RALPH-*/，去掉 ralphs/ 中间层。
  • 新增 skill 内确定性脚本 scripts/ralph_ops.mjs（init/status/archive/map-merge/handoff/dispatch-snapshot）。
  • 同步 Claude 命令、文档、样例、合同测试与 `agents/openai.yaml。

0.1.1-beta.24 — 2026-07-23 13:56 ​

  • 新增 $jj-ralph / /jj-ralph 单仓全流程闭环：需求分析 → 计划实施 → 验收完成 → 归档，产物在 .workflow/ralph/ralphs/，能力地图 business-map.json。
  • 新增 jj ralph 机械 CLI：init、status、archive、map-merge、map-find、handoff、dispatch-snapshot、commit-prep、review-record。
  • 新增 $jj-review / /jj-review 单仓轻量审查：把审查结论与 task/review 会话关联到 ralph run 的 reviews/REV-*.json，不走 dispatch 控制面。
  • ralph 完成后可导出 .workflow/handoffs/ 供 jj-same 迁移，或导出 dispatch 推荐快照供 jj-dispatch 分发；迁移实现不在 ralph 目录内完成。
  • 增加 schema、样例、设计文档与合同测试：map-merge 后 map-find 可恢复历史能力与 run 路径；review-record 可关联任务/审查会话。

0.1.1-beta.23 — 2026-07-20 21:00 ​

  • 新增可复制的 TASK-ID：标准任务的 task.json 记录任务文档、控制面 manifest 和 delivery 绑定；新会话可只提供任务 ID 恢复任务内容与实时状态。
  • 新增 jj task assign、jj task status 和 jj task context，普通输出保持简洁，JSON 输出保留完整审计面。

0.1.1-beta.22 — 2026-07-20 11:12 ​

  • control plane 在 intake.status=REQUIRED 时 fail-closed，必须确认项目归属和目标集合后才能 PREVIEW / APPROVE。

0.1.1-beta.21 — 2026-07-20 11:07 ​

  • 在 jj --help 中公开标准任务 task scaffold 入口。

0.1.1-beta.20 — 2026-07-20 10:58 ​

  • 新增标准任务资产 scaffold：非 quick 任务生成 .workflow/tasks/<TASK-ID>/ 下的任务、计划、进度和结果 Markdown。
  • dispatch task plan、approval、intent 和 Codex App host action 自动携带结构化 distribution_prompt 与 initial_prompt。
  • 增加 control intake、handoff/dispatch/report/receipt 按任务 ID 分目录和源任务完成后的推荐分发规则。

0.1.1-beta.19 — 2026-07-18 16:54 ​

  • 修复 Windows core.autocrlf=true 的 fresh clone 中 Harness runner fingerprint 因 LF/CRLF 差异误判过期的问题；fingerprint 现在按规范化文本计算，并增加跨行尾回归测试。

0.1.1-beta.18 — 2026-07-18 16:42 ​

  • 新增 jj uninstall-skill，支持 Codex/Claude、project/target、dry-run 和 JSON 输出；通过安装 ownership manifest 与 SHA-256 摘要保护本地修改，并可安全清理 jj-validate 等 8 个历史入口。
  • 加固 Harness manifest、schema、机械检查与成熟度评分，补齐版本化 exec plan 和 98/A 基线，持续检测文档、资产、验收证据与仓库事实漂移。
  • 新增只读 Harness Gardener workflow，仅允许创建维护 issue，不授予代码写入或自动修复权限。

0.1.1-beta.17 — 2026-07-18 15:50 ​

  • 引入 repository-native Harness：ARCHITECTURE.md、harness-manifest.json、jj doctor 和机械边界检查，仓库事实不再依赖 .workflow 或本机 memory。
  • 新增确定性 scenario、trace/replay、jj-same handoff 契约，以及使用真实临时 Git/worktree、CAS、中断恢复和 Review 返工的半真实 Host trial。
  • 新增只读 harness:gc、100 分质量评分和版本化 H5 基线；P0/P1 阻断，P2/P3 仅形成维护候选，禁用自动修复。
  • 补齐 Harness Engineering 设计、ADR、H4/M7 与 H5 验收文档，并将全部门禁接入 npm run verify。

0.1.1-beta.16 — 2026-07-18 10:24 ​

  • 文档站：嵌套页相对路径修复、表格/粗体渲染、导航与样式可读性增强、首页 3 步路径；维护说明写清文档所有权；tests/docs-site.test.mjs 覆盖主路径与 docs:check。
  • dispatch 运行时：分析 receipt 先消费、目标独立 ADAPT/NO_CHANGE/BLOCKED 门禁、resume 调和 pending intent、CAS 写锁不误删他人 lock。

0.1.1-beta.15 — 2026-07-17 23:53 ​

  • 产品定位调整：jj-flow 定位为 项目族编排工作流（same / dispatch），同步 README、架构、规划、AGENTS、package 描述与文档站标语。
  • 一并发布尚未上架的 beta.14 能力：dispatch 可恢复 tick/CAS、目标独立差异门禁、M6 验收文档。

0.1.1-beta.14 — 2026-07-17 23:49 ​

  • 加固 $jj-dispatch 运行时：resume 重放 PENDING_THREAD 的 CREATE_THREAD actions；目标差异决策按项目独立门禁；receipt attempt 与 task_key/intent 绑定；persistPlaneCas 真 CAS 写回。
  • 移除 dispatch-tick --no-target-analysis；目标 ANL-TARGET 不可绕过。
  • 关闭 M6（P11/P12）：验收报告 docs/milestones/m6-acceptance.md；下一里程碑 M7 为真实控制项目试跑。

0.1.1-beta.13 — 2026-07-17 22:58 ​

  • Breaking：移除 jj-delivery / jj-validate / jj-evolve 原生命令、recipe 与文档入口。
  • 用户可见原生命令收敛为 jj-same（同源迁移/持续同步）与 jj-dispatch（多项目调度，Codex-only）；兼容入口 jj 默认路由到 same。
  • 控制平面 delivery_id 保留为调度任务身份，不再对应 $jj-delivery 对话入口。
  • 维护 jj-flow 自身改为直接改仓 + npm run verify；删除 projectEvolution 与相关测试。
  • 同步更新 Codex skills、Claude commands、CLI help、文档站导航与回归测试。

0.1.1-beta.12 — 2026-07-17 22:15 ​

  • 移除 jj-feat / jj-fix / jj-knowhow / jj-auto / jj-review 原生命令与 recipe；明确功能、线上修复、交付前审查与不确定意图统一走 jj-delivery。
  • 知识沉淀与独立 review 入口不再提供；审查走 delivery 内 $quality-review，沉淀可按需调用 $manage-knowhow-capture。
  • 全部流程代码定位改用定点读取与搜索工具。
  • 同步更新 Codex skills、Claude commands、文档、安装校验与回归测试。

0.1.1-beta.11 — 2026-07-17 14:20 ​

  • 新增独立项目族控制平面，支持动态 origin_project、requirement_owner、lead_project 和多个目标项目的可恢复派发。
  • 新增只读 Reviewer 与可写 Developer 双角色闭环，支持结构化 findings、NEEDS_CHANGES 重工、递增 attempt 和 Review PASS 门禁。
  • 收紧 sandbox attestation、terminal writer、NO_CHANGE、checkpoint、结果防重放和 skipped dependency 等运行时与公开 Schema 约束。
  • 接入 openaiDeveloperDocs MCP，固定双角色使用 gpt-5.6-sol，并补充 AGENTS、安装、架构、命令与示例文档。

0.1.1-beta.10 — 2026-07-14 18:46 ​

  • 为 jj-same 增加可版本化 handoff snapshot，多个目标复用共享 ANL-SOURCE / BLP/REQ，避免重复读取完整源需求。
  • 增加 准备交接 / 交接 / 更新交接 标准调用流程、freshness 动作、execution_readiness 与 successor delta 契约。
  • 新增 handoff JSON Schema、Codex/Claude 安装资产、用户文档和回归测试。

0.1.1-beta.9 — 2026-07-14 09:09 ​

  • 首次安装或 --force 更新成功后，输出当前包版本对应的最新版本日志。
  • --json 安装结果增加 version 和 release_notes 字段。
  • 安装失败或 --dry-run 预览时不输出版本日志，并兼容 Release Please 的版本标题格式。

0.1.1-beta.8 — 2026-07-13 14:40 ​

  • 默认跳过代理侧编译、build、浏览器、E2E 和页面交互自测。
  • 仅当改动存在静态证据无法覆盖的运行时风险时，提示用户下一步执行最小手动测试清单。
  • 不需要运行时验收时记录 N/A 并继续；需要时使用 READY_FOR_USER_TEST 等待用户确认。

0.1.1-beta.7 — 2026-07-13 14:13 ​

  • 从 jj-same 的 Codex、Claude 和项目族规则中彻底移除 grill 问答流程。
  • 信息不足时仅使用本地证据和可回退的最窄假设；无法安全推断时直接标记 BLOCKED。
  • 增加安装资产回归测试，防止 grill 命令重新进入发布包。

0.1.1-beta.6 — 2026-07-13 13:37 ​

  • 将 grill-me 收紧为阻塞交付时的最后兜底，不再作为常规分析步骤。
  • 信息不足时优先检查需求、会话、Git、文档和源码，再采用不扩大范围且可回退的最窄默认值。
  • 只有缺失信息会改变 MUST、验收、目标项目集合或不可逆实现时才询问，并且一次只确认当前阻塞决策。

0.1.1-beta.5 — 2026-07-13 11:32 ​

  • 让 jj-same 从领头项目分析阶段进入，并持续维护跨项目家族交付计划。
  • 项目A领头时默认按 pa -> pb -> pc 串行推进，前置项目验证和评审通过且用户主动触发后才进入下一项目。
  • 规范后续项目从本地 master 创建派生分支，只替换项目角色前缀并保留日期和任务序号。
  • 增加跨会话交接、目标项目独立差异分析、Codex/Claude 入口和安装资产回归测试。

0.1.1-beta.4 — 2026-07-11 12:37 ​

  • 将 jj-same 扩展为可持续同步协议，按最近成功检查点分析 A 项目的需求更新、bug 修复、回退和有效增量。
  • 增加修改完成后的项目、分支和候选目标确认门禁，由用户逐项目决定立即同步、延期、不适用或暂停关系。
  • 使用目标项目 目标项目 open issue 跟踪延期同步，恢复时从最近成功检查点重新计算累计范围。
  • 为 jj-delivery、jj-feat 和 jj-fix 增加 post-change discovery，并补充 Codex、Claude、文档与安装回归测试。

0.1.1-beta.3 — 2026-07-10 14:45 ​

  • 将 jj-same 固化为源证据总结、正式需求、目标项目评审、实施计划和实现复审的顺序门禁。
  • 按 canonical artifact 规范保存并注册 ANL-*、BLP-*、PLN-*、EXC-*、VRF-* 和 REV-*，禁止创建私有迁移文档目录。
  • 增加 产物路由参考、安装资产检查和回归测试。

0.1.1-beta.2 — 2026-07-10 10:52 ​

  • 增加 jj-same Codex skill 与 Claude slash command，用于基于会话、需求、分支、commit 或 diff 在同源分叉项目之间迁移功能、修复和需求变更。
  • 增加跨项目迁移的项目族参考、沉默账户真实案例和只读证据采集脚本。

0.1.1-beta.1 — 2026-07-06 14:17 ​

  • 调整安装资产结构，发布包内同时提供 Codex skills 与 Claude slash commands。
  • 增加 jj install-skill --platform codex|claude|all，支持用户级和项目级安装。
  • 更新文档站内容，突出真实入口、安装方式和维护边界。

0.1.1-beta.0 — 2026-07-04 17:47 ​

  • 增加 npm beta 发布准备：版本号、npx 安装入口和 GitHub Actions 发布流程。
  • 增加 jj install-skill --project，支持安装到当前项目的 ./skills/jj。
  • 更新安装文档：默认用户级安装，可选项目级安装。

0.1.0 ​

  • 初始化独立 jj-flow 项目。
  • 增加 /jj 薄入口的 CLI、recipe、guard、evidence schema。
  • 增加 Codex skill 草案、GitHub CI、Release Please、Dependabot。