perttool 0.5.0 → 0.5.2

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

@@ -0,0 +1,402 @@
+{
+  "$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",
+  "$defs": {
+    "triggerCode": {
+      "enum": [
+        "allowed_replaces_recommended",
+        "deferred_selected",
+        "discouraged_selected"
+      ]
+    },
+    "triggerCodes": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/triggerCode"
+      }
+    },
+    "reason": {
+      "type": "object",
+      "required": [
+        "code",
+        "text",
+        "evidence_references"
+      ],
+      "properties": {
+        "code": {
+          "enum": [
+            "human_priority_decision",
+            "external_commitment",
+            "incident_response",
+            "plan_correction_pending",
+            "resource_reallocation_pending",
+            "risk_acceptance",
+            "experiment",
+            "other_explicit_reason"
+          ]
+        },
+        "text": {
+          "type": "string"
+        },
+        "evidence_references": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "kind",
+              "value"
+            ],
+            "properties": {
+              "kind": {
+                "enum": [
+                  "issue",
+                  "commit",
+                  "document",
+                  "url",
+                  "other"
+                ]
+              },
+              "value": {
+                "type": "string"
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "selection": {
+      "type": "object",
+      "required": [
+        "selected_task_ids",
+        "retained_recommended_task_ids",
+        "displaced_recommended_task_ids",
+        "selected_nonrecommended_task_ids",
+        "trigger_codes"
+      ],
+      "properties": {
+        "selected_task_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "retained_recommended_task_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "displaced_recommended_task_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "selected_nonrecommended_task_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "trigger_codes": {
+          "$ref": "#/$defs/triggerCodes"
+        }
+      },
+      "additionalProperties": false
+    },
+    "taskDecision": {
+      "type": "object",
+      "required": [
+        "task_id",
+        "normal_decision_id",
+        "normal_tier",
+        "normal_decisive_step_id",
+        "normal_reason_occurrence_ids",
+        "normal_comparison_ids",
+        "override_selected",
+        "trigger_codes",
+        "acknowledged_negative_fact_reason_ids"
+      ],
+      "properties": {
+        "task_id": {
+          "type": "string"
+        },
+        "normal_decision_id": {
+          "type": "string"
+        },
+        "normal_tier": {
+          "enum": [
+            "recommended",
+            "allowed",
+            "deferred",
+            "discouraged"
+          ]
+        },
+        "normal_decisive_step_id": {
+          "type": "string"
+        },
+        "normal_reason_occurrence_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "normal_comparison_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "override_selected": {
+          "const": true
+        },
+        "trigger_codes": {
+          "$ref": "#/$defs/triggerCodes"
+        },
+        "acknowledged_negative_fact_reason_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        }
+      },
+      "additionalProperties": false
+    },
+    "feasibility": {
+      "type": "object",
+      "required": [
+        "selected_set_reference",
+        "start_feasible",
+        "active_task_ids",
+        "resource_witnesses",
+        "expression"
+      ],
+      "properties": {
+        "selected_set_reference": {
+          "type": "object",
+          "required": [
+            "kind",
+            "id"
+          ],
+          "properties": {
+            "kind": {
+              "const": "derived_set"
+            },
+            "id": {
+              "const": "O"
+            }
+          },
+          "additionalProperties": false
+        },
+        "start_feasible": {
+          "const": true
+        },
+        "active_task_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "resource_witnesses": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "resource_id",
+              "capacity",
+              "active_usage",
+              "selected_usage",
+              "used",
+              "available_after_selection",
+              "selected_task_ids"
+            ],
+            "properties": {
+              "resource_id": {
+                "type": "string"
+              },
+              "capacity": {
+                "type": "integer",
+                "minimum": 1
+              },
+              "active_usage": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "selected_usage": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "used": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "available_after_selection": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "selected_task_ids": {
+                "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "expression": {
+          "oneOf": [
+            {
+              "$ref": "Perttool.Common.v1.schema.json#/$defs/recommendationExpression"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "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": {
+              "$ref": "#/$defs/reason"
+            },
+            "selection": {
+              "$ref": "#/$defs/selection"
+            },
+            "task_decisions": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/taskDecision"
+              }
+            },
+            "feasibility": {
+              "$ref": "#/$defs/feasibility"
+            },
+            "single_use": {
+              "const": true
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,283 @@
+{
+  "$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",
+  "$defs": {
+    "eventHistory": {
+      "type": "object",
+      "required": [
+        "event",
+        "evidence_class",
+        "first_seen_commit_id",
+        "last_seen_commit_id",
+        "removal_commit_id",
+        "payload_digest"
+      ],
+      "properties": {
+        "event": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/workEvent"
+        },
+        "evidence_class": {
+          "const": "declared_actual"
+        },
+        "first_seen_commit_id": {
+          "type": "string"
+        },
+        "last_seen_commit_id": {
+          "type": "string"
+        },
+        "removal_commit_id": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "payload_digest": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/digest"
+        }
+      },
+      "additionalProperties": false
+    },
+    "gitRecordedTransition": {
+      "type": "object",
+      "required": [
+        "task_id",
+        "from_state",
+        "to_state",
+        "commit_id",
+        "recorded_at",
+        "source_digest",
+        "evidence_class"
+      ],
+      "properties": {
+        "task_id": {
+          "type": "string"
+        },
+        "from_state": {
+          "$ref": "#/$defs/recordedTaskState"
+        },
+        "to_state": {
+          "$ref": "#/$defs/recordedTaskState"
+        },
+        "commit_id": {
+          "type": "string"
+        },
+        "recorded_at": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableCalendarValue"
+        },
+        "source_digest": {
+          "type": "string"
+        },
+        "evidence_class": {
+          "const": "git_recorded_transition"
+        }
+      },
+      "additionalProperties": false
+    },
+    "recordedTaskState": {
+      "enum": [
+        "absent",
+        "planned",
+        "active",
+        "blocked",
+        "suspended",
+        "done"
+      ]
+    },
+    "suspensionInterval": {
+      "type": "object",
+      "required": [
+        "suspend_event_id",
+        "resume_event_id",
+        "start",
+        "finish",
+        "duration"
+      ],
+      "properties": {
+        "suspend_event_id": {
+          "type": "string"
+        },
+        "resume_event_id": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "start": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/calendarValue"
+        },
+        "finish": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableCalendarValue"
+        },
+        "duration": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableQuantity"
+        }
+      },
+      "additionalProperties": false
+    },
+    "task": {
+      "type": "object",
+      "required": [
+        "task_id",
+        "coverage",
+        "event_ids",
+        "first_start",
+        "last_finish",
+        "suspension_intervals",
+        "cycle_time",
+        "derived_active_time",
+        "explicit_active_time",
+        "effort",
+        "planned_value",
+        "baseline_source",
+        "baseline_event_id",
+        "baseline_commit_id",
+        "qualifiers",
+        "unavailable_causes"
+      ],
+      "properties": {
+        "task_id": {
+          "type": "string"
+        },
+        "coverage": {
+          "enum": [
+            "open",
+            "finish_only",
+            "complete",
+            "unrecorded",
+            "unavailable"
+          ]
+        },
+        "event_ids": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "first_start": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableCalendarValue"
+        },
+        "last_finish": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableCalendarValue"
+        },
+        "suspension_intervals": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/suspensionInterval"
+          }
+        },
+        "cycle_time": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableQuantity"
+        },
+        "derived_active_time": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableQuantity"
+        },
+        "explicit_active_time": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableQuantity"
+        },
+        "effort": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableQuantity"
+        },
+        "planned_value": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableQuantity"
+        },
+        "baseline_source": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "enum": [
+            "start_baseline",
+            "finish_snapshot",
+            null
+          ]
+        },
+        "baseline_event_id": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "baseline_commit_id": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/nullableString"
+        },
+        "qualifiers": {
+          "$ref": "Perttool.Common.v1.schema.json#/$defs/stringArray"
+        },
+        "unavailable_causes": {
+          "type": "array",
+          "items": {
+            "$ref": "Perttool.Common.v1.schema.json#/$defs/actualsCause"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "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": {
+      "$ref": "Perttool.Common.v1.schema.json#/$defs/historyMetadata"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/eventHistory"
+      }
+    },
+    "git_recorded_transitions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/gitRecordedTransition"
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/task"
+      }
+    }
+  },
+  "additionalProperties": false
+}