minutework 0.1.19 → 0.1.20

package/assets/templates/fastapi-sidecar/template.schema.json

@@ -25,14 +25,16 @@
       "enum": [
         "sidecar_nextjs_private",
         "sidecar_fastapi_internal",
-        "combined_web"
+        "combined_web",
+        "public_site"
       ]
     },
     "template_profile": {
       "type": "string",
       "enum": [
         "platform_session_bff",
-        "bridge_internal"
+        "bridge_internal",
+        "public_dj_cms"
       ]
     },
     "template_version": {

package/assets/templates/next-tenant-app/README.md

@@ -8,6 +8,10 @@ In the runtime Builder flow, this bundle materializes into
 In the external CLI scaffold flow, the same starter is copied into
 `tenant-app/`.
 
+On managed tenant VMs, `BuilderWorkspace.sandbox_root` normally lives under
+`/srv/minutework/workspaces/<workspace_id>/`, so the Builder-edited app copy is
+typically `/srv/minutework/workspaces/<workspace_id>/app/`.
+
 `apps/mw-next-client` is still the repo-side seed used to harden and evolve this scaffold. It is not the runtime template location.
 
 ## Auth profile
@@ -27,13 +31,16 @@ This template stays fixed to the `platform_session_bff` profile:
 
 ## Direct web hosts
 
-When this starter lives inside a combined workspace with an optional `sidecar`,
-deploy direct web hosts against `tenant-app` only.
+When this starter lives inside an external CLI workspace with an optional
+`sidecar`, deploy direct web hosts against `tenant-app` only.
 
 - Root `pnpm install` stays Node-only and does not auto-install sidecar Python deps.
 - If you need the sidecar locally, run `pnpm run install:sidecar` from the workspace root or `cd sidecar && poetry install`.
 - For Vercel, set the project Root Directory to `tenant-app`.
 
+Those host-specific instructions apply to the CLI scaffold layout, not the
+runtime Builder sandbox layout under `app/`.
+
 ## Default route shape
 
 The template ships one combined app with two explicit route surfaces:
@@ -131,7 +138,8 @@ Use `pnpm validate` from this directory. It runs:
 `template:validate` validates `template.json` against the bundled `template.schema.json`, so the template remains self-validating after Builder materializes it into a workspace sandbox.
 
 When the CLI scaffolds this starter into `tenant-app/`, the same validation
-contract still applies to that copied workspace surface.
+contract still applies to that copied workspace surface. When Runtime Builder
+materializes it into `app/`, the same validation contract applies there too.
 
 The validation-only build steps inject fixture values for the required
 production env vars and run against a local public-site fixture server, so the

package/assets/templates/next-tenant-app/template.schema.json

@@ -25,14 +25,16 @@
       "enum": [
         "sidecar_nextjs_private",
         "sidecar_fastapi_internal",
-        "combined_web"
+        "combined_web",
+        "public_site"
       ]
     },
     "template_profile": {
       "type": "string",
       "enum": [
         "platform_session_bff",
-        "bridge_internal"
+        "bridge_internal",
+        "public_dj_cms"
       ]
     },
     "template_version": {

package/dist/cli-json.d.ts

@@ -0,0 +1,28 @@
+export declare const CLI_JSON_VERSION: 1;
+export type CliJsonCommand = "validate" | "compile" | "codegen" | "deploy" | "publish";
+export type CliJsonEnvelope = {
+    cliJsonVersion: typeof CLI_JSON_VERSION;
+    command: CliJsonCommand;
+    ok: boolean;
+    status: string;
+    result: unknown;
+    error: {
+        message: string;
+    } | null;
+};
+/**
+ * Render the single, stable JSON envelope that machine-readable CLI verbs emit
+ * on stdout under `--json`. An IDE agent parses one shape across every verb:
+ * check `ok` (and the process exit code), then read `status` and
+ * `result` / `error`. The envelope is the contract; `cliJsonVersion` lets the
+ * shape evolve without silently breaking parsers.
+ */
+export declare function renderCliJsonEnvelope(envelope: {
+    command: CliJsonCommand;
+    ok: boolean;
+    status: string;
+    result?: unknown;
+    error?: {
+        message: string;
+    } | null;
+}): string;

package/dist/cli-json.js

@@ -0,0 +1,20 @@
+export const CLI_JSON_VERSION = 1;
+/**
+ * Render the single, stable JSON envelope that machine-readable CLI verbs emit
+ * on stdout under `--json`. An IDE agent parses one shape across every verb:
+ * check `ok` (and the process exit code), then read `status` and
+ * `result` / `error`. The envelope is the contract; `cliJsonVersion` lets the
+ * shape evolve without silently breaking parsers.
+ */
+export function renderCliJsonEnvelope(envelope) {
+    const payload = {
+        cliJsonVersion: CLI_JSON_VERSION,
+        command: envelope.command,
+        ok: envelope.ok,
+        status: envelope.status,
+        result: envelope.result ?? null,
+        error: envelope.error ?? null,
+    };
+    return `${JSON.stringify(payload, null, 2)}\n`;
+}
+//# sourceMappingURL=cli-json.js.map

package/dist/cli-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-json.js","sourceRoot":"","sources":["../src/cli-json.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAa3C;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAMrC;IACC,MAAM,OAAO,GAAoB;QAC/B,cAAc,EAAE,gBAAgB;QAChC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI;QAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;KAC9B,CAAC;IACF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

package/dist/compile.js

@@ -1,6 +1,7 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
 import { analyzeCompilerWorkspace, discoverCompilerWorkspaceRoot, } from "@minutework/schema-compiler";
+import { renderCliJsonEnvelope } from "./cli-json.js";
 export async function runValidateCommand(options) {
     const parsed = parseCompilerCommandArgs(options.args, "validate");
     if (parsed.help) {
@@ -9,8 +10,18 @@ export async function runValidateCommand(options) {
     }
     const workspaceRoot = await discoverCompilerWorkspaceRoot(path.resolve(options.cwd, parsed.workspacePath ?? "."));
     const analysis = await analyzeCompilerWorkspace(workspaceRoot);
+    const ok = analysis.validateReport.status === "ok";
+    if (parsed.json) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "validate",
+            ok,
+            status: analysis.validateReport.status,
+            result: analysis.validateReport,
+        }));
+        return ok ? 0 : 1;
+    }
     options.io.stdout(formatJson(analysis.validateReport));
-    return analysis.validateReport.status === "ok" ? 0 : 1;
+    return ok ? 0 : 1;
 }
 export async function runCompileCommand(options) {
     const parsed = parseCompilerCommandArgs(options.args, "compile");
@@ -21,10 +32,29 @@ export async function runCompileCommand(options) {
     const workspaceRoot = await discoverCompilerWorkspaceRoot(path.resolve(options.cwd, parsed.workspacePath ?? "."));
     const analysis = await analyzeCompilerWorkspace(workspaceRoot);
     if (!analysis.compileGraph) {
+        if (parsed.json) {
+            options.io.stdout(renderCliJsonEnvelope({
+                command: "compile",
+                ok: false,
+                status: analysis.validateReport.status,
+                result: analysis.validateReport,
+                error: { message: "Compile failed: schema source did not validate." },
+            }));
+            return 1;
+        }
         options.io.stderr(formatJson(analysis.validateReport));
         return 1;
     }
     await writeCompileGraph(workspaceRoot, analysis.compileGraph);
+    if (parsed.json) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "compile",
+            ok: true,
+            status: "compiled",
+            result: analysis.compileGraph,
+        }));
+        return 0;
+    }
     options.io.stdout(formatJson(analysis.compileGraph));
     return 0;
 }
@@ -37,16 +67,36 @@ export async function runCodegenCommand(options) {
     const workspaceRoot = await discoverCompilerWorkspaceRoot(path.resolve(options.cwd, parsed.workspacePath ?? "."));
     const analysis = await analyzeCompilerWorkspace(workspaceRoot);
     if (!analysis.compileGraph || !analysis.codegenArtifacts) {
+        if (parsed.json) {
+            options.io.stdout(renderCliJsonEnvelope({
+                command: "codegen",
+                ok: false,
+                status: analysis.validateReport.status,
+                result: analysis.validateReport,
+                error: { message: "Codegen failed: schema source did not validate." },
+            }));
+            return 1;
+        }
         options.io.stderr(formatJson(analysis.validateReport));
         return 1;
     }
     await writeCompileGraph(workspaceRoot, analysis.compileGraph);
     await writeCodegenArtifacts(workspaceRoot, analysis.compileGraph.artifacts, analysis.codegenArtifacts);
+    if (parsed.json) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "codegen",
+            ok: true,
+            status: "generated",
+            result: analysis.compileGraph,
+        }));
+        return 0;
+    }
     options.io.stdout(formatJson(analysis.compileGraph));
     return 0;
 }
 function parseCompilerCommandArgs(args, command) {
     let workspacePath;
+    let json = false;
     const setWorkspacePath = (value) => {
         if (workspacePath) {
             throw new Error(`${command} accepts at most one workspace path.`);
@@ -58,6 +108,10 @@ function parseCompilerCommandArgs(args, command) {
         if (arg === "--help" || arg === "-h") {
             return { help: true };
         }
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
         if (arg === "--workspace") {
             const next = args[index + 1];
             if (!next || next.startsWith("--")) {
@@ -82,6 +136,7 @@ function parseCompilerCommandArgs(args, command) {
     }
     return {
         help: false,
+        json,
         workspacePath,
     };
 }
@@ -102,20 +157,29 @@ export function formatJson(payload) {
 }
 function renderValidateHelp() {
     return `Usage:
-  minutework validate [workspace] [--workspace <path>]
+  minutework validate [workspace] [--workspace <path>] [--json]
 
-Validate the local MinuteWork schema authoring source and print a deterministic validate report.`;
+Validate the local MinuteWork schema authoring source and print a deterministic validate report.
+
+Options:
+  --json  Emit a single machine-readable JSON result envelope (cliJsonVersion, command, ok, status, result, error) on stdout. Exit 0 when valid, 1 otherwise.`;
 }
 function renderCompileHelp() {
     return `Usage:
-  minutework compile [workspace] [--workspace <path>]
+  minutework compile [workspace] [--workspace <path>] [--json]
+
+Compile the local MinuteWork schema source and write the canonical graph.json artifact under the configured local state directory.
 
-Compile the local MinuteWork schema source and write the canonical graph.json artifact under the configured local state directory.`;
+Options:
+  --json  Emit a single machine-readable JSON result envelope on stdout (result is the compile graph on success, the validate report on failure). Exit 0 on success, 1 otherwise.`;
 }
 function renderCodegenHelp() {
     return `Usage:
-  minutework codegen [workspace] [--workspace <path>]
+  minutework codegen [workspace] [--workspace <path>] [--json]
+
+Generate deterministic OpenAPI and client-type artifacts from the local compile graph, refreshing graph.json first when validation succeeds.
 
-Generate deterministic OpenAPI and client-type artifacts from the local compile graph, refreshing graph.json first when validation succeeds.`;
+Options:
+  --json  Emit a single machine-readable JSON result envelope on stdout. Exit 0 on success, 1 otherwise.`;
 }
 //# sourceMappingURL=compile.js.map

package/dist/compile.js.map

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

package/dist/deploy.js

@@ -4,7 +4,8 @@ import { analyzeCompilerWorkspace, discoverCompilerWorkspaceRoot, HostedPreviewR
 import { writeCompileGraph } from "./compile.js";
 import { MINUTEWORK_PREVIEW_DEPLOY_STATE_VERSION, writePreviewDeployState, } from "./deploy-state.js";
 import { createDeveloperClient, } from "./developer-client.js";
-import { buildRuntimeAppPackage } from "./runtime-package.js";
+import { renderCliJsonEnvelope } from "./cli-json.js";
+import { buildRuntimeAppPackage, buildRuntimePackagePayload } from "./runtime-package.js";
 import { assertWorkspacePlatformMatchesAuthProfile, resolveOptionalCliWorkspaceConfig, } from "./config.js";
 import { loadCurrentAuthProfile, loadWorkspaceBinding, } from "./state.js";
 export async function runDeployCommand(options) {
@@ -13,8 +14,33 @@ export async function runDeployCommand(options) {
         options.io.stdout(renderDeployHelp());
         return 0;
     }
+    try {
+        return await executeDeployPreview({ options, parsed });
+    }
+    catch (error) {
+        if (!parsed.json) {
+            throw error;
+        }
+        // In --json mode every outcome — including thrown errors — is a single
+        // envelope on stdout, so the agent never has to parse free-form stderr.
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "deploy",
+            ok: false,
+            status: "error",
+            error: { message: error instanceof Error ? error.message : String(error) },
+        }));
+        return 1;
+    }
+}
+async function executeDeployPreview(context) {
+    const { options, parsed } = context;
     if (parsed.target === "live") {
-        options.io.stderr("`minutework deploy --live` is reserved for follow-on work and is not implemented for the external alpha.");
+        const message = "`minutework deploy --live` is reserved for follow-on work and is not implemented for the external alpha.";
+        if (parsed.json) {
+            options.io.stdout(renderCliJsonEnvelope({ command: "deploy", ok: false, status: "not_implemented", error: { message } }));
+            return 1;
+        }
+        options.io.stderr(message);
         return 1;
     }
     const workspaceRoot = await discoverCompilerWorkspaceRoot(path.resolve(options.cwd, parsed.workspacePath ?? "."));
@@ -37,6 +63,16 @@ export async function runDeployCommand(options) {
     }
     const analysis = await analyzeCompilerWorkspace(workspaceRoot);
     if (!analysis.compileGraph) {
+        if (parsed.json) {
+            options.io.stdout(renderCliJsonEnvelope({
+                command: "deploy",
+                ok: false,
+                status: analysis.validateReport.status,
+                result: analysis.validateReport,
+                error: { message: "Deploy failed: schema source did not validate." },
+            }));
+            return 1;
+        }
         options.io.stderr(JSON.stringify(analysis.validateReport, null, 2));
         return 1;
     }
@@ -53,6 +89,7 @@ export async function runDeployCommand(options) {
             client,
             dependencies: options.dependencies,
             io: options.io,
+            json: parsed.json,
             platform: options.platform,
             workspaceRoot,
             yes: parsed.yes,
@@ -64,6 +101,7 @@ export async function runDeployCommand(options) {
         client,
         dependencies: options.dependencies,
         io: options.io,
+        json: parsed.json,
         platform: options.platform,
         workspaceRoot,
         yes: parsed.yes,
@@ -96,17 +134,47 @@ async function runHostedPreviewDeploy(options) {
         },
         workspaceRoot: options.workspaceRoot,
     });
-    renderPreviewDiff(options.io, {
-        local: releaseMetadata,
-        remote: remoteStatus,
-    });
+    if (!options.json) {
+        renderPreviewDiff(options.io, {
+            local: releaseMetadata,
+            remote: remoteStatus,
+        });
+    }
     if (remoteStatus.current_preview_release?.digest === releaseMetadata.releaseDigest) {
+        if (options.json) {
+            options.io.stdout(renderCliJsonEnvelope({
+                command: "deploy",
+                ok: true,
+                status: "already_current",
+                result: {
+                    targetKind: "public_site",
+                    propertyKey: options.binding.propertyKey,
+                    releaseDigest: releaseMetadata.releaseDigest,
+                    previewUrl: remoteStatus.preview_url ?? null,
+                },
+            }));
+            return 0;
+        }
         options.io.stdout("Preview deploy already matches the local release digest.");
         if (remoteStatus.preview_url) {
             options.io.stdout(`Preview URL: ${remoteStatus.preview_url}`);
         }
         return 0;
     }
+    if (options.json && !options.yes) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "deploy",
+            ok: false,
+            status: "confirmation_required",
+            result: {
+                targetKind: "public_site",
+                localReleaseDigest: releaseMetadata.releaseDigest,
+                remoteReleaseDigest: remoteStatus.current_preview_release?.digest ?? null,
+            },
+            error: { message: "Preview deploy needs confirmation; re-run with --yes (required alongside --json)." },
+        }));
+        return 1;
+    }
     const confirmed = options.yes ||
         (await (options.dependencies?.confirmPreviewDeploy ?? defaultConfirmPreviewDeploy)({
             localReleaseDigest: releaseMetadata.releaseDigest,
@@ -171,6 +239,19 @@ async function runHostedPreviewDeploy(options) {
         },
         workspaceRoot: options.workspaceRoot,
     });
+    if (options.json) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "deploy",
+            ok: terminalReceipt.deployment_state === "activated",
+            status: terminalReceipt.deployment_state,
+            result: {
+                targetKind: "public_site",
+                previewUrl: terminalReceipt.preview_url ?? null,
+                receipt: summarizeTerminalReceipt(terminalReceipt),
+            },
+        }));
+        return terminalReceipt.deployment_state === "activated" ? 0 : 1;
+    }
     renderTerminalReceipt(options.io, terminalReceipt);
     return terminalReceipt.deployment_state === "activated" ? 0 : 1;
 }
@@ -207,18 +288,49 @@ async function runRuntimePreviewDeploy(options) {
         },
         workspaceRoot: options.workspaceRoot,
     });
-    renderRuntimePreviewDiff(options.io, {
-        local: releaseMetadata,
-        remote: remoteStatus,
-    });
+    if (!options.json) {
+        renderRuntimePreviewDiff(options.io, {
+            local: releaseMetadata,
+            remote: remoteStatus,
+        });
+    }
     if (remoteStatus.app_pack?.status === "active" &&
         String(remoteStatus.current_receipt?.detail?.release_digest || "") === releaseMetadata.releaseDigest) {
+        if (options.json) {
+            options.io.stdout(renderCliJsonEnvelope({
+                command: "deploy",
+                ok: true,
+                status: "already_current",
+                result: {
+                    targetKind: "runtime_app",
+                    appId: releaseMetadata.appId,
+                    releaseDigest: releaseMetadata.releaseDigest,
+                    previewUrl: remoteStatus.preview_url ?? null,
+                },
+            }));
+            return 0;
+        }
         options.io.stdout("Runtime preview deploy already matches the local release digest.");
         if (remoteStatus.preview_url) {
             options.io.stdout(`Preview URL: ${remoteStatus.preview_url}`);
         }
         return 0;
     }
+    if (options.json && !options.yes) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "deploy",
+            ok: false,
+            status: "confirmation_required",
+            result: {
+                targetKind: "runtime_app",
+                appId: releaseMetadata.appId,
+                localReleaseDigest: releaseMetadata.releaseDigest,
+                remoteReleaseDigest: remoteStatus.app_pack?.app_version ?? null,
+            },
+            error: { message: "Preview deploy needs confirmation; re-run with --yes (required alongside --json)." },
+        }));
+        return 1;
+    }
     const confirmed = options.yes ||
         (await (options.dependencies?.confirmPreviewDeploy ?? defaultConfirmPreviewDeploy)({
             appId: releaseMetadata.appId,
@@ -285,14 +397,25 @@ async function runRuntimePreviewDeploy(options) {
         },
         workspaceRoot: options.workspaceRoot,
     });
+    if (options.json) {
+        options.io.stdout(renderCliJsonEnvelope({
+            command: "deploy",
+            ok: terminalReceipt.deployment_state === "activated",
+            status: terminalReceipt.deployment_state,
+            result: {
+                targetKind: "runtime_app",
+                previewUrl: terminalReceipt.preview_url ?? null,
+                receipt: summarizeRuntimeTerminalReceipt(terminalReceipt),
+            },
+        }));
+        return terminalReceipt.deployment_state === "activated" ? 0 : 1;
+    }
     renderRuntimeTerminalReceipt(options.io, terminalReceipt);
     return terminalReceipt.deployment_state === "activated" ? 0 : 1;
 }
-function buildRuntimePackagePayload(packageArtifact) {
-    return JSON.parse(JSON.stringify(packageArtifact));
-}
 function parseDeployCommandArgs(args) {
     let help = false;
+    let json = false;
     let target = null;
     let workspacePath;
     let yes = false;
@@ -320,6 +443,10 @@ function parseDeployCommandArgs(args) {
             yes = true;
             continue;
         }
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
         if (arg === "--workspace") {
             const next = args[index + 1];
             if (!next || next.startsWith("--")) {
@@ -345,7 +472,7 @@ function parseDeployCommandArgs(args) {
     if (!help && target === null) {
         throw new Error("The deploy command requires either `--preview` or `--live`.");
     }
-    return { help, target, workspacePath, yes };
+    return { help, json, target, workspacePath, yes };
 }
 function renderDeployHelp() {
     return `Usage:
@@ -355,6 +482,12 @@ function renderDeployHelp() {
 Current support:
   --preview   Uses the linked workspace target (hosted public-site or tenant runtime)
   --live      Reserved follow-on work and intentionally blocked
+
+Options:
+  --yes    Skip the interactive confirmation prompt.
+  --json   Emit a single machine-readable JSON result envelope on stdout and run
+           unattended (never prompts). Pair with --yes to authorize the deploy;
+           without --yes a "confirmation_required" result is returned (exit 1).
 `;
 }
 async function defaultConfirmPreviewDeploy() {