docs: split CLAUDE.md into per-directory guidance #14

2026-08-04T19:53:13+07:00

sulthan commented

2026-08-04 19:53:13 +07:00

Split monolithic CLAUDE.md into root + backend/CLAUDE.md + userscript/CLAUDE.md, add .opencode/agent configs.

sulthan added 18 commits 2026-08-04 19:53:14 +07:00

Move userscript to Violentmonkey, sync docs to shipped Cinder design e250762ea6

CLAUDE.md: swap Bromite for Violentmonkey throughout, add installed
golang skills to relevant skills, add comment-writing rules, add a
design-system pointer rule. docs/design-system.md: rewrite against
the current Claude Design project and the tokens/components already
shipped in backend/static/style.css (danger/slate/moss/clay/trash,
action key, brand mark).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Split backend into internal packages by responsibility eeb601cbe2

All Go files lived flat in backend/ as one package main. Move store,
latest-chapter polling, sessions, HTTP middleware, the JSON API, the
userscript handler, and the web UI (with its templates/static assets)
into backend/internal/{store,latest,session,httpmw,api,userscript,web},
each with an exported API. main.go becomes the composition root wiring
them into newRouter; root-level tests cover the assembled router while
package-local tests cover unit behavior. Update Dockerfile/.dockerignore
for the new internal/ tree and CLAUDE.md to describe the layout.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

feat(userscript): add comix.to site adapter e392ec3de0

Add test coverage for comix coverFromPage() 78eaecb119

Extend the test harness's document stub with a querySelectorAll("img[alt]")
fake (module-level pageImages fixture, mirroring metaTags), then assert on
p.cover for a matching alt and for no match. Previously the guard in
coverFromPage() always short-circuited under test since querySelectorAll
didn't exist on the stub, so the alt-matching loop had zero coverage.

refactor(userscript): thread seriesId through latest-chapter scan b96caf13e6

feat(userscript): add kagane.to site adapter a5c5e11c21

feat(userscript): refresh kagane latest chapters through its API 076e8bb5d8

feat(userscript): match comix and kagane, add panel chips 48c2d57d7e

feat(latest): parse comix SSR state and kagane API for latest chapter 2fcf882c49

feat(latest): allow comix and kagane, route kagane to a browser fetcher 89eaef70d4

feat(latest): add chromedp browser fetcher for challenge-gated sites 1d9b1200bb

feat: wire headless-shell sidecar for challenge-gated polling 2c7b4952f3

Also bumps backend/Dockerfile's build stage to golang:1.26-alpine —
chromedp v0.16.0 and cdproto both require go 1.26, and the pinned
1.24-alpine base no longer builds the module.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

fix: scope headless-shell to a dedicated network, off the Traefik proxy network 3adbfb7ad9

Prod override put headless-shell on the externally-managed `proxy`
network so manga-api (confined there for Traefik routing) could still
resolve it. That reopened CDP (port 9222, raw remote code execution)
to every other container on that shared network, not just manga-api.

Give both services a project-private `browser` network (defined in
the base compose file, not `internal: true` since headless Chrome
needs outbound access to kagane.to). manga-api joins both `proxy` and
`browser` in the prod override; headless-shell never touches `proxy`.

feat(web): add comix and kagane site colours 877d3df010

fix: address issues found in end-to-end verification ba23411a74

Chained defects made the kagane browser-fetch path completely non-functional
in Docker Compose: headless-shell's compose command re-declared
--remote-debugging-port, colliding with the image's own entrypoint/socat
proxy (EOF on every dial); the sidecar was then only reachable by Docker DNS
name, which Chrome's DevTools HTTP handler rejects with a 500
(Host-header/DNS-rebinding check); and NewBrowserFetcher's NoModifyURL option
skipped /json/version discovery entirely, dialing a bare host:port that
Chrome 404s since /devtools/browser/<uuid> is minted fresh per Chrome start.
Fixed by trimming the redundant command flags, pinning headless-shell to a
static IP so BROWSER_WS_URL can name it directly, and removing NoModifyURL so
chromedp's discovery (which echoes the request's Host back into
webSocketDebuggerUrl) does the right thing on its own.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

fix: extend CORS origins to comix and kagane, preserve progress on unparseable chapters d8c6074559

- .env.example, DEPLOY.md, docker-compose.yml: add comix.to/kagane.to to
  ALLOWED_ORIGINS so the userscript isn't CORS-blocked on either new site
- .env.example: comment out BROWSER_WS_URL's DNS-name default, which
  overrides the working compose default and 500s Chrome's DevTools handler
- userscript: updateToCurrentChapter() now falls back to the stored
  chapter/label when chapterNum is unparseable, instead of wiping progress
  (kagane's og:title lacks a number when a chapter has no episode suffix)
- README.md: document comix/kagane in the config table, adapter reference,
  and key examples

docs: sync AGENTS.md to current architecture (internal/, Cinder, confirm-gated, edge-tab) 0725b11275

Captures what shipped on the branch:
- backend split into internal/ packages; composition root = main.go
- web UI go:embed now lives under internal/web/; Dockerfile must copy tree
- impeccable detector caveat (root-absolute /static/ paths) and false-clean
- confirm-row pattern for archive/finish/remove; --ember reserved
- edge-tab hitbox design (7x44 visible, 28x72 hit, touch-action + arm hold)
- Cinder design system section + ember-law reference

docs: split CLAUDE.md into per-directory guidance, add opencode agents 4ee0b0f092

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

sulthan added 1 commit 2026-08-04 19:55:27 +07:00

Merge remote-tracking branch 'origin/main' into docs/split-claude-md 7a4afcc73e

# Conflicts:
#	CLAUDE.md

sulthan merged commit c445762244 into main

2026-08-04 20:35:17 +07:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: sulthan/mangaBookmark#14