repo:edge:add
Stage an edge between distinct descendants of a graph in this repository.
Reference for flywheel repo:edge:add.
Stage an edge only when the graph, source, and target nodes belong to the same repository. The source and target must be distinct descendants beneath the graph container; establish containment before running this command. Nodes and containment assignments may still be pending. Invalid edges are rejected before staging succeeds, leaving the prior batch unchanged.
Command Group
Local Repository
Summary
Stage an edge between distinct descendants of a graph in this repository.
Usage
flywheel repo:edge:add [FLAGS] <ARGS>…Arguments
| Argument | Required | Choices | Description |
|---|---|---|---|
<graph_node_id> | Yes | Graph node UUID in this repository; containment of the distinct source and target nodes must be established before this operation. | |
<source_node_id> | Yes | Source node UUID in the same repository; a distinct descendant beneath graph_node_id. | |
<target_node_id> | Yes | Target node UUID in the same repository; a distinct descendant beneath graph_node_id. |
Required flags
None.
Optional flags
| Flag | Value | Default | Choices | Description |
|---|---|---|---|---|
--repo | string | Local repository filesystem path. | ||
--personal | Use the configured personal repository. | |||
--content-file | string | Optional edge-content file. | ||
--format | FORMAT | json, tsv, csv, table | Output format for command results. | |
--env | PROFILE | Use a configured CLI profile for this invocation. | ||
--out | PATH | Write output to a file path, or use - for stdout. | ||
--open | Open browser-bound URLs when supported. | |||
--no-retry | Disable transient-error retries. | |||
--retry-max | N | Maximum transient-error retry attempts. | ||
--wait | Block on async operations until a terminal state is reached. | |||
--wait-timeout | SECONDS | 600 | Seconds to wait for --wait before timing out. Defaults to 600. | |
--allow-self | Allow mutating the currently active credential. | |||
--timeout | SECONDS | Set the per-request timeout budget in seconds. | ||
--idempotency-key | KEY | Reuse an Idempotency-Key so ambiguous write failures can be retried with the same key. | ||
--force | Force safety-gated operations where supported. | |||
--yes | Skip confirmation prompts for destructive operations. | |||
--debug | Print structured request debugging with secrets masked. | |||
--verbose | Print verbose progress for long-running operations. | |||
-h, --help | Show this help. |
Examples
Stage an edge between distinct descendants of a graph in this repository.
flywheel repo:edge:add <graph_node_id> <source_node_id> <target_node_id> --format=json