.gitignore

# =============================================================================
# GOLC .gitignore
#
# A clean checkout must contain no secrets, no machine-local values, and no
# provisioned tool state (CONF-03). Everything ignored here is either
# regenerated by `mage Bootstrap`/build steps or is machine-local by design.
# =============================================================================

# --- Secrets & environment ---------------------------------------------------

# Environment files are never committed; external names are documented in safe examples.
# The safe example itself (.env.example: names and empty placeholders only,
# D-19) is deliberately re-included below so it stays trackable.
.env
.env.*
!.env.example

# --- GOLC bootstrap & machine-local state ------------------------------------

# Project-local bootstrap toolchains, caches, and installs
# (provisioned by `mage Bootstrap` from pins in config/toolchain.toml).
/.tools/

# Machine-local configuration overrides
# (written by `golc config set --local`; strictly re-validated on read, never committed).
/golc.local.toml

# Scratch directory for local experiments and transient debris.
/tmp/

# --- Go build & test artifacts -------------------------------------------------

# Compiled binaries; deliverables are packaged reproducibly, never committed.
*.exe
*.exe~
*.dll
*.so
*.dylib
/golc-desktop
/golc-mcp
/golc-project
/mock-golc-demo
/mock-golc-show-seed

# Go test binaries and profiling/coverage output.
*.test
*.out
coverage.*
# Planning capability-coverage matrices are deliberate committed artifacts, not
# Go coverage output (the case-insensitive filesystem otherwise collides them).
!.planning/**/COVERAGE.md

# Go workspace files are developer-local; the module graph is pinned by go.mod/go.sum.
go.work
go.work.sum

# --- Node / TypeScript tooling (tools/linear-sync; Wails frontend later) --------

# Installed packages are restored from committed lockfiles with exact approved pins.
node_modules/

# Package-manager logs and debug output.
npm-debug.log*
yarn-error.log*

# Tool and frontend build output; regenerated from source.
dist/

# Playwright's own e2e run output (frontend/e2e/, playwright.config.ts) --
# traces/screenshots/HTML report from `npm run test:e2e`, regenerated per run.
test-results/
playwright-report/
blob-report/

# --- Wails desktop build output (Phase 6+) --------------------------------------

# Wails compiles into <wails.json-dir>/build/bin -- cmd/golc-desktop/wails.json
# (not a repo-root wails.json; see cmd/golc-desktop/wails.json's own
# "frontend:dir"/"wailsjsdir" comment in internal/command/dev.go for why),
# so that is cmd/golc-desktop/build/bin/, not /build/bin/ at the repo root.
# Packaging jobs produce their own artifacts elsewhere. The rest of
# cmd/golc-desktop/build/ (appicon.png, windows/icon.ico, windows/
# wails.exe.manifest, windows/info.json) is real, committed source/template
# content, not output -- a prior version of this rule ignored the whole
# directory, which silently meant the actual app icon never made it into
# the repository at all (every checkout fell back to Wails' own generic
# scaffold "W" placeholder icon until someone happened to generate one
# locally). cmd/golc-desktop/rsrc_windows_amd64.syso (also committed, not
# ignored) is the Go-toolchain-auto-linked Windows resource compiled from
# windows/icon.ico via `go-winres simply` -- required because this repo's
# `mage build`/`mage run` path is a plain `go build`, which never invokes
# Wails' own icon-embedding step the way `wails build`/`mage Dev` do.
/cmd/golc-desktop/build/bin/

# Wails' own npm-install-skip checksum (pkg/commands/build/base.go's
# packageChecksumFile) -- parallel to this repo's own
# frontend/node_modules/.golc-frontend-build-manifest.json, but Wails'
# independent mechanism, written whenever `mage Dev` runs.
/frontend/package.json.md5

# `mage Dev`'s `wails dev` auto-generates TS bindings into
# cmd/golc-desktop/wails.json's own "wailsjsdir" -- unused by this app (the
# frontend calls the Go backend through its own hand-written
# frontend/src/lib/wailsBridge.ts, never Wails' generated bindings), but
# still real build output that must never be committed.
/frontend/wailsjs/

# --- Foundation package output (mage PackageFoundation) ------------------

# `package --foundation` regenerates a deterministic Windows AMD64
# developer-tool ZIP, canonical manifest, and SHA-256 checksum sidecar at
# dist/foundation/ on every run (already covered by the generic `dist/`
# rule above; named explicitly here for discoverability). These are
# transient, machine-reproducible distribution artifacts, never committed
# source — the only committed foundation-package fixture is the golden
# test oracle at tests/golden/foundation-manifest.json, which this rule
# must never match.
/dist/foundation/

# --- OS cruft ---------------------------------------------------------------------

# Windows Explorer metadata.
Thumbs.db
Desktop.ini

# macOS Finder metadata (architecture stays portable even though v1 is Windows-only).
.DS_Store

# --- Editors & IDEs -----------------------------------------------------------------

# Editor workspace state; shared settings belong in committed files.
.idea/
.vscode/
*.swp

# --- Claude Code agent tooling --------------------------------------------------------

# Per-agent git worktrees (transient; created and removed by the orchestrator).
/.claude/worktrees/

# Machine-local Claude Code settings overrides
# (committed project hooks live in .claude/settings.json, which stays tracked).
/.claude/settings.local.json

# --- GSD planning research cache -----------------------------------------------------

# Content-hashed research/fetch cache regenerated by GSD research workflows;
# machine-local and reproducible from the same sources, never authored content.
/.planning/research/.cache/

# Local Netlify folder
.netlify

# Generated Show Files
# *.golc (not just the literal "show.golc" default name -- GOLC_DESKTOP_SHOW
# and "--show" both accept any filename) is a SQLite database in WAL mode,
# which leaves -wal/-shm sidecar files alongside it during normal operation
# (internal/show/schema.go's own doc comment: "expected to appear and
# disappear... this is normal SQLite WAL behavior, not corruption or a
# leak"). All three must be ignored together, or the sidecars show up as
# untracked cruft the moment a show file is opened.
*.golc
*.golc-wal
*.golc-shm

# Generated Log Files
# Ad hoc stdout/stderr redirection targets from manually launching
# golc-desktop.exe outside Wails' own dev tooling (e.g. `Start-Process
# -RedirectStandardOutput`/`-RedirectStandardError` for console debugging)
# -- never written by the app itself, but common enough to land in the repo
# root by accident to warrant a standing rule.
golc-desktop-run*.log
.coldstart/