@design-parity/baseline 0.1.0

package/README.md

@@ -0,0 +1,60 @@
+# @design-parity/baseline
+
+Detect a repo's design-system maturity and, for a repo with no design system,
+bootstrap an opinionated **committed** baseline. This is the one place AI
+generates artifacts (see [docs/PRINCIPLES.md](../../docs/PRINCIPLES.md),
+Principles 1, 3, 4, 5); the steady-state Action only runs what this writes.
+
+## Maturity rungs
+
+`detectMaturity(repoRoot)` classifies a repo by scanning committed files,
+returning core's `MaturityRung`:
+
+1. **`machine-link`** — Figma Code Connect (`figma.config.json` or
+   `*.figma.{tsx,kt,swift,…}`). → direction `design-led`.
+2. **`manifest`** — a `design-map.json` or a design-token source
+   (`*.tokens.json`, a `tokens/` tree, Style Dictionary). → `code-led`.
+3. **`bootstrap`** — neither. → `code-led`, and **bootstrap**.
+
+Direction resolution is delegated to `@design-parity/policy` so setup and the
+Action's late fallback agree.
+
+## Bootstrap (`bootstrap` rung)
+
+`planBootstrap` decides what to write; `applyBootstrap` writes it. Every rung
+gets a concrete parity direction in policy's committed `.design-parity.json` —
+`auto` is never left behind. The `bootstrap` rung additionally gets:
+
+- `design-tokens.json` — Material 3 + WCAG AA + i18n-ready token baseline,
+- `design-parity.checks.json` — `@design-parity/checks`'s `ChecksConfig`
+  (WCAG AA, hardcoded-string lint on),
+- `design-map.json` — a schema-valid starter scaffold. Components discovered by
+  name convention are surfaced as **low-confidence review items** to wire to a
+  design source later.
+
+## Compose Multiplatform (Principle 6)
+
+`detectMaturity` also reports whether a repo is **Compose Multiplatform (CMP)
+capable** — `cmpCapable: boolean` plus an evidence trail (`cmp.signals`) from a
+bounded scan of Gradle build files (`build.gradle{,.kts}`, `settings.gradle*`,
+`libs.versions.toml`). This is **orthogonal to the maturity rung**: a repo at any
+rung may or may not be CMP-capable.
+
+When a repo is **not** CMP-capable, `cmpSuggestion()` returns a non-blocking
+advisory ("Compose Multiplatform would render candidates on the JVM/desktop with
+no emulator — consider it"), surfaced via `plan.cmpSuggestion` and the CLI.
+**Never a gate** — plain Jetpack Compose stays fully supported.
+
+The live CMP render path (preferring `compose-preview`'s desktop/JVM render in
+`@design-parity/candidate` when capable, plus a Compose-for-Web/wasm spike) is
+deferred — it needs the JVM/Compose toolchain. See [docs/cmp.md](./docs/cmp.md).
+
+## CLI
+
+```sh
+design-parity-bootstrap [--dir <path>] [--direction design-led|code-led] [--yes] [--force]
+```
+
+Interactive setup, run once locally; commit the artifacts it writes. It refuses
+to run in CI — the GitHub Action enforces committed artifacts, it never
+bootstraps.

package/dist/artifacts.d.ts

@@ -0,0 +1,9 @@
+/** Parity policy (`ParityConfig`) — written for every rung. Owned by `policy`. */
+export declare const CONFIG_FILE = ".design-parity.json";
+/** Opinionated `DesignTokens` baseline — bootstrap rung only. */
+export declare const TOKENS_FILE = "design-tokens.json";
+/** Starter `ChecksConfig` for `@design-parity/checks` — bootstrap rung only. */
+export declare const CHECKS_FILE = "design-parity.checks.json";
+/** Starter manifest correspondence — bootstrap rung only. */
+export declare const DESIGN_MAP_FILE = "design-map.json";
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAOA,kFAAkF;AAClF,eAAO,MAAM,WAAW,wBAAyB,CAAC;AAElD,iEAAiE;AACjE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,gFAAgF;AAChF,eAAO,MAAM,WAAW,8BAA8B,CAAC;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,eAAe,oBAAoB,CAAC"}

package/dist/artifacts.js

@@ -0,0 +1,15 @@
+/**
+ * Filenames of the committed artifacts setup/bootstrap writes. Centralized so
+ * detection can ignore files this package itself produces (see {@link
+ * detectMaturity}) and the CLI and tests agree on paths.
+ */
+import { PARITY_CONFIG_FILENAME } from "@design-parity/policy";
+/** Parity policy (`ParityConfig`) — written for every rung. Owned by `policy`. */
+export const CONFIG_FILE = PARITY_CONFIG_FILENAME;
+/** Opinionated `DesignTokens` baseline — bootstrap rung only. */
+export const TOKENS_FILE = "design-tokens.json";
+/** Starter `ChecksConfig` for `@design-parity/checks` — bootstrap rung only. */
+export const CHECKS_FILE = "design-parity.checks.json";
+/** Starter manifest correspondence — bootstrap rung only. */
+export const DESIGN_MAP_FILE = "design-map.json";
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAElD,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEvD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,59 @@
+import type { ResolvedDirection } from "@design-parity/core";
+import type { MaturityResult } from "./detect.js";
+import type { DiscoveredComponent } from "./seed.js";
+/** One file the plan would write. */
+export interface PlannedArtifact {
+    /** Repo-relative path. */
+    path: string;
+    /** One-line human description for the CLI summary. */
+    description: string;
+    /** Serialized contents (pretty JSON, trailing newline). */
+    contents: string;
+    /** True if a file already exists at `path` (apply skips it unless forced). */
+    exists: boolean;
+}
+export interface BootstrapPlan {
+    repoRoot: string;
+    maturity: MaturityResult;
+    /** Concrete direction materialized into the config — never `auto`. */
+    direction: ResolvedDirection;
+    /** Convention-discovered components to wire to a design source (rung 3). */
+    review: DiscoveredComponent[];
+    artifacts: PlannedArtifact[];
+    /**
+     * Non-blocking Compose Multiplatform promotion (Principle 6). Present only
+     * when the repo is *not* CMP-capable; `undefined` when it already is. Advisory
+     * surface text — never a gate, never an artifact.
+     */
+    cmpSuggestion?: string;
+}
+export interface PlanOptions {
+    /** Override the materialized direction (e.g. the user picked design-led). */
+    direction?: ResolvedDirection;
+    /** Inject a maturity result instead of scanning (testing / re-runs). */
+    maturity?: MaturityResult;
+}
+/**
+ * Decide which committed artifacts a repo needs. Every rung gets a concrete
+ * parity direction; only rung 3 (no design system) is bootstrapped with a token
+ * baseline, a starter design-map, and a check config.
+ *
+ * @throws if the seeded design-map fails its own schema (a build-time bug).
+ */
+export declare function planBootstrap(repoRoot: string, opts?: PlanOptions): Promise<BootstrapPlan>;
+export interface ApplyOptions {
+    /** Overwrite artifacts that already exist. Default: skip them. */
+    force?: boolean;
+}
+export interface ApplyResult {
+    /** Repo-relative paths written. */
+    written: string[];
+    /** Repo-relative paths skipped because they already existed. */
+    skipped: string[];
+}
+/**
+ * Write a plan's artifacts to disk. Existing files are left untouched unless
+ * `force` is set, so a re-run never clobbers a human's edits by surprise.
+ */
+export declare function applyBootstrap(plan: BootstrapPlan, opts?: ApplyOptions): Promise<ApplyResult>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAW7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrD,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,SAAS,EAAE,iBAAiB,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAaD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,aAAa,CAAC,CAiDxB;AAED,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,WAAW,CAAC,CActB"}

package/dist/bootstrap.js

@@ -0,0 +1,94 @@
+/**
+ * Bootstrap orchestration — the one place AI generates committed artifacts
+ * (Principles 1, 3). `planBootstrap` is pure: it decides *what* to write from
+ * the detected maturity rung. `applyBootstrap` writes the plan to disk. Keeping
+ * the two apart makes the plan reviewable, testable, and re-runnable, and keeps
+ * generation off the unattended Action path entirely.
+ */
+import { access, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { validateDesignMap } from "@design-parity/core";
+import { CHECKS_FILE, CONFIG_FILE, DESIGN_MAP_FILE, TOKENS_FILE, } from "./artifacts.js";
+import { defaultCheckConfig } from "./checks.js";
+import { cmpSuggestion } from "./cmp.js";
+import { detectMaturity } from "./detect.js";
+import { directionForRung } from "./direction.js";
+import { discoverCodeComponents, seedDesignMap } from "./seed.js";
+import { materialBaselineTokens } from "./tokens.js";
+const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Decide which committed artifacts a repo needs. Every rung gets a concrete
+ * parity direction; only rung 3 (no design system) is bootstrapped with a token
+ * baseline, a starter design-map, and a check config.
+ *
+ * @throws if the seeded design-map fails its own schema (a build-time bug).
+ */
+export async function planBootstrap(repoRoot, opts = {}) {
+    const maturity = opts.maturity ?? (await detectMaturity(repoRoot));
+    const direction = opts.direction ?? directionForRung(maturity.rung);
+    const artifacts = [];
+    const add = async (path, description, value) => {
+        artifacts.push({
+            path,
+            description,
+            contents: json(value),
+            exists: await fileExists(join(repoRoot, path)),
+        });
+    };
+    // Every rung: materialize a concrete direction (Principle 5) and record the
+    // CMP capability so the unattended Action can promote CMP without re-scanning
+    // (Principles 1, 6) — the one CMP decision, committed once instead of re-made
+    // per PR run.
+    await add(CONFIG_FILE, `parity direction (${direction})`, {
+        direction,
+        cmpCapable: maturity.cmpCapable,
+    });
+    let review = [];
+    if (maturity.rung === "bootstrap") {
+        review = await discoverCodeComponents(repoRoot);
+        const designMap = seedDesignMap();
+        const check = validateDesignMap(designMap);
+        if (!check.valid) {
+            // The seeded map is hand-built; an invalid one is a bug in this package.
+            throw new Error(`seeded design-map failed schema validation: ${check.errors.join("; ")}`);
+        }
+        await add(TOKENS_FILE, "Material 3 + WCAG AA token baseline", materialBaselineTokens());
+        await add(CHECKS_FILE, "a11y + i18n checks config", defaultCheckConfig());
+        await add(DESIGN_MAP_FILE, "starter design-map (empty scaffold)", designMap);
+    }
+    return {
+        repoRoot,
+        maturity,
+        direction,
+        review,
+        artifacts,
+        cmpSuggestion: cmpSuggestion(maturity.cmp),
+    };
+}
+/**
+ * Write a plan's artifacts to disk. Existing files are left untouched unless
+ * `force` is set, so a re-run never clobbers a human's edits by surprise.
+ */
+export async function applyBootstrap(plan, opts = {}) {
+    const written = [];
+    const skipped = [];
+    for (const artifact of plan.artifacts) {
+        if (artifact.exists && !opts.force) {
+            skipped.push(artifact.path);
+            continue;
+        }
+        await writeFile(join(plan.repoRoot, artifact.path), artifact.contents, "utf8");
+        written.push(artifact.path);
+    }
+    return { written, skipped };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAqCrD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAE/E,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,OAAoB,EAAE;IAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,KAAK,EAAE,IAAY,EAAE,WAAmB,EAAE,KAAc,EAAE,EAAE;QACtE,SAAS,CAAC,IAAI,CAAC;YACb,IAAI;YACJ,WAAW;YACX,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC;YACrB,MAAM,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,4EAA4E;IAC5E,8EAA8E;IAC9E,8EAA8E;IAC9E,cAAc;IACd,MAAM,GAAG,CAAC,WAAW,EAAE,qBAAqB,SAAS,GAAG,EAAE;QACxD,SAAS;QACT,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC,CAAC;IAEH,IAAI,MAAM,GAA0B,EAAE,CAAC;IACvC,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,yEAAyE;YACzE,MAAM,IAAI,KAAK,CACb,+CAA+C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,CAAC,WAAW,EAAE,qCAAqC,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACxF,MAAM,GAAG,CAAC,WAAW,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC1E,MAAM,GAAG,CAAC,eAAe,EAAE,qCAAqC,EAAE,SAAS,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,SAAS;QACT,MAAM;QACN,SAAS;QACT,aAAa,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,CAAC;KAC3C,CAAC;AACJ,CAAC;AAcD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAmB,EACnB,OAAqB,EAAE;IAEvB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/checks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The starter check config for a bootstrapped repo.
+ *
+ * This is the committed input `@design-parity/checks` consumes — its
+ * {@link ChecksConfig}, not a parallel shape — so bootstrap emits exactly what
+ * the steady-state checks read (Principles 1, 2). The defaults are opinionated
+ * for a freshly bootstrapped repo: target WCAG AA contrast, and turn on the
+ * hardcoded-string lint so i18n drift surfaces from day one.
+ */
+import type { ChecksConfig } from "@design-parity/checks";
+/** The opinionated default {@link ChecksConfig} for a bootstrapped repo. */
+export declare function defaultCheckConfig(): ChecksConfig;
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,YAAY,CAKjD"}

package/dist/checks.js

@@ -0,0 +1,8 @@
+/** The opinionated default {@link ChecksConfig} for a bootstrapped repo. */
+export function defaultCheckConfig() {
+    return {
+        contrastLevel: "AA",
+        flagHardcodedStrings: true,
+    };
+}
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAWA,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,oBAAoB,EAAE,IAAI;KAC3B,CAAC;AACJ,CAAC"}

package/dist/cli/bootstrap.d.ts

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

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

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

package/dist/cli/bootstrap.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * CLI: detect maturity and bootstrap a committed baseline — interactively.
+ *
+ *   design-parity-bootstrap [--dir <path>] [--yes] [--force]
+ *                           [--direction design-led|code-led]
+ *
+ * This is the interactive setup step (Principle 4). It refuses to run on the
+ * unattended Action path: the Action enforces committed artifacts, it never
+ * generates them (Principle 1) — it points the user here instead.
+ */
+import { argv, env, exit, stdin, stdout } from "node:process";
+import { createInterface } from "node:readline/promises";
+import { applyBootstrap, planBootstrap, } from "../bootstrap.js";
+function parseArgs(args) {
+    const out = { dir: ".", yes: false, force: false, help: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        switch (a) {
+            case "--yes":
+            case "-y":
+                out.yes = true;
+                break;
+            case "--force":
+                out.force = true;
+                break;
+            case "--help":
+            case "-h":
+                out.help = true;
+                break;
+            case "--dir":
+                out.dir = args[++i] ?? ".";
+                break;
+            case "--direction": {
+                const v = args[++i];
+                if (v !== "design-led" && v !== "code-led") {
+                    throw new Error(`--direction must be design-led or code-led, got '${v}'`);
+                }
+                out.direction = v;
+                break;
+            }
+            default:
+                throw new Error(`unknown argument '${a}'`);
+        }
+    }
+    return out;
+}
+const HELP = `design-parity-bootstrap — detect maturity and bootstrap a committed baseline
+
+Usage:
+  design-parity-bootstrap [options]
+
+Options:
+  --dir <path>        Repo root to bootstrap (default: current directory)
+  --direction <d>     Force parity direction: design-led | code-led
+  --yes, -y           Don't prompt; write the plan as-is
+  --force             Overwrite artifacts that already exist
+  --help, -h          Show this help
+
+Interactive setup only. Run this once, locally; commit the artifacts it writes.
+The GitHub Action runs those committed artifacts and never bootstraps.`;
+function printPlan(plan) {
+    const { maturity } = plan;
+    console.log(`Detected maturity: ${maturity.rung} — ${maturity.label}`);
+    if (maturity.signals.length > 0) {
+        console.log("Evidence:");
+        for (const s of maturity.signals)
+            console.log(`  • ${s.kind}: ${s.path}`);
+    }
+    console.log(`\nParity direction: ${plan.direction}`);
+    // Principle 6: prefer/promote Compose Multiplatform — advisory, never a gate.
+    if (maturity.cmpCapable) {
+        console.log("\nCompose Multiplatform: capable (candidates can render on the JVM/desktop — no emulator).");
+        for (const s of maturity.cmp.signals) {
+            console.log(`  • ${s.kind}: ${s.path} (${s.match})`);
+        }
+    }
+    else if (plan.cmpSuggestion) {
+        console.log(`\nCompose Multiplatform suggestion:\n  ${plan.cmpSuggestion}`);
+    }
+    console.log("\nArtifacts:");
+    for (const a of plan.artifacts) {
+        const tag = a.exists ? " (exists — will skip unless --force)" : "";
+        console.log(`  • ${a.path} — ${a.description}${tag}`);
+    }
+    if (plan.review.length > 0) {
+        console.log(`\n${plan.review.length} UI component(s) discovered by convention (low confidence).`);
+        console.log("Wire each to a design reference in design-map.json when you adopt a design tool:");
+        for (const c of plan.review)
+            console.log(`  • ${c.code}`);
+    }
+}
+async function confirm(question) {
+    if (!stdin.isTTY)
+        return false;
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const answer = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
+        return answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+async function main() {
+    let args;
+    try {
+        args = parseArgs(argv.slice(2));
+    }
+    catch (err) {
+        console.error(err.message);
+        console.error("\n" + HELP);
+        return 2;
+    }
+    if (args.help) {
+        console.log(HELP);
+        return 0;
+    }
+    // Principle 1 & 4: never bootstrap on the unattended Action path.
+    if (env.GITHUB_ACTIONS === "true" || env.CI === "true") {
+        console.error("design-parity-bootstrap is interactive setup and won't run in CI.\n" +
+            "Run it locally, review the generated artifacts, and commit them. The\n" +
+            "GitHub Action enforces those committed artifacts — it never bootstraps.");
+        return 1;
+    }
+    const plan = await planBootstrap(args.dir, { direction: args.direction });
+    printPlan(plan);
+    const toWrite = plan.artifacts.filter((a) => args.force || !a.exists);
+    if (toWrite.length === 0) {
+        console.log("\nNothing to write (all artifacts exist; pass --force to overwrite).");
+        return 0;
+    }
+    if (!args.yes) {
+        const ok = await confirm(`\nWrite ${toWrite.length} file(s) to ${args.dir}?`);
+        if (!ok) {
+            console.log("Aborted; nothing written.");
+            return 0;
+        }
+    }
+    const result = await applyBootstrap(plan, { force: args.force });
+    for (const p of result.written)
+        console.log(`wrote   ${p}`);
+    for (const p of result.skipped)
+        console.log(`skipped ${p} (exists)`);
+    console.log("\nReview the artifacts and commit them.");
+    return 0;
+}
+exit(await main());
+//# sourceMappingURL=bootstrap.js.map

package/dist/cli/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/cli/bootstrap.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,OAAO,EACL,cAAc,EACd,aAAa,GAEd,MAAM,iBAAiB,CAAC;AAUzB,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,GAAG,GAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,QAAQ,CAAC,EAAE,CAAC;YACV,KAAK,OAAO,CAAC;YACb,KAAK,IAAI;gBACP,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,KAAK,SAAS;gBACZ,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;gBACjB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,OAAO;gBACV,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;gBAC3B,MAAM;YACR,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpB,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;oBAC3C,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,GAAG,CAAC,CAAC;gBAC5E,CAAC;gBACD,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;gBAClB,MAAM;YACR,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;uEAa0D,CAAC;AAExE,SAAS,SAAS,CAAC,IAAmB;IACpC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAErD,8EAA8E;IAC9E,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,4FAA4F,CAAC,CAAC;QAC1G,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;SAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,6DAA6D,CACrF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,kFAAkF,CAAC,CAAC;QAChG,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,QAAgB;IACrC,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9E,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,IAAU,CAAC;IACf,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,kEAAkE;IAClE,IAAI,GAAG,CAAC,cAAc,KAAK,MAAM,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACvD,OAAO,CAAC,KAAK,CACX,qEAAqE;YACnE,wEAAwE;YACxE,yEAAyE,CAC5E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QACpF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACd,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,WAAW,OAAO,CAAC,MAAM,eAAe,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9E,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC"}

package/dist/cmp.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Compose Multiplatform (CMP) capability detection (Principle 6).
+ *
+ * The candidate side is cheapest to render when the UI is Compose
+ * Multiplatform: a CMP component renders on the JVM/desktop — and, increasingly,
+ * a headless browser via Compose for Web / wasm — with no Android emulator. So
+ * the bot *prefers* the CMP render path when a project supports it, and
+ * *promotes* CMP to projects that don't. This module supplies the deterministic
+ * half of that: scan committed Gradle build files for CMP signals and report a
+ * `cmpCapable` verdict plus the evidence behind it.
+ *
+ * This is detection + advisory only. It NEVER gates: plain Jetpack Compose stays
+ * fully supported, and a non-CMP repo gets a suggestion, not a failure
+ * (Principle 6). Detection is a bounded, deterministic, offline file scan — no
+ * model calls, no network, no toolchain — matching {@link detectMaturity}.
+ */
+/** What kind of CMP evidence a build file yielded. */
+export type CmpSignalKind = 
+/** The `org.jetbrains.compose` Gradle plugin (the CMP plugin). */
+"compose-plugin"
+/** The Kotlin Multiplatform plugin (`kotlin("multiplatform")` / KMP id). */
+ | "kotlin-multiplatform"
+/** A non-Android KMP target that can host a headless render (jvm/desktop/wasmJs/js). */
+ | "jvm-target"
+/** A `compose-multiplatform` dependency or version-catalog coordinate. */
+ | "compose-dependency";
+/** One piece of CMP evidence found in a build file. */
+export interface CmpSignal {
+    kind: CmpSignalKind;
+    /** Repo-relative path to the build file that matched. */
+    path: string;
+    /** The literal text fragment that matched, for an auditable verdict. */
+    match: string;
+}
+/** The CMP capability verdict, surfaced on the maturity result. */
+export interface CmpCapability {
+    /** True when any CMP signal was found (drives the prefer/promote choice). */
+    cmpCapable: boolean;
+    /** Every CMP signal found, in scan order — the audit trail. */
+    signals: CmpSignal[];
+}
+/** True if `name` is a build file this module scans. */
+export declare function isCmpBuildFile(name: string): boolean;
+/**
+ * Classify the contents of a single build file into CMP signals (pure).
+ *
+ * Comment lines (`//`, `#`) are skipped so a commented-out plugin block never
+ * trips a false positive. At most one signal per kind per file is reported, so
+ * the evidence stays compact.
+ *
+ * @param path repo-relative path, echoed back on each signal for the audit trail
+ * @param contents the file's text
+ */
+export declare function classifyBuildFile(path: string, contents: string): CmpSignal[];
+/**
+ * Fold a set of per-file signals into a {@link CmpCapability} verdict.
+ *
+ * A repo is CMP-capable on *any* signal — the CMP plugin, the KMP plugin, a
+ * JVM/desktop/wasm/js target, or a compose-multiplatform dependency. The
+ * threshold is deliberately permissive: this is an advisory promote/prefer hint,
+ * never a gate, so a false positive merely skips a suggestion and a false
+ * negative merely shows one (Principle 6).
+ */
+export declare function summarizeCmp(signals: CmpSignal[]): CmpCapability;
+/**
+ * The promotion suggestion shown to Android-only (non-CMP) projects. Returns a
+ * non-blocking advisory string when `capability.cmpCapable` is false, and
+ * `undefined` when the repo is already CMP-capable (nothing to promote).
+ *
+ * This is the "promote CMP, never require it" half of Principle 6: advisory
+ * only, surfaced in the bootstrap output and (where relevant) the PR comment —
+ * never a gate.
+ */
+export declare function cmpSuggestion(capability: CmpCapability): string | undefined;
+//# sourceMappingURL=cmp.d.ts.map

package/dist/cmp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmp.d.ts","sourceRoot":"","sources":["../src/cmp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,sDAAsD;AACtD,MAAM,MAAM,aAAa;AACvB,kEAAkE;AAChE,gBAAgB;AAClB,4EAA4E;GAC1E,sBAAsB;AACxB,wFAAwF;GACtF,YAAY;AACd,0EAA0E;GACxE,oBAAoB,CAAC;AAEzB,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,UAAU,EAAE,OAAO,CAAC;IACpB,+DAA+D;IAC/D,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAUD,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAwCD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAwB7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAU3E"}