@mrciphersmith/keryx 0.2.9

package/src/gdskills/bundled/skills/review/review-orchestrator/input-contract.schema.json

@@ -0,0 +1,153 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "review-orchestrator-input-contract",
+  "title": "Review Orchestrator Input Contract",
+  "type": "object",
+  "properties": {
+    "flags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "path": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "commit_range": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "issue_url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "context_doc": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "context_mode": {
+      "type": "string",
+      "enum": [
+        "none",
+        "light",
+        "full"
+      ],
+      "default": "light"
+    },
+    "model_strategy": {
+      "type": "string",
+      "enum": [
+        "current",
+        "ask",
+        "adaptive"
+      ],
+      "default": "current"
+    },
+    "token_budget": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1000
+        },
+        "per_reviewer": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1000
+        },
+        "diff_max_chars": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1000
+        },
+        "file_max_chars": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1000
+        }
+      },
+      "additionalProperties": false
+    },
+    "publish_pr_review_report": {
+      "type": "string",
+      "enum": [
+        "ask",
+        "comment",
+        "comment-and-ai-artifact",
+        "none",
+        "true",
+        "false"
+      ],
+      "default": "ask"
+    },
+    "review_report_artifact": {
+      "type": "string",
+      "enum": [
+        "ask",
+        "ai-md",
+        "none"
+      ],
+      "default": "ask"
+    },
+    "managed_review": {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "lightweight",
+            "attach-review",
+            "review-flow",
+            "ingest"
+          ],
+          "default": "lightweight"
+        },
+        "target": {
+          "type": "string",
+          "enum": [
+            "pr",
+            "issue",
+            "branch",
+            "path",
+            "report"
+          ]
+        },
+        "target_ref": {
+          "type": "string"
+        },
+        "flow_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reviewers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true
+}

package/src/gdskills/bundled/skills/review/review-orchestrator/output-contract.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "review-orchestrator-output-contract",
+  "title": "Review Orchestrator Output Contract",
+  "type": "object",
+  "required": [
+    "status",
+    "verdict",
+    "summary",
+    "review_context",
+    "findings",
+    "stats",
+    "metadata"
+  ],
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": [
+        "DONE",
+        "DONE_WITH_CONCERNS"
+      ]
+    },
+    "verdict": {
+      "type": "string",
+      "enum": [
+        "APPROVE",
+        "APPROVE_WITH_SUGGESTIONS",
+        "REQUEST_CHANGES"
+      ]
+    },
+    "summary": {
+      "type": "string"
+    },
+    "review_context": {
+      "$ref": "review-context.schema.json"
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "stats": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "integer"
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "orchestrator": {
+          "type": "string"
+        },
+        "model_strategy": {
+          "type": "string"
+        },
+        "agents": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "reviewed_at": {
+          "type": "string"
+        },
+        "token_policy": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/src/gdskills/bundled/skills/review/review-orchestrator/review-context.schema.json

@@ -0,0 +1,389 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "review-context",
+  "title": "Review Context Pack",
+  "type": "object",
+  "required": [
+    "request",
+    "scope",
+    "routing",
+    "token_policy"
+  ],
+  "properties": {
+    "request": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "git": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "pr": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "additionalProperties": true
+    },
+    "scope": {
+      "type": "object",
+      "required": [
+        "mode",
+        "files"
+      ],
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": [
+            "diff",
+            "path"
+          ]
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "changed_lines": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "risk_areas": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "requirements": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "rules": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "memory": {
+      "type": "object",
+      "required": [
+        "query",
+        "entries"
+      ],
+      "description": "Result of the accepted-memory search the Context Pack step runs against the changed paths. Recorded here rather than only inlined into reviewer prompts so that a round which found NO relevant memory is distinguishable from a round that never searched.",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "What was searched, so the search can be reproduced."
+        },
+        "status_filter": {
+          "type": "string",
+          "enum": [
+            "accepted"
+          ],
+          "default": "accepted",
+          "description": "Only accepted memory may be inlined. A draft entry is a hypothesis; presenting one to a reviewer as project truth turns a wrong hypothesis into a wrong finding."
+        },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "path",
+              "title"
+            ],
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              },
+              "score": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "searched": {
+          "type": "boolean",
+          "default": true,
+          "description": "False only when the memory module is disabled. An empty `entries` with `searched: true` means the search ran and matched nothing."
+        }
+      },
+      "additionalProperties": true
+    },
+    "routing": {
+      "type": "object",
+      "required": [
+        "selected_reviewers"
+      ],
+      "properties": {
+        "selected_reviewers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "skipped_reviewers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "reasons": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "token_policy": {
+      "type": "object",
+      "required": [
+        "context_mode",
+        "omissions"
+      ],
+      "properties": {
+        "context_mode": {
+          "type": "string",
+          "enum": [
+            "none",
+            "light",
+            "full"
+          ]
+        },
+        "budget": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "omissions": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "model_plan": {
+          "type": "object",
+          "description": "Detected model capabilities and chosen strategy for review sub-agents.",
+          "properties": {
+            "detector_ran": {
+              "type": "boolean"
+            },
+            "strategy": {
+              "type": "string",
+              "enum": [
+                "current",
+                "ask",
+                "adaptive",
+                "economy",
+                "per-group",
+                "current-session"
+              ]
+            },
+            "current_model": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "complex_model": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "normal_model": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "simple_model": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "user_confirmed_expensive_fanout": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    },
+    "review_plan": {
+      "type": "object",
+      "description": "Grouped reviewer plan shown before optional reviewer prompts.",
+      "properties": {
+        "already_selected": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "optional_convention_detected": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "skipped": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "reviewer",
+              "reason"
+            ],
+            "properties": {
+              "reviewer": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "enable_with": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "optional_legacy_profile_available": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "selected_legacy_profile": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "dispatch_plan": {
+          "type": "array",
+          "description": "Per-reviewer runtime dispatch decision for native agent compatibility.",
+          "items": {
+            "type": "object",
+            "required": [
+              "reviewer",
+              "runtime"
+            ],
+            "properties": {
+              "reviewer": {
+                "type": "string"
+              },
+              "runtime": {
+                "type": "string",
+                "enum": [
+                  "native-agent",
+                  "general-purpose-fallback",
+                  "blocked"
+                ]
+              },
+              "agent_type": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "skill_path": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "reason": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "additionalProperties": true
+          }
+        },
+        "publication_plan": {
+          "type": "object",
+          "description": "User-confirmed PR review report publication mode and generated artifact metadata.",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": [
+                "ask",
+                "comment",
+                "comment-and-ai-artifact",
+                "none"
+              ]
+            },
+            "pr_number": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "pr_url": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "comment_posted": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "ai_artifact_path": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ai_artifact_link": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "user_confirmed": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            }
+          },
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}