@christianirack/brainllm 0.5.0 → 0.6.1

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 +47 -31
  2. package/brain.schema.json +63 -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.5.0/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.6.1/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.5.0/LICENSE"><img src="https://img.shields.io/github/license/chrisifm/BRAINLLM" alt="License"></a>
16
+ <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>
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.5.0/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.6.1/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
 
@@ -31,14 +31,30 @@ code generation, bundling and minification. The agent can operate it through the
31
31
  a confusing diagnostic. The agent can turn that finding into a tested proposal and, when configured, push it
32
32
  automatically to a review branch. Maintainers decide what merges.
33
33
 
34
- **[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)**
34
+ ## Built for agents that change code safely
35
+
36
+ BRAINLLM is not another React, Next or Node. It is a compiler whose first user is an LLM, and it is designed to
37
+ improve itself: when an agent hits a compiler gap, `scripts/evolve.mjs` turns it into an isolated, tested proposal
38
+ for human review. The tools other stacks sell as advanced analysis are the baseline here:
39
+
40
+ - **Locate without reading.** `brain map`, `brain card`, `brain graph`, `brain context` and symbol search give an
41
+ agent the contract and the exact location of what it must touch, never a 2,000-line file.
42
+ - **Measured risk before every edit.** `brain risk <target>` returns a deterministic score, the factors behind it
43
+ (dependents, routes, public contracts, backend schema, covering tests, SEO/i18n/a11y, budget headroom) and the
44
+ checks that will prove the edit safe.
45
+ - **Atomic changes.** Leased, revision-checked changesets validate the whole app on a private snapshot before
46
+ writing and recover cleanly; a stale revision is rejected instead of overwriting another agent's work.
47
+ - **Real-time evidence while developing.** Compiler feedback, impact per save (diagnostics and bytes per view),
48
+ runtime errors mapped to `.brain` lines, memory and leak inspection, over CLI and MCP.
49
+
50
+ **[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)**
35
51
 
36
52
  ## A frontend language with the model in mind
37
53
 
38
54
  An agent writing your app needs a contract it can follow and feedback it can act on. BRAINLLM makes that loop
39
55
  explicit: read the spec, generate a component, check it, apply the fix, test the result.
40
56
 
41
- ![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)
57
+ ![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)
42
58
 
43
59
  - **Less to guess.** `brain spec` defines the supported language. One component format, a prescribed project
44
60
  structure and generators keep the model working inside a known contract.
@@ -66,7 +82,7 @@ agent has to reconstruct while preserving code that a developer can read and rev
66
82
  | Verification and delivery | Tests, `brain doctor` and the production build make validation part of the workflow |
67
83
  | Tested compiler improvements | Isolated proposals, validation gates and optional review-branch pushes let the agent contribute fixes |
68
84
 
69
- 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.
85
+ 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.
70
86
 
71
87
  ## Where it fits in the frontend stack
72
88
 
@@ -125,8 +141,8 @@ stack. Builds run serially on a shared machine. Variance matters: inspect the ra
125
141
  The output strategies differ (including SSR, client rendering and an Astro React island); this comparison measures
126
142
  production build duration for this fixture, not universal app performance or feature equivalence.
127
143
 
128
- 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
129
- [historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
144
+ 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
145
+ [historical results](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/bench/build/results/summary.md) remain available unchanged. Use `bench/build/expanded.mjs`
130
146
  with the documented frozen binary and scratch-directory setup to reproduce this seven-stack run.
131
147
 
132
148
  **Ask your agent to challenge the result:**
@@ -149,11 +165,11 @@ numbers support it. Do not upload results or publish anything automatically.
149
165
  Clean up only the temporary resources this run created.
150
166
  ```
151
167
 
152
- 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
168
+ 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
153
169
  lookup** after removing an unnecessary parse: 10,000 lookups of a 1,050-byte input. That number measures this
154
170
  internal operation only. It is not a full-build speedup or a webpack comparison.
155
171
 
156
- 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
172
+ 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
157
173
  failure recovery. Historical LLM results describe their frozen model/spec/compiler runs; they do not guarantee
158
174
  that a new prompt or compiler revision will pass. This project is open to developers and researchers who want to
159
175
  investigate how language design and compiler feedback affect agent behavior. Bring a hypothesis and a reproducer.
@@ -177,7 +193,7 @@ what each result actually establishes.
177
193
 
178
194
  Browser tooling and the preview supervisor currently require macOS or Linux. Screenshot baselines need stable browser,
179
195
  font and app-data inputs. Runtime mount-time/heap budgets remain planned; the compiler rejects those settings rather
180
- 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).
196
+ 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).
181
197
 
182
198
  ## Give your agent its first task
183
199
 
@@ -271,11 +287,11 @@ For an existing app, run `brain agent setup` to merge local registrations, or
271
287
  The hook checks the app after `.brain`, `.jsbrain` and `.cssbrain` edits; it does not run tests or download packages.
272
288
  Use `brain mcp --profile minimal` for six core tools, or `--profile backend` for resource/job contracts and generators.
273
289
  With a source installation, change the registration to command `brain` and arguments `["mcp"]`.
274
- Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/BACKEND.md).
290
+ Other clients use their own MCP settings. See [the backend/agent contract](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/BACKEND.md).
275
291
 
276
292
  </details>
277
293
 
278
- 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
294
+ 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
279
295
  React, Angular, Vue, Svelte, Next and Nuxt projects. Port one tested route or component at a time, preserve its
280
296
  behavior and keep a rollback path. It is an incremental workflow, not an automatic transpiler.
281
297
 
@@ -293,7 +309,7 @@ behavior and keep a rollback path. It is an incremental workflow, not an automat
293
309
  ```
294
310
 
295
311
  The compiler handles signal reads and writes. Derived values update when their inputs change. Styles can live in
296
- 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.
312
+ 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.
297
313
 
298
314
  ## Readable intent. Lean browser output.
299
315
 
@@ -301,7 +317,7 @@ An internal function named `back_to_home` can become a short identifier in produ
301
317
  on scope and the other names in the module. Keep meaningful names where the agent reasons about the code; let the
302
318
  compiler shorten eligible bindings in what the browser receives.
303
319
 
304
- 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):
320
+ 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):
305
321
 
306
322
  ```js
307
323
  // Before
@@ -336,29 +352,29 @@ BRAINLLM includes protections at several stages of the app loop:
336
352
  tests and diagnostics; failed stages remain visible to the agent.
337
353
 
338
354
  These are implemented mechanisms, not a promise to catch every bug or repair every failure. The agent still needs
339
- 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),
340
- [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/).
355
+ 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),
356
+ [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/).
341
357
 
342
358
  ## Build the tool your agent needs
343
359
 
344
360
  **Build with it. Let your LLM make it better.**
345
361
 
346
- ![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)
362
+ ![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)
347
363
 
348
364
  A failed compilation can become a regression test. A repeated slow step can become a benchmark. A fix made while
349
365
  building your app can become a contribution that helps the next developer and their agent.
350
366
 
351
367
  Found a compiler gap while building an app? Turn the smallest reproducible case into a regression test and a
352
- contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/EVOLUTION.md) for isolated proposals, validated compiler
368
+ contribution. BRAINLLM includes an [evolution workflow](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/EVOLUTION.md) for isolated proposals, validated compiler
353
369
  binaries and reversible activation. Configured automatic pushes go to review branches; merges require the
354
370
  principal author's review. This is an explicit development workflow, not a compiler that silently rewrites itself
355
- 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
371
+ 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
356
372
  to investigate.
357
373
 
358
374
  Human developers and LLM contributors are welcome. Useful first contributions include reproducible compiler bugs,
359
375
  behavior-preserving migration examples, clearer diagnostics and performance improvements with before/after data.
360
376
 
361
- 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).
377
+ 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).
362
378
  2. Make a focused change with a regression test and synthetic sample data.
363
379
  3. Run `bash scripts/verify.sh`. It builds the CLI and checks Rust, runtime, tooling, diagnostic fixtures, privacy
364
380
  and repository language. Verification also requires ripgrep.
@@ -369,7 +385,7 @@ Never include app secrets, private source or customer data in a contribution.
369
385
 
370
386
  ## Know what you are adopting
371
387
 
372
- 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
388
+ 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
373
389
  as planned in the source specification are not a supported promise; `brain spec` serves the implemented contract.
374
390
  Third-party React, Angular and Vue components do not become BRAINLLM components automatically. Benchmark wins in
375
391
  build time do not imply that every runtime workload is faster.
@@ -378,15 +394,15 @@ build time do not imply that every runtime workload is faster.
378
394
 
379
395
  | You want to… | Start here |
380
396
  |---|---|
381
- | Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/llms.txt) |
382
- | Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/SPEC.md) and `brain spec` |
383
- | Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/MIGRATION.md) |
384
- | 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) |
385
- | 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/) |
386
- | 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/) |
387
- | Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/CONTRIBUTING.md) |
397
+ | Give an agent the project context | [llms.txt](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/llms.txt) |
398
+ | Write an app | [SPEC.md](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/SPEC.md) and `brain spec` |
399
+ | Migrate an existing frontend | [Migration guide](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/MIGRATION.md) |
400
+ | 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) |
401
+ | 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/) |
402
+ | 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/) |
403
+ | Contribute a change | [Contributor guide](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/CONTRIBUTING.md) |
388
404
 
389
- Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/LICENSE).
405
+ Released under the [MIT license](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/LICENSE).
390
406
 
391
407
  Created and maintained by **Christian Irack Flores Maldonado**, principal author.
392
408
  [ingenieria.dev](https://ingenieria.dev) · [irack.mx](https://irack.mx) · [christian@irack.mx](mailto:christian@irack.mx)
@@ -398,5 +414,5 @@ Every merged contribution helps the next developer and their agent. Thank you to
398
414
 
399
415
  [<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)
400
416
 
401
- Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.5.0/docs/CONTRIBUTORS.md).
417
+ Attribution is refreshed through a reviewed pull request. [How it works](https://github.com/chrisifm/BRAINLLM/blob/v0.6.1/docs/CONTRIBUTORS.md).
402
418
  <!-- contributors:end -->
package/brain.schema.json CHANGED
@@ -15,10 +15,24 @@
15
15
  "description": {
16
16
  "type": "string"
17
17
  },
18
+ "docs": {
19
+ "type": "boolean",
20
+ "description": "Keep docs/app (generated by `brain docs`) up to date on every `brain build`; also on when docs/app/index.md exists."
21
+ },
18
22
  "lang": {
19
23
  "type": "string",
20
24
  "description": "Default document language, e.g. \"en\"."
21
25
  },
26
+ "server": {
27
+ "type": "object",
28
+ "additionalProperties": false,
29
+ "description": "Limits shared by brain run and the production server (dist/server.mjs). BRAIN_MAX_BODY_KB, BRAIN_TIMEOUT_MS and BRAIN_RPC_LIMIT override them at run time. brain check reports an invalid value as B0707.",
30
+ "properties": {
31
+ "maxBodyKB": { "type": "integer", "minimum": 1, "maximum": 65536, "default": 1024, "description": "Largest RPC or form body in KiB (1024 bytes); a larger body is answered with 413. Raise it for files sent as base64 in RPC arguments." },
32
+ "timeoutMs": { "type": "integer", "minimum": 100, "maximum": 600000, "default": 10000, "description": "Deadline for a server function call and for load(); past it the server answers 504." },
33
+ "rpcPerMinute": { "type": "integer", "minimum": 1, "maximum": 100000, "default": 60, "description": "Calls per client IP and function per minute; past it the server answers 429 with Retry-After." }
34
+ }
35
+ },
22
36
  "site": {
23
37
  "type": "string",
24
38
  "format": "uri",
@@ -88,6 +102,28 @@
88
102
  "type": "number",
89
103
  "minimum": 0,
90
104
  "default": 2048
105
+ },
106
+ "update": {
107
+ "enum": ["auto", "prompt"],
108
+ "default": "auto",
109
+ "description": "prompt: a new service worker waits until the page calls applyUpdate()"
110
+ },
111
+ "routes": {
112
+ "type": "array",
113
+ "maxItems": 32,
114
+ "description": "Service worker strategies for same-origin data paths; first match wins",
115
+ "items": {
116
+ "type": "object",
117
+ "required": ["match", "strategy"],
118
+ "additionalProperties": false,
119
+ "properties": {
120
+ "match": { "type": "string", "pattern": "^/[^*?#\\s]*\\*?$" },
121
+ "strategy": { "enum": ["cache-first", "network-first", "stale-while-revalidate", "network-only"] },
122
+ "maxEntries": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 64 },
123
+ "maxAge": { "type": ["string", "integer"], "description": "30s, 10m, 1h, 7d or seconds; omitted = no age limit" },
124
+ "timeout": { "type": ["string", "integer"], "description": "network-first deadline, 1s to 60s (default 3s)" }
125
+ }
126
+ }
91
127
  }
92
128
  }
93
129
  },
@@ -135,6 +171,16 @@
135
171
  "default": true,
136
172
  "description": "Write sections.json, the manifest of every section (title, description, home page, feed and pages with URL, Markdown copy and lastmod), linked from every page; false turns it off"
137
173
  },
174
+ "trailingSlash": {
175
+ "enum": ["never", "always", "ignore"],
176
+ "default": "never",
177
+ "description": "One URL per page for crawlers: never = /about/ answers 301 to /about; always = /about answers 301 to /about/; ignore = both are served. Folded into the same single hop as redirects.json"
178
+ },
179
+ "canonicalHost": {
180
+ "type": "boolean",
181
+ "default": false,
182
+ "description": "Send every other host (www., an old domain) to `site` with one 301; loopback hosts are never redirected. Needs `site`"
183
+ },
138
184
  "ai": {
139
185
  "enum": [
140
186
  "allow",
@@ -181,6 +227,23 @@
181
227
  }
182
228
  }
183
229
  },
230
+ "analytics": {
231
+ "description": "First-party behavior analytics stored in the native backend's Postgres (docs/backend/analytics.md). On by default when a native backend runs; false turns it off.",
232
+ "oneOf": [
233
+ { "type": "boolean" },
234
+ {
235
+ "type": "object",
236
+ "additionalProperties": false,
237
+ "properties": {
238
+ "enabled": { "type": "boolean" },
239
+ "consent": { "enum": ["required", "none"], "description": "required: record nothing until consent('analytics')" },
240
+ "retentionDays": { "type": "integer", "minimum": 1, "maximum": 3650, "default": 180 },
241
+ "countryHeader": { "type": "string", "pattern": "^[a-z0-9-]{1,64}$", "description": "Proxy header with an ISO country code, e.g. cf-ipcountry" },
242
+ "eventsPerMinute": { "type": "integer", "minimum": 1, "maximum": 6000, "default": 600 }
243
+ }
244
+ }
245
+ ]
246
+ },
184
247
  "budget": {
185
248
  "type": "object",
186
249
  "additionalProperties": false,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@christianirack/brainllm",
3
- "version": "0.5.0",
3
+ "version": "0.6.1",
4
4
  "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.",
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.5.0",
19
- "@christianirack/brainllm-darwin-x64": "0.5.0",
20
- "@christianirack/brainllm-linux-x64": "0.5.0",
21
- "@christianirack/brainllm-linux-arm64": "0.5.0",
22
- "@christianirack/brainllm-linux-x64-musl": "0.5.0",
23
- "@christianirack/brainllm-win32-x64": "0.5.0",
24
- "@christianirack/brainllm-win32-arm64": "0.5.0"
18
+ "@christianirack/brainllm-darwin-arm64": "0.6.1",
19
+ "@christianirack/brainllm-darwin-x64": "0.6.1",
20
+ "@christianirack/brainllm-linux-x64": "0.6.1",
21
+ "@christianirack/brainllm-linux-arm64": "0.6.1",
22
+ "@christianirack/brainllm-linux-x64-musl": "0.6.1",
23
+ "@christianirack/brainllm-win32-x64": "0.6.1",
24
+ "@christianirack/brainllm-win32-arm64": "0.6.1"
25
25
  },
26
26
  "keywords": [
27
27
  "llm",