@walkeros/cli 2.0.0 → 2.1.0

package/dist/dev.d.ts

@@ -7,19 +7,6 @@ import { z } from '@walkeros/core/dev';
  * Follows walkerOS patterns from @walkeros/core.
  */
 
-/**
- * Run mode schema.
- *
- * @remarks
- * Validates CLI run mode for the `run` command.
- * - `collect`: Run as event collector
- * - `serve`: Run as HTTP server
- */
-declare const RunModeSchema: z.ZodEnum<{
-    collect: "collect";
-    serve: "serve";
-}>;
-type RunMode = z.infer<typeof RunModeSchema>;
 /**
  * Port number schema.
  *
@@ -50,10 +37,6 @@ declare const FilePathSchema: z.ZodString;
  * Validates all options for the `walkeros run` command.
  */
 declare const RunOptionsSchema: z.ZodObject<{
-    mode: z.ZodEnum<{
-        collect: "collect";
-        serve: "serve";
-    }>;
     flow: z.ZodString;
     port: z.ZodDefault<z.ZodNumber>;
     flowName: z.ZodOptional<z.ZodString>;
@@ -71,15 +54,17 @@ type RunOptions = z.infer<typeof RunOptionsSchema>;
  *
  * @remarks
  * Validates the type of validation to perform.
+ * - `contract`: Validate a data contract
  * - `event`: Validate a walkerOS event object
  * - `flow`: Validate a flow configuration file
  * - `mapping`: Validate mapping rules
  */
-declare const ValidationTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+declare const ValidationTypeSchema: z.ZodEnum<{
     flow: "flow";
+    contract: "contract";
     event: "event";
     mapping: "mapping";
-}>, z.ZodString]>;
+}>;
 type ValidationType = z.infer<typeof ValidationTypeSchema>;
 /**
  * Validate options schema.
@@ -89,6 +74,7 @@ type ValidationType = z.infer<typeof ValidationTypeSchema>;
  */
 declare const ValidateOptionsSchema: z.ZodObject<{
     flow: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
 /**
@@ -99,13 +85,15 @@ type ValidateOptions = z.infer<typeof ValidateOptionsSchema>;
  * rather than ZodObject instances. Define shape first, then wrap.
  */
 declare const ValidateInputShape: {
-    type: z.ZodUnion<readonly [z.ZodEnum<{
+    type: z.ZodEnum<{
         flow: "flow";
+        contract: "contract";
         event: "event";
         mapping: "mapping";
-    }>, z.ZodString]>;
+    }>;
     input: z.ZodString;
     flow: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 };
 /**
  * Validate input schema for MCP tools.
@@ -114,13 +102,15 @@ declare const ValidateInputShape: {
  * Full input schema including type and input source.
  */
 declare const ValidateInputSchema: z.ZodObject<{
-    type: z.ZodUnion<readonly [z.ZodEnum<{
+    type: z.ZodEnum<{
         flow: "flow";
+        contract: "contract";
         event: "event";
         mapping: "mapping";
-    }>, z.ZodString]>;
+    }>;
     input: z.ZodString;
     flow: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type ValidateInput = z.infer<typeof ValidateInputSchema>;
 
@@ -209,12 +199,14 @@ type SimulateOptions = z.infer<typeof SimulateOptionsSchema>;
  */
 declare const SimulateInputShape: {
     configPath: z.ZodString;
-    event: z.ZodString;
+    event: z.ZodOptional<z.ZodString>;
     flow: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<{
         web: "web";
         server: "server";
     }>>;
+    example: z.ZodOptional<z.ZodString>;
+    step: z.ZodOptional<z.ZodString>;
 };
 /**
  * Simulate input schema for MCP tools.
@@ -224,12 +216,14 @@ declare const SimulateInputShape: {
  */
 declare const SimulateInputSchema: z.ZodObject<{
     configPath: z.ZodString;
-    event: z.ZodString;
+    event: z.ZodOptional<z.ZodString>;
     flow: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<{
         web: "web";
         server: "server";
     }>>;
+    example: z.ZodOptional<z.ZodString>;
+    step: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type SimulateInput = z.infer<typeof SimulateInputSchema>;
 
@@ -305,8 +299,6 @@ declare const index_PushInputSchema: typeof PushInputSchema;
 declare const index_PushInputShape: typeof PushInputShape;
 type index_PushOptions = PushOptions;
 declare const index_PushOptionsSchema: typeof PushOptionsSchema;
-type index_RunMode = RunMode;
-declare const index_RunModeSchema: typeof RunModeSchema;
 type index_RunOptions = RunOptions;
 declare const index_RunOptionsSchema: typeof RunOptionsSchema;
 type index_SimulateInput = SimulateInput;
@@ -322,7 +314,7 @@ declare const index_ValidateOptionsSchema: typeof ValidateOptionsSchema;
 type index_ValidationType = ValidationType;
 declare const index_ValidationTypeSchema: typeof ValidationTypeSchema;
 declare namespace index {
-  export { type index_BundleInput as BundleInput, index_BundleInputSchema as BundleInputSchema, index_BundleInputShape as BundleInputShape, type index_BundleOptions as BundleOptions, index_BundleOptionsSchema as BundleOptionsSchema, index_FilePathSchema as FilePathSchema, type index_Platform as Platform, index_PlatformSchema as PlatformSchema, index_PortSchema as PortSchema, type index_PushInput as PushInput, index_PushInputSchema as PushInputSchema, index_PushInputShape as PushInputShape, type index_PushOptions as PushOptions, index_PushOptionsSchema as PushOptionsSchema, type index_RunMode as RunMode, index_RunModeSchema as RunModeSchema, type index_RunOptions as RunOptions, index_RunOptionsSchema as RunOptionsSchema, type index_SimulateInput as SimulateInput, index_SimulateInputSchema as SimulateInputSchema, index_SimulateInputShape as SimulateInputShape, type index_SimulateOptions as SimulateOptions, index_SimulateOptionsSchema as SimulateOptionsSchema, type index_ValidateInput as ValidateInput, index_ValidateInputSchema as ValidateInputSchema, index_ValidateInputShape as ValidateInputShape, type index_ValidateOptions as ValidateOptions, index_ValidateOptionsSchema as ValidateOptionsSchema, type index_ValidationType as ValidationType, index_ValidationTypeSchema as ValidationTypeSchema };
+  export { type index_BundleInput as BundleInput, index_BundleInputSchema as BundleInputSchema, index_BundleInputShape as BundleInputShape, type index_BundleOptions as BundleOptions, index_BundleOptionsSchema as BundleOptionsSchema, index_FilePathSchema as FilePathSchema, type index_Platform as Platform, index_PlatformSchema as PlatformSchema, index_PortSchema as PortSchema, type index_PushInput as PushInput, index_PushInputSchema as PushInputSchema, index_PushInputShape as PushInputShape, type index_PushOptions as PushOptions, index_PushOptionsSchema as PushOptionsSchema, type index_RunOptions as RunOptions, index_RunOptionsSchema as RunOptionsSchema, type index_SimulateInput as SimulateInput, index_SimulateInputSchema as SimulateInputSchema, index_SimulateInputShape as SimulateInputShape, type index_SimulateOptions as SimulateOptions, index_SimulateOptionsSchema as SimulateOptionsSchema, type index_ValidateInput as ValidateInput, index_ValidateInputSchema as ValidateInputSchema, index_ValidateInputShape as ValidateInputShape, type index_ValidateOptions as ValidateOptions, index_ValidateOptionsSchema as ValidateOptionsSchema, type index_ValidationType as ValidationType, index_ValidationTypeSchema as ValidationTypeSchema };
 }
 
 export { index as schemas };

package/dist/dev.js

@@ -16,7 +16,6 @@ __export(schemas_exports, {
   PushInputSchema: () => PushInputSchema,
   PushInputShape: () => PushInputShape,
   PushOptionsSchema: () => PushOptionsSchema,
-  RunModeSchema: () => RunModeSchema,
   RunOptionsSchema: () => RunOptionsSchema,
   SimulateInputSchema: () => SimulateInputSchema,
   SimulateInputShape: () => SimulateInputShape,
@@ -29,14 +28,12 @@ __export(schemas_exports, {
 
 // src/schemas/primitives.ts
 import { z } from "@walkeros/core/dev";
-var RunModeSchema = z.enum(["collect", "serve"]).describe("CLI run mode: collect events or serve HTTP");
 var PortSchema = z.number().int("Port must be an integer").min(1, "Port must be at least 1").max(65535, "Port must be at most 65535").describe("HTTP server port number");
 var FilePathSchema = z.string().min(1, "File path cannot be empty").describe("Path to configuration file");
 
 // src/schemas/run.ts
 import { z as z2 } from "@walkeros/core/dev";
 var RunOptionsSchema = z2.object({
-  mode: RunModeSchema,
   flow: FilePathSchema,
   port: PortSchema.default(8080),
   flowName: z2.string().optional().describe("Specific flow name to run")
@@ -44,19 +41,20 @@ var RunOptionsSchema = z2.object({
 
 // src/schemas/validate.ts
 import { z as z3 } from "@walkeros/core/dev";
-var ValidationTypeSchema = z3.union([
-  z3.enum(["event", "flow", "mapping"]),
-  z3.string().regex(/^(destinations|sources|transformers)\.\w+$|^\w+$/)
-]).describe(
-  'Validation type: "event", "flow", "mapping", or dot-notation path (e.g., "destinations.snowplow") to validate a specific entry against its package schema'
-);
+var ValidationTypeSchema = z3.enum(["contract", "event", "flow", "mapping"]).describe('Validation type: "event", "flow", "mapping", or "contract"');
 var ValidateOptionsSchema = z3.object({
-  flow: z3.string().optional().describe("Flow name for multi-flow configs")
+  flow: z3.string().optional().describe("Flow name for multi-flow configs"),
+  path: z3.string().optional().describe(
+    'Entry path for package schema validation (e.g., "destinations.snowplow", "sources.browser")'
+  )
 });
 var ValidateInputShape = {
   type: ValidationTypeSchema,
   input: z3.string().min(1).describe("JSON string, file path, or URL to validate"),
-  flow: z3.string().optional().describe("Flow name for multi-flow configs")
+  flow: z3.string().optional().describe("Flow name for multi-flow configs"),
+  path: z3.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.'
+  )
 };
 var ValidateInputSchema = z3.object(ValidateInputShape);
 
@@ -89,9 +87,17 @@ var SimulateOptionsSchema = z5.object({
 });
 var SimulateInputShape = {
   configPath: FilePathSchema.describe("Path to flow configuration file"),
-  event: z5.string().min(1).describe("Event as JSON string, file path, or URL"),
+  event: z5.string().min(1).optional().describe(
+    "Event as JSON string, file path, or URL. Optional when example is provided."
+  ),
   flow: z5.string().optional().describe("Flow name for multi-flow configs"),
-  platform: PlatformSchema.optional().describe("Override platform detection")
+  platform: PlatformSchema.optional().describe("Override platform detection"),
+  example: z5.string().optional().describe(
+    'Name of a step example to use as event input (uses its "in" value)'
+  ),
+  step: z5.string().optional().describe(
+    'Step target in type.name format (e.g. "destination.gtag") to narrow example lookup'
+  )
 };
 var SimulateInputSchema = z5.object(SimulateInputShape);
 

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/run.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 {\n  RunModeSchema,\n  PortSchema,\n  FilePathSchema,\n  type RunMode,\n} from './primitives';\n\nexport { RunOptionsSchema, type RunOptions } from './run';\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 * Run mode schema.\n *\n * @remarks\n * Validates CLI run mode for the `run` command.\n * - `collect`: Run as event collector\n * - `serve`: Run as HTTP server\n */\nexport const RunModeSchema = z\n  .enum(['collect', 'serve'])\n  .describe('CLI run mode: collect events or serve HTTP');\n\nexport type RunMode = z.infer<typeof RunModeSchema>;\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 * Run Command Schemas\n *\n * Zod schemas for run command options validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { RunModeSchema, PortSchema, FilePathSchema } from './primitives';\n\n/**\n * Run command options schema.\n *\n * @remarks\n * Validates all options for the `walkeros run` command.\n */\nexport const RunOptionsSchema = z.object({\n  mode: RunModeSchema,\n  flow: FilePathSchema,\n  port: PortSchema.default(8080),\n  flowName: z.string().optional().describe('Specific flow name to run'),\n});\n\nexport type RunOptions = z.infer<typeof RunOptionsSchema>;\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 * - `event`: Validate a walkerOS event object\n * - `flow`: Validate a flow configuration file\n * - `mapping`: Validate mapping rules\n */\nexport const ValidationTypeSchema = z\n  .union([\n    z.enum(['event', 'flow', 'mapping']),\n    z.string().regex(/^(destinations|sources|transformers)\\.\\w+$|^\\w+$/),\n  ])\n  .describe(\n    'Validation type: \"event\", \"flow\", \"mapping\", or dot-notation path ' +\n      '(e.g., \"destinations.snowplow\") to validate a specific entry against its package schema',\n  );\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});\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};\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)',\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('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 * 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","z","z"]}
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/primitives.ts","../src/schemas/run.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 { RunOptionsSchema, type RunOptions } from './run';\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 * Run Command Schemas\n *\n * Zod schemas for run command options validation.\n */\n\nimport { z } from '@walkeros/core/dev';\nimport { PortSchema, FilePathSchema } from './primitives';\n\n/**\n * Run command options schema.\n *\n * @remarks\n * Validates all options for the `walkeros run` command.\n */\nexport const RunOptionsSchema = z.object({\n  flow: FilePathSchema,\n  port: PortSchema.default(8080),\n  flowName: z.string().optional().describe('Specific flow name to run'),\n});\n\nexport type RunOptions = z.infer<typeof RunOptionsSchema>;\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)',\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('Path to flow configuration file'),\n  event: z\n    .string()\n    .min(1)\n    .optional()\n    .describe(\n      'Event as JSON string, file path, or URL. Optional when example is provided.',\n    ),\n  flow: z.string().optional().describe('Flow name for multi-flow configs'),\n  platform: PlatformSchema.optional().describe('Override platform detection'),\n  example: z\n    .string()\n    .optional()\n    .describe(\n      'Name of a step example to use as event input (uses its \"in\" value)',\n    ),\n  step: z\n    .string()\n    .optional()\n    .describe(\n      'Step target in type.name format (e.g. \"destination.gtag\") to narrow example lookup',\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":";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,SAAS,SAAS;AASX,IAAM,aAAa,EACvB,OAAO,EACP,IAAI,yBAAyB,EAC7B,IAAI,GAAG,yBAAyB,EAChC,IAAI,OAAO,4BAA4B,EACvC,SAAS,yBAAyB;AAS9B,IAAM,iBAAiB,EAC3B,OAAO,EACP,IAAI,GAAG,2BAA2B,EAClC,SAAS,4BAA4B;;;AC3BxC,SAAS,KAAAA,UAAS;AASX,IAAM,mBAAmBC,GAAE,OAAO;AAAA,EACvC,MAAM;AAAA,EACN,MAAM,WAAW,QAAQ,IAAI;AAAA,EAC7B,UAAUA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,2BAA2B;AACtE,CAAC;;;ACbD,SAAS,KAAAC,UAAS;AAYX,IAAM,uBAAuBA,GACjC,KAAK,CAAC,YAAY,SAAS,QAAQ,SAAS,CAAC,EAC7C,SAAS,4DAA4D;AAUjE,IAAM,wBAAwBA,GAAE,OAAO;AAAA,EAC5C,MAAMA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvE,MAAMA,GACH,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ,CAAC;AAWM,IAAM,qBAAqB;AAAA,EAChC,MAAM;AAAA,EACN,OAAOA,GACJ,OAAO,EACP,IAAI,CAAC,EACL,SAAS,4CAA4C;AAAA,EACxD,MAAMA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvE,MAAMA,GACH,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ;AAQO,IAAM,sBAAsBA,GAAE,OAAO,kBAAkB;;;AChE9D,SAAS,KAAAC,UAAS;AASX,IAAM,sBAAsBC,GAAE,OAAO;AAAA,EAC1C,QAAQA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,qBAAqB;AAAA,EAC7D,SAASA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EACjE,OAAOA,GACJ,QAAQ,EACR,SAAS,EACT,QAAQ,IAAI,EACZ,SAAS,0BAA0B;AAAA,EACtC,OAAOA,GACJ,QAAQ,EACR,SAAS,EACT,QAAQ,IAAI,EACZ,SAAS,wBAAwB;AAAA,EACpC,UAAUA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAC7E,CAAC;AAWM,IAAM,mBAAmB;AAAA,EAC9B,YAAY,eAAe;AAAA,IACzB;AAAA,EACF;AAAA,EACA,MAAMA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvE,OAAOA,GACJ,QAAQ,EACR,SAAS,EACT,QAAQ,IAAI,EACZ,SAAS,0BAA0B;AAAA,EACtC,QAAQA,GACL,OAAO,EACP,SAAS,EACT,SAAS,+CAA+C;AAC7D;AAQO,IAAM,oBAAoBA,GAAE,OAAO,gBAAgB;;;ACxD1D,SAAS,KAAAC,UAAS;AASX,IAAM,iBAAiBC,GAC3B,KAAK,CAAC,OAAO,QAAQ,CAAC,EACtB,SAAS,oCAAoC;AAUzC,IAAM,wBAAwBA,GAAE,OAAO;AAAA,EAC5C,QAAQA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,qBAAqB;AAAA,EAC7D,SAASA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EACjE,MAAMA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAC/D,CAAC;AAWM,IAAM,qBAAqB;AAAA,EAChC,YAAY,eAAe,SAAS,iCAAiC;AAAA,EACrE,OAAOA,GACJ,OAAO,EACP,IAAI,CAAC,EACL,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,MAAMA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvE,UAAU,eAAe,SAAS,EAAE,SAAS,6BAA6B;AAAA,EAC1E,SAASA,GACN,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AAAA,EACF,MAAMA,GACH,OAAO,EACP,SAAS,EACT;AAAA,IACC;AAAA,EACF;AACJ;AAQO,IAAM,sBAAsBA,GAAE,OAAO,kBAAkB;;;ACnE9D,SAAS,KAAAC,UAAS;AAUX,IAAM,oBAAoBC,GAAE,OAAO;AAAA,EACxC,QAAQA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,qBAAqB;AAAA,EAC7D,SAASA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,wBAAwB;AAAA,EACjE,MAAMA,GAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,uBAAuB;AAC/D,CAAC;AAWM,IAAM,iBAAiB;AAAA,EAC5B,YAAY,eAAe,SAAS,iCAAiC;AAAA,EACrE,OAAOA,GAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,yCAAyC;AAAA,EAC3E,MAAMA,GAAE,OAAO,EAAE,SAAS,EAAE,SAAS,kCAAkC;AAAA,EACvE,UAAU,eAAe,SAAS,EAAE,SAAS,6BAA6B;AAC5E;AAQO,IAAM,kBAAkBA,GAAE,OAAO,cAAc;","names":["z","z","z","z","z","z","z","z","z"]}

package/dist/examples/README.md

@@ -60,14 +60,14 @@ Feature Inventory and usage examples.
 
 ```bash
 # Web flow (opens browser with demo events)
-walkeros serve examples/flow-complete.json --flow web
+walkeros run examples/flow-complete.json --flow web
 
 # Server flow (HTTP collection endpoint)
 walkeros run examples/flow-complete.json --flow server
 
 # Both (full pipeline)
 # Terminal 1: walkeros run examples/flow-complete.json --flow server
-# Terminal 2: walkeros serve examples/flow-complete.json --flow web
+# Terminal 2: walkeros run examples/flow-complete.json --flow web
 ```
 
 ---
@@ -92,7 +92,7 @@ event flow testing
 
 ```bash
 walkeros bundle examples/web-serve.json
-walkeros run serve examples/web-serve.js -p 3000
+walkeros run examples/web-serve.js -p 3000
 # Open http://localhost:3000 in browser
 ```
 
@@ -159,7 +159,7 @@ web-serve.json
 
 ```bash
 walkeros bundle examples/server-collect.json
-walkeros run collect examples/server-collect.mjs -p 8080
+walkeros run examples/server-collect.mjs -p 8080
 
 # In another terminal, send test event:
 curl -X POST http://localhost:8080/collect \
@@ -199,7 +199,7 @@ export GTM_CONTAINER_ID="GTM-XXXXX"
 export GTM_SERVER_URL="https://your-gtm-server.com"
 
 # Run in Docker
-walkeros run collect examples/server-collection.json -p 8080
+walkeros run examples/server-collection.json -p 8080
 
 # Send test event (in another terminal)
 curl -X POST http://localhost:8080/collect \
@@ -228,14 +228,14 @@ The simplest way to see the complete event flow:
 
 ```bash
 walkeros bundle examples/server-collect.json
-walkeros run collect examples/server-collect.mjs -p 8080
+walkeros run examples/server-collect.mjs -p 8080
 ```
 
 **Terminal 2 - Start web server**:
 
 ```bash
 walkeros bundle examples/web-serve.json
-walkeros run serve examples/web-serve.js -p 3000
+walkeros run examples/web-serve.js -p 3000
 ```
 
 **Browser**: Open http://localhost:3000
@@ -253,7 +253,7 @@ For production with real analytics platforms:
 **1. Start collection server**:
 
 ```bash
-walkeros run collect examples/server-collection.json -p 8080
+walkeros run examples/server-collection.json -p 8080
 ```
 
 **2. Bundle web tracking** (configured to send to localhost:8080):

package/dist/examples/flow-complete.json

@@ -318,6 +318,89 @@
                 }
               }
             }
+          },
+          "examples": {
+            "page-view": {
+              "in": {
+                "name": "page view",
+                "data": { "title": "Home", "path": "/" },
+                "entity": "page",
+                "action": "view"
+              },
+              "mapping": {
+                "name": "page_view",
+                "data": {
+                  "map": {
+                    "page_title": "data.title",
+                    "page_location": "data.path"
+                  }
+                }
+              },
+              "out": [
+                "event",
+                "page_view",
+                { "page_title": "Home", "page_location": "/" }
+              ]
+            },
+            "product-add": {
+              "in": {
+                "name": "product add",
+                "data": {
+                  "id": "SKU-001",
+                  "name": "Blue Shirt",
+                  "price": 49.99,
+                  "currency": "EUR",
+                  "quantity": 2
+                },
+                "entity": "product",
+                "action": "add"
+              },
+              "mapping": {
+                "name": "add_to_cart",
+                "data": {
+                  "map": {
+                    "currency": { "key": "data.currency", "value": "EUR" },
+                    "value": "data.price",
+                    "items": {
+                      "loop": [
+                        "this",
+                        {
+                          "map": {
+                            "item_id": "data.id",
+                            "item_name": "data.name",
+                            "quantity": { "key": "data.quantity", "value": 1 }
+                          }
+                        }
+                      ]
+                    }
+                  }
+                }
+              },
+              "out": [
+                "event",
+                "add_to_cart",
+                {
+                  "currency": "EUR",
+                  "value": 49.99,
+                  "items": [
+                    {
+                      "item_id": "SKU-001",
+                      "item_name": "Blue Shirt",
+                      "quantity": 2
+                    }
+                  ]
+                }
+              ]
+            },
+            "test-ignored": {
+              "in": {
+                "name": "test debug",
+                "data": { "message": "This should be ignored" },
+                "entity": "test",
+                "action": "debug"
+              },
+              "out": false
+            }
           }
         },
         "api": {
@@ -417,6 +500,25 @@
               "context.language": "headers.accept-language",
               "context.referer": "headers.referer"
             }
+          },
+          "examples": {
+            "post-event": {
+              "in": {
+                "method": "POST",
+                "path": "/collect",
+                "headers": { "content-type": "application/json" },
+                "body": {
+                  "name": "page view",
+                  "data": { "title": "Home", "url": "https://example.com" }
+                }
+              },
+              "out": {
+                "name": "page view",
+                "data": { "title": "Home", "url": "https://example.com" },
+                "entity": "page",
+                "action": "view"
+              }
+            }
           }
         }
       },
@@ -427,7 +529,32 @@
             "push": "$code:(event) => event.name.startsWith('internal_') || event.name.startsWith('debug_') ? false : event"
           },
           "next": "fingerprint",
-          "config": {}
+          "config": {},
+          "examples": {
+            "passes-normal": {
+              "in": {
+                "name": "page view",
+                "data": { "title": "Home" },
+                "entity": "page",
+                "action": "view"
+              },
+              "out": {
+                "name": "page view",
+                "data": { "title": "Home" },
+                "entity": "page",
+                "action": "view"
+              }
+            },
+            "filters-internal": {
+              "in": {
+                "name": "internal_heartbeat",
+                "data": {},
+                "entity": "internal",
+                "action": "heartbeat"
+              },
+              "out": false
+            }
+          }
         },
         "fingerprint": {
           "package": "@walkeros/server-transformer-fingerprint",
@@ -610,6 +737,42 @@
                 }
               }
             }
+          },
+          "examples": {
+            "purchase": {
+              "in": {
+                "name": "order complete",
+                "data": {
+                  "id": "ORD-123",
+                  "total": 149.97,
+                  "currency": "EUR"
+                },
+                "entity": "order",
+                "action": "complete"
+              },
+              "mapping": {
+                "name": "Purchase",
+                "data": {
+                  "map": {
+                    "value": "data.total",
+                    "currency": { "key": "data.currency", "value": "EUR" },
+                    "order_id": "data.id"
+                  }
+                }
+              },
+              "out": {
+                "data": [
+                  {
+                    "event_name": "Purchase",
+                    "custom_data": {
+                      "value": 149.97,
+                      "currency": "EUR",
+                      "order_id": "ORD-123"
+                    }
+                  }
+                ]
+              }
+            }
           }
         },
         "demo": {

package/dist/examples/flow-complete.md

@@ -33,7 +33,7 @@ complete event tracking architecture.
 
 ```bash
 cd walkerOS
-npx walkeros serve packages/cli/examples/flow-complete.json --flow web
+npx walkeros run packages/cli/examples/flow-complete.json --flow web
 # Open http://localhost:3000 - demo events fire automatically
 ```
 
@@ -64,7 +64,7 @@ curl -X POST http://localhost:8080/collect \
 npx walkeros run packages/cli/examples/flow-complete.json --flow server
 
 # Terminal 2: Start web (sends to server via API destination)
-npx walkeros serve packages/cli/examples/flow-complete.json --flow web
+npx walkeros run packages/cli/examples/flow-complete.json --flow web
 ```
 
 ---

package/dist/examples/flow-selfhost-test.json

@@ -0,0 +1,24 @@
+{
+  "version": 1,
+  "flows": {
+    "default": {
+      "server": {},
+      "packages": {
+        "@walkeros/collector": {}
+      },
+      "sources": {
+        "http": {
+          "package": "@walkeros/server-source-express",
+          "primary": true,
+          "config": {
+            "settings": {
+              "port": 8080,
+              "cors": true
+            }
+          }
+        }
+      },
+      "destinations": {}
+    }
+  }
+}