agent-skills-standard 1.3.2 → 1.4.0

package/README.md

@@ -33,6 +33,36 @@ Modern AI coding agents are powerful, but they have major flaws:
 
 ---
 
+## 🛠 The Solution: Digital DNA for AI
+
+Agent Skills Standard treats instructions as **versioned dependencies**, much like software libraries.
+
+- **🎯 Smart Loading**: We use a "Search-on-Demand" pattern. The AI only looks at detailed examples when it specifically needs them, saving its memory for your actual code.
+- **🚀 High-Density Language**: We use a specialized "Compressed Syntax" that is **40% more efficient** than normal English. This means the AI understands more while using fewer resources.
+- **🔁 One-Click Sync**: A single command ensures your AI tool stays up-to-date with your team's latest standards.
+
+---
+
+## ✨ Features
+
+- **🛡️ Multi-Agent Support**: Out-of-the-box mapping for Cursor, Claude Dev, GitHub Copilot, and more.
+- **📦 Modular Registry**: Don't load everything. Only enable the skills your project actually uses (e.g., `Flutter + BLoC + Clean Architecture`).
+- **🔄 Dynamic Re-detection**: Automatically re-enables excluded skills if matching dependencies (like `Retrofit`, `Room`, or `Navigation`) are added to your project.
+- **🔒 Secure Overrides**: Lock specific files in your project so they never get overwritten by the central registry.
+- **📊 Semantic Tagging**: Skills are tagged with triggers that tell the AI _exactly_ when to apply them.
+
+---
+
+## � Token Economy & Optimization
+
+To ensure AI efficiency, this project follows a strict **Token Economy**. Every skill is audited for its footprint in the AI's context window.
+
+### 📏 Our Standards
+
+- **High-Density**: Core rules in `SKILL.md` are kept under **70 lines**.
+- **Efficiency**: Target **< 500 tokens** per primary skill file.
+- **Progressive Disclosure**: Heavy examples, checklists, and implementation guides are moved to the `references/` directory and are only loaded by the agent when specific context matches.
+
 ## 🚀 Installation
 
 You can run the tool instantly without installing, or install it globally for convenience:
@@ -115,7 +145,12 @@ The CLI connects to the [Official Skills Registry](https://github.com/HoangNguye
 - **React**: Hooks, Patterns, Performance.
 - **NestJS**: Architecture, Microservices, Security.
 - **Next.js**: App Router, RSC, FSD Architecture.
-- **Golang**: (Coming Soon)
+- **Golang**: Clean Architecture, API Design, Concurrency.
+- **Angular**: Standalone, Signals, Control Flow.
+- **Kotlin**: Idiomatic Patterns, Coroutines, Flow.
+- **Spring Boot**: Architecture, Security, Data, Test.
+- **Android Native**: Architecture, Compose, DI, Performance, Testing, WorkManager.
+- **iOS Native**: Architecture, UI/Layout, Lifecycle, Security, Performance.
 
 ---
 

package/dist/commands/init.js

@@ -74,7 +74,10 @@ class InitCommand {
         ]);
         const frameworkId = answers.framework;
         const frameworkDef = constants_1.SUPPORTED_FRAMEWORKS.find((f) => f.id === frameworkId);
-        const config = this.configService.buildInitialConfig(frameworkId, answers.agents, answers.registry, metadata, frameworkDef?.languages || []);
+        const languages = frameworkDef
+            ? await this.detectionService.detectLanguages(frameworkDef)
+            : [];
+        const config = this.configService.buildInitialConfig(frameworkId, answers.agents, answers.registry, metadata, languages);
         const projectDeps = await this.detectionService.getProjectDeps();
         this.configService.applyDependencyExclusions(config, frameworkId, projectDeps);
         const commentHeader = `# Auto-detected configuration generated by agent-skills-standard init

package/dist/commands/sync.js

@@ -9,6 +9,7 @@ const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const constants_1 = require("../constants");
 const ConfigService_1 = require("../services/ConfigService");
+const DetectionService_1 = require("../services/DetectionService");
 const GithubService_1 = require("../services/GithubService");
 class SyncCommand {
     constructor() {
@@ -23,6 +24,22 @@ class SyncCommand {
                 console.log(picocolors_1.default.red('❌ Error: .skillsrc not found. Run `init` first.'));
                 return;
             }
+            // --- DYNAMIC RE-DETECTION ---
+            const detectionService = new DetectionService_1.DetectionService();
+            const projectDeps = await detectionService.getProjectDeps();
+            let configChanged = false;
+            const categoriesToReconcile = Object.keys(config.skills);
+            for (const cat of categoriesToReconcile) {
+                const reenabled = this.configService.reconcileDependencies(config, cat, projectDeps);
+                if (reenabled.length > 0) {
+                    console.log(picocolors_1.default.yellow(`✨ Dynamic Re-detection: Re-enabling [${reenabled.join(', ')}] in '${cat}' category.`));
+                    configChanged = true;
+                }
+            }
+            if (configChanged) {
+                await this.configService.saveConfig(config);
+            }
+            // ----------------------------
             // 2. Check for updates
             config = await this.checkForUpdates(config);
             console.log(picocolors_1.default.cyan(`🚀 Syncing skills from ${config.registry}...`));

package/dist/constants/enums.d.ts

@@ -17,5 +17,7 @@ export declare enum Framework {
     NextJS = "nextjs",
     React = "react",
     ReactNative = "react-native",
-    Angular = "angular"
+    Angular = "angular",
+    SpringBoot = "spring-boot",
+    Android = "android"
 }

package/dist/constants/enums.js

@@ -23,4 +23,6 @@ var Framework;
     Framework["React"] = "react";
     Framework["ReactNative"] = "react-native";
     Framework["Angular"] = "angular";
+    Framework["SpringBoot"] = "spring-boot";
+    Framework["Android"] = "android";
 })(Framework || (exports.Framework = Framework = {}));

package/dist/constants/index.d.ts

@@ -14,6 +14,7 @@ export interface FrameworkDefinition {
     languages: string[];
     detectionFiles: string[];
     detectionDependencies?: string[];
+    languageDetection?: Record<string, string[]>;
 }
 export declare const getAgentDefinition: (id: Agent) => AgentDefinition;
 export declare const getFrameworkDefinition: (id: Framework) => FrameworkDefinition;

package/dist/constants/index.js

@@ -97,6 +97,10 @@ const getFrameworkDefinition = (id) => {
                 languages: ['typescript', 'javascript'],
                 detectionFiles: ['nest-cli.json'],
                 detectionDependencies: ['@nestjs/core'],
+                languageDetection: {
+                    typescript: ['tsconfig.json'],
+                    javascript: ['jsconfig.json'],
+                },
             };
         case enums_1.Framework.Golang:
             return {
@@ -112,6 +116,10 @@ const getFrameworkDefinition = (id) => {
                 languages: ['typescript', 'javascript'],
                 detectionFiles: ['next.config.js', 'next.config.mjs'],
                 detectionDependencies: ['next'],
+                languageDetection: {
+                    typescript: ['tsconfig.json'],
+                    javascript: ['jsconfig.json'],
+                },
             };
         case enums_1.Framework.React:
             return {
@@ -120,6 +128,10 @@ const getFrameworkDefinition = (id) => {
                 languages: ['typescript', 'javascript'],
                 detectionFiles: [],
                 detectionDependencies: ['react', 'react-dom'],
+                languageDetection: {
+                    typescript: ['tsconfig.json'],
+                    javascript: ['jsconfig.json'],
+                },
             };
         case enums_1.Framework.ReactNative:
             return {
@@ -128,6 +140,10 @@ const getFrameworkDefinition = (id) => {
                 languages: ['typescript', 'javascript'],
                 detectionFiles: ['metro.config.js'],
                 detectionDependencies: ['react-native'],
+                languageDetection: {
+                    typescript: ['tsconfig.json'],
+                    javascript: ['jsconfig.json'],
+                },
             };
         case enums_1.Framework.Angular:
             return {
@@ -136,6 +152,32 @@ const getFrameworkDefinition = (id) => {
                 languages: ['typescript'],
                 detectionFiles: ['angular.json'],
             };
+        case enums_1.Framework.SpringBoot:
+            return {
+                id,
+                name: 'Spring Boot',
+                languages: ['java', 'kotlin'],
+                detectionFiles: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
+                languageDetection: {
+                    kotlin: ['src/main/kotlin', 'build.gradle.kts'],
+                    java: ['src/main/java'],
+                },
+            };
+        case enums_1.Framework.Android:
+            return {
+                id,
+                name: 'Android',
+                languages: ['kotlin', 'java'],
+                detectionFiles: [
+                    'build.gradle',
+                    'build.gradle.kts',
+                    'AndroidManifest.xml',
+                ],
+                languageDetection: {
+                    kotlin: ['src/main/kotlin', 'build.gradle.kts'],
+                    java: ['src/main/java'],
+                },
+            };
     }
 };
 exports.getFrameworkDefinition = getFrameworkDefinition;

package/dist/constants/skills.js

@@ -54,4 +54,37 @@ exports.SKILL_DETECTION_REGISTRY = {
             packages: ['@nestjs/passport', 'passport', 'helmet'],
         },
     ],
+    [enums_1.Framework.Android]: [
+        {
+            id: 'compose',
+            packages: ['androidx.compose.ui'],
+        },
+        {
+            id: 'navigation',
+            packages: ['androidx.navigation:navigation-compose'],
+        },
+        {
+            id: 'legacy-navigation',
+            packages: [
+                'androidx.navigation:navigation-fragment',
+                'androidx.navigation:navigation-ui',
+            ],
+        },
+        {
+            id: 'di',
+            packages: ['hilt-android', 'dagger-android'],
+        },
+        {
+            id: 'persistence',
+            packages: ['androidx.room:room-runtime'],
+        },
+        {
+            id: 'networking',
+            packages: ['retrofit'],
+        },
+        {
+            id: 'concurrency',
+            packages: ['kotlinx-coroutines-android'],
+        },
+    ],
 };

package/dist/index.js

@@ -10,7 +10,7 @@ const program = new commander_1.Command();
 program
     .name('agent-skills-standard')
     .description('A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.')
-    .version('1.3.2');
+    .version('1.4.0');
 program
     .command('init')
     .description('Initialize a .skillsrc configuration file interactively')

package/dist/services/ConfigService.d.ts

@@ -5,4 +5,9 @@ export declare class ConfigService {
     saveConfig(config: SkillConfig, cwd?: string): Promise<void>;
     buildInitialConfig(framework: string, agents: string[], registry: string, metadata: Partial<RegistryMetadata>, languages?: string[]): SkillConfig;
     applyDependencyExclusions(config: SkillConfig, framework: string, projectDeps: Set<string>): void;
+    /**
+     * Automatically re-enables skills that were previously excluded if their dependencies
+     * are now present in the project.
+     */
+    reconcileDependencies(config: SkillConfig, framework: string, projectDeps: Set<string>): string[];
 }

package/dist/services/ConfigService.js

@@ -91,5 +91,33 @@ class ConfigService {
             category.exclude = Array.from(exclusions);
         }
     }
+    /**
+     * Automatically re-enables skills that were previously excluded if their dependencies
+     * are now present in the project.
+     */
+    reconcileDependencies(config, framework, projectDeps) {
+        const category = config.skills[framework];
+        if (!category || !category.exclude)
+            return [];
+        const reenabled = [];
+        const detections = constants_1.SKILL_DETECTION_REGISTRY[framework] || [];
+        const currentExclusions = new Set(category.exclude);
+        for (const detection of detections) {
+            if (currentExclusions.has(detection.id)) {
+                const hasDep = Array.from(projectDeps).some((d) => detection.packages.some((pkg) => d.toLowerCase().includes(pkg.toLowerCase())));
+                if (hasDep) {
+                    currentExclusions.delete(detection.id);
+                    reenabled.push(detection.id);
+                }
+            }
+        }
+        if (reenabled.length > 0) {
+            category.exclude = Array.from(currentExclusions);
+            if (category.exclude.length === 0) {
+                delete category.exclude;
+            }
+        }
+        return reenabled;
+    }
 }
 exports.ConfigService = ConfigService;

package/dist/services/DetectionService.d.ts

@@ -1,6 +1,13 @@
+import { FrameworkDefinition } from '../constants';
 export declare class DetectionService {
     detectFrameworks(): Promise<Record<string, boolean>>;
+    detectLanguages(framework: FrameworkDefinition): Promise<string[]>;
     detectAgents(): Promise<Record<string, boolean>>;
     getProjectDeps(): Promise<Set<string>>;
+    private parsePackageJson;
+    private parsePubspecYaml;
+    private parseGradleDependencies;
+    private parseVersionCatalogs;
+    private parseMavenPom;
     private getPackageDeps;
 }

package/dist/services/DetectionService.js

@@ -30,6 +30,23 @@ class DetectionService {
         }
         return results;
     }
+    async detectLanguages(framework) {
+        if (!framework.languageDetection) {
+            return framework.languages;
+        }
+        const detectedLanguages = [];
+        for (const [lang, files] of Object.entries(framework.languageDetection)) {
+            for (const file of files) {
+                if (await fs_extra_1.default.pathExists(path_1.default.join(process.cwd(), file))) {
+                    detectedLanguages.push(lang);
+                    break;
+                }
+            }
+        }
+        return detectedLanguages.length > 0
+            ? detectedLanguages
+            : framework.languages;
+    }
     async detectAgents() {
         const results = {};
         for (const agent of constants_1.SUPPORTED_AGENTS) {
@@ -45,54 +62,148 @@ class DetectionService {
         return results;
     }
     async getProjectDeps() {
+        const cwd = process.cwd();
+        const results = await Promise.all([
+            this.parsePackageJson(cwd),
+            this.parsePubspecYaml(cwd),
+            this.parseGradleDependencies(cwd),
+            this.parseVersionCatalogs(cwd),
+            this.parseMavenPom(cwd),
+        ]);
+        const combined = new Set();
+        for (const set of results) {
+            for (const item of set)
+                combined.add(item);
+        }
+        return combined;
+    }
+    async parsePackageJson(cwd) {
         const set = new Set();
-        const packageJsonPath = path_1.default.join(process.cwd(), 'package.json');
-        if (await fs_extra_1.default.pathExists(packageJsonPath)) {
-            try {
-                const pkg = await fs_extra_1.default.readJson(packageJsonPath);
-                const deps = {
-                    ...(pkg.dependencies || {}),
-                    ...(pkg.devDependencies || {}),
-                };
-                for (const k of Object.keys(deps))
-                    set.add(k);
-            }
-            catch {
-                // ignore
+        const packageJsonPath = path_1.default.join(cwd, 'package.json');
+        if (!(await fs_extra_1.default.pathExists(packageJsonPath)))
+            return set;
+        try {
+            const pkg = await fs_extra_1.default.readJson(packageJsonPath);
+            const deps = {
+                ...(pkg.dependencies || {}),
+                ...(pkg.devDependencies || {}),
+            };
+            Object.keys(deps).forEach((k) => set.add(k));
+        }
+        catch {
+            /* ignore */
+        }
+        return set;
+    }
+    async parsePubspecYaml(cwd) {
+        const set = new Set();
+        const pubspecPath = path_1.default.join(cwd, 'pubspec.yaml');
+        if (!(await fs_extra_1.default.pathExists(pubspecPath)))
+            return set;
+        try {
+            const content = await fs_extra_1.default.readFile(pubspecPath, 'utf8');
+            const lines = content.split(/\r?\n/);
+            let currentSection = null;
+            let sectionIndent = null;
+            for (const line of lines) {
+                const sectionMatch = line.match(/^(\s*)(dependencies|dev_dependencies)\s*:/);
+                if (sectionMatch) {
+                    currentSection = sectionMatch[2];
+                    sectionIndent = sectionMatch[1].length;
+                    continue;
+                }
+                if (!currentSection || sectionIndent === null)
+                    continue;
+                const entryMatch = line.match(/^(\s*)([a-zA-Z0-9_\-@\\/]+)\s*:/);
+                if (!entryMatch)
+                    continue;
+                const indent = entryMatch[1].length;
+                const key = entryMatch[2];
+                if (indent > sectionIndent && key !== 'sdk' && key !== 'flutter') {
+                    set.add(key);
+                }
             }
         }
-        const pubspecPath = path_1.default.join(process.cwd(), 'pubspec.yaml');
-        if (await fs_extra_1.default.pathExists(pubspecPath)) {
+        catch {
+            /* ignore */
+        }
+        return set;
+    }
+    async parseGradleDependencies(cwd) {
+        const set = new Set();
+        const gradleRegex = /(?:implementation|api|ksp|kapt|annotationProcessor|compileOnly|runtimeOnly)\s*\(?\s*['"]([^'":\s]+)(?::[^'"]*)?['"]\s*\)?/g;
+        const scanDir = async (dir, depth) => {
+            if (depth > 3)
+                return;
             try {
-                const loaded = await fs_extra_1.default.readFile(pubspecPath, 'utf8');
-                // simple parse: only collect keys inside dependencies/dev_dependencies sections
-                const lines = loaded.split(/\r?\n/);
-                let currentSection = null;
-                let sectionIndent = null;
-                for (const line of lines) {
-                    const sectionMatch = line.match(/^(\s*)(dependencies|dev_dependencies)\s*:/);
-                    if (sectionMatch) {
-                        currentSection = sectionMatch[2];
-                        sectionIndent = sectionMatch[1].length;
-                        continue;
+                const entries = await fs_extra_1.default.readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path_1.default.join(dir, entry.name);
+                    if (entry.isDirectory()) {
+                        if (['node_modules', '.git', 'build', '.gradle'].includes(entry.name))
+                            continue;
+                        await scanDir(fullPath, depth + 1);
                     }
-                    if (!currentSection || sectionIndent === null)
-                        continue;
-                    const entryMatch = line.match(/^(\s*)([a-zA-Z0-9_\-@\\/]+)\s*:/);
-                    if (!entryMatch)
-                        continue;
-                    const indent = entryMatch[1].length;
-                    const key = entryMatch[2];
-                    // only include keys that are nested under the current section and are not known non-packages
-                    if (indent > sectionIndent && key !== 'sdk' && key !== 'flutter') {
-                        set.add(key);
+                    else if (entry.name === 'build.gradle' ||
+                        entry.name === 'build.gradle.kts') {
+                        const content = await fs_extra_1.default.readFile(fullPath, 'utf8');
+                        let match;
+                        while ((match = gradleRegex.exec(content)) !== null) {
+                            set.add(match[1]);
+                        }
                     }
                 }
             }
             catch {
-                // ignore
+                /* ignore */
+            }
+        };
+        await scanDir(cwd, 0);
+        return set;
+    }
+    async parseVersionCatalogs(cwd) {
+        const set = new Set();
+        const tomlPaths = [
+            path_1.default.join(cwd, 'gradle', 'libs.versions.toml'),
+            path_1.default.join(cwd, 'gradle.libs.versions.toml'),
+        ];
+        for (const tomlPath of tomlPaths) {
+            if (!(await fs_extra_1.default.pathExists(tomlPath)))
+                continue;
+            try {
+                const content = await fs_extra_1.default.readFile(tomlPath, 'utf8');
+                const moduleRegex = /module\s*=\s*['"]([^'":\s]+)(?::[^'"]*)?['"]/g;
+                const groupRegex = /group\s*=\s*['"]([^'":\s]+)['"]/g;
+                let match;
+                while ((match = moduleRegex.exec(content)) !== null) {
+                    set.add(match[1]);
+                }
+                while ((match = groupRegex.exec(content)) !== null) {
+                    set.add(match[1]);
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return set;
+    }
+    async parseMavenPom(cwd) {
+        const set = new Set();
+        const pomPath = path_1.default.join(cwd, 'pom.xml');
+        if (!(await fs_extra_1.default.pathExists(pomPath)))
+            return set;
+        try {
+            const content = await fs_extra_1.default.readFile(pomPath, 'utf8');
+            const regex = /<dependency>[\s\S]*?<artifactId>([^<]+)<\/artifactId>[\s\S]*?<\/dependency>/g;
+            let match;
+            while ((match = regex.exec(content)) !== null) {
+                set.add(match[1]);
             }
         }
+        catch {
+            /* ignore */
+        }
         return set;
     }
     // kept for internal usage if needed, or can be replaced by getProjectDeps

package/dist/services/__tests__/ConfigService.spec.js

@@ -210,4 +210,62 @@ vitest_1.vi.mock('js-yaml');
             });
         });
     });
+    (0, vitest_1.describe)('reconcileDependencies', () => {
+        (0, vitest_1.it)('should re-enable skills if dependencies are found', () => {
+            const config = {
+                registry: 'https://example.com',
+                agents: ['cursor'],
+                skills: {
+                    android: {
+                        ref: 'v1.0.0',
+                        exclude: ['networking', 'persistence'],
+                    },
+                },
+                custom_overrides: [],
+            };
+            // networking is detected by 'retrofit'
+            // persistence is detected by 'androidx.room:room-runtime'
+            const projectDeps = new Set(['retrofit', 'some-other-dep']);
+            const reenabled = configService.reconcileDependencies(config, 'android', projectDeps);
+            (0, vitest_1.expect)(reenabled).toEqual(['networking']);
+            const category = config.skills.android;
+            (0, vitest_1.expect)(category.exclude).toEqual(['persistence']);
+        });
+        (0, vitest_1.it)('should remove exclude key if all skills are re-enabled', () => {
+            const config = {
+                registry: 'https://example.com',
+                agents: ['cursor'],
+                skills: {
+                    android: {
+                        ref: 'v1.0.0',
+                        exclude: ['networking'],
+                    },
+                },
+                custom_overrides: [],
+            };
+            const projectDeps = new Set(['retrofit']);
+            const reenabled = configService.reconcileDependencies(config, 'android', projectDeps);
+            (0, vitest_1.expect)(reenabled).toEqual(['networking']);
+            const category = config.skills.android;
+            (0, vitest_1.expect)(category.exclude).toBeUndefined();
+        });
+        (0, vitest_1.it)('should return empty if no skills are re-enabled', () => {
+            const config = {
+                registry: 'https://example.com',
+                agents: ['cursor'],
+                skills: {
+                    android: {
+                        ref: 'v1.0.0',
+                        exclude: ['persistence'],
+                    },
+                },
+                custom_overrides: [],
+            };
+            const projectDeps = new Set(['some-other-dep']);
+            const reenabled = configService.reconcileDependencies(config, 'android', projectDeps);
+            (0, vitest_1.expect)(reenabled).toEqual([]);
+            const category = config.skills.android;
+            (0, vitest_1.expect)(category.exclude).toEqual(['persistence']);
+        });
+    });
 });

package/dist/services/__tests__/DetectionService.spec.js

@@ -118,5 +118,207 @@ dev_dependencies:
             const deps = await detectionService.getProjectDeps();
             (0, vitest_1.expect)(deps.size).toBe(0);
         });
+        (0, vitest_1.it)('should collect dependencies from build.gradle', async () => {
+            const mockGradle = `
+dependencies {
+    implementation 'androidx.compose.ui:ui:1.5.0'
+    api "androidx.navigation:navigation-compose:2.7.0"
+}
+`;
+            vitest_1.vi.mocked(fs_extra_1.default.readdir).mockImplementation((dir) => {
+                if (dir === process.cwd()) {
+                    return Promise.resolve([
+                        { name: 'build.gradle', isDirectory: () => false },
+                    ]);
+                }
+                return Promise.resolve([]);
+            });
+            vitest_1.vi.mocked(fs_extra_1.default.readFile).mockImplementation((path) => {
+                if (path.endsWith('build.gradle')) {
+                    return Promise.resolve(mockGradle);
+                }
+                return Promise.resolve('');
+            });
+            const deps = await detectionService.getProjectDeps();
+            (0, vitest_1.expect)(deps.has('androidx.compose.ui')).toBe(true);
+            (0, vitest_1.expect)(deps.has('androidx.navigation')).toBe(true);
+        });
+        (0, vitest_1.it)('should collect dependencies from build.gradle.kts', async () => {
+            const mockGradleKts = `
+dependencies {
+    implementation("androidx.room:room-runtime:2.5.0")
+    ksp("androidx.room:room-compiler:2.5.0")
+}
+`;
+            vitest_1.vi.mocked(fs_extra_1.default.readdir).mockImplementation((dir) => {
+                if (dir === process.cwd()) {
+                    return Promise.resolve([
+                        { name: 'build.gradle.kts', isDirectory: () => false },
+                    ]);
+                }
+                return Promise.resolve([]);
+            });
+            vitest_1.vi.mocked(fs_extra_1.default.readFile).mockImplementation((path) => {
+                if (path.endsWith('build.gradle.kts')) {
+                    return Promise.resolve(mockGradleKts);
+                }
+                return Promise.resolve('');
+            });
+            const deps = await detectionService.getProjectDeps();
+            (0, vitest_1.expect)(deps.has('androidx.room')).toBe(true);
+        });
+        (0, vitest_1.it)('should collect dependencies from recursive build.gradle files (multi-module)', async () => {
+            const mockRootGradle = `// Empty root`;
+            const mockAppGradle = `dependencies { implementation 'androidx.compose.ui:ui:1.5.0' }`;
+            vitest_1.vi.mocked(fs_extra_1.default.readdir).mockImplementation((dir) => {
+                if (dir === process.cwd()) {
+                    return Promise.resolve([
+                        { name: 'build.gradle', isDirectory: () => false },
+                        { name: 'app', isDirectory: () => true },
+                    ]);
+                }
+                if (dir.endsWith('app')) {
+                    return Promise.resolve([
+                        { name: 'build.gradle', isDirectory: () => false },
+                    ]);
+                }
+                return Promise.resolve([]);
+            });
+            vitest_1.vi.mocked(fs_extra_1.default.readFile).mockImplementation((path) => {
+                if (path.endsWith('app/build.gradle')) {
+                    return Promise.resolve(mockAppGradle);
+                }
+                return Promise.resolve(mockRootGradle);
+            });
+            const deps = await detectionService.getProjectDeps();
+            (0, vitest_1.expect)(deps.has('androidx.compose.ui')).toBe(true);
+        });
+        (0, vitest_1.it)('should collect dependencies from Version Catalogs (libs.versions.toml)', async () => {
+            const mockToml = `
+[libraries]
+retrofit = { group = "com.squareup.retrofit2", name = "retrofit", version.ref = "retrofit" }
+room-runtime = { module = "androidx.room:room-runtime", version.ref = "room" }
+`;
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockImplementation((p) => {
+                return Promise.resolve(p.endsWith('libs.versions.toml'));
+            });
+            vitest_1.vi.mocked(fs_extra_1.default.readFile).mockImplementation(() => Promise.resolve(mockToml));
+            const deps = await detectionService.getProjectDeps();
+            (0, vitest_1.expect)(deps.has('com.squareup.retrofit2')).toBe(true);
+            (0, vitest_1.expect)(deps.has('androidx.room')).toBe(true);
+        });
+        (0, vitest_1.it)('should collect dependencies from pom.xml', async () => {
+            const mockPom = `
+<project>
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+    </dependencies>
+</project>
+`;
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockImplementation((p) => {
+                return Promise.resolve(p.endsWith('pom.xml'));
+            });
+            vitest_1.vi.mocked(fs_extra_1.default.readFile).mockImplementation(() => Promise.resolve(mockPom));
+            const deps = await detectionService.getProjectDeps();
+            (0, vitest_1.expect)(deps.has('spring-boot-starter-web')).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)('detectLanguages', () => {
+        (0, vitest_1.it)('should return default languages if no detection rules defined', async () => {
+            const framework = {
+                id: 'golang',
+                name: 'Go',
+                languages: ['go'],
+                detectionFiles: ['go.mod'],
+            };
+            const langs = await detectionService.detectLanguages(framework);
+            (0, vitest_1.expect)(langs).toEqual(['go']);
+        });
+        (0, vitest_1.it)('should detect Kotlin for Spring Boot if src/main/kotlin exists', async () => {
+            const framework = {
+                id: 'spring-boot',
+                name: 'Spring Boot',
+                languages: ['java', 'kotlin'],
+                detectionFiles: ['pom.xml'],
+                languageDetection: {
+                    kotlin: ['src/main/kotlin'],
+                    java: ['src/main/java'],
+                },
+            };
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockImplementation((p) => {
+                return Promise.resolve(p.endsWith('src/main/kotlin'));
+            });
+            const langs = await detectionService.detectLanguages(framework);
+            (0, vitest_1.expect)(langs).toEqual(['kotlin']);
+        });
+        (0, vitest_1.it)('should detect Java for Spring Boot if src/main/java exists', async () => {
+            const framework = {
+                id: 'spring-boot',
+                name: 'Spring Boot',
+                languages: ['java', 'kotlin'],
+                detectionFiles: ['pom.xml'],
+                languageDetection: {
+                    kotlin: ['src/main/kotlin'],
+                    java: ['src/main/java'],
+                },
+            };
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockImplementation((p) => {
+                return Promise.resolve(p.endsWith('src/main/java'));
+            });
+            const langs = await detectionService.detectLanguages(framework);
+            (0, vitest_1.expect)(langs).toEqual(['java']);
+        });
+        (0, vitest_1.it)('should return all default languages if no language-specific files found', async () => {
+            const framework = {
+                id: 'spring-boot',
+                name: 'Spring Boot',
+                languages: ['java', 'kotlin'],
+                detectionFiles: ['pom.xml'],
+                languageDetection: {
+                    kotlin: ['src/main/kotlin'],
+                    java: ['src/main/java'],
+                },
+            };
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockResolvedValue();
+            const langs = await detectionService.detectLanguages(framework);
+            (0, vitest_1.expect)(langs).toEqual(['java', 'kotlin']);
+        });
+        (0, vitest_1.it)('should detect TypeScript for NestJS if tsconfig.json exists', async () => {
+            const framework = {
+                id: 'nestjs',
+                name: 'NestJS',
+                languages: ['typescript', 'javascript'],
+                detectionFiles: ['nest-cli.json'],
+                languageDetection: {
+                    typescript: ['tsconfig.json'],
+                    javascript: ['jsconfig.json'],
+                },
+            };
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockImplementation((p) => {
+                return Promise.resolve(p.endsWith('tsconfig.json'));
+            });
+            const langs = await detectionService.detectLanguages(framework);
+            (0, vitest_1.expect)(langs).toEqual(['typescript']);
+        });
+        (0, vitest_1.it)('should detect JavaScript for NestJS if jsconfig.json exists', async () => {
+            const framework = {
+                id: 'nestjs',
+                name: 'NestJS',
+                languages: ['typescript', 'javascript'],
+                detectionFiles: ['nest-cli.json'],
+                languageDetection: {
+                    typescript: ['tsconfig.json'],
+                    javascript: ['jsconfig.json'],
+                },
+            };
+            vitest_1.vi.mocked(fs_extra_1.default.pathExists).mockImplementation((p) => {
+                return Promise.resolve(p.endsWith('jsconfig.json'));
+            });
+            const langs = await detectionService.detectLanguages(framework);
+            (0, vitest_1.expect)(langs).toEqual(['javascript']);
+        });
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-skills-standard",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "A CLI to manage and sync AI agent skills standard for Cursor, Claude, Copilot, Windsurf, and more.",
   "main": "dist/index.js",
   "bin": {