@oscharko-dev/keiko 0.2.0-beta.7 → 0.2.0-beta.9

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/anchors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/planner/anchors.ts"],"names":[],"mappings":"AAqKA,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;AA2FD,wBAAgB,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CAkBnF"}
+{"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"}

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/anchors.js

@@ -158,7 +158,30 @@ 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;
+// 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
+// with a non-symbol — see planner/plan.ts decideClarification and grounded symbolFileAnchorTerms.
+const CAMEL_IDENTIFIER_RE = /\b([A-Za-z_$][A-Za-z0-9_$]*[a-z0-9][A-Z][A-Za-z0-9_$]*)\b/g;
 const TOKEN_SPLIT_RE = /[^A-Za-z0-9_.]+/;
+const TECHNICAL_TERM_PATTERNS = [
+    { pattern: /\btype[\s_-]?script\b/gi, term: "typescript" },
+    { pattern: /\bjava[\s_-]?script\b/gi, term: "javascript" },
+    { pattern: /\bnode(?:\.js)?\b/gi, term: "node" },
+    { pattern: /\bnext(?:\.js)?\b/gi, term: "nextjs" },
+    { pattern: /\bpackage\.json\b/gi, term: "package.json" },
+    { pattern: /\bpackage[\s_-]?manager\b/gi, term: "package-manager" },
+    { pattern: /\btsconfig(?:\.[a-z0-9]+)?\b/gi, term: "tsconfig" },
+    { pattern: /\bvitest\b/gi, term: "vitest" },
+    { pattern: /\bvite\b/gi, term: "vite" },
+    { pattern: /\bplaywright\b/gi, term: "playwright" },
+    { pattern: /\bjest\b/gi, term: "jest" },
+    { pattern: /\bcypress\b/gi, term: "cypress" },
+    { pattern: /\breact\b/gi, term: "react" },
+    { pattern: /\bnpm\b/gi, term: "npm" },
+    { pattern: /\bpnpm\b/gi, term: "pnpm" },
+    { pattern: /\byarn\b/gi, term: "yarn" },
+];
 function pushAnchor(out, raw, kind, weight) {
     const term = raw.trim().toLowerCase();
     if (term.length > 0) {
@@ -182,6 +205,26 @@ function collectMatches(source, pattern, kind, weight, out) {
     parts.push(source.slice(cursor));
     return parts.join("");
 }
+function collectTechnicalTerms(source, out) {
+    let remaining = source;
+    for (const entry of TECHNICAL_TERM_PATTERNS) {
+        const re = new RegExp(entry.pattern.source, entry.pattern.flags);
+        const parts = [];
+        let cursor = 0;
+        let match = re.exec(remaining);
+        while (match !== null) {
+            const full = match[0];
+            pushAnchor(out, entry.term, "identifier", 0.85);
+            parts.push(remaining.slice(cursor, match.index));
+            parts.push(" ".repeat(full.length));
+            cursor = match.index + full.length;
+            match = re.exec(remaining);
+        }
+        parts.push(remaining.slice(cursor));
+        remaining = parts.join("");
+    }
+    return remaining;
+}
 function tokenizeRemaining(remaining, out) {
     let considered = 0;
     for (const raw of remaining.split(TOKEN_SPLIT_RE)) {
@@ -238,6 +281,8 @@ export function extractAnchors(input) {
     remaining = collectMatches(remaining, QUOTED_SINGLE_RE, "quoted", 1, collected);
     remaining = collectMatches(remaining, BACKTICK_RE, "identifier", 0.9, collected);
     remaining = collectMatches(remaining, PATH_RE, "path", 0.95, collected);
+    remaining = collectMatches(remaining, CAMEL_IDENTIFIER_RE, "identifier", 0.85, collected);
+    remaining = collectTechnicalTerms(remaining, collected);
     const tokensConsidered = tokenizeRemaining(remaining, collected);
     const merged = sortAnchors(dedup(collected));
     const truncated = merged.length > maxAnchors;

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/index.d.ts

@@ -1,5 +1,7 @@
 export type { AnchorExtractionInput, AnchorExtractionResult, SearchAnchor, SearchAnchorKind, } from "./anchors.js";
 export { extractAnchors } from "./anchors.js";
+export type { RetrievalIntent, RetrievalIntentClassification } from "./intent.js";
+export { classifyRetrievalIntent } from "./intent.js";
 export type { ClarificationPrompt, ClarificationReason, CreatePlanDeps, CreatePlanInput, ExplorationPlan, ExplorationPlanState, RetrievalRing, RetrievalRingKind, } from "./plan.js";
 export { createExplorationPlan } from "./plan.js";
 export type { GovernorState, GovernorStatus } from "./governor.js";

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planner/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/F,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planner/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/F,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/index.js

@@ -2,6 +2,7 @@
 // External consumers import every planner symbol through this module; internal modules
 // (anchors.ts, plan.ts, governor.ts, explorationPlanner.ts) are implementation detail.
 export { extractAnchors } from "./anchors.js";
+export { classifyRetrievalIntent } from "./intent.js";
 export { createExplorationPlan } from "./plan.js";
 export { advanceRing, applyUsage, canContinue, complete, createGovernor } from "./governor.js";
 export { planAndGovern, planExploration } from "./explorationPlanner.js";

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/intent.d.ts

@@ -0,0 +1,8 @@
+import type { SelectedScope } from "@oscharko-dev/keiko-contracts/connected-context";
+export type RetrievalIntent = "project-metadata" | "repository-overview" | "targeted-code-search" | "diagnostic-search" | "clarification-needed";
+export interface RetrievalIntentClassification {
+    readonly intent: RetrievalIntent;
+    readonly normalizedTerms: readonly string[];
+}
+export declare function classifyRetrievalIntent(queryText: string, _scope?: SelectedScope): RetrievalIntentClassification;
+//# sourceMappingURL=intent.d.ts.map

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/intent.d.ts.map

@@ -0,0 +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"}

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/intent.js

@@ -0,0 +1,140 @@
+// Deterministic retrieval-intent classification for connected-context planning.
+// This module is intentionally pure: no IO, no clock, no model calls.
+const BASIC_STOP_WORDS = new Set([
+    "the",
+    "and",
+    "for",
+    "of",
+    "in",
+    "on",
+    "at",
+    "to",
+    "a",
+    "an",
+    "is",
+    "are",
+    "was",
+    "were",
+    "be",
+    "been",
+    "being",
+    "do",
+    "does",
+    "did",
+    "how",
+    "why",
+    "what",
+    "which",
+    "where",
+    "when",
+    "who",
+    "das",
+    "dass",
+    "der",
+    "die",
+    "ein",
+    "eine",
+    "einer",
+    "einem",
+    "einen",
+    "ist",
+    "sind",
+    "und",
+    "oder",
+    "welche",
+    "welcher",
+    "welches",
+    "welchen",
+    "wie",
+    "wo",
+    "wird",
+    "werden",
+    "zu",
+]);
+const PROJECT_METADATA_PATTERNS = [
+    { term: "typescript", pattern: /\btype[\s_-]?script\b/iu },
+    { term: "javascript", pattern: /\bjava[\s_-]?script\b/iu },
+    { term: "node", pattern: /\bnode(?:\.js)?\b/iu },
+    { term: "package-json", pattern: /\bpackage\.json\b/iu },
+    { term: "package-manager", pattern: /\bpackage[\s_-]?manager\b/iu },
+    { term: "package-manager", pattern: /\bpaket[\s_-]?manager\b/iu },
+    { term: "tsconfig", pattern: /\btsconfig(?:\.[a-z0-9]+)?\b/iu },
+    { term: "dependency", pattern: /\bdevdependencies\b|\bdependencies\b|\bdependency\b/iu },
+    { term: "dependency", pattern: /\babhaengigkeit(?:en)?\b|\babhängigkeit(?:en)?\b/iu },
+    { term: "script", pattern: /\bscripts?\b|\bskripte?\b/iu },
+    { term: "version", pattern: /\bversion(?:en)?\b/iu },
+    { term: "framework", pattern: /\bframeworks?\b/iu },
+    { term: "test-runner", pattern: /\btest[\s_-]?runner\b|\btestumgebung\b/iu },
+    { term: "build", pattern: /\bbuild\b|\bgebaut\b|\bbauen\b/iu },
+    { term: "npm", pattern: /\bnpm\b/iu },
+    { term: "pnpm", pattern: /\bpnpm\b/iu },
+    { term: "yarn", pattern: /\byarn\b/iu },
+    { term: "vite", pattern: /\bvite\b/iu },
+    { term: "vitest", pattern: /\bvitest\b/iu },
+    { term: "jest", pattern: /\bjest\b/iu },
+    { term: "playwright", pattern: /\bplaywright\b/iu },
+    { term: "cypress", pattern: /\bcypress\b/iu },
+    { term: "nextjs", pattern: /\bnext(?:\.js)?\b/iu },
+    { term: "react", pattern: /\breact\b/iu },
+    { term: "eslint", pattern: /\beslint\b/iu },
+];
+const REPOSITORY_OVERVIEW_PATTERNS = [
+    { term: "architecture", pattern: /\barchitecture\b|\barchitektur\b/iu },
+    { term: "overview", pattern: /\boverview\b|\bueberblick\b|\büberblick\b/iu },
+    { term: "structure", pattern: /\bstructure\b|\bstruktur\b|\baufbau\b/iu },
+    { term: "repository", pattern: /\brepository\b|\brepo\b|\bcodebase\b/iu },
+    { term: "modules", pattern: /\bmodules?\b|\bmodule\b|\bpakete\b|\bpackages\b/iu },
+    { term: "components", pattern: /\bcomponents?\b|\bkomponenten\b/iu },
+];
+const DIAGNOSTIC_PATTERNS = [
+    { term: "error", pattern: /\berror\b|\bfehler\b|\bexception\b|\btraceback\b/iu },
+    { term: "stacktrace", pattern: /\bstack[\s_-]?trace\b|\bstacktrace\b/iu },
+    { term: "failure", pattern: /\bfail(?:ed|ing|ure)?\b|\bscheitert\b|\bkaputt\b/iu },
+    { term: "bug", pattern: /\bbug\b|\bdefect\b|\bregression\b/iu },
+    { term: "http-status", pattern: /\b[45]\d{2}\b|\bhttp\b/iu },
+];
+const TARGETED_CODE_PATTERNS = [
+    { term: "path", pattern: /(?:[\w.-]+\/)+[\w.-]+/u },
+    { term: "quoted", pattern: /"[^"\n]+"|'[^'\n]+'|`[^`\n]+`/u },
+    { term: "identifier", pattern: /\b[A-Za-z_$][A-Za-z0-9_$]*[A-Z][A-Za-z0-9_$]*\b/u },
+    { term: "symbol", pattern: /\b(function|class|interface|type|const|let|var)\s+[A-Za-z_]/iu },
+];
+function normalizeQueryText(queryText) {
+    return queryText.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase();
+}
+function searchableTokens(normalized) {
+    return (normalized
+        .split(/[^a-z0-9_.-]+/u)
+        .filter((token) => token.length >= 3 && !BASIC_STOP_WORDS.has(token))
+        // `.`, `-` and `_` are kept inside tokens (so `package.json`/`tsconfig.base` survive), but a
+        // token built only from those separators (e.g. `...`, `--`, `__`) is not searchable. Require at
+        // least one alphanumeric character so a pure-punctuation prompt resolves to clarification-needed.
+        .filter((token) => /[a-z0-9]/u.test(token)));
+}
+function matchedTerms(queryText, normalized, patterns) {
+    const terms = new Set();
+    for (const entry of patterns) {
+        if (entry.pattern.test(queryText) || entry.pattern.test(normalized)) {
+            terms.add(entry.term);
+        }
+    }
+    return [...terms].sort();
+}
+function classifyByPatterns(queryText, normalized, patterns, intent) {
+    const terms = matchedTerms(queryText, normalized, patterns);
+    return terms.length === 0 ? undefined : { intent, normalizedTerms: terms };
+}
+export function classifyRetrievalIntent(queryText, _scope) {
+    const trimmed = queryText.trim();
+    const normalized = normalizeQueryText(trimmed);
+    if (trimmed.length === 0 || searchableTokens(normalized).length === 0) {
+        return { intent: "clarification-needed", normalizedTerms: [] };
+    }
+    return (classifyByPatterns(trimmed, normalized, PROJECT_METADATA_PATTERNS, "project-metadata") ??
+        classifyByPatterns(trimmed, normalized, DIAGNOSTIC_PATTERNS, "diagnostic-search") ??
+        classifyByPatterns(trimmed, normalized, TARGETED_CODE_PATTERNS, "targeted-code-search") ??
+        classifyByPatterns(trimmed, normalized, REPOSITORY_OVERVIEW_PATTERNS, "repository-overview") ?? {
+        intent: "targeted-code-search",
+        normalizedTerms: searchableTokens(normalized).slice(0, 8),
+    });
+}

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/plan.d.ts

@@ -1,6 +1,7 @@
 import { CONNECTED_CONTEXT_SCHEMA_VERSION, type ExplorationBudget, type RetrievalQuery, type SelectedScope } from "@oscharko-dev/keiko-contracts/connected-context";
 import type { SearchLimits } from "@oscharko-dev/keiko-workspace";
 import { type SearchAnchor } from "./anchors.js";
+import { type RetrievalIntent } from "./intent.js";
 export type ExplorationPlanState = "ready" | "completed" | "budget-exhausted" | "clarification-needed" | "scope-invalid";
 export type RetrievalRingKind = "lexical" | "structural" | "git-history";
 export interface RetrievalRing {
@@ -20,6 +21,7 @@ export interface ExplorationPlan {
     readonly schemaVersion: typeof CONNECTED_CONTEXT_SCHEMA_VERSION;
     readonly planId: string;
     readonly state: ExplorationPlanState;
+    readonly retrievalIntent: RetrievalIntent;
     readonly scope: SelectedScope;
     readonly query: RetrievalQuery;
     readonly anchors: readonly SearchAnchor[];

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/planner/plan.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gCAAgC,EAGhC,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAkB,KAAK,YAAY,EAAyB,MAAM,cAAc,CAAC;AAQxF,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,WAAW,GACX,kBAAkB,GAClB,sBAAsB,GACtB,eAAe,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;AAEjG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAwPD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,IAAI,CAAC,EAAE,cAAc,GACpB,eAAe,CAkCjB"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/planner/plan.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gCAAgC,EAGhC,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAkB,KAAK,YAAY,EAAyB,MAAM,cAAc,CAAC;AACxF,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,aAAa,CAAC;AAQrB,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,WAAW,GACX,kBAAkB,GAClB,sBAAsB,GACtB,eAAe,CAAC;AAEpB,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;AAEjG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,gCAAgC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AA2QD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,IAAI,CAAC,EAAE,cAAc,GACpB,eAAe,CAqCjB"}

package/node_modules/@oscharko-dev/keiko-workflows/dist/planner/plan.js

@@ -5,6 +5,7 @@
 import { createHash } from "node:crypto";
 import { CONNECTED_CONTEXT_SCHEMA_VERSION, DEFAULT_EXPLORATION_BUDGET, validateSelectedScope, } from "@oscharko-dev/keiko-contracts/connected-context";
 import { extractAnchors } from "./anchors.js";
+import { classifyRetrievalIntent, } from "./intent.js";
 // ─── Constants ────────────────────────────────────────────────────────────────
 const DEFAULT_MAX_ANCHORS = 8;
 const RING_WEIGHTS = {
@@ -112,7 +113,16 @@ function maxAnchorWeight(anchors) {
 function buildClarification(reason, suggestedQuestions, minimumAnchorCount) {
     return { reason, suggestedQuestions, minimumAnchorCount };
 }
-function decideClarification(anchors, scope) {
+function explicitConnectionIsReady(scope, intent) {
+    if (scope.explicitConnection !== true) {
+        return false;
+    }
+    if (scope.kind !== "workspace-root") {
+        return true;
+    }
+    return intent === "project-metadata" || intent === "repository-overview";
+}
+function decideClarification(anchors, scope, intent) {
     if (anchors.length === 0) {
         return {
             state: "clarification-needed",
@@ -123,7 +133,7 @@ function decideClarification(anchors, scope) {
     // pill), they have already narrowed the search to a bounded area. The "too-generic" and
     // "scope-empty" gates exist to stop vague questions burning budget over the broad workspace;
     // keep those gates for workspace-root connections even when they were explicitly selected.
-    if (scope.explicitConnection === true && scope.kind !== "workspace-root") {
+    if (explicitConnectionIsReady(scope, intent)) {
         return { state: "ready", clarification: undefined };
     }
     // Threshold is <= literal weight so a prompt yielding only `literal` anchors (weight 0.5,
@@ -148,6 +158,7 @@ function canonicalize(seed) {
         seed.scopeId,
         seed.queryKind,
         seed.queryText,
+        seed.retrievalIntent,
         [...seed.anchorTerms].sort(),
         [...seed.ringKinds].sort(),
     ]);
@@ -163,12 +174,13 @@ function resolveInputs(input, deps) {
         nowMs: deps?.nowMs ?? Date.now,
     };
 }
-function buildScopeInvalidPlan(input, resolved) {
+function buildScopeInvalidPlan(input, resolved, classification) {
     const clarification = buildClarification("scope-invalid", SCOPE_INVALID_QUESTIONS, 0);
     const seed = {
         scopeId: input.scope.scopeId,
         queryKind: input.query.kind,
         queryText: input.query.text,
+        retrievalIntent: classification.intent,
         anchorTerms: [],
         ringKinds: [],
     };
@@ -176,6 +188,7 @@ function buildScopeInvalidPlan(input, resolved) {
         schemaVersion: CONNECTED_CONTEXT_SCHEMA_VERSION,
         planId: derivePlanId(seed),
         state: "scope-invalid",
+        retrievalIntent: classification.intent,
         scope: input.scope,
         query: input.query,
         anchors: [],
@@ -187,15 +200,16 @@ function buildScopeInvalidPlan(input, resolved) {
 }
 export function createExplorationPlan(input, deps) {
     const resolved = resolveInputs(input, deps);
+    const classification = classifyRetrievalIntent(input.query.text, input.scope);
     const scopeResult = validateSelectedScope(input.scope);
     if (!scopeResult.ok) {
-        return buildScopeInvalidPlan(input, resolved);
+        return buildScopeInvalidPlan(input, resolved, classification);
     }
     const extraction = extractAnchors({
         text: input.query.text,
         maxAnchors: resolved.maxAnchors,
     });
-    const decision = decideClarification(extraction.anchors, input.scope);
+    const decision = decideClarification(extraction.anchors, input.scope, classification.intent);
     const rings = decision.state === "ready"
         ? composeRings(extraction.anchors, input.scope, resolved.budget)
         : [];
@@ -203,6 +217,7 @@ export function createExplorationPlan(input, deps) {
         scopeId: input.scope.scopeId,
         queryKind: input.query.kind,
         queryText: input.query.text,
+        retrievalIntent: classification.intent,
         anchorTerms: extraction.anchors.map((a) => a.term),
         ringKinds: rings.map((r) => r.kind),
     };
@@ -210,6 +225,7 @@ export function createExplorationPlan(input, deps) {
         schemaVersion: CONNECTED_CONTEXT_SCHEMA_VERSION,
         planId: derivePlanId(seed),
         state: decision.state,
+        retrievalIntent: classification.intent,
         scope: input.scope,
         query: input.query,
         anchors: extraction.anchors,

package/node_modules/@oscharko-dev/keiko-workflows/dist/qualityIntelligence/modelRoutedTestDesign.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modelRoutedTestDesign.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/modelRoutedTestDesign.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"modelRoutedTestDesign.d.ts","sourceRoot":"","sources":["../../src/qualityIntelligence/modelRoutedTestDesign.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,IAAI,EAAE,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAcL,KAAK,aAAa,EACnB,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAcL,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAEnC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAG1E,KAAK,SAAS,GAAG,EAAE,CAAC,oCAAoC,CAAC;AACzD,KAAK,YAAY,GAAG,EAAE,CAAC,+BAA+B,CAAC;AAEvD,+FAA+F;AAC/F,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,6FAA6F;IAC7F,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oGAAoG;IACpG,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAChE;AAED,kGAAkG;AAClG,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,CACjB,IAAI,EAAE,qCAAqC,KACxC,OAAO,CAAC,uCAAuC,CAAC,CAAC;CACvD;AAED,wFAAwF;AACxF,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,SAAS,qCAAqC,EAAE,CAAC;CAC1E;AAED,MAAM,WAAW,8BAA+B,SAAQ,EAAE,CAAC,uBAAuB;IAChF;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAaD,0GAA0G;AAC1G,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,CACd,KAAK,EAAE,6BAA6B,EACpC,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,iCAAiC,EAAE,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACnE,QAAQ,CAAC,cAAc,EAAE,iCAAiC,CAAC;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,4CAA4C;IAC3D,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,iCAAiC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3D,kGAAkG;IAClG,QAAQ,CAAC,KAAK,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,iCAAiC,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,gCAAgC,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;CAChF;AA4DD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,SAAS,+BAA+B,EAAE,GACxD,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7B;AAomBD;;;;GAIG;AAEH,wBAAsB,2CAA2C,CAC/D,KAAK,EAAE,6CAA6C,EACpD,IAAI,EAAE,4CAA4C,GACjD,OAAO,CAAC,6BAA6B,CAAC,CAqIxC"}