@design-parity/action 0.1.0

package/dist/github/publish.js

@@ -0,0 +1,91 @@
+/**
+ * Publish a staged artifact directory to a permanent branch (issue #56),
+ * encapsulating the git plumbing so a consumer workflow is just "render
+ * candidates → use the action". Mirrors the `compose-ai-tools` `apply`
+ * `push-branch.sh` helper, in TypeScript and with an injectable git runner so
+ * the sequence is unit-testable (the same shape as the `fetch`-injectable REST
+ * client).
+ *
+ * The staged dir is treated as a throwaway repo: `git init` there, write its
+ * contents as one tree, re-parent on the branch tip (orphan commit the first
+ * time), and push. A race-retry loop re-fetches the tip and re-parents when a
+ * concurrent run beat us to the branch. Nothing touches the consumer's working
+ * checkout.
+ *
+ * Requires a token with `contents: write`. The commit identity defaults to the
+ * GitHub Actions bot so published commits never claim a human author.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Default runner: shells out to the system `git` in `cwd`. */
+export const execGit = async (args, { cwd }) => {
+    try {
+        const { stdout, stderr } = await execFileAsync("git", args, {
+            cwd,
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        return { stdout, stderr, code: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return { stdout: e.stdout ?? "", stderr: e.stderr ?? "", code: e.code ?? 1 };
+    }
+};
+const BOT_NAME = "github-actions[bot]";
+const BOT_EMAIL = "41898282+github-actions[bot]@users.noreply.github.com";
+const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+function remoteUrl(serverUrl, repo, token) {
+    const host = serverUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
+    return `https://x-access-token:${token}@${host}/${repo}.git`;
+}
+/**
+ * Stage `sourceDir`'s contents and push them as a single commit on `branch`,
+ * re-parented on the existing tip. Retries the push on a non-fast-forward race.
+ */
+export async function publishBaseline(options) {
+    const git = options.git ?? execGit;
+    const sleep = options.sleep ?? wait;
+    const cwd = options.sourceDir;
+    const maxAttempts = options.maxAttempts ?? 5;
+    const run = async (...args) => git(args, { cwd });
+    const ok = async (...args) => {
+        const r = await run(...args);
+        if (r.code !== 0) {
+            throw new Error(`git ${args.join(" ")} → ${r.code}: ${r.stderr.trim()}`);
+        }
+        return r.stdout.trim();
+    };
+    await ok("init", "-q");
+    await ok("config", "user.name", options.authorName ?? BOT_NAME);
+    await ok("config", "user.email", options.authorEmail ?? BOT_EMAIL);
+    await ok("remote", "add", "origin", remoteUrl(options.serverUrl ?? "https://github.com", options.repo, options.token));
+    await ok("add", "-A");
+    const tree = await ok("write-tree");
+    for (let attempt = 1;; attempt++) {
+        // Re-fetch the tip every attempt so a retry re-parents on the latest.
+        let parent = "";
+        const fetched = await run("fetch", "--depth=1", "--quiet", "origin", options.branch);
+        if (fetched.code === 0) {
+            parent = await ok("rev-parse", "FETCH_HEAD");
+            if (options.skipIfUnchanged) {
+                const parentTree = await ok("rev-parse", `${parent}^{tree}`);
+                if (parentTree === tree) {
+                    return { branch: options.branch, pushed: false };
+                }
+            }
+        }
+        const commit = parent
+            ? await ok("commit-tree", tree, "-p", parent, "-m", options.message)
+            : await ok("commit-tree", tree, "-m", options.message); // orphan: first push
+        const pushed = await run("push", "--quiet", "origin", `${commit}:refs/heads/${options.branch}`);
+        if (pushed.code === 0) {
+            return { branch: options.branch, pushed: true, sha: commit };
+        }
+        if (attempt >= maxAttempts) {
+            throw new Error(`push to ${options.branch} failed after ${attempt} attempts: ${pushed.stderr.trim()}`);
+        }
+        await sleep(attempt * 2000);
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/github/publish.js.map

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

package/dist/github/rest.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A tiny GitHub REST client over `fetch` — just the few endpoints the Action
+ * needs (changed files + issue comments). No SDK dependency, mirroring the figma
+ * adapter's hand-rolled client. `fetch` is injectable for tests.
+ */
+import type { GitHubCommentClient } from "./surface.js";
+export type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<Response>;
+export interface GitHubRestOptions {
+    token: string;
+    baseUrl?: string;
+    fetch?: FetchLike;
+}
+export interface RepoRef {
+    owner: string;
+    repo: string;
+}
+export declare class GitHubRest {
+    #private;
+    constructor(opts: GitHubRestOptions);
+    /** Changed file paths in a PR (paginated). */
+    listPullRequestFiles({ owner, repo }: RepoRef, prNumber: number): Promise<string[]>;
+    /** A {@link GitHubCommentClient} bound to one PR's comment thread. */
+    commentClient(ref: RepoRef, prNumber: number): GitHubCommentClient;
+}
+//# sourceMappingURL=rest.d.ts.map

package/dist/github/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/github/rest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,cAAc,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACxE,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,UAAU;;gBAKT,IAAI,EAAE,iBAAiB;IAyBnC,8CAA8C;IACxC,oBAAoB,CACxB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC;IAapB,sEAAsE;IACtE,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB;CAwBnE"}

package/dist/github/rest.js

@@ -0,0 +1,64 @@
+export class GitHubRest {
+    #base;
+    #fetch;
+    #headers;
+    constructor(opts) {
+        const fetchImpl = opts.fetch ?? globalThis.fetch;
+        if (!fetchImpl)
+            throw new Error("design-parity: no fetch available");
+        this.#fetch = fetchImpl;
+        this.#base = (opts.baseUrl ?? "https://api.github.com").replace(/\/$/, "");
+        this.#headers = {
+            Authorization: `Bearer ${opts.token}`,
+            Accept: "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+        };
+    }
+    async #req(method, path, body) {
+        const res = await this.#fetch(`${this.#base}${path}`, {
+            method,
+            headers: this.#headers,
+            ...(body ? { body: JSON.stringify(body) } : {}),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`github: ${method} ${path} → ${res.status} ${text}`);
+        }
+        return (res.status === 204 ? undefined : await res.json());
+    }
+    /** Changed file paths in a PR (paginated). */
+    async listPullRequestFiles({ owner, repo }, prNumber) {
+        const files = [];
+        for (let page = 1; page <= 30; page++) {
+            const batch = await this.#req("GET", `/repos/${owner}/${repo}/pulls/${prNumber}/files?per_page=100&page=${page}`);
+            files.push(...batch.map((f) => f.filename));
+            if (batch.length < 100)
+                break;
+        }
+        return files;
+    }
+    /** A {@link GitHubCommentClient} bound to one PR's comment thread. */
+    commentClient(ref, prNumber) {
+        const base = `/repos/${ref.owner}/${ref.repo}/issues/${prNumber}/comments`;
+        const commentsBase = `/repos/${ref.owner}/${ref.repo}/issues/comments`;
+        return {
+            listComments: async () => {
+                const out = [];
+                for (let page = 1; page <= 10; page++) {
+                    const batch = await this.#req("GET", `${base}?per_page=100&page=${page}`);
+                    out.push(...batch.map((c) => ({ id: c.id, body: c.body })));
+                    if (batch.length < 100)
+                        break;
+                }
+                return out;
+            },
+            createComment: async (body) => {
+                await this.#req("POST", base, { body });
+            },
+            updateComment: async (id, body) => {
+                await this.#req("PATCH", `${commentsBase}/${id}`, { body });
+            },
+        };
+    }
+}
+//# sourceMappingURL=rest.js.map

package/dist/github/rest.js.map

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

package/dist/github/surface.d.ts

@@ -0,0 +1,17 @@
+export interface IssueComment {
+    id: number;
+    body: string;
+}
+/** The minimal slice of the GitHub API the surface needs (already PR-scoped). */
+export interface GitHubCommentClient {
+    listComments(): Promise<IssueComment[]>;
+    createComment(body: string): Promise<void>;
+    updateComment(id: number, body: string): Promise<void>;
+}
+export type PostOutcome = "created" | "updated";
+/**
+ * Create the report comment, or update the bot's existing one in place. Matches
+ * its own comment by {@link REPORT_MARKER}, so re-runs never pile up duplicates.
+ */
+export declare function postReport(client: GitHubCommentClient, body: string): Promise<PostOutcome>;
+//# sourceMappingURL=surface.d.ts.map

package/dist/github/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../src/github/surface.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACxC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAUtB"}

package/dist/github/surface.js

@@ -0,0 +1,21 @@
+/**
+ * The PR comment surface: post the parity report as a single comment and update
+ * that same comment on every re-run (idempotent), found by the stable
+ * {@link REPORT_MARKER}. The GitHub client is an injected interface so this is
+ * unit-testable with a fake and free of any SDK dependency.
+ */
+import { REPORT_MARKER } from "../report.js";
+/**
+ * Create the report comment, or update the bot's existing one in place. Matches
+ * its own comment by {@link REPORT_MARKER}, so re-runs never pile up duplicates.
+ */
+export async function postReport(client, body) {
+    const existing = (await client.listComments()).find((c) => c.body.includes(REPORT_MARKER));
+    if (existing) {
+        await client.updateComment(existing.id, body);
+        return "updated";
+    }
+    await client.createComment(body);
+    return "created";
+}
+//# sourceMappingURL=surface.js.map

package/dist/github/surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../src/github/surface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgB7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA2B,EAC3B,IAAY;IAEZ,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACxD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/B,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@design-parity/action` — the integration layer.
+ *
+ * Wires the resolver, the `source → adapter` registry, the candidate renderer,
+ * the diff engine (+ checks), and the parity-direction policy into a single
+ * {@link orchestrate} pipeline, and renders the aggregate {@link ParityReport}
+ * for the PR surface, which it also posts/updates as a single PR comment.
+ */
+export { createAdapterRegistry } from "./registry.js";
+export type { AdapterRegistry, RegistryOptions } from "./registry.js";
+export { orchestrate } from "./orchestrate.js";
+export type { OrchestrateOptions, CandidateProvider, ComponentResult, ComponentStatus, ParityReport, } from "./orchestrate.js";
+export { buildCandidateProvider, loadPrecomputed, precomputedSource, providerFromSource, resolveBundlePaths, } from "./candidate.js";
+export type { BuildProviderOptions } from "./candidate.js";
+export { resolveRunConfig } from "./config.js";
+export type { RunConfig } from "./config.js";
+export { renderReport, renderBootstrapNotice, REPORT_MARKER, CMP_PROMOTION, } from "./report.js";
+export { selectMode } from "./mode.js";
+export type { ActionMode, ModeInputs } from "./mode.js";
+export { pushBack, decidePushBack } from "./pushback.js";
+export type { PushBackGate, PushBackOptions, PushBackReport, PushBackComponent, PushBackSkip, PushBackError, PushedImage, } from "./pushback.js";
+export { baselineSummary, renderBaselineIndex, writeBaselineArtifacts, } from "./baseline.js";
+export type { BaselineArtifacts, BaselineComponent, BaselineMeta, BaselineSummary, } from "./baseline.js";
+export { postReport } from "./github/surface.js";
+export type { GitHubCommentClient, IssueComment, PostOutcome, } from "./github/surface.js";
+export { GitHubRest } from "./github/rest.js";
+export type { GitHubRestOptions, RepoRef, FetchLike } from "./github/rest.js";
+export { componentsForChangedFiles, filePathOf, } from "./github/changed-components.js";
+export { checkConclusion, exitCode } from "./github/conclusion.js";
+export type { CheckConclusion } from "./github/conclusion.js";
+export { publishBaseline, execGit } from "./github/publish.js";
+export type { GitRunner, GitResult, PublishOptions, PublishResult, } from "./github/publish.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EACL,yBAAyB,EACzB,UAAU,GACX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * `@design-parity/action` — the integration layer.
+ *
+ * Wires the resolver, the `source → adapter` registry, the candidate renderer,
+ * the diff engine (+ checks), and the parity-direction policy into a single
+ * {@link orchestrate} pipeline, and renders the aggregate {@link ParityReport}
+ * for the PR surface, which it also posts/updates as a single PR comment.
+ */
+export { createAdapterRegistry } from "./registry.js";
+export { orchestrate } from "./orchestrate.js";
+export { buildCandidateProvider, loadPrecomputed, precomputedSource, providerFromSource, resolveBundlePaths, } from "./candidate.js";
+export { resolveRunConfig } from "./config.js";
+export { renderReport, renderBootstrapNotice, REPORT_MARKER, CMP_PROMOTION, } from "./report.js";
+export { selectMode } from "./mode.js";
+export { pushBack, decidePushBack } from "./pushback.js";
+export { baselineSummary, renderBaselineIndex, writeBaselineArtifacts, } from "./baseline.js";
+// GitHub surface
+export { postReport } from "./github/surface.js";
+export { GitHubRest } from "./github/rest.js";
+export { componentsForChangedFiles, filePathOf, } from "./github/changed-components.js";
+export { checkConclusion, exitCode } from "./github/conclusion.js";
+export { publishBaseline, execGit } from "./github/publish.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWzD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAQvB,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EACL,yBAAyB,EACzB,UAAU,GACX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/mode.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Decide what the Action does for the triggering event, mirroring the sibling
+ * `compose-ai-tools` `apply` selector (issue #56):
+ *
+ * - **`comment`** — a `pull_request`: render the changed components, run the
+ *   pipeline, and post/update the single verdict comment (today's behavior).
+ * - **`baseline`** — a `push` to the long-lived `development-branch`: render the
+ *   full mapped surface and publish the browsable artifacts (per-component
+ *   `report.html` triptychs + a machine-readable `verdict.json`) to a permanent
+ *   artifact branch, force-updated each run. This is the always-current parity
+ *   state of the dev branch and the baseline a PR can diff against.
+ * - **`skip`** — nothing applies (e.g. a push to a non-dev branch).
+ *
+ * Pure: no env reads, no I/O — the entrypoint feeds it the resolved inputs.
+ */
+export type ActionMode = "baseline" | "comment" | "skip";
+export interface ModeInputs {
+    /** `GITHUB_EVENT_NAME` (e.g. `pull_request`, `push`, `workflow_dispatch`). */
+    eventName?: string;
+    /** `GITHUB_REF_NAME` — the short branch/tag name of the triggering ref. */
+    refName?: string;
+    /** The long-lived branch whose pushes flip the Action into baseline mode. */
+    developmentBranch: string;
+    /** `INPUT_MODE` override: `auto` (default), `baseline`, `comment`, or `skip`. */
+    override?: string;
+    /** A resolved PR number, used only as the `auto` fallback for odd events. */
+    prNumber?: number;
+}
+/**
+ * Map the event (or an explicit `mode` override) to the Action mode. A
+ * `workflow_dispatch` sitting on the development branch behaves like a push
+ * (manual baseline refresh); elsewhere it falls back to comment mode.
+ */
+export declare function selectMode(inputs: ModeInputs): ActionMode;
+//# sourceMappingURL=mode.d.ts.map

package/dist/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAiBzD"}

package/dist/mode.js

@@ -0,0 +1,25 @@
+const EXPLICIT = new Set(["baseline", "comment", "skip"]);
+/**
+ * Map the event (or an explicit `mode` override) to the Action mode. A
+ * `workflow_dispatch` sitting on the development branch behaves like a push
+ * (manual baseline refresh); elsewhere it falls back to comment mode.
+ */
+export function selectMode(inputs) {
+    const override = (inputs.override ?? "auto").trim();
+    if (EXPLICIT.has(override))
+        return override;
+    const onDevBranch = inputs.refName === inputs.developmentBranch;
+    switch (inputs.eventName) {
+        case "pull_request":
+        case "pull_request_target":
+            return "comment";
+        case "push":
+            return onDevBranch ? "baseline" : "skip";
+        case "workflow_dispatch":
+            return onDevBranch ? "baseline" : "comment";
+        default:
+            // Unknown event: comment if a PR is in context, otherwise nothing to do.
+            return inputs.prNumber ? "comment" : "skip";
+    }
+}
+//# sourceMappingURL=mode.js.map

package/dist/mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.js","sourceRoot":"","sources":["../src/mode.ts"],"names":[],"mappings":"AA8BA,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAsB,CAAC;IAE1D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,iBAAiB,CAAC;IAChE,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,cAAc,CAAC;QACpB,KAAK,qBAAqB;YACxB,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3C,KAAK,mBAAmB;YACtB,OAAO,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C;YACE,yEAAyE;YACzE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/orchestrate.d.ts

@@ -0,0 +1,80 @@
+/**
+ * The parity pipeline: for each changed component, resolve its design reference
+ * (via the adapter the resolver picked), pair it with the candidate render, diff
+ * them, and aggregate into one report. The parity direction decides whether a
+ * failure blocks.
+ *
+ * Fail-soft (Principle: a broken adapter must not break the run): a per-component
+ * error is captured and surfaced, never thrown, and never escalates the overall
+ * status to `fail` — only real verdicts do.
+ */
+import type { AdapterContext, CandidateRender, Correspondence, DesignReference, DesignSource, Finding, ResolvedDirection, Verdict, VerdictStatus } from "@design-parity/core";
+import { type DiffConfig, type Triptych } from "@design-parity/diff";
+import type { AdapterRegistry } from "./registry.js";
+/** Supplies the candidate render for a component (compose-preview, or precomputed). */
+export type CandidateProvider = (componentId: string, ctx: AdapterContext) => Promise<CandidateRender | undefined> | CandidateRender | undefined;
+export interface OrchestrateOptions {
+    repoRoot: string;
+    env?: Record<string, string | undefined>;
+    registry: AdapterRegistry;
+    /** The (code → source/ref) links the resolver produced for the changed components. */
+    correspondences: Correspondence[];
+    candidate: CandidateProvider;
+    /**
+     * Renderer-native a11y/i18n findings for a component (issue #43). When this
+     * returns findings, they **supersede** design-parity's own `@design-parity/checks`
+     * for that component — injected as the diff's `checks` provider (the parity
+     * token/visual/semantic diff still runs). Used by the daemon candidate source,
+     * which ingests the renderer's own `a11y/atf` / `text/strings` / … products.
+     * Returning `undefined` keeps the default checks.
+     */
+    nativeChecks?: (componentId: string, ctx: AdapterContext) => Promise<Finding[] | undefined> | Finding[] | undefined;
+    /** Concrete direction (already resolved from `.design-parity.json`). */
+    direction: ResolvedDirection;
+    /** Where triptych PNGs are written (optional). */
+    outDir?: string;
+    diffConfig?: Partial<DiffConfig>;
+}
+export type ComponentStatus = "ok" | "skipped" | "error";
+export interface ComponentResult {
+    code: string;
+    source?: DesignSource;
+    status: ComponentStatus;
+    reference?: DesignReference;
+    /**
+     * The candidate render that was diffed, retained so a downstream consumer can
+     * act on the shipped pixels — notably Code-to-Canvas push-back (issue #9),
+     * which writes this image back to the design tool in `code-led` mode. Only
+     * present when a candidate was available (i.e. `status` is `ok`).
+     */
+    candidate?: CandidateRender;
+    verdict?: Verdict;
+    summary?: string;
+    triptychs?: Triptych[];
+    /** Path to the self-contained HTML comparison page, when `outDir` was set (#50). */
+    reportPath?: string;
+    /** Reason for `skipped` (no candidate) or `error` (adapter/diff failure). */
+    note?: string;
+}
+export interface ParityReport {
+    /** Worst verdict status across components (errors do not escalate this). */
+    status: VerdictStatus;
+    /** True only when the direction blocks PRs and at least one verdict failed. */
+    blocked: boolean;
+    direction: ResolvedDirection;
+    results: ComponentResult[];
+    /** Non-fatal issues: adapter errors, skipped components, resolver warnings. */
+    warnings: string[];
+    /**
+     * The committed CMP capability flag (Principle 6), threaded from
+     * `.design-parity.json` for the report layer. `false` ⇒ the repo is
+     * Android-only, so the comment carries a non-blocking "could run parity faster
+     * on Compose Multiplatform" suggestion; `true`/omitted ⇒ no promotion. Never
+     * affects {@link ParityReport.status} or {@link ParityReport.blocked} —
+     * advisory only.
+     */
+    cmpCapable?: boolean;
+}
+/** Run the full parity pipeline over the resolved components. */
+export declare function orchestrate(options: OrchestrateOptions): Promise<ParityReport>;
+//# sourceMappingURL=orchestrate.d.ts.map

package/dist/orchestrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../src/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,OAAO,EACP,aAAa,EACd,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,sFAAsF;IACtF,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CACb,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC;IAC5D,wEAAwE;IACxE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAClC;AAYD,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,MAAM,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAOD,iEAAiE;AACjE,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA6FvB"}

package/dist/orchestrate.js

@@ -0,0 +1,100 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { diff, } from "@design-parity/diff";
+import { directionPolicy } from "@design-parity/policy";
+import { renderHtmlReport } from "@design-parity/report-html";
+/** Wrap precomputed native findings as a {@link ChecksProvider} for the diff. */
+function nativeChecksProvider(findings) {
+    return { run: () => findings };
+}
+/** A filesystem-safe slug for a component id (`ui/Tile.kt#LightOn_Dark` → `ui-Tile-kt-LightOn_Dark`). */
+function sanitizeId(code) {
+    return code.replace(/[^a-z0-9_]+/gi, "-").replace(/^-+|-+$/g, "");
+}
+function worst(a, b) {
+    const rank = { pass: 0, warn: 1, fail: 2 };
+    return rank[a] >= rank[b] ? a : b;
+}
+/** Run the full parity pipeline over the resolved components. */
+export async function orchestrate(options) {
+    const ctx = { repoRoot: options.repoRoot, env: options.env ?? {} };
+    const results = [];
+    const warnings = [];
+    let status = "pass";
+    for (const corr of options.correspondences) {
+        const result = {
+            code: corr.code,
+            source: corr.source,
+            status: "ok",
+        };
+        try {
+            const adapter = options.registry[corr.source];
+            if (!adapter) {
+                result.status = "error";
+                result.note = `no adapter registered for source '${corr.source}'`;
+                warnings.push(`${corr.code}: ${result.note}`);
+                results.push(result);
+                continue;
+            }
+            const reference = await adapter.resolve(corr.code, corr.ref, ctx);
+            result.reference = reference;
+            const candidate = await options.candidate(corr.code, ctx);
+            if (!candidate) {
+                result.status = "skipped";
+                result.note = "no candidate render available";
+                warnings.push(`${corr.code}: ${result.note}`);
+                results.push(result);
+                continue;
+            }
+            // Retain the render so push-back (#9) can write the shipped pixels back.
+            result.candidate = candidate;
+            // Each component writes into its own subdir so triptychs (keyed only by
+            // image variant) and the HTML page don't collide across components (#49).
+            const componentOutDir = options.outDir
+                ? join(options.outDir, sanitizeId(corr.code))
+                : undefined;
+            // Renderer-native findings (daemon path) supersede the default checks
+            // for this component (issue #43); the parity diff itself is unchanged.
+            const native = await options.nativeChecks?.(corr.code, ctx);
+            const diffOptions = {
+                repoRoot: options.repoRoot,
+                ...(componentOutDir ? { outDir: componentOutDir } : {}),
+                ...(options.diffConfig ? { config: options.diffConfig } : {}),
+                ...(native ? { checks: nativeChecksProvider(native) } : {}),
+            };
+            const { verdict, summary, triptychs } = await diff(reference, candidate, diffOptions);
+            result.verdict = verdict;
+            result.summary = summary;
+            result.triptychs = triptychs;
+            // Emit the self-contained HTML comparison page alongside the triptychs,
+            // inlining each pair's diff heatmap when the engine produced one (#50).
+            if (componentOutDir) {
+                const diffImages = triptychs
+                    .filter((t) => t.diff !== undefined)
+                    .map((t) => ({ key: t.key, png: t.diff }));
+                const html = renderHtmlReport({
+                    reference,
+                    candidate,
+                    verdict,
+                    repoRoot: options.repoRoot,
+                    ...(diffImages.length > 0 ? { diffImages } : {}),
+                });
+                const reportPath = join(componentOutDir, "report.html");
+                await mkdir(componentOutDir, { recursive: true });
+                await writeFile(reportPath, html);
+                result.reportPath = reportPath;
+            }
+            status = worst(status, verdict.status);
+        }
+        catch (err) {
+            // Fail soft: surface, never throw, never escalate overall status.
+            result.status = "error";
+            result.note = err.message;
+            warnings.push(`${corr.code}: ${result.note}`);
+        }
+        results.push(result);
+    }
+    const blocked = directionPolicy(options.direction).blocksPr && status === "fail";
+    return { status, blocked, direction: options.direction, results, warnings };
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/orchestrate.js.map

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