clinkx 0.3.0 → 1.1.0

package/clinkx-workflows/workflows/council-code-review.yaml

@@ -27,6 +27,87 @@ variables:
     required: false
     default: []
     description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_bundle_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder bundle files copied into the workflow run
+  cb_task:
+    type: string
+    required: false
+    default: ""
+    description: Optional context_builder task override
+  cb_roots:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder source roots
+  cb_focus_paths:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder focus path refinement. Context preflight runs by default; these paths narrow selection when supplied.
+  cb_include_globs:
+    type: string[]
+    required: false
+    default: []
+    description: Context-builder include glob refinements
+  cb_exclude_globs:
+    type: string[]
+    required: false
+    default: ["**/*.po", "**/*.pot", "**/*.mo", "**/locales/**/*.json", "**/i18n/**/*.json"]
+    description: Context-builder exclude glob refinements
+  cb_search_terms:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder search term refinement. Context preflight runs by default; these terms narrow selection when supplied.
+  cb_profile:
+    type: string
+    required: false
+    default: review_deep
+    description: Context-builder budget profile
+  cb_budget_adapter:
+    type: string
+    required: false
+    description: Adapter whose context_builder budget defaults apply when context preflight runs (preflight runs by default unless cb_context_mode is off).
+  cb_allow_secrets:
+    type: boolean
+    required: false
+    description: When false, restores fail-closed context_builder source secret omission/redaction AND rejects high-confidence secrets in persisted task text (cb_task/user_request) before the run starts; default true includes secrets.
+  cb_budget_max_estimated_tokens:
+    type: number
+    required: false
+    description: Context-builder budget override — max estimated tokens
+  cb_budget_max_files:
+    type: number
+    required: false
+    description: Context-builder budget override — max files selected
+  cb_budget_max_scan_files:
+    type: number
+    required: false
+    description: Context-builder budget override — max files scanned
+  cb_budget_max_bytes_per_file:
+    type: number
+    required: false
+    description: Context-builder budget override — max bytes per file
+  cb_budget_max_total_bytes:
+    type: number
+    required: false
+    description: Context-builder budget override — max total bytes
+  cb_budget_max_search_results:
+    type: number
+    required: false
+    description: Context-builder budget override — max search results
+  cb_delegate:
+    type: string
+    required: false
+    default: ""
+    description: Optional context_builder delegate config as a JSON string (enabled/curator/finalizer)
+  cb_context_mode:
+    type: string
+    required: false
+    description: "Context preflight mode selector. Allowed values: full | deterministic | off | inherit. Omitted or inherit follows the server default (CLINKX_WORKFLOWS_CONTEXT_DEFAULT); full runs curator+finalizer delegate, deterministic seeds discovery with no delegate, off skips preflight. Allowed-value validation is owned by the resolver; no concrete mode default is materialized in YAML."
   context_images:
     type: string[]
     required: false
@@ -34,7 +115,10 @@ variables:
     description: Optional image paths (absolute, or relative to workspace root) shared with the council
 
 settings:
-  timeout_seconds: 1800
+  timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: reviewers
@@ -49,25 +133,31 @@ stages:
     calls:
       - id: reviewer_a
         cli_name: codex
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_code_review_reviewer_v1
+        post_processor: citation_check
       - id: reviewer_b
         cli_name: codex
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_code_review_reviewer_v1
+        post_processor: citation_check
       - id: reviewer_c
         cli_name: claude
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_code_review_reviewer_v1
+        post_processor: citation_check
 
   - id: cross_review
     description: "Cross-reviewers evaluate reviews anonymously"
@@ -81,34 +171,40 @@ stages:
     calls:
       - id: cross_reviewer_a
         cli_name: codex
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-cross-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         anonymize_context: true
         context_from:
           - reviewers
         validator_schema_id: council_code_review_cross_reviewer_v4
+        post_processor: citation_check
       - id: cross_reviewer_b
         cli_name: codex
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-cross-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         anonymize_context: true
         context_from:
           - reviewers
         validator_schema_id: council_code_review_cross_reviewer_v4
+        post_processor: citation_check
       - id: cross_reviewer_c
         cli_name: claude
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-cross-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         anonymize_context: true
         context_from:
           - reviewers
         validator_schema_id: council_code_review_cross_reviewer_v4
+        post_processor: citation_check
 
   - id: ranking_analysis
     description: "Deterministic ranking of reviews"
@@ -122,6 +218,7 @@ stages:
     calls:
       - id: ranking
         cli_name: codex
+        timeout_seconds: 1200
         role: json-codereviewer
         reducer: council_ranking_v1
         prompt: "Deterministic ranking reducer"
@@ -141,9 +238,10 @@ stages:
     calls:
       - id: chairman
         cli_name: codex
+        timeout_seconds: 1200
         role: json-codereviewer
         prompt_template: council/code-review-chairman.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         context_from:
           - reviewers

package/clinkx-workflows/workflows/council-debug.yaml

@@ -27,6 +27,87 @@ variables:
     required: false
     default: []
     description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_bundle_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder bundle files copied into the workflow run
+  cb_task:
+    type: string
+    required: false
+    default: ""
+    description: Optional context_builder task override
+  cb_roots:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder source roots
+  cb_focus_paths:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder focus path refinement. Context preflight runs by default; these paths narrow selection when supplied.
+  cb_include_globs:
+    type: string[]
+    required: false
+    default: []
+    description: Context-builder include glob refinements
+  cb_exclude_globs:
+    type: string[]
+    required: false
+    default: ["**/*.po", "**/*.pot", "**/*.mo", "**/locales/**/*.json", "**/i18n/**/*.json"]
+    description: Context-builder exclude glob refinements
+  cb_search_terms:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder search term refinement. Context preflight runs by default; these terms narrow selection when supplied.
+  cb_profile:
+    type: string
+    required: false
+    default: review_deep
+    description: Context-builder budget profile
+  cb_budget_adapter:
+    type: string
+    required: false
+    description: Adapter whose context_builder budget defaults apply when context preflight runs (preflight runs by default unless cb_context_mode is off).
+  cb_allow_secrets:
+    type: boolean
+    required: false
+    description: When false, restores fail-closed context_builder source secret omission/redaction AND rejects high-confidence secrets in persisted task text (cb_task/user_request) before the run starts; default true includes secrets.
+  cb_budget_max_estimated_tokens:
+    type: number
+    required: false
+    description: Context-builder budget override — max estimated tokens
+  cb_budget_max_files:
+    type: number
+    required: false
+    description: Context-builder budget override — max files selected
+  cb_budget_max_scan_files:
+    type: number
+    required: false
+    description: Context-builder budget override — max files scanned
+  cb_budget_max_bytes_per_file:
+    type: number
+    required: false
+    description: Context-builder budget override — max bytes per file
+  cb_budget_max_total_bytes:
+    type: number
+    required: false
+    description: Context-builder budget override — max total bytes
+  cb_budget_max_search_results:
+    type: number
+    required: false
+    description: Context-builder budget override — max search results
+  cb_delegate:
+    type: string
+    required: false
+    default: ""
+    description: Optional context_builder delegate config as a JSON string (enabled/curator/finalizer)
+  cb_context_mode:
+    type: string
+    required: false
+    description: "Context preflight mode selector. Allowed values: full | deterministic | off | inherit. Omitted or inherit follows the server default (CLINKX_WORKFLOWS_CONTEXT_DEFAULT); full runs curator+finalizer delegate, deterministic seeds discovery with no delegate, off skips preflight. Allowed-value validation is owned by the resolver; no concrete mode default is materialized in YAML."
   context_images:
     type: string[]
     required: false
@@ -34,7 +115,10 @@ variables:
     description: Optional image paths (absolute, or relative to workspace root) shared with the council
 
 settings:
-  timeout_seconds: 1800
+  timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: debuggers
@@ -49,23 +133,26 @@ stages:
     calls:
       - id: debugger_a
         cli_name: codex
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-debugger.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_debug_debugger_v2
       - id: debugger_b
         cli_name: codex
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-debugger.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_debug_debugger_v2
       - id: debugger_c
         cli_name: claude
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-debugger.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_debug_debugger_v2
 
@@ -81,9 +168,10 @@ stages:
     calls:
       - id: cross_reviewer_a
         cli_name: codex
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-cross-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         anonymize_context: true
         context_from:
@@ -91,9 +179,10 @@ stages:
         validator_schema_id: council_debug_cross_reviewer_v4
       - id: cross_reviewer_b
         cli_name: codex
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-cross-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         anonymize_context: true
         context_from:
@@ -101,9 +190,10 @@ stages:
         validator_schema_id: council_debug_cross_reviewer_v4
       - id: cross_reviewer_c
         cli_name: claude
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-cross-reviewer.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         anonymize_context: true
         context_from:
@@ -122,6 +212,7 @@ stages:
     calls:
       - id: ranking
         cli_name: codex
+        timeout_seconds: 1200
         role: json-debug
         reducer: council_ranking_v1
         prompt: "Deterministic ranking reducer"
@@ -141,9 +232,10 @@ stages:
     calls:
       - id: chairman
         cli_name: codex
+        timeout_seconds: 1200
         role: json-debug
         prompt_template: council/debug-chairman.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         context_from:
           - debuggers

package/clinkx-workflows/workflows/council-default.yaml

@@ -22,6 +22,87 @@ variables:
     required: false
     default: []
     description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_bundle_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder bundle files copied into the workflow run
+  cb_task:
+    type: string
+    required: false
+    default: ""
+    description: Optional context_builder task override
+  cb_roots:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder source roots
+  cb_focus_paths:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder focus path refinement. Context preflight runs by default; these paths narrow selection when supplied.
+  cb_include_globs:
+    type: string[]
+    required: false
+    default: []
+    description: Context-builder include glob refinements
+  cb_exclude_globs:
+    type: string[]
+    required: false
+    default: ["**/*.po", "**/*.pot", "**/*.mo", "**/locales/**/*.json", "**/i18n/**/*.json"]
+    description: Context-builder exclude glob refinements
+  cb_search_terms:
+    type: string[]
+    required: false
+    default: []
+    description: Optional context_builder search term refinement. Context preflight runs by default; these terms narrow selection when supplied.
+  cb_profile:
+    type: string
+    required: false
+    default: implementation_medium
+    description: Context-builder budget profile
+  cb_budget_adapter:
+    type: string
+    required: false
+    description: Adapter whose context_builder budget defaults apply when context preflight runs (preflight runs by default unless cb_context_mode is off).
+  cb_allow_secrets:
+    type: boolean
+    required: false
+    description: When false, restores fail-closed context_builder source secret omission/redaction AND rejects high-confidence secrets in persisted task text (cb_task/user_request) before the run starts; default true includes secrets.
+  cb_budget_max_estimated_tokens:
+    type: number
+    required: false
+    description: Context-builder budget override — max estimated tokens
+  cb_budget_max_files:
+    type: number
+    required: false
+    description: Context-builder budget override — max files selected
+  cb_budget_max_scan_files:
+    type: number
+    required: false
+    description: Context-builder budget override — max files scanned
+  cb_budget_max_bytes_per_file:
+    type: number
+    required: false
+    description: Context-builder budget override — max bytes per file
+  cb_budget_max_total_bytes:
+    type: number
+    required: false
+    description: Context-builder budget override — max total bytes
+  cb_budget_max_search_results:
+    type: number
+    required: false
+    description: Context-builder budget override — max search results
+  cb_delegate:
+    type: string
+    required: false
+    default: ""
+    description: Optional context_builder delegate config as a JSON string (enabled/curator/finalizer)
+  cb_context_mode:
+    type: string
+    required: false
+    description: "Context preflight mode selector. Allowed values: full | deterministic | off | inherit. Omitted or inherit follows the server default (CLINKX_WORKFLOWS_CONTEXT_DEFAULT); full runs curator+finalizer delegate, deterministic seeds discovery with no delegate, off skips preflight. Allowed-value validation is owned by the resolver; no concrete mode default is materialized in YAML."
   context_images:
     type: string[]
     required: false
@@ -29,7 +110,10 @@ variables:
     description: Optional image paths (absolute, or relative to workspace root) shared with the council
 
 settings:
-  timeout_seconds: 1800
+  timeout_seconds: 10800
+  # Vendor/generated evidence the finalizer cannot see degrades the run
+  # (marked conditional) instead of failing it.
+  context_external_gap_policy: degrade
 
 stages:
   - id: members
@@ -42,25 +126,32 @@ stages:
       max_backoff_seconds: 30
     on_failure: continue
     calls:
+      # Optional per-call model/effort values require adapter-declared support:
+      #   model: gpt-5.4
+      #   effort: low
+      # Omission preserves CLI defaults. Runtime members replace these seed knobs.
       - id: member_a
         cli_name: codex
+        timeout_seconds: 1200
         role: json-default
         prompt_template: council/member.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_member_v2
       - id: member_b
         cli_name: codex
+        timeout_seconds: 1200
         role: json-default
         prompt_template: council/member.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_member_v2
       - id: member_c
         cli_name: claude
+        timeout_seconds: 1200
         role: json-default
         prompt_template: council/member.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         validator_schema_id: council_member_v2
 
@@ -76,8 +167,9 @@ stages:
     calls:
       - id: reviewer_a
         cli_name: codex
+        timeout_seconds: 1200
         role: json-default
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         prompt_template: council/reviewer.txt
         anonymize_context: true
@@ -86,8 +178,9 @@ stages:
         validator_schema_id: council_reviewer_v4
       - id: reviewer_b
         cli_name: codex
+        timeout_seconds: 1200
         role: json-default
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         prompt_template: council/reviewer.txt
         anonymize_context: true
@@ -96,8 +189,9 @@ stages:
         validator_schema_id: council_reviewer_v4
       - id: reviewer_c
         cli_name: claude
+        timeout_seconds: 1200
         role: json-default
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         prompt_template: council/reviewer.txt
         anonymize_context: true
@@ -117,6 +211,7 @@ stages:
     calls:
       - id: ranking
         cli_name: codex
+        timeout_seconds: 1200
         role: json-default
         reducer: council_ranking_v1
         prompt: "Deterministic ranking reducer"
@@ -136,9 +231,10 @@ stages:
     calls:
       - id: chairman
         cli_name: codex
+        timeout_seconds: 1200
         role: json-default
         prompt_template: council/chairman.txt
-        absolute_file_paths_from: context_files
+        absolute_file_paths_from: [context_files, context_bundle_files]
         images_from: context_images
         context_from:
           - members