Stable Asura series IDs: strip rotating build hash #6

2026-07-28T07:14:23+07:00

sulthan commented

2026-07-28 07:14:23 +07:00

Asura series slugs carry a site-wide build hash (-059befe1) that rotates on every redeploy, silently orphaning all asura bookmarks (old-hash URLs 302 to new-hash ones, so detect() yields keys that never match stored rows).

Backend:

migrateAsuraKeys in OpenStore: one-off idempotent migration rewriting hashed asura keys to the stable hashless ID, merging collisions to newest updated_at; losers deleted before winner rewrite (PK-collision safe) — regression tests included
poller latestChapterFrom: build hash made optional in chapter-scoping regex so latest_chapter survives redeploys

Userscript:

stripBuildHash(/-[0-9a-f]{8}$/) applied to seriesId in both asura detect branches; URLs keep full slug (stale hashes 302)
load-time migration rewrites cached + retry-queued asura keys to the stripped form so a queued PUT cannot resurrect an orphaned row

Docs: AGENTS.md + CLAUDE.md URL-shape notes; design spec at docs/superpowers/specs/2026-07-28-asura-stable-series-id-design.md

Verified: go test -count=1 ./... green (new rotation + collision tests), node --check green, regex verified against live asurascans.com slugs.

Deploy order: backend first (migration runs at OpenStore). Orphan rows created by not-yet-updated userscripts self-heal on next backend restart.

Asura series slugs carry a site-wide build hash (-059befe1) that rotates on every redeploy, silently orphaning all asura bookmarks (old-hash URLs 302 to new-hash ones, so detect() yields keys that never match stored rows). Backend: - migrateAsuraKeys in OpenStore: one-off idempotent migration rewriting hashed asura keys to the stable hashless ID, merging collisions to newest updated_at; losers deleted before winner rewrite (PK-collision safe) — regression tests included - poller latestChapterFrom: build hash made optional in chapter-scoping regex so latest_chapter survives redeploys Userscript: - stripBuildHash(/-[0-9a-f]{8}$/) applied to seriesId in both asura detect branches; URLs keep full slug (stale hashes 302) - load-time migration rewrites cached + retry-queued asura keys to the stripped form so a queued PUT cannot resurrect an orphaned row Docs: AGENTS.md + CLAUDE.md URL-shape notes; design spec at docs/superpowers/specs/2026-07-28-asura-stable-series-id-design.md Verified: go test -count=1 ./... green (new rotation + collision tests), node --check green, regex verified against live asurascans.com slugs. Deploy order: backend first (migration runs at OpenStore). Orphan rows created by not-yet-updated userscripts self-heal on next backend restart.

sulthan added 7 commits 2026-07-28 07:14:24 +07:00

fix(backend): strip rotating Asura build hash from bookmark keys d602b67b84

fix(backend): delete migration losers before winner rewrite 712cd6bece

fix(userscript): strip Asura build hash from seriesId 3a2210b9c8

fix(userscript): migrate cached and queued Asura keys on load 4d94d438ab

docs: Asura build-hash slug rotation spec + URL shape notes 1a0c832d8d

fix(backend): strip build hash in poller chapter scoping ba6303784a

docs: sync CLAUDE.md URL shapes with AGENTS.md 2f00e452ff

sulthan merged commit 206c447f36 into main

2026-07-28 07:21:11 +07:00

sulthan deleted branch fix/tracked-manga-undetected/opencode

2026-07-31 01:02:07 +07:00