run402 1.12.3 → 1.13.0

package/cli.mjs

@@ -20,6 +20,7 @@ Usage:
 
 Commands:
   init        Set up allowance, funding, and check tier status
+  status      Show full account state (allowance, balance, tier, projects)
   allowance   Manage your agent allowance (create, fund, balance, status)
   tier        Manage tier subscription (status, set)
   projects    Manage projects (provision, list, query, inspect, delete)
@@ -65,7 +66,12 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
 switch (cmd) {
   case "init": {
     const { run } = await import("./lib/init.mjs");
-    await run();
+    await run([sub, ...rest].filter(Boolean));
+    break;
+  }
+  case "status": {
+    const { run } = await import("./lib/status.mjs");
+    await run([sub, ...rest].filter(Boolean));
     break;
   }
   case "allowance": {

package/lib/deploy.mjs

@@ -1,7 +1,7 @@
 import { readFileSync } from "fs";
-import { API, allowanceAuthHeaders, saveProject, setActiveProjectId } from "./config.mjs";
+import { API, allowanceAuthHeaders, findProject } from "./config.mjs";
 
-const HELP = `run402 deploy — Deploy a full-stack app or static site on Run402
+const HELP = `run402 deploy — Deploy to an existing project on Run402
 
 Usage:
   run402 deploy [options]
@@ -9,11 +9,12 @@ Usage:
 
 Options:
   --manifest <file>    Path to manifest JSON file  (default: read from stdin)
+  --project <id>       Project ID to deploy to     (default: active project)
   --help, -h           Show this help message
 
 Manifest format (JSON):
   {
-    "name": "my-app",
+    "project_id": "prj_...",
     "migrations": "CREATE TABLE items (id serial PRIMARY KEY, title text NOT NULL, done boolean DEFAULT false)",
     "rls": {
       "template": "public_read_write",
@@ -28,7 +29,8 @@ Manifest format (JSON):
     "subdomain": "my-app"
   }
 
-  All fields except "name" are optional.
+  project_id is required (provision first with 'run402 provision').
+  All other fields are optional.
 
   RLS templates:
     user_owns_rows   — users see only their rows (requires owner_column per table)
@@ -40,16 +42,18 @@ Manifest format (JSON):
 
 Examples:
   run402 deploy --manifest app.json
+  run402 deploy --manifest app.json --project prj_123_1
   cat app.json | run402 deploy
 
 Prerequisites:
   - run402 init                     Set up allowance and funding
   - run402 tier set prototype       Subscribe to a tier
+  - run402 provision                Provision a project first
 
 Notes:
   - Requires an active tier subscription (run402 tier set <tier>)
-  - Project credentials (project_id, keys, URL) are saved locally after deploy
-  - Use 'run402 projects list' to see all deployed projects
+  - Provision a project first with 'run402 provision', then deploy to it
+  - Use 'run402 projects list' to see all provisioned projects
 `;
 
 async function readStdin() {
@@ -59,25 +63,30 @@ async function readStdin() {
 }
 
 export async function run(args) {
-  const opts = { manifest: null };
+  const opts = { manifest: null, project: null };
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--help" || args[i] === "-h") { console.log(HELP); process.exit(0); }
     if (args[i] === "--manifest" && args[i + 1]) opts.manifest = args[++i];
+    if (args[i] === "--project" && args[i + 1]) opts.project = args[++i];
   }
 
   const manifest = opts.manifest ? JSON.parse(readFileSync(opts.manifest, "utf-8")) : JSON.parse(await readStdin());
 
+  // --project flag overrides manifest's project_id
+  if (opts.project) manifest.project_id = opts.project;
+
+  // If no project_id in manifest, use active project
+  if (!manifest.project_id) {
+    const { id } = findProject(null);
+    manifest.project_id = id;
+  }
+
+  // Remove legacy 'name' field if present
+  delete manifest.name;
+
   const authHeaders = allowanceAuthHeaders("/deploy/v1");
   const res = await fetch(`${API}/deploy/v1`, { method: "POST", headers: { "Content-Type": "application/json", ...authHeaders }, body: JSON.stringify(manifest) });
   const result = await res.json();
   if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...result })); process.exit(1); }
-  if (result.project_id) {
-    saveProject(result.project_id, {
-      anon_key: result.anon_key, service_key: result.service_key,
-      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

@@ -5,10 +5,27 @@ import { mkdirSync } from "fs";
 const USDC_ABI = [{ name: "balanceOf", type: "function", stateMutability: "view", inputs: [{ name: "account", type: "address" }], outputs: [{ name: "", type: "uint256" }] }];
 const USDC_SEPOLIA = "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
 
+const HELP = `run402 init — Set up allowance, funding, and check tier status
+
+Usage:
+  run402 init
+
+Steps (idempotent — safe to re-run):
+  1. Creates config directory (~/.config/run402)
+  2. Creates agent allowance if none exists
+  3. Checks on-chain USDC balance; requests faucet if zero
+  4. Shows current tier subscription status
+  5. Lists local project count
+  6. Suggests next step (tier set or deploy)
+
+Run this once to get started, or again to check your setup.
+`;
+
 function short(addr) { return addr.slice(0, 6) + "..." + addr.slice(-4); }
 function line(label, value) { console.log(`  ${label.padEnd(10)} ${value}`); }
 
-export async function run() {
+export async function run(args = []) {
+  if (args.includes("--help") || args.includes("-h")) { console.log(HELP); process.exit(0); }
   console.log();
 
   // 1. Config directory

package/lib/status.mjs

@@ -0,0 +1,63 @@
+import { readAllowance, loadKeyStore, getActiveProjectId, API } from "./config.mjs";
+import { getAllowanceAuthHeaders } from "../core-dist/allowance-auth.js";
+
+const HELP = `run402 status — Show full account state in one shot
+
+Usage:
+  run402 status
+
+Displays:
+  - Allowance address and funding status
+  - Billing balance (available + held)
+  - Tier subscription (name, status, expiry)
+  - Projects (from server, with fallback to local keystore)
+  - Active project ID
+
+Output is JSON. Requires an existing allowance (run 'run402 init' first).
+`;
+
+export async function run(args = []) {
+  if (args.includes("--help") || args.includes("-h")) { console.log(HELP); process.exit(0); }
+  const allowance = readAllowance();
+  if (!allowance) {
+    console.log(JSON.stringify({ status: "no_allowance", message: "No agent allowance found. Run: run402 init" }));
+    return;
+  }
+
+  const wallet = allowance.address.toLowerCase();
+  const authHeaders = getAllowanceAuthHeaders("/tiers/v1/status");
+
+  // Parallel API calls: tier + billing balance + server-side projects
+  const [tierRes, balanceRes, projectsRes] = await Promise.all([
+    authHeaders
+      ? fetch(`${API}/tiers/v1/status`, { headers: { ...authHeaders } }).catch(() => null)
+      : null,
+    fetch(`${API}/billing/v1/accounts/${wallet}`).catch(() => null),
+    fetch(`${API}/wallets/v1/${wallet}/projects`).catch(() => null),
+  ]);
+
+  const tier = tierRes?.ok ? await tierRes.json() : null;
+  const billing = balanceRes?.ok ? await balanceRes.json() : null;
+  const remote = projectsRes?.ok ? await projectsRes.json() : null;
+
+  // Local keystore
+  const store = loadKeyStore();
+  const activeId = getActiveProjectId();
+
+  const result = {
+    allowance: {
+      address: allowance.address,
+      funded: allowance.funded || false,
+    },
+    tier: tier && tier.tier
+      ? { name: tier.tier, status: tier.status, expires: tier.lease_expires_at }
+      : null,
+    balance: billing && billing.exists
+      ? { available_usd_micros: billing.available_usd_micros, held_usd_micros: billing.held_usd_micros }
+      : null,
+    projects: remote?.projects || Object.keys(store.projects).map(id => ({ id })),
+    active_project: activeId || null,
+  };
+
+  console.log(JSON.stringify(result, null, 2));
+}

package/package.json

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