pi-mega-compact 0.8.8 → 0.8.10

package/dist/extensions/dashboard-server/api-contracts/core.js

@@ -0,0 +1,7 @@
+/**
+ * api-contracts/core.ts — Core types shared across all API domains.
+ *
+ * Contains: generic endpoint definition, HTTP method, SSE event types.
+ * Extracted from api-contracts.ts (Sprint A1 split).
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts/endpoints.js

@@ -0,0 +1,104 @@
+/**
+ * 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.
+ *
+ * Sprint A1 — PREVENT-PI-004: zero network code (type definitions only).
+ * PREVENT-011: no `any` type — all types are explicit.
+ */
+// ─── ENDPOINTS Registry ─────────────────────────────────────────────────────
+/**
+ * Central registry of all 13 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.',
+    },
+    /** GET /api/version — Dashboard server version string. */
+    version: {
+        method: 'GET',
+        path: '/api/version',
+        description: 'Dashboard server version for stale-server detection.',
+    },
+    /** 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.',
+    },
+    /** 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.',
+    },
+    /** 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).',
+    },
+    /** 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.',
+    },
+    /** 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.',
+    },
+    /** 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',
+    },
+    /** GET /api/game-state — Current game-mode settings. */
+    getGameState: {
+        method: 'GET',
+        path: '/api/game-state',
+        description: 'Current game-mode configuration and active ritual state.',
+    },
+    /** 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.',
+    },
+    /** 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.',
+    },
+    /** GET /api/perf — Rolling-window performance aggregates. */
+    perf: {
+        method: 'GET',
+        path: '/api/perf',
+        description: 'Rolling-window performance aggregates over perf_samples.',
+    },
+    /** GET /api/achievements — Achievement tiles with unlock state. */
+    achievements: {
+        method: 'GET',
+        path: '/api/achievements',
+        description: 'All achievement rows with unlock state.',
+    },
+};

package/dist/extensions/dashboard-server/api-contracts/game.js

@@ -0,0 +1,9 @@
+/**
+ * api-contracts/game.ts — Game mode and mega-game contracts.
+ *
+ * Contains: GameConfig, GameStateResponse, GameRitualStage,
+ * SseGameRitualStart, SseGameRitualStage, SseGameRitualEnd,
+ * SseGameModeChanged, SseGameRender.
+ * Extracted from api-contracts.ts (Sprint A1 split).
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts/index.js

@@ -0,0 +1,9 @@
+/**
+ * api-contracts/index.ts — Barrel re-export for all API contract domains.
+ *
+ * Import from this file to access all types:
+ *   import type { SnapshotResponse, RepoListItem } from '../api-contracts';
+ *   // or explicitly:
+ *   import type { SnapshotResponse } from '../api-contracts/snapshot';
+ */
+export { ENDPOINTS } from './endpoints.js';

package/dist/extensions/dashboard-server/api-contracts/infrastructure.js

@@ -0,0 +1,10 @@
+/**
+ * api-contracts/infrastructure.ts — Infrastructure, diagnostics, and monitoring contracts.
+ *
+ * Contains: InfraHealthResponse, InfraPerfSampleResponse,
+ * InfraRateLimitStatus, InfraRateLimitResponse, ContextLevelState,
+ * TierOverrideState, FallbackState, RepeatInjectionState,
+ * SupersedeGatingState, MinHashBandState.
+ * Extracted from api-contracts.ts (Sprint A1 split).
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts/multi-repo.js

@@ -0,0 +1,9 @@
+/**
+ * api-contracts/multi-repo.ts — Multi-repo index and repo management contracts.
+ *
+ * Contains: RepoListItem, RepoSnapshotEntry, RepoSnapshotMap,
+ * IndexesIndexRow, IndexesSummaryResponse, IndexesDiffEntry,
+ * DiffRequest, DiffResponse, UpdateRepoConfigRequest.
+ * Extracted from api-contracts.ts (Sprint A1 split).
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts/snapshot.js

@@ -0,0 +1,8 @@
+/**
+ * api-contracts/snapshot.ts — Snapshot / store / compression / session contracts.
+ *
+ * Contains: SnapshotResponse, TriggerResponse, CompressionTotalsResponse,
+ * CompactHistoryEntry, CompactionRequest, CompactionResponse.
+ * Extracted from api-contracts.ts (Sprint A1 split).
+ */
+export {};

package/dist/extensions/dashboard-server/api-contracts.js

@@ -0,0 +1,8 @@
+/**
+ * @deprecated Import from `./api-contracts/index.js` (barrel) instead.
+ * This file is retained for backward compatibility. All types are re-exported
+ * from domain modules under `api-contracts/`.
+ *
+ * See: api-contracts/core.ts, snapshot.ts, multi-repo.ts, game.ts, infrastructure.ts
+ */
+export { ENDPOINTS } from './api-contracts/index.js';