@ploaness/governance 1.0.0

package/dist/asset-policy.js

@@ -0,0 +1,312 @@
+// Managed-file policy. Some configuration is read
+// from the working tree by tools ploaness does not run (git, editors, coding agents), so it cannot live
+// inside the package and be resolved through node_modules the way an ESLint or Biome config can. Those
+// files are materialised into the consumer tree by `ploaness sync` and policed here.
+//
+// Five dispositions:
+//   PINNED    - ploaness owns the content; the file must exist and match byte for byte.
+//   SEED      - ploaness writes it once when absent; the project owns it thereafter and may edit it.
+//   FORBIDDEN - the path must not exist, because ploaness supplies that configuration itself and a
+//               working-tree copy would silently shadow or contradict it.
+//   SECTION   - ploaness owns a marked block at the top of the file; the project owns everything below
+//               it. Neither PINNED nor SEED fits a file both parties must write: pinning it would forbid
+//               the project its own agent instructions, and seeding it would let the contract statement
+//               drift the moment ploaness changed.
+//   REFERENCE - the path need not exist, but if it does it carries nothing but a pointer at AGENTS.md.
+//               This is for the entry-point file a coding agent other than Claude reads. PINNED cannot
+//               express it: pinning would force a project to carry an entry point for a tool it does
+//               not use, and FORBIDDEN would bar it from using that tool at all. What the rule refuses
+//               is a second set of instructions - the standard says the root instruction file holds the
+//               rules and a tool-specific one only points at it, so two agents cannot be told two
+//               different things. The form of the pointer is the tool's own: `@AGENTS.md` is Claude's
+//               import syntax and means nothing to Cursor, so the check reads for the NAME rather than
+//               demanding one spelling and forcing a file the tool cannot act on.
+const DISPOSITIONS = new Set([
+    'PINNED',
+    'SEED',
+    'FORBIDDEN',
+    'SECTION',
+    'REFERENCE',
+]);
+// A guard rather than a set membership test followed by an assertion. Both say the same thing; only
+// this one is a claim the compiler checks, so a disposition added to the union without being added to
+// the set above stops compiling instead of parsing into a value no rule handles.
+const isDisposition = (raw) => DISPOSITIONS.has(raw);
+const SCOPES = new Set([
+    'REPOSITORY',
+    'APPLICATION',
+    'PAYLOAD',
+    'EVERYWHERE',
+]);
+const isScope = (raw) => SCOPES.has(raw);
+// A manifest row is a path, a disposition and a scope, and nothing else. A row missing the third column
+// is malformed rather than defaulted: a managed file placed in the wrong half of a workspace is either
+// demanded where it cannot be or ignored where it must be, and neither should be reachable by omission.
+const MANIFEST_COLUMNS = 3;
+/** Opens the block ploaness owns inside a SECTION file. */
+export const SECTION_BEGIN = '<!-- BEGIN PLOANESS MANAGED INSTRUCTIONS -->';
+/** Closes the block ploaness owns inside a SECTION file. */
+export const SECTION_END = '<!-- END PLOANESS MANAGED INSTRUCTIONS -->';
+const occurrences = (content, marker) => content.split(marker).length - 1;
+/**
+ * Read back the ploaness-owned block, markers included.
+ *
+ * The markers are HTML comments so they survive in every Markdown renderer without being visible to a
+ * human reader, and so an agent editing the file below them can see exactly where its own territory
+ * starts. The block must lead the file and appear exactly once: a contract an agent reaches only after
+ * scrolling past the project's own prose is not the first thing it reads, and a second copy would let
+ * one block drift while the other stayed current.
+ * @param rawContent the whole file as it currently stands in the working tree.
+ * @returns which of the three states the file is in.
+ */
+export const readManagedSection = (rawContent) => {
+    // Line endings are normalised before the markers are looked for. The begin marker is required to be
+    // followed by `\n`, so on a CRLF checkout every SECTION file reported "the managed block does not
+    // begin the file" and told the reader to repair markers that were already correct.
+    const content = rawContent.replaceAll('\r\n', '\n');
+    const begins = occurrences(content, SECTION_BEGIN);
+    const ends = occurrences(content, SECTION_END);
+    if (begins === 0 && ends === 0) {
+        return { kind: 'absent' };
+    }
+    if (begins !== 1 || ends !== 1) {
+        return {
+            kind: 'malformed',
+            reason: 'the managed markers appear more than once, or one is missing',
+        };
+    }
+    // Requiring the block to lead the file also settles marker order: with one of each marker and the
+    // begin marker at offset zero, the end marker can only follow it.
+    if (!content.startsWith(`${SECTION_BEGIN}\n`)) {
+        return { kind: 'malformed', reason: 'the managed block does not begin the file' };
+    }
+    const end = content.indexOf(SECTION_END);
+    return { kind: 'present', block: content.slice(0, end + SECTION_END.length) };
+};
+/**
+ * Put the ploaness-owned block into a file, preserving everything the project owns.
+ *
+ * An existing block is replaced where it stands, so the project text below it is carried through
+ * byte for byte. A file with no block gets one at the very top, because the contract has to be the
+ * first thing an agent reads.
+ * @param rawContent the current file, or the empty string when it does not exist yet.
+ * @param block the block ploaness ships, markers included.
+ * @returns the spliced file, or undefined when the markers are too ambiguous to edit safely.
+ */
+export const applyManagedSection = (rawContent, block) => {
+    // Normalised here as well, and for a sharper reason than in the reader: the block length below is
+    // measured on the normalised text, so slicing the raw one would cut at the wrong offset by exactly
+    // the number of carriage returns the block contained.
+    const content = rawContent.replaceAll('\r\n', '\n');
+    const state = readManagedSection(content);
+    if (state.kind === 'malformed') {
+        return undefined;
+    }
+    if (state.kind === 'present') {
+        return block + content.slice(state.block.length);
+    }
+    return content.trim().length === 0 ? `${block}\n` : `${block}\n\n${content.replace(/^\n+/, '')}`;
+};
+const readManifestRow = (index, line) => {
+    const trimmed = line.trim();
+    if (trimmed.length === 0 || trimmed.startsWith('#')) {
+        return { asset: undefined, problem: undefined };
+    }
+    const [path, disposition, scope] = trimmed.split('\t', MANIFEST_COLUMNS);
+    if (path === undefined ||
+        disposition === undefined ||
+        scope === undefined ||
+        !isDisposition(disposition) ||
+        !isScope(scope)) {
+        return {
+            asset: undefined,
+            // Rendered from the sets rather than written out. The list was spelled a third time here and had
+            // already drifted: REFERENCE was missing, so a typo in a REFERENCE row produced advice that
+            // contradicted the set the parser actually accepts.
+            problem: `manifest line ${String(index + 1)}: expected "<path>", a tab, one of ` +
+                `${[...DISPOSITIONS].join(', ')}, a tab, then one of ${[...SCOPES].join(', ')}`,
+        };
+    }
+    return { asset: { path, disposition, scope }, problem: undefined };
+};
+/**
+ * Parse a manifest into catalogue entries. Blank lines and `#` comments are ignored; a row is a
+ * repo-relative path, a tab, and a disposition. A malformed row is reported rather than silently
+ * skipped, so a packaging mistake cannot quietly shrink the catalogue.
+ * @param manifest the raw manifest.tsv contents.
+ * @returns the parsed entries and any malformed rows.
+ */
+export const parseManifest = (manifest) => {
+    // Each row is read once into an outcome, then the outcomes are partitioned. A row that is neither an
+    // entry nor a problem is a comment or a blank line, and simply yields nothing.
+    const rows = [...manifest.split('\n').entries()]
+        .map(([index, line]) => readManifestRow(index, line))
+        .filter((row) => row.asset !== undefined || row.problem !== undefined);
+    return {
+        assets: rows.flatMap((row) => row.asset === undefined ? [] : [row.asset]),
+        problems: rows.flatMap((row) => row.problem === undefined ? [] : [row.problem]),
+    };
+};
+/**
+ * Judge a path whose marked block ploaness owns and whose remaining text the project owns.
+ * @param asset the catalogue entry.
+ * @param state the working-tree and shipped content for that path.
+ * @returns a violation, or undefined when the block matches what ploaness ships.
+ */
+const checkSection = (asset, state) => {
+    const section = readManagedSection(state.actual ?? '');
+    // Malformed markers get their own advice on purpose: `ploaness sync` refuses such a file, so telling
+    // the project to run it would send it round a loop that cannot terminate.
+    if (section.kind === 'malformed') {
+        return { path: asset.path, reason: `${section.reason}; repair the markers by hand` };
+    }
+    if (section.kind === 'absent') {
+        return {
+            path: asset.path,
+            reason: 'the ploaness managed block is missing; run `ploaness sync`',
+        };
+    }
+    return section.block === (state.expected ?? '').trim()
+        ? undefined
+        : {
+            path: asset.path,
+            reason: 'the ploaness managed block drifted from the ploaness copy; run `ploaness sync`',
+        };
+};
+// One checker per disposition, rather than a chain of tests inside `checkAsset`. Five dispositions
+// carried that chain past the complexity cap, and the cap is never raised - so the shape changed. Each
+// checker decides the absent case for itself, because that is precisely where the dispositions differ:
+// a missing PINNED file is a defect, a missing REFERENCE file is a project that uses one agent.
+const missing = (asset) => ({
+    path: asset.path,
+    reason: 'managed file is missing; run `ploaness sync`',
+});
+const checkForbidden = (asset, state) => state.isPresent
+    ? {
+        path: asset.path,
+        reason: 'ploaness supplies this configuration, so a working-tree copy shadows it; delete the file',
+    }
+    : undefined;
+const checkSeed = (asset, state) => state.isPresent ? undefined : missing(asset);
+const checkPinned = (asset, state) => {
+    if (!state.isPresent) {
+        return missing(asset);
+    }
+    return state.actual === state.expected
+        ? undefined
+        : {
+            path: asset.path,
+            reason: 'managed file drifted from the ploaness copy; run `ploaness sync`',
+        };
+};
+/** The instruction file every other one points at. */
+const ROOT_INSTRUCTION_FILE = 'AGENTS.md';
+// Every line that says anything must say the same thing: read AGENTS.md. A line that does not name it
+// is this file stating a rule of its own, which is what makes two agents answerable to two contracts.
+const checkReference = (asset, state) => {
+    // Optional, unlike every other disposition: a project that uses no coding agent but Claude carries no
+    // entry point for one, and requiring the file would be ploaness deciding which tools it uses.
+    if (!state.isPresent) {
+        return undefined;
+    }
+    const stated = (state.actual ?? '')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    if (stated.length === 0) {
+        return {
+            path: asset.path,
+            reason: `is empty; a tool-specific instruction file points at ${ROOT_INSTRUCTION_FILE}`,
+        };
+    }
+    return stated.every((line) => line.includes(ROOT_INSTRUCTION_FILE))
+        ? undefined
+        : {
+            path: asset.path,
+            reason: `states instructions of its own; a tool-specific instruction file carries nothing but a ` +
+                `reference to ${ROOT_INSTRUCTION_FILE}, so no two agents are held to two contracts`,
+        };
+};
+const CHECKERS = {
+    FORBIDDEN: checkForbidden,
+    PINNED: checkPinned,
+    REFERENCE: checkReference,
+    SECTION: (asset, state) => state.isPresent ? checkSection(asset, state) : missing(asset),
+    SEED: checkSeed,
+};
+/**
+ * Judge one managed path against its disposition.
+ * @param asset the catalogue entry.
+ * @param state the working-tree facts for that path.
+ * @returns a violation, or undefined when the path conforms.
+ */
+export const checkAsset = (asset, state) => CHECKERS[asset.disposition](asset, state);
+/**
+ * Judge every catalogue entry the project has not explicitly taken over.
+ * @param assets the parsed catalogue.
+ * @param unmanaged repo-relative paths the project owns instead.
+ * @param stateOf resolves the working-tree and shipped content for a path.
+ * @returns one violation per non-conforming path; empty means the tree matches the catalogue.
+ */
+export const findAssetViolations = (assets, unmanaged, stateOf) => {
+    const owned = new Set(unmanaged);
+    return assets.flatMap((asset) => {
+        if (owned.has(asset.path)) {
+            return [];
+        }
+        const violation = checkAsset(asset, stateOf(asset.path));
+        return violation === undefined ? [] : [violation];
+    });
+};
+/**
+ * Decide the sync action for one path. A PINNED file is always rewritten, so drift is repaired; a SEED
+ * file is written only when absent, so the project's own edits survive; a FORBIDDEN file is deleted; a
+ * SECTION file has only its marked block replaced.
+ * @param asset the catalogue entry.
+ * @param isPresent whether the path is currently present in the working tree.
+ * @returns the action `ploaness sync` performs.
+ */
+export const syncAction = (asset, isPresent) => {
+    if (asset.disposition === 'FORBIDDEN') {
+        return isPresent ? 'delete' : 'skip';
+    }
+    // Never written, in either state. Creating one would hand the project an entry point for a tool it
+    // may not use, and rewriting one would replace a pointer the tool understands with a guess.
+    if (asset.disposition === 'REFERENCE') {
+        return 'skip';
+    }
+    if (asset.disposition === 'SEED') {
+        return isPresent ? 'skip' : 'write';
+    }
+    // A SECTION file is never overwritten, even when absent: the project text below the block is the
+    // project's, and creating the file wholesale would be ploaness writing that text on its behalf.
+    if (asset.disposition === 'SECTION') {
+        return 'splice';
+    }
+    return 'write';
+};
+/**
+ * The catalogue entries that apply at the repository root.
+ * @param assets the whole catalogue.
+ * @returns the repository-scope entries and the forbidden paths, which apply everywhere.
+ */
+export const repositoryAssets = (assets) => assets.filter((asset) => asset.scope === 'REPOSITORY' || asset.scope === 'EVERYWHERE');
+/**
+ * The catalogue entries that apply inside one member.
+ *
+ * A library receives only the forbidden paths: it has no server to sweep, so a spec that drives one
+ * would be a managed file demanding a browser the package was never going to open.
+ * @param assets the whole catalogue.
+ * @param host what the member can hold, derived from its kind.
+ * @returns the entries that apply to that member.
+ */
+export const memberAssets = (assets, host) => assets.filter((asset) => {
+    if (asset.scope === 'EVERYWHERE') {
+        return true;
+    }
+    if (host.isPayload && asset.scope === 'PAYLOAD') {
+        return true;
+    }
+    return host.hasRuntime && asset.scope === 'APPLICATION';
+});
+//# sourceMappingURL=asset-policy.js.map

package/dist/asset-policy.js.map

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

package/dist/banned-typography.d.ts

@@ -0,0 +1,13 @@
+export interface TypographyViolation {
+    readonly line: number;
+    readonly column: number;
+    readonly label: string;
+    readonly replacement: string;
+}
+/**
+ * Scans text for banned AI-typography, reporting 1-based line and column positions.
+ * @param text the content to scan, with lines separated by "\n" or "\r\n".
+ * @returns one violation per banned character found, in reading order.
+ */
+export declare const findTypographyViolations: (text: string) => readonly TypographyViolation[];
+//# sourceMappingURL=banned-typography.d.ts.map

package/dist/banned-typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banned-typography.d.ts","sourceRoot":"","sources":["../src/banned-typography.ts"],"names":[],"mappings":"AAmDA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAiCD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,KAAG,SAAS,mBAAmB,EAM/E,CAAA"}

package/dist/banned-typography.js

@@ -0,0 +1,78 @@
+// Shared AI-typography ban: characters a human rarely types but language models love, each mapped to
+// the plain ASCII a human would actually write. One source of truth, consumed by both the file gate
+// (`conventions`, in packages/cli/src/checks/conventions.ts) and the history gate (`commit-history`, in
+// packages/cli/src/checks/history.ts). Every banned character is
+// referenced via its code point only, so neither this module nor its callers trip the check on
+// themselves.
+const STRAIGHT_DOUBLE_QUOTE = 'a straight double quote';
+const PLAIN_HYPHEN = 'a hyphen "-"';
+// The code points are named rather than written at each use, because a bare number in the table below
+// would be exactly the unexplained literal the standard bans - and this module cannot spell the
+// characters out, since its own source is scanned by the rule it implements.
+const EM_DASH = 0x20_14;
+const EN_DASH = 0x20_13;
+const ELLIPSIS = 0x20_26;
+const LEFT_DOUBLE_QUOTE = 0x20_1c;
+const RIGHT_DOUBLE_QUOTE = 0x20_1d;
+const LOW_DOUBLE_QUOTE = 0x20_1e;
+const BANNED_CHARACTERS = [
+    { char: String.fromCodePoint(EM_DASH), label: 'em dash (U+2014)', replacement: PLAIN_HYPHEN },
+    { char: String.fromCodePoint(EN_DASH), label: 'en dash (U+2013)', replacement: PLAIN_HYPHEN },
+    {
+        char: String.fromCodePoint(ELLIPSIS),
+        label: 'ellipsis (U+2026)',
+        replacement: 'three dots "..."',
+    },
+    {
+        char: String.fromCodePoint(LEFT_DOUBLE_QUOTE),
+        label: 'left double quote (U+201C)',
+        replacement: STRAIGHT_DOUBLE_QUOTE,
+    },
+    {
+        char: String.fromCodePoint(RIGHT_DOUBLE_QUOTE),
+        label: 'right double quote (U+201D)',
+        replacement: STRAIGHT_DOUBLE_QUOTE,
+    },
+    {
+        char: String.fromCodePoint(LOW_DOUBLE_QUOTE),
+        label: 'low double quote (U+201E)',
+        replacement: STRAIGHT_DOUBLE_QUOTE,
+    },
+];
+const BY_CHARACTER = new Map(BANNED_CHARACTERS.map((banned) => [
+    banned.char,
+    banned,
+]));
+// Every occurrence, at its own column, in the order it is read.
+//
+// This used to run `indexOf` once per banned character, which reported only the FIRST of each on a
+// line - so a line with two em dashes produced one finding, and clearing a file took as many runs as
+// it had repeats. Walking the line by code point fixes the count and the column together: `indexOf`
+// returns a UTF-16 offset, so a column after an emoji named a position the editor does not have.
+const violationsInLine = (line, lineNumber) => 
+// Code points are the unit wanted here: a banned character is one code point, and a column counted
+// in code units names a position no editor agrees with.
+// eslint-disable-next-line @typescript-eslint/no-misused-spread -- see the note above
+[...line].flatMap((character, index) => {
+    const banned = BY_CHARACTER.get(character);
+    return banned === undefined
+        ? []
+        : [
+            {
+                line: lineNumber,
+                column: index + 1,
+                label: banned.label,
+                replacement: banned.replacement,
+            },
+        ];
+});
+/**
+ * Scans text for banned AI-typography, reporting 1-based line and column positions.
+ * @param text the content to scan, with lines separated by "\n" or "\r\n".
+ * @returns one violation per banned character found, in reading order.
+ */
+export const findTypographyViolations = (text) => text
+    .replaceAll('\r\n', '\n')
+    .split('\n')
+    .flatMap((line, index) => violationsInLine(line, index + 1));
+//# sourceMappingURL=banned-typography.js.map

package/dist/banned-typography.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banned-typography.js","sourceRoot":"","sources":["../src/banned-typography.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,oGAAoG;AACpG,wGAAwG;AACxG,iEAAiE;AACjE,+FAA+F;AAC/F,cAAc;AAQd,MAAM,qBAAqB,GAAW,yBAAyB,CAAA;AAC/D,MAAM,YAAY,GAAW,cAAc,CAAA;AAE3C,sGAAsG;AACtG,gGAAgG;AAChG,6EAA6E;AAC7E,MAAM,OAAO,GAAW,OAAO,CAAA;AAC/B,MAAM,OAAO,GAAW,OAAO,CAAA;AAC/B,MAAM,QAAQ,GAAW,OAAO,CAAA;AAChC,MAAM,iBAAiB,GAAW,OAAO,CAAA;AACzC,MAAM,kBAAkB,GAAW,OAAO,CAAA;AAC1C,MAAM,gBAAgB,GAAW,OAAO,CAAA;AAExC,MAAM,iBAAiB,GAA+B;IACpD,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE;IAC7F,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE;IAC7F;QACE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;QACpC,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC;QAC7C,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC;QAC9C,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC;QAC5C,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,qBAAqB;KACnC;CACF,CAAA;AASD,MAAM,YAAY,GAAyC,IAAI,GAAG,CAChE,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAuB,EAAsC,EAAE,CAAC;IACrF,MAAM,CAAC,IAAI;IACX,MAAM;CACP,CAAC,CACH,CAAA;AAED,gEAAgE;AAChE,EAAE;AACF,mGAAmG;AACnG,qGAAqG;AACrG,oGAAoG;AACpG,iGAAiG;AACjG,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,UAAkB,EAAkC,EAAE;AAC5F,mGAAmG;AACnG,wDAAwD;AACxD,sFAAsF;AACtF,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,SAAiB,EAAE,KAAa,EAAkC,EAAE;IACrF,MAAM,MAAM,GAAgC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACvE,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,KAAK,GAAG,CAAC;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC;SACF,CAAA;AACP,CAAC,CAAC,CAAA;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAY,EAAkC,EAAE,CACvF,IAAI;KACD,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;KACxB,KAAK,CAAC,IAAI,CAAC;KACX,OAAO,CAAC,CAAC,IAAY,EAAE,KAAa,EAAkC,EAAE,CACvE,gBAAgB,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAClC,CAAA"}

package/dist/bundle-budget.d.ts

@@ -0,0 +1,16 @@
+/** One built client asset and its gzipped size. */
+export interface BundleFile {
+    readonly path: string;
+    readonly gzipBytes: number;
+}
+/** The outcome of comparing the measured client JS against the budget. */
+export interface BundleReport {
+    readonly totalGzipBytes: number;
+    readonly budgetBytes: number;
+    readonly isWithinBudget: boolean;
+    readonly fileCount: number;
+}
+export declare const BUNDLE_BUDGET_BYTES: number;
+/** Sum the gzipped sizes of the built assets and compare the total against the budget. */
+export declare const evaluateBundle: (files: readonly BundleFile[], budgetBytes: number) => BundleReport;
+//# sourceMappingURL=bundle-budget.d.ts.map

package/dist/bundle-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-budget.d.ts","sourceRoot":"","sources":["../src/bundle-budget.ts"],"names":[],"mappings":"AAUA,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAkBD,eAAO,MAAM,mBAAmB,EAAE,MAAmC,CAAA;AAErE,0FAA0F;AAC1F,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,UAAU,EAAE,EAAE,aAAa,MAAM,KAAG,YAWlF,CAAA"}

package/dist/bundle-budget.js

@@ -0,0 +1,37 @@
+// Bundle-size budget policy: the pure logic - the byte ceiling and the sum-vs-budget evaluation - lives
+// here so it is unit-tested; the `bundle` gate in packages/cli/src/checks/integrity.ts walks
+// `.next/static`, gzips each chunk, and reports.
+//
+// Why this is a DETERMINISTIC gate (unlike Lighthouse, which this repo deliberately omits): gzipped
+// byte counts of built JS are a fixed function of the source + pinned dependency and Node versions, so
+// the number changes only when your change changes the bundle - a true signal, never environment flake.
+// It measures the TOTAL client JS (the whole `.next/static` tree), so it catches a catastrophic
+// regression (an accidental heavyweight dependency) rather than a per-route First-Load delta.
+// Total gzipped client-JS ceiling. This is a CONSCIOUS ceiling: raise it deliberately, in a reviewed
+// commit, when a real application needs the room - the way the licence allowlist is widened on purpose,
+// never to silence a regression. A project cannot raise it, only lower it, because `readSettings` takes
+// `Math.min` over the declared value.
+//
+// It was 900 KiB, calibrated against one production build at ~768 KiB with headroom for the Payload
+// admin bundle to grow. A second real Payload application measured 954.6 KiB - and roughly 680 KiB of
+// that was `@payloadcms/ui`, Lexical and the datepicker Payload pulls in, before the project wrote a
+// line of its own. The ceiling was therefore below what the framework this harness exists to govern
+// ships on its own, which made it unreachable rather than demanding: no amount of work on the project's
+// code would have brought it under.
+//
+// The gate is not exercised by `it/`, which builds no application, so a number here is only ever as
+// good as the applications it has been checked against. It has now been checked against two.
+const BYTES_PER_KIB = 1024;
+const BUDGET_KIB = 1100;
+export const BUNDLE_BUDGET_BYTES = BUDGET_KIB * BYTES_PER_KIB;
+/** Sum the gzipped sizes of the built assets and compare the total against the budget. */
+export const evaluateBundle = (files, budgetBytes) => {
+    const totalGzipBytes = files.reduce((sum, file) => sum + file.gzipBytes, 0);
+    return {
+        totalGzipBytes,
+        budgetBytes,
+        isWithinBudget: totalGzipBytes <= budgetBytes,
+        fileCount: files.length,
+    };
+};
+//# sourceMappingURL=bundle-budget.js.map

package/dist/bundle-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-budget.js","sourceRoot":"","sources":["../src/bundle-budget.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,6FAA6F;AAC7F,iDAAiD;AACjD,EAAE;AACF,oGAAoG;AACpG,uGAAuG;AACvG,wGAAwG;AACxG,gGAAgG;AAChG,8FAA8F;AAgB9F,qGAAqG;AACrG,wGAAwG;AACxG,wGAAwG;AACxG,sCAAsC;AACtC,EAAE;AACF,oGAAoG;AACpG,sGAAsG;AACtG,qGAAqG;AACrG,oGAAoG;AACpG,wGAAwG;AACxG,oCAAoC;AACpC,EAAE;AACF,oGAAoG;AACpG,6FAA6F;AAC7F,MAAM,aAAa,GAAW,IAAI,CAAA;AAClC,MAAM,UAAU,GAAW,IAAI,CAAA;AAC/B,MAAM,CAAC,MAAM,mBAAmB,GAAW,UAAU,GAAG,aAAa,CAAA;AAErE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA4B,EAAE,WAAmB,EAAgB,EAAE;IAChG,MAAM,cAAc,GAAW,KAAK,CAAC,MAAM,CACzC,CAAC,GAAW,EAAE,IAAgB,EAAU,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,EAC/D,CAAC,CACF,CAAA;IACD,OAAO;QACL,cAAc;QACd,WAAW;QACX,cAAc,EAAE,cAAc,IAAI,WAAW;QAC7C,SAAS,EAAE,KAAK,CAAC,MAAM;KACxB,CAAA;AACH,CAAC,CAAA"}

package/dist/commit-message.d.ts

@@ -0,0 +1,37 @@
+export interface ParsedMessage {
+    readonly header: string;
+    readonly body: string;
+}
+export interface DiffStat {
+    readonly files: number;
+    readonly lines: number;
+}
+/**
+ * Splits a raw commit message into header and body, dropping git comment lines and any verbose-diff
+ * section below the scissors marker.
+ * @param raw the full commit-message file contents.
+ * @returns the first non-blank line as `header` and the remaining prose as `body` (both may be empty).
+ */
+export declare const parseMessage: (raw: string) => ParsedMessage;
+/**
+ * Validates a parsed commit message, returning a human-readable problem per rule violation. Every
+ * commit is held to every rule: there is no exemption list, so a git-generated merge, revert, or
+ * autosquash subject must be rewritten by hand to conform.
+ * @param message the header/body pair from {@link parseMessage}.
+ * @param isBodyRequired whether the change is non-trivial and therefore must carry an explanatory body.
+ * @returns an empty array when the message passes.
+ */
+export declare const validateMessage: (message: ParsedMessage, isBodyRequired: boolean) => readonly string[];
+/**
+ * Parses `git --numstat` output into a file count and a total changed-line count.
+ * @param numstat the raw stdout of a `--numstat` diff (tab-separated added/deleted/path rows).
+ * @returns the number of changed files and the sum of added plus deleted lines (binary rows count 0).
+ */
+export declare const parseNumstat: (numstat: string) => DiffStat;
+/**
+ * Decides whether a diff is large enough to require an explanatory commit body.
+ * @param stat the file and line counts from {@link parseNumstat}.
+ * @returns true when the change touches more than 2 files or more than 50 lines.
+ */
+export declare const isNonTrivial: (stat: DiffStat) => boolean;
+//# sourceMappingURL=commit-message.d.ts.map

package/dist/commit-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-message.d.ts","sourceRoot":"","sources":["../src/commit-message.ts"],"names":[],"mappings":"AA4CA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,aAmB1C,CAAA;AAgED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,aAAa,EACtB,gBAAgB,OAAO,KACtB,SAAS,MAAM,EAMjB,CAAA;AAOD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,QAS9C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,QAAQ,KAAG,OACoB,CAAA"}