149 lines
5.1 KiB
Markdown
149 lines
5.1 KiB
Markdown
---
|
|
id: EBIND-WP-0001
|
|
type: workplan
|
|
title: "Extract evidence-binder from citation-evidence"
|
|
domain: infotech
|
|
repo: evidence-binder
|
|
status: ready
|
|
owner: codex
|
|
topic_slug: citation_evidence_mvp
|
|
created: "2026-06-21"
|
|
updated: "2026-07-08"
|
|
state_hub_workstream_id: "405d789c-0e0b-4764-89ed-0f6140a143e7"
|
|
---
|
|
|
|
# EBIND-WP-0001 — Extract evidence-binder from citation-evidence
|
|
|
|
`evidence-binder` is still INTENT-only in this repo, but the current
|
|
implementation already exists upstream in `../citation-evidence/src/binder/`.
|
|
That slice includes a binding service, in-memory link repository, active-state
|
|
machine, rect registry and overlay, provider wiring, and a small form-oriented
|
|
reference UI. This workplan turns the placeholder into a concrete extraction
|
|
plan that preserves the canonical contracts in
|
|
`../citation-evidence/wiki/SharedContracts.md` and the allowed edges in
|
|
`../citation-evidence/wiki/DependencyMap.md`.
|
|
|
|
## Lock Extraction Boundary And Contract Deltas
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T01
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "f2abe7f8-089b-4719-a739-18dc3224e9eb"
|
|
```
|
|
|
|
Review the upstream binder slice (`services/`, `repos/`, `state/`,
|
|
`visual-guide/`, `BinderProvider.tsx`, `FormRenderer.tsx`) against
|
|
`SharedContracts.md` sections 2.4, 2.5, 4, and 7 plus `DependencyMap.md`
|
|
section 2. Capture and resolve remaining deltas before extraction, including
|
|
INTENT drift around `EvidenceTarget` naming, the dropped
|
|
`derived-from` / `needs-check` relation values, and any event vocabulary that
|
|
is not yet canonicalized.
|
|
|
|
## Stand Up Standalone Package, Tests, And Repo Metadata
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T02
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "122a254f-6490-4211-bde7-ce515c72c36a"
|
|
```
|
|
|
|
Create the standalone package and test harness that this repo currently lacks,
|
|
then refresh repo-local metadata so it stops looking like a placeholder. This
|
|
includes package entrypoints, test scripts, baseline CI/tooling, `README.md`,
|
|
`SCOPE.md`, and the stale capability metadata in
|
|
`registry/indexes/capabilities.yaml`.
|
|
|
|
## Extract Headless Binding Model And Repository
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T03
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "d58501a4-b2e5-45fa-b504-e2c37ca48e68"
|
|
```
|
|
|
|
Move the headless binding primitives from
|
|
`../citation-evidence/src/binder/repos/in-memory-links.ts` and
|
|
`../citation-evidence/src/binder/services/bindings.ts` with their tests. Keep
|
|
the current query directions, default relation/status behavior, and event-bus
|
|
emission semantics while staying independent of persistence, viewer internals,
|
|
`citation-work`, and `evidence-source`.
|
|
|
|
## Extract Active State And Provider Composition
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T04
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "b6f96550-c4a6-4ce1-bfde-4c91d33da687"
|
|
```
|
|
|
|
Extract `state/active.ts` and `BinderProvider.tsx` so the binder owns the
|
|
active target / active evidence / active annotation state triple plus the
|
|
composition root that wires link storage, binding services, rect registry, and
|
|
engine bus access. Preserve `initialLinks` restore behavior and bus injection
|
|
without introducing a dependency on umbrella app code.
|
|
|
|
## Extract Rect Registry, Change Pumps, And Overlay
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T05
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "58b55a71-eee4-4f3d-9bcd-7c3678320dd1"
|
|
```
|
|
|
|
Move the visual-guide contract from
|
|
`../citation-evidence/src/binder/visual-guide/`, including
|
|
`rect-registry.ts`, `events.ts`, `react-hooks.ts`, `Overlay.tsx`, and their
|
|
tests. Preserve the section 7 rect kinds, invalidate/version semantics,
|
|
requestAnimationFrame throttling, and the contract that independent renderers
|
|
publish rects into one registry.
|
|
|
|
## Decide Binder-Owned Reference UI Surface
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T06
|
|
status: todo
|
|
priority: medium
|
|
state_hub_task_id: "39164219-5f35-49cf-874a-00fd0c902007"
|
|
```
|
|
|
|
Decide whether `FormRenderer.tsx` and `FieldDefinitionForm.tsx` remain binder
|
|
exports, move into examples, or shift into an application layer. Whatever the
|
|
outcome, keep binder form-friendly but target-neutral, avoid a `citation-work`
|
|
dependency, and document which React surfaces are supported versus merely
|
|
illustrative.
|
|
|
|
## Cut Over Umbrella Integration And Verify Boundaries
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T07
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "efceaee5-43a8-4ecf-9025-a5843eecada0"
|
|
```
|
|
|
|
Update `citation-evidence` to consume the extracted binder package instead of
|
|
owning `src/binder/` directly, or otherwise enforce the same boundary through
|
|
package-level imports during a staged cutover. Verify there are no forbidden
|
|
edges to `citation-evidence` behavior, `citation-work`, or `evidence-source`,
|
|
and keep shared-contract changes flowing through the umbrella docs until the
|
|
cutover is complete.
|
|
|
|
## Exit Criteria
|
|
|
|
```task
|
|
id: EBIND-WP-0001-T08
|
|
status: todo
|
|
priority: medium
|
|
state_hub_task_id: "2c89dfcb-1526-46d9-936d-8f97f4e48d76"
|
|
```
|
|
|
|
Exit when this repo exports the binder service, active-state flow, and
|
|
visual-guide rect-registry contract with passing tests; repo docs and metadata
|
|
match the canonical shared contracts; and the umbrella app can define a target,
|
|
link evidence, activate evidence, and draw the field-to-card-to-highlight
|
|
overlay without relying on the upstream `src/binder/` implementation.
|