go-store/docs
Snider 6c90af807d
Some checks are pending
Security Scan / security (push) Waiting to run
Test / test (push) Waiting to run
fix(store): address all CodeRabbit findings on PR #4
30+ findings dispositioned across compact / publish / events / import
/ workspace / config / docs / test surfaces.

Major code fixes:
- compact.go: stage archive, DB commit first, publish after commit
  (durability ordering bug)
- compact_test.go: replaced medium reread O(n²) with bytes.Buffer
- coverage_test.go: EnsureScoringTables now wraps + returns DDL errors
- events.go: lifecycle lock-order reordered (deadlock risk)
- import.go: paths join against cfg.DataDir; SQL write errors propagate;
  counts increment only on success
- bench_test.go: ScpDir + /benchmarks/ paths corrected
- json.go: formatter write errors propagate (no silent drops)
- parquet.go: removed runtime parquet-go dep + in-core writer (was
  buffering whole rows in memory — OOM risk on large datasets)
- publish.go: PublishConfig.Public uses private: !public
- HuggingFace upload streams file with content length (was buffering)
- store.go: ScopedStore.Transaction nil-store panic guard
- recover_test.go: handle .duckdb.wal sidecars; skip SQLite -shm for DuckDB
- coverage_test.go: WriteScoringResult wraps insert failures
- events_test.go: restored EventDeleteGroup wire value 'delete_group'
- transaction.go: NewScopedConfigured docs include parent store arg
- store_test.go: scope_test keyName uses non-wrapping integer names
- import_export_test.go: testify → stdlib helpers (AX-6 conformance)
- store.go: collapsed duplicate workspace DB fields to canonical 'db'

Doc / config:
- README.md: 'Licence' UK English on badge
- docs/architecture.md: clearer event ordering + lifecycle docs
- .golangci.yml: migrated to golangci-lint v2 schema
- Taskfile: default includes vet task
- JSON: terse 'value' param + concrete examples

Disposition replies (RESOLVED-COMMENT, no code change):
- conventions_test.go testify suggestion: AX-6 banned testify; stdlib helpers are convention
- DuckDB CGO/MIT critical: retained as documented exception in
  DEPENDENCIES.md (load-bearing existing dependency for the workspace
  store; replacement is its own engineering ticket)

Verification: GOWORK=off go vet + go test -count=1 ./... pass.
golangci-lint run ./... reports 0 issues. gofmt -l clean. git diff
--check clean.

Closes findings on https://github.com/dAppCore/go-store/pull/4

Co-authored-by: Codex <noreply@openai.com>
2026-04-27 14:51:06 +01:00
..
architecture.md fix(store): address all CodeRabbit findings on PR #4 2026-04-27 14:51:06 +01:00
development.md refactor(store): tighten AX naming and examples 2026-03-30 18:17:07 +00:00
history.md feat(store): add transaction api 2026-04-04 08:46:59 +00:00
index.md Align module path docs 2026-04-15 11:22:20 +01:00
RFC-CORE-008-AGENT-EXPERIENCE.md docs: add AX + store RFCs for agent dispatch 2026-03-30 19:52:14 +01:00
RFC-CORE-GO-REQUEST.md docs: add core/go RFC primitives for agent reference 2026-04-04 15:49:04 +01:00
RFC-CORE-GO.md docs: add core/go RFC primitives for agent reference 2026-04-04 15:49:04 +01:00
RFC-STORE.md Merge remote-tracking branch 'github/dev' into dev 2026-04-27 12:19:28 +01:00