syncpoint-ai 0.1.0

package/dist/server/application/protocol-gate-service.js

@@ -0,0 +1,398 @@
+/**
+ * Protocol Gate & Snapshot Validation — P12 context assembly layer.
+ *
+ * Design principle:
+ *   snapshot-only means agent working-context only, not protocol-only.
+ *   Protocol rules are never absorbed into snapshot — they remain a hard external layer.
+ *
+ * Three layers:
+ *   1. Protocol Gate   — hard collaboration rules
+ *   2. Snapshot Reality — agent's current task working memory
+ *   3. Validation Notes — staleness, evidence coverage, missing proof
+ */
+import { ContractStatus } from "../../adapters/index.js";
+import { CheckpointReviewStatus } from "../../governance/index.js";
+import * as contextMemoryRepo from "../repositories/_exports/context-memory.js";
+import * as orchestrationRepo from "../repositories/_exports/orchestration.js";
+import * as protocolRepo from "../repositories/_exports/protocol.js";
+import { sgCheckAgent } from "./sync-gate-service.js";
+import { rcDetectConflicts } from "./resource-claim-service.js";
+import { wakeList } from "./wake-engine-service.js";
+// ══════════════════════════════════════════════════════
+// Protocol Gate Assembler
+// ══════════════════════════════════════════════════════
+/**
+ * Assemble the full protocol gate summary for an agent + task context.
+ * This collects all active collaboration rules from every protocol source.
+ */
+export function assembleProtocolGate(agentId, taskId, sessionId) {
+    const rules = [];
+    // 1. Pinned memories — always enforced
+    const pinned = contextMemoryRepo.collectPinnedMemories(taskId);
+    for (const m of pinned) {
+        rules.push({
+            source: "pinned-memory",
+            severity: "hard",
+            summary: `${m.key}: ${m.content}`,
+        });
+    }
+    // 2. Peer contract constraints
+    const approved = contextMemoryRepo.getContractForTask(taskId);
+    if (approved && approved.status === ContractStatus.APPROVED) {
+        if (approved.scope) {
+            rules.push({ source: "peer-contract", severity: "hard", summary: `Scope: ${approved.scope}`, entityId: approved.id });
+        }
+        if (approved.resourceBoundaries.length) {
+            rules.push({ source: "peer-contract", severity: "hard", summary: `Resource boundaries: ${approved.resourceBoundaries.join(", ")}`, entityId: approved.id });
+        }
+        if (approved.responsibilities.length) {
+            rules.push({ source: "peer-contract", severity: "soft", summary: `Responsibilities: ${approved.responsibilities.join(", ")}`, entityId: approved.id });
+        }
+        if (approved.interfaceSpec.length) {
+            rules.push({ source: "peer-contract", severity: "soft", summary: `Interface: ${approved.interfaceSpec.join(", ")}`, entityId: approved.id });
+        }
+    }
+    // 3. Resource claims for this agent
+    const claims = protocolRepo.listActiveResourceClaims(sessionId ? { sessionId } : undefined);
+    const agentClaims = claims.filter((c) => c.actorId === agentId);
+    for (const c of agentClaims) {
+        const locators = c.resources?.map((r) => `${r.type}:${r.locator}`).join(", ") ?? "";
+        rules.push({
+            source: "resource-claim",
+            severity: "info",
+            summary: `Claimed: ${locators} (${c.mode ?? "exclusive"})`,
+            entityId: c.id,
+        });
+    }
+    // 4. Resource conflicts
+    const conflicts = rcDetectConflicts(sessionId ? { sessionId } : undefined);
+    const agentConflicts = conflicts.filter((c) => c.claimA.actorId === agentId || c.claimB.actorId === agentId);
+    for (const c of agentConflicts) {
+        rules.push({
+            source: "resource-claim",
+            severity: c.isHardConflict ? "hard" : "soft",
+            summary: `Conflict on ${c.overlappingLocator}: ${c.claimA.actorId} vs ${c.claimB.actorId}`,
+        });
+    }
+    // 5. Sync gates blocking this agent
+    const gateCheck = sgCheckAgent(agentId, { taskId, sessionId });
+    for (const g of gateCheck.blockingGates) {
+        rules.push({
+            source: "sync-gate",
+            severity: "hard",
+            summary: `SyncGate ${g.id}: ${g.description || g.reason} — awaiting ack`,
+            entityId: g.id,
+        });
+    }
+    // 6. Active checkpoint reviews
+    const CR_BLOCKING = new Set([
+        CheckpointReviewStatus.OPEN,
+        CheckpointReviewStatus.WAITING_APPROVAL,
+        CheckpointReviewStatus.REJECTED,
+    ]);
+    try {
+        const txns = protocolRepo.listActiveCheckpointReviews({ taskId, sessionId });
+        for (const tx of txns) {
+            const isBlocking = CR_BLOCKING.has(tx.status);
+            rules.push({
+                source: "checkpoint-review",
+                severity: isBlocking ? "hard" : "soft",
+                summary: `CheckpointReview ${tx.id}: ${tx.status}`,
+                entityId: tx.id,
+            });
+        }
+    }
+    catch { /* no checkpoint reviews module — ok */ }
+    // 7. Pending reviews
+    try {
+        const reviews = sessionId ? orchestrationRepo.listReviewRequests(sessionId) : [];
+        for (const r of reviews) {
+            if (r.status === "PENDING" && r.reviewerAgentId === agentId) {
+                rules.push({
+                    source: "review",
+                    severity: "soft",
+                    summary: `Review pending: ${r.id} — you are the reviewer`,
+                    entityId: r.id,
+                });
+            }
+        }
+    }
+    catch { /* ok */ }
+    // 8. Pending wakes for this agent
+    try {
+        const wakes = wakeList({ agentId, status: "QUEUED" });
+        for (const w of wakes) {
+            rules.push({
+                source: "wake",
+                severity: "info",
+                summary: `Wake queued: ${w.action ?? w.id}`,
+                entityId: w.id,
+            });
+        }
+    }
+    catch { /* ok */ }
+    // Compute summary — blocked = any hard rule from a blocking source
+    const hardBlockers = rules.filter(r => r.severity === "hard").map(r => r.summary);
+    const hasBlockingGates = gateCheck.blocked;
+    const hasHardConflicts = agentConflicts.some((c) => c.isHardConflict);
+    const hasActiveSubmittedTx = rules.some(r => r.source === "checkpoint-review" && r.severity === "hard");
+    const blocked = hasBlockingGates || hasHardConflicts || hasActiveSubmittedTx;
+    return {
+        rules,
+        blocked,
+        hardBlockers,
+        counts: {
+            pinnedRules: pinned.length,
+            contractConstraints: rules.filter(r => r.source === "peer-contract").length,
+            resourceClaims: agentClaims.length,
+            activeGates: gateCheck.blockingGates.length,
+            activeTransactions: rules.filter(r => r.source === "checkpoint-review").length,
+            pendingReviews: rules.filter(r => r.source === "review").length,
+            pendingWakes: rules.filter(r => r.source === "wake").length,
+            projectionRules: 0,
+        },
+    };
+}
+// ══════════════════════════════════════════════════════
+// P3B — Projection → Gate injection
+// ══════════════════════════════════════════════════════
+/**
+ * Inject projected protocolRules and constraintRules into the protocol gate.
+ * Also injects projection conflicts and validity degradation.
+ * Returns a new ProtocolGateSummary (does not mutate input).
+ */
+export function injectProjectionIntoGate(gate, projection) {
+    const rules = [...gate.rules];
+    const hardBlockers = [...gate.hardBlockers];
+    let blocked = gate.blocked;
+    // Protocol rules from projection → severity based on memory severity
+    for (const pr of projection.protocolRules) {
+        const severity = pr.source.confidence === "high" ? "hard" : "soft";
+        const summary = `[projection:${pr.source.sourceMemoryId}] ${pr.title}: ${pr.content}`;
+        rules.push({ source: "projection", severity, summary, entityId: pr.source.sourceMemoryId });
+        if (severity === "hard")
+            hardBlockers.push(summary);
+    }
+    // Constraint rules → visible as awareness in gate notes, but NOT blocking in P3B.
+    // P4 Constraint Runtime will enforce actual violation detection.
+    // Severity is "soft" = agent must be aware, but existence alone does not block.
+    for (const cr of projection.constraintRules) {
+        const summary = `[constraint:${cr.source.sourceMemoryId}] ${cr.title}: ${cr.content}`;
+        rules.push({ source: "projection", severity: "soft", summary, entityId: cr.source.sourceMemoryId });
+    }
+    // Projection conflicts → explicit
+    for (const c of projection.conflicts) {
+        const summary = `[conflict] ${c.description} (${c.itemA.sourceMemoryId} vs ${c.itemB.sourceMemoryId})`;
+        rules.push({ source: "projection", severity: "hard", summary });
+        hardBlockers.push(summary);
+    }
+    // Projection validity degradation
+    if (projection.projectionValidity === "invalid") {
+        const msg = "Projection invalid — cannot trust projected reality.";
+        rules.push({ source: "projection", severity: "hard", summary: msg });
+        hardBlockers.push(msg);
+        blocked = true;
+    }
+    // If we added hard projection rules, re-evaluate blocked
+    if (hardBlockers.length > gate.hardBlockers.length) {
+        blocked = true;
+    }
+    return {
+        rules,
+        blocked,
+        hardBlockers,
+        counts: {
+            ...gate.counts,
+            projectionRules: projection.protocolRules.length + projection.constraintRules.length + projection.conflicts.length,
+        },
+    };
+}
+// ══════════════════════════════════════════════════════
+// Snapshot Validation
+// ══════════════════════════════════════════════════════
+/**
+ * Validate a snapshot against the current state.
+ * Returns a validation result with notes.
+ */
+export function validateSnapshot(snapshot, checkpoint, taskId, agentId) {
+    const notes = [];
+    let valid = true;
+    let stale = false;
+    let staleReason = null;
+    let scopeMatch = true;
+    let hasBlockers = false;
+    let hasEvidence = !!checkpoint;
+    let needsSync = false;
+    if (!snapshot) {
+        valid = false;
+        notes.push("No context snapshot found. Create one before resuming.");
+        return {
+            valid, stale, staleReason, scopeMatch, hasBlockers,
+            hasEvidence, needsSync, notes,
+        };
+    }
+    // Scope check
+    if (snapshot.taskId !== taskId || snapshot.agentId !== agentId) {
+        scopeMatch = false;
+        valid = false;
+        notes.push("Snapshot scope mismatch: taskId or agentId does not match.");
+    }
+    // Staleness check
+    if (checkpoint && snapshot.createdAt < checkpoint.createdAt) {
+        stale = true;
+        staleReason = `Snapshot (${snapshot.createdAt}) is older than checkpoint (${checkpoint.createdAt}).`;
+        valid = false;
+        notes.push(`Stale: ${staleReason}`);
+    }
+    // Evidence check
+    if (!checkpoint) {
+        hasEvidence = false;
+        valid = false;
+        notes.push("No checkpoint found — snapshot has no evidence backing.");
+    }
+    // Blocker check
+    const payload = snapshot.payload ?? {};
+    const blockerText = Array.isArray(payload.blockers) ? payload.blockers.join(", ") : "";
+    if (blockerText.length > 0) {
+        hasBlockers = true;
+        valid = false;
+        notes.push(`Unresolved blockers: ${blockerText.slice(0, 100)}`);
+    }
+    // NeedSync check
+    if (checkpoint?.needSync) {
+        needsSync = true;
+        valid = false;
+        notes.push("Latest checkpoint flagged needSync — coordinate before continuing.");
+    }
+    return {
+        valid,
+        stale,
+        staleReason,
+        scopeMatch,
+        hasBlockers,
+        hasEvidence,
+        needsSync,
+        notes,
+    };
+}
+// ══════════════════════════════════════════════════════
+// Protocol Gate Prompt Formatter
+// ══════════════════════════════════════════════════════
+/**
+ * Format the protocol gate as a prompt section.
+ * This is the "you must obey these rules" block.
+ */
+export function formatProtocolGatePrompt(gate) {
+    if (gate.rules.length === 0)
+        return "";
+    const lines = [];
+    lines.push("# Protocol Gate");
+    lines.push("These are hard collaboration rules. You MUST obey them.");
+    lines.push("");
+    // Group by source
+    const bySource = new Map();
+    for (const r of gate.rules) {
+        const list = bySource.get(r.source) ?? [];
+        list.push(r);
+        bySource.set(r.source, list);
+    }
+    const labels = {
+        "pinned-memory": "Pinned Rules",
+        "peer-contract": "Contract Constraints",
+        "resource-claim": "Resource Ownership",
+        "sync-gate": "Sync Gates (BLOCKING)",
+        "checkpoint-review": "Checkpoint Reviews",
+        "review": "Pending Reviews",
+        "wake": "Queued Actions",
+        "assignment": "Assignment State",
+        "projection": "Projected Reality Rules",
+    };
+    for (const [source, rules] of bySource) {
+        lines.push(`## ${labels[source] ?? source}`);
+        for (const r of rules) {
+            const marker = r.severity === "hard" ? "⛔" : r.severity === "soft" ? "⚠" : "ℹ";
+            lines.push(`- ${marker} ${r.summary}`);
+        }
+        lines.push("");
+    }
+    if (gate.blocked) {
+        lines.push("**⛔ BLOCKED — resolve hard blockers before proceeding.**");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format snapshot validation as a prompt section.
+ */
+export function formatValidationNotes(validation) {
+    if (validation.notes.length === 0)
+        return "";
+    const lines = [];
+    lines.push("# Validation Notes");
+    for (const n of validation.notes) {
+        lines.push(`- ${n}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Format the snapshot as the main working context prompt section.
+ */
+export function formatSnapshotReality(snapshot) {
+    if (!snapshot)
+        return "";
+    const p = snapshot.payload ?? {};
+    const s = (k) => {
+        const v = p[k];
+        if (Array.isArray(v))
+            return v.join(", ");
+        return typeof v === "string" ? v : "";
+    };
+    const lines = [];
+    lines.push("# Snapshot Reality");
+    lines.push("This is your current task working memory. Act on this.");
+    lines.push("");
+    if (s("intentScope"))
+        lines.push(`**Intent scope**: ${s("intentScope")}`);
+    if (s("goal"))
+        lines.push(`**Goal**: ${s("goal")}`);
+    if (s("currentPhase"))
+        lines.push(`**Phase**: ${s("currentPhase")}`);
+    if (s("nonGoals"))
+        lines.push(`**Non-goals**: ${s("nonGoals")}`);
+    if (s("verifiedFacts"))
+        lines.push(`**Verified facts**: ${s("verifiedFacts")}`);
+    if (s("unverifiedClaims"))
+        lines.push(`**Unverified claims**: ${s("unverifiedClaims")}`);
+    if (s("confirmedDecisions"))
+        lines.push(`**Decisions**: ${s("confirmedDecisions")}`);
+    if (s("activeConstraints"))
+        lines.push(`**Active constraints**: ${s("activeConstraints")}`);
+    if (s("workingResources"))
+        lines.push(`**Working resources**: ${s("workingResources")}`);
+    if (s("completedWork"))
+        lines.push(`**Done**: ${s("completedWork")}`);
+    if (s("remainingWork"))
+        lines.push(`**Remaining**: ${s("remainingWork")}`);
+    if (s("nextSteps"))
+        lines.push(`**Next steps**: ${s("nextSteps")}`);
+    if (s("risks"))
+        lines.push(`**Risks**: ${s("risks")}`);
+    if (s("blockers"))
+        lines.push(`**Blockers**: ${s("blockers")}`);
+    if (s("doNotTouch"))
+        lines.push(`**Do not touch**: ${s("doNotTouch")}`);
+    lines.push("");
+    if (s("resumePrompt")) {
+        lines.push("## Resume Instructions");
+        lines.push(s("resumePrompt"));
+        lines.push("");
+    }
+    if (s("handoffInstructions")) {
+        lines.push("## Handoff Instructions");
+        lines.push(s("handoffInstructions"));
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=protocol-gate-service.js.map

package/dist/server/application/protocol-gate-service.js.map

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

package/dist/server/application/reality-projection-service.d.ts

@@ -0,0 +1,38 @@
+/**
+ * P3A — Projection Service (server-side orchestrator).
+ *
+ * Bridges collectProjectMemories → compileProjection.
+ * Read-only: never mutates snapshot, checkpoint, or contract.
+ *
+ * PR3: In-memory read-through projection cache.
+ * Lookup key excludes memoryVersion → lazy invalidation on version bump.
+ * Fingerprints are pre-filtered (skip stale/invalid) to match compiler behavior.
+ */
+import { RealityProjection, ProjectionContext } from "../../context/index.js";
+import "./_scope-matchers.js";
+export interface ProjectionCacheStats {
+    size: number;
+    maxSize: number;
+    hits: number;
+    misses: number;
+    evictions: number;
+    invalidations: number;
+}
+/** Get projection cache statistics. */
+export declare function getProjectionCacheStats(): ProjectionCacheStats;
+/** Clear the projection cache. */
+export declare function clearProjectionCache(): void;
+/** Set the maximum cache size. */
+export declare function setProjectionCacheMaxSize(max: number): void;
+/**
+ * Build a projected reality for a given task.
+ * Orchestrates: collect canonical memories → compile projection.
+ *
+ * Uses an in-memory read-through cache:
+ *   1. Collect memories, pre-filter stale/invalid, compute lookupKey (no memoryVersion)
+ *   2. If cache has entry with matching lookupKey AND same memoryVersion → hit
+ *   3. If lookupKey exists but memoryVersion differs → lazy invalidation
+ *   4. Otherwise compile, store under lookupKey, and return
+ */
+export declare function buildProjection(ctx: Omit<ProjectionContext, "memoryVersion">): RealityProjection;
+//# sourceMappingURL=reality-projection-service.d.ts.map

package/dist/server/application/reality-projection-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality-projection-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/reality-projection-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsD,iBAAiB,EAAE,iBAAiB,EAAyB,MAAM,wBAAwB,CAAC;AAMzJ,OAAO,sBAAsB,CAAC;AAsC9B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,uCAAuC;AACvC,wBAAgB,uBAAuB,IAAI,oBAAoB,CAM9D;AAED,kCAAkC;AAClC,wBAAgB,oBAAoB,IAAI,IAAI,CAG3C;AAED,kCAAkC;AAClC,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG3D;AAID;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,GAAG,iBAAiB,CA2DhG"}

package/dist/server/application/reality-projection-service.js

@@ -0,0 +1,120 @@
+/**
+ * P3A — Projection Service (server-side orchestrator).
+ *
+ * Bridges collectProjectMemories → compileProjection.
+ * Read-only: never mutates snapshot, checkpoint, or contract.
+ *
+ * PR3: In-memory read-through projection cache.
+ * Lookup key excludes memoryVersion → lazy invalidation on version bump.
+ * Fingerprints are pre-filtered (skip stale/invalid) to match compiler behavior.
+ */
+import { buildRealityProjection, computeProjectionLookupKey } from "../../context/index.js";
+import { normalizeResourcePath } from "../../kernel/index.js";
+import { collectProjectMemories, getMemoryVersion, } from "../repositories/_exports/context-memory.js";
+import "./_scope-matchers.js";
+import { getProjectRoot } from "./path-resolver.js";
+const DEFAULT_MAX_CACHE_SIZE = 64;
+let _cache = new Map();
+let _maxCacheSize = DEFAULT_MAX_CACHE_SIZE;
+let _stats = { hits: 0, misses: 0, evictions: 0, invalidations: 0 };
+/** Evict least-recently-accessed entries when cache exceeds max size. */
+function evictIfNeeded() {
+    while (_cache.size > _maxCacheSize) {
+        // Map iterates in insertion order; find the entry with oldest lastAccessedAt
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of _cache) {
+            if (entry.lastAccessedAt < oldestTime) {
+                oldestTime = entry.lastAccessedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            _cache.delete(oldestKey);
+            _stats.evictions++;
+        }
+        else {
+            break;
+        }
+    }
+}
+/** Get projection cache statistics. */
+export function getProjectionCacheStats() {
+    return {
+        size: _cache.size,
+        maxSize: _maxCacheSize,
+        ..._stats,
+    };
+}
+/** Clear the projection cache. */
+export function clearProjectionCache() {
+    _cache = new Map();
+    _stats = { hits: 0, misses: 0, evictions: 0, invalidations: 0 };
+}
+/** Set the maximum cache size. */
+export function setProjectionCacheMaxSize(max) {
+    _maxCacheSize = max;
+    evictIfNeeded();
+}
+// ── Build Projection (with cache) ─────────────────────────
+/**
+ * Build a projected reality for a given task.
+ * Orchestrates: collect canonical memories → compile projection.
+ *
+ * Uses an in-memory read-through cache:
+ *   1. Collect memories, pre-filter stale/invalid, compute lookupKey (no memoryVersion)
+ *   2. If cache has entry with matching lookupKey AND same memoryVersion → hit
+ *   3. If lookupKey exists but memoryVersion differs → lazy invalidation
+ *   4. Otherwise compile, store under lookupKey, and return
+ */
+export function buildProjection(ctx) {
+    const memoryVersion = getMemoryVersion();
+    const collected = collectProjectMemories(ctx.taskId);
+    // Normalize workingResources to absolute paths so they match
+    // normalized appliesTo scope patterns during projection building
+    const root = getProjectRoot();
+    const normalizedCtx = {
+        ...ctx,
+        workingResources: ctx.workingResources?.map(r => normalizeResourcePath(r, { projectRoot: root })),
+        workingResourceRefs: ctx.workingResourceRefs?.map(r => ({
+            ...r,
+            locator: r.type === "file" ? normalizeResourcePath(r.locator, { projectRoot: root }) : r.locator,
+        })),
+    };
+    // CollectedMemory extends ProjectionInput — direct assignment, no mapping needed
+    const inputs = collected;
+    // Pre-filter: skip stale/invalid inputs before computing lookup key
+    // This matches the compiler's filtering, ensuring lookup key consistency
+    // with the returned projection.cacheKey.
+    const relevantFingerprints = inputs
+        .filter(m => m.validityStatus !== "invalid" && m.validityStatus !== "stale")
+        .map(m => m.fingerprint)
+        .filter(Boolean);
+    const fullCtx = { ...normalizedCtx, memoryVersion };
+    // Lookup key excludes memoryVersion → same key across version bumps
+    const lookupKey = computeProjectionLookupKey(fullCtx, relevantFingerprints);
+    // Cache lookup
+    const cached = _cache.get(lookupKey);
+    if (cached && cached.memoryVersion === memoryVersion) {
+        cached.lastAccessedAt = Date.now();
+        _stats.hits++;
+        return cached.projection;
+    }
+    // Lazy invalidation: entry exists but memoryVersion changed
+    if (cached) {
+        _cache.delete(lookupKey);
+        _stats.invalidations++;
+    }
+    // Cache miss — compile
+    _stats.misses++;
+    const projection = buildRealityProjection(inputs, fullCtx);
+    // Store in cache under lookupKey
+    _cache.set(lookupKey, {
+        projection,
+        memoryVersion,
+        lastAccessedAt: Date.now(),
+    });
+    evictIfNeeded();
+    return projection;
+}
+//# sourceMappingURL=reality-projection-service.js.map

package/dist/server/application/reality-projection-service.js.map

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