create-carlonicora-app 1.4.0 → 1.7.0

package/README.md

@@ -85,18 +85,36 @@ pnpm build
 pnpm sync-template
 ```
 
-### Testing locally
+### Running from local folder
 
 ```bash
-# Build first
+# Clone and build
+git clone https://github.com/carlonicora/create-carlonicora-app.git
+cd create-carlonicora-app
+pnpm install
 pnpm build
 
-# Test with node directly
-node bin/cli.js test-project
+# Go to the parent directory and run the CLI from there
+cd ..
+node create-carlonicora-app/bin/cli.js my-project
 
-# Or link globally
+# Or link globally for convenience
+cd create-carlonicora-app
 npm link
-create-carlonicora-app test-project
+cd ..
+create-carlonicora-app my-project
+```
+
+> **Note:** The project is created in your current working directory. Run the CLI from the directory where you want the project to be created.
+
+#### Options
+
+```bash
+node create-carlonicora-app/bin/cli.js [project-name] [options]
+
+Options:
+  --skip-git       Skip git initialization and submodules
+  --skip-install   Skip dependency installation
 ```
 
 ## License

package/dist/compare/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const IGNORE_PATTERNS: string[];
+export declare const ANYWHERE_IGNORE_PATTERNS: string[];
+export declare const BINARY_EXTENSIONS: Set<string>;
+export declare const CONFIG_FILE_PATTERNS: string[];
+export declare const CODE_PATHS: string[];
+export declare const DOTFILE_RENAMES: Record<string, string>;
+export declare const VERSION_FILES: string[];
+export declare const MAX_DIFF_FILE_SIZE: number;
+//# sourceMappingURL=constants.d.ts.map

package/dist/compare/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/compare/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,UAyD3B,CAAC;AAGF,eAAO,MAAM,wBAAwB,UAUpC,CAAC;AAGF,eAAO,MAAM,iBAAiB,aAoC5B,CAAC;AAGH,eAAO,MAAM,oBAAoB,UAqChC,CAAC;AAIF,eAAO,MAAM,UAAU,UAAqD,CAAC;AAG7E,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASlD,CAAC;AAGF,eAAO,MAAM,aAAa,UAA+C,CAAC;AAG1E,eAAO,MAAM,kBAAkB,QAAc,CAAC"}

package/dist/compare/constants.js

@@ -0,0 +1,167 @@
+// Patterns to ignore during comparison (relative to root)
+export const IGNORE_PATTERNS = [
+    'node_modules',
+    '.git',
+    '.turbo',
+    'dist',
+    '.next',
+    'pnpm-lock.yaml',
+    '.env',
+    '.env.local',
+    '.env.e2e',
+    '.DS_Store',
+    '.claude',
+    '.beads',
+    '.vscode',
+    '.idea',
+    'coverage',
+    '*.log',
+    'test-results',
+    'playwright-report',
+    '.tsbuildinfo',
+    'REST.http',
+    '.worktrees',
+    // Target-specific directories that are project additions (not compared)
+    'docs',
+    'structure',
+    'reports',
+    'infrastructure',
+    'openspec',
+    'models',
+    '__tests__',
+    // Application source code (project-specific, not template)
+    'apps/api/src',
+    'apps/api/.cache',
+    'apps/api/templates',
+    'apps/api/scripts',
+    'apps/api/config',
+    'apps/web/public',
+    'apps/web/messages',
+    'apps/web/__tests__',
+    'apps/web/src/app/[locale]/(main)/(features)',
+    'apps/web/src/app/[locale]/(marketing)',
+    'apps/web/src/app/[locale]/(blocked)',
+    'apps/web/src/app/[locale]/(persons)',
+    'apps/web/src/components',
+    '.husky/_',
+    '.ruff_cache',
+    '.DS_Store',
+    'Dockerfile.backup',
+    // Note: apps/web/src/features/* is excluded EXCEPT features/common (handled in file-collector)
+    // Library packages (git submodules in template, full implementations in target)
+    'packages/nestjs-neo4jsonapi',
+    'packages/nextjs-jsonapi',
+    // Shared package source (project-specific implementations)
+    'packages/shared/src',
+    // Documentation files (project-specific, never sync to template)
+    'CHANGELOG.md',
+    'README.md',
+];
+// Patterns that should be ignored anywhere in the path
+export const ANYWHERE_IGNORE_PATTERNS = [
+    'node_modules',
+    'dist',
+    '.turbo',
+    '.next',
+    'coverage',
+    'test-results',
+    'playwright-report',
+    '.DS_Store',
+    '.ruff_cache',
+];
+// Binary file extensions that should not be processed for text comparison
+export const BINARY_EXTENSIONS = new Set([
+    // Images
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.ico',
+    '.svg',
+    '.bmp',
+    '.tiff',
+    // Fonts
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+    '.otf',
+    // Archives
+    '.tar',
+    '.zip',
+    '.gz',
+    '.rar',
+    '.7z',
+    // Documents
+    '.pdf',
+    // Lock files
+    '.lock',
+    // Other binary formats
+    '.exe',
+    '.dll',
+    '.so',
+    '.dylib',
+    // ML models
+    '.onnx',
+    '.bin',
+    '.safetensors',
+]);
+// Files that are configuration files (for categorization)
+export const CONFIG_FILE_PATTERNS = [
+    'package.json',
+    'tsconfig.json',
+    'tsconfig.base.json',
+    'tsconfig.build.json',
+    'turbo.json',
+    'vitest.config.ts',
+    'vitest.setup.ts',
+    'eslint.config.mjs',
+    'playwright.config.ts',
+    'next.config.js',
+    'nest-cli.json',
+    'jest.config.js',
+    '.prettierrc',
+    'prettierrc',
+    '.prettierignore',
+    'prettierignore',
+    '.releaserc',
+    'releaserc',
+    '.npmrc',
+    'npmrc',
+    '.gitignore',
+    'gitignore',
+    '.gitmodules',
+    'gitmodules',
+    'docker-compose.yml',
+    'docker-compose.api.yml',
+    'docker-compose.web.yml',
+    'docker-compose.worker.yml',
+    'Dockerfile',
+    'components.json',
+    'postcss.config.mjs',
+    'pnpm-workspace.yaml',
+    '.swcrc',
+    'swcrc',
+    'next-env.d.ts',
+    'global.d.ts',
+];
+// Paths that contain application code (for categorization)
+// Note: apps/api/src, apps/web/src/features/* (except common), and packages/shared/src are excluded
+export const CODE_PATHS = ['apps/web/src/', 'apps/web/src/features/common/'];
+// Dotfile rename mapping (template stores without dot, target has dot)
+export const DOTFILE_RENAMES = {
+    gitignore: '.gitignore',
+    gitmodules: '.gitmodules',
+    prettierrc: '.prettierrc',
+    prettierignore: '.prettierignore',
+    npmrc: '.npmrc',
+    releaserc: '.releaserc',
+    swcrc: '.swcrc',
+    'env.example': '.env.example',
+};
+// Files that should be compared for version drift
+export const VERSION_FILES = ['package.json', 'versions.production.json'];
+// Maximum file size to show full diff (1MB)
+export const MAX_DIFF_FILE_SIZE = 1024 * 1024;
+//# sourceMappingURL=constants.js.map

package/dist/compare/constants.js.map

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

package/dist/compare/diff-categorizer.d.ts

@@ -0,0 +1,17 @@
+import type { FileDiff, DiffCategory } from './types.js';
+/**
+ * Categorize a file diff based on its path and content changes
+ */
+export declare function categorizeDiff(diff: FileDiff): DiffCategory;
+/**
+ * Categorize an addition (file in target but not in template)
+ */
+export declare function categorizeAddition(relativePath: string): {
+    category: string;
+    group: string;
+};
+/**
+ * Apply categorization to all diffs
+ */
+export declare function applyCategories(diffs: FileDiff[]): FileDiff[];
+//# sourceMappingURL=diff-categorizer.d.ts.map

package/dist/compare/diff-categorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-categorizer.d.ts","sourceRoot":"","sources":["../../src/compare/diff-categorizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmCzD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAwB3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAmFA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAK7D"}

package/dist/compare/diff-categorizer.js

@@ -0,0 +1,128 @@
+import { CONFIG_FILE_PATTERNS, CODE_PATHS } from './constants.js';
+/**
+ * Check if a file path matches any of the config file patterns
+ */
+function isConfigFile(relativePath) {
+    const fileName = relativePath.split('/').pop() || '';
+    for (const pattern of CONFIG_FILE_PATTERNS) {
+        if (fileName === pattern)
+            return true;
+        if (pattern.includes('*')) {
+            const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+            if (regex.test(fileName))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a file path is within a code path
+ */
+function isCodePath(relativePath) {
+    const normalizedPath = relativePath.replace(/\\/g, '/');
+    for (const codePath of CODE_PATHS) {
+        if (normalizedPath.startsWith(codePath)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Categorize a file diff based on its path and content changes
+ */
+export function categorizeDiff(diff) {
+    const { relativePath, category } = diff;
+    // Keep certain categories as-is
+    if (category === 'identical' ||
+        category === 'addition' ||
+        category === 'missing-from-target' ||
+        category === 'version-drift') {
+        return category;
+    }
+    // For modified files, categorize based on path
+    if (isCodePath(relativePath)) {
+        return 'custom-code';
+    }
+    if (isConfigFile(relativePath)) {
+        return 'config-drift';
+    }
+    // Default to config-drift for other files
+    return 'config-drift';
+}
+/**
+ * Categorize an addition (file in target but not in template)
+ */
+export function categorizeAddition(relativePath) {
+    const normalizedPath = relativePath.replace(/\\/g, '/');
+    // Feature modules
+    if (normalizedPath.startsWith('apps/api/src/features/')) {
+        const featureName = normalizedPath.split('/')[4] || 'unknown';
+        return { category: 'Feature Module (API)', group: featureName };
+    }
+    if (normalizedPath.startsWith('apps/web/src/features/')) {
+        const featureName = normalizedPath.split('/')[4] || 'unknown';
+        return { category: 'Feature Module (Web)', group: featureName };
+    }
+    // Documentation
+    if (normalizedPath.startsWith('docs/') ||
+        normalizedPath.endsWith('.md') ||
+        normalizedPath === 'AGENTS.md' ||
+        normalizedPath === 'CONTRIBUTING.md' ||
+        normalizedPath === 'AI-ARCHITECTURE-GUIDE.md') {
+        return { category: 'Documentation', group: 'docs' };
+    }
+    // Configuration/Infrastructure
+    if (normalizedPath.startsWith('infrastructure/') ||
+        normalizedPath.startsWith('openspec/')) {
+        return { category: 'Infrastructure', group: normalizedPath.split('/')[0] };
+    }
+    // Structure/Schema definitions
+    if (normalizedPath.startsWith('structure/')) {
+        return { category: 'Data Structures', group: 'structure' };
+    }
+    // Tests
+    if (normalizedPath.includes('__tests__/') ||
+        normalizedPath.includes('.test.') ||
+        normalizedPath.includes('.spec.')) {
+        return { category: 'Tests', group: 'tests' };
+    }
+    // Scripts
+    if (normalizedPath.startsWith('scripts/')) {
+        return { category: 'Scripts', group: 'scripts' };
+    }
+    // API source additions
+    if (normalizedPath.startsWith('apps/api/src/')) {
+        return { category: 'API Source', group: 'apps/api' };
+    }
+    // Web source additions
+    if (normalizedPath.startsWith('apps/web/src/')) {
+        return { category: 'Web Source', group: 'apps/web' };
+    }
+    // Shared package additions
+    if (normalizedPath.startsWith('packages/shared/')) {
+        return { category: 'Shared Package', group: 'packages/shared' };
+    }
+    // Library packages (full implementations)
+    if (normalizedPath.startsWith('packages/nestjs-neo4jsonapi/')) {
+        return { category: 'Library Package', group: 'nestjs-neo4jsonapi' };
+    }
+    if (normalizedPath.startsWith('packages/nextjs-jsonapi/')) {
+        return { category: 'Library Package', group: 'nextjs-jsonapi' };
+    }
+    // Root files
+    if (!normalizedPath.includes('/')) {
+        return { category: 'Root Files', group: 'root' };
+    }
+    // Default
+    return { category: 'Other', group: 'other' };
+}
+/**
+ * Apply categorization to all diffs
+ */
+export function applyCategories(diffs) {
+    return diffs.map((diff) => ({
+        ...diff,
+        category: categorizeDiff(diff),
+    }));
+}
+//# sourceMappingURL=diff-categorizer.js.map

package/dist/compare/diff-categorizer.js.map

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

package/dist/compare/file-collector.d.ts

@@ -0,0 +1,27 @@
+import type { FileEntry } from './types.js';
+/**
+ * Check if a path should be ignored based on patterns
+ */
+export declare function shouldIgnore(relativePath: string, additionalIgnorePatterns?: string[]): boolean;
+/**
+ * Normalize a template path to how it would appear in the target
+ * Handles dotfile renames (e.g., 'gitignore' -> '.gitignore')
+ */
+export declare function normalizeTemplatePath(templateRelativePath: string): string;
+/**
+ * Parse .gitignore file and return patterns
+ */
+export declare function parseGitignore(projectPath: string): Promise<string[]>;
+/**
+ * Collect all files from a directory
+ */
+export declare function collectFiles(basePath: string, options?: {
+    normalizeTemplatedDotfiles?: boolean;
+    additionalIgnorePatterns?: string[];
+}): Promise<Map<string, FileEntry>>;
+/**
+ * Get the original template path from a normalized path
+ * This is the reverse of normalizeTemplatePath
+ */
+export declare function getOriginalTemplatePath(normalizedPath: string): string;
+//# sourceMappingURL=file-collector.d.ts.map

package/dist/compare/file-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-collector.d.ts","sourceRoot":"","sources":["../../src/compare/file-collector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C;;GAEG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,wBAAwB,GAAE,MAAM,EAAO,GACtC,OAAO,CAgCT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAW1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB3E;AAyCD;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,GACL,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAUjC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAatE"}

package/dist/compare/file-collector.js

@@ -0,0 +1,128 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { IGNORE_PATTERNS, ANYWHERE_IGNORE_PATTERNS, DOTFILE_RENAMES, } from './constants.js';
+/**
+ * Check if a path should be ignored based on patterns
+ */
+export function shouldIgnore(relativePath, additionalIgnorePatterns = []) {
+    const normalizedPath = relativePath.replace(/\\/g, '/');
+    const pathParts = normalizedPath.split('/');
+    // Check patterns that apply anywhere in the path
+    for (const pattern of ANYWHERE_IGNORE_PATTERNS) {
+        if (pathParts.includes(pattern))
+            return true;
+    }
+    // Special case: apps/web/src/features/* is ignored EXCEPT features/common
+    if (normalizedPath.startsWith('apps/web/src/features/')) {
+        if (!normalizedPath.startsWith('apps/web/src/features/common/') &&
+            normalizedPath !== 'apps/web/src/features/common') {
+            return true;
+        }
+    }
+    // Check standard ignore patterns
+    const allPatterns = [...IGNORE_PATTERNS, ...additionalIgnorePatterns];
+    for (const pattern of allPatterns) {
+        if (normalizedPath === pattern)
+            return true;
+        if (normalizedPath.startsWith(pattern + '/'))
+            return true;
+        if (pattern.endsWith('/') && normalizedPath.startsWith(pattern))
+            return true;
+        if (pattern.startsWith('*.')) {
+            const ext = pattern.slice(1);
+            if (normalizedPath.endsWith(ext))
+                return true;
+        }
+        if (pattern === '.tsbuildinfo' && normalizedPath.endsWith('.tsbuildinfo'))
+            return true;
+    }
+    return false;
+}
+/**
+ * Normalize a template path to how it would appear in the target
+ * Handles dotfile renames (e.g., 'gitignore' -> '.gitignore')
+ */
+export function normalizeTemplatePath(templateRelativePath) {
+    const parts = templateRelativePath.split('/');
+    const fileName = parts[parts.length - 1];
+    // Check if the filename needs renaming
+    if (DOTFILE_RENAMES[fileName]) {
+        parts[parts.length - 1] = DOTFILE_RENAMES[fileName];
+        return parts.join('/');
+    }
+    return templateRelativePath;
+}
+/**
+ * Parse .gitignore file and return patterns
+ */
+export async function parseGitignore(projectPath) {
+    const gitignorePath = path.join(projectPath, '.gitignore');
+    try {
+        if (await fs.pathExists(gitignorePath)) {
+            const content = await fs.readFile(gitignorePath, 'utf-8');
+            return content
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line && !line.startsWith('#'));
+        }
+    }
+    catch {
+        // Ignore errors reading .gitignore
+    }
+    return [];
+}
+/**
+ * Recursively collect all files from a directory
+ */
+async function collectFilesRecursive(basePath, currentPath, files, options) {
+    const entries = await fs.readdir(currentPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const absolutePath = path.join(currentPath, entry.name);
+        let relativePath = path.relative(basePath, absolutePath);
+        // Skip ignored paths
+        if (shouldIgnore(relativePath, options.additionalIgnorePatterns)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            await collectFilesRecursive(basePath, absolutePath, files, options);
+        }
+        else if (entry.isFile()) {
+            // Normalize path for template files if needed
+            if (options.normalizeTemplatedDotfiles) {
+                relativePath = normalizeTemplatePath(relativePath);
+            }
+            files.set(relativePath, {
+                relativePath,
+                absolutePath,
+            });
+        }
+    }
+}
+/**
+ * Collect all files from a directory
+ */
+export async function collectFiles(basePath, options = {}) {
+    const files = new Map();
+    if (!(await fs.pathExists(basePath))) {
+        throw new Error(`Directory does not exist: ${basePath}`);
+    }
+    await collectFilesRecursive(basePath, basePath, files, options);
+    return files;
+}
+/**
+ * Get the original template path from a normalized path
+ * This is the reverse of normalizeTemplatePath
+ */
+export function getOriginalTemplatePath(normalizedPath) {
+    const parts = normalizedPath.split('/');
+    const fileName = parts[parts.length - 1];
+    // Check if the filename is a renamed dotfile
+    for (const [original, renamed] of Object.entries(DOTFILE_RENAMES)) {
+        if (fileName === renamed) {
+            parts[parts.length - 1] = original;
+            return parts.join('/');
+        }
+    }
+    return normalizedPath;
+}
+//# sourceMappingURL=file-collector.js.map

package/dist/compare/file-collector.js.map

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

package/dist/compare/file-comparator.d.ts

@@ -0,0 +1,21 @@
+import type { FileEntry, FileDiff, VersionDiff } from './types.js';
+/**
+ * Check if a file is binary based on extension
+ */
+export declare function isBinaryFile(filePath: string): boolean;
+/**
+ * Replace {{name}} placeholders with the project name
+ */
+export declare function resolvePlaceholders(content: string, projectName: string): string;
+/**
+ * Detect version drift in package.json files
+ */
+export declare function detectVersionDrift(templateContent: string, targetContent: string): {
+    isVersionDriftOnly: boolean;
+    versionDiffs: VersionDiff[];
+};
+/**
+ * Compare two files and generate a FileDiff
+ */
+export declare function compareFiles(templateEntry: FileEntry | undefined, targetEntry: FileEntry | undefined, projectName: string): Promise<FileDiff>;
+//# sourceMappingURL=file-comparator.d.ts.map

package/dist/compare/file-comparator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-comparator.d.ts","sourceRoot":"","sources":["../../src/compare/file-comparator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AA4ED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB;IAAE,kBAAkB,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,WAAW,EAAE,CAAA;CAAE,CA4E9D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,SAAS,GAAG,SAAS,EACpC,WAAW,EAAE,SAAS,GAAG,SAAS,EAClC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,CAAC,CA0GnB"}