dev-flow-codex 0.5.0 → 0.5.1

package/README.md

@@ -21,7 +21,7 @@ dev-flow-codex setup
 GitHub Release `v0.4.0` 与 registry 回读证据为准。
 
 当前公开支持 native macOS arm64、Node.js `>=24` 和 Codex
-`>=0.147.0 <0.148.0`。没有 Linux、Windows、Intel Mac、Rosetta 或 DeepSeek 产品支持声明。
+`>=0.147.0`。没有 Linux、Windows、Intel Mac、Rosetta 或 DeepSeek 产品支持声明。
 
 ## Closed package
 
@@ -87,17 +87,17 @@ does not select this Skill；wrong plugin namespace、wrong Skill base name 或
 This does not disable ordinary Codex repository tools. The package does not make or claim selector-bound MCP visibility or authorization。
 
 被接纳的请求必须只涉及一个现有 Git repository，并先调用 `dev_flow_server_info({})`。当前
-source-local Contract 0.2 handshake 必须返回：
+source-local current contract handshake 必须返回：
 
 ```text
-schema_version = 2
-core_limits_version = 0.2
-process = standard-development@1
+process = standard-development
+definition_digest = exact current process content
 method_profiles = plain, spec-kit, openspec
 exact six-tool catalog
 ```
 
-不完整、不同版本或不同顺序的 catalog 会停止请求。公开工具为：
+不完整或不同顺序的 catalog、schema、process digest 会停止请求。Core 产品版本从实际 bundled
+executable 读取，不要求与 Codex package version 相等。公开工具为：
 
 ```text
 dev_flow_server_info
@@ -142,10 +142,10 @@ Core 返回的五分类 Assessment 和 advice。Probe 零写入；只有显式 r
 Core-derived transition 或创建一次 blocker。Adapter 不判断 classification、retry safety、resume
 node 或 destination。
 
-## Schema 1 unsupported guidance
+## pre-graph data unsupported guidance
 
-Graph package 只支持 fresh Schema 2、snapshot-v2 和精确 `standard-development@1`。遇到 Schema
-1/pre-graph data 时 Core 返回 `SCHEMA_UNSUPPORTED`，且不 decode、migrate、rename、truncate、
+Graph package 只支持 current SQLite layout、strict current snapshot 和精确 `standard-development`。
+遇到 incompatible/pre-graph data 时 Core 返回 `SCHEMA_UNSUPPORTED`，且不 decode、migrate、rename、truncate、
 delete 或 reset 旧数据。不要重复启动或自动清理。
 
 用户必须明确选择一个新的绝对、canonical、usable `DEV_FLOW_DATA_DIR`，或在 Core 外部手工
@@ -158,7 +158,7 @@ archive/rename/delete 旧目录，再启动 graph Core。错误信息不回显
 
 setup/update/remove/uninstall 均保留 Core task data 和未知相邻文件，不会修改目标 repository 或
 Git。remove 应先证明 plugin/marketplace absence，再单独执行 package-manager uninstall。重新安装
-兼容的 graph artifact 可以从同一 Schema 2 数据目录恢复任务；没有任何 Schema 1 reader 或
+兼容的 graph artifact 可以从同一 current SQLite format 数据目录恢复任务；没有任何 pre-graph data reader 或
 conversion path。
 
 ## Closed node payload construction

package/bin/dev-flow-codex.mjs

@@ -58,9 +58,6 @@ export async function runCLI(arguments_, dependencies = {}) {
         environment,
         currentDirectory: paths.packageRoot,
       });
-      if (coreVersion !== packageVersion) {
-        throw new Error(`package version ${packageVersion} does not match Core version ${coreVersion}`);
-      }
       stdout.write(`dev-flow-codex ${packageVersion} (core ${coreVersion})\n`);
       return { code: 0, signal: null };
     }

package/lib/lifecycle.mjs

@@ -20,7 +20,7 @@ import { containedPath } from "./paths.mjs";
 
 const execFile = promisify(execFileCallback);
 
-export const CODEX_COMPATIBILITY_RANGE = ">=0.147.0 <0.148.0";
+export const CODEX_COMPATIBILITY_RANGE = ">=0.147.0";
 export const MARKETPLACE_NAME = "dev-flow-local";
 export const PLUGIN_NAME = "dev-flow-codex";
 export const PLUGIN_SELECTOR = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
@@ -293,9 +293,6 @@ async function preflightSetup({ paths, packageVersion, codexExecutable, environm
     environment,
     currentDirectory: paths.packageRoot,
   });
-  if (coreVersion !== packageVersion) {
-    throw new Error(`packaged Core version ${coreVersion} does not match package version ${packageVersion}`);
-  }
   const codexVersion = await inspectCodexVersion(codexExecutable, {
     environment,
     currentDirectory: paths.packageRoot,
@@ -473,7 +470,6 @@ function assertRegistrationAbsent(state, paths) {
 function assertRemovalReceipt(receipt, paths, packageVersion) {
   const matches =
     receipt.product.version === packageVersion &&
-    receipt.product.core_version === packageVersion &&
     receipt.registration.marketplace_name === MARKETPLACE_NAME &&
     receipt.registration.marketplace_root === paths.marketplaceRoot &&
     receipt.registration.plugin_name === PLUGIN_NAME &&
@@ -739,7 +735,6 @@ function createReceipt({
   installedAt,
 }) {
   return validateReceipt({
-    schema_version: 3,
     product: {
       name: PLUGIN_NAME,
       version: packageVersion,
@@ -822,29 +817,26 @@ async function readJSON(path, label) {
 }
 
 export function versionSatisfiesRange(version, range = CODEX_COMPATIBILITY_RANGE) {
-  const match = /^>=(\S+)\s+<(\S+)$/.exec(range);
+  const match = /^>=(\S+)$/.exec(range);
   if (!match) throw new Error(`unsupported compatibility range ${JSON.stringify(range)}`);
   const candidate = parseSemver(version, "Codex version");
   const minimum = parseSemver(match[1], "compatibility minimum");
-  const maximum = parseSemver(match[2], "compatibility maximum");
-  return compareSemver(candidate, minimum) >= 0 && compareSemver(candidate, maximum) < 0;
+  return compareSemver(candidate, minimum) >= 0;
 }
 
 export function validateReceipt(receipt, { compatibilityRange = CODEX_COMPATIBILITY_RANGE } = {}) {
   assertObject(receipt, "registration receipt");
   assertExactKeys(
     receipt,
-    ["schema_version", "product", "host", "registration", "paths", "resource_digests", "installed_at"],
+    ["product", "host", "registration", "paths", "resource_digests", "installed_at"],
     "registration receipt",
   );
-  if (receipt.schema_version !== 3) throw new Error("registration receipt schema_version must equal 3");
 
   assertObject(receipt.product, "product");
   assertExactKeys(receipt.product, ["name", "version", "core_version", "codex_compatibility"], "product");
   assertEqual(receipt.product.name, "dev-flow-codex", "product.name");
   parseSemver(receipt.product.version, "product.version");
   parseSemver(receipt.product.core_version, "product.core_version");
-  assertEqual(receipt.product.core_version, receipt.product.version, "product Core version");
   assertEqual(receipt.product.codex_compatibility, compatibilityRange, "product compatibility range");
 
   assertObject(receipt.host, "host");
@@ -1005,7 +997,6 @@ function assertCompatibleReceiptUpgrade(previousReceipt, currentReceipt) {
 
 function upgradeOwnershipProjection(receipt) {
   return {
-    schema_version: receipt.schema_version,
     product: {
       name: receipt.product.name,
       codex_compatibility: receipt.product.codex_compatibility,
@@ -1022,7 +1013,6 @@ function upgradeOwnershipProjection(receipt) {
 
 function ownershipProjection(receipt) {
   return {
-    schema_version: receipt.schema_version,
     product: receipt.product,
     host: receipt.host,
     registration: receipt.registration,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-flow-codex",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": false,
   "description": "Explicit-only Dev Flow integration for Codex CLI.",
   "license": "Apache-2.0",

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-flow-codex",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Explicit-only Dev Flow integration for Codex CLI.",
   "author": {
     "name": "Dev Flow"

package/plugin/skills/dev-flow/SKILL.md

@@ -5,7 +5,7 @@ description: "Explicit-only Dev Flow entry point for Codex. Use only when the cu
 
 # Dev Flow
 
-This Skill is the Contract 0.2 Codex adapter for the shared Dev Flow Core. Core owns task state,
+This Skill is the current Core contract Codex adapter for the shared Dev Flow Core. Core owns task state,
 current node, legal transitions, destinations, recovery, blockers, and terminal outcomes. The Skill
 admits one explicit request, presents a complete Core Action, renders method work, and forwards one
 closed result without keeping adapter state.
@@ -44,11 +44,10 @@ Only after admission passes, call `dev_flow_server_info({})`; it must be the fir
 call. Require one complete structured result proving:
 
 - product is exactly `dev-flow`, and Core version equals the packaged product version;
-- `schema_version` is exactly `2` and `core_limits_version` is exactly `0.2`;
 - transport is exactly `stdio`, health is exactly `ready`, and the supported host set contains
   `codex`;
-- `supported_processes` contains exactly one closed `standard-development@1` entry:
-  `process_id` is `standard-development`, `process_version` is `1`, `definition_digest` is present
+- `supported_processes` contains exactly one closed `standard-development` entry:
+  `process_id` is `standard-development` is `1`, `definition_digest` is present
   and canonical, and `new_task_supported` is exactly `true`;
 - `method_profiles` is exactly `plain`, `spec-kit`, `openspec` in that order;
 - the tool catalog contains exactly these six raw names, in this order:
@@ -116,7 +115,7 @@ or resumes a task. Report an ownership or contract conflict unchanged in meaning
 ## Governed action loop
 
 The inseparable Action fields are exactly `task_id`, `revision`, `action_id`, `action_kind`,
-`process_id`, `process_version`, `process_definition_digest`, `current_node`, `node_purpose`,
+`process_id`, `process_definition_digest`, `current_node`, `node_purpose`,
 `entry_conditions`, `completion_conditions`, `allowed_effects`, `required_evidence`,
 `method_profile`, `method_steps`, `available_transitions`, `payload_contract`, `guidance`,
 `repository_binding_digest`, and `issued_at`.
@@ -247,7 +246,6 @@ Map every mutation top-level field from the same fresh Action:
 - `fresh_action.action_id` -> top-level `action_id`;
 - `fresh_action.action_kind` -> top-level `action_kind`;
 - `fresh_action.process_id` -> top-level `process_id`;
-- `fresh_action.process_version` -> top-level `process_version`;
 - `fresh_action.process_definition_digest` -> top-level `process_definition_digest`;
 - `fresh_action.current_node` -> top-level `source_cursor`;
 - `fresh_action.repository_binding_digest` -> top-level `repository_binding_digest`;
@@ -262,7 +260,6 @@ apply_arguments = {
   "action_id": fresh_action.action_id,
   "action_kind": fresh_action.action_kind,
   "process_id": fresh_action.process_id,
-  "process_version": fresh_action.process_version,
   "process_definition_digest": fresh_action.process_definition_digest,
   "source_cursor": fresh_action.current_node,
   "repository_binding_digest": fresh_action.repository_binding_digest,
@@ -312,7 +309,7 @@ transport-failed instead of returning one complete structured result. Do not imm
 `dev_flow_apply_action` and do not infer the result from repository state or worktree contents.
 
 Before calling `dev_flow_apply_action`, retain the original `request_id`, `task_id`, `process_id`,
-`process_version`, `process_definition_digest`, `source_cursor`, `revision`, `action_id`,
+`process_definition_digest`, `source_cursor`, `revision`, `action_id`,
 `action_kind`, `repository_binding_digest`, and exact closed `payload` from the same fresh action and
 the same apply dispatch. Never derive or reconstruct them from an incomplete response or partial
 output.
@@ -324,7 +321,6 @@ When all required original identity values are retained, construct exactly this
 {
   "operation_id": "<original apply request_id>",
   "process_id": "standard-development",
-  "process_version": 1,
   "process_definition_digest": "<original process definition digest>",
   "source_cursor": "<original source cursor>",
   "expected_revision": 3,

package/plugin/skills/dev-flow/references/method-profiles.md

@@ -1,6 +1,6 @@
 # Codex Method Profile Rendering Reference
 
-This is the closed Codex Host-rendering reference for Core Contract 0.2 semantic method steps. Read
+This is the closed Codex Host-rendering reference for current Core contract semantic method steps. Read
 it only after Core returns a complete current Action. It explains how Codex may perform the work; it
 is not a process definition or a second task cursor.
 

package/plugin/skills/dev-flow/references/node-payloads.md

@@ -1,4 +1,4 @@
-# Core Contract 0.2 Node Payload Construction
+# current Core contract Node Payload Construction
 
 This reference helps the Codex Adapter construct the one closed payload branch returned by the
 current Core Action. It is not a process definition, transition table, cursor, or authority. The