clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 23
colibri/tools/README.md
Sam & Claude ae5da0e94b chore(docs): delete legacy migration/cutover artifacts; repoint handoff refs (Sam & Claude) 
Remove the transition-era docs that no longer guide anyone and just pollute
context: MIGRATION-INVENTORY, CALLER-INVENTORY, GATE5-MIGRATION-GRAPH,
COLIBRI-CUTOVER-PLAN, and the rolling .agent-handoff.md. (History stays in git.)

Fix references in kept docs: drop the cutover/caller pointers (README,
COLIBRI-DAEMON-GLASSPANE-INTEGRATION), and repoint handoff mentions (AGENTS,
tools/README, MULTIAGENT-WORKFLOW-IMPROVEMENTS) to the ephemeral per-task
`doc/<FEATURE>-HANDOFF.md` convention. Dated session logs left as historical
record. Markdown gate green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-05 12:09:39 +02:00

2.6 KiB
Raw Blame History

Colibri Tools

This directory contains utility tools for the Colibri multiagent development workflow.

proof-gate-tracker

Automated proof gate validation tool that checks the status of all 6 migration proof gates.

Usage

# Build and run
cargo run --release --bin proof-gate-tracker

# Or build and run directly
cargo build --release --bin proof-gate-tracker
./target/release/proof-gate-tracker

Proof Gates Checked

  1. Gate #1 - Contracts: Validates golden test fixtures exist and are valid JSON
  2. Gate #2 - Cache Manifest: Verifies DeepSeek cache hit manifests exist for osa + domedog
  3. Gate #3 - Runtime Inventory: Ensures runtime inventory parity across all platforms
  4. Gate #4 - Cross-Platform: Runs cargo check --workspace to ensure build passes
  5. Gate #5 - Watchdog: Validates osa watchdog socket read successful
  6. Gate #6 - Caller Inventory: Checks caller inventory documentation exists (precondition check)

Exit Codes

  • 0: All critical gates passing
  • 1: Some critical gates failing

Integration with CI/CD

# Example GitHub Actions
- name: Validate Proof Gates
  run: cargo run --release --bin proof-gate-tracker

Platform Matrix Tests

Cross-platform smoke tests are located in tests/platform-matrix.rs.

Usage

# Run all platform matrix tests
cargo test --test platform-matrix

# Run with output
cargo test --test platform-matrix -- --nocapture

# Run specific test
cargo test --test platform-matrix all_platforms_validate_core_features -- --nocapture

Tests Included

  • all_platforms_validate_core_features: Validates all platforms (FreeBSD/Linux) have valid manifests
  • freebsd_specific_tests: FreeBSD-specific validations (osa)
  • linux_specific_tests: Linux-specific validations (domedog, debby)
  • cache_economics_parity: Verifies cache hit rate consistency across platforms

Multiagent Workflow Tools

Agent Handoff Protocol

See doc/<FEATURE>-HANDOFF.md for the standardized handoff protocol used between agents.

Handoff Template

{
  "agent_from": "agent_name",
  "agent_to": "agent_name",
  "focus_area": "brief description",
  "proof_gates_pending": ["gate-1", "gate-2"],
  "known_limitations": ["limitation 1"],
  "next_steps": ["step 1", "step 2"],
  "context_files": ["file1.rs", "file2.md"],
  "test_evidence": ["manifests/file1.json"]
}

Handoff Checklist

  • All tests pass (cargo test --workspace)
  • Relevant proof gates documented
  • Cross-platform validation recorded
  • Next agent's entry point marked
  • Handoff entry added to doc/<FEATURE>-HANDOFF.md