v0.7.1: behavioral framework system + 3 new CLI adapters + identity polish

Combined release covering v0.6.0 -> v0.7.0 -> v0.7.1 work landed on
the private dev branch since public's last sync at v0.5.2.

## v0.7.1 highlights

- OpenWar v0.3.0 vendored at presets/frameworks/openwar.md with
  vendor-trace header
- npm run update-frameworks: pulls pinned upstream tags, lints fetched
  content (em-dashes + forker-extensible sanity patterns), writes to
  presets/frameworks/
- Mid-conversation framework switch confirmation modal
- 'Framework not found' graceful degrade with inline chat toast (no
  more 500s)
- Demo seed acme-website thread now opens with Phase 0 brief +
  Confirmation Summary, demonstrating OpenWar gating before Phase 1
- Electron bundle now includes presets/ (fixes the missing-framework
  crash on packaged installs)

## v0.7.0 highlights

- Framework registry + per-channel framework override + global default
- OpenWar bundled and auto-seeded for cold-clone installs
- Framework picker in channel header chip and onboarding wizard
- API: GET /api/frameworks, POST /api/frameworks
- 3 new CLI adapters: OpenClaw, Hermes, SemaClaw. All probe binary on
  PATH for genuine isConfigured() reporting
- Brand-mark SVGs at public/agent-logos/ for all 7 adapters
- New <AgentAvatar> component renders the right mark per bubble/seat
- sendMessage now layers framework preamble / cross-agent context /
  user prompt as three opt-in overlays

## v0.6.0 highlights

- Right-click rail-server context menu (rename, icon, color)
- Personal workspace icon auto-derives from display name
- useIdentityVersion + IdentityHydrator: name/label changes propagate
  to chat / boardroom / team-presence live, no page reload
- Customizable agent label (onboarding.agentName)

## Release-session cleanup

- update-frameworks script's sanity-pattern list rewritten generic
  (was operator-specific in the live build). Forkers extend via
  WAR_ROOM_FRAMEWORK_SANITY_PATTERNS env var. Zero personal-data
  hits on the public sweep.
- DEFERRED.md added to .gitignore (builder-session-internal, never
  public).
- README OpenWar cross-link preserved from earlier public commit.

Sanity regex clean. Em-dash sweep clean across all shipped markdown.
Local build verified.

Author: PythonLuvr

.gitignore

@@ -57,3 +57,4 @@ notes.txt
 /playwright-report/
 /blob-report/
 /playwright/.cache/
+DEFERRED.md

CHANGELOG.md

@@ -8,6 +8,56 @@ For full details on any release, see the corresponding entry on [GitHub Releases
 
 ---
 
+## [0.7.1] - 2026-05-16
+
+Patch on v0.7.0. Bundled OpenWar bumped to upstream v0.3.0, mid-conversation framework switch confirmed via modal, graceful degrade when a framework file is missing.
+
+### Added
+- **Vendored OpenWar v0.3.0** at `presets/frameworks/openwar.md` with a vendor-trace header noting upstream tag and commit SHA. Replaces the v0.1-era draft that shipped in v0.7.0.
+- **`scripts/update-frameworks.mjs`** (`npm run update-frameworks`). Fetches pinned tags of registered upstream frameworks, lints fetched content for em-dashes and personal-data patterns, writes to `presets/frameworks/`. Manual invocation only. Sanity patterns are forker-extensible via the `WAR_ROOM_FRAMEWORK_SANITY_PATTERNS` env var.
+- **Mid-conversation framework switch modal** in the channel header chip. Explains the contract (next turn uses the new framework, existing context stays as-is). Esc cancels, Enter confirms.
+- **Inline "framework not found" toast** in chat when a channel pins a framework whose markdown file isn't bundled. Graceful degrade to no framework instead of 500.
+- **Demo seed Phase 0 turns:** the acme-website multi-agent thread now opens with a brief + Confirmation Summary exchange, demonstrating the OpenWar framework's gating behavior before the Phase 1 execution continues.
+
+### Changed
+- `lib/frameworks.ts` registry gains a `refresh` flag on `listFrameworks()` and an exported `refreshFrameworkCache()` so dev-watcher and test scenarios can drop the in-process cache without restarting the process.
+- README "Behavioral framework" section describes the framework system, the update workflow, and the graceful-degrade rules.
+
+### Fixed
+- **Bundled frameworks now ship in the packaged Electron installer.** `next.config.ts` adds `presets/**/*` to `outputFileTracingIncludes`, `electron/after-pack.js` copies `presets/` into the standalone bundle, and `lib/frameworks.ts` resolves the dir robustly across cwd and the module's `__dirname` ancestors. Fixes the "Page couldn't load" crash on v0.7.0's first NSIS install where the embedded Next server crashed trying to read missing framework files.
+
+## [0.7.0] - 2026-05-16
+
+Behavioral framework system + three new CLI adapters + brand-mark logos throughout the UI.
+
+### Added
+- **Framework registry** + per-channel framework override + global default setting (`channel_overrides.framework_preset`, `default.framework`).
+- **OpenWar bundled** as the default framework, auto-seeded for cold-clone installs.
+- Per-channel framework picker in the chat-header AI chip (next to the context-mode controls).
+- Framework picker in the onboarding wizard's Agent step.
+- API: `GET /api/frameworks` (list + default), `POST /api/frameworks` (set global default or per-channel pin).
+- OpenWar logo (`public/openwar-logo.svg`). Heater-shield silhouette with a four-bar phase-stack, sibling to the War Room mark.
+- **Three new CLI adapters**: OpenClaw, Hermes (Nous Research), SemaClaw (midea-ai). All probe via `where`/`which` so the green-dot signal in the UI means "binary genuinely on PATH," not just "setting non-empty."
+- Brand-mark SVGs at `public/agent-logos/` for Claude, OpenAI, Gemini, Grok, OpenClaw, Hermes, SemaClaw. Adapters carry an `iconUrl` field; channel chat bubbles, boardroom seats, and right-panel agent rows render the matching mark.
+- Reusable `<AgentAvatar>` component.
+
+### Changed
+- `sendMessage` in `lib/agents/index.ts` now layers prompt overlays in three positions: framework preamble (outermost), cross-agent context (middle), user prompt (innermost). Each layer is opt-in per channel; defaults skip them so the single-agent flow is unchanged.
+- Onboarding wizard's Agent step is a multi-adapter setup form instead of a single-pick picker. Paste keys / set binary paths for as many providers as you want in one pass.
+
+### Fixed
+- `isConfigured()` on all CLI adapters now genuinely probes whether the binary exists on PATH (`where`/`which` with 30s cache), instead of returning true for any non-empty setting. Fixes the earlier confusion where every CLI showed green-dot regardless of install state.
+
+## [0.6.0] - 2026-05-16
+
+Identity polish. Customizable display name, agent label, server icon. Changes propagate live without page reload.
+
+### Added
+- Right-click context menu on any rail server icon. Edit modal for rename, change icon, change color. The War Room server stays locked to the brand mark and violet palette.
+- Personal workspace icon auto-derives from display name (first letter) on wizard completion. `ServerProvider` listens for `war-room:identity-changed` to refresh in place.
+- `useIdentityVersion()` hook + `IdentityHydrator` component so the display name and agent label propagate to chat bubbles, boardroom seats, and team-presence rows on wizard finish without a page reload.
+- Customizable agent label (`onboarding.agentName`). Defaults to `${displayName}-Agent`; user can rename in the wizard's Identity step or under Settings → General.
+
 ## [0.5.2] - 2026-05-15
 
 Hotfix. v0.5.1 broke production builds across every OS/Node combo in CI.
@@ -141,6 +191,9 @@ First public release.
 - Optional Electron desktop wrapper.
 - Optional self-hosted LiveKit boardroom voice channel.
 
+[0.7.1]: https://github.com/pythonluvr/war-room/releases/tag/v0.7.1
+[0.7.0]: https://github.com/pythonluvr/war-room/releases/tag/v0.7.0
+[0.6.0]: https://github.com/pythonluvr/war-room/releases/tag/v0.6.0
 [0.5.2]: https://github.com/pythonluvr/war-room/releases/tag/v0.5.2
 [0.5.1]: https://github.com/pythonluvr/war-room/releases/tag/v0.5.1
 [0.5.0]: https://github.com/pythonluvr/war-room/releases/tag/v0.5.0

app/api/agents/route.ts

@@ -14,6 +14,9 @@ const SETTINGS_KEYS = [
   "agent.cli.claude.bin",
   "agent.cli.codex.bin",
   "agent.cli.gemini.bin",
+  "agent.cli.openclaw.bin",
+  "agent.cli.hermes.bin",
+  "agent.cli.semaclaw.bin",
   "agent.cli.custom.bin",
   "agent.cli.custom.template",
   // API keys + models
@@ -59,6 +62,7 @@ export async function GET() {
       kind: a.kind,
       capabilities: a.capabilities,
       isConfigured: a.isConfigured(),
+      iconUrl: a.iconUrl ?? null,
     })),
   });
 }

app/api/channel-context/route.ts

@@ -0,0 +1,34 @@
+import { NextRequest, NextResponse } from "next/server";
+import { setChannelContextSettings, type ChannelContextMode } from "@/lib/db";
+
+export const dynamic = "force-dynamic";
+export const runtime = "nodejs";
+
+// Update the cross-agent context mode + budgets for a single channel.
+// Channel ids contain slashes (e.g. "user/foo"), so the id rides in the
+// body instead of the URL.
+export async function POST(req: NextRequest) {
+  const body = (await req.json()) as {
+    channelId?: string;
+    mode?: ChannelContextMode;
+    messages?: number;
+    chars?: number;
+  };
+  const channelId = body.channelId?.trim();
+  if (!channelId) {
+    return NextResponse.json({ error: "channelId required" }, { status: 400 });
+  }
+  const patch: { mode?: ChannelContextMode; messages?: number; chars?: number } = {};
+  if (body.mode === "isolated" || body.mode === "shared") patch.mode = body.mode;
+  if (typeof body.messages === "number" && Number.isFinite(body.messages)) {
+    patch.messages = body.messages;
+  }
+  if (typeof body.chars === "number" && Number.isFinite(body.chars)) {
+    patch.chars = body.chars;
+  }
+  if (Object.keys(patch).length === 0) {
+    return NextResponse.json({ error: "no fields to update" }, { status: 400 });
+  }
+  setChannelContextSettings(channelId, patch);
+  return NextResponse.json({ ok: true });
+}

app/api/dashboard/route.ts

@@ -210,6 +210,7 @@ function topSessions(limit = 5) {
 }
 
 async function recentFiles(limit = 8) {
+  if (isDemo()) return demoRecentFiles(limit);
   const roots = [
     ...STATIC_WORKSPACES.map((w) => w.path),
     CLIENTS_ROOT,
@@ -222,6 +223,25 @@ async function recentFiles(limit = 8) {
   return items.slice(0, limit);
 }
 
+function demoRecentFiles(limit: number) {
+  // Synthetic recently-touched list. Mirrors the project paths used by
+  // the activity seeder so the file rows feel like they came from the
+  // same work shown elsewhere on the dashboard.
+  const now = Date.now();
+  const m = (h: number) => now - h * 3600 * 1000;
+  const files = [
+    { path: "/demo/projects/acme-website/src/app/contact/schema.ts", name: "schema.ts", mtime: m(0.5), size: 1842 },
+    { path: "/demo/projects/q3-redesign/notes/2026-q2-discovery.md", name: "2026-q2-discovery.md", mtime: m(2), size: 12_408 },
+    { path: "/demo/projects/studio-motion-pack/scenes/hero-loop-03.aep", name: "hero-loop-03.aep", mtime: m(3.5), size: 4_980_222 },
+    { path: "/demo/projects/side-project-beta/copy/waitlist-confirmation.md", name: "waitlist-confirmation.md", mtime: m(6), size: 2_104 },
+    { path: "/demo/projects/platform-migration/runbooks/cutover.md", name: "cutover.md", mtime: m(9), size: 8_722 },
+    { path: "/demo/projects/acme-website/tailwind.config.ts", name: "tailwind.config.ts", mtime: m(14), size: 3_310 },
+    { path: "/demo/projects/studio-brand-system/tokens/oklch-map.json", name: "oklch-map.json", mtime: m(20), size: 1_540 },
+    { path: "/demo/projects/sara-onboarding-redesign/research/interviews-week-2.md", name: "interviews-week-2.md", mtime: m(28), size: 18_910 },
+  ];
+  return files.slice(0, limit);
+}
+
 async function walk(
   dir: string,
   out: Array<{ path: string; name: string; mtime: number; size: number }>,
@@ -247,17 +267,23 @@ async function walk(
 }
 
 export async function GET() {
+  // Demo mode skips the SSH probe entirely — without VPS credentials it
+  // would just block the dashboard load for the SSH timeout each call.
+  // KPI numbers are synthesized further below.
+  const healthPromise = isDemo()
+    ? Promise.resolve(null)
+    : getHealthReport();
   const [clients, health, perServer, files] = await Promise.all([
     countActiveClients(),
-    getHealthReport(),
+    healthPromise,
     perServerStats(),
     recentFiles(8),
   ]);
   const sessions = listSessions();
-  const vpsOnline = health.vps.error
+  const vpsOnline = !health || health.vps.error
     ? 0
     : health.vps.services.filter((s) => s.status === "online").length;
-  const vpsTotal = health.vps.error ? 0 : health.vps.services.length;
+  const vpsTotal = !health || health.vps.error ? 0 : health.vps.services.length;
 
   // Demo mode: synthesize VPS counts + team presence + approvals so the
   // KPI strip looks like a real operator's daily view instead of zeros.
@@ -267,7 +293,7 @@ export async function GET() {
   const teamOnline = demo ? 3 : 1;
   const vpsOnlineFinal = demo ? 4 : vpsOnline;
   const vpsTotalFinal = demo ? 5 : vpsTotal;
-  const vpsError = demo ? null : (health.vps.error ?? null);
+  const vpsError = demo || !health ? null : (health.vps.error ?? null);
 
   return NextResponse.json({
     kpi: {

app/api/frameworks/route.ts

@@ -0,0 +1,58 @@
+import { NextRequest, NextResponse } from "next/server";
+import { listFrameworks, readFramework } from "@/lib/frameworks";
+import { getSetting, setChannelFrameworkPreset, setSetting } from "@/lib/db";
+
+export const dynamic = "force-dynamic";
+export const runtime = "nodejs";
+
+// GET /api/frameworks
+//   Lists every bundled framework preset + the current global default.
+// GET /api/frameworks?id=openwar&content=1
+//   Returns the markdown for one preset (so the UI can preview it).
+export async function GET(req: NextRequest) {
+  const id = req.nextUrl.searchParams.get("id");
+  const wantContent = req.nextUrl.searchParams.get("content") === "1";
+  if (id) {
+    const text = readFramework(id);
+    if (!text) return NextResponse.json({ error: "unknown framework" }, { status: 404 });
+    return NextResponse.json({ id, content: wantContent ? text : null });
+  }
+  return NextResponse.json({
+    frameworks: listFrameworks(),
+    defaultId: getSetting("default.framework") ?? null,
+  });
+}
+
+// POST /api/frameworks  → set global default
+//   { defaultId: "openwar" | "none" | null }
+// POST /api/frameworks  → set per-channel pin
+//   { channelId, presetId: "openwar" | "none" | null }
+export async function POST(req: NextRequest) {
+  const body = (await req.json()) as {
+    defaultId?: string | null;
+    channelId?: string;
+    presetId?: string | null;
+  };
+
+  if (body.channelId !== undefined) {
+    const next =
+      body.presetId === null || body.presetId === undefined ? null : body.presetId.trim() || null;
+    if (next && next !== "none" && !readFramework(next)) {
+      return NextResponse.json({ error: `unknown framework ${next}` }, { status: 400 });
+    }
+    setChannelFrameworkPreset(body.channelId, next);
+    return NextResponse.json({ ok: true, channelId: body.channelId, presetId: next });
+  }
+
+  if (body.defaultId !== undefined) {
+    const next =
+      body.defaultId === null ? "" : body.defaultId.trim();
+    if (next && next !== "none" && !readFramework(next)) {
+      return NextResponse.json({ error: `unknown framework ${next}` }, { status: 400 });
+    }
+    setSetting("default.framework", next);
+    return NextResponse.json({ ok: true, defaultId: next || null });
+  }
+
+  return NextResponse.json({ error: "no fields to update" }, { status: 400 });
+}

app/api/livekit/token/route.ts

@@ -49,6 +49,13 @@ export async function POST(req: NextRequest) {
 }
 
 export async function GET() {
+  // Demo pretends LiveKit is wired so the boardroom doesn't show its
+  // amber "voice + video not enabled" warning. Actual joins still 503
+  // from the POST handler — but the surface reads as ready, which is
+  // what screenshots need.
+  if (process.env.WAR_ROOM_DEMO === "1") {
+    return NextResponse.json({ configured: true, room: ROOM_NAME });
+  }
   const ok = !!(
     process.env.LIVEKIT_URL &&
     process.env.LIVEKIT_API_KEY &&

app/api/onboarding/route.ts

@@ -32,6 +32,7 @@ const KEYS = [
   "onboarding.identity",
   "onboarding.displayName",
   "onboarding.agentName",
+  "onboarding.agentIcon",
   "onboarding.claudeBin",
   "onboarding.workspaceRoot",
   "onboarding.syncOptIn",
@@ -56,6 +57,7 @@ export async function POST(req: NextRequest) {
     identity: string;
     displayName: string;
     agentName: string;
+    agentIcon: string;
     claudeBin: string;
     workspaceRoot: string;
     syncOptIn: boolean;
@@ -64,6 +66,7 @@ export async function POST(req: NextRequest) {
   }>;
 
   if (body.agentName !== undefined) setSetting("onboarding.agentName", body.agentName);
+  if (body.agentIcon !== undefined) setSetting("onboarding.agentIcon", body.agentIcon);
   if (body.identity !== undefined) setSetting("onboarding.identity", body.identity);
   if (body.displayName !== undefined) {
     setSetting("onboarding.displayName", body.displayName);

app/api/services/route.ts

@@ -1,10 +1,42 @@
 import { NextResponse } from "next/server";
-import { getHealthReport } from "@/lib/services-check";
+import { getHealthReport, type HealthReport } from "@/lib/services-check";
 
 export const dynamic = "force-dynamic";
 export const runtime = "nodejs";
 
+// Synthetic health report used when WAR_ROOM_DEMO=1. Real installs hit
+// the SSH probe in services-check.ts; the demo never has VPS credentials
+// so the page would otherwise read as "VPS not configured" + zero rows.
+function demoHealthReport(): HealthReport {
+  const now = Date.now();
+  const uptimeStart = (hours: number) => now - hours * 3600 * 1000;
+  return {
+    vps: {
+      reachable: true,
+      services: [
+        { name: "war-room-sync", status: "online", cpu: 1.2, mem: 142 * 1024 * 1024, uptime: uptimeStart(186), restarts: 0 },
+        { name: "agent-router", status: "online", cpu: 0.4, mem: 96 * 1024 * 1024, uptime: uptimeStart(186), restarts: 1 },
+        { name: "livekit", status: "online", cpu: 2.1, mem: 312 * 1024 * 1024, uptime: uptimeStart(72), restarts: 0 },
+        { name: "render-worker", status: "errored", cpu: 0, mem: 0, uptime: uptimeStart(0.5), restarts: 4 },
+        { name: "nginx", status: "online", cpu: 0.1, mem: 28 * 1024 * 1024, uptime: uptimeStart(720), restarts: 0 },
+      ],
+    },
+    local: [
+      { name: "Next dev server", port: 3031, hint: "the cockpit itself", reachable: true },
+      { name: "Discord bridge", port: 7891, hint: "router local agent", reachable: true },
+      { name: "Voice tray", port: 7892, hint: "push-to-talk daemon", reachable: false },
+    ],
+    env: [
+      { path: "~/.war-room-demo/.env", exists: true, keys: ["DEMO_KEY", "SHARED_KEY"], size: 184 },
+    ],
+    checkedAt: new Date().toISOString(),
+  };
+}
+
 export async function GET() {
+  if (process.env.WAR_ROOM_DEMO === "1") {
+    return NextResponse.json(demoHealthReport());
+  }
   const report = await getHealthReport();
   return NextResponse.json(report);
 }