Post WP-0002/0003 hygiene: update docs and archive finished workplans
Some checks are pending
CI Smoke / host-smoke (push) Waiting to run
CI Smoke / container-smoke (push) Waiting to run

Refresh README and SCOPE to reflect stale/fuzzy/DOM capabilities. Move
EANCH-WP-0001 through EANCH-WP-0003 to workplans/archived/260709-*.
This commit is contained in:
tegwick 2026-07-09 09:29:50 +02:00
parent a1af0c6a45
commit 113358c13c
5 changed files with 30 additions and 33 deletions

View file

@ -28,9 +28,10 @@ guess. It also owns the `DocumentViewerAdapter` contract every viewer implements
- selector **creation** from a captured viewer selection (`createSelectors`)
- selector **resolution** against a document representation (`resolveSelectors`)
- the exact-match confidence ladder and selector-redundancy rules
- the exact-match confidence ladder, fuzzy recovery floor, and selector-redundancy rules
- PDF selector math (page number + normalized page rectangles, page-local text)
- the format-neutral `DocumentViewerAdapter` contract and the first PDF adapter
- DOM/structural selector creation and resolution for HTML/Markdown
- the format-neutral `DocumentViewerAdapter` contract, the PDF adapter, and the HTML viewer
- scroll-to-target and highlight-render contracts + helpers
- anchor confidence scoring and ambiguous/unresolved/stale reporting
@ -50,14 +51,11 @@ Selector *behavior* lives here; selector *type interfaces* live in
During the umbrella-first MVP these belong to the appropriate citation-evidence
subsystem. This repo may depend on **`citation-engine` only** (DependencyMap §4).
### Not in this extraction slice (EANCH-WP-0001)
### Still deferred (beyond EANCH-WP-0002 / EANCH-WP-0003)
- full HTML/Markdown (`DomSelectionCapture`) selector implementation
- production-grade fuzzy / recovery-oriented re-anchoring
- `stale` and orphaned-annotation semantics beyond what upstream already ships
These are real INTENT.md goals but are **registered as follow-on work**, not
built during the initial extract-and-verify pass.
- `FragmentSelector` (export-only deep links)
- wiring `HtmlViewerAdapter` into `citation-work` / the umbrella review shell
- human-confirmation UI for ambiguous/fuzzy matches
---
@ -80,10 +78,10 @@ built during the initial extract-and-verify pass.
## Current State
- Status: experimental — extracting from the umbrella into a standalone package
- Implementation: partial — pure selector + PDF adapter slice exists upstream in
`../citation-evidence/src/anchor/`; extraction tracked by EANCH-WP-0001
- Stability: evolving — shared contracts stable, this repo's package API forming
- Status: active — standalone package consumed by `citation-evidence`
- Implementation: PDF + HTML/Markdown selector paths, stale/orphan/fuzzy resolution,
`PdfViewerAdapter`, and `HtmlViewerAdapter` (`evidence-anchor/dom`)
- Stability: evolving — shared contracts stable; viewer wiring in the umbrella is next
- Usage: internal (consumed by `citation-evidence` during MVP)
---