content-explorer/README.md
tegwick 072a7fa550 Freeze the v0.1 contract and the local ingest connector.
The snapshot and manifest schemas, both example dataspaces, and the shared text renderer now pass the fixture validator and the negative contract tests. JSON, NDJSON, and Markdown frontmatter publish a snapshot only when rights, identity, and references allow it. CONTENT-WP-0001 and CONTENT-WP-0003 are marked finished against those artifacts. CONTENT-WP-0000-T04 stays open. SCOPE.md and the 19:05 scope-against-intent note record the stop.

Assistant: grok
Assistant-Session: 01a130f1-abfb-7d71-9cd6-a8b75ec7f95a
2026-10-12 19:07:32 +02:00

30 lines
2.1 KiB
Markdown

# 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/README.md](workplans/README.md).
## North-star demo
A single UI build loads either `systems-thinking` or `software-architecture`, shows the same browse/search/detail/connections experience, and needs zero edits to React components for the switch. Source references and rights follow every imported assertion.
## What this archive contains
Research grounded in publicly browsable upstream files, extraction plan, normative draft contracts, two independently authored small datasets, a basic connector example, executable fixture validator, roadmap and decision records. **It does not contain or claim to be a fork of upstream source.** Fetch and pin upstream at implementation time. See `scripts/bootstrap-upstream.sh`.
## Quick seed check
```sh
python3 scripts/validate_fixtures.py
python3 -m unittest tests.test_contract tests.test_ingest
```
## Implementation start
[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
[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.