chapterhouse 0.3.20 → 0.3.21

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

@@ -0,0 +1,217 @@
+import assert from "node:assert/strict";
+import { mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import test from "node:test";
+const repoRoot = process.cwd();
+const sandboxRoot = join(repoRoot, ".test-work", `wiki-project-rules-${process.pid}`);
+process.env.CHAPTERHOUSE_HOME = sandboxRoot;
+async function loadModules() {
+    const nonce = `${Date.now()}-${Math.random()}`;
+    const wikiFs = await import(new URL(`./fs.js?case=${nonce}`, import.meta.url).href);
+    let projectRules;
+    let loadError;
+    try {
+        projectRules = await import(new URL(`./project-rules.js?case=${nonce}`, import.meta.url).href);
+    }
+    catch (error) {
+        loadError = error;
+    }
+    assert.equal(loadError, undefined, `Expected project-rules module to load without errors: ${String(loadError)}`);
+    return { projectRules: projectRules, wikiFs };
+}
+function resetSandbox() {
+    mkdirSync(join(repoRoot, ".test-work"), { recursive: true });
+    rmSync(sandboxRoot, { recursive: true, force: true });
+}
+test.beforeEach(() => {
+    resetSandbox();
+});
+test.after(() => {
+    rmSync(sandboxRoot, { recursive: true, force: true });
+});
+test("loadProjectRules returns an explicit empty result when rules.md is absent", async () => {
+    const { projectRules } = await loadModules();
+    assert.deepEqual(projectRules.loadProjectRules("chapterhouse"), {
+        found: false,
+        path: "pages/projects/chapterhouse/rules.md",
+    });
+});
+test("renderInitialProjectRulesPage returns the default scaffold for a new project", async () => {
+    const { projectRules } = await loadModules();
+    assert.equal(projectRules.getProjectRulesPath("chapterhouse"), "pages/projects/chapterhouse/rules.md");
+    assert.equal(projectRules.renderInitialProjectRulesPage("chapterhouse", new Date("2026-05-13T12:34:56.000Z")), "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse and delegated agents.\n"
+        + "updated: 2026-05-13\n"
+        + "tags: [engineering, workflow]\n"
+        + "related: []\n"
+        + "---\n\n"
+        + "## Soft Rules");
+});
+test("loadProjectRules returns typed hard rules, raw soft rules, and warnings for a valid rules page", async () => {
+    const { projectRules, wikiFs } = await loadModules();
+    wikiFs.writePage("pages/projects/chapterhouse/rules.md", "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "auto_pr: false\n"
+        + "test_command: npm test\n"
+        + "custom_rule: preserve-me\n"
+        + "---\n\n"
+        + "## Soft Rules\n\n"
+        + "- Keep tests green.\n");
+    assert.deepEqual(projectRules.loadProjectRules("chapterhouse"), {
+        found: true,
+        path: "pages/projects/chapterhouse/rules.md",
+        hard: {
+            auto_pr: false,
+            require_worktree: false,
+            pr_draft_default: false,
+            default_branch: "main",
+            commit_co_author: "Copilot <223556219+Copilot@users.noreply.github.com>",
+            test_command: "npm test",
+            build_command: "",
+            lint_command: "",
+            require_clean_worktree: false,
+        },
+        soft: "## Soft Rules\n\n- Keep tests green.\n",
+        warnings: [
+            {
+                rule: "unknown-project-rule-key",
+                field: "custom_rule",
+                message: "Project rules frontmatter includes unknown key 'custom_rule'.",
+            },
+        ],
+        metadata: {
+            custom_rule: "preserve-me",
+        },
+    });
+});
+test("loadProjectRules throws when rules.md contains malformed known hard-rule fields", async () => {
+    const { projectRules, wikiFs } = await loadModules();
+    wikiFs.writePage("pages/projects/chapterhouse/rules.md", "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "auto_pr: nope\n"
+        + "test_command: [npm test]\n"
+        + "---\n\n"
+        + "## Soft Rules\n");
+    assert.throws(() => projectRules.loadProjectRules("chapterhouse"), /invalid 'auto_pr' type|invalid 'test_command' type/);
+});
+test("saveProjectRulesHardFields rewrites only hard-rule frontmatter fields", async () => {
+    const { projectRules, wikiFs } = await loadModules();
+    wikiFs.writePage("pages/projects/chapterhouse/rules.md", "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "updated: 2026-05-13\n"
+        + "tags: [engineering, workflow]\n"
+        + "related: []\n"
+        + "auto_pr: false\n"
+        + "test_command: npm test\n"
+        + "custom_rule: preserve-me\n"
+        + "---\n\n"
+        + "## Soft Rules\n\n"
+        + "- Keep tests green.\n");
+    projectRules.saveProjectRulesHardFields("chapterhouse", {
+        auto_pr: true,
+        require_worktree: true,
+        pr_draft_default: true,
+        default_branch: "release",
+        commit_co_author: "Jane Doe <jane@example.com>",
+        test_command: "pnpm test",
+        build_command: "pnpm build",
+        lint_command: "pnpm lint",
+        require_clean_worktree: true,
+    });
+    assert.equal(wikiFs.readPage("pages/projects/chapterhouse/rules.md"), "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "updated: 2026-05-13\n"
+        + "tags: [engineering, workflow]\n"
+        + "related: []\n"
+        + "auto_pr: true\n"
+        + "require_worktree: true\n"
+        + "pr_draft_default: true\n"
+        + "default_branch: release\n"
+        + "commit_co_author: Jane Doe <jane@example.com>\n"
+        + "test_command: pnpm test\n"
+        + "build_command: pnpm build\n"
+        + "lint_command: pnpm lint\n"
+        + "require_clean_worktree: true\n"
+        + "custom_rule: preserve-me\n"
+        + "---\n\n"
+        + "## Soft Rules\n\n"
+        + "- Keep tests green.\n");
+});
+test("saveProjectRulesSoftRules rewrites the body as a stable soft-rule list while preserving frontmatter", async () => {
+    const { projectRules, wikiFs } = await loadModules();
+    wikiFs.writePage("pages/projects/chapterhouse/rules.md", "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "updated: 2026-05-13\n"
+        + "tags: [engineering, workflow]\n"
+        + "related: []\n"
+        + "auto_pr: false\n"
+        + "test_command: npm test\n"
+        + "custom_rule: preserve-me\n"
+        + "---\n\n"
+        + "## Soft Rules\n\n"
+        + "Intro text that should be replaced.\n\n"
+        + "- Keep tests green.\n"
+        + "* Prefer worktrees for PR work.\n");
+    projectRules.saveProjectRulesSoftRules("chapterhouse", [
+        "Ship the smallest safe slice.",
+        "Document deferred work in the PR body.",
+    ]);
+    assert.equal(wikiFs.readPage("pages/projects/chapterhouse/rules.md"), "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "updated: 2026-05-13\n"
+        + "tags: [engineering, workflow]\n"
+        + "related: []\n"
+        + "auto_pr: false\n"
+        + "require_worktree: false\n"
+        + "pr_draft_default: false\n"
+        + "default_branch: main\n"
+        + "commit_co_author: Copilot <223556219+Copilot@users.noreply.github.com>\n"
+        + "test_command: npm test\n"
+        + "build_command: \n"
+        + "lint_command: \n"
+        + "require_clean_worktree: false\n"
+        + "custom_rule: preserve-me\n"
+        + "---\n\n"
+        + "## Soft Rules\n\n"
+        + "- Ship the smallest safe slice.\n"
+        + "- Document deferred work in the PR body.\n");
+});
+test("loadProjectRuleSummary returns null counts when rules.md is absent", async () => {
+    const { projectRules } = await loadModules();
+    assert.deepEqual(projectRules.loadProjectRuleSummary("chapterhouse"), {
+        slug: "chapterhouse",
+        path: "pages/projects/chapterhouse/rules.md",
+        hardRuleCount: null,
+        softRuleCount: null,
+    });
+});
+test("loadProjectRuleSummary counts explicit hard-rule keys and top-level soft-rule bullets", async () => {
+    const { projectRules, wikiFs } = await loadModules();
+    wikiFs.writePage("pages/projects/chapterhouse/rules.md", "---\n"
+        + "title: Project rules for chapterhouse\n"
+        + "summary: Project-specific operating rules for Chapterhouse itself.\n"
+        + "auto_pr: false\n"
+        + "test_command: npm test\n"
+        + "custom_rule: preserve-me\n"
+        + "---\n\n"
+        + "## Soft Rules\n\n"
+        + "Intro paragraph.\n\n"
+        + "- Keep tests green.\n"
+        + "  - Nested bullets do not count yet.\n"
+        + "* Prefer worktrees for PR work.\n"
+        + "+ Keep docs in sync.\n");
+    assert.deepEqual(projectRules.loadProjectRuleSummary("chapterhouse"), {
+        slug: "chapterhouse",
+        path: "pages/projects/chapterhouse/rules.md",
+        hardRuleCount: 2,
+        softRuleCount: 3,
+    });
+});
+//# sourceMappingURL=project-rules.test.js.map

package/package.json

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