anantham-v2 2.0.0-alpha.1

package/dist/skills/skill-loader.js

@@ -0,0 +1,109 @@
+/**
+ * Anantham V2 — Skill Progressive Loader
+ *
+ * Implements three-phase progressive disclosure: Metadata -> Relevance match -> Full procedure body.
+ */
+import { SkillRelevanceMatcher } from "./skill-matcher.js";
+import { SkillCompatibilityChecker } from "./skill-compatibility.js";
+import { SkillDependencyResolver } from "./skill-dependency.js";
+export class SkillProgressiveLoader {
+    matcher;
+    compatibilityChecker;
+    dependencyResolver;
+    bodyCache = new Map();
+    constructor(options) {
+        this.matcher = options?.matcher || new SkillRelevanceMatcher();
+        this.compatibilityChecker = options?.compatibilityChecker || new SkillCompatibilityChecker();
+        this.dependencyResolver = options?.dependencyResolver || new SkillDependencyResolver();
+    }
+    /**
+     * Clears derived body cache (for cache safety on disable/reload).
+     */
+    invalidateCache(skillId) {
+        if (skillId) {
+            this.bodyCache.delete(skillId);
+        }
+        else {
+            this.bodyCache.clear();
+        }
+    }
+    /**
+     * Evaluates task goal and progressively loads only relevant, compatible skills into context.
+     */
+    loadRelevantSkills(installedManifests, options) {
+        const allMetadataMap = new Map();
+        for (const m of installedManifests) {
+            allMetadataMap.set(m.metadata.id, m.metadata);
+        }
+        // Phase 1 & 2: Match relevant skills using cheap metadata
+        const candidates = this.matcher.match(options.taskGoal, installedManifests.map((m) => m.metadata), { minScore: options.minRelevanceScore || 0.1 });
+        const loaded = [];
+        const skipped = [];
+        let currentTokens = 0;
+        const maxTokens = options.maxTokens || 4000;
+        for (const cand of candidates) {
+            const manifest = installedManifests.find((m) => m.metadata.id === cand.metadata.id);
+            if (!manifest)
+                continue;
+            // Phase 3: Validate compatibility
+            const compat = this.compatibilityChecker.checkCompatibility(manifest.metadata, options.availableCapabilities || []);
+            if (!compat.isCompatible) {
+                skipped.push({ skillId: manifest.metadata.id, reason: compat.reasons.join(" ") });
+                continue;
+            }
+            // Phase 3: Validate dependencies
+            const depRes = this.dependencyResolver.resolveDependencies(manifest.metadata, allMetadataMap);
+            if (!depRes.isResolved) {
+                skipped.push({ skillId: manifest.metadata.id, reason: depRes.errors.join(" ") });
+                continue;
+            }
+            // Format procedure for prompt injection
+            const procedurePrompt = this.formatProcedurePrompt(manifest);
+            const tokenEstimate = Math.ceil(procedurePrompt.length / 4);
+            if (currentTokens + tokenEstimate > maxTokens) {
+                skipped.push({
+                    skillId: manifest.metadata.id,
+                    reason: `Token budget exceeded (${currentTokens + tokenEstimate} > ${maxTokens}).`,
+                });
+                continue;
+            }
+            this.bodyCache.set(manifest.metadata.id, procedurePrompt);
+            currentTokens += tokenEstimate;
+            loaded.push({
+                skillId: manifest.metadata.id,
+                version: manifest.metadata.version,
+                name: manifest.metadata.name,
+                procedurePrompt,
+                tokenEstimate,
+            });
+        }
+        return { matched: candidates, loaded, skipped };
+    }
+    formatProcedurePrompt(manifest) {
+        const meta = manifest.metadata;
+        const proc = manifest.procedure;
+        let output = `### SKILL: ${meta.name} (v${meta.version})\n`;
+        output += `*Description*: ${meta.description}\n\n`;
+        if (proc.preconditions && proc.preconditions.length > 0) {
+            output += `**Preconditions**:\n`;
+            for (const pre of proc.preconditions)
+                output += `- ${pre}\n`;
+            output += `\n`;
+        }
+        if (proc.steps && proc.steps.length > 0) {
+            output += `**Procedure**:\n`;
+            proc.steps.forEach((step, idx) => {
+                output += `${idx + 1}. ${step}\n`;
+            });
+            output += `\n`;
+        }
+        if (proc.successCriteria && proc.successCriteria.length > 0) {
+            output += `**Success Criteria**:\n`;
+            for (const crit of proc.successCriteria)
+                output += `- ${crit}\n`;
+            output += `\n`;
+        }
+        return output.trim();
+    }
+}
+//# 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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"}

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

@@ -0,0 +1,79 @@
+/**
+ * Anantham V2 — Skill Manager & Lifecycle Engine
+ *
+ * Coordinates full skill lifecycle transitions, progressive loading, testing,
+ * execution provenance recording, and EventStore auditing.
+ */
+import { type SkillRecord, type SkillTestFixture, type SkillTestResult, type SkillExecutionRecord } from "../domain/skill.js";
+import { SkillParser } from "./skill-parser.js";
+import { SkillRegistry } from "./skill-registry.js";
+import { SkillProgressiveLoader, type ProgressiveLoadOptions, type LoadedSkillContext } from "./skill-loader.js";
+import { SkillTestRunner } from "./skill-test-runner.js";
+import { SkillSecurityGuard } from "./skill-security.js";
+import { type EventStore } from "../event-state/event-store.js";
+export interface SkillManagerOptions {
+    registry?: SkillRegistry;
+    parser?: SkillParser;
+    loader?: SkillProgressiveLoader;
+    testRunner?: SkillTestRunner;
+    securityGuard?: SkillSecurityGuard;
+    eventStore?: EventStore;
+    projectId?: string;
+}
+export declare class SkillManager {
+    private readonly registry;
+    private readonly parser;
+    private readonly loader;
+    private readonly testRunner;
+    private readonly securityGuard;
+    private readonly eventStore?;
+    private readonly projectId;
+    constructor(options?: SkillManagerOptions);
+    getRegistry(): SkillRegistry;
+    /**
+     * Discovers and parses a SKILL.md document.
+     */
+    discover(rawContent: string, fallbackId?: string): SkillRecord;
+    /**
+     * Installs and validates a SKILL.md document.
+     */
+    install(rawContent: string, fallbackId?: string): SkillRecord;
+    /**
+     * Enables an installed skill.
+     */
+    enable(skillId: string): SkillRecord;
+    /**
+     * Disables a skill and invalidates derived caches.
+     */
+    disable(skillId: string): SkillRecord;
+    /**
+     * Reloads a skill from updated SKILL.md content, invalidating cache.
+     */
+    reload(skillId: string, updatedRawContent: string): SkillRecord;
+    /**
+     * Removes a skill from the registry.
+     */
+    remove(skillId: string): boolean;
+    /**
+     * Progressively loads relevant skills for a task goal.
+     */
+    loadForTask(options: ProgressiveLoadOptions): LoadedSkillContext[];
+    /**
+     * Runs deterministic skill test fixtures (/skills test <name>).
+     */
+    test(skillId: string, fixture: SkillTestFixture): Promise<SkillTestResult>;
+    /**
+     * Records execution provenance when a skill procedure is completed.
+     */
+    recordExecution(skillId: string, context: {
+        projectId?: string;
+        sessionId?: string;
+        taskId?: string;
+        contextRevision?: number;
+        toolsUsed?: string[];
+        mcpUsed?: string[];
+        result?: string;
+    }): SkillExecutionRecord;
+    private emitEvent;
+}
+//# sourceMappingURL=skill-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manager.d.ts","sourceRoot":"","sources":["../../src/skills/skill-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,GAAE,mBAAwB;IAUtC,WAAW,IAAI,aAAa;IAInC;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAarE;;OAEG;IACI,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW;IAkBpE;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAa3C;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAa5C;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,WAAW;IAwBtE;;OAEG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASvC;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,EAAE;IAkBzE;;OAEG;IACU,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiBvF;;OAEG;IACI,eAAe,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,oBAAoB;IA4BvB,OAAO,CAAC,SAAS;CAalB"}

package/dist/skills/skill-manager.js

@@ -0,0 +1,198 @@
+/**
+ * Anantham V2 — Skill Manager & Lifecycle Engine
+ *
+ * Coordinates full skill lifecycle transitions, progressive loading, testing,
+ * execution provenance recording, and EventStore auditing.
+ */
+import { SkillExecutionRecordSchema, } from "../domain/skill.js";
+import { SkillParser } from "./skill-parser.js";
+import { SkillRegistry } from "./skill-registry.js";
+import { SkillProgressiveLoader } from "./skill-loader.js";
+import { SkillTestRunner } from "./skill-test-runner.js";
+import { SkillSecurityGuard } from "./skill-security.js";
+import { EventTypes } from "../domain/event.js";
+export class SkillManager {
+    registry;
+    parser;
+    loader;
+    testRunner;
+    securityGuard;
+    eventStore;
+    projectId;
+    constructor(options = {}) {
+        this.registry = options.registry || new SkillRegistry();
+        this.parser = options.parser || new SkillParser();
+        this.loader = options.loader || new SkillProgressiveLoader();
+        this.testRunner = options.testRunner || new SkillTestRunner();
+        this.securityGuard = options.securityGuard || new SkillSecurityGuard();
+        this.eventStore = options.eventStore;
+        this.projectId = options.projectId || "global";
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * Discovers and parses a SKILL.md document.
+     */
+    discover(rawContent, fallbackId) {
+        const manifest = this.parser.parse(rawContent, fallbackId);
+        const record = this.registry.register(manifest);
+        record.lifecycleState = "discovered";
+        this.emitEvent(EventTypes.SKILL_DISCOVERED, {
+            skillId: manifest.metadata.id,
+            version: manifest.metadata.version,
+        });
+        return record;
+    }
+    /**
+     * Installs and validates a SKILL.md document.
+     */
+    install(rawContent, fallbackId) {
+        const audit = this.securityGuard.auditContent(rawContent);
+        if (!audit.isSafe) {
+            throw new Error(`Skill security validation failed: ${audit.violations.join(" ")}`);
+        }
+        const manifest = this.parser.parse(rawContent, fallbackId);
+        const record = this.registry.register(manifest);
+        record.lifecycleState = "enabled";
+        this.emitEvent(EventTypes.SKILL_INSTALLED, {
+            skillId: manifest.metadata.id,
+            version: manifest.metadata.version,
+        });
+        return record;
+    }
+    /**
+     * Enables an installed skill.
+     */
+    enable(skillId) {
+        const record = this.registry.get(skillId);
+        if (!record) {
+            throw new Error(`Skill "${skillId}" not found in registry.`);
+        }
+        record.lifecycleState = "enabled";
+        this.loader.invalidateCache(skillId);
+        this.emitEvent(EventTypes.SKILL_ENABLED, { skillId });
+        return record;
+    }
+    /**
+     * Disables a skill and invalidates derived caches.
+     */
+    disable(skillId) {
+        const record = this.registry.get(skillId);
+        if (!record) {
+            throw new Error(`Skill "${skillId}" not found in registry.`);
+        }
+        record.lifecycleState = "disabled";
+        this.loader.invalidateCache(skillId);
+        this.emitEvent(EventTypes.SKILL_DISABLED, { skillId });
+        return record;
+    }
+    /**
+     * Reloads a skill from updated SKILL.md content, invalidating cache.
+     */
+    reload(skillId, updatedRawContent) {
+        const record = this.registry.get(skillId);
+        if (!record) {
+            throw new Error(`Skill "${skillId}" not found for reload.`);
+        }
+        const audit = this.securityGuard.auditContent(updatedRawContent);
+        if (!audit.isSafe) {
+            throw new Error(`Skill security validation failed during reload: ${audit.violations.join(" ")}`);
+        }
+        const updatedManifest = this.parser.parse(updatedRawContent, skillId);
+        record.manifest = updatedManifest;
+        record.lifecycleState = "enabled";
+        this.loader.invalidateCache(skillId);
+        this.emitEvent(EventTypes.SKILL_RELOADED, {
+            skillId,
+            version: updatedManifest.metadata.version,
+        });
+        return record;
+    }
+    /**
+     * Removes a skill from the registry.
+     */
+    remove(skillId) {
+        const deleted = this.registry.unregister(skillId);
+        if (deleted) {
+            this.loader.invalidateCache(skillId);
+            this.emitEvent(EventTypes.SKILL_REMOVED, { skillId });
+        }
+        return deleted;
+    }
+    /**
+     * Progressively loads relevant skills for a task goal.
+     */
+    loadForTask(options) {
+        const enabledManifests = this.registry
+            .list()
+            .filter((r) => r.lifecycleState === "enabled" || r.lifecycleState === "loaded")
+            .map((r) => r.manifest);
+        const result = this.loader.loadRelevantSkills(enabledManifests, options);
+        for (const loaded of result.loaded) {
+            this.emitEvent(EventTypes.SKILL_LOADED, {
+                skillId: loaded.skillId,
+                version: loaded.version,
+                tokens: loaded.tokenEstimate,
+            });
+        }
+        return result.loaded;
+    }
+    /**
+     * Runs deterministic skill test fixtures (/skills test <name>).
+     */
+    async test(skillId, fixture) {
+        const record = this.registry.get(skillId);
+        if (!record) {
+            throw new Error(`Skill "${skillId}" not found for testing.`);
+        }
+        const result = await this.testRunner.runTest(record.manifest, fixture);
+        this.emitEvent(EventTypes.SKILL_TESTED, {
+            skillId,
+            passed: result.passed,
+            durationMs: result.durationMs,
+        });
+        return result;
+    }
+    /**
+     * Records execution provenance when a skill procedure is completed.
+     */
+    recordExecution(skillId, context) {
+        const record = this.registry.get(skillId);
+        const version = record ? record.manifest.metadata.version : "unknown";
+        const executionRecord = SkillExecutionRecordSchema.parse({
+            id: `exec_sk_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+            skillId,
+            version,
+            projectId: context.projectId || this.projectId,
+            sessionId: context.sessionId,
+            taskId: context.taskId,
+            contextRevision: context.contextRevision,
+            toolsUsed: context.toolsUsed || [],
+            mcpUsed: context.mcpUsed || [],
+            result: context.result || "success",
+            timestamp: new Date().toISOString(),
+        });
+        this.emitEvent(EventTypes.SKILL_EXECUTED, {
+            skillId,
+            version,
+            taskId: context.taskId,
+            result: executionRecord.result,
+        });
+        return executionRecord;
+    }
+    emitEvent(type, payload) {
+        if (this.eventStore) {
+            this.eventStore.append({
+                id: `evt_sk_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+                schemaVersion: 1,
+                projectId: this.projectId,
+                type,
+                actor: "system",
+                timestamp: new Date().toISOString(),
+                payload,
+            });
+        }
+    }
+}
+//# sourceMappingURL=skill-manager.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Anantham V2 — Skill Relevance Matcher
+ *
+ * Scores and ranks candidate skills against task prompts and goals.
+ */
+import { type SkillMetadata } from "../domain/skill.js";
+export interface SkillMatchCandidate {
+    metadata: SkillMetadata;
+    score: number;
+    matchedTerms: string[];
+}
+export declare class SkillRelevanceMatcher {
+    /**
+     * Matches and ranks skills against a query/goal.
+     */
+    match(query: string, candidates: SkillMetadata[], options?: {
+        minScore?: number;
+        maxResults?: number;
+    }): SkillMatchCandidate[];
+}
+//# sourceMappingURL=skill-matcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-matcher.d.ts","sourceRoot":"","sources":["../../src/skills/skill-matcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,qBAAqB;IAChC;;OAEG;IACI,KAAK,CACV,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,EAAE,EAC3B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,mBAAmB,EAAE;CAiDzB"}

package/dist/skills/skill-matcher.js

@@ -0,0 +1,57 @@
+/**
+ * Anantham V2 — Skill Relevance Matcher
+ *
+ * Scores and ranks candidate skills against task prompts and goals.
+ */
+export class SkillRelevanceMatcher {
+    /**
+     * Matches and ranks skills against a query/goal.
+     */
+    match(query, candidates, options) {
+        const minScore = options?.minScore || 0.1;
+        const maxResults = options?.maxResults || 5;
+        const queryTerms = query
+            .toLowerCase()
+            .split(/[^a-zA-Z0-9_\-]+/)
+            .filter((t) => t.length > 2);
+        const matches = [];
+        for (const skill of candidates) {
+            const skillTerms = new Set();
+            for (const t of skill.id.toLowerCase().split(/[^a-zA-Z0-9_\-]+/))
+                skillTerms.add(t);
+            for (const t of skill.name.toLowerCase().split(/[^a-zA-Z0-9_\-]+/))
+                skillTerms.add(t);
+            for (const t of skill.description.toLowerCase().split(/[^a-zA-Z0-9_\-]+/))
+                skillTerms.add(t);
+            for (const tag of skill.tags || [])
+                skillTerms.add(tag.toLowerCase());
+            const matched = [];
+            let score = 0;
+            for (const term of queryTerms) {
+                if (skillTerms.has(term)) {
+                    matched.push(term);
+                    // Higher score for matches in ID or name
+                    if (skill.id.toLowerCase().includes(term) || skill.name.toLowerCase().includes(term)) {
+                        score += 2.0;
+                    }
+                    else {
+                        score += 1.0;
+                    }
+                }
+            }
+            // Normalize score by query term length
+            const normalizedScore = queryTerms.length > 0 ? score / queryTerms.length : 0;
+            if (normalizedScore >= minScore) {
+                matches.push({
+                    metadata: skill,
+                    score: normalizedScore,
+                    matchedTerms: matched,
+                });
+            }
+        }
+        return matches
+            .sort((a, b) => b.score - a.score)
+            .slice(0, maxResults);
+    }
+}
+//# sourceMappingURL=skill-matcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-matcher.js","sourceRoot":"","sources":["../../src/skills/skill-matcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,OAAO,qBAAqB;IAChC;;OAEG;IACI,KAAK,CACV,KAAa,EACb,UAA2B,EAC3B,OAAoD;QAEpD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;QAC1C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAE5C,MAAM,UAAU,GAAG,KAAK;aACrB,WAAW,EAAE;aACb,KAAK,CAAC,kBAAkB,CAAC;aACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE/B,MAAM,OAAO,GAA0B,EAAE,CAAC;QAE1C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACpF,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACtF,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC;gBAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7F,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE;gBAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAEtE,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,yCAAyC;oBACzC,IAAI,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACrF,KAAK,IAAI,GAAG,CAAC;oBACf,CAAC;yBAAM,CAAC;wBACN,KAAK,IAAI,GAAG,CAAC;oBACf,CAAC;gBACH,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAE9E,IAAI,eAAe,IAAI,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,KAAK;oBACf,KAAK,EAAE,eAAe;oBACtB,YAAY,EAAE,OAAO;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO;aACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC1B,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+/**
+ * Anantham V2 — Skill Parser
+ *
+ * Extracts and validates YAML frontmatter and Markdown procedure sections from SKILL.md.
+ */
+import { type SkillManifest } from "../domain/skill.js";
+export declare class SkillParser {
+    /**
+     * Parses raw markdown with YAML frontmatter into a validated SkillManifest.
+     */
+    parse(rawContent: string, fallbackId?: string): SkillManifest;
+    private parseProcedureSections;
+    private parseSimpleYaml;
+}
+//# sourceMappingURL=skill-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../src/skills/skill-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,WAAW;IACtB;;OAEG;IACI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa;IA6CpE,OAAO,CAAC,sBAAsB;IA4C9B,OAAO,CAAC,eAAe;CA0CxB"}

package/dist/skills/skill-parser.js

@@ -0,0 +1,124 @@
+/**
+ * Anantham V2 — Skill Parser
+ *
+ * Extracts and validates YAML frontmatter and Markdown procedure sections from SKILL.md.
+ */
+import { SkillFrontmatterSchema, SkillManifestSchema, } from "../domain/skill.js";
+export class SkillParser {
+    /**
+     * Parses raw markdown with YAML frontmatter into a validated SkillManifest.
+     */
+    parse(rawContent, fallbackId) {
+        if (!rawContent || !rawContent.trim()) {
+            throw new Error("Cannot parse empty SKILL.md content.");
+        }
+        const frontmatterMatch = rawContent.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            throw new Error("Invalid SKILL.md format: Missing YAML frontmatter delimited by ---.");
+        }
+        const frontmatterYaml = frontmatterMatch[1] || "";
+        const markdownBody = (frontmatterMatch[2] || "").trim();
+        const frontmatterObj = this.parseSimpleYaml(frontmatterYaml);
+        const validatedFrontmatter = SkillFrontmatterSchema.parse(frontmatterObj);
+        const skillId = (fallbackId || validatedFrontmatter.name)
+            .toLowerCase()
+            .replace(/[^a-zA-Z0-9_\-\.]/g, "-");
+        const procedure = this.parseProcedureSections(markdownBody);
+        const manifest = SkillManifestSchema.parse({
+            metadata: {
+                id: skillId,
+                name: validatedFrontmatter.name,
+                description: validatedFrontmatter.description,
+                version: validatedFrontmatter.version,
+                tools: validatedFrontmatter.tools || [],
+                mcp: validatedFrontmatter.mcp || [],
+                skills: validatedFrontmatter.skills || [],
+                capabilities: validatedFrontmatter.capabilities || [],
+                runtime: validatedFrontmatter.runtime || "anantham>=2.0",
+                tags: validatedFrontmatter.tags || [],
+                publisher: validatedFrontmatter.publisher || "local",
+            },
+            procedure: {
+                ...procedure,
+                rawMarkdown: markdownBody,
+            },
+        });
+        return manifest;
+    }
+    parseProcedureSections(markdownBody) {
+        const preconditions = [];
+        const steps = [];
+        const successCriteria = [];
+        const lines = markdownBody.split(/\r?\n/);
+        let currentSection = "none";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            const lower = trimmed.toLowerCase();
+            if (lower.startsWith("## preconditions") || lower.startsWith("# preconditions")) {
+                currentSection = "preconditions";
+                continue;
+            }
+            else if (lower.startsWith("## procedure") || lower.startsWith("# procedure") || lower.startsWith("## steps")) {
+                currentSection = "procedure";
+                continue;
+            }
+            else if (lower.startsWith("## success criteria") || lower.startsWith("# success criteria")) {
+                currentSection = "success";
+                continue;
+            }
+            else if (trimmed.startsWith("#")) {
+                currentSection = "none";
+                continue;
+            }
+            if (!trimmed)
+                continue;
+            if (currentSection === "preconditions") {
+                preconditions.push(trimmed.replace(/^[-*]\s*/, ""));
+            }
+            else if (currentSection === "procedure") {
+                steps.push(trimmed.replace(/^\d+\.\s*/, "").replace(/^[-*]\s*/, ""));
+            }
+            else if (currentSection === "success") {
+                successCriteria.push(trimmed.replace(/^[-*]\s*/, ""));
+            }
+        }
+        return { preconditions, steps, successCriteria };
+    }
+    parseSimpleYaml(yamlString) {
+        const result = {};
+        const lines = yamlString.split(/\r?\n/);
+        let currentListKey = null;
+        let currentList = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            if (trimmed.startsWith("- ") && currentListKey) {
+                currentList.push(trimmed.slice(2).trim());
+                continue;
+            }
+            if (currentListKey) {
+                result[currentListKey] = currentList;
+                currentListKey = null;
+                currentList = [];
+            }
+            const colonIndex = line.indexOf(":");
+            if (colonIndex !== -1) {
+                const key = line.slice(0, colonIndex).trim();
+                const value = line.slice(colonIndex + 1).trim();
+                if (!value) {
+                    currentListKey = key;
+                    currentList = [];
+                }
+                else {
+                    result[key] = value.replace(/^["'](.*)["']$/, "$1");
+                }
+            }
+        }
+        if (currentListKey) {
+            result[currentListKey] = currentList;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=skill-parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.js","sourceRoot":"","sources":["../../src/skills/skill-parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,OAAO,WAAW;IACtB;;OAEG;IACI,KAAK,CAAC,UAAkB,EAAE,UAAmB;QAClD,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,gBAAgB,GAAG,UAAU,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QACxF,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,eAAe,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAExD,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QAC7D,MAAM,oBAAoB,GAAqB,sBAAsB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAE5F,MAAM,OAAO,GAAG,CAAC,UAAU,IAAI,oBAAoB,CAAC,IAAI,CAAC;aACtD,WAAW,EAAE;aACb,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QAE5D,MAAM,QAAQ,GAAkB,mBAAmB,CAAC,KAAK,CAAC;YACxD,QAAQ,EAAE;gBACR,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,oBAAoB,CAAC,IAAI;gBAC/B,WAAW,EAAE,oBAAoB,CAAC,WAAW;gBAC7C,OAAO,EAAE,oBAAoB,CAAC,OAAO;gBACrC,KAAK,EAAE,oBAAoB,CAAC,KAAK,IAAI,EAAE;gBACvC,GAAG,EAAE,oBAAoB,CAAC,GAAG,IAAI,EAAE;gBACnC,MAAM,EAAE,oBAAoB,CAAC,MAAM,IAAI,EAAE;gBACzC,YAAY,EAAE,oBAAoB,CAAC,YAAY,IAAI,EAAE;gBACrD,OAAO,EAAE,oBAAoB,CAAC,OAAO,IAAI,eAAe;gBACxD,IAAI,EAAE,oBAAoB,CAAC,IAAI,IAAI,EAAE;gBACrC,SAAS,EAAE,oBAAoB,CAAC,SAAS,IAAI,OAAO;aACrD;YACD,SAAS,EAAE;gBACT,GAAG,SAAS;gBACZ,WAAW,EAAE,YAAY;aAC1B;SACF,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,sBAAsB,CAAC,YAAoB;QAKjD,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,cAAc,GAAuD,MAAM,CAAC;QAEhF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAEpC,IAAI,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAChF,cAAc,GAAG,eAAe,CAAC;gBACjC,SAAS;YACX,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/G,cAAc,GAAG,WAAW,CAAC;gBAC7B,SAAS;YACX,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBAC7F,cAAc,GAAG,SAAS,CAAC;gBAC3B,SAAS;YACX,CAAC;iBAAM,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,cAAc,GAAG,MAAM,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;gBACvC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACxC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IACnD,CAAC;IAEO,eAAe,CAAC,UAAkB;QACxC,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,cAAc,GAAkB,IAAI,CAAC;QACzC,IAAI,WAAW,GAAa,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAElD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;gBAC/C,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1C,SAAS;YACX,CAAC;YAED,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;gBACrC,cAAc,GAAG,IAAI,CAAC;gBACtB,WAAW,GAAG,EAAE,CAAC;YACnB,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,cAAc,GAAG,GAAG,CAAC;oBACrB,WAAW,GAAG,EAAE,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;QACvC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}