@miosa/cli 1.1.16 → 1.1.19

package/README.md

@@ -296,7 +296,30 @@ $ miosa deploy --docker-deploy
     miosa deploy env set KEY=VALUE             — set env var
 ```
 
+For CI, agents, and scripts, use JSON mode.
+JSON mode and non-TTY stdin never open interactive prompts.
+Framework detection supplies build and run commands when it recognizes the project.
+Unknown project shapes fail before the API and require both command flags instead of guessing.
+Static sites use `--static`, which omits build and run commands completely.
+
+```bash
+miosa --organization acme deploy --docker-deploy --json
+
+miosa --organization acme deploy --docker-deploy --json --yes \
+  --name my-project \
+  --branch main \
+  --build-command "npm run build" \
+  --run-command "npm start"
+
+miosa --organization acme deploy --docker-deploy --static --json --yes \
+  --name callix-security-report \
+  --branch master
+```
+
+The JSON result is one document containing the deployment identity, queued build, App Engine host, public URL when known, and one-time webhook details for a new deployment.
+
 On subsequent runs from the same directory, `miosa deploy` reads `.miosa.json` and skips all prompts — just queues a rebuild and streams logs.
+The creation flags (`--name`, `--branch`, `--build-command`, `--run-command`, `--static`) only apply to the first deploy; passing them when `.miosa.json` exists is an error, so automation never silently deploys a configuration other than the one it asked for.
 
 ```bash
 # Trigger a rebuild any time
@@ -626,6 +649,9 @@ Deploy a GitHub repo. See the [Deploy section](#deploy--60-seconds-to-first-depl
 
 ```bash
 miosa deploy --docker-deploy             # Recommended production deploy
+miosa deploy --docker-deploy --json      # Prompt-free CI or agent deploy
+miosa deploy --docker-deploy --static --name report --branch main --yes --json
+miosa deploy --name app --branch main --build-command "npm run build" --run-command "npm start" --yes --json
 miosa deploy                             # First deploy or redeploy from .miosa.json
 miosa deploy list [--json]               # List all deployments
 miosa deploy logs [id]                   # Tail live build logs

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAimBzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+0B/C"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0oBzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAy/B/C"}

package/dist/commands/deploy.js

@@ -6,7 +6,7 @@ import { request } from "undici";
 import { loadConfig } from "../config.js";
 import { MiosaClient, parseSse } from "../client.js";
 import { ENV_FILE_OPTION_HELP, ENV_INLINE_SHELL_WARNING, ENV_STDIN_OPTION_HELP, resolveEnvInputs, } from "./env-input.js";
-import { handleError, isJsonMode } from "./util.js";
+import { errorExitCode, handleError, isJsonMode, jsonErrorPayload, } from "./util.js";
 import { spin } from "../ui/spinner.js";
 import { renderTable } from "../ui/table.js";
 import { errorEnvelope, hintBlock, icon, kvPanel, printBanner, printElapsed, formatDuration, } from "../ui/render.js";
@@ -153,7 +153,11 @@ async function probePublicUrl(publicUrl, probePath, timeoutMs) {
             signal: controller.signal,
         });
         res.body.resume();
-        return { ok: res.statusCode >= 200 && res.statusCode < 500, status: res.statusCode, url: url.toString() };
+        return {
+            ok: res.statusCode >= 200 && res.statusCode < 500,
+            status: res.statusCode,
+            url: url.toString(),
+        };
     }
     catch (error) {
         return {
@@ -174,7 +178,10 @@ async function proveDeployment(client, deploymentId, opts) {
     addProofCheck(checks, "deployment_row", true, `Deployment ${deployment.id} exists with state=${deployment.state}.`, { state: deployment.state });
     addProofCheck(checks, "deployment_running", deployment.state === "running", deployment.state === "running"
         ? "Deployment is marked running."
-        : `Deployment state is ${deployment.state}, expected running.`, { state: deployment.state }, ["miosa deploy logs <deployment-id>", "miosa deploy redeploy <deployment-id>"]);
+        : `Deployment state is ${deployment.state}, expected running.`, { state: deployment.state }, [
+        "miosa deploy logs <deployment-id>",
+        "miosa deploy redeploy <deployment-id>",
+    ]);
     addProofCheck(checks, "public_url_present", Boolean(publicUrl), publicUrl ? `Public URL is ${publicUrl}.` : "Deployment has no public URL.", { public_url: publicUrl });
     if (product === "docker_deploy") {
         const app = dockerDeployApp(deployment);
@@ -183,20 +190,27 @@ async function proveDeployment(client, deploymentId, opts) {
             stringField(deployment.metadata, "docker_deploy_host_id") ??
             stringField(app, "docker_deploy_host_id") ??
             stringField(app, "host_id");
-        addProofCheck(checks, "docker_deploy_host_link", Boolean(hostId), hostId ? `Deployment links App Engine host ${hostId}.` : "Deployment has no App Engine host id.", { docker_deploy_host_id: hostId }, ["miosa docker-deploy ensure --wait --json"]);
+        addProofCheck(checks, "docker_deploy_host_link", Boolean(hostId), hostId
+            ? `Deployment links App Engine host ${hostId}.`
+            : "Deployment has no App Engine host id.", { docker_deploy_host_id: hostId }, ["miosa docker-deploy ensure --wait --json"]);
         if (hostId) {
             try {
                 const host = await client.apiGet(`/api/v1/docker-deploy/hosts/${encodeURIComponent(hostId)}`);
                 const hostRecord = asRecord(asRecord(host).host ?? asRecord(host).data ?? host);
                 const status = stringField(hostRecord, "status");
                 const applianceStatus = stringField(hostRecord, "appliance_status");
-                addProofCheck(checks, "docker_deploy_host_ready", status === "active" && applianceStatus === "healthy", `Host status=${status ?? "unknown"}, appliance=${applianceStatus ?? "unknown"}.`, { status, appliance_status: applianceStatus }, ["miosa docker-deploy show <host-id> --json", "miosa docker-deploy ensure --wait --json"]);
+                addProofCheck(checks, "docker_deploy_host_ready", status === "active" && applianceStatus === "healthy", `Host status=${status ?? "unknown"}, appliance=${applianceStatus ?? "unknown"}.`, { status, appliance_status: applianceStatus }, [
+                    "miosa docker-deploy show <host-id> --json",
+                    "miosa docker-deploy ensure --wait --json",
+                ]);
             }
             catch (error) {
                 addProofCheck(checks, "docker_deploy_host_ready", false, error instanceof Error ? error.message : String(error), { docker_deploy_host_id: hostId });
             }
         }
-        addProofCheck(checks, "docker_deploy_app_row", Boolean(app), app ? `App Engine app status=${stringField(app, "status") ?? "unknown"}.` : "App Engine app row is missing.", app
+        addProofCheck(checks, "docker_deploy_app_row", Boolean(app), app
+            ? `App Engine app status=${stringField(app, "status") ?? "unknown"}.`
+            : "App Engine app row is missing.", app
             ? {
                 status: stringField(app, "status"),
                 app_id: stringField(app, "app_id"),
@@ -219,7 +233,10 @@ async function proveDeployment(client, deploymentId, opts) {
         const probe = await probePublicUrl(publicUrl, opts.probePath, opts.timeoutMs);
         addProofCheck(checks, "public_url_probe", probe.ok, probe.ok
             ? `Public URL returned HTTP ${probe.status}.`
-            : `Public URL probe failed: ${probe.error ?? `HTTP ${probe.status}`}.`, probe, ["Check DNS/custom domain routing.", "Check app logs and container health."]);
+            : `Public URL probe failed: ${probe.error ?? `HTTP ${probe.status}`}.`, probe, [
+            "Check DNS/custom domain routing.",
+            "Check app logs and container health.",
+        ]);
     }
     const nextActions = checks
         .filter((check) => !check.ok)
@@ -420,16 +437,24 @@ function formatSeconds(value) {
         return formatMetricValue(value);
     return formatDuration(value * 1000);
 }
-// ── register ──────────────────────────────────────────────────────────────────
 export function register(program) {
     const deploy = program
         .command("deploy")
         .alias("launch")
         .description("Deploy a GitHub repo; use --docker-deploy for the recommended production runtime")
         .option("--docker-deploy", "Create the deployment on this workspace's dedicated App Engine runtime")
+        .option("--name <name>", "Deployment name (defaults to the directory name)")
+        .option("--branch <branch>", "Git branch to deploy (defaults to the current branch)")
+        .option("--build-command <cmd>", "Build command (defaults to framework detection)")
+        .option("--run-command <cmd>", "Run command (defaults to framework detection)")
+        .option("--static", "Deploy static files without build or run commands")
+        .option("-y, --yes", "Accept detected defaults and skip interactive confirmation")
         .addHelpText("after", `
 Examples:
   miosa deploy --docker-deploy       Recommended: deploy current directory to App Engine
+  miosa deploy --docker-deploy --json  Prompt-free deploy for CI and agents
+  miosa deploy --docker-deploy --static --name report --branch main --yes --json
+  miosa deploy --name app --branch main --build-command "npm run build" --run-command "npm start" --yes --json
   miosa deploy                       Deploy current directory (auto-detects framework)
   miosa deploy list                  List all deployments
   miosa deploy logs                  Tail build logs for this project
@@ -445,31 +470,49 @@ Examples:
             const cwd = process.cwd();
             const config = loadConfig();
             const client = new MiosaClient(config);
+            const json = isJsonMode(opts);
             // ── Check for existing .miosa.json first (skip git for redeploys) ──
             let projectCfg = loadProjectConfig(cwd);
             let deploymentId;
+            let queuedBuild = null;
+            let createdDeployment = null;
+            let webhookSecret = null;
+            let buildQueueError = null;
             if (projectCfg) {
                 // ── Re-deploy from existing .miosa.json ──────────────────────
-                console.log();
-                console.log(chalk.dim("  Found .miosa.json — redeploying existing deployment"));
-                console.log(`  ${chalk.bold("Project")}   ${projectCfg.name} (${projectCfg.framework})`);
-                console.log(`  ${chalk.bold("Branch")}    ${projectCfg.branch}`);
-                console.log();
+                const firstDeployOnlyFlags = [
+                    opts.name !== undefined ? "--name" : null,
+                    opts.branch !== undefined ? "--branch" : null,
+                    opts.buildCommand !== undefined ? "--build-command" : null,
+                    opts.runCommand !== undefined ? "--run-command" : null,
+                    opts.static ? "--static" : null,
+                ].filter((flag) => flag !== null);
+                if (firstDeployOnlyFlags.length > 0) {
+                    throw new UserError(`.miosa.json already exists; ${firstDeployOnlyFlags.join(", ")} only apply when creating a deployment.`, "Remove these flags to redeploy the saved configuration, or delete .miosa.json to create a new deployment.");
+                }
+                if (!json) {
+                    console.log();
+                    console.log(chalk.dim("  Found .miosa.json — redeploying existing deployment"));
+                    console.log(`  ${chalk.bold("Project")}   ${projectCfg.name} (${projectCfg.framework})`);
+                    console.log(`  ${chalk.bold("Branch")}    ${projectCfg.branch}`);
+                    console.log();
+                }
                 deploymentId = projectCfg.deploymentId;
-                const buildSpinner = spin("Queuing build...");
+                const buildSpinner = json ? null : spin("Queuing build...");
                 try {
-                    await client.redeployDeployment(deploymentId);
-                    buildSpinner.succeed("Build queued");
+                    queuedBuild = await client.redeployDeployment(deploymentId);
+                    buildSpinner?.succeed("Build queued");
                 }
                 catch (err) {
-                    buildSpinner.fail("Failed to queue build");
+                    buildSpinner?.fail("Failed to queue build");
                     handleError(err);
                 }
             }
             else {
                 // ── First deploy: verify git repo + remote, then detect ───────
                 const { repoUrl, currentBranch } = getGitInfo(cwd);
-                console.log();
+                if (!json)
+                    console.log();
                 const detection = detectFramework(cwd);
                 let framework = "unknown";
                 let buildCommand = "npm run build";
@@ -477,60 +520,105 @@ Examples:
                 if (detection) {
                     const label = FRAMEWORK_LABELS[detection.framework] ??
                         detection.framework;
-                    console.log(`  Detected: ${chalk.cyan(label)} (confidence ${detection.confidence}%)`);
+                    if (!json) {
+                        console.log(`  Detected: ${chalk.cyan(label)} (confidence ${detection.confidence}%)`);
+                    }
                     framework = detection.framework;
                     buildCommand = detection.buildCommand;
                     runCommand = detection.runCommand;
                 }
                 else {
-                    console.log(chalk.yellow("  Could not auto-detect framework. You can set build/run commands manually."));
+                    if (!json) {
+                        console.log(chalk.yellow("  Could not auto-detect framework. You can set build/run commands manually."));
+                    }
+                }
+                if (!json) {
+                    console.log(`  Repo:     ${chalk.dim(repoUrl)}`);
+                    console.log(`  Branch:   ${chalk.dim(currentBranch)}`);
+                    console.log();
+                }
+                const requiresNonInteractiveInputs = !process.stdin.isTTY || json || Boolean(opts.yes);
+                if (opts.static &&
+                    (opts.buildCommand !== undefined || opts.runCommand !== undefined)) {
+                    throw new UserError("--static cannot be combined with build or run commands.", "Remove --build-command and --run-command, or remove --static.");
+                }
+                if (requiresNonInteractiveInputs &&
+                    !opts.static &&
+                    !detection &&
+                    (!opts.buildCommand || !opts.runCommand)) {
+                    throw new UserError("Could not determine deployment commands non-interactively.", "Pass both --build-command <cmd> and --run-command <cmd>, or use --static for static sites.");
                 }
-                console.log(`  Repo:     ${chalk.dim(repoUrl)}`);
-                console.log(`  Branch:   ${chalk.dim(currentBranch)}`);
-                console.log();
-                // ── Interactive prompts ──────────────────────────────────────
-                const { default: inquirer } = await import("inquirer");
                 const projectName = path.basename(cwd).replace(/[^a-z0-9-]/gi, "-");
-                const answers = await inquirer.prompt([
-                    {
-                        type: "input",
-                        name: "name",
-                        message: "Deployment name:",
-                        default: projectName,
-                        validate: (v) => v.length > 0 ? true : "Name is required",
-                    },
-                    {
-                        type: "input",
-                        name: "branch",
-                        message: "Branch to deploy:",
-                        default: currentBranch,
-                    },
-                    {
-                        type: "input",
-                        name: "buildCommand",
-                        message: "Build command:",
-                        default: buildCommand,
-                    },
-                    {
-                        type: "input",
-                        name: "runCommand",
-                        message: "Run command:",
-                        default: runCommand,
-                    },
-                    {
+                let answers;
+                if (!requiresNonInteractiveInputs) {
+                    const { default: inquirer } = await import("inquirer");
+                    const identityQuestions = [
+                        {
+                            type: "input",
+                            name: "name",
+                            message: "Deployment name:",
+                            default: opts.name ?? projectName,
+                            validate: (v) => v.length > 0 ? true : "Name is required",
+                        },
+                        {
+                            type: "input",
+                            name: "branch",
+                            message: "Branch to deploy:",
+                            default: opts.branch ?? currentBranch,
+                        },
+                    ];
+                    const confirmQuestion = {
                         type: "confirm",
                         name: "confirm",
                         message: "Create deployment?",
                         default: true,
-                    },
-                ]);
+                    };
+                    if (opts.static) {
+                        const staticAnswers = await inquirer.prompt([...identityQuestions, confirmQuestion]);
+                        answers = {
+                            ...staticAnswers,
+                            buildCommand: "",
+                            runCommand: "",
+                        };
+                    }
+                    else {
+                        answers = await inquirer.prompt([
+                            ...identityQuestions,
+                            {
+                                type: "input",
+                                name: "buildCommand",
+                                message: "Build command:",
+                                default: opts.buildCommand ?? buildCommand,
+                            },
+                            {
+                                type: "input",
+                                name: "runCommand",
+                                message: "Run command:",
+                                default: opts.runCommand ?? runCommand,
+                            },
+                            confirmQuestion,
+                        ]);
+                    }
+                }
+                else {
+                    answers = {
+                        name: opts.name ?? projectName,
+                        branch: opts.branch ?? currentBranch,
+                        buildCommand: opts.static
+                            ? ""
+                            : (opts.buildCommand ?? buildCommand),
+                        runCommand: opts.static ? "" : (opts.runCommand ?? runCommand),
+                        confirm: true,
+                    };
+                }
                 if (!answers.confirm) {
                     console.log(chalk.dim("  Cancelled."));
                     process.exit(0);
                 }
                 // ── Step 3: POST /api/v1/deployments ─────────────────────────
-                const createSpinner = spin(`Creating deployment "${answers.name}"...`);
-                let webhookSecret;
+                const createSpinner = json
+                    ? null
+                    : spin(`Creating deployment "${answers.name}"...`);
                 let deployment;
                 try {
                     const metadata = opts.dockerDeploy
@@ -547,10 +635,11 @@ Examples:
                     });
                     deployment = result.data;
                     webhookSecret = result.webhook_secret;
-                    createSpinner.succeed(`${productLabel(deploymentProduct(deployment))} deployment "${deployment.name}" created (slug: ${deployment.slug})`);
+                    createdDeployment = deployment;
+                    createSpinner?.succeed(`${productLabel(deploymentProduct(deployment))} deployment "${deployment.name}" created (slug: ${deployment.slug})`);
                 }
                 catch (err) {
-                    createSpinner.fail("Failed to create deployment");
+                    createSpinner?.fail("Failed to create deployment");
                     handleError(err);
                 }
                 deploymentId = deployment.id;
@@ -566,29 +655,85 @@ Examples:
                     branch: answers.branch,
                 };
                 saveProjectConfig(cwd, projectCfg);
-                console.log(chalk.dim(`  Saved .miosa.json`));
+                if (!json)
+                    console.log(chalk.dim(`  Saved .miosa.json`));
                 // ── Step 4b: Print webhook secret (one-time) ─────────────────
-                console.log();
-                console.log(chalk.bold.yellow("  ACTION REQUIRED — GitHub Webhook"));
-                console.log(chalk.dim("  The webhook secret below is shown ONCE. Store it now."));
-                console.log();
-                console.log(`  ${chalk.bold("Webhook URL:")}   https://api.miosa.ai/api/v1/integrations/github/webhook`);
-                console.log(`  ${chalk.bold("Content type:")}  application/json`);
-                console.log(`  ${chalk.bold("Secret:")}        ${chalk.green(webhookSecret)}`);
-                console.log(`  ${chalk.bold("Events:")}        push`);
-                console.log();
-                console.log(chalk.dim("  Add this at: " + repoUrl + "/settings/hooks/new"));
-                console.log();
+                if (!json) {
+                    console.log();
+                    console.log(chalk.bold.yellow("  ACTION REQUIRED — GitHub Webhook"));
+                    console.log(chalk.dim("  The webhook secret below is shown ONCE. Store it now."));
+                    console.log();
+                    console.log(`  ${chalk.bold("Webhook URL:")}   https://api.miosa.ai/api/v1/integrations/github/webhook`);
+                    console.log(`  ${chalk.bold("Content type:")}  application/json`);
+                    console.log(`  ${chalk.bold("Secret:")}        ${chalk.green(webhookSecret)}`);
+                    console.log(`  ${chalk.bold("Events:")}        push`);
+                    console.log();
+                    console.log(chalk.dim("  Add this at: " + repoUrl + "/settings/hooks/new"));
+                    console.log();
+                }
                 // ── Step 5: Trigger initial build ─────────────────────────────
-                const buildSpinner = spin("Queuing initial build...");
+                const buildSpinner = json ? null : spin("Queuing initial build...");
                 try {
-                    await client.redeployDeployment(deploymentId);
-                    buildSpinner.succeed("Initial build queued");
+                    queuedBuild = await client.redeployDeployment(deploymentId);
+                    buildSpinner?.succeed("Initial build queued");
                 }
                 catch (err) {
-                    buildSpinner.fail("Failed to queue build");
-                    handleError(err);
+                    buildSpinner?.fail("Failed to queue build");
+                    if (!json)
+                        handleError(err);
+                    buildQueueError = err;
+                }
+            }
+            if (json) {
+                let deployment = createdDeployment;
+                if (!deployment) {
+                    try {
+                        deployment = await client.getDeployment(deploymentId);
+                    }
+                    catch {
+                        deployment = null;
+                    }
                 }
+                console.log(JSON.stringify({
+                    ok: buildQueueError === null,
+                    deployment: deployment
+                        ? {
+                            id: deployment.id,
+                            name: deployment.name,
+                            slug: deployment.slug,
+                            state: deployment.state,
+                            deployment_product: deploymentProduct(deployment),
+                            docker_deploy_host_id: deployment.docker_deploy_host_id ?? null,
+                            public_url: deploymentUrl(deployment),
+                        }
+                        : {
+                            id: deploymentId,
+                            name: projectCfg.name,
+                            slug: null,
+                            state: null,
+                            deployment_product: null,
+                            docker_deploy_host_id: null,
+                            public_url: null,
+                        },
+                    build: queuedBuild
+                        ? { id: queuedBuild.id, state: queuedBuild.state }
+                        : null,
+                    webhook: webhookSecret
+                        ? {
+                            url: "https://api.miosa.ai/api/v1/integrations/github/webhook",
+                            secret: webhookSecret,
+                            events: ["push"],
+                        }
+                        : null,
+                    project_config: path.join(cwd, PROJECT_CONFIG_FILE),
+                    ...(buildQueueError === null
+                        ? {}
+                        : { error: jsonErrorPayload(buildQueueError) }),
+                }, null, 2));
+                if (buildQueueError !== null) {
+                    process.exit(errorExitCode(buildQueueError));
+                }
+                return;
             }
             // ── Step 6: Stream build logs ─────────────────────────────────────
             console.log();
@@ -816,11 +961,16 @@ Examples:
             }
             printBanner({ subtitle: "Deployment proof" });
             console.log(kvPanel([
-                { label: "deployment_id", value: chalk.dim(result.deployment_id) },
+                {
+                    label: "deployment_id",
+                    value: chalk.dim(result.deployment_id),
+                },
                 { label: "type", value: productLabel(result.deployment_product) },
                 {
                     label: "public_url",
-                    value: result.public_url ? chalk.cyan(result.public_url) : chalk.dim("missing"),
+                    value: result.public_url
+                        ? chalk.cyan(result.public_url)
+                        : chalk.dim("missing"),
                 },
                 {
                     label: "proof",