@syncline-design/cli 0.1.0-sandbox.42 → 0.1.0-sandbox.45

package/README.md

@@ -84,6 +84,10 @@ Every key is optional; this is the full shape with its defaults. The Figma plugi
     "llm": false, // paid: let the bridge resolve what a 3-way merge can't
     "sendSource": false, // required with llm: the conflicting files' source is sent to the bridge
   },
+  "enrichStories": {
+    "enabled": false, // paid: AI-proposed stories with play() tests, for components with no stories file yet
+    "verify": true, // run each proposed story (jsdom, your Vitest) and write only the ones that pass
+  },
   "theme": {
     "cssReset": false, // global page state, so opt-in
     "backgroundToken": "Background/Default/Default",
@@ -149,6 +153,14 @@ masks the token and writes `token`, `name` and `email` to `$GITHUB_OUTPUT`;
 without one (no bridge, no credentials, app not installed) it says why and exits
 0, and the workflow pushes with its own token instead.
 
+## Preview access (for the seeded workflow)
+
+`syncline ci preview-access` asks the bridge whether the Storybook preview is
+available to the repository's account and writes `enabled=true|false` to
+`$GITHUB_OUTPUT` (printed elsewhere). The workflow's `preview` job runs its build
+only on `true`. Anything but a clear yes (no bridge, no credentials, an older
+bridge, an outage) is `false`, and it always exits 0.
+
 ## TypeScript and Storybook defaults
 
 - **`tsconfig.json`:** the generated components, ThemeProvider and Storybook decorator
@@ -204,6 +216,29 @@ keep every export, and contain no conflict markers); anything else leaves the
 conflict to you. `--check` never calls the bridge, and a run without a bridge,
 credentials or the paid plan just reports the conflicts.
 
+## AI-proposed stories (`enrichStories`)
+
+With `enrichStories.enabled` (a paid feature) the CLI asks the bridge for extra
+stories with `play()` interaction tests, for every component that has no stories
+file yet. **Only facts leave the repo**: prop names and closed option lists, and
+the roles and texts a story can act on; no source code. The model's answer is
+data that the CLI validates against the real component (props, options and
+targets must exist) before it renders the `play()` with `storybook/test`, so
+whatever the model gets wrong is dropped, not written. Answers are cached in
+`.figma/stories.enriched.json` (commit it), `--check` and `--no-enrich` never
+call the bridge, and a run without a bridge, credentials or the paid plan just
+writes the plain stories. An existing stories file is never rewritten.
+
+**Every proposed story is run before it is written** (`enrichStories.verify`, on
+by default). The model cannot know what a component really does, and in a first
+trial 44% of the proposals failed when run. The CLI renders the proposals into
+the project, runs them headless with the project's own Vitest (jsdom, your
+`vite.config.*` and `.storybook/preview`, Storybook's portable stories), keeps
+the ones that pass and records the rest, with the reason, under `rejected` in the
+cache, so a re-run does not ask again. It needs `vitest`, `jsdom` and
+`@storybook/react` in the project; without them nothing is written and the run
+says why. Set `verify` to `false` to write the proposals unchecked.
+
 ## Dependencies
 
 The generated code imports `react`, `react-dom`, `styled-components` and, with

package/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as e } from "./run-BkY-ZvBm.js";
+import { r as e } from "./run-jiOpeOqI.js";
 //#region src/bin.ts
 e(process.argv.slice(2), {
 	out: (e) => process.stdout.write(e),

package/index.js

@@ -1,2 +1,51 @@
-import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./run-BkY-ZvBm.js";
-export { r as BridgeError, m as CLI_NAME, i as CLI_VERSION, c as CliConfigSchema, a as DEFAULT_CONFIG_FILE, t as bridgeClientProvider, d as createBridgeClient, s as enrichDesign, u as formatFiles, e as generate, n as getBridgeToken, h as hashFacts, l as helpText, o as loadCliConfig, f as run, p as runEnrichStep };
+import { A as e, C as t, D as n, E as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, k as g, l as _, m as v, n as y, o as b, p as x, r as S, s as C, t as w, u as T, v as E, w as D, x as O, y as k } from "./run-jiOpeOqI.js";
+import { join as A } from "node:path";
+//#region src/stories/project-step.ts
+async function j(n) {
+	let { cwd: r, config: i, io: o } = n;
+	if (!i.enrichStories.enabled) return { status: "disabled" };
+	let s = a({
+		root: r,
+		designPath: i.inputs.design,
+		enrichedPath: i.inputs.enriched,
+		assetsPath: i.inputs.assets,
+		annotationsPath: i.inputs.annotations,
+		brandImage: i.theme.brand?.image
+	});
+	if (s.ok === !1) return {
+		status: "no-design",
+		reason: s.error
+	};
+	let l = A(r, i.inputs.stories), u = n.env ?? process.env, d = await f({
+		input: {
+			...s.input,
+			existing: O(r)
+		},
+		config: i,
+		cachePath: l,
+		bridgeUrl: t({
+			env: u,
+			configured: i.enrich.bridgeUrl ?? n.bridgeUrl,
+			baked: e
+		}),
+		audience: n.audience ?? i.enrich.audience,
+		provider: n.provider,
+		io: o,
+		env: u,
+		fetch: n.fetch,
+		sleep: n.sleep
+	});
+	if (!d) return { status: "skipped" };
+	let p = i.enrichStories.verify ? await b({
+		...n,
+		cachePath: l,
+		generate: c
+	}) : void 0;
+	return {
+		status: "done",
+		proposals: d.size,
+		...p && { verified: p }
+	};
+}
+//#endregion
+export { o as BridgeError, w as CLI_NAME, g as CLI_VERSION, n as CliConfigSchema, i as DEFAULT_CONFIG_FILE, C as applyVerification, E as bridgeClientProvider, T as cachedStoryEnrichment, r as createBridgeClient, k as enrichDesign, v as enrichStories, p as formatFiles, c as generate, D as getBridgeToken, l as hashFacts, m as hashStoryFacts, y as helpText, h as loadCliConfig, u as proposalKeys, d as readStoriesCache, S as run, s as runEnrichStep, j as runProjectStoriesStep, f as runStoriesStep, _ as runVitestHarness, x as selectProposals, b as verifyProposals };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncline-design/cli",
-  "version": "0.1.0-sandbox.42",
+  "version": "0.1.0-sandbox.45",
   "description": "Generates a React component library from a Figma export (Syncline).",
   "license": "MIT",
   "repository": {