@biznetgio/neo-app 0.4.10 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biznetgio/neo-app",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "NEO App CLI — one-command agent onboarding, MCP server, and project ops for coding agents (Codex, Claude Code).",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node --test"
+    "test": "node --test",
+    "prepublishOnly": "node --test"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0"

package/src/index.js

@@ -1,19 +1,7 @@
 // CLI entrypoint: parse args and dispatch. Keep this thin — logic lives in commands/.
 
 import { parseArgs } from 'node:util';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import { c, fail } from './util.js';
-
-function version() {
-  try {
-    const p = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
-    return JSON.parse(readFileSync(p, 'utf8')).version;
-  } catch {
-    return 'dev';
-  }
-}
+import { c, fail, pkgVersion as version } from './util.js';
 
 const HELP = `${c.bold('neo-app')} — NEO App CLI for coding agents
 

package/src/mcp/server.js

@@ -9,6 +9,7 @@ import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprot
 import { resolveConfig } from '../config.js';
 import { getCredential } from '../creds.js';
 import { NeoApi } from '../api.js';
+import { pkgVersion } from '../util.js';
 import { TOOLS } from './tools.js';
 
 export async function runMcpServer() {
@@ -19,7 +20,9 @@ export async function runMcpServer() {
     console.error(`[neo-app mcp] no credential for ${cfg.baseUrl} — run 'neo-app login' or set NEO_APP_TOKEN`);
   }
 
-  const server = new Server({ name: 'neo-app', version: '0.3.0' }, { capabilities: { tools: {} } });
+  // serverInfo.version MUST equal the packed npm artifact version (handoff 3.1):
+  // derive it from package.json, never hard-code it.
+  const server = new Server({ name: 'neo-app', version: pkgVersion() }, { capabilities: { tools: {} } });
 
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: TOOLS.map((t) => ({

package/src/mcp/tools.js

@@ -5,6 +5,7 @@
 import { resolve } from 'node:path';
 import { statSync } from 'node:fs';
 import { deploySource } from '../deploySource.js';
+import { pkgVersion } from '../util.js';
 
 const str = (description) => ({ type: 'string', description });
 const int = (description) => ({ type: 'integer', description });
@@ -32,6 +33,59 @@ export const TOOLS = [
       return api.whoami();
     },
   },
+  {
+    name: 'neo_get_capabilities',
+    description:
+      'Discover this MCP server version, the control-plane it targets, and which resource types, lifecycle verbs, source types and environments are actually supported today. Call this FIRST to check compatibility before planning a deployment. The support matrix is honest about current gaps (handoff 3.2).',
+    mutating: false,
+    schema: { type: 'object', properties: {} },
+    async call(api) {
+      // Control-plane version (open /version endpoint). Best-effort: a null
+      // version just means that probe failed, not that the server is down.
+      const controlPlane = { baseUrl: api.baseUrl, version: null, gitCommit: null };
+      try {
+        const v = (await api.get('/version')).data || {};
+        controlPlane.version = v.version ?? null;
+        controlPlane.gitCommit = v.gitCommit ?? null;
+      } catch { /* leave nulls */ }
+
+      // Price book is readable by any member; surface whether cost data is
+      // available (cost consent / neo_plan_stack will consume it).
+      const pricing = { readable: false, version: null };
+      try {
+        const p = (await api.get('/api/v1/pricing')).data;
+        pricing.readable = true;
+        pricing.version = (p && !Array.isArray(p) && p.version) || null;
+      } catch { /* not readable */ }
+
+      // Honest support matrix: what THIS build does, not the roadmap. `create`
+      // is true, false, or 'via_folder' (created through neo_deploy_folder).
+      const resourceTypes = [
+        { type: 'web', create: true, deploy: true, scale: true, logs: true, variables: true, delete: false },
+        { type: 'template', create: true, deploy: true, scale: false, logs: true, variables: true, delete: false },
+        { type: 'static_site', create: false, deploy: true, scale: false, logs: true, variables: true, delete: false, note: 'currently planned/created as web (handoff 4.3)' },
+        { type: 'worker', create: false, deploy: true, scale: true, logs: true, variables: true, delete: false, note: 'currently planned/created as web (handoff 4.2)' },
+        { type: 'database', create: false, deploy: false, delete: false, note: 'REST exists; no MCP tool yet (handoff 4.4)' },
+        { type: 'queue', create: false, deploy: false, delete: false, note: 'REST exists; no MCP tool yet (handoff 4.5)' },
+        { type: 'cron', create: false, deploy: false, delete: false, note: 'REST exists; no MCP tool yet (handoff 4.6)' },
+        { type: 'object_storage', create: false, deploy: false, delete: false, note: 'REST exists; no MCP tool yet (handoff 4.7)' },
+      ];
+
+      return {
+        mcp: { name: 'neo-app', version: pkgVersion() },
+        controlPlane,
+        resourceTypes,
+        // Verbs this MCP build exposes today (no create-DB/queue/cron/bucket, no delete, no costed plan/apply yet).
+        lifecycleVerbs: ['list', 'get', 'deploy', 'scale', 'logs', 'get_variables', 'set_variable', 'list_approvals', 'get_approval', 'get_credit', 'list_templates'],
+        sourceTypes: ['git', 'image', 'dockerfile', 'local', 'template'],
+        environments: ['staging', 'production'],
+        pricing,
+        costConsent: { planApplyEnforced: false, note: 'neo_plan_stack / Approve & Create not implemented yet (handoff 3.3-3.4)' },
+        minClientVersion: pkgVersion(),
+        deprecations: [],
+      };
+    },
+  },
   {
     name: 'neo_list_projects',
     description: 'List projects in an organization. Omit orgId to use the first org.',

package/src/util.js

@@ -1,9 +1,23 @@
 // Small shared helpers: colored status lines, a config-file backup, and a PATH check.
 
-import { existsSync, copyFileSync } from 'node:fs';
+import { existsSync, copyFileSync, readFileSync } from 'node:fs';
 import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
 import readline from 'node:readline';
 
+// The installed package version — the single source for `--version`, the MCP
+// handshake (serverInfo.version), and any other place that must report it.
+// Derived from the packed package.json so it always matches the npm artifact.
+export function pkgVersion() {
+  try {
+    const p = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    return JSON.parse(readFileSync(p, 'utf8')).version;
+  } catch {
+    return 'dev';
+  }
+}
+
 const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
 const paint = (code, s) => (useColor ? `\x1b[${code}m${s}\x1b[0m` : s);