@feiyoug/skill-lab 0.0.0

package/esm/skillreader/github/utils.js

@@ -0,0 +1,37 @@
+export function parseGitHubRepo(repoUrl) {
+    try {
+        const parsed = new URL(repoUrl);
+        if (!(parsed.hostname === "github.com" || parsed.hostname === "www.github.com")) {
+            return null;
+        }
+        const match = parsed.pathname.match(/^\/([^\/]+)\/([^\/]+?)(\.git)?$/);
+        if (!match)
+            return null;
+        return { owner: match[1], repo: match[2] };
+    }
+    catch {
+        return null;
+    }
+}
+export function buildPrefix(baseDir, extraDir) {
+    const cleanedBase = baseDir?.replace(/^\/+|\/+$/g, "") ?? "";
+    const cleanedExtra = extraDir?.replace(/^\/+|\/+$/g, "") ?? "";
+    const combined = [cleanedBase, cleanedExtra].filter(Boolean).join("/");
+    return combined ? `${combined}/` : "";
+}
+export function normalizeRelativePath(prefix, fullPath) {
+    if (!prefix)
+        return fullPath;
+    if (!fullPath.startsWith(prefix))
+        return "";
+    return fullPath.slice(prefix.length);
+}
+export function buildGitHubHeaders(token) {
+    const headers = {
+        Accept: "application/vnd.github.v3+json",
+        "User-Agent": "goskilla-api",
+    };
+    if (token)
+        headers.Authorization = `Bearer ${token}`;
+    return headers;
+}

package/esm/skillreader/manifest.d.ts

@@ -0,0 +1,15 @@
+import type { SkillFile, SkillFileManifest, SkillManifest, SkillZipManifest, ZipManifestFile } from "./types.js";
+export declare const SKILL_MANIFEST_VERSION: 1;
+export declare const SKILL_ZIP_MANIFEST_VERSION: 2;
+export declare function createSkillManifest(files: SkillFile[]): SkillFileManifest;
+export declare function createZipManifest(files: ZipManifestFile[], metadata: {
+    skillVersionId: string;
+    repoUrl: string;
+    commitHash: string;
+    dir?: string | null;
+    checksum: string;
+    compression: "deflate" | "store";
+}): SkillZipManifest;
+export declare function parseSkillManifest(text: string): SkillManifest | null;
+export declare function isZipManifest(manifest: SkillManifest): manifest is SkillZipManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/esm/skillreader/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/skillreader/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,eAAe,EAClB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AACjD,eAAO,MAAM,0BAA0B,EAAG,CAAU,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAMzE;AAED,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,EAAE;IACN,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;CACpC,GACF,gBAAgB,CAalB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAkBrE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,QAAQ,IAAI,gBAAgB,CAEnF"}

package/esm/skillreader/manifest.js

@@ -0,0 +1,50 @@
+export const SKILL_MANIFEST_VERSION = 1;
+export const SKILL_ZIP_MANIFEST_VERSION = 2;
+export function createSkillManifest(files) {
+    return {
+        version: SKILL_MANIFEST_VERSION,
+        generatedAt: new Date().toISOString(),
+        files,
+    };
+}
+export function createZipManifest(files, metadata) {
+    return {
+        version: SKILL_ZIP_MANIFEST_VERSION,
+        storage_method: "zip",
+        compression: metadata.compression,
+        skill_version_id: metadata.skillVersionId,
+        repo_url: metadata.repoUrl,
+        commit_hash: metadata.commitHash,
+        dir: metadata.dir ?? null,
+        created_at: new Date().toISOString(),
+        checksum: metadata.checksum,
+        files,
+    };
+}
+export function parseSkillManifest(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (!Array.isArray(parsed.files))
+            return null;
+        if (parsed.version === SKILL_MANIFEST_VERSION) {
+            return parsed;
+        }
+        if (parsed.version === SKILL_ZIP_MANIFEST_VERSION) {
+            const zipManifest = parsed;
+            if (zipManifest.storage_method !== "zip")
+                return null;
+            if (!zipManifest.compression)
+                return null;
+            return zipManifest;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function isZipManifest(manifest) {
+    return manifest.storage_method === "zip";
+}

package/esm/skillreader/mod.d.ts

@@ -0,0 +1,12 @@
+import "../_dnt.polyfills.js";
+export type { SkillFile, SkillFileManifest, SkillFrontmatter, SkillManifest, SkillReader, SkillZipManifest, ZipManifestFile, } from "./types.js";
+export { createSkillManifest, createZipManifest, isZipManifest, parseSkillManifest, SKILL_MANIFEST_VERSION, SKILL_ZIP_MANIFEST_VERSION, } from "./manifest.js";
+export { LocalFsSkillReader } from "./fs/mod.js";
+export { SkillReaderFactory } from "./factory.js";
+export type { SkillReaderFactoryOptions } from "./factory.js";
+export { Analyzer } from "../analyzer/mod.js";
+export type { AnalyzerAnalyzeInput } from "../analyzer/mod.js";
+export { GitHubApiSkillReader, GitHubRawSkillReader, GitHubSkillReader } from "./github/mod.js";
+export { CloudStorageSkillReader } from "./cloudStorage/mod.js";
+export type { CloudStorageSkillReaderOptions } from "./cloudStorage/mod.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/skillreader/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/skillreader/mod.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,YAAY,EACR,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC"}

package/esm/skillreader/mod.js

@@ -0,0 +1,7 @@
+import "../_dnt.polyfills.js";
+export { createSkillManifest, createZipManifest, isZipManifest, parseSkillManifest, SKILL_MANIFEST_VERSION, SKILL_ZIP_MANIFEST_VERSION, } from "./manifest.js";
+export { LocalFsSkillReader } from "./fs/mod.js";
+export { SkillReaderFactory } from "./factory.js";
+export { Analyzer } from "../analyzer/mod.js";
+export { GitHubApiSkillReader, GitHubRawSkillReader, GitHubSkillReader } from "./github/mod.js";
+export { CloudStorageSkillReader } from "./cloudStorage/mod.js";

package/esm/skillreader/types.d.ts

@@ -0,0 +1,79 @@
+import { FileType } from "../shared/mod.js";
+export type SkillFile = {
+    path: string;
+    size?: number;
+    contentType: FileType;
+};
+export type SkillFileManifest = {
+    version: 1;
+    generatedAt: string;
+    files: SkillFile[];
+};
+export type ZipManifestFile = {
+    path: string;
+    size: number;
+    offset: number;
+    compressedSize: number;
+    compressionMethod: number;
+    signature: number;
+};
+export type SkillZipManifest = {
+    version: 2;
+    storage_method: "zip";
+    compression: "deflate" | "store";
+    skill_version_id: string;
+    repo_url: string;
+    commit_hash: string;
+    dir: string | null;
+    created_at: string;
+    checksum: string;
+    files: ZipManifestFile[];
+};
+export type SkillManifest = SkillFileManifest | SkillZipManifest;
+export type SkillFrontmatter = {
+    startLineNumer?: number;
+    endLineNumer?: number;
+    name: string;
+    description: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, unknown>;
+    "allowed-tools"?: string;
+    [key: string]: unknown;
+};
+export declare abstract class SkillReader {
+    /**
+     * A cached path to the root SKILL.md file in this skill repository
+     */
+    private skillMdPatah;
+    /**
+     * A cached list of files in this skill repository.
+     */
+    private files;
+    /**
+     * A cached parsed SKILL.md frontmatter.
+     */
+    private skillFrontMatter;
+    abstract retrieveFiles(dir?: string): Promise<SkillFile[]>;
+    abstract readTextFile(path: string): Promise<string | null>;
+    abstract readFile(path: string): Promise<ReadableStream<Uint8Array> | null>;
+    abstract readManifest(): Promise<SkillManifest | null>;
+    listFiles(): Promise<SkillFile[]>;
+    /**
+     * Return the path to SKILL.md if it exists, or throw if not.
+     */
+    getSkillMdPath(): Promise<string>;
+    /**
+     * Returns full SKILL.md content, or throws when the repository is not a valid skill.
+     */
+    getSkillMdContent(): Promise<string>;
+    /**
+     * Parses SKILL.md frontmatter and guarantees required fields.
+     */
+    getSkillMdFrontmatter(): Promise<SkillFrontmatter>;
+    validate(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/skillreader/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skillreader/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,EAAE,KAAK,CAAC;IACtB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,8BAAsB,WAAW;IAC7B;;OAEG;IACH,OAAO,CAAC,YAAY,CAAiC;IAErD;;OAEG;IACH,OAAO,CAAC,KAAK,CAAsC;IAEnD;;OAEG;IACH,OAAO,CAAC,gBAAgB,CAA2C;IAEnE,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAC1D,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC3E,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAEzC,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAO9C;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAc9C;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IASjD;;OAEG;IACU,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2BlD,QAAQ,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CASrE"}

package/esm/skillreader/types.js

@@ -0,0 +1,102 @@
+import { parse as parseYaml } from "../deps/jsr.io/@std/yaml/1.0.11/mod.js";
+import { extractFrontmatter } from "./utils/frontmatter-parser.js";
+export class SkillReader {
+    constructor() {
+        /**
+         * A cached path to the root SKILL.md file in this skill repository
+         */
+        Object.defineProperty(this, "skillMdPatah", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+        /**
+         * A cached list of files in this skill repository.
+         */
+        Object.defineProperty(this, "files", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+        /**
+         * A cached parsed SKILL.md frontmatter.
+         */
+        Object.defineProperty(this, "skillFrontMatter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+    }
+    async listFiles() {
+        if (!this.files) {
+            this.files = await this.retrieveFiles();
+        }
+        return this.files;
+    }
+    /**
+     * Return the path to SKILL.md if it exists, or throw if not.
+     */
+    async getSkillMdPath() {
+        if (this.skillMdPatah)
+            return this.skillMdPatah;
+        const files = await this.retrieveFiles();
+        const rootPath = files.find((file) => file.path.toLowerCase() === "skill.md");
+        if (!rootPath?.path) {
+            throw new Error("Invalid skill repository: SKILL.md not found");
+        }
+        this.skillMdPatah = rootPath.path;
+        return this.skillMdPatah;
+    }
+    /**
+     * Returns full SKILL.md content, or throws when the repository is not a valid skill.
+     */
+    async getSkillMdContent() {
+        const skillMdPath = await this.getSkillMdPath();
+        const content = await this.readTextFile(skillMdPath);
+        if (!content) {
+            throw new Error("Invalid skill repository: SKILL.md is unreadable");
+        }
+        return content;
+    }
+    /**
+     * Parses SKILL.md frontmatter and guarantees required fields.
+     */
+    async getSkillMdFrontmatter() {
+        if (this.skillFrontMatter)
+            return this.skillFrontMatter;
+        const content = await this.getSkillMdContent();
+        const frontmatter = await extractFrontmatter(content);
+        if (!frontmatter) {
+            throw new Error("Invalid skill repository: SKILL.md missing YAML frontmatter");
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(frontmatter.content) ??
+                {};
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Invalid skill repository: YAML frontmatter parse failed: ${message}`);
+        }
+        if (!parsed.name || !parsed.description) {
+            throw new Error("Invalid skill repository: frontmatter requires name and description");
+        }
+        parsed.startLineNumer = frontmatter.startLine;
+        parsed.endLineNumer = frontmatter.endLine;
+        this.skillFrontMatter = parsed;
+        return this.skillFrontMatter;
+    }
+    async validate() {
+        try {
+            await this.getSkillMdFrontmatter();
+            return { ok: true };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { ok: false, reason: message };
+        }
+    }
+}

package/esm/skillreader/utils/frontmatter-parser.d.ts

@@ -0,0 +1,7 @@
+export type FrontmatterInfo = {
+    content: string;
+    startLine: number;
+    endLine: number;
+};
+export declare function extractFrontmatter(content: string): Promise<FrontmatterInfo | null>;
+//# sourceMappingURL=frontmatter-parser.d.ts.map

package/esm/skillreader/utils/frontmatter-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../../../src/skillreader/utils/frontmatter-parser.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAwBzF"}

package/esm/skillreader/utils/frontmatter-parser.js

@@ -0,0 +1,51 @@
+let parserInstance = null;
+export async function extractFrontmatter(content) {
+    try {
+        const parser = await getParser();
+        const tree = parser.parse(content);
+        const frontmatterNode = findFrontmatterNode(tree.rootNode);
+        if (!frontmatterNode)
+            return null;
+        const matched = frontmatterNode.text.match(/^---\n([\s\S]*?)\n---/);
+        if (!matched)
+            return null;
+        return {
+            content: matched[1],
+            startLine: frontmatterNode.startPosition.row + 1,
+            endLine: frontmatterNode.endPosition.row + 1,
+        };
+    }
+    catch {
+        const matched = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!matched)
+            return null;
+        return {
+            content: matched[1],
+            startLine: 1,
+            endLine: matched[0].split("\n").length,
+        };
+    }
+}
+function findFrontmatterNode(node) {
+    if (node.type.includes("yaml") && node.startPosition.row === 0) {
+        return node;
+    }
+    for (const child of node.children) {
+        const found = findFrontmatterNode(child);
+        if (found)
+            return found;
+    }
+    return null;
+}
+async function getParser() {
+    if (parserInstance)
+        return parserInstance;
+    const [{ default: Parser }, markdownModule] = await Promise.all([
+        import("tree-sitter"),
+        import("@tree-sitter-grammars/tree-sitter-markdown"),
+    ]);
+    const parser = new Parser();
+    parser.setLanguage((markdownModule.default ?? markdownModule));
+    parserInstance = parser;
+    return parser;
+}

package/esm/skillreader/utils/http-range.d.ts

@@ -0,0 +1,4 @@
+export declare function fetchContentLength(url: string): Promise<number>;
+export declare function fetchRangeStream(url: string, start: number, length: number): Promise<ReadableStream<Uint8Array>>;
+export declare function decompressDeflateStream(stream: ReadableStream<Uint8Array>): ReadableStream<Uint8Array>;
+//# sourceMappingURL=http-range.d.ts.map

package/esm/skillreader/utils/http-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-range.d.ts","sourceRoot":"","sources":["../../../src/skillreader/utils/http-range.ts"],"names":[],"mappings":"AAIA,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUrE;AAED,wBAAsB,gBAAgB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAQrC;AAED,wBAAgB,uBAAuB,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,cAAc,CAAC,UAAU,CAAC,CAK5B"}

package/esm/skillreader/utils/http-range.js

@@ -0,0 +1,30 @@
+import { Readable as NodeReadable } from "node:stream";
+import { createInflateRaw } from "node:zlib";
+export async function fetchContentLength(url) {
+    const res = await fetch(url, { method: "HEAD" });
+    if (!res.ok) {
+        throw new Error(`HEAD ${url} failed: ${res.status} ${res.statusText}`);
+    }
+    const len = res.headers.get("content-length");
+    if (!len)
+        throw new Error("No content-length header");
+    const size = Number.parseInt(len, 10);
+    if (Number.isNaN(size))
+        throw new Error(`Invalid content-length: ${len}`);
+    return size;
+}
+export async function fetchRangeStream(url, start, length) {
+    const end = start + length - 1;
+    const range = `bytes=${start}-${end}`;
+    const res = await fetch(url, { headers: { Range: range } });
+    if (!res.ok || !res.body) {
+        throw new Error(`Range read failed: ${res.status} ${res.statusText}`);
+    }
+    return res.body;
+}
+export function decompressDeflateStream(stream) {
+    const nodeStream = NodeReadable.fromWeb(stream);
+    const inflater = createInflateRaw();
+    const decompressed = nodeStream.pipe(inflater);
+    return NodeReadable.toWeb(decompressed);
+}

package/esm/skillreader/utils/mod.d.ts

@@ -0,0 +1,4 @@
+export declare function isProbablyText(bytes: Uint8Array): boolean;
+export * from "./frontmatter-parser.js";
+export * from "./http-range.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/skillreader/utils/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/skillreader/utils/mod.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAQzD;AAED,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/esm/skillreader/utils/mod.js

@@ -0,0 +1,13 @@
+export function isProbablyText(bytes) {
+    const sample = bytes.subarray(0, Math.min(bytes.length, 2048));
+    let controlCount = 0;
+    for (const byte of sample) {
+        if (byte === 0)
+            return false;
+        if (byte < 9 || (byte > 13 && byte < 32))
+            controlCount += 1;
+    }
+    return controlCount / Math.max(sample.length, 1) < 0.1;
+}
+export * from "./frontmatter-parser.js";
+export * from "./http-range.js";

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@feiyoug/skill-lab",
+  "version": "0.0.0",
+  "description": "Skill Lab library exports for analyzer and skill readers",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FeiyouG/skill-lab.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/FeiyouG/skill-lab/issues"
+  },
+  "main": "./script/skillreader/mod.js",
+  "module": "./esm/skillreader/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/skillreader/mod.js",
+      "require": "./script/skillreader/mod.js"
+    }
+  },
+  "scripts": {},
+  "dependencies": {
+    "@deno/shim-deno": "~0.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}

package/script/_dnt.polyfills.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/script/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAeA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}

package/script/_dnt.polyfills.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
+}

package/script/_dnt.shims.d.ts

@@ -0,0 +1,6 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/script/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}

package/script/_dnt.shims.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = exports.Deno = void 0;
+const shim_deno_1 = require("@deno/shim-deno");
+var shim_deno_2 = require("@deno/shim-deno");
+Object.defineProperty(exports, "Deno", { enumerable: true, get: function () { return shim_deno_2.Deno; } });
+const dntGlobals = {
+    Deno: shim_deno_1.Deno,
+};
+exports.dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/script/analyzer/astgrep/client.d.ts

@@ -0,0 +1,35 @@
+import { parse } from "@ast-grep/napi";
+import type { Finding, PermissionScope, Reference, ReferenceType, RuleRiskMapping } from "../../shared/mod.js";
+import { type AstGrepGrammar } from "./registry.js";
+export type AstGrepRule = {
+    id: string;
+    description: string;
+    grammar: AstGrepGrammar;
+    patterns: string[];
+    permission: {
+        tool: string;
+        scope: PermissionScope;
+        permission: string;
+        metadata?: Record<string, string>;
+        mappedRisks?: RuleRiskMapping[];
+    };
+};
+export type AstGrepMatch = {
+    ruleId: string;
+    line: number;
+    lineEnd?: number;
+    extracted: Record<string, unknown>;
+};
+export declare class AstGrepClient {
+    private isLanguageRegistryInitialized;
+    private PARSE_CACHE_BY_GRAMMAR;
+    /** Parse content for direct AST traversal using kind/composite rules. */
+    parse(language: AstGrepRule["grammar"] | "markdown", content: string): ReturnType<typeof parse>;
+    scanWithRules(content: string, language: AstGrepRule["grammar"], rules: AstGrepRule[]): AstGrepMatch[];
+    matchesToFindings(file: string, type: ReferenceType, matches: AstGrepMatch[], referencedBy?: Reference): Finding[];
+    private ensureLanguageRegistry;
+    private stripQuotes;
+    private getParseCache;
+    private hashContent;
+}
+//# sourceMappingURL=client.d.ts.map

package/script/analyzer/astgrep/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/analyzer/astgrep/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAA2B,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EACR,OAAO,EACP,eAAe,EACf,SAAS,EACT,aAAa,EACb,eAAe,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,KAAK,cAAc,EAGtB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,WAAW,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,eAAe,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;KACnC,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,qBAAa,aAAa;IACtB,OAAO,CAAC,6BAA6B,CAAS;IAC9C,OAAO,CAAC,sBAAsB,CAKvB;IAEP,yEAAyE;IAClE,KAAK,CACR,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,UAAU,EAC7C,OAAO,EAAE,MAAM,GAChB,UAAU,CAAC,OAAO,KAAK,CAAC;IAoBpB,aAAa,CAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,EAChC,KAAK,EAAE,WAAW,EAAE,GACrB,YAAY,EAAE;IAyCV,iBAAiB,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,YAAY,EAAE,EACvB,YAAY,CAAC,EAAE,SAAS,GACzB,OAAO,EAAE;IAcZ,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CAStB"}