@hegemonart/get-design-done 1.34.2 → 1.34.4

package/scripts/lib/print/validate-print-css.cjs

@@ -0,0 +1,155 @@
+/**
+ * print/validate-print-css.cjs — static print-CSS constraint validator
+ * (Phase 34.3-01).
+ *
+ * Pure, deterministic regex/string analysis of a print CSS/HTML STRING. Same
+ * input -> identical output. It checks the statically-verifiable SUBSET of the
+ * constraint catalogue in `reference/print-design.md` §8 — the spec is the
+ * authority; the `rule` ids emitted here are constraint-ids defined there.
+ *
+ * WHAT IS CHECKED (the five deterministic classes, emitted in a stable order):
+ *   PR-PAGE-01  an `@page` rule is present — the print box model. Its absence in
+ *               a print stylesheet means no defined page geometry. (Absence flagged.)
+ *   PR-BLEED-01 a bleed box / crop-marks signal is present — a CSS `bleed:`
+ *               declaration, a `marks:` (crop|cross) declaration, or a documented
+ *               bleed/crop-marks note. (Total absence flagged.)
+ *   PR-CMYK-01  a CMYK-awareness signal is present — a `cmyk(` color, a
+ *               `color-profile` / `@color-profile` reference, or a documented CMYK
+ *               note. (Total RGB-only absence flagged.)
+ *   PR-FONT-01  a font-embed signal is present — an `@font-face` rule carrying a
+ *               `src:` (embedded font), or a documented font-embed/outline note. A
+ *               bare system-font-stack with no embed is flagged.
+ *   PR-DPI-01   a 300dpi raster-fallback signal is present — an `image-resolution:`
+ *               declaration (300dpi / from-image), a `min-resolution` query, or a
+ *               documented 300dpi note. (Absence flagged.)
+ *
+ * WHAT IS *NOT* CHECKED (catalogued in reference/print-design.md as render-tested
+ * guidance — verified by the optional Paged.js-headless-Chrome / PDFKit render
+ * connection at 34.3-02, never by this validator): exact overprint/knockout
+ * behavior, ICC-profile correctness / on-press gamut matching, trap/registration,
+ * true vector tessellation, and per-output preflight (PR-*-02/03, PR-UNIT-01,
+ * PR-COLOR-01..03).
+ *
+ * PURITY (D-02 / D-10): operates only on the passed string — no fs of the
+ * document, no network, no child-process spawn, no pdfkit/paged/puppeteer/
+ * playwright runtime import, no Date, no process.env. This file has zero
+ * require() calls (node builtins included).
+ */
+
+'use strict';
+
+// --- PR-PAGE-01: an @page rule is present ---------------------------------
+// Require an actual @page RULE (an optional `:pseudo` selector then a `{` block),
+// not the bare token — so negative prose like "NO @page rule" in a comment does
+// not count as a present rule.
+const AT_PAGE_RE = /@page\b[^;{}]*\{/i;
+
+// --- PR-BLEED-01: a bleed box / crop-marks signal -------------------------
+// A CSS `bleed:` descriptor, a `marks:` (crop|cross) descriptor, or a
+// documented bleed/crop-marks note. The declaration forms require a value after
+// the colon (so a negative-prose "NO bleed box" comment does NOT match); the
+// note form requires the word "crop"/"registration" adjacent to "mark(s)".
+const BLEED_DECL_RE = /\bbleed\s*:\s*\S/i;
+const MARKS_DECL_RE = /\bmarks\s*:\s*(?:crop|cross)\b/i;
+const CROP_MARKS_NOTE_RE = /\b(?:crop|registration)\s+marks?\b/i;
+
+// --- PR-CMYK-01: a CMYK-awareness signal ----------------------------------
+// A cmyk() color, a color-profile / @color-profile reference, or a documented
+// "CMYK" note (the word CMYK anywhere — a comment recording production intent).
+const CMYK_FN_RE = /\bcmyk\s*\(/i;
+const COLOR_PROFILE_RE = /@?color-profile\b/i;
+const CMYK_NOTE_RE = /\bCMYK\b/i;
+
+// --- PR-FONT-01: a font-embed signal --------------------------------------
+// An @font-face rule whose body carries a `src:` (an embedded font), or a
+// documented font-embed/outline note.
+const FONT_FACE_SRC_RE = /@font-face\s*\{[^{}]*\bsrc\s*:/i;
+const FONT_EMBED_NOTE_RE = /\b(?:font[\s-]*embed(?:ding|ded)?|embed(?:ded)?\s+font|outline(?:d)?\s+(?:to\s+)?(?:vector|font)|font[\s-]*outline)\b/i;
+
+// --- PR-DPI-01: a 300dpi raster-fallback signal ---------------------------
+// An image-resolution declaration, a min-resolution query, or a documented
+// 300dpi note (300 immediately followed by dpi/ppi, optionally spaced/hyphenated).
+const IMAGE_RESOLUTION_RE = /\bimage-resolution\s*:/i;
+const MIN_RESOLUTION_RE = /\bmin-resolution\b/i;
+const DPI_300_NOTE_RE = /\b300\s*-?\s*(?:dpi|ppi)\b/i;
+
+/**
+ * Validate a print CSS/HTML string against the statically-checkable constraint
+ * subset of reference/print-design.md §8.
+ *
+ * @param {string} input the print CSS (or HTML carrying a print stylesheet);
+ *   the caller reads the file and passes the content — this function never
+ *   touches the filesystem
+ * @param {{ checks?: string[] }} [opts] reserved for future toggles; default
+ *   runs all five classes
+ * @returns {{ ok: boolean, violations: Array<{ rule: string, detail: string }> }}
+ *   `ok === (violations.length === 0)`; each violation's `rule` is a catalogued
+ *   constraint-id and `detail` is a short human string.
+ */
+function validatePrintCss(input, opts) {
+  if (typeof input !== 'string') {
+    throw new TypeError('validatePrintCss(input): input must be a string');
+  }
+  void opts; // reserved
+  /** @type {Array<{ rule: string, detail: string }>} */
+  const violations = [];
+
+  // --- PR-PAGE-01: an @page rule is present (the print box model) -----------
+  if (!AT_PAGE_RE.test(input)) {
+    violations.push({
+      rule: 'PR-PAGE-01',
+      detail: 'a print stylesheet must declare an @page rule (the print box model — size/margin/marks); none found',
+    });
+  }
+
+  // --- PR-BLEED-01: a bleed box / crop-marks signal -------------------------
+  const hasBleed =
+    BLEED_DECL_RE.test(input) ||
+    MARKS_DECL_RE.test(input) ||
+    CROP_MARKS_NOTE_RE.test(input);
+  if (!hasBleed) {
+    violations.push({
+      rule: 'PR-BLEED-01',
+      detail: 'declare a bleed box / crop marks (a `bleed:` declaration, a `marks: crop|cross` declaration, or a documented bleed/crop-marks note) so edge-to-edge content survives the trim',
+    });
+  }
+
+  // --- PR-CMYK-01: a CMYK-awareness signal ----------------------------------
+  const hasCmyk =
+    CMYK_FN_RE.test(input) ||
+    COLOR_PROFILE_RE.test(input) ||
+    CMYK_NOTE_RE.test(input);
+  if (!hasCmyk) {
+    violations.push({
+      rule: 'PR-CMYK-01',
+      detail: 'signal CMYK awareness (a cmyk() color, a color-profile/@color-profile reference, or a documented CMYK-target note); print is subtractive CMYK, not screen RGB',
+    });
+  }
+
+  // --- PR-FONT-01: a font-embed signal --------------------------------------
+  const hasFontEmbed =
+    FONT_FACE_SRC_RE.test(input) ||
+    FONT_EMBED_NOTE_RE.test(input);
+  if (!hasFontEmbed) {
+    violations.push({
+      rule: 'PR-FONT-01',
+      detail: 'embed or outline fonts (an @font-face with an embedded src:, or a documented font-embed/outline note); print RIPs have no web fonts and no system-font fallback',
+    });
+  }
+
+  // --- PR-DPI-01: a 300dpi raster-fallback signal ---------------------------
+  const hasDpi =
+    IMAGE_RESOLUTION_RE.test(input) ||
+    MIN_RESOLUTION_RE.test(input) ||
+    DPI_300_NOTE_RE.test(input);
+  if (!hasDpi) {
+    violations.push({
+      rule: 'PR-DPI-01',
+      detail: 'provide a 300dpi raster-fallback signal (image-resolution: 300dpi/from-image, a min-resolution query, or a documented 300dpi note); screen 72/96dpi rasters pixelate in print',
+    });
+  }
+
+  return { ok: violations.length === 0, violations };
+}
+
+module.exports = { validatePrintCss };

package/skills/connections/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gdd-connections
-description: "Interactive onboarding wizard for the 12 external integrations the pipeline supports — probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `/gdd:new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime."
+description: "Interactive onboarding wizard for the 14 external integrations the pipeline supports — probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`, `lazyweb`, `mobbin`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `/gdd:new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime."
 argument-hint: "[list | <connection-name> | --auto]"
 user-invocable: true
 tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
@@ -8,11 +8,11 @@ tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
 
 # /gdd:connections
 
-Interactive onboarding for the 12 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
+Interactive onboarding for the 14 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
 
 Canonical per-connection specs live in `../../connections/<name>.md` (one file per integration). The capability matrix + probe-pattern spec live in `../../connections/connections.md`. This skill is the **user-facing front end** for those specs.
 
-For the 12 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
+For the 14 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
 
 ---
 
@@ -38,7 +38,7 @@ For the 12 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization
 
 ## Workflow
 
-1. **Probe all 12 connections** — run every probe script per `./connections-onboarding.md#step-1--probe-all-12-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) — never add new values.
+1. **Probe all 14 connections** — run every probe script per `./connections-onboarding.md#step-1--probe-all-14-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) — never add new values.
 2. **Categorize + build summary** — bucket each probe result (available / recommended / optional / skipped / unavailable) using project-hint detection. Detail + recommendation mapping: `./connections-onboarding.md#step-2--bucket-categorization`.
 3. **Print summary table** — show buckets + value-prop one-liners (verbatim from `./connections-onboarding.md#step-3--summary-table`).
 4. **Route by mode** — `list` / `--auto` exits after summary; `<name>` jumps straight to Step 5; default mode opens an AskUserQuestion (configure recommended / pick one by one / configure all optional / re-check specific / exit). Routing detail: `./connections-onboarding.md#step-4--route-by-mode`.

package/skills/connections/connections-onboarding.md

@@ -9,7 +9,7 @@ last_updated: 2026-05-18
 
 Source: extracted from `skills/connections/SKILL.md` (Phase 28.5 rework — D-10 extract-then-link).
 The skill's load-bearing routing + invocation-mode dispatch stays in `../skills/connections/SKILL.md`;
-this file holds the 12 probe scripts, bucket categorization, per-connection setup screen,
+this file holds the 14 probe scripts, bucket categorization, per-connection setup screen,
 auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts.
 
 # Connections Onboarding Procedure
@@ -27,7 +27,7 @@ this file does NOT duplicate them; it points at them by name.
 
 ---
 
-## Step 1 — Probe all 12 connections
+## Step 1 — Probe all 14 connections
 
 Run every probe below in order. MCP probes call `ToolSearch` first (deferred tools fail silently without it). Write every result to `STATE.md <connections>` when done.
 
@@ -86,6 +86,20 @@ ToolSearch({ query: "mcp__magic_patterns", max_results: 5 })
 → Non-empty → magic_patterns: available
 ```
 
+**lazyweb:** (discover Tier 1 — free, tried first; D-01)
+```
+ToolSearch({ query: "lazyweb", max_results: 5 })
+→ Empty → lazyweb: not_configured
+→ Non-empty → lazyweb: available
+```
+
+**mobbin:** (discover Tier 2 — paid, mobile/flow-level; D-01)
+```
+ToolSearch({ query: "mobbin", max_results: 5 })
+→ Empty → mobbin: not_configured
+→ Non-empty → mobbin: available
+```
+
 ### Non-MCP probes
 
 **storybook** (HTTP):
@@ -131,7 +145,7 @@ Bash: ls .design/handoff/ 2>/dev/null || find . -maxdepth 3 \
   → Non-empty → claude_design: available
 ```
 
-After all 12 probes complete, merge results into `STATE.md <connections>`. Preserve the three-value schema verbatim (`available | unavailable | not_configured`). Do not add new values.
+After all 14 probes complete, merge results into `STATE.md <connections>`. Preserve the three-value schema verbatim (`available | unavailable | not_configured`). Do not add new values.
 
 ---
 
@@ -167,7 +181,7 @@ HAS_FIGMA_HINT=$( grep -r "figma\.com/file" -l . --include="*.md" 2>/dev/null |
 | `HAS_STORYBOOK_DIR` or storybook available | storybook, chromatic |
 | `HAS_PEN_FILES` | pencil-dev |
 | `HAS_REACT` | 21st-dev, magic-patterns |
-| Always | refero, preview |
+| Always | refero, preview, lazyweb (free — cost-aware default, D-01) |
 
 ---
 
@@ -212,6 +226,8 @@ One-line value props (use verbatim):
 | pencil-dev | `.pen` spec files as canonical design source |
 | 21st-dev | AI component generator (marketplace search) |
 | magic-patterns | AI component generator (DS-aware) |
+| lazyweb | free design reference search (pricing/onboarding/redesign) — discover Tier 1 |
+| mobbin | curated mobile + flow-level references (paid) — discover Tier 2 |
 
 ---
 
@@ -239,7 +255,7 @@ options:
   - "Exit"                            → emit ## CONNECTIONS COMPLETE, exit
 ```
 
-If recommended bucket is empty, swap that option for "Show all 12 and pick."
+If recommended bucket is empty, swap that option for "Show all 14 and pick."
 
 ---
 
@@ -296,6 +312,8 @@ options:
 | 21st-dev | `npx @21st-dev/magic init` + env var | ✗ no | Env var required — force manual |
 | pencil-dev | VS Code extension | ✗ no | IDE-level install — force manual |
 | claude-design | handoff bundle drop | ✗ no | User-driven file drop — force manual |
+| mobbin | `claude mcp add mobbin --transport http https://api.mobbin.com/mcp` | ✓ yes | Reversible MCP add; no credential filesystem-write (OAuth on first call) |
+| lazyweb | `claude plugin install lazyweb@lazyweb` (after token write to `~/.lazyweb/`) | ✗ no | Writes a bearer token to disk — force manual (user-consent step) |
 
 For non-auto-run connections, hide the "Run install command now" option entirely in 5.3.
 

package/skills/discover/discover-procedure.md

@@ -68,7 +68,25 @@ C2. Empty result  -> pinterest: not_configured
 
 No live `pinterest_search` call at probe time — ToolSearch presence is sufficient. The synthesizer makes the actual search calls.
 
-After all probes (A, B, C), update `.design/STATE.md` `<connections>` with the results and continue. Downstream stages (design-context-builder) read `<connections>` from STATE.md rather than re-probing.
+### D — Lazyweb probe (ToolSearch-only — free, discover Tier 1 per D-01)
+
+```
+D1. ToolSearch({ query: "lazyweb", max_results: 5 })
+D2. Empty result  -> lazyweb: not_configured
+    Non-empty     -> lazyweb: available
+```
+
+### E — Mobbin probe (ToolSearch-only — paid, discover Tier 2 per D-01)
+
+```
+E1. ToolSearch({ query: "mobbin", max_results: 5 })
+E2. Empty result  -> mobbin: not_configured
+    Non-empty     -> mobbin: available
+```
+
+**Reference-source tier order (cost-aware, D-01):** Lazyweb (free, tried first) → Mobbin / Refero (paid, whichever is bound + subscribed) → Pinterest → awesome-design-md → WebFetch.
+
+After all probes (A, B, C, D, E), update `.design/STATE.md` `<connections>` with the results and continue. Downstream stages (design-context-builder) read `<connections>` from STATE.md rather than re-probing.
 
 ---