@shardworks/nexus-core 0.1.19 → 0.1.21

package/dist/worktree.js

@@ -0,0 +1,116 @@
+/**
+ * Commission worktree management — creates isolated git worktrees for
+ * commission sessions.
+ *
+ * When an anima is dispatched to work on a commission, this module:
+ * 1. Creates a new git branch for the commission
+ * 2. Sets up a git worktree pointing at that branch
+ * 3. Returns the worktree path so the session can launch in the correct cwd
+ *
+ * Worktrees provide isolation — each commission gets its own working copy
+ * of the repo, so multiple animas can work concurrently without conflicts
+ * in the working directory.
+ *
+ * Absorbed from the former `engine-worktree-setup` package.
+ *
+ * ## Directory layout
+ *
+ * Commission worktrees are created from workshop bare clones:
+ *
+ *   GUILD_ROOT/
+ *     .nexus/
+ *       workshops/
+ *         workshop-a.git/          ← bare clone (source for worktrees)
+ *       worktrees/
+ *         workshop-a/
+ *           commission-42/         ← worktree for commission #42
+ *         workshop-b/
+ *           commission-17/         ← worktree for commission #17
+ */
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { workshopBarePath, worktreesPath } from "./nexus-home.js";
+function git(args, cwd) {
+    return execFileSync('git', args, { cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+}
+/**
+ * Create a git worktree for a commission session.
+ *
+ * Creates a new branch from the base branch and sets up a worktree in
+ * .nexus/worktrees/{workshop}/commission-{id}/.
+ *
+ * @throws If the worktree or branch already exists.
+ */
+export function setupWorktree(config) {
+    const { home, workshop, commissionId, baseBranch = 'main' } = config;
+    const bareRepo = workshopBarePath(home, workshop);
+    const branch = `commission-${commissionId}`;
+    const worktreeDir = path.join(worktreesPath(home), workshop, branch);
+    if (fs.existsSync(worktreeDir)) {
+        throw new Error(`Worktree directory already exists: ${worktreeDir}. ` +
+            `Commission ${commissionId} may already have an active worktree.`);
+    }
+    // Create parent directory
+    fs.mkdirSync(path.dirname(worktreeDir), { recursive: true });
+    // Create branch and worktree in one operation
+    // git worktree add -b <branch> <path> <base>
+    git(['worktree', 'add', '-b', branch, worktreeDir, baseBranch], bareRepo);
+    return { path: worktreeDir, branch, commissionId };
+}
+/**
+ * Remove a worktree after a commission session completes.
+ *
+ * Removes the worktree directory and prunes it from git's tracking.
+ * Does NOT delete the branch — the branch should be kept for history
+ * until explicitly merged or pruned.
+ */
+export function teardownWorktree(home, workshop, commissionId) {
+    const bareRepo = workshopBarePath(home, workshop);
+    const branch = `commission-${commissionId}`;
+    const worktreeDir = path.join(worktreesPath(home), workshop, branch);
+    if (!fs.existsSync(worktreeDir)) {
+        throw new Error(`Worktree not found: ${worktreeDir}. Commission ${commissionId} may not have an active worktree.`);
+    }
+    // Remove the worktree
+    git(['worktree', 'remove', worktreeDir], bareRepo);
+    // Clean up the workshop worktree directory if empty
+    const workshopDir = path.join(worktreesPath(home), workshop);
+    if (fs.existsSync(workshopDir) && fs.readdirSync(workshopDir).length === 0) {
+        fs.rmdirSync(workshopDir);
+    }
+}
+/**
+ * List active commission worktrees.
+ */
+export function listWorktrees(home, workshop) {
+    const wtRoot = worktreesPath(home);
+    if (!fs.existsSync(wtRoot))
+        return [];
+    // If a specific workshop is given, only list worktrees for that workshop
+    const workshopDirs = workshop
+        ? [workshop]
+        : fs.readdirSync(wtRoot, { withFileTypes: true })
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+    const results = [];
+    for (const ws of workshopDirs) {
+        const wsDir = path.join(wtRoot, ws);
+        if (!fs.existsSync(wsDir))
+            continue;
+        for (const entry of fs.readdirSync(wsDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const match = entry.name.match(/^commission-(\d+)$/);
+            if (!match)
+                continue;
+            results.push({
+                path: path.join(wsDir, entry.name),
+                branch: entry.name,
+                commissionId: parseInt(match[1], 10),
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAsBlE,SAAS,GAAG,CAAC,IAAc,EAAE,GAAW;IACtC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACvG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IACrE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,cAAc,YAAY,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAErE,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,sCAAsC,WAAW,IAAI;YACrD,cAAc,YAAY,uCAAuC,CAClE,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,8CAA8C;IAC9C,6CAA6C;IAC7C,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE1E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,YAAoB;IACnF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,cAAc,YAAY,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAErE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,uBAAuB,WAAW,gBAAgB,YAAY,mCAAmC,CAClG,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEnD,oDAAoD;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3E,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAiB;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,yEAAyE;IACzE,MAAM,YAAY,GAAG,QAAQ;QAC3B,CAAC,CAAC,CAAC,QAAQ,CAAC;QACZ,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAExB,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS;QAEpC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YAEnC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;gBAClC,MAAM,EAAE,KAAK,CAAC,IAAI;gBAClB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardworks/nexus-core",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "license": "ISC",
   "repository": {
     "type": "git",