@jahanxu/trellis 0.4.1

package/dist/types/ai-tools.js

@@ -0,0 +1,103 @@
+/**
+ * AI Tool Types and Registry
+ *
+ * Defines supported AI coding tools and which command templates they can use.
+ */
+/**
+ * Registry of all supported AI tools and their configurations.
+ * This is the single source of truth for platform data.
+ *
+ * When adding a new platform, add an entry here and create:
+ * 1. src/configurators/{platform}.ts — configure function
+ * 2. src/templates/{platform}/ — template files
+ * 3. Register in src/configurators/index.ts — PLATFORM_FUNCTIONS
+ * 4. Add CLI flag in src/cli/index.ts
+ * 5. Add to InitOptions in src/commands/init.ts
+ */
+export const AI_TOOLS = {
+    "claude-code": {
+        name: "Claude Code",
+        templateDirs: ["common", "claude"],
+        configDir: ".claude",
+        cliFlag: "claude",
+        defaultChecked: true,
+        hasPythonHooks: true,
+    },
+    cursor: {
+        name: "Cursor",
+        templateDirs: ["common", "cursor"],
+        configDir: ".cursor",
+        cliFlag: "cursor",
+        defaultChecked: true,
+        hasPythonHooks: false,
+    },
+    opencode: {
+        name: "OpenCode",
+        templateDirs: ["common", "opencode"],
+        configDir: ".opencode",
+        cliFlag: "opencode",
+        defaultChecked: false,
+        hasPythonHooks: false,
+    },
+    iflow: {
+        name: "iFlow CLI",
+        templateDirs: ["common", "iflow"],
+        configDir: ".iflow",
+        cliFlag: "iflow",
+        defaultChecked: false,
+        hasPythonHooks: true,
+    },
+    codex: {
+        name: "Codex",
+        templateDirs: ["common", "codex"],
+        configDir: ".agents/skills",
+        cliFlag: "codex",
+        defaultChecked: false,
+        hasPythonHooks: false,
+    },
+    kilo: {
+        name: "Kilo CLI",
+        templateDirs: ["common", "kilo"],
+        configDir: ".kilocode",
+        cliFlag: "kilo",
+        defaultChecked: false,
+        hasPythonHooks: false,
+    },
+    kiro: {
+        name: "Kiro Code",
+        templateDirs: ["common", "kiro"],
+        configDir: ".kiro/skills",
+        cliFlag: "kiro",
+        defaultChecked: false,
+        hasPythonHooks: false,
+    },
+    gemini: {
+        name: "Gemini CLI",
+        templateDirs: ["common", "gemini"],
+        configDir: ".gemini",
+        cliFlag: "gemini",
+        defaultChecked: false,
+        hasPythonHooks: false,
+    },
+    antigravity: {
+        name: "Antigravity",
+        templateDirs: ["common", "antigravity"],
+        configDir: ".agent/workflows",
+        cliFlag: "antigravity",
+        defaultChecked: false,
+        hasPythonHooks: false,
+    },
+};
+/**
+ * Get the configuration for a specific AI tool
+ */
+export function getToolConfig(tool) {
+    return AI_TOOLS[tool];
+}
+/**
+ * Get template directories for a specific tool
+ */
+export function getTemplateDirs(tool) {
+    return AI_TOOLS[tool].templateDirs;
+}
+//# sourceMappingURL=ai-tools.js.map

package/dist/types/ai-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../../src/types/ai-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAiC;IACpD,aAAa,EAAE;QACb,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAClC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,QAAQ;QACjB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,IAAI;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAClC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,QAAQ;QACjB,cAAc,EAAE,IAAI;QACpB,cAAc,EAAE,KAAK;KACtB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QACpC,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,UAAU;QACnB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACjC,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,OAAO;QAChB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,IAAI;KACrB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QACjC,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,OAAO;QAChB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAChC,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;QAChC,SAAS,EAAE,cAAc;QACzB,OAAO,EAAE,MAAM;QACf,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAClC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,QAAQ;QACjB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;QACvC,SAAS,EAAE,kBAAkB;QAC7B,OAAO,EAAE,aAAa;QACtB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AACrC,CAAC"}

package/dist/types/migration.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Migration types for Trellis update command
+ *
+ * These types support intelligent migration during updates,
+ * handling file renames, deletions, and user modification detection.
+ */
+/**
+ * A single migration action (rename, rename-dir, or delete)
+ */
+export interface MigrationItem {
+    /** Type of migration action */
+    type: "rename" | "rename-dir" | "delete";
+    /** Source path (relative to project root) */
+    from: string;
+    /** Target path for renames (relative to project root) */
+    to?: string;
+    /** Human-readable description of the change */
+    description?: string;
+}
+/**
+ * Migration manifest for a specific version
+ */
+export interface MigrationManifest {
+    /** Target version this migration upgrades to */
+    version: string;
+    /** Human-readable description of changes in this version */
+    description?: string;
+    /** List of migration actions */
+    migrations: MigrationItem[];
+    /** Detailed changelog for display to users */
+    changelog?: string;
+    /** Whether this version contains breaking changes */
+    breaking?: boolean;
+    /** Whether users should run --migrate (recommended for breaking changes) */
+    recommendMigrate?: boolean;
+    /** Detailed migration guide for AI-assisted fixes (markdown format) */
+    migrationGuide?: string;
+    /** Instructions for AI assistants on how to help with migration */
+    aiInstructions?: string;
+}
+/**
+ * Classification of how a migration should be handled
+ */
+export type MigrationClassification = "auto" | "confirm" | "conflict" | "skip";
+/**
+ * Classified migration item with its determined action
+ */
+export interface ClassifiedMigrationItem extends MigrationItem {
+    classification: MigrationClassification;
+}
+/**
+ * Result of classifying all migrations
+ */
+export interface ClassifiedMigrations {
+    /** Unmodified files - safe to auto-migrate */
+    auto: MigrationItem[];
+    /** User-modified files - need confirmation */
+    confirm: MigrationItem[];
+    /** Conflict - both old and new exist */
+    conflict: MigrationItem[];
+    /** Skip - old file doesn't exist */
+    skip: MigrationItem[];
+}
+/**
+ * Result of executing migrations
+ */
+export interface MigrationResult {
+    /** Number of files renamed */
+    renamed: number;
+    /** Number of files deleted */
+    deleted: number;
+    /** Number of files skipped (user choice or no action needed) */
+    skipped: number;
+    /** Number of conflicts encountered */
+    conflicts: number;
+}
+/**
+ * User action choice for migration confirmation
+ */
+export type MigrationAction = "rename" | "backup-rename" | "skip" | "view-diff";
+/**
+ * Template hashes storage structure
+ * Maps relative file paths to their SHA256 hashes
+ */
+export type TemplateHashes = Record<string, string>;
+//# sourceMappingURL=migration.d.ts.map

package/dist/types/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;IACzC,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,SAAS,GACT,UAAU,GACV,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,cAAc,EAAE,uBAAuB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,8CAA8C;IAC9C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,wCAAwC;IACxC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,oCAAoC;IACpC,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,eAAe,GACf,MAAM,GACN,WAAW,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/types/migration.js

@@ -0,0 +1,8 @@
+/**
+ * Migration types for Trellis update command
+ *
+ * These types support intelligent migration during updates,
+ * handling file renames, deletions, and user modification detection.
+ */
+export {};
+//# sourceMappingURL=migration.js.map

package/dist/types/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/types/migration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/compare-versions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Compare two semver versions (handles prerelease versions)
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ *
+ * Semver rules:
+ * - 0.3.0-beta.1 < 0.3.0 (prerelease is less than release)
+ * - 0.3.0-alpha < 0.3.0-beta (alphabetically)
+ * - 0.3.0-beta.1 < 0.3.0-beta.2 (numerically)
+ * - 0.3.0-beta.16 < 0.3.0-rc.0 (alphabetically: "beta" < "rc")
+ */
+export declare function compareVersions(a: string, b: string): number;
+//# sourceMappingURL=compare-versions.d.ts.map

package/dist/utils/compare-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-versions.d.ts","sourceRoot":"","sources":["../../src/utils/compare-versions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA8D5D"}

package/dist/utils/compare-versions.js

@@ -0,0 +1,76 @@
+/**
+ * Compare two semver versions (handles prerelease versions)
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ *
+ * Semver rules:
+ * - 0.3.0-beta.1 < 0.3.0 (prerelease is less than release)
+ * - 0.3.0-alpha < 0.3.0-beta (alphabetically)
+ * - 0.3.0-beta.1 < 0.3.0-beta.2 (numerically)
+ * - 0.3.0-beta.16 < 0.3.0-rc.0 (alphabetically: "beta" < "rc")
+ */
+export function compareVersions(a, b) {
+    // Split into base version and prerelease parts
+    const [aBase, aPrerelease] = a.split("-", 2);
+    const [bBase, bPrerelease] = b.split("-", 2);
+    // Parse base version (only numeric parts before any hyphen)
+    const parseBase = (v) => v.split(".").map((n) => parseInt(n, 10) || 0);
+    const aBaseParts = parseBase(aBase);
+    const bBaseParts = parseBase(bBase);
+    const maxBaseLen = Math.max(aBaseParts.length, bBaseParts.length);
+    // Compare base versions first
+    for (let i = 0; i < maxBaseLen; i++) {
+        const aVal = aBaseParts[i] ?? 0;
+        const bVal = bBaseParts[i] ?? 0;
+        if (aVal < bVal)
+            return -1;
+        if (aVal > bVal)
+            return 1;
+    }
+    // Base versions are equal, compare prerelease
+    // No prerelease > prerelease (1.0.0 > 1.0.0-beta)
+    if (!aPrerelease && bPrerelease)
+        return 1;
+    if (aPrerelease && !bPrerelease)
+        return -1;
+    if (!aPrerelease && !bPrerelease)
+        return 0;
+    // Both have prerelease, compare them (guaranteed non-null by checks above)
+    // Split prerelease by dots and compare each part
+    const aPre = aPrerelease.split(".");
+    const bPre = bPrerelease.split(".");
+    const maxPreLen = Math.max(aPre.length, bPre.length);
+    for (let i = 0; i < maxPreLen; i++) {
+        const aP = aPre[i];
+        const bP = bPre[i];
+        // Missing part means shorter prerelease comes first
+        if (aP === undefined)
+            return -1;
+        if (bP === undefined)
+            return 1;
+        // Try numeric comparison first
+        const aNum = parseInt(aP, 10);
+        const bNum = parseInt(bP, 10);
+        const aIsNum = !isNaN(aNum) && String(aNum) === aP;
+        const bIsNum = !isNaN(bNum) && String(bNum) === bP;
+        // Numeric identifiers have lower precedence than string identifiers
+        if (aIsNum && !bIsNum)
+            return -1;
+        if (!aIsNum && bIsNum)
+            return 1;
+        if (aIsNum && bIsNum) {
+            if (aNum < bNum)
+                return -1;
+            if (aNum > bNum)
+                return 1;
+        }
+        else {
+            // String comparison
+            if (aP < bP)
+                return -1;
+            if (aP > bP)
+                return 1;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=compare-versions.js.map

package/dist/utils/compare-versions.js.map

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

package/dist/utils/file-writer.d.ts

@@ -0,0 +1,23 @@
+export type WriteMode = "ask" | "force" | "skip" | "append";
+export interface WriteOptions {
+    mode: WriteMode;
+}
+export declare function setWriteMode(mode: WriteMode): void;
+export declare function getWriteMode(): WriteMode;
+/**
+ * Write file with conflict handling
+ * - If file doesn't exist: write directly
+ * - If file exists and content is identical: skip silently
+ * - If file exists and mode is 'force': overwrite
+ * - If file exists and mode is 'skip': skip
+ * - If file exists and mode is 'append': append to end
+ * - If file exists and mode is 'ask': prompt user
+ */
+export declare function writeFile(filePath: string, content: string, options?: {
+    executable?: boolean;
+}): Promise<boolean>;
+/**
+ * Ensure directory exists
+ */
+export declare function ensureDir(dirPath: string): void;
+//# sourceMappingURL=file-writer.d.ts.map

package/dist/utils/file-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer.d.ts","sourceRoot":"","sources":["../../src/utils/file-writer.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;CACjB;AASD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC;AA6BD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAwGlB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/utils/file-writer.js

@@ -0,0 +1,140 @@
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import inquirer from "inquirer";
+// Global write mode (set from CLI options)
+let globalWriteMode = "ask";
+export function setWriteMode(mode) {
+    globalWriteMode = mode;
+}
+export function getWriteMode() {
+    return globalWriteMode;
+}
+/**
+ * Get relative path from cwd for display
+ */
+function getRelativePath(filePath) {
+    const cwd = process.cwd();
+    const relativePath = path.relative(cwd, filePath);
+    return relativePath || path.basename(filePath);
+}
+/**
+ * Append content to file
+ */
+function appendToFile(filePath, content, options) {
+    const existingContent = fs.readFileSync(filePath, "utf-8");
+    const newContent = existingContent.endsWith("\n")
+        ? existingContent + content
+        : existingContent + "\n" + content;
+    fs.writeFileSync(filePath, newContent);
+    if (options?.executable) {
+        fs.chmodSync(filePath, "755");
+    }
+}
+/**
+ * Write file with conflict handling
+ * - If file doesn't exist: write directly
+ * - If file exists and content is identical: skip silently
+ * - If file exists and mode is 'force': overwrite
+ * - If file exists and mode is 'skip': skip
+ * - If file exists and mode is 'append': append to end
+ * - If file exists and mode is 'ask': prompt user
+ */
+export async function writeFile(filePath, content, options) {
+    const exists = fs.existsSync(filePath);
+    const displayPath = getRelativePath(filePath);
+    if (!exists) {
+        // File doesn't exist, write directly
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        return true;
+    }
+    // File exists, check if content is identical
+    const existingContent = fs.readFileSync(filePath, "utf-8");
+    if (existingContent === content) {
+        // Content identical, skip silently (no output)
+        return false;
+    }
+    // File exists with different content, handle based on mode
+    const mode = globalWriteMode;
+    if (mode === "force") {
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        console.log(chalk.yellow(`  ↻ Overwritten: ${displayPath}`));
+        return true;
+    }
+    if (mode === "skip") {
+        console.log(chalk.gray(`  ○ Skipped: ${displayPath} (already exists)`));
+        return false;
+    }
+    if (mode === "append") {
+        appendToFile(filePath, content, options);
+        console.log(chalk.blue(`  + Appended: ${displayPath}`));
+        return true;
+    }
+    // mode === 'ask': Interactive prompt
+    const { action } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "action",
+            message: `File "${displayPath}" already exists. What would you like to do?`,
+            choices: [
+                { name: "Skip (keep existing)", value: "skip" },
+                { name: "Overwrite", value: "overwrite" },
+                { name: "Append to end", value: "append" },
+                { name: "Skip all remaining conflicts", value: "skip-all" },
+                { name: "Overwrite all remaining conflicts", value: "overwrite-all" },
+                { name: "Append all remaining conflicts", value: "append-all" },
+            ],
+        },
+    ]);
+    if (action === "skip") {
+        console.log(chalk.gray(`  ○ Skipped: ${displayPath}`));
+        return false;
+    }
+    if (action === "overwrite") {
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        console.log(chalk.yellow(`  ↻ Overwritten: ${displayPath}`));
+        return true;
+    }
+    if (action === "append") {
+        appendToFile(filePath, content, options);
+        console.log(chalk.blue(`  + Appended: ${displayPath}`));
+        return true;
+    }
+    if (action === "skip-all") {
+        globalWriteMode = "skip";
+        console.log(chalk.gray(`  ○ Skipped: ${displayPath}`));
+        return false;
+    }
+    if (action === "overwrite-all") {
+        globalWriteMode = "force";
+        fs.writeFileSync(filePath, content);
+        if (options?.executable) {
+            fs.chmodSync(filePath, "755");
+        }
+        console.log(chalk.yellow(`  ↻ Overwritten: ${displayPath}`));
+        return true;
+    }
+    if (action === "append-all") {
+        globalWriteMode = "append";
+        appendToFile(filePath, content, options);
+        console.log(chalk.blue(`  + Appended: ${displayPath}`));
+        return true;
+    }
+    return false;
+}
+/**
+ * Ensure directory exists
+ */
+export function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+//# sourceMappingURL=file-writer.js.map

package/dist/utils/file-writer.js.map

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

package/dist/utils/project-detector.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Project type detected by analyzing project files
+ */
+export type ProjectType = "frontend" | "backend" | "fullstack" | "unknown";
+/**
+ * Detect project type by analyzing project files
+ *
+ * @param cwd - Current working directory to analyze
+ * @returns Detected project type
+ */
+export declare function detectProjectType(cwd: string): ProjectType;
+/**
+ * Get human-readable description of project type
+ */
+export declare function getProjectTypeDescription(type: ProjectType): string;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/utils/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAiK3E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAqB1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAWnE"}