Repair capability federation index

registry/capabilities/capability.evidence.binding.md

@@ -0,0 +1,184 @@
+---
+id: capability.evidence.binding
+name: Evidence-to-Target Binding
+summary: >-
+  Links evidence items to structured targets with relation, status, and
+  confidence metadata, bidirectional queries, active-state coordination, and
+  canonical engine events.
+owner: evidence-binder
+status: draft
+domain: infotech
+tags:
+  - evidence
+  - binding
+  - evidence-link
+  - form-field
+  - citation-evidence
+
+maturity:
+  discovery:
+    current: D3
+    target: D5
+    confidence: high
+    rationale: >-
+      INTENT.md, SCOPE.md, the extraction inventory, shared contracts, and the
+      reference-UI ADR define the boundary, neighboring systems, contract
+      deltas, and obvious risks. The capability has not yet been grounded in a
+      systematic cross-domain use-case catalogue.
+  availability:
+    current: A2
+    target: A2
+    confidence: high
+    rationale: >-
+      The private TypeScript package exports its binding service, in-memory
+      repository, active-state flow, and React provider and is source-linked by
+      the citation-evidence umbrella. A source library is its natural delivery
+      level; no CLI or service surface is intended.
+
+external_evidence:
+  completeness:
+    level: C3
+    confidence: medium
+    basis: scope_vs_intent_and_consumer_expectations
+    satisfied_expectations:
+      - create, update, remove, and query evidence links in both directions
+      - coordinate active target, evidence item, and annotation state
+      - emit the canonical engine event vocabulary
+      - support the umbrella form-field binding path end to end
+    broken_expectations:
+      - non-form target kinds are defined by contract but not exercised by the current umbrella consumer
+      - target adapters and evidence-sufficiency helpers remain narrower than the aspirational INTENT
+    out_of_scope_expectations:
+      - durable persistence implementation
+      - source ingestion, selector resolution, and host-application composition
+  reliability:
+    level: R3
+    confidence: medium
+    basis: consumer_quality_signals
+    evidence:
+      tests:
+        suites:
+          - src/services/bindings.test.ts
+          - src/state/active.test.ts
+          - src/FormRenderer.dom.test.tsx
+      integration:
+        consumer: citation-evidence
+        mode: source-linked internal package
+    known_reliability_risks:
+      - reliability evidence comes from one internal consumer rather than diverse independent consumers
+      - the bundled repository is in-memory and host persistence glue must restore links correctly
+
+discovery:
+  intent: >-
+    Turn collected evidence into inspectable relationships with structured
+    targets while keeping the binding layer target-neutral and independent of
+    ingestion, anchoring, and workspace composition.
+  includes:
+    - evidence-link lifecycle operations and bidirectional queries
+    - active target, evidence-item, and annotation coordination
+    - canonical event-bus emission
+    - a target-neutral reference form renderer
+  excludes:
+    - document ingestion and selector resolution
+    - evidence-source capture workflows
+    - review-workspace and umbrella application composition
+    - durable persistence implementation details
+  assumptions:
+    - citation-engine remains authoritative for shared types and event vocabulary
+    - host applications provide persistence and compose source and work surfaces
+  use_cases:
+    - attach source evidence to a structured form field
+    - list all evidence for a target and all targets for an evidence item
+    - activate a target and its supporting evidence for coordinated navigation
+  research_memos: []
+
+availability:
+  current_level: A2
+  target_level: A2
+  current_artifacts:
+    - src/services/bindings.ts
+    - src/repos/in-memory-links.ts
+    - src/state/active.ts
+    - src/BinderProvider.tsx
+    - src/FormRenderer.tsx
+  target_artifacts: []
+  consumption_modes:
+    - source module
+    - React provider
+
+relations:
+  depends_on: []
+  supports: []
+  related_to: []
+
+evidence:
+  documentation:
+    - README.md
+    - SCOPE.md
+    - INTENT.md
+    - docs/extraction-inventory.md
+    - docs/adr/ADR-0001-reference-ui-surface.md
+  tests:
+    - src/services/bindings.test.ts
+    - src/state/active.test.ts
+    - src/FormRenderer.dom.test.tsx
+  consumer_feedback:
+    - citation-evidence consumes the package through its sibling-checkout alias
+  bug_reports: []
+  incidents: []
+
+consumer_guidance:
+  recommended_for:
+    - internal TypeScript and React workflows that bind evidence to structured targets
+    - form-oriented consumers using citation-engine contracts
+  not_recommended_for:
+    - consumers needing a published package, remote API, or built-in durable storage
+    - applications that need document ingestion or selector resolution
+  known_limitations:
+    - only the form-field target path is exercised by the current umbrella consumer
+    - package distribution is a private sibling-checkout link
+
+promotion_history: []
+---
+
+# Evidence-to-Target Binding
+
+## Overview
+
+This capability owns the relationship and interaction layer between evidence
+items and structured targets. It provides evidence-link lifecycle operations,
+queries in both directions, active-state coordination, canonical engine-event
+emission, and the reference form integration used by the umbrella workspace.
+
+## Assessment notes
+
+### Discovery
+
+The package boundary and contract deltas are documented and implemented, which
+supports D3. Promotion to D5 needs an explicit catalogue of actors, target-type
+variants, and prioritization beyond the current form-field workflow.
+
+### Availability
+
+The capability is directly consumable as source code through the private
+TypeScript package and React exports. A2 is both current and the natural target.
+
+### Completeness
+
+The main form-field evidence-binding flow works end to end. Broader target
+adapters and evidence-sufficiency behavior described in INTENT remain future
+scope, so the assessment stays at C3.
+
+### Reliability
+
+Unit and DOM tests cover the service, state flow, and reference renderer, and
+the umbrella application consumes the package. That supports R3 for normal
+internal use, with medium confidence until more consumers provide evidence.
+
+## Promotion checklist
+
+- [x] ID follows the capability identifier pattern
+- [x] Maturity enums match the capability maturity standard
+- [x] External evidence is separate from internal maturity
+- [x] Relations reference no unresolved capability IDs
+- [x] Index entry points to this file