@blockml/graph 0.9.1

package/blocks/org/blockml/bml/graph/documentation/PublicApi.bml

@@ -0,0 +1,44 @@
+<!--
+  Graph Documentation — PublicApi
+  FQN: org.blockml.bml.graph.documentation.PublicApi
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>PublicApi</name>
+  <type>graphdocumentation:PublicApi</type>
+  <baseType>core:Documentation</baseType>
+  <is>Exported API from packages/graph/src/index.ts</is>
+  <documentation>buildIndex(options?) → BuildIndexResult
+    buildMemoryIndex(registry, options?) → GraphIndex
+    rebuildIndex(options?) → BuildIndexResult
+    loadIndex(options?) → GraphIndex | undefined
+    getIndexStatus(options?) → IndexStatus
+    openGraph(options?) → BuildIndexResult
+
+    GraphIndex: uses, usedBy, neighbors, ancestors, descendants, path, members, schema, query, block, close.
+    uses/usedBy/neighbors take GraphDepthOptions (default 1 hop). Further hops set GraphNeighbor.source.
+    schema() includes a Ladybug Cypher subset description and example. No type() or shortestPath().
+    path follows outgoing authored edges only. block(fqn) returns the Block node or absent.
+    Ladybug types are not exported.</documentation>
+  <references>
+    <see type="graphcap:BuildIndex" relation="Defines" />
+    <see type="graphcap:Query" relation="Defines" />
+  </references>
+</block>

package/blocks/org/blockml/bml/graph/documentation/ScopeExclusions.bml

@@ -0,0 +1,40 @@
+<!--
+  Graph Documentation — ScopeExclusions
+  FQN: org.blockml.bml.graph.documentation.ScopeExclusions
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>ScopeExclusions</name>
+  <type>graphdocumentation:ScopeExclusions</type>
+  <baseType>core:Documentation</baseType>
+  <is>Explicit out-of-scope for @blockml/graph V1</is>
+  <documentation>Out of scope:
+    • Composition instance / containment graph
+    • Documentation see-also as structural edges
+    • Materialized derived / transitive edges
+    • --direction CLI flag
+    • First-class impact, cycles, subgraph operations
+    • Incremental indexing
+    • Second BML discovery or parser
+    • Exporting Ladybug types on the public API</documentation>
+  <references>
+    <see type="graphdocumentation:Introduction" relation="SeeAlso" />
+  </references>
+</block>

package/blocks/org/blockml/bml/graph/documentation/V1Scope.bml

@@ -0,0 +1,41 @@
+<!--
+  Graph Documentation — V1Scope
+  FQN: org.blockml.bml.graph.documentation.V1Scope
+-->
+<block
+  xmlns="http://blockml.org/bml"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://blockml.org/bml https://blockml.org/schemas/bml.xsd
+                      "
+  xmlns:blockml="org.blockml.bml"
+  xmlns:bom="org.blockml.bml.bom"
+  xmlns:bomapi="org.blockml.bml.bom.api"
+  xmlns:bomcommon="org.blockml.bml.bom.common"
+  xmlns:bomdoc="org.blockml.bml.bom.document"
+  xmlns:core="org.blockml.bml.core"
+  xmlns:def="org.blockml.bml.definition"
+  xmlns:framework="org.blockml.bml.framework"
+  xmlns:fwcap="org.blockml.bml.framework.capability"
+  xmlns:graph="org.blockml.bml.graph"
+  xmlns:graphcap="org.blockml.bml.graph.capability"
+  xmlns:graphdocumentation="org.blockml.bml.graph.documentation"
+  xmlns:type="org.blockml.bml.type">
+
+  <name>V1Scope</name>
+  <type>graphdocumentation:V1Scope</type>
+  <baseType>core:Documentation</baseType>
+  <is>Explicit V1 capabilities</is>
+  <documentation>In scope V1:
+    • Full effective classpath graph (workspace, dependencies, node_modules)
+    • Authored Block and Member nodes
+    • Semantic ops: uses, usedBy, neighbors, ancestors, descendants, path, members
+    • Cypher query escape hatch and schema()
+    • Local persisted index under .blockml/graph/
+    • Auto-build when the index is missing or stale
+    • CLI: blockml graph SUBCOMMAND
+
+    Out of scope: see ScopeExclusions.</documentation>
+  <references>
+    <see type="graphdocumentation:ScopeExclusions" relation="SeeAlso" />
+  </references>
+</block>

package/dist/fingerprint.d.ts

@@ -0,0 +1,27 @@
+export declare const DB_DIR = "lbug";
+export declare const MANIFEST_FILE = "manifest.json";
+export interface FileFingerprint {
+    path: string;
+    mtimeMs: number;
+    size: number;
+}
+export interface IndexManifest {
+    version: number;
+    blocks: number;
+    members: number;
+    packageJsonHash: string;
+    lockfileHash: string;
+    files: FileFingerprint[];
+}
+export declare function defaultIndexDir(rootDir: string): string;
+export declare function resolveIndexDir(rootDir: string, indexDir?: string): string;
+export declare function resolveDbDir(indexDir: string): string;
+export declare function fingerprintProject(rootDir: string): {
+    packageJsonHash: string;
+    lockfileHash: string;
+};
+export declare function fingerprintFiles(filePaths: string[]): FileFingerprint[];
+export declare function buildManifest(rootDir: string, filePaths: string[], blocks: number, members: number): IndexManifest;
+export declare function manifestIsCurrent(manifest: IndexManifest, rootDir: string, srcDir?: string): boolean;
+export declare function readManifest(indexDir: string): IndexManifest | undefined;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAqBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAKA;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAYvE;AAuCD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,aAAa,CAUf;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAmCT;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAUxE"}

package/dist/fingerprint.js

@@ -0,0 +1,146 @@
+import { createHash } from "node:crypto";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { projectSourceRoots } from "@blockml/framework";
+import { INDEX_FORMAT_VERSION } from "./types.js";
+export const DB_DIR = "lbug";
+export const MANIFEST_FILE = "manifest.json";
+export function defaultIndexDir(rootDir) {
+    return join(rootDir, ".blockml", "graph");
+}
+export function resolveIndexDir(rootDir, indexDir) {
+    return indexDir ? resolve(rootDir, indexDir) : defaultIndexDir(rootDir);
+}
+export function resolveDbDir(indexDir) {
+    return join(indexDir, DB_DIR);
+}
+function hashFileOrEmpty(path) {
+    if (!existsSync(path)) {
+        return "";
+    }
+    try {
+        return createHash("sha256").update(readFileSync(path)).digest("hex");
+    }
+    catch {
+        return "";
+    }
+}
+function lockfilePath(rootDir) {
+    const lock = join(rootDir, "package-lock.json");
+    if (existsSync(lock)) {
+        return lock;
+    }
+    return join(rootDir, "npm-shrinkwrap.json");
+}
+export function fingerprintProject(rootDir) {
+    return {
+        packageJsonHash: hashFileOrEmpty(join(rootDir, "package.json")),
+        lockfileHash: hashFileOrEmpty(lockfilePath(rootDir)),
+    };
+}
+export function fingerprintFiles(filePaths) {
+    const unique = [...new Set(filePaths)].sort();
+    const files = [];
+    for (const filePath of unique) {
+        try {
+            const st = statSync(filePath);
+            files.push({ path: filePath, mtimeMs: st.mtimeMs, size: st.size });
+        }
+        catch {
+            files.push({ path: filePath, mtimeMs: 0, size: 0 });
+        }
+    }
+    return files;
+}
+function collectBmlFiles(dir, out = []) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry);
+        try {
+            const st = statSync(full);
+            if (st.isDirectory()) {
+                collectBmlFiles(full, out);
+            }
+            else if (entry.endsWith(".bml")) {
+                out.push(full);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return out;
+}
+function fingerprintsEqual(a, b) {
+    if (a.length !== b.length) {
+        return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+        const left = a[i];
+        const right = b[i];
+        if (left.path !== right.path || left.mtimeMs !== right.mtimeMs || left.size !== right.size) {
+            return false;
+        }
+    }
+    return true;
+}
+export function buildManifest(rootDir, filePaths, blocks, members) {
+    const hashes = fingerprintProject(rootDir);
+    return {
+        version: INDEX_FORMAT_VERSION,
+        blocks,
+        members,
+        packageJsonHash: hashes.packageJsonHash,
+        lockfileHash: hashes.lockfileHash,
+        files: fingerprintFiles(filePaths),
+    };
+}
+export function manifestIsCurrent(manifest, rootDir, srcDir) {
+    if (manifest.version !== INDEX_FORMAT_VERSION) {
+        return false;
+    }
+    const hashes = fingerprintProject(rootDir);
+    if (hashes.packageJsonHash !== manifest.packageJsonHash ||
+        hashes.lockfileHash !== manifest.lockfileHash) {
+        return false;
+    }
+    const currentIndexed = fingerprintFiles(manifest.files.map((file) => file.path));
+    if (!fingerprintsEqual(currentIndexed, manifest.files)) {
+        return false;
+    }
+    const localFiles = new Set();
+    for (const root of projectSourceRoots(rootDir, srcDir)) {
+        for (const file of collectBmlFiles(root)) {
+            localFiles.add(resolve(file));
+        }
+    }
+    const indexedLocal = new Set(manifest.files.map((file) => resolve(file.path)).filter((path) => localFiles.has(path)));
+    if (localFiles.size !== indexedLocal.size) {
+        return false;
+    }
+    for (const file of localFiles) {
+        if (!indexedLocal.has(file)) {
+            return false;
+        }
+    }
+    return true;
+}
+export function readManifest(indexDir) {
+    const path = join(indexDir, MANIFEST_FILE);
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

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

package/dist/graph-index.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic } from "@blockml/bom";
+import type { GraphStore } from "./store.js";
+import type { GraphDepthOptions, GraphIndexHandle, GraphMember, GraphNeighbor, GraphNode, GraphPath, GraphQueryResult, GraphSchema } from "./types.js";
+export declare class GraphIndex implements GraphIndexHandle {
+    readonly diagnostics: Diagnostic[];
+    readonly blocks: number;
+    readonly memberCount: number;
+    readonly filePaths: string[];
+    private readonly store;
+    constructor(store: GraphStore, blocks: number, memberCount: number, filePaths: string[], diagnostics?: Diagnostic[]);
+    uses(fqn: string, options?: GraphDepthOptions): Promise<GraphNeighbor[]>;
+    usedBy(fqn: string, options?: GraphDepthOptions): Promise<GraphNeighbor[]>;
+    neighbors(fqn: string, options?: GraphDepthOptions): Promise<GraphNeighbor[]>;
+    ancestors(fqn: string, options?: GraphDepthOptions): Promise<GraphNode[]>;
+    descendants(fqn: string, options?: GraphDepthOptions): Promise<GraphNode[]>;
+    path(from: string, to: string, options?: GraphDepthOptions): Promise<GraphPath | undefined>;
+    members(fqn: string): Promise<GraphMember[]>;
+    block(fqn: string): Promise<GraphNode | undefined>;
+    schema(): GraphSchema;
+    query(cypher: string, params?: Record<string, unknown>): Promise<GraphQueryResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=graph-index.d.ts.map

package/dist/graph-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-index.d.ts","sourceRoot":"","sources":["../src/graph-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAa/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAW,YAAW,gBAAgB;IACjD,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAGjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,GAAE,UAAU,EAAO;IAShC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIxE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAI1E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAI7E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIzE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI3E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAI3F,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAIlD,MAAM,IAAI,WAAW;IAIrB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvB"}

package/dist/graph-index.js

@@ -0,0 +1,49 @@
+import { ancestors as walkAncestors, descendants as walkDescendants, graphSchema, loadBlock, members as listMembers, neighbors as listNeighbors, runQuery, shortestPath, usedBy as listUsedBy, uses as listUses, } from "./operations.js";
+export class GraphIndex {
+    diagnostics;
+    blocks;
+    memberCount;
+    filePaths;
+    store;
+    constructor(store, blocks, memberCount, filePaths, diagnostics = []) {
+        this.store = store;
+        this.blocks = blocks;
+        this.memberCount = memberCount;
+        this.filePaths = filePaths;
+        this.diagnostics = diagnostics;
+    }
+    uses(fqn, options) {
+        return listUses(this.store, fqn, options?.depth);
+    }
+    usedBy(fqn, options) {
+        return listUsedBy(this.store, fqn, options?.depth);
+    }
+    neighbors(fqn, options) {
+        return listNeighbors(this.store, fqn, options?.depth);
+    }
+    ancestors(fqn, options) {
+        return walkAncestors(this.store, fqn, options?.depth);
+    }
+    descendants(fqn, options) {
+        return walkDescendants(this.store, fqn, options?.depth);
+    }
+    path(from, to, options) {
+        return shortestPath(this.store, from, to, options?.depth);
+    }
+    members(fqn) {
+        return listMembers(this.store, fqn);
+    }
+    block(fqn) {
+        return loadBlock(this.store, fqn);
+    }
+    schema() {
+        return graphSchema();
+    }
+    query(cypher, params) {
+        return runQuery(this.store, cypher, params);
+    }
+    close() {
+        return this.store.close();
+    }
+}
+//# sourceMappingURL=graph-index.js.map

package/dist/graph-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-index.js","sourceRoot":"","sources":["../src/graph-index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,IAAI,aAAa,EAC1B,WAAW,IAAI,eAAe,EAC9B,WAAW,EACX,SAAS,EACT,OAAO,IAAI,WAAW,EACtB,SAAS,IAAI,aAAa,EAC1B,QAAQ,EACR,YAAY,EACZ,MAAM,IAAI,UAAU,EACpB,IAAI,IAAI,QAAQ,GACjB,MAAM,iBAAiB,CAAC;AAazB,MAAM,OAAO,UAAU;IACZ,WAAW,CAAe;IAC1B,MAAM,CAAS;IACf,WAAW,CAAS;IACpB,SAAS,CAAW;IACZ,KAAK,CAAa;IAEnC,YACE,KAAiB,EACjB,MAAc,EACd,WAAmB,EACnB,SAAmB,EACnB,cAA4B,EAAE;QAE9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,OAA2B;QAC3C,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAA2B;QAC7C,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,OAA2B;QAChD,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,OAA2B;QAChD,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,WAAW,CAAC,GAAW,EAAE,OAA2B;QAClD,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,EAAU,EAAE,OAA2B;QACxD,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAW;QACf,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,MAAM;QACJ,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,MAAgC;QACpD,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/graph-lock.d.ts

@@ -0,0 +1,6 @@
+export declare const INDEX_LOCK_FILE = "index.lock";
+export declare function isLadybugLockError(error: unknown): boolean;
+export declare function delay(ms: number): Promise<void>;
+export declare function withLadybugLockRetry<T>(run: () => Promise<T>): Promise<T>;
+export declare function acquireGraphLock(indexDir: string): Promise<() => Promise<void>>;
+//# sourceMappingURL=graph-lock.d.ts.map

package/dist/graph-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-lock.d.ts","sourceRoot":"","sources":["../src/graph-lock.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,eAAe,CAAC;AAM5C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAID,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAc/E;AA2DD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAcrF"}

package/dist/graph-lock.js

@@ -0,0 +1,106 @@
+import { mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export const INDEX_LOCK_FILE = "index.lock";
+const LOCK_WAIT_MS = 120_000;
+const LOCK_POLL_MS = 50;
+const STALE_LOCK_MS = 120_000;
+export function isLadybugLockError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /Could not set lock|Resource temporarily unavailable/i.test(message);
+}
+export function delay(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+const LADYBUG_RETRY_DELAYS_MS = [50, 100, 200, 400, 800, 1600, 3200, 5000, 5000, 5000];
+export async function withLadybugLockRetry(run) {
+    let lastError;
+    for (let attempt = 0; attempt <= LADYBUG_RETRY_DELAYS_MS.length; attempt++) {
+        try {
+            return await run();
+        }
+        catch (error) {
+            lastError = error;
+            if (!isLadybugLockError(error) || attempt === LADYBUG_RETRY_DELAYS_MS.length) {
+                throw error;
+            }
+            await delay(LADYBUG_RETRY_DELAYS_MS[attempt]);
+        }
+    }
+    throw lastError;
+}
+function lockPath(indexDir) {
+    return join(indexDir, INDEX_LOCK_FILE);
+}
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function lockIsStale(path) {
+    try {
+        const text = readFileSync(path, "utf8");
+        const pid = Number(text.split("\n")[0]);
+        if (Number.isInteger(pid) && pid > 0) {
+            return !processAlive(pid);
+        }
+        return Date.now() - statSync(path).mtimeMs > STALE_LOCK_MS;
+    }
+    catch {
+        return true;
+    }
+}
+function tryAcquireFileLock(indexDir) {
+    mkdirSync(indexDir, { recursive: true });
+    const path = lockPath(indexDir);
+    try {
+        writeFileSync(path, `${process.pid}\n${Date.now()}\n`, { flag: "wx" });
+    }
+    catch (error) {
+        const code = error.code;
+        if (code !== "EEXIST") {
+            throw error;
+        }
+        if (lockIsStale(path)) {
+            rmSync(path, { force: true });
+            try {
+                writeFileSync(path, `${process.pid}\n${Date.now()}\n`, { flag: "wx" });
+            }
+            catch {
+                return undefined;
+            }
+        }
+        else {
+            return undefined;
+        }
+    }
+    let released = false;
+    return () => {
+        if (released) {
+            return;
+        }
+        released = true;
+        rmSync(path, { force: true });
+    };
+}
+export async function acquireGraphLock(indexDir) {
+    const started = Date.now();
+    let releaseFile = tryAcquireFileLock(indexDir);
+    while (!releaseFile) {
+        if (Date.now() - started > LOCK_WAIT_MS) {
+            throw new Error("Timed out waiting for the graph index lock.");
+        }
+        await delay(LOCK_POLL_MS + Math.floor(Math.random() * LOCK_POLL_MS));
+        releaseFile = tryAcquireFileLock(indexDir);
+    }
+    const release = releaseFile;
+    return async () => {
+        release();
+    };
+}
+//# sourceMappingURL=graph-lock.js.map

package/dist/graph-lock.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic } from "@blockml/bom";
+import { type TypeRegistry } from "@blockml/framework";
+import { GraphIndex } from "./graph-index.js";
+import type { BuildIndexResult, GraphIndexOptions, IndexStatus } from "./types.js";
+export type { BuildIndexResult, GraphDepthOptions, GraphEdge, GraphIndexHandle, GraphIndexOptions, GraphMember, GraphNeighbor, GraphNode, GraphNodeKind, GraphOrigin, GraphPath, GraphPathHop, GraphQueryResult, GraphQueryRow, GraphRelation, GraphSchema, IndexState, IndexStatus, MemberKind, } from "./types.js";
+export { DEFAULT_GRAPH_DEPTH, DEFAULT_USES_DEPTH, INDEX_FORMAT_VERSION } from "./types.js";
+export { GraphIndex } from "./graph-index.js";
+export { graphDataFromRegistry } from "./mapper.js";
+export { collectNamedTypes } from "./type-refs.js";
+export { defaultIndexDir, resolveIndexDir } from "./fingerprint.js";
+export { graphSchema, GRAPH_RELATIONS, GRAPH_CYPHER_EXAMPLE } from "./schema.js";
+export declare function buildMemoryIndex(registry: TypeRegistry, options?: {
+    rootDir?: string;
+    srcDir?: string;
+    diagnostics?: Diagnostic[];
+}): Promise<GraphIndex>;
+export declare function buildIndex(options?: GraphIndexOptions): Promise<BuildIndexResult>;
+export declare function getIndexStatus(options?: GraphIndexOptions): Promise<IndexStatus>;
+export declare function loadIndex(options?: GraphIndexOptions): Promise<GraphIndex | undefined>;
+export declare function rebuildIndex(options?: GraphIndexOptions): Promise<BuildIndexResult>;
+export declare function openGraph(options?: GraphIndexOptions): Promise<BuildIndexResult>;
+export type { GraphIndexHandle as Graph } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASrF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAsBjF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;CAAO,GAC9E,OAAO,CAAC,UAAU,CAAC,CAkBrB;AAED,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc3F;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiB1F;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAiBhG;AA4CD,wBAAsB,YAAY,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAW7F;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAqB1F;AAED,YAAY,EAAE,gBAAgB,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC"}