@otomus/nerva-cli 0.1.1

package/dist/registry/plugin-registry.js

@@ -0,0 +1,134 @@
+/**
+ * Community plugin registry client.
+ *
+ * Searches the npm registry for packages with the `nerva-plugin` keyword
+ * and fetches package metadata. Uses `https.get` with no external dependencies.
+ */
+import { get } from 'node:https';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Base URL for the npm registry API. */
+const NPM_REGISTRY = 'https://registry.npmjs.org';
+/** npm search API endpoint. */
+const NPM_SEARCH_URL = 'https://registry.npmjs.org/-/v1/search';
+/** Request timeout in milliseconds. */
+const REQUEST_TIMEOUT_MS = 10_000;
+// ---------------------------------------------------------------------------
+// HTTP helpers
+// ---------------------------------------------------------------------------
+/**
+ * Performs an HTTPS GET request and returns the response body as a string.
+ *
+ * @param url - Full URL to fetch
+ * @returns Response body
+ * @throws {Error} If the request fails or returns a non-2xx status
+ */
+function httpsGet(url) {
+    return new Promise((resolve, reject) => {
+        const req = get(url, { timeout: REQUEST_TIMEOUT_MS }, (res) => {
+            const statusCode = res.statusCode ?? 0;
+            if (statusCode < 200 || statusCode >= 300) {
+                res.resume();
+                reject(new Error(`HTTP ${statusCode} from ${url}`));
+                return;
+            }
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        });
+        req.on('error', (err) => reject(new Error(`Request failed: ${err.message}`)));
+        req.on('timeout', () => {
+            req.destroy();
+            reject(new Error(`Request timed out after ${REQUEST_TIMEOUT_MS}ms`));
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Searches the npm registry for packages matching a query and the `nerva-plugin` keyword.
+ *
+ * @param query - Free-text search query
+ * @returns Array of matching plugin summaries, sorted by relevance
+ * @throws {Error} If the npm registry is unreachable or returns invalid data
+ */
+export async function searchPlugins(query) {
+    const encodedQuery = encodeURIComponent(`${query} keywords:nerva-plugin`);
+    const url = `${NPM_SEARCH_URL}?text=${encodedQuery}&size=20`;
+    const body = await httpsGet(url);
+    const data = parseJson(body, 'npm search response');
+    if (!Array.isArray(data.objects)) {
+        return [];
+    }
+    return data.objects.map((obj) => ({
+        name: obj.package.name,
+        description: obj.package.description ?? '',
+        version: obj.package.version,
+        downloads: obj.downloads?.monthly ?? 0,
+    }));
+}
+/**
+ * Fetches detailed package info from the npm registry for a specific package.
+ *
+ * @param name - Exact npm package name
+ * @returns Plugin info with name, description, latest version, and monthly downloads
+ * @throws {Error} If the package is not found or the registry is unreachable
+ */
+export async function fetchPluginInfo(name) {
+    const encodedName = encodeURIComponent(name);
+    const url = `${NPM_REGISTRY}/${encodedName}`;
+    const body = await httpsGet(url);
+    const data = parseJson(body, `npm package "${name}"`);
+    const latestVersion = data['dist-tags']?.latest ?? 'unknown';
+    const description = data.description ??
+        data.versions?.[latestVersion]?.description ??
+        '';
+    // Fetch download counts separately (different API)
+    const downloads = await fetchMonthlyDownloads(name);
+    return {
+        name: data.name,
+        description,
+        version: latestVersion,
+        downloads,
+    };
+}
+/**
+ * Fetches monthly download count for a package from the npm downloads API.
+ *
+ * Returns 0 if the request fails — download counts are non-critical metadata.
+ *
+ * @param name - Exact npm package name
+ * @returns Monthly download count
+ */
+async function fetchMonthlyDownloads(name) {
+    try {
+        const encodedName = encodeURIComponent(name);
+        const url = `https://api.npmjs.org/downloads/point/last-month/${encodedName}`;
+        const body = await httpsGet(url);
+        const data = parseJson(body, 'npm downloads');
+        return data.downloads ?? 0;
+    }
+    catch {
+        // Download counts are best-effort — don't fail the whole operation
+        return 0;
+    }
+}
+/**
+ * Parses a JSON string with a descriptive error on failure.
+ *
+ * @param raw - Raw JSON string
+ * @param context - Human-readable description of what was being parsed
+ * @returns Parsed value
+ * @throws {Error} If the JSON is invalid
+ */
+function parseJson(raw, context) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in ${context}`);
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/registry/plugin-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.js","sourceRoot":"","sources":["../../src/registry/plugin-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAqCjC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,yCAAyC;AACzC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD,+BAA+B;AAC/B,MAAM,cAAc,GAAG,wCAAwC,CAAC;AAEhE,uCAAuC;AACvC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC,GAAoB,EAAE,EAAE;YAC7E,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;YAEvC,IAAI,UAAU,GAAG,GAAG,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;gBAC1C,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,UAAU,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACtD,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;QACxE,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,kBAAkB,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa;IAC/C,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,GAAG,cAAc,SAAS,YAAY,UAAU,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,SAAS,CAAkB,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAErE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI;QACtB,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE;QAC1C,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO;QAC5B,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC;KACvC,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,GAAG,YAAY,IAAI,WAAW,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,SAAS,CAAiB,IAAI,EAAE,gBAAgB,IAAI,GAAG,CAAC,CAAC;IAEtE,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,SAAS,CAAC;IAC7D,MAAM,WAAW,GACf,IAAI,CAAC,WAAW;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,WAAW;QAC3C,EAAE,CAAC;IAEL,mDAAmD;IACnD,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW;QACX,OAAO,EAAE,aAAa;QACtB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,qBAAqB,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,oDAAoD,WAAW,EAAE,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAyB,IAAI,EAAE,eAAe,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAI,GAAW,EAAE,OAAe;IAChD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/templates/render.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Template rendering utilities.
+ *
+ * Simple string interpolation for scaffold templates.
+ * Uses {{key}} placeholders — no external template engine required.
+ */
+/** Variable map for template interpolation. */
+export type TemplateVars = Record<string, string>;
+/**
+ * Replaces all {{key}} placeholders in a template string with values from vars.
+ *
+ * Unknown placeholders are left as-is to avoid silent data loss.
+ *
+ * @param template - Raw template string with {{key}} placeholders
+ * @param vars - Key-value pairs to substitute
+ * @returns Rendered string
+ */
+export declare function renderTemplate(template: string, vars: TemplateVars): string;
+/**
+ * Converts a kebab-case or snake_case name to PascalCase for class names.
+ *
+ * @param name - Input name (e.g. "my-agent" or "my_agent")
+ * @returns PascalCase string (e.g. "MyAgent")
+ */
+export declare function toPascalCase(name: string): string;
+/**
+ * Loads a template file from the templates directory and renders it.
+ *
+ * @param lang - Project language ("python" or "typescript")
+ * @param templateName - Template filename (e.g. "agent.py.tmpl")
+ * @param vars - Variables to substitute into the template
+ * @returns Rendered file content
+ * @throws {Error} If the template file cannot be read
+ */
+export declare function loadAndRender(lang: string, templateName: string, vars: TemplateVars): Promise<string>;
+//# sourceMappingURL=render.d.ts.map

package/dist/templates/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/templates/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAMlD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/templates/render.js

@@ -0,0 +1,52 @@
+/**
+ * Template rendering utilities.
+ *
+ * Simple string interpolation for scaffold templates.
+ * Uses {{key}} placeholders — no external template engine required.
+ */
+import { readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const TEMPLATE_PATTERN = /\{\{(\w+)\}\}/g;
+const CURRENT_DIR = dirname(fileURLToPath(import.meta.url));
+/**
+ * Replaces all {{key}} placeholders in a template string with values from vars.
+ *
+ * Unknown placeholders are left as-is to avoid silent data loss.
+ *
+ * @param template - Raw template string with {{key}} placeholders
+ * @param vars - Key-value pairs to substitute
+ * @returns Rendered string
+ */
+export function renderTemplate(template, vars) {
+    return template.replace(TEMPLATE_PATTERN, (_match, key) => {
+        return key in vars ? vars[key] : `{{${key}}}`;
+    });
+}
+/**
+ * Converts a kebab-case or snake_case name to PascalCase for class names.
+ *
+ * @param name - Input name (e.g. "my-agent" or "my_agent")
+ * @returns PascalCase string (e.g. "MyAgent")
+ */
+export function toPascalCase(name) {
+    return name
+        .split(/[-_]/)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Loads a template file from the templates directory and renders it.
+ *
+ * @param lang - Project language ("python" or "typescript")
+ * @param templateName - Template filename (e.g. "agent.py.tmpl")
+ * @param vars - Variables to substitute into the template
+ * @returns Rendered file content
+ * @throws {Error} If the template file cannot be read
+ */
+export async function loadAndRender(lang, templateName, vars) {
+    const templatePath = join(CURRENT_DIR, lang, templateName);
+    const raw = await readFile(templatePath, 'utf-8');
+    return renderTemplate(raw, vars);
+}
+//# sourceMappingURL=render.js.map

package/dist/templates/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/templates/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAE1C,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAkB;IACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE;QAChE,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,YAAoB,EACpB,IAAkB;IAElB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@otomus/nerva-cli",
+  "version": "0.1.1",
+  "description": "CLI for the Nerva agent runtime",
+  "type": "module",
+  "bin": {
+    "nerva": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/otomus/nerva",
+    "directory": "packages/nerva-cli"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}