Commit Graph

6 Commits

Author SHA1 Message Date
471ac78a4c feat: Complete ISO build system with security features
Major updates for production-ready ISO:

1. **Debian Version**:
   - Updated to Debian 13.3.0 stable (released)
   - No longer using testing/sid
   - Using debian:stable Docker image

2. **Password Complexity Enforcement**:
   - Added libpam-pwquality and libpwquality packages
   - Password complexity enforced during install via PAM
   - Configured in security-config.sh:
     * Minimum 12 characters
     * Mixed case required
     * At least one digit
     * At least one special character
     * 3 character classes required
   - Preseed enforces password checks during installer

3. **Auto-Lock After 1 Minute**:
   - Added xautolock and xscreensaver packages
   - Configured in .xinitrc for auto-lock after 1 minute idle
   - Uses xscreensaver-command -lock for screen locking

4. **USB Drive Mounting**:
   - Added udisks2, gvfs-backends, gvfs-fuse packages
   - Created polkit rules for USB mounting
   - User added to plugdev and cdrom groups
   - USB drives mountable via file manager

5. **WiFi and Bluetooth Disabling**:
   - Created config/disable-wifi-bt.sh script
   - Blacklists all WiFi kernel modules
   - Blacklists all Bluetooth kernel modules
   - Masks bluetooth service
   - Removes bluez packages

6. **First-Boot Verification**:
   - Created scripts/verify-system.sh
   - Created config/football-first-boot.service
   - Verifies all functional requirements
   - Runs once on first boot
   - Prevents re-running via status file

7. **ISO Build System**:
   - Updated to use Debian 13.3.0 stable ISO
   - Scripts and config baked into ISO
   - Docker-based build process
   - Corrected ISO filename throughout

8. **Preseed Configuration**:
   - Manual user creation (not automated)
   - Manual password prompts (enforced via PAM)
   - Late_command applies all security configs
   - Copies verification script to target
   - Enables first-boot verification service

Files Added:
- config/disable-wifi-bt.sh (WiFi/BT disabling)
- config/security-config.sh (password complexity, auto-lock, USB mounting)
- config/football-first-boot.service (first-boot verification systemd service)
- scripts/verify-system.sh (comprehensive verification script)

Files Updated:
- config/preseed.cfg (password enforcement, security packages, late_command)
- scripts/build-iso.sh (Debian 13.3.0, correct filenames)
- docs/FUNCTIONAL-REQUIREMENTS.md (verification strategy)
- AGENTS.md (documentation references)
- README.md (documentation references)

All requirements from this session implemented:
✓ Password complexity enforced during install
✓ Auto-lock after 1 minute idle
✓ USB drive mounting enabled
✓ WiFi/Bluetooth disabled
✓ First-boot verification
✓ Scripts baked into ISO (no internet needed)
✓ All packages in ISO
✓ Debian 13.3.0 stable

💘 Generated with Crush

Assisted-by: Gemini 2.5 Flash via Crush <crush@charm.land>
2026-01-20 12:33:49 -05:00
12124707f4 docs: Update AGENTS.md for ISO-based approach
Major updates to AGENTS.md:
- Updates project status to reflect ISO build readiness
- Removes all references to debootstrap approach
- Documents ISO-based build methodology
- Updates architecture section for preseed approach
- Documents dual-artifact approach:
  1. football-installer.iso (for bare metal and VM)
  2. VM boots from ISO for testing
- Clarifies that preseed automates most installation steps

Old debootstrap approach completely replaced with ISO approach.

💘 Generated with Crush

Assisted-by: Gemini 2.5 Flash via Crush <crush@charm.land>
2026-01-20 11:53:09 -05:00
e4f19e19db docs: Add Project Orientation section to AGENTS.md
Adds comprehensive orientation section explaining:
- Project overview and purpose
- Build methodology (debootstrap-based, not ISO)
- Key design decisions
- Clarifies this is a pre-configured system, not installer

This section helps orient developers and agents to the project
structure and build approach.

💘 Generated with Crush

Assisted-by: Gemini 2.5 Flash via Crush <crush@charm.land>
2026-01-20 11:14:05 -05:00
9ad29858c5 docs: Update AGENTS.md with sfdisk issue and next steps
Updates to AGENTS.md:
- Add Issue 6: Missing sfdisk in Docker container
- Update Next Steps to reflect current build failure
- Update Docker images section with football-dev
- Update Docker containers status (none active)
- Document sfdisk root cause and proposed solution
- Update build status section with more detail

💘 Generated with Crush

Assisted-by: Gemini 2.5 Flash via Crush <crush@charm.land>
2026-01-20 11:12:49 -05:00
6182b10ba6 docs: Update AGENTS.md with accurate build status
Updates AGENTS.md to reflect actual build state:
- Last Updated: 2025-01-20
- Build status: Failed at Step 4 (sfdisk missing)
- Steps 1-3: COMPLETE (bootstrap, config, packages)
- Step 4: FAILED (partitioning)
- Added evidence of installed kernel version
- Added football-dev container information

💘 Generated with Crush

Assisted-by: Gemini 2.5 Flash via Crush <crush@charm.land>
2026-01-20 11:08:36 -05:00
Charles N Wyble
316915408e docs: add comprehensive AGENTS.md
Added comprehensive project documentation for AGENTS including:

- Complete project status and architecture
- Security model and network topology
- Compliance standards (CIS, CMMC, FedRAMP, NIST)
- Full file structure and directory layout
- All build scripts and their status
- Configuration files and validation status
- Current build progress (Step 2/5)
- Proof test results (all passed 6/6)
- Known issues and solutions applied
- Deployment procedures (VM and physical)
- Verification checklists
- Commitment to complete working system

This document provides complete orientation to project for
any AI agent or developer taking over the project.

Current Build Status:
- Script: final-simple-build.sh
- Progress: Step 2/5 (Configuring System)
- Completed: Step 1 (Debian Bootstrap)
- Remaining: 3 steps (Packages, Images, VM Test)
- Estimated: 30-45 minutes to completion

All proof tests passed, confirming Docker approach is valid.
Build is executing and progressing normally.

💘 Generated with Crush

Assisted-by: GLM-4.7 via Crush <crush@charm.land>
2026-01-13 19:36:16 -05:00