import { withFileLock } from '@main/services/team/fileLock';
import { atomicWriteAsync } from '@main/utils/atomicWrite';
import { createHash } from 'crypto';
import { mkdir, readdir, readFile, rename } from 'fs/promises';
import { dirname, join } from 'path';

import { assessMemberWorkSyncPhase2Readiness } from '../../core/domain';

import type {
  MemberWorkSyncMetricEvent,
  MemberWorkSyncOutboxClaimInput,
  MemberWorkSyncOutboxCountRecentDeliveredInput,
  MemberWorkSyncOutboxEnsureInput,
  MemberWorkSyncOutboxEnsureResult,
  MemberWorkSyncOutboxItem,
  MemberWorkSyncOutboxMarkDeliveredInput,
  MemberWorkSyncOutboxMarkFailedInput,
  MemberWorkSyncOutboxMarkSupersededInput,
  MemberWorkSyncReportIntent,
  MemberWorkSyncReportRequest,
  MemberWorkSyncStatus,
  MemberWorkSyncStatusState,
  MemberWorkSyncTeamMetrics,
} from '../../contracts';
import type {
  MemberWorkSyncAuditJournalPort,
  MemberWorkSyncLoggerPort,
  MemberWorkSyncOutboxStorePort,
  MemberWorkSyncReportStorePort,
  MemberWorkSyncStatusStorePort,
} from '../../core/application';
import type { MemberWorkSyncStorePaths } from './MemberWorkSyncStorePaths';

interface LegacyStatusFile {
  schemaVersion: 1;
  members: Record<string, MemberWorkSyncStatus>;
  metrics?: {
    recentEvents: MemberWorkSyncMetricEvent[];
  };
}

interface MemberStatusFile {
  schemaVersion: 2;
  status: MemberWorkSyncStatus;
}

interface MetricsIndexMember {
  memberName: string;
  state: MemberWorkSyncStatusState;
  agendaFingerprint: string;
  actionableCount: number;
  evaluatedAt: string;
  providerId?: string;
}

interface MetricsIndexFile {
  schemaVersion: 2;
  members: Record<string, MetricsIndexMember>;
  recentEvents: MemberWorkSyncMetricEvent[];
}

interface LegacyPendingReportFile {
  schemaVersion: 1;
  intents: Record<string, MemberWorkSyncReportIntent>;
}

interface MemberReportsFile {
  schemaVersion: 2;
  intents: Record<string, MemberWorkSyncReportIntent>;
}

interface PendingReportsIndexFile {
  schemaVersion: 2;
  items: Record<
    string,
    {
      memberKey: string;
      memberName: string;
      status: MemberWorkSyncReportIntent['status'];
      recordedAt: string;
      processedAt?: string;
    }
  >;
}

interface LegacyOutboxFile {
  schemaVersion: 1;
  items: Record<string, MemberWorkSyncOutboxItem>;
}

interface MemberOutboxFile {
  schemaVersion: 2;
  items: Record<string, MemberWorkSyncOutboxItem>;
}

interface OutboxIndexFile {
  schemaVersion: 2;
  items: Record<
    string,
    {
      memberKey: string;
      memberName: string;
      status: MemberWorkSyncOutboxItem['status'];
      nextAttemptAt?: string;
      updatedAt: string;
      createdAt: string;
    }
  >;
}

type OutboxIndexRoute = OutboxIndexFile['items'][string];
type OutboxDueRoute = [string, OutboxIndexRoute];

export interface JsonMemberWorkSyncStoreDeps {
  auditJournal?: MemberWorkSyncAuditJournalPort;
  logger?: MemberWorkSyncLoggerPort;
  now?: () => Date;
}

function normalizeMemberKey(memberName: string): string {
  return memberName.trim().toLowerCase();
}

function emptyMetricsIndex(): MetricsIndexFile {
  return { schemaVersion: 2, members: {}, recentEvents: [] };
}

function emptyStateCounts(): Record<MemberWorkSyncStatusState, number> {
  return {
    caught_up: 0,
    needs_sync: 0,
    still_working: 0,
    blocked: 0,
    inactive: 0,
    unknown: 0,
  };
}

function isLegacyStatusFile(value: unknown): value is LegacyStatusFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as LegacyStatusFile).schemaVersion === 1 &&
    (value as LegacyStatusFile).members != null &&
    typeof (value as LegacyStatusFile).members === 'object' &&
    !Array.isArray((value as LegacyStatusFile).members)
  );
}

function isMemberStatusFile(value: unknown): value is MemberStatusFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as MemberStatusFile).schemaVersion === 2 &&
    (value as MemberStatusFile).status != null &&
    typeof (value as MemberStatusFile).status === 'object'
  );
}

function isMetricsIndexFile(value: unknown): value is MetricsIndexFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as MetricsIndexFile).schemaVersion === 2 &&
    (value as MetricsIndexFile).members != null &&
    typeof (value as MetricsIndexFile).members === 'object' &&
    Array.isArray((value as MetricsIndexFile).recentEvents)
  );
}

function isLegacyPendingReportFile(value: unknown): value is LegacyPendingReportFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as LegacyPendingReportFile).schemaVersion === 1 &&
    (value as LegacyPendingReportFile).intents != null &&
    typeof (value as LegacyPendingReportFile).intents === 'object' &&
    !Array.isArray((value as LegacyPendingReportFile).intents)
  );
}

function isMemberReportsFile(value: unknown): value is MemberReportsFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as MemberReportsFile).schemaVersion === 2 &&
    (value as MemberReportsFile).intents != null &&
    typeof (value as MemberReportsFile).intents === 'object' &&
    !Array.isArray((value as MemberReportsFile).intents)
  );
}

function isPendingReportsIndexFile(value: unknown): value is PendingReportsIndexFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as PendingReportsIndexFile).schemaVersion === 2 &&
    (value as PendingReportsIndexFile).items != null &&
    typeof (value as PendingReportsIndexFile).items === 'object' &&
    !Array.isArray((value as PendingReportsIndexFile).items)
  );
}

function isLegacyOutboxFile(value: unknown): value is LegacyOutboxFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as LegacyOutboxFile).schemaVersion === 1 &&
    (value as LegacyOutboxFile).items != null &&
    typeof (value as LegacyOutboxFile).items === 'object' &&
    !Array.isArray((value as LegacyOutboxFile).items)
  );
}

function isMemberOutboxFile(value: unknown): value is MemberOutboxFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as MemberOutboxFile).schemaVersion === 2 &&
    (value as MemberOutboxFile).items != null &&
    typeof (value as MemberOutboxFile).items === 'object' &&
    !Array.isArray((value as MemberOutboxFile).items)
  );
}

function isOutboxIndexFile(value: unknown): value is OutboxIndexFile {
  return (
    value != null &&
    typeof value === 'object' &&
    (value as OutboxIndexFile).schemaVersion === 2 &&
    (value as OutboxIndexFile).items != null &&
    typeof (value as OutboxIndexFile).items === 'object' &&
    !Array.isArray((value as OutboxIndexFile).items)
  );
}

function isOutboxTerminal(status: MemberWorkSyncOutboxItem['status']): boolean {
  return status === 'delivered' || status === 'superseded' || status === 'failed_terminal';
}

function canReviveOutboxItem(status: MemberWorkSyncOutboxItem['status']): boolean {
  return status === 'superseded' || (!isOutboxTerminal(status) && status !== 'pending');
}

function canClaimOutboxItem(item: MemberWorkSyncOutboxItem, nowIso: string): boolean {
  if (item.status !== 'pending' && item.status !== 'failed_retryable') {
    return false;
  }
  if (!item.nextAttemptAt) {
    return true;
  }
  return item.nextAttemptAt <= nowIso;
}

function getDueOutboxRoutes(
  index: OutboxIndexFile,
  nowIso: string,
  limit: number
): OutboxDueRoute[] {
  return Object.entries(index.items)
    .filter(([, route]) => route.status === 'pending' || route.status === 'failed_retryable')
    .filter(([, route]) => !route.nextAttemptAt || route.nextAttemptAt <= nowIso)
    .sort((left, right) => {
      const leftTime = left[1].nextAttemptAt ?? left[1].updatedAt;
      const rightTime = right[1].nextAttemptAt ?? right[1].updatedAt;
      return leftTime.localeCompare(rightTime);
    })
    .slice(0, Math.max(0, limit));
}

function stableStringify(value: unknown): string {
  if (value == null || typeof value !== 'object') {
    return JSON.stringify(value);
  }
  if (Array.isArray(value)) {
    return `[${value.map(stableStringify).join(',')}]`;
  }
  const record = value as Record<string, unknown>;
  return `{${Object.keys(record)
    .sort()
    .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
    .join(',')}}`;
}

function buildPendingReportIntentId(request: MemberWorkSyncReportRequest): string {
  const taskIds = [...new Set(request.taskIds ?? [])].sort();
  const payload = {
    teamName: request.teamName,
    memberName: normalizeMemberKey(request.memberName),
    state: request.state,
    agendaFingerprint: request.agendaFingerprint,
    reportToken: request.reportToken ?? '',
    ...(taskIds.length > 0 ? { taskIds } : {}),
    ...(request.note ? { note: request.note } : {}),
    ...(request.leaseTtlMs ? { leaseTtlMs: request.leaseTtlMs } : {}),
    ...(request.source ? { source: request.source } : {}),
  };
  return `member-work-sync-intent:${createHash('sha256')
    .update(stableStringify(payload))
    .digest('hex')}`;
}

function buildMetricEventId(status: MemberWorkSyncStatus, kind: MemberWorkSyncMetricEvent['kind']) {
  return `member-work-sync-metric:${createHash('sha256')
    .update(
      stableStringify({
        teamName: status.teamName,
        memberName: normalizeMemberKey(status.memberName),
        kind,
        state: status.state,
        agendaFingerprint: status.agenda.fingerprint,
        evaluatedAt: status.evaluatedAt,
        reportState: status.report?.state ?? '',
        rejectionCode: status.report?.rejectionCode ?? '',
      })
    )
    .digest('hex')}`;
}

function buildMetricEvents(status: MemberWorkSyncStatus): MemberWorkSyncMetricEvent[] {
  const base = {
    teamName: status.teamName,
    memberName: status.memberName,
    state: status.state,
    agendaFingerprint: status.agenda.fingerprint,
    recordedAt: status.evaluatedAt,
    actionableCount: status.agenda.items.length,
    ...(status.providerId ? { providerId: status.providerId } : {}),
    ...(status.shadow?.previousFingerprint
      ? { previousFingerprint: status.shadow.previousFingerprint }
      : {}),
    ...(status.shadow?.triggerReasons?.length
      ? { triggerReasons: [...status.shadow.triggerReasons] }
      : {}),
    ...(status.report?.state ? { reportState: status.report.state } : {}),
    ...(status.report?.rejectionCode ? { rejectionCode: status.report.rejectionCode } : {}),
  };
  const events: MemberWorkSyncMetricEvent[] = [
    {
      ...base,
      id: buildMetricEventId(status, 'status_evaluated'),
      kind: 'status_evaluated',
    },
  ];
  if (status.shadow?.wouldNudge) {
    events.push({
      ...base,
      id: buildMetricEventId(status, 'would_nudge'),
      kind: 'would_nudge',
    });
  }
  if (status.shadow?.fingerprintChanged) {
    events.push({
      ...base,
      id: buildMetricEventId(status, 'fingerprint_changed'),
      kind: 'fingerprint_changed',
    });
  }
  if (status.report?.accepted) {
    events.push({
      ...base,
      id: buildMetricEventId(status, 'report_accepted'),
      kind: 'report_accepted',
    });
  } else if (status.report?.rejectionCode) {
    events.push({
      ...base,
      id: buildMetricEventId(status, 'report_rejected'),
      kind: 'report_rejected',
    });
  }
  return events;
}

function appendMetricEvents(file: MetricsIndexFile, status: MemberWorkSyncStatus): void {
  const byId = new Map(file.recentEvents.map((event) => [event.id, event]));
  for (const event of buildMetricEvents(status)) {
    byId.set(event.id, event);
  }
  file.recentEvents = [...byId.values()]
    .sort((left, right) => left.recordedAt.localeCompare(right.recordedAt))
    .slice(-200);
}

function updateMetricsMember(
  file: MetricsIndexFile,
  status: MemberWorkSyncStatus,
  memberKey: string
): void {
  file.members[memberKey] = {
    memberName: status.memberName,
    state: status.state,
    agendaFingerprint: status.agenda.fingerprint,
    actionableCount: status.agenda.items.length,
    evaluatedAt: status.evaluatedAt,
    ...(status.providerId ? { providerId: status.providerId } : {}),
  };
  appendMetricEvents(file, status);
}

function toMetrics(teamName: string, file: MetricsIndexFile): MemberWorkSyncTeamMetrics {
  const stateCounts = emptyStateCounts();
  const members = Object.values(file.members);
  let actionableItemCount = 0;
  for (const member of members) {
    stateCounts[member.state] += 1;
    actionableItemCount += member.actionableCount;
  }
  const recentEvents = [...file.recentEvents].sort((left, right) =>
    left.recordedAt.localeCompare(right.recordedAt)
  );
  const metrics = {
    teamName,
    generatedAt: new Date().toISOString(),
    memberCount: members.length,
    stateCounts,
    actionableItemCount,
    wouldNudgeCount: recentEvents.filter((event) => event.kind === 'would_nudge').length,
    fingerprintChangeCount: recentEvents.filter((event) => event.kind === 'fingerprint_changed')
      .length,
    reportAcceptedCount: recentEvents.filter((event) => event.kind === 'report_accepted').length,
    reportRejectedCount: recentEvents.filter((event) => event.kind === 'report_rejected').length,
    recentEvents,
  };
  return {
    ...metrics,
    phase2Readiness: assessMemberWorkSyncPhase2Readiness({
      memberCount: metrics.memberCount,
      recentEvents: metrics.recentEvents,
    }),
  };
}

async function quarantineFile(filePath: string): Promise<void> {
  try {
    await rename(filePath, `${filePath}.invalid.${Date.now()}`);
  } catch {
    // If quarantine fails, keep the feature degraded but do not block team operation.
  }
}

async function readJsonFile<T>(
  filePath: string,
  guard: (value: unknown) => value is T,
  fallback: T,
  options: { quarantineInvalid?: boolean } = {}
): Promise<T> {
  try {
    const raw = await readFile(filePath, 'utf8');
    const parsed = JSON.parse(raw);
    if (guard(parsed)) {
      return parsed;
    }
    if (options.quarantineInvalid) {
      await quarantineFile(filePath);
    }
  } catch (error) {
    if ((error as NodeJS.ErrnoException).code !== 'ENOENT' && options.quarantineInvalid) {
      await quarantineFile(filePath);
    }
  }
  return fallback;
}

async function writeJsonFile(filePath: string, value: unknown): Promise<void> {
  await mkdir(dirname(filePath), { recursive: true });
  await atomicWriteAsync(filePath, `${JSON.stringify(value, null, 2)}\n`);
}

export class JsonMemberWorkSyncStore
  implements
    MemberWorkSyncStatusStorePort,
    MemberWorkSyncReportStorePort,
    MemberWorkSyncOutboxStorePort
{
  private readonly writeQueues = new Map<string, Promise<void>>();
  private readonly now: () => Date;

  constructor(
    private readonly paths: MemberWorkSyncStorePaths,
    private readonly deps: JsonMemberWorkSyncStoreDeps = {}
  ) {
    this.now = deps.now ?? (() => new Date());
  }

  async read(input: {
    teamName: string;
    memberName: string;
  }): Promise<MemberWorkSyncStatus | null> {
    const memberFile = await this.readMemberStatusFile(input.teamName, input.memberName);
    if (memberFile) {
      return memberFile.status;
    }

    const legacy = await this.readLegacyStatusFile(input.teamName);
    const legacyStatus = legacy.members[normalizeMemberKey(input.memberName)] ?? null;
    if (legacyStatus) {
      await this.appendAudit({
        teamName: input.teamName,
        memberName: input.memberName,
        event: 'legacy_fallback_used',
        source: 'json_store',
        reason: 'status_v1',
      });
    }
    return legacyStatus;
  }

  async write(status: MemberWorkSyncStatus): Promise<void> {
    const memberKey = this.paths.getMemberKey(status.memberName);
    await this.paths.ensureMemberWorkSyncDir(status.teamName, status.memberName);
    await this.enqueue(status.teamName, async () => {
      await withFileLock(this.paths.getMetricsIndexPath(status.teamName), async () => {
        await withFileLock(
          this.paths.getMemberStatusPath(status.teamName, status.memberName),
          async () => {
            const metrics = await this.readMetricsIndexFile(status.teamName);
            updateMetricsMember(metrics, status, memberKey);
            await this.writeMemberStatusFile(status);
            await this.writeMetricsIndexFile(status.teamName, metrics);
          }
        );
      });
    });
    await this.appendAudit({
      teamName: status.teamName,
      memberName: status.memberName,
      event: 'status_written',
      source: 'json_store',
      agendaFingerprint: status.agenda.fingerprint,
      state: status.state,
      actionableCount: status.agenda.items.length,
      ...(status.shadow?.triggerReasons ? { triggerReasons: status.shadow.triggerReasons } : {}),
      ...(status.providerId ? { providerId: status.providerId } : {}),
    });
  }

  async readTeamMetrics(teamName: string): Promise<MemberWorkSyncTeamMetrics> {
    let file = await this.readMetricsIndexFile(teamName);
    if (Object.keys(file.members).length === 0 && file.recentEvents.length === 0) {
      const repaired = await this.repairMetricsIndex(teamName);
      if (repaired) {
        file = repaired;
      }
    }
    return toMetrics(teamName, file);
  }

  async appendPendingReport(request: MemberWorkSyncReportRequest, reason: string): Promise<void> {
    const id = buildPendingReportIntentId(request);
    const memberKey = this.paths.getMemberKey(request.memberName);
    await this.paths.ensureMemberWorkSyncDir(request.teamName, request.memberName);
    await this.enqueue(request.teamName, async () => {
      await withFileLock(this.paths.getPendingReportsIndexPath(request.teamName), async () => {
        await withFileLock(
          this.paths.getMemberReportsPath(request.teamName, request.memberName),
          async () => {
            const reports = await this.readMemberReportsFile(request.teamName, request.memberName);
            const current = reports.intents[id];
            if (current && current.status !== 'pending') {
              return;
            }
            const intent: MemberWorkSyncReportIntent = {
              id,
              teamName: request.teamName,
              memberName: request.memberName,
              request,
              reason: current?.reason ?? reason,
              status: 'pending',
              recordedAt: current?.recordedAt ?? this.now().toISOString(),
            };
            reports.intents[id] = intent;
            await this.writeMemberReportsFile(request.teamName, request.memberName, reports);

            const index = await this.readPendingReportsIndexFile(request.teamName);
            index.items[id] = {
              memberKey,
              memberName: request.memberName,
              status: intent.status,
              recordedAt: intent.recordedAt,
            };
            await this.writePendingReportsIndexFile(request.teamName, index);
          }
        );
      });
    });
  }

  async listPendingReports(teamName: string): Promise<MemberWorkSyncReportIntent[]> {
    let index = await this.readPendingReportsIndexFile(teamName);
    if (Object.keys(index.items).length === 0) {
      await this.enqueue(teamName, async () => {
        await withFileLock(this.paths.getPendingReportsIndexPath(teamName), async () => {
          index = await this.readPendingReportsIndexFile(teamName);
          if (Object.keys(index.items).length === 0) {
            index = await this.repairPendingReportsIndex(teamName);
          }
        });
      });
    }
    let staleIndex = false;
    const pending: MemberWorkSyncReportIntent[] = [];
    for (const [id, route] of Object.entries(index.items)) {
      if (route.status !== 'pending') {
        continue;
      }
      const file = await this.readMemberReportsFile(teamName, route.memberName);
      const intent = file.intents[id];
      if (intent?.status === 'pending') {
        pending.push(intent);
      } else {
        staleIndex = true;
      }
    }
    const missingIndexedPending = staleIndex
      ? false
      : await this.hasMissingIndexedPendingReport(teamName, index);
    if (staleIndex || missingIndexedPending) {
      await this.enqueue(teamName, async () => {
        await withFileLock(this.paths.getPendingReportsIndexPath(teamName), async () => {
          index = await this.repairPendingReportsIndex(teamName);
        });
      });
      pending.length = 0;
      for (const [id, route] of Object.entries(index.items)) {
        if (route.status !== 'pending') {
          continue;
        }
        const file = await this.readMemberReportsFile(teamName, route.memberName);
        const intent = file.intents[id];
        if (intent?.status === 'pending') {
          pending.push(intent);
        }
      }
    }
    return pending.sort((left, right) => left.recordedAt.localeCompare(right.recordedAt));
  }

  async markPendingReportProcessed(
    teamName: string,
    id: string,
    result: {
      status: MemberWorkSyncReportIntent['status'];
      resultCode: string;
      processedAt: string;
    }
  ): Promise<void> {
    await this.enqueue(teamName, async () => {
      await withFileLock(this.paths.getPendingReportsIndexPath(teamName), async () => {
        let index = await this.readPendingReportsIndexFile(teamName);
        if (!index.items[id]) {
          index = await this.repairPendingReportsIndex(teamName);
        }
        const route = index.items[id];
        if (!route) {
          return;
        }
        await withFileLock(
          this.paths.getMemberReportsPath(teamName, route.memberName),
          async () => {
            const reports = await this.readMemberReportsFile(teamName, route.memberName);
            const current = reports.intents[id];
            if (current?.status !== 'pending') {
              return;
            }
            reports.intents[id] = {
              ...current,
              status: result.status,
              resultCode: result.resultCode,
              processedAt: result.processedAt,
            };
            await this.writeMemberReportsFile(teamName, route.memberName, reports);
            index.items[id] = {
              ...route,
              status: result.status,
              processedAt: result.processedAt,
            };
            await this.writePendingReportsIndexFile(teamName, index);
          }
        );
      });
    });
  }

  async ensurePending(
    input: MemberWorkSyncOutboxEnsureInput
  ): Promise<MemberWorkSyncOutboxEnsureResult> {
    let result: MemberWorkSyncOutboxEnsureResult | null = null;
    const memberKey = this.paths.getMemberKey(input.memberName);
    await this.paths.ensureMemberWorkSyncDir(input.teamName, input.memberName);
    await this.enqueue(input.teamName, async () => {
      await withFileLock(this.paths.getOutboxIndexPath(input.teamName), async () => {
        await withFileLock(
          this.paths.getMemberOutboxPath(input.teamName, input.memberName),
          async () => {
            const outbox = await this.readMemberOutboxFile(input.teamName, input.memberName);
            const current = outbox.items[input.id];
            if (current) {
              if (current.payloadHash !== input.payloadHash) {
                result = {
                  ok: false,
                  outcome: 'payload_conflict',
                  item: current,
                  existingPayloadHash: current.payloadHash,
                  requestedPayloadHash: input.payloadHash,
                };
                return;
              }

              if (canReviveOutboxItem(current.status)) {
                const next: MemberWorkSyncOutboxItem = {
                  ...current,
                  status: 'pending',
                  updatedAt: input.nowIso,
                };
                const nextAttemptAt = input.nextAttemptAt ?? current.nextAttemptAt;
                if (nextAttemptAt) {
                  next.nextAttemptAt = nextAttemptAt;
                } else {
                  delete next.nextAttemptAt;
                }
                delete next.claimedBy;
                delete next.claimedAt;
                delete next.lastError;
                outbox.items[input.id] = next;
                await this.writeMemberOutboxFile(input.teamName, input.memberName, outbox);
                await this.upsertOutboxIndexItem(input.teamName, next, memberKey);
                result = { ok: true, outcome: 'existing', item: next };
                return;
              }

              await this.upsertOutboxIndexItem(input.teamName, current, memberKey);
              result = { ok: true, outcome: 'existing', item: current };
              return;
            }

            const item: MemberWorkSyncOutboxItem = {
              id: input.id,
              teamName: input.teamName,
              memberName: input.memberName,
              agendaFingerprint: input.agendaFingerprint,
              payloadHash: input.payloadHash,
              payload: input.payload,
              status: 'pending',
              attemptGeneration: 0,
              ...(input.nextAttemptAt ? { nextAttemptAt: input.nextAttemptAt } : {}),
              createdAt: input.nowIso,
              updatedAt: input.nowIso,
            };
            outbox.items[input.id] = item;
            await this.writeMemberOutboxFile(input.teamName, input.memberName, outbox);
            await this.upsertOutboxIndexItem(input.teamName, item, memberKey);
            result = { ok: true, outcome: 'created', item };
          }
        );
      });
    });

    if (!result) {
      throw new Error('Member work sync outbox write did not produce a result');
    }
    return result;
  }

  async claimDue(input: MemberWorkSyncOutboxClaimInput): Promise<MemberWorkSyncOutboxItem[]> {
    const claimed: MemberWorkSyncOutboxItem[] = [];
    await this.enqueue(input.teamName, async () => {
      await withFileLock(this.paths.getOutboxIndexPath(input.teamName), async () => {
        let index = await this.readOutboxIndexFile(input.teamName);
        if (Object.keys(index.items).length === 0) {
          index = await this.repairOutboxIndex(input.teamName);
        }
        let dueRoutes = getDueOutboxRoutes(index, input.nowIso, input.limit);
        if (
          dueRoutes.length > 0 &&
          dueRoutes.length < Math.max(0, input.limit) &&
          (await this.hasMissingIndexedDueOutboxItem(input.teamName, index, input.nowIso))
        ) {
          index = await this.repairOutboxIndex(input.teamName);
          dueRoutes = getDueOutboxRoutes(index, input.nowIso, input.limit);
        }

        let staleIndex = false;
        for (const [id, route] of dueRoutes) {
          await withFileLock(
            this.paths.getMemberOutboxPath(input.teamName, route.memberName),
            async () => {
              const outbox = await this.readMemberOutboxFile(input.teamName, route.memberName);
              const item = outbox.items[id];
              if (!item || !canClaimOutboxItem(item, input.nowIso)) {
                delete index.items[id];
                staleIndex = true;
                return;
              }
              const next: MemberWorkSyncOutboxItem = {
                ...item,
                status: 'claimed',
                attemptGeneration: item.attemptGeneration + 1,
                claimedBy: input.claimedBy,
                claimedAt: input.nowIso,
                updatedAt: input.nowIso,
              };
              delete next.lastError;
              outbox.items[id] = next;
              await this.writeMemberOutboxFile(input.teamName, route.memberName, outbox);
              index.items[id] = toOutboxIndexItem(next, route.memberKey);
              claimed.push(next);
            }
          );
        }

        if (staleIndex) {
          index = await this.repairOutboxIndex(input.teamName);
        } else if (dueRoutes.length > 0) {
          await this.writeOutboxIndexFile(input.teamName, index);
        }
      });
    });
    return claimed;
  }

  async markDelivered(input: MemberWorkSyncOutboxMarkDeliveredInput): Promise<void> {
    await this.updateOutboxItem(input.teamName, input.id, (current) => {
      if (current?.attemptGeneration !== input.attemptGeneration) {
        return current;
      }
      const next: MemberWorkSyncOutboxItem = {
        ...current,
        status: 'delivered',
        deliveredMessageId: input.deliveredMessageId,
        updatedAt: input.nowIso,
      };
      delete next.lastError;
      return next;
    });
  }

  async markSuperseded(input: MemberWorkSyncOutboxMarkSupersededInput): Promise<void> {
    await this.updateOutboxItem(input.teamName, input.id, (current) => {
      if (!current || isOutboxTerminal(current.status)) {
        return current;
      }
      return {
        ...current,
        status: 'superseded',
        lastError: input.reason,
        updatedAt: input.nowIso,
      };
    });
  }

  async markFailed(input: MemberWorkSyncOutboxMarkFailedInput): Promise<void> {
    await this.updateOutboxItem(input.teamName, input.id, (current) => {
      if (current?.attemptGeneration !== input.attemptGeneration) {
        return current;
      }
      const next: MemberWorkSyncOutboxItem = {
        ...current,
        status: input.retryable ? 'failed_retryable' : 'failed_terminal',
        lastError: input.error,
        ...(input.retryable && input.nextAttemptAt ? { nextAttemptAt: input.nextAttemptAt } : {}),
        updatedAt: input.nowIso,
      };
      if (!input.retryable) {
        delete next.nextAttemptAt;
      }
      return next;
    });
  }

  async countRecentDelivered(
    input: MemberWorkSyncOutboxCountRecentDeliveredInput
  ): Promise<number> {
    let index = await this.readOutboxIndexFile(input.teamName);
    if (Object.keys(index.items).length === 0) {
      await this.enqueue(input.teamName, async () => {
        await withFileLock(this.paths.getOutboxIndexPath(input.teamName), async () => {
          index = await this.readOutboxIndexFile(input.teamName);
          if (Object.keys(index.items).length === 0) {
            index = await this.repairOutboxIndex(input.teamName);
          }
        });
      });
    }
    const indexedCount = Object.values(index.items).filter(
      (item) =>
        normalizeMemberKey(item.memberName) === normalizeMemberKey(input.memberName) &&
        item.status === 'delivered' &&
        item.updatedAt >= input.sinceIso
    ).length;
    const memberOutbox = await this.readMemberOutboxFile(input.teamName, input.memberName);
    const memberFileCount = Object.values(memberOutbox.items).filter(
      (item) => item.status === 'delivered' && item.updatedAt >= input.sinceIso
    ).length;
    if (memberFileCount > indexedCount) {
      await this.enqueue(input.teamName, async () => {
        await withFileLock(this.paths.getOutboxIndexPath(input.teamName), async () => {
          await this.repairOutboxIndex(input.teamName);
        });
      });
    }
    return Math.max(indexedCount, memberFileCount);
  }

  private async readLegacyStatusFile(teamName: string): Promise<LegacyStatusFile> {
    return readJsonFile(
      this.paths.getLegacyStatusPath(teamName),
      isLegacyStatusFile,
      { schemaVersion: 1, members: {}, metrics: { recentEvents: [] } },
      { quarantineInvalid: true }
    );
  }

  private async readMemberStatusFile(
    teamName: string,
    memberName: string
  ): Promise<MemberStatusFile | null> {
    const file = await readJsonFile<MemberStatusFile | null>(
      this.paths.getMemberStatusPath(teamName, memberName),
      (value): value is MemberStatusFile | null => value === null || isMemberStatusFile(value),
      null,
      { quarantineInvalid: true }
    );
    return file;
  }

  private async writeMemberStatusFile(status: MemberWorkSyncStatus): Promise<void> {
    await writeJsonFile(this.paths.getMemberStatusPath(status.teamName, status.memberName), {
      schemaVersion: 2,
      status,
    } satisfies MemberStatusFile);
  }

  private async readMetricsIndexFile(teamName: string): Promise<MetricsIndexFile> {
    return readJsonFile(
      this.paths.getMetricsIndexPath(teamName),
      isMetricsIndexFile,
      emptyMetricsIndex(),
      {
        quarantineInvalid: true,
      }
    );
  }

  private async writeMetricsIndexFile(teamName: string, file: MetricsIndexFile): Promise<void> {
    await writeJsonFile(this.paths.getMetricsIndexPath(teamName), file);
  }

  private async readLegacyPendingFile(teamName: string): Promise<LegacyPendingReportFile> {
    return readJsonFile(
      this.paths.getLegacyPendingReportsPath(teamName),
      isLegacyPendingReportFile,
      { schemaVersion: 1, intents: {} },
      { quarantineInvalid: true }
    );
  }

  private async readMemberReportsFile(
    teamName: string,
    memberName: string
  ): Promise<MemberReportsFile> {
    return readJsonFile(
      this.paths.getMemberReportsPath(teamName, memberName),
      isMemberReportsFile,
      { schemaVersion: 2, intents: {} },
      { quarantineInvalid: true }
    );
  }

  private async writeMemberReportsFile(
    teamName: string,
    memberName: string,
    file: MemberReportsFile
  ): Promise<void> {
    await this.paths.ensureMemberWorkSyncDir(teamName, memberName);
    await writeJsonFile(this.paths.getMemberReportsPath(teamName, memberName), file);
  }

  private async readPendingReportsIndexFile(teamName: string): Promise<PendingReportsIndexFile> {
    return readJsonFile(
      this.paths.getPendingReportsIndexPath(teamName),
      isPendingReportsIndexFile,
      { schemaVersion: 2, items: {} },
      { quarantineInvalid: true }
    );
  }

  private async writePendingReportsIndexFile(
    teamName: string,
    file: PendingReportsIndexFile
  ): Promise<void> {
    await writeJsonFile(this.paths.getPendingReportsIndexPath(teamName), file);
  }

  private async readLegacyOutboxFile(teamName: string): Promise<LegacyOutboxFile> {
    return readJsonFile(
      this.paths.getLegacyOutboxPath(teamName),
      isLegacyOutboxFile,
      { schemaVersion: 1, items: {} },
      { quarantineInvalid: true }
    );
  }

  private async readMemberOutboxFile(
    teamName: string,
    memberName: string
  ): Promise<MemberOutboxFile> {
    return readJsonFile(
      this.paths.getMemberOutboxPath(teamName, memberName),
      isMemberOutboxFile,
      { schemaVersion: 2, items: {} },
      { quarantineInvalid: true }
    );
  }

  private async writeMemberOutboxFile(
    teamName: string,
    memberName: string,
    file: MemberOutboxFile
  ): Promise<void> {
    await this.paths.ensureMemberWorkSyncDir(teamName, memberName);
    await writeJsonFile(this.paths.getMemberOutboxPath(teamName, memberName), file);
  }

  private async readOutboxIndexFile(teamName: string): Promise<OutboxIndexFile> {
    return readJsonFile(
      this.paths.getOutboxIndexPath(teamName),
      isOutboxIndexFile,
      { schemaVersion: 2, items: {} },
      { quarantineInvalid: true }
    );
  }

  private async writeOutboxIndexFile(teamName: string, file: OutboxIndexFile): Promise<void> {
    await writeJsonFile(this.paths.getOutboxIndexPath(teamName), file);
  }

  private async upsertOutboxIndexItem(
    teamName: string,
    item: MemberWorkSyncOutboxItem,
    memberKey: string
  ): Promise<void> {
    const index = await this.readOutboxIndexFile(teamName);
    index.items[item.id] = toOutboxIndexItem(item, memberKey);
    await this.writeOutboxIndexFile(teamName, index);
  }

  private async updateOutboxItem(
    teamName: string,
    id: string,
    updater: (current: MemberWorkSyncOutboxItem | undefined) => MemberWorkSyncOutboxItem | undefined
  ): Promise<void> {
    await this.enqueue(teamName, async () => {
      await withFileLock(this.paths.getOutboxIndexPath(teamName), async () => {
        let index = await this.readOutboxIndexFile(teamName);
        if (!index.items[id]) {
          index = await this.repairOutboxIndex(teamName);
        }
        const route = index.items[id];
        if (!route) {
          return;
        }
        await withFileLock(this.paths.getMemberOutboxPath(teamName, route.memberName), async () => {
          const outbox = await this.readMemberOutboxFile(teamName, route.memberName);
          const next = updater(outbox.items[id]);
          if (!next) {
            return;
          }
          outbox.items[id] = next;
          await this.writeMemberOutboxFile(teamName, route.memberName, outbox);
          index.items[id] = toOutboxIndexItem(next, route.memberKey);
          await this.writeOutboxIndexFile(teamName, index);
        });
      });
    });
  }

  private async repairMetricsIndex(teamName: string): Promise<MetricsIndexFile | null> {
    let repaired: MetricsIndexFile | null = null;
    await this.enqueue(teamName, async () => {
      await withFileLock(this.paths.getMetricsIndexPath(teamName), async () => {
        const current = await this.readMetricsIndexFile(teamName);
        if (Object.keys(current.members).length > 0 || current.recentEvents.length > 0) {
          repaired = current;
          return;
        }

        const next = emptyMetricsIndex();
        const memberStatuses = await this.scanMemberStatuses(teamName);
        for (const status of memberStatuses) {
          updateMetricsMember(next, status, this.paths.getMemberKey(status.memberName));
        }
        const legacy = await this.readLegacyStatusFile(teamName);
        for (const status of Object.values(legacy.members)) {
          const memberKey = this.paths.getMemberKey(status.memberName);
          if (!next.members[memberKey]) {
            updateMetricsMember(next, status, memberKey);
          }
        }
        for (const event of legacy.metrics?.recentEvents ?? []) {
          if (!next.recentEvents.some((existing) => existing.id === event.id)) {
            next.recentEvents.push(event);
          }
        }
        next.recentEvents.sort((left, right) => left.recordedAt.localeCompare(right.recordedAt));
        next.recentEvents = next.recentEvents.slice(-200);
        if (Object.keys(next.members).length === 0 && next.recentEvents.length === 0) {
          repaired = null;
          return;
        }
        await this.writeMetricsIndexFile(teamName, next);
        repaired = next;
      });
    });

    const repairedIndex = repaired as MetricsIndexFile | null;
    if (!repairedIndex) {
      return null;
    }
    for (const member of Object.values(repairedIndex.members)) {
      await this.appendAudit({
        teamName,
        memberName: member.memberName,
        event: 'index_repaired',
        source: 'json_store',
        reason: 'metrics',
        agendaFingerprint: member.agendaFingerprint,
        state: member.state,
        actionableCount: member.actionableCount,
        ...(member.providerId ? { providerId: member.providerId } : {}),
      });
    }
    return repairedIndex;
  }

  private async repairPendingReportsIndex(teamName: string): Promise<PendingReportsIndexFile> {
    const index: PendingReportsIndexFile = { schemaVersion: 2, items: {} };
    const repairedMembers = new Set<string>();
    const legacyMembers = new Set<string>();
    for (const { memberName, reports } of await this.scanMemberReports(teamName)) {
      const memberKey = this.paths.getMemberKey(memberName);
      for (const intent of Object.values(reports.intents)) {
        index.items[intent.id] = toPendingReportIndexItem(intent, memberKey);
        repairedMembers.add(intent.memberName);
      }
    }
    for (const intent of Object.values((await this.readLegacyPendingFile(teamName)).intents)) {
      const memberKey = this.paths.getMemberKey(intent.memberName);
      if (!index.items[intent.id]) {
        await withFileLock(
          this.paths.getMemberReportsPath(teamName, intent.memberName),
          async () => {
            const reports = await this.readMemberReportsFile(teamName, intent.memberName);
            reports.intents[intent.id] = intent;
            await this.writeMemberReportsFile(teamName, intent.memberName, reports);
          }
        );
        index.items[intent.id] = toPendingReportIndexItem(intent, memberKey);
        repairedMembers.add(intent.memberName);
        legacyMembers.add(intent.memberName);
      }
    }
    await this.writePendingReportsIndexFile(teamName, index);
    for (const memberName of repairedMembers) {
      await this.appendAudit({
        teamName,
        memberName,
        event: 'index_repaired',
        source: 'json_store',
        reason: 'pending_reports',
      });
    }
    for (const memberName of legacyMembers) {
      await this.appendAudit({
        teamName,
        memberName,
        event: 'legacy_fallback_used',
        source: 'json_store',
        reason: 'pending_reports_v1',
      });
    }
    return index;
  }

  private async repairOutboxIndex(teamName: string): Promise<OutboxIndexFile> {
    const index: OutboxIndexFile = { schemaVersion: 2, items: {} };
    const repairedMembers = new Set<string>();
    const legacyMembers = new Set<string>();
    for (const { memberName, outbox } of await this.scanMemberOutboxes(teamName)) {
      const memberKey = this.paths.getMemberKey(memberName);
      for (const item of Object.values(outbox.items)) {
        index.items[item.id] = toOutboxIndexItem(item, memberKey);
        repairedMembers.add(item.memberName);
      }
    }
    for (const item of Object.values((await this.readLegacyOutboxFile(teamName)).items)) {
      const memberKey = this.paths.getMemberKey(item.memberName);
      if (!index.items[item.id]) {
        await withFileLock(this.paths.getMemberOutboxPath(teamName, item.memberName), async () => {
          const outbox = await this.readMemberOutboxFile(teamName, item.memberName);
          outbox.items[item.id] = item;
          await this.writeMemberOutboxFile(teamName, item.memberName, outbox);
        });
        index.items[item.id] = toOutboxIndexItem(item, memberKey);
        repairedMembers.add(item.memberName);
        legacyMembers.add(item.memberName);
      }
    }
    await this.writeOutboxIndexFile(teamName, index);
    for (const memberName of repairedMembers) {
      await this.appendAudit({
        teamName,
        memberName,
        event: 'index_repaired',
        source: 'json_store',
        reason: 'outbox',
      });
    }
    for (const memberName of legacyMembers) {
      await this.appendAudit({
        teamName,
        memberName,
        event: 'legacy_fallback_used',
        source: 'json_store',
        reason: 'outbox_v1',
      });
    }
    return index;
  }

  private async scanMemberNames(teamName: string): Promise<string[]> {
    const membersDir = join(this.paths.getTeamRootDir(teamName), 'members');
    const entries = await readdir(membersDir, { withFileTypes: true }).catch(() => []);
    const names: string[] = [];
    for (const entry of entries) {
      if (!entry.isDirectory()) {
        continue;
      }
      const metaPath = join(membersDir, entry.name, 'member.meta.json');
      try {
        const raw = await readFile(metaPath, 'utf8');
        const parsed = JSON.parse(raw) as { memberName?: unknown };
        if (typeof parsed.memberName === 'string' && parsed.memberName.trim()) {
          names.push(parsed.memberName.trim());
        }
      } catch {
        // Ignore malformed member storage dirs during repair.
      }
    }
    return names;
  }

  private async scanMemberStatuses(teamName: string): Promise<MemberWorkSyncStatus[]> {
    const statuses: MemberWorkSyncStatus[] = [];
    for (const memberName of await this.scanMemberNames(teamName)) {
      const file = await this.readMemberStatusFile(teamName, memberName);
      if (file) {
        statuses.push(file.status);
      }
    }
    return statuses;
  }

  private async scanMemberReports(
    teamName: string
  ): Promise<{ memberName: string; reports: MemberReportsFile }[]> {
    const reports: { memberName: string; reports: MemberReportsFile }[] = [];
    for (const memberName of await this.scanMemberNames(teamName)) {
      reports.push({ memberName, reports: await this.readMemberReportsFile(teamName, memberName) });
    }
    return reports;
  }

  private async hasMissingIndexedPendingReport(
    teamName: string,
    index: PendingReportsIndexFile
  ): Promise<boolean> {
    const indexedIds = new Set(Object.keys(index.items));
    for (const { reports } of await this.scanMemberReports(teamName)) {
      for (const intent of Object.values(reports.intents)) {
        if (intent.status === 'pending' && !indexedIds.has(intent.id)) {
          return true;
        }
      }
    }
    for (const intent of Object.values((await this.readLegacyPendingFile(teamName)).intents)) {
      if (intent.status === 'pending' && !indexedIds.has(intent.id)) {
        return true;
      }
    }
    return false;
  }

  private async scanMemberOutboxes(
    teamName: string
  ): Promise<{ memberName: string; outbox: MemberOutboxFile }[]> {
    const outboxes: { memberName: string; outbox: MemberOutboxFile }[] = [];
    for (const memberName of await this.scanMemberNames(teamName)) {
      outboxes.push({ memberName, outbox: await this.readMemberOutboxFile(teamName, memberName) });
    }
    return outboxes;
  }

  private async hasMissingIndexedDueOutboxItem(
    teamName: string,
    index: OutboxIndexFile,
    nowIso: string
  ): Promise<boolean> {
    const indexedIds = new Set(Object.keys(index.items));
    for (const { outbox } of await this.scanMemberOutboxes(teamName)) {
      for (const item of Object.values(outbox.items)) {
        if (canClaimOutboxItem(item, nowIso) && !indexedIds.has(item.id)) {
          return true;
        }
      }
    }
    for (const item of Object.values((await this.readLegacyOutboxFile(teamName)).items)) {
      if (canClaimOutboxItem(item, nowIso) && !indexedIds.has(item.id)) {
        return true;
      }
    }
    return false;
  }

  private async appendAudit(input: {
    teamName: string;
    memberName: string;
    event: 'status_written' | 'legacy_fallback_used' | 'index_repaired';
    source: string;
    agendaFingerprint?: string;
    state?: string;
    actionableCount?: number;
    reason?: string;
    triggerReasons?: string[];
    providerId?: string;
  }): Promise<void> {
    if (!this.deps.auditJournal) {
      return;
    }
    try {
      await this.deps.auditJournal.append({
        ...input,
        timestamp: this.now().toISOString(),
      });
    } catch (error) {
      this.deps.logger?.warn('member work sync store audit append failed', {
        teamName: input.teamName,
        memberName: input.memberName,
        event: input.event,
        error: String(error),
      });
    }
  }

  private async enqueue(teamName: string, operation: () => Promise<void>): Promise<void> {
    const previous = this.writeQueues.get(teamName) ?? Promise.resolve();
    const next = previous.then(operation, operation);
    this.writeQueues.set(
      teamName,
      next.finally(() => {
        if (this.writeQueues.get(teamName) === next) {
          this.writeQueues.delete(teamName);
        }
      })
    );
    await next;
  }
}

function toOutboxIndexItem(
  item: MemberWorkSyncOutboxItem,
  memberKey: string
): OutboxIndexFile['items'][string] {
  return {
    memberKey,
    memberName: item.memberName,
    status: item.status,
    ...(item.nextAttemptAt ? { nextAttemptAt: item.nextAttemptAt } : {}),
    updatedAt: item.updatedAt,
    createdAt: item.createdAt,
  };
}

function toPendingReportIndexItem(
  intent: MemberWorkSyncReportIntent,
  memberKey: string
): PendingReportsIndexFile['items'][string] {
  return {
    memberKey,
    memberName: intent.memberName,
    status: intent.status,
    recordedAt: intent.recordedAt,
    ...(intent.processedAt ? { processedAt: intent.processedAt } : {}),
  };
}