@jinn-network/client 0.1.2 → 0.1.3-canary.262e5cda

package/dist/cli/commands/plug-ins.js

@@ -0,0 +1,282 @@
+/**
+ * `jinn plug-ins {list|add|remove|show}` — operator-facing CLI for managing
+ * Path 1 plug-ins (the bundled `claude-code-learner` impl's plug-in
+ * surface). Edits `learnerPlugIns[]` in the operator config file with
+ * install-time manifest validation.
+ *
+ * Spec: spec/2026-04-30-plug-in-surface.md §4.4.2.
+ * Plan: docs/superpowers/plans/2026-04-30-plug-in-surface-path-1-mechanism.md
+ * Task 6.
+ *
+ * Note the plural `plug-ins` (vs. existing singular `jinn plugin install`,
+ * which manages AI-host MCP servers and is unrelated).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { dirname, isAbsolute, resolve, join } from 'node:path';
+import { homedir } from 'node:os';
+import { parseArgs } from 'node:util';
+import { loadPlugInManifest } from '../../restorer/plug-ins/manifest.js';
+const DEFAULT_CONFIG_PATH = join(homedir(), '.jinn-client', 'config.json');
+function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfig(path, cfg) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+}
+function emitJson(ctx, payload) {
+    ctx.writer.write(JSON.stringify(payload) + '\n');
+}
+function emitError(ctx, code, message, details) {
+    emitJson(ctx, { error: { code, message, ...(details ? { details } : {}) } });
+    ctx.exit(1);
+}
+export async function runPlugIns({ argv, configPath = DEFAULT_CONFIG_PATH, stdout, stderr, prompt, }) {
+    const out = stdout ?? { write: (s) => process.stdout.write(s) };
+    const err = stderr ?? { write: (s) => process.stderr.write(s) };
+    const verb = argv[0];
+    if (!existsSync(configPath)) {
+        // Initialise a minimal config so list works on a fresh install.
+        writeConfig(configPath, { learnerPlugIns: [] });
+    }
+    switch (verb) {
+        case 'list':
+            return list(configPath, out);
+        case 'add':
+            return add(argv.slice(1), configPath, err, prompt);
+        case 'remove':
+            return remove(argv.slice(1), configPath, err);
+        case 'show':
+            return show(argv.slice(1), configPath, out, err);
+        default:
+            err.write(`Usage: jinn plug-ins {list|add|remove|show} ...\n`);
+            return 1;
+    }
+}
+function list(configPath, stdout) {
+    const cfg = readConfig(configPath);
+    const entries = cfg.learnerPlugIns ?? [];
+    if (entries.length === 0) {
+        stdout.write('No plug-ins installed.\n');
+        return 0;
+    }
+    for (const e of entries) {
+        stdout.write(`${e.name}\t${e.entry}\n`);
+    }
+    return 0;
+}
+/** Default TTY prompt implementation using readline. */
+function defaultPrompt(question) {
+    return new Promise((resolve) => {
+        if (!process.stdin.isTTY) {
+            // Non-interactive: return empty string (will be treated as 'n').
+            resolve('');
+            return;
+        }
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+/** Slot types that require operator confirmation because they run executable code. */
+const EXECUTABLE_SLOT_TYPES = new Set(['mcp-tool', 'memory-backend', 'hook']);
+/** Build a human-readable summary of executable slots for the confirmation prompt. */
+function summariseExecutableSlots(slots) {
+    const lines = [];
+    for (const slot of slots) {
+        if (slot.type === 'mcp-tool') {
+            lines.push(`  mcp-tool: ${slot.command} ${slot.args.join(' ')}`);
+        }
+        else if (slot.type === 'memory-backend') {
+            lines.push(`  memory-backend: ${slot.command} ${slot.args.join(' ')}`);
+        }
+        else if (slot.type === 'hook') {
+            lines.push(`  hook (${slot.event}): ${slot.entry}`);
+        }
+    }
+    return lines.join('\n');
+}
+async function add(rest, configPath, stderr, promptFn) {
+    // Parse flags: --yes and --entry <path>, ignore unknown flags gracefully.
+    const { values, positionals } = parseArgs({
+        args: rest,
+        options: {
+            entry: { type: 'string' },
+            yes: { type: 'boolean', default: false },
+        },
+        allowPositionals: true,
+        strict: false,
+    });
+    const name = positionals[0];
+    if (!name) {
+        stderr.write(`error: name required\n`);
+        return 1;
+    }
+    const entry = values.entry;
+    if (!entry) {
+        stderr.write(`error: --entry <path> required\n`);
+        return 1;
+    }
+    const yes = Boolean(values.yes);
+    const absEntry = isAbsolute(entry) ? entry : resolve(process.cwd(), entry);
+    let manifest;
+    try {
+        manifest = await loadPlugInManifest(absEntry);
+    }
+    catch (err) {
+        stderr.write(`error: invalid plug-in: ${err.message}\n`);
+        return 1;
+    }
+    if (manifest.name !== name) {
+        stderr.write(`error: name "${name}" mismatches manifest name "${manifest.name}"\n`);
+        return 1;
+    }
+    // Check for executable slots: mcp-tool, memory-backend, hook.
+    const executableSlots = manifest.slots.filter((s) => EXECUTABLE_SLOT_TYPES.has(s.type));
+    if (executableSlots.length > 0) {
+        const summary = summariseExecutableSlots(executableSlots);
+        stderr.write(`warning: plug-in "${name}" declares executable slot(s) that will run on your machine:\n${summary}\n`);
+        if (!yes) {
+            const ask = promptFn ?? defaultPrompt;
+            let answer;
+            try {
+                answer = await ask('Install anyway? [y/N] ');
+            }
+            catch {
+                answer = '';
+            }
+            if (!answer.trim().toLowerCase().startsWith('y')) {
+                stderr.write(`error: confirmation_required\n`);
+                return 1;
+            }
+        }
+    }
+    const cfg = readConfig(configPath);
+    const next = cfg.learnerPlugIns ?? [];
+    if (next.some((e) => e.name === name)) {
+        stderr.write(`error: plug-in ${name} already installed\n`);
+        return 1;
+    }
+    next.push({ name, entry: absEntry });
+    cfg.learnerPlugIns = next;
+    writeConfig(configPath, cfg);
+    return 0;
+}
+async function remove(rest, configPath, stderr) {
+    const name = rest[0];
+    if (!name) {
+        stderr.write(`error: name required\n`);
+        return 1;
+    }
+    const cfg = readConfig(configPath);
+    const list = cfg.learnerPlugIns ?? [];
+    const next = list.filter((e) => e.name !== name);
+    if (next.length === list.length) {
+        stderr.write(`error: plug-in ${name} not installed\n`);
+        return 1;
+    }
+    cfg.learnerPlugIns = next;
+    writeConfig(configPath, cfg);
+    return 0;
+}
+async function show(rest, configPath, stdout, stderr) {
+    const name = rest[0];
+    if (!name) {
+        stderr.write(`error: name required\n`);
+        return 1;
+    }
+    const cfg = readConfig(configPath);
+    const entry = (cfg.learnerPlugIns ?? []).find((e) => e.name === name);
+    if (!entry) {
+        stderr.write(`error: plug-in ${name} not installed\n`);
+        return 1;
+    }
+    const manifest = await loadPlugInManifest(entry.entry);
+    stdout.write(JSON.stringify(manifest, null, 2) + '\n');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// CommandModule wrapper for cli/index.ts
+// ---------------------------------------------------------------------------
+const HELP_TEXT = `\
+jinn plug-ins <list|add|remove|show> [options]
+
+Manage Path 1 plug-ins for the bundled claude-code-learner impl.
+A plug-in declares one or more slot contributions (phase-agent override,
+topic explorer, MCP tool, skill bundle, memory backend, hook) via a
+\`jinn-plugin.json\` manifest at its package root.
+
+Subcommands:
+  list                              Print installed plug-ins
+  add <name> --entry <pkg-path>     Validate manifest + append to config
+  remove <name>                     Drop the named entry from config
+  show <name>                       Print the named plug-in's manifest
+
+Options:
+  --config <path>                   Config file (default: ~/.jinn-client/config.json)
+  --yes                             Skip confirmation prompt for executable slots
+                                    (mcp-tool, memory-backend, hook)
+
+Examples:
+  jinn plug-ins list
+  jinn plug-ins add @example/news-explorer --entry ./node_modules/@example/news-explorer
+  jinn plug-ins add @example/news-explorer --entry ./node_modules/@example/news-explorer --yes
+  jinn plug-ins remove @example/news-explorer
+  jinn plug-ins show @example/news-explorer
+`;
+async function run(ctx) {
+    const sub = ctx.argv[0];
+    if (!sub || sub === '--help' || sub === '-h') {
+        ctx.writer.write(HELP_TEXT);
+        return;
+    }
+    // Strip an optional --config <path> from anywhere in argv before passing
+    // through to runPlugIns (which uses positional + --entry parsing).
+    let configPath = DEFAULT_CONFIG_PATH;
+    const filteredArgv = [];
+    for (let i = 0; i < ctx.argv.length; i++) {
+        const a = ctx.argv[i];
+        if (a === '--config' && i + 1 < ctx.argv.length) {
+            configPath = ctx.argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (a.startsWith('--config=')) {
+            configPath = a.slice('--config='.length);
+            continue;
+        }
+        filteredArgv.push(a);
+    }
+    // Route stdout via ctx.writer (structured output shim) and stderr via
+    // process.stderr directly so the two streams are not mixed.
+    const code = await runPlugIns({
+        argv: filteredArgv,
+        configPath,
+        stdout: { write: (s) => ctx.writer.write(s) },
+        stderr: { write: (s) => process.stderr.write(s) },
+    });
+    if (code !== 0) {
+        // Mirror impls.ts: emit a JSON error envelope on non-zero exit so callers
+        // that pipe to jq still see structured output. Keep it minimal — text
+        // already went to writer above for human readers.
+        ctx.exit(code);
+    }
+}
+const command = {
+    name: 'plug-ins',
+    summary: 'Manage Path 1 plug-ins for the claude-code-learner impl',
+    helpText: HELP_TEXT,
+    run,
+};
+export default command;
+//# sourceMappingURL=plug-ins.js.map

package/dist/cli/commands/plug-ins.js.map

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

package/dist/cli/commands/plugin-install.d.ts

@@ -1,3 +1,13 @@
 import type { CommandModule } from '../command.js';
+/** A single file change that would be made during install. */
+export interface PlanEntry {
+    target: string;
+    kind: 'mcp' | 'skill';
+    filePath: string;
+    fileExists: boolean;
+    /** Exact content that would be appended/written (not the full file). */
+    patch: string;
+    alreadyConfigured: boolean;
+}
 declare const command: CommandModule;
 export default command;