feat(gcode): add graph lifecycle commands

Author: joshwilhelmi

CHANGELOG.md

@@ -7,6 +7,20 @@ All notable changes to gobby-cli are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.2] — gcode
+
+### Added
+
+#### gcode
+
+- **Graph lifecycle commands** — Added `gcode graph clear` and `gcode graph rebuild` as daemon-backed code-index graph lifecycle commands. Both commands use the current resolved project context, POST to the existing `/api/code-index/graph/{clear,rebuild}` endpoints, and keep existing read-side graph commands (`callers`, `usages`, `imports`, `blast-radius`) unchanged and top-level.
+
+### Changed
+
+#### gcode
+
+- **Strict daemon response contract** — `gcode graph clear` and `gcode graph rebuild` now fail hard when project context cannot be resolved, when no daemon URL is configured or reachable, when the daemon returns a non-2xx status, or when a 2xx response body is not valid JSON. Successful `--format json` output prints the daemon payload directly; `--format text` renders a concise summary from the parsed JSON response.
+
 ## [0.6.1] — gcode
 
 ### Fixed

Cargo.lock

@@ -29,7 +29,8 @@ AST-aware code search powered by tree-sitter. Indexes 18 languages into SQLite
 FTS5 for symbol lookup, content search, file tree navigation, and hybrid
 ranking. When Neo4j, Qdrant, and an embeddings endpoint are configured -
 typically through Gobby - `gcode` adds graph-aware search, semantic search,
-and dependency analysis (`callers`, `usages`, `imports`, `blast-radius`).
+dependency analysis (`callers`, `usages`, `imports`, `blast-radius`), and
+daemon-backed graph lifecycle commands (`gcode graph clear`, `gcode graph rebuild`).
 
 ### gsqz — Output Compression
 

README.md

@@ -1,6 +1,6 @@
 [package]
 name = "gobby-code"
-version = "0.6.1"
+version = "0.6.2"
 edition = "2024"
 rust-version = "1.85"
 authors = ["Josh Wilhelmi <hello@gobby.ai>"]

crates/gcode/Cargo.toml

@@ -115,12 +115,16 @@ gcode symbol <id>                         # Source code by symbol ID
 gcode symbols <id1> <id2> ...             # Batch retrieve
 gcode tree                                # File tree with symbol counts
 
-# Dependency graph (requires Neo4j)
+# Dependency graph reads (requires Neo4j)
 gcode callers "handleAuth"                # Who calls this?
 gcode usages "handleAuth"                 # Incoming call sites
 gcode imports src/auth.ts                 # Import graph for a file
 gcode blast-radius "handleAuth" --depth 3 # Transitive impact analysis
 
+# Graph lifecycle (requires Gobby daemon)
+gcode graph clear                         # Clear current project's graph projection
+gcode graph rebuild                       # Rebuild current project's graph projection
+
 # Project management
 gcode status                              # Index stats
 gcode projects                            # List all indexed projects
@@ -159,7 +163,7 @@ codebase → tree-sitter → SQLite        → FTS5 search
                                           config, secrets, sessions, agents
 ```
 
-Gobby adds graph queries, semantic search, and infrastructure that makes gcode better at its core job — not just more features bolted on.
+Gobby adds graph queries, graph lifecycle orchestration, semantic search, and infrastructure that makes gcode better at its core job — not just more features bolted on.
 
 **Search quality improves.** With Neo4j, `gcode search` blends FTS5 text matching with call-graph relevance. With Qdrant plus a configured embeddings API, conceptual queries like "database connection pooling" can find semantically similar code even when the exact words don't match.
 
@@ -174,6 +178,7 @@ Gobby adds graph queries, semantic search, and infrastructure that makes gcode b
 | Semantic vector search | — | Yes (Qdrant + embeddings API) |
 | Call graph / blast radius | — | Yes (Neo4j) |
 | Import graph | — | Yes (Neo4j) |
+| Graph clear / rebuild lifecycle | — | Yes (daemon-backed) |
 | Auto-indexing on file change | — | Yes (daemon file watcher) |
 | Centralized config + secrets | — | Yes (encrypted, no env vars) |
 | Shared index (daemon + CLI) | — | Yes (gobby-hub.db) |
@@ -192,6 +197,10 @@ Get started with Gobby at [github.com/GobbyAI/gobby](https://github.com/GobbyAI/
 | Embeddings API unavailable | Semantic embeddings disabled. FTS5 + graph still work. |
 | No index yet | Commands error with `Run gcode init to initialize`. |
 
+Read-side graph commands depend on Neo4j. `gcode graph clear` and `gcode graph rebuild`
+are separate lifecycle operations routed through the Gobby daemon for the
+current resolved project.
+
 ## Language Support
 
 gcode parses ASTs using tree-sitter with support for 18 languages: