@shardworks/walker-apparatus 0.1.113

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 Walker'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 Walker'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,11 @@
+/**
+ * Review engine — stub (Increment 1).
+ *
+ * Returns a completed result with mock yields so the full pipeline can be
+ * tested end-to-end. Increment 3 replaces this with real Animator-backed
+ * quick engine execution.
+ */
+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;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,QAAA,MAAM,YAAY,EAAE,YAcnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/review.js

@@ -0,0 +1,23 @@
+/**
+ * Review engine — stub (Increment 1).
+ *
+ * Returns a completed result with mock yields so the full pipeline can be
+ * tested end-to-end. Increment 3 replaces this with real Animator-backed
+ * quick engine execution.
+ */
+const reviewEngine = {
+    id: 'review',
+    async run(_givens, _context) {
+        return {
+            status: 'completed',
+            yields: {
+                sessionId: 'stub',
+                passed: true,
+                findings: 'Stub review — no findings.',
+                mechanicalChecks: [],
+            },
+        };
+    },
+};
+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":"AAAA;;;;;;GAMG;AAIH,MAAM,YAAY,GAAiB;IACjC,EAAE,EAAE,QAAQ;IAEZ,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ;QACzB,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;gBACN,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,4BAA4B;gBACtC,gBAAgB,EAAE,EAAE;aACrB;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/revise.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Revise engine — stub (Increment 1).
+ *
+ * Returns a completed result with mock yields so the full pipeline can be
+ * tested end-to-end. Increment 3 replaces this with real Animator-backed
+ * quick engine execution.
+ */
+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;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE,QAAA,MAAM,YAAY,EAAE,YAYnB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/engines/revise.js

@@ -0,0 +1,21 @@
+/**
+ * Revise engine — stub (Increment 1).
+ *
+ * Returns a completed result with mock yields so the full pipeline can be
+ * tested end-to-end. Increment 3 replaces this with real Animator-backed
+ * quick engine execution.
+ */
+const reviseEngine = {
+    id: 'revise',
+    async run(_givens, _context) {
+        return {
+            status: 'completed',
+            yields: {
+                sessionId: 'stub',
+                sessionStatus: 'completed',
+            },
+        };
+    },
+};
+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":"AAAA;;;;;;GAMG;AAIH,MAAM,YAAY,GAAiB;IACjC,EAAE,EAAE,QAAQ;IAEZ,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ;QACzB,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE;gBACN,SAAS,EAAE,MAAM;gBACjB,aAAa,EAAE,WAAW;aAC3B;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,YAAY,CAAC"}

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/walker-apparatus — The Walker.
+ *
+ * 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, WalkResult, WalkerApi, etc.) are
+ * re-exported for consumers that inspect walk results or rig state.
+ */
+export type { EngineStatus, EngineInstance, RigStatus, RigDoc, WalkResult, WalkerApi, WalkerConfig, 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,UAAU,EACV,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;;AAIpB,wBAA8B"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @shardworks/walker-apparatus — The Walker.
+ *
+ * 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, WalkResult, WalkerApi, etc.) are
+ * re-exported for consumers that inspect walk results or rig state.
+ */
+import { createWalker } from "./walker.js";
+// ── Default export: the apparatus plugin ──────────────────────────────
+export default createWalker();
+//# 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/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { default as walkTool } from './walk.ts';
+export { default as walkContinualTool } from './walk-continual.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export { default as walkTool } from "./walk.js";
+export { default as walkContinualTool } from "./walk-continual.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/tools/walk-continual.d.ts

@@ -0,0 +1,13 @@
+/**
+ * walkContinual tool — runs the walk loop continuously.
+ *
+ * Polls walk() on a configurable interval until stopped or no remaining
+ * work exists for the configured number of consecutive idle cycles.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    maxIdleCycles: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+}>;
+export default _default;
+//# sourceMappingURL=walk-continual.d.ts.map

package/dist/tools/walk-continual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-continual.d.ts","sourceRoot":"","sources":["../../src/tools/walk-continual.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;AAKxB,wBA0DG"}

package/dist/tools/walk-continual.js

@@ -0,0 +1,63 @@
+/**
+ * walkContinual tool — runs the walk loop continuously.
+ *
+ * Polls walk() on a configurable interval until stopped or no remaining
+ * work exists for the configured number of consecutive idle cycles.
+ */
+import { z } from 'zod';
+import { guild } from '@shardworks/nexus-core';
+import { tool } from '@shardworks/tools-apparatus';
+export default tool({
+    name: 'walkContinual',
+    description: 'Run the Walker loop continuously until idle',
+    instructions: 'Polls walk() in a loop, sleeping between steps when idle. ' +
+        'Stops when the configured number of consecutive idle cycles is reached. ' +
+        'Returns a summary of all actions taken.',
+    params: {
+        maxIdleCycles: z
+            .number()
+            .optional()
+            .default(3)
+            .describe('Number of consecutive idle walk() calls before stopping (default: 3)'),
+        pollIntervalMs: z
+            .number()
+            .optional()
+            .describe('Override the configured poll interval in milliseconds'),
+    },
+    permission: 'walker:write',
+    handler: async (params) => {
+        const g = guild();
+        const walker = g.apparatus('walker');
+        const config = g.guildConfig().walker ?? {};
+        const intervalMs = params.pollIntervalMs ?? config.pollIntervalMs ?? 5000;
+        const maxIdle = params.maxIdleCycles;
+        const actions = [];
+        let idleCount = 0;
+        while (idleCount < maxIdle) {
+            let result;
+            try {
+                result = await walker.walk();
+            }
+            catch (err) {
+                console.error('[walkContinual] walk() error:', err instanceof Error ? err.message : String(err));
+                idleCount++;
+                if (idleCount < maxIdle) {
+                    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+                }
+                continue;
+            }
+            if (result === null) {
+                idleCount++;
+                if (idleCount < maxIdle) {
+                    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+                }
+            }
+            else {
+                idleCount = 0;
+                actions.push(result);
+            }
+        }
+        return { actions, totalActions: actions.length };
+    },
+});
+//# sourceMappingURL=walk-continual.js.map

package/dist/tools/walk-continual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-continual.js","sourceRoot":"","sources":["../../src/tools/walk-continual.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnD,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,6CAA6C;IAC1D,YAAY,EACV,4DAA4D;QAC5D,0EAA0E;QAC1E,yCAAyC;IAC3C,MAAM,EAAE;QACN,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CACP,sEAAsE,CACvE;QACH,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,uDAAuD,CACxD;KACJ;IACD,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,IAAI,EAAkB,CAAC;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;QAErC,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,IAAI,SAAS,GAAG,CAAC,CAAC;QAElB,OAAO,SAAS,GAAG,OAAO,EAAE,CAAC;YAC3B,IAAI,MAA+C,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjG,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;oBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBACxE,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;oBACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,CAAC,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/walk.d.ts

@@ -0,0 +1,9 @@
+/**
+ * walk tool — executes a single step of the walk loop.
+ *
+ * Returns the WalkResult or null (idle) from one walk() call.
+ * Useful for manual step-through or testing.
+ */
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{}>;
+export default _default;
+//# sourceMappingURL=walk.d.ts.map

package/dist/tools/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/tools/walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;AAMH,wBAaG"}

package/dist/tools/walk.js

@@ -0,0 +1,22 @@
+/**
+ * walk tool — executes a single step of the walk loop.
+ *
+ * Returns the WalkResult or null (idle) from one walk() call.
+ * Useful for manual step-through or testing.
+ */
+import { guild } from '@shardworks/nexus-core';
+import { tool } from '@shardworks/tools-apparatus';
+export default tool({
+    name: 'walk',
+    description: 'Execute one step of the Walker loop',
+    instructions: 'Runs a single walk() step: collect a pending session result, run the next ' +
+        'ready engine, or spawn a rig for a ready writ — in that priority order. ' +
+        'Returns the action taken, or null if there is nothing to do.',
+    params: {},
+    permission: 'walker:write',
+    handler: async () => {
+        const walker = guild().apparatus('walker');
+        return walker.walk();
+    },
+});
+//# sourceMappingURL=walk.js.map

package/dist/tools/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/tools/walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAGnD,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,qCAAqC;IAClD,YAAY,EACV,4EAA4E;QAC5E,0EAA0E;QAC1E,8DAA8D;IAChE,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,cAAc;IAC1B,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,SAAS,CAAY,QAAQ,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * The Walker — public types.
+ *
+ * Rig and engine data model, WalkResult, WalkerApi, and configuration.
+ * Engine yield shapes (DraftYields, SealYields) live here too so downstream
+ * packages can import them without depending on the engine implementation files.
+ */
+export type EngineStatus = 'pending' | 'running' | 'completed' | 'failed';
+/**
+ * A single engine slot within a rig.
+ *
+ * `id` is the engine's position identifier (e.g. 'draft', 'implement').
+ * For the static pipeline it matches `designId`.
+ *
+ * `givensSpec` holds literal values set at spawn time (writ, role, commands).
+ * The Walker assembles `givens` from this directly; upstream yields arrive
+ * via `context.upstream` as the escape hatch.
+ */
+export interface EngineInstance {
+    /** Unique identifier within the rig (e.g. 'draft', 'implement'). */
+    id: string;
+    /** The engine design to look up in the Fabricator. */
+    designId: string;
+    /** Current execution status. */
+    status: EngineStatus;
+    /** Engine IDs that must be completed before this engine can run. */
+    upstream: string[];
+    /** Literal givens values set at rig spawn time. */
+    givensSpec: Record<string, unknown>;
+    /** Yields from a completed engine run (JSON-serializable). */
+    yields?: unknown;
+    /** Error message if this engine failed. */
+    error?: string;
+    /** Session ID from a launched quick engine, used by the collect step. */
+    sessionId?: string;
+    /** ISO timestamp when execution started. */
+    startedAt?: string;
+    /** ISO timestamp when execution completed (or failed). */
+    completedAt?: string;
+}
+export type RigStatus = 'running' | 'completed' | 'failed';
+/**
+ * A rig — the execution context for a single writ.
+ *
+ * Stored in The Stacks (`walker/rigs` book). The `engines` array is the
+ * ordered pipeline of engine instances. The Walker updates this document
+ * in-place as engines run and complete.
+ */
+export interface RigDoc {
+    /** Index signature required to satisfy BookEntry constraint. */
+    [key: string]: unknown;
+    /** Unique rig id. */
+    id: string;
+    /** The writ this rig is executing. */
+    writId: string;
+    /** Current rig status. */
+    status: RigStatus;
+    /** Ordered engine pipeline. */
+    engines: EngineInstance[];
+}
+/**
+ * The result of a single walk() call.
+ *
+ * Four variants, ordered by priority:
+ * - 'engine-completed' — an engine finished (collected or ran inline); rig still running
+ * - 'engine-started'   — launched a quick engine's session
+ * - 'rig-spawned'      — created a new rig for a ready writ
+ * - 'rig-completed'    — the walk step caused a rig to reach a terminal state
+ *
+ * null means no work was available.
+ */
+export type WalkResult = {
+    action: 'engine-completed';
+    rigId: string;
+    engineId: string;
+} | {
+    action: 'engine-started';
+    rigId: string;
+    engineId: string;
+} | {
+    action: 'rig-spawned';
+    rigId: string;
+    writId: string;
+} | {
+    action: 'rig-completed';
+    rigId: string;
+    writId: string;
+    outcome: 'completed' | 'failed';
+};
+/**
+ * The Walker's public API — retrieved via guild().apparatus<WalkerApi>('walker').
+ */
+export interface WalkerApi {
+    /**
+     * Execute one step of the walk loop.
+     *
+     * Priority ordering: collect > run > spawn.
+     * Returns null when no work is available.
+     */
+    walk(): Promise<WalkResult | null>;
+}
+/**
+ * Walker apparatus configuration — lives under the `walker` key in guild.json.
+ */
+export interface WalkerConfig {
+    /**
+     * Role to summon for quick engine sessions.
+     * Default: 'artificer'.
+     */
+    role?: string;
+    /**
+     * Polling interval for walkContinual tool (milliseconds).
+     * Default: 5000.
+     */
+    pollIntervalMs?: number;
+    /**
+     * Build command to pass to quick engines.
+     */
+    buildCommand?: string;
+    /**
+     * Test command to pass to quick engines.
+     */
+    testCommand?: string;
+}
+/**
+ * Yields from the `draft` clockwork engine.
+ * The Walker stores these in the engine instance and passes them
+ * to downstream engines via context.upstream['draft'].
+ */
+export interface DraftYields {
+    /** The draft's unique id. */
+    draftId: string;
+    /** Codex this draft belongs to. */
+    codexName: string;
+    /** Git branch name for the draft. */
+    branch: string;
+    /** Absolute filesystem path to the draft's worktree. */
+    path: string;
+    /** HEAD commit SHA at the time the draft was opened. Used by review engine to compute diffs. */
+    baseSha: string;
+}
+/**
+ * Yields from the `seal` clockwork engine.
+ */
+export interface SealYields {
+    /** The commit SHA at head of the target branch after sealing. */
+    sealedCommit: string;
+    /** Git strategy used. */
+    strategy: 'fast-forward' | 'rebase';
+    /** Number of retry attempts. */
+    retries: number;
+    /** Number of inscriptions (commits) sealed. */
+    inscriptionsSealed: number;
+}
+/**
+ * Yields from the `implement` quick engine.
+ * Set by the Walker's collect step when the Animator session completes.
+ */
+export interface ImplementYields {
+    /** The Animator session id. */
+    sessionId: string;
+    /** Terminal status of the session. */
+    sessionStatus: 'completed' | 'failed';
+}
+declare module '@shardworks/nexus-core' {
+    interface GuildConfig {
+        walker?: WalkerConfig;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * The Walker — public types.
+ *
+ * Rig and engine data model, WalkResult, WalkerApi, and configuration.
+ * Engine yield shapes (DraftYields, SealYields) live here too so downstream
+ * packages can import them without depending on the engine implementation files.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/walker.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The Walker — rig execution engine apparatus.
+ *
+ * The Walker drives writ-to-completion by managing rigs: ordered pipelines
+ * of engine instances. Each walk() 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/walker.md
+ */
+import type { Plugin } from '@shardworks/nexus-core';
+export declare function createWalker(): Plugin;
+//# sourceMappingURL=walker.d.ts.map

package/dist/walker.d.ts.map

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

package/dist/walker.js

@@ -0,0 +1,345 @@
+/**
+ * The Walker — rig execution engine apparatus.
+ *
+ * The Walker drives writ-to-completion by managing rigs: ordered pipelines
+ * of engine instances. Each walk() 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/walker.md
+ */
+import { guild, generateId } from '@shardworks/nexus-core';
+import { draftEngine, implementEngine, reviewEngine, reviseEngine, sealEngine, } from "./engines/index.js";
+import { walkTool, walkContinualTool } from "./tools/index.js";
+// ── Helpers ────────────────────────────────────────────────────────────
+/**
+ * Check whether a value is JSON-serializable.
+ * Non-serializable yields cause engine failure — the Stacks cannot store them.
+ */
+function isJsonSerializable(value) {
+    try {
+        JSON.stringify(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build the upstream yields map for a rig: all completed engine yields
+ * keyed by engine id. Passed as context.upstream to the engine's run().
+ */
+function buildUpstreamMap(rig) {
+    const upstream = {};
+    for (const engine of rig.engines) {
+        if (engine.status === 'completed' && engine.yields !== undefined) {
+            upstream[engine.id] = engine.yields;
+        }
+    }
+    return upstream;
+}
+/**
+ * Find the first pending engine whose entire upstream is completed.
+ * Returns null if no runnable engine exists.
+ */
+function findRunnableEngine(rig) {
+    for (const engine of rig.engines) {
+        if (engine.status !== 'pending')
+            continue;
+        const allUpstreamDone = engine.upstream.every((upstreamId) => {
+            const dep = rig.engines.find((e) => e.id === upstreamId);
+            return dep?.status === 'completed';
+        });
+        if (allUpstreamDone)
+            return engine;
+    }
+    return null;
+}
+/**
+ * Produce the five-engine static pipeline for a writ.
+ * Each engine receives only the givens it needs.
+ * Upstream yields arrive via context.upstream at run time.
+ */
+function buildStaticEngines(writ, config) {
+    const role = config.role ?? 'artificer';
+    const reviewGivens = {
+        writ,
+        role: 'reviewer',
+        ...(config.buildCommand !== undefined ? { buildCommand: config.buildCommand } : {}),
+        ...(config.testCommand !== undefined ? { testCommand: config.testCommand } : {}),
+    };
+    return [
+        { id: 'draft', designId: 'draft', status: 'pending', upstream: [], givensSpec: { writ } },
+        { id: 'implement', designId: 'implement', status: 'pending', upstream: ['draft'], givensSpec: { writ, role } },
+        { id: 'review', designId: 'review', status: 'pending', upstream: ['implement'], givensSpec: reviewGivens },
+        { id: 'revise', designId: 'revise', status: 'pending', upstream: ['review'], givensSpec: { writ, role } },
+        { id: 'seal', designId: 'seal', status: 'pending', upstream: ['revise'], givensSpec: {} },
+    ];
+}
+// ── Apparatus factory ──────────────────────────────────────────────────
+export function createWalker() {
+    let rigsBook;
+    let sessionsBook;
+    let writsBook;
+    let clerk;
+    let fabricator;
+    let walkerConfig = {};
+    // ── Internal walk operations ─────────────────────────────────────
+    /**
+     * Mark an engine failed and propagate failure to the rig (same update).
+     */
+    async function failEngine(rig, engineId, errorMessage) {
+        const now = new Date().toISOString();
+        const updatedEngines = rig.engines.map((e) => e.id === engineId
+            ? { ...e, status: 'failed', error: errorMessage, completedAt: now }
+            : e);
+        await rigsBook.patch(rig.id, {
+            engines: updatedEngines,
+            status: 'failed',
+        });
+    }
+    /**
+     * Phase 1 — collect.
+     *
+     * Find the first running engine with a sessionId whose session has
+     * reached a terminal state. Populate yields and advance the engine
+     * (and possibly the rig) to completed or failed.
+     */
+    async function tryCollect() {
+        const runningRigs = await rigsBook.find({ where: [['status', '=', 'running']] });
+        for (const rig of runningRigs) {
+            for (const engine of rig.engines) {
+                if (engine.status !== 'running' || !engine.sessionId)
+                    continue;
+                const session = await sessionsBook.get(engine.sessionId);
+                if (!session || session.status === 'running')
+                    continue;
+                // Terminal session found — collect.
+                const now = new Date().toISOString();
+                if (session.status === 'failed' || session.status === 'timeout') {
+                    await failEngine(rig, engine.id, session.error ?? `Session ${session.status}`);
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+                }
+                // Completed session — assemble yields from session record.
+                const yields = {
+                    sessionId: session.id,
+                    sessionStatus: session.status,
+                    ...(session.output !== undefined ? { output: session.output } : {}),
+                };
+                if (!isJsonSerializable(yields)) {
+                    await failEngine(rig, engine.id, 'Session yields are not JSON-serializable');
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+                }
+                const updatedEngines = rig.engines.map((e) => e.id === engine.id
+                    ? { ...e, status: 'completed', yields, completedAt: now }
+                    : e);
+                const allCompleted = updatedEngines.every((e) => e.status === 'completed');
+                await rigsBook.patch(rig.id, {
+                    engines: updatedEngines,
+                    status: allCompleted ? 'completed' : 'running',
+                });
+                if (allCompleted) {
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'completed' };
+                }
+                return { action: 'engine-completed', rigId: rig.id, engineId: engine.id };
+            }
+        }
+        return null;
+    }
+    /**
+     * Phase 2 — run.
+     *
+     * Find the first pending engine in any running rig whose upstream is
+     * all completed. Execute it:
+     * - Clockwork ('completed') → store yields, mark engine completed,
+     *   check for rig completion.
+     * - Quick ('launched') → store sessionId, mark engine running.
+     */
+    async function tryRun() {
+        const runningRigs = await rigsBook.find({ where: [['status', '=', 'running']] });
+        for (const rig of runningRigs) {
+            const pending = findRunnableEngine(rig);
+            if (!pending)
+                continue;
+            const design = fabricator.getEngineDesign(pending.designId);
+            if (!design) {
+                await failEngine(rig, pending.id, `No engine design found for "${pending.designId}"`);
+                return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+            }
+            const now = new Date().toISOString();
+            const upstream = buildUpstreamMap(rig);
+            const givens = { ...pending.givensSpec };
+            const context = { engineId: pending.id, upstream };
+            let engineResult;
+            try {
+                // Mark engine as running before executing
+                const startedEngines = rig.engines.map((e) => e.id === pending.id ? { ...e, status: 'running', startedAt: now } : e);
+                await rigsBook.patch(rig.id, { engines: startedEngines });
+                // Re-fetch to get the up-to-date engines list (with startedAt set)
+                const updatedRig = { ...rig, engines: startedEngines };
+                engineResult = await design.run(givens, context);
+                if (engineResult.status === 'launched') {
+                    // Quick engine — store sessionId, leave engine in 'running'
+                    const { sessionId } = engineResult;
+                    const launchedEngines = updatedRig.engines.map((e) => e.id === pending.id
+                        ? { ...e, status: 'running', sessionId }
+                        : e);
+                    await rigsBook.patch(rig.id, { engines: launchedEngines });
+                    return { action: 'engine-started', rigId: rig.id, engineId: pending.id };
+                }
+                // Clockwork engine — validate and store yields
+                const { yields } = engineResult;
+                if (!isJsonSerializable(yields)) {
+                    await failEngine(updatedRig, pending.id, 'Engine yields are not JSON-serializable');
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+                }
+                const completedAt = new Date().toISOString();
+                const completedEngines = updatedRig.engines.map((e) => e.id === pending.id
+                    ? { ...e, status: 'completed', yields, completedAt }
+                    : e);
+                const allCompleted = completedEngines.every((e) => e.status === 'completed');
+                await rigsBook.patch(rig.id, {
+                    engines: completedEngines,
+                    status: allCompleted ? 'completed' : 'running',
+                });
+                if (allCompleted) {
+                    return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'completed' };
+                }
+                return { action: 'engine-completed', rigId: rig.id, engineId: pending.id };
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                await failEngine(rig, pending.id, errorMessage);
+                return { action: 'rig-completed', rigId: rig.id, writId: rig.writId, outcome: 'failed' };
+            }
+        }
+        return null;
+    }
+    /**
+     * Phase 3 — spawn.
+     *
+     * Find the oldest ready writ with no existing rig. Create a rig and
+     * transition the writ to active so the Clerk tracks it as in-progress.
+     */
+    async function trySpawn() {
+        // Find ready writs ordered by creation time (oldest first)
+        const readyWrits = await writsBook.find({
+            where: [['status', '=', 'ready']],
+            orderBy: ['createdAt', 'asc'],
+            limit: 10,
+        });
+        for (const writ of readyWrits) {
+            // Check for existing rig
+            const existing = await rigsBook.find({
+                where: [['writId', '=', writ.id]],
+                limit: 1,
+            });
+            if (existing.length > 0)
+                continue;
+            const rigId = generateId('rig', 4);
+            const engines = buildStaticEngines(writ, walkerConfig);
+            const rig = {
+                id: rigId,
+                writId: writ.id,
+                status: 'running',
+                engines,
+            };
+            await rigsBook.put(rig);
+            // Transition writ to active so Clerk tracks it
+            try {
+                await clerk.transition(writ.id, 'active');
+            }
+            catch (err) {
+                // Only swallow state-transition conflicts (writ already moved past 'ready')
+                if (err instanceof Error && err.message.includes('transition')) {
+                    // Race condition — another walker got here first. The rig is already created,
+                    // so we continue. The writ is already active or beyond.
+                }
+                else {
+                    throw err;
+                }
+            }
+            return { action: 'rig-spawned', rigId, writId: writ.id };
+        }
+        return null;
+    }
+    // ── WalkerApi ─────────────────────────────────────────────────────
+    const api = {
+        async walk() {
+            const collected = await tryCollect();
+            if (collected)
+                return collected;
+            const ran = await tryRun();
+            if (ran)
+                return ran;
+            const spawned = await trySpawn();
+            if (spawned)
+                return spawned;
+            return null;
+        },
+    };
+    // ── Apparatus ─────────────────────────────────────────────────────
+    return {
+        apparatus: {
+            requires: ['stacks', 'clerk', 'fabricator'],
+            supportKit: {
+                books: {
+                    rigs: {
+                        indexes: ['status', 'writId', ['status', 'writId']],
+                    },
+                },
+                engines: {
+                    draft: draftEngine,
+                    implement: implementEngine,
+                    review: reviewEngine,
+                    revise: reviseEngine,
+                    seal: sealEngine,
+                },
+                tools: [walkTool, walkContinualTool],
+            },
+            provides: api,
+            start(_ctx) {
+                const g = guild();
+                walkerConfig = g.guildConfig().walker ?? {};
+                const stacks = g.apparatus('stacks');
+                clerk = g.apparatus('clerk');
+                fabricator = g.apparatus('fabricator');
+                rigsBook = stacks.book('walker', 'rigs');
+                sessionsBook = stacks.readBook('animator', 'sessions');
+                writsBook = stacks.readBook('clerk', 'writs');
+                // CDC — Phase 1 cascade on rigs book.
+                // When a rig reaches a terminal state, transition the associated writ.
+                stacks.watch('walker', 'rigs', async (event) => {
+                    if (event.type !== 'update')
+                        return;
+                    const rig = event.entry;
+                    const prev = event.prev;
+                    // Only act when status changes to a terminal state
+                    if (rig.status === prev.status)
+                        return;
+                    if (rig.status === 'completed') {
+                        // Use seal yields as the resolution summary
+                        const sealEngine = rig.engines.find((e) => e.id === 'seal');
+                        const resolution = sealEngine?.yields
+                            ? JSON.stringify(sealEngine.yields)
+                            : 'Rig completed';
+                        await clerk.transition(rig.writId, 'completed', { resolution });
+                    }
+                    else if (rig.status === 'failed') {
+                        const failedEngine = rig.engines.find((e) => e.status === 'failed');
+                        const resolution = failedEngine?.error ?? 'Engine failure';
+                        await clerk.transition(rig.writId, 'failed', { resolution });
+                    }
+                }, { failOnError: true });
+            },
+        },
+    };
+}
+//# sourceMappingURL=walker.js.map

package/dist/walker.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@shardworks/walker-apparatus",
+  "version": "0.1.113",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus",
+    "directory": "packages/plugins/walker"
+  },
+  "description": "The Walker — rig execution engine apparatus",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "4.3.6",
+    "@shardworks/fabricator-apparatus": "0.1.113",
+    "@shardworks/stacks-apparatus": "0.1.113",
+    "@shardworks/clerk-apparatus": "0.1.113",
+    "@shardworks/nexus-core": "0.1.113",
+    "@shardworks/tools-apparatus": "0.1.113",
+    "@shardworks/animator-apparatus": "0.1.113",
+    "@shardworks/codexes-apparatus": "0.1.113"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --disable-warning=ExperimentalWarning --experimental-transform-types --test 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit"
+  }
+}