@exaudeus/workrail 3.9.2 → 3.11.0

package/dist/v2/durable-core/schemas/session/events.d.ts

@@ -1098,6 +1098,229 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     eventIndex: z.ZodNumber;
     sessionId: z.ZodString;
     dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"assessment_recorded">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        assessmentId: z.ZodString;
+        attemptId: z.ZodString;
+        artifactOutputId: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        normalizationNotes: z.ZodReadonly<z.ZodArray<z.ZodString, "many">>;
+        dimensions: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            dimensionId: z.ZodString;
+            level: z.ZodString;
+            rationale: z.ZodOptional<z.ZodString>;
+            normalization: z.ZodEnum<["exact", "normalized"]>;
+        }, "strip", z.ZodTypeAny, {
+            level: string;
+            dimensionId: string;
+            normalization: "exact" | "normalized";
+            rationale?: string | undefined;
+        }, {
+            level: string;
+            dimensionId: string;
+            normalization: "exact" | "normalized";
+            rationale?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        assessmentId: string;
+        dimensions: readonly {
+            level: string;
+            dimensionId: string;
+            normalization: "exact" | "normalized";
+            rationale?: string | undefined;
+        }[];
+        attemptId: string;
+        artifactOutputId: string;
+        normalizationNotes: readonly string[];
+        summary?: string | undefined;
+    }, {
+        assessmentId: string;
+        dimensions: readonly {
+            level: string;
+            dimensionId: string;
+            normalization: "exact" | "normalized";
+            rationale?: string | undefined;
+        }[];
+        attemptId: string;
+        artifactOutputId: string;
+        normalizationNotes: readonly string[];
+        summary?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "assessment_recorded";
+    sessionId: string;
+    data: {
+        assessmentId: string;
+        dimensions: readonly {
+            level: string;
+            dimensionId: string;
+            normalization: "exact" | "normalized";
+            rationale?: string | undefined;
+        }[];
+        attemptId: string;
+        artifactOutputId: string;
+        normalizationNotes: readonly string[];
+        summary?: string | undefined;
+    };
+    v: 1;
+    eventIndex: number;
+    eventId: string;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "assessment_recorded";
+    sessionId: string;
+    data: {
+        assessmentId: string;
+        dimensions: readonly {
+            level: string;
+            dimensionId: string;
+            normalization: "exact" | "normalized";
+            rationale?: string | undefined;
+        }[];
+        attemptId: string;
+        artifactOutputId: string;
+        normalizationNotes: readonly string[];
+        summary?: string | undefined;
+    };
+    v: 1;
+    eventIndex: number;
+    eventId: string;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
+} & {
+    kind: z.ZodLiteral<"assessment_consequence_applied">;
+    scope: z.ZodObject<{
+        runId: z.ZodString;
+        nodeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        runId: string;
+        nodeId: string;
+    }, {
+        runId: string;
+        nodeId: string;
+    }>;
+    data: z.ZodObject<{
+        attemptId: z.ZodString;
+        assessmentId: z.ZodString;
+        trigger: z.ZodObject<{
+            dimensionId: z.ZodString;
+            level: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            level: string;
+            dimensionId: string;
+        }, {
+            level: string;
+            dimensionId: string;
+        }>;
+        effect: z.ZodObject<{
+            kind: z.ZodLiteral<"require_followup">;
+            guidance: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "require_followup";
+            guidance: string;
+        }, {
+            kind: "require_followup";
+            guidance: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        assessmentId: string;
+        effect: {
+            kind: "require_followup";
+            guidance: string;
+        };
+        attemptId: string;
+        trigger: {
+            level: string;
+            dimensionId: string;
+        };
+    }, {
+        assessmentId: string;
+        effect: {
+            kind: "require_followup";
+            guidance: string;
+        };
+        attemptId: string;
+        trigger: {
+            level: string;
+            dimensionId: string;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "assessment_consequence_applied";
+    sessionId: string;
+    data: {
+        assessmentId: string;
+        effect: {
+            kind: "require_followup";
+            guidance: string;
+        };
+        attemptId: string;
+        trigger: {
+            level: string;
+            dimensionId: string;
+        };
+    };
+    v: 1;
+    eventIndex: number;
+    eventId: string;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}, {
+    kind: "assessment_consequence_applied";
+    sessionId: string;
+    data: {
+        assessmentId: string;
+        effect: {
+            kind: "require_followup";
+            guidance: string;
+        };
+        attemptId: string;
+        trigger: {
+            level: string;
+            dimensionId: string;
+        };
+    };
+    v: 1;
+    eventIndex: number;
+    eventId: string;
+    dedupeKey: string;
+    scope: {
+        runId: string;
+        nodeId: string;
+    };
+}>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    eventId: z.ZodString;
+    eventIndex: z.ZodNumber;
+    sessionId: z.ZodString;
+    dedupeKey: z.ZodString;
 } & {
     kind: z.ZodLiteral<"preferences_changed">;
     scope: z.ZodObject<{
@@ -1653,6 +1876,7 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
             outputId: string;
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        summary: string;
         reason: {
             detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
             category: "user_only_dependency";
@@ -1674,7 +1898,6 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         };
         gapId: string;
         severity: "warning" | "info" | "critical";
-        summary: string;
         evidenceRefs?: ({
             kind: "event";
             eventId: string;
@@ -1683,6 +1906,7 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
             outputId: string;
         })[] | undefined;
     }, {
+        summary: string;
         reason: {
             detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
             category: "user_only_dependency";
@@ -1704,7 +1928,6 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         };
         gapId: string;
         severity: "warning" | "info" | "critical";
-        summary: string;
         evidenceRefs?: ({
             kind: "event";
             eventId: string;
@@ -1717,6 +1940,7 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     kind: "gap_recorded";
     sessionId: string;
     data: {
+        summary: string;
         reason: {
             detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
             category: "user_only_dependency";
@@ -1738,7 +1962,6 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         };
         gapId: string;
         severity: "warning" | "info" | "critical";
-        summary: string;
         evidenceRefs?: ({
             kind: "event";
             eventId: string;
@@ -1759,6 +1982,7 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     kind: "gap_recorded";
     sessionId: string;
     data: {
+        summary: string;
         reason: {
             detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
             category: "user_only_dependency";
@@ -1780,7 +2004,6 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         };
         gapId: string;
         severity: "warning" | "info" | "critical";
-        summary: string;
         evidenceRefs?: ({
             kind: "event";
             eventId: string;
@@ -1879,13 +2102,13 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
         summary: z.ZodString;
         relatedStepId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         summary: string;
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         divergenceId: string;
         relatedStepId?: string | undefined;
     }, {
-        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         summary: string;
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         divergenceId: string;
         relatedStepId?: string | undefined;
     }>;
@@ -1893,8 +2116,8 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     kind: "divergence_recorded";
     sessionId: string;
     data: {
-        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         summary: string;
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         divergenceId: string;
         relatedStepId?: string | undefined;
     };
@@ -1910,8 +2133,8 @@ export declare const DomainEventV1Schema: z.ZodDiscriminatedUnion<"kind", [z.Zod
     kind: "divergence_recorded";
     sessionId: string;
     data: {
-        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         summary: string;
+        reason: "missing_user_context" | "capability_unavailable" | "efficiency_skip" | "safety_stop" | "policy_constraint";
         divergenceId: string;
         relatedStepId?: string | undefined;
     };

package/dist/v2/durable-core/schemas/session/events.js

@@ -53,6 +53,32 @@ const AdvanceRecordedDataV1Schema = zod_1.z.object({
     intent: zod_1.z.literal('ack_pending'),
     outcome: AdvanceRecordedOutcomeV1Schema,
 });
+const AssessmentRecordedDimensionV1Schema = zod_1.z.object({
+    dimensionId: zod_1.z.string().min(1),
+    level: zod_1.z.string().min(1),
+    rationale: zod_1.z.string().min(1).optional(),
+    normalization: zod_1.z.enum(['exact', 'normalized']),
+});
+const AssessmentRecordedDataV1Schema = zod_1.z.object({
+    assessmentId: zod_1.z.string().min(1),
+    attemptId: zod_1.z.string().min(1),
+    artifactOutputId: zod_1.z.string().min(1),
+    summary: zod_1.z.string().min(1).optional(),
+    normalizationNotes: zod_1.z.array(zod_1.z.string().min(1)).readonly(),
+    dimensions: zod_1.z.array(AssessmentRecordedDimensionV1Schema).min(1).readonly(),
+});
+const AssessmentConsequenceAppliedDataV1Schema = zod_1.z.object({
+    attemptId: zod_1.z.string().min(1),
+    assessmentId: zod_1.z.string().min(1),
+    trigger: zod_1.z.object({
+        dimensionId: zod_1.z.string().min(1),
+        level: zod_1.z.string().min(1),
+    }),
+    effect: zod_1.z.object({
+        kind: zod_1.z.literal('require_followup'),
+        guidance: zod_1.z.string().min(1),
+    }),
+});
 const PreferencesChangedDataV1Schema = zod_1.z
     .object({
     changeId: zod_1.z.string().min(1),
@@ -120,6 +146,16 @@ exports.DomainEventV1Schema = zod_1.z.discriminatedUnion('kind', [
         scope: zod_1.z.object({ runId: zod_1.z.string().min(1), nodeId: zod_1.z.string().min(1) }),
         data: outputs_js_1.NodeOutputAppendedDataV1Schema,
     }),
+    exports.DomainEventEnvelopeV1Schema.extend({
+        kind: zod_1.z.literal('assessment_recorded'),
+        scope: zod_1.z.object({ runId: zod_1.z.string().min(1), nodeId: zod_1.z.string().min(1) }),
+        data: AssessmentRecordedDataV1Schema,
+    }),
+    exports.DomainEventEnvelopeV1Schema.extend({
+        kind: zod_1.z.literal('assessment_consequence_applied'),
+        scope: zod_1.z.object({ runId: zod_1.z.string().min(1), nodeId: zod_1.z.string().min(1) }),
+        data: AssessmentConsequenceAppliedDataV1Schema,
+    }),
     exports.DomainEventEnvelopeV1Schema.extend({
         kind: zod_1.z.literal('preferences_changed'),
         scope: zod_1.z.object({ runId: zod_1.z.string().min(1), nodeId: zod_1.z.string().min(1) }),

package/dist/v2/durable-core/schemas/session/gaps.d.ts

@@ -149,6 +149,7 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
         outputId: string;
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
+    summary: string;
     reason: {
         detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
         category: "user_only_dependency";
@@ -170,7 +171,6 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
     };
     gapId: string;
     severity: "warning" | "info" | "critical";
-    summary: string;
     evidenceRefs?: ({
         kind: "event";
         eventId: string;
@@ -179,6 +179,7 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
         outputId: string;
     })[] | undefined;
 }, {
+    summary: string;
     reason: {
         detail: "needs_user_secret_or_token" | "needs_user_account_access" | "needs_user_artifact" | "needs_user_choice" | "needs_user_approval" | "needs_user_environment_action";
         category: "user_only_dependency";
@@ -200,7 +201,6 @@ export declare const GapRecordedDataV1Schema: z.ZodObject<{
     };
     gapId: string;
     severity: "warning" | "info" | "critical";
-    summary: string;
     evidenceRefs?: ({
         kind: "event";
         eventId: string;

package/dist/v2/projections/assessment-consequences.d.ts

@@ -0,0 +1,19 @@
+import type { Result } from 'neverthrow';
+import type { DomainEventV1 } from '../durable-core/schemas/session/index.js';
+import type { ProjectionError } from './projection-error.js';
+type AssessmentConsequenceAppliedEventV1 = Extract<DomainEventV1, {
+    kind: 'assessment_consequence_applied';
+}>;
+export interface AppliedAssessmentConsequenceViewV2 {
+    readonly assessmentId: string;
+    readonly attemptId: string;
+    readonly trigger: AssessmentConsequenceAppliedEventV1['data']['trigger'];
+    readonly effect: AssessmentConsequenceAppliedEventV1['data']['effect'];
+    readonly recordedAtEventIndex: number;
+}
+export interface AssessmentConsequencesProjectionV2 {
+    readonly byNodeId: Readonly<Record<string, readonly AppliedAssessmentConsequenceViewV2[]>>;
+}
+export declare function projectAssessmentConsequencesV2(events: readonly DomainEventV1[]): Result<AssessmentConsequencesProjectionV2, ProjectionError>;
+export declare function getLatestAssessmentConsequenceForNode(projection: AssessmentConsequencesProjectionV2, nodeId: string): AppliedAssessmentConsequenceViewV2 | undefined;
+export {};

package/dist/v2/projections/assessment-consequences.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectAssessmentConsequencesV2 = projectAssessmentConsequencesV2;
+exports.getLatestAssessmentConsequenceForNode = getLatestAssessmentConsequenceForNode;
+const neverthrow_1 = require("neverthrow");
+const constants_js_1 = require("../durable-core/constants.js");
+function projectAssessmentConsequencesV2(events) {
+    for (let i = 1; i < events.length; i++) {
+        if (events[i].eventIndex < events[i - 1].eventIndex) {
+            return (0, neverthrow_1.err)({ code: 'PROJECTION_INVARIANT_VIOLATION', message: 'Events must be sorted by eventIndex ascending' });
+        }
+    }
+    const byNodeId = {};
+    for (const event of events) {
+        if (event.kind !== constants_js_1.EVENT_KIND.ASSESSMENT_CONSEQUENCE_APPLIED)
+            continue;
+        const nodeId = event.scope.nodeId;
+        if (!byNodeId[nodeId])
+            byNodeId[nodeId] = [];
+        byNodeId[nodeId].push({
+            assessmentId: event.data.assessmentId,
+            attemptId: event.data.attemptId,
+            trigger: event.data.trigger,
+            effect: event.data.effect,
+            recordedAtEventIndex: event.eventIndex,
+        });
+    }
+    return (0, neverthrow_1.ok)({ byNodeId });
+}
+function getLatestAssessmentConsequenceForNode(projection, nodeId) {
+    const consequences = projection.byNodeId[nodeId];
+    return consequences && consequences.length > 0 ? consequences[consequences.length - 1] : undefined;
+}

package/dist/v2/projections/assessments.d.ts

@@ -0,0 +1,21 @@
+import type { Result } from 'neverthrow';
+import type { DomainEventV1 } from '../durable-core/schemas/session/index.js';
+import type { ProjectionError } from './projection-error.js';
+type AssessmentRecordedEventV1 = Extract<DomainEventV1, {
+    kind: 'assessment_recorded';
+}>;
+export interface RecordedAssessmentViewV2 {
+    readonly assessmentId: string;
+    readonly attemptId: string;
+    readonly artifactOutputId: string;
+    readonly summary?: string;
+    readonly normalizationNotes: readonly string[];
+    readonly dimensions: AssessmentRecordedEventV1['data']['dimensions'];
+    readonly recordedAtEventIndex: number;
+}
+export interface AssessmentsProjectionV2 {
+    readonly byNodeId: Readonly<Record<string, readonly RecordedAssessmentViewV2[]>>;
+}
+export declare function projectAssessmentsV2(events: readonly DomainEventV1[]): Result<AssessmentsProjectionV2, ProjectionError>;
+export declare function getLatestAssessmentForNode(projection: AssessmentsProjectionV2, nodeId: string): RecordedAssessmentViewV2 | undefined;
+export {};

package/dist/v2/projections/assessments.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectAssessmentsV2 = projectAssessmentsV2;
+exports.getLatestAssessmentForNode = getLatestAssessmentForNode;
+const neverthrow_1 = require("neverthrow");
+const constants_js_1 = require("../durable-core/constants.js");
+function projectAssessmentsV2(events) {
+    for (let i = 1; i < events.length; i++) {
+        if (events[i].eventIndex < events[i - 1].eventIndex) {
+            return (0, neverthrow_1.err)({ code: 'PROJECTION_INVARIANT_VIOLATION', message: 'Events must be sorted by eventIndex ascending' });
+        }
+    }
+    const byNodeId = {};
+    for (const event of events) {
+        if (event.kind !== constants_js_1.EVENT_KIND.ASSESSMENT_RECORDED)
+            continue;
+        const nodeId = event.scope.nodeId;
+        if (!byNodeId[nodeId])
+            byNodeId[nodeId] = [];
+        byNodeId[nodeId].push({
+            assessmentId: event.data.assessmentId,
+            attemptId: event.data.attemptId,
+            artifactOutputId: event.data.artifactOutputId,
+            summary: event.data.summary,
+            normalizationNotes: event.data.normalizationNotes,
+            dimensions: event.data.dimensions,
+            recordedAtEventIndex: event.eventIndex,
+        });
+    }
+    return (0, neverthrow_1.ok)({ byNodeId });
+}
+function getLatestAssessmentForNode(projection, nodeId) {
+    const assessments = projection.byNodeId[nodeId];
+    return assessments && assessments.length > 0 ? assessments[assessments.length - 1] : undefined;
+}

package/dist/v2/projections/resume-ranking.d.ts

@@ -1,4 +1,5 @@
 import type { SessionId, WorkflowHash, WorkflowId } from '../durable-core/ids/index.js';
+export { MAX_RESUME_PREVIEW_BYTES } from '../durable-core/constants.js';
 export type RecapSnippet = string & {
     readonly __brand: 'RecapSnippet';
 };

package/dist/v2/projections/resume-ranking.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_RESUME_CANDIDATES = void 0;
+exports.MAX_RESUME_CANDIDATES = exports.MAX_RESUME_PREVIEW_BYTES = void 0;
 exports.asRecapSnippet = asRecapSnippet;
 exports.normalizeToTokens = normalizeToTokens;
 exports.allQueryTokensMatch = allQueryTokensMatch;
@@ -11,7 +11,10 @@ exports.computeQueryRelevanceScore = computeQueryRelevanceScore;
 exports.assignTier = assignTier;
 exports.rankResumeCandidates = rankResumeCandidates;
 const constants_js_1 = require("../durable-core/constants.js");
-const MAX_SNIPPET_BYTES = 1024;
+const retrieval_contract_js_1 = require("../durable-core/domain/retrieval-contract.js");
+var constants_js_2 = require("../durable-core/constants.js");
+Object.defineProperty(exports, "MAX_RESUME_PREVIEW_BYTES", { enumerable: true, get: function () { return constants_js_2.MAX_RESUME_PREVIEW_BYTES; } });
+const MAX_SNIPPET_BYTES = constants_js_1.MAX_RESUME_PREVIEW_BYTES;
 function asRecapSnippet(raw) {
     const stripped = raw.endsWith(constants_js_1.TRUNCATION_MARKER)
         ? raw.slice(0, -constants_js_1.TRUNCATION_MARKER.length)
@@ -145,29 +148,14 @@ function collectMatchReasons(summary, query, tier) {
     return reasons;
 }
 function buildPreviewSnippet(summary, query) {
-    const previewSource = buildSearchableSessionText(summary);
-    if (!previewSource)
+    const segments = [
+        summary.sessionTitle ? (0, retrieval_contract_js_1.createSessionTitlePreviewSegment)(summary.sessionTitle) : null,
+        summary.recapSnippet ? (0, retrieval_contract_js_1.createRecapPreviewSegment)(summary.recapSnippet) : null,
+    ].filter((segment) => segment !== null);
+    if (segments.length === 0)
         return '';
-    const queryTokens = query.freeTextQuery ? [...normalizeToTokens(query.freeTextQuery)] : [];
-    if (queryTokens.length === 0)
-        return summary.recapSnippet ?? previewSource;
-    const lower = previewSource.toLowerCase();
-    let bestIndex = -1;
-    for (const token of queryTokens) {
-        if (token.length < 3)
-            continue;
-        const idx = lower.indexOf(token);
-        if (idx !== -1 && (bestIndex === -1 || idx < bestIndex))
-            bestIndex = idx;
-    }
-    if (bestIndex === -1)
-        return summary.recapSnippet ?? previewSource;
-    const start = Math.max(0, bestIndex - 100);
-    const end = Math.min(previewSource.length, bestIndex + 180);
-    const slice = previewSource.slice(start, end).trim();
-    const prefix = start > 0 ? '...' : '';
-    const suffix = end < previewSource.length ? '...' : '';
-    return `${prefix}${slice}${suffix}`;
+    const focusTerms = query.freeTextQuery ? [...normalizeToTokens(query.freeTextQuery)] : [];
+    return (0, retrieval_contract_js_1.renderBudgetedResumePreview)({ segments, focusTerms }).text;
 }
 function deriveConfidence(tier, reasons) {
     if (tier.kind === 'matched_exact_id' || tier.kind === 'matched_notes')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "3.9.2",
+  "version": "3.11.0",
   "description": "Step-by-step workflow enforcement for AI agents via MCP",
   "license": "MIT",
   "repository": {