axstack 0.25.3 → 0.25.4

package/docs/workflows.md

@@ -254,8 +254,10 @@ for explicit ownership transfer.
   read back private evidence, salvage dirty or ignored non-cache content,
   archive the exact eligible thread, then remove its exact worktree without
   force and delete only eligible local branches. T3 metadata actions do not
-  remove worktrees. Authors remain until their PR merges or closes; the current
-  pass, unsettled descendants, and user-taken-over threads remain protected.
+  remove worktrees. Accepted writer or delegated completion settles thread
+  metadata only. Author threads and worktrees remain retained and unarchived
+  until their PR merges or closes; the current pass, unsettled descendants,
+  and user-taken-over threads remain protected.
 
 One T3 host/server owns a run, one persistent owner owns each PR, and one
 writer owns each candidate. Fanout has no fixed PR count; it follows real
@@ -431,8 +433,12 @@ admits nothing, writes only its private discovery note, and notifies once about
 a stalled owner under the recorded policy.
 
 Capacity is measured across the host. Waiting events stay covered and occupy
-no execution slot after descendants settle. Each pass retires eligible settled
-predecessors through `axstack-cleanup` and records retained worktree count.
+no execution slot after descendants settle. After lane reconciliation at pass
+start, every pass, including a duplicate, settles finished lane pass threads
+under the [Finite-session teardown guards](../skills/axstack/references/automations.md#finite-session-teardown).
+Held or stuck passes stay unsettled. Only the owner retires eligible settled
+predecessors through `axstack-cleanup` and writes continuity; each pass records
+retained worktree count.
 Past the authorized storage limit (default 20 lane worktrees), disable the
 schedule with `enabled:false` and hold. The overlap, real-event, killed-predecessor,
 and storage-limit canaries must pass before activation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axstack",
-  "version": "0.25.3",
+  "version": "0.25.4",
   "description": "Axstack installer and setup CLI: installs owned chat skills and role data, configures supported harness settings, and checks T3 Code capabilities.",
   "keywords": [
     "claude-code",

package/skills/axstack/references/automations.md

@@ -70,8 +70,10 @@ The earlier pass wins only when ordering evidence exists.
 Missing ordering or ownership evidence holds admission and never guesses a winner.
 
 Once identified as a duplicate, the new pass does no PR work, makes no further
-shared-record write and touches no live or unsettled resource owned by the
-live manager. A duplicate pass admits nothing and runs read-only discovery
+shared-record write and touches no PR-job thread or descendant owned by the
+live manager. A duplicate's only mutation is pass-start settlement of eligible
+terminal lane pass threads under [Finite-session teardown](#finite-session-teardown).
+A duplicate pass admits nothing and runs read-only discovery
 into its own pass note in its private evidence folder, recording new eligible
 events and the unserved count. If a duplicate finds a stalled owner idle at its
 prompt with a final turn lacking a completion receipt for more than five
@@ -328,6 +330,16 @@ or separate model gate.
 
 ## Finite-session teardown
 
+After lane reconciliation at pass start, every pass, including a duplicate,
+uses `t3_thread_organize` to settle finished predecessor and duplicate lane pass
+threads as metadata only, before discovery or admission.
+Settle another lane pass thread only with terminal run evidence, no unsettled
+descendants, no recorded open hold naming it, no user takeover, and exclusion of
+the live owner and current pass.
+Leave held or stuck pass threads unsettled.
+Settlement is separate from owner-only worktree removal, branch deletion and
+continuity writes.
+
 Only the owner-of-record pass retires settled predecessor passes and qualifying
 terminal duplicates, including duplicates newer than the owner and immediately
 after successor takeover.
@@ -340,8 +352,8 @@ Then run the driver-start orphan sweep under Workspace hygiene; the sweep is
 silent when nothing was removed. Record sweep results and holds in continuity's
 Open holds table.
 The orphan sweep covers the run record's repositories plus registered repositories on this host.
-Retirement settles duplicate threads with `t3_thread_organize` (settle/archive
-changes metadata only) before separate guarded Git worktree removal.
+Retirement settles remaining duplicate threads with `t3_thread_organize`
+(settle/archive changes metadata only) before separate guarded Git worktree removal.
 Unknown, active or user-taken-over threads,
 ambiguous publication and failed salvage stay preserved.
 

package/skills/axstack/references/review-manager-prompt.md

@@ -9,10 +9,13 @@ which loads `../axstack/references/automations.md` relatively. Read that contrac
 and [T3 runtime](t3-runtime.md). Reconcile lane ownership and duplicate status,
 then follow [Provider bindings](t3-runtime.md#preflight-and-binding) for shared schedule
 recreation and recorded instance update before verifying the recorded `axstack-owner`
-binding before admission. Discover all eligible peer-review events and admit within measured host capacity.
+binding before admission. At pass start, every pass, including a duplicate,
+settles finished predecessor and duplicate pass threads under the Finite-session
+teardown guards before admission. Discover all eligible peer-review events and admit within measured host capacity.
 Use host-clone detached per-PR checkouts; preserve exact ownership and receipts.
-Retire settled predecessors, report retained worktree count, and disable the
-schedule and hold past its authorized limit. Save and read back continuity at
+Report retained worktree count and disable the schedule and hold past its
+authorized limit. Only the owner retires settled predecessors and saves and
+reads back continuity at
 `~/.local/share/axstack/runs/review-manager/progress.md` using
 `run-record.md#review-manager-continuity-template`; settle descendants and end
 the finite turn. Stay quiet when unchanged. Never check out a PR branch here.

package/skills/axstack/references/workspace-hygiene.md

@@ -32,7 +32,12 @@ Cleanup order is: settled descendants -> evidence readback -> salvage dirty or i
 Require terminal run evidence before `t3_thread_organize` settle or archive.
 These metadata actions do not remove worktrees. Accept matching delegated task
 or launched run completion under the runtime contract before settlement.
-Keep the author worktree and thread until the PR merges or closes.
+After the driver accepts a launched writer's or delegated task's completion from terminal run evidence plus a verified receipt or candidate check, it settles the matching thread with `t3_thread_organize` as metadata only.
+Settling never removes, archives or abandons the thread or worktree.
+Retain the author worktree and thread unarchived until the PR merges or closes, with repairs returning to the same author.
+A repair turn automatically un-settles the thread, making it visible while working.
+The driver settles the thread again after the next accepted repair completion.
+Threads with unaccepted completion, FAILED or QUESTION markers, held, failed or interrupted runs, or anything needing the user stay unsettled and visible.
 Retain a user-taken-over T3 thread and never send cleanup commands to it, including `t3_thread_organize` settle or archive.
 Never remove the current driver, current pass, an active or unknown thread, an unsettled descendant, or a resource with ambiguous ownership.
 At final settlement, no eligible non-driver thread or worktree remains.