@lukoweb/apitogo 0.1.85 → 0.1.87

package/dist/declarations/cli/platform/tools/lifecycle.d.ts

@@ -0,0 +1,40 @@
+import type { PlatformApiClient } from "../client/platform-api.js";
+import type { ApitogoConfig } from "../config.js";
+import type { ProgressReporter } from "../helpers/progress.js";
+interface BootstrapStep {
+    step: string;
+    status: string;
+    detail?: unknown;
+}
+export declare function resolveBootstrapProjectId(client: PlatformApiClient, args: {
+    name: string;
+    description?: string;
+    modules: string[];
+}, steps: BootstrapStep[]): Promise<{
+    projectId: string;
+    resumed: boolean;
+}>;
+export declare function handleBootstrapProject(client: PlatformApiClient, config: ApitogoConfig, args: {
+    name: string;
+    description?: string;
+    modules?: string[];
+    activatedModules?: string[];
+    selectFreePlan?: boolean;
+    wait?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    configureGatewayBaseline?: boolean;
+    authMode?: "bringYourOwnOidc" | "platformManagedEntra";
+    oidcMetadataUrl?: string;
+    oidcAllowedIssuers?: string[];
+    oidcAudiences?: string[];
+    limitsJson?: string;
+    publicHealthActionKey?: string;
+}, progress?: ProgressReporter): Promise<string>;
+export declare function handleTeardownProject(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    wait?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}, progress?: ProgressReporter): Promise<string>;
+export {};

package/dist/declarations/cli/platform/tools/platform-plan.d.ts

@@ -0,0 +1,43 @@
+import type { PlatformApiClient } from "../client/platform-api.js";
+import { type ApitogoConfig } from "../config.js";
+import type { ManifestPlanInput } from "../helpers/dev-portal-manifest.js";
+import type { ProgressReporter } from "../helpers/progress.js";
+export type PlatformPlanChoice = "free" | "starter" | "professional";
+export declare function loadPlatformPlanSelectionPayload(client: PlatformApiClient): Promise<{
+    note: string;
+    freeProjectsQuota?: import("../helpers/free-projects-quota.js").FreeProjectsQuota | undefined;
+    freeProjectsQuotaHint?: string | undefined;
+    freePlanAvailable?: boolean | undefined;
+    platformPlanCatalog: import("../helpers/platform-plan-catalog.js").PlatformPlanOption[];
+    platformPlanUserPrompt: string;
+    platformPlanSelectionAgentInstruction: string;
+}>;
+export declare function handleListPlatformPlans(client: PlatformApiClient): Promise<string>;
+export declare function handleWaitForPlatformPlan(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    wait?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}, progress?: ProgressReporter): Promise<string>;
+export declare function handleEnsurePlatformPlan(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    projectName?: string;
+    plan: PlatformPlanChoice;
+    currency?: string;
+    wait?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    modules?: string[];
+}, progress?: ProgressReporter): Promise<string>;
+export declare function assertPlatformPlanReadyForPublish(client: PlatformApiClient, projectId: string): Promise<{
+    blocked: true;
+    payload: Record<string, unknown>;
+} | {
+    blocked: false;
+}>;
+export declare function assertPaidGatewayPlansAllowedForPublish(client: PlatformApiClient, projectId: string, plans: ManifestPlanInput[] | undefined): Promise<{
+    blocked: true;
+    payload: Record<string, unknown>;
+} | {
+    blocked: false;
+}>;

package/dist/declarations/cli/platform/tools/projects.d.ts

@@ -0,0 +1,27 @@
+import type { PlatformApiClient } from "../client/platform-api.js";
+import { type ApitogoConfig } from "../config.js";
+import type { ProgressReporter } from "../helpers/progress.js";
+export declare function handleWhoami(client: PlatformApiClient): Promise<string>;
+export declare function handleListProjects(client: PlatformApiClient): Promise<string>;
+export declare function handleGetProject(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    includeInfrastructureStatus?: boolean;
+}): Promise<string>;
+export declare function handleCreateProject(client: PlatformApiClient, args: {
+    name: string;
+    description?: string;
+    activatedModules?: string[];
+    ownerTenantId?: string;
+}): Promise<string>;
+export declare function handleUpdateProject(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    name: string;
+    description?: string;
+    activatedModules?: string[];
+}): Promise<string>;
+export declare function handleDeleteProject(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    wait?: boolean;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}, progress?: ProgressReporter): Promise<string>;

package/dist/declarations/cli/platform/tools/subscription.d.ts

@@ -0,0 +1,13 @@
+import type { PlatformApiClient } from "../client/platform-api.js";
+import { type ApitogoConfig } from "../config.js";
+export declare function handleGetSubscription(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+}): Promise<string>;
+export declare function handleSelectFreePlan(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+}): Promise<string>;
+export declare function handleCreateCheckoutSession(client: PlatformApiClient, config: ApitogoConfig, args: {
+    projectId?: string;
+    planSlug: string;
+    currency?: string;
+}): Promise<string>;

package/docs/cli/commands.md

@@ -4,17 +4,20 @@ description: APItoGo CLI command catalog by category.
 sidebar_icon: wrench
 ---
 
-Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). Platform commands delegate to
-`@lukoweb/apitogo-mcp` (`apitogo-apply`, `apitogo-status`, `apitogo-teardown`).
+Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). The CLI is the **source of
+truth** for init, config, apply, status, teardown, project create, and check. MCP tools spawn these
+same commands so agents and humans get identical behavior.
 
 ## Lifecycle (prefer these)
 
 | Command | Role |
 | ------- | ---- |
-| `init` | Scaffold portal locally (no platform calls) |
-| `config` / `make-config` | Write or update `apitogo.config.json` (interactive: backend, OpenAPI, pages, plans) |
+| `init` | Scaffold portal (create-apitogo + OpenAPI discovery + secrets) |
+| `config` / `make-config` | Write or update `apitogo.config.json` (interactive or flags) |
 | `dev` | Local preview server |
 | `build` | Production build (`--preview` to serve locally) |
+| `check` | Publish readiness (secrets, manifest, site validation) |
+| `project create` | Create a platform project (plan unselected) |
 | `apply` | Publish config to platform (apihub + portal) |
 | `status` | Account, project, and live readiness |
 | `teardown --yes` | Delete the linked platform project |
@@ -23,10 +26,10 @@ Commands are exposed by the **`apitogo`** binary (`@lukoweb/apitogo`). Platform
 
 | Command | Role |
 | ------- | ---- |
-| `init [dir]` | Create `package.json`, stubs, and initial `apitogo.config.json` |
-| `config` | Interactive on TTY: backend, OpenAPI, pages, plans (apply each immediately); flags for site/theme/auth |
+| `init [dir]` | Named folder; `--install` (default), `--overwrite`, `--json`, `--openapi-search` |
+| `config` | Interactive on TTY; flags: `--openapi`, `--page-*`, `--plan`, `--backend`, `--theme`, `--patch`, `--json` |
 
-`npm create @lukoweb/apitogo@latest` is an interactive alternative to `init` for new folders.
+`npm create @lukoweb/apitogo@latest` remains an interactive alternative for new folders.
 
 See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags.
 
@@ -42,6 +45,8 @@ See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags
 
 | Command | Role |
 | ------- | ---- |
+| `project create --name` | Create platform project only |
+| `check` | Dry-run publish readiness |
 | `apply` | Full publish — project, plans, apihub, portal backend/frontend |
 | `apply --only <resource>` | Limit to `apihub`, `portal-backend`, or `portal-frontend` |
 | `apply --force` | Redeploy selected resources even when healthy |
@@ -50,7 +55,7 @@ See [Make config (CLI)](../configuration/make-config.mdx) for all `config` flags
 | `status` | Whoami + project + live verification |
 | `teardown --yes` | Delete platform project (confirmation required) |
 
-Env: `APITOGO_API_KEY_ID`, `APITOGO_API_SECRET`. Optional: `APITOGO_API_URL`, `APITOGO_MCP_PATH`.
+Env: `APITOGO_API_KEY_ID`, `APITOGO_API_SECRET`. Optional: `APITOGO_API_URL`.
 
 ## Hand-edit exceptions
 
@@ -77,4 +82,4 @@ These print a redirect message — use the replacement:
 - [Overview](./overview.md)
 - [Shape](./shape.md)
 - [Go live](./go-live.md)
-- [MCP tools](../mcp/tools.md) — agent tool catalog
+- [MCP tools](../mcp/tools.md) — agent tool catalog (spawn the CLI)

package/docs/cli/go-live.md

@@ -6,8 +6,8 @@ sidebar_icon: rocket
 ---
 
 **Go live** publishes your shaped portal to APItoGo hosting, optionally deploys the backend, upserts
-gateway plans, and verifies the live site. `apitogo apply` uses the same engine as MCP
-`publish_dev_portal`.
+gateway plans, and verifies the live site. `apitogo apply` is the source of truth; MCP
+`publish_dev_portal` spawns the same CLI.
 
 ## Before you publish
 

package/docs/cli/setup.md

@@ -85,7 +85,7 @@ Optional:
 | Variable           | Purpose                                              |
 | ------------------ | ---------------------------------------------------- |
 | `APITOGO_API_URL`  | Override platform API base URL                       |
-| `APITOGO_MCP_PATH` | Local `@lukoweb/apitogo-mcp` checkout for apply/status/teardown |
+| `APITOGO_CLI_PATH` | Local `@lukoweb/apitogo` / doc-tool checkout for MCP spawn |
 
 Never commit secrets. Site auth secrets (OIDC, Stripe) belong in the portal **`.env`** as
 `APITOGO_CONFIG_AUTHENTICATION__*` — see [Go live](./go-live.md).

package/docs/guides/environment-variables.md

@@ -87,6 +87,6 @@ interface ImportMeta {
 | -------- | ------- |
 | `APITOGO_API_KEY_ID` / `APITOGO_API_SECRET` | Required for MCP and CLI apply/status/teardown |
 | `APITOGO_DOC_TOOL_PATH` | Optional local doc-tool for scaffold |
-| `APITOGO_MCP_PATH` | Optional local MCP checkout for CLI apply/status/teardown |
+| `APITOGO_CLI_PATH` | Optional local `@lukoweb/apitogo` / doc-tool checkout for MCP spawn |
 
 See [MCP overview](../mcp/overview.md) and [CLI overview](../cli/overview.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lukoweb/apitogo",
-  "version": "0.1.85",
+  "version": "0.1.87",
   "type": "module",
   "sideEffects": [
     "**/*.css",
@@ -161,6 +161,10 @@
     "./config-loader": {
       "types": "./dist/declarations/config/apitogo-config-loader.d.ts",
       "default": "./src/config/apitogo-config-loader.ts"
+    },
+    "./apply": {
+      "types": "./dist/declarations/cli/platform/apply/index.d.ts",
+      "default": "./src/cli/platform/apply/index.ts"
     }
   },
   "scripts": {
@@ -175,6 +179,7 @@
   },
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "15.3.1",
+    "@apidevtools/swagger-parser": "^12.1.0",
     "@envelop/core": "5.5.1",
     "@graphql-typed-document-node/core": "3.2.0",
     "@hono/node-server": "1.19.11",
@@ -223,6 +228,7 @@
     "@zudoku/httpsnippet": "10.0.9",
     "@zudoku/react-helmet-async": "2.0.5",
     "@zuplo/mcp": "0.0.32",
+    "archiver": "^8.0.0",
     "bs58": "6.0.0",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
@@ -244,6 +250,7 @@
     "hast-util-to-string": "3.0.1",
     "hono": "4.12.5",
     "http-terminator": "3.2.0",
+    "ignore": "^7.0.5",
     "javascript-stringify": "2.1.0",
     "json-schema-to-typescript-lite": "15.0.0",
     "loglevel": "1.9.2",
@@ -280,9 +287,9 @@
     "shiki": "3.23.0",
     "sitemap": "9.0.1",
     "strip-ansi": "7.2.0",
-    "tar": "7.5.10",
     "tailwind-merge": "3.5.0",
     "tailwindcss": "4.2.1",
+    "tar": "7.5.10",
     "tw-animate-css": "1.4.0",
     "unified": "11.0.5",
     "unist-util-visit": "5.1.0",
@@ -302,6 +309,7 @@
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.2",
     "@testing-library/user-event": "14.6.1",
+    "@types/archiver": "^8.0.0",
     "@types/estree": "1.0.8",
     "@types/glob-parent": "5.1.3",
     "@types/hast": "3.0.4",
@@ -483,6 +491,10 @@
       "./config-loader": {
         "types": "./dist/declarations/config/apitogo-config-loader.d.ts",
         "default": "./src/config/apitogo-config-loader.ts"
+      },
+      "./apply": {
+        "types": "./dist/declarations/cli/platform/apply/index.d.ts",
+        "default": "./src/cli/platform/apply/index.ts"
       }
     },
     "access": "public"