Quality plan

Inspection points, sample gates and pack-out checks.

All action kinds · Project workflow

• Kind: quality_plan
• Availability: available
• Registry cost category: one_call
• Lifecycle stage IDs: iqc, programming_and_test, oqc, final_pack_out

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

Returns a draft for review against the project brief and supporting evidence. A completed action does not establish that a physical test, production gate or engineering review has passed.

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
unitsPerBatch	integer	No	Maximum 9007199254740991. Greater than 0
criticalToQuality	string[]	No	Max items 40
packaging	string	No	Max length 2000

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "unitsPerBatch": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "criticalToQuality": {
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500
      }
    },
    "packaging": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Example request

Synthetic example for action.json; adapt it to your reviewed brief.

{
  "kind": "quality_plan",
  "input": {
    "unitsPerBatch": 100,
    "criticalToQuality": [
      "Drawing tolerances require confirmation",
      "Assembly fit must be checked on a golden sample"
    ],
    "packaging": "Packaging specification is not decided."
  }
}

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

maglev actions request PROJECT_ID --input action.json \
  --idempotency-key example-quality-plan-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

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
inspectionPoints	object[]	Yes
inspectionPoints[].stage	string	If parent supplied	One of: iqc, ipqc, fqc, oqc, psi
inspectionPoints[].what	string	If parent supplied
inspectionPoints[].method	string	If parent supplied
inspectionPoints[].sampling	string	If parent supplied	Every unit, first article plus per batch sample, or a stated sample; never a plan the quantity cannot support
aqlSuggestion	object	Yes
aqlSuggestion.level	string,null	If parent supplied
aqlSuggestion.note	string	If parent supplied
goldenSampleGate	string[]	Yes	What the golden sample must demonstrate and how it is tied to a revision
packOutChecks	string[]	Yes
assumptions	string[]	Yes	What was assumed in order to write this draft
openQuestions	string[]	Yes	What only the founder, a factory or a lab can answer
sources	string[]	Yes	Repo paths of the passages actually relied on

Output JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "inspectionPoints": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "stage": {
            "type": "string",
            "enum": [
              "iqc",
              "ipqc",
              "fqc",
              "oqc",
              "psi"
            ]
          },
          "what": {
            "type": "string"
          },
          "method": {
            "type": "string"
          },
          "sampling": {
            "type": "string",
            "description": "Every unit, first article plus per batch sample, or a stated sample; never a plan the quantity cannot support"
          }
        },
        "required": [
          "stage",
          "what",
          "method",
          "sampling"
        ],
        "additionalProperties": false
      }
    },
    "aqlSuggestion": {
      "type": "object",
      "properties": {
        "level": {
          "type": [
            "string",
            "null"
          ]
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "level",
        "note"
      ],
      "additionalProperties": false
    },
    "goldenSampleGate": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What the golden sample must demonstrate and how it is tied to a revision"
    },
    "packOutChecks": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "assumptions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What was assumed in order to write this draft"
    },
    "openQuestions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What only the founder, a factory or a lab can answer"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Repo paths of the passages actually relied on"
    }
  },
  "required": [
    "inspectionPoints",
    "aqlSuggestion",
    "goldenSampleGate",
    "packOutChecks",
    "assumptions",
    "openQuestions",
    "sources"
  ],
  "additionalProperties": false
}