@bradygaster/squad-sdk 0.6.2 → 0.8.0

package/dist/sharing/import.js

@@ -0,0 +1,138 @@
+/**
+ * M5-2: Import command (squad import)
+ * Imports a Squad configuration bundle into a target project.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+/**
+ * Deserialize a bundle string (JSON or YAML-like) into an ExportBundle.
+ */
+export function deserializeBundle(content) {
+    const trimmed = content.trim();
+    // Try JSON first
+    if (trimmed.startsWith('{')) {
+        return JSON.parse(trimmed);
+    }
+    // Minimal: only JSON is fully supported for import
+    throw new Error('Only JSON format is supported for import');
+}
+/**
+ * Validate an ExportBundle for structural correctness.
+ */
+export function validateBundle(bundle) {
+    const errors = [];
+    if (!bundle.metadata) {
+        errors.push({ field: 'metadata', message: 'Missing metadata' });
+    }
+    else {
+        if (!bundle.metadata.version) {
+            errors.push({ field: 'metadata.version', message: 'Missing version in metadata' });
+        }
+        if (!bundle.metadata.timestamp) {
+            errors.push({ field: 'metadata.timestamp', message: 'Missing timestamp in metadata' });
+        }
+    }
+    if (!bundle.agents || !Array.isArray(bundle.agents)) {
+        errors.push({ field: 'agents', message: 'Missing or invalid agents array' });
+    }
+    else {
+        for (let i = 0; i < bundle.agents.length; i++) {
+            const agent = bundle.agents[i];
+            if (!agent.name)
+                errors.push({ field: `agents[${i}].name`, message: 'Agent missing name' });
+            if (!agent.content)
+                errors.push({ field: `agents[${i}].content`, message: 'Agent missing content' });
+        }
+    }
+    if (!bundle.routingRules || !Array.isArray(bundle.routingRules)) {
+        errors.push({ field: 'routingRules', message: 'Missing or invalid routingRules array' });
+    }
+    if (bundle.config === undefined || bundle.config === null) {
+        errors.push({ field: 'config', message: 'Missing config' });
+    }
+    return errors;
+}
+/**
+ * Import a Squad configuration bundle into a target directory.
+ */
+export function importSquadConfig(bundlePath, targetDir, options) {
+    const opts = {
+        merge: options?.merge ?? true,
+        dryRun: options?.dryRun ?? false,
+        skipValidation: options?.skipValidation ?? false,
+    };
+    const warnings = [];
+    const changes = [];
+    // Read and parse bundle
+    if (!existsSync(bundlePath)) {
+        return { success: false, changes: [], warnings: [`Bundle file not found: ${bundlePath}`] };
+    }
+    let bundle;
+    try {
+        const content = readFileSync(bundlePath, 'utf-8');
+        bundle = deserializeBundle(content);
+    }
+    catch (err) {
+        return { success: false, changes: [], warnings: [`Failed to parse bundle: ${err.message}`] };
+    }
+    // Validate
+    if (!opts.skipValidation) {
+        const validationErrors = validateBundle(bundle);
+        if (validationErrors.length > 0) {
+            return {
+                success: false,
+                changes: [],
+                warnings: validationErrors.map(e => `${e.field}: ${e.message}`),
+            };
+        }
+    }
+    // Import agents
+    const agentsDir = join(targetDir, '.github', 'agents');
+    for (const agent of bundle.agents) {
+        const agentPath = join(agentsDir, `${agent.name}.agent.md`);
+        const relativePath = `.github/agents/${agent.name}.agent.md`;
+        if (existsSync(agentPath) && !opts.merge) {
+            changes.push({ type: 'skipped', path: relativePath, reason: 'File exists and merge is disabled' });
+            continue;
+        }
+        if (existsSync(agentPath) && opts.merge) {
+            if (!opts.dryRun) {
+                writeFileSync(agentPath, agent.content, 'utf-8');
+            }
+            changes.push({ type: 'modified', path: relativePath });
+        }
+        else {
+            if (!opts.dryRun) {
+                mkdirSync(dirname(agentPath), { recursive: true });
+                writeFileSync(agentPath, agent.content, 'utf-8');
+            }
+            changes.push({ type: 'added', path: relativePath });
+        }
+    }
+    // Import routing rules
+    if (bundle.routingRules.length > 0) {
+        const routingPath = join(targetDir, '.ai-team', 'routing.md');
+        const relativePath = '.ai-team/routing.md';
+        const routingContent = formatRoutingRules(bundle.routingRules);
+        if (existsSync(routingPath) && !opts.merge) {
+            changes.push({ type: 'skipped', path: relativePath, reason: 'File exists and merge is disabled' });
+        }
+        else {
+            if (!opts.dryRun) {
+                mkdirSync(dirname(routingPath), { recursive: true });
+                writeFileSync(routingPath, routingContent, 'utf-8');
+            }
+            changes.push({ type: existsSync(routingPath) ? 'modified' : 'added', path: relativePath });
+        }
+    }
+    return { success: true, changes, warnings };
+}
+function formatRoutingRules(rules) {
+    const lines = ['# Routing Rules', ''];
+    for (const rule of rules) {
+        lines.push(`- \`${rule.pattern}\` → ${rule.agent}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=import.js.map

package/dist/sharing/import.js.map

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

package/dist/sharing/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sharing module exports — export, import, history splitting, versioning, caching, conflicts
+ */
+export * from './export.js';
+export * from './import.js';
+export * from './history-split.js';
+export * from './versioning.js';
+export * from './agent-repo.js';
+export * from './cache.js';
+export * from './conflicts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sharing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sharing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/sharing/index.js

@@ -0,0 +1,11 @@
+/**
+ * Sharing module exports — export, import, history splitting, versioning, caching, conflicts
+ */
+export * from './export.js';
+export * from './import.js';
+export * from './history-split.js';
+export * from './versioning.js';
+export * from './agent-repo.js';
+export * from './cache.js';
+export * from './conflicts.js';
+//# sourceMappingURL=index.js.map

package/dist/sharing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sharing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/sharing/versioning.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Agent Versioning — commit SHA pinning (M5-6, Issue #129)
+ */
+import type { AgentDefinition } from '../config/agent-source.js';
+export interface VersionPin {
+    agentId: string;
+    sha: string;
+    timestamp: number;
+    source: 'local' | 'github';
+}
+export interface VersionDiff {
+    agentId: string;
+    from: VersionPin;
+    to: VersionPin;
+    fields: string[];
+}
+/** Resolver callback: given agentId + SHA, return the agent at that version. */
+export type AgentVersionResolver = (agentId: string, sha: string) => Promise<AgentDefinition | null>;
+/** Pin an agent to a specific commit SHA. */
+export declare function pinAgentVersion(agentId: string, sha: string, source?: 'local' | 'github'): VersionPin;
+/**
+ * Resolve a version pin to an agent definition.
+ * "latest" SHA resolves via the headResolver callback.
+ */
+export declare function resolveVersion(pin: VersionPin, resolver: AgentVersionResolver, headResolver?: (agentId: string) => Promise<string>): Promise<AgentDefinition | null>;
+/** Compare two version pins and return a diff summary. */
+export declare function compareAgentVersions(a: VersionPin, b: VersionPin, resolver: AgentVersionResolver): Promise<VersionDiff>;
+/** Get the full version history for an agent. */
+export declare function getVersionHistory(agentId: string): VersionPin[];
+/** Clear all stored version pins (useful in tests). */
+export declare function clearVersionStore(): void;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/sharing/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/sharing/versioning.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAIjE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;AAQrG,6CAA6C;AAC7C,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,GAAG,QAAkB,GACnC,UAAU,CAWZ;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,oBAAoB,EAC9B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAClD,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOjC;AAED,0DAA0D;AAC1D,wBAAsB,oBAAoB,CACxC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,EACb,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAE/D;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/sharing/versioning.js

@@ -0,0 +1,64 @@
+/**
+ * Agent Versioning — commit SHA pinning (M5-6, Issue #129)
+ */
+// --- In-memory version store ---
+const versionStore = new Map();
+// --- Public API ---
+/** Pin an agent to a specific commit SHA. */
+export function pinAgentVersion(agentId, sha, source = 'local') {
+    const pin = {
+        agentId,
+        sha,
+        timestamp: Date.now(),
+        source,
+    };
+    const existing = versionStore.get(agentId) ?? [];
+    existing.push(pin);
+    versionStore.set(agentId, existing);
+    return pin;
+}
+/**
+ * Resolve a version pin to an agent definition.
+ * "latest" SHA resolves via the headResolver callback.
+ */
+export async function resolveVersion(pin, resolver, headResolver) {
+    let sha = pin.sha;
+    if (sha === 'latest') {
+        if (!headResolver)
+            return null;
+        sha = await headResolver(pin.agentId);
+    }
+    return resolver(pin.agentId, sha);
+}
+/** Compare two version pins and return a diff summary. */
+export async function compareAgentVersions(a, b, resolver) {
+    const agentA = await resolver(a.agentId, a.sha);
+    const agentB = await resolver(b.agentId, b.sha);
+    const fields = [];
+    if (agentA && agentB) {
+        const keys = ['name', 'role', 'charter', 'model', 'source'];
+        for (const key of keys) {
+            if (agentA[key] !== agentB[key])
+                fields.push(key);
+        }
+        if (JSON.stringify(agentA.tools) !== JSON.stringify(agentB.tools))
+            fields.push('tools');
+        if (JSON.stringify(agentA.skills) !== JSON.stringify(agentB.skills))
+            fields.push('skills');
+        if (agentA.history !== agentB.history)
+            fields.push('history');
+    }
+    else {
+        fields.push('__unresolvable__');
+    }
+    return { agentId: a.agentId, from: a, to: b, fields };
+}
+/** Get the full version history for an agent. */
+export function getVersionHistory(agentId) {
+    return [...(versionStore.get(agentId) ?? [])];
+}
+/** Clear all stored version pins (useful in tests). */
+export function clearVersionStore() {
+    versionStore.clear();
+}
+//# sourceMappingURL=versioning.js.map

package/dist/sharing/versioning.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skills System (M3-3, Issue #141)
+ *
+ * Domain-specific knowledge packages that agents load on-demand.
+ * Skills are matched by keyword triggers and agent role affinity,
+ * then injected into agent context as markdown.
+ */
+import type { SkillDefinition } from './skill-loader.js';
+export { loadSkillsFromDirectory, parseFrontmatter, parseSkillFile } from './skill-loader.js';
+export type { SkillDefinition } from './skill-loader.js';
+export * from './skill-source.js';
+export interface SkillMatch {
+    /** The matched skill */
+    skill: SkillDefinition;
+    /** Relevance score (0–1) */
+    score: number;
+    /** Reason the skill matched */
+    reason: string;
+}
+export declare class SkillRegistry {
+    private skills;
+    /** Register a skill definition. */
+    registerSkill(skill: SkillDefinition): void;
+    /** Unregister a skill by ID. */
+    unregisterSkill(skillId: string): boolean;
+    /** Get a skill by ID. */
+    getSkill(skillId: string): SkillDefinition | undefined;
+    /** Get all registered skills. */
+    getAllSkills(): SkillDefinition[];
+    /** Number of registered skills. */
+    get size(): number;
+    /**
+     * Match skills relevant to a task for a given agent role.
+     *
+     * Scoring:
+     *  - +0.5 for each trigger keyword found in the task text
+     *  - +0.3 if the agent role matches the skill's agentRoles
+     *  - Scores are clamped to [0, 1]
+     *
+     * Returns matches sorted by score descending, filtered to score > 0.
+     */
+    matchSkills(task: string, agentRole: string): SkillMatch[];
+    /**
+     * Load a skill's content for injection into an agent's context.
+     * Returns the markdown content, or undefined if skill not found.
+     */
+    loadSkill(skillId: string): string | undefined;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9F,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,cAAc,mBAAmB,CAAC;AAIlC,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,KAAK,EAAE,eAAe,CAAC;IACvB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA2C;IAEzD,mCAAmC;IACnC,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI3C,gCAAgC;IAChC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIzC,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAItD,iCAAiC;IACjC,YAAY,IAAI,eAAe,EAAE;IAIjC,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;OASG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IA0C1D;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG/C"}

package/dist/skills/index.js

@@ -0,0 +1,85 @@
+/**
+ * Skills System (M3-3, Issue #141)
+ *
+ * Domain-specific knowledge packages that agents load on-demand.
+ * Skills are matched by keyword triggers and agent role affinity,
+ * then injected into agent context as markdown.
+ */
+export { loadSkillsFromDirectory, parseFrontmatter, parseSkillFile } from './skill-loader.js';
+export * from './skill-source.js';
+// --- Skill Registry ---
+export class SkillRegistry {
+    skills = new Map();
+    /** Register a skill definition. */
+    registerSkill(skill) {
+        this.skills.set(skill.id, skill);
+    }
+    /** Unregister a skill by ID. */
+    unregisterSkill(skillId) {
+        return this.skills.delete(skillId);
+    }
+    /** Get a skill by ID. */
+    getSkill(skillId) {
+        return this.skills.get(skillId);
+    }
+    /** Get all registered skills. */
+    getAllSkills() {
+        return Array.from(this.skills.values());
+    }
+    /** Number of registered skills. */
+    get size() {
+        return this.skills.size;
+    }
+    /**
+     * Match skills relevant to a task for a given agent role.
+     *
+     * Scoring:
+     *  - +0.5 for each trigger keyword found in the task text
+     *  - +0.3 if the agent role matches the skill's agentRoles
+     *  - Scores are clamped to [0, 1]
+     *
+     * Returns matches sorted by score descending, filtered to score > 0.
+     */
+    matchSkills(task, agentRole) {
+        const lowerTask = task.toLowerCase();
+        const matches = [];
+        for (const skill of this.skills.values()) {
+            let score = 0;
+            const reasons = [];
+            // Trigger keyword matching
+            const hitTriggers = [];
+            for (const trigger of skill.triggers) {
+                if (lowerTask.includes(trigger.toLowerCase())) {
+                    hitTriggers.push(trigger);
+                }
+            }
+            if (hitTriggers.length > 0) {
+                score += Math.min(hitTriggers.length * 0.5, 0.7);
+                reasons.push(`triggers: ${hitTriggers.join(', ')}`);
+            }
+            // Agent role affinity
+            if (skill.agentRoles.length > 0 &&
+                skill.agentRoles.some((r) => r.toLowerCase() === agentRole.toLowerCase())) {
+                score += 0.3;
+                reasons.push(`role affinity: ${agentRole}`);
+            }
+            if (score > 0) {
+                matches.push({
+                    skill,
+                    score: Math.min(score, 1),
+                    reason: reasons.join('; '),
+                });
+            }
+        }
+        matches.sort((a, b) => b.score - a.score);
+        return matches;
+    }
+    /**
+     * Load a skill's content for injection into an agent's context.
+     * Returns the markdown content, or undefined if skill not found.
+     */
+    loadSkill(skillId) {
+        return this.skills.get(skillId)?.content;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

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

package/dist/skills/skill-loader.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Skill Loader (M3-3, Issue #141)
+ *
+ * Reads SKILL.md files from a directory and parses them into
+ * SkillDefinition objects. Handles missing / malformed files gracefully.
+ *
+ * SKILL.md format:
+ * ```
+ * ---
+ * name: TypeScript Testing
+ * domain: testing
+ * triggers: [vitest, jest, test, spec]
+ * roles: [tester, developer]
+ * ---
+ * Markdown body content…
+ * ```
+ */
+export interface SkillDefinition {
+    /** Unique identifier (derived from directory name) */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Knowledge domain */
+    domain: string;
+    /** Markdown content body */
+    content: string;
+    /** Keyword patterns that trigger this skill */
+    triggers: string[];
+    /** Agent roles that have affinity for this skill */
+    agentRoles: string[];
+}
+/**
+ * Parse simple YAML-like frontmatter from a SKILL.md string.
+ * Returns the parsed fields and the remaining body content.
+ */
+export declare function parseFrontmatter(raw: string): {
+    meta: Record<string, string | string[]>;
+    body: string;
+};
+/**
+ * Load all skill definitions from a directory.
+ *
+ * Expected structure:
+ *   dir/
+ *     skill-a/SKILL.md
+ *     skill-b/SKILL.md
+ *
+ * Malformed or missing files are silently skipped.
+ */
+export declare function loadSkillsFromDirectory(dir: string): SkillDefinition[];
+/**
+ * Parse a single SKILL.md raw string into a SkillDefinition.
+ * Returns undefined if required fields are missing.
+ */
+export declare function parseSkillFile(id: string, raw: string): SkillDefinition | undefined;
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/skills/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/skills/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4B3D;AAID;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CA2BtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAUnF"}

package/dist/skills/skill-loader.js

@@ -0,0 +1,106 @@
+/**
+ * Skill Loader (M3-3, Issue #141)
+ *
+ * Reads SKILL.md files from a directory and parses them into
+ * SkillDefinition objects. Handles missing / malformed files gracefully.
+ *
+ * SKILL.md format:
+ * ```
+ * ---
+ * name: TypeScript Testing
+ * domain: testing
+ * triggers: [vitest, jest, test, spec]
+ * roles: [tester, developer]
+ * ---
+ * Markdown body content…
+ * ```
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { normalizeEol } from '../utils/normalize-eol.js';
+// --- Frontmatter Parser ---
+/**
+ * Parse simple YAML-like frontmatter from a SKILL.md string.
+ * Returns the parsed fields and the remaining body content.
+ */
+export function parseFrontmatter(raw) {
+    raw = normalizeEol(raw);
+    const meta = {};
+    let body = raw;
+    const match = raw.match(/^---\s*\n([\s\S]*?)---\s*\n?([\s\S]*)$/);
+    if (!match)
+        return { meta, body };
+    const frontmatter = match[1];
+    body = match[2].trim();
+    for (const line of frontmatter.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        let value = line.slice(colonIdx + 1).trim();
+        // Parse inline arrays: [a, b, c]
+        const arrayMatch = value.match(/^\[(.+)\]$/);
+        if (arrayMatch) {
+            meta[key] = arrayMatch[1].split(',').map((s) => s.trim()).filter(Boolean);
+        }
+        else {
+            meta[key] = value;
+        }
+    }
+    return { meta, body };
+}
+// --- Directory Loader ---
+/**
+ * Load all skill definitions from a directory.
+ *
+ * Expected structure:
+ *   dir/
+ *     skill-a/SKILL.md
+ *     skill-b/SKILL.md
+ *
+ * Malformed or missing files are silently skipped.
+ */
+export function loadSkillsFromDirectory(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const skills = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillFile = path.join(dir, entry.name, 'SKILL.md');
+        if (!fs.existsSync(skillFile))
+            continue;
+        try {
+            const raw = fs.readFileSync(skillFile, 'utf-8');
+            const skill = parseSkillFile(entry.name, raw);
+            if (skill)
+                skills.push(skill);
+        }
+        catch {
+            // Malformed file — skip gracefully
+        }
+    }
+    return skills;
+}
+/**
+ * Parse a single SKILL.md raw string into a SkillDefinition.
+ * Returns undefined if required fields are missing.
+ */
+export function parseSkillFile(id, raw) {
+    const { meta, body } = parseFrontmatter(raw);
+    if (!body)
+        return undefined;
+    const name = typeof meta.name === 'string' ? meta.name : id;
+    const domain = typeof meta.domain === 'string' ? meta.domain : 'general';
+    const triggers = Array.isArray(meta.triggers) ? meta.triggers : [];
+    const agentRoles = Array.isArray(meta.roles) ? meta.roles : [];
+    return { id, name, domain, content: body, triggers, agentRoles };
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skills/skill-loader.js.map

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