@skillbase/spm 0.1.0

package/dist/core/config.js

@@ -0,0 +1,72 @@
+import fs from "node:fs/promises";
+import { getConfigPath, getGlobalSkillsDir } from "./paths.js";
+const DEFAULT_CONFIG = {
+    feedback: {
+        enabled: true,
+        automatic: true,
+    },
+    tools: {
+        skill_list: true,
+        skill_load: true,
+        skill_context: true,
+        skill_feedback: true,
+        skill_search: true,
+        skill_install: true,
+    },
+    search: {
+        remote_enabled: true,
+        auto_suggest: true,
+    },
+    registries: [
+        {
+            name: "public",
+            url: "https://skillbase-registry.fly.dev",
+        },
+    ],
+    scopes: {
+        "*": "public",
+    },
+};
+export function getDefaultConfig() {
+    return structuredClone(DEFAULT_CONFIG);
+}
+export async function readConfig(skillsDir) {
+    const dir = skillsDir ?? getGlobalSkillsDir();
+    const configPath = getConfigPath(dir);
+    try {
+        const raw = await fs.readFile(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return mergeWithDefaults(parsed);
+    }
+    catch {
+        return getDefaultConfig();
+    }
+}
+export async function writeConfig(config, skillsDir) {
+    const dir = skillsDir ?? getGlobalSkillsDir();
+    const configPath = getConfigPath(dir);
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+function mergeWithDefaults(partial) {
+    const defaults = getDefaultConfig();
+    return {
+        feedback: { ...defaults.feedback, ...partial.feedback },
+        tools: { ...defaults.tools, ...partial.tools },
+        search: { ...defaults.search, ...partial.search },
+        registries: partial.registries ?? defaults.registries,
+        scopes: partial.scopes ?? defaults.scopes,
+        github: partial.github,
+    };
+}
+export function resolveRegistry(config, _skillRef) {
+    const registryName = config.scopes["*"];
+    if (!registryName)
+        return null;
+    const registry = config.registries.find((r) => r.name === registryName);
+    return registry?.url ?? null;
+}
+export function getRegistryToken(config, registryName) {
+    const registry = config.registries.find((r) => r.name === registryName);
+    return registry?.token;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/feedback.d.ts

@@ -0,0 +1,22 @@
+import type { FeedbackEntry, FeedbackResult, FeedbackType, SkillStats } from "../types/index.js";
+export declare function addFeedback(skill: string, version: string, result: FeedbackResult, type?: FeedbackType, options?: {
+    rating?: number;
+    comment?: string;
+    task_type?: string;
+    file_types?: string[];
+    tokens_used?: number;
+}, skillsDir?: string): Promise<FeedbackEntry>;
+export declare function getEntriesForSkill(skillName: string, skillsDir?: string): Promise<FeedbackEntry[]>;
+export declare function getAllStats(skillsDir?: string): Promise<SkillStats[]>;
+export declare function getStatsForSkill(skillName: string, skillsDir?: string): Promise<SkillStats | null>;
+/**
+ * Confidence = success_rate × usage_weight
+ * usage_weight = min(1, log2(usage_count + 1) / 5)
+ *
+ * This ensures:
+ * - New skills (few uses) have low confidence regardless of success rate
+ * - Well-used skills converge toward their true success rate
+ * - ~32 uses needed for usage_weight to reach 1.0
+ */
+export declare function calculateConfidence(successRate: number, usageCount: number): number;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/core/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAEd,YAAY,EACZ,UAAU,EACX,MAAM,mBAAmB,CAAC;AAgC3B,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,YAA0B,EAChC,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAG1B;AAED,wBAAsB,WAAW,CAC/B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC,CAiBvB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAI5B;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR"}

package/dist/core/feedback.js

@@ -0,0 +1,93 @@
+import fs from "node:fs/promises";
+import { getFeedbackPath, getGlobalSkillsDir } from "./paths.js";
+// -- Storage --
+async function readStore(skillsDir) {
+    const dir = skillsDir ?? getGlobalSkillsDir();
+    const feedbackPath = getFeedbackPath(dir);
+    try {
+        const raw = await fs.readFile(feedbackPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return { entries: [] };
+    }
+}
+async function writeStore(store, skillsDir) {
+    const dir = skillsDir ?? getGlobalSkillsDir();
+    const feedbackPath = getFeedbackPath(dir);
+    await fs.writeFile(feedbackPath, JSON.stringify(store, null, 2) + "\n", "utf-8");
+}
+// -- Public API --
+export async function addFeedback(skill, version, result, type = "automatic", options, skillsDir) {
+    const store = await readStore(skillsDir);
+    const entry = {
+        skill,
+        version,
+        timestamp: new Date().toISOString(),
+        type,
+        result,
+        ...(options?.rating !== undefined && { rating: options.rating }),
+        ...(options?.comment && { comment: options.comment }),
+        ...((options?.task_type || options?.file_types || options?.tokens_used) && {
+            context: {
+                ...(options.task_type && { task_type: options.task_type }),
+                ...(options.file_types && { file_types: options.file_types }),
+                ...(options.tokens_used && { tokens_used: options.tokens_used }),
+            },
+        }),
+    };
+    store.entries.push(entry);
+    await writeStore(store, skillsDir);
+    return entry;
+}
+export async function getEntriesForSkill(skillName, skillsDir) {
+    const store = await readStore(skillsDir);
+    return store.entries.filter((e) => e.skill === skillName);
+}
+export async function getAllStats(skillsDir) {
+    const store = await readStore(skillsDir);
+    const grouped = new Map();
+    for (const entry of store.entries) {
+        const existing = grouped.get(entry.skill) ?? [];
+        existing.push(entry);
+        grouped.set(entry.skill, existing);
+    }
+    const stats = [];
+    for (const [skill, entries] of grouped) {
+        stats.push(computeStats(skill, entries));
+    }
+    return stats.sort((a, b) => b.confidence - a.confidence);
+}
+export async function getStatsForSkill(skillName, skillsDir) {
+    const entries = await getEntriesForSkill(skillName, skillsDir);
+    if (entries.length === 0)
+        return null;
+    return computeStats(skillName, entries);
+}
+// -- Confidence calculation --
+/**
+ * Confidence = success_rate × usage_weight
+ * usage_weight = min(1, log2(usage_count + 1) / 5)
+ *
+ * This ensures:
+ * - New skills (few uses) have low confidence regardless of success rate
+ * - Well-used skills converge toward their true success rate
+ * - ~32 uses needed for usage_weight to reach 1.0
+ */
+export function calculateConfidence(successRate, usageCount) {
+    const usageWeight = Math.min(1, Math.log2(usageCount + 1) / 5);
+    return Math.round(successRate * usageWeight * 100) / 100;
+}
+// -- Internal --
+function computeStats(skill, entries) {
+    const usageCount = entries.length;
+    const successCount = entries.filter((e) => e.result === "success" || e.result === "partial").length;
+    const successRate = usageCount > 0 ? Math.round((successCount / usageCount) * 100) / 100 : 0;
+    const rated = entries.filter((e) => e.rating !== undefined);
+    const avgRating = rated.length > 0
+        ? Math.round((rated.reduce((sum, e) => sum + e.rating, 0) / rated.length) * 100) / 100
+        : null;
+    const confidence = calculateConfidence(successRate, usageCount);
+    return { skill, usage_count: usageCount, success_rate: successRate, avg_rating: avgRating, confidence };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/core/feedback.js.map

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

package/dist/core/github/client.d.ts

@@ -0,0 +1,18 @@
+import { Octokit } from "@octokit/rest";
+import type { SkillManifest } from "../../types/index.js";
+export interface GitHubSource {
+    owner: string;
+    repo: string;
+    ref?: string;
+    path?: string;
+}
+export interface FetchedSkill {
+    manifest: SkillManifest;
+    entryContent: string;
+    compactContent?: string;
+}
+export declare function parseGitHubUrl(url: string): GitHubSource;
+export declare function createOctokit(token?: string): Octokit;
+export declare function fetchSkillFromGitHub(source: GitHubSource, token?: string): Promise<FetchedSkill>;
+export declare function downloadSkillFiles(source: GitHubSource, token?: string): Promise<Map<string, string>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/core/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/core/github/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAiDxD;AAED,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CAmDvB;AAGD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoD9B"}

package/dist/core/github/client.js

@@ -0,0 +1,141 @@
+import { Octokit } from "@octokit/rest";
+export function parseGitHubUrl(url) {
+    // Supports:
+    //   https://github.com/owner/repo
+    //   https://github.com/owner/repo/tree/main/path/to/skill
+    //   github:owner/repo
+    //   github:owner/repo/path/to/skill
+    //   owner/repo (shorthand)
+    let cleaned = url.trim();
+    // Remove trailing slash
+    cleaned = cleaned.replace(/\/$/, "");
+    // github:owner/repo[/path]
+    if (cleaned.startsWith("github:")) {
+        const rest = cleaned.slice(7);
+        const parts = rest.split("/");
+        if (parts.length < 2)
+            throw new Error(`Invalid GitHub URL: ${url}`);
+        return {
+            owner: parts[0],
+            repo: parts[1],
+            path: parts.length > 2 ? parts.slice(2).join("/") : undefined,
+        };
+    }
+    // https://github.com/owner/repo[/tree/ref/path]
+    if (cleaned.includes("github.com")) {
+        const match = cleaned.match(/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/tree\/([^/]+)(?:\/(.+))?)?$/);
+        if (!match)
+            throw new Error(`Invalid GitHub URL: ${url}`);
+        return {
+            owner: match[1],
+            repo: match[2],
+            ref: match[3] || undefined,
+            path: match[4] || undefined,
+        };
+    }
+    // owner/repo shorthand
+    const parts = cleaned.split("/");
+    if (parts.length >= 2) {
+        return {
+            owner: parts[0],
+            repo: parts[1],
+            path: parts.length > 2 ? parts.slice(2).join("/") : undefined,
+        };
+    }
+    throw new Error(`Cannot parse GitHub source: ${url}`);
+}
+export function createOctokit(token) {
+    return new Octokit(token ? { auth: token } : {});
+}
+export async function fetchSkillFromGitHub(source, token) {
+    const octokit = createOctokit(token);
+    const basePath = source.path ? `${source.path}/` : "";
+    const params = {
+        owner: source.owner,
+        repo: source.repo,
+    };
+    if (source.ref)
+        params.ref = source.ref;
+    // Fetch skill.json
+    const manifestResponse = await octokit.repos.getContent({
+        ...params,
+        path: `${basePath}skill.json`,
+    });
+    if (!("content" in manifestResponse.data)) {
+        throw new Error("skill.json not found or is a directory");
+    }
+    const manifestRaw = Buffer.from(manifestResponse.data.content, "base64").toString("utf-8");
+    const manifest = JSON.parse(manifestRaw);
+    // Fetch entry file (SKILL.md)
+    const entryResponse = await octokit.repos.getContent({
+        ...params,
+        path: `${basePath}${manifest.entry}`,
+    });
+    if (!("content" in entryResponse.data)) {
+        throw new Error(`Entry file "${manifest.entry}" not found`);
+    }
+    const entryContent = Buffer.from(entryResponse.data.content, "base64").toString("utf-8");
+    // Fetch compact entry if defined
+    let compactContent;
+    if (manifest.compact_entry) {
+        try {
+            const compactResponse = await octokit.repos.getContent({
+                ...params,
+                path: `${basePath}${manifest.compact_entry}`,
+            });
+            if ("content" in compactResponse.data) {
+                compactContent = Buffer.from(compactResponse.data.content, "base64").toString("utf-8");
+            }
+        }
+        catch {
+            // Compact entry is optional
+        }
+    }
+    return { manifest, entryContent, compactContent };
+}
+// Download full skill directory as files map (for install)
+export async function downloadSkillFiles(source, token) {
+    const octokit = createOctokit(token);
+    const files = new Map();
+    const basePath = source.path ?? "";
+    async function fetchDir(dirPath) {
+        const response = await octokit.repos.getContent({
+            owner: source.owner,
+            repo: source.repo,
+            ref: source.ref ?? undefined,
+            path: dirPath || ".",
+        });
+        if (!Array.isArray(response.data)) {
+            // Single file
+            if ("content" in response.data) {
+                const relativePath = basePath
+                    ? response.data.path.slice(basePath.length + 1)
+                    : response.data.path;
+                files.set(relativePath, Buffer.from(response.data.content, "base64").toString("utf-8"));
+            }
+            return;
+        }
+        for (const item of response.data) {
+            if (item.type === "file") {
+                const fileResp = await octokit.repos.getContent({
+                    owner: source.owner,
+                    repo: source.repo,
+                    ref: source.ref,
+                    path: item.path,
+                });
+                if ("content" in fileResp.data) {
+                    const relativePath = basePath
+                        ? fileResp.data.path.slice(basePath.length + 1)
+                        : fileResp.data.path;
+                    files.set(relativePath, Buffer.from(fileResp.data.content, "base64").toString("utf-8"));
+                }
+            }
+            else if (item.type === "dir") {
+                await fetchDir(item.path);
+            }
+        }
+    }
+    await fetchDir(basePath);
+    return files;
+}
+//# sourceMappingURL=client.js.map

package/dist/core/github/client.js.map

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

package/dist/core/indexer.d.ts

@@ -0,0 +1,4 @@
+import type { SkillIndex } from "../types/index.js";
+export declare function buildIndex(skillsDir: string): Promise<SkillIndex>;
+export declare function writeIndex(skillsDir: string): Promise<SkillIndex>;
+//# sourceMappingURL=indexer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/core/indexer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAiB,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AA6BpF,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuDvE;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAMvE"}

package/dist/core/indexer.js

@@ -0,0 +1,90 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getInstalledDir, getIndexPath } from "./paths.js";
+import { validateSkillManifest } from "../schema/skill-schema.js";
+async function estimateTokens(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        // Rough estimate: ~4 chars per token for English text
+        return Math.ceil(content.length / 4);
+    }
+    catch {
+        return 0;
+    }
+}
+async function readSkillManifest(skillDir) {
+    const manifestPath = path.join(skillDir, "skill.json");
+    try {
+        const raw = await fs.readFile(manifestPath, "utf-8");
+        const data = JSON.parse(raw);
+        const result = validateSkillManifest(data);
+        if (!result.valid) {
+            console.error(`Invalid skill.json in ${skillDir}:`, result.errors);
+            return null;
+        }
+        return data;
+    }
+    catch (err) {
+        console.error(`Failed to read skill.json in ${skillDir}:`, err);
+        return null;
+    }
+}
+export async function buildIndex(skillsDir) {
+    const installedDir = getInstalledDir(skillsDir);
+    const index = { version: "1.0.0", skills: [] };
+    let scopes;
+    try {
+        scopes = await fs.readdir(installedDir);
+    }
+    catch {
+        return index;
+    }
+    for (const author of scopes) {
+        const authorDir = path.join(installedDir, author);
+        const stat = await fs.stat(authorDir);
+        if (!stat.isDirectory())
+            continue;
+        const skillNames = await fs.readdir(authorDir);
+        for (const skillName of skillNames) {
+            const skillDir = path.join(authorDir, skillName);
+            const skillStat = await fs.stat(skillDir);
+            if (!skillStat.isDirectory())
+                continue;
+            const manifest = await readSkillManifest(skillDir);
+            if (!manifest)
+                continue;
+            // Skip bundles (no entry or trigger = not a loadable skill)
+            if (!manifest.entry || !manifest.trigger)
+                continue;
+            const entryPath = path.join(skillDir, manifest.entry);
+            const tokensEstimate = await estimateTokens(entryPath);
+            const entry = {
+                name: manifest.name,
+                v: manifest.version,
+                trigger: manifest.trigger.description,
+                tags: manifest.trigger.tags,
+                priority: manifest.trigger.priority,
+                entry: entryPath,
+                tokens_estimate: tokensEstimate,
+            };
+            if (manifest.trigger.file_patterns) {
+                entry.file_patterns = manifest.trigger.file_patterns;
+            }
+            if (manifest.compact_entry) {
+                entry.compact_entry = path.join(skillDir, manifest.compact_entry);
+            }
+            index.skills.push(entry);
+        }
+    }
+    // Sort by priority descending
+    index.skills.sort((a, b) => b.priority - a.priority);
+    return index;
+}
+export async function writeIndex(skillsDir) {
+    const index = await buildIndex(skillsDir);
+    const indexPath = getIndexPath(skillsDir);
+    await fs.mkdir(skillsDir, { recursive: true });
+    await fs.writeFile(indexPath, JSON.stringify(index, null, 2), "utf-8");
+    return index;
+}
+//# sourceMappingURL=indexer.js.map

package/dist/core/indexer.js.map

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

package/dist/core/loader.d.ts

@@ -0,0 +1,3 @@
+import type { IndexSkillEntry, LoadedSkill } from "../types/index.js";
+export declare function loadSkill(entry: IndexSkillEntry, compact?: boolean): Promise<LoadedSkill>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AAGrF,wBAAsB,SAAS,CAC7B,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAmCtB"}

package/dist/core/loader.js

@@ -0,0 +1,37 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runLoadHooks } from "./plugins/index.js";
+export async function loadSkill(entry, compact = false) {
+    const entryPath = compact && entry.compact_entry ? entry.compact_entry : entry.entry;
+    const raw = await fs.readFile(entryPath, "utf-8");
+    // Read skill.json for extra metadata
+    const skillDir = path.dirname(entryPath);
+    const manifestPath = path.join(skillDir, "skill.json");
+    let permissions = [];
+    let worksWithList = undefined;
+    try {
+        const manifestRaw = await fs.readFile(manifestPath, "utf-8");
+        const manifest = JSON.parse(manifestRaw);
+        permissions = manifest.security?.permissions ?? [];
+        worksWithList = manifest.works_with;
+    }
+    catch {
+        // Metadata unavailable — continue with defaults
+    }
+    // Run load plugins (e.g. spotlighting)
+    const content = await runLoadHooks({
+        content: raw,
+        name: entry.name,
+        version: entry.v,
+        permissions,
+    });
+    return {
+        name: entry.name,
+        version: entry.v,
+        content,
+        permissions,
+        tokens_estimate: entry.tokens_estimate,
+        works_with: worksWithList,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/core/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAsB,EACtB,UAAmB,KAAK;IAExB,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACrF,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAElD,qCAAqC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvD,IAAI,WAAW,GAAa,EAAE,CAAC;IAC/B,IAAI,aAAa,GAA8B,SAAS,CAAC;IAEzD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAkB,CAAC;QAC1D,WAAW,GAAG,QAAQ,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,CAAC;QACnD,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IAED,uCAAuC;IACvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;QACjC,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,CAAC;QAChB,WAAW;KACZ,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,CAAC;QAChB,OAAO;QACP,WAAW;QACX,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,UAAU,EAAE,aAAa;KAC1B,CAAC;AACJ,CAAC"}

package/dist/core/lock.d.ts

@@ -0,0 +1,4 @@
+import type { SkillsLock } from "../types/index.js";
+export declare function buildLock(skillsDir: string): Promise<SkillsLock>;
+export declare function writeLock(skillsDir: string): Promise<SkillsLock>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/core/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/core/lock.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAiB,UAAU,EAAkB,MAAM,mBAAmB,CAAC;AA4BnF,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuDtE;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAKtE"}

package/dist/core/lock.js

@@ -0,0 +1,86 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import crypto from "node:crypto";
+import { getInstalledDir } from "./paths.js";
+async function hashDirectory(dir) {
+    const hash = crypto.createHash("sha256");
+    const entries = await fs.readdir(dir, { recursive: true });
+    entries.sort();
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.toString());
+        const stat = await fs.stat(fullPath);
+        if (stat.isFile()) {
+            const content = await fs.readFile(fullPath);
+            hash.update(content);
+        }
+    }
+    return hash.digest("hex");
+}
+async function estimateTokensForFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        return Math.ceil(content.length / 4);
+    }
+    catch {
+        return 0;
+    }
+}
+export async function buildLock(skillsDir) {
+    const installedDir = getInstalledDir(skillsDir);
+    const lock = {
+        lock_version: 1,
+        generated: new Date().toISOString(),
+        total_tokens_estimate: 0,
+        skills: {},
+    };
+    let scopes;
+    try {
+        scopes = await fs.readdir(installedDir);
+    }
+    catch {
+        return lock;
+    }
+    for (const author of scopes) {
+        const authorDir = path.join(installedDir, author);
+        const stat = await fs.stat(authorDir);
+        if (!stat.isDirectory())
+            continue;
+        const skillNames = await fs.readdir(authorDir);
+        for (const skillName of skillNames) {
+            const skillDir = path.join(authorDir, skillName);
+            const skillStat = await fs.stat(skillDir);
+            if (!skillStat.isDirectory())
+                continue;
+            const manifestPath = path.join(skillDir, "skill.json");
+            let manifest;
+            try {
+                const raw = await fs.readFile(manifestPath, "utf-8");
+                manifest = JSON.parse(raw);
+            }
+            catch {
+                continue;
+            }
+            const integrity = await hashDirectory(skillDir);
+            const tokensEstimate = manifest.entry
+                ? await estimateTokensForFile(path.join(skillDir, manifest.entry))
+                : 0;
+            const entry = {
+                version: manifest.version,
+                resolved: skillDir,
+                integrity: `sha256-${integrity}`,
+                tokens_estimate: tokensEstimate,
+                dependencies: manifest.dependencies,
+            };
+            lock.skills[manifest.name] = entry;
+            lock.total_tokens_estimate += tokensEstimate;
+        }
+    }
+    return lock;
+}
+export async function writeLock(skillsDir) {
+    const lock = await buildLock(skillsDir);
+    const lockPath = path.join(skillsDir, "skills.lock");
+    await fs.writeFile(lockPath, JSON.stringify(lock, null, 2), "utf-8");
+    return lock;
+}
+//# sourceMappingURL=lock.js.map

package/dist/core/lock.js.map

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