ts-knowledge-graph 0.1.2 → 0.1.6

package/dist/report/report_data.d.ts

@@ -0,0 +1,128 @@
+import { GraphQuery } from '../query/graph_query.js';
+import { SourceManifest } from '../schema/source_manifest.js';
+import { KuzuStore } from '../store/kuzu_store.js';
+/** A graph symbol reduced to the fields every report section renders. */
+export type ReportSymbol = {
+    name: string;
+    kind: string;
+    filePath: string;
+    startLine: number;
+};
+/** A {@link ReportSymbol} carrying the score it earned in a ranking. */
+export type RankedSymbol = ReportSymbol & {
+    score: number;
+};
+/** A {@link ReportSymbol} carrying its propagated cost, for the runtime sections. */
+export type ReportCostNode = ReportSymbol & {
+    selfCost: number;
+    inclusiveCost: number;
+    shareOfTotal: number;
+    cyclic: boolean;
+    cycleSize: number;
+};
+/** One row of the composition tables: a node or edge kind and how many carry it. */
+export type KindCount = {
+    kind: string;
+    count: number;
+};
+/** A detected community, named by its label and sized by its membership. */
+export type ReportCommunity = {
+    label: string;
+    size: number;
+};
+/** One call cycle: the strongly-connected component's size and its members. */
+export type ReportCycle = {
+    size: number;
+    members: ReportSymbol[];
+};
+/** The system-level surface area: routes handled, configuration read, hosts called. */
+export type ReportBoundary = {
+    endpoints: ReportSymbol[];
+    configFlags: ReportSymbol[];
+    externalApis: ReportSymbol[];
+};
+/**
+ * The static-call-graph view set against the runtime profile. `orchestrators`
+ * carry cost but spend ~none themselves; `hiddenHotspots` are hot yet have few
+ * callers; `alignedCore` are both central and hot. Empty on an un-enriched graph.
+ */
+export type StructureVsRuntime = {
+    orchestrators: ReportSymbol[];
+    hiddenHotspots: ReportSymbol[];
+    alignedCore: ReportSymbol[];
+};
+/** The complete, format-agnostic data a {@link GraphReport} renders. */
+export type GraphReportData = {
+    generatedAt: string;
+    project: string;
+    outputFolder: string;
+    provenance: SourceManifest | null;
+    semantic: boolean;
+    enriched: boolean;
+    coverage: number | null;
+    totalSelf: number;
+    limit: number;
+    totals: {
+        symbols: number;
+        files: number;
+        relationships: number;
+        communities: number;
+        deadExports: number;
+        cycles: number;
+    };
+    verdict: string;
+    nodeKinds: KindCount[];
+    edgeKinds: KindCount[];
+    hubsByCallers: RankedSymbol[];
+    hubsByBlastRadius: RankedSymbol[];
+    communityQuality: number | null;
+    communities: ReportCommunity[];
+    hotspots: RankedSymbol[];
+    cost: ReportCostNode[];
+    structureVsRuntime: StructureVsRuntime;
+    cycles: ReportCycle[];
+    boundary: ReportBoundary;
+    deadExports: ReportSymbol[];
+};
+export type GatherOptions = {
+    /** ISO date (YYYY-MM-DD) the command stamps; passed in so gathering stays pure of the clock. */
+    generatedAt: string;
+    /** Fallback project label when the graph records no source provenance. */
+    project: string;
+    /** The output folder, echoed into the copy-pasteable "where to go next" commands. */
+    outputFolder: string;
+    /** Top-N kept per ranking. */
+    limit: number;
+};
+/**
+ * Gathers a {@link GraphReportData} from a loaded graph, reusing the existing
+ * query surface (`hotspots`, `costRanking`, `deadExports`, `strongCycles`) plus a
+ * few direct reads for composition and communities. Mirrors how the other
+ * commands lean on {@link GraphQuery}; the rendering is left entirely to
+ * {@link GraphReport}, so this stays presentation-free apart from the one-line
+ * verdict it synthesises.
+ */
+export declare class ReportData {
+    static gather(store: KuzuStore, query: GraphQuery, options: GatherOptions): Promise<GraphReportData>;
+    private static edgeKindCounts;
+    private static nodeKindCounts;
+    private static countBy;
+    /** Groups nodes by their assigned community index, labelled and sized, largest first. */
+    private static communitiesOf;
+    private static boundaryOf;
+    /**
+     * Splits the measured graph into three reads of the same symbols: pure
+     * orchestrators (cost flows through, ~no self cost), hidden hotspots (hot, few
+     * callers), and the aligned core (central and hot).
+     */
+    private static synthesize;
+    private static readProvenance;
+    private static readCommunityQuality;
+    /** Derives `owner/repo` from the recorded GitHub base URL, falling back to the given label. */
+    private static projectName;
+    private static verdictOf;
+    private static toRanked;
+    private static toCostNode;
+    private static toSymbol;
+}
+//# sourceMappingURL=report_data.d.ts.map

package/dist/report/report_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report_data.d.ts","sourceRoot":"","sources":["../../src/report/report_data.ts"],"names":[],"mappings":"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"}

package/dist/report/report_data.js

@@ -0,0 +1,191 @@
+import { CLUSTERING_MANIFEST_KEY, COMMUNITY_LABEL_METADATA_KEY, COMMUNITY_METADATA_KEY } from '../cluster/graph_clusterer.js';
+import { SOURCE_MANIFEST_KEY, SourceManifestSchema } from '../schema/source_manifest.js';
+/** How many callers a symbol may have and still count as a "hidden" hotspot. */
+const HIDDEN_HOTSPOT_MAX_CALLERS = 1;
+/** A large bound used to read whole rankings before slicing them to `limit`. */
+const UNBOUNDED = 100000;
+/**
+ * Gathers a {@link GraphReportData} from a loaded graph, reusing the existing
+ * query surface (`hotspots`, `costRanking`, `deadExports`, `strongCycles`) plus a
+ * few direct reads for composition and communities. Mirrors how the other
+ * commands lean on {@link GraphQuery}; the rendering is left entirely to
+ * {@link GraphReport}, so this stays presentation-free apart from the one-line
+ * verdict it synthesises.
+ */
+export class ReportData {
+    static async gather(store, query, options) {
+        const nodes = await store.readNodes();
+        const edgeKinds = await ReportData.edgeKindCounts(store);
+        const provenance = await ReportData.readProvenance(store);
+        const communityQuality = await ReportData.readCommunityQuality(store);
+        const callers = await query.hotspots({ by: 'callers', limit: UNBOUNDED });
+        const blast = await query.hotspots({ by: 'blast-radius', limit: UNBOUNDED });
+        const selfTime = await query.hotspots({ by: 'self-time', limit: UNBOUNDED });
+        const costReport = await query.costRanking({ limit: UNBOUNDED });
+        const deadExports = await query.deadExports();
+        const cycles = await query.strongCycles();
+        const limit = options.limit;
+        const enriched = costReport.enriched;
+        const measured = enriched === true && selfTime.fellBack === false;
+        const semantic = edgeKinds.some((entry) => entry.kind === 'CALLS' && entry.count > 0);
+        const fanIn = new Map(callers.hotspots.map((hotspot) => [hotspot.id, hotspot.score]));
+        const communities = ReportData.communitiesOf(nodes);
+        const data = {
+            generatedAt: options.generatedAt,
+            project: ReportData.projectName(provenance, options.project),
+            outputFolder: options.outputFolder,
+            provenance,
+            semantic,
+            enriched,
+            coverage: costReport.coverage,
+            totalSelf: costReport.totalSelf,
+            limit,
+            totals: {
+                symbols: nodes.length,
+                files: new Set(nodes.map((node) => node.filePath)).size,
+                relationships: edgeKinds.reduce((sum, entry) => sum + entry.count, 0),
+                communities: communities.length,
+                deadExports: deadExports.length,
+                cycles: cycles.length,
+            },
+            verdict: '',
+            nodeKinds: ReportData.nodeKindCounts(nodes),
+            edgeKinds,
+            hubsByCallers: callers.hotspots.slice(0, limit).map(ReportData.toRanked),
+            hubsByBlastRadius: blast.hotspots.slice(0, limit).map(ReportData.toRanked),
+            communityQuality,
+            communities: communities.slice(0, limit),
+            hotspots: measured === true ? selfTime.hotspots.slice(0, limit).map(ReportData.toRanked) : [],
+            cost: costReport.nodes.slice(0, limit).map(ReportData.toCostNode),
+            structureVsRuntime: ReportData.synthesize(costReport.nodes, measured === true ? selfTime.hotspots : [], fanIn),
+            cycles: cycles.slice(0, limit).map((members) => ({ size: members.length, members: members.map(ReportData.toSymbol) })),
+            boundary: ReportData.boundaryOf(nodes),
+            deadExports: deadExports.map(ReportData.toSymbol),
+        };
+        data.verdict = ReportData.verdictOf(data);
+        return data;
+    }
+    static async edgeKindCounts(store) {
+        const rows = await store.run('MATCH (:GraphNode)-[e:Edge]->(:GraphNode) RETURN e.kind AS kind');
+        return ReportData.countBy(rows.map((row) => String(row.kind)));
+    }
+    static nodeKindCounts(nodes) {
+        return ReportData.countBy(nodes.map((node) => node.kind));
+    }
+    static countBy(values) {
+        const counts = new Map();
+        for (const value of values) {
+            counts.set(value, (counts.get(value) ?? 0) + 1);
+        }
+        return [...counts.entries()]
+            .map(([kind, count]) => ({ kind, count }))
+            .sort((a, b) => b.count - a.count || a.kind.localeCompare(b.kind));
+    }
+    /** Groups nodes by their assigned community index, labelled and sized, largest first. */
+    static communitiesOf(nodes) {
+        const sizes = new Map();
+        const labels = new Map();
+        for (const node of nodes) {
+            const index = node.metadata[COMMUNITY_METADATA_KEY];
+            if (typeof index !== 'number') {
+                continue;
+            }
+            sizes.set(index, (sizes.get(index) ?? 0) + 1);
+            const label = node.metadata[COMMUNITY_LABEL_METADATA_KEY];
+            if (typeof label === 'string' && labels.has(index) === false) {
+                labels.set(index, label);
+            }
+        }
+        return [...sizes.entries()]
+            .map(([index, size]) => ({ label: labels.get(index) ?? `community ${index}`, size }))
+            .sort((a, b) => b.size - a.size || a.label.localeCompare(b.label));
+    }
+    static boundaryOf(nodes) {
+        const of = (kind) => nodes.filter((node) => node.kind === kind).map(ReportData.toSymbol);
+        return { endpoints: of('Endpoint'), configFlags: of('ConfigFlag'), externalApis: of('ExternalAPI') };
+    }
+    /**
+     * Splits the measured graph into three reads of the same symbols: pure
+     * orchestrators (cost flows through, ~no self cost), hidden hotspots (hot, few
+     * callers), and the aligned core (central and hot).
+     */
+    static synthesize(cost, hottest, fanIn) {
+        const orchestrators = cost
+            .filter((node) => node.selfCost === 0 && node.inclusiveCost > 0)
+            .slice(0, 5)
+            .map(ReportData.toSymbol);
+        const hiddenHotspots = hottest
+            .filter((hotspot) => (fanIn.get(hotspot.id) ?? 0) <= HIDDEN_HOTSPOT_MAX_CALLERS)
+            .slice(0, 5)
+            .map(ReportData.toSymbol);
+        const alignedCore = hottest
+            .filter((hotspot) => (fanIn.get(hotspot.id) ?? 0) > HIDDEN_HOTSPOT_MAX_CALLERS)
+            .slice(0, 5)
+            .map(ReportData.toSymbol);
+        return { orchestrators, hiddenHotspots, alignedCore };
+    }
+    static async readProvenance(store) {
+        const raw = await store.readGraphMeta(SOURCE_MANIFEST_KEY);
+        if (raw === null) {
+            return null;
+        }
+        const parsed = SourceManifestSchema.safeParse(raw);
+        return parsed.success === true ? parsed.data : null;
+    }
+    static async readCommunityQuality(store) {
+        const raw = await store.readGraphMeta(CLUSTERING_MANIFEST_KEY);
+        if (raw === null) {
+            return null;
+        }
+        const quality = raw.quality;
+        return typeof quality === 'number' ? quality : null;
+    }
+    /** Derives `owner/repo` from the recorded GitHub base URL, falling back to the given label. */
+    static projectName(provenance, fallback) {
+        if (provenance === null) {
+            return fallback;
+        }
+        try {
+            const path = new URL(provenance.baseUrl).pathname.replace(/^\/+|\/+$/g, '');
+            return path.length > 0 ? path : fallback;
+        }
+        catch {
+            return fallback;
+        }
+    }
+    static verdictOf(data) {
+        const shape = data.semantic === true ? (data.enriched === true ? 'semantic, enriched' : 'semantic') : 'structural';
+        const cycles = data.totals.cycles === 0 ? 'acyclic' : `${data.totals.cycles} call cycle(s)`;
+        const sentences = [`${data.totals.symbols} symbols across ${data.totals.files} files — ${shape}, ${cycles}.`];
+        if (data.enriched === true && data.hotspots.length > 0) {
+            const hottest = data.hotspots[0];
+            const costNode = data.cost.find((node) => node.name === hottest.name && node.filePath === hottest.filePath);
+            const share = costNode === undefined ? '' : ` (${(costNode.shareOfTotal * 100).toFixed(1)}% of inclusive cost)`;
+            sentences.push(`\`${hottest.name}\` is the hottest function${share}.`);
+        }
+        if (data.totals.deadExports > 0) {
+            sentences.push(`${data.totals.deadExports} exported symbol(s) appear dead.`);
+        }
+        return sentences.join(' ');
+    }
+    static toRanked(ref) {
+        return { name: ref.name, kind: ref.kind, filePath: ref.filePath, startLine: ref.startLine, score: ref.score };
+    }
+    static toCostNode(ref) {
+        return {
+            name: ref.name,
+            kind: ref.kind,
+            filePath: ref.filePath,
+            startLine: ref.startLine,
+            selfCost: ref.selfCost,
+            inclusiveCost: ref.inclusiveCost,
+            shareOfTotal: ref.shareOfTotal,
+            cyclic: ref.cyclic,
+            cycleSize: ref.cycleSize,
+        };
+    }
+    static toSymbol(ref) {
+        return { name: ref.name, kind: ref.kind, filePath: ref.filePath, startLine: ref.startLine };
+    }
+}
+//# sourceMappingURL=report_data.js.map

package/dist/report/report_data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report_data.js","sourceRoot":"","sources":["../../src/report/report_data.ts"],"names":[],"mappings":"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"}

package/dist/schema/edge.d.ts

@@ -1,22 +1,57 @@
 import { z } from 'zod';
-export declare const EDGE_KINDS: readonly ["CONTAINS", "IMPORTS", "EXPORTS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "CALLS", "INSTANTIATES", "OVERRIDES", "READS", "WRITES"];
-export declare const EdgeKindSchema: z.ZodEnum<["CONTAINS", "IMPORTS", "EXPORTS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "CALLS", "INSTANTIATES", "OVERRIDES", "READS", "WRITES"]>;
+/**
+ * The closed edge vocabulary, grouped by layer (mirrors the README graph-model
+ * table).
+ *
+ * Decision (#31 Part 0): keep a closed `z.enum` rather than an extensible kind
+ * registry — simple and explicit. Kùzu stores `kind` as a `STRING`, so a new kind
+ * needs no schema migration; its only real costs are this enum, the extractor that
+ * emits it, and — for edges — whether it joins {@link REFERENCE_EDGE_KINDS}.
+ */
+export declare const EDGE_KINDS: readonly ["CONTAINS", "IMPORTS", "EXPORTS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "CALLS", "INSTANTIATES", "OVERRIDES", "READS", "WRITES", "READS_CONFIG", "CALLS_EXTERNAL", "HANDLES", "CALLS_RUNTIME"];
+export declare const EdgeKindSchema: z.ZodEnum<["CONTAINS", "IMPORTS", "EXPORTS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "CALLS", "INSTANTIATES", "OVERRIDES", "READS", "WRITES", "READS_CONFIG", "CALLS_EXTERNAL", "HANDLES", "CALLS_RUNTIME"]>;
 export type EdgeKind = z.infer<typeof EdgeKindSchema>;
+/**
+ * One-line, onboarding-oriented descriptions for every {@link EdgeKind}, keyed by
+ * kind. This is the single source of truth surfaced as hover tooltips in the web
+ * visualisation; the `Record<EdgeKind, string>` type makes adding an edge kind
+ * without describing it a compile error.
+ */
+export declare const EDGE_KIND_DESCRIPTIONS: Record<EdgeKind, string>;
+/**
+ * The edge kinds that count as a *reference* to their target — the single source
+ * of truth for {@link GraphQuery.references} and the {@link GraphQuery.deadExports}
+ * liveness check (the query layer derives its Cypher list from this array).
+ *
+ * An edge kind is a reference when its presence means the target symbol is *used*:
+ * a call, a heritage link, a type mention, an instantiation, a value read, a method
+ * override (an override uses the base member it replaces), or an endpoint→handler
+ * link (`HANDLES` — a route uses the function that handles it). Deliberately
+ * excluded:
+ * - `CONTAINS` / `IMPORTS` — containment and module wiring, not use;
+ * - `EXPORTS` — marks a symbol as exported; counting it would give every export an
+ *   inbound edge from its module and defeat dead-export detection;
+ * - `WRITES` — mutating a binding is not using its value;
+ * - `READS_CONFIG` / `CALLS_EXTERNAL` — their targets are synthesized system-level
+ *   nodes (a `ConfigFlag`, an `ExternalAPI`), not code symbols subject to
+ *   dead-export analysis.
+ */
+export declare const REFERENCE_EDGE_KINDS: readonly ["CALLS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "INSTANTIATES", "READS", "OVERRIDES", "HANDLES"];
 export declare const GraphEdgeSchema: z.ZodObject<{
     id: z.ZodString;
-    kind: z.ZodEnum<["CONTAINS", "IMPORTS", "EXPORTS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "CALLS", "INSTANTIATES", "OVERRIDES", "READS", "WRITES"]>;
+    kind: z.ZodEnum<["CONTAINS", "IMPORTS", "EXPORTS", "EXTENDS", "IMPLEMENTS", "USES_TYPE", "RETURNS", "PARAM_TYPE", "CALLS", "INSTANTIATES", "OVERRIDES", "READS", "WRITES", "READS_CONFIG", "CALLS_EXTERNAL", "HANDLES", "CALLS_RUNTIME"]>;
     from: z.ZodString;
     to: z.ZodString;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    kind: "CONTAINS" | "IMPORTS" | "EXPORTS" | "EXTENDS" | "IMPLEMENTS" | "USES_TYPE" | "RETURNS" | "PARAM_TYPE" | "CALLS" | "INSTANTIATES" | "OVERRIDES" | "READS" | "WRITES";
+    kind: "CONTAINS" | "IMPORTS" | "EXPORTS" | "EXTENDS" | "IMPLEMENTS" | "USES_TYPE" | "RETURNS" | "PARAM_TYPE" | "CALLS" | "INSTANTIATES" | "OVERRIDES" | "READS" | "WRITES" | "READS_CONFIG" | "CALLS_EXTERNAL" | "HANDLES" | "CALLS_RUNTIME";
     from: string;
     to: string;
     metadata?: Record<string, unknown> | undefined;
 }, {
     id: string;
-    kind: "CONTAINS" | "IMPORTS" | "EXPORTS" | "EXTENDS" | "IMPLEMENTS" | "USES_TYPE" | "RETURNS" | "PARAM_TYPE" | "CALLS" | "INSTANTIATES" | "OVERRIDES" | "READS" | "WRITES";
+    kind: "CONTAINS" | "IMPORTS" | "EXPORTS" | "EXTENDS" | "IMPLEMENTS" | "USES_TYPE" | "RETURNS" | "PARAM_TYPE" | "CALLS" | "INSTANTIATES" | "OVERRIDES" | "READS" | "WRITES" | "READS_CONFIG" | "CALLS_EXTERNAL" | "HANDLES" | "CALLS_RUNTIME";
     from: string;
     to: string;
     metadata?: Record<string, unknown> | undefined;

package/dist/schema/edge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../src/schema/edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,UAAU,qKAcb,CAAC;AAEX,eAAO,MAAM,cAAc,uKAAqB,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../src/schema/edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,mOAuBb,CAAC;AAEX,eAAO,MAAM,cAAc,qOAAqB,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAkB3D,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,oIAWO,CAAC;AAEzC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schema/edge.js

@@ -1,20 +1,93 @@
 import { z } from 'zod';
+/**
+ * The closed edge vocabulary, grouped by layer (mirrors the README graph-model
+ * table).
+ *
+ * Decision (#31 Part 0): keep a closed `z.enum` rather than an extensible kind
+ * registry — simple and explicit. Kùzu stores `kind` as a `STRING`, so a new kind
+ * needs no schema migration; its only real costs are this enum, the extractor that
+ * emits it, and — for edges — whether it joins {@link REFERENCE_EDGE_KINDS}.
+ */
 export const EDGE_KINDS = [
+    // Structural — cheap, always emitted (no symbol resolution).
     'CONTAINS',
     'IMPORTS',
     'EXPORTS',
+    // Type — require symbol resolution, emitted with `--semantic`.
     'EXTENDS',
     'IMPLEMENTS',
     'USES_TYPE',
     'RETURNS',
     'PARAM_TYPE',
+    // Behavioral — require symbol resolution, emitted with `--semantic`.
     'CALLS',
     'INSTANTIATES',
     'OVERRIDES',
     'READS',
     'WRITES',
+    // System-level — detection-gated entities (#31 Part 2+).
+    'READS_CONFIG',
+    'CALLS_EXTERNAL',
+    'HANDLES',
+    // Runtime — observed dynamically, emitted by `enrich` from a CPU profile.
+    'CALLS_RUNTIME',
 ];
 export const EdgeKindSchema = z.enum(EDGE_KINDS);
+/**
+ * One-line, onboarding-oriented descriptions for every {@link EdgeKind}, keyed by
+ * kind. This is the single source of truth surfaced as hover tooltips in the web
+ * visualisation; the `Record<EdgeKind, string>` type makes adding an edge kind
+ * without describing it a compile error.
+ */
+export const EDGE_KIND_DESCRIPTIONS = {
+    CONTAINS: 'Structural nesting: the source declares or encloses the target (a module contains a class, which contains a method).',
+    IMPORTS: 'The source module imports the target.',
+    EXPORTS: 'The source module exports the target symbol.',
+    EXTENDS: 'The source class or interface extends the target (inheritance).',
+    IMPLEMENTS: 'The source class implements the target interface.',
+    USES_TYPE: 'The source references the target in a type position.',
+    RETURNS: 'The target type appears in the source function or method return type.',
+    PARAM_TYPE: 'The target type appears in one of the source parameter types.',
+    CALLS: 'The source function or method calls the target.',
+    INSTANTIATES: 'The source constructs the target class with new.',
+    OVERRIDES: 'The source method overrides the base-class member it replaces.',
+    READS: 'The source reads the value of the target variable or property.',
+    WRITES: 'The source assigns to the target variable or property.',
+    READS_CONFIG: 'The source reads the target configuration flag (an environment variable).',
+    CALLS_EXTERNAL: 'The source makes an outbound HTTP call to the target external API.',
+    HANDLES: 'Links an HTTP endpoint to the function that handles it (route to handler).',
+    CALLS_RUNTIME: 'A call observed at runtime in a CPU profile: the source function or method was on the stack directly above the target. Captures dynamic dispatch that static CALLS cannot see.',
+};
+/**
+ * The edge kinds that count as a *reference* to their target — the single source
+ * of truth for {@link GraphQuery.references} and the {@link GraphQuery.deadExports}
+ * liveness check (the query layer derives its Cypher list from this array).
+ *
+ * An edge kind is a reference when its presence means the target symbol is *used*:
+ * a call, a heritage link, a type mention, an instantiation, a value read, a method
+ * override (an override uses the base member it replaces), or an endpoint→handler
+ * link (`HANDLES` — a route uses the function that handles it). Deliberately
+ * excluded:
+ * - `CONTAINS` / `IMPORTS` — containment and module wiring, not use;
+ * - `EXPORTS` — marks a symbol as exported; counting it would give every export an
+ *   inbound edge from its module and defeat dead-export detection;
+ * - `WRITES` — mutating a binding is not using its value;
+ * - `READS_CONFIG` / `CALLS_EXTERNAL` — their targets are synthesized system-level
+ *   nodes (a `ConfigFlag`, an `ExternalAPI`), not code symbols subject to
+ *   dead-export analysis.
+ */
+export const REFERENCE_EDGE_KINDS = [
+    'CALLS',
+    'EXTENDS',
+    'IMPLEMENTS',
+    'USES_TYPE',
+    'RETURNS',
+    'PARAM_TYPE',
+    'INSTANTIATES',
+    'READS',
+    'OVERRIDES',
+    'HANDLES',
+];
 export const GraphEdgeSchema = z.object({
     id: z.string(),
     kind: EdgeKindSchema,

package/dist/schema/edge.js.map

@@ -1 +1 @@
-{"version":3,"file":"edge.js","sourceRoot":"","sources":["../../src/schema/edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,UAAU;IACV,SAAS;IACT,SAAS;IACT,SAAS;IACT,YAAY;IACZ,WAAW;IACX,SAAS;IACT,YAAY;IACZ,OAAO;IACP,cAAc;IACd,WAAW;IACX,OAAO;IACP,QAAQ;CACC,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAGjD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../../src/schema/edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,6DAA6D;IAC7D,UAAU;IACV,SAAS;IACT,SAAS;IACT,+DAA+D;IAC/D,SAAS;IACT,YAAY;IACZ,WAAW;IACX,SAAS;IACT,YAAY;IACZ,qEAAqE;IACrE,OAAO;IACP,cAAc;IACd,WAAW;IACX,OAAO;IACP,QAAQ;IACR,yDAAyD;IACzD,cAAc;IACd,gBAAgB;IAChB,SAAS;IACT,0EAA0E;IAC1E,eAAe;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC/D,QAAQ,EAAE,sHAAsH;IAChI,OAAO,EAAE,uCAAuC;IAChD,OAAO,EAAE,8CAA8C;IACvD,OAAO,EAAE,iEAAiE;IAC1E,UAAU,EAAE,mDAAmD;IAC/D,SAAS,EAAE,sDAAsD;IACjE,OAAO,EAAE,uEAAuE;IAChF,UAAU,EAAE,+DAA+D;IAC3E,KAAK,EAAE,iDAAiD;IACxD,YAAY,EAAE,kDAAkD;IAChE,SAAS,EAAE,gEAAgE;IAC3E,KAAK,EAAE,gEAAgE;IACvE,MAAM,EAAE,wDAAwD;IAChE,YAAY,EAAE,2EAA2E;IACzF,cAAc,EAAE,oEAAoE;IACpF,OAAO,EAAE,4EAA4E;IACrF,aAAa,EAAE,gLAAgL;CAC/L,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,OAAO;IACP,SAAS;IACT,YAAY;IACZ,WAAW;IACX,SAAS;IACT,YAAY;IACZ,cAAc;IACd,OAAO;IACP,WAAW;IACX,SAAS;CAC8B,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/dist/schema/node.d.ts

@@ -1,7 +1,22 @@
 import { z } from 'zod';
-export declare const NODE_KINDS: readonly ["Module", "Class", "Interface", "TypeAlias", "Enum", "Function", "Method", "Property", "Parameter", "Variable", "ExternalModule"];
-export declare const NodeKindSchema: z.ZodEnum<["Module", "Class", "Interface", "TypeAlias", "Enum", "Function", "Method", "Property", "Parameter", "Variable", "ExternalModule"]>;
+/**
+ * The closed node vocabulary. See {@link EDGE_KINDS} in `edge.ts` for the
+ * closed-enum-vs-registry decision (#31 Part 0); the same reasoning applies here.
+ *
+ * The system-level group grows one detection-gated extractor at a time (#31).
+ * `ConfigFlag` (environment variables) is the first; `Endpoint`, `DatabaseTable`,
+ * `QueueTopic`, and `ExternalAPI` arrive in later slices.
+ */
+export declare const NODE_KINDS: readonly ["Module", "Class", "Interface", "TypeAlias", "Enum", "Function", "Method", "Property", "Parameter", "Variable", "ExternalModule", "ConfigFlag", "ExternalAPI", "Endpoint"];
+export declare const NodeKindSchema: z.ZodEnum<["Module", "Class", "Interface", "TypeAlias", "Enum", "Function", "Method", "Property", "Parameter", "Variable", "ExternalModule", "ConfigFlag", "ExternalAPI", "Endpoint"]>;
 export type NodeKind = z.infer<typeof NodeKindSchema>;
+/**
+ * One-line, onboarding-oriented descriptions for every {@link NodeKind}, keyed by
+ * kind. This is the single source of truth surfaced as hover tooltips in the web
+ * visualisation; the `Record<NodeKind, string>` type makes adding a node kind
+ * without describing it a compile error.
+ */
+export declare const NODE_KIND_DESCRIPTIONS: Record<NodeKind, string>;
 export declare const RangeSchema: z.ZodObject<{
     startLine: z.ZodNumber;
     startColumn: z.ZodNumber;
@@ -21,7 +36,7 @@ export declare const RangeSchema: z.ZodObject<{
 export type Range = z.infer<typeof RangeSchema>;
 export declare const GraphNodeSchema: z.ZodObject<{
     id: z.ZodString;
-    kind: z.ZodEnum<["Module", "Class", "Interface", "TypeAlias", "Enum", "Function", "Method", "Property", "Parameter", "Variable", "ExternalModule"]>;
+    kind: z.ZodEnum<["Module", "Class", "Interface", "TypeAlias", "Enum", "Function", "Method", "Property", "Parameter", "Variable", "ExternalModule", "ConfigFlag", "ExternalAPI", "Endpoint"]>;
     name: z.ZodString;
     filePath: z.ZodString;
     range: z.ZodOptional<z.ZodObject<{
@@ -44,7 +59,7 @@ export declare const GraphNodeSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    kind: "Module" | "Class" | "Interface" | "TypeAlias" | "Enum" | "Function" | "Method" | "Property" | "Parameter" | "Variable" | "ExternalModule";
+    kind: "Module" | "Class" | "Interface" | "TypeAlias" | "Enum" | "Function" | "Method" | "Property" | "Parameter" | "Variable" | "ExternalModule" | "ConfigFlag" | "ExternalAPI" | "Endpoint";
     name: string;
     filePath: string;
     metadata?: Record<string, unknown> | undefined;
@@ -57,7 +72,7 @@ export declare const GraphNodeSchema: z.ZodObject<{
     exported?: boolean | undefined;
 }, {
     id: string;
-    kind: "Module" | "Class" | "Interface" | "TypeAlias" | "Enum" | "Function" | "Method" | "Property" | "Parameter" | "Variable" | "ExternalModule";
+    kind: "Module" | "Class" | "Interface" | "TypeAlias" | "Enum" | "Function" | "Method" | "Property" | "Parameter" | "Variable" | "ExternalModule" | "ConfigFlag" | "ExternalAPI" | "Endpoint";
     name: string;
     filePath: string;
     metadata?: Record<string, unknown> | undefined;

package/dist/schema/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/schema/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,UAAU,6IAYb,CAAC;AAEX,eAAO,MAAM,cAAc,+IAAqB,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAKtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/schema/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,sLAkBb,CAAC;AAEX,eAAO,MAAM,cAAc,wLAAqB,CAAC;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAe3D,CAAC;AAEF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;EAKtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schema/node.js

@@ -1,5 +1,14 @@
 import { z } from 'zod';
+/**
+ * The closed node vocabulary. See {@link EDGE_KINDS} in `edge.ts` for the
+ * closed-enum-vs-registry decision (#31 Part 0); the same reasoning applies here.
+ *
+ * The system-level group grows one detection-gated extractor at a time (#31).
+ * `ConfigFlag` (environment variables) is the first; `Endpoint`, `DatabaseTable`,
+ * `QueueTopic`, and `ExternalAPI` arrive in later slices.
+ */
 export const NODE_KINDS = [
+    // Code structure.
     'Module',
     'Class',
     'Interface',
@@ -10,9 +19,36 @@ export const NODE_KINDS = [
     'Property',
     'Parameter',
     'Variable',
+    // External dependencies, as one opaque node per import specifier.
     'ExternalModule',
+    // System-level entities — detection-gated (#31 Part 2+).
+    'ConfigFlag',
+    'ExternalAPI',
+    'Endpoint',
 ];
 export const NodeKindSchema = z.enum(NODE_KINDS);
+/**
+ * One-line, onboarding-oriented descriptions for every {@link NodeKind}, keyed by
+ * kind. This is the single source of truth surfaced as hover tooltips in the web
+ * visualisation; the `Record<NodeKind, string>` type makes adding a node kind
+ * without describing it a compile error.
+ */
+export const NODE_KIND_DESCRIPTIONS = {
+    Module: 'A source file in the codebase.',
+    Class: 'A class declaration.',
+    Interface: 'An interface declaration.',
+    TypeAlias: 'A type alias declaration.',
+    Enum: 'An enum declaration.',
+    Function: 'A standalone, module-level function.',
+    Method: 'A function that belongs to a class or interface.',
+    Property: 'A field declared on a class or interface.',
+    Parameter: 'A parameter of a function or method.',
+    Variable: 'A module- or block-level variable binding.',
+    ExternalModule: 'An imported third-party or Node.js module, recorded as one opaque node per import specifier.',
+    ConfigFlag: 'An environment-variable configuration flag, detected from process.env reads.',
+    ExternalAPI: 'An outbound HTTP host called through fetch(), with one node per host.',
+    Endpoint: 'An HTTP route registered by the app, such as app.get("/users", handler).',
+};
 export const RangeSchema = z.object({
     startLine: z.number().int(),
     startColumn: z.number().int(),

package/dist/schema/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/schema/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,QAAQ;IACR,OAAO;IACP,WAAW;IACX,WAAW;IACX,MAAM;IACN,UAAU;IACV,QAAQ;IACR,UAAU;IACV,WAAW;IACX,UAAU;IACV,gBAAgB;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAGjD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/schema/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,kBAAkB;IAClB,QAAQ;IACR,OAAO;IACP,WAAW;IACX,WAAW;IACX,MAAM;IACN,UAAU;IACV,QAAQ;IACR,UAAU;IACV,WAAW;IACX,UAAU;IACV,kEAAkE;IAClE,gBAAgB;IAChB,yDAAyD;IACzD,YAAY;IACZ,aAAa;IACb,UAAU;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC/D,MAAM,EAAE,gCAAgC;IACxC,KAAK,EAAE,sBAAsB;IAC7B,SAAS,EAAE,2BAA2B;IACtC,SAAS,EAAE,2BAA2B;IACtC,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,sCAAsC;IAChD,MAAM,EAAE,kDAAkD;IAC1D,QAAQ,EAAE,2CAA2C;IACrD,SAAS,EAAE,sCAAsC;IACjD,QAAQ,EAAE,4CAA4C;IACtD,cAAc,EAAE,8FAA8F;IAC9G,UAAU,EAAE,8EAA8E;IAC1F,WAAW,EAAE,uEAAuE;IACpF,QAAQ,EAAE,0EAA0E;CACpF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}