@biznetgio/neo-app 0.4.15 → 0.4.16

package/package.json

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

@@ -6,6 +6,7 @@ import { basename, join } from 'node:path';
 import { existsSync, readFileSync, readdirSync, writeFileSync, rmSync } from 'node:fs';
 import { execFileSync } from 'node:child_process';
 import { tmpdir } from 'node:os';
+import { estimateCost } from './pricing.js';
 
 export function sanitizeName(s) {
   return (
@@ -262,7 +263,16 @@ export async function deploySource(api, { projectId, src, name, port, build, ser
 
   if (dryRun) {
     for (const p of plan) log(`[dry-run] would ${p}`);
-    return { dryRun: true, plan, service: svc, environment: targetEnv };
+    // Cost confirmation before a billable deploy (handoff 3.3/3.4). A new service
+    // starts on the default compute tier; estimate from the live price book so the
+    // user sees the cost in the dry-run. Best-effort — never fail the dry-run on it.
+    let estimatedCost;
+    try {
+      const book = (await api.get('/api/v1/pricing')).data;
+      estimatedCost = estimateCost(book, { computeTier: 'micro' });
+      log(`[dry-run] estimated cost (default micro compute, ${svcType}): ~${estimatedCost.monthly} ${estimatedCost.currency}/mo (${estimatedCost.hourly}/h) — ${estimatedCost.assumptions}. Use neo_estimate for a specific size.`);
+    } catch { /* price book unavailable — skip the estimate, not the dry-run */ }
+    return { dryRun: true, plan, service: svc, environment: targetEnv, serviceType: svcType, estimatedCost };
   }
 
   if (src.mode === 'dir' || src.mode === 'zip') {

package/src/mcp/tools.js

@@ -6,6 +6,7 @@ import { resolve } from 'node:path';
 import { statSync } from 'node:fs';
 import { deploySource } from '../deploySource.js';
 import { pkgVersion } from '../util.js';
+import { estimateCost } from '../pricing.js';
 
 const str = (description) => ({ type: 'string', description });
 const int = (description) => ({ type: 'integer', description });
@@ -97,7 +98,7 @@ export const TOOLS = [
         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)' },
+        costConsent: { estimateAvailable: true, dryRunIncludesCost: true, planApplyEnforced: false, note: 'neo_estimate + deploy dry-run show cost (0.4.16); server-enforced neo_plan_stack / Approve & Create is still TODO (handoff 3.3-3.5)' },
         minClientVersion: pkgVersion(),
         deprecations: [],
       };
@@ -260,6 +261,37 @@ export const TOOLS = [
       return (await api.get(`/api/v1/orgs/${orgId}/credit`)).data;
     },
   },
+  {
+    name: 'neo_estimate',
+    description:
+      'Estimate the hourly and monthly cost (IDR) of a service or resource from the LIVE price book, so you can show the user the cost BEFORE a billable create/deploy (handoff 3.3/3.4). Read-only. Covers compute (a tier, or custom vcpu/memoryMB), persistent storage, and object storage; variable usage (queue messages, cron runs) is excluded and noted. Pass orgId to apply that org\'s price overrides.',
+    mutating: false,
+    schema: {
+      type: 'object',
+      properties: {
+        computeTier: str('Compute tier key: micro | small | medium | large | xlarge (bundled compute)'),
+        vcpu: { type: 'number', description: 'Custom vCPU count (use instead of computeTier)' },
+        memoryMB: int('Custom memory in MB (use with vcpu)'),
+        storageGB: int('Persistent/database storage in GB (optional)'),
+        objectStorageGB: int('Object-storage quota in GB (optional)'),
+        replicas: int('Replica count (default 1)'),
+        orgId: str('Organization id (optional — applies that org\'s price overrides)'),
+      },
+    },
+    async call(api, args) {
+      // Prefer the org price book (applies overrides); fall back to global defaults.
+      let orgId = args.orgId;
+      if (!orgId) { try { orgId = await api.resolveOrgId(); } catch { orgId = null; } }
+      let book;
+      try {
+        book = (await api.get(orgId ? `/api/v1/orgs/${orgId}/pricing` : '/api/v1/pricing')).data;
+      } catch {
+        book = (await api.get('/api/v1/pricing')).data; // org book may 404; global always readable
+      }
+      const est = estimateCost(book, args);
+      return { ...est, priceBook: orgId ? `org:${orgId}` : 'global-defaults' };
+    },
+  },
   {
     name: 'neo_list_templates',
     description: 'List deployable templates (e.g. wordpress, n8n, redis).',
@@ -322,7 +354,7 @@ export const TOOLS = [
         environment: args.environment || 'production',
         dryRun: !!args.dryRun,
       });
-      if (r.dryRun) return { status: 'dry_run', plan: r.plan, service: r.service, environment: r.environment };
+      if (r.dryRun) return { status: 'dry_run', plan: r.plan, service: r.service, environment: r.environment, estimatedCost: r.estimatedCost };
       if (r.pending) return { status: 'pending_approval', approvalId: r.approvalId };
       return { status: r.result, url: r.url || undefined, appId: r.appId };
     },

package/src/pricing.js

@@ -0,0 +1,77 @@
+// Cost estimation from the NEO App price book (handoff 3.3/3.4 — cost consent).
+// Pure + dependency-free so it's trivially testable and reusable by both the
+// neo_estimate MCP tool and the deploy dry-run. The price book is the live
+// `/pricing` response: { prices: [{metric,key,rate,unit,currency,active}], tiers:[{key,vcpu,memoryMB,defaultRate}] }.
+// defaultRate is IDR/MONTH; hourly SKUs prorate over 730 hours/month.
+
+export const HOURS_PER_MONTH = 730;
+
+// priceOf finds an active price entry for a metric (+ optional tier key), or null.
+function priceOf(prices, metric, key = '') {
+  return (prices || []).find((x) => x.metric === metric && (x.key || '') === key && x.active !== false) || null;
+}
+
+// The price book is NOT self-describing by metric name: `compute_tier_hour`
+// actually carries unit:"month" with a MONTHLY rate, while `vcpu_hour`/`gb_ram_hour`
+// are genuinely hourly. So always normalize by the entry's `unit`, never the name.
+function hourlyFrom(price) {
+  if (!price) return null;
+  return /month/i.test(price.unit || '') ? price.rate / HOURS_PER_MONTH : price.rate;
+}
+function monthlyFrom(price) {
+  if (!price) return null;
+  return /month/i.test(price.unit || '') ? price.rate : price.rate * HOURS_PER_MONTH;
+}
+
+// estimateCost returns { currency, hourly, monthly, breakdown, assumptions } for
+// a spec: { computeTier?, vcpu?, memoryMB?, storageGB?, objectStorageGB?, replicas? }.
+// Compute is a bundled tier (compute_tier_hour, else the tier's defaultRate/730)
+// or custom (vcpu_hour*vCPU + gb_ram_hour*GB-RAM). Storage/object use their SKUs.
+export function estimateCost(book, spec = {}) {
+  const prices = book?.prices || [];
+  const tiers = book?.tiers || [];
+  const replicas = spec.replicas && spec.replicas > 0 ? spec.replicas : 1;
+  const breakdown = [];
+  let hourly = 0;
+  let monthlyExtra = 0; // monthly-only SKUs (storage/object)
+
+  if (spec.computeTier) {
+    let h = hourlyFrom(priceOf(prices, 'compute_tier_hour', spec.computeTier));
+    if (h == null) {
+      const tier = tiers.find((t) => t.key === spec.computeTier);
+      h = tier ? tier.defaultRate / HOURS_PER_MONTH : null; // defaultRate is monthly
+    }
+    if (h == null) {
+      const known = tiers.map((t) => t.key).join(', ') || 'none in price book';
+      throw new Error(`unknown compute tier "${spec.computeTier}" — known tiers: ${known}`);
+    }
+    hourly += h * replicas;
+    breakdown.push({ item: `compute ${spec.computeTier}${replicas > 1 ? ` x${replicas}` : ''}`, hourly: h * replicas });
+  } else if (spec.vcpu || spec.memoryMB) {
+    const vc = hourlyFrom(priceOf(prices, 'vcpu_hour')) || 0;
+    const gr = hourlyFrom(priceOf(prices, 'gb_ram_hour')) || 0;
+    const h = (vc * (spec.vcpu || 0) + gr * ((spec.memoryMB || 0) / 1024)) * replicas;
+    hourly += h;
+    breakdown.push({ item: `compute custom (${spec.vcpu || 0} vCPU, ${spec.memoryMB || 0} MB)${replicas > 1 ? ` x${replicas}` : ''}`, hourly: h });
+  }
+
+  if (spec.storageGB) {
+    const m = monthlyFrom(priceOf(prices, 'storage_gb_month') || priceOf(prices, 'gb_storage_hour'));
+    if (m != null) { monthlyExtra += m * spec.storageGB; breakdown.push({ item: `storage ${spec.storageGB} GB`, monthly: m * spec.storageGB }); }
+  }
+  if (spec.objectStorageGB) {
+    const m = monthlyFrom(priceOf(prices, 'object_gb_month') || priceOf(prices, 'object_gb_hour')) || 0;
+    monthlyExtra += m * spec.objectStorageGB;
+    breakdown.push({ item: `object storage ${spec.objectStorageGB} GB`, monthly: m * spec.objectStorageGB });
+  }
+
+  const monthly = hourly * HOURS_PER_MONTH + monthlyExtra;
+  const currency = (prices.find((p) => p.currency)?.currency) || 'IDR';
+  return {
+    currency,
+    hourly: Math.round(hourly * 10000) / 10000,
+    monthly: Math.round(monthly),
+    breakdown,
+    assumptions: `${HOURS_PER_MONTH} hours/month; variable usage (queue messages, cron runs, egress) not included — this is an estimate, not a quote`,
+  };
+}