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