@gridlock/orchestrator 0.1.0

package/dist/investigation/CaseFile.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Scenario File (#238, #240, #241)
+ *
+ * The player's structured record of their progress through a scenario.
+ * Combines evidence, profiles, timeline, and findings into a coherent
+ * view. Computed from DiscoveryLayer — never stores state independently.
+ *
+ * Engine-generic: operates on DiscoveryLayer, FactRecords, and Findings.
+ * No product vocabulary.
+ *
+ * MS-28 #887 — Phase 1.2 — Orchestrator migration step 5.5b / 5.9.
+ */
+import type { FactSourceType } from './types.js';
+import type { DiscoveryLayer, DiscoveryProgress } from './DiscoveryLayer.js';
+import type { Finding } from '@gridlock/validators';
+/**
+ * A snapshot of the scenario file at a point in time.
+ */
+export interface CaseFileSnapshot {
+    evidence: CaseFileEvidence[];
+    entities: CaseFileEntity[];
+    findings: CaseFileFinding[];
+    summary: CaseFileSummary;
+}
+export interface CaseFileEvidence {
+    id: string;
+    statement: string;
+    sourceType: FactSourceType;
+    sourceId: string;
+    reliability: string;
+    discoveredAt: string;
+}
+export interface CaseFileEntity {
+    id: string;
+    name: string;
+    type: string;
+}
+export interface CaseFileFinding {
+    id: string;
+    text: string;
+    kind: string;
+    relatedEntityIds: string[];
+}
+export interface CaseFileSummary {
+    totalEvidence: number;
+    totalEntities: number;
+    totalFindings: number;
+    progress: DiscoveryProgress;
+}
+export declare class CaseFile {
+    private discoveryLayer;
+    private findings;
+    constructor(discoveryLayer: DiscoveryLayer, findings: Finding[]);
+    /**
+     * Build a complete snapshot of the scenario file.
+     */
+    build(): CaseFileSnapshot;
+    /**
+     * Get all discovered evidence as file entries.
+     */
+    getEvidence(): CaseFileEvidence[];
+    /**
+     * Get all discovered entities.
+     */
+    getEntities(): CaseFileEntity[];
+    /**
+     * Get all findings.
+     */
+    getFindings(): CaseFileFinding[];
+    /**
+     * Get file summary with completeness metrics (#241).
+     */
+    getSummary(): CaseFileSummary;
+    /**
+     * Get evidence related to a specific entity.
+     */
+    getEvidenceByEntity(entityId: string): CaseFileEvidence[];
+    /**
+     * Get evidence grouped by source type.
+     */
+    getEvidenceBySource(sourceType: FactSourceType): CaseFileEvidence[];
+    /**
+     * Get evidence in chronological discovery order.
+     */
+    getEvidenceTimeline(): CaseFileEvidence[];
+    /**
+     * Get evidence grouped by reliability level.
+     */
+    getEvidenceByReliability(): Record<string, CaseFileEvidence[]>;
+    private _toEvidence;
+}
+//# sourceMappingURL=CaseFile.d.ts.map

package/dist/investigation/CaseFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaseFile.d.ts","sourceRoot":"","sources":["../../src/investigation/CaseFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAkB,MAAM,qBAAqB,CAAC;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,qBAAa,QAAQ;IAEjB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;gBADR,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,OAAO,EAAE;IAG7B;;OAEG;IACH,KAAK,IAAI,gBAAgB;IASzB;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE;IAIjC;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;OAEG;IACH,WAAW,IAAI,eAAe,EAAE;IAShC;;OAEG;IACH,UAAU,IAAI,eAAe;IAW7B;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IASzD;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,gBAAgB,EAAE;IAMnE;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,EAAE;IAMzC;;OAEG;IACH,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAU9D,OAAO,CAAC,WAAW;CAUpB"}

package/dist/investigation/CaseFile.js

@@ -0,0 +1,117 @@
+/**
+ * Scenario File (#238, #240, #241)
+ *
+ * The player's structured record of their progress through a scenario.
+ * Combines evidence, profiles, timeline, and findings into a coherent
+ * view. Computed from DiscoveryLayer — never stores state independently.
+ *
+ * Engine-generic: operates on DiscoveryLayer, FactRecords, and Findings.
+ * No product vocabulary.
+ *
+ * MS-28 #887 — Phase 1.2 — Orchestrator migration step 5.5b / 5.9.
+ */
+export class CaseFile {
+    discoveryLayer;
+    findings;
+    constructor(discoveryLayer, findings) {
+        this.discoveryLayer = discoveryLayer;
+        this.findings = findings;
+    }
+    /**
+     * Build a complete snapshot of the scenario file.
+     */
+    build() {
+        return {
+            evidence: this.getEvidence(),
+            entities: this.getEntities(),
+            findings: this.getFindings(),
+            summary: this.getSummary(),
+        };
+    }
+    /**
+     * Get all discovered evidence as file entries.
+     */
+    getEvidence() {
+        return this.discoveryLayer.getDiscoveredFacts().map(r => this._toEvidence(r));
+    }
+    /**
+     * Get all discovered entities.
+     */
+    getEntities() {
+        return this.discoveryLayer.getDiscoveredEntities();
+    }
+    /**
+     * Get all findings.
+     */
+    getFindings() {
+        return this.findings.map(f => ({
+            id: f.id,
+            text: f.text,
+            kind: f.kind,
+            relatedEntityIds: f.relatedEntities.map(e => e.id),
+        }));
+    }
+    /**
+     * Get file summary with completeness metrics (#241).
+     */
+    getSummary() {
+        return {
+            totalEvidence: this.discoveryLayer.getDiscoveredFacts().length,
+            totalEntities: this.discoveryLayer.getDiscoveredEntities().length,
+            totalFindings: this.findings.length,
+            progress: this.discoveryLayer.getDiscoveryProgress(),
+        };
+    }
+    // --- Evidence grouping methods (#240) ---
+    /**
+     * Get evidence related to a specific entity.
+     */
+    getEvidenceByEntity(entityId) {
+        return this.discoveryLayer.getDiscoveredFacts()
+            .filter(r => r.subject === entityId
+            || r.relatedCharacterIds.includes(entityId)
+            || r.relatedArtifactIds.includes(entityId)
+            || r.relatedEntities?.some(e => e.id === entityId))
+            .map(r => this._toEvidence(r));
+    }
+    /**
+     * Get evidence grouped by source type.
+     */
+    getEvidenceBySource(sourceType) {
+        return this.discoveryLayer.getDiscoveredFacts()
+            .filter(r => r.sourceType === sourceType)
+            .map(r => this._toEvidence(r));
+    }
+    /**
+     * Get evidence in chronological discovery order.
+     */
+    getEvidenceTimeline() {
+        return this.discoveryLayer.getDiscoveredFacts()
+            .sort((a, b) => a.discoveredAt.localeCompare(b.discoveredAt))
+            .map(r => this._toEvidence(r));
+    }
+    /**
+     * Get evidence grouped by reliability level.
+     */
+    getEvidenceByReliability() {
+        const grouped = { low: [], medium: [], high: [] };
+        for (const r of this.discoveryLayer.getDiscoveredFacts()) {
+            const level = r.reliability ?? r.confidence;
+            if (!grouped[level])
+                grouped[level] = [];
+            grouped[level].push(this._toEvidence(r));
+        }
+        return grouped;
+    }
+    _toEvidence(r) {
+        return {
+            id: r.id,
+            statement: r.statement,
+            sourceType: r.sourceType,
+            sourceId: r.sourceId,
+            reliability: r.reliability ?? r.confidence,
+            discoveredAt: r.discoveredAt,
+        };
+    }
+}
+//# sourceMappingURL=CaseFile.js.map

package/dist/investigation/CaseFile.js.map

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

package/dist/investigation/DiscoveryLayer.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Discovery Layer — engine-generic (#233, #236, #887 step 5.6/5.9)
+ *
+ * A filtered projection of the scenario representing only what the
+ * player has discovered. This is the formal boundary between world
+ * truth and player knowledge.
+ *
+ * Rules:
+ * - Analytical subsystems read ONLY from DiscoveryLayer
+ * - Profiles are built ONLY from DiscoveryLayer data
+ * - Engine may access full scenario for validation
+ *
+ * Engine-generic: parameterised with ScenarioEntityProvider so the
+ * engine never navigates product-specific scenario shapes directly.
+ * Products inject a provider that maps their scenario type into
+ * the entity/fact lists the DiscoveryLayer needs.
+ *
+ * No product vocabulary: no suspect, crime, case, accusation,
+ * investigation, contradiction.
+ */
+import type { FactRecord } from './types.js';
+import type { FactLedger } from './FactLedger.js';
+import type { EvidenceGraph } from '../EvidenceGraph.js';
+/**
+ * Structured discovery event (#236).
+ * Emitted when a new entity, fact, or relationship is discovered.
+ */
+export interface DiscoveryEvent {
+    type: 'entity' | 'fact' | 'relationship';
+    id: string;
+    timestamp: string;
+    trigger: string;
+}
+/**
+ * Discovery progress — how much of the discoverable content has been found.
+ */
+export interface DiscoveryProgress {
+    discoveredEntities: number;
+    totalEntities: number;
+    discoveredFacts: number;
+    totalFacts: number;
+    discoveredArtifacts: number;
+    totalArtifacts: number;
+    /**
+     * Entities the player has discovered (seen they exist) but cannot yet
+     * interact with because they are still gated behind unlock thresholds.
+     * Lets the progress percentage be read in context.
+     */
+    blockedArtifacts: number;
+    percentage: number;
+}
+/**
+ * An entity descriptor returned by the ScenarioEntityProvider.
+ * Minimal shape — just enough for the DiscoveryLayer to work with.
+ */
+export interface ScenarioEntity {
+    id: string;
+    name: string;
+    type: string;
+}
+/**
+ * ScenarioEntityProvider — product-layer bridge that supplies
+ * scenario-specific entity and fact data to the DiscoveryLayer.
+ *
+ * The engine never navigates the product's scenario shape directly.
+ * Instead, the product injects a provider that returns the entity
+ * lists and counts the DiscoveryLayer needs. This keeps the
+ * DiscoveryLayer engine-generic.
+ */
+export interface ScenarioEntityProvider {
+    /** All entities in the scenario that can be discovered. */
+    getAllEntities(): ScenarioEntity[];
+    /** Total count of discoverable facts across all sources. */
+    getTotalFactCount(): number;
+    /** Total count of discoverable artifacts/evidence items. */
+    getTotalArtifactCount(): number;
+}
+export declare class DiscoveryLayer {
+    private entityProvider;
+    private factLedger;
+    private discoveredGraph;
+    private discoveredEntityIds;
+    private examinedEntityIds;
+    private unlockedEntityIds;
+    private events;
+    /** Cached set of entity IDs referenced by discovered facts. */
+    private _factRefCache;
+    private _factRefCacheSize;
+    constructor(entityProvider: ScenarioEntityProvider, factLedger: FactLedger, discoveredGraph: EvidenceGraph, discoveredEntityIds: Set<string>, examinedEntityIds: Set<string>, unlockedEntityIds: Set<string>);
+    /**
+     * Get all entities the player has discovered.
+     */
+    getDiscoveredEntities(): ScenarioEntity[];
+    /**
+     * Get only facts from examined/talked sources.
+     */
+    getDiscoveredFacts(): FactRecord[];
+    /**
+     * Get only relationships where both endpoints are discovered.
+     */
+    getDiscoveredRelationships(): Array<{
+        sourceId: string;
+        targetId: string;
+        relationship: string;
+    }>;
+    /**
+     * Check if the player knows about an entity.
+     * Uses explicit tracking sets first, then falls back to fact references.
+     */
+    isDiscovered(entityId: string): boolean;
+    /**
+     * Build/return cached set of entity IDs referenced by discovered facts.
+     * Invalidated when ledger size changes.
+     */
+    private _getFactReferencedEntityIds;
+    /**
+     * Get discovery progress — % of discoverable content found.
+     */
+    getDiscoveryProgress(): DiscoveryProgress;
+    /**
+     * Record a discovery event (#236).
+     */
+    recordDiscovery(type: DiscoveryEvent['type'], id: string, trigger: string): void;
+    /**
+     * Get all discovery events in chronological order (#236).
+     */
+    getDiscoveryEvents(): DiscoveryEvent[];
+    /**
+     * Get the set of all discovered node IDs.
+     */
+    private _getDiscoveredNodeIds;
+}
+//# sourceMappingURL=DiscoveryLayer.d.ts.map

package/dist/investigation/DiscoveryLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveryLayer.d.ts","sourceRoot":"","sources":["../../src/investigation/DiscoveryLayer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,CAAC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,cAAc,IAAI,cAAc,EAAE,CAAC;IACnC,4DAA4D;IAC5D,iBAAiB,IAAI,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,qBAAqB,IAAI,MAAM,CAAC;CACjC;AAMD,qBAAa,cAAc;IAOvB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,iBAAiB;IAX3B,OAAO,CAAC,MAAM,CAAwB;IACtC,+DAA+D;IAC/D,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,iBAAiB,CAAM;gBAGrB,cAAc,EAAE,sBAAsB,EACtC,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,aAAa,EAC9B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,EAChC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC;IAGxC;;OAEG;IACH,qBAAqB,IAAI,cAAc,EAAE;IAIzC;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAIlC;;OAEG;IACH,0BAA0B,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAUjG;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUvC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAenC;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;IAuCzC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAShF;;OAEG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAItC;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAwB9B"}

package/dist/investigation/DiscoveryLayer.js

@@ -0,0 +1,176 @@
+/**
+ * Discovery Layer — engine-generic (#233, #236, #887 step 5.6/5.9)
+ *
+ * A filtered projection of the scenario representing only what the
+ * player has discovered. This is the formal boundary between world
+ * truth and player knowledge.
+ *
+ * Rules:
+ * - Analytical subsystems read ONLY from DiscoveryLayer
+ * - Profiles are built ONLY from DiscoveryLayer data
+ * - Engine may access full scenario for validation
+ *
+ * Engine-generic: parameterised with ScenarioEntityProvider so the
+ * engine never navigates product-specific scenario shapes directly.
+ * Products inject a provider that maps their scenario type into
+ * the entity/fact lists the DiscoveryLayer needs.
+ *
+ * No product vocabulary: no suspect, crime, case, accusation,
+ * investigation, contradiction.
+ */
+// ---------------------------------------------------------------------------
+// DiscoveryLayer
+// ---------------------------------------------------------------------------
+export class DiscoveryLayer {
+    entityProvider;
+    factLedger;
+    discoveredGraph;
+    discoveredEntityIds;
+    examinedEntityIds;
+    unlockedEntityIds;
+    events = [];
+    /** Cached set of entity IDs referenced by discovered facts. */
+    _factRefCache = null;
+    _factRefCacheSize = -1;
+    constructor(entityProvider, factLedger, discoveredGraph, discoveredEntityIds, examinedEntityIds, unlockedEntityIds) {
+        this.entityProvider = entityProvider;
+        this.factLedger = factLedger;
+        this.discoveredGraph = discoveredGraph;
+        this.discoveredEntityIds = discoveredEntityIds;
+        this.examinedEntityIds = examinedEntityIds;
+        this.unlockedEntityIds = unlockedEntityIds;
+    }
+    /**
+     * Get all entities the player has discovered.
+     */
+    getDiscoveredEntities() {
+        return this.entityProvider.getAllEntities().filter(e => this.isDiscovered(e.id));
+    }
+    /**
+     * Get only facts from examined/talked sources.
+     */
+    getDiscoveredFacts() {
+        return this.factLedger.getAll();
+    }
+    /**
+     * Get only relationships where both endpoints are discovered.
+     */
+    getDiscoveredRelationships() {
+        const discoveredIds = this._getDiscoveredNodeIds();
+        const subgraph = this.discoveredGraph.getDiscoveredSubgraph(discoveredIds);
+        return subgraph.getAllEdges().map(e => ({
+            sourceId: e.sourceId,
+            targetId: e.targetId,
+            relationship: e.relationship,
+        }));
+    }
+    /**
+     * Check if the player knows about an entity.
+     * Uses explicit tracking sets first, then falls back to fact references.
+     */
+    isDiscovered(entityId) {
+        if (this.discoveredEntityIds.has(entityId)
+            || this.unlockedEntityIds.has(entityId)
+            || this.examinedEntityIds.has(entityId)) {
+            return true;
+        }
+        return this._getFactReferencedEntityIds().has(entityId);
+    }
+    /**
+     * Build/return cached set of entity IDs referenced by discovered facts.
+     * Invalidated when ledger size changes.
+     */
+    _getFactReferencedEntityIds() {
+        if (this._factRefCache && this._factRefCacheSize === this.factLedger.size) {
+            return this._factRefCache;
+        }
+        const ids = new Set();
+        for (const fact of this.factLedger.getAll()) {
+            for (const ref of fact.relatedEntities ?? []) {
+                ids.add(ref.id);
+            }
+        }
+        this._factRefCache = ids;
+        this._factRefCacheSize = this.factLedger.size;
+        return ids;
+    }
+    /**
+     * Get discovery progress — % of discoverable content found.
+     */
+    getDiscoveryProgress() {
+        const allEntities = this.entityProvider.getAllEntities();
+        const discoveredEntities = allEntities.filter(e => this.isDiscovered(e.id)).length;
+        const totalEntities = allEntities.length;
+        const totalFacts = this.entityProvider.getTotalFactCount();
+        const discoveredFacts = this.factLedger.size;
+        const totalArtifacts = this.entityProvider.getTotalArtifactCount();
+        const discoveredArtifacts = this.examinedEntityIds.size;
+        // Blocked count: entities discovered but not yet examinable.
+        // Product layers can refine this with RICE threshold checks.
+        let blockedArtifacts = 0;
+        for (const id of this.discoveredEntityIds) {
+            if (this.examinedEntityIds.has(id))
+                continue;
+            if (!this.unlockedEntityIds.has(id)) {
+                blockedArtifacts++;
+            }
+        }
+        const totalDiscoverable = totalEntities + totalFacts + totalArtifacts;
+        const totalDiscovered = discoveredEntities + discoveredFacts + discoveredArtifacts;
+        const percentage = totalDiscoverable > 0
+            ? Math.round((totalDiscovered / totalDiscoverable) * 100)
+            : 0;
+        return {
+            discoveredEntities,
+            totalEntities,
+            discoveredFacts,
+            totalFacts,
+            discoveredArtifacts,
+            totalArtifacts,
+            blockedArtifacts,
+            percentage,
+        };
+    }
+    /**
+     * Record a discovery event (#236).
+     */
+    recordDiscovery(type, id, trigger) {
+        this.events.push({
+            type,
+            id,
+            timestamp: new Date().toISOString(),
+            trigger,
+        });
+    }
+    /**
+     * Get all discovery events in chronological order (#236).
+     */
+    getDiscoveryEvents() {
+        return [...this.events];
+    }
+    /**
+     * Get the set of all discovered node IDs.
+     */
+    _getDiscoveredNodeIds() {
+        const ids = new Set();
+        for (const e of this.entityProvider.getAllEntities()) {
+            if (this.isDiscovered(e.id)) {
+                ids.add(e.id);
+            }
+        }
+        // Add all fact IDs from the ledger
+        for (const record of this.factLedger.getAll()) {
+            if (record.originFactId)
+                ids.add(record.originFactId);
+        }
+        // Add finding IDs
+        for (const node of this.discoveredGraph.getNodesByType('finding')) {
+            ids.add(node.id);
+        }
+        for (const node of this.discoveredGraph.getNodesByType('validator')) {
+            ids.add(node.id);
+        }
+        return ids;
+    }
+}
+//# sourceMappingURL=DiscoveryLayer.js.map

package/dist/investigation/DiscoveryLayer.js.map

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

package/dist/investigation/FactLedger.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Investigation Layer — Fact Ledger
+ *
+ * The Fact Ledger is the structured investigation memory for a single run.
+ * It stores FactRecords derived from evidence-layer outputs (artifacts,
+ * dialogue, validator findings) and organizes them for player-facing tools.
+ *
+ * Architectural boundary:
+ * - The Evidence Layer (Facts, Validators, Findings) produces truth.
+ * - The Fact Ledger records and organizes that truth.
+ * - The Fact Ledger never modifies validator outcomes or evidence-layer state.
+ */
+import { FactRecord, FactStatus, FactConfidence, FactSourceType } from './types.js';
+export declare class FactLedger {
+    private records;
+    /**
+     * Add a new FactRecord to the ledger.
+     * Duplicates are detected by (sourceType + sourceId + subject + statement).
+     * Returns true if the record was added, false if it was a duplicate.
+     */
+    add(record: FactRecord): boolean;
+    /**
+     * Retrieve a record by its unique id.
+     */
+    getById(id: string): FactRecord | undefined;
+    /**
+     * Retrieve all records for a given subject.
+     */
+    getBySubject(subject: string): FactRecord[];
+    /**
+     * Retrieve all records with a given status.
+     */
+    getByStatus(status: FactStatus): FactRecord[];
+    /**
+     * Retrieve all records from a given source type.
+     */
+    getBySourceType(sourceType: FactSourceType): FactRecord[];
+    /**
+     * Update the status and optionally the confidence of a record.
+     */
+    updateStatus(id: string, status: FactStatus, confidence?: FactConfidence): void;
+    /**
+     * Retrieve a record by its original case-schema fact ID.
+     * Bridges FactLedger identity ↔ Evidence Graph node identity.
+     */
+    getByOriginFactId(originFactId: string): FactRecord | undefined;
+    /**
+     * Add a related fact link to a record.
+     */
+    addRelatedFact(id: string, relatedFactId: string): void;
+    /**
+     * Update the reliability (confidence) of a record without changing its status. (#229)
+     */
+    updateReliability(id: string, confidence: FactConfidence): void;
+    /**
+     * Retrieve all records mentioning an entity (via relatedEntities, entityRefs, or legacy fields).
+     */
+    getByEntity(entityId: string): FactRecord[];
+    /**
+     * Retrieve all records from a given discovery method (sourceType alias).
+     */
+    getByMethod(method: FactSourceType): FactRecord[];
+    /**
+     * Retrieve all records at a given reliability (confidence) level.
+     */
+    getByReliability(level: FactConfidence): FactRecord[];
+    /**
+     * Retrieve the full transitive chain of related facts starting from a given fact.
+     * Follows relatedFactIds links recursively, avoiding cycles.
+     */
+    getRelatedFacts(factId: string): FactRecord[];
+    /**
+     * Trace back to the root source of a fact via relatedFactIds.
+     * Returns the chain from the given fact to the earliest ancestor.
+     */
+    getProvenanceChain(factId: string): FactRecord[];
+    /**
+     * Get all records in the ledger.
+     */
+    getAll(): FactRecord[];
+    /**
+     * Get the total number of records.
+     */
+    get size(): number;
+    /**
+     * Duplicate detection using stable identity:
+     * sourceType + sourceId + subject + statement
+     */
+    private _isDuplicate;
+}
+//# sourceMappingURL=FactLedger.d.ts.map

package/dist/investigation/FactLedger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactLedger.d.ts","sourceRoot":"","sources":["../../src/investigation/FactLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAoB;IAEnC;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO;IAQhC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI3C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAI3C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE;IAI7C;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,UAAU,EAAE;IAIzD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI;IAW/E;;;OAGG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/D;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAUvD;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,IAAI;IAU/D;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAU3C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,EAAE;IAIjD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,EAAE;IAIrD;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAmB7C;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAqBhD;;OAEG;IACH,MAAM,IAAI,UAAU,EAAE;IAItB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,OAAO,CAAC,YAAY;CASrB"}