centy 0.0.27 → 0.0.29

package/proto/centy.proto

@@ -28,6 +28,9 @@ service CentyDaemon {
   // List all issues with optional filtering
   rpc ListIssues(ListIssuesRequest) returns (ListIssuesResponse);
 
+  // Advanced issue search with query language
+  rpc AdvancedSearch(AdvancedSearchRequest) returns (AdvancedSearchResponse);
+
   // Update an existing issue
   rpc UpdateIssue(UpdateIssueRequest) returns (UpdateIssueResponse);
 
@@ -98,17 +101,6 @@ service CentyDaemon {
   // List all shared assets
   rpc ListSharedAssets(ListSharedAssetsRequest) returns (ListAssetsResponse);
 
-  // ============ Plan RPCs ============
-
-  // Get an issue's plan
-  rpc GetPlan(GetPlanRequest) returns (GetPlanResponse);
-
-  // Update (or create) an issue's plan
-  rpc UpdatePlan(UpdatePlanRequest) returns (UpdatePlanResponse);
-
-  // Delete an issue's plan
-  rpc DeletePlan(DeletePlanRequest) returns (DeletePlanResponse);
-
   // ============ Project Registry RPCs ============
 
   // List all tracked projects
@@ -132,6 +124,12 @@ service CentyDaemon {
   // Set project organization
   rpc SetProjectOrganization(SetProjectOrganizationRequest) returns (SetProjectOrganizationResponse);
 
+  // Set user-scope custom title (stored in ~/.centy/projects.json, only visible to current user)
+  rpc SetProjectUserTitle(SetProjectUserTitleRequest) returns (SetProjectUserTitleResponse);
+
+  // Set project-scope custom title (stored in .centy/project.json, visible to all users)
+  rpc SetProjectTitle(SetProjectTitleRequest) returns (SetProjectTitleResponse);
+
   // ============ Organization RPCs ============
 
   // Create a new organization
@@ -234,6 +232,20 @@ service CentyDaemon {
   // Update local LLM configuration
   rpc UpdateLocalLlmConfig(UpdateLocalLlmConfigRequest) returns (UpdateLocalLlmConfigResponse);
 
+  // ============ Temp Workspace RPCs ============
+
+  // Open a project in a temporary VS Code workspace
+  rpc OpenInTempVscode(OpenInTempVscodeRequest) returns (OpenInTempVscodeResponse);
+
+  // List all temp workspaces
+  rpc ListTempWorkspaces(ListTempWorkspacesRequest) returns (ListTempWorkspacesResponse);
+
+  // Close/cleanup a temp workspace
+  rpc CloseTempWorkspace(CloseTempWorkspaceRequest) returns (CloseTempWorkspaceResponse);
+
+  // Cleanup all expired workspaces
+  rpc CleanupExpiredWorkspaces(CleanupExpiredWorkspacesRequest) returns (CleanupExpiredWorkspacesResponse);
+
   // ============ Link RPCs ============
 
   // Create a link between two entities (bidirectional)
@@ -247,6 +259,26 @@ service CentyDaemon {
 
   // Get all available link types (builtin + custom)
   rpc GetAvailableLinkTypes(GetAvailableLinkTypesRequest) returns (GetAvailableLinkTypesResponse);
+
+  // ============ User RPCs ============
+
+  // Create a new user
+  rpc CreateUser(CreateUserRequest) returns (CreateUserResponse);
+
+  // Get a single user by ID
+  rpc GetUser(GetUserRequest) returns (User);
+
+  // List all users
+  rpc ListUsers(ListUsersRequest) returns (ListUsersResponse);
+
+  // Update an existing user
+  rpc UpdateUser(UpdateUserRequest) returns (UpdateUserResponse);
+
+  // Delete a user
+  rpc DeleteUser(DeleteUserRequest) returns (DeleteUserResponse);
+
+  // Sync users from git history
+  rpc SyncUsers(SyncUsersRequest) returns (SyncUsersResponse);
 }
 
 // ============ Init Messages ============
@@ -274,6 +306,9 @@ message InitResponse {
 
   // The updated manifest
   Manifest manifest = 7;
+
+  // Organization inference result from git remote
+  OrgInferenceResult org_inference = 8;
 }
 
 message GetReconciliationPlanRequest {
@@ -368,7 +403,6 @@ message Issue {
   string title = 4;
   string description = 5;
   IssueMetadata metadata = 6;
-  bool has_plan = 7;              // Whether issue has a plan.md file
 }
 
 message IssueMetadata {
@@ -429,6 +463,32 @@ message ListIssuesResponse {
   int32 total_count = 2;
 }
 
+// Advanced search request
+message AdvancedSearchRequest {
+  string query = 1;              // Query string (e.g., "status:open AND priority:1")
+  string sort_by = 2;            // Field to sort by (e.g., "createdAt", "priority")
+  bool sort_descending = 3;      // Sort order (true = descending)
+  bool multi_project = 4;        // Search across all tracked projects
+  string project_path = 5;       // Project path (required if multi_project is false)
+}
+
+// Search result containing issue and project info
+message SearchResultIssue {
+  Issue issue = 1;
+  string project_path = 2;
+  string project_name = 3;
+  string display_path = 4;
+}
+
+// Advanced search response
+message AdvancedSearchResponse {
+  bool success = 1;
+  string error = 2;
+  repeated SearchResultIssue results = 3;
+  int32 total_count = 4;
+  string parsed_query = 5;       // Debug: the parsed query representation
+}
+
 message UpdateIssueRequest {
   string project_path = 1;
   string issue_id = 2;            // UUID or legacy issue number
@@ -779,42 +839,6 @@ message ListSharedAssetsRequest {
   string project_path = 1;
 }
 
-// ============ Plan Messages ============
-
-message GetPlanRequest {
-  string project_path = 1;
-  string issue_id = 2;            // Issue ID or display number
-}
-
-message GetPlanResponse {
-  bool exists = 1;                // Whether plan.md exists
-  string content = 2;             // Plan content (empty if not exists)
-  string updated_at = 3;          // ISO timestamp of last modification (empty if not exists)
-}
-
-message UpdatePlanRequest {
-  string project_path = 1;
-  string issue_id = 2;            // Issue ID or display number
-  string content = 3;             // New plan content
-}
-
-message UpdatePlanResponse {
-  bool success = 1;
-  string error = 2;
-  Manifest manifest = 3;
-}
-
-message DeletePlanRequest {
-  string project_path = 1;
-  string issue_id = 2;            // Issue ID or display number
-}
-
-message DeletePlanResponse {
-  bool success = 1;
-  string error = 2;
-  Manifest manifest = 3;
-}
-
 // ============ Project Registry Messages ============
 
 // Returned by API (enriched with live data from disk)
@@ -831,6 +855,8 @@ message ProjectInfo {
   string display_path = 10;       // Human-readable path with ~/ for home dir (use for display only)
   string organization_slug = 11;  // Organization slug (empty if ungrouped)
   string organization_name = 12;  // Organization display name (for convenience)
+  string user_title = 13;         // User-scope custom title (from ~/.centy/projects.json)
+  string project_title = 14;      // Project-scope custom title (from .centy/project.json)
 }
 
 message ListProjectsRequest {
@@ -839,6 +865,7 @@ message ListProjectsRequest {
   bool include_archived = 3;      // Include archived projects (default: false)
   string organization_slug = 4;   // Filter by organization (empty = all)
   bool ungrouped_only = 5;        // Only show projects without organization
+  bool include_temp = 6;          // Include projects in system temp directory (default: false)
 }
 
 message ListProjectsResponse {
@@ -854,6 +881,7 @@ message RegisterProjectResponse {
   bool success = 1;
   string error = 2;
   ProjectInfo project = 3;        // The registered project info
+  OrgInferenceResult org_inference = 4;  // Organization inference result from git remote
 }
 
 message UntrackProjectRequest {
@@ -907,6 +935,28 @@ message SetProjectOrganizationResponse {
   ProjectInfo project = 3;        // The updated project info
 }
 
+message SetProjectUserTitleRequest {
+  string project_path = 1;
+  string title = 2;               // Custom title (empty to clear)
+}
+
+message SetProjectUserTitleResponse {
+  bool success = 1;
+  string error = 2;
+  ProjectInfo project = 3;        // The updated project info
+}
+
+message SetProjectTitleRequest {
+  string project_path = 1;
+  string title = 2;               // Custom title (empty to clear)
+}
+
+message SetProjectTitleResponse {
+  bool success = 1;
+  string error = 2;
+  ProjectInfo project = 3;        // The updated project info
+}
+
 // ============ Organization Messages ============
 
 message Organization {
@@ -918,6 +968,16 @@ message Organization {
   uint32 project_count = 6;       // Number of projects in this org
 }
 
+// Organization inference result from git remote
+message OrgInferenceResult {
+  string inferred_org_slug = 1;   // The inferred slug (empty if not found)
+  string inferred_org_name = 2;   // The inferred display name
+  bool org_created = 3;           // Whether a new org was created
+  string existing_org_slug = 4;   // Existing org if already assigned
+  bool has_mismatch = 5;          // True if inferred != existing
+  string message = 6;             // Human-readable status message
+}
+
 message CreateOrganizationRequest {
   string slug = 1;                // Unique slug (auto-generated from name if empty)
   string name = 2;                // Display name (required)
@@ -1358,6 +1418,73 @@ message UpdateLocalLlmConfigResponse {
   LocalLlmConfig config = 3;
 }
 
+// ============ Temp Workspace Messages ============
+
+// Request to open a project in a temporary VS Code workspace
+message OpenInTempVscodeRequest {
+  string project_path = 1;              // Source project path
+  string issue_id = 2;                  // Issue UUID or display number
+  LlmAction action = 3;                 // Plan or Implement
+  string agent_name = 4;                // Agent to use (empty = default)
+  uint32 ttl_hours = 5;                 // Custom TTL in hours (0 = use default 12h)
+}
+
+message OpenInTempVscodeResponse {
+  bool success = 1;
+  string error = 2;
+  string workspace_path = 3;            // Path to the temp workspace
+  string issue_id = 4;                  // Resolved issue UUID
+  uint32 display_number = 5;            // Issue display number
+  string expires_at = 6;                // ISO timestamp when workspace expires
+  bool vscode_opened = 7;               // Whether VS Code was successfully opened
+}
+
+// A temporary workspace entry
+message TempWorkspace {
+  string workspace_path = 1;            // Absolute path to temp workspace
+  string source_project_path = 2;       // Original project path
+  string issue_id = 3;                  // Issue UUID
+  uint32 issue_display_number = 4;      // Issue display number
+  string issue_title = 5;               // Issue title
+  string agent_name = 6;                // Agent being used
+  LlmAction action = 7;                 // Plan or Implement
+  string created_at = 8;                // ISO timestamp
+  string expires_at = 9;                // ISO timestamp when workspace expires
+}
+
+message ListTempWorkspacesRequest {
+  bool include_expired = 1;             // Include expired workspaces (default: false)
+  string source_project_path = 2;       // Filter by source project (empty = all)
+}
+
+message ListTempWorkspacesResponse {
+  repeated TempWorkspace workspaces = 1;
+  uint32 total_count = 2;
+  uint32 expired_count = 3;             // Number of expired workspaces (not included unless include_expired)
+}
+
+message CloseTempWorkspaceRequest {
+  string workspace_path = 1;            // Path to the workspace to close
+  bool force = 2;                       // Force removal even if VS Code may be open
+}
+
+message CloseTempWorkspaceResponse {
+  bool success = 1;
+  string error = 2;
+  bool worktree_removed = 3;            // Whether git worktree was removed
+  bool directory_removed = 4;           // Whether directory was removed
+}
+
+message CleanupExpiredWorkspacesRequest {}
+
+message CleanupExpiredWorkspacesResponse {
+  bool success = 1;
+  string error = 2;
+  uint32 cleaned_count = 3;             // Number of workspaces cleaned up
+  repeated string cleaned_paths = 4;    // Paths that were cleaned
+  repeated string failed_paths = 5;     // Paths that failed to clean
+}
+
 // ============ Link Messages ============
 
 // Target entity type for links
@@ -1437,3 +1564,93 @@ message LinkTypeInfo {
 message GetAvailableLinkTypesResponse {
   repeated LinkTypeInfo link_types = 1;
 }
+
+// ============ User Messages ============
+
+// A project user/team member
+message User {
+  string id = 1;                        // Unique identifier (slug format, e.g., "john-doe")
+  string name = 2;                      // Display name
+  string email = 3;                     // Email address (optional)
+  repeated string git_usernames = 4;    // Git usernames (e.g., GitHub handles)
+  string created_at = 5;                // ISO timestamp
+  string updated_at = 6;                // ISO timestamp
+}
+
+message CreateUserRequest {
+  string project_path = 1;
+  string id = 2;                        // User ID (slug format)
+  string name = 3;                      // Display name (required)
+  string email = 4;                     // Email address (optional)
+  repeated string git_usernames = 5;    // Git usernames (optional)
+}
+
+message CreateUserResponse {
+  bool success = 1;
+  string error = 2;
+  User user = 3;                        // The created user
+  Manifest manifest = 4;
+}
+
+message GetUserRequest {
+  string project_path = 1;
+  string user_id = 2;                   // User ID (slug format)
+}
+
+message ListUsersRequest {
+  string project_path = 1;
+  string git_username = 2;              // Optional: filter by git username
+}
+
+message ListUsersResponse {
+  repeated User users = 1;
+  int32 total_count = 2;
+}
+
+message UpdateUserRequest {
+  string project_path = 1;
+  string user_id = 2;                   // User ID (slug format)
+  string name = 3;                      // Empty = don't update
+  string email = 4;                     // Empty = don't update
+  repeated string git_usernames = 5;    // Empty array = don't update
+}
+
+message UpdateUserResponse {
+  bool success = 1;
+  string error = 2;
+  User user = 3;                        // The updated user
+  Manifest manifest = 4;
+}
+
+message DeleteUserRequest {
+  string project_path = 1;
+  string user_id = 2;                   // User ID (slug format)
+}
+
+message DeleteUserResponse {
+  bool success = 1;
+  string error = 2;
+  Manifest manifest = 3;
+}
+
+// Git contributor found in history
+message GitContributor {
+  string name = 1;
+  string email = 2;
+}
+
+message SyncUsersRequest {
+  string project_path = 1;
+  bool dry_run = 2;                     // If true, don't create users, just show what would be created
+}
+
+message SyncUsersResponse {
+  bool success = 1;
+  string error = 2;
+  repeated string created = 3;          // User IDs that were created
+  repeated string skipped = 4;          // Emails that were skipped (already exist)
+  repeated string errors = 5;           // Errors during creation
+  repeated GitContributor would_create = 6;  // For dry run: users that would be created
+  repeated GitContributor would_skip = 7;    // For dry run: users that would be skipped
+  Manifest manifest = 8;
+}