centy 0.0.21 → 0.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "centy",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "CLI for managing project issues and docs via code in the .centy folder",
   "type": "module",
   "main": "./dist/index.js",

package/proto/centy.proto

@@ -57,6 +57,9 @@ service CentyDaemon {
   // Get a single doc by slug
   rpc GetDoc(GetDocRequest) returns (Doc);
 
+  // Get docs by slug across all tracked projects (global search)
+  rpc GetDocsBySlug(GetDocsBySlugRequest) returns (GetDocsBySlugResponse);
+
   // List all docs
   rpc ListDocs(ListDocsRequest) returns (ListDocsResponse);
 
@@ -125,6 +128,9 @@ service CentyDaemon {
   // Get a single PR by display number (human-readable number like 1, 2, 3)
   rpc GetPrByDisplayNumber(GetPrByDisplayNumberRequest) returns (PullRequest);
 
+  // Get PRs by UUID across all tracked projects (global search)
+  rpc GetPrsByUuid(GetPrsByUuidRequest) returns (GetPrsByUuidResponse);
+
   // List all PRs with optional filtering
   rpc ListPrs(ListPrsRequest) returns (ListPrsResponse);
 
@@ -167,6 +173,37 @@ service CentyDaemon {
 
   // Mark multiple issues as compacted
   rpc MarkIssuesCompacted(MarkIssuesCompactedRequest) returns (MarkIssuesCompactedResponse);
+
+  // ============ LLM Agent RPCs ============
+
+  // Spawn an LLM agent to work on an issue
+  rpc SpawnAgent(SpawnAgentRequest) returns (SpawnAgentResponse);
+
+  // Get current LLM work session for a project
+  rpc GetLlmWork(GetLlmWorkRequest) returns (GetLlmWorkResponse);
+
+  // Clear the active LLM work tracking
+  rpc ClearLlmWork(ClearLlmWorkRequest) returns (ClearLlmWorkResponse);
+
+  // Get local LLM configuration (config.local.json)
+  rpc GetLocalLlmConfig(GetLocalLlmConfigRequest) returns (GetLocalLlmConfigResponse);
+
+  // Update local LLM configuration
+  rpc UpdateLocalLlmConfig(UpdateLocalLlmConfigRequest) returns (UpdateLocalLlmConfigResponse);
+
+  // ============ Link RPCs ============
+
+  // Create a link between two entities (bidirectional)
+  rpc CreateLink(CreateLinkRequest) returns (CreateLinkResponse);
+
+  // Delete a link between two entities (bidirectional)
+  rpc DeleteLink(DeleteLinkRequest) returns (DeleteLinkResponse);
+
+  // List all links for an entity
+  rpc ListLinks(ListLinksRequest) returns (ListLinksResponse);
+
+  // Get all available link types (builtin + custom)
+  rpc GetAvailableLinkTypes(GetAvailableLinkTypesRequest) returns (GetAvailableLinkTypesResponse);
 }
 
 // ============ Init Messages ============
@@ -416,6 +453,7 @@ message Config {
   map<string, string> state_colors = 7;     // State name → hex color (e.g., "open" → "#10b981")
   map<string, string> priority_colors = 8;  // Priority level → hex color (e.g., "1" → "#ef4444")
   LlmConfig llm = 9;                        // LLM-related settings
+  repeated LinkTypeDefinition custom_link_types = 10;  // Custom link types (in addition to built-in)
 }
 
 message CustomFieldDefinition {
@@ -432,6 +470,13 @@ message LlmConfig {
   bool allow_direct_edits = 3;        // Allow LLM to directly edit issue files
 }
 
+// Custom link type definition (for custom relationship types)
+message LinkTypeDefinition {
+  string name = 1;                    // Link type name (e.g., "depends-on")
+  string inverse = 2;                 // Inverse link type (e.g., "dependency-of")
+  string description = 3;             // Optional description
+}
+
 message UpdateConfigRequest {
   string project_path = 1;
   Config config = 2;
@@ -477,6 +522,25 @@ message GetDocRequest {
   string slug = 2;                // e.g., "getting-started"
 }
 
+// ============ Global Doc Search Messages ============
+
+message GetDocsBySlugRequest {
+  string slug = 1;                    // The slug to search for (kebab-case)
+}
+
+// A doc with its source project path
+message DocWithProject {
+  Doc doc = 1;
+  string project_path = 2;            // Absolute path to the project where this doc was found
+  string project_name = 3;            // Human-readable project name (directory name)
+}
+
+message GetDocsBySlugResponse {
+  repeated DocWithProject docs = 1;
+  int32 total_count = 2;
+  repeated string errors = 3;         // Non-fatal errors (e.g., projects that couldn't be accessed)
+}
+
 message ListDocsRequest {
   string project_path = 1;
 }
@@ -603,7 +667,7 @@ message ListSharedAssetsRequest {
 
 // Returned by API (enriched with live data from disk)
 message ProjectInfo {
-  string path = 1;                // Absolute path to project
+  string path = 1;                // Absolute path to project (use this for API calls)
   string first_accessed = 2;      // ISO timestamp
   string last_accessed = 3;       // ISO timestamp
   uint32 issue_count = 4;         // Fetched live from .centy/issues/
@@ -612,6 +676,7 @@ message ProjectInfo {
   string name = 7;                // Fetched live (directory name)
   bool is_favorite = 8;           // User-marked favorite status
   bool is_archived = 9;           // User-marked archived status
+  string display_path = 10;       // Human-readable path with ~/ for home dir (use for display only)
 }
 
 message ListProjectsRequest {
@@ -815,6 +880,25 @@ message GetPrByDisplayNumberRequest {
   uint32 display_number = 2;          // Human-readable number (1, 2, 3...)
 }
 
+// ============ Global PR Search Messages ============
+
+message GetPrsByUuidRequest {
+  string uuid = 1;                    // The UUID to search for (must be valid UUID format)
+}
+
+// A PR with its source project path
+message PrWithProject {
+  PullRequest pr = 1;
+  string project_path = 2;            // Absolute path to the project where this PR was found
+  string project_name = 3;            // Human-readable project name (directory name)
+}
+
+message GetPrsByUuidResponse {
+  repeated PrWithProject prs = 1;
+  int32 total_count = 2;
+  repeated string errors = 3;         // Non-fatal errors (e.g., projects that couldn't be accessed)
+}
+
 message ListPrsRequest {
   string project_path = 1;
 
@@ -936,3 +1020,190 @@ message MarkIssuesCompactedResponse {
   string error = 2;
   uint32 marked_count = 3;            // Number of issues successfully marked
 }
+
+// ============ LLM Agent Messages ============
+
+// Predefined agent types
+enum AgentType {
+  AGENT_TYPE_UNSPECIFIED = 0;
+  AGENT_TYPE_CLAUDE = 1;
+  AGENT_TYPE_GEMINI = 2;
+  AGENT_TYPE_CODEX = 3;
+  AGENT_TYPE_OPENCODE = 4;
+  AGENT_TYPE_CUSTOM = 5;
+}
+
+// Action types for LLM agents
+enum LlmAction {
+  LLM_ACTION_UNSPECIFIED = 0;
+  LLM_ACTION_PLAN = 1;
+  LLM_ACTION_IMPLEMENT = 2;
+}
+
+// Agent configuration (stored in config.local.json)
+message AgentConfig {
+  AgentType agent_type = 1;
+  string name = 2;                      // Display name (e.g., "claude", "my-agent")
+  string command = 3;                   // CLI command (e.g., "claude", "/path/to/agent")
+  repeated string default_args = 4;     // Default arguments for the CLI
+  string plan_template = 5;             // Template name for "plan" action
+  string implement_template = 6;        // Template name for "implement" action
+}
+
+// Local LLM configuration (config.local.json - not version controlled)
+message LocalLlmConfig {
+  string default_agent = 1;             // Name of default agent to use
+  repeated AgentConfig agents = 2;      // Available agents
+  map<string, string> env_vars = 3;     // Environment variables for agents
+}
+
+// Request to spawn an LLM agent
+message SpawnAgentRequest {
+  string project_path = 1;
+  string issue_id = 2;                  // UUID or display number of issue to work on
+  LlmAction action = 3;                 // "plan" or "implement"
+  string agent_name = 4;                // Agent to use (empty = default)
+  repeated string extra_args = 5;       // Additional CLI arguments
+}
+
+message SpawnAgentResponse {
+  bool success = 1;
+  string error = 2;
+  string agent_name = 3;                // Which agent was spawned
+  string issue_id = 4;                  // Resolved issue UUID
+  uint32 display_number = 5;            // Issue display number
+  string prompt_preview = 6;            // First 500 chars of generated prompt
+}
+
+// Get active LLM work for a project
+message GetLlmWorkRequest {
+  string project_path = 1;
+}
+
+message LlmWorkSession {
+  string issue_id = 1;
+  uint32 display_number = 2;
+  string issue_title = 3;
+  string agent_name = 4;
+  LlmAction action = 5;
+  string started_at = 6;                // ISO timestamp
+  uint32 pid = 7;                       // Process ID (0 if unknown/exited)
+}
+
+message GetLlmWorkResponse {
+  bool has_active_work = 1;
+  LlmWorkSession session = 2;           // Current session (if any)
+}
+
+// Clear active work tracking
+message ClearLlmWorkRequest {
+  string project_path = 1;
+}
+
+message ClearLlmWorkResponse {
+  bool success = 1;
+  string error = 2;
+}
+
+// Get local LLM config
+message GetLocalLlmConfigRequest {
+  string project_path = 1;              // Empty = global config only
+}
+
+message GetLocalLlmConfigResponse {
+  LocalLlmConfig config = 1;
+  bool has_project_config = 2;
+  bool has_global_config = 3;
+}
+
+// Update local LLM config
+message UpdateLocalLlmConfigRequest {
+  string project_path = 1;              // Empty = update global config
+  LocalLlmConfig config = 2;
+}
+
+message UpdateLocalLlmConfigResponse {
+  bool success = 1;
+  string error = 2;
+  LocalLlmConfig config = 3;
+}
+
+// ============ Link Messages ============
+
+// Target entity type for links
+enum LinkTargetType {
+  LINK_TARGET_TYPE_UNSPECIFIED = 0;
+  LINK_TARGET_TYPE_ISSUE = 1;
+  LINK_TARGET_TYPE_DOC = 2;
+  LINK_TARGET_TYPE_PR = 3;
+}
+
+// A link between two entities
+message Link {
+  string target_id = 1;               // Target entity ID (UUID for issues/PRs, slug for docs)
+  LinkTargetType target_type = 2;     // Type of the target entity
+  string link_type = 3;               // Relationship type (e.g., "blocks", "parent-of")
+  string created_at = 4;              // ISO timestamp when link was created
+}
+
+// Create a link between two entities (bidirectional - also creates inverse)
+message CreateLinkRequest {
+  string project_path = 1;
+  string source_id = 2;               // Source entity ID
+  LinkTargetType source_type = 3;     // Source entity type
+  string target_id = 4;               // Target entity ID
+  LinkTargetType target_type = 5;     // Target entity type
+  string link_type = 6;               // Link type (e.g., "blocks")
+}
+
+message CreateLinkResponse {
+  bool success = 1;
+  string error = 2;
+  Link created_link = 3;              // The forward link that was created
+  Link inverse_link = 4;              // The inverse link that was created
+}
+
+// Delete a link between two entities (also deletes inverse)
+message DeleteLinkRequest {
+  string project_path = 1;
+  string source_id = 2;               // Source entity ID
+  LinkTargetType source_type = 3;     // Source entity type
+  string target_id = 4;               // Target entity ID
+  LinkTargetType target_type = 5;     // Target entity type
+  string link_type = 6;               // Optional: specific link type to delete (empty = all links between entities)
+}
+
+message DeleteLinkResponse {
+  bool success = 1;
+  string error = 2;
+  uint32 deleted_count = 3;           // Number of links deleted (including inverse)
+}
+
+// List all links for an entity
+message ListLinksRequest {
+  string project_path = 1;
+  string entity_id = 2;               // Entity ID to list links for
+  LinkTargetType entity_type = 3;     // Entity type
+}
+
+message ListLinksResponse {
+  repeated Link links = 1;
+  int32 total_count = 2;
+}
+
+// Get all available link types (builtin + custom)
+message GetAvailableLinkTypesRequest {
+  string project_path = 1;
+}
+
+// Information about a link type
+message LinkTypeInfo {
+  string name = 1;                    // Link type name (e.g., "blocks")
+  string inverse = 2;                 // Inverse link type (e.g., "blocked-by")
+  string description = 3;             // Optional description
+  bool is_builtin = 4;                // Whether this is a built-in type
+}
+
+message GetAvailableLinkTypesResponse {
+  repeated LinkTypeInfo link_types = 1;
+}