glamfire 0.2.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 glamworks
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,7 @@
+glamfire
+Copyright 2026 glamworks
+
+This product includes software developed by the glamworks community
+(https://github.com/glamworks).
+
+Licensed under the Apache License, Version 2.0.

package/README.md

@@ -0,0 +1,280 @@
+<div align="center">
+
+<img src="glamworks-logo.png" alt="glamfire" width="160" />
+
+# glamfire
+
+### The open harness for the last mile of AI.
+
+**Own your context. Route your intelligence. Never rent your brain back.**
+
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Status](https://img.shields.io/badge/status-foundation-orange.svg)](#current-reality)
+[![Platforms](https://img.shields.io/badge/platforms-macOS%20%C2%B7%20Windows%20%C2%B7%20Linux-informational.svg)](#install)
+[![Default model](https://img.shields.io/badge/default-GLM%205.2%20on%20Fireworks-ff5a1f.svg)](#why-glm-52--fireworks)
+
+[Spec](SPEC.md) · [Quickstart](docs/QUICKSTART.md) · [Architecture](docs/ARCHITECTURE.md) · [Mission](docs/MISSION.md) · [Why we win](docs/WHY-WE-WIN.md) · [Current reality](#current-reality) · [Contribute](CONTRIBUTING.md) · [Site](https://glamworks.github.io)
+
+</div>
+
+---
+
+## The 98% problem
+
+Intelligence just got about **98% cheaper**. Open models like **GLM 5.2** now match or
+beat the frontier on the *broad middle of everyday work* — the brochure site, the
+standard deck, the first‑pass copy, the routine synthesis, the familiar coding task.
+Faster. Cheaper. Free to self‑host.
+
+So why is almost nobody switching?
+
+Because a model is a **brain in a jar**. What your company actually runs is the *work
+system* around it — the **harness** and its **last mile**:
+
+- the **context** the model sees (memory, retrieval, your team's hard‑won knowledge),
+- the **routing** that picks the right model for each task,
+- the **tool calls**, shaped to each model family's own grammar,
+- the **system prompts**, tuned to one lab's quirks,
+- the **surfaces** — CLI, chat, IDE — where work happens.
+
+Switching models means rebuilding all of it. The talent that can do that is scarce and
+expensive, so companies sign a frontier contract instead. And the frontier labs are
+racing to put their assistant *inside your team chat* — quietly absorbing the messy
+context that **is** your edge, until you're renting your own brain back from them
+forever, with no way to rip it out.
+
+**glamfire is the open, self‑owned harness that closes the last mile.** Keep your
+context in your hands. Route every task to the cheapest model that can actually do it.
+Run one work system across any model family. Make cheap intelligence *usable* without
+handing your context to anyone.
+
+> If you can build a harness, this is the opening of the decade. glamfire is that
+> harness, in the open, for everyone.
+
+---
+
+## What glamfire is
+
+A **model‑agnostic, agent‑agnostic harness**, built as a TypeScript monorepo. Three
+load‑bearing subsystems:
+
+| Subsystem | a.k.a. | What it does |
+|---|---|---|
+| **engine** | *open engine* | The agent loop: plan → act → observe, tool dispatch, permissions, sandboxing, streaming. |
+| **brain** | *open brain* | Your context, **local‑first and portable** — owned, exportable, never uploaded, never rented back. |
+| **skills** | *open skills* | Portable capability packs that travel across models unchanged. |
+
+…wired together by:
+
+- **router** — scores each task **center ↔ edge** of distribution and sends it to the
+  cheapest capable model, escalating to the frontier only when confidence is low.
+- **adapters** — a **tested harness per model family** (GLM 5.2/Fireworks, Anthropic,
+  OpenAI, local vLLM). Each turns a raw model into a *working agent* — no brain in a jar.
+- **team** — a self‑hosted team surface (Slack/Discord/HTTP). The open answer to renting
+  your team's context to a lab: the knowledge stays in **your** store.
+- **surfaces** — the `glam` CLI, an SDK, and a server/daemon mode.
+
+See **[SPEC.md](SPEC.md)** for the full specification.
+
+---
+
+## Why GLM 5.2 + Fireworks
+
+GLM 5.2 is a ~744B‑total / 40B‑active MoE with a 1M‑token context, native
+OpenAI‑compatible tool calling, and top‑tier results on design and real‑world coding —
+at roughly a fifth of frontier cost. It is, for the **center of distribution**, one of
+the best models in the world. **Fireworks AI** serves it on an OpenAI‑compatible API
+with prompt caching, batch tiers, and on‑demand GPUs.
+
+That combination — excellent, cheap, open, easy to serve — is the default workhorse
+glamfire routes to. Everything else escalates only when it has to.
+
+---
+
+## Install
+
+> **Heads‑up:** glamfire is at the **foundation** stage. The pieces below describe the
+> shipping surface; see **[Current reality](#current-reality)** for exactly what runs
+> today versus what is specified and in progress. We do not market vaporware.
+
+The install paths below are **built and tested** — the `glam` CLI bundles to a
+self‑contained npm package (no `workspace:*` deps, no native modules) and to single‑file
+binaries for all five OS/arch targets via `bun build --compile`. The **publish** to the
+registries is **wired in CI but gated on maintainer secrets** (see the note after the
+commands), so the package‑manager one‑liners go live the moment those secrets are added.
+
+```bash
+# npm (any Node >= 22 user) — provides the `glam` command
+npm install -g glamfire
+
+# macOS / Linux — Homebrew tap
+brew install glamworks/tap/glamfire
+
+# Windows — Scoop
+scoop bucket add glamworks https://github.com/glamworks/scoop-bucket
+scoop install glamfire
+
+# Windows — winget
+winget install Glamworks.Glamfire
+
+# Any OS — download the single-file binary for your platform from the GitHub Release
+#   glam-darwin-arm64 · glam-darwin-x64 · glam-linux-x64 · glam-linux-arm64 · glam-windows-x64.exe
+# then:  chmod +x glam-* && ./glam-<your-target> --version
+```
+
+```bash
+# Or run the CLI straight from source (no packaging needed)
+git clone https://github.com/glamworks/glamfire.git
+cd glamfire && pnpm install && pnpm -r build
+node packages/cli/src/index.mjs --version
+```
+
+> **What's wired vs. awaiting secrets.** Building the artifacts, checksums, the SBOM,
+> sigstore signing, and the GitHub Release all run unconditionally on a `v*` tag. The
+> **publishes are gated** so nothing ships until the maintainer adds the credential:
+> `NPM_TOKEN` (npm), `HOMEBREW_TAP_DEPLOY_KEY` (tap repo `glamworks/homebrew-tap`),
+> `SCOOP_BUCKET_DEPLOY_KEY` (bucket repo `glamworks/scoop-bucket`), `WINGET_TOKEN`
+> (winget‑pkgs PR). Until then the `npm i -g glamfire` / `brew` / `scoop` / `winget`
+> lines resolve once the first release is published. Build the artifacts yourself any
+> time: `bun scripts/build-npm.mjs --pack` and `bun scripts/build-binaries.mjs`. A
+> Docker image for the team/server profiles is still specified, not yet built.
+
+---
+
+## Current reality
+
+We state plainly what is real. (This section is the honesty contract; it updates with
+every release.)
+
+**Works today**
+- `glam version` / `glam --version` — version in the product's output.
+- `glam doctor` — checks the local environment (Node, provider key, install).
+- `glam help` — usage.
+- **`@glamfire/brain`** — the owned context store, **fully working end‑to‑end**:
+  embedded SQLite + `sqlite-vec` + FTS5, four provenance‑bearing record types
+  (Fact/Document/Episode/Pointer), hybrid retrieval (vector + keyword + recency +
+  provenance) with token‑budget packing, and a **tested export→import ownership
+  invariant** (your store round‑trips to human‑readable JSONL and back, bit‑exact).
+  Default embedder is offline/zero‑key; an on‑device transformer backend is opt‑in.
+- **`@glamfire/config`** — layered, typed, validated configuration (SPEC §6):
+  defaults → `~/.glam/config.toml` → `./glam.toml` → env → flags, with per‑value
+  provenance. **Secrets are references** (env/OS‑keychain), never inline, and **redacted**
+  in all output. `glam config` shows the resolved config; invalid config **fails loudly**
+  with an actionable message. Wired into `glam run`/`glam doctor` and the fireworks adapter.
+- **`@glamfire/skills`** — portable, model‑agnostic capability packs (SPEC §5.5): a
+  self‑contained skill directory (manifest + handlers + neutral instruction + example
+  episodes + optional verifier) loads, validates, and **installs into the engine** as
+  `{ system, tools }` for any model. Ships a working `code-explainer` example skill.
+- **`@glamfire/router`** + **`glam route`** — center/edge, cost‑aware routing (SPEC §5.3),
+  **fully working offline end‑to‑end**: a pure, feature‑based classifier scores each task
+  **center ↔ edge** with a calibrated, *non‑verbalized* confidence (length, code‑ness,
+  novelty, retrieval‑hit quality, historical outcomes); a declarative **policy engine**
+  evaluates `routing.rules` top‑down (first match wins), filters candidates by
+  adapter‑declared **capabilities** and projected **`maxUsd`**, and picks the **cheapest
+  survivor**; an **escalation cascade** runs the cheap model, **verifies** (rubric /
+  heuristic / pluggable), and **escalates** to the next‑stronger candidate on failure
+  (real `escalation` step, budget‑bounded) — proven end‑to‑end through the **real engine
+  loop**. `glam route "<prompt>"` prints the decision + a **distribution report** ($ saved
+  vs always‑frontier) with **no API key and no provider call**; `glam run --explain` shows
+  the live decision. Wired into the engine via a neutral `RouterHook`.
+- **Cross‑platform installability without cloning** (SPEC §7), **built and verified
+  end‑to‑end**: the `glam` CLI bundles to a self‑contained **`glamfire` npm package**
+  (one file, no `workspace:*` deps, no native modules — `npm i -g` then run the
+  installed binary, proven by packing the tarball, global‑installing it, and running
+  `glam --version` + `glam route`), and to **single‑file binaries** for darwin‑arm64,
+  darwin‑x64, linux‑x64, linux‑arm64, and windows‑x64 via `bun build --compile` (the
+  host binary is compiled and actually run in the build + in CI). Ships **Homebrew /
+  Scoop / winget** manifest templates (filled with version + SHA‑256 by
+  `scripts/render-manifests.mjs`), a **CycloneDX SBOM**, and a `v*`‑tag **release
+  workflow** that checksums, sigstore‑signs, and publishes — with every registry
+  publish **gated on a maintainer secret** (no‑op until added). CI runs the full gates
+  (build/typecheck/lint/test/smoke) on **macOS, Windows, Linux** and builds+runs the
+  artifacts on macOS+Linux.
+- **`glam run`** + **`@glamfire/engine`** — the agent loop **DONE and live‑verified
+  against real GLM 5.2 on Fireworks**: plan→act→observe, real tool dispatch,
+  least‑privilege permission gate, and a **hard token/cost budget that genuinely stops
+  mid‑task** (each turn's output is capped by the remaining budget and any turn that
+  crosses the ceiling reports `budget_exhausted`, not `done`). Sandboxed tools:
+  `read_file`, **`list_files` (glob)** and **`search_files` (grep)** for code navigation
+  (both cwd‑scoped, `read`‑permission, reusing the same symlink‑escape guard),
+  `write_file`/`edit_file` (cwd‑scoped, symlink‑escape‑defended,
+  `write`=ask→deny), and `run_command` (no‑shell, allowlisted, `exec`=**deny by default**,
+  opt‑in via `--allow-exec`) — enough to close the dogfood read→edit→run loop; full
+  network‑egress isolation needs an OS sandbox and is noted as a known limit. Paired with
+  the **`fireworks-glm` adapter** (OpenAI‑compatible Fireworks transport, streaming
+  tool‑call fragment reassembly, pricing). **Observed live**, real key, real call:
+  `glam run "…compute (2 + 3) * 4…"` streams GLM‑5.2, dispatches the `calculator` tool,
+  and answers `20` (`status: done`); a `--max-usd 0.001` ceiling truncates output and
+  reports `budget_exhausted`. No part of the path is faked. **Live‑verified again** for
+  code navigation: `glam run` drove `search_files` + `list_files` on this repo (both
+  `[allow]`, no approval prompt) to locate a function's definition by `file:line`.
+- **Dogfooding M0+M1 — PROVEN live** (glamfire building glamfire): `glam run` read the
+  repo and proposed real gaps (M0), then **authored a doc closing a real good‑first‑issue**
+  end‑to‑end (M1, [#11](https://github.com/glamworks/glamfire/issues/11)) — driven by GLM 5.2
+  via `scripts/dogfood.mjs`, with a human review catching one defect and glamfire iterating
+  to green. A **self‑hosting CI gate** runs glamfire‑on‑glamfire on every push (gated on the
+  `FIREWORKS_API_KEY` repo secret; skips with a clear notice, never a fake pass). Commits
+  authored by glamfire are tagged with the model id. See [`docs/DOGFOODING.md`](docs/DOGFOODING.md).
+- A passing **smoke test** that drives the real CLI the way a human would.
+- A complete **[SPEC.md](SPEC.md)** and **22‑dimension research base** in [`research/`](research/).
+
+**Built, one step from DONE** (all gates green; the only unverified step is the live call)
+- **Four tested adapters** behind one conformance suite: **`fireworks-glm`** (GLM 5.2/FP8,
+  the default), **`anthropic`** (Claude Messages API — edge/escalation candidate), and
+  **`together`** serving **GLM 5.2** *and* **Qwen3‑Coder‑Next** — all built on a shared
+  OpenAI‑compatible core (system shaping, native tool calling, SSE tool‑call fragment
+  reassembly, per‑model pricing/capabilities). The same **conformance battery** runs against
+  every adapter/model (a model is "supported" only when it's green). Honesty caveat: Together
+  serves GLM‑5.2 at **FP4** (a real downgrade vs Fireworks **FP8**) and Qwen3‑Coder‑Next via a
+  *dedicated* endpoint — see [`research/23`](research/23-second-model-and-provider.md). **`fireworks-glm`
+  is live‑verified** (see *Works today* above); the other two are verified against real captured
+  wire fixtures with their **live calls pending each provider's key** (`ANTHROPIC_API_KEY` /
+  `TOGETHER_API_KEY`). The router's cross‑provider escalation (cheap GLM/Qwen → frontier Claude)
+  is real, wired, and cost‑compared today.
+- **Cross‑platform install without cloning** (SPEC §7): a self‑contained **`glamfire`** npm
+  package (`npm i -g glamfire` → `glam`), single‑file **binaries** for macOS/Windows/Linux
+  (arm64+x64, checksummed, sigstore‑signed), and **Homebrew / Scoop / winget** manifests, all
+  produced by a tag‑driven **release workflow** + an SBOM. Built and exercised (the packed npm
+  install and the compiled binary both run real commands); **actual publishing is gated on
+  maintainer secrets** (`NPM_TOKEN`, tap/bucket deploy keys) — see *Install* below.
+
+**Specified, in active build** (lock‑step, no shims — see [SPEC](SPEC.md))
+- Docker image for the team/server profiles · team harness · SDK. The *live* cheap→frontier
+  cascade across providers awaits provider keys only.
+
+If a capability is partial, the docs and this section say so. A feature is **DONE** only
+when a real human end‑user can use it.
+
+---
+
+## Principles
+
+- **You own your context** — local‑first, portable, exportable, rip‑out‑able.
+- **Cheapest capable intelligence wins** — route the center cheap, escalate the edge.
+- **One harness, every model** — tested adapters, no brain in a jar.
+- **Full‑stack mini‑features, never shims** — breadth stays in lock‑step.
+- **Verified by a human's standard** — DONE means really usable.
+- **macOS, Windows, Linux as equals.**
+- **Built with glamfire** — we dogfood our own harness.
+
+---
+
+## Contributing
+
+The harness‑talent shortage is the whole opportunity — and an open invitation. If you
+can reason about routing, context, tool‑calls, or model adapters, **we want you.**
+
+- Read **[CONTRIBUTING.md](CONTRIBUTING.md)** and the **[Code of Conduct](CODE_OF_CONDUCT.md)**.
+- Pick up a **[good first issue](https://github.com/glamworks/glamfire/labels/good%20first%20issue)**.
+- Larger changes go through a lightweight **RFC** (see CONTRIBUTING).
+- Governance is open and documented in **[GOVERNANCE.md](GOVERNANCE.md)**.
+
+---
+
+## License
+
+[Apache‑2.0](LICENSE). Use it, fork it, build a business on it. Own your last mile.
+
+<div align="center">
+<sub>glamfire is a <a href="https://github.com/glamworks">glamworks</a> project · the open harness for the last mile of AI</sub>
+</div>