rivet-design 0.9.2 → 0.9.4

package/dist/mcp/agent-variants/designContextStore.d.ts

@@ -0,0 +1,160 @@
+import type { InspirationDesignSignals } from './inspirationDesignContext';
+/**
+ * Runtime user cache for inspiration-link design context. Persists generated
+ * designmd markdown plus safe metadata so future MCP
+ * `create_zero_to_one_project` requests with the same web link can reuse
+ * prior extraction by default. Treated as runtime user data — never mutates
+ * the bundled `src/services/templates/designmd` catalog.
+ *
+ * Path layout (local filesystem implementation):
+ *   <directory>/<sha256(normalizedUrl)>.json
+ *
+ * The default <directory> is `~/.rivet/design-context-cache/`. The store
+ * abstraction is interface-first so future hosted/server deployments can
+ * provide a durable backend (HTTPS, KV, SQL) without changing the
+ * extraction or MCP orchestration logic.
+ */
+/**
+ * Output/extractor schema version. Bump when the cache entry shape or the
+ * generated markdown structure changes incompatibly. Cached entries with a
+ * different schema version are not silently reused — they regenerate.
+ */
+export declare const DESIGN_CONTEXT_SCHEMA_VERSION = "2";
+/**
+ * Default freshness window for a cached entry. Entries older than this are
+ * marked `stale` and trigger regeneration by default. Tunable per call so
+ * tests can exercise the stale branch without sleeping.
+ */
+export declare const DEFAULT_FRESHNESS_MS: number;
+/**
+ * Default confidence threshold below which cached entries are considered
+ * low-confidence and trigger regeneration. Mirrors the in-extractor
+ * `LOW_SIGNAL_THRESHOLD` so cached and live signals stay aligned.
+ */
+export declare const DEFAULT_CONFIDENCE_THRESHOLD = 18;
+export type FreshnessState = 'fresh' | 'stale';
+export interface DesignContextCacheMetadata {
+    /** Stable cache key (sha256 hex of normalized URL). */
+    cacheKey: string;
+    /** Extractor/output schema version used to produce this entry. */
+    schemaVersion: string;
+    /** Wall-clock creation time (ms since epoch). */
+    createdAtMs: number;
+    /** Wall-clock last-used time (ms since epoch). */
+    lastUsedAtMs: number;
+    /** Signal density / confidence score (0-100). */
+    confidence: number;
+    /**
+     * Safe outcome metadata only — short non-sensitive warning codes such as
+     * `low_signal` or `partial_meta`. MUST NOT include fetched page content,
+     * full URLs, or extracted text snippets.
+     */
+    warningCodes: string[];
+}
+export interface DesignContextCacheEntry {
+    metadata: DesignContextCacheMetadata;
+    /** Generated single-source designmd markdown (separate-flavor). */
+    markdown: string;
+    /** Short user-visible label (already truncated to fit downstream cap). */
+    label: string;
+    /**
+     * Structured design signals for the source URL. Storing the same derived
+     * design observations the markdown already encodes (palette, families,
+     * sections, components) so merge-strategy callers can re-summarise across
+     * multiple cached entries without re-fetching. Raw HTML, screenshots,
+     * DOM dumps, and full source text MUST NOT be persisted here.
+     */
+    signals: InspirationDesignSignals;
+}
+export interface DesignContextStore {
+    get(cacheKey: string): Promise<DesignContextCacheEntry | undefined>;
+    put(entry: DesignContextCacheEntry): Promise<void>;
+}
+/**
+ * Normalize an HTTP/HTTPS URL for cache keying. Lowercases scheme and host,
+ * strips default ports and fragments, and preserves meaningful path/query
+ * so two pages with the same host but different paths or query strings
+ * keep separate cache entries. Returns `undefined` for inputs that are not
+ * parseable HTTP/HTTPS URLs.
+ */
+export declare const normalizeCacheUrl: (rawUrl: string) => string | undefined;
+/**
+ * Compute a stable cache key from a normalized URL. SHA-256 hashed to hex
+ * so the resulting key is filesystem-safe and does not embed proprietary
+ * URL content in the filename layer.
+ */
+export declare const cacheKeyForUrl: (rawUrl: string) => string | undefined;
+/**
+ * Coarse age bucket for safe telemetry. Maps a wall-clock age in
+ * milliseconds onto a small fixed bucket name so analytics never receive
+ * exact timestamps.
+ */
+export declare const ageBucketFor: (ageMs: number) => "lt_1h" | "1h_24h" | "1d_7d" | "7d_30d" | "gt_30d";
+/**
+ * Coarse confidence bucket for safe telemetry. Three buckets keyed off the
+ * extractor signal density score so reuse outcomes can be aggregated
+ * without leaking specific confidence values.
+ */
+export declare const confidenceBucketFor: (confidence: number) => "low" | "medium" | "high";
+/**
+ * Return true when the user prompt explicitly asks for fresh/latest/
+ * current design context. Used by the MCP flow to bypass cache reuse even
+ * when a compatible entry exists.
+ */
+export declare const promptRequestsFreshExtraction: (prompt: string) => boolean;
+export type CacheReuseDecision = {
+    reuse: true;
+    freshness: FreshnessState;
+    ageMs: number;
+} | {
+    reuse: false;
+    reason: 'version_mismatch' | 'stale' | 'low_confidence' | 'forced_refresh' | 'corrupt';
+    freshness: FreshnessState;
+    ageMs: number;
+};
+interface CanReuseOptions {
+    forceRefresh: boolean;
+    schemaVersion?: string;
+    confidenceThreshold?: number;
+    freshnessMs?: number;
+    now?: number;
+}
+/**
+ * Decide whether a cached entry is reusable for a request, factoring in
+ * extractor/schema version, freshness window, confidence threshold, and
+ * any explicit user request for fresh extraction. Callers MUST honour the
+ * decision — the store itself never silently reuses incompatible entries.
+ */
+export declare const canReuseCacheEntry: (entry: DesignContextCacheEntry, options: CanReuseOptions) => CacheReuseDecision;
+interface FileDesignContextStoreOptions {
+    /**
+     * Override the cache directory. Defaults to `~/.rivet/design-context-cache`
+     * via `os.homedir()`. Tests use a tmpdir override so the suite never
+     * touches the real user cache.
+     */
+    directory?: string;
+}
+/**
+ * Filesystem-backed `DesignContextStore`. One JSON file per cache key under
+ * a per-user cache directory. Safe to delete the entire directory without
+ * affecting bundled catalog data or compiled application code.
+ *
+ * Read/write failures degrade gracefully — get returns undefined on any
+ * parse/IO error so the MCP flow falls through to a fresh extraction
+ * instead of crashing the user request.
+ */
+export declare class FileDesignContextStore implements DesignContextStore {
+    private readonly directory;
+    private dirReady;
+    constructor(options?: FileDesignContextStoreOptions);
+    /**
+     * Resolve a cache key to its on-disk file path. Rejects keys that do not
+     * match the expected sha256 hex shape so a malformed key cannot escape
+     * the cache directory.
+     */
+    resolvePath(cacheKey: string): string | undefined;
+    get(cacheKey: string): Promise<DesignContextCacheEntry | undefined>;
+    put(entry: DesignContextCacheEntry): Promise<void>;
+}
+export {};
+//# sourceMappingURL=designContextStore.d.ts.map

package/dist/mcp/agent-variants/designContextStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designContextStore.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/designContextStore.ts"],"names":[],"mappings":"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"}

package/dist/mcp/agent-variants/designContextStore.js

@@ -0,0 +1,295 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileDesignContextStore = exports.canReuseCacheEntry = exports.promptRequestsFreshExtraction = exports.confidenceBucketFor = exports.ageBucketFor = exports.cacheKeyForUrl = exports.normalizeCacheUrl = exports.DEFAULT_CONFIDENCE_THRESHOLD = exports.DEFAULT_FRESHNESS_MS = exports.DESIGN_CONTEXT_SCHEMA_VERSION = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("../../utils/logger");
+const log = (0, logger_1.createLogger)('DesignContextStore');
+/**
+ * Runtime user cache for inspiration-link design context. Persists generated
+ * designmd markdown plus safe metadata so future MCP
+ * `create_zero_to_one_project` requests with the same web link can reuse
+ * prior extraction by default. Treated as runtime user data — never mutates
+ * the bundled `src/services/templates/designmd` catalog.
+ *
+ * Path layout (local filesystem implementation):
+ *   <directory>/<sha256(normalizedUrl)>.json
+ *
+ * The default <directory> is `~/.rivet/design-context-cache/`. The store
+ * abstraction is interface-first so future hosted/server deployments can
+ * provide a durable backend (HTTPS, KV, SQL) without changing the
+ * extraction or MCP orchestration logic.
+ */
+/**
+ * Output/extractor schema version. Bump when the cache entry shape or the
+ * generated markdown structure changes incompatibly. Cached entries with a
+ * different schema version are not silently reused — they regenerate.
+ */
+exports.DESIGN_CONTEXT_SCHEMA_VERSION = '2';
+/**
+ * Default freshness window for a cached entry. Entries older than this are
+ * marked `stale` and trigger regeneration by default. Tunable per call so
+ * tests can exercise the stale branch without sleeping.
+ */
+exports.DEFAULT_FRESHNESS_MS = 14 * 24 * 60 * 60 * 1000;
+/**
+ * Default confidence threshold below which cached entries are considered
+ * low-confidence and trigger regeneration. Mirrors the in-extractor
+ * `LOW_SIGNAL_THRESHOLD` so cached and live signals stay aligned.
+ */
+exports.DEFAULT_CONFIDENCE_THRESHOLD = 18;
+/**
+ * Match prompts that explicitly request fresh/latest/current/regenerated
+ * design context for an inspiration link. Matches are evaluated against the
+ * raw user prompt — callers MUST keep the prompt out of telemetry payloads.
+ *
+ * The bare adjectives `fresh`/`latest`/`current` are intentionally NOT
+ * matched on their own because they collide with common project-description
+ * phrasing (e.g. "build a fresh landing page", "use the latest design
+ * patterns", "based on the current site") that does not actually request a
+ * cache bypass. They only match when paired with a cache- or
+ * extraction-bearing noun. Verbs like `re-extract`, `refresh`, and
+ * `bypass cache` are unambiguous on their own.
+ */
+const CACHE_BYPASS_NOUNS = 'extract(?:ion)?|fetch|context|data|copy|signals?|markdown|version|run|pull|scrape|grab|snapshot|content|html|cache|design\\s+context';
+const FRESH_INTENT_PATTERNS = [
+    new RegExp(`\\bfresh(?:est)?\\s+(?:${CACHE_BYPASS_NOUNS})\\b`, 'i'),
+    new RegExp(`\\blatest\\s+(?:${CACHE_BYPASS_NOUNS})\\b`, 'i'),
+    new RegExp(`\\bcurrent\\s+(?:${CACHE_BYPASS_NOUNS})\\b`, 'i'),
+    /\bup[-\s]?to[-\s]?date\s+(?:extract(?:ion)?|fetch|context|data|copy|signals?|markdown|version|cache|design\s+context)\b/i,
+    /\bre[-\s]?extract\b/i,
+    /\bre[-\s]?fetch\b/i,
+    /\bre[-\s]?generate\b/i,
+    /\brefresh\b/i,
+    /\bbypass\s+cache\b/i,
+    /\bno[-\s]?cache\b/i,
+];
+/**
+ * Normalize an HTTP/HTTPS URL for cache keying. Lowercases scheme and host,
+ * strips default ports and fragments, and preserves meaningful path/query
+ * so two pages with the same host but different paths or query strings
+ * keep separate cache entries. Returns `undefined` for inputs that are not
+ * parseable HTTP/HTTPS URLs.
+ */
+const normalizeCacheUrl = (rawUrl) => {
+    const trimmed = rawUrl.trim();
+    if (!trimmed)
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        return undefined;
+    }
+    parsed.hostname = parsed.hostname.toLowerCase();
+    if ((parsed.protocol === 'http:' && parsed.port === '80') ||
+        (parsed.protocol === 'https:' && parsed.port === '443')) {
+        parsed.port = '';
+    }
+    parsed.hash = '';
+    return parsed.toString();
+};
+exports.normalizeCacheUrl = normalizeCacheUrl;
+/**
+ * Compute a stable cache key from a normalized URL. SHA-256 hashed to hex
+ * so the resulting key is filesystem-safe and does not embed proprietary
+ * URL content in the filename layer.
+ */
+const cacheKeyForUrl = (rawUrl) => {
+    const normalized = (0, exports.normalizeCacheUrl)(rawUrl);
+    if (!normalized)
+        return undefined;
+    return crypto_1.default.createHash('sha256').update(normalized).digest('hex');
+};
+exports.cacheKeyForUrl = cacheKeyForUrl;
+/**
+ * Coarse age bucket for safe telemetry. Maps a wall-clock age in
+ * milliseconds onto a small fixed bucket name so analytics never receive
+ * exact timestamps.
+ */
+const ageBucketFor = (ageMs) => {
+    if (ageMs < 60 * 60 * 1000)
+        return 'lt_1h';
+    if (ageMs < 24 * 60 * 60 * 1000)
+        return '1h_24h';
+    if (ageMs < 7 * 24 * 60 * 60 * 1000)
+        return '1d_7d';
+    if (ageMs < 30 * 24 * 60 * 60 * 1000)
+        return '7d_30d';
+    return 'gt_30d';
+};
+exports.ageBucketFor = ageBucketFor;
+/**
+ * Coarse confidence bucket for safe telemetry. Three buckets keyed off the
+ * extractor signal density score so reuse outcomes can be aggregated
+ * without leaking specific confidence values.
+ */
+const confidenceBucketFor = (confidence) => {
+    if (confidence < exports.DEFAULT_CONFIDENCE_THRESHOLD)
+        return 'low';
+    if (confidence < 60)
+        return 'medium';
+    return 'high';
+};
+exports.confidenceBucketFor = confidenceBucketFor;
+/**
+ * Return true when the user prompt explicitly asks for fresh/latest/
+ * current design context. Used by the MCP flow to bypass cache reuse even
+ * when a compatible entry exists.
+ */
+const promptRequestsFreshExtraction = (prompt) => FRESH_INTENT_PATTERNS.some((pattern) => pattern.test(prompt));
+exports.promptRequestsFreshExtraction = promptRequestsFreshExtraction;
+/**
+ * Decide whether a cached entry is reusable for a request, factoring in
+ * extractor/schema version, freshness window, confidence threshold, and
+ * any explicit user request for fresh extraction. Callers MUST honour the
+ * decision — the store itself never silently reuses incompatible entries.
+ */
+const canReuseCacheEntry = (entry, options) => {
+    const now = options.now ?? Date.now();
+    const freshnessMs = options.freshnessMs ?? exports.DEFAULT_FRESHNESS_MS;
+    const schemaVersion = options.schemaVersion ?? exports.DESIGN_CONTEXT_SCHEMA_VERSION;
+    const confidenceThreshold = options.confidenceThreshold ?? exports.DEFAULT_CONFIDENCE_THRESHOLD;
+    const ageMs = Math.max(0, now - entry.metadata.createdAtMs);
+    const freshness = ageMs <= freshnessMs ? 'fresh' : 'stale';
+    if (options.forceRefresh) {
+        return { reuse: false, reason: 'forced_refresh', freshness, ageMs };
+    }
+    if (entry.metadata.schemaVersion !== schemaVersion) {
+        return { reuse: false, reason: 'version_mismatch', freshness, ageMs };
+    }
+    if (freshness === 'stale') {
+        return { reuse: false, reason: 'stale', freshness, ageMs };
+    }
+    if (entry.metadata.confidence < confidenceThreshold) {
+        return { reuse: false, reason: 'low_confidence', freshness, ageMs };
+    }
+    return { reuse: true, freshness, ageMs };
+};
+exports.canReuseCacheEntry = canReuseCacheEntry;
+const ALLOWED_KEY_PATTERN = /^[a-f0-9]{64}$/;
+/**
+ * Filesystem-backed `DesignContextStore`. One JSON file per cache key under
+ * a per-user cache directory. Safe to delete the entire directory without
+ * affecting bundled catalog data or compiled application code.
+ *
+ * Read/write failures degrade gracefully — get returns undefined on any
+ * parse/IO error so the MCP flow falls through to a fresh extraction
+ * instead of crashing the user request.
+ */
+class FileDesignContextStore {
+    directory;
+    dirReady = false;
+    constructor(options = {}) {
+        this.directory =
+            options.directory ?? path_1.default.join(os_1.default.homedir(), '.rivet', 'design-context-cache');
+    }
+    /**
+     * Resolve a cache key to its on-disk file path. Rejects keys that do not
+     * match the expected sha256 hex shape so a malformed key cannot escape
+     * the cache directory.
+     */
+    resolvePath(cacheKey) {
+        if (!ALLOWED_KEY_PATTERN.test(cacheKey))
+            return undefined;
+        return path_1.default.join(this.directory, `${cacheKey}.json`);
+    }
+    async get(cacheKey) {
+        const target = this.resolvePath(cacheKey);
+        if (!target)
+            return undefined;
+        try {
+            const raw = await fs_1.default.promises.readFile(target, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (!isCacheEntry(parsed)) {
+                log.debug(`Discarding malformed cache entry at ${cacheKey}.`);
+                return undefined;
+            }
+            return parsed;
+        }
+        catch (error) {
+            if (error &&
+                typeof error === 'object' &&
+                'code' in error &&
+                error.code === 'ENOENT') {
+                return undefined;
+            }
+            log.debug(`Failed to read cache entry ${cacheKey}: ${String(error)}`);
+            return undefined;
+        }
+    }
+    async put(entry) {
+        const target = this.resolvePath(entry.metadata.cacheKey);
+        if (!target) {
+            log.warn('Refusing to write cache entry with invalid cache key shape.');
+            return;
+        }
+        const tmp = `${target}.${crypto_1.default.randomBytes(4).toString('hex')}.tmp`;
+        try {
+            if (!this.dirReady) {
+                await fs_1.default.promises.mkdir(this.directory, {
+                    recursive: true,
+                    mode: 0o700,
+                });
+                this.dirReady = true;
+            }
+            await fs_1.default.promises.writeFile(tmp, JSON.stringify(entry), {
+                encoding: 'utf8',
+                mode: 0o600,
+            });
+            await fs_1.default.promises.rename(tmp, target);
+        }
+        catch (error) {
+            log.debug(`Failed to write cache entry: ${String(error)}`);
+            try {
+                await fs_1.default.promises.unlink(tmp);
+            }
+            catch {
+                // best-effort cleanup
+            }
+        }
+    }
+}
+exports.FileDesignContextStore = FileDesignContextStore;
+/**
+ * Runtime guard so corrupted or third-party-tampered cache files cannot
+ * inject arbitrary fields into the MCP flow.
+ */
+const isCacheEntry = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const record = value;
+    const metadata = record.metadata;
+    if (!metadata || typeof metadata !== 'object')
+        return false;
+    if (typeof metadata.cacheKey !== 'string')
+        return false;
+    if (typeof metadata.schemaVersion !== 'string')
+        return false;
+    if (typeof metadata.createdAtMs !== 'number')
+        return false;
+    if (typeof metadata.lastUsedAtMs !== 'number')
+        return false;
+    if (typeof metadata.confidence !== 'number')
+        return false;
+    if (!Array.isArray(metadata.warningCodes))
+        return false;
+    if (typeof record.markdown !== 'string')
+        return false;
+    if (typeof record.label !== 'string')
+        return false;
+    const signals = record.signals;
+    if (!signals || typeof signals !== 'object')
+        return false;
+    return true;
+};
+//# sourceMappingURL=designContextStore.js.map

package/dist/mcp/agent-variants/designContextStore.js.map

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

package/dist/mcp/agent-variants/elementRefToTarget.d.ts

@@ -0,0 +1,21 @@
+import type { ElementRef } from '../../types/change-request-types';
+import type { Target } from './contracts';
+/**
+ * Map a comment's ElementRef to a single `propose_variants` target.
+ *
+ * Rules (first non-empty wins, no concatenation):
+ *  1. `rivetId` → `{ type: 'element', ref: '[data-rivet-id="<id>"]' }`
+ *  2. `id` (no whitespace) → `{ type: 'element', ref: '#<id>' }`
+ *  3. `xpath` → `{ type: 'element', ref: '<xpath>' }`
+ *  4. `className` (single dominant token) → `{ type: 'element', ref: '.<token>' }`
+ *
+ * If `element.filePaths.length === 1`, prefer `{ type: 'file', ref: filePaths[0] }`
+ * for refinement scope. The original ElementRef selector should still appear
+ * verbatim in the LLM brief prompt — callers are responsible for that.
+ *
+ * Returns null when none of the four rules produce a usable ref. Callers should
+ * surface a structured error to the user rather than calling propose_variants
+ * with a fabricated target.
+ */
+export declare const elementRefToTarget: (ref: ElementRef) => Target | null;
+//# sourceMappingURL=elementRefToTarget.d.ts.map

package/dist/mcp/agent-variants/elementRefToTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementRefToTarget.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/elementRefToTarget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,UAAU,KAAG,MAAM,GAAG,IA6B7D,CAAC"}

package/dist/mcp/agent-variants/elementRefToTarget.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.elementRefToTarget = void 0;
+/**
+ * Map a comment's ElementRef to a single `propose_variants` target.
+ *
+ * Rules (first non-empty wins, no concatenation):
+ *  1. `rivetId` → `{ type: 'element', ref: '[data-rivet-id="<id>"]' }`
+ *  2. `id` (no whitespace) → `{ type: 'element', ref: '#<id>' }`
+ *  3. `xpath` → `{ type: 'element', ref: '<xpath>' }`
+ *  4. `className` (single dominant token) → `{ type: 'element', ref: '.<token>' }`
+ *
+ * If `element.filePaths.length === 1`, prefer `{ type: 'file', ref: filePaths[0] }`
+ * for refinement scope. The original ElementRef selector should still appear
+ * verbatim in the LLM brief prompt — callers are responsible for that.
+ *
+ * Returns null when none of the four rules produce a usable ref. Callers should
+ * surface a structured error to the user rather than calling propose_variants
+ * with a fabricated target.
+ */
+const elementRefToTarget = (ref) => {
+    if (ref.filePaths.length === 1 && ref.filePaths[0]) {
+        return { type: 'file', ref: ref.filePaths[0] };
+    }
+    const rivetId = ref.rivetId?.trim();
+    if (rivetId) {
+        return { type: 'element', ref: `[data-rivet-id="${rivetId}"]` };
+    }
+    const id = ref.id?.trim();
+    if (id && !/\s/.test(id)) {
+        return { type: 'element', ref: `#${id}` };
+    }
+    const xpath = ref.xpath?.trim();
+    if (xpath) {
+        return { type: 'element', ref: xpath };
+    }
+    const className = ref.className?.trim();
+    if (className) {
+        const tokens = className.split(/\s+/).filter(Boolean);
+        if (tokens.length === 1) {
+            return { type: 'element', ref: `.${tokens[0]}` };
+        }
+    }
+    return null;
+};
+exports.elementRefToTarget = elementRefToTarget;
+//# sourceMappingURL=elementRefToTarget.js.map

package/dist/mcp/agent-variants/elementRefToTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementRefToTarget.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/elementRefToTarget.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,kBAAkB,GAAG,CAAC,GAAe,EAAiB,EAAE;IACnE,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,mBAAmB,OAAO,IAAI,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAChC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AA7BW,QAAA,kBAAkB,sBA6B7B"}

package/dist/mcp/agent-variants/errors.d.ts

@@ -1,4 +1,4 @@
-export declare const ERROR_CODES: readonly ["INVALID_STAGE_ACTION", "INVALID_TRANSITION", "MISSING_REQUIRED_INPUT", "STALE_LEASE", "LEASE_EXPIRED", "LEASE_MISMATCH", "PENDING_CHANGE_CONFLICT", "SCHEMA_VALIDATION_FAILED", "RUNTIME_VALIDATION_FAILED", "CLEANUP_TIMEOUT", "DEPENDENCY_FAILED", "SESSION_NOT_FOUND", "WORK_ITEM_NOT_FOUND"];
+export declare const ERROR_CODES: readonly ["INVALID_STAGE_ACTION", "INVALID_TRANSITION", "MISSING_REQUIRED_INPUT", "STALE_LEASE", "LEASE_EXPIRED", "LEASE_MISMATCH", "PENDING_CHANGE_CONFLICT", "SCHEMA_VALIDATION_FAILED", "RUNTIME_VALIDATION_FAILED", "CLEANUP_TIMEOUT", "DEPENDENCY_FAILED", "SESSION_NOT_FOUND", "WORK_ITEM_NOT_FOUND", "UNSUPPORTED_FRAMEWORK", "UNKNOWN_DESIGN_SYSTEM", "DESTINATION_NOT_EMPTY", "SCAFFOLD_FAILED", "SOURCE_CONTEXT_INVALID", "SOURCE_CONTEXT_TOO_LARGE", "VARIANT_QA_FAILED"];
 export type ErrorCode = (typeof ERROR_CODES)[number];
 export declare class AgentVariantsError extends Error {
     readonly code: ErrorCode;

package/dist/mcp/agent-variants/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,6SAcd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;CAM7C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,sdAqBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;CAM7C"}

package/dist/mcp/agent-variants/errors.js

@@ -15,6 +15,13 @@ exports.ERROR_CODES = [
     'DEPENDENCY_FAILED',
     'SESSION_NOT_FOUND',
     'WORK_ITEM_NOT_FOUND',
+    'UNSUPPORTED_FRAMEWORK',
+    'UNKNOWN_DESIGN_SYSTEM',
+    'DESTINATION_NOT_EMPTY',
+    'SCAFFOLD_FAILED',
+    'SOURCE_CONTEXT_INVALID',
+    'SOURCE_CONTEXT_TOO_LARGE',
+    'VARIANT_QA_FAILED',
 ];
 class AgentVariantsError extends Error {
     code;

package/dist/mcp/agent-variants/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/errors.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACzB,sBAAsB;IACtB,oBAAoB;IACpB,wBAAwB;IACxB,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,yBAAyB;IACzB,0BAA0B;IAC1B,2BAA2B;IAC3B,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,qBAAqB;CACb,CAAC;AAIX,MAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAY;IAChB,MAAM,CAAS;IAExB,YAAY,IAAe,EAAE,OAAe;QAC1C,KAAK,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAVD,gDAUC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/errors.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACzB,sBAAsB;IACtB,oBAAoB;IACpB,wBAAwB;IACxB,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,yBAAyB;IACzB,0BAA0B;IAC1B,2BAA2B;IAC3B,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,qBAAqB;IACrB,uBAAuB;IACvB,uBAAuB;IACvB,uBAAuB;IACvB,iBAAiB;IACjB,wBAAwB;IACxB,0BAA0B;IAC1B,mBAAmB;CACX,CAAC;AAIX,MAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAY;IAChB,MAAM,CAAS;IAExB,YAAY,IAAe,EAAE,OAAe;QAC1C,KAAK,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAVD,gDAUC"}

package/dist/mcp/agent-variants/index.d.ts

@@ -4,8 +4,10 @@ export { PendingChangesAdapter } from './pendingChangesAdapter';
 export type { AdapterTelemetry, BridgeChangeIntent, BridgeQueue, } from './pendingChangesAdapter';
 export { AgentVariantsOrchestrator } from './WorktreeOrchestrator';
 export type { OrchestratorDeps, ProjectEnvironment, WorktreeManagerLike, } from './WorktreeOrchestrator';
-export { registerAgentVariantsTools } from './tools';
+export { registerAgentVariantsTools, slugifyPrompt } from './tools';
+export { registerCreateZeroToOneTool } from './createZeroToOneTool';
 export type { ToolDeps } from './tools';
 export { AgentVariantsError, ERROR_CODES, type ErrorCode } from './errors';
-export type { Brief, CancelVariantsInput, CancelVariantsOutput, ContinueVariantsInput, ContinueVariantsOutput, LeaseRecord, LeasedWorkItemDescriptor, ProjectContext, ProposeVariantsInput, ProposeVariantsOutput, ReportVariantBriefsInput, ReportVariantBriefsOutput, ReportVariantCompleteInput, ReportVariantCompleteOutput, Stage, Target, TerminalSummary, VariantPickEnvelope, VariantPickPayload, WorkItem, WorkItemKind, WorkItemStatus, } from './contracts';
+export { VARIANT_COUNT_MIN, VARIANT_COUNT_MAX } from './contracts';
+export type { Brief, CancelVariantsInput, CancelVariantsOutput, ContinueVariantsInput, ContinueVariantsOutput, ExtractInspirationContextInput, ExtractInspirationContextOutput, LeaseRecord, LeasedWorkItemDescriptor, ProjectContext, ProposeVariantsInput, ProposeVariantsOutput, ReportVariantBriefsInput, ReportVariantBriefsOutput, ReportSourcePlanInput, ReportSourcePlanOutput, ReportVariantCompleteInput, ReportVariantCompleteOutput, SourceContextArtifact, SourceContextInput, SourcePlanArtifact, SourcePlanWorkItemDescriptor, Stage, Target, TerminalSummary, VariantPickEnvelope, VariantPickPayload, VisualEditorAttachment, WorkItem, WorkItemKind, WorkItemStatus, } from './contracts';
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/agent-variants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC3E,YAAY,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,EACL,MAAM,EACN,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,EAC/B,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,4BAA4B,EAC5B,KAAK,EACL,MAAM,EACN,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/mcp/agent-variants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ERROR_CODES = exports.AgentVariantsError = exports.registerAgentVariantsTools = exports.AgentVariantsOrchestrator = exports.PendingChangesAdapter = exports.SessionStore = void 0;
+exports.VARIANT_COUNT_MAX = exports.VARIANT_COUNT_MIN = exports.ERROR_CODES = exports.AgentVariantsError = exports.registerCreateZeroToOneTool = exports.slugifyPrompt = exports.registerAgentVariantsTools = exports.AgentVariantsOrchestrator = exports.PendingChangesAdapter = exports.SessionStore = void 0;
 var SessionStore_1 = require("./SessionStore");
 Object.defineProperty(exports, "SessionStore", { enumerable: true, get: function () { return SessionStore_1.SessionStore; } });
 var pendingChangesAdapter_1 = require("./pendingChangesAdapter");
@@ -9,7 +9,13 @@ var WorktreeOrchestrator_1 = require("./WorktreeOrchestrator");
 Object.defineProperty(exports, "AgentVariantsOrchestrator", { enumerable: true, get: function () { return WorktreeOrchestrator_1.AgentVariantsOrchestrator; } });
 var tools_1 = require("./tools");
 Object.defineProperty(exports, "registerAgentVariantsTools", { enumerable: true, get: function () { return tools_1.registerAgentVariantsTools; } });
+Object.defineProperty(exports, "slugifyPrompt", { enumerable: true, get: function () { return tools_1.slugifyPrompt; } });
+var createZeroToOneTool_1 = require("./createZeroToOneTool");
+Object.defineProperty(exports, "registerCreateZeroToOneTool", { enumerable: true, get: function () { return createZeroToOneTool_1.registerCreateZeroToOneTool; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AgentVariantsError", { enumerable: true, get: function () { return errors_1.AgentVariantsError; } });
 Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return errors_1.ERROR_CODES; } });
+var contracts_1 = require("./contracts");
+Object.defineProperty(exports, "VARIANT_COUNT_MIN", { enumerable: true, get: function () { return contracts_1.VARIANT_COUNT_MIN; } });
+Object.defineProperty(exports, "VARIANT_COUNT_MAX", { enumerable: true, get: function () { return contracts_1.VARIANT_COUNT_MAX; } });
 //# sourceMappingURL=index.js.map

package/dist/mcp/agent-variants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAUrB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAM9B,+DAAmE;AAA1D,iIAAA,yBAAyB,OAAA;AAMlC,iCAAqD;AAA5C,mHAAA,0BAA0B,OAAA;AAEnC,mCAA2E;AAAlE,4GAAA,kBAAkB,OAAA;AAAE,qGAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/agent-variants/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAUrB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAM9B,+DAAmE;AAA1D,iIAAA,yBAAyB,OAAA;AAMlC,iCAAoE;AAA3D,mHAAA,0BAA0B,OAAA;AAAE,sGAAA,aAAa,OAAA;AAClD,6DAAoE;AAA3D,kIAAA,2BAA2B,OAAA;AAEpC,mCAA2E;AAAlE,4GAAA,kBAAkB,OAAA;AAAE,qGAAA,WAAW,OAAA;AACxC,yCAAmE;AAA1D,8GAAA,iBAAiB,OAAA;AAAE,8GAAA,iBAAiB,OAAA"}