thachvd-kit 1.0.37 → 1.0.39

package/bin/config.js

@@ -0,0 +1,164 @@
+const fs = require('fs');
+const path = require('path');
+
+const CONFIG_RELATIVE_PATH = path.join('.thachvd', 'config.json');
+const SUPPORTED_SPEC_LANGUAGES = new Set(['en', 'vi']);
+const SUPPORTED_SPEC_PROFILES = new Set(['auto', 'backend', 'frontend', 'fullstack', 'mobile', 'infra']);
+
+function resolveHome(env = process.env) {
+    return env.USERPROFILE || env.HOME || null;
+}
+
+function configPath(homeDir) {
+    return path.join(homeDir, CONFIG_RELATIVE_PATH);
+}
+
+function readConfig(homeDir) {
+    if (!homeDir) return {};
+    const filePath = configPath(homeDir);
+    if (!fs.existsSync(filePath)) return {};
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    } catch (error) {
+        throw new Error(`Cannot parse ${filePath}: ${error.message}`);
+    }
+}
+
+function writeConfig(homeDir, config) {
+    if (!homeDir) throw new Error('Cannot determine home directory from USERPROFILE or HOME.');
+    const filePath = configPath(homeDir);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    return filePath;
+}
+
+function normalizeLanguage(value) {
+    const language = String(value || '').trim().toLowerCase();
+    if (!SUPPORTED_SPEC_LANGUAGES.has(language)) {
+        throw new Error(`Unsupported spec language: ${value}. Supported values: en, vi`);
+    }
+    return language;
+}
+
+function normalizeProfile(value) {
+    const profile = String(value || '').trim().toLowerCase();
+    if (!SUPPORTED_SPEC_PROFILES.has(profile)) {
+        throw new Error(`Unsupported spec profile: ${value}. Supported values: auto, backend, frontend, fullstack, mobile, infra`);
+    }
+    return profile;
+}
+
+function getDefaultSpecProfile(env = process.env) {
+    const homeDir = resolveHome(env);
+    if (!homeDir) return null;
+    const config = readConfig(homeDir);
+    return config.spec_profile ? normalizeProfile(config.spec_profile) : null;
+}
+
+function getDefaultSpecLanguage(env = process.env) {
+    const homeDir = resolveHome(env);
+    if (!homeDir) return null;
+    const config = readConfig(homeDir);
+    return config.spec_language ? normalizeLanguage(config.spec_language) : null;
+}
+
+function printHelp() {
+    console.log(`thachvd-kit config
+
+Usage:
+  thachvd-kit config show
+  thachvd-kit config set spec-language en|vi
+  thachvd-kit config unset spec-language
+  thachvd-kit config set spec-profile auto|backend|frontend|fullstack|mobile|infra
+  thachvd-kit config unset spec-profile
+
+The user-level config is stored at ~/.thachvd/config.json (or the platform-equivalent home directory).
+Project-level --language and --profile always override their user defaults.
+`);
+}
+
+function runConfigCommand(args, options = {}) {
+    const env = options.env || process.env;
+    const homeDir = options.homeDir || resolveHome(env);
+    const command = args[0] || 'show';
+
+    try {
+        if (command === '--help' || command === '-h' || command === 'help') {
+            printHelp();
+            return 0;
+        }
+
+        if (command === 'show') {
+            const config = readConfig(homeDir);
+            console.log(`Config: ${homeDir ? configPath(homeDir) : '(home unavailable)'}`);
+            console.log(`spec-language: ${config.spec_language || '(default: en)'}`);
+            console.log(`spec-profile: ${config.spec_profile || '(default: auto)'}`);
+            return 0;
+        }
+
+        if (command === 'set') {
+            if (!args[1] || !args[2]) {
+                throw new Error('Usage: thachvd-kit config set spec-language en|vi OR spec-profile auto|backend|frontend|fullstack|mobile|infra');
+            }
+            const config = readConfig(homeDir);
+            if (args[1] === 'spec-language') {
+                const language = normalizeLanguage(args[2]);
+                config.spec_language = language;
+                const filePath = writeConfig(homeDir, config);
+                console.log(`Updated ${filePath}`);
+                console.log(`spec-language: ${language}`);
+                return 0;
+            }
+            if (args[1] === 'spec-profile') {
+                const profile = normalizeProfile(args[2]);
+                config.spec_profile = profile;
+                const filePath = writeConfig(homeDir, config);
+                console.log(`Updated ${filePath}`);
+                console.log(`spec-profile: ${profile}`);
+                return 0;
+            }
+            throw new Error(`Unknown config key: ${args[1]}`);
+        }
+
+        if (command === 'unset') {
+            const config = readConfig(homeDir);
+            if (args[1] === 'spec-language') {
+                delete config.spec_language;
+                const filePath = writeConfig(homeDir, config);
+                console.log(`Updated ${filePath}`);
+                console.log('spec-language: (default: en)');
+                return 0;
+            }
+            if (args[1] === 'spec-profile') {
+                delete config.spec_profile;
+                const filePath = writeConfig(homeDir, config);
+                console.log(`Updated ${filePath}`);
+                console.log('spec-profile: (default: auto)');
+                return 0;
+            }
+            throw new Error('Usage: thachvd-kit config unset spec-language|spec-profile');
+        }
+
+        throw new Error(`Unknown config command: ${command}`);
+    } catch (error) {
+        console.error(`config ${command} failed: ${error.message}`);
+        process.exitCode = 1;
+        return 1;
+    }
+}
+
+module.exports = {
+    CONFIG_RELATIVE_PATH,
+    SUPPORTED_SPEC_LANGUAGES,
+    SUPPORTED_SPEC_PROFILES,
+    resolveHome,
+    configPath,
+    readConfig,
+    writeConfig,
+    normalizeLanguage,
+    normalizeProfile,
+    getDefaultSpecLanguage,
+    getDefaultSpecProfile,
+    runConfigCommand
+};

package/bin/entry.js

@@ -11,7 +11,7 @@ function isInitInvocation(args) {
     if (args.includes('--help') || args.includes('-h') || args.includes('--version') || args.includes('-v')) {
         return false;
     }
-    // Note: 'upgrade' and 'global' are handled and returned above before this
+    // Note: 'upgrade', 'global', 'config', and 'spec' are handled and returned above before this
     // is ever called, so they never reach here.
     const first = args[0];
     return !first || first === 'init' || first.startsWith('-');
@@ -74,6 +74,16 @@ if (command === 'global') {
     return;
 }
 
+if (command === 'config') {
+    require('./config').runConfigCommand(args.slice(1));
+    return;
+}
+
+if (command === 'spec') {
+    require('./spec').runSpecCommand(args.slice(1));
+    return;
+}
+
 const shouldUpgradeGeneratedPolicy = isInitInvocation(args);
 const beforeSnapshot = shouldUpgradeGeneratedPolicy ? snapshotPolicyFiles(process.cwd()) : null;
 const force = args.includes('--yes') || args.includes('-y');

package/bin/native-skills.js

@@ -1,149 +1,183 @@
-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
-};
+const fs = require('fs');
+const path = require('path');
+
+const NATIVE_SKILLS = [
+    'using-git-worktrees',
+    'subagent-driven-development',
+    'finishing-a-development-branch',
+    'system-discovery',
+    'system-reverse-engineer',
+    'system-spec-review'
+];
+
+const SYSTEM_SPEC_SKILLS = [
+    'system-discovery',
+    'system-reverse-engineer',
+    'system-spec-review'
+];
+
+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 installSystemSpecSkills(targetDir, options = {}) {
+    const dryRun = options.dryRun === true;
+    const operations = [];
+    for (const surface of NATIVE_SKILL_SURFACES) {
+        for (const name of SYSTEM_SPEC_SKILLS) {
+            for (const relativePath of ownedSkillFiles(name)) {
+                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,
+        message: dryRun
+            ? `Dry run: would copy ${SYSTEM_SPEC_SKILLS.length} system-spec skills to workspace agent surfaces`
+            : `installed ${SYSTEM_SPEC_SKILLS.length} system-spec skills to workspace agent surfaces`
+    };
+}
+
+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,
+    SYSTEM_SPEC_SKILLS,
+    NATIVE_SUPPORT_FILES,
+    NATIVE_SKILL_SURFACES,
+    nativeSkillsSourceDir,
+    checkNativeSkills,
+    installNativeSkills,
+    installSystemSpecSkills,
+    updateNativeSkills
+};