@dewtech/dare-cli 3.8.2 → 3.10.0

package/dist/graphrag/__tests__/requirement-hash.test.js

@@ -0,0 +1,74 @@
+import { createHash } from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { JsonGraph } from '../json-graph.js';
+import { ingestRequirements } from '../requirement-ingest.js';
+const cleanupRoots = [];
+async function ingestAndGetRequirement(content, ingestedAt) {
+    const projectRoot = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'req-hash-'));
+    cleanupRoots.push(projectRoot);
+    await fs.promises.mkdir(path.join(projectRoot, 'DARE'));
+    await fs.promises.writeFile(path.join(projectRoot, 'DARE', 'BLUEPRINT-sample.md'), content, 'utf8');
+    const graph = new JsonGraph(path.join(projectRoot, '.dare', 'graph.json'));
+    await graph.init();
+    ingestRequirements(graph, projectRoot, { ingestedAt });
+    const node = graph.getNode('requirement:RF-01');
+    graph.close();
+    return node;
+}
+describe('requirement-hash', () => {
+    afterEach(async () => {
+        for (const root of cleanupRoots.splice(0, cleanupRoots.length)) {
+            await fs.promises.rm(root, { recursive: true, force: true });
+        }
+    });
+    it('writes_contentHash_on_requirement', async () => {
+        const fixedIngestedAt = '2026-01-01T00:00:00.000Z';
+        const content = `
+| ID | Requirement |
+| --- | --- |
+| RF-01 | Auth MUST |
+`;
+        const node = await ingestAndGetRequirement(content, fixedIngestedAt);
+        const metadata = node?.metadata;
+        const expectedHash = createHash('sha256').update('Auth MUST').digest('hex');
+        expect(metadata?.contentHash).toBe(expectedHash);
+        expect(metadata?.ingestedAt).toBe(fixedIngestedAt);
+    });
+    it('hash_is_stable', async () => {
+        const content = `
+| ID | Requirement |
+| --- | --- |
+| RF-01 | Deterministic text |
+`;
+        const firstNode = await ingestAndGetRequirement(content, '2026-01-01T00:00:00.000Z');
+        const secondNode = await ingestAndGetRequirement(content, '2026-01-02T00:00:00.000Z');
+        const firstHash = firstNode?.metadata?.contentHash;
+        const secondHash = secondNode?.metadata?.contentHash;
+        expect(firstHash).toBeTruthy();
+        expect(secondHash).toBeTruthy();
+        expect(firstHash).toBe(secondHash);
+    });
+    it('hash_changes_with_text', async () => {
+        const firstContent = `
+| ID | Requirement |
+| --- | --- |
+| RF-01 | Requirement text A |
+`;
+        const secondContent = `
+| ID | Requirement |
+| --- | --- |
+| RF-01 | Requirement text B |
+`;
+        const firstNode = await ingestAndGetRequirement(firstContent);
+        const secondNode = await ingestAndGetRequirement(secondContent);
+        const firstHash = firstNode?.metadata?.contentHash;
+        const secondHash = secondNode?.metadata?.contentHash;
+        expect(firstHash).toBeTruthy();
+        expect(secondHash).toBeTruthy();
+        expect(firstHash).not.toBe(secondHash);
+    });
+});
+//# sourceMappingURL=requirement-hash.test.js.map

package/dist/graphrag/__tests__/requirement-hash.test.js.map

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

package/dist/graphrag/__tests__/semantic-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=semantic-config.test.d.ts.map

package/dist/graphrag/__tests__/semantic-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-config.test.d.ts","sourceRoot":"","sources":["../../../src/graphrag/__tests__/semantic-config.test.ts"],"names":[],"mappings":""}

package/dist/graphrag/__tests__/semantic-config.test.js

@@ -0,0 +1,39 @@
+import { describe, expect, it } from 'vitest';
+import { defaultSemanticConfigForProject, parseSemanticConfig, SemanticConfigError, } from '../../verification/config.js';
+describe('parseSemanticConfig', () => {
+    it('defaults_when_absent', () => {
+        expect(parseSemanticConfig({})).toEqual(defaultSemanticConfigForProject());
+        expect(parseSemanticConfig(undefined).enabled).toBe(false);
+        expect(parseSemanticConfig(undefined).rrfK).toBe(60);
+    });
+    it('parses_full_block', () => {
+        const cfg = parseSemanticConfig({
+            graphrag: {
+                backend: 'sqlite',
+                semantic: {
+                    enabled: true,
+                    model: 'all-MiniLM-L12-v2',
+                    modelHash: 'sha256:abc123',
+                    rrfK: 75,
+                },
+            },
+        });
+        expect(cfg.enabled).toBe(true);
+        expect(cfg.model).toBe('all-MiniLM-L12-v2');
+        expect(cfg.modelHash).toBe('sha256:abc123');
+        expect(cfg.rrfK).toBe(75);
+    });
+    it('rejects_non_positive_rrfK', () => {
+        expect(() => parseSemanticConfig({
+            graphrag: {
+                semantic: { rrfK: 0 },
+            },
+        })).toThrow(SemanticConfigError);
+        expect(() => parseSemanticConfig({
+            graphrag: {
+                semantic: { rrfK: -1 },
+            },
+        })).toThrow(SemanticConfigError);
+    });
+});
+//# sourceMappingURL=semantic-config.test.js.map

package/dist/graphrag/__tests__/semantic-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-config.test.js","sourceRoot":"","sources":["../../../src/graphrag/__tests__/semantic-config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AAEtC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,GAAG,GAAG,mBAAmB,CAAC;YAC9B,QAAQ,EAAE;gBACR,OAAO,EAAE,QAAQ;gBACjB,QAAQ,EAAE;oBACR,OAAO,EAAE,IAAI;oBACb,KAAK,EAAE,mBAAmB;oBAC1B,SAAS,EAAE,eAAe;oBAC1B,IAAI,EAAE,EAAE;iBACT;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,EAAE,CACV,mBAAmB,CAAC;YAClB,QAAQ,EAAE;gBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;aACtB;SACF,CAAC,CACH,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAE/B,MAAM,CAAC,GAAG,EAAE,CACV,mBAAmB,CAAC;YAClB,QAAQ,EAAE;gBACR,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACvB;SACF,CAAC,CACH,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/graphrag/__tests__/vector-persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector-persistence.test.d.ts.map

package/dist/graphrag/__tests__/vector-persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-persistence.test.d.ts","sourceRoot":"","sources":["../../../src/graphrag/__tests__/vector-persistence.test.ts"],"names":[],"mappings":""}

package/dist/graphrag/__tests__/vector-persistence.test.js

@@ -0,0 +1,112 @@
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'fs-extra';
+import { describe, expect, it } from 'vitest';
+import { GraphRAG } from '../graph-rag.js';
+import { JsonGraph } from '../json-graph.js';
+const BACKENDS = [
+    { name: 'sqlite', extension: 'db', create: (filePath) => new GraphRAG(filePath) },
+    { name: 'json', extension: 'json', create: (filePath) => new JsonGraph(filePath) },
+];
+function tempPath(prefix, extension) {
+    const suffix = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    return path.join(os.tmpdir(), `${prefix}-${suffix}.${extension}`);
+}
+function expectVectorClose(actual, expected) {
+    expect(actual.length).toBe(expected.length);
+    for (let index = 0; index < expected.length; index++) {
+        expect(actual[index]).toBeCloseTo(expected[index] ?? 0, 5);
+    }
+}
+describe('vector-persistence', () => {
+    it('roundtrip_float32', async () => {
+        const expected = [0.125, -2.5, Math.PI, 42.25];
+        for (const backend of BACKENDS) {
+            const filePath = tempPath(`vector-roundtrip-${backend.name}`, backend.extension);
+            const graph = backend.create(filePath);
+            try {
+                await graph.init();
+                graph.addNode({
+                    id: `concept:${backend.name}-vector`,
+                    type: 'concept',
+                    label: `vector-${backend.name}`,
+                    vector: expected,
+                });
+                await Promise.resolve(graph.close());
+                const reopened = backend.create(filePath);
+                try {
+                    await reopened.init();
+                    const vectors = reopened.loadVectors();
+                    expect(vectors).toHaveLength(1);
+                    expect(vectors[0]?.id).toBe(`concept:${backend.name}-vector`);
+                    expectVectorClose(vectors[0].v, expected);
+                }
+                finally {
+                    await Promise.resolve(reopened.close());
+                }
+            }
+            finally {
+                await fs.remove(filePath).catch(() => undefined);
+            }
+        }
+    });
+    it('node_without_vector_is_valid', async () => {
+        for (const backend of BACKENDS) {
+            const filePath = tempPath(`vector-compat-${backend.name}`, backend.extension);
+            const graph = backend.create(filePath);
+            try {
+                await graph.init();
+                graph.addNode({
+                    id: `task:${backend.name}-legacy`,
+                    type: 'task',
+                    label: 'legacy-node',
+                });
+                expect(graph.getNode(`task:${backend.name}-legacy`)).not.toBeNull();
+                expect(graph.loadVectors()).toEqual([]);
+            }
+            finally {
+                await Promise.resolve(graph.close());
+                await fs.remove(filePath).catch(() => undefined);
+            }
+        }
+    });
+    it('export_import_preserves_vector', async () => {
+        const sourcePath = tempPath('vector-export-source', 'db');
+        const targetPath = tempPath('vector-export-target', 'json');
+        const expected = [0.5, 1.5, -3.25];
+        const source = new GraphRAG(sourcePath);
+        const target = new JsonGraph(targetPath);
+        try {
+            await source.init();
+            source.addNode({
+                id: 'concept:portable-vector',
+                type: 'concept',
+                label: 'portable',
+                vector: expected,
+            });
+            source.addNode({
+                id: 'task:without-vector',
+                type: 'task',
+                label: 'no-vector',
+            });
+            const exported = source.exportToJson();
+            await target.init();
+            target.importFromJson(exported);
+            const restored = target.getNode('concept:portable-vector');
+            expect(restored).not.toBeNull();
+            expect(Array.isArray(restored?.vector)).toBe(true);
+            expectVectorClose(new Float32Array(restored?.vector ?? []), expected);
+            const vectors = target.loadVectors();
+            expect(vectors).toHaveLength(1);
+            expect(vectors[0]?.id).toBe('concept:portable-vector');
+            expectVectorClose(vectors[0].v, expected);
+        }
+        finally {
+            await Promise.resolve(source.close());
+            await Promise.resolve(target.close());
+            await fs.remove(sourcePath).catch(() => undefined);
+            await fs.remove(targetPath).catch(() => undefined);
+        }
+    });
+});
+//# sourceMappingURL=vector-persistence.test.js.map

package/dist/graphrag/__tests__/vector-persistence.test.js.map

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

package/dist/graphrag/__tests__/vector-search.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vector-search.test.d.ts.map

package/dist/graphrag/__tests__/vector-search.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search.test.d.ts","sourceRoot":"","sources":["../../../src/graphrag/__tests__/vector-search.test.ts"],"names":[],"mappings":""}

package/dist/graphrag/__tests__/vector-search.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { cosine, cosineTopK } from '../vector-search.js';
+describe('vector-search', () => {
+    it('cosine_known_values', () => {
+        const orthogonal = cosine(new Float32Array([1, 0]), new Float32Array([0, 1]));
+        const identical = cosine(new Float32Array([1, 2, 3]), new Float32Array([1, 2, 3]));
+        expect(orthogonal).toBe(0);
+        expect(identical).toBeCloseTo(1, 10);
+    });
+    it('topK_orders_desc', () => {
+        const query = new Float32Array([1, 0]);
+        const ranked = cosineTopK(query, [
+            { id: 'c', v: new Float32Array([0, 1]) },
+            { id: 'a', v: new Float32Array([1, 0]) },
+            { id: 'b', v: new Float32Array([0.8, 0.2]) },
+            { id: 'd', v: new Float32Array([-1, 0]) },
+        ], 3);
+        expect(ranked.map((item) => item.id)).toEqual(['a', 'b', 'c']);
+        expect(ranked[0]?.score).toBeGreaterThanOrEqual(ranked[1]?.score ?? -Infinity);
+        expect(ranked[1]?.score).toBeGreaterThanOrEqual(ranked[2]?.score ?? -Infinity);
+    });
+    it('topK_stable_on_ties', () => {
+        const query = new Float32Array([1, 0]);
+        const ranked = cosineTopK(query, [
+            { id: 'first', v: new Float32Array([2, 0]) },
+            { id: 'second', v: new Float32Array([3, 0]) },
+            { id: 'third', v: new Float32Array([0, 1]) },
+        ], 2);
+        expect(ranked.map((item) => item.id)).toEqual(['first', 'second']);
+    });
+    it('mismatched_dim_throws', () => {
+        expect(() => cosine(new Float32Array([1, 2]), new Float32Array([1, 2, 3]))).toThrow(/dimensions must match/i);
+        expect(() => cosineTopK(new Float32Array([1, 2]), [{ id: 'bad', v: new Float32Array([1, 2, 3]) }], 1)).toThrow(/dimensions must match/i);
+    });
+});
+//# sourceMappingURL=vector-search.test.js.map

package/dist/graphrag/__tests__/vector-search.test.js.map

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

package/dist/graphrag/drift.d.ts

@@ -0,0 +1,22 @@
+import type { KnowledgeGraph } from './knowledge-graph.js';
+export type DriftKind = 'orphan-requirement' | 'orphan-code' | 'stale';
+export interface DriftFinding {
+    readonly kind: DriftKind;
+    readonly nodeId: string;
+    readonly label: string;
+    readonly detail: string;
+}
+export interface DriftReport {
+    readonly findings: ReadonlyArray<DriftFinding>;
+    readonly counts: Record<DriftKind, number>;
+    readonly staleIndeterminate: number;
+}
+export interface DriftConfig {
+    readonly enabled: boolean;
+    readonly maxOrphanReqs: number;
+    readonly maxOrphanCode: number;
+    readonly failOnStale: boolean;
+    readonly ignore: ReadonlyArray<string>;
+}
+export declare function detectDrift(graph: KnowledgeGraph, cfg: DriftConfig): DriftReport;
+//# sourceMappingURL=drift.d.ts.map

package/dist/graphrag/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/graphrag/drift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAEjF,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG,aAAa,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AASD,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,WAAW,CA2EhF"}

package/dist/graphrag/drift.js

@@ -0,0 +1,204 @@
+const QUERY_LIMIT = 1000000;
+export function detectDrift(graph, cfg) {
+    if (!cfg.enabled) {
+        return {
+            findings: [],
+            counts: createCounts(),
+            staleIndeterminate: 0,
+        };
+    }
+    const findings = [];
+    const counts = createCounts();
+    let staleIndeterminate = 0;
+    const requirements = sortNodes(graph.queryNodes('requirement', QUERY_LIMIT));
+    const codeSymbols = sortNodes(graph.queryNodes('code_symbol', QUERY_LIMIT));
+    const ignoreGlobs = [...cfg.ignore].sort();
+    for (const requirement of requirements) {
+        const links = linkedCodeToRequirement(graph, requirement.id);
+        if (links.length === 0) {
+            pushFinding(findings, counts, {
+                kind: 'orphan-requirement',
+                nodeId: requirement.id,
+                label: requirement.label,
+                detail: `requirement ${requirement.id} has no incoming implements/affects edge from code_symbol`,
+            });
+            continue;
+        }
+        const reqHash = readString(requirement.metadata, 'contentHash');
+        if (!reqHash) {
+            staleIndeterminate += 1;
+            continue;
+        }
+        const reqTimestamp = firstValidTimestamp([
+            readString(requirement.metadata, 'ingestedAt'),
+            readString(requirement.metadata, 'updatedAt'),
+            requirement.updatedAt,
+            requirement.createdAt,
+        ]);
+        const staleCause = findStaleCause(reqHash, reqTimestamp, links);
+        if (staleCause) {
+            pushFinding(findings, counts, {
+                kind: 'stale',
+                nodeId: requirement.id,
+                label: requirement.label,
+                detail: staleCause,
+            });
+        }
+    }
+    for (const symbol of codeSymbols) {
+        if (isIgnored(symbol, ignoreGlobs))
+            continue;
+        if (hasRequirementImplementsEdge(graph, symbol.id))
+            continue;
+        pushFinding(findings, counts, {
+            kind: 'orphan-code',
+            nodeId: symbol.id,
+            label: symbol.label,
+            detail: `code_symbol ${symbol.id} has no outgoing implements edge to requirement`,
+        });
+    }
+    const sortedFindings = [...findings].sort((a, b) => {
+        if (a.kind !== b.kind)
+            return a.kind.localeCompare(b.kind);
+        if (a.nodeId !== b.nodeId)
+            return a.nodeId.localeCompare(b.nodeId);
+        return a.detail.localeCompare(b.detail);
+    });
+    return {
+        findings: sortedFindings,
+        counts,
+        staleIndeterminate,
+    };
+}
+function createCounts() {
+    return {
+        'orphan-requirement': 0,
+        'orphan-code': 0,
+        stale: 0,
+    };
+}
+function pushFinding(findings, counts, finding) {
+    findings.push(finding);
+    counts[finding.kind] += 1;
+}
+function sortNodes(nodes) {
+    return [...nodes].sort((a, b) => {
+        if (a.id !== b.id)
+            return a.id.localeCompare(b.id);
+        return a.label.localeCompare(b.label);
+    });
+}
+function linkedCodeToRequirement(graph, requirementId) {
+    const incoming = graph.getEdges(requirementId, 'in');
+    const links = [];
+    for (const edge of incoming) {
+        if (edge.type !== 'implements' && edge.type !== 'affects')
+            continue;
+        const source = graph.getNode(edge.sourceId);
+        if (!source || source.type !== 'code_symbol')
+            continue;
+        links.push({ edge, codeNode: source });
+    }
+    return links.sort((a, b) => {
+        if (a.codeNode.id !== b.codeNode.id)
+            return a.codeNode.id.localeCompare(b.codeNode.id);
+        return a.edge.id.localeCompare(b.edge.id);
+    });
+}
+function hasRequirementImplementsEdge(graph, codeSymbolId) {
+    const outgoing = graph.getEdges(codeSymbolId, 'out');
+    for (const edge of outgoing) {
+        if (edge.type !== 'implements')
+            continue;
+        const target = graph.getNode(edge.targetId);
+        if (target?.type === 'requirement')
+            return true;
+    }
+    return false;
+}
+function isIgnored(codeNode, globs) {
+    if (globs.length === 0)
+        return false;
+    const candidates = normalizeCandidates([
+        codeNode.id,
+        codeNode.label,
+        readString(codeNode.metadata, 'path'),
+        readString(codeNode.metadata, 'qualifiedName'),
+    ]);
+    for (const glob of globs) {
+        const regex = globToRegExp(glob);
+        if (candidates.some((candidate) => regex.test(candidate)))
+            return true;
+    }
+    return false;
+}
+function normalizeCandidates(candidates) {
+    return candidates
+        .filter((value) => typeof value === 'string' && value.length > 0)
+        .map((value) => value.replace(/\\/g, '/'));
+}
+function globToRegExp(glob) {
+    const normalized = glob.replace(/\\/g, '/');
+    const escaped = normalized.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    const pattern = escaped
+        .replace(/\*\*\/?/g, '§§§')
+        .replace(/\*/g, '[^/]*')
+        .replace(/§§§/g, '.*');
+    return new RegExp(`^${pattern}$`);
+}
+function findStaleCause(requirementHash, requirementTimestamp, links) {
+    for (const link of links) {
+        const codeSymbol = codeSymbolLabel(link.codeNode);
+        const recordedRequirementHash = firstPresentString([
+            readString(link.edge.metadata, 'requirementContentHash'),
+            readString(link.codeNode.metadata, 'requirementContentHash'),
+            readString(link.codeNode.metadata, 'reqContentHash'),
+        ]);
+        if (recordedRequirementHash && recordedRequirementHash !== requirementHash) {
+            return `requirement hash differs from code snapshot on ${codeSymbol}`;
+        }
+        if (requirementTimestamp === undefined)
+            continue;
+        const codeTimestamp = firstValidTimestamp([
+            readString(link.codeNode.metadata, 'ingestedAt'),
+            readString(link.codeNode.metadata, 'indexedAt'),
+            readString(link.codeNode.metadata, 'updatedAt'),
+            readString(link.codeNode.metadata, 'mtime'),
+            readString(link.codeNode.metadata, 'modifiedAt'),
+            link.codeNode.updatedAt,
+            link.codeNode.createdAt,
+        ]);
+        if (codeTimestamp !== undefined && requirementTimestamp > codeTimestamp) {
+            return `requirement changed after code snapshot on ${codeSymbol}`;
+        }
+    }
+    return null;
+}
+function codeSymbolLabel(node) {
+    return (readString(node.metadata, 'qualifiedName') ??
+        readString(node.metadata, 'path') ??
+        node.label ??
+        node.id);
+}
+function firstPresentString(values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+function readString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function firstValidTimestamp(values) {
+    for (const value of values) {
+        if (!value)
+            continue;
+        const parsed = Date.parse(value);
+        if (!Number.isNaN(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+//# sourceMappingURL=drift.js.map

package/dist/graphrag/drift.js.map

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

package/dist/graphrag/embeddings.d.ts

@@ -0,0 +1,15 @@
+export interface SemanticConfig {
+    readonly model: string;
+    readonly modelHash: string;
+    readonly runtimePackage?: string;
+}
+export interface Embedder {
+    readonly dim: number;
+    embed(text: string): Promise<Float32Array>;
+}
+export declare class EmbeddingModelMissingError extends Error {
+    readonly code: "EMBEDDING_MODEL_MISSING";
+    constructor(runtimePackage?: string);
+}
+export declare function loadEmbedder(cfg: SemanticConfig): Promise<Embedder>;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/graphrag/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/graphrag/embeddings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAG,yBAAyB,CAAU;gBAEvC,cAAc,SAA0B;CAMrD;AA0HD,wBAAsB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAezE"}