@zigrivers/scaffold 3.27.0 → 3.29.0

package/dist/knowledge-freshness/bump-version.js

@@ -0,0 +1,69 @@
+// Knowledge-base VERSION bump logic.
+//
+// Pure functions only — no I/O, no git, no GH. The workflow in
+// .github/workflows/knowledge-freshness-version-bump.yml reads
+// content/knowledge/VERSION, calls `deriveBumpKind` from the PR title/body,
+// calls `bumpSemver` to compute the next version, and writes it back.
+//
+// We intentionally do not depend on a SemVer library — the bump rules here
+// are a tiny subset (major/minor/patch on `X.Y.Z` with no prerelease tags).
+/**
+ * Derive the bump kind from a Conventional Commits-flavored PR title and body.
+ *
+ * Rules (first match wins):
+ *   1. `BREAKING CHANGE:` token anywhere in title or body → major
+ *   2. `feat(knowledge):` or `feat(knowledge-freshness):` title prefix → minor
+ *   3. `chore(knowledge):` or `chore(knowledge-freshness):` title prefix → patch
+ *   4. Anything else → patch (the workflow logs a `::notice::` for this case)
+ *
+ * Title matching is case-sensitive against the literal prefix (Conventional
+ * Commits canonicalizes to lowercase). The BREAKING CHANGE token is matched
+ * case-sensitively as well — that's the canonical form.
+ */
+export function deriveBumpKind(prTitle, prBody) {
+    // BREAKING CHANGE wins over everything else, even if title is `feat(...)`.
+    //
+    // Round-2 F-002: the body match MUST be anchored to start-of-line. A
+    // freshness PR's body contains an LLM-generated findings table where an
+    // evidence URL or excerpt that happens to mention "BREAKING CHANGE:"
+    // would otherwise trigger an accidental major bump. The canonical
+    // Conventional Commits "BREAKING CHANGE:" footer lives on its own line.
+    const breakingInBody = /^BREAKING CHANGE:/m.test(prBody);
+    if (prTitle.includes('BREAKING CHANGE:') || breakingInBody) {
+        return 'major';
+    }
+    if (prTitle.startsWith('feat(knowledge):') || prTitle.startsWith('feat(knowledge-freshness):')) {
+        return 'minor';
+    }
+    if (prTitle.startsWith('chore(knowledge):') || prTitle.startsWith('chore(knowledge-freshness):')) {
+        return 'patch';
+    }
+    return 'patch';
+}
+/**
+ * Bump a `X.Y.Z` SemVer string by the given kind. Throws on invalid input.
+ *
+ *  - `major`: `X.Y.Z` → `(X+1).0.0`
+ *  - `minor`: `X.Y.Z` → `X.(Y+1).0`
+ *  - `patch`: `X.Y.Z` → `X.Y.(Z+1)`
+ */
+export function bumpSemver(current, kind) {
+    // Trim because VERSION files routinely have a trailing newline.
+    const trimmed = current.trim();
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(trimmed);
+    if (!match) {
+        throw new Error(`bumpSemver: invalid SemVer "${current}" (expected X.Y.Z)`);
+    }
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    const patch = Number(match[3]);
+    switch (kind) {
+        case 'major':
+            return `${major + 1}.0.0`;
+        case 'minor':
+            return `${major}.${minor + 1}.0`;
+        case 'patch':
+            return `${major}.${minor}.${patch + 1}`;
+    }
+}
+//# sourceMappingURL=bump-version.js.map

package/dist/knowledge-freshness/bump-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump-version.js","sourceRoot":"","sources":["../../src/knowledge-freshness/bump-version.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,+DAA+D;AAC/D,+DAA+D;AAC/D,4EAA4E;AAC5E,sEAAsE;AACtE,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAI5E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAc;IAC5D,2EAA2E;IAC3E,EAAE;IACF,qEAAqE;IACrE,wEAAwE;IACxE,qEAAqE;IACrE,kEAAkE;IAClE,wEAAwE;IACxE,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACxD,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,cAAc,EAAE,CAAC;QAC3D,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAC/F,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACjG,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAc;IACxD,gEAAgE;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,oBAAoB,CAAC,CAAA;IAC7E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,QAAQ,IAAI,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAA;QAC3B,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAA;QAClC,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAA;IACzC,CAAC;AACH,CAAC"}

package/dist/knowledge-freshness/bump-version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bump-version.test.d.ts.map

package/dist/knowledge-freshness/bump-version.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump-version.test.d.ts","sourceRoot":"","sources":["../../src/knowledge-freshness/bump-version.test.ts"],"names":[],"mappings":""}

package/dist/knowledge-freshness/bump-version.test.js

@@ -0,0 +1,82 @@
+import { describe, it, expect } from 'vitest';
+import { deriveBumpKind, bumpSemver } from './bump-version.js';
+describe('deriveBumpKind', () => {
+    it('returns major when BREAKING CHANGE appears in title', () => {
+        expect(deriveBumpKind('feat(knowledge): rework API BREAKING CHANGE: drops X', '')).toBe('major');
+    });
+    it('returns major when BREAKING CHANGE appears at the start of a body line', () => {
+        expect(deriveBumpKind('feat(knowledge): new entry', 'Body line\nBREAKING CHANGE: removes Y')).toBe('major');
+    });
+    it('does NOT return major when BREAKING CHANGE appears mid-line (round-2 F-002)', () => {
+        // A freshness PR body's findings table can quote evidence containing the
+        // string "BREAKING CHANGE:" inside a cell. That must NOT trigger major.
+        const body = '| P1 | citation: "see the BREAKING CHANGE: removed-deprecated section above" |';
+        expect(deriveBumpKind('chore(knowledge): refresh X', body)).toBe('patch');
+    });
+    it('does NOT return major when BREAKING CHANGE is preceded by whitespace or > (quoted)', () => {
+        expect(deriveBumpKind('chore(knowledge): X', '> BREAKING CHANGE: from external doc')).toBe('patch');
+        expect(deriveBumpKind('chore(knowledge): X', '  BREAKING CHANGE: indented')).toBe('patch');
+    });
+    it('returns minor for feat(knowledge): prefix', () => {
+        expect(deriveBumpKind('feat(knowledge): add new entry for Z', '')).toBe('minor');
+    });
+    it('returns minor for feat(knowledge-freshness): prefix', () => {
+        expect(deriveBumpKind('feat(knowledge-freshness): new workflow', '')).toBe('minor');
+    });
+    it('returns patch for chore(knowledge): prefix', () => {
+        expect(deriveBumpKind('chore(knowledge): refresh React entry against v19', '')).toBe('patch');
+    });
+    it('returns patch for chore(knowledge-freshness): prefix', () => {
+        expect(deriveBumpKind('chore(knowledge-freshness): tweak cadence', '')).toBe('patch');
+    });
+    it('defaults to patch for unrecognized prefixes', () => {
+        expect(deriveBumpKind('docs: tweak README', '')).toBe('patch');
+        expect(deriveBumpKind('fix: nit', '')).toBe('patch');
+        expect(deriveBumpKind('', '')).toBe('patch');
+    });
+});
+describe('bumpSemver', () => {
+    it('bumps patch', () => {
+        expect(bumpSemver('0.1.0', 'patch')).toBe('0.1.1');
+        expect(bumpSemver('1.2.3', 'patch')).toBe('1.2.4');
+    });
+    it('bumps minor and resets patch', () => {
+        expect(bumpSemver('0.1.5', 'minor')).toBe('0.2.0');
+        expect(bumpSemver('1.2.3', 'minor')).toBe('1.3.0');
+    });
+    it('bumps major and resets minor and patch', () => {
+        expect(bumpSemver('0.1.5', 'major')).toBe('1.0.0');
+        expect(bumpSemver('2.4.7', 'major')).toBe('3.0.0');
+    });
+    it('tolerates trailing newline / whitespace from a VERSION file', () => {
+        expect(bumpSemver('0.1.0\n', 'patch')).toBe('0.1.1');
+        expect(bumpSemver('  1.0.0  ', 'minor')).toBe('1.1.0');
+    });
+    it('throws on invalid SemVer input', () => {
+        expect(() => bumpSemver('1.0', 'patch')).toThrow(/invalid SemVer/);
+        expect(() => bumpSemver('1.0.0-beta', 'patch')).toThrow(/invalid SemVer/);
+        expect(() => bumpSemver('vNotASemver', 'patch')).toThrow(/invalid SemVer/);
+        expect(() => bumpSemver('', 'patch')).toThrow(/invalid SemVer/);
+    });
+});
+describe('end-to-end fixture: simulated merged PR title → version diff', () => {
+    it('chore(knowledge) PR bumps patch', () => {
+        const title = 'chore(knowledge): refresh React entry against v19';
+        const body = '';
+        const kind = deriveBumpKind(title, body);
+        expect(bumpSemver('0.1.0', kind)).toBe('0.1.1');
+    });
+    it('feat(knowledge-freshness) PR bumps minor', () => {
+        const title = 'feat(knowledge-freshness): add Postgres entry';
+        const body = 'New entry';
+        const kind = deriveBumpKind(title, body);
+        expect(bumpSemver('0.1.0', kind)).toBe('0.2.0');
+    });
+    it('BREAKING CHANGE PR bumps major', () => {
+        const title = 'feat(knowledge): drop deprecated entries';
+        const body = 'Cleanup.\n\nBREAKING CHANGE: removes 5 entries';
+        const kind = deriveBumpKind(title, body);
+        expect(bumpSemver('0.1.0', kind)).toBe('1.0.0');
+    });
+});
+//# sourceMappingURL=bump-version.test.js.map

package/dist/knowledge-freshness/bump-version.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump-version.test.js","sourceRoot":"","sources":["../../src/knowledge-freshness/bump-version.test.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-freshness/gates/anti-over-rewrite.d.ts

@@ -0,0 +1,86 @@
+export interface ChurnInput {
+    file: string;
+    /** Raw post-change file contents (used to read volatility + total lines). */
+    content: string;
+    /** Added lines from the diff for this file (entire file). */
+    addedCount: number;
+    /** Removed lines from the diff for this file (entire file). */
+    removedCount: number;
+    /** Added lines from the diff that are in the BODY (post-frontmatter) region. */
+    bodyAddedCount?: number;
+    /** Removed lines from the diff that are in the BODY (post-frontmatter) region. */
+    bodyRemovedCount?: number;
+}
+export interface ChurnFinding {
+    file: string;
+    volatility: 'stable' | 'evolving' | 'fast-moving' | null;
+    totalLines: number;
+    addedCount: number;
+    removedCount: number;
+    churnPct: number;
+    /** True if this counts as a blocking failure (stable + over-threshold + no override). */
+    blocking: boolean;
+    /** True if the PR body contained the override marker. */
+    overridden: boolean;
+}
+export interface ChurnOptions {
+    /**
+     * Labels currently applied to the PR. The gate honors the literal label
+     * `override:anti-over-rewrite` (F-005). PR-body markers are explicitly
+     * NOT honored because the bot can write the body but cannot apply labels.
+     */
+    prLabels?: string[];
+}
+export declare function evaluateChurn(inputs: ChurnInput[], opts?: ChurnOptions): ChurnFinding[];
+/**
+ * Parse a unified diff into per-file add/remove counts. Mirrors
+ * `lint-unsourced.parseUnifiedDiff` in scope (knowledge entries only) so the
+ * two gates pull the same set of files from the same diff input.
+ */
+export interface ChurnDiffResult {
+    file: string;
+    addedCount: number;
+    removedCount: number;
+    bodyAddedCount: number;
+    bodyRemovedCount: number;
+}
+/**
+ * Parse a unified diff into per-file add/remove counts. Returns raw counts;
+ * body-only counts are derived later by `splitChurnByRegion` because they
+ * require access to the post-change file content (to know where the
+ * frontmatter ends).
+ *
+ * Round-7 F-001 replaces the round-6 state-machine approach (which
+ * incorrectly flipped on the FIRST `---` line — i.e., the opening
+ * boundary — instead of the second / closing one, miscounting most
+ * frontmatter as body churn). The line-number-based filter in
+ * splitChurnByRegion is more robust because it relies on the actual
+ * file content, not on diff-content patterns.
+ */
+export declare function parseUnifiedDiffForChurn(diff: string): ChurnDiffResult[];
+/**
+ * Per-file content pair used by `splitChurnByRegion` to derive separate
+ * frontmatter boundaries for added (new file) and removed (old file)
+ * sides of the diff. Round-8 F-003 introduced the asymmetry: when
+ * audit-apply ADDS frontmatter fields (hash / retrieved on first audit),
+ * the new frontmatter is taller than the old, so using the new boundary
+ * for `-` lines mis-classifies the first body lines as frontmatter and
+ * under-counts removal churn.
+ */
+export interface ChurnFileContent {
+    /** Post-change file content (the head / working-tree version). */
+    newContent: string;
+    /** Pre-change file content (the base / origin/main version). Optional. */
+    oldContent?: string;
+}
+/**
+ * Given the raw diff and per-file pre/post-change content, return body-only
+ * add/remove counts. An added line is "body" iff its new-file line number
+ * is past the NEW frontmatter end; a removed line is "body" iff its
+ * old-file line number is past the OLD frontmatter end.
+ */
+export declare function splitChurnByRegion(diff: string, fileContents: Map<string, ChurnFileContent | string>): Map<string, {
+    bodyAddedCount: number;
+    bodyRemovedCount: number;
+}>;
+//# sourceMappingURL=anti-over-rewrite.d.ts.map

package/dist/knowledge-freshness/gates/anti-over-rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-over-rewrite.d.ts","sourceRoot":"","sources":["../../../src/knowledge-freshness/gates/anti-over-rewrite.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,IAAI,CAAA;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,yFAAyF;IACzF,QAAQ,EAAE,OAAO,CAAA;IACjB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,YAAY,EAAE,CAqC3F;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAoBxE;AA2CD;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,GACnD,GAAG,CAAC,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAiDnE"}

package/dist/knowledge-freshness/gates/anti-over-rewrite.js

@@ -0,0 +1,210 @@
+/**
+ * Anti-over-rewrite gate (spec §A.5): for `volatility: stable` entries, fail
+ * if the diff's add+remove line count exceeds 20% of the entry's total line
+ * count. For `evolving` and `fast-moving` entries we still compute the churn
+ * percentage and surface it as a notice, but never fail.
+ *
+ * The override is a maintainer-applied PR label `override:anti-over-rewrite`
+ * — NOT a PR-body marker. F-005 (round-1 Phase 2 MMR review): a marker in
+ * the PR body could be prompt-injected via LLM-generated verdict text from
+ * a malicious source. Labels are applied by GitHub users with write access,
+ * so they're trustworthy.
+ */
+import { parseEntry } from './parse-entry.js';
+const STABLE_THRESHOLD = 0.20;
+const OVERRIDE_LABEL = 'override:anti-over-rewrite';
+export function evaluateChurn(inputs, opts = {}) {
+    const overridden = Array.isArray(opts.prLabels) && opts.prLabels.includes(OVERRIDE_LABEL);
+    const out = [];
+    for (const input of inputs) {
+        let volatility = null;
+        let bodyLines = input.content.split('\n').length;
+        try {
+            const parsed = parseEntry(input.content);
+            volatility = parsed.volatility;
+            bodyLines = parsed.body.split('\n').length;
+        }
+        catch { /* missing FM → null volatility; bodyLines stays as full file */ }
+        // Round-6 F-002: the 20% threshold applies to BODY churn only. A
+        // `current` verdict refreshes 3 frontmatter fields (~6 lines of diff)
+        // and touches no body — without excluding frontmatter changes, a
+        // stable entry under ~30 lines would trip the threshold on every
+        // metadata-only refresh PR. The diff parser exposes bodyAdded/Removed
+        // alongside the total counts so we can compute the right denominator
+        // and numerator here.
+        const bodyAdded = input.bodyAddedCount ?? input.addedCount;
+        const bodyRemoved = input.bodyRemovedCount ?? input.removedCount;
+        const totalLines = input.content.split('\n').length;
+        const totalBodyChurn = bodyAdded + bodyRemoved;
+        const churnPct = bodyLines > 0 ? totalBodyChurn / bodyLines : 0;
+        const overThreshold = churnPct > STABLE_THRESHOLD;
+        const blocking = volatility === 'stable' && overThreshold && !overridden;
+        out.push({
+            file: input.file,
+            volatility,
+            totalLines,
+            addedCount: input.addedCount,
+            removedCount: input.removedCount,
+            churnPct,
+            blocking,
+            overridden: overridden && volatility === 'stable' && overThreshold,
+        });
+    }
+    return out;
+}
+/**
+ * Parse a unified diff into per-file add/remove counts. Returns raw counts;
+ * body-only counts are derived later by `splitChurnByRegion` because they
+ * require access to the post-change file content (to know where the
+ * frontmatter ends).
+ *
+ * Round-7 F-001 replaces the round-6 state-machine approach (which
+ * incorrectly flipped on the FIRST `---` line — i.e., the opening
+ * boundary — instead of the second / closing one, miscounting most
+ * frontmatter as body churn). The line-number-based filter in
+ * splitChurnByRegion is more robust because it relies on the actual
+ * file content, not on diff-content patterns.
+ */
+export function parseUnifiedDiffForChurn(diff) {
+    const perFileHunks = parseHunks(diff);
+    const out = [];
+    for (const [file, hunks] of perFileHunks) {
+        let added = 0, removed = 0;
+        for (const h of hunks) {
+            for (const line of h.lines) {
+                if (line.startsWith('+') && !line.startsWith('+++'))
+                    added++;
+                else if (line.startsWith('-') && !line.startsWith('---'))
+                    removed++;
+            }
+        }
+        out.push({
+            file,
+            addedCount: added, removedCount: removed,
+            // bodyAdded/Removed left at zero here; the caller calls
+            // splitChurnByRegion() with the new-file content to fill them in.
+            bodyAddedCount: 0, bodyRemovedCount: 0,
+        });
+    }
+    return out;
+}
+function parseHunks(diff) {
+    const out = new Map();
+    const lines = diff.split('\n');
+    let i = 0;
+    let currentFile = null;
+    let currentHunks = [];
+    while (i < lines.length) {
+        const line = lines[i];
+        if (line.startsWith('diff --git ')) {
+            if (currentFile)
+                out.set(currentFile, currentHunks);
+            const m = line.match(/^diff --git a\/(.+) b\/(.+)$/);
+            const file = m ? m[2] : '';
+            currentFile = (file.startsWith('content/knowledge/') && file.endsWith('.md')) ? file : null;
+            currentHunks = [];
+            i++;
+            continue;
+        }
+        if (currentFile && line.startsWith('@@')) {
+            const hh = line.match(/^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)?/);
+            if (!hh) {
+                i++;
+                continue;
+            }
+            const hunk = {
+                oldStart: parseInt(hh[1], 10),
+                newStart: parseInt(hh[2], 10),
+                lines: [],
+            };
+            i++;
+            while (i < lines.length && !lines[i].startsWith('@@') && !lines[i].startsWith('diff --git ')) {
+                hunk.lines.push(lines[i]);
+                i++;
+            }
+            currentHunks.push(hunk);
+            continue;
+        }
+        i++;
+    }
+    if (currentFile)
+        out.set(currentFile, currentHunks);
+    return out;
+}
+/**
+ * Given the raw diff and per-file pre/post-change content, return body-only
+ * add/remove counts. An added line is "body" iff its new-file line number
+ * is past the NEW frontmatter end; a removed line is "body" iff its
+ * old-file line number is past the OLD frontmatter end.
+ */
+export function splitChurnByRegion(diff, fileContents) {
+    const perFile = parseHunks(diff);
+    const out = new Map();
+    for (const [file, hunks] of perFile) {
+        const entry = fileContents.get(file);
+        let newContent = '';
+        let oldContent;
+        if (typeof entry === 'string') {
+            // Back-compat shape: just the new content. Old boundary unknown;
+            // we'll fall back to the new boundary for `-` lines (round-8 F-003
+            // documented residual: this is the over-count direction, never
+            // under-count — safe).
+            newContent = entry;
+        }
+        else if (entry) {
+            newContent = entry.newContent;
+            oldContent = entry.oldContent;
+        }
+        const newFmEnd = findFrontmatterEndLineNumber(newContent);
+        const oldFmEnd = oldContent !== undefined
+            ? findFrontmatterEndLineNumber(oldContent)
+            : newFmEnd;
+        let bodyAdded = 0, bodyRemoved = 0;
+        for (const hunk of hunks) {
+            // Walk through the hunk, tracking the running line number on each
+            // side. Context lines (' ') advance both sides. '+' advances only
+            // the new side. '-' advances only the old side.
+            let newLineNo = hunk.newStart;
+            let oldLineNo = hunk.oldStart;
+            for (const l of hunk.lines) {
+                if (l.startsWith('+') && !l.startsWith('+++')) {
+                    if (newLineNo > newFmEnd)
+                        bodyAdded++;
+                    newLineNo++;
+                }
+                else if (l.startsWith('-') && !l.startsWith('---')) {
+                    if (oldLineNo > oldFmEnd)
+                        bodyRemoved++;
+                    oldLineNo++;
+                }
+                else if (l.startsWith(' ') || l === '') {
+                    // Round-9 F-001: empty diff lines (where trailing whitespace was
+                    // stripped from a blank context line) must still advance both
+                    // counters. Without this, line numbers drift mid-hunk and the
+                    // body/frontmatter classification breaks.
+                    newLineNo++;
+                    oldLineNo++;
+                }
+                //  → no line numbers consumed.
+            }
+        }
+        out.set(file, { bodyAddedCount: bodyAdded, bodyRemovedCount: bodyRemoved });
+    }
+    return out;
+}
+/**
+ * Return the 1-indexed line number of the closing frontmatter `---`. If
+ * the file has no frontmatter or it's malformed, returns 0 so every
+ * line is treated as body.
+ */
+function findFrontmatterEndLineNumber(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---')
+        return 0;
+    for (let n = 1; n < lines.length; n++) {
+        if (lines[n].trim() === '---')
+            return n + 1; // 1-indexed
+    }
+    return 0;
+}
+//# sourceMappingURL=anti-over-rewrite.js.map

package/dist/knowledge-freshness/gates/anti-over-rewrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-over-rewrite.js","sourceRoot":"","sources":["../../../src/knowledge-freshness/gates/anti-over-rewrite.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-freshness/gates/anti-over-rewrite.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anti-over-rewrite.test.d.ts.map

package/dist/knowledge-freshness/gates/anti-over-rewrite.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-over-rewrite.test.d.ts","sourceRoot":"","sources":["../../../src/knowledge-freshness/gates/anti-over-rewrite.test.ts"],"names":[],"mappings":""}

package/dist/knowledge-freshness/gates/anti-over-rewrite.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect } from 'vitest';
+import { evaluateChurn, parseUnifiedDiffForChurn, splitChurnByRegion } from './anti-over-rewrite.js';
+function makeContent(volatility, bodyLines) {
+    const body = Array.from({ length: bodyLines }, (_, i) => `body line ${i + 1}`).join('\n');
+    return `---\nname: x\nvolatility: ${volatility}\n---\n${body}\n`;
+}
+describe('evaluateChurn', () => {
+    it('blocks a stable entry with >20% churn and no override', () => {
+        const content = makeContent('stable', 100);
+        // 100 body lines + frontmatter ≈ 105 total. 30 churn → 28%.
+        const out = evaluateChurn([
+            { file: 'x.md', content, addedCount: 15, removedCount: 15 },
+        ]);
+        expect(out[0].blocking).toBe(true);
+    });
+    it('does not block when maintainer applied the override label', () => {
+        const content = makeContent('stable', 100);
+        const out = evaluateChurn([{ file: 'x.md', content, addedCount: 15, removedCount: 15 }], { prLabels: ['knowledge-freshness', 'override:anti-over-rewrite'] });
+        expect(out[0].blocking).toBe(false);
+        expect(out[0].overridden).toBe(true);
+    });
+    it('DOES still block when only a PR-body marker is present (no label)', () => {
+        // F-005: the gate explicitly does not honor PR-body markers, which a
+        // prompt-injected source body could plant. Only the maintainer-applied
+        // label is trusted.
+        const content = makeContent('stable', 100);
+        const out = evaluateChurn([{ file: 'x.md', content, addedCount: 15, removedCount: 15 }], { prLabels: [] });
+        expect(out[0].blocking).toBe(true);
+        expect(out[0].overridden).toBe(false);
+    });
+    it('does not block evolving entries even at high churn', () => {
+        const content = makeContent('evolving', 100);
+        const out = evaluateChurn([
+            { file: 'x.md', content, addedCount: 40, removedCount: 40 },
+        ]);
+        expect(out[0].blocking).toBe(false);
+    });
+    it('passes stable entries under threshold', () => {
+        const content = makeContent('stable', 100);
+        const out = evaluateChurn([
+            { file: 'x.md', content, addedCount: 5, removedCount: 5 },
+        ]);
+        expect(out[0].blocking).toBe(false);
+    });
+});
+describe('parseUnifiedDiffForChurn', () => {
+    it('counts adds and removes per knowledge file', () => {
+        const diff = [
+            'diff --git a/content/knowledge/x/y.md b/content/knowledge/x/y.md',
+            '--- a/content/knowledge/x/y.md',
+            '+++ b/content/knowledge/x/y.md',
+            '@@ -1,3 +1,3 @@',
+            '-old',
+            '+new',
+            ' same',
+            '-gone',
+            '+came',
+        ].join('\n');
+        const out = parseUnifiedDiffForChurn(diff);
+        // Hunk starts at line 1 → state begins 'inside' frontmatter; none of the
+        // diff content contains `---` boundaries to flip to 'after', so body
+        // counts stay zero. The total counts reflect the raw diff.
+        expect(out).toEqual([{
+                file: 'content/knowledge/x/y.md',
+                addedCount: 2, removedCount: 2,
+                bodyAddedCount: 0, bodyRemovedCount: 0,
+            }]);
+    });
+    it('counts body adds/removes separately from frontmatter ones (round-6 F-002, round-7 F-001)', () => {
+        // A diff where the closing --- appears, transitioning frontmatter→body.
+        // Frontmatter changes (last-reviewed) should NOT count toward body churn.
+        const diff = [
+            'diff --git a/content/knowledge/core/x.md b/content/knowledge/core/x.md',
+            '--- a/content/knowledge/core/x.md',
+            '+++ b/content/knowledge/core/x.md',
+            '@@ -1,8 +1,8 @@',
+            ' ---',
+            ' name: x',
+            ' description: y',
+            '-last-reviewed: null',
+            '+last-reviewed: 2026-05-25',
+            ' ---',
+            '',
+            '-old body line',
+            '+new body line',
+        ].join('\n');
+        const raw = parseUnifiedDiffForChurn(diff);
+        expect(raw).toEqual([{
+                file: 'content/knowledge/core/x.md',
+                addedCount: 2, removedCount: 2,
+                // parseUnifiedDiffForChurn alone returns 0 here — body counts are
+                // computed by splitChurnByRegion which needs the post-change content.
+                bodyAddedCount: 0, bodyRemovedCount: 0,
+            }]);
+        // The post-change file content has the closing --- on line 5,
+        // body starts on line 6. The diff's body line (`new body line`) lands
+        // at new-file line 7 (after blank line 6).
+        const newContent = [
+            '---',
+            'name: x',
+            'description: y',
+            'last-reviewed: 2026-05-25',
+            '---',
+            '',
+            'new body line',
+        ].join('\n');
+        // F-001 round-7: splitChurnByRegion uses parseEntry-derived line
+        // numbers instead of the buggy diff-content state machine.
+        const splits = splitChurnByRegion(diff, new Map([['content/knowledge/core/x.md', newContent]]));
+        expect(splits.get('content/knowledge/core/x.md')).toEqual({
+            bodyAddedCount: 1, bodyRemovedCount: 1, // only the body line pair
+        });
+    });
+});
+//# sourceMappingURL=anti-over-rewrite.test.js.map

package/dist/knowledge-freshness/gates/anti-over-rewrite.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anti-over-rewrite.test.js","sourceRoot":"","sources":["../../../src/knowledge-freshness/gates/anti-over-rewrite.test.ts"],"names":[],"mappings":"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"}