@shardworks/nexus-core 0.1.1

package/dist/install-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-tool.d.ts","sourceRoot":"","sources":["../src/install-tool.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAkDD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAmFnE"}

package/dist/install-tool.js

@@ -0,0 +1,149 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { guildhallWorktreePath } from "./nexus-home.js";
+import { readGuildConfig, writeGuildConfig } from "./guild-config.js";
+/** Descriptor file names in priority order for detection. */
+const DESCRIPTOR_FILES = [
+    'nexus-implement.json',
+    'nexus-engine.json',
+    'nexus-curriculum.json',
+    'nexus-temperament.json',
+];
+/** Map descriptor file → artifact category in guild.json */
+const CATEGORY_MAP = {
+    'nexus-implement.json': 'implements',
+    'nexus-engine.json': 'engines',
+    'nexus-curriculum.json': 'curricula',
+    'nexus-temperament.json': 'temperaments',
+};
+/** Map category → on-disk parent directory (relative to guildhall worktree). */
+const DIR_MAP = {
+    implements: 'implements',
+    engines: 'engines',
+    curricula: 'training/curricula',
+    temperaments: 'training/temperaments',
+};
+function git(args, cwd) {
+    execFileSync('git', args, { cwd, stdio: 'pipe' });
+}
+/** Detect the descriptor file in a directory. Returns the filename or throws. */
+function findDescriptor(dir) {
+    for (const f of DESCRIPTOR_FILES) {
+        if (fs.existsSync(path.join(dir, f)))
+            return f;
+    }
+    throw new Error(`No descriptor found in ${dir}. Expected one of: ${DESCRIPTOR_FILES.join(', ')}`);
+}
+/** Read a JSON file, returning an empty object on missing fields. */
+function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+}
+/** Directories to skip when copying tool sources. */
+const SKIP_DIRS = new Set(['node_modules', '.git']);
+/** Recursively copy a directory, skipping node_modules and .git. */
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            if (!SKIP_DIRS.has(entry.name)) {
+                copyDir(srcPath, destPath);
+            }
+        }
+        else if (entry.isSymbolicLink()) {
+            // Resolve symlink and copy the target
+            const realPath = fs.realpathSync(srcPath);
+            if (fs.statSync(realPath).isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name)) {
+                    copyDir(realPath, destPath);
+                }
+            }
+            else {
+                fs.copyFileSync(realPath, destPath);
+            }
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Install a tool (implement, engine, curriculum, or temperament) into the guild.
+ *
+ * Currently supports local directory sources only. Detects the descriptor type,
+ * copies the directory to the correct slot, and registers in guild.json.
+ */
+export function installTool(opts) {
+    const { home, source, roles, framework = false, commit = true } = opts;
+    const worktree = guildhallWorktreePath(home);
+    // Resolve source to absolute path
+    const sourceDir = path.resolve(source);
+    if (!fs.existsSync(sourceDir) || !fs.statSync(sourceDir).isDirectory()) {
+        throw new Error(`Source is not a directory: ${sourceDir}`);
+    }
+    // Detect descriptor
+    const descriptorFile = findDescriptor(sourceDir);
+    const category = CATEGORY_MAP[descriptorFile];
+    const descriptor = readJson(path.join(sourceDir, descriptorFile));
+    // Read optional package.json for fallbacks
+    const pkgJsonPath = path.join(sourceDir, 'package.json');
+    const pkg = fs.existsSync(pkgJsonPath) ? readJson(pkgJsonPath) : {};
+    // Resolve name: --name flag > directory basename
+    const name = opts.name || path.basename(sourceDir);
+    if (!name || name === '.' || name === '..') {
+        throw new Error('Could not determine tool name. Use --name to specify one.');
+    }
+    // Resolve slot: --slot flag > descriptor version > package.json version > error
+    const version = descriptor['version']
+        || pkg['version'];
+    const slot = opts.slot || version;
+    if (!slot) {
+        throw new Error('No version found in descriptor or package.json. Use --slot to specify a version slot.');
+    }
+    // Determine target directory.
+    // Framework tools go under nexus/{implements,engines}/.
+    // Guild tools go under {implements,engines}/ (or training/ for curricula/temperaments).
+    const parentDir = DIR_MAP[category];
+    const prefix = framework && (category === 'implements' || category === 'engines')
+        ? path.join('nexus', parentDir)
+        : parentDir;
+    const targetDir = path.join(worktree, prefix, name, slot);
+    // Copy source to target
+    if (fs.existsSync(targetDir)) {
+        fs.rmSync(targetDir, { recursive: true });
+    }
+    copyDir(sourceDir, targetDir);
+    // Register in guild.json
+    const config = readGuildConfig(home);
+    const now = new Date().toISOString();
+    if (category === 'implements' || category === 'engines') {
+        const entry = {
+            source: framework ? 'nexus' : 'guild',
+            slot,
+            upstream: null,
+            installedAt: now,
+        };
+        if (category === 'implements' && roles && roles.length > 0) {
+            entry.roles = roles;
+        }
+        config[category][name] = entry;
+    }
+    else {
+        const entry = {
+            slot,
+            upstream: null,
+            installedAt: now,
+        };
+        config[category][name] = entry;
+    }
+    writeGuildConfig(home, config);
+    // Commit (unless suppressed — e.g. during bootstrap)
+    if (commit) {
+        git(['add', '-A'], worktree);
+        git(['commit', '-m', `Install ${category.slice(0, -1)} ${name}@${slot}`], worktree);
+    }
+    return { category, name, slot, installedTo: targetDir };
+}
+//# sourceMappingURL=install-tool.js.map

package/dist/install-tool.js.map

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

package/dist/instantiate.d.ts

@@ -0,0 +1,28 @@
+export interface InstantiateOptions {
+    /** Absolute path to NEXUS_HOME. */
+    home: string;
+    /** Name for the new anima. Must be unique within the guild. */
+    name: string;
+    /** Roles the anima will hold (determines implement access via role gating). */
+    roles: string[];
+    /** Curriculum to assign (by name, must be registered in guild.json). */
+    curriculum?: string;
+    /** Temperament to assign (by name, must be registered in guild.json). */
+    temperament?: string;
+}
+export interface InstantiateResult {
+    animaId: number;
+    name: string;
+    roles: string[];
+    curriculum: string | null;
+    temperament: string | null;
+}
+/**
+ * Instantiate a new anima in the guild.
+ *
+ * Creates the anima record, assigns roles in the roster, and snapshots the
+ * composition (curriculum + temperament content at current versions). All
+ * operations happen in a single transaction.
+ */
+export declare function instantiate(opts: InstantiateOptions): InstantiateResult;
+//# sourceMappingURL=instantiate.d.ts.map

package/dist/instantiate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instantiate.d.ts","sourceRoot":"","sources":["../src/instantiate.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA6CD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAyGvE"}

package/dist/instantiate.js

@@ -0,0 +1,113 @@
+/**
+ * instantiate — core logic for creating new animas.
+ *
+ * Creates an anima record in the Ledger with its full composition: roles,
+ * curriculum, and temperament. Reads and snapshots the training content at
+ * instantiation time so the anima's composition is frozen to specific versions.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { ledgerPath, guildhallWorktreePath } from "./nexus-home.js";
+import { readGuildConfig } from "./guild-config.js";
+/**
+ * Read training content from disk given its guild.json entry.
+ *
+ * @param worktree - Path to the guildhall worktree.
+ * @param category - 'curricula' or 'temperaments'.
+ * @param name - The training content name.
+ * @param slot - The version slot.
+ * @returns Object with version and the actual content text.
+ */
+function readTrainingContent(worktree, category, name, slot) {
+    const dir = path.join(worktree, 'training', category, name, slot);
+    const descriptorFile = category === 'curricula'
+        ? 'nexus-curriculum.json'
+        : 'nexus-temperament.json';
+    const descriptorPath = path.join(dir, descriptorFile);
+    if (!fs.existsSync(descriptorPath)) {
+        throw new Error(`${category.slice(0, -1)} "${name}" slot "${slot}" not found on disk at ${dir}`);
+    }
+    const descriptor = JSON.parse(fs.readFileSync(descriptorPath, 'utf-8'));
+    const contentFile = descriptor.content;
+    const contentPath = path.join(dir, contentFile);
+    if (!fs.existsSync(contentPath)) {
+        throw new Error(`Content file "${contentFile}" not found for ${category.slice(0, -1)} "${name}" at ${contentPath}`);
+    }
+    return {
+        version: slot,
+        content: fs.readFileSync(contentPath, 'utf-8'),
+    };
+}
+/**
+ * Instantiate a new anima in the guild.
+ *
+ * Creates the anima record, assigns roles in the roster, and snapshots the
+ * composition (curriculum + temperament content at current versions). All
+ * operations happen in a single transaction.
+ */
+export function instantiate(opts) {
+    const { home, name, roles, curriculum, temperament } = opts;
+    const worktree = guildhallWorktreePath(home);
+    if (roles.length === 0) {
+        throw new Error('At least one role is required.');
+    }
+    // Validate curriculum and temperament exist in guild.json
+    const config = readGuildConfig(home);
+    if (curriculum && !config.curricula[curriculum]) {
+        throw new Error(`Curriculum "${curriculum}" not found in guild.json. Available: ${Object.keys(config.curricula).join(', ') || '(none)'}`);
+    }
+    if (temperament && !config.temperaments[temperament]) {
+        throw new Error(`Temperament "${temperament}" not found in guild.json. Available: ${Object.keys(config.temperaments).join(', ') || '(none)'}`);
+    }
+    // Read and snapshot training content
+    let curriculumSnapshot = null;
+    if (curriculum) {
+        const entry = config.curricula[curriculum];
+        const { version, content } = readTrainingContent(worktree, 'curricula', curriculum, entry.slot);
+        curriculumSnapshot = { name: curriculum, version, content };
+    }
+    let temperamentSnapshot = null;
+    if (temperament) {
+        const entry = config.temperaments[temperament];
+        const { version, content } = readTrainingContent(worktree, 'temperaments', temperament, entry.slot);
+        temperamentSnapshot = { name: temperament, version, content };
+    }
+    const db = new Database(ledgerPath(home));
+    db.pragma('foreign_keys = ON');
+    try {
+        const result = db.transaction(() => {
+            // Check name uniqueness
+            const existing = db.prepare(`SELECT id FROM animas WHERE name = ?`).get(name);
+            if (existing) {
+                throw new Error(`Anima "${name}" already exists in the Ledger.`);
+            }
+            // Create anima
+            const insertAnima = db.prepare(`INSERT INTO animas (name, status) VALUES (?, 'active')`);
+            const animaResult = insertAnima.run(name);
+            const animaId = Number(animaResult.lastInsertRowid);
+            // Assign roles in roster
+            const insertRole = db.prepare(`INSERT INTO roster (anima_id, role) VALUES (?, ?)`);
+            for (const role of roles) {
+                insertRole.run(animaId, role);
+            }
+            // Record composition snapshot
+            db.prepare(`INSERT INTO anima_compositions (anima_id, curriculum_name, curriculum_version, curriculum_snapshot, temperament_name, temperament_version, temperament_snapshot)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`).run(animaId, curriculumSnapshot?.name ?? '', curriculumSnapshot?.version ?? '', curriculumSnapshot?.content ?? '', temperamentSnapshot?.name ?? '', temperamentSnapshot?.version ?? '', temperamentSnapshot?.content ?? '');
+            // Audit log
+            db.prepare(`INSERT INTO audit_log (actor, action, target_type, target_id, detail) VALUES (?, ?, ?, ?, ?)`).run('instantiate', 'anima_instantiated', 'anima', animaId, JSON.stringify({ roles, curriculum: curriculum ?? null, temperament: temperament ?? null }));
+            return animaId;
+        })();
+        return {
+            animaId: result,
+            name,
+            roles,
+            curriculum: curriculum ?? null,
+            temperament: temperament ?? null,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=instantiate.js.map

package/dist/instantiate.js.map

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

package/dist/ledger.d.ts

@@ -0,0 +1,8 @@
+/** SQL for the initial Ledger schema (001). Creates all base tables with WAL mode and foreign keys. */
+export declare const INITIAL_SCHEMA = "\nPRAGMA journal_mode = WAL;\nPRAGMA foreign_keys = ON;\n\nCREATE TABLE animas (\n    id          INTEGER PRIMARY KEY AUTOINCREMENT,\n    name        TEXT    NOT NULL UNIQUE,\n    status      TEXT    NOT NULL CHECK(status IN ('aspirant', 'active', 'retired')),\n    created_at  TEXT    NOT NULL DEFAULT (datetime('now')),\n    updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE anima_compositions (\n    id                    INTEGER PRIMARY KEY AUTOINCREMENT,\n    anima_id              INTEGER NOT NULL UNIQUE REFERENCES animas(id),\n    curriculum_name       TEXT    NOT NULL,\n    curriculum_version    TEXT    NOT NULL,\n    temperament_name      TEXT    NOT NULL,\n    temperament_version   TEXT    NOT NULL,\n    curriculum_snapshot   TEXT    NOT NULL,\n    temperament_snapshot  TEXT    NOT NULL,\n    composed_at           TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE roster (\n    id          INTEGER PRIMARY KEY AUTOINCREMENT,\n    anima_id    INTEGER NOT NULL REFERENCES animas(id),\n    role        TEXT    NOT NULL,\n    standing    INTEGER NOT NULL DEFAULT 0,\n    assigned_at TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE commissions (\n    id          INTEGER PRIMARY KEY AUTOINCREMENT,\n    content     TEXT    NOT NULL,\n    status      TEXT    NOT NULL CHECK(status IN ('posted', 'assigned', 'in_progress', 'completed', 'failed')),\n    workshop    TEXT    NOT NULL,\n    created_at  TEXT    NOT NULL DEFAULT (datetime('now')),\n    updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE commission_assignments (\n    id              INTEGER PRIMARY KEY AUTOINCREMENT,\n    commission_id   INTEGER NOT NULL REFERENCES commissions(id),\n    anima_id        INTEGER NOT NULL REFERENCES animas(id),\n    assigned_at     TEXT    NOT NULL DEFAULT (datetime('now')),\n    UNIQUE(commission_id, anima_id)\n);\n\nCREATE TABLE audit_log (\n    id          INTEGER PRIMARY KEY AUTOINCREMENT,\n    actor       TEXT    NOT NULL,\n    action      TEXT    NOT NULL,\n    target_type TEXT,\n    target_id   INTEGER,\n    detail      TEXT,\n    timestamp   TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n";
+/**
+ * Create a new Ledger database at the given path and apply the initial schema.
+ * @param dbPath - Absolute path where the SQLite file will be created.
+ */
+export declare function createLedger(dbPath: string): void;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAEA,uGAAuG;AACvG,eAAO,MAAM,cAAc,ipEA0D1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOjD"}

package/dist/ledger.js

@@ -0,0 +1,75 @@
+import Database from 'better-sqlite3';
+/** SQL for the initial Ledger schema (001). Creates all base tables with WAL mode and foreign keys. */
+export const INITIAL_SCHEMA = `
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE animas (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    name        TEXT    NOT NULL UNIQUE,
+    status      TEXT    NOT NULL CHECK(status IN ('aspirant', 'active', 'retired')),
+    created_at  TEXT    NOT NULL DEFAULT (datetime('now')),
+    updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE anima_compositions (
+    id                    INTEGER PRIMARY KEY AUTOINCREMENT,
+    anima_id              INTEGER NOT NULL UNIQUE REFERENCES animas(id),
+    curriculum_name       TEXT    NOT NULL,
+    curriculum_version    TEXT    NOT NULL,
+    temperament_name      TEXT    NOT NULL,
+    temperament_version   TEXT    NOT NULL,
+    curriculum_snapshot   TEXT    NOT NULL,
+    temperament_snapshot  TEXT    NOT NULL,
+    composed_at           TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE roster (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    anima_id    INTEGER NOT NULL REFERENCES animas(id),
+    role        TEXT    NOT NULL,
+    standing    INTEGER NOT NULL DEFAULT 0,
+    assigned_at TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE commissions (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    content     TEXT    NOT NULL,
+    status      TEXT    NOT NULL CHECK(status IN ('posted', 'assigned', 'in_progress', 'completed', 'failed')),
+    workshop    TEXT    NOT NULL,
+    created_at  TEXT    NOT NULL DEFAULT (datetime('now')),
+    updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE commission_assignments (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    commission_id   INTEGER NOT NULL REFERENCES commissions(id),
+    anima_id        INTEGER NOT NULL REFERENCES animas(id),
+    assigned_at     TEXT    NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(commission_id, anima_id)
+);
+
+CREATE TABLE audit_log (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    actor       TEXT    NOT NULL,
+    action      TEXT    NOT NULL,
+    target_type TEXT,
+    target_id   INTEGER,
+    detail      TEXT,
+    timestamp   TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+`;
+/**
+ * Create a new Ledger database at the given path and apply the initial schema.
+ * @param dbPath - Absolute path where the SQLite file will be created.
+ */
+export function createLedger(dbPath) {
+    const db = new Database(dbPath);
+    try {
+        db.exec(INITIAL_SCHEMA);
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,uGAAuG;AACvG,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0D7B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/nexus-home.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve NEXUS_HOME from the environment.
+ * @throws If `NEXUS_HOME` is not set.
+ */
+export declare function resolveNexusHome(): string;
+/** Path to the guildhall bare git repo. */
+export declare function guildhallBarePath(home: string): string;
+/** Path to the guildhall's standing worktree (`worktrees/guildhall/main`). */
+export declare function guildhallWorktreePath(home: string): string;
+/** Path to the Ledger SQLite database. */
+export declare function ledgerPath(home: string): string;
+/** Path to the top-level worktrees directory. */
+export declare function worktreesPath(home: string): string;
+//# sourceMappingURL=nexus-home.d.ts.map

package/dist/nexus-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-home.d.ts","sourceRoot":"","sources":["../src/nexus-home.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/nexus-home.js

@@ -0,0 +1,29 @@
+import path from 'node:path';
+/**
+ * Resolve NEXUS_HOME from the environment.
+ * @throws If `NEXUS_HOME` is not set.
+ */
+export function resolveNexusHome() {
+    const home = process.env['NEXUS_HOME'];
+    if (!home) {
+        throw new Error('NEXUS_HOME is not set. Run `nexus init <path>` to create a guild, then set NEXUS_HOME to that path.');
+    }
+    return path.resolve(home);
+}
+/** Path to the guildhall bare git repo. */
+export function guildhallBarePath(home) {
+    return path.join(home, 'guildhall');
+}
+/** Path to the guildhall's standing worktree (`worktrees/guildhall/main`). */
+export function guildhallWorktreePath(home) {
+    return path.join(home, 'worktrees', 'guildhall', 'main');
+}
+/** Path to the Ledger SQLite database. */
+export function ledgerPath(home) {
+    return path.join(home, 'nexus.db');
+}
+/** Path to the top-level worktrees directory. */
+export function worktreesPath(home) {
+    return path.join(home, 'worktrees');
+}
+//# sourceMappingURL=nexus-home.js.map

package/dist/nexus-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-home.js","sourceRoot":"","sources":["../src/nexus-home.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,qGAAqG,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC"}

package/dist/publish.d.ts

@@ -0,0 +1,20 @@
+export interface PublishOptions {
+    /** Absolute path to NEXUS_HOME. */
+    home: string;
+    /** Commission ID to publish. */
+    commissionId: number;
+    /** Brief summary of what was accomplished. */
+    summary?: string;
+}
+export interface PublishResult {
+    commissionId: number;
+    previousStatus: string;
+}
+/**
+ * Publish a completed commission.
+ *
+ * Validates the commission exists and is in an assignable state (assigned or
+ * in_progress), then marks it as completed. Records the event in the audit log.
+ */
+export declare function publish(opts: PublishOptions): PublishResult;
+//# sourceMappingURL=publish.d.ts.map

package/dist/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CA8C3D"}

package/dist/publish.js

@@ -0,0 +1,41 @@
+/**
+ * publish — core logic for completing commissions.
+ *
+ * Marks a commission as completed in the Ledger. The publish implement
+ * and CLI both call this function.
+ */
+import Database from 'better-sqlite3';
+import { ledgerPath } from "./nexus-home.js";
+/**
+ * Publish a completed commission.
+ *
+ * Validates the commission exists and is in an assignable state (assigned or
+ * in_progress), then marks it as completed. Records the event in the audit log.
+ */
+export function publish(opts) {
+    const { home, commissionId, summary } = opts;
+    const db = new Database(ledgerPath(home));
+    db.pragma('foreign_keys = ON');
+    try {
+        // Read current commission state
+        const commission = db.prepare(`SELECT id, status FROM commissions WHERE id = ?`).get(commissionId);
+        if (!commission) {
+            throw new Error(`Commission ${commissionId} not found in the Ledger.`);
+        }
+        const completableStatuses = ['assigned', 'in_progress'];
+        if (!completableStatuses.includes(commission.status)) {
+            throw new Error(`Commission ${commissionId} cannot be published — current status is "${commission.status}". ` +
+                `Must be one of: ${completableStatuses.join(', ')}.`);
+        }
+        const previousStatus = commission.status;
+        // Mark as completed
+        db.prepare(`UPDATE commissions SET status = 'completed', updated_at = datetime('now') WHERE id = ?`).run(commissionId);
+        // Audit log
+        db.prepare(`INSERT INTO audit_log (actor, action, target_type, target_id, detail) VALUES (?, ?, ?, ?, ?)`).run('publish', 'commission_published', 'commission', commissionId, JSON.stringify({ previousStatus, summary: summary ?? null }));
+        return { commissionId, previousStatus };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgB7C;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAoB;IAC1C,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE7C,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,gCAAgC;QAChC,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B,iDAAiD,CAClD,CAAC,GAAG,CAAC,YAAY,CAA+C,CAAC;QAElE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,cAAc,YAAY,2BAA2B,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,cAAc,YAAY,6CAA6C,UAAU,CAAC,MAAM,KAAK;gBAC7F,mBAAmB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrD,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;QAEzC,oBAAoB;QACpB,EAAE,CAAC,OAAO,CACR,wFAAwF,CACzF,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAEpB,YAAY;QACZ,EAAE,CAAC,OAAO,CACR,8FAA8F,CAC/F,CAAC,GAAG,CACH,SAAS,EACT,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC,CAC7D,CAAC;QAEF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/remove-tool.d.ts

@@ -0,0 +1,20 @@
+export interface RemoveToolOptions {
+    home: string;
+    name: string;
+    /** Restrict to a specific category. If omitted, searches all registries. */
+    category?: 'implements' | 'engines' | 'curricula' | 'temperaments';
+}
+export interface RemoveResult {
+    category: 'implements' | 'engines' | 'curricula' | 'temperaments';
+    name: string;
+    slot: string;
+    removedFrom: string;
+}
+/**
+ * Remove a tool from the guild — deregister from guild.json and delete from disk.
+ *
+ * Only guild-managed tools can be removed. Framework (nexus) tools are managed
+ * by `nexus repair` / `nexus install`.
+ */
+export declare function removeTool(opts: RemoveToolOptions): RemoveResult;
+//# sourceMappingURL=remove-tool.d.ts.map

package/dist/remove-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-tool.d.ts","sourceRoot":"","sources":["../src/remove-tool.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;CACpE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAoDhE"}

package/dist/remove-tool.js

@@ -0,0 +1,64 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { guildhallWorktreePath } from "./nexus-home.js";
+import { readGuildConfig, writeGuildConfig } from "./guild-config.js";
+const DIR_MAP = {
+    implements: 'implements',
+    engines: 'engines',
+    curricula: 'training/curricula',
+    temperaments: 'training/temperaments',
+};
+/** The registries in guild.json that can contain tools, in search order. */
+const REGISTRIES = ['implements', 'engines', 'curricula', 'temperaments'];
+function git(args, cwd) {
+    execFileSync('git', args, { cwd, stdio: 'pipe' });
+}
+/**
+ * Remove a tool from the guild — deregister from guild.json and delete from disk.
+ *
+ * Only guild-managed tools can be removed. Framework (nexus) tools are managed
+ * by `nexus repair` / `nexus install`.
+ */
+export function removeTool(opts) {
+    const { home, name } = opts;
+    const worktree = guildhallWorktreePath(home);
+    const config = readGuildConfig(home);
+    // Find the tool in guild.json
+    const searchIn = opts.category ? [opts.category] : REGISTRIES;
+    let foundCategory;
+    for (const cat of searchIn) {
+        if (config[cat][name]) {
+            foundCategory = cat;
+            break;
+        }
+    }
+    if (!foundCategory) {
+        throw new Error(`Tool "${name}" not found in guild.json.`);
+    }
+    const entry = config[foundCategory][name];
+    const slot = 'slot' in entry ? entry.slot : '';
+    // Prevent removal of framework tools
+    if ('source' in entry && entry.source === 'nexus') {
+        throw new Error(`"${name}" is a framework tool (source: nexus). Use "nexus repair" to manage framework tools.`);
+    }
+    // Remove on-disk directory (the specific slot)
+    const parentDir = DIR_MAP[foundCategory];
+    const toolDir = path.join(worktree, parentDir, name, slot);
+    const toolParent = path.join(worktree, parentDir, name);
+    if (fs.existsSync(toolDir)) {
+        fs.rmSync(toolDir, { recursive: true });
+    }
+    // Remove the parent name directory if now empty
+    if (fs.existsSync(toolParent) && fs.readdirSync(toolParent).length === 0) {
+        fs.rmdirSync(toolParent);
+    }
+    // Deregister from guild.json
+    delete config[foundCategory][name];
+    writeGuildConfig(home, config);
+    // Commit
+    git(['add', '-A'], worktree);
+    git(['commit', '-m', `Remove ${foundCategory.slice(0, -1)} ${name}`], worktree);
+    return { category: foundCategory, name, slot, removedFrom: toolDir };
+}
+//# sourceMappingURL=remove-tool.js.map

package/dist/remove-tool.js.map

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