@cyber-dash-tech/revela 0.9.0 → 0.10.0

package/lib/inspect/request.ts

@@ -0,0 +1,70 @@
+import { hasDecksState, readDecksState, type DecksState } from "../decks-state"
+import { compileInspectionContext } from "../inspection-context/compile"
+import { matchInspectionElement, type InspectionElementSnapshot } from "../inspection-context/match"
+import { projectInspectionMatch, type InspectionPromptProjection } from "../inspection-context/project"
+import { buildDeterministicInspectionResult, type InspectionResult } from "../inspection-context/result"
+
+export interface InspectElementResult {
+  requestId?: string
+  result: InspectionResult
+}
+
+export interface InspectElementProjectionResult {
+  requestId?: string
+  projection: InspectionPromptProjection
+  preprocess: InspectionResult
+}
+
+export function inspectElementInState(
+  state: DecksState,
+  snapshot: InspectionElementSnapshot,
+  options: { requestId?: string; staleReason?: string; slug?: string } = {},
+): InspectElementResult {
+  const context = compileInspectionContext(state, options.slug)
+  const match = matchInspectionElement(context, snapshot)
+  const projection = projectInspectionMatch(context, match, snapshot)
+  return {
+    requestId: options.requestId,
+    result: buildDeterministicInspectionResult(projection, {
+      requestId: options.requestId,
+      staleReason: options.staleReason,
+    }),
+  }
+}
+
+export function projectElementInState(
+  state: DecksState,
+  snapshot: InspectionElementSnapshot,
+  options: { requestId?: string; slug?: string } = {},
+): InspectElementProjectionResult {
+  const context = compileInspectionContext(state, options.slug)
+  const match = matchInspectionElement(context, snapshot)
+  const projection = projectInspectionMatch(context, match, snapshot)
+  return {
+    requestId: options.requestId,
+    projection,
+    preprocess: buildDeterministicInspectionResult(projection, { requestId: options.requestId }),
+  }
+}
+
+export function inspectWorkspaceElement(
+  workspaceRoot: string,
+  snapshot: InspectionElementSnapshot,
+  options: { requestId?: string; staleReason?: string; slug?: string } = {},
+): InspectElementResult {
+  if (!hasDecksState(workspaceRoot)) {
+    throw new Error("DECKS.json is required before inspection. Run /revela init first.")
+  }
+  return inspectElementInState(readDecksState(workspaceRoot), snapshot, options)
+}
+
+export function projectWorkspaceElement(
+  workspaceRoot: string,
+  snapshot: InspectionElementSnapshot,
+  options: { requestId?: string; slug?: string } = {},
+): InspectElementProjectionResult {
+  if (!hasDecksState(workspaceRoot)) {
+    throw new Error("DECKS.json is required before inspection. Run /revela init first.")
+  }
+  return projectElementInState(readDecksState(workspaceRoot), snapshot, options)
+}

package/lib/inspect/requests.ts

@@ -0,0 +1,86 @@
+import type { InspectionPromptProjection } from "../inspection-context/project"
+import type { InspectionResult } from "../inspection-context/result"
+
+export type InspectRequestStatus = "pending" | "completed" | "failed" | "expired"
+
+export interface PendingInspectRequest {
+  requestId: string
+  status: InspectRequestStatus
+  projection: InspectionPromptProjection
+  deckVersion: string
+  createdAt: number
+  updatedAt: number
+  result?: InspectionResult
+  error?: string
+}
+
+const REQUEST_TTL_MS = 90 * 1000
+const requests = new Map<string, PendingInspectRequest>()
+
+export function createInspectRequest(input: {
+  requestId: string
+  projection: InspectionPromptProjection
+  deckVersion: string
+}): PendingInspectRequest {
+  cleanupInspectRequests()
+  const now = Date.now()
+  const request: PendingInspectRequest = {
+    requestId: input.requestId,
+    status: "pending",
+    projection: input.projection,
+    deckVersion: input.deckVersion,
+    createdAt: now,
+    updatedAt: now,
+  }
+  requests.set(input.requestId, request)
+  return request
+}
+
+export function getInspectRequest(requestId: string): PendingInspectRequest | undefined {
+  cleanupInspectRequests()
+  const request = requests.get(requestId)
+  if (!request) return undefined
+  if (request.status === "pending" && Date.now() - request.createdAt > REQUEST_TTL_MS) {
+    request.status = "expired"
+    request.error = "Inspection timed out before the LLM submitted a result."
+    request.updatedAt = Date.now()
+  }
+  return request
+}
+
+export function completeInspectRequest(requestId: string, result: InspectionResult): PendingInspectRequest {
+  const request = getInspectRequest(requestId)
+  if (!request) throw new Error(`Unknown inspection request: ${requestId}`)
+  if (request.status !== "pending") throw new Error(`Inspection request is not pending: ${request.status}`)
+  request.status = "completed"
+  request.result = { ...result, requestId }
+  request.updatedAt = Date.now()
+  return request
+}
+
+export function failInspectRequest(requestId: string, error: string): PendingInspectRequest | undefined {
+  const request = getInspectRequest(requestId)
+  if (!request || request.status !== "pending") return request
+  request.status = "failed"
+  request.error = error
+  request.updatedAt = Date.now()
+  return request
+}
+
+export function cleanupInspectRequests(now = Date.now()): void {
+  for (const [requestId, request] of requests) {
+    if (request.status === "pending" && now - request.createdAt > REQUEST_TTL_MS) {
+      request.status = "expired"
+      request.error = "Inspection timed out before the LLM submitted a result."
+      request.updatedAt = now
+      continue
+    }
+    if (request.status !== "pending" && now - request.updatedAt > REQUEST_TTL_MS) {
+      requests.delete(requestId)
+    }
+  }
+}
+
+export function clearInspectRequestsForTests(): void {
+  requests.clear()
+}