@codeyam/codeyam-cli 0.1.0-staging.76566f9 → 0.1.0-staging.78c1cad

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

@@ -0,0 +1,182 @@
+import { execSync } from 'child_process';
+/**
+ * Check if the git working directory is clean (no uncommitted changes to tracked files).
+ * Used by baseline command to ensure we're analyzing a known git state.
+ *
+ * Note: Untracked files are ignored - they're not part of the commit SHA
+ * and typically include things like .idea/, .codeyam/, editor configs, etc.
+ */
+export function checkGitClean(rootPath) {
+    const workingDir = rootPath || process.cwd();
+    try {
+        const output = execSync('git status --porcelain', {
+            cwd: workingDir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+        const lines = output
+            .trim()
+            .split('\n')
+            .filter((line) => line.length > 0);
+        // Filter out untracked files (lines starting with ??)
+        // We only care about changes to tracked files
+        const trackedChanges = lines.filter((line) => !line.startsWith('??'));
+        if (trackedChanges.length === 0) {
+            return { clean: true, files: [] };
+        }
+        // Parse file paths from git status output
+        const files = trackedChanges.map((line) => {
+            // Git status format: XY filename
+            // Skip the two status characters and any following whitespace
+            return line
+                .slice(2)
+                .replace(/^[ \t]+/, '')
+                .trim();
+        });
+        return { clean: false, files };
+    }
+    catch (error) {
+        // If git status fails, assume not clean (safer)
+        console.error('Failed to check git status:', error);
+        return { clean: false, files: ['(unable to determine)'] };
+    }
+}
+/**
+ * Get the current HEAD commit SHA.
+ * Used by baseline command to create a commit record with the real git SHA.
+ */
+export function getHeadSha(rootPath) {
+    const workingDir = rootPath || process.cwd();
+    try {
+        const output = execSync('git rev-parse HEAD', {
+            cwd: workingDir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+        return output.trim();
+    }
+    catch (error) {
+        throw new Error(`Failed to get HEAD SHA: ${error}`);
+    }
+}
+/**
+ * Check if we're in a git repository.
+ */
+export function isGitRepo(rootPath) {
+    const workingDir = rootPath || process.cwd();
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd: workingDir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize a git repo if one doesn't exist.
+ * Returns true if a new repo was initialized, false if one already existed.
+ */
+export function initGitIfNeeded(rootPath) {
+    if (isGitRepo(rootPath)) {
+        return false;
+    }
+    execSync('git init', {
+        cwd: rootPath,
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'ignore'],
+    });
+    // Set initial config so commits work in fresh repos
+    try {
+        execSync('git config user.email "codeyam@local"', {
+            cwd: rootPath,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+        execSync('git config user.name "CodeYam"', {
+            cwd: rootPath,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'ignore'],
+        });
+    }
+    catch {
+        // Config may already be set globally — that's fine
+    }
+    return true;
+}
+/**
+ * Stage all changes (git add -A).
+ */
+export function gitAddAll(rootPath) {
+    execSync('git add -A', {
+        cwd: rootPath,
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'ignore'],
+    });
+}
+/**
+ * Create a commit with the given message. Returns the new commit SHA.
+ */
+export function gitCommit(rootPath, message) {
+    execSync(`git commit -m ${JSON.stringify(message)}`, {
+        cwd: rootPath,
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'ignore'],
+    });
+    return getHeadSha(rootPath);
+}
+/**
+ * Validate that a string looks like a valid git commit SHA (7-40 hex chars).
+ * Used to prevent command injection before passing to git commands.
+ */
+export function validateCommitSha(sha) {
+    return /^[0-9a-f]{7,40}$/i.test(sha);
+}
+/**
+ * Verify that a commit exists in the repository using `git cat-file -t`.
+ */
+export function verifyCommitExists(rootPath, sha) {
+    try {
+        execSync(`git cat-file -t ${sha}`, {
+            cwd: rootPath,
+            encoding: 'utf8',
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stash uncommitted changes with a message.
+ * Returns `{ stashed: true }` if changes were stashed, `{ stashed: false }` if clean.
+ */
+export function gitStash(rootPath, message) {
+    try {
+        const output = execSync(`git stash push -m ${JSON.stringify(message)}`, {
+            cwd: rootPath,
+            encoding: 'utf8',
+            stdio: 'pipe',
+        });
+        return { stashed: !output.includes('No local changes') };
+    }
+    catch {
+        return { stashed: false };
+    }
+}
+/**
+ * Checkout a specific git ref (commit SHA, branch name, etc.).
+ * Throws on failure.
+ */
+export function gitCheckout(rootPath, ref) {
+    execSync(`git checkout ${ref}`, {
+        cwd: rootPath,
+        encoding: 'utf8',
+        stdio: 'pipe',
+    });
+}
+//# sourceMappingURL=git.js.map

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

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

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,49 +3,144 @@ import * as path from 'path';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-export async function installClaudeCodeSkills(projectRoot) {
+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 {
-        // Create .claude/skills directories in project root
         const skillsDir = path.join(projectRoot, '.claude', 'skills');
-        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(setupSkillDir, { recursive: true });
-        await fs.mkdir(simSkillDir, { recursive: true });
-        await fs.mkdir(testSkillDir, { recursive: true });
-        await fs.mkdir(verifySkillDir, { recursive: true });
-        // Create .claude/commands directory for slash commands
-        const commandsDir = path.join(projectRoot, '.claude', 'commands');
-        await fs.mkdir(commandsDir, { recursive: true });
-        // Create .codeyam/bin directory for helper scripts
+        const templatesDir = path.join(__dirname, '../../templates');
+        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');
+        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');
+            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(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 });
-        // Find templates directory (go up from dist if built)
-        const templatesDir = path.join(__dirname, '../../templates');
-        // Copy skill files to proper SKILL.md locations
-        const setupSkillSrc = path.join(templatesDir, 'codeyam-setup-skill.md');
-        const simSkillSrc = path.join(templatesDir, 'codeyam-sim-skill.md');
-        const testSkillSrc = path.join(templatesDir, 'codeyam-test-skill.md');
-        const verifySkillSrc = path.join(templatesDir, 'codeyam-verify-skill.md');
-        const setupSkillDest = path.join(setupSkillDir, 'SKILL.md');
-        const simSkillDest = path.join(simSkillDir, 'SKILL.md');
-        const testSkillDest = path.join(testSkillDir, 'SKILL.md');
-        const verifySkillDest = path.join(verifySkillDir, 'SKILL.md');
-        await fs.copyFile(setupSkillSrc, setupSkillDest);
-        await fs.copyFile(simSkillSrc, simSkillDest);
-        await fs.copyFile(testSkillSrc, testSkillDest);
-        await fs.copyFile(verifySkillSrc, verifySkillDest);
-        // Copy command files to .claude/commands/
-        const debugCommandSrc = path.join(templatesDir, 'debug-codeyam.md');
-        const debugCommandDest = path.join(commandsDir, 'debug-codeyam.md');
-        await fs.copyFile(debugCommandSrc, debugCommandDest);
-        // Copy main stop hook (correct JSON format)
-        // const stopHookSrc = path.join(templatesDir, 'codeyam-stop-hook.sh');
-        // const stopHookDest = path.join(binDir, 'codeyam-stop-hook.sh');
-        // await fs.copyFile(stopHookSrc, stopHookDest);
-        // Make scripts executable
-        // await fs.chmod(stopHookDest, 0o755);
+        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');
+            await fs.copyFile(path.join(templatesDir, 'codeyam-memory-hook.sh'), memoryHookDest);
+            await fs.chmod(memoryHookDest, 0o755);
+        }
+        catch {
+            // Hook script is optional - skill will create it if missing
+        }
+        // Rule reflection hook
+        try {
+            const ruleReflectionHookDest = path.join(binDir, 'rule-reflection-hook.py');
+            await fs.copyFile(path.join(templatesDir, 'rule-reflection-hook.py'), ruleReflectionHookDest);
+            await fs.chmod(ruleReflectionHookDest, 0o755);
+        }
+        catch {
+            // Hook script is optional
+        }
+        // Rule notification hook
+        try {
+            const ruleNotificationHookDest = path.join(binDir, 'rule-notification-hook.py');
+            await fs.copyFile(path.join(templatesDir, 'rule-notification-hook.py'), ruleNotificationHookDest);
+            await fs.chmod(ruleNotificationHookDest, 0o755);
+        }
+        catch {
+            // Hook script is optional
+        }
+        // Prompt templates
+        try {
+            const promptsDestDir = path.join(binDir, 'prompts');
+            await fs.mkdir(promptsDestDir, { recursive: true });
+            const promptFiles = await fs.readdir(path.join(templatesDir, 'prompts'));
+            for (const file of promptFiles) {
+                await fs.copyFile(path.join(templatesDir, 'prompts', file), path.join(promptsDestDir, file));
+            }
+        }
+        catch {
+            // Prompt templates are optional
+        }
+        // Rules instructions
+        try {
+            await fs.copyFile(path.join(templatesDir, 'rules-instructions.md'), path.join(rulesDir, 'instructions.md'));
+        }
+        catch {
+            // Instructions file is optional - skill will guide if missing
+        }
         return {
             success: true,
             skillsPath: path.relative(projectRoot, skillsDir),

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":"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"}

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

@@ -0,0 +1,19 @@
+import { createHmac } from 'crypto';
+const LABS_UNLOCK_SALT = process.env.LABS_UNLOCK_SALT || 'codeyam-labs-default-salt';
+/**
+ * Generate the unlock code for a project slug.
+ * Deterministic: same slug + salt always produces the same code.
+ */
+export function generateUnlockCode(projectSlug) {
+    const hmac = createHmac('sha256', LABS_UNLOCK_SALT);
+    hmac.update(projectSlug);
+    return `CY-${hmac.digest('hex').slice(0, 16)}`;
+}
+/**
+ * Validate an unlock code locally using the same HMAC-SHA256 logic as the server.
+ * No network call required — the code is deterministic per project slug + salt.
+ */
+export function validateUnlockCode(projectSlug, unlockCode) {
+    return unlockCode === generateUnlockCode(projectSlug);
+}
+//# sourceMappingURL=labsAutoCheck.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labsAutoCheck.js","sourceRoot":"","sources":["../../../../src/utils/labsAutoCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,gBAAgB,GACpB,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,2BAA2B,CAAC;AAE9D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,UAAkB;IAElB,OAAO,UAAU,KAAK,kBAAkB,CAAC,WAAW,CAAC,CAAC;AACxD,CAAC"}