docs: remove the finished plan 003 (the spec is the record)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
d16bdf7545
commit
6e97e95ce9
@@ -1,47 +0,0 @@
|
||||
# Tapas source — implementation plan
|
||||
|
||||
> **For agentic workers:** superpowers:executing-plans (native, the user's standing choice). Checkbox steps.
|
||||
|
||||
**Goal:** a `tapas` Source (comics and novels) registered next to `webtoons`.
|
||||
**Architecture:** `src/core/sources/tapas/{urls,parse,index}.ts` mirroring `webtoons/`; one registry line; host
|
||||
lists; source-neutral copy. **Spec:** [`docs/specs/003-tapas.md`](../specs/003-tapas.md).
|
||||
|
||||
## Global constraints
|
||||
- `src/core` pure (no DOM/Bun/node/GM). Tests offline, fixtures captured (done: `test/fixtures/tapas/*`,
|
||||
`test/fixtures/wayback/tapas-villains-*`). No new dependencies.
|
||||
|
||||
## Review focus
|
||||
1. Wayback rows for `<slug>-novel` must not count as the comic. → Task 1 same-series test, Task 3 history test.
|
||||
2. Age-gated series must not fail the run. → Task 3 test.
|
||||
3. CloudFront URLs from 2020 normalise to `us-a.tapas.io` without the size suffix. → Task 1 test.
|
||||
4. Episode links resolve to the series. → Task 3 test.
|
||||
5. Capitalised/underscored slugs (`RU_Screwed`) parse. → Task 1 test.
|
||||
|
||||
### Task 1: URLs (`tapas/urls.ts`)
|
||||
**Produces:** `TAPAS_HOSTS`, `IMAGE_HOST = "us-a.tapas.io"`, `IMAGE_HOSTS`, `parseTapasUrl(url): TapasRef`
|
||||
(`{ kind: "series", key: string /* slug or id */ } | { kind: "episode", id: string }`), `isTapasUrl(url)`,
|
||||
`infoUrl(key)`, `normalizeImageUrl(raw)`, `isSameTapasSeries(linkUrl, slug, id)`, `slugOf(canonicalUrl)`.
|
||||
- [x] Tests: every link form; non-series paths rejected (`/comics`, `/series/`); normalisation (cloudfront → us-a,
|
||||
`_z`/`_m` dropped, query dropped, other hosts untouched); same-series by slug (case-insensitive, `/info`,
|
||||
trailing slash), by id, `-novel` rejected. RED → implement → GREEN → commit.
|
||||
|
||||
### Task 2: Parsing (`tapas/parse.ts`)
|
||||
**Produces:** `parseInfoPage(html, pageUrl): { id, title, canonicalUrl, novel, covers }`, `extractCovers(html,
|
||||
pageUrl)`, `episodeSeriesId(html)`, `ageGateTarget(html): string | null`.
|
||||
- [x] Tests on fixtures: comic (id 186414, title, not novel, poster 960×1440 URL, banner), novel (266599, novel),
|
||||
2020 archive (cloudfront poster + banner normalised), reader page (`seriesId` 186414), age check (`from` URL).
|
||||
RED → implement → GREEN → commit.
|
||||
|
||||
### Task 3: Source (`tapas/index.ts`) and registry
|
||||
- [x] Tests through `FakeTransport`: info link; `/series/<id>` (fake redirect = info page served for id URL);
|
||||
episode link (two fetches); age check (mature, no covers, warning via a `SourceSeries` flag read by the
|
||||
pipeline → add `ageGated` flag and pipeline warning); Wayback history over the CDX fixture keeps only the
|
||||
comic rows. Register in `SOURCES`; hosts. RED → implement → GREEN → commit.
|
||||
|
||||
### Task 4: Copy, userscript @connect, docs
|
||||
- [x] Link hint, "No rehosting" warning, userscript description/@connect (+ gm test), README sources section,
|
||||
ARCHITECTURE map, DECISIONS entry. Commit.
|
||||
|
||||
### Task 5: Verify
|
||||
- [x] Real run in headless Chrome: comic and novel (no Wayback), and one with Wayback every 12 months; final
|
||||
review; remove this plan; merge; push.
|
||||
Reference in New Issue
Block a user