redlinegate 0.0.1

package/dist/remove/host.js

@@ -0,0 +1,294 @@
+import { createGit } from "../core/git.js";
+import { RedlineError } from "../core/errors.js";
+import { parseRemote } from "../platforms/detect.js";
+import { createAzureClient } from "../platforms/azure/client.js";
+import { createGitHubClient } from "../platforms/github/client.js";
+import { RULESET_NAME } from "../platforms/github/install.js";
+import { AZURE_STATUS_GENRE, AZURE_STATUS_NAME, POLICY_TYPE_NAMES, REDLINE_POLICY_MARKER, resolvePolicyTypeIds, } from "../platforms/azure/policy-types.js";
+import { isNonNullObject, isSuccess } from "../platforms/shape.js";
+// CONTRACT with GATE_LABELS in cli/platforms/github/install.ts: these are the
+// three labels the gate install creates, with the descriptions it gives them.
+// The description is what makes deletion safe. `no-adr` carries no Redline
+// prefix at all and is exactly the name a team may already have used, and
+// GitHub answers the install's POST with 422 either way — so the install
+// cannot record whether it created one or found one. The description can still
+// answer it: a label still carrying the text Redline wrote is Redline's, and
+// one carrying anything else is the repository's own and is left in place.
+const REDLINE_LABELS = [
+    { name: 'no-adr', description: 'PR intentionally ships without an ADR' },
+    { name: 'redline-exempt', description: 'Gate process checks soft-failed with reviewer sign-off' },
+    { name: 'redline-sync', description: 'Automated standards sync from the Redline source repo' },
+];
+// CONTRACT with cli/platforms/github/install.ts's applyPolicy: the property it
+// sets. GitHub removes a property value when it is PATCHed as null.
+const REPO_PROPERTY = 'redline';
+// CONTRACT with GATE_DEFINITION_NAME/FOLDER and GATE_YAML_FILENAME in
+// cli/platforms/azure/install.ts. All three together are what
+// `ensureGateBuildDefinition` uses to recognise its own definition, and the
+// same tuple is what this file reports on.
+const AZURE_GATE_DEFINITION = '\\Redline\\redline-gate';
+const OUTCOME_RANK = {
+    denied: 4,
+    unknown: 3,
+    unsupported: 2,
+    already: 1,
+    applied: 0,
+};
+// Several host calls fold into one capability the operator reads — three label
+// deletions, several Azure policy deletions. Ranked by how actionable the
+// status is rather than by HTTP status number, so a definite refusal on one
+// call is never masked by a larger number on another. Same table and same
+// reasoning as both install adapters.
+function worstOutcome(outcomes) {
+    const [first, ...rest] = outcomes;
+    if (!first)
+        throw new Error('worstOutcome requires at least one outcome');
+    return rest.reduce((worst, next) => (OUTCOME_RANK[next.status] > OUTCOME_RANK[worst.status] ? next : worst), first);
+}
+// Every DELETE below is issued only after a read confirmed the object is there,
+// so a 404 on the delete itself is not "already gone": GitHub answers 404
+// rather than 403 on an admin endpoint a fine-grained token cannot reach, the
+// same reading writeOutcome takes in cli/platforms/github/install.ts. Reporting
+// it as success would tell an operator their ruleset is gone when it is not.
+function deleteOutcome(capability, status, detail) {
+    if (isSuccess(status))
+        return { capability, status: 'applied', detail };
+    if (status === 401 || status === 403 || status === 404) {
+        return { capability, status: 'denied', detail: `${detail} (needs repository admin)` };
+    }
+    return { capability, status: 'denied', detail: `${detail} (HTTP ${status})` };
+}
+// A read that did not answer. It cannot be `unknown`: `unknown` never reaches
+// pendingAdmin (isPending is exactly `denied`), and a repository whose Redline
+// ruleset could not even be listed has host state left behind that somebody has
+// to go and remove. The detail says it was the read that failed, so nobody goes
+// looking for a delete that was never attempted.
+function unreadable(capability, status, what) {
+    return {
+        capability,
+        status: 'denied',
+        detail: `${what} could not be read (HTTP ${status}), so nothing was removed — ` +
+            'an administrator has to take it away by hand',
+    };
+}
+function parseNamedObjects(body) {
+    if (!Array.isArray(body))
+        return null;
+    const parsed = [];
+    for (const item of body) {
+        if (!isNonNullObject(item) || typeof item['id'] !== 'number' || typeof item['name'] !== 'string') {
+            return null;
+        }
+        parsed.push({ id: item['id'], name: item['name'] });
+    }
+    return parsed;
+}
+function parseLabelDescription(body) {
+    if (!isNonNullObject(body))
+        return null;
+    const description = body['description'];
+    return typeof description === 'string' ? description : '';
+}
+export function createGitHubWithdrawal(client) {
+    const repoPath = (ref) => `/repos/${ref.org}/${ref.repo}`;
+    async function withdrawRuleset(ref) {
+        const listed = await client.rest('GET', `${repoPath(ref)}/rulesets`);
+        if (!isSuccess(listed.status)) {
+            return unreadable('merge-policy', listed.status, `the branch rulesets on ${ref.repo}`);
+        }
+        const rulesets = parseNamedObjects(listed.body);
+        if (rulesets === null) {
+            throw new RedlineError('host', 'GitHub returned an unexpected shape for the rulesets list');
+        }
+        // By name, which is the only attribution a ruleset carries. A ruleset a
+        // human named anything else is theirs even if it requires the Redline
+        // check — that is a policy decision they made, and taking it away is not
+        // this command's to do.
+        const mine = rulesets.find((ruleset) => ruleset.name === RULESET_NAME);
+        if (!mine) {
+            return {
+                capability: 'merge-policy',
+                status: 'already',
+                detail: `no ruleset named "${RULESET_NAME}" on this repository — nothing to remove`,
+            };
+        }
+        const deleted = await client.rest('DELETE', `${repoPath(ref)}/rulesets/${mine.id}`);
+        return deleteOutcome('merge-policy', deleted.status, `branch ruleset "${RULESET_NAME}" (and with it the required Redline check)`);
+    }
+    async function withdrawLabels(ref) {
+        const notes = [];
+        const outcomes = [];
+        for (const label of REDLINE_LABELS) {
+            const path = `${repoPath(ref)}/labels/${label.name}`;
+            const read = await client.rest('GET', path);
+            if (read.status === 404)
+                continue; // not on this repository at all
+            if (!isSuccess(read.status)) {
+                outcomes.push(unreadable('labels', read.status, `the "${label.name}" label`));
+                continue;
+            }
+            const description = parseLabelDescription(read.body);
+            if (description === null) {
+                throw new RedlineError('host', 'GitHub returned an unexpected shape for a label');
+            }
+            if (description !== label.description) {
+                notes.push(`the "${label.name}" label was left in place: its description is no longer the one Redline ` +
+                    'wrote, so this repository has made it its own');
+                continue;
+            }
+            const deleted = await client.rest('DELETE', path);
+            outcomes.push(deleteOutcome('labels', deleted.status, `label "${label.name}"`));
+        }
+        if (outcomes.length === 0) {
+            return {
+                outcome: {
+                    capability: 'labels',
+                    status: 'already',
+                    detail: 'no label still carrying a Redline description — nothing to remove',
+                },
+                notes,
+            };
+        }
+        return { outcome: worstOutcome(outcomes), notes };
+    }
+    return {
+        host: 'github',
+        async withdraw(ref) {
+            const ruleset = await withdrawRuleset(ref);
+            const labels = await withdrawLabels(ref);
+            // Removed by PATCHing the value to null, which is how GitHub deletes a
+            // repository property value. The registry derives the estate by walking
+            // for this property, so leaving it set is what keeps a removed repository
+            // showing up as onboarded.
+            const property = await client.rest('PATCH', `${repoPath(ref)}/properties/values`, {
+                properties: [{ property_name: REPO_PROPERTY, value: null }],
+            });
+            return {
+                outcomes: [
+                    ruleset,
+                    labels.outcome,
+                    deleteOutcome('repo-property', property.status, `repository property "${REPO_PROPERTY}"`),
+                ],
+                notes: labels.notes,
+            };
+        },
+    };
+}
+function parsePolicyConfigurations(body) {
+    if (!isNonNullObject(body) || !Array.isArray(body['value']))
+        return null;
+    const configs = [];
+    for (const item of body['value']) {
+        if (!isNonNullObject(item) || typeof item['id'] !== 'number')
+            return null;
+        const type = item['type'];
+        if (!isNonNullObject(type) || typeof type['id'] !== 'string')
+            return null;
+        const settings = item['settings'];
+        if (!isNonNullObject(settings))
+            return null;
+        configs.push({ id: item['id'], typeId: type['id'], settings });
+    }
+    return configs;
+}
+export function createAzureWithdrawal(client) {
+    return {
+        host: 'azure',
+        async withdraw(ref) {
+            const project = ref.project;
+            const repoId = ref.repoId;
+            if (project === undefined || repoId === undefined) {
+                throw new RedlineError('usage', 'an Azure DevOps repository needs a project and its id');
+            }
+            const listed = await client.request('GET', `/${project}/_apis/policy/configurations`);
+            if (!isSuccess(listed.status)) {
+                return {
+                    outcomes: [unreadable('merge-policy', listed.status, 'the branch policies on this project')],
+                    notes: [],
+                };
+            }
+            const configs = parsePolicyConfigurations(listed.body);
+            if (configs === null) {
+                throw new RedlineError('host', 'Azure DevOps returned an unexpected shape for policy configurations');
+            }
+            const types = await resolvePolicyTypeIds(client, project);
+            const statusTypeId = types[POLICY_TYPE_NAMES.status];
+            // Scoped to THIS repository, and marked as Redline's. Both halves matter:
+            // policy configurations are project-wide, so a sibling repository's
+            // Redline policies are in the same list and are not this run's to delete.
+            const coversThisRepo = (config) => {
+                const scope = config.settings['scope'];
+                if (!Array.isArray(scope))
+                    return false;
+                return scope.some((entry) => isNonNullObject(entry) && entry['repositoryId'] === repoId);
+            };
+            // The displayName marker every policy `redline init` writes carries, plus
+            // the genre/name pair that identifies the gate Status policy — which
+            // predates the marker, so a repository onboarded by an earlier release is
+            // still recognised rather than abandoned. Exactly the two tests
+            // cli/platforms/azure/install.ts uses to decide a policy is its own.
+            const mine = (config) => {
+                const displayName = config.settings['displayName'];
+                if (typeof displayName === 'string' && displayName.startsWith(REDLINE_POLICY_MARKER)) {
+                    return true;
+                }
+                return (config.typeId === statusTypeId &&
+                    config.settings['statusGenre'] === AZURE_STATUS_GENRE &&
+                    config.settings['statusName'] === AZURE_STATUS_NAME);
+            };
+            const targets = configs.filter((config) => coversThisRepo(config) && mine(config));
+            const outcomes = [];
+            for (const config of targets) {
+                const deleted = await client.request('DELETE', `/${project}/_apis/policy/configurations/${config.id}`);
+                outcomes.push(deleteOutcome('merge-policy', deleted.status, `branch policy ${config.id}`));
+            }
+            return {
+                outcomes: [
+                    outcomes.length === 0
+                        ? {
+                            capability: 'merge-policy',
+                            status: 'already',
+                            detail: `no branch policy carrying "${REDLINE_POLICY_MARKER}" on this repository — nothing to remove`,
+                        }
+                        : worstOutcome(outcomes),
+                    {
+                        capability: 'repo-property',
+                        status: 'unsupported',
+                        detail: 'Azure DevOps has no repository properties, so there is none to clear',
+                    },
+                    {
+                        capability: 'labels',
+                        status: 'unsupported',
+                        detail: 'Azure DevOps creates pull request labels on use rather than declaring them on the ' +
+                            'repository, so there is no label object to remove',
+                    },
+                ],
+                // Left standing on purpose. Deleting a build definition deletes its run
+                // history with it, and that history is the repository's record of what
+                // ran on which pull request — losing it is a bigger change than
+                // removing Redline. The Build Validation policy above is gone, so the
+                // definition no longer queues on anything.
+                notes: [
+                    `the "${AZURE_GATE_DEFINITION}" pipeline definition is still registered and is yours to ` +
+                        'delete: removing it would delete its run history too, and nothing queues it now that ' +
+                        'the Build Validation policy is gone',
+                ],
+            };
+        },
+    };
+}
+/**
+ * The withdrawal port for whichever host this checkout belongs to. It reads the
+ * remote the same way cli/platforms/resolve.ts does, and for the same reason —
+ * the git remote is the only thing that says which host a working tree is on.
+ */
+export function createHostWithdrawal(cwd, deps = {}) {
+    const gitFor = deps.gitFor ?? ((dir) => createGit(dir));
+    const identity = parseRemote(gitFor(cwd).remoteUrl());
+    if (identity.host === 'github') {
+        return createGitHubWithdrawal((deps.makeGitHubClient ?? createGitHubClient)());
+    }
+    const makeAzure = deps.makeAzureClient ?? ((org) => createAzureClient(org));
+    return createAzureWithdrawal(makeAzure(identity.org));
+}
+//# sourceMappingURL=host.js.map

package/dist/remove/host.js.map

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

package/dist/render/commands.js

@@ -0,0 +1,139 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { RedlineError } from "../core/errors.js";
+import { wrapBlock } from "./markers.js";
+import { stripBlock } from "./standards.js";
+const FRONTMATTER = /^---\n([\s\S]*?)\n---\n?/;
+export function loadCommands(root) {
+    const dir = join(root, 'commands');
+    return readdirSync(dir)
+        .filter((f) => f.endsWith('.md'))
+        .map((file) => {
+        const raw = readFileSync(join(dir, file), 'utf8');
+        const match = FRONTMATTER.exec(raw);
+        const description = /description:\s*(.+)/.exec(match?.[1] ?? '')?.[1]?.trim() ?? '';
+        return {
+            name: file.replace(/\.md$/, ''),
+            description,
+            body: raw.slice(match?.[0].length ?? 0).trimStart(),
+        };
+    });
+}
+// The header says whose it is. Nothing about the SHAPE of a frontmatter block
+// tells Redline's apart from a human's — a team's own command file can carry an
+// identical lone `description:` key — so recognising it by shape claimed their
+// bytes. Marking what Redline owns is the answer markers.ts already gives for
+// the body: an indeterminate read is not an answer, so this makes it
+// determinate. It goes below the keys, not above them, because the tools read
+// the first key of the block.
+const MANAGED_BY = '# Managed by Redline; regenerate with `redline init` rather than editing here.';
+const MANAGED_HEADER = /^# Managed by Redline\b/m;
+const MANAGED_LINE = /^# Managed by Redline\b[^\n]*\n/m;
+export const COMMAND_HOSTS = {
+    copilot: (cmd) => ({
+        path: `.github/prompts/${cmd.name}.prompt.md`,
+        header: `---\nmode: agent\ndescription: ${cmd.description}\n${MANAGED_BY}\n---\n`,
+        body: cmd.body,
+    }),
+    claude: (cmd) => ({
+        path: `.claude/commands/${cmd.name}.md`,
+        header: `---\ndescription: ${cmd.description}\n${MANAGED_BY}\n---\n`,
+        body: cmd.body,
+    }),
+    opencode: (cmd) => ({
+        path: `.opencode/command/${cmd.name}.md`,
+        header: `---\ndescription: ${cmd.description}\n${MANAGED_BY}\n---\n`,
+        body: cmd.body,
+    }),
+    cursor: (cmd) => ({ path: `.cursor/commands/${cmd.name}.md`, header: '', body: cmd.body }),
+};
+// What the renderer before the marker block wrote at this path: the header and
+// the body with one blank line between them, and no attribution line, because
+// there was none to write. Every repository already onboarded has exactly these
+// bytes on disk, put there by Redline itself — merge-or-create is the right
+// answer for a HUMAN's file and the wrong one for Redline's own earlier output,
+// which would get its prompt appended to itself and run twice. Recomputed
+// rather than pattern-matched, so it can only ever recognise a file Redline
+// actually produced.
+function previouslyRendered(header, body) {
+    const legacyHeader = header.replace(MANAGED_LINE, '');
+    const composed = legacyHeader === '' ? body : `${legacyHeader}\n${body}`;
+    return `${composed.trimEnd()}\n`;
+}
+// What `.redline.json` records for every command file Redline owns whole, and
+// the only thing a later run compares that record against. The algorithm is
+// therefore part of the on-disk contract: change it and every recorded
+// identifier stops matching, which silently returns those repositories to the
+// byte-exact fallback below.
+export function contentId(text) {
+    return `sha256:${createHash('sha256').update(text).digest('hex')}`;
+}
+// `<name>` is only the filename in `commands/`, and nothing reserves that name
+// in a consumer repository — `commands/review-pr.md` here would land on a
+// team's own `.claude/commands/review-pr.md`. So whatever is at the path stays
+// and Redline's half goes inside a marker block beside it. A `.claude/commands`
+// file IS one prompt body, so `/<name>` then runs both texts concatenated; that
+// is the accepted cost of not overwriting a human's prompt, and the markers are
+// what keep Redline's half removable and re-renderable.
+export function renderCommands(opts) {
+    const commands = loadCommands(opts.root);
+    const written = [];
+    const removed = [];
+    const contentIds = {};
+    for (const host of opts.hosts) {
+        if (!COMMAND_HOSTS[host]) {
+            throw new RedlineError('usage', `unknown command host "${host}". Known: ${Object.keys(COMMAND_HOSTS).join(', ')}`);
+        }
+    }
+    // Every host, not just the selected ones: a host that is no longer selected
+    // is how Redline's block gets taken back out again, which is the other half
+    // of being allowed to merge it into a file it does not own.
+    for (const [host, renderer] of Object.entries(COMMAND_HOSTS)) {
+        const selected = opts.hosts.includes(host);
+        for (const command of commands) {
+            const { path, header, body } = renderer(command);
+            const target = join(opts.out, path);
+            const current = existsSync(target) ? readFileSync(target, 'utf8') : null;
+            // Throws rather than guessing on a half-edited marker pair or a block
+            // hidden under an unclosed fence — see markers.ts. Nothing is written.
+            const outside = current === null ? null : stripBlock(current, path);
+            // Redline's to rewrite whole: the file is nothing but its block, or what
+            // sits outside the block carries Redline's own attribution line, or the
+            // file predates the block entirely and is byte-for-byte what Redline
+            // last rendered there.
+            // The recorded identifier is asked first because it is the only one of
+            // the three that does not move when `commands/<name>.md` changes here.
+            const recorded = opts.known?.[path];
+            const ownedWhole = outside === null ||
+                (outside !== current && MANAGED_HEADER.test(outside)) ||
+                (current !== null &&
+                    outside === current &&
+                    (recorded === contentId(current) || current === previouslyRendered(header, body)));
+            if (!selected) {
+                if (current === null || outside === current)
+                    continue; // never Redline's — brownfield rule
+                if (!opts.check) {
+                    if (ownedWhole)
+                        rmSync(target);
+                    else
+                        writeFileSync(target, outside);
+                }
+                removed.push(path);
+                continue;
+            }
+            const next = wrapBlock(current === null || ownedWhole ? header : current, body, path);
+            if (current === null || ownedWhole)
+                contentIds[path] = contentId(next);
+            if (current === next)
+                continue;
+            if (!opts.check) {
+                mkdirSync(dirname(target), { recursive: true });
+                writeFileSync(target, next);
+            }
+            written.push(path);
+        }
+    }
+    return { written, removed, contentIds };
+}
+//# sourceMappingURL=commands.js.map

package/dist/render/commands.js.map

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

package/dist/render/manifest.js

@@ -0,0 +1,82 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { RedlineError } from "../core/errors.js";
+function isNonNullObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function parseManifest(raw) {
+    if (!isNonNullObject(raw)) {
+        throw new RedlineError('usage', 'standards manifest is not a JSON object');
+    }
+    const version = raw['version'];
+    if (typeof version !== 'string') {
+        throw new RedlineError('usage', 'standards manifest is missing a string "version" field');
+    }
+    const core = raw['core'];
+    const stacks = raw['stacks'];
+    const profiles = raw['profiles'];
+    const vendors = raw['vendors'];
+    if (!isNonNullObject(core)) {
+        throw new RedlineError('usage', 'standards manifest is missing an object "core" field');
+    }
+    if (!isNonNullObject(stacks)) {
+        throw new RedlineError('usage', 'standards manifest is missing an object "stacks" field');
+    }
+    if (!isNonNullObject(profiles)) {
+        throw new RedlineError('usage', 'standards manifest is missing an object "profiles" field');
+    }
+    if (!isNonNullObject(vendors)) {
+        throw new RedlineError('usage', 'standards manifest is missing an object "vendors" field');
+    }
+    const coreTitle = core['title'];
+    const coreSource = core['source'];
+    if (typeof coreTitle !== 'string' || typeof coreSource !== 'string') {
+        throw new RedlineError('usage', 'standards manifest "core" needs string "title" and "source" fields');
+    }
+    const profileAliasesRaw = raw['profileAliases'];
+    if (profileAliasesRaw !== undefined && !isNonNullObject(profileAliasesRaw)) {
+        throw new RedlineError('usage', 'standards manifest "profileAliases" must be an object');
+    }
+    const profileAliases = (profileAliasesRaw ?? {});
+    const deterministicRaw = raw['deterministic'];
+    if (deterministicRaw !== undefined && !Array.isArray(deterministicRaw)) {
+        throw new RedlineError('usage', 'standards manifest "deterministic" must be an array of rule ids');
+    }
+    const deterministic = (deterministicRaw ?? []);
+    for (const id of deterministic) {
+        if (typeof id !== 'string') {
+            throw new RedlineError('usage', 'standards manifest "deterministic" must contain only rule ids');
+        }
+    }
+    return {
+        version,
+        core: { title: coreTitle, source: coreSource },
+        stacks: stacks,
+        profiles: profiles,
+        profileAliases,
+        vendors: vendors,
+        deterministic,
+    };
+}
+function errorCode(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error))
+        return undefined;
+    const code = error.code;
+    return typeof code === 'string' ? code : undefined;
+}
+export function loadManifest(root) {
+    const path = join(root, 'standards/manifest.json');
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        if (errorCode(error) === 'EACCES') {
+            throw new RedlineError('permission', `permission denied reading the standards manifest at ${path}`);
+        }
+        throw new RedlineError('usage', `cannot read the standards manifest at ${path}`);
+    }
+    const parsed = JSON.parse(raw);
+    return parseManifest(parsed);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/render/manifest.js.map

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