@fortemi/core 2026.5.3 → 2026.6.0

package/dist/index.d.ts

@@ -52,6 +52,13 @@ interface EventMap {
         name: string;
         progress?: number;
     };
+    'capability.required': {
+        name: string;
+        jobId: string;
+        noteId: string;
+        type: string;
+        message: string;
+    };
     'job.completed': {
         id: string;
         noteId: string;
@@ -63,6 +70,13 @@ interface EventMap {
         type: string;
         error: string;
     };
+    'job.blocked': {
+        id: string;
+        noteId: string;
+        type: string;
+        capability: string;
+        message: string;
+    };
     'archive.switched': {
         name: string;
     };
@@ -507,6 +521,195 @@ declare class TransactionProxy {
     exec(sql: string): Promise<void>;
 }
 
+/**
+ * EmbeddingSetsRepository - named, filter, and virtual embedding set API.
+ */
+
+type EmbeddingSetKind = 'physical' | 'filter' | 'virtual';
+type EmbeddingSetMode = 'auto' | 'manual' | 'mixed';
+interface EmbeddingSetCriteria {
+    query?: string;
+    tags?: string[];
+    collectionIds?: string[];
+    conceptIds?: string[];
+    noteIds?: string[];
+    updatedAfter?: string;
+    updatedBefore?: string;
+}
+interface EmbeddingSetFreshness {
+    status: 'fresh' | 'stale' | 'unknown';
+    sourceHash?: string;
+    checkedAt?: string;
+    reason?: string;
+}
+interface EmbeddingCompatibilityPolicy {
+    model: 'require-same' | 'allow-compatible-family';
+    dimension: 'require-same' | 'allow-truncation';
+    duplicateVectors: 'prefer-latest' | 'prefer-set-order' | 'error';
+    missingVectors: 'omit' | 'include-unembedded-note' | 'error';
+}
+interface VirtualMaterializationPolicy {
+    allowed: boolean;
+    includeResolvedMembers?: boolean;
+    includeResolvedEdges?: boolean;
+    freshness: 'fresh' | 'stale' | 'unknown';
+}
+interface CriteriaVirtualSource {
+    type: 'criteria';
+    baseSetId: string;
+    criteria: EmbeddingSetCriteria;
+}
+interface SetOperationVirtualSource {
+    type: 'set-operation';
+    operation: 'union' | 'intersection' | 'difference';
+    setIds: string[];
+}
+interface FallbackVirtualSource {
+    type: 'fallback';
+    preferredSetIds: string[];
+}
+interface LatestCompatibleVirtualSource {
+    type: 'latest-compatible';
+    candidateSetIds: string[];
+    model?: string;
+    dimension?: number;
+}
+interface SnapshotVirtualSource {
+    type: 'snapshot';
+    snapshotId: string;
+    sourceDefinitionId: string;
+    generatedAt: string;
+    inputHash: string;
+}
+type VirtualEmbeddingSetSource = CriteriaVirtualSource | SetOperationVirtualSource | FallbackVirtualSource | LatestCompatibleVirtualSource | SnapshotVirtualSource;
+interface VirtualEmbeddingSetDefinition {
+    id: string;
+    name: string;
+    purpose?: string | null;
+    source: VirtualEmbeddingSetSource;
+    compatibility: EmbeddingCompatibilityPolicy;
+    materialization?: VirtualMaterializationPolicy;
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface EmbeddingSetSelector {
+    kind: 'default' | 'embedding-set' | 'virtual-definition';
+    embeddingSetId?: string;
+    definition?: VirtualEmbeddingSetDefinition;
+}
+interface EmbeddingSetDescriptor {
+    id: string;
+    name: string;
+    purpose?: string | null;
+    kind: EmbeddingSetKind;
+    mode?: EmbeddingSetMode;
+    model?: string;
+    dimension?: number;
+    truncateDimension?: number | null;
+    criteria?: EmbeddingSetCriteria | null;
+    createdAt?: string;
+    updatedAt?: string;
+    freshness?: EmbeddingSetFreshness;
+}
+type VirtualEmbeddingSetValidationError = {
+    code: 'mixed-models';
+    setIds: string[];
+} | {
+    code: 'mixed-dimensions';
+    setIds: string[];
+} | {
+    code: 'missing-vector';
+    noteId: string;
+    setId: string;
+} | {
+    code: 'duplicate-vector';
+    noteId: string;
+    setIds: string[];
+} | {
+    code: 'stale-snapshot';
+    snapshotId: string;
+} | {
+    code: 'unsupported-criteria';
+    field: string;
+};
+interface ResolvedEmbeddingRow {
+    note_id: string;
+    embedding_set_id: string;
+    embedding_id: string;
+    vector: string;
+    created_at: Date;
+}
+interface ResolvedEmbeddingSet {
+    selector: EmbeddingSetSelector;
+    rows: ResolvedEmbeddingRow[];
+    noteIds: string[];
+    embeddingIds: string[];
+    errors: VirtualEmbeddingSetValidationError[];
+    freshness: EmbeddingSetFreshness;
+}
+interface EmbeddingSetRow {
+    id: string;
+    name: string;
+    purpose: string | null;
+    model_name: string;
+    dimensions: number;
+    kind: EmbeddingSetKind;
+    mode: EmbeddingSetMode | null;
+    truncate_dimension: number | null;
+    criteria_json: unknown | null;
+    source_json: unknown | null;
+    compatibility_json: unknown | null;
+    materialization_json: unknown | null;
+    freshness_json: unknown | null;
+    created_at: Date;
+    updated_at: Date;
+}
+interface EmbeddingSetCreateInput {
+    id?: string;
+    name: string;
+    purpose?: string | null;
+    model_name?: string;
+    dimensions?: number;
+    kind?: EmbeddingSetKind;
+    mode?: EmbeddingSetMode | null;
+    truncate_dimension?: number | null;
+    criteria?: EmbeddingSetCriteria | null;
+}
+interface EmbeddingSetEmbeddingInput {
+    id?: string;
+    note_id: string;
+    embedding_set_id: string;
+    vector: number[];
+}
+declare class EmbeddingSetsRepository {
+    private db;
+    constructor(db: QueryExecutor);
+    create(input: EmbeddingSetCreateInput): Promise<EmbeddingSetRow>;
+    createVirtualDefinition(input: VirtualEmbeddingSetDefinition): Promise<EmbeddingSetRow>;
+    ensureDefault(): Promise<EmbeddingSetRow>;
+    get(id: string): Promise<EmbeddingSetRow>;
+    list(): Promise<EmbeddingSetRow[]>;
+    listDescriptors(): Promise<EmbeddingSetDescriptor[]>;
+    toDescriptor(row: EmbeddingSetRow): EmbeddingSetDescriptor;
+    putEmbedding(input: EmbeddingSetEmbeddingInput): Promise<{
+        id: string;
+    }>;
+    resolveSelector(selector: EmbeddingSetSelector): Promise<ResolvedEmbeddingSet>;
+    private resolveDefinition;
+    private resolvePhysicalSet;
+    private resolvePhysicalRows;
+    private resolveCriteriaSource;
+    private resolveSetOperationSource;
+    private resolveFallbackSource;
+    private resolveLatestCompatibleSource;
+    private validateCompatibility;
+    private resolveDuplicateRows;
+    private finalizeResolution;
+    private definitionFromRow;
+    private inferDefinitionModel;
+    private inferDefinitionDimension;
+}
+
 /**
  * Shared types for repository layer.
  * All repository methods use these types as inputs and outputs.
@@ -622,6 +825,8 @@ interface SearchOptions {
     visibility?: string;
     include_facets?: boolean;
     mode?: 'text' | 'semantic' | 'hybrid' | 'auto';
+    embeddingSetId?: string;
+    embeddingSetSelector?: EmbeddingSetSelector;
 }
 interface NoteRevision {
     id: string;
@@ -700,61 +905,169 @@ declare class NotesRepository {
 }
 
 /**
- * SearchRepository — full-text search using DatabaseClient tsvector/tsquery,
+ * SearchRepository - full-text search using DatabaseClient tsvector/tsquery,
  * with optional semantic search (pgvector) and hybrid (BM25 + vector RRF).
- *
- * Search strategy:
- *  - Title match uses the STORED tsvector column (weight A).
- *  - Content match uses an ad-hoc to_tsvector on note_revised_current.content (weight B).
- *  - ts_rank combines both weighted vectors to rank title matches higher.
- *  - ts_headline generates highlighted snippets from content.
- *  - Empty / whitespace-only queries fall back to returning recent notes.
- *  - semanticSearch uses pgvector cosine distance (<=>).
- *  - hybridSearch combines BM25 and vector with Reciprocal Rank Fusion (k=60).
- *  - Quoted phrases use phraseto_tsquery for exact phrase matching.
- *
- * @implements #64 semantic and hybrid search
- * @implements #77 correct mode field
- * @implements #79 date range filter
- * @implements #80 starred/archived filters
- * @implements #81 format/source/visibility filters
- * @implements #82 collection filter on semantic/hybrid
- * @implements #83 phrase search
- * @implements #87 shared condition builder
- * @implements #89 search mode selector
- * @implements #94 per-result embedding status
  */
 
 declare class SearchRepository {
     private db;
     private semanticAvailable;
     constructor(db: DatabaseClient, semanticAvailable?: boolean);
-    /** Select tsquery function based on whether query contains quoted phrases */
     private tsqueryFn;
-    /** Returns a Set of note IDs that have an embedding record */
     private fetchEmbeddingSet;
-    /** Attach has_embedding to each SearchResult using the provided embedding set */
+    private selectorFromOptions;
+    private resolveEmbeddingSet;
+    private scopeToResolvedEmbeddingSet;
+    private scopeToResolvedEmbeddingRows;
+    private fetchEmbeddingStatus;
     private attachEmbeddingStatus;
     search(query: string, options?: SearchOptions, queryEmbedding?: number[]): Promise<SearchResponse>;
-    /**
-     * Semantic search using pgvector cosine distance.
-     * Returns notes ranked by vector similarity to the query embedding.
-     */
     semanticSearch(queryEmbedding: number[], options?: SearchOptions): Promise<SearchResponse>;
-    /**
-     * Hybrid search combining BM25 (full-text) and vector similarity using
-     * Reciprocal Rank Fusion (RRF, k=60).
-     */
     hybridSearch(query: string, queryEmbedding: number[], options?: SearchOptions): Promise<SearchResponse>;
     private recentNotes;
-    /**
-     * Fetch faceted aggregate counts for tags and collections across all matching note IDs.
-     * Uses the full (unpaginated) result set for accurate counts.
-     */
     private fetchFacets;
     private fetchTagMap;
 }
 
+interface GraphNode {
+    id: string;
+}
+interface GraphEdge {
+    source: string;
+    target: string;
+    weight: number;
+    kind?: string;
+}
+interface GraphCommunity {
+    id: string;
+    nodes: string[];
+}
+interface CommunityGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    communities: GraphCommunity[];
+}
+interface SimilarityGraphOptions {
+    k?: number;
+    minSimilarity?: number;
+    threshold?: number;
+}
+interface SimilarityGraphRequest extends SimilarityGraphOptions {
+    selector: EmbeddingSetSelector;
+    metric?: 'cosine' | 'inner_product' | 'l2';
+    source?: 'cache-preferred' | 'live-only' | 'cache-only';
+}
+interface SimilarityGraphCacheKey {
+    selectorHash: string;
+    resolvedEmbeddingSetId?: string;
+    virtualSetId?: string;
+    k: number;
+    minSimilarity: number;
+    metric: 'cosine' | 'inner_product' | 'l2';
+    model: string;
+    dimension: number;
+    truncateDimension?: number | null;
+    memberHash: string;
+    vectorHash: string;
+    parameterHash: string;
+}
+interface SimilarityGraphResult {
+    graph: CommunityGraph;
+    graphSource: {
+        id: string;
+        name: string;
+        input_hash: string;
+        freshness: 'fresh' | 'stale' | 'unknown';
+    };
+    cache: 'hit' | 'miss-live-built' | 'stale-live-built' | 'live-only';
+    freshness: 'fresh' | 'stale' | 'unknown';
+}
+interface CommunityOptions {
+    maxIterations?: number;
+}
+declare function detectCommunities(edges: GraphEdge[], nodes?: GraphNode[], options?: CommunityOptions): GraphCommunity[];
+declare class GraphRepository {
+    private db;
+    constructor(db: QueryExecutor);
+    normalizeSimilarityRequest(request: SimilarityGraphRequest): Required<Pick<SimilarityGraphRequest, 'selector' | 'k' | 'minSimilarity' | 'metric' | 'source'>>;
+    buildSimilarityGraph(embeddingSet: string | EmbeddingSetSelector, options?: SimilarityGraphOptions): Promise<CommunityGraph>;
+    buildSimilarityGraphLive(request: SimilarityGraphRequest): Promise<CommunityGraph>;
+    getCachedSimilarityGraph(request: SimilarityGraphRequest): Promise<SimilarityGraphResult | null>;
+    buildOrLoadSimilarityGraph(request: SimilarityGraphRequest): Promise<SimilarityGraphResult>;
+    saveSimilarityGraphArtifact(input: {
+        graph: CommunityGraph;
+        request: Required<Pick<SimilarityGraphRequest, 'selector' | 'k' | 'minSimilarity' | 'metric' | 'source'>>;
+        resolved: ResolvedEmbeddingSet;
+        cacheKey: SimilarityGraphCacheKey;
+        freshness?: 'fresh' | 'stale' | 'unknown';
+    }): Promise<SimilarityGraphResult['graphSource']>;
+    markSimilarityGraphStale(graphSourceId: string, reason: string): Promise<void>;
+    loadGraphArtifact(graphSourceId: string, noteIds?: string[]): Promise<CommunityGraph>;
+    private buildSimilarityGraphFromResolved;
+    private computeSimilarityGraphCacheKey;
+    private findGraphSource;
+    private graphFromArtifact;
+    buildLinkGraph(linkType?: string): Promise<CommunityGraph>;
+}
+
+type CommunitySourceType = 'computed' | 'precomputed' | 'dynamic' | 'dynamic-snapshot' | 'user-authored' | 'imported';
+interface CommunityFilterDefinition {
+    query?: string;
+    tags?: string[];
+    collectionIds?: string[];
+    conceptIds?: string[];
+    noteIds?: string[];
+    embeddingSetSelector?: EmbeddingSetSelector;
+}
+interface CommunitySourceDescriptor {
+    id: string;
+    name: string;
+    sourceType: CommunitySourceType;
+    graphSourceId?: string;
+    selector?: EmbeddingSetSelector;
+    searchQuery?: string;
+    filters?: CommunityFilterDefinition;
+    createdAt?: string;
+    updatedAt?: string;
+    freshness?: 'fresh' | 'stale' | 'unknown';
+}
+interface CommunityAssignmentView {
+    communitySourceId: string;
+    communityId: string;
+    noteId: string;
+    label?: string | null;
+    confidence?: number | null;
+    sourceType: CommunitySourceType;
+}
+interface CommunitySummary {
+    id: string;
+    label: string;
+    sourceType: CommunitySourceType;
+    size: number;
+    confidence?: number | null;
+    representativeNoteIds: string[];
+    freshness?: 'fresh' | 'stale' | 'unknown';
+}
+interface CommunityCreateInput {
+    name: string;
+    label?: string;
+    sourceType: 'dynamic-snapshot' | 'user-authored';
+    filters?: CommunityFilterDefinition;
+    noteIds?: string[];
+    representativeNoteIds?: string[];
+}
+declare class CommunitiesRepository {
+    private db;
+    constructor(db: DatabaseClient);
+    previewDynamicCommunity(filters: CommunityFilterDefinition): Promise<CommunityAssignmentView[]>;
+    saveCommunity(input: CommunityCreateInput): Promise<CommunitySourceDescriptor>;
+    rerunDynamicCommunity(sourceId: string): Promise<CommunityAssignmentView[]>;
+    listCommunitySources(): Promise<CommunitySourceDescriptor[]>;
+    getCommunityAssignments(sourceId: string): Promise<CommunityAssignmentView[]>;
+    listCommunitySummaries(sourceId: string): Promise<CommunitySummary[]>;
+    private resolveFilterNoteIds;
+}
+
 /**
  * Shared SQL condition builder for note filtering.
  * Used by both SearchRepository and NotesRepository to prevent drift
@@ -878,6 +1191,7 @@ declare class JobQueueWorker {
     processOnce(): Promise<number>;
     private poll;
     private processPendingJobs;
+    private blockForCapability;
     getBackoffDelay(retryCount: number): number;
 }
 /** Title generation: LLM first, fallback to first-line extraction */
@@ -1293,9 +1607,9 @@ declare const ListNotesInputSchema: z.ZodObject<{
     collection_id: z.ZodOptional<z.ZodString>;
     include_deleted: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    sort: "created_at" | "updated_at" | "title";
     limit: number;
     offset: number;
-    sort: "created_at" | "updated_at" | "title";
     order: "asc" | "desc";
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
@@ -1303,12 +1617,12 @@ declare const ListNotesInputSchema: z.ZodObject<{
     include_deleted?: boolean | undefined;
     collection_id?: string | undefined;
 }, {
+    sort?: "created_at" | "updated_at" | "title" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
     tags?: string[] | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
-    sort?: "created_at" | "updated_at" | "title" | undefined;
     order?: "asc" | "desc" | undefined;
     include_deleted?: boolean | undefined;
     collection_id?: string | undefined;
@@ -2092,7 +2406,7 @@ declare function createCspReportHandler(onReport: (report: CspViolationReport) =
 declare const CURRENT_SHARD_VERSION = "1.0.0";
 declare const SHARD_FORMAT = "matric-shard";
 /** Components that can appear in a shard archive. */
-type ShardComponent = 'notes' | 'collections' | 'tags' | 'links' | 'embedding_sets' | 'embedding_set_members' | 'embedding_configs' | 'embeddings';
+type ShardComponent = 'notes' | 'collections' | 'tags' | 'links' | 'embedding_sets' | 'embedding_set_members' | 'embedding_configs' | 'embeddings' | 'skos_schemes' | 'skos_concepts' | 'skos_relations' | 'note_skos_tags' | 'provenance_edges' | 'community_assignments' | 'communities' | 'graph_edges' | 'graph_sources';
 /** Manifest included in every shard as manifest.json. */
 interface ShardManifest {
     version: string;
@@ -2100,7 +2414,7 @@ interface ShardManifest {
     format: typeof SHARD_FORMAT;
     created_at: string;
     components: ShardComponent[];
-    counts: Partial<Record<ShardComponent, number>>;
+    counts: Partial<Record<ShardComponent | 'community_sets', number>>;
     checksums: Record<string, string>;
     min_reader_version: string;
 }
@@ -2127,6 +2441,16 @@ interface ImportCounts {
     embedding_sets: number;
     embedding_set_members: number;
     embeddings: number;
+    skos_schemes: number;
+    skos_concepts: number;
+    skos_relations: number;
+    note_skos_tags: number;
+    provenance_edges: number;
+    graph_sources: number;
+    graph_edges: number;
+    community_sets: number;
+    communities: number;
+    community_assignments: number;
 }
 /** Result of a shard import operation. */
 interface ImportResult {
@@ -2179,9 +2503,20 @@ interface ShardLink {
 /** Embedding set as serialized in the shard JSON array. */
 interface ShardEmbeddingSet {
     id: string;
+    name?: string;
+    purpose?: string | null;
     model: string;
     dimension: number;
+    kind?: 'physical' | 'filter' | 'virtual';
+    mode?: 'auto' | 'manual' | 'mixed' | null;
+    truncate_dimension?: number | null;
+    criteria?: Record<string, unknown> | null;
+    source?: Record<string, unknown> | null;
+    compatibility?: Record<string, unknown> | null;
+    materialization?: Record<string, unknown> | null;
+    freshness?: ShardArtifactFreshness | null;
     created_at: string;
+    updated_at?: string;
 }
 /** Embedding set member as serialized in the shard JSONL. */
 interface ShardEmbeddingSetMember {
@@ -2197,6 +2532,63 @@ interface ShardEmbedding {
     vector: number[];
     created_at: string;
 }
+/** SKOS scheme as serialized in the shard JSON array. */
+interface ShardSkosScheme {
+    id: string;
+    title: string;
+    description: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** SKOS concept as serialized in the shard JSON array. */
+interface ShardSkosConcept {
+    id: string;
+    scheme_id: string;
+    pref_label: string;
+    alt_labels: string[];
+    definition: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** SKOS concept relation as serialized in the shard JSONL. */
+interface ShardSkosRelation {
+    id: string;
+    source_concept_id: string;
+    target_concept_id: string;
+    relation_type: 'broader' | 'narrower' | 'related';
+    created_at: string;
+}
+/** Note-to-SKOS-concept assignment as serialized in the shard JSONL. */
+interface ShardNoteSkosTag {
+    id: string;
+    note_id: string;
+    concept_id: string;
+    created_at: string;
+}
+/** Provenance edge as serialized in the shard JSONL. */
+interface ShardProvenanceEdge {
+    id: string;
+    entity_type: string;
+    entity_id: string;
+    activity: string;
+    agent: string;
+    started_at: string;
+    ended_at: string | null;
+    attributes: Record<string, unknown> | null;
+}
+interface ShardArtifactFreshness {
+    status: 'fresh' | 'stale' | 'unknown';
+    checked_at?: string;
+    stale_reason?: string;
+    source_hashes?: {
+        notes?: string;
+        links?: string;
+        embeddings?: string;
+        embedding_set_members?: string;
+        virtual_set_definition?: string;
+        parameters?: string;
+    };
+}
 
 /**
  * Minimal tar + gzip packing/unpacking for shard archives.
@@ -2301,16 +2693,38 @@ declare function tagsFromShard(shardTags: ShardTag[]): string[];
 /** Convert a browser embedding_set to shard format. */
 declare function embeddingSetToShard(set: {
     id: string;
+    name?: string;
+    purpose?: string | null;
     model_name: string;
     dimensions: number;
+    kind?: 'physical' | 'filter' | 'virtual';
+    mode?: 'auto' | 'manual' | 'mixed' | null;
+    truncate_dimension?: number | null;
+    criteria_json?: unknown | null;
+    source_json?: unknown | null;
+    compatibility_json?: unknown | null;
+    materialization_json?: unknown | null;
+    freshness_json?: unknown | null;
     created_at: Date | string;
+    updated_at?: Date | string;
 }): ShardEmbeddingSet;
 /** Convert a shard embedding set back to browser format. */
 declare function embeddingSetFromShard(shard: ShardEmbeddingSet): {
     id: string;
+    name: string;
+    purpose: string | null;
     model_name: string;
     dimensions: number;
+    kind: 'physical' | 'filter' | 'virtual';
+    mode: 'auto' | 'manual' | 'mixed' | null;
+    truncate_dimension: number | null;
+    criteria_json: string | null;
+    source_json: string | null;
+    compatibility_json: string | null;
+    materialization_json: string | null;
+    freshness_json: string | null;
     created_at: string;
+    updated_at: string | null;
 };
 /** Convert a browser embedding_set_member to shard format. */
 declare function embeddingSetMemberToShard(member: {
@@ -2334,6 +2748,45 @@ declare function embeddingFromShard(shard: ShardEmbedding): {
     vector: string;
     created_at: string;
 };
+declare function skosSchemeToShard(scheme: {
+    id: string;
+    title: string;
+    description: string | null;
+    created_at: Date | string;
+    updated_at: Date | string;
+}): ShardSkosScheme;
+declare function skosConceptToShard(concept: {
+    id: string;
+    scheme_id: string;
+    pref_label: string;
+    alt_labels: string[] | string | null;
+    definition: string | null;
+    created_at: Date | string;
+    updated_at: Date | string;
+}): ShardSkosConcept;
+declare function skosRelationToShard(relation: {
+    id: string;
+    source_concept_id: string;
+    target_concept_id: string;
+    relation_type: 'broader' | 'narrower' | 'related';
+    created_at: Date | string;
+}): ShardSkosRelation;
+declare function noteSkosTagToShard(tag: {
+    id: string;
+    note_id: string;
+    concept_id: string;
+    created_at: Date | string;
+}): ShardNoteSkosTag;
+declare function provenanceEdgeToShard(edge: {
+    id: string;
+    entity_type: string;
+    entity_id: string;
+    activity: string;
+    agent: string;
+    started_at: Date | string;
+    ended_at: Date | string | null;
+    attributes: Record<string, unknown> | string | null;
+}): ShardProvenanceEdge;
 
 /**
  * Shard export pipeline — query all entities, serialize, pack into .shard archive.
@@ -2370,6 +2823,92 @@ declare function exportShard(db: DatabaseClient, options?: ExportOptions): Promi
  */
 declare function importShard(db: DatabaseClient, data: Uint8Array | ArrayBuffer, options?: ImportOptions): Promise<ImportResult>;
 
-declare const VERSION = "2026.5.3";
+type AiwgFortemiRecordType = 'crm.contact' | 'crm.organization' | 'crm.event' | 'crm.interaction' | 'aiwg.artifact';
+type AiwgPrivacyClassification = 'private' | 'sanitized' | 'public';
+type AiwgProvenanceConfidence = 'source' | 'candidate' | 'reviewed' | 'rejected';
+type AiwgReviewAction = 'accept' | 'reject' | 'defer';
+interface AiwgFortemiRecordSource {
+    path: string;
+    repo_relative_path: string;
+    locator: string;
+}
+interface AiwgFortemiRelationship {
+    type: string;
+    target_id: string;
+    source_path?: string;
+}
+interface AiwgFortemiProvenance {
+    field: string;
+    source: string;
+    path: string;
+    confidence: AiwgProvenanceConfidence;
+    privacy: AiwgPrivacyClassification;
+}
+interface AiwgFortemiRecord {
+    schema_version: 'aiwg.fortemi.index.record.v1';
+    id: string;
+    type: AiwgFortemiRecordType;
+    source: AiwgFortemiRecordSource;
+    title: string;
+    text: string;
+    facets: Record<string, string[]>;
+    tags: string[];
+    concepts: string[];
+    relationships: AiwgFortemiRelationship[];
+    provenance: AiwgFortemiProvenance[];
+    privacy: {
+        classification: AiwgPrivacyClassification;
+        pii: boolean;
+    };
+    updated_at: string;
+}
+interface AiwgFortemiIndexExport {
+    schema_version: 'aiwg.fortemi.index.export.v1';
+    generated_at: string;
+    source: {
+        repo: string;
+        privacy: AiwgPrivacyClassification;
+    };
+    items: AiwgFortemiRecord[];
+}
+interface AiwgIndexValidationResult {
+    valid: boolean;
+    errors: string[];
+    counts: Partial<Record<AiwgFortemiRecordType, number>>;
+}
+interface AiwgIndexQueryOptions {
+    types?: AiwgFortemiRecordType[];
+    facets?: Record<string, string[]>;
+    tags?: string[];
+    concepts?: string[];
+    privacy?: AiwgPrivacyClassification[];
+    relationshipTargetId?: string;
+    limit?: number;
+    offset?: number;
+}
+interface AiwgIndexQueryResult {
+    items: AiwgFortemiRecord[];
+    total: number;
+    facets: Record<string, Record<string, number>>;
+}
+interface AiwgReviewDecision {
+    item_id: string;
+    action: AiwgReviewAction;
+    reason?: string;
+    updated_at: string;
+}
+interface AiwgReviewDecisionExport {
+    schema_version: 'aiwg.fortemi.review-decisions.v1';
+    generated_at: string;
+    source_export_schema_version: string;
+    decisions: AiwgReviewDecision[];
+}
+declare function validateAiwgFortemiIndexExport(value: unknown): AiwgIndexValidationResult;
+declare function assertAiwgFortemiIndexExport(value: unknown): AiwgFortemiIndexExport;
+declare function getAiwgFortemiFacets(items: AiwgFortemiRecord[]): Record<string, Record<string, number>>;
+declare function queryAiwgFortemiIndex(index: AiwgFortemiIndexExport, query?: string, options?: AiwgIndexQueryOptions): AiwgIndexQueryResult;
+declare function createAiwgReviewDecisionExport(source: AiwgFortemiIndexExport, decisions: AiwgReviewDecision[], generatedAt?: string): AiwgReviewDecisionExport;
+
+declare const VERSION = "2026.6.0";
 
-export { type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BlobStore, type BridgeCapability, type BrowserNoteExport, CURRENT_SHARD_VERSION, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionRow, CollectionsRepository, type CompletionRequest, type CompletionResponse, type ConditionResult, type ConflictStrategy, type CooldownConfig, type CooldownEvent, type CspDirectiveName, type CspDirectives, type CspViolationReport, type DatabaseClient, type DiscoveredProvider, type DiscoveryOptions, type EmbedFunction, type EmbedRequest, type EmbedResponse, type EnqueueJobInput, type ErrorCategory, type EventMap, type ExportOptions, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FortemiConfig, type FortemiCore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type IDisposable, type ImportCounts, type ImportOptions, type ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, LOCAL_ENDPOINTS, type LinkRow, LinksRepository, type ListNotesInput, ListNotesInputSchema, type LlmCapabilityOptions, type LlmCompleteFn, type LoadedPluginScript, type LocalEndpoint, type ManageArchiveInput, ManageArchiveInputSchema, type ManageArchiveResult, type ManageAttachmentsInput, ManageAttachmentsInputSchema, type ManageAttachmentsResult, type ManageCapabilitiesInput, ManageCapabilitiesInputSchema, type ManageCapabilitiesResult, type ManageCollectionsInput, ManageCollectionsInputSchema, type ManageCollectionsResult, type ManageLinksInput, ManageLinksInputSchema, type ManageLinksResult, type ManageNoteInput, ManageNoteInputSchema, type ManageNoteResult, type ManageTagsInput, ManageTagsInputSchema, type ManageTagsResult, MemoryBlobStore, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteRevision, type NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type ProbeResult, type ProbeStatus, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type RouteHandler, SHARD_FORMAT, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardCollection, type ShardComponent, type ShardEmbedding, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLink, type ShardManifest, type ShardNote, type ShardTag, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, collectionFromShard, collectionToShard, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createBlobStore, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteInstance, createRoutes, defaultStorageBackendFactory, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchPluginScript, fortemiManifest, generateId, getEmbedFunction, getJobQueueStatus, getLlmFunction, getNote, importShard, isPluginScriptAllowed, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteToShard, packTarGz, parseCspReport, registerLlmCapability, registerSemanticCapability, registerServiceWorker, searchTool, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateChecksums, verifySri };
+export { type AiwgFortemiIndexExport, type AiwgFortemiProvenance, type AiwgFortemiRecord, type AiwgFortemiRecordSource, type AiwgFortemiRecordType, type AiwgFortemiRelationship, type AiwgIndexQueryOptions, type AiwgIndexQueryResult, type AiwgIndexValidationResult, type AiwgPrivacyClassification, type AiwgProvenanceConfidence, type AiwgReviewAction, type AiwgReviewDecision, type AiwgReviewDecisionExport, type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BlobStore, type BridgeCapability, type BrowserNoteExport, CURRENT_SHARD_VERSION, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionRow, CollectionsRepository, CommunitiesRepository, type CommunityAssignmentView, type CommunityCreateInput, type CommunityFilterDefinition, type CommunityGraph, type CommunityOptions, type CommunitySourceDescriptor, type CommunitySourceType, type CommunitySummary, type CompletionRequest, type CompletionResponse, type ConditionResult, type ConflictStrategy, type CooldownConfig, type CooldownEvent, type CspDirectiveName, type CspDirectives, type CspViolationReport, type DatabaseClient, type DiscoveredProvider, type DiscoveryOptions, type EmbedFunction, type EmbedRequest, type EmbedResponse, type EmbeddingCompatibilityPolicy, type EmbeddingSetCreateInput, type EmbeddingSetCriteria, type EmbeddingSetDescriptor, type EmbeddingSetEmbeddingInput, type EmbeddingSetFreshness, type EmbeddingSetKind, type EmbeddingSetMode, type EmbeddingSetRow, type EmbeddingSetSelector, EmbeddingSetsRepository, type EnqueueJobInput, type ErrorCategory, type EventMap, type ExportOptions, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FortemiConfig, type FortemiCore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type GraphCommunity, type GraphEdge, type GraphNode, GraphRepository, type IDisposable, type ImportCounts, type ImportOptions, type ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, LOCAL_ENDPOINTS, type LinkRow, LinksRepository, type ListNotesInput, ListNotesInputSchema, type LlmCapabilityOptions, type LlmCompleteFn, type LoadedPluginScript, type LocalEndpoint, type ManageArchiveInput, ManageArchiveInputSchema, type ManageArchiveResult, type ManageAttachmentsInput, ManageAttachmentsInputSchema, type ManageAttachmentsResult, type ManageCapabilitiesInput, ManageCapabilitiesInputSchema, type ManageCapabilitiesResult, type ManageCollectionsInput, ManageCollectionsInputSchema, type ManageCollectionsResult, type ManageLinksInput, ManageLinksInputSchema, type ManageLinksResult, type ManageNoteInput, ManageNoteInputSchema, type ManageNoteResult, type ManageTagsInput, ManageTagsInputSchema, type ManageTagsResult, MemoryBlobStore, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteRevision, type NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type ProbeResult, type ProbeStatus, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RouteHandler, SHARD_FORMAT, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardCollection, type ShardComponent, type ShardEmbedding, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLink, type ShardManifest, type ShardNote, type ShardNoteSkosTag, type ShardProvenanceEdge, type ShardSkosConcept, type ShardSkosRelation, type ShardSkosScheme, type ShardTag, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VirtualEmbeddingSetDefinition, type VirtualEmbeddingSetSource, type VirtualEmbeddingSetValidationError, type VirtualMaterializationPolicy, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, assertAiwgFortemiIndexExport, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, collectionFromShard, collectionToShard, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createAiwgReviewDecisionExport, createBlobStore, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteInstance, createRoutes, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchPluginScript, fortemiManifest, generateId, getAiwgFortemiFacets, getEmbedFunction, getJobQueueStatus, getLlmFunction, getNote, importShard, isPluginScriptAllowed, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteSkosTagToShard, noteToShard, packTarGz, parseCspReport, provenanceEdgeToShard, queryAiwgFortemiIndex, registerLlmCapability, registerSemanticCapability, registerServiceWorker, searchTool, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateAiwgFortemiIndexExport, validateChecksums, verifySri };