docs(fs-http): surface Doctrine #8 timeout contract; collapse README duplication

[Goosterhof]

Summary

Surfaces the Doctrine #8 library-author extension (war-room CLAUDE.md, 2026-04-22) timeout contract on the canonical ally-facing docs page at packages.script.nl/packages/http, and collapses the README/docs duplication that was the structural drift hazard.

PR #60 (fs-http 0.1.3 → 0.2.0, merged 2026-04-30) shipped the timeout surface in code and documented it in packages/http/README.md — but docs/packages/http.md (the human-facing canonical reference) carried zero coverage of the contract. Convergent finding from Cartographer M2 + Warden M2 in the 2026-05-04 staleness wave.

Scope (docs-only — no code changes)

• docs/packages/http.md (+61 / -7):
  • New ## Timeout section between ## Configuration and ## Middleware quoting the doctrine extension verbatim and showing default / service-wide override / opt-out / per-request override / DEFAULT_TIMEOUT_MS barrel export.
  • ## Configuration code block gains a timeout line.
  • ## API Reference createHttpService table gains an options.timeout row plus a new ### Constants sub-section listing DEFAULT_TIMEOUT_MS.
• packages/http/README.md (+1 / -25): Full ### Timeout block replaced with a one-line pointer to the docs site. Eliminates the duplication so the next surface change updates one source of truth.

Out of scope (filed for separate deployments)

• fs-http 0.3.0 migration docs (download / preview reshape, triggerDownload migration partner) — separate pre-staging deployment, lands with or after PR feat(fs-http)!: remove DOM coupling from download/preview (0.3.0) — closes #59 #62.
• Peer-dep version sweep across 7 docs pages — Armorer queue candidate (>7-file shared-pattern threshold for build-time generator).
• Cross-package markdown links on adapter-store / loading / theme docs pages — separate small task.
• 5 M1 Detonation Points (Time-to-First-Import progress callout / Decision Trees / Troubleshooting / Vue badges / Showcase) — backlog carry.

Verification

$ grep -cE "(timeout|DEFAULT_TIMEOUT_MS|Doctrine #8)" docs/packages/http.md
16

$ wc -l packages/http/README.md
68 packages/http/README.md   # was 92 pre-deployment (-24)

$ grep -c "Doctrine #8" packages/http/README.md
1                            # was 2 pre-deployment

$ grep "packages.script.nl/packages/http#timeout" packages/http/README.md
[the new pointer paragraph]  # 1 match

$ npm run build
[all 10 packages built clean]

Refs

• Campaign report: campaigns/fs-packages/2026-05-04-cartographer-warden-staleness-wave.md
• Doctrine source: war-room CLAUDE.md ## Architectural Principles §8 (library-author extension, 2026-04-22)
• Closing implementation: PR feat(fs-http): timeout option with 30000ms default (Doctrine #8 library-author extension) #60 (armorer/fs-http-timeout-surface, merged 2026-04-30)

[cloudflare-workers-and-pages]

Deploying fs-packages with    Cloudflare Pages

Latest commit:	770e045
Status:	✅  Deploy successful!
Preview URL:	https://376424b2.fs-packages.pages.dev
Branch Preview URL:	https://engineer-doctrine-8-fs-http.fs-packages.pages.dev

View logs