@biznetgio/neo-app 0.3.0 → 0.4.1

package/README.md

@@ -42,7 +42,7 @@ token into agent/MCP configuration.
 
 ## Authentication
 
-API key (`kap_...`) for now. Create one in the portal (Developer Tools → API tokens).
+API key (`kap_...`) for now. Create one in the portal (Settings → API tokens).
 
 - Interactive: `neo-app login` prompts (hidden) and stores the key at
   `~/.config/neo-app/credentials.json` (mode `0600`), scoped per control-plane URL.

package/package.json

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

package/prompt.md

@@ -6,7 +6,7 @@ Keep this in sync with pkg/api/prompt.md (the copy the Go server embeds).
 -->
 # Set this repo up on NEO App
 
-**Version:** 0.3.0 · **Last updated:** 2026-10-12
+**Version:** 0.4.0 · **Last updated:** 2026-10-12
 
 These are the official setup instructions from NEO App (Biznet Gio's managed-app
 platform). If you are an AI coding agent, complete the steps below yourself by running
@@ -48,7 +48,7 @@ npx -y @biznetgio/neo-app@latest agent setup --project <project-id>
 ## 2. Authenticate (human step)
 
 `agent setup` runs this when no credential is stored. The human provides their NEO App
-API key when prompted — create one in the portal under **Developer Tools → API tokens**.
+API key when prompted — create one in the portal under **Settings → API tokens**.
 The CLI reads it directly and stores it user-only (`~/.config/neo-app/credentials.json`,
 mode 0600); it never lands in agent/MCP configuration. Relay the portal link to the
 human and let them create and paste the key into the CLI prompt — do not ask them to

package/src/commands/deploy.js

@@ -0,0 +1,118 @@
+// `neo-app deploy` — create-or-reuse a web service in the linked project and ship it,
+// then poll until the deployment reaches a terminal state (parity with `insta deploy`).
+// Sources: --image <ref> (prebuilt, no build) or --repo <git-url> (server builds it).
+
+import { basename } from 'node:path';
+import { resolveConfig } from '../config.js';
+import { getCredential } from '../creds.js';
+import { NeoApi } from '../api.js';
+import { readLink } from '../link.js';
+import { log, ok, fail, step, c } from '../util.js';
+
+function sanitizeName(s) {
+  return (
+    String(s)
+      .toLowerCase()
+      .replace(/[^a-z0-9-]+/g, '-')
+      .replace(/^-+|-+$/g, '')
+      .slice(0, 60) || 'app'
+  );
+}
+
+function pending(res) {
+  return res.status === 202 && res.data && res.data.status === 'pending_approval';
+}
+
+export async function deploy(opts = {}) {
+  const cfg = resolveConfig(opts);
+  const cred = getCredential(cfg.baseUrl);
+  if (!cred?.token) {
+    fail(`not authenticated for ${cfg.baseUrl} — run 'neo-app login'`);
+    process.exit(1);
+  }
+  const api = new NeoApi({ baseUrl: cfg.baseUrl, token: cred.token });
+
+  const projectId = opts.project || readLink()?.projectId;
+  if (!projectId) {
+    fail("no project — run 'neo-app link <project-id>' or pass --project <id>");
+    process.exit(1);
+  }
+
+  const image = opts.image;
+  const repo = opts.repo;
+  if (!image && !repo) {
+    fail('specify a source: --image <ref> or --repo <git-url>');
+    process.exit(2);
+  }
+
+  const name = sanitizeName(
+    opts.name || (image ? image.split('/').pop().split(':')[0] : basename(repo, '.git'))
+  );
+  const environment = cfg.env === 'staging' ? 'staging' : 'production';
+
+  log(`${c.bold('Deploying')} ${name} ${c.dim(`→ ${cfg.env} · project ${projectId}`)}`);
+
+  // Create-or-reuse the service by name.
+  const existing = (await api.get(`/api/v1/projects/${projectId}/apps`)).data?.applications || [];
+  let app = existing.find((a) => a.name === name);
+
+  if (!app) {
+    const res = await api.post(`/api/v1/projects/${projectId}/apps`, {
+      name,
+      environment,
+      serviceType: 'web',
+      buildType: image ? 'image' : opts.build || 'railpack',
+      image: image || undefined,
+      repoUrl: repo || undefined,
+      branch: opts.branch || undefined,
+      port: opts.port ? Number(opts.port) : undefined,
+      tls: true,
+    });
+    if (pending(res)) {
+      ok(`create submitted — pending approval (${res.data.approvalId}). An owner/admin must approve, then re-run.`);
+      return;
+    }
+    app = res.data?.application || res.data;
+    ok(`created service ${name}`);
+  } else {
+    step(`service ${name} exists — redeploying`);
+    if (image && app.image !== image) await api.put(`/api/v1/apps/${app.id}`, { image });
+  }
+
+  // Ship it.
+  const dep = await api.post(`/api/v1/apps/${app.id}/deploy`);
+  if (pending(dep)) {
+    ok(`deploy submitted — pending approval (${dep.data.approvalId}).`);
+    return;
+  }
+  const deployId = dep.data?.id;
+  step(`deployment ${deployId} started`);
+
+  const result = await pollDeployment(api, deployId, Number(opts.timeout) || 300);
+
+  const view = (await api.get(`/api/v1/apps/${app.id}`)).data?.application || {};
+  const url = view.domain ? `https://${view.domain}` : '';
+  if (result === 'success') {
+    ok(`deployed ${name}${url ? ' → ' + c.bold(url) : ''}`);
+  } else {
+    fail(`deployment ${result}${deployId ? ` (neo-app logs via 'neo_get_logs' or the portal)` : ''}`);
+    process.exitCode = 1;
+  }
+  return { appId: app.id, url, result };
+}
+
+async function pollDeployment(api, id, timeoutSec) {
+  if (!id) return 'unknown';
+  const deadline = Date.now() + timeoutSec * 1000;
+  let last = '';
+  while (Date.now() < deadline) {
+    const d = (await api.get(`/api/v1/deployments/${id}`)).data || {};
+    if (d.status && d.status !== last) {
+      step(`  ${d.status}`);
+      last = d.status;
+    }
+    if (d.status === 'success' || d.status === 'failed') return d.status;
+    await new Promise((r) => setTimeout(r, 4000));
+  }
+  return 'timeout';
+}

package/src/commands/link.js

@@ -2,6 +2,7 @@
 // InstaCloud's `insta project link`. Links the repo to a project (writes .neo-app.json)
 // after validating it against the authenticated account.
 
+import { basename } from 'node:path';
 import { resolveConfig } from '../config.js';
 import { getCredential } from '../creds.js';
 import { NeoApi, ApiError } from '../api.js';
@@ -37,6 +38,37 @@ export async function link(projectId, opts = {}) {
   }
 }
 
+// createProject makes a new project in the current org and links this repo to it
+// (parity with `insta project create`). Name defaults to the working-directory name.
+export async function createProject(name, opts = {}) {
+  const { cfg, api } = apiFor(opts);
+  const orgId = await api.resolveOrgId(opts.org);
+  const projName = String(name || opts.name || basename(process.cwd())).trim();
+  if (!projName) {
+    fail('usage: neo-app project create <name>');
+    process.exit(2);
+  }
+  let res;
+  try {
+    res = await api.post(`/api/v1/orgs/${orgId}/projects`, { name: projName });
+  } catch (e) {
+    fail(`could not create project '${projName}': ${e.message}`);
+    process.exit(1);
+  }
+  if (res.status === 202 && res.data?.status === 'pending_approval') {
+    ok(`create submitted — pending approval (${res.data.approvalId}). An owner/admin must approve.`);
+    return;
+  }
+  const proj = res.data?.project || res.data || {};
+  const environment = cfg.env === 'staging' ? 'staging' : 'production';
+  ok(`created project ${proj.name || projName}`);
+  if (proj.id) {
+    writeLink({ projectId: proj.id, environment, baseUrl: cfg.baseUrl, env: cfg.env, name: proj.name || projName });
+    ok(`linked ${proj.name || projName} / ${environment}  ${c.dim('(.neo-app.json)')}`);
+  }
+  return proj;
+}
+
 export async function listProjects(opts = {}) {
   const { api } = apiFor(opts);
   const orgId = await api.resolveOrgId(opts.org);

package/src/index.js

@@ -27,12 +27,18 @@ ${c.bold('Commands')}
   config install-mcp       Register the neo-app MCP server with detected agents
   login                    Authenticate with a NEO App API key (kap_...)
   link <project-id>        Link this repo to a project (writes .neo-app.json)
+  deploy                   Deploy a web service: --image <ref> or --repo <git-url>
+  project create [name]    Create a project (defaults to the dir name) and link it
   project list             List projects in your organization (find ids to link)
   status | whoami          Show connected account, org, environment, linked project
   mcp                      Run the local stdio MCP server (used by agents)
 
 ${c.bold('Options')}
-  --project <id>           Link this repo to a project (agent setup)
+  --project <id>           Target/link a project (agent setup, deploy)
+  --image <ref>            Deploy a prebuilt image (deploy)
+  --repo <git-url>         Deploy from a Git repo, built server-side (deploy)
+  --name <name>            Service name (deploy; default derived from the source)
+  --port <n>               Container port (deploy)
   --agent <codex|claude-code>   Target one agent (config install-mcp)
   --staging | --prod       Target staging (portal.neoapp.biznetgio.dev) or production (portal.app.neoapp.id)
   --url <url>              Override the control-plane URL (also NEO_APP_URL)
@@ -50,6 +56,13 @@ const options = {
   project: { type: 'string' },
   agent: { type: 'string' },
   org: { type: 'string' },
+  image: { type: 'string' },
+  repo: { type: 'string' },
+  name: { type: 'string' },
+  port: { type: 'string' },
+  branch: { type: 'string' },
+  build: { type: 'string' },
+  timeout: { type: 'string' },
   env: { type: 'string' },
   url: { type: 'string' },
   token: { type: 'string' },
@@ -86,8 +99,10 @@ export async function main(argv = process.argv.slice(2)) {
     if ((cmd === 'agent' && sub === 'uninstall') || (cmd === 'uninstall')) return void (await (await import('./commands/uninstall.js')).uninstall(opts));
     if (cmd === 'config' && sub === 'install-mcp') return void (await (await import('./commands/install-mcp.js')).installMcp(opts));
     if (cmd === 'login') return void (await (await import('./commands/login.js')).login(opts));
+    if (cmd === 'deploy') return void (await (await import('./commands/deploy.js')).deploy(opts));
     if (cmd === 'link') return void (await (await import('./commands/link.js')).link(sub, opts));
     if (cmd === 'project' && sub === 'link') return void (await (await import('./commands/link.js')).link(positionals[2], opts));
+    if (cmd === 'project' && sub === 'create') return void (await (await import('./commands/link.js')).createProject(positionals[2], opts));
     if (cmd === 'project' && (sub === 'list' || sub === 'ls')) return void (await (await import('./commands/link.js')).listProjects(opts));
     if (cmd === 'status' || cmd === 'whoami') return void (await (await import('./commands/status.js')).status(opts));
     if (cmd === 'mcp') return void (await (await import('./mcp/server.js')).runMcpServer());

package/src/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: neo-app
-version: 0.3.0
+version: 0.4.0
 description: Deploy and operate apps on NEO App (Biznet Gio managed-app platform) via the neo-app CLI and the neo-app MCP tools. Use for deploying services, reading logs, managing env variables, scaling, and checking deployment/approval status.
 ---