@christianirack/brainllm 0.10.4 → 0.10.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +31 -31
  2. package/brain.schema.json +10 -0
  3. package/package.json +8 -8
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- <p align="center"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.10.4/docs/site/assets/logo.png" width="88" alt="BRAINLLM brain mark"></p>
1
+ <p align="center"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.10.11/docs/site/assets/logo.png" width="88" alt="BRAINLLM brain mark"></p>
2
2
 
3
3
  # BRAINLLM
4
4
 
@@ -13,10 +13,10 @@
13
13
  <img src="https://img.shields.io/badge/built%20with-Rust-dea584?logo=rust&logoColor=white" alt="Built with Rust">
14
14
  <a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://img.shields.io/badge/website-chrisifm.github.io%2FBRAINLLM-0071e3" alt="Website"></a>
15
15
  <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>
16
- <a href="https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
16
+ <a href="https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
17
17
  </p>
18
18
 
19
- <p align="center"><a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.10.4/docs/site/assets/cover.png" alt="BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM"></a></p>
19
+ <p align="center"><a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.10.11/docs/site/assets/cover.png" alt="BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM"></a></p>
20
20
 
21
21
  <p align="center"><b>🌐 <a href="https://chrisifm.github.io/BRAINLLM/">chrisifm.github.io/BRAINLLM</a></b></p>
22
22
 
@@ -49,14 +49,14 @@ the baseline here:
49
49
  - **Real-time evidence while developing.** Compiler feedback, impact per save (diagnostics and bytes per view),
50
50
  runtime errors mapped to `.brain` lines, memory and leak inspection, over CLI and MCP.
51
51
 
52
- **[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.10.4/SPEC.md)** · **[See the benchmarks](#show-me-the-numbers)** · **[Contribute](#build-the-tool-your-agent-needs)**
52
+ **[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.10.11/SPEC.md)** · **[See the benchmarks](#show-me-the-numbers)** · **[Contribute](#build-the-tool-your-agent-needs)**
53
53
 
54
54
  ## A frontend language with the model in mind
55
55
 
56
56
  An agent writing your app needs a contract it can follow and feedback it can act on. BRAINLLM makes that loop
57
57
  explicit: read the spec, generate a component, check it, apply the fix, test the result.
58
58
 
59
- ![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.10.4/docs/site/assets/agent-loop.png)
59
+ ![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.10.11/docs/site/assets/agent-loop.png)
60
60
 
61
61
  - **Less to guess.** `brain spec` defines the supported language. One component format, a prescribed project
62
62
  structure and generators keep the model working inside a known contract.
@@ -84,7 +84,7 @@ agent has to reconstruct while preserving code that a developer can read and rev
84
84
  | Verification and delivery | Tests, `brain doctor` and the production build make validation part of the workflow |
85
85
  | Tested compiler improvements | Isolated proposals, validation gates and optional review-branch pushes let the agent contribute fixes |
86
86
 
87
- Use [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/SPEC.md), the served `brain spec` and [EVOLUTION.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/EVOLUTION.md) for exact contracts and limits.
87
+ Use [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/SPEC.md), the served `brain spec` and [EVOLUTION.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/EVOLUTION.md) for exact contracts and limits.
88
88
 
89
89
  ## Where it fits in the frontend stack
90
90
 
@@ -143,8 +143,8 @@ stack. Builds run serially on a shared machine. Variance matters: inspect the ra
143
143
  The output strategies differ (including SSR, client rendering and an Astro React island); this comparison measures
144
144
  production build duration for this fixture, not universal app performance or feature equivalence.
145
145
 
146
- Read the [expanded method, versions, payloads and results](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/bench/build/expanded.md). The original three-stack
147
- [historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
146
+ Read the [expanded method, versions, payloads and results](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/bench/build/expanded.md). The original three-stack
147
+ [historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
148
148
  with the documented frozen binary and scratch-directory setup to reproduce this seven-stack run.
149
149
 
150
150
  **Ask your agent to challenge the result:**
@@ -167,11 +167,11 @@ numbers support it. Do not upload results or publish anything automatically.
167
167
  Clean up only the temporary resources this run created.
168
168
  ```
169
169
 
170
- A separate [cache-key microbenchmark](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/bench/build/results/compiler-cache-lookup.json) measured **43.3× faster key
170
+ A separate [cache-key microbenchmark](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/bench/build/results/compiler-cache-lookup.json) measured **43.3× faster key
171
171
  lookup** after removing an unnecessary parse: 10,000 lookups of a 1,050-byte input. That number measures this
172
172
  internal operation only. It is not a full-build speedup or a webpack comparison.
173
173
 
174
- The [benchmark report](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/bench/REPORT.md) also tracks agent-generated apps, browser behavior, payload size and
174
+ The [benchmark report](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/bench/REPORT.md) also tracks agent-generated apps, browser behavior, payload size and
175
175
  failure recovery. Historical LLM results describe their frozen model/spec/compiler runs; they do not guarantee
176
176
  that a new prompt or compiler revision will pass. This project is open to developers and researchers who want to
177
177
  investigate how language design and compiler feedback affect agent behavior. Bring a hypothesis and a reproducer.
@@ -195,7 +195,7 @@ what each result actually establishes.
195
195
 
196
196
  Browser tooling and the preview supervisor currently require macOS or Linux. Screenshot baselines need stable browser,
197
197
  font and app-data inputs. Runtime mount-time/heap budgets remain planned; the compiler rejects those settings rather
198
- than pretending to measure them. See the [implemented contract](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/SPEC.md) and [tool internals](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/INTERNALS.md).
198
+ than pretending to measure them. See the [implemented contract](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/SPEC.md) and [tool internals](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/INTERNALS.md).
199
199
 
200
200
  ## Give your agent its first task
201
201
 
@@ -303,11 +303,11 @@ For an existing app, run `brain agent setup` to merge local registrations, or
303
303
  The hook checks the app after `.brain`, `.jsbrain` and `.cssbrain` edits; it does not run tests or download packages.
304
304
  Use `brain mcp --profile minimal` for six core tools, or `--profile backend` for resource/job contracts and generators.
305
305
  With a source installation, change the registration to command `brain` and arguments `["mcp"]`.
306
- Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/BACKEND.md).
306
+ Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/BACKEND.md).
307
307
 
308
308
  </details>
309
309
 
310
- For an existing frontend, start with the [migration workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/MIGRATION.md). Its read-only planner recognizes
310
+ For an existing frontend, start with the [migration workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/MIGRATION.md). Its read-only planner recognizes
311
311
  React, Angular, Vue, Svelte, Next and Nuxt projects. Port one tested route or component at a time, preserve its
312
312
  behavior and keep a rollback path. It is an incremental workflow, not an automatic transpiler.
313
313
 
@@ -325,7 +325,7 @@ behavior and keep a rollback path. It is an incremental workflow, not an automat
325
325
  ```
326
326
 
327
327
  The compiler handles signal reads and writes. Derived values update when their inputs change. Styles can live in
328
- the same file and are scoped to the component. The [served spec](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/SPEC.md) defines the supported syntax.
328
+ the same file and are scoped to the component. The [served spec](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/SPEC.md) defines the supported syntax.
329
329
 
330
330
  ## Readable intent. Lean browser output.
331
331
 
@@ -333,7 +333,7 @@ An internal function named `back_to_home` can become a short identifier in produ
333
333
  on scope and the other names in the module. Keep meaningful names where the agent reasons about the code; let the
334
334
  compiler shorten eligible bindings in what the browser receives.
335
335
 
336
- This example comes from the [minifier's scope regression tests](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/crates/brain-min/src/mangle.rs):
336
+ This example comes from the [minifier's scope regression tests](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/crates/brain-min/src/mangle.rs):
337
337
 
338
338
  ```js
339
339
  // Before
@@ -368,29 +368,29 @@ BRAINLLM includes protections at several stages of the app loop:
368
368
  tests and diagnostics; failed stages remain visible to the agent.
369
369
 
370
370
  These are implemented mechanisms, not a promise to catch every bug or repair every failure. The agent still needs
371
- to test the user's workflow. See [runtime behavior in the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/SPEC.md#errors-at-runtime),
372
- [component boundaries](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/runtime/brain-guard.js) and [compiler diagnostics](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/crates/brain-check/).
371
+ to test the user's workflow. See [runtime behavior in the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/SPEC.md#errors-at-runtime),
372
+ [component boundaries](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/runtime/brain-guard.js) and [compiler diagnostics](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/crates/brain-check/).
373
373
 
374
374
  ## Build the tool your agent needs
375
375
 
376
376
  **Build with it. Let your LLM make it better.**
377
377
 
378
- ![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.10.4/docs/site/assets/improvement-loop.png)
378
+ ![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.10.11/docs/site/assets/improvement-loop.png)
379
379
 
380
380
  A failed compilation can become a regression test. A repeated slow step can become a benchmark. A fix made while
381
381
  building your app can become a contribution that helps the next developer and their agent.
382
382
 
383
383
  Found a compiler gap while building an app? Turn the smallest reproducible case into a regression test and a
384
- contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/EVOLUTION.md) for isolated proposals, validated compiler
384
+ contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/EVOLUTION.md) for isolated proposals, validated compiler
385
385
  binaries and reversible activation. Configured automatic pushes go to review branches; merges require the
386
386
  principal author's review. This is an explicit development workflow, not a compiler that silently rewrites itself
387
- on every build. Read the [agent improvement playbook](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/AGENT-IDEAS.md) for an opt-in prompt and concrete ideas
387
+ on every build. Read the [agent improvement playbook](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/AGENT-IDEAS.md) for an opt-in prompt and concrete ideas
388
388
  to investigate.
389
389
 
390
390
  Human developers and LLM contributors are welcome. Useful first contributions include reproducible compiler bugs,
391
391
  behavior-preserving migration examples, clearer diagnostics and performance improvements with before/after data.
392
392
 
393
- 1. Read [CONTRIBUTING.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/CONTRIBUTING.md) and the relevant [internals](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/INTERNALS.md).
393
+ 1. Read [CONTRIBUTING.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/CONTRIBUTING.md) and the relevant [internals](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/INTERNALS.md).
394
394
  2. Make a focused change with a regression test and synthetic sample data.
395
395
  3. Run `bash scripts/verify.sh`. It builds the CLI and checks Rust, runtime, tooling, diagnostic fixtures, privacy
396
396
  and repository language. Verification also requires ripgrep.
@@ -401,7 +401,7 @@ Never include app secrets, private source or customer data in a contribution.
401
401
 
402
402
  ## Know what you are adopting
403
403
 
404
- BRAINLLM is **0.10.4** (see [CHANGELOG.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/CHANGELOG.md)). Start with a small app or an isolated route and test the behavior you need. Features marked
404
+ BRAINLLM is **0.10.11** (see [CHANGELOG.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/CHANGELOG.md)). Start with a small app or an isolated route and test the behavior you need. Features marked
405
405
  as planned in the source specification are not a supported promise; `brain spec` serves the implemented contract.
406
406
  Third-party React, Angular and Vue components do not become BRAINLLM components automatically. Benchmark wins in
407
407
  build time do not imply that every runtime workload is faster.
@@ -410,15 +410,15 @@ build time do not imply that every runtime workload is faster.
410
410
 
411
411
  | You want to… | Start here |
412
412
  |---|---|
413
- | Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/llms.txt) |
414
- | Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/SPEC.md) and `brain spec` |
415
- | Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/MIGRATION.md) |
416
- | Improve the compiler while using it | [Evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/EVOLUTION.md) and [agent ideas](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/AGENT-IDEAS.md) |
417
- | Understand the implementation | [Internals](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/INTERNALS.md) and [crates](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/crates/) |
418
- | Inspect examples and reproduce measurements | [Examples](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/examples/) and [benchmarks](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/bench/) |
419
- | Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/CONTRIBUTING.md) |
413
+ | Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/llms.txt) |
414
+ | Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/SPEC.md) and `brain spec` |
415
+ | Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/MIGRATION.md) |
416
+ | Improve the compiler while using it | [Evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/EVOLUTION.md) and [agent ideas](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/AGENT-IDEAS.md) |
417
+ | Understand the implementation | [Internals](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/INTERNALS.md) and [crates](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/crates/) |
418
+ | Inspect examples and reproduce measurements | [Examples](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/examples/) and [benchmarks](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/bench/) |
419
+ | Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/CONTRIBUTING.md) |
420
420
 
421
- Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/LICENSE).
421
+ Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/LICENSE).
422
422
 
423
423
  Created and maintained by **Christian Irack Flores Maldonado**, principal author.
424
424
  [ingenieria.dev](https://ingenieria.dev) · [irack.mx](https://irack.mx) · [christian@irack.mx](mailto:christian@irack.mx)
@@ -430,5 +430,5 @@ Every merged contribution helps the next developer and their agent. Thank you to
430
430
 
431
431
  [<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)
432
432
 
433
- Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.10.4/docs/CONTRIBUTORS.md).
433
+ Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.10.11/docs/CONTRIBUTORS.md).
434
434
  <!-- contributors:end -->
package/brain.schema.json CHANGED
@@ -451,6 +451,16 @@
451
451
  },
452
452
  "description": "Origins pages may embed in an iframe, besides the site's own. A literal iframe outside this list is reported as B0811."
453
453
  },
454
+ "frameAncestors": {
455
+ "type": "array",
456
+ "maxItems": 64,
457
+ "uniqueItems": true,
458
+ "items": {
459
+ "type": "string",
460
+ "pattern": "^('self'|'none'|https://[a-z0-9.-]+(:[0-9]+)?|http://(localhost|127\\.0\\.0\\.1)(:([0-9]+|\\*))?|http://[a-z0-9-]+(:[0-9]+)?)$"
461
+ },
462
+ "description": "Who may embed this site's pages in an iframe (CSP frame-ancestors). Absent: 'none' plus X-Frame-Options DENY. With origins, X-Frame-Options is omitted (SAMEORIGIN when the list is only 'self'). http only for localhost or a single-label LAN host."
463
+ },
454
464
  "formAction": {
455
465
  "type": "array",
456
466
  "maxItems": 64,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@christianirack/brainllm",
3
- "version": "0.10.4",
3
+ "version": "0.10.11",
4
4
  "description": "BRAINLLM: a Rust-powered frontend and full-stack web compiler. Optimized JavaScript, SSR, SEO-ready static sites, a PostgreSQL backend and MCP tools for LLMs and AI agents.",
5
5
  "bin": {
6
6
  "brain": "bin/brain.js"
@@ -15,13 +15,13 @@
15
15
  "node": ">=22"
16
16
  },
17
17
  "optionalDependencies": {
18
- "@christianirack/brainllm-darwin-arm64": "0.10.4",
19
- "@christianirack/brainllm-darwin-x64": "0.10.4",
20
- "@christianirack/brainllm-linux-x64": "0.10.4",
21
- "@christianirack/brainllm-linux-arm64": "0.10.4",
22
- "@christianirack/brainllm-linux-x64-musl": "0.10.4",
23
- "@christianirack/brainllm-win32-x64": "0.10.4",
24
- "@christianirack/brainllm-win32-arm64": "0.10.4"
18
+ "@christianirack/brainllm-darwin-arm64": "0.10.11",
19
+ "@christianirack/brainllm-darwin-x64": "0.10.11",
20
+ "@christianirack/brainllm-linux-x64": "0.10.11",
21
+ "@christianirack/brainllm-linux-arm64": "0.10.11",
22
+ "@christianirack/brainllm-linux-x64-musl": "0.10.11",
23
+ "@christianirack/brainllm-win32-x64": "0.10.11",
24
+ "@christianirack/brainllm-win32-arm64": "0.10.11"
25
25
  },
26
26
  "keywords": [
27
27
  "llm",