@codeyam/codeyam-cli 0.1.0-staging.b8a55ba → 0.1.0-staging.b8b17a5

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

@@ -0,0 +1,40 @@
+import { EventEmitter } from 'events';
+/**
+ * Shared event emitter for dev mode file sync events.
+ * The InteractiveSyncWatcher emits events to this, and the
+ * SSE endpoint (api.dev-mode-events.ts) streams them to the browser.
+ *
+ * Uses a global variable to ensure the CLI's job runner and the Vite SSR
+ * webserver routes share the exact same singleton instance, even though
+ * they're compiled by different bundlers.
+ */
+class DevModeEventEmitter extends EventEmitter {
+    constructor() {
+        super();
+        this.setMaxListeners(20);
+    }
+    emitFileSynced(fileName, filePath) {
+        this.emit('event', {
+            type: 'file-synced',
+            fileName,
+            filePath,
+            timestamp: Date.now(),
+        });
+    }
+    emitError(fileName, filePath) {
+        this.emit('event', {
+            type: 'sync-error',
+            fileName,
+            filePath,
+            timestamp: Date.now(),
+        });
+    }
+}
+// Use a global singleton to ensure the same instance is shared between
+// the CLI's TypeScript compilation and Vite's SSR compilation
+const GLOBAL_KEY = '__codeyam_dev_mode_event_emitter__';
+if (!globalThis[GLOBAL_KEY]) {
+    globalThis[GLOBAL_KEY] = new DevModeEventEmitter();
+}
+export const devModeEventEmitter = globalThis[GLOBAL_KEY];
+//# sourceMappingURL=devModeEvents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devModeEvents.js","sourceRoot":"","sources":["../../../../src/utils/devModeEvents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,mBAAoB,SAAQ,YAAY;IAC5C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,QAAgB;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,aAAa;YACnB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,QAAgB;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;YACjB,IAAI,EAAE,YAAY;YAClB,QAAQ;YACR,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AAED,uEAAuE;AACvE,8DAA8D;AAC9D,MAAM,UAAU,GAAG,oCAAoC,CAAC;AACxD,IAAI,CAAE,UAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;IACpC,UAAkB,CAAC,UAAU,CAAC,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAyB,UAAkB,CACzE,UAAU,CACX,CAAC"}

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

@@ -0,0 +1,71 @@
+/**
+ * Pure state transition logic for the editor dev server.
+ *
+ * Extracted from the inline polling effect in editor.tsx so the
+ * state machine can be unit-tested without React or network concerns.
+ */
+/**
+ * Given the current dev server state and an API poll response, compute
+ * the next state. This is a pure function with no side effects.
+ */
+export function computeDevServerTransition(current, response) {
+    if (response.status === 'error') {
+        return {
+            url: null,
+            proxyUrl: null,
+            isStarting: false,
+            error: response.errorMessage || 'Dev server crashed',
+            canStartServer: current.canStartServer,
+            autoStartAttempted: current.autoStartAttempted,
+            shouldAutoStart: false,
+        };
+    }
+    if (response.url) {
+        return {
+            url: response.url,
+            proxyUrl: response.proxyUrl || null,
+            isStarting: false,
+            error: null,
+            canStartServer: true,
+            autoStartAttempted: current.autoStartAttempted,
+            shouldAutoStart: false,
+        };
+    }
+    if (response.status === 'starting') {
+        return {
+            ...current,
+            isStarting: true,
+            error: null,
+            canStartServer: true,
+            shouldAutoStart: false,
+        };
+    }
+    if (response.status === 'stopped') {
+        if (current.url) {
+            // Server was running but now stopped unexpectedly
+            return {
+                ...current,
+                url: null,
+                isStarting: false,
+                shouldAutoStart: false,
+            };
+        }
+        if (!current.autoStartAttempted) {
+            // First load with no server running — signal auto-start
+            return {
+                ...current,
+                autoStartAttempted: true,
+                shouldAutoStart: true,
+            };
+        }
+        // Already attempted — ensure spinner is off
+        return {
+            ...current,
+            isStarting: false,
+            shouldAutoStart: false,
+        };
+    }
+    // Unknown status — no changes
+    return { ...current, shouldAutoStart: false };
+}
+//# sourceMappingURL=devServerState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devServerState.js","sourceRoot":"","sources":["../../../../src/utils/devServerState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB,EACvB,QAA8B;IAE9B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,QAAQ,CAAC,YAAY,IAAI,oBAAoB;YACpD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,OAAO;YACL,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;YACnC,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,kDAAkD;YAClD,OAAO;gBACL,GAAG,OAAO;gBACV,GAAG,EAAE,IAAI;gBACT,UAAU,EAAE,KAAK;gBACjB,eAAe,EAAE,KAAK;aACvB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAChC,wDAAwD;YACxD,OAAO;gBACL,GAAG,OAAO;gBACV,kBAAkB,EAAE,IAAI;gBACxB,eAAe,EAAE,IAAI;aACtB,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,OAAO,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,79 @@
+/**
+ * Editor API request builder.
+ *
+ * Maps editor subcommand names + optional JSON args to API request descriptors.
+ * Used by `codeyam editor <subcommand>` to avoid raw curl calls,
+ * which lets Claude Code auto-approve these operations.
+ */
+const SUBCOMMAND_MAP = {
+    preview: (jsonArg) => {
+        const body = jsonArg ? JSON.parse(jsonArg) : undefined;
+        if (!body?.dimension) {
+            throw new Error('"dimension" is required for preview. Every preview call must specify the viewport dimension explicitly, e.g. \'{"dimension":"Desktop"}\'');
+        }
+        return {
+            method: 'POST',
+            endpoint: '/api/dev-mode-preview',
+            body,
+        };
+    },
+    'show-results': () => ({
+        method: 'POST',
+        endpoint: '/api/editor-show-results',
+    }),
+    'hide-results': () => ({
+        method: 'POST',
+        endpoint: '/api/editor-hide-results',
+    }),
+    commit: (jsonArg) => ({
+        method: 'POST',
+        endpoint: '/api/editor-commit',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    journal: (jsonArg) => ({
+        method: 'POST',
+        endpoint: '/api/editor-journal-entry',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'journal-update': (jsonArg) => ({
+        method: 'PATCH',
+        endpoint: '/api/editor-journal-update',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'dev-server': (jsonArg) => ({
+        method: jsonArg ? 'POST' : 'GET',
+        endpoint: '/api/editor-dev-server',
+        ...(jsonArg ? { body: JSON.parse(jsonArg) } : {}),
+    }),
+    'journal-list': () => ({
+        method: 'GET',
+        endpoint: '/api/editor-journal',
+    }),
+    'client-errors': () => ({
+        method: 'GET',
+        endpoint: '/api/editor-client-errors',
+    }),
+};
+export function buildEditorApiRequest(subcommand, jsonArg) {
+    const builder = SUBCOMMAND_MAP[subcommand];
+    if (!builder) {
+        throw new Error(`Unknown editor subcommand: ${subcommand}`);
+    }
+    return builder(jsonArg);
+}
+/**
+ * Execute an editor API request against the local server.
+ */
+export async function callEditorApi(request, port) {
+    const url = `http://localhost:${port}${request.endpoint}`;
+    const options = { method: request.method };
+    if (request.body) {
+        options.headers = { 'Content-Type': 'application/json' };
+        options.body = JSON.stringify(request.body);
+    }
+    const res = await fetch(url, options);
+    const data = await res.json().catch(() => null);
+    return { ok: res.ok, status: res.status, data };
+}
+export const EDITOR_API_SUBCOMMANDS = Object.keys(SUBCOMMAND_MAP);
+//# sourceMappingURL=editorApi.js.map

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

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

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

@@ -0,0 +1,388 @@
+/**
+ * Pure logic for `codeyam editor audit` — zero I/O, fully testable.
+ *
+ * Cross-references glossary entries against registered scenarios (components)
+ * and test files (functions) to detect gaps Claude may have missed.
+ */
+// ─── Logic ───────────────────────────────────────────────────────────
+const COMPONENT_RETURN_PATTERNS = ['JSX', 'React', 'Element', 'ReactNode'];
+/**
+ * Returns true when the entry's returnType indicates a React component
+ * (contains "JSX", "React", "Element", or "ReactNode").
+ */
+export function isComponent(entry) {
+    if (!entry.returnType)
+        return false;
+    return COMPONENT_RETURN_PATTERNS.some((pat) => entry.returnType.includes(pat));
+}
+/**
+ * Split glossary entries into components (JSX-returning) and functions (everything else).
+ */
+export function classifyGlossaryEntries(entries) {
+    const components = [];
+    const functions = [];
+    for (const entry of entries) {
+        if (isComponent(entry)) {
+            components.push(entry);
+        }
+        else {
+            functions.push(entry);
+        }
+    }
+    return { components, functions };
+}
+/**
+ * Given classified entries and coverage data, produce a structured audit result.
+ *
+ * @param components  - Glossary entries classified as components
+ * @param functions   - Glossary entries classified as functions
+ * @param scenarioCounts - Map of component_name → number of registered scenarios
+ * @param testFileExistence - Map of testFile path → whether the file exists on disk
+ */
+export function computeAudit({ components, functions, scenarioCounts, testFileExistence, testResults, clientErrors, }) {
+    const componentResults = components.map((c) => {
+        const count = scenarioCounts[c.name] || 0;
+        const errors = clientErrors?.[c.name];
+        const hasErrors = count > 0 && errors && errors.length > 0;
+        let status;
+        if (count === 0) {
+            status = 'missing';
+        }
+        else if (hasErrors) {
+            status = 'has_errors';
+        }
+        else {
+            status = 'ok';
+        }
+        return {
+            name: c.name,
+            filePath: c.filePath,
+            scenarioCount: count,
+            status,
+            ...(hasErrors ? { clientErrors: errors } : {}),
+        };
+    });
+    const functionResults = functions.map((f) => {
+        const exists = f.testFile
+            ? (testFileExistence[f.testFile] ?? false)
+            : false;
+        if (!exists) {
+            return {
+                name: f.name,
+                filePath: f.filePath,
+                testFile: f.testFile,
+                testFileExists: false,
+                status: 'missing',
+            };
+        }
+        // If we have test results for this file, use them for deeper status
+        const tr = f.testFile && testResults ? testResults[f.testFile] : undefined;
+        if (!tr) {
+            // No test results available — fall back to existence-only check
+            return {
+                name: f.name,
+                filePath: f.filePath,
+                testFile: f.testFile,
+                testFileExists: true,
+                status: 'ok',
+            };
+        }
+        let status;
+        if (!tr.passing && tr.errorMessage) {
+            status = 'runner_error';
+        }
+        else if (!tr.passing) {
+            status = 'failing';
+        }
+        else if (!tr.hasEntityNameDescribe) {
+            status = 'name_mismatch';
+        }
+        else {
+            status = 'ok';
+        }
+        return {
+            name: f.name,
+            filePath: f.filePath,
+            testFile: f.testFile,
+            testFileExists: true,
+            testsPassing: tr.passing,
+            testsVisibleInUi: tr.hasEntityNameDescribe,
+            status,
+            ...(tr.errorMessage ? { errorMessage: tr.errorMessage } : {}),
+        };
+    });
+    const componentsOk = componentResults.filter((c) => c.status === 'ok').length;
+    const componentsWithErrors = componentResults.filter((c) => c.status === 'has_errors').length;
+    const componentsMissing = componentResults.filter((c) => c.status === 'missing').length;
+    const functionsOk = functionResults.filter((f) => f.status === 'ok').length;
+    const functionsFailing = functionResults.filter((f) => f.status === 'failing').length;
+    const functionsRunnerError = functionResults.filter((f) => f.status === 'runner_error').length;
+    const functionsNameMismatch = functionResults.filter((f) => f.status === 'name_mismatch').length;
+    const functionsMissing = functionResults.filter((f) => f.status === 'missing').length;
+    return {
+        components: componentResults,
+        functions: functionResults,
+        summary: {
+            totalComponents: componentResults.length,
+            componentsOk,
+            componentsMissing,
+            componentsWithErrors,
+            totalFunctions: functionResults.length,
+            functionsOk,
+            functionsMissing,
+            functionsFailing,
+            functionsRunnerError,
+            functionsNameMismatch,
+            allPassing: componentsMissing === 0 &&
+                componentsWithErrors === 0 &&
+                functionsFailing === 0 &&
+                functionsRunnerError === 0 &&
+                functionsNameMismatch === 0 &&
+                functionsMissing === 0,
+        },
+    };
+}
+/**
+ * Returns true when the audit failure can be auto-fixed by running
+ * analyze-imports: incomplete entities are the only issue AND we haven't
+ * already tried (to prevent infinite retry loops when analysis has errors).
+ */
+export function isAutoRemediable(summary, alreadyAttempted) {
+    if (alreadyAttempted)
+        return false;
+    if (!summary.incompleteEntities || summary.incompleteEntities === 0)
+        return false;
+    return isOnlyIncompleteEntities(summary);
+}
+/**
+ * Returns true when incompleteEntities is the ONLY audit failure —
+ * all other failure counts are zero. Used to decide whether auto-running
+ * analyze-imports can fix the audit without manual intervention.
+ */
+export function isOnlyIncompleteEntities(summary) {
+    return ((summary.componentsMissing ?? 0) === 0 &&
+        (summary.componentsWithErrors ?? 0) === 0 &&
+        (summary.functionsFailing ?? 0) === 0 &&
+        (summary.functionsNameMismatch ?? 0) === 0 &&
+        (summary.functionsMissing ?? 0) === 0 &&
+        (summary.missingFromGlossary ?? 0) === 0 &&
+        (summary.miscategorizedScenarios ?? 0) === 0);
+}
+/**
+ * Ensures the two audit filters — glossary scoping and scenario-count scoping —
+ * are consistent. When entityChangeStatus is empty/undefined (meaning the glossary
+ * will fall back to "audit all entries"), we must also drop the featureStartedAt
+ * filter so scenario counts include ALL scenarios, not just the current session.
+ *
+ * Without this, Feature 1 components get audited but their scenarios (created before
+ * the current feature session) aren't counted, causing false "no scenarios" failures.
+ */
+export function resolveAuditSessionScope({ featureStartedAt, entityChangeStatus, }) {
+    const hasChangeStatus = entityChangeStatus && Object.keys(entityChangeStatus).length > 0;
+    if (!hasChangeStatus) {
+        // Glossary will include all entries — scenario counts must also include all
+        return { featureStartedAt: null, entityChangeStatus };
+    }
+    return { featureStartedAt, entityChangeStatus };
+}
+/**
+ * Filter glossary entries to only those whose entities are new, edited, or impacted
+ * in the current working session. When entityChangeStatus is empty or undefined,
+ * falls back to returning all entries (no filtering).
+ *
+ * Matches by entity name first, then by filePath as a fallback.
+ */
+export function filterGlossaryByChangeStatus(entries, entityChangeStatus) {
+    if (!entityChangeStatus || Object.keys(entityChangeStatus).length === 0) {
+        return entries;
+    }
+    return entries.filter((entry) => {
+        // Match by entity name
+        if (entityChangeStatus[entry.name])
+            return true;
+        // Match by file path (entity names in changeStatus may be file-path keyed)
+        if (entityChangeStatus[entry.filePath])
+            return true;
+        return false;
+    });
+}
+/**
+ * Find entities that have scenarios but no analysis records.
+ * These entities need `codeyam editor analyze-imports` to run.
+ *
+ * Optionally scoped to the current feature session via featureStartedAt.
+ */
+export async function queryIncompleteEntities(db, projectId, featureStartedAt) {
+    // Step 1: Get distinct entity SHAs from scenarios (with counts)
+    let scenarioQuery = db
+        .selectFrom('editor_scenarios')
+        .select(['entity_sha'])
+        .select(db.fn.count('id').as('count'))
+        .where('project_id', '=', projectId)
+        .where('entity_sha', 'is not', null)
+        .groupBy('entity_sha');
+    if (featureStartedAt) {
+        const sqliteTimestamp = featureStartedAt
+            .replace('T', ' ')
+            .replace(/\.\d{3}Z$/, '');
+        scenarioQuery = scenarioQuery.where((eb) => eb.or([
+            eb('created_at', '>=', sqliteTimestamp),
+            eb('updated_at', '>=', sqliteTimestamp),
+        ]));
+    }
+    const scenarioRows = await scenarioQuery.execute();
+    if (scenarioRows.length === 0)
+        return [];
+    const scenarioShas = scenarioRows.map((r) => r.entity_sha);
+    // Step 2: Get entity SHAs that have analyses
+    const analysisRows = await db
+        .selectFrom('analyses')
+        .select('entity_sha')
+        .where('entity_sha', 'in', scenarioShas)
+        .groupBy('entity_sha')
+        .execute();
+    const analyzedShas = new Set(analysisRows.map((r) => r.entity_sha));
+    // Step 3: Find scenario entity SHAs without direct analyses
+    const incompleteShas = scenarioRows.filter((r) => !analyzedShas.has(r.entity_sha));
+    if (incompleteShas.length === 0)
+        return [];
+    // Step 4: Look up entity names for incomplete SHAs
+    const incompleteShalist = incompleteShas.map((r) => r.entity_sha);
+    const entityRows = await db
+        .selectFrom('entities')
+        .select(['sha', 'name', 'file_path'])
+        .where('sha', 'in', incompleteShalist)
+        .execute();
+    const entityNameMap = new Map(entityRows.map((r) => [r.sha, r.name]));
+    // Step 4.5: Check for inherited analyses from sibling entity versions.
+    // A new entity version (created by the file watcher) may not have direct
+    // analyses, but an older version (same name+filePath) might. This matches
+    // getAllEntities() behavior which inherits analyses across versions.
+    const entityNames = [
+        ...new Set(entityRows.map((r) => r.name).filter(Boolean)),
+    ];
+    let namesWithInheritedAnalyses = new Set();
+    if (entityNames.length > 0) {
+        const siblingRows = await db
+            .selectFrom('entities')
+            .innerJoin('analyses', 'analyses.entity_sha', 'entities.sha')
+            .select('entities.name')
+            .where('entities.name', 'in', entityNames)
+            .groupBy('entities.name')
+            .execute();
+        namesWithInheritedAnalyses = new Set(siblingRows.map((r) => r.name));
+    }
+    // Filter out entities that have inherited analyses
+    const trulyIncompleteShas = incompleteShas.filter((r) => {
+        const name = entityNameMap.get(r.entity_sha);
+        return !name || !namesWithInheritedAnalyses.has(name);
+    });
+    if (trulyIncompleteShas.length === 0)
+        return [];
+    const trulyIncompleteShalist = trulyIncompleteShas.map((r) => r.entity_sha);
+    // Step 5: Also get component_name from scenarios as fallback for name
+    const scenarioNameRows = await db
+        .selectFrom('editor_scenarios')
+        .select(['entity_sha', 'component_name'])
+        .where('project_id', '=', projectId)
+        .where('entity_sha', 'in', trulyIncompleteShalist)
+        .where('component_name', 'is not', null)
+        .groupBy('entity_sha')
+        .execute();
+    const scenarioNameMap = new Map(scenarioNameRows.map((r) => [
+        r.entity_sha,
+        r.component_name,
+    ]));
+    return trulyIncompleteShas.map((r) => {
+        const sha = r.entity_sha;
+        return {
+            entitySha: sha,
+            name: entityNameMap.get(sha) || scenarioNameMap.get(sha) || 'Unknown',
+            scenarioCount: Number(r.count),
+        };
+    });
+}
+/**
+ * Find component scenarios that use non-isolation URLs.
+ *
+ * Component scenarios should always use `/isolated-components/...` URLs.
+ * When a component scenario points at a real page URL (e.g., `/library`),
+ * it's miscategorized — it should either be an application scenario
+ * (no componentName, with pageFilePath) or use an isolation route.
+ *
+ * Optionally scoped to the current feature session via featureStartedAt.
+ */
+export async function queryMiscategorizedScenarios(db, projectId, featureStartedAt) {
+    let query = db
+        .selectFrom('editor_scenarios')
+        .select(['component_name', 'name', 'url'])
+        .where('project_id', '=', projectId)
+        .where('component_name', 'is not', null)
+        .where('url', 'is not', null);
+    if (featureStartedAt) {
+        const sqliteTimestamp = featureStartedAt
+            .replace('T', ' ')
+            .replace(/\.\d{3}Z$/, '');
+        query = query.where((eb) => eb.or([
+            eb('created_at', '>=', sqliteTimestamp),
+            eb('updated_at', '>=', sqliteTimestamp),
+        ]));
+    }
+    const rows = await query.execute();
+    // Filter to only rows where URL is NOT an isolation route
+    const miscategorized = rows.filter((r) => r.url && !r.url.includes('/isolated-components'));
+    if (miscategorized.length === 0)
+        return [];
+    // Group by (component_name, url)
+    const groups = new Map();
+    for (const row of miscategorized) {
+        const key = `${row.component_name}::${row.url}`;
+        const existing = groups.get(key);
+        if (existing) {
+            existing.scenarioNames.push(row.name);
+        }
+        else {
+            groups.set(key, {
+                componentName: row.component_name,
+                scenarioNames: [row.name],
+                url: row.url,
+            });
+        }
+    }
+    return [...groups.values()];
+}
+/**
+ * Query scenario counts per component, optionally scoped to the current
+ * feature session via featureStartedAt.
+ *
+ * A scenario belongs to the current session if it was created OR updated
+ * after featureStartedAt — re-registering a scenario during a new feature
+ * session updates `updated_at` but preserves the original `created_at`.
+ */
+export async function queryScenarioCounts(db, projectId, featureStartedAt) {
+    let query = db
+        .selectFrom('editor_scenarios')
+        .select(['component_name'])
+        .select(db.fn.count('id').as('count'))
+        .where('project_id', '=', projectId)
+        .where('component_name', 'is not', null)
+        .groupBy('component_name');
+    if (featureStartedAt) {
+        const sqliteTimestamp = featureStartedAt
+            .replace('T', ' ')
+            .replace(/\.\d{3}Z$/, '');
+        query = query.where((eb) => eb.or([
+            eb('created_at', '>=', sqliteTimestamp),
+            eb('updated_at', '>=', sqliteTimestamp),
+        ]));
+    }
+    const rows = await query.execute();
+    const counts = {};
+    for (const row of rows) {
+        if (row.component_name) {
+            counts[row.component_name] = Number(row.count);
+        }
+    }
+    return counts;
+}
+//# sourceMappingURL=editorAudit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editorAudit.js","sourceRoot":"","sources":["../../../../src/utils/editorAudit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoDH,wEAAwE;AAExE,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5C,KAAK,CAAC,UAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAI9D,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,YAAY,GAeb;IACC,MAAM,gBAAgB,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAE3D,IAAI,MAAqC,CAAC;QAC1C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,IAAI,SAAS,EAAE,CAAC;YACrB,MAAM,GAAG,YAAY,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,aAAa,EAAE,KAAK;YACpB,MAAM;YACN,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAyB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAChE,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ;YACvB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;YAC1C,CAAC,CAAC,KAAK,CAAC;QAEV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,cAAc,EAAE,KAAK;gBACrB,MAAM,EAAE,SAAkB;aAC3B,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,gEAAgE;YAChE,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,IAAa;aACtB,CAAC;QACJ,CAAC;QAED,IAAI,MAAoC,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;YACnC,MAAM,GAAG,cAAc,CAAC;QAC1B,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC;YACrC,MAAM,GAAG,eAAe,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,EAAE,CAAC,OAAO;YACxB,gBAAgB,EAAE,EAAE,CAAC,qBAAqB;YAC1C,MAAM;YACN,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IAC9E,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CACjC,CAAC,MAAM,CAAC;IACT,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAC9B,CAAC,MAAM,CAAC;IACT,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;IAC5E,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAC9B,CAAC,MAAM,CAAC;IACT,MAAM,oBAAoB,GAAG,eAAe,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,cAAc,CACnC,CAAC,MAAM,CAAC;IACT,MAAM,qBAAqB,GAAG,eAAe,CAAC,MAAM,CAClD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,eAAe,CACpC,CAAC,MAAM,CAAC;IACT,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAC9B,CAAC,MAAM,CAAC;IAET,OAAO;QACL,UAAU,EAAE,gBAAgB;QAC5B,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE;YACP,eAAe,EAAE,gBAAgB,CAAC,MAAM;YACxC,YAAY;YACZ,iBAAiB;YACjB,oBAAoB;YACpB,cAAc,EAAE,eAAe,CAAC,MAAM;YACtC,WAAW;YACX,gBAAgB;YAChB,gBAAgB;YAChB,oBAAoB;YACpB,qBAAqB;YACrB,UAAU,EACR,iBAAiB,KAAK,CAAC;gBACvB,oBAAoB,KAAK,CAAC;gBAC1B,gBAAgB,KAAK,CAAC;gBACtB,oBAAoB,KAAK,CAAC;gBAC1B,qBAAqB,KAAK,CAAC;gBAC3B,gBAAgB,KAAK,CAAC;SACzB;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAGC,EACD,gBAAyB;IAEzB,IAAI,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,KAAK,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAQxC;IACC,OAAO,CACL,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC;QACtC,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,CAAC,KAAK,CAAC;QACzC,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,KAAK,CAAC;QACrC,CAAC,OAAO,CAAC,qBAAqB,IAAI,CAAC,CAAC,KAAK,CAAC;QAC1C,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC,KAAK,CAAC;QACrC,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,KAAK,CAAC;QACxC,CAAC,OAAO,CAAC,uBAAuB,IAAI,CAAC,CAAC,KAAK,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,EACvC,gBAAgB,EAChB,kBAAkB,GAInB;IAIC,MAAM,eAAe,GACnB,kBAAkB,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAEnE,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,4EAA4E;QAC5E,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAwB,EACxB,kBAAkE;IAElE,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,uBAAuB;QACvB,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,2EAA2E;QAC3E,IAAI,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAe,EACf,SAAiB,EACjB,gBAA+B;IAE/B,gEAAgE;IAChE,IAAI,aAAa,GAAG,EAAE;SACnB,UAAU,CAAC,kBAAkB,CAAC;SAC9B,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;SACtB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;SAC7C,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,CAAC;SACnC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC;SACnC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,gBAAgB;aACrC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;aACjB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5B,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CACzC,EAAE,CAAC,EAAE,CAAC;YACJ,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC;YACvC,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC;SACxC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;IACnD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC;IAErE,6CAA6C;IAC7C,MAAM,YAAY,GAAG,MAAM,EAAE;SAC1B,UAAU,CAAC,UAAU,CAAC;SACtB,MAAM,CAAC,YAAY,CAAC;SACpB,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,YAAY,CAAC;SACvC,OAAO,CAAC,YAAY,CAAC;SACrB,OAAO,EAAE,CAAC;IACb,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC,CAAC;IAE9E,4DAA4D;IAC5D,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,UAAoB,CAAC,CACjD,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3C,mDAAmD;IACnD,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,MAAM,EAAE;SACxB,UAAU,CAAC,UAAU,CAAC;SACtB,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;SACpC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,iBAAiB,CAAC;SACrC,OAAO,EAAE,CAAC;IACb,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAa,EAAE,CAAC,CAAC,IAAc,CAAC,CAAC,CAC3D,CAAC;IAEF,uEAAuE;IACvE,yEAAyE;IACzE,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM,WAAW,GAAG;QAClB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC;IACF,IAAI,0BAA0B,GAAG,IAAI,GAAG,EAAU,CAAC;IACnD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,EAAE;aACzB,UAAU,CAAC,UAAU,CAAC;aACtB,SAAS,CAAC,UAAU,EAAE,qBAAqB,EAAE,cAAc,CAAC;aAC5D,MAAM,CAAC,eAAe,CAAC;aACvB,KAAK,CAAC,eAAe,EAAE,IAAI,EAAE,WAAW,CAAC;aACzC,OAAO,CAAC,eAAe,CAAC;aACxB,OAAO,EAAE,CAAC;QACb,0BAA0B,GAAG,IAAI,GAAG,CAClC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CACzC,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,MAAM,mBAAmB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACtD,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,UAAoB,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhD,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,GAAG,CACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAoB,CAC9B,CAAC;IAEF,sEAAsE;IACtE,MAAM,gBAAgB,GAAG,MAAM,EAAE;SAC9B,UAAU,CAAC,kBAAkB,CAAC;SAC9B,MAAM,CAAC,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;SACxC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,CAAC;SACnC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,sBAAsB,CAAC;SACjD,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,YAAY,CAAC;SACrB,OAAO,EAAE,CAAC;IACb,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1B,CAAC,CAAC,UAAoB;QACtB,CAAC,CAAC,cAAwB;KAC3B,CAAC,CACH,CAAC;IAEF,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,CAAC,CAAC,UAAoB,CAAC;QACnC,OAAO;YACL,SAAS,EAAE,GAAG;YACd,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS;YACrE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;SAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,EAAe,EACf,SAAiB,EACjB,gBAA+B;IAI/B,IAAI,KAAK,GAAG,EAAE;SACX,UAAU,CAAC,kBAAkB,CAAC;SAC9B,MAAM,CAAC,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;SACzC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,CAAC;SACnC,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC;SACvC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEhC,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,gBAAgB;aACrC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;aACjB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CACzB,EAAE,CAAC,EAAE,CAAC;YACJ,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC;YACvC,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC;SACxC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IAEnC,0DAA0D;IAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAE,CAAC,CAAC,GAAc,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CACpE,CAAC;IAEF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3C,iCAAiC;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAGnB,CAAC;IACJ,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,cAAc,KAAK,GAAG,CAAC,GAAG,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACd,aAAa,EAAE,GAAG,CAAC,cAAwB;gBAC3C,aAAa,EAAE,CAAC,GAAG,CAAC,IAAc,CAAC;gBACnC,GAAG,EAAE,GAAG,CAAC,GAAa;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAe,EACf,SAAiB,EACjB,gBAA+B;IAE/B,IAAI,KAAK,GAAG,EAAE;SACX,UAAU,CAAC,kBAAkB,CAAC;SAC9B,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;SAC1B,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;SAC7C,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,SAAS,CAAC;SACnC,KAAK,CAAC,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,gBAAgB;aACrC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;aACjB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CACzB,EAAE,CAAC,EAAE,CAAC;YACJ,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC;YACvC,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,eAAe,CAAC;SACxC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACnC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,26 @@
+import { broadcastSetViewport, broadcastPreviewRefresh, } from "../webserver/terminalServer.js";
+/**
+ * Broadcast viewport change THEN preview refresh.
+ *
+ * Order matters: the browser must resize the iframe before it starts
+ * reloading, otherwise the content renders at the wrong viewport size.
+ * Both the preview endpoint and register endpoint need this sequence.
+ */
+export function broadcastViewportThenRefresh(opts) {
+    // 1. Set viewport (only when a named dimension is present)
+    if (opts.dimension) {
+        try {
+            broadcastSetViewport({
+                name: opts.dimension,
+                width: opts.viewport.width,
+                height: opts.viewport.height,
+            });
+        }
+        catch {
+            // Non-critical — viewport broadcast failure shouldn't block refresh
+        }
+    }
+    // 2. Refresh preview iframe
+    broadcastPreviewRefresh(opts.refreshPath, opts.scenarioId);
+}
+//# sourceMappingURL=editorBroadcastViewport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editorBroadcastViewport.js","sourceRoot":"","sources":["../../../../src/utils/editorBroadcastViewport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAK5C;IACC,2DAA2D;IAC3D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,oBAAoB,CAAC;gBACnB,IAAI,EAAE,IAAI,CAAC,SAAS;gBACpB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK;gBAC1B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;aAC7B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,uBAAuB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;AAC7D,CAAC"}