docs(link): the panel, and the two deletions it could see and no test could (Phase 8) #243

wtclaude · 2026-09-14T13:11:45Z

wtclaude commented

2026-09-14 13:11:45 +00:00

Records the Asset Bridge's phase 8 — the admin surface — as built. Pairs with Module-uo#41.

What's here

link/v8.md §12.2 (new) — the panel as built: one page (Admin → Client Files) over the creature catalogue, item and land art, and the cliloc table, because they come off one client install and change on one event. The four decisions are written down, including the one that kept the phase to a single repo: §14's "activity view" is the last import's own summary rather than a filtered feed — the alternative was a core activity filter, a ctx.activity.list helper and a MODULE_API bump, to re-read rows the panel can keep itself.
§14 — the admin paragraph now describes what exists instead of what was promised, including needsReview returning each vanished key with the picture the site serves for it.
§16 — phase 8 marked DONE, with the walk's numbers (1,095 portraits in 3.5 s, 313 item pictures in 0.6 s, 67,496 cliloc rows in 1.7 s).
website/CLILOCS.md, website/SPAWN_ATLAS.md — both said "Admin → Shard → Import". That button is now Admin → Client Files → Update.
modules/uo/API.md — the needsReview reply shape.

The part worth reading twice

Two of the three defects the walk found were deletions, both predate phase 8, and neither was reachable by a test that did not already suspect it:

the body import diffing its manifest against every family's rows, so 313 item pictures were staged for deletion under a sentence that was wrong about what had happened;
an approved vanish unlinking the sprite and keeping the row, so the key came back for review forever and the count never moved.

The rule they share is now stated in §12.2: after phase 5, shard_assets is three collections in one table, and every read of it that feeds a decision has to say which one it means. Two of the three that did not were deletions.

AI-assisted contribution

Written with Claude Code (Claude Opus 5). The commit carries the Co-Authored-By trailer.

🤖 Generated with Claude Code

https://claude.ai/code/session_016wDDVXWMDz82WqE1i969r4

Records the Asset Bridge's phase 8 — the admin surface — as built. Pairs with **Module-uo#41**. ## What's here - **`link/v8.md` §12.2 (new)** — the panel as built: one page (`Admin → Client Files`) over the creature catalogue, item and land art, and the cliloc table, because they come off one client install and change on one event. The four decisions are written down, including the one that kept the phase to a single repo: §14's *"activity view"* is the **last import's own summary** rather than a filtered feed — the alternative was a core activity filter, a `ctx.activity.list` helper and a `MODULE_API` bump, to re-read rows the panel can keep itself. - **§14** — the admin paragraph now describes what exists instead of what was promised, including `needsReview` returning each vanished key with the picture the site serves for it. - **§16** — phase 8 marked DONE, with the walk's numbers (1,095 portraits in 3.5 s, 313 item pictures in 0.6 s, 67,496 cliloc rows in 1.7 s). - **`website/CLILOCS.md`, `website/SPAWN_ATLAS.md`** — both said *"Admin → Shard → Import"*. That button is now `Admin → Client Files → Update`. - **`modules/uo/API.md`** — the `needsReview` reply shape. ## The part worth reading twice Two of the three defects the walk found were **deletions**, both predate phase 8, and neither was reachable by a test that did not already suspect it: - the body import diffing its manifest against *every* family's rows, so 313 item pictures were staged for deletion under a sentence that was wrong about what had happened; - an approved vanish unlinking the sprite and keeping the row, so the key came back for review forever and the count never moved. The rule they share is now stated in §12.2: **after phase 5, `shard_assets` is three collections in one table, and every read of it that feeds a decision has to say which one it means.** Two of the three that did not were deletions. ### AI-assisted contribution Written with Claude Code (Claude Opus 5). The commit carries the `Co-Authored-By` trailer. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_016wDDVXWMDz82WqE1i969r4

wtclaude added 1 commit 2026-09-14 13:11:47 +00:00

docs(link): the panel, and the two deletions it could see and no test could (Phase 8) fc2d4872f6

v8.md section 12.2 records the admin surface as built: one page, Admin -> Client
Files, over the creature catalogue, item and land art, and the cliloc table --
one page because they come off one client install and change on one event. The
four decisions are written down, including the one that kept the phase to a
single repo: section 14's "activity view" is the last import's own summary
rather than a filtered feed, which would have needed a core activity filter, a
`ctx.activity.list` helper and a MODULE_API bump to re-read rows the panel can
keep itself.

The part worth reading twice is what the walk found. Two of the three defects
were DELETIONS, both predate phase 8, and neither was reachable by a test that
did not already suspect them:

  * the body import diffing its manifest against every family's rows, so 313
    item pictures were staged for deletion under a sentence that was wrong about
    what had happened;
  * an approved vanish unlinking the sprite and keeping the row, so the key came
    back for review forever and the count never moved.

The rule they share is now stated: after phase 5, `shard_assets` is three
collections in one table, and every read of it that feeds a decision has to say
which one it means. Two of the three that did not were deletions.

CLILOCS.md and SPAWN_ATLAS.md now name the button that exists (Admin -> Client
Files) instead of the one they promised, and modules/uo/API.md records that a
`needsReview` reply carries each vanished key's picture.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016wDDVXWMDz82WqE1i969r4

wtclaude referenced this pull request from RunicGateway/Module-uo

2026-09-14 13:12:12 +00:00

feat(assets): the panel that operates the client-file imports (Phase 8) #41

whitlocktech merged commit 1f3c728053 into main

2026-09-14 16:03:42 +00:00

whitlocktech referenced this issue from a commit

2026-09-14 16:03:45 +00:00

Merge pull request 'docs(link): the panel, and the two deletions it could see and no test could (Phase 8)' (#243) from docs/asset-bridge-p8 into main

whitlocktech deleted branch docs/asset-bridge-p8

2026-09-14 16:03:46 +00:00

Sign in to join this conversation.