agentic-orchestrator 0.1.2 → 0.1.4

package/agentic/orchestrator/schemas/policy.schema.json

@@ -22,21 +22,37 @@
     "rbac"
   ],
   "properties": {
-    "version": { "type": "number" },
+    "version": {
+      "type": "number"
+    },
     "commit_policy": {
       "type": "object",
-      "required": ["allow_commit", "allow_merge"],
+      "required": [
+        "allow_commit",
+        "allow_merge"
+      ],
       "properties": {
-        "allow_commit": { "type": "boolean" },
-        "allow_merge": { "type": "boolean" }
+        "allow_commit": {
+          "type": "boolean"
+        },
+        "allow_merge": {
+          "type": "boolean"
+        }
       }
     },
     "patch_policy": {
       "type": "object",
-      "required": ["enforce_plan", "enforce_allowed_areas"],
+      "required": [
+        "enforce_plan",
+        "enforce_allowed_areas"
+      ],
       "properties": {
-        "enforce_plan": { "type": "boolean" },
-        "enforce_allowed_areas": { "type": "boolean" }
+        "enforce_plan": {
+          "type": "boolean"
+        },
+        "enforce_allowed_areas": {
+          "type": "boolean"
+        }
       }
     },
     "locks": {
@@ -52,43 +68,91 @@
       "properties": {
         "resources": {
           "type": "array",
-          "items": { "type": "string", "minLength": 1 }
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
         },
         "contract_to_resource": {
           "type": "object",
-          "required": ["openapi", "events", "db"],
+          "required": [
+            "openapi",
+            "events",
+            "db"
+          ],
           "properties": {
-            "openapi": { "type": "string" },
-            "events": { "type": "string" },
-            "db": { "type": "string" }
+            "openapi": {
+              "type": "string"
+            },
+            "events": {
+              "type": "string"
+            },
+            "db": {
+              "type": "string"
+            }
           }
         },
-        "lease_ttl_seconds": { "type": "number", "minimum": 1 },
-        "acquire_behavior": { "type": "string", "enum": ["wait", "fail"] },
-        "default_wait_timeout_seconds": { "type": "number", "minimum": 1 },
+        "lease_ttl_seconds": {
+          "type": "number",
+          "minimum": 1
+        },
+        "acquire_behavior": {
+          "type": "string",
+          "enum": [
+            "wait",
+            "fail"
+          ]
+        },
+        "default_wait_timeout_seconds": {
+          "type": "number",
+          "minimum": 1
+        },
         "acquire_backoff": {
           "type": "object",
-          "required": ["initial_ms", "max_ms", "multiplier", "jitter_ms"],
+          "required": [
+            "initial_ms",
+            "max_ms",
+            "multiplier",
+            "jitter_ms"
+          ],
           "properties": {
-            "initial_ms": { "type": "number", "minimum": 1 },
-            "max_ms": { "type": "number", "minimum": 1 },
-            "multiplier": { "type": "number", "minimum": 1 },
-            "jitter_ms": { "type": "number", "minimum": 0 }
+            "initial_ms": {
+              "type": "number",
+              "minimum": 1
+            },
+            "max_ms": {
+              "type": "number",
+              "minimum": 1
+            },
+            "multiplier": {
+              "type": "number",
+              "minimum": 1
+            },
+            "jitter_ms": {
+              "type": "number",
+              "minimum": 0
+            }
           }
         }
       }
     },
     "protected_areas": {
       "type": "array",
-      "items": { "type": "string" }
+      "items": {
+        "type": "string"
+      }
     },
     "exclusive_areas": {
       "type": "array",
-      "items": { "type": "string" }
+      "items": {
+        "type": "string"
+      }
     },
     "required_modes": {
       "type": "array",
-      "items": { "type": "string" },
+      "items": {
+        "type": "string"
+      },
       "minItems": 1
     },
     "required_merge_mode": {
@@ -96,76 +160,150 @@
     },
     "collision_policy": {
       "type": "string",
-      "enum": ["reject", "block"]
+      "enum": [
+        "reject",
+        "block"
+      ]
     },
     "config_precedence": {
       "type": "object"
     },
     "path_rules": {
       "type": "object",
-      "required": ["matching", "normalize_paths", "allow_symlink_traversal"],
+      "required": [
+        "matching",
+        "normalize_paths",
+        "allow_symlink_traversal"
+      ],
       "properties": {
-        "matching": { "type": "string", "enum": ["repo_prefix", "glob"] },
-        "normalize_paths": { "type": "boolean", "const": true },
-        "allow_symlink_traversal": { "type": "boolean" }
+        "matching": {
+          "type": "string",
+          "enum": [
+            "repo_prefix",
+            "glob"
+          ]
+        },
+        "normalize_paths": {
+          "type": "boolean",
+          "const": true
+        },
+        "allow_symlink_traversal": {
+          "type": "boolean"
+        }
       }
     },
     "execution": {
       "type": "object",
-      "required": ["default_step_timeout_seconds", "retry_policy", "env_allowlist"],
+      "required": [
+        "default_step_timeout_seconds",
+        "retry_policy",
+        "env_allowlist"
+      ],
       "properties": {
-        "default_step_timeout_seconds": { "type": "number", "minimum": 1 },
+        "default_step_timeout_seconds": {
+          "type": "number",
+          "minimum": 1
+        },
         "retry_policy": {
           "type": "object",
-          "required": ["transient_max_retries", "transient_error_codes", "non_retryable_error_codes"],
+          "required": [
+            "transient_max_retries",
+            "transient_error_codes",
+            "non_retryable_error_codes"
+          ],
           "properties": {
-            "transient_max_retries": { "type": "number", "minimum": 0 },
+            "transient_max_retries": {
+              "type": "number",
+              "minimum": 0
+            },
             "transient_error_codes": {
               "type": "array",
-              "items": { "type": "number" }
+              "items": {
+                "type": "number"
+              }
             },
             "non_retryable_error_codes": {
               "type": "array",
-              "items": { "type": "number" }
+              "items": {
+                "type": "number"
+              }
             }
           }
         },
         "env_allowlist": {
           "type": "array",
-          "items": { "type": "string" }
+          "items": {
+            "type": "string"
+          }
         }
       }
     },
     "implementation": {
       "type": "object",
-      "required": ["workspace"],
+      "required": [
+        "workspace"
+      ],
       "properties": {
-        "workspace": { "type": "string", "const": "nx" }
+        "workspace": {
+          "type": "string",
+          "const": "nx"
+        }
       }
     },
     "testing": {
       "type": "object",
-      "required": ["framework", "coverage"],
+      "required": [
+        "framework",
+        "coverage"
+      ],
       "properties": {
-        "framework": { "type": "string", "const": "vitest" },
+        "framework": {
+          "type": "string",
+          "const": "vitest"
+        },
         "coverage": {
           "type": "object",
-          "required": ["minimums", "targets"],
+          "required": [
+            "minimums",
+            "targets"
+          ],
           "properties": {
             "minimums": {
               "type": "object",
-              "required": ["line", "branch"],
+              "required": [
+                "line",
+                "branch"
+              ],
               "properties": {
-                "line": { "type": "number", "minimum": 0, "maximum": 1 },
-                "branch": { "type": "number", "minimum": 0, "maximum": 1 }
+                "line": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "branch": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                }
               }
             },
             "targets": {
               "type": "object",
-              "required": ["line", "branch"],
+              "required": [
+                "line",
+                "branch"
+              ],
               "properties": {
-                "line": { "type": "number", "minimum": 0, "maximum": 1 },
-                "branch": { "type": "number", "minimum": 0, "maximum": 1 }
+                "line": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "branch": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                }
               }
             }
           }
@@ -174,30 +312,58 @@
     },
     "merge_policy": {
       "type": "object",
-      "required": ["require_user_approval", "allowed_strategies"],
+      "required": [
+        "require_user_approval",
+        "allowed_strategies"
+      ],
       "properties": {
-        "require_user_approval": { "type": "boolean" },
+        "require_user_approval": {
+          "type": "boolean"
+        },
         "allowed_strategies": {
           "type": "array",
           "items": {
             "type": "string",
-            "enum": ["merge_commit", "squash", "rebase"]
+            "enum": [
+              "merge_commit",
+              "squash",
+              "rebase"
+            ]
           }
         }
       }
     },
     "worktree": {
       "type": "object",
-      "required": ["base_branch"],
+      "required": [
+        "base_branch"
+      ],
       "properties": {
-        "base_branch": { "type": "string", "minLength": 1 }
+        "base_branch": {
+          "type": "string",
+          "minLength": 1
+        },
+        "post_create": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "symlinks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
       }
     },
     "rbac": {
       "type": "object",
       "additionalProperties": {
         "type": "array",
-        "items": { "type": "string" }
+        "items": {
+          "type": "string"
+        }
       }
     },
     "recovery": {
@@ -220,6 +386,237 @@
           "type": "integer",
           "minimum": 0,
           "default": 6
+        },
+        "max_parallel_gate_runs": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 2
+        },
+        "agent_idle_threshold_ms": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 300000
+        }
+      }
+    },
+    "cleanup": {
+      "type": "object",
+      "properties": {
+        "auto_after_merge": {
+          "type": "boolean"
+        },
+        "grace_period_seconds": {
+          "type": "number",
+          "minimum": 0
+        }
+      }
+    },
+    "dashboard": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "port": {
+          "type": "number",
+          "minimum": 1,
+          "maximum": 65535
+        }
+      }
+    },
+    "notifications": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "channels": {
+          "type": "object",
+          "properties": {
+            "desktop": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                }
+              }
+            },
+            "slack": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "webhook": {
+                  "type": "string"
+                },
+                "channel": {
+                  "type": "string"
+                }
+              }
+            },
+            "webhook": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "url": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "routing": {
+          "type": "object",
+          "properties": {
+            "critical": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "urgent": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "action": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "warning": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "info": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "reactions": {
+      "type": "object",
+      "properties": {
+        "gate_failed": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "max_retries": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "action": {
+              "type": "string",
+              "enum": [
+                "retry_with_agent_repair",
+                "notify_only"
+              ]
+            },
+            "escalate_after": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "retry_delay_ms": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "agent_stuck": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "action": {
+              "type": "string"
+            },
+            "idle_threshold_ms": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "escalate_after": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "collision_detected": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "action": {
+              "type": "string"
+            }
+          }
+        },
+        "ready_to_merge": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "action": {
+              "type": "string"
+            }
+          }
+        },
+        "changes_requested": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "action": {
+              "type": "string"
+            },
+            "escalate_after": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "per_feature_limit_usd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "alert_threshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      }
+    },
+    "issue_tracker": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "type": { "type": "string", "enum": ["github", "linear", "jira"] },
+        "config": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
         }
       }
     }

package/agentic/orchestrator/schemas/state.schema.json

@@ -82,6 +82,22 @@
         }
       }
     },
+    "pr": {
+      "type": "object",
+      "properties": {
+        "number": { "type": "integer" },
+        "url": { "type": "string" },
+        "ci_status": { "type": "string", "enum": ["passing", "failing", "pending", "none"] },
+        "review_decision": { "type": "string", "enum": ["approved", "changes_requested", "pending", "none"] },
+        "merge_ready": { "type": "boolean" },
+        "pending_review_threads": { "type": "integer" },
+        "has_conflicts": { "type": "boolean" },
+        "merge_score": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "gate_retry_count": { "type": "integer", "minimum": 0, "default": 0 },
+    "last_retry_at": { "type": ["string", "null"], "format": "date-time" },
     "last_updated": { "type": "string", "format": "date-time" },
     "status_reason": { "type": "string" },
     "evidence": {