@clossys/launcher 0.3.0 → 0.4.0

package/dist/release-age-edit.js

@@ -0,0 +1,413 @@
+// Editing a repository's release-age exemption file to add the publishing
+// scope (issue #1178, code rule C12). The surface is pnpm's
+// `minimumReleaseAgeExclude` in pnpm-workspace.yaml or Yarn's
+// `npmPreapprovedPackages` in .yarnrc.yml. This edits a client's file, so every
+// ambiguity refuses: the editor adds exactly one quoted entry under the
+// surface's key, keeps every other byte, and refuses any shape its restricted
+// reader does not fully recognise. The reader is not a YAML parser; it is
+// modelled on the launcher's lockfile reader (same idea, no shared code). It
+// performs no I/O.
+import { EXEMPTION_SURFACES } from "./change-set-contract.js";
+import { PACKAGE_SCOPE } from "./generated/package-scope.generated.js";
+const UNPARSEABLE = { kind: "refused", reason: "release-age-surface-unparseable" };
+const CONFLICT = { kind: "refused", reason: "release-age-surface-conflict" };
+const NOT_VERIFIED = { verified: false };
+const scopeValue = () => `${PACKAGE_SCOPE.scope}/*`;
+/** pnpm writes single quotes, Yarn double. A plain `@...` scalar is invalid YAML, so an inserted entry is always quoted. */
+const quotedEntry = (surface) => (surface === "pnpm-workspace" ? `'${scopeValue()}'` : `"${scopeValue()}"`);
+/** The key block appended (or created) when the key is absent, with its final newline. */
+const keyBlock = (key, entry) => `${key}:\n  - ${entry}\n`;
+// ---------------------------------------------------------------------------
+// The .npmrc (pnpm only): a fixed safe grammar, never a list of bad spellings.
+// ---------------------------------------------------------------------------
+/** The exclusion setting's key with `-` and `_` removed and lower-cased: the kebab and the camel-case spellings both reduce to it. */
+const NPMRC_CONFLICT_KEY = "minimumreleaseageexclude";
+/**
+ * Keys, reduced the same way, that point the package manager at another user
+ * config file, global config file or prefix directory. Such a line sends the
+ * reader to a file this editor is never given, which may hold the exclusion
+ * list itself, so the whole `.npmrc` is refused rather than read as clear.
+ */
+const NPMRC_REDIRECT_KEYS = new Set(["userconfig", "globalconfig", "prefix"]);
+/** A character of an accepted .npmrc key: an ASCII letter or digit, or one of `@ : _ . / -`. */
+function isNpmrcKeyCharacter(code) {
+    return ((code >= 48 && code <= 57) || // 0-9
+        (code >= 65 && code <= 90) || // A-Z
+        (code >= 97 && code <= 122) || // a-z
+        code === 64 || // @
+        code === 58 || // :
+        code === 95 || // _
+        code === 46 || // .
+        code === 47 || // /
+        code === 45 // -
+    );
+}
+/**
+ * Reads a pnpm surface's .npmrc under a fixed grammar. Every line must be
+ * blank (spaces only), a comment (first non-space character `#` or `;`), or a
+ * plain assignment: optional spaces, a key of ASCII letters, digits and
+ * `@ : _ . / -`, optional spaces, `=`, then any value. Any other line shape
+ * (a quoted or bracketed key, a comment before the `=`, a backslash, a tab, a
+ * section header, a key with no `=`) makes the whole file `unparseable`,
+ * because npm's ini reader could read such a line as the exclusion key. A plain
+ * key that reduces (in the same way) to `userconfig`, `globalconfig` or `prefix`
+ * is `unparseable` too: it redirects the read to a file this reader cannot
+ * see. A plain key that reduces to the exclusion setting is a `conflict`.
+ * Index scans only.
+ */
+function readNpmrc(surface, npmrc) {
+    if (surface !== "pnpm-workspace" || npmrc === null || npmrc === undefined)
+        return "clear";
+    const text = npmrc.startsWith("\uFEFF") ? npmrc.slice(1) : npmrc;
+    let conflict = false;
+    for (const line of text.split(/\r\n|\r|\n/)) {
+        let start = 0;
+        while (start < line.length && line[start] === " ")
+            start += 1;
+        if (start === line.length || line[start] === "#" || line[start] === ";")
+            continue;
+        let keyEnd = start;
+        while (keyEnd < line.length && isNpmrcKeyCharacter(line.charCodeAt(keyEnd)))
+            keyEnd += 1;
+        if (keyEnd === start)
+            return "unparseable";
+        let equals = keyEnd;
+        while (equals < line.length && line[equals] === " ")
+            equals += 1;
+        if (line[equals] !== "=")
+            return "unparseable";
+        const reduced = line.slice(start, keyEnd).replace(/[-_]/g, "").toLowerCase();
+        if (NPMRC_REDIRECT_KEYS.has(reduced))
+            return "unparseable";
+        if (reduced === NPMRC_CONFLICT_KEY)
+            conflict = true;
+    }
+    return conflict ? "conflict" : "clear";
+}
+// ---------------------------------------------------------------------------
+// The restricted reader: refuses everything it does not fully recognise.
+// ---------------------------------------------------------------------------
+class Refusal extends Error {
+}
+function refuse() {
+    throw new Refusal();
+}
+/** A tab, CR, byte order mark anywhere, a Unicode line break other than LF, or another control character. */
+const FORBIDDEN_CHARACTERS = /[\t\r\uFEFF\u0085\u2028\u2029\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u;
+const KEY_NAME = "[A-Za-z_][A-Za-z0-9_.-]*";
+/** A top-level key line: bare, or wrapped in matching quotes (no backslash), then `:` and the end of the line or a space. */
+const KEY_LINE = new RegExp(`^(?:(${KEY_NAME})|'(${KEY_NAME})'|"(${KEY_NAME})"):( .*)?$`);
+const isBlankLine = (line) => /^ *$/.test(line);
+const isCommentLine = (line) => /^ *#/.test(line);
+/** Where the spaces around `value[from, to)` end: the bounds of the same text without its leading and trailing spaces. One pass, no backtracking. */
+function trimmedBounds(value, from, to) {
+    let start = from;
+    while (start < to && value[start] === " ")
+        start += 1;
+    let end = to;
+    while (end > start && value[end - 1] === " ")
+        end -= 1;
+    return [start, end];
+}
+/** The text without its leading and trailing spaces (only U+0020). */
+function trimSpaces(value) {
+    const [start, end] = trimmedBounds(value, 0, value.length);
+    return value.slice(start, end);
+}
+/** End index (exclusive) of the single-quoted scalar starting at `start`; `''` is an escaped quote. */
+function endOfSingleQuoted(line, start) {
+    let i = start + 1;
+    while (i < line.length) {
+        if (line[i] === "'") {
+            if (line[i + 1] === "'") {
+                i += 2;
+                continue;
+            }
+            return i + 1;
+        }
+        i += 1;
+    }
+    return refuse();
+}
+/** End index (exclusive) of the double-quoted scalar starting at `start`; a backslash anywhere in it refuses, as no escape is interpreted. */
+function endOfDoubleQuoted(line, start) {
+    for (let i = start + 1; i < line.length; i += 1) {
+        if (line[i] === "\\")
+            return refuse();
+        if (line[i] === '"')
+            return i + 1;
+    }
+    return refuse();
+}
+/** The index of the colon ending a (possibly quoted) mapping key in a trimmed line, or undefined. */
+function findKeyColon(content) {
+    const first = content[0];
+    if (first === "'" || first === '"') {
+        const end = first === "'" ? endOfSingleQuoted(content, 0) : endOfDoubleQuoted(content, 0);
+        return content[end] === ":" ? end : undefined;
+    }
+    for (let i = 0; i < content.length; i += 1) {
+        if (content[i] === ":" && (i + 1 === content.length || content[i + 1] === " "))
+            return i;
+    }
+    return undefined;
+}
+/**
+ * Refuses an anchor, alias, tag, block scalar, explicit key, or unterminated
+ * quote on one line, wherever in the file the line sits. Text inside quotes
+ * and after a comment start is not scanned for them.
+ */
+function scanForForbiddenConstructs(line) {
+    let afterSpace = true;
+    let tokenStart = true;
+    let i = 0;
+    while (i < line.length) {
+        const c = line[i];
+        if (c === " ") {
+            afterSpace = true;
+            tokenStart = true;
+            i += 1;
+            continue;
+        }
+        if (c === "#" && afterSpace)
+            return;
+        if (tokenStart) {
+            if (c === "&" || c === "*" || c === "!")
+                refuse();
+            if (c === "'" || c === '"') {
+                i = c === "'" ? endOfSingleQuoted(line, i) : endOfDoubleQuoted(line, i);
+                afterSpace = false;
+                tokenStart = false;
+                continue;
+            }
+        }
+        afterSpace = false;
+        tokenStart = c === "[" || c === "{" || c === ",";
+        i += 1;
+    }
+    // The trimmed line with every leading "- " marker (and the spaces after it) skipped, by index so a long run of markers is not re-copied.
+    const [trimmedStart, end] = trimmedBounds(line, 0, line.length);
+    let start = trimmedStart;
+    while (start < end && line[start] === "-" && (start + 1 === end || line[start + 1] === " ")) {
+        start += 1;
+        while (start < end && line[start] === " ")
+            start += 1;
+    }
+    const content = line.slice(start, end);
+    if (content === "?" || content.startsWith("? "))
+        refuse();
+    if (content.startsWith("|") || content.startsWith(">"))
+        refuse();
+    const colon = findKeyColon(content);
+    if (colon !== undefined) {
+        const value = content.slice(colon + 1).replace(/^ +/, "");
+        if (value.startsWith("|") || value.startsWith(">"))
+            refuse();
+    }
+}
+/** The decoded scalar of one list item's text after its "- ": a whole single- or double-quoted scalar, or a conservative plain one. */
+function decodeItemScalar(rest) {
+    if (rest === "")
+        return refuse();
+    if (rest.startsWith("'")) {
+        let out = "";
+        let i = 1;
+        for (;;) {
+            if (i >= rest.length)
+                return refuse();
+            if (rest[i] === "'") {
+                if (rest[i + 1] === "'") {
+                    out += "'";
+                    i += 2;
+                    continue;
+                }
+                return i === rest.length - 1 ? out : refuse();
+            }
+            out += rest[i];
+            i += 1;
+        }
+    }
+    if (rest.startsWith('"')) {
+        const end = rest.indexOf('"', 1);
+        if (end !== rest.length - 1)
+            return refuse();
+        const inner = rest.slice(1, -1);
+        return inner.includes("\\") ? refuse() : inner;
+    }
+    if (/^[[\]{},&*!|>'"%@#?`-]/.test(rest))
+        return refuse();
+    if (rest.includes(": ") || rest.endsWith(":") || rest.includes(" #"))
+        return refuse();
+    if (rest.startsWith(" ") || rest.endsWith(" "))
+        return refuse();
+    return rest;
+}
+/**
+ * The block sequence under the target key at `keyIndex`: items of one indent,
+ * each `- ` and one scalar, contiguous from the line after the key. After the
+ * last item only blank lines and column-0 comments may precede the next key.
+ */
+function readTargetList(lines, keyIndex) {
+    const first = lines[keyIndex + 1];
+    const opener = first === undefined ? null : /^( *)- /.exec(first);
+    if (opener === null)
+        return refuse();
+    const indent = opener[1].length;
+    const prefix = `${" ".repeat(indent)}- `;
+    const items = [];
+    let j = keyIndex + 1;
+    while (j < lines.length && lines[j].startsWith(prefix)) {
+        items.push({ index: j, value: decodeItemScalar(lines[j].slice(prefix.length)) });
+        j += 1;
+    }
+    for (; j < lines.length; j += 1) {
+        const line = lines[j];
+        if (isBlankLine(line) || line.startsWith("#"))
+            continue;
+        if (line.startsWith(" ") || line.startsWith("-"))
+            return refuse();
+        break;
+    }
+    return { indent, items };
+}
+function read(text, key) {
+    if (FORBIDDEN_CHARACTERS.test(text))
+        refuse();
+    const lines = text === "" ? [] : (text.endsWith("\n") ? text.slice(0, -1) : text).split("\n");
+    const seen = new Set();
+    // What the latest top-level key holds so far: nothing yet ("open"), an inline value, an indented body, or column-0 items.
+    let mode = "none";
+    let keyIndex = -1;
+    lines.forEach((line, index) => {
+        if (/^(---|\.\.\.)(\s|$)/.test(line) || line.startsWith("%"))
+            refuse();
+        scanForForbiddenConstructs(line);
+        if (isBlankLine(line) || isCommentLine(line))
+            return;
+        if (line.startsWith(" ")) {
+            if (mode === "none")
+                refuse();
+            if (mode === "open")
+                mode = "map";
+            return;
+        }
+        if (/^-( |$)/.test(line)) {
+            if (mode !== "open" && mode !== "seq")
+                refuse();
+            mode = "seq";
+            return;
+        }
+        const match = KEY_LINE.exec(line);
+        if (match === null)
+            return refuse();
+        const name = match[1] ?? match[2] ?? match[3];
+        if (seen.has(name))
+            refuse();
+        seen.add(name);
+        const rest = trimSpaces(match[4] ?? "");
+        mode = rest === "" || rest.startsWith("#") ? "open" : "inline";
+        if (name === key) {
+            if (match[4] !== undefined)
+                refuse();
+            keyIndex = index;
+        }
+    });
+    return { target: keyIndex === -1 ? null : readTargetList(lines, keyIndex) };
+}
+/** Reads `text` under the restricted reader; null is a refusal. */
+function readSurface(text, key) {
+    try {
+        return read(text, key);
+    }
+    catch (error) {
+        if (error instanceof Refusal)
+            return null;
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// Edit and verify.
+// ---------------------------------------------------------------------------
+/**
+ * Adds the scope entry to the surface's exemption list. A missing file or key
+ * is created or appended with a two-space list; an existing block sequence
+ * gains one line after its last item, in its own indent, and nothing else
+ * changes. An already-present entry is unchanged. Refuses a pnpm `.npmrc`
+ * that sets the same list (conflict) or has any line outside the fixed safe
+ * grammar (unparseable), and any file the restricted reader does not fully
+ * recognise (flow lists, comments inside the list, anchors, aliases, tags,
+ * block scalars, multiple documents, tabs, CRLF, repeated keys, and more).
+ */
+export function editReleaseAgeExemption(input) {
+    const { surface, text } = input;
+    const npmrc = readNpmrc(surface, input.npmrc);
+    if (npmrc === "conflict")
+        return CONFLICT;
+    if (npmrc === "unparseable")
+        return UNPARSEABLE;
+    const { key } = EXEMPTION_SURFACES[surface];
+    const entry = quotedEntry(surface);
+    const block = keyBlock(key, entry);
+    if (text === null || text === "")
+        return { kind: "edited", text: block };
+    const reading = readSurface(text, key);
+    if (reading === null)
+        return UNPARSEABLE;
+    const { target } = reading;
+    if (target === null)
+        return { kind: "edited", text: text.endsWith("\n") ? text + block : `${text}\n${block.slice(0, -1)}` };
+    if (target.items.some((item) => item.value === scopeValue()))
+        return { kind: "unchanged" };
+    const last = target.items[target.items.length - 1];
+    const out = text.split("\n");
+    out.splice(last.index + 1, 0, `${" ".repeat(target.indent)}- ${entry}`);
+    return { kind: "edited", text: out.join("\n") };
+}
+/**
+ * Whether `after` is `before` plus exactly the one scope entry, judged by its
+ * own structural comparison of the two texts (and, as a second check, by the
+ * edit function reproducing `after`). The entry must sit after the last
+ * existing item, in the list's indent and the surface's quoting, with every
+ * other byte, including the final newline, unchanged.
+ */
+export function verifyReleaseAgeExemption(input) {
+    const { surface, before, after } = input;
+    if (readNpmrc(surface, input.npmrc) !== "clear" || before === after)
+        return NOT_VERIFIED;
+    const { key } = EXEMPTION_SURFACES[surface];
+    const entry = quotedEntry(surface);
+    const value = scopeValue();
+    const afterReading = readSurface(after, key);
+    const beforeReading = before === null ? { target: null } : readSurface(before, key);
+    if (afterReading === null || beforeReading === null)
+        return NOT_VERIFIED;
+    const beforeValues = beforeReading.target?.items.map((item) => item.value) ?? [];
+    const afterValues = afterReading.target?.items.map((item) => item.value) ?? [];
+    if (beforeValues.includes(value))
+        return NOT_VERIFIED;
+    if (afterValues.length !== beforeValues.length + 1 || afterValues[afterValues.length - 1] !== value)
+        return NOT_VERIFIED;
+    if (!beforeValues.every((existing, i) => existing === afterValues[i]))
+        return NOT_VERIFIED;
+    const target = beforeReading.target;
+    if (target === null) {
+        const block = keyBlock(key, entry);
+        const expected = before === null || before === "" ? block : before.endsWith("\n") ? before + block : `${before}\n${block.slice(0, -1)}`;
+        if (after !== expected)
+            return NOT_VERIFIED;
+    }
+    else {
+        const b = before.split("\n");
+        const a = after.split("\n");
+        const at = target.items[target.items.length - 1].index + 1;
+        if (a.length !== b.length + 1)
+            return NOT_VERIFIED;
+        if (a[at] !== `${" ".repeat(target.indent)}- ${entry}`)
+            return NOT_VERIFIED;
+        if (!b.every((line, i) => a[i < at ? i : i + 1] === line))
+            return NOT_VERIFIED;
+    }
+    const edited = editReleaseAgeExemption(input.npmrc === undefined ? { surface, text: before } : { surface, text: before, npmrc: input.npmrc });
+    return edited.kind === "edited" && edited.text === after ? { verified: true, value } : NOT_VERIFIED;
+}
+//# sourceMappingURL=release-age-edit.js.map

package/dist/release-age-edit.js.map

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

package/dist/root-entries.d.ts

@@ -0,0 +1,36 @@
+/** What adding some paths would do to a repository profile's root vocabulary. */
+export type RootEntriesVerdict = 
+/** No root name is refused: `vocabulary` is none when the profile has no root vocabulary Controller checks. */
+{
+    readonly verdict: "satisfied";
+    readonly vocabulary: "none" | "checked";
+}
+/** Some root names would fail the check: sorted by UTF-16 code units, with no name repeated. */
+ | {
+    readonly verdict: "violated";
+    readonly undeclared: readonly string[];
+    readonly prohibited: readonly string[];
+}
+/** The profile cannot be read as a profile with a well-formed root vocabulary. */
+ | {
+    readonly verdict: "indeterminate";
+    readonly reason: "root-vocabulary-unknown";
+};
+/** Controller's rule for one direct-child name: 1 to 255 characters, trimmed, not . or .., no / or \, no control character. */
+export declare function isRootEntryName(value: unknown): value is string;
+/**
+ * Judges the root names `paths` introduce -- each path's first segment --
+ * against a parsed repository profile. A profile of schema version 1 or 2,
+ * or of version 3 with an empty `rootEntries`, has no root vocabulary
+ * Controller checks, so nothing is refused. A version 3 profile with entries
+ * refuses a name it does not declare, or declares as prohibited. Anything
+ * that is not a profile Controller could read this way -- not an object,
+ * another schema version, a `rootEntries` on version 1 or 2, more than
+ * 10,000 entries, or a malformed or repeated entry -- is indeterminate,
+ * never read as permissive. It judges the root vocabulary only: a profile
+ * whose other fields Controller refuses fails Controller's check whatever
+ * this returns. Throws
+ * when a path is not a safe relative path, which is a caller defect.
+ */
+export declare function wouldViolateRootEntries(profile: unknown, paths: readonly string[]): RootEntriesVerdict;
+//# sourceMappingURL=root-entries.d.ts.map

package/dist/root-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-entries.d.ts","sourceRoot":"","sources":["../src/root-entries.ts"],"names":[],"mappings":"AAaA,iFAAiF;AACjF,MAAM,MAAM,kBAAkB;AAC5B,+GAA+G;AAC7G;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;AAC5E,gGAAgG;GAC9F;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AAClH,kFAAkF;GAChF;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAetF,+HAA+H;AAC/H,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CA0BtG"}

package/dist/root-entries.js

@@ -0,0 +1,80 @@
+// Whether adding paths would break a repository's Controller root
+// vocabulary (issue #1178). A consumer repository may declare a Controller
+// repository profile whose schema version 3 `rootEntries` is a closed list of
+// its direct children; Controller's repository-profile check then fails on a
+// direct child the list does not declare, or declares as prohibited. The
+// shapes read here are Controller's (its README, "Profile schema v3" and
+// "Pure exact-root evaluation"); this package has no runtime dependency on
+// Controller, so this module reads only `schemaVersion` and `rootEntries`,
+// with the same rules, and judges nothing else in the profile. It performs no
+// I/O.
+import { compareCodeUnits, isSafeRelativePath } from "./change-set-contract.js";
+const CLASSIFICATIONS = new Set(["canonical", "extension", "exception", "compatibility-alias", "legacy-artifact"]);
+const DISPOSITIONS = new Set(["required", "allowed", "prohibited"]);
+const ENTRY_KEYS = new Set(["name", "classification", "disposition"]);
+const UNKNOWN = { verdict: "indeterminate", reason: "root-vocabulary-unknown" };
+/** Controller refuses a profile collection of more entries than this. */
+const MAX_ROOT_ENTRIES = 10_000;
+function isPlainRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === null || prototype === Object.prototype;
+}
+/** Controller's rule for one direct-child name: 1 to 255 characters, trimmed, not . or .., no / or \, no control character. */
+export function isRootEntryName(value) {
+    return typeof value === "string" && value.length > 0 && value.length <= 255 && value === value.trim() && value !== "." && value !== ".." && !/[\\/\u0000-\u001f\u007f]/u.test(value);
+}
+/**
+ * Judges the root names `paths` introduce -- each path's first segment --
+ * against a parsed repository profile. A profile of schema version 1 or 2,
+ * or of version 3 with an empty `rootEntries`, has no root vocabulary
+ * Controller checks, so nothing is refused. A version 3 profile with entries
+ * refuses a name it does not declare, or declares as prohibited. Anything
+ * that is not a profile Controller could read this way -- not an object,
+ * another schema version, a `rootEntries` on version 1 or 2, more than
+ * 10,000 entries, or a malformed or repeated entry -- is indeterminate,
+ * never read as permissive. It judges the root vocabulary only: a profile
+ * whose other fields Controller refuses fails Controller's check whatever
+ * this returns. Throws
+ * when a path is not a safe relative path, which is a caller defect.
+ */
+export function wouldViolateRootEntries(profile, paths) {
+    paths.forEach((path, index) => {
+        if (!isSafeRelativePath(path))
+            throw new TypeError(`paths[${index}] is not a safe relative path`);
+    });
+    if (!isPlainRecord(profile))
+        return UNKNOWN;
+    const version = profile.schemaVersion;
+    const hasRoots = Object.hasOwn(profile, "rootEntries");
+    if (version === 1 || version === 2)
+        return hasRoots ? UNKNOWN : { verdict: "satisfied", vocabulary: "none" };
+    if (version !== 3 || !hasRoots)
+        return UNKNOWN;
+    const entries = profile.rootEntries;
+    if (!Array.isArray(entries) || entries.length > MAX_ROOT_ENTRIES || Object.keys(entries).length !== entries.length)
+        return UNKNOWN;
+    const dispositions = new Map();
+    for (const entry of entries) {
+        if (!isPlainRecord(entry) || !Object.keys(entry).every((key) => ENTRY_KEYS.has(key)))
+            return UNKNOWN;
+        const { name, classification, disposition } = entry;
+        if (!isRootEntryName(name) || dispositions.has(name))
+            return UNKNOWN;
+        if (typeof classification !== "string" || !CLASSIFICATIONS.has(classification))
+            return UNKNOWN;
+        if (typeof disposition !== "string" || !DISPOSITIONS.has(disposition))
+            return UNKNOWN;
+        dispositions.set(name, disposition);
+    }
+    if (dispositions.size === 0)
+        return { verdict: "satisfied", vocabulary: "none" };
+    const roots = [...new Set(paths.map((path) => path.split("/")[0]))].sort(compareCodeUnits);
+    const undeclared = roots.filter((root) => !dispositions.has(root));
+    const prohibited = roots.filter((root) => dispositions.get(root) === "prohibited");
+    if (undeclared.length === 0 && prohibited.length === 0)
+        return { verdict: "satisfied", vocabulary: "checked" };
+    return { verdict: "violated", undeclared, prohibited };
+}
+//# sourceMappingURL=root-entries.js.map

package/dist/root-entries.js.map

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

package/dist/setup-template-scripts.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pure renderers for the setup template acts' script and workflow files.
+ *
+ * Each renderer takes no input and returns the exact bytes of one file, so
+ * the text is a pure function of this module alone: no clock, no randomness,
+ * no filesystem, no environment. Everything that reads a clock or a
+ * repository does so inside the emitted script, when a workflow runs it, and
+ * never here.
+ *
+ * Files rendered here:
+ * - `.github/scripts/clossys-collect-adoption-snapshot.mjs`
+ * - `.github/workflows/clossys-adoption-evidence.yml`
+ * - `.github/workflows/clossys-path-scope.yml`
+ *
+ * The path-scope script is standalone, so it runs the same under a test as it
+ * does inside the workflow that embeds it.
+ */
+/**
+ * The path patterns an apply pull request may own, in the change-set
+ * contract's order. The path-scope script embeds this list.
+ */
+export declare const OWNED_PATH_PATTERNS: readonly string[];
+/** The bytes of `.github/scripts/clossys-collect-adoption-snapshot.mjs`. */
+export declare function renderSnapshotCollector(): string;
+/** The bytes of `.github/workflows/clossys-adoption-evidence.yml`. */
+export declare function renderAdoptionEvidenceWorkflow(): string;
+/**
+ * The standalone path-scope script (its text ends in one LF). The
+ * path-scope workflow embeds it; a test runs it with `node` directly.
+ */
+export declare function renderPathScopeScript(): string;
+/** The bytes of `.github/workflows/clossys-path-scope.yml`: the script embedded in a quoted heredoc. */
+export declare function renderPathScopeWorkflow(): string;
+//# sourceMappingURL=setup-template-scripts.d.ts.map

package/dist/setup-template-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-template-scripts.d.ts","sourceRoot":"","sources":["../src/setup-template-scripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAkBhD,CAAC;AAoOF,4EAA4E;AAC5E,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAiED,sEAAsE;AACtE,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAoKD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAuDD,wGAAwG;AACxG,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD"}