xuhdandClaude Opus 4.7
8162719e36
新增两套 persistence 模块，仿 persistence/agents/ 模板：
1. persistence/skills/
- SkillRow ORM (PK=name, owner_user_id, published, timestamps)
- SkillStore 抽象：list_visible / get_visible / get_any /
get_owned / create / ensure_legacy / update / update_admin /
delete / delete_admin
- SqlAlchemy 实现 SkillRepository
- MemorySkillStore 用于测试
- 可见性 = owner OR published OR builtin
2. persistence/notifications/
- NotificationRow ORM (id, user_id, type, title, body, payload JSON,
read, created_at)
- NotificationStore 抽象：create / list_for_user / unread_count /
mark_read / mark_all_read / delete
- SqlAlchemy 实现 NotificationRepository
- MemoryNotificationStore 用于测试
- sender.notify(user_id, type, ...) 全局接口；harness 不能 import
app.*，所以用 set_notification_store / get_notification_store
注入模式
3. persistence/models/__init__.py 注册 SkillRow + NotificationRow
后续阶段会接入路由、cascade、curator per-user 重构、前端。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
43 lines
1.3 KiB
Python
43 lines
1.3 KiB
Python
"""Abstract persistence API for in-app notifications."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from abc import ABC, abstractmethod
|
|
from typing import Any
|
|
|
|
|
|
class NotificationStore(ABC):
|
|
@abstractmethod
|
|
async def create(self, data: dict[str, Any]) -> dict[str, Any]:
|
|
"""Insert a notification record. ``data`` must include ``id``, ``user_id``, ``type``."""
|
|
raise NotImplementedError
|
|
|
|
@abstractmethod
|
|
async def list_for_user(
|
|
self,
|
|
user_id: str,
|
|
*,
|
|
unread_only: bool = False,
|
|
limit: int = 50,
|
|
) -> list[dict[str, Any]]:
|
|
"""Return newest-first records for ``user_id``."""
|
|
raise NotImplementedError
|
|
|
|
@abstractmethod
|
|
async def unread_count(self, user_id: str) -> int:
|
|
raise NotImplementedError
|
|
|
|
@abstractmethod
|
|
async def mark_read(self, notification_id: str, user_id: str) -> bool:
|
|
"""Mark a single notification as read; returns False if not owned by user."""
|
|
raise NotImplementedError
|
|
|
|
@abstractmethod
|
|
async def mark_all_read(self, user_id: str) -> int:
|
|
"""Mark every unread notification of ``user_id`` as read; returns count updated."""
|
|
raise NotImplementedError
|
|
|
|
@abstractmethod
|
|
async def delete(self, notification_id: str, user_id: str) -> bool:
|
|
raise NotImplementedError
|