@otomus/nerva-cli 0.1.1

package/dist/commands/dev.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `nerva dev` command.
+ *
+ * Starts a development server with hot reload, watching agent/tool/middleware
+ * directories for changes and serving diagnostic endpoints.
+ */
+import { Command } from 'commander';
+import { type Server } from 'node:http';
+import { type FSWatcher } from 'node:fs';
+import { type NervaConfig } from '../config/nerva-yaml.js';
+/** A single trace event stored in memory. */
+export interface TraceEvent {
+    timestamp: string;
+    channel: string;
+    message: string;
+    children?: TraceEvent[];
+}
+/** Runtime state for the dev server, exposed for testability. */
+export interface DevServerHandle {
+    server: Server;
+    watchers: FSWatcher[];
+    traces: TraceEvent[];
+    config: NervaConfig | null;
+    close: () => Promise<void>;
+}
+/**
+ * Starts the dev server and file watchers.
+ *
+ * Exported for testing — callers should call `handle.close()` to shut down.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param port - Port number to listen on
+ * @returns DevServerHandle with server, watchers, and close method
+ */
+export declare function startDevServer(projectDir: string, port: number): Promise<DevServerHandle>;
+/**
+ * Registers the `nerva dev` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export declare function registerDevCommand(program: Command): void;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACjG,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGhD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAY5E,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAOD,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA0LD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CA0C1B;AAmBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAezD"}

package/dist/commands/dev.js

@@ -0,0 +1,257 @@
+/**
+ * `nerva dev` command.
+ *
+ * Starts a development server with hot reload, watching agent/tool/middleware
+ * directories for changes and serving diagnostic endpoints.
+ */
+import { createServer } from 'node:http';
+import { watch } from 'node:fs';
+import { join } from 'node:path';
+import { stat } from 'node:fs/promises';
+import { readNervaConfig } from '../config/nerva-yaml.js';
+import { buildTraceHtml } from './trace-ui.js';
+/** Default port for the dev server. */
+const DEFAULT_PORT = 3000;
+/** Maximum number of trace entries kept in memory. */
+const MAX_TRACES = 100;
+/** Directories watched for file changes, relative to project root. */
+const WATCHED_DIRS = ['agents', 'tools', 'middleware'];
+/**
+ * Reads the request body as a UTF-8 string.
+ *
+ * @param req - Incoming HTTP request
+ * @returns Resolved body string
+ */
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+/**
+ * Sends a JSON response with the given status code.
+ *
+ * @param res - Server response object
+ * @param statusCode - HTTP status code
+ * @param body - Object to serialize as JSON
+ */
+function sendJson(res, statusCode, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(statusCode, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(payload),
+    });
+    res.end(payload);
+}
+/**
+ * Sends an HTML response with the given status code.
+ *
+ * @param res - Server response object
+ * @param statusCode - HTTP status code
+ * @param html - HTML string to send
+ */
+function sendHtml(res, statusCode, html) {
+    res.writeHead(statusCode, {
+        'Content-Type': 'text/html; charset=utf-8',
+        'Content-Length': Buffer.byteLength(html),
+    });
+    res.end(html);
+}
+/**
+ * Adds a trace event to the in-memory store, evicting the oldest if at capacity.
+ *
+ * @param traces - Mutable trace array
+ * @param event - Event to add
+ */
+function addTrace(traces, event) {
+    traces.push(event);
+    if (traces.length > MAX_TRACES) {
+        traces.shift();
+    }
+}
+/**
+ * Handles an incoming HTTP request by routing to the appropriate endpoint.
+ *
+ * @param req - Incoming request
+ * @param res - Server response
+ * @param handle - Dev server runtime state
+ */
+async function handleRequest(req, res, handle) {
+    const url = req.url ?? '/';
+    const method = req.method ?? 'GET';
+    if (method === 'GET' && url === '/health') {
+        sendJson(res, 200, { status: 'ok', uptime: process.uptime() });
+        return;
+    }
+    if (method === 'GET' && url === '/components') {
+        if (!handle.config) {
+            sendJson(res, 503, { error: 'Config not loaded' });
+            return;
+        }
+        sendJson(res, 200, {
+            agents: handle.config.agents,
+            tools: handle.config.tools,
+            middleware: handle.config.middleware,
+            routers: handle.config.routers,
+        });
+        return;
+    }
+    if (method === 'GET' && url === '/traces') {
+        sendJson(res, 200, handle.traces);
+        return;
+    }
+    if (method === 'GET' && url === '/traces/ui') {
+        sendHtml(res, 200, buildTraceHtml());
+        return;
+    }
+    if (method === 'POST' && url === '/chat') {
+        const body = await readBody(req);
+        let message = '';
+        try {
+            const parsed = JSON.parse(body);
+            message = parsed.message ?? '';
+        }
+        catch {
+            sendJson(res, 400, { error: 'Invalid JSON body' });
+            return;
+        }
+        addTrace(handle.traces, {
+            timestamp: new Date().toISOString(),
+            channel: 'system',
+            message: `chat: ${message}`,
+        });
+        sendJson(res, 200, {
+            reply: `[mock] Received: ${message}`,
+            timestamp: new Date().toISOString(),
+        });
+        return;
+    }
+    sendJson(res, 404, { error: 'Not found' });
+}
+/**
+ * Attempts to reload nerva.yaml and logs what changed.
+ *
+ * @param projectDir - Project root directory
+ * @param handle - Dev server runtime state
+ * @param changedPath - The file path that triggered the reload
+ */
+async function reloadConfig(projectDir, handle, changedPath) {
+    try {
+        handle.config = await readNervaConfig(projectDir);
+        console.log(`[nerva dev] Reloaded config (changed: ${changedPath})`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[nerva dev] Failed to reload config: ${message}`);
+    }
+}
+/**
+ * Sets up file watchers on the standard component directories.
+ *
+ * @param projectDir - Project root directory
+ * @param handle - Dev server runtime state
+ * @returns Array of active FSWatcher instances
+ */
+async function setupWatchers(projectDir, handle) {
+    const watchers = [];
+    for (const dir of WATCHED_DIRS) {
+        const dirPath = join(projectDir, dir);
+        const exists = await stat(dirPath).then(() => true).catch(() => false);
+        if (!exists) {
+            continue;
+        }
+        const watcher = watch(dirPath, { recursive: true }, (_eventType, filename) => {
+            const changed = filename ? join(dir, filename) : dir;
+            console.log(`[nerva dev] Change detected: ${changed}`);
+            void reloadConfig(projectDir, handle, changed);
+        });
+        watchers.push(watcher);
+    }
+    return watchers;
+}
+/**
+ * Starts the dev server and file watchers.
+ *
+ * Exported for testing — callers should call `handle.close()` to shut down.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param port - Port number to listen on
+ * @returns DevServerHandle with server, watchers, and close method
+ */
+export async function startDevServer(projectDir, port) {
+    let config = null;
+    try {
+        config = await readNervaConfig(projectDir);
+    }
+    catch {
+        console.warn('[nerva dev] No nerva.yaml found — starting without config');
+    }
+    const handle = {
+        server: null,
+        watchers: [],
+        traces: [],
+        config,
+        close: async () => {
+            for (const w of handle.watchers) {
+                w.close();
+            }
+            await new Promise((resolve, reject) => {
+                handle.server.close((err) => (err ? reject(err) : resolve()));
+            });
+        },
+    };
+    const server = createServer((req, res) => {
+        handleRequest(req, res, handle).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[nerva dev] Request error: ${message}`);
+            if (!res.headersSent) {
+                sendJson(res, 500, { error: 'Internal server error' });
+            }
+        });
+    });
+    handle.server = server;
+    handle.watchers = await setupWatchers(projectDir, handle);
+    await new Promise((resolve) => {
+        server.listen(port, () => resolve());
+    });
+    return handle;
+}
+/**
+ * Prints the startup banner showing URL and watched directories.
+ *
+ * @param port - Port the server is listening on
+ * @param watchedDirs - Directories being watched for changes
+ */
+function printBanner(port, watchedDirs) {
+    console.log('');
+    console.log('  Nerva Dev Server');
+    console.log('  ================');
+    console.log(`  URL:      http://localhost:${port}`);
+    console.log(`  Health:   http://localhost:${port}/health`);
+    console.log(`  Traces:   http://localhost:${port}/traces/ui`);
+    console.log(`  Watching: ${watchedDirs.join(', ')}`);
+    console.log('');
+}
+/**
+ * Registers the `nerva dev` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export function registerDevCommand(program) {
+    program
+        .command('dev')
+        .description('Start development server with hot reload')
+        .option('-p, --port <port>', 'Port to listen on', String(DEFAULT_PORT))
+        .action(async (options) => {
+        const port = parseInt(options.port, 10);
+        if (isNaN(port) || port < 0 || port > 65535) {
+            throw new Error(`Invalid port: "${options.port}"`);
+        }
+        const projectDir = process.cwd();
+        await startDevServer(projectDir, port);
+        printBanner(port, WATCHED_DIRS);
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAA0D,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,uCAAuC;AACvC,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,sDAAsD;AACtD,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,sEAAsE;AACtE,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC;AAwBhE;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,GAAoB;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACtE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAAmB,EAAE,UAAkB,EAAE,IAAa;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE;QACxB,cAAc,EAAE,kBAAkB;QAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;KAC7C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAAmB,EAAE,UAAkB,EAAE,IAAY;IACrE,GAAG,CAAC,SAAS,CAAC,UAAU,EAAE;QACxB,cAAc,EAAE,0BAA0B;QAC1C,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;KAC1C,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,MAAoB,EAAE,KAAiB;IACvD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,aAAa,CAC1B,GAAoB,EACpB,GAAmB,EACnB,MAAuB;IAEvB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;IAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;IAEnC,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC1C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;YAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;YAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;YACpC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;SAC/B,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC1C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;QAC7C,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyB,CAAC;YACxD,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,SAAS,OAAO,EAAE;SAC5B,CAAC,CAAC;QAEH,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;YACjB,KAAK,EAAE,oBAAoB,OAAO,EAAE;YACpC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,YAAY,CACzB,UAAkB,EAClB,MAAuB,EACvB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,yCAAyC,WAAW,GAAG,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,aAAa,CAC1B,UAAkB,EAClB,MAAuB;IAEvB,MAAM,QAAQ,GAAgB,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;YAC3E,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;YACvD,KAAK,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB,EAClB,IAAY;IAEZ,IAAI,MAAM,GAAuB,IAAI,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAoB;QAC9B,MAAM,EAAE,IAAyB;QACjC,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QACV,MAAM;QACN,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChC,CAAC,CAAC,KAAK,EAAE,CAAC;YACZ,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACvC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACrD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,QAAQ,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAE1D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,IAAY,EAAE,WAA8B;IAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,SAAS,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,YAAY,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,eAAe,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;SACtE,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvC,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `nerva generate <type> <name>` command (alias: `nerva g`).
+ *
+ * Generates a new component (agent, tool, middleware, or router),
+ * creates its test file, and registers it in nerva.yaml.
+ */
+import { Command } from 'commander';
+/**
+ * Registers the `nerva generate` command (and `g` alias) with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export declare function registerGenerateCommand(program: Command): void;
+/**
+ * Executes the component generation logic.
+ *
+ * Creates the component file, its test file, and updates nerva.yaml.
+ *
+ * @param rawType - Component type string from CLI
+ * @param name - Component name
+ * @throws {Error} If type is invalid or nerva.yaml cannot be read
+ */
+export declare function executeGenerate(rawType: string, name: string): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmHpC;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAU9D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqClF"}

package/dist/commands/generate.js

@@ -0,0 +1,162 @@
+/**
+ * `nerva generate <type> <name>` command (alias: `nerva g`).
+ *
+ * Generates a new component (agent, tool, middleware, or router),
+ * creates its test file, and registers it in nerva.yaml.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { readNervaConfig, writeNervaConfig, pluralizeType, } from '../config/nerva-yaml.js';
+import { loadAndRender, toPascalCase } from '../templates/render.js';
+/** Valid component types the generate command accepts. */
+const VALID_TYPES = new Set(['agent', 'tool', 'middleware', 'router']);
+/** File extension for each language. */
+const EXTENSIONS = {
+    python: '.py',
+    typescript: '.ts',
+};
+/** Source directory prefix for each language. */
+const SOURCE_PREFIX = {
+    python: '',
+    typescript: 'src/',
+};
+/**
+ * Resolves the directory where a component file should be created.
+ *
+ * @param lang - Project language
+ * @param type - Component type
+ * @returns Relative directory path from project root
+ */
+function resolveComponentDir(lang, type) {
+    const prefix = SOURCE_PREFIX[lang] ?? '';
+    return `${prefix}${pluralizeType(type)}`;
+}
+/**
+ * Resolves the directory where a test file should be created.
+ *
+ * @returns Relative test directory path from project root
+ */
+function resolveTestDir() {
+    return 'tests';
+}
+/**
+ * Builds the template filename for a given component type and language.
+ *
+ * @param type - Component type
+ * @param lang - Project language
+ * @returns Template filename (e.g. "agent.py.tmpl")
+ */
+function templateFileName(type, lang) {
+    const ext = EXTENSIONS[lang] ?? '.py';
+    return `${type}${ext}.tmpl`;
+}
+/**
+ * Builds the test template filename for a given language.
+ *
+ * @param lang - Project language
+ * @returns Test template filename
+ */
+function testTemplateFileName(lang) {
+    const ext = EXTENSIONS[lang] ?? '.py';
+    return `test${ext}.tmpl`;
+}
+/**
+ * Builds template variables from component name and type.
+ *
+ * @param name - Component name (kebab-case)
+ * @param type - Component type
+ * @returns Template variable map
+ */
+function buildTemplateVars(name, type) {
+    return {
+        name,
+        class_name: toPascalCase(name),
+        type,
+        description: `A ${type} named ${name}`,
+    };
+}
+/**
+ * Registers a new component in the nerva.yaml configuration.
+ *
+ * @param config - Current config
+ * @param type - Component type to register
+ * @param entry - The component entry to add
+ * @returns Updated config with the new component
+ */
+function addComponentToConfig(config, type, entry) {
+    const key = pluralizeType(type);
+    const existing = config[key];
+    const isDuplicate = existing.some((e) => e.name === entry.name);
+    if (isDuplicate) {
+        return config;
+    }
+    return {
+        ...config,
+        [key]: [...existing, entry],
+    };
+}
+/**
+ * Registers the `nerva generate` command (and `g` alias) with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export function registerGenerateCommand(program) {
+    const cmd = program
+        .command('generate')
+        .alias('g')
+        .description('Generate a new component (agent, tool, middleware, router)')
+        .argument('<type>', 'Component type: agent, tool, middleware, router')
+        .argument('<name>', 'Component name (kebab-case)')
+        .action(async (type, name) => {
+        await executeGenerate(type, name);
+    });
+}
+/**
+ * Executes the component generation logic.
+ *
+ * Creates the component file, its test file, and updates nerva.yaml.
+ *
+ * @param rawType - Component type string from CLI
+ * @param name - Component name
+ * @throws {Error} If type is invalid or nerva.yaml cannot be read
+ */
+export async function executeGenerate(rawType, name) {
+    if (!VALID_TYPES.has(rawType)) {
+        throw new Error(`Unknown component type: "${rawType}". Valid types: ${[...VALID_TYPES].join(', ')}`);
+    }
+    const type = rawType;
+    const projectDir = process.cwd();
+    const config = await readNervaConfig(projectDir);
+    const lang = config.lang;
+    const ext = EXTENSIONS[lang];
+    const vars = buildTemplateVars(name, type);
+    // Generate component file
+    const componentDir = resolveComponentDir(lang, type);
+    const componentPath = join(componentDir, `${name}${ext}`);
+    const componentContent = await loadAndRender(lang, templateFileName(type, lang), vars);
+    await ensureDirForFile(join(projectDir, componentPath));
+    await writeFile(join(projectDir, componentPath), componentContent, 'utf-8');
+    // Generate test file
+    const testDir = resolveTestDir();
+    const testFileName = lang === 'python' ? `test_${name}${ext}` : `${name}.test${ext}`;
+    const testPath = join(testDir, testFileName);
+    const testContent = await loadAndRender(lang, testTemplateFileName(lang), vars);
+    await ensureDirForFile(join(projectDir, testPath));
+    await writeFile(join(projectDir, testPath), testContent, 'utf-8');
+    // Update nerva.yaml
+    const entry = { name, path: componentPath };
+    const updatedConfig = addComponentToConfig(config, type, entry);
+    await writeNervaConfig(projectDir, updatedConfig);
+    console.log(`Generated ${type}: ${componentPath}`);
+    console.log(`Generated test: ${testPath}`);
+    console.log(`Updated nerva.yaml`);
+}
+/**
+ * Ensures the parent directory of a file path exists.
+ *
+ * @param filePath - Absolute file path
+ */
+async function ensureDirForFile(filePath) {
+    await mkdir(dirname(filePath), { recursive: true });
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `nerva list` command.
+ *
+ * Reads nerva.yaml and prints all registered components in a table.
+ */
+import { Command } from 'commander';
+/**
+ * Registers the `nerva list` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export declare function registerListCommand(program: Command): void;
+/**
+ * Executes the list logic: reads nerva.yaml and prints component tables.
+ *
+ * @throws {Error} If nerva.yaml cannot be read
+ */
+export declare function executeList(): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiEpC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ1D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBjD"}

package/dist/commands/list.js

@@ -0,0 +1,96 @@
+/**
+ * `nerva list` command.
+ *
+ * Reads nerva.yaml and prints all registered components in a table.
+ */
+import { readNervaConfig } from '../config/nerva-yaml.js';
+/** Section labels for display. */
+const SECTION_LABELS = {
+    agent: 'Agents',
+    tool: 'Tools',
+    middleware: 'Middleware',
+    router: 'Routers',
+};
+/** All component types in display order. */
+const DISPLAY_ORDER = ['agent', 'tool', 'middleware', 'router'];
+/** Minimum column widths for the table. */
+const MIN_NAME_WIDTH = 20;
+const MIN_PATH_WIDTH = 40;
+/**
+ * Formats a list of component entries as padded table rows.
+ *
+ * @param entries - Components to format
+ * @param nameWidth - Column width for the name field
+ * @param pathWidth - Column width for the path field
+ * @returns Formatted row strings
+ */
+function formatEntries(entries, nameWidth, pathWidth) {
+    if (entries.length === 0) {
+        return ['  (none)'];
+    }
+    return entries.map((entry) => {
+        const name = entry.name.padEnd(nameWidth);
+        const path = entry.path.padEnd(pathWidth);
+        const desc = entry.description ?? '';
+        return `  ${name}  ${path}  ${desc}`;
+    });
+}
+/**
+ * Computes the widest name and path across all entries.
+ *
+ * @param sections - Map of component type to entries
+ * @returns Tuple of [nameWidth, pathWidth]
+ */
+function computeColumnWidths(sections) {
+    let maxName = MIN_NAME_WIDTH;
+    let maxPath = MIN_PATH_WIDTH;
+    for (const entries of Object.values(sections)) {
+        for (const entry of entries) {
+            maxName = Math.max(maxName, entry.name.length);
+            maxPath = Math.max(maxPath, entry.path.length);
+        }
+    }
+    return [maxName, maxPath];
+}
+/**
+ * Registers the `nerva list` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export function registerListCommand(program) {
+    program
+        .command('list')
+        .alias('ls')
+        .description('List all registered components')
+        .action(async () => {
+        await executeList();
+    });
+}
+/**
+ * Executes the list logic: reads nerva.yaml and prints component tables.
+ *
+ * @throws {Error} If nerva.yaml cannot be read
+ */
+export async function executeList() {
+    const projectDir = process.cwd();
+    const config = await readNervaConfig(projectDir);
+    const sections = {
+        agent: config.agents,
+        tool: config.tools,
+        middleware: config.middleware,
+        router: config.routers,
+    };
+    console.log(`\nProject: ${config.name} (${config.lang})\n`);
+    const [nameWidth, pathWidth] = computeColumnWidths(sections);
+    for (const type of DISPLAY_ORDER) {
+        const label = SECTION_LABELS[type];
+        const entries = sections[type];
+        console.log(`${label}:`);
+        const rows = formatEntries(entries, nameWidth, pathWidth);
+        for (const row of rows) {
+            console.log(row);
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/new.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `nerva new <name>` command.
+ *
+ * Scaffolds a new Nerva project directory with the correct structure
+ * for either Python or TypeScript.
+ */
+import { Command } from 'commander';
+import { type ProjectLang } from '../config/nerva-yaml.js';
+/**
+ * Registers the `nerva new` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export declare function registerNewCommand(program: Command): void;
+/**
+ * Executes the project scaffolding logic.
+ *
+ * @param name - Project name (used as directory name)
+ * @param lang - Target language
+ * @throws {Error} If the language is unsupported
+ */
+export declare function executeNew(name: string, lang: ProjectLang): Promise<void>;
+//# sourceMappingURL=new.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAA0C,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAsInG;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASzD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/E"}