Add recordable trash, archive, and restore subcommands

internal/commands/cards.go

@@ -42,6 +42,9 @@ func NewCardsCmd() *cobra.Command {
 		newCardsColumnCmd(&project, &cardTable),
 		newCardsStepsCmd(&project),
 		newCardsStepCmd(&project),
+		newRecordableTrashCmd("card"),
+		newRecordableArchiveCmd("card"),
+		newRecordableRestoreCmd("card"),
 	)
 
 	return cmd

internal/commands/commands.go

@@ -34,13 +34,13 @@ func CommandCategories() []CommandCategory {
 			Name: "Core Commands",
 			Commands: []CommandInfo{
 				{Name: "projects", Category: "core", Description: "Manage projects", Actions: []string{"list", "show", "create", "update", "delete"}},
-				{Name: "todos", Category: "core", Description: "Manage to-dos", Actions: []string{"list", "show", "create", "complete", "uncomplete", "position"}},
-				{Name: "todolists", Category: "core", Description: "Manage to-do lists", Actions: []string{"list", "show", "create", "update"}},
+				{Name: "todos", Category: "core", Description: "Manage to-dos", Actions: []string{"list", "show", "create", "complete", "uncomplete", "position", "trash", "archive", "restore"}},
+				{Name: "todolists", Category: "core", Description: "Manage to-do lists", Actions: []string{"list", "show", "create", "update", "trash", "archive", "restore"}},
 				{Name: "todosets", Category: "core", Description: "View to-do set containers", Actions: []string{"show"}},
 				{Name: "todolistgroups", Category: "core", Description: "Manage to-do list groups", Actions: []string{"list", "show", "create", "update", "position"}},
-				{Name: "messages", Category: "core", Description: "Manage messages", Actions: []string{"list", "show", "create", "update", "pin", "unpin"}},
+				{Name: "messages", Category: "core", Description: "Manage messages", Actions: []string{"list", "show", "create", "update", "pin", "unpin", "trash", "archive", "restore"}},
 				{Name: "campfire", Category: "core", Description: "Chat in Campfire rooms", Actions: []string{"list", "messages", "post", "line", "delete"}},
-				{Name: "cards", Category: "core", Description: "Manage Kanban cards", Actions: []string{"list", "show", "create", "update", "move", "columns", "steps"}},
+				{Name: "cards", Category: "core", Description: "Manage Kanban cards", Actions: []string{"list", "show", "create", "update", "move", "columns", "steps", "trash", "archive", "restore"}},
 			},
 		},
 		{
@@ -60,10 +60,10 @@ func CommandCategories() []CommandCategory {
 		{
 			Name: "Files & Docs",
 			Commands: []CommandInfo{
-				{Name: "files", Category: "files", Description: "Manage files, documents, and folders", Actions: []string{"list", "show", "create", "update"}},
-				{Name: "uploads", Category: "files", Description: "List and manage uploads", Actions: []string{"list", "show"}},
-				{Name: "vaults", Category: "files", Description: "Manage folders (vaults)", Actions: []string{"list", "show", "create"}},
-				{Name: "docs", Category: "files", Description: "Manage documents", Actions: []string{"list", "show", "create", "update"}},
+				{Name: "files", Category: "files", Description: "Manage files, documents, and folders", Actions: []string{"list", "show", "download", "update", "trash", "archive", "restore"}},
+				{Name: "uploads", Category: "files", Description: "List and manage uploads", Actions: []string{"list", "show", "download", "update", "trash", "archive", "restore"}},
+				{Name: "vaults", Category: "files", Description: "Manage folders (vaults)", Actions: []string{"list", "show", "download", "update", "trash", "archive", "restore"}},
+				{Name: "docs", Category: "files", Description: "Manage documents", Actions: []string{"list", "show", "download", "update", "trash", "archive", "restore"}},
 			},
 		},
 		{
@@ -92,7 +92,7 @@ func CommandCategories() []CommandCategory {
 				{Name: "messagetypes", Category: "communication", Description: "Manage message categories", Actions: []string{"list", "show", "create", "update", "delete"}},
 				{Name: "forwards", Category: "communication", Description: "Manage email forwards (inbox)", Actions: []string{"list", "show", "inbox", "replies", "reply"}},
 				{Name: "subscriptions", Category: "communication", Description: "Manage notification subscriptions", Actions: []string{"show", "subscribe", "unsubscribe", "add", "remove"}},
-				{Name: "comments", Category: "communication", Description: "Manage comments", Actions: []string{"create", "list", "show", "update"}},
+				{Name: "comments", Category: "communication", Description: "Manage comments", Actions: []string{"create", "list", "show", "update", "trash", "archive", "restore"}},
 				{Name: "boost", Category: "communication", Description: "Manage boosts (reactions)", Actions: []string{"list", "show", "create", "delete"}},
 			},
 		},

internal/commands/comment.go

@@ -31,6 +31,9 @@ func NewCommentsCmd() *cobra.Command {
 		newCommentsShowCmd(),
 		newCommentsCreateCmd(),
 		newCommentsUpdateCmd(),
+		newRecordableTrashCmd("comment"),
+		newRecordableArchiveCmd("comment"),
+		newRecordableRestoreCmd("comment"),
 	)
 
 	return cmd

internal/commands/files.go

@@ -43,6 +43,9 @@ Each project has a root folder containing documents, uploads, and subfolders.`,
 		newFilesShowCmd(&project),
 		newFilesUpdateCmd(&project),
 		newFilesDownloadCmd(&project),
+		newRecordableTrashCmd("file"),
+		newRecordableArchiveCmd("file"),
+		newRecordableRestoreCmd("file"),
 	)
 
 	return cmd

internal/commands/messages.go

@@ -39,6 +39,9 @@ func NewMessagesCmd() *cobra.Command {
 		newMessagesUpdateCmd(),
 		newMessagesPinCmd(),
 		newMessagesUnpinCmd(),
+		newRecordableTrashCmd("message"),
+		newRecordableArchiveCmd("message"),
+		newRecordableRestoreCmd("message"),
 	)
 
 	return cmd

internal/commands/recordings.go

@@ -448,6 +448,57 @@ You can pass either an ID or a Basecamp URL:
 	return cmd
 }
 
+// newRecordableTrashCmd creates a trash subcommand for a recordable entity.
+func newRecordableTrashCmd(noun string) *cobra.Command {
+	return &cobra.Command{
+		Use:   "trash <id|url>",
+		Short: fmt.Sprintf("Move a %s to trash", noun),
+		Long: fmt.Sprintf(`Move a %s to the trash.
+
+You can pass either an ID or a Basecamp URL:
+  basecamp %ss trash 789`, noun, noun),
+		Args: cobra.ExactArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			app := appctx.FromContext(cmd.Context())
+			return runRecordingsStatus(cmd, app, args[0], "trashed")
+		},
+	}
+}
+
+// newRecordableArchiveCmd creates an archive subcommand for a recordable entity.
+func newRecordableArchiveCmd(noun string) *cobra.Command {
+	return &cobra.Command{
+		Use:   "archive <id|url>",
+		Short: fmt.Sprintf("Archive a %s", noun),
+		Long: fmt.Sprintf(`Archive a %s to remove it from active view.
+
+You can pass either an ID or a Basecamp URL:
+  basecamp %ss archive 789`, noun, noun),
+		Args: cobra.ExactArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			app := appctx.FromContext(cmd.Context())
+			return runRecordingsStatus(cmd, app, args[0], "archived")
+		},
+	}
+}
+
+// newRecordableRestoreCmd creates a restore subcommand for a recordable entity.
+func newRecordableRestoreCmd(noun string) *cobra.Command {
+	return &cobra.Command{
+		Use:   "restore <id|url>",
+		Short: fmt.Sprintf("Restore a %s", noun),
+		Long: fmt.Sprintf(`Restore a %s from trash or archive to active status.
+
+You can pass either an ID or a Basecamp URL:
+  basecamp %ss restore 789`, noun, noun),
+		Args: cobra.ExactArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			app := appctx.FromContext(cmd.Context())
+			return runRecordingsStatus(cmd, app, args[0], "active")
+		},
+	}
+}
+
 // recordingDisplayName maps SDK recording type names to human-friendly display names.
 func recordingDisplayName(sdkType string) string {
 	switch sdkType {

internal/commands/todolists.go

@@ -36,6 +36,9 @@ to disambiguate when needed.`,
 		newTodolistsShowCmd(&project),
 		newTodolistsCreateCmd(&project, &todosetID),
 		newTodolistsUpdateCmd(&project),
+		newRecordableTrashCmd("todolist"),
+		newRecordableArchiveCmd("todolist"),
+		newRecordableRestoreCmd("todolist"),
 	)
 
 	return cmd

internal/commands/todos.go

@@ -46,6 +46,9 @@ func NewTodosCmd() *cobra.Command {
 		newTodosUncompleteCmd(),
 		newTodosSweepCmd(),
 		newTodosPositionCmd(),
+		newRecordableTrashCmd("todo"),
+		newRecordableArchiveCmd("todo"),
+		newRecordableRestoreCmd("todo"),
 	)
 
 	return cmd