@shardworks/nexus-core 0.1.1

package/dist/base-tools.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Base tools — the framework implements and engines that ship with Nexus.
+ *
+ * Each entry maps a tool name to the workspace package that contains it.
+ * The actual descriptors and instructions live in the packages themselves
+ * (nexus-implement.json / nexus-engine.json / instructions.md).
+ *
+ * During `nexus init`, these are installed into the guildhall via
+ * `installTool({ framework: true })` — the same code path used for all
+ * tool installation.
+ */
+/** Reference to a framework tool package. */
+export interface BaseToolRef {
+    /** Tool name — becomes the directory name in nexus/{implements,engines}/. */
+    name: string;
+    /** Workspace package that contains the tool. */
+    packageName: string;
+    /** Roles for implements (omit for engines or all-role implements). */
+    roles?: string[];
+}
+/** Base implements that ship with the framework. */
+export declare const BASE_IMPLEMENTS: BaseToolRef[];
+/** Base engines that ship with the framework. */
+export declare const BASE_ENGINES: BaseToolRef[];
+/** All base tools (implements + engines). */
+export declare const BASE_TOOLS: BaseToolRef[];
+//# sourceMappingURL=base-tools.d.ts.map

package/dist/base-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-tools.d.ts","sourceRoot":"","sources":["../src/base-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,oDAAoD;AACpD,eAAO,MAAM,eAAe,EAAE,WAAW,EAOxC,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,YAAY,EAAE,WAAW,EAKrC,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,UAAU,EAAE,WAAW,EAA0C,CAAC"}

package/dist/base-tools.js

@@ -0,0 +1,30 @@
+/**
+ * Base tools — the framework implements and engines that ship with Nexus.
+ *
+ * Each entry maps a tool name to the workspace package that contains it.
+ * The actual descriptors and instructions live in the packages themselves
+ * (nexus-implement.json / nexus-engine.json / instructions.md).
+ *
+ * During `nexus init`, these are installed into the guildhall via
+ * `installTool({ framework: true })` — the same code path used for all
+ * tool installation.
+ */
+/** Base implements that ship with the framework. */
+export const BASE_IMPLEMENTS = [
+    { name: 'install-tool', packageName: '@shardworks/implement-install-tool' },
+    { name: 'remove-tool', packageName: '@shardworks/implement-remove-tool' },
+    { name: 'dispatch', packageName: '@shardworks/implement-dispatch' },
+    { name: 'instantiate', packageName: '@shardworks/implement-instantiate' },
+    { name: 'publish', packageName: '@shardworks/implement-publish' },
+    { name: 'nexus-version', packageName: '@shardworks/implement-nexus-version' },
+];
+/** Base engines that ship with the framework. */
+export const BASE_ENGINES = [
+    { name: 'manifest', packageName: '@shardworks/engine-manifest' },
+    { name: 'mcp-server', packageName: '@shardworks/engine-mcp-server' },
+    { name: 'worktree-setup', packageName: '@shardworks/engine-worktree-setup' },
+    { name: 'ledger-migrate', packageName: '@shardworks/engine-ledger-migrate' },
+];
+/** All base tools (implements + engines). */
+export const BASE_TOOLS = [...BASE_IMPLEMENTS, ...BASE_ENGINES];
+//# sourceMappingURL=base-tools.js.map

package/dist/base-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-tools.js","sourceRoot":"","sources":["../src/base-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,EAAE,IAAI,EAAE,cAAc,EAAK,WAAW,EAAE,oCAAoC,EAAE;IAC9E,EAAE,IAAI,EAAE,aAAa,EAAM,WAAW,EAAE,mCAAmC,EAAE;IAC7E,EAAE,IAAI,EAAE,UAAU,EAAS,WAAW,EAAE,gCAAgC,EAAE;IAC1E,EAAE,IAAI,EAAE,aAAa,EAAM,WAAW,EAAE,mCAAmC,EAAE;IAC7E,EAAE,IAAI,EAAE,SAAS,EAAU,WAAW,EAAE,+BAA+B,EAAE;IACzE,EAAE,IAAI,EAAE,eAAe,EAAI,WAAW,EAAE,qCAAqC,EAAE;CAChF,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,EAAE,IAAI,EAAE,UAAU,EAAS,WAAW,EAAE,6BAA6B,EAAE;IACvE,EAAE,IAAI,EAAE,YAAY,EAAO,WAAW,EAAE,+BAA+B,EAAE;IACzE,EAAE,IAAI,EAAE,gBAAgB,EAAG,WAAW,EAAE,mCAAmC,EAAE;IAC7E,EAAE,IAAI,EAAE,gBAAgB,EAAG,WAAW,EAAE,mCAAmC,EAAE;CAC9E,CAAC;AAEF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAkB,CAAC,GAAG,eAAe,EAAE,GAAG,YAAY,CAAC,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Install all framework base tools into a freshly-initialized guild.
+ *
+ * Uses `installTool({ framework: true })` for every base implement and engine —
+ * the same code path used for all tool installation. Individual installs do not
+ * commit; a single "Bootstrap base tools" commit is created at the end.
+ *
+ * @param home - Absolute path to NEXUS_HOME.
+ * @param resolvePackage - Resolves a package name to its root directory on disk.
+ *   The caller owns resolution because it depends on the runtime module system
+ *   (workspace links, node_modules layout, etc.) which varies by context.
+ */
+export declare function bootstrapBaseTools(home: string, resolvePackage: (packageName: string) => string): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAC9C,IAAI,CA8BN"}

package/dist/bootstrap.js

@@ -0,0 +1,46 @@
+import { execFileSync } from 'node:child_process';
+import { guildhallWorktreePath } from "./nexus-home.js";
+import { installTool } from "./install-tool.js";
+import { BASE_IMPLEMENTS, BASE_ENGINES } from "./base-tools.js";
+/**
+ * Install all framework base tools into a freshly-initialized guild.
+ *
+ * Uses `installTool({ framework: true })` for every base implement and engine —
+ * the same code path used for all tool installation. Individual installs do not
+ * commit; a single "Bootstrap base tools" commit is created at the end.
+ *
+ * @param home - Absolute path to NEXUS_HOME.
+ * @param resolvePackage - Resolves a package name to its root directory on disk.
+ *   The caller owns resolution because it depends on the runtime module system
+ *   (workspace links, node_modules layout, etc.) which varies by context.
+ */
+export function bootstrapBaseTools(home, resolvePackage) {
+    // Install base implements
+    for (const ref of BASE_IMPLEMENTS) {
+        const sourceDir = resolvePackage(ref.packageName);
+        installTool({
+            home,
+            source: sourceDir,
+            name: ref.name,
+            roles: ref.roles ?? ['*'],
+            framework: true,
+            commit: false,
+        });
+    }
+    // Install base engines
+    for (const ref of BASE_ENGINES) {
+        const sourceDir = resolvePackage(ref.packageName);
+        installTool({
+            home,
+            source: sourceDir,
+            name: ref.name,
+            framework: true,
+            commit: false,
+        });
+    }
+    // Single commit for all bootstrap installs
+    const worktree = guildhallWorktreePath(home);
+    execFileSync('git', ['add', '-A'], { cwd: worktree, stdio: 'pipe' });
+    execFileSync('git', ['commit', '-m', 'Bootstrap base tools'], { cwd: worktree, stdio: 'pipe' });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,cAA+C;IAE/C,0BAA0B;IAC1B,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,WAAW,CAAC;YACV,IAAI;YACJ,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC;YACzB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,WAAW,CAAC;YACV,IAAI;YACJ,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAED,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,sBAAsB,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/dispatch.d.ts

@@ -0,0 +1,26 @@
+export interface DispatchOptions {
+    /** Absolute path to NEXUS_HOME. */
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,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

@@ -0,0 +1,55 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/dist/guild-config.d.ts

@@ -0,0 +1,51 @@
+/** A reference to an implement or engine registered in guild.json. */
+export interface ToolEntry {
+    /** Whether the tool is provided by the Nexus framework or authored by the guild. */
+    source: 'nexus' | 'guild';
+    /** Guild-local version slot — the directory name under {implements|engines}/{name}/. */
+    slot: string;
+    /** Upstream package identifier, e.g. "@shardworks/implement-dispatch@1.11.3". Null for locally-built tools. */
+    upstream: string | null;
+    /** ISO-8601 timestamp of when the tool was installed into this slot. */
+    installedAt: string;
+    /** Which roles have access (implements only). ["*"] means all roles. */
+    roles?: string[];
+}
+/** A reference to a curriculum or temperament registered in guild.json. */
+export interface TrainingEntry {
+    /** Guild-local version slot — the directory name under training/{curricula|temperaments}/{name}/. */
+    slot: string;
+    /** Upstream package identifier, or null for locally-authored content. */
+    upstream: string | null;
+    /** ISO-8601 timestamp of when the content was installed into this slot. */
+    installedAt: string;
+}
+/** The guild's central configuration file shape (`guild.json`). */
+export interface GuildConfig {
+    /** Installed Nexus framework version. */
+    nexus: string;
+    /** Default model for anima sessions. */
+    model: string;
+    /** Registered workshop names. */
+    workshops: string[];
+    /** Active implements indexed by name. */
+    implements: Record<string, ToolEntry>;
+    /** Active engines indexed by name. */
+    engines: Record<string, ToolEntry>;
+    /** Available curricula indexed by name. */
+    curricula: Record<string, TrainingEntry>;
+    /** Available temperaments indexed by name. */
+    temperaments: Record<string, TrainingEntry>;
+}
+/**
+ * Create the default guild.json content for a new guild.
+ * All registries (implements, engines, curricula, temperaments) start empty.
+ */
+export declare function createInitialGuildConfig(nexusVersion: string, model: string): GuildConfig;
+/** Resolve the path to guild.json in the standing worktree. */
+export declare function guildConfigPath(home: string): string;
+/** Read and parse guild.json from the standing worktree. */
+export declare function readGuildConfig(home: string): GuildConfig;
+/** Write guild.json to the standing worktree. */
+export declare function writeGuildConfig(home: string, config: GuildConfig): void;
+//# sourceMappingURL=guild-config.d.ts.map

package/dist/guild-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guild-config.d.ts","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"AAIA,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,oFAAoF;IACpF,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAUzF;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAGzD;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAGxE"}

package/dist/guild-config.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { guildhallWorktreePath } from "./nexus-home.js";
+/**
+ * Create the default guild.json content for a new guild.
+ * All registries (implements, engines, curricula, temperaments) start empty.
+ */
+export function createInitialGuildConfig(nexusVersion, model) {
+    return {
+        nexus: nexusVersion,
+        model,
+        workshops: [],
+        implements: {},
+        engines: {},
+        curricula: {},
+        temperaments: {},
+    };
+}
+/** Resolve the path to guild.json in the standing worktree. */
+export function guildConfigPath(home) {
+    return path.join(guildhallWorktreePath(home), 'guild.json');
+}
+/** Read and parse guild.json from the standing worktree. */
+export function readGuildConfig(home) {
+    const configFile = guildConfigPath(home);
+    return JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+}
+/** Write guild.json to the standing worktree. */
+export function writeGuildConfig(home, config) {
+    const configFile = guildConfigPath(home);
+    fs.writeFileSync(configFile, JSON.stringify(config, null, 2) + '\n');
+}
+//# sourceMappingURL=guild-config.js.map

package/dist/guild-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guild-config.js","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA4CxD;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAAoB,EAAE,KAAa;IAC1E,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,KAAK;QACL,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAgB,CAAC;AACzE,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAmB;IAChE,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/implement.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Implement SDK — the primary authoring interface for module-based implements.
+ *
+ * Use `implement()` to define a typed implement with Zod parameter schemas.
+ * The returned definition is what the MCP engine imports and registers as a tool,
+ * what the CLI uses to auto-generate subcommands, and what engines import directly.
+ *
+ * @example
+ * ```typescript
+ * import { implement } from '@shardworks/nexus-core';
+ * import { z } from 'zod';
+ *
+ * export default implement({
+ *   description: 'Look up an anima by name',
+ *   params: {
+ *     name: z.string().describe('Anima name'),
+ *   },
+ *   handler: async ({ name }, { home }) => {
+ *     // ... look up anima using home to find the guild ...
+ *     return { found: true, status: 'active' };
+ *   },
+ * });
+ * ```
+ */
+import { z } from 'zod';
+type ZodShape = Record<string, z.ZodType>;
+/**
+ * Framework-provided context injected into every implement handler call.
+ * The implement author doesn't construct this — the framework (MCP engine, CLI,
+ * or calling engine) provides it.
+ */
+export interface ImplementContext {
+    /** Absolute path to NEXUS_HOME. */
+    home: string;
+}
+/**
+ * A fully-defined implement — the return type of `implement()`.
+ *
+ * The MCP engine uses `.params.shape` to register the tool's input schema,
+ * `.description` for the tool description, and `.handler` to execute calls.
+ * The CLI uses `.params` to auto-generate Commander options.
+ * Engines call `.handler` directly.
+ */
+export interface ImplementDefinition<TShape extends ZodShape = ZodShape> {
+    readonly description: string;
+    readonly params: z.ZodObject<TShape>;
+    readonly handler: (params: z.infer<z.ZodObject<TShape>>, context: ImplementContext) => unknown | Promise<unknown>;
+}
+/**
+ * Define a Nexus implement.
+ *
+ * This is the primary SDK entry point for module-based implements. Pass a
+ * description, a params object of Zod schemas, and a handler function.
+ * The framework handles the rest — MCP registration, CLI generation, validation.
+ *
+ * The handler receives two arguments:
+ * - `params` — the validated input, typed from your Zod schemas
+ * - `context` — framework-injected context (NEXUS_HOME path, etc.)
+ *
+ * Return any JSON-serializable value. The MCP engine wraps it as tool output;
+ * the CLI prints it; engines use it directly.
+ */
+export declare function implement<TShape extends ZodShape>(def: {
+    description: string;
+    params: TShape;
+    handler: (params: z.infer<z.ZodObject<TShape>>, context: ImplementContext) => unknown | Promise<unknown>;
+}): ImplementDefinition<TShape>;
+export {};
+//# sourceMappingURL=implement.d.ts.map

package/dist/implement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../src/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,gBAAgB,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,QAAQ,EAAE,GAAG,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CACP,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,gBAAgB,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAM9B"}

package/dist/implement.js

@@ -0,0 +1,47 @@
+/**
+ * Implement SDK — the primary authoring interface for module-based implements.
+ *
+ * Use `implement()` to define a typed implement with Zod parameter schemas.
+ * The returned definition is what the MCP engine imports and registers as a tool,
+ * what the CLI uses to auto-generate subcommands, and what engines import directly.
+ *
+ * @example
+ * ```typescript
+ * import { implement } from '@shardworks/nexus-core';
+ * import { z } from 'zod';
+ *
+ * export default implement({
+ *   description: 'Look up an anima by name',
+ *   params: {
+ *     name: z.string().describe('Anima name'),
+ *   },
+ *   handler: async ({ name }, { home }) => {
+ *     // ... look up anima using home to find the guild ...
+ *     return { found: true, status: 'active' };
+ *   },
+ * });
+ * ```
+ */
+import { z } from 'zod';
+/**
+ * Define a Nexus implement.
+ *
+ * This is the primary SDK entry point for module-based implements. Pass a
+ * description, a params object of Zod schemas, and a handler function.
+ * The framework handles the rest — MCP registration, CLI generation, validation.
+ *
+ * The handler receives two arguments:
+ * - `params` — the validated input, typed from your Zod schemas
+ * - `context` — framework-injected context (NEXUS_HOME path, etc.)
+ *
+ * Return any JSON-serializable value. The MCP engine wraps it as tool output;
+ * the CLI prints it; engines use it directly.
+ */
+export function implement(def) {
+    return {
+        description: def.description,
+        params: z.object(def.params),
+        handler: def.handler,
+    };
+}
+//# sourceMappingURL=implement.js.map

package/dist/implement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement.js","sourceRoot":"","sources":["../src/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAA0B,GAOlD;IACC,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export declare const VERSION = "0.1.0";
+export { type ImplementContext, type ImplementDefinition, implement, } from './implement.ts';
+export { createLedger, INITIAL_SCHEMA } from './ledger.ts';
+export { type GuildConfig, type ToolEntry, type TrainingEntry, createInitialGuildConfig, guildConfigPath, readGuildConfig, writeGuildConfig, } from './guild-config.ts';
+export { resolveNexusHome, guildhallBarePath, guildhallWorktreePath, ledgerPath, worktreesPath, } from './nexus-home.ts';
+export { type InstallToolOptions, type InstallResult, installTool, } from './install-tool.ts';
+export { type RemoveToolOptions, type RemoveResult, removeTool, } from './remove-tool.ts';
+export { type DispatchOptions, type DispatchResult, dispatch, } from './dispatch.ts';
+export { type PublishOptions, type PublishResult, publish, } from './publish.ts';
+export { type InstantiateOptions, type InstantiateResult, instantiate, } from './instantiate.ts';
+export { type BaseToolRef, BASE_IMPLEMENTS, BASE_ENGINES, BASE_TOOLS, } from './base-tools.ts';
+export { initGuild } from './init-guild.ts';
+export { bootstrapBaseTools } from './bootstrap.ts';
+//# 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":"AAEA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,WAAW,EAChB,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// @shardworks/nexus-core — shared infrastructure for the guild system
+export const VERSION = '0.1.0';
+export { implement, } from "./implement.js";
+export { createLedger, INITIAL_SCHEMA } from "./ledger.js";
+export { createInitialGuildConfig, guildConfigPath, readGuildConfig, writeGuildConfig, } from "./guild-config.js";
+export { resolveNexusHome, guildhallBarePath, guildhallWorktreePath, ledgerPath, worktreesPath, } from "./nexus-home.js";
+export { installTool, } from "./install-tool.js";
+export { removeTool, } from "./remove-tool.js";
+export { dispatch, } from "./dispatch.js";
+export { publish, } from "./publish.js";
+export { instantiate, } from "./instantiate.js";
+export { BASE_IMPLEMENTS, BASE_ENGINES, BASE_TOOLS, } from "./base-tools.js";
+export { initGuild } from "./init-guild.js";
+export { bootstrapBaseTools } from "./bootstrap.js";
+//# 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,sEAAsE;AAEtE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAGL,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAIL,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/init-guild.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Create a new guild skeleton at the given path.
+ *
+ * Sets up the NEXUS_HOME directory structure: bare guildhall repo,
+ * standing worktree with scaffolded directories, empty guild.json,
+ * the initial migration file, and an initial git commit.
+ *
+ * This is the first step of guild creation. After this, the caller
+ * should bootstrap base tools and apply migrations:
+ *
+ *   initGuild(home, model)        // skeleton
+ *   bootstrapBaseTools(home, ...)  // install framework tools via installTool
+ *   applyMigrations(home)          // create ledger via migration engine
+ *
+ * @param home - Absolute path for the new NEXUS_HOME directory.
+ * @param model - Default model identifier for anima sessions.
+ * @throws If `home` exists and is not empty.
+ */
+export declare function initGuild(home: string, model: string): void;
+//# sourceMappingURL=init-guild.d.ts.map

package/dist/init-guild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-guild.d.ts","sourceRoot":"","sources":["../src/init-guild.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CA8D3D"}

package/dist/init-guild.js

@@ -0,0 +1,77 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { VERSION } from "./index.js";
+import { guildhallBarePath, guildhallWorktreePath } from "./nexus-home.js";
+import { createInitialGuildConfig } from "./guild-config.js";
+import { INITIAL_SCHEMA } from "./ledger.js";
+function git(args, cwd) {
+    execFileSync('git', args, { cwd, stdio: 'pipe' });
+}
+/**
+ * Create a new guild skeleton at the given path.
+ *
+ * Sets up the NEXUS_HOME directory structure: bare guildhall repo,
+ * standing worktree with scaffolded directories, empty guild.json,
+ * the initial migration file, and an initial git commit.
+ *
+ * This is the first step of guild creation. After this, the caller
+ * should bootstrap base tools and apply migrations:
+ *
+ *   initGuild(home, model)        // skeleton
+ *   bootstrapBaseTools(home, ...)  // install framework tools via installTool
+ *   applyMigrations(home)          // create ledger via migration engine
+ *
+ * @param home - Absolute path for the new NEXUS_HOME directory.
+ * @param model - Default model identifier for anima sessions.
+ * @throws If `home` exists and is not empty.
+ */
+export function initGuild(home, model) {
+    // Validate target
+    if (fs.existsSync(home)) {
+        const entries = fs.readdirSync(home);
+        if (entries.length > 0) {
+            throw new Error(`${home} exists and is not empty.`);
+        }
+    }
+    // Create NEXUS_HOME skeleton
+    const ghWorktree = guildhallWorktreePath(home);
+    fs.mkdirSync(path.dirname(ghWorktree), { recursive: true });
+    // Create guildhall bare repo
+    const ghBare = guildhallBarePath(home);
+    git(['init', '--bare', ghBare]);
+    // Create standing worktree
+    git(['-C', ghBare, 'worktree', 'add', '-b', 'main', ghWorktree]);
+    // Scaffold guildhall directory structure
+    const dirs = [
+        'nexus/implements',
+        'nexus/engines',
+        'nexus/migrations',
+        'implements',
+        'engines',
+        'codex/roles',
+        'training/curricula',
+        'training/temperaments',
+    ];
+    for (const dir of dirs) {
+        const full = path.join(ghWorktree, dir);
+        fs.mkdirSync(full, { recursive: true });
+        fs.writeFileSync(path.join(full, '.gitkeep'), '');
+    }
+    // Write initial migration
+    fs.writeFileSync(path.join(ghWorktree, 'nexus/migrations/001-initial-schema.sql'), INITIAL_SCHEMA.trimStart());
+    // Remove .gitkeep from migrations since it now has a real file
+    const migrationsGitkeep = path.join(ghWorktree, 'nexus/migrations/.gitkeep');
+    if (fs.existsSync(migrationsGitkeep)) {
+        fs.unlinkSync(migrationsGitkeep);
+    }
+    // Write codex placeholder
+    fs.writeFileSync(path.join(ghWorktree, 'codex/all.md'), '');
+    // Write guild.json — empty registries, tools will be installed via bootstrapBaseTools
+    const config = createInitialGuildConfig(VERSION, model);
+    fs.writeFileSync(path.join(ghWorktree, 'guild.json'), JSON.stringify(config, null, 2) + '\n');
+    // Initial commit
+    git(['add', '-A'], ghWorktree);
+    git(['commit', '-m', 'Initialize guild'], ghWorktree);
+}
+//# sourceMappingURL=init-guild.js.map

package/dist/init-guild.js.map

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

package/dist/install-tool.d.ts

@@ -0,0 +1,34 @@
+export interface InstallToolOptions {
+    /** Absolute path to the NEXUS_HOME directory. */
+    home: string;
+    /** Source — currently only local directory paths. */
+    source: string;
+    /** Override the tool name (defaults to source directory name). */
+    name?: string;
+    /** Override the version slot. */
+    slot?: string;
+    /** Roles for implements (comma-separated or array). */
+    roles?: string[];
+    /**
+     * Install as a framework tool (`source: 'nexus'`).
+     * Installs to `nexus/implements/` or `nexus/engines/` instead of
+     * guild-managed directories. Framework tools cannot be removed via remove-tool.
+     */
+    framework?: boolean;
+    /** Whether to create a git commit after installing. Defaults to true. */
+    commit?: boolean;
+}
+export interface InstallResult {
+    category: 'implements' | 'engines' | 'curricula' | 'temperaments';
+    name: string;
+    slot: string;
+    installedTo: string;
+}
+/**
+ * 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 declare function installTool(opts: InstallToolOptions): InstallResult;
+//# sourceMappingURL=install-tool.d.ts.map