History

Parfii-bot 5993f32146 feat(v0.22): FS warn + battle-test matrix + USB docs platform split (Track C) 1. Filesystem type detection (architect P2 finding) _primitives/_rust/keisei/src/fs_type.rs (NEW, 103 LOC) - statfs(2)-based detection on unix (libc = '0.2' under [target.'cfg(unix)'.dependencies]) - Recognizes exfat / msdos (FAT32) via f_fstypename on macOS, via f_type magic numbers on Linux (0x4d44, 0x2011bab0) - Windows stub returns Unknown (GetVolumeInformationW TBD) - warn_on_unsafe_fs(root) emits stderr warning on ExFat/Fat32 brain.rs::load calls warn_on_unsafe_fs after canonicalize+symlink checks. Warning NOT fatal — user can opt into single-client use. 2. Battle-test matrix (architect P3 finding) tests/battle/Dockerfile.install-test-alpine (NEW) - alpine:3.19 + apk rust/cargo/pandoc - Exposes musl-vs-glibc issues in aws-sdk-s3, rusqlite, git2 tests/battle/Dockerfile.install-test-debian (NEW) - debian:12 + rustup stable + pandoc - Default server distro, different apt structure from Ubuntu tests/battle/README.md rewritten — 3-distro matrix with run script 3. USB-BRAIN-GUIDE platform split docs/USB-BRAIN-GUIDE.md — restructured as TOC + platform-agnostic preamble + exFAT warning + cross-platform troubleshooting docs/USB-BRAIN-GUIDE-macos.md (NEW, 97 LOC) — Gatekeeper, diskutil, /Volumes, xattr -d com.apple.quarantine docs/USB-BRAIN-GUIDE-linux.md (NEW, 98 LOC) — /media/$USER, umount, ext4 recommended, systemd-udev auto-mount note docs/USB-BRAIN-GUIDE-windows.md (NEW, 115 LOC) — PowerShell Dismount-Volume, NTFS, FS-advisory Unknown caveat REAL VERIFICATION (paste from agent): cargo check -p keisei: Finished (clean) cargo test -p keisei --release: 32 passed 0 failed (30 existing + 2 new) docker buildx outline: both new Dockerfiles parse Constructor Pattern: fs_type.rs 103 LOC, brain.rs 198 LOC (at limit 200, held the line) All fns <30 LOC. Each USB guide sub-doc 97-115 LOC. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-04-22 20:56:42 +08:00
..
battle-entry.sh	test(v0.21): Docker battle-test infra for install.sh on fresh ubuntu:24.04	2026-04-22 18:37:55 +08:00
Dockerfile.install-test	test(v0.21): Docker battle-test infra for install.sh on fresh ubuntu:24.04	2026-04-22 18:37:55 +08:00
Dockerfile.install-test-alpine	feat(v0.22): FS warn + battle-test matrix + USB docs platform split (Track C)	2026-04-22 20:56:42 +08:00
Dockerfile.install-test-debian	feat(v0.22): FS warn + battle-test matrix + USB docs platform split (Track C)	2026-04-22 20:56:42 +08:00
README.md	feat(v0.22): FS warn + battle-test matrix + USB docs platform split (Track C)	2026-04-22 20:56:42 +08:00
verify.sh	test(v0.21): Docker battle-test infra for install.sh on fresh ubuntu:24.04	2026-04-22 18:37:55 +08:00

README.md

tests/battle — Clean-Distro Install Test Matrix

Validates install.sh on fresh container images. CI only runs --no-execute dry-runs; these battle-tests actually execute the installer against real distro package sets.

Matrix (v0.22+)

Image	libc	Dockerfile
`ubuntu:24.04`	glibc	`Dockerfile.install-test` (CI baseline)
`alpine:3.19`	musl	`Dockerfile.install-test-alpine`
`debian:12`	glibc	`Dockerfile.install-test-debian`

ubuntu is the historic baseline. alpine exposes musl-static-link quirks in rusqlite, git2, aws-sdk-s3 — crates that wrap C code and are known to behave differently under musl. debian covers the most common server deployment; its apt repo layout differs from Ubuntu, so a Debian pass rules out a "ubuntu-specific fix" regression.

Run one image

From repo root:

docker build -t keisei-battle-ubuntu -f tests/battle/Dockerfile.install-test .
docker run --rm                   keisei-battle-ubuntu   # minimal
docker run --rm -e PROFILE=core   keisei-battle-ubuntu
docker run --rm -e PROFILE=dev    keisei-battle-ubuntu
docker run --rm -e PROFILE=full   keisei-battle-ubuntu

Run the whole matrix

for distro in ubuntu alpine debian; do
    if [ "$distro" = "ubuntu" ]; then
        DF=Dockerfile.install-test
    else
        DF=Dockerfile.install-test-$distro
    fi
    docker build -t keisei-battle-$distro -f tests/battle/$DF .
    docker run --rm -e PROFILE=full keisei-battle-$distro
done

Container exits 0 = green. Any other code = investigate stdout.

What it asserts (verify.sh)

~/.claude/agents/_blocks ≥ 79
~/.claude/skills ≥ 39
~/.claude/hooks/*.sh ≥ 10 top-level
~/.claude/hooks/_lib/*.sh ≥ 2 (gate.sh + test-gate.sh, v0.17)
hooks/_lib/test-gate.sh self-test passes (11/11)
settings.json (if created) parses as valid JSON

Known quirks (2026-04-22)

kei-artifact crate fails on dev/full: copy_rust_primitive (install/lib-primitives.sh) copies src/ + tests/ only — misses sibling schemas/, so include_str!("../schemas/*.json") breaks. Install still exits 0 (build is soft-fail); primitive binary count drops (6/25 on full). Fix: copy every sibling dir the crate ships.
Ubuntu 24.04 rustc is 1.75 — too old for edition = "2024". Dockerfile installs rustup stable; apt install rustc is NOT enough.
Debian 12 rustc is 1.63 — same story. Dockerfile uses rustup.
Alpine 3.19 rustc is 1.76 — still below edition-2024's 1.85 floor; some primitives may fail to build. That failure IS what this image catches; document as "known-issue on musl" rather than patching here.
Alpine musl + aws-sdk-s3 / rusqlite / git2: static-link failures are EXPECTED on musl for the s3 / SQLite-backed primitives. Treat as matrix signal, not regression.
Apple Silicon hosts: images build linux/arm64 natively; binaries produced inside won't run on x86_64 hosts.