@blulotus/trellis 0.7.0

package/dist/types/ai-tools.js

@@ -0,0 +1,509 @@
+/**
+ * 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,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "claude",
+        },
+    },
+    cursor: {
+        name: "Cursor",
+        templateDirs: ["common", "cursor"],
+        configDir: ".cursor",
+        cliFlag: "cursor",
+        defaultChecked: true,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "cursor",
+        },
+    },
+    opencode: {
+        name: "OpenCode",
+        templateDirs: ["common", "opencode"],
+        configDir: ".opencode",
+        cliFlag: "opencode",
+        defaultChecked: false,
+        // hasHooks: false — OpenCode has no session-start hook. The pre-v0.5.0
+        // `.opencode/commands/trellis/start.md` deprecation in
+        // migrations/manifests/0.5.0-beta.0.json assumed a hook would replace it;
+        // that never happened for OpenCode, so `resolveCommands`/`filterCommands`
+        // (see configurators/shared.ts) still generate `/start` as the live
+        // fallback command for this `agentCapable && !hasHooks` platform.
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: false,
+            cliFlag: "opencode",
+        },
+    },
+    codex: {
+        name: "Codex (also writes .agents/skills/ — read by Cursor, Gemini CLI, GitHub Copilot, Amp, Kimi Code)",
+        templateDirs: ["common", "codex"],
+        configDir: ".codex",
+        supportsAgentSkills: true,
+        cliFlag: "codex",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "$",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: false,
+            cliFlag: "codex",
+        },
+    },
+    kilo: {
+        name: "Kilo CLI",
+        templateDirs: ["common", "kilo"],
+        configDir: ".kilocode",
+        cliFlag: "kilo",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or file reads",
+            userActionLabel: "Workflows",
+            agentCapable: false,
+            hasHooks: false,
+            cliFlag: "kilo",
+        },
+    },
+    kiro: {
+        name: "Kiro Code",
+        templateDirs: ["common", "kiro"],
+        configDir: ".kiro/skills",
+        extraManagedPaths: [".kiro/agents", ".kiro/hooks"],
+        cliFlag: "kiro",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "$",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "kiro",
+        },
+    },
+    gemini: {
+        name: "Gemini CLI",
+        templateDirs: ["common", "gemini"],
+        configDir: ".gemini",
+        supportsAgentSkills: true,
+        cliFlag: "gemini",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "gemini",
+        },
+    },
+    antigravity: {
+        name: "Antigravity",
+        templateDirs: ["common", "antigravity"],
+        configDir: ".agent/workflows",
+        extraManagedPaths: [".agent/skills"],
+        cliFlag: "antigravity",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/",
+            executorAI: "Bash scripts or file reads",
+            userActionLabel: "Workflows",
+            agentCapable: false,
+            hasHooks: false,
+            cliFlag: "antigravity",
+        },
+    },
+    devin: {
+        name: "Devin",
+        templateDirs: ["common", "devin"],
+        configDir: ".devin/workflows",
+        extraManagedPaths: [".devin/skills"],
+        cliFlag: "devin",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or file reads",
+            userActionLabel: "Workflows",
+            agentCapable: false,
+            hasHooks: false,
+            cliFlag: "devin",
+        },
+    },
+    qoder: {
+        name: "Qoder",
+        templateDirs: ["common", "qoder"],
+        configDir: ".qoder",
+        cliFlag: "qoder",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "$",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "qoder",
+        },
+    },
+    codebuddy: {
+        name: "CodeBuddy",
+        templateDirs: ["common", "codebuddy"],
+        configDir: ".codebuddy",
+        cliFlag: "codebuddy",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "codebuddy",
+        },
+    },
+    copilot: {
+        name: "GitHub Copilot",
+        templateDirs: ["common", "copilot"],
+        configDir: ".github/copilot",
+        extraManagedPaths: [
+            ".github/agents",
+            ".github/copilot-instructions.md",
+            ".github/hooks",
+            ".github/prompts",
+            ".github/skills",
+        ],
+        cliFlag: "copilot",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Prompts",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "copilot",
+        },
+    },
+    droid: {
+        name: "Factory Droid",
+        templateDirs: ["common", "droid"],
+        configDir: ".factory",
+        cliFlag: "droid",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "droid",
+        },
+    },
+    /**
+     * DeepSeek Harness (dsh) — class-2 pull-based platform.
+     *
+     * DSH discovers skills from `<projectRoot>/.agents/skills/` (shared root,
+     * rank 200) and `<projectRoot>/.dsh/skills/` (DSH-private root, rank 100),
+     * plus user roots under `$DSH_HOME/skills` / `$DSH_AGENTS_HOME/skills`.
+     * SKILL.md frontmatter uses `name` (kebab-case) + `description`, matching
+     * Trellis's skill rendering. The model loads skills via the `skill` tool;
+     * users can load entry points by their `trellis-<name>` skill names. DSH
+     * surfaces that expose the slash pipeline may also accept `/trellis-<name>`.
+     *
+     * DSH injects project `AGENTS.md` at session start (workspace instructions)
+     * and supports isolated sub-agents through the `subagent` tool, so Trellis
+     * ships as class-2: workflow/bundled skills go to the shared `.agents/skills/`
+     * root via the neutral resolver (byte-identical to Codex/Gemini/Pi/Kimi
+     * writes), while DSH-private entry points (trellis-start / trellis-continue /
+     * trellis-finish-work) and collision-free role skills
+     * (trellis-agent-implement / trellis-agent-check / trellis-agent-research)
+     * live under `.dsh/skills/` with the pull-based prelude on implement/check.
+     *
+     * DSH has no project-level hooks/settings file Trellis may write, so
+     * hasHooks/hasPythonHooks stay false and no hook assets are emitted.
+     */
+    dsh: {
+        name: "DeepSeek Harness (dsh)",
+        templateDirs: ["common", "dsh"],
+        configDir: ".dsh",
+        supportsAgentSkills: true,
+        cliFlag: "dsh",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "trellis-",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: false,
+            cliFlag: "dsh",
+        },
+    },
+    pi: {
+        // Pi also writes .agents/skills/, which is read by Cursor, Gemini CLI,
+        // GitHub Copilot, Amp, and Kimi Code. Keep that detail here rather than
+        // in `name` — `name` leaks verbatim into `trellis platforms` output and
+        // init checkboxes, where a long parenthetical reads badly.
+        name: "Pi Agent",
+        templateDirs: ["common", "pi"],
+        configDir: ".pi",
+        supportsAgentSkills: true,
+        cliFlag: "pi",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "pi",
+        },
+    },
+    reasonix: {
+        name: "Reasonix",
+        templateDirs: ["common", "reasonix"],
+        configDir: ".reasonix",
+        cliFlag: "reasonix",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/skill trellis-",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: false,
+            cliFlag: "reasonix",
+        },
+    },
+    zcode: {
+        name: "ZCode",
+        templateDirs: ["common", "zcode"],
+        configDir: ".zcode",
+        // `.zcode/cli/agents` is the pre-ZCode-update discovery path. Kept managed
+        // during the transition so `trellis update --migrate` (rename-dir →
+        // `.zcode/agents/`) and `trellis uninstall` can clean up the now-empty
+        // `.zcode/cli/` parent. Drop this entry once the migration has shipped and
+        // no project still holds the legacy dir. Only empty dirs are ever removed,
+        // so user files are never touched (see cleanupEmptyDirs in update.ts).
+        extraManagedPaths: [
+            ".zcode/cli/agents",
+            ".zcode/agents",
+            ".zcode/commands",
+            ".zcode/skills",
+            // Hooks assets written by configureZcode.
+            ".zcode/hooks",
+        ],
+        cliFlag: "zcode",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or Agent calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            // ZCode (3.x) supports a workspace hook config at .zcode/config.json
+            // with SessionStart / UserPromptSubmit / PreToolUse events. PreToolUse
+            // can mutate sub-agent prompts, so ZCode is class-1 hook-inject.
+            hasHooks: true,
+            cliFlag: "zcode",
+        },
+    },
+    trae: {
+        name: "Trae",
+        templateDirs: ["common", "trae"],
+        configDir: ".trae",
+        cliFlag: "trae",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or tool calls",
+            userActionLabel: "Commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "trae",
+        },
+    },
+    omp: {
+        name: "Oh My Pi",
+        templateDirs: ["common", "omp"],
+        configDir: ".omp",
+        cliFlag: "omp",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/trellis:",
+            executorAI: "Bash scripts or Task calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "omp",
+        },
+    },
+    /**
+     * Grok Build (xAI) — class-2 pull-based platform.
+     *
+     * Phase 0 verified (Grok 0.2.101): skills/agents/AGENTS.md load correctly;
+     * Claude-style hook `additionalContext` is NOT injected into the model.
+     * Do not set hasHooks/hasPythonHooks true until Grok consumes hook stdout.
+     * Commands are flat under `.grok/commands/trellis-*.md` (Grok slash-command layout).
+     */
+    grok: {
+        name: "Grok Build",
+        templateDirs: ["common", "grok"],
+        configDir: ".grok",
+        extraManagedPaths: [".grok/skills", ".grok/commands", ".grok/agents"],
+        cliFlag: "grok",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or Agent calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: false,
+            cliFlag: "grok",
+        },
+    },
+    /**
+     * Kimi Code CLI — class-2 pull-based platform.
+     *
+     * Kimi reads project skills from `.kimi-code/skills/` AND the shared
+     * `.agents/skills/` (agentskills.io standard), so workflow/bundled skills go
+     * to the shared root via the neutral resolver (byte-identical to
+     * Codex/Gemini/Pi writes) while user-invocable entry points
+     * (`trellis-start` / `trellis-continue` / `trellis-finish-work`, invoked as
+     * `/skill:trellis-<name>`) and the Trellis sub-agent prompts live under
+     * `.kimi-code/skills/`.
+     *
+     * Kimi has no project-level hooks/settings file Trellis may write (hooks are
+     * user-level `~/.kimi-code/config.toml` only) and no project-level custom
+     * sub-agent definitions (only the built-in coder/explore/plan sub-agents), so
+     * the Trellis agent prompts ship as skills with the pull-based prelude.
+     */
+    kimi: {
+        name: "Kimi Code",
+        templateDirs: ["common", "kimi"],
+        configDir: ".kimi-code",
+        supportsAgentSkills: true,
+        cliFlag: "kimi",
+        defaultChecked: false,
+        hasPythonHooks: false,
+        templateContext: {
+            cmdRefPrefix: "/skill:trellis-",
+            executorAI: "Bash scripts or Agent calls",
+            userActionLabel: "Slash commands",
+            agentCapable: true,
+            hasHooks: false,
+            cliFlag: "kimi",
+        },
+    },
+    /**
+     * Snow CLI - class-1 platform.
+     *
+     * Skills: `.snow/skills/` (Claude Code Skills compatible)
+     * Commands: `.snow/commands/trellis-*.json` (type: prompt)
+     * Agents: `.snow/agents/` (project discovery; no class-2 pull prelude)
+     * Hooks: `.snow/hooks/` emit additionalContext JSON (session/user/sub-agent)
+     *
+     * hasHooks=true: SessionStart injects context -> trellis-start is filtered out.
+     * hasPythonHooks=true: ships write-trellis-context.py under .snow/hooks/.
+     * Primary agent path is `.snow/agents/*.md` only (no legacy JSON fragment).
+     *
+     * CLI flag: `--snow`.
+     * Detection requires Trellis-owned template hashes under `.snow/skills`, so
+     * native Snow settings, commands, agents, or skills are not false positives.
+     */
+    snow: {
+        name: "Snow CLI",
+        templateDirs: ["common", "snow"],
+        configDir: ".snow/skills",
+        extraManagedPaths: [
+            ".snow/commands",
+            ".snow/agents",
+            ".snow/hooks",
+            ".snow/SNOW.md",
+        ],
+        cliFlag: "snow",
+        defaultChecked: false,
+        hasPythonHooks: true,
+        templateContext: {
+            cmdRefPrefix: "/trellis-",
+            executorAI: "Bash scripts or Agent calls",
+            userActionLabel: "Skills",
+            agentCapable: true,
+            hasHooks: true,
+            cliFlag: "snow",
+        },
+    },
+};
+/**
+ * Get the configuration for a specific AI tool
+ */
+export function getToolConfig(tool) {
+    return AI_TOOLS[tool];
+}
+/**
+ * Get all managed paths for a specific tool.
+ */
+export function getManagedPaths(tool) {
+    const config = AI_TOOLS[tool];
+    const paths = [config.configDir];
+    if (config.supportsAgentSkills) {
+        paths.push(".agents/skills");
+    }
+    if (config.extraManagedPaths) {
+        paths.push(...config.extraManagedPaths);
+    }
+    return paths;
+}
+/**
+ * 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":"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"}

package/dist/types/migration.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 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" | "safe-file-delete";
+    /** Source path (relative to project root) */
+    from: string;
+    /** Target path for renames (relative to project root) */
+    to?: string;
+    /** Human-readable description of WHAT this migration does */
+    description?: string;
+    /**
+     * Optional context shown in the "confirm" prompt explaining WHY the user is
+     * being asked about this specific file. Use this for version-specific nuance
+     * (e.g. a known hash-tracking gap from a prior CLI version) that would
+     * otherwise have to be hardcoded in update.ts. Keep it short (1-2 sentences).
+     */
+    reason?: string;
+    /** Known template hashes for safe-file-delete (only delete if content matches) */
+    allowed_hashes?: string[];
+}
+/**
+ * A new top-level config.yaml section introduced by this release.
+ *
+ * Used by `trellis update` to append the section to existing user config files
+ * that pre-date the release, without overwriting their other customizations.
+ * Append is gated on `sentinel`: if the user file already contains the sentinel
+ * substring (live or commented), the section is treated as already present.
+ */
+export interface ConfigSectionAdded {
+    /** Target file relative to project root (e.g. `.trellis/config.yaml`). */
+    file: string;
+    /**
+     * Substring whose presence in the user file means this section already
+     * exists. Pick something stable (e.g. the new top-level YAML key like
+     * `codex:`).
+     */
+    sentinel: string;
+    /**
+     * The section heading text that appears on the `# <heading>` line inside the
+     * `#---` separator block in the bundled template. The extractor takes lines
+     * from that separator block until the next `#---` separator (or EOF).
+     */
+    sectionHeading: 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;
+    /**
+     * New top-level config.yaml sections introduced by this release. Applied
+     * additively to existing user files via sentinel-gated append, keeping their
+     * customizations intact while still surfacing newly-introduced knobs.
+     */
+    configSectionsAdded?: ConfigSectionAdded[];
+}
+/**
+ * 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,GAAG,kBAAkB,CAAC;IAC9D,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;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;IACxB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC5C;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"}