@shardworks/nexus 0.1.99 → 0.1.101

package/dist/commands/status.d.ts

@@ -0,0 +1,16 @@
+/**
+ * nsg status — guild status.
+ *
+ * A framework command. Shows guild identity, framework version, and installed plugins
+ * separated into apparatuses (running infrastructure) and kits (passive capabilities).
+ * Domain-specific status (writ counts, session history, clock state) belongs
+ * to plugins, not here.
+ *
+ * Requires a booted guild — prints a friendly error if run outside one.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    json: z.ZodOptional<z.ZodBoolean>;
+}>;
+export default _default;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAExB,wBA0CG"}

package/dist/commands/status.js

@@ -0,0 +1,54 @@
+/**
+ * nsg status — guild status.
+ *
+ * A framework command. Shows guild identity, framework version, and installed plugins
+ * separated into apparatuses (running infrastructure) and kits (passive capabilities).
+ * Domain-specific status (writ counts, session history, clock state) belongs
+ * to plugins, not here.
+ *
+ * Requires a booted guild — prints a friendly error if run outside one.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { VERSION, readGuildConfig, guild } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'status',
+    description: 'Show guild identity and installed plugin summary',
+    callableBy: ['cli'],
+    params: {
+        json: z.boolean().optional().describe('Output as JSON'),
+    },
+    handler: async (params) => {
+        let g;
+        try {
+            g = guild();
+        }
+        catch {
+            throw new Error('Not inside a guild. Run `nsg init` to create one, or use --guild-root to specify the path.');
+        }
+        const { home } = g;
+        const config = readGuildConfig(home);
+        // Note: at status time we don't load/start plugins — we just report what's
+        // declared in guild.json. Type discrimination (kit vs apparatus) requires
+        // loading the modules, which is deferred to avoid startup cost for status.
+        const result = {
+            guild: config.name,
+            nexus: VERSION,
+            home,
+            model: config.settings?.model ?? '(not set)',
+            plugins: [...config.plugins].sort(),
+        };
+        if (params.json) {
+            return result;
+        }
+        const lines = [
+            `Guild:    ${result.guild}`,
+            `Nexus:    ${result.nexus}`,
+            `Home:     ${result.home}`,
+            `Model:    ${result.model}`,
+            `Plugins:  ${result.plugins.length > 0 ? result.plugins.join(', ') : '(none)'}`,
+        ];
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,kDAAkD;IAC/D,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KACxD;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC;QACN,IAAI,CAAC;YACH,CAAC,GAAG,KAAK,EAAE,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;QAChH,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QACnB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAErC,2EAA2E;QAC3E,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,MAAM,GAAG;YACb,KAAK,EAAI,MAAM,CAAC,IAAI;YACpB,KAAK,EAAI,OAAO;YAChB,IAAI;YACJ,KAAK,EAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,WAAW;YAC9C,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;SACpC,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,aAAa,MAAM,CAAC,KAAK,EAAE;YAC3B,aAAa,MAAM,CAAC,KAAK,EAAE;YAC3B,aAAa,MAAM,CAAC,IAAI,EAAE;YAC1B,aAAa,MAAM,CAAC,KAAK,EAAE;YAC3B,aAAa,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAChF,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/test-helpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared test helpers for CLI command tests.
+ *
+ * Provides guild accessor setup, temp directory management, and minimal
+ * guild.json scaffolding. Extracted from status.test.ts, version.test.ts,
+ * and plugin.test.ts where these were copy-pasted identically.
+ */
+/** Set up a minimal guild accessor pointing at the given directory. */
+export declare function setupGuildAccessor(home: string): void;
+/** Create a temp directory and register it for cleanup. */
+export declare function makeTmpDir(prefix: string): string;
+/** Write a minimal guild.json to dir, with optional overrides. */
+export declare function makeGuild(dir: string, overrides?: Record<string, unknown>): void;
+/** Write a guild-root package.json declaring the given npm dependencies. */
+export declare function makeGuildPackageJson(dir: string, deps: Record<string, string>): void;
+/** Clean up guild state and temp directories. Call from afterEach(). */
+export declare function cleanupTestState(): void;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/commands/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUrD;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI,CASpF;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAGpF;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}

package/dist/commands/test-helpers.js

@@ -0,0 +1,56 @@
+/**
+ * Shared test helpers for CLI command tests.
+ *
+ * Provides guild accessor setup, temp directory management, and minimal
+ * guild.json scaffolding. Extracted from status.test.ts, version.test.ts,
+ * and plugin.test.ts where these were copy-pasted identically.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { setGuild, clearGuild } from '@shardworks/nexus-core';
+/** Accumulates temp dirs for cleanup in afterEach. */
+let tmpDirs = [];
+/** Set up a minimal guild accessor pointing at the given directory. */
+export function setupGuildAccessor(home) {
+    setGuild({
+        home,
+        apparatus: () => { throw new Error('not available in test'); },
+        config: () => ({}),
+        writeConfig: () => { throw new Error('not available in test'); },
+        guildConfig: () => ({}),
+        kits: () => [],
+        apparatuses: () => [],
+    });
+}
+/** Create a temp directory and register it for cleanup. */
+export function makeTmpDir(prefix) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), `nsg-${prefix}-test-`));
+    tmpDirs.push(dir);
+    return dir;
+}
+/** Write a minimal guild.json to dir, with optional overrides. */
+export function makeGuild(dir, overrides = {}) {
+    const config = {
+        name: 'test-guild',
+        nexus: '0.0.0',
+        plugins: [],
+        settings: { model: 'sonnet' },
+        ...overrides,
+    };
+    fs.writeFileSync(path.join(dir, 'guild.json'), JSON.stringify(config, null, 2) + '\n');
+}
+/** Write a guild-root package.json declaring the given npm dependencies. */
+export function makeGuildPackageJson(dir, deps) {
+    const pkg = { name: 'test-guild', version: '1.0.0', dependencies: deps };
+    fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify(pkg, null, 2) + '\n');
+}
+/** Clean up guild state and temp directories. Call from afterEach(). */
+export function cleanupTestState() {
+    clearGuild();
+    for (const dir of tmpDirs) {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+    tmpDirs = [];
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/commands/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/commands/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE9D,sDAAsD;AACtD,IAAI,OAAO,GAAa,EAAE,CAAC;AAE3B,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,QAAQ,CAAC;QACP,IAAI;QACJ,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAU;QAC3B,WAAW,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;QAChE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAU;QAChC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE;QACd,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,MAAM,QAAQ,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,YAAqC,EAAE;IAC5E,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC7B,GAAG,SAAS;KACb,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACzF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,IAA4B;IAC5E,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IACzE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB;IAC9B,UAAU,EAAE,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,GAAG,EAAE,CAAC;AACf,CAAC"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,13 @@
+/**
+ * nsg upgrade — upgrade the guild framework.
+ *
+ * Stub — upgrade lifecycle not yet designed. Will handle framework version
+ * bumps, guild.json schema reconciliation, and plugin-specific upgrade
+ * hooks when implemented.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}>;
+export default _default;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/commands/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAExB,wBAUG"}

package/dist/commands/upgrade.js

@@ -0,0 +1,21 @@
+/**
+ * nsg upgrade — upgrade the guild framework.
+ *
+ * Stub — upgrade lifecycle not yet designed. Will handle framework version
+ * bumps, guild.json schema reconciliation, and plugin-specific upgrade
+ * hooks when implemented.
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { z } from 'zod';
+export default tool({
+    name: 'upgrade',
+    description: 'Upgrade the guild framework and run pending plugin migrations',
+    callableBy: ['cli'],
+    params: {
+        dryRun: z.boolean().optional().describe('Show what would be done without applying changes'),
+    },
+    handler: async () => {
+        return 'Not yet implemented.';
+    },
+});
+//# sourceMappingURL=upgrade.js.map

package/dist/commands/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,+DAA+D;IAC5E,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE;QACN,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;KAC5F;IACD,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,OAAO,sBAAsB,CAAC;IAChC,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/version.d.ts

@@ -0,0 +1,15 @@
+/**
+ * nsg version — show framework and plugin version info.
+ *
+ * A framework command — hardcoded in the CLI, not discovered via plugins.
+ *
+ * Always shows framework and Node versions. When run inside a guild,
+ * additionally shows installed plugin versions. Gracefully degrades
+ * when run outside a guild (no error, just less info).
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    json: z.ZodOptional<z.ZodBoolean>;
+}>;
+export default _default;
+//# sourceMappingURL=version.d.ts.map

package/dist/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;AAExB,wBAwCG"}

package/dist/commands/version.js

@@ -0,0 +1,52 @@
+/**
+ * nsg version — show framework and plugin version info.
+ *
+ * A framework command — hardcoded in the CLI, not discovered via plugins.
+ *
+ * Always shows framework and Node versions. When run inside a guild,
+ * additionally shows installed plugin versions. Gracefully degrades
+ * when run outside a guild (no error, just less info).
+ */
+import { tool } from '@shardworks/tools-apparatus';
+import { VERSION, readGuildConfig, guild, readGuildPackageJson, resolvePackageNameForPluginId } from '@shardworks/nexus-core';
+import { z } from 'zod';
+export default tool({
+    name: 'version',
+    description: 'Show Nexus framework and installed plugin version information',
+    callableBy: ['cli'],
+    params: {
+        json: z.boolean().optional().describe('Output as JSON'),
+    },
+    handler: async (params) => {
+        const result = {
+            nexus: VERSION,
+            node: process.version,
+        };
+        // Add plugin versions when running inside a guild.
+        // guild() throws if not initialized — that's fine, we just skip plugin info.
+        try {
+            const { home } = guild();
+            const config = readGuildConfig(home);
+            for (const pluginId of config.plugins) {
+                const packageName = resolvePackageNameForPluginId(home, pluginId);
+                if (!packageName) {
+                    result[pluginId] = 'not installed';
+                    continue;
+                }
+                const { pkgJson } = readGuildPackageJson(home, packageName);
+                result[packageName] = pkgJson
+                    ? (pkgJson.version ?? 'unknown')
+                    : 'not installed';
+            }
+        }
+        catch {
+            // Not in a guild or guild.json unreadable — just show framework version
+        }
+        if (params.json) {
+            return result;
+        }
+        const lines = Object.entries(result).map(([k, v]) => `${k}: ${v}`);
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAC9H,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,+DAA+D;IAC5E,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KACxD;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,MAAM,GAA2B;YACrC,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,OAAO,CAAC,OAAO;SACtB,CAAC;QAEF,mDAAmD;QACnD,6EAA6E;QAC7E,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACrC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACtC,MAAM,WAAW,GAAG,6BAA6B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAClE,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC;oBACnC,SAAS;gBACX,CAAC;gBACD,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAC5D,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO;oBAC3B,CAAC,CAAC,CAAE,OAAO,CAAC,OAAkB,IAAI,SAAS,CAAC;oBAC5C,CAAC,CAAC,eAAe,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/helpers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Pure helper functions for CLI command generation.
+ *
+ * Extracted from program.ts so they can be tested independently
+ * without pulling in heavy runtime dependencies (Arbor, Instrumentarium).
+ */
+import { z } from 'zod';
+import type { ToolDefinition } from '@shardworks/tools-apparatus';
+/**
+ * Convert camelCase key to kebab-case CLI flag.
+ * e.g. 'writId' → '--writ-id'
+ */
+export declare function toFlag(key: string): string;
+/**
+ * Detect whether a Zod schema accepts booleans (and only booleans).
+ * Used to register Commander flags without <value> for boolean params.
+ */
+export declare function isBooleanSchema(schema: z.ZodTypeAny): boolean;
+/**
+ * Determine which hyphen prefixes have enough tools to warrant a group.
+ *
+ * Returns a Set of prefixes that have 2+ tools sharing them.
+ * 'plugin-list' + 'plugin-install' → 'plugin' is a group.
+ * 'show-writ' alone → 'show' is NOT a group.
+ */
+export declare function findGroupPrefixes(tools: ToolDefinition[]): Set<string>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAetE"}

package/dist/helpers.js

@@ -0,0 +1,48 @@
+/**
+ * Pure helper functions for CLI command generation.
+ *
+ * Extracted from program.ts so they can be tested independently
+ * without pulling in heavy runtime dependencies (Arbor, Instrumentarium).
+ */
+import { z } from 'zod';
+/**
+ * Convert camelCase key to kebab-case CLI flag.
+ * e.g. 'writId' → '--writ-id'
+ */
+export function toFlag(key) {
+    return `--${key.replace(/([A-Z])/g, (c) => `-${c.toLowerCase()}`)}`;
+}
+/**
+ * Detect whether a Zod schema accepts booleans (and only booleans).
+ * Used to register Commander flags without <value> for boolean params.
+ */
+export function isBooleanSchema(schema) {
+    return (schema.safeParse(true).success &&
+        schema.safeParse(false).success &&
+        !schema.safeParse(42).success &&
+        !schema.safeParse('test').success);
+}
+/**
+ * Determine which hyphen prefixes have enough tools to warrant a group.
+ *
+ * Returns a Set of prefixes that have 2+ tools sharing them.
+ * 'plugin-list' + 'plugin-install' → 'plugin' is a group.
+ * 'show-writ' alone → 'show' is NOT a group.
+ */
+export function findGroupPrefixes(tools) {
+    const prefixCounts = new Map();
+    for (const t of tools) {
+        const idx = t.name.indexOf('-');
+        if (idx === -1)
+            continue;
+        const prefix = t.name.slice(0, idx);
+        prefixCounts.set(prefix, (prefixCounts.get(prefix) ?? 0) + 1);
+    }
+    const groups = new Set();
+    for (const [prefix, count] of prefixCounts) {
+        if (count >= 2)
+            groups.add(prefix);
+    }
+    return groups;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,OAAO,CACL,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO;QAC9B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAC/B,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO;QAC7B,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAClC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACpC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QAC3C,IAAI,KAAK,IAAI,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export { VERSION } from '@shardworks/nexus-core';
+export { main } from './program.ts';
+export { frameworkCommands } from './commands/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,2 +1,4 @@
 export { VERSION } from '@shardworks/nexus-core';
+export { main } from "./program.js";
+export { frameworkCommands } from "./commands/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/program.d.ts

@@ -1,35 +1,20 @@
 /**
- * nsg program — dynamic Commander setup via mainspring tool resolution.
+ * nsg program — dynamic Commander setup.
  *
- * Discovers installed tools at startup via the Mainspring, then registers each
- * as a Commander command with auto-generated options from its Zod param schema.
+ * Two command sources:
+ *
+ * 1. **Framework commands** — hardcoded in the CLI package (init, status,
+ *    version, upgrade, plugin management). Always available, even without
+ *    a guild.
+ *
+ * 2. **Plugin tools** — discovered at runtime via The Instrumentarium
+ *    (tools apparatus). Only available when a guild is present and the
+ *    tools apparatus is installed.
  *
  * Tool names are auto-grouped when multiple tools share a hyphen prefix:
- * 'rig-list' + 'rig-install' → 'nsg rig list' / 'nsg rig install'.
+ * 'plugin-list' + 'plugin-install' → 'nsg plugin list' / 'nsg plugin install'.
  * A tool like 'show-writ' stays flat ('nsg show-writ') since no other tool
  * starts with 'show-'.
- *
- * Commander lives here; rig handles all manifest and import logic.
- */
-import { z } from 'zod';
-import type { Tool } from '@shardworks/nexus-mainspring';
-/**
- * Convert camelCase key to kebab-case CLI flag.
- * e.g. 'writId' → '--writ-id'
- */
-export declare function toFlag(key: string): string;
-/**
- * Detect whether a Zod schema accepts booleans (and only booleans).
- * Used to register Commander flags without <value> for boolean params.
- */
-export declare function isBooleanSchema(schema: z.ZodTypeAny): boolean;
-/**
- * Determine which hyphen prefixes have enough tools to warrant a group.
- *
- * Returns a Set of prefixes that have 2+ tools sharing them.
- * 'rig-list' + 'rig-install' → 'rig' is a group.
- * 'show-writ' alone → 'show' is NOT a group.
  */
-export declare function findGroupPrefixes(tools: Tool[]): Set<string>;
 export declare function main(): Promise<void>;
 //# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,8BAA8B,CAAC;AAOrE;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAO7D;AAqED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAe5D;AA+CD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuD1C"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAwGH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAwD1C"}