CLI: vyasa node

                                                                                
 Usage: vyasa node [OPTIONS] COMMAND [ARGS]...                              
                                                                                
 Manage node instances                                                          
                                                                                
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help  -h        Show this message and exit.                                │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ list         List node instances.                                            │
│ show         Show a single node instance.                                    │
│ create       Create a new node instance.                                     │
│ link         Link an existing node to a parent node.                         │
│ set-depends  Replace a node's dependency list.                               │
│ supersede    Supersede a node with a new version.                            │
│ note         Write an agent-owned work note onto a node.                     │
│ sub-node     Manage sub-nodes                                                │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node list

                                                                                
 Usage: vyasa node list [OPTIONS]                                           
                                                                                
 List node instances.                                                           
                                                                                
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --type            TEXT  Filter by node type                                  │
│ --status          TEXT  Filter by status                                     │
│ --dir             PATH  Project directory                                    │
│ --help    -h            Show this message and exit.                          │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node show

                                                                                
 Usage: vyasa node show [OPTIONS] NODE_ID                                   
                                                                                
 Show a single node instance.                                                   
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    node_id      TEXT  Node ID [required]                                   │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir           PATH  Project directory                                      │
│ --help  -h            Show this message and exit.                            │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node create

                                                                                
 Usage: vyasa node create [OPTIONS]                                         
                                                                                
 Create a new node instance.                                                    
                                                                                
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --type                 TEXT  Node type ID                                    │
│ --id                   TEXT  Node ID                                         │
│ --parent               TEXT  Parent node ID                                  │
│ --purpose              TEXT  User-owned statement of what this node is FOR   │
│ --dir                  PATH  Project directory                               │
│ --interactive                Force interactive prompts                       │
│ --help         -h            Show this message and exit.                     │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node link

                                                                                
 Usage: vyasa node link [OPTIONS] NODE_ID PARENT_ID                         
                                                                                
 Link an existing node to a parent node.                                        
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    node_id        TEXT  Node ID to link [required]                         │
│ *    parent_id      TEXT  Parent node ID [required]                          │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir           PATH  Project directory                                      │
│ --help  -h            Show this message and exit.                            │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node set-depends

                                                                                
 Usage: vyasa node set-depends [OPTIONS] NODE_ID                            
                                                                                
 Replace a node's dependency list.                                              
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    node_id      TEXT  Node ID to update [required]                         │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ *  --depends  -d      TEXT  New dependency node ID(s) [required]             │
│    --dir              PATH  Project directory                                │
│    --help     -h            Show this message and exit.                      │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node supersede

                                                                                
 Usage: vyasa node supersede [OPTIONS] OLD_ID NEW_ID                        
                                                                                
 Supersede a node with a new version.                                           
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    old_id      TEXT  Old node ID to supersede [required]                   │
│ *    new_id      TEXT  New node ID [required]                                │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --reason          TEXT  Reason for superseding                               │
│ --dir             PATH  Project directory                                    │
│ --help    -h            Show this message and exit.                          │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node note

                                                                                
 Usage: vyasa node note [OPTIONS] NODE_ID                                   
                                                                                
 Write an agent-owned work note onto a node.                                    
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    node_id      TEXT  Node ID to annotate [required]                       │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ *  --text  -t      TEXT  Agent-owned work note [required]                    │
│    --dir           PATH  Project directory                                   │
│    --help  -h            Show this message and exit.                         │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node sub-node

                                                                                
 Usage: vyasa node sub-node [OPTIONS] COMMAND [ARGS]...                     
                                                                                
 Manage sub-nodes                                                               
                                                                                
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help  -h        Show this message and exit.                                │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ add   Create a sub-node under a parent.                                      │
│ list  List all sub-nodes for a parent.                                       │
│ show  Show a specific sub-node.                                              │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node sub-node add

                                                                                
 Usage: vyasa node sub-node add [OPTIONS] [PARENT_ID] [SUB_ID]              
                                                                                
 Create a sub-node under a parent.                                              
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│   parent_id      [PARENT_ID]  Parent node ID                                 │
│   sub_id         [SUB_ID]     Sub-node ID                                    │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --type                 TEXT  Sub-node type                                   │
│ --dir                  PATH  Project directory                               │
│ --interactive                Force interactive prompts                       │
│ --help         -h            Show this message and exit.                     │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node sub-node list

                                                                                
 Usage: vyasa node sub-node list [OPTIONS] PARENT_ID                        
                                                                                
 List all sub-nodes for a parent.                                               
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    parent_id      TEXT  Parent node ID [required]                          │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir           PATH  Project directory                                      │
│ --help  -h            Show this message and exit.                            │
└──────────────────────────────────────────────────────────────────────────────┘

vyasa node sub-node show

                                                                                
 Usage: vyasa node sub-node show [OPTIONS] PARENT_ID SUB_ID                 
                                                                                
 Show a specific sub-node.                                                      
                                                                                
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ *    parent_id      TEXT  Parent node ID [required]                          │
│ *    sub_id         TEXT  Sub-node ID [required]                             │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir           PATH  Project directory                                      │
│ --help  -h            Show this message and exit.                            │
└──────────────────────────────────────────────────────────────────────────────┘