an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
chore: remove repo bloat — stray screenshots, QA captures, stale docs (#107)
Chaitanya Giri33b094e912de
diff --git a/REDESIGN_PLAN.md b/REDESIGN_PLAN.mddeleted file mode 100644index d22d0b87..00000000--- a/REDESIGN_PLAN.md+++ /dev/null@@ -1,181 +0,0 @@-# Munder Difflin — Landing Redesign Plan (cubicle-inspired)--> Goal: re-skin the marketing site (`docs/index.html`) and rewrite `docs/DESIGN.md`-> to a **light, warm-paper, monospace, neo-brutalist** system in the lineage of-> [cubicle.run](https://cubicle.run). Direction chosen: **"Close to cubicle"** — match-> the palette and component language closely, while keeping MD's own identity-> (maroon brand mark, the name, the GOD/hive/MemPalace story, and the real product footage).->-> This is a deliberate **reversal** of the current DESIGN.md (which is dark, flat, rounded,-> "no offset shadows, no square corners"). The new doc replaces it wholesale.-------## 0. What cubicle does (observed, with exact tokens)--| Aspect | cubicle.run |-|---|---|-| Canvas | white `#FFF` body + cream bands `#F5F2E8` / `#F5ECD7` / `#FFFEF5`; dark band `#1B1B1B` for final CTA |-| Ink | `#1B1B1B` (text **and** borders) |-| Type | **JetBrains Mono** headings/labels/UI (hero 68px / 600 / −1.7px tracking); **Geist** sans body |-| Eyebrow | 11px mono, +3px tracking, UPPERCASE, faint ink |-| Cards | `border: 3px solid #1B1B1B`, `border-radius: 0`, `box-shadow: 10px 10px 0 #1B1B1B` |-| Buttons | square, `2px solid #1B1B1B`, yellow `#FFCA54` fill (primary) / sky `#72C2DF` (alt), mono 700 |-| Accents | yellow `#FFCA54` CTA, sky-blue `#72C2DF` headline highlight, pastel color-blocks (lilac/peach/mint/tan) per feature card |-| Structure | numbered feature cards (`01 / TEAM`): pastel top holds a mini-UI mockup, white bottom holds mono title + body; dark metadata chips; dotted-texture dark final CTA; integrations logo grid |--MD already shares the most important DNA: **JetBrains Mono**, a **gold ≈ cubicle-yellow** accent,-a **pixel-art office product**, and an **Office/paper-company** theme. "Munder Difflin is a paper-company" makes the cream-paper canvas thematically *more* on-brand than the current dark theme.-------## 1. New design tokens (`:root`)--```css-:root {- /* canvas & surfaces (light, warm paper) */- --paper: #FFFDF7; /* body */- --cream: #F5F2E8; /* primary band */- --cream-2: #F5ECD7; /* alt band */- --white: #FFFFFF; /* card bodies */- --ink-band: #1B1B1B; /* dark final-CTA band + dark video panels */-- /* ink (text + borders are the same near-black) */- --ink: #1B1B1B;- --ink-dim: #57544C; /* body/secondary */- --ink-faint: #8A867A; /* eyebrows, meta */-- /* accents */- --yellow: #FFCA54; /* primary CTA (== MD gold, kept) */- --sky: #72C2DF; /* headline highlight + alt CTA */- --maroon: #B23A4E; /* MD signature — brand mark + rare emphasis */- --maroon-deep: #6E1423;-- /* pastel card tints (one per feature) */- --lilac: #E4DEFB; --peach: #FBDDBE; --mint: #D6F3E1;- --tan: #F1E6CC; --rose: #FBE0DF; --sky-soft: #DCEFF7;-- /* neo-brutalist depth — hard offset shadows, NO blur */- --shadow-card: 10px 10px 0 var(--ink);- --shadow-btn: 4px 4px 0 var(--ink);- --shadow-chip: 3px 3px 0 var(--ink);-- /* geometry */- --border: 2px solid var(--ink);- --border-bold: 3px solid var(--ink);- --radius: 0px; /* square everywhere */-- --font-mono: "JetBrains Mono", ui-monospace, "SF Mono", Menlo, monospace;- --font-sans: "Geist", "Inter", -apple-system, system-ui, sans-serif;-- --maxw: 1200px; --pad-x: 24px;-}-```--**Fonts:** add **Geist** (400/500) + keep **JetBrains Mono** (400/500/700) in the Google-Fonts `<link>`. Inter becomes fallback only.--**Motion:** neo-brutalist press on hover — `transform: translate(-2px,-2px)` and shadow grows-(`4px→6px` btn, `10px→14px` card). Keep reveal-on-scroll and the video IntersectionObserver.-All disabled under `prefers-reduced-motion`.-------## 2. Component restyle--| Component | New treatment |-|---|---|-| **Button (primary)** | square, `--border`, `--yellow` fill, `--ink` text, mono 700, `--shadow-btn`, press-on-hover |-| **Button (ghost)** | square, `--border`, `--white` fill, `--ink` text, `--shadow-btn` |-| **Button (alt)** | sky `--sky` fill (used on the dark final-CTA band) |-| **Card** | `--white` body, `--border-bold`, square, `--shadow-card`. Feature cards = pastel top block (mini-UI/video) + white bottom (label + title + body) |-| **Eyebrow** | 11px mono, +3px tracking, UPPERCASE, `--ink-faint`, optional leading `—` |-| **Chip / badge** | `--ink` fill, `--white` mono UPPERCASE text, square, optional `--shadow-chip` |-| **Window / media frame** | `--border-bold`, square, black title bar (white mono title + 3 dots), video/terminal inside |-| **Numbered label** | `01 / THE SIMULATION` — mono, `--ink-faint`, above each feature title |-| **Focus** | 2px `--ink` (or `--sky`) square outline, 2px offset |-------## 3. `docs/index.html` — section-by-section--> Same content/sections and the 4 videos stay. This is a **re-skin + restructure**, not a rewrite-> of the message. Order: `nav → hero → why → what → how → claude → open source → install → support → FINAL CTA (new) → footer`.--1. **Nav** — cream/paper bg, 2px black bottom border on scroll. Maroon square `MD` mark + `MUNDER DIFFLIN` mono wordmark. Links in ink. Right: ghost `★ Star` + yellow `⤓ Download` (square, black border).--2. **Hero** — cream bg with a faint dotted/grid paper texture.- - Bordered mono chip: `⚡ LOCAL · OPEN SOURCE · macOS`.- - H1 `Local Multi-Agent Harness` (JetBrains Mono, ~64px, −1.7px) with **one word in sky-blue** (`Multi-Agent` highlighted), rest ink.- - Sub in Geist, `--ink-dim`.- - CTA row: yellow `Download free · macOS` + ghost `★ Star on GitHub`.- - Trust line.- - **Hero video** below the CTA: `hero.webm` in a 3px-black square window with a black title bar (`munder-difflin — the floor` + live chip). (Already below CTA — keep.)--3. **Why** (3 problem cards) — 3-up neo-brutalist cards, each a different pastel tint (rose / lilac / peach), square emoji tile + mono H3 + body. Hard offset shadows.--4. **What** (statement) — big mono statement on cream, ink with **gold + maroon + sky** highlights on the key nouns (`hive mind`, `long-term memory`, `GOD orchestrator`). Keep the widened `max-width: 38ch`.--5. **How** (3 rows → cubicle feature cards) — each row = pastel color-block panel holding the **video** + white panel with numbered label + mono title + body:- - `01 / THE SIMULATION` — sky-soft tint — `how-agents.webm`- - `02 / THE MEMORY` — lilac tint — `how-mempalace.webm`- - `03 / THE ORCHESTRATION` — peach/tan tint — `how-god-hive.webm`- - Videos keep their dark backgrounds → read like cubicle's dark terminal panels inside light cards.--6. **Claude ecosystem** — keep the 2 cards, restyle neo-brutalist; **add an integrations-style logo grid** (cubicle's strongest borrowed pattern): "Plugs into Claude Code, your skills, and MCP servers" → square bordered tiles (Claude Code, MCP, skills, hooks, subscription). Terminal block restyled as a dark panel inside a black-bordered card.--7. **Open source** — bordered blockquote on cream, mono, with the MIT line; yellow + ghost CTAs.--8. **Install** — dark terminal panel (`#1B1B1B`) inside a 3px-black square card on cream; mono tokens (teal/gold/mint) preserved.--9. **Support + patrons** — neo-brutalist cards; OnlyGains / AnimeBlip patrons as square bordered cards with hard shadow.--10. **FINAL CTA band (NEW)** — full-width dark `#1B1B1B` band with dotted texture (cubicle's closer). Big mono headline e.g. *"Run your own office of agents."* with a **sky-blue** word, sub, and a **yellow** square CTA. MD currently lacks this high-converting closer.--11. **Footer** — cream, mono, copyright left + links + `hello@…` email right (underlined). Keep parody disclaimer.-------## 4. `docs/DESIGN.md` — rewrite map--The current doc is the *anti-cubicle*; it must be replaced, not patched. Rewrite:--- **Header/Direction** — "light, warm-paper, monospace, neo-brutalist, in the lineage of cubicle.run; keeps MD's maroon mark + Office parody for identity."-- **§1 Principles** — invert: paper canvas; mono-forward; hard offset shadows + square corners as the depth language; one playful accent system (yellow CTA + sky highlight + pastel feature tints); product-led via real footage.-- **§2 Color** — new token table above (paper/cream/ink/yellow/sky/maroon/pastels).-- **§3 Type** — JetBrains Mono display/labels + Geist body; add Geist to font loading.-- **§4 Spacing/radius/depth** — `radius: 0`; hard offset shadows (`4/10px 0`); 2–3px ink borders.-- **§5 Components** — square neo-brutalist buttons/cards/chips/windows + press-on-hover.-- **§6 "How it works"** — pastel feature cards holding the videos (keep on-screen-only playback).-- **§7 Layout** — add the dark final-CTA band; integrations grid; light section bands (cream/white alternating, one dark band).-- **§9 A11y** — ink-on-cream contrast; yellow CTA AAA with ink text; **sky-blue used only on large display text** (low contrast at body size); square focus rings.-- **§11 Asset inventory** — videos stay "Used"; note posters; maroon mark retained.-- Bump *Last updated*.-------## 5. Build order & verification--1. Rewrite `:root` tokens + base + nav + buttons; swap fonts. QA in browser (light render).-2. Hero (chip, sky highlight, square video window).-3. Why / What / How (pastel feature cards + videos).-4. Claude / OSS / Install / Support / patrons.-5. Add dark final-CTA band + footer.-6. Rewrite `docs/DESIGN.md`.-7. QA pass: desktop + mobile screenshots over `python3 -m http.server`, check no horizontal overflow, contrast on yellow/sky, all 4 videos still play, focus rings, reduced-motion.--**Self-contained:** `docs/index.html` is one file with an inline `<style>`. Changes are large but-contained; videos, IntersectionObserver, and reveal logic are reused as-is.-------## 6. Risks / decisions--- **Looks-like-a-clone risk** (chosen direction is "close"). Mitigations baked in: keep maroon- brand mark + name, keep gold (not cubicle's exact yellow is fine — they're near-identical), keep- MD's own copy + GOD/hive/MemPalace story + real pixel footage. Don't copy cubicle's section wording.-- **Sky-blue contrast** — only on large headline words, never body.-- **Hard reversal of DESIGN.md** — intended; old doc is replaced.-- **Geist dependency** — adds one font family; falls back to Inter if it fails to load.-```diff --git "a/Screenshot 2026-06-01 at 2.08.34\342\200\257AM.png" "b/Screenshot 2026-06-01 at 2.08.34\342\200\257AM.png"deleted file mode 100644index e2c9d430..00000000Binary files "a/Screenshot 2026-06-01 at 2.08.34\342\200\257AM.png" and /dev/null differdiff --git "a/Screenshot 2026-06-01 at 2.30.45\342\200\257AM.png" "b/Screenshot 2026-06-01 at 2.30.45\342\200\257AM.png"deleted file mode 100644index 8168bc38..00000000Binary files "a/Screenshot 2026-06-01 at 2.30.45\342\200\257AM.png" and /dev/null differdiff --git a/blog/screenshots/index-desktop.png b/blog/screenshots/index-desktop.pngdeleted file mode 100644index 9049f251..00000000Binary files a/blog/screenshots/index-desktop.png and /dev/null differdiff --git a/blog/screenshots/index-mobile.png b/blog/screenshots/index-mobile.pngdeleted file mode 100644index 87cb5794..00000000Binary files a/blog/screenshots/index-mobile.png and /dev/null differdiff --git a/blog/screenshots/post-desktop.png b/blog/screenshots/post-desktop.pngdeleted file mode 100644index abafac49..00000000Binary files a/blog/screenshots/post-desktop.png and /dev/null differdiff --git a/blog/screenshots/post-mobile.png b/blog/screenshots/post-mobile.pngdeleted file mode 100644index fc321004..00000000Binary files a/blog/screenshots/post-mobile.png and /dev/null differdiff --git a/blog/screenshots/post2-desktop.png b/blog/screenshots/post2-desktop.pngdeleted file mode 100644index 4d74a3ad..00000000Binary files a/blog/screenshots/post2-desktop.png and /dev/null differdiff --git a/blog/screenshots/post2-mobile.png b/blog/screenshots/post2-mobile.pngdeleted file mode 100644index 9d86c1c3..00000000Binary files a/blog/screenshots/post2-mobile.png and /dev/null differdiff --git a/docs/TESTING-since-v0.2.7.md b/docs/TESTING-since-v0.2.7.mddeleted file mode 100644index 032df828..00000000--- a/docs/TESTING-since-v0.2.7.md+++ /dev/null@@ -1,537 +0,0 @@-# Feature Testing — everything added since v0.2.7--This document is a practical, hands-on test guide for every feature added to **`munder-difflin`**-(the multi-agent "office floor" of CLI coding agents; the god orchestrator is **Michael**) since-the `v0.2.7` tag. It covers the released **v0.2.8** features (shareable hires + The Hiring Fair)-**and** the unreleased work that currently lives only on local **`main`** — the dev build.--**How to run.** All of this is exercised by launching the dev build:--```bash-npm run dev # electron-vite dev — opens the macOS desktop app-```--> This is a macOS desktop app. The features below are on local `main` (an unreleased dev build);-> there is no published release that contains them yet.--**External setup needed for a few features (called out per-section):**-- **Voice / VDE** — a **Groq API key** (Settings → General → *Free Flow*).-- **Slack-triggered worker** — a **Slack app + bot token + a public tunnel** (Settings → General → *Slack*).-- **Integrations end-to-end** — a **real API token** for the service you add (e.g. a GitHub PAT).- Everything else (UI, validation, broker plumbing) can be exercised without one.-------## Table of contents--- [A. Shareable hires (v0.2.8)](#a-shareable-hires-v028)-- [B. The Hiring Fair — community gallery (v0.2.8)](#b-the-hiring-fair--community-gallery-v028)-- [C. Selectable agent engines + per-hire capabilities](#c-selectable-agent-engines--per-hire-capabilities)-- [D. Agent Gallery (in-app)](#d-agent-gallery-in-app)-- [E. Onboarding — feature-aware first-run + permissions & reliability](#e-onboarding--feature-aware-first-run--permissions--reliability)-- [F. Reliability on wake](#f-reliability-on-wake)-- [G. Command Center IA + UX fixes (voice tooltip, visible installer)](#g-command-center-ia--ux-fixes-voice-tooltip-visible-installer)-- [H. Slack → god-triggered ephemeral isolated worker (Phase 1)](#h-slack--god-triggered-ephemeral-isolated-worker-phase-1)-- [I. Integrations registry + loopback secret broker (Phase 2)](#i-integrations-registry--loopback-secret-broker-phase-2)-- [J. Worker lifecycle hardening — Workers tab + GC + token-cap (Phase 4)](#j-worker-lifecycle-hardening--workers-tab--gc--token-cap-phase-4)-- [K. Temporal skills + capability catalog (Phase 3)](#k-temporal-skills--capability-catalog-phase-3)-- [L. VDE prototype + Groq AI assist (experimental)](#l-vde-prototype--groq-ai-assist-experimental)-- [Quick smoke test (15 min)](#quick-smoke-test-15-min)-------## A. Shareable hires (v0.2.8)--**What it is.** Import a role-configured agent from a portable `munder-difflin/hire@1` JSON-manifest — either via a `munderdifflin://hire?src=<https-manifest-url>` deep link or via an-*import hire…* button that reads a local manifest file; import only **pre-fills** the Add-Agent-modal, it never auto-spawns.--**Prerequisites:** none for the local-file path. The deep-link path needs a packaged build for the-protocol to be OS-registered (`electron-builder.yml` registers the `munderdifflin` scheme); in-`npm run dev` the local-file path is the reliable one to exercise.--**Steps to test — local file import (works in dev):**-1. Grab a manifest file. Either download one from the gallery (feature B) or use a `.hire.json`- from `docs/hires/manifests/` (e.g. `pam-designer.hire.json`).-2. In the app, click **Add agent** to open the Add-Agent modal.-3. In the modal, click **`import hire…`** and pick the `.json` file.-4. Observe the form pre-fill and the imported banner.-5. Review the pre-filled fields — **especially the `command`** — then click **`spawn`** only if you- want it to run.--**Steps to test — deep link (packaged build, or `munderdifflin://` registered):**-1. Host a manifest at an `https://` URL (the gallery serves these as static files).-2. Open `munderdifflin://hire?src=https://munderdiffl.in/hires/manifests/<file>.json`.-3. The main process fetches + validates it (https-only, manual-redirect re-validation, 64 KB cap,- 10 s timeout, ≤5 hops) and queues it; the renderer pulls it on mount and pre-fills the modal.--**Expected result:**-- ✓ The Add-Agent modal opens **pre-filled** behind a banner: `📋 hire imported: <name>` (with- `· by <author>` when present) and the line `review every field — especially the command — before spawning.`-- ✓ Nothing spawns on import — spawning is a separate, explicit **`spawn`** click.-- ✓ A hostile manifest is rejected before it can do harm: `provider: "custom"` is refused (provider- must be `claude` / `antigravity` / `codex`); only flags in the **default-deny allowlist**- `SAFE_FLAG_NAMES` (`--model`, `--max-turns`, `--output-format`, `--verbose`) survive; `model` must- match `MODEL_RE` (no shell metacharacters); the binary always comes from your local provider preset.-- ✓ Manifest fetch is **https-only** (http allowed only for `127.0.0.1` / `localhost`), with SSRF- blocks on private/loopback/link-local/metadata addresses.--> Validator + schema: `src/shared/hire.ts` (`HIRE_SPEC_V1` = `"munder-difflin/hire@1"`,-> `SAFE_FLAG_NAMES`, `MODEL_RE`); local-file/fetch + SSRF guard: `src/main/hire.ts`; deep-link parse:-> `parseHireDeepLink()` in `src/shared/hire.ts`; UI: `src/renderer/src/components/AddAgentModal.tsx`.-------## B. The Hiring Fair — community gallery (v0.2.8)--**What it is.** A static community gallery of ready-made roles at-[`munderdiffl.in/hires`](https://munderdiffl.in/hires/) (source `docs/hires/`, no build step) you can-browse, toggle by engine, and download a manifest from to import back into the app.--**Prerequisites:** none (a browser). To open it locally, serve `docs/hires/`:-`cd docs/hires && python3 -m http.server 8080` then visit `http://127.0.0.1:8080`.--**Steps to test:**-1. Open `https://munderdiffl.in/hires/` (or the local server above).-2. Browse the seed roles. Use the **function filters** to narrow, and use the per-card **provider- toggle** to switch between **Claude Code / Antigravity / Codex** (each base manifest derives a- per-provider variant client-side).-3. Pick a role and click its **download** control (the `⤓` button) to save the variant's- `.hire.json`.-4. Bring it into the app via feature A's **`import hire…`** path.--**Expected result:**-- ✓ The seed roles render — the gallery now ships ~20 (e.g. developer, designer, sales, feedback- collector, customer support, social-media manager, QA, PR-reviewer, security, migrations), each- with a Claude / Antigravity / Codex toggle.-- ✓ Model suggestions are data-driven from `docs/hires/models.json` (a one-line update adds a model).-- ✓ The downloaded `.json` validates against the same dependency-free validator the app uses- (`docs/hires/validator.js`, mirrored from `src/shared/hire.ts`) and the schema in- `docs/hires/spec/`.-- ✓ The gallery is static HTML/JS — importing happens by **download → re-import locally** (no- auto-fetch from the page).-------## C. Selectable agent engines + per-hire capabilities--**What it is.** Michael's underlying engine is selectable (Claude Code / Codex / Antigravity, plus-proxy-bridged `qwen`), pickable at onboarding and changeable later; and an imported hire-can declare bundled skills / MCP servers that surface a consent UI before anything is enabled.--**Prerequisites:** none to see the pickers. Running a non-Claude engine requires that engine's CLI-installed (see feature G — the installer now runs visibly if the binary is missing).--**Steps to test — pick Michael's engine at onboarding:**-1. On first run (or after resetting onboarding), reach **STEP 2 OF 5 · MICHAEL'S ENGINE** in the- onboarding wizard.-2. Choose an engine from the radio list (`godProvider`). **Claude Code** carries a **`RECOMMENDED`**- badge; only inbox-capable engines are offered.-3. Pick a model from the dropdown (seeded with each preset's `recommendedOrchestratorModel`, e.g.- `claude-opus-4-8[1m]` for Claude) and continue.--**Steps to test — change Michael's engine later:**-1. Select **Michael** (the god orchestrator) in the floor; open the **Command Center**.-2. On Michael's agent card use the **`engine:`** dropdown (and the model dropdown next to it).-3. Click **`apply`**.-4. Confirm the prompt: *"This restarts Michael; a conversation on a different engine can't be resumed."*--**Steps to test — per-hire MCP/skills consent:**-1. Import a hire (feature A) whose manifest declares `skills` and/or `mcpServers`.-2. In the Add-Agent modal review block, observe how the capabilities are surfaced.--**Expected result:**-- ✓ Engine options come from `AGENT_PROVIDER_PRESETS` (`src/shared/agentProvider.ts`):- `claude`, `codex`, `antigravity`,- `qwen` (proxy → OpenAI-shaped API via `OPENAI_BASE_URL`), `custom`.-- ✓ Changing the engine restarts Michael (no cross-engine resume) after the confirm dialog.-- ✓ Hire capabilities show a graded consent UI: **safe, read-only** MCP servers are pre-enabled (blue- badge); **write/secret** servers show an orange `⚠️ MCP (needs your consent — NOT auto-enabled)`- badge and are **not** auto-enabled (enable later in Settings → MCP). Bundled skills shipped with the- hire show as green badges.-- ✓ Bundled skills are shipped via `extraResources` (`resources/skills` → `<resources>/skills` in- `electron-builder.yml`); MCP catalog lives in `src/shared/mcpCatalog.ts` (safe-readonly: e.g.- sequential-thinking, time, fetch, context7, filesystem, git; write/secret: github-token, db,- email-calendar, search-with-key).--> Files: `src/shared/agentProvider.ts`, `src/shared/mcpCatalog.ts`,-> `src/renderer/src/components/OnboardingWizard.tsx` (engine step),-> `src/renderer/src/components/CommandCenterPanel.tsx` (change-engine on Michael's card),-> `src/renderer/src/components/AddAgentModal.tsx` (consent UI).-------## D. Agent Gallery (in-app)--**What it is.** A set of ready-made off-the-shelf hires (originally six, now ~20 manifests; formerly-"The Hiring Fair", rebranded **Agent Gallery**) you can grab and spawn in one click via the Add-Agent-flow.--**Prerequisites:** none.--**Steps to test:**-1. Note the **READY-MADE HIRES → Agent Gallery** tile on the onboarding welcome screen ("Grab a- pre-configured agent from the Agent Gallery and spawn it in one click").-2. Click **Add agent** to open the Add-Agent modal.-3. Click **`import hire…`** and pick one of the six bundled manifests from `docs/hires/manifests/`- (developer / designer / sales / feedback / support / social).-4. Review the pre-filled fields and click **`spawn`**.--**Expected result:**-- ✓ ~20 roles are available as ready-made manifests in `docs/hires/manifests/` (e.g. `ryan-developer`,- `pam-designer`, `michael-sales`, `toby-feedback`, `erin-support`, `kelly-social`, `dwight-qa`,- `jim-pr-reviewer`, `creed-security`, `stanley-migrations`), each with a sensible model.-- ✓ The flow is identical to feature A's local import — review-then-spawn, never auto-spawn.--> The "Agent Gallery" is the renamed Hiring Fair; the in-app entry point is the **`import hire…`**-> button in `AddAgentModal.tsx`, sourcing the six manifests in `docs/hires/manifests/`.-------## E. Onboarding — feature-aware first-run + permissions & reliability--**What it is.** A first-run wizard that introduces the office's features and ends on a dedicated-**Permissions & Reliability** step explaining how agents keep working while you're away.--**Prerequisites:** none. To replay it after first run, reset onboarding (Settings → General, or clear-the onboarding flag) and relaunch.--**Steps to test:**-1. Launch a fresh install (or reset onboarding) and walk the wizard:- **MEET YOUR OFFICE → STEP 1 HARNESS HOME → STEP 2 MICHAEL'S ENGINE → STEP 3 YOUR REPOS →- STEP 4 AUTO MODE → STEP 5 PERMISSIONS & RELIABILITY → ALL SET.**-2. On the welcome screen, read the feature tiles (this is the "feature-aware" part — it advertises- ready-made hires, the gallery, etc.).-3. On **STEP 5 OF 5 · PERMISSIONS & RELIABILITY**, toggle each row and read its description.--**Expected result:**-- ✓ The Permissions & Reliability step exposes four controls:- - **KEEP WORKING WHILE AWAY** — strong keep-alive (`strongKeepalive`), off by default, "uses more- battery — best on power."- - **DESKTOP NOTIFICATIONS** — macOS asks permission the first time one fires.- - **OPEN AT LOGIN** — relaunch after reboot so scheduled missions resume.- - **STAY AWAKE ON POWER (MANUAL)** — instruction-only, with an **open Battery settings** button- (`x-apple.systempreferences:com.apple.preference.battery`), because macOS won't let the app flip- Energy settings itself.-- ✓ The copy explains that on full sleep, timers pause and **catch up on wake** (nothing lost, may- run late) — tying directly into feature F.--> File: `src/renderer/src/components/OnboardingWizard.tsx` (step type:-> `welcome | home | orchestrator | repos | auto | permissions | done`).-------## F. Reliability on wake--**What it is.** When the Mac sleeps/locks, schedules and terminals freeze; on wake the app **catches-up missed schedules exactly once** and **auto-revives wedged terminals** instead of leaving them-dead.--**Prerequisites:** an actual sleep/wake cycle (or close-lid). Optional: enable **KEEP WORKING WHILE-AWAY** (`strongKeepalive`) from onboarding or Settings to test the stronger blocker.--**Steps to test:**-1. With at least one agent terminal live and a recurring mission scheduled (Schedules tab), set a- mission due in a few minutes.-2. Put the Mac to sleep (or close the lid) past that due time, for several minutes.-3. Wake the Mac and watch the floor.--**Expected result:**-- ✓ On resume, each overdue mission fires **exactly once** (coalesced catch-up — no replay burst),- via the `onSystemResume()` / `syncMissions` path; always-on beats (heartbeat / fleet / breaker)- re-arm.-- ✓ ~15 s after wake, a liveness probe (`kill(pid,0)`, no auto-kill) flags any **wedged** PTYs and- emits a `power:resume` IPC.-- ✓ The renderer auto-respawns exactly those wedged terminals — same agent id, cwd/worktree, command,- with `--resume` to reattach the CLI session — so they self-heal instead of needing a manual- **Restart & Continue**. Healthy PTYs are untouched; a resume+unlock burst is debounced (per-PTY 8 s)- so a terminal can't double-respawn.--> Commits: `dd9ea5f` (main: powerMonitor wiring + catch-up), `d7f09aa` (renderer: auto-revive-> listener). Files: `src/main/index.ts`, `src/main/hive.ts` (renderer-side revive).-------## G. Command Center IA + UX fixes (voice tooltip, visible installer)--**What it is.** Three independent UX fixes: the Add-Agent modal's many config fields are grouped into-a sectioned sidebar; the Free Flow voice button now shows **disabled with a tooltip** when no Groq-key is set; and a missing engine CLI is **installed visibly** in the agent's own terminal.--**Prerequisites:** none. (Installer test is easiest if the target engine's CLI is genuinely missing.)--**Steps to test — Add-Agent IA:**-1. Click **Add agent**. Note the left sidebar index with four sections: **Identity / Workspace /- Engine / Briefing**, one shown at a time, with the hire-import banner and footer pinned.-2. Leave a required field blank and submit — the modal **auto-jumps** to the section holding the- offending field (it can never be trapped in an unopened section).--**Steps to test — Free Flow voice button tooltip:**-1. In Settings → General → **Free Flow**, enable Free Flow but leave the **Groq API key** empty.-2. Open an agent composer and hover the **voice** button.--**Steps to test — visible engine-CLI installer:**-1. Add an agent whose engine CLI is not installed (e.g. Codex when `codex` isn't on PATH).-2. Spawn it and watch its terminal.--**Expected result:**-- ✓ Add-Agent: sectioned IA, wide-rectangle layout, every field/validation/spawn path unchanged; the- Monitor tab grid and an Ask Me dismiss affordance are also fixed.-- ✓ Voice button: stays **visible but disabled** with tooltip *"Add a Groq API key in Settings → Free- Flow to use voice mode."* (With Free Flow's master toggle **off**, the button is not rendered at- all.) It never starts a recording, so `getUserMedia` and the Groq STT call are never reached.-- ✓ Installer: instead of dying with `— process exited (code 1) —`, the terminal prints a banner and- **runs the provider's install command visibly** (e.g. `npm i -g @anthropic-ai/claude-code` for- Claude) so you can watch it and complete any interactive sign-in, then click **restart & continue**.--> Commits: `eaed9fb` (Add-Agent IA), `d96d651` (voice tooltip), `cc49e1e` (visible installer).-> Files: `src/renderer/src/components/AddAgentModal.tsx`,-> `src/renderer/src/components/MessageQueueComposer.tsx`, `src/shared/agentProvider.ts`-> (`installCommand`), `src/main/pty.ts`.-------## H. Slack → god-triggered ephemeral isolated worker (Phase 1)--**What it is — the flagship.** A Slack message spins up a **fresh, isolated worker** in its own git-worktree + isolated env; it runs to completion, replies in-thread, then tears down — **preserving any-unintegrated work** rather than discarding it.--**Prerequisites (external setup required):**-- A **Slack app** with a bot token (`xoxb-…`), a signing secret, and event subscriptions, plus a- **public tunnel** for the inbound webhook. Configure these in **Settings → General → Slack**- (`slackEnabled`, `slackSigningSecret`, `slackBotToken`, `slackChannelId`, `slackPort` default- `3847`). Use the **open Slack connect steps** help in that panel.-- Full walkthrough: the existing Slack setup tutorial — `blog/src/posts/run-ai-agent-hive-from-slack-setup.md`- and `blog/src/posts/trigger-ai-agents-from-slack.md` (published at- `docs/blog/run-ai-agent-hive-from-slack-setup` / `docs/blog/trigger-ai-agents-from-slack`).--**Steps to test (with Slack configured):**-1. In **Settings → General → Slack**, fill the fields and **start** Slack; wait for the tunnel to- report `listening` and verify the Request URL shows Slack's green check.-2. Open the **Workers** tab in the Command Center (feature J) to watch live.-3. Post a message that mentions the bot / lands in the configured channel.-4. Observe the lifecycle and check the Slack thread for the reply.--**Local-only partial check (no Slack):** You can confirm the plumbing without Slack by reading the-spawn loop — the main process polls `HIVE_ROOT/spawn-requests/` every ~1.5 s-(`WORKER_TICK_MS = 1500`) and the worktree mount dir is `<harnessHome>/worktrees/` (the repo also-ignores `.worktrees/`). The Workers tab renders "No workers running right now." until one spawns.--**Expected result:**-- ✓ A Slack message (validated by HMAC + replay-dedup) creates a spawn request; `processSpawnRequest`- spawns an **isolated worker** via `spawnAgentCore` in a fresh `agent/<id>` worktree- (`addWorktree()` in `src/main/git.ts`).-- ✓ The worker does the job and **posts a substantive reply** into the originating Slack thread (via- the loopback-only reply helper), then signals `act:"done"` to god.-- ✓ Teardown is **safe**: `finalizeWorkerWorktree()` checks `worktreeHasUnintegratedWork()` and only- removes the worktree when there's nothing to keep; otherwise it's tracked in `preservedWorktrees`- (surfaced under **Preserved worktrees** in the Workers tab) and reclaimed later once the work lands.-- ✓ A **stale-done guard** (`workerSignaledDone`) only releases a worker on a `done` authored **after**- its own spawn time, so a previous worker's signal can't prematurely release a new one.--> Commits: `22fce6f` (spawn→reply→safe teardown), `13c5435` (teardown-safety gate), `a2f2e45`-> (stale-done guard). Files: `src/main/index.ts`, `src/main/slack.ts`, `src/main/git.ts`,-> `src/main/pty.ts`, `src/main/hive.ts`.-------## I. Integrations registry + loopback secret broker (Phase 2)--**What it is.** Add an integration (from a template or a custom REST API) with a **write-only, masked**-secret; a spawned worker reaches it **credential-free** through a local loopback broker that injects-the real secret upstream — the secret never enters the worker's env or any response.--**Prerequisites:** none to add/configure/test the UI plumbing. A successful **Test connection** and a-real upstream call need a **real API token** for the chosen service.--**Steps to test — add + test an integration:**-1. Open **Settings → Integrations**.-2. Pick a template from the gallery (or **custom-rest** for any HTTP API) and click **`continue →`**.-3. Fill the label / base URL / auth header as needed, then **paste your secret** into the masked- field (toggle **show/hide**; an existing secret shows a saved pill with **Replace key**).-4. Click **`Save integration`**.-5. Click **`Test connection`** (a live, read-only probe against the base URL with the stored secret).--**Steps to test — a worker reaches it via the broker:**-1. Spawn a worker (e.g. via Slack, feature H). The harness injects `MD_BROKER_URL` and- `MD_BROKER_TOKEN` into that worker's env.-2. From inside the worker, call the integration credential-free:- ```bash- curl -H "Authorization: Bearer $MD_BROKER_TOKEN" "$MD_BROKER_URL/i/<integrationId>/<path>"- ```- (The header `X-MD-Broker-Token: $MD_BROKER_TOKEN` is also accepted.)--**Expected result:**-- ✓ The Integrations UI lists 9 templates from `INTEGRATION_TEMPLATES` (`src/shared/integrations.ts`):- **github, custom-rest, linear, jira, notion, stripe, confluence, sentry, hubspot**. (Gmail, Google- Calendar, Salesforce are **deferred to v1.1** — OAuth.)-- ✓ The secret is **write-only/masked**: it's stored encrypted, shown as a saved pill, and never- echoed back into the form.-- ✓ Test connection returns `✓ Connected (<status>)` or `✕ <error>`; status renders per-row too.-- ✓ The broker route is `/i/<integrationId>/<path>` (regex `^/i/([^/?#]+)(?:/([^?#]*))?...` in- `src/main/integrationBroker.ts`). The path is **origin-confined** — absolute URLs, host overrides,- and `..` traversal are rejected (the `47e78a6` SSRF/secret-exfil fix) — so the broker is not an- open proxy.-- ✓ **Security guarantee:** the real secret is materialized only at forward-time inside the broker- (`getSecret(rec.secretRef)`), injected into the **upstream** request, and never logged, never- returned to the worker, never placed in the worker's env. The worker holds only the short-lived- broker token.--> Preload bridge (`a253bb5`) exposes `integrationsTemplates / integrationsList / integrationsUpsert /-> integrationsSetSecret / integrationsRemove / integrationsTest`. Files:-> `src/main/integrationBroker.ts`, `src/main/integrations.ts`, `src/shared/integrations.ts`,-> `src/renderer/src/components/IntegrationsRegistry.tsx`, `src/preload/index.ts`, `src/main/index.ts`-> (env injection `MD_BROKER_URL` / `MD_BROKER_TOKEN`).-------## J. Worker lifecycle hardening — Workers tab + GC + token-cap (Phase 4)--**What it is.** A **Workers** tab in the Command Center that lists live ephemeral workers-(status/age/tokens) with a **stop** control, plus auto-GC of torn-down worktrees once their work-integrates (never GCing unintegrated work), and a per-worker token cap that **defaults to unlimited**.--**Prerequisites:** none to view the tab. To see live rows you need a worker spawning (feature H).--**Steps to test:**-1. Open the **Command Center** and select the **`workers`** tab (last tab, gear icon).-2. With no workers running, confirm the empty state.-3. Spawn a worker (feature H) and watch a row appear under **Live workers** (`N / max`).-4. Click **`stop`** on a row to tear it down by hand.-5. If a torn-down worker left unintegrated work, find it under **Preserved worktrees**; once that- work lands in its base branch, confirm it disappears (auto-reclaimed).--**Expected result:**-- ✓ The tab is labeled **`workers`** and lives in the Command Center tab strip- (`CommandCenterPanel.tsx`).-- ✓ Each live row shows a status badge (**working** / **stopping**), the worker name, a `slack` chip- when it replies to a thread, the worker/PTY id, `base: <branch>`, `up <age>`, `idle <age>` (or- `pty gone`), and `tokens <n> · uncapped` (or `/ <cap>`). A **`stop`** button reads `stopping…`- while tearing down.-- ✓ **Preserved worktrees** lists finished workers whose worktree held un-integrated work — "kept- (never auto-discarded) and auto-reclaimed once the work lands." GC is fail-safe- (`gcPreservedWorktrees()` → `worktreeIsGcSafe()`): it reclaims only when the tree is clean **and**- either 0 commits ahead or the tree is identical to base.-- ✓ Token cap defaults **off**: `defaultWorkerTokenCap: 0` (`0 = unlimited`) in `src/main/config.ts`;- the mechanism is wired (reaped only when `tokenCap > 0`) but does nothing by default — rows show- `· uncapped`.--> Commit: `d670856`. Files: `src/renderer/src/components/WorkersTab.tsx`,-> `src/renderer/src/components/CommandCenterPanel.tsx`, `src/main/config.ts`, `src/main/index.ts`,-> `src/main/git.ts`.-------## K. Temporal skills + capability catalog (Phase 3)--**What it is.** Bundled, read-only worker skills that resolve named time windows to concrete ISO date-ranges relative to invoke time, plus a `/capabilities` catalog every spawned worker reads at boot.--**Prerequisites:** none — they run with plain `node` (no network, no writes).--**Named window skills bundled** (`resources/skills/`): `today`, `yesterday`, `thisWeek`, `lastWeek`,-`last7Days`, `last30Days`, `thisMonth`, `lastMonth`, `thisQuarter`, `lastQuarter`, `thisYear`,-`lastYear` — plus the umbrella `temporal` skill and the read-only `capabilities` catalog. (The-`temporal` resolver also understands `last90Days`, `last12Months`, and arbitrary-`lastNdays`/`lastNweeks`/`lastNmonths`.)--**Steps to test (locally, no app needed):**-1. From the repo root, run the resolver directly:- ```bash- node resources/skills/temporal/when.mjs last30Days- node resources/skills/temporal/when.mjs --json last7Days- node resources/skills/temporal/when.mjs --list- ```-2. Inside a spawned worker, the same skill is at `$AGENT_DIR/.claude/skills/temporal/when.mjs`, and a- worker invokes the named shortcut (e.g. `/last30Days`) which calls this resolver for that one- window.--**Expected result:**-- ✓ `/last30Days` resolves a rolling 30-day window ending today and prints a human line plus a JSON- record, e.g.:- ```json- {- "window": "last30Days",- "start": "2026-05-21",- "end": "2026-06-19",- "inclusive": true,- "startUtc": "2026-05-20T18:30:00.000Z",- "endExclusiveUtc": "2026-06-19T18:30:00.000Z",- "days": 30,- "timezone": "Asia/Calcutta",- "asOf": "<resolve instant>"- }- ```- (Exact dates/timezone reflect your clock and locale.)-- ✓ Convention holds: `this*` windows are **period-start → today** (to-date); `last*` named periods- are the **full prior complete period**. Output gives both inclusive civil dates and a half-open- `[startUtc, endExclusiveUtc)` for timestamp queries.-- ✓ Every spawned worker reads the read-only **`/capabilities`** catalog at boot, which documents its- env (`AGENT_ID`, `AGENT_DIR`, `HIVE_ROOT`), the temporal skills, and how to reach integrations via- the loopback broker (feature I) credential-free.--> Commit: `0791a45`. Files: `resources/skills/temporal/SKILL.md` + `when.mjs`, the per-window-> `resources/skills/<window>/SKILL.md`, and `resources/skills/capabilities/SKILL.md`.-------## L. VDE prototype + Groq AI assist (experimental)--**What it is — EXPERIMENTAL / PROTOTYPE, not a shipped UI surface.** A standalone static prototype of-a Virtual Dev Environment under `prototypes/vde/`, plus a main-process Groq chat-completion module-(`src/main/groq.ts`) intended to back its "AI assist." Neither is imported by the app, and there is no-in-app entry point.--**Prerequisites:** a browser for the prototype. The Groq module would need a Groq API key, but it is-**not wired to any UI**, so you cannot exercise it through the app.--**Steps to test (the only available way — open the static prototype):**-1. Serve and open the prototype directly:- ```bash- cd prototypes/vde && python3 -m http.server 8081- ```- then visit `http://127.0.0.1:8081`.-2. Use the **screen switcher** (top-left chips: `A Full IDE`, `B Empty`, `C Palette`, `D AI Diff`,- `E Daylight Split`, `F Zen`) and the Code/Vibe/Terminal/Zen layout toggles to view the static- screens.--**Expected result:**-- ✓ The prototype renders a multi-screen static IDE mockup (no real editing, no agent wiring) — it's a- design dump, four files, no dependencies.-- ✓ `src/main/groq.ts` exists as a self-contained module (`groqChat()`, default model- `llama-3.1-8b-instant`, endpoint pinned to `https://api.groq.com/...`, key used only in the- `Authorization` header, never logged/returned, suggestion-text-only with no fs/pty side effects) —- but **no renderer/preload/`index.ts` code calls it**, so there is no shipped path to trigger it.-- ✓ Treat this as preview-only: it is intentionally not part of the app's navigable UI.--> Commits: `11bdf12` (Groq module), `db2b03d` (VDE prototype + reference doc dumps). Files:-> `prototypes/vde/{index.html,app.js,styles.css,tokens.css}`, `src/main/groq.ts`. (`docs/r/*.json`-> are reference data dumps, also not imported by app source.)-------## Quick smoke test (15 min)--A fast confidence pass that touches the highest-value features end to end.--1. **Launch.** `npm run dev` — the app opens.-2. **Onboarding + engine pick (E, C).** Walk the wizard; at **STEP 2 · MICHAEL'S ENGINE** pick an- engine + model; at **STEP 5 · PERMISSIONS & RELIABILITY** read the four reliability toggles.- Finish to **ALL SET**.-3. **Add a gallery hire (D, A).** Click **Add agent → `import hire…`**, pick a manifest from- `docs/hires/manifests/` (e.g. `pam-designer.hire.json`), confirm the **imported** banner pre-fills- the modal, then click **`spawn`**.-4. **Add + test an integration (I).** **Settings → Integrations** → pick **github** (or- **custom-rest**) → **`continue →`** → paste a token (a real PAT to actually pass) → **`Save- integration`** → **`Test connection`** and read the status.-5. **Temporal skill (K).** In a terminal: `node resources/skills/temporal/when.mjs last30Days` —- confirm a concrete ISO range comes back.-6. **Workers tab (J).** Open the **Command Center → `workers`** tab and confirm the live/preserved- layout (empty state if no Slack worker is running).--If all six steps behave as described, the core of the v0.2.7→`main` feature set is healthy. The two-features that need external services to fully exercise are **Slack workers (H)** — needs a Slack app +-bot token + tunnel — and a fully green **integration Test (I)** — needs a real API token. The **VDE /-Groq assist (L)** is prototype-only and has no in-app surface.diff --git a/docs/screenshots/after-desktop.png b/docs/screenshots/after-desktop.pngdeleted file mode 100644index 884633d9..00000000Binary files a/docs/screenshots/after-desktop.png and /dev/null differdiff --git a/docs/screenshots/after-mobile.png b/docs/screenshots/after-mobile.pngdeleted file mode 100644index 232b09be..00000000Binary files a/docs/screenshots/after-mobile.png and /dev/null differ