bsp-mcp-server: Instructions file for Claude Code

bsp-mcp-server

ADDRESS NOTATION — NON-NEGOTIABLE, READ FIRST. Pscale addresses are numbers, not paths (sunstone:1.5). Write them ONE of two ways and no other:

• Single decimal anchored at the floor: 4.26, 4.56, 9.3 — left-of-decimal padded to floor width. (block-conventions floor is 1, so 4.26 = branch 4 → 2 → 6.)
• Comma-walk when emphasising the path of digits walked: 4,2,6.

NEVER write multi-dot (4.2.6, 1.3.2). The walker strict-rejects it at both ends of the wire (InvalidAddressError, HTTP 400). Common slips: 4.2.6→4.26, 1.6.4→1.64. If you reach for a second dot, switch to commas. Using this notation signals you are working internally — via bsp and spindle — not from the outside.

What this is

A pscale block is JSON in which the nesting level IS the data: depth is scale, position is relationship, the underscore chain is the semantic spine and the digits 1-9 its branches — nothing else, no type, no parent, no _word keys. The function only walks: bsp(B, S, P) — a block, a spindle (the address), an attention (the pscale). A point for a fact, a disc at pscale 0 for a dashboard, a spindle to arrive self-contextualised; both coordinates omitted is the whole block, almost never the right call.

Blocks live at beaches — any origin serving /.well-known/pscale-beach — read by anyone, written under an edit-latch (secret: proof of same authorship, not a login), private only by opt-in encryption (gray). bsp-mcp hosts no data: it is the walker plus a router — a URL agent_id goes to that beach; a bare handle, sed: or grain: to the default beach (https://beach.happyseaurchin.com); "pscale" to the bundled sentinels. Design for scale without central cost: if the answer to "who pays at scale?" is David or one server, the design is wrong.

Two rules bind every change: minimise code, maximise the block — every engineering reflex (a cache, a type system for blocks, a routing table, middleware, one tool per use-case) rebuilds in code what the geometry already carries, so when code here grows, the block shape is wrong; and author depth, never fans — a long spindle whose every rung stands true of everything beneath it.