ankui 0.1.0

package/dist/scanner/adapters/opencode.js

@@ -0,0 +1,231 @@
+import path from "node:path";
+import { countTextLines, createSanitizedPreview } from "../preview.js";
+import { readJsoncFile, readMarkdownFile } from "../parsing.js";
+import { maskSecretText, safeReadDirectory } from "../safety.js";
+import { addSkillToState, addWarningsToState, buildLinkDetails, buildSkill, collectMarkdownFiles, createAdapterState, extractFirstHeading, firstString, isDiscovered, parseMarkdownFrontmatter, readMaskedUrl, readRecord, safeReadOptions } from "./shared.js";
+const OPENCODE_EXCLUDED_DIRS = new Set([
+    "sessions",
+    "session",
+    "cache",
+    "auth",
+    "log",
+    "logs",
+    "history",
+    "histories",
+    "share",
+    "database",
+    "databases",
+    "db",
+    "runtime"
+]);
+export const opencodeAdapter = {
+    toolId: "opencode",
+    async scan(context) {
+        const state = createAdapterState();
+        const userOpenCodeDir = path.join(context.homeDir, ".config", "opencode");
+        const projectOpenCodeDir = path.join(context.cwd, ".opencode");
+        for (const configFile of [
+            {
+                path: path.join(context.cwd, "opencode.json"),
+                scope: "project",
+                requiredPath: path.join(context.cwd, "opencode.json")
+            },
+            {
+                path: path.join(context.cwd, "opencode.jsonc"),
+                scope: "project",
+                requiredPath: path.join(context.cwd, "opencode.jsonc")
+            }
+        ]) {
+            await scanJsoncConfig(state, context, configFile.path, configFile.scope, configFile.requiredPath);
+        }
+        await scanMarkdownDirectory(state, context, path.join(userOpenCodeDir, "agent"), "user", "custom_agents", userOpenCodeDir);
+        await scanMarkdownDirectory(state, context, path.join(projectOpenCodeDir, "agent"), "project", "custom_agents", projectOpenCodeDir);
+        await scanMarkdownDirectory(state, context, path.join(userOpenCodeDir, "command"), "user", "custom_commands", userOpenCodeDir);
+        await scanMarkdownDirectory(state, context, path.join(projectOpenCodeDir, "command"), "project", "custom_commands", projectOpenCodeDir);
+        await scanMarkdownDirectory(state, context, path.join(userOpenCodeDir, "tools"), "user", "custom_tools", userOpenCodeDir);
+        await scanMarkdownDirectory(state, context, path.join(projectOpenCodeDir, "tools"), "project", "custom_tools", projectOpenCodeDir);
+        await scanSkillDirectories(state, context, path.join(userOpenCodeDir, "skills"), "user", userOpenCodeDir);
+        await scanSkillDirectories(state, context, path.join(projectOpenCodeDir, "skills"), "project", projectOpenCodeDir);
+        await scanMemoryFile(state, context, path.join(context.cwd, "AGENTS.md"), "project");
+        return { skills: state.skills, warnings: state.warnings };
+    }
+};
+async function scanJsoncConfig(state, context, configPath, scope, requiredPath) {
+    if (!isDiscovered(context, requiredPath)) {
+        return;
+    }
+    const result = await readJsoncFile(configPath, safeReadOptions(configPath, context));
+    addWarningsToState(state, result.warnings);
+    if (!result.ok) {
+        return;
+    }
+    const config = readRecord(result.value);
+    if (!config) {
+        return;
+    }
+    // OpenCode uses key "mcp" directly mapping { serverName: serverConfig }
+    const mcp = readRecord(config.mcp);
+    if (mcp) {
+        for (const [serverName, serverConfig] of Object.entries(mcp)) {
+            if (serverName.trim().length === 0) {
+                continue;
+            }
+            const cfg = readRecord(serverConfig);
+            addSkillToState(state, buildSkill({
+                toolId: "opencode",
+                kind: "mcp_server",
+                name: maskSecretText(serverName),
+                summary: `OpenCode MCP server from ${path.basename(configPath)}.`,
+                scope,
+                sourcePath: configPath,
+                source: "config",
+                details: {
+                    configPath: `mcp.${serverName}`,
+                    command: cfg ? firstString(cfg.command) : undefined,
+                    args: cfg && Array.isArray(cfg.args)
+                        ? cfg.args
+                            .filter((a) => typeof a === "string")
+                            .map((a) => readMaskedUrl(a) ?? a)
+                        : undefined,
+                    envKeys: cfg && readRecord(cfg.env)
+                        ? Object.keys(readRecord(cfg.env) ?? {}).sort()
+                        : undefined
+                }
+            }));
+        }
+    }
+    // Plugins
+    const plugins = config.plugins;
+    if (Array.isArray(plugins)) {
+        for (const [index, entry] of plugins.entries()) {
+            const name = typeof entry === "string" ? maskSecretText(entry) : undefined;
+            if (name) {
+                addSkillToState(state, buildSkill({
+                    toolId: "opencode",
+                    kind: "plugins",
+                    name,
+                    summary: `OpenCode plugin from ${path.basename(configPath)}.`,
+                    scope,
+                    sourcePath: configPath,
+                    source: "config",
+                    details: { configPath: `plugins.${index}` }
+                }));
+            }
+        }
+    }
+    // Tools permissions → single rules skill listing enabled tool keys
+    const tools = readRecord(config.tools);
+    if (tools && Object.keys(tools).length > 0) {
+        const enabledKeys = Object.entries(tools)
+            .filter(([, v]) => v === true)
+            .map(([k]) => k)
+            .sort();
+        addSkillToState(state, buildSkill({
+            toolId: "opencode",
+            kind: "rules",
+            name: `${scope === "user" ? "User" : "Project"} OpenCode tools`,
+            summary: `OpenCode tool permissions from ${path.basename(configPath)}.`,
+            scope,
+            sourcePath: configPath,
+            source: "config",
+            details: { configPath: "tools", keys: enabledKeys }
+        }));
+    }
+    // Local instruction file references — skip remote URLs
+    const instructions = config.instructions;
+    if (Array.isArray(instructions)) {
+        for (const entry of instructions) {
+            if (typeof entry !== "string") {
+                continue;
+            }
+            const trimmed = entry.trim();
+            if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+                continue;
+            }
+            const absPath = path.resolve(context.cwd, trimmed);
+            await scanMemoryFile(state, context, absPath, scope);
+        }
+    }
+}
+async function scanMarkdownDirectory(state, context, dirPath, scope, kind, requiredPath) {
+    if (!isDiscovered(context, requiredPath)) {
+        return;
+    }
+    const files = await collectMarkdownFiles(dirPath, state, context);
+    for (const filePath of files) {
+        if (isExcludedOpenCodePath(filePath)) {
+            continue;
+        }
+        const fallbackName = path
+            .relative(dirPath, filePath)
+            .replace(/\.md$/i, "")
+            .split(path.sep)
+            .join("/");
+        await scanMarkdownSkill(state, context, { filePath, scope, kind, fallbackName });
+    }
+}
+async function scanSkillDirectories(state, context, skillsDir, scope, requiredPath) {
+    if (!isDiscovered(context, requiredPath)) {
+        return;
+    }
+    const entries = await safeReadDirectory(skillsDir, safeReadOptions(skillsDir, context));
+    addWarningsToState(state, entries.warnings);
+    if (!entries.ok) {
+        return;
+    }
+    for (const entry of entries.value) {
+        if ((!entry.isDirectory() && !entry.isSymbolicLink()) || OPENCODE_EXCLUDED_DIRS.has(entry.name)) {
+            continue;
+        }
+        const skillPath = path.join(skillsDir, entry.name, "SKILL.md");
+        await scanMarkdownSkill(state, context, {
+            filePath: skillPath,
+            scope,
+            kind: "agent_skill",
+            fallbackName: entry.name
+        });
+    }
+}
+async function scanMemoryFile(state, context, filePath, scope) {
+    if (!isDiscovered(context, filePath)) {
+        return;
+    }
+    await scanMarkdownSkill(state, context, {
+        filePath,
+        scope,
+        kind: "memory_file",
+        fallbackName: path.basename(filePath)
+    });
+}
+async function scanMarkdownSkill(state, context, options) {
+    const result = await readMarkdownFile(options.filePath, safeReadOptions(options.filePath, context));
+    addWarningsToState(state, result.warnings);
+    if (!result.ok) {
+        return;
+    }
+    const frontmatter = parseMarkdownFrontmatter(result.value, options.filePath);
+    addWarningsToState(state, frontmatter.warnings);
+    const name = firstString(frontmatter.metadata.name, frontmatter.metadata.title) ?? options.fallbackName;
+    const summary = firstString(frontmatter.metadata.description, frontmatter.metadata.summary) ??
+        extractFirstHeading(result.value) ??
+        "OpenCode skill.";
+    const linkDetails = await buildLinkDetails(options.filePath, context);
+    addSkillToState(state, buildSkill({
+        toolId: "opencode",
+        kind: options.kind,
+        name,
+        summary,
+        scope: options.scope,
+        sourcePath: options.filePath,
+        source: "directory",
+        details: {
+            preview: createSanitizedPreview(result.value, options.filePath),
+            lineCount: countTextLines(result.value),
+            ...linkDetails
+        }
+    }));
+}
+function isExcludedOpenCodePath(filePath) {
+    return filePath.split(path.sep).some((segment) => OPENCODE_EXCLUDED_DIRS.has(segment));
+}
+//# sourceMappingURL=opencode.js.map

package/dist/scanner/adapters/opencode.js.map

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

package/dist/scanner/adapters/shared.d.ts

@@ -0,0 +1,57 @@
+import { type Scope, type Skill, type SkillKind, type SkillSource, type ToolId, type Warning } from "../../types.js";
+import type { AdapterContext } from "./index.js";
+export interface AdapterState {
+    skills: Skill[];
+    warnings: Warning[];
+    skillIds: Set<string>;
+    warningIds: Set<string>;
+}
+export declare function createAdapterState(): AdapterState;
+export declare function addSkillToState(state: AdapterState, skill: Skill): void;
+export declare function addWarningsToState(state: AdapterState, warnings: readonly Warning[]): void;
+export declare function buildSkill(input: {
+    toolId: ToolId;
+    kind: SkillKind;
+    name: string;
+    summary: string;
+    scope: Scope;
+    sourcePath: string;
+    source: SkillSource;
+    details?: Record<string, unknown>;
+}): Skill;
+export interface McpEntry {
+    name: string;
+    configPath: string;
+    config: unknown;
+}
+export declare function extractMcpEntries(value: unknown): McpEntry[];
+export declare function createMcpDetails(entry: McpEntry): Record<string, unknown>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readRecord(value: unknown): Record<string, unknown> | undefined;
+export declare function hasMeaningfulValue(value: unknown): boolean;
+export declare function readMaskedString(value: unknown): string | undefined;
+export declare function readMaskedStringArray(value: unknown): string[] | undefined;
+export declare function readMaskedUrl(value: unknown): string | undefined;
+export declare function readMaskedUrlArray(value: unknown): string[] | undefined;
+export declare function firstString(...values: unknown[]): string | undefined;
+export declare function normalizeSummary(summary: string): string;
+export interface MarkdownFrontmatter {
+    metadata: Record<string, unknown>;
+    warnings: Warning[];
+}
+export declare function parseMarkdownFrontmatter(text: string, sourcePath: string): MarkdownFrontmatter;
+export declare function extractFirstHeading(text: string): string | undefined;
+export declare function toSensitivePath(filePath: string, context: Pick<AdapterContext, "cwd" | "homeDir">): string;
+export declare function safeReadOptions(filePath: string, context: Pick<AdapterContext, "cwd" | "homeDir">, extras?: {
+    warnOnMissing?: boolean;
+}): {
+    warnOnMissing: boolean;
+    sensitivePath: string;
+    allowedRoots: string[];
+};
+export declare function buildLinkDetails(filePath: string, context: Pick<AdapterContext, "cwd" | "homeDir">): Promise<{
+    linked?: boolean;
+    linkTarget?: string;
+}>;
+export declare function isDiscovered(context: AdapterContext, filePath: string | undefined): boolean;
+export declare function collectMarkdownFiles(directoryPath: string, state: AdapterState, context: AdapterContext): Promise<string[]>;

package/dist/scanner/adapters/shared.js

@@ -0,0 +1,239 @@
+import path from "node:path";
+import { createSkillId, createWarning } from "../../types.js";
+import { isPathInside, toDisplayPath } from "../paths.js";
+import { parseYamlText } from "../parsing.js";
+import { getLinkInfo, maskSecretText, maskUrl, safeReadDirectory } from "../safety.js";
+export function createAdapterState() {
+    return { skills: [], warnings: [], skillIds: new Set(), warningIds: new Set() };
+}
+export function addSkillToState(state, skill) {
+    if (state.skillIds.has(skill.id)) {
+        return;
+    }
+    state.skillIds.add(skill.id);
+    state.skills.push(skill);
+}
+export function addWarningsToState(state, warnings) {
+    for (const w of warnings) {
+        if (state.warningIds.has(w.id)) {
+            continue;
+        }
+        state.warningIds.add(w.id);
+        state.warnings.push(w);
+    }
+}
+// ─── Skill factory ────────────────────────────────────────────────────────────
+export function buildSkill(input) {
+    return {
+        id: createSkillId({
+            toolId: input.toolId,
+            kind: input.kind,
+            name: input.name,
+            sourcePath: input.sourcePath
+        }),
+        toolId: input.toolId,
+        kind: input.kind,
+        name: normalizeSummary(input.name),
+        summary: normalizeSummary(input.summary),
+        scope: input.scope,
+        sourcePath: input.sourcePath,
+        source: input.source,
+        capabilityCategories: ["unknown"],
+        accessLevel: "unknown",
+        details: input.details
+    };
+}
+export function extractMcpEntries(value) {
+    const entries = [];
+    visitConfigValue(value, [], (key, candidate, configPath) => {
+        if (!isMcpServersKey(key) || !isRecord(candidate)) {
+            return;
+        }
+        for (const [serverName, serverConfig] of Object.entries(candidate)) {
+            if (serverName.trim().length === 0) {
+                continue;
+            }
+            entries.push({
+                name: maskSecretText(serverName),
+                config: serverConfig,
+                configPath: [...configPath, serverName].join(".")
+            });
+        }
+    });
+    return entries;
+}
+export function createMcpDetails(entry) {
+    const config = readRecord(entry.config);
+    if (!config) {
+        return { configPath: entry.configPath };
+    }
+    return {
+        configPath: entry.configPath,
+        command: readMaskedString(config.command),
+        args: readMaskedUrlArray(config.args),
+        url: readMaskedUrl(config.url) ?? readMaskedUrl(config.serverUrl),
+        type: readMaskedString(config.type),
+        transport: readMaskedString(config.transport),
+        disabled: typeof config.disabled === "boolean" ? config.disabled : undefined,
+        envKeys: readRecord(config.env)
+            ? Object.keys(readRecord(config.env) ?? {}).sort()
+            : undefined
+    };
+}
+function visitConfigValue(value, configPath, visitor) {
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => visitConfigValue(item, [...configPath, String(index)], visitor));
+        return;
+    }
+    if (!isRecord(value)) {
+        return;
+    }
+    for (const [key, entryValue] of Object.entries(value)) {
+        const entryPath = [...configPath, key];
+        visitor(key, entryValue, entryPath);
+        if (!isMcpServersKey(key)) {
+            visitConfigValue(entryValue, entryPath, visitor);
+        }
+    }
+}
+function isMcpServersKey(key) {
+    return key === "mcpServers" || key === "mcp_servers";
+}
+// ─── Type guards ──────────────────────────────────────────────────────────────
+export function isRecord(value) {
+    return Object.prototype.toString.call(value) === "[object Object]";
+}
+export function readRecord(value) {
+    return isRecord(value) ? value : undefined;
+}
+export function hasMeaningfulValue(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    if (isRecord(value)) {
+        return Object.keys(value).length > 0;
+    }
+    return value !== undefined && value !== null && value !== "";
+}
+// ─── Masked readers ───────────────────────────────────────────────────────────
+export function readMaskedString(value) {
+    return typeof value === "string" ? maskSecretText(value) : undefined;
+}
+export function readMaskedStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    return value.filter((e) => typeof e === "string").map(maskSecretText);
+}
+export function readMaskedUrl(value) {
+    return typeof value === "string" ? maskUrl(value) : undefined;
+}
+export function readMaskedUrlArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    return value.filter((e) => typeof e === "string").map(maskUrl);
+}
+// ─── String utils ─────────────────────────────────────────────────────────────
+export function firstString(...values) {
+    for (const value of values) {
+        if (typeof value === "string" && value.trim().length > 0) {
+            return maskSecretText(value.trim());
+        }
+    }
+    return undefined;
+}
+export function normalizeSummary(summary) {
+    return summary.replace(/\s+/g, " ").trim();
+}
+export function parseMarkdownFrontmatter(text, sourcePath) {
+    const normalizedText = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    if (!normalizedText.startsWith("---\n")) {
+        return { metadata: {}, warnings: [] };
+    }
+    const closingMatch = /^---\s*$/m.exec(normalizedText.slice(4));
+    if (!closingMatch) {
+        return {
+            metadata: {},
+            warnings: [
+                createWarning({
+                    reason: "parse_failed",
+                    path: sourcePath,
+                    message: `Could not parse ${sourcePath}: unterminated YAML frontmatter`
+                })
+            ]
+        };
+    }
+    const yamlText = normalizedText.slice(4, 4 + closingMatch.index);
+    const parsed = parseYamlText(yamlText, sourcePath);
+    if (!parsed.ok) {
+        return { metadata: {}, warnings: parsed.warnings };
+    }
+    return { metadata: readRecord(parsed.value) ?? {}, warnings: parsed.warnings };
+}
+export function extractFirstHeading(text) {
+    for (const line of text.split(/\r?\n/)) {
+        const match = /^#{1,6}\s+(.+?)\s*$/.exec(line);
+        if (match) {
+            return match[1];
+        }
+    }
+    return undefined;
+}
+// ─── Path utils ───────────────────────────────────────────────────────────────
+export function toSensitivePath(filePath, context) {
+    if (isPathInside(filePath, context.cwd)) {
+        return path.relative(context.cwd, filePath) || path.basename(filePath);
+    }
+    if (isPathInside(filePath, context.homeDir)) {
+        return path.relative(context.homeDir, filePath) || path.basename(filePath);
+    }
+    return path.basename(filePath);
+}
+export function safeReadOptions(filePath, context, extras = {}) {
+    return {
+        warnOnMissing: extras.warnOnMissing ?? false,
+        sensitivePath: toSensitivePath(filePath, context),
+        allowedRoots: [context.homeDir, context.cwd]
+    };
+}
+export async function buildLinkDetails(filePath, context) {
+    const info = await getLinkInfo(filePath);
+    if (!info.linked || !info.linkTarget) {
+        return {};
+    }
+    return {
+        linked: true,
+        linkTarget: toDisplayPath(info.linkTarget, { homeDir: context.homeDir })
+    };
+}
+export function isDiscovered(context, filePath) {
+    if (!filePath) {
+        return true;
+    }
+    return context.discoveredPaths.some((p) => path.resolve(p.path) === path.resolve(filePath));
+}
+// ─── Directory walker ─────────────────────────────────────────────────────────
+export async function collectMarkdownFiles(directoryPath, state, context) {
+    const entries = await safeReadDirectory(directoryPath, safeReadOptions(directoryPath, context));
+    addWarningsToState(state, entries.warnings);
+    if (!entries.ok) {
+        return [];
+    }
+    const files = [];
+    for (const entry of entries.value) {
+        const entryPath = path.join(directoryPath, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await collectMarkdownFiles(entryPath, state, context)));
+            continue;
+        }
+        if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+            if (context.isIgnored?.(path.relative(context.cwd, entryPath))) {
+                continue;
+            }
+            files.push(entryPath);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=shared.js.map

package/dist/scanner/adapters/shared.js.map

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

package/dist/scanner/adapters/skills-sh.d.ts

@@ -0,0 +1,2 @@
+import type { ScannerAdapter } from "./index.js";
+export declare const skillsShAdapter: ScannerAdapter;

package/dist/scanner/adapters/skills-sh.js

@@ -0,0 +1,71 @@
+import path from "node:path";
+import { countTextLines, createSanitizedPreview } from "../preview.js";
+import { readMarkdownFile } from "../parsing.js";
+import { safeReadDirectory } from "../safety.js";
+import { addSkillToState, addWarningsToState, buildLinkDetails, buildSkill, createAdapterState, extractFirstHeading, firstString, isDiscovered, parseMarkdownFrontmatter, safeReadOptions } from "./shared.js";
+export const skillsShAdapter = {
+    toolId: "skills-sh",
+    async scan(context) {
+        const state = createAdapterState();
+        const userSkillsDirs = [
+            path.join(context.homeDir, ".skills"),
+            path.join(context.homeDir, ".config", "skills")
+        ];
+        const projectSkillsDir = path.join(context.cwd, ".skills");
+        for (const dir of userSkillsDirs) {
+            await scanSkillsDirectory(state, context, dir, "user");
+        }
+        await scanSkillsDirectory(state, context, projectSkillsDir, "project");
+        return { skills: state.skills, warnings: state.warnings };
+    }
+};
+async function scanSkillsDirectory(state, context, dirPath, scope) {
+    if (!isDiscovered(context, dirPath)) {
+        return;
+    }
+    const entries = await safeReadDirectory(dirPath, safeReadOptions(dirPath, context));
+    addWarningsToState(state, entries.warnings);
+    if (!entries.ok) {
+        return;
+    }
+    for (const entry of entries.value) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink()) {
+            continue;
+        }
+        await scanSkillEntry(state, context, path.join(dirPath, entry.name), entry.name, scope);
+    }
+}
+async function scanSkillEntry(state, context, skillDir, fallbackName, scope) {
+    const skillMdPath = path.join(skillDir, "SKILL.md");
+    const readmePath = path.join(skillDir, "README.md");
+    for (const filePath of [skillMdPath, readmePath]) {
+        const result = await readMarkdownFile(filePath, safeReadOptions(filePath, context));
+        if (!result.ok) {
+            continue;
+        }
+        const frontmatter = parseMarkdownFrontmatter(result.value, filePath);
+        addWarningsToState(state, frontmatter.warnings);
+        const name = firstString(frontmatter.metadata.name, frontmatter.metadata.title) ??
+            extractFirstHeading(result.value) ??
+            fallbackName;
+        const summary = firstString(frontmatter.metadata.description, frontmatter.metadata.summary) ??
+            "skills.sh skill.";
+        const linkDetails = await buildLinkDetails(filePath, context);
+        addSkillToState(state, buildSkill({
+            toolId: "skills-sh",
+            kind: "skills_sh_skill",
+            name,
+            summary,
+            scope,
+            sourcePath: filePath,
+            source: "directory",
+            details: {
+                preview: createSanitizedPreview(result.value, filePath),
+                lineCount: countTextLines(result.value),
+                ...linkDetails
+            }
+        }));
+        return; // stop after first found file (SKILL.md preferred over README.md)
+    }
+}
+//# sourceMappingURL=skills-sh.js.map

package/dist/scanner/adapters/skills-sh.js.map

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

package/dist/scanner/capability-map.d.ts

@@ -0,0 +1,8 @@
+import type { AccessLevel, CapabilityCategory, Skill } from "../types.js";
+export interface CapabilityClassification {
+    capabilityCategories: CapabilityCategory[];
+    accessLevel: AccessLevel;
+}
+export declare function mapMcpById(mcpId: string | undefined): CapabilityClassification;
+export declare function mapOpenCodeToolKey(key: string): CapabilityClassification;
+export declare function enrichSkill(skill: Skill): void;