@autonav/core 1.0.0 → 1.1.0

package/dist/repo-analyzer/index.js

@@ -0,0 +1,148 @@
+import { query } from "@anthropic-ai/claude-agent-sdk";
+/**
+ * Repository Analyzer
+ *
+ * Uses Claude to analyze scan results and infer navigator configuration.
+ */
+// Model to use for analysis
+const ANALYSIS_MODEL = "claude-sonnet-4-5";
+/**
+ * Build the analysis prompt from scan results
+ */
+function buildAnalysisPrompt(scanResult) {
+    const { files, directoryStructure, projectMetadata, stats } = scanResult;
+    // Build file content section
+    const fileContents = files
+        .filter((f) => f.content)
+        .map((f) => `### ${f.relativePath}\n\`\`\`\n${f.content}\n\`\`\``)
+        .join("\n\n");
+    return `You are analyzing a repository to create a knowledge navigator configuration.
+
+## Repository Structure
+
+\`\`\`
+${directoryStructure}
+\`\`\`
+
+## Project Metadata
+
+${projectMetadata.name ? `- **Name**: ${projectMetadata.name}` : ""}
+${projectMetadata.description ? `- **Description**: ${projectMetadata.description}` : ""}
+${projectMetadata.language ? `- **Language**: ${projectMetadata.language}` : ""}
+${projectMetadata.keywords?.length ? `- **Keywords**: ${projectMetadata.keywords.join(", ")}` : ""}
+${projectMetadata.dependencies?.length ? `- **Dependencies**: ${projectMetadata.dependencies.slice(0, 10).join(", ")}${projectMetadata.dependencies.length > 10 ? "..." : ""}` : ""}
+
+## Scan Statistics
+
+- Total files: ${stats.totalFiles}
+- Files scanned: ${stats.scannedFiles}
+- Strategy used: ${stats.strategy}
+
+## File Contents
+
+${fileContents}
+
+---
+
+Based on this repository analysis, provide a navigator configuration. Respond with ONLY a JSON object in this exact format:
+
+\`\`\`json
+{
+  "purpose": "A one-sentence description of what this repository/project does",
+  "scope": "Topics this navigator should cover (in-scope) and what it should NOT cover (out-of-scope)",
+  "audience": "Who would use this navigator and what communication style is appropriate",
+  "suggestedKnowledgePaths": ["array", "of", "paths", "to", "use", "as", "knowledge"],
+  "confidence": 0.85
+}
+\`\`\`
+
+Guidelines:
+- purpose: Be specific and accurate based on the actual code/docs
+- scope: List specific topics, not vague categories
+- audience: Consider the project type (library, application, internal tool, etc.)
+- suggestedKnowledgePaths: Include paths that contain useful documentation (README.md, docs/, etc.)
+- confidence: 0.0-1.0, how confident you are in this analysis (lower if repo has minimal docs)
+
+Respond ONLY with the JSON block, no other text.`;
+}
+/**
+ * Parse the analysis response from Claude
+ */
+function parseAnalysisResponse(response) {
+    // Extract JSON from response
+    const jsonMatch = response.match(/```json\s*([\s\S]*?)```/);
+    const jsonStr = jsonMatch?.[1] ?? response;
+    try {
+        const parsed = JSON.parse(jsonStr.trim());
+        // Validate required fields
+        if (typeof parsed.purpose !== "string" ||
+            typeof parsed.scope !== "string" ||
+            typeof parsed.audience !== "string" ||
+            !Array.isArray(parsed.suggestedKnowledgePaths) ||
+            typeof parsed.confidence !== "number") {
+            return null;
+        }
+        return {
+            purpose: parsed.purpose,
+            scope: parsed.scope,
+            audience: parsed.audience,
+            suggestedKnowledgePaths: parsed.suggestedKnowledgePaths,
+            confidence: Math.max(0, Math.min(1, parsed.confidence)),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Analyze a scanned repository using Claude
+ */
+export async function analyzeRepository(scanResult) {
+    const prompt = buildAnalysisPrompt(scanResult);
+    try {
+        const queryInstance = query({
+            prompt,
+            options: {
+                model: ANALYSIS_MODEL,
+                permissionMode: "bypassPermissions",
+            },
+        });
+        let responseText = "";
+        for await (const message of queryInstance) {
+            if (message.type === "assistant") {
+                const content = message.message.content;
+                const textBlocks = content.filter((b) => b.type === "text");
+                responseText = textBlocks.map((b) => b.text).join("\n");
+            }
+        }
+        const result = parseAnalysisResponse(responseText);
+        if (!result) {
+            // Return a default with low confidence if parsing failed
+            return {
+                purpose: scanResult.projectMetadata.description || "A software project",
+                scope: "This repository's code and documentation",
+                audience: "Developers working with this codebase",
+                suggestedKnowledgePaths: scanResult.files
+                    .filter((f) => f.type === "readme" || f.type === "docs")
+                    .map((f) => f.relativePath)
+                    .slice(0, 5),
+                confidence: 0.3,
+            };
+        }
+        return result;
+    }
+    catch (error) {
+        // Return a fallback on error
+        return {
+            purpose: scanResult.projectMetadata.description || scanResult.projectMetadata.name || "A software project",
+            scope: "This repository's code and documentation",
+            audience: "Developers working with this codebase",
+            suggestedKnowledgePaths: scanResult.files
+                .filter((f) => f.type === "readme" || f.type === "docs")
+                .map((f) => f.relativePath)
+                .slice(0, 5),
+            confidence: 0.2,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/repo-analyzer/index.js.map

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

package/dist/repo-scanner/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Repository Scanner
+ *
+ * Scans an existing repository to understand its structure and content
+ * for importing as a knowledge base.
+ */
+export interface ScannedFile {
+    path: string;
+    relativePath: string;
+    type: "readme" | "config" | "docs" | "source" | "other";
+    size: number;
+    content?: string;
+    modifiedAt: Date;
+}
+export interface ProjectMetadata {
+    name?: string;
+    description?: string;
+    keywords?: string[];
+    language?: string;
+    dependencies?: string[];
+}
+export interface ScanStats {
+    totalFiles: number;
+    totalSize: number;
+    scannedFiles: number;
+    scannedSize: number;
+    strategy: "full" | "truncated" | "sampled";
+}
+export interface ScanResult {
+    files: ScannedFile[];
+    directoryStructure: string;
+    projectMetadata: ProjectMetadata;
+    stats: ScanStats;
+    warnings: string[];
+}
+export interface ScanOptions {
+    /** Maximum total content to read in bytes (default: 100KB) */
+    maxContentSize?: number;
+    /** Whether to respect .gitignore (default: true) */
+    respectGitignore?: boolean;
+    /** Additional paths to skip */
+    skipPaths?: string[];
+}
+/**
+ * Scan a repository to understand its structure and content
+ */
+export declare function scanRepository(repoPath: string, options?: ScanOptions): Promise<ScanResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/repo-scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repo-scanner/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAiYD;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAiErB"}

package/dist/repo-scanner/index.js

@@ -0,0 +1,385 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import ignore from "ignore";
+// Default paths to always skip
+const DEFAULT_SKIP_PATHS = [
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    "vendor",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "target", // Rust
+    ".cargo",
+    "coverage",
+    ".nyc_output",
+    ".cache",
+    ".parcel-cache",
+    ".turbo",
+];
+// File priority for scanning (lower = higher priority)
+const FILE_PRIORITY = {
+    "README.md": 1,
+    "README": 1,
+    "readme.md": 1,
+    "package.json": 2,
+    "Cargo.toml": 2,
+    "pyproject.toml": 2,
+    "go.mod": 2,
+    "composer.json": 2,
+    "pom.xml": 2,
+    "build.gradle": 2,
+    "ARCHITECTURE.md": 3,
+    "CONTRIBUTING.md": 3,
+    "CHANGELOG.md": 4,
+};
+/**
+ * Categorize a file based on its path and name
+ */
+function categorizeFile(relativePath) {
+    const basename = path.basename(relativePath).toLowerCase();
+    const ext = path.extname(relativePath).toLowerCase();
+    // READMEs
+    if (basename.startsWith("readme")) {
+        return "readme";
+    }
+    // Config files
+    if (["package.json", "cargo.toml", "pyproject.toml", "go.mod", "composer.json", "pom.xml", "build.gradle"].includes(basename)) {
+        return "config";
+    }
+    // Documentation
+    if (relativePath.startsWith("docs/") || relativePath.startsWith("doc/")) {
+        return "docs";
+    }
+    if (ext === ".md" || ext === ".rst" || ext === ".txt") {
+        return "docs";
+    }
+    // Source code
+    if ([".ts", ".js", ".py", ".rs", ".go", ".java", ".rb", ".php", ".c", ".cpp", ".h"].includes(ext)) {
+        return "source";
+    }
+    return "other";
+}
+/**
+ * Get priority for a file (lower = scan first)
+ */
+function getFilePriority(relativePath) {
+    const basename = path.basename(relativePath);
+    if (FILE_PRIORITY[basename]) {
+        return FILE_PRIORITY[basename];
+    }
+    const type = categorizeFile(relativePath);
+    switch (type) {
+        case "readme":
+            return 1;
+        case "config":
+            return 2;
+        case "docs":
+            return 5;
+        case "source":
+            return 10;
+        default:
+            return 100;
+    }
+}
+/**
+ * Build a tree-like directory structure string
+ */
+function buildDirectoryTree(files, repoPath) {
+    // Get unique directories
+    const dirs = new Set();
+    const filesByDir = new Map();
+    for (const file of files) {
+        const dir = path.dirname(file.relativePath);
+        if (dir !== ".") {
+            // Add all parent directories
+            const parts = dir.split(path.sep);
+            for (let i = 1; i <= parts.length; i++) {
+                dirs.add(parts.slice(0, i).join(path.sep));
+            }
+        }
+        const parent = dir === "." ? "" : dir;
+        if (!filesByDir.has(parent)) {
+            filesByDir.set(parent, []);
+        }
+        filesByDir.get(parent).push(path.basename(file.relativePath));
+    }
+    // Build tree
+    const lines = [path.basename(repoPath) + "/"];
+    const sortedDirs = Array.from(dirs).sort();
+    // Add top-level files
+    const rootFiles = filesByDir.get("") || [];
+    for (const file of rootFiles.slice(0, 10)) {
+        lines.push(`├── ${file}`);
+    }
+    if (rootFiles.length > 10) {
+        lines.push(`├── ... (${rootFiles.length - 10} more files)`);
+    }
+    // Add directories (limited)
+    for (const dir of sortedDirs.slice(0, 20)) {
+        const depth = dir.split(path.sep).length;
+        const indent = "│   ".repeat(depth - 1);
+        lines.push(`${indent}├── ${path.basename(dir)}/`);
+    }
+    if (sortedDirs.length > 20) {
+        lines.push(`... (${sortedDirs.length - 20} more directories)`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Parse project metadata from config files
+ */
+function parseProjectMetadata(files) {
+    const metadata = {};
+    for (const file of files) {
+        if (!file.content)
+            continue;
+        const basename = path.basename(file.relativePath).toLowerCase();
+        try {
+            if (basename === "package.json") {
+                const pkg = JSON.parse(file.content);
+                metadata.name = pkg.name;
+                metadata.description = pkg.description;
+                metadata.keywords = pkg.keywords;
+                metadata.language = "TypeScript/JavaScript";
+                metadata.dependencies = [
+                    ...Object.keys(pkg.dependencies || {}),
+                    ...Object.keys(pkg.devDependencies || {}),
+                ].slice(0, 20);
+            }
+            else if (basename === "cargo.toml") {
+                metadata.language = "Rust";
+                // Basic TOML parsing for name
+                const nameMatch = file.content.match(/name\s*=\s*"([^"]+)"/);
+                if (nameMatch)
+                    metadata.name = nameMatch[1];
+                const descMatch = file.content.match(/description\s*=\s*"([^"]+)"/);
+                if (descMatch)
+                    metadata.description = descMatch[1];
+            }
+            else if (basename === "pyproject.toml") {
+                metadata.language = "Python";
+                const nameMatch = file.content.match(/name\s*=\s*"([^"]+)"/);
+                if (nameMatch)
+                    metadata.name = nameMatch[1];
+            }
+            else if (basename === "go.mod") {
+                metadata.language = "Go";
+                const moduleMatch = file.content.match(/module\s+(\S+)/);
+                if (moduleMatch)
+                    metadata.name = moduleMatch[1];
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    return metadata;
+}
+/**
+ * Load .gitignore patterns
+ */
+function loadGitignore(repoPath) {
+    const ig = ignore();
+    const gitignorePath = path.join(repoPath, ".gitignore");
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, "utf-8");
+        ig.add(content);
+    }
+    return ig;
+}
+/**
+ * Phase 1: Discover all files without reading content
+ */
+function discoverFiles(repoPath, options) {
+    const warnings = [];
+    const files = [];
+    const skipPaths = new Set([...DEFAULT_SKIP_PATHS, ...(options.skipPaths || [])]);
+    const ig = options.respectGitignore !== false ? loadGitignore(repoPath) : null;
+    function walk(dir, relativeTo) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            const relativePath = path.relative(relativeTo, fullPath);
+            // Skip hidden files and directories (except .github)
+            if (entry.name.startsWith(".") && entry.name !== ".github") {
+                continue;
+            }
+            // Skip configured paths
+            if (skipPaths.has(entry.name)) {
+                continue;
+            }
+            // Check gitignore
+            if (ig && ig.ignores(relativePath)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                walk(fullPath, relativeTo);
+            }
+            else if (entry.isFile()) {
+                try {
+                    const stats = fs.statSync(fullPath);
+                    files.push({
+                        relativePath,
+                        size: stats.size,
+                        modifiedAt: stats.mtime,
+                    });
+                }
+                catch {
+                    // Skip files we can't stat
+                }
+            }
+        }
+    }
+    walk(repoPath, repoPath);
+    if (files.length > 10000) {
+        warnings.push(`Large repository detected: ${files.length} files. Using sampling strategy.`);
+    }
+    return { files, warnings };
+}
+/**
+ * Phase 2: Determine scanning strategy based on total size
+ */
+function determineScanStrategy(files, maxContentSize) {
+    // Calculate total size of text files we care about
+    const textFiles = files.filter((f) => {
+        const type = categorizeFile(f.relativePath);
+        return type !== "other" && type !== "source";
+    });
+    const totalTextSize = textFiles.reduce((sum, f) => sum + f.size, 0);
+    // Sort by priority
+    const sorted = [...textFiles].sort((a, b) => {
+        const priorityDiff = getFilePriority(a.relativePath) - getFilePriority(b.relativePath);
+        if (priorityDiff !== 0)
+            return priorityDiff;
+        // Prefer newer files
+        return 0;
+    });
+    if (totalTextSize <= maxContentSize) {
+        // Small repo: read everything
+        return {
+            strategy: "full",
+            filesToScan: sorted.map((f) => f.relativePath),
+        };
+    }
+    // Need to sample - accumulate until we hit budget
+    const filesToScan = [];
+    let accumulatedSize = 0;
+    for (const file of sorted) {
+        if (accumulatedSize + file.size > maxContentSize) {
+            // If this file alone is bigger than remaining budget, truncate
+            if (accumulatedSize < maxContentSize * 0.5) {
+                filesToScan.push(file.relativePath);
+                accumulatedSize += Math.min(file.size, maxContentSize - accumulatedSize);
+            }
+            break;
+        }
+        filesToScan.push(file.relativePath);
+        accumulatedSize += file.size;
+    }
+    return {
+        strategy: totalTextSize > maxContentSize * 2 ? "sampled" : "truncated",
+        filesToScan,
+    };
+}
+/**
+ * Phase 3: Read file contents
+ */
+function readFileContents(repoPath, filesToScan, discoveredFiles, maxContentSize) {
+    const scannedFiles = [];
+    let totalRead = 0;
+    const fileMap = new Map(discoveredFiles.map((f) => [f.relativePath, f]));
+    for (const relativePath of filesToScan) {
+        const fileInfo = fileMap.get(relativePath);
+        if (!fileInfo)
+            continue;
+        const fullPath = path.join(repoPath, relativePath);
+        const remainingBudget = maxContentSize - totalRead;
+        if (remainingBudget <= 0)
+            break;
+        try {
+            // Read file, potentially truncating
+            const fd = fs.openSync(fullPath, "r");
+            const buffer = Buffer.alloc(Math.min(fileInfo.size, remainingBudget, 50000)); // Max 50KB per file
+            const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, 0);
+            fs.closeSync(fd);
+            let content = buffer.subarray(0, bytesRead).toString("utf-8");
+            // If truncated, add indicator
+            if (bytesRead < fileInfo.size) {
+                content += "\n\n[... content truncated ...]";
+            }
+            scannedFiles.push({
+                path: fullPath,
+                relativePath,
+                type: categorizeFile(relativePath),
+                size: fileInfo.size,
+                content,
+                modifiedAt: fileInfo.modifiedAt,
+            });
+            totalRead += bytesRead;
+        }
+        catch {
+            // Skip files we can't read
+        }
+    }
+    return scannedFiles;
+}
+/**
+ * Scan a repository to understand its structure and content
+ */
+export async function scanRepository(repoPath, options = {}) {
+    const resolvedPath = path.resolve(repoPath);
+    // Validate path exists and is a directory
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Path does not exist: ${repoPath}`);
+    }
+    if (!fs.statSync(resolvedPath).isDirectory()) {
+        throw new Error(`Path is not a directory: ${repoPath}`);
+    }
+    const maxContentSize = options.maxContentSize ?? 100 * 1024; // 100KB default
+    const warnings = [];
+    // Phase 1: Discover
+    const { files: discoveredFiles, warnings: discoverWarnings } = discoverFiles(resolvedPath, options);
+    warnings.push(...discoverWarnings);
+    if (discoveredFiles.length === 0) {
+        throw new Error(`No files found in repository: ${repoPath}`);
+    }
+    // Phase 2: Determine strategy
+    const { strategy, filesToScan } = determineScanStrategy(discoveredFiles, maxContentSize);
+    // Phase 3: Read content
+    const scannedFiles = readFileContents(resolvedPath, filesToScan, discoveredFiles, maxContentSize);
+    // Build results
+    const directoryStructure = buildDirectoryTree(discoveredFiles.map((f) => ({
+        path: path.join(resolvedPath, f.relativePath),
+        relativePath: f.relativePath,
+        type: categorizeFile(f.relativePath),
+        size: f.size,
+        modifiedAt: f.modifiedAt,
+    })), resolvedPath);
+    const projectMetadata = parseProjectMetadata(scannedFiles);
+    const stats = {
+        totalFiles: discoveredFiles.length,
+        totalSize: discoveredFiles.reduce((sum, f) => sum + f.size, 0),
+        scannedFiles: scannedFiles.length,
+        scannedSize: scannedFiles.reduce((sum, f) => sum + (f.content?.length || 0), 0),
+        strategy,
+    };
+    return {
+        files: scannedFiles,
+        directoryStructure,
+        projectMetadata,
+        stats,
+        warnings,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/repo-scanner/index.js.map

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

package/dist/skill-generator/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Skill Generator
+ *
+ * Generates global Claude Code skills for navigators, enabling
+ * inter-navigator communication via the "ask <navname>" pattern.
+ */
+export interface SkillConfig {
+    /** Navigator name (used for skill name: ask-<navname>) */
+    navigatorName: string;
+    /** Absolute path to the navigator directory */
+    navigatorPath: string;
+    /** Navigator description/purpose */
+    description: string;
+    /** Topics the navigator covers */
+    scope?: string;
+    /** Who uses this navigator */
+    audience?: string;
+}
+/**
+ * Get the global skills directory path
+ */
+export declare function getGlobalSkillsDir(): string;
+/**
+ * Check if a skill already exists
+ */
+export declare function skillExists(skillName: string): boolean;
+/**
+ * Generate the skill name from navigator name
+ */
+export declare function getSkillName(navigatorName: string): string;
+/**
+ * Generate the SKILL.md content for a navigator
+ */
+export declare function generateSkillContent(config: SkillConfig): string;
+/**
+ * Create a global skill for a navigator
+ *
+ * @param config - Skill configuration
+ * @param options - Options for skill creation
+ * @returns Path to the created skill directory, or null if skipped
+ */
+export declare function createNavigatorSkill(config: SkillConfig, options?: {
+    force?: boolean;
+    quiet?: boolean;
+}): Promise<string | null>;
+/**
+ * Remove a navigator skill
+ */
+export declare function removeNavigatorSkill(navigatorName: string, options?: {
+    quiet?: boolean;
+}): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/skill-generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill-generator/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAgKhE;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAkBT"}