core-framework 1.7.0__tar.gz → 1.8.0__tar.gz

{core_framework-1.7.0 → core_framework-1.8.0}/.cursor/rules/application-layer.mdc

@@ -77,3 +77,7 @@ async def retrieve_my_username_suggestions(...) -> list[UsernameSuggestion]: ...
 - Input validation (`validate_user_id`, `validate_report_id`, etc.) belongs in schemas
 - Services do NOT raise `RequestValidationError` or import from `fastapi.exceptions`
 - Routers call `validate_*` from schemas before invoking services
+
+## Docstrings
+
+Application functions get a **one-line** docstring (what it does). No `Args` / `Returns` / `Raises` — see **`docstrings.mdc`**.

core_framework-1.8.0/.cursor/rules/docstrings.mdc

@@ -0,0 +1,81 @@
+---
+description: Docstring depth by layer — one-line in application, full Args/Returns/Raises in domain and infrastructure
+globs:
+  - core_framework/application/**/*.py
+  - core_framework/domains/**/*.py
+  - core_framework/infrastructure/**/*.py
+---
+
+# Docstrings by layer
+
+Docstring **depth** depends on which layer owns the symbol. Type hints and keyword-only signatures carry parameter detail in application code; domain and infrastructure document the contract at the boundary.
+
+## Application layer (`core_framework/application/`)
+
+**One short sentence** — what the function does. No `Args`, `Returns`, or `Raises` sections.
+
+```python
+# ✅ Preferred
+async def enqueue_delete_superseded_banner_finals(*, asset_id: str) -> None:
+    """Enqueue cleanup of published finals for a replaced banner asset."""
+    ...
+
+# ❌ Avoid — too heavy for application orchestration
+async def enqueue_delete_superseded_banner_finals(...):
+    """Enqueue cleanup of published finals for a replaced banner asset.
+
+    Args:
+        asset_id: ...
+    Returns:
+        ...
+    """
+```
+
+Applies to **public and private** helpers in application modules. When you touch a function in an application file, use the simple style.
+
+## Domain layer (`core_framework/domains/`)
+
+**Full docstring** on public service, repository, component, and port methods that implement or define behavior:
+
+- Opening summary (one or two sentences)
+- **`Args:`** — keyword-only parameters and meaning
+- **`Returns:`** — when the return value is not obvious from the type alone
+- **`Raises:`** — domain exceptions and validation errors callers should handle
+
+Skip `Raises` only when the method truly cannot raise beyond programming errors. Trivial private helpers may stay undocumented; **exported and orchestration paths** get the full treatment.
+
+```python
+# ✅ Preferred (domain service)
+async def insert_avatar_staging_registry(...) -> AvatarStagingRegistryEntry:
+    """Record a new avatar staging registry row before blob upload completes.
+
+    Args:
+        asset_id: Unique avatar asset identifier.
+        owner_user_id: User who owns the avatar.
+        staging_filename: Basename of the staging blob on disk.
+
+    Returns:
+        Persisted registry entry including staging metadata.
+
+    Raises:
+        DomainValidationError: If required string fields are blank or ``staging_filename``
+            is unsafe.
+    """
+```
+
+Repositories: document query semantics (filtering, empty results, strong vs normal read) in the summary or **`Returns:`** when non-obvious.
+
+## Infrastructure layer (`core_framework/infrastructure/`)
+
+Same as **domain** — adapters implement ports and perform I/O. Document inputs, outputs, failure modes (`Raises:` or raised infrastructure exceptions), and non-obvious side effects (network, disk, SSH).
+
+## When editing
+
+- **New** application functions → simple docstring.
+- **New** domain/infrastructure public methods → full docstring.
+- When you **change** a function in a file, bring **that function's** docstring in line with its layer; do not repo-wide migrate unrelated symbols unless the task asks for it.
+
+## Out of scope
+
+- **API routers and schemas** — no docstring requirement from this rule (OpenAPI and Pydantic carry the contract).
+- **Workers** (`core_framework/worker/`) — thin task/schedule wrappers follow **application** style; logic belongs in application services.

{core_framework-1.7.0 → core_framework-1.8.0}/.cursor/rules/domain-services-and-adapters.mdc

@@ -45,3 +45,7 @@ See **`docs/platform/domain-services-and-adapters.md`** for the full model. Appl
 - **Layout:** `domains/media/shared/`, `avatar/ports/`, `avatar/components/`, `AvatarService`.
 - **Avatar:** `media_deps.avatar_service` only (not individual components).
 - **Cross-domain:** `avatar_ingest_sequence` / profile `avatar_id` via **user** domain; orchestration in `application/media/avatar_service`.
+
+## Docstrings
+
+Domain services, repositories, ports, and components use **full** docstrings (`Args`, `Returns`, `Raises` where applicable). Application orchestration uses **one-line** summaries — see **`docstrings.mdc`**.

{core_framework-1.7.0 → core_framework-1.8.0}/.cursor/skills/code-review/SKILL.md

@@ -39,7 +39,7 @@ Read these files **before** proceeding with the review:
 1. **`docs/platform/domain-services-and-adapters.md`** – Application orchestration vs domain services, ports/adapters, multiple collaborators per bounded context
 1. **`docs/platform/conventions.md`** – Coding conventions, domain rules, caching, Redis, exception handling, API layer rules
 1. **`docs/platform/architecture-decisions.md`** – Intentional design choices; do not flag these as issues
-1. **`.cursor/rules/api-layer.mdc`**, **`.cursor/rules/application-layer.mdc`**, **`.cursor/rules/domain-services-and-adapters.mdc`**, **`.cursor/rules/domain-imports.mdc`**, **`.cursor/rules/domain-caller-context.mdc`** – Apply when reviewing API/application/domain code
+1. **`.cursor/rules/api-layer.mdc`**, **`.cursor/rules/application-layer.mdc`**, **`.cursor/rules/docstrings.mdc`**, **`.cursor/rules/domain-services-and-adapters.mdc`**, **`.cursor/rules/domain-imports.mdc`**, **`.cursor/rules/domain-caller-context.mdc`** – Apply when reviewing API/application/domain code
 
 ## Step 2: Key Context
 
@@ -76,6 +76,7 @@ Verify the following. Also apply api-layer, application-layer, and domain-import
 
 ### Application Layer Services (`core_framework/application/**/*_service.py`)
 
+- [ ] **Docstrings** – One-line summary only; no `Args`/`Returns`/`Raises` (see `docstrings.mdc`)
 - [ ] **No HTTP handling** – No `HTTPException`, `RequestValidationError`, `BackgroundTasks`, or other FastAPI HTTP imports
 - [ ] **No Pydantic return types** – Services return `dict`, `list[dict]`, dataclasses, or plain types; routers use `response_model`
 - [ ] **Not found** – Return `None` or `Optional`; routers raise `HTTPException(404)` when appropriate

{core_framework-1.7.0 → core_framework-1.8.0}/CHANGELOG.md

@@ -4,6 +4,24 @@ Notable changes to **core-framework** (import **`core_framework`**). Format foll
 
 ## [Unreleased]
 
+## [1.8.0] - 2026-06-06
+
+### Added
+
+- **`[avatar].public_path_prefix`** and **`[banner].public_path_prefix`** — optional URL path segment in **`config.toml`** when avatar/banner finals are served under a subdirectory on a shared media host. Empty by default (dedicated product vhost docroot).
+
+- **Follow counts on profile surfaces:** **`GET /users/me/profile`**, **`PATCH /users/me/profile`**, and admin **`GET /admin/users/{user_id}`** profile payload include **`follower_count`** and **`following_count`** (same **user_stats** source as public profile). Follow/unfollow invalidates **`user_stats`** cache for both parties when the edge changes.
+
+- **HEIC/HEIF ingest (avatar and banner):** Allow **`image/heic`** and **`image/heif`** on profile image uploads; decode via **`pillow-heif`** before WebP variant encoding.
+
+- **Image ingest hardening:** Staging decode uses a **30s** timeout, **4096×4096** pixel cap, and Pillow decompression-bomb limits; published WebP finals omit embedded metadata.
+
+- **Structured mentions (posts and comments):** **`post_mentions`** / **`comment_mentions`** persistence; **`mentions`** on **POST** create, **PATCH** replace (omit unchanged, **`[]`** clears), and **GET** responses as **`UserReference`** list. **`mention` inbox notifications** remain **create-only**. Migrations **`post_add_post_mentions`**, **`comment_add_comment_mentions`**. See **`docs/domains/mentions/mentions_in_content.md`**.
+
+### Database
+
+- **Post** migration **`post_add_post_mentions`**; **comment** migration **`comment_add_comment_mentions`**. Run **`uv run cf-alembic`** before deploying.
+
 ## [1.7.0] - 2026-06-01
 
 ### Added
@@ -233,4 +251,5 @@ First **SemVer-stable** release per **`docs/library/package-api.md`**.
 [1.5.0]: https://github.com/NepNepFFXIV/core-framework/compare/v1.4.0...v1.5.0
 [1.6.0]: https://github.com/NepNepFFXIV/core-framework/compare/v1.5.0...v1.6.0
 [1.7.0]: https://github.com/NepNepFFXIV/core-framework/compare/v1.6.0...v1.7.0
-[unreleased]: https://github.com/NepNepFFXIV/core-framework/compare/v1.7.0...HEAD
+[1.8.0]: https://github.com/NepNepFFXIV/core-framework/compare/v1.7.0...v1.8.0
+[unreleased]: https://github.com/NepNepFFXIV/core-framework/compare/v1.8.0...HEAD

{core_framework-1.7.0 → core_framework-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: core-framework
-Version: 1.7.0
+Version: 1.8.0
 Summary: Core framework package (import as core_framework)
 Project-URL: Homepage, https://github.com/NepNepFFXIV/core-framework
 Project-URL: Repository, https://github.com/NepNepFFXIV/core-framework
@@ -24,6 +24,7 @@ Requires-Dist: itsdangerous>=2.2.0
 Requires-Dist: logfire[asyncpg,fastapi,httpx,redis]>=4.32.1
 Requires-Dist: mashumaro[orjson]>=3.20
 Requires-Dist: orjson>=3.11.7
+Requires-Dist: pillow-heif>=1.3.0
 Requires-Dist: pillow>=12.2.0
 Requires-Dist: python-ulid>=3.1.0
 Requires-Dist: structlog>=25.5.0

core_framework-1.8.0/alembic/comment/alembic/versions/comment_add_comment_mentions.py

@@ -0,0 +1,36 @@
+"""add comment_mentions for structured @mentions on comments
+
+Revision ID: comment_add_comment_mentions
+Revises: v1_comment_init
+Create Date: 2026-06-03 12:00:00.000000
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "comment_add_comment_mentions"
+down_revision: str | Sequence[str] | None = "v1_comment_init"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create table comment_mentions (
+            comment_id varchar(26) not null references comments(id) on delete cascade,
+            mentioned_user_id varchar(128) not null,
+            created_at timestamptz not null default now(),
+            primary key (comment_id, mentioned_user_id)
+        );
+    """)
+
+    op.execute("""
+        create index idx_comment_mentions_mentioned_user_id
+        on comment_mentions (mentioned_user_id);
+    """)
+
+
+def downgrade() -> None:
+    pass

core_framework-1.8.0/alembic/post/alembic/versions/post_add_post_mentions.py

@@ -0,0 +1,36 @@
+"""add post_mentions for structured @mentions on posts
+
+Revision ID: post_add_post_mentions
+Revises: v1_post_init
+Create Date: 2026-06-03 12:00:00.000000
+
+"""
+
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "post_add_post_mentions"
+down_revision: str | Sequence[str] | None = "v1_post_init"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.execute("""
+        create table post_mentions (
+            post_id varchar(26) not null references posts(id) on delete cascade,
+            mentioned_user_id varchar(128) not null,
+            created_at timestamptz not null default now(),
+            primary key (post_id, mentioned_user_id)
+        );
+    """)
+
+    op.execute("""
+        create index idx_post_mentions_mentioned_user_id
+        on post_mentions (mentioned_user_id);
+    """)
+
+
+def downgrade() -> None:
+    pass

{core_framework-1.7.0 → core_framework-1.8.0}/config.toml

@@ -18,11 +18,13 @@ staging_root = "media-staging"
 avatar_host_domain = "avatar.core-framework.com"
 default_avatar_image = "default.webp"
 publish_root = "/var/www/sites/avatar"
+public_path_prefix = "avatar"
 
 [banner]
 banner_host_domain = "banner.core-framework.com"
 default_banner_image = "default.webp"
 publish_root = "/var/www/sites/banner"
+public_path_prefix = "banner"
 
 [image_server]
 host = "127.0.0.1"

{core_framework-1.7.0 → core_framework-1.8.0}/config.toml.template

@@ -13,11 +13,13 @@ staging_root = "/app/media-staging"
 avatar_host_domain = "$AVATAR_HOST_DOMAIN"
 default_avatar_image = "$AVATAR_DEFAULT_IMAGE"
 publish_root = "$AVATAR_PUBLISH_ROOT"
+public_path_prefix = "avatar"
 
 [banner]
 banner_host_domain = "$BANNER_HOST_DOMAIN"
 default_banner_image = "$BANNER_DEFAULT_IMAGE"
 publish_root = "$BANNER_PUBLISH_ROOT"
+public_path_prefix = "banner"
 
 [image_server]
 host = "$IMAGE_SERVER_HOST"

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/admin/users/schemas.py

@@ -80,6 +80,8 @@ class AdminProfileResponse(AvatarMixin, BannerMixin):
     social_links: Annotated[dict[str, str], Field(default_factory=dict)]
     profile_visibility: ProfileVisibility
     date_of_birth: DateOfBirth | None
+    follower_count: Annotated[int, Field(ge=0)] = 0
+    following_count: Annotated[int, Field(ge=0)] = 0
 
 
 class UserDetailResponse(BaseModel):

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/comments/authenticated/mappers.py

@@ -4,7 +4,17 @@ from core_framework.domains.comment import CommentUpdate
 
 def comment_update_from_request(*, request: UpdateCommentRequest) -> CommentUpdate:
     fields_set = frozenset(request.model_fields_set)
+
+    content = None
+    if "content" in fields_set and request.content is not None:
+        content = request.content.root
+
+    mentions = None
+    if "mentions" in fields_set:
+        mentions = None if request.mentions is None else [mention.root for mention in request.mentions]
+
     return CommentUpdate(
         fields_set=fields_set,
-        content=request.content.root if "content" in fields_set and request.content is not None else None,
+        content=content,
+        mentions=mentions,
     )

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/comments/authenticated/schemas.py

@@ -12,6 +12,14 @@ from core_framework.domains.moderation import ReportCategory
 
 class UpdateCommentRequest(BasePatchRequest):
     content: CommentContent | None = None
+    mentions: Annotated[list[UserID], Field(max_length=MAX_MENTIONS_PER_REQUEST)] | None = None
+
+    @field_validator("mentions", mode="after")
+    @classmethod
+    def dedupe_mentions(cls, v: list[UserID] | None) -> list[UserID] | None:
+        if v is None:
+            return None
+        return dedupe_mention_user_ids(v)
 
 
 class CommentReportRequest(BaseModel):

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/comments/public/schemas.py

@@ -28,6 +28,7 @@ class CommentResponse(BaseModel):
     id: ULID
     author: UserReference
     content: CommentContent
+    mentions: list[UserReference]
     stats: CommentStatsResponse
     can_reply: bool
     engagement_allowed: bool

core_framework-1.8.0/core_framework/api/posts/authenticated/mappers.py

@@ -0,0 +1,28 @@
+from core_framework.api.posts.authenticated.schemas import UpdatePostRequest
+from core_framework.domains.post import PostUpdate
+
+
+def post_update_from_request(*, request: UpdatePostRequest) -> PostUpdate:
+    fields_set = frozenset(request.model_fields_set)
+
+    content = None
+    if "content" in fields_set and request.content is not None:
+        content = request.content.root
+
+    visibility = request.visibility if "visibility" in fields_set else None
+
+    hashtags = None
+    if "hashtags" in fields_set:
+        hashtags = None if request.hashtags is None else [hashtag.root for hashtag in request.hashtags]
+
+    mentions = None
+    if "mentions" in fields_set:
+        mentions = None if request.mentions is None else [mention.root for mention in request.mentions]
+
+    return PostUpdate(
+        fields_set=fields_set,
+        content=content,
+        visibility=visibility,
+        hashtags=hashtags,
+        mentions=mentions,
+    )

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/posts/authenticated/schemas.py

@@ -37,6 +37,7 @@ class UpdatePostRequest(BasePatchRequest):
     content: PostContent | None = None
     visibility: PostVisibility | None = None
     hashtags: Annotated[list[Hashtag], Field(max_length=MAX_HASHTAGS)] | None = None
+    mentions: Annotated[list[UserID], Field(max_length=MAX_MENTIONS_PER_REQUEST)] | None = None
 
     @field_validator("hashtags", mode="after")
     @classmethod
@@ -44,3 +45,10 @@ class UpdatePostRequest(BasePatchRequest):
         if v is None:
             return None
         return list({h.root: h for h in v}.values())
+
+    @field_validator("mentions", mode="after")
+    @classmethod
+    def dedupe_mentions(cls, v: list[UserID] | None) -> list[UserID] | None:
+        if v is None:
+            return None
+        return dedupe_mention_user_ids(v)

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/posts/public/schemas.py

@@ -31,6 +31,7 @@ class PostResponse(BaseModel):
     author: UserReference
     content: PostContent
     hashtags: list[Hashtag]
+    mentions: list[UserReference]
     visibility: PostVisibility
     stats: PostStatsResponse
     engagement_allowed: bool

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/users/authenticated/router.py

@@ -41,7 +41,7 @@ from core_framework.application.users.authenticated_service import (
     change_my_profile,
     delete_my_current_appeal,
     follow_user,
-    mark_user_stats_dirty,
+    mark_follow_counterparty_stats_stale,
     remove_user_report,
     retrieve_my_account,
     retrieve_my_appeals,
@@ -446,8 +446,11 @@ async def put_follow_user(
     validated_target_user_id = validate_user_id(user_id=target_user_id)
     changed = await follow_user(user_id=user_id.root, target_user_id=validated_target_user_id.root)
     if changed:
-        background_tasks.add_task(mark_user_stats_dirty, user_id=user_id.root)
-        background_tasks.add_task(mark_user_stats_dirty, user_id=validated_target_user_id.root)
+        background_tasks.add_task(
+            mark_follow_counterparty_stats_stale,
+            user_id=user_id.root,
+            target_user_id=validated_target_user_id.root,
+        )
 
 
 @router.delete(
@@ -463,8 +466,11 @@ async def delete_follow_user(
     validated_target_user_id = validate_user_id(user_id=target_user_id)
     changed = await unfollow_user(user_id=user_id.root, target_user_id=validated_target_user_id.root)
     if changed:
-        background_tasks.add_task(mark_user_stats_dirty, user_id=user_id.root)
-        background_tasks.add_task(mark_user_stats_dirty, user_id=validated_target_user_id.root)
+        background_tasks.add_task(
+            mark_follow_counterparty_stats_stale,
+            user_id=user_id.root,
+            target_user_id=validated_target_user_id.root,
+        )
 
 
 @router.get(

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/users/authenticated/schemas.py

@@ -48,6 +48,8 @@ class ProfileResponse(AvatarMixin, BannerMixin):
     social_links: dict[str, str]
     profile_visibility: ProfileVisibility
     date_of_birth: DateOfBirth | None
+    follower_count: Annotated[int, Field(ge=0)] = 0
+    following_count: Annotated[int, Field(ge=0)] = 0
 
 
 class AccountResponse(AvatarMixin):

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/api/users/public/router.py

@@ -4,9 +4,10 @@ from fastapi import APIRouter, Query
 from fastapi.exceptions import RequestValidationError
 from pydantic import ValidationError
 
-from core_framework.api.users.public.schemas import UsernameExistsResponse
-from core_framework.api.users.shared.schemas import Username
-from core_framework.application.users.public_service import is_username_available
+from core_framework.api.dependencies import OptionalUserID
+from core_framework.api.users.public.schemas import UsernameExistsResponse, UserProfileResponse
+from core_framework.api.users.shared.schemas import Username, validate_user_id
+from core_framework.application.users.public_service import is_username_available, retrieve_user_profile
 
 router = APIRouter(
     prefix="/users",
@@ -23,3 +24,12 @@ async def get_username_exists(username: Annotated[str, Query()]) -> Any:
     except ValidationError as e:
         raise RequestValidationError(e.errors()) from e
     return {"status": "available" if await is_username_available(username=validated_username.root) else "taken"}
+
+
+@router.get("/{target_user_id}/profile", response_model=UserProfileResponse)
+async def get_user_profile(target_user_id: str, viewer_id: OptionalUserID) -> Any:
+    validated_target_user_id = validate_user_id(user_id=target_user_id)
+    return await retrieve_user_profile(
+        target_user_id=validated_target_user_id.root,
+        viewer_id=viewer_id.root if viewer_id else None,
+    )

core_framework-1.8.0/core_framework/api/users/public/schemas.py

@@ -0,0 +1,33 @@
+from typing import Annotated, Literal
+
+from pydantic import BaseModel, Field
+
+from core_framework.api.users.shared.schemas import (
+    AvatarMixin,
+    BannerMixin,
+    Bio,
+    DisplayName,
+    UserID,
+    Username,
+    UserStatus,
+)
+
+
+class UsernameExistsResponse(BaseModel):
+    status: Literal["available", "taken"]
+
+
+class UserProfileViewerContext(BaseModel):
+    is_following: bool
+
+
+class UserProfileResponse(AvatarMixin, BannerMixin):
+    user_id: UserID
+    username: Username
+    display_name: DisplayName | None = None
+    bio: Bio | None = None
+    status: UserStatus | None = None
+    social_links: dict[str, str]
+    follower_count: Annotated[int, Field(ge=0)] = 0
+    following_count: Annotated[int, Field(ge=0)] = 0
+    viewer_context: UserProfileViewerContext | None = None

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/application/auth/access_service.py

@@ -15,16 +15,11 @@ from core_framework.domains.user import UserIdentity
     condition=lambda result, args, kwargs, key=None: result.identity != UserIdentity.DEFAULT,
 )
 async def get_user_detail(*, user_id: str) -> UserDetail:
-    """Return cached user identity and moderation state for auth middleware.
+    """
+    Return cached user identity and moderation state for auth middleware.
 
     Fetches identity and moderation mappings concurrently. Results are cached
     under ``CacheKey.USER_DETAIL``; default (missing) identities are not cached.
-
-    Args:
-        user_id: External user ID from the auth token.
-
-    Returns:
-        Combined identity and moderation snapshot for access checks.
     """
     async with asyncio.TaskGroup() as tg:
         identity_task = tg.create_task(user_deps.user_service.retrieve_user_identity_mapping(user_ids={user_id}))

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/application/auth/auth_service.py

@@ -6,14 +6,7 @@ from core_framework.domains.user import CreatedUser
 
 
 async def register_user(*, user_id: str) -> CreatedUser:
-    """Register a new user and prime username availability cache.
-
-    Args:
-        user_id: External identity for the new account.
-
-    Returns:
-        Created user ID and assigned username.
-    """
+    """Register a new user and prime username availability cache."""
     created_user = await user_deps.user_service.add_user(user_id=user_id)
     await cache.set(
         CacheKey.TAKEN_USERNAMES.format_key(username=created_user.username),

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/application/bootstrap.py

@@ -10,6 +10,7 @@ from core_framework.domains.user.dependencies import configure_user_dependencies
 
 
 def configure_application_dependencies(*, runtime: CoreRuntime) -> None:
+    """Wire application-level dependencies from the shared runtime."""
     configure_worker_jobs(runtime=runtime)
     configure_cashews_backend(redis_cache_url=runtime.settings.redis.redis_cache_url)
     configure_comment_dependencies(runtime)

{core_framework-1.7.0 → core_framework-1.8.0}/core_framework/application/cache/invalidate_service.py

@@ -9,14 +9,11 @@ logger = get_logger(__name__)
 
 
 async def invalidate_cache_targets(*, actor_id: str, items: list[CacheInvalidateTarget]) -> None:
-    """Invalidate cashews cache entries requested by an admin.
+    """
+    Invalidate cashews cache entries requested by an admin.
 
     Best-effort: failures are logged and do not propagate. Callers receive no
     signal when Redis or cashews is unavailable (see admin cache invalidation flow doc).
-
-    Args:
-        actor_id: Firebase uid of the admin performing the operation.
-        items: Cache keys and parameters to invalidate.
     """
     for item in items:
         try:
@@ -39,12 +36,7 @@ async def invalidate_cache_targets(*, actor_id: str, items: list[CacheInvalidate
 
 
 async def enqueue_cache_pattern_invalidation(*, actor_id: str, target: CacheInvalidatePatternTarget) -> None:
-    """Enqueue a worker job to invalidate cache entries matching a partial pattern.
-
-    Args:
-        actor_id: Firebase uid of the admin performing the operation.
-        target: Cache resource and partial key parameters (omitted fields wildcard).
-    """
+    """Enqueue a worker job to invalidate cache entries matching a partial pattern."""
     await worker_jobs.enqueue_job(
         job_name=WorkerJobName.PROCESS_CACHE_PATTERN_INVALIDATION,
         actor_id=actor_id,
@@ -54,15 +46,7 @@ async def enqueue_cache_pattern_invalidation(*, actor_id: str, target: CacheInva
 
 
 async def invalidate_cache_pattern_target(*, actor_id: str, target: CacheInvalidatePatternTarget) -> None:
-    """Invalidate cashews cache entries matching a partial pattern (worker entrypoint).
-
-    Args:
-        actor_id: Firebase uid of the admin who requested the invalidation.
-        target: Cache resource and partial key parameters (omitted fields wildcard).
-
-    Raises:
-        Exception: Re-raised after logging so the worker can retry transient failures.
-    """
+    """Invalidate cashews cache entries matching a partial pattern (worker entrypoint)."""
     try:
         await invalidate_cache(target.resource, **target.params)
     except Exception: