@opencodehub/ingestion 0.1.0

package/dist/pipeline/phases/summarize.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Summarize phase — emit structured LLM summaries for callable symbols.
+ *
+ * This is the first hop of the SACL-style two-lane retrieval stack. Every
+ * Function / Method / Class that the LSP oracle has independently confirmed
+ * gets a Zod 4-validated `SymbolSummary` generated by `@opencodehub/summarizer`
+ * (Bedrock Haiku 4.5 via Converse + tool_use). The summaries live in a
+ * separate `symbol_summaries` storage table; they never participate in the
+ * graph edge set.
+ *
+ * The phase is gated four ways, in strict precedence:
+ *   1. `opts.offline === true` → skip with `skippedReason: "offline"`. The
+ *      offline invariant is non-negotiable; no summarizer call path may
+ *      execute when offline is set.
+ *   2. `opts.summaries !== true` → skip with `skippedReason: "not-enabled"`.
+ *      The flag defaults off so re-index runs stay free until the operator
+ *      explicitly opts in.
+ *   3. Trust filter — a symbol is summarized only when at least one edge
+ *      incident on it is SCIP-confirmed (confidence 1.0 and
+ *      `reason` starts with an {@link SCIP_PROVENANCE_PREFIXES} entry). This
+ *      cuts noise from tree-sitter-only resolution where the symbol's
+ *      existence is uncertain.
+ *   4. Cost cap — `maxSummariesPerRun` bounds how many Bedrock calls we
+ *      actually issue. `maxSummariesPerRun = 0` (the default) runs the
+ *      phase in dry-run mode: we record how many symbols WOULD have been
+ *      summarized, but never contact Bedrock. Session A ships in this
+ *      mode so the operator can inspect the counter before spending
+ *      anything on Session B.
+ *
+ * The LSP phases run upstream, so by the time we get here every high-
+ * confidence edge carries its `scip:scip-python@…` / `scip:scip-typescript@…`
+ * / `scip:scip-go@…` / `scip:rust-analyzer@…` provenance. The trust filter reads that
+ * directly off `ctx.graph`.
+ *
+ * Cache semantics:
+ *   - Content hash = sha256 hex of the UTF-8 bytes of the symbol's source
+ *     span `[startLine, endLine]`. A whitespace-only edit to a different
+ *     symbol leaves the target symbol's hash stable → cache hit.
+ *   - The cache key is `(nodeId, contentHash, promptVersion)`. Bumping
+ *     `SUMMARIZER_PROMPT_VERSION` invalidates prior rows without deleting
+ *     them; multiple prompt versions can coexist during rollout.
+ *   - Cache hits are counted but do NOT re-enter the output `rows` array
+ *     — the CLI only persists freshly produced rows. The prior row is
+ *     already on disk.
+ *
+ * Provenance:
+ *   - The phase never emits graph edges.
+ *   - The phase never mutates graph nodes (no summary text stored inline).
+ *   - All output is side-channel, keyed by node id.
+ */
+import type { SymbolSummaryRow } from "@opencodehub/storage";
+import { type SummarizeInput, type SummarizerResult } from "@opencodehub/summarizer";
+import type { PipelinePhase } from "../types.js";
+export declare const SUMMARIZE_PHASE_NAME: "summarize";
+export interface SummarizePhaseOutput {
+    /** `true` when the phase actually considered symbols for summarization. */
+    readonly enabled: boolean;
+    /** Populated when `enabled=false`; a human-readable hint for logs. */
+    readonly skippedReason?: string;
+    /** Prompt version that gated the cache key for this run. */
+    readonly promptVersion: string;
+    /** Model id that WOULD (or did) be invoked — resolved for diagnostics. */
+    readonly modelId: string;
+    /** Symbols walked after kind filtering. */
+    readonly considered: number;
+    /** Symbols dropped by the LSP trust filter. */
+    readonly skippedUnconfirmed: number;
+    /** Symbols whose cached summary already covered the content hash. */
+    readonly cacheHits: number;
+    /**
+     * Symbols eligible but dropped by the cost cap (dry-run or when the
+     * batch exceeds `maxSummariesPerRun`).
+     */
+    readonly wouldHaveSummarized: number;
+    /** Bedrock calls that returned a validated summary. */
+    readonly summarized: number;
+    /** Bedrock calls that threw (retry loop exhausted or transport error). */
+    readonly failed: number;
+    /** Fresh rows the CLI will persist via `store.bulkLoadSymbolSummaries`. */
+    readonly rows: readonly SymbolSummaryRow[];
+    readonly durationMs: number;
+}
+/**
+ * Shape the phase uses to talk to the summarizer. Narrower than the full
+ * Bedrock client so tests can substitute a fake without instantiating
+ * `@aws-sdk/client-bedrock-runtime`. The production path wraps
+ * {@link summarizeSymbol} against a real `BedrockRuntimeClient`.
+ */
+export interface SummarizerAdapter {
+    summarize(input: SummarizeInput): Promise<SummarizerResult>;
+}
+export interface SummarizePhaseTestHooks {
+    /**
+     * Override the summarizer adapter. When provided, the phase uses this
+     * instead of instantiating a real Bedrock client. Tests MUST set this
+     * so Bedrock is never contacted.
+     */
+    readonly summarizerFactory?: (opts: {
+        readonly modelId: string;
+    }) => SummarizerAdapter;
+    /** Override the source-text reader (test-only). */
+    readonly sourceReader?: (absPath: string) => string;
+    /** Override the clock so `createdAt` is deterministic in tests. */
+    readonly now?: () => Date;
+}
+export declare function __setSummarizePhaseTestHooks__(hooks: SummarizePhaseTestHooks | undefined): void;
+export declare const summarizePhase: PipelinePhase<SummarizePhaseOutput>;
+/**
+ * Lightweight cache adapter a caller can plug onto `ctx.options` to let the
+ * phase probe existing summaries before emitting work. The `summarize`
+ * phase has no direct `IGraphStore` handle — phases are pure over
+ * `PipelineContext` — so we expose a narrow hook (`__summaryCache`) the
+ * CLI fills before invoking `runIngestion`. Tests plug in a fake
+ * adapter; production may or may not depending on how aggressive the
+ * operator wants cache hits to be.
+ */
+export interface SummaryCacheAdapter {
+    lookup(nodeId: string, contentHash: string, promptVersion: string): Promise<SymbolSummaryRow | undefined>;
+}
+/**
+ * Options-bag extension point. Callers attach the cache adapter via a
+ * non-enumerable-looking well-known key so existing snapshot tests that
+ * assert on option shape don't break.
+ */
+export declare const SUMMARY_CACHE_OPTIONS_KEY: "__summaryCache";
+//# sourceMappingURL=summarize.d.ts.map

package/dist/pipeline/phases/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phases/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAGlE,eAAO,MAAM,oBAAoB,EAAG,WAAoB,CAAC;AAKzD,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,iBAAiB,CAAC;IACvF,mDAAmD;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAGD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAE/F;AAED,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,oBAAoB,CAU9D,CAAC;AA+UF;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAG,gBAAyB,CAAC"}

package/dist/pipeline/phases/summarize.js

@@ -0,0 +1,401 @@
+/**
+ * Summarize phase — emit structured LLM summaries for callable symbols.
+ *
+ * This is the first hop of the SACL-style two-lane retrieval stack. Every
+ * Function / Method / Class that the LSP oracle has independently confirmed
+ * gets a Zod 4-validated `SymbolSummary` generated by `@opencodehub/summarizer`
+ * (Bedrock Haiku 4.5 via Converse + tool_use). The summaries live in a
+ * separate `symbol_summaries` storage table; they never participate in the
+ * graph edge set.
+ *
+ * The phase is gated four ways, in strict precedence:
+ *   1. `opts.offline === true` → skip with `skippedReason: "offline"`. The
+ *      offline invariant is non-negotiable; no summarizer call path may
+ *      execute when offline is set.
+ *   2. `opts.summaries !== true` → skip with `skippedReason: "not-enabled"`.
+ *      The flag defaults off so re-index runs stay free until the operator
+ *      explicitly opts in.
+ *   3. Trust filter — a symbol is summarized only when at least one edge
+ *      incident on it is SCIP-confirmed (confidence 1.0 and
+ *      `reason` starts with an {@link SCIP_PROVENANCE_PREFIXES} entry). This
+ *      cuts noise from tree-sitter-only resolution where the symbol's
+ *      existence is uncertain.
+ *   4. Cost cap — `maxSummariesPerRun` bounds how many Bedrock calls we
+ *      actually issue. `maxSummariesPerRun = 0` (the default) runs the
+ *      phase in dry-run mode: we record how many symbols WOULD have been
+ *      summarized, but never contact Bedrock. Session A ships in this
+ *      mode so the operator can inspect the counter before spending
+ *      anything on Session B.
+ *
+ * The LSP phases run upstream, so by the time we get here every high-
+ * confidence edge carries its `scip:scip-python@…` / `scip:scip-typescript@…`
+ * / `scip:scip-go@…` / `scip:rust-analyzer@…` provenance. The trust filter reads that
+ * directly off `ctx.graph`.
+ *
+ * Cache semantics:
+ *   - Content hash = sha256 hex of the UTF-8 bytes of the symbol's source
+ *     span `[startLine, endLine]`. A whitespace-only edit to a different
+ *     symbol leaves the target symbol's hash stable → cache hit.
+ *   - The cache key is `(nodeId, contentHash, promptVersion)`. Bumping
+ *     `SUMMARIZER_PROMPT_VERSION` invalidates prior rows without deleting
+ *     them; multiple prompt versions can coexist during rollout.
+ *   - Cache hits are counted but do NOT re-enter the output `rows` array
+ *     — the CLI only persists freshly produced rows. The prior row is
+ *     already on disk.
+ *
+ * Provenance:
+ *   - The phase never emits graph edges.
+ *   - The phase never mutates graph nodes (no summary text stored inline).
+ *   - All output is side-channel, keyed by node id.
+ */
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { SCIP_PROVENANCE_PREFIXES } from "@opencodehub/core-types";
+import { DEFAULT_MODEL_ID, SUMMARIZER_PROMPT_VERSION, } from "@opencodehub/summarizer";
+import { CONFIDENCE_DEMOTE_PHASE_NAME } from "./confidence-demote.js";
+export const SUMMARIZE_PHASE_NAME = "summarize";
+const LSP_CONFIDENCE = 1.0;
+const SUMMARIZABLE_KINDS = new Set(["Function", "Method", "Class"]);
+let testHooks;
+export function __setSummarizePhaseTestHooks__(hooks) {
+    testHooks = hooks;
+}
+export const summarizePhase = {
+    name: SUMMARIZE_PHASE_NAME,
+    // Depend on confidence-demote so every LSP phase (and the demotion pass)
+    // has finished before we inspect edge provenance. The dep graph guarantees
+    // all four lsp-* phases ran upstream, so trust filtering sees the final
+    // confidence scores.
+    deps: [CONFIDENCE_DEMOTE_PHASE_NAME],
+    async run(ctx) {
+        return runSummarize(ctx);
+    },
+};
+async function runSummarize(ctx) {
+    const start = Date.now();
+    // Accept `summaryModel` via the options bag — the CLI surface threads
+    // `--summary-model <id>` through `PipelineOptions.summaryModel`. A string
+    // override replaces the compile-time default; anything else falls back to
+    // `DEFAULT_MODEL_ID` so production deployments stay pinned.
+    const summaryModelOpt = ctx.options.summaryModel;
+    const modelId = typeof summaryModelOpt === "string" && summaryModelOpt.length > 0
+        ? summaryModelOpt
+        : DEFAULT_MODEL_ID;
+    const promptVersion = SUMMARIZER_PROMPT_VERSION;
+    // ---- Offline gate (INVARIANT) ----------------------------------------
+    if (ctx.options.offline === true) {
+        return emptyOutput(start, {
+            skippedReason: "offline",
+            promptVersion,
+            modelId,
+        });
+    }
+    // ---- Feature flag gate -----------------------------------------------
+    if (ctx.options.summaries !== true) {
+        return emptyOutput(start, {
+            skippedReason: "not-enabled",
+            promptVersion,
+            modelId,
+        });
+    }
+    // ---- Walk candidates --------------------------------------------------
+    // Build per-node inbound/outbound incidence sets so we can apply the LSP
+    // trust filter in O(|edges| + |nodes|) rather than O(|edges| × |nodes|).
+    const lspConfirmedNodes = new Set();
+    for (const edge of ctx.graph.edges()) {
+        if (edge.confidence < LSP_CONFIDENCE)
+            continue;
+        if (!isLspReason(edge.reason))
+            continue;
+        lspConfirmedNodes.add(edge.from);
+        lspConfirmedNodes.add(edge.to);
+    }
+    let considered = 0;
+    let skippedUnconfirmed = 0;
+    const candidates = [];
+    for (const node of ctx.graph.nodes()) {
+        if (!SUMMARIZABLE_KINDS.has(node.kind))
+            continue;
+        considered += 1;
+        if (!lspConfirmedNodes.has(node.id)) {
+            skippedUnconfirmed += 1;
+            continue;
+        }
+        const startLine = node.startLine;
+        const endLine = node.endLine;
+        if (startLine === undefined || endLine === undefined)
+            continue;
+        const enclosingClass = typeof node.enclosingClass === "string"
+            ? (node.enclosingClass ?? null)
+            : null;
+        const docstring = typeof node.description === "string"
+            ? (node.description ?? null)
+            : null;
+        candidates.push({
+            nodeId: node.id,
+            filePath: node.filePath,
+            startLine,
+            endLine,
+            enclosingClass,
+            docstring,
+        });
+    }
+    // Deterministic order: sort by node id so cap truncation picks a stable
+    // subset across runs.
+    candidates.sort((a, b) => (a.nodeId < b.nodeId ? -1 : a.nodeId > b.nodeId ? 1 : 0));
+    // ---- Read source + hash, classify hit vs miss -------------------------
+    const readSource = testHooks?.sourceReader ?? defaultSourceReader;
+    let cacheHits = 0;
+    const misses = [];
+    // Resolve a cache adapter from the options bag if the CLI attached one.
+    // Phases have no direct store handle, so we route cache probes through a
+    // narrow hook on `ctx.options`. Production attaches the DuckDB-backed
+    // adapter; tests supply an in-memory fake.
+    const cacheAdapter = resolveCacheAdapter(ctx);
+    for (const c of candidates) {
+        const source = safeReadSpan(readSource, ctx.repoPath, c.filePath, c.startLine, c.endLine);
+        if (source === undefined)
+            continue;
+        const contentHash = sha256Hex(source);
+        if (cacheAdapter !== undefined) {
+            const hit = await cacheAdapter.lookup(c.nodeId, contentHash, promptVersion);
+            if (hit !== undefined) {
+                cacheHits += 1;
+                continue;
+            }
+        }
+        misses.push({ candidate: c, source, contentHash });
+    }
+    // ---- Cost cap ---------------------------------------------------------
+    const cap = Math.max(0, Math.floor(ctx.options.maxSummariesPerRun ?? 0));
+    // When cap === 0 the phase runs in dry-run mode: every miss contributes
+    // to wouldHaveSummarized and we skip Bedrock entirely. When cap > 0 we
+    // slice the first `cap` misses into the effective batch and count the
+    // overflow (if any) as wouldHaveSummarized too.
+    const effectiveBatch = cap === 0 ? [] : misses.slice(0, cap);
+    const effectiveWouldHave = cap === 0 ? misses.length : misses.length - effectiveBatch.length;
+    if (effectiveBatch.length === 0) {
+        return {
+            enabled: true,
+            promptVersion,
+            modelId,
+            considered,
+            skippedUnconfirmed,
+            cacheHits,
+            wouldHaveSummarized: effectiveWouldHave,
+            summarized: 0,
+            failed: 0,
+            rows: [],
+            durationMs: Date.now() - start,
+        };
+    }
+    // ---- Summarize --------------------------------------------------------
+    // Instantiating the summarizer resolves the AWS SDK credential chain, which
+    // throws `CredentialsProviderError` / `NoCredentialsError` when no creds
+    // are configured. Catch that family here so contributors without Bedrock
+    // access still get a green analyze — the missing-credentials path emits a
+    // skip note and zero rows, while every other factory error continues to
+    // surface so real bugs don't go silent.
+    let summarizer;
+    try {
+        summarizer = (testHooks?.summarizerFactory ?? defaultSummarizerFactory)({ modelId });
+    }
+    catch (err) {
+        if (isMissingCredentialsError(err)) {
+            ctx.onProgress?.({
+                phase: SUMMARIZE_PHASE_NAME,
+                kind: "note",
+                message: "summarize: skipped (no AWS credentials)",
+            });
+            return emptyOutput(start, {
+                skippedReason: "no-credentials",
+                promptVersion,
+                modelId,
+            });
+        }
+        throw err;
+    }
+    const now = testHooks?.now ?? (() => new Date());
+    const rows = [];
+    let summarized = 0;
+    let failed = 0;
+    for (const [idx, entry] of effectiveBatch.entries()) {
+        const input = {
+            source: entry.source,
+            filePath: entry.candidate.filePath,
+            lineStart: entry.candidate.startLine,
+            lineEnd: entry.candidate.endLine,
+            docstring: entry.candidate.docstring,
+            enclosingClass: entry.candidate.enclosingClass,
+        };
+        try {
+            const result = await summarizer.summarize(input);
+            const summary = result.summary;
+            const signatureSummary = buildSignatureSummary(summary);
+            const row = {
+                nodeId: entry.candidate.nodeId,
+                contentHash: entry.contentHash,
+                promptVersion,
+                modelId,
+                summaryText: summary.purpose,
+                ...(signatureSummary !== undefined ? { signatureSummary } : {}),
+                returnsTypeSummary: summary.returns.type_summary,
+                createdAt: now().toISOString(),
+            };
+            rows.push(row);
+            summarized += 1;
+        }
+        catch (err) {
+            // Credential errors can surface on the first Bedrock call rather than
+            // at client construction (e.g. SSO profile expired mid-run). Treat
+            // the first such error on the first candidate as a soft-fail for the
+            // whole phase so we don't waste the batch on a guaranteed-failing
+            // credential chain.
+            if (idx === 0 && isMissingCredentialsError(err)) {
+                ctx.onProgress?.({
+                    phase: SUMMARIZE_PHASE_NAME,
+                    kind: "note",
+                    message: "summarize: skipped (no AWS credentials)",
+                });
+                return emptyOutput(start, {
+                    skippedReason: "no-credentials",
+                    promptVersion,
+                    modelId,
+                });
+            }
+            failed += 1;
+            ctx.onProgress?.({
+                phase: SUMMARIZE_PHASE_NAME,
+                kind: "warn",
+                message: `summarize: ${entry.candidate.nodeId} failed: ${err.message}`,
+            });
+        }
+    }
+    return {
+        enabled: true,
+        promptVersion,
+        modelId,
+        considered,
+        skippedUnconfirmed,
+        cacheHits,
+        wouldHaveSummarized: effectiveWouldHave,
+        summarized,
+        failed,
+        rows,
+        durationMs: Date.now() - start,
+    };
+}
+// ---- Helpers ------------------------------------------------------------
+function emptyOutput(start, partial) {
+    return {
+        enabled: false,
+        skippedReason: partial.skippedReason,
+        promptVersion: partial.promptVersion,
+        modelId: partial.modelId,
+        considered: 0,
+        skippedUnconfirmed: 0,
+        cacheHits: 0,
+        wouldHaveSummarized: 0,
+        summarized: 0,
+        failed: 0,
+        rows: [],
+        durationMs: Date.now() - start,
+    };
+}
+function isLspReason(reason) {
+    if (reason === undefined)
+        return false;
+    for (const prefix of SCIP_PROVENANCE_PREFIXES) {
+        if (reason.startsWith(prefix))
+            return true;
+    }
+    return false;
+}
+function sha256Hex(s) {
+    return createHash("sha256").update(s, "utf8").digest("hex");
+}
+/**
+ * Recognize the AWS SDK v3 credential-missing error family. The SDK
+ * throws `CredentialsProviderError` (name) / `NoCredentialsError`
+ * depending on the provider in the chain, plus pure-string errors from
+ * `from*` providers ("Could not load credentials from any providers").
+ *
+ * We match on a small set of well-known shapes rather than importing
+ * `@smithy/types` to keep the phase independent of the SDK's type
+ * surface and safe to call with a test fake that merely sets `name`.
+ */
+function isMissingCredentialsError(err) {
+    if (err === null || err === undefined)
+        return false;
+    const errObj = err;
+    const name = typeof errObj.name === "string" ? errObj.name : "";
+    if (name === "CredentialsProviderError" ||
+        name === "NoCredentialsError" ||
+        name === "ExpiredTokenException") {
+        return true;
+    }
+    const message = typeof errObj.message === "string" ? errObj.message : "";
+    return (message.includes("Could not load credentials") ||
+        message.includes("credentials is missing") ||
+        message.includes("Unable to load credentials") ||
+        message.includes("The security token included in the request is expired"));
+}
+function defaultSourceReader(absPath) {
+    return readFileSync(absPath, "utf-8");
+}
+function safeReadSpan(reader, repoPath, filePath, startLine, endLine) {
+    try {
+        const abs = path.isAbsolute(filePath) ? filePath : path.join(repoPath, filePath);
+        const all = reader(abs);
+        const lines = all.split(/\r?\n/);
+        const from = Math.max(0, startLine - 1);
+        const to = Math.min(lines.length, endLine);
+        if (to <= from)
+            return undefined;
+        return lines.slice(from, to).join("\n");
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildSignatureSummary(summary) {
+    if (summary.inputs.length === 0)
+        return undefined;
+    return summary.inputs.map((i) => `${i.name}: ${i.type}`).join(", ");
+}
+/**
+ * Options-bag extension point. Callers attach the cache adapter via a
+ * non-enumerable-looking well-known key so existing snapshot tests that
+ * assert on option shape don't break.
+ */
+export const SUMMARY_CACHE_OPTIONS_KEY = "__summaryCache";
+function resolveCacheAdapter(ctx) {
+    const opts = ctx.options;
+    const cache = opts[SUMMARY_CACHE_OPTIONS_KEY];
+    if (cache === undefined || cache === null || typeof cache !== "object")
+        return undefined;
+    const adapter = cache;
+    if (typeof adapter.lookup !== "function")
+        return undefined;
+    return adapter;
+}
+/**
+ * Default summarizer factory. Defers importing `@aws-sdk/client-bedrock-runtime`
+ * until the phase actually needs to issue a call, so test runs with
+ * `maxSummariesPerRun=0` or `summaries=false` never touch the SDK's
+ * credential provider chain.
+ */
+function defaultSummarizerFactory(opts) {
+    return {
+        summarize: async (input) => {
+            const [{ BedrockRuntimeClient }, { summarizeSymbol }] = await Promise.all([
+                import("@aws-sdk/client-bedrock-runtime"),
+                import("@opencodehub/summarizer"),
+            ]);
+            const client = new BedrockRuntimeClient({});
+            return summarizeSymbol(client, input, { modelId: opts.modelId });
+        },
+    };
+}
+//# sourceMappingURL=summarize.js.map

package/dist/pipeline/phases/summarize.js.map

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

package/dist/pipeline/phases/temporal-helpers/branch-divergence.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Branch divergence — counts `ahead` and `behind` commits relative to the
+ * configured base branch, plus the list of files uniquely touched by the
+ * ahead commits.
+ *
+ * Uses two git subprocesses per branch:
+ *   1. `git rev-list --left-right --count <base>...<ref>` → tab-separated
+ *      pair "behind<TAB>ahead".
+ *   2. `git log <base>..<ref> --name-only --format=` → newline-separated
+ *      file paths, deduplicated in first-seen order.
+ *
+ * The caller supplies the base branch name (typically `main`) and the list
+ * of candidate head refs. The function fails open: any git error leaves the
+ * affected branch's entry absent from the returned map.
+ */
+export interface BranchDivergenceEntry {
+    readonly ahead: number;
+    readonly behind: number;
+    readonly overlapFiles: readonly string[];
+}
+export interface BranchDivergenceResult {
+    readonly entries: ReadonlyMap<string, BranchDivergenceEntry>;
+}
+export interface BranchDivergenceOptions {
+    readonly repoPath: string;
+    readonly baseBranch: string;
+    readonly branches: readonly string[];
+    readonly maxOverlapFiles?: number;
+}
+/**
+ * List local branches via `git for-each-ref refs/heads/`. Returns short ref
+ * names sorted lexicographically so downstream iteration is deterministic.
+ */
+export declare function listLocalBranches(repoPath: string): Promise<readonly string[]>;
+/**
+ * Compute divergence for each branch relative to `baseBranch`.
+ *
+ * Branches equal to the base or failing to resolve are omitted from the
+ * result map.
+ */
+export declare function computeBranchDivergence(opts: BranchDivergenceOptions): Promise<BranchDivergenceResult>;
+//# sourceMappingURL=branch-divergence.d.ts.map

package/dist/pipeline/phases/temporal-helpers/branch-divergence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-divergence.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phases/temporal-helpers/branch-divergence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAepF;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAYjC"}