@codeyam/codeyam-cli 0.1.0-staging.28f73cf → 0.1.0-staging.323686

package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js

@@ -1,7 +1,36 @@
-export default function safeFileName(name) {
+/**
+ * Simple hash function for generating unique suffixes.
+ * Uses djb2 algorithm - fast and produces good distribution.
+ * Not cryptographically secure, but sufficient for filename uniqueness.
+ */
+function simpleHash(str) {
+    let hash = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash = (hash * 33) ^ str.charCodeAt(i);
+    }
+    // Convert to unsigned 32-bit and then to hex
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+export default function safeFileName(name, options = {}) {
+    const { maxLength } = options;
     // Replace unsafe characters with underscores, preserving original casing
-    const safeSlug = name.replace(/[^a-zA-Z0-9_]+/g, '_');
+    // Then trim leading/trailing underscores to avoid malformed route segments
+    let safeSlug = name.replace(/[^a-zA-Z0-9_]+/g, '_').replace(/^_+|_+$/g, '');
+    if (!safeSlug)
+        return '';
     // Ensure it starts with a capital letter (for consistency with Remix routes)
-    return safeSlug.slice(0, 1).toUpperCase() + safeSlug.slice(1);
+    safeSlug = safeSlug.slice(0, 1).toUpperCase() + safeSlug.slice(1);
+    // If maxLength is specified and the slug exceeds it, truncate and add a hash
+    if (maxLength && safeSlug.length > maxLength) {
+        // Create an 8-character hash of the full name for uniqueness
+        const hash = simpleHash(name);
+        // Reserve space for underscore + hash (9 chars total)
+        const truncateLength = maxLength - 9;
+        const truncated = safeSlug.substring(0, truncateLength);
+        // Remove trailing underscore if present (from mid-word truncation)
+        const cleanTruncated = truncated.replace(/_+$/, '');
+        safeSlug = `${cleanTruncated}_${hash}`;
+    }
+    return safeSlug;
 }
 //# sourceMappingURL=safeFileName.js.map

package/analyzer-template/packages/github/dist/utils/src/lib/safeFileName.js.map

@@ -1 +1 @@
-{"version":3,"file":"safeFileName.js","sourceRoot":"","sources":["../../../../../utils/src/lib/safeFileName.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,IAAY;IAC/C,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAEtD,6EAA6E;IAC7E,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC"}
+{"version":3,"file":"safeFileName.js","sourceRoot":"","sources":["../../../../../utils/src/lib/safeFileName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,6CAA6C;IAC7C,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC;AAWD,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAY,EACZ,UAA+B,EAAE;IAEjC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,yEAAyE;IACzE,2EAA2E;IAC3E,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE5E,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,6EAA6E;IAC7E,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAElE,6EAA6E;IAC7E,IAAI,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC7C,6DAA6D;QAC7D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAE9B,sDAAsD;QACtD,MAAM,cAAc,GAAG,SAAS,GAAG,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;QAExD,mEAAmE;QACnE,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAEpD,QAAQ,GAAG,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/buildStartCommand.d.ts

@@ -0,0 +1,18 @@
+import { WebApp, EnvironmentVariable } from '~codeyam/types';
+export interface BuildStartCommandOptions {
+    webapp: WebApp | undefined;
+    port: number;
+    environmentVariables: EnvironmentVariable[];
+    packageManager: string;
+}
+/**
+ * Builds a shell-ready start command string for a webapp.
+ *
+ * This function handles:
+ * - $PORT substitution in args and env vars
+ * - Environment variable formatting with proper escaping
+ * - sh -c command quoting
+ * - Fallback when no startCommand is configured
+ */
+export default function buildStartCommand(options: BuildStartCommandOptions): string;
+//# sourceMappingURL=buildStartCommand.d.ts.map

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/buildStartCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildStartCommand.d.ts","sourceRoot":"","sources":["../../../../../../utils/src/lib/startCommand/buildStartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,OAAO,EAAE,wBAAwB,GAChC,MAAM,CA0CR"}

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/buildStartCommand.js

@@ -0,0 +1,45 @@
+/**
+ * Builds a shell-ready start command string for a webapp.
+ *
+ * This function handles:
+ * - $PORT substitution in args and env vars
+ * - Environment variable formatting with proper escaping
+ * - sh -c command quoting
+ * - Fallback when no startCommand is configured
+ */
+export default function buildStartCommand(options) {
+    const { webapp, port, environmentVariables, packageManager } = options;
+    const startCmd = webapp?.startCommand;
+    // Fallback when no startCommand configured
+    if (!startCmd) {
+        return `${packageManager} ${packageManager === 'npm' ? 'run ' : ''}dev`;
+    }
+    // Substitute $PORT in args
+    const args = startCmd.args?.map((arg) => arg.replace(/\$PORT/g, String(port))) ??
+        [];
+    // Build environment variables string from config
+    const envVars = [];
+    for (const envVar of environmentVariables) {
+        if (envVar.key && envVar.value !== undefined) {
+            // Escape single quotes in values
+            const escapedValue = String(envVar.value).replace(/'/g, "'\\''");
+            envVars.push(`${envVar.key}='${escapedValue}'`);
+        }
+    }
+    // Add any env vars from startCommand.env
+    if (startCmd.env) {
+        for (const [key, value] of Object.entries(startCmd.env)) {
+            const substitutedValue = String(value).replace(/\$PORT/g, String(port));
+            const escapedValue = substitutedValue.replace(/'/g, "'\\''");
+            envVars.push(`${key}='${escapedValue}'`);
+        }
+    }
+    const envPrefix = envVars.length > 0 ? envVars.join(' ') + ' ' : '';
+    // If command is 'sh' with '-c' arg, properly quote the shell command
+    if (startCmd.command === 'sh' && args[0] === '-c' && args[1]) {
+        return `${envPrefix}sh -c "${args[1]}"`;
+    }
+    // Default: just join command and args
+    return `${envPrefix}${startCmd.command} ${args.join(' ')}`;
+}
+//# sourceMappingURL=buildStartCommand.js.map

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/buildStartCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildStartCommand.js","sourceRoot":"","sources":["../../../../../../utils/src/lib/startCommand/buildStartCommand.ts"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,OAAiC;IAEjC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACvE,MAAM,QAAQ,GAAG,MAAM,EAAE,YAAY,CAAC;IAEtC,2CAA2C;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,GAAG,cAAc,IAAI,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IAC1E,CAAC;IAED,2BAA2B;IAC3B,MAAM,IAAI,GACR,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,EAAE,CAAC;IAEL,iDAAiD;IACjD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7C,iCAAiC;YACjC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,YAAY,GAAG,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,YAAY,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpE,qEAAqE;IACrE,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,GAAG,SAAS,UAAU,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,CAAC;IAED,sCAAsC;IACtC,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/getWebappInfo.d.ts

@@ -0,0 +1,26 @@
+import { WebApp, EnvironmentVariable, ProjectFramework } from '~codeyam/types';
+export interface GetWebappInfoOptions {
+    filePath: string;
+    webapps: WebApp[];
+    environmentVariables: EnvironmentVariable[];
+    port: number;
+    packageManager: string;
+}
+export interface WebappInfo {
+    webapp: WebApp;
+    webappPath: string;
+    framework: ProjectFramework;
+    packageManager: string;
+    startCommand: string;
+    url: string;
+}
+/**
+ * Gets comprehensive webapp information for a given file path.
+ *
+ * This function:
+ * - Finds the correct webapp for the file path
+ * - Builds the complete start command with environment variables
+ * - Returns all relevant webapp metadata
+ */
+export default function getWebappInfo(options: GetWebappInfoOptions): WebappInfo;
+//# sourceMappingURL=getWebappInfo.d.ts.map

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/getWebappInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWebappInfo.d.ts","sourceRoot":"","sources":["../../../../../../utils/src/lib/startCommand/getWebappInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAI/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAiDD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,OAAO,EAAE,oBAAoB,GAC5B,UAAU,CA6BZ"}

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/getWebappInfo.js

@@ -0,0 +1,67 @@
+import buildStartCommand from './buildStartCommand';
+import * as path from 'path';
+/**
+ * Find which webapp a component belongs to based on its file path.
+ * Returns the webapp with the most specific (longest) path match.
+ */
+function findWebAppForComponent(componentPath, webapps) {
+    if (!webapps || webapps.length === 0) {
+        return undefined;
+    }
+    if (webapps.length === 1) {
+        return webapps[0];
+    }
+    // Normalize the component path
+    const normalizedComponentPath = path.normalize(componentPath);
+    // Sort webapps by path length (descending) to match most specific path first
+    const sortedWebapps = [...webapps].sort((a, b) => (b.path?.length ?? 0) - (a.path?.length ?? 0));
+    // Find the webapp whose path is a prefix of the component path
+    for (const webapp of sortedWebapps) {
+        const webappPath = path.normalize(webapp.path ?? '.');
+        // Check if component is within this webapp
+        if (webappPath === '.') {
+            // Root webapp - matches everything (but we check others first due to sorting)
+            return webapp;
+        }
+        // Check if component path starts with webapp path
+        if (normalizedComponentPath.startsWith(webappPath + path.sep) ||
+            normalizedComponentPath === webappPath) {
+            return webapp;
+        }
+    }
+    // Fallback to first webapp
+    return webapps[0];
+}
+/**
+ * Gets comprehensive webapp information for a given file path.
+ *
+ * This function:
+ * - Finds the correct webapp for the file path
+ * - Builds the complete start command with environment variables
+ * - Returns all relevant webapp metadata
+ */
+export default function getWebappInfo(options) {
+    const { filePath, webapps, environmentVariables, port, packageManager } = options;
+    if (!webapps || webapps.length === 0) {
+        throw new Error('No webapps configured. Please run CodeYam init again.');
+    }
+    const webapp = findWebAppForComponent(filePath, webapps);
+    if (!webapp) {
+        throw new Error('Could not find webapp for file path: ' + filePath);
+    }
+    const startCommand = buildStartCommand({
+        webapp,
+        port,
+        environmentVariables,
+        packageManager,
+    });
+    return {
+        webapp,
+        webappPath: webapp.path ?? '.',
+        framework: webapp.framework,
+        packageManager: webapp.packageManager ?? packageManager,
+        startCommand,
+        url: `http://localhost:${port}/static/codeyam-sample`,
+    };
+}
+//# sourceMappingURL=getWebappInfo.js.map

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/getWebappInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWebappInfo.js","sourceRoot":"","sources":["../../../../../../utils/src/lib/startCommand/getWebappInfo.ts"],"names":[],"mappings":"AACA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAmB7B;;;GAGG;AACH,SAAS,sBAAsB,CAC7B,aAAqB,EACrB,OAAiB;IAEjB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,+BAA+B;IAC/B,MAAM,uBAAuB,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAE9D,6EAA6E;IAC7E,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,CACxD,CAAC;IAEF,+DAA+D;IAC/D,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QAEtD,2CAA2C;QAC3C,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,8EAA8E;YAC9E,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,kDAAkD;QAClD,IACE,uBAAuB,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC;YACzD,uBAAuB,KAAK,UAAU,EACtC,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,OAA6B;IAE7B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,cAAc,EAAE,GACrE,OAAO,CAAC;IAEV,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC;QACrC,MAAM;QACN,IAAI;QACJ,oBAAoB;QACpB,cAAc;KACf,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,cAAc;QACvD,YAAY;QACZ,GAAG,EAAE,oBAAoB,IAAI,wBAAwB;KACtD,CAAC;AACJ,CAAC"}

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/index.d.ts

@@ -0,0 +1,3 @@
+export { default as buildStartCommand, type BuildStartCommandOptions, } from './buildStartCommand';
+export { default as getWebappInfo, type GetWebappInfoOptions, type WebappInfo, } from './getWebappInfo';
+//# sourceMappingURL=index.d.ts.map

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../utils/src/lib/startCommand/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,IAAI,iBAAiB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,KAAK,oBAAoB,EACzB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC"}

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/index.js

@@ -0,0 +1,3 @@
+export { default as buildStartCommand, } from './buildStartCommand';
+export { default as getWebappInfo, } from './getWebappInfo';
+//# sourceMappingURL=index.js.map

package/analyzer-template/packages/github/dist/utils/src/lib/startCommand/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../utils/src/lib/startCommand/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,IAAI,iBAAiB,GAE7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,OAAO,IAAI,aAAa,GAGzB,MAAM,iBAAiB,CAAC"}

package/analyzer-template/packages/github/src/lib/getCommitsFromGithub.ts

@@ -1,4 +1,4 @@
-import { getSupabase } from '~codeyam/supabase';
+import { getSupabase } from '~codeyam/database';
 import { Project } from '~codeyam/types';
 import { createProjectOctokit } from './createProjectOctokit';
 

package/analyzer-template/packages/github/src/lib/loadOrCreateCommit.ts

@@ -4,7 +4,7 @@ import {
   upsertBranches,
   upsertCommits,
   upsertGithubUser,
-} from '~codeyam/supabase';
+} from '~codeyam/database';
 import { Project } from '~codeyam/types';
 import { safeStringify } from '~codeyam/utils';
 import {
@@ -124,6 +124,20 @@ export default async function loadOrCreateCommit(
     branchFromDb = newBranches[0];
   }
 
+  // If no branch was found or created (e.g., non-HEAD commit where
+  // listBranchesForHeadCommit returns empty), fall back to the primary branch.
+  // Only do this for baseline commits where the assumption is justified.
+  if (!branchFromDb && baseline && project.branches) {
+    branchFromDb = project.branches.find((b) => b.primary) ?? null;
+  }
+
+  if (!branchFromDb) {
+    throw new Error(
+      `Could not determine branch for commit ${commitSha}. ` +
+        `The commit may not be at the HEAD of any branch, and no primary branch was found.`,
+    );
+  }
+
   commit.branch = branchFromDb;
   branchName = branchFromDb.name;
 

package/analyzer-template/packages/github/src/lib/syncBranches.ts

@@ -1,4 +1,4 @@
-import { loadBranches, upsertBranches } from '~codeyam/supabase';
+import { loadBranches, upsertBranches } from '~codeyam/database';
 import { Branch, GithubRepoData } from '~codeyam/types';
 import getCommits from './getCommits';
 import { Octokit } from '@octokit/rest';

package/analyzer-template/packages/github/src/lib/syncHeadBranches.ts

@@ -1,4 +1,4 @@
-import { loadBranches, upsertBranches } from '~codeyam/supabase';
+import { loadBranches, upsertBranches } from '~codeyam/database';
 import { Project } from '~codeyam/types';
 import { createProjectOctokit } from './createProjectOctokit';
 

package/analyzer-template/packages/github/src/lib/syncPrimaryBranch.ts

@@ -1,4 +1,4 @@
-import { loadBranches, upsertBranches } from '~codeyam/supabase';
+import { loadBranches, upsertBranches } from '~codeyam/database';
 import { Branch, Project } from '~codeyam/types';
 import getRepoInfo from './getRepoInfo';
 
@@ -79,6 +79,8 @@ export default async function syncPrimaryBranch({
       const index = projectBranches.findIndex((b) => b.name === branch.name);
       if (index !== -1) {
         projectBranches[index] = branch;
+      } else {
+        projectBranches.push(branch);
       }
     }
 

package/analyzer-template/packages/github/src/lib/syncPullRequest.ts

@@ -2,7 +2,7 @@ import {
   createOrUpdateBranchCommitStats,
   upsertBranches,
   upsertCommits,
-} from '~codeyam/supabase';
+} from '~codeyam/database';
 import { Branch, Commit, Project } from '~codeyam/types';
 
 interface UpdateBranchedBasedOnPullRequestArgs {

package/analyzer-template/packages/github/src/lib/updateCommitBranchesInDb.ts

@@ -1,4 +1,4 @@
-import { loadCommitBranches, upsertCommitBranches } from '~codeyam/supabase';
+import { loadCommitBranches, upsertCommitBranches } from '~codeyam/database';
 import { Branch, Commit } from '~codeyam/types';
 
 export default async function updateCommitBranchesInDb({

package/analyzer-template/packages/github/src/lib/updateFilesInDb.ts

@@ -6,7 +6,7 @@ import {
   upsertFiles,
   Insertable,
   FilesTable,
-} from '~codeyam/supabase';
+} from '~codeyam/database';
 import { Project } from '~codeyam/types';
 import { randomUUID } from 'node:crypto';
 

package/analyzer-template/packages/process/index.ts

@@ -0,0 +1,2 @@
+// Re-export everything from src/index.ts
+export * from './src/index';

package/analyzer-template/packages/process/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@codeyam/process",
+  "version": "1.0.0",
+  "description": "Process management utilities for CodeYam",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {},
+  "keywords": [],
+  "author": "",
+  "license": "ISC"
+}

package/analyzer-template/packages/process/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*.ts"]
+}

package/analyzer-template/packages/types/index.ts

@@ -42,6 +42,9 @@ export type {
   ScenariosDataStructure,
   DataStructure,
   ConditionalUsage,
+  CompoundConditional,
+  ConditionalEffect,
+  JsxRenderingUsage,
 } from './src/types/ScenariosDataStructure';
 export type {
   Scenario,
@@ -63,6 +66,8 @@ export type {
   AnalysisStatus,
   AnalysisMetadata,
   ReadonlyAnalysis,
+  SourceLocation,
+  ExecutionFlow,
 } from './src/types/Analysis';
 export { EMPTY_SHA_MARKER } from './src/types/Analysis';
 export type { CodeExplanation } from './src/types/CodeExplanation';

package/analyzer-template/packages/types/src/types/Analysis.ts

@@ -17,6 +17,24 @@ import { DeepReadonly } from './DeepReadonly';
 // used for e.g. analyzedTreeSha for analyses that have no meaningful content to hash
 export const EMPTY_SHA_MARKER = '0000000000000000000000000000000000000000';
 
+/** Represents a location in source code */
+export interface SourceLocation {
+  /** Entity name where this usage occurs */
+  entityName: string;
+  /** File path relative to project root */
+  filePath: string;
+  /** Line number (1-based) */
+  lineNumber: number;
+  /** Column number (0-based) */
+  column?: number;
+  /** The code snippet at this location */
+  codeSnippet: string;
+  /** Type of usage: conditional check, render expression, or computation */
+  usageType: 'conditional' | 'render' | 'computation';
+  /** Human-readable description of how the attribute is used here */
+  description?: string;
+}
+
 export interface AnalysisError {
   message: string;
   stack: string;
@@ -24,6 +42,90 @@ export interface AnalysisError {
   phase: 'capture' | 'analyze';
 }
 
+/** Represents a distinct execution path/outcome in a component with the required attribute values */
+export interface ExecutionFlow {
+  /** Unique identifier for this execution flow */
+  id: string;
+  /** Human-readable name (e.g., "Modal visible", "Loading spinner shown") */
+  name: string;
+  /** Description of what the user sees or what behavior occurs */
+  description: string;
+  /** Whether this is an error/exception scenario */
+  isError?: boolean;
+  /** Attribute values required to produce this outcome */
+  requiredValues: {
+    /** Path to the attribute (e.g., "signature[0].showModal") */
+    attributePath: string;
+    /** The required value (descriptive or literal) */
+    value: string;
+    /** Comparison type for the value */
+    comparison:
+      | 'equals'
+      | 'notEquals'
+      | 'truthy'
+      | 'falsy'
+      | 'length>'
+      | 'length<'
+      | 'exists'
+      | 'not-exists';
+    /** Type of the attribute for mock generation */
+    valueType?:
+      | 'string'
+      | 'number'
+      | 'boolean'
+      | 'object'
+      | 'array'
+      | 'null'
+      | 'function';
+    /**
+     * The full original expression as a semantic constraint for LLM reasoning.
+     * Used when the attributePath is a base that needs additional context to
+     * generate correct mock data.
+     *
+     * Examples:
+     * - `scenarios.filter(s => s.active).length > 1`
+     * - `users.some(u => u.role === 'admin' && u.active)`
+     *
+     * The LLM interprets this constraint to generate data that satisfies it.
+     */
+    constraint?: string;
+  }[];
+  /** Visual/behavioral impact level */
+  impact: 'high' | 'medium' | 'low';
+  /** True if this outcome hides/blocks other outcomes (modals, overlays, full-screen states) */
+  blocksOtherFlows?: boolean;
+  /**
+   * True if this flow can only be triggered by user interaction (clicking a button, etc.)
+   * and cannot be controlled via mock data. These flows need Playwright instructions.
+   */
+  interactionRequired?: boolean;
+  /**
+   * Group name for mutually exclusive flows - only ONE flow from a group can be active at a time.
+   * Examples: "status-badge", "active-tab", "modal-state"
+   * Flows in the same group represent alternative states of the same UI element/feature.
+   */
+  exclusiveGroup?: string;
+  /** Code snippet showing where this outcome is determined */
+  codeSnippet?: string;
+  /** Source location in code */
+  sourceLocation?: {
+    lineNumber: number;
+    column?: number;
+  };
+  /**
+   * Priority score for this flow (higher = more important to simulate).
+   * Based on rendering impact: flows that control more content/child components
+   * are prioritized higher. Used for sorting and filtering when there are many flows.
+   */
+  priority?: number;
+  /**
+   * Names of child components whose rendering is controlled by this flow.
+   * Flows that gate child component rendering should have higher priority
+   * as they affect more of the UI.
+   */
+  childComponentsControlled?: string[];
+}
+
 export interface Analysis {
   id?: string;
   projectId: string;
@@ -58,15 +160,8 @@ export interface Analysis {
     }[];
     mergedDataStructure?: Omit<DataStructure, 'equivalentSignatureVariables'>;
     scenariosDataStructure?: ScenariosDataStructure;
-    keyAttributes?: {
-      dependentEntityName?: string;
-      internalPath: string;
-      externalPath: string;
-      dataStructurePath?: string; // Full path like "useDiffModal().diffView" for mapping to mockData
-      description: string;
-      validValueOptions: string[];
-      errorValueOptions: string[];
-    }[];
+    /** All distinct execution flows/outcomes this entity can produce */
+    executionFlows?: ExecutionFlow[];
     dependencyTree?: DependencyTreeNode;
     dependentAnalyses?: string[];
     dependencyAnalyzedTreeShas?: {

package/analyzer-template/packages/types/src/types/Commit.ts

@@ -20,6 +20,8 @@ export type CommitRunStatus = {
   capturesAttempted?: number; // number of analyses captures attempted
   capturesCompleted?: number; // number of entity analyses captured
   analysisCompletedAt?: string; // timestamp when all analysis was completed
+  captureCompletedAt?: string; // timestamp when capture orchestration finished (success or graceful exit)
+  completedAt?: string; // latest phase completion — always set alongside analysisCompletedAt or captureCompletedAt
   firstCaptureAt?: string; // timestamp when the first capture was initiated
   lastCaptureAt?: string; // timestamp when the last capture was initiated
 

package/analyzer-template/packages/types/src/types/Entity.ts

@@ -71,6 +71,7 @@ export interface Entity {
       isImplicitDependency?: boolean;
       isMocked?: boolean;
       calls?: string[];
+      callVariableNames?: string[];
     })[];
     nodeModuleImports?: {
       [key: string]: {
@@ -78,6 +79,7 @@ export interface Entity {
         isDefault: boolean;
         isMocked?: boolean;
         calls?: string[];
+        callVariableNames?: string[];
       }[];
     };
     importedBy?: {
@@ -99,6 +101,8 @@ export interface Entity {
     previousVersionWithAnalyses?: string;
     isSuperseded?: boolean;
     mockInfo?: any;
+    /** Whether the entity is an async function/component (Server Component in Next.js) */
+    isAsync?: boolean;
   };
   file?: File;
   commit?: Commit;

package/analyzer-template/packages/types/src/types/Scenario.ts

@@ -71,16 +71,11 @@ export interface Scenario {
       diffPercentage?: string;
     }[];
     dataMapping?: { [key: string]: string };
-    // New format: { dataStructurePath: { localVariable, instruction } }
-    // Old format (deprecated): { path: instruction_string }
-    keyAttributeInstructions?: {
-      [key: string]:
-        | string
-        | {
-            localVariable: string;
-            instruction: string;
-          };
-    };
+    /**
+     * IDs of execution flows this scenario covers.
+     * Mock data is generated to satisfy all requiredValues from these flows.
+     */
+    coveredFlows?: string[];
     data?: {
       mockData: { [key: string]: unknown };
       argumentsData: { [key: string]: unknown }[];
@@ -99,6 +94,12 @@ export interface Scenario {
      * all scenarios and can only contain one scenario's mock data at a time.
      */
     runAlone?: boolean;
+    /**
+     * When true, this scenario's screenshots need to be recaptured.
+     * Set when entity code changed but data structure didn't (scenarios reused from previous analysis).
+     * The capture process should check this flag and recapture if needed.
+     */
+    needsRecapture?: boolean;
   };
   previousVersionId?: string;
   analysis?: Analysis;