@mesh-tech/mesh-cli 0.43.2 → 0.44.0

package/assets/app-skill/SKILL.md

@@ -53,7 +53,14 @@ This section is what makes the skill worth loading.
 ```bash
 cd __APP_PATH__
 pnpm install
-mesh dev            # run locally
+
+# Local-only platform (mesh.json platform "local", or none set)
+mesh start          # the local Mesh platform (once; Docker)
+mesh dev            # run the app against it
 mesh hub dev        # watch this session's runs in a local Hub
+
+# Deployed platform
+mesh stack init     # personal dev stack (deploy: false)
 mesh deploy up      # deploy via the stack's deployer role
+mesh dev            # run locally against the platform
 ```

package/dist/bin/{mesh.chunk-OOWKJR4H.js → mesh.chunk-OQA2UBOD.js}

@@ -1051,7 +1051,7 @@ async function cliReferenceStaleness(repoRoot) {
     { createProgram },
     { extractCliReference, renderCliReferenceMarkdown }
   ] = await Promise.all([
-    import("./mesh.program-GEKNV2LY.js"),
+    import("./mesh.program-NOBVA3JS.js"),
     import("./mesh.cli-reference-H3TOPIET.js")
   ]);
   const outPath = path3.join(repoRoot, "docs/portal/generated/cli-reference.md");

package/dist/bin/{mesh.chunk-VCQKLVZJ.js → mesh.chunk-XOCERV6F.js}

@@ -12,7 +12,7 @@ import {
   cliReferenceStaleness,
   resolveCliRuntime,
   runPortalCommand
-} from "./mesh.chunk-OOWKJR4H.js";
+} from "./mesh.chunk-OQA2UBOD.js";
 import {
   registerAppCommands,
   registerCreateAppCommand
@@ -1542,7 +1542,7 @@ var DOCS_PREVIEW_PORT = "4410";
 var CLI_REFERENCE_PATH = "docs/portal/generated/cli-reference.md";
 async function renderCliReference() {
   const [{ createProgram: createProgram2 }, { extractCliReference, renderCliReferenceMarkdown }] = await Promise.all([
-    import("./mesh.program-GEKNV2LY.js"),
+    import("./mesh.program-NOBVA3JS.js"),
     import("./mesh.cli-reference-H3TOPIET.js")
   ]);
   return renderCliReferenceMarkdown(extractCliReference(createProgram2()));
@@ -1614,7 +1614,7 @@ function registerDocsCommand(program) {
     "Serve the Mesh docs locally \u2014 detached in a tmux session by default; the working tree in a mesh-platform checkout, or the published @mesh-tech/docs artifact (role-gated registry) anywhere else"
   ).option("-v, --version <version>", "docs version to serve (== the @mesh-tech/* baseline it describes); default: latest", void 0).option("-p, --port <port>", "port to serve on (0 picks a free one)", "4400").option("--dev", "in a checkout: run the Zudoku dev server (HMR) in the foreground, for authoring", false).option("--foreground", "serve in the foreground (the agent/CI path; automatic when not a TTY)", false).action(
     (opts) => guarded(async () => {
-      const { runDocsStart } = await import("./mesh.start-HE6P3TCS.js");
+      const { runDocsStart } = await import("./mesh.start-JDSYIRZI.js");
       await runDocsStart({
         repoRoot: findRepoRoot(process.cwd()),
         version: opts.version,
@@ -1626,13 +1626,13 @@ function registerDocsCommand(program) {
   );
   docs.command("stop").description(`Stop the detached docs server (the tmux session "${"mesh-docs"}")`).action(
     () => guarded(async () => {
-      const { runDocsStop } = await import("./mesh.start-HE6P3TCS.js");
+      const { runDocsStop } = await import("./mesh.start-JDSYIRZI.js");
       runDocsStop();
     })()
   );
   docs.command("serve-static", { hidden: true }).option("--root <dir>", "built site root", "").option("--port <port>", "port", "4400").action(
     (opts) => guarded(async () => {
-      const { runDocsServeStatic } = await import("./mesh.start-HE6P3TCS.js");
+      const { runDocsServeStatic } = await import("./mesh.start-JDSYIRZI.js");
       await runDocsServeStatic(opts);
     })()
   );
@@ -1675,7 +1675,7 @@ function registerDocsCommand(program) {
   );
   docs.command("list").description("List the published docs versions (each is an @mesh-tech/* baseline)").action(
     () => guarded(async () => {
-      const { runDocsList } = await import("./mesh.start-HE6P3TCS.js");
+      const { runDocsList } = await import("./mesh.start-JDSYIRZI.js");
       await runDocsList();
     })()
   );
@@ -6959,7 +6959,7 @@ const target = ${JSON.stringify(targetPath)};
 const explicitProcessArtifact = ${JSON.stringify(explicitProcessArtifact ?? null)};
 const stat = statSync(target);
 const files = stat.isDirectory()
-  ? readdirSync(target).filter(f => f.endsWith(".ts") && f !== "index.ts").map(f => join(target, f))
+  ? readdirSync(target).filter(f => f.endsWith(".ts") && f !== "index.ts" && !/\\.(test|spec|d)\\.ts$/.test(f)).map(f => join(target, f))
   : [target];
 
 const results = [];
@@ -7005,7 +7005,7 @@ ${DISCOVERY_HELPERS_SRC}
 const target = ${JSON.stringify(targetPath)};
 const stat = statSync(target);
 const files = stat.isDirectory()
-  ? readdirSync(target).filter(f => f.endsWith(".ts") && f !== "index.ts").map(f => join(target, f))
+  ? readdirSync(target).filter(f => f.endsWith(".ts") && f !== "index.ts" && !/\\.(test|spec|d)\\.ts$/.test(f)).map(f => join(target, f))
   : [target];
 
 const results = [];
@@ -7059,7 +7059,7 @@ const target = ${JSON.stringify(targetPath)};
 const explicitProcessArtifact = ${JSON.stringify(explicitProcessArtifact ?? null)};
 const stat = statSync(target);
 const files = stat.isDirectory()
-  ? readdirSync(target).filter(f => f.endsWith(".ts") && f !== "index.ts").map(f => join(target, f))
+  ? readdirSync(target).filter(f => f.endsWith(".ts") && f !== "index.ts" && !/\\.(test|spec|d)\\.ts$/.test(f)).map(f => join(target, f))
   : [target];
 
 const results = [];
@@ -7093,22 +7093,7 @@ process.stdout.write(JSON.stringify(results));
     return null;
   }
 }
-async function uploadToS3(bucket, appName, workflows) {
-  const { S3Client, PutObjectCommand } = await import("@aws-sdk/client-s3");
-  const s3 = new S3Client({ region: process.env.AWS_REGION ?? "us-east-2" });
-  for (const wf of workflows) {
-    const key = `workflow-ir/${appName}/${wf.workflowType}.json`;
-    const body = JSON.stringify(wf.ir, null, 2);
-    logInfo(`  Uploading s3://${bucket}/${key} (${body.length} bytes)`);
-    await s3.send(
-      new PutObjectCommand({
-        Bucket: bucket,
-        Key: key,
-        Body: body,
-        ContentType: "application/json"
-      })
-    );
-  }
+function workflowIrFiles(appName, workflows, root) {
   const manifest = {
     extractedAt: (/* @__PURE__ */ new Date()).toISOString(),
     app: appName,
@@ -7116,23 +7101,33 @@ async function uploadToS3(bucket, appName, workflows) {
       workflows.map((wf) => [
         wf.workflowType,
         {
-          sourceFile: wf.sourceFile,
+          sourceFile: path14.relative(root, wf.sourceFile) || path14.basename(wf.sourceFile),
           nodeCount: wf.ir.nodes.length,
           edgeCount: wf.ir.edges.length
         }
       ])
     )
   };
-  const manifestKey = `workflow-ir/${appName}/_manifest.json`;
-  logInfo(`  Uploading s3://${bucket}/${manifestKey}`);
-  await s3.send(
-    new PutObjectCommand({
-      Bucket: bucket,
-      Key: manifestKey,
-      Body: JSON.stringify(manifest, null, 2),
-      ContentType: "application/json"
-    })
-  );
+  return [
+    ...workflows.map((wf) => ({ name: `${wf.workflowType}.json`, body: JSON.stringify(wf.ir, null, 2) })),
+    { name: "_manifest.json", body: JSON.stringify(manifest, null, 2) }
+  ];
+}
+async function uploadToS3(bucket, appName, files) {
+  const { S3Client, PutObjectCommand } = await import("@aws-sdk/client-s3");
+  const s3 = new S3Client({ region: process.env.AWS_REGION ?? "us-east-2", followRegionRedirects: true });
+  for (const file of files) {
+    const key = `workflow-ir/${appName}/${file.name}`;
+    logInfo(`  Uploading s3://${bucket}/${key} (${file.body.length} bytes)`);
+    await s3.send(
+      new PutObjectCommand({
+        Bucket: bucket,
+        Key: key,
+        Body: file.body,
+        ContentType: "application/json"
+      })
+    );
+  }
 }
 function parseNameList(value) {
   return value ? value.split(",").map((name) => name.trim()).filter((name) => name.length > 0) : void 0;
@@ -7144,6 +7139,9 @@ function registerWorkflowCommands(program) {
   ).option("--app <name>", "Application name (used as S3 key prefix)").option(
     "--upload <bucket>",
     "S3 bucket to upload extracted IR (requires --app)"
+  ).option(
+    "--out <dir>",
+    "Write the files the upload would write (one JSON per workflow type, plus _manifest.json) to a directory (requires --app)"
   ).option(
     "--process <path>",
     "Path to a process artifact JSON file (docs/plans/2026-07-05-process-artifact-design.md \xA71); renders substeps/actors/outcomes in place of a BUSINESS_STAGES map. Absent this flag, a sibling process/*.process.json is auto-discovered per workflow file."
@@ -7185,15 +7183,29 @@ function registerWorkflowCommands(program) {
             `  ${wf.workflowType} (${wf.ir.nodes.length} nodes, ${wf.ir.edges.length} edges)`
           );
         }
-        if (opts.upload && opts.app) {
+        if ((opts.upload || opts.out) && !opts.app) {
+          logError("--upload and --out need --app (the IR's key prefix)");
+          process.exitCode = 1;
+          return;
+        }
+        const root = fs13.statSync(resolvedPath).isDirectory() ? resolvedPath : path14.dirname(resolvedPath);
+        const files = opts.app ? workflowIrFiles(opts.app, results, root) : [];
+        if (opts.out) {
+          const outDir = path14.resolve(opts.out);
+          fs13.mkdirSync(outDir, { recursive: true });
+          for (const file of files) fs13.writeFileSync(path14.join(outDir, file.name), file.body);
+          logSuccess(`Wrote ${files.length} file(s) to ${outDir}`);
+        }
+        if (opts.upload) {
           logInfo(
             `Uploading ${results.length} workflow IR(s) to s3://${opts.upload}/workflow-ir/${opts.app}/`
           );
-          await uploadToS3(opts.upload, opts.app, results);
+          await uploadToS3(opts.upload, opts.app, files);
           logSuccess("Upload complete");
-        } else if (opts.upload || opts.app) {
-          logWarn("Both --app and --upload required for S3 upload");
-        } else {
+        } else if (opts.app && !opts.out) {
+          logWarn("--app does nothing without --upload or --out");
+        }
+        if (!opts.upload && !opts.out) {
           console.log(JSON.stringify(results.map((r) => r.ir), null, 2));
         }
       } catch (error) {