@fnd-platform/cli 1.0.0-alpha.1

package/lib/lib/nx-stats.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACHE_HIT_TARGET = void 0;
+exports.parseNxOutput = parseNxOutput;
+exports.getCacheDirectoryStats = getCacheDirectoryStats;
+exports.formatCacheStats = formatCacheStats;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Target cache hit ratio (80%).
+ */
+exports.CACHE_HIT_TARGET = 0.8;
+/**
+ * Parses NX output to extract cache statistics.
+ *
+ * @param output - NX command output
+ * @returns Cache statistics or null if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const output = `
+ * >  NX   Successfully ran target build for 5 projects (234ms)
+ *
+ *    Nx read the output from the cache instead of running the command for 4 out of 5 tasks.
+ * `;
+ * const stats = parseNxOutput(output);
+ * // { totalTasks: 5, cacheHits: 4, cacheMisses: 1, hitRatio: 0.8, ... }
+ * ```
+ */
+function parseNxOutput(output) {
+    // Match patterns like "4 out of 5 tasks" or "read from cache for X tasks"
+    const cacheMatch = output.match(/(?:instead of running the command for |from cache for )(\d+) out of (\d+) tasks/i);
+    if (cacheMatch) {
+        const cacheHits = parseInt(cacheMatch[1], 10);
+        const totalTasks = parseInt(cacheMatch[2], 10);
+        const cacheMisses = totalTasks - cacheHits;
+        const hitRatio = totalTasks > 0 ? cacheHits / totalTasks : 0;
+        return {
+            totalTasks,
+            cacheHits,
+            cacheMisses,
+            hitRatio,
+            hitRatioFormatted: `${(hitRatio * 100).toFixed(1)}%`,
+            meetsTarget: hitRatio >= exports.CACHE_HIT_TARGET,
+        };
+    }
+    // Check for "Successfully ran target X for N projects"
+    const successMatch = output.match(/Successfully ran target \w+ for (\d+) projects?/i);
+    if (successMatch) {
+        const totalTasks = parseInt(successMatch[1], 10);
+        // If no cache message, all were cache misses
+        return {
+            totalTasks,
+            cacheHits: 0,
+            cacheMisses: totalTasks,
+            hitRatio: 0,
+            hitRatioFormatted: '0.0%',
+            meetsTarget: false,
+        };
+    }
+    return null;
+}
+/**
+ * Gets cache statistics from the NX cache directory.
+ *
+ * @param projectRoot - Root directory of the project
+ * @returns Cache statistics based on cache directory analysis
+ */
+function getCacheDirectoryStats(projectRoot) {
+    const cacheDir = (0, path_1.join)(projectRoot, 'node_modules', '.cache', 'nx');
+    if (!(0, fs_1.existsSync)(cacheDir)) {
+        return null;
+    }
+    const walkDir = (dir, state) => {
+        const entries = (0, fs_1.readdirSync)(dir);
+        for (const entry of entries) {
+            const fullPath = (0, path_1.join)(dir, entry);
+            const stat = (0, fs_1.statSync)(fullPath);
+            if (stat.isDirectory()) {
+                state.entryCount++;
+                walkDir(fullPath, state);
+            }
+            else {
+                state.totalSize += stat.size;
+            }
+        }
+    };
+    try {
+        const state = { totalSize: 0, entryCount: 0 };
+        walkDir(cacheDir, state);
+        return {
+            cacheEntries: state.entryCount,
+            cacheSizeMB: Math.round((state.totalSize / (1024 * 1024)) * 100) / 100,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Creates a formatted report of NX cache statistics.
+ *
+ * @param stats - Cache statistics to report
+ * @returns Formatted string for display
+ */
+function formatCacheStats(stats) {
+    const lines = [
+        'NX Cache Statistics:',
+        `  Total tasks:   ${stats.totalTasks}`,
+        `  Cache hits:    ${stats.cacheHits}`,
+        `  Cache misses:  ${stats.cacheMisses}`,
+        `  Hit ratio:     ${stats.hitRatioFormatted}`,
+        `  Target (>80%): ${stats.meetsTarget ? 'PASS' : 'FAIL'}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=nx-stats.js.map

package/lib/lib/nx-stats.js.map

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

package/lib/lib/project.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Searches upward from a starting directory to find the project root.
+ * The project root is identified by the presence of a .projenrc.ts file.
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns The project root path, or null if not found
+ */
+export declare function findProjectRoot(startDir?: string): string | null;
+/**
+ * Finds the project root or throws an error if not in a project.
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns The project root path
+ * @throws Error if not inside an fnd-platform project
+ */
+export declare function requireProjectRoot(startDir?: string): string;
+//# sourceMappingURL=project.d.ts.map

package/lib/lib/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/lib/project.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAoB/E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAU3E"}

package/lib/lib/project.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findProjectRoot = findProjectRoot;
+exports.requireProjectRoot = requireProjectRoot;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Searches upward from a starting directory to find the project root.
+ * The project root is identified by the presence of a .projenrc.ts file.
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns The project root path, or null if not found
+ */
+function findProjectRoot(startDir = process.cwd()) {
+    let currentDir = (0, path_1.resolve)(startDir);
+    // Traverse up the directory tree
+    let reachedRoot = false;
+    while (!reachedRoot) {
+        if ((0, fs_1.existsSync)((0, path_1.join)(currentDir, '.projenrc.ts'))) {
+            return currentDir;
+        }
+        const parent = (0, path_1.dirname)(currentDir);
+        if (parent === currentDir) {
+            // Reached filesystem root
+            reachedRoot = true;
+        }
+        else {
+            currentDir = parent;
+        }
+    }
+    return null;
+}
+/**
+ * Finds the project root or throws an error if not in a project.
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns The project root path
+ * @throws Error if not inside an fnd-platform project
+ */
+function requireProjectRoot(startDir = process.cwd()) {
+    const root = findProjectRoot(startDir);
+    if (!root) {
+        throw new Error('Not inside an fnd-platform project. ' +
+            'Run this command from a project directory containing .projenrc.ts, ' +
+            'or create a new project with: fnd new <project-name>');
+    }
+    return root;
+}
+//# sourceMappingURL=project.js.map

package/lib/lib/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/lib/project.ts"],"names":[],"mappings":";;AAUA,0CAoBC;AASD,gDAUC;AAjDD,2BAAgC;AAChC,+BAA8C;AAE9C;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,UAAU,GAAG,IAAA,cAAO,EAAC,QAAQ,CAAC,CAAC;IAEnC,iCAAiC;IACjC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,WAAW,EAAE,CAAC;QACpB,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,UAAU,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,0BAA0B;YAC1B,WAAW,GAAG,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,sCAAsC;YACpC,qEAAqE;YACrE,sDAAsD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/lib/templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Template for .projenrc.ts file in new projects.
+ *
+ * @param projectName - The name of the project
+ * @returns The .projenrc.ts file content
+ */
+export declare function getProjenrcTemplate(projectName: string): string;
+/**
+ * Template for initial package.json before Projen runs.
+ *
+ * @param projectName - The name of the project
+ * @param packageManager - The package manager to use
+ * @returns The package.json content as an object
+ */
+export declare function getInitialPackageJson(projectName: string, packageManager?: 'pnpm' | 'yarn'): Record<string, unknown>;
+//# sourceMappingURL=templates.d.ts.map

package/lib/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAU/D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,cAAc,GAAE,MAAM,GAAG,MAAe,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB"}

package/lib/lib/templates.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjenrcTemplate = getProjenrcTemplate;
+exports.getInitialPackageJson = getInitialPackageJson;
+/**
+ * Template for .projenrc.ts file in new projects.
+ *
+ * @param projectName - The name of the project
+ * @returns The .projenrc.ts file content
+ */
+function getProjenrcTemplate(projectName) {
+    return `import { FndMonorepoProject } from '@fnd-platform/core';
+
+const project = new FndMonorepoProject({
+  name: '${projectName}',
+  defaultReleaseBranch: 'main',
+});
+
+project.synth();
+`;
+}
+/**
+ * Template for initial package.json before Projen runs.
+ *
+ * @param projectName - The name of the project
+ * @param packageManager - The package manager to use
+ * @returns The package.json content as an object
+ */
+function getInitialPackageJson(projectName, packageManager = 'pnpm') {
+    return {
+        name: projectName,
+        version: '0.0.0',
+        private: true,
+        devDependencies: {
+            '@fnd-platform/core': '^0.1.0',
+            projen: '^0.91.0',
+            typescript: '^5.6.3',
+        },
+        ...(packageManager === 'pnpm' && { packageManager: 'pnpm@10.6.5' }),
+    };
+}
+//# sourceMappingURL=templates.js.map

package/lib/lib/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":";;AAMA,kDAUC;AASD,sDAeC;AAxCD;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,OAAO;;;WAGE,WAAW;;;;;CAKrB,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,WAAmB,EACnB,iBAAkC,MAAM;IAExC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE;YACf,oBAAoB,EAAE,QAAQ;YAC9B,MAAM,EAAE,SAAS;YACjB,UAAU,EAAE,QAAQ;SACrB;QACD,GAAG,CAAC,cAAc,KAAK,MAAM,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/lib/lib/timer.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Performance timing utilities for CLI profiling.
+ * Enable profiling with FND_PROFILE=true environment variable.
+ */
+/**
+ * Result of a single timing measurement.
+ */
+export interface TimingResult {
+    /**
+     * Name/label for this timing.
+     */
+    name: string;
+    /**
+     * Duration in milliseconds.
+     */
+    durationMs: number;
+    /**
+     * Human-readable duration string.
+     */
+    durationFormatted: string;
+}
+/**
+ * Complete profile report for a command execution.
+ */
+export interface ProfileReport {
+    /**
+     * Command that was profiled (e.g., 'fnd new', 'fnd build').
+     */
+    command: string;
+    /**
+     * Total execution time in milliseconds.
+     */
+    totalDurationMs: number;
+    /**
+     * Total execution time formatted for display.
+     */
+    totalDurationFormatted: string;
+    /**
+     * Individual timing measurements.
+     */
+    timings: TimingResult[];
+    /**
+     * Whether the command completed successfully.
+     */
+    success: boolean;
+}
+/**
+ * Formats milliseconds into a human-readable string.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(1234);  // "1.23s"
+ * formatDuration(234);   // "234ms"
+ * formatDuration(65000); // "1m 5.00s"
+ * ```
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * High-resolution performance timer for profiling CLI commands.
+ *
+ * @example
+ * ```typescript
+ * const timer = new PerformanceTimer('fnd new');
+ *
+ * timer.start('file-generation');
+ * // ... do file generation
+ * timer.end('file-generation');
+ *
+ * timer.start('git-init');
+ * // ... do git init
+ * timer.end('git-init');
+ *
+ * const report = timer.getReport(true);
+ * console.log(report.timings);
+ * ```
+ */
+export declare class PerformanceTimer {
+    private command;
+    private startTime;
+    private activeTimers;
+    private timings;
+    /**
+     * Creates a new performance timer.
+     *
+     * @param command - Name of the command being profiled
+     */
+    constructor(command: string);
+    /**
+     * Starts timing a named phase.
+     *
+     * @param name - Name of the phase to time
+     * @throws Error if a timer with the same name is already running
+     */
+    start(name: string): void;
+    /**
+     * Ends timing a named phase and records the result.
+     *
+     * @param name - Name of the phase to stop timing
+     * @returns The timing result
+     * @throws Error if no timer with the given name is running
+     */
+    end(name: string): TimingResult;
+    /**
+     * Gets the complete profile report.
+     *
+     * @param success - Whether the command completed successfully
+     * @returns Complete profile report
+     */
+    getReport(success: boolean): ProfileReport;
+    /**
+     * Checks if profiling is enabled via FND_PROFILE environment variable.
+     *
+     * @returns true if profiling is enabled
+     */
+    static isEnabled(): boolean;
+}
+//# sourceMappingURL=timer.d.ts.map

package/lib/lib/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/lib/timer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,OAAO,CAAsB;IAErC;;;;OAIG;gBACS,OAAO,EAAE,MAAM;IAK3B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAoB/B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa;IAY1C;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;CAG5B"}

package/lib/lib/timer.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Performance timing utilities for CLI profiling.
+ * Enable profiling with FND_PROFILE=true environment variable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceTimer = void 0;
+exports.formatDuration = formatDuration;
+/**
+ * Formats milliseconds into a human-readable string.
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ *
+ * @example
+ * ```typescript
+ * formatDuration(1234);  // "1.23s"
+ * formatDuration(234);   // "234ms"
+ * formatDuration(65000); // "1m 5.00s"
+ * ```
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${Math.round(ms)}ms`;
+    }
+    if (ms < 60000) {
+        return `${(ms / 1000).toFixed(2)}s`;
+    }
+    const minutes = Math.floor(ms / 60000);
+    const seconds = ((ms % 60000) / 1000).toFixed(2);
+    return `${minutes}m ${seconds}s`;
+}
+/**
+ * High-resolution performance timer for profiling CLI commands.
+ *
+ * @example
+ * ```typescript
+ * const timer = new PerformanceTimer('fnd new');
+ *
+ * timer.start('file-generation');
+ * // ... do file generation
+ * timer.end('file-generation');
+ *
+ * timer.start('git-init');
+ * // ... do git init
+ * timer.end('git-init');
+ *
+ * const report = timer.getReport(true);
+ * console.log(report.timings);
+ * ```
+ */
+class PerformanceTimer {
+    command;
+    startTime;
+    activeTimers = new Map();
+    timings = [];
+    /**
+     * Creates a new performance timer.
+     *
+     * @param command - Name of the command being profiled
+     */
+    constructor(command) {
+        this.command = command;
+        this.startTime = performance.now();
+    }
+    /**
+     * Starts timing a named phase.
+     *
+     * @param name - Name of the phase to time
+     * @throws Error if a timer with the same name is already running
+     */
+    start(name) {
+        if (this.activeTimers.has(name)) {
+            throw new Error(`Timer '${name}' is already running`);
+        }
+        this.activeTimers.set(name, performance.now());
+    }
+    /**
+     * Ends timing a named phase and records the result.
+     *
+     * @param name - Name of the phase to stop timing
+     * @returns The timing result
+     * @throws Error if no timer with the given name is running
+     */
+    end(name) {
+        const startTime = this.activeTimers.get(name);
+        if (startTime === undefined) {
+            throw new Error(`Timer '${name}' was not started`);
+        }
+        const endTime = performance.now();
+        const durationMs = endTime - startTime;
+        this.activeTimers.delete(name);
+        const result = {
+            name,
+            durationMs,
+            durationFormatted: formatDuration(durationMs),
+        };
+        this.timings.push(result);
+        return result;
+    }
+    /**
+     * Gets the complete profile report.
+     *
+     * @param success - Whether the command completed successfully
+     * @returns Complete profile report
+     */
+    getReport(success) {
+        const totalDurationMs = performance.now() - this.startTime;
+        return {
+            command: this.command,
+            totalDurationMs,
+            totalDurationFormatted: formatDuration(totalDurationMs),
+            timings: [...this.timings],
+            success,
+        };
+    }
+    /**
+     * Checks if profiling is enabled via FND_PROFILE environment variable.
+     *
+     * @returns true if profiling is enabled
+     */
+    static isEnabled() {
+        return process.env.FND_PROFILE === 'true' || process.env.FND_PROFILE === '1';
+    }
+}
+exports.PerformanceTimer = PerformanceTimer;
+//# sourceMappingURL=timer.js.map

package/lib/lib/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/lib/timer.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAiEH,wCAUC;AAvBD;;;;;;;;;;;;GAYG;AACH,SAAgB,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IAC/B,CAAC;IACD,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,gBAAgB;IACnB,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,YAAY,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC9C,OAAO,GAAmB,EAAE,CAAC;IAErC;;;;OAIG;IACH,YAAY,OAAe;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,sBAAsB,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,IAAY;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE/B,MAAM,MAAM,GAAiB;YAC3B,IAAI;YACJ,UAAU;YACV,iBAAiB,EAAE,cAAc,CAAC,UAAU,CAAC;SAC9C,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAgB;QACxB,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe;YACf,sBAAsB,EAAE,cAAc,CAAC,eAAe,CAAC;YACvD,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YAC1B,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS;QACd,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC;IAC/E,CAAC;CACF;AAlFD,4CAkFC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fnd-platform/cli",
+  "version": "1.0.0-alpha.1",
+  "description": "CLI tool for fnd-platform monorepo scaffolding",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "bin": {
+    "fnd": "./lib/bin/fnd.js"
+  },
+  "files": [
+    "lib/"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "@fnd-platform/core": "1.0.0-alpha.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "eslint": "^8.57.0",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0"
+  },
+  "keywords": [
+    "cli",
+    "fnd-platform",
+    "monorepo",
+    "scaffolding",
+    "aws",
+    "typescript"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/fnd-platform",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "chmod +x lib/bin/fnd.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "e2e": "vitest run --config vitest.config.e2e.ts",
+    "e2e:watch": "vitest --config vitest.config.e2e.ts",
+    "lint": "eslint src/ test/"
+  }
+}