@untangle-code/context-artifacts 0.0.0-stage → 0.1.0

package/dist/adapters/kubernetes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Kubernetes YAML adapter (architecture.md §20: "je Dokument eine
+ * Ressource, apiVersion/kind/name erhalten").
+ *
+ * Each `---`-separated YAML document in the file becomes exactly one
+ * chunk, kind `"kubernetes_resource"`, spanning that document's full line
+ * range — Kubernetes manifests are not sectioned further, since a
+ * Deployment's `spec.template` is meaningless read apart from its
+ * `metadata`. A document whose YAML fails to parse still gets its full raw
+ * span turned into a chunk (kind `"kubernetes_resource_parse_error"`, title
+ * carries the reason) rather than aborting the whole file: one malformed
+ * manifest in a directory of many must not hide the rest (architecture.md
+ * §22.2's cross-repo-search principle, applied at document granularity).
+ */
+import type { ArtifactAdapter } from "@untangle-code/domain";
+import type { SkipLedgerReporter } from "./shared.js";
+export interface KubernetesAdapterOptions {
+    /** Overrides how a real skip-ledger finding surfaces from `chunk()` (default: a stderr warning) — see `coverage.ts`'s `SkipLedgerReporter`. */
+    onSkipLedgerGap?: SkipLedgerReporter;
+}
+export declare function createKubernetesAdapter(options?: KubernetesAdapterOptions): ArtifactAdapter;
+//# sourceMappingURL=kubernetes.d.ts.map

package/dist/adapters/kubernetes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes.d.ts","sourceRoot":"","sources":["../../src/adapters/kubernetes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkClE,MAAM,WAAW,wBAAwB;IACvC,+IAA+I;IAC/I,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,GAAG,eAAe,CAgC/F"}

package/dist/adapters/kubernetes.js

@@ -0,0 +1,56 @@
+import { buildLineIndex } from "../text/line-index.js";
+import { mapGet, parseYamlNode, scalarString, splitYamlDocuments, YamlParseError, } from "../text/yaml-lite.js";
+import { buildChunksReportingSkips, buildDocuments } from "./shared.js";
+const YAML_EXTENSION = /\.ya?ml$/i;
+const COMPOSE_FILENAME = /(^|\/)(docker-)?compose\.ya?ml$/i;
+function kubernetesDrafts(content) {
+    return splitYamlDocuments(content).map((span) => {
+        try {
+            const root = parseYamlNode(span.text);
+            const apiVersion = scalarString(mapGet(root, "apiVersion"));
+            const kind = scalarString(mapGet(root, "kind"));
+            const name = scalarString(mapGet(mapGet(root, "metadata"), "name"));
+            const title = [apiVersion, kind].filter((part) => part !== undefined).join("/") +
+                (name === undefined ? "" : ` ${name}`);
+            return {
+                kind: "kubernetes_resource",
+                startLine: span.startLine,
+                endLine: span.endLine,
+                ...(title.trim().length === 0 ? {} : { title: title.trim() }),
+            };
+        }
+        catch (error) {
+            const reason = error instanceof YamlParseError ? error.message : "unknown parse error";
+            return {
+                kind: "kubernetes_resource_parse_error",
+                startLine: span.startLine,
+                endLine: span.endLine,
+                title: `parse error: ${reason}`,
+            };
+        }
+    });
+}
+export function createKubernetesAdapter(options = {}) {
+    return {
+        supports(type, path) {
+            // "auto" detection only claims .yaml/.yml files that are not a
+            // Compose file (see docker.ts) — every other ambiguous case (a plain
+            // config .yaml, an OpenAPI/AsyncAPI file without a name hint) should
+            // be configured with an explicit `type`, since path alone cannot
+            // disambiguate them (spec.md §19.1's `supports` has no content
+            // access — see README "Entscheidungen").
+            return (type === "kubernetes" ||
+                (type === "auto" && YAML_EXTENSION.test(path) && !COMPOSE_FILENAME.test(path)));
+        },
+        async read(input) {
+            return buildDocuments(input, "kubernetes");
+        },
+        chunk(document) {
+            return buildChunksReportingSkips(document, buildLineIndex(document.content), kubernetesDrafts(document.content), options.onSkipLedgerGap);
+        },
+        links() {
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=kubernetes.js.map

package/dist/adapters/kubernetes.js.map

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

package/dist/adapters/markdown.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Markdown / ADR adapter (architecture.md §20, spec.md §19.2 "semantische
+ * Abschnitte statt fester Zeilenfenster").
+ *
+ * ADRs are not a separate `ContextArtifactType` (spec.md §19.1's type union
+ * has no "adr" literal — an Architecture Decision Record IS a Markdown
+ * document, conventionally with `## Status`/`## Context`/`## Decision`/
+ * `## Consequences` headings) — this one adapter's heading-based sectioning
+ * handles both.
+ *
+ * WP-110: the sectioning itself no longer lives here. It moved verbatim to
+ * `@untangle-code/domain`'s `outlineMarkdown()` so that the SAME partition
+ * also serves ordinary `.md` files through the parser-registry prose adapter
+ * and the prose metrics — before that move, a configured artifact got
+ * breadcrumbed sections while the identical file outside an artifact
+ * configuration got arbitrary line windows. Behaviour here is unchanged; the
+ * implementation is simply no longer duplicated.
+ *
+ * Sectioning (defined on `outlineMarkdown`): each ATX heading (`#` …
+ * `######`, ignored inside fenced code blocks) starts a new chunk that runs
+ * up to the START of the very next heading of ANY level (or EOF) — a flat
+ * partition of the file with no overlap. Each chunk's `title` carries the
+ * breadcrumb (ancestor headings joined by " › ") instead, so the hierarchy
+ * is still fully recoverable even though `content` stays the exact raw slice
+ * — the breadcrumb is never spliced into the preserved raw content
+ * (spec.md §19.2).
+ */
+import type { ArtifactAdapter } from "@untangle-code/domain";
+import type { SkipLedgerReporter } from "./shared.js";
+export interface MarkdownAdapterOptions {
+    /** Overrides how a real skip-ledger finding surfaces from `chunk()` (default: a stderr warning) — see `coverage.ts`'s `SkipLedgerReporter`. */
+    onSkipLedgerGap?: SkipLedgerReporter;
+}
+export declare function createMarkdownAdapter(options?: MarkdownAdapterOptions): ArtifactAdapter;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/adapters/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/adapters/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAmBlE,MAAM,WAAW,sBAAsB;IACrC,+IAA+I;IAC/I,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAyB3F"}

package/dist/adapters/markdown.js

@@ -0,0 +1,36 @@
+import { outlineMarkdown } from "@untangle-code/domain";
+import { buildLineIndex, splitLines } from "../text/line-index.js";
+import { buildChunksReportingSkips, buildDocuments } from "./shared.js";
+const MARKDOWN_EXTENSION = /\.(md|markdown|mdx)$/i;
+function markdownDrafts(lines) {
+    return outlineMarkdown(lines).map((section) => {
+        const draft = {
+            kind: "markdown_section",
+            startLine: section.startLine,
+            endLine: section.endLine,
+        };
+        // Der Vorspann vor der ersten Ueberschrift hat keinen Breadcrumb; ein
+        // leerer `title` waere eine Behauptung ueber eine Ueberschrift, die es
+        // nicht gibt.
+        return section.breadcrumb === "" ? draft : { ...draft, title: section.breadcrumb };
+    });
+}
+export function createMarkdownAdapter(options = {}) {
+    return {
+        supports(type, path) {
+            return type === "markdown" || (type === "auto" && MARKDOWN_EXTENSION.test(path));
+        },
+        async read(input) {
+            return buildDocuments(input, "markdown");
+        },
+        chunk(document) {
+            const { lines } = splitLines(document.content);
+            const index = buildLineIndex(document.content);
+            return buildChunksReportingSkips(document, index, markdownDrafts(lines), options.onSkipLedgerGap);
+        },
+        links() {
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/adapters/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/adapters/markdown.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEnD,SAAS,cAAc,CAAC,KAAe;IACrC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAe;YACxB,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;QACF,sEAAsE;QACtE,uEAAuE;QACvE,cAAc;QACd,OAAO,OAAO,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,UAAU,qBAAqB,CAAC,UAAkC,EAAE;IACxE,OAAO;QACL,QAAQ,CAAC,IAAY,EAAE,IAAY;YACjC,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACnF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAoB;YAC7B,OAAO,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK,CAAC,QAA0B;YAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,yBAAyB,CAC9B,QAAQ,EACR,KAAK,EACL,cAAc,CAAC,KAAK,CAAC,EACrB,OAAO,CAAC,eAAe,CACxB,CAAC;QACJ,CAAC;QAED,KAAK;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/openapi.d.ts

@@ -0,0 +1,21 @@
+/**
+ * OpenAPI adapter (architecture.md §20: "je Operation ein Abschnitt,
+ * Operation-IDs erhalten").
+ *
+ * Parses the document with the package's YAML subset parser
+ * (`text/yaml-lite.ts`) and emits one chunk per `paths.<path>.<method>`
+ * operation, titled with the HTTP method, path and (when present)
+ * `operationId` — never dropped even when absent from the title, since
+ * `content` is always the exact raw YAML block, `operationId` field
+ * included. A malformed document degrades to a single whole-document
+ * `"openapi_parse_error"` chunk (architecture.md §22.2) rather than
+ * throwing — the raw content is still fully preserved in that chunk.
+ */
+import type { ArtifactAdapter } from "@untangle-code/domain";
+import type { SkipLedgerReporter } from "./shared.js";
+export interface OpenApiAdapterOptions {
+    /** Overrides how a real skip-ledger finding surfaces from `chunk()` (default: a stderr warning) — see `coverage.ts`'s `SkipLedgerReporter`. */
+    onSkipLedgerGap?: SkipLedgerReporter;
+}
+export declare function createOpenApiAdapter(options?: OpenApiAdapterOptions): ArtifactAdapter;
+//# sourceMappingURL=openapi.d.ts.map

package/dist/adapters/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/adapters/openapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAyElE,MAAM,WAAW,qBAAqB;IACpC,+IAA+I;IAC/I,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,eAAe,CA+CzF"}

package/dist/adapters/openapi.js

@@ -0,0 +1,101 @@
+import { buildLineIndex } from "../text/line-index.js";
+import { mapGet, parseYamlNode, scalarString, YamlParseError, } from "../text/yaml-lite.js";
+import { buildChunks, buildChunksReportingSkips, buildDocuments, wholeDocumentDraft, } from "./shared.js";
+const OPENAPI_NAME_HINT = /openapi/i;
+const YAML_OR_JSON_EXTENSION = /\.(ya?ml|json)$/i;
+const HTTP_METHODS = ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+function openApiDrafts(root) {
+    if (root === null || root.kind !== "map")
+        return [];
+    const drafts = [];
+    const info = mapGet(root, "info");
+    if (info !== undefined) {
+        const title = scalarString(mapGet(info, "title"));
+        drafts.push({
+            kind: "openapi_info",
+            startLine: info.startLine,
+            endLine: info.endLine,
+            ...(title === undefined ? {} : { title: `info: ${title}` }),
+        });
+    }
+    const paths = mapGet(root, "paths");
+    if (paths !== undefined && paths.kind === "map") {
+        for (const pathEntry of paths.entries) {
+            if (pathEntry.value.kind !== "map")
+                continue;
+            for (const methodEntry of pathEntry.value.entries) {
+                const method = methodEntry.key.toLowerCase();
+                if (!HTTP_METHODS.includes(method))
+                    continue;
+                const operationId = scalarString(mapGet(methodEntry.value, "operationId"));
+                const title = operationId === undefined
+                    ? `${method.toUpperCase()} ${pathEntry.key}`
+                    : `${method.toUpperCase()} ${pathEntry.key} (${operationId})`;
+                drafts.push({
+                    kind: "openapi_operation",
+                    startLine: methodEntry.value.startLine,
+                    endLine: methodEntry.value.endLine,
+                    title,
+                });
+            }
+        }
+    }
+    return drafts;
+}
+function operationIdOf(chunk) {
+    if (chunk.kind !== "openapi_operation" || chunk.title === undefined)
+        return undefined;
+    const match = /\(([^()]+)\)$/.exec(chunk.title);
+    return match?.[1];
+}
+function draftsFor(document) {
+    try {
+        return openApiDrafts(parseYamlNode(document.content));
+    }
+    catch (error) {
+        const reason = error instanceof YamlParseError ? error.message : "unknown parse error";
+        return [
+            wholeDocumentDraft("openapi_parse_error", buildLineIndex(document.content), `parse error: ${reason}`),
+        ];
+    }
+}
+export function createOpenApiAdapter(options = {}) {
+    return {
+        supports(type, path) {
+            return (type === "openapi" ||
+                (type === "auto" && OPENAPI_NAME_HINT.test(path) && YAML_OR_JSON_EXTENSION.test(path)));
+        },
+        async read(input) {
+            return buildDocuments(input, "openapi");
+        },
+        chunk(document) {
+            return buildChunksReportingSkips(document, buildLineIndex(document.content), draftsFor(document), options.onSkipLedgerGap);
+        },
+        /**
+         * Heuristic (architecture.md §20's canonical example): assumes the
+         * common REST-codegen convention that a controller method is named
+         * after the operation's `operationId`. No AST/symbol table is
+         * consulted here — `targetId` stays unset; a later graph-linking stage
+         * resolves `targetName` against real symbols, if any match.
+         */
+        links(document) {
+            const chunks = buildChunks(document, buildLineIndex(document.content), draftsFor(document));
+            const links = [];
+            for (const chunk of chunks) {
+                const operationId = operationIdOf(chunk);
+                if (operationId === undefined)
+                    continue;
+                links.push({
+                    fromChunkId: chunk.chunkId,
+                    targetKind: "symbol",
+                    targetName: operationId,
+                    heuristic: true,
+                    confidence: 0.5,
+                    note: `naming-convention guess: OpenAPI operationId "${operationId}" → a controller method of the same name`,
+                });
+            }
+            return links;
+        },
+    };
+}
+//# sourceMappingURL=openapi.js.map

package/dist/adapters/openapi.js.map

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

package/dist/adapters/protobuf.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Protobuf adapter (architecture.md §20: "Messages, Services, RPCs").
+ *
+ * Brace-depth line scanning (no full grammar needed): a top-level
+ * (depth-0) `message Foo {` or `service Foo {` opens a block that runs to
+ * its matching `}`. Nested `message`s inside another message are part of
+ * the parent's content (not chunked separately — a deliberate scope limit,
+ * see README "Entscheidungen"; their bytes are still fully present in the
+ * parent chunk's content, so nothing is silently dropped). Inside a
+ * `service` block, each `rpc Name(...) returns (...);` additionally gets
+ * its own finer-grained chunk — intentionally OVERLAPPING the enclosing
+ * service chunk's range, so a search hit on one RPC's name returns a tight
+ * chunk while a hit on shared service-level comments/options still returns
+ * full context.
+ *
+ * The brace counter is string/comment-aware (WP-81 review finding: a `{` or
+ * `}` inside a string default value, e.g. `[default = "{"]`, or inside a
+ * `//`/`/* *\/` comment, must never move the depth counter — a naive raw
+ * count desyncs PERMANENTLY on such a line, degrading "runs to EOF" and
+ * silently swallowing every following top-level block). `scanLine` below
+ * carries string/block-comment state across lines through ONE continuous
+ * scan (a single shared `ScanState`, not a fresh one per block) — depth is
+ * tracked exactly once per line, not once in this function and again in a
+ * separate look-ahead, so there is only one source of truth for "are we
+ * inside a string/comment right now" across the whole file.
+ */
+import type { ArtifactAdapter } from "@untangle-code/domain";
+import type { SkipLedgerReporter } from "./shared.js";
+export interface ProtobufAdapterOptions {
+    /** Overrides how a real skip-ledger finding surfaces from `chunk()` (default: a stderr warning) — see `coverage.ts`'s `SkipLedgerReporter`. */
+    onSkipLedgerGap?: SkipLedgerReporter;
+}
+export declare function createProtobufAdapter(options?: ProtobufAdapterOptions): ArtifactAdapter;
+//# sourceMappingURL=protobuf.d.ts.map

package/dist/adapters/protobuf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.d.ts","sourceRoot":"","sources":["../../src/adapters/protobuf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAsC,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAgM1F,MAAM,WAAW,sBAAsB;IACrC,+IAA+I;IAC/I,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,eAAe,CAkD3F"}

package/dist/adapters/protobuf.js

@@ -0,0 +1,221 @@
+import { describeDelimiterImbalances, findDelimiterImbalances } from "../text/delimiter-balance.js";
+import { buildLineIndex, splitLines } from "../text/line-index.js";
+import { buildChunks, buildChunksReportingSkips, buildDocuments } from "./shared.js";
+const PROTO_EXTENSION = /\.proto$/i;
+const MESSAGE_RE = /^\s*message\s+([\w.]+)\s*\{/;
+const SERVICE_RE = /^\s*service\s+([\w.]+)\s*\{/;
+const RPC_RE = /^\s*rpc\s+(\w+)\s*\(/;
+/**
+ * Net brace delta for one line, skipping `'...'`/`"..."` string literals
+ * (with `\`-escapes) and `//`/`/* *\/` comments, so a brace character
+ * inside either never affects depth. `state` is mutated in place for
+ * anything that spans past this line's end (an unterminated string or an
+ * open block comment) — the NEXT call for the following line continues
+ * from exactly that state, which is what makes the counter immune to
+ * per-line resets.
+ */
+function scanLine(line, state) {
+    let delta = 0;
+    for (let i = 0; i < line.length; i += 1) {
+        const c = line[i];
+        const next = line[i + 1];
+        if (state.inBlockComment) {
+            if (c === "*" && next === "/") {
+                state.inBlockComment = false;
+                i += 1;
+            }
+            continue;
+        }
+        if (state.inSingle) {
+            if (c === "\\") {
+                i += 1;
+            }
+            else if (c === "'") {
+                state.inSingle = false;
+            }
+            continue;
+        }
+        if (state.inDouble) {
+            if (c === "\\") {
+                i += 1;
+            }
+            else if (c === '"') {
+                state.inDouble = false;
+            }
+            continue;
+        }
+        if (c === "/" && next === "/") {
+            break; // line comment: rest of the line is never code, and cannot itself open a block comment
+        }
+        if (c === "/" && next === "*") {
+            state.inBlockComment = true;
+            i += 1;
+            continue;
+        }
+        if (c === "'") {
+            state.inSingle = true;
+            continue;
+        }
+        if (c === '"') {
+            state.inDouble = true;
+            continue;
+        }
+        if (c === "{")
+            delta += 1;
+        else if (c === "}")
+            delta -= 1;
+    }
+    return delta;
+}
+/**
+ * Letzte Zeile einer `rpc`-Deklaration.
+ *
+ * Zwei Formen: die Kurzform endet an ihrem `;` (das bei mehrzeiliger
+ * Signatur erst auf einer späteren Zeile steht), die Langform an der
+ * schließenden `}` ihres Optionsrumpfs. WP-118: bisher wurde nur die erste
+ * Form erkannt, also endete `rpc A(X) returns (Y) {` schon an der ersten
+ * `;` IM RUMPF — mitten im Konstrukt, mit fehlender schließender Klammer,
+ * und ohne Ledger-Eintrag, weil die Range des Service-Chunks alles
+ * abdeckte. Der Klammerstand wird deshalb mitgezählt.
+ */
+function findRpcEnd(lines, startIndex, hardLimit) {
+    const state = { inSingle: false, inDouble: false, inBlockComment: false };
+    let depth = 0;
+    for (let i = startIndex; i < hardLimit; i += 1) {
+        const line = lines[i] ?? "";
+        const depthBefore = depth;
+        depth += scanLine(line, state);
+        if (depthBefore > 0 && depth === 0)
+            return i + 1; // Optionsrumpf geschlossen
+        if (depthBefore === 0 && depth === 0 && (line.includes(";") || line.includes("}")))
+            return i + 1;
+    }
+    return hardLimit;
+}
+/** Pushes `pending`'s finished draft (and, for a service, its nested RPC drafts scanned from its now-final range) into `drafts`. */
+function finalizePendingBlock(drafts, lines, pending, endLine) {
+    drafts.push({ kind: pending.kind, startLine: pending.startLine, endLine, title: pending.title });
+    if (pending.kind !== "protobuf_service")
+        return;
+    for (let j = pending.startLine - 1; j < endLine; j += 1) {
+        const rpc = RPC_RE.exec(lines[j] ?? "");
+        if (rpc) {
+            const rpcEnd = findRpcEnd(lines, j, endLine);
+            drafts.push({
+                kind: "protobuf_rpc",
+                startLine: j + 1,
+                endLine: rpcEnd,
+                title: `${pending.title}.${rpc[1]}`,
+            });
+        }
+    }
+}
+function protobufDrafts(lines) {
+    const drafts = [];
+    const state = { inSingle: false, inDouble: false, inBlockComment: false };
+    let depth = 0;
+    let pending;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        if (depth === 0 && pending === undefined) {
+            const message = MESSAGE_RE.exec(line);
+            const service = SERVICE_RE.exec(line);
+            if (message) {
+                pending = { kind: "protobuf_message", title: message[1], startLine: i + 1 };
+            }
+            else if (service) {
+                pending = { kind: "protobuf_service", title: service[1], startLine: i + 1 };
+            }
+        }
+        depth += scanLine(line, state);
+        if (pending !== undefined && depth === 0) {
+            finalizePendingBlock(drafts, lines, pending, i + 1);
+            pending = undefined;
+        }
+    }
+    if (pending !== undefined) {
+        // Unterminated top-level block (malformed source, or a still-open
+        // string/comment at EOF): degrade to "runs to EOF" rather than
+        // dropping it — never silently, see the module doc.
+        finalizePendingBlock(drafts, lines, pending, Math.max(lines.length, pending.startLine));
+    }
+    return drafts;
+}
+/**
+ * Trennzeichen-Konventionen für die Plausibilitätsprüfung (WP-118).
+ * Zeichenketten dürfen keine Zeile überschreiten — ein Anführungszeichen,
+ * das bis zum Zeilenende offen bleibt, ist in Protobuf bereits ein Befund.
+ */
+const PROTOBUF_SCAN_OPTIONS = {
+    quotes: [
+        { open: "'", close: "'", backslashEscapes: true, doubledEscapes: false, spansLines: false },
+        { open: '"', close: '"', backslashEscapes: true, doubledEscapes: false, spansLines: false },
+    ],
+    brackets: [
+        { open: "{", close: "}" },
+        { open: "(", close: ")" },
+        { open: "[", close: "]" },
+    ],
+    lineComments: ["//"],
+    blockComment: { open: "/*", close: "*/" },
+};
+/**
+ * WP-118 (dieselbe Blindstelle wie in `sql.ts`): der Blockzähler dieses
+ * Adapters degradiert einen unabgeschlossenen Top-Level-Block zu „läuft
+ * bis Dateiende". Die Byte-Abdeckung bleibt dabei lückenlos, der Chunk ist
+ * weder leer noch überlappend — der Ledger sah also NICHTS, obwohl der
+ * Blockzähler nachweislich aus dem Tritt geraten war. Ein Fragment mit
+ * offener Klammer, offener Zeichenkette oder offenem Kommentar ist jetzt
+ * ein Befund.
+ */
+const checkProtobufPlausibility = (chunk) => {
+    const imbalances = findDelimiterImbalances(chunk.content, PROTOBUF_SCAN_OPTIONS);
+    return imbalances.length === 0 ? undefined : describeDelimiterImbalances(imbalances);
+};
+function messageName(chunk) {
+    return chunk.kind === "protobuf_service" ? chunk.title : undefined;
+}
+export function createProtobufAdapter(options = {}) {
+    return {
+        supports(type, path) {
+            return type === "protobuf" || (type === "auto" && PROTO_EXTENSION.test(path));
+        },
+        async read(input) {
+            return buildDocuments(input, "protobuf");
+        },
+        chunk(document) {
+            const { lines } = splitLines(document.content);
+            const index = buildLineIndex(document.content);
+            return buildChunksReportingSkips(document, index, protobufDrafts(lines), options.onSkipLedgerGap, checkProtobufPlausibility);
+        },
+        /**
+         * Heuristic (architecture.md §20): a gRPC service `FooService` often
+         * backs a generated/handwritten server symbol named `FooServiceServer`
+         * or `FooServiceImpl`. Both are offered as separate low-confidence
+         * hints — this is a naming guess, not a resolved reference.
+         */
+        links(document) {
+            const { lines } = splitLines(document.content);
+            const index = buildLineIndex(document.content);
+            const chunks = buildChunks(document, index, protobufDrafts(lines));
+            const links = [];
+            for (const chunk of chunks) {
+                const name = messageName(chunk);
+                if (name === undefined)
+                    continue;
+                for (const suffix of ["Server", "Impl"]) {
+                    links.push({
+                        fromChunkId: chunk.chunkId,
+                        targetKind: "symbol",
+                        targetName: `${name}${suffix}`,
+                        heuristic: true,
+                        confidence: 0.3,
+                        note: `naming-convention guess: gRPC service "${name}" → generated/handwritten server symbol`,
+                    });
+                }
+            }
+            return links;
+        },
+    };
+}
+//# sourceMappingURL=protobuf.js.map

package/dist/adapters/protobuf.js.map

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

package/dist/adapters/shared.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Helpers shared by every concrete format adapter in `src/adapters/`.
+ */
+import type { ArtifactChunk, ArtifactDocument, ArtifactInput, ContextArtifactType } from "@untangle-code/domain";
+import { type ChunkPlausibilityCheck, type SkipLedgerReporter } from "../coverage.js";
+import type { LineIndex } from "../text/line-index.js";
+export type { ChunkPlausibilityCheck, SkipLedgerReporter } from "../coverage.js";
+/** Builds one `ArtifactDocument` per file in `input.files` (spec.md §19.2: files AND directories). */
+export declare function buildDocuments(input: ArtifactInput, type: Exclude<ContextArtifactType, "auto">, language?: string): ArtifactDocument[];
+export interface ChunkDraft {
+    kind: string;
+    startLine: number;
+    endLine: number;
+    title?: string;
+    /**
+     * Optional exact byte range, used instead of `rangeForLines(index,
+     * startLine, endLine)` when a draft's true boundary does not land on a
+     * whole-line boundary — e.g. two SQL statements sharing one physical
+     * line, each needing its own non-overlapping byte span within that one
+     * line. `startLine`/`endLine` are still required (and still used for the
+     * chunk's `range.startLine`/`endLine`) so every draft has a human-facing
+     * line reference even when its bytes are sub-line-precise. Omitted by
+     * every adapter that only ever splits on whole lines (the common case).
+     */
+    startByte?: number;
+    endByte?: number;
+}
+/**
+ * Turns line-range drafts into fully-formed `ArtifactChunk`s: computes
+ * `range` (via `index`, or the draft's own `startByte`/`endByte` when
+ * given), byte-exact `content` (a slice of the SAME buffer `index` was
+ * built from — never a re-encoded copy, so content is always byte-identical
+ * to the source, spec.md §19.2), `contentHash`, and a deterministic
+ * `chunkId` (ordinal = position in `drafts`).
+ */
+export declare function buildChunks(document: ArtifactDocument, index: LineIndex, drafts: ChunkDraft[]): ArtifactChunk[];
+/** A single chunk spanning the whole document, used for parse-error degrades and the text fallback's single-window case. */
+export declare function wholeDocumentDraft(kind: string, index: LineIndex, title?: string): ChunkDraft;
+/**
+ * `buildChunks`, plus BUILD_PLAN §12 E4: `buildArtifactSkipLedger()` must
+ * never be a "Bringschuld" (an obligation a caller has to remember) —
+ * every format adapter's `chunk()` calls this instead of `buildChunks`
+ * directly, so a loss becomes visible in the SAME call that produces
+ * chunks, with zero extra action from whoever calls `adapter.chunk()`.
+ *
+ * `checkPlausibility` (optional, WP-118) reicht die formatspezifische
+ * Plausibilitätsprüfung des Adapters an den Ledger durch: ein Fragment,
+ * das MITTEN DURCH ein Konstrukt geschnitten wurde, ist auch dann ein
+ * Befund, wenn die Byte-Abdeckung lückenlos ist. Siehe
+ * `coverage.ts::ChunkPlausibilityCheck` und `text/delimiter-balance.ts`.
+ *
+ * Only entries beyond plain `"whitespace_or_comment"` are reported —
+ * `"unclassified_content"` and `"semantic_loss"` are the two reasons that
+ * indicate a real problem (see coverage.ts's module doc); a benign gap
+ * between two well-formed sections is expected and stays silent here too,
+ * exactly as it does for a caller who inspects the ledger directly.
+ *
+ * `report` defaults to `defaultSkipLedgerReporter` (a single stderr line
+ * per finding) but every `create*Adapter()` factory accepts an
+ * `onSkipLedgerGap` override — inject a real structured logger, a test
+ * spy, or a no-op, without this package depending on any particular
+ * logging implementation.
+ */
+export declare function buildChunksReportingSkips(document: ArtifactDocument, index: LineIndex, drafts: ChunkDraft[], report?: SkipLedgerReporter, checkPlausibility?: ChunkPlausibilityCheck): ArtifactChunk[];
+//# sourceMappingURL=shared.d.ts.map