@biznetgio/neo-app 0.4.25 → 0.4.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@biznetgio/neo-app",
-  "version": "0.4.25",
+  "version": "0.4.27",
   "description": "NEO App CLI — one-command agent onboarding, MCP server, and project ops for coding agents (Codex, Claude Code).",
   "type": "module",
   "bin": {

package/src/deploySource.js

@@ -140,7 +140,7 @@ function looksStatic(dir) {
 // With `dryRun`, it performs NO create/update/upload/deploy — only the GETs needed to
 // build a plan — and returns { dryRun:true, plan } (JNG #93).
 // Returns { pending, approvalId } or { appId, url, result }. `log(msg)` is optional.
-export async function deploySource(api, { projectId, src, name, port, build, serviceType, environment, dryRun = false, timeout = 300, log = () => {} }) {
+export async function deploySource(api, { projectId, src, name, port, build, serviceType, buildCommand, publishDirectory, environment, dryRun = false, timeout = 300, log = () => {} }) {
   const defaultName =
     src.mode === 'image' ? src.image.split('/').pop().split(':')[0]
     : src.mode === 'git' ? basename(src.repo, '.git')
@@ -220,6 +220,9 @@ export async function deploySource(api, { projectId, src, name, port, build, ser
         // A worker has no public listener: don't request a port or TLS/ingress.
         port: isWorker ? undefined : (port ? Number(port) : undefined),
         tls: isWorker ? false : true,
+        // static_site native hosting: build + serve a published directory (§4.3).
+        buildCommand: svcType === 'static_site' ? (buildCommand || undefined) : undefined,
+        publishDirectory: svcType === 'static_site' ? (publishDirectory || undefined) : undefined,
       });
       if (pending(res)) return { pending: true, approvalId: res.data.approvalId };
       app = res.data?.application || res.data;

package/src/mcp/tools.js

@@ -92,7 +92,7 @@ export const TOOLS = [
       const resourceTypes = [
         { type: 'web', create: true, deploy: true, scale: true, logs: true, variables: true, delete: true },
         { type: 'template', create: true, deploy: true, scale: false, logs: true, variables: true, delete: true },
-        { type: 'static_site', create: 'via_folder', deploy: true, scale: false, logs: true, variables: true, delete: true, note: 'neo_deploy_folder serviceType=static_site (auto-detected for static-only folders); auto-detection from a repo/monorepo is still TODO (handoff 6)' },
+        { type: 'static_site', create: 'via_folder', deploy: true, scale: false, logs: true, variables: true, delete: true, nativeStatic: true, note: 'neo_deploy_folder serviceType=static_site with buildCommand/publishDirectory → native nginx static hosting (0.4.27); auto-detected for static-only folders' },
         { type: 'worker', create: 'via_folder', deploy: true, scale: true, logs: true, variables: true, delete: true, note: 'neo_deploy_folder serviceType=worker — no public ingress; repo auto-detection still TODO (handoff 6)' },
         { type: 'database', create: true, get: true, list: true, update: true, backup: true, delete: true, note: 'neo_create/list/get/update(resize)/delete_database + backup (list/create/run); restore still TODO (handoff 4.4)' },
         { type: 'queue', create: true, get: true, list: true, update: true, delete: true, note: 'neo_create/list/get/update/delete_queue (0.4.15-0.4.25) (handoff 4.5)' },
@@ -105,7 +105,7 @@ export const TOOLS = [
         controlPlane,
         resourceTypes,
         // Verbs this MCP build exposes today (no create-DB/queue/cron/bucket, no costed plan/apply yet).
-        lifecycleVerbs: ['plan', 'apply', 'get_operation', 'wait_operation', 'create', 'list', 'get', 'update', 'deploy', 'scale', 'logs', 'get_variables', 'set_variable', 'estimate', 'scan_repo', 'bind', 'unbind', 'run_cron', 'presign_object', 'delete', 'list_approvals', 'get_approval', 'get_credit', 'list_templates'],
+        lifecycleVerbs: ['plan', 'apply', 'get_operation', 'wait_operation', 'delete_stack', 'reconcile_usage', 'create', 'list', 'get', 'update', 'deploy', 'scale', 'logs', 'get_variables', 'set_variable', 'estimate', 'scan_repo', 'bind', 'unbind', 'run_cron', 'presign_object', 'backup', 'delete', 'list_approvals', 'get_approval', 'get_credit', 'list_templates'],
         bindings: { supported: true, targets: ['neo_db', 'neo_queue'], writeOnly: true, note: 'neo_bind_resource injects DATABASE_URL/NATS_URL server-side at deploy; the secret is never returned (handoff 5)' },
         sourceTypes: ['git', 'image', 'dockerfile', 'local', 'template'],
         environments: ['staging', 'production'],
@@ -349,6 +349,11 @@ export const TOOLS = [
         suggestedBuildType: s.type === 'docker' ? 'dockerfile' : 'railpack',
         contextDir: s.path || undefined,
         detectedDependencies: s.deps || [], // database | queue | object_storage, inferred from the manifest
+        // Confidence + evidence (handoff 6): an explicit Dockerfile/index.html is high
+        // confidence; a language marker is inferred (medium). The stack marker + any
+        // detectedDependencies ARE the evidence.
+        typeConfidence: (s.type === 'docker' || s.type === 'static') ? 'high' : 'medium',
+        evidence: { marker: s.type, manifestDeps: s.deps || [] },
       }));
       const anyDeps = components.some((c) => c.detectedDependencies.length);
       return {
@@ -401,6 +406,8 @@ export const TOOLS = [
         path: str('Local folder or .zip path'),
         name: str('Service name (optional)'),
         serviceType: { type: 'string', enum: ['web', 'worker', 'static_site'], description: 'web (default) | worker (no public URL) | static_site. Auto-detects static_site for a static-only folder; else web.' },
+        buildCommand: str('static_site: build command to run before serving (e.g. "npm ci && npm run build"); omit for a pre-built folder'),
+        publishDirectory: str('static_site: directory of built files to serve via nginx (e.g. "dist"); enables native static hosting'),
         port: int('Container port (optional; ignored for worker)'),
         environment: { type: 'string', enum: ['staging', 'production'], description: 'REQUIRED — staging or production. Never defaulted (handoff §2). Deploy to staging first.' },
         dryRun: { type: 'boolean', description: 'Preview the plan without creating/uploading/deploying anything (JNG #93)' },
@@ -424,6 +431,8 @@ export const TOOLS = [
         src,
         name: args.name,
         serviceType: args.serviceType,
+        buildCommand: args.buildCommand,
+        publishDirectory: args.publishDirectory,
         port: args.port,
         environment,
         dryRun: !!args.dryRun,
@@ -844,6 +853,8 @@ export const TOOLS = [
               kind: { type: 'string', enum: ['app', 'database', 'queue', 'bucket'] },
               name: str('Unique resource name within this stack (bindings reference it)'),
               serviceType: str('app: web | worker | static_site'),
+              buildCommand: str('app/static_site: build command (e.g. "npm ci && npm run build")'),
+              publishDirectory: str('static_site: built-files directory to serve (e.g. "dist")'),
               image: str('app: prebuilt image reference'),
               repoUrl: str('app: git repository URL'),
               branch: str('app: git branch'),
@@ -931,6 +942,50 @@ export const TOOLS = [
       return op;
     },
   },
+  {
+    name: 'neo_delete_stack',
+    description:
+      'Tear down a whole stack created by neo_apply_stack — deletes its resources in REVERSE dependency order (services first, then databases/queues/crons/buckets, handoff 3.6/7). Destructive and irreversible. Pass the operationId/planId from the apply.',
+    mutating: true,
+    destructive: true,
+    schema: { type: 'object', properties: { operationId: str('Operation/plan id from neo_apply_stack') }, required: ['operationId'] },
+    async call(api, args) {
+      const op = (await api.get(`/api/v1/plans/${args.operationId}`)).data;
+      const entries = Object.entries(op.result || {}).map(([name, v]) => ({ name, kind: v.kind, id: v.id })).filter((e) => e.id);
+      const rank = { app: 0, cron: 1, database: 2, queue: 2, bucket: 2 }; // services before foundations
+      entries.sort((a, b) => (rank[a.kind] ?? 3) - (rank[b.kind] ?? 3));
+      const path = { app: 'apps', database: 'databases', queue: 'queues', cron: 'crons', bucket: 'buckets' };
+      const deleted = [];
+      for (const e of entries) {
+        if (!path[e.kind]) continue;
+        try { await api.del(`/api/v1/${path[e.kind]}/${e.id}`); deleted.push({ name: e.name, kind: e.kind, status: 'deleted' }); }
+        catch (err) { deleted.push({ name: e.name, kind: e.kind, status: 'failed', error: err.message }); }
+      }
+      return { operationId: args.operationId, order: 'reverse-dependency (services → foundations)', deleted };
+    },
+  },
+  {
+    name: 'neo_reconcile_usage',
+    description:
+      'Reconcile an approved plan\'s estimated cost against actual metered usage (handoff A2). Returns the plan\'s fixed monthly estimate + price-book snapshot + the variable SKUs, and the project\'s actual usage, so billing can be checked against what was approved. Usage accrues hourly — a freshly-applied stack shows ~0 until it runs.',
+    mutating: false,
+    schema: { type: 'object', properties: { planId: str('Plan id from neo_plan_stack/apply') }, required: ['planId'] },
+    async call(api, args) {
+      const plan = (await api.get(`/api/v1/plans/${args.planId}`)).data;
+      let usage = null;
+      try { usage = (await api.get(`/api/v1/projects/${plan.projectId}/usage`)).data; } catch { /* usage may be unavailable */ }
+      return {
+        planId: args.planId,
+        projectId: plan.projectId,
+        estimatedMonthly: plan.cost?.monthly ?? null,
+        currency: plan.cost?.currency,
+        priceBook: plan.cost?.priceBook,
+        variableSkus: plan.cost?.variable || [],
+        actualUsage: redactSecrets(usage),
+        note: 'estimatedMonthly is the FIXED compute/storage estimate; actualUsage is metered (incl. variable usage). Compare over a full billing period — a just-applied stack has not accrued usage yet.',
+      };
+    },
+  },
   // --- Cleanup (handoff 3.6): MCP can delete every resource type it can reach, so
   // an agent never leaks a resource it created. These are DESTRUCTIVE and permanent;
   // the server hard-deletes the record and tears down the running workload. ---