@shardworks/spider-apparatus 0.1.270 → 0.1.272

package/README.md

@@ -2,7 +2,14 @@
 
 The Spider is the guild's rig execution engine. It spawns rigs for open writs, drives engine pipelines to completion, and transitions writs via the Clerk when rigs finish. Each rig is an ordered pipeline of engine instances; the Spider's `crawl()` loop advances that pipeline one step at a time.
 
-The Spider maintains bidirectional CDC cascades between writs and rigs: when a rig reaches a terminal or `stuck` state, the associated writ is transitioned to match; when a writ is cancelled, the associated rig is cancelled (writs transitioning to `completed` or `failed` do not cancel the rig). Engine failures cascade the rig to `stuck` (a non-terminal "needs attention" state) and the writ to `stuck`, preserving the obligation for future retry. Guards in both handlers break the circular cascade path so that a writ cancellation that triggers a rig cancellation does not attempt to re-transition the already-terminal writ.
+The Spider's state model is:
+
+- **`EngineStatus`** — `'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'skipped'`. Holds (rate-limit, block-type, retry back-off) are **pending-plus-metadata**, not a distinct state: `status='pending'` + `holdReason` / `holdUntil` / `holdCondition` on the engine instance. `holdReason` is either a registered BlockType id (e.g. `'animator-paused'` — the rate-limit gate) or the sentinel `'retry-backoff'` for purely timer-driven retry holds (no BlockType; cleared when `holdUntil` elapses).
+- **`RigStatus`** — `'running' | 'completed' | 'failed' | 'cancelled'`. Rig status is a **pure projection** of the engine set: running if any engine is non-terminal, failed if any terminal-failed with no running, completed if all terminal-success with at least one completed, cancelled if `cancelledAt` is set. It is never written independently — every engine-state-change goes through a patch-wrapper (`patchRigWithRollup`) that recomputes the status and writes both fields in one transaction.
+- **Retry** — opt-in on engine designs via a nested `retry: { maxAttempts, backoff }` block. Transient failures (session crash, engine throw) retry in place on the same rig up to the design's budget, with exponential back-off. Rate-limit is a hold (no budget consumed); definitional failures (invalid graft, unknown design, non-serializable yields) fail terminally on first observation. Legacy rigs persisted with `'stuck'` / `'blocked'` statuses remain in place — readers tolerate them; no migration.
+- **Attempts** — every engine dispatch appends a row to `attempts[]` carrying `startedAt`, `endedAt`, terminal `status`, optional `error`, `sessionId`, and `yields`. Scalar engine-level `startedAt` / `completedAt` / `error` / `sessionId` / `yields` fields **do not exist** — `attempts[-1]` is authoritative.
+
+The Spider maintains bidirectional CDC cascades between writs and rigs: when a rig reaches a terminal state, the associated writ is transitioned to match; when a writ is cancelled, the associated rig is cancelled (writs transitioning to `completed` or `failed` do not cancel the rig). Engine-failure retry now lives inside the rig — only terminal retry exhaustion routes the rig to `failed`, which cascades the writ directly to `phase='failed'`. Guards in both handlers break the circular cascade path so that a writ cancellation that triggers a rig cancellation does not attempt to re-transition the already-terminal writ.
 
 Depends on `@shardworks/stacks-apparatus` for rig persistence, `@shardworks/fabricator-apparatus` to look up engine designs, `@shardworks/clerk-apparatus` to transition writs, and `@shardworks/animator-apparatus` to launch quick-engine sessions. Recommends `@shardworks/loom-apparatus` so the Spider's support kit can contribute the `mender` role used by the seal-engine recovery tail.
 
@@ -31,9 +38,9 @@ const spider = guild().apparatus<SpiderApi>('spider');
 
 ### `crawl(): Promise<CrawlResult | null>`
 
-Execute one step of the crawl loop. The Spider evaluates pending work in priority order — collect > processGrafts > checkBlocked > **pause gate** > run > autoUnstick > spawn — and returns a description of the action taken, or `null` if no work was available.
+Execute one step of the crawl loop. The Spider evaluates pending work in priority order — collect > processGrafts > run > autoUnstick > spawn (guarded by the Animator-paused gate) — and returns a description of the action taken, or `null` if no work was available.
 
-The **pause gate** consults the Animator's rate-limit status (via `AnimatorApi.getStatus()`) and short-circuits the `tryRun` and `trySpawn` phases when the Animator is paused AND the persisted `pausedUntil` window has not elapsed. The earlier phases (`tryCollect`, `tryProcessGrafts`, `tryCheckBlocked`) still run so the triggering rate-limit signal is ingested and the `animator-paused` block-type checker can drive auto-resume. When the gate suppresses both dispatch phases and no other phase produced work, `crawl()` returns `null` (today's "no work" signal — no new CrawlResult variant).
+Dispatch (inside `tryRun`) is governed by a single **dispatch predicate** that composes four checks per pending engine: status is `'pending'`, every upstream is terminal-success, `holdUntil` is absent or in the past, and — if `holdReason` names a registered `BlockType` — the BlockType's `check()` returns `'cleared'` (honouring its `pollIntervalMs` against the engine's `lastCheckedAt` stamp). The top-level `isAnimatorPaused()` gate now only guards `trySpawn`; `tryRun` is handled uniformly by the per-engine predicate.
 
 ```typescript
 const result = await spider.crawl();
@@ -49,38 +56,61 @@ CrawlResult variants:
 | `'rig-spawned'` | Created a new rig for an open writ |
 | `'engine-started'` | Launched a quick engine's session |
 | `'engine-completed'` | An engine finished; rig still running |
-| `'engine-blocked'` | Engine entered blocked status |
-| `'engine-unblocked'` | A blocked engine's condition cleared |
+| `'engine-held'` | Engine transitioned to `'pending'` with a hold (rate-limit, block-type gate) |
+| `'engine-retrying'` | A retryable failure was observed; engine is pending with a back-off `holdUntil` and `attemptCount` was incremented |
 | `'engine-skipped'` | Engine (and any downstream-only dependents) was skipped due to `when` condition |
 | `'engine-grafted'` | Engine injected additional engines into the pipeline |
-| `'rig-completed'` | Rig reached terminal or stuck state (completed, stuck, failed, or cancelled) |
-| `'rig-blocked'` | All forward progress stalled; rig entered blocked status |
-| `'gated'` | Spawn was deferred — the writ has outbound `spider.follows` blockers (includes the case where a blocker reached `failed` and the writ was cascaded to `stuck`) |
+| `'rig-completed'` | Rig reached terminal state (`completed`, `failed`, or `cancelled`) |
 | `'writ-unstuck'` | `autoUnstick` phase returned a previously-Spider-stuck writ to `open` because its recorded blockers resolved |
 
+A `null` return means no dispatchable candidate was found this tick — either the queue is empty, or every candidate writ was gated on non-terminal blockers. Gate state lives on the writ substrate (`phase` + `status.spider`), not in the `CrawlResult`.
+
 ### Dispatch gating via `spider.follows`
 
 Spider contributes a `spider.follows` link kind and consults outbound `spider.follows` links when deciding whether to spawn a rig for an open writ. The gate is evaluated in `trySpawn` before any rig is created:
 
-- If any direct outbound `spider.follows` target is still `new`, `open`, or `stuck` — the writ is held. `trySpawn` emits a `'gated'` result and the writ stays `open` until a later poll.
-- If any direct outbound target is `failed` — the writ is cascaded to `stuck`. A `status.spider` record is written with `stuckCause: 'failed-blocker'` and the ids of every failed blocker. The resolution text is `Blocked by failed dependency: <short-id>` (or `Blocked by failed dependencies: …` when plural).
-- If the full transitive `spider.follows` walk from the writ visits a cycle — the writ is cascaded to `stuck` with `stuckCause: 'cycle'` and the cycle members as blockers. The resolution text is `Detected spider.follows cycle: <id> → <id> → … → <id>`.
+- If any direct outbound `spider.follows` target is still `new`, `open`, or `stuck` — the writ is held. The scan continues to the next candidate so a later, unblocked writ can still dispatch this tick; the gated writ stays `open` and no status is persisted.
+- If any direct outbound target is `failed` — the writ is cascaded to `stuck`. A `status.spider` record is written with `stuckCause: 'failed-blocker'` and the ids of every failed blocker. The resolution text is `Blocked by failed dependency: <short-id>` (or `Blocked by failed dependencies: …` when plural). The scan then continues with the next candidate.
+- If the full transitive `spider.follows` walk from the writ visits a cycle — every cycle member is cascaded to `stuck` with `stuckCause: 'cycle'` and the cycle members as blockers. The resolution text is `Cycle detected in spider.follows graph`. The scan then continues with the next candidate.
 - Only when every direct outbound target is in a terminal-success state (`completed`, or `cancelled`) does the writ proceed to rig spawn.
 
-Before `trySpawn`, each crawl tick runs an `autoUnstick` pass that re-evaluates every writ whose `status.spider.stuckCause` is one of the dependency-recovery causes (`failed-blocker` or `cycle`). When the recorded cause resolves (all `failed-blocker` ids are now `completed`/`cancelled`, or any `cycle` member has moved out of `open`/`stuck`), the writ is returned to `open` and emits a `'writ-unstuck'` result. Writs stuck with other causes — including `engine-failure` writs (see below) and operator-stuck writs with no `status.spider` slot — are left alone; their recovery is owned by a separate retry clockwork, not by `autoUnstick`.
+Before `trySpawn`, each crawl tick runs an `autoUnstick` pass that re-evaluates every writ whose `status.spider.stuckCause` is one of the dependency-recovery causes (`failed-blocker` or `cycle`). When the recorded cause resolves (all `failed-blocker` ids are now `completed`/`cancelled`, or any `cycle` member has moved out of `open`/`stuck`), the writ is returned to `open` and emits a `'writ-unstuck'` result. Writs stuck without a `status.spider` slot (operator-flagged stucks) are left alone — their recovery is owned by the operator, not by `autoUnstick`.
+
+### Engine-level retry (in-place within the rig)
+
+Engine designs may declare an opt-in retry policy:
+
+```typescript
+const myEngine: EngineDesign = {
+  id: 'my-engine',
+  retry: { maxAttempts: 2, backoff: { initialMs: 30_000, maxMs: 600_000, factor: 2 } },
+  async run(givens, ctx) { /* … */ },
+};
+```
+
+When an engine observes a retryable failure (session crash, engine throw, `collect()` throw) and the design has remaining budget, the unified failure handler:
+
+1. Finalizes the in-flight `attempts[-1]` row with `status='failed'` and the error message.
+2. Increments `engine.attemptCount`.
+3. Sets `engine.status='pending'` with `holdReason='retry-backoff'` and `holdUntil` computed from the back-off policy.
+4. Leaves downstream engines pending (no cascade-cancel).
 
-### Engine-failure stuck payload
+The dispatch predicate picks the engine up again once `holdUntil` elapses; a fresh attempt row is appended to `attempts[]`, and the sequence repeats until the attempt succeeds or the budget is exhausted.
 
-When an engine failure takes a rig to `stuck` via the `failEngine` path (session crash, engine throw, graft validation failure, unknown design, unknown block type, invalid block condition, non-JSON-serializable yields), Spider publishes an observability payload to the writ's `status.spider` sub-slot alongside the standard rig → writ CDC transition:
+Retry is **opt-in**. Engine designs without a `retry` block default to `maxAttempts: 0` — the first retryable failure is terminal. Definitional failures (invalid graft, unknown design, unknown block type, non-JSON-serializable yields) fail terminally regardless of budget.
 
-- `stuckCause: 'engine-failure'` — the single bucket for every engine-cascade failure. Sub-taxonomy lives in `detail`, not in the enum.
-- `retryable: boolean` — classified at the `failEngine` call site. `true` for transient failures (session crashes, engine threw an unexpected error) where a fresh attempt may succeed. `false` for definitional failures (invalid graft, unknown design/block type, bad schema, non-JSON-serializable yields) where the same code would reproduce the same failure.
-- `detail: string` — freeform human-readable description of the specific failure. Surfaces to the patron UI and analytics, and is the designated place for case-by-case context.
-- `observedAt: string` — ISO timestamp of the transition.
+Designs shipping with retry enabled in this commission: `anima-session`, `implement`, `review`, `revise`, `astrolabe.reader-analyst`, `astrolabe.patron-anima`, `astrolabe.decision-review`. All others (including `draft`, `seal`, `manual-merge`, `step-session`, `implement-loop`, `astrolabe.plan-init`, `astrolabe.inventory-check`, `astrolabe.plan-finalize`, `astrolabe.observation-lift`) default to no retry.
 
-The `retryable` flag is informational in this plugin — nothing here acts on it. The retry clockwork (a separate commission) is the sole load-bearing consumer. Dependency-recovery stucks (`failed-blocker` / `cycle`) do not write `retryable` or `detail`; they carry `blockerIds` instead and are serviced by `autoUnstick`.
+### Terminal engine-failure cascade
 
-`failEngine` writes the rig patch (`status: 'stuck'`) and the writ's `status.spider` payload inside a single `stacks.transaction`. Both land in the same post-commit event batch, so any Phase 2 observer (the retry clockwork in particular) sees a writ stuck transition whose status slot is already fully populated. Producers must not split these two writes across transactions — that would expose a window where a stuck observer reads a slot with stale data.
+When an engine exhausts its retry budget (or observes a definitional failure), the unified failure handler:
+
+1. Finalizes the in-flight attempts[] row.
+2. Sets `engine.status='failed'`.
+3. Cascade-cancels every non-terminal engine (both plain pending and pending-with-hold) in one pass.
+4. The `patchRigWithRollup` wrapper projects `rig.status='failed'` as the natural derivation.
+
+The existing rigs→writs CDC handler translates `rig.status='failed'` directly to `writ.phase='failed'` — no intermediate stuck state. The writ's `status.spider` slot is **not written on the engine-failure path**: that slot is reserved for dependency-recovery causes (`failed-blocker`, `cycle`). Engine-level retry has fully absorbed the retry budget that legacy versions of Spider exposed via stuck-with-`retryable=true`.
 
 ### `show(id): Promise<RigDoc>`
 
@@ -213,6 +243,7 @@ A config-level template named `default` overrides the plugin-contributed `spider
 | `rigTemplateMappings` | `Record<string, string>` | plugin default `{ mandate: 'default' }` | Writ type → template name. Config-level entries override plugin-contributed mappings for the same writ type. Two kits contributing a mapping for the same writ type is a hard error at guild startup; resolve by removing one kit mapping or by overriding here in config (config always wins). |
 | `maxConcurrentEngines` | `number` | `3` | Maximum number of engines running concurrently across all rigs. When the limit is reached, runnable engines stay in `pending` and new rigs are not spawned until a slot frees. |
 | `maxConcurrentEnginesPerRig` | `number` | `1` | Maximum number of engines running concurrently within a single rig. Prevents race conditions with rig-local resources. |
+| `engineRetryOverrides` | `Record<string, Partial<EngineRetryConfig>>` | — | Per-design overrides for engine retry policy, keyed by `EngineDesign.id`. The override layers on top of the design's declared `retry`, which in turn layers on top of the kit's built-in defaults (`override > design.retry > built-in defaults`). Validated fail-loud at startup: an unknown `designId` or any malformed field (negative `maxAttempts`, `maxMs < initialMs`, `factor <= 1`, etc.) throws before any engines are scheduled. The map is re-read live from guild config on each retry decision, so guild.json edits take effect on the next retry without restarting the daemon. An override on a design with no declared `retry` block is permitted — it enables retry on a previously fail-fast engine. See `docs/architecture/apparatus/spider.md` for the full shape, validation rules, and a worked example. |
 
 ## Rig Templates
 
@@ -330,9 +361,10 @@ Two kits contributing overlapping entries to a merge registry refuse to start th
 
 - `rigTemplateMappings` — two kits mapping the same writ type (including Spider's own plugin-default `mandate → default`)
 - `blockTypes` — two kits contributing the same block-type id
-- Clerk `writTypes` — two kits contributing the same writ type
 - Fabricator `engines` — two kits contributing the same engine-design id
 
+(Writ types are no longer kit-merged — every plugin registers its own writ types via `ClerkApi.registerWritType` from its own apparatus's `start()`. A second registration of the same name throws at registration time with `[clerk] registerWritType: duplicate writ type "<name>"`.)
+
 When a collision is detected the guild fails to start with an error naming both contributing plugins and the conflicting key. Operators resolve by removing one of the kit contributions, or — for the Spider sites that support it — by declaring a config-level override in `guild.json["spider"]` (config always wins over any kit contribution, silently). The winner is never selected by kit load order.
 
 
@@ -350,10 +382,11 @@ The Spider contributes books, tools, engines, and a role for rig inspection and
 
 | Tool | Permission | Description |
 |---|---|---|
-| `rig-list` | `read` | List rigs with optional status/limit filters (returns enriched `RigView[]`) |
-| `rig-show` | `read` | Show full detail for a rig by id (returns enriched `RigView`) |
-| `rig-resume` | `write` | Manually clear a block on a specific engine |
-| `rig-cancel` | `write` | Cancel a running, blocked, or stuck rig |
+| `rig-list` | `read` | List rigs with optional status/limit filters (returns enriched `RigView[]`). `--status` accepts the four current values (`running`/`completed`/`failed`/`cancelled`) **plus** the deprecated legacy values `stuck` and `blocked` for inspecting rigs that predate the engine-level retry reshape. |
+| `rig-show` | `read` | Show full detail for a rig by id. Default `--format text` renders a human-readable CLI view surfacing per-engine attempt count, hold state (`holdReason` / `holdUntil` / `lastCheckedAt`), and the latest attempt's error — the minimum bar the engine-level retry commission calls for. Pass `--format json` for the raw enriched `RigView`. |
+| `rig-resume` | `write` | Manually clear a hold on a specific pending engine |
+| `rig-cancel` | `write` | Cancel a running rig (also tolerates legacy `'stuck'` / `'blocked'` rigs) |
+| `writ-rescue-stuck` | `write` | List, and with `--apply` requeue, writs still stuck under the legacy `engine-failure` cause that predate the engine-level-retry commission. Default lists candidates without mutating; `--apply` transitions each match `stuck → open`, clears its `status.spider` slot, and cancels every legacy `'stuck'` / `'blocked'` rig for that writ. Operator-stuck writs (no `status.spider` slot) and dependency-cause stucks (`failed-blocker` / `cycle`) are never touched. Pass `--id` to scope to a single writ; `--format json` for machine-readable output. |
 | `crawl` | `write` | Execute a single crawl step |
 | `crawl-continual` | `write` | Poll `crawl()` in a loop until no work remains |
 

package/dist/block-types/animator-paused.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animator-paused.d.ts","sourceRoot":"","sources":["../../src/block-types/animator-paused.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAO1D,QAAA,MAAM,uBAAuB,EAAE,SA0B9B,CAAC;AAEF,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"animator-paused.d.ts","sourceRoot":"","sources":["../../src/block-types/animator-paused.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAe1D,QAAA,MAAM,uBAAuB,EAAE,SAwB9B,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/block-types/animator-paused.js

@@ -14,10 +14,19 @@
  */
 import { z } from 'zod';
 import { guild } from '@shardworks/nexus-core';
-const conditionSchema = z.object({
+import { isDispatchable } from '@shardworks/animator-apparatus';
+// The outer object is `.optional()` so legacy engines persisted under
+// the pre-`attempts[]` schema — `holdReason: 'animator-paused'` with no
+// `holdCondition` — resolve quietly through `check()` instead of
+// throwing a ZodError that the dispatch predicate's catch logs as a
+// warning. Populated conditions still validate against the inner shape;
+// malformed payloads (e.g. `{ sessionId: 42 }`) are still rejected.
+const conditionSchema = z
+    .object({
     /** Session id that triggered the pause — informational. */
     sessionId: z.string().optional(),
-});
+})
+    .optional();
 const animatorPausedBlockType = {
     id: 'animator-paused',
     conditionSchema,
@@ -38,14 +47,10 @@ const animatorPausedBlockType = {
             return { status: 'pending' };
         }
         const status = await animator.getStatus();
-        if (status.state === 'running')
-            return { status: 'cleared' };
-        if (!status.pausedUntil)
-            return { status: 'cleared' };
-        if (new Date(status.pausedUntil).getTime() <= Date.now()) {
-            return { status: 'cleared' };
-        }
-        return { status: 'pending' };
+        // Delegate to the canonical predicate from the animator package so
+        // this checker stays in lockstep with the back-off machine, the
+        // crawl-gate, and the Oculus banner.
+        return { status: isDispatchable(status) ? 'cleared' : 'pending' };
     },
 };
 export default animatorPausedBlockType;

package/dist/block-types/animator-paused.js.map

@@ -1 +1 @@
-{"version":3,"file":"animator-paused.js","sourceRoot":"","sources":["../../src/block-types/animator-paused.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAI/C,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAc;IACzC,EAAE,EAAE,iBAAiB;IACrB,eAAe;IACf,qEAAqE;IACrE,mEAAmE;IACnE,+BAA+B;IAC/B,cAAc,EAAE,MAAM;IACtB,KAAK,CAAC,KAAK,CAAC,SAAkB;QAC5B,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,QAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,+DAA+D;YAC/D,8BAA8B;YAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACtD,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACzD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;CACF,CAAC;AAEF,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"animator-paused.js","sourceRoot":"","sources":["../../src/block-types/animator-paused.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIhE,sEAAsE;AACtE,wEAAwE;AACxE,iEAAiE;AACjE,oEAAoE;AACpE,wEAAwE;AACxE,oEAAoE;AACpE,MAAM,eAAe,GAAG,CAAC;KACtB,MAAM,CAAC;IACN,2DAA2D;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,QAAQ,EAAE,CAAC;AAEd,MAAM,uBAAuB,GAAc;IACzC,EAAE,EAAE,iBAAiB;IACrB,eAAe;IACf,qEAAqE;IACrE,mEAAmE;IACnE,+BAA+B;IAC/B,cAAc,EAAE,MAAM;IACtB,KAAK,CAAC,KAAK,CAAC,SAAkB;QAC5B,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,QAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,+DAA+D;YAC/D,8BAA8B;YAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,mEAAmE;QACnE,gEAAgE;QAChE,qCAAqC;QACrC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IACpE,CAAC;CACF,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/engines/anima-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anima-session.d.ts","sourceRoot":"","sources":["../../src/engines/anima-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIrE,QAAA,MAAM,kBAAkB,EAAE,YAgCzB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"anima-session.d.ts","sourceRoot":"","sources":["../../src/engines/anima-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIrE,QAAA,MAAM,kBAAkB,EAAE,YAqCzB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/engines/anima-session.js

@@ -12,6 +12,10 @@
 import { guild } from '@shardworks/nexus-core';
 const animaSessionEngine = {
     id: 'anima-session',
+    // Retry budget — transient session crashes retry in-place. This is
+    // the design used by the plan-and-ship template's `spec-writer` slot
+    // (and any other rig template that summons a generic anima session).
+    retry: { maxAttempts: 2 },
     async run(givens, context) {
         // Validate required givens
         if (typeof givens.role !== 'string' || givens.role.length === 0) {

package/dist/engines/anima-session.js.map

@@ -1 +1 @@
-{"version":3,"file":"anima-session.js","sourceRoot":"","sources":["../../src/engines/anima-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAK/C,MAAM,kBAAkB,GAAiB;IACvC,EAAE,EAAE,eAAe;IAEnB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,2BAA2B;QAC3B,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAA2B,CAAC;QAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE;YACvE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YAC9E,uEAAuE;YACvE,sEAAsE;YACtE,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"anima-session.js","sourceRoot":"","sources":["../../src/engines/anima-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAK/C,MAAM,kBAAkB,GAAiB;IACvC,EAAE,EAAE,eAAe;IAEnB,mEAAmE;IACnE,qEAAqE;IACrE,qEAAqE;IACrE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;IAEzB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,2BAA2B;QAC3B,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAA2B,CAAC;QAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAwB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE;YACvE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YAC9E,uEAAuE;YACvE,sEAAsE;YACtE,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/engines/implement-loop.d.ts

@@ -1,20 +1,20 @@
 /**
  * Implement-loop engine — clockwork.
  *
- * Orchestrates sequential execution of piece writs under a mandate.
+ * Orchestrates sequential execution of step writs under a mandate.
  *
  * On run:
- *   1. Queries all open child piece writs of the mandate.
- *   2. If pieces exist, grafts piece-session engines for each piece
+ *   1. Queries all open child step writs of the mandate.
+ *   2. If steps exist, grafts step-session engines for each step
  *      (in mandate child order) with sequential upstream dependencies.
- *   3. If no pieces exist, falls through to legacy single-session behavior
+ *   3. If no steps exist, falls through to legacy single-session behavior
  *      identical to the original implement engine.
  *
  * The engine itself completes immediately with a graft (clockwork engine
  * returning { status: 'completed', yields, graft }). The grafted
- * piece-session engines are then processed sequentially by the Spider.
+ * step-session engines are then processed sequentially by the Spider.
  *
- * For the legacy fallback (no pieces), it launches an anima session
+ * For the legacy fallback (no steps), it launches an anima session
  * directly, same as the original implement engine.
  */
 import type { EngineDesign } from '@shardworks/fabricator-apparatus';

package/dist/engines/implement-loop.js

@@ -1,20 +1,20 @@
 /**
  * Implement-loop engine — clockwork.
  *
- * Orchestrates sequential execution of piece writs under a mandate.
+ * Orchestrates sequential execution of step writs under a mandate.
  *
  * On run:
- *   1. Queries all open child piece writs of the mandate.
- *   2. If pieces exist, grafts piece-session engines for each piece
+ *   1. Queries all open child step writs of the mandate.
+ *   2. If steps exist, grafts step-session engines for each step
  *      (in mandate child order) with sequential upstream dependencies.
- *   3. If no pieces exist, falls through to legacy single-session behavior
+ *   3. If no steps exist, falls through to legacy single-session behavior
  *      identical to the original implement engine.
  *
  * The engine itself completes immediately with a graft (clockwork engine
  * returning { status: 'completed', yields, graft }). The grafted
- * piece-session engines are then processed sequentially by the Spider.
+ * step-session engines are then processed sequentially by the Spider.
  *
- * For the legacy fallback (no pieces), it launches an anima session
+ * For the legacy fallback (no steps), it launches an anima session
  * directly, same as the original implement engine.
  */
 import { guild } from '@shardworks/nexus-core';
@@ -25,15 +25,15 @@ const implementLoopEngine = {
         const clerk = guild().apparatus('clerk');
         const writ = givens.writ;
         const draft = context.upstream['draft'];
-        // Query all open child piece writs of the mandate
-        const pieces = await clerk.list({
+        // Query all open child step writs of the mandate
+        const steps = await clerk.list({
             parentId: writ.id,
-            type: 'piece',
+            type: 'step',
             phase: 'open',
             limit: 100,
         });
-        if (pieces.length === 0) {
-            // ── Legacy fallback: no pieces → single-session implement ──
+        if (steps.length === 0) {
+            // ── Legacy fallback: no steps → single-session implement ──
             const animator = guild().apparatus('animator');
             const prompt = `${writ.body}\n${EXECUTION_EPILOGUE}`;
             const handle = animator.summon({
@@ -45,23 +45,23 @@ const implementLoopEngine = {
             });
             return { status: 'launched', sessionId: handle.sessionId };
         }
-        // ── Piece-aware path: graft piece-session engines ──
-        // Sort pieces by createdAt to maintain manifest order
-        const sortedPieces = [...pieces].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
-        // Build a chain of piece-session engines with sequential dependencies.
-        // Each piece-session depends on the previous one (or on this engine for the first).
+        // ── Step-aware path: graft step-session engines ──
+        // Sort steps by createdAt to maintain manifest order
+        const sortedSteps = [...steps].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        // Build a chain of step-session engines with sequential dependencies.
+        // Each step-session depends on the previous one (or on this engine for the first).
         const graft = [];
         let previousEngineId = context.engineId; // 'implement-loop' or whatever the instance id is
-        for (let i = 0; i < sortedPieces.length; i++) {
-            const piece = sortedPieces[i];
-            const engineId = `piece-${i}`;
+        for (let i = 0; i < sortedSteps.length; i++) {
+            const step = sortedSteps[i];
+            const engineId = `step-${i}`;
             graft.push({
                 id: engineId,
-                designId: 'piece-session',
+                designId: 'step-session',
                 upstream: [previousEngineId],
                 givens: {
                     writ: '${writ}',
-                    piece: piece, // Pass the piece WritDoc directly as a literal value
+                    step: step, // Pass the step WritDoc directly as a literal value
                     role: givens.role,
                     cwd: `\${yields.draft.path}`,
                 },
@@ -70,16 +70,16 @@ const implementLoopEngine = {
         }
         // Return as a SpiderEngineRunResult with graft.
         // graftTail tells Spider that any engine downstream of implement-loop
-        // should also wait for the last grafted piece-session to complete.
-        const lastPieceEngineId = `piece-${sortedPieces.length - 1}`;
+        // should also wait for the last grafted step-session to complete.
+        const lastStepEngineId = `step-${sortedSteps.length - 1}`;
         const result = {
             status: 'completed',
             yields: {
-                pieceCount: sortedPieces.length,
-                pieceIds: sortedPieces.map(p => p.id),
+                stepCount: sortedSteps.length,
+                stepIds: sortedSteps.map(p => p.id),
             },
             graft,
-            graftTail: lastPieceEngineId,
+            graftTail: lastStepEngineId,
         };
         return result;
     },

package/dist/engines/implement-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"implement-loop.js","sourceRoot":"","sources":["../../src/engines/implement-loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"implement-loop.js","sourceRoot":"","sources":["../../src/engines/implement-loop.ts"],"names":[],"mappings":"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"}

package/dist/engines/implement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB,usBASuB,CAAC;AAEhD,QAAA,MAAM,eAAe,EAAE,YA4BtB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,eAAe,eAAe,CAAC"}
+{"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB,usBASuB,CAAC;AAEhD,QAAA,MAAM,eAAe,EAAE,YAgCtB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,eAAe,eAAe,CAAC"}

package/dist/engines/implement.js

@@ -36,6 +36,9 @@ If the specification above contains a <task-manifest>, follow these execution ru
 Commit all changes before ending your session.`;
 const implementEngine = {
     id: 'implement',
+    // Retry budget — transient session crashes / animator hiccups retry
+    // in-place on the same rig. Terminal exhaustion fails the writ directly.
+    retry: { maxAttempts: 2 },
     async run(givens, context) {
         const animator = guild().apparatus('animator');
         const writ = givens.writ;

package/dist/engines/implement.js.map

@@ -1 +1 @@
-{"version":3,"file":"implement.js","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;+CASoB,CAAC;AAEhD,MAAM,eAAe,GAAiB;IACpC,EAAE,EAAE,WAAW;IAEf,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAe,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB,CAAC;QAEvD,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,iEAAiE;QACjE,8CAA8C;QAC9C,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACxE,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACd,MAAM,MAAM,GAAG,GAAG,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,WAAW,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE;YAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,eAAe,eAAe,CAAC"}
+{"version":3,"file":"implement.js","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;+CASoB,CAAC;AAEhD,MAAM,eAAe,GAAiB;IACpC,EAAE,EAAE,WAAW;IAEf,oEAAoE;IACpE,yEAAyE;IACzE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;IAEzB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAe,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB,CAAC;QAEvD,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,iEAAiE;QACjE,8CAA8C;QAC9C,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACxE,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACd,MAAM,MAAM,GAAG,GAAG,IAAI,KAAK,kBAAkB,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,WAAW,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE;YAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,eAAe,eAAe,CAAC"}

package/dist/engines/index.d.ts

@@ -3,7 +3,7 @@ export { default as draftEngine } from './draft.ts';
 export { default as implementEngine, EXECUTION_EPILOGUE } from './implement.ts';
 export { default as implementLoopEngine } from './implement-loop.ts';
 export { default as manualMergeEngine } from './manual-merge.ts';
-export { default as pieceSessionEngine, PIECE_EXECUTION_EPILOGUE } from './piece-session.ts';
+export { default as stepSessionEngine, STEP_EXECUTION_EPILOGUE } from './step-session.ts';
 export { default as reviewEngine } from './review.ts';
 export { default as reviseEngine } from './revise.ts';
 export { default as sealEngine } from './seal.ts';

package/dist/engines/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/engines/index.js

@@ -3,7 +3,7 @@ export { default as draftEngine } from "./draft.js";
 export { default as implementEngine, EXECUTION_EPILOGUE } from "./implement.js";
 export { default as implementLoopEngine } from "./implement-loop.js";
 export { default as manualMergeEngine } from "./manual-merge.js";
-export { default as pieceSessionEngine, PIECE_EXECUTION_EPILOGUE } from "./piece-session.js";
+export { default as stepSessionEngine, STEP_EXECUTION_EPILOGUE } from "./step-session.js";
 export { default as reviewEngine } from "./review.js";
 export { default as reviseEngine } from "./revise.js";
 export { default as sealEngine } from "./seal.js";

package/dist/engines/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/engines/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/engines/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAiGrE,QAAA,MAAM,YAAY,EAAE,YAgDnB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/engines/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAiGrE,QAAA,MAAM,YAAY,EAAE,YAoDnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/review.js

@@ -104,6 +104,9 @@ Produce your findings as your final message in the format above.`;
 }
 const reviewEngine = {
     id: 'review',
+    // Retry budget — transient session crashes retry in-place. Terminal
+    // exhaustion fails the writ directly.
+    retry: { maxAttempts: 2 },
     async run(givens, context) {
         const animator = guild().apparatus('animator');
         const writ = givens.writ;

package/dist/engines/review.js.map

@@ -1 +1 @@
-{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/engines/review.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/engines/review.ts"],"names":[],"mappings":"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"}

package/dist/engines/revise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"revise.d.ts","sourceRoot":"","sources":["../../src/engines/revise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AA8DrE,QAAA,MAAM,YAAY,EAAE,YAuBnB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"revise.d.ts","sourceRoot":"","sources":["../../src/engines/revise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AA8DrE,QAAA,MAAM,YAAY,EAAE,YA2BnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/revise.js

@@ -67,6 +67,9 @@ Commit all changes before ending your session.`;
 }
 const reviseEngine = {
     id: 'revise',
+    // Retry budget — transient session crashes retry in-place. Terminal
+    // exhaustion fails the writ directly.
+    retry: { maxAttempts: 2 },
     async run(givens, context) {
         const animator = guild().apparatus('animator');
         const writ = givens.writ;

package/dist/engines/revise.js.map

@@ -1 +1 @@
-{"version":3,"file":"revise.js","sourceRoot":"","sources":["../../src/engines/revise.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"revise.js","sourceRoot":"","sources":["../../src/engines/revise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAa,EAAE,MAAoB,EAAE,MAAc,EAAE,IAAY;IAC/F,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM;QAChC,CAAC,CAAC,8JAA8J;QAChK,CAAC,CAAC,qJAAqJ,CAAC;IAE1J,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE;QAC7B,CAAC,CAAC,eAAe,IAAI,UAAU;QAC/B,CAAC,CAAC,2BAA2B,CAAC;IAEhC,OAAO;;;;;;EAMP,IAAI,CAAC,IAAI;;;;EAIT,MAAM,CAAC,QAAQ;;oBAEG,YAAY;;EAE9B,YAAY;;;;;EAKZ,MAAM;;;EAGN,WAAW;;+CAEkC,CAAC;AAChD,CAAC;AAED,MAAM,YAAY,GAAiB;IACjC,EAAE,EAAE,QAAQ;IAEZ,oEAAoE;IACpE,sCAAsC;IACtC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;IAEzB,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO;QACvB,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,SAAS,CAAc,UAAU,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAe,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB,CAAC;QACvD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB,CAAC;QAE1D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,WAAW,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,EAAE,cAAc,EAAE;YAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;SAC1D,CAAC,CAAC;QAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/step-session.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Step-session engine — quick (Animator-backed).
+ *
+ * Launches an anima session for a single step writ. The prompt combines
+ * the mandate body with the step body and step-specific execution
+ * instructions.
+ *
+ * Custom collect():
+ *   - On session completion → transitions the step writ to 'completed'.
+ *   - After collecting, checks for dynamically added child steps of the
+ *     mandate and grafts new step-session engines for them.
+ *
+ * Note on failure: Spider's tryCollect() calls failEngine() directly for
+ * failed/timeout sessions and never invokes collect(). Step writ failure
+ * relies on Clerk's parent/child cascade when the mandate reaches a
+ * terminal state (stuck → child steps get cancelled).
+ *
+ * Givens:
+ *   - writ: WritDoc (the mandate writ)
+ *   - step: WritDoc (the step writ for this task)
+ *   - role: string
+ *   - cwd: string (draft worktree path)
+ */
+import type { EngineDesign } from '@shardworks/fabricator-apparatus';
+/**
+ * Execution instructions for step sessions. Focuses the anima on a single
+ * task — no manifest traversal, commit-per-step guidance.
+ */
+export declare const STEP_EXECUTION_EPILOGUE = "\nYou are working on a single task from a larger mandate. Focus exclusively on this task.\n\nInstructions:\n1. Complete the task described in the <task> element below the specification.\n2. If the task has a <verify> command, run it after completing the work and confirm the <done> criterion is met.\n3. The <files> element (if present) is the planner's predicted blast radius \u2014 useful for orientation, but verify scope independently.\n4. If you discover additional work needed beyond this task, use the step-add tool to create new tasks rather than doing them inline.\n5. Commit all changes before ending your session.";
+declare const stepSessionEngine: EngineDesign;
+export default stepSessionEngine;
+//# sourceMappingURL=step-session.d.ts.map

package/dist/engines/step-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-session.d.ts","sourceRoot":"","sources":["../../src/engines/step-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,kCAAkC,CAAC;AAiCvF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,qnBAQc,CAAC;AAEnD,QAAA,MAAM,iBAAiB,EAAE,YA0JxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}