chapterhouse 0.9.1 → 0.10.0

package/dist/copilot/tools.okr.test.js

@@ -33,6 +33,37 @@ test("createTools registers OKR progress tools", async () => {
     assert.ok(tools.some((tool) => tool.name === "get_my_okrs"));
     assert.ok(tools.some((tool) => tool.name === "write_team_wiki"));
 });
+test("get_my_okrs does not fall back to the last authenticated user outside a turn", async () => {
+    const toolsModule = await loadToolsModule();
+    assert.ok(toolsModule, "tools module should exist");
+    const dbModule = await import("../store/db.js");
+    dbModule.setState("last_authenticated_user", JSON.stringify({
+        id: "u-ada",
+        name: "Ada Lovelace",
+        email: "ada@example.com",
+        role: "engineer",
+    }));
+    let fetchAttempts = 0;
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+        createTeamPushClient: () => ({
+            async pushUpdate() {
+                throw new Error("not used in this test");
+            },
+            async fetchOKRs() {
+                fetchAttempts += 1;
+                return "";
+            },
+            async writePage(path) {
+                return { ok: true, path };
+            },
+        }),
+    });
+    const result = await tools.find((tool) => tool.name === "get_my_okrs")?.handler({});
+    assert.match(result, /current user identity/i);
+    assert.equal(fetchAttempts, 0, "tool must not use persisted last-user identity");
+});
 test("log_okr_progress suggests a KR when the user did not specify one", async () => {
     const toolsModule = await loadToolsModule();
     assert.ok(toolsModule, "tools module should exist");

package/dist/copilot/tools.wiki.test.js

@@ -2,6 +2,7 @@ import assert from "node:assert/strict";
 import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import test from "node:test";
+import { withWikiWrite } from "../wiki/lock.js";
 async function loadToolsModule() {
     return await import(new URL(`./tools.js?cachebust=${Date.now()}-${Math.random()}`, import.meta.url).href);
 }
@@ -11,6 +12,16 @@ async function readWikiArtifacts() {
     const indexManager = await import(new URL(`../wiki/index-manager.js?case=${nonce}`, import.meta.url).href);
     return { wikiFs, indexManager };
 }
+async function loadWikiTool(name) {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === name);
+    assert.ok(tool, `Expected tool '${name}' to be registered`);
+    return tool;
+}
 test.before(() => {
     mkdirSync(join(process.cwd(), ".test-work"), { recursive: true });
 });
@@ -70,9 +81,143 @@ Runtime notes.
 `,
     });
     assert.equal(typeof result, "object");
-    assert.match(result.error, /invalid 'summary'/i);
-    assert.match(result.error, /unknown tag 'made-up-tag'/i);
-    assert.match(result.error, /pages\/_meta\/taxonomy\.md/);
+    const error = result.error;
+    assert.match(error, /invalid 'summary'/i);
+    assert.match(error, /unknown tag 'made-up-tag'|tag "made-up-tag" is not in the allowed tag list/i);
+    assert.match(error, /Valid tags:/i);
+    assert.match(error, /engineering/i);
+    assert.match(error, /release/i);
+});
+test("wiki_update accepts an empty tags list", async () => {
+    const tool = await loadWikiTool("wiki_update");
+    const result = await tool.handler({
+        path: "pages/shared/chapterhouse.md",
+        title: "Chapterhouse",
+        summary: "Runtime notes",
+        content: `---
+title: Chapterhouse
+summary: Runtime notes
+tags: []
+---
+
+# Chapterhouse
+
+Runtime notes.
+`,
+    });
+    assert.equal(result, "Wiki page updated: Chapterhouse (pages/shared/chapterhouse.md)");
+});
+test("wiki_update accepts mixed-case valid tags with surrounding whitespace", async () => {
+    const tool = await loadWikiTool("wiki_update");
+    const { wikiFs } = await readWikiArtifacts();
+    wikiFs.writePage("pages/_meta/taxonomy.md", "## Custom\n- workflow\n");
+    const result = await tool.handler({
+        path: "pages/shared/chapterhouse.md",
+        title: "Chapterhouse",
+        summary: "Runtime notes",
+        content: `---
+title: Chapterhouse
+summary: Runtime notes
+tags: [ Engineering , workflow ]
+---
+
+# Chapterhouse
+
+Runtime notes.
+`,
+    });
+    assert.equal(result, "Wiki page updated: Chapterhouse (pages/shared/chapterhouse.md)");
+});
+test("wiki_update accepts summaries that are exactly 160 characters long", async () => {
+    const tool = await loadWikiTool("wiki_update");
+    const summary = "x".repeat(160);
+    const result = await tool.handler({
+        path: "pages/shared/chapterhouse.md",
+        title: "Chapterhouse",
+        summary,
+        content: `---
+title: Chapterhouse
+summary: ${summary}
+tags: [engineering]
+---
+
+# Chapterhouse
+
+${summary}
+`,
+    });
+    assert.equal(result, "Wiki page updated: Chapterhouse (pages/shared/chapterhouse.md)");
+});
+test("wiki_update rejects summaries longer than 160 characters", async () => {
+    const tool = await loadWikiTool("wiki_update");
+    const result = await tool.handler({
+        path: "pages/shared/chapterhouse.md",
+        title: "Chapterhouse",
+        summary: "x".repeat(161),
+        content: `---
+title: Chapterhouse
+summary: Runtime notes
+tags: [engineering]
+---
+
+# Chapterhouse
+
+Runtime notes.
+`,
+    });
+    assert.deepEqual(result, {
+        error: "Summary must be 160 characters or fewer",
+    });
+    const { wikiFs } = await readWikiArtifacts();
+    assert.equal(wikiFs.readPage("pages/shared/chapterhouse.md"), undefined);
+});
+test("wiki_update keeps empty-summary behavior unchanged", async () => {
+    const tool = await loadWikiTool("wiki_update");
+    const result = await tool.handler({
+        path: "pages/shared/chapterhouse.md",
+        title: "Chapterhouse",
+        summary: "",
+        content: `---
+title: Chapterhouse
+summary:
+tags: [engineering]
+---
+
+# Chapterhouse
+
+Runtime notes.
+`,
+    });
+    assert.equal(typeof result, "object");
+    assert.match(result.error, /missing 'summary'/i);
+});
+test("wiki_ingest_source rejects local file-style inputs with a clear error", async () => {
+    const tool = await loadWikiTool("wiki_ingest_source");
+    for (const source of [
+        "./notes.md",
+        "../notes.md",
+        "/var/data/notes.md",
+        "notes.md",
+        "C:\\Users\\brian\\notes.md",
+        "file:///home/brian/notes.md",
+    ]) {
+        const result = await tool.handler({ source });
+        assert.equal(typeof result, "object", `Expected '${source}' to be rejected`);
+        const error = result.error;
+        assert.match(error, /local|file/i, `Expected '${source}' error to mention local-file rejection`);
+        assert.match(error, /url|http|https/i, `Expected '${source}' error to mention the remote URL requirement`);
+    }
+    const { wikiFs } = await readWikiArtifacts();
+    assert.deepEqual(wikiFs.listSources(), []);
+});
+test("wiki_ingest_source still passes remote URLs through to ingestSource", async () => {
+    const tool = await loadWikiTool("wiki_ingest_source");
+    const result = await tool.handler({
+        source: "http://127.0.0.1/private",
+    });
+    assert.deepEqual(result, {
+        error: "Cannot fetch internal/private URLs.",
+    });
 });
 test("wiki_update accepts valid frontmatter and refreshes the index entry", async () => {
     const toolsModule = await loadToolsModule();
@@ -116,6 +261,211 @@ Runtime notes.
         },
     ]);
 });
+test("wiki_batch_update creates multiple pages and refreshes the index", async () => {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === "wiki_batch_update");
+    assert.ok(tool);
+    const result = await tool.handler({
+        pages: [
+            {
+                path: "pages/projects/atlas/index.md",
+                title: "Atlas",
+                summary: "Project atlas overview",
+                content: `---
+title: Atlas
+summary: Project atlas overview
+tags: [project]
+---
+
+# Atlas
+
+Project atlas overview.
+`,
+            },
+            {
+                path: "pages/people/alice/index.md",
+                title: "Alice",
+                summary: "Team profile for Alice",
+                section: "People",
+                content: `---
+title: Alice
+summary: Team profile for Alice
+tags: [people]
+---
+
+# Alice
+
+Team profile for Alice.
+`,
+            },
+        ],
+    });
+    assert.equal(result, "Created 2 pages successfully.");
+    const { wikiFs, indexManager } = await readWikiArtifacts();
+    const index = indexManager.parseIndex();
+    assert.match(wikiFs.readPage("pages/projects/atlas/index.md") ?? "", /summary: Project atlas overview/);
+    assert.match(wikiFs.readPage("pages/people/alice/index.md") ?? "", /summary: Team profile for Alice/);
+    assert.ok(index.some((entry) => entry.path === "pages/projects/atlas/index.md" && entry.summary === "Project atlas overview"));
+    assert.ok(index.some((entry) => entry.path === "pages/people/alice/index.md" && entry.summary === "Team profile for Alice"));
+});
+test("wiki_batch_update reports per-page path errors and continues other writes", async () => {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === "wiki_batch_update");
+    assert.ok(tool);
+    const result = await tool.handler({
+        pages: [
+            {
+                path: "pages/projects/atlas/index.md",
+                title: "Atlas",
+                summary: "Project atlas overview",
+                content: `---
+title: Atlas
+summary: Project atlas overview
+tags: [project]
+---
+
+# Atlas
+
+Project atlas overview.
+`,
+            },
+            {
+                path: "../secrets.md",
+                title: "Secrets",
+                summary: "Should be rejected",
+                content: `---
+title: Secrets
+summary: Should be rejected
+tags: [project]
+---
+
+# Secrets
+`,
+            },
+        ],
+    });
+    assert.equal(result, "Created 1 pages successfully.\nErrors (1):\n  • ../secrets.md — Refused unsafe wiki path: ../secrets.md");
+    const { wikiFs } = await readWikiArtifacts();
+    assert.match(wikiFs.readPage("pages/projects/atlas/index.md") ?? "", /summary: Project atlas overview/);
+    assert.equal(wikiFs.readPage("../secrets.md"), undefined);
+});
+test("wiki_batch_update reports per-page tag errors and continues other writes", async () => {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === "wiki_batch_update");
+    assert.ok(tool);
+    const result = await tool.handler({
+        pages: [
+            {
+                path: "pages/projects/atlas/index.md",
+                title: "Atlas",
+                summary: "Project atlas overview",
+                content: `---
+title: Atlas
+summary: Project atlas overview
+tags: [project]
+---
+
+# Atlas
+
+Project atlas overview.
+`,
+            },
+            {
+                path: "pages/people/alice/index.md",
+                title: "Alice",
+                summary: "Team profile for Alice",
+                content: `---
+title: Alice
+summary: Team profile for Alice
+tags: [personal]
+---
+
+# Alice
+
+Team profile for Alice.
+`,
+            },
+        ],
+    });
+    assert.equal(typeof result, "string");
+    assert.match(result, /^Created 1 pages successfully\.\nErrors \(1\):/);
+    assert.match(result, /pages\/people\/alice\/index\.md — Wiki page frontmatter violates the required shape: unknown tag 'personal'/);
+    const { wikiFs } = await readWikiArtifacts();
+    assert.match(wikiFs.readPage("pages/projects/atlas/index.md") ?? "", /summary: Project atlas overview/);
+    assert.equal(wikiFs.readPage("pages/people/alice/index.md"), undefined);
+});
+test("wiki_batch_update fails fast on an empty pages array", async () => {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === "wiki_batch_update");
+    assert.ok(tool);
+    const result = await tool.handler({ pages: [] });
+    assert.deepEqual(result, { error: "Too small: expected array to have >=1 items" });
+    const { indexManager } = await readWikiArtifacts();
+    assert.deepEqual(indexManager.parseIndex(), []);
+});
+test("wiki_batch_update fails fast when more than 50 pages are requested", async () => {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === "wiki_batch_update");
+    assert.ok(tool);
+    const result = await tool.handler({
+        pages: Array.from({ length: 51 }, (_, index) => ({
+            path: `pages/projects/page-${index + 1}/index.md`,
+            title: `Page ${index + 1}`,
+            summary: `Summary ${index + 1}`,
+            content: `---\ntitle: Page ${index + 1}\nsummary: Summary ${index + 1}\ntags: [project]\n---\n\n# Page ${index + 1}\n`,
+        })),
+    });
+    assert.deepEqual(result, { error: "Too big: expected array to have <=50 items" });
+    const { indexManager } = await readWikiArtifacts();
+    assert.deepEqual(indexManager.parseIndex(), []);
+});
+test("wiki_batch_update inherits summary length validation from the per-page schema", async () => {
+    const toolsModule = await loadToolsModule();
+    const tools = toolsModule.createTools({
+        client: { async listModels() { return []; } },
+        onAgentTaskComplete: () => { },
+    });
+    const tool = tools.find((entry) => entry.name === "wiki_batch_update");
+    assert.ok(tool);
+    const result = await tool.handler({
+        pages: [{
+                path: "pages/projects/atlas/index.md",
+                title: "Atlas",
+                summary: "x".repeat(161),
+                content: `---
+title: Atlas
+summary: Project atlas overview
+tags: [project]
+---
+
+# Atlas
+`,
+            }],
+    });
+    assert.deepEqual(result, { error: "Summary must be 160 characters or fewer" });
+    const { indexManager } = await readWikiArtifacts();
+    assert.deepEqual(indexManager.parseIndex(), []);
+});
 test("retained wiki tools append audit entries to pages/_meta/log.md", async () => {
     const toolsModule = await loadToolsModule();
     const tools = toolsModule.createTools({
@@ -164,9 +514,11 @@ updated: 2026-05-12
 
 # Rust
 `);
-    for (const entry of indexManager.parseIndex()) {
-        indexManager.removeFromIndex(entry.path);
-    }
+    await withWikiWrite(() => {
+        for (const entry of indexManager.parseIndex()) {
+            indexManager.removeFromIndex(entry.path);
+        }
+    });
     assert.equal(indexManager.parseIndex().length, 0, "Precondition: wiki_pages should start empty");
     const result = await wikiReindex.handler({});
     assert.match(result, /^Reindexed \d+ wiki page\(s\) from disk\.$/);

package/dist/copilot/turn-event-log.js

@@ -44,12 +44,37 @@ const turnBuffers = new Map();
 const turnListeners = new Map();
 /** Per-session ring buffer for SSE reconnect replay (sliding window across turns). */
 const sessionBuffers = new Map();
-/** Per-session live listeners (SSE connections). */
+/** Warn when one session accumulates an unusual number of SSE listeners. */
+export const SESSION_LISTENER_WARN_THRESHOLD = 50;
+/** Hard cap to evict oldest leaked SSE listeners for one session. */
+export const SESSION_LISTENER_MAX = 100;
+/** Per-session live listeners (SSE connections), insertion-ordered for oldest-first eviction. */
 const sessionListeners = new Map();
 /** Pending clear-buffer timers keyed by turnId. */
 const clearTimers = new Map();
 /** Monotonic global sequence counter — used as SSE `id:` for Last-Event-ID replay. */
 let globalSeq = 0;
+function warnHighSessionListenerCount(sessionKey, listenerCount) {
+    if (listenerCount !== SESSION_LISTENER_WARN_THRESHOLD + 1)
+        return;
+    log.warn({ sessionKey, listenerCount, threshold: SESSION_LISTENER_WARN_THRESHOLD }, "turn-event-log: high session listener count may indicate leaked SSE subscribers");
+}
+function evictOverflowSessionListeners(sessionKey, listeners) {
+    const overflow = listeners.size - SESSION_LISTENER_MAX;
+    if (overflow <= 0)
+        return;
+    let evicted = 0;
+    for (const [listener] of listeners) {
+        listeners.delete(listener);
+        evicted += 1;
+        if (evicted >= overflow)
+            break;
+    }
+    if (listeners.size === 0) {
+        sessionListeners.delete(sessionKey);
+    }
+    log.warn({ sessionKey, evicted, listenerCount: listeners.size, maxListeners: SESSION_LISTENER_MAX }, "turn-event-log: evicted oldest session listeners after exceeding the max listener cap");
+}
 // ---------------------------------------------------------------------------
 // Emit
 // ---------------------------------------------------------------------------
@@ -90,7 +115,7 @@ export function emitTurnEvent(sessionKey, event) {
     // Notify per-session listeners (SSE connections) -------------------------
     const sListeners = sessionListeners.get(sessionKey);
     if (sListeners) {
-        for (const fn of sListeners) {
+        for (const fn of sListeners.keys()) {
             try {
                 fn(indexed);
             }
@@ -169,10 +194,12 @@ export function subscribeSession(sessionKey, listener, afterSeq) {
     // Register live listener
     let ls = sessionListeners.get(sessionKey);
     if (!ls) {
-        ls = new Set();
+        ls = new Map();
         sessionListeners.set(sessionKey, ls);
     }
-    ls.add(listener);
+    ls.set(listener, true);
+    warnHighSessionListenerCount(sessionKey, ls.size);
+    evictOverflowSessionListeners(sessionKey, ls);
     return () => {
         const set = sessionListeners.get(sessionKey);
         if (set) {

package/dist/copilot/turn-event-log.test.js

@@ -22,17 +22,24 @@
  * SQLite-dependent functions (persistTurnEvents, getSessionEventsFromDb) are
  * tested in the integration suite to avoid needing a real DB here.
  */
-import { describe, it, afterEach } from "node:test";
+import { describe, it, afterEach, after } from "node:test";
 import assert from "node:assert/strict";
+import { mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
 import { setTimeout as setTimeoutPromise } from "node:timers/promises";
-import { emitTurnEvent, subscribeTurn, subscribeSession, clearTurnLog, scheduleClearTurnLog, turnLogSize, oldestSessionSeq, persistTurnEvents, getSessionEventsFromDb, TURN_BUFFER_CAPACITY, SESSION_BUFFER_CAPACITY, } from "./turn-event-log.js";
+import { emitTurnEvent, subscribeTurn, subscribeSession, clearTurnLog, scheduleClearTurnLog, turnLogSize, oldestSessionSeq, persistTurnEvents, getSessionEventsFromDb, TURN_BUFFER_CAPACITY, SESSION_BUFFER_CAPACITY, SESSION_LISTENER_MAX, } from "./turn-event-log.js";
 import { getDb } from "../store/db.js";
+import { resetSingletons } from "../test/helpers/reset-singletons.js";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
 let turnCounter = 0;
 let sessionCounter = 0;
 const usedSessionKeys = [];
+const sandboxRoot = join(process.cwd(), ".test-work", `turn-event-log-${process.pid}`);
+mkdirSync(sandboxRoot, { recursive: true });
+process.env.CHAPTERHOUSE_HOME = sandboxRoot;
+resetSingletons();
 function freshTurnId() {
     return `turn-test-${++turnCounter}-${Date.now()}`;
 }
@@ -76,6 +83,10 @@ afterEach(() => {
         }
     }
 });
+after(() => {
+    resetSingletons();
+    rmSync(sandboxRoot, { recursive: true, force: true });
+});
 function trackTurn(turnId) {
     usedTurnIds.push(turnId);
     return turnId;
@@ -260,6 +271,17 @@ describe("turn-event-log", () => {
             emitTurnEvent(session, makeComplete(turnId, session));
             assert.equal(received.length, 1);
         });
+        it("evicts the oldest session listeners when one session exceeds the max listener cap", () => {
+            const session = freshSessionKey();
+            const turnId = trackTurn(freshTurnId());
+            const deliveries = Array.from({ length: SESSION_LISTENER_MAX + 1 }, () => []);
+            for (const received of deliveries) {
+                trackUnsub(subscribeSession(session, (event) => received.push(event)));
+            }
+            emitTurnEvent(session, makeStarted(turnId, session));
+            assert.equal(deliveries[0]?.length, 0, "oldest listener should be evicted once the cap is exceeded");
+            assert.equal(deliveries.at(-1)?.length, 1, "most recent listener should still receive events");
+        });
         it("two sessions are isolated from each other", () => {
             const session1 = freshSessionKey();
             const session2 = freshSessionKey();

package/dist/copilot/workiq-installer.test.js

@@ -68,12 +68,12 @@ function makeFs(initialJson) {
     let stored = initialJson ?? null;
     const written = [];
     return {
-        readFile: (path, _enc) => {
+        readFile: (_path, _enc) => {
             if (stored === null)
                 throw Object.assign(new Error("ENOENT"), { code: "ENOENT" });
             return stored;
         },
-        writeFile: (path, data, _enc) => {
+        writeFile: (_path, data, _enc) => {
             stored = data;
             written.push(data);
         },

package/dist/daemon-install.js

@@ -7,6 +7,7 @@ import { execSync, execFileSync } from "child_process";
 import { existsSync, mkdirSync, writeFileSync, rmSync } from "fs";
 import { join, dirname } from "path";
 import { homedir, platform } from "os";
+import { config } from "./config.js";
 /** The launchd label / systemd unit name. */
 export const DAEMON_LABEL = "com.bketelsen.chapterhouse";
 export const DAEMON_UNIT_NAME = "chapterhouse";
@@ -80,7 +81,7 @@ function composeMacOSPath(binDir, shellPath) {
 /** Generate the launchd plist XML string. */
 export function generatePlist(options) {
     const label = options.label ?? DAEMON_LABEL;
-    const shellPath = options.shellPath ?? process.env.PATH ?? "";
+    const shellPath = options.shellPath ?? config.shellPath;
     const richPath = composeMacOSPath(dirname(options.binPath), shellPath);
     return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
@@ -135,7 +136,7 @@ function composeSystemdPath(binDir, shellPath) {
 /** Generate the systemd user unit file string. */
 export function generateSystemdUnit(options) {
     const description = options.description ?? "Chapterhouse AI assistant daemon";
-    const shellPath = options.shellPath ?? process.env.PATH ?? "";
+    const shellPath = options.shellPath ?? config.shellPath;
     const richPath = composeSystemdPath(dirname(options.binPath), shellPath);
     return `[Unit]
 Description=${description}

package/dist/daemon.js

@@ -12,6 +12,7 @@ import { checkForUpdate } from "./update.js";
 import { ensureWikiStructure } from "./wiki/fs.js";
 import { seedTeamWiki } from "./wiki/seed-team-wiki.js";
 import { shouldMigrate, migrateMemoriesToWiki, shouldReorganize, reorganizeWiki } from "./wiki/migrate.js";
+import { withWikiWrite } from "./wiki/lock.js";
 import { shouldEnforceTopics, enforceTopicStructure } from "./wiki/migrate-topics.js";
 import { SESSIONS_DIR } from "./paths.js";
 import { getDisplayHost } from "./api/server-runtime.js";
@@ -37,15 +38,7 @@ const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
  *   Layer 3 — systemd kill:      TimeoutStopSec=90 s (must exceed layer 2)
  * Allows in-flight LLM streams to complete before the process is torn down.
  */
-const SHUTDOWN_TIMEOUT_MS = (() => {
-    const env = process.env.CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS;
-    if (env) {
-        const parsed = parseInt(env, 10);
-        if (!isNaN(parsed) && parsed > 0)
-            return parsed;
-    }
-    return 60_000;
-})();
+const SHUTDOWN_TIMEOUT_MS = config.shutdownTimeoutMs;
 /** Remove orphaned session folders older than 7 days, preserving the current session. */
 function pruneOldSessions() {
     try {
@@ -95,10 +88,9 @@ async function main() {
     for (const warning of config.modeCompatibilityWarnings) {
         log.warn({ mode: config.chapterhouseMode }, warning);
     }
+    log.info({ capabilities: modeContext.getCapabilities() }, modeContext.getStartupCapabilitySummary());
     // Set up message logging to daemon console
     setMessageLogger((direction, source, text) => {
-        const arrow = direction === "in" ? "⟶" : "⟵";
-        const tag = source.padEnd(8);
         log.debug({ direction, source, text: truncate(text) }, "chat");
     });
     // Initialize SQLite
@@ -110,19 +102,19 @@ async function main() {
         log.info("Created wiki");
     }
     if (modeContext.isTeam()) {
-        const seed = seedTeamWiki();
+        const seed = await withWikiWrite(() => seedTeamWiki());
         if (seed.created.length > 0) {
             log.info({ pages: seed.created }, "Seeded team wiki pages");
         }
     }
     if (shouldMigrate()) {
         log.info("Migrating SQLite memories to wiki");
-        const count = migrateMemoriesToWiki();
+        const count = await withWikiWrite(() => migrateMemoriesToWiki());
         log.info({ count }, "Migrated memories to wiki");
     }
     if (shouldReorganize()) {
         log.info("Reorganizing wiki pages into entity structure");
-        const count = reorganizeWiki();
+        const count = await withWikiWrite(() => reorganizeWiki());
         log.info({ count }, "Created entity pages during reorganization");
     }
     if (shouldEnforceTopics()) {
@@ -144,7 +136,7 @@ async function main() {
     // Prune orphaned session folders older than 7 days
     pruneOldSessions();
     // One-time deprecation note for legacy Telegram users (v1 → v2)
-    if (process.env.TELEGRAM_BOT_TOKEN) {
+    if (config.telegramBotTokenConfigured) {
         log.warn("TELEGRAM_BOT_TOKEN found in env — Telegram support was removed in v2. The web UI is now the only client.");
     }
     // Auto-install workiq MCP server when Entra is configured
@@ -180,7 +172,7 @@ async function main() {
     }
     const url = `http://${getDisplayHost(config.apiHost)}:${config.apiPort}`;
     log.info({ url }, "Chapterhouse is fully operational");
-    if (process.env.CHAPTERHOUSE_OPEN_BROWSER === "1") {
+    if (config.openBrowserOnStart) {
         const opener = process.platform === "darwin" ? "open" :
             process.platform === "win32" ? "explorer.exe" : "xdg-open";
         try {
@@ -198,7 +190,7 @@ async function main() {
         }
     })
         .catch(() => { }); // silent — network may be unavailable
-    if (process.env.CHAPTERHOUSE_RESTARTED === "1") {
+    if (config.restarted) {
         delete process.env.CHAPTERHOUSE_RESTARTED;
     }
 }