@walkeros/cli 4.7.0-next-1790245733116 → 4.7.0

package/dist/dev.d.ts

@@ -56,6 +56,9 @@ type ValidationType = z.infer<typeof ValidationTypeSchema>;
 declare const ValidateOptionsSchema: z.ZodObject<{
     flow: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
+    strict: z.ZodOptional<z.ZodBoolean>;
+    offline: z.ZodOptional<z.ZodBoolean>;
+    configDir: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
 /**
@@ -75,6 +78,8 @@ declare const ValidateInputShape: {
     input: z.ZodString;
     flow: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
+    strict: z.ZodOptional<z.ZodBoolean>;
+    offline: z.ZodOptional<z.ZodBoolean>;
 };
 /**
  * Validate input schema for MCP tools.
@@ -92,6 +97,8 @@ declare const ValidateInputSchema: z.ZodObject<{
     input: z.ZodString;
     flow: z.ZodOptional<z.ZodString>;
     path: z.ZodOptional<z.ZodString>;
+    strict: z.ZodOptional<z.ZodBoolean>;
+    offline: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type ValidateInput = z.infer<typeof ValidateInputSchema>;
 

package/dist/dev.js

@@ -36,7 +36,16 @@ var ValidationTypeSchema = z2.enum(["contract", "event", "flow", "mapping"]).des
 var ValidateOptionsSchema = z2.object({
   flow: z2.string().optional().describe("Flow name for multi-flow configs"),
   path: z2.string().optional().describe(
-    'Entry path for package schema validation (e.g., "destinations.snowplow", "sources.browser")'
+    'Entry path for package schema validation (e.g., "destinations.snowplow", "stores.cache"). Checks the entry in every flow that has it, or only in --flow.'
+  ),
+  strict: z2.boolean().optional().describe(
+    "Escalate: strict turns warnings and skips into failures (valid is false), contract disagreements error"
+  ),
+  offline: z2.boolean().optional().describe(
+    'Do not fetch package schemas: step settings are not checked against them, and the result scope says so. Only with type "flow" and no path.'
+  ),
+  configDir: z2.string().optional().describe(
+    "Directory local `path` packages resolve against. Defaults to the input file's directory; set it when passing a parsed document."
   )
 });
 var ValidateInputShape = {
@@ -44,7 +53,13 @@ var ValidateInputShape = {
   input: z2.string().min(1).describe("JSON string, file path, or URL to validate"),
   flow: z2.string().optional().describe("Flow name for multi-flow configs"),
   path: z2.string().optional().describe(
-    'Entry path for package schema validation (e.g., "destinations.snowplow"). When provided, validates the entry against its package JSON Schema instead of using --type.'
+    'Entry path for package schema validation (e.g., "destinations.snowplow"). Only with type "flow": validates the entry against its package JSON Schema in every flow that has it, or only in the given flow.'
+  ),
+  strict: z2.boolean().optional().describe(
+    "Escalate: strict turns warnings and skips into failures: valid is false (the CLI exits 2), and contract example disagreements become errors. Every check runs with or without it."
+  ),
+  offline: z2.boolean().optional().describe(
+    'Do not fetch package schemas: step settings are not checked against them, and details.scope says so. Only with type "flow" and no path.'
   )
 };
 var ValidateInputSchema = z2.object(ValidateInputShape);

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/validate.ts","../src/schemas/bundle.ts","../src/schemas/simulate.ts","../src/schemas/push.ts"],"sourcesContent":["/**\n * CLI Schemas\n *\n * Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nexport { PortSchema, FilePathSchema } from './primitives';\n\nexport {\n  ValidationTypeSchema,\n  ValidateOptionsSchema,\n  ValidateInputShape,\n  ValidateInputSchema,\n  type ValidationType,\n  type ValidateOptions,\n  type ValidateInput,\n} from './validate';\n\nexport {\n  BundleOptionsSchema,\n  BundleInputShape,\n  BundleInputSchema,\n  type BundleOptions,\n  type BundleInput,\n} from './bundle';\n\nexport {\n  PlatformSchema,\n  SimulateOptionsSchema,\n  SimulateInputShape,\n  SimulateInputSchema,\n  type Platform,\n  type SimulateOptions,\n  type SimulateInput,\n} from './simulate';\n\nexport {\n  PushOptionsSchema,\n  PushInputShape,\n  PushInputSchema,\n  type PushOptions,\n  type PushInput,\n} from './push';\n","/**\n * CLI Primitive Schemas\n *\n * Basic Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Port number schema.\n *\n * @remarks\n * Validates HTTP server port number.\n * Must be integer between 1-65535.\n */\nexport const PortSchema = z\n  .number()\n  .int('Port must be an integer')\n  .min(1, 'Port must be at least 1')\n  .max(65535, 'Port must be at most 65535')\n  .describe('HTTP server port number');\n\n/**\n * File path schema.\n *\n * @remarks\n * Basic string validation for file paths.\n * File existence is checked separately (Zod can't check filesystem).\n */\nexport const FilePathSchema = z\n  .string()\n  .min(1, 'File path cannot be empty')\n  .describe('Path to configuration file');\n","/**\n * Validate Command Schemas\n *\n * Zod schemas for validate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Validation type schema.\n *\n * @remarks\n * Validates the type of validation to perform.\n * - `contract`: Validate a data contract\n * - `event`: Validate a walkerOS event object\n * - `flow`: Validate a flow configuration file\n * - `mapping`: Validate mapping rules\n */\nexport const ValidationTypeSchema = z\n  .enum(['contract', 'event', 'flow', 'mapping'])\n  .describe('Validation type: \"event\", \"flow\", \"mapping\", or \"contract\"');\n\nexport type ValidationType = z.infer<typeof ValidationTypeSchema>;\n\n/**\n * Validate options schema.\n *\n * @remarks\n * Options for the programmatic validate() API.\n */\nexport const ValidateOptionsSchema = z.object({\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\", \"sources.browser\")',\n    ),\n});\n\nexport type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const ValidateInputShape = {\n  type: ValidationTypeSchema,\n  input: z\n    .string()\n    .min(1)\n    .describe('JSON string, file path, or URL to validate'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\"). When provided, validates the entry against its package JSON Schema instead of using --type.',\n    ),\n};\n\n/**\n * Validate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including type and input source.\n */\nexport const ValidateInputSchema = z.object(ValidateInputShape);\n\nexport type ValidateInput = z.infer<typeof ValidateInputSchema>;\n","/**\n * Bundle Command Schemas\n *\n * Zod schemas for bundle command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Bundle options schema.\n *\n * @remarks\n * Options for the programmatic bundle() API.\n */\nexport const BundleOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  cache: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Enable package caching'),\n  flowName: z.string().optional().describe('Flow name for multi-flow configs'),\n});\n\nexport type BundleOptions = z.infer<typeof BundleOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const BundleInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file (JSON or JavaScript), URL, or inline JSON string',\n  ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  output: z\n    .string()\n    .optional()\n    .describe('Output file path (defaults to config-defined)'),\n};\n\n/**\n * Bundle input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path and options.\n */\nexport const BundleInputSchema = z.object(BundleInputShape);\n\nexport type BundleInput = z.infer<typeof BundleInputSchema>;\n","/**\n * Simulate Command Schemas\n *\n * Zod schemas for simulate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Platform schema.\n *\n * @remarks\n * Validates platform type for event simulation.\n */\nexport const PlatformSchema = z\n  .enum(['web', 'server'])\n  .describe('Platform type for event processing');\n\nexport type Platform = z.infer<typeof PlatformSchema>;\n\n/**\n * Simulate options schema.\n *\n * @remarks\n * Options for the programmatic simulate() API.\n */\nexport const SimulateOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const SimulateInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file, URL, or inline JSON string',\n  ),\n  event: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\n      'Event as JSON string, file path, or URL. For sources: { content, trigger?, env? }.',\n    ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n  step: z\n    .string()\n    .optional()\n    .describe(\n      'Step target in type.name format (e.g. \"source.browser\", \"destination.gtag\")',\n    ),\n};\n\n/**\n * Simulate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const SimulateInputSchema = z.object(SimulateInputShape);\n\nexport type SimulateInput = z.infer<typeof SimulateInputSchema>;\n","/**\n * Push Command Schemas\n *\n * Zod schemas for push command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\nimport { PlatformSchema } from './simulate';\n\n/**\n * Push options schema.\n *\n * @remarks\n * Options for the programmatic push() API.\n */\nexport const PushOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type PushOptions = z.infer<typeof PushOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const PushInputShape = {\n  configPath: FilePathSchema.describe('Path to flow configuration file'),\n  event: z.string().min(1).describe('Event as JSON string, file path, or URL'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n};\n\n/**\n * Push input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const PushInputSchema = z.object(PushInputShape);\n\nexport type PushInput = z.infer<typeof PushInputSchema>;\n"],"mappings":"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","names":["z","z","z","z","z","z","z"]}
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/validate.ts","../src/schemas/bundle.ts","../src/schemas/simulate.ts","../src/schemas/push.ts"],"sourcesContent":["/**\n * CLI Schemas\n *\n * Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nexport { PortSchema, FilePathSchema } from './primitives';\n\nexport {\n  ValidationTypeSchema,\n  ValidateOptionsSchema,\n  ValidateInputShape,\n  ValidateInputSchema,\n  type ValidationType,\n  type ValidateOptions,\n  type ValidateInput,\n} from './validate';\n\nexport {\n  BundleOptionsSchema,\n  BundleInputShape,\n  BundleInputSchema,\n  type BundleOptions,\n  type BundleInput,\n} from './bundle';\n\nexport {\n  PlatformSchema,\n  SimulateOptionsSchema,\n  SimulateInputShape,\n  SimulateInputSchema,\n  type Platform,\n  type SimulateOptions,\n  type SimulateInput,\n} from './simulate';\n\nexport {\n  PushOptionsSchema,\n  PushInputShape,\n  PushInputSchema,\n  type PushOptions,\n  type PushInput,\n} from './push';\n","/**\n * CLI Primitive Schemas\n *\n * Basic Zod schemas for CLI parameter validation.\n * Follows walkerOS patterns from @walkeros/core.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Port number schema.\n *\n * @remarks\n * Validates HTTP server port number.\n * Must be integer between 1-65535.\n */\nexport const PortSchema = z\n  .number()\n  .int('Port must be an integer')\n  .min(1, 'Port must be at least 1')\n  .max(65535, 'Port must be at most 65535')\n  .describe('HTTP server port number');\n\n/**\n * File path schema.\n *\n * @remarks\n * Basic string validation for file paths.\n * File existence is checked separately (Zod can't check filesystem).\n */\nexport const FilePathSchema = z\n  .string()\n  .min(1, 'File path cannot be empty')\n  .describe('Path to configuration file');\n","/**\n * Validate Command Schemas\n *\n * Zod schemas for validate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\n\n/**\n * Validation type schema.\n *\n * @remarks\n * Validates the type of validation to perform.\n * - `contract`: Validate a data contract\n * - `event`: Validate a walkerOS event object\n * - `flow`: Validate a flow configuration file\n * - `mapping`: Validate mapping rules\n */\nexport const ValidationTypeSchema = z\n  .enum(['contract', 'event', 'flow', 'mapping'])\n  .describe('Validation type: \"event\", \"flow\", \"mapping\", or \"contract\"');\n\nexport type ValidationType = z.infer<typeof ValidationTypeSchema>;\n\n/**\n * Validate options schema.\n *\n * @remarks\n * Options for the programmatic validate() API.\n */\nexport const ValidateOptionsSchema = z.object({\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\", \"stores.cache\"). Checks the entry in every flow that has it, or only in --flow.',\n    ),\n  strict: z\n    .boolean()\n    .optional()\n    .describe(\n      'Escalate: strict turns warnings and skips into failures (valid is false), contract disagreements error',\n    ),\n  offline: z\n    .boolean()\n    .optional()\n    .describe(\n      'Do not fetch package schemas: step settings are not checked against them, and the result scope says so. Only with type \"flow\" and no path.',\n    ),\n  configDir: z\n    .string()\n    .optional()\n    .describe(\n      \"Directory local `path` packages resolve against. Defaults to the input file's directory; set it when passing a parsed document.\",\n    ),\n});\n\nexport type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const ValidateInputShape = {\n  type: ValidationTypeSchema,\n  input: z\n    .string()\n    .min(1)\n    .describe('JSON string, file path, or URL to validate'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  path: z\n    .string()\n    .optional()\n    .describe(\n      'Entry path for package schema validation (e.g., \"destinations.snowplow\"). Only with type \"flow\": validates the entry against its package JSON Schema in every flow that has it, or only in the given flow.',\n    ),\n  strict: z\n    .boolean()\n    .optional()\n    .describe(\n      'Escalate: strict turns warnings and skips into failures: valid is false (the CLI exits 2), and contract example disagreements become errors. Every check runs with or without it.',\n    ),\n  offline: z\n    .boolean()\n    .optional()\n    .describe(\n      'Do not fetch package schemas: step settings are not checked against them, and details.scope says so. Only with type \"flow\" and no path.',\n    ),\n};\n\n/**\n * Validate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including type and input source.\n */\nexport const ValidateInputSchema = z.object(ValidateInputShape);\n\nexport type ValidateInput = z.infer<typeof ValidateInputSchema>;\n","/**\n * Bundle Command Schemas\n *\n * Zod schemas for bundle command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Bundle options schema.\n *\n * @remarks\n * Options for the programmatic bundle() API.\n */\nexport const BundleOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  cache: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Enable package caching'),\n  flowName: z.string().optional().describe('Flow name for multi-flow configs'),\n});\n\nexport type BundleOptions = z.infer<typeof BundleOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const BundleInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file (JSON or JavaScript), URL, or inline JSON string',\n  ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  stats: z\n    .boolean()\n    .optional()\n    .default(true)\n    .describe('Return bundle statistics'),\n  output: z\n    .string()\n    .optional()\n    .describe('Output file path (defaults to config-defined)'),\n};\n\n/**\n * Bundle input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path and options.\n */\nexport const BundleInputSchema = z.object(BundleInputShape);\n\nexport type BundleInput = z.infer<typeof BundleInputSchema>;\n","/**\n * Simulate Command Schemas\n *\n * Zod schemas for simulate command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\n\n/**\n * Platform schema.\n *\n * @remarks\n * Validates platform type for event simulation.\n */\nexport const PlatformSchema = z\n  .enum(['web', 'server'])\n  .describe('Platform type for event processing');\n\nexport type Platform = z.infer<typeof PlatformSchema>;\n\n/**\n * Simulate options schema.\n *\n * @remarks\n * Options for the programmatic simulate() API.\n */\nexport const SimulateOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const SimulateInputShape = {\n  configPath: FilePathSchema.describe(\n    'Path to flow configuration file, URL, or inline JSON string',\n  ),\n  event: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\n      'Event as JSON string, file path, or URL. For sources: { content, trigger?, env? }.',\n    ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n  step: z\n    .string()\n    .optional()\n    .describe(\n      'Step target in type.name format (e.g. \"source.browser\", \"destination.gtag\")',\n    ),\n};\n\n/**\n * Simulate input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const SimulateInputSchema = z.object(SimulateInputShape);\n\nexport type SimulateInput = z.infer<typeof SimulateInputSchema>;\n","/**\n * Push Command Schemas\n *\n * Zod schemas for push command parameter validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { FilePathSchema } from './primitives';\nimport { PlatformSchema } from './simulate';\n\n/**\n * Push options schema.\n *\n * @remarks\n * Options for the programmatic push() API.\n */\nexport const PushOptionsSchema = z.object({\n  silent: z.boolean().optional().describe('Suppress all output'),\n  verbose: z.boolean().optional().describe('Enable verbose logging'),\n  json: z.boolean().optional().describe('Format output as JSON'),\n});\n\nexport type PushOptions = z.infer<typeof PushOptionsSchema>;\n\n/**\n * Raw shape for MCP SDK compatibility (ZodRawShapeCompat).\n *\n * @remarks\n * MCP SDK's registerTool expects raw shapes (Record<string, ZodType>)\n * rather than ZodObject instances. Define shape first, then wrap.\n */\nexport const PushInputShape = {\n  configPath: FilePathSchema.describe('Path to flow configuration file'),\n  event: z.string().min(1).describe('Event as JSON string, file path, or URL'),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n};\n\n/**\n * Push input schema for MCP tools.\n *\n * @remarks\n * Full input schema including config path, event, and options.\n */\nexport const PushInputSchema = z.object(PushInputShape);\n\nexport type PushInput = z.infer<typeof PushInputSchema>;\n"],"mappings":"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","names":["z","z","z","z","z","z","z"]}

package/dist/examples/README.md

@@ -7,37 +7,24 @@ installation.
 
 ## Usage
 
-Use `walkeros bundle <example>.json` to build any example, then `walkeros run`
-to execute.
-
----
-
-This directory contains example flow configurations demonstrating various
-walkerOS use cases.
-
-## Rebuilding Example Bundles
-
-The `.mjs` bundle files in this directory are pre-built from their corresponding
-`.json` config files. If you update the configs or core packages, rebuild them:
+Build any example with `walkeros bundle`, then start a built server flow with
+`runneros` from
+[`@walkeros/runner`](https://www.npmjs.com/package/@walkeros/runner). The CLI
+builds flows; it does not run them.
 
 ```bash
-cd /workspaces/walkerOS/packages/cli
-
-# Rebuild server-collect
-walkeros bundle examples/server-collect.json --local
-mv server-collect.mjs examples/
+walkeros bundle examples/server-collect.json -o dist/
+npx --package=@walkeros/runner runneros start dist/flow.mjs
+```
 
-# Rebuild web-serve
-walkeros bundle examples/web-serve.json --local
-mv web-serve.js examples/
+A server flow builds to a directory (`flow.mjs`, `package.json` and
+`node_modules/`); a web flow builds to a single `walker.js` for any static host.
+Without `-o`, the bundle is written to stdout.
 
-# Update Docker demos
-cp examples/server-collect.mjs ../docker/demos/demo-collect.mjs
-cp examples/web-serve.js ../docker/demos/demo-serve.mjs
-```
+---
 
-**Important**: Always use `--local` flag when rebuilding examples in the
-devcontainer.
+This directory contains example flow configurations demonstrating various
+walkerOS use cases.
 
 ## Comprehensive Example
 
@@ -46,10 +33,6 @@ devcontainer.
 **Purpose**: Complete reference demonstrating ALL JSON-compatible walkerOS
 features
 
-**Features**: 51 features including variables, mapping (key, map, loop, set),
-transformers (enricher, fingerprint), consent gating, wildcards, ingest
-metadata, and more.
-
 **Architecture**: Two named flows (`web` and `server`) showing full event
 pipeline from browser to server-side forwarding.
 
@@ -59,15 +42,17 @@ Feature Inventory and usage examples.
 **Try it**:
 
 ```bash
-# Web flow (opens browser with demo events)
-walkeros run examples/flow-complete.json --flow web
-
 # Server flow (HTTP collection endpoint)
-walkeros run examples/flow-complete.json --flow server
+walkeros bundle examples/flow-complete.json --flow server -o dist/server/
+npx --package=@walkeros/runner runneros start dist/server/flow.mjs
+
+# Web flow: build walker.js, then serve dist/web/ with any static server
+walkeros bundle examples/flow-complete.json --flow web -o dist/web/
 
-# Both (full pipeline)
-# Terminal 1: walkeros run examples/flow-complete.json --flow server
-# Terminal 2: walkeros run examples/flow-complete.json --flow web
+# Test either flow offline, destinations mocked
+walkeros push examples/flow-complete.json --flow server \
+  --event '{"name":"page view","data":{"title":"Home"}}' \
+  --simulate destination.pubsub
 ```
 
 ---
@@ -76,14 +61,13 @@ walkeros run examples/flow-complete.json --flow server
 
 ### web-serve.json
 
-**Purpose**: Browser bundle that sends events to collector
+**Purpose**: Browser bundle that sends events to a collector
 
 **Features**:
 
 - sourceDemo (generates test events automatically)
 - destinationDemo (console output for debugging)
 - destinationAPI (sends events to http://localhost:8080/collect)
-- Simulates page views and product views
 
 **Use case**: Demo web tracking that connects to server-collect.json for full
 event flow testing
@@ -91,53 +75,9 @@ event flow testing
 **Try it**:
 
 ```bash
-walkeros bundle examples/web-serve.json
-walkeros run examples/web-serve.js -p 3000
-# Open http://localhost:3000 in browser
-```
-
-### web-tracking.json
-
-**Purpose**: Comprehensive browser tracking with multiple analytics platforms
-
-**Features**:
-
-- sourceBrowser (DOM event tracking)
-- destinationAPI → localhost:8080/collect (send to collection server)
-- destinationGtag → Google Analytics 4
-- destinationMeta → Meta Pixel (Facebook)
-- destinationDemo → Console logging
-
-**Event mappings**:
-
-- Page views → GA4 `page_view`, Meta `PageView`
-- Product views → GA4 `view_item`, Meta `ViewContent`
-- Add to cart → GA4 `add_to_cart`, Meta `AddToCart`
-- Purchases → GA4 `purchase`, Meta `Purchase`
-
-**Use case**: Production web tracking with multiple destinations
-
-**Environment variables**:
-
-- `GA4_MEASUREMENT_ID` - Google Analytics 4 measurement ID (default:
-  G-XXXXXXXXXX)
-- `META_PIXEL_ID` - Meta Pixel ID (default: 123456789)
-- `META_TEST_CODE` - Meta test event code (optional)
-
-**Try it**:
-
-```bash
-# Set environment variables
-export GA4_MEASUREMENT_ID="G-YOUR-ID"
-export META_PIXEL_ID="123456789"
-
-# Bundle for browser
-walkeros bundle examples/web-tracking.json --stats
-
-# Simulate events
-walkeros push examples/web-tracking.json \
-  --event '{"name":"product view","data":{"id":"P123","name":"Laptop","price":999}}' \
-  --simulate destination.demo
+walkeros bundle examples/web-serve.json -o dist/web/
+npx serve dist/web -l 3000
+# Load http://localhost:3000/walker.js from a page
 ```
 
 ## Server Examples
@@ -151,7 +91,6 @@ walkeros push examples/web-tracking.json \
 - sourceExpress (HTTP endpoint at /collect)
 - destinationDemo (console logging)
 - CORS enabled for browser requests
-- Health check endpoint
 
 **Use case**: Simple event collector for demo and testing, receives events from
 web-serve.json
@@ -159,123 +98,54 @@ web-serve.json
 **Try it**:
 
 ```bash
-walkeros bundle examples/server-collect.json
-walkeros run examples/server-collect.mjs -p 8080
+walkeros bundle examples/server-collect.json -o dist/server/
+npx --package=@walkeros/runner runneros start dist/server/flow.mjs --port 8080
 
-# In another terminal, send test event:
+# In another terminal, send a test event:
 curl -X POST http://localhost:8080/collect \
   -H "Content-Type: application/json" \
   -d '{"name":"page view","data":{"title":"Test"}}'
 ```
 
-### server-collection.json
-
-**Purpose**: Server-side event collection and forwarding to data platforms
-
-**Features**:
-
-- sourceExpress (HTTP endpoint at /collect)
-- destinationDataManager → Google Tag Manager Server-Side
-- destinationDemo → Console logging
-
-**Event mappings**:
-
-- Page views → GTM `page_view`
-- Product views → GTM `view_item`
-- Add to cart → GTM `add_to_cart`
-- Purchases → GTM `purchase`
-
-**Use case**: Server-side tracking for privacy-compliant data collection
-
-**Environment variables**:
-
-- `GTM_CONTAINER_ID` - GTM Server Container ID (default: GTM-XXXXXXX)
-- `GTM_SERVER_URL` - GTM Server URL (default: https://gtm.example.com)
-
-**Try it**:
+To run the same artifact in Docker, mount the whole directory where the
+`walkeros/flow` image expects it:
 
 ```bash
-# Set environment variables
-export GTM_CONTAINER_ID="GTM-XXXXX"
-export GTM_SERVER_URL="https://your-gtm-server.com"
-
-# Run in Docker
-walkeros run examples/server-collection.json -p 8080
-
-# Send test event (in another terminal)
-curl -X POST http://localhost:8080/collect \
-  -H "Content-Type: application/json" \
-  -d '{
-    "name": "product view",
-    "data": {
-      "id": "P123",
-      "name": "Laptop",
-      "price": 999
-    },
-    "user": {
-      "id": "user_123",
-      "session": "session_456"
-    }
-  }'
+docker run --rm -p 8080:8080 \
+  -v "$PWD/dist/server:/app/flow:ro" \
+  walkeros/flow:<version>
 ```
 
-## Workflow: Web → Server
-
-### Quick Demo Loop (web-serve → server-collect)
+Use a `walkeros/flow` version that ships `runneros`, ideally the same version as
+this CLI. See the [runtime docs](https://www.walkeros.io/docs/apps/runtime).
 
-The simplest way to see the complete event flow:
+## Workflow: Web → Server
 
 **Terminal 1 - Start collector**:
 
 ```bash
-walkeros bundle examples/server-collect.json
-walkeros run examples/server-collect.mjs -p 8080
+walkeros bundle examples/server-collect.json -o dist/server/
+npx --package=@walkeros/runner runneros start dist/server/flow.mjs --port 8080
 ```
 
-**Terminal 2 - Start web server**:
+**Terminal 2 - Serve the web bundle**:
 
 ```bash
-walkeros bundle examples/web-serve.json
-walkeros run examples/web-serve.js -p 3000
+walkeros bundle examples/web-serve.json -o dist/web/
+npx serve dist/web -l 3000
 ```
 
-**Browser**: Open http://localhost:3000
-
 **Events flow**:
 
 ```
 Browser (demo source) → destinationAPI → POST /collect → sourceExpress → destinationDemo (console)
 ```
 
-### Production Pattern (web-tracking → server-collection)
-
-For production with real analytics platforms:
-
-**1. Start collection server**:
-
-```bash
-walkeros run examples/server-collection.json -p 8080
-```
-
-**2. Bundle web tracking** (configured to send to localhost:8080):
-
-```bash
-walkeros bundle examples/web-tracking.json
-```
-
-**3. Deploy** bundle to your website
-
-**4. Events flow**:
-
-```
-Browser → destinationAPI (POST /collect) → sourceExpress → destinationDataManager → GTM Server
-```
-
 ## Creating Custom Examples
 
 ### Flow Configuration Structure
 
-Flow configs use the `Flow.Config` format:
+Flow configs use the `Flow.Json` format:
 
 ```json
 {
@@ -321,44 +191,8 @@ Flow configs use the `Flow.Config` format:
 
 - Platform is set via `config: { "platform": "web" }` (or `"server"`)
 - Each step references its npm package directly via `package`
-- Output path is convention-based: `./dist/walker.js` (web) or
-  `./dist/bundle.mjs` (server)
-
-### Available Sources
-
-**Web**:
-
-- `@walkeros/web-source-browser` → `sourceBrowser` (DOM tracking)
-- `@walkeros/web-source-datalayer` → `sourceDataLayer` (data layer integration)
-- `@walkeros/source-demo` → `sourceDemo` (test events)
-
-**Server**:
-
-- `@walkeros/server-source-express` → `sourceExpress` (HTTP endpoint)
-- `@walkeros/server-source-gcp` → `sourceGCP` (Google Cloud Functions)
-
-### Available Destinations
-
-**Web**:
-
-- `@walkeros/web-destination-api` → `destinationAPI` (HTTP API)
-- `@walkeros/web-destination-gtag` → `destinationGtag` (GA4, GTM, Ads)
-- `@walkeros/web-destination-meta` → `destinationMeta` (Meta Pixel)
-- `@walkeros/web-destination-piwikpro` → `destinationPiwikPro`
-- `@walkeros/web-destination-plausible` → `destinationPlausible`
-
-**Server**:
-
-- `@walkeros/server-destination-datamanager` → `destinationDataManager` (GTM
-  Server-Side)
-- `@walkeros/server-destination-meta` → `destinationMeta` (Meta CAPI)
-- `@walkeros/server-destination-aws` → `destinationAWS`
-- `@walkeros/server-destination-gcp` → `destinationGCP`
-- `@walkeros/server-destination-piwikpro` → `destinationPiwikPro`
-
-**Universal**:
-
-- `@walkeros/destination-demo` → `destinationDemo` (console logging)
+- With `-o dist/`, output is `dist/walker.js` (web) or `dist/flow.mjs` plus
+  `package.json` and `node_modules/` (server)
 
 ## Event Naming Convention
 
@@ -382,7 +216,7 @@ The event name is parsed as: `const [entity, action] = event.split(' ')`
 
 ## Next Steps
 
-1. Try each example with `walkeros bundle` and `walkeros push --simulate`
+1. Try each example with `walkeros push --simulate`, then `walkeros bundle`
 2. Modify examples to match your tracking requirements
 3. Create custom flow files for your use case
-4. Deploy to production
+4. Deploy: `walkeros bundle`, then `runneros start` or the `walkeros/flow` image

package/dist/examples/customers/README.md

@@ -0,0 +1,18 @@
+# customers
+
+Fake demo customers for the `customers` store of `flow-complete.json`
+(`@walkeros/server-store-fs`, structured mode). One file per customer id; the
+content is the customer's record as JSON: lifetime value and segment.
+
+- `cust-42`: `{"ltv":420,"segment":"loyal"}`
+- `cust-1001`: `{"ltv":75.5,"segment":"new"}`
+
+Not covered by root `include`, so no customer data ships in a bundle. `basePath`
+defaults to `./customers`, relative to the working directory: run
+`walkeros push` from `packages/cli/examples`, or set `CUSTOMERS_DIR` to this
+folder's absolute path (always for `runneros start`, which runs inside the
+artifact folder).
+
+In production the store is swapped for a real one, e.g.
+`@walkeros/server-store-sheets` or a GCS store; the `loadUser` step does not
+change.

package/dist/examples/customers/cust-1001

@@ -0,0 +1 @@
+{"ltv":75.5,"segment":"new"}

package/dist/examples/customers/cust-42

@@ -0,0 +1 @@
+{"ltv":420,"segment":"loyal"}