@walkeros/cli 0.6.2 → 0.8.0

package/README.md

@@ -14,6 +14,21 @@ The walkerOS CLI is a developer tool that:
 Think of it as your development toolchain for walkerOS - from config to running
 production bundles.
 
+### When to Use the CLI
+
+The CLI is for **Bundled mode** — when you want config-as-code and separate
+deployment:
+
+| Use CLI When                | Use Integrated Mode When |
+| --------------------------- | ------------------------ |
+| Static sites, landing pages | React/Next.js apps       |
+| Docker/server deployments   | TypeScript projects      |
+| CI/CD versioned configs     | Programmatic control     |
+| Marketing/GTM workflows     | Build-time type safety   |
+
+For Integrated mode (importing directly into your app), see the
+[Collector package](../collector/).
+
 ## Installation
 
 ```bash
@@ -533,14 +548,14 @@ docker run -v ./dist:/flow -p 8080:8080 walkeros/flow
 
 ```dockerfile
 FROM walkeros/flow
-COPY dist/bundle.mjs /flow/
+COPY dist/bundle.mjs /app/flow/
 ```
 
 **Environment variables:**
 
 - `MODE` - `collect` or `serve` (default: `collect`)
 - `PORT` - Server port (default: `8080`)
-- `FILE` - Bundle path (default: `/flow/bundle.mjs`)
+- `BUNDLE` - Bundle path (default: `/app/flow/bundle.mjs`)
 
 ### Using Node.js
 
@@ -568,8 +583,11 @@ See [src/types.ts](./src/types.ts) for TypeScript interfaces.
 
 ## Related
 
-- [Website Documentation](https://www.walkeros.io/docs/cli/)
+- [Website Documentation](https://www.walkeros.io/docs/apps/cli/)
 - [Flow Configuration](https://www.walkeros.io/docs/getting-started/flow/)
+- [Collector Package](../collector/) - For Integrated mode (direct imports)
+- [Operating Modes](https://www.walkeros.io/docs/getting-started/modes/) -
+  Choosing between Integrated and Bundled
 
 ## License
 

package/dist/index.js

@@ -1481,7 +1481,7 @@ FROM walkeros/flow:latest
 COPY ${bundleFilename} /app/flow/bundle.mjs
 
 ENV MODE=collect
-ENV FLOW=/app/flow/bundle.mjs
+ENV BUNDLE=/app/flow/bundle.mjs
 
 EXPOSE 8080
 `;
@@ -2465,7 +2465,9 @@ import { resolve as resolve2 } from "path";
 async function runServeMode(config, logger2) {
   const port = process.env.PORT ? parseInt(process.env.PORT, 10) : config?.port || 8080;
   const host = process.env.HOST || config?.host || "0.0.0.0";
-  const file = resolve2(process.env.FILE || config?.file || "./dist/walker.js");
+  const file = resolve2(
+    process.env.BUNDLE || config?.file || "./dist/walker.js"
+  );
   const serveName = process.env.SERVE_NAME || config?.serveName || "walker.js";
   const servePath = process.env.SERVE_PATH || config?.servePath || "";
   const urlPath = servePath ? `/${servePath}/${serveName}` : `/${serveName}`;
@@ -2707,7 +2709,7 @@ program.name("walkeros").description("walkerOS CLI - Bundle and deploy walkerOS
 program.hook("preAction", (thisCommand, actionCommand) => {
   const options = actionCommand.opts();
   if (!options.silent && !options.json) {
-    console.log(chalk2.hex("#01b5e2")(`walkerOS v${VERSION}`));
+    console.log(`${chalk2.hex("#01b5e2")("walkerOS")} v${VERSION}`);
   }
 });
 program.command("bundle [file]").description("Bundle NPM packages with custom code").option("-f, --flow <name>", "flow to build (for multi-flow configs)").option("--all", "build all flows (for multi-flow configs)").option("-s, --stats", "show bundle statistics").option("--json", "output statistics in JSON format (implies --stats)").option("--no-cache", "disable package caching and download fresh packages").option("-v, --verbose", "verbose output").option("--dry-run", "preview command without executing").option("--silent", "suppress output").option("--dockerfile", "generate Dockerfile alongside bundle").action(async (file, options) => {