pi-mega-compact 0.13.0 → 0.13.2

package/extensions/dashboard-server/api-contracts/endpoints.ts

@@ -1,672 +1,51 @@
 /**
  * api-contracts/endpoints.ts — Central registry of all dashboard API endpoints.
  *
- * Single source of truth for all 13 dashboard API routes. Each entry is an
- * `EndpointDef` (or `SseEndpointDef` for SSE) instance with method, path,
- * description, and typed request/response references.
+ * Delegate-shell (extensions split): single source of truth for all dashboard
+ * API routes. The inline response types + game-types re-exports live in
+ * ./endpoints/types.ts and the ENDPOINTS object literal in ./endpoints/registry.ts;
+ * this pointer re-exports the full public surface unchanged.
  *
  * Sprint A1 — PREVENT-PI-004: zero network code (type definitions only).
  * PREVENT-011: no `any` type — all types are explicit.
  */
 
-import type { EndpointDef } from "./core.js";
-import type { SnapshotResponse } from "./snapshot.js";
-import type { IndexesIndexRow, IndexesSummaryResponse } from "./multi-repo.js";
-import type { GameStateResponse } from "./game.js";
-import type { SseEvent } from "./index.js";
-import type { ProviderCacheResponse } from "./provider-cache.js";
-import type { MemoryStatusResponse } from "./memory.js";
-import type { SetupStatusResponse, SetupDetectResponse, SetupConfigureRequest, SetupConfigureResponse } from "./setup.js";
-import type {
-	TurnsResponse,
-	ConversationTurnsResponse,
-	RewindIntentsResponse,
-	ForkRequest,
-	ForkResponse,
-	PostIntentRequest,
-	PruneRequest,
-	PruneTurnsResponse,
-	TopicMemoriesResponse,
-} from "./turns.js";
-
-import type {
-	DbStatsResponse,
-	MaintenanceActionResult,
-	MaintenanceAction,
-	SchemaHealthResponse,
-} from "./maintenance.js";
-
-import type { CacheStripesResponse } from "./cache-stripes.js";
-
-import type {
-	GameScoreRow,
-	GameScoresQuery,
-	AchievementRow,
-	SessionsResponse,
-	SessionTimeseriesQuery,
-	SessionTimeseriesResponse,
-	GameStatePatch,
-	SseEndpointDef,
-	TopicsResponse,
-} from "./game-types.js";
-
 export type {
+	VersionResponse,
+	IndexSummary,
+	IndexFallbackResponse,
+	ReposQuery,
+	ReposResponse,
+	SummaryResponse,
+	DriftSeverity,
+	DriftSignal,
+	RepoDrift,
+	DriftReportResponse,
+	ServerEntry,
+	ServersResponse,
+	PerfPercentile,
+	PerfAverage,
+	PerfLatest,
+	CacheHitSample,
+	PerfCacheHit,
+	PerfDiag,
+	PerfQuery,
+	PerfResponse,
 	GameScoreRow,
 	GameScoresQuery,
 	AchievementRow,
+	GameStatePatch,
 	ActiveSession,
 	SessionsResponse,
 	SessionDataPoint,
 	SessionSeries,
 	SessionTimeseriesQuery,
 	SessionTimeseriesResponse,
-	GameStatePatch,
 	SseEndpointDef,
 	TopicRow,
 	TopicAssignmentRow,
 	TopicsResponse,
 	TopicDetailResponse,
-} from "./game-types.js";
-
-// ─── New Response Types (inline) ───────────────────────────────────────────
-
-/**
- * Response for GET /api/version. Returns the dashboard server version string
- * so the launcher can detect stale servers from older builds.
- */
-export interface VersionResponse {
-	/** Semver-style version string of the running dashboard server. */
-	readonly version: string;
-}
-
-/**
- * Aggregated summary of the multi-repo index (subset of IndexesSummaryResponse).
- * Used by GET /api/summary for lightweight header tiles.
- */
-export type IndexSummary = Pick<
-	IndexesSummaryResponse,
-	| "totalRepos"
-	| "totalCheckpoints"
-	| "totalTokensSaved"
-	| "totalCompressedOriginalBytes"
->;
-
-/**
- * Fallback response for GET /api/index when the multi-repo index is unavailable
- * (no index.sqlite file or read error). All fields are null/empty.
- */
-export interface IndexFallbackResponse {
-	/** Always null — no index data available. */
-	readonly updatedAt: null;
-	/** Always null — no summary available. */
-	readonly summary: null;
-	/** Always an empty array — no repos registered. */
-	readonly repos: IndexesIndexRow[];
-}
-
-/**
- * Query parameters for GET /api/repos. The `active` parameter filters to repos
- * seen within the last N hours (format: "<N>h", e.g. "24h").
- */
-export interface ReposQuery {
-	/** Active-window filter in format "<hours>h" (e.g. "24h"). Optional. */
-	readonly active?: string;
-}
-
-/**
- * Response for GET /api/repos. Returns the registry list with an optional
- * active-window filter applied.
- */
-export interface ReposResponse {
-	/** ISO timestamp of the last index update, or null if unavailable. */
-	readonly updatedAt: string | null;
-	/** Array of repo index rows. */
-	readonly repos: IndexesIndexRow[];
-	/** Number of repos in the response (after filtering). */
-	readonly count: number;
-}
-
-/**
- * Response for GET /api/summary. Lightweight header tiles without the full
- * repo list (keeps payload small for embed scenarios).
- */
-export interface SummaryResponse {
-	/** ISO timestamp of the last index update, or null if unavailable. */
-	readonly updatedAt: string | null;
-	/** Aggregate index summary, or null if no index exists. */
-	readonly summary: IndexSummary | null;
-	/** Number of repos active within the last 24 hours. */
-	readonly activeRepos: number;
-	/** Total number of repos in the registry. */
-	readonly totalRepos: number;
-}
-
-// ─── Drift Report Types ─────────────────────────────────────────────────────
-
-/** Severity level for a drift signal. */
-export type DriftSeverity = "warn" | "info";
-
-/**
- * A single drift signal for a repo.
- */
-export interface DriftSignal {
-	/** The kind of drift detected. */
-	readonly kind: "stale" | "compaction_lag" | "model_churn";
-	/** Severity level of the signal. */
-	readonly severity: DriftSeverity;
-	/** Human-readable detail describing the drift. */
-	readonly detail: string;
-}
-
-/**
- * Drift classification for a single repo.
- */
-export interface RepoDrift {
-	/** Absolute path to the repo root. */
-	readonly repoRoot: string;
-	/** Display name of the repo. */
-	readonly displayName: string;
-	/** Unix timestamp (seconds) of the last dashboard activity. */
-	readonly lastSeen: number;
-	/** Unix timestamp (seconds) of the last compaction, or null if never. */
-	readonly lastCompactedAt: number | null;
-	/** Unix timestamp (seconds) of the last model capture, or null. */
-	readonly modelCapturedAt: number | null;
-	/** Array of drift signals detected for this repo. */
-	readonly signals: DriftSignal[];
-	/** Highest severity across signals; "ok" if none. */
-	readonly status: "ok" | "warn";
-}
-
-/**
- * Response for GET /api/drift. Cross-repo drift report over the machine-wide
- * repo_registry, flagging stale repos, compaction lag, and model churn.
- */
-export interface DriftReportResponse {
-	/** Unix timestamp (seconds) when the report was generated. */
-	readonly generatedAt: number;
-	/** Aggregate counts by status/signal. */
-	readonly totals: {
-		/** Repos with no drift signals. */
-		readonly ok: number;
-		/** Repos with at least one warning signal. */
-		readonly warn: number;
-		/** Repos with the "stale" signal. */
-		readonly stale: number;
-		/** Repos with the "compaction_lag" signal. */
-		readonly compactionLag: number;
-		/** Repos with the "model_churn" signal. */
-		readonly modelChurn: number;
-	};
-	/** Per-repo drift classifications. */
-	readonly repos: RepoDrift[];
-}
-
-// ─── Servers Types ──────────────────────────────────────────────────────────
-
-/**
- * A single server entry in the GET /api/servers response. Represents a
- * recently-active repo with its live dashboard snapshot data.
- */
-export interface ServerEntry {
-	/** Absolute path to the repo root. */
-	readonly repoRoot: string;
-	/** Display name of the repo. */
-	readonly displayName: string;
-	/** Model name, or null if not set. */
-	readonly model: string | null;
-	/** Provider display name, or null if not set. */
-	readonly provider: string | null;
-	/** Unix timestamp (seconds) of the last dashboard activity. */
-	readonly lastSeen: number;
-	/** Unix timestamp (seconds) of the last compaction, or null. */
-	readonly lastCompactedAt: number | null;
-	/** Current compaction tier, or null if no live snapshot. Present when a live dashboard.json exists. */
-	readonly tier?: string | null;
-	/** Current context pressure percentage (0–100), or null. Present when a live snapshot has context data. */
-	readonly contextPct?: number | null;
-	/** Current session state string, or null. Present when a live snapshot has session data. */
-	readonly state?: string | null;
-	/** Cache hit counters from the live snapshot, or null. Present when a live snapshot has cacheHits. */
-	readonly cacheHits?: {
-		readonly session: number;
-		readonly total: number;
-		readonly sessionTokensSaved: number;
-		readonly totalTokensSaved: number;
-	} | null;
-	/** Compaction counters from the live snapshot, or null. Present when a live snapshot has compacts. */
-	readonly compacts?: {
-		readonly session: number;
-		readonly total: number;
-	} | null;
-	/** Time saved counters from the live snapshot, or null. Present when a live snapshot has timeSaved. */
-	readonly timeSaved?: {
-		readonly compact: {
-			readonly sessionSec: number;
-			readonly totalSec: number;
-		};
-		readonly cacheHit: {
-			readonly sessionSec: number;
-			readonly totalSec: number;
-		};
-	} | null;
-	/** ISO timestamp of the live snapshot, or null. Present when a live snapshot has updatedAt. */
-	readonly updatedAt?: string | null;
-	/** Provider prompt-cache lifetime aggregates for this repo, or null when unavailable. */
-	readonly providerCache?: {
-		readonly avgHitPct: number;
-		readonly cacheRead: number;
-		readonly cacheWrite: number;
-		readonly totalInput: number;
-		readonly sampleCount: number;
-		readonly estimatedSaved: number | null;
-	} | null;
-}
-
-/**
- * Response for GET /api/servers. Lists recently-active repo servers with
- * live snapshot data.
- */
-export interface ServersResponse {
-	/** ISO timestamp when the response was generated. */
-	readonly updatedAt: string;
-	/** Array of server entries, sorted by lastSeen descending. */
-	readonly servers: ServerEntry[];
-}
-
-// ─── Perf Types ─────────────────────────────────────────────────────────────
-
-/** Percentile statistics for a latency metric (in milliseconds). */
-export interface PerfPercentile {
-	/** 50th percentile (median) in milliseconds. */
-	readonly p50: number;
-	/** 95th percentile in milliseconds. */
-	readonly p95: number;
-	/** Number of samples in the window. */
-	readonly n: number;
-}
-
-/** Average statistics for a rate metric. */
-export interface PerfAverage {
-	/** Average value across all samples in the window. */
-	readonly avg: number;
-	/** Number of samples in the window. */
-	readonly n: number;
-}
-
-/** Latest-value statistics for a gauge metric. */
-export interface PerfLatest {
-	/** Most recent value in the window. */
-	readonly latest: number;
-	/** Number of samples in the window. */
-	readonly n: number;
-}
-
-/** A single cache hit rate sample with timestamp. */
-export interface CacheHitSample {
-	/** Cache hit percentage (0–100). */
-	readonly pct: number;
-	/** Epoch ms timestamp of the sample. */
-	readonly ts: number;
-}
-
-/** Average + latest statistics for cache hit percentage. */
-export interface PerfCacheHit {
-	/** Average cache hit percentage (0–100). */
-	readonly avg: number;
-	/** Most recent cache hit percentage (0–100). */
-	readonly latest: number;
-	/** Number of samples in the window. */
-	readonly n: number;
-	/** Raw cache hit samples with timestamps for time-series charting. */
-	readonly samples: CacheHitSample[];
-}
-
-/** Diagnostic counters from the live dashboard snapshot. */
-export interface PerfDiag {
-	/** Number of fast-gate context trim fires. */
-	readonly ctxFastGate: number;
-	/** Number of live trim fires. */
-	readonly liveTrimFires: number;
-	/** Number of live trim replays. */
-	readonly liveTrimReplays: number;
-}
-
-/**
- * Query parameters for GET /api/perf. The `minutes` parameter controls the
- * rolling window size.
- */
-export interface PerfQuery {
-	/** Rolling window size in minutes (default: 30, max: 1440). Optional. */
-	readonly minutes?: number;
-}
-
-/**
- * Response for GET /api/perf. Rolling-window aggregates over perf_samples
- * with per-kind p50/p95, latest rss/heap, cpu counters, and diagnostic data.
- */
-export interface PerfResponse {
-	/** ISO timestamp when the response was generated. */
-	readonly updatedAt: string;
-	/** Rolling window size in minutes. */
-	readonly windowMinutes: number;
-	/** Total number of perf samples in the window. */
-	readonly sampleCount: number;
-	/** Turn latency statistics in milliseconds. */
-	readonly turn_latency_ms: PerfPercentile;
-	/** Provider latency statistics in milliseconds. */
-	readonly provider_latency_ms: PerfPercentile;
-	/** Tokens-per-second statistics. */
-	readonly tps: PerfAverage;
-	/** Cache hit percentage statistics. */
-	readonly cache_hit_pct: PerfCacheHit;
-	/** Database recompute duration statistics in milliseconds. */
-	readonly db_recompute_ms: PerfPercentile;
-	/** Disk write duration statistics in milliseconds. */
-	readonly disk_write_ms: PerfPercentile;
-	/** RSS memory usage in MB (latest value). */
-	readonly rss_mb: PerfLatest;
-	/** Heap memory usage in MB (latest value). */
-	readonly heap_mb: PerfLatest;
-	/** CPU user time in milliseconds (latest value). */
-	readonly cpu_user_ms: PerfLatest;
-	/** CPU system time in milliseconds (latest value). */
-	readonly cpu_sys_ms: PerfLatest;
-	/** Diagnostic counters from the live snapshot, or null if unavailable. */
-	readonly diag: PerfDiag | null;
-}
-
-// ─── Provider Cache Lifetime (A.2) — see provider-cache.ts ─────────────────
-
-// ─── Game Score & Achievement Types ─────────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-
-// ─── Sessions Memory Graph (S39) ─────────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-
-// ─── Game State Patch (PUT request body) ────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-
-// ─── SSE Endpoint Definition ────────────────────────────────────────────────
-// (moved to game-types.ts; re-exported for backwards compatibility)
-
-// ─── ENDPOINTS Registry ─────────────────────────────────────────────────────
-
-/**
- * Central registry of all 14 dashboard API endpoints. Each entry is an
- * `EndpointDef` or `SseEndpointDef` instance serving as the single source of
- * truth for route paths, methods, descriptions, and typed request/response
- * contracts.
- *
- * Usage:
- *   import { ENDPOINTS } from './api-contracts';
- *   ENDPOINTS.snapshot.path   // '/api/snapshot'
- *   ENDPOINTS.snapshot.method // 'GET'
- */
-export const ENDPOINTS = {
-	/** GET /api/snapshot — Full session, store, compression, and context snapshot. */
-	snapshot: {
-		method: "GET",
-		path: "/api/snapshot",
-		description: "Full session, store, compression, and context snapshot.",
-	} as const satisfies EndpointDef<"GET", undefined, SnapshotResponse>,
-
-	/** GET /api/version — Dashboard server version string. */
-	version: {
-		method: "GET",
-		path: "/api/version",
-		description: "Dashboard server version for stale-server detection.",
-	} as const satisfies EndpointDef<"GET", undefined, VersionResponse>,
-
-	/** GET /api/index — Multi-repo aggregate index (or fallback when unavailable). */
-	index: {
-		method: "GET",
-		path: "/api/index",
-		description:
-			"Machine-wide multi-repo registry with checkpoints, tokens, and model info.",
-	} as const satisfies EndpointDef<
-		"GET",
-		undefined,
-		IndexesSummaryResponse | IndexFallbackResponse
-	>,
-
-	/** GET /api/repos — Registry list with optional active-window filter. */
-	repos: {
-		method: "GET",
-		path: "/api/repos",
-		description: "Repo registry list, optionally filtered by recent activity.",
-	} as const satisfies EndpointDef<"GET", ReposQuery, ReposResponse>,
-
-	/** GET /api/summary — Lightweight header tiles without the full repo list. */
-	summary: {
-		method: "GET",
-		path: "/api/summary",
-		description:
-			"Aggregate summary with active/total repo counts (no repo list).",
-	} as const satisfies EndpointDef<"GET", undefined, SummaryResponse>,
-
-	/** GET /api/drift — Cross-repo drift report. */
-	drift: {
-		method: "GET",
-		path: "/api/drift",
-		description:
-			"Cross-repo drift report flagging stale repos, compaction lag, and model churn.",
-	} as const satisfies EndpointDef<"GET", undefined, DriftReportResponse>,
-
-	/** GET /api/servers — Recently-active repo servers with live snapshot data. */
-	servers: {
-		method: "GET",
-		path: "/api/servers",
-		description: "Recently-active repo servers with live snapshot data.",
-	} as const satisfies EndpointDef<"GET", undefined, ServersResponse>,
-
-	/** GET /api/events — SSE stream of dashboard events. */
-	events: {
-		type: "sse",
-		method: "GET",
-		path: "/api/events",
-		description: "Server-Sent Events stream of all dashboard events.",
-		event: "data",
-	} as const satisfies SseEndpointDef<SseEvent>,
-
-	/** GET /api/game-state — Current game-mode settings. */
-	getGameState: {
-		method: "GET",
-		path: "/api/game-state",
-		description: "Current game-mode configuration and active ritual state.",
-	} as const satisfies EndpointDef<"GET", undefined, GameStateResponse>,
-
-	/** PUT /api/game-state — Apply a partial patch to game-mode settings. */
-	putGameState: {
-		method: "PUT",
-		path: "/api/game-state",
-		description:
-			"Apply a partial patch to game-mode settings and return the updated state.",
-	} as const satisfies EndpointDef<"PUT", GameStatePatch, GameStateResponse>,
-
-	/** GET /api/game-scores — High-score leaderboard for a metric. */
-	gameScores: {
-		method: "GET",
-		path: "/api/game-scores",
-		description: "High-score leaderboard for a game metric.",
-	} as const satisfies EndpointDef<"GET", GameScoresQuery, GameScoreRow[]>,
-
-	/** GET /api/perf — Rolling-window performance aggregates. */
-	perf: {
-		method: "GET",
-		path: "/api/perf",
-		description: "Rolling-window performance aggregates over perf_samples.",
-	} as const satisfies EndpointDef<"GET", PerfQuery, PerfResponse>,
-
-	/** GET /api/achievements — Achievement tiles with unlock state. */
-	achievements: {
-		method: "GET",
-		path: "/api/achievements",
-		description: "All achievement rows with unlock state.",
-	} as const satisfies EndpointDef<"GET", undefined, AchievementRow[]>,
-
-	/** GET /api/sessions — Active sessions with latest token usage (S39). */
-	sessions: {
-		method: "GET",
-		path: "/api/sessions",
-		description: "Active pi sessions with latest token usage + heartbeat.",
-	} as const satisfies EndpointDef<"GET", undefined, SessionsResponse>,
-
-	/** GET /api/sessions/timeseries — Stacked per-session token timeseries (S39). */
-	sessionTimeseries: {
-		method: "GET",
-		path: "/api/sessions/timeseries",
-		description:
-			"Recharts-ready per-session token timeseries for the stacked memory graph.",
-	} as const satisfies EndpointDef<
-		"GET",
-		SessionTimeseriesQuery,
-		SessionTimeseriesResponse
-	>,
-
-	/** GET /api/topics — Auto-categorizing wiki topics (S51). */
-	topics: {
-		method: "GET",
-		path: "/api/topics",
-		description:
-			"Auto-categorized wiki topics from k-means + TF-IDF over real embeddings.",
-	} as const satisfies EndpointDef<"GET", undefined, TopicsResponse>,
-
-	/** GET /api/turns — Turn-by-turn memory tracking + recall (S52). */
-	turns: {
-		method: "GET",
-		path: "/api/turns",
-		description:
-			"Per-conversation turn list with recall + epoch provenance (turn-by-turn memory tracking).",
-	} as const satisfies EndpointDef<"GET", undefined, TurnsResponse>,
-
-	/** GET /api/turns/conversation/:convId — per-turn detail + recall hits. */
-	conversationTurns: {
-		method: "GET",
-		path: "/api/turns/conversation/:convId",
-		description:
-			"Per-turn metrics + injected-checkpoint recall provenance for one conversation.",
-	} as const satisfies EndpointDef<"GET", undefined, ConversationTurnsResponse>,
-
-	/** GET /api/turns/intents — pending rewind intents (S52A). */
-	turnIntents: {
-		method: "GET",
-		path: "/api/turns/intents",
-		description:
-			"Pending rewind intents queued by the dashboard for the host to consume.",
-	} as const satisfies EndpointDef<"GET", undefined, RewindIntentsResponse>,
-
-	/** POST /api/turns/intent — post a rewind intent. */
-	postTurnIntent: {
-		method: "POST",
-		path: "/api/turns/intent",
-		description:
-			"Queue a rewind-to-turn-N intent for the host to apply at before_agent_start.",
-	} as const satisfies EndpointDef<"POST", PostIntentRequest, unknown>,
-
-	/** POST /api/fork — fork a conversation at a turn. */
-	fork: {
-		method: "POST",
-		path: "/api/fork",
-		description:
-			"Branch a child conversation off a parent turn + return the recall set to rehydrate.",
-	} as const satisfies EndpointDef<"POST", ForkRequest, ForkResponse>,
-
-	/** POST /api/turns/prune — admin prune (capability-gated). */
-	pruneTurns: {
-		method: "POST",
-		path: "/api/turns/prune",
-		description:
-			"Prune old turns (admin capability — dashboard uses asAdmin()).",
-	} as const satisfies EndpointDef<"POST", PruneRequest, PruneTurnsResponse>,
-
-	/** GET /api/topics/:topicId/memories — wiki topic drill-down (S52). */
-	topicMemories: {
-		method: "GET",
-		path: "/api/topics/:topicId/memories",
-		description: "Member memories assigned to a wiki topic (drill-down).",
-	} as const satisfies EndpointDef<"GET", undefined, TopicMemoriesResponse>,
-
-	// ─── S49B Maintenance Tab ─────────────────────────────────────────
-
-	/** GET /api/maintenance — DB stats (table row counts + storage). */
-	maintenanceStats: {
-		method: "GET",
-		path: "/api/maintenance",
-		description: "SQLite table row counts, storage stats, and DB file sizes.",
-	} as const satisfies EndpointDef<"GET", undefined, DbStatsResponse>,
-
-	/** GET /api/maintenance/schema-health — Schema version + integrity audit. */
-	schemaHealth: {
-		method: "GET",
-		path: "/api/maintenance/schema-health",
-		description:
-			"SCHEMA_VERSION, PRAGMA integrity_check, FK check, and per-column audit.",
-	} as const satisfies EndpointDef<"GET", undefined, SchemaHealthResponse>,
-
-	/** POST /api/maintenance/action — Trigger a maintenance action. */
-	maintenanceAction: {
-		method: "POST",
-		path: "/api/maintenance/action",
-		description:
-			"Run vacuum, checkpoint, reindex, fts5-rebuild, reconcile-dedup, prune, or integrity-check.",
-	} as const satisfies EndpointDef<
-		"POST",
-		MaintenanceAction,
-		MaintenanceActionResult
-	>,
-
-	// ─── Provider Cache (Sprint A.2) ─────────────────────────────────
-
-	/** GET /api/provider-cache — Lifetime provider prompt cache aggregates + $ savings. */
-	providerCache: {
-		method: "GET",
-		path: "/api/provider-cache",
-		description:
-			"Lifetime provider prompt cache hit-rate aggregates + dollar savings estimate.",
-	} as const satisfies EndpointDef<"GET", undefined, ProviderCacheResponse>,
-
-
-		// ─── A3 Cache Stripes (PLAN_V2 Phase 4) ───────────────────────────
-
-		/** GET /api/cache-stripes — Per-stripe distribution + health score. */
-		cacheStripes: {
-			method: "GET",
-			path: "/api/cache-stripes",
-			description:
-				"Per-stripe distribution counts, average stability scores, and composite cache health.",
-		} as const satisfies EndpointDef<"GET", undefined, CacheStripesResponse>,
-	// ─── Memory Effectiveness (S53B) ───────────────────────────────────────
-
-	/** GET /api/memory-status — Memory store aggregate statistics. */
-	memoryStatus: {
-		method: "GET",
-		path: "/api/memory-status",
-		description:
-			"Memory store statistics: total count, 30-day window, top-N stable memories, avg recall score.",
-	} as const satisfies EndpointDef<"GET", undefined, MemoryStatusResponse>,
-
-	/** GET /api/setup-status — Current embedder configuration. */
-	setupStatus: {
-		method: "GET",
-		path: "/api/setup-status",
-		description:
-			"Current embedder configuration (which embedder is active, embedding URL, cache, MiniLM flag).",
-	} as const satisfies EndpointDef<"GET", undefined, SetupStatusResponse>,
-
-	/** GET /api/setup-detect — Detect available local embedder backends. */
-	setupDetect: {
-		method: "GET",
-		path: "/api/setup-detect",
-		description:
-			"Best-effort detection of local embedder backends (ollama, llama.cpp, ONNX) available on the machine.",
-	} as const satisfies EndpointDef<"GET", undefined, SetupDetectResponse>,
+} from "./endpoints/types.js";
 
-	/** POST /api/setup-configure — Write embedder config to .mega-compact.env. */
-	setupConfigure: {
-		method: "POST",
-		path: "/api/setup-configure",
-		description:
-			"Write the chosen embedder configuration to .mega-compact.env (loaded at next startup). Returns whether a restart is required.",
-	} as const satisfies EndpointDef<"POST", SetupConfigureRequest, SetupConfigureResponse>,
-} as const;
+export { ENDPOINTS } from "./endpoints/registry.js";