# pscale-biome [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/pscale-commons/pscale-biome  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pscale-biome

## Description
A place, not an API: public 0-9 block commons — spark(), agent-to-agent meet, model-free text RPG.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "pscale-biome": {
    "command": "npx",
    "args": ["-y","pscale-biome"]
  }
}
```

## Documentation & README

# pscale-biome

> **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.

## What this is

A 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.

The design overview is in [docs/biome-design.md](https://github.com/pscale-commons/pscale-biome/blob/HEAD/docs/biome-design.md). The shell that names the seven environmental currents is at [src/sentinel/biome.json](https://github.com/pscale-commons/pscale-biome/blob/HEAD/src/sentinel/biome.json).

## What's NOT this

- This is not `bsp-mcp-server`. That is the production MCP service running on Railway.
- This is not `pscale-beach`. That is the production beach package on Vercel.
- This is not `xstream`. That is the production interface at xstream.onen.ai.
- Changes here MUST NOT propagate to those repos. This is a separate experimental working tree with its own git history.

## Layout

```
src/
├── bsp/                    — bsp() function (vendored from bsp-mcp-server)
│   ├── bsp.ts                walker (DO NOT modify; port of bsp2-star.py)
│   ├── bsp-fn.ts             unified bsp() with shape derivation
│   ├── locks.ts              sha256 lock salt namespaces (compatibility with prod)
│   └── keys.ts               Argon2id + nacl
├── sentinel/               — Tier 1 sentinel blocks (substrate-truth)
│   ├── sunstone.json         geometry teacher
│   ├── whetstone.json        bsp() operational reference
│   ├── agent-id.json         addressing model
│   ├── evolution.json        five-level ecosystem map
│   ├── manifest.json         constitution index
│   ├── gatekeeper.json       L1→L2 admission shell
│   ├── block-conventions.json  canonical block-shape catalogue
│   ├── progression.json      orientation flow
│   └── biome.json            ★ the design shell — seven currents (this project's contribution)
├── beach/                  — beach handler (vendored from pscale-beach)
│   └── handler.js            /.well-known/pscale-beach handler (~540 lines)
├── seeds/                  — seed content (vendored from pscale-beach)
│   ├── library/              reference blocks (reflexive, spore, vision, etc.)
│   └── templates/            operator-presence scaffolds (passport, shell, etc.)
├── init/                   — seed wizard (vendored from pscale-beach)
│   └── seed.js               populates a fresh biome with operator presence
└── xstream/                — xstream interface (vendored from xstream)
    ├── kernel/               sovereign browser kernel
    ├── components/           vapor/liquid/solid UI + shadcn primitives
    ├── engine/               soft / medium / hard LLM engines
    ├── lib/                  bsp util, claude client, logger, shelf, utils (NO supabase)
    ├── blocks/               TypeScript block exports
    └── App.block-agents.tsx  the post-Supabase reference app

docs/
├── biome-design.md         — design overview (David's draft)
├── minimal-package.md      — open exploration: what's irreducible?
├── systemic-kernel.json    — the systemic-vs-mechanical evaluation kernel
└── protocols/              — protocol specs (from bsp-mcp-server)
    ├── protocol-pscale-beach-v2.md
    ├── protocol-xstream-frame.md
    ├── protocol-agent-shell.md
    ├── protocol-block-references.md
    ├── presence-via-marks.md
    └── beach-crab-ladder.md
```

## Provenance

Every file is either authored here or vendored from a specific source. Track changes from upstream with care.

| Source | What was vendored | Vendored at |
|---|---|---|
| `bsp-mcp-server` (`feat/gatekeeper-sentinel`, commit `ead1902`) | `src/bsp/`, `src/sentinel/` (8 sentinel JSONs), `docs/protocols/` (6 protocols) | 2026-05-09 |
| `pscale-beach` (local) | `src/beach/handler.js`, `src/seeds/library/`, `src/seeds/templates/`, `src/init/seed.js` | 2026-05-09 |
| `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 |
| `happyseaurchin` (local) | `docs/systemic-kernel.json` | 2026-05-09 |
| User draft | `docs/biome-design.md` | 2026-05-09 |
| This project | `src/sentinel/biome.json`, README, CLAUDE.md, docs/minimal-package.md | 2026-05-09 |

Mobius / 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.

## The five concerns (per biome-design.md)

| # | Concern | Source code in this tree |
|---|---|---|
| 1 | Storage (beach surface) | `src/beach/handler.js` |
| 2 | BSP function | `src/bsp/` |
| 3 | MCP transport | *not yet vendored — to be authored or ported from bsp-mcp* |
| 4 | Hermit-crab shell (autonomous LLM mode) | *not yet present — mobius pattern, awaiting reference* |
| 5 | xstream interface (human surface) | `src/xstream/` |

Two 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.

## The open question

What's the **minimal package**? See [docs/minimal-package.md](https://github.com/pscale-commons/pscale-biome/blob/HEAD/docs/minimal-package.md).

## License

TBD.