@happyvertical/smrt-facts 0.51.32 → 0.51.33

package/dist/__smrt-register__.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__smrt-register__.d.ts.map

package/dist/__smrt-register__.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__smrt-register__.d.ts","sourceRoot":"","sources":["../src/__smrt-register__.ts"],"names":[],"mappings":""}

package/dist/__tests__/fixtures/decision-claim-support-3166.d.ts

@@ -0,0 +1,33 @@
+import type { FactClaimSupportCandidate, FactClaimSupportStatus } from '../../types';
+export interface RationaleConstraint {
+    kind: 'candidate_scope' | 'grounded' | 'missing_portion' | 'empty_claim';
+    example: string;
+    requiredTerms: string[];
+}
+export interface DecisionClaimSupportFixture {
+    id: 'direct-support' | 'candidate-miss' | 'combined-support' | 'direct-contradiction' | 'conflicting-sources' | 'partial-support' | 'empty-candidates' | 'empty-claim';
+    claim: string;
+    candidates: FactClaimSupportCandidate[];
+    expectedStatus: FactClaimSupportStatus;
+    expectedSupportingFactIds: string[];
+    expectedSupportingEvidenceIds: string[];
+    expectedContradictingFactIds: string[];
+    expectedContradictingEvidenceIds: string[];
+    rationaleConstraint: RationaleConstraint;
+}
+export interface InvalidDecisionClaimSupportResponseFixture {
+    claim: string;
+    candidates: FactClaimSupportCandidate[];
+    rawResponse: {
+        status: FactClaimSupportStatus;
+        supportingFactIds: string[];
+        supportingEvidenceIds: string[];
+        contradictingFactIds: string[];
+        contradictingEvidenceIds: string[];
+    };
+    expectedNormalizedStatus: 'needs_review';
+    expectedErrors: Array<'unknown_fact' | 'evidence_fact_mismatch'>;
+}
+export declare const decisionClaimSupportFixtures: DecisionClaimSupportFixture[];
+export declare const invalidDecisionClaimSupportResponseFixture: InvalidDecisionClaimSupportResponseFixture;
+//# sourceMappingURL=decision-claim-support-3166.d.ts.map

package/dist/__tests__/fixtures/decision-claim-support-3166.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-claim-support-3166.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/decision-claim-support-3166.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,GAAG,UAAU,GAAG,iBAAiB,GAAG,aAAa,CAAC;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EACE,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,sBAAsB,GACtB,qBAAqB,GACrB,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,cAAc,EAAE,sBAAsB,CAAC;IACvC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,6BAA6B,EAAE,MAAM,EAAE,CAAC;IACxC,4BAA4B,EAAE,MAAM,EAAE,CAAC;IACvC,gCAAgC,EAAE,MAAM,EAAE,CAAC;IAC3C,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,MAAM,WAAW,0CAA0C;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,WAAW,EAAE;QACX,MAAM,EAAE,sBAAsB,CAAC;QAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAChC,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,wBAAwB,EAAE,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,wBAAwB,EAAE,cAAc,CAAC;IACzC,cAAc,EAAE,KAAK,CAAC,cAAc,GAAG,wBAAwB,CAAC,CAAC;CAClE;AAED,eAAO,MAAM,4BAA4B,EAAE,2BAA2B,EAkLrE,CAAC;AAEF,eAAO,MAAM,0CAA0C,EAAE,0CAwBtD,CAAC"}

package/dist/catalog-search.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Encode JavaScript lowercase UTF-16 units as aligned ASCII tokens. SQL's
+ * Unicode/collation rules never participate in substring matching. The `x`
+ * separator cannot occur inside a hex unit, so matches cannot start mid-unit.
+ */
+export declare function encodeCatalogSearch(value: string): string;
+//# sourceMappingURL=catalog-search.d.ts.map

package/dist/catalog-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-search.d.ts","sourceRoot":"","sources":["../src/catalog-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD"}

package/dist/fact-content.d.ts

@@ -0,0 +1,39 @@
+/**
+ * FactContent model - Join table between facts and content
+ *
+ * Links facts to content objects (from @happyvertical/smrt-content)
+ * with relationship classification and metadata.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { FactContentOptions, FactContentRelationship } from './types';
+export declare class FactContent extends SmrtObject {
+    factId: string;
+    contentId: string;
+    relationship: string;
+    metadata: string;
+    tenantId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FactContentOptions);
+    /**
+     * Get the relationship type as a typed value
+     */
+    getRelationship(): FactContentRelationship;
+    /**
+     * Get metadata as parsed object
+     */
+    getMetadata(): Record<string, unknown>;
+    /**
+     * Set metadata from object
+     */
+    setMetadata(data: Record<string, unknown>): void;
+    /**
+     * Update metadata by merging with existing values
+     */
+    updateMetadata(updates: Record<string, unknown>): void;
+    /**
+     * Get the fact this content link belongs to
+     */
+    getFact(): Promise<import('./fact').Fact | null>;
+}
+//# sourceMappingURL=fact-content.d.ts.map

package/dist/fact-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-content.d.ts","sourceRoot":"","sources":["../src/fact-content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE3E,qBAOa,WAAY,SAAQ,UAAU;IAEzC,MAAM,EAAE,MAAM,CAAM;IAGpB,SAAS,EAAE,MAAM,CAAM;IAGvB,YAAY,EAAE,MAAM,CAAoB;IAGxC,QAAQ,EAAE,MAAM,CAAM;IAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,IAAI,CAAc;IAE7B,SAAS,EAAE,IAAI,CAAc;gBAEjB,OAAO,GAAE,kBAAuB;IAgB5C;;OAEG;IACH,eAAe,IAAI,uBAAuB;IAI1C;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKtD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CAOvD"}

package/dist/fact-contents.d.ts

@@ -0,0 +1,32 @@
+/**
+ * FactContentCollection — junction collection for Fact ↔ Content links.
+ *
+ * Generic junction surface (byLeft/byRight/attach/detach/setLinks) comes from
+ * `SmrtJunction`. The remaining methods are tenant-scoping helpers.
+ */
+import { SmrtJunction } from '@happyvertical/smrt-core';
+import { FactContent } from './fact-content';
+export declare class FactContentCollection extends SmrtJunction<FactContent> {
+    static readonly _itemClass: typeof FactContent;
+    protected leftField: string;
+    protected rightField: string;
+    protected sortField: string | null;
+    protected positionField: string | null;
+    findByTenant(tenantId: string): Promise<FactContent[]>;
+    /**
+     * Find all global (tenant-less) fact-content links.
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context (an explicit `tenant_id IS NULL` filter would be
+     * flagged as an isolation violation). (#1600)
+     */
+    findGlobal(): Promise<FactContent[]>;
+    /**
+     * Find fact-content links for a tenant including global links.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     */
+    findWithGlobals(tenantId: string): Promise<FactContent[]>;
+}
+//# sourceMappingURL=fact-contents.d.ts.map

package/dist/fact-contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-contents.d.ts","sourceRoot":"","sources":["../src/fact-contents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAQ,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAO7C,qBACa,qBAAsB,SAAQ,YAAY,CAAC,WAAW,CAAC;IAClE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IACzC,SAAS,CAAC,SAAS,SAAY;IAC/B,SAAS,CAAC,UAAU,SAAe;IAEnC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMxC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5D;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1C;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAOhE"}

package/dist/fact-evidence.d.ts

@@ -0,0 +1,37 @@
+/**
+ * FactEvidence model - specific provenance spans for facts
+ *
+ * FactSource remains the coarse source summary. FactEvidence records the
+ * concrete excerpt/span/artifact that supports a fact.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { FactEvidenceOptions, FactEvidenceStatus } from './types';
+export declare class FactEvidence extends SmrtObject {
+    factId: string;
+    evidenceKey: string;
+    status: FactEvidenceStatus;
+    sourceKind: string;
+    sourceId: string;
+    sourceUrl: string;
+    sourceTitle: string;
+    quote: string;
+    locator: string;
+    extractionMethod: string;
+    /**
+     * Extraction confidence in `[0, 1]`. The `0.0` initializer is load-bearing:
+     * SMRT maps `= 0` to INTEGER and `= 0.0` to DECIMAL, so an INTEGER column
+     * would truncate every meaningful score to 0 or 1 and PostgreSQL would
+     * reject the save outright (`22P02`). Matches `Fact.confidence` and
+     * `FactSource.credibility` (#2361).
+     */
+    confidence: number;
+    metadata: string;
+    tenantId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FactEvidenceOptions);
+    getMetadata(): Record<string, unknown>;
+    setMetadata(data: Record<string, unknown>): void;
+    updateMetadata(updates: Record<string, unknown>): void;
+}
+//# sourceMappingURL=fact-evidence.d.ts.map

package/dist/fact-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-evidence.d.ts","sourceRoot":"","sources":["../src/fact-evidence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAkBvE,qBAQa,YAAa,SAAQ,UAAU;IAE1C,MAAM,EAAE,MAAM,CAAM;IAGpB,WAAW,EAAE,MAAM,CAAM;IAGzB,MAAM,EAAE,kBAAkB,CAAc;IAGxC,UAAU,EAAE,MAAM,CAAM;IAGxB,QAAQ,EAAE,MAAM,CAAM;IAGtB,SAAS,EAAE,MAAM,CAAM;IAGvB,WAAW,EAAE,MAAM,CAAM;IAGzB,KAAK,EAAE,MAAM,CAAM;IAGnB,OAAO,EAAE,MAAM,CAAM;IAGrB,gBAAgB,EAAE,MAAM,CAAM;IAE9B;;;;;;OAMG;IAEH,UAAU,EAAE,MAAM,CAAO;IAGzB,QAAQ,EAAE,MAAM,CAAM;IAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;gBAEjB,OAAO,GAAE,mBAAwB;IA2B7C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhD,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAIvD"}

package/dist/fact-evidences.d.ts

@@ -0,0 +1,32 @@
+/**
+ * FactEvidenceCollection - Collection manager for concrete fact evidence.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { FactEvidence } from './fact-evidence';
+import type { FactEvidenceOptions, FactEvidenceStatus } from './types';
+export declare function createFactEvidenceKey(input: Pick<FactEvidenceOptions, 'sourceKind' | 'sourceId' | 'sourceUrl' | 'locator' | 'quote'>): string;
+export declare class FactEvidenceCollection extends SmrtCollection<FactEvidence> {
+    static readonly _itemClass: typeof FactEvidence;
+    getForFact(factId: string): Promise<FactEvidence[]>;
+    getForSource(sourceKind: string, sourceId: string): Promise<FactEvidence[]>;
+    getForSources(sources: Array<{
+        sourceKind: string;
+        sourceId: string;
+    }>): Promise<FactEvidence[]>;
+    bulkUpdateStatus(evidenceIds: string[], status: FactEvidenceStatus, options?: {
+        reason?: string;
+        reviewedBy?: string | null;
+    }): Promise<FactEvidence[]>;
+    replaceGeneratedForSources(sources: Array<{
+        sourceKind: string;
+        sourceId: string;
+    }>, options?: {
+        generatedBy?: string;
+        contentId?: string;
+        tenantId?: string | null;
+    }): Promise<{
+        deletedEvidenceIds: string[];
+    }>;
+    upsertEvidence(options: FactEvidenceOptions): Promise<FactEvidence>;
+}
+//# sourceMappingURL=fact-evidences.d.ts.map

package/dist/fact-evidences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-evidences.d.ts","sourceRoot":"","sources":["../src/fact-evidences.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAuCvE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CACT,mBAAmB,EACnB,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAC9D,GACA,MAAM,CAUR;AAED,qBAAa,sBAAuB,SAAQ,cAAc,CAAC,YAAY,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,UAAU,sBAAgB;IAEpC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAInD,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC;IAOpB,aAAa,CACjB,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GACvD,OAAO,CAAC,YAAY,EAAE,CAAC;IAoBpB,gBAAgB,CACpB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,GAC5D,OAAO,CAAC,YAAY,EAAE,CAAC;IAwBpB,0BAA0B,CAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,EACxD,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACrB,GACL,OAAO,CAAC;QAAE,kBAAkB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4DtC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;CA2C1E"}

package/dist/fact-source.d.ts

@@ -0,0 +1,29 @@
+/**
+ * FactSource model - Provenance tracking for facts
+ *
+ * Records where a fact came from, including source URL, type,
+ * credibility, and extraction timestamp.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { FactSourceOptions } from './types';
+export declare class FactSource extends SmrtObject {
+    factId: string;
+    sourceType: string;
+    sourceUrl: string;
+    sourceTitle: string;
+    credibility: number;
+    extractedAt: Date;
+    metadata: string;
+    tenantId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FactSourceOptions);
+    getMetadata(): Record<string, unknown>;
+    setMetadata(data: Record<string, unknown>): void;
+    updateMetadata(updates: Record<string, unknown>): void;
+    /**
+     * Get the fact this source belongs to
+     */
+    getFact(): Promise<import('./fact').Fact | null>;
+}
+//# sourceMappingURL=fact-source.d.ts.map

package/dist/fact-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-source.d.ts","sourceRoot":"","sources":["../src/fact-source.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,qBAOa,UAAW,SAAQ,UAAU;IAExC,MAAM,EAAE,MAAM,CAAM;IAGpB,UAAU,EAAE,MAAM,CAAM;IAExB,SAAS,EAAE,MAAM,CAAM;IAEvB,WAAW,EAAE,MAAM,CAAM;IAEzB,WAAW,EAAE,MAAM,CAAO;IAE1B,WAAW,EAAE,IAAI,CAAc;IAE/B,QAAQ,EAAE,MAAM,CAAM;IAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,IAAI,CAAc;IAE7B,SAAS,EAAE,IAAI,CAAc;gBAEjB,OAAO,GAAE,iBAAsB;IAoB3C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhD,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKtD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CAOvD"}

package/dist/fact-sources.d.ts

@@ -0,0 +1,50 @@
+/**
+ * FactSourceCollection - Collection manager for FactSource objects
+ *
+ * Provides queries for sources by fact, type, and credibility.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { FactSource } from './fact-source';
+export declare class FactSourceCollection extends SmrtCollection<FactSource> {
+    static readonly _itemClass: typeof FactSource;
+    /**
+     * Get all sources for a given fact
+     */
+    getForFact(factId: string): Promise<FactSource[]>;
+    /**
+     * Count sources for a given fact
+     */
+    countForFact(factId: string): Promise<number>;
+    /**
+     * Get sources by type
+     */
+    getByType(sourceType: string): Promise<FactSource[]>;
+    /**
+     * Get sources with credibility above a threshold
+     */
+    getHighCredibility(minCredibility?: number): Promise<FactSource[]>;
+    /**
+     * Get average credibility for a fact's sources
+     */
+    getAverageCredibility(factId: string): Promise<number>;
+    /**
+     * Find all sources belonging to a specific tenant
+     */
+    findByTenant(tenantId: string): Promise<FactSource[]>;
+    /**
+     * Find all global (tenant-less) sources.
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context (an explicit `tenant_id IS NULL` filter would be
+     * flagged as an isolation violation). (#1600)
+     */
+    findGlobal(): Promise<FactSource[]>;
+    /**
+     * Find sources for a tenant including global sources.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     */
+    findWithGlobals(tenantId: string): Promise<FactSource[]>;
+}
+//# sourceMappingURL=fact-sources.d.ts.map

package/dist/fact-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-sources.d.ts","sourceRoot":"","sources":["../src/fact-sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,qBAAa,oBAAqB,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClE,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAc;IAExC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIvD;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD;;OAEG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI1D;;OAEG;IACG,kBAAkB,CACtB,cAAc,GAAE,MAAY,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB;;OAEG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW5D;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI3D;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAIzC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAO/D"}

package/dist/fact-subject.d.ts

@@ -0,0 +1,28 @@
+/**
+ * FactSubject model - Polymorphic entity linking for facts
+ *
+ * Links facts to any entity type (profiles, places, events, etc.)
+ * using polymorphic entityType + entityId with role classification.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { FactSubjectOptions, SubjectRole } from './types';
+export declare class FactSubject extends SmrtObject {
+    factId: string;
+    entityType: string;
+    entityId: string;
+    role: string;
+    metadata: string;
+    tenantId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FactSubjectOptions);
+    getRole(): SubjectRole;
+    getMetadata(): Record<string, unknown>;
+    setMetadata(data: Record<string, unknown>): void;
+    updateMetadata(updates: Record<string, unknown>): void;
+    /**
+     * Get the fact this subject is linked to
+     */
+    getFact(): Promise<import('./fact').Fact | null>;
+}
+//# sourceMappingURL=fact-subject.d.ts.map

package/dist/fact-subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-subject.d.ts","sourceRoot":"","sources":["../src/fact-subject.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAOa,WAAY,SAAQ,UAAU;IAEzC,MAAM,EAAE,MAAM,CAAM;IAGpB,UAAU,EAAE,MAAM,CAAM;IAGxB,QAAQ,EAAE,MAAM,CAAM;IAGtB,IAAI,EAAE,MAAM,CAAa;IAEzB,QAAQ,EAAE,MAAM,CAAM;IAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,IAAI,CAAc;IAE7B,SAAS,EAAE,IAAI,CAAc;gBAEjB,OAAO,GAAE,kBAAuB;IAgB5C,OAAO,IAAI,WAAW;IAItB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhD,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKtD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CAOvD"}

package/dist/fact-subjects.d.ts

@@ -0,0 +1,56 @@
+/**
+ * FactSubjectCollection - Collection manager for FactSubject objects
+ *
+ * Provides queries for polymorphic entity linking, including
+ * link/unlink operations and entity-centric lookups.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { FactSubject } from './fact-subject';
+import type { SubjectRole } from './types';
+export declare class FactSubjectCollection extends SmrtCollection<FactSubject> {
+    static readonly _itemClass: typeof FactSubject;
+    /**
+     * Get all subjects linked to a fact
+     */
+    getForFact(factId: string): Promise<FactSubject[]>;
+    /**
+     * Get all fact-subject links for a given entity
+     */
+    getForEntity(entityType: string, entityId: string): Promise<FactSubject[]>;
+    /**
+     * Link an entity to a fact
+     */
+    linkEntity(factId: string, entityType: string, entityId: string, role?: SubjectRole): Promise<FactSubject>;
+    /**
+     * Unlink an entity from a fact
+     */
+    unlinkEntity(factId: string, entityType: string, entityId: string): Promise<void>;
+    /**
+     * Get subjects by role for a fact
+     */
+    getByRole(factId: string, role: SubjectRole): Promise<FactSubject[]>;
+    /**
+     * Count entities linked to a fact
+     */
+    countForFact(factId: string): Promise<number>;
+    /**
+     * Find all subjects belonging to a specific tenant
+     */
+    findByTenant(tenantId: string): Promise<FactSubject[]>;
+    /**
+     * Find all global (tenant-less) subjects.
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context (an explicit `tenant_id IS NULL` filter would be
+     * flagged as an isolation violation). (#1600)
+     */
+    findGlobal(): Promise<FactSubject[]>;
+    /**
+     * Find subjects for a tenant including global subjects.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     */
+    findWithGlobals(tenantId: string): Promise<FactSubject[]>;
+}
+//# sourceMappingURL=fact-subjects.d.ts.map

package/dist/fact-subjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-subjects.d.ts","sourceRoot":"","sources":["../src/fact-subjects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,WAAW,CAAC;IACpE,MAAM,CAAC,QAAQ,CAAC,UAAU,qBAAe;IAEzC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAIxD;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC;IAIzB;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,WAAuB,GAC5B,OAAO,CAAC,WAAW,CAAC;IASvB;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1E;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASnD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI5D;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1C;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAOhE"}

package/dist/fact-tag.d.ts

@@ -0,0 +1,34 @@
+/**
+ * FactTag model - Join table between facts and tags
+ *
+ * Links facts to tags via tag slug (not tag ID),
+ * enabling categorization and discovery of facts.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { FactTagOptions } from './types';
+export declare class FactTag extends SmrtObject {
+    factId: string;
+    tagSlug: string;
+    metadata: string;
+    tenantId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FactTagOptions);
+    /**
+     * Get metadata as parsed object
+     */
+    getMetadata(): Record<string, unknown>;
+    /**
+     * Set metadata from object
+     */
+    setMetadata(data: Record<string, unknown>): void;
+    /**
+     * Update metadata by merging with existing values
+     */
+    updateMetadata(updates: Record<string, unknown>): void;
+    /**
+     * Get the fact this tag link belongs to
+     */
+    getFact(): Promise<import('./fact').Fact | null>;
+}
+//# sourceMappingURL=fact-tag.d.ts.map

package/dist/fact-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-tag.d.ts","sourceRoot":"","sources":["../src/fact-tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,qBAOa,OAAQ,SAAQ,UAAU;IAErC,MAAM,EAAE,MAAM,CAAM;IAGpB,OAAO,EAAE,MAAM,CAAM;IAGrB,QAAQ,EAAE,MAAM,CAAM;IAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,IAAI,CAAc;IAE7B,SAAS,EAAE,IAAI,CAAc;gBAEjB,OAAO,GAAE,cAAmB;IAcxC;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYtC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKtD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;CAOvD"}

package/dist/fact-tags.d.ts

@@ -0,0 +1,51 @@
+/**
+ * FactTagCollection - Collection manager for FactTag objects
+ *
+ * Provides queries for fact-tag links, including
+ * add/remove operations and tag-centric lookups.
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { FactTag } from './fact-tag';
+export declare class FactTagCollection extends SmrtCollection<FactTag> {
+    static readonly _itemClass: typeof FactTag;
+    /**
+     * Get all tag links for a fact
+     */
+    getForFact(factId: string): Promise<FactTag[]>;
+    /**
+     * Get all fact links for a tag slug
+     */
+    getForTag(tagSlug: string): Promise<FactTag[]>;
+    /**
+     * Add a tag to a fact
+     */
+    addTag(factId: string, tagSlug: string): Promise<FactTag>;
+    /**
+     * Remove a tag from a fact
+     */
+    removeTag(factId: string, tagSlug: string): Promise<void>;
+    /**
+     * Get all tag slugs for a fact
+     */
+    getTagSlugs(factId: string): Promise<string[]>;
+    /**
+     * Find all fact-tag links belonging to a specific tenant
+     */
+    findByTenant(tenantId: string): Promise<FactTag[]>;
+    /**
+     * Find all global (tenant-less) fact-tag links.
+     *
+     * Routes through the shared tenant-global helper so it does not throw under
+     * an active tenant context (an explicit `tenant_id IS NULL` filter would be
+     * flagged as an isolation violation). (#1600)
+     */
+    findGlobal(): Promise<FactTag[]>;
+    /**
+     * Find fact-tag links for a tenant including global links.
+     *
+     * Fails closed if an active tenant context requests a different tenant's
+     * rows; the admin/system path keeps the cross-tenant capability. (#1600)
+     */
+    findWithGlobals(tenantId: string): Promise<FactTag[]>;
+}
+//# sourceMappingURL=fact-tags.d.ts.map

package/dist/fact-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-tags.d.ts","sourceRoot":"","sources":["../src/fact-tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,CAAC;IAC5D,MAAM,CAAC,QAAQ,CAAC,UAAU,iBAAW;IAErC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpD;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO/D;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASpD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIxD;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAItC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAG5D"}

package/dist/fact.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Fact model - Atomic knowledge unit with provenance tracking
+ *
+ * Core entity for distributed memory. Facts represent individual pieces
+ * of knowledge with semantic embeddings for similarity search, evolution
+ * tracking via previousFactId (self-referencing chain: original →
+ * correction/contradiction/refinement), and confidence scoring.
+ *
+ * Note: this is an evolution chain, not a structural hierarchy. Fact
+ * deliberately does NOT extend SmrtHierarchical — `parentId` is reserved
+ * for true structural hierarchy (Place, Event, Tag, Account, Zone). See
+ * R3-C in the relationships-v2 release for the rationale behind the
+ * semantic distinction.
+ */
+import { SmrtObject } from '@happyvertical/smrt-core';
+import type { EvolutionType, FactMetadata, FactOptions, FactStatus, FactType } from './types';
+export declare class Fact extends SmrtObject {
+    textRefined: string;
+    textRaw: string;
+    /** Derived search storage. NULL requires the explicit catalog backfill. */
+    catalogSearch: string | null;
+    type: string;
+    status: string;
+    domain: string;
+    /**
+     * Self-referencing pointer to the predecessor fact in an evolution chain.
+     *
+     * This is NOT a structural hierarchy edge — Fact does not extend
+     * SmrtHierarchical. The chain represents knowledge evolution: an original
+     * fact, then corrections, refinements, contradictions, or extensions of
+     * that fact. See `evolutionType` for the kind of step.
+     */
+    previousFactId: string;
+    evolutionType: string;
+    sourceCount: number;
+    confidence: number;
+    metadata: string;
+    tenantId: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(options?: FactOptions);
+    protected getPersistenceDerivedColumns(): readonly string[];
+    protected normalizePersistenceData(data: Readonly<Record<string, unknown>>): Record<string, unknown>;
+    getMetadata(): FactMetadata;
+    setMetadata(data: FactMetadata): void;
+    updateMetadata(updates: Partial<FactMetadata>): void;
+    getType(): FactType;
+    getStatus(): FactStatus;
+    getEvolutionType(): EvolutionType;
+    isActive(): boolean;
+    isSuperseded(): boolean;
+    /**
+     * Whether this fact has a predecessor in the evolution chain.
+     *
+     * Returns false for the framework default (`''`) and for any nullish
+     * value — defensive against rows whose `previous_fact_id` column is
+     * NULL (e.g. after a migration that left root facts un-backfilled).
+     */
+    hasPredecessor(): boolean;
+    /**
+     * Get the predecessor fact (the prior version in the evolution chain).
+     */
+    getPredecessor(): Promise<Fact | null>;
+    /**
+     * Get successor facts (facts that evolved directly from this one).
+     */
+    getSuccessors(): Promise<Fact[]>;
+    /**
+     * Get all sources for this fact
+     */
+    getSources(): Promise<import('./fact-source').FactSource[]>;
+    /**
+     * Get all subjects linked to this fact
+     */
+    getSubjects(): Promise<import('./fact-subject').FactSubject[]>;
+}
+//# sourceMappingURL=fact.d.ts.map

package/dist/fact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact.d.ts","sourceRoot":"","sources":["../src/fact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAG/E,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACT,MAAM,SAAS,CAAC;AAWjB,qBAgBa,IAAK,SAAQ,UAAU;IAElC,WAAW,EAAE,MAAM,CAAM;IAGzB,OAAO,EAAE,MAAM,CAAM;IAErB,2EAA2E;IAE3E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGpC,IAAI,EAAE,MAAM,CAAe;IAG3B,MAAM,EAAE,MAAM,CAAa;IAG3B,MAAM,EAAE,MAAM,CAAM;IAEpB;;;;;;;OAOG;IAEH,cAAc,EAAE,MAAM,CAAM;IAG5B,aAAa,EAAE,MAAM,CAAc;IAGnC,WAAW,EAAE,MAAM,CAAK;IAGxB,UAAU,EAAE,MAAM,CAAO;IAGzB,QAAQ,EAAE,MAAM,CAAM;IAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAG/B,SAAS,EAAE,IAAI,CAAc;IAE7B,SAAS,EAAE,IAAI,CAAc;gBAEjB,OAAO,GAAE,WAAgB;cAwBlB,4BAA4B,IAAI,SAAS,MAAM,EAAE;cAIjD,wBAAwB,CACzC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAc1B,WAAW,IAAI,YAAY;IAW3B,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIrC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAMpD,OAAO,IAAI,QAAQ;IAInB,SAAS,IAAI,UAAU;IAIvB,gBAAgB,IAAI,aAAa;IAIjC,QAAQ,IAAI,OAAO;IAInB,YAAY,IAAI,OAAO;IAIvB;;;;;;OAMG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAQ5C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAMtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,eAAe,EAAE,UAAU,EAAE,CAAC;IAMjE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,gBAAgB,EAAE,WAAW,EAAE,CAAC;CAKrE"}