piyaz_link
Create, update, or remove dependency edges.
source/target accept 'TRV-42' or UUIDs. depends_on=source needs target's output (target must finish first). relates_to=informational, neither blocks. Litmus: removing the target makes the source impossible → depends_on; merely harder → relates_to. create=new edge; note REQUIRED and substantive (placeholders 'needed'/'depends'/'related' rejected), write it as a brief to the developer starting the source task. update=rewrite the note, keyed by source+target+type (type is the lookup key there; pass edgeId to also change type). To re-type without an edgeId: remove, then create with a fresh note. remove=same keys. Server rejects self-edges, duplicates, and cycles (the error names the chain). On 'duplicate edge': treat as success. Fails while the project is archived (reopen via piyaz_workspace status='active'). Verify with piyaz_map view='neighbors'.
Actions
| Action | Purpose |
|---|---|
create | new edge (source, target, type, note required) |
update | rewrite the note of an edge keyed by source+target+type; with edgeId you may also change type |
remove | delete by source+target+type or edgeId |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
action | "create" | "update" | "remove" | Yes | create=new edge (source, target, type, note required). update=rewrite the note of an edge keyed by source+target+type; with edgeId you may also change type. remove=delete by source+target+type or edgeId. |
edgeId | string (uuid) | No | Edge UUID, when known. Alternative key for update/remove; source+target+type works without it. |
note | string | No | Why this relationship exists; propagates into downstream agent context. REQUIRED on create; placeholders ('needed', 'depends', 'related') rejected. Write what the source task gets from the target: a decision, code, a contract, a fixture. |
source | string | No | Source taskRef ('TRV-42') or UUID. Required for create; keys update/remove together with target+type. |
target | string | No | Target taskRef ('TRV-42') or UUID. Required for create; keys update/remove together with source+type. |
type | "depends_on" | "relates_to" | No | depends_on = source needs target done first. relates_to = informational, neither blocks. Required for create. |
Last updated