@codeyam/codeyam-cli 0.1.0-staging.dd216e0 → 0.1.0-staging.df25827

package/codeyam-cli/src/commands/editorAnalyzeImportsArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorAnalyzeImportsArgs.js","sourceRoot":"","sources":["../../../../src/commands/editorAnalyzeImportsArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAwB,EACxB,MAA2B;IAE3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,wEAAwE;IACxE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/codeyam-cli/src/commands/editorIsolateArgs.js

@@ -0,0 +1,25 @@
+/**
+ * Parse component names for `codeyam editor isolate`.
+ *
+ * Supports multiple calling conventions:
+ *   codeyam editor isolate "A B C"     → json="A B C", extras=[]
+ *   codeyam editor isolate A B C       → json="A", extras=["editor","B","C"]
+ *   codeyam editor isolate A,B,C       → json="A,B,C", extras=[]
+ *   codeyam editor isolate A           → json="A", extras=[]
+ */
+export function parseIsolateArgs(json, extras) {
+    const names = [];
+    // Split json arg by whitespace or commas
+    if (json) {
+        names.push(...json.split(/[\s,]+/).filter(Boolean));
+    }
+    // Collect extra positional args, filtering out "editor"
+    for (const arg of extras) {
+        if (typeof arg === 'string' && arg !== 'editor') {
+            names.push(arg);
+        }
+    }
+    // Deduplicate while preserving order
+    return [...new Set(names)];
+}
+//# sourceMappingURL=editorIsolateArgs.js.map

package/codeyam-cli/src/commands/editorIsolateArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorIsolateArgs.js","sourceRoot":"","sources":["../../../../src/commands/editorIsolateArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAwB,EACxB,MAA2B;IAE3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yCAAyC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,wDAAwD;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/codeyam-cli/src/commands/init.js

@@ -1,23 +1,19 @@
 import * as fs from 'fs/promises';
 import * as fsSync from 'fs';
 import * as path from 'path';
-import { execSync } from 'child_process';
+import chalk from 'chalk';
+import { generateProjectSlug } from "../utils/slugUtils.js";
 import { error, header, info, ProgressReporter, success, withoutSpinner, } from "../utils/progress.js";
 import { ensureLocalBranch, ensureProject, getSqlitePath, testEnvironment, } from "../utils/database.js";
-import { createAnalyzer, getProjectPath } from "../utils/analyzer.js";
-import { ProjectAnalyzer } from "../../../packages/analyze/index.js";
-import prepareRepo from "../../../background/src/lib/virtualized/project/prepareRepo.js";
-import { createSqliteSchema, getSqliteDatabase, loadAnalyses, loadEntities, loadFiles, } from "../../../packages/database/index.js";
-import getFilesWithEntitiesFromRepo from "../../../background/src/lib/virtualized/project/getFilesWithEntitiesFromRepo.js";
-import createEntitiesAndSortFiles from "../../../background/src/lib/virtualized/project/createEntitiesAndSortFiles.js";
-import { findProjectRoot } from "../utils/project.js";
+import { createSqliteSchema, getSqliteDatabase, updateProjectMetadata, } from "../../../packages/database/index.js";
+import { findProjectRoot, isForbiddenProjectRoot } from "../utils/project.js";
 import { setProjectRoot } from "../state.js";
-import { populateEntityMetadata } from "../utils/entityMetadata.js";
 import { installClaudeCodeSkills } from "../utils/install-skills.js";
 import { setupClaudeCodeSettings } from "../utils/setupClaudeCodeSettings.js";
 import { getUnapprovedPathsWithGitignore } from "../utils/defaultUnapprovedPaths.js";
 import { detectWebApps } from "../utils/webappDetection.js";
 import { isServerRunning, killServer } from "../utils/serverState.js";
+import { readPreservedConfigProperties } from "../utils/editorScenarios.js";
 const initCommand = {
     command: 'init',
     describe: 'Initialize a project for CodeYam CLI analysis',
@@ -28,6 +24,17 @@ const initCommand = {
             describe: 'Force initialization even if .codeyam already exists',
             default: false,
         },
+        'keep-server': {
+            type: 'boolean',
+            describe: 'Skip stopping the running CodeYam server (use when running inside the editor)',
+            default: false,
+        },
+        provider: {
+            type: 'string',
+            describe: 'The AI provider for the editor (claude, gemini, or codex)',
+            choices: ['claude', 'gemini', 'codex'],
+            default: 'claude',
+        },
     },
     handler: async (argv) => {
         header('Initializing CodeYam CLI project');
@@ -40,16 +47,16 @@ const initCommand = {
         if (!projectRoot) {
             projectRoot = process.cwd();
         }
+        if (isForbiddenProjectRoot(projectRoot)) {
+            error('Cannot initialize CodeYam in your home directory or filesystem root.');
+            error('Please run codeyam init from inside a project directory.');
+            return;
+        }
         setProjectRoot(projectRoot);
-        // Stop any running CodeYam server before reinitializing
-        const { running, state, pids } = isServerRunning();
-        if (running) {
-            if (state) {
-                info(`Stopping running CodeYam server (PID: ${state.pid})...`);
-            }
-            else if (pids && pids.length > 0) {
-                info(`Stopping ${pids.length} running CodeYam server process${pids.length > 1 ? 'es' : ''} (PID${pids.length > 1 ? 's' : ''}: ${pids.join(', ')})...`);
-            }
+        // Stop any running CodeYam server before reinitializing —
+        // unless --keep-server is passed (e.g. when running inside the editor terminal).
+        const { running } = isServerRunning();
+        if (running && !argv['keep-server']) {
             const stopped = killServer();
             if (stopped) {
                 success('CodeYam server stopped');
@@ -62,194 +69,134 @@ const initCommand = {
         const configPath = path.join(codeyamDir, 'config.json');
         const progress = new ProgressReporter();
         try {
-            // Create directory structure
-            progress.start('Creating .codeyam directory structure...');
+            // Create .codeyam dir + .gitignore entry
+            progress.start('Setting up project scaffolding...');
             await fs.mkdir(codeyamDir, { recursive: true });
-            await fs.mkdir(path.join(codeyamDir, 'results'), { recursive: true });
-            await fs.mkdir(path.join(codeyamDir, 'captures'), { recursive: true });
-            await fs.mkdir(path.join(codeyamDir, 'universal-mocks'), {
-                recursive: true,
-            });
-            progress.succeed('Created .codeyam directory structure');
-            // Add .codeyam to .gitignore to prevent committing secrets
-            progress.start('Updating .gitignore...');
-            await ensureGitignoreEntry(projectRoot, '.codeyam');
-            progress.succeed('Updated .gitignore');
-            // Generate project slug
-            progress.start('Detecting project configuration...');
-            const projectSlug = generateProjectSlug(projectRoot);
+            await ensureGitignoreEntry(projectRoot);
+            progress.succeed('Project scaffolding ready');
+            // Preserve existing slug from config.json unless it's a legacy local-
+            // slug (which included the username and is not stable across machines).
+            let projectSlug = generateProjectSlug(projectRoot);
+            try {
+                const existingConfig = JSON.parse(fsSync.readFileSync(configPath, 'utf8'));
+                if (existingConfig.projectSlug &&
+                    !existingConfig.projectSlug.startsWith('local-')) {
+                    projectSlug = existingConfig.projectSlug;
+                }
+            }
+            catch {
+                // No existing config — use generated slug
+            }
             const packageManager = detectPackageManager(projectRoot);
-            progress.succeed('Detected project configuration');
-            // Detect webapps in the project
-            progress.start('Detecting web applications...');
-            const detectedWebapps = detectWebApps(projectRoot);
-            if (detectedWebapps.length === 0) {
-                progress.fail('No web applications found');
-                error('CodeYam only supports web applications (Next.js, Remix, CRA)');
-                info('Make sure your project has a package.json with React dependencies');
-                return;
+            // Detect webapps (soft — doesn't block init for non-webapp projects)
+            let detectedWebapps = [];
+            try {
+                detectedWebapps = detectWebApps(projectRoot);
             }
-            progress.succeed(`Found ${detectedWebapps.length} web application${detectedWebapps.length > 1 ? 's' : ''}`);
-            // Display detected webapps
-            for (const webapp of detectedWebapps) {
-                info(`  • ${webapp.path === '.' ? 'Root' : webapp.path}: ${webapp.framework}`);
+            catch {
+                // Webapp detection is best-effort
             }
-            // ADMIN: commenting out for now as it's not working very well...
-            // // Detect files that use environment variables (only in webapp directories)
-            // progress.start('Scanning for files that use environment variables...');
-            // const webappPaths = detectedWebapps.map((w) => w.path);
-            // const detectedEnvVars = await detectEnvironmentVariables(
-            //   projectRoot,
-            //   webappPaths
-            // );
-            // if (detectedEnvVars.length > 0) {
-            //   progress.succeed(
-            //     `Found ${detectedEnvVars.length} file${detectedEnvVars.length > 1 ? 's' : ''} in webapp${webappPaths.length > 1 ? 's' : ''} using environment variables`
-            //   );
-            //   info(`  These files will need simple mocks during setup`);
-            // } else {
-            //   progress.succeed('No files in webapps using environment variables');
-            // }
-            // Create config.json
-            progress.start('Writing configuration file...');
+            if (detectedWebapps.length > 0) {
+                const webappSummary = detectedWebapps
+                    .map((w) => `${w.path === '.' ? 'Root' : w.path} (${w.framework})`)
+                    .join(', ');
+                info(`Found ${detectedWebapps.length} web application${detectedWebapps.length > 1 ? 's' : ''}: ${webappSummary}`);
+            }
+            // Config, database, environment validation, and project creation
+            progress.start('Configuring project...');
+            // Preserve user-configured properties (defaultScreenSize, screenSizes, etc.)
+            // before overwriting the config — these survive re-init.
+            const preserved = readPreservedConfigProperties(configPath);
             const config = {
                 projectSlug,
                 packageManager,
                 webapps: detectedWebapps,
-                environmentVariables: [], //detectedEnvVars,
+                environmentVariables: [],
                 createdAt: new Date().toISOString(),
+                provider: argv.provider || 'claude',
+                handoff: {},
+                ...preserved,
             };
             await fs.writeFile(configPath, JSON.stringify(config, null, 2));
-            progress.succeed('Created configuration file');
             const sqlitePath = getSqlitePath();
             if (!fsSync.existsSync(sqlitePath)) {
-                progress.start('Creating local database...');
                 const newDatabase = getSqliteDatabase(sqlitePath);
                 await createSqliteSchema(newDatabase);
-                progress.succeed('Local database ready');
             }
-            // Test database connection and create project
-            progress.start('Validating environment...');
             const connectionOk = await withoutSpinner(() => testEnvironment());
             if (!connectionOk) {
                 progress.fail('Environment validation failed');
                 return;
             }
-            progress.succeed('Environment validated');
-            // Create project in database
-            progress.start('Validating project and analyzer...');
             try {
-                const { project, created: projectCreated } = await ensureProject({
+                const { project } = await ensureProject({
                     slug: projectSlug,
                     packageManager,
                     unapprovedPaths: getUnapprovedPathsWithGitignore(projectRoot),
                     webapps: detectedWebapps,
                 });
-                progress.succeed(projectCreated ? 'Created new project' : 'Loaded existing project');
-                info(`Database ID: ${project?.id}`);
-                // Install Claude Code skills for guided setup
+                progress.succeed('Project configured');
+                // Skills, local branch, and auto-approval
                 progress.start('Installing Claude Code skills...');
-                const skillsResult = await installClaudeCodeSkills(projectRoot);
+                const editorMode = !!argv['keep-server'];
+                const skillsResult = await installClaudeCodeSkills(projectRoot, {
+                    mode: editorMode ? 'editor' : 'memory',
+                    editorMode,
+                });
+                const { branch: localBranch } = await ensureLocalBranch(project);
+                config.branchId = localBranch.id;
+                await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+                setupClaudeCodeSettings(projectRoot, {
+                    mode: editorMode ? 'editor' : 'memory',
+                    editorMode,
+                });
                 if (skillsResult.success) {
-                    progress.succeed(`Installed skills to ${skillsResult.skillsPath}/`);
+                    progress.succeed('Claude Code skills installed');
                 }
                 else {
                     progress.warn('Could not install skills');
-                    info(`Reason: ${skillsResult.error}`);
-                }
-                // Create _local branch for local development
-                progress.start('Creating local development branch...');
-                const { branch: localBranch, created: branchCreated } = await ensureLocalBranch(project);
-                if (branchCreated) {
-                    progress.succeed('Created _local branch');
                 }
-                // Create baseline entities in database
-                progress.start('Analyzing project and creating baseline entities...');
-                await createBaselineEntities(project, localBranch, projectRoot);
-                progress.succeed('Baseline entities created');
-                // Update config with branch ID for future reference
-                config.branchId = localBranch.id;
-                await fs.writeFile(configPath, JSON.stringify(config, null, 2));
-                // Warm analyzer cache for faster first analysis
-                progress.start('Setting up analyzer...');
-                await createAnalyzer(projectSlug);
-                progress.succeed('Analyzer ready for fast analysis');
-                // Cache project for faster subsequent runs
-                progress.start('Caching project files...');
-                await prepareRepo({
-                    absoluteProjectRootPath: getProjectPath(projectSlug),
-                    localProjectPath: projectRoot,
-                    silent: true,
-                });
-                progress.succeed('Project cache ready');
-                // // Install Claude Code skills for guided setup
-                // progress.start('Installing Claude Code skills...');
-                // const skillsResult = await installClaudeCodeSkills(projectRoot);
-                // if (skillsResult.success) {
-                //   progress.succeed(`Installed skills to ${skillsResult.skillsPath}/ (templates from ${skillsResult.templatesDir})`);
-                // } else {
-                //   progress.warn('Could not install skills');
-                //   info(`Reason: ${skillsResult.error}`);
-                // }
-                // Configure auto-approval for CodeYam commands and skills
-                progress.start('Configuring auto-approval permissions...');
-                const permissionsConfigured = setupClaudeCodeSettings(projectRoot);
-                if (permissionsConfigured) {
-                    progress.succeed('Auto-approval configured for CodeYam commands and skills');
+                // When running inside the editor (--keep-server), enable simulations
+                // and editor mode so `codeyam analyze` works immediately.
+                // Otherwise disable simulations by default.
+                try {
+                    if (argv['keep-server']) {
+                        await updateProjectMetadata({
+                            projectSlug,
+                            metadataUpdate: {
+                                editorMode: true,
+                                labs: { simulations: true },
+                            },
+                        });
+                    }
+                    else {
+                        await updateProjectMetadata({
+                            projectSlug,
+                            metadataUpdate: { labs: { simulations: false } },
+                        });
+                    }
                 }
-                else {
-                    progress.warn('Could not configure auto-approval');
-                    info('You may need to approve CodeYam commands manually');
+                catch {
+                    // Non-fatal
                 }
                 // AI Mode: Default to interactive (Claude Code)
-                // API key support exists but is not exposed in init flow yet
                 config.aiMode = 'interactive';
             }
             catch (err) {
-                progress.fail('Failed to create project and analyzer');
+                progress.fail('Failed to create project');
                 error(err.message);
                 return;
             }
+            const frameworkInfo = detectedWebapps.length > 0
+                ? `, ${detectedWebapps.map((w) => w.framework).join(', ')}`
+                : '';
             console.log();
-            success(`Initialized project: ${projectSlug}`);
-            info(`Package Manager: ${packageManager}`);
-            if (detectedWebapps.length === 1) {
-                info(`Framework: ${detectedWebapps[0].framework}`);
-                if (detectedWebapps[0].path !== '.') {
-                    info(`Webapp Path: ${detectedWebapps[0].path}`);
-                }
-            }
-            else {
-                info(`Web Applications: ${detectedWebapps.length}`);
-                for (const webapp of detectedWebapps) {
-                    info(`  • ${webapp.path === '.' ? 'Root' : webapp.path}: ${webapp.framework}`);
-                }
+            success(`✨ Initialized ${projectSlug} (${packageManager}${frameworkInfo})`);
+            if (!argv.autoInit) {
+                console.log();
+                console.log(chalk.bold('  Run "codeyam" to start the dashboard'));
+                console.log('  Run "codeyam --help" for all commands');
             }
-            console.log();
-            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            console.log();
-            success('✨ CodeYam initialization complete!');
-            console.log();
-            console.log('📋 Next step: Complete setup with Claude Code');
-            console.log();
-            console.log('   1. Open this project in Claude Code');
-            console.log('   2. Say to Claude:');
-            console.log();
-            console.log('      "Claude, can you setup CodeYam?"');
-            console.log();
-            console.log('   Claude will guide you through:');
-            console.log('   • Detecting your project start command');
-            console.log('   • Finding dependencies that need mocking');
-            console.log('   • Configuring CodeYam to run your project');
-            console.log();
-            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            console.log();
-            console.log('💡 Tips:');
-            console.log('   • Run "codeyam" to start the dashboard');
-            console.log('   • Run "codeyam --help" for all commands');
-            console.log('   • Run "codeyam stop" to stop the background server');
-            console.log('   • Edit mock files in .codeyam/universal-mocks/');
-            console.log();
         }
         catch (err) {
             progress.fail('Failed to initialize project');
@@ -258,27 +205,6 @@ const initCommand = {
         }
     },
 };
-function generateProjectSlug(projectPath) {
-    try {
-        // Try to detect GitHub remote
-        const gitConfig = execSync('git config --get remote.origin.url', {
-            cwd: projectPath,
-            encoding: 'utf8',
-        }).trim();
-        // Parse GitHub URL: https://github.com/owner/repo.git or git@github.com:owner/repo.git
-        const githubMatch = gitConfig.match(/github\.com[:/]([^/]+)\/([^/]+?)(?:\.git)?$/);
-        if (githubMatch) {
-            return `${githubMatch[1]}-${githubMatch[2]}`;
-        }
-    }
-    catch (error) {
-        // Not a git repo or no remote, fall back to local naming
-    }
-    // Fallback: local-{username}-{dirname}
-    const username = process.env.USER || process.env.USERNAME || 'user';
-    const dirname = path.basename(projectPath);
-    return `local-${username}-${dirname}`;
-}
 function detectPackageManager(projectPath) {
     if (fsSync.existsSync(path.join(projectPath, 'pnpm-lock.yaml')))
         return 'pnpm';
@@ -289,131 +215,81 @@ function detectPackageManager(projectPath) {
     return 'npm'; // default fallback
 }
 /**
- * Create baseline entities for a project during initialization
- * This populates the database so that subsequent status/analyze commands
- * only show actual changes, not every file as "new"
+ * Machine-local .codeyam files that should NOT be committed.
+ * Shared files (config.json, editor-scenarios/, etc.) are intentionally
+ * omitted so they CAN be committed and shared across clones.
  */
-async function createBaselineEntities(project, branch, projectRootPath) {
-    // Load project with files to populate project.files
-    if (!project.files) {
-        project.files = await loadFiles({ projectId: project.id });
-    }
-    // Load existing entities to preserve version tracking
-    const existingEntities = await loadEntities({
-        projectId: project.id,
-        branchId: branch.id,
-    });
-    // Create a map of existing entities by (filePath, name)
-    const existingEntityMap = new Map();
-    if (existingEntities) {
-        for (const entity of existingEntities) {
-            const key = `${entity.filePath}:${entity.name}`;
-            if (!existingEntityMap.has(key)) {
-                existingEntityMap.set(key, new Map());
-            }
-            existingEntityMap.get(key).set(entity.sha, entity);
-        }
-    }
-    // Load analyses for existing entities
-    const existingAnalysesMap = new Map();
-    if (existingEntities && existingEntities.length > 0) {
-        const analyses = await loadAnalyses({
-            entityShas: existingEntities.map((e) => e.sha),
-        });
-        if (analyses) {
-            for (const analysis of analyses) {
-                if (!existingAnalysesMap.has(analysis.entitySha)) {
-                    existingAnalysesMap.set(analysis.entitySha, []);
-                }
-                existingAnalysesMap.get(analysis.entitySha).push(analysis);
-            }
-        }
-    }
-    // Initialize ProjectAnalyzer and populate project.files with entities
-    const projectAnalyzer = await ProjectAnalyzer.from({
-        project,
-        dirPath: projectRootPath,
-    });
-    await getFilesWithEntitiesFromRepo({
-        project: project,
-        projectAnalyzer,
-        silent: true,
-    });
-    // Now create and persist all entities to database
-    const { entityMap } = await createEntitiesAndSortFiles({
-        project,
-        branch,
-        projectAnalyzer,
-    });
-    // Populate project.files with the created entities so populateEntityMetadata can process them
-    for (const file of project.files) {
-        file.entities = [];
-        if (entityMap[file.path]) {
-            // Deduplicate entities by SHA (aliases like 'default' can point to same entity)
-            const entitiesBySha = new Map();
-            Object.values(entityMap[file.path]).forEach((entity) => {
-                entitiesBySha.set(entity.sha, entity);
-            });
-            file.entities = Array.from(entitiesBySha.values());
-            // Preserve version tracking for each entity
-            for (const entity of file.entities) {
-                const key = `${entity.filePath}:${entity.name}`;
-                const existingVersions = existingEntityMap.get(key);
-                if (existingVersions) {
-                    // Check if this exact SHA already exists
-                    const exactMatch = existingVersions.get(entity.sha);
-                    if (exactMatch) {
-                        // Exact match - preserve all metadata and analyses
-                        entity.metadata = exactMatch.metadata;
-                        entity.analyses = existingAnalysesMap.get(exactMatch.sha) || [];
-                        continue;
-                    }
-                    // Different SHA - check if any previous version has analyses
-                    const versionWithAnalyses = Array.from(existingVersions.values()).find((v) => existingAnalysesMap.has(v.sha));
-                    if (versionWithAnalyses) {
-                        // Set previousVersionWithAnalyses to track where analyses came from
-                        entity.metadata = entity.metadata || {};
-                        entity.metadata.previousVersionWithAnalyses =
-                            versionWithAnalyses.sha;
-                        entity.metadata.previousCommittedSha =
-                            versionWithAnalyses.metadata?.isUncommitted === false
-                                ? versionWithAnalyses.sha
-                                : versionWithAnalyses.metadata?.previousCommittedSha;
-                        // Inherit analyses for display
-                        entity.analyses =
-                            existingAnalysesMap.get(versionWithAnalyses.sha) || [];
-                    }
-                }
-            }
-        }
-    }
-    await populateEntityMetadata(project.files, projectRootPath, projectAnalyzer);
-}
+const CODEYAM_GITIGNORE_ENTRIES = [
+    '.codeyam/db.sqlite3',
+    '.codeyam/db.sqlite3-wal',
+    '.codeyam/db.sqlite3-shm',
+    '.codeyam/secrets.json',
+    '.codeyam/server.json',
+    '.codeyam/server-state.json',
+    '.codeyam/queue.json',
+    '.codeyam/active-scenario.json',
+    '.codeyam/editor-step.json',
+    '.codeyam/editor-user-prompt.txt',
+    '.codeyam/claude-session-id.txt',
+    '.codeyam/editor-mode-context.md',
+    '.codeyam/dev-mode-context.md',
+    '.codeyam/handoff-context.md',
+    '.codeyam/logs/',
+    '.codeyam/llm-calls/',
+    '.codeyam/captures/',
+    '.codeyam/results/',
+    '.codeyam/tmp/',
+    '.codeyam/rules/',
+    '.codeyam/bin/',
+    '.codeyam/docs/',
+];
 /**
- * Ensure a given entry exists in the project's .gitignore file
- * Creates the .gitignore if it doesn't exist
+ * Ensure granular .codeyam ignore patterns exist in .gitignore.
+ * Replaces any blanket ".codeyam" entry with granular patterns so that
+ * shared files (config.json, editor-scenarios/) can be committed.
  */
-async function ensureGitignoreEntry(projectRoot, entry) {
+async function ensureGitignoreEntry(projectRoot) {
     const gitignorePath = path.join(projectRoot, '.gitignore');
     let gitignoreContent = '';
-    // Read existing .gitignore if it exists
     try {
         gitignoreContent = await fs.readFile(gitignorePath, 'utf8');
     }
     catch (error) {
         // File doesn't exist, will create it
     }
-    // Check if entry already exists
     const lines = gitignoreContent.split('\n');
-    const entryExists = lines.some((line) => line.trim() === entry || line.trim() === `/${entry}`);
-    if (!entryExists) {
-        // Add entry with a comment
+    // If there's a blanket .codeyam ignore, replace it with granular patterns
+    const blanketIndex = lines.findIndex((line) => line.trim() === '.codeyam' || line.trim() === '/.codeyam');
+    if (blanketIndex !== -1) {
+        const removeStart = blanketIndex > 0 &&
+            lines[blanketIndex - 1].trim().startsWith('# CodeYam local files')
+            ? blanketIndex - 1
+            : blanketIndex;
+        lines.splice(removeStart, blanketIndex - removeStart + 1);
+        gitignoreContent = lines.join('\n');
+    }
+    // Check if granular patterns already exist
+    const hasGranularPatterns = CODEYAM_GITIGNORE_ENTRIES.some((entry) => lines.some((line) => line.trim() === entry));
+    if (!hasGranularPatterns) {
+        const block = '\n# CodeYam - local only (not shared)\n' +
+            CODEYAM_GITIGNORE_ENTRIES.join('\n') +
+            '\n';
         const newContent = gitignoreContent +
             (gitignoreContent && !gitignoreContent.endsWith('\n') ? '\n' : '') +
-            '\n# CodeYam local files (contains secrets and local database)\n' +
-            `.codeyam\n`;
+            block;
         await fs.writeFile(gitignorePath, newContent, 'utf8');
     }
+    else {
+        // Add any missing entries from the current list (handles upgrades)
+        const missingEntries = CODEYAM_GITIGNORE_ENTRIES.filter((entry) => !lines.some((line) => line.trim() === entry));
+        if (missingEntries.length > 0) {
+            const updatedContent = gitignoreContent +
+                (gitignoreContent && !gitignoreContent.endsWith('\n') ? '\n' : '') +
+                missingEntries.join('\n') +
+                '\n';
+            await fs.writeFile(gitignorePath, updatedContent, 'utf8');
+        }
+    }
 }
 export default initCommand;
 //# sourceMappingURL=init.js.map