clinkx 0.3.0 → 1.1.0

package/clinkx-workflows/dist/run-summary.js

@@ -1,5 +1,7 @@
 import { logger } from "./logger.js";
+import { PLAN_REVIEW_RECEIPTS_WORKFLOW, isPlanReviewRunState } from "./plan-review/admission.js";
 import { deriveDecisiveFailure, deriveStagePresentation } from "./run-summary-derived.js";
+import { extractCouncilPlanReviewCard } from "./run-summary/cards/council-plan-review.js";
 export function deriveCardKind(definitionName) {
     switch (definitionName) {
         case "council-default":
@@ -12,6 +14,8 @@ export function deriveCardKind(definitionName) {
             return "council-discover";
         case "council-answer":
             return "council-answer";
+        case PLAN_REVIEW_RECEIPTS_WORKFLOW:
+            return "council-plan-review";
         default:
             return "generic";
     }
@@ -30,9 +34,32 @@ export function buildSuccessRunSummary(result, store, cardExtractor) {
         attemptStartedAt: expectTimestamp(runState.startedAt, "run startedAt"),
         attemptCompletedAt: expectTimestamp(runState.completedAt, "run completedAt"),
         stages: buildStageSummaries(runState, definition, store),
-        card: cardExtractor(flattenExecutedCalls(result), definition),
+        card: buildCard(result, definition, runState, cardExtractor),
+        workflowContext: runState.workflow_context,
     };
 }
+/**
+ * Plan review is the one council whose card cannot be read off raw call
+ * artifacts: only the projector's published `council-plan-review-result-v1`
+ * envelope (`result.outputText` under the `plan_review_artifacts` terminal
+ * policy) carries seat outcomes the runtime actually validated. Every other
+ * workflow keeps the existing artifact-driven extractor untouched.
+ */
+function buildCard(result, definition, runState, cardExtractor) {
+    // Presence-based typed detection so legacy runs persisted under the
+    // pre-rename name "council-plan-review" still get the transport card, while
+    // runs of the generic council-plan-review workflow never do.
+    if (isPlanReviewRunState(runState)) {
+        return extractCouncilPlanReviewCard({
+            envelopeText: result.outputText,
+            contextStatus: deriveContextStatus(runState),
+        });
+    }
+    return cardExtractor(flattenExecutedCalls(result), definition);
+}
+function deriveContextStatus(runState) {
+    return runState.workflow_context?.context_builder.status ?? "absent";
+}
 export function buildFailureRunSummary(store) {
     const runState = store.runState;
     const definition = store.definition;
@@ -49,6 +76,7 @@ export function buildFailureRunSummary(store) {
         attemptCompletedAt: expectTimestamp(runState.completedAt, "run completedAt"),
         stages: buildStageSummaries(runState, definition, store),
         card: { kind: "generic" },
+        workflowContext: runState.workflow_context,
     };
     if (decisiveFailure != null) {
         summary.failure = decisiveFailure;

package/clinkx-workflows/dist/run-summary.js.map

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

package/clinkx-workflows/dist/schema.d.ts

@@ -48,6 +48,10 @@ export declare const RetryConfigSchema: z.ZodObject<{
     max_backoff_seconds?: number | undefined;
 }>;
 export type RetryConfig = z.infer<typeof RetryConfigSchema>;
+export declare const MODEL_VALUE_MAX = 128;
+export declare const MODEL_VALUE_PATTERN: RegExp;
+export declare const EFFORT_VALUE_MAX = 32;
+export declare const EFFORT_VALUE_PATTERN: RegExp;
 /**
  * CallSchema: exactly ONE of `prompt` or `prompt_template` (XOR).
  * Uses zod refine for XOR enforcement.
@@ -56,11 +60,14 @@ export declare const CallSchema: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     cli_name: z.ZodString;
     role: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
     reducer: z.ZodOptional<z.ZodString>;
+    post_processor: z.ZodOptional<z.ZodString>;
     anonymize_context: z.ZodOptional<z.ZodBoolean>;
     timeout_seconds: z.ZodOptional<z.ZodNumber>;
     absolute_file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    absolute_file_paths_from: z.ZodOptional<z.ZodString>;
+    absolute_file_paths_from: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     images_from: z.ZodOptional<z.ZodString>;
     context_from: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
@@ -74,11 +81,14 @@ export declare const CallSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
     reducer?: string | undefined;
+    post_processor?: string | undefined;
     anonymize_context?: boolean | undefined;
     timeout_seconds?: number | undefined;
     absolute_file_paths?: string[] | undefined;
-    absolute_file_paths_from?: string | undefined;
+    absolute_file_paths_from?: string | string[] | undefined;
     images?: string[] | undefined;
     images_from?: string | undefined;
     context_from?: string[] | undefined;
@@ -91,11 +101,14 @@ export declare const CallSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
     reducer?: string | undefined;
+    post_processor?: string | undefined;
     anonymize_context?: boolean | undefined;
     timeout_seconds?: number | undefined;
     absolute_file_paths?: string[] | undefined;
-    absolute_file_paths_from?: string | undefined;
+    absolute_file_paths_from?: string | string[] | undefined;
     images?: string[] | undefined;
     images_from?: string | undefined;
     context_from?: string | string[] | undefined;
@@ -108,11 +121,14 @@ export declare const CallSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
     reducer?: string | undefined;
+    post_processor?: string | undefined;
     anonymize_context?: boolean | undefined;
     timeout_seconds?: number | undefined;
     absolute_file_paths?: string[] | undefined;
-    absolute_file_paths_from?: string | undefined;
+    absolute_file_paths_from?: string | string[] | undefined;
     images?: string[] | undefined;
     images_from?: string | undefined;
     context_from?: string[] | undefined;
@@ -125,11 +141,14 @@ export declare const CallSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
     reducer?: string | undefined;
+    post_processor?: string | undefined;
     anonymize_context?: boolean | undefined;
     timeout_seconds?: number | undefined;
     absolute_file_paths?: string[] | undefined;
-    absolute_file_paths_from?: string | undefined;
+    absolute_file_paths_from?: string | string[] | undefined;
     images?: string[] | undefined;
     images_from?: string | undefined;
     context_from?: string | string[] | undefined;
@@ -165,11 +184,14 @@ export declare const StageSchema: z.ZodObject<{
         id: z.ZodString;
         cli_name: z.ZodString;
         role: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
         reducer: z.ZodOptional<z.ZodString>;
+        post_processor: z.ZodOptional<z.ZodString>;
         anonymize_context: z.ZodOptional<z.ZodBoolean>;
         timeout_seconds: z.ZodOptional<z.ZodNumber>;
         absolute_file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        absolute_file_paths_from: z.ZodOptional<z.ZodString>;
+        absolute_file_paths_from: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
         images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         images_from: z.ZodOptional<z.ZodString>;
         context_from: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
@@ -183,11 +205,14 @@ export declare const StageSchema: z.ZodObject<{
         id: string;
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         reducer?: string | undefined;
+        post_processor?: string | undefined;
         anonymize_context?: boolean | undefined;
         timeout_seconds?: number | undefined;
         absolute_file_paths?: string[] | undefined;
-        absolute_file_paths_from?: string | undefined;
+        absolute_file_paths_from?: string | string[] | undefined;
         images?: string[] | undefined;
         images_from?: string | undefined;
         context_from?: string[] | undefined;
@@ -200,11 +225,14 @@ export declare const StageSchema: z.ZodObject<{
         id: string;
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         reducer?: string | undefined;
+        post_processor?: string | undefined;
         anonymize_context?: boolean | undefined;
         timeout_seconds?: number | undefined;
         absolute_file_paths?: string[] | undefined;
-        absolute_file_paths_from?: string | undefined;
+        absolute_file_paths_from?: string | string[] | undefined;
         images?: string[] | undefined;
         images_from?: string | undefined;
         context_from?: string | string[] | undefined;
@@ -217,11 +245,14 @@ export declare const StageSchema: z.ZodObject<{
         id: string;
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         reducer?: string | undefined;
+        post_processor?: string | undefined;
         anonymize_context?: boolean | undefined;
         timeout_seconds?: number | undefined;
         absolute_file_paths?: string[] | undefined;
-        absolute_file_paths_from?: string | undefined;
+        absolute_file_paths_from?: string | string[] | undefined;
         images?: string[] | undefined;
         images_from?: string | undefined;
         context_from?: string[] | undefined;
@@ -234,11 +265,14 @@ export declare const StageSchema: z.ZodObject<{
         id: string;
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         reducer?: string | undefined;
+        post_processor?: string | undefined;
         anonymize_context?: boolean | undefined;
         timeout_seconds?: number | undefined;
         absolute_file_paths?: string[] | undefined;
-        absolute_file_paths_from?: string | undefined;
+        absolute_file_paths_from?: string | string[] | undefined;
         images?: string[] | undefined;
         images_from?: string | undefined;
         context_from?: string | string[] | undefined;
@@ -262,11 +296,14 @@ export declare const StageSchema: z.ZodObject<{
         id: string;
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         reducer?: string | undefined;
+        post_processor?: string | undefined;
         anonymize_context?: boolean | undefined;
         timeout_seconds?: number | undefined;
         absolute_file_paths?: string[] | undefined;
-        absolute_file_paths_from?: string | undefined;
+        absolute_file_paths_from?: string | string[] | undefined;
         images?: string[] | undefined;
         images_from?: string | undefined;
         context_from?: string[] | undefined;
@@ -283,11 +320,14 @@ export declare const StageSchema: z.ZodObject<{
         id: string;
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         reducer?: string | undefined;
+        post_processor?: string | undefined;
         anonymize_context?: boolean | undefined;
         timeout_seconds?: number | undefined;
         absolute_file_paths?: string[] | undefined;
-        absolute_file_paths_from?: string | undefined;
+        absolute_file_paths_from?: string | string[] | undefined;
         images?: string[] | undefined;
         images_from?: string | undefined;
         context_from?: string | string[] | undefined;
@@ -311,12 +351,34 @@ export type Stage = z.infer<typeof StageSchema>;
 export declare const WorkflowSettingsSchema: z.ZodObject<{
     timeout_seconds: z.ZodDefault<z.ZodNumber>;
     max_retries: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Opt-in (default off): hard-fail the run when context-builder preflight
+     * selects zero files. Default behavior warns and proceeds, falling back to
+     * caller-provided context_files (decision D3).
+     */
+    fail_on_empty_context_selection: z.ZodDefault<z.ZodBoolean>;
+    fail_on_degraded_context_coverage: z.ZodDefault<z.ZodBoolean>;
+    include_selected_context_artifact: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Runtime default for the preflight delegate's `external_gap_policy` when the
+     * effective delegate is enabled and does not set one. Absent keeps the
+     * context_builder default ("fail"), so unset workflows are unchanged.
+     */
+    context_external_gap_policy: z.ZodOptional<z.ZodEnum<["fail", "degrade"]>>;
 }, "strip", z.ZodTypeAny, {
     max_retries: number;
     timeout_seconds: number;
+    fail_on_empty_context_selection: boolean;
+    fail_on_degraded_context_coverage: boolean;
+    include_selected_context_artifact: boolean;
+    context_external_gap_policy?: "fail" | "degrade" | undefined;
 }, {
     max_retries?: number | undefined;
     timeout_seconds?: number | undefined;
+    fail_on_empty_context_selection?: boolean | undefined;
+    fail_on_degraded_context_coverage?: boolean | undefined;
+    include_selected_context_artifact?: boolean | undefined;
+    context_external_gap_policy?: "fail" | "degrade" | undefined;
 }>;
 export type WorkflowSettings = z.infer<typeof WorkflowSettingsSchema>;
 export declare const WorkflowDefinitionSchema: z.ZodObject<{
@@ -348,11 +410,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: z.ZodString;
             cli_name: z.ZodString;
             role: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
             reducer: z.ZodOptional<z.ZodString>;
+            post_processor: z.ZodOptional<z.ZodString>;
             anonymize_context: z.ZodOptional<z.ZodBoolean>;
             timeout_seconds: z.ZodOptional<z.ZodNumber>;
             absolute_file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            absolute_file_paths_from: z.ZodOptional<z.ZodString>;
+            absolute_file_paths_from: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
             images: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             images_from: z.ZodOptional<z.ZodString>;
             context_from: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
@@ -366,11 +431,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string[] | undefined;
@@ -383,11 +451,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string | string[] | undefined;
@@ -400,11 +471,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string[] | undefined;
@@ -417,11 +491,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string | string[] | undefined;
@@ -445,11 +522,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string[] | undefined;
@@ -466,11 +546,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string | string[] | undefined;
@@ -509,12 +592,34 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
     settings: z.ZodDefault<z.ZodObject<{
         timeout_seconds: z.ZodDefault<z.ZodNumber>;
         max_retries: z.ZodDefault<z.ZodNumber>;
+        /**
+         * Opt-in (default off): hard-fail the run when context-builder preflight
+         * selects zero files. Default behavior warns and proceeds, falling back to
+         * caller-provided context_files (decision D3).
+         */
+        fail_on_empty_context_selection: z.ZodDefault<z.ZodBoolean>;
+        fail_on_degraded_context_coverage: z.ZodDefault<z.ZodBoolean>;
+        include_selected_context_artifact: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Runtime default for the preflight delegate's `external_gap_policy` when the
+         * effective delegate is enabled and does not set one. Absent keeps the
+         * context_builder default ("fail"), so unset workflows are unchanged.
+         */
+        context_external_gap_policy: z.ZodOptional<z.ZodEnum<["fail", "degrade"]>>;
     }, "strip", z.ZodTypeAny, {
         max_retries: number;
         timeout_seconds: number;
+        fail_on_empty_context_selection: boolean;
+        fail_on_degraded_context_coverage: boolean;
+        include_selected_context_artifact: boolean;
+        context_external_gap_policy?: "fail" | "degrade" | undefined;
     }, {
         max_retries?: number | undefined;
         timeout_seconds?: number | undefined;
+        fail_on_empty_context_selection?: boolean | undefined;
+        fail_on_degraded_context_coverage?: boolean | undefined;
+        include_selected_context_artifact?: boolean | undefined;
+        context_external_gap_policy?: "fail" | "degrade" | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     description: string;
@@ -534,11 +639,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string[] | undefined;
@@ -559,6 +667,10 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
     settings: {
         max_retries: number;
         timeout_seconds: number;
+        fail_on_empty_context_selection: boolean;
+        fail_on_degraded_context_coverage: boolean;
+        include_selected_context_artifact: boolean;
+        context_external_gap_policy?: "fail" | "degrade" | undefined;
     };
 }, {
     description: string;
@@ -570,11 +682,14 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
             id: string;
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             reducer?: string | undefined;
+            post_processor?: string | undefined;
             anonymize_context?: boolean | undefined;
             timeout_seconds?: number | undefined;
             absolute_file_paths?: string[] | undefined;
-            absolute_file_paths_from?: string | undefined;
+            absolute_file_paths_from?: string | string[] | undefined;
             images?: string[] | undefined;
             images_from?: string | undefined;
             context_from?: string | string[] | undefined;
@@ -603,6 +718,10 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
     settings?: {
         max_retries?: number | undefined;
         timeout_seconds?: number | undefined;
+        fail_on_empty_context_selection?: boolean | undefined;
+        fail_on_degraded_context_coverage?: boolean | undefined;
+        include_selected_context_artifact?: boolean | undefined;
+        context_external_gap_policy?: "fail" | "degrade" | undefined;
     } | undefined;
 }>;
 export type WorkflowDefinition = z.infer<typeof WorkflowDefinitionSchema>;

package/clinkx-workflows/dist/schema.js

@@ -57,15 +57,34 @@ const ContextFromSchema = z
     .union([z.string(), z.array(z.string())])
     .transform((val) => (typeof val === "string" ? [val] : val))
     .optional();
+export const MODEL_VALUE_MAX = 128;
+export const MODEL_VALUE_PATTERN = /^[^\s\u0000-][^\s\u0000]*$/;
+export const EFFORT_VALUE_MAX = 32;
+export const EFFORT_VALUE_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
 const BaseCallSchema = z.object({
     id: IdSchema,
     cli_name: z.string().min(1),
     role: z.string().min(1),
+    model: z
+        .string()
+        .trim()
+        .min(1)
+        .max(MODEL_VALUE_MAX)
+        .regex(MODEL_VALUE_PATTERN)
+        .optional(),
+    effort: z
+        .string()
+        .trim()
+        .min(1)
+        .max(EFFORT_VALUE_MAX)
+        .regex(EFFORT_VALUE_PATTERN)
+        .optional(),
     reducer: z.string().optional(),
+    post_processor: z.string().optional(),
     anonymize_context: z.boolean().optional(),
     timeout_seconds: z.number().positive().optional(),
     absolute_file_paths: z.array(z.string()).optional(),
-    absolute_file_paths_from: z.string().optional(),
+    absolute_file_paths_from: z.union([z.string(), z.array(z.string())]).optional(),
     images: z.array(z.string()).optional(),
     images_from: z.string().optional(),
     context_from: ContextFromSchema,
@@ -107,6 +126,20 @@ export const StageSchema = z.object({
 export const WorkflowSettingsSchema = z.object({
     timeout_seconds: z.number().positive().default(1800),
     max_retries: z.number().int().min(0).default(0),
+    /**
+     * Opt-in (default off): hard-fail the run when context-builder preflight
+     * selects zero files. Default behavior warns and proceeds, falling back to
+     * caller-provided context_files (decision D3).
+     */
+    fail_on_empty_context_selection: z.boolean().default(false),
+    fail_on_degraded_context_coverage: z.boolean().default(false),
+    include_selected_context_artifact: z.boolean().default(false),
+    /**
+     * Runtime default for the preflight delegate's `external_gap_policy` when the
+     * effective delegate is enabled and does not set one. Absent keeps the
+     * context_builder default ("fail"), so unset workflows are unchanged.
+     */
+    context_external_gap_policy: z.enum(["fail", "degrade"]).optional(),
 });
 export const WorkflowDefinitionSchema = z.object({
     name: IdSchema,

package/clinkx-workflows/dist/schema.js.map

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

package/clinkx-workflows/dist/seed-terms.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Deterministic seed-term synthesis (Plan Phase 5, tasks 5-1/5-2/5-3).
+ *
+ * Pure function: no clock, no RNG, no LLM, no I/O. Identical input always
+ * yields a byte-identical array (verified by tests/seed-terms.test.ts).
+ *
+ * Used to seed context_builder discovery when a workflow runs preflight in
+ * `full`/`deterministic` mode but the caller supplied neither focus paths nor
+ * search terms (wiring lives in Phase 3 — not here).
+ *
+ * Algorithm (pinned in plan task 5-3, authoritative):
+ *   1. Preserve quoted phrases, then camelCase/snake_case/dotted identifiers as
+ *      WHOLE terms before any prose splitting (5-2).
+ *   2. Lowercase and split the remaining prose; drop the fixed 21-word stop set
+ *      and tokens shorter than 3 chars (5-3).
+ *   3. Dedupe case-insensitively; rank by `score = frequency + lengthBonus`
+ *      with a first-seen tie-break; cap at 12 terms (5-3).
+ */
+export declare const MAX_SEED_SOURCE_CHARACTERS = 4000;
+export declare const MAX_CONTEXT_SEARCH_TERMS = 20;
+export declare const MAX_CONTEXT_SEARCH_TERM_CODE_POINTS = 256;
+export declare const MAX_CONTEXT_SEARCH_TERMS_UTF8_BYTES = 4096;
+/** Resolve the workflow context task using the runner's nonblank cb_task rule. */
+export declare function resolveSeedSource(cbTask: string | undefined, userRequest: string | undefined): string;
+/** Match the root task schema's trim-before-max character bound. */
+export declare function seedSourceExceedsLimit(seedSource: string): boolean;
+/** Match the root NonBlankStringSchema + post-parse task bound. */
+export declare function contextSeedSourceValidationError(seedSource: string): string | undefined;
+export declare function contextSearchTermsValidationError(searchTerms: readonly string[]): string | undefined;
+export declare function synthesizeSeedTerms(text: string): string[];