sporades 0.1.0

package/dist/capsule-services.d.ts

@@ -0,0 +1,94 @@
+export type JsonRecord = Record<string, unknown>;
+export type DatabaseEngine = "libsql" | "postgres";
+export type StorageEngine = "minio";
+export type CapsuleServiceKind = "database" | "storage";
+export type CapsuleServiceCredentials = {
+    databaseUser: string;
+    databasePassword: string;
+    storageAccessKey: string;
+    storageSecretKey: string;
+};
+export type CapsuleServiceOptions = {
+    credentials?: Partial<CapsuleServiceCredentials>;
+    publishPorts?: boolean;
+};
+export type DatabaseServiceDeclaration = {
+    kind: "database";
+    engine: DatabaseEngine;
+};
+export type StorageServiceDeclaration = {
+    kind: "storage";
+    engine: StorageEngine;
+};
+export type CapsuleServicesDeclaration = JsonRecord & {
+    database?: DatabaseServiceDeclaration;
+    storage?: StorageServiceDeclaration;
+};
+export type CapsuleProjectConfig = JsonRecord & {
+    name?: unknown;
+    services?: CapsuleServicesDeclaration;
+};
+export type CapsuleServiceBase = {
+    kind: CapsuleServiceKind;
+    name: string;
+    engine: string;
+    image: string;
+    stateDir: string;
+    targetPort: number;
+    volumeTarget: string;
+    environment: Record<string, string>;
+    healthcheck: string[];
+    command: string | null;
+    labels: Record<string, string>;
+};
+export type CapsuleDatabaseService = CapsuleServiceBase & {
+    kind: "database";
+    engine: DatabaseEngine;
+    user: string;
+    password: string;
+    databaseName: string;
+};
+export type CapsuleStorageService = CapsuleServiceBase & {
+    kind: "storage";
+    engine: StorageEngine;
+    accessKey: string;
+    secretKey: string;
+    bucket: string;
+    region: string;
+    namespace: string;
+};
+export type CapsuleService = CapsuleDatabaseService | CapsuleStorageService;
+export type CapsuleServices = {
+    database?: CapsuleDatabaseService;
+    storage?: CapsuleStorageService;
+};
+export type CapsuleServicesComposeModel = {
+    projectSlug: string;
+    composeProjectName: string;
+    publishPorts: boolean;
+    credentials: CapsuleServiceCredentials;
+    services: CapsuleServices;
+    networks: {
+        services: string;
+    };
+    labels: Record<string, string>;
+};
+export type DatabaseEngineModel = {
+    engine: DatabaseEngine;
+    image: string;
+    targetPort: number;
+    volumeTarget: string;
+    environment: Record<string, string>;
+    healthcheck: string[];
+};
+export type WrittenCapsuleServicesCompose = CapsuleServicesComposeModel & {
+    path: string;
+    relativePath: string;
+};
+export declare const CAPSULE_SERVICES_COMPOSE_FILE: string;
+export declare const CAPSULE_SERVICES_STATE_DIR: string;
+export declare const CAPSULE_SERVICES_CREDENTIALS_FILE: string;
+export declare function validateCapsuleServicesConfig(services: unknown): CapsuleServicesDeclaration | null;
+export declare function writeCapsuleServicesCompose(projectDir: string, config: CapsuleProjectConfig, options?: CapsuleServiceOptions): Promise<WrittenCapsuleServicesCompose | null>;
+export declare function capsuleServicesComposeModel(config: CapsuleProjectConfig, projectDir?: string, options?: CapsuleServiceOptions): CapsuleServicesComposeModel;
+//# sourceMappingURL=capsule-services.d.ts.map

package/dist/capsule-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule-services.d.ts","sourceRoot":"","sources":["../src/capsule-services.ts"],"names":[],"mappings":"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"}

package/dist/capsule-services.js

@@ -0,0 +1,310 @@
+import { randomBytes } from "node:crypto";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+const SUPPORTED_SERVICE_KEYS = new Set(["database", "storage"]);
+const SUPPORTED_DATABASE_ENGINES = new Set(["libsql", "postgres"]);
+const SUPPORTED_STORAGE_ENGINES = new Set(["minio"]);
+const LIBSQL_IMAGE = "ghcr.io/tursodatabase/libsql-server:v0.24.32";
+const POSTGRES_IMAGE = "postgres:16-alpine";
+const POSTGRES_USER = "sporades";
+const POSTGRES_DATABASE = "sporades";
+const MINIO_IMAGE = "quay.io/minio/minio:RELEASE.2025-04-22T22-12-26Z";
+const MINIO_ROOT_USER = "sporades";
+const MINIO_BUCKET = "sporades-files";
+const MINIO_REGION = "us-east-1";
+export const CAPSULE_SERVICES_COMPOSE_FILE = path.join(".sporades", "compose", "capsule-services.compose.yml");
+export const CAPSULE_SERVICES_STATE_DIR = path.join(".sporades", "services");
+export const CAPSULE_SERVICES_CREDENTIALS_FILE = path.join(".sporades", "services", "credentials.json");
+export function validateCapsuleServicesConfig(services) {
+    if (services === undefined) {
+        return null;
+    }
+    if (!isRecord(services)) {
+        throw commandError("Invalid Capsule services declaration.", "Set `services` in sporades.json to an object.");
+    }
+    for (const key of Object.keys(services)) {
+        if (!SUPPORTED_SERVICE_KEYS.has(key)) {
+            throw commandError(`Unsupported Capsule service: ${key}`, "Use supported Capsule service declarations: `services.database` or `services.storage`.");
+        }
+    }
+    if (services.database !== undefined) {
+        validateDatabaseServiceConfig(services.database);
+    }
+    if (services.storage !== undefined) {
+        validateStorageServiceConfig(services.storage);
+    }
+    return services;
+}
+export async function writeCapsuleServicesCompose(projectDir, config, options = {}) {
+    const composePath = path.join(projectDir, CAPSULE_SERVICES_COMPOSE_FILE);
+    if (!hasDeclaredCapsuleServices(config)) {
+        await rm(composePath, { force: true });
+        return null;
+    }
+    validateCapsuleServicesConfig(config.services);
+    await mkdir(path.dirname(composePath), { recursive: true });
+    const credentials = await loadOrCreateCapsuleServiceCredentials(projectDir);
+    const model = capsuleServicesComposeModel(config, projectDir, {
+        credentials,
+        publishPorts: options.publishPorts === true,
+    });
+    await Promise.all(Object.values(model.services).map((service) => mkdir(service.stateDir, { recursive: true })));
+    const source = renderCapsuleServicesCompose(model);
+    await writeFile(composePath, source);
+    return {
+        path: composePath,
+        relativePath: CAPSULE_SERVICES_COMPOSE_FILE,
+        ...model,
+    };
+}
+async function loadOrCreateCapsuleServiceCredentials(projectDir) {
+    const credentialsPath = path.join(projectDir, CAPSULE_SERVICES_CREDENTIALS_FILE);
+    let existing = {};
+    try {
+        const parsed = JSON.parse(await readFile(credentialsPath, "utf8"));
+        if (isRecord(parsed)) {
+            existing = parsed;
+        }
+    }
+    catch {
+        // Missing or unreadable credentials are regenerated below.
+    }
+    const credentials = {
+        databaseUser: typeof existing.databaseUser === "string" && existing.databaseUser ? existing.databaseUser : POSTGRES_USER,
+        databasePassword: typeof existing.databasePassword === "string" && existing.databasePassword
+            ? existing.databasePassword
+            : randomBytes(24).toString("base64url"),
+        storageAccessKey: typeof existing.storageAccessKey === "string" && existing.storageAccessKey ? existing.storageAccessKey : MINIO_ROOT_USER,
+        storageSecretKey: typeof existing.storageSecretKey === "string" && existing.storageSecretKey
+            ? existing.storageSecretKey
+            : randomBytes(24).toString("base64url"),
+    };
+    if (credentials.databaseUser !== existing.databaseUser ||
+        credentials.databasePassword !== existing.databasePassword ||
+        credentials.storageAccessKey !== existing.storageAccessKey ||
+        credentials.storageSecretKey !== existing.storageSecretKey) {
+        await mkdir(path.dirname(credentialsPath), { recursive: true });
+        await writeFile(credentialsPath, `${JSON.stringify(credentials, null, 2)}\n`, { mode: 0o600 });
+    }
+    return credentials;
+}
+export function capsuleServicesComposeModel(config, projectDir = process.cwd(), options = {}) {
+    const credentials = options.credentials ?? {};
+    const databaseUser = credentials.databaseUser ?? POSTGRES_USER;
+    const databasePassword = credentials.databasePassword ?? "";
+    const storageAccessKey = credentials.storageAccessKey ?? MINIO_ROOT_USER;
+    const storageSecretKey = credentials.storageSecretKey ?? "";
+    const projectSlug = slugify(config.name ?? "capsule");
+    const networkName = `sporades-${projectSlug}-services`;
+    const services = {};
+    const database = config.services?.database;
+    const storage = config.services?.storage;
+    const labels = {
+        "com.sporades.managed": "true",
+        "com.sporades.runtime-state": "true",
+        "com.sporades.project": projectSlug,
+    };
+    if (database) {
+        const engine = database.engine ?? "libsql";
+        const engineModel = engine === "postgres"
+            ? {
+                engine,
+                image: POSTGRES_IMAGE,
+                targetPort: 5432,
+                volumeTarget: "/var/lib/postgresql/data",
+                environment: {
+                    POSTGRES_USER: databaseUser,
+                    POSTGRES_PASSWORD: databasePassword,
+                    POSTGRES_DB: POSTGRES_DATABASE,
+                },
+                healthcheck: ["CMD", "pg_isready", "-U", databaseUser, "-d", POSTGRES_DATABASE],
+            }
+            : {
+                engine: "libsql",
+                image: LIBSQL_IMAGE,
+                targetPort: 8080,
+                volumeTarget: "/var/lib/sqld",
+                environment: {},
+                healthcheck: ["CMD", "/bin/bash", "-c", "exec 3<>/dev/tcp/127.0.0.1/8080"],
+            };
+        services.database = {
+            kind: "database",
+            name: `sporades-${projectSlug}-database`,
+            engine: engineModel.engine,
+            image: engineModel.image,
+            stateDir: path.join(projectDir, CAPSULE_SERVICES_STATE_DIR, "database"),
+            targetPort: engineModel.targetPort,
+            volumeTarget: engineModel.volumeTarget,
+            environment: engineModel.environment,
+            healthcheck: engineModel.healthcheck,
+            command: null,
+            labels: serviceLabels(labels, "database", engineModel.engine),
+            user: databaseUser,
+            password: databasePassword,
+            databaseName: POSTGRES_DATABASE,
+        };
+    }
+    if (storage) {
+        services.storage = {
+            kind: "storage",
+            name: `sporades-${projectSlug}-storage`,
+            engine: "minio",
+            image: MINIO_IMAGE,
+            stateDir: path.join(projectDir, CAPSULE_SERVICES_STATE_DIR, "storage"),
+            targetPort: 9000,
+            volumeTarget: "/data",
+            environment: {
+                MINIO_ROOT_USER: storageAccessKey,
+                MINIO_ROOT_PASSWORD: storageSecretKey,
+            },
+            healthcheck: ["CMD", "curl", "-fsS", "http://127.0.0.1:9000/minio/health/ready"],
+            command: 'server /data --console-address ":9001"',
+            labels: serviceLabels(labels, "storage", "minio"),
+            accessKey: storageAccessKey,
+            secretKey: storageSecretKey,
+            bucket: MINIO_BUCKET,
+            region: MINIO_REGION,
+            namespace: projectSlug,
+        };
+    }
+    const model = {
+        projectSlug,
+        composeProjectName: `sporades-${projectSlug}-services`,
+        publishPorts: options.publishPorts === true,
+        credentials: {
+            databaseUser,
+            databasePassword,
+            storageAccessKey,
+            storageSecretKey,
+        },
+        services,
+        networks: {
+            services: networkName,
+        },
+        labels,
+    };
+    return model;
+}
+function validateDatabaseServiceConfig(database) {
+    if (!isRecord(database)) {
+        throw commandError("Invalid database Capsule service declaration.", "Set `services.database` to `{ \"kind\": \"database\", \"engine\": \"libsql\" }` or `{ \"kind\": \"database\", \"engine\": \"postgres\" }`.");
+    }
+    if (database.kind !== "database") {
+        throw commandError("Unsupported database Capsule service kind.", "Use `services.database.kind` of `database`.");
+    }
+    if (typeof database.engine !== "string" || !SUPPORTED_DATABASE_ENGINES.has(database.engine)) {
+        throw commandError(`Unsupported database Capsule service engine: ${database.engine ?? "missing"}`, "Use `services.database.engine` of `libsql` or `postgres`.");
+    }
+}
+function validateStorageServiceConfig(storage) {
+    if (!isRecord(storage)) {
+        throw commandError("Invalid storage Capsule service declaration.", "Set `services.storage` to `{ \"kind\": \"storage\", \"engine\": \"minio\" }`.");
+    }
+    if (storage.kind !== "storage") {
+        throw commandError("Unsupported storage Capsule service kind.", "Use `services.storage.kind` of `storage`.");
+    }
+    if (typeof storage.engine !== "string" || !SUPPORTED_STORAGE_ENGINES.has(storage.engine)) {
+        throw commandError(`Unsupported storage Capsule service engine: ${storage.engine ?? "missing"}`, "Use `services.storage.engine` of `minio`.");
+    }
+}
+function renderCapsuleServicesCompose(model) {
+    const services = Object.values(model.services)
+        .map((service) => renderServiceCompose(service, model))
+        .join("\n");
+    return `# Sporades-owned runtime state. Do not edit by hand.
+# Generated from sporades.json Capsule service declarations.
+name: ${model.composeProjectName}
+
+services:
+${services}
+
+networks:
+  ${model.networks.services}:
+    name: ${model.networks.services}
+    labels:
+${renderLabels(model.labels, 6)}
+`;
+}
+function renderServiceCompose(service, model) {
+    // Ports are published (loopback-only) solely for local dev sessions, where the
+    // Capsule runs as a host process. Container sessions reach services by name on
+    // the project network; publishing a port would also open it to containers on
+    // other Docker networks.
+    const ports = model.publishPorts
+        ? `    ports:
+      - "127.0.0.1::${service.targetPort}"
+`
+        : "";
+    return `  ${service.name}:
+    image: ${service.image}
+    container_name: ${service.name}
+    labels:
+${renderLabels(service.labels, 6)}
+${renderEnvironment(service.environment, 4)}${renderCommand(service.command, 4)}${renderHealthcheck(service.healthcheck, 4)}
+    networks:
+      - ${model.networks.services}
+${ports}    volumes:
+      - ${JSON.stringify(`${service.stateDir}:${service.volumeTarget}:rw`)}
+`;
+}
+function renderHealthcheck(healthcheck, indent) {
+    if (!healthcheck) {
+        return "";
+    }
+    const padding = " ".repeat(indent);
+    return `${padding}healthcheck:
+${padding}  test: ${JSON.stringify(healthcheck)}
+${padding}  interval: 5s
+${padding}  timeout: 3s
+${padding}  retries: 3
+${padding}  start_period: 60s
+${padding}  start_interval: 1s
+`;
+}
+function renderCommand(command, indent) {
+    if (!command) {
+        return "";
+    }
+    const padding = " ".repeat(indent);
+    return `${padding}command: ${JSON.stringify(command)}\n`;
+}
+function renderEnvironment(environment, indent) {
+    const entries = Object.entries(environment ?? {});
+    if (entries.length === 0) {
+        return "";
+    }
+    const padding = " ".repeat(indent);
+    return `${padding}environment:\n${entries.map(([key, value]) => `${padding}  ${key}: ${JSON.stringify(value)}`).join("\n")}\n`;
+}
+function renderLabels(labels, indent) {
+    const padding = " ".repeat(indent);
+    return Object.entries(labels)
+        .map(([key, value]) => `${padding}${key}: ${JSON.stringify(value)}`)
+        .join("\n");
+}
+function slugify(value) {
+    const slug = String(value)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "capsule";
+}
+function hasDeclaredCapsuleServices(config) {
+    return Boolean(config.services?.database || config.services?.storage);
+}
+function serviceLabels(labels, kind, engine) {
+    return {
+        ...labels,
+        "com.sporades.capsule-service.kind": kind,
+        "com.sporades.capsule-service.engine": engine,
+    };
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function commandError(message, hint) {
+    const error = new Error(message);
+    error.hint = hint;
+    return error;
+}
+//# sourceMappingURL=capsule-services.js.map

package/dist/capsule-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsule-services.js","sourceRoot":"","sources":["../src/capsule-services.ts"],"names":[],"mappings":"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"}

package/dist/cli/cli-help.d.ts

@@ -0,0 +1,16 @@
+declare const HELP_TEXT: {
+    readonly create: "Usage: sporades create <name> [options]\n\nScaffold a new Capsule.\n\nOptions:\n  --framework <name>  Client framework: react or preact\n  --template <name>   Template: blank, todo, guestbook, or photo-library\n  --no-install        Skip npm install\n  --no-git            Skip git initialization\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly dev: "Usage: sporades dev [status|stop|reset] [options]\n\nStart and manage a local Dev session.\n\nCommands:\n  dev                 Start a Dev session\n  dev status          Print Dev session status\n  dev stop            Stop the running Dev session\n  dev reset           Stop the Dev session and remove local Dev state\n\nOptions:\n  --port <number>     Dev session port when starting\n  --public            Allow non-localhost access when starting\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly auth: "Usage: sporades auth <command> [options]\n\nManage local auth configuration and identity simulation.\n\nCommands:\n  status              Print auth provider status\n  clients             List connected Dev session clients\n  set google          Configure Google OAuth credentials\n  as email            Simulate a local email identity\n\nOptions:\n  --client-id <id>        Google OAuth client ID\n  --client-secret <secret> Google OAuth client secret\n  --client-json <path>    Read Google OAuth credentials JSON\n  --email <address>       Simulated email identity\n  --display-name <name>   Simulated display name\n  --picture <url>         Simulated profile picture URL\n  --port <number>         Target Dev session port\n  --client <target>       Delivery target: current, all, or a client ID\n  --json                  Write JSON output\n  --help, -h              Show this help\n";
+    readonly security: "Usage: sporades security [options]\n\nInspect effective Capsule security policy.\n\nOptions:\n  --session <name>    Session: dev, public-dev, container, or hosted\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly env: "Usage: sporades env <command> [options]\n\nManage Sealed Server env.\n\nCommands:\n  init                Create local Sealed Server env key material\n  import              Import Server env values from a file\n  status              Print Sealed Server env status\n  export              Export Sealed Server env for a Host profile\n  reencrypt           Re-encrypt local Sealed Server env material\n\nOptions:\n  --file <path>       Input file for import or export\n  --host <alias>      Host profile alias\n  --subname <name>    Hosted Capsule subname\n  --output <path>     Export output path\n  --sealed            Treat input as an already sealed export\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly deploy: "Usage: sporades deploy [status|stop|restart|remove|reset] [options]\n\nStart and manage a local Container session.\n\nCommands:\n  deploy              Start a local Container session\n  deploy status       Print Container session status\n  deploy stop         Stop the running Container session\n  deploy restart      Restart the running Container session\n  deploy remove       Remove the Container session\n  deploy reset        Remove the Container session and local container state\n\nOptions:\n  --port <number>     Published local port when starting\n  --force             Replace stale or conflicting container state when starting\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly host: "Usage: sporades host <command> [options]\n\nManage Host profiles and Hosted Capsules.\n\nProfile commands:\n  add <alias>         Add a Host profile\n  use <alias>         Set the default Host profile\n  current             Print the selected Host profile\n  bootstrap           Provision the remote Host server\n  health [subname]    Check Host server or Hosted Capsule health\n\nCapsule commands:\n  bind <subname>      Bind this project to a Hosted Capsule\n  register <subname>  Register a Hosted Capsule\n  push                Push and install a Hosted Capsule release\n  start <subname>     Start a Hosted Capsule\n  stop <subname>      Stop a Hosted Capsule\n  restart <subname>   Restart a Hosted Capsule\n  stats [subname]     Print Host server or Hosted Capsule stats\n  logs [source]       Print Hosted Capsule logs\n  releases <subname>  List Hosted Capsule releases\n  rollback <subname> <release-id>\n                      Roll back to a previous release\n  rotate-key <subname>\n                      Rotate Hosted Capsule Sealed Server env keys\n  unregister <subname>\n                      Unregister a Hosted Capsule\n  delete <subname>    Delete Hosted Capsule storage\n\nOther commands:\n  list                List Hosted Capsules\n  github workflow write\n                      Write a GitHub Actions deploy workflow\n  invoke <action>     Invoke a low-level remote Host helper action\n\nOptions:\n  --host <alias>      Host profile alias\n  --server <target>   SSH target for host add\n  --domain <domain>   Hosted domain for host add\n  --remote-root <path>\n                      Remote root path for host add\n  --tls <mode>        TLS mode: automatic or cloudflare-origin\n  --subname <name>    Hosted Capsule subname\n  --lines <n>, -n <n> Log line count\n  --restart           Restart after host push\n  --verify            Verify release health after host push\n  --fallback-to-previous-release\n                      Roll back when verified push fails\n  --branch <name>     GitHub workflow branch\n  --file <path>       GitHub workflow output path\n  --dry-run           Print workflow without writing it\n  --force             Overwrite workflow output when writing it\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly logs: "Usage: sporades logs [tail] [options]\n\nPrint Dev session logs.\n\nCommands:\n  logs                Print recent Dev session logs\n  logs tail           Follow Dev session logs\n\nOptions:\n  --port <number>     Target Dev session or local Container port\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly db: "Usage: sporades db <command> [options]\n\nInspect the Dev session database.\n\nCommands:\n  list                List database tables\n  dump                Dump database contents\n  query <sql>         Run a read-only SQL query\n\nOptions:\n  --port <number>     Target Dev session or local Container port\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+    readonly default: "Usage: sporades <command> [options]\n    \n    Commands:\n      create <name>  Scaffold a new Capsule\n      dev            Start a local Dev session\n      auth           Manage local auth configuration and simulation\n      security       Inspect effective Capsule security policy\n      env            Manage Sealed Server env\n      deploy         Start a local Container session\n      host           Manage Host profiles and Hosted Capsules\n      logs           Print Dev session logs\n      db             Inspect the Dev session database\n    \n    Options:\n      --help, -h     Show help for command\n      --json         Write JSON output when supported by the command\n    ";
+};
+export type CliHelpCommand = keyof Omit<typeof HELP_TEXT, "default">;
+export declare function renderCliHelp(command?: string): "Usage: sporades create <name> [options]\n\nScaffold a new Capsule.\n\nOptions:\n  --framework <name>  Client framework: react or preact\n  --template <name>   Template: blank, todo, guestbook, or photo-library\n  --no-install        Skip npm install\n  --no-git            Skip git initialization\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades dev [status|stop|reset] [options]\n\nStart and manage a local Dev session.\n\nCommands:\n  dev                 Start a Dev session\n  dev status          Print Dev session status\n  dev stop            Stop the running Dev session\n  dev reset           Stop the Dev session and remove local Dev state\n\nOptions:\n  --port <number>     Dev session port when starting\n  --public            Allow non-localhost access when starting\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades auth <command> [options]\n\nManage local auth configuration and identity simulation.\n\nCommands:\n  status              Print auth provider status\n  clients             List connected Dev session clients\n  set google          Configure Google OAuth credentials\n  as email            Simulate a local email identity\n\nOptions:\n  --client-id <id>        Google OAuth client ID\n  --client-secret <secret> Google OAuth client secret\n  --client-json <path>    Read Google OAuth credentials JSON\n  --email <address>       Simulated email identity\n  --display-name <name>   Simulated display name\n  --picture <url>         Simulated profile picture URL\n  --port <number>         Target Dev session port\n  --client <target>       Delivery target: current, all, or a client ID\n  --json                  Write JSON output\n  --help, -h              Show this help\n" | "Usage: sporades security [options]\n\nInspect effective Capsule security policy.\n\nOptions:\n  --session <name>    Session: dev, public-dev, container, or hosted\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades env <command> [options]\n\nManage Sealed Server env.\n\nCommands:\n  init                Create local Sealed Server env key material\n  import              Import Server env values from a file\n  status              Print Sealed Server env status\n  export              Export Sealed Server env for a Host profile\n  reencrypt           Re-encrypt local Sealed Server env material\n\nOptions:\n  --file <path>       Input file for import or export\n  --host <alias>      Host profile alias\n  --subname <name>    Hosted Capsule subname\n  --output <path>     Export output path\n  --sealed            Treat input as an already sealed export\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades deploy [status|stop|restart|remove|reset] [options]\n\nStart and manage a local Container session.\n\nCommands:\n  deploy              Start a local Container session\n  deploy status       Print Container session status\n  deploy stop         Stop the running Container session\n  deploy restart      Restart the running Container session\n  deploy remove       Remove the Container session\n  deploy reset        Remove the Container session and local container state\n\nOptions:\n  --port <number>     Published local port when starting\n  --force             Replace stale or conflicting container state when starting\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades host <command> [options]\n\nManage Host profiles and Hosted Capsules.\n\nProfile commands:\n  add <alias>         Add a Host profile\n  use <alias>         Set the default Host profile\n  current             Print the selected Host profile\n  bootstrap           Provision the remote Host server\n  health [subname]    Check Host server or Hosted Capsule health\n\nCapsule commands:\n  bind <subname>      Bind this project to a Hosted Capsule\n  register <subname>  Register a Hosted Capsule\n  push                Push and install a Hosted Capsule release\n  start <subname>     Start a Hosted Capsule\n  stop <subname>      Stop a Hosted Capsule\n  restart <subname>   Restart a Hosted Capsule\n  stats [subname]     Print Host server or Hosted Capsule stats\n  logs [source]       Print Hosted Capsule logs\n  releases <subname>  List Hosted Capsule releases\n  rollback <subname> <release-id>\n                      Roll back to a previous release\n  rotate-key <subname>\n                      Rotate Hosted Capsule Sealed Server env keys\n  unregister <subname>\n                      Unregister a Hosted Capsule\n  delete <subname>    Delete Hosted Capsule storage\n\nOther commands:\n  list                List Hosted Capsules\n  github workflow write\n                      Write a GitHub Actions deploy workflow\n  invoke <action>     Invoke a low-level remote Host helper action\n\nOptions:\n  --host <alias>      Host profile alias\n  --server <target>   SSH target for host add\n  --domain <domain>   Hosted domain for host add\n  --remote-root <path>\n                      Remote root path for host add\n  --tls <mode>        TLS mode: automatic or cloudflare-origin\n  --subname <name>    Hosted Capsule subname\n  --lines <n>, -n <n> Log line count\n  --restart           Restart after host push\n  --verify            Verify release health after host push\n  --fallback-to-previous-release\n                      Roll back when verified push fails\n  --branch <name>     GitHub workflow branch\n  --file <path>       GitHub workflow output path\n  --dry-run           Print workflow without writing it\n  --force             Overwrite workflow output when writing it\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades logs [tail] [options]\n\nPrint Dev session logs.\n\nCommands:\n  logs                Print recent Dev session logs\n  logs tail           Follow Dev session logs\n\nOptions:\n  --port <number>     Target Dev session or local Container port\n  --json              Write JSON output\n  --help, -h          Show this help\n" | "Usage: sporades db <command> [options]\n\nInspect the Dev session database.\n\nCommands:\n  list                List database tables\n  dump                Dump database contents\n  query <sql>         Run a read-only SQL query\n\nOptions:\n  --port <number>     Target Dev session or local Container port\n  --json              Write JSON output\n  --help, -h          Show this help\n";
+export {};
+//# sourceMappingURL=cli-help.d.ts.map

package/dist/cli/cli-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../../src/cli/cli-help.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,SAAS;;;;;;;;;;;CAqML,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,OAAO,SAAS,EAAE,SAAS,CAAC,CAAC;AAErE,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,04MAE7C"}