@codeyam/codeyam-cli 0.1.0-staging.fef152f → 0.1.0-staging.fff1b4e

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

@@ -38,7 +38,7 @@ export function setupClaudeCodeSettings(projectRoot, options) {
             settings.permissions.allow = [];
         }
         // Memory permissions — always included
-        const memoryPermissions = [
+        const basePermissions = [
             'Skill(codeyam-memory)',
             'Skill(codeyam-new-rule)',
             'Bash(codeyam)',
@@ -48,21 +48,71 @@ export function setupClaudeCodeSettings(projectRoot, options) {
             'Write(.codeyam/**)',
             'Glob(.codeyam/**)',
         ];
-        // Simulation permissions — only in full mode
-        const simulationPermissions = [
+        // Simulation permissions — project setup, analysis, and capture (full + editor modes)
+        const simAndEditorExtraPermissions = [
             'Skill(codeyam-setup)',
             'Skill(codeyam-sim)',
             'Skill(codeyam-debug)',
             'Skill(codeyam-test)',
             'Skill(codeyam-verify)',
-            'Read(/tmp/codeyam/**)',
-            'Edit(/tmp/codeyam/**)',
-            'Write(/tmp/codeyam/**)',
-            'Glob(/tmp/codeyam/**)',
+            'Skill(codeyam-dev-mode)',
+            'Read(/tmp/**)',
+            'Edit(/tmp/**)',
+            'Write(/tmp/**)',
+            'Glob(/tmp/**)',
+            'Bash(npm install:*)',
+            'Bash(npm run:*)',
+            'Bash(npx:*)',
+            'Bash(node:*)',
+            'Bash(cp:*)',
+            'Bash(mkdir:*)',
+            'Bash(chmod:*)',
+            'Bash(rm:*)',
+            'Bash(curl:*)',
+            'Bash(sleep:*)',
+            'Bash(echo:*)',
+            'Bash(grep:*)',
+            'Bash(python3:*)',
+            'Bash(cat:*)',
+            'Bash(printf:*)',
+            'Bash(ls:*)',
         ];
-        const codeyamPermissions = mode === 'full'
-            ? [...memoryPermissions, ...simulationPermissions]
-            : memoryPermissions;
+        // Editor permissions — git ops and skill for dev mode (editor mode only)
+        const editorExtraPermissions = [
+            'Skill(codeyam-editor)',
+            'Bash(git:*)',
+            'Edit(**)',
+            'Write(**)',
+        ];
+        const isEditorMode = mode === 'editor' || options?.editorMode === true;
+        let codeyamPermissions;
+        if (mode === 'full') {
+            codeyamPermissions = [
+                ...basePermissions,
+                ...simAndEditorExtraPermissions,
+            ];
+        }
+        else if (mode === 'editor') {
+            codeyamPermissions = [
+                ...basePermissions,
+                ...editorExtraPermissions,
+                ...simAndEditorExtraPermissions,
+            ];
+        }
+        else {
+            codeyamPermissions = basePermissions;
+        }
+        // When editorMode flag is set (e.g. full mode + editor), ensure editor permissions are included
+        if (isEditorMode && mode !== 'editor') {
+            for (const perm of [
+                ...editorExtraPermissions,
+                ...simAndEditorExtraPermissions,
+            ]) {
+                if (!codeyamPermissions.includes(perm)) {
+                    codeyamPermissions.push(perm);
+                }
+            }
+        }
         let updated = false;
         for (const permission of codeyamPermissions) {
             if (!settings.permissions.allow.includes(permission)) {
@@ -70,7 +120,29 @@ export function setupClaudeCodeSettings(projectRoot, options) {
                 updated = true;
             }
         }
-        // Write updated settings if any permissions were added
+        // Editor mode: register PostToolUse + Stop hooks for step tracking
+        if (isEditorMode) {
+            if (!settings.hooks) {
+                settings.hooks = {};
+            }
+            const hookCommand = 'test -f "$CLAUDE_PROJECT_DIR"/.codeyam/bin/editor-step-hook.py && python3 "$CLAUDE_PROJECT_DIR"/.codeyam/bin/editor-step-hook.py || true';
+            for (const event of [
+                'PostToolUse',
+                'Stop',
+                'UserPromptSubmit',
+            ]) {
+                const existing = settings.hooks[event] || [];
+                const alreadyRegistered = existing.some((entry) => entry.hooks?.some((h) => h.command?.includes('editor-step-hook')));
+                if (!alreadyRegistered) {
+                    existing.push({
+                        hooks: [{ type: 'command', command: hookCommand, timeout: 5 }],
+                    });
+                    settings.hooks[event] = existing;
+                    updated = true;
+                }
+            }
+        }
+        // Write updated settings if any permissions or hooks were added
         if (updated) {
             fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
             return true;

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

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

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

@@ -1,18 +1,22 @@
 import { findProjectRoot } from "./project.js";
 import { initializeEnvironment, requireBranchAndProject } from "./database.js";
-import { isAnalyzerFinalized } from "./analyzer.js";
+import { generateProjectSlug } from "./slugUtils.js";
+import Database from 'better-sqlite3';
 import * as fs from 'fs';
 import * as path from 'path';
-export const SIMULATION_COMMANDS = [
+/**
+ * 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: 'detect-universal-mocks',
-        describe: 'Detect universal mocks needed for startup',
-    },
     {
         name: 'test-startup',
         describe: 'Test project startup without external services',
@@ -21,14 +25,8 @@ export const SIMULATION_COMMANDS = [
         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: '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',
@@ -37,19 +35,9 @@ export const SIMULATION_COMMANDS = [
         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: 'list', describe: 'List entities or analyses' },
+    { 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',
@@ -59,16 +47,12 @@ export const SIMULATION_COMMANDS = [
         name: 'report',
         describe: 'Create a debug bundle for sharing with the CodeYam team',
     },
-    {
-        name: 'webapp-info',
-        describe: 'Show webapp info for a scenario, analysis, or file',
-    },
     {
         name: 'wipe',
         describe: 'Delete all analysis data (entities, analyses, scenarios)',
     },
 ];
-export const SIMULATION_COMMAND_NAMES = SIMULATION_COMMANDS.map((c) => c.name);
+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
@@ -85,9 +69,15 @@ export async function loadProjectForMiddleware(argv) {
     if (!fs.existsSync(configPath))
         return null;
     const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    const { projectSlug } = config;
+    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 };
@@ -100,7 +90,16 @@ export async function loadProjectForMiddleware(argv) {
  */
 export async function simulationGateMiddleware(argv) {
     const command = String(argv._[0] ?? '');
-    if (!SIMULATION_COMMAND_NAMES.includes(command)) {
+    // In editor mode, only `codeyam editor` subcommands are allowed
+    if (process.env.CODEYAM_EDITOR_ACTIVE === '1') {
+        if (command !== 'editor') {
+            console.error(`\nPlease only use \`codeyam editor\` subcommands when building in the editor.`);
+            console.error(`Also please make sure you are following the \`codeyam editor steps\` if you are changing code.\n`);
+            process.exit(1);
+        }
+        return; // Skip simulation gate check entirely in editor mode
+    }
+    if (!HIDDEN_COMMAND_NAMES.includes(command)) {
         return;
     }
     try {
@@ -111,7 +110,7 @@ export async function simulationGateMiddleware(argv) {
         }
         if (!context.project.metadata?.labs?.simulations) {
             console.error(`\n"codeyam ${command}" requires simulations to be enabled.`);
-            console.error('Run "codeyam setup-simulations" to get started.\n');
+            console.error('Enable simulations from the CodeYam dashboard.\n');
             process.exit(1);
         }
     }
@@ -121,18 +120,56 @@ export async function simulationGateMiddleware(argv) {
     }
 }
 /**
- * Build the epilogue string for --help that shows simulation commands
- * in a separate section from core commands.
+ * 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() {
-    const header = isAnalyzerFinalized()
-        ? 'Simulation Commands:'
-        : 'Simulation Commands (run "codeyam setup-simulations" to enable):';
-    const maxNameLen = Math.max(...SIMULATION_COMMANDS.map((c) => c.name.length));
-    const lines = SIMULATION_COMMANDS.map((c) => {
+    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 `${header}\n${lines.join('\n')}`;
+    return `All Commands:\n${lines.join('\n')}`;
 }
 //# sourceMappingURL=simulationGateMiddleware.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"simulationGateMiddleware.js","sourceRoot":"","sources":["../../../../src/utils/simulationGateMiddleware.ts"],"names":[],"mappings":"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"}
+{"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,7 +1,7 @@
 import { syncUniversalMocks } from "./syncUniversalMocks.js";
 import { loadProjectForMiddleware } from "./simulationGateMiddleware.js";
-// Commands that should NOT trigger sync
-const SKIP_SYNC_COMMANDS = ['init', 'help', 'version', '$0'];
+// 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/

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,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,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,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"}
+{"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/techStackConfig.js

@@ -0,0 +1,38 @@
+/**
+ * Ensure a tech stack item exists in the given category.
+ * Mutates config.techStack in place. No-ops if an item with the same name
+ * (case-insensitive) already exists in the category.
+ */
+export function ensureTechStackItem(config, category, item) {
+    if (!config.techStack || typeof config.techStack !== 'object') {
+        config.techStack = {};
+    }
+    if (!Array.isArray(config.techStack[category])) {
+        config.techStack[category] = [];
+    }
+    const exists = config.techStack[category].some((existing) => existing.name.toLowerCase() === item.name.toLowerCase());
+    if (!exists) {
+        config.techStack[category].push(item);
+    }
+}
+export const GITHUB_TECH_STACK_ITEM = {
+    name: 'GitHub',
+    url: 'https://github.com',
+    description: 'Source code hosting and version control',
+};
+export const VERCEL_TECH_STACK_ITEM = {
+    name: 'Vercel',
+    url: 'https://vercel.com',
+    description: 'Frontend deployment and hosting platform',
+};
+export const SUPABASE_TECH_STACK_ITEM = {
+    name: 'Supabase',
+    url: 'https://supabase.com',
+    description: 'Open-source Firebase alternative with PostgreSQL database',
+    envKeys: [
+        'NEXT_PUBLIC_SUPABASE_URL',
+        'NEXT_PUBLIC_SUPABASE_ANON_KEY',
+        'DATABASE_URL',
+    ],
+};
+//# sourceMappingURL=techStackConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"techStackConfig.js","sourceRoot":"","sources":["../../../../src/utils/techStackConfig.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA2B,EAC3B,QAA2B,EAC3B,IAAmB;IAEnB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC9D,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC5C,CAAC,QAAuB,EAAE,EAAE,CAC1B,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAC1D,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,oBAAoB;IACzB,WAAW,EAAE,yCAAyC;CACvD,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,oBAAoB;IACzB,WAAW,EAAE,0CAA0C;CACxD,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAkB;IACrD,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,sBAAsB;IAC3B,WAAW,EAAE,2DAA2D;IACxE,OAAO,EAAE;QACP,0BAA0B;QAC1B,+BAA+B;QAC/B,cAAc;KACf;CACF,CAAC"}

package/codeyam-cli/src/utils/techStackConfig.test.js

@@ -0,0 +1,85 @@
+import { ensureTechStackItem, GITHUB_TECH_STACK_ITEM, VERCEL_TECH_STACK_ITEM, } from "./techStackConfig.js";
+describe('ensureTechStackItem', () => {
+    it('adds item when config has no techStack key', () => {
+        const config = {};
+        ensureTechStackItem(config, 'infrastructure', GITHUB_TECH_STACK_ITEM);
+        expect(config.techStack.infrastructure).toEqual([GITHUB_TECH_STACK_ITEM]);
+    });
+    it('adds item when techStack exists but category is missing', () => {
+        const config = {
+            techStack: {
+                languages: [{ name: 'TypeScript', url: '', description: '' }],
+            },
+        };
+        ensureTechStackItem(config, 'infrastructure', VERCEL_TECH_STACK_ITEM);
+        expect(config.techStack.infrastructure).toEqual([VERCEL_TECH_STACK_ITEM]);
+        // Preserves other categories
+        expect(config.techStack.languages).toHaveLength(1);
+    });
+    it('adds item when category exists but is empty', () => {
+        const config = {
+            techStack: { infrastructure: [] },
+        };
+        ensureTechStackItem(config, 'infrastructure', GITHUB_TECH_STACK_ITEM);
+        expect(config.techStack.infrastructure).toEqual([GITHUB_TECH_STACK_ITEM]);
+    });
+    it('does not add duplicate when item with same name exists', () => {
+        const config = {
+            techStack: { infrastructure: [GITHUB_TECH_STACK_ITEM] },
+        };
+        ensureTechStackItem(config, 'infrastructure', GITHUB_TECH_STACK_ITEM);
+        expect(config.techStack.infrastructure).toHaveLength(1);
+    });
+    it('does not add duplicate with case-insensitive name match', () => {
+        const config = {
+            techStack: {
+                infrastructure: [{ name: 'github', url: '', description: 'existing' }],
+            },
+        };
+        ensureTechStackItem(config, 'infrastructure', GITHUB_TECH_STACK_ITEM);
+        expect(config.techStack.infrastructure).toHaveLength(1);
+        // Preserves the existing entry, doesn't overwrite
+        expect(config.techStack.infrastructure[0].description).toBe('existing');
+    });
+    it('preserves existing items when adding a new one', () => {
+        const existingItem = {
+            name: 'AWS',
+            url: 'https://aws.amazon.com',
+            description: 'Cloud',
+        };
+        const config = {
+            techStack: { infrastructure: [existingItem] },
+        };
+        ensureTechStackItem(config, 'infrastructure', VERCEL_TECH_STACK_ITEM);
+        expect(config.techStack.infrastructure).toHaveLength(2);
+        expect(config.techStack.infrastructure[0]).toEqual(existingItem);
+        expect(config.techStack.infrastructure[1]).toEqual(VERCEL_TECH_STACK_ITEM);
+    });
+    it('works with different categories', () => {
+        const config = { techStack: {} };
+        const dbItem = {
+            name: 'PostgreSQL',
+            url: 'https://postgresql.org',
+            description: 'Database',
+        };
+        ensureTechStackItem(config, 'databases', dbItem);
+        expect(config.techStack.databases).toEqual([dbItem]);
+    });
+});
+describe('predefined items', () => {
+    it('GITHUB_TECH_STACK_ITEM has expected shape', () => {
+        expect(GITHUB_TECH_STACK_ITEM).toEqual({
+            name: 'GitHub',
+            url: 'https://github.com',
+            description: 'Source code hosting and version control',
+        });
+    });
+    it('VERCEL_TECH_STACK_ITEM has expected shape', () => {
+        expect(VERCEL_TECH_STACK_ITEM).toEqual({
+            name: 'Vercel',
+            url: 'https://vercel.com',
+            description: 'Frontend deployment and hosting platform',
+        });
+    });
+});
+//# sourceMappingURL=techStackConfig.test.js.map

package/codeyam-cli/src/utils/techStackConfig.test.js.map

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

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

@@ -0,0 +1,106 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import crypto from 'crypto';
+import { PostHog } from 'posthog-node';
+// Public, write-only API key — safe to embed (same as dashboard client JS)
+const POSTHOG_API_KEY = 'phc_A31jab4KZfelVaNmdtni7kJ8996BgECSmDp2Qdk2FbK';
+const POSTHOG_HOST = 'https://us.i.posthog.com';
+let cachedConfig = null;
+let posthogClient = null;
+function getConfigPath() {
+    return path.join(os.homedir(), '.codeyam', 'telemetry.json');
+}
+function readConfig() {
+    if (cachedConfig)
+        return cachedConfig;
+    try {
+        const content = fs.readFileSync(getConfigPath(), 'utf-8');
+        const parsed = JSON.parse(content);
+        cachedConfig = {
+            enabled: parsed.enabled ?? true,
+            distinctId: parsed.distinctId ?? '',
+            noticeShown: parsed.noticeShown ?? false,
+        };
+        return cachedConfig;
+    }
+    catch {
+        cachedConfig = { enabled: true, distinctId: '', noticeShown: false };
+        return cachedConfig;
+    }
+}
+function writeConfig(config) {
+    const configPath = getConfigPath();
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    cachedConfig = config;
+}
+export function isTelemetryEnabled() {
+    if (process.env.DO_NOT_TRACK === '1')
+        return false;
+    if (process.env.CODEYAM_TELEMETRY === '0')
+        return false;
+    if (process.env.CI === 'true')
+        return false;
+    const config = readConfig();
+    return config.enabled !== false;
+}
+export function getDistinctId() {
+    const config = readConfig();
+    if (config.distinctId)
+        return config.distinctId;
+    const id = crypto.randomUUID();
+    writeConfig({ ...config, distinctId: id });
+    return id;
+}
+export function setTelemetryEnabled(enabled) {
+    const config = readConfig();
+    writeConfig({ ...config, enabled });
+}
+export function hasNoticeBeenShown() {
+    return readConfig().noticeShown;
+}
+export function markNoticeShown() {
+    const config = readConfig();
+    writeConfig({ ...config, noticeShown: true });
+}
+function getPostHogClient() {
+    if (posthogClient)
+        return posthogClient;
+    try {
+        posthogClient = new PostHog(POSTHOG_API_KEY, {
+            host: POSTHOG_HOST,
+            flushAt: 1,
+            flushInterval: 5000,
+        });
+        return posthogClient;
+    }
+    catch {
+        return null;
+    }
+}
+export function captureEvent(event, properties) {
+    if (!isTelemetryEnabled())
+        return;
+    try {
+        const client = getPostHogClient();
+        if (!client)
+            return;
+        client.capture({
+            distinctId: getDistinctId(),
+            event,
+            properties,
+        });
+        client.flush().catch(() => { });
+    }
+    catch {
+        // Fire-and-forget, never throw
+    }
+}
+/** Reset module state — for testing only */
+export function _resetForTesting() {
+    cachedConfig = null;
+    posthogClient = null;
+}
+//# sourceMappingURL=telemetry.js.map