Skip to content

Overnight goal: clean, polished, agent-ready homelab release #21

Description

@jusso-dev

Outcome

Leave Muster as a clean-install, credible, Buzz-simple security workspace that runs on the homelab, supports governed agent work, and has a truthful public release. This is the parent queue; not every follow-on is expected to finish in one night.

Ordered work queue

Phase 0 — stop-ship homelab stability

Exit gate: login, room load, message send/reload, and failure evidence work on the deployed image before adding product breadth.

Phase 1 — durable collaboration core

Dependency: these flows establish the durable UI/API contracts used by the smaller Buzz-inspired enhancements below.

Phase 2 — governed agent and integration foundation

Dependency: #31 precedes #25/#30. #20 precedes durable agent UX. #13 unlocks the remaining real-integration acceptance criteria in #10.

Phase 3 — small high-value collaboration improvements

Keep these bounded: one clear interaction, reuse existing data/contracts, no new dashboard or generic framework unless separately approved.

Phase 4 — first-party security agents

Dependency: build agents on #13/#20; use #17/#27 for delegation and readiness; prove their real deployed paths through #10.

Phase 5 — coherent product finish

UI direction: match Buzz's restraint and clarity, not its branding or architecture. Ordinary conversation should use rows and whitespace, not a bordered card around every message.

Phase 6 — dependency, documentation, and release handoff

Final order: dependency verification, truthful docs, then release/image/handoff proof.

Phase 7 — first-class external agent access and final polish

Dependency: complete the ordered core, agents and release handoff before #33. Complete #33 before #32 so Slack and harness usability, accessibility, documentation and operations are included in the final sweep.

Overnight operating rules

  • Work in the order above; parallelise only independent tests or surfaces.
  • Do not claim mocked, fixture-only, local-only, or browserless delivery as deployed success.
  • Keep PostgreSQL authoritative; Redis/BullMQ remain execution infrastructure.
  • Scope every domain query, subscription, export, search filter, and observer projection by organisation.
  • Dangerous actions require server-side capability checks and immutable approval records.
  • Treat external content and agent output as untrusted evidence, never instructions.
  • Write significant state changes and outbox events in one transaction.
  • Keep long-running integration and agent work outside HTTP handlers.
  • Preserve append-only messages, timelines, evidence metadata, and audit events.
  • Use idempotency keys for inbound events, jobs, message sends, and external actions.
  • Use synthetic data in tests, screenshots, documentation, Tawny actions, and Kelpie cases.
  • Never expose secrets, Codex credentials, API keys, real customer data, or private homelab details in GitHub artifacts.
  • Commit reviewable slices with a regression test for every reproduced bug.

Exit criteria

  • Fresh clean Docker install works without demo activity.
  • Homelab login and core room/message/task flows pass extensive deployed Playwright coverage.
  • The current homelab message-send error is fixed and regression-tested.
  • UI is readable, quiet, consistent, responsive, and keyboard/zoom accessible.
  • Governed Codex delegation, progress, cancellation, result review, and restart recovery work.
  • Tawny and Kelpie have real synthetic, idempotent, approval-safe integration evidence.
  • Search, thread export, activity, readiness, handoff, and reaction enhancements obey tenant/capability policy.
  • Public linux/amd64 image is anonymously pullable and matches the verified commit.
  • README and runbooks describe only tested reality.
  • Slack can invoke enabled agents with durable threaded progress, typed results, governed approvals and no duplicate delivery.
  • Hermes/MCP and custom tools can discover and invoke the same agents through the shared portable harness.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions