@aiquants/daily-report 0.20.0 → 0.21.0

package/src/server/service.ts

@@ -1,2045 +0,0 @@
-/**
- * Data-access service for daily reports (drizzle mssql), fully DI-configured.
- * 日報データアクセスサービス (drizzle mssql)。依存はすべて DI で注入する。
- *
- * キャッシュキー・無効化順序・SSE publish 順序を含むデータアクセスロジックの中核。
- */
-
-import { runWithTransactionRetry, type TransactionRetryOptions } from "@aiquants/mssql"
-import { aliasedTable, and, asc, desc, eq, getColumns, inArray, isNull, or, sql } from "drizzle-orm"
-import { normalizeBusinessDateKey } from "../shared/business-date"
-import { compareIdsStreamOrder, isIdsStreamOrdered } from "../shared/ids-stream"
-import { createLogger, type DailyReportLogger, LogLevel } from "../shared/logger"
-import { commentAddMessageSchema, commentDeleteMessageSchema, reportCreateMessageSchema, reportDeleteMessageSchema, reportPublishMessageSchema, reportUpdateMessageSchema, statusUpdateMessageSchema } from "../shared/sse-schema"
-import type { DailyReportAttachmentSummary, DailyReportDetail, DailyReportExternalComment, DailyReportInterviewer, DailyReportItem, DailyReportLabelDef, DailyReportPostedComment } from "../shared/types"
-import type { EpochStore, SqlResultCache, SqlResultCacheQueryOptions } from "./cache"
-import type { DailyReportExternalSource } from "./external-source"
-import type { DailyReportEncodeUserId, DailyReportIdCodec, DailyReportRedisProvider, DailyReportResolveUserId } from "./ports"
-import type { DailyReportTables, DailyReportUserTable } from "./schema"
-import { buildVisibleSourceTypeCondition, computeViewerScopeDigest, DailyReportViewerScope, deniesEverySourceType, isSourceTypeVisible, type VisibleSourceTypeSet } from "./visibility"
-
-export type { SqlResultCacheQueryOptions }
-
-// ---- 行型 (drizzle $inferSelect の構造的置き換え) ----
-
-/** DailyReportHub の行型。 */
-export type DailyReportHubRow = {
-    id: number
-    sourceType: string
-    sourceId: string
-    sourceIdNum: number | null
-    businessDate: Date | string | null
-    userId: number | null
-    title: string | null
-    summary: string | null
-    createdAt: Date | string
-    createdBy: string
-    updatedAt: Date | string
-    updatedBy: string
-    deletedAt: Date | string | null
-    deletedBy: string | null
-}
-
-/** DailyReportInternal の行型。 */
-export type DailyReportInternalRow = {
-    hubId: number
-    body: string | null
-    metadata: string | null
-    createdAt: Date | string
-    createdBy: string
-    updatedAt: Date | string
-    updatedBy: string
-}
-
-/** DailyReportUserStatus の行型。 */
-export type DailyReportUserStatusRow = {
-    hubId: number
-    userId: number
-    isRead: boolean
-    isStarred: boolean
-    createdAt: Date | string
-    createdBy: string
-    updatedAt: Date | string
-    updatedBy: string
-}
-
-/** 投稿コメント行 (物理テーブル DailyReportComment) の行型。 */
-export type DailyReportCommentRow = {
-    id: number
-    hubId: number
-    userId: number
-    body: string
-    createdAt: Date | string
-    createdBy: string
-    updatedAt: Date | string
-    updatedBy: string
-}
-
-// ---- 必要最小の drizzle ビルダ形 (公開契約はサービス関数のシグネチャで厳格化) ----
-
-type Rows<T> = PromiseLike<T[]>
-interface SelectChain<T> extends Rows<T> {
-    from(t: unknown): SelectChain<T>
-    innerJoin(t: unknown, on: unknown): SelectChain<T>
-    leftJoin(t: unknown, on: unknown): SelectChain<T>
-    where(cond: unknown): SelectChain<T>
-    orderBy(...cols: unknown[]): SelectChain<T>
-    top(n: number): SelectChain<T>
-}
-interface InsertChain<T> {
-    output(): { values(v: unknown): PromiseLike<T[]> }
-    values(v: unknown): PromiseLike<unknown>
-}
-interface UpdateChain<T> {
-    set(v: unknown): {
-        where(cond: unknown): PromiseLike<unknown>
-        output(): { where(cond: unknown): PromiseLike<T[]> }
-    }
-}
-interface DeleteChain {
-    where(cond: unknown): PromiseLike<unknown>
-}
-
-/** サービスが要求する drizzle mssql データベースの最小面 (トランザクション込み)。 */
-export interface DailyReportDb {
-    select<T = Record<string, unknown>>(fields?: unknown): SelectChain<T>
-    insert<T = Record<string, unknown>>(t: unknown): InsertChain<T>
-    update<T = Record<string, unknown>>(t: unknown): UpdateChain<T>
-    delete(t: unknown): DeleteChain
-    transaction<T>(fn: (tx: DailyReportDb) => Promise<T>, config?: unknown): Promise<T>
-}
-
-/** getColumns へ構造型テーブルを渡すための境界キャスト。 */
-const cols = (t: unknown) => getColumns(t as Parameters<typeof getColumns>[0])
-
-// ---- サービス設定 ----
-
-export type DailyReportServiceConfig = {
-    /** drizzle mssql データベースハンドル。 */
-    db: DailyReportDb
-    /** 日報 7 テーブル (アプリ既存モデルまたは defineDailyReportSchema 生成物)。`attachment` のみ任意。 */
-    tables: DailyReportTables
-    /** 表示名解決に使う外部ユーザーテーブル ({ id, displayName })。 */
-    userTable: DailyReportUserTable
-    /** 外部ユーザー ID → 内部数値 ID の解決ポート。 */
-    resolveUserId: DailyReportResolveUserId
-    /** 内部数値 ID の難読化ポート。 */
-    encodeUserId: DailyReportEncodeUserId
-    /** SSE publish / epoch 用 redis (省略時は SSE publish スキップ・epoch 無効)。 */
-    redis?: DailyReportRedisProvider
-    /** レガシー等の外部ソースアダプタ群。 */
-    externalSources?: DailyReportExternalSource[]
-    /** SQL 結果キャッシュ (facade が生成して注入)。 */
-    cache: SqlResultCache
-    /** クロスワーカー epoch ストア (facade が生成して注入)。 */
-    epochs: EpochStore
-    /**
-     * Retry policy for transactions SQL Server chose as the deadlock victim. See `@aiquants/mssql`.
-     * サーバがロールバックしたトランザクションの再試行方針。
-     *
-     * 鍵の範囲が重なる並行操作はデッドロックしうる。犠牲に選ばれた側はサーバによって
-     * ロールバックされる — 何もコミットされていないので、書き直す再実行が正しい。既定で 3 回試す。
-     * `{ attempts: 1 }` で再試行しない。
-     */
-    transactionRetry?: TransactionRetryOptions
-    /**
-     * 下書きラベル名 (単一または配列で指定可能)。
-     * 消費アプリ側で自 DB のラベル名や作成区分の候補名 ("下書き", "DRAFT" など) を注入できる。
-     */
-    draftLabelName?: string
-    draftLabelNames?: string[]
-    /** SSE Redis Stream キー (既定 "daily-report:sse-stream")。 */
-    streamKey?: string
-    /** SSE Stream の MAXLEN (既定 10000)。 */
-    streamMaxLen?: number
-    /** IDs 一覧キャッシュ TTL (既定 180,000ms)。 */
-    idsTtlMs?: number
-    /** 営業日別キャッシュ TTL (既定 300,000ms)。 */
-    businessDateTtlMs?: number
-    /** 外部 ID → 内部 ID のプロセス内キャッシュを無効化 (テスト用)。 */
-    disableUserIdCache?: boolean
-    /**
-     * 添付 ID の難読化コーデック。
-     *
-     * 任意にしているのは、添付テーブルを注入しない消費アプリと既存テストのフィクスチャを
-     * 壊さないため。未注入なら添付一覧は常に空になる (縮退動作)。
-     * ユーザー ID 用のコーデックとは **別インスタンス**を渡すこと。同一だと
-     * レスポンス中の `userId` トークンがそのまま添付トークンとして解釈できてしまう。
-     */
-    attachmentIdCodec?: DailyReportIdCodec
-    /** ロガー (既定は console ベース)。 */
-    logger?: DailyReportLogger
-}
-
-/** createDailyReportService の返却型。 */
-export type DailyReportService = ReturnType<typeof createDailyReportService>
-
-/**
- * Creates the daily-report data-access service bound to the injected dependencies.
- * 注入された依存に束縛された日報データアクセスサービスを生成する処理。
- */
-type DatePattern = "YYYY-MM-DD HH:mm:ss" | "YYYY-MM-DD"
-
-/**
- * Formats date-like values to a given pattern using local-time fields (no Intl allocation).
- * 日付相当の値をローカル時刻フィールドで指定パターンへ整形する処理 (Intl 非生成)。
- *
- * ローカル時刻フィールドの手組み整形。旧実装 (ja-JP ロケール + 2-digit toLocale*) と出力互換。
- * ❗ toLocale* 系へ戻さないこと: あれは呼び出しごとに Intl.DateTimeFormat を生成し
- * (実測 約 66μs/呼)、全量 ids の 227k 行 map で 15〜20 秒の同期 CPU 洪水になる。
- * business-date / SSE の全応答が人質化した実害バグの根本原因だった。
- * モジュールスコープの export であり、バレル (src/server.ts の `export *`) 経由で
- * `@aiquants/daily-report/server` の公開 API の一部になる (テストからの直接検証と
- * ホスト側での汎用日時整形の再利用を意図した、意図的な公開)。
- * 1000 年未満の年は旧実装 (年ゼロ詰めなし) から意図的に乖離し、ISO 準拠の 4 桁ゼロ詰めで出す
- * (負の年は符号を除いた絶対値を 4 桁詰め。DB の date/datetime からは到達しない文字列入力のみの領域)。
- */
-export const formatDateValue = (value: Date | string | null | undefined, pattern: DatePattern): string | null => {
-    // null / undefined / 空文字は null に正規化
-    if (!value) {
-        return null
-    }
-
-    // Date 以外 (文字列) は Date コンストラクタで解釈
-    const dateValue = value instanceof Date ? value : new Date(value)
-    if (Number.isNaN(dateValue.getTime())) {
-        // 解釈不能な文字列は原文のまま返す (旧実装と同一の不変挙動)
-        return typeof value === "string" ? value : null
-    }
-
-    // 年月日をゼロ詰めで組み立てる (負の年は符号を除いた絶対値を 4 桁詰め = ISO 8601 拡張表記に整合。
-    // String(-5).padStart は "00-5" と符号ごと詰めてしまうため符号を分離する)
-    const year = dateValue.getFullYear()
-    const yyyy = year < 0 ? `-${String(-year).padStart(4, "0")}` : String(year).padStart(4, "0")
-    const mm = String(dateValue.getMonth() + 1).padStart(2, "0")
-    const dd = String(dateValue.getDate()).padStart(2, "0")
-    if (pattern === "YYYY-MM-DD") {
-        return `${yyyy}-${mm}-${dd}`
-    }
-    // 時分秒付きパターン
-    const hh = String(dateValue.getHours()).padStart(2, "0")
-    const mi = String(dateValue.getMinutes()).padStart(2, "0")
-    const ss = String(dateValue.getSeconds()).padStart(2, "0")
-    return `${yyyy}-${mm}-${dd} ${hh}:${mi}:${ss}`
-}
-
-export function createDailyReportService(config: DailyReportServiceConfig) {
-    const { db, tables, userTable: users, resolveUserId, encodeUserId, redis, cache: sqlResultCache, epochs } = config
-    const { hub: DailyReportHub, internal: DailyReportInternal, comment: DailyReportCommentModel, label: DailyReportLabel, hubLabel: DailyReportHub_Label, userStatus: DailyReportUserStatus } = tables
-    const externalSources = config.externalSources ?? []
-    const draftLabelNames = config.draftLabelNames && config.draftLabelNames.length > 0 ? config.draftLabelNames : [config.draftLabelName ?? "下書き"]
-    const draftLabelName = draftLabelNames[0] ?? "下書き"
-    const logger = config.logger ?? createLogger(LogLevel.INFO, "[DailyReportService]")
-    /**
-     * 全トランザクションの唯一の入口。サーバがロールバックした場合だけやり直す。
-     *
-     * ⚠️ **閉包を DB の外へ波及させないこと。** 再実行は毎回はじめから走るため、ロールバックで元に
-     * 戻らない副作用 (キャッシュ無効化・epoch 更新・SSE 配信) を閉包へ入れてはならない。現在それらは
-     * すべてトランザクションの**後**に置かれている。
-     */
-    // 閉包を capture で包む。包まないと ORM が 1205 を EABORT へ置き換えた後しか見えず、
-    // デッドロックだと判定できなくなる
-    const inTransaction = <T>(fn: (tx: DailyReportDb) => Promise<T>): Promise<T> => runWithTransactionRetry((capture) => db.transaction((tx) => capture(() => fn(tx))), config.transactionRetry)
-
-    const DAILY_REPORT_IDS_CACHE_KEY = "daily-report:ids"
-    const DAILY_REPORT_IDS_TTL_MS = config.idsTtlMs ?? 180_000
-    const DAILY_REPORT_IDS_EPOCH_KEY = "daily-report:ids:epoch"
-
-    const DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX = "daily-report:business-date:"
-    const DAILY_REPORT_BUSINESS_DATE_TTL_MS = config.businessDateTtlMs ?? 300_000
-
-    /** 営業日キャッシュのクロスワーカー epoch プレフィックス */
-    const DAILY_REPORT_DATE_EPOCH_PREFIX = "daily-report:date-epoch:"
-    /** レポート詳細キャッシュのクロスワーカー epoch プレフィックス */
-    const DAILY_REPORT_DETAIL_EPOCH_PREFIX = "daily-report:detail-epoch:"
-
-    /**
-     * SSE ワイヤ形式の版。埋め込み detail スキーマの互換を破る変更ごとに上げる。
-     *
-     * ❗ SSE の実体は配備を跨いで残る永続 Redis Stream (MAXLEN トリムのみ・時間上限なし)。
-     * スキーマの必須キーを変えると、旧形式エントリが再接続 catch-up の safeParse で全滅する。
-     * 版をキーへ焼き込むことで旧エントリは**構造的に到達不能**になり、スキーマに寿命無期限の
-     * 互換シムを飼う必要がなくなる。設定キー (env 上書き含む) にも接尾辞を適用する —
-     * 消費側の設定が版分離を黙って無効化できてはならない。
-     * 旧版のストリームは xAdd が止まりトリムも走らないため残置される (手動 DEL 可)。
-     * v2: comments/commentItems → externalComments/postedComments の改名 (2026-08)。
-     */
-    const DAILY_REPORT_SSE_WIRE_VERSION = "v2"
-    const DAILY_REPORT_SSE_STREAM_KEY = `${config.streamKey ?? "daily-report:sse-stream"}:${DAILY_REPORT_SSE_WIRE_VERSION}`
-    const DAILY_REPORT_SSE_STREAM_MAXLEN = config.streamMaxLen ?? 10000
-
-    const incrementRedisEpoch = (key: string) => epochs.incrementEpoch(key)
-
-    /**
-     * Binds the shared visibility condition builder to this service's hub table.
-     * 共有の可視性条件ビルダーを本サービスの hub テーブルへ束縛したもの。
-     *
-     * 三値の意味と fail-close の方向は {@link buildVisibleSourceTypeCondition} が唯一の真実源。
-     */
-    const visibleSourceTypeCondition = (visible: VisibleSourceTypeSet) => buildVisibleSourceTypeCondition(DailyReportHub.sourceType, visible)
-
-    // ---- キャッシュキー生成 (ダイジェスト折り込みと無効化接頭辞の単一の真実源) ----
-    // ❗ ユーザー別キャッシュキーは必ずここから作る。可視集合ダイジェストの付け忘れ (= 別権限へ
-    //    古い結果を配信) と、無効化時の取りこぼしを構造的に防ぐ。接頭辞の末尾 ":" は
-    //    ユーザー ID の前方一致衝突 (1 と 10) を避けるため必須。
-
-    /** ID 一覧キャッシュのキー (ユーザー + 可視集合ダイジェスト)。 */
-    const idsCacheKey = (userId: number, digest: string): string => `${DAILY_REPORT_IDS_CACHE_KEY}:user:${userId}:st:${digest}`
-    /** ID 一覧キャッシュの当該ユーザー全ダイジェスト分の接頭辞。 */
-    const idsUserPrefix = (userId: number): string => `${DAILY_REPORT_IDS_CACHE_KEY}:user:${userId}:`
-    /** 営業日別キャッシュのキー (営業日 + ユーザー + 可視集合ダイジェスト)。 */
-    const dateCacheKey = (normalizedBusinessDate: string, userId: number, digest: string): string => `daily-report:date:${normalizedBusinessDate}:user:${userId}:st:${digest}`
-    /** 営業日別キャッシュの当該ユーザー全ダイジェスト分の接頭辞。 */
-    const dateUserPrefix = (normalizedBusinessDate: string, userId: number): string => `daily-report:date:${normalizedBusinessDate}:user:${userId}:`
-    /** 詳細キャッシュのキー (hub + ユーザー + 可視集合ダイジェスト)。 */
-    const detailCacheKey = (reportHubId: number, userId: number, digest: string): string => `daily-report:detail:${reportHubId}:user:${userId}:st:${digest}`
-    /** 詳細キャッシュの当該ユーザー全ダイジェスト分の接頭辞。 */
-    const detailUserPrefix = (reportHubId: number, userId: number): string => `daily-report:detail:${reportHubId}:user:${userId}:`
-
-    /**
-     * Publishes a message to the SSE Redis Stream.
-     * SSE 用の Redis Stream にメッセージを追加する。
-     */
-    const publishToSseStream = async (message: Record<string, unknown>, callerName: string): Promise<void> => {
-        const client = await redis?.getClient()
-        if (!client) {
-            logger.warn(`[SSE] Redis client unavailable (${callerName})`)
-            return
-        }
-        const publishStartMs = Date.now()
-        try {
-            await client.xAdd(DAILY_REPORT_SSE_STREAM_KEY, "*", { data: JSON.stringify(message) }, { TRIM: { strategy: "MAXLEN", strategyModifier: "~", threshold: DAILY_REPORT_SSE_STREAM_MAXLEN } })
-            const publishDurationMs = Date.now() - publishStartMs
-            if (publishDurationMs > 1000) {
-                logger.warn(`[SSE] Slow publish (${callerName}): ${publishDurationMs}ms`)
-            }
-        } catch (e) {
-            logger.error(`[SSE] Redis publish failed (${callerName}):`, e)
-        }
-    }
-
-    /**
-     * Masks a raw audit-actor value (created_by / updated_by) before client exposure.
-     * 監査列 (created_by / updated_by) をクライアント公開前にマスクする処理。
-     *
-     * Internal 由来の値は String(userId) の生内部 ID のため、数値なら encodeUserId で難読化する。
-     * 非数値 (外部ソース由来の氏名やシステム文字列) はそのまま返す。null / 空文字は null。
-     * userId フィールドと同じ難読化を監査列にも適用し、内部 ID の横流し漏洩を防ぐ。
-     */
-    const maskAuditActor = (value: string | null | undefined): string | null => {
-        if (value == null || value === "") return null
-        return /^\d+$/.test(value) ? encodeUserId(Number(value)) : value
-    }
-
-    type RawJsonComment = {
-        id: number
-        content: string
-        createdAt: string
-        userId: number
-        userName: string
-    }
-
-    type RawJsonLabel = {
-        id: number
-        name: string
-        color: string | null
-    }
-
-    /** 詳細クエリ 1 行 (外部ソース列は `ext_<sourceType>` キーで同居)。 */
-    type HubQueryRow = {
-        hub: DailyReportHubRow
-        internal: DailyReportInternalRow | null
-        isRead?: boolean | null
-        isStarred?: boolean | null
-        creatorName?: string | null
-    } & Record<string, unknown>
-
-    type HubRecord = HubQueryRow & {
-        labels?: RawJsonLabel[]
-        /** パッケージ自身のコメント表 (投稿コメント) の行。detail の postedComments になる。 */
-        postedCommentRows?: RawJsonComment[]
-        /**
-         * 添付ファイル一覧。**任意にしない。**
-         * `?` を付けると `mapHubRecord` 側で `?? []` が必要になり、注入を忘れた読み取り経路が
-         * 黙って空配列を返す。必須にしておけば注入漏れは全呼び出し箇所でコンパイルエラーになる。
-         */
-        attachments: DailyReportAttachmentSummary[]
-    }
-
-    /** 外部ソースアダプタの select 追加フィールドを構築する。 */
-    const externalSelections = (): Record<string, unknown> => {
-        const out: Record<string, unknown> = {}
-        for (const adapter of externalSources) {
-            out[`ext_${adapter.sourceType}`] = cols(adapter.table)
-        }
-        return out
-    }
-
-    /** 外部ソースアダプタの LEFT JOIN を select チェーンへ適用する。 */
-    const applyExternalJoins = <T>(chain: SelectChain<T>): SelectChain<T> => {
-        let c = chain
-        for (const adapter of externalSources) {
-            c = c.leftJoin(adapter.table, and(eq(DailyReportHub.sourceType, adapter.sourceType), eq(DailyReportHub.sourceIdNum, adapter.idColumn)))
-        }
-        return c
-    }
-
-    /**
-     * Converts a Hub record into a DailyReportDetail structure, applying the viewer's comment visibility.
-     * Hub レコードを DailyReportDetail に変換し、閲覧者のコメント可視性を適用する処理。
-     *
-     * ❗ **コメント 2 面の唯一の生成点**。詳細取得 / 営業日一覧 / 管理経路 / publish 応答の全てが
-     * ここを通るため、コメント次元の射影はここ 1 箇所に置く。SQL の `WHERE` 側で絞るのは不可 —
-     * コメント表を引くクエリは `postedComments` にしか効かず、レガシー `comments` は外部ソース
-     * アダプタの出力なのでクエリを通らない (半分しか塞げない)。
-     *
-     * ❗ 秘匿は**必ず空配列**で行う。キーごと省くと SSE 側は `dailyReportDetailSchema` の必須キー
-     * 欠落で `safeParse` に失敗し、メッセージ全体が fail-close で落ちる (更新が永久に届かない)。
-     * HTTP 側もクライアントの `DailyReportCache.merge` が `postedComments` を無ガードで参照する。
-     *
-     * @param scope Viewer scope carrying the comment dimension. コメント次元を運ぶ閲覧範囲。
-     * @param row Hub record to convert. 変換対象の Hub レコード。
-     * @param currentUserId Viewer's raw internal user id, if known. 判明していれば閲覧者の生内部ユーザー ID。
-     * @returns The detail structure. 変換した詳細構造。
-     */
-    const mapHubRecord = (scope: DailyReportViewerScope, row: HubRecord, currentUserId?: number): DailyReportDetail => {
-        const { hub, internal } = row
-
-        let content = hub.summary
-        let interviewers: DailyReportInterviewer[] = []
-        let category: string | null = null
-        let creationCategory: string | null = null
-        let visitTimeFrom: string | null = null
-        let visitTimeTo: string | null = null
-        let customerName: string | null = null
-        let employeeName: string | null = null
-        let externalComments: DailyReportExternalComment[] = []
-
-        // 外部ソースアダプタ優先 → Internal の順で表示フィールドを解決する
-        const adapter = externalSources.find((a) => a.sourceType === hub.sourceType)
-        const externalRow = adapter ? (row[`ext_${adapter.sourceType}`] as Record<string, unknown> | null | undefined) : undefined
-        if (adapter && externalRow) {
-            const fields = adapter.mapRow(externalRow)
-            if (fields.content !== undefined) content = fields.content
-            if (fields.employeeName !== undefined) employeeName = fields.employeeName
-            if (fields.category !== undefined) category = fields.category
-            if (fields.creationCategory !== undefined) creationCategory = fields.creationCategory
-            if (fields.visitTimeFrom !== undefined) visitTimeFrom = fields.visitTimeFrom
-            if (fields.visitTimeTo !== undefined) visitTimeTo = fields.visitTimeTo
-            if (fields.customerName !== undefined) customerName = fields.customerName
-            if (fields.interviewers !== undefined) interviewers = fields.interviewers
-            if (fields.externalComments !== undefined) externalComments = fields.externalComments
-        } else if (hub.sourceType === "Internal" && internal) {
-            content = internal.body
-            // Internal specific mappings if any
-        }
-
-        const labelsRaw = (row.labels ?? []).map((l) => ({
-            id: l.id,
-            name: l.name,
-            color: l.color,
-        }))
-        const postedCommentsRaw = row.postedCommentRows ?? []
-
-        // コメント次元がこの区分を拒否するなら、コメント 2 面を落として返す。
-        // ❗ 自分のコメントだけは常に残す (要件 5)。隠すと「UI に見えないのに削除だけできる」
-        //    非対称が生まれ、権限剥奪の瞬間に既存の自分のコメントが恒久的に削除不能になる。
-        //    外部由来 `externalComments` はユーザー ID を持たない構造なので区分単位の二値にしかできない
-        const commentsVisible = isSourceTypeVisible(scope.commentable, hub.sourceType)
-
-        // 作成区分がアプリ設定の下書き候補に合致する場合、ラベル一覧に下書きラベルが含まれるよう補完
-        const isCreationCategoryDraft = creationCategory ? draftLabelNames.includes(creationCategory) : false
-        // 同期関数なので DB へは問い合わせず、既に解決済みのキャッシュがある場合だけ補完する
-        const cachedPrimaryDraftLabelId = cachedDraftLabelIds?.[0] ?? null
-        if (isCreationCategoryDraft && cachedPrimaryDraftLabelId && !labelsRaw.some((l) => l.id === cachedPrimaryDraftLabelId)) {
-            labelsRaw.push({
-                id: cachedPrimaryDraftLabelId,
-                name: draftLabelName,
-                color: null,
-            })
-        }
-
-        return {
-            reportHubId: hub.id,
-            date: formatDateValue(hub.businessDate, "YYYY-MM-DD"),
-            author: row.creatorName ?? maskAuditActor(hub.createdBy) ?? "",
-            userId: hub.userId ? encodeUserId(hub.userId) : "",
-            sourceType: hub.sourceType ?? "Internal",
-            createdAt: formatDateValue(hub.createdAt, "YYYY-MM-DD HH:mm:ss"),
-            updatedAt: formatDateValue(hub.updatedAt, "YYYY-MM-DD HH:mm:ss"),
-            updatedBy: maskAuditActor(hub.updatedBy),
-            employeeName: employeeName ?? row.creatorName ?? maskAuditActor(hub.createdBy),
-            category,
-            creationCategory,
-            visitTimeFrom,
-            visitTimeTo,
-            customerName,
-            interviewers,
-            subject: hub.title,
-            content,
-            externalComments: commentsVisible ? externalComments : [],
-            isRead: row.isRead ?? false,
-            isStarred: row.isStarred ?? false,
-            labels: labelsRaw,
-            postedComments: postedCommentsRaw
-                .filter((c) => commentsVisible || (currentUserId !== undefined && c.userId === currentUserId))
-                .map((c) => ({
-                    ...c,
-                    userId: encodeUserId(c.userId),
-                    isMine: currentUserId ? c.userId === currentUserId : false,
-                })),
-            // `?? []` を書かない。HubRecord 側で必須にしてあるため、注入漏れはここではなく
-            // 呼び出し箇所でコンパイルエラーになる (それが検知したい事象)。
-            attachments: row.attachments,
-        }
-    }
-
-    /**
-     * Fetches daily report IDs alongside normalized business dates.
-     * 日報 ID と正規化済み営業日を取得する内部処理。
-     *
-     * ❗ 可視性述語は他の 3 経路 (営業日一覧 / 詳細取得 / 添付取得) と**意図的に 1 つ緩い**。
-     * ここだけ `isNull(DailyReportHub.userId)` を追加で許しており、投稿者を持たない
-     * 取込元の日報を一覧から消さないための緩和である。返すのは ID・営業日・ソース種別だけで
-     * 本文も添付も含まないため、緩めても内容は漏れない。
-     * この差分は無自覚なものではなく、`service.spec.ts` が明示的に表明して固定している。
-     * 他の 3 経路をこの形に合わせてはならない (合わせると内容が漏れる)。
-     *
-     * 区分 (sourceType) の可視性は緩和の対象外であり、他経路と完全に同一の条件を適用する。
-     *
-     * @param userId Internal numeric user id. 内部数値ユーザー ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Stream-ordered items. ストリーム順のアイテム一覧。
-     */
-    const fetchDailyReportIdsByUserId = async (scope: DailyReportViewerScope, userId: number): Promise<DailyReportItem[]> => {
-        const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
-        const draftLabelJoinIds = await getDraftLabelJoinIds()
-
-        const result = await db
-            .select<{ reportHubId: number; businessDate: Date | string | null; sourceType: string }>({
-                reportHubId: DailyReportHub.id,
-                businessDate: DailyReportHub.businessDate,
-                sourceType: DailyReportHub.sourceType,
-            })
-            .from(DailyReportHub)
-            .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
-            .where(and(isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DailyReportHub.userId), isNull(DraftLabelRelation.hubId)), visibleSourceTypeCondition(scope.visible)))
-            .orderBy(desc(DailyReportHub.businessDate), desc(DailyReportHub.id))
-
-        return result.map((item) => ({
-            ...item,
-            businessDate: formatDateValue(item.businessDate, "YYYY-MM-DD"),
-        }))
-    }
-
-    /**
-     * Fetches only the first page of report ids for time-to-first-render (uncached).
-     * 最初の描画までの時間専用に、ID 一覧の先頭ページだけを取得する内部処理 (キャッシュ無し)。
-     *
-     * `ids-stream` の新規接続でキャッシュミスした場合、全量クエリの確定を待たずに
-     * この軽量クエリ (TOP n・インデックス順で n 行走査した時点で打ち切り) の結果を
-     * 最初のチャンクとして送出する。可視性述語と並び順は全量クエリと完全同一。
-     * `.top(n)` は `.select()` の直後でなければならない (drizzle-mssql の構造的制約)。
-     *
-     * @param externalId External user id. 外部ユーザー ID。
-     * @param limit Page size. ページサイズ。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns First-page items in stream order. ストリーム順の先頭ページ。
-     */
-    const getDailyReportIdsFirstPageByExternalId = async (scope: DailyReportViewerScope, externalId: string, limit: number): Promise<DailyReportItem[]> => {
-        const userId = await getUserIdByExternalId(externalId)
-        if (!userId) {
-            return []
-        }
-        // 全拒否なら DB を引かずに空を返す (0 件 = fail-close)
-        if (deniesEverySourceType(scope.visible)) {
-            return []
-        }
-        const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
-        const draftLabelJoinIds = await getDraftLabelJoinIds()
-
-        const result = await db
-            .select<{ reportHubId: number; businessDate: Date | string | null; sourceType: string }>({
-                reportHubId: DailyReportHub.id,
-                businessDate: DailyReportHub.businessDate,
-                sourceType: DailyReportHub.sourceType,
-            })
-            .top(limit)
-            .from(DailyReportHub)
-            .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
-            .where(and(isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DailyReportHub.userId), isNull(DraftLabelRelation.hubId)), visibleSourceTypeCondition(scope.visible)))
-            .orderBy(desc(DailyReportHub.businessDate), desc(DailyReportHub.id))
-
-        return result.map((item) => ({
-            ...item,
-            businessDate: formatDateValue(item.businessDate, "YYYY-MM-DD"),
-        }))
-    }
-
-    /**
-     * Fetches daily report details for the provided business date.
-     * 指定した営業日の日報詳細を取得する内部処理。
-     */
-    const fetchDailyReportsByBusinessDate = async (scope: DailyReportViewerScope, normalizedBusinessDate: string): Promise<DailyReportDetail[]> => {
-        const rows = await applyExternalJoins(
-            db
-                .select<HubQueryRow>({
-                    hub: cols(DailyReportHub),
-                    internal: cols(DailyReportInternal),
-                    creatorName: users.displayName,
-                    ...externalSelections(),
-                })
-                .from(DailyReportHub),
-        )
-            .leftJoin(DailyReportInternal, eq(DailyReportHub.id, DailyReportInternal.hubId))
-            .leftJoin(users, eq(DailyReportHub.userId, users.id))
-            .where(and(eq(DailyReportHub.businessDate, sql`${normalizedBusinessDate}`), isNull(DailyReportHub.deletedAt), visibleSourceTypeCondition(scope.visible)))
-            .orderBy(desc(DailyReportHub.id))
-
-        const attachmentsMap = await getAttachmentsByHubIds(rows.map((r) => r.hub.id))
-        return rows.map((row) => mapHubRecord(scope, { ...row, attachments: attachmentsMap.get(row.hub.id) ?? [] }))
-    }
-
-    /**
-     * Builds a deterministic cache key for business-date caches.
-     * 営業日キャッシュ用の一意キーを生成する処理。
-     */
-    const buildBusinessDateCacheKey = (normalizedBusinessDate: string): string => {
-        return `${DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX}${normalizedBusinessDate}`
-    }
-
-    /**
-     * Resolves the internal user ID from an external ID (with process-local caching).
-     * 外部 ID から内部ユーザー ID を解決する (プロセス内キャッシュ付き)。
-     */
-    const userIdCache = new Map<string, number>()
-
-    const getUserIdByExternalId = async (externalId: string): Promise<number | null> => {
-        if (!config.disableUserIdCache && userIdCache.has(externalId)) {
-            return userIdCache.get(externalId) ?? null
-        }
-
-        const userId = await resolveUserId(externalId)
-        if (userId !== null && !config.disableUserIdCache) {
-            userIdCache.set(externalId, userId)
-        }
-        return userId
-    }
-
-    /**
-     * Retrieves daily report IDs and their normalized business dates.
-     * 日報 ID と正規化済み営業日を取得する処理。
-     *
-     * @param externalId External user id. 外部ユーザー ID。
-     * @param options Cache query options. キャッシュ問い合わせオプション。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Stream-ordered items. ストリーム順のアイテム一覧。
-     */
-    const getDailyReportIdsByExternalId = async (scope: DailyReportViewerScope, externalId: string, { forceRefresh = false, snapshot = false, ttlMsOverride, onFetchStart }: SqlResultCacheQueryOptions & { onFetchStart?: () => void } = {}): Promise<DailyReportItem[]> => {
-        const userId = await getUserIdByExternalId(externalId)
-        if (!userId) {
-            return []
-        }
-        // 全拒否なら DB を引かずに空を返す (0 件 = fail-close)
-        if (deniesEverySourceType(scope.visible)) {
-            return []
-        }
-
-        // 可視集合ごとに別バケットへ隔離する (権限変更後に旧結果を配信しない)
-        const cacheKey = idsCacheKey(userId, computeViewerScopeDigest(scope))
-        return sqlResultCache.getOrFetch<DailyReportItem>({
-            cacheKey,
-            fetcher: async () => {
-                const res = await fetchDailyReportIdsByUserId(scope, userId)
-                // ❗ 並んでいない配列はカーソル再開の前提を破る (findIdsStreamResumeIndex は
-                //    比較器で「最初に後ろへ来る位置」を探すため、並びが崩れていると誤った位置から
-                //    再開する)。原因は SQL の ORDER BY と compareIdsStreamOrder の乖離、または
-                //    RCSI の無い配備でのスキャン中の行移動 (実運用 DB は dev / 本番とも
-                //    READ_COMMITTED_SNAPSHOT = ON を実機確認済みで、その配備では後者は起きない —
-                //    2026-08-15 検証)。fetcher 内で治癒するのは、
-                //    ①検査が fetch 1 回につき 1 度で済み ②バケットとスナップショットトークンが
-                //    治癒済み配列を見る、の両方を成立させるため。
-                //    ❗ 並べ直しても欠落・重複は直らない — 直るのはカーソル再開の二次被害だけ
-                if (!isIdsStreamOrdered(res)) {
-                    logger.warn("[DailyReportService] ids array is not in stream order; re-sorting (check SQL ORDER BY vs compareIdsStreamOrder, or concurrent row movement during the scan)")
-                    return [...res].sort(compareIdsStreamOrder)
-                }
-                return res
-            },
-            // 本呼び出しが実際に全量クエリを起動した瞬間だけ合図する (バケットヒット・相乗り・
-            // refresh-ahead では呼ばれない)。ids ストリームはこれを高速先頭ページ起動の
-            // 因果的な前提条件に使う
-            onFetchStart,
-            forceRefresh,
-            snapshot,
-            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_IDS_TTL_MS,
-            epochKey: DAILY_REPORT_IDS_EPOCH_KEY,
-            // TTL の半分を過ぎたヒットは、返却後に裏で 1 本だけ再フェッチして差し替える。
-            // 90 秒に 1 回以上アクセスがある限り、対話リクエストはコールド (全量再クエリ) を踏まない
-            refreshAheadRatio: 0.5,
-        }) as Promise<DailyReportItem[]>
-    }
-
-    /**
-     * Retrieves daily report details for a business date (⚠️ NOT per-user filtered).
-     * 指定した営業日に紐づく日報詳細を取得する処理 (⚠️ ユーザー別フィルタなし)。
-     *
-     * ⚠️ SECURITY: この関数は下書きラベルによる可視性フィルタ (他ユーザーの下書きを隠す) と
-     * ユーザー別の既読/スター状態を **適用しない**。取得結果は全ユーザーの下書きを含み得るため、
-     * HTTP レスポンス / SSR loader / SSE へ **直接返してはならない**。ユーザー向け配信には
-     * 必ず {@link getDailyReportsByBusinessDateByExternalId} を使うこと。
-     * (本関数は管理・バッチ・テスト用途に限定する。)
-     */
-    const getDailyReportsByBusinessDate = (scope: DailyReportViewerScope, businessDate: string, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail[]> => {
-        const normalizedBusinessDate = normalizeBusinessDateKey(businessDate)
-        if (!normalizedBusinessDate) {
-            return Promise.resolve([])
-        }
-        // 全拒否なら DB を引かずに空を返す (0 件 = fail-close)
-        if (deniesEverySourceType(scope.visible)) {
-            return Promise.resolve([])
-        }
-
-        return sqlResultCache.getOrFetch<DailyReportDetail>({
-            // 可視集合ごとに別バケットへ隔離する (管理経路でも権限混在を起こさない)
-            cacheKey: `${buildBusinessDateCacheKey(normalizedBusinessDate)}:st:${computeViewerScopeDigest(scope)}`,
-            fetcher: () => fetchDailyReportsByBusinessDate(scope, normalizedBusinessDate),
-            forceRefresh,
-            snapshot,
-            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_BUSINESS_DATE_TTL_MS,
-        }) as Promise<DailyReportDetail[]>
-    }
-
-    /**
-     * Retrieves every label id that counts as a draft.
-     * 下書きとみなすラベル ID を**すべて**取得する処理 (キャッシュ付き)。
-     *
-     * ❗ 可視性述語は必ずこちら (複数形) を使うこと。`draftLabelNames` には複数のラベル名を
-     * 注入できる (取込元ごとに下書きの呼び名が違うため) のに、1 個の ID だけで結合すると
-     * **2 つ目以降の下書きラベルが付いた日報が誰にでも可視になる**。
-     * 名前が 1 つも解決できない場合は空配列を返し、呼び出し側は結合対象を
-     * 「存在しない ID」にして「下書きは存在しない」と解釈する。
-     *
-     * @returns Draft label ids, ascending. 昇順の下書きラベル ID 群。
-     */
-    let cachedDraftLabelIds: number[] | null = null
-    const getDraftLabelIds = async (): Promise<number[]> => {
-        if (cachedDraftLabelIds !== null) return cachedDraftLabelIds
-        const rows = await db.select<{ id: number }>({ id: DailyReportLabel.id }).from(DailyReportLabel).where(inArray(DailyReportLabel.name, draftLabelNames)).orderBy(DailyReportLabel.id)
-        cachedDraftLabelIds = rows.map((row) => row.id)
-        return cachedDraftLabelIds
-    }
-
-    /**
-     * Join targets for the draft-label relation, safe when no draft label exists.
-     * 下書きラベル関連の結合対象。下書きラベルが 1 件も無い場合でも安全に働く値。
-     *
-     * `inArray` に空配列を渡すと方言によっては構文エラーや常に真になりうるため、
-     * 実在しない ID (`-1`) を 1 個入れて「どの行にも一致しない」ことを明示する。
-     *
-     * @returns Ids to join on. 結合に使う ID 群。
-     */
-    const getDraftLabelJoinIds = async (): Promise<number[]> => {
-        const ids = await getDraftLabelIds()
-        return ids.length > 0 ? ids : [-1]
-    }
-
-    /**
-     * Retrieves the canonical draft label id used when creating a draft.
-     * 下書きを作成するときに付与する代表の下書きラベル ID を取得する処理。
-     *
-     * 付与は 1 個に決めなければならないため `draftLabelNames` の先頭に対応する ID を返す。
-     * **可視性判定には使わないこと** (`getDraftLabelIds` を使う)。
-     *
-     * @returns The canonical draft label id, or null when it does not exist. 代表の下書きラベル ID (存在しなければ null)。
-     */
-    const getDraftLabelId = async (): Promise<number | null> => {
-        const ids = await getDraftLabelIds()
-        if (ids.length === 0) return null
-        // 先頭の名前に対応する ID を選ぶ。ID 順ではなく注入順を正とする (代表名は draftLabelName)
-        const [primary] = await db.select<{ id: number }>({ id: DailyReportLabel.id }).top(1).from(DailyReportLabel).where(eq(DailyReportLabel.name, draftLabelName))
-        return primary?.id ?? ids[0]
-    }
-
-    /**
-     * Derives the tri-state verification status of an attachment's backing object.
-     * 添付ファイル実体の検証状態 (三値) を導出する処理。
-     *
-     * 判定不能 (`unknown`) を `absent` へ丸めない。存在確認そのものが失敗した場合を
-     * 偽の真偽で埋めると、一時的な権限・通信障害が「消失」として表示される。
-     */
-    const deriveAttachmentState = (checkedAt: Date | string | null, missingAt: Date | string | null): DailyReportAttachmentSummary["state"] => {
-        if (missingAt != null) return "absent"
-        if (checkedAt != null) return "present"
-        return "unknown"
-    }
-
-    /**
-     * Fetches attachments for multiple hubs in one query, keyed by hub id.
-     * 複数 hub の添付ファイルを 1 クエリで取得し hub ID をキーにまとめる処理。
-     *
-     * 一覧描画は N 件の日報を同時に返すため、日報ごとに問い合わせると N+1 になる。
-     * ラベル・コメントと同じ一括取得の流儀に揃える。
-     *
-     * @param hubIds Hub ids to fetch attachments for. 添付を取得する hub ID 群。
-     * @returns Attachments grouped by hub id. hub ID ごとにまとめた添付一覧。
-     */
-    const getAttachmentsByHubIds = async (hubIds: number[]): Promise<Map<number, DailyReportAttachmentSummary[]>> => {
-        const map = new Map<number, DailyReportAttachmentSummary[]>()
-        const attachment = tables.attachment
-        // codec は config 直参照。createDailyReportService の分割代入は 8 キーのみで、
-        // 裸の識別子として書くと TS2304 になる (任意設定は config.x で読むのがこのファイルの様式)
-        const codec = config.attachmentIdCodec
-        if (hubIds.length === 0 || !attachment || !codec) {
-            return map
-        }
-
-        const rows = await db
-            .select<{ id: number; hubId: number; fileName: string; fileType: string | null; fileSize: number | null; createdAt: Date | string | null; objectCheckedAt: Date | string | null; objectMissingAt: Date | string | null }>({
-                id: attachment.id,
-                hubId: attachment.hubId,
-                fileName: attachment.fileName,
-                fileType: attachment.fileType,
-                fileSize: attachment.fileSize,
-                createdAt: attachment.createdAt,
-                objectCheckedAt: attachment.objectCheckedAt,
-                objectMissingAt: attachment.objectMissingAt,
-            })
-            .from(attachment)
-            .where(inArray(attachment.hubId, hubIds))
-            .orderBy(asc(attachment.createdAt), asc(attachment.id))
-
-        for (const row of rows) {
-            // 内部数値 ID はここで難読化トークンへ変換する。以降クライアントへ生 ID は出ない。
-            // `uploaded_by` / `created_by` / `updated_by` / `file_path` は選択もしない
-            const item: DailyReportAttachmentSummary = {
-                id: codec.encode(Number(row.id)),
-                fileName: String(row.fileName),
-                fileType: row.fileType ? String(row.fileType) : null,
-                fileSize: row.fileSize != null ? Number(row.fileSize) : null,
-                createdAt: formatDateValue(row.createdAt, "YYYY-MM-DD HH:mm:ss"),
-                state: deriveAttachmentState(row.objectCheckedAt, row.objectMissingAt),
-            }
-            const list = map.get(Number(row.hubId))
-            if (list) {
-                list.push(item)
-            } else {
-                map.set(Number(row.hubId), [item])
-            }
-        }
-
-        return map
-    }
-
-    /**
-     * Fetches one attachment together with its visibility check for a given user.
-     * 指定ユーザーの可視性判定込みで添付ファイル 1 件を取得する処理。
-     *
-     * 認可は SQL 側で完結させる。アプリ層のフィルタリングに依存しない。
-     * 認可されない / 存在しない / 親日報が論理削除済みのいずれでも `null` を返すため、
-     * 呼び出し側は 403 と 404 を区別せず 404 とすること (存在オラクル回避)。
-     *
-     * 本関数は意図的に `SqlResultCache.getOrFetch` を通さない。これは読み取りキャッシュではなく
-     * リクエストごとの**認可判定**であり、結果をキャッシュするとユーザーを跨いで再利用されうる。
-     *
-     * @param attachmentId Internal numeric attachment id. 内部数値の添付 ID。
-     * @param userId Internal numeric user id of the viewer. 閲覧者の内部数値ユーザー ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Attachment row when visible, otherwise null. 可視なら添付行、それ以外は null。
-     */
-    const getAttachmentForUser = async (scope: DailyReportViewerScope, attachmentId: number, userId: number): Promise<{ fileName: string; filePath: string; fileType: string | null; fileSize: number | null } | null> => {
-        const attachment = tables.attachment
-        if (!attachment) {
-            return null
-        }
-        // 全拒否なら DB を引かずに null を返す (0 件 = fail-close)
-        if (deniesEverySourceType(scope.visible)) {
-            return null
-        }
-        const draftLabelJoinIds = await getDraftLabelJoinIds()
-        const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
-
-        // `.top(1)` は `.select()` の直後でなければならない。drizzle-mssql は top() を
-        // db.select() が返す MsSqlSelectBuilder にしか定義しておらず、.from() 以降のクラスには
-        // 存在しない。誤った順序は型 (構造型 SelectChain が全段階に top を宣言) でも
-        // 単体テスト (モックが全段階で top を返す) でも検出されず、本番で TypeError になる。
-        const rows = await db
-            .select<{ fileName: string; filePath: string; fileType: string | null; fileSize: number | null }>({
-                fileName: attachment.fileName,
-                filePath: attachment.filePath,
-                fileType: attachment.fileType,
-                fileSize: attachment.fileSize,
-            })
-            .top(1)
-            .from(attachment)
-            .innerJoin(DailyReportHub, eq(DailyReportHub.id, attachment.hubId))
-            .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
-            .where(and(eq(attachment.id, attachmentId), isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DraftLabelRelation.hubId)), visibleSourceTypeCondition(scope.visible)))
-
-        return rows[0] ?? null
-    }
-
-    /**
-     * Records that an attachment's backing object was confirmed missing.
-     * 添付ファイルの実体が消失していたことを記録する処理。
-     *
-     * 実配信で `not_found` を得たときに呼ぶ。次回描画で三値が `absent` になる。
-     * 記録の失敗は配信結果に影響させない (呼び出し側は await しない)。
-     *
-     * @param attachmentId Internal numeric attachment id. 内部数値の添付 ID。
-     */
-    const markAttachmentMissing = async (attachmentId: number): Promise<void> => {
-        const attachment = tables.attachment
-        if (!attachment) return
-        const now = new Date()
-        try {
-            await db.update(attachment).set({ objectCheckedAt: now, objectMissingAt: now, updatedAt: now }).where(eq(attachment.id, attachmentId))
-        } catch (error) {
-            logger.error("markAttachmentMissing failed", error)
-        }
-    }
-
-    /**
-     * Records that an attachment's backing object was confirmed present.
-     * 添付ファイルの実体が存在していたことを記録する処理。
-     *
-     * `markAttachmentMissing` と対にすること。消失記録が一方向だと、一時的な障害で
-     * 一度 `absent` が立った添付は UI がリンクを描画しなくなり (押しても 404 なので当然)、
-     * **利用者が再取得を発火させる手段そのものが消える**。実体が戻っても手動の
-     * 一括検証を回すまで復帰しない。配信が 200 で成功した時点で解除するのが唯一の
-     * 自動回復経路である。
-     *
-     * 記録の失敗は配信結果に影響させない (呼び出し側は await しない)。
-     *
-     * @param attachmentId Internal numeric attachment id. 内部数値の添付 ID。
-     */
-    const markAttachmentPresent = async (attachmentId: number): Promise<void> => {
-        const attachment = tables.attachment
-        if (!attachment) return
-        const now = new Date()
-        try {
-            await db.update(attachment).set({ objectCheckedAt: now, objectMissingAt: null, updatedAt: now }).where(eq(attachment.id, attachmentId))
-        } catch (error) {
-            logger.error("markAttachmentPresent failed", error)
-        }
-    }
-
-    /**
-     * Retrieves daily report details for a business date with user-specific status and relations.
-     * 指定した営業日の日報詳細を、ユーザー状態と関連データを含めて取得する。
-     */
-    const getDailyReportsByBusinessDateByExternalId = async (scope: DailyReportViewerScope, businessDate: string, externalId: string, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail[]> => {
-        const userId = await getUserIdByExternalId(externalId)
-        if (!userId) {
-            return []
-        }
-
-        const normalizedBusinessDate = normalizeBusinessDateKey(businessDate)
-        if (!normalizedBusinessDate) {
-            return []
-        }
-        // 全拒否なら DB を引かずに空を返す (0 件 = fail-close)
-        if (deniesEverySourceType(scope.visible)) {
-            return []
-        }
-
-        // 可視集合ごとに別バケットへ隔離する (権限変更後に旧結果を配信しない)
-        const cacheKey = dateCacheKey(normalizedBusinessDate, userId, computeViewerScopeDigest(scope))
-
-        return sqlResultCache.getOrFetch<DailyReportDetail>({
-            cacheKey,
-            fetcher: async () => {
-                const draftLabelJoinIds = await getDraftLabelJoinIds()
-                const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
-
-                const rows = await applyExternalJoins(
-                    db
-                        .select<HubQueryRow>({
-                            hub: cols(DailyReportHub),
-                            internal: cols(DailyReportInternal),
-                            isRead: DailyReportUserStatus.isRead,
-                            isStarred: DailyReportUserStatus.isStarred,
-                            creatorName: users.displayName,
-                            ...externalSelections(),
-                        })
-                        .from(DailyReportHub),
-                )
-                    .leftJoin(DailyReportInternal, eq(DailyReportHub.id, DailyReportInternal.hubId))
-                    .leftJoin(DailyReportUserStatus, and(eq(DailyReportHub.id, DailyReportUserStatus.hubId), eq(DailyReportUserStatus.userId, userId)))
-                    .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
-                    .leftJoin(users, eq(DailyReportHub.userId, users.id))
-                    .where(and(eq(DailyReportHub.businessDate, sql`${normalizedBusinessDate}`), isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DraftLabelRelation.hubId)), visibleSourceTypeCondition(scope.visible)))
-                    .orderBy(desc(DailyReportHub.id))
-
-                if (rows.length === 0) {
-                    return []
-                }
-
-                const hubIds = rows.map((r) => r.hub.id)
-
-                // Drizzle ORM batch queries to fetch labels and comments
-                const allLabels = await db
-                    .select<{ hubId: number; id: number; name: string; color: string | null }>({
-                        hubId: DailyReportHub_Label.hubId,
-                        id: DailyReportLabel.id,
-                        name: DailyReportLabel.name,
-                        color: DailyReportLabel.color,
-                    })
-                    .from(DailyReportHub_Label)
-                    .innerJoin(DailyReportLabel, eq(DailyReportHub_Label.labelId, DailyReportLabel.id))
-                    .where(inArray(DailyReportHub_Label.hubId, hubIds))
-
-                const allComments = await db
-                    .select<{ hubId: number; id: number; body: string; createdAt: Date | string; userId: number; userName: string | null }>({
-                        hubId: DailyReportCommentModel.hubId,
-                        id: DailyReportCommentModel.id,
-                        body: DailyReportCommentModel.body,
-                        createdAt: DailyReportCommentModel.createdAt,
-                        userId: DailyReportCommentModel.userId,
-                        userName: users.displayName,
-                    })
-                    .from(DailyReportCommentModel)
-                    .leftJoin(users, eq(DailyReportCommentModel.userId, users.id))
-                    .where(inArray(DailyReportCommentModel.hubId, hubIds))
-                    .orderBy(asc(DailyReportCommentModel.createdAt))
-
-                // 添付も同じ流儀で一括取得する (日報ごとに引くと N+1 になる)
-                const attachmentsMap = await getAttachmentsByHubIds(hubIds)
-
-                const labelsMap = new Map<number, RawJsonLabel[]>()
-                const commentsMap = new Map<number, RawJsonComment[]>()
-
-                for (const label of allLabels) {
-                    let list = labelsMap.get(label.hubId)
-                    if (!list) {
-                        list = []
-                        labelsMap.set(label.hubId, list)
-                    }
-                    list.push({
-                        id: label.id,
-                        name: label.name,
-                        color: label.color,
-                    })
-                }
-
-                for (const comment of allComments) {
-                    let list = commentsMap.get(comment.hubId)
-                    if (!list) {
-                        list = []
-                        commentsMap.set(comment.hubId, list)
-                    }
-                    list.push({
-                        id: comment.id,
-                        content: comment.body,
-                        createdAt: formatDateValue(comment.createdAt, "YYYY-MM-DD HH:mm:ss") || "",
-                        userId: comment.userId,
-                        userName: comment.userName || "",
-                    })
-                }
-
-                return rows.map((row) => {
-                    const hubId = row.hub.id
-                    return mapHubRecord(
-                        scope,
-                        {
-                            ...row,
-                            attachments: attachmentsMap.get(hubId) ?? [],
-                            labels: labelsMap.get(hubId) || [],
-                            postedCommentRows: commentsMap.get(hubId) || [],
-                        },
-                        userId,
-                    )
-                })
-            },
-            forceRefresh,
-            snapshot,
-            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_BUSINESS_DATE_TTL_MS,
-            epochKey: `${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedBusinessDate}`,
-        }) as Promise<DailyReportDetail[]>
-    }
-
-    /**
-     * Retrieves a single daily report detail by ID with user-specific status and relations.
-     * 指定した日報詳細を、ユーザー状態と関連データを含めて取得する。
-     *
-     * 可視性の述語は営業日一覧 (`getDailyReportsByBusinessDateByExternalId`) および
-     * `getAttachmentForUser` と同一に保つこと。3 経路のどれか 1 つだけ緩いと、
-     * 緩い経路がメタデータ (件名・本文・添付のファイル名やトークン) を渡してしまい、
-     * 「SQL 述語が唯一の認可境界」という不変条件が崩れる。
-     * 4 番目の経路である `fetchDailyReportIdsByUserId` だけは意図的に 1 つ緩い
-     * (返すのが ID・営業日・ソース種別のみのため)。詳細は同関数の docstring を参照。
-     *
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param userId Internal numeric user id of the viewer. 閲覧者の内部数値ユーザー ID。
-     * @param options Cache query options. キャッシュ問い合わせオプション。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Detail when visible, otherwise null. 可視なら詳細、そうでなければ null。
-     */
-    const getDailyReportDetailById = async (scope: DailyReportViewerScope, reportHubId: number, userId: number, { forceRefresh = false, snapshot = false, ttlMsOverride }: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail | null> => {
-        // 全拒否なら DB を引かずに null を返す (0 件 = fail-close)
-        if (deniesEverySourceType(scope.visible)) {
-            return null
-        }
-
-        // 可視集合ごとに別バケットへ隔離する (権限変更後に旧結果を配信しない)
-        const cacheKey = detailCacheKey(reportHubId, userId, computeViewerScopeDigest(scope))
-
-        const results = (await sqlResultCache.getOrFetch<DailyReportDetail>({
-            cacheKey,
-            fetcher: async () => {
-                const draftLabelJoinIds = await getDraftLabelJoinIds()
-                const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
-
-                const rows = await applyExternalJoins(
-                    db
-                        .select<HubQueryRow>({
-                            hub: cols(DailyReportHub),
-                            internal: cols(DailyReportInternal),
-                            isRead: DailyReportUserStatus.isRead,
-                            isStarred: DailyReportUserStatus.isStarred,
-                            creatorName: users.displayName,
-                            ...externalSelections(),
-                        })
-                        .from(DailyReportHub),
-                )
-                    .leftJoin(DailyReportInternal, eq(DailyReportHub.id, DailyReportInternal.hubId))
-                    .leftJoin(DailyReportUserStatus, and(eq(DailyReportHub.id, DailyReportUserStatus.hubId), eq(DailyReportUserStatus.userId, userId)))
-                    .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
-                    .leftJoin(users, eq(DailyReportHub.userId, users.id))
-                    .where(and(eq(DailyReportHub.id, reportHubId), isNull(DailyReportHub.deletedAt), or(eq(DailyReportHub.userId, userId), isNull(DraftLabelRelation.hubId)), visibleSourceTypeCondition(scope.visible)))
-
-                if (rows.length === 0) {
-                    return []
-                }
-
-                const hubId = rows[0].hub.id
-
-                // Fetch labels and comments via Drizzle ORM
-                const labels = await db
-                    .select<{ id: number; name: string; color: string | null }>({
-                        id: DailyReportLabel.id,
-                        name: DailyReportLabel.name,
-                        color: DailyReportLabel.color,
-                    })
-                    .from(DailyReportHub_Label)
-                    .innerJoin(DailyReportLabel, eq(DailyReportHub_Label.labelId, DailyReportLabel.id))
-                    .where(eq(DailyReportHub_Label.hubId, hubId))
-
-                const comments = await db
-                    .select<{ id: number; body: string; createdAt: Date | string; userId: number; userName: string | null }>({
-                        id: DailyReportCommentModel.id,
-                        body: DailyReportCommentModel.body,
-                        createdAt: DailyReportCommentModel.createdAt,
-                        userId: DailyReportCommentModel.userId,
-                        userName: users.displayName,
-                    })
-                    .from(DailyReportCommentModel)
-                    .leftJoin(users, eq(DailyReportCommentModel.userId, users.id))
-                    .where(eq(DailyReportCommentModel.hubId, hubId))
-                    .orderBy(asc(DailyReportCommentModel.createdAt))
-
-                const attachmentsMap = await getAttachmentsByHubIds([hubId])
-
-                const labelsMapped = labels.map((l) => ({
-                    id: l.id,
-                    name: l.name,
-                    color: l.color,
-                }))
-
-                const commentsMapped = comments.map((c) => ({
-                    id: c.id,
-                    content: c.body,
-                    createdAt: formatDateValue(c.createdAt, "YYYY-MM-DD HH:mm:ss") || "",
-                    userId: c.userId,
-                    userName: c.userName || "",
-                }))
-
-                return [
-                    mapHubRecord(
-                        scope,
-                        {
-                            ...rows[0],
-                            attachments: attachmentsMap.get(hubId) ?? [],
-                            labels: labelsMapped,
-                            postedCommentRows: commentsMapped,
-                        },
-                        userId,
-                    ),
-                ]
-            },
-            forceRefresh,
-            snapshot,
-            ttlMsOverride: ttlMsOverride ?? DAILY_REPORT_BUSINESS_DATE_TTL_MS,
-            epochKey: `${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`,
-        })) as DailyReportDetail[]
-
-        return results[0] ?? null
-    }
-
-    /**
-     * Retrieves a single daily report detail by ID with user-specific status and relations.
-     * 指定した日報詳細を、ユーザー状態と関連データを含めて取得する。
-     *
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param externalId External user id. 外部ユーザー ID。
-     * @param options Cache query options. キャッシュ問い合わせオプション。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Detail when visible, otherwise null. 可視なら詳細、そうでなければ null。
-     */
-    const getDailyReportDetailByIdByExternalId = async (scope: DailyReportViewerScope, reportHubId: number, externalId: string, options: SqlResultCacheQueryOptions = {}): Promise<DailyReportDetail | null> => {
-        const userId = await getUserIdByExternalId(externalId)
-        if (!userId) {
-            return null
-        }
-        // ❗ 受け取った可視集合はそのまま透過する。ここで null へ潰すと外部 ID 経由の詳細取得だけ
-        //    フィルタが外れる (内部の create/update/publish が明示 null を渡すのとは別物)
-        return getDailyReportDetailById(scope, reportHubId, userId, options)
-    }
-
-    /**
-     * Loads the gate columns of a hub for a mutation, or null when it does not exist.
-     * ミューテーション用に hub のゲート列を取得する処理 (存在しなければ null)。
-     *
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @returns Source type and deletion marker, or null. ソース種別と論理削除印 (無ければ null)。
-     */
-    const findHubGateColumns = async (reportHubId: number, userId: number): Promise<{ sourceType: string; deletedAt: Date | string | null } | null> => {
-        const draftLabelJoinIds = await getDraftLabelJoinIds()
-        const DraftLabelRelation = aliasedTable(DailyReportHub_Label as unknown as Parameters<typeof aliasedTable>[0], "draft_label") as unknown as typeof DailyReportHub_Label
-
-        // ❗ 可視性の述語は読み取り経路と同一に保つ。下書き条項を落とすと、閲覧できないはずの
-        //    他人の下書きに対して既読 / スター / コメントを付けられる (書き込み可能な存在オラクル)
-        const [hub] = await db
-            .select<{ sourceType: string; deletedAt: Date | string | null }>({ sourceType: DailyReportHub.sourceType, deletedAt: DailyReportHub.deletedAt })
-            .top(1)
-            .from(DailyReportHub)
-            .leftJoin(DraftLabelRelation, and(eq(DraftLabelRelation.hubId, DailyReportHub.id), inArray(DraftLabelRelation.labelId, draftLabelJoinIds)))
-            .where(and(eq(DailyReportHub.id, reportHubId), or(eq(DailyReportHub.userId, userId), isNull(DraftLabelRelation.hubId))))
-        return hub ?? null
-    }
-
-    /**
-     * Rejects a status mutation targeting a missing, deleted, or invisible report.
-     * 不存在・論理削除済み・不可視区分の日報に対する状態更新を拒否する処理。
-     *
-     * 認可失敗と不存在を区別せず一律 `Not Found` にする (存在オラクルの回避)。従来は hub を
-     * 一切検証せず任意の `reportHubId` へ upsert できたため、その穴も同時に塞ぐ。
-     *
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Nothing; throws when rejected. なし (拒否時は例外送出)。
-     */
-    const assertHubMutable = async (scope: DailyReportViewerScope, reportHubId: number, userId: number): Promise<void> => {
-        const hub = await findHubGateColumns(reportHubId, userId)
-        if (!hub || hub.deletedAt || !isSourceTypeVisible(scope.visible, hub.sourceType)) {
-            throw new Error("Not Found")
-        }
-    }
-
-    /**
-     * Sets the starred status of a daily report for a user.
-     * ユーザーの日報スター状態を設定する。
-     *
-     * @param userId Internal numeric user id. 内部数値ユーザー ID。
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param businessDate Business date for cache invalidation. キャッシュ無効化に使う営業日。
-     * @param isStarred Desired star state. 設定するスター状態。
-     * @param clientTempId Optimistic-update correlation id. 楽観更新の相関 ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Updated status row. 更新後の状態行。
-     */
-    const setStarStatus = async (scope: DailyReportViewerScope, userId: number, reportHubId: number, businessDate: string | null, isStarred: boolean, clientTempId: string): Promise<DailyReportUserStatusRow> => {
-        // 不可視区分・不存在・削除済みへの書き込みを先に弾く
-        await assertHubMutable(scope, reportHubId, userId)
-
-        const existing = await db
-            .select<DailyReportUserStatusRow>()
-            .top(1)
-            .from(DailyReportUserStatus)
-            .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
-
-        let updatedStatus: DailyReportUserStatusRow
-
-        if (existing.length > 0) {
-            if (existing[0].isStarred !== isStarred) {
-                const rows = await db
-                    .update<DailyReportUserStatusRow>(DailyReportUserStatus)
-                    .set({
-                        isStarred: isStarred,
-                        updatedAt: new Date(),
-                        updatedBy: String(userId),
-                    })
-                    .output()
-                    .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
-                updatedStatus = rows[0]
-            } else {
-                updatedStatus = existing[0]
-            }
-        } else {
-            const rows = await db
-                .insert<DailyReportUserStatusRow>(DailyReportUserStatus)
-                .output()
-                .values({
-                    hubId: reportHubId,
-                    userId,
-                    isStarred: isStarred,
-                    isRead: false,
-                    createdAt: new Date(),
-                    createdBy: String(userId),
-                    updatedAt: new Date(),
-                    updatedBy: String(userId),
-                })
-            updatedStatus = rows[0]
-        }
-
-        if (businessDate) {
-            const normalizedDate = normalizeBusinessDateKey(businessDate)
-            if (normalizedDate) {
-                // 可視集合ダイジェスト付きキーを取りこぼさないよう接頭辞で消す
-                sqlResultCache.invalidatePrefix(dateUserPrefix(normalizedDate, userId))
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
-            }
-        }
-        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
-        // 可視集合ダイジェスト付きキーを取りこぼさないよう接頭辞で消す
-        sqlResultCache.invalidatePrefix(detailUserPrefix(reportHubId, userId))
-        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
-
-        await publishToSseStream(
-            statusUpdateMessageSchema.parse({
-                type: "status-update",
-                reportHubId: reportHubId,
-                recipientRawUserId: userId,
-                statusType: "star",
-                value: isStarred,
-                clientTempId,
-            }),
-            "setStarStatus",
-        )
-
-        return updatedStatus
-    }
-
-    /**
-     * Sets the read status of a daily report for a user.
-     * ユーザーの日報既読状態を設定する。
-     *
-     * @param userId Internal numeric user id. 内部数値ユーザー ID。
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param businessDate Business date for cache invalidation. キャッシュ無効化に使う営業日。
-     * @param isRead Desired read state. 設定する既読状態。
-     * @param clientTempId Optimistic-update correlation id. 楽観更新の相関 ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Updated status row. 更新後の状態行。
-     */
-    const setReadStatus = async (scope: DailyReportViewerScope, userId: number, reportHubId: number, businessDate: string | null, isRead: boolean, clientTempId: string): Promise<DailyReportUserStatusRow> => {
-        // 不可視区分・不存在・削除済みへの書き込みを先に弾く
-        await assertHubMutable(scope, reportHubId, userId)
-
-        const existing = await db
-            .select<DailyReportUserStatusRow>()
-            .top(1)
-            .from(DailyReportUserStatus)
-            .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
-
-        let updatedStatus: DailyReportUserStatusRow
-
-        if (existing.length > 0) {
-            if (existing[0].isRead !== isRead) {
-                const rows = await db
-                    .update<DailyReportUserStatusRow>(DailyReportUserStatus)
-                    .set({
-                        isRead: isRead,
-                        updatedAt: new Date(),
-                        updatedBy: String(userId),
-                    })
-                    .output()
-                    .where(and(eq(DailyReportUserStatus.hubId, reportHubId), eq(DailyReportUserStatus.userId, userId)))
-                updatedStatus = rows[0]
-            } else {
-                updatedStatus = existing[0]
-            }
-        } else {
-            const rows = await db
-                .insert<DailyReportUserStatusRow>(DailyReportUserStatus)
-                .output()
-                .values({
-                    hubId: reportHubId,
-                    userId,
-                    isRead: isRead,
-                    isStarred: false,
-                    createdAt: new Date(),
-                    createdBy: String(userId),
-                    updatedAt: new Date(),
-                    updatedBy: String(userId),
-                })
-            updatedStatus = rows[0]
-        }
-
-        if (businessDate) {
-            const normalizedDate = normalizeBusinessDateKey(businessDate)
-            if (normalizedDate) {
-                // 可視集合ダイジェスト付きキーを取りこぼさないよう接頭辞で消す
-                sqlResultCache.invalidatePrefix(dateUserPrefix(normalizedDate, userId))
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
-            }
-        }
-        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
-        // 可視集合ダイジェスト付きキーを取りこぼさないよう接頭辞で消す
-        sqlResultCache.invalidatePrefix(detailUserPrefix(reportHubId, userId))
-        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
-
-        await publishToSseStream(
-            statusUpdateMessageSchema.parse({
-                type: "status-update",
-                reportHubId: reportHubId,
-                recipientRawUserId: userId,
-                statusType: "read",
-                value: isRead,
-                clientTempId,
-            }),
-            "setReadStatus",
-        )
-
-        return updatedStatus
-    }
-
-    /**
-     * Resolves the SSE recipient for comment events on a possibly-draft report.
-     * 下書きの可能性がある日報のコメントイベントについて SSE の宛先を解決する処理。
-     *
-     * 下書きは所有者にしか見えないため、下書きラベルが付いている間はコメント本文も
-     * 所有者だけに配信する (無指定だと本文が全ユーザーへブロードキャストされる)。
-     * 公開済み (下書きラベル無し) は全員配信 = undefined を返す。
-     *
-     * @param hubId Parent hub id. 親日報の hub ID。
-     * @param ownerUserId Hub owner's raw user id. 所有者の内部ユーザー ID。
-     * @returns Recipient raw user id, or undefined to broadcast. 宛先 (全員配信は undefined)。
-     */
-    const resolveCommentRecipient = async (hubId: number, ownerUserId: number | null): Promise<number | undefined> => {
-        // 所有者不明 (共有日報など) は従来どおり全員配信
-        if (ownerUserId === null) return undefined
-        const draftIds = await getDraftLabelJoinIds()
-        const [rel] = await db
-            .select<{ hubId: number }>({ hubId: DailyReportHub_Label.hubId })
-            .top(1)
-            .from(DailyReportHub_Label)
-            .where(and(eq(DailyReportHub_Label.hubId, hubId), inArray(DailyReportHub_Label.labelId, draftIds)))
-        return rel ? ownerUserId : undefined
-    }
-
-    /**
-     * Adds a comment to a daily report.
-     * 日報にコメントを追加する。
-     *
-     * @param userId Internal numeric user id. 内部数値ユーザー ID。
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param content Comment body. コメント本文。
-     * @param businessDate Business date for cache invalidation. キャッシュ無効化に使う営業日。
-     * @param clientTempId Optimistic-update correlation id. 楽観更新の相関 ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns The created comment. 追加されたコメント。
-     */
-    const addComment = async (scope: DailyReportViewerScope, userId: number, reportHubId: number, content: string, businessDate: string | null, clientTempId: string): Promise<DailyReportPostedComment> => {
-        const [hub] = await db
-            .select<{ sourceType: string; deletedAt: Date | string | null; userId: number | null }>({ sourceType: DailyReportHub.sourceType, deletedAt: DailyReportHub.deletedAt, userId: DailyReportHub.userId })
-            .top(1)
-            .from(DailyReportHub)
-            .where(eq(DailyReportHub.id, reportHubId))
-        // 存在しない / 論理削除済みの日報にはコメントを付けない (以前は hub 未取得でも
-        // フォールスルーして孤児コメントを INSERT していた)
-        if (!hub || hub.deletedAt) {
-            throw new Error("Not Found")
-        }
-        // 不可視区分・他人の下書きにはコメントできない。認可失敗と不存在を区別せず Not Found にする
-        // (存在オラクルの回避)。読み取り経路と同一の可視性述語を共通ゲートで適用する
-        await assertHubMutable(scope, reportHubId, userId)
-        // コメント次元が拒否する区分には記入させない。本文は読めても書けない状態を表現するため、
-        // 不存在 (Not Found) ではなく「制限」として返す — 閲覧者は当該日報を見えているので
-        // 不存在を装っても存在オラクルにはならず、嘘をつくだけ UI の説明性が落ちる
-        if (!isSourceTypeVisible(scope.commentable, hub.sourceType)) {
-            throw new Error("Comments are restricted by the viewer's comment permission")
-        }
-        if (hub.sourceType.toLowerCase() !== "internal") {
-            throw new Error("Comments are restricted for external daily report sources")
-        }
-        // 下書きなら SSE を所有者宛に絞る (本文の全員配信を防ぐ)
-        const recipientRawUserId = await resolveCommentRecipient(reportHubId, hub.userId)
-
-        const [inserted] = await db
-            .insert<DailyReportCommentRow>(DailyReportCommentModel)
-            .output()
-            .values({
-                hubId: reportHubId,
-                userId,
-                body: content,
-                createdAt: new Date(),
-                createdBy: String(userId),
-                updatedAt: new Date(),
-                updatedBy: String(userId),
-            })
-
-        const [user] = await db.select<{ displayName: string | null }>({ displayName: users.displayName }).top(1).from(users).where(eq(users.id, userId))
-        const userName = user?.displayName ?? "Unknown"
-
-        // コメントは全ユーザーに表示されるため、date キャッシュも全ユーザー分を無効化
-        if (businessDate) {
-            const normalizedDate = normalizeBusinessDateKey(businessDate)
-            if (normalizedDate) {
-                sqlResultCache.invalidatePrefix(`daily-report:date:${normalizedDate}:user:`)
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
-            }
-        }
-        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
-        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
-        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
-
-        const commentItem: DailyReportPostedComment = {
-            id: inserted.id,
-            userId: encodeUserId(inserted.userId),
-            userName: userName,
-            content: inserted.body,
-            createdAt: formatDateValue(inserted.createdAt, "YYYY-MM-DD HH:mm:ss") ?? "",
-            isMine: true,
-        }
-
-        await publishToSseStream(
-            commentAddMessageSchema.parse({
-                type: "comment-add",
-                reportHubId: reportHubId,
-                comment: commentItem,
-                clientTempId,
-                recipientRawUserId,
-                // 受信側の区分フィルタ用 (旧エントリ互換のためスキーマ上は任意)
-                sourceType: hub.sourceType,
-            }),
-            "addComment",
-        )
-
-        return commentItem
-    }
-
-    /**
-     * Finds a daily report comment by ID.
-     * 日報コメントをIDで検索する。
-     */
-    const findDailyReportCommentById = async (tx: DailyReportDb, commentId: number) => {
-        return await tx.select<DailyReportCommentRow>().top(1).from(DailyReportCommentModel).where(eq(DailyReportCommentModel.id, commentId))
-    }
-
-    /**
-     * Deletes a comment from a daily report.
-     * 日報のコメントを削除する。
-     *
-     * @param userId Internal numeric user id. 内部数値ユーザー ID。
-     * @param reportHubId Hub id. 対象 hub の ID。
-     * @param commentId Comment id to delete. 削除対象のコメント ID。
-     * @param businessDate Business date for cache invalidation. キャッシュ無効化に使う営業日。
-     * @param clientTempId Optimistic-update correlation id. 楽観更新の相関 ID。
-     * @param scope Viewer scope carrying the visible source types. 可視 sourceType を運ぶ閲覧範囲。
-     * @returns Nothing. なし。
-     */
-    const deleteComment = async (scope: DailyReportViewerScope, userId: number, reportHubId: number, commentId: number, businessDate: string | null, clientTempId: string): Promise<void> => {
-        const comments = await findDailyReportCommentById(db, commentId)
-        if (comments.length === 0) {
-            throw new Error("Not Found")
-        }
-
-        // 渡された reportHubId がコメントの実際の所属と一致することを確認する。
-        // 不一致のまま進むと、無関係な日報のキャッシュ無効化と SSE 配信を引き起こす。
-        // ❗ 所有者チェックより**前**に置く。後ろだと、攻撃者が自分に可視な hubId を添えて任意の
-        //    commentId を試すことで「他人のコメント = 403 / 存在しない = 404」と応答が割れ、
-        //    コメントの存在を列挙できてしまう
-        if (comments[0].hubId !== reportHubId) {
-            throw new Error("Not Found")
-        }
-
-        // ❗ 区分ゲートも所有者チェックより前に置く。参照するのは**コメント自身の所属 hub** で
-        //    あり、呼び出し側が渡した ID ではない (上で一致を確認済み)。hub 行が引けない場合も
-        //    fail-close で Not Found にする (assertHubMutable と同一の規約)
-        // ❗ ここで見るのは本文次元 (`scope.visible`) であって**コメント次元ではない**。意図的。
-        //    自分のコメントは常に可視という契約 (mapHubRecord 参照) の対を成す規則であり、
-        //    コメント次元でゲートすると権限剥奪の瞬間に既存の自分のコメントが恒久的に削除不能に
-        //    なる。所有者チェックが単独で十分な防御になっている
-        const [hubForDelete] = await db.select<{ userId: number | null; sourceType: string }>({ userId: DailyReportHub.userId, sourceType: DailyReportHub.sourceType }).top(1).from(DailyReportHub).where(eq(DailyReportHub.id, comments[0].hubId))
-        if (!(hubForDelete && isSourceTypeVisible(scope.visible, hubForDelete.sourceType))) {
-            throw new Error("Not Found")
-        }
-
-        if (comments[0].userId !== userId) {
-            throw new Error("Unauthorized")
-        }
-
-        // 下書きなら削除イベントも所有者宛に絞る (comment-add と対称)
-        const recipientRawUserId = await resolveCommentRecipient(reportHubId, hubForDelete.userId)
-
-        await db.delete(DailyReportCommentModel).where(eq(DailyReportCommentModel.id, commentId))
-
-        // コメントは全ユーザーに表示されるため、date キャッシュも全ユーザー分を無効化
-        if (businessDate) {
-            const normalizedDate = normalizeBusinessDateKey(businessDate)
-            if (normalizedDate) {
-                sqlResultCache.invalidatePrefix(`daily-report:date:${normalizedDate}:user:`)
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
-            }
-        }
-        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
-        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
-        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
-
-        await publishToSseStream(
-            commentDeleteMessageSchema.parse({
-                type: "comment-delete",
-                reportHubId: reportHubId,
-                commentId,
-                clientTempId,
-                recipientRawUserId,
-                // 受信側の区分フィルタ用 (hub 行が引けない場合は undefined = 旧エントリ相当の扱い)
-                sourceType: hubForDelete?.sourceType,
-            }),
-            "deleteComment",
-        )
-    }
-
-    /**
-     * Creates a new draft daily report.
-     * 新しい日報（下書き）を作成する。
-     */
-    const createDailyReport = async (userId: number, businessDate: string, clientTempId: string): Promise<DailyReportDetail> => {
-        logger.info("createDailyReport called", { userId, businessDate })
-
-        // ユーザー名取得
-        const [user] = await db.select<{ displayName: string | null }>({ displayName: users.displayName }).from(users).where(eq(users.id, userId))
-        const userName = user?.displayName ?? encodeUserId(userId)
-
-        try {
-            const result = await inTransaction(async (tx) => {
-                logger.info("Starting transaction")
-                // 1. Hub作成
-                const sourceId = `internal-temp-${Date.now()}-${Math.random()}` // 一時的なID
-                const [hub] = await tx
-                    .insert<DailyReportHubRow>(DailyReportHub)
-                    .output()
-                    .values({
-                        sourceType: "Internal",
-                        sourceId: sourceId,
-                        businessDate: new Date(businessDate),
-                        userId: userId,
-                        title: "(無題)",
-                        createdAt: new Date(),
-                        createdBy: String(userId),
-                        updatedAt: new Date(),
-                        updatedBy: String(userId),
-                    })
-
-                // sourceId を id と同じ値に更新 (Internal の場合の正規化)
-                await tx
-                    .update(DailyReportHub)
-                    .set({ sourceId: String(hub.id) })
-                    .where(eq(DailyReportHub.id, hub.id))
-
-                logger.info("Hub created", hub)
-
-                // 2. Internal作成
-                await tx.insert(DailyReportInternal).values({
-                    hubId: hub.id,
-                    body: "",
-                    createdAt: new Date(),
-                    createdBy: String(userId),
-                    updatedAt: new Date(),
-                    updatedBy: String(userId),
-                })
-                logger.info("Internal created")
-
-                // 3. ラベル付与
-                logger.info("Calling getDraftLabelId")
-                const draftLabelId = await getDraftLabelId()
-                logger.info("draftLabelId", draftLabelId)
-                const labels: DailyReportLabelDef[] = []
-                if (draftLabelId) {
-                    await tx.insert(DailyReportHub_Label).values({
-                        hubId: hub.id,
-                        labelId: draftLabelId,
-                        createdAt: new Date(),
-                        createdBy: String(userId),
-                    })
-                    labels.push({ id: draftLabelId, name: draftLabelName, color: null })
-                }
-                logger.info("Label assigned")
-
-                // 4. 詳細オブジェクト構築
-                return {
-                    reportHubId: hub.id,
-                    date: businessDate,
-                    createdAt: formatDateValue(hub.createdAt, "YYYY-MM-DD HH:mm:ss"),
-                    author: userName,
-                    userId: encodeUserId(userId),
-                    sourceType: "Internal",
-                    employeeName: userName,
-                    // 監査列と同様、クライアント公開時は生内部 ID を難読化する (mapHubRecord と整合)
-                    updatedBy: encodeUserId(userId),
-                    updatedAt: formatDateValue(hub.updatedAt, "YYYY-MM-DD HH:mm:ss"),
-                    category: null,
-                    creationCategory: null,
-                    visitTimeFrom: null,
-                    visitTimeTo: null,
-                    customerName: null,
-                    interviewers: [],
-                    subject: hub.title,
-                    content: "",
-                    externalComments: [],
-                    isRead: true, // 自分で作ったので既読
-                    isStarred: false,
-                    labels: labels,
-                    postedComments: [],
-                    // 新規作成直後の日報に添付は存在しない
-                    attachments: [],
-                }
-            })
-
-            // キャッシュ無効化
-            const normalizedBusinessDate = normalizeBusinessDateKey(businessDate)
-            if (normalizedBusinessDate) {
-                // 可視集合ダイジェスト付きキーを取りこぼさないよう接頭辞で消す
-                sqlResultCache.invalidatePrefix(dateUserPrefix(normalizedBusinessDate, userId))
-            }
-            sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
-            // ❗ createDailyReport には ids の広域 prefix 無効化が無く、この 1 行が作成者の ID 一覧を
-            //    落とす唯一の経路。redis 未注入の配備では epoch も進まないため、ここを消すと
-            //    作成した日報が自分の一覧から TTL 分 (既定 180 秒) 消える。接頭辞化のみ行う
-            sqlResultCache.invalidatePrefix(idsUserPrefix(userId))
-            // ❗ 順序重要: invalidate → incrementRedisEpoch → publishToSseStream
-            await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
-            if (normalizedBusinessDate) {
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedBusinessDate}`)
-            }
-
-            // ❗ 明示 null (無制限)。所有者が自分で作った日報を取り直す経路なので、消費側の可視集合に
-            //    作成区分 ("Internal") が含まれなくても取得と SSE 配信を壊さない。区分の出し分けは
-            //    受信側の SSE フィルタと次回読み取り時のサーバーフィルタが担う
-            const fullDetail = await getDailyReportDetailById(DailyReportViewerScope.unrestricted("post-write self read: the writer always sees the row they just wrote"), result.reportHubId, userId, { forceRefresh: true })
-
-            if (fullDetail) {
-                // 下書き判定
-                // 判定は代表 ID ではなく下書きラベル**全体**で行う (2 つ目の下書き名を見落とさない)
-                const draftLabelIds = await getDraftLabelIds()
-                const isDraft = fullDetail.labels.some((l) => draftLabelIds.includes(l.id))
-                await publishToSseStream(
-                    reportCreateMessageSchema.parse({
-                        type: "report-create",
-                        reportHubId: fullDetail.reportHubId,
-                        report: fullDetail,
-                        clientTempId,
-                        recipientRawUserId: isDraft ? userId : undefined,
-                    }),
-                    "createDailyReport",
-                )
-            }
-
-            return fullDetail ?? result
-        } catch (e) {
-            logger.error("Error in createDailyReport", e)
-            throw e
-        }
-    }
-
-    // --- Internal Repository Layer ---
-
-    /**
-     * Finds a DailyReportHub by ID.
-     * 日報HubをIDで検索する。
-     */
-    const findDailyReportHubById = async (tx: DailyReportDb, reportHubId: number) => {
-        return await tx.select<DailyReportHubRow>().top(1).from(DailyReportHub).where(eq(DailyReportHub.id, reportHubId))
-    }
-
-    /**
-     * Updates a DailyReportHub.
-     * 日報Hubを更新する。
-     */
-    const updateDailyReportHub = async (tx: DailyReportDb, reportHubId: number, data: Partial<DailyReportHubRow>) => {
-        await tx.update(DailyReportHub).set(data).where(eq(DailyReportHub.id, reportHubId))
-    }
-
-    /**
-     * Updates a DailyReportInternal.
-     * 日報Internalを更新する。
-     */
-    const updateDailyReportInternal = async (tx: DailyReportDb, hubId: number, data: Partial<DailyReportInternalRow>) => {
-        await tx.update(DailyReportInternal).set(data).where(eq(DailyReportInternal.hubId, hubId))
-    }
-
-    /**
-     * Deletes a label from a DailyReportHub.
-     * 日報Hubからラベルを削除する。
-     */
-    const deleteDailyReportLabel = async (tx: DailyReportDb, hubId: number, labelId: number) => {
-        await tx.delete(DailyReportHub_Label).where(and(eq(DailyReportHub_Label.hubId, hubId), eq(DailyReportHub_Label.labelId, labelId)))
-    }
-
-    // --- Service Layer ---
-
-    /**
-     * Logically deletes a daily report.
-     * 日報を論理削除する。
-     */
-    const deleteDailyReport = async (reportHubId: number, userId: number, clientTempId: string): Promise<void> => {
-        const report = await findDailyReportHubById(db, reportHubId)
-        if (!report.length || report[0].deletedAt) {
-            throw new Error("Not Found")
-        }
-        if (report[0].userId !== userId) {
-            throw new Error("Unauthorized")
-        }
-
-        await updateDailyReportHub(db, reportHubId, {
-            deletedAt: new Date(),
-            deletedBy: String(userId),
-            updatedAt: new Date(),
-            updatedBy: String(userId),
-        })
-
-        // キャッシュ無効化
-        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
-        // 削除されたレポートは全ユーザーの一覧から消えるため、全ユーザーの IDs キャッシュを invalidate
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_IDS_CACHE_KEY)
-        // ❗ 順序重要: invalidatePrefix → incrementRedisEpoch → publishToSseStream
-        await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
-        if (report[0].businessDate) {
-            const normalizedDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
-            if (normalizedDate) {
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
-            }
-        }
-
-        await publishToSseStream(
-            reportDeleteMessageSchema.parse({
-                type: "report-delete",
-                reportHubId: reportHubId,
-                clientTempId,
-                // 受信側の区分フィルタ用 (旧エントリ互換のためスキーマ上は任意)
-                sourceType: report[0].sourceType,
-            }),
-            "deleteDailyReport",
-        )
-    }
-
-    /**
-     * Updates an existing daily report.
-     * 日報を更新する。
-     */
-    const updateDailyReport = async (reportHubId: number, userId: number, data: { title?: string; content?: string }, clientTempId: string): Promise<void> => {
-        const report = await findDailyReportHubById(db, reportHubId)
-        if (!report.length || report[0].deletedAt) {
-            throw new Error("Not Found")
-        }
-        if (report[0].userId !== userId) {
-            throw new Error("Unauthorized")
-        }
-
-        await inTransaction(async (tx) => {
-            if (data.title !== undefined) {
-                await updateDailyReportHub(tx, reportHubId, {
-                    title: data.title,
-                    updatedAt: new Date(),
-                    updatedBy: String(userId),
-                })
-            }
-            if (data.content !== undefined) {
-                await updateDailyReportInternal(tx, reportHubId, {
-                    body: data.content,
-                    updatedAt: new Date(),
-                    updatedBy: String(userId),
-                })
-            }
-        })
-
-        // キャッシュ無効化: 一覧プレビューは詳細キャッシュから引くため、詳細を全プロセス横断で落とす。
-        // 以前は読み取りに使われないプレフィックスを無効化し epoch も上げていなかったため、
-        // 編集後の件名/本文が他ワーカーで古いまま配信されていた
-        sqlResultCache.invalidate(`daily-report:detail:${reportHubId}`)
-        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
-        await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${reportHubId}`)
-        // 編集内容は全ユーザーの一覧に映るため、営業日別一覧は全ユーザー分 + 全ワーカー横断で
-        // 無効化する (addComment と同じ流儀。編集者本人のキーだけでは他者へ古い件名が残る)
-        const editedBusinessDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
-        if (editedBusinessDate) {
-            sqlResultCache.invalidatePrefix(`daily-report:date:${editedBusinessDate}:user:`)
-            await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${editedBusinessDate}`)
-        }
-
-        // ❗ 明示 null (無制限)。所有者が自分の日報を取り直す経路であり、区分の出し分けは
-        //    受信側の SSE フィルタと次回読み取り時のサーバーフィルタが担う
-        const fullDetail = await getDailyReportDetailById(DailyReportViewerScope.unrestricted("post-write self read: the writer always sees the row they just wrote"), reportHubId, userId, { forceRefresh: true })
-        if (fullDetail) {
-            // 下書き判定
-            // 判定は代表 ID ではなく下書きラベル**全体**で行う (2 つ目の下書き名を見落とさない)
-            const draftLabelIds = await getDraftLabelIds()
-            const isDraft = fullDetail.labels.some((l) => draftLabelIds.includes(l.id))
-            await publishToSseStream(
-                reportUpdateMessageSchema.parse({
-                    type: "report-update",
-                    reportHubId: fullDetail.reportHubId,
-                    report: fullDetail,
-                    clientTempId,
-                    recipientRawUserId: isDraft ? userId : undefined,
-                }),
-                "updateDailyReport",
-            )
-        }
-    }
-
-    /**
-     * Publishes a draft daily report.
-     * 日報を公開する（下書きラベルを削除）。
-     */
-    const publishDailyReport = async (reportHubId: number, userId: number, clientTempId: string): Promise<DailyReportDetail | null> => {
-        const report = await findDailyReportHubById(db, reportHubId)
-        if (!report.length) {
-            throw new Error("Not Found")
-        }
-        if (report[0].userId !== userId) {
-            throw new Error("Unauthorized")
-        }
-
-        const draftLabelId = await getDraftLabelId()
-        if (!draftLabelId) return null
-
-        await deleteDailyReportLabel(db, reportHubId, draftLabelId)
-
-        // キャッシュ無効化
-        sqlResultCache.invalidatePrefix(`daily-report:detail:${reportHubId}:user:`)
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
-        // 公開によりドラフトが全ユーザーに可視化されるため、全ユーザーの IDs キャッシュを invalidate
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_IDS_CACHE_KEY)
-        // ❗ 順序重要: invalidatePrefix → incrementRedisEpoch → publishToSseStream
-        await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
-        if (report[0].businessDate) {
-            const normalizedDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
-            if (normalizedDate) {
-                await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalizedDate}`)
-            }
-        }
-
-        // ユーザーごとの営業日別一覧キャッシュも無効化
-        const normalizedBusinessDate = normalizeBusinessDateKey(formatDateValue(report[0].businessDate, "YYYY-MM-DD"))
-        if (normalizedBusinessDate) {
-            // 可視集合ダイジェスト付きキーを取りこぼさないよう接頭辞で消す
-            sqlResultCache.invalidatePrefix(dateUserPrefix(normalizedBusinessDate, userId))
-        }
-
-        // ❗ 明示 null (無制限)。所有者が自分の日報を取り直す経路であり、区分の出し分けは
-        //    受信側の SSE フィルタと次回読み取り時のサーバーフィルタが担う
-        const fullDetail = await getDailyReportDetailById(DailyReportViewerScope.unrestricted("post-write self read: the writer always sees the row they just wrote"), reportHubId, userId, { forceRefresh: true })
-        if (fullDetail) {
-            await publishToSseStream(
-                reportPublishMessageSchema.parse({
-                    type: "report-publish",
-                    reportHubId: fullDetail.reportHubId,
-                    report: fullDetail,
-                    clientTempId,
-                }),
-                "publishDailyReport",
-            )
-        }
-        return fullDetail ?? null
-    }
-
-    /**
-     * Invalidates the read caches that carry hub-scoped data across every process.
-     * hub 単位のデータを載せている読み取りキャッシュを、全プロセス横断で無効化する処理。
-     *
-     * 用途: 通常の更新経路 (create / update / publish) を通らずに DB を書き換えた場合、
-     * 例えば外部システムからの一括取込。プロセス内 Map を消すだけでは稼働中の
-     * 別プロセス (別ワーカー・別コンテナ) のキャッシュが TTL まで stale のままになるため、
-     * Redis の epoch を進めて全プロセスのキャッシュ行を一斉に無効化する。
-     *
-     * `clearCache()` との違い: `clearCache()` はプロセス内キャッシュの全消去 + 一覧 ID の
-     * epoch のみ進める粗い操作。こちらは対象 hub / 営業日 / 一覧 ID の三系統を epoch まで
-     * 含めて狙い撃ちで無効化する。日報本体に紐づくデータを書き換えたときはこちらを使うこと。
-     *
-     * @param hubIds Hub ids whose detail cache must be dropped. 詳細キャッシュを捨てる hub ID 群。
-     * @param businessDates Business dates (YYYY-MM-DD) whose list cache must be dropped. 一覧キャッシュを捨てる営業日群。
-     * @returns Nothing. なし。
-     */
-    const invalidateHubReadCaches = async (hubIds: readonly number[], businessDates: readonly string[]): Promise<void> => {
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_BUSINESS_DATE_CACHE_PREFIX)
-        // 一覧 ID は「どの行が存在するか」そのもの。hub の行集合を変えうる呼び出し元
-        // (取込・移行) がこの関数を頼る以上、詳細・営業日と同時に捨てる。
-        // 現在の唯一の呼び出し元 (添付同期) は行集合を変えないため、これは将来の
-        // 行集合変更呼び出し元に対する予防である
-        sqlResultCache.invalidatePrefix(DAILY_REPORT_IDS_CACHE_KEY)
-        await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
-        for (const hubId of new Set(hubIds)) {
-            sqlResultCache.invalidatePrefix(`daily-report:detail:${hubId}:user:`)
-            await incrementRedisEpoch(`${DAILY_REPORT_DETAIL_EPOCH_PREFIX}${hubId}`)
-        }
-        for (const businessDate of new Set(businessDates)) {
-            const normalized = normalizeBusinessDateKey(businessDate)
-            // 正規化できない値で epoch キーを作ると、誰も参照しないキーが増えるだけになる
-            if (!normalized) continue
-            await incrementRedisEpoch(`${DAILY_REPORT_DATE_EPOCH_PREFIX}${normalized}`)
-        }
-    }
-
-    /**
-     * Clears all server-side SQL result and user ID caches.
-     * サーバー側のすべての SQL 結果キャッシュおよびユーザー ID キャッシュを全消去する。
-     *
-     * Redis で進める epoch は一覧 ID のもののみ (プロセス内キャッシュは全系統消える)。
-     * 特定 hub / 営業日の epoch まで狙い撃ちで進めたい場合は `invalidateHubReadCaches` を使うこと。
-     */
-    const clearCache = async (): Promise<void> => {
-        sqlResultCache.clearAll()
-        userIdCache.clear()
-        cachedDraftLabelIds = null
-        if (epochs) {
-            await incrementRedisEpoch(DAILY_REPORT_IDS_EPOCH_KEY)
-        }
-        logger.info("[DailyReportService] Server-side DB/SQL caches cleared successfully.")
-    }
-
-    return {
-        // 定数 (アプリ側の互換 export 用)
-        streamKey: DAILY_REPORT_SSE_STREAM_KEY,
-        streamMaxLen: DAILY_REPORT_SSE_STREAM_MAXLEN,
-        // キャッシュクリア
-        clearCache,
-        invalidateHubReadCaches,
-        // ユーザー解決
-        getUserIdByExternalId,
-        // 参照系
-        getDailyReportIdsByExternalId,
-        getDailyReportIdsFirstPageByExternalId,
-        getDailyReportsByBusinessDate,
-        getDailyReportsByBusinessDateByExternalId,
-        getDailyReportDetailById,
-        getDailyReportDetailByIdByExternalId,
-        getDraftLabelId,
-        // 添付 (ハンドラーが認可判定と実体消失記録に使う)
-        getAttachmentsByHubIds,
-        getAttachmentForUser,
-        markAttachmentMissing,
-        markAttachmentPresent,
-        // 更新系
-        setStarStatus,
-        setReadStatus,
-        addComment,
-        deleteComment,
-        createDailyReport,
-        updateDailyReport,
-        publishDailyReport,
-        deleteDailyReport,
-        // リポジトリヘルパー。現時点で消費側の呼び出し元は無く、公開面としてのみ維持している
-        // (「統合テストから直接利用されている」という以前の記述は誤り。実測で 0 件)。
-        // ❗ どれも**コメント次元を適用しない**素のリポジトリ操作である。詳細を組み立てる用途へ
-        //    流用すると mapHubRecord の射影を迂回してコメント本文が出るため、読み取り経路の
-        //    素材として使わないこと
-        findDailyReportHubById,
-        updateDailyReportHub,
-        updateDailyReportInternal,
-        deleteDailyReportLabel,
-    }
-}