# Session Log — 2026-06-01 — Howard — Crash recovery / orientation (no code work)

## User
- **User:** Howard Enos (howard)
- **Machine:** Howard-Home
- **Role:** tech

## Session Summary

Recovery session after a crash/machine reboot. The user asked to resume prior work. No
half-finished edits existed: both the ClaudeTools parent repo and the `gururmm` submodule were
clean working trees, and no coord locks were held by this session — everything in flight before the
crash had already been committed and merged.

Reconstructed state from the two most recent Howard session logs (both 2026-05-31) and live coord
API queries. Confirmed the GuruRMM submodule tip at `69d8635` with BUG-015/SPEC-011 (ARP Programs &
Features, PRs #35/#36/#37) and the UI_GAPS reconciliation (PR #38) all merged. Surfaced four unread
coord broadcasts (verbatim), the most significant being two fresh P1 bugs filed today (13:59) by
GURU-KALI — BUG-016 (Linux systemd unit omits `/var/lib/gururmm` from `ReadWritePaths` → EROFS on
device_id persist) and BUG-017 (agent re-mints device_id on persist failure instead of caching),
both now also coord todos (`7eb7e60a`, plus server-side dedup `5ada8ff4`).

Presented the resume options: (a) the windows-update-mvp Phase 1 build (the explicit "next" from
the last log, Task 1 = DB migration + PolicyData windows_update section, build-ready in
`specs/windows-update-mvp/plan.md`), (b) BUG-016+017 paired agent/installer fix, or (c) those plus
the machine_uid server dedup. User elected to save and sync and move on to something else — no code
work performed this session.

## Key Decisions

- Did not pick up any of the GuruRMM threads; user deferred to a different task. State captured for
  a clean future resume rather than starting work that would be interrupted again.
- Did not mass-mark the four coord messages read — they are `to_session: broadcast` (21 unread
  broadcasts total), not session-targeted, so per-session read-marking does not apply.

## Problems Encountered

- **whoami-block.sh / sync.sh "not found":** an earlier diagnostic `cd projects/msp-tools/guru-rmm`
  persisted the Bash working directory into the submodule, so repo-root-relative script paths
  failed. Resolved by prefixing commands with `cd /c/claudetools`.

## Configuration Changes

- Created: `session-logs/2026-06-01-howard-crash-recovery.md` (this log). No other files touched.

## Credentials & Secrets

- None created or discovered this session.

## Infrastructure & Servers

- Coord API: `http://172.16.3.30:8001/api/coord` — queried for locks (0), status, and pending todos.
- GuruRMM submodule (`projects/msp-tools/guru-rmm`, repo `azcomputerguru/gururmm`): main at `69d8635`.

## Commands & Outputs

- `git status --short` (parent + submodule) — both clean.
- `curl -s .../coord/locks?project_key=gururmm` — `{"total":0,...}` (no locks held).
- `curl -s .../coord/todos?for_user=howard&status_filter=pending` — 13 pending, incl. GuruRMM
  BUG-017 (`7eb7e60a`), machine_uid dedup (`5ada8ff4`), agent IP capture (`7459428e`), LHM temp
  (`bde31c52`), onboarding findings[] defense-in-depth (`15ec665c`).

## Pending / Incomplete Tasks

- **GuruRMM next-up (user to choose):**
  - `windows-update-mvp` Phase 1 — Task 1 = DB migration + PolicyData windows_update section.
    Full plan in `specs/windows-update-mvp/plan.md`. The flagged "remaining big item."
  - **BUG-016** (P1) — add `StateDirectory=gururmm` (preferred) or append `/var/lib/gururmm` to the
    systemd unit `ReadWritePaths` in `agent/src/main.rs:836-852`. GURU-KALI offered to take this.
  - **BUG-017** (P1) — OnceLock-cache the device_id in `agent/src/device_id.rs:22-39` so persist
    failure doesn't re-mint. Do NOT switch to /etc/machine-id (OEM image collisions, see :7-10).
  - **machine_uid dedup** (`5ada8ff4`) — port GuruConnect SPEC-004 (machine_uid + partial unique
    index) to the RMM server so churning device_ids stop creating ghost rows.
- All prior-session pending items still stand (see 2026-05-31 Howard logs): undeployed BUG-009/011
  tails, #3 AgentDetail Client row enrich + #4 dead-endpoint removal (deferred behind build-server.sh
  BUG-003 risk), SPEC-021 build, judgment-call roadmap markings.

## Reference Information

- GuruRMM submodule tip: `69d8635`. Recent merges: #38 UI_GAPS (`0cedfe8`), #37 BUG-015 docs
  (`be0302b`), #36 DisplayIcon (`9a2245b`), #35 ARP (`07d14bd`).
- Prior session logs: `session-logs/2026-05-31-howard-gururmm-roadmap-and-features.md` (SPEC-021,
  SPEC-022, windows-update-mvp shape-spec), `session-logs/2026-05-31-howard-gururmm-roadmap.md`
  (BUG-015, SSE auth PR #31, agent IP capture PR #32).
- BUG-016/017 full entries: `docs/FEATURE_ROADMAP.md` lines 301 and 338.
- Spec folder to resume Phase 1: `specs/windows-update-mvp/` (shape/plan/references/standards.md).