@principles/core 1.73.0

package/dist/prompt-builder/principle-selection.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Budget-Aware Principle Selection
+ *
+ * Phase: PRI-75 Prompt Injection SDK Migration Phase 2
+ *
+ * Pure functions for selecting and formatting principles within a character budget.
+ * No I/O dependencies — suitable for any host.
+ */
+import type { PrinciplePriority } from '../runtime-v2/types/principle-enums.js';
+/**
+ * Minimal principle shape required for injection selection.
+ * Accepts both evolution-types.Principle and principle-tree-schema.Principle.
+ */
+export interface InjectablePrinciple {
+    id: string;
+    text: string;
+    /** Priority level. Defaults to 'P1' if not set by the source. */
+    priority?: PrinciplePriority;
+    /** ISO date string. Required for recency ordering in selectPrinciplesForInjection. */
+    createdAt: string;
+}
+/**
+ * Result of principle selection for injection.
+ */
+export interface PrincipleSelectionResult {
+    /** Selected principles in injection order (priority-first, then recency) */
+    selected: InjectablePrinciple[];
+    /** Total character count of selected principles' formatted output */
+    totalChars: number;
+    /** Number of principles by priority tier */
+    breakdown: {
+        p0: number;
+        p1: number;
+        p2: number;
+    };
+    /** Whether at least one P0 principle was included */
+    hasP0: boolean;
+    /** Whether the selection was truncated due to budget */
+    wasTruncated: boolean;
+}
+/**
+ * Format a single principle for injection.
+ * Returns the formatted string including ID and text.
+ *
+ * Format: "- [ID] text" (matches existing prompt.ts format)
+ */
+export declare function formatPrinciple(p: InjectablePrinciple): string;
+/**
+ * Select principles for prompt injection within a character budget.
+ *
+ * Algorithm:
+ *  1. Sort all principles by priority (P0 > P1 > P2), then by recency
+ *  2. Iterate through sorted principles, accumulating character count
+ *  3. Stop when adding the next principle would exceed budgetChars
+ *  4. Ensure at least one P0 principle is included (even if it exceeds budget)
+ *
+ * @param principles - All available principles to select from
+ * @param budgetChars - Maximum character budget for formatted output
+ * @returns Selection result with chosen principles and metadata
+ */
+export declare function selectPrinciplesForInjection(principles: InjectablePrinciple[], budgetChars: number): PrincipleSelectionResult;
+/**
+ * Default character budget for principle injection.
+ * 4000 characters is ~800 tokens, leaving ample room for other prompt sections
+ * within the 10K character injection limit.
+ */
+export declare const DEFAULT_PRINCIPLE_BUDGET = 4000;
+//# sourceMappingURL=principle-selection.d.ts.map

package/dist/prompt-builder/principle-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"principle-selection.d.ts","sourceRoot":"","sources":["../../src/prompt-builder/principle-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAMhF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,YAAY,EAAE,OAAO,CAAC;CACvB;AAmCD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAE9D;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,mBAAmB,EAAE,EACjC,WAAW,EAAE,MAAM,GAClB,wBAAwB,CAwE1B;AAMD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC"}

package/dist/prompt-builder/principle-selection.js

@@ -0,0 +1,140 @@
+/**
+ * Budget-Aware Principle Selection
+ *
+ * Phase: PRI-75 Prompt Injection SDK Migration Phase 2
+ *
+ * Pure functions for selecting and formatting principles within a character budget.
+ * No I/O dependencies — suitable for any host.
+ */
+// ---------------------------------------------------------------------------
+// Priority Ordering
+// ---------------------------------------------------------------------------
+const PRIORITY_ORDER = {
+    P0: 0,
+    P1: 1,
+    P2: 2,
+};
+/**
+ * Compare two principles for sorting.
+ * Primary: priority (P0 < P1 < P2 — lower is higher priority).
+ * Secondary: recency (newer createdAt first).
+ */
+function comparePrinciples(a, b) {
+    const INVALID_PRIORITY_RANK = 99;
+    const priorityA = PRIORITY_ORDER[a.priority ?? 'P1'] ?? INVALID_PRIORITY_RANK;
+    const priorityB = PRIORITY_ORDER[b.priority ?? 'P1'] ?? INVALID_PRIORITY_RANK;
+    if (priorityA !== priorityB) {
+        return priorityA - priorityB;
+    }
+    // Same priority: sort by recency (newer first)
+    // Date.parse is robust to non-ISO-8601 formats unlike localeCompare on raw strings
+    return Date.parse(b.createdAt) - Date.parse(a.createdAt);
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format a single principle for injection.
+ * Returns the formatted string including ID and text.
+ *
+ * Format: "- [ID] text" (matches existing prompt.ts format)
+ */
+export function formatPrinciple(p) {
+    return `- [${p.id}] ${p.text}`;
+}
+/**
+ * Calculate the character length of a formatted principle, including newline.
+ */
+function formattedLength(p) {
+    return formatPrinciple(p).length + 1; // +1 for newline separator
+}
+// ---------------------------------------------------------------------------
+// Selection Algorithm
+// ---------------------------------------------------------------------------
+/**
+ * Select principles for prompt injection within a character budget.
+ *
+ * Algorithm:
+ *  1. Sort all principles by priority (P0 > P1 > P2), then by recency
+ *  2. Iterate through sorted principles, accumulating character count
+ *  3. Stop when adding the next principle would exceed budgetChars
+ *  4. Ensure at least one P0 principle is included (even if it exceeds budget)
+ *
+ * @param principles - All available principles to select from
+ * @param budgetChars - Maximum character budget for formatted output
+ * @returns Selection result with chosen principles and metadata
+ */
+export function selectPrinciplesForInjection(principles, budgetChars) {
+    if (principles.length === 0) {
+        return {
+            selected: [],
+            totalChars: 0,
+            breakdown: { p0: 0, p1: 0, p2: 0 },
+            hasP0: false,
+            wasTruncated: false,
+        };
+    }
+    // Sort by priority then recency
+    const sorted = [...principles].sort(comparePrinciples);
+    const selected = [];
+    let totalChars = 0;
+    let p0Included = false;
+    let wasTruncated = false;
+    for (const principle of sorted) {
+        const cost = formattedLength(principle);
+        // Check if adding this principle would exceed budget
+        if (totalChars + cost > budgetChars) {
+            // Special case: if no P0 has been included yet, force-include the first P0
+            // even if it exceeds the budget (P0 principles are critical)
+            if (!p0Included && principle.priority === 'P0') {
+                selected.push(principle);
+                totalChars += cost;
+                p0Included = true;
+                wasTruncated = true;
+                // Continue to try to fit more principles after this forced inclusion
+                continue;
+            }
+            wasTruncated = true;
+            // Continue evaluating remaining principles — a smaller one that fits may exist
+            continue;
+        }
+        selected.push(principle);
+        totalChars += cost;
+        if (principle.priority === 'P0') {
+            p0Included = true;
+        }
+    }
+    // Safety net: if we went through all principles and still no P0 included
+    // (because P0 was beyond budget threshold), force-include the first P0
+    if (!p0Included) {
+        const firstP0 = sorted.find(p => p.priority === 'P0');
+        if (firstP0 && !selected.includes(firstP0)) {
+            // Insert P0 at the beginning of selected (highest priority)
+            selected.unshift(firstP0);
+            totalChars += formattedLength(firstP0);
+            p0Included = true;
+        }
+    }
+    const breakdown = {
+        p0: selected.filter(p => (p.priority ?? 'P1') === 'P0').length,
+        p1: selected.filter(p => (p.priority ?? 'P1') === 'P1').length,
+        p2: selected.filter(p => (p.priority ?? 'P1') === 'P2').length,
+    };
+    return {
+        selected,
+        totalChars,
+        breakdown,
+        hasP0: p0Included,
+        wasTruncated,
+    };
+}
+// ---------------------------------------------------------------------------
+// Default Budget
+// ---------------------------------------------------------------------------
+/**
+ * Default character budget for principle injection.
+ * 4000 characters is ~800 tokens, leaving ample room for other prompt sections
+ * within the 10K character injection limit.
+ */
+export const DEFAULT_PRINCIPLE_BUDGET = 4000;
+//# sourceMappingURL=principle-selection.js.map

package/dist/prompt-builder/principle-selection.js.map

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

package/dist/prompt-builder/routing-guidance.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Routing Guidance — Task Classification Pure Logic
+ *
+ * Phase: PRI-74 Routing Guidance Migration (follow-up to PRI-75 Prompt Injection SDK Migration)
+ *
+ * Pure functions for classifying task intent and building routing guidance.
+ * No I/O dependencies — suitable for any host.
+ * The full classifyTask() with stateDir I/O lives in the plugin.
+ */
+/**
+ * The input contract for a routing decision.
+ * All fields are optional — the classifier handles missing data gracefully.
+ */
+export interface RoutingInput {
+    taskIntent?: string;
+    taskDescription?: string;
+    /** @deprecated Not used by classifyTaskKind; reserved for future extensions. */
+    requestedTools?: string[];
+    requestedFiles?: string[];
+    expectedOutputShape?: string;
+    complexityHints?: string[];
+    targetProfile?: 'local-reader' | 'local-editor';
+}
+/**
+ * Classification categories from classifyTaskKind.
+ * The full RoutingDecision includes I/O fields (deploymentCheck, etc.)
+ * that belong to the plugin layer.
+ */
+export type RoutingClassification = 'reader_eligible' | 'editor_eligible' | 'high_entropy_disallowed' | 'ambiguous_scope' | 'profile_mismatch' | 'deployment_unavailable';
+/**
+ * Keywords that indicate a task is suitable for `local-reader`.
+ */
+export declare const READER_KEYWORDS: readonly ["read", "view", "show", "get", "find", "search", "grep", "look", "inspect", "examine", "list", "cat", "head", "tail", "diff", "summary", "summarize", "extract", "parse", "review", "check", "verify", "status", "describe", "explain_what", "browse", "fetch", "show_content", "file_content", "code_read"];
+/**
+ * Keywords that indicate a task is suitable for `local-editor`.
+ */
+export declare const EDITOR_KEYWORDS: readonly ["edit", "update", "modify", "change", "fix", "patch", "replace", "add", "remove", "delete", "insert", "rewrite", "refactor", "apply", "execute", "run", "transform", "convert", "migrate", "write", "create_file", "append", "touch", "rename"];
+/**
+ * Keywords that indicate HIGH ENTROPY — tasks that must stay on main agent.
+ */
+export declare const HIGH_ENTROPY_KEYWORDS: readonly ["design", "architect", "plan", "strategy", "roadmap", "propose", "research", "investigate", "explore", "evaluate", "compare", "decide", "choose", "recommend", "suggest", "analyze_tradeoffs", "unclear", "vague", "ambiguous", "open_ended", "multiple_options", "architecture", "system_design", "high_level", "blueprint", "thinking", "reasoning", "思考", "分析", "设计"];
+/**
+ * Simple case-insensitive keyword match.
+ */
+export declare function containsKeyword(text: string | undefined, keywords: readonly string[]): boolean;
+/**
+ * Compute a combined text from all input fields for keyword scanning.
+ */
+export declare function computeCombinedText(input: RoutingInput): string;
+/**
+ * Classify the task based on its input fields.
+ * Returns a raw classification category (before deployment check).
+ * This is a pure function — no I/O, no stateDir.
+ */
+export declare function classifyTaskKind(input: RoutingInput): RoutingClassification;
+/**
+ * Build the reason string for a given classification.
+ */
+export declare function buildReason(classification: RoutingClassification, input: RoutingInput): string;
+/**
+ * Build the blockers list for a given classification.
+ */
+export declare function buildBlockers(classification: RoutingClassification, input: RoutingInput): string[];
+//# sourceMappingURL=routing-guidance.d.ts.map

package/dist/prompt-builder/routing-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-guidance.d.ts","sourceRoot":"","sources":["../../src/prompt-builder/routing-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC;CACjD;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,wBAAwB,CAAC;AAM7B;;GAEG;AACH,eAAO,MAAM,eAAe,wTAMlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,2PAKlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,qBAAqB,oXAOxB,CAAC;AAiBX;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAO/D;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,qBAAqB,CA0D3E;AAMD;;GAEG;AACH,wBAAgB,WAAW,CACzB,cAAc,EAAE,qBAAqB,EACrC,KAAK,EAAE,YAAY,GAClB,MAAM,CA4CR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,cAAc,EAAE,qBAAqB,EACrC,KAAK,EAAE,YAAY,GAClB,MAAM,EAAE,CA6CV"}

package/dist/prompt-builder/routing-guidance.js

@@ -0,0 +1,227 @@
+/**
+ * Routing Guidance — Task Classification Pure Logic
+ *
+ * Phase: PRI-74 Routing Guidance Migration (follow-up to PRI-75 Prompt Injection SDK Migration)
+ *
+ * Pure functions for classifying task intent and building routing guidance.
+ * No I/O dependencies — suitable for any host.
+ * The full classifyTask() with stateDir I/O lives in the plugin.
+ */
+// ---------------------------------------------------------------------------
+// Keyword Sets
+// ---------------------------------------------------------------------------
+/**
+ * Keywords that indicate a task is suitable for `local-reader`.
+ */
+export const READER_KEYWORDS = [
+    'read', 'view', 'show', 'get', 'find', 'search', 'grep', 'look',
+    'inspect', 'examine', 'list', 'cat', 'head', 'tail', 'diff',
+    'summary', 'summarize', 'extract', 'parse', 'review',
+    'check', 'verify', 'status', 'describe', 'explain_what',
+    'browse', 'fetch', 'show_content', 'file_content', 'code_read',
+];
+/**
+ * Keywords that indicate a task is suitable for `local-editor`.
+ */
+export const EDITOR_KEYWORDS = [
+    'edit', 'update', 'modify', 'change', 'fix', 'patch', 'replace',
+    'add', 'remove', 'delete', 'insert', 'rewrite', 'refactor',
+    'apply', 'execute', 'run', 'transform', 'convert', 'migrate',
+    'write', 'create_file', 'append', 'touch', 'rename',
+];
+/**
+ * Keywords that indicate HIGH ENTROPY — tasks that must stay on main agent.
+ */
+export const HIGH_ENTROPY_KEYWORDS = [
+    'design', 'architect', 'plan', 'strategy', 'roadmap', 'propose',
+    'research', 'investigate', 'explore', 'evaluate', 'compare',
+    'decide', 'choose', 'recommend', 'suggest', 'analyze_tradeoffs',
+    'unclear', 'vague', 'ambiguous', 'open_ended', 'multiple_options',
+    'architecture', 'system_design', 'high_level', 'blueprint',
+    'thinking', 'reasoning', '思考', '分析', '设计',
+];
+/**
+ * Complexity hint values that trigger high_entropy_disallowed.
+ * Extracted to a constant to keep classifyTaskKind readable.
+ */
+const COMPLEXITY_HINTS = ['multi_step', 'cross_file', 'ambiguous', 'requires_planning', 'open_ended', 'unclear'];
+/**
+ * Maximum number of files for a bounded edit before it becomes high-entropy.
+ */
+const MAX_BOUNDED_EDIT_FILES = 4;
+// ---------------------------------------------------------------------------
+// Keyword Matching Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Simple case-insensitive keyword match.
+ */
+export function containsKeyword(text, keywords) {
+    if (!text)
+        return false;
+    const lower = text.toLowerCase();
+    return keywords.some((kw) => lower.includes(kw));
+}
+/**
+ * Compute a combined text from all input fields for keyword scanning.
+ */
+export function computeCombinedText(input) {
+    const parts = [];
+    if (input.taskIntent)
+        parts.push(input.taskIntent);
+    if (input.taskDescription)
+        parts.push(input.taskDescription);
+    if (input.expectedOutputShape)
+        parts.push(input.expectedOutputShape);
+    if (input.complexityHints)
+        parts.push(input.complexityHints.join(' '));
+    return parts.join(' ').toLowerCase();
+}
+// ---------------------------------------------------------------------------
+// Classification
+// ---------------------------------------------------------------------------
+/**
+ * Classify the task based on its input fields.
+ * Returns a raw classification category (before deployment check).
+ * This is a pure function — no I/O, no stateDir.
+ */
+export function classifyTaskKind(input) {
+    const text = computeCombinedText(input);
+    const { taskIntent, taskDescription, requestedFiles, complexityHints } = input;
+    // --- Step 1: High-entropy keyword detection ---
+    if (complexityHints?.some((h) => ['multi_step', 'cross_file', 'ambiguous', 'requires_planning', 'open_ended', 'unclear'].includes(h))) {
+        return 'high_entropy_disallowed';
+    }
+    if (containsKeyword(text, HIGH_ENTROPY_KEYWORDS)) {
+        return 'high_entropy_disallowed';
+    }
+    if (containsKeyword(taskIntent, HIGH_ENTROPY_KEYWORDS) ||
+        containsKeyword(taskDescription, HIGH_ENTROPY_KEYWORDS)) {
+        return 'high_entropy_disallowed';
+    }
+    // --- Step 2: Reader eligibility ---
+    const intentIsReader = containsKeyword(taskIntent, READER_KEYWORDS);
+    const descIsReader = containsKeyword(taskDescription, READER_KEYWORDS);
+    if (intentIsReader && (descIsReader || !taskDescription)) {
+        return 'reader_eligible';
+    }
+    // --- Step 3: Editor eligibility ---
+    const uniqueFiles = requestedFiles
+        ? [...new Set(requestedFiles.filter((f) => f.trim().length > 0))]
+        : [];
+    const intentIsEditor = containsKeyword(taskIntent, EDITOR_KEYWORDS);
+    const descIsEditor = containsKeyword(taskDescription, EDITOR_KEYWORDS);
+    if (intentIsEditor && (descIsEditor || !taskDescription)) {
+        if (uniqueFiles.length >= MAX_BOUNDED_EDIT_FILES) {
+            return 'high_entropy_disallowed';
+        }
+        return 'editor_eligible';
+    }
+    // --- Step 4: Ambiguous scope ---
+    if (taskDescription && taskDescription.trim().length > 0) {
+        const trimmed = taskDescription.trim();
+        if (trimmed.length < 20 || ['todo', 'fix', 'improve', 'change', 'update', 'something'].includes(trimmed.toLowerCase())) {
+            return 'ambiguous_scope';
+        }
+        if (/\b(why|how|should|could|would|what if|should we|whether to)\b/i.test(trimmed)) {
+            return 'ambiguous_scope';
+        }
+    }
+    if (!taskIntent && !taskDescription) {
+        return 'ambiguous_scope';
+    }
+    return 'ambiguous_scope';
+}
+// ---------------------------------------------------------------------------
+// Reason / Blockers Building
+// ---------------------------------------------------------------------------
+/**
+ * Build the reason string for a given classification.
+ */
+export function buildReason(classification, input) {
+    const { taskIntent, taskDescription } = input;
+    switch (classification) {
+        case 'reader_eligible':
+            return `Task "${taskIntent || taskDescription || '(unnamed)'}" is classified as reader_eligible. ` +
+                `Keywords indicate focused reading, inspection, or information retrieval. ` +
+                `No high-entropy or risk signals detected.`;
+        case 'editor_eligible':
+            return `Task "${taskIntent || taskDescription || '(unnamed)'}" is classified as editor_eligible. ` +
+                `Keywords indicate bounded editing, modification, or repair. ` +
+                `No high-entropy or risk signals detected.`;
+        case 'high_entropy_disallowed': {
+            const uniqueFiles = input.requestedFiles
+                ? [...new Set(input.requestedFiles.filter((f) => f.trim().length > 0))]
+                : [];
+            const isLargeScaleEdit = uniqueFiles.length >= MAX_BOUNDED_EDIT_FILES;
+            if (isLargeScaleEdit) {
+                return `Task "${taskIntent || taskDescription || '(unnamed)'}" is blocked as high_entropy_disallowed. ` +
+                    `Editing ${uniqueFiles.length} files simultaneously exceeds the bounded-scope limit for local-editor. ` +
+                    `Large-scale multi-file edits require the main agent's coordination and risk judgment.`;
+            }
+            return `Task "${taskIntent || taskDescription || '(unnamed)'}" is blocked as high_entropy_disallowed. ` +
+                `Keywords indicate open-ended planning, architecture design, or ambiguous multi-step work. ` +
+                `These tasks require the main agent's full reasoning capability.`;
+        }
+        case 'ambiguous_scope':
+            return `Task "${taskIntent || taskDescription || '(unnamed)'}" is blocked as ambiguous_scope. ` +
+                `The task description is too vague, too short, or contains open-ended question words. ` +
+                `Main agent must clarify scope before delegation.`;
+        case 'profile_mismatch':
+            return `Task profile does not match the requested target profile. ` +
+                `The task's natural classification is incompatible with the specified worker profile. ` +
+                `Main agent must re-route or choose a compatible profile.`;
+        case 'deployment_unavailable':
+            return `No enabled deployment available for routing. ` +
+                `Either no checkpoint is bound to the profile, or routing has been disabled. ` +
+                `Main agent must handle this task.`;
+    }
+}
+/**
+ * Build the blockers list for a given classification.
+ */
+export function buildBlockers(classification, input) {
+    switch (classification) {
+        case 'reader_eligible':
+            return [];
+        case 'editor_eligible':
+            return [];
+        case 'high_entropy_disallowed': {
+            const uniqueFiles = input.requestedFiles
+                ? [...new Set(input.requestedFiles.filter((f) => f.trim().length > 0))]
+                : [];
+            const isLargeScaleEdit = uniqueFiles.length >= MAX_BOUNDED_EDIT_FILES;
+            const triggeredByComplexityHint = input.complexityHints?.some((h) => COMPLEXITY_HINTS.includes(h)) ?? false;
+            const blockers = [];
+            if (isLargeScaleEdit) {
+                blockers.push(`large-scale multi-file edit detected (${uniqueFiles.length} files): scope too broad for local-editor`);
+            }
+            else {
+                blockers.push('task contains high-entropy keywords (design/plan/architect/investigate)');
+            }
+            if (triggeredByComplexityHint) {
+                blockers.push('complexity hint indicates multi-step or open-ended work');
+            }
+            blockers.push('main agent required for full reasoning and judgment');
+            return blockers;
+        }
+        case 'ambiguous_scope':
+            return [
+                'task description too vague or generic',
+                'task intent not provided or unclear',
+                'open-ended question words detected',
+                'main agent must clarify scope before delegation',
+            ];
+        case 'profile_mismatch':
+            return [
+                'task natural profile incompatible with requested target profile',
+                'main agent must re-route or select a compatible profile',
+            ];
+        case 'deployment_unavailable':
+            return [
+                'no enabled deployment found for target profile',
+                'routing may be disabled in deployment registry',
+                'main agent must handle task directly',
+            ];
+    }
+}
+//# sourceMappingURL=routing-guidance.js.map

package/dist/prompt-builder/routing-guidance.js.map

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

package/dist/prompt-builder/size-guard.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Size guard — truncates prompt injection to stay within budget.
+ *
+ * Architecture: this function receives the three prompt components separately
+ * (matching how the plugin calls it — in-place modification of prependSystemContext,
+ * prependContext, appendSystemContext). It returns an object with the stripped
+ * components so the caller can reassemble.
+ *
+ * Priority stripping order (diagnosticianMode):
+ *   1. project_context (always stripped first when over limit)
+ *   2. thinking_os (only in diag mode)
+ *   3. evolution_principles (only in diag mode)
+ *   4. reflection_log (only in diag mode)
+ *   5. reason: line truncation (only in diag mode, when reason: line > 129 chars)
+ *   6. fallback: only replaces appendSystemContext — prependSystemContext and
+ *      prependContext are ALWAYS preserved (matching plugin behavior)
+ *
+ * Phase: PRI-75 Prompt Injection SDK Migration Phase 1
+ */
+import type { SizeGuardOptions, TruncateResult } from './types.js';
+/**
+ * Truncates the combined prompt injection to fit within budget.
+ *
+ * Receives the three prompt components separately (prependSystemContext,
+ * prependContext, appendSystemContext) to allow exact-content replacement and
+ * proper fallback behavior (preserving prependSystemContext + prependContext).
+ *
+ * @param prependSystemContext - Fixed system identity block
+ * @param prependContext - Dynamic directives block
+ * @param appendSystemContext - Principles + Thinking OS + reflection_log + project_context
+ * @param options - Size guard options (diagnosticianMode, blocks with exact content for replacement)
+ * @returns Stripped prompt components + truncation log
+ */
+export declare function truncateInjectionToBudget(prependSystemContext: string, prependContext: string, appendSystemContext: string, options?: SizeGuardOptions): TruncateResult;
+//# sourceMappingURL=size-guard.d.ts.map

package/dist/prompt-builder/size-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-guard.d.ts","sourceRoot":"","sources":["../../src/prompt-builder/size-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAInE;;;;;;;;;;;;GAYG;AAEH,wBAAgB,yBAAyB,CACvC,oBAAoB,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAuHhB"}