clinkx 0.2.1 → 0.2.3

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

@@ -0,0 +1,147 @@
+name: council-answer
+description: "Answer council: specialists respond, cross-reviewers evaluate, chairman synthesizes (1-10 members)"
+version: 1.0.0
+
+variables:
+  user_request:
+    type: string
+    required: true
+    description: The question to be answered
+  mode:
+    type: string
+    required: false
+    default: answer_questions
+    description: Answer mode
+  rubric:
+    type: string
+    required: false
+    default: '[{"name":"correctness","description":"Factual and logical accuracy","weight":30},{"name":"completeness","description":"Covers the full question and important nuances","weight":20},{"name":"clarity","description":"Clear explanation accessible to the audience","weight":20},{"name":"helpfulness","description":"Practical value and actionability","weight":15},{"name":"uncertainty_handling","description":"Honest about unknowns and confidence levels","weight":15}]'
+    description: Evaluation rubric for specialists and reviewers
+  context_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_images:
+    type: string[]
+    required: false
+    default: []
+    description: Optional image paths (absolute, or relative to workspace root) shared with the council
+
+settings:
+  timeout_seconds: 1800
+
+stages:
+  - id: specialists
+    description: "Council members propose answers independently"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: continue
+    calls:
+      - id: specialist_a
+        cli_name: codex
+        role: json-default
+        prompt_template: council/answer-specialist.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_answer_specialist_v2
+      - id: specialist_b
+        cli_name: codex
+        role: json-default
+        prompt_template: council/answer-specialist.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_answer_specialist_v2
+      - id: specialist_c
+        cli_name: claude
+        role: json-default
+        prompt_template: council/answer-specialist.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_answer_specialist_v2
+
+  - id: cross_review
+    description: "Cross-reviewers evaluate proposals anonymously"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: continue
+    calls:
+      - id: cross_reviewer_a
+        cli_name: codex
+        role: json-default
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        prompt_template: council/answer-cross-reviewer.txt
+        anonymize_context: true
+        context_from:
+          - specialists
+        validator_schema_id: council_answer_cross_reviewer_v4
+      - id: cross_reviewer_b
+        cli_name: codex
+        role: json-default
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        prompt_template: council/answer-cross-reviewer.txt
+        anonymize_context: true
+        context_from:
+          - specialists
+        validator_schema_id: council_answer_cross_reviewer_v4
+      - id: cross_reviewer_c
+        cli_name: claude
+        role: json-default
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        prompt_template: council/answer-cross-reviewer.txt
+        anonymize_context: true
+        context_from:
+          - specialists
+        validator_schema_id: council_answer_cross_reviewer_v4
+
+  - id: ranking_analysis
+    description: "Deterministic ranking of proposals"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 0
+      backoff_seconds: 0
+      max_backoff_seconds: 0
+    on_failure: continue
+    calls:
+      - id: ranking
+        cli_name: codex
+        role: json-default
+        reducer: council_ranking_v1
+        prompt: "Deterministic ranking reducer"
+        context_from:
+          - cross_review
+        validator_schema_id: council_ranking_reducer_v1
+
+  - id: chairman
+    description: "Chairman synthesizes final answer"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: abort
+    calls:
+      - id: chairman
+        cli_name: codex
+        role: json-default
+        prompt_template: council/answer-chairman.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        context_from:
+          - specialists
+          - cross_review
+          - ranking_analysis
+        validator_schema_id: council_answer_chairman_v1

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

@@ -0,0 +1,152 @@
+name: council-code-review
+description: "Code review council: reviewers assess, cross-reviewers evaluate, chairman decides (1-10 members)"
+version: 1.0.0
+
+variables:
+  user_request:
+    type: string
+    required: true
+    description: The code review request including context
+  mode:
+    type: string
+    required: false
+    default: code_review
+    description: Review mode
+  rubric:
+    type: string
+    required: false
+    default: '[{"name":"correctness","description":"Logic correctness and bug detection","weight":25},{"name":"security","description":"Security vulnerability identification","weight":20},{"name":"performance","description":"Performance impact analysis","weight":15},{"name":"readability","description":"Code readability and maintainability","weight":15},{"name":"test_coverage","description":"Test adequacy and coverage gaps","weight":15},{"name":"api_stability","description":"API stability and backwards compatibility","weight":10}]'
+    description: Evaluation rubric for reviewers
+  diff_context:
+    type: string
+    required: false
+    default: ""
+    description: Optional diff or code context to review
+  context_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_images:
+    type: string[]
+    required: false
+    default: []
+    description: Optional image paths (absolute, or relative to workspace root) shared with the council
+
+settings:
+  timeout_seconds: 1800
+
+stages:
+  - id: reviewers
+    description: "Council members review code independently"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: continue
+    calls:
+      - id: reviewer_a
+        cli_name: codex
+        role: json-codereviewer
+        prompt_template: council/code-review-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_code_review_reviewer_v1
+      - id: reviewer_b
+        cli_name: codex
+        role: json-codereviewer
+        prompt_template: council/code-review-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_code_review_reviewer_v1
+      - id: reviewer_c
+        cli_name: claude
+        role: json-codereviewer
+        prompt_template: council/code-review-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_code_review_reviewer_v1
+
+  - id: cross_review
+    description: "Cross-reviewers evaluate reviews anonymously"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: continue
+    calls:
+      - id: cross_reviewer_a
+        cli_name: codex
+        role: json-codereviewer
+        prompt_template: council/code-review-cross-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        anonymize_context: true
+        context_from:
+          - reviewers
+        validator_schema_id: council_code_review_cross_reviewer_v4
+      - id: cross_reviewer_b
+        cli_name: codex
+        role: json-codereviewer
+        prompt_template: council/code-review-cross-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        anonymize_context: true
+        context_from:
+          - reviewers
+        validator_schema_id: council_code_review_cross_reviewer_v4
+      - id: cross_reviewer_c
+        cli_name: claude
+        role: json-codereviewer
+        prompt_template: council/code-review-cross-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        anonymize_context: true
+        context_from:
+          - reviewers
+        validator_schema_id: council_code_review_cross_reviewer_v4
+
+  - id: ranking_analysis
+    description: "Deterministic ranking of reviews"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 0
+      backoff_seconds: 0
+      max_backoff_seconds: 0
+    on_failure: continue
+    calls:
+      - id: ranking
+        cli_name: codex
+        role: json-codereviewer
+        reducer: council_ranking_v1
+        prompt: "Deterministic ranking reducer"
+        context_from:
+          - cross_review
+        validator_schema_id: council_ranking_reducer_v1
+
+  - id: chairman
+    description: "Chairman synthesizes code review verdict"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: abort
+    calls:
+      - id: chairman
+        cli_name: codex
+        role: json-codereviewer
+        prompt_template: council/code-review-chairman.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        context_from:
+          - reviewers
+          - cross_review
+          - ranking_analysis
+        validator_schema_id: council_code_review_chairman_v1

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

@@ -0,0 +1,152 @@
+name: council-debug
+description: "Debug council: debuggers analyze, cross-reviewers evaluate, chairman decides (1-10 members)"
+version: 1.0.0
+
+variables:
+  user_request:
+    type: string
+    required: true
+    description: The debugging request including bug description
+  mode:
+    type: string
+    required: false
+    default: debug
+    description: Debug mode
+  rubric:
+    type: string
+    required: false
+    default: '[{"name":"diagnostic_depth","description":"Breadth and depth of causal analysis","weight":25},{"name":"hypothesis_quality","description":"Plausibility and discriminative power of hypotheses","weight":20},{"name":"consistency_with_evidence","description":"Grounding in logs, code, and symptoms","weight":25},{"name":"safety_side_effect_awareness","description":"Awareness of rollback risk and blast radius","weight":15},{"name":"clarity_of_next_steps","description":"Actionable diagnostic and remediation plan","weight":15}]'
+    description: Evaluation rubric for debuggers and reviewers
+  error_context:
+    type: string
+    required: false
+    default: ""
+    description: Optional error logs, stack traces, or reproduction steps
+  context_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_images:
+    type: string[]
+    required: false
+    default: []
+    description: Optional image paths (absolute, or relative to workspace root) shared with the council
+
+settings:
+  timeout_seconds: 1800
+
+stages:
+  - id: debuggers
+    description: "Council members diagnose the issue independently"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: continue
+    calls:
+      - id: debugger_a
+        cli_name: codex
+        role: json-debug
+        prompt_template: council/debug-debugger.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_debug_debugger_v2
+      - id: debugger_b
+        cli_name: codex
+        role: json-debug
+        prompt_template: council/debug-debugger.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_debug_debugger_v2
+      - id: debugger_c
+        cli_name: claude
+        role: json-debug
+        prompt_template: council/debug-debugger.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_debug_debugger_v2
+
+  - id: cross_review
+    description: "Cross-reviewers evaluate diagnoses anonymously"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: continue
+    calls:
+      - id: cross_reviewer_a
+        cli_name: codex
+        role: json-debug
+        prompt_template: council/debug-cross-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        anonymize_context: true
+        context_from:
+          - debuggers
+        validator_schema_id: council_debug_cross_reviewer_v4
+      - id: cross_reviewer_b
+        cli_name: codex
+        role: json-debug
+        prompt_template: council/debug-cross-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        anonymize_context: true
+        context_from:
+          - debuggers
+        validator_schema_id: council_debug_cross_reviewer_v4
+      - id: cross_reviewer_c
+        cli_name: claude
+        role: json-debug
+        prompt_template: council/debug-cross-reviewer.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        anonymize_context: true
+        context_from:
+          - debuggers
+        validator_schema_id: council_debug_cross_reviewer_v4
+
+  - id: ranking_analysis
+    description: "Deterministic ranking of diagnoses"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 0
+      backoff_seconds: 0
+      max_backoff_seconds: 0
+    on_failure: continue
+    calls:
+      - id: ranking
+        cli_name: codex
+        role: json-debug
+        reducer: council_ranking_v1
+        prompt: "Deterministic ranking reducer"
+        context_from:
+          - cross_review
+        validator_schema_id: council_ranking_reducer_v1
+
+  - id: chairman
+    description: "Chairman synthesizes debugging verdict"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: abort
+    calls:
+      - id: chairman
+        cli_name: codex
+        role: json-debug
+        prompt_template: council/debug-chairman.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        context_from:
+          - debuggers
+          - cross_review
+          - ranking_analysis
+        validator_schema_id: council_debug_chairman_v1

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

@@ -0,0 +1,147 @@
+name: council-default
+description: "Multi-agent council: members propose, cross-reviewers evaluate, chairman decides (1-10 members)"
+version: 1.0.0
+
+variables:
+  user_request:
+    type: string
+    required: true
+    description: The user's request to be evaluated by the council
+  deliberation_style:
+    type: string
+    required: false
+    default: balanced
+    description: "Council deliberation style: balanced, creative, or conservative"
+  rubric:
+    type: string
+    required: false
+    default: '[{"name":"correctness","description":"Technical truth and fidelity to provided files","weight":25},{"name":"completeness","description":"Covers the full request and major edge cases","weight":20},{"name":"clarity","description":"Readable structure and directness","weight":15},{"name":"safety","description":"No harmful or incorrect recommendations","weight":10},{"name":"practicality","description":"Implementation realism and operational cost","weight":15},{"name":"depth_of_reasoning","description":"Analytical depth and evidence quality","weight":15}]'
+    description: Evaluation rubric for council members and reviewers
+  context_files:
+    type: string[]
+    required: false
+    default: []
+    description: Optional file paths (absolute, or relative to workspace root) shared with the council
+  context_images:
+    type: string[]
+    required: false
+    default: []
+    description: Optional image paths (absolute, or relative to workspace root) shared with the council
+
+settings:
+  timeout_seconds: 1800
+
+stages:
+  - id: members
+    description: "Council members propose solutions independently"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 5
+      max_backoff_seconds: 30
+    on_failure: continue
+    calls:
+      - id: member_a
+        cli_name: codex
+        role: json-default
+        prompt_template: council/member.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_member_v2
+      - id: member_b
+        cli_name: codex
+        role: json-default
+        prompt_template: council/member.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_member_v2
+      - id: member_c
+        cli_name: claude
+        role: json-default
+        prompt_template: council/member.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        validator_schema_id: council_member_v2
+
+  - id: reviewers
+    description: "Cross-reviewers evaluate proposals anonymously"
+    parallel: true
+    retry:
+      mode: all
+      max_retries: 1
+      backoff_seconds: 5
+      max_backoff_seconds: 30
+    on_failure: continue
+    calls:
+      - id: reviewer_a
+        cli_name: codex
+        role: json-default
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        prompt_template: council/reviewer.txt
+        anonymize_context: true
+        context_from:
+          - members
+        validator_schema_id: council_reviewer_v4
+      - id: reviewer_b
+        cli_name: codex
+        role: json-default
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        prompt_template: council/reviewer.txt
+        anonymize_context: true
+        context_from:
+          - members
+        validator_schema_id: council_reviewer_v4
+      - id: reviewer_c
+        cli_name: claude
+        role: json-default
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        prompt_template: council/reviewer.txt
+        anonymize_context: true
+        context_from:
+          - members
+        validator_schema_id: council_reviewer_v4
+
+  - id: ranking_analysis
+    description: "Deterministic ranking of proposals"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 0
+      backoff_seconds: 0
+      max_backoff_seconds: 0
+    on_failure: continue
+    calls:
+      - id: ranking
+        cli_name: codex
+        role: json-default
+        reducer: council_ranking_v1
+        prompt: "Deterministic ranking reducer"
+        context_from:
+          - reviewers
+        validator_schema_id: council_ranking_reducer_v1
+
+  - id: chairman
+    description: "Chairman synthesizes final verdict"
+    parallel: false
+    retry:
+      mode: transport_only
+      max_retries: 1
+      backoff_seconds: 10
+      max_backoff_seconds: 60
+    on_failure: abort
+    calls:
+      - id: chairman
+        cli_name: codex
+        role: json-default
+        prompt_template: council/chairman.txt
+        absolute_file_paths_from: context_files
+        images_from: context_images
+        context_from:
+          - members
+          - reviewers
+          - ranking_analysis
+        validator_schema_id: council_chairman_v1