# Where is it a thing?

**Design principle (home of the idea):**  
> Aligned layers (**glulam**): one classifier graph, one bus, twin geometries — **code** + **language**.  
> Product loop: **type → path → shadows → strain → action.**

That sentence lives in:

| Place | Role |
|-------|------|
| **This file** | Human map of *where the product exists* |
| [`ECOSYSTEM-MAP.md`](./ECOSYSTEM-MAP.md) | Full concept map (DAC · GlueLam · IronLine · T5 · ugrad…) |
| [`HOSTING.md`](./HOSTING.md) | Deploy mechanics (CF Pages · R2) |
| Runtime | `window.kbatchDict.corpus.livesAt()` · `shadowLiveEnvelope().designPrinciple` |
| UI chrome | Shadow Live stack chips · footer |

---

## The three “hosts” people mean

### 1. Cloudflare · **ugrad.ai** — *the product runtime*

| What | Where |
|------|--------|
| **Live SPA** | **`https://kbatch.ugrad.ai`** (CF Pages project **`ugrad-kbatch`**) |
| **Public Shadow Live** | **`https://kbatch.ugrad.ai/shadow`** → `shadow.html` |
| Alias | `dictionary.ugrad.ai` (optional custom domain) |
| Path alternate | `ugrad.ai/kbatch/` (proxy or Pages path) |
| **blank bridge** | Opens [blank](https://fornevercollective.github.io/blank/) + `BroadcastChannel('kbatch-blank')` |
| Analyzed packs (heavy) | R2 → **`https://data.ugrad.ai/kbatch/`** (optional) |
| Deploy | `npx wrangler pages deploy . --project-name=ugrad-kbatch` |
| Config | `wrangler.toml` · `public/_headers` · `public/_redirects` |

**This is where users open the thing every day.** Shadow Live, dictionary, Writer, buses (in-browser).

Org umbrella site: [ugrad](https://github.com/qbitOS/ugrad) · [ugrad.ai](https://ugrad.ai)

---

### 2. GitHub · **qbitOS** — *source of truth + contracts*

| What | Repo / path |
|------|-------------|
| **This product source** | Your checkout **`KBatch-dictionary`** (ship target for CF) · org twin **[qbitos-kbatch](https://github.com/qbitOS/qbitos-kbatch)** |
| **GlueLam contract** | [qbitos-gluelam](https://github.com/qbitOS/qbitos-gluelam) — no forked classifiers |
| **IronLine L0–L7 + bus** | [qbitos-iron-line](https://github.com/qbitOS/qbitos-iron-line) |
| **ugrad host / compliance** | [ugrad](https://github.com/qbitOS/ugrad) |
| **Monorepo (prefixes, DAC, steno, T5, kbatch PWA)** | [uvspeed](https://github.com/qbitOS/uvspeed) |
| **Org profile** | [github.com/qbitOS](https://github.com/qbitOS) |

**GitHub is where it is versioned, reviewed, and synced — not the daily type-once surface.**

---

### 3. X / Grok · **batch narrative** — *story + distribution, not runtime*

| What | Where |
|------|--------|
| **X Article composer** | In-app **X article** button → presentation blocks |
| **Export batch** | `exports/kbatch-x-article.txt` · Copy MD / LaTeX |
| **Grok thread** | Product read + “killer app” narrative (e.g. Shadow Live reply) |
| **Not** | Not a host for the engine, corpus, or buses |

**X/Grok is where the *story* of the index ships.** Runtime stays on ugrad.ai.

---

## Sibling live surfaces (same family, different URL)

| Surface | URL | Relation |
|---------|-----|----------|
| Full kbatch PWA | [mueee.qbitos.ai/kbatch.html](https://mueee.qbitos.ai/kbatch.html) | World analyzer + Quantum tab + drills |
| Quantum gutter | [mueee.qbitos.ai/quantum-gutter.html](https://mueee.qbitos.ai/quantum-gutter.html) | Code prefixes → QPU |
| Overview pipe | [fornevercollective.github.io/overview](https://fornevercollective.github.io/overview/) | Research workspace import |
| Local dev | `python3 -m http.server` in this repo | Same SPA |

Shadow Live **publishes** on `BroadcastChannel('iron-line' | 'kbatch-training' | 'quantum-loopback')` so those surfaces can hear it when open in the same browser profile.

---

## Stack 1–7 → where each layer “is a thing”

| # | Layer | Code in this repo | Lives at (runtime) | Lives at (source) |
|---|--------|-------------------|--------------------|-------------------|
| 1 | **Shadow Live** | `js/shadow-live.js` · `#shadow-live` | **kbatch.ugrad.ai** | GitHub product repo |
| 2 | **GlueLam consumer** | `js/gluelam-consumer.js` | Browser loads optional scripts; stubs offline | Modules owned by **uvspeed** / gluelam contract |
| 3 | **IronLine publish** | `js/ironline-bus.js` | In-browser bus (no server) | Spec: **qbitos-iron-line** |
| 4 | **Quantum bridge + preflight** | `js/quantum-bridge.js` | SPA UI · preflight stub or real `qbit-preflight.js` | Gate map aligned with gutter / kbatch |
| 5 | **Shadow Search** | `js/shadow-search.js` | SPA (cache + analyzed pool) | This repo |
| 6 | **ugrad host** | `wrangler.toml` · `docs/HOSTING.md` | **Cloudflare Pages `ugrad-kbatch`** | **qbitOS/ugrad** org |
| 7 | **Spatial / aito hooks** | `js/spatial-hooks.js` | Payload on bus + `__KBATCH_SPATIAL__` | Hosts: Overview / hexcast / aito TBD |

---

## One diagram

```
                         ┌──────────────────────┐
                         │   X / Grok batch     │
                         │   story · X article  │
                         └──────────▲───────────┘
                                    │ exports / posts
┌──────────────┐           ┌────────┴────────┐           ┌─────────────────┐
│   GitHub     │  deploy   │  Cloudflare     │  optional │  R2 data.ugrad   │
│   qbitOS     │ ────────► │  kbatch.ugrad.ai│ ◄──────── │  analyzed/*      │
│   source +   │           │  Shadow Live    │           └─────────────────┘
│   contracts  │           │  L4 runtime     │
└──────┬───────┘           └────────┬────────┘
       │                            │ BroadcastChannel
       │                            ▼
       │                   iron-line · kbatch-training
       │                   quantum-loopback · spatial
       │                            │
       └──────── specs ─────────────┴──► mueee kbatch · gutter · Overview
```

---

## API: ask the runtime

```js
// Where does this product live?
kbatchDict.corpus.livesAt()

// Full envelope including designPrinciple + livesAt
kbatchDict.corpus.lastShadowLive()
// or
window.__KBATCH_SHADOW_LIVE__
```

---

## Short answer to “where is it a thing?”

| If you mean… | Answer |
|--------------|--------|
| **Users type every day** | **Cloudflare → kbatch.ugrad.ai** |
| **Code & contracts** | **GitHub qbitOS** (this repo + gluelam + iron-line + uvspeed) |
| **Grok / X batch** | **Narrative + X Article export** — not the engine host |
| **Design principle home** | `docs/WHERE-IT-LIVES.md` + `docs/ECOSYSTEM-MAP.md` + envelope field `designPrinciple` |
| **Full keyboard/quantum PWA** | mueee **kbatch.html** (sibling, same family) |
| **Live documents / research product** | **overview.ugrad.ai** ← `/Users/qbit/dev/overview` |
| **Burst / glyph / live chat rooms** | **GrokYtalkY** (`/Users/qbit/Projects/GrokYtalkY`) |
| **Full ugrad live stack** | `overview/docs/agent/11-ugrad-live-product.md` |