@christianirack/brainllm 0.6.1 → 0.7.0

package/README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.6.1/docs/site/assets/logo.png" width="88" alt="BRAINLLM brain mark"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.7.0/docs/site/assets/logo.png" width="88" alt="BRAINLLM brain mark"></p>
 
 # BRAINLLM
 
@@ -13,10 +13,10 @@
   <img src="https://img.shields.io/badge/built%20with-Rust-dea584?logo=rust&logoColor=white" alt="Built with Rust">
   <a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://img.shields.io/badge/website-chrisifm.github.io%2FBRAINLLM-0071e3" alt="Website"></a>
   <a href="https://www.npmjs.com/package/@christianirack/brainllm"><img src="https://img.shields.io/npm/v/@christianirack/brainllm?color=cb3837" alt="npm version"></a>
-  <a href="https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
+  <a href="https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
 </p>
 
-<p align="center"><a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.6.1/docs/site/assets/cover.png" alt="BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM"></a></p>
+<p align="center"><a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.7.0/docs/site/assets/cover.png" alt="BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM"></a></p>
 
 <p align="center"><b>🌐 <a href="https://chrisifm.github.io/BRAINLLM/">chrisifm.github.io/BRAINLLM</a></b></p>
 
@@ -47,14 +47,14 @@ for human review. The tools other stacks sell as advanced analysis are the basel
 - **Real-time evidence while developing.** Compiler feedback, impact per save (diagnostics and bytes per view),
   runtime errors mapped to `.brain` lines, memory and leak inspection, over CLI and MCP.
 
-**[Visit the site](https://chrisifm.github.io/BRAINLLM/)** · **[Build your first app](#give-your-agent-its-first-task)** · **[Read the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md)** · **[See the benchmarks](#show-me-the-numbers)** · **[Contribute](#build-the-tool-your-agent-needs)**
+**[Visit the site](https://chrisifm.github.io/BRAINLLM/)** · **[Build your first app](#give-your-agent-its-first-task)** · **[Read the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/SPEC.md)** · **[See the benchmarks](#show-me-the-numbers)** · **[Contribute](#build-the-tool-your-agent-needs)**
 
 ## A frontend language with the model in mind
 
 An agent writing your app needs a contract it can follow and feedback it can act on. BRAINLLM makes that loop
 explicit: read the spec, generate a component, check it, apply the fix, test the result.
 
-![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.6.1/docs/site/assets/agent-loop.png)
+![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.7.0/docs/site/assets/agent-loop.png)
 
 - **Less to guess.** `brain spec` defines the supported language. One component format, a prescribed project
   structure and generators keep the model working inside a known contract.
@@ -82,7 +82,7 @@ agent has to reconstruct while preserving code that a developer can read and rev
 | Verification and delivery | Tests, `brain doctor` and the production build make validation part of the workflow |
 | Tested compiler improvements | Isolated proposals, validation gates and optional review-branch pushes let the agent contribute fixes |
 
-Use [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md), the served `brain spec` and [EVOLUTION.md](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/EVOLUTION.md) for exact contracts and limits.
+Use [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/SPEC.md), the served `brain spec` and [EVOLUTION.md](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/EVOLUTION.md) for exact contracts and limits.
 
 ## Where it fits in the frontend stack
 
@@ -141,8 +141,8 @@ stack. Builds run serially on a shared machine. Variance matters: inspect the ra
 The output strategies differ (including SSR, client rendering and an Astro React island); this comparison measures
 production build duration for this fixture, not universal app performance or feature equivalence.
 
-Read the [expanded method, versions, payloads and results](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/bench/build/expanded.md). The original three-stack
-[historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
+Read the [expanded method, versions, payloads and results](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/bench/build/expanded.md). The original three-stack
+[historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
 with the documented frozen binary and scratch-directory setup to reproduce this seven-stack run.
 
 **Ask your agent to challenge the result:**
@@ -165,11 +165,11 @@ numbers support it. Do not upload results or publish anything automatically.
 Clean up only the temporary resources this run created.
 ```
 
-A separate [cache-key microbenchmark](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/bench/build/results/compiler-cache-lookup.json) measured **43.3× faster key
+A separate [cache-key microbenchmark](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/bench/build/results/compiler-cache-lookup.json) measured **43.3× faster key
 lookup** after removing an unnecessary parse: 10,000 lookups of a 1,050-byte input. That number measures this
 internal operation only. It is not a full-build speedup or a webpack comparison.
 
-The [benchmark report](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/bench/REPORT.md) also tracks agent-generated apps, browser behavior, payload size and
+The [benchmark report](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/bench/REPORT.md) also tracks agent-generated apps, browser behavior, payload size and
 failure recovery. Historical LLM results describe their frozen model/spec/compiler runs; they do not guarantee
 that a new prompt or compiler revision will pass. This project is open to developers and researchers who want to
 investigate how language design and compiler feedback affect agent behavior. Bring a hypothesis and a reproducer.
@@ -193,7 +193,7 @@ what each result actually establishes.
 
 Browser tooling and the preview supervisor currently require macOS or Linux. Screenshot baselines need stable browser,
 font and app-data inputs. Runtime mount-time/heap budgets remain planned; the compiler rejects those settings rather
-than pretending to measure them. See the [implemented contract](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md) and [tool internals](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/INTERNALS.md).
+than pretending to measure them. See the [implemented contract](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/SPEC.md) and [tool internals](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/INTERNALS.md).
 
 ## Give your agent its first task
 
@@ -287,11 +287,11 @@ For an existing app, run `brain agent setup` to merge local registrations, or
 The hook checks the app after `.brain`, `.jsbrain` and `.cssbrain` edits; it does not run tests or download packages.
 Use `brain mcp --profile minimal` for six core tools, or `--profile backend` for resource/job contracts and generators.
 With a source installation, change the registration to command `brain` and arguments `["mcp"]`.
-Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/BACKEND.md).
+Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/BACKEND.md).
 
 </details>
 
-For an existing frontend, start with the [migration workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/MIGRATION.md). Its read-only planner recognizes
+For an existing frontend, start with the [migration workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/MIGRATION.md). Its read-only planner recognizes
 React, Angular, Vue, Svelte, Next and Nuxt projects. Port one tested route or component at a time, preserve its
 behavior and keep a rollback path. It is an incremental workflow, not an automatic transpiler.
 
@@ -309,7 +309,7 @@ behavior and keep a rollback path. It is an incremental workflow, not an automat
 ```
 
 The compiler handles signal reads and writes. Derived values update when their inputs change. Styles can live in
-the same file and are scoped to the component. The [served spec](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md) defines the supported syntax.
+the same file and are scoped to the component. The [served spec](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/SPEC.md) defines the supported syntax.
 
 ## Readable intent. Lean browser output.
 
@@ -317,7 +317,7 @@ An internal function named `back_to_home` can become a short identifier in produ
 on scope and the other names in the module. Keep meaningful names where the agent reasons about the code; let the
 compiler shorten eligible bindings in what the browser receives.
 
-This example comes from the [minifier's scope regression tests](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/crates/brain-min/src/mangle.rs):
+This example comes from the [minifier's scope regression tests](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/crates/brain-min/src/mangle.rs):
 
 ```js
 // Before
@@ -352,29 +352,29 @@ BRAINLLM includes protections at several stages of the app loop:
   tests and diagnostics; failed stages remain visible to the agent.
 
 These are implemented mechanisms, not a promise to catch every bug or repair every failure. The agent still needs
-to test the user's workflow. See [runtime behavior in the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md#errors-at-runtime),
-[component boundaries](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/runtime/brain-guard.js) and [compiler diagnostics](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/crates/brain-check/).
+to test the user's workflow. See [runtime behavior in the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/SPEC.md#errors-at-runtime),
+[component boundaries](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/runtime/brain-guard.js) and [compiler diagnostics](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/crates/brain-check/).
 
 ## Build the tool your agent needs
 
 **Build with it. Let your LLM make it better.**
 
-![An LLM turns an observed problem into an isolated fix, runs validation and submits a contribution for human review](https://github.com/chrisifm/BRAINLLM/raw/v0.6.1/docs/site/assets/improvement-loop.png)
+![An LLM turns an observed problem into an isolated fix, runs validation and submits a contribution for human review](https://github.com/chrisifm/BRAINLLM/raw/v0.7.0/docs/site/assets/improvement-loop.png)
 
 A failed compilation can become a regression test. A repeated slow step can become a benchmark. A fix made while
 building your app can become a contribution that helps the next developer and their agent.
 
 Found a compiler gap while building an app? Turn the smallest reproducible case into a regression test and a
-contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/EVOLUTION.md) for isolated proposals, validated compiler
+contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/EVOLUTION.md) for isolated proposals, validated compiler
 binaries and reversible activation. Configured automatic pushes go to review branches; merges require the
 principal author's review. This is an explicit development workflow, not a compiler that silently rewrites itself
-on every build. Read the [agent improvement playbook](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/AGENT-IDEAS.md) for an opt-in prompt and concrete ideas
+on every build. Read the [agent improvement playbook](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/AGENT-IDEAS.md) for an opt-in prompt and concrete ideas
 to investigate.
 
 Human developers and LLM contributors are welcome. Useful first contributions include reproducible compiler bugs,
 behavior-preserving migration examples, clearer diagnostics and performance improvements with before/after data.
 
-1. Read [CONTRIBUTING.md](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/CONTRIBUTING.md) and the relevant [internals](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/INTERNALS.md).
+1. Read [CONTRIBUTING.md](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/CONTRIBUTING.md) and the relevant [internals](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/INTERNALS.md).
 2. Make a focused change with a regression test and synthetic sample data.
 3. Run `bash scripts/verify.sh`. It builds the CLI and checks Rust, runtime, tooling, diagnostic fixtures, privacy
    and repository language. Verification also requires ripgrep.
@@ -385,7 +385,7 @@ Never include app secrets, private source or customer data in a contribution.
 
 ## Know what you are adopting
 
-BRAINLLM is **0.6.1** (see [CHANGELOG.md](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/CHANGELOG.md)). Start with a small app or an isolated route and test the behavior you need. Features marked
+BRAINLLM is **0.7.0** (see [CHANGELOG.md](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/CHANGELOG.md)). Start with a small app or an isolated route and test the behavior you need. Features marked
 as planned in the source specification are not a supported promise; `brain spec` serves the implemented contract.
 Third-party React, Angular and Vue components do not become BRAINLLM components automatically. Benchmark wins in
 build time do not imply that every runtime workload is faster.
@@ -394,15 +394,15 @@ build time do not imply that every runtime workload is faster.
 
 | You want to… | Start here |
 |---|---|
-| Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/llms.txt) |
-| Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md) and `brain spec` |
-| Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/MIGRATION.md) |
-| Improve the compiler while using it | [Evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/EVOLUTION.md) and [agent ideas](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/AGENT-IDEAS.md) |
-| Understand the implementation | [Internals](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/INTERNALS.md) and [crates](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/crates/) |
-| Inspect examples and reproduce measurements | [Examples](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/examples/) and [benchmarks](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/bench/) |
-| Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/CONTRIBUTING.md) |
+| Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/llms.txt) |
+| Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/SPEC.md) and `brain spec` |
+| Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/MIGRATION.md) |
+| Improve the compiler while using it | [Evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/EVOLUTION.md) and [agent ideas](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/AGENT-IDEAS.md) |
+| Understand the implementation | [Internals](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/INTERNALS.md) and [crates](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/crates/) |
+| Inspect examples and reproduce measurements | [Examples](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/examples/) and [benchmarks](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/bench/) |
+| Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/CONTRIBUTING.md) |
 
-Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/LICENSE).
+Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/LICENSE).
 
 Created and maintained by **Christian Irack Flores Maldonado**, principal author.
 [ingenieria.dev](https://ingenieria.dev) · [irack.mx](https://irack.mx) · [christian@irack.mx](mailto:christian@irack.mx)
@@ -414,5 +414,5 @@ Every merged contribution helps the next developer and their agent. Thank you to
 
 [<img src="https://avatars.githubusercontent.com/u/1562002?v=4" width="48" height="48" alt="chrisifm">](https://github.com/chrisifm) [chrisifm](https://github.com/chrisifm)
 
-Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/CONTRIBUTORS.md).
+Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.7.0/docs/CONTRIBUTORS.md).
 <!-- contributors:end -->

package/brain.schema.json

@@ -5,9 +5,26 @@
   "description": "BRAINLLM app configuration. Precedence: flag > BRAIN_* variable > brain.json > defaults.",
   "type": "object",
   "properties": {
+    "trace": {
+      "type": "object",
+      "description": "`brain trace`, the development capture of `brain run`. It never reaches a production build.",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "redact": { "type": "array", "items": { "type": "string" }, "description": "Extra field names to hide, on top of passwords, tokens, cookies and secrets" },
+        "maxBodyKB": { "type": "integer", "minimum": 1, "default": 16 },
+        "maxMB": { "type": "integer", "minimum": 1, "default": 64 },
+        "maxAgeHours": { "type": "integer", "minimum": 1, "default": 72 }
+      }
+    },
     "$schema": {
       "type": "string"
     },
+    "brainVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[0-9A-Za-z.-]+)?$",
+      "description": "Exact BRAINLLM version this app's source targets. Written by `brain new`; `brain upgrade` reports the changes since it and `brain upgrade --apply` advances it."
+    },
     "name": {
       "type": "string",
       "description": "App name (SEO, web manifest)."
@@ -127,6 +144,16 @@
         }
       }
     },
+    "doctor": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "failOnSuspectedLeaks": {
+          "type": "boolean",
+          "description": "Make `brain doctor` fail on B0601, an instance still alive after GC. Off by default: B0601 is a suspicion and is reported as a warning."
+        }
+      }
+    },
     "seo": {
       "type": "object",
       "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@christianirack/brainllm",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "BRAINLLM: the Rust-powered full-stack web compiler for LLMs and AI agents. Native brain CLI, dev server, optimized builds, PostgreSQL backend and MCP server.",
   "bin": {
     "brain": "bin/brain.js"
@@ -15,13 +15,13 @@
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@christianirack/brainllm-darwin-arm64": "0.6.1",
-    "@christianirack/brainllm-darwin-x64": "0.6.1",
-    "@christianirack/brainllm-linux-x64": "0.6.1",
-    "@christianirack/brainllm-linux-arm64": "0.6.1",
-    "@christianirack/brainllm-linux-x64-musl": "0.6.1",
-    "@christianirack/brainllm-win32-x64": "0.6.1",
-    "@christianirack/brainllm-win32-arm64": "0.6.1"
+    "@christianirack/brainllm-darwin-arm64": "0.7.0",
+    "@christianirack/brainllm-darwin-x64": "0.7.0",
+    "@christianirack/brainllm-linux-x64": "0.7.0",
+    "@christianirack/brainllm-linux-arm64": "0.7.0",
+    "@christianirack/brainllm-linux-x64-musl": "0.7.0",
+    "@christianirack/brainllm-win32-x64": "0.7.0",
+    "@christianirack/brainllm-win32-arm64": "0.7.0"
   },
   "keywords": [
     "llm",