Query nodes, relationships, traces, and temporal state
Query nodes with optional filters for type and status
Library function: src/operations/query-nodes!queryNodesOp
spm query nodes [options]
| Flag | Description | Required |
|---|---|---|
--path |
SysProM document path (auto-detected if omitted) | |
--json |
output as JSON | |
--type |
filter by node type | |
--status |
filter by node status |
Valid type:
intent, concept, capability, element, realisation, invariant, principle, policy, protocol, stage, role, gate, mode, artefact, artefact_flow, decision, change, view, milestone, version
Valid status:
proposed, accepted, active, implemented, adopted, defined, introduced, in_progress, complete, consolidated, experimental, deprecated, retired, superseded, abandoned, deferred
Query a single node by ID with its incoming and outgoing relationships
Library function: src/operations/query-node!queryNodeOp
spm query node <id> [options]
| Argument | Description |
|---|---|
<id> |
node ID to retrieve |
| Flag | Description | Required |
|---|---|---|
--path |
SysProM document path (auto-detected if omitted) | |
--json |
output as JSON |
Query relationships with optional filters for from, to, and type
Library function: src/operations/query-relationships!queryRelationshipsOp
spm query rels [options]
| Flag | Description | Required |
|---|---|---|
--path |
SysProM document path (auto-detected if omitted) | |
--json |
output as JSON | |
--from |
filter relationships by source node | |
--to |
filter relationships by target node | |
--type |
filter by relationship type |
Trace refinement chain from a node (follows refines, realises, implements)
Library function: src/operations/trace-from-node!traceFromNodeOp
spm query trace <id> [options]
| Argument | Description |
|---|---|
<id> |
node ID to start trace from |
| Flag | Description | Required |
|---|---|---|
--path |
SysProM document path (auto-detected if omitted) | |
--json |
output as JSON |
Extract all timestamped lifecycle events from a document, sorted chronologically
Library function: src/operations/timeline!timelineOp
spm query timeline [options]
| Flag | Description | Required |
|---|---|---|
--path |
SysProM document path (auto-detected if omitted) | |
--json |
output as JSON | |
--node |
filter events to a specific node |
Determine the active states of all nodes at a specific point in time
Library function: src/operations/state-at!stateAtOp
spm query state-at <time> [options]
| Argument | Description |
|---|---|
<time> |
ISO timestamp to query |
| Flag | Description | Required |
|---|---|---|
--path |
SysProM document path (auto-detected if omitted) | |
--json |
output as JSON |