@syncline-design/cli 0.1.0-sandbox.53 → 0.1.0-sandbox.54

package/README.md

@@ -48,13 +48,14 @@ with the old paths needs the same one-word change.
 
 ## Options
 
-| Option            |                                                                                                 |
-| ----------------- | ----------------------------------------------------------------------------------------------- |
-| `--config <file>` | Config file (default `syncline.config.json`; every setting has a default, so no file is needed) |
-| `--cwd <dir>`     | Project root (default: the current directory)                                                   |
-| `--check`         | Drift check for CI: nothing is written; exit 1 if the output differs from what is on disk       |
-| `--verbose`       | List every warning instead of a per-phase count                                                 |
-| `--accept <path>` | After a merge conflict you resolved by hand: keep the file and record the new base (repeatable) |
+| Option                |                                                                                                                                                                     |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--config <file>`     | Config file (default `syncline.config.json`; every setting has a default, so no file is needed)                                                                     |
+| `--cwd <dir>`         | Project root (default: the current directory)                                                                                                                       |
+| `--check`             | Drift check for CI: nothing is written; exit 1 if the output differs from what is on disk                                                                           |
+| `--verbose`           | List every warning instead of a per-phase count                                                                                                                     |
+| `--overwrite-stories` | For this run only, rewrite stories files that already exist so they get the proposed `play()` stories (replaces hand edits to those files; the config is untouched) |
+| `--accept <path>`     | After a merge conflict you resolved by hand: keep the file and record the new base (repeatable)                                                                     |
 
 Warnings are design feedback (for example a fill that is not bound to a Figma
 variable), never failures.
@@ -101,7 +102,7 @@ Every key is optional; this is the full shape with its defaults. The Figma plugi
     "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
+    "enabled": true, // part of generating stories; the plan decides at run time (paid), false opts out
     "verify": true, // run each proposed story (jsdom, your Vitest) and write only the ones that pass
   },
   "theme": {
@@ -247,16 +248,19 @@ 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
+Proposing extra stories with `play()` interaction tests is part of generating
+the stories (`enrichStories.enabled` is on by default; `false` opts out). It is a
+paid feature and the plan decides at run time: on an account without it the bridge
+says no, the CLI prints why and writes the plain stories, so an upgrade needs no
+config change. The CLI asks 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
 `.syncline/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.
+writes the plain stories. An existing stories file is never rewritten, unless you
+run `syncline generate --overwrite-stories` once to upgrade the files you already have.
 
 **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
@@ -265,7 +269,8 @@ 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
+`@storybook/react` in the project (the dependency check lists them, and
+`dependencies.install` adds them); without them nothing is written and the run
 says why. Set `verify` to `false` to write the proposals unchecked.
 
 ## Fonts

package/bin.js

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

package/index.js

@@ -1,4 +1,4 @@
-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-Cr3o-ltQ.js";
+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-Bx68LVYw.js";
 import { join as A } from "node:path";
 //#region src/stories/project-step.ts
 async function j(n) {

package/package.json

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