@skillsmith/core 0.5.5 → 0.5.6

package/dist/indexer/GitHubIndexer.js

@@ -0,0 +1,215 @@
+/**
+ * SMI-628: GitHubIndexer - Fetches skill repositories from GitHub
+ *
+ * Provides:
+ * - Search GitHub for claude code skill repositories
+ * - Rate limit handling
+ * - Repository metadata extraction
+ */
+const DEFAULT_TOPICS = ['claude-code-skill', 'claude-code', 'anthropic-claude', 'claude-skill'];
+/**
+ * Indexes skill repositories from GitHub
+ */
+export class GitHubIndexer {
+    token;
+    perPage;
+    requestDelay;
+    topics;
+    constructor(options = {}) {
+        this.token = options.token;
+        this.perPage = options.perPage ?? 30;
+        this.requestDelay = options.requestDelay ?? 150;
+        this.topics = options.topics ?? DEFAULT_TOPICS;
+    }
+    /**
+     * Delay between API calls to avoid rate limiting
+     */
+    async delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Build GitHub API headers
+     */
+    buildHeaders() {
+        const headers = {
+            Accept: 'application/vnd.github.v3+json',
+            'User-Agent': 'skillsmith-indexer/1.0',
+        };
+        if (this.token) {
+            headers.Authorization = `Bearer ${this.token}`;
+        }
+        return headers;
+    }
+    /**
+     * Search GitHub for repositories by topic or query
+     */
+    async searchRepositories(query, page = 1) {
+        const result = {
+            found: 0,
+            indexed: 0,
+            failed: 0,
+            errors: [],
+            repositories: [],
+        };
+        try {
+            const searchQuery = encodeURIComponent(query);
+            const url = `https://api.github.com/search/repositories?q=${searchQuery}&per_page=${this.perPage}&page=${page}`;
+            const response = await fetch(url, {
+                headers: this.buildHeaders(),
+            });
+            if (!response.ok) {
+                if (response.status === 403) {
+                    result.errors.push('GitHub API rate limit exceeded');
+                }
+                else {
+                    result.errors.push(`GitHub API error: ${response.status}`);
+                }
+                result.failed = 1;
+                return result;
+            }
+            const data = (await response.json());
+            result.found = data.total_count;
+            for (const item of data.items) {
+                try {
+                    const repo = {
+                        owner: item.owner.login,
+                        name: item.name,
+                        fullName: item.full_name,
+                        description: item.description,
+                        url: item.html_url,
+                        stars: item.stargazers_count,
+                        forks: item.forks_count,
+                        topics: item.topics || [],
+                        updatedAt: item.updated_at,
+                        defaultBranch: item.default_branch,
+                    };
+                    result.repositories.push(repo);
+                    result.indexed++;
+                }
+                catch (error) {
+                    result.failed++;
+                    result.errors.push(`Failed to parse repository ${item.full_name}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                }
+            }
+            await this.delay(this.requestDelay);
+        }
+        catch (error) {
+            result.errors.push(`Network error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            result.failed = 1;
+        }
+        return result;
+    }
+    /**
+     * Index all configured topics
+     */
+    async indexAllTopics(maxPagesPerTopic = 3) {
+        const result = {
+            found: 0,
+            indexed: 0,
+            failed: 0,
+            errors: [],
+            repositories: [],
+        };
+        const seenUrls = new Set();
+        for (const topic of this.topics) {
+            for (let page = 1; page <= maxPagesPerTopic; page++) {
+                const query = `topic:${topic}`;
+                const pageResult = await this.searchRepositories(query, page);
+                result.found += pageResult.found;
+                result.errors.push(...pageResult.errors);
+                for (const repo of pageResult.repositories) {
+                    if (!seenUrls.has(repo.url)) {
+                        seenUrls.add(repo.url);
+                        result.repositories.push(repo);
+                        result.indexed++;
+                    }
+                }
+                result.failed += pageResult.failed;
+                // Break if we've fetched all results for this topic
+                if (pageResult.repositories.length < this.perPage) {
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Index repositories by first letter filter (A-F, G-L, etc.)
+     */
+    async indexByLetterRange(startLetter, endLetter, maxPages = 3) {
+        const result = {
+            found: 0,
+            indexed: 0,
+            failed: 0,
+            errors: [],
+            repositories: [],
+        };
+        const seenUrls = new Set();
+        for (const topic of this.topics) {
+            for (let page = 1; page <= maxPages; page++) {
+                const query = `topic:${topic}`;
+                const pageResult = await this.searchRepositories(query, page);
+                result.found += pageResult.found;
+                result.errors.push(...pageResult.errors);
+                for (const repo of pageResult.repositories) {
+                    const firstLetter = repo.name.charAt(0).toUpperCase();
+                    if (firstLetter >= startLetter.toUpperCase() && firstLetter <= endLetter.toUpperCase()) {
+                        if (!seenUrls.has(repo.url)) {
+                            seenUrls.add(repo.url);
+                            result.repositories.push(repo);
+                            result.indexed++;
+                        }
+                    }
+                }
+                result.failed += pageResult.failed;
+                if (pageResult.repositories.length < this.perPage) {
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Convert GitHub repository to SkillCreateInput
+     */
+    repositoryToSkill(repo) {
+        // Feature flag: SKILLSMITH_LOG_QUALITY_SCORE controls formula
+        // Robust comparison: trim whitespace and lowercase
+        const flagRaw = process.env.SKILLSMITH_LOG_QUALITY_SCORE;
+        const useLogScale = flagRaw?.trim().toLowerCase() === 'true';
+        let starScore;
+        let forkScore;
+        if (useLogScale) {
+            // Logarithmic scale for better distribution across wide star/fork ranges
+            starScore = Math.min(Math.log10(repo.stars + 1) * 15, 50);
+            forkScore = Math.min(Math.log10(repo.forks + 1) * 10, 25);
+        }
+        else {
+            // Linear scale (default) - saturates at 500 stars / 125 forks
+            starScore = Math.min(repo.stars / 10, 50);
+            forkScore = Math.min(repo.forks / 5, 25);
+        }
+        const qualityScore = (starScore + forkScore + 25) / 100; // Normalize to 0-1
+        // Determine trust tier based on indicators
+        let trustTier = 'unknown';
+        if (repo.topics.includes('claude-code-official')) {
+            trustTier = 'verified';
+        }
+        else if (repo.stars >= 50) {
+            trustTier = 'community';
+        }
+        else if (repo.stars >= 5) {
+            trustTier = 'experimental';
+        }
+        return {
+            name: repo.name,
+            description: repo.description,
+            author: repo.owner,
+            repoUrl: repo.url,
+            qualityScore,
+            trustTier,
+            tags: repo.topics,
+        };
+    }
+}
+//# sourceMappingURL=GitHubIndexer.js.map

package/dist/indexer/GitHubIndexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubIndexer.js","sourceRoot":"","sources":["../../src/indexer/GitHubIndexer.ts"],"names":[],"mappings":"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"}

package/dist/indexer/PartitionStrategy.d.ts

@@ -0,0 +1,115 @@
+/**
+ * SMI-643: PartitionStrategy - Load balancing for parallel repository indexing
+ *
+ * Provides:
+ * - Partition repositories by letter range (A-F, G-L, M-R, S-Z)
+ * - Load balancing across workers
+ * - Handle uneven distributions
+ */
+import type { GitHubRepository } from './GitHubIndexer.js';
+/**
+ * A partition of repositories for a worker
+ */
+export interface Partition {
+    /** Unique partition identifier */
+    id: string;
+    /** Start letter for this partition (inclusive) */
+    startLetter: string;
+    /** End letter for this partition (inclusive) */
+    endLetter: string;
+    /** Letter pattern description (e.g., "A-F") */
+    range: string;
+    /** Repositories assigned to this partition */
+    repositories: GitHubRepository[];
+}
+/**
+ * Options for partitioning strategy
+ */
+export interface PartitionOptions {
+    /** Number of partitions to create (default: 4) */
+    partitionCount?: number;
+    /** Custom partition ranges (overrides partitionCount) */
+    customRanges?: Array<{
+        start: string;
+        end: string;
+    }>;
+}
+/**
+ * Default letter ranges for 4-way partitioning
+ */
+export declare const DEFAULT_PARTITION_RANGES: Array<{
+    start: string;
+    end: string;
+}>;
+/**
+ * Partition strategy for distributing repositories across workers
+ */
+export declare class PartitionStrategy {
+    private ranges;
+    constructor(options?: PartitionOptions);
+    /**
+     * Generate balanced letter ranges for any partition count
+     */
+    private generateRanges;
+    /**
+     * Get the partition ranges
+     */
+    getRanges(): Array<{
+        start: string;
+        end: string;
+    }>;
+    /**
+     * Get empty partitions for workers to fill
+     */
+    createEmptyPartitions(): Partition[];
+    /**
+     * Check if a repository name belongs to a specific partition
+     */
+    belongsToPartition(repoName: string, partition: Partition): boolean;
+    /**
+     * Assign a single repository to the appropriate partition
+     */
+    assignToPartition(repo: GitHubRepository, partitions: Partition[]): Partition | null;
+    /**
+     * Partition a list of repositories across all partitions
+     */
+    partitionRepositories(repositories: GitHubRepository[]): Partition[];
+    /**
+     * Get partition statistics for load balancing analysis
+     */
+    getPartitionStats(partitions: Partition[]): PartitionStats;
+    /**
+     * Rebalance partitions by redistributing excess repositories
+     */
+    rebalancePartitions(partitions: Partition[]): Partition[];
+}
+/**
+ * Statistics about partition distribution
+ */
+export interface PartitionStats {
+    partitionCount: number;
+    totalRepositories: number;
+    averagePerPartition: number;
+    minSize: number;
+    maxSize: number;
+    imbalanceRatio: number;
+    isBalanced: boolean;
+    distribution: Array<{
+        id: string;
+        range: string;
+        count: number;
+        percentage: number;
+    }>;
+}
+/**
+ * Create a default partition strategy with 4 workers
+ */
+export declare function createDefaultStrategy(): PartitionStrategy;
+/**
+ * Create a custom partition strategy
+ */
+export declare function createCustomStrategy(ranges: Array<{
+    start: string;
+    end: string;
+}>): PartitionStrategy;
+//# sourceMappingURL=PartitionStrategy.d.ts.map

package/dist/indexer/PartitionStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartitionStrategy.d.ts","sourceRoot":"","sources":["../../src/indexer/PartitionStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,YAAY,EAAE,gBAAgB,EAAE,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrD;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAK1E,CAAA;AAiCD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAuC;gBAEzC,OAAO,GAAE,gBAAqB;IAS1C;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,SAAS,IAAI,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlD;;OAEG;IACH,qBAAqB,IAAI,SAAS,EAAE;IAUpC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO;IAgBnE;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI;IAWpF;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAAE;IAapE;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,cAAc;IAyB1D;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE;CAkC1D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;CACH;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAEzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5C,iBAAiB,CAEnB"}

package/dist/indexer/PartitionStrategy.js

@@ -0,0 +1,207 @@
+/**
+ * SMI-643: PartitionStrategy - Load balancing for parallel repository indexing
+ *
+ * Provides:
+ * - Partition repositories by letter range (A-F, G-L, M-R, S-Z)
+ * - Load balancing across workers
+ * - Handle uneven distributions
+ */
+/**
+ * Default letter ranges for 4-way partitioning
+ */
+export const DEFAULT_PARTITION_RANGES = [
+    { start: 'A', end: 'F' },
+    { start: 'G', end: 'L' },
+    { start: 'M', end: 'R' },
+    { start: 'S', end: 'Z' },
+];
+/**
+ * Handles letter distribution with approximately equal splits
+ */
+const LETTER_GROUPS = {
+    2: [
+        { start: 'A', end: 'L' },
+        { start: 'M', end: 'Z' },
+    ],
+    3: [
+        { start: 'A', end: 'H' },
+        { start: 'I', end: 'Q' },
+        { start: 'R', end: 'Z' },
+    ],
+    4: DEFAULT_PARTITION_RANGES,
+    5: [
+        { start: 'A', end: 'E' },
+        { start: 'F', end: 'J' },
+        { start: 'K', end: 'O' },
+        { start: 'P', end: 'T' },
+        { start: 'U', end: 'Z' },
+    ],
+    6: [
+        { start: 'A', end: 'D' },
+        { start: 'E', end: 'H' },
+        { start: 'I', end: 'L' },
+        { start: 'M', end: 'P' },
+        { start: 'Q', end: 'T' },
+        { start: 'U', end: 'Z' },
+    ],
+};
+/**
+ * Partition strategy for distributing repositories across workers
+ */
+export class PartitionStrategy {
+    ranges;
+    constructor(options = {}) {
+        if (options.customRanges && options.customRanges.length > 0) {
+            this.ranges = options.customRanges;
+        }
+        else {
+            const count = options.partitionCount ?? 4;
+            this.ranges = LETTER_GROUPS[count] ?? this.generateRanges(count);
+        }
+    }
+    /**
+     * Generate balanced letter ranges for any partition count
+     */
+    generateRanges(count) {
+        const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+        const lettersPerPartition = Math.ceil(26 / count);
+        const ranges = [];
+        for (let i = 0; i < count; i++) {
+            const startIdx = i * lettersPerPartition;
+            const endIdx = Math.min((i + 1) * lettersPerPartition - 1, 25);
+            if (startIdx <= 25) {
+                ranges.push({
+                    start: ALPHABET[startIdx],
+                    end: ALPHABET[endIdx],
+                });
+            }
+        }
+        return ranges;
+    }
+    /**
+     * Get the partition ranges
+     */
+    getRanges() {
+        return [...this.ranges];
+    }
+    /**
+     * Get empty partitions for workers to fill
+     */
+    createEmptyPartitions() {
+        return this.ranges.map((range, index) => ({
+            id: `partition-${index}`,
+            startLetter: range.start,
+            endLetter: range.end,
+            range: `${range.start}-${range.end}`,
+            repositories: [],
+        }));
+    }
+    /**
+     * Check if a repository name belongs to a specific partition
+     */
+    belongsToPartition(repoName, partition) {
+        if (!repoName || repoName.length === 0) {
+            return false;
+        }
+        const firstLetter = repoName.charAt(0).toUpperCase();
+        // Handle non-alphabetic first characters
+        if (!/[A-Z]/.test(firstLetter)) {
+            // Assign numeric/special char repos to first partition
+            return partition.id === 'partition-0';
+        }
+        return firstLetter >= partition.startLetter && firstLetter <= partition.endLetter;
+    }
+    /**
+     * Assign a single repository to the appropriate partition
+     */
+    assignToPartition(repo, partitions) {
+        for (const partition of partitions) {
+            if (this.belongsToPartition(repo.name, partition)) {
+                return partition;
+            }
+        }
+        // Fallback: assign to first partition
+        return partitions.length > 0 ? partitions[0] : null;
+    }
+    /**
+     * Partition a list of repositories across all partitions
+     */
+    partitionRepositories(repositories) {
+        const partitions = this.createEmptyPartitions();
+        for (const repo of repositories) {
+            const partition = this.assignToPartition(repo, partitions);
+            if (partition) {
+                partition.repositories.push(repo);
+            }
+        }
+        return partitions;
+    }
+    /**
+     * Get partition statistics for load balancing analysis
+     */
+    getPartitionStats(partitions) {
+        const sizes = partitions.map((p) => p.repositories.length);
+        const total = sizes.reduce((a, b) => a + b, 0);
+        const average = total / partitions.length;
+        const min = Math.min(...sizes);
+        const max = Math.max(...sizes);
+        const imbalance = max > 0 ? (max - min) / max : 0;
+        return {
+            partitionCount: partitions.length,
+            totalRepositories: total,
+            averagePerPartition: average,
+            minSize: min,
+            maxSize: max,
+            imbalanceRatio: imbalance,
+            isBalanced: imbalance < 0.3, // Less than 30% imbalance is considered balanced
+            distribution: partitions.map((p) => ({
+                id: p.id,
+                range: p.range,
+                count: p.repositories.length,
+                percentage: total > 0 ? (p.repositories.length / total) * 100 : 0,
+            })),
+        };
+    }
+    /**
+     * Rebalance partitions by redistributing excess repositories
+     */
+    rebalancePartitions(partitions) {
+        const stats = this.getPartitionStats(partitions);
+        // Already balanced, no need to rebalance
+        if (stats.isBalanced) {
+            return partitions;
+        }
+        // Collect all repositories
+        const allRepos = [];
+        for (const partition of partitions) {
+            allRepos.push(...partition.repositories);
+        }
+        // Sort by name for consistent redistribution
+        allRepos.sort((a, b) => a.name.localeCompare(b.name));
+        // Redistribute evenly
+        const rebalanced = this.createEmptyPartitions();
+        const targetSize = Math.ceil(allRepos.length / rebalanced.length);
+        let currentPartitionIdx = 0;
+        for (const repo of allRepos) {
+            if (rebalanced[currentPartitionIdx].repositories.length >= targetSize &&
+                currentPartitionIdx < rebalanced.length - 1) {
+                currentPartitionIdx++;
+            }
+            rebalanced[currentPartitionIdx].repositories.push(repo);
+        }
+        return rebalanced;
+    }
+}
+/**
+ * Create a default partition strategy with 4 workers
+ */
+export function createDefaultStrategy() {
+    return new PartitionStrategy({ partitionCount: 4 });
+}
+/**
+ * Create a custom partition strategy
+ */
+export function createCustomStrategy(ranges) {
+    return new PartitionStrategy({ customRanges: ranges });
+}
+//# sourceMappingURL=PartitionStrategy.js.map

package/dist/indexer/PartitionStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartitionStrategy.js","sourceRoot":"","sources":["../../src/indexer/PartitionStrategy.ts"],"names":[],"mappings":"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"}

package/dist/indexer/SkillParser.coverage.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SMI-4285: SkillParser coverage gaps — type-validation branches + unicode.
+ *
+ * Lives in a sidecar (not SkillParser.test.ts) to stay under the 500-line gate.
+ * Split rationale: these tests exercise boundary behaviors — YAML-parser bypass
+ * (direct validate() calls with typed-wrong objects) and non-ASCII inputs —
+ * that are orthogonal to the main suite's functional coverage.
+ */
+export {};
+//# sourceMappingURL=SkillParser.coverage.test.d.ts.map

package/dist/indexer/SkillParser.coverage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillParser.coverage.test.d.ts","sourceRoot":"","sources":["../../src/indexer/SkillParser.coverage.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/indexer/SkillParser.coverage.test.js

@@ -0,0 +1,76 @@
+/**
+ * SMI-4285: SkillParser coverage gaps — type-validation branches + unicode.
+ *
+ * Lives in a sidecar (not SkillParser.test.ts) to stay under the 500-line gate.
+ * Split rationale: these tests exercise boundary behaviors — YAML-parser bypass
+ * (direct validate() calls with typed-wrong objects) and non-ASCII inputs —
+ * that are orthogonal to the main suite's functional coverage.
+ */
+import { describe, it, expect } from 'vitest';
+import SkillParser from './SkillParser.js';
+function makeSkillMd(frontmatter, body = '# My Skill\n\nDoes things.') {
+    return `---\n${frontmatter}\n---\n\n${body}`;
+}
+// ---------------------------------------------------------------------------
+// Unicode coverage — description and tags (name is covered in SkillParser.test.ts)
+// ---------------------------------------------------------------------------
+describe('SkillParser.extractFrontmatter — unicode', () => {
+    const parser = new SkillParser();
+    it('preserves unicode characters in description values', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ndescription: "これはスキル"'));
+        expect(result?.description).toBe('これはスキル');
+    });
+    it('preserves unicode characters in tag values', () => {
+        const result = parser.extractFrontmatter(makeSkillMd('name: x\ntags:\n  - 日本語\n  - 中文\n  - ไทย'));
+        expect(result?.tags).toEqual(['日本語', '中文', 'ไทย']);
+    });
+});
+// ---------------------------------------------------------------------------
+// validate() type-validation branches
+//
+// These cannot be reached via extractFrontmatter — the YAML parser coerces
+// scalars (e.g. `name: 123` becomes the string "123" via the String(parsed.name)
+// call at SkillParser.ts:264-266). Call validate() directly with a typed-wrong
+// object to exercise the `typeof !== 'string'` branches at SkillParser.ts:291-309.
+// ---------------------------------------------------------------------------
+describe('SkillParser.validate — type-validation branches', () => {
+    const parser = new SkillParser();
+    it('errors when name is not a string', () => {
+        const result = parser.validate({ name: 123 });
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Field "name" must be a string');
+    });
+    it('errors when description is not a string', () => {
+        const result = parser.validate({
+            name: 'x',
+            description: 123,
+        });
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Field "description" must be a string');
+    });
+    it('errors when author is not a string', () => {
+        const result = parser.validate({
+            name: 'x',
+            author: true,
+        });
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Field "author" must be a string');
+    });
+    it('errors when version is not a string', () => {
+        const result = parser.validate({
+            name: 'x',
+            version: ['1', '0', '0'],
+        });
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Field "version" must be a string');
+    });
+    it('errors when tags is not an array', () => {
+        const result = parser.validate({
+            name: 'x',
+            tags: 'typescript,testing',
+        });
+        expect(result.valid).toBe(false);
+        expect(result.errors).toContain('Field "tags" must be an array');
+    });
+});
+//# sourceMappingURL=SkillParser.coverage.test.js.map

package/dist/indexer/SkillParser.coverage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillParser.coverage.test.js","sourceRoot":"","sources":["../../src/indexer/SkillParser.coverage.test.ts"],"names":[],"mappings":"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"}