valtrion 0.7.4__py3-none-any.whl

valtrion/__init__.py

@@ -0,0 +1,3 @@
+"""Valtrion device validation host CLI. Python 3 standard library only."""
+
+__version__ = "0.7.4"

valtrion/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

valtrion/_compat.json

@@ -0,0 +1,7 @@
+{
+  "schema": "valtrion.compat/1",
+  "package": "com.goryned.valtrion.unity",
+  "ranges": [
+    { "package": "0.7.x", "core": ">=0.7.0,<0.8" }
+  ]
+}

valtrion/_license.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GORYNED
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

valtrion/_schemas/baseline.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.baseline/1",
+  "title": "Baseline summary of one plan on one comparability key",
+  "type": "object",
+  "required": ["schema", "planId", "key", "createdUtc", "source", "metrics"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.baseline/1" },
+    "planId": { "$ref": "common.schema.json#/$defs/identifier" },
+    "key": { "$ref": "common.schema.json#/$defs/comparabilityKey" },
+    "createdUtc": { "$ref": "common.schema.json#/$defs/utc" },
+    "source": {
+      "type": "object",
+      "required": ["runId", "repo", "sha", "evidence"],
+      "additionalProperties": false,
+      "properties": {
+        "runId": { "$ref": "common.schema.json#/$defs/identifier" },
+        "repo": { "type": "string", "minLength": 1 },
+        "sha": { "$ref": "common.schema.json#/$defs/gitSha" },
+        "evidence": { "enum": ["physical", "emulator", "host"] }
+      }
+    },
+    "metrics": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["unit", "direction", "stats"],
+        "additionalProperties": false,
+        "properties": {
+          "unit": { "type": "string", "minLength": 1 },
+          "direction": { "$ref": "common.schema.json#/$defs/direction" },
+          "stats": { "$ref": "common.schema.json#/$defs/stats" }
+        }
+      }
+    }
+  }
+}

valtrion/_schemas/checks.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.checks/1",
+  "title": "Project check map: changed paths to kinds, kinds to checks per level",
+  "type": "object",
+  "required": ["schema", "platforms", "areas", "kinds", "unclassified"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.checks/1" },
+    "platforms": {
+      "type": "object",
+      "required": ["required"],
+      "additionalProperties": false,
+      "properties": {
+        "required": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/platform" } },
+        "dev": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/platform" } }
+      }
+    },
+    "unityEditorSlots": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+    "areas": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["glob", "kind"],
+        "additionalProperties": false,
+        "properties": {
+          "glob": { "type": "string", "minLength": 1 },
+          "kind": { "$ref": "common.schema.json#/$defs/identifier" }
+        }
+      }
+    },
+    "kinds": { "type": "object", "additionalProperties": { "$ref": "#/$defs/levels" } },
+    "unclassified": { "enum": ["widest", "fail"] }
+  },
+  "$defs": {
+    "levels": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "L0": { "$ref": "common.schema.json#/$defs/stringList" },
+        "L1": { "$ref": "common.schema.json#/$defs/stringList" },
+        "L2": { "$ref": "common.schema.json#/$defs/stringList" },
+        "L3": { "$ref": "common.schema.json#/$defs/stringList" },
+        "L4": { "$ref": "common.schema.json#/$defs/stringList" }
+      }
+    }
+  }
+}

valtrion/_schemas/common.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.common/1",
+  "title": "Shared definitions of the Valtrion contracts",
+  "$defs": {
+    "status": { "enum": ["PASS", "FAIL", "BLOCKED", "NEEDS_PERMISSION", "STALL", "TIMEOUT"] },
+    "layerStatus": { "$ref": "#/$defs/status" },
+    "evidence": { "enum": ["physical", "emulator", "editor", "host"] },
+    "platform": { "enum": ["ios", "android", "windows", "macos", "editor"] },
+    "int32": { "type": "integer", "maximum": 2147483647 },
+    "hostOs": { "enum": ["windows", "macos", "linux"] },
+    "transportKind": { "enum": ["local", "ssh"] },
+    "hostSelection": { "enum": ["local", "capability", "pinned"] },
+    "planKind": { "enum": ["functional", "performance", "soak", "smoke"] },
+    "dataPolicy": { "enum": ["isolated", "devdata", "clean-install"] },
+    "direction": { "enum": ["lower", "higher"] },
+    "verdict": { "enum": ["PASS", "REGRESSION", "IMPROVED", "NOISY", "NOT_COMPARABLE"] },
+    "identifier": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$", "maxLength": 200 },
+    "gitSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+    "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "utc": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]+)?Z$" },
+    "stringList": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "stats": {
+      "type": "object",
+      "required": ["n", "median", "p90", "max"],
+      "additionalProperties": false,
+      "properties": {
+        "n": { "type": "integer", "minimum": 0 },
+        "median": { "type": "number" },
+        "p90": { "type": "number" },
+        "max": { "type": "number" },
+        "stdev": { "type": "number", "minimum": 0 }
+      }
+    },
+    "comparabilityKey": {
+      "type": "object",
+      "required": ["planSha256", "deviceClass", "osMajor", "buildProfile", "unityVersion"],
+      "additionalProperties": false,
+      "properties": {
+        "planSha256": { "$ref": "#/$defs/sha256" },
+        "deviceClass": { "$ref": "#/$defs/identifier" },
+        "osMajor": { "$ref": "#/$defs/int32", "minimum": 0 },
+        "buildProfile": { "$ref": "#/$defs/identifier" },
+        "unityVersion": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

valtrion/_schemas/event.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.event/1",
+  "title": "One line of events.jsonl (append-only job log)",
+  "type": "object",
+  "required": ["schema", "seq", "utc", "jobId", "type"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.event/1" },
+    "seq": { "type": "integer", "minimum": 0 },
+    "utc": { "$ref": "common.schema.json#/$defs/utc" },
+    "jobId": { "$ref": "common.schema.json#/$defs/identifier" },
+    "type": {
+      "enum": [
+        "job.started", "job.finished", "step.started", "step.finished", "progress",
+        "stall.detected", "timeout.detected", "lease.acquired", "lease.released", "log"
+      ]
+    },
+    "step": { "type": "string" },
+    "status": { "$ref": "common.schema.json#/$defs/status" },
+    "message": { "type": "string" },
+    "data": { "type": "object" }
+  }
+}

valtrion/_schemas/heartbeat.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.heartbeat/1",
+  "title": "Heartbeat written by the Runtime every few seconds",
+  "type": "object",
+  "required": ["schema", "runId", "seq", "utc", "state", "stepIndex", "stepType", "elapsedMs"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.heartbeat/1" },
+    "runId": { "$ref": "common.schema.json#/$defs/identifier" },
+    "seq": { "type": "integer", "minimum": 0 },
+    "utc": { "$ref": "common.schema.json#/$defs/utc" },
+    "state": { "enum": ["starting", "running", "waiting-host", "finishing", "done"] },
+    "stepIndex": { "$ref": "common.schema.json#/$defs/int32", "minimum": -1 },
+    "stepType": { "type": "string" },
+    "elapsedMs": { "type": "integer", "minimum": 0 },
+    "message": { "type": "string" },
+    "request": {
+      "type": "object",
+      "required": ["id", "action"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/identifier" },
+        "action": { "type": "string", "minLength": 1 },
+        "args": { "type": "object" }
+      }
+    }
+  }
+}

valtrion/_schemas/hosts.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.hosts/1",
+  "title": "Host inventory of one machine (machine-local, outside git): where Valtrion may run work",
+  "type": "object",
+  "required": ["schema", "hosts"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.hosts/1" },
+    "hosts": { "type": "array", "items": { "$ref": "#/$defs/host" }, "minItems": 1 }
+  },
+  "$defs": {
+    "host": {
+      "type": "object",
+      "required": ["id", "transport", "os", "artifactsRoot"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/identifier" },
+        "transport": { "$ref": "#/$defs/transport" },
+        "os": { "$ref": "common.schema.json#/$defs/hostOs" },
+        "roles": { "$ref": "common.schema.json#/$defs/stringList" },
+        "capabilities": { "$ref": "#/$defs/capabilities" },
+        "projectsRoot": { "type": "string", "minLength": 1 },
+        "worktreePolicy": { "enum": ["per-task", "shared"] },
+        "artifactsRoot": { "type": "string", "minLength": 1 },
+        "python": { "type": "string", "minLength": 1, "description": "Absolute path of the Python (3.10 or newer) that valtrion hosts sync uses on an SSH host; recorded by valtrion hosts add --python or found by valtrion hosts sync." },
+        "valtrionCommand": { "type": "string", "minLength": 1, "description": "Absolute path of the valtrion command on an SSH host; recorded by valtrion hosts sync, used instead of PATH lookup." }
+      }
+    },
+    "transport": {
+      "type": "object",
+      "required": ["kind"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "$ref": "common.schema.json#/$defs/transportKind" },
+        "sshTarget": { "type": "string", "pattern": "^[^-\\x00-\\x1f][^\\x00-\\x1f]*" },
+        "connectTimeoutSec": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 }
+      }
+    },
+    "capabilities": {
+      "description": "What the host declares; valtrion doctor verifies it. Devices attached to the host are discovered, not declared.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "unityEditors": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["version", "modules"],
+            "additionalProperties": false,
+            "properties": {
+              "version": { "type": "string", "minLength": 1 },
+              "modules": { "$ref": "common.schema.json#/$defs/stringList" }
+            }
+          }
+        },
+        "buildPlatforms": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/platform" } },
+        "xcode": { "type": "string", "minLength": 1 },
+        "iosSigning": { "type": "boolean" },
+        "adb": { "type": "boolean" }
+      }
+    }
+  }
+}

valtrion/_schemas/job.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.job/1",
+  "title": "State of a detached host job (job.json, rewritten atomically)",
+  "type": "object",
+  "required": ["schema", "jobId", "kind", "state", "status", "reason", "createdUtc", "updatedUtc", "host", "command", "watchdog", "eventsOffset"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.job/1" },
+    "jobId": { "$ref": "common.schema.json#/$defs/identifier" },
+    "kind": { "enum": ["run", "pipeline", "build", "install", "collect"] },
+    "state": { "enum": ["queued", "running", "finished", "cancelled"] },
+    "status": {
+      "anyOf": [
+        { "type": "null" },
+        { "$ref": "common.schema.json#/$defs/status" }
+      ]
+    },
+    "reason": { "type": ["string", "null"] },
+    "createdUtc": { "$ref": "common.schema.json#/$defs/utc" },
+    "updatedUtc": { "$ref": "common.schema.json#/$defs/utc" },
+    "host": { "$ref": "common.schema.json#/$defs/identifier" },
+    "pid": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+    "command": { "$ref": "common.schema.json#/$defs/stringList" },
+    "resultPath": { "type": "string", "minLength": 1 },
+    "watchdog": {
+      "type": "object",
+      "required": ["stallSec", "timeoutSec", "lastProgressUtc"],
+      "additionalProperties": false,
+      "properties": {
+        "stallSec": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+        "timeoutSec": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+        "lastProgressUtc": { "$ref": "common.schema.json#/$defs/utc" }
+      }
+    },
+    "eventsOffset": { "type": "integer", "minimum": 0 }
+  }
+}

valtrion/_schemas/lease.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.lease/1",
+  "title": "Lease on an exclusive resource (device, editor slot, signing, worktree)",
+  "type": "object",
+  "required": ["schema", "resource", "owner", "session", "pid", "host", "acquiredUtc", "renewedUtc", "ttlSec", "purpose"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.lease/1" },
+    "resource": { "$ref": "common.schema.json#/$defs/identifier" },
+    "owner": { "type": "string", "minLength": 1 },
+    "session": { "type": "string", "minLength": 1 },
+    "worktree": { "type": "string" },
+    "pid": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+    "host": { "$ref": "common.schema.json#/$defs/identifier" },
+    "acquiredUtc": { "$ref": "common.schema.json#/$defs/utc" },
+    "renewedUtc": { "$ref": "common.schema.json#/$defs/utc" },
+    "ttlSec": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+    "purpose": { "type": "string" }
+  }
+}

valtrion/_schemas/pipeline.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.pipeline/1",
+  "title": "Validation pipeline: build, install, run series, collect, compare",
+  "type": "object",
+  "required": ["schema", "id", "candidate", "device", "stages"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.pipeline/1" },
+    "id": { "$ref": "common.schema.json#/$defs/identifier" },
+    "candidate": {
+      "type": "object",
+      "required": ["repo", "profile"],
+      "additionalProperties": false,
+      "properties": {
+        "repo": { "type": "string", "minLength": 1 },
+        "sha": { "$ref": "common.schema.json#/$defs/gitSha", "description": "Optional, or all zeros: the commit of the checkout is used and recorded." },
+        "profile": { "$ref": "common.schema.json#/$defs/identifier" }
+      }
+    },
+    "device": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "class": { "$ref": "common.schema.json#/$defs/identifier" },
+        "id": { "$ref": "common.schema.json#/$defs/identifier" },
+        "platform": { "$ref": "common.schema.json#/$defs/platform" }
+      }
+    },
+    "stages": { "type": "array", "items": { "$ref": "#/$defs/stage" }, "minItems": 1 },
+    "compare": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "stage": {
+      "type": "object",
+      "required": ["stage"],
+      "additionalProperties": false,
+      "properties": {
+        "stage": { "enum": ["build", "install", "run", "collect"] },
+        "plan": { "type": "string", "minLength": 1 },
+        "variant": { "type": "string", "minLength": 1 },
+        "repeat": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+        "coldLaunch": { "type": "boolean" },
+        "timeoutSec": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+        "args": { "type": "object" },
+        "prelaunchFiles": {
+          "type": "array",
+          "description": "Files pushed into the application's data root before it starts (read before the first scene): local is absolute or relative to the pipeline file, remote is relative to the data root.",
+          "items": {
+            "type": "object",
+            "required": ["local", "remote"],
+            "additionalProperties": false,
+            "properties": {
+              "local": { "type": "string", "minLength": 1 },
+              "remote": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

valtrion/_schemas/plan.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.plan/1",
+  "title": "Validation plan",
+  "type": "object",
+  "required": ["schema", "id", "kind", "dataPolicy", "budgetSeconds", "steps"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.plan/1" },
+    "id": { "$ref": "common.schema.json#/$defs/identifier" },
+    "kind": { "$ref": "common.schema.json#/$defs/planKind" },
+    "requires": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "platforms": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/platform" }, "minItems": 1 },
+        "capabilities": { "$ref": "common.schema.json#/$defs/stringList" },
+        "profile": { "$ref": "common.schema.json#/$defs/identifier" },
+        "evidence": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/evidence" }, "minItems": 1 }
+      }
+    },
+    "dataPolicy": { "$ref": "common.schema.json#/$defs/dataPolicy" },
+    "budgetSeconds": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+    "repeat": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 },
+    "warmup": { "$ref": "common.schema.json#/$defs/int32", "minimum": 0 },
+    "continueOnFail": { "type": "boolean" },
+    "setup": { "type": "array", "items": { "$ref": "#/$defs/step" } },
+    "steps": { "type": "array", "items": { "$ref": "#/$defs/step" }, "minItems": 1 },
+    "metrics": { "type": "object", "additionalProperties": { "$ref": "#/$defs/metricSpec" } },
+    "cleanup": { "enum": ["ledger", "none"] }
+  },
+  "$defs": {
+    "step": {
+      "type": "object",
+      "required": ["type", "timeoutSec"],
+      "properties": {
+        "type": { "$ref": "common.schema.json#/$defs/identifier" },
+        "timeoutSec": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 }
+      }
+    },
+    "metricSpec": {
+      "type": "object",
+      "required": ["unit", "direction"],
+      "additionalProperties": false,
+      "properties": {
+        "unit": { "type": "string", "minLength": 1 },
+        "direction": { "$ref": "common.schema.json#/$defs/direction" },
+        "budget": { "type": "number" },
+        "regressionPct": { "type": "number", "minimum": 0 },
+        "minSamples": { "$ref": "common.schema.json#/$defs/int32", "minimum": 1 }
+      }
+    }
+  }
+}

valtrion/_schemas/registry.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "gdv.registry/1",
+  "title": "Host device registry (outside git)",
+  "type": "object",
+  "required": ["schema", "host", "devices"],
+  "additionalProperties": false,
+  "properties": {
+    "schema": { "const": "gdv.registry/1" },
+    "host": {
+      "type": "object",
+      "required": ["id", "os", "roles"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "$ref": "common.schema.json#/$defs/identifier" },
+        "os": { "$ref": "common.schema.json#/$defs/hostOs" },
+        "roles": { "$ref": "common.schema.json#/$defs/stringList" }
+      }
+    },
+    "devices": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "hostId", "platform", "class", "capabilities", "exclusive"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "$ref": "common.schema.json#/$defs/identifier" },
+          "hostId": { "$ref": "common.schema.json#/$defs/identifier" },
+          "alias": { "$ref": "common.schema.json#/$defs/identifier" },
+          "platform": { "$ref": "common.schema.json#/$defs/platform" },
+          "class": { "$ref": "common.schema.json#/$defs/identifier" },
+          "model": { "type": "string" },
+          "os": { "type": "string" },
+          "evidence": { "$ref": "common.schema.json#/$defs/evidence" },
+          "capabilities": { "$ref": "common.schema.json#/$defs/stringList" },
+          "exclusive": { "type": "boolean" },
+          "notes": { "type": "string" }
+        }
+      }
+    }
+  }
+}