@intentius/terragucci 0.4.34 → 0.4.35

package/dist/estates.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://intentius.io/terragucci/schemas/estates/v1/estates.schema.json",
+  "title": "terragucci.estates/v1",
+  "description": "estates.json at the top of a reports prefix: each estate whose roster a tf-apply wave or an estate migration wrote, with its resource count. Within v1 fields are only added, and an existing field never changes meaning.",
+  "type": "object",
+  "required": ["schema", "estates"],
+  "properties": {
+    "schema": { "const": "terragucci.estates/v1" },
+    "estates": {
+      "type": "array",
+      "description": "By estate name.",
+      "items": {
+        "type": "object",
+        "required": ["estate", "count", "at", "project", "root", "roster"],
+        "properties": {
+          "estate": { "type": "string", "description": "The estate a choudoufu root's live block names, or a stock root's path." },
+          "count": { "type": "integer", "description": "How many resources the roster holds." },
+          "at": { "type": "string", "description": "When the roster was read: the wave's end, or the migration's write." },
+          "project": { "type": "string" },
+          "root": { "type": "string" },
+          "roster": { "type": "string", "description": "The roster's key, relative to estates.json: estates/<estate>/roster.json." }
+        }
+      }
+    }
+  }
+}

package/dist/report-index.schema.json

@@ -39,7 +39,7 @@
         "groups": { "type": "integer" },
         "totals": { "$ref": "#/$defs/totals" },
         "refused": { "type": "integer", "description": "Roots that refused to plan." },
-        "failed": { "type": "integer", "description": "Roots that failed to plan or apply. Absent on rows written before it was kept." },
+        "failed": { "type": "integer", "description": "Roots that failed to plan or apply; on a tf-apply wave whose apply failed, every root of the wave. Absent on rows written before it was kept." },
         "changed": { "type": "integer", "description": "Roots with at least one change; on a tf-drift row, the roots that drifted." },
         "approval": { "enum": ["waiting", "approved", "not-required"], "description": "A tf-apply wave's gate." },
         "waiting_since": { "type": "string", "description": "When a waiting wave began waiting for an approval of its digest." },

package/dist/report.schema.json

@@ -177,6 +177,10 @@
               "rules": { "type": "array", "items": { "type": "string" }, "description": "The ids of the rules that denied, sorted (minor 10)." },
               "warnings": { "type": "array", "items": { "type": "string" } },
               "error": { "type": "string" },
+              "held_by": { "type": "array", "items": { "type": "string" }, "description": "With hold in policy.outcomes at base: the ids of the hold rules that matched, sorted; its wave waits for an approval (minor 40)." },
+              "holds": { "type": "array", "items": { "type": "string" }, "description": "The messages of those hold rules (minor 40)." },
+              "allowed_by": { "type": "array", "items": { "type": "string" }, "description": "With allow_unattended in policy.outcomes at base: the ids of the allow_unattended rules that matched, sorted (minor 40)." },
+              "overriders": { "type": "array", "items": { "type": "string" }, "description": "With scoped policy.override entries at base: who may override this root's denial by its rules, names then roles with their holders (minor 40)." },
               "override": {
                 "description": "The policy override that stands for this root's plan and rules (minor 10).",
                 "type": "object",
@@ -357,6 +361,32 @@
               }
             }
           },
+          "policy_gate": {
+            "type": "object",
+            "description": "What the policy's hold and allow_unattended rules did to the wave's gate: held, or unattended when every root that changes something is allowed and none holds; the rules' ids and, on a tf-apply wave, the commit the policy was read at (minor 40).",
+            "required": ["outcome", "rules"],
+            "properties": {
+              "outcome": { "enum": ["held", "unattended"] },
+              "rules": { "type": "array", "items": { "type": "string" } },
+              "commit": { "type": "string" }
+            }
+          },
+          "approval_rules": {
+            "type": "array",
+            "description": "The approval_rules entries at base the wave's roots take: what each asks for and, on a tf-apply wave, the approvers of its digest it counted and whether it is met (minor 40).",
+            "items": {
+              "type": "object",
+              "required": ["roots", "count", "approvers", "met"],
+              "properties": {
+                "roots": { "type": "array", "items": { "type": "string" } },
+                "count": { "type": "integer", "minimum": 1 },
+                "roles": { "type": "array", "items": { "type": "string" } },
+                "not_author": { "type": "boolean" },
+                "approvers": { "type": "array", "items": { "type": "string" } },
+                "met": { "type": "boolean" }
+              }
+            }
+          },
           "held_by_steps": {
             "type": "array",
             "items": { "type": "string" },