# Anthrocybernetics Core Workbook CookieBlob Preview — Build SOP v0.1

**Project:** Anthrocybernetics Core Workbook CookieBlob Preview  
**Build type:** Standalone browser preview and source mirror  
**Version:** 0.1  
**Status:** Initial build  
**Date:** 2026-08-04

## 1. Product decision

Create a single, dependency-free `index.html` that acts as the front door to the Anthrocybernetics Core Workbook. The preview should feel like a CookieBlob room: a navigable archive, persistent local state, visible transmissions, and a portable JSON seed.

The HTML is a preview and reading instrument, not a replacement for the canonical Markdown workbook. The published workbook remains the source of truth. The project keeps a local source mirror under `source/` so the preview can be rebuilt and audited.

The primary loop is:

> enter the archive → choose a focus → read a room → mark the observation → leave a transmission → return with a seed

## 2. Scope

### Included

- One standalone `index.html`.
- Workbook orientation and core grammar preview.
- All 16 core chapters.
- All 16 applied modules.
- Contents, changelog, and source SOP as archive rooms.
- Search across room titles, summaries, and full text.
- Guided sequence plus direct room navigation.
- Five Foci visual card: Phase, Field, Arc, Form, Lattice.
- Evidence status labels: Grounded, Hypothesized, Interpretive.
- Reading progress persisted in browser `localStorage`.
- Reader notes persisted in browser `localStorage`.
- Transmission rail showing room visits, notes, and seed events.
- JSON seed export/import.
- Explicit reset for this preview only.
- Responsive layout and keyboard-friendly controls.
- No external JavaScript libraries, images, fonts, accounts, or server-side state.

### Excluded

- Editing or rewriting the canonical workbook from the browser.
- Server-side saves, accounts, comments, analytics, or multiplayer.
- Claims that CookieBlob persistence is shared across browsers or visitors.
- Automatic fetching from zo.pub at runtime.
- Full Markdown specification support.
- Reproducing every workbook page as a separate website route.

## 3. Source contract

The source mirror is downloaded from:

`https://zo.pub/anthrocybernetics/anthrocybernetics-core-workbook`

The source directory contains the published Markdown and original HTML summary. The builder reads Markdown files from:

`source/anthrocybernetics-core-workbook/`

The builder must not silently invent or rewrite source prose. Preview-specific summaries, labels, and room metadata may be added around source text, but the rendered room body comes from the mirrored Markdown.

## 4. CookieBlob state contract

Use a dedicated namespace so this preview does not collide with other CookieBlob rooms:

```js
const STORAGE_KEY = "cookieblob_anthrocybernetics_preview_v01";
```

Canonical state shape:

```js
{
  version: "0.1",
  room: "opening-and-orientation",
  visited: [],
  completed: [],
  notes: {},
  transmissions: [],
  focus: "Phase",
  updated_at: null
}
```

State rules:

1. Invalid or missing local state falls back to a fresh state.
2. Imported seeds must match the expected version and basic object shape.
3. Room IDs are selected from the generated room registry; unknown IDs fall back to the opening room.
4. Notes are plain text and rendered escaped.
5. Transmissions are capped at the most recent 80 entries.
6. Completed rooms are idempotent.
7. Every state-changing action updates `updated_at`.
8. Reset affects only this preview namespace.
9. Exported seeds contain reading state and notes, not executable content.

## 5. Architecture

```text
source/*.md
    |
    +-- build.py: room registry + embedded Markdown payload
    |
    +-- index.html: CSS shell + archive UI + CookieBlob state
              |
              +-- state load / validate / save
              +-- room navigation / search / guided sequence
              +-- Markdown preview renderer
              +-- notes / completion / transmissions
              +-- seed export / import / reset
```

The generated HTML must remain usable from a local file, zo.pub, and a WordPress Custom HTML context where inline scripts are allowed. Do not require fetch requests for the embedded workbook content.

## 6. Visual and interaction system

Use a warm archive-terminal aesthetic rather than a literal game interface:

- deep ink background;
- brass, amber, moss, cyan, and magenta accents;
- monospace metadata with readable proportional body text;
- bordered room cards and a persistent transmission rail;
- CSS states that remain understandable without color alone;
- normal buttons for every important action;
- `aria-live` for notices and readable labels for progress.

The Five Foci are navigation lenses, not scores. Evidence labels are epistemic status markers, not authority rankings. The preview must preserve the workbook's distinction between observation, hypothesis, and interpretation.

## 7. Acceptance tests

### Build

- `python3 build.py` completes without errors.
- `index.html` is generated in the project root.
- The generated page contains the expected 36 source rooms: 16 core chapters, 16 applied modules, and 4 reference rooms.
- No external runtime dependency is required.

### Browser behavior

- Opening `index.html` shows the archive entrance and room list.
- Selecting a room changes the main reading pane without a page reload.
- Search finds terms in room titles and body text.
- Marking a room complete survives reload.
- Notes survive reload and are shown in the transmission rail.
- Export produces a JSON seed.
- Import accepts a valid seed and rejects malformed or wrong-version data without destroying current state.
- Reset requires confirmation and clears only this preview's state.
- Narrow screens remain usable without hidden critical controls.

### Content boundary

- The preview identifies itself as a preview.
- The canonical zo.pub workbook link is visible.
- The page does not present metaphorical or hypothesized claims as measured fact.
- The source mirror and SOP are included in the published collection.

## 8. Publishing workflow

1. Refresh `source/` from the canonical workbook when a new revision is available.
2. Run `python3 build.py`.
3. Open `index.html` locally and test navigation, search, note persistence, and seed import/export.
4. Sync the project directory with:

```bash
zopub sync anthrocybernetics-core-workbook-cookieblob /home/workspace/AnthroCybernetics/anthrocybernetics-core-workbook-cookieblob
```

5. Report the collection URL and identify the preview entry point:

`https://zo.pub/tenchi/anthrocybernetics-core-workbook-cookieblob/index.html`

## 9. Future revisions

- Add a WordPress-safe room export only if the standalone preview proves useful.
- Add facilitator or practitioner pathways as curated sequences, without changing source-room content.
- Consider a separate notes export if users need to share reflections without sharing all reading state.
- Keep the preview deliberately bounded; a full interactive course platform should become a separate project.