content-explorer/AGENTS.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

54 lines
2.1 KiB
Markdown

# 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
python3 -m unittest tests.test_contract tests.test_ingest
```
## 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.