@shardworks/nexus 0.1.99 → 0.1.101

package/README.md

@@ -0,0 +1,208 @@
+# `@shardworks/nexus`
+
+The `nsg` command-line interface for Nexus guilds. The CLI is the patron's and operator's primary entry point — it provides framework commands for guild lifecycle and plugin management, and dynamically discovers plugin-contributed tools via The Instrumentarium.
+
+The CLI has two layers of commands:
+
+1. **Framework commands** — hardcoded in the CLI package. Always available, even without a guild. Guild lifecycle (`init`, `status`, `version`, `upgrade`) and plugin management (`plugin list/install/remove/upgrade`).
+2. **Plugin tools** — discovered at runtime from The Instrumentarium (`tools` apparatus). Only available when inside a guild that has the tools apparatus installed. Each tool is contributed by a kit or apparatus; the CLI auto-generates Commander commands from the tool's Zod param schema.
+
+---
+
+## Binary Names
+
+| Binary | Description |
+|---|---|
+| `nsg` | The v2 CLI — framework commands + dynamic tool discovery via The Instrumentarium |
+
+During development from the monorepo root:
+
+```sh
+pnpm nsg <command>
+```
+
+---
+
+## How It Works
+
+### Command Discovery
+
+At startup:
+
+1. Pre-parse `--guild-root` to locate the guild (or auto-detect by walking up from cwd)
+2. Register framework commands (always available — see [Framework Commands](#framework-commands))
+3. If inside a guild: call `createGuild()` to start the runtime, then query The Instrumentarium for all tools with `callableBy: 'cli'`
+4. Auto-generate Commander commands from each tool's Zod param schema
+
+If the guild doesn't have the tools apparatus installed, only framework commands are available.
+
+### Auto-Grouping
+
+Tool names are automatically grouped by hyphen prefix when two or more tools share a prefix:
+
+```
+plugin-list + plugin-install  →  nsg plugin list / nsg plugin install
+session-list + session-show   →  nsg session list / nsg session show
+signal (no group)             →  nsg signal
+```
+
+A tool like `show-writ` stays flat (`nsg show-writ`) if no other tool starts with `show-`.
+
+### Flag Generation
+
+Zod param schemas are converted to Commander flags:
+
+| Zod schema | Commander flag |
+|---|---|
+| `z.string()` (required) | `--param <value>` (required) |
+| `z.string().optional()` | `--param <value>` (optional) |
+| `z.boolean()` | `--param` (flag, no value) |
+| camelCase key | `--kebab-case` flag |
+
+### Guild Root Resolution
+
+The CLI finds the guild root the same way git finds `.git/` — walking up from cwd until it finds `guild.json`. Override with `--guild-root <path>`.
+
+Plugin-contributed tools require a guild. Framework commands work without one.
+
+---
+
+## Framework Commands
+
+Framework commands are defined in the CLI package itself (`src/commands/`). They handle guild lifecycle and plugin management — operations that need to work before any plugins are loaded, or without a guild at all.
+
+### Guild Lifecycle
+
+| Command | Description |
+|---|---|
+| `nsg init <path>` | Create a new guild: directory structure, `guild.json`, `package.json`, `.gitignore` |
+| `nsg status` | Show guild identity and installed plugins |
+| `nsg version` | Show Nexus framework version and installed plugin versions |
+| `nsg upgrade` | Upgrade framework and run pending plugin migrations *(stub)* |
+
+### Plugin Management
+
+| Command | Description |
+|---|---|
+| `nsg plugin list` | List installed plugins |
+| `nsg plugin install <source>` | Install a plugin from npm, a git URL, or a local directory |
+| `nsg plugin remove <name>` | Remove a plugin |
+| `nsg plugin upgrade <name>` | Upgrade a plugin to a newer version *(stub)* |
+
+#### `nsg init`
+
+Writes the minimum viable guild. Does not run `git init`, create the database, or instantiate animas — those are separate steps.
+
+```sh
+nsg init ./my-guild --name my-guild
+cd my-guild
+nsg plugin install @shardworks/nexus-stdlib
+```
+
+#### `nsg plugin install`
+
+Accepts npm package specifiers, version pins, and git URLs:
+
+```sh
+nsg plugin install @shardworks/nexus-stdlib
+nsg plugin install nexus-stdlib@1.2.0
+nsg plugin install git+https://github.com/acme/my-plugin.git
+
+# Symlink a local directory (dev workflow)
+nsg plugin install ./path/to/my-plugin --type link
+```
+
+Plugin install is a pure npm + guild.json operation — it adds the package as a dependency and registers the plugin id. Tool access is controlled by the permission model: tools declare permission levels, and roles grant `plugin:level` permissions via the Loom's configuration. See [The Instrumentarium](../../docs/architecture/apparatus/instrumentarium.md) for the permission model.
+
+---
+
+## Standard Guild Commands
+
+> **Note:** The standard kits are still being developed. This inventory reflects the target command set for a default `nsg init` guild. Some commands listed here are only available via `nsg1` (v1 legacy) until migration is complete. Update this section once the standard kit set is finalized.
+
+### Commissions and Writs
+
+| Command | Source | Description |
+|---|---|---|
+| `nsg writ post` | nexus-stdlib | Post a new commission (creates a mandate writ) |
+| `nsg writ list` | nexus-stdlib | List writs with optional filters |
+| `nsg writ show` | nexus-stdlib | Show full detail for a writ |
+| `nsg writ update` | nexus-stdlib | Update writ fields (status, spec, etc.) |
+
+### Animas
+
+| Command | Source | Description |
+|---|---|---|
+| `nsg anima create` | nexus-stdlib | Create a new anima |
+| `nsg anima list` | nexus-stdlib | List animas |
+| `nsg anima show` | nexus-stdlib | Show anima detail (roles, curriculum, temperament) |
+| `nsg anima update` | nexus-stdlib | Update anima configuration |
+| `nsg anima remove` | nexus-stdlib | Retire an anima |
+| `nsg anima manifest` | nexus-stdlib | Preview the manifest that would be assembled for an anima |
+
+### Sessions and Conversations
+
+| Command | Source | Description |
+|---|---|---|
+| `nsg consult` | cli (v1) | Start an interactive conversation with an anima |
+| `nsg convene` | cli (v1) | Start a multi-anima conversation |
+| `nsg session list` | animator (supportKit) | List recent sessions |
+| `nsg session show` | animator (supportKit) | Show session detail (tokens, cost, duration) |
+| `nsg conversation list` | parlour (supportKit) | List conversations |
+| `nsg conversation show` | parlour (supportKit) | Show conversation detail with turn history |
+| `nsg conversation end` | parlour (supportKit) | End an active conversation |
+
+### Clockworks
+
+| Command | Source | Description |
+|---|---|---|
+| `nsg signal` | nexus-stdlib | Signal a custom event |
+| `nsg clock start` | cli (v1) | Start the Clockworks daemon |
+| `nsg clock stop` | cli (v1) | Stop the Clockworks daemon |
+| `nsg clock status` | cli (v1) | Show daemon status |
+| `nsg clock tick` | cli (v1) | Process one pending event (manual mode) |
+| `nsg clock run` | cli (v1) | Process all pending events (manual mode) |
+| `nsg clock list` | cli (v1) | List standing orders |
+| `nsg event list` | nexus-stdlib | List recent events |
+| `nsg event show` | nexus-stdlib | Show event detail |
+
+### Codexes
+
+| Command | Source | Description |
+|---|---|---|
+| `nsg codex add` | codexes-apparatus | Register an existing repo as a codex |
+| `nsg codex list` | codexes-apparatus | List registered codexes |
+| `nsg codex show` | codexes-apparatus | Show codex detail |
+| `nsg codex remove` | codexes-apparatus | Unregister a codex |
+| `nsg codex push` | codexes-apparatus | Push a branch to the codex remote |
+| `nsg draft open` | codexes-apparatus | Open a draft binding (worktree) |
+| `nsg draft list` | codexes-apparatus | List active draft bindings |
+| `nsg draft abandon` | codexes-apparatus | Abandon a draft binding |
+| `nsg draft seal` | codexes-apparatus | Seal a draft into the codex |
+
+### Operations
+
+| Command | Source | Description |
+|---|---|---|
+| `nsg dispatch list` | nexus-stdlib | List recent dispatches |
+| `nsg audit list` | nexus-stdlib | List audit entries |
+| `nsg dashboard` | cli (v1) | Open the guild dashboard |
+
+---
+
+## Migration Status (v1 → v2)
+
+The v2 CLI dynamically discovers plugin-contributed tools via The Instrumentarium. Commands that are still hardcoded in v1 need to be migrated to the plugin architecture (either as tools in a kit/apparatus supportKit, or as framework commands).
+
+**Migrated to v2:**
+- Framework commands: `init`, `status`, `version`, `upgrade`, `plugin list/install/remove/upgrade`
+- All tool-based commands discovered via The Instrumentarium
+
+**Remaining in v1 only:**
+- `consult`, `convene` — interactive session launchers (need Animator/Parlour integration)
+- `clock *` — Clockworks daemon management
+- `codex *` / `draft *` — codex and draft lifecycle (migrated to codexes-apparatus)
+- `dashboard` — guild dashboard
+- `guild restore`, `guild upgrade-books` — guild maintenance
+
+These will migrate as the corresponding apparatus are implemented and expose the necessary tools via their supportKits.

package/dist/cli.d.ts

@@ -1,16 +1,12 @@
 #!/usr/bin/env node
 /**
- * nsg — new entry point, built on the rig architecture.
+ * nsg — CLI entry point, built on the plugin architecture.
  *
- * Dynamically discovers installed tools via rig, registers them as Commander
+ * Dynamically discovers installed tools via plugins, registers them as Commander
  * commands, and delegates argument parsing and invocation to Commander.
  *
- * Tools are filtered to those with 'cli' in callableFrom (or no callableFrom
- * set, which defaults to all callers). Tools marked 'mcp'-only are invisible here.
- *
- * nsg1 is the legacy entry point (src/v1/cli.ts) — fully preserved and functional.
- * The guild continues to use nsg1 for anything not yet migrated. Over time, nsg1
- * is retired as commands migrate to nsg.
+ * Tools are filtered to those with 'cli' in callableBy (or no callableBy
+ * set, which defaults to all callers). Tools marked 'anima'-only are invisible here.
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/dist/cli.js

@@ -1,16 +1,12 @@
 #!/usr/bin/env node
 /**
- * nsg — new entry point, built on the rig architecture.
+ * nsg — CLI entry point, built on the plugin architecture.
  *
- * Dynamically discovers installed tools via rig, registers them as Commander
+ * Dynamically discovers installed tools via plugins, registers them as Commander
  * commands, and delegates argument parsing and invocation to Commander.
  *
- * Tools are filtered to those with 'cli' in callableFrom (or no callableFrom
- * set, which defaults to all callers). Tools marked 'mcp'-only are invisible here.
- *
- * nsg1 is the legacy entry point (src/v1/cli.ts) — fully preserved and functional.
- * The guild continues to use nsg1 for anything not yet migrated. Over time, nsg1
- * is retired as commands migrate to nsg.
+ * Tools are filtered to those with 'cli' in callableBy (or no callableBy
+ * set, which defaults to all callers). Tools marked 'anima'-only are invisible here.
  */
 import { main } from "./program.js";
 main().catch((err) => {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Framework commands — hardcoded CLI commands that work with or without a guild.
+ *
+ * These are guild lifecycle and plugin management commands that the CLI
+ * registers directly, bypassing plugin discovery. They are the CLI's own
+ * commands, not tools contributed by kits or apparatus.
+ *
+ * Plugin-contributed tools are discovered at runtime via The Instrumentarium
+ * when a guild is present and the tools apparatus is installed.
+ */
+import type { ToolDefinition } from '@shardworks/tools-apparatus';
+/** All framework commands, typed as the base ToolDefinition for uniform handling. */
+export declare const frameworkCommands: ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAOlE,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EASzB,cAAc,EAAE,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,27 @@
+/**
+ * Framework commands — hardcoded CLI commands that work with or without a guild.
+ *
+ * These are guild lifecycle and plugin management commands that the CLI
+ * registers directly, bypassing plugin discovery. They are the CLI's own
+ * commands, not tools contributed by kits or apparatus.
+ *
+ * Plugin-contributed tools are discovered at runtime via The Instrumentarium
+ * when a guild is present and the tools apparatus is installed.
+ */
+import init from "./init.js";
+import version from "./version.js";
+import status from "./status.js";
+import upgrade from "./upgrade.js";
+import { pluginList, pluginInstall, pluginRemove, pluginUpgrade } from "./plugin.js";
+/** All framework commands, typed as the base ToolDefinition for uniform handling. */
+export const frameworkCommands = [
+    init,
+    version,
+    status,
+    upgrade,
+    pluginList,
+    pluginInstall,
+    pluginRemove,
+    pluginUpgrade,
+];
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI;IACJ,OAAO;IACP,MAAM;IACN,OAAO;IACP,UAAU;IACV,aAAa;IACb,YAAY;IACZ,aAAa;CACM,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,19 @@
+/**
+ * nsg init — create a new guild.
+ *
+ * A framework command — hardcoded in the CLI, not discovered via plugins.
+ *
+ * Writes the minimum viable guild: directory structure, guild.json,
+ * package.json, .gitignore. Does NOT git init, install bundles, create
+ * the database, or instantiate animas — those are separate steps.
+ *
+ * After init, the user runs `nsg plugin install` to add capabilities.
+ */
+import { z } from 'zod';
+declare const _default: import("@shardworks/tools-apparatus").ToolDefinition<{
+    path: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}>;
+export default _default;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;;;;;;AAIxB,wBAuFG"}

package/dist/commands/init.js

@@ -0,0 +1,90 @@
+/**
+ * nsg init — create a new guild.
+ *
+ * A framework command — hardcoded in the CLI, not discovered via plugins.
+ *
+ * Writes the minimum viable guild: directory structure, guild.json,
+ * package.json, .gitignore. Does NOT git init, install bundles, create
+ * the database, or instantiate animas — those are separate steps.
+ *
+ * After init, the user runs `nsg plugin install` to add capabilities.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { tool } from '@shardworks/tools-apparatus';
+import { VERSION, createInitialGuildConfig, writeGuildConfig } from '@shardworks/nexus-core';
+import { z } from 'zod';
+const DEFAULT_MODEL = 'sonnet';
+export default tool({
+    name: 'init',
+    description: 'Create a new guild — directory structure, guild.json, and package.json',
+    callableBy: ['cli'],
+    params: {
+        path: z.string().describe('Directory path for the new guild'),
+        name: z.string().optional().describe('Guild name (defaults to directory basename)'),
+        model: z.string().optional().describe('Default model for anima sessions (default: sonnet)'),
+    },
+    handler: async (params) => {
+        const home = path.resolve(params.path);
+        const name = params.name ?? path.basename(home);
+        const model = params.model ?? DEFAULT_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 guild root
+        fs.mkdirSync(home, { recursive: true });
+        // .nexus infrastructure (gitignored)
+        fs.mkdirSync(path.join(home, '.nexus'), { recursive: true });
+        // Scaffold guild directories
+        const dirs = [
+            'roles',
+            'codex',
+        ];
+        for (const dir of dirs) {
+            const full = path.join(home, dir);
+            fs.mkdirSync(full, { recursive: true });
+            fs.writeFileSync(path.join(full, '.gitkeep'), '');
+        }
+        // guild.json — V2 format: plugin-centric, model in settings
+        const guildConfig = createInitialGuildConfig(name, VERSION, model);
+        writeGuildConfig(home, guildConfig);
+        // package.json — makes the guild an npm project so plugins install as deps.
+        // If running from a published version, pin @shardworks/nexus so nsg is
+        // available in the guild's node_modules/.bin without a global install.
+        const dependencies = {};
+        if (VERSION !== '0.0.0') {
+            dependencies['@shardworks/nexus'] = `^${VERSION}`;
+        }
+        const packageJson = {
+            name: `guild-${name}`,
+            private: true,
+            version: '0.0.0',
+            type: 'module',
+            dependencies,
+        };
+        fs.writeFileSync(path.join(home, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n');
+        // .gitignore
+        fs.writeFileSync(path.join(home, '.gitignore'), ['node_modules/', '.nexus/', ''].join('\n'));
+        // codex placeholder
+        fs.writeFileSync(path.join(home, 'codex', 'all.md'), '');
+        // npm install to get dependencies into node_modules
+        if (Object.keys(dependencies).length > 0) {
+            execFileSync('npm', ['install'], { cwd: home, stdio: 'pipe' });
+        }
+        const lines = [
+            `Guild "${name}" created at ${home}`,
+            '',
+            `  cd ${params.path}`,
+            '  git init                                        # if you want version control',
+            '  nsg plugin install @shardworks/nexus-stdlib     # install standard tools',
+            '',
+        ];
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,QAAQ,CAAC;AAE/B,eAAe,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,wEAAwE;IACrF,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACnF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;KAC5F;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,aAAa,CAAC;QAE5C,kBAAkB;QAClB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAExC,qCAAqC;QACrC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7D,6BAA6B;QAC7B,MAAM,IAAI,GAAG;YACX,OAAO;YACP,OAAO;SACR,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,4DAA4D;QAC5D,MAAM,WAAW,GAAG,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACnE,gBAAgB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAEpC,4EAA4E;QAC5E,uEAAuE;QACvE,uEAAuE;QACvE,MAAM,YAAY,GAA2B,EAAE,CAAC;QAChD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,YAAY,CAAC,mBAAmB,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,WAAW,GAAG;YAClB,IAAI,EAAE,SAAS,IAAI,EAAE;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,QAAQ;YACd,YAAY;SACb,CAAC;QACF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAC/B,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC5C,CAAC;QAEF,aAAa;QACb,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAC7B,CAAC,eAAe,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC5C,CAAC;QAEF,oBAAoB;QACpB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAEzD,oDAAoD;QACpD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,YAAY,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,UAAU,IAAI,gBAAgB,IAAI,EAAE;YACpC,EAAE;YACF,QAAQ,MAAM,CAAC,IAAI,EAAE;YACrB,iFAAiF;YACjF,4EAA4E;YAC5E,EAAE;SACH,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/commands/plugin.d.ts

@@ -0,0 +1,28 @@
+/**
+ * nsg plugin-* — manage guild plugins.
+ *
+ * Framework commands for plugin lifecycle. Available via CLI only (not MCP).
+ *
+ * Plugin install/remove are pure npm + guild.json operations. No tool
+ * discovery at install time — tools are resolved at runtime by the
+ * Instrumentarium via its permission-based model.
+ */
+import { z } from 'zod';
+export declare const pluginList: import("@shardworks/tools-apparatus").ToolDefinition<{
+    json: z.ZodOptional<z.ZodBoolean>;
+}>;
+export declare const pluginInstall: import("@shardworks/tools-apparatus").ToolDefinition<{
+    source: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+        link: "link";
+        registry: "registry";
+    }>>;
+}>;
+export declare const pluginRemove: import("@shardworks/tools-apparatus").ToolDefinition<{
+    name: z.ZodString;
+}>;
+export declare const pluginUpgrade: import("@shardworks/tools-apparatus").ToolDefinition<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwDxB,eAAO,MAAM,UAAU;;EAsBrB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;EAoDxB,CAAC;AAEH,eAAO,MAAM,YAAY;;EA8BvB,CAAC;AAEH,eAAO,MAAM,aAAa;;;EAWxB,CAAC"}

package/dist/commands/plugin.js

@@ -0,0 +1,174 @@
+/**
+ * nsg plugin-* — manage guild plugins.
+ *
+ * Framework commands for plugin lifecycle. Available via CLI only (not MCP).
+ *
+ * Plugin install/remove are pure npm + guild.json operations. No tool
+ * discovery at install time — tools are resolved at runtime by the
+ * Instrumentarium via its permission-based model.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { tool } from '@shardworks/tools-apparatus';
+import { guild, readGuildConfig, writeGuildConfig, derivePluginId, readGuildPackageJson, resolvePackageNameForPluginId, } from '@shardworks/nexus-core';
+import { z } from 'zod';
+// ── Helpers ────────────────────────────────────────────────────────────
+function npm(args, cwd) {
+    return execFileSync('npm', args, { cwd, stdio: 'pipe', encoding: 'utf-8' });
+}
+/**
+ * Parse a source specifier to extract the npm package name.
+ * e.g. "@shardworks/nexus-stdlib@1.0" → "@shardworks/nexus-stdlib"
+ *      "nexus-stdlib" → "nexus-stdlib"
+ *
+ * Returns null for git URLs — the package name must be read from
+ * the guild's package.json after npm install.
+ *
+ * Known limitations: does not handle npm: alias specifiers, tarball URLs,
+ * or workspace: protocol. These are uncommon for plugin install and can
+ * be added if needed.
+ */
+function parsePackageName(source) {
+    if (source.startsWith('git+') || source.startsWith('git://') || source.endsWith('.git')) {
+        return null;
+    }
+    if (source.startsWith('@')) {
+        const lastAt = source.lastIndexOf('@');
+        if (lastAt > 0)
+            return source.substring(0, lastAt);
+        return source;
+    }
+    if (source.includes('@')) {
+        return source.split('@')[0];
+    }
+    return source;
+}
+/**
+ * Find the most recently added dependency in the guild's package.json.
+ * Used after `npm install <git-url>` where we can't parse the name from the source.
+ *
+ * Relies on Object.keys() returning insertion-ordered string keys (guaranteed
+ * by the ES2015 spec for non-integer keys, and by V8/Node). A diff-based
+ * approach (snapshot deps before install, compare after) would be more robust
+ * but overkill for this edge case.
+ */
+function detectInstalledPackage(guildRoot) {
+    const pkgPath = path.join(guildRoot, 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    const deps = pkg.dependencies ?? {};
+    const names = Object.keys(deps);
+    const last = names[names.length - 1];
+    if (!last)
+        throw new Error('Could not determine package name after npm install.');
+    return last;
+}
+// ── Commands ───────────────────────────────────────────────────────────
+export const pluginList = tool({
+    name: 'plugin-list',
+    description: 'List installed plugins',
+    callableBy: ['cli'],
+    params: {
+        json: z.boolean().optional().describe('Output as JSON'),
+    },
+    handler: async (params) => {
+        const { home } = guild();
+        const config = readGuildConfig(home);
+        const pluginIds = config.plugins;
+        if (pluginIds.length === 0) {
+            if (params.json)
+                return [];
+            return 'No plugins installed.';
+        }
+        if (params.json) {
+            return [...pluginIds].sort().map((id) => ({ id }));
+        }
+        return [...pluginIds].sort().join('\n');
+    },
+});
+export const pluginInstall = tool({
+    name: 'plugin-install',
+    description: 'Install a plugin into the guild',
+    callableBy: ['cli'],
+    params: {
+        source: z.string().describe('Package name, git URL, or local folder path'),
+        type: z.enum(['registry', 'link']).optional().describe('Install type: "registry" (npm install) or "link" (local folder). Auto-detected when source is a folder path.'),
+    },
+    handler: async (params) => {
+        const { home } = guild();
+        const { source } = params;
+        // Auto-detect link mode when source looks like a filesystem path
+        const sourceDir = path.resolve(source);
+        const looksLikePath = source.startsWith('.') || source.startsWith('/');
+        const isDirectory = looksLikePath && fs.existsSync(sourceDir) && fs.statSync(sourceDir).isDirectory();
+        const installType = params.type ?? (isDirectory ? 'link' : 'registry');
+        // 1. Install the npm package into the guild
+        let packageName;
+        if (installType === 'link') {
+            const sourceDir = path.resolve(source);
+            if (!fs.existsSync(path.join(sourceDir, 'package.json'))) {
+                throw new Error(`No package.json found in ${sourceDir}. --link requires a directory with a package.json.`);
+            }
+            const pkgJson = JSON.parse(fs.readFileSync(path.join(sourceDir, 'package.json'), 'utf-8'));
+            packageName = pkgJson.name;
+            npm(['install', '--save', `file:${sourceDir}`], home);
+        }
+        else {
+            npm(['install', '--save', source], home);
+            packageName = parsePackageName(source) ?? detectInstalledPackage(home);
+            const { pkgJson } = readGuildPackageJson(home, packageName);
+            if (!pkgJson) {
+                throw new Error(`Package "${packageName}" not found in node_modules after install.`);
+            }
+        }
+        const pluginId = derivePluginId(packageName);
+        // 2. Update guild.json — add to plugins list
+        const config = readGuildConfig(home);
+        if (!config.plugins.includes(pluginId)) {
+            config.plugins.push(pluginId);
+        }
+        writeGuildConfig(home, config);
+        return `Installed plugin: ${pluginId} (${packageName})`;
+    },
+});
+export const pluginRemove = tool({
+    name: 'plugin-remove',
+    description: 'Remove a plugin from the guild',
+    callableBy: ['cli'],
+    params: {
+        name: z.string().describe('Plugin id or package name to remove'),
+    },
+    handler: async (params) => {
+        const { home } = guild();
+        const config = readGuildConfig(home);
+        const targetId = params.name.startsWith('@') ? derivePluginId(params.name) : params.name;
+        if (!config.plugins.includes(targetId)) {
+            throw new Error(`Plugin "${targetId}" is not installed.`);
+        }
+        config.plugins = config.plugins.filter((id) => id !== targetId);
+        writeGuildConfig(home, config);
+        const packageName = resolvePackageNameForPluginId(home, targetId);
+        if (packageName) {
+            try {
+                npm(['uninstall', packageName], home);
+            }
+            catch {
+                // Don't fail if npm uninstall fails — guild.json is already updated
+            }
+        }
+        return `Removed plugin: ${targetId}`;
+    },
+});
+export const pluginUpgrade = tool({
+    name: 'plugin-upgrade',
+    description: 'Upgrade a plugin to a newer version',
+    callableBy: ['cli'],
+    params: {
+        name: z.string().describe('Plugin id or package name to upgrade'),
+        version: z.string().optional().describe('Target version (default: latest)'),
+    },
+    handler: async () => {
+        return 'Not yet implemented.';
+    },
+});
+//# sourceMappingURL=plugin.js.map

package/dist/commands/plugin.js.map

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