@hookwarden/engine 0.0.1 → 0.1.1

package/dist/parsers/babel.js

@@ -0,0 +1,121 @@
+// JS/TS parser adapter (ENGINE-01). Calls @babel/parser, normalizes the result into ParsedFile.
+// Engine-pure: NO fs / http / net / process — caller hands us source_text.
+// D-27 all-or-nothing: any parse error short-circuits to a ParseErrorRecord with empty imports.
+// Plugin set is permissive per phase-2 Claude's Discretion; Phase 6 will tighten against the 200+ corpus.
+import { parse } from "@babel/parser";
+const TS_FAMILY = [
+    "typescript",
+    "decorators-legacy",
+    "topLevelAwait",
+    "importAttributes",
+    "explicitResourceManagement",
+];
+const JS_FAMILY = [
+    "decorators-legacy",
+    "topLevelAwait",
+    "importAttributes",
+    "explicitResourceManagement",
+];
+const JSX_FAMILY = ["jsx"];
+function pluginsFor(hint, filePath) {
+    const ext = (hint ?? filePath.split(".").pop() ?? "").toLowerCase();
+    const isTs = ext === "ts" || ext === "tsx";
+    const isJsx = ext === "tsx" || ext === "jsx";
+    const out = isTs ? [...TS_FAMILY] : [...JS_FAMILY];
+    if (isJsx)
+        out.push(...JSX_FAMILY);
+    return out;
+}
+function languageFor(hint, filePath) {
+    const ext = (hint ?? filePath.split(".").pop() ?? "").toLowerCase();
+    return ext === "ts" || ext === "tsx" ? "typescript" : "javascript";
+}
+export async function parseJsTs(input) {
+    const { file_path, source_text } = input;
+    const plugins = pluginsFor(input.hint, file_path);
+    const language = languageFor(input.hint, file_path);
+    let ast = null;
+    let parseError = null;
+    try {
+        ast = parse(source_text, {
+            sourceType: "module",
+            plugins: plugins,
+            errorRecovery: false, // D-27: we want the throw, not a partial tree
+            tokens: false,
+            ranges: false,
+            attachComment: false,
+            allowReturnOutsideFunction: false,
+        });
+    }
+    catch (err) {
+        // Babel's SyntaxError carries .loc = { line, column } (1-indexed line, 0-indexed column).
+        const e = err;
+        parseError = {
+            message: e?.message ?? "babel parse error",
+            location: { line: e?.loc?.line ?? 1, col: (e?.loc?.column ?? 0) + 1 },
+            source: "babel",
+        };
+    }
+    // D-27: when parse_error is set, downstream rules MUST NOT inspect raw_ast — return empty imports.
+    const imports = ast === null ? [] : extractImports(ast, file_path);
+    return {
+        file_path,
+        language,
+        dialect: "babel",
+        source_text,
+        raw_ast: ast,
+        imports,
+        parse_error: parseError,
+    };
+}
+function extractImports(ast, fromFile) {
+    const out = [];
+    for (const stmt of ast.program.body) {
+        // ES module imports: import { a, b as c } from 'x'; import d from 'x'; import * as ns from 'x';
+        if (stmt.type === "ImportDeclaration") {
+            out.push(toImportEdge(stmt, fromFile));
+            continue;
+        }
+        // CJS interop: const x = require('y'); top-level only.
+        if (stmt.type === "VariableDeclaration") {
+            for (const decl of stmt.declarations) {
+                if (decl.init?.type !== "CallExpression")
+                    continue;
+                const callee = decl.init.callee;
+                if (callee.type !== "Identifier" || callee.name !== "require")
+                    continue;
+                const arg = decl.init.arguments[0];
+                if (!arg || arg.type !== "StringLiteral")
+                    continue;
+                const local = decl.id.type === "Identifier" ? decl.id.name : "<destructured>";
+                out.push({
+                    from_file: fromFile,
+                    to_module: arg.value,
+                    imported_names: [{ local, source: "default" }],
+                    is_default: true,
+                });
+            }
+        }
+    }
+    return out;
+}
+function toImportEdge(node, fromFile) {
+    const toModule = node.source.value;
+    const names = [];
+    let isDefault = false;
+    for (const spec of node.specifiers) {
+        if (spec.type === "ImportDefaultSpecifier") {
+            isDefault = true;
+            names.push({ local: spec.local.name, source: "default" });
+        }
+        else if (spec.type === "ImportSpecifier") {
+            const importedName = spec.imported.type === "Identifier" ? spec.imported.name : spec.imported.value;
+            names.push({ local: spec.local.name, source: importedName });
+        }
+        else if (spec.type === "ImportNamespaceSpecifier") {
+            names.push({ local: spec.local.name, source: "*" });
+        }
+    }
+    return { from_file: fromFile, to_module: toModule, imported_names: names, is_default: isDefault };
+}
+//# sourceMappingURL=babel.js.map

package/dist/parsers/babel.js.map

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

package/dist/parsers/index.d.ts

@@ -0,0 +1,6 @@
+export { type BabelFile, type BabelNode, type ParseJsTsInput, parseJsTs } from "./babel.js";
+export { extractBabelLiterals } from "./literals.js";
+export { type ParsePythonInput, parsePython } from "./python.js";
+export { extractPythonLiterals } from "./python-literals.js";
+export { type InitPythonRuntimeInput, initPythonRuntime, type PythonRuntime, } from "./python-loader.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,KAAK,sBAAsB,EAC3B,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/parsers/index.js

@@ -0,0 +1,7 @@
+// parsers/ barrel — engine-internal. Public package barrel does not re-export parsers.
+export { parseJsTs } from "./babel.js";
+export { extractBabelLiterals } from "./literals.js";
+export { parsePython } from "./python.js";
+export { extractPythonLiterals } from "./python-literals.js";
+export { initPythonRuntime, } from "./python-loader.js";
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAuD,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAyB,WAAW,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAEL,iBAAiB,GAElB,MAAM,oBAAoB,CAAC"}

package/dist/parsers/literals.d.ts

@@ -0,0 +1,4 @@
+import type { File } from "@babel/types";
+import type { LiteralSpan } from "../redaction/structural.js";
+export declare function extractBabelLiterals(ast: File | null): ReadonlyArray<LiteralSpan>;
+//# sourceMappingURL=literals.d.ts.map

package/dist/parsers/literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"literals.d.ts","sourceRoot":"","sources":["../../src/parsers/literals.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAa9D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CA0BjF"}

package/dist/parsers/literals.js

@@ -0,0 +1,37 @@
+// Walks a Babel File and extracts every literal span the redactor needs.
+// Pure traversal: depth-first via the shared walkUntypedAst helper. No @babel/traverse dep.
+import { walkUntypedAst } from "./walk.js";
+function pushSpan(out, kind, node, value) {
+    if (typeof node.start !== "number" || typeof node.end !== "number")
+        return;
+    out.push({ kind, start: node.start, end: node.end, value });
+}
+export function extractBabelLiterals(ast) {
+    if (ast === null)
+        return [];
+    const out = [];
+    walkUntypedAst(ast, (node) => {
+        switch (node.type) {
+            case "StringLiteral":
+                pushSpan(out, "string", node, node.value);
+                return;
+            case "NumericLiteral":
+            case "BigIntLiteral":
+                pushSpan(out, "number", node, String(node.value));
+                return;
+            case "TemplateLiteral":
+                // Whole template captured as one span so substitution values cannot survive redaction.
+                pushSpan(out, "template", node, "<TEMPLATE>");
+                return;
+            case "RegExpLiteral":
+                pushSpan(out, "regex", node, node.pattern);
+                return;
+            default:
+                return;
+        }
+    });
+    // Stable order: ascending by start.
+    out.sort((a, b) => a.start - b.start);
+    return out;
+}
+//# sourceMappingURL=literals.js.map

package/dist/parsers/literals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"literals.js","sourceRoot":"","sources":["../../src/parsers/literals.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4FAA4F;AAI5F,OAAO,EAAqB,cAAc,EAAE,MAAM,WAAW,CAAC;AAE9D,SAAS,QAAQ,CACf,GAAkB,EAClB,IAAyB,EACzB,IAAkB,EAClB,KAAa;IAEb,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO;IAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAgB;IACnD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,cAAc,CAAC,GAA8B,EAAE,CAAC,IAAI,EAAE,EAAE;QACtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,eAAe;gBAClB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAG,IAAqC,CAAC,KAAK,CAAC,CAAC;gBAC5E,OAAO;YACT,KAAK,gBAAgB,CAAC;YACtB,KAAK,eAAe;gBAClB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAE,IAAsC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrF,OAAO;YACT,KAAK,iBAAiB;gBACpB,uFAAuF;gBACvF,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;gBAC9C,OAAO;YACT,KAAK,eAAe;gBAClB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAG,IAAuC,CAAC,OAAO,CAAC,CAAC;gBAC/E,OAAO;YACT;gBACE,OAAO;QACX,CAAC;IACH,CAAC,CAAC,CAAC;IACH,oCAAoC;IACpC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/parsers/python-literals.d.ts

@@ -0,0 +1,5 @@
+import type { Node, Tree } from "web-tree-sitter";
+import type { LiteralSpan } from "../redaction/structural.js";
+export declare function extractPythonLiterals(tree: Tree | null): ReadonlyArray<LiteralSpan>;
+export type { Node as TreeSitterNode };
+//# sourceMappingURL=python-literals.d.ts.map

package/dist/parsers/python-literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-literals.d.ts","sourceRoot":"","sources":["../../src/parsers/python-literals.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAO9D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAsCnF;AAkBD,YAAY,EAAE,IAAI,IAAI,cAAc,EAAE,CAAC"}

package/dist/parsers/python-literals.js

@@ -0,0 +1,62 @@
+// Walks a tree-sitter-python tree and emits LiteralSpan[] for the redactor (D-39).
+// Pure: in-memory tree traversal only — engine purity gate (D-01) bans any I/O imports.
+// tree-sitter-python literal node types we care about. (Confirmed against tree-sitter-python's
+// `node-types.json`; if a grammar bump renames any of these, update this list.)
+const STRING_NODES = ["string"];
+const NUMBER_NODES = ["integer", "float"];
+export function extractPythonLiterals(tree) {
+    if (tree === null)
+        return [];
+    const out = [];
+    const root = tree.rootNode;
+    for (const node of root.descendantsOfType([...STRING_NODES, ...NUMBER_NODES])) {
+        if (NUMBER_NODES.includes(node.type)) {
+            out.push({
+                kind: "number",
+                start: node.startIndex,
+                end: node.endIndex,
+                value: node.text,
+            });
+            continue;
+        }
+        // String literal. Detect f-string by looking for an `interpolation` named descendant.
+        // (Some grammar versions use `string_interpolation`; treat both as template.)
+        const isTemplate = node.descendantsOfType(["interpolation", "string_interpolation"]).length > 0;
+        if (isTemplate) {
+            out.push({
+                kind: "template",
+                start: node.startIndex,
+                end: node.endIndex,
+                value: "<TEMPLATE>",
+            });
+            continue;
+        }
+        // Plain string literal. The `text` field includes the quote characters and any prefix
+        // (b, r, u). Strip prefix + quotes to get the inner value for length-aware redaction.
+        const innerValue = stripPythonQuotes(node.text);
+        out.push({
+            kind: "string",
+            start: node.startIndex,
+            end: node.endIndex,
+            value: innerValue,
+        });
+    }
+    out.sort((a, b) => a.start - b.start);
+    return out;
+}
+function stripPythonQuotes(raw) {
+    // Strip any prefix character (b, r, u, B, R, U, plus combos like rb, fr).
+    let i = 0;
+    while (i < raw.length && /[bBrRuUfF]/.test(raw[i] ?? ""))
+        i++;
+    const quoted = raw.slice(i);
+    // Triple-quoted ('''x''' or """x""") and single-quoted ('x' or "x").
+    if (quoted.startsWith('"""') || quoted.startsWith("'''")) {
+        return quoted.slice(3, quoted.length - 3);
+    }
+    if (quoted.startsWith('"') || quoted.startsWith("'")) {
+        return quoted.slice(1, quoted.length - 1);
+    }
+    return quoted;
+}
+//# sourceMappingURL=python-literals.js.map

package/dist/parsers/python-literals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-literals.js","sourceRoot":"","sources":["../../src/parsers/python-literals.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wFAAwF;AAKxF,+FAA+F;AAC/F,gFAAgF;AAChF,MAAM,YAAY,GAAG,CAAC,QAAQ,CAAU,CAAC;AACzC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC;AAEnD,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC;QAC9E,IAAK,YAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,sFAAsF;QACtF,8EAA8E;QAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAChG,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,KAAK,EAAE,YAAY;aACpB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,sFAAsF;QACtF,sFAAsF;QACtF,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI,CAAC,UAAU;YACtB,GAAG,EAAE,IAAI,CAAC,QAAQ;YAClB,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;IACL,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,0EAA0E;IAC1E,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAAE,CAAC,EAAE,CAAC;IAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,qEAAqE;IACrE,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/parsers/python-loader.d.ts

@@ -0,0 +1,9 @@
+import { Parser } from "web-tree-sitter";
+export interface PythonRuntime {
+    readonly parser: Parser;
+}
+export interface InitPythonRuntimeInput {
+    readonly wasmBytes: Uint8Array;
+}
+export declare function initPythonRuntime(input: InitPythonRuntimeInput): Promise<PythonRuntime>;
+//# sourceMappingURL=python-loader.d.ts.map

package/dist/parsers/python-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-loader.d.ts","sourceRoot":"","sources":["../../src/parsers/python-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;CAChC;AAID,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAS7F"}

package/dist/parsers/python-loader.js

@@ -0,0 +1,16 @@
+// Caller-supplied init for the tree-sitter-python WASM runtime.
+// D-01 engine purity: this module never opens the .wasm file. The CLI runner reads
+// it from disk (or fetch in a future browser playground build) and passes the bytes.
+import { Language, Parser } from "web-tree-sitter";
+let parserInited = false;
+export async function initPythonRuntime(input) {
+    if (!parserInited) {
+        await Parser.init();
+        parserInited = true;
+    }
+    const language = await Language.load(input.wasmBytes);
+    const parser = new Parser();
+    parser.setLanguage(language);
+    return { parser };
+}
+//# sourceMappingURL=python-loader.js.map

package/dist/parsers/python-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-loader.js","sourceRoot":"","sources":["../../src/parsers/python-loader.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mFAAmF;AACnF,qFAAqF;AAErF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAWnD,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAA6B;IACnE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/parsers/python.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedFile } from "../types/project-model.js";
+import type { PythonRuntime } from "./python-loader.js";
+export interface ParsePythonInput {
+    readonly file_path: string;
+    readonly source_text: string;
+}
+export declare function parsePython(input: ParsePythonInput, runtime: PythonRuntime): Promise<ParsedFile>;
+//# sourceMappingURL=python.d.ts.map

package/dist/parsers/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../src/parsers/python.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAc,UAAU,EAAoB,MAAM,2BAA2B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,UAAU,CAAC,CA2BrB"}

package/dist/parsers/python.js

@@ -0,0 +1,125 @@
+// Python parser adapter (ENGINE-02). web-tree-sitter (WASM) + tree-sitter-python.
+// D-27 all-or-nothing: any ERROR or MISSING node in the parse output triggers a ParseErrorRecord.
+// PITFALLS #6: tree-sitter-python decorator-grammar gaps surface here as parse errors,
+// NOT as silently-skipped files. The all-or-nothing policy is the user-visible signal.
+export async function parsePython(input, runtime) {
+    const { file_path, source_text } = input;
+    // tree-sitter never throws on parse — it always returns a tree (possibly null on OOM).
+    // Errors surface as ERROR / MISSING nodes inside the tree.
+    const tree = runtime.parser.parse(source_text);
+    let parseError = null;
+    if (tree === null) {
+        parseError = {
+            message: "tree-sitter-python: parser returned null tree",
+            location: { line: 1, col: 1 },
+            source: "tree-sitter",
+        };
+    }
+    else {
+        parseError = findFirstError(tree.rootNode);
+    }
+    const cleanTree = parseError === null ? tree : null;
+    const imports = cleanTree === null ? [] : extractImports(cleanTree.rootNode, file_path);
+    return {
+        file_path,
+        language: "python",
+        dialect: "tree-sitter-python",
+        source_text,
+        raw_ast: cleanTree, // D-27: null on error
+        imports,
+        parse_error: parseError,
+    };
+}
+function findFirstError(root) {
+    // DFS from rootNode; stop at first ERROR or MISSING node.
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            break;
+        if (node.type === "ERROR" || node.isMissing) {
+            return {
+                message: node.isMissing
+                    ? `tree-sitter-python: missing token (${node.type})`
+                    : `tree-sitter-python: ERROR node at ${node.startPosition.row + 1}:${node.startPosition.column + 1}`,
+                location: { line: node.startPosition.row + 1, col: node.startPosition.column + 1 },
+                source: "tree-sitter",
+            };
+        }
+        if (!node.hasError)
+            continue; // entire subtree is clean; skip
+        for (const child of node.namedChildren) {
+            if (child !== null)
+                stack.push(child);
+        }
+    }
+    return null;
+}
+function extractImports(root, fromFile) {
+    const out = [];
+    // tree-sitter-python distinguishes:
+    //   import_statement       → `import a`, `import a as b`, `import a, c`
+    //   import_from_statement  → `from a import b`, `from a import b as c`, `from a import (b, c)`
+    for (const node of root.descendantsOfType(["import_statement", "import_from_statement"])) {
+        if (node.type === "import_statement") {
+            // Children include dotted_name | aliased_import nodes.
+            for (const child of node.namedChildren) {
+                if (child === null)
+                    continue;
+                if (child.type === "dotted_name") {
+                    out.push({
+                        from_file: fromFile,
+                        to_module: child.text,
+                        imported_names: [{ local: child.text, source: "default" }],
+                        is_default: true,
+                    });
+                }
+                else if (child.type === "aliased_import") {
+                    const name = child.childForFieldName("name")?.text ?? "";
+                    const alias = child.childForFieldName("alias")?.text ?? name;
+                    out.push({
+                        from_file: fromFile,
+                        to_module: name,
+                        imported_names: [{ local: alias, source: "default" }],
+                        is_default: true,
+                    });
+                }
+            }
+        }
+        else {
+            // import_from_statement. The module_name field child is itself a dotted_name, so identifying
+            // imported-name children requires comparing byte offsets — tree-sitter returns fresh node
+            // objects on each accessor, so reference equality is not reliable.
+            const moduleNode = node.childForFieldName("module_name");
+            const moduleName = moduleNode?.text ?? "";
+            const moduleStart = moduleNode?.startIndex ?? -1;
+            const moduleEnd = moduleNode?.endIndex ?? -1;
+            const names = [];
+            for (const child of node.namedChildren) {
+                if (child === null)
+                    continue;
+                // Skip the module_name child by byte-offset match.
+                if (child.startIndex === moduleStart && child.endIndex === moduleEnd)
+                    continue;
+                if (child.type === "dotted_name") {
+                    names.push({ local: child.text, source: child.text });
+                }
+                else if (child.type === "aliased_import") {
+                    const src = child.childForFieldName("name")?.text ?? "";
+                    const alias = child.childForFieldName("alias")?.text ?? src;
+                    names.push({ local: alias, source: src });
+                }
+            }
+            if (moduleName !== "") {
+                out.push({
+                    from_file: fromFile,
+                    to_module: moduleName,
+                    imported_names: names,
+                    is_default: false,
+                });
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=python.js.map

package/dist/parsers/python.js.map

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

package/dist/parsers/walk.d.ts

@@ -0,0 +1,15 @@
+import type { Node } from "@babel/types";
+/**
+ * Walk a Babel AST depth-first, invoking `visitor` on every node.
+ *
+ * The visitor cannot stop traversal — call sites that need early-exit semantics
+ * collect into an output array and inspect it after the walk completes.
+ */
+export declare function walkBabelAst(root: Node, visitor: (node: Node) => void): void;
+export interface MaybeAstNode {
+    readonly type?: string;
+    readonly start?: number | null;
+    readonly end?: number | null;
+}
+export declare function walkUntypedAst(root: MaybeAstNode | null | undefined, visitor: (node: MaybeAstNode) => void): void;
+//# sourceMappingURL=walk.d.ts.map

package/dist/parsers/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/parsers/walk.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAMzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI,CAoB5E;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GACpC,IAAI,CAqBN"}

package/dist/parsers/walk.js

@@ -0,0 +1,66 @@
+// Canonical iterative AST walkers. Engine has multiple readers (literal extraction, catalog
+// detection, future reachability + middleware extraction in Plan 06b, evaluator dispatch in
+// Plan 02-08) — all use the same depth-first walk.
+//
+// Iterative (not recursive) so deeply-nested ASTs cannot exhaust the JS stack — a real concern
+// for adversarial source. Bounded by the parser's source-size cap (Phase 8 worker concern).
+// Keys we never recurse into. `loc` is metadata; `start`/`end` are byte offsets;
+// `range` is a tuple alias for start/end; `type` is the node discriminator itself.
+const SKIP_KEYS = new Set(["loc", "type", "start", "end", "range"]);
+/**
+ * Walk a Babel AST depth-first, invoking `visitor` on every node.
+ *
+ * The visitor cannot stop traversal — call sites that need early-exit semantics
+ * collect into an output array and inspect it after the walk completes.
+ */
+export function walkBabelAst(root, visitor) {
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            break;
+        visitor(node);
+        for (const key of Object.keys(node)) {
+            if (SKIP_KEYS.has(key))
+                continue;
+            const value = node[key];
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (item && typeof item === "object" && "type" in item) {
+                        stack.push(item);
+                    }
+                }
+            }
+            else if (value && typeof value === "object" && "type" in value) {
+                stack.push(value);
+            }
+        }
+    }
+}
+export function walkUntypedAst(root, visitor) {
+    if (!root || typeof root.type !== "string")
+        return;
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            break;
+        visitor(node);
+        for (const key of Object.keys(node)) {
+            if (SKIP_KEYS.has(key))
+                continue;
+            const value = node[key];
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    if (item && typeof item === "object" && "type" in item) {
+                        stack.push(item);
+                    }
+                }
+            }
+            else if (value && typeof value === "object" && "type" in value) {
+                stack.push(value);
+            }
+        }
+    }
+}
+//# sourceMappingURL=walk.js.map

package/dist/parsers/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/parsers/walk.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,mDAAmD;AACnD,EAAE;AACF,+FAA+F;AAC/F,4FAA4F;AAI5F,iFAAiF;AACjF,mFAAmF;AACnF,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,OAA6B;IACpE,MAAM,KAAK,GAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,MAAM;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACjC,MAAM,KAAK,GAAI,IAA2C,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAK,IAAe,EAAE,CAAC;wBACnE,KAAK,CAAC,IAAI,CAAC,IAAY,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAK,KAAgB,EAAE,CAAC;gBAC7E,KAAK,CAAC,IAAI,CAAC,KAAa,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAYD,MAAM,UAAU,cAAc,CAC5B,IAAqC,EACrC,OAAqC;IAErC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO;IACnD,MAAM,KAAK,GAAmB,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,MAAM;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACjC,MAAM,KAAK,GAAI,IAA2C,CAAC,GAAG,CAAC,CAAC;YAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAK,IAAe,EAAE,CAAC;wBACnE,KAAK,CAAC,IAAI,CAAC,IAAoB,CAAC,CAAC;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAK,KAAgB,EAAE,CAAC;gBAC7E,KAAK,CAAC,IAAI,CAAC,KAAqB,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/redaction/index.d.ts

@@ -0,0 +1,3 @@
+export type { LiteralKind, LiteralSpan, RedactionInput } from "./structural.js";
+export { redactSnippet } from "./structural.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redaction/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/redaction/index.js

@@ -0,0 +1,2 @@
+export { redactSnippet } from "./structural.js";
+//# sourceMappingURL=index.js.map

package/dist/redaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/redaction/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/redaction/structural.d.ts

@@ -0,0 +1,14 @@
+export type LiteralKind = "string" | "number" | "template" | "regex" | "secret";
+export interface LiteralSpan {
+    readonly kind: LiteralKind;
+    readonly start: number;
+    readonly end: number;
+    readonly value: string;
+}
+export interface RedactionInput {
+    readonly source_text: string;
+    readonly literals: ReadonlyArray<LiteralSpan>;
+    readonly secret_literal_prefixes?: ReadonlyArray<string>;
+}
+export declare function redactSnippet(input: RedactionInput): string;
+//# sourceMappingURL=structural.d.ts.map

package/dist/redaction/structural.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural.d.ts","sourceRoot":"","sources":["../../src/redaction/structural.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAG9C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1D;AAuBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAQ3D"}