@shardworks/nexus-core 0.1.16 → 0.1.18

package/dist/workshop.d.ts

@@ -0,0 +1,85 @@
+export interface AddWorkshopOptions {
+    /** Absolute path to the guild root. */
+    home: string;
+    /** Workshop name (used as the key in guild.json and the bare clone directory name). */
+    name: string;
+    /** Git remote URL to clone from. */
+    remoteUrl: string;
+}
+export interface AddWorkshopResult {
+    /** Workshop name. */
+    name: string;
+    /** Remote URL that was cloned. */
+    remoteUrl: string;
+    /** Path to the bare clone on disk. */
+    barePath: string;
+}
+export interface RemoveWorkshopOptions {
+    /** Absolute path to the guild root. */
+    home: string;
+    /** Workshop name to remove. */
+    name: string;
+}
+export interface WorkshopInfo {
+    /** Workshop name. */
+    name: string;
+    /** Remote URL from guild.json. */
+    remoteUrl: string;
+    /** When the workshop was added. */
+    addedAt: string;
+    /** Whether the bare clone exists on disk. */
+    cloned: boolean;
+    /** Number of active commission worktrees. */
+    activeWorktrees: number;
+}
+export interface CreateWorkshopOptions {
+    /** Absolute path to the guild root. */
+    home: string;
+    /** Repository name in org/name format. */
+    repoName: string;
+    /** Whether to create a private repo (default: true). */
+    private?: boolean;
+}
+/**
+ * Derive a workshop name from a remote URL or repo name.
+ * "https://github.com/org/my-repo.git" → "my-repo"
+ * "org/my-repo" → "my-repo"
+ * "git@github.com:org/my-repo.git" → "my-repo"
+ */
+export declare function deriveWorkshopName(input: string): string;
+/**
+ * Add a workshop by cloning a remote repo as a bare clone and registering
+ * it in guild.json.
+ *
+ * @throws If the workshop name already exists in guild.json.
+ * @throws If the bare clone directory already exists on disk.
+ * @throws If the git clone fails.
+ */
+export declare function addWorkshop(opts: AddWorkshopOptions): AddWorkshopResult;
+/**
+ * Remove a workshop — deletes the bare clone, any commission worktrees,
+ * and the guild.json entry.
+ *
+ * @throws If the workshop doesn't exist in guild.json.
+ */
+export declare function removeWorkshop(opts: RemoveWorkshopOptions): void;
+/**
+ * List all workshops with status info.
+ */
+export declare function listWorkshops(home: string): WorkshopInfo[];
+/**
+ * Check whether `gh` is installed and authenticated.
+ * Returns null if OK, or an error message if not.
+ */
+export declare function checkGhAuth(): string | null;
+/**
+ * Create a new GitHub repo and add it as a workshop.
+ *
+ * Precondition: `gh` must be installed and authenticated. Call checkGhAuth()
+ * first to verify.
+ *
+ * @param opts.repoName - Repository name in "org/name" format.
+ * @throws If gh auth check fails, repo creation fails, or add fails.
+ */
+export declare function createWorkshop(opts: CreateWorkshopOptions): AddWorkshopResult;
+//# sourceMappingURL=workshop.d.ts.map

package/dist/workshop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workshop.d.ts","sourceRoot":"","sources":["../src/workshop.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAmBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQxD;AAID;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CA4BvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAyBhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAsB3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAqB7E"}

package/dist/workshop.js

@@ -0,0 +1,189 @@
+/**
+ * workshop — core logic for managing guild workshops.
+ *
+ * Workshops are repositories where the guild does its work. Each workshop
+ * is stored as a bare git clone in .nexus/workshops/{name}.git, with
+ * commission worktrees created from it by the worktree-setup engine.
+ *
+ * This module provides:
+ * - addWorkshop: clone a remote repo and register it in guild.json
+ * - removeWorkshop: remove the bare clone, worktrees, and guild.json entry
+ * - listWorkshops: return workshop entries with status info
+ * - createWorkshop: create a new GitHub repo via `gh`, then add it
+ */
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { readGuildConfig, writeGuildConfig } from "./guild-config.js";
+import { workshopBarePath, workshopsPath, worktreesPath } from "./nexus-home.js";
+// ── Helpers ────────────────────────────────────────────────────────────
+function git(args, cwd) {
+    return execFileSync('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+}
+function gh(args) {
+    return execFileSync('gh', args, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+}
+/**
+ * Derive a workshop name from a remote URL or repo name.
+ * "https://github.com/org/my-repo.git" → "my-repo"
+ * "org/my-repo" → "my-repo"
+ * "git@github.com:org/my-repo.git" → "my-repo"
+ */
+export function deriveWorkshopName(input) {
+    // Handle org/name format
+    if (input.includes('/') && !input.includes(':') && !input.includes('.')) {
+        return input.split('/').pop();
+    }
+    // Handle URLs — take the last path segment, strip .git
+    const basename = input.split('/').pop() ?? input;
+    return basename.replace(/\.git$/, '');
+}
+// ── Core operations ───────────────────────────────────────────────────
+/**
+ * Add a workshop by cloning a remote repo as a bare clone and registering
+ * it in guild.json.
+ *
+ * @throws If the workshop name already exists in guild.json.
+ * @throws If the bare clone directory already exists on disk.
+ * @throws If the git clone fails.
+ */
+export function addWorkshop(opts) {
+    const { home, name, remoteUrl } = opts;
+    const config = readGuildConfig(home);
+    if (name in config.workshops) {
+        throw new Error(`Workshop "${name}" already exists in guild.json.`);
+    }
+    const barePath = workshopBarePath(home, name);
+    if (fs.existsSync(barePath)) {
+        throw new Error(`Bare clone already exists at ${barePath}. Remove it first or choose a different name.`);
+    }
+    // Ensure workshops directory exists
+    fs.mkdirSync(workshopsPath(home), { recursive: true });
+    // Clone as bare repo
+    git(['clone', '--bare', remoteUrl, barePath]);
+    // Register in guild.json
+    const entry = {
+        remoteUrl,
+        addedAt: new Date().toISOString(),
+    };
+    config.workshops[name] = entry;
+    writeGuildConfig(home, config);
+    return { name, remoteUrl, barePath };
+}
+/**
+ * Remove a workshop — deletes the bare clone, any commission worktrees,
+ * and the guild.json entry.
+ *
+ * @throws If the workshop doesn't exist in guild.json.
+ */
+export function removeWorkshop(opts) {
+    const { home, name } = opts;
+    const config = readGuildConfig(home);
+    if (!(name in config.workshops)) {
+        throw new Error(`Workshop "${name}" not found in guild.json. Available workshops: ${Object.keys(config.workshops).join(', ') || '(none)'}`);
+    }
+    // Remove commission worktrees for this workshop
+    const wtDir = path.join(worktreesPath(home), name);
+    if (fs.existsSync(wtDir)) {
+        fs.rmSync(wtDir, { recursive: true, force: true });
+    }
+    // Remove the bare clone
+    const barePath = workshopBarePath(home, name);
+    if (fs.existsSync(barePath)) {
+        fs.rmSync(barePath, { recursive: true, force: true });
+    }
+    // Remove from guild.json
+    delete config.workshops[name];
+    writeGuildConfig(home, config);
+}
+/**
+ * List all workshops with status info.
+ */
+export function listWorkshops(home) {
+    const config = readGuildConfig(home);
+    const results = [];
+    for (const [name, entry] of Object.entries(config.workshops)) {
+        const barePath = workshopBarePath(home, name);
+        const cloned = fs.existsSync(barePath);
+        // Count active worktrees
+        let activeWorktrees = 0;
+        const wtDir = path.join(worktreesPath(home), name);
+        if (fs.existsSync(wtDir)) {
+            activeWorktrees = fs.readdirSync(wtDir, { withFileTypes: true })
+                .filter(e => e.isDirectory())
+                .length;
+        }
+        results.push({
+            name,
+            remoteUrl: entry.remoteUrl,
+            addedAt: entry.addedAt,
+            cloned,
+            activeWorktrees,
+        });
+    }
+    return results;
+}
+/**
+ * Check whether `gh` is installed and authenticated.
+ * Returns null if OK, or an error message if not.
+ */
+export function checkGhAuth() {
+    try {
+        execFileSync('which', ['gh'], { stdio: 'pipe' });
+    }
+    catch {
+        return 'GitHub CLI (gh) is not installed. Install from https://cli.github.com/';
+    }
+    try {
+        const output = execFileSync('gh', ['auth', 'status'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // gh auth status exits 0 when authenticated
+        return null;
+    }
+    catch (err) {
+        // gh auth status may write to stderr even on success in some versions
+        if (err && typeof err === 'object' && 'stderr' in err) {
+            const stderr = err.stderr ?? '';
+            if (stderr.includes('Logged in'))
+                return null;
+        }
+        return 'GitHub CLI is not authenticated. Run: gh auth login';
+    }
+}
+/**
+ * Create a new GitHub repo and add it as a workshop.
+ *
+ * Precondition: `gh` must be installed and authenticated. Call checkGhAuth()
+ * first to verify.
+ *
+ * @param opts.repoName - Repository name in "org/name" format.
+ * @throws If gh auth check fails, repo creation fails, or add fails.
+ */
+export function createWorkshop(opts) {
+    const { home, repoName, private: isPrivate = true } = opts;
+    // Verify gh is available and authenticated
+    const authError = checkGhAuth();
+    if (authError) {
+        throw new Error(authError);
+    }
+    // Create the repo on GitHub
+    const visibility = isPrivate ? '--private' : '--public';
+    gh(['repo', 'create', repoName, visibility, '--confirm']);
+    // Get the clone URL
+    const remoteUrl = `https://github.com/${repoName}.git`;
+    const name = deriveWorkshopName(repoName);
+    // Need to initialize the repo so bare clone works.
+    // gh repo create with --confirm creates it but it may be empty.
+    // We'll clone it (possibly empty) — git clone --bare handles empty repos.
+    return addWorkshop({ home, name, remoteUrl });
+}
+//# sourceMappingURL=workshop.js.map

package/dist/workshop.js.map

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

package/package.json

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

package/dist/dispatch.d.ts

@@ -1,26 +0,0 @@
-export interface DispatchOptions {
-    /** Absolute path to the guild root. */
-    home: string;
-    /** Commission specification — what needs to be done. */
-    spec: string;
-    /** Target workshop for the commission. */
-    workshop: string;
-    /** Target anima name. If provided, the commission is assigned immediately. */
-    anima?: string;
-}
-export interface DispatchResult {
-    /** The ID of the created commission. */
-    commissionId: number;
-    /** Whether the commission was assigned to an anima. */
-    assigned: boolean;
-    /** The anima name if assigned. */
-    assignedTo?: string;
-}
-/**
- * Post a commission to the guild.
- *
- * Creates a commission in the Ledger. If an anima is specified, validates that
- * the anima exists and is active, then creates an assignment record.
- */
-export declare function dispatch(opts: DispatchOptions): DispatchResult;
-//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAgE9D"}

package/dist/dispatch.js

@@ -1,55 +0,0 @@
-/**
- * dispatch — core logic for posting commissions to the guild.
- *
- * Creates a commission record in the Ledger and optionally assigns it to an anima.
- * The dispatch implement and CLI both call this function.
- */
-import Database from 'better-sqlite3';
-import { ledgerPath } from "./nexus-home.js";
-import { readGuildConfig } from "./guild-config.js";
-/**
- * Post a commission to the guild.
- *
- * Creates a commission in the Ledger. If an anima is specified, validates that
- * the anima exists and is active, then creates an assignment record.
- */
-export function dispatch(opts) {
-    const { home, spec, workshop, anima } = opts;
-    // Validate workshop exists in guild.json
-    const config = readGuildConfig(home);
-    if (!config.workshops.includes(workshop)) {
-        throw new Error(`Workshop "${workshop}" not found in guild.json. Available workshops: ${config.workshops.join(', ') || '(none)'}`);
-    }
-    const db = new Database(ledgerPath(home));
-    db.pragma('foreign_keys = ON');
-    try {
-        const initialStatus = anima ? 'assigned' : 'posted';
-        // Create commission
-        const insertCommission = db.prepare(`INSERT INTO commissions (content, status, workshop) VALUES (?, ?, ?)`);
-        const commissionResult = insertCommission.run(spec, initialStatus, workshop);
-        const commissionId = Number(commissionResult.lastInsertRowid);
-        let assigned = false;
-        let assignedTo;
-        if (anima) {
-            // Validate anima exists and is active
-            const animaRow = db.prepare(`SELECT id, status FROM animas WHERE name = ?`).get(anima);
-            if (!animaRow) {
-                throw new Error(`Anima "${anima}" not found in the Ledger.`);
-            }
-            if (animaRow.status !== 'active') {
-                throw new Error(`Anima "${anima}" is not active (status: ${animaRow.status}).`);
-            }
-            // Create assignment
-            db.prepare(`INSERT INTO commission_assignments (commission_id, anima_id) VALUES (?, ?)`).run(commissionId, animaRow.id);
-            assigned = true;
-            assignedTo = anima;
-        }
-        // Audit log
-        db.prepare(`INSERT INTO audit_log (actor, action, target_type, target_id, detail) VALUES (?, ?, ?, ?, ?)`).run('dispatch', assigned ? 'commission_dispatched_and_assigned' : 'commission_dispatched', 'commission', commissionId, JSON.stringify({ workshop, anima: assignedTo }));
-        return { commissionId, assigned, assignedTo };
-    }
-    finally {
-        db.close();
-    }
-}
-//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAsBpD;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC5C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAE7C,yCAAyC;IACzC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,aAAa,QAAQ,mDAAmD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAClH,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;QAEpD,oBAAoB;QACpB,MAAM,gBAAgB,GAAG,EAAE,CAAC,OAAO,CACjC,sEAAsE,CACvE,CAAC;QACF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC7E,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAE9D,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,UAA8B,CAAC;QAEnC,IAAI,KAAK,EAAE,CAAC;YACV,sCAAsC;YACtC,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CACzB,8CAA8C,CAC/C,CAAC,GAAG,CAAC,KAAK,CAA+C,CAAC;YAE3D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,4BAA4B,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,4BAA4B,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;YAClF,CAAC;YAED,oBAAoB;YACpB,EAAE,CAAC,OAAO,CACR,4EAA4E,CAC7E,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAEjC,QAAQ,GAAG,IAAI,CAAC;YAChB,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;QAED,YAAY;QACZ,EAAE,CAAC,OAAO,CACR,8FAA8F,CAC/F,CAAC,GAAG,CACH,UAAU,EACV,QAAQ,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,uBAAuB,EACzE,YAAY,EACZ,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAChD,CAAC;QAEF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}