@biznetgio/neo-app 0.4.11 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biznetgio/neo-app",
-  "version": "0.4.11",
+  "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": {

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.',