@shardworks/engine-workshop-prepare 0.1.17

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/index.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@shardworks/nexus-core").EngineDefinition;
+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":";AAgBA,wBA6CG"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * Workshop Prepare Engine (clockwork)
+ *
+ * Standing order handler for commission.posted events. Creates an isolated
+ * git worktree for the commission and signals commission.ready so the next
+ * standing order (summon artificer) can launch the session.
+ *
+ * Event flow:
+ *   commission.posted { commissionId, workshop }
+ *     → creates worktree from workshop bare repo
+ *     → updates commission status → in_progress
+ *     → signals commission.ready { commissionId, workshop, worktreePath }
+ */
+import { engine, signalEvent, updateCommissionStatus, readCommission } from '@shardworks/nexus-core';
+import { setupWorktree } from '@shardworks/engine-worktree-setup';
+export default engine({
+    handler: async (event, { home }) => {
+        if (!event) {
+            throw new Error('workshop-prepare requires an event (cannot be invoked directly).');
+        }
+        const payload = event.payload;
+        if (!payload || typeof payload.commissionId !== 'number' || typeof payload.workshop !== 'string') {
+            throw new Error(`workshop-prepare expected payload with { commissionId, workshop }, got: ${JSON.stringify(payload)}`);
+        }
+        const commissionId = payload.commissionId;
+        const workshop = payload.workshop;
+        // Verify commission exists
+        const commission = readCommission(home, commissionId);
+        if (!commission) {
+            throw new Error(`Commission #${commissionId} not found in the Ledger.`);
+        }
+        // Create the worktree
+        const worktree = setupWorktree({
+            home,
+            workshop,
+            commissionId,
+        });
+        // Update commission status
+        updateCommissionStatus(home, commissionId, 'in_progress', `worktree ready on branch ${worktree.branch}`);
+        // Signal ready for the next standing order (summon artificer)
+        signalEvent(home, 'commission.ready', { commissionId, workshop, worktreePath: worktree.path }, 'framework');
+    },
+});
+//# 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;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,eAAe,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAyC,CAAC;QAChE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjG,MAAM,IAAI,KAAK,CACb,2EAA2E,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CACrG,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAsB,CAAC;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAkB,CAAC;QAE5C,2BAA2B;QAC3B,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,eAAe,YAAY,2BAA2B,CAAC,CAAC;QAC1E,CAAC;QAED,sBAAsB;QACtB,MAAM,QAAQ,GAAG,aAAa,CAAC;YAC7B,IAAI;YACJ,QAAQ;YACR,YAAY;SACb,CAAC,CAAC;QAEH,2BAA2B;QAC3B,sBAAsB,CACpB,IAAI,EACJ,YAAY,EACZ,aAAa,EACb,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAC9C,CAAC;QAEF,8DAA8D;QAC9D,WAAW,CACT,IAAI,EACJ,kBAAkB,EAClB,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,EACvD,WAAW,CACZ,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/nexus-engine.json

@@ -0,0 +1,5 @@
+{
+  "entry": "src/index.ts",
+  "version": "0.1.0",
+  "description": "Clockwork engine — prepares a workshop worktree for a commission"
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@shardworks/engine-workshop-prepare",
+  "version": "0.1.17",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus-mk2",
+    "directory": "packages/engine-workshop-prepare"
+  },
+  "description": "Clockwork engine — prepares a workshop worktree for a commission",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@shardworks/engine-worktree-setup": "0.1.17",
+    "@shardworks/nexus-core": "0.1.17"
+  },
+  "devDependencies": {
+    "@types/node": "25.5.0"
+  },
+  "files": [
+    "dist",
+    "nexus-engine.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}