devflow-kit 1.8.3 → 2.0.1

package/dist/commands/list.d.ts

@@ -1,24 +0,0 @@
-import { Command } from 'commander';
-import { type ManifestData } from '../utils/manifest.js';
-/**
- * Format manifest feature flags into a human-readable comma-separated string.
- * Returns 'none' when no features are enabled.
- */
-export declare function formatFeatures(features: ManifestData['features']): string;
-/**
- * Determine effective installation scope based on which manifest was found.
- * Local scope takes precedence when a local manifest exists.
- */
-export declare function resolveScope(localManifest: ManifestData | null): 'user' | 'local';
-/**
- * Compute the install status indicator for a plugin.
- * Returns 'installed', 'not_installed', or 'unknown' (when no manifest exists).
- */
-export declare function getPluginInstallStatus(pluginName: string, installedPlugins: ReadonlySet<string>, hasManifest: boolean): 'installed' | 'not_installed' | 'unknown';
-/**
- * Format the commands portion of a plugin entry.
- * Returns the comma-separated command list or '(skills only)' for skill-only plugins.
- */
-export declare function formatPluginCommands(commands: string[]): string;
-export declare const listCommand: Command;
-//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.js

@@ -1,89 +0,0 @@
-import { Command } from 'commander';
-import * as p from '@clack/prompts';
-import color from 'picocolors';
-import { DEVFLOW_PLUGINS } from '../plugins.js';
-import { getDevFlowDirectory } from '../utils/paths.js';
-import { getGitRoot } from '../utils/git.js';
-import { readManifest } from '../utils/manifest.js';
-import * as path from 'path';
-/**
- * Format manifest feature flags into a human-readable comma-separated string.
- * Returns 'none' when no features are enabled.
- */
-export function formatFeatures(features) {
-    return [
-        features.teams ? 'teams' : null,
-        features.ambient ? 'ambient' : null,
-        features.memory ? 'memory' : null,
-        features.hud ? 'hud' : null,
-    ].filter(Boolean).join(', ') || 'none';
-}
-/**
- * Determine effective installation scope based on which manifest was found.
- * Local scope takes precedence when a local manifest exists.
- */
-export function resolveScope(localManifest) {
-    return localManifest ? 'local' : 'user';
-}
-/**
- * Compute the install status indicator for a plugin.
- * Returns 'installed', 'not_installed', or 'unknown' (when no manifest exists).
- */
-export function getPluginInstallStatus(pluginName, installedPlugins, hasManifest) {
-    if (!hasManifest)
-        return 'unknown';
-    return installedPlugins.has(pluginName) ? 'installed' : 'not_installed';
-}
-/**
- * Format the commands portion of a plugin entry.
- * Returns the comma-separated command list or '(skills only)' for skill-only plugins.
- */
-export function formatPluginCommands(commands) {
-    return commands.length > 0 ? commands.join(', ') : '(skills only)';
-}
-export const listCommand = new Command('list')
-    .description('List available DevFlow plugins')
-    .action(async () => {
-    p.intro(color.bgCyan(color.black(' DevFlow Plugins ')));
-    // Resolve user manifest and git root in parallel (independent I/O)
-    const userDevflowDir = getDevFlowDirectory();
-    const [gitRoot, userManifest] = await Promise.all([
-        getGitRoot(),
-        readManifest(userDevflowDir),
-    ]);
-    const localDevflowDir = gitRoot ? path.join(gitRoot, '.devflow') : null;
-    const localManifest = localDevflowDir ? await readManifest(localDevflowDir) : null;
-    const manifest = localManifest ?? userManifest;
-    // Show install status if manifest exists
-    if (manifest) {
-        const installedAt = new Date(manifest.installedAt).toLocaleDateString();
-        const updatedAt = new Date(manifest.updatedAt).toLocaleDateString();
-        const scope = resolveScope(localManifest);
-        const features = formatFeatures(manifest.features);
-        p.note(`${color.dim('Version:')}  ${color.cyan(`v${manifest.version}`)}\n` +
-            `${color.dim('Scope:')}    ${scope}\n` +
-            `${color.dim('Features:')} ${features}\n` +
-            `${color.dim('Installed:')} ${installedAt}` +
-            (installedAt !== updatedAt ? `  ${color.dim('Updated:')} ${updatedAt}` : ''), 'Installation');
-    }
-    const installedPlugins = new Set(manifest?.plugins ?? []);
-    const hasManifest = manifest !== null;
-    const maxNameLen = Math.max(...DEVFLOW_PLUGINS.map(p => p.name.length));
-    const pluginList = DEVFLOW_PLUGINS
-        .map(plugin => {
-        const cmds = formatPluginCommands(plugin.commands);
-        const optionalTag = plugin.optional ? color.dim(' (optional)') : '';
-        const status = getPluginInstallStatus(plugin.name, installedPlugins, hasManifest);
-        const installedTag = status === 'installed' ? color.green(' ✓')
-            : status === 'not_installed' ? color.dim(' ✗')
-                : '';
-        return `${color.cyan(plugin.name.padEnd(maxNameLen + 2))}${color.dim(plugin.description)}${optionalTag}${installedTag}\n${' '.repeat(maxNameLen + 2)}${color.yellow(cmds)}`;
-    })
-        .join('\n\n');
-    p.note(pluginList, 'Available plugins');
-    if (!manifest) {
-        p.log.info(color.dim('Run `devflow init` for install tracking'));
-    }
-    p.outro(color.dim('Install with: npx devflow-kit init --plugin=<name>'));
-});
-//# sourceMappingURL=list.js.map

package/dist/commands/memory.d.ts

@@ -1,22 +0,0 @@
-import { Command } from 'commander';
-/**
- * Add all 3 memory hooks (Stop, SessionStart, PreCompact) to settings JSON.
- * Idempotent — skips hooks that already exist. Returns unchanged JSON if all 3 present.
- */
-export declare function addMemoryHooks(settingsJson: string, devflowDir: string): string;
-/**
- * Remove all memory hooks (Stop, SessionStart, PreCompact) from settings JSON.
- * Idempotent — returns unchanged JSON if no memory hooks present.
- * Preserves non-memory hooks. Cleans empty arrays/objects.
- */
-export declare function removeMemoryHooks(settingsJson: string): string;
-/**
- * Check if ALL 3 memory hooks are registered in settings JSON.
- */
-export declare function hasMemoryHooks(settingsJson: string): boolean;
-/**
- * Count how many of the 3 memory hooks are present (0-3).
- */
-export declare function countMemoryHooks(settingsJson: string): number;
-export declare const memoryCommand: Command;
-//# sourceMappingURL=memory.d.ts.map

package/dist/commands/memory.js

@@ -1,175 +0,0 @@
-import { Command } from 'commander';
-import { promises as fs } from 'fs';
-import * as path from 'path';
-import * as p from '@clack/prompts';
-import color from 'picocolors';
-import { getClaudeDirectory, getDevFlowDirectory } from '../utils/paths.js';
-import { createMemoryDir, migrateMemoryFiles } from '../utils/post-install.js';
-/**
- * Map of hook event type → filename marker for the 3 memory hooks.
- */
-const MEMORY_HOOK_CONFIG = {
-    Stop: 'stop-update-memory',
-    SessionStart: 'session-start-memory',
-    PreCompact: 'pre-compact-memory',
-};
-/**
- * Add all 3 memory hooks (Stop, SessionStart, PreCompact) to settings JSON.
- * Idempotent — skips hooks that already exist. Returns unchanged JSON if all 3 present.
- */
-export function addMemoryHooks(settingsJson, devflowDir) {
-    const settings = JSON.parse(settingsJson);
-    if (hasMemoryHooks(settingsJson)) {
-        return settingsJson;
-    }
-    if (!settings.hooks) {
-        settings.hooks = {};
-    }
-    let changed = false;
-    for (const [hookType, marker] of Object.entries(MEMORY_HOOK_CONFIG)) {
-        const existing = settings.hooks[hookType] ?? [];
-        const alreadyPresent = existing.some((matcher) => matcher.hooks.some((h) => h.command.includes(marker)));
-        if (!alreadyPresent) {
-            const hookCommand = path.join(devflowDir, 'scripts', 'hooks', 'run-hook') + ` ${marker}`;
-            const newEntry = {
-                hooks: [
-                    {
-                        type: 'command',
-                        command: hookCommand,
-                        timeout: 10,
-                    },
-                ],
-            };
-            if (!settings.hooks[hookType]) {
-                settings.hooks[hookType] = [];
-            }
-            settings.hooks[hookType].push(newEntry);
-            changed = true;
-        }
-    }
-    if (!changed) {
-        return settingsJson;
-    }
-    return JSON.stringify(settings, null, 2) + '\n';
-}
-/**
- * Remove all memory hooks (Stop, SessionStart, PreCompact) from settings JSON.
- * Idempotent — returns unchanged JSON if no memory hooks present.
- * Preserves non-memory hooks. Cleans empty arrays/objects.
- */
-export function removeMemoryHooks(settingsJson) {
-    const settings = JSON.parse(settingsJson);
-    if (!settings.hooks) {
-        return settingsJson;
-    }
-    let changed = false;
-    for (const [hookType, marker] of Object.entries(MEMORY_HOOK_CONFIG)) {
-        if (!settings.hooks[hookType]) {
-            continue;
-        }
-        const before = settings.hooks[hookType].length;
-        settings.hooks[hookType] = settings.hooks[hookType].filter((matcher) => !matcher.hooks.some((h) => h.command.includes(marker)));
-        if (settings.hooks[hookType].length !== before) {
-            changed = true;
-        }
-        if (settings.hooks[hookType].length === 0) {
-            delete settings.hooks[hookType];
-        }
-    }
-    if (settings.hooks && Object.keys(settings.hooks).length === 0) {
-        delete settings.hooks;
-    }
-    if (!changed) {
-        return settingsJson;
-    }
-    return JSON.stringify(settings, null, 2) + '\n';
-}
-/**
- * Check if ALL 3 memory hooks are registered in settings JSON.
- */
-export function hasMemoryHooks(settingsJson) {
-    return countMemoryHooks(settingsJson) === 3;
-}
-/**
- * Count how many of the 3 memory hooks are present (0-3).
- */
-export function countMemoryHooks(settingsJson) {
-    const settings = JSON.parse(settingsJson);
-    if (!settings.hooks) {
-        return 0;
-    }
-    let count = 0;
-    for (const [hookType, marker] of Object.entries(MEMORY_HOOK_CONFIG)) {
-        const matchers = settings.hooks[hookType] ?? [];
-        if (matchers.some((matcher) => matcher.hooks.some((h) => h.command.includes(marker)))) {
-            count++;
-        }
-    }
-    return count;
-}
-export const memoryCommand = new Command('memory')
-    .description('Enable or disable working memory (session context preservation)')
-    .option('--enable', 'Add Stop/SessionStart/PreCompact hooks')
-    .option('--disable', 'Remove memory hooks')
-    .option('--status', 'Show current state')
-    .action(async (options) => {
-    const hasFlag = options.enable || options.disable || options.status;
-    if (!hasFlag) {
-        p.intro(color.bgCyan(color.white(' Working Memory ')));
-        p.note(`${color.cyan('devflow memory --enable')}   Add memory hooks\n` +
-            `${color.cyan('devflow memory --disable')}  Remove memory hooks\n` +
-            `${color.cyan('devflow memory --status')}   Check current state`, 'Usage');
-        p.outro(color.dim('Memory hooks provide automatic session context preservation'));
-        return;
-    }
-    const claudeDir = getClaudeDirectory();
-    const settingsPath = path.join(claudeDir, 'settings.json');
-    let settingsContent;
-    try {
-        settingsContent = await fs.readFile(settingsPath, 'utf-8');
-    }
-    catch {
-        if (options.status) {
-            p.log.info('Working memory: disabled (no settings.json found)');
-            return;
-        }
-        // Create minimal settings.json
-        settingsContent = '{}';
-    }
-    if (options.status) {
-        const count = countMemoryHooks(settingsContent);
-        if (count === 3) {
-            p.log.info(`Working memory: ${color.green('enabled')} (3/3 hooks)`);
-        }
-        else if (count === 0) {
-            p.log.info(`Working memory: ${color.dim('disabled')}`);
-        }
-        else {
-            p.log.info(`Working memory: ${color.yellow(`partial (${count}/3 hooks)`)} — run --enable to fix`);
-        }
-        return;
-    }
-    const devflowDir = getDevFlowDirectory();
-    if (options.enable) {
-        const updated = addMemoryHooks(settingsContent, devflowDir);
-        if (updated === settingsContent) {
-            p.log.info('Working memory already enabled');
-            return;
-        }
-        await fs.writeFile(settingsPath, updated, 'utf-8');
-        await createMemoryDir(false);
-        await migrateMemoryFiles(true);
-        p.log.success('Working memory enabled — Stop/SessionStart/PreCompact hooks registered');
-        p.log.info(color.dim('Session context will be automatically preserved across conversations'));
-    }
-    if (options.disable) {
-        const updated = removeMemoryHooks(settingsContent);
-        if (updated === settingsContent) {
-            p.log.info('Working memory already disabled');
-            return;
-        }
-        await fs.writeFile(settingsPath, updated, 'utf-8');
-        p.log.success('Working memory disabled — hooks removed');
-    }
-});
-//# sourceMappingURL=memory.js.map

package/dist/commands/skills.d.ts

@@ -1,11 +0,0 @@
-import { Command } from 'commander';
-/**
- * Check if a skill has a shadow (personal override).
- */
-export declare function hasShadow(skillName: string, devflowDir?: string): Promise<boolean>;
-/**
- * List all shadowed skill names.
- */
-export declare function listShadowed(devflowDir?: string): Promise<string[]>;
-export declare const skillsCommand: Command;
-//# sourceMappingURL=skills.d.ts.map

package/dist/commands/skills.js

@@ -1,116 +0,0 @@
-import { Command } from 'commander';
-import { promises as fs } from 'fs';
-import * as path from 'path';
-import * as p from '@clack/prompts';
-import color from 'picocolors';
-import { getClaudeDirectory, getDevFlowDirectory } from '../utils/paths.js';
-import { getAllSkillNames } from '../plugins.js';
-import { copyDirectory } from '../utils/installer.js';
-/**
- * Check if a directory exists.
- */
-async function dirExists(dirPath) {
-    try {
-        const stat = await fs.stat(dirPath);
-        return stat.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get the shadow directory for a skill.
- */
-function getShadowDir(devflowDir, skillName) {
-    return path.join(devflowDir, 'skills', skillName);
-}
-/**
- * Check if a skill has a shadow (personal override).
- */
-export async function hasShadow(skillName, devflowDir) {
-    const dir = devflowDir ?? getDevFlowDirectory();
-    return dirExists(getShadowDir(dir, skillName));
-}
-/**
- * List all shadowed skill names.
- */
-export async function listShadowed(devflowDir) {
-    const dir = devflowDir ?? getDevFlowDirectory();
-    const shadowsRoot = path.join(dir, 'skills');
-    try {
-        const entries = await fs.readdir(shadowsRoot, { withFileTypes: true });
-        return entries.filter(e => e.isDirectory()).map(e => e.name);
-    }
-    catch {
-        return [];
-    }
-}
-export const skillsCommand = new Command('skills')
-    .description('Manage skill overrides (shadow/unshadow/list)')
-    .argument('<action>', 'Action: shadow, unshadow, or list-shadowed')
-    .argument('[name]', 'Skill name (required for shadow/unshadow)')
-    .action(async (action, name) => {
-    const devflowDir = getDevFlowDirectory();
-    const claudeDir = getClaudeDirectory();
-    const allSkills = getAllSkillNames();
-    if (action === 'shadow') {
-        if (!name) {
-            p.log.error('Skill name required. Usage: devflow skills shadow <name>');
-            p.log.info(`Available skills: ${allSkills.join(', ')}`);
-            process.exit(1);
-        }
-        if (!allSkills.includes(name)) {
-            p.log.error(`Unknown skill: ${name}`);
-            p.log.info(`Available skills: ${allSkills.join(', ')}`);
-            process.exit(1);
-        }
-        const installedSkillDir = path.join(claudeDir, 'skills', name);
-        if (!await dirExists(installedSkillDir)) {
-            p.log.error(`Skill not installed: ${name}. Run devflow init first.`);
-            process.exit(1);
-        }
-        const shadowDir = getShadowDir(devflowDir, name);
-        if (await dirExists(shadowDir)) {
-            p.log.info(`${name} is already shadowed`);
-            return;
-        }
-        // Create shadow directory and copy original as reference backup
-        await fs.mkdir(path.join(devflowDir, 'skills'), { recursive: true });
-        await copyDirectory(installedSkillDir, shadowDir);
-        p.log.success(`Shadowed ${color.cyan(name)}`);
-        p.log.info(`Edit ${color.dim(path.join(claudeDir, 'skills', name, 'SKILL.md'))} — it won't be overwritten on next init.`);
-    }
-    else if (action === 'unshadow') {
-        if (!name) {
-            p.log.error('Skill name required. Usage: devflow skills unshadow <name>');
-            process.exit(1);
-        }
-        const shadowDir = getShadowDir(devflowDir, name);
-        if (!await dirExists(shadowDir)) {
-            p.log.info(`${name} is not shadowed`);
-            return;
-        }
-        await fs.rm(shadowDir, { recursive: true, force: true });
-        p.log.success(`Unshadowed ${color.cyan(name)}`);
-        p.log.info('Run devflow init to restore DevFlow\'s version.');
-    }
-    else if (action === 'list-shadowed') {
-        const shadowed = await listShadowed(devflowDir);
-        if (shadowed.length === 0) {
-            p.log.info('No shadowed skills');
-            return;
-        }
-        p.log.info(`Shadowed skills (${shadowed.length}):`);
-        for (const skill of shadowed) {
-            const isKnown = allSkills.includes(skill);
-            const status = isKnown ? color.green('active') : color.yellow('unknown skill');
-            p.log.info(`  ${color.cyan(skill)} — ${status}`);
-        }
-    }
-    else {
-        p.log.error(`Unknown action: ${action}`);
-        p.log.info('Usage: devflow skills <shadow|unshadow|list-shadowed> [name]');
-        process.exit(1);
-    }
-});
-//# sourceMappingURL=skills.js.map

package/dist/commands/uninstall.d.ts

@@ -1,22 +0,0 @@
-import { Command } from 'commander';
-import { type PluginDefinition } from '../plugins.js';
-/**
- * Compute which assets should be removed during selective plugin uninstall.
- * Skills and agents shared by remaining plugins are retained.
- */
-export declare function computeAssetsToRemove(selectedPlugins: PluginDefinition[], allPlugins: PluginDefinition[]): {
-    skills: string[];
-    agents: string[];
-    commands: string[];
-};
-/**
- * Format a dry-run plan showing what would be removed.
- * Pure function — no I/O, fully testable.
- */
-export declare function formatDryRunPlan(assets: {
-    skills: string[];
-    agents: string[];
-    commands: string[];
-}, extras?: string[]): string;
-export declare const uninstallCommand: Command;
-//# sourceMappingURL=uninstall.d.ts.map