@zhuoyuezs/ml-platform 0.2.2-alpha.1 → 0.2.2-alpha.3

package/checksums.json

@@ -2,17 +2,17 @@
   "files": [
     {
       "path": "runtime/business-client/README.md",
-      "sha256": "sha256:7e84fad64f8ee6c7aae467b7947123f3a490b799ec5ffa24fd008e0fa37b133e",
-      "size_bytes": 7898
+      "sha256": "sha256:30d921fabf5bc0339eda60169a1865f6007807b1d9a8d3e646b42f68cd563240",
+      "size_bytes": 8125
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:7fc827b514bf44b2b216eeaa3ba2638739ebd4691fe77093322fd882e2cb11f3",
+      "sha256": "sha256:1e364f51be2b6df7ab5f27b72aa04cb499d9d191a321ab669bba011555e659e7",
       "size_bytes": 1628
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:a497a296ed8b70323bf6a306f92ad7cadd693613d1f8c9fe2df00a045603aee0",
+      "sha256": "sha256:45545a61753cc889a1d578266634f0720423895e0693fa4911e0fdd3c0957f69",
       "size_bytes": 671
     },
     {
@@ -22,8 +22,8 @@
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:2c8c2ccc5ca9d09ac787ea68af928cb4cd63d3348c0b40bfc1898dd2dcb0edec",
-      "size_bytes": 58618
+      "sha256": "sha256:7ddd434c1e8ee64d8a6de9005e4f6b440197eafab021071b9e4a8af340d4e23a",
+      "size_bytes": 57877
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -142,8 +142,8 @@
     },
     {
       "path": "skills/model-lifecycle-management/SKILL.md",
-      "sha256": "sha256:61a89145ef33a2d58c58d8f352006590a47cf9587705568dec1c8ffe7ed8938e",
-      "size_bytes": 4014
+      "sha256": "sha256:4ea40815d73b3a470b2572874dcad63640cbdd53d3c10293d7a5ce8621a13b96",
+      "size_bytes": 4272
     },
     {
       "path": "skills/model-lifecycle-management/agents/openai.yaml",
@@ -152,8 +152,8 @@
     },
     {
       "path": "skills/model-lifecycle-management/references/discovery.md",
-      "sha256": "sha256:c87a9efacb1a18125bc1ee1b3061c5a9b876355e238aa5f7f17a985014413281",
-      "size_bytes": 4899
+      "sha256": "sha256:184472a79fb217dd8c74dffab20e75285b0c8f69207dc593ae3099b8a2b6d6d5",
+      "size_bytes": 5381
     },
     {
       "path": "skills/model-lifecycle-management/references/evaluation.md",
@@ -167,13 +167,13 @@
     },
     {
       "path": "skills/model-lifecycle-management/references/training-contracts.md",
-      "sha256": "sha256:d2b1f4089cd622589fabd50fe1600edfa6c330f4a7516734fe2316fcec7bb1e0",
-      "size_bytes": 12893
+      "sha256": "sha256:4cecf5f90464640d063ca721fded1c27b46bb79daa0f67c78a8fb6b0e3e60b3b",
+      "size_bytes": 14747
     },
     {
       "path": "skills/model-lifecycle-management/references/training.md",
-      "sha256": "sha256:97c20f02b1179dc7b7527cb7b5e11978778ccb8b76cdf88c229bcfdb5786f045",
-      "size_bytes": 5629
+      "sha256": "sha256:97de7894da24a07b4146d6de5e00a0cf17166654fb219a145f35adff5e8a7f99",
+      "size_bytes": 7980
     }
   ],
   "schema_version": "data_platform.ml_platform_checksums/v1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.2.2-alpha.1",
+  "version": "0.2.2-alpha.3",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"

package/release.json

@@ -13,8 +13,8 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:6491b970b094de9514aacdf21a90e8f8f57d429f37a0f762747b2dca4a4d6df2",
-    "version": "0.8.1"
+    "sha256": "sha256:ceb3fdabf57044a5bf8d54baf04ab10327cb896e4eaff3897c18e08e96e5336a",
+    "version": "0.8.2"
   },
   "policy_sha256": "sha256:02fbde0134696b78c0c365d6e0b76c9814227208da5b2b3d4e5dbd82dc4a3606",
   "public_schema_versions": [
@@ -25,7 +25,7 @@
     "ml_data_platform.feature_set/v1",
     "ml_data_platform.dataset_manifest/v1"
   ],
-  "release_version": "0.2.2-alpha.1",
+  "release_version": "0.2.2-alpha.3",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,22 +37,22 @@
   "skills": {
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.8.1 <0.9.0",
-      "revision": "0.2.2-alpha.1",
+      "requires_cli": ">=0.8.2 <0.9.0",
+      "revision": "0.2.2-alpha.3",
       "sha256": "sha256:d32f0306f129d7bf76eb037fe239c84dd3c29c64b61600799d6e40320784bb10"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.8.1 <0.9.0",
-      "revision": "0.2.2-alpha.1",
+      "requires_cli": ">=0.8.2 <0.9.0",
+      "revision": "0.2.2-alpha.3",
       "sha256": "sha256:e7d87c272a0dcc028ea628d5e36f5b7e52ed27cb9c1bc17ea76527478e28b46d"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.8.1 <0.9.0",
-      "revision": "0.2.2-alpha.1",
-      "sha256": "sha256:aaa3fdb54c0ff9e8dfa0f71e67d072830786e5e3d4803ba3962dff723d159386"
+      "requires_cli": ">=0.8.2 <0.9.0",
+      "revision": "0.2.2-alpha.3",
+      "sha256": "sha256:ec6ebb2587fd7acd024def75a8c0e9cd94b6cdd8ee6df439609291b496751b91"
     }
   },
-  "source_commit": "d81c77ff5c978ba1da4ce4b370c19c0be27d28c4"
+  "source_commit": "e713953153439c28680b60b56f57d3b9679ff49a"
 }

package/runtime/business-client/README.md

@@ -147,6 +147,9 @@ resolve the same contracts as submission without registering or scheduling
 workloads. Read `submitted=false` and `unchecked`: successful preflight does not
 verify image pulls, cluster resources or runtime execution. Complete request
 examples and identity propagation are in the bundled model lifecycle Skill.
+Training Run and Job validation also return `effective_trainer_parameters`;
+for Job preflight it must match `job_spec.trainer_parameters` and represents
+the complete mapping delivered to the Worker after defaults are resolved.
 
 Maintainers can export the current API, including uncommitted schema changes,
 with `uv run python scripts/generate_openapi_schema.py --working-tree` from the

package/runtime/business-client/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.8.1",
+      "version": "0.8.2",
       "license": "UNLICENSED",
       "bin": {
         "ml-platform": "src/cli.js"

package/runtime/business-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "private": true,
   "description": "JavaScript implementation of the ML Platform business client",
   "bin": {

package/runtime/business-client/src/cli.js

@@ -26,7 +26,7 @@ const BUSINESS_COMMANDS = new Set([
     "add-dataset", "update-dataset", "delete-dataset", "list-dataset-artifacts",
     "register-operator", "show-operator-specs", "delete-operator", "run-operator",
     "get-job", "wait-job", "retry-job", "cancel-job", "get-dataset-artifact", "download-dataset-artifact", "fetch-inference-data", "fetch-inference-context", "predict-model", "apply",
-    "list-system-models", "get-system-model", "list-trainer-definitions", "get-trainer-definition", "register-training-run", "validate-training-run", "submit-training-job", "get-training-job", "retry-training-job", "cancel-training-job",
+    "list-system-models", "get-system-model", "register-training-run", "validate-training-run", "submit-training-job", "get-training-job", "retry-training-job", "cancel-training-job",
     "register-evaluation-config", "get-evaluation-config", "register-metric-definition", "get-metric-definition",
     "register-executable-package", "verify-executable-package", "publish-executable-package",
     "validate-evaluation-run", "submit-evaluation", "get-evaluation-run", "get-evaluation-job", "retry-evaluation-job", "cancel-evaluation-job", "list-evaluation-attempts",
@@ -108,8 +108,6 @@ const COMMAND_USAGE = {
     "predict-model": "predict-model REQUEST_JSON --serving-url URL",
     "list-system-models": "list-system-models",
     "get-system-model": "get-system-model NAME VERSION [--project PROJECT]",
-    "list-trainer-definitions": "list-trainer-definitions",
-    "get-trainer-definition": "get-trainer-definition NAME VERSION [--project PROJECT]",
     "register-training-run": "register-training-run RUN_JSON",
     "validate-training-run": "validate-training-run RUN_JSON",
     "submit-training-job": "submit-training-job REQUEST_JSON",
@@ -827,15 +825,6 @@ async function runBusinessCli(argv) {
         const project = take(rest, "--project", "default");
         result = await client(options).get(`/system-models/${encodeURIComponent(project)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}`);
     }
-    else if (options.command === "list-trainer-definitions") {
-        result = await client(options).get("/trainer-definitions");
-    }
-    else if (options.command === "get-trainer-definition") {
-        const name = positional(rest, "trainer name");
-        const version = positional(rest, "trainer version");
-        const project = take(rest, "--project", "default");
-        result = await client(options).get(`/trainer-definitions/${encodeURIComponent(project)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}`);
-    }
     else if ({
         "register-training-run": "/training-runs", "validate-training-run": "/training-runs/validate",
         "validate-training-job": "/training-jobs/validate", "validate-model-package": "/model-packages/validate", "submit-training-job": "/training-jobs", "register-evaluation-config": "/evaluation-configs", "register-metric-definition": "/metric-definitions",

package/skills/model-lifecycle-management/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: model-lifecycle-management
-description: Manage ITSMP model training, evaluation, immutable model packaging, and contract-bound inference requests. Use when a user asks to list or inspect registered TrainerDefinitions, register a trainer, validate or submit a training run, inspect/retry/cancel training jobs, configure or run governed evaluation, inspect evaluation evidence, validate a ModelArtifact, create and inspect a ModelPackage, or invoke a deployed model. Do not use for feature catalog authoring, dataset builds, model deployment, Kubernetes administration, or image release engineering.
+description: Manage ITSMP system-model discovery, model training, evaluation, immutable model packaging, and contract-bound inference requests. Use when a user asks to inspect platform-owned SystemModels and runtime bindings, validate or submit a training run, inspect/retry/cancel training jobs, configure or run governed evaluation, inspect evaluation evidence, validate a ModelArtifact, create and inspect a ModelPackage, or invoke a deployed model. Do not use for feature catalog authoring, dataset builds, model deployment, Kubernetes administration, or image release engineering.
 ---
 
 # Model Lifecycle Management
@@ -24,13 +24,15 @@ Before training a model that will be evaluated, also read
 [references/evaluation.md](references/evaluation.md). Check the final dataset
 schema, training split binding and evaluation runtime before submission.
 OpenAPI free-form dictionaries are not complete nested contracts: use the
-examples in these references and same-release validation, not successive 422s
-to discover fields. Preserve release/error evidence when deployment differs.
+SystemModel `parameter_schema`, examples in these references and same-release
+validation, not successive 422s to discover fields. Preserve release/error
+evidence when deployment differs.
 
-- Establish exact immutable inputs, TrainerDefinition `v1`, runtime image digest, model inputs/targets, resources, evaluation policy, and package destination from authoritative contracts. Do not infer them from model names.
+- Establish exact immutable inputs, canonical SystemModel `v1`, runtime-release image digest, model inputs/targets, resources, evaluation policy, and package destination from authoritative contracts. Do not infer them from model names.
+- For Chronos-2, inspect the typed `lora_config` schema before authoring a Run and preserve `effective_trainer_parameters` from validation. Do not infer PEFT keys or rely on Worker defaults.
 - Validate, register, submit, retry, cancel, and package creation are separate actions. Read-only discovery and validation do not authorize mutation or workload submission.
 - Before submission, show the exact JSON path, immutable identities, expected workload, and target API. Obtain explicit authorization. Retry and cancel require separate authorization for the exact Job.
-- Never use `latest` image tags. During development TrainerDefinition stays at `v1`; rebinding it follows the reviewed release procedure and requires confirming no active Job references the old definition.
+- Never use `latest` image tags. During development the canonical SystemModel stays at `v1`; image changes are reviewed Runtime Release updates and require confirming no active Job depends on the previous binding.
 - A succeeded Job is insufficient evidence. Training requires a valid ModelArtifact and signature; evaluation requires immutable Result/Summary evidence and coverage; packaging requires `READY`, an immutable image digest, manifest, and passing test report.
 - Register a ModelArtifact through `register-model-artifact` only after a platform-generated PASS evaluation/result or summary has complete evidence; do not bypass the CLI with a direct registration HTTP request.
 - Do not register caller-computed evaluation results. Workers produce predictions, metrics, decisions, and summaries from frozen DatasetArtifact rowsets.

package/skills/model-lifecycle-management/references/discovery.md

@@ -9,18 +9,21 @@ capability probe.
 ## Effective runtime policy
 
 ```bash
+ml-platform --profile server list-system-models
+ml-platform --profile server get-system-model NAME v1 --project PROJECT
 ml-platform --profile server get-model-runtime-release
-ml-platform --profile server list-trainer-definitions
-ml-platform --profile server get-trainer-definition NAME v1 --project PROJECT
 ```
 
-Discovery returns `configured`, `release_id`, `approval_policy`, and `bindings`.
-Each binding contains the exact `project/name:version:device` trainer key,
+System-model discovery returns the platform-owned algorithm identity,
+capabilities, parameter contract and Serving input modes. Runtime discovery
+returns `configured`, `release_id`, `approval_policy`, and `bindings`. Each
+binding contains the exact `project/name:version:device` compatibility key,
 immutable training and Serving base images, input modes and architectures.
-Compare the registered TrainerDefinition image against the binding before Job
-preflight. A binding is release approval, not proof that a matching definition
-is registered. `configured=false` means capability-based validation without a
-release allowlist; it does not mean every trainer/device is approved by a release.
+Confirm that the canonical SystemModel supports the selected device and that an
+exact runtime binding exists before Job preflight. Do not use historical
+TrainerDefinition registry entries to select a model or image.
+`configured=false` means capability-based validation without a release allowlist;
+it does not mean every model/device is approved by a release.
 `evaluation.runtime_identity` and `default_executor` are effective server values.
 `worker_dependencies_verified=false` explicitly means discovery has not tested
 imports, image pulls or model prediction in the Worker.
@@ -65,6 +68,10 @@ artifact eligibility, selected runtime, input modes and immutable-version confli
 checks used by creation. Both return `status=valid`, the proposed `job_spec` or
 `package`, `submitted=false` and `unchecked` execution checks. They do not register
 Jobs/packages or invoke schedulers. Artifact reads can populate local caches.
+For training, confirm that top-level `effective_trainer_parameters` exactly
+matches `job_spec.trainer_parameters`; this is the complete parameter mapping
+the Worker receives after platform defaults and reproducibility controls are
+resolved.
 
 A valid preview does not prove image availability, cluster capacity, credentials,
 framework imports, training success or packaging test success. Read `unchecked`
@@ -78,9 +85,11 @@ Training Run `task`, `data`, `data.artifact`, `features.feature_set`, `splits`,
 `temporal` and `trainer` are explicit objects in OpenAPI. Evaluation artifact,
 config references, members and execution, plus ModelPackage requests, are also
 structured. Unknown keys return 422 with `detail[].loc` identifying the field.
-Keep algorithm-specific `trainer.parameters` and documented plugin configuration
-maps extensible; validate them against the registered plugin schema. Do not treat
-all remaining `additionalProperties` as a platform schema defect.
+Keep algorithm-specific `trainer.parameters` governed by the SystemModel
+parameter schema. A typed nested contract such as Chronos-2 `lora_config`
+rejects unknown fields; a SystemModel that intentionally advertises
+`additionalProperties` remains extensible. Do not infer one policy from the
+other.
 
 These HTTP checks preserve accepted values and do not rewrite historical stored
 contracts or hashes. Legacy records remain readable. A previously ignored typo

package/skills/model-lifecycle-management/references/training-contracts.md

@@ -68,6 +68,59 @@ Non-temporal regression can omit it. Do not change task kind just to evade check
 `series_keys` must identify entity-key columns when multiple series coexist;
 an empty list treats the entire artifact as one series.
 
+## Chronos-2 LoRA parameters
+
+Chronos-2 fine-tuning settings belong under `trainer.parameters`; they are
+frozen with the immutable TrainingRun. This fragment overrides rank and keeps
+the other released LoRA defaults explicit:
+
+```json
+{
+  "trainer": {
+    "project": "default",
+    "name": "chronos2_forecaster",
+    "version": "v1",
+    "parameters": {
+      "finetune_mode": "lora",
+      "num_steps": 1000,
+      "batch_size": 16,
+      "learning_rate": 0.00001,
+      "gradient_accumulation_steps": 2,
+      "logging_steps": 10,
+      "lora_config": {
+        "r": 16,
+        "lora_alpha": 16,
+        "lora_dropout": 0.0,
+        "target_modules": [
+          "self_attention.q",
+          "self_attention.v",
+          "self_attention.k",
+          "self_attention.o",
+          "output_patch_embedding.output_layer"
+        ]
+      }
+    }
+  },
+  "reproducibility": {"seed": 42, "deterministic": true}
+}
+```
+
+Always obtain the accepted fields, target-module enum and defaults from
+`get-system-model chronos2_forecaster v1`; unknown nested LoRA keys are
+rejected before scheduling. `r >= 1`, `lora_alpha >= 1`, and
+`0 <= lora_dropout < 1`. `finetune_mode=full` rejects `lora_config`.
+
+The platform materializes omitted values before Job creation. Run validation
+returns `effective_trainer_parameters`; Job validation returns the same object
+both at the top level and in `job_spec.trainer_parameters`. Review that object
+instead of assuming library defaults. Changing any Trainer parameter requires
+a new TrainingRun identity; Job retry cannot alter it.
+
+Do not put `prediction_length` in this mapping. It is derived from the temporal
+horizon and frequency. Trainer `context_length` defaults to the sequence input
+adapter's context length, and `min_past` defaults to prediction length. GPU,
+CPU, memory and deadline remain TrainingJob execution fields.
+
 ## Direct tabular forecasting with known-future features
 
 Tree and other matrix-based models can forecast a variable target grid without
@@ -237,7 +290,7 @@ For `continuous_target_series`, TrainingRun v3 derives the fixed maximum
 `prediction_length` as `data.temporal.horizon / data.temporal.frequency`; the
 horizon must be a positive exact multiple of the frequency. The target input
 must be a numeric, at-prediction Feature and the output label must be the sole
-entry in `data.labels`. Use this adapter only when the inspected TrainerDefinition
+entry in `data.labels`. Use this adapter only when the inspected SystemModel
 advertises `forecast_target_modes=["continuous_target_series"]`.
 
 The resulting model emits the complete fixed-length trajectory. Serving accepts

package/skills/model-lifecycle-management/references/training.md

@@ -6,10 +6,10 @@ Settle the final DataSchema (including split/metadata and label/time columns),
 FeatureSet order and evaluation runtime before the first Job. See
 [evaluation.md](evaluation.md) for inherited split bindings and runtime failures.
 
-- Inspect exact TrainerDefinition `project/name:v1`, entrypoint, image digest,
+- Inspect the exact canonical SystemModel `project/name:v1`, entrypoint,
   capabilities (including `forecast_target_modes`) and parameter schema. Similar names in different projects are
-  distinct identities; registration does not imply runtime approval.
-- Match definition and device to the active runtime release. On `not approved
+  distinct identities. Resolve its immutable image from the active Runtime Release.
+- Match the SystemModel and device to the active runtime release. On `not approved
   for device`, preserve the rejected identity, device and release ID. Use `get-model-runtime-release` to find the
   approved binding; if the deployed release lacks discovery, request its contract;
   do not try similar names or re-register trainers to bypass approval.
@@ -52,22 +52,22 @@ working directory so later diagnosis needs no source repository.
 Read [training-contracts.md](training-contracts.md) when authoring a Run or Job
 JSON. It provides complete request shapes, response paths and sequence semantics.
 
-Discover already-registered TrainerDefinitions (read-only) before authoring a
-TrainingRunSpec or deciding whether registration is needed:
+Discover the platform-owned SystemModel before authoring a TrainingRunSpec, then
+inspect the active Runtime Release for the selected device:
 
 ```bash
-ml-platform --profile server list-trainer-definitions
-ml-platform --profile server get-trainer-definition <name> <version> [--project default]
+ml-platform --profile server list-system-models
+ml-platform --profile server get-system-model <name> <version> [--project default]
+ml-platform --profile server get-model-runtime-release
 ```
 
-`get-trainer-definition` returns the entrypoint, immutable training image digest,
-`artifact_format`, `model_file`, capabilities, and parameter schema. Use it to confirm
-the referenced `v1` definition exists and its image digest matches the approved runtime
-release; discovery never mutates the registry. Registering a new definition is the
-separate mutation below, and a 404 means the definition (not the model plugin) is missing.
+`get-system-model` returns the canonical identity, entrypoint, `artifact_format`,
+`model_file`, capabilities, parameter schema, and Serving input modes. Runtime
+discovery supplies the approved immutable training image for the selected device.
+A missing SystemModel or runtime binding is a platform release gap; do not register
+or select a historical TrainerDefinition as a workaround.
 
 ```bash
-ml-platform --profile server register-trainer trainer-definition.json
 ml-platform --profile server validate-training-run training-run.json
 ml-platform --profile server register-training-run training-run.json
 ml-platform --profile server validate-training-job training-job-request.json
@@ -75,7 +75,7 @@ ml-platform --profile server submit-training-job training-job-request.json
 ml-platform --profile server get-training-job <job-id>
 ```
 
-The TrainingRun binds immutable DatasetArtifact identities, DataSchema, ordered inputs, targets, InputAdapter, TrainerDefinition `v1`, reproducibility controls, and runtime identity. Validation proves compatibility only. Submit the run and Job separately after authorization and record spec hash and Job ID. Terminal success must expose a ModelArtifact ID; validate it before evaluation or packaging.
+The TrainingRun binds immutable DatasetArtifact identities, DataSchema, ordered inputs, targets, InputAdapter, canonical SystemModel `v1`, reproducibility controls, and runtime identity. Job resolution freezes the SystemModel and approved runtime image as an internal TrainerDefinition snapshot. Validation proves compatibility only. Submit the run and Job separately after authorization and record spec hash and Job ID. Terminal success must expose a ModelArtifact ID; validate it before evaluation or packaging.
 
 ```bash
 ml-platform --profile server validate-model-artifact <artifact-id>
@@ -85,6 +85,70 @@ ml-platform --profile server cancel-training-job <job-id>
 
 Retry and cancellation require exact-Job authorization. Never change a run contract while retrying; create a new immutable run when semantic inputs change.
 
+## Chronos-2 fine-tuning parameters
+
+Configure Chronos-2 algorithm parameters only under
+`trainer.parameters` in the TrainingRun. Configure execution device and GPU
+resources later under TrainingJob `execution`; do not mix the two contracts.
+The Run is immutable after registration, so changing rank, learning rate,
+batch size or fine-tuning mode requires a new `run_id`. Retrying an existing
+Job must retain the original parameters.
+
+Inspect the same-release contract first:
+
+```bash
+ml-platform --profile server get-system-model \
+  chronos2_forecaster v1 --project default
+```
+
+The returned `parameter_schema` is authoritative. A typical explicit LoRA
+fragment is:
+
+```json
+{
+  "trainer": {
+    "project": "default",
+    "name": "chronos2_forecaster",
+    "version": "v1",
+    "parameters": {
+      "finetune_mode": "lora",
+      "num_steps": 1000,
+      "batch_size": 16,
+      "learning_rate": 0.00001,
+      "gradient_accumulation_steps": 2,
+      "logging_steps": 10,
+      "lora_config": {
+        "r": 16,
+        "lora_alpha": 32,
+        "lora_dropout": 0.05
+      }
+    }
+  },
+  "reproducibility": {"seed": 42, "deterministic": true}
+}
+```
+
+`r` and `lora_alpha` must be positive integers; `lora_dropout` is in `[0, 1)`.
+Only target modules enumerated by the SystemModel schema are accepted. LoRA is
+the default mode; full fine-tuning rejects `lora_config`. Omitted LoRA settings
+resolve to `r=8`, `lora_alpha=16`, `lora_dropout=0` and the released Chronos-2
+target-module list. Omitted learning rate resolves to `1e-5` for LoRA and
+`1e-6` for full fine-tuning. `min_past` defaults to the derived prediction
+length, while trainer `context_length` defaults to
+`input_adapter.context_length`.
+
+Set random seed and determinism only through top-level `reproducibility`.
+Compatibility fields with the same names may appear in the parameter schema,
+but the top-level values are authoritative. Do not configure
+`prediction_length`; the platform derives it as `temporal.horizon /
+temporal.frequency`.
+
+After `validate-training-run`, inspect and preserve
+`effective_trainer_parameters`. After Run registration, call
+`validate-training-job` and confirm that its top-level
+`effective_trainer_parameters` exactly equals
+`job_spec.trainer_parameters` before requesting submission authorization.
+
 ## Chronos-2 future-known inputs
 
 For storage forecasting, tomorrow's weather forecast and peak/valley schedule