Commit Graph

223 Commits

Author SHA1 Message Date
06ac00e64c docs(apt): Add public repo staging design (ref #80)
Brainstormed design for staging a signed APT repo at output/repo/
with amd64 + arm64 (mochabin) packages for bookworm, using existing
Go CLI and shell tooling. No network operations - user pushes
artifacts to apt.secubox.in out-of-band.

Layered build: base -> tier-lite -> tier-standard -> tier-pro
GPG: persistent ~/.gnupg/secubox/
License: CMSD-1.0 embedded in staged tree

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 09:02:51 +02:00
e6189bbaa5 docs(opad): add implementation plan for doctrine documents
7-task plan to create 5 OPAD doctrinal documents:
1. Directory structure
2. JSON Schema (opad-profile.schema.json)
3. Pydantic models (models.py + tests)
4. OPAD.md core doctrine
5. CSPN.matrix.md threat matrix
6. OPAD-OPERATIONS.md operational guide
7. Final validation

Reference: CM-WALL-OPAD-2026-05

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-12 08:54:53 +02:00
5ccf862f05 docs(opad): Add OPAD doctrine design specification
Design spec for 5 OPAD doctrinal documents:
- OPAD.md: Core doctrine, invariants, injection primitives
- CSPN.matrix.md: Threat × capability matrix for ANSSI
- opad-profile.schema.json: 3-prong profile JSON Schema
- models.py: Pydantic equivalents for FastAPI
- OPAD-OPERATIONS.md: Operational guide

Reference: CM-WALL-OPAD-2026-05
Version: 2.4.0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-12 08:39:42 +02:00
cf328e5a42 docs: add implementation plan for APT and Clone commands 2026-05-11 06:10:20 +02:00
fcca5a7dce docs: add design spec for secubox apt and clone commands
Hybrid approach:
- Client operations (apt setup, clone) in pure Go
- Server operations (apt init/publish/sync) wrap existing shell scripts

Features:
- secubox apt: full repo management + client setup
- secubox clone: interactive bootstrap wizard for new systems

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-11 05:44:35 +02:00
ddd87e55c7 feat(secubox): add manifest generator
- Define Manifest struct with kernel, partitions, boot, output
- Implement Generate() from Profile and Board
- Add ToYAML() for serialization with header comments

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-10 21:08:32 +02:00
3335a5053f docs: Add Meta-Script Generator implementation plan
17 tasks with TDD approach:
- Go CLI with cobra/viper (gen, build, fetch, ota, info)
- Profile loader with inheritance merger
- Board configuration and tweaks
- Package scanner for debian/secubox.yaml
- Manifest and Makefile generation
- Interactive wizard with promptui
- Hardware detection
- APT repository with lintian compliance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-10 20:00:56 +02:00
da706eeb28 docs: Add Meta-Script Generator v2.0.0 design spec
Design specification for secubox CLI tool:
- Go-based unified CLI (gen, build, fetch, ota)
- Profile hierarchy with hardware detection
- Package self-description (debian/secubox.yaml)
- A/B partition OTA with auto-rollback
- Dual APT repo (apt.secubox.in + apt.gk2.secubox.in)
- Multi-arch with lintian compliance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-10 19:56:50 +02:00
d90afdc22d docs(migration): Add implementation plan for OpenWrt to Debian migration
26 tasks, 135 steps covering:
- Phase 1: LXC/storage/network preparation
- Phase 2: Container creation (mail, nextcloud, matrix, gitea)
- Phase 3: Data sync (certs, configs, databases, mailboxes)
- Phase 4: Cutover procedure with verification

Includes rollback procedure and summary checklist.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-05 12:35:41 +02:00
a9199d1f40 docs(migration): Add OpenWrt to Debian migration design spec
Big Bang migration plan from C3BOX (OpenWrt) to SecuBox-DEB (Debian):
- 4 phases: Prepare, Build, Sync, Cutover
- LXC containers for Mail, NextCloud, Matrix, Gitea
- Host-native gateway services (HAProxy, CrowdSec, nftables)
- Data migration strategy for 94 SSL certs + service data
- Cutover procedure with rollback plan

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-05 12:31:36 +02:00
0b705981e9 docs(plan): Add mitmproxy WAF migration implementation plan
15 tasks covering complete module migration:
- Package scaffold and debian files
- Configuration (TOML + WAF rules JSON)
- mitmproxyctl CLI for LXC management
- secubox_waf.py threat detection addon
- FastAPI routers (status, settings, alerts, haproxy, waf)
- WebUI pages (status, settings, filters)
- Nginx configuration
- README documentation

Session 90

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-03 07:48:38 +02:00
9e1bbfb173 docs(spec): Add mitmproxy WAF migration design specification
Design spec for migrating mitmproxy WAF module from OpenWrt to Debian:
- WAF-in mode only (HAProxy backend inspection)
- Single unified secubox-mitmproxy package
- LXC container with secubox_waf.py threat detection addon
- 18 FastAPI endpoints for status, alerts, HAProxy integration, WAF rules
- CrowdSec integration for automatic IP banning
- Full WebUI with status, settings, and filters pages
- TOML configuration format

Session 90

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-03 07:42:43 +02:00
814325dc83 docs(plan): HAProxy WebUI CRUD implementation plan
11 tasks with 37 steps covering:
- Modal system and toast notifications
- Form validation and API error handling
- VHost CRUD (add/edit/delete)
- Backend CRUD (add/edit/delete)
- Server CRUD (nested under backends)
- Certificate CRUD (request/delete)
- Table enhancements with action buttons

Single file modification pattern maintained.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-02 17:51:09 +02:00
6210fd3591 docs(spec): HAProxy WebUI enhancement design
Design spec for adding CRUD operations to HAProxy dashboard:
- VHost management (add/edit/delete)
- Backend management with nested servers
- Certificate request and deletion
- Modal system with P31 Phosphor theme
- Toast notifications for feedback
- Client-side validation

Approach A: Minimal Enhancement (~450 lines in single file)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-02 17:48:05 +02:00
133837f017 docs: Add Eye Remote Swiss Army implementation plan
21 tasks across 6 phases:
- Phase 1: Core Infrastructure (Mode manager, failover, renderer)
- Phase 2: Display Modes (Dashboard, Local, Flash, Gateway)
- Phase 3: Web Remote Server (FastAPI, routes, control.html)
- Phase 4: System Controls (WiFi, Bluetooth, display)
- Phase 5: Advanced Features (device manager, remote control, fleet)
- Phase 6: Integration & Polish (main.py, WebSocket, testing)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-26 17:07:08 +02:00
582a2d5702 docs: Add Eye Remote Swiss Army Dashboard design spec
- 4 operating modes: Dashboard, Local, Flash, Gateway
- Web Remote control at :8080 (touchless)
- Auto-detect + flag file override for mode switching
- Staged failover with visual feedback
- Unified Python Agent architecture

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-26 17:01:20 +02:00
7838ffa1f1 docs: Add Eye Remote touchscreen controller implementation plan
13-task TDD implementation plan covering:
- MenuItem and MenuState data models
- Static menu definitions for 6-slice radial menus
- MenuNavigator state machine
- Slice detection from touch coordinates
- RadialRenderer for framebuffer display
- ActionExecutor with LocalAPI integration
- TouchHandler menu mode integration
- Component wiring in main.py
- Menu icon generation
- Comprehensive test coverage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-24 10:06:35 +02:00
ba8edad728 docs: Add Eye Remote touchscreen controller design spec
Comprehensive design for radial menu touch interface:
- 6-slice pie navigation optimized for circular display
- Dual-scope control (local Pi Zero + remote SecuBox)
- Gesture-based interaction (tap, swipe, long press)
- Hierarchical menu structure with dynamic data loading
- Error handling and visual feedback patterns

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-24 09:36:26 +02:00
67afb50034 docs(eye-remote): add bootstrap v2.1.0 implementation plan
14-task plan for mass_storage LUN + TFTP shadow channel:
- T1-T2: gadget-setup.sh and systemd service
- T3-T5: Pydantic models, core logic, FastAPI router
- T6: dnsmasq TFTP configuration
- T7: U-Boot documentation
- T8-T9: Debian packaging and build script
- T10: Integration tests
- T11-T14: Wiki and documentation updates

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-23 10:30:05 +02:00
ff9dd27d65 docs(eye-remote): Add bootstrap v2.1.0 design specification
Design spec for adding mass_storage LUN + TFTP shadow channel:
- USB composite gadget: ECM + ACM + mass_storage concurrent
- 4R double-buffer: active/shadow slots with atomic swap
- FastAPI /boot-media/ endpoints for upload/swap/rollback
- dnsmasq TFTP serving shadow slot for testing
- Shell (gadget-setup.sh) + Python (core/boot_media.py) split

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-23 10:23:19 +02:00
cca602da56 docs: Add integration test guide for Eye Remote v2.0.0
Complete testing guide covering:
- Gateway emulator installation and usage
- Unit test execution (13 tests)
- Agent-gateway integration testing
- API module verification
- Troubleshooting section

Part of Eye Remote v2.0.0 implementation (Task 14).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-21 11:11:26 +02:00
e1d496641e docs: Add Eye Remote v2.0.0 implementation plan
14 tasks across 4 phases:
- Phase 1: Eye Remote Agent (config, HTTP client, metrics bridge, device manager)
- Phase 2: SecuBox Module (models, registry, token manager, API routers)
- Phase 3: Gateway Tool (CLI, emulator, server)
- Phase 4: Packaging & Integration (Debian, build script, e2e test)

Each task includes TDD approach with failing tests first,
complete code, exact file paths, and commit instructions.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-21 08:41:31 +02:00
7d46e9a0ad docs: Add Eye Remote integration design specification
Comprehensive spec for Eye Remote ↔ SecuBox integration:
- secubox-eye-agent: Multi-SecuBox connection manager
- secubox-eye-remote: SecuBox management module + WebUI
- secubox-eye-gateway: Dev emulator + fleet gateway
- Device token auto-authentication
- Touchless pairing via QR code
- Bidirectional control (Eye can control SecuBox)
- SSH auto-provisioning
- Screenshot, OTA, serial console features

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-04-21 08:32:35 +02:00