evidence-binder/registry/capabilities/capability.evidence.binding.md
tegwick e462775bae
All checks were successful
CI Smoke / host-smoke (push) Successful in 1s
CI Smoke / container-smoke (push) Successful in 2s
Repair capability federation index
2026-08-21 08:58:31 +02:00

6.3 KiB

id name summary owner status domain tags maturity external_evidence discovery availability relations evidence consumer_guidance promotion_history
capability.evidence.binding Evidence-to-Target Binding Links evidence items to structured targets with relation, status, and confidence metadata, bidirectional queries, active-state coordination, and canonical engine events. evidence-binder draft infotech
evidence
binding
evidence-link
form-field
citation-evidence
discovery availability
current target confidence rationale
D3 D5 high 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.
current target confidence rationale
A2 A2 high 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.
completeness reliability
level confidence basis satisfied_expectations broken_expectations out_of_scope_expectations
C3 medium scope_vs_intent_and_consumer_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
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
durable persistence implementation
source ingestion, selector resolution, and host-application composition
level confidence basis evidence known_reliability_risks
R3 medium consumer_quality_signals
tests integration
suites
src/services/bindings.test.ts
src/state/active.test.ts
src/FormRenderer.dom.test.tsx
consumer mode
citation-evidence source-linked internal package
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
intent includes excludes assumptions use_cases research_memos
Turn collected evidence into inspectable relationships with structured targets while keeping the binding layer target-neutral and independent of ingestion, anchoring, and workspace composition.
evidence-link lifecycle operations and bidirectional queries
active target, evidence-item, and annotation coordination
canonical event-bus emission
a target-neutral reference form renderer
document ingestion and selector resolution
evidence-source capture workflows
review-workspace and umbrella application composition
durable persistence implementation details
citation-engine remains authoritative for shared types and event vocabulary
host applications provide persistence and compose source and work surfaces
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
current_level target_level current_artifacts target_artifacts consumption_modes
A2 A2
src/services/bindings.ts
src/repos/in-memory-links.ts
src/state/active.ts
src/BinderProvider.tsx
src/FormRenderer.tsx
source module
React provider
depends_on supports related_to
documentation tests consumer_feedback bug_reports incidents
README.md
SCOPE.md
INTENT.md
docs/extraction-inventory.md
docs/adr/ADR-0001-reference-ui-surface.md
src/services/bindings.test.ts
src/state/active.test.ts
src/FormRenderer.dom.test.tsx
citation-evidence consumes the package through its sibling-checkout alias
recommended_for not_recommended_for known_limitations
internal TypeScript and React workflows that bind evidence to structured targets
form-oriented consumers using citation-engine contracts
consumers needing a published package, remote API, or built-in durable storage
applications that need document ingestion or selector resolution
only the form-field target path is exercised by the current umbrella consumer
package distribution is a private sibling-checkout link

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

  • ID follows the capability identifier pattern
  • Maturity enums match the capability maturity standard
  • External evidence is separate from internal maturity
  • Relations reference no unresolved capability IDs
  • Index entry points to this file