gabriel / musehub public
docker-restart-docs-agent-config.md markdown
50 lines 2.3 KB
Raw
sha256:34035d72cef530c1ab9d6a6f53be18d803dde705fc3157617d70352a96d0747b Merge branch 'fix/wire-push-external-parent-manifest' into dev Human 8 days ago

Add Docker container restart/rebuild guidance to musehub's .muse/agent.md

Background

During the MWP-9 spot-check investigation (musehub#113), significant time was lost because musehub_worker (the background job container) was silently running a Docker image dated over a month old, while musehub (the API container) had been restarted recently. Nothing in the agent-facing docs distinguished the two containers — only musehub's restart was a documented habit. This produced misleading investigation results for a long stretch before the staleness was caught.

What was done

Added a rewritten "Localhost Containers" section to musehub/.muse/agent.md — the source file muse agent-config sync reads to regenerate CLAUDE.md / AGENTS.md / .cursorrules / .windsurfrules. Covers:

  • Both musehub and musehub_worker must be restarted together after any code change — never just one.
  • A concrete freshness-verification recipe (container uptime, image build timestamp, and specific log lines to grep for) to run before trusting any local test result, not after debugging goes sideways.
  • When a plain docker restart is enough (bind-mounted .py edits) vs. when a full docker compose build is required (Dockerfile, dependency, or compose-file changes).
  • Two distinct schema-migration failure modes surfaced in the same session (DB behind existing migrations vs. an ORM model with no migration ever generated for it) and the correct recipe for each.

Applied and verified in this session via muse agent-config sync --force and muse agent-config status (both report in sync).

Deliverables

  • [x] Rewrite musehub/.muse/agent.md's "Localhost Container" section (done, this session).
  • [x] Regenerate adapters via muse agent-config sync --force (done, confirmed in sync).
  • [ ] Confirm this content actually reaches other machines/checkouts the way muse agent-config sync is expected to distribute it — flagged as a follow-up check, not resolved in this ticket, since the goal here was capturing the missing verbiage, not auditing the distribution mechanism itself.

Out of scope

  • Auditing whether .muse/agent.md is tracked/pushed by muse itself — noted as an open follow-up above, not investigated further here.
File History 4 commits
sha256:34035d72cef530c1ab9d6a6f53be18d803dde705fc3157617d70352a96d0747b Merge branch 'fix/wire-push-external-parent-manifest' into dev Human 8 days ago
sha256:fc04e4cae9e1774d6a21b65c45daeed0e6787eb581d13aa1b03bfe9384a34226 Merge branch 'fix/two-column-scroll-layout' into dev Human 8 days ago
sha256:408916fc5973ba59c6e4eebaa80ebdcc801c0a63205651e25009d11548f79454 chore: bump version to 0.2.0.dev2 — nightly.2, matching muse Sonnet 4.6 patch 11 days ago
sha256:d035733f21ccff27735fddebfbbe0ed24565a32a22db8de5885402262671ecd2 chore: bump version to 0.2.0rc15 for musehub#113 fix release Sonnet 4.6 patch 14 days ago