.ctxrc.dev

# .ctxrc — ctx runtime configuration
# https://ctx.ist/configuration/
#
# All settings are optional. Missing values use defaults.
# Priority: CLI flags > environment variables > .ctxrc > defaults

profile: dev

# context_dir: .context
# token_budget: 8000
# auto_archive: true
# archive_after_days: 7
# scratchpad_encrypt: true
# allow_outside_cwd: false
# entry_count_learnings: 30
# entry_count_decisions: 20
# convention_line_count: 200
# context_window: 200000  # Auto-detected for Claude Code; override for other tools
# billing_token_warn: 0   # Absolute token threshold for billing nudge (0 = disabled)
                           # Set to e.g. 180000 if tokens beyond 200k cost extra
# stale_age_days: 30       # Days before drift flags a context file as stale (0 = disabled)
# injection_token_warn: 15000  # Token threshold for oversize injection warning (0 = disabled)
# event_log: false         # Log hook events locally
# task_nudge_interval: 5   # Edit/Write calls between task completion nudges (0 = disabled)
# key_path: ""             # Explicit encryption key file path (default: auto-resolved)
# companion_check: true    # Check companion tool availability at session start
# session_prefixes:        # Recognized session header prefixes for Markdown parser
#   - "Session:"
# classify_rules:          # Custom keyword rules for memory entry classification
#   - target: convention   # (overrides defaults when set; rules evaluated in order)
#     keywords: ["always use", "prefer", "convention"]
#   - target: decision
#     keywords: ["decided", "chose", "trade-off"]
#   - target: learning
#     keywords: ["gotcha", "learned", "watch out"]
#   - target: task
#     keywords: ["todo", "need to", "follow up"]
# freshness_files:         # Files with technology-dependent constants for periodic review
#   - path: internal/config/version/version.go
#     desc: "Model-to-window mapping"
#     review_url: "https://docs.anthropic.com/en/docs/about-claude/models"
# priority_order:
#   - CONSTITUTION.md
#   - TASKS.md
#   - CONVENTIONS.md
#   - ARCHITECTURE.md
#   - DECISIONS.md
#   - LEARNINGS.md
#   - GLOSSARY.md
#   - AGENT_PLAYBOOK.md

key_rotation_days: 90  # Days before encryption key rotation nudge

# --- Webhook notifications ---
# Notifications are opt-in: nothing fires unless events are listed.
# Run `ctx hook notify setup` to configure the encrypted webhook URL first.
#
notify:
  events:
    - loop    # Loop script completed or hit max iterations
    - nudge   # VERBATIM relay hooks fired a nudge to the agent
    # nudge sub-events:
    #   check-context-size  — context checkpoint threshold reached
    #   check-persistence   — no context updated in N+ prompts
    #   check-ceremonies    — session ceremony reminder
    #   check-journal       — unexported/unenriched journal entries
    #   check-resources     — system resources critically low
    #   check-knowledge     — knowledge file growth detected
    #   check-version       — binary/plugin version mismatch or key rotation
    - relay   # All hook output (verbose — includes nudges plus)
    # relay sub-events:
    #   post-commit         — commit succeeded, context capture offered
    #   qa-reminder         — QA gate reminder emitted
    #   block-non-path-ctx  — blocked non-PATH ctx invocation
#
# Note: `ctx hook notify test` always bypasses the event filter — no need to
# list "test" here. It warns if filtered but sends anyway.