@walkeros/cli 4.7.0-next-1790245733116 → 4.7.0-next-1790722899482

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @walkeros/cli
 
-## 4.7.0-next-1790245733116
+## 4.7.0-next-1790722899482
 
 ### Minor Changes
 
@@ -9,58 +9,94 @@
   `config.bundle.env`; they must be literal strings and supply `$env` in web
   bundles. Step packages, overrides and their dependencies must now come from
   the npm registry: git, file and URL specs are rejected.
-- 06b498a: `@walkeros/cli` no longer depends on `express`, `cors` or `p-limit`.
-  Nothing in the CLI imported them, so an install is smaller and pulls fewer
-  transitive packages into your project. Commands and options are unchanged.
-- ef02916: The `findExample` and `compareOutput` exports and the
-  `ExampleLookupResult` type were removed from `@walkeros/cli`.
-- f5a1cfd: `walkeros validate` now reports unknown route targets as
-  `UNKNOWN_ROUTE_TARGET` errors and warns about entries after an unconditional
-  `stop` and about arrays that only pick the first match.
-  `walkeros push --simulate collector.default` runs enrichment plus
-  `collector.next`, `--mock collector.next.<id>` mocks one of its steps, and
-  simulating a transformer now continues through its `next`.
-- ef02916: `walkeros validate` now reports a file path that does not exist or
-  does not contain valid JSON as an input error with exit code 3, instead of
-  validating the path string and failing the schema with exit code 1. Cross-step
-  example checks now include an object `out`, such as a source example that
-  produces a single walkerOS event, so incompatible connections are reported as
-  errors.
-- 06b498a: `walkeros run` is removed, with no alias. Build a flow with
-  `walkeros bundle`, then start the prebuilt artifact with
-  `runneros start dist/flow.mjs`. The new `@walkeros/runner` package ships the
-  `runneros` binary without esbuild, pacote, jsdom or nft, and the
-  `walkeros/flow` image now runs it.
+- 74821ed: The canonical `flow-complete.json` example is rewritten as one tested
+  ecommerce setup with web, server and warehouse flows and a 15-chapter guide.
+  The new `flowCompleteManifest` export from `@walkeros/cli/examples` names
+  every feature by a stable id with a JSON Pointer into the file, so docs and
+  tools can reference it.
+- 06b498a: `walkeros run` is removed. Build with `walkeros bundle`, then start
+  the artifact with `runneros start dist/flow.mjs` from the new
+  `@walkeros/runner` package, which the `walkeros/flow` image now runs. The CLI
+  no longer depends on `express`, `cors` or `p-limit`. New `@walkeros/core/node`
+  entry with the Node-only logger, redaction and temp-path helpers.
+- 74821ed: `walkeros push --simulate` prints each step's mapping and vendor
+  calls (`simulations` in `--json`) and reports init or push failures. New
+  flags: `--ingest`, `--consent` (MCP `state.consent`), `--command` for command
+  examples, `--simulate collector.default` and `--mock collector.next.<id>`. A
+  destination that sent nothing says why in `skipped`. `toPrintable` is
+  exported.
+- 74821ed: Simulate records every vendor call through one recorder, `observeEnv`
+  from `@walkeros/core`, and runs offline: BigQuery, Data Manager and the
+  Sheets, GCS and S3 stores reach the network through `env`. Client and `Env`
+  types of BigQuery, Firehose, PostHog, SQS and Pub/Sub are structural.
+  `@walkeros/cli` exports `resolveExportName` and `selectDevExamples` and drops
+  `findExample` and `compareOutput`.
+- 74821ed: Simulate starts only the simulated step, and a simulated transformer
+  continues through its `next`. Source simulations list the commands a source
+  issues as `elb` calls; `--page-url` sets the web page. Express flows need no
+  port. Packages with several exports use per-export examples and mocks, and a
+  destination without a mock env is refused instead of calling the vendor.
+- 74821ed: `walkeros validate` reports a missing or non-JSON input file as an
+  input error (exit 3). `--path` no longer fails on `uri` or email formats, nor
+  warns on mapping loops. The published Flow JSON Schema adds `config.observe`
+  and drops step-level `validate`. The Usercentrics schema now lists
+  `apiVersion` and `v3EventName`.
+- 74821ed: `walkeros validate` prints a `Scope:` line and returns
+  `details.scope` (flows and checks) instead of `details.validatedFlow`;
+  `details.skipped` lists checks that did not run, such as an unreachable
+  package schema (exit 0). `--path` and `--flow` narrow every check; paths start
+  with `flows.<flow>.`. Errors and warnings carry stable codes, settings errors
+  `ENTRY_SCHEMA` plus `keyword`. `--path` or `--flow` with a non-flow `-t`
+  exits 3.
+- 74821ed: `walkeros validate` warns on malformed or mid-string `$flow.`,
+  `$store.`, `$secret.` and `$contract.` references, paths that can never
+  resolve, unknown route targets, and routes shadowed by a `stop` or first
+  match. Contracts bind only on `@walkeros/transformer-validate` steps.
+  Cross-step checks include an object `out`.
 
 ### Patch Changes
 
-- ef02916: `walkeros validate --path` no longer fails with
-  `unknown format "uri" ignored` for packages whose settings use URL or email
-  fields. Settings are still checked for structure, types and patterns; string
-  formats such as `uri` are not checked.
-- 8f8aea6: Every step field now survives bundling. A transformer with only
-  `state` or `mapping`, and inline code steps with `cache` or `state`, were
-  silently dropped from the bundle before and did nothing at runtime. `mapping`
-  is now a typed transformer field, and bundles no longer carry `variables`.
-- Updated dependencies [57788bc]
+- 74821ed: Server builds served from the build cache now copy the root `include`
+  folders; web builds ignore `include` and log it. An unused package in
+  `bundle.packages` warns instead of failing the build. Cache entries are
+  written atomically, so an interrupt no longer leaves a broken entry, and
+  `walkeros cache clear` removes leftovers. Temp dirs are
+  `<tmp>/walkeros/<kind>/<id>`.
+- 74821ed: A flow's own log lines now go through the CLI logger: its debug lines
+  need `--verbose`, and they go to stderr with `--json`. Version numbers are no
+  longer masked as tokens, so `walkeros deploy` shows the image tag and
+  `bundle --stats` shows package versions. Paths under the system temp directory
+  print as `$TMPDIR/...`.
+- 74821ed: The values of secrets a flow references are masked in simulate
+  output, CLI logs and flow logs, also inside JSON strings. The runtime masks
+  the secret values it fetches in every log path, heartbeats and `--json` errors
+  included. Simulate output also scrubs credential-named fields, `Authorization`
+  headers and PEM keys. `scrubSecrets` takes `known`; the CLI logger takes
+  `knownSecrets`.
+- 74821ed: `state` paths resolve against `{ event, ingest }` and need an
+  `event.` or `ingest.` prefix; a `get` can write into `ingest`, and an
+  unresolvable key warns. Every step field now survives bundling: transformers
+  with only `state` or `mapping`, and code steps with `cache` or `state`, were
+  silently dropped before. `buildCacheContext` is renamed `createMappingRoot`.
+- Updated dependencies [74821ed]
 - Updated dependencies [06b498a]
-- Updated dependencies [2aebc53]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [ef02916]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
 - Updated dependencies [06b498a]
-- Updated dependencies [ef02916]
-- Updated dependencies [2aebc53]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [2aebc53]
-- Updated dependencies [8f8aea6]
-- Updated dependencies [2aebc53]
-- Updated dependencies [2aebc53]
-  - @walkeros/core@4.7.0-next-1790245733116
-  - @walkeros/server-core@4.7.0-next-1790245733116
-  - @walkeros/collector@4.7.0-next-1790245733116
-  - @walkeros/transformer-validate@4.7.0-next-1790245733116
-  - @walkeros/server-destination-api@4.7.0-next-1790245733116
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+  - @walkeros/collector@4.7.0-next-1790722899482
+  - @walkeros/core@4.7.0-next-1790722899482
+  - @walkeros/server-core@4.7.0-next-1790722899482
+  - @walkeros/transformer-validate@4.7.0-next-1790722899482
+  - @walkeros/server-destination-api@4.7.0-next-1790722899482
 
 ## 4.6.1
 

package/README.md

@@ -22,14 +22,20 @@ npm install -g @walkeros/cli
 ## Quick start
 
 ```bash
-# Bundle a flow configuration
-walkeros bundle flow.json
-
 # Test with simulated events (no real API calls)
 walkeros push flow.json --event '{"name":"product view"}' --simulate destination.demo
 
-# Run a collection server locally
-walkeros run dist/flow.mjs --port 3000
+# Bundle a flow configuration into dist/
+walkeros bundle flow.json -o dist/
+```
+
+The CLI builds flows; it does not run them. Start a built server flow with
+`runneros` from
+[`@walkeros/runner`](https://www.npmjs.com/package/@walkeros/runner) (also the
+`walkeros/flow` Docker image):
+
+```bash
+npx --package=@walkeros/runner runneros start dist/flow.mjs --port 3000
 ```
 
 ## Documentation