pi-harness-runtime 1.1.95 → 1.1.96

package/packages/skills/dist/linter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Skill Linter
+ *
+ * Hermes-style quality checks for skills.
+ * Ensures skills capture "lessons, not logs".
+ */
+import type { Skill, LintResult, LintRule, LintSeverity } from "./types.js";
+/**
+ * Hermes-style linter rules
+ */
+export declare const LINTER_RULES: LintRule[];
+/**
+ * Lint a skill
+ */
+export declare function lintSkill(skill: Skill, rules?: LintRule[]): LintResult[];
+/**
+ * Lint a skill and return formatted output
+ */
+export declare function lintSkillFormatted(skill: Skill, rules?: LintRule[]): string;
+/**
+ * Get lint summary for multiple skills
+ */
+export declare function lintSkillsSummary(skills: Skill[]): {
+    total: number;
+    passed: number;
+    failed: number;
+    bySeverity: Record<LintSeverity, number>;
+    byRule: Record<string, number>;
+};
+/**
+ * Create custom lint rule
+ */
+export declare function createLintRule(name: string, description: string, severity: LintSeverity, check: (skill: Skill) => LintResult | null): LintRule;
+/**
+ * Filter lint results by severity
+ */
+export declare function filterLintResults(results: LintResult[], minSeverity: LintSeverity): LintResult[];
+//# sourceMappingURL=linter.d.ts.map

package/packages/skills/dist/linter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../src/linter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,EA0PlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,CAoBxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,CAe3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAwBA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,UAAU,GAAG,IAAI,GACzC,QAAQ,CAEV;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EAAE,EACrB,WAAW,EAAE,YAAY,GACxB,UAAU,EAAE,CAQd"}

package/packages/skills/dist/linter.js

@@ -0,0 +1,323 @@
+/**
+ * Skill Linter
+ *
+ * Hermes-style quality checks for skills.
+ * Ensures skills capture "lessons, not logs".
+ */
+/**
+ * Hermes-style linter rules
+ */
+export const LINTER_RULES = [
+    // === Quality Rules ===
+    {
+        name: "incident-log-shape",
+        description: "Body contains too many PR/issue references (looks like incident log)",
+        severity: "warning",
+        check: (skill) => {
+            // Count PR/issue references like #123, PR #456, issue #789
+            const prIssueRefs = skill.body.match(/(?:PR|issue|#)\s*\d+/gi) ?? [];
+            if (prIssueRefs.length > 5) {
+                return {
+                    rule: "incident-log-shape",
+                    severity: "warning",
+                    message: `Found ${prIssueRefs.length} PR/issue references. Skills should capture rules, not incident logs.`,
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "references-sprawl",
+        description: "Too many reference files (>60)",
+        severity: "error",
+        check: (skill) => {
+            if (skill.references.length > 60) {
+                return {
+                    rule: "references-sprawl",
+                    severity: "error",
+                    message: `Found ${skill.references.length} reference files. Skills should consolidate references.`,
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "oversized-body",
+        description: "SKILL.md exceeds 24k characters",
+        severity: "warning",
+        check: (skill) => {
+            if (skill.body.length > 24000) {
+                return {
+                    rule: "oversized-body",
+                    severity: "warning",
+                    message: `SKILL.md body is ${skill.body.length} chars (exceeds 24k). Consider splitting into references.`,
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "missing-pitfalls",
+        description: "No pitfalls with 'why' explanations",
+        severity: "info",
+        check: (skill) => {
+            const hasPitfalls = skill.hermes?.pitfalls && skill.hermes.pitfalls.length > 0;
+            const hasWhy = skill.body.toLowerCase().includes("why");
+            if (!hasPitfalls && !hasWhy) {
+                return {
+                    rule: "missing-pitfalls",
+                    severity: "info",
+                    message: "No pitfalls found. Consider documenting common mistakes and why they happen.",
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "missing-examples",
+        description: "No examples provided",
+        severity: "info",
+        check: (skill) => {
+            if (skill.examples.length === 0) {
+                return {
+                    rule: "missing-examples",
+                    severity: "info",
+                    message: "No examples found. Consider adding example files to demonstrate the skill.",
+                };
+            }
+            return null;
+        },
+    },
+    // === pi.dev Compatibility Rules ===
+    {
+        name: "missing-description",
+        description: "No description in frontmatter",
+        severity: "error",
+        check: (skill) => {
+            if (!skill.frontmatter.description || skill.frontmatter.description.length < 10) {
+                return {
+                    rule: "missing-description",
+                    severity: "error",
+                    message: "Missing or too short description. The description determines when the model considers loading the skill.",
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "invalid-name",
+        description: "Name contains invalid characters",
+        severity: "error",
+        check: (skill) => {
+            const nameRegex = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+            if (!nameRegex.test(skill.frontmatter.name)) {
+                return {
+                    rule: "invalid-name",
+                    severity: "error",
+                    message: `Invalid skill name '${skill.frontmatter.name}'. Must be kebab-case (e.g., 'code-review').`,
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "name-mismatch",
+        description: "Directory name doesn't match skill name",
+        severity: "warning",
+        check: (skill) => {
+            const dirName = skill.path.split("/").pop() ?? "";
+            if (dirName !== skill.frontmatter.name && dirName !== "") {
+                return {
+                    rule: "name-mismatch",
+                    severity: "warning",
+                    message: `Directory name '${dirName}' differs from skill name '${skill.frontmatter.name}'. Consider matching them for portability.`,
+                };
+            }
+            return null;
+        },
+    },
+    // === Hermes-Specific Rules ===
+    {
+        name: "missing-triggers",
+        description: "No triggers defined for auto-matching",
+        severity: "info",
+        check: (skill) => {
+            const hasTriggers = skill.hermes?.triggers && skill.hermes.triggers.length > 0;
+            if (!hasTriggers) {
+                return {
+                    rule: "missing-triggers",
+                    severity: "info",
+                    message: "No triggers defined. The skill relies only on description matching.",
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "low-confidence",
+        description: "Skill has low confidence score",
+        severity: "info",
+        check: (skill) => {
+            const confidence = skill.hermes?.confidence;
+            if (confidence !== undefined && confidence < 0.5) {
+                return {
+                    rule: "low-confidence",
+                    severity: "info",
+                    message: `Low confidence score (${confidence}). Consider validating this skill pattern.`,
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "unused-skill",
+        description: "Skill has never been used",
+        severity: "info",
+        check: (skill) => {
+            const usageCount = skill.hermes?.usage_count ?? 0;
+            if (usageCount === 0 && skill.hermes?.created_at) {
+                return {
+                    rule: "unused-skill",
+                    severity: "info",
+                    message: "This skill has never been used. Consider testing or archiving it.",
+                };
+            }
+            return null;
+        },
+    },
+    {
+        name: "generic-description",
+        description: "Description is too generic",
+        severity: "warning",
+        check: (skill) => {
+            const genericPhrases = [
+                "helps with",
+                "useful for",
+                "does things",
+                "stuff",
+                "things",
+            ];
+            const descLower = skill.frontmatter.description.toLowerCase();
+            for (const phrase of genericPhrases) {
+                if (descLower.includes(phrase)) {
+                    return {
+                        rule: "generic-description",
+                        severity: "warning",
+                        message: `Description contains generic phrase '${phrase}'. Be specific about what the skill does and when to use it.`,
+                    };
+                }
+            }
+            return null;
+        },
+    },
+    {
+        name: "log-like-content",
+        description: "Body contains log-like content (timestamps, repeated patterns)",
+        severity: "warning",
+        check: (skill) => {
+            // Check for log patterns
+            const logPatterns = [
+                /\d{4}-\d{2}-\d{2}/, // dates
+                /\d{2}:\d{2}:\d{2}/, // timestamps
+                /^(?:INFO|ERROR|WARN|DEBUG)/m, // log levels
+                /^\d+\.\s/m, // numbered lists (too detailed)
+            ];
+            let matchCount = 0;
+            for (const pattern of logPatterns) {
+                if (pattern.test(skill.body)) {
+                    matchCount++;
+                }
+            }
+            if (matchCount >= 2) {
+                return {
+                    rule: "log-like-content",
+                    severity: "warning",
+                    message: "Body contains log-like patterns. Skills should capture procedures and rules, not logs.",
+                };
+            }
+            return null;
+        },
+    },
+];
+/**
+ * Lint a skill
+ */
+export function lintSkill(skill, rules) {
+    const rulesToUse = rules ?? LINTER_RULES;
+    const results = [];
+    for (const rule of rulesToUse) {
+        try {
+            const result = rule.check(skill);
+            if (result) {
+                results.push(result);
+            }
+        }
+        catch (err) {
+            results.push({
+                rule: rule.name,
+                severity: "error",
+                message: `Linter error: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Lint a skill and return formatted output
+ */
+export function lintSkillFormatted(skill, rules) {
+    const results = lintSkill(skill, rules);
+    if (results.length === 0) {
+        return `✓ ${skill.id}: No issues found`;
+    }
+    const lines = [`✗ ${skill.id}:`];
+    for (const result of results) {
+        const icon = result.severity === "error" ? "✗" : result.severity === "warning" ? "⚠" : "ℹ";
+        lines.push(`  ${icon} [${result.severity}] ${result.rule}: ${result.message}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Get lint summary for multiple skills
+ */
+export function lintSkillsSummary(skills) {
+    const summary = {
+        total: skills.length,
+        passed: 0,
+        failed: 0,
+        bySeverity: { error: 0, warning: 0, info: 0 },
+        byRule: {},
+    };
+    for (const skill of skills) {
+        const results = lintSkill(skill);
+        if (results.length === 0) {
+            summary.passed++;
+        }
+        else {
+            summary.failed++;
+            for (const result of results) {
+                summary.bySeverity[result.severity]++;
+                summary.byRule[result.rule] = (summary.byRule[result.rule] ?? 0) + 1;
+            }
+        }
+    }
+    return summary;
+}
+/**
+ * Create custom lint rule
+ */
+export function createLintRule(name, description, severity, check) {
+    return { name, description, severity, check };
+}
+/**
+ * Filter lint results by severity
+ */
+export function filterLintResults(results, minSeverity) {
+    const severityOrder = ["info", "warning", "error"];
+    const minIndex = severityOrder.indexOf(minSeverity);
+    return results.filter((result) => {
+        const resultIndex = severityOrder.indexOf(result.severity);
+        return resultIndex >= minIndex;
+    });
+}
+//# sourceMappingURL=linter.js.map

package/packages/skills/dist/linter.js.map

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

package/packages/skills/dist/loader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Skill Registry
+ *
+ * Stores and manages skills with progressive disclosure.
+ * Based on pi.dev Agent Skills specification.
+ */
+import type { Skill, SkillIndex, MatchOptions, MatchResult, LoadOptions, LoadedSkill } from "./types.js";
+/**
+ * Skill Registry - manages loaded and indexed skills
+ */
+export declare class SkillRegistry {
+    private skills;
+    private index;
+    private loading;
+    /**
+     * Register a skill
+     */
+    register(skill: Skill): void;
+    /**
+     * Unregister a skill by ID
+     */
+    unregister(skillId: string): boolean;
+    /**
+     * Get a skill by ID
+     */
+    get(skillId: string): Skill | undefined;
+    /**
+     * List all registered skills
+     */
+    list(): Skill[];
+    /**
+     * Get skill index (lightweight)
+     */
+    getIndex(): SkillIndex;
+    /**
+     * Find skills matching a trigger/query
+     */
+    find(query: string, options?: MatchOptions): MatchResult[];
+    /**
+     * Find best matching skill for a query
+     */
+    findBestMatch(query: string, options?: MatchOptions): MatchResult | null;
+    /**
+     * Load a skill's full content (progressive disclosure)
+     */
+    load(skillId: string, options?: LoadOptions): Promise<LoadedSkill | null>;
+    /**
+     * Load skill content from disk
+     */
+    private loadSkill;
+    /**
+     * Update skill index entry
+     */
+    private updateIndex;
+    /**
+     * Clear all skills
+     */
+    clear(): void;
+    /**
+     * Get count of registered skills
+     */
+    get size(): number;
+    /**
+     * Check if skill exists
+     */
+    has(skillId: string): boolean;
+}
+/**
+ * Create a new skill registry
+ */
+export declare function createSkillRegistry(): SkillRegistry;
+export declare function getGlobalSkillRegistry(): SkillRegistry;
+export declare function setGlobalSkillRegistry(registry: SkillRegistry): void;
+//# sourceMappingURL=loader.d.ts.map

package/packages/skills/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EAEV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EAEZ,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,OAAO,CAA0C;IAEzD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAG3B;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUnC;IAED;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEtC;IAED;;OAEG;IACH,IAAI,IAAI,KAAK,EAAE,CAEd;IAED;;OAEG;IACH,QAAQ,IAAI,UAAU,CAErB;IAED;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,CAkFzD;IAED;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CAGvE;IAED;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA4B9E;IAED;;OAEG;YACW,SAAS;IA6DvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAqBnB;;OAEG;IACH,KAAK,IAAI,IAAI,CAIZ;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5B;CACF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD;AAOD,wBAAgB,sBAAsB,IAAI,aAAa,CAKtD;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEpE"}