@sun-asterisk/sungen 2.5.0 → 2.5.1

package/dist/orchestrator/templates/ai-instructions/github-skill-sungen-tc-generation.md

@@ -6,14 +6,25 @@ user-invocable: false
 
 ## Goal
 
-Generate **focused test cases per screen section** with **20+ scenarios per viewpoint**. Output `.feature` + `test-data.yaml` only — selectors are deferred to `/sungen:run-test`.
+Generate **focused test cases per screen section** using a **tier-based approach** for faster results. Output `.feature` + `test-data.yaml` only — selectors are deferred to `/sungen:run-test`.
+
+### Tier System
+
+| Tier | Priority | What to generate | When |
+|---|---|---|---|
+| **Tier 1** (default) | `@critical` + `@high` | Happy paths, required validation, core business rules, security basics | First run of `create-test` |
+| **Tier 2** (expand) | `@normal` + `@low` | UI presence, optional validation, edge cases, cosmetic checks | User runs `create-test` again with "Add viewpoints" mode |
+
+**Round 1 (Tier 1)** targets **~10-15 scenarios per section** — enough to cover critical flows and catch real bugs. This is the default behavior.
+
+**Round 2 (Tier 2)** expands to full coverage when the user explicitly chooses "Add viewpoints" or "Add new sections" update mode. Only then generate `@normal` + `@low` scenarios to fill coverage gaps.
 
 ## Update Mode
 
 When `.feature` already has scenarios, summarize and ask:
-1. **Add new sections** — append, continue numbering
-2. **Add viewpoints** — add to existing sections
-3. **Replace all** — overwrite
+1. **Add new sections** — append new sections with Tier 2 (`@normal` + `@low`) scenarios, continue numbering
+2. **Add viewpoints** — expand existing sections with Tier 2 (`@normal` + `@low`) scenarios
+3. **Replace all** — overwrite with fresh Tier 1 (`@critical` + `@high`) generation
 
 For append: read highest `VP-<CAT>-<NNN>`, continue from next number. Never modify existing scenarios.
 
@@ -28,14 +39,28 @@ Requirements improve every viewpoint: exact error messages for VAL, business rul
 
 If also exploring live page: verify spec vs actual, flag mismatches, capture exact text.
 
+### Figma supplement (`spec_figma.md`)
+
+When `requirements/spec_figma.md` is present alongside `spec.md`, treat it as a **secondary input** with these rules:
+
+- **Never override `spec.md`**: `spec.md` is authoritative for all business rules, field constraints, and behavior. `spec_figma.md` only supplements with visual/text data that `spec.md` may lack.
+- **`## Text Inventory` → literal strings**: use text label values from this section verbatim in `test-data.yaml` (button labels, input placeholders, error messages shown in Figma). Do not paraphrase or invent alternatives.
+- **`## Interaction States` → state coverage checkpoints**: use the listed variants (e.g., empty, loading, error, success) as a checklist for state-coverage scenarios. Only generate scenarios for states that are either (a) confirmed in both `spec.md` and `spec_figma.md`, or (b) explicitly documented in one source without contradiction from the other.
+- **Flag disagreements**: if a field name, label, or behavior in `spec_figma.md` contradicts `spec.md`, insert an HTML comment at the top of the `.feature` file:
+  ```gherkin
+  <!-- FIGMA-SPEC CONFLICT: <brief description> — using spec.md value -->
+  ```
+  Then proceed using the `spec.md` value.
+
 ## Screen Input Sources
 
-**Recommended** (in priority order):
-1. **Figma designs** — use Figma MCP to read design context, screenshots, and component metadata
-2. **UI images** — screenshots or mockups in `qa/screens/<screen>/requirements/ui/`
-3. **`spec.md`** — written specification with sections, fields, validation rules
+**Auto-detect** — the parent command (`create-test`) resolves visual sources before invoking this skill. By the time generation starts, the available sources are already determined:
+- `spec.md` — primary, always read if present
+- `spec_figma.md` — Figma supplement, read if present (PAT flow already completed)
+- `ui/*.png` — visual context, read if present
+- `test-viewpoint.md` — edge cases and known issues, read if present
 
-**Optional**: **Live page scan** via Playwright MCP — useful to verify specs vs actual UI, capture real data (error messages, labels). If auth needed → ask user to log in manually via MCP browser.
+**IMPORTANT:** If `spec_figma.md` exists, do NOT call any `mcp__figma__*` tool. The PAT flow is complete — just read the file.
 
 **Single screen focus**: one URL = one screen. Don't explore sibling paths. Modals on same page = part of this screen.
 
@@ -76,7 +101,9 @@ Apply `sungen-test-design-techniques` to spec-extracted conditions:
 
 Use `sungen-viewpoint` skill for per-pattern checklists across 4 viewpoints: UI/UX, Data & Validate, Logic, Security.
 
-Add scenarios for generic UI coverage that spec didn't explicitly state (empty states, loading states, keyboard nav, hover effects). Skip viewpoints truly N/A.
+**Tier-aware gap filling:**
+- **Tier 1 (first run)**: only add `@critical` and `@high` items from the checklists — core security checks (VP-SEC), required field validation (VP-VAL), key state transitions (VP-LOGIC). Skip `@normal`/`@low` items like hover states, empty states, tooltips.
+- **Tier 2 (expand run)**: add `@normal` + `@low` scenarios — UI presence, optional validation, edge cases, cosmetic checks, keyboard nav, hover effects.
 
 **Validation rule**: capture actual error messages from live page or spec.md. Use `User see {{error_var}}` — never assert just "is visible".
 
@@ -168,13 +195,14 @@ Feature: <Screen> Screen
     When User click [Create] button
     Then User see [Form] dialog
 
-  # --- Section: Create User Form ---
+  # --- Section: Create User Form (Tier 1: @critical + @high) ---
 
-  @normal @extend:open_form
-  Scenario: VP-UI-001 Form displays all fields with correct defaults
+  @critical @extend:open_form
+  Scenario: VP-LOGIC-001 Submit form with valid data creates record
     Given User is on [Form] dialog
-    Then User see [Name] field
-    And User see [Submit] button is disabled
+    When User fill [Name] field with {{valid_name}}
+    And User click [Submit] button
+    Then User see {{success_message}} message
 
   @high @extend:open_form
   Scenario: VP-VAL-001 Submit with all empty fields shows errors
@@ -182,11 +210,7 @@ Feature: <Screen> Screen
     When User click [Submit] button
     Then User see [Name error] message with {{name_required_error}}
 
-  # --- Section: User Table ---
-
-  @normal
-  Scenario: VP-UI-010 Table displays all columns
-    Then User see [Name] column in [Users] table
+  # --- Section: User Table (Tier 1: @critical + @high) ---
 
   @high
   Scenario: VP-VAL-010 Table displays correct data
@@ -194,13 +218,15 @@ Feature: <Screen> Screen
       | Name       | Email        |
       | {{name_1}} | {{email_1}}  |
 
-  @high
-  Scenario: VP-VAL-011 Edit button targets correct row
-    Given User see [Target] row in [Users] table with {{name_1}}
-    When User click [Edit] button in [Users] table with {{name_1}}
-    Then User see [Name] field with {{name_1}}
+  @critical
+  Scenario: VP-SEC-010 Unauthorized user cannot access page
+    Given User is not logged in
+    When User navigate to [Screen] page
+    Then User is on [Login] page
 ```
 
+**Tier 2 (expand run)** adds `@normal` + `@low` scenarios like UI field presence, hover states, tooltips, empty states.
+
 ### When to use DataTable vs Row Scope
 
 | Pattern | Use when |

package/dist/orchestrator/templates/ai-instructions/github-skill-sungen-tc-review.md

@@ -43,6 +43,8 @@ Score: `(dimensions_covered / 6) * 40`. Validate technique application with `sun
 
 **Classification**: UI = static/always-same appearance. VAL = input validation/errors. LOGIC = behavior/state changes (includes persisted state without When). SEC = auth/permissions.
 
+**Tier-aware scoring**: If the feature file only contains `@critical` + `@high` scenarios (Tier 1), do NOT penalize for missing VP-UI viewpoint — UI scenarios are intentionally deferred to Tier 2. Score "All applicable VP present" based on Tier 1-relevant viewpoints only (VAL, LOGIC, SEC). Note in the review output: *"VP-UI deferred to Tier 2 — run create-test with 'Add viewpoints' to expand."*
+
 ---
 
 ## Quality Rules
@@ -87,6 +89,21 @@ Do NOT mark `@manual` when data is visible in snapshot or documented in spec —
 
 ---
 
+## Unverified Selectors metric
+
+**When to check**: if `qa/screens/<screen>/selectors/<screen>.yaml` exists, count lines matching the pattern `@needs-live-verify`.
+
+| Metric | Source | Scoring impact |
+|---|---|---|
+| Unverified Selectors | Count of `@needs-live-verify` comment lines in `selectors.yaml` | None — non-blocking |
+
+- If count > 0: include the following line in the review report summary (after the score table, before Issues):
+  `⚠ <N> selectors flagged @needs-live-verify — run run-test against live URL when available.`
+- Does NOT reduce the score or block the 60% threshold. The suite can PASS with unverified selectors.
+- If `selectors.yaml` does not exist yet (not yet generated): omit this metric entirely.
+
+---
+
 ## Output Format
 
 ```markdown
@@ -99,6 +116,9 @@ Do NOT mark `@manual` when data is visible in snapshot or documented in spec —
 | Viewpoint | <n> | 30 |
 | **Total** | **<n>%** | **100** |
 
+⚠ <N> selectors flagged @needs-live-verify — run run-test against live URL when available.
+<!-- omit this line if selectors.yaml doesn't exist or @needs-live-verify count = 0 -->
+
 ### Issues
 1. [SYNTAX] ...
 2. [COVERAGE] ...

package/dist/tools/figma/figma-auth.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Figma PAT lifecycle: load, save, clear, and safety checks.
+ *
+ * Storage: <cwd>/.env  key=FIGMA_PAT
+ * Override: process.env.FIGMA_PAT (CI path — skips file read)
+ *
+ * Safeguards enforced on every save AND every assertSafeToUse call:
+ *   1. .env must appear in .gitignore (abort if not).
+ *   2. No tracked file may contain "FIGMA_PAT=" (git grep scan).
+ */
+/**
+ * Load the Figma PAT.
+ * Priority: process.env.FIGMA_PAT > .env file.
+ * Returns undefined when no PAT is configured.
+ */
+export declare function loadPat(cwd: string): string | undefined;
+/**
+ * Persist PAT to <cwd>/.env, upserting only the FIGMA_PAT key.
+ * Aborts with an actionable error if safeguards are violated.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+export declare function savePat(cwd: string, token: string): Promise<void>;
+/**
+ * Remove FIGMA_PAT line from <cwd>/.env.
+ * No-op when key is not present.
+ */
+export declare function clearPat(cwd: string): void;
+/**
+ * Run tracked-file scan on every Figma CLI / skill invocation.
+ * Aborts with actionable message if FIGMA_PAT= is found in any tracked file.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+export declare function assertSafeToUse(cwd: string): Promise<void>;
+//# sourceMappingURL=figma-auth.d.ts.map

package/dist/tools/figma/figma-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-auth.d.ts","sourceRoot":"","sources":["../../../src/tools/figma/figma-auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiEH;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWvD;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCvE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAM1C;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE"}

package/dist/tools/figma/figma-auth.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Figma PAT lifecycle: load, save, clear, and safety checks.
+ *
+ * Storage: <cwd>/.env  key=FIGMA_PAT
+ * Override: process.env.FIGMA_PAT (CI path — skips file read)
+ *
+ * Safeguards enforced on every save AND every assertSafeToUse call:
+ *   1. .env must appear in .gitignore (abort if not).
+ *   2. No tracked file may contain "FIGMA_PAT=" (git grep scan).
+ */
+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.loadPat = loadPat;
+exports.savePat = savePat;
+exports.clearPat = clearPat;
+exports.assertSafeToUse = assertSafeToUse;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const exec_file_no_throw_1 = require("../../utils/exec-file-no-throw");
+const PAT_KEY = 'FIGMA_PAT';
+const ENV_FILE = '.env';
+const GITIGNORE_FILE = '.gitignore';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function envFilePath(cwd) {
+    return path.join(cwd, ENV_FILE);
+}
+function gitignorePath(cwd) {
+    return path.join(cwd, GITIGNORE_FILE);
+}
+/**
+ * Read .env file lines, return empty array when file does not exist.
+ */
+function readEnvLines(cwd) {
+    const fp = envFilePath(cwd);
+    if (!fs.existsSync(fp))
+        return [];
+    return fs.readFileSync(fp, 'utf8').split('\n');
+}
+/**
+ * Write lines back to .env, preserving a trailing newline.
+ */
+function writeEnvLines(cwd, lines) {
+    fs.writeFileSync(envFilePath(cwd), lines.join('\n'), 'utf8');
+}
+/**
+ * Check whether .env (or .env.*) is covered by .gitignore.
+ */
+function isEnvIgnored(cwd) {
+    const gp = gitignorePath(cwd);
+    if (!fs.existsSync(gp))
+        return false;
+    const content = fs.readFileSync(gp, 'utf8');
+    // Accept ".env", ".env.local", ".env.*", or "*.env" patterns
+    return /^\s*(\.env[\w.*]*|\*\.env)\s*$/m.test(content);
+}
+/**
+ * Run `git grep -l "FIGMA_PAT="` in cwd.
+ * Returns list of matching tracked file paths (empty = safe).
+ */
+async function findTrackedFilesWithPat(cwd) {
+    const result = await (0, exec_file_no_throw_1.execFileNoThrow)('git', ['grep', '-l', `${PAT_KEY}=`], cwd);
+    if (result.status === 0 && result.stdout.trim()) {
+        return result.stdout.trim().split('\n').filter(Boolean);
+    }
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load the Figma PAT.
+ * Priority: process.env.FIGMA_PAT > .env file.
+ * Returns undefined when no PAT is configured.
+ */
+function loadPat(cwd) {
+    if (process.env[PAT_KEY])
+        return process.env[PAT_KEY];
+    const lines = readEnvLines(cwd);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(`${PAT_KEY}=`)) {
+            return trimmed.slice(PAT_KEY.length + 1).trim();
+        }
+    }
+    return undefined;
+}
+/**
+ * Persist PAT to <cwd>/.env, upserting only the FIGMA_PAT key.
+ * Aborts with an actionable error if safeguards are violated.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+async function savePat(cwd, token) {
+    // Safeguard 1: .env must be gitignored
+    if (!isEnvIgnored(cwd)) {
+        throw new Error(`Refusing to save FIGMA_PAT: ".env" is not listed in ${GITIGNORE_FILE}.\n` +
+            `Add the following line to ${path.join(cwd, GITIGNORE_FILE)} and re-run:\n\n  .env\n`);
+    }
+    // Safeguard 2: no tracked file may contain FIGMA_PAT=
+    const leakedFiles = await findTrackedFilesWithPat(cwd);
+    if (leakedFiles.length > 0) {
+        throw new Error(`Refusing to save FIGMA_PAT: token key found in tracked file(s):\n` +
+            leakedFiles.map((f) => `  ${f}`).join('\n') +
+            `\n\nRemove FIGMA_PAT from those files, commit the removal, then re-run.\n`);
+    }
+    // Upsert: replace existing line or append
+    const lines = readEnvLines(cwd);
+    const idx = lines.findIndex((l) => l.trim().startsWith(`${PAT_KEY}=`));
+    const newLine = `${PAT_KEY}=${token}`;
+    if (idx >= 0) {
+        lines[idx] = newLine;
+    }
+    else {
+        // Ensure file ends with newline before appending
+        if (lines.length > 0 && lines[lines.length - 1] !== '') {
+            lines.push('');
+        }
+        lines.push(newLine);
+    }
+    writeEnvLines(cwd, lines);
+}
+/**
+ * Remove FIGMA_PAT line from <cwd>/.env.
+ * No-op when key is not present.
+ */
+function clearPat(cwd) {
+    const lines = readEnvLines(cwd);
+    const filtered = lines.filter((l) => !l.trim().startsWith(`${PAT_KEY}=`));
+    if (filtered.length !== lines.length) {
+        writeEnvLines(cwd, filtered);
+    }
+}
+/**
+ * Run tracked-file scan on every Figma CLI / skill invocation.
+ * Aborts with actionable message if FIGMA_PAT= is found in any tracked file.
+ *
+ * @throws Error with remediation instructions on safeguard failure.
+ */
+async function assertSafeToUse(cwd) {
+    const leakedFiles = await findTrackedFilesWithPat(cwd);
+    if (leakedFiles.length > 0) {
+        throw new Error(`Security check failed: FIGMA_PAT found in tracked file(s):\n` +
+            leakedFiles.map((f) => `  ${f}`).join('\n') +
+            `\n\nRemove FIGMA_PAT from those files and commit the removal before using Figma commands.\n`);
+    }
+}
+//# sourceMappingURL=figma-auth.js.map

package/dist/tools/figma/figma-auth.js.map

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

package/dist/tools/figma/figma-cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Version-keyed disk cache for Figma node JSON and rendered images.
+ *
+ * Layout:
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>.json       (filtered node)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-raw.json   (unfiltered API response)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-<scale>.png
+ *
+ * Cache directory is created on first write (permissions 0o700 on Unix).
+ * `bustOldVersions` retains the N most recently modified version dirs.
+ */
+import type { FigmaCacheKind } from './figma-client-types';
+/**
+ * Read a cached entry. Returns `undefined` on cache miss.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+export declare function get(cwd: string, fileKey: string, versionId: string, nodeId: string, kind: FigmaCacheKind): Buffer | undefined;
+/**
+ * Write data to the cache.
+ * Creates the version directory (mode 0o700) if it does not exist.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+export declare function put(cwd: string, fileKey: string, versionId: string, nodeId: string, kind: FigmaCacheKind, data: Buffer | string): void;
+/**
+ * Find the newest on-disk version that has a cached raw node JSON for `nodeId`.
+ * Returns `undefined` when no usable cache exists.
+ *
+ * Lets the scaffolder skip an expensive `/v1/files/:key/nodes` call on Starter
+ * plans where REST quota is severely restricted.
+ */
+export declare function findLatestCachedVersion(cwd: string, fileKey: string, nodeId: string): string | undefined;
+/**
+ * Remove all version directories for `fileKey` except the `keep` most recent.
+ *
+ * Directories are ordered by mtime descending; oldest are deleted first.
+ * No-op when fewer than `keep` versions exist.
+ *
+ * @param keep  Number of versions to retain (default 3).
+ */
+export declare function bustOldVersions(cwd: string, fileKey: string, currentVersion: string, options?: {
+    keep?: number;
+}): void;
+//# sourceMappingURL=figma-cache.d.ts.map

package/dist/tools/figma/figma-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-cache.d.ts","sourceRoot":"","sources":["../../../src/tools/figma/figma-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiC3D;;;;GAIG;AACH,wBAAgB,GAAG,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,GACnB,MAAM,GAAG,SAAS,CAWpB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CACjB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAyBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,IAAI,CAqCN"}

package/dist/tools/figma/figma-cache.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Version-keyed disk cache for Figma node JSON and rendered images.
+ *
+ * Layout:
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>.json       (filtered node)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-raw.json   (unfiltered API response)
+ *   <cwd>/.sungen/figma-cache/<fileKey>/<versionId>/<safeNodeId>-<scale>.png
+ *
+ * Cache directory is created on first write (permissions 0o700 on Unix).
+ * `bustOldVersions` retains the N most recently modified version dirs.
+ */
+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.get = get;
+exports.put = put;
+exports.findLatestCachedVersion = findLatestCachedVersion;
+exports.bustOldVersions = bustOldVersions;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+const CACHE_ROOT = path.join('.sungen', 'figma-cache');
+/** Replace characters unsafe for filenames (colons, slashes, spaces). */
+function safeId(id) {
+    return id.replace(/[:/\\s]/g, '_');
+}
+function cacheDir(cwd, fileKey, versionId) {
+    return path.join(cwd, CACHE_ROOT, safeId(fileKey), safeId(versionId));
+}
+function cacheFilename(nodeId, kind) {
+    const safe = safeId(nodeId);
+    if (kind === 'json')
+        return `${safe}.json`;
+    if (kind === 'raw')
+        return `${safe}-raw.json`;
+    // kind is like "2x", "1x", etc.
+    return `${safe}-${kind}.png`;
+}
+function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Read a cached entry. Returns `undefined` on cache miss.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+function get(cwd, fileKey, versionId, nodeId, kind) {
+    const filePath = path.join(cacheDir(cwd, fileKey, versionId), cacheFilename(nodeId, kind));
+    if (!fs.existsSync(filePath))
+        return undefined;
+    try {
+        return fs.readFileSync(filePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Write data to the cache.
+ * Creates the version directory (mode 0o700) if it does not exist.
+ *
+ * @param kind  'json' for filtered node data, '<n>x' for PNG images.
+ */
+function put(cwd, fileKey, versionId, nodeId, kind, data) {
+    const dir = cacheDir(cwd, fileKey, versionId);
+    ensureDir(dir);
+    const filePath = path.join(dir, cacheFilename(nodeId, kind));
+    const payload = typeof data === 'string' ? Buffer.from(data, 'utf8') : data;
+    // Atomic write: tmp → rename
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, payload, { mode: 0o600 });
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Find the newest on-disk version that has a cached raw node JSON for `nodeId`.
+ * Returns `undefined` when no usable cache exists.
+ *
+ * Lets the scaffolder skip an expensive `/v1/files/:key/nodes` call on Starter
+ * plans where REST quota is severely restricted.
+ */
+function findLatestCachedVersion(cwd, fileKey, nodeId) {
+    const keyDir = path.join(cwd, CACHE_ROOT, safeId(fileKey));
+    if (!fs.existsSync(keyDir))
+        return undefined;
+    let entries;
+    try {
+        entries = fs.readdirSync(keyDir, { withFileTypes: true });
+    }
+    catch {
+        return undefined;
+    }
+    const rawFilename = cacheFilename(nodeId, 'raw');
+    const candidates = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => {
+        const rawPath = path.join(keyDir, e.name, rawFilename);
+        if (!fs.existsSync(rawPath))
+            return undefined;
+        let mtime = 0;
+        try {
+            mtime = fs.statSync(rawPath).mtimeMs;
+        }
+        catch { /* ignore */ }
+        return { versionDir: e.name, mtime };
+    })
+        .filter((x) => x !== undefined)
+        .sort((a, b) => b.mtime - a.mtime);
+    return candidates[0]?.versionDir;
+}
+/**
+ * Remove all version directories for `fileKey` except the `keep` most recent.
+ *
+ * Directories are ordered by mtime descending; oldest are deleted first.
+ * No-op when fewer than `keep` versions exist.
+ *
+ * @param keep  Number of versions to retain (default 3).
+ */
+function bustOldVersions(cwd, fileKey, currentVersion, options = {}) {
+    const keep = options.keep ?? 3;
+    const keyDir = path.join(cwd, CACHE_ROOT, safeId(fileKey));
+    if (!fs.existsSync(keyDir))
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(keyDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const versionDirs = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => {
+        const fullPath = path.join(keyDir, e.name);
+        let mtime = 0;
+        try {
+            mtime = fs.statSync(fullPath).mtimeMs;
+        }
+        catch { /* ignore */ }
+        return { name: e.name, fullPath, mtime };
+    })
+        // Ensure current version is always kept (bump its mtime artificially)
+        .map((d) => d.name === safeId(currentVersion)
+        ? { ...d, mtime: Number.MAX_SAFE_INTEGER }
+        : d)
+        .sort((a, b) => b.mtime - a.mtime); // newest first
+    const toDelete = versionDirs.slice(keep);
+    for (const dir of toDelete) {
+        try {
+            fs.rmSync(dir.fullPath, { recursive: true, force: true });
+        }
+        catch { /* best-effort */ }
+    }
+}
+//# sourceMappingURL=figma-cache.js.map

package/dist/tools/figma/figma-cache.js.map

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