Knowledge Lifecycle (CRUD)

# Knowledge Lifecycle (CRUD)

All create, pull, and push operations are performed through the interactive sub-menus accessed from the main dashboard.

### Creating a Node

1. Select **◈ Node Operations** from the main menu.
2. Choose **Create New Node**.
3. Enter a slug (e.g., `my-research-note`).
4. A template file is generated in your workspace at `nodes/@your-handle/my-research-note/my-research-note.md`.
5. Edit the file in your preferred text editor.

### Pulling from Server

1. Navigate to the appropriate domain menu (Node, Flow, or Hub).
2. Select **Pull from Server**.
3. Enter the ID of the resource you want to download.
4. An interactive version picker appears — select the specific version or choose **latest**.
5. The content is saved to your workspace with the `pinned_version` recorded in the frontmatter.

### Pushing to Server

1. Select **Push to Server** from the domain menu.
2. The CLI scans your workspace for files under your `@handle` directory.
3. Files with changes are listed. Select the items to push.
4. On success, the server-assigned `id` and `version` are written back to the file's frontmatter.

### Version Pinning

When you pull a specific version, the frontmatter records it:

```yaml
---
# SYNC BEHAVIOR
pinned_version: 3
---
```

This tells the CLI that you intentionally chose version 3 and prevents accidental overwrites when syncing.

Knowledge Lifecycle (CRUD)

// COMMENTS

ON THIS PAGE