chapterhouse 0.3.18 → 0.3.19

package/dist/wiki/fix.test.js

@@ -0,0 +1,350 @@
+import assert from "node:assert/strict";
+import { mkdirSync, rmSync, utimesSync } from "node:fs";
+import { join } from "node:path";
+import test from "node:test";
+const repoRoot = process.cwd();
+const sandboxRoot = join(repoRoot, ".test-work", `wiki-fix-${process.pid}`);
+process.env.CHAPTERHOUSE_HOME = sandboxRoot;
+process.env.CHAPTERHOUSE_AGENT_NAME = "wiki-fix-test-agent";
+async function loadModules() {
+    const nonce = `${Date.now()}-${Math.random()}`;
+    const fix = await import(new URL(`./fix.js?case=${nonce}`, import.meta.url).href);
+    const wikiFs = await import(new URL(`./fs.js?case=${nonce}`, import.meta.url).href);
+    return { fix, wikiFs };
+}
+function resetSandbox() {
+    mkdirSync(join(repoRoot, ".test-work"), { recursive: true });
+    rmSync(sandboxRoot, { recursive: true, force: true });
+}
+function wikiPath(relativePath) {
+    return join(sandboxRoot, ".chapterhouse", "wiki", ...relativePath.split("/"));
+}
+function setMtime(relativePath, isoDate) {
+    const timestamp = new Date(`${isoDate}T12:00:00.000Z`);
+    utimesSync(wikiPath(relativePath), timestamp, timestamp);
+}
+test.beforeEach(() => {
+    resetSandbox();
+});
+test.after(() => {
+    rmSync(sandboxRoot, { recursive: true, force: true });
+});
+test("fixWiki dry-run previews frontmatter backfills, tag normalization, and autostub marking without writing files", async () => {
+    const { fix, wikiFs } = await loadModules();
+    wikiFs.ensureWikiStructure();
+    wikiFs.writePage("pages/projects/alpha/index.md", `# Alpha Project
+
+Alpha project **launch** notes for the team.
+
+## Details
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/projects/empty/index.md", `# Empty Page
+`);
+    wikiFs.writePage("pages/projects/bravo/index.md", `---
+title: Bravo
+summary: Bravo deployment notes
+updated: 2026-05-10
+tags: [Run Book, Mystery]
+---
+
+# Bravo
+
+Deployment notes with enough body to avoid the stub marker.
+
+## Steps
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/projects/stub/index.md", `---
+title: Stub Page
+summary: Tiny page
+updated: 2026-05-10
+---
+
+# Stub Page
+
+Tiny.
+`);
+    wikiFs.writePage("pages/_meta/taxonomy.md", `## Process
+- runbook
+`);
+    setMtime("pages/projects/alpha/index.md", "2026-01-02");
+    setMtime("pages/projects/empty/index.md", "2026-01-03");
+    const beforeAlpha = wikiFs.readPage("pages/projects/alpha/index.md");
+    const beforeEmpty = wikiFs.readPage("pages/projects/empty/index.md");
+    const beforeBravo = wikiFs.readPage("pages/projects/bravo/index.md");
+    const beforeStub = wikiFs.readPage("pages/projects/stub/index.md");
+    const report = fix.fixWiki({ dryRun: true });
+    assert.equal(report.dryRun, true);
+    assert.equal(report.changedFiles, 4);
+    const alpha = report.files.find((entry) => entry.path === "pages/projects/alpha/index.md");
+    const empty = report.files.find((entry) => entry.path === "pages/projects/empty/index.md");
+    const bravo = report.files.find((entry) => entry.path === "pages/projects/bravo/index.md");
+    const stub = report.files.find((entry) => entry.path === "pages/projects/stub/index.md");
+    assert.deepEqual(alpha?.changes, [
+        { rule: "frontmatter-backfill", details: ["title", "summary", "updated"] },
+    ]);
+    assert.deepEqual(empty?.changes, [
+        { rule: "frontmatter-backfill", details: ["title", "summary", "updated", "autostub"] },
+    ]);
+    assert.deepEqual(bravo?.changes, [
+        { rule: "tag-normalize", details: ["Run Book -> runbook"] },
+    ]);
+    assert.deepEqual(bravo?.unknownTags, ["Mystery"]);
+    assert.deepEqual(stub?.changes, [
+        { rule: "autostub-mark", details: ["autostub"] },
+    ]);
+    assert.match(report.diff, /--- a\/pages\/projects\/alpha\/index\.md/);
+    assert.match(report.diff, /title: Alpha Project/);
+    assert.match(report.diff, /summary: Alpha project launch notes for the team\./);
+    assert.match(report.diff, /updated: 2026-01-02/);
+    assert.match(report.diff, /summary: \(no summary yet\)/);
+    assert.match(report.diff, /tags: \[runbook, Mystery\]/);
+    assert.match(report.diff, /autostub: true/);
+    assert.equal(wikiFs.readPage("pages/projects/alpha/index.md"), beforeAlpha);
+    assert.equal(wikiFs.readPage("pages/projects/empty/index.md"), beforeEmpty);
+    assert.equal(wikiFs.readPage("pages/projects/bravo/index.md"), beforeBravo);
+    assert.equal(wikiFs.readPage("pages/projects/stub/index.md"), beforeStub);
+});
+test("fixWiki applies changes, logs each applied rule, and is idempotent on the second run", async () => {
+    const { fix, wikiFs } = await loadModules();
+    wikiFs.ensureWikiStructure();
+    wikiFs.writePage("pages/projects/alpha/index.md", `# Alpha Project
+
+Alpha project launch notes for the team.
+
+## Details
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/projects/bravo/index.md", `---
+title: Bravo
+summary: Bravo deployment notes
+updated: 2026-05-10
+tags: [Run Book]
+---
+
+# Bravo
+
+Deployment notes with enough body to avoid the stub marker.
+
+## Steps
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/projects/stub/index.md", `---
+title: Stub Page
+summary: Tiny page
+updated: 2026-05-10
+---
+
+# Stub Page
+
+Tiny.
+`);
+    wikiFs.writePage("pages/_meta/taxonomy.md", `## Process
+- runbook
+`);
+    setMtime("pages/projects/alpha/index.md", "2026-01-02");
+    const logEntries = [];
+    const firstReport = fix.fixWiki({
+        dryRun: false,
+        logAction: (type, path) => logEntries.push(`${type}:${path}`),
+    });
+    assert.equal(firstReport.dryRun, false);
+    assert.equal(firstReport.changedFiles, 3);
+    assert.equal(firstReport.diff, "");
+    assert.match(wikiFs.readPage("pages/projects/alpha/index.md") ?? "", /title: Alpha Project/);
+    assert.match(wikiFs.readPage("pages/projects/alpha/index.md") ?? "", /updated: 2026-01-02/);
+    assert.match(wikiFs.readPage("pages/projects/bravo/index.md") ?? "", /tags: \[runbook\]/);
+    assert.match(wikiFs.readPage("pages/projects/stub/index.md") ?? "", /autostub: true/);
+    assert.deepEqual(logEntries, [
+        "fix-frontmatter:pages/projects/alpha/index.md",
+        "fix-tags:pages/projects/bravo/index.md",
+        "fix-autostub:pages/projects/stub/index.md",
+    ]);
+    const secondReport = fix.fixWiki({
+        dryRun: false,
+        logAction: (type, path) => logEntries.push(`${type}:${path}`),
+    });
+    assert.equal(secondReport.changedFiles, 0);
+    assert.equal(secondReport.diff, "");
+    assert.deepEqual(logEntries, [
+        "fix-frontmatter:pages/projects/alpha/index.md",
+        "fix-tags:pages/projects/bravo/index.md",
+        "fix-autostub:pages/projects/stub/index.md",
+    ]);
+});
+test("fixWiki respects fix toggles, path globs, autofix false, and pages/_meta skips", async () => {
+    const { fix, wikiFs } = await loadModules();
+    wikiFs.ensureWikiStructure();
+    wikiFs.writePage("pages/projects/match/index.md", `---
+title: Match
+summary: Match notes
+updated: 2026-05-10
+tags: [Run Book]
+---
+
+# Match
+
+Long enough body.
+
+## Details
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/projects/skip/index.md", `---
+title: Skip
+summary: Skip notes
+updated: 2026-05-10
+tags: [Run Book]
+autofix: false
+---
+
+# Skip
+
+Long enough body.
+
+## Details
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/people/alice/index.md", `---
+title: Alice
+summary: Alice notes
+updated: 2026-05-10
+tags: [Run Book]
+---
+
+# Alice
+
+Long enough body.
+
+## Details
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/_meta/manual.md", `---
+title: Manual
+summary: System page
+updated: 2026-05-10
+tags: [Run Book]
+---
+
+# Manual
+`);
+    wikiFs.writePage("pages/_meta/taxonomy.md", `## Process
+- runbook
+`);
+    const beforeSkip = wikiFs.readPage("pages/projects/skip/index.md");
+    const beforePeople = wikiFs.readPage("pages/people/alice/index.md");
+    const beforeMeta = wikiFs.readPage("pages/_meta/manual.md");
+    const report = fix.fixWiki({
+        dryRun: true,
+        fixes: ["tag-normalize"],
+        pathGlob: "pages/projects/**",
+    });
+    assert.equal(report.changedFiles, 1);
+    assert.deepEqual(report.files.map((entry) => entry.path), ["pages/projects/match/index.md"]);
+    assert.deepEqual(report.files[0]?.changes.map((change) => change.rule), ["tag-normalize"]);
+    assert.doesNotMatch(report.diff, /pages\/projects\/skip\/index\.md/);
+    assert.doesNotMatch(report.diff, /pages\/people\/alice\/index\.md/);
+    assert.doesNotMatch(report.diff, /pages\/_meta\/manual\.md/);
+    assert.equal(wikiFs.readPage("pages/projects/skip/index.md"), beforeSkip);
+    assert.equal(wikiFs.readPage("pages/people/alice/index.md"), beforePeople);
+    assert.equal(wikiFs.readPage("pages/_meta/manual.md"), beforeMeta);
+});
+test("fixWiki flags unmatched tags even when there is nothing to rewrite", async () => {
+    const { fix, wikiFs } = await loadModules();
+    wikiFs.ensureWikiStructure();
+    wikiFs.writePage("pages/projects/mystery/index.md", `---
+title: Mystery
+summary: Mystery notes
+updated: 2026-05-10
+tags: [Mystery]
+---
+
+# Mystery
+
+Long enough body.
+
+## Details
+
+One
+Two
+Three
+Four
+Five
+Six
+Seven
+Eight
+`);
+    wikiFs.writePage("pages/_meta/taxonomy.md", `## Process
+- runbook
+`);
+    const report = fix.fixWiki({
+        dryRun: true,
+        fixes: ["tag-normalize"],
+    });
+    assert.equal(report.changedFiles, 0);
+    assert.equal(report.diff, "");
+    assert.deepEqual(report.files, [
+        {
+            path: "pages/projects/mystery/index.md",
+            changes: [],
+            unknownTags: ["Mystery"],
+        },
+    ]);
+});
+//# sourceMappingURL=fix.test.js.map

package/dist/wiki/frontmatter.js

@@ -1,6 +1,40 @@
 const FRONTMATTER_RE = /^---\s*\n([\s\S]*?)\n---\s*\n?/;
 const SUMMARY_MARKDOWN_RE = /(\*\*|__|[_*`~]|^\s*#+\s|\[[^\]]+\]\([^)]+\)|!\[[^\]]*\]\([^)]+\)|^\s*>)/m;
 const FRONTMATTER_TEMPLATE = `---\ntitle: <title>\nsummary: <plain-text one-line summary, max 200 chars>\nupdated: YYYY-MM-DD\ntags: []\nrelated: []\n---`;
+const PROJECT_RULES_HARD_DEFAULTS = {
+    auto_pr: true,
+    require_worktree: false,
+    pr_draft_default: false,
+    default_branch: "main",
+    commit_co_author: "Copilot <223556219+Copilot@users.noreply.github.com>",
+    test_command: "",
+    build_command: "",
+    lint_command: "",
+    require_clean_worktree: false,
+};
+const KNOWN_WIKI_FRONTMATTER_FIELDS = new Set([
+    "title",
+    "summary",
+    "updated",
+    "tags",
+    "autostub",
+    "confidence",
+    "contested",
+    "contradictions",
+    "related",
+]);
+const PROJECT_RULE_HARD_FIELDS = [
+    "auto_pr",
+    "require_worktree",
+    "pr_draft_default",
+    "default_branch",
+    "commit_co_author",
+    "test_command",
+    "build_command",
+    "lint_command",
+    "require_clean_worktree",
+];
+const KNOWN_PROJECT_RULE_FIELDS = new Set(PROJECT_RULE_HARD_FIELDS);
 export function parseWikiFrontmatter(content) {
     const match = content.match(FRONTMATTER_RE);
     if (!match) {
@@ -41,6 +75,15 @@ export function parseWikiFrontmatter(content) {
                 else
                     parsed.metadata[key] = value;
                 break;
+            case "auto_pr":
+            case "require_worktree":
+            case "pr_draft_default":
+            case "require_clean_worktree":
+                if (typeof value === "boolean")
+                    parsed[key] = value;
+                else
+                    parsed.metadata[key] = value;
+                break;
             case "confidence":
                 if (value === "high" || value === "medium" || value === "low") {
                     parsed.confidence = value;
@@ -49,6 +92,16 @@ export function parseWikiFrontmatter(content) {
                     parsed.metadata[key] = value;
                 }
                 break;
+            case "default_branch":
+            case "commit_co_author":
+            case "test_command":
+            case "build_command":
+            case "lint_command":
+                if (typeof value === "string")
+                    parsed[key] = value;
+                else
+                    parsed.metadata[key] = value;
+                break;
             default:
                 parsed.metadata[key] = value;
                 break;
@@ -59,6 +112,17 @@ export function parseWikiFrontmatter(content) {
         body: content.slice(match[0].length),
     };
 }
+export function parseProjectRulesFrontmatter(content) {
+    const { parsed, body } = parseWikiFrontmatter(content);
+    return {
+        parsed: {
+            ...parsed,
+            hardRules: materializeProjectRulesHardFields(parsed),
+        },
+        body,
+        warnings: collectUnknownProjectRuleWarnings(parsed.metadata),
+    };
+}
 export function hasWikiFrontmatter(content) {
     return FRONTMATTER_RE.test(content);
 }
@@ -125,6 +189,25 @@ export function validateWikiFrontmatter(content, options = {}) {
         errors,
     };
 }
+export function validateProjectRulesFrontmatter(content, options = {}) {
+    const base = validateWikiFrontmatter(content, options);
+    const { parsed, warnings } = parseProjectRulesFrontmatter(content);
+    const errors = [...base.errors];
+    for (const field of PROJECT_RULE_HARD_FIELDS) {
+        if (field in parsed.metadata) {
+            errors.push({
+                rule: "invalid-field-type",
+                field,
+                message: formatFrontmatterMessage(`invalid '${field}' type`),
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
 function formatFrontmatterMessage(reason) {
     return `Wiki page frontmatter violates the required shape: ${reason}. Use:\n${FRONTMATTER_TEMPLATE}`;
 }
@@ -145,4 +228,26 @@ function parseValue(rawValue) {
 function stripQuotes(value) {
     return value.replace(/^['"]|['"]$/g, "");
 }
+function materializeProjectRulesHardFields(parsed) {
+    return {
+        auto_pr: parsed.auto_pr ?? PROJECT_RULES_HARD_DEFAULTS.auto_pr,
+        require_worktree: parsed.require_worktree ?? PROJECT_RULES_HARD_DEFAULTS.require_worktree,
+        pr_draft_default: parsed.pr_draft_default ?? PROJECT_RULES_HARD_DEFAULTS.pr_draft_default,
+        default_branch: parsed.default_branch ?? PROJECT_RULES_HARD_DEFAULTS.default_branch,
+        commit_co_author: parsed.commit_co_author ?? PROJECT_RULES_HARD_DEFAULTS.commit_co_author,
+        test_command: parsed.test_command ?? PROJECT_RULES_HARD_DEFAULTS.test_command,
+        build_command: parsed.build_command ?? PROJECT_RULES_HARD_DEFAULTS.build_command,
+        lint_command: parsed.lint_command ?? PROJECT_RULES_HARD_DEFAULTS.lint_command,
+        require_clean_worktree: parsed.require_clean_worktree ?? PROJECT_RULES_HARD_DEFAULTS.require_clean_worktree,
+    };
+}
+function collectUnknownProjectRuleWarnings(metadata) {
+    return Object.keys(metadata)
+        .filter((field) => !KNOWN_WIKI_FRONTMATTER_FIELDS.has(field) && !KNOWN_PROJECT_RULE_FIELDS.has(field))
+        .map((field) => ({
+        rule: "unknown-project-rule-key",
+        field,
+        message: `Project rules frontmatter includes unknown key '${field}'.`,
+    }));
+}
 //# sourceMappingURL=frontmatter.js.map

package/dist/wiki/frontmatter.test.js

@@ -106,4 +106,124 @@ tags: [engineering, made-up-tag]
     assert.deepEqual(result.errors.map((error) => error.rule), ["unknown-tag"]);
     assert.match(result.errors[0]?.message ?? "", /Add it to `pages\/_meta\/taxonomy\.md` first\./);
 });
+test("parseProjectRulesFrontmatter parses typed hard-rule fields and flags unknown keys", async () => {
+    const { parseProjectRulesFrontmatter } = await loadFrontmatterModule();
+    const result = parseProjectRulesFrontmatter(`---
+title: Project rules for chapterhouse
+summary: Project-specific operating rules for Chapterhouse itself.
+updated: 2026-05-12
+tags: [engineering, workflow]
+related: []
+auto_pr: false
+require_worktree: true
+pr_draft_default: true
+default_branch: trunk
+commit_co_author: Jane Doe <jane@example.com>
+test_command: npm test
+build_command: npm run build
+lint_command: npm run lint
+require_clean_worktree: true
+custom_rule: preserve-me
+---
+
+## Soft Rules
+`);
+    assert.deepEqual(result, {
+        parsed: {
+            title: "Project rules for chapterhouse",
+            summary: "Project-specific operating rules for Chapterhouse itself.",
+            updated: "2026-05-12",
+            tags: ["engineering", "workflow"],
+            related: [],
+            auto_pr: false,
+            require_worktree: true,
+            pr_draft_default: true,
+            default_branch: "trunk",
+            commit_co_author: "Jane Doe <jane@example.com>",
+            test_command: "npm test",
+            build_command: "npm run build",
+            lint_command: "npm run lint",
+            require_clean_worktree: true,
+            metadata: {
+                custom_rule: "preserve-me",
+            },
+            hardRules: {
+                auto_pr: false,
+                require_worktree: true,
+                pr_draft_default: true,
+                default_branch: "trunk",
+                commit_co_author: "Jane Doe <jane@example.com>",
+                test_command: "npm test",
+                build_command: "npm run build",
+                lint_command: "npm run lint",
+                require_clean_worktree: true,
+            },
+        },
+        body: "## Soft Rules\n",
+        warnings: [
+            {
+                rule: "unknown-project-rule-key",
+                field: "custom_rule",
+                message: "Project rules frontmatter includes unknown key 'custom_rule'.",
+            },
+        ],
+    });
+});
+test("parseProjectRulesFrontmatter materializes defaults for omitted hard-rule fields", async () => {
+    const { parseProjectRulesFrontmatter } = await loadFrontmatterModule();
+    const result = parseProjectRulesFrontmatter(`---
+title: Project rules for chapterhouse
+summary: Project-specific operating rules for Chapterhouse itself.
+---
+
+## Soft Rules
+`);
+    assert.deepEqual(result.parsed.hardRules, {
+        auto_pr: true,
+        require_worktree: false,
+        pr_draft_default: false,
+        default_branch: "main",
+        commit_co_author: "Copilot <223556219+Copilot@users.noreply.github.com>",
+        test_command: "",
+        build_command: "",
+        lint_command: "",
+        require_clean_worktree: false,
+    });
+    assert.deepEqual(result.warnings, []);
+});
+test("validateProjectRulesFrontmatter rejects invalid hard-rule field types and warns on unknown keys", async () => {
+    const { validateProjectRulesFrontmatter } = await loadFrontmatterModule();
+    const result = validateProjectRulesFrontmatter(`---
+title: Project rules for chapterhouse
+summary: Project-specific operating rules for Chapterhouse itself.
+auto_pr: nope
+default_branch: [main]
+test_command: [npm test]
+require_clean_worktree: "yes"
+custom_rule: preserve-me
+---
+
+## Soft Rules
+`);
+    assert.equal(result.valid, false);
+    assert.deepEqual(result.errors.map((error) => error.rule), [
+        "invalid-field-type",
+        "invalid-field-type",
+        "invalid-field-type",
+        "invalid-field-type",
+    ]);
+    assert.deepEqual(result.errors.map((error) => error.field), [
+        "auto_pr",
+        "default_branch",
+        "test_command",
+        "require_clean_worktree",
+    ]);
+    assert.deepEqual(result.warnings, [
+        {
+            rule: "unknown-project-rule-key",
+            field: "custom_rule",
+            message: "Project rules frontmatter includes unknown key 'custom_rule'.",
+        },
+    ]);
+});
 //# sourceMappingURL=frontmatter.test.js.map

package/package.json

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