mirror of
https://github.com/garrytan/gstack.git
synced 2026-05-07 05:56:41 +02:00
Garry Tan
f7b95329c1
* Phase 2: Enhanced browser — dialog handling, upload, state checks, snapshots - CircularBuffer O(1) ring buffer for console/network/dialog (was O(n) array+shift) - Async buffer flush with Bun.write() (was appendFileSync) - Dialog auto-accept/dismiss with buffer + prompt text support - File upload command (upload <sel> <file...>) - Element state checks (is visible/hidden/enabled/disabled/checked/editable/focused) - Annotated screenshots with ref labels overlaid (-a flag) - Snapshot diffing against previous snapshot (-D flag) - Cursor-interactive element scan for non-ARIA clickables (-C flag) - Snapshot scoping depth limit (-d N flag) - Health check with page.evaluate + 2s timeout - Playwright error wrapping — actionable messages for AI agents - Fix useragent — context recreation preserves cookies/storage/URLs - wait --networkidle / --load / --domcontentloaded flags - console --errors filter (error + warning only) - cookie-import <json-file> with auto-fill domain from page URL - 166 integration tests (was ~63) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Phase 2: Rewrite SKILL.md as QA playbook + command reference Reorient SKILL.md files from raw command reference to QA-first playbook with 10 workflow patterns (test user flows, verify deployments, dogfood features, responsive layouts, file upload, forms, dialogs, compare pages). Compact command reference tables at the bottom. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Phase 3: /qa skill — systematic QA testing with health scores New /qa skill for systematic web app QA testing. Three modes: - full: 5-10 documented issues with screenshots and repro steps - quick: 30-second smoke test with health score - regression: compare against saved baseline Includes issue taxonomy (7 categories, 4 severity levels), structured report template, health score rubric (weighted across 7 categories), framework detection guidance (Next.js, Rails, WordPress, SPA). Also adds browse/bin/find-browse (DRY binary discovery using git rev-parse), .gstack/ to .gitignore, and updated TODO roadmap. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * Bump to v0.3.0 — Phase 2 + Phase 3 changelog Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * feat: cookie-import-browser — Chromium cookie decryption module + tests Pure logic module for reading and decrypting cookies from macOS Chromium browsers (Comet, Chrome, Arc, Brave, Edge). Supports v10 AES-128-CBC encryption with macOS Keychain access, PBKDF2 key derivation, and per-browser key caching. 18 unit tests with encrypted cookie fixtures. * feat: cookie picker web UI + route handler Two-panel dark-theme picker served from the browse server. Left panel shows source browser domains with search and import buttons. Right panel shows imported domains with trash buttons. No cookie values exposed. 6 API endpoints, importedDomains Set tracking, inline clearCookies. * feat: wire cookie-import-browser into browse server Add cookie-picker route dispatch (no auth, localhost-only), add cookie-import-browser to WRITE_COMMANDS and CHAIN_WRITE, add serverPort property to BrowserManager, add write command with two modes (picker UI vs --domain direct import), update CLI help text. * chore: /setup-browser-cookies skill + docs (Phase 3.5) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * chore: bump version and changelog (v0.3.1) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * security: redact sensitive values from command output (PR #21) type no longer echoes text (reports character count), cookie redacts value with ****, header redacts Authorization/Cookie/X-API-Key/X-Auth-Token, storage set drops value, forms redacts password fields. Prevents secrets from persisting in LLM transcripts. 7 new tests. Credit: fredluz (PR #21) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * security: path traversal prevention for screenshot/pdf/eval (PR #26) Add validateOutputPath() for screenshot/pdf/responsive (restricts to /tmp and cwd) and validateReadPath() for eval (blocks .. sequences and absolute paths outside safe dirs). 7 new tests. Credit: Jah-yee (PR #26) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: auto-install Playwright Chromium in setup (PR #22) Setup now verifies Playwright can launch Chromium, and auto-installs it via `bunx playwright install chromium` if missing. Exits non-zero if build or Chromium launch fails. Credit: AkbarDevop (PR #22) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * security: fix path validation bypass, CORS restriction, cookie-import path check - startsWith('/tmp') matched '/tmpevil' — now requires trailing slash - CORS Access-Control-Allow-Origin changed from * to http://127.0.0.1:<port> - cookie-import now validates file paths (was missing validateReadPath) - 3 new tests for prefix collision and cookie-import path traversal Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * fix: address review informational issues + add regression tests - Add cookie-import to CHAIN_WRITE set for chain command routing - Add path validation to snapshot -a -o output path - Fix package.json version to match 0.3.1 - Use crypto.randomUUID() for temp DB paths (unpredictable filenames) - Add regression tests for chain cookie-import and snapshot path validation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: add /qa, /setup-browser-cookies to README + update BROWSER.md - Add /qa and /setup-browser-cookies to skills table, install/update/uninstall blurbs - Add dedicated README sections for both new skills with usage examples - Update demo workflow to show cookie import → QA → browse flow - Update BROWSER.md: cookie import commands, new source files, test count (203) - Update skill count from 6 to 8 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * feat: team-aware /retro v2.0 — per-person praise and growth opportunities - Identify current user via git config, orient narrative as "you" vs teammates - Add per-author metrics: commits, LOC, focus areas, commit type mix, sessions - New "Your Week" section with personal deep-dive for whoever runs the command - New "Team Breakdown" with per-person praise and growth opportunities - Track AI-assisted commits via Co-Authored-By trailers - Personal + team shipping streaks - Tone: praise like a 1:1, growth like investment advice, never compare negatively Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: add Conductor parallel sessions section to README Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
68 lines
3.6 KiB
Markdown
68 lines
3.6 KiB
Markdown
# Changelog
|
|
|
|
## 0.3.1 — 2026-03-12
|
|
|
|
### Phase 3.5: Browser cookie import
|
|
|
|
- `cookie-import-browser` command — decrypt and import cookies from real Chromium browsers (Comet, Chrome, Arc, Brave, Edge)
|
|
- Interactive cookie picker web UI served from the browse server (dark theme, two-panel layout, domain search, import/remove)
|
|
- Direct CLI import with `--domain` flag for non-interactive use
|
|
- `/setup-browser-cookies` skill for Claude Code integration
|
|
- macOS Keychain access with async 10s timeout (no event loop blocking)
|
|
- Per-browser AES key caching (one Keychain prompt per browser per session)
|
|
- DB lock fallback: copies locked cookie DB to /tmp for safe reads
|
|
- 18 unit tests with encrypted cookie fixtures
|
|
|
|
## 0.3.0 — 2026-03-12
|
|
|
|
### Phase 3: /qa skill — systematic QA testing
|
|
|
|
- New `/qa` skill with 6-phase workflow (Initialize, Authenticate, Orient, Explore, Document, Wrap up)
|
|
- Three modes: full (systematic, 5-10 issues), quick (30-second smoke test), regression (compare against baseline)
|
|
- Issue taxonomy: 7 categories, 4 severity levels, per-page exploration checklist
|
|
- Structured report template with health score (0-100, weighted across 7 categories)
|
|
- Framework detection guidance for Next.js, Rails, WordPress, and SPAs
|
|
- `browse/bin/find-browse` — DRY binary discovery using `git rev-parse --show-toplevel`
|
|
|
|
### Phase 2: Enhanced browser
|
|
|
|
- Dialog handling: auto-accept/dismiss, dialog buffer, prompt text support
|
|
- File upload: `upload <sel> <file1> [file2...]`
|
|
- Element state checks: `is visible|hidden|enabled|disabled|checked|editable|focused <sel>`
|
|
- Annotated screenshots with ref labels overlaid (`snapshot -a`)
|
|
- Snapshot diffing against previous snapshot (`snapshot -D`)
|
|
- Cursor-interactive element scan for non-ARIA clickables (`snapshot -C`)
|
|
- `wait --networkidle` / `--load` / `--domcontentloaded` flags
|
|
- `console --errors` filter (error + warning only)
|
|
- `cookie-import <json-file>` with auto-fill domain from page URL
|
|
- CircularBuffer O(1) ring buffer for console/network/dialog buffers
|
|
- Async buffer flush with Bun.write()
|
|
- Health check with page.evaluate + 2s timeout
|
|
- Playwright error wrapping — actionable messages for AI agents
|
|
- Context recreation preserves cookies/storage/URLs (useragent fix)
|
|
- SKILL.md rewritten as QA-oriented playbook with 10 workflow patterns
|
|
- 166 integration tests (was ~63)
|
|
|
|
## 0.0.2 — 2026-03-12
|
|
|
|
- Fix project-local `/browse` installs — compiled binary now resolves `server.ts` from its own directory instead of assuming a global install exists
|
|
- `setup` rebuilds stale binaries (not just missing ones) and exits non-zero if the build fails
|
|
- Fix `chain` command swallowing real errors from write commands (e.g. navigation timeout reported as "Unknown meta command")
|
|
- Fix unbounded restart loop in CLI when server crashes repeatedly on the same command
|
|
- Cap console/network buffers at 50k entries (ring buffer) instead of growing without bound
|
|
- Fix disk flush stopping silently after buffer hits the 50k cap
|
|
- Fix `ln -snf` in setup to avoid creating nested symlinks on upgrade
|
|
- Use `git fetch && git reset --hard` instead of `git pull` for upgrades (handles force-pushes)
|
|
- Simplify install: global-first with optional project copy (replaces submodule approach)
|
|
- Restructured README: hero, before/after, demo transcript, troubleshooting section
|
|
- Six skills (added `/retro`)
|
|
|
|
## 0.0.1 — 2026-03-11
|
|
|
|
Initial release.
|
|
|
|
- Five skills: `/plan-ceo-review`, `/plan-eng-review`, `/review`, `/ship`, `/browse`
|
|
- Headless browser CLI with 40+ commands, ref-based interaction, persistent Chromium daemon
|
|
- One-command install as Claude Code skills (submodule or global clone)
|
|
- `setup` script for binary compilation and skill symlinking
|