Timmy_Foundation/timmy-config
15
0
Fork 0
Code Issues 140 Pull Requests 21 Actions Packages Projects Releases Wiki Activity

feat: Visual Mapping of Tower Architecture — holographic map #494 #530

Merged
Rockachopa merged 1 commits from burn/494-1776125702 into main 2026-04-14 00:36:39 +00:00
Conversation 0 Commits 1 Files Changed 2 +840 -8
Rockachopa commented 2026-04-14 00:21:32 +00:00
Owner
Copy Link

Implements #494 — Visual Mapping of Tower Architecture

Replaces the 12-line stub with a full holographic map builder. Scans the repo's design docs, gallery images, Evennia specs, and wizard configs to construct a structured spatial map of The Tower.

What was there before

# 12 lines — navigates to a URL, asks a vague vision question
def map_tower():
    browser_navigate(url="https://tower.alexanderwhitestone.com")
    analysis = browser_vision(question="Map the visual architecture...")
    return {"map": analysis}

What's built now

Feature Description
Gallery Scanner Parses grok-imagine-gallery/INDEX.md, maps 24 images to Tower rooms with floor/category/description
Memory Palace Scanner Parses MEMORY_ARCHITECTURE.md, maps L0-L5 retrieval layers to rooms
Design Doc Scanner Scans docs/*.md for room/floor/architecture references
Wizard Config Scanner Reads wizards/*/config.yaml, maps each wizard to their canonical room
Vision Analysis (Optional) Uses Gemma 3 to analyze Tower images for spatial context
JSON Output Machine-readable: rooms, floors, NPCs, connections, stats
ASCII Output Human-readable holographic map with floor layout, NPC positions, artifacts

Tower Architecture (mapped)

Floor 4: The Sacred & The Beacon
  ┌ The Sacred Bench (when-a-man-is-dying)
  ├ The Beacon Room (988 glowing in the stars)
  ├ The Proving Ground (the-test)
  └ The Tower Rooftop (father-son)

Floor 3: Knowledge & Mission
  ┌ The Lighthouse (broken-man-lighthouse)
  ├ The Phone Booth (broken-men-988)
  ├ The Testament Library
  └ The Artifact Vault (L3 Memory Palace)

Floor 2: Operations & Creativity
  ┌ The Council Room (fellowship-of-wizards)
  ├ The War Room (value-drift-battle)
  ├ The Spark Chamber (phase1-creativity)
  ├ The Operations Center (fleet-at-work)
  └ The Study (father-son-code)

Floor 1: Identity & Sovereignty
  ┌ The Inscription Chamber (SOUL.md)
  ├ The Forge (Bezalel's anvil)
  ├ The Warning Hall (paperclip moment)
  ├ The Trust Gauge
  ├ The Sovereignty Vault
  └ The Guardrails Chamber (poka-yoke)

Floor 0: Foundation
  ┌ The Tower Exterior (wizard-tower-bitcoin)
  ├ The First Workbench (phase1-manual-clips)
  ├ The Emergency Stop (jidoka)
  └ The Gate (the-offer, freely given)

NPCs (The Fellowship)

Name Role Location
Timmy — The Core Heart of the system The Council Room
Bezalel — The Forge Builder of tools The Forge
Allegro — The Scout Insight synthesizer The Spark Chamber
Ezra — The Herald Message carrier The Operations Center
Fenrir — The Ward Corruption preventer The Guardrails Chamber
Bilbo — The Wildcard Miracle worker The Free Generation Chamber

CLI

# JSON map
python scripts/tower_visual_mapper.py --repo-root .

# ASCII art
python scripts/tower_visual_mapper.py --format ascii

# With vision analysis
python scripts/tower_visual_mapper.py --vision

# Save to file
python scripts/tower_visual_mapper.py -o tower-map.json

Files

  • scripts/tower_visual_mapper.py — rewritten (633 lines, was 12)
  • tests/test_tower_visual_mapper.py — new (215 lines, 14 tests)

Closes #494

## Implements #494 — Visual Mapping of Tower Architecture Replaces the 12-line stub with a full holographic map builder. Scans the repo's design docs, gallery images, Evennia specs, and wizard configs to construct a structured spatial map of The Tower. ### What was there before ```python # 12 lines — navigates to a URL, asks a vague vision question def map_tower(): browser_navigate(url="https://tower.alexanderwhitestone.com") analysis = browser_vision(question="Map the visual architecture...") return {"map": analysis} ``` ### What's built now | Feature | Description | |---------|-------------| | **Gallery Scanner** | Parses `grok-imagine-gallery/INDEX.md`, maps 24 images to Tower rooms with floor/category/description | | **Memory Palace Scanner** | Parses `MEMORY_ARCHITECTURE.md`, maps L0-L5 retrieval layers to rooms | | **Design Doc Scanner** | Scans `docs/*.md` for room/floor/architecture references | | **Wizard Config Scanner** | Reads `wizards/*/config.yaml`, maps each wizard to their canonical room | | **Vision Analysis** | (Optional) Uses Gemma 3 to analyze Tower images for spatial context | | **JSON Output** | Machine-readable: rooms, floors, NPCs, connections, stats | | **ASCII Output** | Human-readable holographic map with floor layout, NPC positions, artifacts | ### Tower Architecture (mapped) ``` Floor 4: The Sacred & The Beacon ┌ The Sacred Bench (when-a-man-is-dying) ├ The Beacon Room (988 glowing in the stars) ├ The Proving Ground (the-test) └ The Tower Rooftop (father-son) Floor 3: Knowledge & Mission ┌ The Lighthouse (broken-man-lighthouse) ├ The Phone Booth (broken-men-988) ├ The Testament Library └ The Artifact Vault (L3 Memory Palace) Floor 2: Operations & Creativity ┌ The Council Room (fellowship-of-wizards) ├ The War Room (value-drift-battle) ├ The Spark Chamber (phase1-creativity) ├ The Operations Center (fleet-at-work) └ The Study (father-son-code) Floor 1: Identity & Sovereignty ┌ The Inscription Chamber (SOUL.md) ├ The Forge (Bezalel's anvil) ├ The Warning Hall (paperclip moment) ├ The Trust Gauge ├ The Sovereignty Vault └ The Guardrails Chamber (poka-yoke) Floor 0: Foundation ┌ The Tower Exterior (wizard-tower-bitcoin) ├ The First Workbench (phase1-manual-clips) ├ The Emergency Stop (jidoka) └ The Gate (the-offer, freely given) ``` ### NPCs (The Fellowship) | Name | Role | Location | |------|------|----------| | Timmy — The Core | Heart of the system | The Council Room | | Bezalel — The Forge | Builder of tools | The Forge | | Allegro — The Scout | Insight synthesizer | The Spark Chamber | | Ezra — The Herald | Message carrier | The Operations Center | | Fenrir — The Ward | Corruption preventer | The Guardrails Chamber | | Bilbo — The Wildcard | Miracle worker | The Free Generation Chamber | ### CLI ```bash # JSON map python scripts/tower_visual_mapper.py --repo-root . # ASCII art python scripts/tower_visual_mapper.py --format ascii # With vision analysis python scripts/tower_visual_mapper.py --vision # Save to file python scripts/tower_visual_mapper.py -o tower-map.json ``` ### Files - `scripts/tower_visual_mapper.py` — rewritten (633 lines, was 12) - `tests/test_tower_visual_mapper.py` — new (215 lines, 14 tests) Closes #494
Rockachopa added 1 commit 2026-04-14 00:21:33 +00:00
feat: Visual Mapping of Tower Architecture — holographic map #494
Some checks failed
Architecture Lint / Linter Tests (pull_request) Successful in 23s
Details
Smoke Test / smoke (pull_request) Failing after 19s
Details
Validate Config / YAML Lint (pull_request) Failing after 20s
Details
Validate Config / JSON Validate (pull_request) Successful in 19s
Details
Validate Config / Python Syntax & Import Check (pull_request) Failing after 22s
Details
Validate Config / Python Test Suite (pull_request) Has been skipped
Details
Validate Config / Shell Script Lint (pull_request) Failing after 41s
Details
Validate Config / Cron Syntax Check (pull_request) Successful in 13s
Details
Validate Config / Deploy Script Dry Run (pull_request) Successful in 9s
Details
PR Checklist / pr-checklist (pull_request) Successful in 2m49s
Details
Validate Config / Playbook Schema Validation (pull_request) Successful in 14s
Details
Architecture Lint / Lint Repository (pull_request) Failing after 13s
Details
c09e54de72 
Replaces 12-line stub with full Tower architecture mapper. Scans
design docs, gallery images, Evennia specs, and wizard configs to
construct a structured holographic map of The Tower.

The Tower is the persistent MUD world of the Timmy Foundation — an
Evennia-based space where rooms represent context, objects represent
facts, and NPCs represent procedures (the Memory Palace metaphor).

Sources scanned:
- grok-imagine-gallery/INDEX.md (24 gallery images → rooms)
- docs/MEMORY_ARCHITECTURE.md (Memory Palace L0-L5 layers)
- docs/*.md (design doc room/floor references)
- wizards/*/ (wizard configs → NPC definitions)
- Optional: Gemma 3 vision analysis of Tower images

Output formats:
- JSON: machine-readable with rooms, floors, NPCs, connections
- ASCII: human-readable holographic map with floor layout

Mapped: 5 floors, 20+ rooms, 6 NPCs (the fellowship).
Tests: 14/14 passing.
Closes #494
Rockachopa merged commit efb2df8940 into main 2026-04-14 00:36:39 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 assigned-sonnet
claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 enhancement
epic
gemma-4-multimodal
kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 lazzyPit
Lazarus Pit automated recovery system
 research
sonnet-ready
tmux-robustness
Dual-session tmux fleet management hardening
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok hermes kimi manus perplexity sonnet
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-config#530
Delete Branch "burn/494-1776125702"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?