@tiangong-lca/cli 0.1.9 → 0.1.11

package/assets/runtime/runtime-manifest.schema.json

@@ -0,0 +1,383 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:tiangong-lca:runtime-manifest:v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "bootstrap_protocol",
+    "product",
+    "minimum_hosts",
+    "workspace",
+    "components",
+    "launches"
+  ],
+  "properties": {
+    "schema": {
+      "const": "tiangong-lca.runtime-manifest.v1"
+    },
+    "bootstrap_protocol": {
+      "const": "tiangong-lca.runtime-bootstrap.v1"
+    },
+    "product": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+        }
+      }
+    },
+    "minimum_hosts": {
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "darwin-arm64": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["os_release", "glibc"],
+          "properties": {
+            "os_release": {
+              "type": "string",
+              "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+            },
+            "glibc": {
+              "type": "null"
+            }
+          }
+        },
+        "linux-x64": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["os_release", "glibc"],
+          "properties": {
+            "os_release": {
+              "type": "string",
+              "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+            },
+            "glibc": {
+              "type": "string",
+              "pattern": "^[0-9]+\\.[0-9]+$"
+            }
+          }
+        },
+        "linux-arm64": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["os_release", "glibc"],
+          "properties": {
+            "os_release": {
+              "type": "string",
+              "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+            },
+            "glibc": {
+              "type": "string",
+              "pattern": "^[0-9]+\\.[0-9]+$"
+            }
+          }
+        },
+        "win32-x64": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["os_release", "glibc"],
+          "properties": {
+            "os_release": {
+              "type": "string",
+              "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+            },
+            "glibc": {
+              "type": "null"
+            }
+          }
+        }
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["read", "write"],
+      "properties": {
+        "read": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["schema", "features"],
+            "properties": {
+              "schema": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "features": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "maxItems": 64,
+                "minItems": 0
+              }
+            }
+          },
+          "maxItems": 32,
+          "minItems": 0
+        },
+        "write": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["schema", "features"],
+            "properties": {
+              "schema": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "features": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                "maxItems": 64,
+                "minItems": 0
+              }
+            }
+          },
+          "maxItems": 32,
+          "minItems": 0
+        }
+      }
+    },
+    "components": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "version",
+          "platform",
+          "archive",
+          "files",
+          "content_sha256",
+          "production_lock",
+          "sbom",
+          "licenses",
+          "provenance",
+          "protocols",
+          "asset_fingerprints"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
+          },
+          "version": {
+            "type": "string",
+            "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+          },
+          "platform": {
+            "enum": ["darwin-arm64", "linux-x64", "linux-arm64", "win32-x64"]
+          },
+          "archive": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["format", "url", "bytes", "sha256"],
+            "properties": {
+              "format": {
+                "const": "tar-gzip-ustar-v1"
+              },
+              "url": {
+                "type": "string",
+                "format": "uri",
+                "maxLength": 4096
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 536870912
+              },
+              "sha256": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              }
+            }
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["path", "bytes", "sha256", "mode"],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 255
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 536870912
+                },
+                "sha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                },
+                "mode": {
+                  "enum": [420, 493]
+                }
+              }
+            },
+            "maxItems": 50000,
+            "minItems": 1
+          },
+          "content_sha256": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$"
+          },
+          "production_lock": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 255
+          },
+          "sbom": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 255
+          },
+          "licenses": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 255
+            },
+            "maxItems": 64,
+            "minItems": 1
+          },
+          "provenance": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 255
+            },
+            "maxItems": 64,
+            "minItems": 1
+          },
+          "protocols": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            "maxItems": 32,
+            "minItems": 1
+          },
+          "asset_fingerprints": {
+            "type": "object",
+            "maxProperties": 64,
+            "additionalProperties": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{64}$"
+            }
+          }
+        }
+      },
+      "maxItems": 128,
+      "minItems": 1
+    },
+    "launches": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "platform", "executable", "environment", "argv"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
+          },
+          "platform": {
+            "enum": ["darwin-arm64", "linux-x64", "linux-arm64", "win32-x64"]
+          },
+          "executable": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["component", "path"],
+            "properties": {
+              "component": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 255
+              }
+            }
+          },
+          "environment": {
+            "enum": ["isolated", "cli-auth"]
+          },
+          "context_protocol": {
+            "const": "tiangong-lca.runtime-host.v1"
+          },
+          "argv": {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["component", "path"],
+                  "properties": {
+                    "component": {
+                      "type": "string",
+                      "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
+                    },
+                    "path": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 255
+                    }
+                  }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["literal"],
+                  "properties": {
+                    "literal": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 4096
+                    }
+                  }
+                }
+              ]
+            },
+            "maxItems": 32,
+            "minItems": 0
+          }
+        }
+      },
+      "maxItems": 64,
+      "minItems": 1
+    }
+  }
+}

package/dist/src/cli.js

@@ -1,4 +1,5 @@
 import { parseArgs } from 'node:util';
+import { runRuntimeCommand } from './lib/runtime/command.js';
 import { buildDoctorReport, readRuntimeEnv } from './lib/env.js';
 import { CliError, toErrorPayload } from './lib/errors.js';
 import { stringifyJson } from './lib/io.js';
@@ -91,6 +92,7 @@ Usage:
 Commands:
 Implemented Commands:
   doctor     show environment diagnostics
+  runtime    describe | ensure | status | prune | lease-release | exec
   auth       login | status | whoami | doctor-auth | logout | identity-receipt
   search     flow | process | lifecyclemodel
   process    get | list | identity-preflight | build-plan | scope-statistics | dedup-review | auto-build | resume-build | publish-build | complete-required-fields | save-draft | batch-build | refresh-references | verify-rows
@@ -981,7 +983,7 @@ Outputs written under --output-dir:
   - mapping.csv.gz when --write-mapping is used
 
 Runtime contract:
-  - Linux x86_64/ARM64, macOS Intel/Apple Silicon, and Windows x86_64 are supported.
+  - Linux x86_64/ARM64, macOS Apple Silicon (arm64), and Windows x86_64 are supported.
   - Windows ARM64 is unsupported.
   - The binary must report tidas.operation-report.v1 and a stable 0.2.x version.
   - Import publication, cancellation cleanup, and domain validation remain owned by Rust tidas.
@@ -5806,6 +5808,8 @@ export async function executeCli(argv, deps) {
         if (!command || command === 'help' || flags.help) {
             return { exitCode: 0, stdout: `${renderMainHelp(deps.dotEnvStatus)}\n`, stderr: '' };
         }
+        if (command === 'runtime')
+            return await runRuntimeCommand(subcommand, commandArgs, undefined, deps.fetchImpl, deps.env);
         if (command === 'doctor') {
             const doctorFlags = parseDoctorFlags(commandArgs);
             if (doctorFlags.help) {