chapterhouse 0.3.0 → 0.3.2

package/dist/daemon-install.js

@@ -53,9 +53,35 @@ export function resolveChapterhouseBin() {
         return argv1;
     return "chapterhouse";
 }
+/**
+ * Compose a rich PATH for launchd-spawned children (macOS).
+ * Prepends the installing shell's $PATH so any tool already on the user's PATH
+ * is available to sub-agents, then adds Homebrew and language-toolchain dirs.
+ */
+function composeMacOSPath(binDir, shellPath) {
+    const home = homedir();
+    return [
+        shellPath,
+        binDir,
+        "/opt/homebrew/bin",
+        "/usr/local/bin",
+        `${home}/.cargo/bin`,
+        `${home}/.bun/bin`,
+        `${home}/.volta/bin`,
+        `${home}/.local/bin`,
+        "/usr/bin",
+        "/bin",
+        "/usr/sbin",
+        "/sbin",
+    ]
+        .filter(Boolean)
+        .join(":");
+}
 /** Generate the launchd plist XML string. */
 export function generatePlist(options) {
     const label = options.label ?? DAEMON_LABEL;
+    const shellPath = options.shellPath ?? process.env.PATH ?? "";
+    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">
 <plist version="1.0">
@@ -78,16 +104,39 @@ export function generatePlist(options) {
     <key>EnvironmentVariables</key>
     <dict>
         <key>PATH</key>
-        <string>${dirname(options.binPath)}:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+        <string>${richPath}</string>
     </dict>
 </dict>
 </plist>
 `;
 }
+/**
+ * Compose a rich PATH for systemd-spawned children (Linux).
+ * Uses systemd's %h specifier for the home directory so the unit stays portable
+ * across uid changes. Prepends the installing shell's $PATH for robustness.
+ */
+function composeSystemdPath(binDir, shellPath) {
+    return [
+        shellPath,
+        binDir,
+        "/home/linuxbrew/.linuxbrew/bin",
+        "%h/.cargo/bin",
+        "%h/.bun/bin",
+        "%h/.volta/bin",
+        "%h/.local/bin",
+        "/opt/homebrew/bin",
+        "/usr/local/bin",
+        "/usr/bin",
+        "/bin",
+    ]
+        .filter(Boolean)
+        .join(":");
+}
 /** Generate the systemd user unit file string. */
 export function generateSystemdUnit(options) {
     const description = options.description ?? "Chapterhouse AI assistant daemon";
-    const pathDir = dirname(options.binPath);
+    const shellPath = options.shellPath ?? process.env.PATH ?? "";
+    const richPath = composeSystemdPath(dirname(options.binPath), shellPath);
     return `[Unit]
 Description=${description}
 After=network.target
@@ -97,7 +146,17 @@ Type=simple
 ExecStart=${options.binPath} start
 Restart=on-failure
 RestartSec=5s
-Environment="PATH=${pathDir}:/usr/local/bin:/usr/bin:/bin"
+# Rich PATH ensures spawned sub-agents and tools can find CLI dependencies
+# (Linuxbrew, Homebrew, Cargo, Bun, Volta). %h is expanded to $HOME by systemd.
+Environment="PATH=${richPath}"
+# ── Timing contract (three layers) ─────────────────────────────────────────────
+# Layer 1 │ Orchestrator turn timeout  │ CHAPTERHOUSE_ORCHESTRATOR_TIMEOUT_MS (default 1800 s)
+# Layer 2 │ Daemon graceful shutdown   │ CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS     (default 60 s)
+# Layer 3 │ systemd force-kill window  │ TimeoutStopSec = 90 s (must exceed layer 2)
+# Each layer must exceed the one above it. Do NOT tighten TimeoutStopSec without
+# first reducing CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS, or in-flight LLM streams will
+# be killed mid-response.
+TimeoutStopSec=90
 
 [Install]
 WantedBy=default.target

package/dist/daemon-install.test.js

@@ -41,6 +41,23 @@ test("generatePlist includes bin directory in PATH environment", () => {
     const plist = generatePlist({ binPath: MOCK_BIN_DARWIN, logPath: MOCK_LOG_DARWIN });
     assert.ok(plist.includes(dirname(MOCK_BIN_DARWIN)), "plist PATH should include bin directory");
 });
+test("generatePlist PATH includes Homebrew and toolchain directories", () => {
+    const plist = generatePlist({ binPath: MOCK_BIN_DARWIN, logPath: MOCK_LOG_DARWIN, shellPath: "" });
+    const home = homedir();
+    assert.ok(plist.includes("/opt/homebrew/bin"), "plist PATH should include /opt/homebrew/bin");
+    assert.ok(plist.includes(`${home}/.cargo/bin`), "plist PATH should include ~/.cargo/bin");
+    assert.ok(plist.includes(`${home}/.bun/bin`), "plist PATH should include ~/.bun/bin");
+    assert.ok(plist.includes(`${home}/.volta/bin`), "plist PATH should include ~/.volta/bin");
+    assert.ok(plist.includes(`${home}/.local/bin`), "plist PATH should include ~/.local/bin");
+});
+test("generatePlist PATH prepends installing shell PATH", () => {
+    const shellPath = "/custom/shell/bin:/another/dir";
+    const plist = generatePlist({ binPath: MOCK_BIN_DARWIN, logPath: MOCK_LOG_DARWIN, shellPath });
+    assert.ok(plist.includes(shellPath), "plist PATH should include the installing shell PATH");
+    const pathStart = plist.indexOf(shellPath);
+    const binDirStart = plist.indexOf(dirname(MOCK_BIN_DARWIN), plist.indexOf("<key>PATH</key>"));
+    assert.ok(pathStart < binDirStart, "shell PATH should appear before bin dir in composed PATH");
+});
 test("generatePlist respects a custom label override", () => {
     const customLabel = "com.example.test";
     const plist = generatePlist({ binPath: MOCK_BIN_DARWIN, logPath: MOCK_LOG_DARWIN, label: customLabel });
@@ -78,6 +95,24 @@ test("generateSystemdUnit includes bin directory in PATH", () => {
     const unit = generateSystemdUnit({ binPath: MOCK_BIN_LINUX });
     assert.ok(unit.includes(dirname(MOCK_BIN_LINUX)), "unit PATH should include bin directory");
 });
+test("generateSystemdUnit PATH includes Linuxbrew and toolchain directories", () => {
+    const unit = generateSystemdUnit({ binPath: MOCK_BIN_LINUX, shellPath: "" });
+    assert.ok(unit.includes("/home/linuxbrew/.linuxbrew/bin"), "unit PATH should include Linuxbrew");
+    assert.ok(unit.includes("%h/.cargo/bin"), "unit PATH should include %h/.cargo/bin");
+    assert.ok(unit.includes("%h/.bun/bin"), "unit PATH should include %h/.bun/bin");
+    assert.ok(unit.includes("%h/.volta/bin"), "unit PATH should include %h/.volta/bin");
+    assert.ok(unit.includes("%h/.local/bin"), "unit PATH should include %h/.local/bin");
+    assert.ok(unit.includes("/opt/homebrew/bin"), "unit PATH should include /opt/homebrew/bin");
+});
+test("generateSystemdUnit PATH prepends installing shell PATH", () => {
+    const shellPath = "/custom/shell/bin";
+    const unit = generateSystemdUnit({ binPath: MOCK_BIN_LINUX, shellPath });
+    assert.ok(unit.includes(shellPath), "unit PATH should include the installing shell PATH");
+});
+test("generateSystemdUnit includes TimeoutStopSec=90", () => {
+    const unit = generateSystemdUnit({ binPath: MOCK_BIN_LINUX });
+    assert.ok(unit.includes("TimeoutStopSec=90"), "unit should set TimeoutStopSec=90 for timing contract");
+});
 test("generateSystemdUnit has all three sections", () => {
     const unit = generateSystemdUnit({ binPath: MOCK_BIN_LINUX });
     assert.ok(unit.includes("[Unit]"), "unit should have [Unit] section");

package/dist/daemon.js

@@ -17,8 +17,26 @@ import { StandupScheduler } from "./copilot/standup.js";
 import { DecisionsSyncScheduler } from "./squad/mirror.scheduler.js";
 import { registerShutdownSignals } from "./shutdown-signals.js";
 import { logger } from "./util/logger.js";
+import { CHAPTERHOUSE_VERSION } from "./version.js";
 const log = logger.child({ module: "daemon" });
 const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * How long the daemon waits for in-flight work to finish before forcing an exit.
+ * Layer 2 of the 3-layer timing contract:
+ *   Layer 1 — orchestrator turn: CHAPTERHOUSE_ORCHESTRATOR_TIMEOUT_MS (default 1800 s)
+ *   Layer 2 — daemon shutdown:   CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS     (default 60 s) ← this
+ *   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;
+})();
 /** Remove orphaned session folders older than 7 days, preserving the current session. */
 function pruneOldSessions() {
     try {
@@ -61,7 +79,7 @@ function truncate(text, max = 200) {
     return oneLine.length > max ? oneLine.slice(0, max) + "…" : oneLine;
 }
 async function main() {
-    log.info("Starting Chapterhouse daemon");
+    log.info({ version: CHAPTERHOUSE_VERSION }, "Starting Chapterhouse daemon");
     if (config.selfEditEnabled) {
         log.warn("Self-edit mode enabled — Chapterhouse can modify his own source code");
     }
@@ -165,11 +183,11 @@ async function shutdown() {
     }
     shutdownState = "shutting_down";
     log.info("Shutting down (Ctrl+C again to force)");
-    // Force exit after 3 seconds no matter what
+    // Force exit after the configured grace period no matter what
     const forceTimer = setTimeout(() => {
         log.warn("Shutdown timed out — forcing exit");
         process.exit(1);
-    }, 3000);
+    }, SHUTDOWN_TIMEOUT_MS);
     forceTimer.unref();
     // Destroy all active agent sessions
     await shutdownAgents();

package/dist/integrations/teams-notify.js

@@ -1,4 +1,6 @@
 import { config } from "../config.js";
+import { childLogger } from "../util/logger.js";
+const log = childLogger("teams-notify");
 export const TEAMS_MILESTONE_THRESHOLDS = [25, 50, 75, 100];
 const DEFAULT_COLOR = "0076D7";
 export class TeamsNotifier {
@@ -10,7 +12,7 @@ export class TeamsNotifier {
         this.webhookUrl = (options.webhookUrl ?? config.teamsWebhookUrl).trim();
         this.enabled = options.enabled ?? config.teamsNotificationsEnabled;
         this.fetchImpl = options.fetchImpl ?? fetch;
-        this.warn = options.warn ?? ((message) => console.warn(message));
+        this.warn = options.warn ?? ((message) => log.warn(message));
     }
     async sendMessage(title, body, color = DEFAULT_COLOR) {
         return await this.postCard({

package/dist/squad/index.js

@@ -5,4 +5,5 @@ export * from './context.js';
 export * from './charter.js';
 export * from './mirror.js';
 export * from './worktree.js';
+export * from './init.js';
 //# sourceMappingURL=index.js.map

package/dist/squad/init-cli.js

@@ -0,0 +1,109 @@
+/**
+ * src/squad/init-cli.ts
+ *
+ * Interactive CLI for `chapterhouse squad init`.
+ * Asks the user 5 questions, proposes a roster, then scaffolds `.squad/`.
+ *
+ * Flags:
+ *   --force    Re-scaffold even if .squad/ already exists (clobbers existing)
+ *   --yes      Skip confirmation prompt (non-interactive / CI mode)
+ *   --universe <name>  Override the naming universe (default: Dune)
+ */
+import { createInterface } from 'node:readline';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+import { scaffoldSquad, isSquadInitialized, allocateCast, resolveRoles, UNIVERSE_CHARACTERS, DEFAULT_UNIVERSE, } from './init.js';
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+export async function runInitCli(argv) {
+    const force = argv.includes('--force');
+    const yes = argv.includes('--yes');
+    // --universe <name>
+    const univIdx = argv.indexOf('--universe');
+    const univArg = univIdx !== -1 ? argv[univIdx + 1] : undefined;
+    const projectRoot = process.cwd();
+    if (!force && isSquadInitialized(projectRoot)) {
+        console.error('⚠️  Squad is already initialized in this directory.\n' +
+            '   Run with --force to re-scaffold (existing files will be overwritten).');
+        process.exit(1);
+    }
+    console.log('\n🚀 chapterhouse squad init — guided setup\n');
+    // Try to pre-fill the human name from git
+    let defaultHuman = 'the team';
+    try {
+        defaultHuman = execSync('git config user.name', { encoding: 'utf-8' }).trim() || defaultHuman;
+    }
+    catch { /* not a git repo or git not available */ }
+    const availableUniverses = Object.keys(UNIVERSE_CHARACTERS);
+    const universeList = availableUniverses.join(', ');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (prompt) => new Promise(resolve => rl.question(prompt, answer => resolve(answer.trim())));
+    try {
+        // ── Q1: project name ───────────────────────────────────────────────────
+        const projectName = (await ask('Project name: ')) || 'My Project';
+        // ── Q2: language / stack ───────────────────────────────────────────────
+        const stack = (await ask('Language / stack (e.g. TypeScript, React, Node): ')) || 'TypeScript';
+        // ── Q3: primary goal ──────────────────────────────────────────────────
+        const goal = (await ask('Primary goal — what does it do?: ')) || 'A software project';
+        // ── Q4: team size ─────────────────────────────────────────────────────
+        const teamSizeRaw = await ask('Team size (3–5, default 4): ');
+        const teamSize = Math.min(Math.max(parseInt(teamSizeRaw || '4', 10) || 4, 3), 5);
+        // ── Q5: universe ──────────────────────────────────────────────────────
+        const defaultUniverse = univArg && availableUniverses.includes(univArg) ? univArg : DEFAULT_UNIVERSE;
+        const universeInput = await ask(`Naming universe [${universeList}]\n  (default: ${defaultUniverse}): `);
+        const universe = availableUniverses.find(u => u.toLowerCase() === universeInput.toLowerCase()) ?? defaultUniverse;
+        rl.close();
+        // ── Propose roster ────────────────────────────────────────────────────
+        const roles = resolveRoles(teamSize);
+        const castMap = allocateCast(roles, universe);
+        console.log(`\n📋 Proposed team (${universe} universe):\n`);
+        for (const role of roles) {
+            const castName = castMap[role.slug];
+            console.log(`  ${role.icon}  ${castName.padEnd(12)} — ${role.role.padEnd(14)} ${role.description}`);
+        }
+        console.log('  📋 Scribe        — Scribe          Memory, decisions, session logs');
+        console.log('  🔄 Ralph         — Monitor         Work queue, backlog, keep-alive\n');
+        // ── Confirm ───────────────────────────────────────────────────────────
+        if (!yes) {
+            const rl2 = createInterface({ input: process.stdin, output: process.stdout });
+            const confirm = await new Promise(resolve => rl2.question('Hire this team? [Y/n]: ', ans => { rl2.close(); resolve(ans.trim()); }));
+            if (confirm && confirm.toLowerCase() !== 'y' && confirm.toLowerCase() !== 'yes') {
+                console.log('Aborted. No files written.');
+                process.exit(0);
+            }
+        }
+        // ── Scaffold ──────────────────────────────────────────────────────────
+        const result = scaffoldSquad(projectRoot, { projectName, stack, goal, teamSize, universe, humanName: defaultHuman }, { force });
+        if (!result) {
+            // Should not happen (we checked above) — safety fallback
+            console.error('⚠️  Squad already initialized. Use --force to overwrite.');
+            process.exit(1);
+        }
+        console.log(`\n✅ Squad initialized at ${join(projectRoot, '.squad')}/\n`);
+        console.log('Files written:');
+        console.log('  .squad/team.md');
+        console.log('  .squad/routing.md');
+        console.log('  .squad/ceremonies.md');
+        console.log('  .squad/decisions.md');
+        for (const agent of result.agents) {
+            console.log(`  .squad/agents/${agent.slug}/charter.md`);
+            console.log(`  .squad/agents/${agent.slug}/history.md`);
+        }
+        console.log('  .squad/agents/scribe/charter.md');
+        console.log('  .squad/agents/ralph/charter.md');
+        console.log('  .squad/casting/policy.json');
+        console.log('  .squad/casting/registry.json');
+        console.log('  .squad/casting/history.json');
+        console.log('  .gitattributes (updated with union merge rules)\n');
+        const firstAgent = result.agents[0];
+        if (firstAgent) {
+            console.log(`💡 Try: "@${firstAgent.slug}, set up the project structure"\n`);
+        }
+    }
+    catch (err) {
+        rl.close();
+        throw err;
+    }
+}
+//# sourceMappingURL=init-cli.js.map