thachvd-kit 1.0.36 → 1.0.37

package/bin/native-skills.js

@@ -0,0 +1,149 @@
+const fs = require('fs');
+const path = require('path');
+
+const NATIVE_SKILLS = [
+    'using-git-worktrees',
+    'subagent-driven-development',
+    'finishing-a-development-branch'
+];
+
+const NATIVE_SUPPORT_FILES = [
+    path.join('requesting-code-review', 'code-reviewer.md')
+];
+
+const NATIVE_SKILL_SURFACES = [
+    { id: 'agents', relativeDir: path.join('.agents', 'skills') },
+    { id: 'claude', relativeDir: path.join('.claude', 'skills') }
+];
+
+const nativeSkillsSourceDir = path.resolve(__dirname, '..', 'skills');
+
+function sourcePath(relativePath) {
+    return path.join(nativeSkillsSourceDir, relativePath);
+}
+
+function skillSourceDir(name) {
+    return sourcePath(name);
+}
+
+function collectFiles(directory, relative = '') {
+    const files = [];
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const entryRelative = path.join(relative, entry.name);
+        const entryPath = path.join(directory, entry.name);
+        if (entry.isDirectory()) files.push(...collectFiles(entryPath, entryRelative));
+        else if (entry.isFile()) files.push(entryRelative);
+    }
+    return files;
+}
+
+function ownedFiles() {
+    return [
+        ...NATIVE_SKILLS.flatMap(name => collectFiles(skillSourceDir(name), name)),
+        ...NATIVE_SUPPORT_FILES
+    ];
+}
+
+function ownedSkillFiles(name) {
+    return collectFiles(skillSourceDir(name), name);
+}
+
+function targetPath(targetDir, surface, relativePath) {
+    return path.join(targetDir, surface.relativeDir, relativePath);
+}
+
+function checkNativeSkills(targetDir) {
+    const surfaces = {};
+    const skills = {};
+
+    for (const surface of NATIVE_SKILL_SURFACES) {
+        const missingFiles = ownedFiles().filter(relativePath => !fs.existsSync(targetPath(targetDir, surface, relativePath)));
+        const installed = [];
+        const missing = [];
+        for (const name of NATIVE_SKILLS) {
+            (ownedSkillFiles(name).every(relativePath => fs.existsSync(targetPath(targetDir, surface, relativePath)))
+                ? installed
+                : missing).push(name);
+        }
+        const supportInstalled = NATIVE_SUPPORT_FILES.filter(relativePath => !missingFiles.includes(relativePath));
+        const supportMissing = NATIVE_SUPPORT_FILES.filter(relativePath => missingFiles.includes(relativePath));
+        surfaces[surface.id] = {
+            installed,
+            missing,
+            total: NATIVE_SKILLS.length,
+            missingFiles,
+            support: {
+                installed: supportInstalled,
+                missing: supportMissing,
+                total: NATIVE_SUPPORT_FILES.length
+            }
+        };
+    }
+
+    for (const name of NATIVE_SKILLS) {
+        skills[name] = {};
+        for (const surface of NATIVE_SKILL_SURFACES) {
+            skills[name][surface.id] = ownedSkillFiles(name).every(relativePath => fs.existsSync(targetPath(targetDir, surface, relativePath)));
+        }
+    }
+
+    const installed = NATIVE_SKILLS.filter(name => NATIVE_SKILL_SURFACES.every(surface => skills[name][surface.id]));
+    const missing = NATIVE_SKILLS.filter(name => !installed.includes(name));
+    const missingFiles = Object.fromEntries(NATIVE_SKILL_SURFACES.map(surface => [surface.id, surfaces[surface.id].missingFiles]));
+    return {
+        installed,
+        missing,
+        total: NATIVE_SKILLS.length,
+        allInstalled: missingFiles.agents.length === 0 && missingFiles.claude.length === 0,
+        surfaces,
+        skills,
+        missingFiles
+    };
+}
+
+function copyFile(source, destination) {
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
+    fs.copyFileSync(source, destination);
+}
+
+function installNativeSkills(targetDir, options = {}) {
+    const dryRun = options.dryRun === true;
+    const operations = [];
+    for (const surface of NATIVE_SKILL_SURFACES) {
+        for (const relativePath of ownedFiles()) {
+            const source = sourcePath(relativePath);
+            const destination = targetPath(targetDir, surface, relativePath);
+            operations.push({ surface: surface.id, relativePath, source, destination });
+            if (!dryRun) copyFile(source, destination);
+        }
+    }
+    return {
+        ok: true,
+        dryRun,
+        operations,
+        results: NATIVE_SKILLS.map(name => ({ name, ok: true, dryRun })),
+        message: dryRun
+            ? `Dry run: would copy ${NATIVE_SKILLS.length} native skills to .agents/skills and .claude/skills`
+            : `installed ${NATIVE_SKILLS.length} thachvd-kit native skills to .agents/skills and .claude/skills`
+    };
+}
+
+function updateNativeSkills(targetDir, options = {}) {
+    const result = installNativeSkills(targetDir, options);
+    return {
+        ...result,
+        message: result.dryRun
+            ? `Dry run: would refresh ${NATIVE_SKILLS.length} native skills from bundled copies`
+            : `updated ${NATIVE_SKILLS.length} thachvd-kit native skills from bundled copies`
+    };
+}
+
+module.exports = {
+    NATIVE_SKILLS,
+    NATIVE_SUPPORT_FILES,
+    NATIVE_SKILL_SURFACES,
+    nativeSkillsSourceDir,
+    checkNativeSkills,
+    installNativeSkills,
+    updateNativeSkills
+};