perttool 0.5.0 → 0.5.1

package/schemas/Perttool.OverrideDecision.v1.schema.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.OverrideDecision.v1.schema.json",
+  "title": "Perttool.OverrideDecision.v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "diagnostics",
+    "diagnostics_truncated",
+    "override"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.OverrideDecision.v1"
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "recommendation.override.validate"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    },
+    "diagnostics_truncated": {
+      "const": false
+    },
+    "override": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "override_contract_version",
+            "override_id",
+            "source",
+            "actor",
+            "decided_at",
+            "reason",
+            "selection",
+            "task_decisions",
+            "feasibility",
+            "single_use"
+          ],
+          "properties": {
+            "override_contract_version": {
+              "const": 1
+            },
+            "override_id": {
+              "type": "string",
+              "pattern": "^override:sha256:[0-9a-f]{64}$"
+            },
+            "source": {
+              "type": "object",
+              "required": [
+                "schema_version",
+                "tool_version",
+                "source_digest",
+                "recommendation_interface_version",
+                "ranking_algorithm_id",
+                "ranking_algorithm_version",
+                "reason_taxonomy_version",
+                "explanation_model_version",
+                "expression_version",
+                "description_registry_version",
+                "result_decision_id",
+                "recommended_task_ids",
+                "capacity_overrides"
+              ],
+              "properties": {
+                "schema_version": {
+                  "const": "Perttool.NextResult.v5"
+                },
+                "tool_version": {
+                  "type": "string"
+                },
+                "source_digest": {
+                  "$ref": "Perttool.Common.v1.schema.json#/$defs/digest"
+                },
+                "recommendation_interface_version": {
+                  "const": 1
+                },
+                "ranking_algorithm_id": {
+                  "const": "perttool.recommendation-ranking.lexicographic-frontier"
+                },
+                "ranking_algorithm_version": {
+                  "const": 1
+                },
+                "reason_taxonomy_version": {
+                  "const": "1.0"
+                },
+                "explanation_model_version": {
+                  "const": 1
+                },
+                "expression_version": {
+                  "const": 1
+                },
+                "description_registry_version": {
+                  "const": 1
+                },
+                "result_decision_id": {
+                  "type": "string"
+                },
+                "recommended_task_ids": {
+                  "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+                },
+                "capacity_overrides": {
+                  "$ref": "Perttool.Common.v1.schema.json#/$defs/capacityOverrides"
+                }
+              },
+              "additionalProperties": false
+            },
+            "actor": {
+              "type": "object",
+              "required": [
+                "kind",
+                "id",
+                "authentication"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "human"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "authentication": {
+                  "const": "caller_asserted"
+                }
+              },
+              "additionalProperties": false
+            },
+            "decided_at": {
+              "type": "string",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$"
+            },
+            "reason": {
+              "type": "object"
+            },
+            "selection": {
+              "type": "object"
+            },
+            "task_decisions": {
+              "type": "array",
+              "items": {
+                "type": "object"
+              }
+            },
+            "feasibility": {
+              "type": "object"
+            },
+            "single_use": {
+              "const": true
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.ProjectHistoryResult.v1.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.ProjectHistoryResult.v1.schema.json",
+  "title": "Perttool.ProjectHistoryResult.v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "document_id",
+    "source",
+    "source_digest",
+    "diagnostics",
+    "diagnostics_truncated",
+    "grammar_version",
+    "history",
+    "events",
+    "git_recorded_transitions",
+    "tasks"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.ProjectHistoryResult.v1"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "project.history"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "document_id": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+    },
+    "source": {
+      "type": "string"
+    },
+    "source_digest": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableDigest"
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    },
+    "diagnostics_truncated": {
+      "type": "boolean"
+    },
+    "grammar_version": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "history": {
+      "type": "object",
+      "required": [
+        "id",
+        "version",
+        "status",
+        "traversal",
+        "repository_snapshot_id",
+        "repository_relative_path",
+        "requested_revision",
+        "resolved_revision",
+        "source_digest",
+        "inspected_commit_ids",
+        "unavailable_causes"
+      ],
+      "properties": {
+        "id": {
+          "const": "perttool.project-history"
+        },
+        "version": {
+          "const": 1
+        },
+        "status": {
+          "enum": [
+            "complete",
+            "incomplete",
+            "unavailable"
+          ]
+        },
+        "traversal": {
+          "const": "first_parent"
+        },
+        "repository_snapshot_id": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "repository_relative_path": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "requested_revision": {
+          "type": "string"
+        },
+        "resolved_revision": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "source_digest": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableDigest"
+        },
+        "inspected_commit_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "unavailable_causes": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "git_recorded_transitions": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object"
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.ProjectResult.v3.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.ProjectResult.v3.schema.json",
+  "title": "Perttool.ProjectResult.v3",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "document_id",
+    "source",
+    "source_digest",
+    "diagnostics",
+    "diagnostics_truncated",
+    "grammar_version",
+    "project"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.ProjectResult.v3"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "project.show"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "document_id": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+    },
+    "source": {
+      "type": "string"
+    },
+    "source_digest": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/digest"
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    },
+    "diagnostics_truncated": {
+      "type": "boolean"
+    },
+    "grammar_version": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 1,
+      "maximum": 5
+    },
+    "project": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "id",
+            "version",
+            "title",
+            "description",
+            "as_of",
+            "duration_unit",
+            "velocity",
+            "finish",
+            "finish_deadline",
+            "governance",
+            "critical_epsilon",
+            "target_duration"
+          ],
+          "properties": {
+            "id": {
+              "type": "string"
+            },
+            "version": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5
+            },
+            "title": {
+              "type": "string"
+            },
+            "description": {
+              "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+            },
+            "as_of": {
+              "oneOf": [
+                {
+                  "$ref": "Perttool.Common.v1.schema.json#/$defs/calendarValue"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "duration_unit": {
+              "enum": [
+                "day",
+                "hour",
+                "point"
+              ]
+            },
+            "velocity": {
+              "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+            },
+            "finish": {
+              "type": "string"
+            },
+            "finish_deadline": {
+              "oneOf": [
+                {
+                  "$ref": "Perttool.Common.v1.schema.json#/$defs/calendarValue"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "governance": {
+              "type": "object"
+            },
+            "critical_epsilon": {
+              "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+            },
+            "target_duration": {
+              "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/Perttool.SchemaResult.v1.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mako10k/perttool/schemas/Perttool.SchemaResult.v1.schema.json",
+  "title": "Perttool.SchemaResult.v1",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "cli_contract_version",
+    "tool_version",
+    "operation",
+    "ok",
+    "query",
+    "schemas",
+    "schema",
+    "diagnostics"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "Perttool.SchemaResult.v1"
+    },
+    "cli_contract_version": {
+      "const": 6
+    },
+    "tool_version": {
+      "type": "string"
+    },
+    "operation": {
+      "const": "schema"
+    },
+    "ok": {
+      "type": "boolean"
+    },
+    "query": {
+      "type": "object",
+      "required": [
+        "schema_id"
+      ],
+      "properties": {
+        "schema_id": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        }
+      },
+      "additionalProperties": false
+    },
+    "schemas": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "schema_id",
+          "artifact_path",
+          "command_result",
+          "public_library_result"
+        ],
+        "properties": {
+          "schema_id": {
+            "type": "string"
+          },
+          "artifact_path": {
+            "type": "string",
+            "pattern": "^schemas/Perttool\\.[A-Za-z]+(?:[A-Za-z0-9]*)?\\.v[0-9]+\\.schema\\.json$"
+          },
+          "command_result": {
+            "type": "boolean"
+          },
+          "public_library_result": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "schema": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "diagnostics": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/diagnostics"
+    }
+  },
+  "additionalProperties": false
+}