chore(ai): archive session record and resolved tasks

1 files changed, 84 insertions, 0 deletions

diff --git a/.ai/sessions/2026-05-31-01-11-inbox-monitoring-workflow-and-infra-fixes.org b/.ai/sessions/2026-05-31-01-11-inbox-monitoring-workflow-and-infra-fixes.org
new file mode 100644
index 0000000..5dbacef
--- /dev/null
+++ b/.ai/sessions/2026-05-31-01-11-inbox-monitoring-workflow-and-infra-fixes.org
@@ -0,0 +1,84 @@
+#+TITLE: Session — lint-org verbatim-asterisk checker fix
+#+DATE: 2026-05-30
+
+* Summary
+
+** Active Goal
+
+Post-wrap continuation of 2026-05-30 (the prior session wrapped at 86326c1). A string of infrastructure fixes driven by Craig's directives and cross-project handoffs, capped by building an inbox-monitoring system. Six commits: 4b24597, 1f79945, 9a1bea9, 143feda, e446dab, ddcde66, 8c0eca8 — all pushed.
+
+** Decisions
+
+- *Linting shouldn't flag unfixable items* (Craig's rule): fixable → fix; unfixable false positive → message rulesets' inbox about the checker + rule. Applied to the recurring verbatim-asterisk misplaced-heading false positives.
+- *Act-vs-file rule* (Craig): when I decide to act → just do it, no asking; when I decide to file → ask first, filing = option 1, "do it now" = option 2; always ask if unsure. Codified in monitor-inbox.org + protocols.org.
+- *Startup rsync skip-when-dirty* (jr-estate handoff): option 1, scoped to the synced source paths so unrelated rulesets dirt doesn't block the sync.
+- *Per-agent session-context* (Codex Phase 1): AI_AGENT_ID resolves the active path via a helper, backward-compatible (unset → the legacy singleton). Fixes the two-agents-one-project race without the broader runtime refactor.
+- *cmail-action send is the default email path* (org-drill handoff): surfaced in protocols.org; send-email.org off the msmtp heredoc; send gained --cc/--bcc + threading.
+- *Inbox monitoring as a template workflow* (Craig: "general workflow, for sure"): task-boundary cadence + opt-in background /loop + the act-vs-file rule + reply discipline, with an inbox-status script.
+
+** Data Collected / Findings
+
+- lint-org verbatim-asterisk false positives are recurring and unfixable in source — the fix is suppressing the class in the checker, not editing todo.org.
+- The startup-rsync propagation anomaly (two files missing from jr-estate) was a timeline artifact (files added in 664bf01 after jr-estate's rsync ran), not a Phase A bug.
+- cmail send was a working-but-invisible capability — an org-drill session claimed it couldn't send, then hand-rolled MIME through msmtp. Root cause: discoverability (protocols said nothing about email).
+
+** Files Modified
+
+- =lint-org.el= (+ test) — suppress verbatim-asterisk misplaced-heading (lo--verbatim-asterisk-at-line-p).
+- =startup.org= — Phase A sync guarded skip-when-dirty (scoped to synced paths), renumbered steps.
+- =session-context-path= (new script + bats), =protocols.org= / =startup.org= / =wrap-it-up.org= — AI_AGENT_ID-aware session-context path.
+- =cmail-action.py= (+ test) — --cc/--bcc/--in-reply-to/--references via build_message.
+- =protocols.org= — "Sending Email" subsection + "Inbox Monitoring Cadence" subsection; =send-email.org= Step 4 rewrite.
+- =monitor-inbox.org= (new template workflow), =inbox-status= (new script + bats), =INDEX.org= entry.
+- =todo.org= — two [#B] tasks (startup-dirty, Codex Phase 1) marked DONE.
+
+** Next Steps
+
+- *Inbox monitoring is now active* — check inbox-status at task boundaries going forward. The opt-in background =/loop= is available when unattended watching is wanted.
+- *All today's handoffs confirmed back* to their senders (jr-estate, health, work, org-drill); inbox empty.
+- *Signal MCP install at the desktop* still the oldest open carryover (GPG pinentry blocks it remotely).
+- Parked [#B]/[#C]: cross-project pattern catalog, the broader runtime-neutral arc (parent of Codex Phase 1).
+- Everything reaches downstream projects on their next template sync.
+
+* Session Log
+
+** 2026-05-30 ~17:20 CDT — post-wrap continuation: lint-org false-positive fix
+
+The prior session wrapped at 86326c1 (archived as =.ai/sessions/2026-05-30-16-06-drill-deck-anki-buildout-and-script-tests.org=). Craig then gave two post-wrap directives.
+
+First (4b24597): the wrap-up lint pass kept re-flagging two verbatim-asterisk misplaced-heading items (=** DONE=, =** Startup Pull Ordering= shown as verbatim refs in prose) that aren't fixable in todo.org. Per Craig's rule — linting shouldn't flag unfixable items; fixable→fix, else message rules' inbox — I filed a checker-bug report to this project's inbox (inbox-send excludes the sender, so a direct write) and dropped the two items from lint-followups.org.
+
+Then Craig said "fix the org checker" (1f79945). Added =lo--verbatim-asterisk-at-line-p= to =lint-org.el= (mirrors the markdown-bold detector, checks the reported line and the one before it since org-lint marks the blank line after the offender), and the misplaced-heading dispatch now suppresses verbatim-asterisk matches silently like the cj-comment case. TDD: flipped =lo-verbatim-asterisk-is-suppressed= + the mixed-fixture assertion (red), implemented (green). Updated header comments. Verified: 24/24 ERT, =lint-org --check todo.org= → judgment=0, sync-check clean, full suite 405/1skip green. Removed the now-resolved inbox bug report in the same commit. Pushed =4b24597..1f79945=.
+
+Craig then asked for a fresh session-context file (this one).
+
+** 2026-05-30 ~17:30 CDT — task 1: startup-rsync-dirty guard
+
+From jr-estate's handoff: Phase A's =rsync -a --delete= copies rulesets working-tree WIP into downstream projects when rulesets is dirty at their session start. Implemented option 1 (skip-when-dirty), scoped to the synced source paths: startup.org Phase A step 3 now guards the protocols/workflows/scripts rsyncs behind =git status --porcelain= on =claude-templates/.ai/{protocols.org,workflows/,scripts/}= — skips with a message when dirty, syncs when clean. Scoped to the synced paths so unrelated rulesets dirt (stray session-context.org) doesn't block the sync. Folded the three rsyncs into one guarded block, renumbered the Phase A list, added a Notes bullet. Verified the dirty-detection live (flagged my own WIP startup.org → skip). Resolved the reported propagation anomaly: cross-project-broadcast.org + page-signal.org were added in 664bf01 on 2026-05-29, after jr-estate's rsync ran — timeline, not a bug. Marked the [#B] task DONE. sync-check clean, suite 405/1skip green.
+
+Next: task 2 (Codex Phase 1 — AI_AGENT_ID + session-context.d/<id>.org).
+
+** 2026-05-30 ~17:45 CDT — task 2: Codex Phase 1 (AI_AGENT_ID)
+
+Fixed the singleton-session-context race backward-compatibly. New =.ai/scripts/session-context-path= helper resolves the active path from =AI_AGENT_ID=: unset → legacy =.ai/session-context.org= (one-agent default unchanged, per the spec's compatibility rule), set → =.ai/session-context.d/<sanitized-id>.org=. TDD: wrote session-context-path.bats (red, script absent), wrote the helper (green) — 5 cases (unset/empty/set/two-distinct/unsafe-chars). Wired startup.org's existence check + wrap-it-up.org's rename through the helper, each with a singleton fallback for older checkouts; wrap folds the agent id into the archive name. protocols.org documents the rule (new "Agent-scoped path" subsection). Verified the two-agent simulation (distinct paths per id) — the task's stated verification. sync-check clean, full suite 405/1skip + the 5 new bats green. Marked the [#B] task DONE. Pushed =9a1bea9..143feda=. The broader runtime-neutral arc stays parked under the parent [#C] spec.
+
+Both requested tasks (1 then 2) complete. Commits this session: 4b24597, 1f79945, 9a1bea9, 143feda (plus the wrap commit 86326c1 that closed the prior session).
+
+** 2026-05-30 ~22:00 CDT — inbox monitoring discussion + org-drill handoff (cmail discoverability)
+
+Craig asked to monitor the inbox + respond to handoffs, build infra for it, and discuss the act-vs-file rules + cadence. Discussed; Craig set the operating rule: when I decide to file → ask first (file = option 1 recommended, do-now = option 2); when I decide to act → just do it, no asking; always ask if unsure.
+
+Demonstrated the rule on the live org-drill handoff (cmail send was a working-but-invisible capability — an org-drill session claimed it couldn't send, then hand-rolled MIME through msmtp). All three asks read as act-now, so I did them, no asking:
+- #1 + #2 (ddcde66, docs): added a "Sending Email" subsection to protocols.org (cmail = default personal account, dmail = work, cmail-action send = the tool, with examples); rewrote send-email.org Step 4 off the inline-Python/msmtp heredoc to cmail-action send.
+- #3 (e446dab, feat, TDD): cmail-action send gained --cc/--bcc (repeatable) + --in-reply-to/--references via build_message; 4 new tests, test _args helper updated, 57 cmail tests + full suite 409/1skip green.
+Confirmed back to org-drill via inbox-send; inbox empty.
+
+STILL OPEN — the monitoring infrastructure build. Craig resolved the act-vs-file rule but not: (a) cadence default (proposed: check at every task boundary during a session + opt-in background /loop), (b) project-workflow vs template scope, (c) new inbox-status script vs extend cross-agent-status. Need those calls before building the monitor-inbox workflow + script.
+
+** 2026-05-31 — monitoring infrastructure built (8c0eca8)
+
+Craig: "proceed with your recommendations. general workflow, for sure." Built all three recommendations as a template (general) workflow:
+- =inbox-status= script (template, +x, mirror) — lists unprocessed handoffs (excludes .gitkeep / lint-followups.org / PROCESSED-*), exit 0 clean / 1 pending / 2 no-inbox-or-usage, =-q= count-only. 5 bats cases, live-verified.
+- =monitor-inbox.org= template workflow — the cadence (task-boundary default + opt-in background =/loop=) + the act-vs-file decision rule + the reply discipline, layered over process-inbox.org (no duplication of the value gate). INDEX.org entry added.
+- protocols.org "Inbox Monitoring Cadence" subsection (read every session) so the habit actually fires: check inbox-status at task boundaries, act-now silent / file asks (file = option 1) / ask if unsure, always reply to senders.
+Verified: sync-check clean, full suite 409/1skip + 5 new bats green. The cadence is now active — checked the inbox at this boundary (0 pending).