Files
open-design/shells/terminal/contract/shell-updater.schema.json
8ab7c3d5f1 feat(standalone): establish the exact lifecycle and Terminal carrier (#7716)
* feat(standalone): add shell-neutral exact lifecycle

* feat(terminal): add native exact cold-start carrier

* test(terminal): exercise mutable exact channel heads

* feat(standalone): model synced blobs and Shell updates

* feat(terminal): exercise the complete Shell lifecycle

* feat(release): add the independent exact Terminal line

* test(exact): run the full local Terminal release line

* feat(terminal): harden exact Sidecar lifecycle

* feat(standalone): prove exact update transactions

* refactor(standalone): separate shell lifecycle dimensions

* refactor(e2e): decouple terminal exact drivers

* refactor(terminal): isolate exact sidecar fixture host

* feat(terminal): gate handoff on physical retirement

* refactor(release): gate exact activation on public acceptance

* test(terminal): formalize guarded lifecycle algebra

* fix(terminal): guard shell installer handoff

* feat(terminal): add exact bootloader handoff

* feat(terminal): integrate exact sidecar lifecycle

* refactor(exact): rename validation channels

* test(terminal): harden exact release acceptance

* fix(postinstall): build standalone dependencies first

Generated-By: looper 0.11.2 (runner=fixer, agent=codex)

* fix(ci): build the native Terminal scene

Generated-By: looper 0.11.2 (runner=fixer, agent=codex)

* test(ci): cover exact convergence handoff routing

Generated-By: looper 0.11.2 (runner=fixer, agent=codex)

* fix(exact): isolate terminal validation from main CI

* fix(terminal): complete shell update confirmation

Generated-By: looper 0.11.2 (runner=fixer, agent=codex)

* fix(exact): bind acceptance to installed manifest

Generated-By: looper 0.11.2 (runner=fixer, agent=codex)

* fix(standalone): block occupied shell installs

Generated-By: looper 0.11.2 (runner=fixer, agent=codex)

---------

Co-authored-by: Looper <looper@noreply.github.com>
2026-09-03 03:50:34 +00:00

87 lines
3.2 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://nexu.io/contracts/terminal/shell-updater-v3.schema.json",
"title": "Shell updater snapshot v3",
"type": "object",
"additionalProperties": false,
"required": ["schemaVersion", "revision", "shellType", "state", "actions", "blockedBy"],
"properties": {
"schemaVersion": {"const": 3},
"revision": {"type": "integer", "minimum": 0},
"shellType": {"type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$"},
"candidateId": {"type": "string", "pattern": "^[A-Za-z0-9._-]{1,128}$"},
"installAttemptId": {"type": "string", "pattern": "^[A-Za-z0-9._-]{1,128}$"},
"state": {"enum": ["idle", "checking", "available", "downloading", "ready", "applying", "handed-off", "installed", "failed"]},
"progress": {
"type": "object",
"additionalProperties": false,
"required": ["completed", "total"],
"properties": {"completed": {"type": "integer", "minimum": 0}, "total": {"type": "integer", "minimum": 1}}
},
"actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": ["id", "emphasis"],
"properties": {
"id": {"enum": ["check", "download", "install", "later", "force-stop-and-install", "abandon"]},
"emphasis": {"enum": ["primary", "secondary", "danger"]}
}
}
},
"blockedBy": {"type": "array"},
"handoff": {
"type": "object",
"additionalProperties": false,
"required": ["interaction", "releaseVersion", "target", "artifact", "shell"],
"properties": {
"interaction": {"const": "restart-and-install"},
"releaseVersion": {"type": "string"},
"target": {"type": "string"},
"shell": {
"type": "object",
"additionalProperties": false,
"required": ["type", "version", "buildHash"],
"properties": {
"type": {"type": "string"},
"version": {"type": "string"},
"buildHash": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
}
},
"artifact": {
"type": "object",
"additionalProperties": false,
"required": ["path", "sha256", "size", "mediaType"],
"properties": {
"path": {"type": "string"},
"sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
"size": {"type": "integer", "minimum": 1},
"mediaType": {"type": "string"}
}
}
}
},
"error": {
"type": "object",
"additionalProperties": false,
"required": ["code", "message"],
"properties": {"code": {"type": "string"}, "message": {"type": "string"}}
}
},
"allOf": [
{
"if": {"properties": {"state": {"enum": ["available", "downloading", "ready", "applying", "handed-off", "installed"]}}},
"then": {"required": ["candidateId"]}
},
{
"if": {"properties": {"state": {"enum": ["applying", "handed-off", "installed"]}}},
"then": {"required": ["installAttemptId"]}
},
{
"if": {"properties": {"state": {"enum": ["ready", "applying", "handed-off", "installed"]}}},
"then": {"required": ["handoff"]}
}
]
}