@trofimyukdev/repo-truth 0.0.0-stage → 0.1.0

package/dist/commit-range.js

@@ -0,0 +1,152 @@
+/**
+ * Commit-range ASCII and identity hygiene.
+ *
+ * `commit-msg` hooks see one commit at a time, at the moment it is written.
+ * `cherry-pick`, `revert`, every form of `rebase`, and `git am` all create
+ * commits without ever invoking that hook - a property of git, not a defect
+ * of the hook. A rule enforced only at commit time is therefore enforced on
+ * a subset of history it cannot even name. This check instead reads the
+ * whole range `base..candidate` after the fact and answers for all of it.
+ */
+import { execFile } from "node:child_process";
+/** The commit fields this check reads and validates, one line at a time. */
+const FIELDS = [
+    { key: "message", label: "commit message" },
+    { key: "authorName", label: "author name" },
+    { key: "authorEmail", label: "author e-mail" },
+    { key: "committerName", label: "committer name" },
+    { key: "committerEmail", label: "committer e-mail" },
+];
+function runGit(cwd, args) {
+    return new Promise((resolve, reject) => {
+        execFile("git", args, { cwd, maxBuffer: 64 * 1024 * 1024, encoding: "utf8" }, (error, stdout, stderr) => {
+            if (error) {
+                reject(new Error(stderr.trim() || error.message));
+                return;
+            }
+            resolve({ stdout });
+        });
+    });
+}
+/**
+ * Escape a character outside printable ASCII (plus tab) so evidence can be
+ * printed to a terminal without replaying whatever control sequence a
+ * malicious or malformed commit smuggled in.
+ */
+function escapeChar(char) {
+    const codePoint = char.codePointAt(0) ?? 0;
+    return `\\u{${codePoint.toString(16).padStart(4, "0")}}`;
+}
+function escapeLine(line) {
+    let escaped = "";
+    for (const char of line) {
+        const codePoint = char.codePointAt(0) ?? 0;
+        if (codePoint === 0x09 || (codePoint >= 0x20 && codePoint <= 0x7e)) {
+            escaped += char;
+        }
+        else {
+            escaped += escapeChar(char);
+        }
+    }
+    return escaped;
+}
+function isAllowedCodePoint(codePoint) {
+    return codePoint === 0x09 || (codePoint >= 0x20 && codePoint <= 0x7e);
+}
+function lineIsAscii(line) {
+    for (const char of line) {
+        if (!isAllowedCodePoint(char.codePointAt(0) ?? 0)) {
+            return false;
+        }
+    }
+    return true;
+}
+function validateField(hash, label, content, evidence) {
+    for (const line of content.split("\n")) {
+        if (!lineIsAscii(line)) {
+            evidence.push(`${hash.slice(0, 12)}: ${label} contains a character outside printable ASCII/tab: "${escapeLine(line)}"`);
+        }
+    }
+}
+async function listCommits(cwd, base, candidate) {
+    const { stdout } = await runGit(cwd, ["rev-list", "--reverse", `${base}..${candidate}`, "--"]);
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+async function readCommitField(cwd, hash, prettyFormat) {
+    const { stdout } = await runGit(cwd, ["show", "-s", `--format=${prettyFormat}`, hash]);
+    // `git show` always appends a trailing newline after a pretty-printed
+    // format; that newline is formatting, not content the commit wrote.
+    return stdout.replace(/\n$/, "");
+}
+async function readCommitFields(cwd, hash) {
+    // Read each field with its own `git show` call, one argument vector per
+    // invocation, rather than joining them with a delimiter: a delimiter drawn
+    // from the same alphabet this check polices could itself appear in a
+    // message or identity, and Node's `execFile` rejects NUL outright as an
+    // argument byte, so there is no safe separator to join on.
+    const [authorName, authorEmail, committerName, committerEmail, message] = await Promise.all([
+        readCommitField(cwd, hash, "%an"),
+        readCommitField(cwd, hash, "%ae"),
+        readCommitField(cwd, hash, "%cn"),
+        readCommitField(cwd, hash, "%ce"),
+        readCommitField(cwd, hash, "%B"),
+    ]);
+    return { hash, authorName, authorEmail, committerName, committerEmail, message };
+}
+/**
+ * Check every commit in `base..candidate` for characters outside printable
+ * ASCII plus tab, in the message and in both identities. Fails closed: any
+ * git invocation that cannot be completed (unknown revision, unreachable
+ * base, non-zero exit) is reported as `fail`, never as `pass`, and never as
+ * a thrown error the caller must catch to stay correct.
+ */
+export async function checkCommitRange(options) {
+    const { cwd, base, candidate } = options;
+    let hashes;
+    try {
+        hashes = await listCommits(cwd, base, candidate);
+    }
+    catch (error) {
+        return {
+            name: "RT-01",
+            status: "fail",
+            evidence: [`could not compute range ${base}..${candidate}: ${error.message}`],
+        };
+    }
+    if (hashes.length === 0) {
+        return {
+            name: "RT-01",
+            status: "pass",
+            evidence: [`range ${base}..${candidate} is empty`],
+        };
+    }
+    const evidence = [];
+    for (const hash of hashes) {
+        let fields;
+        try {
+            fields = await readCommitFields(cwd, hash);
+        }
+        catch (error) {
+            return {
+                name: "RT-01",
+                status: "fail",
+                evidence: [`could not read commit ${hash}: ${error.message}`],
+            };
+        }
+        for (const field of FIELDS) {
+            validateField(fields.hash, field.label, fields[field.key], evidence);
+        }
+    }
+    if (evidence.length > 0) {
+        return { name: "RT-01", status: "fail", evidence };
+    }
+    return {
+        name: "RT-01",
+        status: "pass",
+        evidence: [`${hashes.length} commit(s) in ${base}..${candidate} are printable ASCII/tab, identities included`],
+    };
+}
+//# sourceMappingURL=commit-range.js.map

package/dist/commit-range.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,35 @@
+export declare const CONFIG_FILE = "repo-truth.json";
+export declare const CONFIG_SCHEMA = "repo-truth.config/v1";
+export type OptionKind = "integer" | "boolean" | "string" | "strings";
+export declare const OPTION_KINDS: readonly OptionKind[];
+/** Check name to option name to the kind of that option. */
+export type OptionKinds = {
+    readonly [check: string]: {
+        readonly [option: string]: OptionKind;
+    };
+};
+export type ConfigOptions = {
+    [check: string]: {
+        [option: string]: unknown;
+    };
+};
+export declare class ConfigError extends Error {
+    readonly issues: string[];
+    constructor(issues: readonly string[], source?: string);
+}
+/** Reads `text` as a configuration document; throws a `ConfigError` naming every problem. */
+export declare function parseConfig(text: string, kinds: OptionKinds): ConfigOptions;
+/**
+ * With no `path`, the settings are repo-truth.json at the top directory of the
+ * base commit, whatever directory of the repository `cwd` is in; a
+ * subdirectory's repo-truth.json is never read. A `path` is read as given, a
+ * relative one against `cwd`.
+ */
+export declare function readConfig(options: {
+    cwd: string;
+    base: string;
+    path?: string;
+}, kinds: OptionKinds): Promise<{
+    source: string | null;
+    options: ConfigOptions;
+}>;

package/dist/config.js

@@ -0,0 +1,235 @@
+/**
+ * The configuration file: `repo-truth.json`, read from the base commit through
+ * git (never from the working tree or the candidate) or from a file the caller
+ * names, and checked against the options each check declares. Every refusal is
+ * a `ConfigError` holding one issue per problem.
+ */
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+export const CONFIG_FILE = "repo-truth.json";
+export const CONFIG_SCHEMA = "repo-truth.config/v1";
+export const OPTION_KINDS = ["integer", "boolean", "string", "strings"];
+/** Everything outside printable ASCII becomes `\u{hex}`, the form the checks already use. */
+function escapeText(text) {
+    let escaped = "";
+    for (const char of text) {
+        const codePoint = char.codePointAt(0);
+        escaped += codePoint >= 0x20 && codePoint <= 0x7e ? char : `\\u{${codePoint.toString(16).padStart(4, "0")}}`;
+    }
+    return escaped;
+}
+export class ConfigError extends Error {
+    issues;
+    constructor(issues, source) {
+        const lines = issues.map((issue) => escapeText(issue));
+        const head = `${source === undefined ? "" : `${escapeText(source)}: `}${lines.length} configuration ${lines.length === 1 ? "issue" : "issues"}`;
+        super([head, ...lines.map((line) => `  ${line}`)].join("\n"));
+        this.name = "ConfigError";
+        this.issues = lines;
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function own(object, key) {
+    return Object.prototype.hasOwnProperty.call(object, key);
+}
+function describe(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "an array";
+    return `a ${typeof value}`;
+}
+function kindProblem(kind, value) {
+    switch (kind) {
+        case "integer":
+            return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? null : "a non-negative safe integer";
+        case "boolean":
+            return typeof value === "boolean" ? null : "true or false";
+        case "string":
+            return typeof value === "string" ? null : "a string";
+        case "strings":
+            return Array.isArray(value) && value.every((item) => typeof item === "string") ? null : "an array of strings";
+    }
+}
+/**
+ * `JSON.parse` keeps the last of two equal member names and says nothing, which
+ * is why the repeats are found here, over the tokens of a text already known to
+ * be valid JSON. Each repeat is one issue naming its path.
+ */
+function repeatedNames(text) {
+    const repeats = [];
+    const stack = [];
+    for (const [token] of text.matchAll(/"(?:[^"\\]|\\.)*"|[{}[\],:]|[^\s{}[\],:"]+/g)) {
+        const top = stack[stack.length - 1];
+        if (token === "{" || token === "[") {
+            let path = "";
+            if (top !== undefined)
+                path = top.array ? `${top.path}[${top.index}]` : top.member;
+            stack.push({ array: token === "[", path, names: new Set(), index: 0, wantsName: true, member: "" });
+        }
+        else if (token === "}" || token === "]") {
+            stack.pop();
+        }
+        else if (token === ",") {
+            if (top !== undefined) {
+                top.index += 1;
+                top.wantsName = true;
+            }
+        }
+        else if (token === ":") {
+            if (top !== undefined)
+                top.wantsName = false;
+        }
+        else if (top !== undefined && !top.array && top.wantsName) {
+            const name = JSON.parse(token);
+            top.member = top.path === "" ? name : `${top.path}.${name}`;
+            if (top.names.has(name))
+                repeats.push(`${top.member}: given more than once`);
+            top.names.add(name);
+        }
+    }
+    return repeats;
+}
+/** Reads `text` as a configuration document; throws a `ConfigError` naming every problem. */
+export function parseConfig(text, kinds) {
+    let document;
+    try {
+        document = JSON.parse(text);
+    }
+    catch (error) {
+        throw new ConfigError([`the document: not valid JSON (${error instanceof Error ? error.message : String(error)})`]);
+    }
+    if (!isObject(document))
+        throw new ConfigError([`the document: expected a JSON object, found ${describe(document)}`]);
+    const issues = repeatedNames(text);
+    const options = {};
+    if (!own(document, "schema"))
+        issues.push(`schema: required, must be "${CONFIG_SCHEMA}"`);
+    for (const key of Object.keys(document)) {
+        const value = document[key];
+        if (key === "schema") {
+            if (value !== CONFIG_SCHEMA)
+                issues.push(`schema: expected "${CONFIG_SCHEMA}", found ${JSON.stringify(value)}`);
+        }
+        else if (key === "checks") {
+            if (!isObject(value)) {
+                issues.push(`checks: expected an object, found ${describe(value)}`);
+                continue;
+            }
+            for (const check of Object.keys(value)) {
+                const given = value[check];
+                if (!own(kinds, check)) {
+                    issues.push(`checks.${check}: unknown check`);
+                }
+                else if (!isObject(given)) {
+                    issues.push(`checks.${check}: expected an object, found ${describe(given)}`);
+                }
+                else {
+                    const declared = kinds[check];
+                    const chosen = {};
+                    for (const option of Object.keys(given)) {
+                        const path = `checks.${check}.${option}`;
+                        if (!own(declared, option)) {
+                            issues.push(`${path}: unknown option of ${check}`);
+                            continue;
+                        }
+                        const expected = kindProblem(declared[option], given[option]);
+                        if (expected === null)
+                            chosen[option] = given[option];
+                        else
+                            issues.push(`${path}: expected ${expected}, found ${JSON.stringify(given[option])}`);
+                    }
+                    options[check] = chosen;
+                }
+            }
+        }
+        else {
+            issues.push(`${key}: unknown key, only schema and checks are allowed`);
+        }
+    }
+    if (issues.length > 0)
+        throw new ConfigError(issues);
+    return options;
+}
+function git(cwd, args) {
+    return new Promise((done, fail) => {
+        execFile("git", args, { cwd, maxBuffer: 1024 * 1024 * 1024, encoding: "utf8" }, (error, stdout, stderr) => {
+            if (error === null)
+                return done({ code: 0, stdout, stderr });
+            const code = error.code;
+            if (typeof code === "number")
+                return done({ code, stdout, stderr });
+            fail(new ConfigError([`git could not be run: ${error.message}`]));
+        });
+    });
+}
+function failed(args, result) {
+    return new ConfigError([`git ${args[0]} failed (exit ${result.code}): ${result.stderr.trim() || "no message"}`]);
+}
+function parseFrom(text, kinds, source) {
+    try {
+        return parseConfig(text, kinds);
+    }
+    catch (error) {
+        if (error instanceof ConfigError)
+            throw new ConfigError(error.issues, source);
+        throw error;
+    }
+}
+/**
+ * With no `path`, the settings are repo-truth.json at the top directory of the
+ * base commit, whatever directory of the repository `cwd` is in; a
+ * subdirectory's repo-truth.json is never read. A `path` is read as given, a
+ * relative one against `cwd`.
+ */
+export async function readConfig(options, kinds) {
+    try {
+        const { cwd, base, path } = options;
+        if (path !== undefined) {
+            let text;
+            try {
+                text = await readFile(isAbsolute(path) ? path : resolve(cwd, path), "utf8");
+            }
+            catch (error) {
+                throw new ConfigError([`${path}: cannot read the configuration file (${error instanceof Error ? error.message : String(error)})`]);
+            }
+            return { source: path, options: parseFrom(text, kinds, path) };
+        }
+        const revParse = ["rev-parse", "--verify", "--quiet", "--end-of-options", `${base}^{commit}`];
+        const resolved = await git(cwd, revParse);
+        if (resolved.code === 1 && resolved.stderr.trim() === "")
+            throw new ConfigError([`revision ${base}: names no commit`]);
+        if (resolved.code !== 0)
+            throw failed(revParse, resolved);
+        const commit = resolved.stdout.trim();
+        const lsTree = ["ls-tree", "-z", "--full-tree", commit, "--", CONFIG_FILE];
+        const listing = await git(cwd, lsTree);
+        if (listing.code !== 0)
+            throw failed(lsTree, listing);
+        const entry = listing.stdout.split("\0")[0];
+        if (entry === "")
+            return { source: null, options: {} };
+        const short = commit.slice(0, 12);
+        const match = /^(\d+) (\w+) ([0-9a-f]+)\t/.exec(entry);
+        if (match === null)
+            throw new ConfigError([`${CONFIG_FILE}: unreadable tree entry at ${short}`]);
+        if (match[1] !== "100644" && match[1] !== "100755") {
+            throw new ConfigError([`${CONFIG_FILE}: expected a regular file, found a ${match[2]} (mode ${match[1]}) at ${short}`]);
+        }
+        const catFile = ["cat-file", "blob", match[3]];
+        const blob = await git(cwd, catFile);
+        if (blob.code !== 0)
+            throw failed(catFile, blob);
+        const source = `${CONFIG_FILE} at ${short}`;
+        return { source, options: parseFrom(blob.stdout, kinds, source) };
+    }
+    catch (error) {
+        if (error instanceof ConfigError)
+            throw error;
+        throw new ConfigError([`unexpected failure: ${error instanceof Error ? error.message : String(error)}`]);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/conflict-markers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Conflict markers.
+ *
+ * A merge, a rebase or a cherry-pick that stops on a conflict writes marker
+ * lines into the file, and whoever resolves it by editing around them can
+ * commit them. A compiler catches that in some files and not in others: a
+ * Markdown page, a YAML fixture or a JSON snapshot carries the markers
+ * silently. This check reads the lines `git diff base...candidate` shows as
+ * ADDED and reports every conflict marker among them with its file and line.
+ *
+ * Only added lines count. A marker the base already holds is not the range's
+ * doing, and a line the range removes is never read as one it adds, so the
+ * commit that deletes a leftover marker is not itself reported. The lines come
+ * from git's diff of the two commits, never from the working tree.
+ *
+ * A marker is a line that begins with exactly seven of one marker character
+ * followed by whitespace or the end of the line. `<` opens a conflict, `|`
+ * opens the common ancestor's part and `>` closes it; those three are always
+ * findings. `=` separates the two sides, and a line of seven equals signs is
+ * also what underlines a Markdown heading, so a separator is a finding only
+ * between an opening marker and the next closing marker among the added lines
+ * of the same file.
+ */
+import type { CheckRecord } from "./index.js";
+/** Where to look, and which two revisions bound the range. */
+export interface ConflictMarkersOptions {
+    /** The git repository to run in. */
+    readonly cwd: string;
+    /** The revision the range starts after. */
+    readonly base: string;
+    /** The revision the range ends at. */
+    readonly candidate: string;
+}
+/**
+ * Check the lines `base...candidate` adds for leftover conflict markers.
+ * Fails closed: a revision that names no commit, or any git invocation that
+ * fails, is a `fail` record naming the cause - never a `pass`, and never a
+ * thrown error.
+ */
+export declare function checkConflictMarkers(options: ConflictMarkersOptions): Promise<CheckRecord>;