@skillsmith/core 0.5.2 → 0.5.4

package/dist/src/analysis/tree-sitter/pythonIncremental.hardening.test.js

@@ -0,0 +1,229 @@
+/**
+ * SMI-4315 + SMI-4316: hardening tests for pythonIncremental.
+ *
+ * SMI-4315 — `resolvePythonWasmPath` probes each candidate with
+ * `fs.existsSync` instead of always returning `candidates[0]`. Regression
+ * test for the package-local-fallback case.
+ *
+ * SMI-4316 — both silent catches now emit logger.warn. Tests verify:
+ *   - `parseSync` catch: rate-limited warn keyed per file; payload is
+ *     `{ file, error }` only with error truncated to <=200 chars and no
+ *     `stack` field (no source code leak).
+ *   - `doInit` catch: one-shot warn per parser instance on init failure.
+ *
+ * All SUT access goes through a dynamic `import('./pythonIncremental.js')`
+ * inside the tests so the vi.mock calls below are applied even when vitest
+ * shares its module cache with sibling test files in the same worker.
+ * Mixing static `import { X } from './pythonIncremental.js'` with vi.mock
+ * against the same module has been observed to bypass the mock when a
+ * sibling test file imports the SUT first.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { resetRateLimiter } from '../../utils/rate-limit.js';
+// vi.hoisted runs before vi.mock factories; closure-sharing the spy
+// objects avoids the createLogger-spy trap (feedback_logger_spy_pattern).
+const { loggerSpies, existsSyncMock } = vi.hoisted(() => ({
+    loggerSpies: {
+        warn: vi.fn(),
+        error: vi.fn(),
+        info: vi.fn(),
+        debug: vi.fn(),
+        auditLog: vi.fn(),
+        securityLog: vi.fn(),
+    },
+    existsSyncMock: vi.fn(),
+}));
+vi.mock('../../utils/logger.js', () => ({
+    createLogger: () => loggerSpies,
+}));
+vi.mock('node:fs', async () => {
+    const actual = await vi.importActual('node:fs');
+    return { ...actual, existsSync: (p) => existsSyncMock(p) };
+});
+let SUT_CACHE = null;
+async function getSUT() {
+    if (!SUT_CACHE)
+        SUT_CACHE = await import('./pythonIncremental.js');
+    return SUT_CACHE;
+}
+describe('SMI-4315 · resolvePythonWasmPath existsSync probe', () => {
+    beforeEach(() => {
+        existsSyncMock.mockReset();
+    });
+    it('returns candidates[0] when the workspace-hoist path exists', async () => {
+        const { resolvePythonWasmPath } = await getSUT();
+        const seen = [];
+        existsSyncMock.mockImplementation((p) => {
+            seen.push(p);
+            return true; // first candidate hits; loop exits after one probe
+        });
+        const result = resolvePythonWasmPath();
+        expect(result).toMatch(/tree-sitter-python\.wasm$/);
+        expect(seen).toHaveLength(1);
+        expect(result).toBe(seen[0]);
+    });
+    it('falls back to candidates[1] (package-local) when the hoist is missing', async () => {
+        const { resolvePythonWasmPath } = await getSUT();
+        const seen = [];
+        existsSyncMock.mockImplementation((p) => {
+            seen.push(p);
+            return seen.length === 2; // second candidate exists
+        });
+        const result = resolvePythonWasmPath();
+        expect(result).toBe(seen[1]);
+        expect(seen).toHaveLength(2);
+        expect(seen[0]).not.toBe(seen[1]);
+    });
+    it('returns candidates[0] as a stable error anchor when neither exists', async () => {
+        const { resolvePythonWasmPath } = await getSUT();
+        const seen = [];
+        existsSyncMock.mockImplementation((p) => {
+            seen.push(p);
+            return false;
+        });
+        const result = resolvePythonWasmPath();
+        expect(result).toBe(seen[0]);
+        expect(seen).toHaveLength(2);
+    });
+});
+describe('SMI-4316 · parseSync catch emits rate-limited warn', () => {
+    beforeEach(() => {
+        loggerSpies.warn.mockReset();
+        resetRateLimiter();
+        // existsSync returns true so the constructor wasm-path resolution is
+        // stable even though we don't actually load WASM in these tests.
+        existsSyncMock.mockReturnValue(true);
+    });
+    afterEach(() => {
+        resetRateLimiter();
+    });
+    /**
+     * Build a parser primed with a cached entry whose `tree.edit` throws on
+     * re-parse. This drives `parseSync` into the catch without needing a
+     * real WASM runtime.
+     */
+    function primeFailingCache(parser, filePath, error) {
+        const p = parser;
+        // Force `isReady` true with minimal stubs.
+        p.parser = { parse: () => ({}) };
+        p.language = {};
+        p.queries = {};
+        p.cache.set(filePath, {
+            tree: {
+                edit: () => {
+                    throw error;
+                },
+                delete: () => { },
+            },
+            content: 'placeholder\n',
+            lastUsed: 1,
+            lastResult: null,
+        });
+    }
+    it('emits one warn on the first parseSync failure with safe payload', async () => {
+        const { PythonIncrementalParser } = await getSUT();
+        const parser = new PythonIncrementalParser();
+        const filePath = 'a.py';
+        primeFailingCache(parser, filePath, new Error('simulated parse failure'));
+        const result = parser.parseSync('different content\n', filePath);
+        expect(result).toBeNull();
+        expect(loggerSpies.warn).toHaveBeenCalledTimes(1);
+        const [message, payload] = loggerSpies.warn.mock.calls[0];
+        expect(message).toContain('parseSync failed');
+        // Strictly { file, error } — no stack, no source content.
+        expect(payload).toEqual({
+            file: filePath,
+            error: 'simulated parse failure',
+        });
+        expect(Object.keys(payload ?? {}).sort()).toEqual(['error', 'file']);
+    });
+    it('truncates error messages to <=200 chars (no source code leak)', async () => {
+        const { PythonIncrementalParser } = await getSUT();
+        const parser = new PythonIncrementalParser();
+        const filePath = 'b.py';
+        const longMsg = 'E'.repeat(500);
+        // Include a newline that contains fake "source" content; the formatter
+        // must only keep the first line.
+        const faux = new Error(`${longMsg}\nSECRET_API_KEY=sk_live_should_never_appear`);
+        primeFailingCache(parser, filePath, faux);
+        parser.parseSync('xx\n', filePath);
+        const payload = loggerSpies.warn.mock.calls[0][1];
+        expect(payload.error.length).toBeLessThanOrEqual(200);
+        expect(payload.error).not.toContain('\n');
+        expect(payload.error).not.toContain('SECRET_API_KEY');
+    });
+    it('rate-limits a hot-loop flood (FIRST_N fire, then 1-in-SAMPLE_EVERY)', async () => {
+        const { PythonIncrementalParser } = await getSUT();
+        const parser = new PythonIncrementalParser();
+        const filePath = 'flood.py';
+        // FIRST_N (5) fires; after that, one-in-SAMPLE_EVERY (100) fires.
+        // 200 events after the first 5 → 2 sampled hits. Total = 7.
+        for (let i = 0; i < 205; i += 1) {
+            primeFailingCache(parser, filePath, new Error(`fail ${i}`));
+            parser.parseSync(`content ${i}\n`, filePath);
+        }
+        expect(loggerSpies.warn).toHaveBeenCalledTimes(7);
+    });
+    it('isolates rate-limit buckets across files', async () => {
+        const { PythonIncrementalParser } = await getSUT();
+        const parser = new PythonIncrementalParser();
+        // Drive hot.py well past its FIRST_N + next sampled boundary (5 + 1 = 6).
+        for (let i = 0; i < 50; i += 1) {
+            primeFailingCache(parser, 'hot.py', new Error('x'));
+            parser.parseSync(`content ${i}\n`, 'hot.py');
+        }
+        const hotWarns = loggerSpies.warn.mock.calls.length;
+        // hot.py should have burned FIRST_N=5 + 1 sampled (count=6) = 6 warns.
+        expect(hotWarns).toBe(6);
+        // cool.py still gets its own FIRST_N budget, so the very first failure
+        // emits a warn regardless of what hot.py did.
+        primeFailingCache(parser, 'cool.py', new Error('y'));
+        parser.parseSync('ctn\n', 'cool.py');
+        expect(loggerSpies.warn.mock.calls.length).toBe(hotWarns + 1);
+        const cool = loggerSpies.warn.mock.calls.find((c) => c[1].file === 'cool.py');
+        expect(cool).toBeDefined();
+    });
+});
+describe('SMI-4316 · doInit catch emits one-shot warn', () => {
+    beforeEach(() => {
+        loggerSpies.warn.mockReset();
+        resetRateLimiter();
+        existsSyncMock.mockReturnValue(true);
+    });
+    it('logs a single warn on init failure with wasmPath + error + stack', async () => {
+        const { PythonIncrementalParser } = await getSUT();
+        const failingLoader = async () => {
+            throw new Error('module not found');
+        };
+        const parser = new PythonIncrementalParser({}, failingLoader);
+        const result = await parser.parse('def x(): pass\n', 'fail.py');
+        expect(result).toBeNull();
+        expect(parser.hasFailedInit).toBe(true);
+        expect(loggerSpies.warn).toHaveBeenCalledTimes(1);
+        const [message, payload] = loggerSpies.warn.mock.calls[0];
+        expect(message).toContain('init failed');
+        const p = payload;
+        expect(p.wasmPath).toMatch(/tree-sitter-python\.wasm$/);
+        expect(p.error).toBe('module not found');
+        expect(typeof p.stack).toBe('string');
+    });
+    it('does not warn on a successful parse path (no init failure)', async () => {
+        const { PythonIncrementalParser } = await getSUT();
+        const parser = new PythonIncrementalParser();
+        // Mark ready via stubs; we only assert doInit never fired a warn.
+        const p = parser;
+        p.parser = { parse: () => ({ rootNode: {} }) };
+        p.language = {};
+        p.queries = {};
+        p.initFailed = false;
+        try {
+            parser.parseSync('def ok(): pass\n', 'ok.py');
+        }
+        catch {
+            // swallow — assertion is on the warn spy, not the parse result.
+        }
+        const initWarns = loggerSpies.warn.mock.calls.filter((c) => String(c[0]).includes('init failed'));
+        expect(initWarns).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=pythonIncremental.hardening.test.js.map

package/dist/src/analysis/tree-sitter/pythonIncremental.hardening.test.js.map

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

package/dist/src/analysis/tree-sitter/pythonIncremental.js

@@ -0,0 +1,287 @@
+/**
+ * SMI-4293: Python Incremental Parser Controller
+ *
+ * Couples the WASM tree-sitter parser, per-file tree cache, and edit-based
+ * incremental parsing into a single entry point for the Python adapter.
+ *
+ * Responsibilities:
+ *   - Lazy-init the WASM parser (via web-tree-sitter) and Python language
+ *     grammar (from tree-sitter-wasms).
+ *   - Cache parse trees per file path with LRU eviction (max 100 trees) and
+ *     proper `.delete()` lifecycle.
+ *   - Apply tree.edit() and reuse the previous tree when content changes
+ *     incrementally; fall back to full parse on cache miss or corruption.
+ *   - Delegate extraction to pythonExtractor (query-based, replaces regex).
+ *
+ * @see docs/internal/implementation/github-wave-5c-tree-sitter-incremental.md
+ * @module analysis/tree-sitter/pythonIncremental
+ */
+import * as fs from 'node:fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { calculateEdit, findMinimalEdit } from '../incremental.js';
+import { createLogger } from '../../utils/logger.js';
+import { rateLimited } from '../../utils/rate-limit.js';
+import { PythonQuerySet, extractPythonParseResult } from './pythonExtractor.js';
+const logger = createLogger('PythonIncrementalParser');
+/** First line of a string, truncated to 200 chars. Used to avoid leaking source content into logs. */
+function firstLine(s) {
+    return s.split('\n', 1)[0]?.slice(0, 200) ?? '';
+}
+/** Maximum number of cached trees (per SMI-1309 / SMI-4293 spec). */
+const DEFAULT_MAX_TREES = 100;
+/** Resolve the path to the Python WASM grammar distributed via tree-sitter-wasms. */
+export function resolvePythonWasmPath() {
+    // Caller is inside packages/core/dist or packages/core/src; tree-sitter-wasms
+    // is hoisted to the repo root node_modules in every layout.
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // Monorepo root (workspace hoist)
+        path.resolve(here, '..', '..', '..', '..', '..', 'node_modules', 'tree-sitter-wasms', 'out', 'tree-sitter-python.wasm'),
+        // Package-local (npm-registry install consumers without hoist)
+        path.resolve(here, '..', '..', '..', '..', 'node_modules', 'tree-sitter-wasms', 'out', 'tree-sitter-python.wasm'),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    // Neither exists on disk; return the first so `doInit()` has a stable
+    // error path to surface. Probe is best-effort — the real load failure
+    // is still caught by `doInit()` below.
+    return candidates[0];
+}
+const defaultLoader = async () => {
+    // Optional peer; falls back to error if not installed at runtime.
+    const mod = (await import('web-tree-sitter'));
+    return {
+        Parser: mod.Parser,
+        Language: mod.Language,
+        Query: mod.Query,
+        // Parser.init is a static method on the named export.
+        init: async () => {
+            const maybeInit = mod.Parser.init;
+            if (typeof maybeInit === 'function') {
+                await maybeInit.call(mod.Parser);
+            }
+        },
+    };
+};
+/**
+ * Incremental Python parser: lazily boots web-tree-sitter, parses with
+ * `tree.edit()` reuse when possible, falls back gracefully otherwise.
+ */
+export class PythonIncrementalParser {
+    maxTrees;
+    wasmPath;
+    loader;
+    cache = new Map();
+    parser = null;
+    language = null;
+    queries = null;
+    initPromise = null;
+    initFailed = false;
+    useCounter = 0;
+    constructor(options = {}, loader = defaultLoader) {
+        this.maxTrees = options.maxTrees ?? DEFAULT_MAX_TREES;
+        this.wasmPath = options.wasmPath ?? resolvePythonWasmPath();
+        this.loader = loader;
+    }
+    /** True when the WASM runtime and Python grammar loaded successfully. */
+    get isReady() {
+        return this.parser !== null && this.language !== null && this.queries !== null;
+    }
+    /** True when a prior init attempt failed; callers should use regex fallback. */
+    get hasFailedInit() {
+        return this.initFailed;
+    }
+    /**
+     * Ensure the WASM parser + Python grammar are loaded. Callers should
+     * `await` this once before relying on `parseSync` for a synchronous path.
+     */
+    async ensureReady() {
+        await this.ensureInit();
+    }
+    /**
+     * Parse asynchronously: ensures init, then delegates to the sync path.
+     * Returns null if init has permanently failed (caller falls back to regex).
+     */
+    async parse(content, filePath) {
+        await this.ensureInit();
+        return this.parseSync(content, filePath);
+    }
+    /**
+     * Synchronous parse: usable only after `ensureReady()` has resolved. Uses
+     * the previous tree via `tree.edit()` when content changed incrementally.
+     *
+     * Returns null when the parser isn't ready or any parse/extract step fails;
+     * callers should fall back to regex extraction in that case.
+     */
+    parseSync(content, filePath) {
+        if (!this.isReady)
+            return null;
+        const parser = this.parser;
+        const queries = this.queries;
+        try {
+            const cached = this.cache.get(filePath);
+            let tree;
+            let reusedResult = null;
+            if (cached) {
+                const diff = findMinimalEdit(cached.content, content);
+                if (!diff) {
+                    // Unchanged content — reuse tree AND memoised extraction result
+                    // without re-parse or re-extract.
+                    this.touch(filePath, cached);
+                    tree = cached.tree;
+                    reusedResult = cached.lastResult;
+                }
+                else {
+                    const edit = calculateEdit(cached.content, content, diff.changeStart, diff.changeEnd, diff.newText);
+                    // Apply edit to the previous tree. `edit()` is in-place.
+                    const editable = cached.tree;
+                    editable.edit(edit);
+                    tree = parser.parse(content, cached.tree);
+                    // Replace cached tree; delete old to free WASM memory.
+                    if (tree !== cached.tree)
+                        this.safeDelete(cached.tree);
+                    this.store(filePath, tree, content);
+                }
+            }
+            else {
+                tree = parser.parse(content);
+                this.store(filePath, tree, content);
+            }
+            if (reusedResult)
+                return reusedResult;
+            const result = extractPythonParseResult(tree, queries, filePath);
+            const entry = this.cache.get(filePath);
+            if (entry)
+                entry.lastResult = result;
+            return result;
+        }
+        catch (error) {
+            // Any failure (corrupt tree, grammar error) invalidates this file's
+            // cache and signals the adapter to use regex fallback for this call.
+            // Log rate-limited so a pathological grammar hit cannot flood logs.
+            // Emit only `{ file, error(firstLine, <=200) }` — never the source
+            // content or the stack (tree-sitter errors can quote source lines).
+            if (rateLimited(`python-parse:${filePath}`)) {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.warn('Python parseSync failed; regex fallback for this file', {
+                    file: filePath,
+                    error: firstLine(message),
+                });
+            }
+            this.invalidate(filePath);
+            return null;
+        }
+    }
+    /** Invalidate a single file's cache entry and free its tree. */
+    invalidate(filePath) {
+        const entry = this.cache.get(filePath);
+        if (!entry)
+            return;
+        this.safeDelete(entry.tree);
+        this.cache.delete(filePath);
+    }
+    /** Clear and dispose all cached trees. */
+    dispose() {
+        for (const entry of this.cache.values())
+            this.safeDelete(entry.tree);
+        this.cache.clear();
+        if (this.parser) {
+            try {
+                this.parser.delete();
+            }
+            catch {
+                // ignore
+            }
+        }
+        this.parser = null;
+        this.language = null;
+        this.queries = null;
+        this.initPromise = null;
+    }
+    /** Current cache size (exposed for tests and instrumentation). */
+    get cacheSize() {
+        return this.cache.size;
+    }
+    // ----------------------------------------------------------------
+    // Private
+    // ----------------------------------------------------------------
+    async ensureInit() {
+        if (this.isReady || this.initFailed)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this.doInit();
+        try {
+            await this.initPromise;
+        }
+        finally {
+            this.initPromise = null;
+        }
+    }
+    async doInit() {
+        try {
+            const deps = await this.loader();
+            await deps.init();
+            const parser = new deps.Parser();
+            const language = await deps.Language.load(this.wasmPath);
+            parser.setLanguage(language);
+            this.parser = parser;
+            this.language = language;
+            this.queries = new PythonQuerySet(deps.Query, language);
+        }
+        catch (error) {
+            this.initFailed = true;
+            this.parser = null;
+            this.language = null;
+            this.queries = null;
+            // One-shot warn per parser instance: fires at most once in `doInit`.
+            // Log `{ wasmPath, error, stack }` for operator diagnostics; the WASM
+            // path is not secret, the stack points inside web-tree-sitter /
+            // resolvePythonWasmPath, not user source.
+            logger.warn('Python tree-sitter init failed; regex fallback in use', {
+                wasmPath: this.wasmPath,
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+        }
+    }
+    store(filePath, tree, content) {
+        if (!this.cache.has(filePath) && this.cache.size >= this.maxTrees) {
+            this.evictLRU();
+        }
+        this.cache.set(filePath, {
+            tree,
+            content,
+            lastUsed: ++this.useCounter,
+            lastResult: null,
+        });
+    }
+    touch(filePath, entry) {
+        entry.lastUsed = ++this.useCounter;
+        this.cache.set(filePath, entry);
+    }
+    evictLRU() {
+        let oldestKey = null;
+        let oldest = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.lastUsed < oldest) {
+                oldest = entry.lastUsed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey)
+            this.invalidate(oldestKey);
+    }
+    safeDelete(tree) {
+        try {
+            tree.delete();
+        }
+        catch {
+            // Already-deleted trees throw; swallow for robustness.
+        }
+    }
+}
+//# sourceMappingURL=pythonIncremental.js.map

package/dist/src/analysis/tree-sitter/pythonIncremental.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythonIncremental.js","sourceRoot":"","sources":["../../../../src/analysis/tree-sitter/pythonIncremental.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AAEnC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAiB,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAkB,MAAM,sBAAsB,CAAA;AAE/F,MAAM,MAAM,GAAG,YAAY,CAAC,yBAAyB,CAAC,CAAA;AAEtD,sGAAsG;AACtG,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAA;AACjD,CAAC;AAED,qEAAqE;AACrE,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B,qFAAqF;AACrF,MAAM,UAAU,qBAAqB;IACnC,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACzD,MAAM,UAAU,GAAG;QACjB,kCAAkC;QAClC,IAAI,CAAC,OAAO,CACV,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,mBAAmB,EACnB,KAAK,EACL,yBAAyB,CAC1B;QACD,+DAA+D;QAC/D,IAAI,CAAC,OAAO,CACV,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,mBAAmB,EACnB,KAAK,EACL,yBAAyB,CAC1B;KACF,CAAA;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAA;IAChD,CAAC;IACD,sEAAsE;IACtE,sEAAsE;IACtE,uCAAuC;IACvC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAA;AACtB,CAAC;AA8BD,MAAM,aAAa,GAAwB,KAAK,IAAI,EAAE;IACpD,kEAAkE;IAClE,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAI3C,CAAA;IACD,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,sDAAsD;QACtD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,SAAS,GAAI,GAAG,CAAC,MAAoD,CAAC,IAAI,CAAA;YAChF,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;gBACpC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IACjB,QAAQ,CAAQ;IAChB,QAAQ,CAAQ;IAChB,MAAM,CAAqB;IAC3B,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC/C,MAAM,GAA4B,IAAI,CAAA;IACtC,QAAQ,GAA8B,IAAI,CAAA;IAC1C,OAAO,GAA0B,IAAI,CAAA;IACrC,WAAW,GAAyB,IAAI,CAAA;IACxC,UAAU,GAAG,KAAK,CAAA;IAClB,UAAU,GAAG,CAAC,CAAA;IAEtB,YACE,UAA0C,EAAE,EAC5C,SAA8B,aAAa;QAE3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAA;QACrD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,EAAE,CAAA;QAC3D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,yEAAyE;IACzE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAA;IAChF,CAAC;IAED,gFAAgF;IAChF,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,QAAgB;QAC3C,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,OAAe,EAAE,QAAgB;QACzC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAA0B,CAAA;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAyB,CAAA;QAE9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvC,IAAI,IAAoB,CAAA;YACxB,IAAI,YAAY,GAAuB,IAAI,CAAA;YAE3C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBACrD,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,gEAAgE;oBAChE,kCAAkC;oBAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;oBAC5B,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;oBAClB,YAAY,GAAG,MAAM,CAAC,UAAU,CAAA;gBAClC,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,GAAa,aAAa,CAClC,MAAM,CAAC,OAAO,EACd,OAAO,EACP,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,CACb,CAAA;oBACD,yDAAyD;oBACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAA8C,CAAA;oBACtE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACnB,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;oBACzC,uDAAuD;oBACvD,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI;wBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;oBACtD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBACrC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;YACrC,CAAC;YAED,IAAI,YAAY;gBAAE,OAAO,YAAY,CAAA;YACrC,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;YAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACtC,IAAI,KAAK;gBAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAA;YACpC,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oEAAoE;YACpE,qEAAqE;YACrE,oEAAoE;YACpE,mEAAmE;YACnE,oEAAoE;YACpE,IAAI,WAAW,CAAC,gBAAgB,QAAQ,EAAE,CAAC,EAAE,CAAC;gBAC5C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACtE,MAAM,CAAC,IAAI,CAAC,uDAAuD,EAAE;oBACnE,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;iBAC1B,CAAC,CAAA;YACJ,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,UAAU,CAAC,QAAgB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACtC,IAAI,CAAC,KAAK;YAAE,OAAM;QAClB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAED,0CAA0C;IAC1C,OAAO;QACL,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACpE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QAClB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAA;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAED,kEAAkE;IAClE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,mEAAmE;IACnE,UAAU;IACV,mEAAmE;IAE3D,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU;YAAE,OAAM;QAC3C,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,WAAW,CAAA;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAA;QACxB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACzB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;YAChC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;YACjB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAA;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CACvD;YAAC,MAAuD,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;YAC/E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;YACpB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;YACxB,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;YACnB,qEAAqE;YACrE,sEAAsE;YACtE,gEAAgE;YAChE,0CAA0C;YAC1C,MAAM,CAAC,IAAI,CAAC,uDAAuD,EAAE;gBACnE,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAgB,EAAE,IAAoB,EAAE,OAAe;QACnE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClE,IAAI,CAAC,QAAQ,EAAE,CAAA;QACjB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,IAAI;YACJ,OAAO;YACP,QAAQ,EAAE,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI;SACjB,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,QAAgB,EAAE,KAAkB;QAChD,KAAK,CAAC,QAAQ,GAAG,EAAE,IAAI,CAAC,UAAU,CAAA;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IACjC,CAAC;IAEO,QAAQ;QACd,IAAI,SAAS,GAAkB,IAAI,CAAA;QACnC,IAAI,MAAM,GAAG,QAAQ,CAAA;QACrB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAC;gBAC5B,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAA;gBACvB,SAAS,GAAG,GAAG,CAAA;YACjB,CAAC;QACH,CAAC;QACD,IAAI,SAAS;YAAE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC3C,CAAC;IAEO,UAAU,CAAC,IAAoB;QACrC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,CAAA;QACf,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;CACF"}

package/dist/src/analysis/tree-sitter/pythonIncremental.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SMI-4293: PythonIncrementalParser unit tests.
+ *
+ * Covers the six cases called out in the plan:
+ *   1. First parse caches the tree.
+ *   2. Unchanged content re-parse hits the cache (no re-parse).
+ *   3. Incremental edits re-use the previous tree via tree.edit().
+ *   4. LRU eviction at the configured max.
+ *   5. Corrupted cached tree falls back gracefully (returns null, adapter
+ *      then falls back to regex).
+ *   6. Unsupported / unavailable grammar surfaces `isReady === false` and
+ *      `parseSync` returns null.
+ *
+ * @see docs/internal/implementation/github-wave-5c-tree-sitter-incremental.md
+ */
+export {};
+//# sourceMappingURL=pythonIncremental.test.d.ts.map

package/dist/src/analysis/tree-sitter/pythonIncremental.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pythonIncremental.test.d.ts","sourceRoot":"","sources":["../../../../src/analysis/tree-sitter/pythonIncremental.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}