Skip to content
Maglev docs

Check progress

A draft progress request and evidence checklist.

All action kinds · Project workflow

  • Kind: status_check
  • Availability: available
  • Registry cost category: one_call
  • Lifecycle stage IDs: material_coordination, tracking

The cost category describes model work in the registry; it is not a manufacturing price or a monetary quote. Read maglev actions kinds --json for current availability and schemas.

What this does

Section titled “What this does”

Can draft a status request. That draft is not new evidence about production progress.

Input

Section titled “Input”

Send these fields inside the request’s input object. Use only facts you have, and keep unresolved requirements explicit. Optional fields with defaults can be omitted.

Field Type Required Details
factoryId string No Min length 1. Max length 120
factoryName string No Min length 1. Max length 200
orderSummary string Yes Min length 1. Max length 2000
milestone string Yes The milestone to check: material arrival, T1 shots, first article, packing. Min length 1. Max length 200
lastUpdate string No What the factory last told us, and when. Max length 1000
questions string[] No Max items 10
Input JSON schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "factoryId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "factoryName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "orderSummary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "milestone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The milestone to check: material arrival, T1 shots, first article, packing"
    },
    "lastUpdate": {
      "description": "What the factory last told us, and when",
      "type": "string",
      "maxLength": 1000
    },
    "questions": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      }
    }
  },
  "required": [
    "orderSummary",
    "milestone"
  ]
}

Request the action

Section titled “Request the action”

Prepare action.json with kind: "status_check" and an input object matching the schema above.

Replace PROJECT_ID with your saved project ID. Use a new idempotency key for new work and retain it for an identical retry.

Terminal window
maglev actions request PROJECT_ID --input action.json \
  --idempotency-key example-status-check-001 --json

Read action.status, action.output, deliveries and any task in the response. Model actions can take several minutes. After a timeout, check saved actions before retrying. See request and recovery behavior.

Output

Section titled “Output”

The schema below describes action.output.result. The saved action.output envelope also contains draft: true and a note. It can be null while an action is running or after a failure; check the status before reading the result. Null or missing facts are unknown; preserve source references and open questions.

Field Type Required Details
messageZh string Yes
messageEn string Yes
checklist string[] Yes Min items 1
factory object or null Yes
factoryResolved boolean Yes
subjectZh string Yes
Output JSON schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "messageZh": {
      "type": "string"
    },
    "messageEn": {
      "type": "string"
    },
    "checklist": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "factory": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "factoryId": {
              "type": [
                "string",
                "null"
              ]
            },
            "directoryId": {
              "type": [
                "string",
                "null"
              ]
            },
            "nameEn": {
              "type": "string"
            },
            "nameZh": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "factoryId",
            "directoryId",
            "nameEn",
            "nameZh"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "factoryResolved": {
      "type": "boolean"
    },
    "subjectZh": {
      "type": "string"
    }
  },
  "required": [
    "messageZh",
    "messageEn",
    "checklist",
    "factory",
    "factoryResolved",
    "subjectZh"
  ],
  "additionalProperties": false
}