@design-parity/action 0.1.0

package/dist/cli/action.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+/**
+ * GitHub Action entrypoint. Auto-selects its mode from the triggering event
+ * (issue #56), staying unattended throughout: zero human input, only committed
+ * deterministic artifacts, no model call (docs/PRINCIPLES.md).
+ *
+ * - **comment** (a `pull_request`): keep the changed-component components, run
+ *   the pipeline, and post/update the single verdict comment. Exits non-zero
+ *   only when the parity direction blocks (`design-led` + a failure).
+ * - **baseline** (a `push` to the `development-branch`): render the full mapped
+ *   surface and publish the browsable artifacts (`index.html` + per-component
+ *   `report.html` triptychs + `verdict.json`) to a permanent artifact branch,
+ *   force-updated each run. Requires a token with `contents: write`.
+ * - **skip**: nothing applies (e.g. a push to a non-dev branch).
+ *
+ * Reads the standard Action environment (`GITHUB_TOKEN`, `GITHUB_REPOSITORY`,
+ * `GITHUB_EVENT_PATH`, `GITHUB_WORKSPACE`, `GITHUB_EVENT_NAME`, `GITHUB_REF_NAME`,
+ * `GITHUB_SHA`). Candidate renders come from a committed/produced
+ * `CandidateRender[]` JSON (`INPUT_CANDIDATES`) and/or compose-preview bundles
+ * (`INPUT_CANDIDATE_BUNDLES`) — live rendering is the consumer's prior step.
+ */
+import { env, cwd, exit, stdout, stderr } from "node:process";
+import { readFile, mkdtemp } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { resolve as resolveCorrespondences } from "@design-parity/resolver";
+import { FigmaCanvasWriter } from "@design-parity/adapter-figma";
+import { buildCandidateProvider } from "../candidate.js";
+import { pushBack } from "../pushback.js";
+import { resolveRunConfig } from "../config.js";
+import { createAdapterRegistry } from "../registry.js";
+import { orchestrate } from "../orchestrate.js";
+import { renderReport, renderBootstrapNotice } from "../report.js";
+import { GitHubRest } from "../github/rest.js";
+import { postReport } from "../github/surface.js";
+import { componentsForChangedFiles } from "../github/changed-components.js";
+import { exitCode } from "../github/conclusion.js";
+import { publishBaseline } from "../github/publish.js";
+import { writeBaselineArtifacts } from "../baseline.js";
+import { selectMode } from "../mode.js";
+/** Whether an Action input string is set to a truthy opt-in value. */
+function isOptedIn(value) {
+    if (!value)
+        return false;
+    return ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
+}
+/**
+ * Build the Code-to-Canvas writer (issue #9) from the configured bridge
+ * endpoint. Returns `undefined` when no endpoint is set, so push-back no-ops
+ * with a clear log even when opted in — the Figma REST API can't write, so a
+ * bridge must be configured for the candidate to reach the canvas.
+ */
+function canvasWriter() {
+    const endpoint = env.INPUT_CANVAS_ENDPOINT ?? env.FIGMA_CANVAS_ENDPOINT;
+    if (!endpoint?.trim())
+        return undefined;
+    const token = env.INPUT_CANVAS_TOKEN ?? env.FIGMA_CANVAS_TOKEN ?? env.FIGMA_OAUTH_TOKEN;
+    return new FigmaCanvasWriter({ endpoint, ...(token ? { token } : {}) });
+}
+async function readPrNumber() {
+    const path = env.GITHUB_EVENT_PATH;
+    if (!path)
+        return undefined;
+    try {
+        const event = JSON.parse(await readFile(path, "utf8"));
+        return event.pull_request?.number ?? event.number;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Build the candidate provider from the committed JSON / bundle inputs. */
+async function candidateProvider(repoRoot, designMap) {
+    const candidatesPath = env.INPUT_CANDIDATES ?? env.DESIGN_PARITY_CANDIDATES;
+    const bundles = (env.INPUT_CANDIDATE_BUNDLES ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const opts = {
+        repoRoot,
+        bundlePaths: bundles,
+    };
+    if (designMap)
+        opts.designMap = designMap;
+    if (candidatesPath)
+        opts.candidatesPath = candidatesPath;
+    const { provider, warnings } = await buildCandidateProvider(opts);
+    return { provider: provider ?? (() => undefined), warnings };
+}
+/** comment mode: changed-component parity run + the single verdict comment. */
+async function runComment(ref, repoRoot, rest, prNumber) {
+    const { designMap, direction, cmpCapable, warnings } = await resolveRunConfig(repoRoot);
+    // No committed setup at all: don't guess the design ↔ code mapping at run time
+    // (Principle 1). Post a comment pointing at the interactive bootstrap (#11)
+    // instead of silently skipping, so the repo owner knows parity isn't wired up.
+    if (!designMap || designMap.components.length === 0) {
+        const outcome = await postReport(rest.commentClient(ref, prNumber), renderBootstrapNotice());
+        stdout.write(`design-parity: ${outcome} bootstrap notice — no committed design-map.json (run design-parity-bootstrap)\n`);
+        return 0;
+    }
+    const changedFiles = await rest.listPullRequestFiles(ref, prNumber);
+    const components = componentsForChangedFiles(designMap, changedFiles);
+    if (components.length === 0) {
+        stdout.write("design-parity: no design-mapped components changed — skipping (non-UI PR)\n");
+        return 0;
+    }
+    const resolved = resolveCorrespondences(components, designMap ? { designMap } : {});
+    const { provider, warnings: candidateWarnings } = await candidateProvider(repoRoot, designMap);
+    const report = await orchestrate({
+        repoRoot,
+        env,
+        registry: createAdapterRegistry(),
+        correspondences: resolved.correspondences,
+        candidate: provider,
+        direction,
+        ...(env.DESIGN_PARITY_OUT ? { outDir: env.DESIGN_PARITY_OUT } : {}),
+    });
+    report.warnings.unshift(...warnings, ...resolved.warnings, ...candidateWarnings, ...resolved.unresolved.map((u) => `unresolved (no source matched): ${u}`));
+    // Promote CMP to Android-only repos in the comment (Principle 6); advisory.
+    if (typeof cmpCapable === "boolean")
+        report.cmpCapable = cmpCapable;
+    const outcome = await postReport(rest.commentClient(ref, prNumber), renderReport(report));
+    stdout.write(`design-parity: ${outcome} report — status=${report.status} blocked=${report.blocked}\n`);
+    // Optional Code-to-Canvas push-back (#9): gated on the opt-in flag + a
+    // `code-led` direction + a `figma` source, and a no-op (with a log) otherwise.
+    // A side effect only — it never changes the PR verdict / exit code.
+    const writer = canvasWriter();
+    await pushBack({
+        report,
+        enabled: isOptedIn(env.INPUT_PUSH_BACK ?? env.DESIGN_PARITY_PUSH_BACK),
+        ...(writer ? { writer } : {}),
+        ctx: { repoRoot, env },
+        log: (m) => stdout.write(m + "\n"),
+    });
+    return exitCode(report);
+}
+/** baseline mode: full-surface parity run published to the artifact branch. */
+async function runBaseline(ref, repoRoot, token, artifactBranch) {
+    const { designMap, direction, warnings } = await resolveRunConfig(repoRoot);
+    const components = designMap?.components.map((c) => c.code) ?? [];
+    if (components.length === 0) {
+        stdout.write("design-parity: no components in design-map.json — nothing to baseline\n");
+        return 0;
+    }
+    const resolved = resolveCorrespondences(components, designMap ? { designMap } : {});
+    const { provider, warnings: candidateWarnings } = await candidateProvider(repoRoot, designMap);
+    const outDir = await mkdtemp(join(tmpdir(), "design-parity-baseline-"));
+    const report = await orchestrate({
+        repoRoot,
+        env,
+        registry: createAdapterRegistry(),
+        correspondences: resolved.correspondences,
+        candidate: provider,
+        direction,
+        outDir,
+    });
+    report.warnings.unshift(...warnings, ...resolved.warnings, ...candidateWarnings, ...resolved.unresolved.map((u) => `unresolved (no source matched): ${u}`));
+    const commit = env.GITHUB_SHA;
+    const { summary } = await writeBaselineArtifacts(outDir, report, {
+        ...(commit ? { commit } : {}),
+    });
+    const result = await publishBaseline({
+        sourceDir: outDir,
+        branch: artifactBranch,
+        repo: `${ref.owner}/${ref.repo}`,
+        token,
+        message: `design-parity: baseline ${summary.status}${commit ? ` @ ${commit.slice(0, 12)}` : ""}`,
+        skipIfUnchanged: true,
+        ...(env.GITHUB_SERVER_URL ? { serverUrl: env.GITHUB_SERVER_URL } : {}),
+    });
+    stdout.write(result.pushed
+        ? `design-parity: published baseline to ${result.branch} (${result.sha?.slice(0, 12)}) — status=${summary.status}\n`
+        : `design-parity: baseline unchanged vs ${result.branch} — nothing to publish\n`);
+    // Baseline mode never blocks the dev-branch push; it only publishes.
+    return 0;
+}
+async function main() {
+    const token = env.GITHUB_TOKEN ?? env.INPUT_GITHUB_TOKEN;
+    const repository = env.GITHUB_REPOSITORY;
+    if (!token || !repository) {
+        stderr.write("design-parity: GITHUB_TOKEN and GITHUB_REPOSITORY are required\n");
+        return 2;
+    }
+    const [owner, repo] = repository.split("/");
+    if (!owner || !repo) {
+        stderr.write(`design-parity: bad GITHUB_REPOSITORY '${repository}'\n`);
+        return 2;
+    }
+    const ref = { owner, repo };
+    const repoRoot = env.GITHUB_WORKSPACE ?? cwd();
+    const developmentBranch = env.INPUT_DEVELOPMENT_BRANCH?.trim() || "main";
+    const artifactBranch = env.INPUT_ARTIFACT_BRANCH?.trim() || `design-parity/${developmentBranch}`;
+    const prNumber = await readPrNumber();
+    const mode = selectMode({
+        eventName: env.GITHUB_EVENT_NAME,
+        refName: env.GITHUB_REF_NAME,
+        developmentBranch,
+        ...(env.INPUT_MODE ? { override: env.INPUT_MODE } : {}),
+        ...(prNumber ? { prNumber } : {}),
+    });
+    switch (mode) {
+        case "baseline":
+            stdout.write(`design-parity: baseline mode → ${artifactBranch}\n`);
+            return runBaseline(ref, repoRoot, token, artifactBranch);
+        case "comment": {
+            if (!prNumber) {
+                stdout.write("design-parity: comment mode but no pull_request in context — nothing to do\n");
+                return 0;
+            }
+            const rest = new GitHubRest({
+                token,
+                ...(env.GITHUB_API_URL ? { baseUrl: env.GITHUB_API_URL } : {}),
+            });
+            return runComment(ref, repoRoot, rest, prNumber);
+        }
+        default:
+            stdout.write(`design-parity: nothing to do for event='${env.GITHUB_EVENT_NAME}' ref='${env.GITHUB_REF_NAME}' (not the development branch '${developmentBranch}')\n`);
+            return 0;
+    }
+}
+exit(await main());
+//# sourceMappingURL=action.js.map

package/dist/cli/action.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":""}

package/dist/cli/run.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+/**
+ * `design-parity run` — a local parity run.
+ *
+ *   design-parity run --repo . --components ui/Button.kt#PrimaryButton \
+ *     --candidates candidates.json --out .design-parity/out
+ *
+ * Reads the committed `design-map.json` + `.design-parity.json`, resolves each
+ * changed component to a design reference, diffs it against the candidate
+ * render, and prints the markdown report. Exits non-zero only when the parity
+ * direction blocks (`design-led` + a failure).
+ *
+ * Candidate renders come from committed, offline inputs (reproducible — no live
+ * render at run time): `--candidates <file>` (a precomputed `CandidateRender[]`)
+ * and/or `--candidate-bundles <png|dir,...>` (compose-ai-tools preview-bundle
+ * polyglots, read statically by `@design-parity/candidate`; issue #38 Phase 1).
+ * When both are given, bundles win and the JSON is the fallback.
+ */
+import { argv, cwd, env, exit, stdout } from "node:process";
+import { resolve as resolvePath } from "node:path";
+import { resolve as resolveCorrespondences } from "@design-parity/resolver";
+import { FigmaCanvasWriter } from "@design-parity/adapter-figma";
+import { buildCandidateProvider } from "../candidate.js";
+import { resolveRunConfig } from "../config.js";
+import { createAdapterRegistry } from "../registry.js";
+import { orchestrate } from "../orchestrate.js";
+import { pushBack } from "../pushback.js";
+import { renderReport } from "../report.js";
+function parseArgs(args) {
+    const out = { repoRoot: cwd(), components: [], bundlePaths: [], pushBack: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        const next = () => args[(i += 1)];
+        switch (a) {
+            case "run":
+                break;
+            case "--repo":
+                out.repoRoot = resolvePath(next() ?? ".");
+                break;
+            case "--components":
+                out.components.push(...(next() ?? "").split(",").filter(Boolean));
+                break;
+            case "--candidates":
+                out.candidatesPath = next();
+                break;
+            case "--candidate-bundles":
+                out.bundlePaths.push(...(next() ?? "").split(",").filter(Boolean));
+                break;
+            case "--out":
+                out.outDir = next();
+                break;
+            case "--push-back":
+                out.pushBack = true;
+                break;
+            case "--canvas-endpoint":
+                out.canvasEndpoint = next();
+                break;
+            default:
+                if (a && !a.startsWith("--"))
+                    out.components.push(a);
+        }
+    }
+    return out;
+}
+async function main() {
+    const args = parseArgs(argv.slice(2));
+    if (args.components.length === 0) {
+        stdout.write("design-parity run --components <code#Member,...> [--repo .] " +
+            "[--candidates file.json] [--candidate-bundles <png|dir,...>] [--out dir] " +
+            "[--push-back [--canvas-endpoint <url>]]\n");
+        return 2;
+    }
+    const { designMap, direction, cmpCapable, warnings } = await resolveRunConfig(args.repoRoot);
+    const resolved = resolveCorrespondences(args.components, { designMap });
+    const candidateOpts = {
+        repoRoot: args.repoRoot,
+        bundlePaths: args.bundlePaths,
+    };
+    if (designMap)
+        candidateOpts.designMap = designMap;
+    if (args.candidatesPath)
+        candidateOpts.candidatesPath = args.candidatesPath;
+    const { provider, warnings: candidateWarnings } = await buildCandidateProvider(candidateOpts);
+    const report = await orchestrate({
+        repoRoot: args.repoRoot,
+        env,
+        registry: createAdapterRegistry(),
+        correspondences: resolved.correspondences,
+        candidate: provider ?? (() => undefined),
+        direction,
+        ...(args.outDir ? { outDir: args.outDir } : {}),
+    });
+    report.warnings.unshift(...warnings, ...resolved.warnings, ...candidateWarnings, ...resolved.unresolved.map((u) => `unresolved (no source matched): ${u}`));
+    // Promote CMP in the comment for Android-only repos (Principle 6). Read from
+    // the committed config (set false by bootstrap on a non-CMP repo); advisory
+    // only, so it never touches the verdict or exit code.
+    if (typeof cmpCapable === "boolean")
+        report.cmpCapable = cmpCapable;
+    stdout.write(renderReport(report) + "\n");
+    // Optional Code-to-Canvas push-back (#9): no-op (with a log) unless the
+    // `--push-back` flag is set, the direction is `code-led`, and a figma bridge
+    // endpoint is configured. A side effect only — it never affects the exit code.
+    const endpoint = args.canvasEndpoint ?? env.FIGMA_CANVAS_ENDPOINT;
+    await pushBack({
+        report,
+        enabled: args.pushBack,
+        ...(endpoint ? { writer: new FigmaCanvasWriter({ endpoint }) } : {}),
+        ctx: { repoRoot: args.repoRoot, env },
+        log: (m) => stdout.write(m + "\n"),
+    });
+    // Point at the self-contained HTML comparison pages, when written (#50).
+    const pages = report.results
+        .map((r) => r.reportPath)
+        .filter((p) => p !== undefined);
+    if (pages.length > 0) {
+        stdout.write(`\nWrote ${pages.length} comparison page(s):\n` +
+            pages.map((p) => `  ${p}`).join("\n") +
+            "\n");
+    }
+    return report.blocked ? 1 : 0;
+}
+exit(await main());
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+import { type DesignMap, type ResolvedDirection } from "@design-parity/core";
+export interface RunConfig {
+    designMap?: DesignMap;
+    direction: ResolvedDirection;
+    /**
+     * The committed CMP capability flag (Principle 6), read verbatim from
+     * `.design-parity.json` — *not* re-derived here (Principle 1). `false` lets
+     * the run promote CMP in the PR comment; `true`/omitted stays silent. See
+     * {@link ParityConfig.cmpCapable}.
+     */
+    cmpCapable?: boolean;
+    warnings: string[];
+}
+/**
+ * Read `design-map.json` and `.design-parity.json` from `repoRoot`.
+ *
+ * A concrete `direction` is used verbatim. `auto` means setup never ran to
+ * materialize it (Principle 5), so we fall back to `code-led` (advisory) and
+ * warn — the steady-state Action never re-derives direction from a maturity
+ * scan; that's setup's job.
+ */
+export declare function resolveRunConfig(repoRoot: string): Promise<RunConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA+B3E"}

package/dist/config.js

@@ -0,0 +1,46 @@
+/**
+ * Resolve the committed configuration a parity run reads from a repo: the
+ * `design-map.json` correspondence manifest and the `.design-parity.json` parity
+ * direction. Everything here is committed and read deterministically — no model,
+ * no network (Principle 1).
+ */
+import { join } from "node:path";
+import { loadDesignMap, } from "@design-parity/core";
+import { loadParityConfigOrDefault, PARITY_CONFIG_FILENAME, } from "@design-parity/policy";
+/**
+ * Read `design-map.json` and `.design-parity.json` from `repoRoot`.
+ *
+ * A concrete `direction` is used verbatim. `auto` means setup never ran to
+ * materialize it (Principle 5), so we fall back to `code-led` (advisory) and
+ * warn — the steady-state Action never re-derives direction from a maturity
+ * scan; that's setup's job.
+ */
+export async function resolveRunConfig(repoRoot) {
+    const warnings = [];
+    let designMap;
+    try {
+        designMap = await loadDesignMap(join(repoRoot, "design-map.json"));
+    }
+    catch (err) {
+        // A missing design-map is fine (Code Connect / convention may still resolve);
+        // an invalid one is worth surfacing.
+        const message = err.message;
+        if (!/cannot read/.test(message))
+            warnings.push(message);
+    }
+    const config = await loadParityConfigOrDefault(join(repoRoot, PARITY_CONFIG_FILENAME));
+    let direction;
+    if (config.direction === "auto") {
+        direction = "code-led";
+        warnings.push(`parity direction is 'auto' (no ${PARITY_CONFIG_FILENAME} from setup); defaulting to code-led (advisory). Run the bootstrap to materialize a concrete direction.`);
+    }
+    else {
+        direction = config.direction;
+    }
+    const runConfig = { designMap, direction, warnings };
+    // Carry the committed CMP flag through verbatim (only when setup recorded it).
+    if (typeof config.cmpCapable === "boolean")
+        runConfig.cmpCapable = config.cmpCapable;
+    return runConfig;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,aAAa,GAGd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAe/B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,SAAgC,CAAC;IACrC,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8EAA8E;QAC9E,qCAAqC;QACrC,MAAM,OAAO,GAAI,GAAa,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAC5C,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CACvC,CAAC;IACF,IAAI,SAA4B,CAAC;IACjC,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAChC,SAAS,GAAG,UAAU,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,kCAAkC,sBAAsB,yGAAyG,CAClK,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,MAAM,SAAS,GAAc,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IAChE,+EAA+E;IAC/E,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,SAAS;QACxC,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/github/changed-components.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Decide which components a PR touched: the `design-map.json` entries whose code
+ * file is among the PR's changed files. Deterministic — the Action never guesses
+ * components from a model (Principle 1). A PR that changes no mapped component is
+ * "non-UI" and gets skipped.
+ */
+import type { DesignMap } from "@design-parity/core";
+/** The file part of a code handle: `"ui/Button.kt#PrimaryButton"` → `"ui/Button.kt"`. */
+export declare function filePathOf(code: string): string;
+/**
+ * Code handles from `design-map.json` whose file was changed in this PR. Paths
+ * are compared after stripping a leading `./`, so either form matches.
+ */
+export declare function componentsForChangedFiles(designMap: DesignMap | undefined, changedFiles: string[]): string[];
+//# sourceMappingURL=changed-components.d.ts.map

package/dist/github/changed-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-components.d.ts","sourceRoot":"","sources":["../../src/github/changed-components.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,EAAE,CAMV"}

package/dist/github/changed-components.js

@@ -0,0 +1,18 @@
+/** The file part of a code handle: `"ui/Button.kt#PrimaryButton"` → `"ui/Button.kt"`. */
+export function filePathOf(code) {
+    const hash = code.indexOf("#");
+    return hash === -1 ? code : code.slice(0, hash);
+}
+/**
+ * Code handles from `design-map.json` whose file was changed in this PR. Paths
+ * are compared after stripping a leading `./`, so either form matches.
+ */
+export function componentsForChangedFiles(designMap, changedFiles) {
+    if (!designMap)
+        return [];
+    const changed = new Set(changedFiles.map((f) => f.replace(/^\.\//, "")));
+    return designMap.components
+        .filter((c) => changed.has(filePathOf(c.code).replace(/^\.\//, "")))
+        .map((c) => c.code);
+}
+//# sourceMappingURL=changed-components.js.map

package/dist/github/changed-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-components.js","sourceRoot":"","sources":["../../src/github/changed-components.ts"],"names":[],"mappings":"AAQA,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAgC,EAChC,YAAsB;IAEtB,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,SAAS,CAAC,UAAU;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;SACnE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/github/conclusion.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Map a {@link ParityReport} to a GitHub check conclusion and a process exit
+ * code. Blocking is owned by the parity direction (`design-led` blocks; `code-led`
+ * is advisory) — the surface only translates it.
+ */
+import type { ParityReport } from "../orchestrate.js";
+export type CheckConclusion = "success" | "failure" | "neutral";
+/**
+ * - `blocked` (design-led + a failure) → `failure` (red check, exit 1).
+ * - any other failure/warn (advisory) → `neutral` (visible, non-blocking).
+ * - clean pass → `success`.
+ */
+export declare function checkConclusion(report: ParityReport): CheckConclusion;
+/** Exit code for the Action step: non-zero only when blocking. */
+export declare function exitCode(report: ParityReport): number;
+//# sourceMappingURL=conclusion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conclusion.d.ts","sourceRoot":"","sources":["../../src/github/conclusion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAIrE;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAErD"}

package/dist/github/conclusion.js

@@ -0,0 +1,17 @@
+/**
+ * - `blocked` (design-led + a failure) → `failure` (red check, exit 1).
+ * - any other failure/warn (advisory) → `neutral` (visible, non-blocking).
+ * - clean pass → `success`.
+ */
+export function checkConclusion(report) {
+    if (report.blocked)
+        return "failure";
+    if (report.status === "pass")
+        return "success";
+    return "neutral";
+}
+/** Exit code for the Action step: non-zero only when blocking. */
+export function exitCode(report) {
+    return report.blocked ? 1 : 0;
+}
+//# sourceMappingURL=conclusion.js.map

package/dist/github/conclusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conclusion.js","sourceRoot":"","sources":["../../src/github/conclusion.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,MAAoB;IAC3C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/github/publish.d.ts

@@ -0,0 +1,50 @@
+export interface GitResult {
+    stdout: string;
+    stderr: string;
+    /** Process exit code; non-zero is expected (and handled) for some commands. */
+    code: number;
+}
+/** Runs one `git` invocation. Injectable so tests can script the sequence. */
+export type GitRunner = (args: string[], opts: {
+    cwd: string;
+}) => Promise<GitResult>;
+/** Default runner: shells out to the system `git` in `cwd`. */
+export declare const execGit: GitRunner;
+export interface PublishOptions {
+    /** Directory whose current contents become the published tree. */
+    sourceDir: string;
+    /** Destination branch on the remote (force-updated / re-parented each run). */
+    branch: string;
+    /** `owner/repo`. */
+    repo: string;
+    /** Token with `contents: write`. */
+    token: string;
+    /** Commit message. */
+    message: string;
+    /** When the tree matches the branch tip, skip the push (no empty commits). */
+    skipIfUnchanged?: boolean;
+    /** Commit identity (defaults to the GitHub Actions bot). */
+    authorName?: string;
+    authorEmail?: string;
+    /** Remote host, e.g. `https://github.com` or a GHES server URL. */
+    serverUrl?: string;
+    /** Push-race retry budget. Default 5. */
+    maxAttempts?: number;
+    /** Injected git runner (tests); defaults to {@link execGit}. */
+    git?: GitRunner;
+    /** Backoff sleeper (tests); defaults to a real `setTimeout`. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface PublishResult {
+    branch: string;
+    /** False when `skipIfUnchanged` short-circuited an unchanged tree. */
+    pushed: boolean;
+    /** The pushed commit SHA (absent when nothing was pushed). */
+    sha?: string;
+}
+/**
+ * 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 declare function publishBaseline(options: PublishOptions): Promise<PublishResult>;
+//# sourceMappingURL=publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/github/publish.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAClB,OAAO,CAAC,SAAS,CAAC,CAAC;AAExB,+DAA+D;AAC/D,eAAO,MAAM,OAAO,EAAE,SAWrB,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAaD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA+DxB"}