@christianirack/create-brainllm 0.4.0 → 0.5.0

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 (2) hide show
  1. package/README.md +31 -31
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -10,7 +10,7 @@ npm run dev
10
10
 
11
11
  Runs the same pinned BRAINLLM compiler and installs the generated app dependencies. Pass `-- --no-install` to skip dependency installation.
12
12
 
13
- <p align="center"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.4.0/docs/site/assets/logo.png" width="88" alt="BRAINLLM brain mark"></p>
13
+ <p align="center"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.5.0/docs/site/assets/logo.png" width="88" alt="BRAINLLM brain mark"></p>
14
14
 
15
15
  # BRAINLLM
16
16
 
@@ -25,10 +25,10 @@ Runs the same pinned BRAINLLM compiler and installs the generated app dependenci
25
25
  <img src="https://img.shields.io/badge/built%20with-Rust-dea584?logo=rust&logoColor=white" alt="Built with Rust">
26
26
  <a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://img.shields.io/badge/website-chrisifm.github.io%2FBRAINLLM-0071e3" alt="Website"></a>
27
27
  <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>
28
- <a href="https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
28
+ <a href="https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
29
29
  </p>
30
30
 
31
- <p align="center"><a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.4.0/docs/site/assets/cover.png" alt="BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM"></a></p>
31
+ <p align="center"><a href="https://chrisifm.github.io/BRAINLLM/"><img src="https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.5.0/docs/site/assets/cover.png" alt="BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM"></a></p>
32
32
 
33
33
  <p align="center"><b>🌐 <a href="https://chrisifm.github.io/BRAINLLM/">chrisifm.github.io/BRAINLLM</a></b></p>
34
34
 
@@ -43,14 +43,14 @@ code generation, bundling and minification. The agent can operate it through the
43
43
  a confusing diagnostic. The agent can turn that finding into a tested proposal and, when configured, push it
44
44
  automatically to a review branch. Maintainers decide what merges.
45
45
 
46
- **[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.4.0/SPEC.md)** · **[See the benchmarks](#show-me-the-numbers)** · **[Contribute](#build-the-tool-your-agent-needs)**
46
+ **[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.5.0/SPEC.md)** · **[See the benchmarks](#show-me-the-numbers)** · **[Contribute](#build-the-tool-your-agent-needs)**
47
47
 
48
48
  ## A frontend language with the model in mind
49
49
 
50
50
  An agent writing your app needs a contract it can follow and feedback it can act on. BRAINLLM makes that loop
51
51
  explicit: read the spec, generate a component, check it, apply the fix, test the result.
52
52
 
53
- ![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.4.0/docs/site/assets/agent-loop.png)
53
+ ![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.5.0/docs/site/assets/agent-loop.png)
54
54
 
55
55
  - **Less to guess.** `brain spec` defines the supported language. One component format, a prescribed project
56
56
  structure and generators keep the model working inside a known contract.
@@ -78,7 +78,7 @@ agent has to reconstruct while preserving code that a developer can read and rev
78
78
  | Verification and delivery | Tests, `brain doctor` and the production build make validation part of the workflow |
79
79
  | Tested compiler improvements | Isolated proposals, validation gates and optional review-branch pushes let the agent contribute fixes |
80
80
 
81
- Use [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/SPEC.md), the served `brain spec` and [EVOLUTION.md](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/EVOLUTION.md) for exact contracts and limits.
81
+ Use [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/SPEC.md), the served `brain spec` and [EVOLUTION.md](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/EVOLUTION.md) for exact contracts and limits.
82
82
 
83
83
  ## Where it fits in the frontend stack
84
84
 
@@ -137,8 +137,8 @@ stack. Builds run serially on a shared machine. Variance matters: inspect the ra
137
137
  The output strategies differ (including SSR, client rendering and an Astro React island); this comparison measures
138
138
  production build duration for this fixture, not universal app performance or feature equivalence.
139
139
 
140
- Read the [expanded method, versions, payloads and results](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/bench/build/expanded.md). The original three-stack
141
- [historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
140
+ Read the [expanded method, versions, payloads and results](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/bench/build/expanded.md). The original three-stack
141
+ [historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
142
142
  with the documented frozen binary and scratch-directory setup to reproduce this seven-stack run.
143
143
 
144
144
  **Ask your agent to challenge the result:**
@@ -161,11 +161,11 @@ numbers support it. Do not upload results or publish anything automatically.
161
161
  Clean up only the temporary resources this run created.
162
162
  ```
163
163
 
164
- A separate [cache-key microbenchmark](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/bench/build/results/compiler-cache-lookup.json) measured **43.3× faster key
164
+ A separate [cache-key microbenchmark](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/bench/build/results/compiler-cache-lookup.json) measured **43.3× faster key
165
165
  lookup** after removing an unnecessary parse: 10,000 lookups of a 1,050-byte input. That number measures this
166
166
  internal operation only. It is not a full-build speedup or a webpack comparison.
167
167
 
168
- The [benchmark report](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/bench/REPORT.md) also tracks agent-generated apps, browser behavior, payload size and
168
+ The [benchmark report](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/bench/REPORT.md) also tracks agent-generated apps, browser behavior, payload size and
169
169
  failure recovery. Historical LLM results describe their frozen model/spec/compiler runs; they do not guarantee
170
170
  that a new prompt or compiler revision will pass. This project is open to developers and researchers who want to
171
171
  investigate how language design and compiler feedback affect agent behavior. Bring a hypothesis and a reproducer.
@@ -189,7 +189,7 @@ what each result actually establishes.
189
189
 
190
190
  Browser tooling and the preview supervisor currently require macOS or Linux. Screenshot baselines need stable browser,
191
191
  font and app-data inputs. Runtime mount-time/heap budgets remain planned; the compiler rejects those settings rather
192
- than pretending to measure them. See the [implemented contract](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/SPEC.md) and [tool internals](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/INTERNALS.md).
192
+ than pretending to measure them. See the [implemented contract](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/SPEC.md) and [tool internals](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/INTERNALS.md).
193
193
 
194
194
  ## Give your agent its first task
195
195
 
@@ -283,11 +283,11 @@ For an existing app, run `brain agent setup` to merge local registrations, or
283
283
  The hook checks the app after `.brain`, `.jsbrain` and `.cssbrain` edits; it does not run tests or download packages.
284
284
  Use `brain mcp --profile minimal` for six core tools, or `--profile backend` for resource/job contracts and generators.
285
285
  With a source installation, change the registration to command `brain` and arguments `["mcp"]`.
286
- Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/BACKEND.md).
286
+ Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/BACKEND.md).
287
287
 
288
288
  </details>
289
289
 
290
- For an existing frontend, start with the [migration workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/MIGRATION.md). Its read-only planner recognizes
290
+ For an existing frontend, start with the [migration workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/MIGRATION.md). Its read-only planner recognizes
291
291
  React, Angular, Vue, Svelte, Next and Nuxt projects. Port one tested route or component at a time, preserve its
292
292
  behavior and keep a rollback path. It is an incremental workflow, not an automatic transpiler.
293
293
 
@@ -305,7 +305,7 @@ behavior and keep a rollback path. It is an incremental workflow, not an automat
305
305
  ```
306
306
 
307
307
  The compiler handles signal reads and writes. Derived values update when their inputs change. Styles can live in
308
- the same file and are scoped to the component. The [served spec](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/SPEC.md) defines the supported syntax.
308
+ the same file and are scoped to the component. The [served spec](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/SPEC.md) defines the supported syntax.
309
309
 
310
310
  ## Readable intent. Lean browser output.
311
311
 
@@ -313,7 +313,7 @@ An internal function named `back_to_home` can become a short identifier in produ
313
313
  on scope and the other names in the module. Keep meaningful names where the agent reasons about the code; let the
314
314
  compiler shorten eligible bindings in what the browser receives.
315
315
 
316
- This example comes from the [minifier's scope regression tests](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/crates/brain-min/src/mangle.rs):
316
+ This example comes from the [minifier's scope regression tests](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/crates/brain-min/src/mangle.rs):
317
317
 
318
318
  ```js
319
319
  // Before
@@ -348,29 +348,29 @@ BRAINLLM includes protections at several stages of the app loop:
348
348
  tests and diagnostics; failed stages remain visible to the agent.
349
349
 
350
350
  These are implemented mechanisms, not a promise to catch every bug or repair every failure. The agent still needs
351
- to test the user's workflow. See [runtime behavior in the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/SPEC.md#errors-at-runtime),
352
- [component boundaries](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/runtime/brain-guard.js) and [compiler diagnostics](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/crates/brain-check/).
351
+ to test the user's workflow. See [runtime behavior in the spec](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/SPEC.md#errors-at-runtime),
352
+ [component boundaries](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/runtime/brain-guard.js) and [compiler diagnostics](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/crates/brain-check/).
353
353
 
354
354
  ## Build the tool your agent needs
355
355
 
356
356
  **Build with it. Let your LLM make it better.**
357
357
 
358
- ![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.4.0/docs/site/assets/improvement-loop.png)
358
+ ![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.5.0/docs/site/assets/improvement-loop.png)
359
359
 
360
360
  A failed compilation can become a regression test. A repeated slow step can become a benchmark. A fix made while
361
361
  building your app can become a contribution that helps the next developer and their agent.
362
362
 
363
363
  Found a compiler gap while building an app? Turn the smallest reproducible case into a regression test and a
364
- contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/EVOLUTION.md) for isolated proposals, validated compiler
364
+ contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/EVOLUTION.md) for isolated proposals, validated compiler
365
365
  binaries and reversible activation. Configured automatic pushes go to review branches; merges require the
366
366
  principal author's review. This is an explicit development workflow, not a compiler that silently rewrites itself
367
- on every build. Read the [agent improvement playbook](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/AGENT-IDEAS.md) for an opt-in prompt and concrete ideas
367
+ on every build. Read the [agent improvement playbook](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/AGENT-IDEAS.md) for an opt-in prompt and concrete ideas
368
368
  to investigate.
369
369
 
370
370
  Human developers and LLM contributors are welcome. Useful first contributions include reproducible compiler bugs,
371
371
  behavior-preserving migration examples, clearer diagnostics and performance improvements with before/after data.
372
372
 
373
- 1. Read [CONTRIBUTING.md](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/CONTRIBUTING.md) and the relevant [internals](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/INTERNALS.md).
373
+ 1. Read [CONTRIBUTING.md](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/CONTRIBUTING.md) and the relevant [internals](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/INTERNALS.md).
374
374
  2. Make a focused change with a regression test and synthetic sample data.
375
375
  3. Run `bash scripts/verify.sh`. It builds the CLI and checks Rust, runtime, tooling, diagnostic fixtures, privacy
376
376
  and repository language. Verification also requires ripgrep.
@@ -381,7 +381,7 @@ Never include app secrets, private source or customer data in a contribution.
381
381
 
382
382
  ## Know what you are adopting
383
383
 
384
- BRAINLLM is **0.4.0** (see [CHANGELOG.md](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/CHANGELOG.md)). Start with a small app or an isolated route and test the behavior you need. Features marked
384
+ BRAINLLM is **0.5.0** (see [CHANGELOG.md](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/CHANGELOG.md)). Start with a small app or an isolated route and test the behavior you need. Features marked
385
385
  as planned in the source specification are not a supported promise; `brain spec` serves the implemented contract.
386
386
  Third-party React, Angular and Vue components do not become BRAINLLM components automatically. Benchmark wins in
387
387
  build time do not imply that every runtime workload is faster.
@@ -390,15 +390,15 @@ build time do not imply that every runtime workload is faster.
390
390
 
391
391
  | You want to… | Start here |
392
392
  |---|---|
393
- | Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/llms.txt) |
394
- | Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/SPEC.md) and `brain spec` |
395
- | Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/MIGRATION.md) |
396
- | Improve the compiler while using it | [Evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/EVOLUTION.md) and [agent ideas](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/AGENT-IDEAS.md) |
397
- | Understand the implementation | [Internals](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/INTERNALS.md) and [crates](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/crates/) |
398
- | Inspect examples and reproduce measurements | [Examples](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/examples/) and [benchmarks](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/bench/) |
399
- | Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/CONTRIBUTING.md) |
393
+ | Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/llms.txt) |
394
+ | Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/SPEC.md) and `brain spec` |
395
+ | Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/MIGRATION.md) |
396
+ | Improve the compiler while using it | [Evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/EVOLUTION.md) and [agent ideas](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/AGENT-IDEAS.md) |
397
+ | Understand the implementation | [Internals](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/INTERNALS.md) and [crates](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/crates/) |
398
+ | Inspect examples and reproduce measurements | [Examples](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/examples/) and [benchmarks](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/bench/) |
399
+ | Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/CONTRIBUTING.md) |
400
400
 
401
- Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/LICENSE).
401
+ Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/LICENSE).
402
402
 
403
403
  Created and maintained by **Christian Irack Flores Maldonado**, principal author.
404
404
  [ingenieria.dev](https://ingenieria.dev) · [irack.mx](https://irack.mx) · [christian@irack.mx](mailto:christian@irack.mx)
@@ -410,5 +410,5 @@ Every merged contribution helps the next developer and their agent. Thank you to
410
410
 
411
411
  [<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)
412
412
 
413
- Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.4.0/docs/CONTRIBUTORS.md).
413
+ Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/CONTRIBUTORS.md).
414
414
  <!-- contributors:end -->
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@christianirack/create-brainllm",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "npm create @christianirack/brainllm <app>: a new BRAINLLM app (the Rust-powered full-stack web compiler for LLMs and AI agents) with its brain version pinned.",
5
5
  "bin": {
6
6
  "create-brainllm": "bin/create.js"
@@ -14,7 +14,7 @@
14
14
  "node": ">=22"
15
15
  },
16
16
  "dependencies": {
17
- "@christianirack/brainllm": "0.4.0"
17
+ "@christianirack/brainllm": "0.5.0"
18
18
  },
19
19
  "keywords": [
20
20
  "create",