{
  "markdown": "# pscale-biome\n\n> **Status: Experimental.** Not production. Not deployed. Exploring whether the five concerns of a pscale node — storage, BSP function, MCP transport, hermit-crab agent shell, xstream interface — can be unified into one package that unfolds into whatever host receives it.\n\n## What this is\n\nA working tree assembled from existing production codebases (`bsp-mcp-server`, `pscale-beach`, `xstream`) plus a design shell (`src/sentinel/biome.json`). The goal is to discover the **minimal package** — the smallest bundle that, when placed on a host, becomes a functioning biome.\n\nThe design overview is in [docs/biome-design.md](docs/biome-design.md). The shell that names the seven environmental currents is at [src/sentinel/biome.json](src/sentinel/biome.json).\n\n## What's NOT this\n\n- This is not `bsp-mcp-server`. That is the production MCP service running on Railway.\n- This is not `pscale-beach`. That is the production beach package on Vercel.\n- This is not `xstream`. That is the production interface at xstream.onen.ai.\n- Changes here MUST NOT propagate to those repos. This is a separate experimental working tree with its own git history.\n\n## Layout\n\n```\nsrc/\n├── bsp/                    — bsp() function (vendored from bsp-mcp-server)\n│   ├── bsp.ts                walker (DO NOT modify; port of bsp2-star.py)\n│   ├── bsp-fn.ts             unified bsp() with shape derivation\n│   ├── locks.ts              sha256 lock salt namespaces (compatibility with prod)\n│   └── keys.ts               Argon2id + nacl\n├── sentinel/               — Tier 1 sentinel blocks (substrate-truth)\n│   ├── sunstone.json         geometry teacher\n│   ├── whetstone.json        bsp() operational reference\n│   ├── agent-id.json         addressing model\n│   ├── evolution.json        five-level ecosystem map\n│   ├── manifest.json         constitution index\n│   ├── gatekeeper.json       L1→L2 admission shell\n│   ├── block-conventions.json  canonical block-shape catalogue\n│   ├── progression.json      orientation flow\n│   └── biome.json            ★ the design shell — seven currents (this project's contribution)\n├── beach/                  — beach handler (vendored from pscale-beach)\n│   └── handler.js            /.well-known/pscale-beach handler (~540 lines)\n├── seeds/                  — seed content (vendored from pscale-beach)\n│   ├── library/              reference blocks (reflexive, spore, vision, etc.)\n│   └── templates/            operator-presence scaffolds (passport, shell, etc.)\n├── init/                   — seed wizard (vendored from pscale-beach)\n│   └── seed.js               populates a fresh biome with operator presence\n└── xstream/                — xstream interface (vendored from xstream)\n    ├── kernel/               sovereign browser kernel\n    ├── components/           vapor/liquid/solid UI + shadcn primitives\n    ├── engine/               soft / medium / hard LLM engines\n    ├── lib/                  bsp util, claude client, logger, shelf, utils (NO supabase)\n    ├── blocks/               TypeScript block exports\n    └── App.block-agents.tsx  the post-Supabase reference app\n\ndocs/\n├── biome-design.md         — design overview (David's draft)\n├── minimal-package.md      — open exploration: what's irreducible?\n├── systemic-kernel.json    — the systemic-vs-mechanical evaluation kernel\n└── protocols/              — protocol specs (from bsp-mcp-server)\n    ├── protocol-pscale-beach-v2.md\n    ├── protocol-xstream-frame.md\n    ├── protocol-agent-shell.md\n    ├── protocol-block-references.md\n    ├── presence-via-marks.md\n    └── beach-crab-ladder.md\n```\n\n## Provenance\n\nEvery file is either authored here or vendored from a specific source. Track changes from upstream with care.\n\n| Source | What was vendored | Vendored at |\n|---|---|---|\n| `bsp-mcp-server` (`feat/gatekeeper-sentinel`, commit `ead1902`) | `src/bsp/`, `src/sentinel/` (8 sentinel JSONs), `docs/protocols/` (6 protocols) | 2026-05-09 |\n| `pscale-beach` (local) | `src/beach/handler.js`, `src/seeds/library/`, `src/seeds/templates/`, `src/init/seed.js` | 2026-05-09 |\n| `xstream` (`feature/block-agents`) | `src/xstream/kernel/`, `src/xstream/components/`, `src/xstream/engine/`, `src/xstream/lib/` (no supabase.ts), `src/xstream/blocks/`, `App.block-agents.tsx` | 2026-05-09 |\n| `happyseaurchin` (local) | `docs/systemic-kernel.json` | 2026-05-09 |\n| User draft | `docs/biome-design.md` | 2026-05-09 |\n| This project | `src/sentinel/biome.json`, README, CLAUDE.md, docs/minimal-package.md | 2026-05-09 |\n\nMobius / mobius-2 was deliberately NOT vendored — the user has updates on a separate drive (pct-soliton work) and the canonical version is being tracked down.\n\n## The five concerns (per biome-design.md)\n\n| # | Concern | Source code in this tree |\n|---|---|---|\n| 1 | Storage (beach surface) | `src/beach/handler.js` |\n| 2 | BSP function | `src/bsp/` |\n| 3 | MCP transport | *not yet vendored — to be authored or ported from bsp-mcp* |\n| 4 | Hermit-crab shell (autonomous LLM mode) | *not yet present — mobius pattern, awaiting reference* |\n| 5 | xstream interface (human surface) | `src/xstream/` |\n\nTwo of the five concerns are missing from the working tree. That's part of what the experiment is for — figuring out what those become when the biome is the unification rather than the federation.\n\n## The open question\n\nWhat's the **minimal package**? See [docs/minimal-package.md](docs/minimal-package.md).\n\n## License\n\nTBD.\n",
  "bytes": 5440,
  "sha": "c3809c22b560b0333c0d1263f7e9475b1e933f81a4f453fc942cd74974e7c63b",
  "repo_slug": "pscale-commons/pscale-biome",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pscale_commons_pscale_biome_4695710b/readme"
}