@tiangong-lca/cli 0.1.8 → 0.1.10

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

@@ -0,0 +1,380 @@
+{
+  "$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"]
+          },
+          "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.d.ts

@@ -1,5 +1,6 @@
 import type { DotEnvLoadResult } from './lib/dotenv.js';
 import type { FetchLike } from './lib/http.js';
+import { type RunDatasetSupportCacheExportOptions, type DatasetSupportCacheExportReport } from './lib/dataset-support-cache.js';
 import { inspectSupabaseAuthStatus, loginWithSupabaseOAuth, logoutSupabaseUserSession } from './lib/supabase-session.js';
 import { type AuthIdentityReceipt, type RunAuthIdentityReceiptOptions } from './lib/auth-identity-receipt.js';
 import { type LifecyclemodelAutoBuildReport, type RunLifecyclemodelAutoBuildOptions } from './lib/lifecyclemodel-auto-build.js';
@@ -68,6 +69,7 @@ import { runFlowIdentity } from './lib/dataset-maintenance-flow-identity-run.js'
 import { verifyFlowIdentity } from './lib/dataset-maintenance-flow-identity-verify.js';
 import { type DatasetSourceUploadAttachmentsReport, type RunDatasetSourceUploadAttachmentsOptions } from './lib/dataset-source-upload-attachments.js';
 export type CliDeps = {
+    runDatasetSupportCacheExportImpl?: (options: RunDatasetSupportCacheExportOptions) => Promise<DatasetSupportCacheExportReport>;
     env: NodeJS.ProcessEnv;
     dotEnvStatus: DotEnvLoadResult;
     fetchImpl: FetchLike;

package/dist/src/cli.js

@@ -1,8 +1,10 @@
 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';
 import { loadCliPackageVersion } from './lib/package-version.js';
+import { runDatasetSupportCacheExport, } from './lib/dataset-support-cache.js';
 import { requireSupabaseRestRuntime } from './lib/supabase-client.js';
 import { inspectSupabaseAuthStatus, loginWithSupabaseOAuth, logoutSupabaseUserSession, } from './lib/supabase-session.js';
 import { OAUTH_LOGIN_TIMEOUT_MAX_MS } from './lib/oauth-loopback.js';
@@ -90,10 +92,11 @@ 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
-  dataset    contract get | context-pack | classification children/path/audit/apply | curation-queue build/next/verify | import-lca convert | author | patch apply | save-draft | source upload-attachments | validate | verify-remote | bilingual extract/apply/validate | evidence-search plan/run | references rewrite/refresh-remote | maintenance clear-account/plan/apply/verify/flow-identity
+  dataset    support-cache export | contract get | context-pack | classification children/path/audit/apply | curation-queue build/next/verify | import-lca convert | author | patch apply | save-draft | source upload-attachments | validate | verify-remote | bilingual extract/apply/validate | evidence-search plan/run | references rewrite/refresh-remote | maintenance clear-account/plan/apply/verify/flow-identity
   flow       get | list | identity-preflight | build-plan | fetch-rows | materialize-decisions | remediate | publish-version | publish-reviewed-data | build-alias-map | scan-process-flow-refs | plan-process-flow-repairs | apply-process-flow-repairs | regen-product | validate-processes
   lifecyclemodel auto-build | validate-build | publish-build | save-draft | graph | build-resulting-process | publish-resulting-process | orchestrate
   qa         process | flow | lifecyclemodel
@@ -450,6 +453,7 @@ function renderDatasetHelp() {
   tiangong-lca dataset <subcommand> [options]
 
 Implemented Subcommands:
+  support-cache export Export complete observed canonical support rows through OAuth
   contract get        Write TIDAS schema / methodology / ruleset contract artifacts
   context-pack        Write an AI-ready TIDAS contract context pack
   classification       Navigate bundled TIDAS classification schemas or apply selected classifications
@@ -979,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.
@@ -5804,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) {
@@ -6321,6 +6327,46 @@ export async function executeCli(argv, deps) {
                 stderr: '',
             };
         }
+        if (command === 'dataset' && subcommand === 'support-cache') {
+            const help = 'Usage: tiangong-lca dataset support-cache export --out-dir <fresh-dir> [--state-code <int>] [--page-size <1..5000>] [--timeout-ms <1..120000>] [--expected-project-ref <ref>] [--expected-user-id <uuid>] [--json]';
+            const action = commandArgs[0];
+            if (!action || action === '--help' || action === '-h')
+                return { exitCode: 0, stdout: help + '\n', stderr: '' };
+            if (action !== 'export')
+                throw new CliError('dataset support-cache action must be export.', {
+                    code: 'DATASET_SUPPORT_CACHE_ACTION_INVALID',
+                    exitCode: 2,
+                });
+            const { values } = parseArgs({
+                args: commandArgs.slice(1),
+                strict: true,
+                allowPositionals: false,
+                options: {
+                    'out-dir': { type: 'string' },
+                    'state-code': { type: 'string', multiple: true },
+                    'page-size': { type: 'string' },
+                    'timeout-ms': { type: 'string' },
+                    'expected-project-ref': { type: 'string' },
+                    'expected-user-id': { type: 'string' },
+                    json: { type: 'boolean' },
+                    help: { type: 'boolean', short: 'h' },
+                },
+            });
+            if (values.help)
+                return { exitCode: 0, stdout: help + '\n', stderr: '' };
+            const report = await (deps.runDatasetSupportCacheExportImpl ?? runDatasetSupportCacheExport)({
+                outDir: values['out-dir'] ?? '',
+                env: deps.env,
+                fetchImpl: deps.fetchImpl,
+                cliVersion: loadCliPackageVersion(import.meta.url),
+                stateCodes: values['state-code']?.map((value) => value.trim() ? Number(value) : Number.NaN),
+                pageSize: values['page-size'] === undefined ? undefined : Number(values['page-size']),
+                timeoutMs: values['timeout-ms'] === undefined ? undefined : Number(values['timeout-ms']),
+                expectedProjectRef: values['expected-project-ref'],
+                expectedUserId: values['expected-user-id'],
+            });
+            return { exitCode: 0, stdout: stringifyJson(report, values.json ?? false), stderr: '' };
+        }
         if (command === 'dataset' && subcommand === 'verify-remote') {
             const datasetFlags = parseDatasetRemoteVerifyFlags(commandArgs);
             if (datasetFlags.help) {