@rubytech/create-siteoffice-code 0.1.256

package/payload/platform/plugins/memory/mcp/dist/tools/memory-write.js

@@ -0,0 +1,376 @@
+import { getSession } from "../lib/neo4j.js";
+import { embed } from "../lib/embeddings.js";
+import { validateWrite } from "../lib/schema-validator.js";
+import { resolveActiveVertical } from "../lib/resolve-active-vertical.js";
+import { checkGraphWriteGate, checkLabelWriteGate, checkPropertyWriteGate, } from "../lib/graph-write-gate.js";
+import { extractDatedStatements } from "../lib/timeline-extractor.js";
+import { randomUUID } from "node:crypto";
+import { checkLabelOriginGate } from "../lib/label-origin-gate.js";
+import { withWriteEvent, pickName } from "../lib/log-ingest.js";
+import { writeNodeWithEdges, injectConversationProvenance, } from "../../../../../lib/graph-write/dist/index.js";
+/** Admin-twin labels carrying `compiledTruth` (Task 306 + 392 extension to :Project, :LocalBusiness). */
+const TIMELINE_SUBJECT_LABELS = [
+    "Person",
+    "Organization",
+    "Concept",
+    "Project",
+    "LocalBusiness",
+];
+// LEGACY (Task 654) — the `compiledTruthPublic` public-twin subsystem
+// (this constant, the six `compiledTruthPublic*` system-managed fields, the
+// `compiled-truth-rewriter` producer, the `memory-update` stamping/history, and
+// `projectPublicProperties` in memory-search.ts) exists to shape a *public-scope
+// graph read*. Task 654 retires that read path (the public agent is toolless and
+// the session-end reviewer no longer searches), leaving `compiledTruthPublic`
+// written but never read. Retained intentionally — not deleted — in case a
+// public-facing compiled-truth surface is wanted again. This comment is the
+// standing record of that decision (no teardown task). Do not wire new readers
+// without restoring the public-scope search surface first.
+/** Public-twin labels carrying `compiledTruthPublic` (Task 392). :Person excluded by design. */
+const PUBLIC_TWIN_LABELS = [
+    "Organization",
+    "Concept",
+    "Project",
+    "LocalBusiness",
+];
+/** Default `compiledTruthUpdatedAt` on first write — epoch makes stale-detection trivial. */
+const COMPILED_TRUTH_EPOCH = "1970-01-01T00:00:00Z";
+/**
+ * Loud-fail keys. The six compiled-truth fields are system-managed on both
+ * admin and public twins; Task 424 made the `compiled-truth-rewriter`
+ * specialist the only sanctioned writer (it writes via memory-update under
+ * MAXY_SPECIALIST env gate). First-write defaults stamped in the block below
+ * are the other path. A caller supplying any of these keys in the properties
+ * bag bypasses the audit chain — refuse loudly.
+ */
+const SYSTEM_MANAGED_COMPILED_TRUTH_KEYS = [
+    "compiledTruth",
+    "compiledTruthUpdatedAt",
+    "compiledTruthSource",
+    "compiledTruthPublic",
+    "compiledTruthPublicUpdatedAt",
+    "compiledTruthPublicSource",
+];
+export async function memoryWrite(params) {
+    const { labels, properties, accountId, scope, relationships, createdBy, validator, producedByTaskId } = params;
+    const nameHint = pickName(properties);
+    return withWriteEvent({ tool: "memory-write", accountId, labels, name: nameHint }, () => memoryWriteImpl({ labels, properties, accountId, scope, relationships, createdBy, validator, producedByTaskId }), (r) => ({ elementId: r.nodeId, labels: r.labels, name: nameHint }));
+}
+async function memoryWriteImpl(params) {
+    const { labels, properties, accountId, scope, relationships, createdBy, validator, producedByTaskId } = params;
+    if (!scope) {
+        throw new Error("scope is required — valid values: 'public', 'shared', 'admin', 'user:{identifier}'");
+    }
+    // Refuse operator-supplied compiled-truth fields in the properties bag.
+    // Defaults stamped below remain the first-write path; mutations land via
+    // memory-update under MAXY_SPECIALIST=compiled-truth-rewriter (Task 424).
+    for (const key of SYSTEM_MANAGED_COMPILED_TRUTH_KEYS) {
+        if (key in properties) {
+            throw new Error(`Write blocked (system-managed-key): '${key}' cannot be set via the properties bag. ` +
+                `Compiled-truth fields are written only by the compiled-truth-rewriter specialist — dispatch it via the Task tool.`);
+        }
+    }
+    const session = getSession();
+    const labelStr = labels.map((l) => `\`${l}\``).join(":");
+    try {
+        // Resolve the active vertical for this write before validation, on the
+        // same session that performs the write. A LocalBusiness with
+        // `businessType` overrides the brand-declared default; otherwise the
+        // brand vertical applies. The validator scopes rules to base + the
+        // resolved vertical.
+        const verticalContext = await resolveActiveVertical({
+            session,
+            accountId,
+            brandVertical: validator.schema.brandVertical,
+        });
+        // Schema validation runs before embedding so a rejected write does not
+        // waste an Ollama call. Errors are logged to stderr then re-thrown so the
+        // MCP tool handler can report a descriptive message to the agent and the
+        // operator can see the rejection in server.log.
+        try {
+            validateWrite({ labels, properties, accountId }, validator, { verticalContext });
+        }
+        catch (err) {
+            console.error(`memory-write: schema validation rejected [${labels.join(", ")}] for account ${accountId ?? "<none>"}: ${err instanceof Error ? err.message : String(err)}`);
+            throw err;
+        }
+        // Task 350: refuse agent-origin LocalBusiness writes. The installer's
+        // seed-neo4j.sh writes the single root via raw cypher (system origin)
+        // and never goes through this tool, so the seed path is unaffected.
+        const origin = checkLabelOriginGate({ labels, createdBy, accountId, tool: "memory-write" });
+        if (!origin.ok) {
+            throw new Error(`Write blocked (${origin.reason}): ${origin.message}`);
+        }
+        // precondition: AdminUser + LocalBusiness must exist for the
+        // account before any non-exempt node is written. Exempt labels (Person,
+        // LocalBusiness, AdminUser) pass through so the bootstrap writes the
+        // agent needs to run `business-profile` are not themselves blocked.
+        if (accountId) {
+            const gate = await checkGraphWriteGate({ session, accountId, labels });
+            if (!gate.ok) {
+                throw new Error(`Write blocked (${gate.reason}): ${gate.message}`);
+            }
+        }
+        // Property-level gate (Task 306). Refuse a write whose
+        // `compiledTruth` exceeds COMPILED_TRUTH_MAX_CHARS — this protects against
+        // operators / agents pasting in long bodies as compiled truth.
+        const propGate = checkPropertyWriteGate({ properties });
+        if (!propGate.ok) {
+            throw new Error(`Write blocked (${propGate.reason}): ${propGate.message}`);
+        }
+        // Label-level gate (Task 391). Refuse direct writes to read-only
+        // audit labels (e.g. :CompiledTruthRevision) — these are owned by
+        // the rewriter + dream-cycle, never the agent.
+        const labelGate = checkLabelWriteGate({ labels });
+        if (!labelGate.ok) {
+            throw new Error(`Write blocked (${labelGate.reason}): ${labelGate.message}`);
+        }
+        const textForEmbedding = buildTextRepresentation(labels, properties);
+        const embedding = await embed(textForEmbedding);
+        const nodeProps = {
+            ...properties,
+            accountId,
+            scope,
+            embedding,
+            updatedAt: new Date().toISOString(),
+        };
+        if (!properties.createdOn && !properties.createdAt) {
+            nodeProps.createdAt = new Date().toISOString();
+        }
+        // Task 485 — when the writer runs under a reviewer dispatch, every node
+        // it creates is stamped with the visitor's sliceToken and forced to
+        // scope `"user"`. The env var is the single source of truth (the
+        // reviewer agent / database-operator both inherit it). The forced
+        // scope override defends against an agent-supplied `scope: "public"`
+        // leaking the user-scoped row into other visitors' reads.
+        const recorderSliceToken = typeof process.env.RECORDER_SLICE_TOKEN === "string" &&
+            process.env.RECORDER_SLICE_TOKEN.length > 0
+            ? process.env.RECORDER_SLICE_TOKEN
+            : undefined;
+        if (recorderSliceToken) {
+            nodeProps.sliceToken = recorderSliceToken;
+            nodeProps.scope = "user";
+        }
+        process.stderr.write(`[memory-write] sliceStamp=${recorderSliceToken ? recorderSliceToken.slice(0, 8) : "none"} ` +
+            `nodeLabels=${labels.join(",")} scope=${String(nodeProps.scope)}\n`);
+        // Task 306 + 392: stamp compiled-truth defaults on the five admin-twin
+        // labels that carry the compiled-truth + timeline doctrine. New nodes
+        // start with an empty compiledTruth and an epoch updatedAt so
+        // stale-detection queries treat them as eligible for the next rewriter
+        // pass. `compiledTruthSource = "rewriter"` is the default writer; the
+        // operator override flips it to "operator".
+        //
+        // Task 392: also stamp public-twin defaults on the four public-twin
+        // labels. :Person is in the admin set but NOT the public set — the
+        // public twin remains undefined on Person nodes so the graph projection
+        // can detect "this label never carries a public summary" structurally.
+        const isCompiledTruthSubject = TIMELINE_SUBJECT_LABELS.some((l) => labels.includes(l));
+        if (isCompiledTruthSubject) {
+            if (nodeProps.compiledTruth === undefined)
+                nodeProps.compiledTruth = "";
+            if (nodeProps.compiledTruthUpdatedAt === undefined)
+                nodeProps.compiledTruthUpdatedAt = COMPILED_TRUTH_EPOCH;
+            if (nodeProps.compiledTruthSource === undefined)
+                nodeProps.compiledTruthSource = "rewriter";
+        }
+        const isPublicTwinSubject = PUBLIC_TWIN_LABELS.some((l) => labels.includes(l));
+        if (isPublicTwinSubject) {
+            if (nodeProps.compiledTruthPublic === undefined)
+                nodeProps.compiledTruthPublic = "";
+            if (nodeProps.compiledTruthPublicUpdatedAt === undefined)
+                nodeProps.compiledTruthPublicUpdatedAt = COMPILED_TRUTH_EPOCH;
+            if (nodeProps.compiledTruthPublicSource === undefined)
+                nodeProps.compiledTruthPublicSource = "rewriter";
+        }
+        // compose the inbound `:PRODUCED` edge from the active
+        // Task before delegating to the gate. We resolve the Task here (not
+        // in the gate) so we can verify accountId parity and emit a clear
+        // error before the write transaction starts. Mismatched accountId is
+        // a doctrine violation (account isolation is absolute) — fail loud.
+        let resolvedRelationships = relationships;
+        if (producedByTaskId) {
+            const taskRes = await session.run(`MATCH (t:Task) WHERE elementId(t) = $taskId RETURN t.accountId AS accountId LIMIT 1`, { taskId: producedByTaskId });
+            if (taskRes.records.length === 0) {
+                throw new Error(`memory-write: producedByTaskId '${producedByTaskId}' did not resolve to a :Task node`);
+            }
+            const taskAccountId = taskRes.records[0].get("accountId");
+            if (accountId && taskAccountId !== accountId) {
+                throw new Error(`memory-write: producedByTaskId Task.accountId='${taskAccountId}' does not match write accountId='${accountId}' (account isolation violation)`);
+            }
+            resolvedRelationships = [
+                ...relationships,
+                {
+                    type: "PRODUCED",
+                    direction: "incoming",
+                    targetNodeId: producedByTaskId,
+                },
+            ];
+        }
+        else {
+            // direct-ask fallback. When the caller didn't pass an
+            // explicit `producedByTaskId` (typical of direct admin asks: "add
+            // Anneke as person"), the admin server's `SESSION_NODE_ID`
+            // env-stamp covers the gate by injecting a PRODUCED edge from the
+            // active :AdminConversation. No-op for non-action-provenance label
+            // writes and when the env is unset.
+            resolvedRelationships = await injectConversationProvenance({
+                session,
+                relationships,
+                accountId: accountId ?? "",
+                writeLabels: labels,
+                conversationNodeId: process.env.SESSION_NODE_ID,
+                logNamespace: "mcp:memory",
+                tool: "memory-write",
+            });
+        }
+        const result = await writeNodeWithEdges({
+            session,
+            labels,
+            props: nodeProps,
+            relationships: resolvedRelationships,
+            createdBy,
+        });
+        // Task 306: extract dated statements from the body of compiled-truth
+        // subjects and path-anchor-MERGE :TimelineEvent rows. Strictly deterministic
+        // here; the 305 typed-edge hook upgrades `kind` from "mentioned" to a
+        // more specific value asynchronously. Failures here MUST NOT roll back
+        // the entity write — the node persisting with an empty timeline is the
+        // right degradation mode; a rewriter call on demand still works.
+        if (isCompiledTruthSubject && typeof properties.body === "string" && accountId) {
+            try {
+                // Task 390: reference timestamp anchors relative date forms
+                // ("yesterday", "two weeks ago", "Q3 last year"). Use the
+                // operator-supplied createdAt when present; otherwise the
+                // createdAt we just stamped on nodeProps; otherwise now.
+                const refRaw = (typeof properties.createdAt === "string" && properties.createdAt) ||
+                    (typeof properties.createdOn === "string" && properties.createdOn) ||
+                    (typeof nodeProps.createdAt === "string" && nodeProps.createdAt) ||
+                    undefined;
+                const reference = refRaw ? new Date(refRaw) : new Date();
+                const statements = extractDatedStatements(properties.body, Number.isNaN(reference.getTime()) ? new Date() : reference);
+                if (statements.length > 0) {
+                    for (const s of statements) {
+                        await session.run(`MATCH (e) WHERE elementId(e) = $entityId AND e.accountId = $accountId
+               MERGE (e)-[:HAS_TIMELINE_EVENT]->(t:TimelineEvent {timelineEventId: $id})
+                 ON CREATE SET t.accountId = $accountId,
+                               t.occurredAt = datetime($occurredAt),
+                               t.kind = $kind,
+                               t.summary = $summary,
+                               t.source = $source,
+                               t.matched = $matched,
+                               t.createdAt = datetime(),
+                               t.learnedAt = datetime(),
+                               t.scope = $scope
+               RETURN elementId(t) AS timelineEventNodeId`, {
+                            entityId: result.nodeId,
+                            accountId,
+                            id: randomUUID(),
+                            occurredAt: s.occurredAt,
+                            kind: "mentioned",
+                            summary: s.summary,
+                            source: typeof properties.sourceMessageId === "string"
+                                ? properties.sourceMessageId
+                                : "memory-write",
+                            matched: s.matched,
+                            scope,
+                        });
+                    }
+                }
+                console.log(`[timeline-extract] nodeId=${result.nodeId.slice(0, 12)} ` +
+                    `subject="${properties.name ?? "?"}" dates=${statements.length} kinds=[mentioned×${statements.length}]`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                const bodyLen = properties.body.length;
+                console.error(`[timeline-extract] error nodeId=${result.nodeId.slice(0, 12)} ` +
+                    `body-len=${bodyLen} error="${msg}"`);
+                // intentional swallow — entity write succeeded; timeline is opportunistic.
+            }
+        }
+        return { nodeId: result.nodeId, labels: result.labels, created: true };
+    }
+    catch (error) {
+        // Constraint violations include an unusable internal ID (e.g. "Node(219)").
+        // Look up the existing node's elementId so the agent can call memory-update.
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code ===
+                "Neo.ClientError.Schema.ConstraintValidationFailed") {
+            const parsed = parseConstraintProperty(error.message);
+            console.error(`memory-write: constraint violation on ${labels.join(":")}` +
+                (parsed
+                    ? ` — property '${parsed.propName}' = '${parsed.propValue}'`
+                    : ` — could not parse property from: ${error.message}`));
+            try {
+                let lookupQuery;
+                let lookupParams;
+                if (parsed) {
+                    // propName is safe to interpolate — regex constrains it to \w+ characters
+                    lookupQuery = `
+            MATCH (n:${labelStr})
+            WHERE n.accountId = $accountId AND n.\`${parsed.propName}\` = $propValue
+            RETURN elementId(n) AS existingId
+          `;
+                    lookupParams = { accountId, propValue: parsed.propValue };
+                }
+                else {
+                    lookupQuery = `
+            MATCH (n:${labelStr})
+            WHERE n.accountId = $accountId
+            RETURN elementId(n) AS existingId
+            LIMIT 1
+          `;
+                    lookupParams = { accountId };
+                }
+                const lookupResult = await session.run(lookupQuery, lookupParams);
+                if (lookupResult.records.length > 0) {
+                    const existingId = lookupResult.records[0].get("existingId");
+                    const reason = parsed
+                        ? ` — property '${parsed.propName}' = '${parsed.propValue}' is unique.`
+                        : " (match may be approximate).";
+                    console.error(`memory-write: conflicting node elementId: ${existingId}`);
+                    throw new Error(`Node already exists (elementId: ${existingId})${reason} Use memory-update with this nodeId to modify it.`);
+                }
+            }
+            catch (lookupError) {
+                // If the lookup itself produced our actionable error, propagate it.
+                if (lookupError instanceof Error &&
+                    lookupError.message.startsWith("Node already exists")) {
+                    throw lookupError;
+                }
+                console.error("memory-write: lookup for conflicting node failed:", lookupError);
+                // Lookup failed — fall through to re-throw the original constraint error.
+            }
+        }
+        throw error;
+    }
+    finally {
+        await session.close();
+    }
+}
+/** Parse the violated property name and value from a Neo4j constraint error message. */
+export function parseConstraintProperty(message) {
+    // Neo4j format: "... property `name` = 'value'" or "... property 'name' = 'value'"
+    const match = message.match(/property [`'](\w+)[`'] = '([^']*)'/);
+    if (!match)
+        return null;
+    return { propName: match[1], propValue: match[2] };
+}
+// Embedding-text bounds. A single large `body`/`text`/`compiledTruth` prop
+// could otherwise produce a multi-KB representation that exceeds the embed
+// model's input limit. Cap each value (so one huge prop cannot crowd out the
+// rest) and the total (the final backstop is embeddings.ts' EMBED_INPUT_MAX_CHARS).
+const REPR_PER_VALUE_MAX = 2000;
+const REPR_TOTAL_MAX = 8000;
+export function buildTextRepresentation(labels, properties) {
+    const parts = [`[${labels.join(", ")}]`];
+    for (const [key, value] of Object.entries(properties)) {
+        if (value !== null && value !== undefined && key !== "embedding") {
+            const v = String(value);
+            parts.push(`${key}: ${v.length > REPR_PER_VALUE_MAX ? v.slice(0, REPR_PER_VALUE_MAX) : v}`);
+        }
+    }
+    const joined = parts.join(" | ");
+    return joined.length > REPR_TOTAL_MAX ? joined.slice(0, REPR_TOTAL_MAX) : joined;
+}
+//# sourceMappingURL=memory-write.js.map

package/payload/platform/plugins/memory/mcp/dist/tools/memory-write.js.map

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

package/payload/platform/plugins/memory/mcp/dist/tools/obsidian-vault-import.d.ts

@@ -0,0 +1,127 @@
+import { Buffer } from "node:buffer";
+/**
+ * obsidian-vault-import — server-side parser + write orchestrator for
+ * Obsidian vault ingestion. Two-phase by operator decision (CEO review):
+ *
+ *   1. mode='dry-run' — walks the extractedDir, parses, builds the
+ *      resolution plan, returns counts + ambiguities the operator must
+ *      disambiguate before the write commits. No writes happen.
+ *
+ *   2. mode='commit' — re-walks (parsing is deterministic + cheap on a
+ *      local fs), applies operator-supplied resolutions, runs the
+ *      content-hash idempotency check against the existing graph,
+ *      copies attachments to {accountDir}/archive/obsidian/<importId>/,
+ *      and invokes memoryArchiveWrite with archiveType='obsidian-vault'.
+ *
+ * The agent never parses markdown. It supplies extractedDir + ownerNodeId
+ * + operator-driven filter selection, runs the dry-run, surfaces
+ * ambiguities to the operator interactively, then re-invokes commit with
+ * the resolutions block. All schema decisions (label reuse, edge naming,
+ * MERGE keys) are pinned in memory-archive-write's obsidian-vault handler.
+ */
+export type ObsidianImportMode = "dry-run" | "commit";
+export interface VaultImportFilters {
+    /** Only ingest pages whose obsidianPath starts with one of these prefixes. */
+    folderPrefixes?: string[];
+    /** Only ingest pages whose tags intersect this set (normalised, no `#`). */
+    tags?: string[];
+    /** Only ingest pages with mtime >= this ISO date or epoch-ms. */
+    modifiedSince?: string;
+}
+/**
+ * Operator's disambiguation answers, keyed by the ambiguity id the dry-run
+ * returned. Each entry tells the commit phase which candidate to write the
+ * wikilink edge to.
+ */
+export type AmbiguityResolution = {
+    kind: "page";
+    obsidianPath: string;
+} | {
+    kind: "entity";
+    nodeId: string;
+} | {
+    kind: "stub";
+};
+export interface VaultImportParams {
+    accountId: string;
+    ownerNodeId: string;
+    /** Absolute path to the extracted vault directory. Caller validates it
+     *  lives under the account's archive area before invoking. */
+    extractedDir: string;
+    /** Stable id for the import run. Generated by dry-run, passed back in
+     *  the commit call so observability lines tie together. */
+    importId?: string;
+    mode: ObsidianImportMode;
+    filters?: VaultImportFilters;
+    /** Operator answers to dry-run ambiguities. Required when mode='commit'
+     *  AND the dry-run reported ambiguities; ignored otherwise. */
+    resolutions?: Record<string, AmbiguityResolution>;
+    /** Threshold above which the dry-run flags large vaults for the skill's
+     *  selective-ingest filter conversation. Default 100 — mirrors the
+     *  linkedin-connections threshold. */
+    selectiveIngestThreshold?: number;
+    sessionId?: string;
+}
+export interface VaultImportAmbiguity {
+    /** Stable id the operator quotes back in the resolutions map. */
+    id: string;
+    /** The page that contains the wikilink. */
+    fromPath: string;
+    /** Raw wikilink text (without `[[…]]`, before alias `|`). */
+    target: string;
+    /** Candidate intra-vault pages by obsidianPath. */
+    pageCandidates: string[];
+    /** Candidate existing entities — `{nodeId, label, name, distance}`. */
+    entityCandidates: Array<{
+        nodeId: string;
+        label: string;
+        name: string;
+        distance: number;
+    }>;
+}
+export interface VaultImportPlan {
+    importId: string;
+    mode: ObsidianImportMode;
+    /** Total pages discovered before filtering. */
+    pagesDiscovered: number;
+    /** Pages surviving filters. */
+    pagesEligible: number;
+    /** Pages whose contentHash already matches the existing graph (skipped on commit). */
+    pagesUnchanged: number;
+    /** Wikilinks classified by resolution: intra-vault, fuzzy-entity, stub. */
+    wikilinks: {
+        page: number;
+        entity: number;
+        stub: number;
+        ambiguous: number;
+    };
+    /** Tags discovered across eligible pages. */
+    tagCount: number;
+    /** Distinct attachments referenced. */
+    attachmentCount: number;
+    /** Operator must resolve these before commit will run. */
+    ambiguities: VaultImportAmbiguity[];
+    /** Set when pagesEligible > selectiveIngestThreshold and dry-run was the call. */
+    selectiveIngestSuggested: boolean;
+}
+export interface VaultImportCommitResult extends VaultImportPlan {
+    written: {
+        createdPages: number;
+        mergedPages: number;
+        createdTags: number;
+        createdTagEdges: number;
+        createdAttachments: number;
+        createdAttachmentEdges: number;
+        createdWikilinkEdges: number;
+    };
+    attachmentsCopied: number;
+    errors: Array<{
+        rowIndex: number;
+        reason: string;
+    }>;
+    /** Server log line tag — the same string written to server.log. */
+    observabilityTag: string;
+}
+export declare function obsidianVaultImport(params: VaultImportParams): Promise<VaultImportPlan | VaultImportCommitResult>;
+export type _BufferType = Buffer;
+//# sourceMappingURL=obsidian-vault-import.d.ts.map

package/payload/platform/plugins/memory/mcp/dist/tools/obsidian-vault-import.d.ts.map

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