generated from coulomb/repo-seed
tegwick
4e17c9fea9
- Register under capabilities domain (foerster_capabilities renamed) - Replace prose workplans with ADR-001 format (RREG-WP-0001 done, RREG-WP-0002 active) - Add AGENTS.md for Codex agent state-hub integration via HTTP API - Add SCOPE.md with domain context and v0.1 scope boundaries Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
116 lines
3.3 KiB
Markdown
116 lines
3.3 KiB
Markdown
---
|
|
id: RREG-WP-0001
|
|
type: workplan
|
|
title: "Repository Ability Registry — MVP Implementation"
|
|
domain: capabilities
|
|
repo: repo-registry
|
|
status: done
|
|
owner: codex
|
|
topic_slug: foerster-capabilities
|
|
created: "2026-04-26"
|
|
updated: "2026-04-26"
|
|
state_hub_workstream_id: "acee5529-43c0-4519-94bc-e59e61719af1"
|
|
---
|
|
|
|
# RREG-WP-0001 — MVP Implementation
|
|
|
|
## Goal
|
|
|
|
Prove the core registry loop: Register → Analyze → Review → Approve → Search/Inspect.
|
|
|
|
Core design constraint: deterministic scanners establish observed facts; LLM-assisted
|
|
extractors propose interpreted claims; humans or trusted agents approve registry truth.
|
|
|
|
## Scaffold and Foundation
|
|
|
|
```task
|
|
id: RREG-WP-0001-T01
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "d26e70c9-e3a9-48f9-951c-c6210208aef4"
|
|
```
|
|
|
|
App skeleton, database migration setup, configuration system, health endpoint, basic
|
|
test harness, local development instructions. Acceptance: app starts, tests run,
|
|
migrations apply cleanly.
|
|
|
|
## Manual Registry
|
|
|
|
```task
|
|
id: RREG-WP-0001-T02
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "e9c1cb9b-be21-4862-9443-a3e6c390882e"
|
|
```
|
|
|
|
Repository CRUD, manual ability/capability/feature/evidence CRUD, ability-map endpoint,
|
|
basic repository profile UI. Acceptance: user can create a profile by hand; UI and API
|
|
both display `Ability → Capability → Feature → Evidence`.
|
|
|
|
## Git Ingestion and Deterministic Scanner
|
|
|
|
```task
|
|
id: RREG-WP-0001-T03
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "4a9fd9f0-d968-4778-93d4-609090c13c62"
|
|
```
|
|
|
|
Git URL validation, clone/fetch, snapshot with branch+commit hash, file tree scan,
|
|
README/docs/examples/tests/manifest detection, language/framework detection, analysis
|
|
run status tracking. Acceptance: public repo can be registered and analyzed; failures
|
|
visible without corrupting prior data.
|
|
|
|
## Reviewable Candidate Graph
|
|
|
|
```task
|
|
id: RREG-WP-0001-T04
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "9aa84fb5-998b-480e-adf8-3c1b0faa395a"
|
|
```
|
|
|
|
Content extraction, source references, candidate ability/capability/feature/evidence
|
|
generation, confidence scoring, candidate graph endpoint and UI. Acceptance: candidates
|
|
have source references and confidence; output is explainable for curator review.
|
|
|
|
## Review and Approval Workflow
|
|
|
|
```task
|
|
id: RREG-WP-0001-T05
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "0b5cff5d-4bc8-48ca-aa41-2f1d0c774bed"
|
|
```
|
|
|
|
Approve/reject/edit/merge/relink candidates, publish approved profile, persist review
|
|
decisions. Acceptance: curator can correct and approve an analysis result; only approved
|
|
entries appear in canonical views.
|
|
|
|
## Search and Inspection
|
|
|
|
```task
|
|
id: RREG-WP-0001-T06
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "13e506eb-017a-4710-b20b-ae10ac8df9d4"
|
|
```
|
|
|
|
Text search over repos/abilities/capabilities/descriptions, search filters, search UI,
|
|
repository profile drill-down, code/evidence links. Acceptance: user can search by need;
|
|
results show repo, ability/capability, confidence, evidence level.
|
|
|
|
## API Completeness for Agents
|
|
|
|
```task
|
|
id: RREG-WP-0001-T07
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "cb94bb9c-756f-446a-8a59-54aa5a51eff0"
|
|
```
|
|
|
|
Full MVP REST API: GET/POST /repos, GET /repos/{id}, POST/GET /repos/{id}/analysis-runs,
|
|
GET /repos/{id}/ability-map, GET /abilities, GET /capabilities, GET /search, OpenAPI
|
|
examples. Acceptance: API covers registration, analysis, search, inspection; stable
|
|
enough for agent/tooling integration.
|