@aiquants/daily-report 0.20.0 → 0.21.0

package/dist/server.d.mts

@@ -1,23 +1,13 @@
-import { f as DailyReportInterviewer, e as DailyReportExternalComment, a as DailyReportItem, b as DailyReportDetail, D as DailyReportAttachmentSummary, h as DailyReportPostedComment } from './types-CqgYQgbH.mjs';
-import * as drizzle_orm_mssql_core from 'drizzle-orm/mssql-core';
-import { AnyMsSqlColumn } from 'drizzle-orm/mssql-core';
-import { D as DailyReportLogger } from './logger-D3krZrNK.mjs';
-import { TransactionRetryOptions } from '@aiquants/mssql';
-import { SQL } from 'drizzle-orm';
-
-/**
- * DI ports (structural interfaces) consumed by the daily-report server layer.
- * daily-report サーバー層が消費する DI ポート (構造的インターフェース) 群。
- *
- * redis / 認証 / ユーザー解決 / ID 難読化はすべてアプリ実装を注入する。
- * redis の型は `redis` パッケージへ依存しないよう、使用する最小面のみ構造定義する。
- */
-/** Redis Stream の 1 エントリ (xRead / xRange の結果要素)。 */
+import { f as DailyReportInterviewer, e as DailyReportExternalComment, a as DailyReportItem, b as DailyReportDetail, D as DailyReportAttachmentSummary, h as DailyReportPostedComment } from "./types-CqgYQgbH.mjs";
+import * as drizzle_orm_mssql_core from "drizzle-orm/mssql-core";
+import { AnyMsSqlColumn } from "drizzle-orm/mssql-core";
+import { D as DailyReportLogger } from "./logger-D3krZrNK.mjs";
+import { TransactionRetryOptions } from "@aiquants/mssql";
+import { SQL } from "drizzle-orm";
 type RedisStreamMessage = {
     id: string;
     message: Record<string, string>;
 };
-/** 通常操作用 Redis クライアントの最小面 (共有クライアント)。 */
 type DailyReportRedisClient = {
     get(key: string): Promise<string | null>;
     incr(key: string): Promise<number>;
@@ -29,7 +19,6 @@ type DailyReportRedisClient = {
         COUNT?: number;
     }): Promise<RedisStreamMessage[]>;
 };
-/** ブロッキング xRead 用 Redis クライアントの最小面 (SSE リーダー専用接続)。 */
 type DailyReportRedisBlockingClient = {
     isOpen: boolean;
     on(event: "error", listener: (err: Error) => void): unknown;
@@ -45,32 +34,17 @@ type DailyReportRedisBlockingClient = {
     }> | null>;
     quit(): Promise<unknown>;
 };
-/**
- * Redis provider port: shared client for commands + dedicated client factory for blocking reads.
- * Redis プロバイダーポート。コマンド用共有クライアントと、ブロッキング読み取り用専用クライアント生成を提供する。
- */
 type DailyReportRedisProvider = {
-    /** 共有クライアントを取得する (未接続・失敗時は undefined)。 */
     getClient(): Promise<DailyReportRedisClient | undefined>;
-    /** ブロッキング xRead 用の専用クライアントを生成する (失敗時は undefined)。 */
     createClient(): Promise<DailyReportRedisBlockingClient | undefined>;
 };
-/** 認証結果 (ユーザーは外部 ID を持つ最小形状)。 */
 type DailyReportAuthResult = {
     user?: {
         id: string;
     };
     cookie?: string;
 };
-/**
- * Request authentication port (e.g. session/OpenID check in the host app).
- * リクエスト認証ポート (ホストアプリのセッション / OpenID 検証)。
- *
- * `failureRedirect` が文字列の場合、未認証時は実装側で redirect を throw すること。
- * null の場合は throw せず `user` 無しで解決する。
- */
 interface DailyReportAuthenticate {
-    /** 失敗時は必ずリダイレクトを throw するため、正常復帰時の `user` は常に存在する。 */
     (request: Request, options: {
         failureRedirect: string;
     }): Promise<{
@@ -79,214 +53,55 @@ interface DailyReportAuthenticate {
         };
         cookie?: string;
     }>;
-    /** リダイレクトを発生させないモード。未認証では `user` を持たない結果が返る。 */
     (request: Request, options: {
         failureRedirect: null;
     }): Promise<DailyReportAuthResult>;
 }
-/**
- * Per-dimension visible source types (report body vs. comments).
- * 次元ごとの可視 sourceType (本文とコメント)。
- *
- * コメントの閲覧・記入を本文の可視性から独立して絞るための形。
- *
- * - `read`: 本文 (日報行) を閲覧してよい sourceType。**空配列は 0 件**。
- * - `comment` **省略**: コメント次元は `read` に従う (単一次元と同義・現行互換)。
- * - `comment: []`: コメント 0 件かつ記入不可。
- *
- * ❗ `comment` に `null` は受け付けない。「`read` に従う」の綴りを 2 つ作ると、
- *   ポート全体の nullish (= 無制限) と次元レベルの nullish が混ざって 4 状態になり、
- *   本ファイルが一貫して避けている「無制限と全拒否の取り違え」を次元単位で再発させる。
- *
- * ❗ `read` の外側にあるコメントトークンは意味を持たない (コメントは必ず read で絞られた
- *   詳細の内側にしか載らない)。`DailyReportViewerScope.restrictTo` が構築時に
- *   `read` との積集合へ狭めるため、設定ミスは黙って安全側へ倒れる。
- */
 type DailyReportVisibilityDimensions = {
-    /** 本文を閲覧してよい sourceType。空配列は 0 件。 */
     read: readonly string[];
-    /** コメントを閲覧・記入してよい sourceType。省略時は `read` に従う。空配列は 0 件かつ記入不可。 */
     comment?: readonly string[];
 };
-/**
- * Raw return of the visible-source-type resolver.
- * 可視 sourceType リゾルバの生戻り値。
- *
- * - `undefined` / `null`: 無制限 (全件)。ポート未注入時と同じ既定の意味。
- * - `string[]`: 本文・コメントの双方をその集合に限定。要素は `DailyReportHub.sourceType` の値であり、
- *   **空配列は 0 件**。`{ read: <配列> }` と完全に同義。
- * - `{ read, comment? }`: 次元ごとに指定する ({@link DailyReportVisibilityDimensions})。
- *
- * 中立契約: いかなる認可パッケージの型 (`PermissionView` 等) にも依存しない素の文字列と配列のみ。
- */
 type DailyReportVisibleSourceTypes = readonly string[] | DailyReportVisibilityDimensions | null | undefined;
-/**
- * Why the visible-source-type resolver is being called.
- * 可視 sourceType リゾルバが呼ばれた理由。
- *
- * - `initial`: リクエスト処理の開始時 (読み取り / ミューテーション / 添付 / SSE 接続確立)。
- * - `refresh`: 長寿命の SSE 接続が権限失効を検出するための定期再解決。
- *
- * ❗ `refresh` は接続時と**同一の `Request` インスタンス**で呼ばれる (SSE 接続の生存期間中、
- *   他に握れるハンドルが無いため)。したがってリクエストスコープで記憶化する実装は、
- *   `refresh` のときだけキャッシュを迂回しなければ再解決が常に古い値を返し、失効が反映されない。
- */
 type DailyReportVisibilityResolveReason = "initial" | "refresh";
-/**
- * Context handed to the visible-source-type resolver.
- * 可視 sourceType リゾルバへ渡される文脈。
- */
 type DailyReportVisibilityResolveContext = {
-    /** 呼び出し理由。`refresh` のときリクエストスコープのキャッシュを迂回すること。 */
     reason: DailyReportVisibilityResolveReason;
 };
-/**
- * Resolves which report source types a request may view.
- * リクエストが閲覧してよい日報 sourceType を解決するポート。
- *
- * サーバー側の全データ経路 (一覧 / 詳細 / コメント / 添付 / SSE) に一貫して効く。
- *
- * ❗ 例外を投げた場合、ハンドラは**空集合 (全拒否) にフォールバック**する。認可ストアの
- *   障害時に無制限へ倒れないための fail-close であり、実装側で握り潰さないこと。
- * ❗ 全読み取りリクエストのクリティカルパス上で 1 回呼ばれる (キャッシュキーが戻り値に依存する)。
- *   高速に保つこと。記憶化する場合はセッション / ユーザー単位の短時間 TTL (60 秒以下) とし、
- *   `context.reason === "refresh"` では必ずキャッシュを迂回すること
- *   (迂回しないと SSE の定期再解決が失効を観測できず、権限剥奪後も配信が続く)。
- */
 type DailyReportResolveVisibleSourceTypes = (request: Request, context: DailyReportVisibilityResolveContext) => DailyReportVisibleSourceTypes | Promise<DailyReportVisibleSourceTypes>;
-/**
- * Resolves an external user id (e.g. Google sub) to the internal numeric user id.
- * 外部ユーザー ID (例: Google sub) を内部数値ユーザー ID へ解決するポート。
- */
 type DailyReportResolveUserId = (externalUserId: string) => Promise<number | null>;
-/**
- * Obfuscates an internal numeric user id for client exposure.
- * 内部数値ユーザー ID をクライアント公開用に難読化するポート。
- */
 type DailyReportEncodeUserId = (id: number) => string;
-/**
- * Reversible obfuscation codec for an internal numeric id exposed to clients.
- * クライアントへ公開する内部数値 ID の可逆難読化コーデック。
- *
- * これは難読化であって認可ではない。トークンを能力 (capability) として扱ってはならず、
- * 認可は必ずサーバー側の述語で行うこと。ID 空間を混ぜないため、リソース種別ごとに
- * 別インスタンス (別 alphabet 等) を注入することを推奨する。
- */
 type DailyReportIdCodec = {
-    /** 内部数値 ID をトークンへ変換する。 */
     encode: (id: number) => string;
-    /** トークンを内部数値 ID へ戻す。復号できない場合は null。 */
     decode: (token: string) => number | null;
 };
-/**
- * Failure kinds a caller maps onto HTTP statuses.
- * 呼び出し側が HTTP ステータスへ写像する失敗種別。
- *
- * - `not_found`: 実体が存在しない (消失・未正規化 URI)
- * - `denied`: ストレージ側で拒否された (サンドボックス外・ACL)
- * - `too_large`: 上限超過 (事前サイズ判定またはワイヤ上限)
- * - `invalid_path`: 受け入れないスキーム・不正なパス (データ不備)
- * - `unavailable`: ストレージサービスへ到達できない・締め切り超過
- */
 type DailyReportAttachmentFailure = "not_found" | "denied" | "too_large" | "invalid_path" | "unavailable";
-/** 添付ファイル読み取りの成功結果。 */
 type DailyReportAttachmentBytes = {
     ok: true;
-    /**
-     * Byte view backed by an `ArrayBuffer`.
-     * `ArrayBuffer` を裏に持つバイトビュー。
-     *
-     * 素の `Uint8Array` と書くと `Uint8Array<ArrayBufferLike>` へ広がり `BodyInit` へ代入できない
-     * (TypeScript 5.7 以降の既定型引数)。`Response` のボディへそのまま渡すため narrow 型で受ける。
-     * `head` が true の呼び出しでは長さ 0 のビューを返してよい (実サイズは `size` で申告する)。
-     */
     bytes: Uint8Array<ArrayBuffer>;
-    /** バックエンドが申告した MIME 型。判定できない場合は null。 */
     contentType?: string | null;
-    /**
-     * Entity size in bytes, independent of how many bytes `bytes` actually holds.
-     * 実体のバイト数。`bytes` が実際に保持している長さとは独立に申告する値。
-     *
-     * HEAD 応答の `Content-Length` は同じ URI への GET が返す値と一致しなければならない
-     * (RFC 9110 §9.3.2)。`head` が true の呼び出しは本体を読まないため `bytes` は空になるので、
-     * ここで実サイズを申告しないと HEAD が常に `Content-Length: 0` を返してしまう。
-     * 申告できない場合は省略してよく、そのとき呼び出し側は `bytes.byteLength` を使う。
-     */
     size?: number;
 };
-/** 添付ファイル読み取りの失敗結果。 */
 type DailyReportAttachmentError = {
     ok: false;
     reason: DailyReportAttachmentFailure;
-    /** 診断ログ用の生のストレージエラーコード。HTTP ステータスの決定には使わない。 */
     code?: string;
 };
-/**
- * Reads attachment bytes from the host application's storage backend.
- * ホストアプリのストレージバックエンドから添付ファイルのバイト列を読み取るポート。
- *
- * `filePath` はサーバー内部にとどまり、クライアントへは決して渡らない。
- * 失敗は種別付きで返すこと (例外を投げない・単一の null へ潰さない)。
- * 種別を潰すと「実体が消えた」「上限超過」「サービス停止」が運用上区別できなくなる。
- *
- * `head` が true のときは実体を読まずメタデータのみ取得する。HEAD 要求で本体を読んで
- * 捨てると、認証済み呼び出し元が任意に転送量とレイテンシを増幅できる経路になる。
- */
 type DailyReportReadAttachment = (filePath: string, options: {
     maxBytes: number;
     head: boolean;
     principal?: string;
 }) => Promise<DailyReportAttachmentBytes | DailyReportAttachmentError>;
-
-/**
- * In-memory SQL result cache with TTL, snapshot, and cross-worker epoch (via redis) support.
- * TTL・スナップショット・クロスワーカー epoch (redis 経由) を備えた SQL 結果のインメモリキャッシュ。
- *
- * epoch は任意注入の redis ポート経由で取得・更新する (未注入時は常に 0 = epoch 無効)。
- */
-
 type SqlResultCacheQueryOptions = {
     forceRefresh?: boolean;
     snapshot?: boolean;
     ttlMsOverride?: number;
     epochKey?: string;
-    /**
-     * ヒット時にバケット年齢が ttl × ratio を超えていたら、キャッシュ値を即返しつつ
-     * 裏で 1 本だけ再フェッチして置き換える (未指定は従来動作 = 何もしない)。
-     * 有効域は 0 <= ratio < 1: ヒット判定が「未失効」を要求するため年齢は常に ttl 未満であり、
-     * ratio 1 は事実上発火しない。ratio 0 は毎ヒット裏更新 (undefined とは区別される)。
-     * 定期的にアクセスされるキーの「TTL 切れ直後のコールド遭遇」を対話リクエストから排除する。
-     */
     refreshAheadRatio?: number;
 };
-/**
- * Creates epoch helpers bound to an optional redis provider.
- * 任意の redis プロバイダーに束縛された epoch ヘルパーを生成する処理。
- */
 declare const createEpochStore: (redis?: DailyReportRedisProvider) => {
-    /**
-     * Gets the current epoch value, or null when it cannot be determined.
-     * 現在のエポック値を取得する処理。判定不能なら null。
-     *
-     * - `null` = redis 未注入、または一時的な失敗。**エポックによる横断無効化は判定不能**。
-     * - `0` = redis に到達したがキーが無い (一度も increment されていない正当な初期値)。
-     *
-     * ❗ `0` を「不明」の代用にしてはならない。記録側も `0` のとき両辺が一致してしまい、
-     * stale 検出が黙って無効化される (無効化されたこと自体がどこにも現れない)。
-     * 「常に 0 = safe 方向」が成り立つのは一時的失敗のときだけで、未注入時には偽である。
-     */
     getEpoch(epochKey: string): Promise<number | null>;
-    /**
-     * Increments the epoch counter in Redis.
-     * Redis のエポックカウンターをインクリメントする。
-     */
     incrementEpoch(epochKey: string): Promise<void>;
 };
 type EpochStore = ReturnType<typeof createEpochStore>;
-/**
- * In-memory cache for SQL query results with TTL and snapshot support.
- * TTLとスナップショット機能を備えたSQLクエリ結果のインメモリキャッシュ。
- */
 declare class SqlResultCache {
     private readonly config;
     private readonly epochStore;
@@ -295,75 +110,18 @@ declare class SqlResultCache {
     constructor(config: {
         defaultTtlMs: number;
     }, epochStore: EpochStore);
-    /**
-     * Invalidates a specific cache bucket.
-     * 指定されたキャッシュバケットを無効化します。
-     */
     invalidate: (cacheKey: string) => void;
-    /**
-     * Kicks a single background refetch when the bucket has aged past ttl * ratio.
-     * バケット年齢が ttl × ratio を超えたヒット時に、裏で 1 本だけ再フェッチを起動する処理。
-     *
-     * 応答は誰も待たない。完了までは旧バケットがそのまま生きているため、並行するヒットは
-     * 従来どおりキャッシュから即答する (バケットを先に消す forceRefresh 委譲はスタンピードに
-     * なるため使わない)。バケットが有効な間は失敗しても旧バケットが残るだけ (safe 方向)。
-     * 裏フェッチ中に TTL が完全に切れて in-flight へ相乗りした前面リクエストには、通常の
-     * in-flight 共有と同じく失敗が伝播する (相乗りしなくても自前フェッチが同様に失敗する状況)。
-     * in-flight が既に居れば起動しない (前面リクエストの結果で足りる)。
-     */
     private maybeRefreshAhead;
-    /**
-     * Retrieves records from cache or fetches them if expired/missing.
-     * キャッシュからレコードを取得するか、期限切れや未存在の場合はフェッチします。
-     */
     getOrFetch: <T>(opts: {
         cacheKey: string;
         fetcher: () => Promise<readonly T[]>;
-        /**
-         * 本呼び出しが実際にフェッチャーを起動した瞬間に 1 度だけ呼ばれる。
-         *
-         * 「返す配列がこの呼び出し自身の新規フェッチ結果である」ことの**因果的な証明**として使う。
-         * バケットヒット・進行中フェッチへの相乗り・refresh-ahead の裏側更新では**呼ばれない** —
-         * それらの経路が返す配列は本呼び出しより古くなりうるためである。
-         *
-         * ids ストリームはこの合図で高速先頭ページのクエリを起動する。合図の後に始まる以上、
-         * 先頭ページは全量配列より古くなり得ず、「先頭ページに在って全量に無い行 = 削除済み」
-         * という判定が初めて健全になる (逆順を許すと作成直後の日報を削除してしまう)。
-         */
         onFetchStart?: () => void;
     } & SqlResultCacheQueryOptions) => Promise<readonly T[]>;
-    /**
-     * Clears the cache for a specific key.
-     * 指定されたキーのキャッシュをクリアします。
-     */
     flush: (cacheKey: string) => void;
-    /**
-     * Clears all cached buckets and in-flight requests.
-     * すべてのキャッシュバケットと進行中のリクエストを全クリアします。
-     */
     clearAll: () => void;
-    /**
-     * Invalidates cache buckets matching a prefix.
-     * 指定されたプレフィックスに一致するキャッシュバケットを無効化します。
-     */
     invalidatePrefix: (prefix: string) => void;
-    /**
-     * Cleans up all expired cache buckets to prevent memory accumulation.
-     * メモリー蓄積を防ぐため、期限切れのキャッシュバケットをすべてクリーンアップする処理。
-     */
     private cleanExpired;
 }
-
-/**
- * External source adapter contract for legacy/foreign daily-report tables.
- * レガシー・外部由来の日報テーブルを取り込む外部ソースアダプタ契約。
- *
- * DailyReportHub.source_type がアダプタの `sourceType` に一致する行は、
- * `table` を `Hub.source_id_num = idColumn` で LEFT JOIN し、その行を
- * `mapRow` で表示フィールドへ変換する (例: 別システムのレガシー日報テーブルの取り込み)。
- */
-
-/** 外部ソース行から詳細表示へ供給するフィールド群。 */
 type ExternalReportFields = {
     content?: string | null;
     employeeName?: string | null;
@@ -375,29 +133,17 @@ type ExternalReportFields = {
     interviewers?: DailyReportInterviewer[];
     externalComments?: DailyReportExternalComment[];
 };
-/** 外部ソースアダプタ。 */
 type DailyReportExternalSource = {
-    /** DailyReportHub.source_type の一致値 (例 "legacy")。 */
     sourceType: string;
-    /** LEFT JOIN する drizzle テーブル。 */
     table: unknown;
-    /** Hub.source_id_num と突き合わせる ID 列。 */
     idColumn: AnyMsSqlColumn;
-    /** 結合行を表示フィールドへ変換する処理。 */
     mapRow: (row: Record<string, unknown>) => ExternalReportFields;
 };
-/**
- * Parses JSON array payloads and maps each element (fail-soft: returns [] on error).
- * JSON 配列のペイロードを解析し各要素を変換する処理 (エラー時は空配列)。
- */
 declare const transformJsonArray: <TRaw, TResult>(payload: string | null, label: string, mapper: (raw: TRaw) => TResult | null, logger?: DailyReportLogger) => TResult[];
-
-/** 注入する外部ユーザーテーブルの最小形 (id / display_name)。 */
 type DailyReportUserTable = {
     id: AnyMsSqlColumn;
     displayName: AnyMsSqlColumn;
 };
-/** DailyReportHub テーブルの構造形。 */
 type DailyReportHubTable = {
     id: AnyMsSqlColumn;
     sourceType: AnyMsSqlColumn;
@@ -414,7 +160,6 @@ type DailyReportHubTable = {
     deletedAt: AnyMsSqlColumn;
     deletedBy: AnyMsSqlColumn;
 };
-/** DailyReportInternal テーブルの構造形。 */
 type DailyReportInternalTable = {
     hubId: AnyMsSqlColumn;
     body: AnyMsSqlColumn;
@@ -424,7 +169,6 @@ type DailyReportInternalTable = {
     updatedAt: AnyMsSqlColumn;
     updatedBy: AnyMsSqlColumn;
 };
-/** 投稿コメントテーブル (物理名 DailyReportComment) の構造形。 */
 type DailyReportCommentTable = {
     id: AnyMsSqlColumn;
     hubId: AnyMsSqlColumn;
@@ -435,7 +179,6 @@ type DailyReportCommentTable = {
     updatedAt: AnyMsSqlColumn;
     updatedBy: AnyMsSqlColumn;
 };
-/** DailyReportLabel テーブルの構造形。 */
 type DailyReportLabelTable = {
     id: AnyMsSqlColumn;
     userId: AnyMsSqlColumn;
@@ -447,14 +190,12 @@ type DailyReportLabelTable = {
     updatedAt: AnyMsSqlColumn;
     updatedBy: AnyMsSqlColumn;
 };
-/** DailyReportHub_Label 中間テーブルの構造形。 */
 type DailyReportHubLabelTable = {
     hubId: AnyMsSqlColumn;
     labelId: AnyMsSqlColumn;
     createdAt: AnyMsSqlColumn;
     createdBy: AnyMsSqlColumn;
 };
-/** DailyReportUserStatus テーブルの構造形。 */
 type DailyReportUserStatusTable = {
     hubId: AnyMsSqlColumn;
     userId: AnyMsSqlColumn;
@@ -465,13 +206,6 @@ type DailyReportUserStatusTable = {
     updatedAt: AnyMsSqlColumn;
     updatedBy: AnyMsSqlColumn;
 };
-/**
- * DailyReportAttachment テーブルの構造形。
- *
- * `uploadedBy` は外部取込ソース由来の行に投稿者が存在しないため NULL 許容。
- * `sourceKey` は取込の冪等 upsert の自然キー。
- * `objectCheckedAt` / `objectMissingAt` から実体存在の三値 (unknown / present / absent) を導出する。
- */
 type DailyReportAttachmentTable = {
     id: AnyMsSqlColumn;
     hubId: AnyMsSqlColumn;
@@ -488,13 +222,6 @@ type DailyReportAttachmentTable = {
     updatedAt: AnyMsSqlColumn;
     updatedBy: AnyMsSqlColumn;
 };
-/**
- * サービスへ注入するテーブル一式 (アプリ既存モデルまたは本ファクトリ生成物)。
- *
- * `attachment` のみ任意。添付テーブルを持たない消費アプリでも本パッケージを使えるようにするため。
- * 未注入時は詳細の `attachments` が常に空配列になり、添付エンドポイントは全トークンで 404 を返す
- * (意図した縮退動作)。
- */
 type DailyReportTables = {
     hub: DailyReportHubTable;
     internal: DailyReportInternalTable;
@@ -504,13 +231,6 @@ type DailyReportTables = {
     hubLabel: DailyReportHubLabelTable;
     userStatus: DailyReportUserStatusTable;
 };
-/**
- * Generic factory: build the seven daily-report tables under an arbitrary schema name.
- * 任意のスキーマ名の下に日報 7 テーブルを生成する汎用ファクトリ。
- *
- * 制約・索引名は `${schemaName}_<Table>_...` 規約で生成する。
- * ユーザーテーブルへの FK は注入された `userTable` を参照する。
- */
 declare function defineDailyReportSchema<S extends string>(schemaName: S, opts: {
     userTable: DailyReportUserTable;
 }): {
@@ -545,7 +265,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -561,7 +284,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -627,7 +353,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -643,7 +372,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -675,7 +407,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -707,7 +442,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -739,7 +477,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -778,7 +519,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -794,7 +538,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -826,7 +573,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -858,7 +608,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -929,7 +682,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -961,7 +717,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -993,7 +752,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1064,7 +826,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1080,7 +845,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1096,7 +864,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1112,7 +883,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1192,7 +966,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1224,7 +1001,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1279,7 +1059,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1295,7 +1078,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1343,7 +1129,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1375,7 +1164,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1446,7 +1238,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1549,7 +1344,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1581,7 +1379,10 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
                 isPrimaryKey: false;
                 isAutoincrement: false;
                 hasRuntimeDefault: false;
-                enumValues: [string, ...string[]];
+                enumValues: [
+                    string,
+                    ...string[]
+                ];
                 baseColumn: never;
                 identity: undefined;
                 generated: undefined;
@@ -1590,207 +1391,22 @@ declare function defineDailyReportSchema<S extends string>(schemaName: S, opts:
         dialect: "mssql";
     }>;
 };
-
-/**
- * Source-type visibility set: normalization, digest, and predicate helpers.
- * sourceType 可視集合の正規化・ダイジェスト・判定ヘルパー群。
- *
- * 中立文字列 (`DailyReportHub.sourceType` の値) のみを扱い、いかなる認可パッケージの型にも
- * 依存しない。可視集合は 2 状態を厳密に区別する:
- *
- * - `null`  = 無制限 (全件)。ポート未注入時の既定であり、現行互換の意味を持つ。
- * - `Set`   = その集合に限定。**空集合は 0 件 (fail-close)** であって無制限ではない。
- *
- * この 2 状態の取り違えは情報漏洩か機能停止に直結するため、判定・畳み込み・キー生成を
- * 本ファイルへ一元化し、ハンドラ層とサービス層の双方がここだけを参照する。
- *
- * 閲覧範囲は**次元ごと**にこの 2 状態を持つ:
- *
- * - `visible`    = 本文 (日報行) を閲覧してよい区分。
- * - `commentable` = コメントを閲覧・記入してよい区分。常に `visible` の部分集合。
- *
- * 次元が増えても状態数は増やさない。「もう一方の次元に従う」は
- * {@link DailyReportViewerScope.restrictTo} が**構築時に解決**するため、各次元は最後まで
- * 厳密に 2 状態であり、本ファイルの判定ヘルパーは次元を問わずそのまま適用できる。
- */
-
-/**
- * Normalized visible set. null = unrestricted (all rows), ReadonlySet = restricted (empty = zero rows).
- * 正規化済みの可視集合。null は無制限 (全件)、ReadonlySet は限定 (空集合は 0 件)。
- */
 type VisibleSourceTypeSet = ReadonlySet<string> | null;
-/**
- * Normalizes a raw resolver return into a VisibleSourceTypeSet.
- * ポートの生戻り値を正規化済み可視集合へ変換する処理。
- *
- * `null` / `undefined` は無制限 (`null`) へ。配列は各要素を畳み込み・空文字除去・重複排除して
- * `Set` 化する。**空配列は空 `Set` (0 件) を返し、`null` (無制限) へは決して倒さない** —
- * この取り違えが情報漏洩か機能停止に直結するため。
- *
- * ❗ 引数は**単一次元のトークン配列に限る**。次元別オブジェクト
- * ({@link DailyReportVisibilityDimensions}) をここへ渡すと配列ガードに掛かって全拒否になるため、
- * 次元の解体は {@link DailyReportViewerScope.restrictTo} が行い、ここには常に配列だけが届く。
- *
- * ❗ オーバーロードで「**配列を渡した場合は決して `null` (無制限) を返さない**」という不変条件を
- * 型に載せている。これは実装の偶然ではなく本ファイルの中核契約 (空配列は 0 件であって無制限では
- * ない) そのものであり、呼び出し側が `null` 分岐を書いて無制限へ倒す余地を型で塞ぐ。
- *
- * @param raw Raw single-dimension resolver value. 単一次元の生値。
- * @returns Normalized visible set. 正規化済みの可視集合。
- */
 declare function normalizeVisibleSourceTypes(raw: readonly string[]): ReadonlySet<string>;
 declare function normalizeVisibleSourceTypes(raw: readonly string[] | null | undefined): VisibleSourceTypeSet;
-/**
- * Tests whether a report's sourceType is visible under the given set.
- * ある日報の sourceType が可視集合に含まれるかの三値判定。
- *
- * - 無制限 (`null`): 常に `true`。
- * - 限定 + sourceType 判明: 畳み込み一致で判定。
- * - 限定 + sourceType 不明 (`null` / `undefined`): `false` — 制限された閲覧者は「不明な区分」を
- *   見られない。区分を運ばない旧 SSE エントリ等を fail-close 側へ倒すための規則。
- *
- * @param set Normalized visible set. 正規化済みの可視集合。
- * @param sourceType The row's source type, if known. 判明していれば当該行のソース種別。
- * @returns True when visible. 可視なら true。
- */
 declare function isSourceTypeVisible(set: VisibleSourceTypeSet, sourceType: string | null | undefined): boolean;
-/**
- * Tells whether the set denies everything (zero rows).
- * 可視集合が全拒否 (0 件) を意味するかを判定する処理。
- *
- * 真のとき呼び出し側は DB へ問い合わせず即座に空を返してよい (無駄クエリの排除)。
- * これは性能上の短絡であり、認可の防御そのものは {@link buildVisibleSourceTypeCondition} が担う。
- *
- * @param set Normalized visible set. 正規化済みの可視集合。
- * @returns True when nothing is visible. 何も可視でないなら true。
- */
 declare function deniesEverySourceType(set: VisibleSourceTypeSet): boolean;
-/**
- * Builds the SQL condition restricting rows to the visible source types.
- * 可視 sourceType へ行を限定する SQL 条件を生成する処理 (三値)。
- *
- * {@link isSourceTypeVisible} の SQL 版であり、同じ三値を同じ向きへ写像する:
- *
- * - 無制限 (`null`): `undefined` を返す。drizzle の `and(...)` は `undefined` を無視するため、
- *   既存の述語がそのまま残る (現行互換)。
- * - 全拒否 (空集合): `1 = 0` を返す。**決して `undefined` へ倒さない** — 呼び出し側の短絡漏れが
- *   あっても生成器自身が fail-close する二重防御であり、ここを緩めると認可が反転する。
- * - 限定: `LOWER(<column>) IN (...)`。トークンは正規化時に小文字畳み込み済みなので両辺が小文字となり、
- *   DB の照合順序 (collation) に依存せず決定的に大小文字非依存で一致する。
- *
- * @param sourceTypeColumn The source-type column to constrain. 制限対象の sourceType 列。
- * @param set Normalized visible set. 正規化済みの可視集合。
- * @returns Condition, or undefined when unrestricted. 条件 (無制限なら undefined)。
- */
 declare function buildVisibleSourceTypeCondition(sourceTypeColumn: AnyMsSqlColumn, set: VisibleSourceTypeSet): SQL | undefined;
-/**
- * Request-scoped viewer scope carrying the normalized visible source-type set.
- * 正規化済みの可視 sourceType 集合を運ぶ、リクエストスコープの閲覧範囲。
- *
- * このクラスは private フィールドを持つことで**名目型**になっており、`{ visible: null }` のような
- * 構造的偽造も、`{ ...scope, visible: null }` のようなスプレッドによる widening も型が拒否する
- * (`unique symbol` ブランドでは後者を防げないことを実測で確認済み)。
- *
- * 生成経路は {@link DailyReportViewerScope.restrictTo} と {@link DailyReportViewerScope.unrestricted}
- * の 2 つだけであり、`null` を「可視性」としてそのまま綴ることはできない。結果として、
- * **絞り込まれない読み取りは必ず `unrestricted(理由)` として現れる**ため、
- * `grep -rn "DailyReportViewerScope.unrestricted("` が fail-open の全数リストになる。
- */
 declare class DailyReportViewerScope {
     #private;
     private constructor();
-    /** 正規化済みの本文可視集合。`null` は無制限、空集合は 0 件 (fail-close)。 */
     get visible(): VisibleSourceTypeSet;
-    /**
-     * 正規化済みのコメント可視集合。`null` は無制限、空集合は 0 件 (fail-close)。
-     *
-     * 常に `visible` の部分集合である (構築時に積集合を取っているため)。
-     */
     get commentable(): VisibleSourceTypeSet;
-    /**
-     * Builds a scope restricted to the given source types (empty input = zero rows).
-     * 指定した sourceType へ限定した閲覧範囲を生成する処理 (空入力は 0 件)。
-     *
-     * 入力は {@link normalizeVisibleSourceTypes} を通るため、大小文字・前後空白・重複・非文字列は
-     * ここで吸収される。素の配列は `{ read: <配列> }` と同義で、コメント次元は `read` に従う。
-     *
-     * ❗ 引数は `null` / `undefined` を**受け付けない**。受け付けると「restrict」という名前のまま
-     * 無制限スコープを生む第 2 の入口になり、「絞り込まれない読み取りは必ず
-     * {@link DailyReportViewerScope.unrestricted} に現れる」という監査不変条件が崩れる。
-     * 無制限は必ず理由付きで明示すること。
-     *
-     * ❗ 判別に `Array.isArray` を使ってはならない。型述語が `arg is any[]` であり
-     * `readonly string[]` を負の分岐から除去できないため、`.read` 参照が TS2339 になる
-     * (実測済み)。`"read" in input` で判別する。文字列など object でない契約違反入力は
-     * `in` が実行時に throw するので、先に `typeof` で弾いてから
-     * {@link normalizeVisibleSourceTypes} の fail-close 経路へ落とす。
-     *
-     * @param input Visible source-type tokens, or per-dimension sets. 可視 sourceType のトークン群、または次元別の集合。
-     * @returns The scope. 生成した閲覧範囲。
-     */
     static restrictTo(input: readonly string[] | DailyReportVisibilityDimensions): DailyReportViewerScope;
-    /**
-     * Builds an unrestricted scope; every call site is an audited fail-open.
-     * 無制限の閲覧範囲を生成する処理。全呼び出し箇所が監査対象の fail-open となる。
-     *
-     * ❗ 理由文字列は必須。読み捨てるが、呼び出し箇所の全数列挙と「なぜここは絞らなくてよいか」の
-     * 記録を強制するために受け取る。
-     *
-     * ❗ **両次元**を無制限にする。片方だけ残すと「無制限」という名前が嘘になり、監査 grep の
-     * 結果が「絞られていない読み取りの全数」でなくなる。
-     *
-     * @param auditReason Why unrestricted access is correct here. なぜここで無制限が正当かの理由。
-     * @returns The unrestricted scope. 無制限の閲覧範囲。
-     */
     static unrestricted(auditReason: string): DailyReportViewerScope;
 }
-/**
- * Computes the cache-key digest for a whole viewer scope (all dimensions).
- * 閲覧範囲全体 (全次元) からキャッシュキー用ダイジェストを算出する処理。
- *
- * スコープに次元が増えてもキャッシュキーの生成点を 1 つに保つための入口。
- *
- * ❗ **必ず全次元を畳み込むこと。** 本文次元だけを畳み込むと、コメント権限だけを剥奪された
- * 同一ユーザーが剥奪前のキャッシュバケットを共有し続け、TTL の間コメント本文入りの詳細を
- * 受け取り続ける (キーが変わらないため無効化も走らない)。
- *
- * 両次元が一致する既定形 (コメント次元が `read` に従う) では**本文のみのダイジェストと同一値**を
- * 返す。既存配備のキャッシュキーは 1 文字も変わらず、キャッシュ再利用率は無退行となる。
- * 次元が分かれるときだけ `d:` 名前空間の下へ**長さ接頭辞付きで連結**するため、写像は単射であり
- * sentinel (`all` / `none`) や単一次元表記 (`s:` / `sh:`) と衝突しない。
- *
- * @param scope Viewer scope. 閲覧範囲。
- * @returns Digest usable as a cache-key component. キャッシュキー構成要素として使えるダイジェスト。
- */
 declare function computeViewerScopeDigest(scope: DailyReportViewerScope): string;
-/**
- * Computes a stable and bounded cache-key digest of the set.
- * 可視集合から安定・有界なキャッシュキー用ダイジェストを算出する処理。
- *
- * 無制限は `"all"`、空集合は `"none"`、それ以外は `s:` 名前空間の下へ**長さ接頭辞付きトークンを昇順連結**する。
- * 連結は長さ接頭辞付きなので**単射**であり、通常経路 (`s:`) では論理的に等価な集合が必ず同一の、
- * 異なる集合が必ず別のダイジェストになる。sentinel (`all` / `none`) とも名前空間が分かれるため、
- * 限定集合が無制限 / 全拒否と同じバケットを共有することはない。権限が安定している間はキーが
- * 不変になるため、キャッシュは完全に再利用される (性能無退行)。
- *
- * ❗ 区分数が異常に多い場合だけキー長を抑えるため FNV-1a 32bit へ退避し `sh:` 接頭辞を付ける。
- * **この退避経路に限り理論上の衝突がありうる** (32bit)。衝突しても影響は同一ユーザーの
- * キャッシュ再利用に留まり、認可判定そのものは SQL 述語が担うため漏洩には至らない。
- * 通常の区分数 (数個) では到達しない。
- *
- * @param set Normalized visible set. 正規化済みの可視集合。
- * @returns Digest usable as a cache-key component. キャッシュキー構成要素として使えるダイジェスト。
- */
 declare function computeSourceTypeDigest(set: VisibleSourceTypeSet): string;
-
-/**
- * Data-access service for daily reports (drizzle mssql), fully DI-configured.
- * 日報データアクセスサービス (drizzle mssql)。依存はすべて DI で注入する。
- *
- * キャッシュキー・無効化順序・SSE publish 順序を含むデータアクセスロジックの中核。
- */
-
-/** DailyReportHub の行型。 */
 type DailyReportHubRow = {
     id: number;
     sourceType: string;
@@ -1807,7 +1423,6 @@ type DailyReportHubRow = {
     deletedAt: Date | string | null;
     deletedBy: string | null;
 };
-/** DailyReportInternal の行型。 */
 type DailyReportInternalRow = {
     hubId: number;
     body: string | null;
@@ -1817,7 +1432,6 @@ type DailyReportInternalRow = {
     updatedAt: Date | string;
     updatedBy: string;
 };
-/** DailyReportUserStatus の行型。 */
 type DailyReportUserStatusRow = {
     hubId: number;
     userId: number;
@@ -1828,7 +1442,6 @@ type DailyReportUserStatusRow = {
     updatedAt: Date | string;
     updatedBy: string;
 };
-/** 投稿コメント行 (物理テーブル DailyReportComment) の行型。 */
 type DailyReportCommentRow = {
     id: number;
     hubId: number;
@@ -1865,7 +1478,6 @@ interface UpdateChain<T> {
 interface DeleteChain {
     where(cond: unknown): PromiseLike<unknown>;
 }
-/** サービスが要求する drizzle mssql データベースの最小面 (トランザクション込み)。 */
 interface DailyReportDb {
     select<T = Record<string, unknown>>(fields?: unknown): SelectChain<T>;
     insert<T = Record<string, unknown>>(t: unknown): InsertChain<T>;
@@ -1874,82 +1486,28 @@ interface DailyReportDb {
     transaction<T>(fn: (tx: DailyReportDb) => Promise<T>, config?: unknown): Promise<T>;
 }
 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 の返却型。 */
 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 からは到達しない文字列入力のみの領域)。
- */
 declare const formatDateValue: (value: Date | string | null | undefined, pattern: DatePattern) => string | null;
 declare function createDailyReportService(config: DailyReportServiceConfig): {
     streamKey: string;
@@ -1991,45 +1549,17 @@ declare function createDailyReportService(config: DailyReportServiceConfig): {
     updateDailyReportInternal: (tx: DailyReportDb, hubId: number, data: Partial<DailyReportInternalRow>) => Promise<void>;
     deleteDailyReportLabel: (tx: DailyReportDb, hubId: number, labelId: number) => Promise<void>;
 };
-
-/**
- * Fan-Out shared reader for the daily report SSE Redis Stream.
- * 日報 SSE 用 Redis Stream の共有リーダーモジュール。
- *
- * 単一の xRead BLOCK ループで全接続にメッセージをブロードキャストし、
- * 接続ごとに Redis TCP を張る問題を解消する。
- */
-
-/**
- * Compares two Redis Stream IDs numerically.
- * Redis Stream ID を数値比較し、a <= b なら true を返す。
- *
- * Stream ID は `<timestamp_ms>-<sequence>` 形式。
- * 辞書順比較では sequence が可変長のとき不正確になるため、数値分割で比較する。
- */
 declare const isStreamIdLte: (a: string, b: string) => boolean;
-/** xRead 結果の 1 エントリに相当する型。 */
 type StreamEntry = {
     id: string;
     message: Record<string, string>;
 };
 type DailyReportSseReaderConfig = {
-    /** ブロッキング xRead 用の専用クライアントを生成する redis プロバイダー。 */
     redis?: DailyReportRedisProvider;
-    /** SSE Redis Stream キー。 */
     streamKey: string;
-    /** 受信メッセージに応じてローカル SQL キャッシュを無効化する対象キャッシュ。 */
     cache: SqlResultCache;
-    /** ロガー (既定は console ベース)。 */
     logger?: DailyReportLogger;
 };
-/**
- * Shared xRead loop that fans out entries to all active SSE connections.
- * 全 SSE 接続に対してメッセージをファンアウトする共有 xRead ループ。
- *
- * - "entry" イベント: 新着エントリ (StreamEntry) をブロードキャスト
- * - "error" イベント: 回復不能エラーをブロードキャスト
- * */
 declare class DailyReportSseReader {
     private readonly config;
     private _emitter;
@@ -2039,38 +1569,12 @@ declare class DailyReportSseReader {
     private _client;
     private readonly _logger;
     constructor(config: DailyReportSseReaderConfig);
-    /**
-     * Subscribes to the shared reader. Starts the loop on first subscriber.
-     * 共有リーダーを購読する。最初の購読者でループを開始する。
-     *
-     * @param onEntry - 新着エントリのコールバック
-     * @param onError - 回復不能エラーのコールバック (省略可)
-     * @returns unsubscribe 関数。呼び出すと両リスナーを解除し、最後の購読者解除でループを停止する。
-     */
     subscribe(onEntry: (entry: StreamEntry) => void, onError?: (err: Error) => void): () => void;
-    /**
-     * Destroys the reader for test cleanup.
-     * テストクリーンアップ用のデストラクタ。
-     */
     destroy(): Promise<void>;
-    /**
-     * Internal xRead BLOCK loop.
-     * 内部 xRead BLOCK ループ。
-     */
     private _startLoop;
-    /**
-     * Stops the xRead loop by closing the client.
-     * クライアントを閉じて xRead ループを停止する。
-     */
     private _stopLoop;
-    /**
-     * Emits an "error" event only when a listener exists (bare "error" emit throws).
-     * リスナーが居るときだけ "error" イベントを emit する処理 (リスナー 0 の "error" emit は
-     * EventEmitter 仕様で throw し、非同期文脈では unhandled rejection = プロセス危険になるため)。
-     */
     private _emitError;
 }
-
 type AuthzResourceItem = {
     resourceKey: string;
     name: string;
@@ -2082,15 +1586,7 @@ type DailyReportSourceTypeInput = {
     description?: string | null;
     includeCommentResource?: boolean;
 };
-/**
- * Dynamically builds neutral Authz resource definitions from provided source type inputs.
- * 指定されたソース種別定義から中立な認可リソース定義リストを生成するファクトリ。
- */
 declare function defineDailyReportAuthzResources(sources?: DailyReportSourceTypeInput[]): AuthzResourceItem[];
-/**
- * Ensures all daily-report standard resources exist in the authz TMResource table idempotently.
- * authz データベース内に日報機能の標準認可リソースが存在することを自動保証（冪等シード）する処理。
- */
 declare function seedDailyReportAuthzResources(db: unknown, authzTables: {
     TMResource: unknown;
 }, opts: {
@@ -2099,102 +1595,31 @@ declare function seedDailyReportAuthzResources(db: unknown, authzTables: {
     sources?: DailyReportSourceTypeInput[];
     resources?: AuthzResourceItem[];
 }): Promise<void>;
-
-/**
- * Generates a SHA-256 ETag for the given data.
- * 指定されたデータの SHA-256 ETag を生成します。
- *
- * @param data The data to hash (will be JSON stringified).
- * @returns The ETag string (wrapped in quotes).
- */
 declare const generateETag: (data: unknown) => string;
-
 type LoaderArgs = {
     request: Request;
     params: Record<string, string | undefined>;
 };
-/**
- * Accepts a media type only when it is header-safe and well-formed.
- * ヘッダー安全かつ MIME 型の形をしている場合のみ採用する処理。
- *
- * CR/LF や 0x00-0xFF 外の文字が混ざった値を `new Headers()` へ渡すと TypeError になり、
- * 認可済みのダウンロードが 500 になる。
- *
- * **これは第 2 層である。** 現在の配信経路では、注入値はインライン許可リストに完全一致しないため
- * 必ず `application/octet-stream` へ落ち、ヘッダーには到達しない。つまり本関数を外しても
- * 現状の挙動は変わらない (ミューテーションテストで確認済み)。
- * 許可判定を前方一致や「DB の型を信じる」形へ変えた瞬間に効き始める防御なので、
- * 到達不能なまま放置せず **直接の単体テストで固定する**目的でエクスポートしている。
- *
- * @param value Candidate media type. 候補となる media type。
- * @returns The value when acceptable, otherwise null. 採用可なら値、それ以外は null。
- */
 declare const sanitizeMediaType: (value: string | null | undefined) => string | null;
-/**
- * Percent-encodes a file name for the RFC 8187 `filename*` parameter.
- * RFC 8187 の `filename*` 用にファイル名をパーセントエンコードする処理。
- *
- * `encodeURIComponent` は `'` `(` `)` `*` を残すが、いずれも RFC 8187 の attr-char ではない。
- *
- * @param name Raw file name. 生のファイル名。
- * @returns Encoded value. エンコード済みの値。
- */
 declare const encodeRfc8187: (name: string) => string;
-/**
- * Builds the ASCII fallback used by the plain `filename` parameter.
- * 素の `filename` パラメータ用の ASCII フォールバックを組み立てる処理。
- *
- * @param name Raw file name. 生のファイル名。
- * @returns ASCII-only, quote-free name. ASCII のみで引用符を含まない名前。
- */
 declare const asciiFallbackFileName: (name: string) => string;
 type DailyReportHandlersConfig = {
-    /** リクエスト認証ポート。 */
     authenticate: DailyReportAuthenticate;
-    /**
-     * 可視 sourceType リゾルバ。未注入なら全件 (現行互換)。
-     * 全データ経路 (一覧 / 詳細 / コメント / 添付 / SSE) に一貫して効き、例外は全拒否として扱う。
-     */
     resolveVisibleSourceTypes?: DailyReportResolveVisibleSourceTypes;
-    /** データアクセスサービス。 */
     service: DailyReportService;
-    /** 内部数値 ID の難読化ポート。 */
     encodeUserId: DailyReportEncodeUserId;
-    /**
-     * 添付 ID の難読化コーデック。未注入なら添付エンドポイントは常に 404。
-     * ユーザー ID 用とは別インスタンスを渡すこと (ID 空間の分離)。
-     */
     attachmentIdCodec?: DailyReportIdCodec;
-    /** 添付ファイル読み取りポート。未注入なら添付エンドポイントは常に 404。 */
     readAttachment?: DailyReportReadAttachment;
-    /** 添付ファイルの最大バイト数 (既定 32 MiB)。サービス側のワイヤ上限より低く保つこと。 */
     attachmentMaxBytes?: number;
-    /** 添付エンドポイントの 1 分あたり呼び出し上限 (ユーザー単位・既定 60)。 */
     attachmentRateLimitPerMinute?: number;
-    /** 添付読み取りの同時実行上限 (プロセス単位・既定 4)。 */
     attachmentConcurrency?: number;
-    /** SSE 用 redis プロバイダー (catch-up の xRange / xRevRange に使用)。 */
     redis?: DailyReportRedisProvider;
-    /** SSE Fan-Out 共有リーダー。 */
     sseReader: DailyReportSseReader;
-    /** SSE Redis Stream キー。 */
     streamKey: string;
-    /** 未ログイン時のリダイレクト先 (index.loader 用、既定 "/auth/login")。 */
     loginRedirectPath?: string;
-    /**
-     * `intent=clearCache` (全サーバーキャッシュの一括破棄) を許可するか。既定 false。
-     * 開発用アフォーダンスであり、有効化すると認証済みユーザーなら誰でも全ワーカーの
-     * キャッシュを無制限に破棄できるため、本番では必ず無効のままにする
-     * (消費アプリは開発環境でのみ true を注入する)。
-     */
     enableDevCacheClear?: boolean;
-    /** ロガー (既定は console ベース)。 */
     logger?: DailyReportLogger;
 };
-/**
- * Creates the daily-report loaders/actions bound to the injected dependencies.
- * 注入依存に束縛された日報 loader / action 群を生成する処理。
- */
 declare function createDailyReportHandlers(config: DailyReportHandlersConfig): {
     index: {
         loader: ({ request }: LoaderArgs) => Promise<{
@@ -2218,62 +1643,19 @@ declare function createDailyReportHandlers(config: DailyReportHandlersConfig): {
         loader: ({ request, params }: LoaderArgs) => Promise<Response>;
     };
 };
-
-/**
- * JSON response helper with shared security headers and ETag support.
- * 共有セキュリティヘッダーと ETag 対応を備えた JSON レスポンスヘルパー。
- */
-
-/**
- * Creates JSON response with shared security headers and ETag support.
- * 共有のセキュリティヘッダーと ETag サポート付き JSON レスポンスを生成。
- */
 declare const jsonResponseWithETag: (request: Request, cookie: string | null, payload: Record<string, unknown>, status?: number, logger?: DailyReportLogger) => Response;
-
-/** createDailyReportServer の設定 (サービス設定 + 認証ポート + ハンドラ設定)。 */
 type DailyReportServerConfig = Omit<DailyReportServiceConfig, "cache" | "epochs"> & {
-    /** リクエスト認証ポート。 */
     authenticate: DailyReportAuthenticate;
-    /**
-     * 可視 sourceType リゾルバ。未注入なら全件 (現行互換)。
-     *
-     * サーバー側の全データ経路 (一覧 / 詳細 / コメント / 添付 / SSE) に一貫して効く。
-     * 戻り値は `DailyReportHub.sourceType` の値 (`knownSourceTypes` 参照) であり、認可リソースキーではない。
-     * `undefined` / `null` は無制限、空配列は 0 件、例外は全拒否 (fail-close)。
-     */
     resolveVisibleSourceTypes?: DailyReportResolveVisibleSourceTypes;
-    /** 添付ファイル読み取りポート。未注入なら添付エンドポイントは常に 404。 */
     readAttachment?: DailyReportReadAttachment;
-    /** 添付ファイルの最大バイト数 (既定 32 MiB)。サービス側のワイヤ上限より低く保つこと。 */
     attachmentMaxBytes?: number;
-    /** 添付エンドポイントの 1 分あたり呼び出し上限 (ユーザー単位・既定 60)。 */
     attachmentRateLimitPerMinute?: number;
-    /** 添付読み取りの同時実行上限 (プロセス単位・既定 4)。 */
     attachmentConcurrency?: number;
-    /** 未ログイン時のリダイレクト先 (index.loader 用、既定 "/auth/login")。 */
     loginRedirectPath?: string;
-    /**
-     * `intent=clearCache` (全サーバーキャッシュの一括破棄) を許可するか。既定 false。
-     * 開発用アフォーダンス。有効化すると認証済みなら誰でも全ワーカーのキャッシュを
-     * 無制限破棄できるため、本番では無効のままにする (消費アプリは開発環境のみ true 注入)。
-     */
     enableDevCacheClear?: boolean;
-    /** SQL 結果キャッシュの既定 TTL (既定 60,000ms)。 */
     cacheDefaultTtlMs?: number;
-    /** 外部ソースアダプタ群 (レガシー日報テーブル等)。 */
     externalSources?: DailyReportExternalSource[];
 };
-/**
- * One-stop factory wiring cache, service, SSE fan-out reader, and route handlers.
- * キャッシュ・サービス・SSE Fan-Out リーダー・ルートハンドラを一括結線するファクトリ。
- *
- * @example
- * const server = createDailyReportServer({ db, tables, userTable, resolveUserId, encodeUserId, authenticate, redis })
- * // routes:
- * //   daily_report._index      → server.index.loader (+ data() ラップ)
- * //   daily_report.api.$endpoint → server.api.loader / server.api.action
- * //   sse.daily_report.$endpoint → server.sse.loader
- */
 declare function createDailyReportServer(config: DailyReportServerConfig): {
     index: {
         loader: ({ request }: {
@@ -2311,7 +1693,6 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
             params: Record<string, string | undefined>;
         }) => Promise<Response>;
     };
-    /** データアクセスサービス (CRUD + キャッシュ + SSE publish)。 */
     service: {
         streamKey: string;
         streamMaxLen: number;
@@ -2352,24 +1733,13 @@ declare function createDailyReportServer(config: DailyReportServerConfig): {
         updateDailyReportInternal: (tx: DailyReportDb, hubId: number, data: Partial<DailyReportInternalRow>) => Promise<void>;
         deleteDailyReportLabel: (tx: DailyReportDb, hubId: number, labelId: number) => Promise<void>;
     };
-    /** SQL 結果キャッシュ (サービス・SSE リーダー共有インスタンス)。 */
     cache: SqlResultCache;
-    /** クロスワーカー epoch ストア。 */
     epochs: {
         getEpoch(epochKey: string): Promise<number | null>;
         incrementEpoch(epochKey: string): Promise<void>;
     };
-    /** SSE Fan-Out 共有リーダー。 */
     sseReader: DailyReportSseReader;
-    /** SSE Redis Stream キー。 */
     streamKey: string;
-    /**
-     * 既知の正準 sourceType 集合 (注入した `externalSources` の全 sourceType + `"Internal"`)。
-     *
-     * `resolveVisibleSourceTypes` が返すべき語彙そのものであり、消費側は起動時にこの集合と
-     * 自前のマッピングを突き合わせて誤トークン (無診断で 0 件になる) を検出できる。
-     */
     knownSourceTypes: readonly string[];
 };
-
 export { type AuthzResourceItem, type DailyReportAttachmentBytes, type DailyReportAttachmentError, type DailyReportAttachmentFailure, type DailyReportAttachmentTable, type DailyReportAuthResult, type DailyReportAuthenticate, type DailyReportCommentRow, type DailyReportCommentTable, type DailyReportDb, type DailyReportEncodeUserId, type DailyReportExternalSource, type DailyReportHandlersConfig, type DailyReportHubLabelTable, type DailyReportHubRow, type DailyReportHubTable, type DailyReportIdCodec, type DailyReportInternalRow, type DailyReportInternalTable, type DailyReportLabelTable, type DailyReportReadAttachment, type DailyReportRedisBlockingClient, type DailyReportRedisClient, type DailyReportRedisProvider, type DailyReportResolveUserId, type DailyReportResolveVisibleSourceTypes, type DailyReportServerConfig, type DailyReportService, type DailyReportServiceConfig, type DailyReportSourceTypeInput, DailyReportSseReader, type DailyReportSseReaderConfig, type DailyReportTables, type DailyReportUserStatusRow, type DailyReportUserStatusTable, type DailyReportUserTable, DailyReportViewerScope, type DailyReportVisibilityDimensions, type DailyReportVisibilityResolveContext, type DailyReportVisibilityResolveReason, type DailyReportVisibleSourceTypes, type EpochStore, type ExternalReportFields, type RedisStreamMessage, SqlResultCache, type SqlResultCacheQueryOptions, type StreamEntry, type VisibleSourceTypeSet, asciiFallbackFileName, buildVisibleSourceTypeCondition, computeSourceTypeDigest, computeViewerScopeDigest, createDailyReportHandlers, createDailyReportServer, createDailyReportService, createEpochStore, defineDailyReportAuthzResources, defineDailyReportSchema, deniesEverySourceType, encodeRfc8187, formatDateValue, generateETag, isSourceTypeVisible, isStreamIdLte, jsonResponseWithETag, normalizeVisibleSourceTypes, sanitizeMediaType, seedDailyReportAuthzResources, transformJsonArray };