run402 1.10.1 → 1.11.0

package/cli.mjs

@@ -4,9 +4,15 @@
  * https://run402.com
  */
 
+import { readFileSync } from "node:fs";
+
 const [,, cmd, sub, ...rest] = process.argv;
 
-const HELP = `run402 v1.0.0 — Full-stack backend infra for AI agents
+const { version } = JSON.parse(
+  readFileSync(new URL("./package.json", import.meta.url), "utf8")
+);
+
+const HELP = `run402 v${version} — Full-stack backend infra for AI agents
 https://run402.com
 
 Usage:
@@ -46,9 +52,14 @@ Getting started:
   run402 deploy --manifest app.json
 `;
 
+if (cmd === '--version' || cmd === '-v') {
+  console.log(version);
+  process.exit(0);
+}
+
 if (!cmd || cmd === '--help' || cmd === '-h') {
   console.log(HELP);
-  process.exit(cmd ? 0 : 0);
+  process.exit(0);
 }
 
 switch (cmd) {

package/core-dist/keystore.js

@@ -21,8 +21,6 @@ export function loadKeyStore(path) {
                     projects[item.project_id] = {
                         anon_key: item.anon_key,
                         service_key: item.service_key,
-                        tier: item.tier,
-                        lease_expires_at: item.lease_expires_at || item.expires_at || "",
                         ...(item.site_url && { site_url: item.site_url }),
                         ...(item.deployed_at && { deployed_at: item.deployed_at }),
                     };
@@ -31,15 +29,17 @@ export function loadKeyStore(path) {
             return { projects };
         }
         if (parsed && typeof parsed === "object" && parsed.projects) {
-            // Auto-normalize expires_at → lease_expires_at
+            // Strip legacy fields (tier, lease_expires_at, expires_at) from projects
             for (const proj of Object.values(parsed.projects)) {
                 const rec = proj;
-                if (rec.expires_at && !rec.lease_expires_at) {
-                    rec.lease_expires_at = rec.expires_at;
-                    delete rec.expires_at;
-                }
+                delete rec.tier;
+                delete rec.lease_expires_at;
+                delete rec.expires_at;
             }
-            return parsed;
+            return {
+                ...(parsed.active_project_id && { active_project_id: parsed.active_project_id }),
+                projects: parsed.projects,
+            };
         }
         return { projects: {} };
     }
@@ -66,10 +66,32 @@ export function saveProject(projectId, project, path) {
     store.projects[projectId] = project;
     saveKeyStore(store, p);
 }
+export function updateProject(projectId, update, path) {
+    const p = path ?? getKeystorePath();
+    const store = loadKeyStore(p);
+    const existing = store.projects[projectId];
+    if (existing) {
+        store.projects[projectId] = { ...existing, ...update };
+        saveKeyStore(store, p);
+    }
+}
 export function removeProject(projectId, path) {
     const p = path ?? getKeystorePath();
     const store = loadKeyStore(p);
     delete store.projects[projectId];
+    if (store.active_project_id === projectId) {
+        delete store.active_project_id;
+    }
+    saveKeyStore(store, p);
+}
+export function getActiveProjectId(path) {
+    const store = loadKeyStore(path);
+    return store.active_project_id;
+}
+export function setActiveProjectId(projectId, path) {
+    const p = path ?? getKeystorePath();
+    const store = loadKeyStore(p);
+    store.active_project_id = projectId;
     saveKeyStore(store, p);
 }
 //# sourceMappingURL=keystore.js.map

package/lib/config.mjs

@@ -5,7 +5,7 @@
 
 import { getApiBase, getConfigDir, getKeystorePath, getAllowancePath } from "../core-dist/config.js";
 import { readAllowance as coreReadAllowance, saveAllowance as coreSaveAllowance } from "../core-dist/allowance.js";
-import { loadKeyStore, getProject, saveProject, removeProject, saveKeyStore } from "../core-dist/keystore.js";
+import { loadKeyStore, getProject, saveProject, updateProject, removeProject, saveKeyStore, getActiveProjectId, setActiveProjectId } from "../core-dist/keystore.js";
 
 export const CONFIG_DIR = getConfigDir();
 export const ALLOWANCE_FILE = getAllowancePath();
@@ -36,5 +36,17 @@ export function findProject(id) {
   return p;
 }
 
+export function resolveProject(id) {
+  const projectId = id || getActiveProjectId();
+  if (!projectId) { console.error("Error: no project specified and no active project set. Run: run402 projects provision"); process.exit(1); }
+  return findProject(projectId);
+}
+
+export function resolveProjectId(id) {
+  const projectId = id || getActiveProjectId();
+  if (!projectId) { console.error("Error: no project specified and no active project set. Run: run402 projects provision"); process.exit(1); }
+  return projectId;
+}
+
 // Re-export core keystore functions for direct use
-export { loadKeyStore, saveProject, removeProject, saveKeyStore };
+export { loadKeyStore, saveProject, updateProject, removeProject, saveKeyStore, getActiveProjectId, setActiveProjectId };

package/lib/deploy.mjs

@@ -1,5 +1,5 @@
 import { readFileSync } from "fs";
-import { API, allowanceAuthHeaders, saveProject } from "./config.mjs";
+import { API, allowanceAuthHeaders, saveProject, setActiveProjectId } from "./config.mjs";
 
 const HELP = `run402 deploy — Deploy a full-stack app or static site on Run402
 
@@ -55,10 +55,10 @@ export async function run(args) {
   if (result.project_id) {
     saveProject(result.project_id, {
       anon_key: result.anon_key, service_key: result.service_key,
-      tier: result.tier, lease_expires_at: result.lease_expires_at,
       site_url: result.site_url || result.subdomain_url,
       deployed_at: new Date().toISOString(),
     });
+    setActiveProjectId(result.project_id);
   }
   console.log(JSON.stringify(result, null, 2));
 }

package/lib/init.mjs

@@ -84,13 +84,6 @@ export async function run() {
     if (res.ok) tierInfo = await res.json();
   } catch {}
 
-  // Fall back to keystore if the API call failed or returned no tier
-  if (!tierInfo || !tierInfo.tier) {
-    const projects = Object.values(store.projects);
-    const active = projects.find(p => p.tier && p.lease_expires_at && new Date(p.lease_expires_at) > new Date());
-    if (active) tierInfo = { tier: active.tier, status: "active", lease_expires_at: active.lease_expires_at };
-  }
-
   if (tierInfo && tierInfo.tier && tierInfo.status === "active") {
     const expiry = tierInfo.lease_expires_at ? tierInfo.lease_expires_at.split("T")[0] : "unknown";
     line("Tier", `${tierInfo.tier} (expires ${expiry})`);

package/lib/projects.mjs

@@ -1,4 +1,4 @@
-import { findProject, loadKeyStore, saveProject, removeProject, API, allowanceAuthHeaders } from "./config.mjs";
+import { findProject, loadKeyStore, saveProject, removeProject, API, allowanceAuthHeaders, setActiveProjectId, getActiveProjectId } from "./config.mjs";
 
 const HELP = `run402 projects — Manage your deployed Run402 projects
 
@@ -8,8 +8,9 @@ Usage:
 Subcommands:
   quote                                   Show pricing tiers
   provision [--tier <tier>] [--name <n>]  Provision a new Postgres project (pays via x402)
-  list                                    List all your projects (IDs, tiers, URLs, expiry)
-  info  <id>                              Show project details: REST URL, keys, expiry
+  use   <id>                              Set the active project (used as default for other commands)
+  list                                    List all your projects (IDs, URLs, active marker)
+  info  <id>                              Show project details: REST URL, keys
   sql   <id> "<query>"                    Run a SQL query against a project's Postgres DB
   rest  <id> <table> [params]             Query a table via the REST API (PostgREST)
   usage <id>                              Show compute/storage usage for a project
@@ -21,6 +22,7 @@ Examples:
   run402 projects quote
   run402 projects provision --tier prototype
   run402 projects provision --tier hobby --name my-app
+  run402 projects use prj_abc123
   run402 projects list
   run402 projects info abc123
   run402 projects sql abc123 "SELECT * FROM users LIMIT 5"
@@ -32,6 +34,7 @@ Examples:
 
 Notes:
   - <id> is the project_id shown in 'run402 projects list'
+  - Most commands that take <id> default to the active project if omitted
   - 'rest' uses PostgREST query syntax (table name + optional query string)
   - 'provision' requires a funded allowance — payment is automatic via x402
   - RLS templates: user_owns_rows, public_read, public_read_write
@@ -60,13 +63,13 @@ async function provision(args) {
   });
   const data = await res.json();
   if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
-  // Save project credentials locally
+  // Save project credentials locally and set as active
   if (data.project_id) {
     saveProject(data.project_id, {
       anon_key: data.anon_key, service_key: data.service_key,
-      tier: data.tier, lease_expires_at: data.lease_expires_at,
       deployed_at: new Date().toISOString(),
     });
+    setActiveProjectId(data.project_id);
   }
   console.log(JSON.stringify(data, null, 2));
 }
@@ -88,17 +91,14 @@ async function list() {
   const store = loadKeyStore();
   const entries = Object.entries(store.projects);
   if (entries.length === 0) { console.log(JSON.stringify({ status: "ok", projects: [], message: "No projects yet." })); return; }
-  console.log(JSON.stringify(entries.map(([id, p]) => ({ project_id: id, tier: p.tier, site_url: p.site_url, lease_expires_at: p.lease_expires_at, deployed_at: p.deployed_at })), null, 2));
+  const activeId = store.active_project_id;
+  console.log(JSON.stringify(entries.map(([id, p]) => ({ project_id: id, active: id === activeId, site_url: p.site_url, deployed_at: p.deployed_at })), null, 2));
 }
 
 async function info(projectId) {
   const p = findProject(projectId);
-  const active = p.lease_expires_at ? new Date(p.lease_expires_at) > new Date() : null;
   console.log(JSON.stringify({
     project_id: projectId,
-    tier: p.tier,
-    active,
-    lease_expires_at: p.lease_expires_at,
     rest_url: `${API}/rest/v1`,
     anon_key: p.anon_key,
     service_key: p.service_key,
@@ -135,6 +135,13 @@ async function schema(projectId) {
   console.log(JSON.stringify(data, null, 2));
 }
 
+async function use(projectId) {
+  if (!projectId) { console.error("Usage: run402 projects use <project_id>"); process.exit(1); }
+  findProject(projectId); // verify it exists
+  setActiveProjectId(projectId);
+  console.log(JSON.stringify({ status: "ok", active_project_id: projectId }));
+}
+
 async function deleteProject(projectId) {
   const p = findProject(projectId);
   const res = await fetch(`${API}/projects/v1/${projectId}`, { method: "DELETE", headers: { "Authorization": `Bearer ${p.service_key}` } });
@@ -155,6 +162,7 @@ export async function run(sub, args) {
   switch (sub) {
     case "quote":     await quote(); break;
     case "provision": await provision(args); break;
+    case "use":       await use(args[0]); break;
     case "list":      await list(); break;
     case "info":      await info(args[0]); break;
     case "sql":       await sqlCmd(args[0], args[1]); break;

package/lib/sites.mjs

@@ -1,21 +1,20 @@
 import { readFileSync } from "fs";
-import { API, allowanceAuthHeaders } from "./config.mjs";
+import { API, allowanceAuthHeaders, resolveProjectId, updateProject } from "./config.mjs";
 
 const HELP = `run402 sites — Deploy and manage static sites
 
 Usage:
-  run402 sites deploy --name <name> --manifest <file> [--project <id>] [--target <target>]
+  run402 sites deploy --manifest <file> [--project <id>] [--target <target>]
   run402 sites status <deployment_id>
-  cat manifest.json | run402 sites deploy --name <name>
+  cat manifest.json | run402 sites deploy
 
 Subcommands:
   deploy  Deploy a static site
   status  Check the status of a deployment
 
 Options (deploy):
-  --name <name>         Site name (e.g. 'portfolio', 'family-todo')
   --manifest <file>     Path to manifest JSON file (or read from stdin)
-  --project <id>        Optional project ID to link this deployment to
+  --project <id>        Project ID (defaults to active project)
   --target <target>     Deployment target (e.g. 'production')
   --help, -h            Show this help message
 
@@ -28,9 +27,9 @@ Manifest format (JSON):
   }
 
 Examples:
-  run402 sites deploy --name my-site --manifest site.json
-  run402 sites status dep_abc123
-  cat site.json | run402 sites deploy --name my-site
+  run402 sites deploy --manifest site.json
+  run402 sites status dpl_abc123
+  cat site.json | run402 sites deploy
 
 Notes:
   - Must include at least index.html in the files array
@@ -44,18 +43,16 @@ async function readStdin() {
 }
 
 async function deploy(args) {
-  const opts = { name: null, manifest: null, project: undefined, target: undefined };
+  const opts = { manifest: null, project: undefined, target: undefined };
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--help" || args[i] === "-h") { console.log(HELP); process.exit(0); }
-    if (args[i] === "--name" && args[i + 1]) opts.name = args[++i];
     if (args[i] === "--manifest" && args[i + 1]) opts.manifest = args[++i];
     if (args[i] === "--project" && args[i + 1]) opts.project = args[++i];
     if (args[i] === "--target" && args[i + 1]) opts.target = args[++i];
   }
-  if (!opts.name) { console.error(JSON.stringify({ status: "error", message: "Missing --name <name>" })); process.exit(1); }
+  const projectId = resolveProjectId(opts.project);
   const manifest = opts.manifest ? JSON.parse(readFileSync(opts.manifest, "utf-8")) : JSON.parse(await readStdin());
-  const body = { name: opts.name, files: manifest.files };
-  if (opts.project) body.project = opts.project;
+  const body = { files: manifest.files, project: projectId };
   if (opts.target) body.target = opts.target;
 
   const authHeaders = await allowanceAuthHeaders();
@@ -66,6 +63,9 @@ async function deploy(args) {
   });
   const data = await res.json();
   if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  if (data.deployment_id) {
+    updateProject(projectId, { last_deployment_id: data.deployment_id });
+  }
   console.log(JSON.stringify(data, null, 2));
 }
 

package/lib/subdomains.mjs

@@ -1,4 +1,4 @@
-import { findProject, API } from "./config.mjs";
+import { resolveProject, resolveProjectId, API } from "./config.mjs";
 
 const HELP = `run402 subdomains — Manage custom subdomains
 
@@ -6,31 +6,44 @@ Usage:
   run402 subdomains <subcommand> [args...]
 
 Subcommands:
-  claim  <deployment_id> <name> [--project <id>]   Claim a subdomain for a deployment
-  delete <name> [--project <id>]                    Release a subdomain
-  list   <id>                                       List subdomains for a project
+  claim  <name> [--project <id>] [--deployment <id>]   Claim a subdomain
+  delete <name> [--project <id>]                        Release a subdomain
+  list   [<id>]                                         List subdomains for a project
+
+Options default to the active project and its last deployment when omitted.
+Legacy syntax 'claim <deployment_id> <name>' is still supported.
 
 Examples:
-  run402 subdomains claim dpl_abc123 myapp
-  run402 subdomains claim dpl_abc123 myapp --project proj123
+  run402 subdomains claim myapp
+  run402 subdomains claim myapp --deployment dpl_abc123 --project proj123
   run402 subdomains delete myapp
-  run402 subdomains list proj123
+  run402 subdomains list
 
 Notes:
   - Subdomain names: 3-63 chars, lowercase alphanumeric + hyphens
   - Creates <name>.run402.com pointing to the deployment
 `;
 
-async function claim(deploymentId, name, args) {
-  const opts = { project: null };
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--project" && args[i + 1]) opts.project = args[++i];
+async function claim(positionalArgs, flagArgs) {
+  const opts = { project: null, deployment: null };
+  for (let i = 0; i < flagArgs.length; i++) {
+    if (flagArgs[i] === "--project" && flagArgs[i + 1]) opts.project = flagArgs[++i];
+    if (flagArgs[i] === "--deployment" && flagArgs[i + 1]) opts.deployment = flagArgs[++i];
   }
-  const headers = { "Content-Type": "application/json" };
-  if (opts.project) {
-    const p = findProject(opts.project);
-    headers["Authorization"] = `Bearer ${p.service_key}`;
+  // positional: [name] or [deployment_id, name]
+  let name, deploymentId;
+  if (positionalArgs.length >= 2) {
+    deploymentId = positionalArgs[0];
+    name = positionalArgs[1];
+  } else if (positionalArgs.length === 1) {
+    name = positionalArgs[0];
   }
+  if (!name) { console.error("Usage: run402 subdomains claim <name> [--project <id>] [--deployment <id>]"); process.exit(1); }
+  const projectId = resolveProjectId(opts.project);
+  const p = resolveProject(opts.project);
+  deploymentId = opts.deployment || deploymentId || p.last_deployment_id;
+  if (!deploymentId) { console.error("Error: no deployment_id specified and no recent deployment found. Deploy a site first or pass --deployment <id>."); process.exit(1); }
+  const headers = { "Content-Type": "application/json", "Authorization": `Bearer ${p.service_key}` };
   const res = await fetch(`${API}/subdomains/v1`, {
     method: "POST",
     headers,
@@ -46,11 +59,8 @@ async function deleteSubdomain(name, args) {
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--project" && args[i + 1]) opts.project = args[++i];
   }
-  const headers = {};
-  if (opts.project) {
-    const p = findProject(opts.project);
-    headers["Authorization"] = `Bearer ${p.service_key}`;
-  }
+  const p = resolveProject(opts.project);
+  const headers = { "Authorization": `Bearer ${p.service_key}` };
   const res = await fetch(`${API}/subdomains/v1/${encodeURIComponent(name)}`, {
     method: "DELETE",
     headers,
@@ -64,7 +74,7 @@ async function deleteSubdomain(name, args) {
 }
 
 async function list(projectId) {
-  const p = findProject(projectId);
+  const p = resolveProject(projectId);
   const res = await fetch(`${API}/subdomains/v1`, {
     headers: { "Authorization": `Bearer ${p.service_key}` },
   });
@@ -76,7 +86,17 @@ async function list(projectId) {
 export async function run(sub, args) {
   if (!sub || sub === '--help' || sub === '-h') { console.log(HELP); process.exit(0); }
   switch (sub) {
-    case "claim":  await claim(args[0], args[1], args.slice(2)); break;
+    case "claim": {
+      const positional = [];
+      const flags = [];
+      let i = 0;
+      while (i < args.length) {
+        if (args[i].startsWith("--")) { flags.push(args[i], args[i + 1]); i += 2; }
+        else { positional.push(args[i]); i++; }
+      }
+      await claim(positional, flags);
+      break;
+    }
     case "delete": await deleteSubdomain(args[0], args.slice(1)); break;
     case "list":   await list(args[0]); break;
     default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 micropayments.",
   "type": "module",
   "bin": {