chapterhouse 0.9.1 → 0.10.0

package/dist/wiki/migrate.js

@@ -33,6 +33,7 @@ const CATEGORY_MAP = {
 export function migrateMemoriesToWiki() {
     ensureWikiStructure();
     const db = getDb();
+    ensureWikiMigrationVersionTable(db);
     const rows = db.prepare(`SELECT id, category, content, source, created_at FROM memories ORDER BY category, id`).all();
     if (rows.length === 0) {
         setState(MIGRATION_KEY, "true");
@@ -73,30 +74,26 @@ export function migrateMemoriesToWiki() {
         lines.push("");
         // Check if a page already exists (avoid clobbering manual content)
         const existing = readPage(mapping.path);
-        // Idempotency marker: if the migration block was already appended, skip the
-        // append so re-runs don't duplicate bullets.
-        const MIGRATE_MARKER = `<!-- migrate:${category}:v1 -->`;
+        backfillMemoryMigrationVersionFromLegacyMarker(db, category, mapping.path, existing);
+        if (hasWikiMigrationVersion(db, category, 1)) {
+            const entry = {
+                path: mapping.path,
+                title: mapping.title,
+                summary: `${items.length} ${category} memories (already migrated)`,
+                section: mapping.section,
+            };
+            addToIndex(entry);
+            continue;
+        }
         if (existing) {
-            if (existing.includes(MIGRATE_MARKER)) {
-                // Already migrated; just refresh the index entry.
-                const entry = {
-                    path: mapping.path,
-                    title: mapping.title,
-                    summary: `${items.length} ${category} memories (already migrated)`,
-                    section: mapping.section,
-                };
-                addToIndex(entry);
-                continue;
-            }
             // Extract only the bullet-point items to append
             const bulletLines = lines.filter((l) => l.startsWith("- "));
-            writePage(mapping.path, existing + `\n${MIGRATE_MARKER}\n## Migrated Memories\n\n` + bulletLines.join("\n") + "\n");
+            writePage(mapping.path, existing + `\n## Migrated Memories\n\n` + bulletLines.join("\n") + "\n");
         }
         else {
-            // Embed the marker in fresh pages too so future re-runs are no-ops.
-            lines.splice(lines.length - 1, 0, MIGRATE_MARKER);
             writePage(mapping.path, lines.join("\n"));
         }
+        setWikiMigrationVersion(db, category, 1);
         // Update index
         const entry = {
             path: mapping.path,
@@ -113,6 +110,36 @@ export function migrateMemoriesToWiki() {
     log.info({ total, pageCount: Object.keys(grouped).length }, "Wiki migration complete");
     return total;
 }
+function ensureWikiMigrationVersionTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS wiki_migration_versions (
+      name TEXT NOT NULL,
+      version INTEGER NOT NULL,
+      applied_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      PRIMARY KEY (name, version)
+    )
+  `);
+}
+function hasWikiMigrationVersion(db, category, version) {
+    const row = db.prepare(`SELECT 1 FROM wiki_migration_versions WHERE name = ? AND version = ?`).get(`memory:${category}`, version);
+    return Boolean(row);
+}
+function setWikiMigrationVersion(db, category, version) {
+    db.prepare(`
+    INSERT OR IGNORE INTO wiki_migration_versions (name, version)
+    VALUES (?, ?)
+  `).run(`memory:${category}`, version);
+}
+function backfillMemoryMigrationVersionFromLegacyMarker(db, category, path, existing) {
+    if (existing?.includes(`<!-- migrate:${category}:v1 -->`)) {
+        setWikiMigrationVersion(db, category, 1);
+        return;
+    }
+    const markerPage = readPage(path);
+    if (markerPage?.includes(`<!-- migrate:${category}:v1 -->`)) {
+        setWikiMigrationVersion(db, category, 1);
+    }
+}
 // ---------------------------------------------------------------------------
 // One-time reorganization: flat dump pages → entity pages
 // ---------------------------------------------------------------------------

package/dist/wiki/project-registry.js

@@ -1,4 +1,4 @@
-import { isAbsolute } from "node:path";
+import { isAbsolute, resolve } from "node:path";
 import { getDb } from "../store/db.js";
 import { childLogger } from "../util/logger.js";
 import { deletePage, pageExists, readPage } from "./fs.js";
@@ -13,12 +13,14 @@ export function loadRegistry() {
     const rows = getDb()
         .prepare("SELECT slug, cwd FROM projects ORDER BY slug")
         .all();
-    return Object.fromEntries(rows.map(({ slug, cwd }) => [slug, cwd]));
+    return Object.fromEntries(rows.map(({ slug, cwd }) => [slug, normalizeProjectPath(cwd)]));
 }
 export function saveRegistry(registry) {
     validateRegistry(registry);
     ensureRegistryMigrated();
-    const entries = Object.entries(registry).sort(([left], [right]) => left.localeCompare(right));
+    const entries = Object.entries(registry)
+        .map(([slug, cwd]) => [slug, normalizeProjectPath(cwd)])
+        .sort(([left], [right]) => left.localeCompare(right));
     const db = getDb();
     const save = db.transaction(() => {
         db.prepare("DELETE FROM projects").run();
@@ -138,9 +140,8 @@ function parseRegistryBlock(lines) {
             throw new Error(`Project registry is malformed: malformed registry line '${rawLine}'.`);
         }
         const slug = line.slice(0, separatorIndex).trim();
-        const path = line.slice(separatorIndex + 1).trim();
+        const path = normalizeProjectPath(line.slice(separatorIndex + 1).trim());
         assertValidProjectSlug(slug);
-        validatePath(path);
         if (slug in registry) {
             throw new Error(`Project registry is malformed: duplicate project slug '${slug}'.`);
         }
@@ -154,6 +155,10 @@ function validateRegistry(registry) {
         validatePath(path);
     }
 }
+export function normalizeProjectPath(path) {
+    validatePath(path);
+    return resolve(path);
+}
 function validatePath(path) {
     if (!path || !isAbsolute(path)) {
         throw new Error(`Project registry path '${path}' must be an absolute path.`);

package/dist/wiki/project-registry.test.js

@@ -79,6 +79,20 @@ test("saveRegistry replaces prior SQLite-backed registry contents", async () =>
         dbModule.closeDb();
     }
 });
+test("saveRegistry normalizes absolute project paths before persisting", async () => {
+    const { projectRegistry, dbModule } = await loadModules();
+    try {
+        projectRegistry.saveRegistry({
+            alpha: "/srv/projects/../alpha/",
+        });
+        assert.deepEqual(projectRegistry.loadRegistry(), {
+            alpha: "/srv/alpha",
+        });
+    }
+    finally {
+        dbModule.closeDb();
+    }
+});
 test("loadRegistry migrates the legacy wiki registry into SQLite and removes the file", async () => {
     const { projectRegistry, wikiFs, dbModule } = await loadModules();
     try {

package/dist/wiki/scheduler.js

@@ -16,7 +16,7 @@ export class WikiConsolidationScheduler {
     started = false;
     running = false;
     constructor(options = {}) {
-        this.env = options.env ?? process.env;
+        this.env = options.env ?? {};
         this.runConsolidationImpl = options.runConsolidation ?? (() => runConsolidation(getDb()));
         this.now = options.now ?? (() => new Date());
         this.log = options.log ?? childLogger("wiki.scheduler");

package/dist/wiki/seed-team-wiki.js

@@ -2,6 +2,7 @@ import { fileURLToPath } from "node:url";
 import { resolve } from "node:path";
 import { ensureWikiStructure, readPage, writePage } from "./fs.js";
 import { addToIndex, buildIndexEntryForPage } from "./index-manager.js";
+import { withWikiWrite } from "./lock.js";
 import { generateKPIPage, generateOKRQuarterPage, generateTeamIndexPage, } from "./templates/okr.js";
 import { childLogger } from "../util/logger.js";
 const log = childLogger("wiki:seed");
@@ -281,7 +282,7 @@ export function seedTeamWiki() {
     return { created, existing };
 }
 async function main() {
-    const result = seedTeamWiki();
+    const result = await withWikiWrite(() => seedTeamWiki());
     const message = result.created.length > 0
         ? `Seeded ${result.created.length} team wiki page(s): ${result.created.join(", ")}`
         : "Team wiki seed already up to date; no pages created.";

package/dist/wiki/team-sync.js

@@ -5,8 +5,21 @@ import { ModeContext } from "../mode-context.js";
 import { WIKI_DIR } from "../paths.js";
 import { assertPagePath, readPage, writePage, writeFileAtomic } from "./fs.js";
 import { addToIndex, buildIndexEntryForPage } from "./index-manager.js";
+import { withWikiWrite } from "./lock.js";
 import { childLogger } from "../util/logger.js";
 const log = childLogger("team-sync");
+const DEFAULT_RATE_LIMIT_RETRY_MS = 1_000;
+function parseRetryAfterMs(value) {
+    if (!value) {
+        return DEFAULT_RATE_LIMIT_RETRY_MS;
+    }
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return seconds * 1000;
+    }
+    const dateMs = Date.parse(value);
+    return Number.isFinite(dateMs) ? Math.max(DEFAULT_RATE_LIMIT_RETRY_MS, dateMs - Date.now()) : DEFAULT_RATE_LIMIT_RETRY_MS;
+}
 export class TeamWikiSync {
     teamChapterhouseUrl;
     teamChapterhouseToken;
@@ -36,6 +49,7 @@ export class TeamWikiSync {
         this.now = options.now ?? (() => new Date());
         this.modeContext = new ModeContext({
             ...config,
+            chapterhouseMode: options.chapterhouseMode ?? config.chapterhouseMode,
             teamChapterhouseUrl: this.teamChapterhouseUrl,
             standaloneMode: this.standaloneMode,
         });
@@ -58,7 +72,7 @@ export class TeamWikiSync {
             return cachedContent;
         }
         try {
-            const response = await this.fetchImpl(this.buildPageUrl(path), {
+            const response = await this.fetchWithRateLimitBackoff(this.buildPageUrl(path), {
                 headers: this.buildHeaders(options.authorizationHeader),
             });
             if (!response.ok) {
@@ -85,6 +99,15 @@ export class TeamWikiSync {
             return null;
         }
     }
+    async fetchWithRateLimitBackoff(input, init) {
+        const response = await this.fetchImpl(input, init);
+        if (response.status !== 429) {
+            return response;
+        }
+        const retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
+        await new Promise((resolve) => setTimeout(resolve, retryAfterMs));
+        return this.fetchImpl(input, init);
+    }
     async syncAll(options = {}) {
         if (!this.isEnabled()) {
             return [];
@@ -103,11 +126,13 @@ export class TeamWikiSync {
             }
             const content = await this.fetchPage(path, options);
             if (content !== null) {
-                writePage(path, content);
-                const entry = buildIndexEntryForPage(path, { section: "Team" });
-                if (entry) {
-                    addToIndex(entry);
-                }
+                await withWikiWrite(() => {
+                    writePage(path, content);
+                    const entry = buildIndexEntryForPage(path, { section: "Team" });
+                    if (entry) {
+                        addToIndex(entry);
+                    }
+                });
                 synced.push(path);
             }
         }

package/dist/wiki/team-sync.test.js

@@ -36,6 +36,7 @@ test("uses fresh cache when TTL has not expired", async () => {
     }));
     let fetchCalls = 0;
     const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
         teamChapterhouseUrl: "https://team.example.com",
         standaloneMode: false,
         cacheTtlMinutes: 60,
@@ -64,6 +65,7 @@ test("re-fetches when cache is stale", async () => {
         },
     }));
     const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
         teamChapterhouseUrl: "https://team.example.com",
         standaloneMode: false,
         cacheTtlMinutes: 60,
@@ -90,6 +92,41 @@ test("re-fetches when cache is stale", async () => {
     const manifest = JSON.parse(readFileSync(join(cacheRoot, "manifest.json"), "utf-8"));
     assert.equal(manifest[pagePath]?.etag, '"fresh-q2"');
 });
+test("fetchPage retries once after a team wiki 429 response", async () => {
+    const teamSyncModule = await loadTeamSyncModule();
+    assert.ok(teamSyncModule, "team sync module should exist");
+    const wikiDir = makeWikiDir("rate-limit-retry");
+    const pagePath = "pages/team/rate-limit.md";
+    let fetchCalls = 0;
+    const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
+        teamChapterhouseUrl: "https://team.example.com",
+        standaloneMode: false,
+        cacheTtlMinutes: 60,
+        teamWikiPaths: ["pages/team"],
+        wikiDir,
+        fetchImpl: async () => {
+            fetchCalls += 1;
+            if (fetchCalls === 1) {
+                return new Response("rate limited", {
+                    status: 429,
+                    headers: { "retry-after": "0" },
+                });
+            }
+            return new Response(JSON.stringify({
+                path: pagePath,
+                content: "# Recovered\n",
+                exists: true,
+            }), {
+                status: 200,
+                headers: { "content-type": "application/json" },
+            });
+        },
+    });
+    const content = await sync.fetchPage(pagePath);
+    assert.equal(content, "# Recovered\n");
+    assert.equal(fetchCalls, 2);
+});
 test("returns stale cache on network failure with warning", async () => {
     const teamSyncModule = await loadTeamSyncModule();
     assert.ok(teamSyncModule, "team sync module should exist");
@@ -105,6 +142,7 @@ test("returns stale cache on network failure with warning", async () => {
     }));
     const warnings = [];
     const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
         teamChapterhouseUrl: "https://team.example.com",
         standaloneMode: false,
         cacheTtlMinutes: 60,
@@ -125,6 +163,7 @@ test("returns null when no cache exists and network fails", async () => {
     assert.ok(teamSyncModule, "team sync module should exist");
     const wikiDir = makeWikiDir("cold-miss");
     const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
         teamChapterhouseUrl: "https://team.example.com",
         standaloneMode: false,
         cacheTtlMinutes: 60,
@@ -141,6 +180,7 @@ test("isTeamPath matches configured team wiki prefixes", async () => {
     const teamSyncModule = await loadTeamSyncModule();
     assert.ok(teamSyncModule, "team sync module should exist");
     const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
         teamChapterhouseUrl: "https://team.example.com",
         standaloneMode: false,
         teamWikiPaths: ["pages/team", "pages/okrs", "pages/kpis", "pages/shared"],
@@ -152,11 +192,52 @@ test("isTeamPath matches configured team wiki prefixes", async () => {
     assert.equal(sync.isTeamPath("pages/shared/runbooks/deploy.md"), true);
     assert.equal(sync.isTeamPath("pages/private/notes.md"), false);
 });
+test("syncAll writes fetched team pages and refreshes the index", async () => {
+    const teamSyncModule = await loadTeamSyncModule();
+    assert.ok(teamSyncModule, "team sync module should exist");
+    const wikiDir = makeWikiDir("sync-all");
+    const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
+        teamChapterhouseUrl: "https://team.example.com",
+        standaloneMode: false,
+        cacheTtlMinutes: 60,
+        teamWikiPaths: ["pages/team", "pages/okrs", "pages/kpis"],
+        wikiDir,
+        fetchImpl: async (input) => {
+            const url = String(input);
+            if (url === "https://team.example.com/api/team/wiki") {
+                return new Response(JSON.stringify({
+                    pages: ["pages/team/vision.md", "pages/private/skip.md"],
+                }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            if (url === "https://team.example.com/api/team/wiki/pages%2Fteam%2Fvision.md") {
+                return new Response(JSON.stringify({
+                    path: "pages/team/vision.md",
+                    content: "---\ntitle: Team Vision\nsummary: Shared direction\nupdated: 2026-05-15\n---\n\n# Team Vision\n",
+                    exists: true,
+                }), {
+                    status: 200,
+                    headers: { "content-type": "application/json" },
+                });
+            }
+            throw new Error(`unexpected fetch: ${url}`);
+        },
+    });
+    const synced = await sync.syncAll();
+    const indexManager = await import(new URL(`./index-manager.js?cachebust=${Date.now()}-${Math.random()}`, import.meta.url).href);
+    assert.deepEqual(synced, ["pages/team/vision.md"]);
+    assert.equal(readFileSync(join(tmpRoot, ".chapterhouse", "wiki", "pages", "team", "vision.md"), "utf-8"), "---\ntitle: Team Vision\nsummary: Shared direction\nupdated: 2026-05-15\n---\n\n# Team Vision\n");
+    assert.ok(indexManager.parseIndex().some((entry) => entry.path === "pages/team/vision.md"));
+});
 test("pushUpdate silently no-ops when team wiki sync is disabled", async () => {
     const teamSyncModule = await loadTeamSyncModule();
     assert.ok(teamSyncModule, "team sync module should exist");
     let called = false;
     const sync = new teamSyncModule.TeamWikiSync({
+        chapterhouseMode: "team",
         teamChapterhouseUrl: "",
         standaloneMode: false,
         wikiDir: makeWikiDir("disabled-push"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chapterhouse",
-  "version": "0.9.1",
+  "version": "0.10.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"