@codeyam/codeyam-cli 0.0.0 → 0.1.0-staging.032c089

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

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

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

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

@@ -0,0 +1,31 @@
+import * as fs from 'fs';
+/**
+ * Parse a register command argument — either inline JSON or @file reference.
+ *
+ * The @file convention reads JSON from a file path (like curl's -d @file),
+ * avoiding long CLI arguments and subshell ($()) approval prompts.
+ *
+ * @returns Parsed object, or null with error message on failure.
+ */
+export function parseRegisterArg(jsonArg) {
+    if (!jsonArg) {
+        return { error: 'JSON argument required' };
+    }
+    try {
+        if (jsonArg.startsWith('@')) {
+            const filePath = jsonArg.slice(1);
+            if (!fs.existsSync(filePath)) {
+                return { error: `File not found: ${filePath}` };
+            }
+            const fileContent = fs.readFileSync(filePath, 'utf8');
+            return { body: JSON.parse(fileContent) };
+        }
+        else {
+            return { body: JSON.parse(jsonArg) };
+        }
+    }
+    catch {
+        return { error: 'Invalid JSON' };
+    }
+}
+//# sourceMappingURL=parseRegisterArg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseRegisterArg.js","sourceRoot":"","sources":["../../../../src/utils/parseRegisterArg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe;IAIf,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,KAAK,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC;YAClD,CAAC;YACD,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACnC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,139 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Parse .gitignore file and return patterns
+ */
+export function parseGitignore(gitignorePath) {
+    if (!fs.existsSync(gitignorePath)) {
+        return [];
+    }
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'))
+        .map((line) => {
+        // Remove leading slash for consistency
+        if (line.startsWith('/')) {
+            return line.slice(1);
+        }
+        return line;
+    });
+}
+/**
+ * Load all .gitignore files recursively from a directory
+ */
+export function loadGitignorePatterns(rootPath) {
+    const patterns = [];
+    function traverse(dir) {
+        const gitignorePath = path.join(dir, '.gitignore');
+        if (fs.existsSync(gitignorePath)) {
+            const localPatterns = parseGitignore(gitignorePath);
+            // Make patterns relative to root
+            const relativeDir = path.relative(rootPath, dir);
+            const prefixedPatterns = localPatterns.map((pattern) => relativeDir ? path.join(relativeDir, pattern) : pattern);
+            patterns.push(...prefixedPatterns);
+        }
+        // Traverse subdirectories (excluding node_modules, .git, etc.)
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() &&
+                    entry.name !== 'node_modules' &&
+                    entry.name !== '.git' &&
+                    entry.name !== 'dist' &&
+                    entry.name !== 'build') {
+                    traverse(path.join(dir, entry.name));
+                }
+            }
+        }
+        catch (error) {
+            // Ignore permission errors
+        }
+    }
+    traverse(rootPath);
+    return patterns;
+}
+/**
+ * Check if a file path matches a gitignore pattern
+ */
+export function matchesGitignorePattern(filePath, pattern) {
+    // Normalize paths
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    const normalizedPattern = pattern.replace(/\\/g, '/');
+    // Exact match
+    if (normalizedPath === normalizedPattern) {
+        return true;
+    }
+    // Directory match - if pattern ends with /, match directory and everything inside
+    if (normalizedPattern.endsWith('/')) {
+        // Handle **/ prefix: match directory name anywhere in the path
+        if (normalizedPattern.startsWith('**/')) {
+            const dirName = normalizedPattern.slice(3, -1); // e.g. "**/.react-router/" → ".react-router"
+            // Match: starts with "dirName/", contains "/dirName/", or equals "dirName"
+            if (normalizedPath === dirName ||
+                normalizedPath.startsWith(dirName + '/') ||
+                normalizedPath.includes('/' + dirName + '/')) {
+                return true;
+            }
+        }
+        else {
+            const dir = normalizedPattern.slice(0, -1);
+            // Only match at root level (start of path)
+            if (normalizedPath === dir || normalizedPath.startsWith(dir + '/')) {
+                // But not if it's nested (has a slash before the pattern)
+                const beforePattern = normalizedPath.substring(0, normalizedPath.indexOf(dir));
+                if (!beforePattern || !beforePattern.includes('/')) {
+                    return true;
+                }
+            }
+        }
+    }
+    // Pattern matching with wildcards
+    if (normalizedPattern.includes('*')) {
+        const regexPattern = normalizedPattern
+            .replace(/\./g, '\\.')
+            .replace(/\*/g, '.*')
+            .replace(/\?/g, '.');
+        const regex = new RegExp(`^${regexPattern}$`);
+        if (regex.test(normalizedPath)) {
+            return true;
+        }
+    }
+    // Substring match - pattern matches anywhere in path (but not nested for directory names)
+    // For simple patterns without trailing slash, match anywhere
+    if (!pattern.endsWith('/')) {
+        if (normalizedPath.includes(normalizedPattern) ||
+            normalizedPath.includes('/' + normalizedPattern) ||
+            normalizedPath.endsWith('/' + normalizedPattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a file path should be ignored based on patterns
+ */
+export function shouldIgnorePath(filePath, customPatterns, gitignorePatterns) {
+    // Check custom regex patterns
+    for (const pattern of customPatterns) {
+        try {
+            const regex = new RegExp(pattern);
+            if (regex.test(filePath)) {
+                return true;
+            }
+        }
+        catch (error) {
+            // Invalid regex, skip
+            console.warn(`Invalid regex pattern: ${pattern}`);
+        }
+    }
+    // Check gitignore patterns
+    for (const pattern of gitignorePatterns) {
+        if (matchesGitignorePattern(filePath, pattern)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=pathIgnoring.js.map

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

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

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

@@ -0,0 +1,139 @@
+import spinners from 'cli-spinners';
+import chalk from 'chalk';
+export class ProgressReporter {
+    constructor(quiet = false) {
+        this.spinnerIndex = 0;
+        this.currentMessage = '';
+        this.isSpinning = false;
+        this.spinnerFrames = spinners.dots.frames;
+        this.spinnerInterval = spinners.dots.interval;
+        this.isTTY = process.stdout.isTTY;
+        this.quiet = quiet;
+    }
+    start(message) {
+        this.currentMessage = message;
+        this.isSpinning = true;
+        this.spinnerIndex = 0;
+        ProgressReporter.activeInstance = this;
+        // In quiet mode, don't output anything for start
+        if (this.quiet) {
+            return;
+        }
+        // If not a TTY (e.g., output is being captured), just log the message once
+        if (!this.isTTY) {
+            console.log(chalk.cyan('⠿') + ' ' + this.currentMessage);
+            return;
+        }
+        // Render the first frame immediately so it's visible even if
+        // the caller blocks the event loop with execSync right after.
+        process.stdout.write('\r' +
+            chalk.cyan(this.spinnerFrames[this.spinnerIndex]) +
+            ' ' +
+            this.currentMessage);
+        this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
+        this.spinner = setInterval(() => {
+            process.stdout.write('\r' +
+                chalk.cyan(this.spinnerFrames[this.spinnerIndex]) +
+                ' ' +
+                this.currentMessage);
+            this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
+        }, this.spinnerInterval);
+        // Allow the process to exit even if this interval is still running
+        this.spinner.unref();
+    }
+    static pause() {
+        ProgressReporter.activeInstance?.stop();
+    }
+    static resume() {
+        const instance = ProgressReporter.activeInstance;
+        if (instance && instance.currentMessage) {
+            instance.start(instance.currentMessage);
+        }
+    }
+    update(message) {
+        this.currentMessage = message;
+        // In quiet mode, don't output updates
+        if (this.quiet) {
+            return;
+        }
+        // If not a TTY, log updates as separate lines
+        if (!this.isTTY) {
+            console.log(chalk.cyan('⠿') + ' ' + this.currentMessage);
+        }
+    }
+    succeed(message) {
+        this.stop();
+        const finalMessage = message || this.currentMessage;
+        // In quiet mode, don't output success messages
+        if (this.quiet) {
+            return;
+        }
+        // Skip duplicate message if we already logged it in non-TTY mode
+        if (this.isTTY || finalMessage !== this.currentMessage) {
+            console.log(chalk.green('✓') + ' ' + finalMessage);
+        }
+    }
+    fail(message) {
+        this.stop();
+        const finalMessage = message || this.currentMessage;
+        // In quiet mode, don't output fail messages
+        if (this.quiet) {
+            return;
+        }
+        console.log(chalk.red('✗') + ' ' + finalMessage);
+    }
+    warn(message) {
+        this.stop();
+        // In quiet mode, don't output warnings
+        if (this.quiet) {
+            return;
+        }
+        console.log(chalk.yellow('⚠') + ' ' + message);
+    }
+    info(message) {
+        this.stop();
+        // In quiet mode, don't output info messages
+        if (this.quiet) {
+            return;
+        }
+        console.log(chalk.blue('ℹ') + ' ' + message);
+    }
+    stop() {
+        if (this.spinner) {
+            clearInterval(this.spinner);
+            this.spinner = undefined;
+        }
+        if (this.isSpinning && this.isTTY) {
+            // Clear the entire line and ensure cursor is at the start
+            process.stdout.write('\r\x1b[K');
+            this.isSpinning = false;
+        }
+        if (this === ProgressReporter.activeInstance) {
+            ProgressReporter.activeInstance = undefined;
+        }
+    }
+}
+/**
+ * Helper wrapper to automatically pause/resume spinner during interactive operations
+ */
+export async function withoutSpinner(fn) {
+    ProgressReporter.pause();
+    try {
+        return await fn();
+    }
+    finally {
+        ProgressReporter.resume();
+    }
+}
+// Convenience functions for one-off messages
+export const success = (message) => console.log(chalk.green('✓') + ' ' + message);
+export const error = (message) => console.log(chalk.red('✗') + ' ' + message);
+export const warn = (message) => console.log(chalk.yellow('⚠') + ' ' + message);
+export const info = (message) => console.log(chalk.blue('ℹ') + ' ' + message);
+// Create a styled header
+export const header = (message) => {
+    console.log();
+    console.log(chalk.cyan.bold('🚀 ' + message));
+    console.log();
+};
+//# sourceMappingURL=progress.js.map

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

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

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

@@ -0,0 +1,37 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+export function isForbiddenProjectRoot(dir) {
+    const normalized = path.resolve(dir);
+    const root = path.parse(normalized).root;
+    if (normalized === root)
+        return true;
+    if (normalized === path.resolve(os.homedir()))
+        return true;
+    return false;
+}
+/**
+ * Find the root directory of a CodeYam project by walking up the directory tree
+ * looking for .codeyam/config.json, similar to how git finds .git directories.
+ *
+ * Stops before checking the user's home directory or the filesystem root —
+ * these are never valid project roots.
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @returns Project root path if found, null otherwise
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let currentDir = path.resolve(startDir);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        if (isForbiddenProjectRoot(currentDir))
+            return null;
+        const configPath = path.join(currentDir, '.codeyam', 'config.json');
+        if (fs.existsSync(configPath)) {
+            return currentDir;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+//# sourceMappingURL=project.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../../src/utils/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IACzC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,UAAU,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,OAAO,CAAC,GAAG,EAAE;IAEhC,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,IAAI,sBAAsB,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QACpE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}