@soleri/core 9.14.4 → 9.16.7

package/dist/skills/validate-skills.js

@@ -0,0 +1,396 @@
+/**
+ * Validator for user-installed SKILL.md op-call examples.
+ *
+ * Reads all SKILL.md files from a given skills directory (e.g. ~/.claude/skills/),
+ * extracts inline op-call examples, and validates their params against the actual
+ * Zod schemas from the facade layer.
+ *
+ * Returns structured results rather than printing or exiting — the CLI layer owns I/O.
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+// ── Facade factory imports ──────────────────────────────────────────────
+import { createVaultFacadeOps } from '../runtime/facades/vault-facade.js';
+import { createPlanFacadeOps } from '../runtime/facades/plan-facade.js';
+import { createBrainFacadeOps } from '../runtime/facades/brain-facade.js';
+import { createMemoryFacadeOps } from '../runtime/facades/memory-facade.js';
+import { createAdminFacadeOps } from '../runtime/facades/admin-facade.js';
+import { createCuratorFacadeOps } from '../runtime/facades/curator-facade.js';
+import { createLoopFacadeOps } from '../runtime/facades/loop-facade.js';
+import { createOrchestrateFacadeOps } from '../runtime/facades/orchestrate-facade.js';
+import { createControlFacadeOps } from '../runtime/facades/control-facade.js';
+import { createContextFacadeOps } from '../runtime/facades/context-facade.js';
+import { createAgencyFacadeOps } from '../runtime/facades/agency-facade.js';
+import { createChatFacadeOps } from '../runtime/facades/chat-facade.js';
+import { createOperatorFacadeOps } from '../runtime/facades/operator-facade.js';
+import { createArchiveFacadeOps } from '../runtime/facades/archive-facade.js';
+import { createSyncFacadeOps } from '../runtime/facades/sync-facade.js';
+import { createReviewFacadeOps } from '../runtime/facades/review-facade.js';
+import { createIntakeFacadeOps } from '../runtime/facades/intake-facade.js';
+import { createLinksFacadeOps } from '../runtime/facades/links-facade.js';
+import { createBranchingFacadeOps } from '../runtime/facades/branching-facade.js';
+import { createTierFacadeOps } from '../runtime/facades/tier-facade.js';
+import { createEmbeddingFacadeOps } from '../runtime/facades/embedding-facade.js';
+// ── Mock runtime ────────────────────────────────────────────────────────
+// Schemas are constructed during factory calls but handlers are never invoked.
+function createNoopProxy() {
+    const handler = {
+        get(_target, prop) {
+            if (prop === Symbol.toPrimitive)
+                return () => '';
+            if (prop === Symbol.iterator)
+                return undefined;
+            if (prop === 'then')
+                return undefined;
+            if (prop === 'toString')
+                return () => '[mock]';
+            if (prop === 'valueOf')
+                return () => 0;
+            if (prop === 'length')
+                return 0;
+            return new Proxy(function () { }, handler);
+        },
+        apply() {
+            return new Proxy({}, handler);
+        },
+    };
+    return new Proxy({}, handler);
+}
+// ── Schema registry ─────────────────────────────────────────────────────
+function buildSchemaRegistry() {
+    const runtime = createNoopProxy();
+    const registry = new Map();
+    const facadeFactories = [
+        createVaultFacadeOps,
+        createPlanFacadeOps,
+        createBrainFacadeOps,
+        createMemoryFacadeOps,
+        createAdminFacadeOps,
+        createCuratorFacadeOps,
+        createLoopFacadeOps,
+        createOrchestrateFacadeOps,
+        createControlFacadeOps,
+        createContextFacadeOps,
+        createAgencyFacadeOps,
+        createChatFacadeOps,
+        createOperatorFacadeOps,
+        createArchiveFacadeOps,
+        createSyncFacadeOps,
+        createReviewFacadeOps,
+        createIntakeFacadeOps,
+        createLinksFacadeOps,
+        createBranchingFacadeOps,
+        createTierFacadeOps,
+        createEmbeddingFacadeOps,
+    ];
+    for (const factory of facadeFactories) {
+        try {
+            const ops = factory(runtime);
+            for (const op of ops) {
+                if (op.schema) {
+                    registry.set(op.name, op.schema);
+                }
+            }
+        }
+        catch {
+            // Some facades may fail with the mock runtime — skip them.
+        }
+    }
+    return registry;
+}
+// ── SKILL.md discovery ──────────────────────────────────────────────────
+// Discovers all SKILL.md files directly inside skillsDir.
+// Supports both layouts:
+//   - skillsDir/{name}/SKILL.md  (directory layout)
+//   - skillsDir/{name}.md        (flat file layout)
+function discoverSkillFiles(skillsDir) {
+    const paths = [];
+    if (!existsSync(skillsDir))
+        return paths;
+    let entries;
+    try {
+        entries = readdirSync(skillsDir);
+    }
+    catch {
+        return paths;
+    }
+    for (const entry of entries) {
+        const entryPath = join(skillsDir, entry);
+        try {
+            const stat = statSync(entryPath);
+            if (stat.isDirectory()) {
+                const skillMd = join(entryPath, 'SKILL.md');
+                if (existsSync(skillMd)) {
+                    paths.push(skillMd);
+                }
+            }
+            else if (entry.endsWith('.md')) {
+                paths.push(entryPath);
+            }
+        }
+        catch {
+            // Skip unreadable entries
+        }
+    }
+    return paths;
+}
+// ── SKILL.md parser ─────────────────────────────────────────────────────
+function extractOpExamples(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split('\n');
+    const examples = [];
+    let inCodeBlock = false;
+    let codeBlockStart = -1;
+    let codeBlockLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trimStart().startsWith('```')) {
+            if (!inCodeBlock) {
+                inCodeBlock = true;
+                codeBlockStart = i + 1;
+                codeBlockLines = [];
+            }
+            else {
+                extractFromCodeBlock(filePath, codeBlockStart, codeBlockLines, examples);
+                inCodeBlock = false;
+                codeBlockLines = [];
+            }
+            continue;
+        }
+        if (inCodeBlock) {
+            codeBlockLines.push(line);
+        }
+    }
+    return examples;
+}
+function extractFromCodeBlock(filePath, startLine, blockLines, results) {
+    const opPattern = /(?:YOUR_AGENT_\w+\s+)?op:(\w+)(?:\s+params:\s*(.*))?/;
+    for (let i = 0; i < blockLines.length; i++) {
+        const line = blockLines[i];
+        const match = line.match(opPattern);
+        if (!match)
+            continue;
+        const opName = match[1];
+        const lineNum = startLine + i + 1;
+        let rawParams = '';
+        if (match[2]) {
+            rawParams = match[2].trim();
+        }
+        else if (i + 1 < blockLines.length && blockLines[i + 1].trim().startsWith('params:')) {
+            const paramsLine = blockLines[i + 1].trim();
+            const paramsMatch = paramsLine.match(/^params:\s*(.*)/);
+            if (paramsMatch) {
+                rawParams = paramsMatch[1].trim();
+            }
+        }
+        if (rawParams) {
+            const fullParams = collectMultiLineParams(blockLines, i, rawParams);
+            const { parsed, error } = parseLooseJson(fullParams);
+            results.push({
+                file: filePath,
+                line: lineNum,
+                opName,
+                rawParams: fullParams,
+                parsedParams: parsed,
+                parseError: error,
+            });
+        }
+    }
+}
+function collectMultiLineParams(blockLines, opLineIdx, initial) {
+    if (isBalanced(initial))
+        return initial;
+    let startIdx = opLineIdx + 1;
+    if (!blockLines[opLineIdx].includes('params:') && startIdx < blockLines.length) {
+        if (blockLines[startIdx].trim().startsWith('params:')) {
+            startIdx++;
+        }
+    }
+    let result = initial;
+    for (let j = startIdx; j < blockLines.length; j++) {
+        const nextLine = blockLines[j].trim();
+        if (!nextLine)
+            continue;
+        if (nextLine.match(/(?:YOUR_AGENT_\w+\s+)?op:\w+/))
+            break;
+        result += '\n' + nextLine;
+        if (isBalanced(result))
+            break;
+    }
+    return result;
+}
+function isBalanced(s) {
+    let depth = 0;
+    for (const ch of s) {
+        if (ch === '{' || ch === '[')
+            depth++;
+        if (ch === '}' || ch === ']')
+            depth--;
+        if (depth < 0)
+            return false;
+    }
+    return depth === 0;
+}
+function parseLooseJson(raw) {
+    if (!raw.trim())
+        return { parsed: null };
+    try {
+        const normalized = raw
+            .replace(/"<([^">]+)>"/g, '"$1"')
+            .replace(/([{,]\s*)(\w+)\s*:/g, '$1"$2":')
+            .replace(/'/g, '"')
+            .replace(/,\s*([}\]])/g, '$1')
+            .replace(/\.\.\./g, '')
+            .replace(/\["?<[^>]+>"?\]/g, '["placeholder"]');
+        const result = JSON.parse(normalized);
+        return { parsed: result };
+    }
+    catch (e) {
+        try {
+            const result = extractFlatParams(raw);
+            if (result && Object.keys(result).length > 0) {
+                return { parsed: result };
+            }
+        }
+        catch {
+            // fall through
+        }
+        return {
+            parsed: null,
+            error: `Cannot parse params: ${e.message}`,
+        };
+    }
+}
+function extractFlatParams(raw) {
+    const result = {};
+    const kvPattern = /(\w+)\s*:\s*(?:"([^"]*)"|\[([^\]]*)\]|(\{[^}]*\})|(\w+))/g;
+    let match;
+    let found = false;
+    while ((match = kvPattern.exec(raw)) !== null) {
+        found = true;
+        const key = match[1];
+        if (match[2] !== undefined) {
+            result[key] = match[2].replace(/<[^>]+>/g, 'placeholder');
+        }
+        else if (match[3] !== undefined) {
+            result[key] = ['placeholder'];
+        }
+        else if (match[4] !== undefined) {
+            result[key] = {};
+        }
+        else if (match[5] !== undefined) {
+            const val = match[5];
+            if (val === 'true')
+                result[key] = true;
+            else if (val === 'false')
+                result[key] = false;
+            else if (/^\d+$/.test(val))
+                result[key] = parseInt(val, 10);
+            else
+                result[key] = val;
+        }
+    }
+    return found ? result : null;
+}
+// ── Validation ──────────────────────────────────────────────────────────
+function isPlaceholder(value) {
+    if (typeof value !== 'string')
+        return false;
+    if (value.includes('|'))
+        return true;
+    if (/^<.*>$/.test(value))
+        return true;
+    if (/^(placeholder|example|value|name|id|title|description|type|domain)$/i.test(value))
+        return true;
+    if (/^[\w]+-[\w]+$/.test(value) &&
+        /\b(correct|your|my|the|this|some|new|old|entry|item|current)\b/i.test(value))
+        return true;
+    return false;
+}
+function isPlaceholderIssue(issue, params) {
+    if (issue.code === 'invalid_enum_value') {
+        const received = issue.received ?? getNestedValue(params, issue.path);
+        if (isPlaceholder(received))
+            return true;
+    }
+    return false;
+}
+function getNestedValue(obj, path) {
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+function validateExamples(examples, registry) {
+    const errors = [];
+    for (const ex of examples) {
+        if (ex.parseError)
+            continue;
+        if (!ex.parsedParams)
+            continue;
+        const schema = registry.get(ex.opName);
+        if (!schema) {
+            errors.push({
+                file: ex.file,
+                op: ex.opName,
+                line: ex.line,
+                message: `unknown op — not found in any facade schema registry`,
+            });
+            continue;
+        }
+        const result = schema.safeParse(ex.parsedParams);
+        if (!result.success && result.error) {
+            for (const issue of result.error.issues) {
+                if (isPlaceholderIssue(issue, ex.parsedParams)) {
+                    continue;
+                }
+                const path = issue.path.join('.');
+                errors.push({
+                    file: ex.file,
+                    op: ex.opName,
+                    line: ex.line,
+                    message: `${path ? path + ': ' : ''}${issue.message}`,
+                });
+            }
+        }
+    }
+    return errors;
+}
+// ── Public API ──────────────────────────────────────────────────────────
+/**
+ * Validate all SKILL.md files found in `skillsDir`.
+ *
+ * `skillsDir` is the directory that contains skill subdirectories, e.g. ~/.claude/skills/.
+ * Each subdirectory is expected to have a SKILL.md file.
+ *
+ * @returns Structured result with errors, counts, and whether all examples are valid.
+ */
+export function validateSkillDocs(skillsDir) {
+    const registry = buildSchemaRegistry();
+    const skillFiles = discoverSkillFiles(skillsDir);
+    let totalExamples = 0;
+    const allErrors = [];
+    for (const file of skillFiles) {
+        const examples = extractOpExamples(file);
+        totalExamples += examples.length;
+        const errors = validateExamples(examples, registry);
+        allErrors.push(...errors);
+    }
+    return {
+        valid: allErrors.length === 0,
+        errors: allErrors,
+        totalFiles: skillFiles.length,
+        totalExamples,
+        registrySize: registry.size,
+    };
+}
+//# sourceMappingURL=validate-skills.js.map

package/dist/skills/validate-skills.js.map

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

package/dist/utils/worktree-reaper.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Worktree reaper — cleans up stale .claude/worktrees/ entries left by subagent execution.
+ *
+ * Claude Code creates worktrees via `isolation: "worktree"` for parallel subagent runs.
+ * If the agent commits changes, the worktree persists — nobody reaps it automatically.
+ *
+ * Usage: call worktreeReap() at session start and after plan completion (best-effort).
+ */
+export interface ReapReport {
+    /** Number of worktrees successfully reaped */
+    reaped: number;
+    /** Paths of stale worktrees found */
+    found: string[];
+    /** Any errors encountered (non-fatal) */
+    errors: string[];
+    /** Whether git worktree prune ran successfully */
+    pruned: boolean;
+}
+export interface WorktreeStatus {
+    /** All .claude/worktrees/ entries found */
+    stale: Array<{
+        path: string;
+        branch: string;
+        commit: string;
+    }>;
+    /** Total count */
+    total: number;
+}
+/**
+ * Get status of stale worktrees under .claude/worktrees/ without removing them.
+ */
+export declare function worktreeStatus(projectPath: string): WorktreeStatus;
+/**
+ * Reap stale worktrees under .claude/worktrees/.
+ * Best-effort — errors are collected but never thrown.
+ */
+export declare function worktreeReap(projectPath: string): ReapReport;
+//# sourceMappingURL=worktree-reaper.d.ts.map

package/dist/utils/worktree-reaper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-reaper.d.ts","sourceRoot":"","sources":["../../src/utils/worktree-reaper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AA6BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAelE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CA8B5D"}

package/dist/utils/worktree-reaper.js

@@ -0,0 +1,85 @@
+/**
+ * Worktree reaper — cleans up stale .claude/worktrees/ entries left by subagent execution.
+ *
+ * Claude Code creates worktrees via `isolation: "worktree"` for parallel subagent runs.
+ * If the agent commits changes, the worktree persists — nobody reaps it automatically.
+ *
+ * Usage: call worktreeReap() at session start and after plan completion (best-effort).
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Parse `git worktree list --porcelain` output into structured entries.
+ */
+function parseWorktreeList(output) {
+    const entries = [];
+    const blocks = output.trim().split(/\n\n+/);
+    for (const block of blocks) {
+        const lines = block.trim().split('\n');
+        let path = '';
+        let branch = '';
+        let commit = '';
+        for (const line of lines) {
+            if (line.startsWith('worktree '))
+                path = line.slice(9).trim();
+            else if (line.startsWith('HEAD '))
+                commit = line.slice(5).trim();
+            else if (line.startsWith('branch '))
+                branch = line.slice(7).trim();
+        }
+        if (path)
+            entries.push({ path, branch, commit });
+    }
+    return entries;
+}
+/**
+ * Get status of stale worktrees under .claude/worktrees/ without removing them.
+ */
+export function worktreeStatus(projectPath) {
+    const result = spawnSync('git', ['worktree', 'list', '--porcelain'], {
+        cwd: projectPath,
+        encoding: 'utf-8',
+    });
+    if (result.status !== 0 || !result.stdout) {
+        return { stale: [], total: 0 };
+    }
+    const all = parseWorktreeList(result.stdout);
+    const worktreeBase = join(projectPath, '.claude', 'worktrees');
+    const stale = all.filter((e) => e.path.startsWith(worktreeBase) && existsSync(e.path));
+    return { stale, total: stale.length };
+}
+/**
+ * Reap stale worktrees under .claude/worktrees/.
+ * Best-effort — errors are collected but never thrown.
+ */
+export function worktreeReap(projectPath) {
+    const report = { reaped: 0, found: [], errors: [], pruned: false };
+    try {
+        const { stale } = worktreeStatus(projectPath);
+        for (const { path } of stale) {
+            report.found.push(path);
+            const rm = spawnSync('git', ['worktree', 'remove', '--force', path], {
+                cwd: projectPath,
+                encoding: 'utf-8',
+            });
+            if (rm.status === 0) {
+                report.reaped++;
+            }
+            else {
+                report.errors.push(`Failed to remove ${path}: ${rm.stderr?.trim() ?? 'unknown error'}`);
+            }
+        }
+        // Prune dangling refs
+        const prune = spawnSync('git', ['worktree', 'prune'], {
+            cwd: projectPath,
+            encoding: 'utf-8',
+        });
+        report.pruned = prune.status === 0;
+    }
+    catch (err) {
+        report.errors.push(err instanceof Error ? err.message : String(err));
+    }
+    return report;
+}
+//# sourceMappingURL=worktree-reaper.js.map

package/dist/utils/worktree-reaper.js.map

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

package/dist/vault/default-canonical-tags.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default canonical tag taxonomy for Soleri agents.
+ *
+ * These tags represent the most common knowledge domains. When a vault is
+ * configured with tagConstraintMode 'suggest' or 'enforce', incoming tags
+ * are mapped to the nearest entry in this list via edit-distance matching.
+ *
+ * To use these defaults in your agent runtime config:
+ *   import { DEFAULT_CANONICAL_TAGS } from '@soleri/core';
+ *   // ...
+ *   canonicalTags: DEFAULT_CANONICAL_TAGS,
+ *   tagConstraintMode: 'suggest',
+ */
+export declare const DEFAULT_CANONICAL_TAGS: string[];
+//# sourceMappingURL=default-canonical-tags.d.ts.map

package/dist/vault/default-canonical-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-canonical-tags.d.ts","sourceRoot":"","sources":["../../src/vault/default-canonical-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAkD1C,CAAC"}

package/dist/vault/default-canonical-tags.js

@@ -0,0 +1,65 @@
+/**
+ * Default canonical tag taxonomy for Soleri agents.
+ *
+ * These tags represent the most common knowledge domains. When a vault is
+ * configured with tagConstraintMode 'suggest' or 'enforce', incoming tags
+ * are mapped to the nearest entry in this list via edit-distance matching.
+ *
+ * To use these defaults in your agent runtime config:
+ *   import { DEFAULT_CANONICAL_TAGS } from '@soleri/core';
+ *   // ...
+ *   canonicalTags: DEFAULT_CANONICAL_TAGS,
+ *   tagConstraintMode: 'suggest',
+ */
+export const DEFAULT_CANONICAL_TAGS = [
+    'architecture',
+    'typescript',
+    'react',
+    'testing',
+    'workflow',
+    'design-tokens',
+    'accessibility',
+    'performance',
+    'security',
+    'planning',
+    'soleri',
+    'vault',
+    'mcp',
+    'claude-code',
+    'ai',
+    'learning',
+    'gamification',
+    'education',
+    'adhd',
+    'routing',
+    'orchestration',
+    'skills',
+    'automation',
+    'git',
+    'database',
+    'api',
+    'authentication',
+    'subagent',
+    'design-system',
+    'component',
+    'frontend',
+    'backend',
+    'tooling',
+    'monorepo',
+    'refactoring',
+    'debugging',
+    'deployment',
+    'configuration',
+    'documentation',
+    'pattern',
+    'anti-pattern',
+    'principle',
+    'decision',
+    'migration',
+    'plugin',
+    'hook',
+    'schema',
+    'pipeline',
+    'ingestion',
+];
+//# sourceMappingURL=default-canonical-tags.js.map

package/dist/vault/default-canonical-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-canonical-tags.js","sourceRoot":"","sources":["../../src/vault/default-canonical-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAa;IAC9C,cAAc;IACd,YAAY;IACZ,OAAO;IACP,SAAS;IACT,UAAU;IACV,eAAe;IACf,eAAe;IACf,aAAa;IACb,UAAU;IACV,UAAU;IACV,QAAQ;IACR,OAAO;IACP,KAAK;IACL,aAAa;IACb,IAAI;IACJ,UAAU;IACV,cAAc;IACd,WAAW;IACX,MAAM;IACN,SAAS;IACT,eAAe;IACf,QAAQ;IACR,YAAY;IACZ,KAAK;IACL,UAAU;IACV,KAAK;IACL,gBAAgB;IAChB,UAAU;IACV,eAAe;IACf,WAAW;IACX,UAAU;IACV,SAAS;IACT,SAAS;IACT,UAAU;IACV,aAAa;IACb,WAAW;IACX,YAAY;IACZ,eAAe;IACf,eAAe;IACf,SAAS;IACT,cAAc;IACd,WAAW;IACX,UAAU;IACV,WAAW;IACX,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,UAAU;IACV,WAAW;CACZ,CAAC"}

package/dist/vault/scope-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope-detector.d.ts","sourceRoot":"","sources":["../../src/vault/scope-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAwJD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAkCnE"}
+{"version":3,"file":"scope-detector.d.ts","sourceRoot":"","sources":["../../src/vault/scope-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AA8LD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAkCnE"}