Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as opaque submodule gitlinks on GitHub) into fully-tracked first-party content. AITM now merges its 7 vendored repos as first-party engines: - memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts - git: vendored C git (bundled binary) + gitnexus (in-process code intelligence) - agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess) Includes the full session's product build: Gitgram web/mobile/backend features, AITM website/CLI/MCP, the unified memory layer, engine build tooling (scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md), and extensive test suites. Build artifacts, node_modules, external/, and gemini-cli are gitignored. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Compaction Examples
This directory contains example scripts for automating database compaction.
Scripts
workflow.sh
Interactive compaction workflow with prompts. Perfect for manual compaction runs.
chmod +x workflow.sh
export ANTHROPIC_API_KEY="sk-ant-..."
./workflow.sh
Features:
- Previews candidates before compaction
- Prompts for confirmation at each tier
- Shows final statistics
- Provides next-step guidance
When to use: Manual monthly/quarterly compaction
cron-compact.sh
Fully automated compaction for cron jobs. No interaction required.
# Configure
export BD_REPO_PATH="/path/to/your/repo"
export BD_LOG_FILE="$HOME/.bd-compact.log"
export ANTHROPIC_API_KEY="sk-ant-..."
# Test manually
./cron-compact.sh
# Install to cron (monthly)
cp cron-compact.sh /etc/cron.monthly/bd-compact
chmod +x /etc/cron.monthly/bd-compact
# Or add to crontab
crontab -e
# Add: 0 2 1 * * /path/to/cron-compact.sh
Features:
- Pulls latest changes before compacting
- Logs all output
- Auto-commits and pushes results
- Reports counts of compacted issues
When to use: Automated monthly compaction for active projects
auto-compact.sh
Smart auto-compaction with thresholds. Only runs if enough eligible issues exist.
chmod +x auto-compact.sh
# Compact if 10+ eligible issues
./auto-compact.sh
# Custom threshold
./auto-compact.sh --threshold 50
# Preview without compacting
./auto-compact.sh --dry-run
(Tier 2 ultra-compression is planned but not yet implemented; only --tier 1
works today.)
Features:
- Configurable eligibility threshold
- Skips compaction if below threshold
- Tier 1 semantic compression (Tier 2 planned)
- Dry-run mode for testing
When to use:
- Pre-commit hooks (if ANTHROPIC_API_KEY set)
- CI/CD pipelines
- Conditional automation
Configuration
All scripts require:
export ANTHROPIC_API_KEY="sk-ant-..."
Additional environment variables:
BD_REPO_PATH: Repository path (cron-compact.sh)BD_LOG_FILE: Log file location (cron-compact.sh)
Recommendations
Small Projects (<500 issues)
Use workflow.sh manually, once or twice per year.
Medium Projects (500-5000 issues)
Use cron-compact.sh quarterly or auto-compact.sh in CI.
Large Projects (5000+ issues)
Use cron-compact.sh monthly with both tiers:
# Modify cron-compact.sh to run both tiers
High-Velocity Teams
Combine approaches:
auto-compact.sh --threshold 50in CI (Tier 1 only)cron-compact.shmonthly for Tier 2
Testing
Before deploying to cron, test scripts manually:
# Test workflow
export ANTHROPIC_API_KEY="sk-ant-..."
./workflow.sh
# Test cron script
export BD_REPO_PATH="$(pwd)"
./cron-compact.sh
# Test auto-compact (dry run)
./auto-compact.sh --dry-run --threshold 1
Troubleshooting
Script says "bd command not found"
Ensure bd is in PATH:
which bd
export PATH="$PATH:/usr/local/bin"
"ANTHROPIC_API_KEY not set"
export ANTHROPIC_API_KEY="sk-ant-..."
# Add to ~/.zshrc or ~/.bashrc for persistence
Cron job not running
Check cron logs:
# Linux
grep CRON /var/log/syslog
# macOS
log show --predicate 'process == "cron"' --last 1h
Verify script is executable:
chmod +x /etc/cron.monthly/bd-compact
Cost Monitoring
Track compaction costs:
# Show stats after compaction
bd admin compact --stats
# Estimate monthly cost
# (issues_compacted / 1000) * $1.00
Set up alerts if costs exceed budget (future feature: bd-cost-alert).
See Also
- COMPACTION.md - Comprehensive compaction guide
- README.md - Main documentation
- GIT_WORKFLOW.md - Multi-machine collaboration