devflow-kit 1.8.3 → 2.0.0

package/dist/utils/paths.d.ts

@@ -1,42 +0,0 @@
-/**
- * Get the OS-specific path for Claude Code managed settings.
- * Managed settings have highest precedence and cannot be overridden by users.
- * - macOS: /Library/Application Support/ClaudeCode/managed-settings.json
- * - Linux: /etc/claude-code/managed-settings.json
- *
- * @throws {Error} On unsupported platforms (Windows)
- */
-export declare function getManagedSettingsPath(): string;
-/**
- * Get home directory with proper fallback and validation
- * Priority: process.env.HOME > os.homedir()
- *
- * @throws {Error} If unable to determine home directory
- */
-export declare function getHomeDirectory(): string;
-/**
- * Get Claude Code directory with environment variable override support
- * Priority: CLAUDE_CODE_DIR env var > ~/.claude
- *
- * @throws {Error} If CLAUDE_CODE_DIR is invalid (not absolute, outside home)
- */
-export declare function getClaudeDirectory(): string;
-/**
- * Get DevFlow directory with environment variable override support
- * Priority: DEVFLOW_DIR env var > ~/.devflow
- *
- * @throws {Error} If DEVFLOW_DIR is invalid (not absolute, outside home)
- */
-export declare function getDevFlowDirectory(): string;
-/**
- * Get installation paths based on scope (async, non-blocking)
- * @param scope - 'user' or 'local'
- * @returns Object with claudeDir and devflowDir
- * @throws {Error} If local scope selected but not in a git repository
- */
-export declare function getInstallationPaths(scope: 'user' | 'local'): Promise<{
-    claudeDir: string;
-    devflowDir: string;
-    gitRoot: string | null;
-}>;
-//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.js

@@ -1,106 +0,0 @@
-import { homedir, platform } from 'os';
-import * as path from 'path';
-import { getGitRoot } from './git.js';
-/**
- * Get the OS-specific path for Claude Code managed settings.
- * Managed settings have highest precedence and cannot be overridden by users.
- * - macOS: /Library/Application Support/ClaudeCode/managed-settings.json
- * - Linux: /etc/claude-code/managed-settings.json
- *
- * @throws {Error} On unsupported platforms (Windows)
- */
-export function getManagedSettingsPath() {
-    const os = platform();
-    if (os === 'darwin') {
-        return '/Library/Application Support/ClaudeCode/managed-settings.json';
-    }
-    if (os === 'linux') {
-        return '/etc/claude-code/managed-settings.json';
-    }
-    throw new Error(`Managed settings not supported on platform: ${os}`);
-}
-/**
- * Get home directory with proper fallback and validation
- * Priority: process.env.HOME > os.homedir()
- *
- * @throws {Error} If unable to determine home directory
- */
-export function getHomeDirectory() {
-    const home = process.env.HOME || homedir();
-    if (!home) {
-        throw new Error('Unable to determine home directory. Set HOME environment variable.');
-    }
-    return home;
-}
-/**
- * Get Claude Code directory with environment variable override support
- * Priority: CLAUDE_CODE_DIR env var > ~/.claude
- *
- * @throws {Error} If CLAUDE_CODE_DIR is invalid (not absolute, outside home)
- */
-export function getClaudeDirectory() {
-    if (process.env.CLAUDE_CODE_DIR) {
-        const customDir = process.env.CLAUDE_CODE_DIR;
-        // Validate path is absolute
-        if (!path.isAbsolute(customDir)) {
-            throw new Error('CLAUDE_CODE_DIR must be an absolute path');
-        }
-        // Warn if outside home directory (security best practice)
-        const home = getHomeDirectory();
-        if (!customDir.startsWith(home)) {
-            console.warn('⚠️  CLAUDE_CODE_DIR is outside home directory. Ensure this is intentional.');
-        }
-        return customDir;
-    }
-    return path.join(getHomeDirectory(), '.claude');
-}
-/**
- * Get DevFlow directory with environment variable override support
- * Priority: DEVFLOW_DIR env var > ~/.devflow
- *
- * @throws {Error} If DEVFLOW_DIR is invalid (not absolute, outside home)
- */
-export function getDevFlowDirectory() {
-    if (process.env.DEVFLOW_DIR) {
-        const customDir = process.env.DEVFLOW_DIR;
-        // Validate path is absolute
-        if (!path.isAbsolute(customDir)) {
-            throw new Error('DEVFLOW_DIR must be an absolute path');
-        }
-        // Warn if outside home directory (security best practice)
-        const home = getHomeDirectory();
-        if (!customDir.startsWith(home)) {
-            console.warn('⚠️  DEVFLOW_DIR is outside home directory. Ensure this is intentional.');
-        }
-        return customDir;
-    }
-    return path.join(getHomeDirectory(), '.devflow');
-}
-/**
- * Get installation paths based on scope (async, non-blocking)
- * @param scope - 'user' or 'local'
- * @returns Object with claudeDir and devflowDir
- * @throws {Error} If local scope selected but not in a git repository
- */
-export async function getInstallationPaths(scope) {
-    if (scope === 'user') {
-        return {
-            claudeDir: getClaudeDirectory(),
-            devflowDir: getDevFlowDirectory(),
-            gitRoot: null,
-        };
-    }
-    else {
-        // Local scope - install to git repository root
-        const gitRoot = await getGitRoot();
-        if (!gitRoot) {
-            throw new Error('Local scope requires a git repository. Run "git init" first or use --scope user');
-        }
-        return {
-            claudeDir: path.join(gitRoot, '.claude'),
-            devflowDir: path.join(gitRoot, '.devflow'),
-            gitRoot,
-        };
-    }
-}
-//# sourceMappingURL=paths.js.map

package/dist/utils/post-install.d.ts

@@ -1,87 +0,0 @@
-/**
- * Replace ${DEVFLOW_DIR} placeholders in a settings template.
- */
-export declare function substituteSettingsTemplate(template: string, devflowDir: string): string;
-/**
- * Add Agent Teams configuration to settings JSON.
- * Sets teammateMode and CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var.
- */
-export declare function applyTeamsConfig(settingsJson: string): string;
-/**
- * Remove Agent Teams configuration from settings JSON.
- * Strips teammateMode and CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS env var.
- */
-export declare function stripTeamsConfig(settingsJson: string): string;
-/**
- * Compute which entries need appending to a .gitignore file.
- * Returns only entries not already present.
- */
-export declare function computeGitignoreAppend(existingContent: string, entries: string[]): string[];
-/**
- * Merge DevFlow deny entries into an existing managed settings object.
- * Preserves existing entries, deduplicates, and returns the merged JSON string.
- */
-export declare function mergeDenyList(existingJson: string, newDenyEntries: string[]): string;
-/**
- * Attempt to install managed settings (security deny list) to the system path.
- * Managed settings have highest precedence in Claude Code and cannot be overridden.
- *
- * Strategy:
- * 1. Try direct write (works if running as root or directory is writable)
- * 2. If EACCES in TTY, retry with sudo (caller is responsible for obtaining consent)
- * 3. Returns true if managed settings were written, false if caller should fall back
- */
-export declare function installManagedSettings(rootDir: string, verbose: boolean): Promise<boolean>;
-/**
- * Remove DevFlow deny entries from managed settings.
- * If only DevFlow entries remain, deletes the file entirely.
- *
- * Mirrors installManagedSettings strategy:
- * 1. Try direct write/delete
- * 2. If EACCES and TTY, ask user before sudo
- * 3. Non-TTY: return false (caller logs preservation message)
- */
-export declare function removeManagedSettings(rootDir: string, verbose: boolean): Promise<boolean>;
-export type SecurityMode = 'managed' | 'user';
-/**
- * Install or update settings.json with DevFlow configuration.
- * Prompts interactively in TTY mode when settings already exist.
- * In non-TTY mode, skips override (safe default).
- *
- * When securityMode is 'managed', the deny list goes to system-level managed
- * settings and is excluded from user settings.json. When 'user', the deny list
- * is included in settings.json (original behavior).
- */
-export declare function installSettings(claudeDir: string, rootDir: string, devflowDir: string, verbose: boolean, teamsEnabled?: boolean, securityMode?: SecurityMode): Promise<void>;
-/**
- * Create .claudeignore in git repository root (skip if already exists).
- * Returns true if a new file was created, false if it already existed or on error.
- */
-export declare function installClaudeignore(gitRoot: string, rootDir: string, verbose: boolean): Promise<boolean>;
-/**
- * Discover git repository roots from Claude's project history.
- * Parses ~/.claude/history.jsonl for unique project paths that are valid git repos.
- * @param homeDir - Override home directory (dependency injection for tests)
- */
-export declare function discoverProjectGitRoots(homeDir?: string): Promise<string[]>;
-/**
- * Update .gitignore with DevFlow entries (for local scope installs).
- */
-export declare function updateGitignore(gitRoot: string, verbose: boolean): Promise<void>;
-/**
- * Create .docs/ directory structure for DevFlow artifacts.
- */
-export declare function createDocsStructure(verbose: boolean): Promise<void>;
-/**
- * Create .memory/ directory for working memory files.
- * Separate from .docs/ which is for reviews/releases.
- */
-export declare function createMemoryDir(verbose: boolean, cwd?: string): Promise<void>;
-/**
- * Migrate memory files from .docs/ to .memory/.
- * One-time migration for existing users. Skips if destination exists (no clobber).
- * Also cleans up ephemeral files from .docs/.
- * Returns count of migrated files.
- */
-export declare function migrateMemoryFiles(verbose: boolean, cwd?: string): Promise<number>;
-//# sourceMappingURL=post-install.d.ts.map