layered-soul/skills/colibri-development/references/linux-precheck.md
Hermes & Sam 5c5df32101 Populate layered-soul: identity, memories, skills, plan (Hermes & Sam)
- SOUL.md: full agent identity, operating principles, voice
- IDENTITY.md: runtime identity, hosts, boundaries
- USER.md: operator context imported from hermes-soul
- AGENTS.md: actual operating rules, infrastructure, quick reference
- memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden)
- skills/: 9 cross-harness skills imported from hermes-soul after review
- docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan
- Validate: passes clean
2026-06-14 00:21:26 +02:00

1.8 KiB

Linux pre-check as FreeBSD build gate

The Colibri workspace compiles and tests on Linux (Debian bookworm, rustc 1.95+). Running the full test suite on Linux before handing off to the FreeBSD/OSA build host catches Rust-level issues (missing enum variants, type mismatches, edition errors, compilation failures) that don't need FreeBSD-specific tools.

Commands

cd ~/ai/colibri
git pull forgejo main                  # sync first
cargo build --workspace --release      # full release build
cargo test --workspace                 # all tests

Use terminal(background=true, notify_on_complete=true, timeout=600) for the build — it takes 60-90s from warm cache.

What this catches

  • Missing enum variants (see pitfall below)
  • Type mismatches across crates
  • Missing tokio features in Cargo.toml
  • Edition mismatches
  • Compilation errors from incomplete refactors

What this does NOT catch

  • FreeBSD-specific path issues (/tmp vs tmpfs, /var/run permissions)
  • daemon(8) supervision bugs
  • rc.d service behavior
  • ZFS / device node access
  • FreeBSD-only syscalls or kqueue events

When to run

  • After any PR merge that touches multiple crates
  • After adding a new subcommand or CLI surface
  • Before a handoff to the FreeBSD build host (osa)
  • After pulling — the remote may have drift

2026-06-04 example

Pull of main (13 files changed across 2 PRs) failed cargo build --workspace --release on Linux with 6 errors in the colibri CLI: Command::ListSkills and Command::RegisterSkill were used in the arg parser and handler but missing from the Command enum definition. Fix was adding the two variants. Full cargo test --workspace passed with 151 tests, 0 failures after the fix. FreeBSD build was never blocked because Linux caught it first.