@principal-ai/subsystems-react 0.17.0

package/dist/graphify/anchor.js

@@ -0,0 +1,132 @@
+/**
+ * Resolve a subsystem component (file + symbol) to a graphify definition node.
+ *
+ * This is component *anchoring*, not type-ref stub rewiring (`resolve.ts`).
+ * Conservative: never bind via corpus-wide same-name alone.
+ */
+import { normalizeGraphifyLabel } from './resolve';
+import { graphifyFileStem, makeGraphifyId, normalizeSourcePath, } from './ids';
+const FILE_SUFFIX_RE = /\.(py|js|jsx|ts|tsx|mjs|cjs|java|go|rs|rb|php|cs|cpp|cc|c|h|hpp|pas|pp|dpr|swift|kt|scala|dart|lua|pl|pm|ex|exs|zig|vue|svelte)$/i;
+function isDefinition(node) {
+    if (node.file_type !== 'code')
+        return false;
+    const file = typeof node.source_file === 'string' ? node.source_file : '';
+    if (!file)
+        return false;
+    const label = typeof node.label === 'string' ? node.label.trim() : '';
+    return !!label && !FILE_SUFFIX_RE.test(label);
+}
+/** Label forms that might match a subsystem symbol on a graphify node. */
+export function symbolLabelVariants(symbol) {
+    const raw = symbol.trim();
+    if (!raw)
+        return [];
+    const last = raw.includes('.') ? (raw.split('.').pop() ?? raw) : raw;
+    const variants = new Set([
+        raw,
+        last,
+        `${raw}()`,
+        `${last}()`,
+        `.${last}()`,
+        `.${last}`,
+    ]);
+    return [...variants];
+}
+function labelMatchesSymbol(label, symbol) {
+    const variants = symbolLabelVariants(symbol);
+    const trimmed = label.trim();
+    if (variants.includes(trimmed))
+        return true;
+    const foldedLabel = normalizeGraphifyLabel(trimmed);
+    return variants.some((v) => normalizeGraphifyLabel(v) === foldedLabel);
+}
+function candidateIdsFor(file, symbol) {
+    const stem = graphifyFileStem(file);
+    if (!stem)
+        return [];
+    const parts = symbol.split('.').map((p) => p.trim()).filter(Boolean);
+    const ids = new Set();
+    ids.add(makeGraphifyId(stem, symbol));
+    if (parts.length > 0)
+        ids.add(makeGraphifyId(stem, ...parts));
+    if (parts.length === 2) {
+        // Class method: make_id(class_id, method) ≈ make_id(stem, Class, method)
+        ids.add(makeGraphifyId(stem, parts[0], parts[1]));
+    }
+    return [...ids];
+}
+/**
+ * Anchor a subsystem component onto a graphify definition node.
+ */
+export function resolveComponentAnchor(nodes, input) {
+    const file = input.file?.trim() ? normalizeSourcePath(input.file) : '';
+    const symbol = input.symbol?.trim() ?? '';
+    if (!file || !symbol) {
+        return { resolution: 'missing', node: null, candidates: [], triedIds: [] };
+    }
+    const byId = new Map();
+    const inFile = [];
+    for (const node of nodes) {
+        byId.set(String(node.id), node);
+        if (!isDefinition(node))
+            continue;
+        const sf = normalizeSourcePath(String(node.source_file ?? ''));
+        if (sf === file)
+            inFile.push(node);
+    }
+    const triedIds = candidateIdsFor(file, symbol);
+    const idHits = [];
+    for (const id of triedIds) {
+        const hit = byId.get(id);
+        if (!hit || !isDefinition(hit))
+            continue;
+        const sf = normalizeSourcePath(String(hit.source_file ?? ''));
+        if (sf === file)
+            idHits.push(hit);
+    }
+    const uniqueIdHits = [...new Map(idHits.map((n) => [String(n.id), n])).values()];
+    if (uniqueIdHits.length === 1) {
+        return {
+            resolution: 'exact',
+            node: uniqueIdHits[0],
+            candidates: [],
+            triedIds,
+        };
+    }
+    if (uniqueIdHits.length > 1) {
+        return {
+            resolution: 'ambiguous',
+            node: null,
+            candidates: uniqueIdHits,
+            triedIds,
+        };
+    }
+    if (inFile.length === 0) {
+        return { resolution: 'missing', node: null, candidates: [], triedIds };
+    }
+    const labelHits = inFile.filter((n) => labelMatchesSymbol(String(n.label ?? ''), symbol));
+    if (labelHits.length === 1) {
+        return {
+            resolution: 'exact',
+            node: labelHits[0],
+            candidates: [],
+            triedIds,
+        };
+    }
+    if (labelHits.length > 1) {
+        return {
+            resolution: 'ambiguous',
+            node: null,
+            candidates: labelHits,
+            triedIds,
+        };
+    }
+    // File has code nodes but none matched the symbol.
+    return {
+        resolution: 'file-only',
+        node: null,
+        candidates: inFile.slice(0, 8),
+        triedIds,
+    };
+}
+//# sourceMappingURL=anchor.js.map

package/dist/graphify/anchor.js.map

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

package/dist/graphify/consolidated.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Graphify consolidated / drill-down types.
+ *
+ * graphify stores the graph in flat, normalized form — class vs function vs
+ * type is NOT a node attribute (every code node is `file_type: "code"`); it is
+ * derived from graph structure. These types rebuild that structure from the raw
+ * edges so a UI can show a drill-down modal for a subsystem component or jump
+ * to its definition file.
+ */
+import type { GraphifyConfidence, GraphifyFileType, GraphifyRelation } from './types';
+/** How a subsystem component resolved to a graphify node. */
+export type GraphifyAnchorResolution = 'exact' | 'file-only' | 'ambiguous' | 'missing';
+/**
+ * The bridge between a facet component and the graphify graph.
+ *
+ * `nodeId` is reconstructed from the component's `file` + `symbol` via the id
+ * slug scheme; `resolution` says how confident that reconstruction is.
+ * `source_file` + `source_location` are the "open the definition" primitive.
+ */
+export interface SubsystemGraphifyAnchor {
+    /** Resolved graphify node id. */
+    nodeId: string;
+    /** PURL of the repo the node lives in (pkg:github/owner/repo). */
+    purl: string;
+    /** How the anchor resolved — the honesty signal for verification. */
+    resolution: GraphifyAnchorResolution;
+    /** Human-readable node label from the graph. */
+    label: string;
+    /** Repo-relative path of the node's source file. */
+    source_file: string;
+    /** `L<line>` — the line of the definition for a file-open jump. */
+    source_location?: string;
+    /** Node classification from the graph. */
+    file_type: GraphifyFileType;
+    /** Leiden community id. */
+    community?: number | null;
+    /** Human-readable community label. */
+    community_name?: string;
+}
+/** A method on a class-like node (`method` edge from the class). */
+export interface GraphifyMethodInfo {
+    /** The method's own node id. */
+    nodeId: string;
+    /** Display name from the label (`.get()` → `get`). */
+    name: string;
+    /** Typed parameters from `references` edges with context `parameter_type`. */
+    parameters?: GraphifyParamInfo[];
+    /** Return type from a `references` edge with context `return_type`. */
+    returnType?: string;
+    /** Backing edge target for `returnType`, when the graph had one. */
+    returnTypeRef?: GraphifyReferenceInfo;
+}
+/** A property/field on a class- or type-like node. */
+export interface GraphifyPropertyInfo {
+    /** Field name — present when graphify emits a `defines` node (C++). */
+    name: string;
+    /** Field type from a `references` edge with context `field`. */
+    type?: string;
+    /** Backing edge target for `type`, when the graph had one. */
+    typeRef?: GraphifyReferenceInfo;
+    /** The field's own node id when it exists (e.g. C++ `defines` nodes). */
+    nodeId?: string;
+}
+/**
+ * A single typed parameter of a function (`references` context `parameter_type`).
+ *
+ * `ref.nodeId` is the resolvable half: it targets the type's definition node
+ * when graphify resolved the reference, or a sourceless stub node when the
+ * name was ambiguous / external (see `resolveGraphifyTypeRef`).
+ */
+export interface GraphifyParamInfo {
+    /** Parameter name — not captured by graphify; left undefined. */
+    name?: string;
+    /** Parameter type. */
+    type: string;
+    /** Backing `references[parameter_type|generic_arg]` edge target. */
+    ref?: GraphifyReferenceInfo;
+}
+/** One call relationship, in either direction. */
+export interface GraphifyCallInfo {
+    /** The other endpoint's node id (caller for `callers`, callee for `callees`). */
+    nodeId: string;
+    /** The other endpoint's display label. */
+    name: string;
+    /** `L<line>` of the call site. */
+    source_location?: string;
+}
+/** A type-name reference to a node (`references` edge with a context). */
+export interface GraphifyReferenceInfo {
+    /** The referenced node id. */
+    nodeId: string;
+    /** The referenced node's display label. */
+    name: string;
+    /** Reference context (e.g. `type`, `field`, `generic_arg`, `attribute`). */
+    context?: string;
+    /** `L<line>` of the reference site. */
+    source_location?: string;
+}
+/** An import relationship (`imports` / `imports_from` / `re_exports`). */
+export interface GraphifyImportInfo {
+    /** The imported module/file node id. */
+    nodeId: string;
+    /** The imported module/file label. */
+    name: string;
+    /** Which relation carried the import. */
+    relation?: GraphifyRelation;
+    /** `L<line>` of the import statement. */
+    source_location?: string;
+}
+/** A class-like node: owns outgoing `method` edges. */
+export interface GraphifyClassDetail {
+    kind: 'class';
+    /** Methods connected via `method` edges. */
+    methods: GraphifyMethodInfo[];
+    /** Fields from `defines`/`references` context `field`. */
+    properties: GraphifyPropertyInfo[];
+    /** `inherits` edge targets. */
+    extends: string[];
+    /** `implements` edge targets. */
+    implements: string[];
+    /** Incoming `calls` — graphify models constructor calls as calls into the class. */
+    instantiations: GraphifyCallInfo[];
+    /** Everywhere the type name is referenced (`references` edges). */
+    references: GraphifyReferenceInfo[];
+}
+/** A function-like node: label ends `name()` with no `method` edges. */
+export interface GraphifyFunctionDetail {
+    kind: 'function';
+    /** Parameter types from `references` context `parameter_type`. */
+    parameters: GraphifyParamInfo[];
+    /** Return type from `references` context `return_type`. */
+    returnType?: string;
+    /** Backing edge target for `returnType`, when the graph had one. */
+    returnTypeRef?: GraphifyReferenceInfo;
+    /** Incoming `calls` edges. */
+    callers: GraphifyCallInfo[];
+    /** Outgoing `calls` edges. */
+    callees: GraphifyCallInfo[];
+}
+/** A type-like node (interface/struct): revealed by incoming `implements` edges. */
+export interface GraphifyTypeDetail {
+    kind: 'type';
+    /** Struct/interface fields. */
+    properties: GraphifyPropertyInfo[];
+    /** Nodes referencing this type name. */
+    usedBy: GraphifyReferenceInfo[];
+    /** Nodes that `inherits`/`implements` this type. */
+    implementors: string[];
+}
+/** A module/file-like node: a `contains` target with a filename label. */
+export interface GraphifyModuleDetail {
+    kind: 'module';
+    /** `re_exports` targets / contained public symbols. */
+    exports: string[];
+    /** `imports` / `imports_from` relationships. */
+    imports: GraphifyImportInfo[];
+    /** Symbols contained in the module (`contains` targets). */
+    symbols: string[];
+}
+/** A facet-only component with no graphify node (external consumer stub). */
+export interface GraphifyExternalDetail {
+    kind: 'external';
+    /** Facet-only label; there is no backing graph data. */
+    label: string;
+}
+/**
+ * A retained-state node (`kind: 'store'`): state and its contract, no
+ * behavior. `kind` is the node's verifiable anchor — a store anchors to a
+ * *state location* (module consts, a file or db), not to a declaration.
+ * When a class manages the store's access, that is a SEPARATE node
+ * (`kind: 'class'`, methods = the access mechanism) joined by
+ * `writes`/`reads` — never merged into one hybrid node. This payload
+ * renders as state declarations (`declare const …`), never as a class
+ * stub.
+ */
+export interface GraphifyStoreDetail {
+    kind: 'store';
+    /** The retained state members (module-level consts or class fields). */
+    properties: GraphifyPropertyInfo[];
+}
+/** A standalone method selected from its owning class. */
+export interface GraphifyMethodDetail {
+    kind: 'method';
+    /** The class that owns this method. */
+    hostClass: string;
+    /** Parameter types from `references` context `parameter_type`. */
+    parameters?: GraphifyParamInfo[];
+    /** Return type from `references` context `return_type`. */
+    returnType?: string;
+}
+/**
+ * The drill-down payload for a subsystem component.
+ *
+ * The discriminant is derived from graph structure, not read off the node:
+ * method edges → class; `()` label + no method edges → function; incoming
+ * `implements` → type; else module. `external` covers consumer stubs.
+ * `method` covers standalone method components selected from a class.
+ */
+export type GraphifyComponentDetail = GraphifyClassDetail | GraphifyFunctionDetail | GraphifyMethodDetail | GraphifyTypeDetail | GraphifyModuleDetail | GraphifyExternalDetail | GraphifyStoreDetail;
+/** A raw graphify edge backing a facet claim (verification + provenance). */
+export interface GraphifyEdgeRef {
+    source: string;
+    target: string;
+    relation: GraphifyRelation;
+    confidence: GraphifyConfidence;
+    confidence_score?: number;
+    source_file: string;
+    source_location?: string;
+}
+//# sourceMappingURL=consolidated.d.ts.map

package/dist/graphify/consolidated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidated.d.ts","sourceRoot":"","sources":["../../src/graphify/consolidated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,6DAA6D;AAC7D,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,UAAU,EAAE,wBAAwB,CAAC;IACrC,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,GAAG,CAAC,EAAE,qBAAqB,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,4CAA4C;IAC5C,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,0DAA0D;IAC1D,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oFAAoF;IACpF,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,mEAAmE;IACnE,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,8BAA8B;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,wCAAwC;IACxC,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,oDAAoD;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,wEAAwE;IACxE,UAAU,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAC/B,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,CAAC;AAExB,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/graphify/consolidated.js

@@ -0,0 +1,11 @@
+/**
+ * Graphify consolidated / drill-down types.
+ *
+ * graphify stores the graph in flat, normalized form — class vs function vs
+ * type is NOT a node attribute (every code node is `file_type: "code"`); it is
+ * derived from graph structure. These types rebuild that structure from the raw
+ * edges so a UI can show a drill-down modal for a subsystem component or jump
+ * to its definition file.
+ */
+export {};
+//# sourceMappingURL=consolidated.js.map

package/dist/graphify/consolidated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidated.js","sourceRoot":"","sources":["../../src/graphify/consolidated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/graphify/ids.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Mirror of graphify/ids.py — NFKC + casefold-ish + non-word → `_`.
+ *
+ * Definition node ids are `makeId(fileStem, ...symbolParts)`. Stub ids are
+ * intentionally different (name-only / `ref_…`); this module is for the
+ * definition path used by component anchoring.
+ */
+/** Normalize one id string to graphify's canonical form. */
+export declare function normalizeGraphifyId(s: string): string;
+/** Build a canonical node id from path/symbol parts (graphify `make_id`). */
+export declare function makeGraphifyId(...parts: string[]): string;
+/**
+ * File stem used as the node-id prefix (graphify `_file_stem`):
+ * full path with extension dropped, posix separators.
+ */
+export declare function graphifyFileStem(file: string): string;
+/** Normalize a repo-relative path for source_file comparison. */
+export declare function normalizeSourcePath(file: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/graphify/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/graphify/ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAOzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/graphify/ids.js

@@ -0,0 +1,46 @@
+/**
+ * Mirror of graphify/ids.py — NFKC + casefold-ish + non-word → `_`.
+ *
+ * Definition node ids are `makeId(fileStem, ...symbolParts)`. Stub ids are
+ * intentionally different (name-only / `ref_…`); this module is for the
+ * definition path used by component anchoring.
+ */
+/** Normalize one id string to graphify's canonical form. */
+export function normalizeGraphifyId(s) {
+    let out = s.normalize("NFKC");
+    // JS has no Unicode casefold; lowercasing + second NFKC is close enough
+    // for the Latin/ASCII identifiers we resolve in practice.
+    out = out.toLowerCase().normalize("NFKC");
+    out = out.replace(/[^\w]+/gu, "_");
+    out = out.replace(/_+/g, "_");
+    return out.replace(/^_|_$/g, "");
+}
+/** Build a canonical node id from path/symbol parts (graphify `make_id`). */
+export function makeGraphifyId(...parts) {
+    const joined = parts
+        .filter((p) => typeof p === "string" && p.length > 0)
+        .map((p) => p.replace(/^[_.]+|[_.]+$/g, ""))
+        .filter(Boolean)
+        .join("_");
+    return normalizeGraphifyId(joined);
+}
+/**
+ * File stem used as the node-id prefix (graphify `_file_stem`):
+ * full path with extension dropped, posix separators.
+ */
+export function graphifyFileStem(file) {
+    const posix = file.replace(/\\/g, "/").replace(/^\.\//, "");
+    const lastSlash = posix.lastIndexOf("/");
+    const base = lastSlash >= 0 ? posix.slice(lastSlash + 1) : posix;
+    const dir = lastSlash >= 0 ? posix.slice(0, lastSlash + 1) : "";
+    if (!base || base === ".")
+        return "";
+    const dot = base.lastIndexOf(".");
+    const stemBase = dot > 0 ? base.slice(0, dot) : base;
+    return `${dir}${stemBase}`;
+}
+/** Normalize a repo-relative path for source_file comparison. */
+export function normalizeSourcePath(file) {
+    return file.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+/g, "/");
+}
+//# sourceMappingURL=ids.js.map

package/dist/graphify/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/graphify/ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,wEAAwE;IACxE,0DAA0D;IAC1D,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACnC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,GAAG,KAAe;IAChD,MAAM,MAAM,GAAG,KAAK;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;SAC3C,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,OAAO,GAAG,GAAG,GAAG,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC3E,CAAC"}

package/dist/graphify/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Graphify integration types.
+ *
+ * Type-compatible view of graphify's graph.json data model for consuming
+ * graphify output (nodes, links, hyperedges) inside this library.
+ */
+export type { JsonValue, GraphifyFileType, GraphifyConfidence, GraphifyNodeType, GraphifyRelation, GraphifyNode, GraphifyEdge, GraphifyHyperedge, GraphifyGraphMetadata, GraphifyGraph, } from './types';
+export type { GraphifyAnchorResolution, SubsystemGraphifyAnchor, GraphifyMethodInfo, GraphifyPropertyInfo, GraphifyParamInfo, GraphifyCallInfo, GraphifyReferenceInfo, GraphifyImportInfo, GraphifyClassDetail, GraphifyFunctionDetail, GraphifyTypeDetail, GraphifyModuleDetail, GraphifyExternalDetail, GraphifyStoreDetail, GraphifyComponentDetail, GraphifyEdgeRef, } from './consolidated';
+export type { GraphifyTypeRefStatus, GraphifyTypeRefResolution, } from './resolve';
+export { normalizeGraphifyLabel, createGraphifyTypeResolver, resolveGraphifyTypeRef, } from './resolve';
+export { normalizeGraphifyId, makeGraphifyId, graphifyFileStem, normalizeSourcePath, } from './ids';
+export type { ComponentAnchorInput, ComponentAnchorResult, } from './anchor';
+export { resolveComponentAnchor, symbolLabelVariants, } from './anchor';
+export type { InferredGraphifyKind, InferGraphifyKindResult } from './kind';
+export { inferGraphifyKind, kindsMatch } from './kind';
+export type { GraphifyInferredSignature, ClaimedSignature, SignatureCompareResult, } from './signature';
+export { extractNamedTypes, extractGraphifySignature, compareSignatures, } from './signature';
+//# sourceMappingURL=index.d.ts.map

package/dist/graphify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphify/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,OAAO,CAAC;AACf,YAAY,EACV,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACvD,YAAY,EACV,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/graphify/index.js

@@ -0,0 +1,12 @@
+/**
+ * Graphify integration types.
+ *
+ * Type-compatible view of graphify's graph.json data model for consuming
+ * graphify output (nodes, links, hyperedges) inside this library.
+ */
+export { normalizeGraphifyLabel, createGraphifyTypeResolver, resolveGraphifyTypeRef, } from './resolve';
+export { normalizeGraphifyId, makeGraphifyId, graphifyFileStem, normalizeSourcePath, } from './ids';
+export { resolveComponentAnchor, symbolLabelVariants, } from './anchor';
+export { inferGraphifyKind, kindsMatch } from './kind';
+export { extractNamedTypes, extractGraphifySignature, compareSignatures, } from './signature';
+//# sourceMappingURL=index.js.map

package/dist/graphify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphify/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,OAAO,CAAC;AAKf,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAMvD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/graphify/kind.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Infer a subsystem-style kind from a graphify node + edges.
+ *
+ * Graphify does not store `kind` on nodes (everything is `file_type: "code"`).
+ * Class vs function vs type is derived from structure — same rules as
+ * `GraphifyComponentDetail` in consolidated.ts.
+ */
+import type { GraphifyEdge, GraphifyNode } from './types';
+/** Kind inferred from graph structure (never read off the node). */
+export type InferredGraphifyKind = 'class' | 'function' | 'method' | 'type' | 'module' | 'unknown';
+export interface InferGraphifyKindResult {
+    kind: InferredGraphifyKind;
+    evidence: string[];
+}
+/**
+ * Infer kind for a definition node from its label and incident edges.
+ *
+ * Priority: class → method → function → type → module → unknown.
+ */
+export declare function inferGraphifyKind(node: GraphifyNode, edges: readonly GraphifyEdge[]): InferGraphifyKindResult;
+/** Strict claimed-vs-inferred check, with type-family compatibility. */
+export declare function kindsMatch(claimed: string | undefined, inferred: InferredGraphifyKind): boolean;
+//# sourceMappingURL=kind.d.ts.map

package/dist/graphify/kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind.d.ts","sourceRoot":"","sources":["../../src/graphify/kind.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAC7B,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEb,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAqBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,SAAS,YAAY,EAAE,GAC5B,uBAAuB,CAqDzB;AAOD,wEAAwE;AACxE,wBAAgB,UAAU,CACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,oBAAoB,GAC5B,OAAO,CAIT"}

package/dist/graphify/kind.js

@@ -0,0 +1,77 @@
+/**
+ * Infer a subsystem-style kind from a graphify node + edges.
+ *
+ * Graphify does not store `kind` on nodes (everything is `file_type: "code"`).
+ * Class vs function vs type is derived from structure — same rules as
+ * `GraphifyComponentDetail` in consolidated.ts.
+ */
+const FILE_LABEL_RE = /\.(py|js|jsx|ts|tsx|mjs|cjs|java|go|rs|rb|php|cs|cpp|cc|c|h|hpp|pas|pp|dpr|swift|kt|scala|dart|lua|pl|pm|ex|exs|zig|vue|svelte)$/i;
+function isMethodStyleLabel(label) {
+    return label.trim().startsWith('.');
+}
+function isCallStyleLabel(label) {
+    return label.trim().endsWith('()');
+}
+function isFilenameLabel(label, sourceFile) {
+    const trimmed = label.trim();
+    if (FILE_LABEL_RE.test(trimmed))
+        return true;
+    if (!sourceFile)
+        return false;
+    const base = sourceFile.replace(/\\/g, '/').split('/').pop() ?? '';
+    return !!base && trimmed === base;
+}
+/**
+ * Infer kind for a definition node from its label and incident edges.
+ *
+ * Priority: class → method → function → type → module → unknown.
+ */
+export function inferGraphifyKind(node, edges) {
+    const id = String(node.id);
+    const label = String(node.label ?? '').trim();
+    const sourceFile = typeof node.source_file === 'string' ? node.source_file : '';
+    const evidence = [];
+    const outgoingMethod = edges.filter((e) => String(e.source) === id && e.relation === 'method');
+    if (outgoingMethod.length > 0) {
+        evidence.push(`${outgoingMethod.length} outgoing method edge(s)`);
+        return { kind: 'class', evidence };
+    }
+    const incomingMethod = edges.filter((e) => String(e.target) === id && e.relation === 'method');
+    if (incomingMethod.length > 0 && isMethodStyleLabel(label)) {
+        evidence.push(`incoming method edge from ${String(incomingMethod[0].source)}`, `label ${label}`);
+        return { kind: 'method', evidence };
+    }
+    if (isCallStyleLabel(label)) {
+        evidence.push(`call-style label ${label}`);
+        return { kind: 'function', evidence };
+    }
+    const incomingImplements = edges.filter((e) => String(e.target) === id && e.relation === 'implements');
+    if (incomingImplements.length > 0) {
+        evidence.push(`${incomingImplements.length} incoming implements edge(s)`);
+        return { kind: 'type', evidence };
+    }
+    if (node.type === 'module' || isFilenameLabel(label, sourceFile)) {
+        evidence.push(node.type === 'module'
+            ? 'node.type=module'
+            : `filename label ${label}`);
+        return { kind: 'module', evidence };
+    }
+    if (label)
+        evidence.push(`unclassified label ${label}`);
+    else
+        evidence.push('no classifying signals');
+    return { kind: 'unknown', evidence };
+}
+/** Type-family constructs all infer as the coarse 'type' — graph structure
+ *  (implements/references edges) cannot sub-classify interface vs alias vs
+ *  enum vs variable; only the source declaration can. */
+const TYPE_FAMILY = new Set(['interface', 'type_alias', 'enum']);
+/** Strict claimed-vs-inferred check, with type-family compatibility. */
+export function kindsMatch(claimed, inferred) {
+    if (!claimed || claimed === 'external')
+        return true;
+    if (TYPE_FAMILY.has(claimed))
+        return inferred === 'type';
+    return claimed === inferred;
+}
+//# sourceMappingURL=kind.js.map

package/dist/graphify/kind.js.map

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