@codeyam/codeyam-cli 0.1.0-staging.73a4bf4 → 0.1.0-staging.78c1cad

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

@@ -0,0 +1,74 @@
+/**
+ * Pure validation and merge logic for `codeyam editor glossary-add`.
+ *
+ * Safely adds/updates entries in .codeyam/glossary.json without
+ * hand-editing, avoiding unicode encoding issues with the Edit tool.
+ */
+/**
+ * Validate that an object has the required glossary entry fields:
+ * name, filePath, and description (all non-empty strings).
+ */
+export function validateGlossaryEntry(entry) {
+    if (!entry || typeof entry !== 'object') {
+        return { valid: false, error: 'Entry must be a non-null object' };
+    }
+    const obj = entry;
+    if (!obj.name || typeof obj.name !== 'string') {
+        return { valid: false, error: 'Missing required field: name' };
+    }
+    if (!obj.filePath || typeof obj.filePath !== 'string') {
+        return { valid: false, error: 'Missing required field: filePath' };
+    }
+    if (!obj.description || typeof obj.description !== 'string') {
+        return { valid: false, error: 'Missing required field: description' };
+    }
+    return { valid: true };
+}
+/**
+ * Merge incoming glossary entries into an existing array.
+ *
+ * - Validates each incoming entry
+ * - Deduplicates by name + filePath (updates in place, preserving position)
+ * - Appends truly new entries at the end
+ * - Preserves extra fields on existing entries that aren't in the incoming data
+ */
+export function mergeGlossaryEntries(existing, incoming) {
+    const errors = [];
+    const validIncoming = [];
+    // Validate each incoming entry
+    for (let i = 0; i < incoming.length; i++) {
+        const check = validateGlossaryEntry(incoming[i]);
+        if (!check.valid) {
+            errors.push({ index: i, message: check.error });
+            continue;
+        }
+        validIncoming.push(incoming[i]);
+    }
+    // Build a key for dedup: name + filePath
+    const key = (e) => `${e.name}::${e.filePath}`;
+    // Clone existing entries so we don't mutate the input
+    const result = existing.map((e) => ({ ...e }));
+    const existingKeys = new Map();
+    for (let i = 0; i < result.length; i++) {
+        existingKeys.set(key(result[i]), i);
+    }
+    let added = 0;
+    let updated = 0;
+    for (const entry of validIncoming) {
+        const k = key(entry);
+        const existingIdx = existingKeys.get(k);
+        if (existingIdx !== undefined) {
+            // Update in place — spread existing first to preserve extra fields,
+            // then overlay the incoming fields
+            result[existingIdx] = { ...result[existingIdx], ...entry };
+            updated++;
+        }
+        else {
+            result.push(entry);
+            existingKeys.set(k, result.length - 1);
+            added++;
+        }
+    }
+    return { entries: result, added, updated, errors };
+}
+//# sourceMappingURL=glossaryAdd.js.map

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

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

package/codeyam-cli/src/utils/install-skills.js

@@ -3,42 +3,98 @@ import * as path from 'path';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+async function copyDirRecursive(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+            if (entry.name.endsWith('.sh') || entry.name.endsWith('.mjs')) {
+                await fs.chmod(destPath, 0o755);
+            }
+        }
+    }
+}
 export async function installClaudeCodeSkills(projectRoot, options) {
     const mode = options?.mode ?? 'memory';
     try {
         const skillsDir = path.join(projectRoot, '.claude', 'skills');
         const templatesDir = path.join(__dirname, '../../templates');
-        // Memory + setup skills — always installed
+        const skillsTemplateDir = path.join(templatesDir, 'skills');
+        const commandsTemplateDir = path.join(templatesDir, 'commands');
+        // Memory skills — always installed
         const memorySkillDir = path.join(skillsDir, 'codeyam-memory');
         const newRuleSkillDir = path.join(skillsDir, 'codeyam-new-rule');
-        const setupSkillDir = path.join(skillsDir, 'codeyam-setup');
-        await fs.mkdir(memorySkillDir, { recursive: true });
-        await fs.mkdir(newRuleSkillDir, { recursive: true });
-        await fs.mkdir(setupSkillDir, { recursive: true });
-        await fs.copyFile(path.join(templatesDir, 'codeyam-memory.md'), path.join(memorySkillDir, 'SKILL.md'));
-        await fs.copyFile(path.join(templatesDir, 'codeyam-new-rule.md'), path.join(newRuleSkillDir, 'SKILL.md'));
-        await fs.copyFile(path.join(templatesDir, 'codeyam-setup.md'), path.join(setupSkillDir, 'SKILL.md'));
+        await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-memory'), memorySkillDir);
+        await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-new-rule'), newRuleSkillDir);
+        // Editor skill — in editor mode (either explicit mode or editorMode flag)
+        const isEditorMode = mode === 'editor' || options?.editorMode === true;
+        if (isEditorMode) {
+            const editorSkillDir = path.join(skillsDir, 'codeyam-editor');
+            await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-editor'), editorSkillDir);
+            // CLAUDE.md for editor projects — guides Claude to build with scenarios
+            const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
+            try {
+                await fs.access(claudeMdPath);
+                // CLAUDE.md already exists — don't overwrite
+            }
+            catch {
+                // Doesn't exist — create it
+                await fs.copyFile(path.join(templatesDir, 'codeyam-editor-claude.md'), claudeMdPath);
+            }
+            // .codeyam/docs/editor-reference.md — CLI and directory reference for Claude Code
+            // Always overwrite so clients get the latest docs when the CLI updates
+            const docsDir = path.join(projectRoot, '.codeyam', 'docs');
+            await fs.mkdir(docsDir, { recursive: true });
+            await fs.copyFile(path.join(templatesDir, 'codeyam-editor-reference.md'), path.join(docsDir, 'editor-reference.md'));
+        }
         // Simulation skills — only in full mode
         if (mode === 'full') {
+            const setupSkillDir = path.join(skillsDir, 'codeyam-setup');
             const simSkillDir = path.join(skillsDir, 'codeyam-sim');
             const testSkillDir = path.join(skillsDir, 'codeyam-test');
             const verifySkillDir = path.join(skillsDir, 'codeyam-verify');
-            await fs.mkdir(simSkillDir, { recursive: true });
-            await fs.mkdir(testSkillDir, { recursive: true });
-            await fs.mkdir(verifySkillDir, { recursive: true });
-            await fs.copyFile(path.join(templatesDir, 'codeyam-sim.md'), path.join(simSkillDir, 'SKILL.md'));
-            await fs.copyFile(path.join(templatesDir, 'codeyam-test.md'), path.join(testSkillDir, 'SKILL.md'));
-            await fs.copyFile(path.join(templatesDir, 'codeyam-verify.md'), path.join(verifySkillDir, 'SKILL.md'));
+            const devModeSkillDir = path.join(skillsDir, 'codeyam-dev-mode');
+            await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-setup'), setupSkillDir);
+            await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-sim'), simSkillDir);
+            await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-test'), testSkillDir);
+            await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-verify'), verifySkillDir);
+            await copyDirRecursive(path.join(skillsTemplateDir, 'codeyam-dev-mode'), devModeSkillDir);
             // Diagnose command — only in full mode
             const commandsDir = path.join(projectRoot, '.claude', 'commands');
             await fs.mkdir(commandsDir, { recursive: true });
-            await fs.copyFile(path.join(templatesDir, 'codeyam-diagnose.md'), path.join(commandsDir, 'codeyam-diagnose.md'));
+            await fs.copyFile(path.join(commandsTemplateDir, 'codeyam-diagnose.md'), path.join(commandsDir, 'codeyam-diagnose.md'));
         }
         // Helper scripts and hooks — always installed
         const binDir = path.join(projectRoot, '.codeyam', 'bin');
         await fs.mkdir(binDir, { recursive: true });
         const rulesDir = path.join(projectRoot, '.codeyam', 'rules');
         await fs.mkdir(rulesDir, { recursive: true });
+        // Editor step tracking hook — only in editor mode
+        if (isEditorMode) {
+            try {
+                const editorStepHookDest = path.join(binDir, 'editor-step-hook.py');
+                await fs.copyFile(path.join(templatesDir, 'editor-step-hook.py'), editorStepHookDest);
+                await fs.chmod(editorStepHookDest, 0o755);
+            }
+            catch {
+                // Hook script is optional
+            }
+            // Seed adapter templates — copied so migration step 2 can reference them
+            try {
+                const seedAdaptersSrc = path.join(templatesDir, 'seed-adapters');
+                const seedAdaptersDest = path.join(projectRoot, '.codeyam', 'seed-adapters');
+                await copyDirRecursive(seedAdaptersSrc, seedAdaptersDest);
+            }
+            catch {
+                // Seed adapter templates are optional
+            }
+        }
         // Memory pre-commit hook
         try {
             const memoryHookDest = path.join(binDir, 'memory-hook.sh');

package/codeyam-cli/src/utils/install-skills.js.map

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

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

@@ -0,0 +1,126 @@
+import fs from 'fs';
+import path from 'path';
+import { EventEmitter } from 'events';
+/**
+ * Watches the original project directory for file changes and syncs them
+ * to the tmp dev server directory. This enables live code editing in
+ * a separate terminal while dev mode shows the preview.
+ *
+ * Modeled after FileWatcher but simplified - only copies files, no entity tracking.
+ */
+export class InteractiveSyncWatcher extends EventEmitter {
+    constructor(options) {
+        super();
+        this.watcher = null;
+        this.debounceTimers = new Map();
+        this.DEBOUNCE_MS = 300;
+        this.options = options;
+    }
+    /**
+     * Start watching the project directory for changes
+     */
+    start() {
+        try {
+            this.watcher = fs.watch(this.options.projectRootPath, { recursive: true }, (eventType, filename) => {
+                if (!filename)
+                    return;
+                // Only watch source files
+                if (!/\.(ts|tsx|js|jsx|css|scss|json|svg|html)$/.test(filename)) {
+                    return;
+                }
+                // Ignore files in excluded directories
+                if (InteractiveSyncWatcher.IGNORED_DIRS.some((dir) => filename.includes(dir + '/') || filename.includes(dir + '\\'))) {
+                    return;
+                }
+                // Debounce rapid saves
+                const existing = this.debounceTimers.get(filename);
+                if (existing) {
+                    clearTimeout(existing);
+                }
+                this.debounceTimers.set(filename, setTimeout(() => {
+                    this.debounceTimers.delete(filename);
+                    this.syncFile(filename);
+                }, this.DEBOUNCE_MS));
+            });
+            console.log(`[InteractiveSyncWatcher] Watching ${this.options.projectRootPath} for changes`);
+        }
+        catch (error) {
+            console.error('[InteractiveSyncWatcher] Failed to start:', error);
+        }
+    }
+    /**
+     * Copy a changed file from the original project to the tmp project
+     */
+    syncFile(relativePath) {
+        const sourcePath = path.join(this.options.projectRootPath, relativePath);
+        const destPath = path.join(this.options.tmpProjectPath, relativePath);
+        try {
+            // Check if source file exists (might have been deleted)
+            if (!fs.existsSync(sourcePath)) {
+                // File was deleted - remove from tmp project too
+                if (fs.existsSync(destPath)) {
+                    fs.unlinkSync(destPath);
+                    console.log(`[InteractiveSyncWatcher] Removed: ${relativePath}`);
+                }
+                return;
+            }
+            // Ensure destination directory exists
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            // Copy the file
+            fs.copyFileSync(sourcePath, destPath);
+            const fileName = path.basename(relativePath);
+            console.log(`[InteractiveSyncWatcher] Synced: ${relativePath}`);
+            // Emit sync event
+            const event = {
+                type: 'file-synced',
+                fileName,
+                filePath: relativePath,
+                timestamp: Date.now(),
+            };
+            this.emit('sync', event);
+        }
+        catch (error) {
+            console.error(`[InteractiveSyncWatcher] Error syncing ${relativePath}:`, error);
+            const event = {
+                type: 'error',
+                fileName: path.basename(relativePath),
+                filePath: relativePath,
+                timestamp: Date.now(),
+            };
+            this.emit('sync', event);
+        }
+    }
+    /**
+     * Stop watching and clean up
+     */
+    stop() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        // Clear all pending debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        console.log('[InteractiveSyncWatcher] Stopped');
+    }
+}
+/** Directories to ignore when watching for changes */
+InteractiveSyncWatcher.IGNORED_DIRS = [
+    'node_modules',
+    '.git',
+    '.codeyam',
+    '__codeyamMocks__',
+    '.next',
+    'dist',
+    'build',
+    '.turbo',
+    '.vercel',
+    'coverage',
+    '.cache',
+];
+//# sourceMappingURL=interactiveSyncWatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveSyncWatcher.js","sourceRoot":"","sources":["../../../../src/utils/interactiveSyncWatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAgBtC;;;;;;GAMG;AACH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IAqBtD,YAAY,OAAsC;QAChD,KAAK,EAAE,CAAC;QArBF,YAAO,GAAwB,IAAI,CAAC;QAEpC,mBAAc,GAAgC,IAAI,GAAG,EAAE,CAAC;QAC/C,gBAAW,GAAG,GAAG,CAAC;QAmBjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,KAAK,CACrB,IAAI,CAAC,OAAO,CAAC,eAAe,EAC5B,EAAE,SAAS,EAAE,IAAI,EAAE,EACnB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;gBACtB,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBAEtB,0BAA0B;gBAC1B,IAAI,CAAC,2CAA2C,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChE,OAAO;gBACT,CAAC;gBAED,uCAAuC;gBACvC,IACE,sBAAsB,CAAC,YAAY,CAAC,IAAI,CACtC,CAAC,GAAG,EAAE,EAAE,CACN,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,CAChE,EACD,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,uBAAuB;gBACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnD,IAAI,QAAQ,EAAE,CAAC;oBACb,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;gBAED,IAAI,CAAC,cAAc,CAAC,GAAG,CACrB,QAAQ,EACR,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBACrC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CACrB,CAAC;YACJ,CAAC,CACF,CAAC;YAEF,OAAO,CAAC,GAAG,CACT,qCAAqC,IAAI,CAAC,OAAO,CAAC,eAAe,cAAc,CAChF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,YAAoB;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAEtE,IAAI,CAAC;YACH,wDAAwD;YACxD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,iDAAiD;gBACjD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAC;gBACnE,CAAC;gBACD,OAAO;YACT,CAAC;YAED,sCAAsC;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAED,gBAAgB;YAChB,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAC;YAEhE,kBAAkB;YAClB,MAAM,KAAK,GAAc;gBACvB,IAAI,EAAE,aAAa;gBACnB,QAAQ;gBACR,QAAQ,EAAE,YAAY;gBACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,0CAA0C,YAAY,GAAG,EACzD,KAAK,CACN,CAAC;YAEF,MAAM,KAAK,GAAc;gBACvB,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACrC,QAAQ,EAAE,YAAY;gBACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,oCAAoC;QACpC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAE5B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC;;AA5ID,sDAAsD;AAC9B,mCAAY,GAAG;IACrC,cAAc;IACd,MAAM;IACN,UAAU;IACV,kBAAkB;IAClB,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,QAAQ;CACT,AAZmC,CAYlC"}

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

@@ -0,0 +1,196 @@
+/**
+ * Pure logic for manual entity analysis — used when automated
+ * analyze-imports fails and Claude needs to provide entity metadata
+ * directly. Zero side effects in the pure functions.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// ─── Type conversion ─────────────────────────────────────────────────
+/**
+ * Convert nested TypeInfo JSON into flat dot-notation dataForMocks format.
+ *
+ * Input (what Claude provides naturally from reading code):
+ *   { props: { user: { name: "string" } }, hooks: { useAuth: { isLoggedIn: "boolean" } } }
+ *
+ * Output (what downstream consumers expect):
+ *   { "props.user": "object", "props.user.name": "string", "useAuth()": "object", "useAuth().isLoggedIn": "boolean" }
+ */
+export function convertTypeInfoToDataForMocks(typeInfo) {
+    if (!typeInfo)
+        return {};
+    const result = {};
+    // Props: flatten under "props." prefix
+    if (typeInfo.props) {
+        flattenObject(typeInfo.props, 'props', result);
+    }
+    // Hooks: flatten with "()" call syntax — e.g., "useAuth().user.id"
+    if (typeInfo.hooks) {
+        for (const [hookName, hookValue] of Object.entries(typeInfo.hooks)) {
+            const prefix = `${hookName}()`;
+            if (typeof hookValue === 'string') {
+                result[prefix] = hookValue;
+            }
+            else {
+                result[prefix] = 'object';
+                flattenObject(hookValue, prefix, result);
+            }
+        }
+    }
+    // Params: flatten under "params." prefix
+    if (typeInfo.params) {
+        flattenObject(typeInfo.params, 'params', result);
+    }
+    // Returns: flatten under "returns" prefix
+    if (typeInfo.returns) {
+        const isArray = typeInfo.returns._type === 'array';
+        const prefix = isArray ? 'returns[]' : 'returns';
+        const rootType = isArray ? 'array' : 'object';
+        result[prefix] = rootType;
+        const entries = Object.entries(typeInfo.returns).filter(([k]) => k !== '_type');
+        for (const [key, value] of entries) {
+            flattenEntry(key, value, prefix, result);
+        }
+    }
+    return result;
+}
+function flattenObject(obj, prefix, result) {
+    const isArray = obj._type === 'array';
+    const actualPrefix = isArray ? `${prefix}[]` : prefix;
+    if (isArray) {
+        result[actualPrefix] = 'array';
+    }
+    const entries = Object.entries(obj).filter(([k]) => k !== '_type');
+    for (const [key, value] of entries) {
+        flattenEntry(key, value, actualPrefix, result);
+    }
+}
+function flattenEntry(key, value, prefix, result) {
+    const fullKey = `${prefix}.${key}`;
+    if (typeof value === 'string') {
+        result[fullKey] = value;
+    }
+    else {
+        // Nested object — add "object" type marker and recurse
+        const isArray = value._type === 'array';
+        if (isArray) {
+            result[`${fullKey}[]`] = 'array';
+            const entries = Object.entries(value).filter(([k]) => k !== '_type');
+            for (const [k, v] of entries) {
+                flattenEntry(k, v, `${fullKey}[]`, result);
+            }
+        }
+        else {
+            result[fullKey] = 'object';
+            for (const [k, v] of Object.entries(value)) {
+                flattenEntry(k, v, fullKey, result);
+            }
+        }
+    }
+}
+// ─── Validation ──────────────────────────────────────────────────────
+/**
+ * Validate manual entity input before creating records.
+ * Returns an array of error messages (empty = valid).
+ */
+export function validateManualEntityInput(input, glossaryEntries, io) {
+    const errors = [];
+    if (!input.name) {
+        errors.push('name is required');
+    }
+    if (!input.filePath) {
+        errors.push('filePath is required');
+    }
+    if (input.filePath && !io.fileExists(input.filePath)) {
+        errors.push(`File does not exist: ${input.filePath}`);
+    }
+    if (input.entityType &&
+        input.entityType !== 'visual' &&
+        input.entityType !== 'library') {
+        errors.push(`entityType must be "visual" or "library", got "${input.entityType}"`);
+    }
+    if (!input.entityType) {
+        errors.push('entityType is required (must be "visual" or "library")');
+    }
+    // Validate importedExports reference known glossary entries
+    if (input.importedExports && input.importedExports.length > 0) {
+        const glossaryNames = new Set(glossaryEntries.map((e) => e.name));
+        for (const imp of input.importedExports) {
+            if (!glossaryNames.has(imp.name)) {
+                errors.push(`importedExports references unknown glossary entity: "${imp.name}" — check .codeyam/glossary.json`);
+            }
+        }
+    }
+    return errors;
+}
+// ─── Failure tracker ─────────────────────────────────────────────────
+const FAILURES_FILENAME = 'analysis-failures.json';
+/**
+ * Read the structured analysis failures file.
+ * Returns empty object if file doesn't exist or can't be parsed.
+ */
+export function readAnalysisFailures(projectRoot, io) {
+    const filePath = path.join(projectRoot, '.codeyam', FAILURES_FILENAME);
+    try {
+        if (io) {
+            if (!io.existsSync(filePath))
+                return {};
+            const content = io.readFileSync(filePath);
+            return JSON.parse(content);
+        }
+        if (!fs.existsSync(filePath))
+            return {};
+        const content = fs.readFileSync(filePath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write the structured analysis failures file.
+ * Removes the file when failures is empty.
+ */
+export function writeAnalysisFailures(projectRoot, failures, io) {
+    const filePath = path.join(projectRoot, '.codeyam', FAILURES_FILENAME);
+    if (Object.keys(failures).length === 0) {
+        // Remove the file when no failures remain
+        try {
+            if (io) {
+                if (io.existsSync?.(filePath))
+                    io.unlinkSync?.(filePath);
+            }
+            else {
+                if (fs.existsSync(filePath))
+                    fs.unlinkSync(filePath);
+            }
+        }
+        catch {
+            // Non-fatal
+        }
+        return;
+    }
+    try {
+        const dir = path.dirname(filePath);
+        if (io) {
+            io.mkdirSync?.(dir, { recursive: true });
+            io.writeFileSync?.(filePath, JSON.stringify(failures, null, 2));
+        }
+        else {
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(filePath, JSON.stringify(failures, null, 2));
+        }
+    }
+    catch {
+        // Non-fatal — failure tracking is best-effort
+    }
+}
+/**
+ * Remove a specific file path from the failures map.
+ * Returns a new object (does not mutate the original).
+ */
+export function clearFailureForPath(failures, filePath) {
+    const result = { ...failures };
+    delete result[filePath];
+    return result;
+}
+//# sourceMappingURL=manualEntityAnalysis.js.map

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

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

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

@@ -0,0 +1,76 @@
+import { getDisplayVersion } from "./versionInfo.js";
+// In-memory cache with 1-hour TTL
+let cachedResult = null;
+let cacheTimestamp = 0;
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Compares two semver-style version strings.
+ * Returns true if `latest` is strictly newer than `current`.
+ */
+export function isNewerVersion(latest, current) {
+    const latestParts = latest.split('.').map(Number);
+    const currentParts = current.split('.').map(Number);
+    for (let i = 0; i < Math.max(latestParts.length, currentParts.length); i++) {
+        const l = latestParts[i] ?? 0;
+        const c = currentParts[i] ?? 0;
+        if (isNaN(l) || isNaN(c))
+            return false;
+        if (l > c)
+            return true;
+        if (l < c)
+            return false;
+    }
+    return false;
+}
+/**
+ * Checks the npm registry for a newer version of the CLI.
+ * Results are cached in memory for 1 hour.
+ * Any failure (network, timeout, parse) returns { updateAvailable: false }.
+ */
+export async function checkForNpmUpdate() {
+    const currentVersion = getDisplayVersion();
+    // Return cached result if still fresh
+    if (cachedResult && Date.now() - cacheTimestamp < CACHE_TTL_MS) {
+        return cachedResult;
+    }
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch('https://registry.npmjs.org/@codeyam/codeyam-cli/latest', { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!response.ok) {
+            const result = {
+                updateAvailable: false,
+                latestVersion: null,
+                currentVersion,
+            };
+            cachedResult = result;
+            cacheTimestamp = Date.now();
+            return result;
+        }
+        const data = (await response.json());
+        const latestVersion = data.version;
+        if (!latestVersion) {
+            const result = {
+                updateAvailable: false,
+                latestVersion: null,
+                currentVersion,
+            };
+            cachedResult = result;
+            cacheTimestamp = Date.now();
+            return result;
+        }
+        const result = {
+            updateAvailable: isNewerVersion(latestVersion, currentVersion),
+            latestVersion,
+            currentVersion,
+        };
+        cachedResult = result;
+        cacheTimestamp = Date.now();
+        return result;
+    }
+    catch {
+        return { updateAvailable: false, latestVersion: null, currentVersion };
+    }
+}
+//# sourceMappingURL=npmVersionCheck.js.map