@crewbie/cli 0.1.0-alpha.51 → 0.1.0-alpha.53

package/dist/setup/code-graph-export.js

@@ -0,0 +1,328 @@
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+const DEFAULT_LIMITS = { maxBytes: 256_000_000, maxValueBytes: 1_000_000, maxDepth: 64 };
+const CHUNK_BYTES = 64 * 1024;
+class ExportError extends Error {
+}
+function invalid() {
+    throw new ExportError("Invalid CodeGraph export JSON. No assessment was sent; raw tool output was withheld.");
+}
+function valueBudget(bytes, limit) {
+    if (bytes > limit)
+        throw new ExportError(`CodeGraph export value is ${bytes} bytes; the buffered value limit is ${limit} bytes. No assessment was sent.`);
+}
+const whitespace = (code) => code === 32 || code === 9 || code === 10 || code === 13;
+const numberCharacter = (code) => code >= 48 && code <= 57 || code === 45 || code === 43 || code === 46 || code === 69 || code === 101;
+/** Synchronous chunk scanning: no per-character promises and no whole-export string. */
+class Tokenizer {
+    limit;
+    mode;
+    parts = [];
+    bytes = 0;
+    escaped = false;
+    hexLeft = 0;
+    literal = "";
+    literalOffset = 0;
+    constructor(limit) {
+        this.limit = limit;
+    }
+    append(part) {
+        this.bytes += Buffer.byteLength(part);
+        valueBudget(this.bytes, this.limit);
+        this.parts.push(part);
+    }
+    complete(kind) {
+        const token = { kind, raw: this.parts.join(""), bytes: this.bytes };
+        this.parts = [];
+        this.bytes = 0;
+        this.mode = undefined;
+        if (kind === "number" && !/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(token.raw))
+            invalid();
+        return token;
+    }
+    *write(text) {
+        let offset = 0;
+        while (offset < text.length) {
+            let start = offset;
+            if (this.mode === undefined) {
+                const char = text[offset];
+                if (whitespace(text.charCodeAt(offset))) {
+                    do {
+                        offset++;
+                    } while (offset < text.length && whitespace(text.charCodeAt(offset)));
+                    yield { kind: "whitespace", raw: text.slice(start, offset), bytes: offset - start };
+                    continue;
+                }
+                if ("{}[]:,".includes(char)) {
+                    offset++;
+                    yield { kind: "punctuation", raw: char, bytes: 1 };
+                    continue;
+                }
+                if (char === '"') {
+                    this.mode = "string";
+                    offset++;
+                }
+                else if (char === "-" || char >= "0" && char <= "9")
+                    this.mode = "number";
+                else if (char === "t" || char === "f" || char === "n") {
+                    this.mode = "literal";
+                    this.literal = char === "t" ? "true" : char === "f" ? "false" : "null";
+                    this.literalOffset = 0;
+                }
+                else
+                    invalid();
+            }
+            if (this.mode === "string") {
+                let complete = false;
+                while (offset < text.length) {
+                    const char = text[offset++];
+                    if (this.hexLeft) {
+                        if (!/^[0-9a-fA-F]$/.test(char))
+                            invalid();
+                        this.hexLeft--;
+                    }
+                    else if (this.escaped) {
+                        this.escaped = false;
+                        if (char === "u")
+                            this.hexLeft = 4;
+                        else if (!'"\\/bfnrt'.includes(char))
+                            invalid();
+                    }
+                    else if (char === "\\")
+                        this.escaped = true;
+                    else if (char === '"') {
+                        complete = true;
+                        break;
+                    }
+                    else if (char.charCodeAt(0) < 32)
+                        invalid();
+                }
+                this.append(text.slice(start, offset));
+                if (complete)
+                    yield this.complete("string");
+            }
+            else if (this.mode === "number") {
+                while (offset < text.length && numberCharacter(text.charCodeAt(offset)))
+                    offset++;
+                this.append(text.slice(start, offset));
+                if (offset < text.length)
+                    yield this.complete("number");
+            }
+            else if (this.mode === "literal") {
+                while (offset < text.length && this.literalOffset < this.literal.length) {
+                    if (text[offset++] !== this.literal[this.literalOffset++])
+                        invalid();
+                }
+                this.append(text.slice(start, offset));
+                if (this.literalOffset === this.literal.length)
+                    yield this.complete("literal");
+            }
+        }
+    }
+    *finish() {
+        if (this.mode === "number")
+            yield this.complete("number");
+        else if (this.mode !== undefined)
+            invalid();
+    }
+}
+/** Validates all JSON, while retaining just one graph record. Metadata is discarded token by token. */
+class GraphParser {
+    kind;
+    limit;
+    maxDepth;
+    stack = [];
+    keys = new Set();
+    keyBytes = 0;
+    started = false;
+    finished = false;
+    capture;
+    constructor(kind, limit, maxDepth) {
+        this.kind = kind;
+        this.limit = limit;
+        this.maxDepth = maxDepth;
+    }
+    append(token) {
+        if (!this.capture)
+            return;
+        this.capture.bytes += token.bytes;
+        valueBudget(this.capture.bytes, this.limit);
+        this.capture.parts.push(token.raw);
+    }
+    valueFinished() {
+        const parent = this.stack.at(-1);
+        if (parent)
+            parent.state = "commaOrEnd";
+        else
+            this.finished = true;
+    }
+    push(frame) {
+        if (this.stack.length >= this.maxDepth)
+            throw new ExportError(`CodeGraph export exceeds the nesting limit of ${this.maxDepth}. No assessment was sent.`);
+        this.stack.push(frame);
+    }
+    accept(token) {
+        this.append(token);
+        if (token.kind === "whitespace")
+            return;
+        if (this.finished)
+            invalid();
+        if (!this.started) {
+            if (token.raw !== "{")
+                invalid();
+            this.started = true;
+            this.push({ type: "object", state: "keyOrEnd" });
+            return;
+        }
+        const frame = this.stack.at(-1);
+        const objectEnd = token.raw === "}" && frame.type === "object" && (frame.state === "keyOrEnd" || frame.state === "commaOrEnd");
+        const arrayEnd = token.raw === "]" && frame.type === "array" && (frame.state === "valueOrEnd" || frame.state === "commaOrEnd");
+        if (objectEnd || arrayEnd) {
+            let result;
+            if (this.capture?.depth === this.stack.length) {
+                // Even unselected records have a size limit and must be valid object JSON.
+                if (this.capture.kind === this.kind) {
+                    try {
+                        result = JSON.parse(this.capture.parts.join(""));
+                    }
+                    catch {
+                        invalid();
+                    }
+                }
+                this.capture = undefined;
+            }
+            this.stack.pop();
+            this.valueFinished();
+            return result;
+        }
+        if (frame.type === "object" && (frame.state === "keyOrEnd" || frame.state === "key")) {
+            if (token.kind !== "string")
+                invalid();
+            if (this.stack.length === 1) {
+                const key = JSON.parse(token.raw);
+                if (this.keys.has(key))
+                    invalid();
+                // Include an allowance per entry so many tiny distinct names cannot grow the Set without bound.
+                this.keyBytes += token.bytes + 32;
+                valueBudget(this.keyBytes, this.limit);
+                this.keys.add(key);
+                frame.key = key;
+            }
+            frame.state = "colon";
+            return;
+        }
+        if (frame.state === "colon") {
+            if (token.raw !== ":")
+                invalid();
+            frame.state = "value";
+            return;
+        }
+        if (frame.state === "commaOrEnd") {
+            if (token.raw !== ",")
+                invalid();
+            frame.state = frame.type === "object" ? "key" : "value";
+            return;
+        }
+        if (frame.state !== "value" && frame.state !== "valueOrEnd")
+            invalid();
+        const graph = this.stack.length === 1 && frame.type === "object" && (frame.key === "nodes" || frame.key === "edges") ? frame.key : undefined;
+        if (graph && token.raw !== "[")
+            invalid();
+        if (frame.type === "array" && frame.graph) {
+            if (token.raw !== "{")
+                invalid();
+            this.capture = { depth: this.stack.length + 1, parts: [], bytes: 0, kind: frame.graph };
+            this.append(token);
+        }
+        if (token.raw === "{")
+            this.push({ type: "object", state: "keyOrEnd" });
+        else if (token.raw === "[")
+            this.push({ type: "array", state: "valueOrEnd", ...(graph ? { graph } : {}) });
+        else if (token.kind === "string" || token.kind === "number" || token.kind === "literal")
+            this.valueFinished();
+        else
+            invalid();
+        return;
+    }
+    finish() {
+        if (!this.finished || this.stack.length || !this.keys.has("nodes") || !this.keys.has("edges"))
+            invalid();
+    }
+}
+/**
+ * Stream one record array; consume the generator fully to validate the entire export.
+ * Run separate passes for nodes and edges so their order in the export is immaterial.
+ * Optional lower limits are for offline tests, not CLI-configurable budget increases.
+ */
+export async function* readCodeGraphRecords(path, kind, options = {}) {
+    const limits = { ...DEFAULT_LIMITS, ...options };
+    for (const key of ["maxBytes", "maxValueBytes", "maxDepth"]) {
+        if (!Number.isSafeInteger(limits[key]) || limits[key] <= 0 || limits[key] > DEFAULT_LIMITS[key])
+            throw new ExportError("Invalid CodeGraph export reader limits.");
+    }
+    let handle;
+    try {
+        const before = await lstat(path);
+        if (!before.isFile())
+            throw new ExportError("CodeGraph export must be a regular file (symlinks are not allowed). No assessment was sent.");
+        if (before.size > limits.maxBytes)
+            throw new ExportError(`CodeGraph export is ${before.size} bytes; the input limit is ${limits.maxBytes} bytes. No assessment was sent.`);
+        handle = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
+        const initial = await handle.stat();
+        if (!initial.isFile())
+            throw new ExportError("CodeGraph export must be a regular file (symlinks are not allowed). No assessment was sent.");
+        if (initial.size > limits.maxBytes)
+            throw new ExportError(`CodeGraph export is ${initial.size} bytes; the input limit is ${limits.maxBytes} bytes. No assessment was sent.`);
+        if (initial.dev !== before.dev || initial.ino !== before.ino || initial.size !== before.size)
+            throw new ExportError("CodeGraph export changed while opening it. No assessment was sent.");
+        const decoder = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+        const tokenizer = new Tokenizer(limits.maxValueBytes);
+        const parser = new GraphParser(kind, limits.maxValueBytes, limits.maxDepth);
+        const buffer = Buffer.alloc(CHUNK_BYTES);
+        let total = 0;
+        while (true) {
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, null);
+            if (!bytesRead)
+                break;
+            total += bytesRead;
+            if (total > limits.maxBytes)
+                throw new ExportError(`CodeGraph export is at least ${total} bytes; the input limit is ${limits.maxBytes} bytes. No assessment was sent.`);
+            let text;
+            try {
+                text = decoder.decode(buffer.subarray(0, bytesRead), { stream: true });
+            }
+            catch {
+                invalid();
+            }
+            for (const token of tokenizer.write(text)) {
+                const value = parser.accept(token);
+                if (value !== undefined)
+                    yield value;
+            }
+        }
+        try {
+            decoder.decode();
+        }
+        catch {
+            invalid();
+        }
+        for (const token of tokenizer.finish()) {
+            const value = parser.accept(token);
+            if (value !== undefined)
+                yield value;
+        }
+        parser.finish();
+        const final = await handle.stat();
+        if (total !== initial.size || final.size !== initial.size || final.mtimeMs !== initial.mtimeMs || final.ctimeMs !== initial.ctimeMs)
+            throw new ExportError("CodeGraph export changed while reading it. No assessment was sent.");
+    }
+    catch (error) {
+        if (error instanceof ExportError)
+            throw error;
+        throw new ExportError("Unable to read the CodeGraph export safely. No assessment was sent; file details were withheld.");
+    }
+    finally {
+        await handle?.close().catch(() => { });
+    }
+}
+//# sourceMappingURL=code-graph-export.js.map

package/dist/setup/code-graph-export.js.map

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

package/dist/setup/code-graph.d.ts

@@ -0,0 +1,62 @@
+declare const RELATIONS: readonly ["CALLS", "IMPORTS_FROM", "INHERITS", "IMPLEMENTS", "TESTED_BY", "DEPENDS_ON"];
+type Relation = typeof RELATIONS[number];
+export interface CodeGraphEvidence {
+    provider: "code-review-graph";
+    version: string;
+    collectedAt: string;
+    snapshotHash: string;
+    scope: string;
+    coverage: {
+        candidates: number;
+        copied: number;
+        indexed: number;
+        omitted: number;
+        unindexed: number;
+        partial: boolean;
+    };
+    languages: {
+        extension: string;
+        files: number;
+    }[];
+    files: {
+        path: string;
+        symbols: number;
+        maxSymbolLines: number;
+        incoming: number;
+        outgoing: number;
+        testLinks: number;
+    }[];
+    filesOmitted: number;
+    relationships: {
+        kind: Relation;
+        count: number;
+    }[];
+    dependencies: {
+        from: string;
+        to: string;
+        kind: Relation;
+        count: number;
+    }[];
+    dependenciesOmitted: number;
+    warnings: string[];
+}
+export interface CodeGraphRunOptions {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}
+export interface CodeGraphOptions {
+    executable?: string;
+    /** Injectable transport for offline tests; not a CLI option. */
+    run?: (executable: string, args: string[], options: CodeGraphRunOptions) => Promise<string>;
+}
+interface GraphMetadata {
+    version: string;
+    collectedAt: string;
+    snapshotHash: string;
+    candidates: number;
+    partial: boolean;
+}
+/** Only validated file paths and numeric structure leave the collector. No names, docstrings, source or signatures. */
+export declare function summarizeCodeGraph(value: unknown, snapshot: string, paths: string[], metadata: GraphMetadata): CodeGraphEvidence;
+export declare function collectCodeGraph(root: string, files: string[], options?: CodeGraphOptions): Promise<CodeGraphEvidence>;
+export {};