Skip to content
ReqSeq

Set status

Set or remove the status of elements on explicit request of the caller. Only a status of each element’s type is taken (statuses of the type in metamodel.get, #306); an element of a type without status gets none. status: null removes the status line where the type’s status is optional (#343). The only command besides element.supersede that changes a status; no command changes a status on its own (D-030, SR-087).

Command element.setStatus. Writes files in the working tree, never to Git. It is refused while the workspace is read-only. Sets a status from the statuses of the metamodel, and no change can be checked against a missing or faulty metamodel.

Input

Section titled “Input”
Field Type Required Description
refs array of elementRef yes
status keyOrName or null yes Key or display name of a status of the metamodel, in any case; the key is written. It must be a status of the element’s type (#306). null removes the status line, only from an element whose type has an optional status: no status, or only statuses marked invalid (#343); else input.invalid with reason status-required.

Output

Section titled “Output”
Field Type Required Description
files array of string yes
problems array of problem no

App

Section titled “App”

In the command prompt (Ctrl+Shift+P, macOS ⌘⇧P): the command Set status. Key: Ctrl+K T (macOS ⌘K T).

CLI

Section titled “CLI”

reqseq element set-status, with --json for the output as JSON. Its help:

Usage: reqseq element set-status <status> [options]


Set or remove the status of elements on explicit request of the caller. Only a
status of each element's type is taken (`statuses` of the type in metamodel.get,
#306); an element of a type without status gets none. `status: null` removes the
status line where the type's status is optional (#343). The only command besides
element.supersede that changes a status; no command changes a status on its own
(D-030, SR-087).


Arguments:
  status                  Key or display name of a status of the metamodel, in
                          any case; the key is written. It must be a status of
                          the element's type (#306). null removes the status
                          line, only from an element whose type has an optional
                          status: no status, or only statuses marked invalid
                          (#343); else input.invalid with reason
                          status-required. null only via --input


Options:
  --status <value>        instead of the argument <status>
  --refs <value>          repeatable
  --input <json|@file|->  command input as JSON: inline, from a file, or from
                          standard input
  --workspace <path>      workspace root (default: nearest folder upwards with
                          reqseq-workspace.yaml)
  --json                  print exactly the command output as JSON
  --yaml                  print the whole command output as YAML, problems one
                          per line
  -h, --help              show help

API

Section titled “API”

POST /v1/commands/element.setStatus on the local API (reqseq serve api), with the input as the JSON body; the answer is the output.

MCP

Section titled “MCP”

Tool element_setStatus of the MCP server (reqseq mcp), with the input as its arguments.