Skip to content

feat(agent-menu): make the stack truth export reachable from the menu - #176

Open
MCamner wants to merge 1 commit into
mainfrom
mq/agent-menu-truth-export-20260806-230421
Open

feat(agent-menu): make the stack truth export reachable from the menu#176
MCamner wants to merge 1 commit into
mainfrom
mq/agent-menu-truth-export-20260806-230421

Conversation

@MCamner

@MCamner MCamner commented Aug 6, 2026

Copy link
Copy Markdown
Owner

Why

mqlaunch stack truth-export has always worked — it is in the command-mode help and forwards to mq-agent stack unchanged. But it could only be run by typing it. The stack sweep reads brain_export, reports the note as stale, and offers no way to refresh it.

That is how it went fourteen days without running. Nothing schedules it: no launchd agent, no cron, and the note history is irregular (11 Jun, 18 Jul, 19 Jul, 22 Jul, 23 Jul) — consistent with manual runs.

Change

Option 3 of the Review to Brain submenu, whose panel already declares WRITES TO mqobsidian, and which sits at option 5 of the agent menu — next to the stack sweep at 6.

┌─ Review to Brain ──────────────────────────────────────────┐
│ WRITES TO mqobsidian                                       │
│ 1. Review repo → brain      2. Signal + save to brain      │
│ 3. Stack truth export → brain                              │
│ b. Back                                                    │
└────────────────────────────────────────────────────────────┘

Why not a top-level row next to the sweep

That was the original idea, but the agent menu already holds exactly ten choices, and tools/scripts/test-all.sh step [8/9] enforces "no menu loop offers more than ten choices" across every menu — "the limit is enforced rather than recorded". An eleventh row would have failed the suite. The submenu keeps the export one keystroke from the sweep without breaking that rule.

Verification

$ bash tools/scripts/test-all.sh
[8/9] no menu option bypasses the dispatcher
[8/9] no menu loop offers more than ten choices
[PASS] Shell lint passed at warning severity (193 files)
[PASS] All selftest checks passed.

New assertion mq-agent-routing-smoke [14/14] was written first and seen red: it requires both the visible row and a numbered case that reaches _run_agent stack truth-export. The panel above is the actual rendered output, not a mock-up.

Still open

This makes the export findable, not automatic. It will read aging after a day and stale after a week again unless someone runs it.

🤖 Generated with Claude Code

`mqlaunch stack truth-export` has always worked, but the export could only be
run by typing it. The stack sweep reads brain_export and reports the note as
stale without offering any way to refresh it — which is how it went fourteen
days without running. Nothing schedules it; the note history is irregular
(11 Jun, 18 Jul, 19 Jul, 22 Jul, 23 Jul), consistent with manual runs.

Adds it as option 3 of the Review to Brain submenu, whose panel already says
WRITES TO mqobsidian and which sits at option 5 of the agent menu, next to the
sweep at 6.

Not a top-level row: the agent menu already holds exactly ten choices and
tools/scripts/test-all.sh step [8/9] enforces "no menu loop offers more than
ten choices" across every menu. An eleventh would have failed the suite.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant