centy 0.8.0 → 0.8.2

package/proto/centy/v1/generic_item.proto

@@ -2,6 +2,15 @@ syntax = "proto3";
 
 package centy.v1;
 
+// Manifest is defined here so it can be shared by both generic_item.proto and centy.proto
+message Manifest {
+  int32 schema_version = 1;
+  string centy_version = 2;
+  string created_at = 3;
+  reserved 4;
+  reserved "updated_at";
+}
+
 // ============ Generic Item Messages ============
 
 // A generic item that can represent any item type (issues, docs, custom types)
@@ -21,6 +30,8 @@ message GenericItemMetadata {
   string updated_at = 5;                // ISO timestamp
   string deleted_at = 6;                // ISO timestamp when soft-deleted (empty if not deleted)
   map<string, string> custom_fields = 7; // Custom fields (values are JSON strings)
+  repeated string tags = 8;             // Free-form tags (e.g. ["bug", "frontend"])
+  repeated string projects = 9;         // Project slugs this item is associated with (org-wide items only)
 }
 
 message CreateItemRequest {
@@ -31,6 +42,8 @@ message CreateItemRequest {
   string status = 5;                    // Initial status (empty = use default)
   int32 priority = 6;                   // 0 = use default
   map<string, string> custom_fields = 7; // Custom fields (values are JSON strings)
+  repeated string tags = 8;             // Tags to set on create (empty = no tags)
+  repeated string projects = 9;         // Associated project slugs; len > 1 → written to the org repo
 }
 
 message CreateItemResponse {
@@ -55,11 +68,10 @@ message GetItemResponse {
 message ListItemsRequest {
   string project_path = 1;
   string item_type = 2;
-  string status = 3;                    // Filter by status (empty = all)
-  int32 priority = 4;                   // Filter by priority (0 = all)
-  bool include_deleted = 5;             // Include soft-deleted items (default: false)
   uint32 limit = 6;                     // Limit results (0 = no limit)
   uint32 offset = 7;                    // Offset for pagination (0 = no offset)
+  string filter = 8;                    // JSON-encoded MQL query (e.g. {"status":{"$in":["open","in-progress"]}})
+  optional bool include_organization_items = 9; // Include organization-wide items for this project (default: true)
 }
 
 message ListItemsResponse {
@@ -78,6 +90,8 @@ message UpdateItemRequest {
   string status = 6;                    // Empty = don't update
   int32 priority = 7;                   // 0 = don't update
   map<string, string> custom_fields = 8; // Custom fields to merge (values are JSON strings)
+  repeated string tags = 9;             // Non-empty = replace tags; empty = don't change
+  bool clear_tags = 10;                 // If true, clear all tags (takes precedence over tags field)
 }
 
 message UpdateItemResponse {
@@ -122,17 +136,6 @@ message RestoreItemResponse {
   GenericItem item = 3;                 // The restored item (with deleted_at cleared)
 }
 
-message ListItemTypesRequest {
-  string project_path = 1;
-}
-
-message ListItemTypesResponse {
-  bool success = 1;
-  string error = 2;
-  repeated ItemTypeConfig item_types = 3;
-  int32 total_count = 4;
-}
-
 message DuplicateItemRequest {
   string source_project_path = 1;       // Project containing the original item
   string item_type = 2;                 // e.g., "issues", "docs", or custom type
@@ -147,85 +150,45 @@ message DuplicateItemResponse {
   string error = 2;
   GenericItem item = 3;                 // The new duplicate item
   string original_id = 4;              // ID of the original item
+  Manifest manifest = 5;               // Updated target project manifest
 }
 
-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
-}
+// ============ Cross-Project Search Messages ============
 
-message MoveItemResponse {
-  bool success = 1;
-  string error = 2;
-  GenericItem item = 3;
-  string old_id = 4;
+message SearchItemsRequest {
+  string item_type = 1;                 // Plural type name (e.g., "issues", "docs")
+  string item_id = 2;                   // Item identifier (UUID or slug) to search for across projects
 }
 
-// ============ Item Type Messages ============
-
-// Toggle-able features for an item type
-message ItemTypeFeatures {
-  bool display_number = 1;
-  bool status = 2;
-  bool priority = 3;
-  bool assets = 4;
-  bool org_sync = 5;
-  bool move = 6;
-  bool duplicate = 7;
+// A generic item with its source project metadata
+message ItemWithProject {
+  GenericItem item = 1;
+  string project_path = 2;             // Absolute path to the project where this item 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)
 }
 
-// Features that can be enabled for an item type (legacy enum, kept for CreateItemTypeRequest)
-enum ItemTypeFeature {
-  ITEM_TYPE_FEATURE_UNSPECIFIED = 0;
-  ITEM_TYPE_FEATURE_DISPLAY_NUMBER = 1;
-  ITEM_TYPE_FEATURE_STATUS = 2;
-  ITEM_TYPE_FEATURE_PRIORITY = 3;
-  ITEM_TYPE_FEATURE_ASSETS = 4;
-  ITEM_TYPE_FEATURE_ORG_SYNC = 5;
-  ITEM_TYPE_FEATURE_MOVE = 6;
-  ITEM_TYPE_FEATURE_DUPLICATE = 7;
+message SearchItemsResponse {
+  repeated ItemWithProject items = 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;
 }
 
-// Custom field definition for item types
-message ItemTypeCustomField {
-  string name = 1;                      // Field name
-  string field_type = 2;               // "string", "number", "boolean", "enum"
-  bool required = 3;                    // Whether field is required
-  string default_value = 4;            // Default value
-  repeated string enum_values = 5;     // For enum type
+// ============ Cross-Project List Messages ============
+
+message ListItemsAcrossProjectsRequest {
+  string item_type = 1;                 // Plural type name (e.g., "issues", "docs")
+  uint32 limit = 2;                     // Limit results (0 = no limit)
+  uint32 offset = 3;                    // Offset for pagination (0 = no offset)
+  string filter = 4;                    // JSON-encoded MQL query (same as ListItemsRequest)
 }
 
-// Request to create a new item type
-message CreateItemTypeRequest {
-  string project_path = 1;
-  string name = 2;                      // Singular display name (e.g., "Bug", "Task")
-  string plural = 3;                    // Folder/type key, lowercase alphanumeric + hyphens (e.g., "bugs")
-  string identifier = 4;               // "uuid" or "slug"
-  ItemTypeFeatures features = 5;         // Enabled 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 ItemTypeCustomField custom_fields = 9; // Custom field definitions
-}
-
-// Response from creating an item type
-message CreateItemTypeResponse {
-  bool success = 1;
-  string error = 2;
-  ItemTypeConfig item_type = 3;         // The created item type configuration
-}
-
-// Configuration for an item type (stored in .centy/config.yaml)
-message ItemTypeConfig {
-  string name = 1;                      // Singular display name
-  string plural = 2;                    // Folder/type key
-  string identifier = 3;               // "uuid" or "slug"
-  ItemTypeFeatures features = 4;        // Enabled features
-  repeated string statuses = 5;         // Allowed statuses
-  string default_status = 6;           // Default status
-  uint32 priority_levels = 7;          // Number of priority levels
-  repeated ItemTypeCustomField custom_fields = 8; // Custom field definitions
+message ListItemsAcrossProjectsResponse {
+  repeated ItemWithProject items = 1;
+  int32 total_count = 2;               // Total count across all projects (before limit/offset)
+  repeated string errors = 3;          // Non-fatal errors (e.g., projects that couldn't be accessed)
+  bool success = 4;
+  string error = 5;
 }

package/proto/cspell.json

@@ -0,0 +1,5 @@
+{
+  "version": "0.2",
+  "words": ["centy", "worktree", "unpushed"],
+  "ignorePaths": ["node_modules", "pnpm-lock.yaml"]
+}

package/proto/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@centy-io/proto",
+  "private": true,
+  "scripts": {
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "cspell": "^9.0.0",
+    "husky": "^9.0.0"
+  }
+}