centy 0.8.0 → 0.8.2

package/proto/centy/v1/centy.proto

@@ -9,51 +9,6 @@ service CentyDaemon {
   // Initialize a .centy folder in the specified directory
   rpc Init(InitRequest) returns (InitResponse);
 
-  // Get reconciliation plan without executing it
-  rpc GetReconciliationPlan(GetReconciliationPlanRequest) returns (ReconciliationPlan);
-
-  // 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 +21,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
@@ -185,21 +108,6 @@ service CentyDaemon {
   // Open a standalone workspace with a configurable editor (not tied to an issue)
   rpc OpenStandaloneWorkspace(OpenStandaloneWorkspaceWithEditorRequest) returns (OpenStandaloneWorkspaceResponse);
 
-  // Open a project in a temporary VS Code workspace (deprecated: use OpenInTempWorkspace)
-  rpc OpenInTempVscode(OpenInTempWorkspaceRequest) returns (OpenInTempWorkspaceResponse);
-
-  // 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);
-
-  // Open a standalone workspace in terminal (deprecated: use OpenStandaloneWorkspace)
-  rpc OpenStandaloneWorkspaceTerminal(OpenStandaloneWorkspaceRequest) returns (OpenStandaloneWorkspaceResponse);
-
   // List all temp workspaces
   rpc ListTempWorkspaces(ListTempWorkspacesRequest) returns (ListTempWorkspacesResponse);
 
@@ -274,6 +182,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 +219,17 @@ 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);
+
+  // List items of a given type across all tracked projects, sorted by created_at descending
+  rpc ListItemsAcrossProjects(ListItemsAcrossProjectsRequest) returns (ListItemsAcrossProjectsResponse);
 }
 
 // ============ Init Messages ============
@@ -321,6 +243,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 {
@@ -340,38 +271,6 @@ message InitResponse {
   OrgInferenceResult org_inference = 8;
 }
 
-message GetReconciliationPlanRequest {
-  string project_path = 1;
-}
-
-message ReconciliationPlan {
-  // Files that need to be created (not on disk, not in manifest)
-  repeated FileInfo to_create = 1;
-
-  // Files that were deleted but exist in manifest (can be restored)
-  repeated FileInfo to_restore = 2;
-
-  // Files that were modified from original (hash mismatch)
-  repeated FileInfo to_reset = 3;
-
-  // Files that are up to date
-  repeated FileInfo up_to_date = 4;
-
-  // User-created files (not managed by centy)
-  repeated FileInfo user_files = 5;
-
-  // Whether user decisions are needed
-  bool needs_decisions = 6;
-
-  bool success = 7;
-  string error = 8;
-}
-
-message ExecuteReconciliationRequest {
-  string project_path = 1;
-  ReconciliationDecisions decisions = 2;
-}
-
 message ReconciliationDecisions {
   // Paths of files to restore (from to_restore list)
   repeated string restore = 1;
@@ -380,261 +279,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 +292,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 +324,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")
@@ -693,8 +332,9 @@ message Config {
   reserved 9;  // Previously: LlmConfig llm (removed)
   repeated LinkTypeDefinition custom_link_types = 10;  // Custom link types (in addition to built-in)
   string default_editor = 11;                // Default editor ID for this project (e.g., "vscode", "terminal", "zed")
-  repeated HookDefinition hooks = 12;                  // Lifecycle hooks
+  reserved 12;  // Previously: repeated HookDefinition hooks (moved to hooks.yaml)
   WorkspaceConfig workspace = 13;            // Workspace settings
+  map<string, string> user_values = 14;      // User-defined free-form key-value pairs
 }
 
 // Workspace configuration section
@@ -710,19 +350,10 @@ message CustomFieldDefinition {
   repeated string enum_values = 5;  // For enum type
 }
 
-// Lifecycle hook definition (bash scripts to run before/after operations)
-message HookDefinition {
-  string pattern = 1;                   // Pattern like "pre:issue:create" or "*:*:delete"
-  string command = 2;                   // Bash command to execute
-  bool run_async = 3;                   // If true, run in background (post-hooks only)
-  uint64 timeout = 4;                   // Timeout in seconds (default: 30)
-  bool enabled = 5;                     // Whether hook is enabled (default: true)
-}
-
 // 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")
+  reserved 2;                         // Removed: inverse (no longer needed — direction field on Link replaces it)
   string description = 3;             // Optional description
 }
 
@@ -748,184 +379,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 +471,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 +645,7 @@ message UpdateOrganizationResponse {
 
 message DeleteOrganizationRequest {
   string slug = 1;
+  bool cascade = 2;
 }
 
 message DeleteOrganizationResponse {
@@ -1206,7 +662,7 @@ message DaemonInfo {
   string version = 1;                    // Current daemon version (e.g., "0.1.0")
   reserved 2;                            // was: repeated string available_versions (removed)
   string binary_path = 3;                // Absolute path to the running daemon binary
-  bool vscode_available = 4;             // Whether VS Code is installed and accessible
+  reserved 4;                            // was: vscode_available (removed)
 }
 
 // ============ Daemon Control Messages ============
@@ -1233,34 +689,11 @@ 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;
-  EDITOR_TYPE_VSCODE = 1;             // VS Code editor
-  EDITOR_TYPE_TERMINAL = 2;           // OS terminal
-}
-
 // Request to get supported editors (empty request)
 message GetSupportedEditorsRequest {}
 
 // Information about a supported editor
 message EditorInfo {
-  EditorType editor_type = 1;         // Editor type enum value (deprecated: use editor_id)
   string name = 2;                    // Display name (e.g., "VS Code", "Terminal")
   string description = 3;             // Brief description
   bool available = 4;                 // Whether this editor is available on the current system
@@ -1277,8 +710,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 +721,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 +729,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 +747,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 +776,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)
@@ -1413,47 +822,40 @@ message CleanupExpiredWorkspacesResponse {
 
 // ============ Link Messages ============
 
-// Target entity type for links
-enum LinkTargetType {
-  LINK_TARGET_TYPE_UNSPECIFIED = 0;
-  LINK_TARGET_TYPE_ISSUE = 1;
-  LINK_TARGET_TYPE_DOC = 2;
-  reserved 3;                         // Removed: LINK_TARGET_TYPE_PR
-}
-
 // A link between two entities
 message Link {
   string target_id = 1;               // Target entity ID (UUID for issues, slug for docs)
-  LinkTargetType target_type = 2;     // Type of the target entity
-  string link_type = 3;               // Relationship type (e.g., "blocks", "parent-of")
+  reserved 2;                         // Removed: LinkTargetType target_type (legacy enum)
+  string link_type = 3;               // Relationship type (e.g., "blocks", "parent-of"); always from source's perspective
   string created_at = 4;              // ISO timestamp when link was created
+  string target_item_type = 5;        // Singular item type as a string (e.g., "issue", "plan")
+  string id = 6;                      // UUID of the link file (use for deletion)
+  string direction = 7;               // "source" or "target" — which side the queried entity is on
 }
 
-// Create a link between two entities (bidirectional - also creates inverse)
+// Create a link between two entities (one file, two response views)
 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 source_id = 2;               // Source entity ID (UUID or display number)
+  reserved 3;                         // Removed: LinkTargetType source_type (legacy enum)
+  string target_id = 4;               // Target entity ID (UUID or display number)
+  reserved 5;                         // Removed: LinkTargetType target_type (legacy enum)
   string link_type = 6;               // Link type (e.g., "blocks")
+  string source_item_type = 7;        // Singular item type as a string (e.g., "issue", "plan")
+  string target_item_type = 8;        // Singular item type as a string (e.g., "issue", "plan")
 }
 
 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
+  Link created_link = 3;              // Source's view (direction="source")
+  Link inverse_link = 4;              // Target's view (direction="target")
 }
 
-// Delete a link between two entities (also deletes inverse)
+// Delete a link by its UUID
 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)
+  string link_id = 2;                 // UUID of the link file to delete (from Link.id)
 }
 
 message DeleteLinkResponse {
@@ -1466,7 +868,8 @@ message DeleteLinkResponse {
 message ListLinksRequest {
   string project_path = 1;
   string entity_id = 2;               // Entity ID to list links for
-  LinkTargetType entity_type = 3;     // Entity type
+  reserved 3;                         // Removed: LinkTargetType entity_type (legacy enum)
+  string entity_item_type = 4;        // Singular item type as a string (e.g., "issue", "plan")
 }
 
 message ListLinksResponse {
@@ -1484,7 +887,7 @@ message GetAvailableLinkTypesRequest {
 // 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")
+  reserved 2;                         // Removed: inverse (no longer needed — use direction on Link instead)
   string description = 3;             // Optional description
   bool is_builtin = 4;                // Whether this is a built-in type
 }
@@ -1622,14 +1025,6 @@ message SyncUsersResponse {
 
 // ============ Entity Actions Messages ============
 
-// Entity type for actions
-enum EntityType {
-  ENTITY_TYPE_UNSPECIFIED = 0;
-  ENTITY_TYPE_ISSUE = 1;
-  reserved 2;                         // Removed: ENTITY_TYPE_PR
-  ENTITY_TYPE_DOC = 3;
-}
-
 // Action category for grouping in UI
 enum ActionCategory {
   ACTION_CATEGORY_UNSPECIFIED = 0;
@@ -1653,8 +1048,9 @@ message EntityAction {
 // Request to get available actions for an entity
 message GetEntityActionsRequest {
   string project_path = 1;              // Project path for config/state lookup
-  EntityType entity_type = 2;           // Type of entity (issue, doc)
+  reserved 2;                           // Removed: EntityType entity_type (legacy enum)
   string entity_id = 3;                 // Optional: entity ID for contextual actions (empty = general actions like "create")
+  string item_type = 4;                 // Type of item (e.g., "issues", "docs")
 }
 
 // Response with available actions
@@ -1776,3 +1172,110 @@ 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
+  bool listed = 11;                     // Whether this type appears in ListItemTypes responses
+}
+
+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
+}
+
+