184 lines
6.3 KiB
Markdown
184 lines
6.3 KiB
Markdown
---
|
|
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
|