Skip to content

docs(world-model): outstanding work as handoff#385

Merged
buremba merged 1 commit into
mainfrom
docs/world-model-remaining
Apr 26, 2026
Merged

docs(world-model): outstanding work as handoff#385
buremba merged 1 commit into
mainfrom
docs/world-model-remaining

Conversation

@buremba
Copy link
Copy Markdown
Member

@buremba buremba commented Apr 26, 2026

Adds a prioritized "Outstanding work" section to `docs/plans/world-model.md` so the next session has a concrete checklist.

Principles for the items below

Items, ordered by what unblocks usage

  1. Schema CRUD cross-org (backend, ~80 LOC) — `manage_entity_schema` list/get widens; rows include origin org. Prerequisite for items 2-3.
  2. Frontend type pickers show cross-org with read-only badge (~30 LOC) — purely visual on existing dropdown.
  3. Discovery via existing org dropdown — group public catalogs separately. No global search bar (agents already have `search_knowledge`).
  4. Read-side cross-org tolerance (~50 LOC) — `manage_entity.get`, `resolve_path`, public pages widen the same way `fetchEntityById` did in feat(world-model): cross-org relationship_types + catalog discovery #377.
  5. Visibility-flip safety (~10 LOC) — refuse `public → private` when referenced. Cleaner than retroactive revalidation.
  6. Catalog curation — data pass, no PR. Existing public orgs have demo cruft.
  7. `is_catalog` flag — deferred until visibility can be mutated by regular users.
  8. `entity_relationship_type_rules` slug → id — deferred until first cross-catalog rule conflict.
  9. Contribution flow — premature; build when someone has data worth contributing.
  10. TOCTOU on type lookup — deferred; semantic-not-corrupting.

Test plan

  • `bun run check` clean

Captures the remaining gaps as a handoff for the next session. Each item
states the simplest path that reuses existing surfaces — no new pages,
no new MCP tools, no new components. Type pickers grow a badge column;
read sites widen with the same pattern as #377; visibility flips guarded
by a single existence check rather than a retroactive validation pass.

Ordered by what unblocks usage:
1. Schema CRUD cross-org awareness (backend prerequisite)
2. Frontend type pickers show cross-org with read-only badge
3. Discovery via existing org dropdown (split into two groups)
4. Read-side cross-org tolerance (manage_entity.get, resolve_path)
5. Visibility-flip safety (refuse if referenced)
6. Catalog curation (data prune, no PR needed)
7. is_catalog flag (deferred — no user path mutates visibility today)
8. entity_relationship_type_rules slug → id (deferred — no conflict yet)
9. Contribution flow (premature — no content to contribute yet)
10. TOCTOU (deferred — semantic-not-corrupting microsecond window)
@buremba buremba merged commit a249676 into main Apr 26, 2026
12 checks passed
@buremba buremba deleted the docs/world-model-remaining branch April 26, 2026 23:35
@buremba buremba restored the docs/world-model-remaining branch May 12, 2026 00:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant