doc-detective 4.29.0 → 4.30.0

package/dist/lsp/registry.js

@@ -0,0 +1,124 @@
+import { schemas } from "../common/src/schemas/index.js";
+/** Collect the candidate sub-schemas of a schema: itself plus anyOf/oneOf/allOf. */
+export function branchesOf(schema) {
+    if (!schema || typeof schema !== "object")
+        return [];
+    const out = [schema];
+    for (const key of ["anyOf", "oneOf", "allOf"]) {
+        if (Array.isArray(schema[key]))
+            out.push(...schema[key]);
+    }
+    return out;
+}
+/** Dig for a human description across a schema and its immediate branches. */
+export function findDescription(schema) {
+    for (const branch of branchesOf(schema)) {
+        if (typeof branch.description === "string" && branch.description.length > 0) {
+            return branch.description;
+        }
+    }
+    return undefined;
+}
+/** Map a JSON-Schema scalar type onto the snippet-relevant primitive kind. */
+function normalizePrimitive(type) {
+    if (type === "string")
+        return "string";
+    if (type === "number" || type === "integer")
+        return "number";
+    if (type === "boolean")
+        return "boolean";
+    return null;
+}
+/**
+ * The scalar kind a schema (or a branch) accepts in its compact form, or null.
+ * The first primitive type encountered across branches wins.
+ */
+export function primitiveKindOf(schema) {
+    for (const branch of branchesOf(schema)) {
+        const type = branch.type;
+        const types = typeof type === "string" ? [type] : Array.isArray(type) ? type : [];
+        for (const t of types) {
+            const kind = normalizePrimitive(t);
+            if (kind)
+                return kind;
+        }
+    }
+    return null;
+}
+/** Does the schema (or a branch) accept a primitive scalar value? */
+export function acceptsPrimitive(schema) {
+    return primitiveKindOf(schema) !== null;
+}
+/** Merge the `properties` maps found across a schema's object branches. */
+export function collectFields(schema) {
+    const seen = new Map();
+    for (const branch of branchesOf(schema)) {
+        const props = branch.properties;
+        if (!props || typeof props !== "object")
+            continue;
+        for (const [name, propSchema] of Object.entries(props)) {
+            if (name === "$schema" || seen.has(name))
+                continue;
+            seen.set(name, {
+                name,
+                description: findDescription(propSchema),
+                primitiveKind: primitiveKindOf(propSchema),
+                enumValues: extractEnum(propSchema),
+            });
+        }
+    }
+    return [...seen.values()];
+}
+/** Pull an enum list from a schema or its branches, if any. */
+export function extractEnum(schema) {
+    for (const branch of branchesOf(schema)) {
+        if (Array.isArray(branch.enum))
+            return branch.enum.slice();
+    }
+    return undefined;
+}
+/**
+ * The `allOf` element of a `step_v3` anyOf branch that carries the action: the
+ * one whose `required` names exactly the action key (never `$schema`).
+ */
+function actionPartOf(branch) {
+    const parts = Array.isArray(branch.allOf) ? branch.allOf : [branch];
+    return parts.find((p) => Array.isArray(p.required) &&
+        p.required.length === 1 &&
+        p.required[0] !== "$schema");
+}
+/**
+ * Build the action registry from the live `step_v3` schema. Derived at runtime
+ * (not a build step) so a new action added to the schemas automatically appears
+ * in completion/hover — the anti-drift test pins that guarantee.
+ */
+export function buildRegistry(step = schemas["step_v3"]) {
+    const actions = [];
+    for (const branch of step.anyOf || []) {
+        const part = actionPartOf(branch);
+        /* c8 ignore next - every step_v3 anyOf branch has an action part; defensive */
+        if (!part)
+            continue;
+        const key = part.required[0];
+        const propSchema = part.properties?.[key];
+        const primitiveKind = primitiveKindOf(propSchema);
+        actions.push({
+            key,
+            title: part.title || key,
+            description: findDescription(propSchema),
+            acceptsPrimitive: primitiveKind !== null,
+            primitiveKind,
+            fields: collectFields(propSchema),
+        });
+    }
+    const byKey = new Map(actions.map((a) => [a.key, a]));
+    return { actions, byKey };
+}
+/** Lazily-built shared registry (the schemas are static within a process). */
+let cached;
+export function getRegistry() {
+    if (!cached)
+        cached = buildRegistry();
+    return cached;
+}
+//# sourceMappingURL=registry.js.map

package/dist/lsp/registry.js.map

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

package/dist/lsp/server.d.ts

@@ -0,0 +1,40 @@
+import { type InitializeResult } from "vscode-languageserver/node.js";
+import type { CompletionItem, CompletionParams, Hover, HoverParams } from "vscode-languageserver";
+import { TextDocument } from "vscode-languageserver-textdocument";
+/**
+ * The subset of a `Connection` the handlers touch. Narrowed to an interface so
+ * tests can drive the wiring with a fake instead of a live stdio transport.
+ */
+export interface DiagnosticsConnection {
+    onInitialize(handler: () => InitializeResult): void;
+    sendDiagnostics(params: {
+        uri: string;
+        diagnostics: unknown[];
+    }): void;
+    onCompletion(handler: (params: CompletionParams) => CompletionItem[]): void;
+    onHover(handler: (params: HoverParams) => Hover | null): void;
+}
+/**
+ * The subset of a `TextDocuments` manager the handlers subscribe to.
+ */
+export interface DocumentEvents {
+    onDidChangeContent(handler: (event: {
+        document: TextDocument;
+    }) => void): void;
+    onDidClose(handler: (event: {
+        document: TextDocument;
+    }) => void): void;
+    get(uri: string): TextDocument | undefined;
+}
+/**
+ * Wire language-server behavior onto a connection + document manager. Pure of
+ * any transport, so a unit test can pass fakes, capture the registered
+ * callbacks, and assert what gets published — no real process required.
+ */
+export declare function registerHandlers(connection: DiagnosticsConnection, documents: DocumentEvents): void;
+/**
+ * Boot the language server over stdio. Called by the `doc-detective lsp`
+ * subcommand.
+ */
+export declare function startServer(): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/lsp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/lsp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,KAAK,EACL,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAKlE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,OAAO,EAAE,MAAM,gBAAgB,GAAG,IAAI,CAAC;IACpD,eAAe,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,YAAY,CACV,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,cAAc,EAAE,GACtD,IAAI,CAAC;IACR,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,qBAAqB,EACjC,SAAS,EAAE,cAAc,GACxB,IAAI,CAsCN;AAKD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAclC"}

package/dist/lsp/server.js

@@ -0,0 +1,64 @@
+import { createConnection, TextDocuments, ProposedFeatures, StreamMessageReader, StreamMessageWriter, TextDocumentSyncKind, } from "vscode-languageserver/node.js";
+import { TextDocument } from "vscode-languageserver-textdocument";
+import { computeDiagnostics } from "./diagnostics.js";
+import { computeCompletions } from "./completion.js";
+import { computeHover } from "./hover.js";
+/**
+ * Wire language-server behavior onto a connection + document manager. Pure of
+ * any transport, so a unit test can pass fakes, capture the registered
+ * callbacks, and assert what gets published — no real process required.
+ */
+export function registerHandlers(connection, documents) {
+    connection.onInitialize(() => ({
+        capabilities: {
+            // Full sync keeps Phase 1 simple; jsonc-parser reparses the whole buffer
+            // on each change anyway, so incremental patching buys nothing yet.
+            textDocumentSync: TextDocumentSyncKind.Full,
+            completionProvider: { triggerCharacters: ['"', "{"] },
+            hoverProvider: true,
+        },
+    }));
+    const publish = (document) => {
+        connection.sendDiagnostics({
+            uri: document.uri,
+            diagnostics: computeDiagnostics(document),
+        });
+    };
+    // Fires on open and on every edit — the single hook we need for live
+    // diagnostics.
+    documents.onDidChangeContent((event) => publish(event.document));
+    // Clear diagnostics when a document closes so stale squiggles don't linger.
+    documents.onDidClose((event) => connection.sendDiagnostics({ uri: event.document.uri, diagnostics: [] }));
+    connection.onCompletion((params) => {
+        const document = documents.get(params.textDocument.uri);
+        if (!document)
+            return [];
+        return computeCompletions(document, params.position);
+    });
+    connection.onHover((params) => {
+        const document = documents.get(params.textDocument.uri);
+        if (!document)
+            return null;
+        return computeHover(document, params.position);
+    });
+}
+/* c8 ignore start - real stdio bootstrap: no injectable seam; the pure wiring
+   in registerHandlers is unit-tested, and the whole server is exercised
+   end-to-end by the spawned protocol test. */
+/**
+ * Boot the language server over stdio. Called by the `doc-detective lsp`
+ * subcommand.
+ */
+export function startServer() {
+    // Explicit stdio streams so the server works no matter how it's launched —
+    // the `doc-detective lsp` subcommand OR the bare `doc-detective-lsp` bin.
+    // (createConnection(ProposedFeatures.all) alone sniffs argv for `--stdio`,
+    // which the bare bin doesn't pass.)
+    const connection = createConnection(ProposedFeatures.all, new StreamMessageReader(process.stdin), new StreamMessageWriter(process.stdout));
+    const documents = new TextDocuments(TextDocument);
+    registerHandlers(connection, documents);
+    documents.listen(connection);
+    connection.listen();
+}
+/* c8 ignore stop */
+//# sourceMappingURL=server.js.map

package/dist/lsp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/lsp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwB1C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAiC,EACjC,SAAyB;IAEzB,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7B,YAAY,EAAE;YACZ,yEAAyE;YACzE,mEAAmE;YACnE,gBAAgB,EAAE,oBAAoB,CAAC,IAAI;YAC3C,kBAAkB,EAAE,EAAE,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;YACrD,aAAa,EAAE,IAAI;SACpB;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAG,CAAC,QAAsB,EAAE,EAAE;QACzC,UAAU,CAAC,eAAe,CAAC;YACzB,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,WAAW,EAAE,kBAAkB,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,qEAAqE;IACrE,eAAe;IACf,SAAS,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjE,4EAA4E;IAC5E,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7B,UAAU,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CACzE,CAAC;IAEF,UAAU,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;8CAE8C;AAC9C;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,2EAA2E;IAC3E,0EAA0E;IAC1E,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,UAAU,GAAe,gBAAgB,CAC7C,gBAAgB,CAAC,GAAG,EACpB,IAAI,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,EACtC,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CACxC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IAClD,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACxC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7B,UAAU,CAAC,MAAM,EAAE,CAAC;AACtB,CAAC;AACD,oBAAoB"}

package/dist/lsp/yaml/positions.d.ts

@@ -0,0 +1,32 @@
+import YAML from "yaml";
+import type { OffsetRange, ActionKeyedStep } from "../json/positions.js";
+/** Result of parsing YAML: the document (for node lookups) plus its value. */
+export interface YamlParse {
+    doc: YAML.Document.Parsed;
+    value: any;
+    /** Set when `doc.toJS()` threw (e.g. an alias-bomb exceeding maxAliasCount). */
+    valueError?: string;
+}
+/** Parse YAML into a position-preserving document plus its plain JS value. */
+export declare function parseYamlTree(text: string): YamlParse;
+/** A YAML syntax error reduced to an offset span and message. */
+export interface YamlSyntaxError {
+    range: OffsetRange;
+    message: string;
+}
+/** Collect YAML syntax errors as offset spans (empty when the doc is clean). */
+export declare function yamlSyntaxErrors(doc: YAML.Document.Parsed): YamlSyntaxError[];
+/**
+ * Resolve the source span for an AJV `instancePath` in a YAML document. Walks
+ * up to the nearest present ancestor (like the JSON resolver) so a
+ * `required`-style error still anchors somewhere. Returns null only when even
+ * the document contents can't be located.
+ */
+export declare function rangeForInstancePathYaml(doc: YAML.Document.Parsed, instancePath: string): OffsetRange | null;
+/**
+ * Find every step written as a map carrying an `action` key inside a `steps`
+ * sequence — the YAML twin of the JSON detector. Returns the offending `action`
+ * key span and the step's JSON-Pointer.
+ */
+export declare function findActionKeyedStepsYaml(doc: YAML.Document.Parsed): ActionKeyedStep[];
+//# sourceMappingURL=positions.d.ts.map

package/dist/lsp/yaml/positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.d.ts","sourceRoot":"","sources":["../../../src/lsp/yaml/positions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGzE,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,GAAG,CAAC;IACX,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAarD;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,eAAe,EAAE,CAK7E;AASD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EACzB,YAAY,EAAE,MAAM,GACnB,WAAW,GAAG,IAAI,CAUpB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GACxB,eAAe,EAAE,CAqCnB"}

package/dist/lsp/yaml/positions.js

@@ -0,0 +1,92 @@
+import YAML from "yaml";
+import { instancePathToSegments, pointerFromPath } from "../json/positions.js";
+/** Parse YAML into a position-preserving document plus its plain JS value. */
+export function parseYamlTree(text) {
+    const doc = YAML.parseDocument(text, { keepSourceTokens: true });
+    // `toJS()` resolves aliases and can throw on a pathological document (the
+    // "billion laughs" alias bomb the yaml lib guards with maxAliasCount). Catch
+    // it so a malicious/degenerate buffer can't crash the server — surface it as
+    // a document-level error instead.
+    try {
+        return { doc, value: doc.toJS() };
+    }
+    catch (error) {
+        /* c8 ignore next - the yaml lib always throws an Error with a message; the String() fallback guards a hypothetical non-Error throw */
+        const message = error instanceof Error ? error.message : String(error);
+        return { doc, value: undefined, valueError: message };
+    }
+}
+/** Collect YAML syntax errors as offset spans (empty when the doc is clean). */
+export function yamlSyntaxErrors(doc) {
+    return doc.errors.map((error) => {
+        const [start, end] = error.pos;
+        return { range: { start, end }, message: error.message };
+    });
+}
+/** Node range → OffsetRange, using [start, valueEnd] for a tight span. */
+function nodeRange(node) {
+    const range = node?.range;
+    if (!Array.isArray(range))
+        return null;
+    return { start: range[0], end: range[1] };
+}
+/**
+ * Resolve the source span for an AJV `instancePath` in a YAML document. Walks
+ * up to the nearest present ancestor (like the JSON resolver) so a
+ * `required`-style error still anchors somewhere. Returns null only when even
+ * the document contents can't be located.
+ */
+export function rangeForInstancePathYaml(doc, instancePath) {
+    const segments = instancePathToSegments(instancePath);
+    for (let end = segments.length; end >= 0; end--) {
+        const node = end === 0 ? doc.contents : doc.getIn(segments.slice(0, end), true);
+        const range = nodeRange(node);
+        if (range)
+            return range;
+    }
+    // Reached only for an empty document (no contents node has a range).
+    return null;
+}
+/**
+ * Find every step written as a map carrying an `action` key inside a `steps`
+ * sequence — the YAML twin of the JSON detector. Returns the offending `action`
+ * key span and the step's JSON-Pointer.
+ */
+export function findActionKeyedStepsYaml(doc) {
+    const found = [];
+    const visit = (node, path) => {
+        if (YAML.isMap(node)) {
+            for (const pair of node.items) {
+                const key = pair.key?.value;
+                if (key === "steps" && YAML.isSeq(pair.value)) {
+                    collectSteps(pair.value, [...path, "steps"]);
+                }
+                if (pair.value)
+                    visit(pair.value, [...path, key]);
+            }
+        }
+        else if (YAML.isSeq(node)) {
+            node.items.forEach((item, index) => visit(item, [...path, index]));
+        }
+    };
+    const collectSteps = (seq, seqPath) => {
+        seq.items.forEach((item, index) => {
+            if (!YAML.isMap(item))
+                return;
+            const actionPair = item.items.find((p) => p.key?.value === "action");
+            if (actionPair) {
+                const range = nodeRange(actionPair.key);
+                if (range) {
+                    found.push({
+                        keyRange: range,
+                        pointer: pointerFromPath([...seqPath, index]),
+                    });
+                }
+            }
+        });
+    };
+    if (doc.contents)
+        visit(doc.contents, []);
+    return found;
+}
+//# sourceMappingURL=positions.js.map

package/dist/lsp/yaml/positions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positions.js","sourceRoot":"","sources":["../../../src/lsp/yaml/positions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAU/E,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,0EAA0E;IAC1E,6EAA6E;IAC7E,6EAA6E;IAC7E,kCAAkC;IAClC,IAAI,CAAC;QACH,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,sIAAsI;QACtI,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACxD,CAAC;AACH,CAAC;AAQD,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,GAAyB;IACxD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,SAAS,SAAS,CAAC,IAAS;IAC1B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAyB,EACzB,YAAoB;IAEpB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACtD,KAAK,IAAI,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,GACR,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,qEAAqE;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAyB;IAEzB,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAG,CAAC,IAAS,EAAE,IAA4B,EAAQ,EAAE;QAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAc,EAAE,CAAC;gBACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;gBAC5B,IAAI,GAAG,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9C,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC/C,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,KAAa,EAAE,EAAE,CAC9C,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,GAAQ,EAAE,OAA+B,EAAQ,EAAE;QACvE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,KAAa,EAAE,EAAE;YAC7C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC;YAC1E,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,KAAK,EAAE,CAAC;oBACV,KAAK,CAAC,IAAI,CAAC;wBACT,QAAQ,EAAE,KAAK;wBACf,OAAO,EAAE,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,CAAC;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,GAAG,CAAC,QAAQ;QAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,cAAc,EACd,GAAG,EACH,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,CAAC;AASF,iBAAS,gBAAgB,IAAI,OAAO,CAKnC;AAQD,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,GAAQ,GAAG,OAAO,CAMjE;AAED,iBAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,GAAE,MAAe,EAAE,MAAM,GAAE,GAAQ,QASlE;AAMD,iBAAS,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAiGlC;AAGD,iBAAS,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAG/B;AAGD,iBAAe,uBAAuB,CAAC,MAAM,GAAE,GAAQ;;;UAyEtD;AA8CD,iBAAe,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAAE,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,gBAwM7E;AAgCD,QAAA,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAilBzG,CAAC;AAGF,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAM5D;AAED,iBAAe,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,iBA8DpF;AAED,iBAAe,aAAa,CAAC,MAAM,EAAE,GAAG,YAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,kBA0D9F;AAGD,iBAAe,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE;;;;GAwCvD;AAED,iBAAS,OAAO,SAuBf;AAGD,iBAAS,cAAc,QA+GtB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EACT,aAAa,EACb,YAAY,EACZ,OAAO,EACP,cAAc,EACd,GAAG,EACH,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACjB,CAAC;AASF,iBAAS,gBAAgB,IAAI,OAAO,CAKnC;AAQD,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,GAAQ,GAAG,OAAO,CAMjE;AAED,iBAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,GAAE,MAAe,EAAE,MAAM,GAAE,GAAQ,QASlE;AAMD,iBAAS,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAiGlC;AAGD,iBAAS,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAG/B;AAGD,iBAAe,uBAAuB,CAAC,MAAM,GAAE,GAAQ;;;UAyEtD;AA8CD,iBAAe,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAAE,UAAU,CAAC,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,gBAwM7E;AAgCD,QAAA,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CA+lBzG,CAAC;AAGF,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAM5D;AAED,iBAAe,aAAa,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,iBA4DpF;AAED,iBAAe,aAAa,CAAC,MAAM,EAAE,GAAG,YAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,kBA0E9F;AAGD,iBAAe,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE;;;;GAwCvD;AAED,iBAAS,OAAO,SAuBf;AAGD,iBAAS,cAAc,QA+GtB"}

package/dist/utils.js

@@ -454,7 +454,12 @@ const reporters = {
         const outputExtensions = [".json"];
         // Normalize output path
         outputPath = path.resolve(outputPath);
-        const data = JSON.stringify(results, null, 2);
+        // Reuse the results JSON serialized once by outputResults when present
+        // (byte-identical to serializing `results` here); fall back for direct
+        // callers that don't pass it.
+        const data = typeof options.resultsJson === "string"
+            ? options.resultsJson
+            : JSON.stringify(results, null, 2);
         let outputFile = "";
         let outputDir = "";
         let reportType = "doc-detective-results";
@@ -564,10 +569,17 @@ const reporters = {
                 // The run folder name IS the runId under the `runs/<id>` layout.
                 runId: path.basename(runDir),
             };
+        // When we archive the unmodified `results` (stamped-runDir case), reuse the
+        // JSON outputResults already serialized. When we rewrote runId/runDir into a
+        // fresh copy, that object differs from `results`, so serialize it directly —
+        // keeping the written file byte-identical to before this optimization.
+        const persistedJson = useStampedRunDir && typeof options.resultsJson === "string"
+            ? options.resultsJson
+            : JSON.stringify(persistedResults, null, 2);
         const outputFile = path.resolve(runDir, `${reportType}.json`);
         try {
             fs.mkdirSync(runDir, { recursive: true });
-            fs.writeFileSync(outputFile, JSON.stringify(persistedResults, null, 2));
+            fs.writeFileSync(outputFile, persistedJson);
             // Archive a human-readable HTML report beside the JSON, so the run folder
             // is a complete shareable artifact without the standalone `html` reporter.
             // Best-effort and isolated: an HTML failure must not break the JSON
@@ -978,7 +990,6 @@ async function reportResults({ apiConfig, results }) {
     try {
         const url = `${apiConfig.url}/contexts`;
         const payload = { contexts };
-        console.log(payload);
         const response = await axios.post(url, payload, {
             headers: {
                 "x-runner-token": apiConfig.token,
@@ -1021,15 +1032,29 @@ async function outputResults(config = {}, outputPath, results, options = {}) {
             return reporter;
         });
     }
+    // Serialize the canonical results tree ONCE and share the string with the
+    // JSON-writing reporters (json + runFolder) instead of each calling
+    // JSON.stringify on the full tree independently. Only computed when a
+    // JSON-writing reporter is actually active, so a terminal-only run pays
+    // nothing. Each reporter still falls back to serializing itself when the
+    // shared string is absent (so they stay correct if called directly), and
+    // runFolder only reuses it when it archives the unmodified `results` (the
+    // stamped-runDir case) — a rewritten runId/runDir copy is serialized fresh,
+    // keeping every written file byte-identical to before.
+    const writesJson = activeReporters.includes("jsonReporter") ||
+        activeReporters.includes("runFolderReporter");
+    const reporterOptions = writesJson
+        ? { ...options, resultsJson: JSON.stringify(results, null, 2) }
+        : options;
     // Execute each reporter
     const reporterPromises = activeReporters.map((reporter) => {
         if (typeof reporter === "function") {
             // Direct function reference
-            return reporter(config, outputPath, results, options);
+            return reporter(config, outputPath, results, reporterOptions);
         }
         else if (typeof reporter === "string" && reporters[reporter]) {
             // String reference to built-in or registered reporter
-            return reporters[reporter](config, outputPath, results, options);
+            return reporters[reporter](config, outputPath, results, reporterOptions);
         }
         else if (typeof reporter === "string" && !reporters[reporter]) {
             console.error(`Reporter "${reporter}" not found. Available reporters: ${Object.keys(reporters).join(", ")}`);