@apso/cli 0.8.6 → 0.10.1

package/oclif.manifest.json

@@ -1,67 +1,242 @@
 {
-  "version": "0.8.6",
+  "version": "0.10.1",
   "commands": {
-    "server:new": {
-      "id": "server:new",
-      "description": "Initialize your server project",
+    "config": {
+      "id": "config",
+      "description": "View or modify CLI configuration",
+      "strict": false,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso config",
+        "$ apso config get apiUrl",
+        "$ apso config set verbose true",
+        "$ apso config reset"
+      ],
+      "flags": {},
+      "args": {
+        "action": {
+          "name": "action",
+          "description": "Action: get, set, or reset",
+          "required": false
+        },
+        "key": {
+          "name": "key",
+          "description": "Configuration key",
+          "required": false
+        },
+        "value": {
+          "name": "value",
+          "description": "Value to set",
+          "required": false
+        }
+      }
+    },
+    "deploy": {
+      "id": "deploy",
+      "description": "Deploy the linked service",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso deploy",
+        "$ apso deploy --yes",
+        "$ apso deploy --skip-migrate",
+        "$ apso deploy --no-wait"
+      ],
+      "flags": {
+        "no-wait": {
+          "name": "no-wait",
+          "type": "boolean",
+          "description": "Trigger deploy without waiting for completion",
+          "allowNo": false
+        },
+        "yes": {
+          "name": "yes",
+          "type": "boolean",
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "allowNo": false
+        },
+        "skip-migrate": {
+          "name": "skip-migrate",
+          "type": "boolean",
+          "description": "Skip local migration validation",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "dev": {
+      "id": "dev",
+      "description": "Start the local development server using Docker Compose",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso dev",
+        "$ apso dev --build",
+        "$ apso dev --detach",
+        "$ apso dev --build --detach"
+      ],
+      "flags": {
+        "detach": {
+          "name": "detach",
+          "type": "boolean",
+          "char": "d",
+          "description": "Run containers in the background",
+          "allowNo": false
+        },
+        "build": {
+          "name": "build",
+          "type": "boolean",
+          "description": "Rebuild images before starting",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "generate": {
+      "id": "generate",
+      "description": "Generate code from .apsorc schema",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso generate",
+        "$ apso generate --skip-format",
+        "$ apso generate --language typescript",
+        "$ apso generate --language python",
+        "$ apso generate --language go"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "skip-format": {
+          "name": "skip-format",
+          "type": "boolean",
+          "description": "Skip the formatting step (useful when prettier is not available)",
+          "allowNo": false
+        },
+        "language": {
+          "name": "language",
+          "type": "option",
+          "char": "l",
+          "description": "Target language for code generation (typescript, python, go). If not specified, uses .apsorc config or prompts.",
+          "multiple": false,
+          "options": [
+            "typescript",
+            "python",
+            "go"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "init": {
+      "id": "init",
+      "description": "Create a new Apso project or clone an existing one",
       "strict": true,
       "pluginName": "@apso/cli",
       "pluginAlias": "@apso/cli",
       "pluginType": "core",
       "aliases": [],
       "examples": [
-        "$ apso server new --name TestProject",
-        "$ apso server new --name TestProject --language python",
-        "$ apso server new --name TestProject --language go"
+        "$ apso init",
+        "$ apso init --name my-app --language typescript",
+        "$ apso init --name my-app --language python --skip-platform"
       ],
       "flags": {
         "name": {
           "name": "name",
           "type": "option",
           "char": "n",
-          "description": "name of application",
-          "multiple": false
-        },
-        "type": {
-          "name": "type",
-          "type": "option",
-          "char": "t",
-          "description": "api type (rest or graphql)",
+          "description": "Project name",
           "multiple": false
         },
         "language": {
           "name": "language",
           "type": "option",
           "char": "l",
-          "description": "target language (typescript, python, go)",
+          "description": "Target language (typescript, python, go)",
           "multiple": false,
           "options": [
             "typescript",
             "python",
             "go"
           ]
+        },
+        "skip-platform": {
+          "name": "skip-platform",
+          "type": "boolean",
+          "description": "Skip platform linking (offline mode)",
+          "allowNo": false
         }
       },
-      "args": {
-        "name": {
-          "name": "name"
+      "args": {}
+    },
+    "link": {
+      "id": "link",
+      "description": "Link this project to a platform service",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso link",
+        "$ apso link --workspace my-team --service my-api",
+        "$ apso link --force"
+      ],
+      "flags": {
+        "workspace": {
+          "name": "workspace",
+          "type": "option",
+          "char": "w",
+          "description": "Workspace slug",
+          "multiple": false
+        },
+        "service": {
+          "name": "service",
+          "type": "option",
+          "char": "s",
+          "description": "Service slug",
+          "multiple": false
+        },
+        "force": {
+          "name": "force",
+          "type": "boolean",
+          "char": "f",
+          "description": "Overwrite existing link without confirmation",
+          "allowNo": false
         }
-      }
+      },
+      "args": {}
     },
-    "server:scaffold": {
-      "id": "server:scaffold",
-      "description": "Setup new entities and interfaces for an Apso Server",
+    "login": {
+      "id": "login",
+      "description": "Authenticate with the Apso platform",
       "strict": true,
       "pluginName": "@apso/cli",
       "pluginAlias": "@apso/cli",
       "pluginType": "core",
       "aliases": [],
       "examples": [
-        "$ apso server scaffold",
-        "$ apso server scaffold --skip-format",
-        "$ apso server scaffold --language typescript",
-        "$ apso server scaffold --language python",
-        "$ apso server scaffold --language go"
+        "$ apso login",
+        "$ apso login --token <api-token>"
       ],
       "flags": {
         "help": {
@@ -71,26 +246,357 @@
           "description": "Show CLI help.",
           "allowNo": false
         },
-        "skip-format": {
-          "name": "skip-format",
+        "token": {
+          "name": "token",
+          "type": "option",
+          "char": "t",
+          "description": "Use an API token directly (for CI/CD)",
+          "multiple": false
+        }
+      },
+      "args": {}
+    },
+    "logout": {
+      "id": "logout",
+      "description": "Log out from the Apso platform",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso logout"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
           "type": "boolean",
-          "description": "Skip the formatting step (useful when prettier is not available)",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "logs": {
+      "id": "logs",
+      "description": "View build logs for the linked service",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso logs",
+        "$ apso logs <build-id>"
+      ],
+      "flags": {},
+      "args": {
+        "buildId": {
+          "name": "buildId",
+          "description": "Specific build ID (defaults to latest)",
+          "required": false
+        }
+      }
+    },
+    "migrate": {
+      "id": "migrate",
+      "description": "Detect schema changes, generate migration SQL, and test against a local PGlite sandbox",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso migrate",
+        "$ apso migrate --apply",
+        "$ apso migrate --reset",
+        "$ apso migrate --sql"
+      ],
+      "flags": {
+        "apply": {
+          "name": "apply",
+          "type": "boolean",
+          "description": "Apply the migration: update the local snapshot after a successful test",
           "allowNo": false
         },
-        "language": {
-          "name": "language",
+        "reset": {
+          "name": "reset",
+          "type": "boolean",
+          "description": "Reset the sandbox (clear snapshot and PGlite data)",
+          "allowNo": false
+        },
+        "sql": {
+          "name": "sql",
+          "type": "boolean",
+          "description": "Output raw SQL only (for piping to files)",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "open": {
+      "id": "open",
+      "description": "Open the service dashboard or endpoint in browser",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso open",
+        "$ apso open --endpoint",
+        "$ apso open --dashboard"
+      ],
+      "flags": {
+        "endpoint": {
+          "name": "endpoint",
+          "type": "boolean",
+          "char": "e",
+          "description": "Open the service API endpoint",
+          "allowNo": false
+        },
+        "dashboard": {
+          "name": "dashboard",
+          "type": "boolean",
+          "char": "d",
+          "description": "Open the service dashboard (default)",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "projects": {
+      "id": "projects",
+      "description": "List projects (services) in a workspace",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso projects",
+        "$ apso projects --workspace my-team",
+        "$ apso projects --json"
+      ],
+      "flags": {
+        "workspace": {
+          "name": "workspace",
           "type": "option",
-          "char": "l",
-          "description": "Target language for code generation (typescript, python, go). If not specified, uses .apsorc config or prompts.",
-          "multiple": false,
-          "options": [
-            "typescript",
-            "python",
-            "go"
-          ]
+          "char": "w",
+          "description": "Workspace slug",
+          "multiple": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Output as JSON",
+          "allowNo": false
         }
       },
       "args": {}
+    },
+    "status": {
+      "id": "status",
+      "description": "Show the current service and latest build status",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso status"
+      ],
+      "flags": {},
+      "args": {}
+    },
+    "unlink": {
+      "id": "unlink",
+      "description": "Remove the link between this project and the platform",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso unlink",
+        "$ apso unlink --yes"
+      ],
+      "flags": {
+        "yes": {
+          "name": "yes",
+          "type": "boolean",
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "whoami": {
+      "id": "whoami",
+      "description": "Display information about the current user and context",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso whoami",
+        "$ apso whoami --json"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "json": {
+          "name": "json",
+          "type": "boolean",
+          "description": "Output as JSON",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "mcp:serve": {
+      "id": "mcp:serve",
+      "description": "Start an MCP server exposing Apso tools over stdio. Used by AI coding agents (Claude Code, Cursor, etc.) to design schemas, generate APIs, and deploy backends.",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso mcp serve",
+        "# In Claude Code settings:",
+        "# { \"mcpServers\": { \"api-tools\": { \"command\": \"apso\", \"args\": [\"mcp\", \"serve\"] } } }"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "schema:diff": {
+      "id": "schema:diff",
+      "description": "Show diff between local and remote schema",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso schema diff"
+      ],
+      "flags": {},
+      "args": {}
+    },
+    "schema:pull": {
+      "id": "schema:pull",
+      "description": "Pull remote schema to local .apsorc",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso schema pull",
+        "$ apso schema pull --yes"
+      ],
+      "flags": {
+        "yes": {
+          "name": "yes",
+          "type": "boolean",
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "schema:push": {
+      "id": "schema:push",
+      "description": "Push local schema to the platform",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso schema push",
+        "$ apso schema push --yes"
+      ],
+      "flags": {
+        "yes": {
+          "name": "yes",
+          "type": "boolean",
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "schema:validate": {
+      "id": "schema:validate",
+      "description": "Validate the local .apsorc schema",
+      "strict": true,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ apso schema validate",
+        "$ apso schema validate --local"
+      ],
+      "flags": {
+        "local": {
+          "name": "local",
+          "type": "boolean",
+          "description": "Skip server validation even if linked",
+          "allowNo": false
+        }
+      },
+      "args": {}
+    },
+    "server:new": {
+      "id": "server:new",
+      "description": "[Deprecated] Use 'apso init' instead",
+      "strict": false,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "hidden": true,
+      "aliases": [],
+      "examples": [
+        "$ apso init"
+      ],
+      "flags": {},
+      "args": {}
+    },
+    "server:scaffold": {
+      "id": "server:scaffold",
+      "description": "[Deprecated] Use 'apso generate' instead",
+      "strict": false,
+      "pluginName": "@apso/cli",
+      "pluginAlias": "@apso/cli",
+      "pluginType": "core",
+      "hidden": true,
+      "aliases": [],
+      "examples": [
+        "$ apso generate"
+      ],
+      "flags": {},
+      "args": {}
     }
   }
 }