@shardworks/spider-apparatus 0.1.270 → 0.1.271

package/dist/engines/{piece-session.js → step-session.js}

@@ -1,23 +1,23 @@
 /**
- * Piece-session engine — quick (Animator-backed).
+ * Step-session engine — quick (Animator-backed).
  *
- * Launches an anima session for a single piece writ. The prompt combines
- * the mandate body with the piece body and piece-specific execution
+ * 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 piece writ to 'completed'.
- *   - After collecting, checks for dynamically added child pieces of the
- *     mandate and grafts new piece-session engines for them.
+ *   - 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(). Piece writ failure
+ * 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 pieces get cancelled).
+ * terminal state (stuck → child steps get cancelled).
  *
  * Givens:
  *   - writ: WritDoc (the mandate writ)
- *   - piece: WritDoc (the piece writ for this task)
+ *   - step: WritDoc (the step writ for this task)
  *   - role: string
  *   - cwd: string (draft worktree path)
  */
@@ -28,42 +28,50 @@ import { guild } from '@shardworks/nexus-core';
  * failed) — in which case the failed transition is expected (the cascade or
  * another path beat us to it) and should be swallowed silently.
  *
- * Matches the wording produced by Clerk's `transition()` guard, e.g.
- *   `Cannot transition writ "…" to "completed": phase is "cancelled", expected one of: open.`
+ * Matches the wording produced by Clerk's `transition()` guard. Both the
+ * pre-T2 and post-T2 error shapes are recognised so this classifier keeps
+ * working across the writ-type-config refactor:
+ *   pre-T2:  `Cannot transition writ "…" to "completed": phase is "cancelled", …`
+ *   post-T2: `Cannot transition writ "…" from "cancelled" to "completed": legal transitions from "cancelled" are none (terminal state).`
  * Also tolerates future phrasing like "already terminal".
  */
 function isAlreadyTerminalTransitionError(err) {
     const message = err instanceof Error ? err.message : String(err);
     if (message.includes('already terminal'))
         return true;
+    // Post-T2 strict-transition wording — `none (terminal state)` is emitted
+    // exactly when the writ's current state is terminal and has no outbound
+    // transitions, which is the race condition this guard is meant to swallow.
+    if (message.includes('none (terminal state)'))
+        return true;
     return (message.includes('phase is "cancelled"') ||
         message.includes('phase is "completed"') ||
         message.includes('phase is "failed"'));
 }
 /**
- * Execution instructions for piece sessions. Focuses the anima on a single
- * task — no manifest traversal, commit-per-piece guidance.
+ * Execution instructions for step sessions. Focuses the anima on a single
+ * task — no manifest traversal, commit-per-step guidance.
  */
-export const PIECE_EXECUTION_EPILOGUE = `
+export const STEP_EXECUTION_EPILOGUE = `
 You are working on a single task from a larger mandate. Focus exclusively on this task.
 
 Instructions:
 1. Complete the task described in the <task> element below the specification.
 2. If the task has a <verify> command, run it after completing the work and confirm the <done> criterion is met.
 3. The <files> element (if present) is the planner's predicted blast radius — useful for orientation, but verify scope independently.
-4. If you discover additional work needed beyond this task, use the piece-add tool to create new tasks rather than doing them inline.
+4. If you discover additional work needed beyond this task, use the step-add tool to create new tasks rather than doing them inline.
 5. Commit all changes before ending your session.`;
-const pieceSessionEngine = {
-    id: 'piece-session',
+const stepSessionEngine = {
+    id: 'step-session',
     async run(givens, context) {
         const animator = guild().apparatus('animator');
         const mandateWrit = givens.writ;
-        const piece = givens.piece;
-        if (!piece) {
-            throw new Error('piece-session engine requires a "piece" given (WritDoc).');
+        const step = givens.step;
+        if (!step) {
+            throw new Error('step-session engine requires a "step" given (WritDoc).');
         }
-        // Assemble prompt: mandate body + piece body + piece-specific epilogue
-        const prompt = `${mandateWrit.body}\n\n---\n\n## Current Task\n\nMandate ID: ${mandateWrit.id}\n\n${piece.body}\n${PIECE_EXECUTION_EPILOGUE}`;
+        // Assemble prompt: mandate body + step body + step-specific epilogue
+        const prompt = `${mandateWrit.body}\n\n---\n\n## Current Task\n\nMandate ID: ${mandateWrit.id}\n\n${step.body}\n${STEP_EXECUTION_EPILOGUE}`;
         const handle = animator.summon({
             role: givens.role,
             prompt,
@@ -72,7 +80,7 @@ const pieceSessionEngine = {
             metadata: {
                 engineId: context.engineId,
                 writId: mandateWrit.id,
-                pieceId: piece.id,
+                stepId: step.id,
             },
         });
         return { status: 'launched', sessionId: handle.sessionId };
@@ -84,86 +92,86 @@ const pieceSessionEngine = {
         const clerk = guild().apparatus('clerk');
         const sessionsBook = stacks.readBook('animator', 'sessions');
         const session = await sessionsBook.get(sessionId);
-        const piece = givens.piece;
+        const step = givens.step;
         const mandateWrit = givens.writ;
-        if (!piece || !mandateWrit) {
+        if (!step || !mandateWrit) {
             // Fallback: return generic yields if givens are missing
             return {
                 sessionId,
                 sessionStatus: session?.status ?? 'completed',
             };
         }
-        // Completed session → mark piece completed.
+        // Completed session → mark step completed.
         //
-        // The transition may fail if the piece writ is already in a terminal
+        // The transition may fail if the step writ is already in a terminal
         // state (e.g. Clerk's downward cascade beat us to it after a sibling
         // failure). Classify the error: already-terminal is expected and silent;
         // anything else is a genuine bookkeeping failure that must be surfaced
         // via a warning so the race is visible in logs.
         try {
-            await clerk.transition(piece.id, 'completed', {
+            await clerk.transition(step.id, 'completed', {
                 resolution: 'Task completed',
             });
         }
         catch (err) {
             if (!isAlreadyTerminalTransitionError(err)) {
                 const message = err instanceof Error ? err.message : String(err);
-                console.warn(`[piece-session] Unexpected error transitioning piece "${piece.id}" ` +
+                console.warn(`[step-session] Unexpected error transitioning step "${step.id}" ` +
                     `to completed: ${message}`);
             }
-            // Swallow — collect() must not throw. The current piece writ status
+            // Swallow — collect() must not throw. The current step writ status
             // will be observed below and included in yields so downstream
             // consumers can see the actual outcome.
         }
-        // Re-read the piece writ after the transition attempt so yields reflect
+        // Re-read the step writ after the transition attempt so yields reflect
         // the observed, authoritative phase — whether the transition succeeded
         // or was caught as already-terminal.
-        let observedPiecePhase;
+        let observedStepPhase;
         try {
-            const observedPiece = await clerk.show(piece.id);
-            observedPiecePhase = observedPiece.phase;
+            const observedStep = await clerk.show(step.id);
+            observedStepPhase = observedStep.phase;
         }
         catch {
             // Writ lookup failure should not propagate out of collect(). Leave
-            // observedPiecePhase undefined so yields omit the field entirely.
+            // observedStepPhase undefined so yields omit the field entirely.
         }
-        // ── Dynamic piece pickup ──────────────────────────────────────────
-        // Check for dynamically added child pieces that don't yet have engines.
-        // Graft new piece-session engines for them so they run after this piece.
+        // ── Dynamic step pickup ──────────────────────────────────────────
+        // Check for dynamically added child steps that don't yet have engines.
+        // Graft new step-session engines for them so they run after this step.
         const openChildren = await clerk.list({
             parentId: mandateWrit.id,
-            type: 'piece',
+            type: 'step',
             phase: 'open',
             limit: 50,
         });
-        // Determine which piece IDs already have engines in the rig
+        // Determine which step IDs already have engines in the rig
         const rigsBook = stacks.readBook('spider', 'rigs');
         const rig = await rigsBook.get(context.rigId);
-        const existingPieceIds = new Set();
+        const existingStepIds = new Set();
         if (rig) {
             for (const engine of rig.engines) {
-                // Piece engines have a literal piece object in givensSpec
-                const enginePiece = engine.givensSpec?.piece;
-                if (enginePiece?.id) {
-                    existingPieceIds.add(enginePiece.id);
+                // Step engines have a literal step object in givensSpec
+                const engineStep = engine.givensSpec?.step;
+                if (engineStep?.id) {
+                    existingStepIds.add(engineStep.id);
                 }
             }
         }
-        // Filter to pieces that don't already have engines
-        const newPieces = openChildren.filter(c => !existingPieceIds.has(c.id));
-        // Build graft entries for new pieces with sequential dependencies
+        // Filter to steps that don't already have engines
+        const newSteps = openChildren.filter(c => !existingStepIds.has(c.id));
+        // Build graft entries for new steps with sequential dependencies
         const graft = [];
         let previousEngineId = context.engineId; // chain starts after this engine
-        for (let i = 0; i < newPieces.length; i++) {
-            const newPiece = newPieces[i];
-            const engineId = `piece-${newPiece.id}`;
+        for (let i = 0; i < newSteps.length; i++) {
+            const newStep = newSteps[i];
+            const engineId = `step-${newStep.id}`;
             graft.push({
                 id: engineId,
-                designId: 'piece-session',
+                designId: 'step-session',
                 upstream: [previousEngineId],
                 givens: {
                     writ: '${writ}',
-                    piece: newPiece, // literal WritDoc — survives resolveGivens/resolveYieldRefs
+                    step: newStep, // literal WritDoc — survives resolveGivens/resolveYieldRefs
                     role: givens.role,
                     cwd: `\${yields.draft.path}`,
                 },
@@ -173,20 +181,20 @@ const pieceSessionEngine = {
         const yields = {
             sessionId,
             sessionStatus: session?.status ?? 'completed',
-            pieceId: piece.id,
-            ...(observedPiecePhase !== undefined ? { pieceStatus: observedPiecePhase } : {}),
+            stepId: step.id,
+            ...(observedStepPhase !== undefined ? { stepStatus: observedStepPhase } : {}),
             ...(session?.output !== undefined ? { output: session.output } : {}),
-            ...(newPieces.length > 0 ? { dynamicPieceIds: newPieces.map(p => p.id) } : {}),
+            ...(newSteps.length > 0 ? { dynamicStepIds: newSteps.map(p => p.id) } : {}),
         };
         if (graft.length > 0) {
-            // graftTail ensures engines downstream of this piece-session (e.g. the
-            // next piece in the original chain, or seal via the original graftTail)
-            // also wait for all dynamically added pieces to complete.
-            const graftTail = `piece-${newPieces[newPieces.length - 1].id}`;
+            // graftTail ensures engines downstream of this step-session (e.g. the
+            // next step in the original chain, or seal via the original graftTail)
+            // also wait for all dynamically added steps to complete.
+            const graftTail = `step-${newSteps[newSteps.length - 1].id}`;
             return { yields, graft, graftTail };
         }
         return yields;
     },
 };
-export default pieceSessionEngine;
-//# sourceMappingURL=piece-session.js.map
+export default stepSessionEngine;
+//# sourceMappingURL=step-session.js.map

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

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

package/dist/index.d.ts

@@ -7,7 +7,7 @@
  * Public types (RigDoc, EngineInstance, CrawlResult, SpiderApi, etc.) are
  * re-exported for consumers that inspect walk results or rig state.
  */
-export type { EngineStatus, EngineInstance, RigStatus, RigDoc, RigView, RigCostSummary, EngineCostSummary, RigFilters, CrawlResult, SpiderApi, SpiderConfig, BlockRecord, BlockType, BlockTypeInfo, CheckResult, DraftYields, SealYields, RigTemplate, RigTemplateEngine, RigTemplateInfo, SpiderEngineRunResult, SpiderCollectResult, InputRequestStatus, InputRequestDoc, ChoiceQuestionSpec, BooleanQuestionSpec, TextQuestionSpec, QuestionSpec, ChoiceAnswer, AnswerValue, SpiderStuckCause, SpiderWritStatus, } from './types.ts';
+export type { EngineStatus, EngineAttempt, EngineInstance, EngineRetryConfig, EngineRetryBackoffConfig, RigStatus, RigDoc, RigView, RigCostSummary, EngineCostSummary, RigFilters, CrawlResult, SpiderApi, SpiderConfig, BlockType, BlockTypeInfo, CheckResult, DraftYields, SealYields, RigTemplate, RigTemplateEngine, RigTemplateInfo, SpiderEngineRunResult, SpiderCollectResult, InputRequestStatus, InputRequestDoc, ChoiceQuestionSpec, BooleanQuestionSpec, TextQuestionSpec, QuestionSpec, ChoiceAnswer, AnswerValue, SpiderStuckCause, SpiderWritStatus, } from './types.ts';
 export type { SpiderKit } from './spider.ts';
 /**
  * Create a fresh Spider apparatus plugin instance.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,MAAM,EACN,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;;AAI3C,wBAA8B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,SAAS,EACT,MAAM,EACN,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;;AAI3C,wBAA8B"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAyC3C,yEAAyE;AAEzE;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,yEAAyE;AAEzE,eAAe,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2C3C,yEAAyE;AAEzE;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,yEAAyE;AAEzE,eAAe,YAAY,EAAE,CAAC"}

package/dist/rig-view.d.ts

@@ -26,6 +26,11 @@ import type { RigDoc, RigView } from './types.ts';
  * snapshots of every engine's session (if any) and summing across them.
  *
  * Does not mutate the rig. Safe to call on every read.
+ *
+ * Per-engine `sessionId` is read from the engine's latest attempt
+ * (`attempts[-1].sessionId`) — the engine no longer carries a scalar
+ * `sessionId` field. Earlier attempts' sessions (pre-retry) are not
+ * currently aggregated; that is a deferred follow-up decision.
  */
 export declare function enrichRigView(rig: RigDoc): Promise<RigView>;
 /**

package/dist/rig-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rig-view.d.ts","sourceRoot":"","sources":["../src/rig-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EAGR,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgFjE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAEvE"}
+{"version":3,"file":"rig-view.d.ts","sourceRoot":"","sources":["../src/rig-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EACV,MAAM,EACN,OAAO,EAGR,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmFjE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAEvE"}

package/dist/rig-view.js

@@ -26,6 +26,11 @@ import { guild } from '@shardworks/nexus-core';
  * snapshots of every engine's session (if any) and summing across them.
  *
  * Does not mutate the rig. Safe to call on every read.
+ *
+ * Per-engine `sessionId` is read from the engine's latest attempt
+ * (`attempts[-1].sessionId`) — the engine no longer carries a scalar
+ * `sessionId` field. Earlier attempts' sessions (pre-retry) are not
+ * currently aggregated; that is a deferred follow-up decision.
  */
 export async function enrichRigView(rig) {
     // Look up the writ title from the clerk/writs book. Direct book read —
@@ -39,8 +44,12 @@ export async function enrichRigView(rig) {
     // Collect (engineId, sessionId) pairs to look up.
     const pairs = [];
     for (const engine of rig.engines || []) {
-        if (engine.sessionId) {
-            pairs.push({ engineId: engine.id, sessionId: engine.sessionId });
+        const attempts = engine.attempts ?? [];
+        if (attempts.length === 0)
+            continue;
+        const tail = attempts[attempts.length - 1];
+        if (tail.sessionId) {
+            pairs.push({ engineId: engine.id, sessionId: tail.sessionId });
         }
     }
     // No engines with sessions: no cost data to report — but still attach

package/dist/rig-view.js.map

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

package/dist/spider-test-fixture.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Shared fixture module for Spider unit tests.
+ *
+ * Houses the canonical `buildFixture` integration harness and its
+ * module-scope helper dependencies, originally co-located with the
+ * monolithic `spider.test.ts`. The split into per-feature test files
+ * relocates these helpers here so each split file imports only the
+ * helpers it actually uses.
+ *
+ * The file name does not match the `*.test.ts` glob, so the test runner
+ * never picks it up directly. Production source is imported directly
+ * from the original packages — this module deliberately does NOT
+ * re-export production symbols (no barrel pattern).
+ */
+import type { GuildConfig, LoadedKit, LoadedApparatus, StartupContext, KitEntry } from '@shardworks/nexus-core';
+import { MemoryBackend } from '@shardworks/stacks-apparatus/testing';
+import type { StacksApi } from '@shardworks/stacks-apparatus';
+import type { ClerkApi, WritDoc, WritTypeConfig } from '@shardworks/clerk-apparatus';
+import type { FabricatorApi } from '@shardworks/fabricator-apparatus';
+import type { SummonRequest } from '@shardworks/animator-apparatus';
+import type { SpiderApi, RigDoc, EngineInstance, EngineAttempt, RigTemplate } from './types.ts';
+/**
+ * Return the latest attempt row (tail of `attempts[]`) for the given engine,
+ * or undefined if the engine has never been dispatched. Tests read
+ * session id / yields / error / timestamps from this row (the scalar
+ * engine-level fields no longer exist).
+ */
+export declare function latestAttempt(engine: EngineInstance): EngineAttempt | undefined;
+export declare const STANDARD_TEMPLATE: RigTemplate;
+export declare const FRAMEWORK_KIT_FIELDS: Set<string>;
+export declare function buildKitEntries(kits: LoadedKit[], apparatuses: LoadedApparatus[]): KitEntry[];
+/**
+ * Build a minimal StartupContext that captures and fires events.
+ */
+export declare function buildCtx(kitEntries?: KitEntry[]): {
+    ctx: StartupContext;
+    fire: (event: string, ...args: unknown[]) => Promise<void>;
+};
+/**
+ * Splice test-supplied custom engines into a copy of Spider's apparatus
+ * supportKit. Matching is by engine id — if `customEngines` contains an
+ * engine whose id matches one of Spider's built-in engines, that built-in is
+ * replaced rather than registered alongside (which would violate the
+ * Fabricator's kit-vs-kit uniqueness rule). Engines with new ids are
+ * appended. Returns the same apparatus object unmodified when there are no
+ * custom engines.
+ */
+export declare function mergeCustomEnginesIntoSpider(spiderApparatus: LoadedApparatus['apparatus'], customEngines: Record<string, unknown> | undefined): LoadedApparatus['apparatus'];
+/**
+ * Full integration fixture: starts Stacks (memory), Clerk, Fabricator,
+ * and Spider. Returns handles to each API plus mock animator controls.
+ */
+export declare function buildFixture(guildConfig?: Partial<GuildConfig>, initialSessionOutcome?: {
+    status: 'completed' | 'failed';
+    error?: string;
+    output?: string;
+}, extra?: {
+    kits?: LoadedKit[];
+    apparatuses?: LoadedApparatus[];
+    customEngines?: Record<string, unknown>;
+    /**
+     * Additional writ-type configs to register with the Clerk after its
+     * `start()` returns. The legacy `clerk.writTypes` guild-config channel
+     * and kit-channel scan have both been retired; tests that need
+     * non-mandate writ types register them here. Each config is a full
+     * `WritTypeConfig`; common test types (`triage`, `audit`) clone
+     * mandate's six-state machine.
+     */
+    extraWritTypes?: WritTypeConfig[];
+}): {
+    stacks: StacksApi;
+    clerk: ClerkApi;
+    realClerk: ClerkApi;
+    fabricator: FabricatorApi;
+    spider: SpiderApi;
+    memBackend: InstanceType<typeof MemoryBackend>;
+    fire: (event: string, ...args: unknown[]) => Promise<void>;
+    spiderFire: (event: string, ...args: unknown[]) => Promise<void>;
+    summonCalls: SummonRequest[];
+    cancelCalls: Array<{
+        sessionId: string;
+        options?: {
+            reason?: string;
+        };
+    }>;
+    setSessionOutcome: (outcome: {
+        status: 'completed' | 'failed';
+        error?: string;
+        output?: string;
+    }) => void;
+};
+/** Get the rigs book. */
+export declare function rigsBook(stacks: StacksApi): import("@shardworks/stacks-apparatus").Book<RigDoc>;
+/**
+ * Build a `WritTypeConfig` that clones mandate's six-state machine under a
+ * different name. Used by tests that previously declared throwaway writ
+ * types via the legacy `clerk.writTypes` guild-config channel.
+ */
+export declare function mandateLikeWritType(name: string): WritTypeConfig;
+/**
+ * Post a mandate writ. The fixture's clerk wrapper auto-publishes mandate
+ * writs to `open`, so this helper is now a thin convenience that just sets
+ * a default title and body. (The auto-publish lives in the wrapper, not
+ * this helper, so callers that go through `fix.clerk.post(...)` directly
+ * get the same `open`-on-arrival behaviour.)
+ */
+export declare function postWrit(clerk: ClerkApi, title?: string, codex?: string): Promise<WritDoc>;
+/**
+ * Assert that a rig's terminalAt field is a valid ISO timestamp. Used by
+ * rig terminal-transition tests to pin the invariant that any rig reaching
+ * a terminal status also records the terminal-event timestamp.
+ */
+export declare function assertTerminalAt(rig: {
+    terminalAt?: string;
+} | null | undefined, msg?: string): void;
+//# sourceMappingURL=spider-test-fixture.d.ts.map

package/dist/spider-test-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spider-test-fixture.d.ts","sourceRoot":"","sources":["../src/spider-test-fixture.ts"],"names":[],"mappings":"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"}