james.maes cf61b6bac8 feat(02-01): add Bus package with discriminated-union Codable + fixtures
- New `packages/Bus` SPM package (Swift 6 strict concurrency, WebKit linked).
- `BUS_PROTOCOL_VERSION = "2.0.0"` + shared `HudState` / `TurnTerminator` /
  `BusCoder` in `Protocol.swift`.
- `BusOutbound` (8 cases) + `BusInbound` (2 cases) with hand-written
  `Codable` using a `type` discriminator and exhaustive switches — SE-0295
  synthesized `{"case": {...}}` shape is rejected by design.
- `BusReply` plist-serializable reply + `BusError` error surface.
- 14 JSON fixtures + 24 XCTest round-trip tests asserting byte-equal
  re-encoding, shape invariants, UUID-lowercasing, and negative-path decode
  failures. All green.
- `JarvisLogChannel` gains `case bus` (OBS-06 extension per RESEARCH-07);
  `LoggingTests.test_fiveChannelsAreDefined` updated to match.
2026-04-23 17:23:02 -05:00

Jarvis

A personal, always-on macOS AI assistant styled after the Iron Man HUD. Native Swift/SwiftUI host with an embedded React + React Three Fiber HUD, driven by an agent loop that speaks Claude Opus 4.7 primarily and local Ollama (qwen2.5-coder:32b) as a first-class alternative, with MCP tool servers, fully-local voice (openWakeWord + SpeechAnalyzer + Orpheus via mlx-audio-swift), and local memory (SQLite + FTS5 + sqlite-vec). Personal use only — single user, single machine.

Status

Pre-implementation. Planning complete; Phase 1 (Foundations) is next.

Project structure

Authoritative state lives in .planning/:

Path Purpose
.planning/PROJECT.md Project context, core value, active requirements, key decisions
.planning/REQUIREMENTS.md 78 v1 requirements with REQ-IDs, mapped to phases
.planning/ROADMAP.md 8 phases with dependency DAG, goals, success criteria
.planning/STATE.md Current position, scaffold-time verifications, accumulated context
.planning/config.json GSD workflow configuration
.planning/research/ Synthesized research (stack, features, architecture, pitfalls) — see RESEARCH-DELTAS.md for corrections that supersede the primary research
.planning/source-material/ Pre-GSD artifacts (BRIEF, PLAN/IMPL-week-one rev 3, AUDIT R1–R4) preserved for reference; no longer authoritative
CLAUDE.md Project instruction for AI coding agents working in this repo

Working on this project

This is a GSD (Get Shit Done) project — planning, execution, and verification flow through /gsd-* slash commands:

/gsd-discuss-phase 1     # clarify Phase 1 approach before planning
/gsd-plan-phase 1        # decompose Phase 1 into plans
/gsd-execute-phase 1     # run the plans
/gsd-verify-phase 1      # verify success criteria

Each step commits atomically so context loss doesn't destroy work.

See CLAUDE.md for architectural decisions and collaboration conventions.

S
Description
Personal always-on macOS AI assistant in the shape of the Iron Man HUD — native Swift brain, R3F particle-ring face, voice-first, locally-grounded.
Readme MIT
7.7 MiB
0 Stars 2 Watchers 0 Forks
Languages
Swift 90.5%
TypeScript 4.7%
Shell 4%
CSS 0.5%
GLSL 0.1%
Other 0.1%