mirror of https://github.com/moonD4rk/HackBrowserData.git synced 2026-05-19 18:58:03 +02:00

Files

T

Roger d0971ca098 chore: update CI, golangci-lint, and CLAUDE.md (#511 )

* chore: update CI, golangci-lint, and CLAUDE.md
* fix: resolve CI failures on Windows test and lint
* fix: resolve Windows test path and main.go line length lint issues
* fix: auto-format log/ with gofumpt, exclude pre-refactoring lint issues
* fix: resolve remaining lint issues, remove unnecessary exclusions
* fix: remove invalid G117 gosec rule, use text exclusion for secret pattern
* fix: align CI golangci-lint version with local (v2.4 -> v2.10)

2026-03-23 01:40:59 +08:00

2.2 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Security Notice

This project is for security research and defensive purposes only. Do not generate code that could be used for unauthorized access. All security research must be conducted ethically and within legal boundaries.

Project Overview

HackBrowserData is a CLI security research tool for extracting and decrypting browser data across Windows, macOS, and Linux. It supports Chromium-based browsers and Firefox.

Constraint: Must build with Go 1.20 (Windows 7 support). Do not use features from Go 1.21+ (e.g., log/slog, slices, maps, cmp packages).

Development Commands

# Build (use go@1.20 for module operations)
go build ./cmd/hack-browser-data/

# Cross-compile
GOOS=windows GOARCH=amd64 go build ./cmd/hack-browser-data/
GOOS=linux GOARCH=amd64 go build ./cmd/hack-browser-data/

# Test
go test ./...
go test -v ./... -covermode=count -coverprofile=coverage.out

# Lint (requires golangci-lint v2)
golangci-lint run

# Format (gofumpt is stricter than gofmt)
gofumpt -l -w .
goimports -w -local github.com/moond4rk/hackbrowserdata .

# Spelling
typos

# Dependencies (MUST use go@1.20 to avoid bumping go directive)
# export GOROOT=$(brew --prefix go@1.20)/libexec && export PATH=$GOROOT/bin:$PATH
go mod tidy
go mod verify

Code Conventions

Platform code: use build tags (_darwin.go, _windows.go, _linux.go)
Error handling: fmt.Errorf("context: %w", err) for wrapping, never _ = to ignore errors
Logging: log.Debugf for record-level issues, log.Warnf for user-visible warnings. Extract methods should return errors, not log them.
Naming: follow Go conventions — Config not BrowserConfig, Extract not BrowsingData
Tests: use t.TempDir() for filesystem tests, go-sqlmock for database tests
Architecture: see rfcs/ for design documents

Key Constraints

modernc.org/sqlite pinned at v1.31.1 (v1.32+ requires Go 1.21)
golang.org/x/text will be removed in refactoring (use 3-byte UTF-8 BOM instead)
No pkg/ + internal/ directory structure — keep it simple
No root-level library API — CLI calls browser.PickBrowsers() directly

2.2 KiB Raw Blame History