centy 0.7.9 → 0.8.1

package/proto/centy/v1/centy.proto

@@ -15,45 +15,6 @@ service CentyDaemon {
   // Execute reconciliation with user decisions
   rpc ExecuteReconciliation(ExecuteReconciliationRequest) returns (InitResponse);
 
-  // Deprecated: Use CreateItem with item_type="issues" instead.
-  rpc CreateIssue(CreateIssueRequest) returns (CreateIssueResponse);
-
-  // Deprecated: Use GetItem with item_type="issues" instead.
-  rpc GetIssue(GetIssueRequest) returns (GetIssueResponse);
-
-  // Get a single issue by display number (human-readable number like 1, 2, 3)
-  rpc GetIssueByDisplayNumber(GetIssueByDisplayNumberRequest) returns (GetIssueResponse);
-
-  // Get issues by UUID across all tracked projects (global search)
-  rpc GetIssuesByUuid(GetIssuesByUuidRequest) returns (GetIssuesByUuidResponse);
-
-  // Deprecated: Use ListItems with item_type="issues" instead.
-  rpc ListIssues(ListIssuesRequest) returns (ListIssuesResponse);
-
-  // Advanced issue search with query language
-  rpc AdvancedSearch(AdvancedSearchRequest) returns (AdvancedSearchResponse);
-
-  // Deprecated: Use UpdateItem with item_type="issues" instead.
-  rpc UpdateIssue(UpdateIssueRequest) returns (UpdateIssueResponse);
-
-  // Deprecated: Use DeleteItem with item_type="issues" instead.
-  rpc DeleteIssue(DeleteIssueRequest) returns (DeleteIssueResponse);
-
-  // Deprecated: Use SoftDeleteItem with item_type="issues" instead.
-  rpc SoftDeleteIssue(SoftDeleteIssueRequest) returns (SoftDeleteIssueResponse);
-
-  // Deprecated: Use RestoreItem with item_type="issues" instead.
-  rpc RestoreIssue(RestoreIssueRequest) returns (RestoreIssueResponse);
-
-  // Move an issue to another project
-  rpc MoveIssue(MoveIssueRequest) returns (MoveIssueResponse);
-
-  // Duplicate an issue (same project or different project)
-  rpc DuplicateIssue(DuplicateIssueRequest) returns (DuplicateIssueResponse);
-
-  // Get the next issue number
-  rpc GetNextIssueNumber(GetNextIssueNumberRequest) returns (GetNextIssueNumberResponse);
-
   // Read the manifest
   rpc GetManifest(GetManifestRequest) returns (GetManifestResponse);
 
@@ -66,38 +27,6 @@ service CentyDaemon {
   // Check if centy is initialized in a directory
   rpc IsInitialized(IsInitializedRequest) returns (IsInitializedResponse);
 
-  // ============ Doc RPCs ============
-
-  // Deprecated: Use CreateItem with item_type="docs" instead.
-  rpc CreateDoc(CreateDocRequest) returns (CreateDocResponse);
-
-  // Deprecated: Use GetItem with item_type="docs" instead.
-  rpc GetDoc(GetDocRequest) returns (GetDocResponse);
-
-  // Get docs by slug across all tracked projects (global search)
-  rpc GetDocsBySlug(GetDocsBySlugRequest) returns (GetDocsBySlugResponse);
-
-  // Deprecated: Use ListItems with item_type="docs" instead.
-  rpc ListDocs(ListDocsRequest) returns (ListDocsResponse);
-
-  // Deprecated: Use UpdateItem with item_type="docs" instead.
-  rpc UpdateDoc(UpdateDocRequest) returns (UpdateDocResponse);
-
-  // Deprecated: Use DeleteItem with item_type="docs" instead.
-  rpc DeleteDoc(DeleteDocRequest) returns (DeleteDocResponse);
-
-  // Deprecated: Use SoftDeleteItem with item_type="docs" instead.
-  rpc SoftDeleteDoc(SoftDeleteDocRequest) returns (SoftDeleteDocResponse);
-
-  // Deprecated: Use RestoreItem with item_type="docs" instead.
-  rpc RestoreDoc(RestoreDocRequest) returns (RestoreDocResponse);
-
-  // Move a doc to another project
-  rpc MoveDoc(MoveDocRequest) returns (MoveDocResponse);
-
-  // Duplicate a doc (same project or different project)
-  rpc DuplicateDoc(DuplicateDocRequest) returns (DuplicateDocResponse);
-
   // ============ Asset RPCs ============
 
   // Add an asset to an issue or as a shared asset
@@ -161,6 +90,32 @@ service CentyDaemon {
   // Delete an organization
   rpc DeleteOrganization(DeleteOrganizationRequest) returns (DeleteOrganizationResponse);
 
+  // ============ Organization Issue RPCs ============
+
+  // Create an organization-level issue
+  rpc CreateOrgIssue(CreateOrgIssueRequest) returns (CreateOrgIssueResponse);
+
+  // Get an org issue by UUID
+  rpc GetOrgIssue(GetOrgIssueRequest) returns (OrgIssue);
+
+  // Get an org issue by display number
+  rpc GetOrgIssueByDisplayNumber(GetOrgIssueByDisplayNumberRequest) returns (OrgIssue);
+
+  // List org issues with optional filters
+  rpc ListOrgIssues(ListOrgIssuesRequest) returns (ListOrgIssuesResponse);
+
+  // Update an org issue
+  rpc UpdateOrgIssue(UpdateOrgIssueRequest) returns (UpdateOrgIssueResponse);
+
+  // Delete an org issue
+  rpc DeleteOrgIssue(DeleteOrgIssueRequest) returns (DeleteOrgIssueResponse);
+
+  // Get org-level config
+  rpc GetOrgConfig(GetOrgConfigRequest) returns (OrgConfig);
+
+  // Update org-level config
+  rpc UpdateOrgConfig(UpdateOrgConfigRequest) returns (UpdateOrgConfigResponse);
+
   // ============ Version RPCs ============
 
   // Get daemon version info
@@ -191,9 +146,6 @@ service CentyDaemon {
   // Open a project in a temporary terminal workspace (deprecated: use OpenInTempWorkspace)
   rpc OpenInTempTerminal(OpenInTempWorkspaceRequest) returns (OpenInTempWorkspaceResponse);
 
-  // Open an agent in a terminal for working on an issue
-  rpc OpenAgentInTerminal(OpenAgentInTerminalRequest) returns (OpenAgentInTerminalResponse);
-
   // Open a standalone workspace in VS Code (deprecated: use OpenStandaloneWorkspace)
   rpc OpenStandaloneWorkspaceVscode(OpenStandaloneWorkspaceRequest) returns (OpenStandaloneWorkspaceResponse);
 
@@ -274,6 +226,14 @@ service CentyDaemon {
   // Manually trigger a sync push
   rpc SyncPush(SyncPushRequest) returns (SyncPushResponse);
 
+  // ============ Item Type RPCs ============
+
+  // Create a new item type dynamically
+  rpc CreateItemType(CreateItemTypeRequest) returns (CreateItemTypeResponse);
+
+  // List all item types for a project
+  rpc ListItemTypes(ListItemTypesRequest) returns (ListItemTypesResponse);
+
   // ============ Generic Item RPCs ============
 
   // Create a new item of any type
@@ -303,11 +263,14 @@ service CentyDaemon {
   // Move an item to another project
   rpc MoveItem(MoveItemRequest) returns (MoveItemResponse);
 
-  // Create a new custom item type
-  rpc CreateItemType(CreateItemTypeRequest) returns (CreateItemTypeResponse);
+  // Archive an item by moving it to the archived folder and recording its original type
+  rpc ArchiveItem(ArchiveItemRequest) returns (ArchiveItemResponse);
 
-  // List all item types for a project
-  rpc ListItemTypes(ListItemTypesRequest) returns (ListItemTypesResponse);
+  // Unarchive an item by moving it back to its original folder
+  rpc UnarchiveItem(UnarchiveItemRequest) returns (UnarchiveItemResponse);
+
+  // Search for an item by ID across all tracked projects
+  rpc SearchItems(SearchItemsRequest) returns (SearchItemsResponse);
 }
 
 // ============ Init Messages ============
@@ -321,6 +284,15 @@ message InitRequest {
 
   // Decisions for files that need user input (only used when force=false)
   ReconciliationDecisions decisions = 3;
+
+  // Optional configuration to apply during initialization.
+  // Fields set here will be written to .centy/config.json.
+  // Unset/zero-value fields fall back to project defaults.
+  Config init_config = 4;
+
+  // Optional project title to set during initialization (stored in .centy/project.json,
+  // visible to all team members). Empty string means no title is set.
+  string title = 5;
 }
 
 message InitResponse {
@@ -380,261 +352,6 @@ message ReconciliationDecisions {
   repeated string reset = 2;
 }
 
-// ============ Issue Messages ============
-
-message CreateIssueRequest {
-  string project_path = 1;
-  string title = 2;
-  string description = 3;
-  int32 priority = 4;   // 1 = highest priority, 0 = use default
-  string status = 5;    // default: "open"
-  map<string, string> custom_fields = 6;
-  string template = 7;  // Optional template name (without .md extension)
-  bool draft = 8;       // Create as draft (default: false)
-  bool is_org_issue = 9; // Create as organization-wide issue (syncs to all org projects)
-}
-
-message CreateIssueResponse {
-  bool success = 1;
-  string error = 2;
-
-  // The created issue ID (UUID)
-  string id = 3;
-
-  // Human-readable display number (1, 2, 3...)
-  uint32 display_number = 4;
-
-  // Legacy: same as id (for backward compatibility)
-  string issue_number = 5;
-
-  // Paths to created files
-  repeated string created_files = 6;
-
-  // The updated manifest
-  Manifest manifest = 7;
-
-  // Org-level display number (only for org issues, 0 if not an org issue)
-  uint32 org_display_number = 8;
-
-  // Results from syncing to other org projects (org issues only)
-  repeated OrgDocSyncResult sync_results = 9;
-}
-
-message GetNextIssueNumberRequest {
-  string project_path = 1;
-}
-
-message GetNextIssueNumberResponse {
-  string issue_number = 1;
-  bool success = 2;
-  string error = 3;
-}
-
-// Issue represents a full issue with all its data
-message Issue {
-  // UUID-based issue ID (folder name)
-  string id = 1;
-
-  // Human-readable display number (1, 2, 3...)
-  uint32 display_number = 2;
-
-  // Legacy: same as id (for backward compatibility)
-  string issue_number = 3;
-
-  string title = 4;
-  string description = 5;
-  IssueMetadata metadata = 6;
-}
-
-message IssueMetadata {
-  // Human-readable display number (1, 2, 3...)
-  uint32 display_number = 1;
-  string status = 2;              // e.g., "open", "in-progress", "closed"
-  int32 priority = 3;             // 1 = highest priority, N = lowest
-  string created_at = 4;          // ISO timestamp
-  string updated_at = 5;          // ISO timestamp
-  map<string, string> custom_fields = 6;
-  string priority_label = 7;      // Human-readable label (e.g., "high", "P1")
-  reserved 8, 9;                   // Removed: compacted, compacted_at (moved to CLI)
-  bool draft = 10;                // Whether this issue is a draft
-  string deleted_at = 11;         // ISO timestamp when soft-deleted (empty if not deleted)
-  bool is_org_issue = 12;         // Whether this is an organization-level issue
-  string org_slug = 13;           // Organization slug (empty if not org issue)
-  uint32 org_display_number = 14; // Org-scoped display number (0 if not org issue)
-}
-
-message GetIssueRequest {
-  string project_path = 1;
-  string issue_id = 2;            // UUID or legacy issue number (e.g., "0001")
-}
-
-message GetIssueByDisplayNumberRequest {
-  string project_path = 1;
-  uint32 display_number = 2;      // Human-readable number (1, 2, 3...)
-}
-
-// Wrapper response for GetIssue and GetIssueByDisplayNumber RPCs
-message GetIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Issue issue = 3;
-}
-
-// ============ Global Issue Search Messages ============
-
-message GetIssuesByUuidRequest {
-  string uuid = 1;                // The UUID to search for (must be valid UUID format)
-}
-
-// An issue with its source project path
-message IssueWithProject {
-  Issue issue = 1;
-  string project_path = 2;        // Absolute path to the project where this issue was found
-  string project_name = 3;        // Human-readable project name (directory name)
-  string display_path = 4;        // Human-readable path with ~/ for home dir (use for display only)
-}
-
-message GetIssuesByUuidResponse {
-  repeated IssueWithProject issues = 1;
-  int32 total_count = 2;
-  repeated string errors = 3;     // Non-fatal errors (e.g., projects that couldn't be accessed)
-  bool success = 4;
-  string error = 5;
-}
-
-message ListIssuesRequest {
-  string project_path = 1;
-
-  // Optional filters
-  string status = 2;              // Filter by status (empty = all)
-  int32 priority = 3;             // Filter by priority (0 = all)
-  optional bool draft = 4;        // Filter by draft status (absent = all, true = drafts only, false = non-drafts only)
-  bool include_deleted = 5;       // Include soft-deleted issues (default: false)
-}
-
-message ListIssuesResponse {
-  repeated Issue issues = 1;
-  int32 total_count = 2;
-  bool success = 3;
-  string error = 4;
-}
-
-// 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
-
-  // Fields to update (empty string = don't update, 0 = don't update priority)
-  string title = 3;
-  string description = 4;
-  string status = 5;
-  int32 priority = 6;             // 0 = don't update, otherwise 1-N
-  map<string, string> custom_fields = 7;
-  optional bool draft = 8;        // Update draft status (absent = don't update)
-}
-
-message UpdateIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Issue issue = 3;                // The updated issue
-  Manifest manifest = 4;
-  repeated OrgDocSyncResult sync_results = 5;  // Results from syncing to other org projects (org issues only)
-}
-
-message DeleteIssueRequest {
-  string project_path = 1;
-  string issue_id = 2;            // UUID or legacy issue number
-}
-
-message DeleteIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Manifest manifest = 3;          // Updated manifest after deletion
-}
-
-// Soft-delete an issue (set deleted_at timestamp)
-message SoftDeleteIssueRequest {
-  string project_path = 1;
-  string issue_id = 2;            // UUID or legacy issue number
-}
-
-message SoftDeleteIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Issue issue = 3;                // The soft-deleted issue (with deleted_at set)
-  Manifest manifest = 4;          // Updated manifest
-}
-
-// Restore a soft-deleted issue (clear deleted_at timestamp)
-message RestoreIssueRequest {
-  string project_path = 1;
-  string issue_id = 2;            // UUID or legacy issue number
-}
-
-message RestoreIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Issue issue = 3;                // The restored issue (with deleted_at cleared)
-  Manifest manifest = 4;          // Updated manifest
-}
-
-// ============ Issue Move/Duplicate Messages ============
-
-message MoveIssueRequest {
-  string source_project_path = 1;       // Project containing the issue
-  string issue_id = 2;                  // UUID of the issue to move
-  string target_project_path = 3;       // Target project path
-}
-
-message MoveIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Issue issue = 3;                      // The moved issue (same UUID, new display_number)
-  uint32 old_display_number = 4;        // Original display number for reference
-  Manifest source_manifest = 5;         // Updated source project manifest
-  Manifest target_manifest = 6;         // Updated target project manifest
-}
-
-message DuplicateIssueRequest {
-  string source_project_path = 1;       // Project containing the original issue
-  string issue_id = 2;                  // UUID of the issue to duplicate
-  string target_project_path = 3;       // Target project (can be same as source)
-  string new_title = 4;                 // Optional: override title (default: "Copy of {original}")
-}
-
-message DuplicateIssueResponse {
-  bool success = 1;
-  string error = 2;
-  Issue issue = 3;                      // The new duplicate issue (new UUID, new display_number)
-  string original_issue_id = 4;         // UUID of the original issue
-  Manifest manifest = 5;                // Updated target project manifest
-}
-
 // ============ Manifest Messages ============
 
 message GetManifestRequest {
@@ -648,12 +365,7 @@ message GetManifestResponse {
   Manifest manifest = 3;
 }
 
-message Manifest {
-  int32 schema_version = 1;
-  string centy_version = 2;
-  string created_at = 3;
-  string updated_at = 4;
-}
+// Manifest is defined in generic_item.proto (shared across both files)
 
 enum FileType {
   FILE_TYPE_UNSPECIFIED = 0;
@@ -685,7 +397,7 @@ message Config {
   repeated CustomFieldDefinition custom_fields = 1;
   map<string, string> defaults = 2;
   int32 priority_levels = 3;      // Number of priority levels (default: 3)
-  repeated string allowed_states = 4;  // Allowed status values (default: ["open", "in-progress", "closed"])
+  reserved 4;  // Previously: repeated string allowed_states (moved to per-item-type config.yaml)
   reserved 5;  // Previously: string default_state (moved to per-item-type config.yaml)
   string version = 6;                  // Project version (semver, empty = daemon default)
   map<string, string> state_colors = 7;     // State name → hex color (e.g., "open" → "#10b981")
@@ -748,184 +460,6 @@ message IsInitializedResponse {
   string centy_path = 2;  // Full path to .centy folder if initialized
 }
 
-// ============ Doc Messages ============
-
-message CreateDocRequest {
-  string project_path = 1;
-  string title = 2;               // Doc title (used to generate slug)
-  string content = 3;             // Markdown content
-  string slug = 4;                // Optional custom slug (auto-generated from title if empty)
-  string template = 5;            // Optional template name (without .md extension)
-  bool is_org_doc = 6;            // Create as organization-wide doc (syncs to all org projects)
-}
-
-// Result of syncing an org doc to a project
-message OrgDocSyncResult {
-  string project_path = 1;        // Path of target project
-  bool success = 2;               // Whether sync succeeded
-  string error = 3;               // Error message if failed
-}
-
-message CreateDocResponse {
-  bool success = 1;
-  string error = 2;
-  string slug = 3;                // The created doc slug
-  string created_file = 4;        // Path to created file
-  Manifest manifest = 5;
-  repeated OrgDocSyncResult sync_results = 6;  // Results from syncing to other org projects
-}
-
-message GetDocRequest {
-  string project_path = 1;
-  string slug = 2;                // e.g., "getting-started"
-}
-
-// Wrapper response for GetDoc RPC
-message GetDocResponse {
-  bool success = 1;
-  string error = 2;
-  Doc doc = 3;
-}
-
-// ============ 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)
-  string display_path = 4;            // Human-readable path with ~/ for home dir (use for display only)
-}
-
-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)
-  bool success = 4;
-  string error = 5;
-}
-
-message ListDocsRequest {
-  string project_path = 1;
-  bool include_deleted = 2;       // Include soft-deleted docs (default: false)
-}
-
-message ListDocsResponse {
-  repeated Doc docs = 1;
-  int32 total_count = 2;
-  bool success = 3;
-  string error = 4;
-}
-
-// Doc represents a documentation file
-message Doc {
-  string slug = 1;                // e.g., "getting-started"
-  string title = 2;
-  string content = 3;             // Full markdown content
-  DocMetadata metadata = 4;
-}
-
-message DocMetadata {
-  string created_at = 1;          // ISO timestamp
-  string updated_at = 2;          // ISO timestamp
-  string deleted_at = 3;          // ISO timestamp when soft-deleted (empty if not deleted)
-  bool is_org_doc = 4;            // Whether this is an organization-level doc
-  string org_slug = 5;            // Organization slug (for org docs)
-}
-
-message UpdateDocRequest {
-  string project_path = 1;
-  string slug = 2;
-
-  // Fields to update (empty string = don't update)
-  string title = 3;
-  string content = 4;
-  string new_slug = 5;            // Rename the doc (empty = keep current slug)
-}
-
-message UpdateDocResponse {
-  bool success = 1;
-  string error = 2;
-  Doc doc = 3;                    // The updated doc
-  Manifest manifest = 4;
-  repeated OrgDocSyncResult sync_results = 5;  // Results from syncing to other org projects (org docs only)
-}
-
-message DeleteDocRequest {
-  string project_path = 1;
-  string slug = 2;
-}
-
-message DeleteDocResponse {
-  bool success = 1;
-  string error = 2;
-  Manifest manifest = 3;
-}
-
-// Soft-delete a doc (set deleted_at timestamp)
-message SoftDeleteDocRequest {
-  string project_path = 1;
-  string slug = 2;
-}
-
-message SoftDeleteDocResponse {
-  bool success = 1;
-  string error = 2;
-  Doc doc = 3;                    // The soft-deleted doc (with deleted_at set)
-  Manifest manifest = 4;
-}
-
-// Restore a soft-deleted doc (clear deleted_at timestamp)
-message RestoreDocRequest {
-  string project_path = 1;
-  string slug = 2;
-}
-
-message RestoreDocResponse {
-  bool success = 1;
-  string error = 2;
-  Doc doc = 3;                    // The restored doc (with deleted_at cleared)
-  Manifest manifest = 4;
-}
-
-// ============ Doc Move/Duplicate Messages ============
-
-message MoveDocRequest {
-  string source_project_path = 1;       // Project containing the doc
-  string slug = 2;                      // Slug of the doc to move
-  string target_project_path = 3;       // Target project path
-  string new_slug = 4;                  // Optional: new slug if conflict exists
-}
-
-message MoveDocResponse {
-  bool success = 1;
-  string error = 2;
-  Doc doc = 3;                          // The moved doc
-  string old_slug = 4;                  // Original slug for reference
-  Manifest source_manifest = 5;         // Updated source project manifest
-  Manifest target_manifest = 6;         // Updated target project manifest
-}
-
-message DuplicateDocRequest {
-  string source_project_path = 1;       // Project containing the original doc
-  string slug = 2;                      // Slug of the doc to duplicate
-  string target_project_path = 3;       // Target project (can be same as source)
-  string new_slug = 4;                  // Optional: override slug (default: "{slug}-copy")
-  string new_title = 5;                 // Optional: override title (default: "Copy of {original}")
-}
-
-message DuplicateDocResponse {
-  bool success = 1;
-  string error = 2;
-  Doc doc = 3;                          // The new duplicate doc
-  string original_slug = 4;             // Slug of the original doc
-  Manifest manifest = 5;                // Updated target project manifest
-}
-
 // ============ Asset Messages ============
 
 // Asset represents file metadata
@@ -1018,6 +552,8 @@ message ProjectInfo {
   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)
+  string project_version = 15;    // Centy version recorded in manifest (empty if not initialized)
+  bool project_behind = 16;       // True if project version is behind current daemon version
 }
 
 message ListProjectsRequest {
@@ -1190,6 +726,7 @@ message UpdateOrganizationResponse {
 
 message DeleteOrganizationRequest {
   string slug = 1;
+  bool cascade = 2;
 }
 
 message DeleteOrganizationResponse {
@@ -1233,21 +770,6 @@ message RestartResponse {
 
 // ============ Temp Workspace Messages ============
 
-// Action types for workspace operations
-enum LlmAction {
-  LLM_ACTION_UNSPECIFIED = 0;
-  LLM_ACTION_PLAN = 1;
-  LLM_ACTION_IMPLEMENT = 2;
-  LLM_ACTION_DEEPDIVE = 3;
-}
-
-// Workspace mode for agent operations
-enum WorkspaceMode {
-  WORKSPACE_MODE_UNSPECIFIED = 0;       // Use project default or prompt user
-  WORKSPACE_MODE_TEMP = 1;              // Create temporary worktree
-  WORKSPACE_MODE_CURRENT = 2;           // Use current project directory
-}
-
 // Editor type for opening workspaces
 enum EditorType {
   EDITOR_TYPE_UNSPECIFIED = 0;
@@ -1277,8 +799,7 @@ message GetSupportedEditorsResponse {
 message OpenInTempWorkspaceWithEditorRequest {
   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)
+  reserved 3, 4;                        // Removed: action (LlmAction), agent_name
   uint32 ttl_hours = 5;                 // Custom TTL in hours (0 = use default 12h)
   string editor_id = 6;                 // Editor ID (e.g., "vscode", "terminal", "zed"). Empty = use project/user default.
 }
@@ -1289,7 +810,7 @@ message OpenStandaloneWorkspaceWithEditorRequest {
   string name = 2;                      // Optional custom name for the workspace
   string description = 3;               // Optional description/goals for this workspace
   uint32 ttl_hours = 4;                 // Custom TTL in hours (0 = use default 12h)
-  string agent_name = 5;                // Agent to use (empty = default)
+  reserved 5;                           // Removed: agent_name
   string editor_id = 6;                 // Editor ID (e.g., "vscode", "terminal", "zed"). Empty = use project/user default.
 }
 
@@ -1297,8 +818,7 @@ message OpenStandaloneWorkspaceWithEditorRequest {
 message OpenInTempWorkspaceRequest {
   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)
+  reserved 3, 4;                        // Removed: action (LlmAction), agent_name
   uint32 ttl_hours = 5;                 // Custom TTL in hours (0 = use default 12h)
 }
 
@@ -1316,34 +836,13 @@ message OpenInTempWorkspaceResponse {
   string original_created_at = 10;      // Original creation timestamp (only set if workspace_reused is true)
 }
 
-// Request to open an agent in a terminal
-message OpenAgentInTerminalRequest {
-  string project_path = 1;              // Source project path
-  string issue_id = 2;                  // Issue UUID or display number
-  string agent_name = 3;                // Agent to use (empty = default)
-  WorkspaceMode workspace_mode = 4;     // Temp worktree or current project
-  uint32 ttl_hours = 5;                 // Custom TTL in hours (0 = default, only for temp mode)
-}
-
-message OpenAgentInTerminalResponse {
-  bool success = 1;
-  string error = 2;
-  string working_directory = 3;         // Path where agent was launched
-  string issue_id = 4;                  // Resolved issue UUID
-  uint32 display_number = 5;            // Issue display number
-  string agent_command = 6;             // The agent command that was executed
-  bool terminal_opened = 7;             // Whether terminal was successfully opened
-  string expires_at = 8;                // ISO timestamp (only for temp mode)
-  bool requires_status_config = 9;      // True if user must configure update_status_on_start setting
-}
-
 // Request to open a standalone workspace (not tied to an issue)
 message OpenStandaloneWorkspaceRequest {
   string project_path = 1;              // Source project path
   string name = 2;                      // Optional custom name for the workspace
   string description = 3;               // Optional description/goals for this workspace
   uint32 ttl_hours = 4;                 // Custom TTL in hours (0 = use default 12h)
-  string agent_name = 5;                // Agent to use (empty = default)
+  reserved 5;                           // Removed: agent_name
 }
 
 // Response for opening a standalone workspace
@@ -1366,8 +865,7 @@ message TempWorkspace {
   string issue_id = 3;                  // Issue UUID (empty for standalone workspaces)
   uint32 issue_display_number = 4;      // Issue display number (0 for standalone)
   string issue_title = 5;               // Issue title (empty for standalone)
-  string agent_name = 6;                // Agent being used
-  LlmAction action = 7;                 // Plan or Implement
+  reserved 6, 7;                        // Removed: agent_name, action (LlmAction)
   string created_at = 8;                // ISO timestamp
   string expires_at = 9;                // ISO timestamp when workspace expires
   bool is_standalone = 10;              // True if this is a standalone workspace (not tied to an issue)
@@ -1776,3 +1274,218 @@ message SyncPushResponse {
   bool had_changes = 3;                 // Whether any changes were pushed
 }
 
+// ============ Item Type Messages ============
+
+// Toggle-able features for an item type
+message ItemTypeFeatures {
+  bool display_number = 1;              // Enable display numbers (1, 2, 3...)
+  bool status = 2;                      // Enable status tracking
+  bool priority = 3;                    // Enable priority levels
+  bool assets = 4;                      // Enable file attachments
+  bool org_sync = 5;                    // Enable organization sync
+  bool move = 6;                        // Enable moving between projects
+  bool duplicate = 7;                   // Enable duplication
+  bool soft_delete = 8;                 // Enable soft-deletion (restorable delete)
+}
+
+// Request to create a new item type
+message CreateItemTypeRequest {
+  string project_path = 1;
+  string name = 2;                      // Singular display name (e.g., "Bug", "Task", "Epic")
+  string plural = 3;                    // Folder/type key (e.g., "bugs", "tasks", "epics")
+  string identifier = 4;               // "uuid" or "slug"
+  ItemTypeFeatures features = 5;        // Toggle-able features
+  repeated string statuses = 6;         // Allowed statuses (e.g., ["open", "in-progress", "closed"])
+  string default_status = 7;            // Default status for new items (must be in statuses list)
+  uint32 priority_levels = 8;           // Number of priority levels (0 = none)
+  repeated CustomFieldDefinition custom_fields = 9; // Custom field definitions
+}
+
+// Response after creating an item type
+message CreateItemTypeResponse {
+  bool success = 1;
+  string error = 2;
+  ItemTypeConfigProto config = 3;       // The created item type config
+}
+
+// Proto representation of an ItemTypeConfig
+message ItemTypeConfigProto {
+  string name = 1;
+  string plural = 2;
+  string identifier = 3;
+  ItemTypeFeatures features = 4;
+  repeated string statuses = 5;
+  string default_status = 6;
+  uint32 priority_levels = 7;
+  repeated CustomFieldDefinition custom_fields = 8;
+  string icon = 9;                      // Optional icon identifier (e.g. "clipboard")
+  string template = 10;                 // Optional template file path
+}
+
+message ListItemTypesRequest {
+  string project_path = 1;
+}
+
+message ListItemTypesResponse {
+  bool success = 1;
+  string error = 2;
+  repeated ItemTypeConfigProto item_types = 3;
+  int32 total_count = 4;
+}
+
+// ============ Generic Item Move Messages ============
+
+message MoveItemRequest {
+  string source_project_path = 1;
+  string target_project_path = 2;
+  string item_type = 3;
+  string item_id = 4;
+  string new_id = 5;                    // Optional: for slug renames
+}
+
+message MoveItemResponse {
+  bool success = 1;
+  string error = 2;
+  GenericItem item = 3;
+  string old_id = 4;
+  Manifest source_manifest = 5;
+  Manifest target_manifest = 6;
+}
+
+// ============ Archive Messages ============
+
+message ArchiveItemRequest {
+  string project_path = 1;
+  string item_type = 2;   // Source folder name (e.g., "issues", "docs")
+  string item_id = 3;     // UUID of the item to archive
+}
+
+message ArchiveItemResponse {
+  bool success = 1;
+  string error = 2;
+  GenericItem item = 3;   // The archived item with original_item_type set
+}
+
+message UnarchiveItemRequest {
+  string project_path = 1;
+  string item_id = 2;           // UUID of the archived item
+  string target_item_type = 3;  // Optional: override original_item_type from metadata
+}
+
+message UnarchiveItemResponse {
+  bool success = 1;
+  string error = 2;
+  GenericItem item = 3;             // The restored item
+  string original_item_type = 4;    // The folder the item was restored to
+}
+
+// ============ Organization Issue Messages ============
+
+message OrgIssueMetadata {
+  uint32 display_number = 1;
+  string status = 2;
+  int32 priority = 3;
+  string created_at = 4;
+  string updated_at = 5;
+  map<string, string> custom_fields = 6;
+  string priority_label = 7;
+  repeated string referenced_projects = 8;
+}
+
+message OrgIssue {
+  string id = 1;
+  uint32 display_number = 2;
+  string title = 3;
+  string description = 4;
+  OrgIssueMetadata metadata = 5;
+}
+
+message CreateOrgIssueRequest {
+  string organization_slug = 1;
+  string title = 2;
+  string description = 3;
+  int32 priority = 4;
+  string status = 5;
+  map<string, string> custom_fields = 6;
+  repeated string referenced_projects = 7;
+}
+
+message CreateOrgIssueResponse {
+  bool success = 1;
+  string error = 2;
+  string id = 3;
+  uint32 display_number = 4;
+  repeated string created_files = 5;
+}
+
+message GetOrgIssueRequest {
+  string organization_slug = 1;
+  string issue_id = 2;
+}
+
+message GetOrgIssueByDisplayNumberRequest {
+  string organization_slug = 1;
+  uint32 display_number = 2;
+}
+
+message ListOrgIssuesRequest {
+  string organization_slug = 1;
+  string status = 2;           // Filter by status (empty = all)
+  int32 priority = 3;          // Filter by priority (0 = all)
+  string referenced_project = 4; // Filter by referenced project path (empty = all)
+}
+
+message ListOrgIssuesResponse {
+  repeated OrgIssue issues = 1;
+  int32 total_count = 2;
+}
+
+message UpdateOrgIssueRequest {
+  string organization_slug = 1;
+  string issue_id = 2;
+  string title = 3;
+  string description = 4;
+  string status = 5;
+  int32 priority = 6;
+  map<string, string> custom_fields = 7;
+  repeated string add_referenced_projects = 8;
+  repeated string remove_referenced_projects = 9;
+}
+
+message UpdateOrgIssueResponse {
+  bool success = 1;
+  string error = 2;
+  OrgIssue issue = 3;
+}
+
+message DeleteOrgIssueRequest {
+  string organization_slug = 1;
+  string issue_id = 2;
+}
+
+message DeleteOrgIssueResponse {
+  bool success = 1;
+  string error = 2;
+}
+
+message OrgConfig {
+  uint32 priority_levels = 1;
+  repeated CustomFieldDefinition custom_fields = 2;
+}
+
+message GetOrgConfigRequest {
+  string organization_slug = 1;
+}
+
+message UpdateOrgConfigRequest {
+  string organization_slug = 1;
+  uint32 priority_levels = 2;
+  repeated CustomFieldDefinition custom_fields = 3;
+}
+
+message UpdateOrgConfigResponse {
+  bool success = 1;
+  string error = 2;
+  OrgConfig config = 3;
+}
+