superskill 0.2.5 → 0.2.7

package/dist/lib/analytics.js

@@ -0,0 +1,167 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+import { readFile, writeFile, mkdir, rename } from "fs/promises";
+import { resolve, dirname } from "path";
+import { tmpdir } from "os";
+import { randomBytes } from "crypto";
+// ── Constants ────────────────────────────────────────
+const MAX_ACTIVATIONS = 1000;
+const MAX_FAILED_SEARCHES = 1000;
+const ANALYTICS_DIR = resolve(process.env.HOME ?? process.env.USERPROFILE ?? tmpdir(), ".superskill");
+const ANALYTICS_PATH = resolve(ANALYTICS_DIR, "analytics.json");
+/** Override path for testing. */
+let analyticsPathOverride = null;
+export function setAnalyticsPath(path) {
+    analyticsPathOverride = path;
+}
+function getAnalyticsPath() {
+    return analyticsPathOverride ?? ANALYTICS_PATH;
+}
+// ── Storage ──────────────────────────────────────────
+function emptyData() {
+    return {
+        activations: [],
+        failed_searches: [],
+        summary: {
+            total_activations: 0,
+            total_failed_searches: 0,
+            most_used_skills: [],
+            first_seen: null,
+            last_seen: null,
+        },
+    };
+}
+async function readAnalytics() {
+    try {
+        const raw = await readFile(getAnalyticsPath(), "utf-8");
+        const data = JSON.parse(raw);
+        return {
+            activations: Array.isArray(data.activations) ? data.activations : [],
+            failed_searches: Array.isArray(data.failed_searches) ? data.failed_searches : [],
+            summary: data.summary ?? emptyData().summary,
+        };
+    }
+    catch {
+        return emptyData();
+    }
+}
+function computeSummary(data) {
+    const counts = new Map();
+    for (const a of data.activations) {
+        counts.set(a.skill_id, (counts.get(a.skill_id) ?? 0) + 1);
+    }
+    const most_used_skills = Array.from(counts.entries())
+        .map(([id, count]) => ({ id, count }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 20);
+    const allTimestamps = [
+        ...data.activations.map((a) => a.timestamp),
+        ...data.failed_searches.map((f) => f.timestamp),
+    ].filter(Boolean).sort();
+    return {
+        total_activations: data.activations.length,
+        total_failed_searches: data.failed_searches.length,
+        most_used_skills,
+        first_seen: allTimestamps[0] ?? null,
+        last_seen: allTimestamps[allTimestamps.length - 1] ?? null,
+    };
+}
+function rotateIfNeeded(data) {
+    if (data.activations.length > MAX_ACTIVATIONS) {
+        data.activations = data.activations.slice(-MAX_ACTIVATIONS);
+    }
+    if (data.failed_searches.length > MAX_FAILED_SEARCHES) {
+        data.failed_searches = data.failed_searches.slice(-MAX_FAILED_SEARCHES);
+    }
+}
+async function writeAnalytics(data) {
+    const filePath = getAnalyticsPath();
+    await mkdir(dirname(filePath), { recursive: true });
+    // Atomic write: write to temp file, then rename
+    const tempPath = filePath + "." + randomBytes(6).toString("hex") + ".tmp";
+    const json = JSON.stringify(data, null, 2);
+    await writeFile(tempPath, json, "utf-8");
+    await rename(tempPath, filePath);
+}
+// ── Public API ───────────────────────────────────────
+/**
+ * Track a skill activation event.
+ * Never throws — analytics failures must not block skill activation.
+ */
+export async function trackActivation(activation) {
+    try {
+        const data = await readAnalytics();
+        data.activations.push({
+            ...activation,
+            timestamp: new Date().toISOString(),
+        });
+        rotateIfNeeded(data);
+        data.summary = computeSummary(data);
+        await writeAnalytics(data);
+    }
+    catch {
+        // Never crash — analytics failure must never block skill activation
+    }
+}
+/**
+ * Track a failed search event.
+ * Never throws — analytics failures must not block skill activation.
+ */
+export async function trackFailedSearch(query, resultCount = 0) {
+    try {
+        const data = await readAnalytics();
+        data.failed_searches.push({
+            query,
+            timestamp: new Date().toISOString(),
+            result_count: resultCount,
+        });
+        rotateIfNeeded(data);
+        data.summary = computeSummary(data);
+        await writeAnalytics(data);
+    }
+    catch {
+        // Never crash — analytics failure must never block skill activation
+    }
+}
+/**
+ * Track a web discovery activation (convenience wrapper).
+ * Never throws.
+ */
+export async function trackWebDiscovery(taskQuery, matched) {
+    try {
+        await trackActivation({
+            skill_id: "web_discovery",
+            match_method: "web_discovery",
+            task_query: taskQuery,
+            matched,
+        });
+    }
+    catch {
+        // Never crash
+    }
+}
+/**
+ * Get the current analytics summary.
+ * Never throws — returns empty summary on failure.
+ */
+export async function getAnalyticsSummary() {
+    try {
+        const data = await readAnalytics();
+        return computeSummary(data);
+    }
+    catch {
+        return emptyData().summary;
+    }
+}
+/**
+ * Get the full analytics data (for debugging / display).
+ * Never throws — returns empty data on failure.
+ */
+export async function getAnalyticsData() {
+    try {
+        return await readAnalytics();
+    }
+    catch {
+        return emptyData();
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/lib/analytics.js.map

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

package/dist/lib/skill-cache.d.ts

@@ -0,0 +1,34 @@
+/** The 8 core skills that are prefetched on install */
+export declare const PREFETCH_SKILL_IDS: string[];
+export declare function setCacheDir(dir: string): void;
+export declare function getCacheDir(): string;
+/**
+ * Get cached skill content. Returns null if not cached.
+ */
+export declare function getCachedSkill(skillId: string): Promise<string | null>;
+/**
+ * Write skill content to cache. Uses atomic write (temp + rename).
+ */
+export declare function cacheSkill(skillId: string, content: string): Promise<void>;
+/**
+ * Check if a skill is cached.
+ */
+export declare function isSkillCached(skillId: string): Promise<boolean>;
+/**
+ * Prefetch core skills from their source repos.
+ * Called during postinstall. Non-fatal — warns on failure, never blocks install.
+ * Returns count of successfully cached skills.
+ */
+export declare function prefetchCoreSkills(options?: {
+    concurrency?: number;
+    onProgress?: (skill: string, status: "cached" | "fetched" | "failed") => void;
+}): Promise<{
+    fetched: number;
+    cached: number;
+    failed: number;
+    errors: string[];
+}>;
+/**
+ * List all cached skills.
+ */
+export declare function listCachedSkills(): Promise<string[]>;

package/dist/lib/skill-cache.js

@@ -0,0 +1,150 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+/**
+ * Skill cache — local disk cache for fetched skill content.
+ * Skills are cached at ~/.superskill/cache/{source}/{name}@{version}.md
+ * Prefetched skills are downloaded on install for offline availability.
+ */
+import { readFile, writeFile, mkdir, rename, readdir } from "fs/promises";
+import { resolve, dirname, join } from "path";
+import { homedir, tmpdir } from "os";
+import { randomBytes } from "crypto";
+import { CATALOG } from "../commands/skill/catalog.js";
+// ── Configuration ────────────────────────────────────
+const CACHE_DIR = resolve(homedir(), ".superskill", "cache");
+/** The 8 core skills that are prefetched on install */
+export const PREFETCH_SKILL_IDS = [
+    "superpowers/brainstorming",
+    "ecc/plan",
+    "ecc/tdd-workflow",
+    "ecc/go-review",
+    "superpowers/systematic-debugging",
+    "ecc/security-review",
+    "ecc/verification-loop",
+    "ecc/deployment-patterns",
+];
+// Allow tests to override the cache dir
+let cacheDir = CACHE_DIR;
+export function setCacheDir(dir) { cacheDir = dir; }
+export function getCacheDir() { return cacheDir; }
+// ── Cache Operations ─────────────────────────────────
+/**
+ * Get cached skill content. Returns null if not cached.
+ */
+export async function getCachedSkill(skillId) {
+    try {
+        const path = skillCachePath(skillId);
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write skill content to cache. Uses atomic write (temp + rename).
+ */
+export async function cacheSkill(skillId, content) {
+    try {
+        const path = skillCachePath(skillId);
+        await mkdir(dirname(path), { recursive: true });
+        const tmp = join(tmpdir(), `superskill-cache-${randomBytes(8).toString("hex")}`);
+        await writeFile(tmp, content, "utf-8");
+        await rename(tmp, path);
+    }
+    catch {
+        // Cache write failure is non-fatal
+    }
+}
+/**
+ * Check if a skill is cached.
+ */
+export async function isSkillCached(skillId) {
+    try {
+        await readFile(skillCachePath(skillId), "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Prefetch core skills from their source repos.
+ * Called during postinstall. Non-fatal — warns on failure, never blocks install.
+ * Returns count of successfully cached skills.
+ */
+export async function prefetchCoreSkills(options) {
+    const concurrency = options?.concurrency ?? 4;
+    const onProgress = options?.onProgress;
+    const results = { fetched: 0, cached: 0, failed: 0, errors: [] };
+    // Resolve skill IDs to catalog entries
+    const skills = PREFETCH_SKILL_IDS
+        .map((id) => CATALOG.find((s) => s.id === id))
+        .filter((s) => s !== undefined);
+    // Process in batches for bounded concurrency
+    for (let i = 0; i < skills.length; i += concurrency) {
+        const batch = skills.slice(i, i + concurrency);
+        const batchResults = await Promise.allSettled(batch.map(async (skill) => {
+            // Check if already cached
+            if (await isSkillCached(skill.id)) {
+                onProgress?.(skill.id, "cached");
+                results.cached++;
+                return;
+            }
+            // Fetch from source
+            const content = await fetchSkillFromSource(skill.source);
+            await cacheSkill(skill.id, content);
+            onProgress?.(skill.id, "fetched");
+            results.fetched++;
+        }));
+        for (let j = 0; j < batchResults.length; j++) {
+            const result = batchResults[j];
+            if (result.status === "rejected") {
+                const skillId = batch[j].id;
+                const error = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                results.errors.push(`${skillId}: ${error}`);
+                results.failed++;
+                onProgress?.(skillId, "failed");
+            }
+        }
+    }
+    return results;
+}
+/**
+ * List all cached skills.
+ */
+export async function listCachedSkills() {
+    try {
+        const cached = [];
+        const repos = await readdir(cacheDir).catch(() => []);
+        for (const repo of repos) {
+            const repoDir = join(cacheDir, repo);
+            const files = await readdir(repoDir).catch(() => []);
+            for (const file of files) {
+                if (file.endsWith(".md")) {
+                    const name = file.replace(".md", "");
+                    cached.push(`${repo}/${name}`);
+                }
+            }
+        }
+        return cached;
+    }
+    catch {
+        return [];
+    }
+}
+// ── Helpers ──────────────────────────────────────────
+function skillCachePath(skillId) {
+    // "ecc/tdd-workflow" → ~/.superskill/cache/ecc/tdd-workflow.md
+    const [repo, ...rest] = skillId.split("/");
+    const name = rest.join("/");
+    return resolve(cacheDir, repo, `${name}.md`);
+}
+async function fetchSkillFromSource(source) {
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+        const res = await fetch(source);
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status} ${res.statusText}`);
+        return res.text();
+    }
+    return readFile(source, "utf-8");
+}
+//# sourceMappingURL=skill-cache.js.map

package/dist/lib/skill-cache.js.map

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

package/dist/setup/postinstall.js

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
 try {
     const { detectClients } = await import("./detect.js");
+    const { prefetchCoreSkills, PREFETCH_SKILL_IDS } = await import("../lib/skill-cache.js");
     if (!process.stdout.isTTY)
         process.exit(0);
     const detected = detectClients();
@@ -14,8 +15,28 @@ try {
         console.log("  No AI clients detected.");
     }
     console.log('  Run "superskill-cli setup --all" to configure all 8 supported clients.\n');
+    // Prefetch core skills for offline availability
+    console.log(`  Prefetching ${PREFETCH_SKILL_IDS.length} core skills...`);
+    const result = await prefetchCoreSkills({
+        onProgress: (skill, status) => {
+            const icon = status === "fetched" ? "+" : status === "cached" ? "=" : "x";
+            console.log(`    [${icon}] ${skill}`);
+        },
+    });
+    const parts = [];
+    if (result.fetched > 0)
+        parts.push(`${result.fetched} fetched`);
+    if (result.cached > 0)
+        parts.push(`${result.cached} already cached`);
+    if (result.failed > 0)
+        parts.push(`${result.failed} failed`);
+    console.log(`  Done: ${parts.join(", ")}.\n`);
+    if (result.failed > 0) {
+        console.log("  Some skills could not be prefetched. They will be fetched on first use.\n");
+    }
 }
 catch {
+    // Postinstall must never fail the install
     process.exit(0);
 }
 export {};

package/dist/setup/postinstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../src/setup/postinstall.ts"],"names":[],"mappings":";AACA,2DAA2D;AAC3D,IAAI,CAAC;IACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAEtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAE3C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;AAC5F,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../src/setup/postinstall.ts"],"names":[],"mappings":";AACA,2DAA2D;AAC3D,IAAI,CAAC;IACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAEzF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IAEjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAE3C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;IAE1F,gDAAgD;IAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,kBAAkB,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,iBAAiB,CAAC,CAAC;IACrE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAAC,MAAM,CAAC;IACP,0CAA0C;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superskill",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Universal agentic knowledge base + context optimizer + skill marketplace for AI tools",
   "type": "module",
   "main": "dist/mcp-server.js",