@pleaseai/ask 0.1.0 → 0.2.0

package/dist/sources/npm.d.ts

@@ -0,0 +1,14 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+/**
+ * @deprecated Use the npm ecosystem resolver (`resolvers/npm.ts`) + github source
+ * instead. This direct npm tarball source is kept for one release to avoid
+ * regressions in existing configs that specify `source: 'npm'` explicitly.
+ */
+export declare class NpmSource implements DocSource {
+    fetch(options: SourceConfig): Promise<FetchResult>;
+    private detectDocsPath;
+    private listDirs;
+    private collectMarkdownFiles;
+    private isDocFile;
+}
+//# sourceMappingURL=npm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../src/sources/npm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EAEX,YAAY,EACb,MAAM,YAAY,CAAA;AAOnB;;;;GAIG;AACH,qBAAa,SAAU,YAAW,SAAS;IACnC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAsExD,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,SAAS;CAIlB"}

package/dist/sources/npm.js

@@ -0,0 +1,113 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { consola } from 'consola';
+/**
+ * @deprecated Use the npm ecosystem resolver (`resolvers/npm.ts`) + github source
+ * instead. This direct npm tarball source is kept for one release to avoid
+ * regressions in existing configs that specify `source: 'npm'` explicitly.
+ */
+export class NpmSource {
+    async fetch(options) {
+        const opts = options;
+        const pkg = opts.package ?? opts.name;
+        const spec = `${pkg}@${opts.version}`;
+        // Get package info to resolve exact version and tarball URL
+        const resolvedVersion = execSync(`npm view ${spec} version`, {
+            encoding: 'utf-8',
+        }).trim();
+        const tarballUrl = execSync(`npm view ${spec} dist.tarball`, {
+            encoding: 'utf-8',
+        }).trim();
+        const integrity = (() => {
+            try {
+                return execSync(`npm view ${spec} dist.integrity`, {
+                    encoding: 'utf-8',
+                }).trim() || undefined;
+            }
+            catch {
+                return undefined;
+            }
+        })();
+        // Download and extract tarball
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ask-npm-'));
+        try {
+            consola.info(`  Downloading ${pkg}@${resolvedVersion}...`);
+            execSync(`curl -sL "${tarballUrl}" | tar xz -C "${tmpDir}"`, {
+                encoding: 'utf-8',
+            });
+            // Find docs in the extracted package
+            const packageDir = path.join(tmpDir, 'package');
+            const docsPath = opts.docsPath ?? this.detectDocsPath(packageDir);
+            if (!docsPath) {
+                throw new Error(`No docs found in ${spec}. Specify --docs-path to point to the docs directory within the package.`);
+            }
+            const docsDir = path.join(packageDir, docsPath);
+            if (!fs.existsSync(docsDir)) {
+                throw new Error(`Docs path "${docsPath}" not found in ${spec}. Available paths:\n${this.listDirs(packageDir)}`);
+            }
+            let files;
+            if (fs.statSync(docsDir).isFile()) {
+                const content = fs.readFileSync(docsDir, 'utf-8');
+                files = [{ path: path.basename(docsDir), content }];
+            }
+            else {
+                files = this.collectMarkdownFiles(docsDir, docsDir);
+            }
+            return {
+                files,
+                resolvedVersion,
+                meta: { tarball: tarballUrl, integrity },
+            };
+        }
+        finally {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+    detectDocsPath(packageDir) {
+        const candidates = [
+            'docs',
+            'doc',
+            'dist/docs',
+            'documentation',
+            'guide',
+            'guides',
+        ];
+        for (const candidate of candidates) {
+            const fullPath = path.join(packageDir, candidate);
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+                return candidate;
+            }
+        }
+        return null;
+    }
+    listDirs(dir) {
+        return fs
+            .readdirSync(dir, { withFileTypes: true })
+            .filter(d => d.isDirectory())
+            .map(d => `  - ${d.name}/`)
+            .join('\n');
+    }
+    collectMarkdownFiles(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.collectMarkdownFiles(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;
+    }
+    isDocFile(filename) {
+        const ext = path.extname(filename).toLowerCase();
+        return ['.md', '.mdx', '.txt', '.rst'].includes(ext);
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/sources/npm.js.map

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

package/dist/sources/web.d.ts

@@ -0,0 +1,13 @@
+import type { DocSource, FetchResult, SourceConfig } from './index.js';
+export declare class WebSource implements DocSource {
+    private nhm;
+    fetch(options: SourceConfig): Promise<FetchResult>;
+    private crawl;
+    private htmlToMarkdown;
+    private extractMainContent;
+    private extractLinks;
+    private isSkippableUrl;
+    private normalizeUrl;
+    private urlToFilePath;
+}
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/sources/web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAA;AAgBnB,qBAAa,SAAU,YAAW,SAAS;IACzC,OAAO,CAAC,GAAG,CAAyB;IAE9B,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;YAmB1C,KAAK;IA6DnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,YAAY;IA+CpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,aAAa;CAetB"}

package/dist/sources/web.js

@@ -0,0 +1,143 @@
+import { consola } from 'consola';
+import { NodeHtmlMarkdown } from 'node-html-markdown';
+/* eslint-disable regexp/no-unused-capturing-group -- all capturing groups accessed via match[1] */
+const RE_MAIN = /<main[^>]*>([\s\S]*?)<\/main>/i;
+const RE_ARTICLE = /<article[^>]*>([\s\S]*?)<\/article>/i;
+const RE_CONTENT_DIV = /<div[^>]*class="[^"]*(?:content|docs|documentation)[^"]*"[^>]*>([\s\S]*?)<\/div>/i;
+const RE_BODY = /<body[^>]*>([\s\S]*?)<\/body>/i;
+const RE_HREF = /href="([^"]+)"/g;
+const RE_SKIP_EXT = /\.(png|jpg|jpeg|gif|svg|ico|css|js|woff|woff2|ttf|eot)$/i;
+const RE_SKIP_PATH = /\/(api|auth|login|signup|search)\/?$/i;
+/* eslint-enable regexp/no-unused-capturing-group */
+const RE_TRAILING_SLASH = /\/$/;
+const RE_LEADING_SLASH = /^\//;
+export class WebSource {
+    nhm = new NodeHtmlMarkdown();
+    async fetch(options) {
+        const opts = options;
+        const maxDepth = opts.maxDepth ?? 1;
+        const visited = new Set();
+        const files = [];
+        for (const startUrl of opts.urls) {
+            await this.crawl(startUrl, startUrl, maxDepth, 0, visited, files, opts);
+        }
+        if (files.length === 0) {
+            throw new Error(`No documentation content found from URLs: ${opts.urls.join(', ')}`);
+        }
+        return { files, resolvedVersion: opts.version };
+    }
+    async crawl(url, baseUrl, maxDepth, currentDepth, visited, files, opts) {
+        const normalized = this.normalizeUrl(url);
+        if (visited.has(normalized))
+            return;
+        visited.add(normalized);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': 'ask-docs/0.1 (documentation downloader)',
+                    'Accept': 'text/html',
+                },
+            });
+            if (!response.ok) {
+                consola.warn(`  Warning: ${url} returned ${response.status}, skipping`);
+                return;
+            }
+            const contentType = response.headers.get('content-type') ?? '';
+            if (!contentType.includes('text/html'))
+                return;
+            const html = await response.text();
+            const markdown = this.htmlToMarkdown(html, url);
+            if (markdown.trim().length > 0) {
+                const filePath = this.urlToFilePath(url, baseUrl);
+                files.push({ path: filePath, content: markdown });
+                consola.info(`  Fetched: ${url} -> ${filePath}`);
+            }
+            // Crawl linked pages if depth allows
+            if (currentDepth < maxDepth) {
+                const links = this.extractLinks(html, url, baseUrl, opts);
+                for (const link of links) {
+                    await this.crawl(link, baseUrl, maxDepth, currentDepth + 1, visited, files, opts);
+                }
+            }
+        }
+        catch (err) {
+            consola.warn(`  Warning: Failed to fetch ${url}: ${err}`);
+        }
+    }
+    htmlToMarkdown(html, url) {
+        const mainContent = this.extractMainContent(html);
+        const markdown = this.nhm.translate(mainContent);
+        return `<!-- Source: ${url} -->\n\n${markdown}`;
+    }
+    extractMainContent(html) {
+        const patterns = [RE_MAIN, RE_ARTICLE, RE_CONTENT_DIV, RE_BODY];
+        for (const pattern of patterns) {
+            const match = html.match(pattern);
+            if (match)
+                return match[1];
+        }
+        return html;
+    }
+    extractLinks(html, currentUrl, baseUrl, opts) {
+        const links = [];
+        const base = new URL(baseUrl);
+        for (const match of html.matchAll(RE_HREF)) {
+            try {
+                const resolved = new URL(match[1], currentUrl);
+                // Only follow same-origin links
+                if (resolved.origin !== base.origin)
+                    continue;
+                // Filter by path prefix if specified
+                if (opts.allowedPathPrefix) {
+                    if (!resolved.pathname.startsWith(opts.allowedPathPrefix))
+                        continue;
+                }
+                else {
+                    // Default: stay within the base URL's path
+                    const basePath = new URL(baseUrl).pathname;
+                    if (!resolved.pathname.startsWith(basePath))
+                        continue;
+                }
+                // Skip non-doc links
+                if (this.isSkippableUrl(resolved.pathname))
+                    continue;
+                // Remove hash and query
+                resolved.hash = '';
+                resolved.search = '';
+                links.push(resolved.toString());
+            }
+            catch {
+                // Invalid URL, skip
+            }
+        }
+        return links;
+    }
+    isSkippableUrl(pathname) {
+        return RE_SKIP_EXT.test(pathname) || RE_SKIP_PATH.test(pathname);
+    }
+    normalizeUrl(url) {
+        try {
+            const u = new URL(url);
+            u.hash = '';
+            u.search = '';
+            u.pathname = u.pathname.replace(RE_TRAILING_SLASH, '') || '/';
+            return u.toString();
+        }
+        catch {
+            return url;
+        }
+    }
+    urlToFilePath(url, baseUrl) {
+        const u = new URL(url);
+        const base = new URL(baseUrl);
+        let relativePath = u.pathname.replace(base.pathname, '').replace(RE_LEADING_SLASH, '');
+        if (!relativePath)
+            relativePath = 'index';
+        relativePath = relativePath.replace(RE_TRAILING_SLASH, '');
+        if (!relativePath.endsWith('.md')) {
+            relativePath += '.md';
+        }
+        return relativePath;
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/sources/web.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,11 @@
+import type { DocFile } from './sources/index.js';
+export declare function getDocsDir(projectDir: string): string;
+export declare function getLibraryDocsDir(projectDir: string, name: string, version: string): string;
+export declare function saveDocs(projectDir: string, name: string, version: string, files: DocFile[]): string;
+export declare function removeDocs(projectDir: string, name: string, version?: string): void;
+export declare function listDocs(projectDir: string): Array<{
+    name: string;
+    version: string;
+    fileCount: number;
+}>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAKjD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EAAE,GACf,MAAM,CA2BR;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAmBN;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAc7D"}

package/dist/storage.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getAskDir } from './io.js';
+export function getDocsDir(projectDir) {
+    return path.join(getAskDir(projectDir), 'docs');
+}
+export function getLibraryDocsDir(projectDir, name, version) {
+    return path.join(getDocsDir(projectDir), `${name}@${version}`);
+}
+export function saveDocs(projectDir, name, version, files) {
+    const docsDir = getLibraryDocsDir(projectDir, name, version);
+    // Clean existing docs for this library version
+    if (fs.existsSync(docsDir)) {
+        fs.rmSync(docsDir, { recursive: true });
+    }
+    fs.mkdirSync(docsDir, { recursive: true });
+    for (const file of files) {
+        const filePath = path.join(docsDir, file.path);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, file.content, 'utf-8');
+    }
+    // Create an index file listing all docs
+    const index = files
+        .map(f => `- [${f.path}](./${f.path})`)
+        .join('\n');
+    fs.writeFileSync(path.join(docsDir, 'INDEX.md'), `# ${name}@${version} Documentation\n\n${index}\n`, 'utf-8');
+    return docsDir;
+}
+export function removeDocs(projectDir, name, version) {
+    if (version) {
+        const docsDir = getLibraryDocsDir(projectDir, name, version);
+        if (fs.existsSync(docsDir)) {
+            fs.rmSync(docsDir, { recursive: true });
+        }
+    }
+    else {
+        // Remove all versions for this library
+        const baseDir = getDocsDir(projectDir);
+        if (!fs.existsSync(baseDir))
+            return;
+        const entries = fs.readdirSync(baseDir);
+        for (const entry of entries) {
+            if (entry.startsWith(`${name}@`)) {
+                fs.rmSync(path.join(baseDir, entry), { recursive: true });
+            }
+        }
+    }
+}
+export function listDocs(projectDir) {
+    const baseDir = getDocsDir(projectDir);
+    if (!fs.existsSync(baseDir))
+        return [];
+    return fs
+        .readdirSync(baseDir, { withFileTypes: true })
+        .filter(d => d.isDirectory() && d.name.includes('@'))
+        .map((d) => {
+        const [name, version] = d.name.split('@');
+        const dirPath = path.join(baseDir, d.name);
+        const fileCount = countFiles(dirPath);
+        return { name, version, fileCount };
+    });
+}
+function countFiles(dir) {
+    let count = 0;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            count += countFiles(path.join(dir, entry.name));
+        }
+        else {
+            count++;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "@pleaseai/ask",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Agent Skills Kit - Download version-specific library docs for AI coding agents",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pleaseai/ask.git",
+    "directory": "packages/cli"
+  },
   "keywords": [
     "ai",
     "agent",
@@ -12,17 +17,12 @@
     "claude",
     "agents-md"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pleaseai/ask.git",
-    "directory": "packages/cli"
+  "bin": {
+    "ask": "./dist/index.js"
   },
   "files": [
     "dist"
   ],
-  "bin": {
-    "ask": "./dist/index.js"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -34,6 +34,7 @@
     "test": "bun test"
   },
   "dependencies": {
+    "@pleaseai/ask-schema": "0.1.0",
     "citty": "^0.2.2",
     "consola": "^3.4.2",
     "node-html-markdown": "^1.3.0",