@specship/specship-win32-arm64 0.25.0 → 0.29.0

package/lib/dist/commands/specship/learn.md

@@ -32,6 +32,28 @@ applies it.
    ROUTINE
    ```
 
+### Lanes (ALEARN-DOC)
+
+The capture has three lanes — pick by what the lesson IS:
+
+- **skill** (default, above) — a reusable multi-step routine.
+- **style** — a code-style convention the user stated or corrected ("always
+  use named exports", "use our logger, not console.log"). Capture with
+  `--lane style`; title = short rule name, stdin = the rule in one or two
+  sentences. On apply it lands in `.specship/conventions.md` and is injected
+  into every future session's cheatsheet.
+- **domain** — business/product knowledge the user explained (what a term
+  means, a rule of the domain, a product decision). Capture with
+  `--lane domain`; title = the term/concept, stdin = the fact in plain
+  sentences. On apply it lands as a draft fact under `specs/domain/`
+  (the apply IS the human confirmation — DOM-SPECSHIP-003).
+
+```bash
+specship reflect --capture --lane style --title "<rule name>" <<'RULE'
+<the convention>
+RULE
+```
+
 4. **Tell the user** the proposal id from the output and that they can review
    the open proposals with `specship reflect` (add `--json` for the full
    bodies). Nothing lands until they apply it. The CLI is the only review

package/lib/dist/commands/specship/spec.md

@@ -397,8 +397,14 @@ workflow and the `designer-loop` skill rather than re-explaining either.
     --input SLUG="<slug>"
   ```
 
+Every path also writes `specs/<slug>/design.md` — the pixel-exact design
+reference (every value verbatim, extracted by `specship design extract`, checked
+by `specship design check`; follow the **`design-md` skill**). To capture or
+refresh a design reference without authoring a spec, use that skill directly.
+
 When the workflow finishes it hands off with `/specship:spec implement <first REQ ID>`;
-the implementer reads `specs/<slug>/snapshot.html` for visual fidelity. After the
+the implementer builds the UI from `specs/<slug>/design.md` (the spec's `design:`
+frontmatter), with `snapshot.html` as the raw source. After the
 spec is written and synced, the shared **Post-write review** (above) runs like any
 other authoring path.
 
@@ -432,6 +438,18 @@ Pull the requirement's acceptance criteria and its behaviour surface
 (`specship_spec` with `spec_id` + `behaviour_surface: true` → UI tier / backend
 tier). For **each** acceptance criterion, author a Playwright test when a UI
 exists and/or a backend test, mirroring the repo's existing test conventions.
+**Honour the surface's test-shape classification (REQ-QGATE-001):** a criterion
+marked `[invariant]` is authored as a **property-based test** with the framework
+the surface names — Hypothesis (`@given` + strategies) on a Python backend,
+fast-check on TypeScript/JavaScript — generating inputs and asserting the
+stated property, never a single hard-coded example. Criteria marked
+`[example]` stay concrete example tests.
+**Contract-fuzz leg (REQ-QGATE-003):** when the surface marks the spec
+route-backed, it emits a Schemathesis command scoped to the linked routes.
+Fill in the OpenAPI schema ref, show the command for review (staging only —
+never run it silently), and record the outcome via `specship_link_verify`
+(fail → result "fail" with the failing case as reason). The fuzz run never
+mints `tests`-kind links.
 **Preview the files → confirm → write**, then `specship_link_assert … kind:tests`
 at the `.A<N>`, run the suite, and `specship_link_verify` each (pass→verified,
 fail→broken; a suite that can't run is reported unrun, never marked broken).

package/lib/dist/db/sqlite-adapter.d.ts

@@ -9,13 +9,15 @@
  *   1. `better-sqlite3` — present only when the host has installed it (a
  *      devDependency in this repo, optional in user installs). Ships its
  *      own SQLite compiled with FTS5, so it's the only path that works on
- *      dev machines whose system Node was built without FTS5. Production
- *      bundle ships Node 24 with FTS5 in `node:sqlite`, so it skips this.
- *   2. `node:sqlite` — Node's built-in module (Node 22.5+). Used by the
- *      shipped Node 24 bundle which is compiled with FTS5.
+ *      dev machines whose system Node was built without FTS5.
+ *   2. `node:sqlite` — Node's built-in module (Node 22.5+, the supported
+ *      floor). Published packages bundle no runtime — they run on the
+ *      user's installed Node (>=22.5 <25) — and `node:sqlite` only ships
+ *      FTS5 on Node 24, so Node 22/23 users without better-sqlite3 lack FTS5.
  *
  * Tests, dev runs from source, and contributors get FTS5 via better-sqlite3.
- * End users on the published binary get FTS5 via the bundled Node 24.
+ * End users get FTS5 via better-sqlite3 (optional dependency) or Node 24's
+ * `node:sqlite`.
  */
 export interface SqliteStatement {
     run(...params: any[]): {

package/lib/dist/db/sqlite-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../src/db/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7E,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC3B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,GAAG,CAAC;IACzD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjE,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAqK7D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAkC7F"}
+{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../src/db/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7E,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAC3B,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,GAAG,CAAC;IACzD,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjE,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAqK7D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAkC7F"}

package/lib/dist/db/sqlite-adapter.js

@@ -10,13 +10,15 @@
  *   1. `better-sqlite3` — present only when the host has installed it (a
  *      devDependency in this repo, optional in user installs). Ships its
  *      own SQLite compiled with FTS5, so it's the only path that works on
- *      dev machines whose system Node was built without FTS5. Production
- *      bundle ships Node 24 with FTS5 in `node:sqlite`, so it skips this.
- *   2. `node:sqlite` — Node's built-in module (Node 22.5+). Used by the
- *      shipped Node 24 bundle which is compiled with FTS5.
+ *      dev machines whose system Node was built without FTS5.
+ *   2. `node:sqlite` — Node's built-in module (Node 22.5+, the supported
+ *      floor). Published packages bundle no runtime — they run on the
+ *      user's installed Node (>=22.5 <25) — and `node:sqlite` only ships
+ *      FTS5 on Node 24, so Node 22/23 users without better-sqlite3 lack FTS5.
  *
  * Tests, dev runs from source, and contributors get FTS5 via better-sqlite3.
- * End users on the published binary get FTS5 via the bundled Node 24.
+ * End users get FTS5 via better-sqlite3 (optional dependency) or Node 24's
+ * `node:sqlite`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDatabase = createDatabase;
@@ -204,10 +206,10 @@ function createDatabase(dbPath) {
         errors.push(`node:sqlite: ${error instanceof Error ? error.message : String(error)}`);
         throw new Error('Failed to open SQLite.\n' +
             'SpecShip tries better-sqlite3 first (when installed), then falls back to\n' +
-            "Node's built-in node:sqlite (Node 22.5+). The production install bundles a\n" +
-            'compatible Node 24 with FTS5. For dev / running from source, install\n' +
-            'better-sqlite3 (`npm install --save-dev better-sqlite3`) so FTS5 works on\n' +
-            'hosts whose system Node was built without it.\n' +
+            "Node's built-in node:sqlite (Node 22.5+; FTS5 ships in node:sqlite only on\n" +
+            'Node 24). Run on Node 24, or install better-sqlite3\n' +
+            '(`npm install --save-dev better-sqlite3`) so FTS5 works on hosts whose\n' +
+            'Node was built without it.\n' +
             `Backend errors:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
     }
 }

package/lib/dist/db/sqlite-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-adapter.js","sourceRoot":"","sources":["../../src/db/sqlite-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AA4MH,wCAkCC;AAhND;;;;;;;;GAQG;AACH,MAAM,iBAAiB;IACb,GAAG,CAAM;IAEjB,YAAY,MAAc;QACxB,iEAAiE;QACjE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,oEAAoE;QACpE,4EAA4E;QAC5E,qBAAqB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;YACL,GAAG,CAAC,GAAG,MAAa;gBAClB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;oBAChC,eAAe,EAAE,CAAC,EAAE,eAAe,IAAI,CAAC;iBACzC,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,GAAG,MAAa;gBACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAA8B;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,4EAA4E;QAC5E,6CAA6C;QAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,uEAAuE;QACvE,gFAAgF;QAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACxD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACtE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,WAAW,CAAI,EAAyB;QACtC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;YACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC1B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,uEAAuE;QACvE,yEAAyE;QACzE,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,oBAAoB;IAChB,GAAG,CAAM;IAEjB,YAAY,MAAc;QACxB,iEAAiE;QACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;YACL,GAAG,CAAC,GAAG,MAAa;gBAClB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;oBAChC,eAAe,EAAE,CAAC,EAAE,eAAe,IAAI,CAAC;iBACzC,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,GAAG,MAAa;gBACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAA8B;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,WAAW,CAAI,EAAyB;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,wBAAwB;IAC/B,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,wBAAwB,EAAE,CAAC;IAEpF,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,SAAS,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAC7E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzF,4EAA4E;YAC5E,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,yEAAyE,MAAM,CAAC,CAAC,CAAC,EAAE,CACrF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtF,MAAM,IAAI,KAAK,CACb,0BAA0B;YAC1B,4EAA4E;YAC5E,8EAA8E;YAC9E,wEAAwE;YACxE,6EAA6E;YAC7E,iDAAiD;YACjD,oBAAoB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"sqlite-adapter.js","sourceRoot":"","sources":["../../src/db/sqlite-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AA4MH,wCAkCC;AAhND;;;;;;;;GAQG;AACH,MAAM,iBAAiB;IACb,GAAG,CAAM;IAEjB,YAAY,MAAc;QACxB,iEAAiE;QACjE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,oEAAoE;QACpE,4EAA4E;QAC5E,qBAAqB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;YACL,GAAG,CAAC,GAAG,MAAa;gBAClB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;oBAChC,eAAe,EAAE,CAAC,EAAE,eAAe,IAAI,CAAC;iBACzC,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,GAAG,MAAa;gBACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAA8B;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,4EAA4E;QAC5E,6CAA6C;QAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,uEAAuE;QACvE,gFAAgF;QAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACxD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACtE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,WAAW,CAAI,EAAyB;QACtC,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE;YACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC1B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,uEAAuE;QACvE,yEAAyE;QACzE,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACxC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,oBAAoB;IAChB,GAAG,CAAM;IAEjB,YAAY,MAAc;QACxB,iEAAiE;QACjE,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO;YACL,GAAG,CAAC,GAAG,MAAa;gBAClB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;oBAChC,eAAe,EAAE,CAAC,EAAE,eAAe,IAAI,CAAC;iBACzC,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,GAAG,CAAC,GAAG,MAAa;gBAClB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,GAAG,MAAa;gBACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;YACjC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAA8B;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,WAAW,CAAI,EAAyB;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,wBAAwB;IAC/B,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,wBAAwB,EAAE,CAAC;IAEpF,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,SAAS,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAC7E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzF,4EAA4E;YAC5E,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CACb,yEAAyE,MAAM,CAAC,CAAC,CAAC,EAAE,CACrF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtF,MAAM,IAAI,KAAK,CACb,0BAA0B;YAC1B,4EAA4E;YAC5E,8EAA8E;YAC9E,uDAAuD;YACvD,0EAA0E;YAC1E,8BAA8B;YAC9B,oBAAoB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/lib/dist/design-md/check.d.ts

@@ -0,0 +1,51 @@
+/**
+ * design.md checker (DESIGNMD-DOC, REQ-DESIGNMD-004).
+ *
+ * A design reference is only useful to a low-end model if it is complete,
+ * current and exact. This checks all three mechanically: the fixed sections
+ * are present and the authored ones are filled in; the recorded sources still
+ * hash to what was extracted; every color and custom property in the sources
+ * appears in the generated block; and the authored prose has no approximate
+ * wording ("roughly 12px" is exactly what a cheap model turns into 10px).
+ *
+ * Also hosts the `specship design extract|check` CLI entry points, which
+ * return text + exit code instead of printing (same shape as the spec lint).
+ */
+export type DesignCheckCode = 'design_missing_section' | 'design_missing_generated_block' | 'design_empty_section' | 'design_vague_wording' | 'design_source_missing' | 'design_stale' | 'design_uncovered_value' | 'design_missing_linked_source' | 'design_duplicate_section';
+export interface DesignCheckFinding {
+    code: DesignCheckCode;
+    severity: 'error' | 'warning';
+    line?: number;
+    message: string;
+}
+export interface RecordedSource {
+    path: string;
+    sha256: string;
+}
+/** Sources recorded on the generated block's first line. */
+export declare function recordedSources(block: string): RecordedSource[];
+export declare function checkDesignMd(content: string, opts: {
+    projectRoot: string;
+}): DesignCheckFinding[];
+interface CliResult {
+    output: string;
+    exitCode: number;
+}
+/**
+ * `specship design extract <source...> [--out <design.md> [--title <t>] [--origin <url>]] [--update <design.md>]`
+ * Without --out/--update, prints the generated block.
+ */
+export declare function runDesignExtractCli(argv: string[], opts: {
+    projectRoot: string;
+    date?: string;
+}): CliResult;
+/** `specship design check <design.md> [--json]` */
+export declare function runDesignCheckCli(argv: string[], opts: {
+    projectRoot: string;
+}): CliResult;
+/** `specship design verify <build.html> --against <design.md>` (REQ-DESIGNMD-008). */
+export declare function runDesignVerifyCli(argv: string[], opts: {
+    projectRoot: string;
+}): CliResult;
+export {};
+//# sourceMappingURL=check.d.ts.map

package/lib/dist/design-md/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/design-md/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,MAAM,MAAM,eAAe,GACvB,wBAAwB,GACxB,gCAAgC,GAChC,sBAAsB,GACtB,sBAAsB,GACtB,uBAAuB,GACvB,cAAc,GACd,wBAAwB,GACxB,8BAA8B,GAC9B,0BAA0B,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAG/D;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAkB,EAAE,CA4GlG;AAMD,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAmD3G;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA8B1F;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAkB3F"}

package/lib/dist/design-md/check.js

@@ -0,0 +1,335 @@
+"use strict";
+/**
+ * design.md checker (DESIGNMD-DOC, REQ-DESIGNMD-004).
+ *
+ * A design reference is only useful to a low-end model if it is complete,
+ * current and exact. This checks all three mechanically: the fixed sections
+ * are present and the authored ones are filled in; the recorded sources still
+ * hash to what was extracted; every color and custom property in the sources
+ * appears in the generated block; and the authored prose has no approximate
+ * wording ("roughly 12px" is exactly what a cheap model turns into 10px).
+ *
+ * Also hosts the `specship design extract|check` CLI entry points, which
+ * return text + exit code instead of printing (same shape as the spec lint).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordedSources = recordedSources;
+exports.checkDesignMd = checkDesignMd;
+exports.runDesignExtractCli = runDesignExtractCli;
+exports.runDesignCheckCli = runDesignCheckCli;
+exports.runDesignVerifyCli = runDesignVerifyCli;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const extract_1 = require("./extract");
+const maintain_1 = require("./maintain");
+const render_1 = require("./render");
+const verify_1 = require("./verify");
+const VAGUE = [
+    { re: /\bapprox(?:imately|\.)?\b/i, label: 'approximately' },
+    { re: /\broughly\b/i, label: 'roughly' },
+    { re: /\babout\s+-?\d/i, label: 'about <number>' },
+    { re: /~\s*-?\d/, label: '~<number>' },
+    { re: /\bsimilar to\b/i, label: 'similar to' },
+    { re: /\betc\b\.?/i, label: 'etc.' },
+    { re: /\bTBD\b/, label: 'TBD' },
+    { re: /\bsomething like\b/i, label: 'something like' },
+];
+/** Sources recorded on the generated block's first line. */
+function recordedSources(block) {
+    const line = block.split('\n').find((l) => l.startsWith('Sources:')) ?? '';
+    return [...line.matchAll(/`([^`]+)`\s+sha256:([0-9a-f]{64})/g)].map((m) => ({ path: m[1], sha256: m[2] }));
+}
+function lineOf(content, index) {
+    return content.slice(0, index).split('\n').length;
+}
+/** `## Heading` → [start index of its body, end index]. */
+function sections(content) {
+    const out = new Map();
+    const heads = [...content.matchAll(/^## (.+?)[ \t]*$/gm)];
+    heads.forEach((h, i) => {
+        const bodyStart = h.index + h[0].length;
+        const bodyEnd = i + 1 < heads.length ? heads[i + 1].index : content.length;
+        if (!out.has(h[1]))
+            out.set(h[1], { at: h.index, body: content.slice(bodyStart, bodyEnd) });
+    });
+    return out;
+}
+function checkDesignMd(content, opts) {
+    const findings = [];
+    const secs = sections(content);
+    for (const name of render_1.REQUIRED_SECTIONS) {
+        if (!secs.has(name))
+            findings.push({ code: 'design_missing_section', severity: 'error', message: `missing section "## ${name}"` });
+    }
+    // A heading written twice (a filled copy plus a leftover stub) — say so
+    // plainly; "section is empty" alone sends the author looking in the wrong place.
+    const seen = new Map();
+    for (const h of content.matchAll(/^## (.+?)[ \t]*$/gm)) {
+        const line = lineOf(content, h.index);
+        const first = seen.get(h[1]);
+        if (first !== undefined) {
+            findings.push({
+                code: 'design_duplicate_section',
+                severity: 'error',
+                line,
+                message: `"## ${h[1]}" appears twice (lines ${first} and ${line}) — keep one: merge the content and delete the other heading`,
+            });
+        }
+        else
+            seen.set(h[1], line);
+    }
+    for (const name of render_1.AUTHORED_SECTIONS) {
+        const sec = secs.get(name);
+        if (sec && sec.body.replace(/<!--[\s\S]*?-->/g, '').trim() === '') {
+            findings.push({
+                code: 'design_empty_section',
+                severity: 'error',
+                line: lineOf(content, sec.at),
+                message: `section "## ${name}" is empty — fill it in from the design (or state "None")`,
+            });
+        }
+    }
+    const span = (0, maintain_1.findGeneratedBlock)(content);
+    if (!span) {
+        findings.push({
+            code: 'design_missing_generated_block',
+            severity: 'error',
+            message: 'no generated reference block — run `specship design extract <source> --out <design.md>`',
+        });
+    }
+    // Vague wording, outside the generated block and outside HTML comments.
+    const masked = (span ? content.slice(0, span.start) + ' '.repeat(span.end - span.start) + content.slice(span.end) : content)
+        .replace(/<!--[\s\S]*?-->/g, (m) => m.replace(/[^\n]/g, ' '));
+    masked.split('\n').forEach((text, i) => {
+        for (const v of VAGUE) {
+            if (v.re.test(text)) {
+                findings.push({
+                    code: 'design_vague_wording',
+                    severity: 'error',
+                    line: i + 1,
+                    message: `approximate wording ("${v.label}") — state the exact value from the design`,
+                });
+            }
+        }
+    });
+    if (span) {
+        for (const m of span.block.matchAll(/^Missing linked stylesheet: `([^`]+)`/gm)) {
+            findings.push({
+                code: 'design_missing_linked_source',
+                severity: 'error',
+                message: `linked stylesheet ${m[1]} was not captured — save it next to the source, then re-run extract --update`,
+            });
+        }
+        const sources = recordedSources(span.block);
+        const readable = [];
+        let stale = false;
+        for (const s of sources) {
+            const abs = path.resolve(opts.projectRoot, s.path);
+            let buf;
+            try {
+                buf = fs.readFileSync(abs);
+            }
+            catch {
+                findings.push({ code: 'design_source_missing', severity: 'warning', message: `recorded source ${s.path} is not readable — coverage not checked` });
+                continue;
+            }
+            readable.push(s);
+            if (crypto.createHash('sha256').update(buf).digest('hex') !== s.sha256) {
+                stale = true;
+                findings.push({
+                    code: 'design_stale',
+                    severity: 'error',
+                    message: `source ${s.path} changed since extraction — run \`specship design extract ${sources.map((x) => x.path).join(' ')} --update <design.md>\``,
+                });
+            }
+        }
+        // Coverage only means something against the bytes the block claims to describe.
+        if (!stale && readable.length > 0 && readable.length === sources.length) {
+            try {
+                const x = (0, extract_1.extractDesign)(readable.map((s) => s.path), opts);
+                const block = span.block.toLowerCase();
+                const missing = new Set();
+                for (const p of x.customProperties)
+                    if (!span.block.includes(p.name))
+                        missing.add(p.name);
+                for (const entry of x.inventories['Colors']) {
+                    for (const c of (0, extract_1.colorLiterals)(entry.value))
+                        if (!block.includes(c.toLowerCase()))
+                            missing.add(c);
+                }
+                for (const m of [...missing].sort()) {
+                    findings.push({ code: 'design_uncovered_value', severity: 'error', message: `${m} appears in the source but not in the generated reference` });
+                }
+            }
+            catch (err) {
+                if (!(err instanceof extract_1.DesignSourceError))
+                    throw err;
+            }
+        }
+    }
+    return findings;
+}
+function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+function takeOption(args, name) {
+    const i = args.indexOf(name);
+    if (i === -1)
+        return undefined;
+    const v = args[i + 1];
+    args.splice(i, v !== undefined && !v.startsWith('--') ? 2 : 1);
+    return v !== undefined && !v.startsWith('--') ? v : undefined;
+}
+/**
+ * `specship design extract <source...> [--out <design.md> [--title <t>] [--origin <url>]] [--update <design.md>]`
+ * Without --out/--update, prints the generated block.
+ */
+function runDesignExtractCli(argv, opts) {
+    const args = [...argv];
+    const out = takeOption(args, '--out');
+    const update = takeOption(args, '--update');
+    const title = takeOption(args, '--title');
+    const origin = takeOption(args, '--origin');
+    const date = opts.date ?? today();
+    const sources = args.filter((a) => !a.startsWith('--'));
+    if (out && update)
+        return { output: 'use either --out (new file) or --update (existing file), not both', exitCode: 1 };
+    let x;
+    try {
+        x = (0, extract_1.extractDesign)(sources, opts);
+    }
+    catch (err) {
+        if (err instanceof extract_1.DesignSourceError)
+            return { output: err.message, exitCode: 1 };
+        throw err;
+    }
+    if (update) {
+        const target = path.resolve(opts.projectRoot, update);
+        let existing;
+        try {
+            existing = fs.readFileSync(target, 'utf-8');
+        }
+        catch {
+            return { output: `cannot read ${update} — create it with --out first`, exitCode: 1 };
+        }
+        try {
+            const res = (0, maintain_1.updateDesignMd)(existing, (0, render_1.renderGeneratedBlock)(x), date);
+            if (!res.changed)
+                return { output: `${update} is already current`, exitCode: 0 };
+            fs.writeFileSync(target, res.content);
+            const n = res.diff.added.length + res.diff.removed.length + res.diff.changed.length;
+            return { output: `updated ${update} (${n} value change${n === 1 ? '' : 's'} logged)`, exitCode: 0 };
+        }
+        catch (err) {
+            if (err instanceof maintain_1.DesignMdUpdateError)
+                return { output: `${update}: ${err.message}`, exitCode: 1 };
+            throw err;
+        }
+    }
+    if (out) {
+        const target = path.resolve(opts.projectRoot, out);
+        if (fs.existsSync(target))
+            return { output: `${out} already exists — use --update ${out} to refresh it`, exitCode: 1 };
+        const name = title ?? path.basename(path.dirname(target));
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.writeFileSync(target, (0, render_1.renderDesignMd)(x, { title: name, origin, date }));
+        return {
+            output: `wrote ${out} — fill in the authored sections, then run \`specship design check ${out}\``,
+            exitCode: 0,
+        };
+    }
+    return { output: (0, render_1.renderGeneratedBlock)(x), exitCode: 0 };
+}
+/** `specship design check <design.md> [--json]` */
+function runDesignCheckCli(argv, opts) {
+    const args = [...argv];
+    const json = args.includes('--json');
+    const files = args.filter((a) => !a.startsWith('--'));
+    if (files.length === 0)
+        return { output: 'usage: specship design check <design.md> [--json]', exitCode: 1 };
+    const results = [];
+    for (const file of files) {
+        let content;
+        try {
+            content = fs.readFileSync(path.resolve(opts.projectRoot, file), 'utf-8');
+        }
+        catch {
+            results.push({ file, findings: [{ code: 'design_missing_generated_block', severity: 'error', message: `cannot read ${file}` }] });
+            continue;
+        }
+        results.push({ file, findings: checkDesignMd(content, opts) });
+    }
+    const errors = results.reduce((n, r) => n + r.findings.filter((f) => f.severity === 'error').length, 0);
+    if (json)
+        return { output: JSON.stringify({ results, errors }, null, 2), exitCode: errors > 0 ? 1 : 0 };
+    const lines = [];
+    for (const r of results) {
+        if (r.findings.length === 0) {
+            lines.push(`${r.file}: ok`);
+            continue;
+        }
+        for (const f of r.findings)
+            lines.push(`${r.file}${f.line ? `:${f.line}` : ''}  ${f.severity}  ${f.code}  ${f.message}`);
+    }
+    lines.push(errors > 0 ? `${errors} error${errors === 1 ? '' : 's'}` : 'design check passed');
+    return { output: lines.join('\n'), exitCode: errors > 0 ? 1 : 0 };
+}
+/** `specship design verify <build.html> --against <design.md>` (REQ-DESIGNMD-008). */
+function runDesignVerifyCli(argv, opts) {
+    const args = [...argv];
+    const against = takeOption(args, '--against');
+    const build = args.filter((a) => !a.startsWith('--'))[0];
+    if (!build || !against)
+        return { output: 'usage: specship design verify <build.html> --against <design.md>', exitCode: 1 };
+    let designMd;
+    try {
+        designMd = fs.readFileSync(path.resolve(opts.projectRoot, against), 'utf-8');
+    }
+    catch {
+        return { output: `cannot read ${against}`, exitCode: 1 };
+    }
+    try {
+        const result = (0, verify_1.verifyBuild)(designMd, build, opts);
+        return { output: (0, verify_1.formatVerify)(result, build), exitCode: result.ok ? 0 : 1 };
+    }
+    catch (err) {
+        if (err instanceof extract_1.DesignSourceError)
+            return { output: err.message, exitCode: 1 };
+        throw err;
+    }
+}
+//# sourceMappingURL=check.js.map

package/lib/dist/design-md/check.js.map

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

package/lib/dist/design-md/css.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A small, dependency-free CSS reader for design.md (DESIGNMD-DOC,
+ * REQ-DESIGNMD-001).
+ *
+ * It does not validate CSS or compute the cascade. It walks the text and
+ * records what is written: each rule's selector and declarations verbatim
+ * (whitespace collapsed), the `@media` / `@supports` / `@container` condition
+ * a rule sits under, `@keyframes` bodies and `@font-face` blocks. Native CSS
+ * nesting is flattened (`&` replaced by the parent selector). The output order
+ * is source order, so the same text always yields the same result.
+ */
+export interface CssDeclaration {
+    property: string;
+    value: string;
+}
+export interface CssRule {
+    selector: string;
+    declarations: CssDeclaration[];
+    /** The enclosing conditional at-rule preludes, joined with ` and `. */
+    media?: string;
+}
+export interface CssKeyframes {
+    name: string;
+    body: string;
+    media?: string;
+}
+export interface ParsedCss {
+    rules: CssRule[];
+    keyframes: CssKeyframes[];
+    fontFaces: CssDeclaration[][];
+    /** `@import` targets, verbatim. */
+    imports: string[];
+}
+export declare function collapse(text: string): string;
+/** Split on commas that are not inside parentheses or brackets. */
+export declare function splitTopLevel(text: string, sep?: string): string[];
+/** Parse a `style=""` attribute or any `prop: value; …` list. */
+export declare function parseDeclarationList(text: string): CssDeclaration[];
+export declare function parseCss(text: string): ParsedCss;
+//# sourceMappingURL=css.d.ts.map

package/lib/dist/design-md/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/design-md/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,cAAc,EAAE,EAAE,CAAC;IAC9B,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAOD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AA4FD,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,EAAE,CAe/D;AA2BD,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAKnE;AAuCD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAIhD"}