Cache dashboard header to cut menu-change re-renders

.mq/context/active-contract.md

@@ -0,0 +1,23 @@
+# Active Contract: macos-scripts
+
+## Owns
+
+* `mqlaunch` interactive and direct CLI entrypoints
+* macOS workflow menus and launchers
+* release-check and repo workflow shortcuts
+* HAL, review, and repo-status bridges
+* shell-script surface validation
+
+## Does Not Own
+
+* MQ-stack orchestration internals
+* repo scoring logic
+* durable Obsidian memory
+* MCP runtime behavior
+* source-repo feature implementation
+
+## Rules
+
+* Treat this file as routing context, not runtime truth.
+* Verify current code, tests, CLI behavior, and contracts in the target repo.
+* Do not duplicate behavior owned by another MQ repo.

.mq/context/current-blockers.md

@@ -0,0 +1,12 @@
+# Current Blockers: macos-scripts
+
+## Known Blockers
+
+* No repo-specific blocker exported in this Phase 4 seed.
+
+## Check Before Acting
+
+* Read `.mq/context/repo-card.md`.
+* Read `.mq/context/active-contract.md`.
+* Read `.mq/context/integration-map.md`.
+* Verify live repo state before making runtime or release claims.

.mq/context/integration-map.md

@@ -0,0 +1,29 @@
+# Integration Map: macos-scripts
+
+## Reads From
+
+* local MQ repos under the user workspace
+* mq-agent and mq-hal command outputs
+* repo-signal readiness outputs
+* terminal menu and launcher scripts
+
+## Writes To
+
+* terminal UI output
+* local workflow snapshots
+* shell launcher state
+* no durable memory unless routed through MQ tools
+
+## Use When
+
+* task involves `mqlaunch`
+* task involves macOS terminal menus
+* task touches release-check shortcuts
+* task needs launcher-to-repo path boundaries
+
+## Avoid Reading First
+
+* unrelated app docs
+* old menu screenshots
+* full repo READMEs
+* generated dependency logs

.mq/context/repo-card.md

@@ -0,0 +1,56 @@
+---
+schema: context-card.v1
+repo: macos-scripts
+role: macOS workflow launcher and mqlaunch operator entrypoint
+updated_at: 2026-06-19T00:00:00Z
+---
+
+# Context Card: macos-scripts
+
+## Role
+
+macOS workflow launcher and mqlaunch operator entrypoint.
+
+## Owns
+
+* `mqlaunch` interactive and direct CLI entrypoints
+* macOS workflow menus and launchers
+* release-check and repo workflow shortcuts
+* HAL, review, and repo-status bridges
+* shell-script surface validation
+
+## Does not own
+
+* MQ-stack orchestration internals
+* repo scoring logic
+* durable Obsidian memory
+* MCP runtime behavior
+* source-repo feature implementation
+
+## Reads from
+
+* local MQ repos under the user workspace
+* mq-agent and mq-hal command outputs
+* repo-signal readiness outputs
+* terminal menu and launcher scripts
+
+## Writes to
+
+* terminal UI output
+* local workflow snapshots
+* shell launcher state
+* no durable memory unless routed through MQ tools
+
+## Use this card when
+
+* task involves `mqlaunch`
+* task involves macOS terminal menus
+* task touches release-check shortcuts
+* task needs launcher-to-repo path boundaries
+
+## Avoid reading unless needed
+
+* unrelated app docs
+* old menu screenshots
+* full repo READMEs
+* generated dependency logs

.mq/context/token-budget.md

@@ -0,0 +1,16 @@
+# Token Budget: macos-scripts
+
+## Generated Context Budgets
+
+| File | Budget |
+| --- | ---: |
+| `repo-card.md` | 60 lines |
+| `active-contract.md` | 80 lines |
+| `current-blockers.md` | 80 lines |
+| `integration-map.md` | 120 lines |
+| `task-pack.md` | 200 lines |
+
+## Rule
+
+If a generated context file exceeds its budget, tighten the export instead of
+copying broad README, changelog, release-note, or vault history into it.

AGENTS.md

@@ -0,0 +1,60 @@
+# Agent Instructions For macos-scripts
+
+This repo is part of the MQ stack.
+
+These instructions add MQ memory read-order rules. They do not replace
+repo-specific build, test, safety, or release instructions.
+
+## mqobsidian Location
+
+Default local vault path:
+
+`/Users/mansys/mqobsidian`
+
+If `MQ_OBSIDIAN_DIR` is set, prefer that value.
+
+## Read Order
+
+For work related to `macos-scripts`:
+
+0. Read `.mq/context/task-pack.md` if it exists and matches the task.
+1. Read `/Users/mansys/mqobsidian/memory/learn/agent/macos-scripts.md` if it exists.
+2. Read `/Users/mansys/mqobsidian/systems/macos-scripts/hot.md` if it exists.
+3. Read `/Users/mansys/mqobsidian/systems/macos-scripts/index.md` if it exists.
+4. Read `/Users/mansys/mqobsidian/memory/learn/repos/macos-scripts.md` if it exists.
+5. Read individual pattern notes only if the compressed notes are insufficient.
+
+Stop reading as soon as the task is grounded.
+
+## Low-Token Rules
+
+* Prefer task packs and agent views over full notes.
+* Prefer hot/index over pattern notes.
+* Do not scan the whole vault by default.
+* Do not open multiple pattern notes unless clearly needed.
+* Summarize instead of replaying long note bodies.
+
+## Source-Of-Truth Rule
+
+`mqobsidian` is durable memory, not live runtime truth.
+
+If the task depends on current code behavior, tests, contracts, CLI behavior,
+or runtime state, verify in this repo before making claims.
+
+## Writing Rules
+
+When creating notes, summaries, or exports:
+
+* separate facts, interpretation, and recommendation
+* keep outputs compact
+* preserve timestamps and provenance when relevant
+* prefer links over duplicated prose
+* avoid raw dumps
+
+Do not store or copy secrets, tokens, internal hostnames, raw enterprise logs,
+or machine-specific private paths.
+
+## Fallback Rule
+
+If `mqobsidian` is missing, stale, or too weak for the task, say so and verify
+in the repo. Do not invent continuity.

CLAUDE.md

@@ -0,0 +1,60 @@
+# Claude Instructions For macos-scripts
+
+This repo is part of the MQ stack.
+
+These instructions add MQ memory read-order rules. They do not replace
+repo-specific build, test, safety, or release instructions.
+
+## mqobsidian Location
+
+Default local vault path:
+
+`/Users/mansys/mqobsidian`
+
+If `MQ_OBSIDIAN_DIR` is set, prefer that value.
+
+## Read Order
+
+For work related to `macos-scripts`:
+
+0. Read `.mq/context/task-pack.md` if it exists and matches the task.
+1. Read `/Users/mansys/mqobsidian/memory/learn/agent/macos-scripts.md` if it exists.
+2. Read `/Users/mansys/mqobsidian/systems/macos-scripts/hot.md` if it exists.
+3. Read `/Users/mansys/mqobsidian/systems/macos-scripts/index.md` if it exists.
+4. Read `/Users/mansys/mqobsidian/memory/learn/repos/macos-scripts.md` if it exists.
+5. Read individual pattern notes only if the compressed notes are insufficient.
+
+Stop reading as soon as the task is grounded.
+
+## Low-Token Rules
+
+* Prefer task packs and agent views over full notes.
+* Prefer hot/index over pattern notes.
+* Do not scan the whole vault by default.
+* Do not open multiple pattern notes unless clearly needed.
+* Summarize instead of replaying long note bodies.
+
+## Source-Of-Truth Rule
+
+`mqobsidian` is durable memory, not live runtime truth.
+
+If the task depends on current code behavior, tests, contracts, CLI behavior,
+or runtime state, verify in this repo before making claims.
+
+## Writing Rules
+
+When creating notes, summaries, or exports:
+
+* separate facts, interpretation, and recommendation
+* keep outputs compact
+* preserve timestamps and provenance when relevant
+* prefer links over duplicated prose
+* avoid raw dumps
+
+Do not store or copy secrets, tokens, internal hostnames, raw enterprise logs,
+or machine-specific private paths.
+
+## Fallback Rule
+
+If `mqobsidian` is missing, stale, or too weak for the task, say so and verify
+in the repo. Do not invent continuity.