docs(04): commit plan-revision residue + 04-01 SUMMARY

This commit is contained in:
araharah-executor
2026-10-24 00:39:32 +08:00
parent 8b6ad2047f
commit 2e724cbee1
3 changed files with 23 additions and 3 deletions
@@ -4,6 +4,25 @@
**Files analyzed:** 30 new/modified surfaces (grouped into 18 rows below)
**Analogs found:** 16 / 18 rows matched (2 rows are genuinely new: repo-level LICENSE + ODbL data notice)
> **PATH RECONCILIATION (2026-10-23, plan-phase revision).** This map was written BEFORE the
> phase plans fixed the file layout. The ANALOGS below are all still correct and are cited by
> the plans; only the NAMES of the new files changed. The plans are authoritative. Mapping:
>
> | Pre-planning path in this map | Realized path (per plans 04-01…04-04) |
> |---|---|
> | `shared/` workspace pkg | the `search/` workspace pkg (`@araharah/search`) |
> | `shared/src/types.ts` / `rules.ts` / `normalize.ts` / `distance.ts` / `score.ts` | `search/src/types.ts` / `rules/abbreviations.ts` / `normalize.ts` / `distance.ts` / `score.ts` |
> | `bot/src/search/source.ts` (SearchSource impl) | `search/src/source.ts` (+ `search/src/gazetteer.ts` loader, `search/src/index.ts` public API) |
> | `shared/data/kl-gazetteer.json` | `search/src/data/kl-gazetteer.json` |
> | `shared/data/golden-corpus.json` | `search/test/fixtures/golden-corpus.json` |
> | `shared/data/NOTICE.md` (ODbL) | `LICENSES.md` (repo root) |
> | `bot/scripts/gazetteer-topup.mjs` | `search/scripts/overpass-topup.mjs` |
> | `bot/scripts/gazetteer-corpus.mjs` | `search/scripts/gazetteer-corpus.mjs` |
> | `bot/scripts/gazetteer-to-sqlite.mjs` | `search/scripts/json-to-sqlite.mjs` |
> | `web/src/search/destination.ts` | `web/src/search/resolve-destination.ts` (+ `web/src/search/destination-card.ts`) |
> | `web/src/pwa/homescreen.ts` | `web/src/telegram/homescreen.ts` |
> | `web/test/destination.test.mjs` | `web/test/destination-preload.test.mjs` |
## File Classification
| New/Modified File | Role | Data Flow | Closest Analog | Match Quality |