export interface ClaudeSkillShadow {
    skillName: string;
    globalPath: string;
    pluginPath: string;
    globalHash: string;
    pluginHash: string;
    isKnownDevFlowArtifact: boolean;
}
export interface ActivePluginInfo {
    root: string | null;
    version: string | null;
}
interface ActivePluginPaths {
    installedPluginsPath?: string;
    pluginCachePath?: string;
}
export interface LegacySkillBackup {
    skillName: string;
    originalPath: string;
    backupPath: string;
    hash: string;
    pluginHash: string;
    contentChanged: boolean;
    version: string;
}
/**
 * Locate plugin files directory.
 * Priority: bundled dist/plugin-files (npm) -> monorepo plugins/claude-code (dev)
 */
export declare function getPluginFilesDir(): string;
/** Resolve the installed DevFlow plugin only when its cache path is present. */
export declare function resolveActivePlugin(home?: string, paths?: ActivePluginPaths): ActivePluginInfo;
/** Find global Claude skills that collide with canonical DevFlow skills. */
export declare function scanClaudeSkillShadowing(home: string, pluginRoot: string): ClaudeSkillShadow[];
/** Back up unchanged legacy global skills without touching user-owned files. */
export declare function migrateLegacyClaudeSkills(home: string, pluginRoot: string, version: string, now?: () => number, options?: {
    includeModified?: boolean;
}): LegacySkillBackup[];
/**
 * Ensure the devflow plugin and its local marketplace are configured in
 * ~/.claude/settings.json. Existing unrelated settings are preserved.
 */
export declare function ensurePluginEnabled(settingsPath: string): void;
/**
 * Write .claude/mcp.json for the project.
 * Merges with existing config; does not overwrite user's custom servers.
 * Skips if devflow server already configured.
 */
export declare function writeMcpConfig(projectRoot: string, mcpCommand: string): void;
/**
 * Deploy plugin files and register the installation with Claude Code.
 * Global user skills are left untouched; Claude discovers skills from the plugin cache.
 */
export declare function deployPlugin(pluginFilesDir: string, cacheBaseDir: string, version: string): void;
export {};
//# sourceMappingURL=plugin-setup.d.ts.map