@shardworks/codexes-apparatus 0.1.101

package/dist/tools/codex-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-list.js","sourceRoot":"","sources":["../../src/tools/codex-list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,4CAA4C;IACzD,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/codex-push.d.ts

@@ -0,0 +1,10 @@
+/**
+ * codex-push tool — push a branch to the codex's remote.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    codexName: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+}>;
+export default _default;
+//# sourceMappingURL=codex-push.d.ts.map

package/dist/tools/codex-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-push.d.ts","sourceRoot":"","sources":["../../src/tools/codex-push.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;AAGxB,wBAYG"}

package/dist/tools/codex-push.js

@@ -0,0 +1,20 @@
+/**
+ * codex-push tool — push a branch to the codex's remote.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'codex-push',
+    description: 'Push a branch to the codex remote',
+    permission: 'write',
+    params: {
+        codexName: z.string().describe('Codex name'),
+        branch: z.string().optional().describe('Branch to push (default: codex default branch)'),
+    },
+    handler: async (params) => {
+        const api = guild().apparatus('codexes');
+        return api.push(params);
+    },
+});
+//# sourceMappingURL=codex-push.js.map

package/dist/tools/codex-push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-push.js","sourceRoot":"","sources":["../../src/tools/codex-push.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,mCAAmC;IAChD,UAAU,EAAE,OAAO;IACnB,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;KACzF;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/codex-remove.d.ts

@@ -0,0 +1,12 @@
+/**
+ * codex-remove tool — remove a codex from the guild.
+ *
+ * Abandons all active drafts, removes the bare clone, and removes
+ * the entry from guild.json. Does NOT delete the remote repository.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    name: z.ZodString;
+}>;
+export default _default;
+//# sourceMappingURL=codex-remove.d.ts.map

package/dist/tools/codex-remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-remove.d.ts","sourceRoot":"","sources":["../../src/tools/codex-remove.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAGxB,wBAWG"}

package/dist/tools/codex-remove.js

@@ -0,0 +1,22 @@
+/**
+ * codex-remove tool — remove a codex from the guild.
+ *
+ * Abandons all active drafts, removes the bare clone, and removes
+ * the entry from guild.json. Does NOT delete the remote repository.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'codex-remove',
+    description: 'Remove a codex from the guild (does not affect the remote repository)',
+    permission: 'delete',
+    params: {
+        name: z.string().describe('Codex name to remove'),
+    },
+    handler: async ({ name }) => {
+        const api = guild().apparatus('codexes');
+        return api.remove(name);
+    },
+});
+//# sourceMappingURL=codex-remove.js.map

package/dist/tools/codex-remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-remove.js","sourceRoot":"","sources":["../../src/tools/codex-remove.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,uEAAuE;IACpF,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAClD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/codex-show.d.ts

@@ -0,0 +1,9 @@
+/**
+ * codex-show tool — show details of a specific codex including active drafts.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    name: z.ZodString;
+}>;
+export default _default;
+//# sourceMappingURL=codex-show.d.ts.map

package/dist/tools/codex-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-show.d.ts","sourceRoot":"","sources":["../../src/tools/codex-show.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAGxB,wBAWG"}

package/dist/tools/codex-show.js

@@ -0,0 +1,19 @@
+/**
+ * codex-show tool — show details of a specific codex including active drafts.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'codex-show',
+    description: 'Show details of a registered codex including active draft bindings',
+    permission: 'read',
+    params: {
+        name: z.string().describe('Codex name'),
+    },
+    handler: async ({ name }) => {
+        const api = guild().apparatus('codexes');
+        return api.show(name);
+    },
+});
+//# sourceMappingURL=codex-show.js.map

package/dist/tools/codex-show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-show.js","sourceRoot":"","sources":["../../src/tools/codex-show.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,oEAAoE;IACjF,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;KACxC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/draft-abandon.d.ts

@@ -0,0 +1,14 @@
+/**
+ * draft-abandon tool — abandon a draft binding.
+ *
+ * Removes the git worktree and branch. Fails if the draft has
+ * unsealed inscriptions unless force: true.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    codexName: z.ZodString;
+    branch: z.ZodString;
+    force: z.ZodOptional<z.ZodBoolean>;
+}>;
+export default _default;
+//# sourceMappingURL=draft-abandon.d.ts.map

package/dist/tools/draft-abandon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-abandon.d.ts","sourceRoot":"","sources":["../../src/tools/draft-abandon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;AAGxB,wBAaG"}

package/dist/tools/draft-abandon.js

@@ -0,0 +1,24 @@
+/**
+ * draft-abandon tool — abandon a draft binding.
+ *
+ * Removes the git worktree and branch. Fails if the draft has
+ * unsealed inscriptions unless force: true.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'draft-abandon',
+    description: 'Abandon a draft binding (removes the git worktree and branch)',
+    permission: 'delete',
+    params: {
+        codexName: z.string().describe('Codex name'),
+        branch: z.string().describe('Branch of the draft to abandon'),
+        force: z.boolean().optional().describe('Force abandonment even with unmerged changes'),
+    },
+    handler: async (params) => {
+        const api = guild().apparatus('codexes');
+        return api.abandonDraft(params);
+    },
+});
+//# sourceMappingURL=draft-abandon.js.map

package/dist/tools/draft-abandon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-abandon.js","sourceRoot":"","sources":["../../src/tools/draft-abandon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,+DAA+D;IAC5E,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC7D,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KACvF;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/draft-list.d.ts

@@ -0,0 +1,9 @@
+/**
+ * draft-list tool — list active draft bindings.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    codexName: z.ZodOptional<z.ZodString>;
+}>;
+export default _default;
+//# sourceMappingURL=draft-list.d.ts.map

package/dist/tools/draft-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-list.d.ts","sourceRoot":"","sources":["../../src/tools/draft-list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAGxB,wBAWG"}

package/dist/tools/draft-list.js

@@ -0,0 +1,19 @@
+/**
+ * draft-list tool — list active draft bindings.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'draft-list',
+    description: 'List active draft bindings, optionally filtered by codex',
+    permission: 'read',
+    params: {
+        codexName: z.string().optional().describe('Filter by codex name'),
+    },
+    handler: async ({ codexName }) => {
+        const api = guild().apparatus('codexes');
+        return api.listDrafts(codexName);
+    },
+});
+//# sourceMappingURL=draft-list.js.map

package/dist/tools/draft-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-list.js","sourceRoot":"","sources":["../../src/tools/draft-list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0DAA0D;IACvE,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAClE;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/draft-open.d.ts

@@ -0,0 +1,15 @@
+/**
+ * draft-open tool — open a draft binding on a codex.
+ *
+ * Creates an isolated git worktree for concurrent work. Fetches from
+ * the remote before branching to ensure freshness.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    codexName: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    startPoint: z.ZodOptional<z.ZodString>;
+    associatedWith: z.ZodOptional<z.ZodString>;
+}>;
+export default _default;
+//# sourceMappingURL=draft-open.d.ts.map

package/dist/tools/draft-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-open.d.ts","sourceRoot":"","sources":["../../src/tools/draft-open.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;;AAGxB,wBAcG"}

package/dist/tools/draft-open.js

@@ -0,0 +1,25 @@
+/**
+ * draft-open tool — open a draft binding on a codex.
+ *
+ * Creates an isolated git worktree for concurrent work. Fetches from
+ * the remote before branching to ensure freshness.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'draft-open',
+    description: 'Open a draft binding on a codex (creates an isolated git worktree)',
+    permission: 'write',
+    params: {
+        codexName: z.string().describe('Codex to open the draft for'),
+        branch: z.string().optional().describe('Branch name for the draft (default: auto-generated draft-<ulid>)'),
+        startPoint: z.string().optional().describe('Branch/tag/commit to start from (default: remote HEAD)'),
+        associatedWith: z.string().optional().describe('Optional association (e.g. writ id)'),
+    },
+    handler: async (params) => {
+        const api = guild().apparatus('codexes');
+        return api.openDraft(params);
+    },
+});
+//# sourceMappingURL=draft-open.js.map

package/dist/tools/draft-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-open.js","sourceRoot":"","sources":["../../src/tools/draft-open.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,oEAAoE;IACjF,UAAU,EAAE,OAAO;IACnB,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;QAC1G,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACpG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KACtF;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/draft-seal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * draft-seal tool — seal a draft into the codex.
+ *
+ * Incorporates the draft's inscriptions into the sealed binding via
+ * ff-only merge. If ff is not possible, rebases and retries. Fails
+ * hard on conflicts — no merge commits, no auto-resolution.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    codexName: z.ZodString;
+    sourceBranch: z.ZodString;
+    targetBranch: z.ZodOptional<z.ZodString>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    keepDraft: z.ZodOptional<z.ZodBoolean>;
+}>;
+export default _default;
+//# sourceMappingURL=draft-seal.d.ts.map

package/dist/tools/draft-seal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-seal.d.ts","sourceRoot":"","sources":["../../src/tools/draft-seal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;;;AAGxB,wBAeG"}

package/dist/tools/draft-seal.js

@@ -0,0 +1,27 @@
+/**
+ * draft-seal tool — seal a draft into the codex.
+ *
+ * Incorporates the draft's inscriptions into the sealed binding via
+ * ff-only merge. If ff is not possible, rebases and retries. Fails
+ * hard on conflicts — no merge commits, no auto-resolution.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'draft-seal',
+    description: 'Seal a draft binding into the codex (ff-only merge or rebase; no merge commits)',
+    permission: 'write',
+    params: {
+        codexName: z.string().describe('Codex name'),
+        sourceBranch: z.string().describe('Draft branch to seal'),
+        targetBranch: z.string().optional().describe('Target branch (default: codex default branch)'),
+        maxRetries: z.number().optional().describe('Max rebase retries under contention (default: 3)'),
+        keepDraft: z.boolean().optional().describe('Keep draft after sealing (default: false)'),
+    },
+    handler: async (params) => {
+        const api = guild().apparatus('codexes');
+        return api.seal(params);
+    },
+});
+//# sourceMappingURL=draft-seal.js.map

package/dist/tools/draft-seal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-seal.js","sourceRoot":"","sources":["../../src/tools/draft-seal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,iFAAiF;IAC9F,UAAU,EAAE,OAAO;IACnB,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACzD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC7F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC9F,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;KACxF;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC,SAAS,CAAiB,SAAS,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Scriptorium tool re-exports.
+ */
+export { default as codexAdd } from './codex-add.ts';
+export { default as codexList } from './codex-list.ts';
+export { default as codexShow } from './codex-show.ts';
+export { default as codexRemove } from './codex-remove.ts';
+export { default as codexPush } from './codex-push.ts';
+export { default as draftOpen } from './draft-open.ts';
+export { default as draftList } from './draft-list.ts';
+export { default as draftAbandon } from './draft-abandon.ts';
+export { default as draftSeal } from './draft-seal.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;;GAEG;AAEH,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,13 @@
+/**
+ * Scriptorium tool re-exports.
+ */
+export { default as codexAdd } from "./codex-add.js";
+export { default as codexList } from "./codex-list.js";
+export { default as codexShow } from "./codex-show.js";
+export { default as codexRemove } from "./codex-remove.js";
+export { default as codexPush } from "./codex-push.js";
+export { default as draftOpen } from "./draft-open.js";
+export { default as draftList } from "./draft-list.js";
+export { default as draftAbandon } from "./draft-abandon.js";
+export { default as draftSeal } from "./draft-seal.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;;GAEG;AAEH,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * The Scriptorium — type definitions.
+ *
+ * All public types for the codexes apparatus: the ScriptoriumApi
+ * (provides interface), supporting record types, and request/result
+ * types for draft lifecycle and sealing operations.
+ *
+ * See: docs/architecture/apparatus/scriptorium.md
+ */
+export interface CodexRecord {
+    /** Codex name — unique within the guild. */
+    name: string;
+    /** Remote repository URL. */
+    remoteUrl: string;
+    /** Whether the bare clone exists and is healthy. */
+    cloneStatus: 'ready' | 'cloning' | 'error';
+    /** Number of active drafts for this codex. */
+    activeDrafts: number;
+}
+export interface CodexDetail extends CodexRecord {
+    /** Default branch name on the remote (e.g. 'main'). */
+    defaultBranch: string;
+    /** Timestamp of last fetch. */
+    lastFetched: string | null;
+    /** Active drafts for this codex. */
+    drafts: DraftRecord[];
+}
+export interface DraftRecord {
+    /** Unique draft id (ULID). */
+    id: string;
+    /** Codex this draft belongs to. */
+    codexName: string;
+    /** Git branch name for this draft. */
+    branch: string;
+    /** Absolute filesystem path to the draft's working directory (git worktree). */
+    path: string;
+    /** When the draft was opened. */
+    createdAt: string;
+    /** Optional association — e.g. a writ id. */
+    associatedWith?: string;
+}
+export interface OpenDraftRequest {
+    /** Codex to open the draft for. */
+    codexName: string;
+    /** Branch name for the draft. If omitted, generates `draft-<ulid>`. */
+    branch?: string;
+    /**
+     * Starting point — branch, tag, or commit to branch from.
+     * Default: remote HEAD (the codex's default branch).
+     */
+    startPoint?: string;
+    /** Optional association metadata (e.g. writ id). */
+    associatedWith?: string;
+}
+export interface AbandonDraftRequest {
+    /** Codex name. */
+    codexName: string;
+    /** Git branch name of the draft to abandon. */
+    branch: string;
+    /** Force abandonment even if the draft has unsealed inscriptions. */
+    force?: boolean;
+}
+export interface SealRequest {
+    /** Codex name. */
+    codexName: string;
+    /** Git branch to seal (the draft's branch). */
+    sourceBranch: string;
+    /** Target branch (the sealed binding). Default: codex's default branch. */
+    targetBranch?: string;
+    /** Max rebase retry attempts under contention. Default: from settings.maxMergeRetries (3). */
+    maxRetries?: number;
+    /** Keep the draft after successful sealing. Default: false. */
+    keepDraft?: boolean;
+}
+export interface SealResult {
+    /** Whether sealing succeeded. */
+    success: boolean;
+    /** Strategy used: 'fast-forward' or 'rebase'. */
+    strategy: 'fast-forward' | 'rebase';
+    /** Number of retry attempts needed (0 = first try). */
+    retries: number;
+    /** The commit SHA at head of target after sealing. */
+    sealedCommit: string;
+    /** Number of inscriptions (commits) incorporated from the draft. 0 means no-op seal. */
+    inscriptionsSealed: number;
+}
+export interface PushRequest {
+    /** Codex name. */
+    codexName: string;
+    /**
+     * Branch to push. Default: codex's default branch.
+     */
+    branch?: string;
+}
+export interface CodexesConfig {
+    settings?: CodexesSettings;
+    registered?: Record<string, CodexConfigEntry>;
+}
+export interface CodexesSettings {
+    /** Max rebase-retry attempts during sealing under contention. Default: 3. */
+    maxMergeRetries?: number;
+    /** Directory where draft worktrees are created, relative to guild root. Default: '.nexus/worktrees'. */
+    draftRoot?: string;
+}
+export interface CodexConfigEntry {
+    /** The remote URL of the codex's git repository. */
+    remoteUrl: string;
+}
+export interface ScriptoriumApi {
+    /**
+     * Register an existing repository as a codex.
+     * Clones a bare copy to `.nexus/codexes/<name>.git` and adds the
+     * entry to the `codexes` config section in `guild.json`.
+     * Blocks until the clone completes.
+     */
+    add(name: string, remoteUrl: string): Promise<CodexRecord>;
+    /**
+     * List all registered codexes with their status.
+     */
+    list(): Promise<CodexRecord[]>;
+    /**
+     * Show details for a single codex, including active drafts.
+     */
+    show(name: string): Promise<CodexDetail>;
+    /**
+     * Remove a codex from the guild. Abandons all active drafts,
+     * removes the bare clone from `.nexus/codexes/`, and removes the
+     * entry from `guild.json`. Does NOT delete the remote repository.
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * Fetch latest refs from the remote for a codex's bare clone.
+     * Called automatically before draft creation and sealing; can
+     * also be invoked manually.
+     */
+    fetch(name: string): Promise<void>;
+    /**
+     * Push a branch to the codex's remote.
+     * Pushes the specified branch (default: codex's default branch)
+     * to the bare clone's configured remote. Does not force-push.
+     */
+    push(request: PushRequest): Promise<void>;
+    /**
+     * Open a draft binding on a codex.
+     *
+     * Creates a new git branch from `startPoint` (default: the codex's
+     * sealed binding) and checks it out as an isolated worktree under
+     * `.nexus/worktrees/<codex>/<branch>`. Fetches from the remote
+     * before branching to ensure freshness.
+     *
+     * If `branch` is omitted, generates one automatically as `draft-<ulid>`.
+     * Rejects with a clear error if a draft with the same branch name
+     * already exists for this codex.
+     */
+    openDraft(request: OpenDraftRequest): Promise<DraftRecord>;
+    /**
+     * List active drafts, optionally filtered by codex.
+     */
+    listDrafts(codexName?: string): Promise<DraftRecord[]>;
+    /**
+     * Abandon a draft — remove the draft's worktree and git branch.
+     * Fails if the draft has unsealed inscriptions unless `force: true`.
+     * The inscriptions persist in the git reflog but the draft is no
+     * longer active.
+     */
+    abandonDraft(request: AbandonDraftRequest): Promise<void>;
+    /**
+     * Seal a draft — incorporate its inscriptions into the sealed binding.
+     *
+     * Git strategy: fast-forward merge only. If ff is not possible,
+     * rebases the draft branch onto the target and retries. Retries up
+     * to `maxRetries` times (default: from settings.maxMergeRetries)
+     * to handle contention from concurrent sealing. Fails hard if the
+     * rebase produces conflicts — no auto-resolution, no merge commits.
+     *
+     * On success, abandons the draft (unless `keepDraft: true`).
+     */
+    seal(request: SealRequest): Promise<SealResult>;
+}
+//# 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,11 @@
+/**
+ * The Scriptorium — type definitions.
+ *
+ * All public types for the codexes apparatus: the ScriptoriumApi
+ * (provides interface), supporting record types, and request/result
+ * types for draft lifecycle and sealing operations.
+ *
+ * See: docs/architecture/apparatus/scriptorium.md
+ */
+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;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@shardworks/codexes-apparatus",
+  "version": "0.1.101",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus",
+    "directory": "packages/plugins/codexes"
+  },
+  "description": "The Scriptorium — guild codex management apparatus (git repos, draft bindings, sealing)",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "4.3.6",
+    "@shardworks/nexus-core": "0.1.101",
+    "@shardworks/tools-apparatus": "0.1.101"
+  },
+  "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"
+  }
+}