insta 0.0.11 → 0.0.13

package/dist/api.js

@@ -55,7 +55,7 @@ export class ApiClient {
         return r;
     }
     async fetch(method, path, body, auth) {
-        const headers = { 'Content-Type': 'application/json' };
+        const headers = { 'Content-Type': 'application/json', 'Insta-Hints': '1' };
         if (auth && this.cfg.accessToken)
             headers.Authorization = `Bearer ${this.cfg.accessToken}`;
         const res = await fetch(this.apiUrl + path, {

package/dist/commands/branch.js

@@ -1,11 +1,12 @@
 import { ApiClient, requireProject } from '../api.js';
 import { writeProject } from '../config.js';
-import { info, die, printJson, handleApproval } from '../util.js';
+import { info, die, printJson, handleApproval, renderNextActions } from '../util.js';
 export async function branchCreate(name, opts) {
     const api = await ApiClient.load();
     const p = await requireProject();
     const out = await api.request('POST', `/projects/${p.projectId}/branches`, { name, from: opts.from ?? p.branch });
     info(`created branch ${out.branch.name} (${out.branch.id})`);
+    renderNextActions(out.nextActions);
 }
 export async function branchList(opts) {
     const api = await ApiClient.load();

package/dist/commands/compute.js

@@ -1,5 +1,6 @@
 import { ApiClient, requireProject } from '../api.js';
 import { info, printJson, handleApproval } from '../util.js';
+import { resolveComputeServiceId } from './services.js';
 // Attach a developer-owned custom domain to a branch's compute service. Fly issues the cert + routes
 // it; the platform returns the DNS records to set in your OWN zone.
 export async function setDomain(host, opts) {
@@ -42,4 +43,29 @@ function printDomain(r, json) {
     if (!r.configured)
         info('  once DNS propagates, Fly issues the cert — re-check with `insta compute check-domain`');
 }
+async function lifecycle(verb, serviceName, opts) {
+    const api = await ApiClient.load();
+    const p = await requireProject();
+    const { services } = await api.request('GET', `/projects/${p.projectId}/services`);
+    const id = resolveComputeServiceId(services, serviceName);
+    const res = await api.rawRequest('POST', `/projects/${p.projectId}/services/${id}/${verb}`);
+    if (handleApproval(res))
+        return;
+    if (opts.json)
+        return printJson(res.body);
+    info(`compute ${res.body.service?.name ?? id}: ${verb} → desired=${res.body.service?.desired_state} (live: ${res.body.state})`);
+}
+export const computeStart = (service, opts) => lifecycle('start', service, opts);
+export const computeStop = (service, opts) => lifecycle('stop', service, opts);
+export const computeSuspend = (service, opts) => lifecycle('suspend', service, opts);
+export async function computeStatus(serviceName, opts) {
+    const api = await ApiClient.load();
+    const p = await requireProject();
+    const { services } = await api.request('GET', `/projects/${p.projectId}/services`);
+    const id = resolveComputeServiceId(services, serviceName);
+    const r = await api.request('GET', `/projects/${p.projectId}/services/${id}/state`);
+    if (opts.json)
+        return printJson(r);
+    info(`compute ${serviceName ?? id}: desired=${r.desiredState}  live=${r.state}`);
+}
 //# sourceMappingURL=compute.js.map

package/dist/commands/deploy.js

@@ -1,7 +1,7 @@
 import { resolve, join } from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
 import { ApiClient, requireProject } from '../api.js';
-import { info, die, handleApproval } from '../util.js';
+import { info, die, handleApproval, renderNextActions } from '../util.js';
 import { flyctlBuildAndPush, ensureFlyctl } from '../flyctl-build.js';
 // Map CLI options to the platform deploy request body. Pure, so it's unit-tested. --websocket is only
 // sent when set (plain deploys unchanged).
@@ -51,6 +51,7 @@ export async function deploy(dir, opts) {
     if (handleApproval(res))
         return;
     info(`deployed ${image} -> ${res.body.url} (branch ${res.body.branch}, group ${res.body.group})`);
+    renderNextActions(res.body.nextActions);
 }
 // Source mode: mint a scoped Fly deploy token from the platform, then build+push <dir> (needs a
 // Dockerfile) with flyctl's remote builder, returning the pushed image ref to deploy.

package/dist/commands/project.js

@@ -1,8 +1,19 @@
+import { createInterface } from 'node:readline/promises';
 import { ApiClient, requireProject } from '../api.js';
 import { writeProject } from '../config.js';
-import { info, die, printJson, handleApproval } from '../util.js';
+import { info, die, printJson, handleApproval, renderNextActions } from '../util.js';
 import { installObserve } from '../observe/install.js';
 import { installSkills } from '../ensure-skills.js';
+// Interactive name prompt (stderr, so piped stdout stays clean). Enter accepts the default.
+async function promptName(question, def) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return (await rl.question(`${question} [${def}]: `)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
 // Best-effort: wire the credential-audit hook into the project (no-op if assets aren't built).
 function tryInstallObserve() {
     try {
@@ -20,14 +31,30 @@ async function resolveOrg(api, given) {
         die('no org found — run `insta org create <name>`');
     return orgs[0].id;
 }
+/** A valid project name from a raw string: lowercase, non-alnum → hyphen, trimmed. */
+export function slugifyName(raw) {
+    return raw.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40);
+}
+/** Name resolution so the recommended one-liner (`insta project create`, no arg) is paste-and-run:
+ *  explicit arg wins; else prompt with the cwd basename as default (TTY); else use the basename. */
+export async function resolveProjectName(nameArg, cwd = process.cwd(), prompt) {
+    const fromDir = slugifyName(cwd.split('/').filter(Boolean).pop() ?? 'app') || 'app';
+    if (nameArg)
+        return slugifyName(nameArg);
+    if (prompt && process.stdin.isTTY)
+        return slugifyName((await prompt('project name', fromDir)) || fromDir) || fromDir;
+    return fromDir;
+}
 export async function projectCreate(name, opts) {
     const api = await ApiClient.load();
     const orgId = await resolveOrg(api, opts.org);
-    const out = await api.request('POST', `/orgs/${orgId}/projects`, { name });
+    const resolved = await resolveProjectName(name, process.cwd(), promptName);
+    const out = await api.request('POST', `/orgs/${orgId}/projects`, { name: resolved });
     await writeProject({ projectId: out.project.id, orgId, branch: out.defaultBranch.name });
-    info(`created project ${out.project.id} (${name})`);
+    info(`created project ${out.project.id} (${resolved})`);
     info(`  resources: ${out.resources.map((r) => r.kind).join(', ')}`);
     info(`  linked ./.insta/project.json (branch ${out.defaultBranch.name})`);
+    renderNextActions(out.nextActions);
     tryInstallObserve();
     await installSkills({ cwd: process.cwd() });
 }

package/dist/commands/services.js

@@ -1,6 +1,6 @@
 // `insta services` — manage a project's opt-in services (postgres | storage | compute).
 import { ApiClient, requireProject } from '../api.js';
-import { info, printJson, handleApproval } from '../util.js';
+import { info, printJson, handleApproval, renderNextActions } from '../util.js';
 export const SERVICE_TYPES = ['postgres', 'storage', 'compute'];
 // ---- pure, unit-tested helpers (throw plain Errors; the CLI guard turns them into clean output) ----
 // Validate a service-type argument against the allowed set for a command.
@@ -22,6 +22,21 @@ export function resolveServiceId(services, type, name) {
         throw new Error(`service not found: ${type} ${name}`);
     return svc.id;
 }
+// Resolve a compute service id: by name, or the sole compute service when name is omitted.
+export function resolveComputeServiceId(services, name) {
+    const compute = services.filter((s) => s.type === 'compute');
+    if (name) {
+        const svc = compute.find((s) => s.name === name);
+        if (!svc)
+            throw new Error(`compute service not found: ${name}`);
+        return svc.id;
+    }
+    if (compute.length === 0)
+        throw new Error('no compute service in this project (add one with `insta services add compute <name>`)');
+    if (compute.length > 1)
+        throw new Error(`multiple compute services — specify one: ${compute.map((s) => s.name).join(', ')}`);
+    return compute[0].id;
+}
 // ---- commands ----
 export async function servicesAdd(type, name) {
     assertType(type);
@@ -32,6 +47,7 @@ export async function servicesAdd(type, name) {
         return;
     const svc = res.body.service;
     info(`added ${type} service ${name} (${svc.id})${svc.domain ? ` — ${svc.domain}` : ''}`);
+    renderNextActions(res.body.nextActions);
 }
 export async function servicesList(opts) {
     const api = await ApiClient.load();

package/dist/index.js

@@ -73,7 +73,7 @@ orgCmd.command('list').option('--json').action(guard((o) => org.orgList(o)));
 orgCmd.command('create <name>').action(guard((name) => org.orgCreate(name)));
 // ---- project ----
 const pj = program.command('project').description('Manage projects');
-pj.command('create <name>').option('--org <id>', 'org to create under (default: personal)').action(guard((name, o) => project.projectCreate(name, o)));
+pj.command('create [name]').option('--org <id>', 'org to create under (default: personal)').action(guard((name, o) => project.projectCreate(name, o)));
 pj.command('list').option('--org <id>').option('--json').action(guard((o) => project.projectList(o)));
 pj.command('link <id>').description('Link a project to this directory').action(guard((id) => project.projectLink(id)));
 pj.command('delete').option('--project <id>').action(guard((o) => project.projectDelete(o)));
@@ -108,14 +108,22 @@ program.command('deploy [dir]').description('Deploy a source directory (built re
     .option('--image <url>', 'prebuilt container image to deploy (instead of a source dir)').option('--branch <b>').option('--group <g>').option('--port <p>')
     .option('--websocket', 'run a WebSocket app (larger guest + connection-based concurrency)')
     .action(guard((dir, o) => deploy(dir, o)));
-// ---- compute custom domains (bring your own domain → Fly cert + routing) ----
-const compute = program.command('compute').description('Compute custom domains (bring your own domain)');
+// ---- compute (lifecycle control + custom domains) ----
+const compute = program.command('compute').description('Control compute lifecycle (start/stop/suspend/status) + custom domains');
 compute.command('set-domain <host>').description('Attach a custom domain to a branch compute service (gated: deploy)')
     .option('--branch <b>').option('--group <g>').option('--json').action(guard((host, o) => computeCmd.setDomain(host, o)));
 compute.command('check-domain <host>').description("Show a custom domain's cert status + required DNS records")
     .option('--branch <b>').option('--group <g>').option('--json').action(guard((host, o) => computeCmd.checkDomain(host, o)));
 compute.command('remove-domain <host>').description('Detach a custom domain (gated: deploy)')
     .option('--branch <b>').option('--group <g>').action(guard((host, o) => computeCmd.removeDomain(host, o)));
+compute.command('start [service]').description('Bring a compute service online (persistent — re-enables auto-wake)')
+    .option('--json').action(guard((service, o) => computeCmd.computeStart(service, o)));
+compute.command('stop [service]').description('Take a compute service offline; traffic will NOT wake it until `start`')
+    .option('--json').action(guard((service, o) => computeCmd.computeStop(service, o)));
+compute.command('suspend [service]').description('Suspend a compute service (RAM snapshot); stays down until `start`')
+    .option('--json').action(guard((service, o) => computeCmd.computeSuspend(service, o)));
+compute.command('status [service]').description("Show a compute service's desired vs. live state")
+    .option('--json').action(guard((service, o) => computeCmd.computeStatus(service, o)));
 // ---- manifest ----
 program.command('manifest').description('Print an agent-legible view of the project environments').option('--json').action(guard((o) => manifest(o)));
 // ---- observability ----

package/dist/util.js

@@ -34,6 +34,31 @@ export function handleApproval(res) {
     }
     return false;
 }
+// Neutral op → an `insta` command string. Unknown ops fall back to reason-only (no crash).
+const OP_COMMAND = {
+    'service.add': (a) => `insta services add ${a.type ?? '<type>'} ${a.name ?? '<name>'}`,
+    deploy: (a) => `insta deploy${a.branch ? ` --branch ${a.branch}` : ''}`,
+    'secrets.set': (a) => `insta secrets set ${a.name ?? '<NAME>'} ${a.value ?? '<value>'}`,
+    metrics: (a) => `insta metrics ${a.target ?? 'compute'}`,
+    logs: (a) => `insta logs ${a.target ?? 'compute'}`,
+    'approvals.approve': (a) => `insta approvals approve ${a.approvalId ?? '<id>'}`,
+};
+// Pure — builds the printable lines (unit-tested). Empty input → [].
+export function nextActionsLines(actions) {
+    if (!actions || actions.length === 0)
+        return [];
+    const lines = ['Next:'];
+    for (const a of actions) {
+        const cmd = OP_COMMAND[a.op]?.(a.args ?? {});
+        const gated = a.gated ? '  [needs approval]' : '';
+        lines.push(cmd ? `  • ${a.reason}  →  ${cmd}${gated}` : `  • ${a.reason}${gated}`);
+    }
+    return lines;
+}
+export function renderNextActions(actions) {
+    for (const line of nextActionsLines(actions))
+        info(line);
+}
 // Serialize a credential bundle to .env text. All values are double-quoted (connection strings
 // contain special chars); backslashes and quotes are escaped so dotenv parsers read them back exactly.
 export function serializeEnv(bundle) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "insta",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "type": "module",
   "description": "InstaCloud CLI — a thin client of the platform control-plane API.",
   "keywords": [