feat(req-002): implement portfolio tagging and tag filters

app/repositories/portfolio_repository.py

@@ -5,7 +5,7 @@ from __future__ import annotations
 from datetime import datetime
 from typing import Protocol
 
-from app.domain.models import AuthToken, BotPrincipal, LedgerEntry, Portfolio, PortfolioComment, StrategySet, TokenPrincipal, User
+from app.domain.models import AuthToken, BotPrincipal, LedgerEntry, Portfolio, PortfolioComment, PortfolioTag, StrategySet, TokenPrincipal, User
 
 
 class PortfolioRepository(Protocol):
@@ -126,8 +126,17 @@ class PortfolioRepository(Protocol):
         broker: str | None = None,
         status: str | None = None,
         owner_user_id: str | None = None,
+        include_tags: list[str] | None = None,
+        exclude_tags: list[str] | None = None,
+        match_mode: str | None = None,
     ) -> list[Portfolio]: ...
 
+    def add_tag(self, portfolio_id: str, *, tag: str) -> PortfolioTag: ...
+
+    def list_tags(self, portfolio_id: str) -> list[PortfolioTag]: ...
+
+    def remove_tag(self, portfolio_id: str, *, tag: str) -> None: ...
+
     def get_or_create_strategy_set(self, name: str, config: str) -> StrategySet: ...
 
     def get_strategy_set(self, id: str) -> StrategySet | None: ...