coulomb/citation-evidence
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
citation-evidence/package.json

53 lines
1.5 KiB
JSON
Raw Normal View History

Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
{
"name": "citation-evidence",
"version": "0.0.0",
"private": true,
"description": "Document-centered evidence workspace — umbrella-first MVP.",
"license": "Apache-2.0",
"type": "module",
"packageManager": "pnpm@9.15.0",
"engines": {
"node": ">=20.10.0"
},
"scripts": {
"dev": "vite",
Implement CE-WP-0002 T01-T02: engine types + PDF viewer adapter spike T01: shared engine types (Document, Selector union, Annotation, EvidenceItem, branded IDs with newId factory) per wiki/SharedContracts.md §1-§3. T02: react-pdf-highlighter-plus v1.1.4 spike behind the §5 DocumentViewerAdapter contract in src/anchor/. Pure round-trip math extracted to pdf-selector-math.ts with 11 unit tests proving lossless capture → selectors → JSON → restored-rects. ADR-0004 accepted; full user-flow Playwright verification deferred to T09. Adds Vite app shell (index.html, src/app/SpikeApp.tsx) so the spike is exercisable via pnpm dev. tsconfig --noEmit prevents tsc -b from littering src/ with stray .js outputs. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 02:21:31 +02:00
"build": "tsc -b --noEmit && vite build",
Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
"preview": "vite preview",
"test": "vitest run",
"test:watch": "vitest",
"lint": "eslint .",
"typecheck": "tsc -b --noEmit"
},
"dependencies": {
Implement CE-WP-0009: wire umbrella to @citation-evidence/engine Add link: dependency on citation-engine, retarget @shared/@engine aliases, remove in-repo shared/engine copies. ADR-0002 accepted (option B). 172 tests, typecheck, and lint pass.
2026-06-22 19:45:11 +02:00
"@citation-evidence/engine": "link:../citation-engine",
refactor(source): consume extracted evidence-source package (ESRC-WP-0001-T06) Replace the local src/source PDF slice with the standalone @citation-evidence/evidence-source package (link:../evidence-source). - src/source/index.ts is now a thin façade re-exporting the ingest core and browser upload helpers from the package - viewer-url stays local (viewer concern) but takes PdfByteStore from the package - extracted ingest/extract/fingerprint/byte-store/upload files removed - anchor-source round-trip integration test now exercises the package across the repo boundary Full suite (125 tests), typecheck, and lint all green. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 20:55:43 +02:00
"@citation-evidence/evidence-source": "link:../evidence-source",
refactor(anchor): consume extracted evidence-anchor package (EANCH-WP-0001-T05) Replace the in-repo src/anchor/ slice with a dependency on the extracted @citation-evidence/evidence-anchor package (link:../evidence-anchor). - package.json: add the link dependency - repoint all @anchor/{index,selectors,types} imports and vi.mock targets to the package barrel; the node-env anchor-source-roundtrip test uses the pure ./selectors and ./types subpaths (no pdfjs pulled into a node environment) - drop the @anchor alias from tsconfig paths and vite resolve - delete src/anchor/ (behavior now owned by evidence-anchor) Verified green: pnpm typecheck, pnpm test (26 files / 95 tests), pnpm build. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-08 21:08:27 +02:00
"@citation-evidence/evidence-anchor": "link:../evidence-anchor",
refactor: consume @citation-evidence/work for review mode (CWORK-WP-0001 cutover) Cut review mode over to the extracted citation-work package instead of a local src/work/ implementation. - Add @citation-evidence/work as a link: dependency - Repoint the @work alias (tsconfig + vite) to ../citation-work/src/work and allow vite fs access to the sibling - Remove the local src/work/ implementation (now owned by citation-work) Typecheck, lint, and the full test suite (51 tests) pass. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-09 01:49:36 +02:00
"@citation-evidence/work": "link:../citation-work",
Implement CE-WP-0005 T01-T08: demo app — sessions, uploads, ZIP archive Turn the MVP into a self-contained demo. Users now: 1. Land on an empty-state and create a named session. 2. Drag-drop or pick arbitrary PDFs into that session. 3. Annotate, build evidence, link to form fields — all session-scoped. 4. Export the whole session as a single .zip archive (manifest + per-document PDFs). 5. Import a .zip back — into a new session, or merged into an existing one (documents deduped by SHA-256 fingerprint; annotations/evidence/links added additively). Architecture: - New shared types: SessionId, Session, SessionArchiveManifest + parseSessionArchiveManifest with schema-version validation. - SessionService (engine/services/sessions.ts) handles lifecycle (create/rename/delete/setActive) + emits 4 new events through its own bus; SharedContracts.md §4 lists the additions. - SessionProvider (work/SessionContext.tsx) owns the cross-session state: service, per-session PdfByteStore registry, per-session version counter that drives EngineProvider remounts after imports. - EngineProvider becomes session-aware (sessionId prop drives per- session localStorage keys). Bumping engineRevision after restoreFromStorage forces consumers to re-render so restored repos show up immediately. - PdfByteStore (source/pdf/byte-store.ts) holds Uint8Array bytes per document and mints blob URLs; ingestPdfFromFile is the upload entry-point that wraps the existing ingestPdf pipeline. - ADR-0008 locks the ZIP layout (manifest.json + documents/<id>.pdf), the manifest schema (schemaVersion 1), and the merge-on-collision policy. JSZip is the only new dependency. - App.tsx restructured: SessionProvider at the root, EngineProvider keyed by ${sessionId}:${version}, hash routing #/s/<id>[/forms/demo], SessionMenu top-bar, CreateFirstSession empty state. - New DocumentRemoved event for per-document delete cleanup in CollectionList; engine.documents.remove() is the new service method. Tests: - Unit: 16 SessionService lifecycle + persistence tests; per-session snapshot round-trip; PdfByteStore + ingestPdfFromFile; SessionArchive parser; exportSessionZip + importSessionZip with create + merge + corrupt-archive paths. - DOM: UploadDropzone, session-scoped CollectionList delete, SessionMenu create/switch/rename, routing parser. - E2E: tests/integration/session-export-reimport.dom.test.tsx walks the full create → annotate → export → reimport flow and asserts the additive merge (deduped doc + doubled evidence rows). - Legacy E2Es updated to use a seed-session helper instead of the removed fixture-button flow. Known limitation (documented in ADR-0008): re-importing your own freshly-exported ZIP creates duplicate annotations. Forward pointer left for an importBundleId follow-up. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 14:57:28 +02:00
"jszip": "^3.10.1",
Implement CE-WP-0002 T01-T02: engine types + PDF viewer adapter spike T01: shared engine types (Document, Selector union, Annotation, EvidenceItem, branded IDs with newId factory) per wiki/SharedContracts.md §1-§3. T02: react-pdf-highlighter-plus v1.1.4 spike behind the §5 DocumentViewerAdapter contract in src/anchor/. Pure round-trip math extracted to pdf-selector-math.ts with 11 unit tests proving lossless capture → selectors → JSON → restored-rects. ADR-0004 accepted; full user-flow Playwright verification deferred to T09. Adds Vite app shell (index.html, src/app/SpikeApp.tsx) so the spike is exercisable via pnpm dev. tsconfig --noEmit prevents tsc -b from littering src/ with stray .js outputs. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 02:21:31 +02:00
"pdfjs-dist": "^4.4.168",
Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
"react": "^18.3.1",
Implement CE-WP-0002 T01-T02: engine types + PDF viewer adapter spike T01: shared engine types (Document, Selector union, Annotation, EvidenceItem, branded IDs with newId factory) per wiki/SharedContracts.md §1-§3. T02: react-pdf-highlighter-plus v1.1.4 spike behind the §5 DocumentViewerAdapter contract in src/anchor/. Pure round-trip math extracted to pdf-selector-math.ts with 11 unit tests proving lossless capture → selectors → JSON → restored-rects. ADR-0004 accepted; full user-flow Playwright verification deferred to T09. Adds Vite app shell (index.html, src/app/SpikeApp.tsx) so the spike is exercisable via pnpm dev. tsconfig --noEmit prevents tsc -b from littering src/ with stray .js outputs. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 02:21:31 +02:00
"react-dom": "^18.3.1",
"react-pdf-highlighter-plus": "^1.1.4"
Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
},
"devDependencies": {
Implement CE-WP-0002 T03-T09: ingest, anchor resolution, engine, UI, persistence, e2e Completes the PDF review slice end-to-end. After this commit a user can open a fixture, select text, save an evidence item with commentary, see it in the sidebar, reload the page, click the item, and the viewer scrolls to the passage. - T03 src/source/pdf/{fingerprint,extract,ingest}.ts + 39 fixture tests - SHA-256 fingerprint over a fresh ArrayBuffer (TS BufferSource-safe) - PDF.js text extract; per-page normalize then join with "\n\n" - PageMap + OffsetMap (gap-free coverage); pageLength = end - start - Updated manifest's Betriebskosten quote to one PDF.js extracts cleanly - T04 src/anchor/selectors/{create,resolve}.ts + 25 unit + 7 fixture tests - createSelectors emits the maximal redundant set (TextQuote + TextPosition + PdfRect + PdfPageText when available) - resolveSelectors implements the SharedContracts §7 ladder; confidence 1.0 (pos+quote) → 0.7 (rect-only) → 0 (unresolved) - Cross-module integration test moved to tests/integration/ to honor the anchor↛source boundary lint rule - T05 engine: sync event bus over the closed §4 vocabulary, Map-backed repos, services, createEngine() composition root, 12 tests - T06 work + app: three-pane shell (CollectionList | ViewerShell | EvidenceSidebar) wired through EngineProvider; EngineContext lives in src/work/ to respect the work↛app boundary; SpikeApp deleted - T07 AnnotationToolbar: pendingSelection in context; Save runs createSelectors → engine.annotations.create → engine.evidence.create - T08 click-to-reopen + localStorage persistence - scrollToAnnotation state in context with a version counter so a second click on the same item re-fires the viewer scroll - captureSnapshot/restoreSnapshot/attachPersister/restoreFromStorage; restore bypasses services to avoid event-loops - active-document id persisted alongside the snapshot so reload lands on the same fixture; ADR-0005 written - 9 persistence tests - T09 tests/integration/app-prd-scenario.dom.test.tsx - end-to-end happy-dom test of PRD scenario steps 1-8 through the real React tree; viewer + ingest mocked per ADR-0004's headless-Chromium limitation. Fixed memo-deps bug in EvidenceSidebar/ViewerShell where useEngineEventTick values were not included in the useMemo deps, leaving stale memoization across event-driven re-renders - vitest.config.ts: happy-dom for *.dom.test.{ts,tsx} files - noEmit added to tsconfig so tsc -b doesn't litter src/ with .js outputs Gates: typecheck ✓ lint ✓ test 109/109 across 11 files ✓ build ✓ Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 10:58:11 +02:00
"@testing-library/dom": "^10.4.1",
"@testing-library/react": "^16.3.2",
"@testing-library/user-event": "^14.6.1",
Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
"@types/node": "^20.14.0",
"@types/react": "^18.3.3",
"@types/react-dom": "^18.3.0",
"@vitejs/plugin-react": "^4.3.1",
"eslint": "^9.7.0",
"eslint-import-resolver-typescript": "^3.6.3",
"eslint-plugin-boundaries": "^4.2.2",
"eslint-plugin-import": "^2.30.0",
"globals": "^15.9.0",
Implement CE-WP-0002 T03-T09: ingest, anchor resolution, engine, UI, persistence, e2e Completes the PDF review slice end-to-end. After this commit a user can open a fixture, select text, save an evidence item with commentary, see it in the sidebar, reload the page, click the item, and the viewer scrolls to the passage. - T03 src/source/pdf/{fingerprint,extract,ingest}.ts + 39 fixture tests - SHA-256 fingerprint over a fresh ArrayBuffer (TS BufferSource-safe) - PDF.js text extract; per-page normalize then join with "\n\n" - PageMap + OffsetMap (gap-free coverage); pageLength = end - start - Updated manifest's Betriebskosten quote to one PDF.js extracts cleanly - T04 src/anchor/selectors/{create,resolve}.ts + 25 unit + 7 fixture tests - createSelectors emits the maximal redundant set (TextQuote + TextPosition + PdfRect + PdfPageText when available) - resolveSelectors implements the SharedContracts §7 ladder; confidence 1.0 (pos+quote) → 0.7 (rect-only) → 0 (unresolved) - Cross-module integration test moved to tests/integration/ to honor the anchor↛source boundary lint rule - T05 engine: sync event bus over the closed §4 vocabulary, Map-backed repos, services, createEngine() composition root, 12 tests - T06 work + app: three-pane shell (CollectionList | ViewerShell | EvidenceSidebar) wired through EngineProvider; EngineContext lives in src/work/ to respect the work↛app boundary; SpikeApp deleted - T07 AnnotationToolbar: pendingSelection in context; Save runs createSelectors → engine.annotations.create → engine.evidence.create - T08 click-to-reopen + localStorage persistence - scrollToAnnotation state in context with a version counter so a second click on the same item re-fires the viewer scroll - captureSnapshot/restoreSnapshot/attachPersister/restoreFromStorage; restore bypasses services to avoid event-loops - active-document id persisted alongside the snapshot so reload lands on the same fixture; ADR-0005 written - 9 persistence tests - T09 tests/integration/app-prd-scenario.dom.test.tsx - end-to-end happy-dom test of PRD scenario steps 1-8 through the real React tree; viewer + ingest mocked per ADR-0004's headless-Chromium limitation. Fixed memo-deps bug in EvidenceSidebar/ViewerShell where useEngineEventTick values were not included in the useMemo deps, leaving stale memoization across event-driven re-renders - vitest.config.ts: happy-dom for *.dom.test.{ts,tsx} files - noEmit added to tsconfig so tsc -b doesn't litter src/ with .js outputs Gates: typecheck ✓ lint ✓ test 109/109 across 11 files ✓ build ✓ Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 10:58:11 +02:00
"happy-dom": "^20.9.0",
Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
"typescript": "^5.5.4",
"typescript-eslint": "^8.0.0",
"vite": "^5.4.0",
Wire pdfjs cmaps + standard fonts so text layer positions correctly Strong likelihood that the "text layer is misplaced / body text not selectable" symptoms across multiple PDFs come from PDF.js falling back to substitute font metrics. Without the cmaps directory (CID character maps for non-Latin fonts) and the standard_fonts directory (Helvetica/Times/Courier metrics for unembedded standard fonts), the canvas glyphs use embedded font data while the text-layer span positions are computed from fallback metrics. The two diverge — text spans land in the wrong place, or text content can't be decoded at all, leaving the body unselectable. Both directories are now copied into the served root by vite-plugin-static-copy and passed to pdfjs.getDocument() as `cMapUrl: "/cmaps/"` + `cMapPacked: true` + `standardFontDataUrl: "/standard_fonts/"` via PdfLoader's `document` prop (which accepts a full DocumentInitParameters object). If this is the right diagnosis, the textLayer overlay should now line up with the visible glyphs on the same PDFs that were producing fragmented captures. If the body text is still unselectable, the PDF genuinely lacks a text layer for those glyphs (image-only content) and OCR would be the only path forward. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 00:38:34 +02:00
"vite-plugin-static-copy": "^2",
Implement CE-WP-0001 Foundations: TS scaffold, lint boundaries, normalize v1, fixtures T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001). T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/ mirroring the future subsystem split, with path aliases. T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency edges from wiki/DependencyMap.md §4; verified by a violating fixture. T04 Canonical normalization v1 — src/shared/text/normalize.ts with NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft hyphens (including line-break reassembly), mixed whitespace. T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/ (gitignored binaries) plus a manifest with verbatim known-good quotes and page counts, ready for CE-WP-0002 selector tests. T06 README upgrade — umbrella README points at wiki/docs/workplans and documents the dev workflow. T07 ADR-0002..0006 stubs in docs/decisions/. Toolchain end-to-end: pnpm install + lint + typecheck + test all green. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-25 00:13:03 +02:00
"vitest": "^2.0.5"
}
}
Reference in a new issue Copy permalink