devlyn-cli 4.3.25 → 4.3.27

package/native/codex/plugins/devlyn/skills/_shared/task-completion.md

@@ -106,8 +106,10 @@ New allocation and warming modes come from enrollment state alone:
 | absent | present | verified `retired: true` | standalone (unenrollment complete) |
 | absent | present | absent, unreadable or incomplete | refuse; Open Devlyn to repair its storage registration |
 
-The journal `storage-client-unenroll.json` is read no-follow only on the last two
-rows. Schema 1, canonical UUIDv7 operation, permanent `storage-client-fence.json`,
+An unfinished retirement takes precedence over enrollment; follow its
+operation-specific retained-helper resume to reconcile or cancel as named.
+The journal `storage-client-unenroll.json` is read no-follow for retirement
+recovery and the last two rows. Schema 1, canonical UUIDv7 operation, permanent `storage-client-fence.json`,
 matching operation/root/lock identities and Rust's archive ordering/path
 validation are required. If native root/lock identities or the home path changed,
 completed retirement permits standalone only when `storage`, `control`,
@@ -119,7 +121,9 @@ completed unenrollment; a leftover managed key retains its own recovery command.
 Existing operations keep their managed identity. Receipts pin the control
 identity; current enrollment verifies the helper before allocation. Recovery uses
 the current verified `storage-client-recovery/pins.json`, including after uninstall
-or unenrollment, and requires its authority binding to match the receipt. Missing
+or unenrollment, and requires its authority binding to match the receipt, except
+for a proven moved task: use its unflagged, operation-specific `recover-storage`
+resume to release it, retain its files, and archive its receipt under `moved/`. Missing
 or invalid pins retain resources and require repair; saved artifacts are never a
 fallback. Enrolled checkout preserves
 `managed_pending`/`managed_owned` and Rust's `storage-allocation.json` subreceipt.

package/native/codex/plugins/devlyn/skills/devlyn-ideate/SKILL.md

@@ -3,7 +3,7 @@ name: devlyn-ideate
 description: Loop designer and intent queue. Turns an intent or a document into a validated loop package (a meta-prompt plus self-contained task contracts), queues its tasks, reports queue status, and drains the queue serially with evidence-derived acceptance, recovery and delivery. Operations — plan, add, status, drain; a bare intent is planned and, when the request authorizes implementation, continues through add and drain; no arguments shows status. Use when the user wants an idea, goal or document planned into tasks, wants to stack work ("queue this", "큐에 넣어줘"), asks what is queued, or wants unattended execution ("drain the queue", "큐 드레인 시작", "밤새 돌려줘").
 ---
 
-Ideate owns planning and durable serial execution. Each task runs under the installed methodology, the CLAUDE.md/AGENTS.md instruction block; ideate adds no phase graph, reviewer quota, engine router or restart cycle.
+Ideate owns planning and durable serial execution. Each task runs under the installed methodology, the Devlyn defaults and project instructions; ideate adds no phase graph, reviewer quota, engine router or restart cycle.
 
 <ideate_args>
 $ARGUMENTS
@@ -94,7 +94,7 @@ A removed flag stops with its instruction and selects no other behavior.
 
 An absolute path to a package's `meta.md` is added as it is; anything else is planned first. Add with `python3 "$DEVLYN_SKILL_DIR/scripts/queue.py" add '<absolute meta.md>'`, the only writer of a loop's queue file `docs/specs/<loop-id>/queue.md`; never edit one by hand. In every delivery mode add makes no commit on the checked-out branch and leaves the branch, the index and tracked files as they are: it holds the package and its rows at `refs/devlyn/captures/<loop-id>`, records the add and removes the package copies equal to that capture. Report the capture ref and its `git show` command, any `cleanup` entry, and that a revision needs a new loop id. A retry of the same add reports it as added, also once the copies are gone. Tasks start from committed state, a local loop from the branch it was added on and `auto`/`pr` from the remote base, so commit, and for `auto`/`pr` push, whatever the plan depends on. A pending legacy raw-intent row of `docs/specs/queue.md` is replaced in place by a package whose `## Intent` reproduces the row verbatim, added with `--materialize <line>`.
 
-Release-backed queues retain their verified release in `<git-common-dir>/devlyn-loops/harness.json` until all tasks, recovery and delivery settle. A different release refuses with the exact recovery argv; use it. Existing unfinished unbound queues and standalone installations remain legacy.
+Release-backed queues retain their verified release in `<git-common-dir>/devlyn-loops/harness.json` until all tasks, recovery and delivery settle. A different release refuses: use the exact recovery argv when it gives one; otherwise do what it says (Drain in Devlyn, the tasks to finish first, or a repair). Never build the bound queue's path yourself. Existing unfinished unbound queues and standalone installations remain legacy.
 
 ## status
 

package/native/codex/plugins/devlyn/skills/devlyn-ideate/references/loop.md

@@ -55,9 +55,9 @@ Package cleanup, parent pruning and report failures appear as diagnostics under
 
 ## Release binding and read-only consumers
 
-`<git-common-dir>/devlyn-loops/harness.json` is authoritative across linked worktrees: `{schemaVersion: 1, release: {package, version, digest, root}, defaults: {path, sha256}}`. Paths are absolute and hashes cover exact bytes. The queue lock covers binding before the first capture. An interrupted first add, unfinished tasks, recovery conflicts and pending delivery retain it; settlement removes it. A different release refuses with `recovery argv` as a JSON argv array, preserving the caller’s arguments. No caller substitutes another implementation.
+`<git-common-dir>/devlyn-loops/harness.json` is authoritative across linked worktrees: `{schemaVersion: 1, release: {package, version, digest, root}, defaults: {path, sha256}}`. Paths are absolute and hashes cover exact bytes. The queue lock covers binding before the first capture. An interrupted first add, unfinished tasks, recovery conflicts and pending delivery retain it; settlement removes it. A different release refuses: use the exact recovery argv when it gives one (a JSON argv array preserving the caller’s arguments); otherwise do what it says (Drain in Devlyn, the tasks to finish first, or a repair). Never build the bound queue’s path yourself. No caller substitutes another implementation.
 
-`queue.py inspect --repo <dir> --json` reads without cleanup, locks or writes. It returns the status summary plus `binding` (null for legacy) and `compatibility`: `compatible`, `legacy`, `reasons`, `recoveryArgv`, `taskPacket` ranges and `queueBinding` ranges. Incompatible or unreadable state is reported, never migrated. Apps should use this reader instead of `status`, which still reconciles cleanup. For a mismatch, `recoveryArgv` names the bound queue’s inspect invocation; use the same bound queue entry point for authorized add/drain operations.
+`queue.py inspect --repo <dir> --json` reads without cleanup, locks or writes. It returns the status summary plus `binding` (null for legacy) and `compatibility`: `compatible`, `legacy`, `reasons`, `recoveryArgv`, `taskPacket` ranges and `queueBinding` ranges. Incompatible or unreadable state is reported, never migrated. Apps should use this reader instead of `status`, which still reconciles cleanup. For a mismatch, `recoveryArgv` names the bound queue’s inspect invocation when handoff is allowed, and is null when the refusal names Drain in Devlyn, tasks to finish first, or a repair. Use an exact recovery argv when provided; otherwise follow the refusal.
 
 Codex projection writers place `.devlyn-harness-projection.json` at the copied plugin root, beside `skills` and `.codex-plugin`: `{schemaVersion: 1, release: <ReleaseRef>, source: "native/codex/plugins/devlyn"}`. The reader verifies the named release and every projected file’s bytes/mode against that subtree (excluding only the marker). Symlinked skill invocations resolve through their real path. Standalone installs and existing unfinished unbound queues retain legacy behavior; new legacy packets use v2 with a null release, and their `defaults` name the invoking installation's own `_shared/runtime-principles.md` (`source: "skill"`). No engine applicability is inferred from instruction filenames: bound queues use verified release defaults with native instructions taking precedence, except a Devlyn managed block, which the defaults replace. Worker and runner paths point to the bound release, independent of a projection cache’s lifetime.
 

package/native/codex/plugins/devlyn/skills/devlyn-ideate/scripts/queue.py

@@ -188,8 +188,11 @@ def enforce_binding(common, anchor=None):
         if binding and anchor is not None and release_settled_binding(anchor, common, interrupted_add=True):
             return enforce_binding(common)
         if binding:
-            argv = harness_call("recovery_argv", binding, sys.argv[1:])
-            raise LoopError(f"{exc}; recovery argv: {json.dumps(argv, ensure_ascii=False)}") from exc
+            line = shared("storage-client")["queue_handoff"](common, binding)
+            argv = harness_call("recovery_argv", binding, sys.argv[1:]) if line is None else None
+            error = LoopError(f"{exc}; {line}" if line is not None else f"{exc}; recovery argv: {json.dumps(argv, ensure_ascii=False)}")
+            error.handoff = line
+            raise error from exc
         raise
     return binding
 
@@ -1661,7 +1664,11 @@ def inspect(args):
         compatibility.update(compatible=False, reasons=[str(exc)])
         try:
             valid = harness_call("read_binding", common)
-            if valid:
+            if hasattr(exc, "handoff"):
+                line = exc.handoff
+            else:
+                line = shared("storage-client")["queue_handoff"](common, valid) if valid else None
+            if valid and line is None:
                 compatibility["recoveryArgv"] = harness_call("recovery_argv", valid, ["inspect", "--repo", str(anchor), "--json"])
         except (LoopError, OSError):
             pass  # The diagnostic above describes the malformed binding; no safe argv can be inferred.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devlyn-cli",
-  "version": "4.3.25",
-  "description": "Loop & harness engineering for AI coding agents (Claude Code, Codex, and any AGENTS.md-driven agent) — core engineering principles for CLAUDE.md/AGENTS.md and a loop designer that splits one intent into tasks agents drain hands-free",
+  "version": "4.3.27",
+  "description": "Loop & harness engineering for AI coding agents (Claude Code, Codex, and any AGENTS.md-driven agent) — core engineering principles for every session and a loop designer that splits one intent into tasks agents drain hands-free",
   "homepage": "https://github.com/fysoul17/devlyn-cli#readme",
   "bin": {
     "devlyn": "bin/devlyn.js"

package/release.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "devlyn-cli",
-  "version": "4.3.25",
+  "version": "4.3.27",
   "principles": {
     "defaults": "config/skills/_shared/runtime-principles.md",
     "memory": {
@@ -114,7 +114,7 @@
     },
     {
       "path": "README.md",
-      "sha256": "08bb882cc64cdaa3cab446a26c54847cb5c52992f838306163d0a90a764fffb5",
+      "sha256": "c4c554a6ae739264fc5f78fd1ba232d993e6ca18d54e3bfdbe87b7131ecedd92",
       "executable": false
     },
     {
@@ -129,7 +129,7 @@
     },
     {
       "path": "bin/devlyn.js",
-      "sha256": "f1450b804131b9f6b5d1ec61ce06da5e6ebd4f73d10e4c1bc01906b27cd136a9",
+      "sha256": "bcacbcf010cb7faee8323297d3f2542a8baa95de98c8dc99f122b78b8bb64b68",
       "executable": true
     },
     {
@@ -142,6 +142,16 @@
       "sha256": "b864c9e325e3e7bd6f800e51d456cb00d40925d6f0713a0c692cff207a9c6183",
       "executable": false
     },
+    {
+      "path": "bin/harness-context.js",
+      "sha256": "6b2e8d35592305c533bc0c3ee63a3655e1f51620a4baad977cb2f31f6b60d2c2",
+      "executable": false
+    },
+    {
+      "path": "bin/harness-run.js",
+      "sha256": "c4dcd1f7776834e9c5af2a497f900f6de01b2e5e817335e0de48714de4885e55",
+      "executable": false
+    },
     {
       "path": "bin/harness-status.js",
       "sha256": "7cc1bc83594952806142a7e3bda2430d21a583ae31a3b1800aa2811a645e0ad0",
@@ -154,7 +164,7 @@
     },
     {
       "path": "bin/instructions.js",
-      "sha256": "b47b8748f7138788f9f39d62feaf71ea0db7d91d67ee6fc911d5abeb99939b5b",
+      "sha256": "7f9c95fd5ec68b3c95c8cd0be0f3a65596a1ec5f4f264523622e304838c40a25",
       "executable": false
     },
     {
@@ -164,7 +174,7 @@
     },
     {
       "path": "bin/skill-history.json",
-      "sha256": "c137de72e6ca67b53800f1a5f777f44b00dcbdfa1e036ccf38174177f5fed69e",
+      "sha256": "aa8d19fc98e71dd420f23524faaba592b1e9a9341ec28ef7cf9115144bfc0d6c",
       "executable": false
     },
     {
@@ -249,22 +259,22 @@
     },
     {
       "path": "config/skills/_shared/storage-checkout.py",
-      "sha256": "4dbd004375972c09cb0e3d85719f9729ed0f0758c89b557a90aea150f288537e",
+      "sha256": "b12fb9f48c6e46b7544091bbd663cc9090389c92a16f32ac1ef8c51e0f90b77b",
       "executable": false
     },
     {
       "path": "config/skills/_shared/storage-client.py",
-      "sha256": "118aa6eea642ef3cfe7cfd901d51310efa13162425aae68048cbedf1907b3fa2",
+      "sha256": "b0e8d7cfd6b9d03a9e2988da4652e53310a8c3e3785160ed7c4c24e264c3223f",
       "executable": false
     },
     {
       "path": "config/skills/_shared/task-complete.py",
-      "sha256": "364dbaa28b0d01dcbdf7855be7af1d114094605ef343a579afb7d56aaabbb8e9",
+      "sha256": "8150cdb6a2d7bb7d493e3028cde6fb3b4ee6d85ff089ca30d8ffeab3327e91cb",
       "executable": false
     },
     {
       "path": "config/skills/_shared/task-completion.md",
-      "sha256": "c93128b4f16f7c21eccd5bed9afdb3d4beb8c756545dca1d7b1de45dd456e713",
+      "sha256": "ce0691632b113b78a7dd268b2d456c6ef25c6bad2a2c075cd950dd49dfaaec73",
       "executable": false
     },
     {
@@ -284,7 +294,7 @@
     },
     {
       "path": "config/skills/devlyn-ideate/SKILL.md",
-      "sha256": "2901fa7cb69d41fd3321d3846b742b3bc1a77c760eb49bd874c4c745b550553d",
+      "sha256": "529f7b13f52cd5a1b2e619b45a7004ed281ed5be440c867dc3171d79d40d9c2f",
       "executable": false
     },
     {
@@ -294,7 +304,7 @@
     },
     {
       "path": "config/skills/devlyn-ideate/references/loop.md",
-      "sha256": "8dd5ac20d9513e9c0b309a02170deec8642ae5945f1fb082ccc8b04fbc2422bc",
+      "sha256": "4af00f91159d889ec8ab7c853faf9db505a9f3aad9604f43bb666bb6e7873b77",
       "executable": false
     },
     {
@@ -314,7 +324,7 @@
     },
     {
       "path": "config/skills/devlyn-ideate/scripts/queue.py",
-      "sha256": "afd2f9fc8e5be73641cfa46a9de40c38b573dff6b22714d1457babe04f5c1b2f",
+      "sha256": "64de33eff3c47963a6e86159f086a780c613a8064d582e1d6d422d2d7060069e",
       "executable": false
     },
     {
@@ -334,7 +344,7 @@
     },
     {
       "path": "native/claude/.claude-plugin/plugin.json",
-      "sha256": "f2d0eb5a6bccfe88a6e5b8a5117f309f41f724d00acdeff4eac8a1b310ca907b",
+      "sha256": "3abd7843da04fefeabf131d5fcaff4fc8cde24c0889d5b2c19a6e14607bf0b53",
       "executable": false
     },
     {
@@ -414,22 +424,22 @@
     },
     {
       "path": "native/claude/skills/_shared/storage-checkout.py",
-      "sha256": "4dbd004375972c09cb0e3d85719f9729ed0f0758c89b557a90aea150f288537e",
+      "sha256": "b12fb9f48c6e46b7544091bbd663cc9090389c92a16f32ac1ef8c51e0f90b77b",
       "executable": false
     },
     {
       "path": "native/claude/skills/_shared/storage-client.py",
-      "sha256": "118aa6eea642ef3cfe7cfd901d51310efa13162425aae68048cbedf1907b3fa2",
+      "sha256": "b0e8d7cfd6b9d03a9e2988da4652e53310a8c3e3785160ed7c4c24e264c3223f",
       "executable": false
     },
     {
       "path": "native/claude/skills/_shared/task-complete.py",
-      "sha256": "364dbaa28b0d01dcbdf7855be7af1d114094605ef343a579afb7d56aaabbb8e9",
+      "sha256": "8150cdb6a2d7bb7d493e3028cde6fb3b4ee6d85ff089ca30d8ffeab3327e91cb",
       "executable": false
     },
     {
       "path": "native/claude/skills/_shared/task-completion.md",
-      "sha256": "c93128b4f16f7c21eccd5bed9afdb3d4beb8c756545dca1d7b1de45dd456e713",
+      "sha256": "ce0691632b113b78a7dd268b2d456c6ef25c6bad2a2c075cd950dd49dfaaec73",
       "executable": false
     },
     {
@@ -449,7 +459,7 @@
     },
     {
       "path": "native/claude/skills/devlyn-ideate/SKILL.md",
-      "sha256": "2901fa7cb69d41fd3321d3846b742b3bc1a77c760eb49bd874c4c745b550553d",
+      "sha256": "529f7b13f52cd5a1b2e619b45a7004ed281ed5be440c867dc3171d79d40d9c2f",
       "executable": false
     },
     {
@@ -459,7 +469,7 @@
     },
     {
       "path": "native/claude/skills/devlyn-ideate/references/loop.md",
-      "sha256": "8dd5ac20d9513e9c0b309a02170deec8642ae5945f1fb082ccc8b04fbc2422bc",
+      "sha256": "4af00f91159d889ec8ab7c853faf9db505a9f3aad9604f43bb666bb6e7873b77",
       "executable": false
     },
     {
@@ -479,17 +489,17 @@
     },
     {
       "path": "native/claude/skills/devlyn-ideate/scripts/queue.py",
-      "sha256": "afd2f9fc8e5be73641cfa46a9de40c38b573dff6b22714d1457babe04f5c1b2f",
+      "sha256": "64de33eff3c47963a6e86159f086a780c613a8064d582e1d6d422d2d7060069e",
       "executable": false
     },
     {
       "path": "native/codex/.agents/plugins/marketplace.json",
-      "sha256": "3fcaa2f62b36f4aab8475d2ab10910ba0d6a55045a152399d358e2abbf2f5934",
+      "sha256": "101d0836e62520fa6d6c1e6d6ce333d37720abdf1e16eaaa7e91f047bf04b5da",
       "executable": false
     },
     {
       "path": "native/codex/plugins/devlyn/.codex-plugin/plugin.json",
-      "sha256": "f2d0eb5a6bccfe88a6e5b8a5117f309f41f724d00acdeff4eac8a1b310ca907b",
+      "sha256": "3abd7843da04fefeabf131d5fcaff4fc8cde24c0889d5b2c19a6e14607bf0b53",
       "executable": false
     },
     {
@@ -569,22 +579,22 @@
     },
     {
       "path": "native/codex/plugins/devlyn/skills/_shared/storage-checkout.py",
-      "sha256": "4dbd004375972c09cb0e3d85719f9729ed0f0758c89b557a90aea150f288537e",
+      "sha256": "b12fb9f48c6e46b7544091bbd663cc9090389c92a16f32ac1ef8c51e0f90b77b",
       "executable": false
     },
     {
       "path": "native/codex/plugins/devlyn/skills/_shared/storage-client.py",
-      "sha256": "118aa6eea642ef3cfe7cfd901d51310efa13162425aae68048cbedf1907b3fa2",
+      "sha256": "b0e8d7cfd6b9d03a9e2988da4652e53310a8c3e3785160ed7c4c24e264c3223f",
       "executable": false
     },
     {
       "path": "native/codex/plugins/devlyn/skills/_shared/task-complete.py",
-      "sha256": "364dbaa28b0d01dcbdf7855be7af1d114094605ef343a579afb7d56aaabbb8e9",
+      "sha256": "8150cdb6a2d7bb7d493e3028cde6fb3b4ee6d85ff089ca30d8ffeab3327e91cb",
       "executable": false
     },
     {
       "path": "native/codex/plugins/devlyn/skills/_shared/task-completion.md",
-      "sha256": "c93128b4f16f7c21eccd5bed9afdb3d4beb8c756545dca1d7b1de45dd456e713",
+      "sha256": "ce0691632b113b78a7dd268b2d456c6ef25c6bad2a2c075cd950dd49dfaaec73",
       "executable": false
     },
     {
@@ -604,7 +614,7 @@
     },
     {
       "path": "native/codex/plugins/devlyn/skills/devlyn-ideate/SKILL.md",
-      "sha256": "2901fa7cb69d41fd3321d3846b742b3bc1a77c760eb49bd874c4c745b550553d",
+      "sha256": "529f7b13f52cd5a1b2e619b45a7004ed281ed5be440c867dc3171d79d40d9c2f",
       "executable": false
     },
     {
@@ -614,7 +624,7 @@
     },
     {
       "path": "native/codex/plugins/devlyn/skills/devlyn-ideate/references/loop.md",
-      "sha256": "8dd5ac20d9513e9c0b309a02170deec8642ae5945f1fb082ccc8b04fbc2422bc",
+      "sha256": "4af00f91159d889ec8ab7c853faf9db505a9f3aad9604f43bb666bb6e7873b77",
       "executable": false
     },
     {
@@ -634,7 +644,7 @@
     },
     {
       "path": "native/codex/plugins/devlyn/skills/devlyn-ideate/scripts/queue.py",
-      "sha256": "afd2f9fc8e5be73641cfa46a9de40c38b573dff6b22714d1457babe04f5c1b2f",
+      "sha256": "64de33eff3c47963a6e86159f086a780c613a8064d582e1d6d422d2d7060069e",
       "executable": false
     },
     {
@@ -1779,12 +1789,12 @@
     },
     {
       "path": "package.json",
-      "sha256": "2448478a5c2d95bc1cddde475d3d091942f4685c982ca5e52a7d1a267636fd4c",
+      "sha256": "53d9675b0c48aee7aa30b655c059c620d33771285643282fff216694969e9892",
       "executable": false
     }
   ],
   "digest": {
     "algorithm": "sha256",
-    "value": "2a0d645e703b3aa32324d5890cbb83d6bf9174074e12dbf3f16e00c2f1ba7cb1"
+    "value": "0e87d1f25e33fd40925d8657f4006a2ba4ec768e53be005ad67d4f97e73181c2"
   }
 }