chapterhouse 0.7.0 → 0.8.0

package/dist/wiki/lint.test.js

@@ -1,329 +0,0 @@
-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-lint-${process.pid}`);
-const wikiDir = join(sandboxRoot, ".chapterhouse", "wiki");
-process.env.CHAPTERHOUSE_HOME = sandboxRoot;
-async function loadModules() {
-    const nonce = `${Date.now()}-${Math.random()}`;
-    const lint = await import(new URL(`./lint.js?case=${nonce}`, import.meta.url).href);
-    const wikiFs = await import(new URL(`./fs.js?case=${nonce}`, import.meta.url).href);
-    return { lint, 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 });
-});
-function wikiPage(frontmatter, body) {
-    return `---\n${frontmatter.join("\n")}\n---\n\n${body.trim()}\n`;
-}
-function wikiIndexWithSharedEntries(...entries) {
-    return `# Wiki Index
-
-## Index
-
-- [Wiki](pages/index.md) — Index of all wiki pages.
-
-## Shared
-
-${entries.join("\n")}
-`;
-}
-function setPageAge(relativePath, ageInDays) {
-    const stamped = new Date(Date.now() - ageInDays * 24 * 60 * 60 * 1000);
-    const fullPath = join(wikiDir, relativePath);
-    utimesSync(fullPath, stamped, stamped);
-}
-test("lintWiki reports orphan pages and index entries pointing to missing pages", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/shared/orphan.md", wikiPage([
-        "title: Orphan",
-        "summary: Not indexed yet",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Orphan\n\nThis orphan page has enough descriptive body text to avoid the premature-page lint while still remaining absent from the index."));
-    wikiFs.writeIndexFile(wikiIndexWithSharedEntries("- [Missing](pages/shared/missing.md) — Not on disk"));
-    const report = lint.lintWiki();
-    assert.equal(report.pageCount, 2);
-    assert.equal(report.sourceCount, 0);
-    assert.deepEqual(report.issues.map((issue) => `${issue.rule}:${issue.severity}:${issue.path ?? "-"}`).sort(), [
-        "missing-page:warning:pages/shared/missing.md",
-        "orphan-page:warning:pages/shared/orphan.md",
-    ]);
-});
-test("renderWikiLintReport preserves the current wiki_lint report format", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/shared/orphan.md", wikiPage([
-        "title: Orphan",
-        "summary: Not indexed yet",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Orphan\n\nThis orphan page has enough descriptive body text to avoid the premature-page lint while still remaining absent from the index."));
-    wikiFs.writeIndexFile(wikiIndexWithSharedEntries("- [Tracked](pages/shared/tracked.md) — Present only in the index"));
-    const rendered = lint.renderWikiLintReport(lint.lintWiki());
-    assert.match(rendered, /^Wiki health report \(2 pages, 0 sources\):/);
-    assert.match(rendered, /warning\s+\|\s+orphan-page\s+\|\s+pages\/shared\/orphan\.md/);
-    assert.match(rendered, /warning\s+\|\s+missing-page\s+\|\s+pages\/shared\/tracked\.md/);
-    assert.match(rendered, /\*\*Suggestions\*\*: Look for pages that should link to each other/);
-});
-test("renderWikiLintReport reports the healthy wiki message when no issues are found", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/shared/indexed.md", wikiPage([
-        "title: Indexed",
-        "summary: Tracked page",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Indexed\n\n## Overview\n\nTracked page with enough detail to stay above the premature-page threshold and remain clearly established as a real page in the healthy-wiki case."));
-    wikiFs.writeIndexFile(wikiIndexWithSharedEntries("- [Indexed](pages/shared/indexed.md) — Tracked page"));
-    const rendered = lint.renderWikiLintReport(lint.lintWiki());
-    assert.match(rendered, /✅ No issues found\. Index and pages are in sync\./);
-});
-test("lintWiki reports the remaining Phase 1 structural and content rules", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.writePage("pages/_meta/taxonomy.md", `## Engineering
-- engineering
-- release
-
-## Unused
-- ghost-tag
-`);
-    wikiFs.writePage("pages/projects/chapterhouse/feature-ideas.md", wikiPage([
-        "title: Chapterhouse ideas",
-        "summary: Candidate follow-up work",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Chapterhouse ideas\n\n## Ideas\n\n- Add a conventions skill."));
-    setPageAge("pages/projects/chapterhouse/feature-ideas.md", 91);
-    wikiFs.writePage("pages/shared/missing-updated.md", wikiPage([
-        "title: Missing updated",
-        "summary: This page omits the updated field",
-        "tags: [engineering]",
-    ], "# Missing updated\n\nThis page forgot its date stamp."));
-    wikiFs.writePage("pages/shared/invalid-frontmatter.md", wikiPage([
-        "title: Invalid frontmatter",
-        "summary: **Not plain text**",
-        "tags: [engineering, unknown-tag]",
-    ], "# Invalid frontmatter\n\nBody content."));
-    wikiFs.writePage("pages/shared/skipped-heading.md", wikiPage([
-        "title: Skipped heading",
-        "summary: Heading depth should not skip levels",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Skipped heading\n\n### Too deep"));
-    wikiFs.writePage("pages/shared/decisions.md", wikiPage([
-        "title: Misfiled decisions",
-        "summary: Decisions must live under an entity directory",
-        "updated: 2026-05-12",
-        "tags: [decision]",
-    ], "# Misfiled decisions\n\n## Record\n\nA misplaced decision log."));
-    wikiFs.writePage("pages/shared/large-warning.md", wikiPage([
-        "title: Large warning",
-        "summary: Page size warning threshold coverage",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], `# Large warning\n\n${Array.from({ length: 301 }, (_, index) => `Line ${index + 1}`).join("\n")}`));
-    wikiFs.writePage("pages/shared/large-error.md", wikiPage([
-        "title: Large error",
-        "summary: Page size error threshold coverage",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], `# Large error\n\n${Array.from({ length: 801 }, (_, index) => `Line ${index + 1}`).join("\n")}`));
-    wikiFs.writePage("pages/shared/tiny.md", wikiPage([
-        "title: Tiny page",
-        "summary: Tiny pages should be linted as premature",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Tiny page\n\nTiny."));
-    wikiFs.writePage("pages/shared/stub.md", wikiPage([
-        "title: Stub page",
-        "summary: Stub pages should be flipped once they grow up",
-        "autostub: true",
-        "tags: [autostub]",
-    ], `# Stub page\n\n${Array.from({ length: 12 }, (_, index) => `- fleshed out line ${index + 1}`).join("\n")}`));
-    const report = lint.lintWiki();
-    const signatures = report.issues.map((issue) => `${issue.rule}:${issue.severity}:${issue.path ?? "-"}`);
-    assert.ok(signatures.includes("index-integrity:error:pages/projects/chapterhouse"));
-    assert.ok(signatures.includes("stale-page:warning:pages/projects/chapterhouse/feature-ideas.md"));
-    assert.ok(signatures.includes("missing-updated:warning:pages/shared/missing-updated.md"));
-    assert.ok(signatures.includes("frontmatter-shape:error:pages/shared/invalid-frontmatter.md"));
-    assert.ok(signatures.includes("heading-depth:warning:pages/shared/skipped-heading.md"));
-    assert.ok(signatures.includes("decision-misfile:error:pages/shared/decisions.md"));
-    assert.ok(signatures.includes("page-size:warning:pages/shared/large-warning.md"));
-    assert.ok(signatures.includes("page-size:error:pages/shared/large-error.md"));
-    assert.ok(signatures.includes("premature-page:info:pages/shared/tiny.md"));
-    assert.ok(signatures.includes("autostub-not-flipped:info:pages/shared/stub.md"));
-    assert.ok(signatures.includes("dead-taxonomy-entry:info:pages/_meta/taxonomy.md"));
-});
-test("lintWiki exempts decision and conversation pages from staleness and exempts autostubs from selected rules", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.writePage("pages/projects/chapterhouse/index.md", wikiPage([
-        "title: Chapterhouse",
-        "summary: Overview page required for entity facets",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Chapterhouse\n\n## Overview\n\nProject overview."));
-    wikiFs.writePage("pages/projects/chapterhouse/decisions.md", wikiPage([
-        "title: Chapterhouse decisions",
-        "summary: Decision logs should never go stale",
-        "updated: 2026-05-12",
-        "tags: [decision]",
-    ], "# Chapterhouse decisions\n\n## Decisions\n\nRecorded decisions."));
-    setPageAge("pages/projects/chapterhouse/decisions.md", 365);
-    wikiFs.writePage("pages/conversations/2026-01-01.md", wikiPage([
-        "title: Conversations on 2026-01-01",
-        "summary: Daily conversation summary",
-        "updated: 2026-01-01",
-        "tags: [engineering]",
-    ], "# Conversations on 2026-01-01\n\nSummary body."));
-    setPageAge("pages/conversations/2026-01-01.md", 365);
-    wikiFs.writePage("pages/shared/autostub.md", wikiPage([
-        "title: Stub",
-        "summary: Placeholder page",
-        "autostub: true",
-        "tags: [autostub]",
-    ], `# Stub\n\n### Placeholder\n\n${Array.from({ length: 900 }, (_, index) => `Line ${index + 1}`).join("\n")}`));
-    const report = lint.lintWiki();
-    const signatures = report.issues.map((issue) => `${issue.rule}:${issue.path ?? "-"}`);
-    assert.equal(signatures.includes("stale-page:pages/projects/chapterhouse/decisions.md"), false);
-    assert.equal(signatures.includes("stale-page:pages/conversations/2026-01-01.md"), false);
-    assert.equal(signatures.includes("missing-updated:pages/shared/autostub.md"), false);
-    assert.equal(signatures.includes("premature-page:pages/shared/autostub.md"), false);
-    assert.equal(signatures.includes("heading-depth:pages/shared/autostub.md"), false);
-    assert.equal(signatures.includes("page-size:pages/shared/autostub.md"), false);
-});
-test("lintWiki accepts valid project rules frontmatter on rules.md pages", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/projects/chapterhouse/index.md", wikiPage([
-        "title: Chapterhouse",
-        "summary: Project overview",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Chapterhouse\n\n## Overview\n\nProject overview body with enough content to stay out of the premature-page bucket."));
-    wikiFs.writePage("pages/projects/chapterhouse/rules.md", wikiPage([
-        "title: Project rules for chapterhouse",
-        "summary: Project-specific operating rules for Chapterhouse and delegated agents.",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-        "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: "npm test"',
-        'build_command: "npm run build"',
-        'lint_command: "npm run lint"',
-        "require_clean_worktree: true",
-    ], "# Project rules\n\n## Soft Rules\n\n- Keep rules concise and operational.\n- Record workflow changes here when they become durable."));
-    const report = lint.lintWiki();
-    assert.equal(report.issues.some((issue) => issue.path === "pages/projects/chapterhouse/rules.md" && issue.rule === "frontmatter-shape"), false);
-    assert.equal(report.issues.some((issue) => issue.path === "pages/projects/chapterhouse/rules.md" && issue.rule === "unknown-project-rule-key"), false);
-});
-test("lintWiki reports invalid known project rule field types on rules.md pages", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/projects/chapterhouse/index.md", wikiPage([
-        "title: Chapterhouse",
-        "summary: Project overview",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Chapterhouse\n\n## Overview\n\nProject overview body with enough content to stay out of the premature-page bucket."));
-    wikiFs.writePage("pages/projects/chapterhouse/rules.md", wikiPage([
-        "title: Project rules for chapterhouse",
-        "summary: Project-specific operating rules for Chapterhouse and delegated agents.",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-        "auto_pr: [true]",
-    ], "# Project rules\n\n## Soft Rules\n\n- Keep rules concise and operational."));
-    const report = lint.lintWiki();
-    const issue = report.issues.find((candidate) => candidate.path === "pages/projects/chapterhouse/rules.md" && candidate.rule === "frontmatter-shape");
-    assert.ok(issue);
-    assert.equal(issue.severity, "error");
-    assert.match(issue.message, /invalid 'auto_pr' type/);
-});
-test("lintWiki warns on unknown project rule keys on rules.md pages", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/projects/chapterhouse/index.md", wikiPage([
-        "title: Chapterhouse",
-        "summary: Project overview",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Chapterhouse\n\n## Overview\n\nProject overview body with enough content to stay out of the premature-page bucket."));
-    wikiFs.writePage("pages/projects/chapterhouse/rules.md", wikiPage([
-        "title: Project rules for chapterhouse",
-        "summary: Project-specific operating rules for Chapterhouse and delegated agents.",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-        "mystery_setting: true",
-    ], "# Project rules\n\n## Soft Rules\n\n- Keep rules concise and operational."));
-    const report = lint.lintWiki();
-    assert.ok(report.issues.some((issue) => issue.rule === "unknown-project-rule-key" &&
-        issue.severity === "warning" &&
-        issue.path === "pages/projects/chapterhouse/rules.md" &&
-        issue.message.includes("mystery_setting")));
-});
-test("renderWikiLintReport surfaces contested and low-confidence pages ahead of the general issue list", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.writePage("pages/shared/contested.md", wikiPage([
-        "title: Contested page",
-        "summary: This page is explicitly contested",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-        "contested: true",
-    ], "# Contested page\n\nThis page needs review."));
-    wikiFs.writePage("pages/shared/low-confidence.md", wikiPage([
-        "title: Low confidence page",
-        "summary: This page has low confidence",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-        "confidence: low",
-    ], "# Low confidence page\n\nThis page needs review."));
-    wikiFs.writePage("pages/shared/missing-updated.md", wikiPage([
-        "title: Missing updated",
-        "summary: A regular issue should come after contested pages",
-        "tags: [engineering]",
-    ], "# Missing updated\n\nBody."));
-    const rendered = lint.renderWikiLintReport(lint.lintWiki());
-    const contestedIndex = rendered.indexOf("pages/shared/contested.md");
-    const lowConfidenceIndex = rendered.indexOf("pages/shared/low-confidence.md");
-    const generalIssueIndex = rendered.indexOf("missing-updated");
-    assert.ok(contestedIndex >= 0);
-    assert.ok(lowConfidenceIndex >= 0);
-    assert.ok(generalIssueIndex >= 0);
-    assert.ok(contestedIndex < generalIssueIndex);
-    assert.ok(lowConfidenceIndex < generalIssueIndex);
-});
-test("lintWiki reports a missing or unwritable action log", async () => {
-    const { lint, wikiFs } = await loadModules();
-    wikiFs.ensureWikiStructure();
-    wikiFs.writePage("pages/shared/healthy.md", wikiPage([
-        "title: Healthy page",
-        "summary: Enough content to avoid incidental lint issues",
-        "updated: 2026-05-12",
-        "tags: [engineering]",
-    ], "# Healthy page\n\n## Overview\n\nThis page exists so the action-log rule is isolated from unrelated findings in the test."));
-    rmSync(join(wikiDir, "pages", "_meta", "log.md"), { force: true });
-    let report = lint.lintWiki();
-    assert.ok(report.issues.some((issue) => issue.rule === "action-log" &&
-        issue.severity === "error" &&
-        issue.path === "pages/_meta/log.md"));
-    rmSync(join(wikiDir, "pages", "_meta"), { recursive: true, force: true });
-    mkdirSync(join(wikiDir, "pages", "_meta", "log.md"), { recursive: true });
-    report = lint.lintWiki();
-    assert.ok(report.issues.some((issue) => issue.rule === "action-log" &&
-        issue.severity === "error" &&
-        issue.path === "pages/_meta/log.md"));
-});
-//# sourceMappingURL=lint.test.js.map