scripts/tt-config.sh

# trigger-tree — default configuration.
# Layering: this file < user-wide ~/.trigger-tree/config.sh (or TT_USER_CONFIG)
# < project .trigger-tree/config.sh. The project always wins.
# Override per project: create $PROJECT/.trigger-tree/config.sh with the same variables.
# Paths are relative to the project root.

# A Read of a file matching this regex counts as a documentation read.
TT_WATCH_REGEX='^(docs|agents|skills|agent-briefs)/.*\.md$|^\.claude/(rules|skills)/.*\.md$|^(CLAUDE|AGENTS|GEMINI)\.md$'

# A Glob/Grep whose explicit target dir matches this regex counts as search activity.
# The event records that a search happened, not why it happened or whether routing failed.
TT_SCAN_REGEX='^(docs|agents|skills|agent-briefs)(/|$)'

# Files matching this regex are loaded automatically (system-prompt injection, nested
# CLAUDE.md on-demand loading, Skill tool) and therefore cannot be judged through
# Read telemetry — excluded from untouched review-candidate analysis.
TT_ALWAYS_LOADED_REGEX='(^|/)(CLAUDE|AGENTS|GEMINI)\.md$|(^|/)CLAUDE\.local\.md$|^\.claude/(rules|skills)/'
# Example project override additions for other instruction systems:
# TT_ALWAYS_LOADED_REGEX='...|^\.github/copilot-instructions\.md$|^\.cursor/rules/'

# Comma-separated fnmatch globs for markdown that is intentionally NOT agent
# documentation (issue templates, changelogs). Acknowledged files leave the
# watch-scope findings and denominator; a path the watch regex matches is never
# ignored. Example value: .github/* plus CHANGELOG.md, comma-separated.
TT_SCOPE_IGNORE=''

# Comma-separated globs for rare-but-critical documentation that must be reviewed,
# never treated as an archive candidate. Safety paths are protected regardless.
TT_CRITICAL_GLOB=''

# Plugin fallback: hash, so a user-wide install never stores prompt text in any
# repository before that project's setup made an explicit choice. Setup offers
# truncate (recommended), hash, and off.
TT_LOG_PROMPTS='hash'

# Bounded topic labels can support instruction-adherence measurement without prompt
# text. Kept off until project setup explicitly enables it.
TT_LOG_TOPICS='off'

# Values: off, classified (stable manifest pattern IDs only), or full (raw command).
# Kept off until project setup explicitly enables classified capture.
TT_LOG_COMMANDS='off'

# Records only the persona name of a launched subagent, never its task text.
# Kept off until project setup explicitly enables it.
TT_LOG_AGENTS='off'

# Project-relative edit paths only. Setup installs a conservative project scope;
# the plugin fallback matches nothing so existing installs never record more silently.
TT_EDIT_REGEX='(?!)'

# Rotate history.jsonl to history-<timestamp>.jsonl when it exceeds this many bytes.
TT_ROTATE_BYTES='5242880'

# Experimental, correlational view joining reads with local session outcomes.
# Values: off (default) or on. This never makes causal claims or sends data anywhere.
TT_EXPERIMENTAL_OUTCOMES='off'