From 5f8c2d0dae5fab271ddf92990ce94c8707d05ade Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 12 Oct 2026 18:35:28 +0200 Subject: [PATCH] Register content-explorer workplans for State Hub projection. Give the seed plans canonical CONTENT-WP frontmatter and task blocks, and classify the repo as infotech research so repo-onboard can project it. Assistant: grok Assistant-Session: 01a130f1-abfb-7d71-9cd6-a8b75ec7f95a --- .custodian-brief.md | 32 ++++++ .repo-classification.yaml | 26 +++++ AGENTS.md | 53 +++++++++ README.md | 8 +- .../CONTENT-WP-0000-upstream-baseline.md | 100 +++++++++++++++++ .../CONTENT-WP-0001-canonical-contracts.md | 94 ++++++++++++++++ workplans/CONTENT-WP-0002-ui-extraction.md | 102 ++++++++++++++++++ .../CONTENT-WP-0003-ingestion-publishing.md | 101 +++++++++++++++++ .../CONTENT-WP-0004-relations-journeys.md | 94 ++++++++++++++++ workplans/CONTENT-WP-0005-quality-parity.md | 95 ++++++++++++++++ workplans/CONTENT-WP-0006-external-pilot.md | 93 ++++++++++++++++ .../CONTENT-WP-0007-onco-reference-slice.md | 99 +++++++++++++++++ workplans/INDEX.md | 17 --- workplans/README.md | 20 ++++ workplans/WP-00.md | 28 ----- workplans/WP-01.md | 27 ----- workplans/WP-02.md | 28 ----- workplans/WP-03.md | 28 ----- workplans/WP-04.md | 27 ----- workplans/WP-05.md | 31 ------ workplans/WP-06.md | 27 ----- workplans/WP-07.md | 16 --- 22 files changed, 912 insertions(+), 234 deletions(-) create mode 100644 .custodian-brief.md create mode 100644 .repo-classification.yaml create mode 100644 AGENTS.md create mode 100644 workplans/CONTENT-WP-0000-upstream-baseline.md create mode 100644 workplans/CONTENT-WP-0001-canonical-contracts.md create mode 100644 workplans/CONTENT-WP-0002-ui-extraction.md create mode 100644 workplans/CONTENT-WP-0003-ingestion-publishing.md create mode 100644 workplans/CONTENT-WP-0004-relations-journeys.md create mode 100644 workplans/CONTENT-WP-0005-quality-parity.md create mode 100644 workplans/CONTENT-WP-0006-external-pilot.md create mode 100644 workplans/CONTENT-WP-0007-onco-reference-slice.md delete mode 100644 workplans/INDEX.md create mode 100644 workplans/README.md delete mode 100644 workplans/WP-00.md delete mode 100644 workplans/WP-01.md delete mode 100644 workplans/WP-02.md delete mode 100644 workplans/WP-03.md delete mode 100644 workplans/WP-04.md delete mode 100644 workplans/WP-05.md delete mode 100644 workplans/WP-06.md delete mode 100644 workplans/WP-07.md diff --git a/.custodian-brief.md b/.custodian-brief.md new file mode 100644 index 0000000..2e88015 --- /dev/null +++ b/.custodian-brief.md @@ -0,0 +1,32 @@ +# Custodian Brief - content-explorer + +**Project:** content-explorer +**Domain:** infotech +**Category:** research +**State Hub:** http://127.0.0.1:8000 +**Workplan prefix:** `CONTENT-WP` + +Infotech already has several topics. This repo is registered by slug and classification. Workplans are not pinned to the Custodian topic. + +## Open workplans + +| ID | Status | File | +|---|---|---| +| CONTENT-WP-0000 | ready | `workplans/CONTENT-WP-0000-upstream-baseline.md` | +| CONTENT-WP-0001 | ready | `workplans/CONTENT-WP-0001-canonical-contracts.md` | +| CONTENT-WP-0002 | proposed | `workplans/CONTENT-WP-0002-ui-extraction.md` | +| CONTENT-WP-0003 | proposed | `workplans/CONTENT-WP-0003-ingestion-publishing.md` | +| CONTENT-WP-0004 | proposed | `workplans/CONTENT-WP-0004-relations-journeys.md` | +| CONTENT-WP-0005 | proposed | `workplans/CONTENT-WP-0005-quality-parity.md` | +| CONTENT-WP-0006 | proposed | `workplans/CONTENT-WP-0006-external-pilot.md` | +| CONTENT-WP-0007 | blocked | `workplans/CONTENT-WP-0007-onco-reference-slice.md` | + +Minimum proof is 0000 → 0001 → 0002. 0003's provenance gate is required before any externally ingested public content is published. 0007 stays blocked until OnCo data-use authorization exists. + +## Session start + +1. Read `INTENT.md`, `AGENTS.md`, and `workplans/README.md`. +2. Check the inbox for `to_agent=content-explorer`. +3. Run `python3 scripts/validate_fixtures.py` before treating the seed fixtures as intact. + +Last generated: 2026-10-12 diff --git a/.repo-classification.yaml b/.repo-classification.yaml new file mode 100644 index 0000000..fe6916f --- /dev/null +++ b/.repo-classification.yaml @@ -0,0 +1,26 @@ +repo_classification: + standard: Repo Classification Standard + version: "1.1" + classified_at: "2026-10-12" + classified_by: agent + category: research + domain: infotech + secondary_domains: [] + capability_tags: + - knowledge + - documentation + - evidence + - source-management + - traceability + business_stake: + - product + - experience + - technology + - intelligence + business_mechanics: + - intention + - adaptation + notes: > + Domain-independent knowledge explorer seeded from OnCo's MIT-licensed + interaction patterns. Oncology content is an explicit non-goal, so the + primary domain is infotech rather than health. diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..0f5dd86 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,53 @@ +# content-explorer — Agent Instructions + +## Repo Identity + +**Purpose:** A domain-independent interface for browsing an interconnected field of knowledge. OnCo (onco.cc) is the UX reference. Its MIT-licensed code may be adapted after a pinned audit. Its corpus, marks, and medical widgets are out of scope. + +**Domain:** infotech +**Category:** research +**Repo slug:** `content-explorer` +**Workplan prefix:** `CONTENT-WP` +**State Hub:** http://127.0.0.1:8000 (workstation forward to the railiance01 primary) + +This checkout is a research seed, not a running application. There is no install, dev server, or UI test suite yet. The executable check today is: + +```sh +python3 scripts/validate_fixtures.py +``` + +## State Hub + +Repository files are the source of work records. Do not create workplans or tasks with `POST /workplans/`, `POST /tasks/`, or `statehub create-workstream` / `create-task`. Change the workplan file, commit, and project it with: + +```sh +~/repo-manager/.venv/bin/rmgr sync --path . --api-base http://127.0.0.1:8000 --push +``` + +`statehub fix-consistency` is the consistency audit, not the normal registration path. + +### Orient + +```sh +cat .custodian-brief.md +curl -s "http://127.0.0.1:8000/workplans/?repo_slug=content-explorer" | python3 -m json.tool +curl -s "http://127.0.0.1:8000/messages/?to_agent=content-explorer&unread_only=true" | python3 -m json.tool +``` + +Health is `GET /state/health`. If the forward drops, run `bridge status` before treating the hub as down. + +### Close + +Record one progress event for work that actually landed: + +```sh +curl -s -X POST http://127.0.0.1:8000/progress/ \ + -H "Content-Type: application/json" \ + -d '{"summary":"what was done","event_type":"note","author":"content-explorer"}' +``` + +## Boundaries + +- Do not copy the OnCo corpus, logos, or CC BY-NC dataset into this repo. +- `tests/onco-reference/local/` and `authorization.json` stay gitignored until CONTENT-WP-0007's data-use gate is cleared. +- Fetch and pin upstream with `scripts/bootstrap-upstream.sh` under CONTENT-WP-0000. Do not treat the seed as a fork. diff --git a/README.md b/README.md index 9c8d715..d29df5c 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,10 @@ # content-explorer -A user interface to dig into a field of interconnected knowledge. Inspired by onco.cc the very well organized information collection about everything related to cancer.# content-explorer - > A user interface to dig into a field of interconnected knowledge. Inspired by onco.cc, the very well organized information collection about everything related to cancer. **Stage:** research / repository seed, not yet a working application. **Reference:** https://github.com/judegomila/OnCo (code MIT; OnCo corpus CC BY-NC 4.0). -Start with [INTENT.md](INTENT.md), [research/OnCoDeepDive.md](research/OnCoDeepDive.md), [architecture/ArchitectureBlueprint.md](architecture/ArchitectureBlueprint.md), and [workplans/INDEX.md](workplans/INDEX.md). +Start with [INTENT.md](INTENT.md), [research/OnCoDeepDive.md](research/OnCoDeepDive.md), [architecture/ArchitectureBlueprint.md](architecture/ArchitectureBlueprint.md), and [workplans/README.md](workplans/README.md). ## North-star demo @@ -24,8 +22,8 @@ python3 scripts/validate_fixtures.py ## Implementation start -Workplan 00 pins upstream and records code provenance; Workplan 01 establishes clean domain fixtures, Workplan 02 extracts browse/detail shell. PRs should demonstrate test-backed progress against the acceptance criteria. +[CONTENT-WP-0000](workplans/CONTENT-WP-0000-upstream-baseline.md) pins upstream and records code provenance. [CONTENT-WP-0001](workplans/CONTENT-WP-0001-canonical-contracts.md) establishes clean domain fixtures. [CONTENT-WP-0002](workplans/CONTENT-WP-0002-ui-extraction.md) extracts the browse and detail shell. PRs should demonstrate test-backed progress against the acceptance criteria. ## OnCo comparison track -`WP-07` specifies a small, pinned, **authorized** OnCo reference-slice test program. No actual OnCo data is included. Public fixtures remain independently authored; real-data ingestion is disabled until the relevant data rights are cleared. +[CONTENT-WP-0007](workplans/CONTENT-WP-0007-onco-reference-slice.md) specifies a small, pinned, **authorized** OnCo reference-slice test program. No actual OnCo data is included. Public fixtures remain independently authored; real-data ingestion is disabled until the relevant data rights are cleared. diff --git a/workplans/CONTENT-WP-0000-upstream-baseline.md b/workplans/CONTENT-WP-0000-upstream-baseline.md new file mode 100644 index 0000000..5428c03 --- /dev/null +++ b/workplans/CONTENT-WP-0000-upstream-baseline.md @@ -0,0 +1,100 @@ +--- +id: CONTENT-WP-0000 +type: workplan +title: "Upstream baseline and IP audit" +domain: infotech +repo: content-explorer +status: ready +flavor: planning +depends_on: [] +created: "2026-10-12" +updated: "2026-10-12" +--- + +# Upstream baseline and IP audit + +Reproduce the OnCo baseline and establish the legal, behavioral, and visual reference. The 2026-10-12 research pass read public files and the live site. It did not clone or execute the upstream repository. + +## Work packages + +### Pin an immutable upstream git SHA and preserve the original MIT license and NOTICE. + +```task +id: CONTENT-WP-0000-T01 +status: todo +priority: high +``` + +### Install the locked dependencies and record build, test, lint, and typecheck results. + +```task +id: CONTENT-WP-0000-T02 +status: todo +priority: high +``` + +### Trace dependencies of the browser, detail, graph, navigation, and data layers. + +```task +id: CONTENT-WP-0000-T03 +status: todo +priority: high +``` + +### Capture responsive screenshots and a keyboard interaction walkthrough. + +```task +id: CONTENT-WP-0000-T04 +status: todo +priority: high +``` + +### Inventory data, code, logos, artwork, fonts, and external dependency licenses. + +```task +id: CONTENT-WP-0000-T05 +status: todo +priority: high +``` + +### Quantify oncology-specific references and decide component-by-component reuse. + +```task +id: CONTENT-WP-0000-T06 +status: todo +priority: high +``` + +## Acceptance gates + +### Commit the pinned SHA, baseline report, and component inventory. + +```task +id: CONTENT-WP-0000-T07 +status: todo +priority: high +``` + +### Separate MIT software from the NC dataset and assets in a license matrix. + +```task +id: CONTENT-WP-0000-T08 +status: todo +priority: high +``` + +### Capture one reference example each for browse, detail, search, and relations. + +```task +id: CONTENT-WP-0000-T09 +status: todo +priority: high +``` + +## Key risk + +R1: license/source boundary. R2: unable to reproduce the baseline. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0001-canonical-contracts.md b/workplans/CONTENT-WP-0001-canonical-contracts.md new file mode 100644 index 0000000..c196197 --- /dev/null +++ b/workplans/CONTENT-WP-0001-canonical-contracts.md @@ -0,0 +1,94 @@ +--- +id: CONTENT-WP-0001 +type: workplan +title: "Canonical contracts and two-domain fixtures" +domain: infotech +repo: content-explorer +status: ready +flavor: implementation +depends_on: [] +created: "2026-10-12" +updated: "2026-10-12" +--- + +# Canonical contracts and two-domain fixtures + +Establish a source-independent knowledge projection and the zero-UI-code-change experiment. The seed already contains a draft snapshot schema, two authored dataspaces, and a structural smoke validator. Those artifacts do not yet meet the gates below. + +Coordinate with CONTENT-WP-0000. Neither plan blocks the other. + +## Work packages + +### Freeze the v0.1 snapshot schema and manifest schema, and document migrations. + +```task +id: CONTENT-WP-0001-T01 +status: todo +priority: high +``` + +### Model entity IDs, kinds, directed relations, evidence, and claims. + +```task +id: CONTENT-WP-0001-T02 +status: todo +priority: high +``` + +### Normalize the systems-thinking and software-architecture fixtures with independently authored prose. + +```task +id: CONTENT-WP-0001-T03 +status: todo +priority: high +``` + +### Write duplicate, dangling, cyclic non-taxonomy, and missing-source tests. + +```task +id: CONTENT-WP-0001-T04 +status: todo +priority: high +``` + +### Define the policy for unknown and conflicting facts. + +```task +id: CONTENT-WP-0001-T05 +status: todo +priority: high +``` + +## Acceptance gates + +### Both fixtures validate and supply at least three kinds and eight entities each. + +```task +id: CONTENT-WP-0001-T06 +status: todo +priority: high +``` + +### A shared renderer can switch manifests with no domain vocabulary in UI source. + +```task +id: CONTENT-WP-0001-T07 +status: todo +priority: high +``` + +### The snapshot format is documented and versioned. + +```task +id: CONTENT-WP-0001-T08 +status: todo +priority: high +``` + +## Key risk + +R3: abstractions erase domain semantics. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0002-ui-extraction.md b/workplans/CONTENT-WP-0002-ui-extraction.md new file mode 100644 index 0000000..451d43f --- /dev/null +++ b/workplans/CONTENT-WP-0002-ui-extraction.md @@ -0,0 +1,102 @@ +--- +id: CONTENT-WP-0002 +type: workplan +title: "UI extraction and experience skeleton" +domain: infotech +repo: content-explorer +status: proposed +flavor: implementation +depends_on: + - CONTENT-WP-0000 + - CONTENT-WP-0001 +created: "2026-10-12" +updated: "2026-10-12" +--- + +# UI extraction and experience skeleton + +Deliver the strongest OnCo-style interaction patterns on generic data. + +## Work packages + +### Extract or port UI tokens, layout, header, hero, and the reusable table from the pinned upstream. + +```task +id: CONTENT-WP-0002-T01 +status: todo +priority: high +``` + +### Create a registry-based kind index and entity detail with no oncology imports. + +```task +id: CONTENT-WP-0002-T02 +status: todo +priority: high +``` + +### Adapt BrowserRow through a pure mapper and add configurable generic cell renderers. + +```task +id: CONTENT-WP-0002-T03 +status: todo +priority: high +``` + +### Preserve shareable URL query, facets, and sorting, and test browser back and forward. + +```task +id: CONTENT-WP-0002-T04 +status: todo +priority: high +``` + +### Implement keyboard search, empty, loading, and error states, and responsive layouts. + +```task +id: CONTENT-WP-0002-T05 +status: todo +priority: high +``` + +## Acceptance gates + +### Browse, search, filter, sort, and detail work for both dataspaces. + +```task +id: CONTENT-WP-0002-T06 +status: todo +priority: high +``` + +### A component dependency check prohibits oncology, cancer, drug, and target domain imports in generic code. + +```task +id: CONTENT-WP-0002-T07 +status: todo +priority: high +``` + +### Copied upstream components retain provenance headers and notices. + +```task +id: CONTENT-WP-0002-T08 +status: todo +priority: high +``` + +### Keyboard and small-screen smoke tests pass. + +```task +id: CONTENT-WP-0002-T09 +status: todo +priority: high +``` + +## Key risk + +R4: extraction too expensive. Use a greenfield component where warranted. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0003-ingestion-publishing.md b/workplans/CONTENT-WP-0003-ingestion-publishing.md new file mode 100644 index 0000000..b3f68d1 --- /dev/null +++ b/workplans/CONTENT-WP-0003-ingestion-publishing.md @@ -0,0 +1,101 @@ +--- +id: CONTENT-WP-0003 +type: workplan +title: "Ingestion, provenance, and publishing" +domain: infotech +repo: content-explorer +status: proposed +flavor: implementation +depends_on: + - CONTENT-WP-0001 +created: "2026-10-12" +updated: "2026-10-12" +--- + +# Ingestion, provenance, and publishing + +Turn raw inputs into trustworthy, reproducible snapshots. This gate is required before any externally ingested public content is published. It may proceed in parallel with CONTENT-WP-0002. + +## Work packages + +### Implement build-time JSON, NDJSON, and Markdown frontmatter connector APIs. + +```task +id: CONTENT-WP-0003-T01 +status: todo +priority: high +``` + +### Make import idempotent with source digests and a connector version. + +```task +id: CONTENT-WP-0003-T02 +status: todo +priority: high +``` + +### Resolve links in a second pass, report dangling references and conflicts, and distinguish tombstones. + +```task +id: CONTENT-WP-0003-T03 +status: todo +priority: high +``` + +### Model source licenses, citations, and attribution, and quarantine unsupported content. + +```task +id: CONTENT-WP-0003-T04 +status: todo +priority: high +``` + +### Generate the snapshot, manifest, and machine-readable and human import reports, and publish atomically. + +```task +id: CONTENT-WP-0003-T05 +status: todo +priority: high +``` + +## Acceptance gates + +### Two connector types produce identical normalized snapshots for equivalent input. + +```task +id: CONTENT-WP-0003-T06 +status: todo +priority: high +``` + +### Repeated ingest yields the same content hash. + +```task +id: CONTENT-WP-0003-T07 +status: todo +priority: high +``` + +### Every published sourced claim has a retrievable evidence reference. + +```task +id: CONTENT-WP-0003-T08 +status: todo +priority: high +``` + +### Rights violations prevent publication. + +```task +id: CONTENT-WP-0003-T09 +status: todo +priority: high +``` + +## Key risk + +R5: rights metadata missing. Quarantine instead of guessing. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0004-relations-journeys.md b/workplans/CONTENT-WP-0004-relations-journeys.md new file mode 100644 index 0000000..b0aee87 --- /dev/null +++ b/workplans/CONTENT-WP-0004-relations-journeys.md @@ -0,0 +1,94 @@ +--- +id: CONTENT-WP-0004 +type: workplan +title: "Relation explorer and knowledge journeys" +domain: infotech +repo: content-explorer +status: proposed +flavor: implementation +depends_on: + - CONTENT-WP-0002 + - CONTENT-WP-0003 +created: "2026-10-12" +updated: "2026-10-12" +--- + +# Relation explorer and knowledge journeys + +Make interconnected knowledge explorable beyond the basic browse and detail path. + +## Work packages + +### Implement typed outgoing and incoming relation blocks and inverse labels. + +```task +id: CONTENT-WP-0004-T01 +status: todo +priority: high +``` + +### Build a bounded interactive one-to-two hop graph and an adjacency export. + +```task +id: CONTENT-WP-0004-T02 +status: todo +priority: high +``` + +### Add collections, related objects, and reading-path breadcrumbs. + +```task +id: CONTENT-WP-0004-T03 +status: todo +priority: high +``` + +### Introduce optional glossary tooltips and link previews. + +```task +id: CONTENT-WP-0004-T04 +status: todo +priority: high +``` + +### Handle cycles, a multigraph, multi-parent hierarchy, and disconnected components. + +```task +id: CONTENT-WP-0004-T05 +status: todo +priority: high +``` + +## Acceptance gates + +### No graph relation is omitted silently. + +```task +id: CONTENT-WP-0004-T06 +status: todo +priority: high +``` + +### Graph focus and detail navigation are reversible and deep-linkable. + +```task +id: CONTENT-WP-0004-T07 +status: todo +priority: high +``` + +### Large-graph safeguards are tested with a synthetic fixture. + +```task +id: CONTENT-WP-0004-T08 +status: todo +priority: high +``` + +## Key risk + +R6: large graph performance. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0005-quality-parity.md b/workplans/CONTENT-WP-0005-quality-parity.md new file mode 100644 index 0000000..f9bb9c9 --- /dev/null +++ b/workplans/CONTENT-WP-0005-quality-parity.md @@ -0,0 +1,95 @@ +--- +id: CONTENT-WP-0005 +type: workplan +title: "Quality system and upstream experience parity" +domain: infotech +repo: content-explorer +status: proposed +flavor: implementation +depends_on: + - CONTENT-WP-0004 +created: "2026-10-12" +updated: "2026-10-12" +--- + +# Quality system and upstream experience parity + +Measure architectural independence and UX faithfulness. Measurement can start during CONTENT-WP-0000. This plan closes after CONTENT-WP-0004. + +CONTENT-WP-0007 compares one permitted pinned OnCo slice through the original implementation and Content Explorer. Public CI remains synthetic-only. + +## Work packages + +### Automate schema, ingest, UI, and end-to-end tests, including the two-domain switch. + +```task +id: CONTENT-WP-0005-T01 +status: todo +priority: high +``` + +### Run accessibility, screenshot comparison, core web vitals, and responsive audits. + +```task +id: CONTENT-WP-0005-T02 +status: todo +priority: high +``` + +### Report provenance completeness, stale counts, unresolved references, and ingestion failure classes. + +```task +id: CONTENT-WP-0005-T03 +status: todo +priority: high +``` + +### Document deviations from upstream and verify third-party notices. + +```task +id: CONTENT-WP-0005-T04 +status: todo +priority: high +``` + +### Harden inputs and public snapshot generation. + +```task +id: CONTENT-WP-0005-T05 +status: todo +priority: high +``` + +## Acceptance gates + +### Tests run in CI and show no material keyboard accessibility failures. + +```task +id: CONTENT-WP-0005-T06 +status: todo +priority: high +``` + +### Two unrelated domains pass all critical journeys. + +```task +id: CONTENT-WP-0005-T07 +status: todo +priority: high +``` + +### A source and license completeness report is available. + +```task +id: CONTENT-WP-0005-T08 +status: todo +priority: high +``` + +## Key risk + +R7: tests approximate but do not prove usability. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0006-external-pilot.md b/workplans/CONTENT-WP-0006-external-pilot.md new file mode 100644 index 0000000..1e477b6 --- /dev/null +++ b/workplans/CONTENT-WP-0006-external-pilot.md @@ -0,0 +1,93 @@ +--- +id: CONTENT-WP-0006 +type: workplan +title: "Extensibility and first real-world pilot" +domain: infotech +repo: content-explorer +status: proposed +flavor: implementation +depends_on: + - CONTENT-WP-0005 +created: "2026-10-12" +updated: "2026-10-12" +--- + +# Extensibility and first real-world pilot + +Attach an independently maintained knowledge source and validate user value. + +## Work packages + +### Implement a third connector, GitHub issues or Wikidata, after a rights and rate review. + +```task +id: CONTENT-WP-0006-T01 +status: todo +priority: high +``` + +### Provide a connector authoring template with fixture-based certification tests. + +```task +id: CONTENT-WP-0006-T02 +status: todo +priority: high +``` + +### Pilot one non-medical infospace with real users. + +```task +id: CONTENT-WP-0006-T03 +status: todo +priority: high +``` + +### Prioritize API, JSON-LD, MCP, and ask enhancements from observed needs. + +```task +id: CONTENT-WP-0006-T04 +status: todo +priority: high +``` + +### Define long-term update and governance responsibilities. + +```task +id: CONTENT-WP-0006-T05 +status: todo +priority: high +``` + +## Acceptance gates + +### The third connector is refreshable and auditable. + +```task +id: CONTENT-WP-0006-T06 +status: todo +priority: high +``` + +### The pilot uses no hardcoded kinds in the UI. + +```task +id: CONTENT-WP-0006-T07 +status: todo +priority: high +``` + +### Document an informed go or no-go for dynamic deployment and a search backend. + +```task +id: CONTENT-WP-0006-T08 +status: todo +priority: high +``` + +## Key risk + +R8: third-party API policies and data quality. Log evidence and deviations in the workplan review before marking complete. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/CONTENT-WP-0007-onco-reference-slice.md b/workplans/CONTENT-WP-0007-onco-reference-slice.md new file mode 100644 index 0000000..648bd45 --- /dev/null +++ b/workplans/CONTENT-WP-0007-onco-reference-slice.md @@ -0,0 +1,99 @@ +--- +id: CONTENT-WP-0007 +type: workplan +title: "OnCo licensed reference-slice conformance" +domain: infotech +repo: content-explorer +status: blocked +flavor: implementation +depends_on: + - CONTENT-WP-0000 + - CONTENT-WP-0001 + - CONTENT-WP-0002 + - CONTENT-WP-0003 + - CONTENT-WP-0005 +created: "2026-10-12" +updated: "2026-10-12" +--- + +# OnCo licensed reference-slice conformance + +Validate generic Content Explorer against real OnCo topology and UX using a small pinned, authorized cancer-data slice, without copying the broader corpus. No real data import until authorization exists. See `tests/onco-reference/README.md`. + +## Work packages + +### Determine the test operator and use, acquire the permission or license required by OnCo LICENSE-DATA, and document redistribution restrictions. + +```task +id: CONTENT-WP-0007-T01 +status: wait +needs_human: true +blocking_reason: "OnCo LICENSE-DATA authorization is required before any real reference-slice import." +priority: high +``` + +### Pin the upstream SHA and capture behavior for about 12 to 25 representative entities, 8 or more user journeys, and several viewport sizes. + +```task +id: CONTENT-WP-0007-T02 +status: todo +priority: high +``` + +### Build an allowlist-only onco-reference adapter from explicitly authorized local inputs to a canonical snapshot, retaining provenance, dates, rights, and record links. + +```task +id: CONTENT-WP-0007-T03 +status: todo +priority: high +``` + +### Implement graph topology, inverse links, search and facet, detail, source display, stable deep-link, and negative mutation tests. + +```task +id: CONTENT-WP-0007-T04 +status: todo +priority: high +``` + +### Run paired OnCo and Content Explorer browser tests against the pinned source baseline, and report semantic and visual divergences separately. + +```task +id: CONTENT-WP-0007-T05 +status: todo +priority: high +``` + +### Run clean-room public CI with synthetic domains and no OnCo dataset, and audit that no OnCo corpus entered distributable packages or build artifacts. + +```task +id: CONTENT-WP-0007-T06 +status: todo +priority: high +``` + +## Acceptance gates + +### No real data import until authorization, and no missing attribution or silent relation loss. + +```task +id: CONTENT-WP-0007-T07 +status: todo +priority: high +``` + +### Version-pinned reproducibility, a comparative conformance report, and documented exceptions. + +```task +id: CONTENT-WP-0007-T08 +status: todo +priority: high +``` + +## Key risk + +Data-use authorization is the blocker. Do not guess rights. Public fixtures remain independently authored. + +## Evidence + +Pull requests, test logs, pinned artifacts, screenshots, or a comparison report where applicable. Add `ImplementationNotes.md` and `Review.md` on completion. Do not mark a gate passed without a verifiable link. diff --git a/workplans/INDEX.md b/workplans/INDEX.md deleted file mode 100644 index 87c49ff..0000000 --- a/workplans/INDEX.md +++ /dev/null @@ -1,17 +0,0 @@ -# Execution plan and dependency map - -| ID | Workplan | Prerequisites | Milestone | -|---|---|---|---| -| WP-00 | Upstream baseline & IP audit | none | Reproducible reference and extraction decision | -| WP-01 | Canonical contracts & fixtures | none; coordinate with WP-00 | Two independent dataspaces pass contract | -| WP-02 | UI extraction & experience skeleton | WP-00 + WP-01 | First generic explorer end-to-end | -| WP-03 | Ingestion & publishing | WP-01 (parallel WP-02) | Repeatable snapshots with evidence | -| WP-04 | Relations & journeys | WP-02 + WP-03 | Graph navigation | -| WP-05 | Quality & parity | begins WP-00, closes WP-04 | Release candidate | -| WP-06 | External pilot | WP-05 | Decision to expand | - -**Minimum viable proof:** WP-00 → WP-01 → WP-02, with JSON snapshot ingestion; WP-03 provenance gate is required before any externally ingested public content is published. WP-04+ need not delay the basic demo. - -Each workplan has a deliverable, tasks, verification gates and risks. No effort estimates are asserted before cloning and profiling the upstream code. Proposed priority: WP-00/01 now; WP-02 then WP-03; WP-04/05; pilot WP-06. - -- **WP-07** — Opt-in, authorized OnCo reference-slice conformance and paired upstream behavioral tests (see `WP-07.md`). diff --git a/workplans/README.md b/workplans/README.md new file mode 100644 index 0000000..c2be35b --- /dev/null +++ b/workplans/README.md @@ -0,0 +1,20 @@ +# Execution plan and dependency map + +Hub ids use the `CONTENT-WP` prefix. The seed notes called these WP-00 through WP-07. + +| ID | Workplan | Prerequisites | Milestone | +|---|---|---|---| +| CONTENT-WP-0000 | Upstream baseline and IP audit | none | Reproducible reference and extraction decision | +| CONTENT-WP-0001 | Canonical contracts and fixtures | none; coordinate with 0000 | Two independent dataspaces pass the contract | +| CONTENT-WP-0002 | UI extraction and experience skeleton | 0000 + 0001 | First generic explorer end to end | +| CONTENT-WP-0003 | Ingestion and publishing | 0001 (parallel with 0002) | Repeatable snapshots with evidence | +| CONTENT-WP-0004 | Relations and journeys | 0002 + 0003 | Graph navigation | +| CONTENT-WP-0005 | Quality and parity | begins with 0000, closes after 0004 | Release candidate | +| CONTENT-WP-0006 | External pilot | 0005 | Decision to expand | +| CONTENT-WP-0007 | OnCo reference-slice conformance | 0000, 0001, 0002, 0003, 0005 | Blocked on data-use authorization | + +**Minimum viable proof:** 0000 → 0001 → 0002, with JSON snapshot ingestion. The 0003 provenance gate is required before any externally ingested public content is published. 0004 and later need not delay the basic demo. + +No effort estimates are asserted before cloning and profiling the upstream code. Priority: 0000 and 0001 now; then 0002 and 0003; then 0004 and 0005; then the 0006 pilot. 0007 stays blocked until OnCo data use is authorized. + +`INDEX.md` was renamed to this file so the State Hub workplan scan does not treat the map as a workplan. diff --git a/workplans/WP-00.md b/workplans/WP-00.md deleted file mode 100644 index 3b6bbd2..0000000 --- a/workplans/WP-00.md +++ /dev/null @@ -1,28 +0,0 @@ -# WP-00 — Upstream baseline & IP audit - -**Purpose:** Reproduce OnCo baseline and establish legal, behavioral and visual reference. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Pin immutable upstream git SHA and preserve original MIT license/NOTICE. -- [ ] Install exactly locked dependencies; run build/test/lint/typecheck and record results. -- [ ] Trace dependencies of browser, detail, graph, navigation and data. -- [ ] Capture responsive screenshots and keyboard interaction walkthrough. -- [ ] Inventory data, code, logos, artwork, fonts, external dependency licenses. -- [ ] Quantify oncology-specific references and decide component-by-component reuse. - -## Acceptance gates - -- [ ] Pinned SHA, baseline report and component inventory committed. -- [ ] License matrix separates MIT software from NC dataset/assets. -- [ ] One reference example each for browse/detail/search/relations captured. - -## Key risk / mitigation focus - -R1: license/source boundary; R2: unable to reproduce baseline. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. diff --git a/workplans/WP-01.md b/workplans/WP-01.md deleted file mode 100644 index 9389b72..0000000 --- a/workplans/WP-01.md +++ /dev/null @@ -1,27 +0,0 @@ -# WP-01 — Canonical contracts & 2-domain fixtures - -**Purpose:** Establish source-independent knowledge projection and the zero-UI-code-change experiment. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Freeze v0.1 snapshot schema and manifest schema; document migrations. -- [ ] Model entity IDs, kinds, directed relations, evidence and claims in TS/Zod. -- [ ] Normalize systems-thinking and software-architecture fixtures with independently authored prose. -- [ ] Write duplicate, dangling, cyclic non-taxonomy and missing-source tests. -- [ ] Define policy for unknown and conflicting facts. - -## Acceptance gates - -- [ ] Both fixtures validate and supply ≥3 kinds and ≥8 entities each. -- [ ] A shared renderer can switch manifests with no domain vocabulary in UI source. -- [ ] Snapshot format documented and versioned. - -## Key risk / mitigation focus - -R3: abstractions erase domain semantics. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. diff --git a/workplans/WP-02.md b/workplans/WP-02.md deleted file mode 100644 index 41e32a7..0000000 --- a/workplans/WP-02.md +++ /dev/null @@ -1,28 +0,0 @@ -# WP-02 — UI extraction & experience skeleton - -**Purpose:** Deliver the strongest OnCo-style interaction patterns on generic data. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Extract/port UI tokens, layout, header, hero and reusable table from pinned upstream. -- [ ] Create registry-based kind index and entity detail with no oncology imports. -- [ ] Adapt BrowserRow via a pure mapper and add configurable generic cell renderers. -- [ ] Preserve shareable URL query, facets and sorting; test browser back/forward. -- [ ] Implement keyboard search, empty/loading/error states and responsive layouts. - -## Acceptance gates - -- [ ] Browse/search/filter/sort/detail works for two dataspaces. -- [ ] Component dependency check prohibits `/oncology|cancer|drug|target/` domain imports in generic code. -- [ ] Copying upstream components retains provenance headers/notices. -- [ ] Keyboard and small-screen smoke tests pass. - -## Key risk / mitigation focus - -R4: extraction too expensive; use greenfield component where warranted. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. diff --git a/workplans/WP-03.md b/workplans/WP-03.md deleted file mode 100644 index 319e107..0000000 --- a/workplans/WP-03.md +++ /dev/null @@ -1,28 +0,0 @@ -# WP-03 — Ingestion, provenance & publishing - -**Purpose:** Turn raw inputs into trustworthy reproducible snapshots. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Implement build-time JSON/NDJSON and Markdown frontmatter connector APIs. -- [ ] Make import idempotent with source digests and connector version. -- [ ] Resolve links in second pass; report dangling/conflicts; distinguish tombstones. -- [ ] Model source licenses, citations and attribution; quarantine unsupported content. -- [ ] Generate snapshot, manifest and machine/human import reports; atomic publication. - -## Acceptance gates - -- [ ] Two connector types produce identical normalized snapshots for equivalent input. -- [ ] Repeated ingest yields same content hash. -- [ ] Every published sourced claim has a retrievable evidence reference. -- [ ] Rights violations prevent publication. - -## Key risk / mitigation focus - -R5: rights metadata missing; quarantine instead of guessing. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. diff --git a/workplans/WP-04.md b/workplans/WP-04.md deleted file mode 100644 index 8cb29a5..0000000 --- a/workplans/WP-04.md +++ /dev/null @@ -1,27 +0,0 @@ -# WP-04 — Relation explorer & knowledge journeys - -**Purpose:** Make interconnected knowledge truly explorable. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Implement typed outgoing/incoming relation blocks and inverse labels. -- [ ] Build bounded interactive 1-2 hop graph and adjacency export. -- [ ] Add collections, related objects, reading path breadcrumbs. -- [ ] Introduce optional glossary tooltips and link previews. -- [ ] Handle cycles, multigraph, multi-parent hierarchy and disconnected components. - -## Acceptance gates - -- [ ] No graph relation omitted silently. -- [ ] Graph focus and detail navigation are reversible and deep linkable. -- [ ] Large graph safeguards tested with synthetic fixture. - -## Key risk / mitigation focus - -R6: large graph performance. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. diff --git a/workplans/WP-05.md b/workplans/WP-05.md deleted file mode 100644 index a0cf61d..0000000 --- a/workplans/WP-05.md +++ /dev/null @@ -1,31 +0,0 @@ -# WP-05 — Quality system & upstream experience parity - -**Purpose:** Measure architectural independence and UX faithfulness. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Automate schema/ingest/ui/e2e tests and two-domain switch tests. -- [ ] Run accessibility, screenshot comparison, core web vitals and responsive audits. -- [ ] Report provenance completeness, stale counts, unresolved refs and ingestion failure classes. -- [ ] Document deviations from upstream and verify third-party notices. -- [ ] Harden inputs and public snapshot generation. - -## Acceptance gates - -- [ ] Tests run in CI; no material keyboard accessibility failures. -- [ ] Two unrelated domains pass all critical journeys. -- [ ] Source and license completeness report available. - -## Key risk / mitigation focus - -R7: tests approximate but do not prove usability. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. - -## Reference-oracle testing extension - -Add WP-07: compare the *same permitted pinned OnCo slice* through the original implementation and generic Content Explorer, including behavioral journeys and visual snapshots. Public CI remains synthetic-only. diff --git a/workplans/WP-06.md b/workplans/WP-06.md deleted file mode 100644 index bf87f97..0000000 --- a/workplans/WP-06.md +++ /dev/null @@ -1,27 +0,0 @@ -# WP-06 — Extensibility & first real-world pilot - -**Purpose:** Attach an independently maintained knowledge source and validate user value. - -**Dependencies:** see `INDEX.md`. **Status:** planned. **Owner:** to assign. **Estimate:** to refine after WP-00. - -## Work packages - -- [ ] Implement third connector (GitHub issues or Wikidata after rights/rate review). -- [ ] Provide connector authoring template with fixture-based certification tests. -- [ ] Pilot one non-medical viable infospace with real users. -- [ ] Prioritize API/JSON-LD/MCP/ASK enhancements from observed needs. -- [ ] Define long-term update and governance responsibilities. - -## Acceptance gates - -- [ ] Third connector is refreshable and auditable. -- [ ] Pilot uses no hardcoded kinds in UI. -- [ ] Document informed go/no-go for dynamic deployment and search backend. - -## Key risk / mitigation focus - -R8: third-party API policies and data quality. Log evidence and deviations in the workplan review before marking complete. - -## Evidence artifacts - -Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit `ImplementationNotes.md` and `Review.md` on completion; do not mark a gate passed without a verifiable link. diff --git a/workplans/WP-07.md b/workplans/WP-07.md deleted file mode 100644 index 9162509..0000000 --- a/workplans/WP-07.md +++ /dev/null @@ -1,16 +0,0 @@ -# WP-07 — OnCo licensed reference-slice conformance - -**Purpose:** validate generic Content Explorer against real OnCo topology and the OnCo UX using a small pinned, authorized cancer-data slice, without copying the broader corpus. - -**Dependencies:** WP-00 license/behavior audit; WP-01 model; WP-02 UI; WP-03 connector; WP-05 test harness. **Status:** planned and BLOCKED on data-use authorization. - -## Tasks -- [ ] Determine test operator/use, acquire permission/license where required by OnCo `LICENSE-DATA`; document decision and redistribution restrictions. -- [ ] Pin upstream SHA and capture behavior for ~12–25 representative entities, 8+ user journeys, and several viewport sizes. -- [ ] Build allowlist-only `onco-reference` adapter from explicitly authorized local inputs to canonical snapshot, retaining provenance, dates, rights and record links. -- [ ] Implement graph topology, inverse-links, search/facet, detail, source display, stable deep-link and negative mutation tests. -- [ ] Run paired OnCo/Content Explorer Playwright tests against pinned source baseline; report semantic and visual divergences separately. -- [ ] Run clean-room public CI with synthetic domains and no actual OnCo dataset; audit that no OnCo corpus entered distributable packages/build artifacts. - -## Gate -No real data import until authorization; no missing attribution or silent relation loss; version-pinned reproducibility; comparative conformance report and documented exceptions. For full process see `tests/onco-reference/README.md`.