.gitignore

# Created by https://www.toptal.com/developers/gitignore/api/python,node,rust,go,typescript,visualstudiocode,macos,linux,windows,zed
# Edit at https://www.toptal.com/developers/gitignore?templates=python,node,rust,go,typescript,visualstudiocode,macos,linux,windows,zed

### Go ###
# If you prefer the allow list template instead of the deny list, see community template:
# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
#
# Binaries for programs and plugins
*.exe
*.exe~
*.dll
*.so
*.dylib

# Test binary, built with `go test -c`
*.test

# Output of the go coverage tool, specifically when used with LiteIDE
*.out

# Dependency directories (remove the comment below to include it)
# vendor/

# Go workspace file
go.work

### Linux ###
*~

# temporary files which can be created if a process still has a handle open of a deleted file
.fuse_hidden*

# KDE directory preferences
.directory

# Linux trash folder which might appear on any partition or disk
.Trash-*

# .nfs files are created when an open file is removed but is still being accessed
.nfs*

### macOS ###
# General
.DS_Store
.AppleDouble
.LSOverride

# Icon must end with two \r
Icon

# Thumbnails
._*

# Files that might appear in the root of a volume
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent

# Directories potentially created on remote AFP share
.AppleDB
.AppleDesktop
Network Trash Folder
Temporary Items
.apdisk

### macOS Patch ###
# iCloud generated files
*.icloud

### Node ###
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
lerna-debug.log*
.pnpm-debug.log*

# Diagnostic reports (https://nodejs.org/api/report.html)
report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json

# Runtime data
pids
*.pid
*.seed
*.pid.lock

# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov

# Coverage directory used by tools like istanbul
coverage
*.lcov

# nyc test coverage
.nyc_output

# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
.grunt

# Bower dependency directory (https://bower.io/)
bower_components

# node-waf configuration
.lock-wscript

# Compiled binary addons (https://nodejs.org/api/addons.html)
build/Release

# Dependency directories
node_modules/
jspm_packages/

# Snowpack dependency directory (https://snowpack.dev/)
web_modules/

# TypeScript cache
*.tsbuildinfo

# Optional npm cache directory
.npm

# Optional eslint cache
.eslintcache

# Optional stylelint cache
.stylelintcache

# Microbundle cache
.rpt2_cache/
.rts2_cache_cjs/
.rts2_cache_es/
.rts2_cache_umd/

# Optional REPL history
.node_repl_history

# Output of 'npm pack'
*.tgz

# Yarn Integrity file
.yarn-integrity

# dotenv environment variable files
.env
.env.development.local
.env.test.local
.env.production.local
.env.local

# parcel-bundler cache (https://parceljs.org/)
.cache
.parcel-cache

# Next.js build output
.next
out

# Nuxt.js build / generate output
.nuxt
dist

# Gatsby files
.cache/
# Comment in the public line in if your project uses Gatsby and not Next.js
# https://nextjs.org/blog/next-9-1#public-directory-support
# public

# vuepress build output
.vuepress/dist

# vuepress v2.x temp and cache directory
.temp

# Docusaurus cache and generated files
.docusaurus

# Serverless directories
.serverless/

# FuseBox cache
.fusebox/

# DynamoDB Local files
.dynamodb/

# TernJS port file
.tern-port

# Stores VSCode versions used for testing VSCode extensions
.vscode-test

# yarn v2
.yarn/cache
.yarn/unplugged
.yarn/build-state.yml
.yarn/install-state.gz
.pnp.*

### Node Patch ###
# Serverless Webpack directories
.webpack/

# Optional stylelint cache

# SvelteKit build / generate output
.svelte-kit

### Python ###
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
# Anchored to the repo root on purpose. A bare `lib/` matches ANY directory
# named lib at any depth, which silently untracked two production SPA modules
# (web/static/js/lib/) for the whole project history — they existed only as
# working-tree files, so a fresh clone shipped a broken app.
/lib/
/lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST
# The rule above is setuptools' build-artifact MANIFEST (generated next to
# setup.py), not this repo's tracked, hand-maintained provenance record for
# vendored web assets (R-75) -- same trap class as R-67 (the bare `MANIFEST`
# pattern would otherwise silently swallow `git add` for this file forever).
!packages/studyloop/src/studyloop/web/static/vendor/MANIFEST

# PyInstaller
#  Usually these files are written by a python script from a template
#  before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/

# Translations
*.mo
*.pot

# Django stuff:
local_settings.py
db.sqlite3
db.sqlite3-journal

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
.pybuilder/
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
#   For a library or package, you might want to ignore these files since the code is
#   intended to run in multiple environments; otherwise, check them in:
# .python-version

# pipenv
#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
#   However, in case of collaboration, if having platform-specific dependencies or dependencies
#   having no cross-platform support, pipenv may install dependencies that don't work, or not
#   install all needed dependencies.
#Pipfile.lock

# poetry
#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
#   This is especially recommended for binary packages to ensure reproducibility, and is more
#   commonly ignored for libraries.
#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
#poetry.lock

# pdm
#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
#   in version control.
#   https://pdm.fming.dev/#use-with-ide
.pdm.toml

# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/

# Celery stuff
celerybeat-schedule
celerybeat.pid

# SageMath parsed files
*.sage.py

# Environments
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# pytype static type analyzer
.pytype/

# Cython debug symbols
cython_debug/

# PyCharm
#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
#  and can be added to the global gitignore or merged into this file.  For a more nuclear
#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/

### Python Patch ###
# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
poetry.toml

# ruff
.ruff_cache/

# LSP config files
pyrightconfig.json

### Rust ###
# Generated by Cargo
# will have compiled files and executables
debug/

# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
Cargo.lock

# These are backup files generated by rustfmt
**/*.rs.bk

# MSVC Windows builds of rustc generate these, which store debugging information
*.pdb

#!! ERROR: typescript is undefined. Use list command to see defined gitignore types !!#

### VisualStudioCode ###
.vscode/*
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json
!.vscode/extensions.json
!.vscode/*.code-snippets

# Local History for Visual Studio Code
.history/

# Built Visual Studio Code Extensions
*.vsix

### VisualStudioCode Patch ###
# Ignore all local history of files
.history
.ionide

### Windows ###
# Windows thumbnail cache files
Thumbs.db
Thumbs.db:encryptable
ehthumbs.db
ehthumbs_vista.db

# Dump file
*.stackdump

# Folder config file
[Dd]esktop.ini

# Recycle Bin used on file shares
$RECYCLE.BIN/

# Windows Installer files
*.cab
*.msi
*.msix
*.msm
*.msp

# Windows shortcuts
*.lnk

#!! ERROR: zed is undefined. Use list command to see defined gitignore types !!#

# End of https://www.toptal.com/developers/gitignore/api/python,node,rust,go,typescript,visualstudiocode,macos,linux,windows,zed

# Agentic Agent Files
.claude/
CLAUDE.md
AGENTS.md
!/AGENTS.md
# pi harness steering files — shipped with the repo, installed into
# ~/.pi/agent/ by `studyloop install agents --tool pi`.
!agents/codex/AGENTS.md
!agents/pi/AGENTS.md
agents/cowork/
.kiro/
.crush/
.opencode/
.cursor/
.windsurf/
.continue/
.aider/
.copilot/
.speckit/
.openspec/

# IDE Files
.vscode/
.idea/
*.code-workspace
.zed/
site/

# SQLite databases (may contain sensitive AI conversation data)
*.db
*.db-wal
*.db-shm
*.db-journal

# Internal/planning docs (kept locally, not published)
docs/internal/
docs/local_repo_docs/
# docs/plans/ — un-ignored 2026-05-10 so live plans ship with the repo
docs/architecture/*
!docs/architecture/
!docs/architecture/adapter-pattern-notebooklm.md
# Un-ignored 2026-05-28 — these are linked from docs/architecture.md and ship
# with the repo (C4 diagrams of the live system + target direction).
!docs/architecture/current.md
!docs/architecture/target.md
# Un-ignored 2026-05-31, renamed to pi-only 2026-09-10 — pi harness integration
# doc (C4 diagrams + the only written description of the pi JSONL exporter).
!docs/architecture/pi-harness-integration.md
# Un-ignored 2026-09-02 — session-authority contract (M2 remediation lane),
# linked from ADR-0009 and tested against by tests/test_session_authority_matrix.py.
!docs/architecture/session-authority.md
# Un-ignored 2026-09 — second-brain projection contract (R-84), linked from ADR-0010
# and docs/second-brain.md; tested against by tests/test_second_brain_*.py.
!docs/architecture/second-brain.md
# Un-ignored 2026-09-09 — session-memory decision record, corrected against source
# (one file / three tiers; the ontology/OKF/sidecar claims RETIRED by ADR-0011), its
# glossary, and the archify spec the diagram regenerates from. The 718 KB
# delivered HTML stays ignored: it exceeds the 500 KB large-file hook and is
# reproducible from the spec via `archify deliver`. The subdirectory itself must
# be un-ignored first or the file negations cannot match.
!docs/architecture/session-memory/
docs/architecture/session-memory/*
!docs/architecture/session-memory/README.md
!docs/architecture/session-memory/GLOSSARY.md
!docs/architecture/session-memory/verified-architecture.architecture.json
# Receipts (adapter-scope decisions, measurement records) are small Markdown/JSON
# and must be tracked; same negation as feat/knowledge-proof so the branches merge.
!docs/architecture/session-memory/receipts/
# Un-ignored 2026-09-15 — plan-integration programme record (issues #7–#15): council
# briefs, seat receipts, arbitration, verification receipts and the archify spec.
# Same shape as session-memory above: small Markdown/JSON only; any delivered
# HTML stays ignored and regenerates from the spec via `archify deliver`.
!docs/architecture/plan-integration/
docs/architecture/plan-integration/*
!docs/architecture/plan-integration/council/
!docs/architecture/plan-integration/receipts/
!docs/architecture/plan-integration/*.architecture.json
!docs/architecture/plan-integration/*.md

# Demo recordings (large, local-only)
demos/

# Agent workflow artefacts
code-review-plan-items.md
TODO.md

# Artefacts (served from artefact-store, not committed to source repo)
docs/artefacts/
pytest-of-*/
uv-*.lock

# Iterate runner artefacts (autoresearch pattern — kept untracked)
results.tsv
.pytest-junit.xml
docs/reports/
# docs/brainstorms/ — un-ignored 2026-05-10 so brainstorms ship with their plans

# Benchmark output (large regenerable artefacts — keep local)
benchmarks/d2-output/

# Stray mock path artefacts from tests that stringify MagicMock path objects
<MagicMock id='*'>

# Playwright MCP browser cache
.playwright-mcp/
.playwright-cli/

# Repeatable README/e2e media staging. Curated public captures live in docs/images/.
output/playwright/

# Local debug screenshots at repo root (don't commit; allow under packages/ and docs/)
/*.png

# P6 hill-climber generated artifact (regenerated each run)
extractor_candidate.py

# Code-intelligence / knowledge-graph tool output (large, regenerable — keep local)
.codegraph/
.understand-anything/
graphify-out/
.kirograph/
.graphify_detect.json
.graphify_python
.qdrant-initialized
.codex/
.worktrees/

# MemPalace per-project files (issue #185)
mempalace.yaml
entities.json

# Understand-anything
.ua/

# Playwright/e2e failure artifacts
test-results/
# Screenshots/HTML/console dumps written by the e2e harness on failure
# (see packages/studyloop/tests/e2e/_env.py). Regenerated every run.
playwright/artifacts/
# `dir/*` so the tracked .gitkeep survives — with `dir/` the negation is dead and
# the keepfile shows up as tracked-but-ignored.
playwright/snapshots/*
!playwright/snapshots/.gitkeep

# Stray MagicMock dirs from tests that mock a path-typed setting (defense-in-depth)
# These are a SYMPTOM, not a config need: the write site is
# packages/studyloop/src/studyloop/state.py:60 (get_state_dir().mkdir(...)). When a
# test mocks settings without giving state_dir a real path, Path(MagicMock) becomes
# the mock's repr and mkdir creates a directory named after it. 10 such directories
# were present when this comment was written. The rule stays as a net, but the fix
# belongs in the offending tests (give state_dir a tmp_path).
MagicMock/
# Tavily skill installs dropped by harness plugins (tool artefacts, not project content)
.agents/
# Same reasoning for zcode's generated opsx command/skill installs: they mirror
# the OpenSpec Plus set already tracked under .pi/, so tracking them again would
# duplicate generated content once per AI tool.
.zcode/
# .pi holds BOTH tool artefacts and 12 deliberately-tracked OpenSpec files, so it
# uses the `dir/*` form rather than `dir/`: git cannot re-include anything whose
# parent directory is excluded by a trailing-slash pattern, which made the
# negations below silently dead and left those files tracked-but-ignored.
.pi/
agent/
skills-lock.json
#
# openspec files
openspec/
# dotfiles/dirs
.graphify-labels.json
.graphifyignore
# Personal / throwaway scripts only.
#
# Do NOT ignore the whole scripts/ directory. 16 scripts in it are TRACKED and
# load-bearing: scripts/install.sh is the README's documented install path,
# build-release.sh + check-release-consistency.py + the two smoke-*.sh scripts are
# invoked by .github/workflows/ci.yml, and the Justfile drives several more. A
# directory-wide rule does not hide those (git only ignores UNTRACKED files) but it
# does mean a NEW script silently fails to `git add`, and it leaves the tracked
# ones in a tracked-but-ignored state that `git ls-files -i -c` flags.
#
# Convention: prefix a throwaway with an underscore, or put personal scratch in
# scripts/local/.
scripts/_*
scripts/local/
#
# Internal review reports. Deliberately NOT public: these record candid findings
# about docs-vs-reality drift, test gaps and half-built surfaces, which is useful
# working material but reads as a defect list to anyone who finds it in a public
# repo. Public-facing conclusions belong in docs/ or an ADR instead.
/reviews/

# Internal planning, handoffs, audits, research and evidence live in the private
# repo (~/code/personal/tools/studyloop-private), never here. Public docs are the
# mkdocs.yml allowlist plus docs/adr and docs/architecture.
docs/handoffs/
docs/archive/
docs/audit/
docs/research/
docs/superpowers/
docs/plans/
docs/planning/
docs/brainstorms/
docs/explorations/
docs/issues/
docs/designs/
docs/course-explorer/
docs/desktop-mcp/
docs/migrations/
docs/standards/
docs/troubleshooting/

# Process docs folded into docs/contributing.md and kept privately
docs/openspec.md
docs/ownership.md
docs/ci.md
docs/e2e-test-harness.md
docs/release-process.md
docs/mcp.md
docs/audhd-deep-technical-learning-roadmap.md
docs/audhd-learning-loop-implementation.md

# Superpower plugin
.superpowers/