chapterhouse 0.3.25 → 0.4.0

package/dist/test/api-server.js

@@ -0,0 +1,50 @@
+import { createServer } from "node:http";
+import { setTimeout as delay } from "node:timers/promises";
+import assert from "node:assert/strict";
+export const DEFAULT_API_SERVER_STARTUP_TIMEOUT_MS = 60_000;
+export const STANDALONE_API_SERVER_STARTUP_TIMEOUT_MS = 60_000;
+export const API_SERVER_STARTUP_POLL_INTERVAL_MS = 100;
+export async function getFreePort() {
+    const server = createServer();
+    await new Promise((resolve) => server.listen(0, "127.0.0.1", () => resolve()));
+    const address = server.address();
+    assert.ok(address && typeof address === "object", "server should expose a bound address");
+    await new Promise((resolve, reject) => {
+        server.close((error) => (error ? reject(error) : resolve()));
+    });
+    return address.port;
+}
+export async function stopChild(child) {
+    if (child.exitCode !== null) {
+        return;
+    }
+    child.kill("SIGTERM");
+    await new Promise((resolve) => {
+        child.once("exit", () => resolve());
+        setTimeout(() => {
+            if (child.exitCode === null) {
+                child.kill("SIGKILL");
+            }
+        }, 2_000);
+    });
+}
+export async function waitForApiServerReady({ child, baseUrl, logs, timeoutMs = DEFAULT_API_SERVER_STARTUP_TIMEOUT_MS, pollIntervalMs = API_SERVER_STARTUP_POLL_INTERVAL_MS, timeoutMessage = "Timed out waiting for API server to start", exitMessage = "API server exited early", }) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (child.exitCode !== null) {
+            throw new Error(`${exitMessage}:\n${logs.join("")}`);
+        }
+        try {
+            const response = await fetch(`${baseUrl}/status`);
+            if (response.ok) {
+                return;
+            }
+        }
+        catch {
+            // Server is still starting.
+        }
+        await delay(pollIntervalMs);
+    }
+    throw new Error(`${timeoutMessage}:\n${logs.join("")}`);
+}
+//# sourceMappingURL=api-server.js.map

package/dist/test/api-server.test.js

@@ -0,0 +1,57 @@
+import assert from "node:assert/strict";
+import { createServer } from "node:http";
+import test from "node:test";
+import { DEFAULT_API_SERVER_STARTUP_TIMEOUT_MS, STANDALONE_API_SERVER_STARTUP_TIMEOUT_MS, waitForApiServerReady, } from "./api-server.js";
+async function listen(server) {
+    await new Promise((resolve) => server.listen(0, "127.0.0.1", () => resolve()));
+    const address = server.address();
+    assert.ok(address && typeof address === "object");
+    return address.port;
+}
+async function close(server) {
+    if (!server.listening) {
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        server.close((error) => (error ? reject(error) : resolve()));
+    });
+}
+test("waitForApiServerReady waits until /status responds with ok", async () => {
+    let ready = false;
+    const server = createServer((req, res) => {
+        if (req.url !== "/status") {
+            res.writeHead(404).end();
+            return;
+        }
+        if (!ready) {
+            res.writeHead(503).end("starting");
+            return;
+        }
+        res.writeHead(200, { "content-type": "application/json" });
+        res.end(JSON.stringify({ status: "ok" }));
+    });
+    const port = await listen(server);
+    const child = { exitCode: null };
+    setTimeout(() => {
+        ready = true;
+    }, 200);
+    const startedAt = Date.now();
+    try {
+        await waitForApiServerReady({
+            child,
+            baseUrl: `http://127.0.0.1:${port}`,
+            logs: [],
+            timeoutMs: 1_000,
+            pollIntervalMs: 25,
+        });
+    }
+    finally {
+        await close(server);
+    }
+    assert.ok(Date.now() - startedAt >= 150);
+});
+test("API server startup timeouts leave headroom for slow CI runners", () => {
+    assert.equal(DEFAULT_API_SERVER_STARTUP_TIMEOUT_MS, 60_000);
+    assert.equal(STANDALONE_API_SERVER_STARTUP_TIMEOUT_MS, 60_000);
+});
+//# sourceMappingURL=api-server.test.js.map

package/dist/test/setup-env.js

@@ -1,3 +1,28 @@
+const RUNTIME_OVERRIDE_ENV_VARS = [
+    "CHAPTERHOUSE_MODE",
+    "CHAPTERHOUSE_SELF_EDIT",
+    "CHAPTERHOUSE_WORKIQ_AUTO_INSTALL",
+    "CHAPTERHOUSE_CHAT_SSE",
+    "CHAPTERHOUSE_SSE_BUFFER_CAPACITY",
+    "CHAPTERHOUSE_SSE_REPLAY_LIMIT",
+    "CHAPTERHOUSE_MEMORY_CHECKPOINT_ENABLED",
+    "CHAPTERHOUSE_MEMORY_CHECKPOINT_TURNS",
+    "CHAPTERHOUSE_MEMORY_CHECKPOINT_ON_SCOPE_CHANGE",
+    "CHAPTERHOUSE_MEMORY_CHECKPOINT_MIN_TURNS_FOR_SCOPE_FIRE",
+    "CHAPTERHOUSE_MEMORY_INJECT",
+    "CHAPTERHOUSE_MEMORY_AUTO_ACCEPT",
+    "CHAPTERHOUSE_MEMORY_EOT_HOOK_ENABLED",
+    "CHAPTERHOUSE_MEMORY_HOUSEKEEPING_ENABLED",
+    "CHAPTERHOUSE_MEMORY_HOUSEKEEPING_TURNS",
+    "CHAPTERHOUSE_MEMORY_DECAY_DAYS",
+    "CHAPTERHOUSE_MEMORY_INBOX_RETENTION_DAYS",
+    "CHAPTERHOUSE_MEMORY_TIERING_ENABLED",
+    "CHAPTERHOUSE_MEMORY_HOT_RECALL_BOOST",
+    "CHAPTERHOUSE_MEMORY_HOT_AGE_DAYS",
+];
+for (const name of RUNTIME_OVERRIDE_ENV_VARS) {
+    delete process.env[name];
+}
 process.env.CHAPTERHOUSE_DISABLE_DOTENV = "1";
 export {};
 //# sourceMappingURL=setup-env.js.map

package/dist/test/setup-env.test.js

@@ -0,0 +1,38 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+const RUNTIME_OVERRIDE_ENV_VARS = [
+    "CHAPTERHOUSE_MODE",
+    "CHAPTERHOUSE_SELF_EDIT",
+    "CHAPTERHOUSE_WORKIQ_AUTO_INSTALL",
+    "CHAPTERHOUSE_CHAT_SSE",
+    "CHAPTERHOUSE_SSE_BUFFER_CAPACITY",
+    "CHAPTERHOUSE_SSE_REPLAY_LIMIT",
+];
+test("setup-env clears ambient Chapterhouse runtime overrides", async () => {
+    const originalValues = new Map(["CHAPTERHOUSE_DISABLE_DOTENV", ...RUNTIME_OVERRIDE_ENV_VARS].map((name) => [name, process.env[name]]));
+    try {
+        process.env.CHAPTERHOUSE_DISABLE_DOTENV = "0";
+        process.env.CHAPTERHOUSE_MODE = "team";
+        process.env.CHAPTERHOUSE_SELF_EDIT = "1";
+        process.env.CHAPTERHOUSE_WORKIQ_AUTO_INSTALL = "false";
+        process.env.CHAPTERHOUSE_CHAT_SSE = "0";
+        process.env.CHAPTERHOUSE_SSE_BUFFER_CAPACITY = "3";
+        process.env.CHAPTERHOUSE_SSE_REPLAY_LIMIT = "9";
+        await import(`./setup-env.js?cache-bust=${Date.now()}`);
+        assert.equal(process.env.CHAPTERHOUSE_DISABLE_DOTENV, "1");
+        for (const name of RUNTIME_OVERRIDE_ENV_VARS) {
+            assert.equal(process.env[name], undefined, `${name} should be cleared by setup-env`);
+        }
+    }
+    finally {
+        for (const [name, value] of originalValues) {
+            if (value === undefined) {
+                delete process.env[name];
+            }
+            else {
+                process.env[name] = value;
+            }
+        }
+    }
+});
+//# sourceMappingURL=setup-env.test.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chapterhouse",
-  "version": "0.3.25",
+  "version": "0.4.0",
   "description": "Chapterhouse — a team-level AI assistant for engineering teams, built on the GitHub Copilot SDK. Web UI only.",
   "bin": {
     "chapterhouse": "dist/cli.js"