@oscharko-dev/keiko-workflows 0.2.6 → 0.2.7

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

@@ -1 +1 @@
-{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/ranking/scoring.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,uBAAuB,EAAE,cAQ5B,CAAC;AAgBX,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,cAAwC,GAChD,MAAM,CAUR"}
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/ranking/scoring.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAIlC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,uBAAuB,EAAE,cAQ5B,CAAC;AAcX,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAS3E;AAkBD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,cAAwC,GAChD,MAAM,CAcR"}

package/dist/ranking/scoring.js

@@ -14,6 +14,28 @@ export const DEFAULT_SCORING_WEIGHTS = {
     stacktracePositionBonus: 0.05,
     generatedPenalty: 0.3,
 };
+// Intent-conditioned weight overrides (M4). Only the named intents receive non-default weights for
+// the new canonical-metadata / structural-edge signals; every other intent (and the no-intent
+// default path) returns DEFAULT_SCORING_WEIGHTS verbatim, so ranking is byte-identical there.
+// Weights are deliberately modest (tie-breaker magnitude) to nudge, not dominate, the established
+// provenance/anchor signals.
+const INTENT_BOOSTED = new Set([
+    "project-metadata",
+    "repository-overview",
+    "targeted-code-search",
+    "diagnostic-search",
+]);
+export function isIntentBoosted(intent) {
+    return intent !== undefined && INTENT_BOOSTED.has(intent);
+}
+export function weightsForIntent(intent) {
+    if (intent === undefined || !INTENT_BOOSTED.has(intent)) {
+        return DEFAULT_SCORING_WEIGHTS;
+    }
+    const canonicalMetadata = intent === "project-metadata" || intent === "repository-overview" ? 0.25 : 0.1;
+    const structuralEdge = intent === "targeted-code-search" || intent === "diagnostic-search" ? 0.2 : 0.1;
+    return { ...DEFAULT_SCORING_WEIGHTS, canonicalMetadata, structuralEdge };
+}
 const SIGNAL_WEIGHT_KEYS = {
     "provenance-best-score": "provenanceBestScore",
     "provenance-count": "provenanceCount",
@@ -22,6 +44,8 @@ const SIGNAL_WEIGHT_KEYS = {
     "test-pair-bonus": "testPairBonus",
     "stacktrace-position-bonus": "stacktracePositionBonus",
     "generated-penalty": "generatedPenalty",
+    "canonical-metadata": "canonicalMetadata",
+    "structural-edge": "structuralEdge",
 };
 function clampUnit(value) {
     return Math.max(0, Math.min(1, value));
@@ -33,7 +57,11 @@ export function computeScore(signals, weights = DEFAULT_SCORING_WEIGHTS) {
         if (key === undefined) {
             continue;
         }
-        raw += signal.value * weights[key];
+        const weight = weights[key];
+        if (weight === undefined) {
+            continue;
+        }
+        raw += signal.value * weight;
     }
     return clampUnit(raw);
 }

package/dist/ranking/signals.d.ts

@@ -4,6 +4,10 @@ export interface RankingInput {
     readonly atoms: readonly EvidenceAtom[];
     readonly anchors: readonly SearchAnchor[];
     readonly hints?: RankingHints;
+    readonly context?: RankingContext;
+}
+export interface RankingContext {
+    readonly retrievalIntent?: string | undefined;
 }
 export interface RankingHints {
     readonly generatedPathPatterns?: readonly string[];
@@ -16,5 +20,5 @@ export interface ExtractedSignals {
     readonly baseScore: number;
     readonly generatedHint: boolean;
 }
-export declare function extractSignals(atomsForPath: readonly EvidenceAtom[], anchors: readonly SearchAnchor[], hints: Required<RankingHints>): ExtractedSignals;
+export declare function extractSignals(atomsForPath: readonly EvidenceAtom[], anchors: readonly SearchAnchor[], hints: Required<RankingHints>, context?: RankingContext): ExtractedSignals;
 //# sourceMappingURL=signals.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/ranking/signals.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACb,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAS9C,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAyHD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,SAAS,YAAY,EAAE,EACrC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAC5B,gBAAgB,CAuBlB"}
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/ranking/signals.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACb,MAAM,iDAAiD,CAAC;AAGzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAI9B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AAUD,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAS9C,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAyHD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,SAAS,YAAY,EAAE,EACrC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,gBAAgB,CAmClB"}

package/dist/ranking/signals.js

@@ -3,6 +3,14 @@
 // maps weights to signals by NAME (see SIGNAL_WEIGHT_KEYS in scoring.ts), not by position.
 // Penalties are emitted alongside positive signals so the scorer treats them uniformly;
 // downstream code interprets values via signal names only.
+import { isCanonicalMetadataFile } from "@oscharko-dev/keiko-workspace";
+import { isIntentBoosted } from "./scoring.js";
+// True when this candidate is reachable via an inbound import edge or a test↔source pairing, derived
+// from atoms already present (the structural ring's provenance tools). No extra IO.
+const STRUCTURAL_TOOLS = new Set(["import-graph", "test-source-pairing"]);
+function hasStructuralEdge(atoms) {
+    return atoms.some((atom) => STRUCTURAL_TOOLS.has(atom.provenance.tool));
+}
 export const DEFAULT_GENERATED_PATTERNS = [
     "/dist/",
     "/build/",
@@ -119,7 +127,7 @@ function deriveScopePath(atoms) {
     const first = atoms[0];
     return first === undefined ? "" : first.scopePath;
 }
-export function extractSignals(atomsForPath, anchors, hints) {
+export function extractSignals(atomsForPath, anchors, hints, context) {
     const scopePath = deriveScopePath(atomsForPath);
     const generatedHint = detectGenerated(scopePath, hints.generatedPathPatterns);
     const provBest = computeProvenanceBestScore(atomsForPath);
@@ -129,7 +137,7 @@ export function extractSignals(atomsForPath, anchors, hints) {
     const testBonus = computeTestPairBonus(scopePath, anchors);
     const stackBonus = computeStacktracePositionBonus(scopePath, anchors);
     const penalty = generatedHint ? -1 : 0;
-    const signals = [
+    const baseSignals = [
         { name: "provenance-best-score", value: provBest },
         { name: "provenance-count", value: provCount },
         { name: "anchor-overlap", value: overlap },
@@ -138,8 +146,20 @@ export function extractSignals(atomsForPath, anchors, hints) {
         { name: "stacktrace-position-bonus", value: stackBonus },
         { name: "generated-penalty", value: penalty },
     ];
+    // M4: only a boosted intent appends the two new signals (and weightsForIntent only weights them
+    // for the same intents), so the signal vector — and therefore the pack/cache content — is
+    // byte-identical for every other intent and for callers that pass no context.
+    if (isIntentBoosted(context?.retrievalIntent)) {
+        baseSignals.push({
+            name: "canonical-metadata",
+            value: isCanonicalMetadataFile(scopePath) ? 1 : 0,
+        });
+        baseSignals.push({ name: "structural-edge", value: hasStructuralEdge(atomsForPath) ? 1 : 0 });
+    }
+    // baseScore intentionally stays over the original positive signals (it feeds nothing the new
+    // weighted score touches; the filter uses computeScore output, not baseScore).
     const positives = [provBest, provCount, overlap, depthAff, testBonus, stackBonus];
     const positiveMean = positives.reduce((acc, n) => acc + n, 0) / positives.length;
     const baseScore = clampUnit(positiveMean + penalty);
-    return { scopePath, signals, baseScore, generatedHint };
+    return { scopePath, signals: baseSignals, baseScore, generatedHint };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oscharko-dev/keiko-workflows",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "type": "module",
   "license": "Apache-2.0",
   "description": "Internal workflows package: reviewable developer-assist workflows (unit-test generation, bug investigation), prompts/parsers/guards/report rendering, apply-mode verification gating, and UI descriptors (ADR-0008 + ADR-0009 + ADR-0019). Not published independently.",
@@ -25,14 +25,14 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@oscharko-dev/keiko-contracts": "0.2.6",
-    "@oscharko-dev/keiko-security": "0.2.6",
-    "@oscharko-dev/keiko-model-gateway": "0.2.6",
-    "@oscharko-dev/keiko-workspace": "0.2.6",
-    "@oscharko-dev/keiko-tools": "0.2.6",
-    "@oscharko-dev/keiko-evidence": "0.2.6",
-    "@oscharko-dev/keiko-verification": "0.2.6",
-    "@oscharko-dev/keiko-harness": "0.2.6",
-    "@oscharko-dev/keiko-quality-intelligence": "0.2.6"
+    "@oscharko-dev/keiko-contracts": "0.2.7",
+    "@oscharko-dev/keiko-security": "0.2.7",
+    "@oscharko-dev/keiko-model-gateway": "0.2.7",
+    "@oscharko-dev/keiko-workspace": "0.2.7",
+    "@oscharko-dev/keiko-tools": "0.2.7",
+    "@oscharko-dev/keiko-evidence": "0.2.7",
+    "@oscharko-dev/keiko-verification": "0.2.7",
+    "@oscharko-dev/keiko-harness": "0.2.7",
+    "@oscharko-dev/keiko-quality-intelligence": "0.2.7"
   }
 }