@codeyam/codeyam-cli 0.1.0-staging.ad88eeb → 0.1.0-staging.b6c4c78

package/codeyam-cli/src/utils/routePatternMatching.js

@@ -0,0 +1,129 @@
+/**
+ * Route pattern matching utilities for mapping URLs to page files.
+ *
+ * These are pure functions with no Node.js dependencies — safe to import
+ * from browser-bundled code.
+ */
+/**
+ * Convert a page file path to its URL route pattern.
+ *
+ * Examples:
+ *   'app/page.tsx'                    → '/'
+ *   'app/feedback/[id]/page.tsx'      → '/feedback/[id]'
+ *   'app/(tabs)/settings/page.tsx'    → '/settings'
+ *   'app/tea/[id].tsx'                → '/tea/[id]'   (Expo Router)
+ */
+export function buildRoutePattern(pageFilePath) {
+    // Non-route files (e.g., src/App.tsx, src/popup/App.tsx) are app entry
+    // points used as pageFilePath for non-Next.js apps. They represent the
+    // root route since they're not file-based routing pages.
+    if (!pageFilePath.startsWith('app/') && !pageFilePath.startsWith('(')) {
+        return '/';
+    }
+    // Remove 'app/' prefix
+    const rest = pageFilePath.replace(/^app\//, '');
+    // Determine the file name and extract the route prefix
+    const parts = rest.split('/');
+    const fileName = parts.pop();
+    // For page.tsx/page.js — the route is the directory path
+    // For index.tsx — the route is the directory path (Expo Router root)
+    // For named files like add-tea.tsx — the file base name is a segment
+    const ext = fileName.match(/\.(tsx?|jsx?|js)$/)?.[0] || '';
+    const baseName = fileName.slice(0, -ext.length);
+    let segments;
+    if (baseName === 'page') {
+        segments = parts;
+    }
+    else if (baseName === 'index') {
+        segments = parts;
+    }
+    else {
+        // Named route file (Expo Router): settings.tsx → /settings
+        segments = [...parts, baseName];
+    }
+    // Strip route groups like (tabs), (auth)
+    segments = segments.filter((seg) => !seg.startsWith('('));
+    if (segments.length === 0)
+        return '/';
+    return '/' + segments.join('/');
+}
+/**
+ * Generate a human-readable display name from a route pattern.
+ *
+ * Examples:
+ *   '/'                  → 'Home'
+ *   '/about'             → 'About'
+ *   '/feedback/[id]'     → 'Feedback / [id]'
+ *   '/feedback/[id]/edit' → 'Feedback / [id] / Edit'
+ */
+export function routeDisplayName(routePattern) {
+    if (routePattern === '/')
+        return 'Home';
+    const segments = routePattern.replace(/^\//, '').split('/');
+    return segments
+        .map((seg) => {
+        // Don't capitalize dynamic segments like [id]
+        if (seg.startsWith('['))
+            return seg;
+        return seg.charAt(0).toUpperCase() + seg.slice(1);
+    })
+        .join(' / ');
+}
+/**
+ * Match a concrete URL to the page file that handles it.
+ *
+ * Uses Next.js-style routing rules:
+ * - Static segments must match exactly
+ * - Dynamic segments ([id], [slug]) match any single segment
+ * - Static matches are preferred over dynamic matches
+ * - Query parameters are stripped before matching
+ *
+ * Returns the matched file path, or null if no match.
+ */
+export function matchUrlToPageFile(url, pageFiles) {
+    if (!url)
+        return null;
+    // Strip query params and trailing slash
+    const cleanUrl = url.split('?')[0].replace(/\/+$/, '') || '/';
+    // Build route patterns for all page files
+    const routes = pageFiles.map((filePath) => ({
+        filePath,
+        pattern: buildRoutePattern(filePath),
+    }));
+    // Parse the URL into segments
+    const urlSegments = cleanUrl === '/' ? [] : cleanUrl.replace(/^\//, '').split('/');
+    let bestMatch = null;
+    let bestScore = -1;
+    for (const route of routes) {
+        const patternSegments = route.pattern === '/' ? [] : route.pattern.replace(/^\//, '').split('/');
+        // Must have same number of segments
+        if (patternSegments.length !== urlSegments.length)
+            continue;
+        // Score the match: count static (exact) segment matches
+        let matched = true;
+        let staticMatches = 0;
+        for (let i = 0; i < patternSegments.length; i++) {
+            const pat = patternSegments[i];
+            const seg = urlSegments[i];
+            if (pat.startsWith('[') && pat.endsWith(']')) {
+                // Dynamic segment — matches anything
+                continue;
+            }
+            else if (pat === seg) {
+                // Static exact match
+                staticMatches++;
+            }
+            else {
+                // No match
+                matched = false;
+                break;
+            }
+        }
+        if (matched && staticMatches > bestScore) {
+            bestScore = staticMatches;
+            bestMatch = route.filePath;
+        }
+    }
+    return bestMatch;
+}
+//# sourceMappingURL=routePatternMatching.js.map

package/codeyam-cli/src/utils/routePatternMatching.js.map

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

package/codeyam-cli/src/utils/scenarioCoverage.js

@@ -0,0 +1,74 @@
+import { scenarioEntityName } from "./entityChangeStatus.js";
+/**
+ * Classify scenarios as stale or fresh based on when they were captured
+ * relative to when the current feature started.
+ *
+ * A scenario is "stale" if:
+ * - It belongs to a page entity that is new/edited/impacted
+ * - It was captured BEFORE the current feature started
+ *
+ * A page is "uncovered" if:
+ * - It has a new/edited/impacted entity
+ * - It has NO scenarios at all (not even stale ones)
+ */
+export function classifyScenarioCoverage(scenarios, entityChangeStatus, pageEntityNames, featureStartedAt) {
+    // Convert ISO timestamp to SQLite format for comparison
+    const featureTs = featureStartedAt
+        ? featureStartedAt.replace('T', ' ').replace(/\.\d{3}Z$/, '')
+        : null;
+    const staleScenarios = [];
+    const freshScenarios = [];
+    const coveredPageEntities = new Set();
+    for (const row of scenarios) {
+        // Determine entity name for this scenario, preferring pageFilePath
+        // for precise route-based identity over lossy URL-derived names.
+        const entityName = scenarioEntityName({
+            componentName: row.component_name,
+            pageFilePath: row.page_file_path,
+            url: row.url,
+        });
+        if (!entityName)
+            continue;
+        const status = entityChangeStatus[entityName];
+        if (!status)
+            continue; // Entity not changed — not relevant
+        // Only audit page/app scenarios, not component isolation scenarios
+        if (row.component_name)
+            continue;
+        const createdAt = row.created_at || '';
+        const isFresh = featureTs ? createdAt >= featureTs : true;
+        if (isFresh) {
+            freshScenarios.push({
+                name: row.name,
+                url: row.url,
+                entityName,
+            });
+            coveredPageEntities.add(entityName);
+        }
+        else {
+            staleScenarios.push({
+                name: row.name,
+                url: row.url,
+                entityName,
+                changeStatus: status.status,
+                lastCaptured: createdAt,
+            });
+        }
+    }
+    // Find pages with changes but zero scenarios
+    const uncoveredPages = [];
+    for (const [entityName, status] of Object.entries(entityChangeStatus)) {
+        if (!pageEntityNames.has(entityName))
+            continue; // Only pages
+        if (coveredPageEntities.has(entityName))
+            continue; // Has fresh scenarios
+        // Check if it has ANY scenario (even stale)
+        const hasStale = staleScenarios.some((s) => s.entityName === entityName);
+        if (!hasStale) {
+            uncoveredPages.push({ entityName, changeStatus: status.status });
+        }
+    }
+    const pass = staleScenarios.length === 0 && uncoveredPages.length === 0;
+    return { staleScenarios, freshScenarios, uncoveredPages, pass };
+}
+//# sourceMappingURL=scenarioCoverage.js.map

package/codeyam-cli/src/utils/scenarioCoverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarioCoverage.js","sourceRoot":"","sources":["../../../../src/utils/scenarioCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAoC1D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAwB,EACxB,kBAA6E,EAC7E,eAA4B,EAC5B,gBAA+B;IAE/B,wDAAwD;IACxD,MAAM,SAAS,GAAG,gBAAgB;QAChC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7D,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,cAAc,GAAoB,EAAE,CAAC;IAC3C,MAAM,cAAc,GAAoB,EAAE,CAAC;IAC3C,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,mEAAmE;QACnE,iEAAiE;QACjE,MAAM,UAAU,GAAG,kBAAkB,CAAC;YACpC,aAAa,EAAE,GAAG,CAAC,cAAc;YACjC,YAAY,EAAE,GAAG,CAAC,cAAc;YAChC,GAAG,EAAE,GAAG,CAAC,GAAG;SACb,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,SAAS,CAAC,oCAAoC;QAE3D,mEAAmE;QACnE,IAAI,GAAG,CAAC,cAAc;YAAE,SAAS;QAEjC,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAE1D,IAAI,OAAO,EAAE,CAAC;YACZ,cAAc,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,UAAU;aACX,CAAC,CAAC;YACH,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,UAAU;gBACV,YAAY,EAAE,MAAM,CAAC,MAAM;gBAC3B,YAAY,EAAE,SAAS;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,cAAc,GAAoB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS,CAAC,aAAa;QAC7D,IAAI,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS,CAAC,sBAAsB;QACzE,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,cAAc,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;IAExE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/codeyam-cli/src/utils/scenariosManifest.js

@@ -1,105 +1,237 @@
 import * as fs from 'fs';
 import * as path from 'path';
-function manifestPath(codeyamRoot) {
-    return path.join(codeyamRoot, '.codeyam', 'scenarios-manifest.json');
+import { resolveViewportWithProjectDefault } from "./editorScenarios.js";
+/**
+ * Scan .codeyam/editor-scenarios/ for scenario files with embedded _metadata.
+ * Returns an array of { id, metadata } for each file that has _metadata.
+ */
+export function scanScenarioFiles(codeyamRoot) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    let files;
+    try {
+        files = fs.readdirSync(scenariosDir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const file of files) {
+        // Only process {uuid}.json files, skip .seed.json and subdirectories
+        if (!file.endsWith('.json') || file.endsWith('.seed.json'))
+            continue;
+        if (file === 'client-errors.json')
+            continue;
+        const filePath = path.join(scenariosDir, file);
+        try {
+            const stat = fs.statSync(filePath);
+            if (!stat.isFile())
+                continue;
+            const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            if (content._metadata) {
+                const id = file.replace(/\.json$/, '');
+                results.push({ id, metadata: content._metadata });
+            }
+        }
+        catch {
+            // Skip unparseable files
+        }
+    }
+    return results;
 }
-export function readManifest(codeyamRoot) {
-    const p = manifestPath(codeyamRoot);
+/**
+ * Write or update _metadata in a scenario data file.
+ * Preserves all existing data in the file, only adds/updates the _metadata key.
+ */
+export function writeScenarioMetadata(codeyamRoot, scenarioId, metadata) {
+    const filePath = path.join(codeyamRoot, '.codeyam', 'editor-scenarios', `${scenarioId}.json`);
+    let existing = {};
     try {
-        const content = fs.readFileSync(p, 'utf8');
-        return JSON.parse(content);
+        existing = JSON.parse(fs.readFileSync(filePath, 'utf8'));
     }
     catch {
-        return null;
+        // File doesn't exist yet — will be created by the caller
+        return;
     }
+    existing._metadata = metadata;
+    fs.writeFileSync(filePath, JSON.stringify(existing, null, 2), 'utf8');
 }
-export function writeManifest(codeyamRoot, manifest) {
-    const p = manifestPath(codeyamRoot);
-    const dir = path.dirname(p);
-    fs.mkdirSync(dir, { recursive: true });
-    fs.writeFileSync(p, JSON.stringify(manifest, null, 2), 'utf8');
+/**
+ * Backfill _metadata into scenario files that don't have it yet.
+ * Uses database rows as the source of truth for metadata.
+ * Returns the number of files updated.
+ */
+export function backfillScenarioMetadata(codeyamRoot, dbRows) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    let updated = 0;
+    for (const row of dbRows) {
+        const filePath = path.join(scenariosDir, `${row.id}.json`);
+        try {
+            const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+            if (content._metadata)
+                continue; // Already has metadata
+            const r = row;
+            content._metadata = {
+                name: row.name,
+                description: row.description,
+                componentName: row.component_name,
+                componentPath: row.component_path,
+                url: row.url,
+                type: row.type,
+                screenshotPath: row.screenshot_path ?? null,
+                viewportWidth: row.viewport_width ?? null,
+                viewportHeight: row.viewport_height ?? null,
+                dimension: r.dimension ?? null,
+                dimensions: r.dimensions ? JSON.parse(r.dimensions) : null,
+                screenshotPaths: r.screenshot_paths
+                    ? JSON.parse(r.screenshot_paths)
+                    : null,
+                pageFilePath: r.page_file_path ?? null,
+                createdAt: row.created_at,
+                updatedAt: row.updated_at,
+            };
+            fs.writeFileSync(filePath, JSON.stringify(content, null, 2), 'utf8');
+            updated++;
+        }
+        catch {
+            // File doesn't exist or isn't valid JSON — skip
+        }
+    }
+    return updated;
 }
-export function addScenarioToManifest(codeyamRoot, entry) {
-    const manifest = readManifest(codeyamRoot) || {
-        version: 1,
-        updatedAt: '',
-        scenarios: [],
-    };
-    // Dedup by id — replace if exists
-    const existing = manifest.scenarios.findIndex((s) => s.id === entry.id);
-    if (existing >= 0) {
-        manifest.scenarios[existing] = entry;
+/**
+ * Migrate scenario files with bad/legacy formats to the current format.
+ *
+ * Fixes:
+ * 1. Null viewport → resolved via dimension name / project default / 1280×720 fallback
+ * 2. Missing `dimensions` array → wrapped from single `dimension` string
+ * 3. Missing `screenshotPaths` map → built from single `screenshotPath` + dimension name
+ *
+ * This runs during editor startup to repair files created before viewport
+ * resolution was mandatory and before multi-dimension support was added.
+ * It is idempotent — files already in the correct format are skipped.
+ */
+export function migrateScenarioFormats(codeyamRoot) {
+    const entries = scanScenarioFiles(codeyamRoot);
+    if (entries.length === 0) {
+        return { scanned: 0, fixed: 0 };
     }
-    else {
-        manifest.scenarios.push(entry);
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    let fixed = 0;
+    for (const { id, metadata } of entries) {
+        let needsWrite = false;
+        const updated = { ...metadata };
+        // Fix 1: Null viewport → resolve from dimension / project default / fallback
+        if (!updated.viewportWidth || !updated.viewportHeight) {
+            const resolved = resolveViewportWithProjectDefault({
+                dimension: updated.dimension ?? undefined,
+                codeyamRoot,
+            });
+            updated.viewportWidth = resolved.width;
+            updated.viewportHeight = resolved.height;
+            needsWrite = true;
+        }
+        // Fix 2: Missing dimensions array → wrap single dimension
+        if (!updated.dimensions && updated.dimension) {
+            updated.dimensions = [updated.dimension];
+            needsWrite = true;
+        }
+        // Fix 3: Missing screenshotPaths map → build from single screenshotPath
+        if (!updated.screenshotPaths &&
+            updated.screenshotPath &&
+            updated.dimension) {
+            updated.screenshotPaths = { [updated.dimension]: updated.screenshotPath };
+            needsWrite = true;
+        }
+        if (needsWrite) {
+            // Bump updatedAt so the next syncScenarioFilesToDatabase picks up the fix
+            updated.updatedAt = new Date().toISOString();
+            const filePath = path.join(scenariosDir, `${id}.json`);
+            try {
+                const content = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+                content._metadata = updated;
+                fs.writeFileSync(filePath, JSON.stringify(content, null, 2), 'utf8');
+                fixed++;
+            }
+            catch {
+                // Non-fatal — skip files that can't be read/written
+            }
+        }
     }
-    manifest.updatedAt = new Date().toISOString();
-    writeManifest(codeyamRoot, manifest);
-}
-export function removeScenarioFromManifest(codeyamRoot, id) {
-    const manifest = readManifest(codeyamRoot);
-    if (!manifest)
-        return;
-    manifest.scenarios = manifest.scenarios.filter((s) => s.id !== id);
-    manifest.updatedAt = new Date().toISOString();
-    writeManifest(codeyamRoot, manifest);
+    return { scanned: entries.length, fixed };
 }
-export function buildManifestFromRows(rows) {
-    return {
-        version: 1,
-        updatedAt: new Date().toISOString(),
-        scenarios: rows.map((row) => ({
-            id: row.id,
-            name: row.name,
-            description: row.description ?? null,
-            componentName: row.component_name ?? null,
-            componentPath: row.component_path ?? null,
-            url: row.url ?? null,
-            mockDataFile: `editor-scenarios/${row.id}.json`,
-            screenshotFile: row.screenshot_path
-                ? `editor-scenarios/${row.screenshot_path}`
-                : null,
-            createdAt: row.created_at,
-            updatedAt: row.updated_at,
-        })),
-    };
+/**
+ * Remove a scenario data file (and its .seed.json if present).
+ */
+export function deleteScenarioFiles(codeyamRoot, scenarioId) {
+    const scenariosDir = path.join(codeyamRoot, '.codeyam', 'editor-scenarios');
+    for (const suffix of ['.json', '.seed.json']) {
+        const filePath = path.join(scenariosDir, `${scenarioId}${suffix}`);
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch {
+            // File might not exist
+        }
+    }
 }
 /**
- * Sync manifest entries to database.
- * Uses callbacks for insert/update to decouple from the actual DB layer.
+ * Sync scenario files (with _metadata) to database.
+ * Scans the editor-scenarios/ directory for files with embedded _metadata.
  */
-export async function syncManifestToDatabase(codeyamRoot, projectId, existingRows, onInsert, onUpdate) {
-    const manifest = readManifest(codeyamRoot);
-    if (!manifest) {
+export async function syncScenarioFilesToDatabase(codeyamRoot, projectId, existingRows, onInsert, onUpdate) {
+    const entries = scanScenarioFiles(codeyamRoot);
+    if (entries.length === 0) {
         return { inserted: 0, updated: 0, skipped: 0 };
     }
     const existingMap = new Map(existingRows.map((r) => [r.id, r.updated_at]));
     let inserted = 0;
     let updated = 0;
     let skipped = 0;
-    for (const entry of manifest.scenarios) {
-        const existingUpdatedAt = existingMap.get(entry.id);
+    for (const { id, metadata } of entries) {
+        const existingUpdatedAt = existingMap.get(id);
         if (existingUpdatedAt === undefined) {
-            // Not in DB — insert
             await onInsert({
-                id: entry.id,
+                id,
                 project_id: projectId,
-                name: entry.name,
-                description: entry.description,
-                component_name: entry.componentName,
-                component_path: entry.componentPath,
-                url: entry.url,
+                name: metadata.name,
+                description: metadata.description,
+                component_name: metadata.componentName,
+                component_path: metadata.componentPath,
+                url: metadata.url,
+                type: metadata.type,
+                screenshot_path: metadata.screenshotPath,
+                viewport_width: metadata.viewportWidth,
+                viewport_height: metadata.viewportHeight,
+                dimension: metadata.dimension ?? null,
+                dimensions: metadata.dimensions
+                    ? JSON.stringify(metadata.dimensions)
+                    : null,
+                screenshot_paths: metadata.screenshotPaths
+                    ? JSON.stringify(metadata.screenshotPaths)
+                    : null,
+                page_file_path: metadata.pageFilePath ?? null,
             });
             inserted++;
         }
-        else if (entry.updatedAt > existingUpdatedAt) {
-            // Manifest is newer — update
-            await onUpdate(entry.id, {
-                name: entry.name,
-                description: entry.description,
-                component_name: entry.componentName,
-                component_path: entry.componentPath,
-                url: entry.url,
+        else if (metadata.updatedAt > existingUpdatedAt) {
+            await onUpdate(id, {
+                name: metadata.name,
+                description: metadata.description,
+                component_name: metadata.componentName,
+                component_path: metadata.componentPath,
+                url: metadata.url,
+                type: metadata.type,
+                screenshot_path: metadata.screenshotPath,
+                viewport_width: metadata.viewportWidth,
+                viewport_height: metadata.viewportHeight,
+                dimension: metadata.dimension ?? null,
+                dimensions: metadata.dimensions
+                    ? JSON.stringify(metadata.dimensions)
+                    : null,
+                screenshot_paths: metadata.screenshotPaths
+                    ? JSON.stringify(metadata.screenshotPaths)
+                    : null,
+                page_file_path: metadata.pageFilePath ?? null,
             });
             updated++;
         }

package/codeyam-cli/src/utils/scenariosManifest.js.map

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

package/codeyam-cli/src/utils/serverState.js

@@ -178,4 +178,34 @@ export function killServer() {
     waitForProcessExit(pidsToWait);
     return killedAny;
 }
+/**
+ * Find an available port starting from `startPort`.
+ * Uses step=10 to leave room for proxy (+1) and dev server (+2) on adjacent ports.
+ * The `isPortFree` callback should return true when no process is listening on the port.
+ */
+export function findFreePort(startPort, isPortFree, step = 10, maxAttempts = 10) {
+    if (isPortFree(startPort))
+        return startPort;
+    for (let i = 1; i <= maxAttempts; i++) {
+        const port = startPort + i * step;
+        if (isPortFree(port))
+            return port;
+    }
+    throw new Error(`Could not find a free port starting from ${startPort} (tried ${maxAttempts} candidates)`);
+}
+/**
+ * Check if a port is free (no process listening on it).
+ */
+export function checkPortFree(port) {
+    try {
+        execSync(`lsof -ti:${port}`, {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return false; // lsof found something — port is in use
+    }
+    catch {
+        return true; // lsof failed — port is free
+    }
+}
 //# sourceMappingURL=serverState.js.map

package/codeyam-cli/src/utils/serverState.js.map

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

package/codeyam-cli/src/utils/setupClaudeCodeSettings.js

@@ -75,6 +75,7 @@ export function setupClaudeCodeSettings(projectRoot, options) {
             'Bash(python3:*)',
             'Bash(cat:*)',
             'Bash(printf:*)',
+            'Bash(ls:*)',
         ];
         // Editor permissions — git ops and skill for dev mode (editor mode only)
         const editorExtraPermissions = [