@bneb/b4mal 0.1.1 → 0.1.2

package/README.md

@@ -53,6 +53,20 @@ b4mal analyze        # static HTML observability dashboard
 
 `b4mal.lock` is a **generated** artifact whenever `b4mal.config.json` is present — edit the config, not the lock. Running `b4mal init` auto-discovers an existing project, and the migration wizard can translate legacy Turborepo, Nx, and Lerna configurations.
 
+### Audit a build graph in CI, without switching build systems
+
+`b4mal check` reports resource collisions, deterministic overwrites, and implicit
+dependencies without running anything. As a GitHub Action it is a few lines and a
+no-op on repositories that do not use b4mal:
+
+```yaml
+- uses: bneb/b4mal@v0.1.2
+  with:
+    fail-on-findings: false   # start by reporting, not gating
+```
+
+See [Installation](https://github.com/bneb/b4mal/blob/main/docs/guide/installation.md#github-action) for inputs and outputs.
+
 ### Autonomous Trace Synthesis
 
 B4mal can automatically synthesize a mathematically sound DAG by passively tracing a legacy build script's file descriptor usage:
@@ -79,6 +93,7 @@ Documented in some design notes in this repository, but **not implemented in the
 
 ## Documentation
 
+- [Roadmap](./ROADMAP.md) - Open work, and what is verified versus merely claimed.
 - [Core Engine](./src/core/README.md) - Deep dive into caching, validation, and formal verification.
 - [Orchestrator](./src/orchestrator/README.md) - Dynamic scheduling, DAG planning, and subprocess isolation.
 - [Architecture](./ARCHITECTURE.md) - Details on the internal engine mechanics and the DAG collision engine.