chore(memory): R2 closure — L1 refusal (BDR-051), LRN-055, EVAL-021, journal, TODO, L1 verify contract

This commit is contained in:
bchanot committed 2026-10-14 21:57:19 +02:00
1 parent 8d7a56fbf8
commit f768e94c5a
6 files changed
+87 -2

No files matched your search

+6
View File
@@ -400,3 +400,9 @@ Status: active; `chore/dev-lan-access` awaiting the owner's LAN validation; R2 n
Built on review rev 2 + Annex C; plan `.claude/tasks/plans/2026-10-13-rust-r2-domain-core.md` rev 2 (3 challengers, 45 findings, 1 BLOCKER folded). Choices: (1) JSON read text → `serde_json::Value` (JSON.parse dup-key semantics) → typed; lone surrogate escape → U+FFFD pre-pass (L1, owner to confirm); (2) Zod reproduced by field helpers: `js::present` (optional: absent ok, null refused, skipped), `js::nullable` (required key), `JsInt` (any integer-valued number, JS print), hand-written patterns (no regex crate), `url` crate for `.url()`; unions = untagged enums + literal tag fields at Zod position → byte-equal with `JSON.stringify(Zod.parse(x),null,2)`; PDF label fields in engine dict order → frozen envelopes round-trip byte-equal; (3) quirks ported site by site (Map last-wins, find first-wins, JS truthiness, `??=`, malformed map entry still fails the read); (4) `SheetIndexData` minimal (positions, names, spineIds, nodeKeys as JSON `[zone,...path]`), TS `SheetIndex` = accessors only + `ops`; (5) one core call per user action; form-value observation edits (comment, severity, free text, finding removal) stay Zustand assignments (no per-keystroke wasm, D-R7); store actions answer `{ok}`, callers stop on failure; `hydrateReport` deleted; (6) runtime: sync calls, trap → poison → offline recovery from kept compiled module + pre-imported spare glue record, cap 3, per-generation sheet handles, retry clears all caches; `pkg/` shipped vs `pkg-proofs/`; BUILD_STAMP refuses stale module in tests; (7) quarantine only on content kinds, newest-only keys, source removed after successful copy, pre-rebase raw kept when unresolved > 0; editor never redirects in degraded states; (8) Home and /new read availability from the bundle, core loads at submit / import / editor; (9) import = TS byte scan (until R4) → core `archive.import` (read + rebase one call); export = core `archive.snapshot` → frozen TS engine; (10) publish gate takes the core validator (DI), fails closed; (11) report:compare CLI keeps the frozen domain (R4); practitioner prefill keeps a small Zod schema (D-R7, core not loaded on /new mount); (12) app image wasm stage + gzip_static; DEPLOY: CSP keyword before an R2 image, never built on VPS.
Alt rejected: mutation corpus with full outputs (simplicity challenge: drift-free verdict table + characterisation instead); `report.replace_observation` per keystroke; serde internally tagged enums (tag first breaks byte equality); Web Worker for every call (async races in the click chain); unify duplicate-id policies (behaviour change).
Status: active; R2 delivered on feature/rust-r2-domain-core, awaiting owner validation, no merge.
## BDR-051 | 2026-10-14 | L1 resolved: lone UTF-16 surrogate refused whole, never replaced (supersedes BDR-050 choice 1 on this point)
Owner refused U+FFFD replacement of lone surrogate escapes (silent alteration of historical user data). Chosen (owner, 2026-10-14): refusal + quarantine. `js::parse_json` no pre-pass; serde_json refuses escape like any error; failure classified by strict escape scan (on failure only) → `JsonReadError::LoneSurrogate` → closed kind `lone_surrogate` (parse_input, sheet.check, draft.restore, archive.import). App: draft → `osteo:quarantine:draft` verbatim + existing `editor.draft_quarantined`; session archive → `osteo:quarantine:archive`; import → `ImportError('lone_surrogate')` + new `home.import.error_lone_surrogate` (owner-chosen detailed wording FR/EN, file untouched); editor action → refused, report unchanged, `core.action_failed`; publish gate → `invalid_shape`. Oracles untouched: L1 cases now assert TS kept surrogate + Rust refuses; test loader spells lone escapes out as literal text (never U+FFFD).
Alt rejected: faithful preservation (own JSON reader + lossless WTF-16 string type over ~150 contract fields + serialiser, oracles re-frozen; multi-day, for corrupted/pasted-UTF-16 data only; door stays open since nothing is lost); in-band tunnel (placeholder code points mapped back at facade output; collisions with sheet strings, UTF-16 length drift, every output path must be post-processed: hacky).
Status: active; merged with R2.
+7
View File
@@ -157,3 +157,10 @@ Method: plan + contract written first (`.claude/tasks/plans/2026-10-13-rust-r2-d
Result: challengers 45 findings incl. 1 BLOCKER (degraded editor redirect could overwrite an unread draft) → plan rev 2 before any app code; contracts byte-equal to Zod on first run; forks merged with zero conflicts (one stub replaced); fork D found 2 real src bugs (Node source path under happy-dom, failed quarantine reported as success) → fixed with tests. Verifier: 12/12 MET, ECARTS(2) = floor DELETED_TEST (zoneInteraction suite ported to cargo; R0 skip helper replaced by a stricter global setup) → human micro-gate for the owner. Security: PASS (3 MEDIUM nginx false positives pre-existing, 5 LOW) → by-reference deserialisation (also −134 KB raw / −31 KB gzip module) + literal delete paths. Final: cargo core 135, worker+wasm 32, Node 906 (app 313), pgTAP PGlite 12 files / real stack 446, CSP proof 15/15, check:all green ×3, module 1,046,498 B raw / 340,929 B gzip.
Anomalies: worktree base stale (BLK-010); harness decodes `\u` escapes in tool inputs (LRN-054); my first runtime test helper reused the pattern Vite rewrites; the CSP proof first failed on its own harness (EN locale, disclaimer modal, caught compile error logs nothing) — proof scripts need the same dry-run discipline as oracles; a security LOW fix improved size, measure before assuming a cost.
Action: owner manual LAN validation, L1 decision, approve the 2 deleted test files (floor), then merge go; R3 next, not started.
## EVAL-021 | 2026-10-14 | R2 closure — L1 refusal, deletions proof, fresh verifier + security
Method: owner asked to fix L1 (no silent U+FFFD) + prove the 2 approved deletions + checks before merge. Mapped every JSON entry into the core (TS side always `JSON.stringify` → escapes reach Rust as ASCII); preservation costed (own JSON reader + lossless string type ~150 fields) → AskUserQuestion: refusal + quarantine chosen, detailed import wording chosen. Stale-module proof run before `wasm:build` (suites throw `pkg is stale`). Worktrees checked blob by blob vs branch history (60/66 identical, 6 = stub, merged mod lists, 2 lifted `#[ignore]`). Contract `2026-10-14-rust-r2-l1-verify.md` (13 criteria, each dry-run) → fresh verifier; fresh security-auditor on 36316cf..HEAD.
Result: verifier CONFORME 13/13 (floor 2 = the approved deletions, authorised by REQUEST); security PASS, 6 LOW: wasm-bindgen `&str` would re-encode a raw lone surrogate (unreachable, JSON.stringify callers; documented invariant), `pretty_json` proof op refuses as invalid_json, scanner not string-aware (classification only), newest-only quarantine slot, archive quarantine failure under full storage lets a later reset remove it (pre-existing R2, reported to owner), semgrep partial parse. Final: core 142, Node 915 (app 320, supabase 40, core-wasm 26), PGlite pgTAP 12 files, real stack 446/446, types no drift, check:all green 1 min 32 s, module 1,040,784 B raw / 339,933 B gzip.
Anomalies: refusal broke a test loader (oracle file freezes TS outputs with lone escapes) → loader spells escapes out, never normalises (LRN-055); `cargo deny advisories` (warn-only) shows RUSTSEC-2026-0346/0347/0348 on rustls 0.23.45 (worker, none applicable: no brotli, built-in session cache, no ECH) → bump follow-up; `supabase/.temp/cli-latest` tracked by mistake, rewritten by the CLI, restored; `export PATH=…` denied → absolute `~/.cargo/bin/cargo`; first commit with chained `git config` denied → plain commit OK.
Action: gitflow finish into develop (owner authorised after L1 + checks), worktree cleanup (BLK-010), R3 summary only.
+4
View File
@@ -251,3 +251,7 @@ Owner: R1 10/10 validated, identity final (Faunosteo, faunosteo.com), env DEV/ST
## 2026-10-14 (Rust R2 delivered)
Owner: LAN validated, R2 go (brief 2026-10-13), 4 new strings validated (recommended wording). feature/rust-r2-domain-core off develop 1a7ee7d. Plan + 3 challengers (45 findings, 1 blocker) → rev 2. Freeze first (envelopes, N-1 copy, Zod oracles, characterisation 84 + verdicts 765 + editor 49 + conformance 26), contracts byte-equal, rules by 3 worktree forks, runtime (lazy, poison, offline recovery, BUILD_STAMP), app switched (sheet, store, click chain, pickers, import, export snapshot, publish gate fail-closed), quarantine, degraded states, Docker wasm stage + gzip_static, CSP proof on the image 15/15. Verifier 12/12 + floor 2 (deleted tests, owner micro-gate); security PASS → by-ref deserialisation (module 341 KB gzip). check:all green. BDR-050, LRN-054, BLK-010, EVAL-020. Stop: owner validation, no merge, R3 not started, release 0.2.0 untouched.
## 2026-10-14 (R2 closure)
Owner: manual 10/10 validated, R2 accepted (architecture, migrations, contracts, perf); L1 refused (silent U+FFFD). Costed preservation (own JSON reader + lossless string type) → owner chose refusal + quarantine, detailed import wording. Fixed: core refuses lone surrogate as `lone_surrogate` (draft/archive quarantined verbatim, import refused with message, action refused, gate invalid_shape). Deletions proven covered (12+1 Rust tests + 49 oracle cases; stale module fails suites). Worktrees verified recoverable-free. Gates: verifier CONFORME 13/13, security PASS 6 LOW; check:all green. BDR-051, LRN-055, EVAL-021. Next: finish into develop, worktree cleanup, R3 summary (not started).
+5
View File
@@ -421,3 +421,8 @@ Apply: any exposure work on this machine; staging compose (bind explicitly there
- `isolation: worktree` forks started at an old commit (605ee7c, not HEAD): each fork had to move its temp branch; brief forks to check `git log -1` first. `git worktree remove` / `git branch -d` on those temp branches refused by the auto-mode classifier → leftover worktrees (3.2 GB) for the owner to remove.
- Forks with full context + disjoint file ownership + "no commit, I collect the diff" merged with zero conflicts (one deliberate stub replaced).
Apply: R3/R4/R5 ports (same oracle stack), any wasm loaded by Vite, any agent fan-out.
## LRN-055 | 2026-10-14 | Lossy normalisation pre-pass hides user-data alteration; classify parser refusal instead
Context: R2 rewrote lone surrogate escapes to U+FFFD before serde_json so JS-era texts still parsed (L1). Owner refused: silent change of historical data. Fix: drop pre-pass; serde_json already refuses; scan text only after failure to name kind (zero cost on valid input, exact refusal kind for UI message + quarantine). Trap found by fix: oracle file freezing TS outputs carried lone escapes → whole-file parse failed; test loader must spell escapes out as literal text (evidence kept), never re-normalise. Also: `u32::from_str_radix` accepts leading `+` → escape scanner checks hex digits explicitly.
Apply: any reader of user data (R3 SVG, R4 PDF reader, R5 pipeline) → refuse with closed kind + keep original, never repair silently; a leniency step needs explicit owner decision and declared-difference test.
+8 -2
View File
@@ -174,8 +174,14 @@ feat/findings-tree-v2 merged (FindingsTreePicker tracked in HEAD); all work belo
- [x] R2.5 app switch (74fcb37) + publish gate fail-closed (6891f9e); app 313/313 on the real core (fork D adapted 17 files, 24 new tests, found 2 src bugs fixed)
- [x] R2.6 image + serving (7be94d4): wasm stage, gzip_static 372 KB served, CSP proof on the image 15/15 (Chromium only; no Firefox/WebKit build here), check:all green 2 min 17 s
- [x] R2.7 docs (8e8c58e: RUST.md §8, CLAUDE.md, WORKSPACE, TEST_STRATEGY, packages/README, DEPLOY, CHANGELOG), verifier 12/12 + floor ECARTS(2) (deleted tests, owner micro-gate), security PASS ×2 (follow-ups e49009e), memory BDR-050 LRN-054 BLK-010 EVAL-020; STOP (no merge)
- [ ] R2 owner points: manual LAN validation (procedure in the delivery note), L1 decision (lone surrogate → U+FFFD), approve the 2 deleted test files (floor), worktree cleanup (BLK-010), then merge go
- [ ] R2 follow-ups: Firefox/WebKit CSP run (no browser build here), import in a Web Worker (R4), React error boundary (not decided), base images by digest (Step 27), wording of the storage-full degraded notice
- [x] R2 owner points (2026-10-14): manual LAN validation 10/10 + graphics accepted; L1 decided (refusal + quarantine, BDR-051); 2 deleted test files approved (coverage proven); worktree cleanup authorised after checks; merge go after L1
- [x] R2 closure (owner brief 2026-10-14)
- [x] L1.1 core: `parse_json` never rewrites; refusal classified (`JsonReadError::LoneSurrogate`, strict hex scan, on failure only); kind `lone_surrogate` from parse_input, sheet.check, draft.restore, archive.import (20d03cf)
- [x] L1.2 app: quarantine on `lone_surrogate`, `ImportError('lone_surrogate')` + `home.import.error_lone_surrogate` FR/EN (detailed wording), publish gate → `invalid_shape` (da8a037); dead `isCoreBuilt` removed (5020954)
- [x] L1.3 tests: js scanner/parse, session draft/archive/import + normal text, facade kind, characterisation L1 + Zod verdict = explicit refusal (oracles untouched, loader spells escapes out), store quarantine verbatim, editor action refused report unchanged, import kind, real-module call, gate
- [x] L1.4 checks: rust:check, stale-module refusal shown, wasm:build, Node 915, PGlite 12 files, real stack 446/446, types no drift, check:all green; verifier CONFORME 13/13, security PASS (6 LOW)
- [x] L1.5 docs (RUST.md 8.6/8.7, PDF-FORMAT, CHANGELOG) + memory BDR-051, LRN-055, EVAL-021, journal
- [ ] R2 follow-ups: Firefox/WebKit CSP run (no browser build here; owner's manual LAN run covers its browsers), import in a Web Worker + PDF import hardening gate (R4, PDF_IMPORT_HARDENING.md §5), React error boundary (not decided), base images by digest (Step 27), wording of the storage-full degraded notice, CSP refuses the footer's external credit logo (RUST.md 8.8), no CI/CD runner on the forge (workflows prepared, never executed), rustls 0.23.45 advisories RUSTSEC-2026-0346/0347/0348 (worker; not applicable: no brotli, built-in session cache, no ECH) → `cargo update -p rustls` ≥ 0.23.46 + worker:test + e2e:avatar, unreadable session archive under full storage removed by a later reset (security LOW, decision needed), `supabase/.temp/cli-latest` tracked by mistake (untrack + ignore), wasm-bindgen boundary invariant (JSON.stringify callers only, RUST.md 8.7)
- [ ] R3 anatomy core: tree, one sanitiser, serialiser, layer renderer, `compose_view_svg`; app canvas switched; composed views frozen as trees first
- [ ] R4 pdf core: reader (Web Worker, BLK-009 browser measurements) + writer (`pdf-writer`, Std14 AFM, draw log; lines/rects/colours golden frozen with the TS engine first, D-R2) + `report-compare` tool; `packages/pdf` deleted; N-1 scanner reads R4 PDFs
- [ ] R5 curation pipeline + importer + upload tool: seed golden regenerated once (new `documentSha256`, D-R5), `packages/anatomy` + `packages/domain` deleted, docs map; all before Step 13
@@ -0,0 +1,57 @@
# CONTRACT — R2 closure: L1 lone UTF-16 surrogates refused, never replaced
- date: 2026-10-14 | flow: ad-hoc fix on the R2 branch, verifier gate | branch: feature/rust-r2-domain-core
- status: dispatched after the code, test and doc commits
- spec: owner brief 2026-10-14 §2 (L1) + §3 (deletions) + answers: approach = refusal + quarantine (not preservation), import message = detailed wording; BDR-051 in `.claude/memory/decisions.md`; `docs/development/RUST.md` §8.7 item 1
- diff range: 36316cf..HEAD (run every CHECK from the repository root; `. scripts/rust-env.sh` first for cargo)
## REQUEST (IMMUTABLE)
Do not accept the silent transformation of an isolated UTF-16 surrogate into U+FFFD when historical data is read. Preserve user data integrity strictly: faithful preservation where possible, otherwise controlled refusal or quarantine of the data concerned, with the original content kept and an explicit message. Never delete or silently transform unreadable historical data. Add the non-regression tests needed, covering JSON strings with a lone surrogate and normal data. (Owner chose refusal + quarantine; preservation would need an architecture change.) Also approved: deletion of the old `zoneInteraction` suite and of the helper that skipped tests without the wasm module, provided the behaviours stay covered and the checks fail when an essential Rust feature becomes unavailable; no oracle needed by R3/R4 removed. No GUI change, no deploy.
## ACCEPTANCE CRITERIA
1. No replacement of lone surrogates remains anywhere in the code.
CHECK: grep -rn "replace_lone_surrogates" crates packages apps --include=*.rs --include=*.ts | wc -l; grep -c 'push_str("\\\\uFFFD")' crates/core/src/domain/js.rs
EXPECT: 0 / 0
2. The native Rust gate is green.
CHECK: bash scripts/rust-check.sh > /tmp/l1-verify-rust.log 2>&1; echo "exit $?"
EXPECT: exit 0
3. The core carries at least 142 passing tests, none failing.
CHECK: . scripts/rust-env.sh && cargo test -p faunosteo-core 2>&1 | grep "test result" | awk '{s+=$4; f+=$6} END {print s, f}'
EXPECT: first number ≥ 142, second 0
4. Every core entry that reads JSON text names the refusal `lone_surrogate` (operation inputs and sheet.check through the `From<JsonReadError>` impl, draft restore and archive import through their own variants).
CHECK: grep -c '"lone_surrogate"' crates/core/src/ops.rs crates/core/src/facade.rs; grep -c "LoneSurrogate" crates/core/src/domain/session.rs
EXPECT: ops.rs:2 facade.rs:2 / 4
5. The application treats the kind as unreadable draft content (quarantine), maps it on import to its own error and message in both dictionaries, and the publish gate reads it as content.
CHECK: grep -c "'lone_surrogate'" apps/app/src/state/reportStore.ts apps/app/src/pdf/import.ts apps/app/src/app/routes/HomeRoute.tsx packages/supabase/src/anatomical-sheets.ts; printf "%s/%s\n" $(grep -c "'home.import.error_lone_surrogate'" apps/app/src/i18n/fr.ts) $(grep -c "'home.import.error_lone_surrogate'" apps/app/src/i18n/en.ts)
EXPECT: reportStore.ts:1 import.ts:3 HomeRoute.tsx:1 anatomical-sheets.ts:1 / 1/1
6. The Node suites pass on the rebuilt module, with the new cases (app 320, supabase 40, core-wasm 26, domain 262).
CHECK: bash scripts/wasm-build.sh > /dev/null 2>&1; for p in app supabase core-wasm domain; do ./node_modules/.bin/pnpm --filter @faunosteo/$p exec vitest run 2>&1 | grep -E "^ +Tests "; done
EXPECT: Tests 320 passed (320) / Tests 40 passed (40) / Tests 26 passed (26) / Tests 262 passed (262)
7. No oracle, frozen fixture, N-1 copy, golden or seed file changed in the range.
CHECK: git diff --stat 36316cf..HEAD -- crates/core/tests/oracles apps/app/tests/fixtures packages/domain/tests/fixtures packages/core-wasm/tests/n-1 supabase/seed packages/pdf/tests packages/anatomy/tests | wc -l
EXPECT: 0
8. The tests cover a lone surrogate (high, low, in a key, in a v2 and a v3 report, in a draft, an archive, an attachment, an operation input, a sheet document) and normal data (pairs, literal backslash-u text, a genuine U+FFFD) and assert the original text is kept.
CHECK: grep -cE "fn (a_draft_with_a_lone|an_archive_with_a_lone|an_attachment_with_a_lone|normal_text_with_pairs)" crates/core/tests/archive_rules.rs; grep -cE "fn (lone_surrogate_escapes_are_found|a_lone_surrogate_refuses|normal_text_reads_unchanged)" crates/core/src/domain/js.rs; grep -c "lone surrogate" apps/app/tests/unit/state.quarantine.test.ts apps/app/tests/unit/pdf.import.test.ts packages/supabase/tests/anatomical-sheets.test.ts packages/core-wasm/tests/facade.test.ts
EXPECT: 4 / 3 / each file ≥ 1
9. A missing or stale wasm module fails the suites instead of skipping them, and no core suite is conditionally skipped.
CHECK: grep -c "stale' : 'missing'" packages/core-wasm/tests/global-setup.ts; grep -l "core-wasm/tests/global-setup.ts" apps/app/vitest.config.ts packages/supabase/vitest.config.ts packages/core-wasm/vitest.config.ts | wc -l; grep -rn "skipIf\|runIf\|isCoreBuilt" apps/app/tests packages/core-wasm/tests packages/core-wasm/src packages/supabase/tests --include=*.ts | grep -v "e2e/" | wc -l
EXPECT: 1 / 2 (core-wasm references it as `tests/global-setup.ts`) / 0
10. The deleted TypeScript editor cases keep a same-named Rust test each.
CHECK: for n in opens_the_detail_view_for_the_trigger_even_without_an_active_observation only_activates_a_fallback_observation_when_none_is_active always_opens_the_vertebra_picker_on_a_spine_zone routes_bilateral_zones_through_the_side_picker_or_clears_both_sides toggle_zone_adds_a_zone_with_snapshots_then_removes_it ensure_zone_keeps_an_existing_zone_and_reports_its_index add_sides_appends_only_the_missing_sides_and_never_removes_one remove_zone_at_removes_one_zone_by_index_and_keeps_findings detail_view_zones_are_distinct_from_main_view_zones_with_the_same_id collects_vertebrae_across_spine_zones_the_priority_zone_first replaces_per_region_prunes_emptied_zones_and_spawns_zones_for_new_regions keeps_non_spine_zones_untouched_and_ignores_unknown_regions; do grep -c "fn $n" crates/core/tests/editor_rules.rs; done | sort | uniq -c
EXPECT: 12 1
11. No interface component, style or signed-in screen changed; HomeRoute gains only the two lines of the new case.
CHECK: git diff --stat 36316cf..HEAD -- apps/app/src/components apps/app/src/styles apps/app/src/app/routes/app apps/app/src/app/routes/auth | wc -l; git diff 36316cf..HEAD -- apps/app/src/app/routes/HomeRoute.tsx | grep -c "^[+-][^+-]"
EXPECT: 0 / 2
12. Documentation states the owner's decision and the refusal paths.
CHECK: grep -c "owner decision 2026-10-14, BDR-051" docs/development/RUST.md; grep -c "Lone UTF-16 surrogates refused, never altered" CHANGELOG.md; grep -c "lone_surrogate" docs/PDF-FORMAT.md
EXPECT: 1 / 1 / 1
13. The whole pre-merge gate passes.
CHECK: bash scripts/check-all.sh > /tmp/l1-verify-all.log 2>&1; echo "exit $?"; grep -c "== all checks passed" /tmp/l1-verify-all.log
EXPECT: exit 0 / 1
## CLARIFICATIONS
- The editor test list has 13 TypeScript cases; "toggles plain zones; the ten bilateral annotations and the 18 others split as the sheet says" maps to `toggles_plain_zones_and_splits_the_observable_annotations_as_the_sheet_says` (renamed: 28 is not the draft's count), hence 12 exact names in criterion 10.
- `crates/core/tests/common/mod.rs::oracle_file` writes each lone escape of an oracle file out as literal text for the test loader only: the oracle files are frozen TypeScript evidence, not user data, and their raw text is still what the L1 test reads.
- The RustSec advisories stage of `check-all.sh` is warn-only by design (RUST.md); its rustls findings predate this range.
## FILE SCOPE
crates/core/**, packages/domain/tests/r2-characterisation.test.ts, apps/app/src/{app/routes/HomeRoute.tsx,core/sheetOps.ts,i18n/fr.ts,i18n/en.ts,pdf/import.ts,state/reportStore.ts}, apps/app/tests/unit/{state.quarantine.test.ts,pdf.import.test.ts,routes.HomeRoute.import.test.tsx}, packages/supabase/src/anatomical-sheets.ts, packages/supabase/tests/anatomical-sheets.test.ts, packages/core-wasm/src/node.ts, packages/core-wasm/tests/facade.test.ts, docs/development/RUST.md, docs/PDF-FORMAT.md, CHANGELOG.md, .claude/tasks/**, .claude/memory/**