@moldea.ai/core 7.0.4 → 8.0.0

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","names":[],"sources":["../src/node-inspection/client.ts"],"sourcesContent":["import { fork } from 'node:child_process';\nimport { randomBytes } from 'node:crypto';\nimport { fileURLToPath } from 'node:url';\n\nimport { RepositorySourceException } from '@moldea.ai/repository';\n\nimport { CoreOperationException } from '../exceptions/index.js';\nimport { freezeRecursively } from '../immutable/index.js';\nimport { normalizeCoreOptions } from '../options/index.js';\n\nimport {\n  NODE_INSPECTION_LIFETIME_MS,\n  NODE_INSPECTION_MAX_REQUESTS,\n  NODE_INSPECTION_STDIO_BYTES,\n  NODE_INSPECTION_TRANSPORT_BYTES,\n} from './constants.js';\nimport { deserializeInspectionFailure, serializeInspectionFailure } from './errors.js';\nimport {\n  createInspectionEnvironment,\n  createInspectionSender,\n  superviseInspectionChild,\n} from './lifecycle.js';\nimport { createInspectionProcessFailure, decodeInspectionMessage } from './protocol.js';\nimport { executeRepositoryRpc } from './repository-rpc.js';\nimport type {\n  INodeInspectionMetadata,\n  INodeProjectInspection,\n  INodeProjectInspectionInput,\n} from './types.js';\nimport type { IProjectInspectionPageResult } from '../contracts/index.js';\n\nlet isInspectionActive = false;\n\n/** Stores one completion without an unhandled rejection before its owner begins awaiting it. */\nconst createCompletion = <T>(): {\n  promise: Promise<T>;\n  resolve: (result: T) => void;\n  reject: (cause: unknown) => void;\n} => {\n  let resolve!: (result: T) => void;\n  let reject!: (cause: unknown) => void;\n  const promise = new Promise<T>((resolveResult, rejectResult) => {\n    resolve = resolveResult;\n    reject = rejectResult;\n  });\n  void promise.catch(() => {});\n  return { promise, resolve, reject };\n};\n\nconst aborted = (cause?: unknown): CoreOperationException =>\n  new CoreOperationException({\n    code: 'ABORTED',\n    operation: 'create-project-inspection',\n    ...(cause === undefined ? {} : { cause }),\n  });\n\n/**\n * Prepares content-free inspection inside one supervised subprocess and one analysis worker.\n * The caller owns actual reader work and must dispose the returned handle before publishing success.\n * @returns An async paging handle after the worker reports its actual heap and prepares inspection.\n * @throws\n * - INVALID_ARGUMENT: The Core operation received an invalid argument.\n * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.\n * - ABORTED: The Core operation was aborted.\n * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n * - INSPECTION_BUSY: Project inspection capacity is busy. Try again shortly.\n * - INSPECTION_TIMEOUT: The isolated project inspection timed out.\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n * - INVALID_REPOSITORY_PATH: The repository path is invalid.\n * - ENTRY_NOT_FOUND: The requested repository entry was not found.\n * - ENTRY_NOT_FILE: The requested repository entry is not a file.\n * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.\n * - INVALID_PAGE_REQUEST: The repository page request is invalid.\n * - ACCESS_DENIED: Access to the repository source was denied.\n * - SOURCE_UNAVAILABLE: The repository source is unavailable.\n * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.\n * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.\n * - INVALID_SOURCE_DATA: The repository source returned invalid data.\n * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.\n * - ABORTED: The repository operation was aborted.\n */\nexport const createNodeProjectInspection = async (\n  input: INodeProjectInspectionInput,\n): Promise<INodeProjectInspection> => {\n  if (\n    input === null ||\n    typeof input !== 'object' ||\n    input.repository === null ||\n    typeof input.repository !== 'object' ||\n    typeof input.repository.getEntry !== 'function' ||\n    typeof input.repository.listEntriesPage !== 'function' ||\n    typeof input.repository.readFilePage !== 'function' ||\n    input.repository.snapshot === null ||\n    typeof input.repository.snapshot !== 'object' ||\n    typeof input.repository.snapshot.id !== 'string' ||\n    input.repository.snapshot.id.length === 0 ||\n    typeof input.repository.snapshot.sourceKind !== 'string' ||\n    input.repository.snapshot.sourceKind.length === 0\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  let repository: INodeProjectInspectionInput['repository'] | undefined = input.repository;\n  const snapshot = { id: repository.snapshot.id, sourceKind: repository.snapshot.sourceKind };\n  const signal = input.signal;\n  if (\n    signal !== undefined &&\n    (signal === null ||\n      typeof signal !== 'object' ||\n      typeof signal.aborted !== 'boolean' ||\n      typeof signal.addEventListener !== 'function' ||\n      typeof signal.removeEventListener !== 'function')\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  const { limits } = normalizeCoreOptions({\n    ...(input.limits === undefined ? {} : { limits: input.limits }),\n  });\n  if (input.deadline !== undefined && (!Number.isSafeInteger(input.deadline) || input.deadline < 0))\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  if (signal?.aborted === true) throw aborted(signal.reason);\n  if (isInspectionActive)\n    throw new CoreOperationException({\n      code: 'INSPECTION_BUSY',\n      operation: 'create-project-inspection',\n    });\n  if (limits.maxRetainedBytes <= NODE_INSPECTION_TRANSPORT_BYTES)\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      operation: 'create-project-inspection',\n      limit: 'maxRetainedBytes',\n      limitMaximum: limits.maxRetainedBytes,\n      observedUsage: NODE_INSPECTION_TRANSPORT_BYTES,\n      nextAction: 'reduce-input-or-increase-limit',\n    });\n  const deadline = Math.min(Date.now() + NODE_INSPECTION_LIFETIME_MS, input.deadline ?? Infinity);\n  if (deadline <= Date.now())\n    throw new CoreOperationException({\n      code: 'INSPECTION_TIMEOUT',\n      operation: 'create-project-inspection',\n    });\n  isInspectionActive = true;\n  const controller = new AbortController();\n  const attemptId = randomBytes(16).toString('hex');\n  const prepared = createCompletion<INodeInspectionMetadata>();\n  let pendingPage: ReturnType<typeof createCompletion<IProjectInspectionPageResult>> | undefined;\n  let pageRequestId = 0;\n  let lastReaderRequestId = -1;\n  let hasAcknowledgedHeap = false;\n  let heapMaximum: number | undefined;\n  let hasPrepared = false;\n  let isClosing = false;\n  let failure: { cause: Error } | undefined;\n  let cleanupPromise: Promise<void> | undefined;\n  const readerWork = new Set<Promise<unknown>>();\n  const relayWork = new Set<Promise<void>>();\n  const child = (() => {\n    try {\n      return fork(fileURLToPath(import.meta.resolve('#moldea-core-runner')), [], {\n        execPath: process.execPath,\n        execArgv: [],\n        env: createInspectionEnvironment(),\n        serialization: 'advanced',\n        stdio: ['ignore', 'ignore', 'pipe', 'ipc'],\n      });\n    } catch (cause) {\n      isInspectionActive = false;\n      throw createInspectionProcessFailure(cause);\n    }\n  })();\n  const send = createInspectionSender((frame, callback) => {\n    if (!child.connected) throw createInspectionProcessFailure();\n    child.send(frame, callback);\n  });\n  const supervision = superviseInspectionChild(child, () => {\n    void send({ attemptId, kind: 'dispose' }).catch(() => {\n      child.kill('SIGKILL');\n    });\n  });\n\n  /** Keeps admission until child closure and every real reader promise has settled. */\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      isClosing = true;\n      controller.abort(failure?.cause);\n      supervision.terminate();\n      await supervision.closed;\n      await Promise.allSettled([...readerWork, ...relayWork]);\n      repository = undefined;\n      clearTimeout(timer);\n      if (failure === undefined && Date.now() >= deadline) {\n        fail(\n          new CoreOperationException({\n            code: 'INSPECTION_TIMEOUT',\n            operation: 'create-project-inspection',\n          }),\n        );\n      }\n      signal?.removeEventListener('abort', handleAbort);\n      child.removeAllListeners('message');\n      child.removeAllListeners('error');\n      child.stderr?.removeAllListeners('data');\n      isInspectionActive = false;\n    })();\n    return cleanupPromise;\n  };\n  const fail = (cause: unknown): void => {\n    if (failure === undefined)\n      failure = { cause: cause instanceof Error ? cause : createInspectionProcessFailure(cause) };\n    prepared.reject(failure.cause);\n    pendingPage?.reject(failure.cause);\n    void cleanup();\n  };\n  const getFailureCause = (): Error | undefined => failure?.cause;\n  const handleAbort = (): void => {\n    fail(aborted(signal?.reason));\n  };\n  const timer = setTimeout(\n    () => {\n      fail(\n        new CoreOperationException({\n          code: 'INSPECTION_TIMEOUT',\n          operation: 'create-project-inspection',\n        }),\n      );\n    },\n    Math.max(1, deadline - Date.now()),\n  );\n  signal?.addEventListener('abort', handleAbort, { once: true });\n  // Re-read through a function because cancellation can change during listener registration.\n  const isCallerAborted = (): boolean => signal?.aborted === true;\n  if (isCallerAborted()) handleAbort();\n  child.once('error', (cause: unknown) => {\n    fail(createInspectionProcessFailure(cause));\n  });\n  void supervision.closed.then(() => {\n    if (!isClosing) fail(createInspectionProcessFailure());\n  });\n  let stderrBytes = 0;\n  child.stderr?.on('data', (chunk: Buffer) => {\n    stderrBytes += chunk.byteLength;\n    if (stderrBytes > NODE_INSPECTION_STDIO_BYTES) fail(createInspectionProcessFailure());\n  });\n  child.on('message', (frame: unknown) => {\n    if (isClosing) return;\n    try {\n      const message = decodeInspectionMessage(frame);\n      if (message.attemptId !== attemptId) throw createInspectionProcessFailure();\n      if (message.kind === 'ready') {\n        if (hasAcknowledgedHeap) throw createInspectionProcessFailure();\n        heapMaximum = message.maxAnalysisHeapBytes;\n        hasAcknowledgedHeap = true;\n        void send({ attemptId, kind: 'run' }).catch(fail);\n      } else if (message.kind === 'prepared') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.inspection.maxAnalysisHeapBytes !== heapMaximum ||\n          message.inspection.source.id !== snapshot.id ||\n          message.inspection.source.sourceKind !== snapshot.sourceKind\n        )\n          throw createInspectionProcessFailure();\n        hasPrepared = true;\n        prepared.resolve(freezeRecursively(message.inspection));\n      } else if (message.kind === 'reader-request') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.requestId !== lastReaderRequestId + 1 ||\n          readerWork.size >= NODE_INSPECTION_MAX_REQUESTS\n        )\n          throw createInspectionProcessFailure();\n        lastReaderRequestId = message.requestId;\n        if (repository === undefined) throw createInspectionProcessFailure();\n        const work = executeRepositoryRpc(repository, message.request, controller.signal);\n        readerWork.add(work);\n        const relay = (async () => {\n          try {\n            const result = await work;\n            readerWork.delete(work);\n            if (!isClosing)\n              await send({\n                attemptId,\n                kind: 'reader-response',\n                requestId: message.requestId,\n                result,\n              });\n          } catch (cause) {\n            // Core decides whether absence or a reader resource refusal is recoverable at this check.\n            if (\n              cause instanceof RepositorySourceException &&\n              ['ENTRY_NOT_FOUND', 'ENTRY_NOT_FILE', 'RESOURCE_LIMIT_EXCEEDED'].includes(cause.code)\n            ) {\n              try {\n                if (!isClosing)\n                  await send({\n                    attemptId,\n                    kind: 'reader-failure',\n                    requestId: message.requestId,\n                    failure: serializeInspectionFailure(cause),\n                  });\n              } catch (transportFailure) {\n                fail(transportFailure);\n              }\n            } else fail(cause);\n          } finally {\n            readerWork.delete(work);\n          }\n        })();\n        relayWork.add(relay);\n        void relay.finally(() => relayWork.delete(relay));\n      } else if (message.kind === 'page') {\n        if (!hasPrepared || pendingPage === undefined || message.requestId !== pageRequestId)\n          throw createInspectionProcessFailure();\n        const completion = pendingPage;\n        pendingPage = undefined;\n        completion.resolve(freezeRecursively(message.result));\n      } else if (message.kind === 'failure') {\n        if (\n          message.failure.options['nextAction'] === 'review-inspection-capacity' &&\n          (heapMaximum === undefined || message.failure.options['limitMaximum'] !== heapMaximum)\n        )\n          throw createInspectionProcessFailure();\n        fail(deserializeInspectionFailure(message.failure));\n      } else throw createInspectionProcessFailure();\n    } catch (cause) {\n      fail(cause);\n    }\n  });\n  try {\n    await send({\n      attemptId,\n      kind: 'start',\n      snapshot,\n      limits,\n      deadline,\n    });\n    const metadata = await prepared.promise;\n    if (Date.now() >= deadline)\n      throw new CoreOperationException({\n        code: 'INSPECTION_TIMEOUT',\n        operation: 'create-project-inspection',\n      });\n    return Object.freeze({\n      ...metadata,\n      readPage: async (pageInput): Promise<IProjectInspectionPageResult> => {\n        if (failure !== undefined || isClosing) throw failure?.cause ?? aborted();\n        if (\n          pendingPage !== undefined ||\n          pageInput === null ||\n          typeof pageInput !== 'object' ||\n          Reflect.ownKeys(pageInput).some(\n            (key) => key !== 'cursor' && key !== 'maxItems' && key !== 'view',\n          ) ||\n          !Number.isSafeInteger(pageInput.maxItems) ||\n          pageInput.maxItems < 1 ||\n          pageInput.maxItems > limits.maxEntries ||\n          !['all', 'diagnostics', 'coverage', 'metadata'].includes(pageInput.view) ||\n          (pageInput.cursor !== undefined && typeof pageInput.cursor !== 'string')\n        )\n          throw new CoreOperationException({\n            code: 'INVALID_ARGUMENT',\n            operation: 'create-project-inspection',\n          });\n        const completion = createCompletion<IProjectInspectionPageResult>();\n        pendingPage = completion;\n        pageRequestId++;\n        try {\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          await send({\n            attemptId,\n            kind: 'read-page',\n            requestId: pageRequestId,\n            input: {\n              maxItems: pageInput.maxItems,\n              view: pageInput.view,\n              ...(pageInput.cursor === undefined ? {} : { cursor: pageInput.cursor }),\n            },\n          });\n          const result = await completion.promise;\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          return result;\n        } catch (cause) {\n          fail(cause);\n          await cleanup();\n          throw getFailureCause() ?? createInspectionProcessFailure(cause);\n        } finally {\n          if (pendingPage === completion) pendingPage = undefined;\n        }\n      },\n      dispose: async (): Promise<void> => {\n        pendingPage?.reject(failure?.cause ?? aborted());\n        await cleanup();\n        const cause = getFailureCause();\n        if (cause !== undefined) throw cause;\n      },\n    } satisfies INodeProjectInspection);\n  } catch (cause) {\n    fail(cause);\n    await cleanup();\n    throw getFailureCause() ?? createInspectionProcessFailure(cause);\n  }\n};\n"],"mappings":";;;;;;;;;;AA+BA,IAAI,qBAAqB;;AAGzB,IAAM,yBAID;CACH,IAAI;CACJ,IAAI;CACJ,MAAM,UAAU,IAAI,SAAY,eAAe,iBAAiB;EAC9D,UAAU;EACV,SAAS;CACX,CAAC;CACD,QAAa,YAAY,CAAC,CAAC;CAC3B,OAAO;EAAE;EAAS;EAAS;CAAO;AACpC;AAEA,IAAM,WAAW,UACf,IAAI,uBAAuB;CACzB,MAAM;CACN,WAAW;CACX,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;AACzC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BH,IAAa,8BAA8B,OACzC,UACoC;CACpC,IACE,UAAU,QACV,OAAO,UAAU,YACjB,MAAM,eAAe,QACrB,OAAO,MAAM,eAAe,YAC5B,OAAO,MAAM,WAAW,aAAa,cACrC,OAAO,MAAM,WAAW,oBAAoB,cAC5C,OAAO,MAAM,WAAW,iBAAiB,cACzC,MAAM,WAAW,aAAa,QAC9B,OAAO,MAAM,WAAW,aAAa,YACrC,OAAO,MAAM,WAAW,SAAS,OAAO,YACxC,MAAM,WAAW,SAAS,GAAG,WAAW,KACxC,OAAO,MAAM,WAAW,SAAS,eAAe,YAChD,MAAM,WAAW,SAAS,WAAW,WAAW,GAEhD,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN,WAAW;CACb,CAAC;CAEH,IAAI,aAAoE,MAAM;CAC9E,MAAM,WAAW;EAAE,IAAI,WAAW,SAAS;EAAI,YAAY,WAAW,SAAS;CAAW;CAC1F,MAAM,SAAS,MAAM;CACrB,IACE,WAAW,KAAA,MACV,WAAW,QACV,OAAO,WAAW,YAClB,OAAO,OAAO,YAAY,aAC1B,OAAO,OAAO,qBAAqB,cACnC,OAAO,OAAO,wBAAwB,aAExC,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN,WAAW;CACb,CAAC;CAEH,MAAM,EAAE,WAAW,qBAAqB,EACtC,GAAI,MAAM,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,MAAM,OAAO,EAC/D,CAAC;CACD,IAAI,MAAM,aAAa,KAAA,MAAc,CAAC,OAAO,cAAc,MAAM,QAAQ,KAAK,MAAM,WAAW,IAC7F,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN,WAAW;CACb,CAAC;CACH,IAAI,QAAQ,YAAY,MAAM,MAAM,QAAQ,OAAO,MAAM;CACzD,IAAI,oBACF,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN,WAAW;CACb,CAAC;CACH,IAAI,OAAO,oBAAA,UACT,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN,WAAW;EACX,OAAO;EACP,cAAc,OAAO;EACrB,eAAe;EACf,YAAY;CACd,CAAC;CACH,MAAM,WAAW,KAAK,IAAI,KAAK,IAAI,IAAI,6BAA6B,MAAM,YAAY,QAAQ;CAC9F,IAAI,YAAY,KAAK,IAAI,GACvB,MAAM,IAAI,uBAAuB;EAC/B,MAAM;EACN,WAAW;CACb,CAAC;CACH,qBAAqB;CACrB,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,YAAY,YAAY,EAAE,CAAC,CAAC,SAAS,KAAK;CAChD,MAAM,WAAW,iBAA0C;CAC3D,IAAI;CACJ,IAAI,gBAAgB;CACpB,IAAI,sBAAsB;CAC1B,IAAI,sBAAsB;CAC1B,IAAI;CACJ,IAAI,cAAc;CAClB,IAAI,YAAY;CAChB,IAAI;CACJ,IAAI;CACJ,MAAM,6BAAa,IAAI,IAAsB;CAC7C,MAAM,4BAAY,IAAI,IAAmB;CACzC,MAAM,eAAe;EACnB,IAAI;GACF,OAAO,KAAK,cAAc,YAAY,QAAQ,qBAAqB,CAAC,GAAG,CAAC,GAAG;IACzE,UAAU,QAAQ;IAClB,UAAU,CAAC;IACX,KAAK,4BAA4B;IACjC,eAAe;IACf,OAAO;KAAC;KAAU;KAAU;KAAQ;IAAK;GAC3C,CAAC;EACH,SAAS,OAAO;GACd,qBAAqB;GACrB,MAAM,+BAA+B,KAAK;EAC5C;CACF,EAAA,CAAG;CACH,MAAM,OAAO,wBAAwB,OAAO,aAAa;EACvD,IAAI,CAAC,MAAM,WAAW,MAAM,+BAA+B;EAC3D,MAAM,KAAK,OAAO,QAAQ;CAC5B,CAAC;CACD,MAAM,cAAc,yBAAyB,aAAa;EACxD,KAAU;GAAE;GAAW,MAAM;EAAU,CAAC,CAAC,CAAC,YAAY;GACpD,MAAM,KAAK,SAAS;EACtB,CAAC;CACH,CAAC;;CAGD,MAAM,gBAA+B;EACnC,oBAAoB,YAAY;GAC9B,YAAY;GACZ,WAAW,MAAM,SAAS,KAAK;GAC/B,YAAY,UAAU;GACtB,MAAM,YAAY;GAClB,MAAM,QAAQ,WAAW,CAAC,GAAG,YAAY,GAAG,SAAS,CAAC;GACtD,aAAa,KAAA;GACb,aAAa,KAAK;GAClB,IAAI,YAAY,KAAA,KAAa,KAAK,IAAI,KAAK,UACzC,KACE,IAAI,uBAAuB;IACzB,MAAM;IACN,WAAW;GACb,CAAC,CACH;GAEF,QAAQ,oBAAoB,SAAS,WAAW;GAChD,MAAM,mBAAmB,SAAS;GAClC,MAAM,mBAAmB,OAAO;GAChC,MAAM,QAAQ,mBAAmB,MAAM;GACvC,qBAAqB;EACvB,EAAA,CAAG;EACH,OAAO;CACT;CACA,MAAM,QAAQ,UAAyB;EACrC,IAAI,YAAY,KAAA,GACd,UAAU,EAAE,OAAO,iBAAiB,QAAQ,QAAQ,+BAA+B,KAAK,EAAE;EAC5F,SAAS,OAAO,QAAQ,KAAK;EAC7B,aAAa,OAAO,QAAQ,KAAK;EACjC,QAAa;CACf;CACA,MAAM,wBAA2C,SAAS;CAC1D,MAAM,oBAA0B;EAC9B,KAAK,QAAQ,QAAQ,MAAM,CAAC;CAC9B;CACA,MAAM,QAAQ,iBACN;EACJ,KACE,IAAI,uBAAuB;GACzB,MAAM;GACN,WAAW;EACb,CAAC,CACH;CACF,GACA,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC,CACnC;CACA,QAAQ,iBAAiB,SAAS,aAAa,EAAE,MAAM,KAAK,CAAC;CAE7D,MAAM,wBAAiC,QAAQ,YAAY;CAC3D,IAAI,gBAAgB,GAAG,YAAY;CACnC,MAAM,KAAK,UAAU,UAAmB;EACtC,KAAK,+BAA+B,KAAK,CAAC;CAC5C,CAAC;CACD,YAAiB,OAAO,WAAW;EACjC,IAAI,CAAC,WAAW,KAAK,+BAA+B,CAAC;CACvD,CAAC;CACD,IAAI,cAAc;CAClB,MAAM,QAAQ,GAAG,SAAS,UAAkB;EAC1C,eAAe,MAAM;EACrB,IAAI,cAAA,OAA2C,KAAK,+BAA+B,CAAC;CACtF,CAAC;CACD,MAAM,GAAG,YAAY,UAAmB;EACtC,IAAI,WAAW;EACf,IAAI;GACF,MAAM,UAAU,wBAAwB,KAAK;GAC7C,IAAI,QAAQ,cAAc,WAAW,MAAM,+BAA+B;GAC1E,IAAI,QAAQ,SAAS,SAAS;IAC5B,IAAI,qBAAqB,MAAM,+BAA+B;IAC9D,cAAc,QAAQ;IACtB,sBAAsB;IACtB,KAAU;KAAE;KAAW,MAAM;IAAM,CAAC,CAAC,CAAC,MAAM,IAAI;GAClD,OAAO,IAAI,QAAQ,SAAS,YAAY;IACtC,IACE,CAAC,uBACD,eACA,QAAQ,WAAW,yBAAyB,eAC5C,QAAQ,WAAW,OAAO,OAAO,SAAS,MAC1C,QAAQ,WAAW,OAAO,eAAe,SAAS,YAElD,MAAM,+BAA+B;IACvC,cAAc;IACd,SAAS,QAAQ,kBAAkB,QAAQ,UAAU,CAAC;GACxD,OAAO,IAAI,QAAQ,SAAS,kBAAkB;IAC5C,IACE,CAAC,uBACD,eACA,QAAQ,cAAc,sBAAsB,KAC5C,WAAW,QAAA,GAEX,MAAM,+BAA+B;IACvC,sBAAsB,QAAQ;IAC9B,IAAI,eAAe,KAAA,GAAW,MAAM,+BAA+B;IACnE,MAAM,OAAO,qBAAqB,YAAY,QAAQ,SAAS,WAAW,MAAM;IAChF,WAAW,IAAI,IAAI;IACnB,MAAM,SAAS,YAAY;KACzB,IAAI;MACF,MAAM,SAAS,MAAM;MACrB,WAAW,OAAO,IAAI;MACtB,IAAI,CAAC,WACH,MAAM,KAAK;OACT;OACA,MAAM;OACN,WAAW,QAAQ;OACnB;MACF,CAAC;KACL,SAAS,OAAO;MAEd,IACE,iBAAiB,6BACjB;OAAC;OAAmB;OAAkB;MAAyB,CAAC,CAAC,SAAS,MAAM,IAAI,GAEpF,IAAI;OACF,IAAI,CAAC,WACH,MAAM,KAAK;QACT;QACA,MAAM;QACN,WAAW,QAAQ;QACnB,SAAS,2BAA2B,KAAK;OAC3C,CAAC;MACL,SAAS,kBAAkB;OACzB,KAAK,gBAAgB;MACvB;WACK,KAAK,KAAK;KACnB,UAAU;MACR,WAAW,OAAO,IAAI;KACxB;IACF,EAAA,CAAG;IACH,UAAU,IAAI,KAAK;IACnB,MAAW,cAAc,UAAU,OAAO,KAAK,CAAC;GAClD,OAAO,IAAI,QAAQ,SAAS,QAAQ;IAClC,IAAI,CAAC,eAAe,gBAAgB,KAAA,KAAa,QAAQ,cAAc,eACrE,MAAM,+BAA+B;IACvC,MAAM,aAAa;IACnB,cAAc,KAAA;IACd,WAAW,QAAQ,kBAAkB,QAAQ,MAAM,CAAC;GACtD,OAAO,IAAI,QAAQ,SAAS,WAAW;IACrC,IACE,QAAQ,QAAQ,QAAQ,kBAAkB,iCACzC,gBAAgB,KAAA,KAAa,QAAQ,QAAQ,QAAQ,oBAAoB,cAE1E,MAAM,+BAA+B;IACvC,KAAK,6BAA6B,QAAQ,OAAO,CAAC;GACpD,OAAO,MAAM,+BAA+B;EAC9C,SAAS,OAAO;GACd,KAAK,KAAK;EACZ;CACF,CAAC;CACD,IAAI;EACF,MAAM,KAAK;GACT;GACA,MAAM;GACN;GACA;GACA;EACF,CAAC;EACD,MAAM,WAAW,MAAM,SAAS;EAChC,IAAI,KAAK,IAAI,KAAK,UAChB,MAAM,IAAI,uBAAuB;GAC/B,MAAM;GACN,WAAW;EACb,CAAC;EACH,OAAO,OAAO,OAAO;GACnB,GAAG;GACH,UAAU,OAAO,cAAqD;IACpE,IAAI,YAAY,KAAA,KAAa,WAAW,MAAM,SAAS,SAAS,QAAQ;IACxE,IACE,gBAAgB,KAAA,KAChB,cAAc,QACd,OAAO,cAAc,YACrB,QAAQ,QAAQ,SAAS,CAAC,CAAC,MACxB,QAAQ,QAAQ,YAAY,QAAQ,cAAc,QAAQ,MAC7D,KACA,CAAC,OAAO,cAAc,UAAU,QAAQ,KACxC,UAAU,WAAW,KACrB,UAAU,WAAW,OAAO,cAC5B,CAAC;KAAC;KAAO;KAAe;KAAY;IAAU,CAAC,CAAC,SAAS,UAAU,IAAI,KACtE,UAAU,WAAW,KAAA,KAAa,OAAO,UAAU,WAAW,UAE/D,MAAM,IAAI,uBAAuB;KAC/B,MAAM;KACN,WAAW;IACb,CAAC;IACH,MAAM,aAAa,iBAA+C;IAClE,cAAc;IACd;IACA,IAAI;KACF,IAAI,KAAK,IAAI,KAAK,UAChB,MAAM,IAAI,uBAAuB;MAC/B,MAAM;MACN,WAAW;KACb,CAAC;KACH,MAAM,KAAK;MACT;MACA,MAAM;MACN,WAAW;MACX,OAAO;OACL,UAAU,UAAU;OACpB,MAAM,UAAU;OAChB,GAAI,UAAU,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,UAAU,OAAO;MACvE;KACF,CAAC;KACD,MAAM,SAAS,MAAM,WAAW;KAChC,IAAI,KAAK,IAAI,KAAK,UAChB,MAAM,IAAI,uBAAuB;MAC/B,MAAM;MACN,WAAW;KACb,CAAC;KACH,OAAO;IACT,SAAS,OAAO;KACd,KAAK,KAAK;KACV,MAAM,QAAQ;KACd,MAAM,gBAAgB,KAAK,+BAA+B,KAAK;IACjE,UAAU;KACR,IAAI,gBAAgB,YAAY,cAAc,KAAA;IAChD;GACF;GACA,SAAS,YAA2B;IAClC,aAAa,OAAO,SAAS,SAAS,QAAQ,CAAC;IAC/C,MAAM,QAAQ;IACd,MAAM,QAAQ,gBAAgB;IAC9B,IAAI,UAAU,KAAA,GAAW,MAAM;GACjC;EACF,CAAkC;CACpC,SAAS,OAAO;EACd,KAAK,KAAK;EACV,MAAM,QAAQ;EACd,MAAM,gBAAgB,KAAK,+BAA+B,KAAK;CACjE;AACF"}
+{"version":3,"file":"node.js","names":[],"sources":["../src/node-inspection/client.ts"],"sourcesContent":["import { fork } from 'node:child_process';\nimport { randomBytes } from 'node:crypto';\nimport { fileURLToPath } from 'node:url';\n\nimport { RepositorySourceException } from '@moldea.ai/repository';\n\nimport { CoreOperationException } from '../exceptions/index.js';\nimport { freezeRecursively } from '../immutable/index.js';\nimport { normalizeCoreOptions } from '../options/index.js';\n\nimport {\n  NODE_INSPECTION_LIFETIME_MS,\n  NODE_INSPECTION_MAX_REQUESTS,\n  NODE_INSPECTION_STDIO_BYTES,\n  NODE_INSPECTION_TRANSPORT_BYTES,\n} from './constants.js';\nimport { deserializeInspectionFailure, serializeInspectionFailure } from './errors.js';\nimport {\n  createInspectionEnvironment,\n  createInspectionSender,\n  superviseInspectionChild,\n} from './lifecycle.js';\nimport { createInspectionProcessFailure, decodeInspectionMessage } from './protocol.js';\nimport { executeRepositoryRpc } from './repository-rpc.js';\nimport type {\n  INodeInspectionMetadata,\n  INodeInstructionSourceMetadata,\n  INodeProjectInspection,\n  INodeProjectInspectionInput,\n  INodeReaderSources,\n} from './types.js';\nimport type { IProjectInspectionPageResult } from '../contracts/index.js';\n\nlet isInspectionActive = false;\n\n/** Stores one completion without an unhandled rejection before its owner begins awaiting it. */\nconst createCompletion = <T>(): {\n  promise: Promise<T>;\n  resolve: (result: T) => void;\n  reject: (cause: unknown) => void;\n} => {\n  let resolve!: (result: T) => void;\n  let reject!: (cause: unknown) => void;\n  const promise = new Promise<T>((resolveResult, rejectResult) => {\n    resolve = resolveResult;\n    reject = rejectResult;\n  });\n  void promise.catch(() => {});\n  return { promise, resolve, reject };\n};\n\nconst isRecord = (input: unknown): input is Record<string, unknown> =>\n  input !== null && typeof input === 'object';\nconst isSnapshot = (input: unknown): input is { id: string; sourceKind: string } =>\n  isRecord(input) &&\n  typeof input['id'] === 'string' &&\n  input['id'].length > 0 &&\n  typeof input['sourceKind'] === 'string' &&\n  input['sourceKind'].length > 0;\n\n/** Describes a supplied instruction reader for the worker, or rejects one Core could not use. */\nconst describeInstructions = (\n  instructions: unknown,\n): INodeInstructionSourceMetadata | null | undefined => {\n  if (instructions === undefined) return null;\n  if (\n    !isRecord(instructions) ||\n    typeof instructions['getEntry'] !== 'function' ||\n    typeof instructions['readFilePage'] !== 'function' ||\n    typeof instructions['readLinkText'] !== 'function' ||\n    !isSnapshot(instructions['snapshot'])\n  )\n    return undefined;\n  return {\n    snapshot: { id: instructions['snapshot'].id, sourceKind: instructions['snapshot'].sourceKind },\n  };\n};\n\nconst aborted = (cause?: unknown): CoreOperationException =>\n  new CoreOperationException({\n    code: 'ABORTED',\n    operation: 'create-project-inspection',\n    ...(cause === undefined ? {} : { cause }),\n  });\n\n/**\n * Prepares content-free inspection inside one supervised subprocess and one analysis worker.\n * The caller owns actual reader work and must dispose the returned handle before publishing success.\n * @returns An async paging handle after the worker reports its actual heap and prepares inspection.\n * @throws\n * - INVALID_ARGUMENT: The Core operation received an invalid argument.\n * - INVALID_RESOURCE_LIMIT: A Core resource limit is invalid.\n * - ABORTED: The Core operation was aborted.\n * - RESOURCE_LIMIT_EXCEEDED: A Core resource limit was exceeded.\n * - INSPECTION_BUSY: Project inspection capacity is busy. Try again shortly.\n * - INSPECTION_TIMEOUT: The isolated project inspection timed out.\n * - INSPECTION_PROCESS_FAILED: The isolated project inspection failed.\n * - INVALID_REPOSITORY_PATH: The repository path is invalid.\n * - ENTRY_NOT_FOUND: The requested repository entry was not found.\n * - ENTRY_NOT_FILE: The requested repository entry is not a file.\n * - ENTRY_NOT_DIRECTORY: The requested repository entry is not a directory.\n * - INVALID_PAGE_REQUEST: The repository page request is invalid.\n * - ACCESS_DENIED: Access to the repository source was denied.\n * - SOURCE_UNAVAILABLE: The repository source is unavailable.\n * - SNAPSHOT_CHANGED: The repository snapshot changed during the operation.\n * - PROVIDER_INCOMPLETE: The repository provider cannot expose a complete result.\n * - INVALID_SOURCE_DATA: The repository source returned invalid data.\n * - RESOURCE_LIMIT_EXCEEDED: A named repository resource limit was exceeded.\n * - ABORTED: The repository operation was aborted.\n */\nexport const createNodeProjectInspection = async (\n  input: INodeProjectInspectionInput,\n): Promise<INodeProjectInspection> => {\n  if (\n    input === null ||\n    typeof input !== 'object' ||\n    input.repository === null ||\n    typeof input.repository !== 'object' ||\n    typeof input.repository.getEntry !== 'function' ||\n    typeof input.repository.listEntriesPage !== 'function' ||\n    typeof input.repository.readFilePage !== 'function' ||\n    typeof input.repository.readLinkText !== 'function' ||\n    input.repository.snapshot === null ||\n    typeof input.repository.snapshot !== 'object' ||\n    typeof input.repository.snapshot.id !== 'string' ||\n    input.repository.snapshot.id.length === 0 ||\n    typeof input.repository.snapshot.sourceKind !== 'string' ||\n    input.repository.snapshot.sourceKind.length === 0\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  const instructions = describeInstructions(input.instructions);\n  if (instructions === undefined)\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  let sources: INodeReaderSources | undefined = {\n    repository: input.repository,\n    ...(input.instructions === undefined ? {} : { instructions: input.instructions }),\n  };\n  const snapshot = {\n    id: input.repository.snapshot.id,\n    sourceKind: input.repository.snapshot.sourceKind,\n  };\n  const signal = input.signal;\n  if (\n    signal !== undefined &&\n    (signal === null ||\n      typeof signal !== 'object' ||\n      typeof signal.aborted !== 'boolean' ||\n      typeof signal.addEventListener !== 'function' ||\n      typeof signal.removeEventListener !== 'function')\n  ) {\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  }\n  const { limits } = normalizeCoreOptions({\n    ...(input.limits === undefined ? {} : { limits: input.limits }),\n  });\n  if (input.deadline !== undefined && (!Number.isSafeInteger(input.deadline) || input.deadline < 0))\n    throw new CoreOperationException({\n      code: 'INVALID_ARGUMENT',\n      operation: 'create-project-inspection',\n    });\n  if (signal?.aborted === true) throw aborted(signal.reason);\n  if (isInspectionActive)\n    throw new CoreOperationException({\n      code: 'INSPECTION_BUSY',\n      operation: 'create-project-inspection',\n    });\n  if (limits.maxRetainedBytes <= NODE_INSPECTION_TRANSPORT_BYTES)\n    throw new CoreOperationException({\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n      operation: 'create-project-inspection',\n      limit: 'maxRetainedBytes',\n      limitMaximum: limits.maxRetainedBytes,\n      observedUsage: NODE_INSPECTION_TRANSPORT_BYTES,\n      nextAction: 'reduce-input-or-increase-limit',\n    });\n  const deadline = Math.min(Date.now() + NODE_INSPECTION_LIFETIME_MS, input.deadline ?? Infinity);\n  if (deadline <= Date.now())\n    throw new CoreOperationException({\n      code: 'INSPECTION_TIMEOUT',\n      operation: 'create-project-inspection',\n    });\n  isInspectionActive = true;\n  const controller = new AbortController();\n  const attemptId = randomBytes(16).toString('hex');\n  const prepared = createCompletion<INodeInspectionMetadata>();\n  let pendingPage: ReturnType<typeof createCompletion<IProjectInspectionPageResult>> | undefined;\n  let pageRequestId = 0;\n  let lastReaderRequestId = -1;\n  let hasAcknowledgedHeap = false;\n  let heapMaximum: number | undefined;\n  let hasPrepared = false;\n  let isClosing = false;\n  let failure: { cause: Error } | undefined;\n  let cleanupPromise: Promise<void> | undefined;\n  const readerWork = new Set<Promise<unknown>>();\n  const relayWork = new Set<Promise<void>>();\n  const child = (() => {\n    try {\n      return fork(fileURLToPath(import.meta.resolve('#moldea-core-runner')), [], {\n        execPath: process.execPath,\n        execArgv: [],\n        env: createInspectionEnvironment(),\n        serialization: 'advanced',\n        stdio: ['ignore', 'ignore', 'pipe', 'ipc'],\n      });\n    } catch (cause) {\n      isInspectionActive = false;\n      throw createInspectionProcessFailure(cause);\n    }\n  })();\n  const send = createInspectionSender((frame, callback) => {\n    if (!child.connected) throw createInspectionProcessFailure();\n    child.send(frame, callback);\n  });\n  const supervision = superviseInspectionChild(child, () => {\n    void send({ attemptId, kind: 'dispose' }).catch(() => {\n      child.kill('SIGKILL');\n    });\n  });\n\n  /** Keeps admission until child closure and every real reader promise has settled. */\n  const cleanup = (): Promise<void> => {\n    cleanupPromise ??= (async () => {\n      isClosing = true;\n      controller.abort(failure?.cause);\n      supervision.terminate();\n      await supervision.closed;\n      await Promise.allSettled([...readerWork, ...relayWork]);\n      sources = undefined;\n      clearTimeout(timer);\n      if (failure === undefined && Date.now() >= deadline) {\n        fail(\n          new CoreOperationException({\n            code: 'INSPECTION_TIMEOUT',\n            operation: 'create-project-inspection',\n          }),\n        );\n      }\n      signal?.removeEventListener('abort', handleAbort);\n      child.removeAllListeners('message');\n      child.removeAllListeners('error');\n      child.stderr?.removeAllListeners('data');\n      isInspectionActive = false;\n    })();\n    return cleanupPromise;\n  };\n  const fail = (cause: unknown): void => {\n    if (failure === undefined)\n      failure = { cause: cause instanceof Error ? cause : createInspectionProcessFailure(cause) };\n    prepared.reject(failure.cause);\n    pendingPage?.reject(failure.cause);\n    void cleanup();\n  };\n  const getFailureCause = (): Error | undefined => failure?.cause;\n  const handleAbort = (): void => {\n    fail(aborted(signal?.reason));\n  };\n  const timer = setTimeout(\n    () => {\n      fail(\n        new CoreOperationException({\n          code: 'INSPECTION_TIMEOUT',\n          operation: 'create-project-inspection',\n        }),\n      );\n    },\n    Math.max(1, deadline - Date.now()),\n  );\n  signal?.addEventListener('abort', handleAbort, { once: true });\n  // Re-read through a function because cancellation can change during listener registration.\n  const isCallerAborted = (): boolean => signal?.aborted === true;\n  if (isCallerAborted()) handleAbort();\n  child.once('error', (cause: unknown) => {\n    fail(createInspectionProcessFailure(cause));\n  });\n  void supervision.closed.then(() => {\n    if (!isClosing) fail(createInspectionProcessFailure());\n  });\n  let stderrBytes = 0;\n  child.stderr?.on('data', (chunk: Buffer) => {\n    stderrBytes += chunk.byteLength;\n    if (stderrBytes > NODE_INSPECTION_STDIO_BYTES) fail(createInspectionProcessFailure());\n  });\n  child.on('message', (frame: unknown) => {\n    if (isClosing) return;\n    try {\n      const message = decodeInspectionMessage(frame);\n      if (message.attemptId !== attemptId) throw createInspectionProcessFailure();\n      if (message.kind === 'ready') {\n        if (hasAcknowledgedHeap) throw createInspectionProcessFailure();\n        heapMaximum = message.maxAnalysisHeapBytes;\n        hasAcknowledgedHeap = true;\n        void send({ attemptId, kind: 'run' }).catch(fail);\n      } else if (message.kind === 'prepared') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.inspection.maxAnalysisHeapBytes !== heapMaximum ||\n          message.inspection.source.id !== snapshot.id ||\n          message.inspection.source.sourceKind !== snapshot.sourceKind\n        )\n          throw createInspectionProcessFailure();\n        hasPrepared = true;\n        prepared.resolve(freezeRecursively(message.inspection));\n      } else if (message.kind === 'reader-request') {\n        if (\n          !hasAcknowledgedHeap ||\n          hasPrepared ||\n          message.requestId !== lastReaderRequestId + 1 ||\n          readerWork.size >= NODE_INSPECTION_MAX_REQUESTS\n        )\n          throw createInspectionProcessFailure();\n        lastReaderRequestId = message.requestId;\n        if (sources === undefined) throw createInspectionProcessFailure();\n        const work = executeRepositoryRpc(sources, message.request, controller.signal);\n        readerWork.add(work);\n        const relay = (async () => {\n          try {\n            const result = await work;\n            readerWork.delete(work);\n            if (!isClosing)\n              await send({\n                attemptId,\n                kind: 'reader-response',\n                requestId: message.requestId,\n                result,\n              });\n          } catch (cause) {\n            // Core decides whether absence or a reader resource refusal is recoverable at this check.\n            if (\n              cause instanceof RepositorySourceException &&\n              ['ENTRY_NOT_FOUND', 'ENTRY_NOT_FILE', 'RESOURCE_LIMIT_EXCEEDED'].includes(cause.code)\n            ) {\n              try {\n                if (!isClosing)\n                  await send({\n                    attemptId,\n                    kind: 'reader-failure',\n                    requestId: message.requestId,\n                    failure: serializeInspectionFailure(cause),\n                  });\n              } catch (transportFailure) {\n                fail(transportFailure);\n              }\n            } else fail(cause);\n          } finally {\n            readerWork.delete(work);\n          }\n        })();\n        relayWork.add(relay);\n        void relay.finally(() => relayWork.delete(relay));\n      } else if (message.kind === 'page') {\n        if (!hasPrepared || pendingPage === undefined || message.requestId !== pageRequestId)\n          throw createInspectionProcessFailure();\n        const completion = pendingPage;\n        pendingPage = undefined;\n        completion.resolve(freezeRecursively(message.result));\n      } else if (message.kind === 'failure') {\n        if (\n          message.failure.options['nextAction'] === 'review-inspection-capacity' &&\n          (heapMaximum === undefined || message.failure.options['limitMaximum'] !== heapMaximum)\n        )\n          throw createInspectionProcessFailure();\n        fail(deserializeInspectionFailure(message.failure));\n      } else throw createInspectionProcessFailure();\n    } catch (cause) {\n      fail(cause);\n    }\n  });\n  try {\n    await send({\n      attemptId,\n      kind: 'start',\n      snapshot,\n      instructions,\n      limits,\n      deadline,\n    });\n    const metadata = await prepared.promise;\n    if (Date.now() >= deadline)\n      throw new CoreOperationException({\n        code: 'INSPECTION_TIMEOUT',\n        operation: 'create-project-inspection',\n      });\n    return Object.freeze({\n      ...metadata,\n      readPage: async (pageInput): Promise<IProjectInspectionPageResult> => {\n        if (failure !== undefined || isClosing) throw failure?.cause ?? aborted();\n        if (\n          pendingPage !== undefined ||\n          pageInput === null ||\n          typeof pageInput !== 'object' ||\n          Reflect.ownKeys(pageInput).some(\n            (key) => key !== 'cursor' && key !== 'maxItems' && key !== 'view',\n          ) ||\n          !Number.isSafeInteger(pageInput.maxItems) ||\n          pageInput.maxItems < 1 ||\n          pageInput.maxItems > limits.maxEntries ||\n          !['all', 'diagnostics', 'coverage', 'metadata'].includes(pageInput.view) ||\n          (pageInput.cursor !== undefined && typeof pageInput.cursor !== 'string')\n        )\n          throw new CoreOperationException({\n            code: 'INVALID_ARGUMENT',\n            operation: 'create-project-inspection',\n          });\n        const completion = createCompletion<IProjectInspectionPageResult>();\n        pendingPage = completion;\n        pageRequestId++;\n        try {\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          await send({\n            attemptId,\n            kind: 'read-page',\n            requestId: pageRequestId,\n            input: {\n              maxItems: pageInput.maxItems,\n              view: pageInput.view,\n              ...(pageInput.cursor === undefined ? {} : { cursor: pageInput.cursor }),\n            },\n          });\n          const result = await completion.promise;\n          if (Date.now() >= deadline)\n            throw new CoreOperationException({\n              code: 'INSPECTION_TIMEOUT',\n              operation: 'create-project-inspection',\n            });\n          return result;\n        } catch (cause) {\n          fail(cause);\n          await cleanup();\n          throw getFailureCause() ?? createInspectionProcessFailure(cause);\n        } finally {\n          if (pendingPage === completion) pendingPage = undefined;\n        }\n      },\n      dispose: async (): Promise<void> => {\n        pendingPage?.reject(failure?.cause ?? aborted());\n        await cleanup();\n        const cause = getFailureCause();\n        if (cause !== undefined) throw cause;\n      },\n    } satisfies INodeProjectInspection);\n  } catch (cause) {\n    fail(cause);\n    await cleanup();\n    throw getFailureCause() ?? createInspectionProcessFailure(cause);\n  }\n};\n"],"mappings":"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"}

package/dist/project-validation/index.d.ts

@@ -8,7 +8,7 @@ export interface IProjectValidationState {
 }
 /**
  * Inspects one coherent repository snapshot through universal file and export validation.
- * @param input The untrusted source-neutral reader and optional cancellation signal.
+ * @param input The untrusted source-neutral reader, optional instruction reader, and signal.
  * @param options The immutable Core configuration snapshot.
  * @returns A promise resolving to the frozen all-or-nothing project inspection result.
  * @throws

package/dist/project-validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAwEpG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,uBAAuB,CAgCjC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAAwD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project-validation/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AA+EpG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,kCAAkC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,uBAAuB,CAiCjC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,uBAAuB,EAC9B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,wBAAwB,CAAwD,CAAC"}

package/dist/repository-inspection-session/index.d.ts

@@ -1,5 +1,6 @@
-import { type IRepositoryEntry, type IRepositoryOperationOptions, type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
+import { type IRepositoryEntry, type IRepositoryLinkSource, type IRepositoryOperationOptions, type IRepositoryPath, type IRepositoryReader } from '@moldea.ai/repository';
 import type { ICoreResourceLimits } from '../contracts/index.js';
+import { type IRetainedSource } from '../retained-memory/index.js';
 export interface IRepositoryInspectionListOptions extends IRepositoryOperationOptions {
     readonly prefix?: IRepositoryPath;
 }
@@ -8,7 +9,11 @@ export interface IRepositoryInspectionReader {
     iterateEntries(options?: IRepositoryInspectionListOptions): AsyncIterable<IRepositoryEntry>;
     readCompleteFile(path: IRepositoryPath, options?: IRepositoryOperationOptions): Promise<Uint8Array>;
 }
+export interface IRepositoryInstructionView extends IRepositoryLinkSource {
+    readSourceFile(path: IRepositoryPath): Promise<IRetainedSource>;
+}
 export interface IRepositoryInspectionSession {
+    readonly instructions: IRepositoryInstructionView;
     readonly reader: IRepositoryInspectionReader;
     /** Returns deterministic logical resource usage for the current validation state. */
     getResourceUsage(): IRepositoryInspectionResourceUsage;
@@ -30,9 +35,10 @@ export interface IRepositoryInspectionResourceUsage {
  * @param repository The source-neutral reader bound to one coherent snapshot.
  * @param limits The immutable resource limits for the inspection.
  * @param signal Optional cancellation shared by every inspection operation.
+ * @param instructions Optional reader of the four instruction paths, used only by the instruction view.
  * @returns A session that pages source metadata and range-reads bounded canonical files.
  * @throws
  * - ABORTED: The Core operation was aborted.
  */
-export declare const createRepositoryInspectionSession: (repository: IRepositoryReader, limits: ICoreResourceLimits, signal?: AbortSignal) => IRepositoryInspectionSession;
+export declare const createRepositoryInspectionSession: (repository: IRepositoryReader, limits: ICoreResourceLimits, signal?: AbortSignal, instructions?: IRepositoryReader) => IRepositoryInspectionSession;
 //# sourceMappingURL=index.d.ts.map

package/dist/repository-inspection-session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-inspection-session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAcjE,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAGD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CACN,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC5F,gBAAgB,CACd,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE7C,qFAAqF;IACrF,gBAAgB,IAAI,kCAAkC,CAAC;IAEvD;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAmGD;;;;;;;;GAQG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,KACnB,4BAgYF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository-inspection-session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,gBAAgB,EAGrB,KAAK,qBAAqB,EAE1B,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAmB3F,MAAM,WAAW,gCAAiC,SAAQ,2BAA2B;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAGD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CACN,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC,cAAc,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC5F,gBAAgB,CACd,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAOD,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACvE,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjE;AAGD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE7C,qFAAqF;IACrF,gBAAgB,IAAI,kCAAkC,CAAC;IAEvD;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;CACxB;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AA4GD;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,iBAAiB,EAC7B,QAAQ,mBAAmB,EAC3B,SAAS,WAAW,EACpB,eAAe,iBAAiB,KAC/B,4BAscF,CAAC"}

package/dist/retained-memory/index.d.ts

@@ -1,13 +1,14 @@
 import type { IRepositoryPath } from '@moldea.ai/repository';
 import type { IRepositoryInspectionReader } from '../repository-inspection-session/index.js';
+export interface IRetainedSource {
+    bytes: Uint8Array;
+    release: () => void;
+}
 export interface IRetainedMemory {
     reserve(bytes: number): void;
     tryReserve(bytes: number): boolean;
     release(bytes: number): void;
-    readSourceFile(path: IRepositoryPath): Promise<{
-        bytes: Uint8Array;
-        release: () => void;
-    }>;
+    readSourceFile(path: IRepositoryPath): Promise<IRetainedSource>;
 }
 /** Registers the sole memory owner for one internal reader. */
 export declare const registerRetainedMemory: (reader: IRepositoryInspectionReader, ledger: IRetainedMemory) => void;

package/dist/retained-memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retained-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAG7F,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;CAC5F;AAID,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,GACjC,QAAQ,2BAA2B,EACnC,QAAQ,eAAe,KACtB,IAGF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAAI,QAAQ,2BAA2B,KAAG,eAKvE,CAAC;AAEF,4GAA4G;AAC5G,eAAO,MAAM,6BAA6B,GACxC,QAAQ,2BAA2B,EACnC,OAAO,MAAM,KACZ,IAEF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retained-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAG7F,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAGD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjE;AAID,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,GACjC,QAAQ,2BAA2B,EACnC,QAAQ,eAAe,KACtB,IAGF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAAI,QAAQ,2BAA2B,KAAG,eAKvE,CAAC;AAEF,4GAA4G;AAC5G,eAAO,MAAM,6BAA6B,GACxC,QAAQ,2BAA2B,EACnC,OAAO,MAAM,KACZ,IAEF,CAAC"}

package/dist/scope.js

@@ -1,5 +1,5 @@
-import { n as normalizeCoreOptions, t as createCoreOperationOptionsSnapshot } from "./chunks/options-AMqX7rx_.js";
-import { t as matchManifestScope$1 } from "./chunks/scope-e3-w9N7D.js";
+import { n as normalizeCoreOptions, t as createCoreOperationOptionsSnapshot } from "./chunks/options-l3kVfA-K.js";
+import { t as matchManifestScope$1 } from "./chunks/scope-D9BYchNI.js";
 //#region src/scope/scope.ts
 /**
 * Matches only the supplied manifest and changed paths, without inspecting source files.

package/dist/universal-project-inspection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/universal-project-inspection/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAQnE,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAS9F,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,kCAAkC,EAC3C,SAAS,oBAAoB,KAC5B,OAAO,CAAC,iCAAiC,CAgL3C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/universal-project-inspection/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAQnE,OAAO,EAAsC,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAS9F,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAGD,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,kCAAkC,EAC3C,SAAS,oBAAoB,KAC5B,OAAO,CAAC,iCAAiC,CAuL3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moldea.ai/core",
-  "version": "7.0.4",
+  "version": "8.0.0",
   "description": "Source-neutral, deterministic interpretation and indexing of moldea repositories.",
   "homepage": "https://github.com/moldea-ai/packages/tree/main/projects/core#readme",
   "bugs": {
@@ -46,7 +46,7 @@
   },
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@moldea.ai/repository": "^2.0.0",
+    "@moldea.ai/repository": "^3.0.0",
     "error-message-utils": "1.2.11",
     "yaml": "2.9.0",
     "typescript": "6.0.3"