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

2.1 KiB

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:

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:

~/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

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:

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.