@co-engram/core 0.1.0

package/dist/importance/vector.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 多维重要性（spec §8 字段表：personal/team/project/network/temporal/composite）
+ *
+ * 五维独立追踪 + composite 加权聚合：
+ *   - personal: 个人相关性（手动设置或系统派生）
+ *   - team: 团队相关性（手动设置）
+ *   - project: 项目相关性（手动设置）
+ *   - network: 网络中心性（由 incomingSynapseCount 派生）
+ *   - temporal: 时效性（由 lastEffectiveAt + decayHalfLifeDays 派生，艾宾浩斯衰退）
+ *   - composite: 加权聚合，写入 engram.importance（检索公式消费此值）
+ *
+ * 默认权重（spec §9 决策 9 派生）：
+ *   personal 0.20 + team 0.25 + project 0.25 + network 0.15 + temporal 0.15 = 1.00
+ *
+ * 神经科学依据：
+ *   - personal/temporal 类似情景记忆（episodic）显著性
+ *   - team/project 类似语义记忆（semantic）共识权重
+ *   - network 类似突触强度（Hebbian：连接越多越重要）
+ *
+ * @module @co-engram/core/importance
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { ImportanceVector } from "../types/engram.js";
+/** 五维权重（和必须为 1） */
+export interface ImportanceWeights {
+    readonly personal: number;
+    readonly team: number;
+    readonly project: number;
+    readonly network: number;
+    readonly temporal: number;
+}
+/** 默认权重（spec §9 决策 9 派生） */
+export declare const DEFAULT_IMPORTANCE_WEIGHTS: ImportanceWeights;
+/**
+ * 校验权重和为 1（容差 0.001）
+ */
+export declare function validateImportanceWeights(w: ImportanceWeights): void;
+/**
+ * 派生 network 维度（网络中心性）
+ *
+ * `network = min(1, incomingSynapseCount / SATURATION)`
+ *
+ * 饱和点默认 10：达到 10 条入边即视为高中心性。
+ */
+export declare function deriveNetworkImportance(incomingSynapseCount: number, saturation?: number): number;
+/**
+ * 派生 temporal 维度（艾宾浩斯衰退）
+ *
+ * `temporal = recencyDecay(ageDays, decayHalfLifeDays)`
+ *
+ * - decayHalfLifeDays=null → 1（永不衰退）
+ * - 从未 lastEffectiveAt → 0（年龄无穷大）
+ */
+export declare function deriveTemporalImportance(lastEffectiveAt: string | null | undefined, decayHalfLifeDays: number | null, now: Date): number;
+/**
+ * 计算复合重要性
+ *
+ * `composite = Σ w_i · v_i`（截断到 [0,1]）
+ */
+export declare function compositeImportance(v: Omit<ImportanceVector, "composite">, weights?: ImportanceWeights): number;
+/**
+ * 构造默认 ImportanceVector（全 0.5 + composite 0.5）
+ *
+ * 用于未调用 recomputeImportance 的老数据。
+ */
+export declare function defaultImportanceVector(): ImportanceVector;
+export interface RecomputeImportanceOptions {
+    /** 手动覆盖 personal/team/project（network/temporal 永远派生） */
+    readonly overrides?: Partial<Pick<ImportanceVector, "personal" | "team" | "project">>;
+    /** 自定义权重（默认 DEFAULT_IMPORTANCE_WEIGHTS） */
+    readonly weights?: ImportanceWeights;
+    /** 当前时间（测试用，默认 new Date()） */
+    readonly now?: Date;
+    /** 是否写回 meta.yaml（默认 true） */
+    readonly persist?: boolean;
+    /** 调用者标识（persist=true 时写入 updatedBy） */
+    readonly updatedBy?: string;
+}
+export interface RecomputeImportanceResult {
+    readonly id: string;
+    readonly previous: ImportanceVector | undefined;
+    readonly next: ImportanceVector;
+    readonly previousScalarImportance: number;
+    readonly nextScalarImportance: number;
+    readonly persisted: boolean;
+}
+/**
+ * 重新计算 engram 的多维重要性
+ *
+ * 1. 读取当前 engram + 已有 importanceVector（若有）
+ * 2. network/temporal 派生（不受 overrides 影响）
+ * 3. personal/team/project 用 overrides，否则保留原值或默认 0.5
+ * 4. 算 composite
+ * 5. 持久化：更新 meta.importanceVector + meta.importance = composite
+ */
+export declare function recomputeImportance(repo: EngramRepository, id: string, options?: RecomputeImportanceOptions): RecomputeImportanceResult;
+/**
+ * 批量重算（Deep Dreaming / 定期任务调用）
+ *
+ * 稳定扫描：按 id 字典序。
+ */
+export interface BatchRecomputeResult {
+    readonly scanned: number;
+    readonly recomputed: number;
+    readonly skipped: ReadonlyArray<{
+        id: string;
+        reason: string;
+    }>;
+}
+export declare function recomputeImportanceBatch(repo: EngramRepository, options?: Omit<RecomputeImportanceOptions, "overrides"> & {
+    readonly overrides?: (engramId: string) => Partial<Pick<ImportanceVector, "personal" | "team" | "project">> | undefined;
+}): BatchRecomputeResult;
+//# sourceMappingURL=vector.d.ts.map

package/dist/importance/vector.d.ts.map

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

package/dist/importance/vector.js

@@ -0,0 +1,202 @@
+/**
+ * 多维重要性（spec §8 字段表：personal/team/project/network/temporal/composite）
+ *
+ * 五维独立追踪 + composite 加权聚合：
+ *   - personal: 个人相关性（手动设置或系统派生）
+ *   - team: 团队相关性（手动设置）
+ *   - project: 项目相关性（手动设置）
+ *   - network: 网络中心性（由 incomingSynapseCount 派生）
+ *   - temporal: 时效性（由 lastEffectiveAt + decayHalfLifeDays 派生，艾宾浩斯衰退）
+ *   - composite: 加权聚合，写入 engram.importance（检索公式消费此值）
+ *
+ * 默认权重（spec §9 决策 9 派生）：
+ *   personal 0.20 + team 0.25 + project 0.25 + network 0.15 + temporal 0.15 = 1.00
+ *
+ * 神经科学依据：
+ *   - personal/temporal 类似情景记忆（episodic）显著性
+ *   - team/project 类似语义记忆（semantic）共识权重
+ *   - network 类似突触强度（Hebbian：连接越多越重要）
+ *
+ * @module @co-engram/core/importance
+ */
+import { recencyDecay } from "../retrieval/scoring.js";
+/** 默认权重（spec §9 决策 9 派生） */
+export const DEFAULT_IMPORTANCE_WEIGHTS = {
+    personal: 0.2,
+    team: 0.25,
+    project: 0.25,
+    network: 0.15,
+    temporal: 0.15,
+};
+/** network 派生：incomingSynapseCount ≥ 此阈值时 network=1 */
+const NETWORK_SATURATION_INCOMING = 10;
+/**
+ * 校验权重和为 1（容差 0.001）
+ */
+export function validateImportanceWeights(w) {
+    const sum = w.personal + w.team + w.project + w.network + w.temporal;
+    if (Math.abs(sum - 1) > 0.001) {
+        throw new Error(`Importance weights must sum to 1, got ${sum} (p=${w.personal} t=${w.team} pr=${w.project} n=${w.network} te=${w.temporal})`);
+    }
+    for (const [name, v] of [
+        ["personal", w.personal],
+        ["team", w.team],
+        ["project", w.project],
+        ["network", w.network],
+        ["temporal", w.temporal],
+    ]) {
+        if (v < 0 || v > 1) {
+            throw new Error(`Importance weight ${name} must be in [0,1], got ${v}`);
+        }
+    }
+}
+function clamp01(x) {
+    if (Number.isNaN(x))
+        return 0;
+    if (x < 0)
+        return 0;
+    if (x > 1)
+        return 1;
+    return x;
+}
+/**
+ * 派生 network 维度（网络中心性）
+ *
+ * `network = min(1, incomingSynapseCount / SATURATION)`
+ *
+ * 饱和点默认 10：达到 10 条入边即视为高中心性。
+ */
+export function deriveNetworkImportance(incomingSynapseCount, saturation = NETWORK_SATURATION_INCOMING) {
+    if (saturation <= 0)
+        return 0;
+    return clamp01(incomingSynapseCount / saturation);
+}
+/**
+ * 派生 temporal 维度（艾宾浩斯衰退）
+ *
+ * `temporal = recencyDecay(ageDays, decayHalfLifeDays)`
+ *
+ * - decayHalfLifeDays=null → 1（永不衰退）
+ * - 从未 lastEffectiveAt → 0（年龄无穷大）
+ */
+export function deriveTemporalImportance(lastEffectiveAt, decayHalfLifeDays, now) {
+    if (!lastEffectiveAt)
+        return 0;
+    const ts = new Date(lastEffectiveAt).getTime();
+    if (Number.isNaN(ts))
+        return 0;
+    const ageMs = now.getTime() - ts;
+    const ageDays = ageMs < 0 ? 0 : ageMs / (1000 * 60 * 60 * 24);
+    return recencyDecay(ageDays, decayHalfLifeDays);
+}
+/**
+ * 计算复合重要性
+ *
+ * `composite = Σ w_i · v_i`（截断到 [0,1]）
+ */
+export function compositeImportance(v, weights = DEFAULT_IMPORTANCE_WEIGHTS) {
+    validateImportanceWeights(weights);
+    const raw = weights.personal * v.personal +
+        weights.team * v.team +
+        weights.project * v.project +
+        weights.network * v.network +
+        weights.temporal * v.temporal;
+    return clamp01(raw);
+}
+/**
+ * 构造默认 ImportanceVector（全 0.5 + composite 0.5）
+ *
+ * 用于未调用 recomputeImportance 的老数据。
+ */
+export function defaultImportanceVector() {
+    return {
+        personal: 0.5,
+        team: 0.5,
+        project: 0.5,
+        network: 0,
+        temporal: 0,
+        composite: 0.5,
+    };
+}
+/**
+ * 重新计算 engram 的多维重要性
+ *
+ * 1. 读取当前 engram + 已有 importanceVector（若有）
+ * 2. network/temporal 派生（不受 overrides 影响）
+ * 3. personal/team/project 用 overrides，否则保留原值或默认 0.5
+ * 4. 算 composite
+ * 5. 持久化：更新 meta.importanceVector + meta.importance = composite
+ */
+export function recomputeImportance(repo, id, options = {}) {
+    if (!repo.exists(id)) {
+        throw new Error(`Engram not found: ${id}`);
+    }
+    const engram = repo.readEngram(id);
+    const weights = options.weights ?? DEFAULT_IMPORTANCE_WEIGHTS;
+    const now = options.now ?? new Date();
+    const persist = options.persist ?? true;
+    const prevVector = engram.importanceVector;
+    const prevScalar = engram.importance;
+    const personal = options.overrides?.personal ?? prevVector?.personal ?? 0.5;
+    const team = options.overrides?.team ?? prevVector?.team ?? 0.5;
+    const project = options.overrides?.project ?? prevVector?.project ?? 0.5;
+    const network = deriveNetworkImportance(engram.incomingSynapseCount);
+    const temporal = deriveTemporalImportance(engram.lastEffectiveAt, engram.decayHalfLifeDays, now);
+    const composite = compositeImportance({ personal, team, project, network, temporal }, weights);
+    const next = {
+        personal,
+        team,
+        project,
+        network,
+        temporal,
+        composite,
+    };
+    if (persist) {
+        repo.updateImportanceVector(id, {
+            vector: next,
+            updatedBy: options.updatedBy ?? "importance-recompute",
+        });
+    }
+    return {
+        id,
+        previous: prevVector,
+        next,
+        previousScalarImportance: prevScalar,
+        nextScalarImportance: composite,
+        persisted: persist,
+    };
+}
+export function recomputeImportanceBatch(repo, options = {}) {
+    const now = options.now ?? new Date();
+    const persist = options.persist ?? true;
+    const entries = [...repo.listEngrams()].sort((a, b) => a.id < b.id ? -1 : 1);
+    let scanned = 0;
+    let recomputed = 0;
+    const skipped = [];
+    for (const entry of entries) {
+        const engram = repo.readEngram(entry.id);
+        if (engram.status !== "active") {
+            skipped.push({ id: engram.id, reason: `status=${engram.status}` });
+            continue;
+        }
+        scanned += 1;
+        const overrides = options.overrides?.(engram.id);
+        try {
+            recomputeImportance(repo, engram.id, {
+                ...options,
+                overrides,
+                now,
+                persist,
+            });
+            recomputed += 1;
+        }
+        catch (e) {
+            skipped.push({
+                id: engram.id,
+                reason: `failed: ${e.message}`,
+            });
+        }
+    }
+    return { scanned, recomputed, skipped };
+}
+//# sourceMappingURL=vector.js.map

package/dist/importance/vector.js.map

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

package/dist/index/digest-builder.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Digest 索引构建器
+ *
+ * 扫描仓库中所有 engram 文件（单文件布局）,构建 digest.jsonl 索引。
+ * 支持增量构建（基于 mtime / contentHash 对比）。
+ *
+ * @module @co-engram/core/index
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { DigestBuildResult, DigestLine } from "./types.js";
+/**
+ * 从 engram id 读取所有需要的字段
+ */
+export declare function readDigestLine(repo: EngramRepository, id: string): DigestLine | null;
+/**
+ * Digest 构建器
+ */
+export declare class DigestBuilder {
+    private readonly repo;
+    private readonly cachePath;
+    constructor(repo: EngramRepository, cachePath: string);
+    /** digest.jsonl 路径 */
+    get digestFilePath(): string;
+    /**
+     * 读取现有 digest（按 id 索引）
+     */
+    readExisting(): Map<string, DigestLine>;
+    /**
+     * 增量构建 digest 索引
+     *
+     * 通过对比 engram.updatedAt 和 contentHash 判断是否变化
+     */
+    buildIncremental(): DigestBuildResult;
+    /**
+     * 完全重建（强制全量）
+     */
+    rebuild(): DigestBuildResult;
+    /**
+     * 写入 digest.jsonl
+     */
+    private write;
+}
+/**
+ * 收集仓库中所有 engram 的 DigestLine(纯内存,不写文件)
+ *
+ * 用于 search 索引重建等场景:需要真实 importance / decayHalfLifeDays /
+ * retrievalCount 等字段参与三因子打分,但又不需要持久化 digest.jsonl 缓存。
+ *
+ * 与 `DigestBuilder.rebuild()` 区别:
+ *   - `DigestBuilder.rebuild()` 写文件 + 返回统计
+ *   - `collectDigestLines()` 不写文件,直接返回 DigestLine[]
+ *
+ * 行为:
+ *   - 跳过 repo.exists(id) 为 false 的条目(可能并发删除)
+ *   - 跳过 readEngram 失败的条目(损坏文件由 repository 层吞错)
+ *   - 返回顺序与 repo.listEngramIndex() 一致(确定性)
+ */
+export declare function collectDigestLines(repo: EngramRepository): DigestLine[];
+//# sourceMappingURL=digest-builder.d.ts.map

package/dist/index/digest-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-builder.d.ts","sourceRoot":"","sources":["../../src/index/digest-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,GACT,UAAU,GAAG,IAAI,CAmCnB;AAED;;GAEG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM;IAGpC,sBAAsB;IACtB,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAqBvC;;;;OAIG;IACH,gBAAgB,IAAI,iBAAiB;IAkDrC;;OAEG;IACH,OAAO,IAAI,iBAAiB;IAyB5B;;OAEG;IACH,OAAO,CAAC,KAAK;CAOd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAOvE"}

package/dist/index/digest-builder.js

@@ -0,0 +1,195 @@
+/**
+ * Digest 索引构建器
+ *
+ * 扫描仓库中所有 engram 文件（单文件布局）,构建 digest.jsonl 索引。
+ * 支持增量构建（基于 mtime / contentHash 对比）。
+ *
+ * @module @co-engram/core/index
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * 从 engram id 读取所有需要的字段
+ */
+export function readDigestLine(repo, id) {
+    if (!repo.exists(id)) {
+        return null;
+    }
+    const engram = repo.readEngram(id);
+    return {
+        id: engram.id,
+        title: engram.title,
+        kind: engram.kind,
+        kinds: engram.kinds,
+        summary: engram.summary,
+        domainTags: engram.domainTags,
+        contextTags: engram.contextTags,
+        importance: engram.importance,
+        importanceVector: engram.importanceVector,
+        emotionalValence: engram.emotionalValence,
+        freshness: engram.freshness,
+        status: engram.status,
+        sourceType: engram.sourceType,
+        createdBy: engram.createdBy,
+        createdAt: engram.createdAt,
+        updatedAt: engram.updatedAt,
+        lastRetrievedAt: engram.lastRetrievedAt ?? null,
+        lastEffectiveAt: engram.lastEffectiveAt ?? null,
+        retrievalCount: engram.retrievalCount,
+        effectiveRetrievals: engram.effectiveRetrievals,
+        failedUses: engram.failedUses,
+        reinforcementScore: engram.reinforcementScore,
+        decayHalfLifeDays: engram.decayHalfLifeDays,
+        contentSize: engram.contentSize,
+        contentHash: engram.contentHash,
+        outgoingSynapseCount: engram.outgoingSynapseCount,
+        incomingSynapseCount: engram.incomingSynapseCount,
+        activeContradictionCount: engram.activeContradictionCount,
+    };
+}
+/**
+ * Digest 构建器
+ */
+export class DigestBuilder {
+    repo;
+    cachePath;
+    constructor(repo, cachePath) {
+        this.repo = repo;
+        this.cachePath = cachePath;
+    }
+    /** digest.jsonl 路径 */
+    get digestFilePath() {
+        return join(this.cachePath, "digest.jsonl");
+    }
+    /**
+     * 读取现有 digest（按 id 索引）
+     */
+    readExisting() {
+        const map = new Map();
+        if (!existsSync(this.digestFilePath)) {
+            return map;
+        }
+        const raw = readFileSync(this.digestFilePath, "utf8");
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed) {
+                continue;
+            }
+            try {
+                const parsed = JSON.parse(trimmed);
+                map.set(parsed.id, parsed);
+            }
+            catch {
+                // 跳过无效行
+            }
+        }
+        return map;
+    }
+    /**
+     * 增量构建 digest 索引
+     *
+     * 通过对比 engram.updatedAt 和 contentHash 判断是否变化
+     */
+    buildIncremental() {
+        const existing = this.readExisting();
+        const entries = this.repo.listEngramIndex();
+        const currentIds = new Set();
+        let added = 0;
+        let updated = 0;
+        let unchanged = 0;
+        let removed = 0;
+        const result = new Map();
+        for (const entry of entries) {
+            currentIds.add(entry.id);
+            const newLine = readDigestLine(this.repo, entry.id);
+            if (!newLine) {
+                continue;
+            }
+            const oldLine = existing.get(entry.id);
+            if (!oldLine) {
+                added++;
+            }
+            else if (oldLine.updatedAt !== newLine.updatedAt ||
+                oldLine.contentHash !== newLine.contentHash) {
+                updated++;
+            }
+            else {
+                unchanged++;
+            }
+            result.set(entry.id, newLine);
+        }
+        // 统计被删除的
+        for (const id of existing.keys()) {
+            if (!currentIds.has(id)) {
+                removed++;
+            }
+        }
+        this.write(result.values());
+        return {
+            total: result.size,
+            added,
+            updated,
+            unchanged,
+            removed,
+        };
+    }
+    /**
+     * 完全重建（强制全量）
+     */
+    rebuild() {
+        const entries = this.repo.listEngramIndex();
+        const result = new Map();
+        let added = 0;
+        for (const entry of entries) {
+            const newLine = readDigestLine(this.repo, entry.id);
+            if (!newLine) {
+                continue;
+            }
+            result.set(entry.id, newLine);
+            added++;
+        }
+        this.write(result.values());
+        return {
+            total: result.size,
+            added,
+            updated: 0,
+            unchanged: 0,
+            removed: 0,
+        };
+    }
+    /**
+     * 写入 digest.jsonl
+     */
+    write(lines) {
+        mkdirSync(this.cachePath, { recursive: true });
+        const text = Array.from(lines)
+            .map((line) => JSON.stringify(line))
+            .join("\n");
+        writeFileSync(this.digestFilePath, text + "\n", "utf8");
+    }
+}
+/**
+ * 收集仓库中所有 engram 的 DigestLine(纯内存,不写文件)
+ *
+ * 用于 search 索引重建等场景:需要真实 importance / decayHalfLifeDays /
+ * retrievalCount 等字段参与三因子打分,但又不需要持久化 digest.jsonl 缓存。
+ *
+ * 与 `DigestBuilder.rebuild()` 区别:
+ *   - `DigestBuilder.rebuild()` 写文件 + 返回统计
+ *   - `collectDigestLines()` 不写文件,直接返回 DigestLine[]
+ *
+ * 行为:
+ *   - 跳过 repo.exists(id) 为 false 的条目(可能并发删除)
+ *   - 跳过 readEngram 失败的条目(损坏文件由 repository 层吞错)
+ *   - 返回顺序与 repo.listEngramIndex() 一致(确定性)
+ */
+export function collectDigestLines(repo) {
+    const out = [];
+    for (const entry of repo.listEngramIndex()) {
+        const line = readDigestLine(repo, entry.id);
+        if (line)
+            out.push(line);
+    }
+    return out;
+}
+//# sourceMappingURL=digest-builder.js.map

package/dist/index/digest-builder.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Graph 索引构建器
+ *
+ * 从所有 engrams/synapses/*.yaml 收集所有出边，构建 graph.json 索引。
+ *
+ * @module @co-engram/core/index
+ */
+import type { EngramRepository } from "../storage/repository.js";
+import type { GraphIndex } from "./types.js";
+/**
+ * Graph 构建器
+ */
+export declare class GraphBuilder {
+    private readonly repo;
+    private readonly cachePath;
+    constructor(repo: EngramRepository, cachePath: string);
+    /** graph.json 路径 */
+    get graphFilePath(): string;
+    /**
+     * 完全重建 graph 索引
+     */
+    rebuild(): {
+        nodes: number;
+        edges: number;
+    };
+    /**
+     * 读取 graph.json
+     */
+    read(): GraphIndex | null;
+    private write;
+}
+//# sourceMappingURL=graph-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../src/index/graph-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAa,UAAU,EAAa,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM;IAGpC,oBAAoB;IACpB,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAiE3C;;OAEG;IACH,IAAI,IAAI,UAAU,GAAG,IAAI;IAQzB,OAAO,CAAC,KAAK;CAId"}