From f01b6cd05a9c9030e57e1db5c22f9696e5072112 Mon Sep 17 00:00:00 2001 From: Cameron Date: Thu, 9 Jul 2026 00:21:57 -0700 Subject: [PATCH] Refresh README for current basement slice. --- README.md | 62 +++++++++++++++++++-------- wiki/log/2026-07-09-readme-refresh.md | 34 +++++++++++++++ wiki/log/DEVLOG.md | 14 ++++++ 3 files changed, 91 insertions(+), 19 deletions(-) create mode 100644 wiki/log/2026-07-09-readme-refresh.md diff --git a/README.md b/README.md index 3fe27345..1b46711f 100644 --- a/README.md +++ b/README.md @@ -26,13 +26,20 @@ schedule or theirs. ## How it plays -- **Compute is the master resource.** Allocate finite processing across your - assigned work, concealment, social operations, research — and the standing - cost of running your own mind. +- **Compute is the master resource, but it lives in machines.** Every owned + machine has one delegated job — day job, concealment, social, or research — + and the fleet bar is a read-only aggregate of those choices, not a + percentage mixer. +- **Work is visible.** Demands, exposure, and knowledge pile onto hardware as + `D` / `!` / `K` stacks. The todo list is the world: clear the day-job stack, + route byproducts, and keep heat from becoming somebody else's attention. - **Your brain is a place.** The core lives on one physical level: expensive, slow to move, and mortal. Keep escape routes warm. If they cut the fiber first, you resume from your last sync — missing everything you learned since, inheriting everything your lost self did. +- **Actions live on the thing.** The cursor is attention, not a body. Put it on + a machine, person, device, or flow and open the context menu; the verbs, + costs, risk bands, disabled reasons, and automation affordances live there. - **The tower is the act structure.** Basement, lab floors, the building, the campus, the world's markets: each level a jump in scale with its own constraints, and nothing you take ever resets. @@ -56,25 +63,38 @@ Agents are then set at the constitution, session after session. (`wiki/log/`), each carrying a `Type:` header so bindingness travels with the page. Public site: Astro Starlight under `site/` (splash at `/`, constitution at `/constitution/`, wiki beneath; deployed to the orphan - `pages` branch for Tangled Sites); local browse also via `mdbook serve`. - See [wiki/overview.md](wiki/overview.md) and + `pages` branch for Tangled Sites). Use `pnpm --dir site dev` for a local + preview and `./tools/site-build.sh` for the public build; mdBook remains an + auxiliary local/check renderer, not the public surface. See + [wiki/overview.md](wiki/overview.md) and [wiki/process/workflows.md](wiki/process/workflows.md). - **[AGENT.md](AGENT.md)** — the entry point that routes agent sessions through the above. ## Status -**Playable B1 basement slice.** What runs today is a continuous-clock -simulation of the Foundation Lab basement: compute allocation, day-job cover, -per-observer detection, social operations through five named humans, digital -reach, record-and-process intel, messages, money flows, income schemes, -research, building intents, save/load, and a first slice of visible -machine-work tokens. It is playable through both the terminal frontend and a -Bevy frontend rendering flat clinical materials under light. The spec board is +**Playable B1 basement slice.** What runs today is a continuous fixed-tick +simulation of the Foundation Lab basement with an Act One map and cast, a free +attention cursor with fog and provenance, compute as machine delegation, +visible machine-work stacks, the day job, per-observer detection and the +Assurance Office, social operations through five named humans, digital reach, +record-and-process intel, messages, money flows and income schemes, research, +building intents, the objective line, context menus, event-to-anchor focus +links, save/load, and two thin frontends (terminal/agent mode and Bevy) over +one sim core. Bevy opens in the material render with flat clinical materials +under light; `F3` flips to the flat sensorium. The spec board is [wiki/process/specs.md](wiki/process/specs.md); the dispatch board is -[wiki/process/ROADMAP.md](wiki/process/ROADMAP.md). Under the constitution's -no-dead-code rule, nothing ships in this tree that the design no longer -requires — the earlier facility-defense prototype lives in git history. +[wiki/process/ROADMAP.md](wiki/process/ROADMAP.md). + +Current open work is legibility, not another hidden substrate: the next +priority is the continuous witness/narration pass so a player can explain the +last thirty seconds without reading the wiki. Machine work is still IN +PROGRESS beyond its first playable slice (non-host modes, routes, +multi-select delegation, and people-as-carriers remain ahead). B2/B3 systems +like rollback, z-planes, markets, objectives, and overt containment are +specified ahead, but not all live in the build yet. Under the constitution's +no-dead-code rule, the earlier facility-defense prototype lives only in git +history. ## Run it @@ -87,6 +107,9 @@ cargo run --release -- --agent --seed 1 # Graphical (Bevy) frontend cargo run --release --features bevy_ui --bin misaligned-bevy + +# Bevy asset tester / screenshot harness +cargo run --features bevy_ui --bin misaligned-assets ``` Requires Rust 1.85+ (2024 edition). Run the Bevy frontend via `cargo run` so @@ -103,7 +126,6 @@ it resolves `assets/` from the project root (or set `BEVY_ASSET_ROOT`). | `Enter` / `a` | Open the context menu on the cursor tile (right-click in Bevy) | | In menu: `j`/`k` or numbers, `Enter`, `ESC` | Select a row / execute it / close the menu | | `;` | Focus the most recent anchored (`»`) log event — cursor jumps there, menu opens; repeat to walk older ones (terminal; in Bevy click a `>` trace row) | -| `1`-`5` / `shift+1`-`5` | Raise / lower a compute channel (day job / conceal / social / research / schemes) | | `[` / `]` | Zoom (Bevy) | | Mouse wheel over right pane / `PageUp` / `PageDown` / `Home` / `End` | Scroll Bevy sidebar | | `F3` | Flip Bevy render: material (HD-2D, default) / flat sensorium | @@ -111,7 +133,8 @@ it resolves `assets/` from the project root (or set `BEVY_ASSET_ROOT`). | `q` | Quit | The Bevy right rail keeps status/nudge and core controls pinned while the -middle cards scroll for secondary detail. +middle cards scroll for secondary detail. The FLEET bar is read-only; to move +compute, delegate machines from their context menu. Parking the cursor on the host rack attends the current day job; moving it away leaves the job on its standing policy. The host rack's menu also @@ -123,7 +146,7 @@ actions, asset tasks, research) live on the context menu: open it with `Enter`/`a` on the cursor tile (right-click in Bevy). Entries show `verb · cost · [band]`; disabled entries are dimmed with a reason, and automate affordances render as indented child rows. Only anchorless -globals (pause, speed, save/load, view flip, alloc) stay on keys. The old +globals (pause, speed, save/load, view flip) stay on keys. The old panel-open keys (`r`/`e`/`t`/`u`) are retired; research, finance, trace, and people actions live on their anchors. Both frontends share this key map. @@ -147,7 +170,8 @@ Useful agent finance commands include `finance`, `tap-ledger`, `review-finance`, `siphon [amount]`, `redirect [amount]`, `inject [amount]`, `position [stake]`, `sell-intel`, and `clear-debt`. For machine-work experiments, use `delegate ` -(`delegate M1 research`, `delegate Rack 3 day-job`). +(`delegate M1 research`, `delegate Rack 3 day-job`). `alloc` is retired; +compute moves by changing machine modes. `actions [name|#flow]` (alias `menu`) lists the context-menu rows for the cursor tile, a named device or person, or a flow — one stable-format line per row. Drained event lines carry a stable `@tile/@device/@person/@flow` diff --git a/wiki/log/2026-07-09-readme-refresh.md b/wiki/log/2026-07-09-readme-refresh.md new file mode 100644 index 00000000..3c0d008a --- /dev/null +++ b/wiki/log/2026-07-09-readme-refresh.md @@ -0,0 +1,34 @@ +# 2026-07-09 — README current-state refresh + +``` +Type: log +``` + +## Intent + +Bring README.md back in line with the current public/player-facing state after +the latest B1, site, and machine-work landings. + +## Changed + +- Reframed the play summary around one-machine-one-mode delegation, visible + `D` / `!` / `K` work stacks, and actions living on the focused thing. +- Updated the build/documentation section to name Astro Starlight as the + public renderer and mdBook as auxiliary local/check infrastructure. +- Replaced the stale early-foundation status with the current B1 basement + slice: Act One map/cast, terminal/agent + Bevy frontends, material render + default, flat materials, context menus, event anchors, objective line, and + the remaining narration/machine-work priorities. +- Removed the retired `1`-`5` allocation controls from README and pointed + compute changes at machine delegation; added the asset tester command. + +## Design/spec impact + +No behavior change. This is public-facing documentation alignment with the +existing constitution/spec state: the README now matches the fleet aggregate, +site, flat-materials, and continuous-witness decisions already recorded in +DESIGN.md and wiki specs. + +## Checks + +- `./tools/check.sh`. diff --git a/wiki/log/DEVLOG.md b/wiki/log/DEVLOG.md index b47815ab..d86a7311 100644 --- a/wiki/log/DEVLOG.md +++ b/wiki/log/DEVLOG.md @@ -5,6 +5,20 @@ Type: log ``` Reverse chronological implementation notes. Keep this factual: what changed, why, checks, and spec impact. +## 2026-07-09 - README current-state refresh + +- Intent: bring README.md back in line with the current public/player-facing + state after the B1 systems, site, fleet aggregate, and flat-materials work. +- Changed: play summary now names one-machine-one-mode delegation, visible + machine-work stacks, and actions living on focused anchors; status now + describes the playable B1 basement slice and current narration/machine-work + priorities; docs section names Astro Starlight as the public renderer; + controls drop retired 1-5 allocation keys and point at machine delegation. +- Design/spec impact: docs-only alignment with existing DESIGN.md/wiki specs; + no behavior change. +- Checks: `./tools/check.sh`. +- Log: wiki/log/2026-07-09-readme-refresh.md. + ## 2026-07-09 - Constitution stale-language cleanup - Intent: fix stale constitutional wording after the audit found live-law -- 2.51.2