Graph Engineering v0.3.3

Graph Engineering v0.3.3

Graph Engineering v0.3.3 与 @tutar/graph-engineering@0.3.3 提供独立 Workflow 版本升级入口，保留项目自有修改，并修复 Coding Action 流式日志的行分帧与安全模式增量去重。基于 PR #106。历史包与 Release 不回写。

Upgrade

已安装 0.3.1 的项目可以使用新版 CLI 升级到指定的已发布 0.3.2：

npx --yes @tutar/graph-engineering@0.3.3 upgrade --to 0.3.2
npx --yes @tutar/graph-engineering@0.3.3 upgrade --to 0.3.2 --apply
npx --yes @tutar/graph-engineering@0.3.2 check

CLI 版本与目标项目安装版本独立；省略 --to 时目标为 0.3.3。默认只读显示路径计划、包来源与 diff，显式 --apply 才写入。--project 选择项目；--from-package 与 --to-package 支持可信原始 npm 包的离线升级。新版 CLI 的 init 仍只负责首次安装，migrate 仍只负责旧 Loop Engineering 来源迁移。

三方合并保留 runner、触发条件、Prompt 等可合并修改。冲突或无法核对旧安装来源时整套停止，不写冲突标记；应用前复核现场，可捕获写入失败恢复原文件与记录，整套文件成功后才写目标模板来源。不保证断电/强制终止恢复或多文件事务原子性。完整接口与离线步骤见 CLI 文档。

Install

npx --yes @tutar/graph-engineering@0.3.3 init --dry-run
npx --yes @tutar/graph-engineering@0.3.3 init
npx --yes @tutar/graph-engineering@0.3.3 check

Verification boundary

CLI 与 Workflow 完整回归串行运行 120/120 通过。打包的 0.3.3 CLI 使用真实已发布 0.3.1/0.3.2 包完成在线与离线预览、应用，核对新增 Development 本地 Action、Coding Skill 桥接文件、保留的项目修改及目标来源记录。另验证默认升级到打包 CLI 的 0.3.3 目标。同版本、来源拒绝、冲突整套阻断、四阶段失败恢复和连续升级均有回归覆盖。逐项验收、命令与包校验值保存在 Issue #105。

文件升级与静态 check 不证明 runner 认证、隔离或真实 Workflow 任务执行。

Graph Engineering v0.3.2

Graph Engineering v0.3.2

Graph Engineering v0.3.2 与 @tutar/graph-engineering@0.3.2 交付更新后的 Coding 和 Development Workflow，以及整套 Workflow 安装 CLI。GitHub Release 的 .tgz 附件与 npm 包具有相同的包校验值。基于 PR #104。

Highlights

• Coding Task 的 Work Goal 显式引用 $skill-name 时，Action 在创建 Goal 前从当前 Skill catalog 解析 enabled Skill，要求 Agent 读取并遵循它。缺失、disabled、同名歧义或 catalog 不一致时停止；这仍是兼容桥接，不宣称 Codex 原生 structured Skill invocation。
• Coding Goal Action 仅要求稳定 Codex CLI 不低于 0.153.4，复用 runner 上已安装的兼容版本；无兼容版本时按最低版本安装。
• Development Workflow 改用本仓库维护的本地 Action；其 Task Invocation 与 Session 恢复 bundle 保持原固定提交内容，运行时选择改为复用符合最低版本的 runner CLI。持久 task state 保存在 checkout 外。
• Goal 终止与最终 Turn 持久化之间的竞态已修复，避免漏掉最终 Agent 消息。

Install

在目标 Git 仓库根目录执行：

npx --yes @tutar/graph-engineering@0.3.2 init --dry-run
npx --yes @tutar/graph-engineering@0.3.2 init
npx --yes @tutar/graph-engineering@0.3.2 check

已安装的整套 Workflow 由项目所有；init 不覆盖现有文件。更新前请先检查本地修改，并按 CLI 文档处理目标冲突。check 的静态文件匹配不证明 runner、认证或实际任务执行已经验收。

Verification boundary

Workflow 测试 70/70、CLI 测试 13/13、Development Action Task Invocation 集成测试 27/27。隔离的真实 Codex CLI 0.156.1 场景验证了 Coding Skill 桥接，以及 Development Action 对已安装新版 CLI 的复用和一次真实执行。原始“升级后 Workflow 报错”的失败步骤、错误及当时版本没有日志可核对；这些验证不能反推原故障根因。详见 Issue #102 与 Issue #103。

Graph Engineering v0.3.1

Graph Engineering v0.3.1

Graph Engineering v0.3.1 与 @tutar/graph-engineering@0.3.1 共同交付项目自有的 Workflow 集合和安装 CLI。

Highlights

• CLI 改为一次安装并检查整套 Workflow；init/check development 旧任务选择接口不再接受。
• PR Review Task 退出当前源码、测试、打包与安装支持；已有 Consumer 文件保持项目所有，不会被自动删除或接管。
• migrate 可预览并迁移来源可确认且未修改的旧 Development 安装；遇到未知来源、本地修改、目标冲突、新旧安装并存或旧 PR Review 时停止。
• Coding Task 使用项目自有的 Codex Goal Action，通过 App Server 执行原生 Work Goal，并在 blocked 或 budgetLimited 后最多执行一次固定预算的 Handoff Goal。
• Runtime Token Budget 采用累计上限，Handoff 获得 100,000 token，Coding Task 总上限为 500,000 token。
• Coding Task 支持经过脱敏的近实时日志，并避免重复渲染已完成的 Agent 消息。

Install

在目标 Git 仓库根目录执行：

npx --yes @tutar/graph-engineering@0.3.1 init --dry-run
npx --yes @tutar/graph-engineering@0.3.1 init
npx --yes @tutar/graph-engineering@0.3.1 check

CLI 不注册 runner、不登录 Codex、不安装 Skill、不提交文件，也不修改 GitHub Settings。check 的文件匹配不证明 runner、认证或真实任务执行已经验收。

Migration

先预览可识别的旧 Development 安装：

npx --yes @tutar/graph-engineering@0.3.1 migrate

交互确认后才会修改；非交互环境必须显式传入 --apply。旧 PR Review 安装需要人工决定如何处理。

Graph Engineering v0.3.0

Graph Engineering v0.3.0 completes the product and Consumer protocol rename from Loop Engineering and introduces the first public installer CLI.

Install

npx --yes @tutar/graph-engineering@0.3.0 init pr-review
npx --yes @tutar/graph-engineering@0.3.0 check pr-review

Development Task uses init development. Existing recognized pre-v0.3 installations can review a migration with migrate and apply it explicitly with migrate --apply in non-interactive environments.

Boundaries

• The CLI installs project-owned ordinary files and never commits, pushes, registers runners, logs in to Codex, installs Skills, or changes GitHub Settings.
• Current Workflow Tasks remain outside a Stable Definition claim. Historical failed Consumer Evidence remains failed and is not inherited by this release.
• Historical tags, Releases, Evidence, and Consumer identities retain their original loop-engineering facts.

Verification

• 83 Node tests passed across delivery contracts, Development, PR Review, and CLI behavior.
• Public npm registry smoke tests passed for exact-version init, check --json, and migrate --apply.
• Published npm tarball: 48 files, SHA-1 e54c1580e13c570f494fc3e0109f482df8acba67, source commit 049fdb6a98ab9867572637a5728f91f4683124ce.
• npm dist-tags next and latest both resolve to 0.3.0.

Closes #57.

Loop Engineering v0.2.5 — current-layout PR Review Candidate

Current-layout PR Review Candidate

• Source commit: 927bd96156f750546019581b653b7601db9c71c8.
• Repository Release: v0.2.5.
• Workflow Definition delivery identity: github-pr-review/v0.1.5.
• Installation path: workflow-tasks/pr-review/files/.github/.
• Runtime source identities: github-pr-review/current and github-pr-review/codex/current; exact immutable assets are bound by this tag and the delivery manifest, not a versioned source directory.
• Action: tutar/codex-action@f33581290086e62dc34d420a7f1862477fc2b503; CLI: 0.153.4.

Includes complete Check history pagination, duplicate/malformed-history fail-closed, head freshness recheck and publication audit. PR Review and Development remain independently owned tasks and workflows.

Candidate only: local checks do not prove Consumer acceptance or Stable support. Bundle 7 must use a new Consumer PR and a new frozen combination; historical FAIL/partial Bundles are not inherited. Published older tags and release contents are unchanged. Consumer validation remains private and requires repository access to audit its run artifacts.

Loop Engineering v0.2.4 — strict review output Candidate

Loop Engineering v0.2.4

Published Candidate snapshot: PR #45 merge d41b988c5e93e2bb51a33b47d1f98a080af41edb. Bundle 6 is NOT_FROZEN / NOT_RUN; this Release is not Stable or Consumer validation evidence.

• Repository Release: v0.2.4
• Workflow Definition: github-pr-review/v0.1.4
• Definition status: Candidate
• Stable status: no Stable Supported Profile

Repository Release 与 Workflow Definition 分别版本化。v0.2.4 发布 github-pr-review/v0.1.4 纠正版；它不改写 Repository Release v0.2.0–v0.2.2、Workflow Definition github-pr-review/v0.1.0–v0.1.2 或旧 Consumer Evidence Bundle。v0.1.1 与 v0.1.2 的真实 Consumer 验证结论均为 FAIL。

Included

• 与 v0.1.0–v0.1.2 并存、可整体复制并由 Consumer Project 自有的完整 github-pr-review/v0.1.4 文件集合。
• 同时保留已发布 v0.1.3；Bundle 5 的真实 schema 拒绝记录见 结果。
• 去除 Action 输出 schema 的 oneOf / not，所有字段必填；Standards、Spec 和 handoff 使用显式可空类型。可信 capture 强制两轴完成与 handoff 互斥，并移除 handoff=null 后才形成发布 artifact。
• Manual dispatch 使用只读 GitHub token 读取当前 PR facts，并与自动事件一致排除 Draft、closed 或不可读取的目标。
• 只传 Action 支持的 legacy safety-strategy: read-only，不再与 permission-profile 组合。
• review job 冻结到 [self-hosted, Linux, X64, codex]，route 与 trusted publish jobs 继续独立运行。
• 维护版 tutar/codex-action 锁定到 commit f33581290086e62dc34d420a7f1862477fc2b503，上游基线锁定为 openai/codex-action@86365089eb2b84e0a8fb0717b304f8bdcb13b20e，并显式固定 codex-version: 0.153.4。
• Runner-backed Codex Authentication：不传 repository OPENAI_API_KEY，由 Action 使用 runner 默认 Codex home 中的既有登录状态；Workflow 不直接调用 runner CLI。
• 保留 write-access gate、same-repository PR、Read-only Effect Mode、结构化 Standards/Spec 双轴结果、可信 Check publisher、SHA freshness、幂等与 fail-closed 边界。

Evidence boundary

Candidate Publication Gate 提供 local static and automated contract evidence（本地静态与自动化契约证据），包括维护版 Action 的认证回归、人工 Draft 路由的 fake GitHub API 测试与精确 Action 输入断言；它仍不证明真实 runner、登录状态、网络或 Consumer Project 兼容。公开 Consumer Project 必须以该冻结组合完整执行相关 Cases，并产生独立 Evidence Bundle；不得拼接失败的 v0.1.1 或 v0.1.2 结果。

forks、共享 runner、无 write 权限 actor、其他 runner labels、API-key 路径、直接 CLI 与动态 Provider 标记为 Not Yet Verified 或不属于该 Definition。Stable Promotion 与安全失败路径仍由后续 ticket 负责。

Loop Engineering v0.2.3

Loop Engineering v0.2.3

• Repository Release: v0.2.3
• Workflow Definition: github-pr-review/v0.1.3
• Definition status: Candidate
• Stable status: no Stable Supported Profile

Repository Release 与 Workflow Definition 分别版本化。v0.2.3 发布 github-pr-review/v0.1.3 纠正版；它不改写 Repository Release v0.2.0–v0.2.2、Workflow Definition github-pr-review/v0.1.0–v0.1.2 或旧 Consumer Evidence Bundle。v0.1.1 与 v0.1.2 的真实 Consumer 验证结论均为 FAIL。

Included

• 与 v0.1.0–v0.1.2 并存、可整体复制并由 Consumer Project 自有的完整 github-pr-review/v0.1.3 文件集合。
• Manual dispatch 使用只读 GitHub token 读取当前 PR facts，并与自动事件一致排除 Draft、closed 或不可读取的目标。
• 只传 Action 支持的 legacy safety-strategy: read-only，不再与 permission-profile 组合。
• review job 冻结到 [self-hosted, Linux, X64, codex]，route 与 trusted publish jobs 继续独立运行。
• 维护版 tutar/codex-action 锁定到 commit f33581290086e62dc34d420a7f1862477fc2b503，上游基线锁定为 openai/codex-action@86365089eb2b84e0a8fb0717b304f8bdcb13b20e，并显式固定 codex-version: 0.153.4。
• Runner-backed Codex Authentication：不传 repository OPENAI_API_KEY，由 Action 使用 runner 默认 Codex home 中的既有登录状态；Workflow 不直接调用 runner CLI。
• 保留 write-access gate、same-repository PR、Read-only Effect Mode、结构化 Standards/Spec 双轴结果、可信 Check publisher、SHA freshness、幂等与 fail-closed 边界。

Evidence boundary

Candidate Publication Gate 提供 local static and automated contract evidence（本地静态与自动化契约证据），包括维护版 Action 的认证回归、人工 Draft 路由的 fake GitHub API 测试与精确 Action 输入断言；它仍不证明真实 runner、登录状态、网络或 Consumer Project 兼容。公开 Consumer Project 必须以该冻结组合完整执行相关 Cases，并产生独立 Evidence Bundle；不得拼接失败的 v0.1.1 或 v0.1.2 结果。

forks、共享 runner、无 write 权限 actor、其他 runner labels、API-key 路径、直接 CLI 与动态 Provider 标记为 Not Yet Verified 或不属于该 Definition。Stable Promotion 与安全失败路径仍由后续 ticket 负责。

Loop Engineering v0.2.2

Loop Engineering v0.2.2

• Repository Release: v0.2.2
• Workflow Definition: github-pr-review/v0.1.2
• Definition status: Candidate
• Stable status: no Stable Supported Profile

Repository Release 与 Workflow Definition 分别版本化。v0.2.2 发布 github-pr-review/v0.1.2 纠正版；它不改写 Repository Release v0.2.0 / v0.2.1、Workflow Definition github-pr-review/v0.1.0 / v0.1.1 或旧 Consumer Evidence Bundle。v0.1.1 的真实 Consumer 验证结论为 FAIL。

Included

• 与 v0.1.0、v0.1.1 并存、可整体复制并由 Consumer Project 自有的完整 github-pr-review/v0.1.2 文件集合。
• review job 冻结到 [self-hosted, Linux, X64, codex]，route 与 trusted publish jobs 继续独立运行。
• 维护版 tutar/codex-action 锁定到 commit f33581290086e62dc34d420a7f1862477fc2b503，上游基线锁定为 openai/codex-action@86365089eb2b84e0a8fb0717b304f8bdcb13b20e，并显式固定 codex-version: 0.153.4。
• Runner-backed Codex Authentication：不传 repository OPENAI_API_KEY，由 Action 使用 runner 默认 Codex home 中的既有登录状态；Workflow 不直接调用 runner CLI。
• 保留 write-access gate、same-repository PR、Read-only Effect Mode、结构化 Standards/Spec 双轴结果、可信 Check publisher、SHA freshness、幂等与 fail-closed 边界。

Evidence boundary

Candidate Publication Gate 提供 local static and automated contract evidence（本地静态与自动化契约证据），包括维护版 Action 对无 key/API-key 两条 server-info 控制流的回归测试；它仍不证明真实 runner、登录状态、网络或 Consumer Project 兼容。公开 Consumer Project 必须以该冻结组合完整执行相关 Cases，并产生独立 Evidence Bundle；不得拼接 v0.1.0 或失败的 v0.1.1 结果。

forks、共享 runner、无 write 权限 actor、其他 runner labels、API-key 路径、直接 CLI 与动态 Provider 标记为 Not Yet Verified 或不属于该 Definition。Stable Promotion 与安全失败路径仍由后续 ticket 负责。

Loop Engineering v0.2.1 — Runner-backed github-pr-review Candidate

Loop Engineering v0.2.1

• Repository Release: v0.2.1
• Workflow Definition: github-pr-review/v0.1.1
• Definition status: Candidate
• Stable status: no Stable Supported Profile

Repository Release 与 Workflow Definition 分别版本化。v0.2.1 发布 github-pr-review/v0.1.1 修正版；它不改写 Repository Release v0.2.0、Workflow Definition github-pr-review/v0.1.0、PR #38 或旧 Consumer Evidence Bundle。

Included

• 与 v0.1.0 并存、可整体复制并由 Consumer Project 自有的完整 github-pr-review/v0.1.1 文件集合。
• review job 冻结到 [self-hosted, Linux, X64, codex]，route 与 trusted publish jobs 继续独立运行。
• openai/codex-action 锁定到 commit 86365089eb2b84e0a8fb0717b304f8bdcb13b20e，并显式固定 codex-version: 0.153.4。
• Runner-backed Codex Authentication：不传 repository OPENAI_API_KEY，由 Action 使用 runner 默认 Codex home 中的既有登录状态；Workflow 不直接调用 runner CLI。
• 保留 write-access gate、same-repository PR、Read-only Effect Mode、结构化 Standards/Spec 双轴结果、可信 Check publisher、SHA freshness、幂等与 fail-closed 边界。

Evidence boundary

Candidate Publication Gate 提供 local static and automated contract evidence（本地静态与自动化契约证据），不证明真实 runner、登录状态、网络或 Consumer Project 兼容。新的公开 Consumer Project 必须以该冻结组合完整执行相关 Cases，并产生独立 Evidence Bundle；不得拼接 v0.1.0、PR #38 或废弃 Consumer Project 的结果。

forks、共享 runner、无 write 权限 actor、其他 runner labels、API-key 路径、直接 CLI 与动态 Provider 标记为 Not Yet Verified 或不属于该 Definition。Stable Promotion 与安全失败路径仍由后续 ticket 负责。

Loop Engineering v0.2.0 — github-pr-review Candidate

Loop Engineering v0.2.0

• Repository Release: v0.2.0
• Workflow Definition: github-pr-review/v0.1.0
• Definition status: Candidate
• Stable status: no Stable Supported Profile

Repository and Workflow Definition versions have independent lifecycles. v0.2.0 introduces the Workflow-first direction and publishes the first github-pr-review Candidate; it does not rename that Definition to v0.2.0 and does not promote it to Stable.

Included

• A complete project-owned PR Review file set: Workflow, Event Prompt configuration, Codex Compatible Executor, static Compatibility Profile, result schema and trusted Check publisher.
• Supported non-Draft PR lifecycle routing plus manual reruns, Fresh Goal Runs, per-PR serialization, SHA freshness and same-SHA Check idempotency.
• Read-only Agent boundaries, isolated trusted control scripts, explicit terminal mapping and fail-closed validation.
• A Candidate Publication Gate covering routing, prompt formation, mappings, permissions, validation, SHA freshness, idempotency and failure paths.

The gate evidence is static analysis and automated contract execution with a controlled Fake Action. It is not a real Consumer Project compatibility result, and Agent final text is not proof of publication or success. Real Consumer validation and a consistent Evidence Bundle remain required for Stable Promotion.

Coexistence and migration

github-pr-review/v0.1.0 and every github-development-ticket v0.1.x Definition can be installed side by side because they are separate products. The new Candidate does not consume or migrate Legacy Thread Records, labels, Controller state or Workflow Instances. There is no automatic migration.

The published github-development-ticket v0.1.0, v0.1.1 and v0.1.2 files, tags and validation history remain available as the previously validated Legacy Frozen line. That line remains usable but receives only serious security fixes and factual corrections; it gains no new workflow capabilities.

Upgrade boundary

The Candidate pins openai/codex-action source tag v1 to commit 86365089eb2b84e0a8fb0717b304f8bdcb13b20e. Changing the Action SHA, mapping, Executor or Profile creates a modified Workflow Instance outside this Candidate claim. An official upgrade requires a new Definition version and renewed validation.