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

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

@@ -45,12 +45,69 @@ export function detectPackageManagerAndScript(projectRoot) {
     }
     return { command, args };
 }
+/**
+ * Resolve the start command for the dev server.
+ * Reads the webapp's startCommand from .codeyam/config.json if available,
+ * falls back to detectPackageManagerAndScript otherwise.
+ * Substitutes $PORT in args and env values, and always provides PORT in env.
+ */
+export function resolveStartCommand(projectRoot, port) {
+    const portStr = port.toString();
+    const env = { PORT: portStr };
+    // Try to read startCommand from config
+    const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+    if (fs.existsSync(configPath)) {
+        try {
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            const webapps = config.webapps || [];
+            const webapp = webapps[0];
+            if (webapp?.startCommand) {
+                const { command, args: rawArgs, env: cmdEnv } = webapp.startCommand;
+                // Substitute $PORT in args
+                const args = (rawArgs || []).map((arg) => arg.includes('$PORT') ? arg.replace(/\$PORT/g, portStr) : arg);
+                // Substitute $PORT in env values
+                if (cmdEnv) {
+                    for (const [key, value] of Object.entries(cmdEnv)) {
+                        if (typeof value === 'string' && value.includes('$PORT')) {
+                            env[key] = value.replace(/\$PORT/g, portStr);
+                        }
+                        else if (typeof value === 'string') {
+                            env[key] = value;
+                        }
+                    }
+                }
+                return { command, args, env };
+            }
+        }
+        catch {
+            // Fall through to detection
+        }
+    }
+    // Fall back to auto-detection
+    const pmResult = detectPackageManagerAndScript(projectRoot);
+    if ('error' in pmResult) {
+        return pmResult;
+    }
+    return { command: pmResult.command, args: pmResult.args, env };
+}
+/**
+ * Compute the port assignments for the editor proxy and dev server.
+ * Proxy sits at codeyamPort+1 (where the preview iframe connects).
+ * Dev server sits at codeyamPort+2 (behind the proxy).
+ */
+export function computeEditorPorts(codeyamPort) {
+    return {
+        proxyPort: codeyamPort + 1,
+        devServerPort: codeyamPort + 2,
+    };
+}
 /** URL patterns matched in dev server output to detect the running URL. */
 const URL_PATTERNS = [
     /Local:\s+(https?:\/\/[^\s]+)/, // Vite
     /Ready on\s+(https?:\/\/[^\s]+)/i, // Next.js
     /started at\s+(https?:\/\/[^\s]+)/i, // Remix
     /listening on\s+(https?:\/\/[^\s]+)/i, // Generic
+    /waiting on\s+(https?:\/\/[^\s]+)/i, // Expo
     /http:\/\/localhost:\d+/, // Bare URL
 ];
 /**
@@ -75,6 +132,44 @@ export function extractDevServerUrl(text) {
 export function stripAnsiCodes(text) {
     return text.replace(/\x1b\[[0-9;]*m/g, '');
 }
+/**
+ * Read the dev server URL from the global state shared with api.editor-dev-server.
+ * Returns the URL when the dev server is running, null otherwise.
+ */
+export function getEditorDevServerUrl() {
+    const server = globalThis.__codeyam_editor_dev_server__;
+    if (server && server.status === 'running' && server.url) {
+        return server.url;
+    }
+    return null;
+}
+/**
+ * Poll a port to detect if a dev server is responding.
+ * Used as a fallback when stdout-based URL detection doesn't trigger.
+ * Returns the URL if the server responds, null otherwise.
+ */
+export async function pollForDevServer(port, options = {}) {
+    const { intervalMs = 2000, maxAttempts = 15 } = options;
+    const url = `http://localhost:${port}`;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        try {
+            const response = await fetch(url, {
+                method: 'HEAD',
+                signal: AbortSignal.timeout(2000),
+            });
+            if (response.ok || response.status === 304) {
+                return url;
+            }
+        }
+        catch {
+            // Server not ready yet
+        }
+        if (attempt < maxAttempts - 1) {
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+    }
+    return null;
+}
 /**
  * Determine what action to take when the dev server process exits.
  *
@@ -83,7 +178,7 @@ export function stripAnsiCodes(text) {
  * - Zero or null exit → stopped normally
  */
 export function determineProcessExitState(params) {
-    const { exitCode, uptime, retryCount } = params;
+    const { exitCode, uptime, retryCount, wasRunning } = params;
     const quickFailure = uptime < 10000;
     if (exitCode !== 0 && exitCode !== null && quickFailure && retryCount === 0) {
         return { action: 'retry' };
@@ -91,6 +186,10 @@ export function determineProcessExitState(params) {
     else if (exitCode !== 0 && exitCode !== null) {
         return { action: 'error' };
     }
+    else if (wasRunning === false) {
+        // Process exited cleanly (code 0 or null) but never started serving
+        return { action: 'error' };
+    }
     else {
         return { action: 'stopped' };
     }

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Orchestration wrapper for computing entity change status in the editor.
+ *
+ * Combines: detectFirstFeature + getGitStatusForProject + buildChangedFilesMap +
+ * scanPageFilePaths + initializeEnvironment + loadEntities +
+ * buildEntityInfosFromScenarios + buildEntityInfosFromGlossary + computeEntityChangeStatus
+ *
+ * Previously duplicated across editor.tsx, api.editor-scenarios.ts, and
+ * api.editor-journal-entry.ts (~80 lines each).
+ */
+import { getGitStatusForProject } from "../webserver/app/lib/git.js";
+import { initializeEnvironment } from "./database.js";
+import { loadEntities } from "../../../packages/database/index.js";
+import { detectFirstFeature, scanPageFilePaths, } from "./entityChangeStatus.server.js";
+import { buildChangedFilesMap, buildEntityInfosFromScenarios, buildEntityInfosFromGlossary, computeEntityChangeStatus, } from "./entityChangeStatus.js";
+export async function computeEntityChangeStatusForEditor(params) {
+    const { projectRoot, scenarioInputs, glossaryInputs } = params;
+    const { map: pageFilePaths } = scanPageFilePaths(projectRoot);
+    const pageEntityNames = new Set(Object.keys(pageFilePaths));
+    const gitFiles = getGitStatusForProject();
+    if (gitFiles.length === 0) {
+        return { entityChangeStatus: {}, pageEntityNames };
+    }
+    const isFirstFeature = detectFirstFeature(projectRoot);
+    const changedFiles = buildChangedFilesMap(gitFiles, isFirstFeature);
+    let entitiesWithMetadata = [];
+    try {
+        await initializeEnvironment();
+        entitiesWithMetadata = (await loadEntities({})) || [];
+    }
+    catch {
+        // Non-fatal — just won't have importedBy data
+    }
+    const scenarioEntityInfos = buildEntityInfosFromScenarios(scenarioInputs, pageFilePaths, entitiesWithMetadata);
+    let entityInfos = scenarioEntityInfos;
+    if (glossaryInputs && glossaryInputs.length > 0) {
+        const scenarioNames = new Set(scenarioEntityInfos.map((e) => e.name));
+        const glossaryEntityInfos = buildEntityInfosFromGlossary(glossaryInputs, scenarioNames);
+        entityInfos = [...scenarioEntityInfos, ...glossaryEntityInfos];
+    }
+    const entityChangeStatus = computeEntityChangeStatus(changedFiles, entityInfos);
+    return { entityChangeStatus, pageEntityNames };
+}
+//# sourceMappingURL=editorEntityChangeStatus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editorEntityChangeStatus.js","sourceRoot":"","sources":["../../../../src/utils/editorEntityChangeStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,4BAA4B,EAC5B,yBAAyB,GAI1B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,kCAAkC,CAAC,MAIxD;IAIC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAC/D,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,cAAc,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEpE,IAAI,oBAAoB,GAAU,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,qBAAqB,EAAE,CAAC;QAC9B,oBAAoB,GAAG,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;IAED,MAAM,mBAAmB,GAAG,6BAA6B,CACvD,cAAc,EACd,aAAa,EACb,oBAAoB,CACrB,CAAC;IAEF,IAAI,WAAW,GAAG,mBAAmB,CAAC;IAEtC,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,mBAAmB,GAAG,4BAA4B,CACtD,cAAc,EACd,aAAa,CACd,CAAC;QACF,WAAW,GAAG,CAAC,GAAG,mBAAmB,EAAE,GAAG,mBAAmB,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,kBAAkB,GAAG,yBAAyB,CAClD,YAAY,EACZ,WAAW,CACZ,CAAC;IACF,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,129 @@
+/**
+ * Pure helper functions for editor entity operations.
+ *
+ * Extracted from EditorAppTab and editor.entity.($sha).tsx for testability.
+ * No React dependencies — these are plain data transformations.
+ */
+import { pageNameFromUrl, isIsolationUrl } from "./entityChangeStatus.js";
+import { buildRoutePattern, routeDisplayName } from "./routePatternMatching.js";
+/**
+ * Group scenarios into page groups and component groups.
+ * Page group names come from scenario.displayName (DB) with fallbacks.
+ */
+export function groupScenarios(scenarios) {
+    const pages = new Map();
+    const components = new Map();
+    for (const scenario of scenarios) {
+        if (scenario.componentName) {
+            const existing = components.get(scenario.componentName) || [];
+            existing.push(scenario);
+            components.set(scenario.componentName, existing);
+        }
+        else if (isIsolationUrl(scenario.url)) {
+            const match = scenario.url?.match(/[?&]c=([^&]+)/);
+            const compName = match ? decodeURIComponent(match[1]) : 'Isolated';
+            const existing = components.get(compName) || [];
+            existing.push(scenario);
+            components.set(compName, existing);
+        }
+        else {
+            const pageName = scenario.displayName ||
+                (scenario.pageFilePath?.startsWith('app/')
+                    ? routeDisplayName(buildRoutePattern(scenario.pageFilePath))
+                    : pageNameFromUrl(scenario.url));
+            const existing = pages.get(pageName) || [];
+            existing.push(scenario);
+            pages.set(pageName, existing);
+        }
+    }
+    const sorted = new Map([...components.entries()].sort(([a], [b]) => a.localeCompare(b)));
+    return { pageGroups: pages, componentGroups: sorted };
+}
+/**
+ * Build a map from group display name → entity SHA.
+ * Reads entitySha directly from scenarios — no entity table joins.
+ */
+export function buildEntityShaMap(pageGroups, componentGroups) {
+    const map = new Map();
+    for (const [groupName, groupScenarios] of pageGroups) {
+        const sha = groupScenarios.find((s) => s.entitySha)?.entitySha;
+        if (sha)
+            map.set(groupName, sha);
+    }
+    for (const [groupName, groupScenarios] of componentGroups) {
+        const sha = groupScenarios.find((s) => s.entitySha)?.entitySha;
+        if (sha)
+            map.set(groupName, sha);
+    }
+    return map;
+}
+/**
+ * Check if an entity SHA represents a fully analyzed entity.
+ */
+export function isEntityComplete(sha, analyzedShas, allEntities, entityNamesWithImports) {
+    if (analyzedShas.has(sha))
+        return true;
+    const entity = allEntities.find((e) => e.sha === sha);
+    return entity ? entityNamesWithImports.has(entity.name) : false;
+}
+/**
+ * Find entities that are missing or incomplete across all groups.
+ */
+export function findBrokenEntities(pageGroups, componentGroups, entityShaMap, isComplete) {
+    const broken = [];
+    for (const [groupName, groupScenarios] of pageGroups) {
+        const sha = entityShaMap.get(groupName);
+        if (!sha) {
+            broken.push({
+                name: groupName,
+                scenarios: groupScenarios,
+                reason: 'missing',
+            });
+        }
+        else if (!isComplete(sha)) {
+            broken.push({
+                name: groupName,
+                scenarios: groupScenarios,
+                reason: 'incomplete',
+            });
+        }
+    }
+    for (const [groupName, groupScenarios] of componentGroups) {
+        const sha = entityShaMap.get(groupName);
+        if (!sha) {
+            broken.push({
+                name: groupName,
+                scenarios: groupScenarios,
+                reason: 'missing',
+            });
+        }
+        else if (!isComplete(sha)) {
+            broken.push({
+                name: groupName,
+                scenarios: groupScenarios,
+                reason: 'incomplete',
+            });
+        }
+    }
+    return broken;
+}
+/**
+ * Resolve a focused entity from a SHA using client-side data.
+ * No server round-trip — uses already-loaded entities and scenarios.
+ */
+export function resolveClientFocusedEntity(sha, allEntities, allScenarios) {
+    if (!sha)
+        return null;
+    const entity = allEntities.find((e) => e.sha === sha);
+    if (!entity)
+        return null;
+    const scenario = allScenarios.find((s) => s.entitySha === sha);
+    return {
+        sha,
+        name: entity.name,
+        filePath: entity.filePath,
+        entityType: entity.entityType,
+        displayName: scenario?.displayName || entity.name,
+    };
+}
+//# sourceMappingURL=editorEntityHelpers.js.map

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

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

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

@@ -0,0 +1,155 @@
+/**
+ * Extract and verify image URLs from HTML pages.
+ *
+ * Used by `codeyam editor verify-images` to deterministically check
+ * that all image references in rendered pages return HTTP 200.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Extract all image URLs from an HTML string.
+ *
+ * Finds URLs from:
+ * 1. <img src="..."> attributes
+ * 2. <img srcset="..."> attributes
+ * 3. URLs in inline JSON/script data that look like image references
+ *    (common image hosts, or URLs ending in image extensions)
+ */
+export function extractImageUrls(html) {
+    const urls = new Set();
+    // 1. <img src="...">
+    const srcRegex = /<img\b[^>]*\bsrc=["']([^"']+)["'][^>]*>/gi;
+    let match;
+    while ((match = srcRegex.exec(html)) !== null) {
+        const url = match[1].trim();
+        if (url && !url.startsWith('data:')) {
+            urls.add(url);
+        }
+    }
+    // 2. <img srcset="...">
+    const srcsetRegex = /<img\b[^>]*\bsrcset=["']([^"']+)["'][^>]*>/gi;
+    while ((match = srcsetRegex.exec(html)) !== null) {
+        const srcset = match[1];
+        // srcset format: "url1 1x, url2 2x" or "url1 300w, url2 600w"
+        for (const entry of srcset.split(',')) {
+            const url = entry.trim().split(/\s+/)[0];
+            if (url && !url.startsWith('data:')) {
+                urls.add(url);
+            }
+        }
+    }
+    // 3. URLs in JSON/inline data — match quoted URLs that are likely images
+    // Covers: known image hosts (unsplash, pravatar, etc.) and URLs with image extensions
+    const IMAGE_EXTENSIONS = /\.(jpg|jpeg|png|gif|svg|webp|avif|ico)(\?[^"']*)?$/i;
+    const IMAGE_HOSTS = /\b(unsplash\.com|pravatar\.cc|cloudinary\.com|imgix\.net|imgur\.com)\b/i;
+    const jsonUrlRegex = /"(https?:\/\/[^"]+)"/g;
+    while ((match = jsonUrlRegex.exec(html)) !== null) {
+        const url = match[1];
+        if (!urls.has(url) &&
+            (IMAGE_EXTENSIONS.test(url) || IMAGE_HOSTS.test(url))) {
+            urls.add(url);
+        }
+    }
+    return [...urls];
+}
+/**
+ * Resolve a potentially relative image URL against a base URL.
+ */
+export function resolveImageUrl(url, baseUrl) {
+    if (url.startsWith('http://') || url.startsWith('https://')) {
+        return url;
+    }
+    if (url.startsWith('//')) {
+        const protocol = new URL(baseUrl).protocol;
+        return `${protocol}${url}`;
+    }
+    const base = new URL(baseUrl);
+    if (url.startsWith('/')) {
+        return `${base.origin}${url}`;
+    }
+    // Relative path — resolve against base origin
+    return `${base.origin}/${url}`;
+}
+/**
+ * Parse the JSON argument for verify-images into paths and explicit image URLs.
+ * Claude can pass known image URLs directly via `imageUrls` so they get verified
+ * without needing to be discoverable in HTML or scenario files.
+ *
+ * Example: `{"paths":["/"], "imageUrls":["https://images.unsplash.com/photo-123"]}`
+ */
+export function parseVerifyImagesInput(jsonArg) {
+    if (!jsonArg)
+        return { paths: ['/'], imageUrls: [] };
+    const parsed = JSON.parse(jsonArg);
+    const paths = Array.isArray(parsed.paths) && parsed.paths.length > 0
+        ? parsed.paths
+        : ['/'];
+    const imageUrls = Array.isArray(parsed.imageUrls) ? parsed.imageUrls : [];
+    return { paths, imageUrls };
+}
+/**
+ * Build a structured report from image verification results.
+ */
+export function buildVerifyImagesReport(input) {
+    const failures = input.results
+        .filter((r) => !r.ok)
+        .map((f) => ({ url: f.url, status: f.status, error: f.error }));
+    const report = {
+        pagesChecked: input.pagesChecked,
+        imagesFound: input.imageUrls.length,
+        imagesVerified: input.results.filter((r) => r.ok).length,
+        failures,
+    };
+    if (input.scenarioFilesScanned !== undefined) {
+        report.scenarioFilesScanned = input.scenarioFilesScanned;
+    }
+    return report;
+}
+/**
+ * Extract image URLs from scenario mock data files (`.codeyam/editor-scenarios/*.json`).
+ *
+ * Client-rendered pages load image URLs from mock API data at runtime,
+ * so these URLs are invisible to the HTML-only scan. This function reads
+ * the raw JSON text and reuses `extractImageUrls()` to find them.
+ */
+export function extractImageUrlsFromScenarioFiles(scenariosDir) {
+    if (!fs.existsSync(scenariosDir)) {
+        return { urls: [], filesScanned: 0 };
+    }
+    const allUrls = new Set();
+    let filesScanned = 0;
+    const entries = fs.readdirSync(scenariosDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory() || !entry.name.endsWith('.json')) {
+            continue;
+        }
+        const content = fs.readFileSync(path.join(scenariosDir, entry.name), 'utf-8');
+        for (const url of extractImageUrls(content)) {
+            allUrls.add(url);
+        }
+        filesScanned++;
+    }
+    return { urls: [...allUrls], filesScanned };
+}
+/**
+ * Verify that each URL returns HTTP 200.
+ */
+export async function verifyImageUrls(urls) {
+    const results = [];
+    for (const url of urls) {
+        try {
+            const res = await fetch(url, { method: 'HEAD' });
+            results.push({ url, status: res.status, ok: res.ok });
+        }
+        catch (err) {
+            results.push({
+                url,
+                status: null,
+                ok: false,
+                error: err.message,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=editorImageVerifier.js.map

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

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

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

@@ -4,6 +4,68 @@
  * Extracted from inline logic in EditorJournal.tsx, api.editor-journal-entry.ts,
  * and api.editor-journal-update.ts.
  */
+/**
+ * Compute a timeframe summary from journal entries.
+ *
+ * Filters entries to those within the given period (relative to `now`),
+ * counts unique commits, and builds per-scenario screenshot timelines
+ * grouped into app-level vs component-level.
+ *
+ * @param entries - Journal entries (unfiltered)
+ * @param period - Time window: '1d', '3d', '7d', or '30d'
+ * @param now - Reference date (defaults to current time; injectable for testing)
+ */
+export function computeTimeframeSummary(entries, period, now = new Date()) {
+    const days = { '1d': 1, '3d': 3, '7d': 7, '30d': 30 }[period];
+    const cutoff = new Date(now);
+    cutoff.setDate(cutoff.getDate() - days);
+    const cutoffDate = cutoff.toISOString().split('T')[0];
+    const filtered = entries.filter((e) => e.date >= cutoffDate);
+    // Count unique commits
+    const commitShas = new Set(filtered.map((e) => e.commitSha).filter(Boolean));
+    // Collect all scenario screenshots with timestamps, deduplicate by path
+    const scenarioMap = new Map();
+    for (const entry of filtered) {
+        if (entry.scenarioScreenshots) {
+            for (const ss of entry.scenarioScreenshots) {
+                if (!scenarioMap.has(ss.name)) {
+                    scenarioMap.set(ss.name, []);
+                }
+                const existing = scenarioMap.get(ss.name);
+                if (!existing.some((e) => e.path === ss.path)) {
+                    existing.push({ path: ss.path, time: entry.time });
+                }
+            }
+        }
+    }
+    // Sort each scenario's screenshots by time
+    for (const screenshots of scenarioMap.values()) {
+        screenshots.sort((a, b) => a.time.localeCompare(b.time));
+    }
+    // Group into app vs component (same logic as groupScreenshotsByComponent)
+    const appScenarios = [];
+    const componentGroups = new Map();
+    for (const [name, screenshots] of scenarioMap) {
+        const dashIdx = name.indexOf(' - ');
+        if (dashIdx !== -1) {
+            const componentName = name.slice(0, dashIdx);
+            if (!componentGroups.has(componentName)) {
+                componentGroups.set(componentName, []);
+            }
+            componentGroups.get(componentName).push({ name, screenshots });
+        }
+        else {
+            appScenarios.push({ name, screenshots });
+        }
+    }
+    return {
+        commitCount: commitShas.size,
+        entryCount: filtered.length,
+        appScenarios,
+        componentGroups,
+        totalScenarios: scenarioMap.size,
+    };
+}
 /**
  * Group journal entries by date, reversing so newest entries come first.
  * Returns a Map preserving insertion order (newest date first).
@@ -19,14 +81,27 @@ export function groupEntriesByDate(entries) {
 }
 /**
  * Group scenario screenshots by component name.
- * Names with " - " are split on the first dash; names without are grouped as "App".
+ * Uses the `componentName` field when available (preferred — matches Results Panel).
+ * Falls back to parsing the name at " - " for backward compatibility.
+ * Screenshots without a componentName are grouped as "App".
  * Sorted with "App" first, then alphabetical.
  */
 export function groupScreenshotsByComponent(screenshots) {
     const groups = new Map();
     for (const ss of screenshots) {
-        const dashIdx = ss.name.indexOf(' - ');
-        const group = dashIdx !== -1 ? ss.name.slice(0, dashIdx) : 'App';
+        let group;
+        if ('componentName' in ss && ss.componentName) {
+            group = ss.componentName;
+        }
+        else if ('componentName' in ss && ss.componentName === null) {
+            // Explicitly null — this is an application scenario
+            group = 'App';
+        }
+        else {
+            // Legacy fallback: parse name
+            const dashIdx = ss.name.indexOf(' - ');
+            group = dashIdx !== -1 ? ss.name.slice(0, dashIdx) : 'App';
+        }
         const existing = groups.get(group) || [];
         existing.push(ss);
         groups.set(group, existing);
@@ -56,7 +131,7 @@ export function generateJournalScreenshotFilename(name, timestamp) {
  * Returns the joined string ready to append to a daily markdown file.
  */
 export function buildJournalMarkdown(params) {
-    const { title, timeStr, type, description, allScenarioNames, screenshot, scenarioScreenshots, commitSha, commitMessage, } = params;
+    const { title, timeStr, type, description, allScenarioNames, screenshot, scenarioScreenshots, commitSha, commitMessage, featureName, userPrompt, } = params;
     const mdLines = [
         '',
         '---',
@@ -65,6 +140,12 @@ export function buildJournalMarkdown(params) {
         `**Time:** ${timeStr}`,
         `**Type:** ${type}`,
     ];
+    if (featureName) {
+        mdLines.push(`**Feature:** ${featureName}`);
+    }
+    if (userPrompt) {
+        mdLines.push(`**Prompt:** ${userPrompt}`);
+    }
     if (allScenarioNames.length > 0) {
         mdLines.push(`**Scenarios:** ${allScenarioNames.join(', ')}`);
     }
@@ -96,6 +177,13 @@ export function buildJournalMarkdown(params) {
 export function findJournalEntryByTime(entries, time) {
     return entries.findIndex((e) => e.time === time);
 }
+/**
+ * Check if a journal entry has already been committed.
+ * Once committed (commitSha is set), the entry is frozen and should not be updated.
+ */
+export function isJournalEntryCommitted(entry) {
+    return !!entry.commitSha;
+}
 /**
  * Apply non-undefined updates to a journal entry.
  * Returns the mutated entry (same reference).