aiox-core 5.0.5 → 5.0.8

package/pro/squads/aiox-sop/templates/decision-tree-template.yaml

@@ -0,0 +1,209 @@
+# =============================================================================
+# Decision Tree Template for ML SOPs
+# =============================================================================
+# Template: decision-tree-template.yaml | SOP Factory | Synkra AIOX
+# Used by: sop-ml-architect (*decision-tree command)
+#
+# Based on: BPMN 2.0 Gateways + exhaustive branching patterns
+#
+# Usage:
+#   1. Model each business rule as a decision node
+#   2. Ensure ALL branches have explicit targets (no implicit fall-through)
+#   3. Always include a "default" branch as catch-all
+#   4. Embed into step's decision_point field in ml-sop-yaml-template.yaml
+#
+# Decision Types:
+#   exclusive   - Exactly one branch taken (XOR gateway)
+#   inclusive   - One or more branches taken (OR gateway)
+#   parallel   - All branches taken simultaneously (AND gateway)
+#   complex    - Custom rule combining multiple conditions
+# =============================================================================
+
+# ==============================================================================
+# PATTERN 1: Simple Binary Decision (IF/ELSE)
+# ==============================================================================
+binary_decision:
+  id: "{{decision_id}}"
+  name: "{{decision_name}}"
+  type: "exclusive"
+  description: "{{what_is_being_decided}}"
+
+  evaluate: "{{variable_or_expression}}"       # What to evaluate
+
+  branches:
+    - condition: "{{true_condition}}"          # e.g., "status == 'approved'"
+      label: "Yes"
+      goto: "{{true_target_step}}"             # Step ID if condition true
+      action: "{{optional_action}}"            # Action before branching
+
+    - condition: "default"                     # REQUIRED: catch-all
+      label: "No"
+      goto: "{{false_target_step}}"            # Step ID if condition false
+
+# ==============================================================================
+# PATTERN 2: Multi-Branch Decision (SWITCH/CASE)
+# ==============================================================================
+multi_branch_decision:
+  id: "{{decision_id}}"
+  name: "{{decision_name}}"
+  type: "exclusive"
+  description: "{{what_is_being_decided}}"
+
+  evaluate: "{{variable_to_switch_on}}"        # e.g., "request.priority"
+
+  branches:
+    - condition: "{{value_1}}"                 # e.g., "priority == 'critical'"
+      label: "{{label_1}}"                     # e.g., "Critical Path"
+      goto: "{{target_step_1}}"
+
+    - condition: "{{value_2}}"                 # e.g., "priority == 'high'"
+      label: "{{label_2}}"
+      goto: "{{target_step_2}}"
+
+    - condition: "{{value_3}}"                 # e.g., "priority == 'medium'"
+      label: "{{label_3}}"
+      goto: "{{target_step_3}}"
+
+    - condition: "default"                     # REQUIRED: unmatched values
+      label: "{{default_label}}"
+      goto: "{{default_step}}"
+
+# ==============================================================================
+# PATTERN 3: Threshold Decision (Numeric Ranges)
+# ==============================================================================
+threshold_decision:
+  id: "{{decision_id}}"
+  name: "{{decision_name}}"
+  type: "exclusive"
+  description: "Route based on numeric threshold"
+
+  evaluate: "{{numeric_variable}}"             # e.g., "audit_score"
+
+  branches:
+    - condition: "value >= {{threshold_high}}"  # e.g., ">= 90"
+      label: "{{high_label}}"                  # e.g., "Certified"
+      goto: "{{high_target}}"
+
+    - condition: "value >= {{threshold_mid}}"   # e.g., ">= 70"
+      label: "{{mid_label}}"                   # e.g., "Approved"
+      goto: "{{mid_target}}"
+
+    - condition: "value >= {{threshold_low}}"   # e.g., ">= 50"
+      label: "{{low_label}}"                   # e.g., "Conditional"
+      goto: "{{low_target}}"
+
+    - condition: "default"                     # Below all thresholds
+      label: "{{fail_label}}"                  # e.g., "Rejected"
+      goto: "{{fail_target}}"
+
+# ==============================================================================
+# PATTERN 4: Inclusive Decision (Multiple Branches Can Fire)
+# ==============================================================================
+inclusive_decision:
+  id: "{{decision_id}}"
+  name: "{{decision_name}}"
+  type: "inclusive"                             # One or more branches taken
+  description: "{{what_conditions_to_check}}"
+
+  branches:
+    - condition: "{{condition_a}}"
+      label: "{{label_a}}"
+      goto: "{{target_a}}"
+      independent: true                        # Can fire alongside others
+
+    - condition: "{{condition_b}}"
+      label: "{{label_b}}"
+      goto: "{{target_b}}"
+      independent: true
+
+    - condition: "default"                     # If NO conditions match
+      label: "None matched"
+      goto: "{{fallback_step}}"
+
+  join_after: "{{convergence_step}}"           # Where branches reconverge
+
+# ==============================================================================
+# PATTERN 5: Compound Decision (Multiple Variables)
+# ==============================================================================
+compound_decision:
+  id: "{{decision_id}}"
+  name: "{{decision_name}}"
+  type: "complex"
+  description: "Decision based on multiple variables"
+
+  evaluate:
+    variables:
+      - "{{var_1}}"                            # e.g., "risk_level"
+      - "{{var_2}}"                            # e.g., "approval_status"
+
+  branches:
+    - condition: "{{var_1}} == 'high' AND {{var_2}} == 'pending'"
+      label: "High risk, pending approval"
+      goto: "{{escalation_step}}"
+
+    - condition: "{{var_1}} == 'high' AND {{var_2}} == 'approved'"
+      label: "High risk, approved"
+      goto: "{{proceed_with_caution_step}}"
+
+    - condition: "{{var_1}} != 'high'"
+      label: "Normal risk"
+      goto: "{{standard_step}}"
+
+    - condition: "default"
+      label: "Unhandled combination"
+      goto: "{{error_step}}"
+
+# ==============================================================================
+# PATTERN 6: Retry Loop Decision
+# ==============================================================================
+retry_decision:
+  id: "{{decision_id}}"
+  name: "Retry Gate"
+  type: "exclusive"
+  description: "Decide whether to retry or escalate after failure"
+
+  evaluate: "retry_count"
+
+  branches:
+    - condition: "retry_count < {{max_retries}}"
+      label: "Retry"
+      goto: "{{retry_target_step}}"            # Go back to the failed step
+      action: "increment_retry_count"
+
+    - condition: "default"
+      label: "Max retries exceeded"
+      goto: "{{escalation_step}}"
+      action: "log_retry_exhausted"
+
+# ==============================================================================
+# EMBEDDING GUIDE
+# ==============================================================================
+# To embed a decision in an ML SOP step:
+#
+#   steps:
+#     - id: "S003"
+#       name: "Evaluate Risk Level"
+#       action: "evaluate_risk"
+#       ...
+#       on_success: "S004"         # Default next (used if no decision match)
+#       on_failure: "ERR_01"
+#       decision_point:
+#         question: "What is the risk level?"
+#         evaluate: "risk_score"
+#         branches:
+#           - condition: "risk_score >= 80"
+#             label: "High Risk"
+#             goto: "S005"
+#           - condition: "risk_score >= 40"
+#             label: "Medium Risk"
+#             goto: "S004"
+#           - condition: "default"
+#             label: "Low Risk"
+#             goto: "S006"
+#
+# RULES:
+#   - Every decision MUST have a "default" branch
+#   - Conditions are evaluated top-to-bottom (first match wins for exclusive)
+#   - All goto targets MUST reference existing step IDs
+#   - Decision conditions must be mutually exclusive (for exclusive type)
+# ==============================================================================

package/pro/squads/aiox-sop/templates/extraction-output-template.md

@@ -0,0 +1,150 @@
+# SOP Extraction Output
+
+> **Template:** extraction-output-template.md | SOP Factory | Synkra AIOX
+>
+> Produced by @sop-extractor after process extraction. This is the handoff artifact
+> consumed by @sop-creator (human SOP) or @sop-ml-architect (ML SOP).
+> Fill all `{{placeholders}}` with actual values.
+
+---
+
+## Extraction Header
+
+| Field | Value |
+|---|---|
+| **Extraction ID** | EXT-{{sequential_number}} |
+| **Process Name** | {{process_name}} |
+| **Extraction Date** | {{YYYY-MM-DD}} |
+| **Extractor** | Ohno (sop-extractor) |
+| **Extraction Method** | {{Description / Document / Interview / Observation / Logs / Tribal}} |
+| **Source Material** | {{brief description of sources used}} |
+| **Target Format** | {{Human-Readable / ML / Both}} |
+| **Average Confidence** | {{X.XX}} |
+
+---
+
+## 1. Process Summary
+
+| Field | Value |
+|---|---|
+| **Name** | {{process_name}} |
+| **Purpose** | {{what this process accomplishes}} |
+| **Frequency** | {{how often: daily / weekly / on-demand / event-triggered}} |
+| **Criticality** | {{low / medium / high / critical}} |
+| **Typical Duration** | {{end-to-end time estimate}} |
+| **Trigger** | {{what initiates this process}} |
+| **Completion Indicator** | {{how you know it is done}} |
+
+---
+
+## 2. Actors & Systems
+
+| Actor/System | Type | Role in Process | Access Required |
+|---|---|---|---|
+| {{name}} | {{Human / System / Agent}} | {{what they do}} | {{permissions needed}} |
+
+---
+
+## 3. Step Sequence
+
+> Confidence markers: `[OBS] 1.0` | `[DOC] 0.9` | `[REP] 0.8` | `[COR] 0.7` | `[INF] 0.5` | `[ASM] 0.3` | `[UNK] 0.1`
+
+| # | Step | Actor | Tool/System | Expected Result | Conf. | Source |
+|---|------|-------|-------------|-----------------|:-----:|--------|
+| 1 | {{action in imperative mood}} | {{role}} | {{tool}} | {{what success looks like}} | {{[OBS]/[DOC]/[REP]/[COR]/[INF]/[ASM]/[UNK]}} | {{source reference}} |
+| 2 | {{action}} | {{role}} | {{tool}} | {{result}} | {{conf}} | {{source}} |
+| 3 | {{action}} | {{role}} | {{tool}} | {{result}} | {{conf}} | {{source}} |
+
+---
+
+## 4. Decision Points
+
+| At Step | Condition | Branch A (if true) | Branch B (if false) | Conf. | Source |
+|:-------:|-----------|---------------------|---------------------|:-----:|--------|
+| {{#}} | {{condition to evaluate}} | {{action / goto step}} | {{action / goto step}} | {{conf}} | {{source}} |
+
+> If no decision points exist, state: "No decision points identified in this process."
+
+---
+
+## 5. Exceptions & Edge Cases
+
+| ID | Trigger / Symptom | Frequency | Current Workaround | Severity | Conf. |
+|----|-------------------|-----------|--------------------|---------:|:-----:|
+| EX-01 | {{what goes wrong}} | {{rare / occasional / frequent}} | {{how it is handled today}} | {{low/med/high/critical}} | {{conf}} |
+
+---
+
+## 6. Tools & Systems
+
+| Tool/System | Version | Purpose in Process | Required/Optional | Access Request Method |
+|---|---|---|---|---|
+| {{name}} | {{version or N/A}} | {{what it does in the process}} | {{Required / Optional}} | {{how to get access}} |
+
+---
+
+## 7. Timing Data
+
+| Step # | Estimated Duration | Variability | Notes |
+|:------:|:------------------:|:-----------:|-------|
+| {{#}} | {{PTxM}} | {{low / medium / high}} | {{any timing notes}} |
+
+**Total Estimated Duration:** {{sum or range}}
+
+> If timing data is unavailable, state: "Timing data not captured in this extraction. Recommend time-motion study."
+
+---
+
+## 8. Gaps & Verification Needed
+
+> Items below the verification threshold (`0.8` by default) that require validation before SOP creation.
+
+| Item | Current Confidence | What Is Missing | Recommended Verification Method |
+|------|:------------------:|-----------------|-------------------------------|
+| {{step or fact}} | {{score}} | {{what evidence would raise confidence}} | {{interview / observation / test / document review}} |
+
+---
+
+## 9. Conflicts
+
+> Contradictory information found across sources. Both versions documented for resolution.
+
+| Conflict ID | Topic | Version A | Source A | Version B | Source B | Resolution |
+|:-----------:|-------|-----------|----------|-----------|----------|:----------:|
+| C-01 | {{what conflicts}} | {{version}} | {{source}} | {{version}} | {{source}} | {{Pending / Resolved: version chosen}} |
+
+> If no conflicts found, state: "No conflicting information identified across sources."
+
+---
+
+## 10. Source Provenance
+
+| Source ID | Type | Description | Date | Reliability |
+|:---------:|------|-------------|------|:-----------:|
+| SRC-01 | {{Document / Interview / Observation / Log / Tribal}} | {{description}} | {{date}} | {{High / Medium / Low}} |
+
+---
+
+## Handoff Summary
+
+| Check | Status |
+|-------|:------:|
+| All 10 sections populated | {{Yes / No (list missing)}} |
+| Average confidence ≥ 0.7 | {{Yes / No (actual: X.XX)}} |
+| All items below 0.8 listed in Gaps | {{Yes / No}} |
+| Conflicts resolved or documented | {{Yes / No}} |
+| Gaps explicitly listed | {{Yes / No}} |
+| Target format identified | {{Human / ML / Both}} |
+
+**Handoff Decision:** {{READY / READY WITH GAPS / INCOMPLETE}}
+
+**Handoff To:** {{@sop-creator / @sop-ml-architect / Both}}
+
+---
+
+**Extractor Signature:** _________________________ **Date:** _______________
+
+---
+
+*Extraction Output Template v1.0. Based on Taiichi Ohno's Gemba methodology.*
+*Template: extraction-output-template.md | SOP Factory | Synkra AIOX*

package/pro/squads/aiox-sop/templates/handoff-tmpl.yaml

@@ -0,0 +1,85 @@
+# Managed by materialize-map.py
+# Source: outputs/sinkra-squad/aiox-sop/map/20260329-190639-claude-opus/phase-handoff.yaml
+# Category: formalization
+
+handoff:
+  from_phase: '8'
+  from_agent: sinkra-qa
+  to_phase: '9'
+  timestamp: '2026-03-30T09:00:00-03:00'
+  artifacts_produced:
+  - file: sinkra_compliance_report.md
+    description: SINKRA v1.2 Map Readiness Compliance Report — 74.2/100 REVIEW, 5
+      applicable categories evaluated, 2 HIGH + 4 MEDIUM/LOW gaps documented with
+      resolution paths
+  - file: score_card.json
+    description: Structured compliance scorecard — 9 dimensions (5 applicable, 4 N/A),
+      per-check findings, design vs downstream gap classification, Phase 6 alignment
+      validation
+  decisions:
+  - REVIEW verdict (74.2/100) — not MAP-READY (80+). Score is in 60-79 REVIEW band.
+    Proceed is recommended conditionally, not automatically.
+  - Zero CRITICAL violations and zero auto-fail conditions — no hard block on Phase
+    9. REVIEW is not VETO.
+  - '2 HIGH design gaps must resolve before Phase 9 start: (1) token_assignments.json
+    families and (2) Clone HIL explicit field in T3.1/T3.3. Combined effort: 2.5h.'
+  - 4 categories N/A (ART, BU, ENT/INH, JLOG) — this is single-BU stateless operational
+    pipeline. Weights redistributed proportionally.
+  - Token gap is Phase 5 responsibility (composition-engineer scaffold not filled)
+    — not a Phase 3/4/6 design failure. Gap is implementation debt, not architecture
+    failure.
+  - Phase 6 (78.3) and Phase 8 (74.2) are coherent — delta 4.1 is expected (Phase
+    8 more granular on structural checks like tokens and Clone HIL). Mandamentos audit
+    identical in both.
+  - 'Deterministic baseline 63.8 vs QA score 74.2: gap is 10.4 points explained by
+    (a) accountable human IS defined via escalation_path (not a dedicated field),
+    (b) token scaffold penalized by scorer but maps to known gap, (c) N/A categories
+    not penalizing in QA scoring.'
+  warnings:
+  - token_assignments.json MUST be filled before Phase 9 materializes any squad files
+    — token families drive Accountability and Mode token binding during materialization.
+  - T3.1 and T3.3 Clone tasks need human_review_trigger field added — this is a contract
+    completeness requirement, not a runtime issue. Without it, Clone HIL is informal.
+  - risk_register.json (P1) and scaling_strategy.md (P2) from Phase 6 corrective actions
+    are still pending — infrastructure-mapper should create these in parallel with
+    Phase 9.
+  - 'Mandamento 6 PARTIAL_PASS: baseline_kpis{} section missing from workflow_definition.json
+    — process should not be declared ''improved'' without measured baseline to compare
+    against.'
+  - Domain language inconsistency (PT-BR vs English) is cosmetic — no logic error
+    — but materialization tooling should pick one standard to avoid field lookup failures.
+  checkpoint:
+    id: SINKRA_QA_GATE
+    verdict: REVIEW
+    score: 74.2
+    details:
+      critical_violations: 0
+      auto_fail_triggered: false
+      high_violations: 2
+      medium_violations: 4
+      categories_applicable: 5
+      categories_na: 4
+      deterministic_baseline: 63.8
+      phase6_axioma_score: 78.3
+      mandamentos_pass: 9
+      mandamentos_partial: 1
+  next_agent_focus:
+  - 'Phase 9 (squad materializer / sinkra-chief): materialize the map into squads/aiox-sop/
+    directory structure following SINKRA squad pattern (config.yaml, agents/, tasks/,
+    workflows/, templates/, data/).'
+  - 'CRITICAL pre-condition: Verify token_assignments.json is filled (9 token families)
+    before generating squad files — token data drives Accountability token binding.'
+  - 'CRITICAL pre-condition: Verify T3.1 and T3.3 in task_definitions.json have human_review_trigger
+    field — needed for correct Clone task materialization.'
+  - Use workflow_definition.json (5 workflows) + task_definitions.json (27 tasks)
+    + executor_matrix.json as the three primary source files for squad materialization.
+  - Materialize 5 workflow organisms as workflow YAML files in squads/aiox-sop/workflows/.
+  - Materialize 27 task atoms as task markdown/YAML files in squads/aiox-sop/tasks/.
+  - Materialize 2 Clone executor tasks (T3.1, T3.3) with human_review_trigger in task
+    definition.
+  - 'Create squads/aiox-sop/config.yaml with SINKRA v3.1 fields: artifact_contracts,
+    bu_mapping (single-BU), supported_modes.'
+  - Corrective actions P1 (risk_register.json), P2 (scaling_strategy.md), P3 (baseline_kpis)
+    can run in parallel — do NOT block Phase 9 on these.
+  - 'After materialization: run validate-squad script against squads/aiox-sop/ to
+    confirm physical structure matches the map.'

package/pro/squads/aiox-sop/templates/ml-sop-json-template.json

@@ -0,0 +1,208 @@
+{
+  "$comment": "ML-SOP JSON Template | SOP Factory | Synkra AIOX",
+  "$schema_ref": "data/sop-ml-schema.yaml v1.0.0",
+  "usage": "Copy, replace {{placeholders}}, validate against schema. For API consumption and strict schema validation.",
+
+  "sop": {
+    "id": "{{sop_id}}",
+    "version": "{{version}}",
+    "title": "{{sop_title}}",
+    "purpose": "{{purpose_statement}}",
+
+    "classification": {
+      "domain": "{{domain}}",
+      "category": "{{category}}",
+      "risk_level": "{{risk_level}}",
+      "compliance_tags": ["{{standard_1}}"]
+    },
+    "status": "DRAFT",
+    "effective_date": "{{YYYY-MM-DD}}",
+    "review_date": "{{YYYY-MM-DD}}",
+
+    "trigger": {
+      "type": "{{trigger_type}}",
+      "description": "{{trigger_description}}",
+      "event": "{{event_name}}",
+      "schedule": "{{cron_expression}}",
+      "source": "{{trigger_source}}",
+      "conditions": [
+        {
+          "field": "{{condition_field}}",
+          "operator": "{{operator}}",
+          "value": "{{expected_value}}"
+        }
+      ]
+    },
+
+    "context": {
+      "tools": [
+        {
+          "id": "{{tool_id}}",
+          "name": "{{tool_name}}",
+          "type": "{{tool_type}}",
+          "version": "{{min_version}}",
+          "required": true
+        }
+      ],
+      "permissions": [
+        {
+          "resource": "{{resource}}",
+          "action": "{{permission}}",
+          "scope": "{{scope}}",
+          "justification": "{{why_needed}}"
+        }
+      ],
+      "environment": [
+        {
+          "key": "{{ENV_VAR}}",
+          "description": "{{var_description}}",
+          "required": true,
+          "sensitive": false
+        }
+      ],
+      "input": [
+        {
+          "name": "{{input_name}}",
+          "type": "{{input_type}}",
+          "required": true,
+          "description": "{{input_description}}",
+          "validation": "{{regex_or_rule}}"
+        }
+      ]
+    },
+
+    "steps": [
+      {
+        "id": "S001",
+        "name": "{{step_name}}",
+        "action": "{{verb_noun}}",
+        "description": "{{step_description}}",
+        "performer": "{{role_or_agent}}",
+        "critical": false,
+        "estimated_duration": "{{PTxM}}",
+        "tool": {
+          "id": "{{tool_ref}}",
+          "command": "{{command_or_endpoint}}",
+          "timeout": "{{PTxM}}"
+        },
+        "input": [
+          {
+            "name": "{{param_name}}",
+            "type": "{{param_type}}",
+            "source": "{{source}}",
+            "value": "{{value_or_ref}}",
+            "required": true
+          }
+        ],
+        "output": [
+          {
+            "name": "{{output_name}}",
+            "type": "{{output_type}}",
+            "store_as": "{{variable_name}}"
+          }
+        ],
+        "validation": {
+          "type": "{{val_type}}",
+          "rules": [
+            {
+              "field": "{{field}}",
+              "operator": "{{op}}",
+              "expected": "{{expected}}",
+              "message": "{{failure_message}}"
+            }
+          ]
+        },
+        "on_success": "S002",
+        "on_failure": "{{error_handler_id}}",
+        "decision_point": null
+      }
+    ],
+
+    "error_handling": {
+      "handlers": [
+        {
+          "id": "{{handler_id}}",
+          "name": "{{handler_name}}",
+          "trigger_on": [
+            { "error_type": "{{error_type}}" }
+          ],
+          "severity": "{{severity}}",
+          "actions": [
+            {
+              "type": "{{action_type}}",
+              "config": {
+                "max_retries": 3,
+                "retry_delay": "PT30S",
+                "backoff": "exponential"
+              }
+            }
+          ]
+        }
+      ],
+      "fallback": {
+        "action": "abort",
+        "notify": ["{{fallback_recipient}}"],
+        "log_level": "error"
+      },
+      "global_timeout": "{{PT2H}}"
+    },
+
+    "quality_gate": {
+      "enabled": true,
+      "criteria": [
+        {
+          "name": "{{criteria_name}}",
+          "type": "{{criteria_type}}",
+          "target": "{{target_value}}",
+          "actual": null,
+          "weight": 0.5
+        }
+      ],
+      "pass_threshold": 0.8,
+      "on_fail": "block"
+    },
+
+    "outputs": {
+      "artifacts": [
+        {
+          "name": "{{artifact_name}}",
+          "type": "{{artifact_type}}",
+          "format": "{{format}}",
+          "destination": "{{path_or_url}}",
+          "retention": "{{P1Y}}"
+        }
+      ],
+      "notifications": {
+        "on_complete": [
+          { "channel": "{{channel}}", "recipients": ["{{recipient}}"] }
+        ],
+        "on_failure": [
+          { "channel": "{{channel}}", "recipients": ["{{recipient}}"] }
+        ]
+      }
+    },
+
+    "metadata": {
+      "created_by": "sop-ml-architect",
+      "created_at": "{{ISO-8601-datetime}}",
+      "updated_by": "{{updater}}",
+      "updated_at": "{{ISO-8601-datetime}}",
+      "owner": "{{owner_role}}",
+      "department": "{{department}}",
+      "tags": ["{{tag1}}", "{{tag2}}"],
+      "review_cycle": "P90D",
+      "regulatory_refs": [
+        { "standard": "{{standard}}", "clause": "{{clause}}" }
+      ],
+      "related_sops": ["{{related_sop_id}}"],
+      "change_log": [
+        {
+          "version": "{{version}}",
+          "date": "{{YYYY-MM-DD}}",
+          "author": "{{author}}",
+          "summary": "{{change_summary}}"
+        }
+      ]
+    }
+  }
+}