The order to do the other plans in, why, and what should change in them first.
As of: 2026-11-19. Every plan page opens with a status line; this page orders them. Steps 1 to 5 are built: 1 to 3 done, 4 (Capabilities & Permissions) and 5's first part (slot constraints) built and used by the app, and on 2026-11-19 most of their browser-side work was run in a browser against just launch (Next Steps A: what passed, and what is still unseen). Two pieces of work grew out of these steps: shared promises (step 3) and, on 2026-11-18, taking the app's class names out of framework code (step 2's boundary, the other direction).
Chosen 2026-11-18, in this order.
Four steps of work were checked headless only, and the framework guide's evidence bar ("did I verify, or did I just read?") is not met for any of it. This comes before new work, because each later step builds on these, and a bug found now has one suspect rather than five. One session in the app (just launch, https://localhost:8443), a host and a second player, checking:
?invite= survives boot (SvPlatform.pageUrl()); opening a link, picking a file and copying text go through the view actions; an error report carries the user agent.aria-valuemin / aria-valuemax; an AI patch that breaks one is refused with the sentence. (There is no aria-invalid yet; add it if the pass shows a screen reader misses the error.)SvChatMessageTile rather than the app's tile; they should look exactly as before, including the narrated-sentence highlight.Run with ?thrash=count on, since steps 2 and 4 touched view code. Each failure becomes a fix with a test where one can be written; the pass is done when every line above has been seen working.
2026-11-19: run against just launch, in Playwright specs that cost nothing to rerun.
hosted-table-invite-signup.spec.js, made to run locally: a link opened signed out survives boot and sign-in and joins the table, with one session). Step 2's accessors, step 3's retry and reload, the tile wiring and the thrash check (meta-plan-step-a.spec.js): the page url and an error report's user agent; opening a link, picking a file and copying through SvWebUserInterface; an image read that failed is read again on the next ask and loads, and loads after a reload, with no unhandled rejection; assistant replies resolve to SvChatMessageTile and the session's tile inherits its highlight; typing two lines in a chat input with ?thrash=count forces no layouts (a forced write-then-read is counted, so 0 is a measurement). Steps 4 and 5 through the model (editability-browser-pass.spec.js): a non-editor's catalog campaign offers no edits by the server's answer; a forced save is refused 403, reloaded and said ("Read only — You can't edit …"); out-of-bounds patches and field values give their sentences.just launch had started with an empty catalog since 2026-11-13 (records.js judged "local" at load, before the seeder pointed at the emulators); the editability spec's forced save edited a derived, unstored title and never reached the server.editability-views-browser-pass.spec.js, mouse and keyboard). Step 4, on the catalog tree as a non-editor (the tree is hidden from players, so the spec makes it visible first): no read-only tile offers editable text; typing over a title, Delete and Backspace, a held drag to reorder, and a file dropped on the list all change nothing, and the drop is said. Step 5, on a character's raw death-save and coin fields (a character opens as its derived sheet everywhere, so the spec hangs the fields under a folder to reach their tiles): the tiles carry aria-valuemin / aria-valuemax; a 4 typed into Failures shows "Must be at most 3." and the model keeps its value; a 2 is taken and the sentence goes.duplicateSelectedTiles() asked nothing, neither the cascade nor nodeCanAddSubnode(), so the ratchet test (which looks for raw capability reads) could not see it. It and pinch-to-add now ask the cascade, and TestEditabilityInViews also fails on a view method that changes a node's list without asking.The 2026-11-18 cleanup found a framework method that looked up the app's UoSession (a ReferenceError under any other app) and a framework class that named the app's tile; both are gone, along with about 30 comments and a fixture that used app classes as examples. One use is left on purpose, pending a decision: the tool instructions every AI conversation receives (SvToolDefinitions) use the app's rollRequest tool and UoRollRequestMessage as their worked example. Changing it changes the game's prompt, so it waits on a choice between a neutral example and one built from the first real tool definition.
Then a ratchet test like TestPlatformGlobalsInModels: fail when framework code references a class that no framework file defines, which needs no app prefix and so stays general. Small, and it stops the drift that the cleanup undid. Details in Naked Objects Issues.
Built 2026-11-19. SvBrowserView.navigate(aRequest) takes an SvNavigationRequest that says where to go and who asked; the older entry points are removed, and the browser remembers the request behind its latest path change. A tile the user taps reports afterwards, and the focus-and-expand notes wait for a second pass. See Browser Cleanup. The compaction coordinator, Tile Container Views and the navigation announcements in Accessibility waited on it and can start.
More slot constraints are declared where a wrong value is seen, not as a project (each is a decision about stored data). The two hand-kept promises in Cleanup Notes wait until their files are changed. Promise-wrapped slots wait for a first user.
| Plan | State | Note |
|---|---|---|
| Complete Protocols | Done | Defaults on base classes, SvJsonSerializableProtocol, and a ratchet test. |
| Lazy Slots | Shipped | Rewritten to describe what shipped; a few items remain. |
| Async Final Initialization | Closed | Its main case was solved by manifests and then lazy loading. |
| Naked Objects Issues | Done, one follow-up | Every listed class moved; the ratchet test's baseline is empty. Two gaps stay open until needed. App class names were taken out of framework code (2026-11-18); one prompt example and a ratchet test are left (next step B). |
| Cleanup Notes | Opportunistic | The runtime-risk items are fixed; the rest are for when a file is being changed anyway. Now lists the two hand-kept promises still to move to shared promises. |
| Promise-Wrapped Slots | Core done, unused | One shared promise per value, retry after failure, recompute on a dependency change; no slot uses it yet. |
| Capabilities & Permissions | Built, unverified in a browser (next step A) | Every view edit path asks the editability cascade; the server says who may write and the cascade uses its answer; a refused commit reloads and says so. Read, share and create hooks wait for a need. |
| JSON Schema | Slot constraints built, unused | A slot's minimum, maxLength and the rest reach the schema, the field's error text, ARIA and a refused AI patch; the setter only warns. pattern is checked too. The app declares its first few (2026-11-18). Class-level keywords and type unions are left. |
| Browser Cleanup | Next new work | Holds the compaction notes; has its own order. Part 1 (one navigation entry point) is built; part 2 (the compaction coordinator) is next. |
| Tile Container Views, Tile Views | Later | The wrapping grid can start on its own (2026-11-20); the table and scrolling wait on compaction. Large collections rewritten around windowed collections. |
| Accessibility Testing & Tuning | Ongoing | Automated checks now; manual passes after the navigation work. |
| Case Studies | Later | Contacts can run early. |
| Emergent Capabilities | Ideas | Each candidate now points to the plan that takes it. |
| Async Navigation, Graph Database | Directions | No work planned. |
npm test (or just test) rebuilds build/_index.json, then runs every tests/headless/Test*.js in its own process, one at a time, with a timeout each; arguments filter by file name (npm test -- Record). The tests share LevelDB databases under data/leveldb/, so they can't run in parallel. The first full run found one flaky test, TestWindowedCollections: classic-level's close() resolves before LevelDB lets go of its files, so a quick reopen sometimes failed. SvIndexedDbFolder now retries such an open briefly, and the test's sleeps are gone. All tests pass (73 then; 80 after steps 2 and 3), in under a minute.
Naked Objects Issues: add the environment accessors and view actions, move the nine classes onto them, then add the ratchet test. The list is short, and the headless and swappable-UI claims depend on it.
App names (2026-11-18), the boundary's other side. The framework must not know the app, and an audit found it did in a few places: a dead session() that looked up UoSession, a default tile named UoChatInputTile, an error message naming UoBuildEnv, and app classes used as examples in comments and a test fixture. All gone (strvct 9bf3aadd), except the prompt example in next step B.
markPid() is iterative (Cleanup Notes).The rest of Cleanup Notes is for when a file is being changed anyway.
Shared promises (2026-11-15), which came out of this step. Finishing the slot feature raised the question of the code that hand-kept a fooPromise for work several callers ask for at once. An audit of those copies found each had something wrong (a failure cached forever, a retry that never ran, a finished run clearing a newer one, an unhandled second rejection, work that carried on after being abandoned). Object_sharedPromises.js now gives every object three helpers (once, one at a time, fresh), and 23 hand-written copies in the framework and the app moved onto them. See Async Patterns. Two framework copies are left, listed in Cleanup Notes.
The most user-facing value: the failure it describes is silent data loss. Its first step is done (2026-11-16): titles, drags in and out, reordering, desktop drops and three field paths now ask the cascade, a refused drop says so, and TestEditabilityInViews fails on a view that reads a raw capability.
The rest followed (2026-11-17). The server now tells the client, with every read, whether the caller may write; the cloud store remembers it and a document's pool carries it into the cascade, so the views and the commit cannot disagree. A commit refused for permission reloads the cloud's copy and tells the user. The work found that the client had been discarding the server's error codes, so no refusal was ever recognized as one. Not done, by decision: separate read, delete, share and create hooks, and a live push of role changes.
Additive, and tighter schemas improve AI tool calls at once. Start by emitting the minimum / maximum annotations that the ARIA code already reads.
Slot constraints — done (2026-11-17). Ten setters on Slot, named after their JSON Schema keywords, with four readers: the schema, the error sentence a field shows, ARIA, and the setter's warning. An AI patch that breaks one is refused before anything is applied. See JSON Schema. pattern joined them on 2026-11-18 (setPattern, replacing the schema-only setJsonSchemaPattern). The app declared its first bounds the same day, after scanning its stored data for values outside them. What remains is declaring more where a wrong value is seen (each is a decision about stored data), and the class-level keywords and type unions when a case needs them.
In its own order: one navigation entry point (built 2026-11-19), the compaction coordinator, composable breadcrumbs, the auxiliary view.
After the compaction coordinator. Meter and badge tiles can be done at any point.
Automated checks alongside step 1; manual passes after steps 6 and 7.
Contacts can run as early as step 2, as a gap-finder; what it finds comes back to this page. The rest once their features exist.
pool.transaction().classNameConversionMap()); slot type changes and custom migrations aren't. Write a plan when a real type change needs it, taking in the migration item from Emergent Capabilities.