go-webview/CLAUDE.md
Snider 7c46558e5b docs: graduate TODO/FINDINGS into production documentation
Replace internal task tracking (TODO.md, FINDINGS.md) with structured
documentation in docs/. Trim CLAUDE.md to agent instructions only.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 15:01:55 +00:00

1.2 KiB

CLAUDE.md

Module: forge.lthn.ai/core/go-webview — Chrome DevTools Protocol client for browser automation.

Commands

go test ./...          # Run all tests (must pass before commit)
go test -v -run Name   # Run a single test
gofmt -w .             # Format code

Coding Standards

  • UK English in all comments, docs, and commit messages
  • EUPL-1.2 licence header (// SPDX-License-Identifier: EUPL-1.2) in every Go file
  • Conventional commits: type(scope): description
  • Co-author trailer on every commit: Co-Authored-By: Virgil <virgil@lethean.io>
  • Test naming: _Good (happy path), _Bad (expected errors), _Ugly (panics/edge cases)

Key API

wv, err := webview.New(webview.WithDebugURL("http://localhost:9222"))
defer wv.Close()
wv.Navigate("https://example.com")
wv.Click("#submit")
wv.Type("#input", "text")
screenshot, _ := wv.Screenshot()

Docs

  • docs/architecture.md — CDP connection, DOM queries, console capture, Angular helpers
  • docs/development.md — prerequisites, build/test, coding standards, adding actions
  • docs/history.md — completed phases, known limitations, future considerations

Forge Push

git push ssh://git@forge.lthn.ai:2223/core/go-webview.git HEAD:main