@neat.is/core 0.10.5 → 0.10.6-dev.20261007

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { MultiDirectedGraph } from 'graphology';
-import { GraphNode, GraphEdge, EdgeEvidence, SpanAttributes, EdgeTypeValue, StaleEvent, ErrorEvent, BlastRadiusResult, RootCauseResult, RegistryEntry, RegistryStatus, RegistryFile } from '@neat.is/types';
+import { GraphNode, GraphEdge, EdgeEvidence, ErrorEvent, SpanAttributes, EdgeTypeValue, StaleEvent, BlastRadiusResult, RootCauseResult, RegistryEntry, RegistryStatus, RegistryFile } from '@neat.is/types';
 export { StaleEvent } from '@neat.is/types';
 import { FastifyInstance } from 'fastify';
 
@@ -46,6 +46,7 @@ interface ExtractOptions {
     project?: string;
     errorsPath?: string;
     source?: string;
+    announce?: boolean;
 }
 declare function extractFromDirectory(graph: NeatGraph, scanPath: string, opts?: ExtractOptions): Promise<ExtractResult>;
 
@@ -150,6 +151,43 @@ interface RepoSyncRequestResult {
     lastPass?: RepoSyncPassSummary;
 }
 
+interface PrVerdictRequest {
+    owner: string;
+    name: string;
+    baseSha: string;
+    headSha: string;
+    /** `https://x-access-token:<token>@github.com/<owner>/<name>.git`. Used for the two clones, then gone. */
+    cloneUrl: string;
+    /** Repo-relative paths the PR changes, from the caller. Absent → the two trees are compared. */
+    changedFiles?: string[];
+    tone?: 'loud' | 'professional';
+}
+interface PrVerdictResult {
+    marker: string;
+    body: string;
+    base: {
+        sha: string;
+        nodes: number;
+        edges: number;
+    };
+    head: {
+        sha: string;
+        nodes: number;
+        edges: number;
+    };
+    changedFiles: number;
+    observedBreaks: number;
+    divergences: number;
+    durationMs: number;
+}
+interface PrVerdictContext {
+    /** The project's live graph. Read for OBSERVED; never written. */
+    liveGraph: NeatGraph;
+    /** The project's recorded incidents, for symbol-grain divergences — the same read `/graph/divergences` does. */
+    incidents?: ErrorEvent[];
+}
+type PrVerdictRunner = (req: PrVerdictRequest, ctx: PrVerdictContext) => Promise<PrVerdictResult>;
+
 /**
  * A connector implements exactly one method. Everything downstream of
  * `poll()` — resolving a static call site, minting the OBSERVED edge — is
@@ -315,6 +353,9 @@ interface BuildApiOptions {
     staleEventsPath?: string;
     searchIndex?: SearchIndex;
     authToken?: string;
+    incidentStreamToken?: string;
+    /** Set only after the hosted substrate restores the complete errors ledger before boot. */
+    incidentReplayDurable?: boolean;
     trustProxy?: boolean;
     publicRead?: boolean;
     otlpReceiver?: () => FastifyInstance | undefined;
@@ -332,6 +373,7 @@ interface BuildApiOptions {
     };
     connectorsHome?: string;
     repoSync?: (project: string) => (() => RepoSyncRequestResult) | undefined;
+    prVerdict?: PrVerdictRunner;
     runPoll?: typeof runConnectorPoll;
 }
 declare function buildApi(opts: BuildApiOptions): Promise<FastifyInstance>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { MultiDirectedGraph } from 'graphology';
-import { GraphNode, GraphEdge, EdgeEvidence, SpanAttributes, EdgeTypeValue, StaleEvent, ErrorEvent, BlastRadiusResult, RootCauseResult, RegistryEntry, RegistryStatus, RegistryFile } from '@neat.is/types';
+import { GraphNode, GraphEdge, EdgeEvidence, ErrorEvent, SpanAttributes, EdgeTypeValue, StaleEvent, BlastRadiusResult, RootCauseResult, RegistryEntry, RegistryStatus, RegistryFile } from '@neat.is/types';
 export { StaleEvent } from '@neat.is/types';
 import { FastifyInstance } from 'fastify';
 
@@ -46,6 +46,7 @@ interface ExtractOptions {
     project?: string;
     errorsPath?: string;
     source?: string;
+    announce?: boolean;
 }
 declare function extractFromDirectory(graph: NeatGraph, scanPath: string, opts?: ExtractOptions): Promise<ExtractResult>;
 
@@ -150,6 +151,43 @@ interface RepoSyncRequestResult {
     lastPass?: RepoSyncPassSummary;
 }
 
+interface PrVerdictRequest {
+    owner: string;
+    name: string;
+    baseSha: string;
+    headSha: string;
+    /** `https://x-access-token:<token>@github.com/<owner>/<name>.git`. Used for the two clones, then gone. */
+    cloneUrl: string;
+    /** Repo-relative paths the PR changes, from the caller. Absent → the two trees are compared. */
+    changedFiles?: string[];
+    tone?: 'loud' | 'professional';
+}
+interface PrVerdictResult {
+    marker: string;
+    body: string;
+    base: {
+        sha: string;
+        nodes: number;
+        edges: number;
+    };
+    head: {
+        sha: string;
+        nodes: number;
+        edges: number;
+    };
+    changedFiles: number;
+    observedBreaks: number;
+    divergences: number;
+    durationMs: number;
+}
+interface PrVerdictContext {
+    /** The project's live graph. Read for OBSERVED; never written. */
+    liveGraph: NeatGraph;
+    /** The project's recorded incidents, for symbol-grain divergences — the same read `/graph/divergences` does. */
+    incidents?: ErrorEvent[];
+}
+type PrVerdictRunner = (req: PrVerdictRequest, ctx: PrVerdictContext) => Promise<PrVerdictResult>;
+
 /**
  * A connector implements exactly one method. Everything downstream of
  * `poll()` — resolving a static call site, minting the OBSERVED edge — is
@@ -315,6 +353,9 @@ interface BuildApiOptions {
     staleEventsPath?: string;
     searchIndex?: SearchIndex;
     authToken?: string;
+    incidentStreamToken?: string;
+    /** Set only after the hosted substrate restores the complete errors ledger before boot. */
+    incidentReplayDurable?: boolean;
     trustProxy?: boolean;
     publicRead?: boolean;
     otlpReceiver?: () => FastifyInstance | undefined;
@@ -332,6 +373,7 @@ interface BuildApiOptions {
     };
     connectorsHome?: string;
     repoSync?: (project: string) => (() => RepoSyncRequestResult) | undefined;
+    prVerdict?: PrVerdictRunner;
     runPoll?: typeof runConnectorPoll;
 }
 declare function buildApi(opts: BuildApiOptions): Promise<FastifyInstance>;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   routeSpanToProject,
   startDaemon
-} from "./chunk-Q2SL2SVH.js";
+} from "./chunk-VL7ANDPI.js";
 import {
   ProjectNameCollisionError,
   addProject,
@@ -37,7 +37,7 @@ import {
   thresholdForEdgeType,
   touchLastSeen,
   writeAtomically
-} from "./chunk-DVCGDMTZ.js";
+} from "./chunk-KTJK2PAH.js";
 import {
   startOtelGrpcReceiver
 } from "./chunk-LXQCL4MP.js";