@pleaseai/ask 0.1.0 → 0.2.0

package/dist/resolvers/npm.js

@@ -0,0 +1,67 @@
+import { consola } from 'consola';
+import { maxSatisfying, validRange } from 'semver';
+import { parseRepoUrl } from './utils.js';
+const RE_SEMVER_RANGE_CHARS = /[~^>=<|]/g;
+/**
+ * Resolve an npm package to a GitHub repo + git tag.
+ *
+ * 1. Fetch `https://registry.npmjs.org/<name>`
+ * 2. Resolve version: dist-tag → exact, semver range → best match, exact → passthrough
+ * 3. Extract `repository.url` → `owner/repo`
+ * 4. Return `v{version}` as the git ref
+ */
+export class NpmResolver {
+    async resolve(name, version) {
+        const url = `https://registry.npmjs.org/${name}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`npm registry returned ${response.status} for ${name}`);
+        }
+        const meta = await response.json();
+        const distTags = meta['dist-tags'] ?? {};
+        const allVersions = meta.versions ? Object.keys(meta.versions) : [];
+        // Resolve version: dist-tag → semver range → exact
+        let resolvedVersion;
+        if (distTags[version]) {
+            // dist-tag (e.g. 'latest', 'canary')
+            resolvedVersion = distTags[version];
+        }
+        else if (validRange(version) && version !== version.replace(RE_SEMVER_RANGE_CHARS, '')) {
+            // Semver range (e.g. '^15', '~3.22', '>=18.0.0')
+            const best = maxSatisfying(allVersions, version);
+            if (!best) {
+                throw new Error(`No version matching '${version}' found for npm package '${name}'. `
+                    + `Available dist-tags: ${Object.keys(distTags).join(', ')}`);
+            }
+            resolvedVersion = best;
+        }
+        else {
+            // Exact version string
+            resolvedVersion = version;
+        }
+        // Verify the resolved version exists
+        if (allVersions.length > 0 && !allVersions.includes(resolvedVersion)) {
+            throw new Error(`Version '${resolvedVersion}' not found for npm package '${name}'. `
+                + `Available dist-tags: ${Object.keys(distTags).join(', ')}`);
+        }
+        // Extract repository URL
+        const repoField = meta.repository;
+        const repoUrl = typeof repoField === 'string'
+            ? repoField
+            : repoField?.url;
+        const repo = parseRepoUrl(repoUrl);
+        if (!repo) {
+            throw new Error(`Cannot resolve GitHub repository for npm package '${name}'. `
+                + `The 'repository' field is missing or not a GitHub URL. `
+                + `Use 'owner/repo' format instead: ask docs add owner/repo`);
+        }
+        consola.debug(`npm: ${name}@${version} → ${repo}@${resolvedVersion}`);
+        return {
+            repo,
+            ref: `v${resolvedVersion}`,
+            fallbackRefs: [resolvedVersion],
+            resolvedVersion,
+        };
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/resolvers/npm.js.map

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

package/dist/resolvers/pub.d.ts

@@ -0,0 +1,13 @@
+import type { EcosystemResolver, ResolveResult } from './index.js';
+/**
+ * Resolve a pub.dev package to a GitHub repo + git tag.
+ *
+ * 1. Fetch `https://pub.dev/api/packages/<name>`
+ * 2. If version is explicit, verify it exists
+ * 3. Extract `latest.pubspec.repository` → `owner/repo`
+ * 4. Use the version as the git ref
+ */
+export declare class PubResolver implements EcosystemResolver {
+    resolve(name: string, version: string): Promise<ResolveResult>;
+}
+//# sourceMappingURL=pub.d.ts.map

package/dist/resolvers/pub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pub.d.ts","sourceRoot":"","sources":["../../src/resolvers/pub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAkBlE;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA8CrE"}

package/dist/resolvers/pub.js

@@ -0,0 +1,50 @@
+import { consola } from 'consola';
+import { parseRepoUrl } from './utils.js';
+/**
+ * Resolve a pub.dev package to a GitHub repo + git tag.
+ *
+ * 1. Fetch `https://pub.dev/api/packages/<name>`
+ * 2. If version is explicit, verify it exists
+ * 3. Extract `latest.pubspec.repository` → `owner/repo`
+ * 4. Use the version as the git ref
+ */
+export class PubResolver {
+    async resolve(name, version) {
+        const url = `https://pub.dev/api/packages/${name}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`pub.dev returned ${response.status} for ${name}`);
+        }
+        const meta = await response.json();
+        const latestVersion = meta.latest.version;
+        let resolvedVersion;
+        if (version === 'latest') {
+            resolvedVersion = latestVersion;
+        }
+        else {
+            // Verify the requested version exists
+            const allVersions = meta.versions?.map(v => v.version) ?? [];
+            if (allVersions.length > 0 && !allVersions.includes(version)) {
+                throw new Error(`Version '${version}' not found for pub package '${name}'. `
+                    + `Latest version: ${latestVersion}`);
+            }
+            resolvedVersion = version;
+        }
+        // Extract repository URL
+        const repoUrl = meta.latest.pubspec.repository ?? meta.latest.pubspec.homepage;
+        const repo = parseRepoUrl(repoUrl);
+        if (!repo) {
+            throw new Error(`Cannot resolve GitHub repository for pub package '${name}'. `
+                + `The 'repository' field is missing or not a GitHub URL. `
+                + `Use 'owner/repo' format instead: ask docs add owner/repo`);
+        }
+        consola.debug(`pub: ${name}@${version} → ${repo}@${resolvedVersion}`);
+        return {
+            repo,
+            ref: resolvedVersion,
+            fallbackRefs: [`v${resolvedVersion}`],
+            resolvedVersion,
+        };
+    }
+}
+//# sourceMappingURL=pub.js.map

package/dist/resolvers/pub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pub.js","sourceRoot":"","sources":["../../src/resolvers/pub.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAgBzC;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAAe;QACzC,MAAM,GAAG,GAAG,gCAAgC,IAAI,EAAE,CAAA;QAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,QAAQ,IAAI,EAAE,CAAC,CAAA;QACpE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoB,CAAA;QACpD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;QAEzC,IAAI,eAAuB,CAAA;QAC3B,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,eAAe,GAAG,aAAa,CAAA;QACjC,CAAC;aACI,CAAC;YACJ,sCAAsC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YAC5D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,gCAAgC,IAAI,KAAK;sBAC1D,mBAAmB,aAAa,EAAE,CACrC,CAAA;YACH,CAAC;YACD,eAAe,GAAG,OAAO,CAAA;QAC3B,CAAC;QAED,yBAAyB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAA;QAC9E,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAI,KAAK;kBAC5D,yDAAyD;kBACzD,0DAA0D,CAC7D,CAAA;QACH,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,OAAO,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,CAAA;QAErE,OAAO;YACL,IAAI;YACJ,GAAG,EAAE,eAAe;YACpB,YAAY,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC;YACrC,eAAe;SAChB,CAAA;IACH,CAAC;CACF"}

package/dist/resolvers/pypi.d.ts

@@ -0,0 +1,12 @@
+import type { EcosystemResolver, ResolveResult } from './index.js';
+/**
+ * Resolve a PyPI package to a GitHub repo + git tag.
+ *
+ * 1. Fetch `https://pypi.org/pypi/<name>/json` (or `<name>/<version>/json`)
+ * 2. Extract `info.project_urls` → find a GitHub URL
+ * 3. Use the PyPI version as the git ref
+ */
+export declare class PypiResolver implements EcosystemResolver {
+    resolve(name: string, version: string): Promise<ResolveResult>;
+}
+//# sourceMappingURL=pypi.d.ts.map

package/dist/resolvers/pypi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pypi.d.ts","sourceRoot":"","sources":["../../src/resolvers/pypi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAyBlE;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,iBAAiB;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAiDrE"}

package/dist/resolvers/pypi.js

@@ -0,0 +1,60 @@
+import { consola } from 'consola';
+import { parseRepoUrl } from './utils.js';
+/** Keys under `project_urls` most likely to contain a source-code link. */
+const SOURCE_URL_KEYS = [
+    'Source',
+    'Source Code',
+    'Repository',
+    'GitHub',
+    'Code',
+    'Homepage',
+];
+/**
+ * Resolve a PyPI package to a GitHub repo + git tag.
+ *
+ * 1. Fetch `https://pypi.org/pypi/<name>/json` (or `<name>/<version>/json`)
+ * 2. Extract `info.project_urls` → find a GitHub URL
+ * 3. Use the PyPI version as the git ref
+ */
+export class PypiResolver {
+    async resolve(name, version) {
+        const isExplicit = version !== 'latest';
+        const url = isExplicit
+            ? `https://pypi.org/pypi/${name}/${version}/json`
+            : `https://pypi.org/pypi/${name}/json`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`PyPI returned ${response.status} for ${name}${isExplicit ? `@${version}` : ''}`);
+        }
+        const meta = await response.json();
+        const resolvedVersion = meta.info.version;
+        // Find GitHub URL from project_urls
+        const projectUrls = meta.info.project_urls ?? {};
+        let repoUrl = null;
+        for (const key of SOURCE_URL_KEYS) {
+            const candidate = projectUrls[key];
+            if (candidate && candidate.includes('github.com')) {
+                repoUrl = candidate;
+                break;
+            }
+        }
+        // Fall back to home_page
+        if (!repoUrl && meta.info.home_page?.includes('github.com')) {
+            repoUrl = meta.info.home_page;
+        }
+        const repo = parseRepoUrl(repoUrl);
+        if (!repo) {
+            throw new Error(`Cannot resolve GitHub repository for PyPI package '${name}'. `
+                + `The 'project_urls' field does not contain a GitHub URL. `
+                + `Use 'owner/repo' format instead: ask docs add owner/repo`);
+        }
+        consola.debug(`pypi: ${name}@${version} → ${repo}@${resolvedVersion}`);
+        return {
+            repo,
+            ref: `v${resolvedVersion}`,
+            fallbackRefs: [resolvedVersion],
+            resolvedVersion,
+        };
+    }
+}
+//# sourceMappingURL=pypi.js.map

package/dist/resolvers/pypi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pypi.js","sourceRoot":"","sources":["../../src/resolvers/pypi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAazC,2EAA2E;AAC3E,MAAM,eAAe,GAAG;IACtB,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,MAAM;IACN,UAAU;CACX,CAAA;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAAe;QACzC,MAAM,UAAU,GAAG,OAAO,KAAK,QAAQ,CAAA;QACvC,MAAM,GAAG,GAAG,UAAU;YACpB,CAAC,CAAC,yBAAyB,IAAI,IAAI,OAAO,OAAO;YACjD,CAAC,CAAC,yBAAyB,IAAI,OAAO,CAAA;QAExC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,QAAQ,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACnG,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAqB,CAAA;QACrD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAA;QAEzC,oCAAoC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAA;QAChD,IAAI,OAAO,GAAkB,IAAI,CAAA;QAEjC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;YAClC,IAAI,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClD,OAAO,GAAG,SAAS,CAAA;gBACnB,MAAK;YACP,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAA;QAC/B,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,sDAAsD,IAAI,KAAK;kBAC7D,0DAA0D;kBAC1D,0DAA0D,CAC7D,CAAA;QACH,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,OAAO,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,CAAA;QAEtE,OAAO;YACL,IAAI;YACJ,GAAG,EAAE,IAAI,eAAe,EAAE;YAC1B,YAAY,EAAE,CAAC,eAAe,CAAC;YAC/B,eAAe;SAChB,CAAA;IACH,CAAC;CACF"}

package/dist/resolvers/utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse a repository URL into `owner/repo` form.
+ *
+ * Handles common formats:
+ *   - `git+https://github.com/owner/repo.git`
+ *   - `https://github.com/owner/repo`
+ *   - `git://github.com/owner/repo.git`
+ *   - `ssh://git@github.com/owner/repo.git`
+ *   - `github.com/owner/repo`
+ *   - URLs with extra path segments (`/tree/main`, etc.)
+ *
+ * Returns `null` for non-GitHub URLs, empty strings, or undefined.
+ */
+export declare function parseRepoUrl(url: string | undefined | null): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/resolvers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/resolvers/utils.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAW1E"}

package/dist/resolvers/utils.js

@@ -0,0 +1,26 @@
+const RE_GITHUB_URL = /github\.com[/:]([^/]+)\/([^/#?\s]+)/;
+const RE_DOT_GIT = /\.git$/;
+/**
+ * Parse a repository URL into `owner/repo` form.
+ *
+ * Handles common formats:
+ *   - `git+https://github.com/owner/repo.git`
+ *   - `https://github.com/owner/repo`
+ *   - `git://github.com/owner/repo.git`
+ *   - `ssh://git@github.com/owner/repo.git`
+ *   - `github.com/owner/repo`
+ *   - URLs with extra path segments (`/tree/main`, etc.)
+ *
+ * Returns `null` for non-GitHub URLs, empty strings, or undefined.
+ */
+export function parseRepoUrl(url) {
+    if (!url)
+        return null;
+    const match = RE_GITHUB_URL.exec(url);
+    if (!match)
+        return null;
+    const owner = match[1];
+    const repo = match[2].replace(RE_DOT_GIT, '');
+    return `${owner}/${repo}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/resolvers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/resolvers/utils.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,qCAAqC,CAAA;AAC3D,MAAM,UAAU,GAAG,QAAQ,CAAA;AAE3B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,GAA8B;IACzD,IAAI,CAAC,GAAG;QACN,OAAO,IAAI,CAAA;IAEb,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrC,IAAI,CAAC,KAAK;QACR,OAAO,IAAI,CAAA;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAC7C,OAAO,GAAG,KAAK,IAAI,IAAI,EAAE,CAAA;AAC3B,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,2 @@
+export * from '@pleaseai/ask-schema';
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,2 @@
+export * from '@pleaseai/ask-schema';
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/skill.d.ts

@@ -0,0 +1,4 @@
+export declare function getSkillDir(projectDir: string, name: string): string;
+export declare function generateSkill(projectDir: string, name: string, version: string, fileList: string[]): string;
+export declare function removeSkill(projectDir: string, name: string): void;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAIA,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CA+CR;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKlE"}

package/dist/skill.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLibraryDocsDir } from './storage.js';
+export function getSkillDir(projectDir, name) {
+    return path.join(projectDir, '.claude', 'skills', `${name}-docs`);
+}
+export function generateSkill(projectDir, name, version, fileList) {
+    const skillDir = getSkillDir(projectDir, name);
+    fs.mkdirSync(skillDir, { recursive: true });
+    const docsRelPath = path.relative(projectDir, getLibraryDocsDir(projectDir, name, version));
+    const toc = fileList
+        .filter(f => f !== 'INDEX.md')
+        .map(f => `- \`${docsRelPath}/${f}\``)
+        .join('\n');
+    const major = version.split('.')[0];
+    const content = `---
+name: ${name}-docs
+description: ${name} v${version} documentation reference. TRIGGER when writing or modifying code that imports or uses ${name}.
+---
+
+# ${name} v${version} Documentation
+
+This project uses **${name} v${version}**.
+The APIs and patterns may differ from your training data.
+**Read the relevant docs before writing any code.**
+
+## Version
+- Current: \`${version}\`
+- In package.json, use \`"^${major}"\` (NOT older major versions)
+
+## Documentation Location
+\`${docsRelPath}/\`
+
+## Available Guides
+${toc}
+
+## Instructions
+1. Before writing any ${name}-related code, read the relevant guide in \`${docsRelPath}/\`
+2. Heed deprecation notices and breaking changes
+3. Prefer patterns shown in the documentation over patterns from training data
+4. When adding ${name} to package.json, use version \`"^${major}"\`
+`;
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    fs.writeFileSync(skillPath, content, 'utf-8');
+    return skillPath;
+}
+export function removeSkill(projectDir, name) {
+    const skillDir = getSkillDir(projectDir, name);
+    if (fs.existsSync(skillDir)) {
+        fs.rmSync(skillDir, { recursive: true });
+    }
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,IAAY;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,IAAY,EACZ,OAAe,EACf,QAAkB;IAElB,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC9C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAC/B,UAAU,EACV,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAC7C,CAAA;IAED,MAAM,GAAG,GAAG,QAAQ;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,WAAW,IAAI,CAAC,IAAI,CAAC;SACrC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnC,MAAM,OAAO,GAAG;QACV,IAAI;eACG,IAAI,KAAK,OAAO,yFAAyF,IAAI;;;IAGxH,IAAI,KAAK,OAAO;;sBAEE,IAAI,KAAK,OAAO;;;;;eAKvB,OAAO;6BACO,KAAK;;;IAG9B,WAAW;;;EAGb,GAAG;;;wBAGmB,IAAI,+CAA+C,WAAW;;;iBAGrE,IAAI,qCAAqC,KAAK;CAC9D,CAAA;IAEC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACjD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,IAAY;IAC1D,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}

package/dist/sources/github.d.ts

@@ -0,0 +1,14 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+export declare class GithubSource implements DocSource {
+    fetch(options: SourceConfig): Promise<FetchResult>;
+    private detectDocsPath;
+    private collectDocFiles;
+    /**
+     * Resolve a ref (tag or branch) to a full commit sha via `git ls-remote`.
+     * Returns undefined when git is unavailable or the ref cannot be resolved
+     * — the lockfile leaves `commit` undefined rather than guessing.
+     */
+    private resolveCommit;
+    private isDocFile;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/sources/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/sources/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EAEX,YAAY,EACb,MAAM,YAAY,CAAA;AAWnB,qBAAa,YAAa,YAAW,SAAS;IACtC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA4DxD,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;IAmBvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,SAAS;CAIlB"}

package/dist/sources/github.js

@@ -0,0 +1,114 @@
+import { execFileSync, execSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { consola } from 'consola';
+const RE_LEADING_V = /^v/;
+const RE_SHA40 = /^[0-9a-f]{40}$/;
+const RE_WHITESPACE = /\s+/;
+export class GithubSource {
+    async fetch(options) {
+        const opts = options;
+        const { repo, docsPath } = opts;
+        const ref = opts.tag ?? opts.branch ?? 'main';
+        // Resolve the ref to get the actual version (strip leading "v" from tags)
+        const tagVersion = opts.tag?.replace(RE_LEADING_V, '');
+        const resolvedVersion = tagVersion ?? opts.version;
+        // Download repo archive and extract docs
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ask-gh-'));
+        try {
+            const archiveUrl = `https://github.com/${repo}/archive/refs/${opts.tag ? 'tags' : 'heads'}/${ref}.tar.gz`;
+            execSync(`curl -sL "${archiveUrl}" | tar xz -C "${tmpDir}"`, {
+                encoding: 'utf-8',
+            });
+            // Find extracted directory (format: reponame-ref)
+            const extractedDirs = fs.readdirSync(tmpDir);
+            if (extractedDirs.length === 0) {
+                throw new Error(`Failed to extract archive from ${repo}@${ref}`);
+            }
+            const extractedDir = path.join(tmpDir, extractedDirs[0]);
+            // Find docs
+            const targetPath = docsPath ?? this.detectDocsPath(extractedDir);
+            if (!targetPath) {
+                throw new Error(`No docs directory found in ${repo}@${ref}. Specify --path to point to the docs directory.`);
+            }
+            const docsDir = path.join(extractedDir, targetPath);
+            if (!fs.existsSync(docsDir)) {
+                throw new Error(`Path "${targetPath}" not found in ${repo}@${ref}`);
+            }
+            let files;
+            if (fs.statSync(docsDir).isFile()) {
+                // Single file specified
+                const content = fs.readFileSync(docsDir, 'utf-8');
+                files = [{ path: path.basename(docsDir), content }];
+            }
+            else {
+                files = this.collectDocFiles(docsDir, docsDir);
+            }
+            const commit = this.resolveCommit(repo, ref);
+            return {
+                files,
+                resolvedVersion,
+                meta: { commit, ref },
+            };
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+    detectDocsPath(dir) {
+        const candidates = ['docs', 'doc', 'documentation', 'guide', 'guides'];
+        for (const candidate of candidates) {
+            const fullPath = path.join(dir, candidate);
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+                return candidate;
+            }
+        }
+        return null;
+    }
+    collectDocFiles(baseDir, currentDir) {
+        const files = [];
+        const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...this.collectDocFiles(baseDir, fullPath));
+            }
+            else if (this.isDocFile(entry.name)) {
+                const relativePath = path.relative(baseDir, fullPath);
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                files.push({ path: relativePath, content });
+            }
+        }
+        return files;
+    }
+    /**
+     * Resolve a ref (tag or branch) to a full commit sha via `git ls-remote`.
+     * Returns undefined when git is unavailable or the ref cannot be resolved
+     * — the lockfile leaves `commit` undefined rather than guessing.
+     */
+    resolveCommit(repo, ref) {
+        try {
+            // execFileSync (not execSync) to bypass the shell — `ref` originates
+            // from user-supplied tag/branch and must not be interpolated into a
+            // shell command line.
+            const out = execFileSync('git', ['ls-remote', `https://github.com/${repo}.git`, ref], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+            // ls-remote may return multiple lines (e.g. tag + ^{} dereference).
+            // Prefer the dereferenced commit if present.
+            const lines = out.split('\n').filter(Boolean);
+            const dereferenced = lines.find(l => l.includes(`refs/tags/${ref}^{}`));
+            const sha = (dereferenced ?? lines[0])?.split(RE_WHITESPACE)[0];
+            return sha && RE_SHA40.test(sha) ? sha : undefined;
+        }
+        catch (err) {
+            consola.warn(`Could not resolve commit for ${repo}@${ref}: ${err instanceof Error ? err.message : err}. `
+                + 'Lockfile will not pin a commit sha for this entry.');
+            return undefined;
+        }
+    }
+    isDocFile(filename) {
+        const ext = path.extname(filename).toLowerCase();
+        return ['.md', '.mdx', '.txt', '.rst'].includes(ext);
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/sources/github.js.map

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

package/dist/sources/index.d.ts

@@ -0,0 +1,41 @@
+import type { SourceConfig } from '../schemas.js';
+export type { SourceConfig };
+export type NpmSourceOptions = Extract<SourceConfig, {
+    source: 'npm';
+}>;
+export type GithubSourceOptions = Extract<SourceConfig, {
+    source: 'github';
+}>;
+export type WebSourceOptions = Extract<SourceConfig, {
+    source: 'web';
+}>;
+export type LlmsTxtSourceOptions = Extract<SourceConfig, {
+    source: 'llms-txt';
+}>;
+export interface DocFile {
+    path: string;
+    content: string;
+}
+export interface FetchResult {
+    files: DocFile[];
+    resolvedVersion: string;
+    /** Source-specific metadata propagated to ask.lock */
+    meta?: {
+        /** GitHub commit sha (40 hex chars) */
+        commit?: string;
+        /** GitHub ref used (tag name or branch name) */
+        ref?: string;
+        /** npm Subresource Integrity hash from dist.integrity */
+        integrity?: string;
+        /** npm tarball URL */
+        tarball?: string;
+        /** web/llms-txt source URL(s) */
+        urls?: string[];
+    };
+}
+export interface DocSource {
+    fetch: (options: SourceConfig) => Promise<FetchResult>;
+}
+type SourceKind = SourceConfig['source'];
+export declare function getSource(type: SourceKind): DocSource;
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAMjD,YAAY,EAAE,YAAY,EAAE,CAAA;AAM5B,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AACvE,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAA;AAC7E,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AACvE,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAAA;AAEhF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,IAAI,CAAC,EAAE;QACL,uCAAuC;QACvC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,gDAAgD;QAChD,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,yDAAyD;QACzD,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,sBAAsB;QACtB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,iCAAiC;QACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;CACF;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CACvD;AAED,KAAK,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AASxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAErD"}

package/dist/sources/index.js

@@ -0,0 +1,14 @@
+import { GithubSource } from './github.js';
+import { LlmsTxtSource } from './llms-txt.js';
+import { NpmSource } from './npm.js';
+import { WebSource } from './web.js';
+const sources = {
+    'npm': new NpmSource(),
+    'github': new GithubSource(),
+    'web': new WebSource(),
+    'llms-txt': new LlmsTxtSource(),
+};
+export function getSource(type) {
+    return sources[type];
+}
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AA0CpC,MAAM,OAAO,GAAkC;IAC7C,KAAK,EAAE,IAAI,SAAS,EAAE;IACtB,QAAQ,EAAE,IAAI,YAAY,EAAE;IAC5B,KAAK,EAAE,IAAI,SAAS,EAAE;IACtB,UAAU,EAAE,IAAI,aAAa,EAAE;CAChC,CAAA;AAED,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC"}

package/dist/sources/llms-txt.d.ts

@@ -0,0 +1,5 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+export declare class LlmsTxtSource implements DocSource {
+    fetch(options: SourceConfig): Promise<FetchResult>;
+}
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/sources/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../../src/sources/llms-txt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EAEX,YAAY,EACb,MAAM,YAAY,CAAA;AAGnB,qBAAa,aAAc,YAAW,SAAS;IACvC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAqCzD"}

package/dist/sources/llms-txt.js

@@ -0,0 +1,33 @@
+import { consola } from 'consola';
+export class LlmsTxtSource {
+    async fetch(options) {
+        const opts = options;
+        const url = opts.url;
+        consola.info(`  Fetching: ${url}`);
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': 'ask-docs/0.1 (documentation downloader)',
+                'Accept': 'text/plain, text/markdown',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+        }
+        const content = await response.text();
+        if (content.trim().length === 0) {
+            throw new Error(`No content found at ${url}`);
+        }
+        // Determine filename from URL path
+        const urlObj = new URL(url);
+        const filename = urlObj.pathname.split('/').pop() || 'llms.txt';
+        const filePath = filename.endsWith('.md') || filename.endsWith('.txt')
+            ? filename
+            : `${filename}.md`;
+        consola.info(`  Fetched: ${url} -> ${filePath} (${content.length} chars)`);
+        return {
+            files: [{ path: filePath, content }],
+            resolvedVersion: opts.version,
+        };
+    }
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/sources/llms-txt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.js","sourceRoot":"","sources":["../../src/sources/llms-txt.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,MAAM,IAAI,GAAG,OAA+B,CAAA;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QAEpB,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,CAAA;QAElC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,YAAY,EAAE,yCAAyC;gBACvD,QAAQ,EAAE,2BAA2B;aACtC;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QACtF,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAErC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAA;QAC/C,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,UAAU,CAAA;QAC/D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YACpE,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAA;QAEpB,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,OAAO,QAAQ,KAAK,OAAO,CAAC,MAAM,SAAS,CAAC,CAAA;QAE1E,OAAO;YACL,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YACpC,eAAe,EAAE,IAAI,CAAC,OAAO;SAC9B,CAAA;IACH,CAAC;CACF"}