@shardworks/nexus-core 0.1.5 → 0.1.6

package/dist/bundle.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Bundle — a manifest that delivers multiple installable artifacts to a guild.
+ *
+ * A bundle is a recipe, not a dependency. The installer reads the manifest,
+ * installs each artifact individually (via installTool), and discards the
+ * bundle itself. Each artifact becomes an independent guild dependency.
+ *
+ * ## Manifest: `nexus-bundle.json`
+ *
+ * The manifest has explicit top-level arrays for each artifact category:
+ * - `implements` and `engines` require a `package` specifier (runtime code)
+ * - `curricula` and `temperaments` support `package` OR `path` (content-only)
+ *
+ * ## Transitive bundles
+ *
+ * A package entry can itself contain a `nexus-bundle.json`. The installer
+ * recurses, so bundles can compose other bundles.
+ */
+/** A package-based artifact entry (implements and engines). */
+export interface BundlePackageEntry {
+    /** npm package specifier or git URL. */
+    package: string;
+    /** Override the artifact name in the guild. */
+    name?: string;
+    /** Roles for implements (which roles can use this tool). */
+    roles?: string[];
+}
+/** A content artifact entry (curricula and temperaments). */
+export interface BundleContentEntry {
+    /** npm package specifier or git URL. */
+    package?: string;
+    /** Path relative to the bundle root for inline content. */
+    path?: string;
+    /** Override the artifact name in the guild. */
+    name?: string;
+}
+/** A migration entry (always inline via `path`). */
+export interface BundleMigrationEntry {
+    /** Path relative to the bundle root for the .sql file. */
+    path: string;
+}
+/** The `nexus-bundle.json` manifest shape. */
+export interface BundleManifest {
+    /** Human-readable description of the bundle. */
+    description?: string;
+    /** Implements to install (require `package`). */
+    implements?: BundlePackageEntry[];
+    /** Engines to install (require `package`). */
+    engines?: BundlePackageEntry[];
+    /** Curricula to install (`package` or `path`). */
+    curricula?: BundleContentEntry[];
+    /** Temperaments to install (`package` or `path`). */
+    temperaments?: BundleContentEntry[];
+    /** Migrations to install (always inline, renumbered on install). */
+    migrations?: BundleMigrationEntry[];
+}
+export interface InstallBundleOptions {
+    /** Absolute path to the guild root directory. */
+    home: string;
+    /** Absolute path to the bundle directory (contains nexus-bundle.json). */
+    bundleDir: string;
+    /** Bundle provenance string, e.g. "@shardworks/guild-starter-kit@0.1.0". */
+    bundleSource?: string;
+    /** Whether to create a git commit after installing. Defaults to true. */
+    commit?: boolean;
+}
+export interface InstallBundleResult {
+    /** Number of artifacts installed. */
+    installed: number;
+    /** Names of installed artifacts, grouped by category. */
+    artifacts: {
+        implements: string[];
+        engines: string[];
+        curricula: string[];
+        temperaments: string[];
+        migrations: string[];
+    };
+    /** Provenance map for installed migrations: guild filename → { bundle, originalName }. */
+    migrationProvenance?: Record<string, {
+        bundle: string;
+        originalName: string;
+    }>;
+}
+/**
+ * Check if a directory contains a nexus-bundle.json manifest.
+ */
+export declare function isBundleDir(dir: string): boolean;
+/**
+ * Read and validate a nexus-bundle.json manifest.
+ *
+ * Enforces schema rules:
+ * - implements/engines must use `package`, not `path`
+ * - curricula/temperaments must have either `package` or `path`
+ */
+export declare function readBundleManifest(bundleDir: string): BundleManifest;
+/**
+ * Install a bundle into a guild.
+ *
+ * Reads the bundle manifest, installs all referenced artifacts individually,
+ * and optionally commits the result. The bundle itself is NOT retained as
+ * a guild dependency — each artifact is installed independently.
+ *
+ * Package artifacts (implements, engines, and packaged content) are installed
+ * via npm. Inline content artifacts (curricula/temperaments with `path`) are
+ * copied directly from the bundle directory.
+ *
+ * If an installed package contains its own `nexus-bundle.json`, the installer
+ * recurses to install the transitive bundle's artifacts.
+ */
+export declare function installBundle(opts: InstallBundleOptions): InstallBundleResult;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAUH,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,kDAAkD;IAClD,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,qDAAqD;IACrD,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC,oEAAoE;IACpE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAID,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAkCD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CA+DpE;AA8ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,mBAAmB,CAqP7E"}

package/dist/bundle.js

@@ -0,0 +1,438 @@
+/**
+ * Bundle — a manifest that delivers multiple installable artifacts to a guild.
+ *
+ * A bundle is a recipe, not a dependency. The installer reads the manifest,
+ * installs each artifact individually (via installTool), and discards the
+ * bundle itself. Each artifact becomes an independent guild dependency.
+ *
+ * ## Manifest: `nexus-bundle.json`
+ *
+ * The manifest has explicit top-level arrays for each artifact category:
+ * - `implements` and `engines` require a `package` specifier (runtime code)
+ * - `curricula` and `temperaments` support `package` OR `path` (content-only)
+ *
+ * ## Transitive bundles
+ *
+ * A package entry can itself contain a `nexus-bundle.json`. The installer
+ * recurses, so bundles can compose other bundles.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { installTool } from "./install-tool.js";
+import { readGuildConfig, writeGuildConfig } from "./guild-config.js";
+// ── Helpers ─────────────────────────────────────────────────────────────
+const BUNDLE_MANIFEST = 'nexus-bundle.json';
+function git(args, cwd) {
+    execFileSync('git', args, { cwd, stdio: 'pipe' });
+}
+function npm(args, cwd) {
+    return execFileSync('npm', args, { cwd, stdio: 'pipe', encoding: 'utf-8' });
+}
+function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+}
+// ── Descriptor types for each category ──────────────────────────────────
+const DESCRIPTOR_MAP = {
+    implements: 'nexus-implement.json',
+    engines: 'nexus-engine.json',
+    curricula: 'nexus-curriculum.json',
+    temperaments: 'nexus-temperament.json',
+};
+const DIR_MAP = {
+    implements: 'implements',
+    engines: 'engines',
+    curricula: 'training/curricula',
+    temperaments: 'training/temperaments',
+};
+/**
+ * Check if a directory contains a nexus-bundle.json manifest.
+ */
+export function isBundleDir(dir) {
+    return fs.existsSync(path.join(dir, BUNDLE_MANIFEST));
+}
+// ── Validation ──────────────────────────────────────────────────────────
+/**
+ * Read and validate a nexus-bundle.json manifest.
+ *
+ * Enforces schema rules:
+ * - implements/engines must use `package`, not `path`
+ * - curricula/temperaments must have either `package` or `path`
+ */
+export function readBundleManifest(bundleDir) {
+    const manifestPath = path.join(bundleDir, BUNDLE_MANIFEST);
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`No ${BUNDLE_MANIFEST} found in ${bundleDir}`);
+    }
+    const manifest = readJson(manifestPath);
+    // Validate implements: must have package, no path allowed
+    for (const entry of manifest.implements ?? []) {
+        if (!entry.package) {
+            throw new Error('Implements must have a "package" specifier. ' +
+                'Implements have runtime code and potential npm dependencies — they cannot be inline.');
+        }
+        if ('path' in entry) {
+            throw new Error('Implements must be npm packages or git URLs. Use a "package" specifier instead of "path".');
+        }
+    }
+    // Validate engines: must have package, no path allowed
+    for (const entry of manifest.engines ?? []) {
+        if (!entry.package) {
+            throw new Error('Engines must have a "package" specifier. ' +
+                'Engines have runtime code and potential npm dependencies — they cannot be inline.');
+        }
+        if ('path' in entry) {
+            throw new Error('Engines must be npm packages or git URLs. Use a "package" specifier instead of "path".');
+        }
+    }
+    // Validate content entries: must have package or path
+    for (const entry of manifest.curricula ?? []) {
+        if (!entry.package && !entry.path) {
+            throw new Error('Curriculum entries must have either a "package" or "path" specifier.');
+        }
+    }
+    for (const entry of manifest.temperaments ?? []) {
+        if (!entry.package && !entry.path) {
+            throw new Error('Temperament entries must have either a "package" or "path" specifier.');
+        }
+    }
+    // Validate migrations: must have path, no package allowed
+    for (const entry of manifest.migrations ?? []) {
+        if (!entry.path) {
+            throw new Error('Migration entries must have a "path" specifier.');
+        }
+        if ('package' in entry) {
+            throw new Error('Migrations must be inline SQL files. Use a "path" specifier instead of "package".');
+        }
+    }
+    return manifest;
+}
+// ── Inline content installation ─────────────────────────────────────────
+/**
+ * Install an inline content artifact (curriculum or temperament) from a
+ * path relative to the bundle directory.
+ *
+ * Copies the full directory to the guild slot and registers in guild.json.
+ */
+function installInlineContent(home, bundleDir, category, entry, bundleSource) {
+    const contentDir = path.resolve(bundleDir, entry.path);
+    if (!fs.existsSync(contentDir)) {
+        throw new Error(`Inline content path not found: ${contentDir}`);
+    }
+    // Read descriptor to get version
+    const descriptorFile = DESCRIPTOR_MAP[category];
+    const descriptorPath = path.join(contentDir, descriptorFile);
+    if (!fs.existsSync(descriptorPath)) {
+        throw new Error(`No ${descriptorFile} found in ${contentDir}`);
+    }
+    const descriptor = readJson(descriptorPath);
+    const name = entry.name || path.basename(contentDir);
+    const slot = descriptor['version'];
+    if (!slot) {
+        throw new Error(`No version in ${descriptorPath}`);
+    }
+    // Copy full directory to guild slot
+    const parentDir = DIR_MAP[category];
+    const targetDir = path.join(home, parentDir, name, slot);
+    if (fs.existsSync(targetDir)) {
+        fs.rmSync(targetDir, { recursive: true });
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    copyDir(contentDir, targetDir);
+    // Register in guild.json
+    const config = readGuildConfig(home);
+    config[category][name] = {
+        slot,
+        upstream: null,
+        installedAt: new Date().toISOString(),
+        ...(bundleSource ? { bundle: bundleSource } : {}),
+    };
+    writeGuildConfig(home, config);
+    return name;
+}
+/** Recursively copy a directory, skipping node_modules and .git. */
+const SKIP_DIRS = new Set(['node_modules', '.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 {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+// ── Main ────────────────────────────────────────────────────────────────
+/**
+ * Install a bundle into a guild.
+ *
+ * Reads the bundle manifest, installs all referenced artifacts individually,
+ * and optionally commits the result. The bundle itself is NOT retained as
+ * a guild dependency — each artifact is installed independently.
+ *
+ * Package artifacts (implements, engines, and packaged content) are installed
+ * via npm. Inline content artifacts (curricula/temperaments with `path`) are
+ * copied directly from the bundle directory.
+ *
+ * If an installed package contains its own `nexus-bundle.json`, the installer
+ * recurses to install the transitive bundle's artifacts.
+ */
+export function installBundle(opts) {
+    const { home, bundleDir, commit = true } = opts;
+    // Auto-detect bundle provenance from package.json if not provided
+    let bundleSource = opts.bundleSource;
+    if (!bundleSource) {
+        const bundlePkgPath = path.join(bundleDir, 'package.json');
+        if (fs.existsSync(bundlePkgPath)) {
+            const bundlePkg = readJson(bundlePkgPath);
+            const name = bundlePkg['name'];
+            const version = bundlePkg['version'];
+            if (name && version) {
+                bundleSource = `${name}@${version}`;
+            }
+        }
+    }
+    const manifest = readBundleManifest(bundleDir);
+    const result = {
+        installed: 0,
+        artifacts: { implements: [], engines: [], curricula: [], temperaments: [], migrations: [] },
+    };
+    // ── Collect all package specifiers for batch npm install ──────────────
+    const packageSpecs = [];
+    for (const entry of manifest.implements ?? []) {
+        packageSpecs.push(entry.package);
+    }
+    for (const entry of manifest.engines ?? []) {
+        packageSpecs.push(entry.package);
+    }
+    for (const entry of manifest.curricula ?? []) {
+        if (entry.package)
+            packageSpecs.push(entry.package);
+    }
+    for (const entry of manifest.temperaments ?? []) {
+        if (entry.package)
+            packageSpecs.push(entry.package);
+    }
+    // Batch npm install all package dependencies at once
+    if (packageSpecs.length > 0) {
+        npm(['install', '--save', ...packageSpecs], home);
+    }
+    // ── Install package-based artifacts ───────────────────────────────────
+    // Helper to install a single package artifact via installTool
+    const installPackageArtifact = (entry, category) => {
+        const spec = entry.package;
+        // Resolve package name from the specifier
+        const packageName = resolvePackageName(spec, home);
+        const packageDir = path.join(home, 'node_modules', packageName);
+        // Check for transitive bundle
+        const nestedBundlePath = path.join(packageDir, BUNDLE_MANIFEST);
+        if (fs.existsSync(nestedBundlePath)) {
+            const nestedResult = installBundle({
+                home,
+                bundleDir: packageDir,
+                bundleSource: spec,
+                commit: false,
+            });
+            // Merge nested results
+            result.installed += nestedResult.installed;
+            for (const cat of ['implements', 'engines', 'curricula', 'temperaments']) {
+                result.artifacts[cat].push(...nestedResult.artifacts[cat]);
+            }
+            return packageName;
+        }
+        // Find descriptor to determine artifact type
+        const descriptorFile = DESCRIPTOR_MAP[category];
+        const descriptorPath = path.join(packageDir, descriptorFile);
+        if (!fs.existsSync(descriptorPath)) {
+            throw new Error(`Package "${packageName}" does not contain ${descriptorFile}. ` +
+                `Expected a ${category.slice(0, -1)} descriptor.`);
+        }
+        const descriptor = readJson(descriptorPath);
+        // Determine artifact name and slot
+        const name = entry.name || packageName.replace(/^@[^/]+\//, '');
+        const slot = descriptor['version'];
+        if (!slot) {
+            throw new Error(`No version in ${descriptorPath}`);
+        }
+        // Copy metadata to guild slot
+        const parentDir = DIR_MAP[category];
+        const targetDir = path.join(home, parentDir, name, slot);
+        if (fs.existsSync(targetDir)) {
+            fs.rmSync(targetDir, { recursive: true });
+        }
+        fs.mkdirSync(targetDir, { recursive: true });
+        // Copy descriptor
+        fs.copyFileSync(descriptorPath, path.join(targetDir, descriptorFile));
+        // Copy instructions if referenced
+        const instructionsFile = descriptor['instructions'];
+        if (instructionsFile) {
+            const instrPath = path.join(packageDir, instructionsFile);
+            if (fs.existsSync(instrPath)) {
+                fs.copyFileSync(instrPath, path.join(targetDir, instructionsFile));
+            }
+        }
+        // Copy content file if referenced (for curricula/temperaments)
+        const contentFile = descriptor['content'];
+        if (contentFile) {
+            const contentPath = path.join(packageDir, contentFile);
+            if (fs.existsSync(contentPath)) {
+                fs.copyFileSync(contentPath, path.join(targetDir, contentFile));
+            }
+        }
+        // Register in guild.json
+        const config = readGuildConfig(home);
+        const now = new Date().toISOString();
+        if (category === 'implements' || category === 'engines') {
+            config[category][name] = {
+                slot,
+                upstream: `${packageName}@${descriptor['version']}`,
+                installedAt: now,
+                ...(category === 'implements' && entry.roles
+                    ? { roles: entry.roles }
+                    : {}),
+                package: packageName,
+                ...(bundleSource ? { bundle: bundleSource } : {}),
+            };
+        }
+        else {
+            config[category][name] = {
+                slot,
+                upstream: `${packageName}@${descriptor['version']}`,
+                installedAt: now,
+                ...(bundleSource ? { bundle: bundleSource } : {}),
+            };
+        }
+        writeGuildConfig(home, config);
+        return name;
+    };
+    // Install implements
+    for (const entry of manifest.implements ?? []) {
+        const name = installPackageArtifact(entry, 'implements');
+        result.artifacts.implements.push(name);
+        result.installed++;
+    }
+    // Install engines
+    for (const entry of manifest.engines ?? []) {
+        const name = installPackageArtifact(entry, 'engines');
+        result.artifacts.engines.push(name);
+        result.installed++;
+    }
+    // Install curricula (package or inline)
+    for (const entry of manifest.curricula ?? []) {
+        if (entry.package) {
+            const name = installPackageArtifact(entry, 'curricula');
+            result.artifacts.curricula.push(name);
+        }
+        else {
+            const name = installInlineContent(home, bundleDir, 'curricula', entry, bundleSource);
+            result.artifacts.curricula.push(name);
+        }
+        result.installed++;
+    }
+    // Install temperaments (package or inline)
+    for (const entry of manifest.temperaments ?? []) {
+        if (entry.package) {
+            const name = installPackageArtifact(entry, 'temperaments');
+            result.artifacts.temperaments.push(name);
+        }
+        else {
+            const name = installInlineContent(home, bundleDir, 'temperaments', entry, bundleSource);
+            result.artifacts.temperaments.push(name);
+        }
+        result.installed++;
+    }
+    // Install migrations (inline only, renumbered into guild sequence)
+    if (manifest.migrations && manifest.migrations.length > 0) {
+        const migrationsDir = path.join(home, 'nexus', 'migrations');
+        fs.mkdirSync(migrationsDir, { recursive: true });
+        // Find current highest sequence in guild
+        const existing = fs.readdirSync(migrationsDir);
+        const MIGRATION_PATTERN = /^(\d{3})-(.+)\.sql$/;
+        let maxSeq = 0;
+        for (const file of existing) {
+            const match = file.match(MIGRATION_PATTERN);
+            if (match) {
+                maxSeq = Math.max(maxSeq, parseInt(match[1], 10));
+            }
+        }
+        const provenance = {};
+        for (const entry of manifest.migrations) {
+            const srcPath = path.resolve(bundleDir, entry.path);
+            if (!fs.existsSync(srcPath)) {
+                throw new Error(`Migration file not found: ${srcPath}`);
+            }
+            const originalName = path.basename(srcPath);
+            maxSeq++;
+            const seq = String(maxSeq).padStart(3, '0');
+            // Derive description from original filename (strip sequence prefix if present)
+            const descMatch = originalName.match(/^\d{3}-(.+)$/);
+            const description = descMatch ? descMatch[1] : originalName;
+            const guildFilename = `${seq}-${description}`;
+            fs.copyFileSync(srcPath, path.join(migrationsDir, guildFilename));
+            if (bundleSource) {
+                provenance[guildFilename] = { bundle: bundleSource, originalName };
+            }
+            result.artifacts.migrations.push(guildFilename);
+            result.installed++;
+        }
+        if (Object.keys(provenance).length > 0) {
+            result.migrationProvenance = provenance;
+        }
+    }
+    // Commit all changes in one batch
+    if (commit) {
+        git(['add', '-A'], home);
+        const bundleLabel = bundleSource || path.basename(bundleDir);
+        git(['commit', '-m', `Install bundle ${bundleLabel}`], home);
+    }
+    return result;
+}
+// ── Package name resolution ─────────────────────────────────────────────
+/**
+ * Resolve a package specifier to a package name.
+ *
+ * - Local paths: reads name from the source's package.json
+ * - Git URLs: finds the package in guild's package.json deps
+ * - Registry specifiers: parses name from "name@version" or "@scope/name@version"
+ */
+function resolvePackageName(spec, guildRoot) {
+    // Local path: read package.json directly
+    const isLocalPath = spec.startsWith('/') || spec.startsWith('./') || spec.startsWith('../');
+    if (isLocalPath) {
+        const pkgJsonPath = path.join(path.resolve(spec), 'package.json');
+        if (!fs.existsSync(pkgJsonPath)) {
+            throw new Error(`No package.json found at ${pkgJsonPath}`);
+        }
+        const pkg = readJson(pkgJsonPath);
+        const name = pkg['name'];
+        if (!name) {
+            throw new Error(`No "name" field in ${pkgJsonPath}`);
+        }
+        return name;
+    }
+    // Git URL: find the package in node_modules by reading package.json deps
+    if (spec.startsWith('git+')) {
+        const guildPkg = readJson(path.join(guildRoot, 'package.json'));
+        const deps = guildPkg['dependencies'] ?? {};
+        for (const [name, value] of Object.entries(deps)) {
+            if (value === spec || value.includes(spec.replace(/^git\+/, ''))) {
+                return name;
+            }
+        }
+        throw new Error(`Could not resolve package name for git URL: ${spec}`);
+    }
+    // Registry specifier: parse name from "name@version" or "@scope/name@version"
+    if (spec.startsWith('@') && spec.lastIndexOf('@') > 0) {
+        return spec.substring(0, spec.lastIndexOf('@'));
+    }
+    if (spec.includes('@')) {
+        return spec.split('@')[0];
+    }
+    return spec;
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

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

package/dist/dispatch.d.ts

@@ -1,5 +1,5 @@
 export interface DispatchOptions {
-    /** Absolute path to NEXUS_HOME. */
+    /** Absolute path to the guild root. */
     home: string;
     /** Commission specification — what needs to be done. */
     spec: string;

package/dist/dispatch.d.ts.map

@@ -1 +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"}
+{"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/guild-config.d.ts

@@ -1,7 +1,5 @@
 /** 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. */
@@ -10,6 +8,10 @@ export interface ToolEntry {
     installedAt: string;
     /** Which roles have access (implements only). ["*"] means all roles. */
     roles?: string[];
+    /** npm package name for runtime resolution via node_modules. Omitted for script-only tools. */
+    package?: string;
+    /** Bundle that delivered this artifact, e.g. "@shardworks/guild-starter-kit@0.1.0". */
+    bundle?: string;
 }
 /** A reference to a curriculum or temperament registered in guild.json. */
 export interface TrainingEntry {
@@ -19,6 +21,8 @@ export interface TrainingEntry {
     upstream: string | null;
     /** ISO-8601 timestamp of when the content was installed into this slot. */
     installedAt: string;
+    /** Bundle that delivered this artifact, e.g. "@shardworks/guild-starter-kit@0.1.0". */
+    bundle?: string;
 }
 /** The guild's central configuration file shape (`guild.json`). */
 export interface GuildConfig {
@@ -44,10 +48,10 @@ export interface GuildConfig {
  * All registries (implements, engines, curricula, temperaments) start empty.
  */
 export declare function createInitialGuildConfig(name: string, nexusVersion: string, model: string): GuildConfig;
-/** Resolve the path to guild.json in the standing worktree. */
+/** Resolve the path to guild.json in the guild root. */
 export declare function guildConfigPath(home: string): string;
-/** Read and parse guild.json from the standing worktree. */
+/** Read and parse guild.json from the guild root. */
 export declare function readGuildConfig(home: string): GuildConfig;
-/** Write guild.json to the standing worktree. */
+/** Write guild.json to the guild root. */
 export declare function writeGuildConfig(home: string, config: GuildConfig): void;
 //# sourceMappingURL=guild-config.d.ts.map

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

@@ -1 +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,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,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,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAWvG;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"}
+{"version":3,"file":"guild-config.d.ts","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"AAGA,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,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;IACjB,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;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;IACpB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,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,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAWvG;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAGzD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAGxE"}