chapterhouse 0.3.18 → 0.3.20

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.20",
   "description": "Chapterhouse — a team-level AI assistant for engineering teams, built on the GitHub Copilot SDK. Web UI only.",
   "bin": {
     "chapterhouse": "dist/cli.js"