sz-chrome-remote-cdp.git/docs, branch master

docs: remove the docs/ folder

2026-08-02T13:47:20+00:00

The plans, specs, and audit reports under docs/superpowers/ described work that has since landed, and ARCHITECTURE.md duplicated what the boundary scanner and the tool contract already enforce in code. CONTRIBUTING.md now points at the source that enforces each rule instead of at prose about it. .gitignore keeps docs/ ignored so local scratch docs stay out of the repo. Co-Authored-By: Claude Opus 5 (1M context)

refactor: merge nine files whose reason to exist was gone

2026-08-02T13:42:46+00:00

src/ goes from 84 files to 75 at the same line count — every merge below had exactly one consumer. cdp/event-queue.ts and cdp/pending-requests.ts become daemon/queue.ts. I split these in the daemon-internals commit on the grounds that they held two unrelated concerns, but the transport commit had already deleted the second transport, so both halves had one consumer and the split bought nothing. They also sat in cdp/ while only daemon/ used them. cdp/transport.ts held only the CdpTransport interface after the second transport went; five of its six consumers import it type-only, so it moves to cdp/types.ts. cdp/evaluate.ts moves into cdp/session.ts rather than into its lone consumer isolated-tab.ts — it reaches session.call directly, so under src/domains/ it would trip the raw-cdp-call rule. util/keycodes.ts and util/time.ts fold into their only callers (keyboard.ts, page.ts); util/bytes.ts into util/truncate.ts, which already owns output-size formatting; readpage/capture.ts and search/extract.ts into the tools beside them; profile/picker.ts into profile/command.ts. Kept deliberately: mutex.ts and domains/target.ts each have their own test suite, and folding target.ts into click.ts would make a tool file export a helper. sharp-shim.ts is an isolation boundary carrying two allowlisted casts. result.ts, guards.ts, js-template.ts and paths.ts are small but have 44, 12, 8 and 3 consumers. Co-Authored-By: Claude Opus 5 (1M context)

docs: record the new contract and the two knobs that now work

2026-08-02T13:42:46+00:00

ARCHITECTURE.md: the layer map gains domains/cdp-call.ts as the single door and the helper-module/tool-module split; the "cdpCall vs session.call" section is replaced, since snapshot.ts no longer mixes styles — it swallows failures through cdpCall instead of around it. Rule 1 now says tool files export only tools, rule 7 names the enforced scanner rules, and the two 250-line exceptions are recorded as largely settled (snapshot 477 to 256, form 409 to 283). Also notes the one honest gap: session.attach and session.windowId perform CDP calls the rules do not match. README: BU_CDP_WS carries its daemon-restart caveat, BH_DEBUG_CLICKS is documented as the flag's equivalent, and the tool count matches the registry (38 to 40). Co-Authored-By: Claude Opus 5 (1M context)

feat!: remove the deep-research feature

2026-08-02T13:42:46+00:00

The harness ships browser tools; orchestrating a multi-agent research workflow on top of them is the agent's job, not this extension's. Drops the skill, the /deep-research command, and the web-search-researcher subagent config. browser_web_search and browser_read_page are untouched — the two tests that covered their pure parsers move to test/domains/, where the test glob still picks them up. Co-Authored-By: Claude Opus 5 (1M context)

docs: warn that the bug-audit line numbers predate the comment strip

2026-08-02T13:42:46+00:00

Co-Authored-By: Claude Opus 5 (1M context)

docs: document the layer rules and tool authoring contract

2026-08-02T13:42:46+00:00

Co-Authored-By: Claude Opus 5 (1M context)

docs: bug audit report

2026-08-02T13:42:46+00:00

Thirty findings plus six investigated-not-bugs from the read-every-file sweep of src/, with resolution status for the six the user approved for fixing and the live-Chrome experiment F12 still needs. Co-Authored-By: Claude Opus 5 (1M context)

docs: add codebase refactor design

2026-08-02T13:42:46+00:00

Covers comment removal, CDP type-safety boundary, tool authoring contract, duplication/stale-code fixes, and commit sequencing. Co-Authored-By: Claude Opus 5 (1M context)

docs: add speed-optimizations research; chore: improve browser detection in setup

2026-05-04T15:44:30+00:00

docs: add v0.3.0 harness rewrite implementation plan

2026-05-02T09:47:27+00:00

27 tasks: foundations → CDP transport/session/client → defineTool helper → vertical slice (click) → 13 domain migrations → wire-up + delete legacy → smoke + release. Each task has concrete code, exact file paths, and a typecheck checkpoint. Co-Authored-By: Claude Opus 4.7 (1M context)