⣀⣠⣤⣤⣀⣀ ⢠⣶⠟⠛⠉⠉⠉⠛⠻⢿⣶⣤⡀ ⢠⡿⠁ ⣍⠻⢿⣦⡀ ⢠⡿⠁ ⠈⢧⣄⠛⢿⣶⣄⣠⡾⣧⡀ ⢀⣿⠃ ⠘⣿⣷⣦⡉⠻⣫⣾⡽⣷ ⣿⠇ ⣀⣀⡀ ⣀⣀⡀ ⠸⣿⠻⣿⣾⡿⠃ ⠹⣿⣷⡀ ⣸⣿⠟⠛⠉ ⠉⠛⠻⣿⣇ ⠈⠛⠛⠒ ⢠⣿⠃ ⢀⣀⣠⣤⣤⣤⣤⣤⣤⣤⣤⣤⣤⣀⡀ ⠘⣿⡆

orstrum push

Sync the local graph to your cloud workspace.

$ orstrum push [--config <path>]

Reads .orstrum/graph.db and upserts all rows into the cloud. The sync is idempotent — running push twice produces no duplicates. Rows are matched on natural keys (workspace_id + name for repos, repo_id + rel_path for nodes).

What is pushed

repos

Repository name and root path.

nodes

File relative paths and content hashes.

exports

Exported symbol names, kinds, and AST signatures. Replaced per-node on each push.

edges

Import edges with specifier, locality flags, package name, and imported symbols. Replaced per-source-file on each push.

summaries

Purpose text, model, cost, and token counts. Upserted on node_id.

Raw source is never pushed. The cloud workspace receives graph structure and summaries only.

Typical workflow

$ orstrum scan
$ orstrum summarize   # optional but recommended
$ orstrum push
  ↳ 1 repo, 847 nodes, 4,203 edges synced in 1.2s