chapterhouse 0.9.2 → 0.10.0

package/dist/config.js

@@ -18,6 +18,8 @@ function loadRuntimeEnv() {
 loadRuntimeEnv();
 const configSchema = z.object({
     NODE_ENV: z.string().optional(),
+    PATH: z.string().optional(),
+    CHAPTERHOUSE_DISABLE_DOTENV: z.string().optional(),
     CHAPTERHOUSE_MODE: z.string().optional(),
     API_HOST: z.string().optional(),
     API_PORT: z.string().optional(),
@@ -34,6 +36,7 @@ const configSchema = z.object({
     ENTRA_AUTH_ENABLED: z.string().optional(),
     CORS_ALLOWED_ORIGINS: z.string().optional(),
     API_TOKEN: z.string().optional(),
+    LOG_LEVEL: z.string().optional(),
     TEAM_CHAPTERHOUSE_URL: z.string().optional(),
     TEAM_CHAPTERHOUSE_TOKEN: z.string().optional(),
     TEAM_WIKI_CACHE_TTL_MINUTES: z.string().optional(),
@@ -43,6 +46,7 @@ const configSchema = z.object({
     TEAMS_NOTIFICATIONS_ENABLED: z.string().optional(),
     COPILOT_TOKEN: z.string().optional(),
     GITHUB_TOKEN: z.string().optional(),
+    TELEGRAM_BOT_TOKEN: z.string().optional(),
     API_RATE_LIMIT_WINDOW_MS: z.string().optional(),
     API_RATE_LIMIT_GENERAL_MAX: z.string().optional(),
     API_RATE_LIMIT_AUTH_MAX: z.string().optional(),
@@ -50,7 +54,20 @@ const configSchema = z.object({
     CHAPTERHOUSE_SSE_BUFFER_CAPACITY: z.string().optional(),
     CHAPTERHOUSE_SSE_REPLAY_LIMIT: z.string().optional(),
     CHAPTERHOUSE_WORKIQ_AUTO_INSTALL: z.string().optional(),
+    CHAPTERHOUSE_SELF_EDIT: z.string().optional(),
+    CHAPTERHOUSE_OPEN_BROWSER: z.string().optional(),
+    CHAPTERHOUSE_RESTARTED: z.string().optional(),
+    CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS: z.string().optional(),
     CHAPTERHOUSE_CHAT_SSE: z.string().optional(),
+    CHAPTERHOUSE_INJECT_DATE: z.string().optional(),
+    CHAPTERHOUSE_SESSION_AGENT_NAME: z.string().optional(),
+    CHAPTERHOUSE_AGENT_NAME: z.string().optional(),
+    COPILOT_AGENT_NAME: z.string().optional(),
+    AGENT_NAME: z.string().optional(),
+    CHAPTERHOUSE_SESSION_IDLE_TTL_MS: z.string().optional(),
+    CHAPTERHOUSE_SESSION_MAX_ACTIVE: z.string().optional(),
+    CHAPTERHOUSE_ORCHESTRATOR_TIMEOUT_MS: z.string().optional(),
+    CHAPTERHOUSE_JSON_LIMIT: z.string().optional(),
     CHAPTERHOUSE_MEMORY_CHECKPOINT_ENABLED: z.string().optional(),
     CHAPTERHOUSE_MEMORY_CHECKPOINT_TURNS: z.string().optional(),
     CHAPTERHOUSE_MEMORY_CHECKPOINT_ON_SCOPE_CHANGE: z.string().optional(),
@@ -58,9 +75,12 @@ const configSchema = z.object({
     CHAPTERHOUSE_MEMORY_INJECT: z.string().optional(),
     CHAPTERHOUSE_MEMORY_AUTO_ACCEPT: z.string().optional(),
     CHAPTERHOUSE_MEMORY_EOT_HOOK_ENABLED: z.string().optional(),
+    CHAPTERHOUSE_MEMORY_EOT_FRICTION_ENABLED: z.string().optional(),
     CHAPTERHOUSE_MEMORY_HOOKS_ENABLED: z.string().optional(),
     CHAPTERHOUSE_MEMORY_HOUSEKEEPING_ENABLED: z.string().optional(),
     CHAPTERHOUSE_MEMORY_HOUSEKEEPING_TURNS: z.string().optional(),
+    CHAPTERHOUSE_MEMORY_HOUSEKEEPING_SIMILARITY_THRESHOLD: z.string().optional(),
+    CHAPTERHOUSE_MEMORY_CHECKPOINT_DUPLICATE_THRESHOLD: z.string().optional(),
     CHAPTERHOUSE_MEMORY_DECAY_DAYS: z.string().optional(),
     CHAPTERHOUSE_MEMORY_INBOX_RETENTION_DAYS: z.string().optional(),
     CHAPTERHOUSE_MEMORY_TIERING_ENABLED: z.string().optional(),
@@ -68,6 +88,7 @@ const configSchema = z.object({
     CHAPTERHOUSE_MEMORY_HOT_AGE_DAYS: z.string().optional(),
     CHAPTERHOUSE_PKB_CONSOLIDATION_ENABLED: z.string().optional(),
     CHAPTERHOUSE_PKB_CONSOLIDATION_HOUR: z.string().optional(),
+    CHAPTERHOUSE_PKB_TRUTH_REWRITE_BUDGET: z.string().optional(),
 });
 export const DEFAULT_MODEL = "claude-sonnet-4.6";
 export const DEFAULT_TEAM_WIKI_CACHE_TTL_MINUTES = 60;
@@ -82,13 +103,18 @@ export const DEFAULT_API_RATE_LIMIT_AUTH_MAX = 10;
 export const DEFAULT_API_RATE_LIMIT_SSE_MAX_CONNECTIONS = 5;
 export const DEFAULT_SSE_BUFFER_CAPACITY = 2_000;
 export const DEFAULT_SSE_REPLAY_LIMIT = 10_000;
+export const DEFAULT_JSON_BODY_LIMIT = "2mb";
+export const DEFAULT_PKB_TRUTH_REWRITE_BUDGET = 18;
 function parseZeroOneEnv(name, rawValue, defaultValue) {
     const normalized = rawValue?.trim();
     if (!normalized) {
         return defaultValue;
     }
+    if (normalized === "true" || normalized === "false") {
+        return normalized === "true";
+    }
     if (normalized !== "0" && normalized !== "1") {
-        throw new Error(`${name} must be '0' or '1', got: "${rawValue}"`);
+        throw new Error(`${name} must be '0', '1', 'true', or 'false', got: "${rawValue}"`);
     }
     return normalized === "1";
 }
@@ -143,6 +169,17 @@ function parsePositiveNumberEnv(name, rawValue, defaultValue) {
     }
     return parsed;
 }
+function parseUnitIntervalEnv(name, rawValue, defaultValue) {
+    const normalized = rawValue?.trim();
+    if (!normalized) {
+        return defaultValue;
+    }
+    const parsed = Number(normalized);
+    if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+        throw new Error(`${name} must be a number between 0 and 1, got: "${rawValue}"`);
+    }
+    return parsed;
+}
 function parseHourEnv(name, rawValue, defaultValue) {
     const normalized = rawValue?.trim();
     if (!normalized) {
@@ -308,12 +345,20 @@ export function parseRuntimeConfig(env, options = {}) {
     const memoryCheckpointTurns = parsePositiveIntegerEnv("CHAPTERHOUSE_MEMORY_CHECKPOINT_TURNS", raw.CHAPTERHOUSE_MEMORY_CHECKPOINT_TURNS, 5);
     const memoryCheckpointMinTurnsForScopeFire = parsePositiveIntegerEnv("CHAPTERHOUSE_MEMORY_CHECKPOINT_MIN_TURNS_FOR_SCOPE_FIRE", raw.CHAPTERHOUSE_MEMORY_CHECKPOINT_MIN_TURNS_FOR_SCOPE_FIRE, 2);
     const memoryHousekeepingTurns = parsePositiveIntegerEnv("CHAPTERHOUSE_MEMORY_HOUSEKEEPING_TURNS", raw.CHAPTERHOUSE_MEMORY_HOUSEKEEPING_TURNS, 50);
+    const memoryHousekeepingSimilarityThreshold = parseUnitIntervalEnv("CHAPTERHOUSE_MEMORY_HOUSEKEEPING_SIMILARITY_THRESHOLD", raw.CHAPTERHOUSE_MEMORY_HOUSEKEEPING_SIMILARITY_THRESHOLD, 0.8);
+    const memoryCheckpointDuplicateThreshold = parseUnitIntervalEnv("CHAPTERHOUSE_MEMORY_CHECKPOINT_DUPLICATE_THRESHOLD", raw.CHAPTERHOUSE_MEMORY_CHECKPOINT_DUPLICATE_THRESHOLD, 0.85);
     const memoryDecayDays = parsePositiveIntegerEnv("CHAPTERHOUSE_MEMORY_DECAY_DAYS", raw.CHAPTERHOUSE_MEMORY_DECAY_DAYS, 30);
     const memoryInboxRetentionDays = parsePositiveIntegerEnv("CHAPTERHOUSE_MEMORY_INBOX_RETENTION_DAYS", raw.CHAPTERHOUSE_MEMORY_INBOX_RETENTION_DAYS, 7);
     const memoryHotRecallBoost = parsePositiveNumberEnv("CHAPTERHOUSE_MEMORY_HOT_RECALL_BOOST", raw.CHAPTERHOUSE_MEMORY_HOT_RECALL_BOOST, 1.5);
     const memoryHotAgeDays = parsePositiveIntegerEnv("CHAPTERHOUSE_MEMORY_HOT_AGE_DAYS", raw.CHAPTERHOUSE_MEMORY_HOT_AGE_DAYS, 30);
     const pkbConsolidationEnabled = parseBooleanEnv("CHAPTERHOUSE_PKB_CONSOLIDATION_ENABLED", raw.CHAPTERHOUSE_PKB_CONSOLIDATION_ENABLED, true);
     const pkbConsolidationHour = parseHourEnv("CHAPTERHOUSE_PKB_CONSOLIDATION_HOUR", raw.CHAPTERHOUSE_PKB_CONSOLIDATION_HOUR, 3);
+    const jsonBodyLimit = raw.CHAPTERHOUSE_JSON_LIMIT?.trim() || DEFAULT_JSON_BODY_LIMIT;
+    const shutdownTimeoutMs = parsePositiveIntegerEnv("CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS", raw.CHAPTERHOUSE_SHUTDOWN_TIMEOUT_MS, 60_000);
+    const sessionIdleTtlMs = parsePositiveIntegerEnv("CHAPTERHOUSE_SESSION_IDLE_TTL_MS", raw.CHAPTERHOUSE_SESSION_IDLE_TTL_MS, 1_800_000);
+    const sessionMaxActive = parsePositiveIntegerEnv("CHAPTERHOUSE_SESSION_MAX_ACTIVE", raw.CHAPTERHOUSE_SESSION_MAX_ACTIVE, 20);
+    const orchestratorTimeoutMs = parsePositiveIntegerEnv("CHAPTERHOUSE_ORCHESTRATOR_TIMEOUT_MS", raw.CHAPTERHOUSE_ORCHESTRATOR_TIMEOUT_MS, 1_800_000);
+    const pkbTruthRewriteBudget = parsePositiveIntegerEnv("CHAPTERHOUSE_PKB_TRUTH_REWRITE_BUDGET", raw.CHAPTERHOUSE_PKB_TRUTH_REWRITE_BUDGET, DEFAULT_PKB_TRUTH_REWRITE_BUDGET);
     if (effectiveEntraAuthEnabled && (!effectiveEntraTenantId || !effectiveEntraClientId)) {
         throw new Error("ENTRA_AUTH_ENABLED=true requires ENTRA_TENANT_ID and ENTRA_CLIENT_ID");
     }
@@ -323,7 +368,9 @@ export function parseRuntimeConfig(env, options = {}) {
     return {
         nodeEnv,
         isProduction,
+        disableDotenv: raw.CHAPTERHOUSE_DISABLE_DOTENV === "1",
         chapterhouseMode: parsedMode,
+        explicitChapterhouseMode: raw.CHAPTERHOUSE_MODE?.trim() || "",
         apiHost: parsedHost,
         apiPort: parsedPort,
         standupTime: parsedStandupTime,
@@ -332,16 +379,18 @@ export function parseRuntimeConfig(env, options = {}) {
         adoProject: raw.ADO_PROJECT?.trim() || DEFAULT_ADO_PROJECT,
         adoPat: raw.ADO_PAT?.trim() || "",
         workerTimeoutMs: parsedWorkerTimeout,
+        shellPath: raw.PATH?.trim() || "",
         entraTenantId: effectiveEntraTenantId,
         entraClientId: effectiveEntraClientId,
         entraRequiredRole: effectiveEntraRequiredRole,
         entraTeamLeadId: effectiveEntraTeamLeadId,
         entraAuthEnabled: effectiveEntraAuthEnabled,
+        apiToken,
         standaloneMode,
         corsAllowedOrigins: parseCorsAllowedOrigins(raw.CORS_ALLOWED_ORIGINS),
         copilotModel: raw.COPILOT_MODEL || DEFAULT_MODEL,
         copilotAuthToken: raw.COPILOT_TOKEN?.trim() || raw.GITHUB_TOKEN?.trim() || "",
-        selfEditEnabled: env.CHAPTERHOUSE_SELF_EDIT === "1",
+        selfEditEnabled: raw.CHAPTERHOUSE_SELF_EDIT === "1",
         teamChapterhouseUrl: parseOptionalUrl("TEAM_CHAPTERHOUSE_URL", raw.TEAM_CHAPTERHOUSE_URL),
         teamChapterhouseToken: raw.TEAM_CHAPTERHOUSE_TOKEN?.trim() || "",
         teamWikiCacheTtlMinutes: parsedTeamWikiCacheTtlMinutes,
@@ -356,7 +405,23 @@ export function parseRuntimeConfig(env, options = {}) {
         sseBufferCapacity,
         sseReplayLimit,
         workiqAutoInstall: parseBooleanEnv("CHAPTERHOUSE_WORKIQ_AUTO_INSTALL", raw.CHAPTERHOUSE_WORKIQ_AUTO_INSTALL, true),
+        logLevel: raw.LOG_LEVEL?.trim() || undefined,
+        shutdownTimeoutMs,
+        telegramBotTokenConfigured: Boolean(raw.TELEGRAM_BOT_TOKEN?.trim()),
+        openBrowserOnStart: raw.CHAPTERHOUSE_OPEN_BROWSER === "1",
+        restarted: raw.CHAPTERHOUSE_RESTARTED === "1",
+        injectDate: raw.CHAPTERHOUSE_INJECT_DATE !== "0",
+        agentNameCandidates: [
+            raw.CHAPTERHOUSE_SESSION_AGENT_NAME,
+            raw.CHAPTERHOUSE_AGENT_NAME,
+            raw.COPILOT_AGENT_NAME,
+            raw.AGENT_NAME,
+        ].map((value) => value?.trim() || "").filter(Boolean),
+        sessionIdleTtlMs,
+        sessionMaxActive,
+        orchestratorTimeoutMs,
         chatSseEnabled: parseZeroOneEnv("CHAPTERHOUSE_CHAT_SSE", raw.CHAPTERHOUSE_CHAT_SSE, true),
+        jsonBodyLimit,
         memoryCheckpointEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_CHECKPOINT_ENABLED", raw.CHAPTERHOUSE_MEMORY_CHECKPOINT_ENABLED, true),
         memoryCheckpointTurns,
         memoryCheckpointOnScopeChange: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_CHECKPOINT_ON_SCOPE_CHANGE", raw.CHAPTERHOUSE_MEMORY_CHECKPOINT_ON_SCOPE_CHANGE, true),
@@ -364,9 +429,12 @@ export function parseRuntimeConfig(env, options = {}) {
         memoryInjectEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_INJECT", raw.CHAPTERHOUSE_MEMORY_INJECT, true),
         memoryAutoAcceptEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_AUTO_ACCEPT", raw.CHAPTERHOUSE_MEMORY_AUTO_ACCEPT, true),
         memoryEndOfTaskHookEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_EOT_HOOK_ENABLED", raw.CHAPTERHOUSE_MEMORY_EOT_HOOK_ENABLED, true),
+        memoryEndOfTaskFrictionEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_EOT_FRICTION_ENABLED", raw.CHAPTERHOUSE_MEMORY_EOT_FRICTION_ENABLED, false),
         memoryHooksEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_HOOKS_ENABLED", raw.CHAPTERHOUSE_MEMORY_HOOKS_ENABLED, true),
         memoryHousekeepingEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_HOUSEKEEPING_ENABLED", raw.CHAPTERHOUSE_MEMORY_HOUSEKEEPING_ENABLED, true),
         memoryHousekeepingTurns,
+        memoryHousekeepingSimilarityThreshold,
+        memoryCheckpointDuplicateThreshold,
         memoryDecayDays,
         memoryInboxRetentionDays,
         memoryTieringEnabled: parseZeroOneEnv("CHAPTERHOUSE_MEMORY_TIERING_ENABLED", raw.CHAPTERHOUSE_MEMORY_TIERING_ENABLED, true),
@@ -374,75 +442,100 @@ export function parseRuntimeConfig(env, options = {}) {
         memoryHotAgeDays,
         pkbConsolidationEnabled,
         pkbConsolidationHour,
+        pkbTruthRewriteBudget,
         modeCompatibilityWarnings,
     };
 }
 const runtimeConfig = parseRuntimeConfig(process.env);
 let _copilotModel = runtimeConfig.copilotModel;
+let _adoPatOverride;
+function currentRuntimeConfig() {
+    return parseRuntimeConfig(process.env);
+}
 export const config = {
-    nodeEnv: runtimeConfig.nodeEnv,
-    isProduction: runtimeConfig.isProduction,
-    chapterhouseMode: runtimeConfig.chapterhouseMode,
-    apiHost: runtimeConfig.apiHost,
-    apiPort: runtimeConfig.apiPort,
-    standupTime: runtimeConfig.standupTime,
-    adoOrg: runtimeConfig.adoOrg,
-    adoProject: runtimeConfig.adoProject,
-    adoPat: runtimeConfig.adoPat,
+    get nodeEnv() { return currentRuntimeConfig().nodeEnv; },
+    get isProduction() { return currentRuntimeConfig().isProduction; },
+    get disableDotenv() { return currentRuntimeConfig().disableDotenv; },
+    get chapterhouseMode() { return currentRuntimeConfig().chapterhouseMode; },
+    get explicitChapterhouseMode() { return currentRuntimeConfig().explicitChapterhouseMode; },
+    get apiHost() { return currentRuntimeConfig().apiHost; },
+    get apiPort() { return currentRuntimeConfig().apiPort; },
+    get standupTime() { return currentRuntimeConfig().standupTime; },
+    get adoOrg() { return currentRuntimeConfig().adoOrg; },
+    get adoProject() { return currentRuntimeConfig().adoProject; },
+    get adoPat() { return _adoPatOverride ?? currentRuntimeConfig().adoPat; },
+    set adoPat(value) { _adoPatOverride = value; },
     get ADO_ORG() {
-        return runtimeConfig.adoOrg;
+        return currentRuntimeConfig().adoOrg;
     },
     get ADO_PROJECT() {
-        return runtimeConfig.adoProject;
+        return currentRuntimeConfig().adoProject;
     },
-    workerTimeoutMs: runtimeConfig.workerTimeoutMs,
-    entraTenantId: runtimeConfig.entraTenantId,
-    entraClientId: runtimeConfig.entraClientId,
-    entraRequiredRole: runtimeConfig.entraRequiredRole,
-    entraTeamLeadId: runtimeConfig.entraTeamLeadId,
-    entraAuthEnabled: runtimeConfig.entraAuthEnabled,
-    standaloneMode: runtimeConfig.standaloneMode,
-    corsAllowedOrigins: runtimeConfig.corsAllowedOrigins,
-    teamChapterhouseUrl: runtimeConfig.teamChapterhouseUrl,
-    teamChapterhouseToken: runtimeConfig.teamChapterhouseToken,
-    teamWikiCacheTtlMinutes: runtimeConfig.teamWikiCacheTtlMinutes,
-    teamWikiPaths: runtimeConfig.teamWikiPaths,
-    wikiEntityCategories: runtimeConfig.wikiEntityCategories,
-    teamsWebhookUrl: runtimeConfig.teamsWebhookUrl,
-    teamsNotificationsEnabled: runtimeConfig.teamsNotificationsEnabled,
-    apiRateLimitWindowMs: runtimeConfig.apiRateLimitWindowMs,
-    apiRateLimitGeneralMax: runtimeConfig.apiRateLimitGeneralMax,
-    apiRateLimitAuthMax: runtimeConfig.apiRateLimitAuthMax,
-    apiRateLimitSseMaxConnections: runtimeConfig.apiRateLimitSseMaxConnections,
-    sseBufferCapacity: runtimeConfig.sseBufferCapacity,
-    sseReplayLimit: runtimeConfig.sseReplayLimit,
-    workiqAutoInstall: runtimeConfig.workiqAutoInstall,
-    chatSseEnabled: runtimeConfig.chatSseEnabled,
-    memoryCheckpointEnabled: runtimeConfig.memoryCheckpointEnabled,
-    memoryCheckpointTurns: runtimeConfig.memoryCheckpointTurns,
-    memoryCheckpointOnScopeChange: runtimeConfig.memoryCheckpointOnScopeChange,
-    memoryCheckpointMinTurnsForScopeFire: runtimeConfig.memoryCheckpointMinTurnsForScopeFire,
-    memoryInjectEnabled: runtimeConfig.memoryInjectEnabled,
-    memoryAutoAcceptEnabled: runtimeConfig.memoryAutoAcceptEnabled,
-    memoryEndOfTaskHookEnabled: runtimeConfig.memoryEndOfTaskHookEnabled,
-    memoryHooksEnabled: runtimeConfig.memoryHooksEnabled,
-    memoryHousekeepingEnabled: runtimeConfig.memoryHousekeepingEnabled,
-    memoryHousekeepingTurns: runtimeConfig.memoryHousekeepingTurns,
-    memoryDecayDays: runtimeConfig.memoryDecayDays,
-    memoryInboxRetentionDays: runtimeConfig.memoryInboxRetentionDays,
-    memoryTieringEnabled: runtimeConfig.memoryTieringEnabled,
-    memoryHotRecallBoost: runtimeConfig.memoryHotRecallBoost,
-    memoryHotAgeDays: runtimeConfig.memoryHotAgeDays,
-    pkbConsolidationEnabled: runtimeConfig.pkbConsolidationEnabled,
-    pkbConsolidationHour: runtimeConfig.pkbConsolidationHour,
+    get workerTimeoutMs() { return currentRuntimeConfig().workerTimeoutMs; },
+    get shellPath() { return currentRuntimeConfig().shellPath; },
+    get entraTenantId() { return currentRuntimeConfig().entraTenantId; },
+    get entraClientId() { return currentRuntimeConfig().entraClientId; },
+    get entraRequiredRole() { return currentRuntimeConfig().entraRequiredRole; },
+    get entraTeamLeadId() { return currentRuntimeConfig().entraTeamLeadId; },
+    get entraAuthEnabled() { return currentRuntimeConfig().entraAuthEnabled; },
+    get apiToken() { return currentRuntimeConfig().apiToken; },
+    get standaloneMode() { return currentRuntimeConfig().standaloneMode; },
+    get corsAllowedOrigins() { return currentRuntimeConfig().corsAllowedOrigins; },
+    get teamChapterhouseUrl() { return currentRuntimeConfig().teamChapterhouseUrl; },
+    get teamChapterhouseToken() { return currentRuntimeConfig().teamChapterhouseToken; },
+    get teamWikiCacheTtlMinutes() { return currentRuntimeConfig().teamWikiCacheTtlMinutes; },
+    get teamWikiPaths() { return currentRuntimeConfig().teamWikiPaths; },
+    get wikiEntityCategories() { return currentRuntimeConfig().wikiEntityCategories; },
+    get teamsWebhookUrl() { return currentRuntimeConfig().teamsWebhookUrl; },
+    get teamsNotificationsEnabled() { return currentRuntimeConfig().teamsNotificationsEnabled; },
+    get apiRateLimitWindowMs() { return currentRuntimeConfig().apiRateLimitWindowMs; },
+    get apiRateLimitGeneralMax() { return currentRuntimeConfig().apiRateLimitGeneralMax; },
+    get apiRateLimitAuthMax() { return currentRuntimeConfig().apiRateLimitAuthMax; },
+    get apiRateLimitSseMaxConnections() { return currentRuntimeConfig().apiRateLimitSseMaxConnections; },
+    get sseBufferCapacity() { return currentRuntimeConfig().sseBufferCapacity; },
+    get sseReplayLimit() { return currentRuntimeConfig().sseReplayLimit; },
+    get workiqAutoInstall() { return currentRuntimeConfig().workiqAutoInstall; },
+    get logLevel() { return currentRuntimeConfig().logLevel; },
+    get shutdownTimeoutMs() { return currentRuntimeConfig().shutdownTimeoutMs; },
+    get telegramBotTokenConfigured() { return currentRuntimeConfig().telegramBotTokenConfigured; },
+    get openBrowserOnStart() { return currentRuntimeConfig().openBrowserOnStart; },
+    get restarted() { return currentRuntimeConfig().restarted; },
+    get injectDate() { return currentRuntimeConfig().injectDate; },
+    get agentNameCandidates() { return currentRuntimeConfig().agentNameCandidates; },
+    get sessionIdleTtlMs() { return currentRuntimeConfig().sessionIdleTtlMs; },
+    get sessionMaxActive() { return currentRuntimeConfig().sessionMaxActive; },
+    get orchestratorTimeoutMs() { return currentRuntimeConfig().orchestratorTimeoutMs; },
+    get chatSseEnabled() { return currentRuntimeConfig().chatSseEnabled; },
+    get jsonBodyLimit() { return currentRuntimeConfig().jsonBodyLimit; },
+    get memoryCheckpointEnabled() { return currentRuntimeConfig().memoryCheckpointEnabled; },
+    get memoryCheckpointTurns() { return currentRuntimeConfig().memoryCheckpointTurns; },
+    get memoryCheckpointOnScopeChange() { return currentRuntimeConfig().memoryCheckpointOnScopeChange; },
+    get memoryCheckpointMinTurnsForScopeFire() { return currentRuntimeConfig().memoryCheckpointMinTurnsForScopeFire; },
+    get memoryInjectEnabled() { return currentRuntimeConfig().memoryInjectEnabled; },
+    get memoryAutoAcceptEnabled() { return currentRuntimeConfig().memoryAutoAcceptEnabled; },
+    get memoryEndOfTaskHookEnabled() { return currentRuntimeConfig().memoryEndOfTaskHookEnabled; },
+    get memoryEndOfTaskFrictionEnabled() { return currentRuntimeConfig().memoryEndOfTaskFrictionEnabled; },
+    get memoryHooksEnabled() { return currentRuntimeConfig().memoryHooksEnabled; },
+    get memoryHousekeepingEnabled() { return currentRuntimeConfig().memoryHousekeepingEnabled; },
+    get memoryHousekeepingTurns() { return currentRuntimeConfig().memoryHousekeepingTurns; },
+    get memoryHousekeepingSimilarityThreshold() { return currentRuntimeConfig().memoryHousekeepingSimilarityThreshold; },
+    get memoryCheckpointDuplicateThreshold() { return currentRuntimeConfig().memoryCheckpointDuplicateThreshold; },
+    get memoryDecayDays() { return currentRuntimeConfig().memoryDecayDays; },
+    get memoryInboxRetentionDays() { return currentRuntimeConfig().memoryInboxRetentionDays; },
+    get memoryTieringEnabled() { return currentRuntimeConfig().memoryTieringEnabled; },
+    get memoryHotRecallBoost() { return currentRuntimeConfig().memoryHotRecallBoost; },
+    get memoryHotAgeDays() { return currentRuntimeConfig().memoryHotAgeDays; },
+    get pkbConsolidationEnabled() { return currentRuntimeConfig().pkbConsolidationEnabled; },
+    get pkbConsolidationHour() { return currentRuntimeConfig().pkbConsolidationHour; },
+    get pkbTruthRewriteBudget() { return currentRuntimeConfig().pkbTruthRewriteBudget; },
     get PKB_CONSOLIDATION_ENABLED() {
-        return runtimeConfig.pkbConsolidationEnabled;
+        return currentRuntimeConfig().pkbConsolidationEnabled;
     },
     get PKB_CONSOLIDATION_HOUR() {
-        return runtimeConfig.pkbConsolidationHour;
+        return currentRuntimeConfig().pkbConsolidationHour;
     },
-    modeCompatibilityWarnings: runtimeConfig.modeCompatibilityWarnings,
-    copilotAuthToken: runtimeConfig.copilotAuthToken,
+    get modeCompatibilityWarnings() { return currentRuntimeConfig().modeCompatibilityWarnings; },
+    get copilotAuthToken() { return currentRuntimeConfig().copilotAuthToken; },
     get copilotModel() {
         return _copilotModel;
     },
@@ -450,7 +543,7 @@ export const config = {
         _copilotModel = model;
     },
     get selfEditEnabled() {
-        return runtimeConfig.selfEditEnabled;
+        return currentRuntimeConfig().selfEditEnabled;
     },
 };
 /** Update or append an env var in ~/.chapterhouse/.env */

package/dist/config.test.js

@@ -112,6 +112,19 @@ test("defaults chat SSE on and still honors explicit CHAPTERHOUSE_CHAT_SSE overr
     assert.equal(parsedDisabled.chatSseEnabled, false);
     assert.equal(parsedEnabled.chatSseEnabled, true);
 });
+test("parses configurable JSON body and consolidation truth rewrite limits", async () => {
+    const configModule = await import("./config.js");
+    assert.equal(typeof configModule.parseRuntimeConfig, "function", "parseRuntimeConfig should be exported");
+    const parsedDefault = configModule.parseRuntimeConfig({});
+    const parsedExplicit = configModule.parseRuntimeConfig({
+        CHAPTERHOUSE_JSON_LIMIT: "8mb",
+        CHAPTERHOUSE_PKB_TRUTH_REWRITE_BUDGET: "7",
+    });
+    assert.equal(parsedDefault.jsonBodyLimit, "2mb");
+    assert.equal(parsedDefault.pkbTruthRewriteBudget, 18);
+    assert.equal(parsedExplicit.jsonBodyLimit, "8mb");
+    assert.equal(parsedExplicit.pkbTruthRewriteBudget, 7);
+});
 test("defaults memory checkpoint turns to 5 and parses integer overrides", async () => {
     const configModule = await import("./config.js");
     assert.equal(typeof configModule.parseRuntimeConfig, "function", "parseRuntimeConfig should be exported");
@@ -197,15 +210,31 @@ test("parses memory housekeeping config defaults and overrides", async () => {
         CHAPTERHOUSE_MEMORY_HOUSEKEEPING_TURNS: "12",
         CHAPTERHOUSE_MEMORY_DECAY_DAYS: "45",
         CHAPTERHOUSE_MEMORY_INBOX_RETENTION_DAYS: "14",
+        CHAPTERHOUSE_MEMORY_HOUSEKEEPING_SIMILARITY_THRESHOLD: "0.91",
+        CHAPTERHOUSE_MEMORY_CHECKPOINT_DUPLICATE_THRESHOLD: "0.72",
     });
     assert.equal(parsedDefault.memoryHousekeepingEnabled, true);
     assert.equal(parsedDefault.memoryHousekeepingTurns, 50);
     assert.equal(parsedDefault.memoryDecayDays, 30);
     assert.equal(parsedDefault.memoryInboxRetentionDays, 7);
+    assert.equal(parsedDefault.memoryHousekeepingSimilarityThreshold, 0.8);
+    assert.equal(parsedDefault.memoryCheckpointDuplicateThreshold, 0.85);
     assert.equal(parsedOverride.memoryHousekeepingEnabled, false);
     assert.equal(parsedOverride.memoryHousekeepingTurns, 12);
     assert.equal(parsedOverride.memoryDecayDays, 45);
     assert.equal(parsedOverride.memoryInboxRetentionDays, 14);
+    assert.equal(parsedOverride.memoryHousekeepingSimilarityThreshold, 0.91);
+    assert.equal(parsedOverride.memoryCheckpointDuplicateThreshold, 0.72);
+});
+test("rejects memory similarity thresholds outside the 0..1 range", async () => {
+    const configModule = await import("./config.js");
+    assert.equal(typeof configModule.parseRuntimeConfig, "function", "parseRuntimeConfig should be exported");
+    assert.throws(() => configModule.parseRuntimeConfig({
+        CHAPTERHOUSE_MEMORY_HOUSEKEEPING_SIMILARITY_THRESHOLD: "1.1",
+    }), /CHAPTERHOUSE_MEMORY_HOUSEKEEPING_SIMILARITY_THRESHOLD must be a number between 0 and 1/);
+    assert.throws(() => configModule.parseRuntimeConfig({
+        CHAPTERHOUSE_MEMORY_CHECKPOINT_DUPLICATE_THRESHOLD: "-0.1",
+    }), /CHAPTERHOUSE_MEMORY_CHECKPOINT_DUPLICATE_THRESHOLD must be a number between 0 and 1/);
 });
 test("defaults automatic proposal acceptance on and still honors explicit CHAPTERHOUSE_MEMORY_AUTO_ACCEPT overrides", async () => {
     const configModule = await import("./config.js");

package/dist/copilot/okr-mapper.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
 import { join } from "node:path";
+import { getChapterhouseHome } from "../paths.js";
 const STOP_WORDS = new Set([
     "about", "after", "against", "been", "from", "into", "just", "that", "their", "them",
     "then", "they", "this", "today", "work", "worked", "yesterday",
@@ -8,11 +8,9 @@ const STOP_WORDS = new Set([
 const MIN_HISTORY_CONFIDENCE = 2;
 export class OKRMapper {
     teamWikiSync;
-    _adoClient;
     learnedMappings;
     constructor(teamWikiSync, _adoClient) {
         this.teamWikiSync = teamWikiSync;
-        this._adoClient = _adoClient;
         this.learnedMappings = loadLearnedMappings();
     }
     recordConfirmedMapping(activity, krId) {
@@ -181,14 +179,7 @@ function saveLearnedMappings(store) {
     writeFileSync(join(wikiDir, ".okr-memory.json"), `${JSON.stringify(store, null, 2)}\n`);
 }
 function getWikiDir() {
-    const configuredHome = process.env.CHAPTERHOUSE_HOME?.trim();
-    if (!configuredHome) {
-        return join(homedir(), ".chapterhouse", "wiki");
-    }
-    const chapterhouseHome = configuredHome.endsWith(".chapterhouse")
-        ? configuredHome
-        : join(configuredHome, ".chapterhouse");
-    return join(chapterhouseHome, "wiki");
+    return join(getChapterhouseHome(), "wiki");
 }
 function getOkrMemoryPath() {
     return join(getWikiDir(), ".okr-memory.json");