@codeyam/codeyam-cli 0.1.0-staging.c1c8678 → 0.1.0-staging.c276166

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

@@ -0,0 +1,166 @@
+import { findProjectRoot } from "./project.js";
+import { initializeEnvironment, requireBranchAndProject } from "./database.js";
+import { generateProjectSlug } from "./slugUtils.js";
+import Database from 'better-sqlite3';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Commands hidden from the default help section.
+ * All require simulations to be enabled via the dashboard.
+ */
+export const HIDDEN_COMMANDS = [
+    { name: 'init', describe: 'Initialize a project for CodeYam CLI analysis' },
+    { name: 'update-config', describe: 'Update project configuration' },
+    { name: 'setup-simulations', describe: 'Enable simulation commands' },
+    { name: 'analyze', describe: 'Analyze local code changes before committing' },
+    {
+        name: 'verify',
+        describe: 'Detect changed visual/library entities and verify',
+    },
+    {
+        name: 'test-startup',
+        describe: 'Test project startup without external services',
+    },
+    {
+        name: 'setup-sandbox',
+        describe: 'Create sandbox copy for iterating on startup',
+    },
+    { name: 'recapture', describe: 'Re-run capture for an analysis or scenario' },
+    { name: 'baseline', describe: 'Run baseline analysis of all entities' },
+    {
+        name: 'debug',
+        describe: 'Setup debug environment for an analysis or scenario',
+    },
+    {
+        name: 'generate-data-structure',
+        describe: 'Generate Jest mock template via partial analysis',
+    },
+    { name: 'suggest', describe: 'Suggest components for analysis' },
+    { name: 'status', describe: 'Show status of local code changes vs database' },
+    { name: 'entities', describe: 'Search for entities in the project by name' },
+    { name: 'queue', describe: 'Show the current job queue status' },
+    {
+        name: 'validate-mock',
+        describe: 'Validate a universal mock file before applying',
+    },
+    {
+        name: 'report',
+        describe: 'Create a debug bundle for sharing with the CodeYam team',
+    },
+    {
+        name: 'wipe',
+        describe: 'Delete all analysis data (entities, analyses, scenarios)',
+    },
+];
+export const HIDDEN_COMMAND_NAMES = HIDDEN_COMMANDS.map((c) => c.name);
+/**
+ * Load project context from the DB for middleware use.
+ * Stashes the result on argv.__projectContext to avoid duplicate loads
+ * when multiple middlewares need the same data.
+ */
+export async function loadProjectForMiddleware(argv) {
+    if (argv.__projectContext) {
+        return argv.__projectContext;
+    }
+    const projectRoot = findProjectRoot();
+    if (!projectRoot)
+        return null;
+    const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+    if (!fs.existsSync(configPath))
+        return null;
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    let { projectSlug } = config;
+    if (!projectSlug)
+        return null;
+    // Fix legacy local- slugs (included username, not stable across machines)
+    if (projectSlug.startsWith('local-')) {
+        projectSlug = generateProjectSlug(projectRoot);
+        config.projectSlug = projectSlug;
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    }
+    await initializeEnvironment();
+    const { project } = await requireBranchAndProject(projectSlug);
+    const context = { projectRoot, projectSlug, project };
+    argv.__projectContext = context;
+    return context;
+}
+/**
+ * Middleware that gates simulation commands behind the labs.simulations flag.
+ * Runs before command execution — for non-simulation commands, returns immediately.
+ */
+export async function simulationGateMiddleware(argv) {
+    const command = String(argv._[0] ?? '');
+    if (!HIDDEN_COMMAND_NAMES.includes(command)) {
+        return;
+    }
+    try {
+        const context = await loadProjectForMiddleware(argv);
+        if (!context) {
+            // Not in a project — let the command handle its own error
+            return;
+        }
+        if (!context.project.metadata?.labs?.simulations) {
+            console.error(`\n"codeyam ${command}" requires simulations to be enabled.`);
+            console.error('Enable simulations from the CodeYam dashboard.\n');
+            process.exit(1);
+        }
+    }
+    catch {
+        // If we can't load the project, let the command handle it
+        return;
+    }
+}
+/**
+ * Synchronously check if the current project has simulations enabled
+ * by reading the SQLite database directly. Returns false if not in a
+ * project or if the flag isn't set.
+ */
+function areSimulationsEnabled() {
+    try {
+        const projectRoot = findProjectRoot();
+        if (!projectRoot)
+            return false;
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        if (!fs.existsSync(configPath))
+            return false;
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        const { projectSlug } = config;
+        if (!projectSlug)
+            return false;
+        const dbPath = path.join(projectRoot, '.codeyam', 'db.sqlite3');
+        if (!fs.existsSync(dbPath))
+            return false;
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            const row = db
+                .prepare('SELECT metadata FROM projects WHERE slug = ?')
+                .get(projectSlug);
+            if (!row?.metadata)
+                return false;
+            const metadata = JSON.parse(row.metadata);
+            return !!metadata?.labs?.simulations;
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build the epilogue string for --help. Only shows hidden commands
+ * when simulations are enabled for the current project.
+ */
+export function buildSimulationEpilogue() {
+    if (!areSimulationsEnabled()) {
+        return 'Enable simulations from the CodeYam dashboard to unlock more commands.';
+    }
+    const maxNameLen = Math.max(...HIDDEN_COMMANDS.map((c) => c.name.length));
+    const lines = HIDDEN_COMMANDS.map((c) => {
+        const padded = c.name.padEnd(maxNameLen + 2);
+        return `  codeyam ${padded}${c.describe}`;
+    });
+    return `All Commands:\n${lines.join('\n')}`;
+}
+//# sourceMappingURL=simulationGateMiddleware.js.map

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

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

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

@@ -0,0 +1,25 @@
+import { execSync } from 'child_process';
+import * as path from 'path';
+/**
+ * Generate a stable project slug from the project path.
+ * Prefers GitHub-derived slugs (owner-repo), falls back to directory name.
+ * Never includes username or other machine-specific values.
+ */
+export function generateProjectSlug(projectPath) {
+    try {
+        const gitConfig = execSync('git config --get remote.origin.url', {
+            cwd: projectPath,
+            encoding: 'utf8',
+        }).trim();
+        const githubMatch = gitConfig.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
+        if (githubMatch) {
+            return `${githubMatch[1]}-${githubMatch[2]}`;
+        }
+    }
+    catch {
+        // Not a git repo or no remote
+    }
+    // Fallback: directory name only (stable across machines and clones)
+    return path.basename(projectPath);
+}
+//# sourceMappingURL=slugUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slugUtils.js","sourceRoot":"","sources":["../../../../src/utils/slugUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,oCAAoC,EAAE;YAC/D,GAAG,EAAE,WAAW;YAChB,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CACjC,6CAA6C,CAC9C,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IAED,oEAAoE;IACpE,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC"}

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

@@ -1,10 +1,7 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { findProjectRoot } from "./project.js";
-import { initializeEnvironment, requireBranchAndProject } from "./database.js";
 import { syncUniversalMocks } from "./syncUniversalMocks.js";
-// Commands that should NOT trigger sync
-const SKIP_SYNC_COMMANDS = ['init', 'help', 'version', '$0'];
+import { loadProjectForMiddleware } from "./simulationGateMiddleware.js";
+// Commands that should NOT trigger sync (editor/start run init internally)
+const SKIP_SYNC_COMMANDS = ['init', 'editor', 'start', 'help', 'version', '$0'];
 /**
  * Middleware that syncs universal mocks before command execution.
  * This runs automatically for most commands to keep .codeyam/universal-mocks/
@@ -16,28 +13,12 @@ export async function syncMocksMiddleware(argv) {
     if (SKIP_SYNC_COMMANDS.includes(command)) {
         return;
     }
-    // Check if we're in a codeyam project
-    const projectRoot = findProjectRoot();
-    if (!projectRoot) {
-        return; // Not in a codeyam project, skip sync
-    }
-    const configPath = path.join(projectRoot, '.codeyam', 'config.json');
-    if (!fs.existsSync(configPath)) {
-        return; // No config file, skip sync
-    }
     try {
-        // Load project config
-        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-        const { projectSlug } = config;
-        if (!projectSlug) {
-            return; // No project slug, skip sync
-        }
-        // Initialize environment (sets up database connection)
-        await initializeEnvironment();
-        // Load project from database
-        const { project } = await requireBranchAndProject(projectSlug);
+        const context = await loadProjectForMiddleware(argv);
+        if (!context)
+            return;
         // Sync mocks
-        const result = await syncUniversalMocks(projectRoot, project);
+        const result = await syncUniversalMocks(context.projectRoot, context.project);
         if (result.synced) {
             console.log(`Synced ${result.mockCount} universal mock(s) from .codeyam/universal-mocks/`);
         }

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

@@ -1 +1 @@
-{"version":3,"file":"syncMocksMiddleware.js","sourceRoot":"","sources":["../../../../src/utils/syncMocksMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wCAAwC;AACxC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAGzC;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAExC,iCAAiC;IACjC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,sCAAsC;IAChD,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,4BAA4B;IACtC,CAAC;IAED,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAE/B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,6BAA6B;QACvC,CAAC;QAED,uDAAuD;QACvD,MAAM,qBAAqB,EAAE,CAAC;QAE9B,6BAA6B;QAC7B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;QAE/D,aAAa;QACb,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE9D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CACT,UAAU,MAAM,CAAC,SAAS,mDAAmD,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2CAA2C;QAC3C,OAAO,CAAC,IAAI,CACV,0CAA0C,EAC1C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"syncMocksMiddleware.js","sourceRoot":"","sources":["../../../../src/utils/syncMocksMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAGzC;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAExC,iCAAiC;IACjC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,aAAa;QACb,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,OAAO,CAChB,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CACT,UAAU,MAAM,CAAC,SAAS,mDAAmD,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2CAA2C;QAC3C,OAAO,CAAC,IAAI,CACV,0CAA0C,EAC1C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,eAAe,mBAAmB,CAAC"}

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

@@ -0,0 +1,158 @@
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Detect whether the project uses vitest or jest by checking package.json devDependencies.
+ */
+function detectTestRunner(projectRoot) {
+    try {
+        const pkgPath = path.join(projectRoot, 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        const allDeps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if (allDeps.vitest)
+            return 'vitest';
+        if (allDeps.jest)
+            return 'jest';
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse the JSON output from vitest or jest into a TestFileResult.
+ * Both produce a compatible shape:
+ *   { testResults: [{ assertionResults: [{ title, status, ancestorTitles, failureMessages }] }] }
+ */
+function parseTestOutput(testFilePath, jsonOutput) {
+    const data = JSON.parse(jsonOutput);
+    const testResults = data.testResults || [];
+    const testCases = [];
+    for (const suite of testResults) {
+        for (const assertion of suite.assertionResults || []) {
+            const ancestors = assertion.ancestorTitles || [];
+            const title = assertion.title || assertion.fullName || 'unknown';
+            const fullName = ancestors.length > 0 ? `${ancestors.join(' > ')} > ${title}` : title;
+            testCases.push({
+                title,
+                fullName,
+                status: assertion.status === 'passed'
+                    ? 'passed'
+                    : assertion.status === 'failed'
+                        ? 'failed'
+                        : 'skipped',
+                duration: assertion.duration,
+                failureMessages: assertion.failureMessages?.length
+                    ? assertion.failureMessages
+                    : undefined,
+            });
+        }
+    }
+    const hasFailures = testCases.some((t) => t.status === 'failed');
+    return {
+        testFilePath,
+        status: hasFailures ? 'failed' : 'passed',
+        testCases,
+    };
+}
+/**
+ * Run a single test file and return structured results.
+ */
+export async function runTestFile(projectRoot, testFilePath) {
+    const runner = detectTestRunner(projectRoot);
+    if (!runner) {
+        return {
+            testFilePath,
+            status: 'error',
+            testCases: [],
+            errorMessage: 'No test runner found (install vitest or jest)',
+        };
+    }
+    const absoluteTestPath = path.isAbsolute(testFilePath)
+        ? testFilePath
+        : path.join(projectRoot, testFilePath);
+    if (!fs.existsSync(absoluteTestPath)) {
+        return {
+            testFilePath,
+            status: 'error',
+            testCases: [],
+            errorMessage: 'Test file not found',
+        };
+    }
+    const tmpPath = path.join(os.tmpdir(), `codeyam-test-result-${Date.now()}.json`);
+    return new Promise((resolve) => {
+        let args;
+        let cmd;
+        if (runner === 'vitest') {
+            cmd = 'node';
+            args = [
+                './node_modules/.bin/vitest',
+                'run',
+                '--reporter=json',
+                '--outputFile',
+                tmpPath,
+                testFilePath,
+            ];
+        }
+        else {
+            cmd = './node_modules/.bin/jest';
+            args = [
+                '--json',
+                '--outputFile',
+                tmpPath,
+                '--testPathPatterns',
+                testFilePath,
+            ];
+        }
+        const child = spawn(cmd, args, {
+            cwd: projectRoot,
+            stdio: 'pipe',
+            env: { ...process.env, NODE_ENV: 'test' },
+        });
+        let stderr = '';
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        const timeout = setTimeout(() => {
+            child.kill('SIGTERM');
+            resolve({
+                testFilePath,
+                status: 'error',
+                testCases: [],
+                errorMessage: 'Test timed out after 30 seconds',
+            });
+        }, 30000);
+        child.on('close', () => {
+            clearTimeout(timeout);
+            try {
+                const jsonOutput = fs.readFileSync(tmpPath, 'utf8');
+                fs.unlinkSync(tmpPath);
+                resolve(parseTestOutput(testFilePath, jsonOutput));
+            }
+            catch {
+                // JSON output file wasn't created — runner crashed
+                resolve({
+                    testFilePath,
+                    status: 'error',
+                    testCases: [],
+                    errorMessage: stderr.trim().slice(0, 500) ||
+                        'Test runner failed to produce output',
+                });
+            }
+        });
+        child.on('error', (err) => {
+            clearTimeout(timeout);
+            resolve({
+                testFilePath,
+                status: 'error',
+                testCases: [],
+                errorMessage: `Failed to spawn test runner: ${err.message}`,
+            });
+        });
+    });
+}
+//# sourceMappingURL=testRunner.js.map

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

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

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

@@ -0,0 +1,67 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { getProjectRoot } from "../state.js";
+export async function pathExists(p) {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolve project slug from .codeyam/config.json. */
+export async function resolveProjectSlug() {
+    try {
+        const projectRoot = getProjectRoot();
+        if (!projectRoot)
+            return null;
+        const configPath = path.join(projectRoot, '.codeyam', 'config.json');
+        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        return config.projectSlug || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function getTasksDir() {
+    const projectRoot = getProjectRoot() || process.cwd();
+    // Encode path: replace leading / then all / with -
+    const encoded = projectRoot.replace(/^\//, '').replace(/\//g, '-');
+    return `/private/tmp/claude-501/-${encoded}/tasks`;
+}
+export const HOOKS_DIR = '/tmp/claude-rule-markers';
+const MAX_AGE_MS = 14 * 24 * 60 * 60 * 1000; // 14 days
+export async function pruneOldTranscripts() {
+    const cutoff = Date.now() - MAX_AGE_MS;
+    let deleted = 0;
+    async function pruneDir(dir, extensions) {
+        if (!(await pathExists(dir)))
+            return;
+        const entries = await fs.readdir(dir);
+        for (const entry of entries) {
+            if (!extensions.some((ext) => entry.endsWith(ext)))
+                continue;
+            const filePath = path.join(dir, entry);
+            try {
+                const stats = await fs.stat(filePath);
+                if (stats.mtimeMs < cutoff) {
+                    await fs.unlink(filePath);
+                    deleted++;
+                }
+            }
+            catch {
+                // File may have been removed concurrently; skip
+            }
+        }
+    }
+    await pruneDir(getTasksDir(), ['.output']);
+    await pruneDir(HOOKS_DIR, ['.log', '.context', '.marker']);
+    // Also prune slug-scoped subdirectory
+    const slug = await resolveProjectSlug();
+    if (slug) {
+        await pruneDir(path.join(HOOKS_DIR, slug), ['.log', '.context', '.marker']);
+    }
+    return deleted;
+}
+//# sourceMappingURL=transcriptPruning.js.map

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

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

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

@@ -62,8 +62,54 @@ function computeCliVersion() {
     }
     return 'unknown';
 }
+/**
+ * Get the npm package version from package.json (computed once at module load)
+ *
+ * This is the version published to npm (e.g., "0.1.1"), which differs from the
+ * build-info semanticVersion (e.g., "0.1.644") that uses build numbers.
+ * Used for npm update checks where we need to compare against registry versions.
+ */
+function computeNpmPackageVersion() {
+    const cliRoot = findCliPackageRoot();
+    if (cliRoot) {
+        const packageJsonPath = path.join(cliRoot, 'package.json');
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            if (packageJson.version) {
+                return packageJson.version;
+            }
+        }
+        catch {
+            // Fall through to unknown
+        }
+    }
+    return 'unknown';
+}
 /** The CLI version string, e.g. "0.1.486" */
 export const cliVersion = computeCliVersion();
+/** The npm package version from package.json, e.g. "0.1.1" */
+export const npmPackageVersion = computeNpmPackageVersion();
+/**
+ * Version string for `codeyam --version`.
+ * CI-published builds show the npm semver; local dev builds show the build counter.
+ */
+export function getDisplayVersion() {
+    if (npmPackageVersion !== 'unknown' && npmPackageVersion !== '0.1.0') {
+        return npmPackageVersion;
+    }
+    const cliRoot = findCliPackageRoot();
+    if (cliRoot) {
+        for (const p of [
+            path.join(cliRoot, 'src/webserver/build-info.json'),
+            path.join(cliRoot, 'codeyam-cli/src/webserver/build-info.json'),
+        ]) {
+            const info = readBuildInfo(p);
+            if (info?.buildNumber)
+                return `dev (build ${info.buildNumber})`;
+        }
+    }
+    return 'dev';
+}
 /**
  * Get comprehensive version information for display
  */

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

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

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

@@ -16,10 +16,16 @@ function detectFrameworkFromPackageJson(packageJsonPath) {
         };
         if (deps.next)
             return ProjectFramework.Next;
-        if (deps['@remix-run/node'] || deps['@remix-run/react'] || deps['react-router'])
+        if (deps['@remix-run/node'] ||
+            deps['@remix-run/react'] ||
+            deps['react-router'])
             return ProjectFramework.Remix;
         if (deps['react-scripts'])
             return ProjectFramework.CRA;
+        if (deps.expo)
+            return ProjectFramework.Expo;
+        if (deps.vite)
+            return ProjectFramework.Vite;
         return ProjectFramework.Unknown;
     }
     catch (error) {
@@ -96,6 +102,7 @@ function isWebAppDirectory(dirPath) {
             'react-scripts',
             'webpack-dev-server',
             'parcel',
+            'expo',
         ];
         const possibleStartAndBuildScripts = Object.keys(scripts).filter((script) => ['dev', 'start', 'serve', 'build'].some((keyword) => script.includes(keyword)));
         const scriptsWithWebappPattern = possibleStartAndBuildScripts.filter((scriptName) => webappPatterns.some((pattern) => scripts[scriptName].includes(pattern)));
@@ -111,7 +118,8 @@ function isWebAppDirectory(dirPath) {
                 const actualWebappPath = path.join(dirPath, cdTarget);
                 // If the script explicitly cd's into a directory to run the webapp command,
                 // trust that directory as the actual webapp location
-                if (fs.existsSync(actualWebappPath) && fs.statSync(actualWebappPath).isDirectory()) {
+                if (fs.existsSync(actualWebappPath) &&
+                    fs.statSync(actualWebappPath).isDirectory()) {
                     // Return the actual webapp subdirectory path
                     return { isWebApp: true, actualPath: actualWebappPath };
                 }
@@ -193,11 +201,20 @@ export function detectWebApps(projectRoot) {
                 appDirectory = 'app';
             }
         }
+        // Auto-detect startCommand from package.json scripts
+        const startScript = getDefaultStartScript(webappPath, projectRoot);
+        const startCommand = startScript
+            ? {
+                command: 'sh',
+                args: ['-c', `${packageManager} run ${startScript} -- --port $PORT`],
+            }
+            : undefined;
         return {
             path: webappPath,
             framework,
             packageManager,
             appDirectory,
+            startCommand,
         };
     });
     return webapps;
@@ -227,6 +244,22 @@ export function getDefaultStartScript(webappPath, projectRoot) {
         return null;
     }
 }
+/**
+ * Merge detected webapps with existing config webapps.
+ * Detected webapps take precedence, but manually-configured webapps
+ * (those with a startCommand that aren't in the detected set) are preserved.
+ */
+export function mergeWebApps(detected, existing) {
+    const detectedPaths = new Set(detected.map((w) => w.path));
+    const merged = [...detected];
+    for (const existingWebapp of existing) {
+        if (!detectedPaths.has(existingWebapp.path)) {
+            // Preserve manually-configured webapps not found by detection
+            merged.push(existingWebapp);
+        }
+    }
+    return merged;
+}
 /**
  * Find which webapp a component belongs to based on its file path
  * Returns the webapp that contains the component, or the first webapp as fallback