@shardworks/spider-apparatus 0.1.115

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Sean Boots
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/dist/engines/draft.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Draft engine — clockwork.
+ *
+ * Opens a draft binding via the Scriptorium. Returns DraftYields
+ * containing the worktree path and branch name for downstream engines.
+ */
+import type { EngineDesign } from '@shardworks/fabricator-apparatus';
+declare const draftEngine: EngineDesign;
+export default draftEngine;
+//# sourceMappingURL=draft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../src/engines/draft.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE,QAAA,MAAM,WAAW,EAAE,YA8BlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/engines/draft.js

@@ -0,0 +1,33 @@
+/**
+ * Draft engine — clockwork.
+ *
+ * Opens a draft binding via the Scriptorium. Returns DraftYields
+ * containing the worktree path and branch name for downstream engines.
+ */
+import { execSync } from 'node:child_process';
+import { guild } from '@shardworks/nexus-core';
+const draftEngine = {
+    id: 'draft',
+    async run(givens, _context) {
+        const scriptorium = guild().apparatus('codexes');
+        const writ = givens.writ;
+        if (!writ.codex) {
+            throw new Error(`Writ "${writ.id}" has no codex — cannot open a draft binding.`);
+        }
+        const draft = await scriptorium.openDraft({
+            codexName: writ.codex,
+            associatedWith: writ.id,
+        });
+        const baseSha = execSync('git rev-parse HEAD', { cwd: draft.path, encoding: 'utf-8' }).trim();
+        const yields = {
+            draftId: draft.id,
+            codexName: draft.codexName,
+            branch: draft.branch,
+            path: draft.path,
+            baseSha,
+        };
+        return { status: 'completed', yields };
+    },
+};
+export default draftEngine;
+//# sourceMappingURL=draft.js.map

package/dist/engines/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../../src/engines/draft.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C,MAAM,WAAW,GAAiB;IAChC,EAAE,EAAE,OAAO;IAEX,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ;QACxB,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAe,CAAC;QAEpC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,CAAC,EAAE,+CAA+C,CAChE,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC;YACxC,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,cAAc,EAAE,IAAI,CAAC,EAAE;SACxB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9F,MAAM,MAAM,GAAgB;YAC1B,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO;SACR,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;CACF,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/engines/implement.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Implement engine — quick (Animator-backed).
+ *
+ * Summons an anima to do the commissioned work. Wraps the writ body with
+ * a commit instruction, then calls animator.summon() with the draft
+ * worktree as the working directory. Returns `{ status: 'launched', sessionId }`
+ * so the Spider's collect step can poll for completion on subsequent walks.
+ */
+import type { EngineDesign } from '@shardworks/fabricator-apparatus';
+declare const implementEngine: EngineDesign;
+export default implementEngine;
+//# sourceMappingURL=implement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAKrE,QAAA,MAAM,eAAe,EAAE,YAqBtB,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/engines/implement.js

@@ -0,0 +1,29 @@
+/**
+ * Implement engine — quick (Animator-backed).
+ *
+ * Summons an anima to do the commissioned work. Wraps the writ body with
+ * a commit instruction, then calls animator.summon() with the draft
+ * worktree as the working directory. Returns `{ status: 'launched', sessionId }`
+ * so the Spider's collect step can poll for completion on subsequent walks.
+ */
+import { guild } from '@shardworks/nexus-core';
+const implementEngine = {
+    id: 'implement',
+    async run(givens, context) {
+        const animator = guild().apparatus('animator');
+        const writ = givens.writ;
+        const draft = context.upstream['draft'];
+        const prompt = `${writ.body}\n\nCommit all changes before ending your session.`;
+        const handle = animator.summon({
+            role: givens.role,
+            prompt,
+            cwd: draft.path,
+            environment: { GIT_AUTHOR_EMAIL: `${writ.id}@nexus.local` },
+            metadata: { engineId: context.engineId, writId: writ.id },
+        });
+        const sessionResult = await handle.result;
+        return { status: 'launched', sessionId: sessionResult.id };
+    },
+};
+export default implementEngine;
+//# sourceMappingURL=implement.js.map

package/dist/engines/implement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement.js","sourceRoot":"","sources":["../../src/engines/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAM/C,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,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,oDAAoD,CAAC;QAEhF,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,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;QAC1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/engines/index.d.ts

@@ -0,0 +1,6 @@
+export { default as draftEngine } from './draft.ts';
+export { default as implementEngine } from './implement.ts';
+export { default as reviewEngine } from './review.ts';
+export { default as reviseEngine } from './revise.ts';
+export { default as sealEngine } from './seal.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,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

@@ -0,0 +1,6 @@
+export { default as draftEngine } from "./draft.js";
+export { default as implementEngine } from "./implement.js";
+export { default as reviewEngine } from "./review.js";
+export { default as reviseEngine } from "./revise.js";
+export { default as sealEngine } from "./seal.js";
+//# sourceMappingURL=index.js.map

package/dist/engines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,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

@@ -0,0 +1,17 @@
+/**
+ * Review engine — quick (Animator-backed).
+ *
+ * Runs mechanical checks (build/test) synchronously in the draft worktree,
+ * then summons a reviewer anima to assess the implementation against the spec.
+ * Returns `{ status: 'launched', sessionId }` so the Spider's collect step
+ * can parse the reviewer's findings from session.output on subsequent walks.
+ *
+ * Collect step (Spider):
+ *   - Reads session.output as the reviewer's structured markdown findings
+ *   - Parses `passed` from /^###\s*Overall:\s*PASS/mi
+ *   - Retrieves mechanicalChecks from session.metadata
+ */
+import type { EngineDesign } from '@shardworks/fabricator-apparatus';
+declare const reviewEngine: EngineDesign;
+export default reviewEngine;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +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;AAgGrE,QAAA,MAAM,YAAY,EAAE,YAuCnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/review.js

@@ -0,0 +1,140 @@
+/**
+ * Review engine — quick (Animator-backed).
+ *
+ * Runs mechanical checks (build/test) synchronously in the draft worktree,
+ * then summons a reviewer anima to assess the implementation against the spec.
+ * Returns `{ status: 'launched', sessionId }` so the Spider's collect step
+ * can parse the reviewer's findings from session.output on subsequent walks.
+ *
+ * Collect step (Spider):
+ *   - Reads session.output as the reviewer's structured markdown findings
+ *   - Parses `passed` from /^###\s*Overall:\s*PASS/mi
+ *   - Retrieves mechanicalChecks from session.metadata
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { guild } from '@shardworks/nexus-core';
+const execFileAsync = promisify(execFile);
+async function runCheck(name, command, cwd) {
+    const start = Date.now();
+    try {
+        const { stdout, stderr } = await execFileAsync('sh', ['-c', command], { cwd });
+        const output = (stdout + stderr).slice(0, 4096);
+        return { name, passed: true, output, durationMs: Date.now() - start };
+    }
+    catch (err) {
+        const execErr = err;
+        const output = ((execErr.stdout ?? '') + (execErr.stderr ?? '')).slice(0, 4096);
+        return { name, passed: false, output, durationMs: Date.now() - start };
+    }
+}
+async function gitDiff(cwd, baseSha) {
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', `${baseSha}..HEAD`], { cwd });
+        return stdout;
+    }
+    catch {
+        return '';
+    }
+}
+async function gitStatus(cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', ['status', '--porcelain'], { cwd });
+        return stdout;
+    }
+    catch {
+        return '';
+    }
+}
+function assembleReviewPrompt(writ, diff, status, checks) {
+    const checksSection = checks.length === 0
+        ? '(No mechanical checks configured.)'
+        : checks.map((c) => `### ${c.name}: ${c.passed ? 'PASSED' : 'FAILED'}\n\`\`\`\n${c.output}\n\`\`\``).join('\n\n');
+    return `# Code Review
+
+You are reviewing work on a commission. Your job is to assess whether the
+implementation satisfies the spec, identify any gaps or problems, and produce
+a structured findings document.
+
+## The Commission (Spec)
+
+${writ.body}
+
+## Implementation Diff
+
+Changes since the draft was opened:
+
+\`\`\`diff
+${diff}
+\`\`\`
+
+## Current Worktree State
+
+\`\`\`
+${status}
+\`\`\`
+
+## Mechanical Check Results
+
+${checksSection}
+
+## Instructions
+
+Assess the implementation against the spec. Produce your findings in this format:
+
+### Overall: PASS or FAIL
+
+### Completeness
+- Which spec requirements are addressed?
+- Which are missing or partially addressed?
+
+### Correctness
+- Are there bugs, logic errors, or regressions?
+- Do the tests pass? If not, what fails?
+
+### Quality
+- Code style consistent with the codebase?
+- Appropriate test coverage for new code?
+- Any concerns about the approach?
+
+### Required Changes (if FAIL)
+Numbered list of specific changes needed, in priority order.
+
+Produce your findings as your final message in the format above.`;
+}
+const reviewEngine = {
+    id: 'review',
+    async run(givens, context) {
+        const animator = guild().apparatus('animator');
+        const writ = givens.writ;
+        const draft = context.upstream['draft'];
+        // 1. Run mechanical checks synchronously before the reviewer session
+        const checks = [];
+        if (givens.buildCommand) {
+            checks.push(await runCheck('build', givens.buildCommand, draft.path));
+        }
+        if (givens.testCommand) {
+            checks.push(await runCheck('test', givens.testCommand, draft.path));
+        }
+        // 2. Compute diff since draft opened and current worktree state
+        const diff = await gitDiff(draft.path, draft.baseSha);
+        const status = await gitStatus(draft.path);
+        // 3. Assemble review prompt
+        const prompt = assembleReviewPrompt(writ, diff, status, checks);
+        // 4. Launch reviewer session — stash mechanicalChecks in metadata for collect step
+        const handle = animator.summon({
+            role: givens.role,
+            prompt,
+            cwd: draft.path,
+            metadata: {
+                engineId: context.engineId,
+                writId: writ.id,
+                mechanicalChecks: checks,
+            },
+        });
+        const sessionResult = await handle.result;
+        return { status: 'launched', sessionId: sessionResult.id };
+    },
+};
+export default reviewEngine;
+//# sourceMappingURL=review.js.map

package/dist/engines/review.js.map

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

package/dist/engines/revise.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Revise engine — quick (Animator-backed).
+ *
+ * Summons an anima to address review findings. If the review passed, the
+ * prompt instructs the anima to confirm and exit without unnecessary changes.
+ * If the review failed, the prompt directs the anima to address each item
+ * in the findings and commit the result.
+ *
+ * Returns `{ status: 'launched', sessionId }` so the Spider's collect step
+ * can store ReviseYields on completion.
+ */
+import type { EngineDesign } from '@shardworks/fabricator-apparatus';
+declare const reviseEngine: EngineDesign;
+export default reviseEngine;
+//# sourceMappingURL=revise.d.ts.map

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

@@ -0,0 +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,YAwBnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/revise.js

@@ -0,0 +1,90 @@
+/**
+ * Revise engine — quick (Animator-backed).
+ *
+ * Summons an anima to address review findings. If the review passed, the
+ * prompt instructs the anima to confirm and exit without unnecessary changes.
+ * If the review failed, the prompt directs the anima to address each item
+ * in the findings and commit the result.
+ *
+ * Returns `{ status: 'launched', sessionId }` so the Spider's collect step
+ * can store ReviseYields on completion.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { guild } from '@shardworks/nexus-core';
+const execFileAsync = promisify(execFile);
+async function gitStatus(cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', ['status', '--porcelain'], { cwd });
+        return stdout;
+    }
+    catch {
+        return '';
+    }
+}
+async function gitDiffUncommitted(cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', ['diff', 'HEAD'], { cwd });
+        return stdout;
+    }
+    catch {
+        return '';
+    }
+}
+function assembleRevisionPrompt(writ, review, status, diff) {
+    const reviewResult = review.passed ? 'PASS' : 'FAIL';
+    const instructions = review.passed
+        ? `The review passed. No changes are required. Confirm the work looks correct\nand exit. Do not make unnecessary changes or spend unnecessary time reassessing.`
+        : `The review identified issues that need to be addressed. See "Required Changes"\nin the findings above. Address each item, then commit your changes.`;
+    const diffSection = diff.trim()
+        ? `\`\`\`diff\n${diff}\n\`\`\``
+        : '(No uncommitted changes.)';
+    return `# Revision Pass
+
+You are revising prior work on a commission based on review findings.
+
+## The Commission (Spec)
+
+${writ.body}
+
+## Review Findings
+
+${review.findings}
+
+## Review Result: ${reviewResult}
+
+${instructions}
+
+## Current State
+
+\`\`\`
+${status}
+\`\`\`
+
+${diffSection}
+
+Commit all changes before ending your session.`;
+}
+const reviseEngine = {
+    id: 'revise',
+    async run(givens, context) {
+        const animator = guild().apparatus('animator');
+        const writ = givens.writ;
+        const draft = context.upstream['draft'];
+        const review = context.upstream['review'];
+        const status = await gitStatus(draft.path);
+        const diff = await gitDiffUncommitted(draft.path);
+        const prompt = assembleRevisionPrompt(writ, review, status, diff);
+        const handle = animator.summon({
+            role: givens.role,
+            prompt,
+            cwd: draft.path,
+            environment: { GIT_AUTHOR_EMAIL: `${writ.id}@nexus.local` },
+            metadata: { engineId: context.engineId, writId: writ.id },
+        });
+        const sessionResult = await handle.result;
+        return { status: 'launched', sessionId: sessionResult.id };
+    },
+};
+export default reviseEngine;
+//# sourceMappingURL=revise.js.map

package/dist/engines/revise.js.map

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

package/dist/engines/seal.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Seal engine — clockwork.
+ *
+ * Seals the draft binding via the Scriptorium. Reads the draft branch
+ * from context.upstream['draft'] (the DraftYields from the draft engine).
+ * Returns SealYields with the sealed commit info.
+ */
+import type { EngineDesign } from '@shardworks/fabricator-apparatus';
+declare const sealEngine: EngineDesign;
+export default sealEngine;
+//# sourceMappingURL=seal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seal.d.ts","sourceRoot":"","sources":["../../src/engines/seal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAIrE,QAAA,MAAM,UAAU,EAAE,YAyBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/engines/seal.js

@@ -0,0 +1,31 @@
+/**
+ * Seal engine — clockwork.
+ *
+ * Seals the draft binding via the Scriptorium. Reads the draft branch
+ * from context.upstream['draft'] (the DraftYields from the draft engine).
+ * Returns SealYields with the sealed commit info.
+ */
+import { guild } from '@shardworks/nexus-core';
+const sealEngine = {
+    id: 'seal',
+    async run(_givens, context) {
+        const scriptorium = guild().apparatus('codexes');
+        const draftYields = context.upstream['draft'];
+        if (!draftYields) {
+            throw new Error('Seal engine requires draft yields in context.upstream but none found.');
+        }
+        const result = await scriptorium.seal({
+            codexName: draftYields.codexName,
+            sourceBranch: draftYields.branch,
+        });
+        const yields = {
+            sealedCommit: result.sealedCommit,
+            strategy: result.strategy,
+            retries: result.retries,
+            inscriptionsSealed: result.inscriptionsSealed,
+        };
+        return { status: 'completed', yields };
+    },
+};
+export default sealEngine;
+//# sourceMappingURL=seal.js.map

package/dist/engines/seal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seal.js","sourceRoot":"","sources":["../../src/engines/seal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAK/C,MAAM,UAAU,GAAiB;IAC/B,EAAE,EAAE,MAAM;IAEV,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO;QACxB,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B,CAAC;QAEzE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC;YACpC,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,YAAY,EAAE,WAAW,CAAC,MAAM;SACjC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAe;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;SAC9C,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;CACF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @shardworks/spider-apparatus — The Spider.
+ *
+ * Rig execution engine: spawns rigs for ready writs, drives engine pipelines
+ * to completion, and transitions writs via the Clerk on rig completion/failure.
+ *
+ * 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, CrawlResult, SpiderApi, SpiderConfig, DraftYields, SealYields, } from './types.ts';
+declare const _default: import("@shardworks/nexus-core").Plugin;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;;AAIpB,wBAA8B"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @shardworks/spider-apparatus — The Spider.
+ *
+ * Rig execution engine: spawns rigs for ready writs, drives engine pipelines
+ * to completion, and transitions writs via the Clerk on rig completion/failure.
+ *
+ * Public types (RigDoc, EngineInstance, CrawlResult, SpiderApi, etc.) are
+ * re-exported for consumers that inspect walk results or rig state.
+ */
+import { createSpider } from "./spider.js";
+// ── Default export: the apparatus plugin ──────────────────────────────
+export default createSpider();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/spider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The Spider — rig execution engine apparatus.
+ *
+ * The Spider drives writ-to-completion by managing rigs: ordered pipelines
+ * of engine instances. Each crawl() call performs one unit of work:
+ *
+ *   collect > run > spawn   (priority order)
+ *
+ * collect — check running engines for terminal session results
+ * run     — execute the next pending engine (clockwork inline, quick → launch)
+ * spawn   — create a new rig for a ready writ with no existing rig
+ *
+ * CDC on the rigs book (Phase 1 cascade) transitions the associated writ
+ * when a rig reaches a terminal state (completed or failed).
+ *
+ * See: docs/architecture/apparatus/spider.md
+ */
+import type { Plugin } from '@shardworks/nexus-core';
+export declare function createSpider(): Plugin;
+//# sourceMappingURL=spider.d.ts.map

package/dist/spider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spider.d.ts","sourceRoot":"","sources":["../src/spider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AA+FrE,wBAAgB,YAAY,IAAI,MAAM,CA8TrC"}