@codeyam/codeyam-cli 0.1.0-staging.8e7b1bd → 0.1.0-staging.9574237

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,210 @@
+/**
+ * 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) {
+            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,
+        };
+    });
+    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 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,
+            functionsNameMismatch,
+            allPassing: componentsMissing === 0 &&
+                componentsWithErrors === 0 &&
+                functionsFailing === 0 &&
+                functionsNameMismatch === 0 &&
+                functionsMissing === 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;
+    });
+}
+/**
+ * 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":"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"}

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"}

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

@@ -0,0 +1,102 @@
+/**
+ * Capture script resolution and execution utilities for the editor.
+ *
+ * Extracted from duplicated inline logic in api.editor-register-scenario.ts
+ * and api.editor-capture-scenario.ts.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Resolve the webserver root directory from an import.meta.url.
+ *
+ * Walks up from the route file's directory to find the 'webserver' ancestor.
+ * Works for both dev (app/routes/) and installed (build/server/) layouts.
+ */
+export function resolveWebserverDir(importMetaUrl) {
+    const routeDir = path.dirname(new URL(importMetaUrl).pathname);
+    let dir = routeDir;
+    for (let i = 0; i < 5; i++) {
+        const parent = path.dirname(dir);
+        if (path.basename(parent) === 'webserver' ||
+            path.basename(dir) === 'webserver') {
+            return path.basename(dir) === 'webserver' ? dir : parent;
+        }
+        dir = parent;
+    }
+    return dir;
+}
+/**
+ * Resolve the journalCapture.ts script path.
+ *
+ * The script lives in different locations depending on context:
+ * - Installed package: webserverDir/scripts/journalCapture.ts
+ * - Dev (codeyam repo): webserverDir/app/lib/journalCapture.ts
+ * - Dev via codeyamRoot (monorepo): codeyamRoot/codeyam-cli/src/webserver/app/lib/journalCapture.ts
+ *
+ * Returns the first path that exists, or the first candidate as fallback.
+ */
+export async function resolveCaptureScript(webserverDir, codeyamRoot) {
+    const possiblePaths = [
+        // Installed package: scripts/ directory (standalone copy)
+        path.join(webserverDir, 'scripts', 'journalCapture.ts'),
+        // Dev: source file in app/lib/
+        path.join(webserverDir, 'app', 'lib', 'journalCapture.ts'),
+        // Dev via codeyamRoot (monorepo)
+        path.join(codeyamRoot, 'codeyam-cli', 'src', 'webserver', 'app', 'lib', 'journalCapture.ts'),
+    ];
+    for (const p of possiblePaths) {
+        try {
+            await fs.access(p);
+            return p;
+        }
+        catch {
+            // Try next path
+        }
+    }
+    // Return the most likely path for error reporting
+    return possiblePaths[0];
+}
+/**
+ * Run a capture script via shell and return the result.
+ *
+ * For the Playwright-based journalCapture.ts, this would typically be called as:
+ *   runCaptureScript(scriptPath, JSON.stringify(captureArgs), cwd)
+ *
+ * For shell scripts (used in tests), runs directly. For .ts files, runs via `npx tsx`.
+ */
+export function runCaptureScript(scriptPath, captureArgs, cwd) {
+    return new Promise((resolve) => {
+        const isTsFile = scriptPath.endsWith('.ts');
+        const command = isTsFile ? 'npx' : scriptPath;
+        const args = isTsFile ? ['tsx', scriptPath, captureArgs] : [captureArgs];
+        const child = spawn(command, args, {
+            cwd,
+            env: { ...process.env },
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve({ success: true, output: stdout });
+            }
+            else {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: stderr || `Process exited with code ${code}`,
+                });
+            }
+        });
+        child.on('error', (err) => {
+            resolve({ success: false, output: '', error: err.message });
+        });
+    });
+}
+//# sourceMappingURL=editorCapture.js.map

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

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

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

@@ -0,0 +1,67 @@
+/**
+ * CLI wrapper for deleting a scenario via the editor API.
+ *
+ * Looks up the scenario name from the editor-scenarios endpoint,
+ * then calls the delete-scenario endpoint to remove it.
+ */
+/**
+ * Delete a scenario by ID via the running editor server.
+ *
+ * 1. Fetches scenario list to resolve the scenario name (for user feedback)
+ * 2. Calls the delete-scenario API
+ */
+export async function deleteScenarioViaCli(scenarioId, port) {
+    const baseUrl = `http://localhost:${port}`;
+    // Step 1: Look up the scenario to confirm it exists and get its name
+    let scenarios;
+    try {
+        const listRes = await fetch(`${baseUrl}/api/editor-scenarios`);
+        if (!listRes.ok) {
+            return {
+                success: false,
+                message: `Failed to fetch scenarios (HTTP ${listRes.status})`,
+            };
+        }
+        const data = await listRes.json();
+        scenarios = data.scenarios;
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: `Could not reach the CodeYam server. Is it running? (${err instanceof Error ? err.message : String(err)})`,
+        };
+    }
+    const scenario = scenarios.find((s) => s.id === scenarioId);
+    if (!scenario) {
+        return {
+            success: false,
+            message: `Scenario "${scenarioId}" not found. Use \`codeyam editor scenarios\` to list available scenarios.`,
+        };
+    }
+    // Step 2: Delete the scenario
+    try {
+        const deleteRes = await fetch(`${baseUrl}/api/delete-scenario`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ scenarioId }),
+        });
+        if (!deleteRes.ok) {
+            return {
+                success: false,
+                message: `Failed to delete scenario (HTTP ${deleteRes.status})`,
+            };
+        }
+        return {
+            success: true,
+            scenarioName: scenario.name,
+            message: `Deleted scenario "${scenario.name}" (${scenarioId})`,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: `Failed to delete scenario: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=editorDeleteScenario.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editorDeleteScenario.js","sourceRoot":"","sources":["../../../../src/utils/editorDeleteScenario.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,IAAY;IAEZ,MAAM,OAAO,GAAG,oBAAoB,IAAI,EAAE,CAAC;IAE3C,qEAAqE;IACrE,IAAI,SAAuE,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,uBAAuB,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,mCAAmC,OAAO,CAAC,MAAM,GAAG;aAC9D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,SAAS,GAAI,IAAwC,CAAC,SAAS,CAAC;IAClE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,uDAAuD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;SACpH,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,aAAa,UAAU,4EAA4E;SAC7G,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,sBAAsB,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,mCAAmC,SAAS,CAAC,MAAM,GAAG;aAChE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,QAAQ,CAAC,IAAI;YAC3B,OAAO,EAAE,qBAAqB,QAAQ,CAAC,IAAI,MAAM,UAAU,GAAG;SAC/D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC1F,CAAC;IACJ,CAAC;AACH,CAAC"}