gitnexus 1.6.11-rc.33 → 1.6.11-rc.35

package/dist/_shared/graph/types.d.ts

@@ -5,7 +5,22 @@
  * Do NOT add Node.js-specific or browser-specific imports here.
  */
 import { SupportedLanguages } from '../languages.js';
-export type NodeLabel = 'Project' | 'Package' | 'Module' | 'Folder' | 'File' | 'Class' | 'Function' | 'Method' | 'Variable' | 'Interface' | 'Enum' | 'Decorator' | 'Import' | 'Type' | 'CodeElement' | 'Community' | 'Process' | 'Struct' | 'Macro' | 'Typedef' | 'Union' | 'Namespace' | 'Trait' | 'Impl' | 'TypeAlias' | 'Const' | 'Static' | 'Property' | 'Record' | 'Delegate' | 'Annotation' | 'Constructor' | 'Template' | 'Section' | 'Route' | 'Tool' | 'BasicBlock';
+export type NodeLabel = 'Project' | 'Package' | 'Module' | 'Folder' | 'File' | 'Class' | 'Function' | 'Method' | 'Variable' | 'Interface' | 'Enum' | 'Decorator' | 'Import' | 'Type' | 'CodeElement' | 'Community' | 'Process' | 'Struct' | 'Macro' | 'Typedef' | 'Union' | 'Namespace' | 'Trait' | 'Impl' | 'TypeAlias' | 'Const' | 'Static' | 'Property' | 'Record' | 'Delegate' | 'Annotation' | 'Constructor' | 'Template' | 'Section' | 'Route' | 'Tool'
+/**
+ * A message-broker destination — a Kafka topic, a Rabbit exchange/routing
+ * key, a JMS queue, a Spring Cloud Stream binding. The framework overlay for
+ * ASYNCHRONOUS entry/exit points, symmetric to `Route` for HTTP.
+ *
+ * Identity is `(broker, resolved ADDRESS)`, so a publisher and a consumer of
+ * the same address on the same broker land on one node and the connection is
+ * a single hop — while a Kafka topic and a Rabbit queue that share a name
+ * stay two nodes, the same way `GET /x` and `POST /x` are two Routes. A
+ * destination whose address could NOT be resolved is keyed by its source
+ * location instead and carries no `address` property at all. See
+ * `pipeline-phases/spring-destinations.ts` for why an unresolved spelling may
+ * not key a node, and `ingestion/destination-key.ts` for why the broker may.
+ */
+ | 'Destination' | 'BasicBlock';
 export type NodeProperties = {
     name: string;
     filePath: string;
@@ -54,13 +69,43 @@ export type NodeProperties = {
     runtimeSource?: string;
     /** Runtime result such as runtime-confirmed or handler-conflict. */
     runtimeStatus?: string;
+    /** The RESOLVED broker address. Together with `broker` it is the key a
+     *  cross-repository pass joins on. Present only when the address resolved:
+     *  absent is the load-bearing state, because an absent property cannot match
+     *  another absent property. */
+    address?: string;
+    /** Broker family the syntax attests to (`kafka`, `rabbit`, `jms`, …). Part
+     *  of the node's identity alongside `address`, not a label on it. */
+    broker?: string;
+    /** How the address was arrived at (`literal`, `constant`) when it resolved,
+     *  or the named reason it did not. */
+    resolution?: string;
+    /** Configuration key named by an unresolvable `${…}` placeholder. The key
+     *  only — configuration VALUES are deliberately absent from this graph. */
+    configKey?: string;
+    /** The `${key:default}` default text. Not an address: configuration can
+     *  override it and the graph cannot see whether it did. */
+    configDefault?: string;
     text?: string;
     /** BasicBlock: space-joined leaf callee names invoked in the block — the
      *  statement-precise inter-procedural reach substrate for impact mode. */
     callees?: string;
     [key: string]: unknown;
 };
-export type RelationshipType = 'CONTAINS' | 'CALLS' | 'INHERITS' | 'METHOD_OVERRIDES' | 'METHOD_IMPLEMENTS' | 'IMPORTS' | 'USES' | 'DEFINES' | 'DECORATES' | 'IMPLEMENTS' | 'EXTENDS' | 'HAS_METHOD' | 'HAS_PROPERTY' | 'ACCESSES' | 'MEMBER_OF' | 'STEP_IN_PROCESS' | 'HANDLES_ROUTE' | 'FETCHES' | 'HANDLES_TOOL' | 'ENTRY_POINT_OF' | 'WRAPS' | 'QUERIES'
+export type RelationshipType = 'CONTAINS' | 'CALLS' | 'INHERITS' | 'METHOD_OVERRIDES' | 'METHOD_IMPLEMENTS' | 'IMPORTS' | 'USES' | 'DEFINES' | 'DECORATES' | 'IMPLEMENTS' | 'EXTENDS' | 'HAS_METHOD' | 'HAS_PROPERTY' | 'ACCESSES' | 'MEMBER_OF' | 'STEP_IN_PROCESS' | 'HANDLES_ROUTE'
+/** Outbound async messaging. Source = the callable that performs the publish
+ *  (or its File); target = the `Destination` it publishes to. Emitted by
+ *  `pipeline-phases/spring-destinations.ts` from Spring messaging-template
+ *  calls (`kafkaTemplate.send(...)`, `rabbitTemplate.convertAndSend(...)`).
+ *  One edge per address: a publish that names two destinations yields two
+ *  edges, and `reason` records which argument each came from. */
+ | 'PUBLISHES_TO'
+/** Inbound async messaging — the mirror of `PUBLISHES_TO`. Source = the
+ *  annotated handler callable (or its File); target = the `Destination` it
+ *  subscribes to. Emitted from `@KafkaListener` / `@RabbitListener` /
+ *  `@JmsListener` and their siblings. Together the two types make
+ *  "who else reads what this service writes" a two-hop traversal. */
+ | 'CONSUMES_FROM' | 'FETCHES' | 'HANDLES_TOOL' | 'ENTRY_POINT_OF' | 'WRAPS' | 'QUERIES'
 /** Dependency-injection edge: a consumer class receives a likely provider
  *  through constructor, field, method, or collection injection. A
  *  per-language resolver identifies the site and provider metadata; the

package/dist/_shared/graph/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,UAAU,GACV,QAAQ,GACR,UAAU,GACV,WAAW,GACX,MAAM,GACN,WAAW,GACX,QAAQ,GACR,MAAM,GACN,aAAa,GACb,WAAW,GACX,SAAS,GAET,QAAQ,GACR,OAAO,GACP,SAAS,GACT,OAAO,GACP,WAAW,GACX,OAAO,GACP,MAAM,GACN,WAAW,GACX,OAAO,GACP,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,aAAa,GACb,UAAU,GACV,SAAS,GACT,OAAO,GACP,MAAM;AACR;;;;;;;;;;;;;GAaG;GACD,aAAa,GAGb,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAEjC,WAAW,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;mCAG+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;yEACqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;0CACsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;+EAC2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;+DAC2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;8EAC0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,OAAO,GACP,UAAU,GACV,kBAAkB,GAClB,mBAAmB,GACnB,SAAS,GACT,MAAM,GACN,SAAS,GACT,WAAW,GACX,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,cAAc,GACd,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,eAAe;AACjB;;;;;iEAKiE;GAC/D,cAAc;AAChB;;;;qEAIqE;GACnE,eAAe,GACf,SAAS,GACT,cAAc,GACd,gBAAgB,GAChB,OAAO,GACP,SAAS;AACX;;;;;;;;;;;0EAW0E;GACxE,SAAS;AACX;;;;;qBAKqB;GACnB,gBAAgB;AAClB;;;;+BAI+B;GAC7B,UAAU;AACZ;;;;6EAI6E;GAC3E,YAAY;AACd;;;;;;qEAMqE;GACnE,qBAAqB;AACvB;;;;;;gEAMgE;GAC9D,aAAa;AAOf,6EAA6E;GAC3E,KAAK;AACP;;;;qCAIqC;GACnC,cAAc;AAChB,qDAAqD;GACnD,SAAS;AACX,6CAA6C;GAC3C,WAAW;AACb;8EAC8E;GAC5E,YAAY;AACd;;;;qEAIqE;GACnE,KAAK;AACP;;;;;;0EAM0E;GACxE,eAAe;AACjB;;;;;;;;;;;oCAWoC;GAClC,cAAc,CAAC;AAEnB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,SAAS;QAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;CACL"}

package/dist/_shared/lbug/schema-constants.d.ts

@@ -7,10 +7,10 @@
  * Full DDL schemas remain in each package's own schema.ts because
  * the CLI uses native LadybugDB and the web uses WASM.
  */
-export declare const NODE_TABLES: readonly ['File', 'Folder', 'Function', 'Class', 'Interface', 'Method', 'CodeElement', 'Community', 'Process', 'Section', 'Struct', 'Enum', 'Macro', 'Typedef', 'Union', 'Namespace', 'Trait', 'Impl', 'TypeAlias', 'Const', 'Static', 'Variable', 'Property', 'Record', 'Delegate', 'Annotation', 'Constructor', 'Template', 'Module', 'Route', 'Tool', 'BasicBlock'];
+export declare const NODE_TABLES: readonly ['File', 'Folder', 'Function', 'Class', 'Interface', 'Method', 'CodeElement', 'Community', 'Process', 'Section', 'Struct', 'Enum', 'Macro', 'Typedef', 'Union', 'Namespace', 'Trait', 'Impl', 'TypeAlias', 'Const', 'Static', 'Variable', 'Property', 'Record', 'Delegate', 'Annotation', 'Constructor', 'Template', 'Module', 'Route', 'Tool', 'Destination', 'BasicBlock'];
 export type NodeTableName = (typeof NODE_TABLES)[number];
 export declare const REL_TABLE_NAME = "CodeRelation";
-export declare const REL_TYPES: readonly ['CONTAINS', 'DEFINES', 'IMPORTS', 'CALLS', 'EXTENDS', 'IMPLEMENTS', 'HAS_METHOD', 'HAS_PROPERTY', 'ACCESSES', 'METHOD_OVERRIDES', 'OVERRIDES', 'METHOD_IMPLEMENTS', 'MEMBER_OF', 'STEP_IN_PROCESS', 'HANDLES_ROUTE', 'FETCHES', 'HANDLES_TOOL', 'ENTRY_POINT_OF', 'WRAPS', 'QUERIES', 'INJECTS', 'CONDITIONAL_ON', 'DECLARES', 'ADVISED_BY', 'CFG', 'REACHING_DEF', 'TAINTED', 'SANITIZES', 'TAINT_PATH', 'CDG', 'POST_DOMINATE'];
+export declare const REL_TYPES: readonly ['CONTAINS', 'DEFINES', 'IMPORTS', 'CALLS', 'EXTENDS', 'IMPLEMENTS', 'HAS_METHOD', 'HAS_PROPERTY', 'ACCESSES', 'METHOD_OVERRIDES', 'OVERRIDES', 'METHOD_IMPLEMENTS', 'MEMBER_OF', 'STEP_IN_PROCESS', 'HANDLES_ROUTE', 'PUBLISHES_TO', 'CONSUMES_FROM', 'FETCHES', 'HANDLES_TOOL', 'ENTRY_POINT_OF', 'WRAPS', 'QUERIES', 'INJECTS', 'CONDITIONAL_ON', 'DECLARES', 'ADVISED_BY', 'CFG', 'REACHING_DEF', 'TAINTED', 'SANITIZES', 'TAINT_PATH', 'CDG', 'POST_DOMINATE'];
 export type RelType = (typeof REL_TYPES)[number];
 export declare const EMBEDDING_TABLE_NAME = "CodeEmbedding";
 //# sourceMappingURL=schema-constants.d.ts.map

package/dist/_shared/lbug/schema-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-constants.d.ts","sourceRoot":"","sources":["../../src/lbug/schema-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,WAAW,YACtB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,SAAS,EACT,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,WAAW,EACX,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,QAAQ,EACR,OAAO,EACP,MAAM,EAEN,YAAY,CACJ,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,eAAO,MAAM,SAAS,YACpB,UAAU,EACV,SAAS,EACT,SAAS,EACT,OAAO,EACP,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,YAAY,EAIZ,KAAK,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,YAAY,EAKZ,KAAK,EACL,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC"}
+{"version":3,"file":"schema-constants.d.ts","sourceRoot":"","sources":["../../src/lbug/schema-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,WAAW,YACtB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,SAAS,EACT,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,WAAW,EACX,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,QAAQ,EACR,OAAO,EACP,MAAM,EAEN,aAAa,EAEb,YAAY,CACJ,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,eAAO,MAAM,SAAS,YACpB,UAAU,EACV,SAAS,EACT,SAAS,EACT,OAAO,EACP,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,YAAY,EAIZ,KAAK,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,YAAY,EAKZ,KAAK,EACL,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC"}

package/dist/_shared/lbug/schema-constants.js

@@ -39,6 +39,8 @@ export const NODE_TABLES = [
     'Module',
     'Route',
     'Tool',
+    // Async messaging overlay — the broker-side counterpart of `Route`.
+    'Destination',
     // Taint/PDG substrate (issue #2080) — inert until M1 (#2081) emits blocks.
     'BasicBlock',
 ];
@@ -59,6 +61,8 @@ export const REL_TYPES = [
     'MEMBER_OF',
     'STEP_IN_PROCESS',
     'HANDLES_ROUTE',
+    'PUBLISHES_TO',
+    'CONSUMES_FROM',
     'FETCHES',
     'HANDLES_TOOL',
     'ENTRY_POINT_OF',

package/dist/_shared/lbug/schema-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-constants.js","sourceRoot":"","sources":["../../src/lbug/schema-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,QAAQ;IACR,UAAU;IACV,OAAO;IACP,WAAW;IACX,QAAQ;IACR,aAAa;IACb,WAAW;IACX,SAAS;IACT,SAAS;IACT,QAAQ;IACR,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,WAAW;IACX,OAAO;IACP,MAAM;IACN,WAAW;IACX,OAAO;IACP,QAAQ;IACR,UAAU;IACV,UAAU;IACV,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,aAAa;IACb,UAAU;IACV,QAAQ;IACR,OAAO;IACP,MAAM;IACN,2EAA2E;IAC3E,YAAY;CACJ,CAAC;AAIX,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,SAAS;IACT,SAAS;IACT,OAAO;IACP,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,UAAU;IACV,kBAAkB;IAClB,WAAW,EAAE,mEAAmE;IAChF,mBAAmB;IACnB,WAAW;IACX,iBAAiB;IACjB,eAAe;IACf,SAAS;IACT,cAAc;IACd,gBAAgB;IAChB,OAAO;IACP,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,yEAAyE;IACzE,yEAAyE;IACzE,6EAA6E;IAC7E,KAAK;IACL,cAAc;IACd,SAAS;IACT,WAAW;IACX,YAAY;IACZ,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,8EAA8E;IAC9E,KAAK;IACL,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"schema-constants.js","sourceRoot":"","sources":["../../src/lbug/schema-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,QAAQ;IACR,UAAU;IACV,OAAO;IACP,WAAW;IACX,QAAQ;IACR,aAAa;IACb,WAAW;IACX,SAAS;IACT,SAAS;IACT,QAAQ;IACR,MAAM;IACN,OAAO;IACP,SAAS;IACT,OAAO;IACP,WAAW;IACX,OAAO;IACP,MAAM;IACN,WAAW;IACX,OAAO;IACP,QAAQ;IACR,UAAU;IACV,UAAU;IACV,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,aAAa;IACb,UAAU;IACV,QAAQ;IACR,OAAO;IACP,MAAM;IACN,oEAAoE;IACpE,aAAa;IACb,2EAA2E;IAC3E,YAAY;CACJ,CAAC;AAIX,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,SAAS;IACT,SAAS;IACT,OAAO;IACP,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,UAAU;IACV,kBAAkB;IAClB,WAAW,EAAE,mEAAmE;IAChF,mBAAmB;IACnB,WAAW;IACX,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,eAAe;IACf,SAAS;IACT,cAAc;IACd,gBAAgB;IAChB,OAAO;IACP,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,yEAAyE;IACzE,yEAAyE;IACzE,6EAA6E;IAC7E,KAAK;IACL,cAAc;IACd,SAAS;IACT,WAAW;IACX,YAAY;IACZ,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,8EAA8E;IAC9E,KAAK;IACL,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC"}

package/dist/cli/detect-changes-format.js

@@ -20,6 +20,27 @@ export function formatDetectChangesResult(result) {
     if (payload.truncated)
         notes.push(t(payload.partial ? 'tool.detectChanges.truncatedDegraded' : 'tool.detectChanges.truncated'));
     if ((summary.changed_count ?? 0) === 0) {
+        // Parse-fail payloads set `partial` and an honest `message` (#2915/#3131).
+        // Production *clean* trees also set English `message: 'No changes detected.'`
+        // — that must go through `t('tool.detectChanges.noChanges')` or zh-CN never
+        // fires. Only pass the backend string through on a degraded/parse-fail run.
+        if (payload.partial &&
+            typeof summary.message === 'string' &&
+            summary.message.trim().length > 0) {
+            return [...notes, summary.message.trim()].join('\n');
+        }
+        // Confirmed no-overlap: files parsed, mapping succeeded, zero symbols.
+        // `queryDegraded` is `partial: true` with the same counts and no message —
+        // do not call that a confirmed mapping (#3131 honesty).
+        if (!payload.partial && (summary.changed_files ?? 0) > 0) {
+            return [
+                ...notes,
+                t('tool.detectChanges.noOverlappingSymbols', { files: summary.changed_files }),
+            ].join('\n');
+        }
+        if (payload.partial) {
+            return notes.join('\n');
+        }
         return [...notes, t('tool.detectChanges.noChanges')].join('\n');
     }
     const lines = [];

package/dist/cli/i18n/en.d.ts

@@ -66,6 +66,7 @@ export declare const en: {
     readonly 'tool.usage.cypher': "Usage: gitnexus cypher <cypher_query>";
     readonly 'tool.warn.unknownKind': "--kind '{{kind}}' is not a known symbol kind (e.g. Function, Class, Method); it will not narrow the result.";
     readonly 'tool.detectChanges.noChanges': "No changes detected.";
+    readonly 'tool.detectChanges.noOverlappingSymbols': "Diff touched {{files}} file(s) but no indexed symbols overlap those hunks — not a clean tree.";
     readonly 'tool.detectChanges.partial': "PARTIAL RESULT: a graph query failed, so changed symbols may be missing. Do not read this as a clean pre-commit check.";
     readonly 'tool.detectChanges.truncated': "LISTING CAPPED: the changed-symbol list was capped, so it does not name every changed symbol. The counts and risk level still cover all of them.";
     readonly 'tool.detectChanges.truncatedDegraded': "LISTING CAPPED: the changed-symbol list was capped. The run also degraded, so the counts are a lower bound, not a total.";

package/dist/cli/i18n/en.js

@@ -66,6 +66,7 @@ export const en = {
     'tool.usage.cypher': 'Usage: gitnexus cypher <cypher_query>',
     'tool.warn.unknownKind': "--kind '{{kind}}' is not a known symbol kind (e.g. Function, Class, Method); it will not narrow the result.",
     'tool.detectChanges.noChanges': 'No changes detected.',
+    'tool.detectChanges.noOverlappingSymbols': 'Diff touched {{files}} file(s) but no indexed symbols overlap those hunks — not a clean tree.',
     'tool.detectChanges.partial': 'PARTIAL RESULT: a graph query failed, so changed symbols may be missing. Do not read this as a clean pre-commit check.',
     'tool.detectChanges.truncated': 'LISTING CAPPED: the changed-symbol list was capped, so it does not name every changed symbol. The counts and risk level still cover all of them.',
     // The reassurance above is only true on its own. When the run also degraded,

package/dist/cli/i18n/resources.d.ts

@@ -67,6 +67,7 @@ export declare const cliResources: {
         readonly 'tool.usage.cypher': "Usage: gitnexus cypher <cypher_query>";
         readonly 'tool.warn.unknownKind': "--kind '{{kind}}' is not a known symbol kind (e.g. Function, Class, Method); it will not narrow the result.";
         readonly 'tool.detectChanges.noChanges': "No changes detected.";
+        readonly 'tool.detectChanges.noOverlappingSymbols': "Diff touched {{files}} file(s) but no indexed symbols overlap those hunks — not a clean tree.";
         readonly 'tool.detectChanges.partial': "PARTIAL RESULT: a graph query failed, so changed symbols may be missing. Do not read this as a clean pre-commit check.";
         readonly 'tool.detectChanges.truncated': "LISTING CAPPED: the changed-symbol list was capped, so it does not name every changed symbol. The counts and risk level still cover all of them.";
         readonly 'tool.detectChanges.truncatedDegraded': "LISTING CAPPED: the changed-symbol list was capped. The run also degraded, so the counts are a lower bound, not a total.";
@@ -331,6 +332,7 @@ export declare const cliResources: {
         'tool.usage.cypher': string;
         'tool.warn.unknownKind': string;
         'tool.detectChanges.noChanges': string;
+        'tool.detectChanges.noOverlappingSymbols': string;
         'tool.detectChanges.partial': string;
         'tool.detectChanges.truncated': string;
         'tool.detectChanges.truncatedDegraded': string;

package/dist/cli/i18n/zh-CN.d.ts

@@ -66,6 +66,7 @@ export declare const zhCN: {
     'tool.usage.cypher': string;
     'tool.warn.unknownKind': string;
     'tool.detectChanges.noChanges': string;
+    'tool.detectChanges.noOverlappingSymbols': string;
     'tool.detectChanges.partial': string;
     'tool.detectChanges.truncated': string;
     'tool.detectChanges.truncatedDegraded': string;

package/dist/cli/i18n/zh-CN.js

@@ -66,6 +66,7 @@ export const zhCN = {
     'tool.usage.cypher': '用法：gitnexus cypher <Cypher 查询>',
     'tool.warn.unknownKind': "--kind '{{kind}}' 不是已知的符号类型（如 Function、Class、Method），不会用于缩小结果范围。",
     'tool.detectChanges.noChanges': '未检测到变更。',
+    'tool.detectChanges.noOverlappingSymbols': 'diff 触及 {{files}} 个文件，但没有索引符号与这些 hunk 重叠 — 并非干净工作区。',
     'tool.detectChanges.partial': '结果不完整：图查询失败，可能遗漏已变更符号。请勿将其视为通过的提交前检查。',
     'tool.detectChanges.truncated': '列表已截断：已变更符号列表被截断，未列出全部变更符号。计数与风险等级仍涵盖全部符号。',
     'tool.detectChanges.truncatedDegraded': '列表已截断：已变更符号列表被截断。本次运行同时不完整，因此计数为下限而非总数。',

package/dist/core/incremental/subgraph-extract.d.ts

@@ -8,7 +8,8 @@
  *   - Every node whose `properties.filePath` is in `toWriteSet`.
  *   - Graph-wide Community/Process nodes unless `includeDerivedGraphWide`
  *     is false (#3016 incremental preserve). Spring metadata placeholders
- *     are always included.
+ *     and `Destination` nodes are always included — their owning phase
+ *     delete-alls them unconditionally before the writeback.
  *   - Every relationship where AT LEAST ONE endpoint is in the writable
  *     set above. Relationships entirely between unchanged-file nodes
  *     are skipped — their rows are still in the DB and re-inserting

package/dist/core/incremental/subgraph-extract.js

@@ -8,7 +8,8 @@
  *   - Every node whose `properties.filePath` is in `toWriteSet`.
  *   - Graph-wide Community/Process nodes unless `includeDerivedGraphWide`
  *     is false (#3016 incremental preserve). Spring metadata placeholders
- *     are always included.
+ *     and `Destination` nodes are always included — their owning phase
+ *     delete-alls them unconditionally before the writeback.
  *   - Every relationship where AT LEAST ONE endpoint is in the writable
  *     set above. Relationships entirely between unchanged-file nodes
  *     are skipped — their rows are still in the DB and re-inserting
@@ -50,8 +51,30 @@
 import { createKnowledgeGraph } from '../graph/graph.js';
 import { isSpringAutoConfigurationDeclaration, isSpringAutoConfigurationSyntheticClass, } from '../ingestion/frameworks/spring/auto-configuration.js';
 import { isSpringAopEvidenceNode } from '../ingestion/frameworks/spring/aop.js';
+/**
+ * `Destination` is graph-wide for the same reason as the Spring AOP evidence
+ * nodes: the layer is recomputed in full on every run and deleted in full
+ * before the writeback (`deleteAllDestinations`), so it must be re-included in
+ * full or it is simply lost.
+ *
+ * The endpoint-writability rule cannot carry it. A RESOLVED destination stores
+ * no `filePath` at all — deliberately, so an incremental delete keyed on
+ * `filePath IN [...]` cannot cut a node shared across files — and the include
+ * test below starts from exactly that property. The result was a defect in both
+ * directions: a newly added file publishing to a new topic reported
+ * `added=1, exit 0` and silently put neither the destination nor the
+ * publisher's edge into the graph, so after the first index every new topic was
+ * invisible until a full rebuild; and a destination whose last referrer stopped
+ * referring to it survived forever as an edgeless orphan still carrying
+ * `address`, the cross-repository join key.
+ *
+ * Unresolved destinations DO carry a file path and would ride the ordinary
+ * rule, but they are included here too: the delete-all removes them as well, so
+ * anything not re-included would be dropped rather than merely stale.
+ */
 const isGraphWideNode = (node) => node.label === 'Community' ||
     node.label === 'Process' ||
+    node.label === 'Destination' ||
     isSpringAopEvidenceNode(node) ||
     isSpringAutoConfigurationSyntheticClass(node);
 /**

package/dist/core/ingestion/destination-key.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Shared destination-identity keying — the async counterpart of `routeNodeKey`
+ * in `route-extractors/route-path.ts`.
+ *
+ * Deliberately OUTSIDE `frameworks/spring/`, and for the same reason
+ * `routeNodeKey` sits outside the routes phase: the identity has to be mintable
+ * by anything that names a broker address, so a Node Kafka client or a Celery
+ * task queue can land on the very node a Spring publisher minted. A key that
+ * lived in the Spring module would force every other producer to import Spring,
+ * or — worse — let each one invent its own spelling, and two spellings of one
+ * address is precisely the missed connection this overlay exists to make.
+ *
+ * `broker` is a plain `string`, NOT the Spring `SpringDestinationBroker` union.
+ * Importing that union here is the dependency this module exists to avoid, and
+ * widening it costs nothing that matters: the union is a subtype of `string`,
+ * so a Spring caller passes its own values unchanged, while a future
+ * non-Spring caller stays free to attest to a broker Spring has no name for.
+ * The trade is real but small — this signature cannot reject a misspelled
+ * broker — and it is the same trade `routeNodeKey` makes by taking `method` as
+ * a `string` rather than an HTTP-verb union. Pure string logic, no
+ * dependencies.
+ */
+/**
+ * The `Destination` node identity: `(broker, address)` when the broker is
+ * known, falling back to the address alone when it is not.
+ *
+ * The broker belongs IN the key, exactly as the HTTP verb belongs in
+ * `routeNodeKey`. `GET /x` and `POST /x` are two nodes, both fully joinable,
+ * and neither is punished for the other's existence; `kafka orders` and
+ * `rabbit orders` are two nodes on the same terms. A Kafka topic and a Rabbit
+ * queue that happen to share a name are two places, and one node for both would
+ * report a publisher and a subscriber as connected when nothing connects them.
+ *
+ * The known objection is that the broker is INFERRED — from a receiver's name,
+ * from an annotation table — so a wrong guess splits a pair that is really one.
+ * That is true and it is the cost. It is worth paying because the alternative
+ * tried first was worse: withdrawing the address from every site that named it
+ * split the pair even when the guess was RIGHT, since one unrelated third party
+ * writing the same word anywhere in the repository was enough to disconnect
+ * everybody on that spelling. Putting the broker in the key bounds the damage
+ * of a wrong guess to the one pair it was wrong about, instead of spreading it
+ * to every pair that shares an address with a stranger.
+ *
+ * ── THE ADDRESS-ONLY FALLBACK IS UNREACHABLE TODAY ──────────────────────
+ *
+ * `SpringDestinationCandidate.broker` is REQUIRED, and every annotation rule
+ * and every producer template supplies one, so no Spring caller can reach the
+ * `undefined` branch. It is written anyway, and on purpose: the parameter shape
+ * is the contract this module offers the next language, and the next language
+ * may well capture an address without being able to attest to a broker (a bare
+ * `queue.publish(name)` in a dynamic language, a binding that names only a
+ * channel). Degrading to address-only is the right answer there — silence about
+ * the broker is not a claim about it, and refusing to key such a site at all
+ * would lose a real destination over a value nobody disagreed about.
+ *
+ * Because the branch is dead, it is covered by testing THIS function directly
+ * rather than by a pipeline test staged to look as though a phase reached it.
+ */
+export declare function destinationNodeKey(broker: string | undefined, address: string): string;

package/dist/core/ingestion/destination-key.js

@@ -0,0 +1,61 @@
+/**
+ * Shared destination-identity keying — the async counterpart of `routeNodeKey`
+ * in `route-extractors/route-path.ts`.
+ *
+ * Deliberately OUTSIDE `frameworks/spring/`, and for the same reason
+ * `routeNodeKey` sits outside the routes phase: the identity has to be mintable
+ * by anything that names a broker address, so a Node Kafka client or a Celery
+ * task queue can land on the very node a Spring publisher minted. A key that
+ * lived in the Spring module would force every other producer to import Spring,
+ * or — worse — let each one invent its own spelling, and two spellings of one
+ * address is precisely the missed connection this overlay exists to make.
+ *
+ * `broker` is a plain `string`, NOT the Spring `SpringDestinationBroker` union.
+ * Importing that union here is the dependency this module exists to avoid, and
+ * widening it costs nothing that matters: the union is a subtype of `string`,
+ * so a Spring caller passes its own values unchanged, while a future
+ * non-Spring caller stays free to attest to a broker Spring has no name for.
+ * The trade is real but small — this signature cannot reject a misspelled
+ * broker — and it is the same trade `routeNodeKey` makes by taking `method` as
+ * a `string` rather than an HTTP-verb union. Pure string logic, no
+ * dependencies.
+ */
+/**
+ * The `Destination` node identity: `(broker, address)` when the broker is
+ * known, falling back to the address alone when it is not.
+ *
+ * The broker belongs IN the key, exactly as the HTTP verb belongs in
+ * `routeNodeKey`. `GET /x` and `POST /x` are two nodes, both fully joinable,
+ * and neither is punished for the other's existence; `kafka orders` and
+ * `rabbit orders` are two nodes on the same terms. A Kafka topic and a Rabbit
+ * queue that happen to share a name are two places, and one node for both would
+ * report a publisher and a subscriber as connected when nothing connects them.
+ *
+ * The known objection is that the broker is INFERRED — from a receiver's name,
+ * from an annotation table — so a wrong guess splits a pair that is really one.
+ * That is true and it is the cost. It is worth paying because the alternative
+ * tried first was worse: withdrawing the address from every site that named it
+ * split the pair even when the guess was RIGHT, since one unrelated third party
+ * writing the same word anywhere in the repository was enough to disconnect
+ * everybody on that spelling. Putting the broker in the key bounds the damage
+ * of a wrong guess to the one pair it was wrong about, instead of spreading it
+ * to every pair that shares an address with a stranger.
+ *
+ * ── THE ADDRESS-ONLY FALLBACK IS UNREACHABLE TODAY ──────────────────────
+ *
+ * `SpringDestinationCandidate.broker` is REQUIRED, and every annotation rule
+ * and every producer template supplies one, so no Spring caller can reach the
+ * `undefined` branch. It is written anyway, and on purpose: the parameter shape
+ * is the contract this module offers the next language, and the next language
+ * may well capture an address without being able to attest to a broker (a bare
+ * `queue.publish(name)` in a dynamic language, a binding that names only a
+ * channel). Degrading to address-only is the right answer there — silence about
+ * the broker is not a claim about it, and refusing to key such a site at all
+ * would lose a real destination over a value nobody disagreed about.
+ *
+ * Because the branch is dead, it is covered by testing THIS function directly
+ * rather than by a pipeline test staged to look as though a phase reached it.
+ */
+export function destinationNodeKey(broker, address) {
+    return broker ? `${broker} ${address}` : address;
+}