@oalo-ai/cli 0.1.0 → 0.2.0

package/src/help.js

@@ -4,7 +4,7 @@
  * same reason typegen reads the manifest instead of hardcoding a schema.
  */
 
-export const TAGLINE = "wire a local app into your OALO workspace";
+export const TAGLINE = "wire a local app into your Oalo workspace";
 
 export const TOKENS = [
   {
@@ -74,12 +74,12 @@ export const COMMANDS = [
       { flag: "--app <slug>", desc: "The app that deploy, env, logs, secrets and dockerfile use when you don't pass --app (`oalo apps` lists them). `oalo deploy --new` sets it." },
       { flag: "--env dev|prod", desc: "Which schema later commands touch. Default dev." },
       { flag: "--status", desc: "Show the current link and re-check reachability." },
-      { flag: "--no-skill", desc: "Don't install or refresh the OALO skill for coding agents (see `oalo skill`)." },
+      { flag: "--no-skill", desc: "Don't install or refresh the Oalo skill for coding agents (see `oalo skill`)." },
     ],
     notes: [
       "Every token is verified against the thing it is for BEFORE anything is saved, so a bad or mixed-up token fails here rather than later.",
       "Writes .oalo/config.json (safe to commit) and ~/.oalo/credentials.json (mode 0600, never in the project). OALO_HOME relocates the credential store.",
-      "Also installs the OALO skill for coding agents (.claude/skills/oalo/SKILL.md), or refreshes it, from this CLI version; an AGENTS.md section from `oalo skill --agents` is refreshed too.",
+      "Also installs the Oalo skill for coding agents (.claude/skills/oalo/SKILL.md), or refreshes it, from this CLI version; an AGENTS.md section from `oalo skill --agents` is refreshed too.",
     ],
     exits: { 0: "linked", 1: "verification failed", 2: "missing or invalid arguments" },
   },
@@ -245,18 +245,35 @@ export const COMMANDS = [
   },
   {
     name: "db",
-    summary: "All of an env's data as plain SQL (every app's own tables and the Oalo models), to keep a copy or take it anywhere.",
-    usage: ["oalo db dump [--env dev|prod] [--out <file.sql>] [--force]"],
+    summary: "All of an env's data as plain SQL (every app's own tables and the Oalo models), to keep a copy or take it anywhere. Or load an existing Postgres database into an env.",
+    usage: [
+      "oalo db dump [--env dev|prod] [--out <file.sql>] [--force]",
+      "oalo db restore <file> --env dev|prod [--schema <name>] [--check] [--yes]",
+      "oalo db restore --from-env <VAR> --env dev|prod [--schema <name>] [--check] [--yes]",
+    ],
     flags: [
-      { flag: "--env dev|prod", desc: "Which env's data. Default prod." },
+      { flag: "--env dev|prod", desc: "dump: which env's data. Default prod. restore: which env the data goes into, always on the command line." },
       { flag: "--out <file.sql>", desc: "Where to write it. Default <workspace>-<env>-<date>.sql here." },
       { flag: "--force", desc: "Replace the file if it exists." },
+      { flag: "--from-env <VAR>", desc: "restore: copy from a running database instead of a file. VAR is the environment variable that holds its postgres:// or postgresql:// URL. Only its host is ever shown." },
+      { flag: "--schema <name>", desc: "restore: the source schema to load. Default public, or the only one when there's just one." },
+      { flag: "--check", desc: "restore: do everything but the write, and report what would happen. Nothing is written, so it never asks." },
+      { flag: "--yes", desc: "restore: go ahead with prod without asking. Needed for prod when there's no terminal to ask at." },
     ],
     notes: [
       "Workspace admins only: it holds every member's data. Restore it into any Postgres with psql -f.",
       "Your code is in git (oalo deploy --pull); this is the data. Together they are everything you need to run your apps elsewhere.",
+      "restore loads a dump file made by pg_dump (like Heroku's latest.dump), up to 10 GB, or copies from a database URL. Admins only, and one restore at a time per Base.",
+      "The tables land in the env's schema, owned by the app's database login, so its Procfile `release:` migrations can alter them. Your app reads them at DATABASE_URL.",
+      "It's refused if a table name already exists there, and the names are listed. A failed restore leaves the env as it was.",
+      "The URL is never a flag value, since that stays in your shell history. Put it in a variable and pass --from-env VAR.",
+      "Run it with --check first. prod asks before it writes; without a terminal it needs --yes. Stop writes to the old database before the copy: writes made after it starts are lost.",
     ],
-    exits: { 0: "a whole dump was written", 1: "refused, unreachable, or cut off (the partial file is removed)", 2: "bad arguments, the file exists, or no CLI token" },
+    exits: {
+      0: "a whole dump was written, or the restore (or check) passed",
+      1: "refused, unreachable, cut off (a partial dump is removed), or the restore failed or was declined",
+      2: "bad arguments, the file exists or is missing, or no CLI token",
+    },
   },
   {
     name: "metrics",
@@ -500,7 +517,7 @@ export const COMMANDS = [
   },
   {
     name: "docs",
-    summary: "Read the OALO platform docs from your workspace: list, search, or print a page as markdown.",
+    summary: "Read the Oalo platform docs from your workspace: list, search, or print a page as markdown.",
     usage: ["oalo docs [--audience developer|trainer] [--json]", "oalo docs <slug> [--json]", "oalo docs --search \"<words>\" [--json]"],
     flags: [
       { flag: "--search <words>", desc: "Pages ranked for the words, each with the line that matched." },
@@ -509,7 +526,7 @@ export const COMMANDS = [
     ],
     notes: [
       "Served by your workspace's own server (its Base), so the pages match the version it runs.",
-      "Good starting pages for building on OALO: bring-your-repo and connect-your-own-frontend for your own code, app-environment, tokens-and-credentials, data-models, sync-rest-api, triggers-and-chaining.",
+      "Good starting pages for building on Oalo: bring-your-repo and connect-your-own-frontend for your own code, app-environment, tokens-and-credentials, data-models, sync-rest-api, triggers-and-chaining.",
       "A page goes to stdout as markdown, so `oalo docs data-models > notes.md` saves it. Related pages are listed on stderr.",
     ],
     exits: { 0: "done", 1: "no such page, or the workspace failed", 2: "no CLI token" },
@@ -542,7 +559,7 @@ export const COMMANDS = [
       { flag: "--from <https url>", desc: "With --new: make the app from a Git repository at this address instead of this folder (no local checkout needed). The Base clones one branch with its whole history (https to a public host only, up to 200 MB, 5 minutes), then makes the app as --new does. The name defaults to the repository's. Nothing is linked here." },
       { flag: "--branch <name>", desc: "With --from: the branch to import. Default: the repository's default branch." },
       { flag: "--token-env <VAR>", desc: "With --from: for a private repository, the environment variable holding an access token that can read it (a GitHub, GitLab, Bitbucket or Forgejo personal access token). Without it, at a terminal, you're asked for the token, hidden, when the host wants one. It is used for that one clone: never stored, logged or kept in the app's repo." },
-      { flag: "--pull", desc: "Fetch the app's code as OALO has it into oalo/<slug>, to merge changes made there (by the builder agent or a teammate)." },
+      { flag: "--pull", desc: "Fetch the app's code as Oalo has it into oalo/<slug>, to merge changes made there (by the builder agent or a teammate)." },
       { flag: "--replace", desc: "Make this branch the app's code even though the histories differ. The app's current code is tagged first so it can be recovered." },
       { flag: "--allow-dirty", desc: "Deploy the last commit even though there are uncommitted changes (which are not sent)." },
       { flag: "--history", desc: "The live releases the app has had, newest first." },
@@ -560,9 +577,32 @@ export const COMMANDS = [
     ],
     exits: { 0: "deployed", 1: "refused or failed", 2: "bad arguments, no CLI token, or not in a git repo" },
   },
+  {
+    name: "migrate",
+    summary: "Move an app from Heroku, Railway, Render, Fly.io or Primcloud: its Procfile, sizes, health path and variables, worked out from its files and that platform's CLI.",
+    usage: [
+      "oalo migrate <heroku|railway|render|fly|primcloud> [--from-app <name>] [--env-file <file>] [--json]",
+      "oalo migrate <platform> --apply [--app <slug>]",
+    ],
+    flags: [
+      { flag: "--from-app <name>", desc: "The app or service on the old platform (a Heroku or Fly app, a Railway or Render service). Default: what that platform's CLI is linked to here, or fly.toml's app." },
+      { flag: "--env-file <file>", desc: "More variables, from a .env file (NAME=value lines). They win over what the platform's CLI reported. For Primcloud, and for Fly secrets, which can't be read back." },
+      { flag: "--apply", desc: "Write the Procfile and .oalo/app.json (never over an existing Procfile; app.json only gains keys it lacks), and set the variables on the app's prod env. Without it, nothing changes." },
+      { flag: "--no-cli", desc: "Don't run the old platform's CLI; read only the files here and --env-file." },
+      { flag: "--app <slug>", desc: "The Oalo app the variables go to. Default: the app this folder is linked to (oalo deploy --new links it)." },
+      { flag: "--json", desc: "The plan as JSON: names only, never a value." },
+    ],
+    notes: [
+      "Run it in the app's repo. It reads fly.toml, railway.json or railway.toml, render.yaml, app.json and the Procfile, and asks the platform's CLI for variables (heroku, railway), secret names (fly) and dyno sizes (heroku) when it's installed and signed in.",
+      "Variables: PORT and each platform's own (HEROKU_*, RAILWAY_*, RENDER_*, FLY_*) are left out, and DATABASE_URL becomes EXTERNAL_DATABASE_URL, since DATABASE_URL on Oalo is the Base's own Postgres. Values are never printed or written to a file; --apply sends them to prod without restarting the app.",
+      "It says what doesn't carry over: cron jobs, volumes and disks, private addresses (*.railway.internal, *.flycast), extra replicas, build commands, an Aptfile, a VM bigger than large.",
+      "The order: oalo migrate <platform> (read the plan), --apply, commit, oalo deploy --new, oalo migrate <platform> --apply again (now the app exists, it sets the variables), then the data (oalo db restore) and oalo deploy --env prod. `oalo docs migrating-from-<platform>` walks through it.",
+    ],
+    exits: { 0: "the plan was shown, or applied", 1: "a config file couldn't be read, or the variables couldn't be set", 2: "bad arguments, an unknown platform, or no CLI token" },
+  },
   {
     name: "env",
-    summary: "An app's environment variables on OALO (API keys, settings), per env: list, set, unset, rotate-token.",
+    summary: "An app's environment variables on Oalo (API keys, settings), per env: list, set, unset, rotate-token.",
     usage: [
       "oalo env [--app <slug>] [--env dev|prod] [--json]",
       "oalo env set NAME=value [NAME=value ...] [--secret | --public] [--no-restart]",
@@ -583,7 +623,7 @@ export const COMMANDS = [
       "A variable is secret unless its name starts with VITE_, EXPO_PUBLIC_, NEXT_PUBLIC_, PUBLIC_ or REACT_APP_, or it's set with --public.",
       "Server apps get every variable, in the preview and live. Static apps (React, Expo, Flutter) only get public ones, because whatever their build sees ends up in the browser.",
       "Names Oalo sets itself can't be set: any starting with OALO_, PORT, DATABASE_URL, APP_SCHEMA, APP_SLUG, CONTAINER_HOST (and their VITE_/EXPO_PUBLIC_ forms), and the process basics (PATH, HOME, LANG, TZ, the Mix, Hex and Flutter homes). `oalo env set` refuses one by name.",
-      "A server app gets OALO_URL and OALO_SYNC_TOKEN: a Sync API token for its own env's data that can also send events, call workflows and start chat sessions, so it needs no token of its own. It also signs OALO's calls to the app's endpoints (.oalo/app.json tools). The preview's token can't touch live data, and its events and workflow calls are test runs. `rotate-token` replaces it at once and restarts the app on the new one.",
+      "A server app gets OALO_URL and OALO_SYNC_TOKEN: a Sync API token for its own env's data that can also send events, call workflows and start chat sessions, so it needs no token of its own. It also signs Oalo's calls to the app's endpoints (.oalo/app.json tools). The preview's token can't touch live data, and its events and workflow calls are test runs. `rotate-token` replaces it at once and restarts the app on the new one.",
       "A dev change restarts the preview. A prod change relaunches the live app at the commit it already runs (a build; no new code goes out). --no-restart skips that, to batch several changes: the last one without it relaunches.",
       "Admins and members with Developer access only.",
     ],
@@ -611,12 +651,12 @@ export const COMMANDS = [
     usage: ["oalo dockerfile [--app <slug>] [--json]", "oalo dockerfile --write [--force] [--app <slug>]"],
     flags: [
       { flag: "--app <slug>", desc: "The app (`oalo apps` lists them). Default: the app saved with `oalo link --app`." },
-      { flag: "--write", desc: "Save OALO's Dockerfile as ./Dockerfile, to change. Once committed, the repo's copy is used." },
+      { flag: "--write", desc: "Save Oalo's Dockerfile as ./Dockerfile, to change. Once committed, the repo's copy is used." },
       { flag: "--force", desc: "With --write, replace an existing ./Dockerfile." },
       { flag: "--json", desc: "method, source (repo or oalo), runtime and the Dockerfile's text." },
     ],
     notes: [
-      "The first that fits: the repo's own Dockerfile; OALO's for the runtime, for the languages buildpacks can't build; buildpacks for the rest. `oalo docs live-server-apps` lists which language gets which.",
+      "The first that fits: the repo's own Dockerfile; Oalo's for the runtime, for the languages buildpacks can't build; buildpacks for the rest. `oalo docs live-server-apps` lists which language gets which.",
       "Every image runs as uid 1000 with a read-only filesystem (/tmp is writable) and must serve $PORT. A Procfile's lines still name the processes: web runs the image's own command when the Procfile has no web line.",
     ],
     exits: { 0: "done", 1: "refused or failed", 2: "bad arguments or no CLI token" },
@@ -628,14 +668,14 @@ export const COMMANDS = [
     flags: [
       { flag: "--app <slug>", desc: "The app (`oalo apps` lists them). Default: the app saved with `oalo link --app`." },
       { flag: "--env dev|prod", desc: "dev is the preview, prod the live app. Default dev." },
-      { flag: "--process <name>", desc: "Only this process: web, a Procfile worker's name, release, build (a live build's output, with --env prod), or oalo (OALO's own notes)." },
+      { flag: "--process <name>", desc: "Only this process: web, a Procfile worker's name, release, build (a live build's output, with --env prod), or oalo (Oalo's own notes)." },
       { flag: "--limit N", desc: "How many recent lines (default 200, at most 2000)." },
       { flag: "--follow", desc: "Keep printing new lines as they come, until Ctrl-C." },
       { flag: "--json", desc: "One JSON object per line: at, process, line." },
     ],
     notes: [
       "The workspace keeps the last 2,000 lines per env in memory; restarting the workspace empties them.",
-      "Lines from `oalo` are OALO's own: which command started, and when a process exited and with what status.",
+      "Lines from `oalo` are Oalo's own: which command started, and when a process exited and with what status.",
       "Admins and members with Developer access only: an app can print secrets or customers' details.",
     ],
     exits: { 0: "done", 1: "refused or failed", 2: "bad arguments or no CLI token" },
@@ -790,7 +830,7 @@ export const COMMANDS = [
   },
   {
     name: "skill",
-    summary: "Teach this project's coding agent how to work on OALO.",
+    summary: "Teach this project's coding agent how to work on Oalo.",
     usage: ["oalo skill [--agents]", "oalo skill --print"],
     flags: [
       { flag: "--agents", desc: "Also write the rules into AGENTS.md (between oalo markers), for agents other than Claude Code." },

package/src/index.js

@@ -32,6 +32,7 @@ import { channels } from "./commands/channels.js";
 import { products } from "./commands/products.js";
 import { metrics, dashboards } from "./commands/metrics.js";
 import { db } from "./commands/db.js";
+import { migrate } from "./commands/migrate.js";
 import { overview, commandHelp, helpJson, COMMANDS } from "./help.js";
 import { parse } from "./args.js";
 
@@ -169,6 +170,9 @@ async function dispatch(cmd) {
     case "db":
       await db(flags, rest);
       break;
+    case "migrate":
+      await migrate(flags, rest);
+      break;
     case "secrets":
       await secrets(flags, rest);
       break;