@oscharko-dev/keiko-workflows 0.2.6 → 0.2.8

package/dist/context-budget/index.d.ts

@@ -0,0 +1,8 @@
+export type { AllocateContextInput, AllocateContextResult, AllocatedContextLane, ContextLaneInput, ContextLaneItemInput, } from "./allocator.js";
+export { allocateContext } from "./allocator.js";
+export { DEFAULT_CONTEXT_BUDGET } from "./defaults.js";
+export type { BuildCompactionInput, CompactionDigest } from "./compaction.js";
+export { buildCompactionRecords } from "./compaction.js";
+export type { RehydrationResult } from "./rehydration.js";
+export { rehydrateProvenanceRef, rehydrateHandle } from "./rehydration.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context-budget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context-budget/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/context-budget/index.js

@@ -0,0 +1,6 @@
+// Public sub-barrel for the deterministic context-budget allocator (ADR-0052 D6). External
+// consumers import the allocator surface and the default budget plan through this module.
+export { allocateContext } from "./allocator.js";
+export { DEFAULT_CONTEXT_BUDGET } from "./defaults.js";
+export { buildCompactionRecords } from "./compaction.js";
+export { rehydrateProvenanceRef, rehydrateHandle } from "./rehydration.js";

package/dist/context-budget/rehydration.d.ts

@@ -0,0 +1,11 @@
+import type { ContextProvenanceRef, ContextRehydrationHandle } from "@oscharko-dev/keiko-contracts";
+import { type SearchScope, type WorkspaceFs } from "@oscharko-dev/keiko-workspace";
+export interface RehydrationResult {
+    readonly resolved: boolean;
+    readonly invalidated?: boolean | undefined;
+    readonly content?: string | undefined;
+    readonly reason?: string | undefined;
+}
+export declare function rehydrateProvenanceRef(ref: ContextProvenanceRef, scope: SearchScope, fs: WorkspaceFs, maxBytes?: number): Promise<RehydrationResult>;
+export declare function rehydrateHandle(handle: ContextRehydrationHandle, scope: SearchScope, fs: WorkspaceFs, maxBytes?: number): Promise<RehydrationResult>;
+//# sourceMappingURL=rehydration.d.ts.map

package/dist/context-budget/rehydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehydration.d.ts","sourceRoot":"","sources":["../../src/context-budget/rehydration.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACpG,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAuDD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,WAAW,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;AAKD,wBAAsB,eAAe,CACnC,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,WAAW,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAa5B"}

package/dist/context-budget/rehydration.js

@@ -0,0 +1,76 @@
+// Bounded, deny-checked, observable rehydration of compacted provenance (ADR-0053 D5). The ONLY IO
+// path in the context-budget module: every repo-file read goes through readExcerpt, which itself
+// runs isDenied + containment + binary/size gates and throws on a denied/binary/too-large path. We
+// CATCH those throws and degrade to {resolved:false, reason} so a stale or denied source never
+// crashes the caller. The excerpt-content hash is recomputed on read so a line-range change is
+// detected precisely against the handle's contentHash.
+import { hashExcerptContent, readExcerpt, } from "@oscharko-dev/keiko-workspace";
+// Independent of whatever the caller passes: rehydration is always bounded. 256 KiB is generous for
+// a single excerpt window yet far under readExcerpt's 2 MiB file cap. A caller passing Infinity or
+// an oversized value cannot widen this — Math.min clamps it.
+const DEFAULT_REHYDRATION_MAX_BYTES = 262_144;
+const MAX_REHYDRATION_MAX_BYTES = 2_097_152;
+function boundMaxBytes(maxBytes) {
+    const requested = maxBytes !== undefined && Number.isFinite(maxBytes) && maxBytes >= 0
+        ? Math.floor(maxBytes)
+        : DEFAULT_REHYDRATION_MAX_BYTES;
+    return Math.min(requested, MAX_REHYDRATION_MAX_BYTES);
+}
+function deferred(kind) {
+    return { resolved: false, reason: `kind ${kind} rehydration deferred (PR3/PR4)` };
+}
+async function readRepoFile(target, scope, fs, maxBytes) {
+    try {
+        const result = await readExcerpt(scope, {
+            scopePath: target.scopePath,
+            startLine: target.startLine,
+            endLine: target.endLine,
+            maxBytes: boundMaxBytes(maxBytes),
+        }, { fs });
+        const newHash = hashExcerptContent(result.content);
+        const invalidated = target.contentHash !== undefined && newHash !== target.contentHash;
+        return { resolved: true, invalidated, content: result.content };
+    }
+    catch (error) {
+        return { resolved: false, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+// Resolves a single ContextProvenanceRef. A notPersistedReason short-circuits WITHOUT any read.
+// kind 'repo-file' with scopePath + lineRange reads via readExcerpt (deny/bounds gated). All other
+// kinds are deferred to a later PR with no IO.
+export async function rehydrateProvenanceRef(ref, scope, fs, maxBytes) {
+    if (ref.notPersistedReason !== undefined) {
+        return { resolved: false, reason: ref.notPersistedReason };
+    }
+    if (ref.kind !== "repo-file") {
+        return deferred(ref.kind);
+    }
+    const scopePath = ref.scopePath;
+    const lineRange = ref.lineRange;
+    if (scopePath === undefined || lineRange === undefined) {
+        return { resolved: false, reason: "repo-file ref missing scopePath or lineRange" };
+    }
+    return readRepoFile({
+        scopePath,
+        startLine: lineRange.startLine,
+        endLine: lineRange.endLine,
+        contentHash: ref.contentHash,
+    }, scope, fs, maxBytes);
+}
+// Resolves a lane-level handle. A handle that carries kind + scopePath + lineRange is resolved by
+// constructing the equivalent repo-file ref; otherwise it is lane-level (an opaque eviction-set
+// pointer) and not directly rehydratable.
+export async function rehydrateHandle(handle, scope, fs, maxBytes) {
+    const { kind, scopePath, lineRange } = handle;
+    if (kind === undefined || scopePath === undefined || lineRange === undefined) {
+        return { resolved: false, reason: "handle not directly rehydratable (lane-level)" };
+    }
+    const ref = {
+        kind,
+        stableId: handle.handleId,
+        scopePath,
+        lineRange,
+        ...(handle.contentHash !== undefined ? { contentHash: handle.contentHash } : {}),
+    };
+    return rehydrateProvenanceRef(ref, scope, fs, maxBytes);
+}

package/dist/contextpack/assemble.d.ts

@@ -1,4 +1,4 @@
-import { type CandidateFile, type ConnectedContextPack, type EvidenceAtom, type ExplorationBudget, type ExplorationUsage, type OmittedContextEntry, type RetrievalQuery, type SelectedScope, type UncertaintyMarker } from "@oscharko-dev/keiko-contracts/connected-context";
+import { type CandidateFile, type ConnectedContextPack, type ContextPackDiagnostics, type EvidenceAtom, type ExplorationBudget, type ExplorationUsage, type OmittedContextEntry, type RetrievalQuery, type SelectedScope, type UncertaintyMarker } from "@oscharko-dev/keiko-contracts/connected-context";
 import { type MicroIndex } from "./microIndex.js";
 import { type RerankerSeam } from "./reranker.js";
 export interface AssembleInput {
@@ -12,6 +12,7 @@ export interface AssembleInput {
     readonly cacheIdentity?: readonly string[] | undefined;
     readonly initialUsage?: ExplorationUsage;
     readonly initialUncertainty?: readonly UncertaintyMarker[];
+    readonly diagnostics?: ContextPackDiagnostics | undefined;
 }
 export interface ExcerptWindow {
     readonly startLine: number;

package/dist/contextpack/assemble.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/contextpack/assemble.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAIzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,iDAAiD,CAAC;AAIzD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAIpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,aAAa,EAAE,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AA0fD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAQ3F;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAoCzB"}
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/contextpack/assemble.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAI3B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,iDAAiD,CAAC;AAIzD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAIpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAE3D,QAAQ,CAAC,WAAW,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,aAAa,EAAE,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AA8gBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAQ3F;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAoCzB"}

package/dist/contextpack/assemble.js

@@ -273,6 +273,7 @@ function buildPack(input, plan, nowMs) {
         uncertainty: plan.uncertainty,
         emittedAtMs: nowMs,
         ledgerRef: undefined,
+        ...(input.diagnostics !== undefined ? { diagnostics: input.diagnostics } : {}),
     };
 }
 // ─── Public facade ────────────────────────────────────────────────────────────
@@ -354,6 +355,23 @@ function cacheOmitted(entry) {
         reason: entry.reason,
     };
 }
+// Diagnostics are carried verbatim onto the pack, so two runs that differ ONLY in ranking
+// explanation must not collide on a cached pack. Returns undefined when absent (serializes away,
+// keeping legacy cache keys byte-identical).
+function cacheDiagnostics(diagnostics) {
+    if (diagnostics === undefined) {
+        return undefined;
+    }
+    return {
+        rankedCandidates: diagnostics.rankedCandidates.map((entry) => ({
+            scopePath: entry.scopePath,
+            bucket: entry.bucket,
+            score: entry.score,
+            ecosystem: entry.ecosystem,
+            signals: entry.signals.map((signal) => ({ name: signal.name, value: signal.value })),
+        })),
+    };
+}
 function cacheExcerptWindow(window) {
     return {
         startLine: window.startLine,
@@ -387,6 +405,7 @@ function buildCacheAtomIds(input, resolved) {
             : undefined,
         ranked: input.ranked.map(cacheCandidate),
         omittedFromRanking: input.omittedFromRanking.map(cacheOmitted),
+        diagnostics: cacheDiagnostics(input.diagnostics),
         excerpts: cacheExcerptIdentity(input),
         maxBytesPerExcerpt: resolved.maxBytesPerExcerpt,
         editablePaths: [...resolved.editablePaths].sort(),

package/dist/index.d.ts

@@ -6,4 +6,6 @@ export * from "./ranking/index.js";
 export * from "./contextpack/index.js";
 export * from "./qualityIntelligence/index.js";
 export * from "./promptEnhancer/index.js";
+export * from "./context-budget/index.js";
+export * from "./observations/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AAIvC,cAAc,gCAAgC,CAAC;AAG/C,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AAIvC,cAAc,gCAAgC,CAAC;AAG/C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -11,3 +11,7 @@ export * from "./contextpack/index.js";
 export * from "./qualityIntelligence/index.js";
 // ─── Prompt Enhancer workflow execution (Epic #1307, Issue #1314) ─────────────
 export * from "./promptEnhancer/index.js";
+// ─── Deterministic context-budget allocator (ADR-0052, context-engineering milestone) ──
+export * from "./context-budget/index.js";
+// ─── Tool-observation shapers (ADR-0054, PR3-W3, context-engineering milestone) ──
+export * from "./observations/index.js";

package/dist/observations/command.d.ts

@@ -0,0 +1,6 @@
+import { type CommandResult, type ShapedCommandObservation } from "@oscharko-dev/keiko-contracts";
+export interface ShapeCommandOptions {
+    readonly observationId?: string | undefined;
+}
+export declare function shapeCommandObservation(result: CommandResult, opts?: ShapeCommandOptions): ShapedCommandObservation;
+//# sourceMappingURL=command.d.ts.map

package/dist/observations/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/observations/command.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAE9B,MAAM,+BAA+B,CAAC;AAWvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AA0CD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,mBAAmB,GACzB,wBAAwB,CA6B1B"}

package/dist/observations/command.js

@@ -0,0 +1,67 @@
+// Pure shaper: CommandResult -> ShapedCommandObservation (ADR-0054, PR3-W3, D4). No IO, no clock,
+// no randomness. Total — never throws on empty streams. The exit-code/duration/timedOut/truncated
+// signals are preserved verbatim; each non-empty stream contributes a redacted, byte-bounded
+// excerpt whose combined bytes stay within MAX_OBSERVATION_EXCERPT_BYTES. Injection signals are
+// recorded content-free over the already-redacted excerpt text. A rehydration handle is attached
+// ONLY when the output was truncated (there is omitted content worth re-fetching in PR5).
+import { MAX_OBSERVATION_EXCERPT_BYTES, } from "@oscharko-dev/keiko-contracts";
+import { boundExcerpt, buildToolRehydrationHandle, estimateTokens, injectionSignalsFor, makeObservationId, utf8ByteLength, } from "./shared.js";
+const TRUNCATED_NOT_PERSISTED = "tool output not persisted in PR3 (artifact store wired in PR5)";
+// Builds the bounded excerpts, allocating the shared MAX_OBSERVATION_EXCERPT_BYTES budget across the
+// non-empty streams in order (stdout first, then stderr from the remaining budget) so the SUM of
+// excerpt bytes never exceeds the cap. Each excerpt is redacted before clamping (boundExcerpt).
+function buildExcerpts(sources) {
+    const excerpts = [];
+    let remaining = MAX_OBSERVATION_EXCERPT_BYTES;
+    for (const source of sources) {
+        if (source.text.length === 0 || remaining <= 0) {
+            continue;
+        }
+        const text = boundExcerpt(source.text, remaining);
+        if (text.length === 0) {
+            continue;
+        }
+        const bytes = utf8ByteLength(text);
+        excerpts.push({ stream: source.stream, bytes, text });
+        remaining -= bytes;
+    }
+    return excerpts;
+}
+function injectionFor(excerpts) {
+    const combined = excerpts.map((excerpt) => excerpt.text).join("\n");
+    const summary = injectionSignalsFor(combined);
+    return {
+        injectionSignalCount: summary.count,
+        hasCriticalInjectionSignal: summary.critical,
+    };
+}
+export function shapeCommandObservation(result, opts) {
+    const observationId = opts?.observationId ?? makeObservationId("");
+    const excerpts = buildExcerpts([
+        { stream: "stdout", text: result.stdout },
+        { stream: "stderr", text: result.stderr },
+    ]);
+    const injection = injectionFor(excerpts);
+    return {
+        kind: "command",
+        observationId,
+        exitCode: result.exitCode,
+        durationMs: result.durationMs,
+        timedOut: result.timedOut,
+        truncated: result.truncated,
+        ...(result.omittedByteCount !== undefined ? { omittedByteCount: result.omittedByteCount } : {}),
+        excerpts,
+        injectionSignalCount: injection.injectionSignalCount,
+        hasCriticalInjectionSignal: injection.hasCriticalInjectionSignal,
+        ...(result.truncated
+            ? {
+                rehydration: buildToolRehydrationHandle({
+                    artifactSeed: `${observationId}:full`,
+                    itemCount: 1,
+                    approxTokens: estimateTokens(excerpts.map((excerpt) => excerpt.text).join("\n")),
+                    notPersistedReason: TRUNCATED_NOT_PERSISTED,
+                }),
+            }
+            : {}),
+    };
+}

package/dist/observations/index.d.ts

@@ -0,0 +1,5 @@
+export { shapeCommandObservation, type ShapeCommandOptions } from "./command.js";
+export { shapeTestObservation, type ShapeTestOptions } from "./test.js";
+export { shapeSearchObservation, type ShapeSearchOptions } from "./search.js";
+export { makeObservationId, injectionSignalsFor, boundExcerpt, buildToolRehydrationHandle, type InjectionSummary, type RehydrationHandleInput, } from "./shared.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observations/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC"}

package/dist/observations/index.js

@@ -0,0 +1,6 @@
+// Barrel for the tool-observation shapers (ADR-0054, PR3-W3). Re-exports the three pure shapers and
+// the shared helpers worth exposing to the PR4 lane assembler. No live browser shaper in PR3 (D8).
+export { shapeCommandObservation } from "./command.js";
+export { shapeTestObservation } from "./test.js";
+export { shapeSearchObservation } from "./search.js";
+export { makeObservationId, injectionSignalsFor, boundExcerpt, buildToolRehydrationHandle, } from "./shared.js";

package/dist/observations/search.d.ts

@@ -0,0 +1,9 @@
+import { type ShapedSearchObservation } from "@oscharko-dev/keiko-contracts";
+import type { SearchResult } from "@oscharko-dev/keiko-workspace";
+export interface ShapeSearchOptions {
+    readonly observationId?: string | undefined;
+    readonly query?: string | undefined;
+    readonly searchKind?: string | undefined;
+}
+export declare function shapeSearchObservation(result: SearchResult, opts?: ShapeSearchOptions): ShapedSearchObservation;
+//# sourceMappingURL=search.d.ts.map

package/dist/observations/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/observations/search.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAIlE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAiBD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,IAAI,CAAC,EAAE,kBAAkB,GACxB,uBAAuB,CAkBzB"}

package/dist/observations/search.js

@@ -0,0 +1,43 @@
+// Pure shaper: SearchResult -> ShapedSearchObservation (ADR-0054, PR3-W3, D4). No IO, no clock, no
+// randomness. Total — never throws on empty atoms. Preserves the top-scoring file ranges so the
+// PR4 lane assembler can cite relevant matches without including any raw atom text. scopePath is
+// allowed here: this is the internal tool-observations lane, not the path-free browser summary.
+//
+// SOURCE NOTE: SearchResult (keiko-workspace/repoSearch.ts) carries the atoms + truncation flag but
+// NOT the original query string or the search kind (those are inputs to searchText/findFiles, not
+// outputs). The caller supplies them via opts so the shaper stays a pure projection. The query is
+// the untrusted input (user-typed or model-generated): it is redacted and byte-bounded, and the
+// injection summary is computed over the redacted query, content-free.
+import { MAX_OBSERVATION_QUERY_BYTES, MAX_TOP_RANGES, } from "@oscharko-dev/keiko-contracts";
+import { boundExcerpt, injectionSignalsFor, makeObservationId } from "./shared.js";
+const DEFAULT_SEARCH_KIND = "text";
+function toRange(atom) {
+    const startLine = atom.lineRange?.startLine ?? 0;
+    const endLine = atom.lineRange?.endLine ?? 0;
+    return { scopePath: atom.scopePath, startLine, endLine, score: atom.score };
+}
+// Top MAX_TOP_RANGES atoms by descending score. Sorts a shallow copy (the source array is readonly
+// and must not be mutated). Ties keep their relative input order via a stable comparator.
+function topRanges(atoms) {
+    const sorted = [...atoms].sort((a, b) => b.score - a.score);
+    return sorted.slice(0, MAX_TOP_RANGES).map(toRange);
+}
+export function shapeSearchObservation(result, opts) {
+    const observationId = opts?.observationId ?? makeObservationId("");
+    const query = boundExcerpt(opts?.query ?? "", MAX_OBSERVATION_QUERY_BYTES);
+    const ranges = topRanges(result.atoms);
+    const candidateCount = result.atoms.length;
+    const injection = injectionSignalsFor(query);
+    return {
+        kind: "search",
+        observationId,
+        query,
+        searchKind: opts?.searchKind ?? DEFAULT_SEARCH_KIND,
+        candidateCount,
+        topRanges: ranges,
+        omittedCount: candidateCount - ranges.length,
+        truncated: result.truncated,
+        injectionSignalCount: injection.count,
+        hasCriticalInjectionSignal: injection.critical,
+    };
+}

package/dist/observations/shared.d.ts

@@ -0,0 +1,18 @@
+import { estimateTokens, type ContextToolRehydrationHandle } from "@oscharko-dev/keiko-contracts";
+export interface InjectionSummary {
+    readonly count: number;
+    readonly critical: boolean;
+}
+export declare function makeObservationId(seed: string): string;
+export declare function injectionSignalsFor(text: string): InjectionSummary;
+export declare function boundExcerpt(text: string, maxBytes: number): string;
+export declare function utf8ByteLength(text: string): number;
+export interface RehydrationHandleInput {
+    readonly artifactSeed: string;
+    readonly itemCount: number;
+    readonly approxTokens: number;
+    readonly notPersistedReason?: string | undefined;
+}
+export declare function buildToolRehydrationHandle(input: RehydrationHandleInput): ContextToolRehydrationHandle;
+export { estimateTokens };
+//# sourceMappingURL=shared.d.ts.map

package/dist/observations/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/observations/shared.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,cAAc,EAEd,KAAK,4BAA4B,EAClC,MAAM,+BAA+B,CAAC;AAavC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAOlE;AAKD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWnE;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClD;AAKD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,sBAAsB,GAC5B,4BAA4B,CAY9B;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/observations/shared.js

@@ -0,0 +1,63 @@
+// Shared, pure helpers for the tool-observation shapers (ADR-0054, PR3-W3). No IO, no clock, no
+// randomness. Every untrusted free-text string is scrubbed via redact() from keiko-security BEFORE
+// it is clamped or measured (the defense-in-depth boundary established by the PR2 compaction
+// helpers). Injection detection is CONTENT-FREE by construction: detectPromptInjectionSignals
+// returns only {code, severity, matchCount}; we store an aggregate count and a boolean and NEVER
+// the matched text. No new package edge: contracts/security/workspace are already dependencies.
+import { CONTEXT_ENGINEERING_SCHEMA_VERSION, estimateTokens, } from "@oscharko-dev/keiko-contracts";
+import { hashExcerptContent } from "@oscharko-dev/keiko-workspace";
+import { detectPromptInjectionSignals, hasCriticalInjectionSignal, redact, } from "@oscharko-dev/keiko-security";
+// The lane every shaped tool observation belongs to (ADR-0052 taxonomy).
+const TOOL_OBSERVATIONS_LANE = "tool-observations";
+// Stable, reproducible observation id: SHA-256 hex of the seed (typically the toolCallId). Total —
+// hashExcerptContent never throws; an empty seed yields the well-defined hash of zero bytes.
+export function makeObservationId(seed) {
+    return hashExcerptContent(seed);
+}
+// CONTENT-FREE injection signal summary over untrusted text. Sums each signal's matchCount for the
+// aggregate count and derives the critical flag from the authoritative severity helper. The matched
+// text is never inspected by the caller — only the returned counts/boolean are persisted.
+export function injectionSignalsFor(text) {
+    const signals = detectPromptInjectionSignals(text);
+    let count = 0;
+    for (const signal of signals) {
+        count += signal.matchCount;
+    }
+    return { count, critical: hasCriticalInjectionSignal(signals) };
+}
+// Redact-then-clamp: redact() runs FIRST so a secret can never survive into the bounded excerpt,
+// then the redacted text is clamped to maxBytes of UTF-8 without splitting a multibyte character
+// (the repoSearch clampToBytes pattern: encode, subarray, lossy-decode, trim the replacement char).
+export function boundExcerpt(text, maxBytes) {
+    const redacted = redact(text);
+    if (maxBytes <= 0) {
+        return "";
+    }
+    const encoded = new TextEncoder().encode(redacted);
+    if (encoded.length <= maxBytes) {
+        return redacted;
+    }
+    const buffer = encoded.subarray(0, maxBytes);
+    return new TextDecoder("utf-8", { fatal: false }).decode(buffer).replace(/�+$/u, "");
+}
+// UTF-8 byte length of a string (the bytes field on a ShapedStreamExcerpt).
+export function utf8ByteLength(text) {
+    return new TextEncoder().encode(text).length;
+}
+// Builds the content-free ContextToolRehydrationHandle. artifactId = hashExcerptContent(artifactSeed)
+// — deterministic and stable. notPersistedReason is included only when supplied (exactOptional:
+// conditional spread, never assigned undefined). approxTokens is passed through unchanged.
+export function buildToolRehydrationHandle(input) {
+    return {
+        schemaVersion: CONTEXT_ENGINEERING_SCHEMA_VERSION,
+        laneId: TOOL_OBSERVATIONS_LANE,
+        kind: "tool-result",
+        artifactId: makeObservationId(input.artifactSeed),
+        itemCount: input.itemCount,
+        approxTokens: input.approxTokens,
+        ...(input.notPersistedReason !== undefined
+            ? { notPersistedReason: input.notPersistedReason }
+            : {}),
+    };
+}
+export { estimateTokens };

package/dist/observations/test.d.ts

@@ -0,0 +1,6 @@
+import { type ShapedTestObservation, type VerificationResult } from "@oscharko-dev/keiko-contracts";
+export interface ShapeTestOptions {
+    readonly observationId?: string | undefined;
+}
+export declare function shapeTestObservation(result: VerificationResult, opts?: ShapeTestOptions): ShapedTestObservation;
+//# sourceMappingURL=test.d.ts.map

package/dist/observations/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/observations/test.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAUvC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAQD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,CAAC,EAAE,gBAAgB,GACtB,qBAAqB,CA6BvB"}

package/dist/observations/test.js

@@ -0,0 +1,47 @@
+// Pure shaper: VerificationResult -> ShapedTestObservation (ADR-0054, PR3-W3, D4). No IO, no clock,
+// no randomness. Total — never throws.
+//
+// HONEST SOURCE NOTE: the live VerificationResult (keiko-contracts/verification.ts) carries NO
+// per-test structured data — no pass/fail/skip counts, no failing test names, no stack frames. Its
+// outputSummary is a redacted DIGEST string (e.g. "command output captured (N bytes) and omitted
+// from summary" — see keiko-verification/src/orchestrator.ts outputDigest), not a parseable test
+// log, and the per-status counts on VerificationReport count STEPS, not individual tests. Per the
+// PR3 constraint we do NOT invent counts or names: counts default to zeros and the name/frame arrays
+// stay empty until a producer supplies genuinely structured data. The reliably-present fields we DO
+// project: kind, status, exitCode, durationMs, truncated, and the redacted outputSummary.
+import {} from "@oscharko-dev/keiko-contracts";
+import { boundExcerpt, buildToolRehydrationHandle, estimateTokens, injectionSignalsFor, makeObservationId, } from "./shared.js";
+const TRUNCATED_NOT_PERSISTED = "tool output not persisted in PR3 (artifact store wired in PR5)";
+// VerificationResult has no per-test breakdown; the only honest count is all-zero. A future producer
+// with structured test data populates this via a richer overload, not by inventing numbers here.
+const EMPTY_COUNTS = { passed: 0, failed: 0, skipped: 0 };
+export function shapeTestObservation(result, opts) {
+    const observationId = opts?.observationId ?? makeObservationId("");
+    const outputSummary = boundExcerpt(result.outputSummary, Number.MAX_SAFE_INTEGER);
+    const injection = injectionSignalsFor(outputSummary);
+    return {
+        kind: "test",
+        observationId,
+        verificationKind: result.kind,
+        status: result.status,
+        exitCode: result.exitCode,
+        durationMs: result.durationMs,
+        truncated: result.truncated,
+        counts: EMPTY_COUNTS,
+        failingTestNames: [],
+        stackFrameExcerpts: [],
+        outputSummary,
+        injectionSignalCount: injection.count,
+        hasCriticalInjectionSignal: injection.critical,
+        ...(result.truncated
+            ? {
+                rehydration: buildToolRehydrationHandle({
+                    artifactSeed: `${observationId}:full`,
+                    itemCount: 1,
+                    approxTokens: estimateTokens(outputSummary),
+                    notPersistedReason: TRUNCATED_NOT_PERSISTED,
+                }),
+            }
+            : {}),
+    };
+}

package/dist/planner/anchors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/planner/anchors.ts"],"names":[],"mappings":"AA+LA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAgHD,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAoBnF"}
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/planner/anchors.ts"],"names":[],"mappings":"AAgMA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAgHD,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAqBnF"}

package/dist/planner/anchors.js

@@ -158,6 +158,7 @@ const QUOTED_DOUBLE_RE = /"([^"\n]+)"/g;
 const QUOTED_SINGLE_RE = /'([^'\n]+)'/g;
 const BACKTICK_RE = /`([^`\n]+)`/g;
 const PATH_RE = /(?:[\w.-]+\/)+[\w.-]+\.[A-Za-z]{1,8}/g;
+const API_ROUTE_RE = /(^|[^A-Za-z0-9_.-])((?:\/[A-Za-z0-9_.:{}-]+){2,})/g;
 // Requires a genuine lower/digit -> upper transition so all-caps acronyms and SHOUTING words
 // (WHY, HTTP, BROKEN) are NOT mistaken for code identifiers. A spurious 0.85 identifier anchor
 // would both satisfy the clarification gate for a vague question and seed symbol-file retrieval
@@ -195,7 +196,7 @@ function collectMatches(source, pattern, kind, weight, out) {
     let match = re.exec(source);
     while (match !== null) {
         const full = match[0];
-        const captured = match[1] ?? full;
+        const captured = match[2] ?? match[1] ?? full;
         pushAnchor(out, captured, kind, weight);
         parts.push(source.slice(cursor, match.index));
         parts.push(" ".repeat(full.length));
@@ -280,6 +281,7 @@ export function extractAnchors(input) {
     let remaining = collectMatches(text, QUOTED_DOUBLE_RE, "quoted", 1, collected);
     remaining = collectMatches(remaining, QUOTED_SINGLE_RE, "quoted", 1, collected);
     remaining = collectMatches(remaining, BACKTICK_RE, "identifier", 0.9, collected);
+    remaining = collectMatches(remaining, API_ROUTE_RE, "path", 0.95, collected);
     remaining = collectMatches(remaining, PATH_RE, "path", 0.95, collected);
     remaining = collectMatches(remaining, CAMEL_IDENTIFIER_RE, "identifier", 0.85, collected);
     remaining = collectTechnicalTerms(remaining, collected);

package/dist/planner/intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/planner/intent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAErF,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAuJD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,aAAa,GACrB,6BAA6B,CAqB/B"}
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/planner/intent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAGrF,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AA4JD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,aAAa,GACrB,6BAA6B,CAqB/B"}

package/dist/planner/intent.js

@@ -1,5 +1,6 @@
 // Deterministic retrieval-intent classification for connected-context planning.
 // This module is intentionally pure: no IO, no clock, no model calls.
+import { ecosystemMetadataIntentPatterns } from "@oscharko-dev/keiko-workspace";
 const BASIC_STOP_WORDS = new Set([
     "the",
     "and",
@@ -77,6 +78,11 @@ const PROJECT_METADATA_PATTERNS = [
     { term: "nextjs", pattern: /\bnext(?:\.js)?\b/iu },
     { term: "react", pattern: /\breact\b/iu },
     { term: "eslint", pattern: /\beslint\b/iu },
+    // Polyglot ecosystem routing is sourced from the shared registry so questions like "Which Java
+    // version does this project use?" classify as project-metadata instead of generic code search.
+    // The established JS/TS terms above stay in place for compatibility; registry duplicates are
+    // harmless because matched terms are de-duplicated before classification.
+    ...ecosystemMetadataIntentPatterns,
 ];
 const REPOSITORY_OVERVIEW_PATTERNS = [
     { term: "architecture", pattern: /\barchitecture\b|\barchitektur\b/iu },

package/dist/ranking/rank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../src/ranking/rank.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,uBAAuB,EAG7B,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AA+JD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAyB/F"}
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../src/ranking/rank.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,uBAAuB,EAG7B,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AA+JD,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CA2B/F"}

package/dist/ranking/rank.js

@@ -4,7 +4,7 @@
 // the returned diagnostics so UI/audit consumers can render zeros without conditionals.
 import { CANDIDATE_OMISSION_REASONS, isValidScopePath, } from "@oscharko-dev/keiko-contracts/connected-context";
 import { DEFAULT_FILTER_OPTIONS, filterCandidates, } from "./filter.js";
-import { DEFAULT_SCORING_WEIGHTS, computeScore } from "./scoring.js";
+import { computeScore, weightsForIntent } from "./scoring.js";
 import { DEFAULT_GENERATED_PATTERNS, extractSignals, } from "./signals.js";
 const AUTO_DUPLICATE_CLUSTER_MIN = 3;
 const AUTO_DUPLICATE_BASENAME_EXEMPTIONS = new Set([
@@ -101,7 +101,7 @@ function deriveDuplicateHints(group, explicit) {
 function buildAnnotated(group, input, hints, weights) {
     const annotated = [];
     for (const [scopePath, atomsForPath] of group) {
-        const signals = extractSignals(atomsForPath, input.anchors, hints);
+        const signals = extractSignals(atomsForPath, input.anchors, hints, input.context);
         const score = computeScore(signals, weights);
         const candidate = {
             scopePath,
@@ -139,7 +139,9 @@ export function rankCandidates(input, options = {}) {
     const startMs = clock();
     const frozenStartMs = () => startMs;
     const hints = resolveHints(input.hints);
-    const weights = options.weights ?? DEFAULT_SCORING_WEIGHTS;
+    // Explicit weights still win (existing callers/tests unaffected); otherwise the intent picks the
+    // weights — DEFAULT for non-boosted intents and the no-intent path, so behavior is unchanged there.
+    const weights = options.weights ?? weightsForIntent(input.context?.retrievalIntent);
     const { valid, invalidPaths } = groupAtomsByPath(input.atoms);
     const rankingHints = { ...hints, duplicateOf: deriveDuplicateHints(valid, hints.duplicateOf) };
     const annotated = buildAnnotated(valid, input, rankingHints, weights);

package/dist/ranking/scoring.d.ts

@@ -7,7 +7,11 @@ export interface ScoringWeights {
     readonly testPairBonus: number;
     readonly stacktracePositionBonus: number;
     readonly generatedPenalty: number;
+    readonly canonicalMetadata?: number;
+    readonly structuralEdge?: number;
 }
 export declare const DEFAULT_SCORING_WEIGHTS: ScoringWeights;
+export declare function isIntentBoosted(intent: string | undefined): boolean;
+export declare function weightsForIntent(intent: string | undefined): ScoringWeights;
 export declare function computeScore(signals: ExtractedSignals, weights?: ScoringWeights): number;
 //# sourceMappingURL=scoring.d.ts.map