This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
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>
2026-06-23 14:14:09 +03:00
..

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 50 in CI (Tier 1 only)
  • cron-compact.sh monthly 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