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
This commit is contained in:
parent
762707cefe
commit
5f8c2d0dae
22 changed files with 912 additions and 234 deletions
32
.custodian-brief.md
Normal file
32
.custodian-brief.md
Normal file
|
|
@ -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
|
||||
26
.repo-classification.yaml
Normal file
26
.repo-classification.yaml
Normal file
|
|
@ -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.
|
||||
53
AGENTS.md
Normal file
53
AGENTS.md
Normal file
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
|
|||
100
workplans/CONTENT-WP-0000-upstream-baseline.md
Normal file
100
workplans/CONTENT-WP-0000-upstream-baseline.md
Normal file
|
|
@ -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.
|
||||
94
workplans/CONTENT-WP-0001-canonical-contracts.md
Normal file
94
workplans/CONTENT-WP-0001-canonical-contracts.md
Normal file
|
|
@ -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.
|
||||
102
workplans/CONTENT-WP-0002-ui-extraction.md
Normal file
102
workplans/CONTENT-WP-0002-ui-extraction.md
Normal file
|
|
@ -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.
|
||||
101
workplans/CONTENT-WP-0003-ingestion-publishing.md
Normal file
101
workplans/CONTENT-WP-0003-ingestion-publishing.md
Normal file
|
|
@ -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.
|
||||
94
workplans/CONTENT-WP-0004-relations-journeys.md
Normal file
94
workplans/CONTENT-WP-0004-relations-journeys.md
Normal file
|
|
@ -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.
|
||||
95
workplans/CONTENT-WP-0005-quality-parity.md
Normal file
95
workplans/CONTENT-WP-0005-quality-parity.md
Normal file
|
|
@ -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.
|
||||
93
workplans/CONTENT-WP-0006-external-pilot.md
Normal file
93
workplans/CONTENT-WP-0006-external-pilot.md
Normal file
|
|
@ -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.
|
||||
99
workplans/CONTENT-WP-0007-onco-reference-slice.md
Normal file
99
workplans/CONTENT-WP-0007-onco-reference-slice.md
Normal file
|
|
@ -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.
|
||||
|
|
@ -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`).
|
||||
20
workplans/README.md
Normal file
20
workplans/README.md
Normal file
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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.
|
||||
|
|
@ -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`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue