.gitignore

# Dev tooling
# (put individual local dev tooling stuff here)

# Environment files
.env
.env.local
.env.keys
*.local
.env.keys

# Encrypted, safe to commit
!.env.production
!.env.staging
!.env.ci

# Dependencies
node_modules
/pantry
# Locally packed tarballs. These are throwaway artifacts of `bun pm pack` /
# `npm pack` used to test an unpublished dependency, and one committed by
# accident ships to every project scaffolded from this template.
*.tgz
# Commit both lockfiles. Pantry owns the complete machine and project graph;
# Bun's lock remains the runtime package-manager lock used by Bun commands.

# QA
test-results
tests/unit/coverage
dist*

# IDE files
.fleet
.idea
.vscode
.cursor
.zed

# Git files
!.gitkeep

# Database files
database/stacks_testing.sqlite
database/stacks.sqlite
database/*.sqlite-wal
database/*.sqlite-shm

# OS files
.DS_Store
.DS_STORE

# Build files
.cache
temp
.temp
data.ms
generated/*
.stx-serve
custom-cli
*bun-build
discovered-packages.json

# Runtime state. It all lives under storage/ now:
#   storage/framework/stx      stx build cache + generated route manifest
#   storage/framework/runtime  migration lock, temp bundles, CLI scratch
#   storage/cloud              cloud driver state + dashboard credentials
storage/framework/stx/
storage/framework/runtime/
storage/cloud/

# Pre-relocation names of the three directories above. stx and ts-cloud each
# take their state directory from config now (`stateDir` in config/ui.ts and
# config/cloud.ts), so nothing is left in the project root - but a checkout that
# predates the move still has these until `ensureRuntimeDirectories()` migrates
# them, and they should never be committed in the meantime.
/.stx
/.ts-cloud
/.stacks

# Opt-in convenience symlink to storage/framework, created by
# `buddy generate:core-symlink`. Core developers only.
/.framework

# AI coding-agent setup, scaffolded by `buddy setup:ai` from the templates in
# storage/framework/defaults/ai. Which agent you use is a personal choice, so
# everything it generates stays out of the repo. AGENTS.md is the exception: it
# is shared guidance every agent reads, so it is authored and committed, and
# `setup:ai` only ever seeds it when it is missing.
/.claude
/.codex
/.gemini
/CLAUDE.md
/GEMINI.md
/.github/copilot-instructions.md

# Stub workspace packages (temporary)
/ts-auth
/ts-cloud
/ts-craft
/ts-md
/ts-open-api
/ts-pantry
/ts-security-crypto
/bun-queue
/headwind
/bun-plugin-stx
pantry

# Build artifact directory used by docs/build steps — never tracked.
storage/framework/cache/

# Persisted by `buddy update` to remember whether the project is following the
# `stable` or `canary` channel. Local preference only — the channel choice
# doesn't need to be shared across team members or CI.
.stacks-channel

# Persisted by `buddy update`: last-synced channel + commit sha for the
# up-to-date short-circuit. Local-only — like the channel, it's per-checkout.
.stacks-version

# Temp directory used during a `buddy update` GitHub fetch. Cleaned up by the
# upgrade action on success but listed here to keep stray copies (e.g. from a
# kill -9'd run) out of commits.
.tmp-upgrade/
/storage/framework/frontend-dist
/storage/framework/desktop-dist

# Per-package runtime logs created when building a core package in place
storage/framework/core/**/storage/logs/
storage/framework/**/storage/logs/

# @stacksjs/defaults copies resources + app from storage/framework/defaults at build time
# @stacksjs/defaults is a publish wrapper. Its generated scaffold is rebuilt
# from storage/framework/defaults by core/defaults/build.ts.
storage/framework/core/defaults/*
!storage/framework/core/defaults/README.md
!storage/framework/core/defaults/build.ts
!storage/framework/core/defaults/package.json
!storage/framework/core/defaults/tests/
!storage/framework/core/defaults/tests/**


# The local access token, minted per boot when the server runs with --remote.
# Anything holding this can dispatch commands, and a command starts an agent.
storage/private/harness.token