devflow-kit 1.8.3 → 2.0.1

package/dist/cli/commands/skills.js

@@ -0,0 +1,140 @@
+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 '../../targets/claude-code/claude-paths.js';
+import { getAllSkillNames, prefixSkillName, unprefixSkillName, FEATURE_OWNED_SKILLS } from '../../core/plugins.js';
+import { copyDirectory, validateSkillShadow } from '../../targets/claude-code/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', unprefixSkillName(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));
+}
+/** Render the shadow-state display tag for a skill. Exhaustive switch catches new states at compile time. */
+function buildSkillShadowTag(shadowState) {
+    switch (shadowState) {
+        case 'valid':
+            return color.green('shadowed');
+        case 'missing-skill-md':
+            return color.yellow('shadowed — invalid: no SKILL.md');
+        case 'none':
+            return color.dim('—');
+        default: {
+            const _exhaustive = shadowState;
+            void _exhaustive;
+            return color.dim('—');
+        }
+    }
+}
+export const skillsCommand = new Command('skills')
+    .description('Manage skill overrides (shadow/unshadow/list)')
+    .argument('<action>', 'Action: shadow, unshadow, or list')
+    .argument('[name]', 'Skill name (required for shadow/unshadow)')
+    .action(async (action, name) => {
+    const devflowDir = getDevFlowDirectory();
+    const claudeDir = getClaudeDirectory();
+    // Union FEATURE_OWNED_SKILLS (compliance) so shadow/unshadow/list cover feature-managed
+    // skills that left the plugin registry but still live in src/assets/skills/ (step 1.5).
+    const allSkills = [...getAllSkillNames(), ...FEATURE_OWNED_SKILLS];
+    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);
+        }
+        // Accept both bare and prefixed input
+        const bareName = unprefixSkillName(name);
+        if (!allSkills.includes(bareName)) {
+            p.log.error(`Unknown skill: ${bareName}`);
+            p.log.info(`Available skills: ${allSkills.join(', ')}`);
+            process.exit(1);
+        }
+        const prefixedName = prefixSkillName(bareName);
+        const installedSkillDir = path.join(claudeDir, 'skills', prefixedName);
+        if (!await dirExists(installedSkillDir)) {
+            p.log.error(`Skill not installed: ${prefixedName}. Run devflow init first.`);
+            process.exit(1);
+        }
+        const shadowDir = getShadowDir(devflowDir, bareName);
+        if (await dirExists(shadowDir)) {
+            p.log.info(`${bareName} is already shadowed`);
+            return;
+        }
+        // Create shadow directory (unprefixed) 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(bareName)}`);
+        p.log.info(`Edit ${color.dim(path.join(shadowDir, 'SKILL.md'))} then run devflow init to apply.`);
+    }
+    else if (action === 'unshadow') {
+        if (!name) {
+            p.log.error('Skill name required. Usage: devflow skills unshadow <name>');
+            process.exit(1);
+        }
+        // Accept both bare and prefixed input
+        const bareName = unprefixSkillName(name);
+        const shadowDir = getShadowDir(devflowDir, bareName);
+        if (!await dirExists(shadowDir)) {
+            p.log.info(`${bareName} is not shadowed`);
+            return;
+        }
+        await fs.rm(shadowDir, { recursive: true, force: true });
+        p.log.success(`Unshadowed ${color.cyan(bareName)}`);
+        p.log.info('Run devflow init to restore Devflow\'s version.');
+    }
+    else if (action === 'list') {
+        const shadowsRoot = path.join(devflowDir, 'skills');
+        // Collect shadow dirs that exist
+        let shadowDirNames = [];
+        try {
+            const entries = await fs.readdir(shadowsRoot, { withFileTypes: true });
+            shadowDirNames = entries.filter(e => e.isDirectory()).map(e => e.name);
+        }
+        catch { /* skills dir absent — no shadows */ }
+        const shadowDirSet = new Set(shadowDirNames);
+        const knownSkillSet = new Set(allSkills);
+        // Build rows in parallel; short-circuit validateSkillShadow for skills with no shadow dir
+        const knownResults = await Promise.all(allSkills.map(async (skill) => {
+            const shadowState = shadowDirSet.has(skill)
+                ? await validateSkillShadow(path.join(shadowsRoot, skill))
+                : 'none';
+            return { skill, shadowState };
+        }));
+        const rows = knownResults.map(({ skill, shadowState }) => `  ${color.cyan(skill.padEnd(28))} ${buildSkillShadowTag(shadowState)}`);
+        // Orphan shadows: in ~/.devflow/skills/ but not a known skill
+        for (const dirName of shadowDirNames) {
+            if (!knownSkillSet.has(dirName)) {
+                rows.push(`  ${color.yellow(dirName.padEnd(28))} ${color.yellow('unknown skill')}`);
+            }
+        }
+        const shadowedCount = knownResults.filter(r => r.shadowState !== 'none').length;
+        p.note(rows.join('\n'), `Skills (${allSkills.length} known, ${shadowedCount} shadowed)`);
+    }
+    else {
+        p.log.error(`Unknown action: ${action}`);
+        p.log.info('Usage: devflow skills <shadow|unshadow|list> [name]');
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=skills.js.map