clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 43
colibri/tools/README.md
Sam & Claude 9891d06144 feat(rc): rename test agent and load provider env (Sam & Codex) 
Rename the local deterministic launch helper from colibri-smoke-agent to colibri-test-agent, update CLI/TUI/tests/docs, and teach the FreeBSD rc.d service to source /usr/local/etc/colibri/provider.env plus set a service PATH for local spawns.\n\nChecks: cargo fmt --check; ./scripts/check-format.sh; git diff --check; cargo check -p colibri-daemon -p colibri-client -p colibri-glasspane-tui; cargo check -p colibri-client --bins; cargo test -p colibri-client --test live_socket_check -- --nocapture.
2026-06-15 07:35:44 +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 startup checks 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