superskill 0.2.6 → 0.2.7

package/dist/commands/skill/generate.js

@@ -0,0 +1,180 @@
+import { CATALOG } from "./catalog.js";
+import { resolveCommand } from "./resolve.js";
+import { fetchSkillContent, formatSection, assembleSuperSkill, classifySkill, } from "./helpers.js";
+async function fetchAllSkills(skillIds, concurrency) {
+    const results = new Map();
+    // Split into chunks to bound concurrency
+    const chunks = [];
+    for (let i = 0; i < skillIds.length; i += concurrency) {
+        chunks.push(skillIds.slice(i, i + concurrency));
+    }
+    for (const chunk of chunks) {
+        const settled = await Promise.allSettled(chunk.map(async (id) => {
+            const entry = CATALOG.find((s) => s.id === id);
+            if (!entry)
+                return { id, error: "not in catalog" };
+            const content = await fetchSkillContent(entry.source);
+            return { id, content };
+        }));
+        for (let i = 0; i < settled.length; i++) {
+            const id = chunk[i];
+            const r = settled[i];
+            if (r.status === "fulfilled") {
+                const val = r.value;
+                if ("error" in val) {
+                    results.set(id, { error: val.error });
+                }
+                else {
+                    results.set(id, { content: val.content });
+                }
+            }
+            else {
+                results.set(id, { error: String(r.reason) });
+            }
+        }
+    }
+    return results;
+}
+// ── Generate Command ──────────────────────────────────
+export async function generateCommand(vaultFs, _vaultPath, options) {
+    const CONCURRENCY = 8;
+    // 1. Resolve
+    const resolution = await resolveCommand({ profile: options.profile });
+    if (!resolution.success) {
+        return { success: false, error: resolution.error };
+    }
+    // 2. Determine active skills
+    let activeSkillIds;
+    if (options.includeNonColliding === false) {
+        activeSkillIds = resolution.resolutions.map((r) => r.chosen);
+    }
+    else {
+        activeSkillIds = resolution.active_skills;
+    }
+    // 2b. Domain filter: only keep skills whose domains overlap with relevantDomains
+    let filteredOut = 0;
+    if (options.relevantDomains && options.relevantDomains.length > 0) {
+        const relevantSet = new Set(options.relevantDomains);
+        const before = activeSkillIds.length;
+        activeSkillIds = activeSkillIds.filter((id) => {
+            const entry = CATALOG.find((s) => s.id === id);
+            if (!entry)
+                return true; // keep unknowns, they'll fail at fetch
+            return entry.domains.some((d) => relevantSet.has(d));
+        });
+        filteredOut = before - activeSkillIds.length;
+    }
+    // Track which skill IDs are collision winners (always core)
+    const collisionWinnerIds = new Set(resolution.resolutions.map((r) => r.chosen));
+    // 3. Parallel fetch
+    const fetchResults = await fetchAllSkills(activeSkillIds, CONCURRENCY);
+    const fetchErrors = [];
+    const buckets = {
+        core: [],
+        extended: [],
+        reference: [],
+    };
+    for (const skillId of activeSkillIds) {
+        const result = fetchResults.get(skillId);
+        if (!result) {
+            fetchErrors.push(`${skillId}: fetch result missing`);
+            continue;
+        }
+        if ("error" in result) {
+            fetchErrors.push(`${skillId}: ${result.error}`);
+            continue;
+        }
+        const entry = CATALOG.find((s) => s.id === skillId);
+        if (!entry) {
+            fetchErrors.push(`${skillId}: not found in catalog`);
+            continue;
+        }
+        const layer = classifySkill(skillId, collisionWinnerIds);
+        buckets[layer].push({
+            skill: entry,
+            section: formatSection(entry, result.content),
+        });
+    }
+    const totalFetched = buckets.core.length + buckets.extended.length + buckets.reference.length;
+    if (totalFetched === 0) {
+        return {
+            success: false,
+            error: "No skills could be fetched",
+            fetch_errors: fetchErrors,
+        };
+    }
+    // 4. Assemble each layer
+    const profileName = resolution.profile_name;
+    function assembleLayer(layer) {
+        const items = buckets[layer];
+        const sections = items.map((i) => i.section);
+        const domainsCovered = new Set(items.flatMap((i) => i.skill.domains));
+        return assembleSuperSkill({
+            layer,
+            profileName,
+            sections,
+            skillCount: sections.length,
+            domainCount: domainsCovered.size,
+            fetchErrors: layer === 'core' ? fetchErrors : [],
+        });
+    }
+    const coreContent = assembleLayer('core');
+    const extContent = assembleLayer('extended');
+    const refContent = assembleLayer('reference');
+    // 5. Pipe mode — write to stdout, skip vault
+    if (options.pipe) {
+        const pipeLayer = options.pipeLayer ?? 'core';
+        let content;
+        if (pipeLayer === 'all') {
+            content = [coreContent, extContent, refContent].join('\n\n');
+        }
+        else if (pipeLayer === 'extended') {
+            content = extContent;
+        }
+        else if (pipeLayer === 'reference') {
+            content = refContent;
+        }
+        else {
+            content = coreContent;
+        }
+        return {
+            success: true,
+            pipe_content: content,
+            total_skills: totalFetched,
+            fetch_errors: fetchErrors.length > 0 ? fetchErrors : undefined,
+            filtered_out: filteredOut > 0 ? filteredOut : undefined,
+        };
+    }
+    // 6. Write three files
+    const corePath = "skills/super-skill/SKILL.md";
+    const extPath = "skills/super-skill/SKILL-extended.md";
+    const refPath = "skills/super-skill/SKILL-reference.md";
+    await vaultFs.write(corePath, coreContent);
+    await vaultFs.write(extPath, extContent);
+    await vaultFs.write(refPath, refContent);
+    const estimateTokens = (s) => Math.ceil(s.length / 4);
+    return {
+        success: true,
+        layers: {
+            core: {
+                path: corePath,
+                skill_count: buckets.core.length,
+                estimated_tokens: estimateTokens(coreContent),
+            },
+            extended: {
+                path: extPath,
+                skill_count: buckets.extended.length,
+                estimated_tokens: estimateTokens(extContent),
+            },
+            reference: {
+                path: refPath,
+                skill_count: buckets.reference.length,
+                estimated_tokens: estimateTokens(refContent),
+            },
+        },
+        total_skills: totalFetched,
+        fetch_errors: fetchErrors.length > 0 ? fetchErrors : undefined,
+        filtered_out: filteredOut > 0 ? filteredOut : undefined,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/skill/generate.js.map

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

package/dist/commands/skill/helpers.d.ts

@@ -0,0 +1,14 @@
+import type { CatalogSkill } from "./catalog.js";
+export type LayerName = 'core' | 'extended' | 'reference';
+export declare function fetchSkillContent(source: string): Promise<string>;
+export declare function stripFrontmatter(content: string): string;
+export declare function formatSection(skill: CatalogSkill, rawContent: string): string;
+export declare function assembleSuperSkill(opts: {
+    layer: 'core' | 'extended' | 'reference';
+    profileName: string;
+    sections: string[];
+    skillCount: number;
+    domainCount: number;
+    fetchErrors: string[];
+}): string;
+export declare function classifySkill(skillId: string, collisionWinnerIds: Set<string>): LayerName;

package/dist/commands/skill/helpers.js

@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+import { readFile } from "fs/promises";
+import { CATALOG, DOMAIN_PRIORITY } from "./catalog.js";
+// ── Fetching & Formatting ────────────────────────────
+export async function fetchSkillContent(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");
+}
+export function stripFrontmatter(content) {
+    return content.replace(/^---[\s\S]*?---\n*/, "").trim();
+}
+export function formatSection(skill, rawContent) {
+    const body = stripFrontmatter(rawContent);
+    return [
+        `## ${skill.name}`,
+        `<!-- source: ${skill.repo} | domains: ${skill.domains.join(", ")} | id: ${skill.id} -->`,
+        "",
+        body,
+    ].join("\n");
+}
+// ── Layer Assembly ───────────────────────────────────
+export function assembleSuperSkill(opts) {
+    const now = new Date().toISOString();
+    const layerLabel = {
+        core: "Core — always loaded",
+        extended: "Extended — medium+ context models",
+        reference: "Reference — large context models only",
+    };
+    const estimatedTokens = Math.ceil(opts.sections.join("").length / 4);
+    const lines = [
+        "---",
+        "name: super-skill",
+        `layer: ${opts.layer}`,
+        `description: ${layerLabel[opts.layer]} — ${opts.skillCount} skills across ${opts.domainCount} domains`,
+        `version: ${now.slice(0, 10)}`,
+        `estimated_tokens: ${estimatedTokens}`,
+        "---",
+        "",
+        `# Super Skill — ${opts.layer.charAt(0).toUpperCase() + opts.layer.slice(1)}`,
+        "",
+        `> Generated by **superskill** skill marketplace`,
+        `> Profile: **${opts.profileName}** | Layer: **${opts.layer}** | Skills: **${opts.skillCount}** | Domains: **${opts.domainCount}** | Generated: ${now}`,
+        "",
+    ];
+    if (opts.fetchErrors.length > 0) {
+        lines.push("## Fetch Errors", "");
+        for (const err of opts.fetchErrors) {
+            lines.push(`- ${err}`);
+        }
+        lines.push("");
+    }
+    if (opts.sections.length > 0) {
+        lines.push(opts.sections.join("\n\n---\n\n"));
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+// ── Layer Classifier ─────────────────────────────────
+export function classifySkill(skillId, collisionWinnerIds) {
+    // Collision winners always go to core
+    if (collisionWinnerIds.has(skillId))
+        return 'core';
+    const entry = CATALOG.find((s) => s.id === skillId);
+    if (!entry)
+        return 'reference';
+    // Use highest-priority domain
+    let best = 'reference';
+    for (const domain of entry.domains) {
+        const priority = DOMAIN_PRIORITY[domain];
+        if (priority === 'core')
+            return 'core';
+        if (priority === 'extended')
+            best = 'extended';
+    }
+    return best;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/skill/helpers.js.map

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

package/dist/commands/skill/manifest.d.ts

@@ -0,0 +1,26 @@
+export interface ManifestEntry {
+    id: string;
+    name: string;
+    domains: string[];
+    layer: 'core' | 'extended' | 'reference';
+    description: string;
+    estimated_tokens: number;
+}
+export interface ManifestResult {
+    success: boolean;
+    manifest?: ManifestEntry[];
+    total_skills?: number;
+    total_estimated_tokens?: number;
+    error?: string;
+}
+export declare function generateManifest(options: {
+    profile?: string;
+}): Promise<ManifestResult>;
+export declare function loadSkillContent(skillId: string): Promise<{
+    success: boolean;
+    content?: string;
+    skill_name?: string;
+    estimated_tokens?: number;
+    error?: string;
+}>;
+export declare function getSkillAwarenessBlock(): string;

package/dist/commands/skill/manifest.js

@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+import { CATALOG } from "./catalog.js";
+import { resolveCommand } from "./resolve.js";
+import { fetchSkillContent, formatSection, classifySkill } from "./helpers.js";
+// ── Manifest Command ──────────────────────────────────
+export async function generateManifest(options) {
+    const resolution = await resolveCommand({ profile: options.profile });
+    if (!resolution.success) {
+        return { success: false, error: resolution.error };
+    }
+    const collisionWinnerIds = new Set(resolution.resolutions.map((r) => r.chosen));
+    const manifest = [];
+    for (const skillId of resolution.active_skills) {
+        const entry = CATALOG.find((s) => s.id === skillId);
+        if (!entry)
+            continue;
+        const layer = classifySkill(skillId, collisionWinnerIds);
+        manifest.push({
+            id: entry.id,
+            name: entry.name,
+            domains: entry.domains,
+            layer,
+            description: entry.description,
+            estimated_tokens: 2000,
+        });
+    }
+    const total_estimated_tokens = manifest.reduce((sum, e) => sum + e.estimated_tokens, 0);
+    return {
+        success: true,
+        manifest,
+        total_skills: manifest.length,
+        total_estimated_tokens,
+    };
+}
+// ── Load Skill Content ────────────────────────────────
+export async function loadSkillContent(skillId) {
+    const entry = CATALOG.find((s) => s.id === skillId);
+    // If not in catalog, check if it's a GitHub URL (web-discovered skill)
+    if (!entry) {
+        if (skillId.startsWith("https://github.com/") || skillId.startsWith("https://raw.githubusercontent.com/")) {
+            const { fetchDiscoveredSkill } = await import("./web-discovery.js");
+            const result = await fetchDiscoveredSkill(skillId);
+            if (!result.success) {
+                return { success: false, error: result.error };
+            }
+            const name = skillId.split("/").filter(Boolean).slice(-2, -1)[0]?.replace(/-/g, " ").replace(/\b\w/g, c => c.toUpperCase()) ?? "Community Skill";
+            const content = `## ${name}\n<!-- source: community | url: ${skillId} -->\n<!-- ⚠️ Unverified community skill -->\n\n${result.content}`;
+            return {
+                success: true,
+                content,
+                skill_name: name,
+                estimated_tokens: Math.ceil(content.length / 4),
+            };
+        }
+        return { success: false, error: `Skill not found in catalog: ${skillId}` };
+    }
+    try {
+        const rawContent = await fetchSkillContent(entry.source);
+        const content = formatSection(entry, rawContent);
+        return {
+            success: true,
+            content,
+            skill_name: entry.name,
+            estimated_tokens: Math.ceil(content.length / 4),
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { success: false, error: `Failed to fetch skill content: ${msg}` };
+    }
+}
+// ── Skill Awareness (for resume/context injection) ────
+export function getSkillAwarenessBlock() {
+    return [
+        "",
+        "## SuperSkill — Expert Methodologies",
+        "",
+        "You have **superskill** — your skill package manager. Call it whenever you're about to:",
+        "",
+        "- Write, review, test, or debug code",
+        "- Plan, architect, or design something",
+        "- Ship, deploy, or secure a system",
+        "- Research, write content, or prepare materials",
+        "",
+        "Just describe the task: `superskill({task: \"write tests for my Go API\"})`",
+        "SuperSkill finds the right methodology from " + CATALOG.length + "+ skills across " + new Set(CATALOG.map(s => s.repo)).size + " repos.",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=manifest.js.map

package/dist/commands/skill/manifest.js.map

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

package/dist/commands/skill/marketplace.d.ts

@@ -1,122 +1,8 @@
-import { VaultFS } from "../../lib/vault-fs.js";
-import type { CatalogSkill } from "./catalog.js";
-export interface CatalogResult {
-    total: number;
-    repos: {
-        repo: string;
-        count: number;
-    }[];
-    domains: {
-        id: string;
-        name: string;
-        skill_count: number;
-    }[];
-    skills: CatalogSkill[];
-}
-export interface CollisionResult {
-    collisions: Array<{
-        domain_id: string;
-        domain_name: string;
-        skills: Array<{
-            id: string;
-            name: string;
-            repo: string;
-            description: string;
-        }>;
-    }>;
-    total_collision_domains: number;
-    total_affected_skills: number;
-}
-export interface ResolveResult {
-    success: boolean;
-    profile_name: string;
-    resolutions: Array<{
-        domain: string;
-        chosen: string;
-        alternatives: string[];
-    }>;
-    active_skills: string[];
-    error?: string;
-}
-export interface LayerInfo {
-    path: string;
-    skill_count: number;
-    estimated_tokens: number;
-}
-export interface GenerateResult {
-    success: boolean;
-    layers?: {
-        core: LayerInfo;
-        extended: LayerInfo;
-        reference: LayerInfo;
-    };
-    total_skills?: number;
-    fetch_errors?: string[];
-    error?: string;
-    filtered_out?: number;
-    pipe_content?: string;
-}
-export interface ManifestEntry {
-    id: string;
-    name: string;
-    domains: string[];
-    layer: 'core' | 'extended' | 'reference';
-    description: string;
-    estimated_tokens: number;
-}
-export interface ManifestResult {
-    success: boolean;
-    manifest?: ManifestEntry[];
-    total_skills?: number;
-    total_estimated_tokens?: number;
-    error?: string;
-}
-export declare function catalogCommand(options: {
-    domain?: string;
-    repo?: string;
-    search?: string;
-}): Promise<CatalogResult>;
-export declare function collisionsCommand(): Promise<CollisionResult>;
-export declare function resolveCommand(options: {
-    profile?: string;
-}): Promise<ResolveResult>;
-type LayerName = 'core' | 'extended' | 'reference';
-export declare function generateCommand(vaultFs: VaultFS, _vaultPath: string, options: {
-    profile?: string;
-    includeNonColliding?: boolean;
-    outputPath?: string;
-    pipe?: boolean;
-    pipeLayer?: LayerName | 'all';
-    relevantDomains?: string[];
-}): Promise<GenerateResult>;
-export declare function generateManifest(options: {
-    profile?: string;
-}): Promise<ManifestResult>;
-export declare function loadSkillContent(skillId: string): Promise<{
-    success: boolean;
-    content?: string;
-    skill_name?: string;
-    estimated_tokens?: number;
-    error?: string;
-}>;
-export declare function matchTaskToDomains(task: string): string[];
-export interface ActivateResult {
-    success: boolean;
-    skills_loaded: Array<{
-        id: string;
-        name: string;
-        domains: string[];
-    }>;
-    content: string;
-    matched_domains: string[];
-    total_tokens: number;
-    error?: string;
-}
-export declare function activateSkills(options: {
-    task: string;
-    profile?: string;
-    skill_id?: string;
-    domain?: string;
-}): Promise<ActivateResult>;
-export declare function getSkillAwarenessBlock(): string;
-export {};
+export { catalogCommand, collisionsCommand, resolveCommand } from "./resolve.js";
+export type { CatalogResult, CollisionResult, ResolveResult } from "./resolve.js";
+export { generateCommand } from "./generate.js";
+export type { LayerInfo, GenerateResult } from "./generate.js";
+export { generateManifest, loadSkillContent, getSkillAwarenessBlock } from "./manifest.js";
+export type { ManifestEntry, ManifestResult } from "./manifest.js";
+export { activateSkills, matchTaskToDomains, TASK_DOMAIN_MAP } from "./activate.js";
+export type { ActivateResult } from "./activate.js";