@fortemi/core 2026.7.4 → 2026.7.5

package/dist/aiwg-index-C2G7iy-b.d.ts

@@ -1,826 +0,0 @@
-/**
- * Content-addressable blob storage.
- *
- * Path format: blobs/{dir1}/{dir2}/{hash}
- *   dir1 = first 2 hex chars of hash
- *   dir2 = next 2 hex chars of hash
- *   filename = full hash
- *
- * Two implementations are provided:
- *   - OpfsBlobStore  — Origin Private File System (Chrome/Edge 86+)
- *   - IdbBlobStore   — IndexedDB fallback (Firefox, Safari)
- *
- * Use createBlobStore() to get the best available implementation.
- * Export MemoryBlobStore for use in tests.
- */
-interface BlobStore {
-    write(hash: string, data: Uint8Array): Promise<void>;
-    read(hash: string): Promise<Uint8Array | null>;
-    remove(hash: string): Promise<void>;
-    exists(hash: string): Promise<boolean>;
-}
-declare class MemoryBlobStore implements BlobStore {
-    private store;
-    write(hash: string, data: Uint8Array): Promise<void>;
-    read(hash: string): Promise<Uint8Array | null>;
-    remove(hash: string): Promise<void>;
-    exists(hash: string): Promise<boolean>;
-}
-declare function createBlobStore(archiveName: string): BlobStore;
-
-/**
- * Shard format types — matches the fortemi server matric-shard specification.
- *
- * A shard is a gzip-compressed tar archive (.shard) containing serialized
- * knowledge data with a manifest for integrity verification.
- */
-
-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' | 'templates' | 'links' | 'embedding_sets' | 'embedding_configs' | 'embedding_set_members' | 'embeddings' | 'skos_schemes' | 'skos_concepts' | 'skos_relations' | 'note_skos_tags' | 'provenance_edges' | 'community_assignments' | 'communities' | 'graph_edges' | 'graph_sources';
-interface ShardAttachmentReference {
-    id: string;
-    path: string;
-    mime: string | null;
-    checksum: string;
-    bytes: number;
-}
-interface ShardAttachmentProjection {
-    extracted_text: string | null;
-    attachment: ShardAttachmentReference;
-}
-/** @deprecated Legacy React shard field name. Server shards use `attachments`. */
-type ShardBinarySource = ShardAttachmentProjection;
-/**
- * Reference to one cluster file of a component split across addressable files
- * (`notes/000.jsonl`, `notes/001.jsonl`, …). `offset` preserves deterministic
- * component order; readers discover each cluster's size from its contents.
- */
-interface ShardClusterRef {
-    href: string;
-    offset: number;
-}
-/**
- * Optional clustered layout (additive — absent on monolithic shards). When a
- * component is present here, its records live in the listed cluster files instead
- * of (or in addition to) the single `<component>.jsonl`. Both `importShard` and
- * the in-place reader consume it; a monolithic shard omits `layout` entirely.
- */
-interface ShardLayout {
-    clusters?: Partial<Record<ShardComponent, ShardClusterRef[]>>;
-}
-interface ShardMigrationHistoryEntry {
-    from_version: string;
-    to_version: string;
-    migrated_at: string;
-    migrated_by: string;
-    changes: string[];
-}
-/** Manifest included in every shard as manifest.json. */
-interface ShardManifest {
-    version: string;
-    matric_version: string;
-    format: typeof SHARD_FORMAT;
-    created_at: string;
-    components: ShardComponent[];
-    counts: Partial<Record<ShardComponent | 'community_sets', number>>;
-    checksums: Record<string, string>;
-    min_reader_version: string;
-    migrated_from?: string | null;
-    migration_history?: ShardMigrationHistoryEntry[];
-    /** Clustered component layout for partial fetch (issue #189). Absent → monolithic. */
-    layout?: ShardLayout;
-}
-/** Options for shard export. */
-interface ExportOptions {
-    includeEmbeddings?: boolean;
-    /** Filter to specific collection (export only notes in this collection). */
-    collectionId?: string;
-    /** Filter to notes with this tag (e.g. 'app:research' for app-scoped export). */
-    tag?: string;
-    /** Export only these embedding sets and their member/vector rows. */
-    embeddingSetIds?: string[];
-    /** Preserve virtual selector materialization metadata and virtual member rows. */
-    includeMaterializedSelectors?: boolean;
-    /**
-     * When set to a positive integer, emit notes as clustered files
-     * (`notes/000.jsonl`, …) of this many records each, and record the layout in
-     * the manifest, so an in-place reader can fetch only the clusters it needs
-     * (issue #189). Absent → a single monolithic `notes.jsonl` (unchanged).
-     */
-    clusterNotesSize?: number;
-    /**
-     * Pack attachment bytes into a portable content-addressed `blobs/<hex>`
-     * sidecar (Fortemi/fortemi#1046), producing a self-contained shard whose
-     * attachments survive a round-trip (`getBlob()` returns real bytes on the
-     * importing host). Requires {@link blobStore}. Absent/false → reference-only
-     * (server default), which remains a valid shard.
-     */
-    includeBlobs?: boolean;
-    /**
-     * Byte source for the sidecar. Required when `includeBlobs` is set; attachment
-     * bytes are read by their `content_hash`. A blob the store cannot return is
-     * skipped (its attachment stays reference-only) rather than failing export.
-     */
-    blobStore?: BlobStore;
-}
-/** Conflict resolution strategy for shard import. */
-type ConflictStrategy = 'skip' | 'replace' | 'error';
-/** Options for shard import. */
-interface ImportOptions {
-    conflictStrategy?: ConflictStrategy;
-    /** Rows processed between cooperative yields. Defaults to 250. */
-    batchSize?: number;
-    /** Progress callback for long-running import phases. */
-    onProgress?: (progress: ImportProgress) => void;
-    /**
-     * Destination for hydrating attachment bytes from a portable `blobs/<hex>`
-     * sidecar (Fortemi/fortemi#1046). When provided, sidecar entries whose bare
-     * hex matches an imported attachment's `content_hash` are written to this
-     * store after the import transaction commits, so `getBlob()` returns real
-     * bytes. Absent → attachments import as reference-only metadata (unchanged).
-     */
-    blobStore?: BlobStore;
-}
-type ImportProgressPhase = 'unpack' | 'validate' | 'collections' | 'notes' | 'skos' | 'templates' | 'links' | 'provenance' | 'embedding_sets' | 'embedding_configs' | 'embeddings' | 'embedding_set_members' | 'graph' | 'communities' | 'index';
-interface ImportProgress {
-    phase: ImportProgressPhase;
-    done: number;
-    total: number;
-}
-/** Per-entity import counts. */
-interface ImportCounts {
-    notes: number;
-    collections: number;
-    templates: number;
-    tags: number;
-    links: number;
-    embedding_sets: number;
-    embedding_configs: 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 {
-    success: boolean;
-    counts: ImportCounts;
-    skipped: Partial<ImportCounts>;
-    warnings: string[];
-    errors: string[];
-    duration_ms: number;
-}
-/** Note as serialized in the shard JSONL. */
-interface ShardNote {
-    id: string;
-    title: string | null;
-    original_content: string;
-    revised_content: string | null;
-    collection_id?: string | null;
-    attachments?: ShardAttachmentProjection[];
-    /** @deprecated Legacy React shard field name. Use `attachments`. */
-    binary_sources?: ShardBinarySource[];
-    format: string;
-    source: string;
-    starred: boolean;
-    archived: boolean;
-    tags: string[];
-    created_at: string;
-    updated_at: string;
-    deleted_at: string | null;
-}
-/** Collection as serialized in the shard JSON array. */
-interface ShardCollection {
-    id: string;
-    name: string;
-    description: string | null;
-    parent_id: string | null;
-    created_at: string;
-    note_count?: number;
-}
-/** Tag as serialized in the shard JSON array. */
-interface ShardTag {
-    name: string;
-    created_at: string;
-}
-/** Template as serialized in the shard JSON array. */
-interface ShardTemplate {
-    id: string;
-    name: string;
-    description: string | null;
-    content: string;
-    format: string;
-    default_tags: string[];
-    collection_id: string | null;
-    created_at: string;
-    updated_at: string;
-}
-/** Link as serialized in the shard JSONL. */
-interface ShardLink {
-    id: string;
-    from_note_id: string;
-    to_note_id: string | null;
-    to_url: string | null;
-    kind: string;
-    score: number | null;
-    created_at: string;
-    metadata: Record<string, unknown> | null;
-}
-/** Embedding set as serialized in the shard JSON array. */
-interface ShardEmbeddingSet {
-    id: string;
-    name: string;
-    slug: string | null;
-    description: string | null;
-    purpose: string | null;
-    document_count: number;
-    embedding_count: number;
-    is_system: boolean;
-    keywords: string[];
-    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 {
-    embedding_set_id: string;
-    note_id: string;
-    /** Legacy React shard field; new exports use server membership metadata instead. */
-    embedding_id?: string;
-    membership_type: string;
-    added_at: string;
-    added_by: string | null;
-}
-/** Embedding config as serialized in the shard JSON array. */
-interface ShardEmbeddingConfig {
-    id: string;
-    name: string;
-    description: string | null;
-    model: string;
-    dimension: number;
-    chunk_size: number;
-    chunk_overlap: number;
-    is_default: boolean;
-}
-/** Embedding as serialized in the shard JSONL. */
-interface ShardEmbedding {
-    id: string;
-    note_id: string;
-    chunk_index: number;
-    text: string;
-    vector: number[];
-    model: string;
-    /** React shard extension used to preserve local embedding-set scoping. */
-    embedding_set_id?: string;
-    /** React shard extension used to preserve local creation ordering. */
-    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;
-    };
-}
-
-type AiwgFortemiRecordType = string;
-type AiwgFortemiRecordSchemaVersion = 'aiwg.fortemi.index.record.v1' | 'aiwg.fortemi.index.record.v2';
-type AiwgFortemiIndexExportSchemaVersion = 'aiwg.fortemi.index.export.v1' | 'aiwg.fortemi.index.export.v2';
-type AiwgPrivacyClassification = 'private' | 'sanitized' | 'public';
-type AiwgProvenanceConfidence = 'source' | 'candidate' | 'reviewed' | 'rejected';
-type AiwgReviewAction = 'accept' | 'reject' | 'defer';
-type AiwgFortemiRelationshipDirection = 'upstream' | 'downstream' | 'related';
-interface AiwgFortemiRecordSource {
-    path: string;
-    repo_relative_path: string;
-    locator: string;
-    origin?: string;
-    generated?: boolean;
-    checksum?: string;
-    updated_at?: string;
-}
-interface AiwgFortemiRelationship {
-    type: string;
-    target_id: string;
-    source_path?: string;
-    target_path?: string;
-    direction?: AiwgFortemiRelationshipDirection;
-    label?: string;
-    confidence?: number;
-    privacy?: AiwgPrivacyClassification;
-    metadata?: Record<string, unknown>;
-}
-interface AiwgFortemiProvenance {
-    field: string;
-    source: string;
-    path: string;
-    confidence: AiwgProvenanceConfidence;
-    privacy: AiwgPrivacyClassification;
-}
-type AiwgFortemiSkosRelationType = 'broader' | 'narrower' | 'related' | string;
-interface AiwgFortemiSkosConcept {
-    id: string;
-    prefLabel: string;
-    definition?: string;
-    scheme?: string;
-    notation?: string;
-    uri?: string;
-    altLabels?: string[];
-    metadata?: Record<string, unknown>;
-}
-interface AiwgFortemiSkosRelation {
-    type: AiwgFortemiSkosRelationType;
-    source_id: string;
-    target_id: string;
-    source_path?: string;
-    metadata?: Record<string, unknown>;
-}
-interface AiwgFortemiProvenanceEvent {
-    id?: string;
-    activity: string;
-    agent?: string;
-    started_at?: string;
-    ended_at?: string;
-    source?: string;
-    path?: string;
-    confidence?: AiwgProvenanceConfidence;
-    privacy?: AiwgPrivacyClassification;
-    attributes?: Record<string, unknown>;
-}
-interface AiwgFortemiSearchProjection {
-    title?: string;
-    name?: string;
-    summary?: string;
-    body?: string;
-    triggers?: string[];
-    aliases?: string[];
-    capability?: string;
-    tags?: string[];
-    phase?: string;
-    type?: string;
-    frontmatter?: Record<string, unknown>;
-}
-interface AiwgFortemiChunk {
-    id?: string;
-    text?: string;
-    body?: string;
-    summary?: string;
-    source_path?: string;
-    metadata?: Record<string, unknown>;
-}
-interface AiwgFortemiRecordEmbedding {
-    id?: string;
-    embedding?: number[];
-    vector?: number[];
-    model?: string;
-    granularity?: string;
-    input_hash?: string;
-    source_path?: string;
-    metadata?: Record<string, unknown>;
-}
-type AiwgFortemiAttachmentReference = ShardAttachmentReference;
-type AiwgFortemiBinarySource = ShardBinarySource;
-interface AiwgFortemiRecord {
-    schema_version: AiwgFortemiRecordSchemaVersion;
-    id: string;
-    type: AiwgFortemiRecordType;
-    source: AiwgFortemiRecordSource;
-    title?: string;
-    text?: string;
-    facets: Record<string, string[]>;
-    tags: string[];
-    concepts: string[];
-    relationships: AiwgFortemiRelationship[];
-    provenance: AiwgFortemiProvenance[];
-    search?: AiwgFortemiSearchProjection;
-    chunks?: AiwgFortemiChunk[];
-    binary_sources?: AiwgFortemiBinarySource[];
-    embeddings?: AiwgFortemiRecordEmbedding[];
-    compatibility?: Record<string, unknown>;
-    /** Optional rich SKOS metadata for static consumers that need labels/definitions without opening a shard. */
-    skos_concepts?: AiwgFortemiSkosConcept[];
-    /** Optional SKOS relationship edges among concepts referenced by this record. */
-    skos_relations?: AiwgFortemiSkosRelation[];
-    /** Optional W3C PROV-style activity chain for this record. */
-    provenance_events?: AiwgFortemiProvenanceEvent[];
-    privacy: {
-        classification: AiwgPrivacyClassification;
-        pii: boolean;
-        locality?: string;
-    };
-    updated_at: string;
-}
-interface AiwgFortemiIndexExport {
-    schema_version: AiwgFortemiIndexExportSchemaVersion;
-    generated_at: string;
-    source: {
-        repo: string;
-        privacy: AiwgPrivacyClassification;
-        graph?: string;
-    };
-    items: AiwgFortemiRecord[];
-    compatibility?: {
-        previous_schema_version: 'aiwg.fortemi.index.export.v1';
-        strategy: 'supported';
-    };
-}
-interface AiwgFortemiChunkPartRef {
-    href: string;
-    offset: number;
-    count: number;
-}
-declare const AIWG_SCAN_REQUIRED_FIELDS: Array<keyof AiwgFortemiRecord>;
-type AiwgFortemiProjectedRecord = Pick<AiwgFortemiRecord, 'schema_version' | 'id' | 'type' | 'title' | 'text' | 'facets' | 'tags' | 'concepts' | 'privacy'> & Partial<AiwgFortemiRecord>;
-type AiwgDetailIdEncoding = 'uri' | 'base64url';
-interface AiwgFortemiChunkDetailRef {
-    href: string;
-    encoding?: AiwgDetailIdEncoding;
-}
-interface AiwgFortemiChunkManifest {
-    schema_version: 'aiwg.fortemi.index.chunk-manifest.v1';
-    generated_at: string;
-    source: AiwgFortemiIndexExport['source'];
-    source_export_schema_version?: AiwgFortemiIndexExportSchemaVersion;
-    total: number;
-    part_size: number;
-    facets?: Record<string, Record<string, number>>;
-    projection?: Array<keyof AiwgFortemiRecord>;
-    detail?: AiwgFortemiChunkDetailRef;
-    parts: AiwgFortemiChunkPartRef[];
-}
-interface AiwgFortemiChunkPart {
-    schema_version: 'aiwg.fortemi.index.chunk.v1';
-    manifest_schema_version: 'aiwg.fortemi.index.chunk-manifest.v1';
-    offset: number;
-    items: AiwgFortemiRecord[];
-}
-interface AiwgIndexValidationResult {
-    valid: boolean;
-    errors: string[];
-    counts: Partial<Record<string, number>>;
-}
-interface AiwgChunkedIndexValidationResult {
-    valid: boolean;
-    errors: string[];
-}
-interface AiwgIndexQueryOptions {
-    types?: AiwgFortemiRecordType[];
-    facets?: Record<string, string[]>;
-    tags?: string[];
-    concepts?: string[];
-    privacy?: AiwgPrivacyClassification[];
-    relationshipTargetId?: string;
-    limit?: number;
-    offset?: number;
-    rank?: boolean;
-    snippets?: boolean;
-    snippetLength?: number;
-    weights?: Partial<AiwgIndexQueryWeights>;
-    includeMatches?: boolean;
-    searchProfile?: 'default' | 'aiwg-discovery';
-}
-interface AiwgIndexQueryWeights {
-    title: number;
-    text: number;
-    tag: number;
-    concept: number;
-    facet: number;
-    id: number;
-    source: number;
-}
-interface AiwgIndexQueryMatch {
-    field: 'title' | 'text' | 'tag' | 'concept' | 'facet' | 'id' | 'source';
-    value: string;
-    score?: number;
-    reason?: string;
-}
-interface AiwgIndexQueryRankedItem {
-    item: AiwgFortemiRecord;
-    rank: number;
-    snippet?: string;
-    matches?: AiwgIndexQueryMatch[];
-}
-interface AiwgIndexQueryResult {
-    items: AiwgFortemiRecord[];
-    total: number;
-    facets: Record<string, Record<string, number>>;
-    rankedItems?: AiwgIndexQueryRankedItem[];
-}
-type AiwgChunkedIndexLoader = (part: AiwgFortemiChunkPartRef, manifest: AiwgFortemiChunkManifest) => Promise<unknown>;
-type AiwgChunkedIndexDetailLoader = (id: string, manifest: AiwgFortemiChunkManifest) => Promise<unknown>;
-interface AiwgChunkedIndexLoadOptions {
-    maxCachedParts?: number;
-    detailLoader?: AiwgChunkedIndexDetailLoader;
-    maxCachedDetails?: number;
-    maxCachedMatches?: number;
-}
-type AiwgChunkedIndexProgressPhase = 'part' | 'query';
-interface AiwgChunkedIndexProgress {
-    phase: AiwgChunkedIndexProgressPhase;
-    done: number;
-    total: number;
-    href?: string;
-}
-interface AiwgChunkedIndexQueryOptions extends AiwgIndexQueryOptions {
-    onProgress?: (progress: AiwgChunkedIndexProgress) => void;
-}
-interface AiwgChunkedIndexQueryResult extends AiwgIndexQueryResult {
-    manifestTotal: number;
-    scannedParts: number;
-    fetchedParts: number;
-    complete: boolean;
-}
-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: AiwgFortemiIndexExportSchemaVersion;
-    decisions: AiwgReviewDecision[];
-}
-interface AiwgIndexGraphOptions {
-    communityFacet?: string;
-    communityTagPrefix?: string;
-    relationshipWeights?: Record<string, number>;
-    includeDanglingRelationships?: boolean;
-}
-type AiwgRelationshipDirection = 'in' | 'out' | 'both';
-type AiwgRelationshipSetOperation = 'intersection' | 'union' | 'difference';
-interface AiwgRelationshipTraversalOptions {
-    direction?: AiwgRelationshipDirection;
-    relationshipType?: string;
-    relationshipDirection?: AiwgFortemiRelationshipDirection;
-    limit?: number;
-}
-interface AiwgRelationshipQueryOptions extends AiwgRelationshipTraversalOptions {
-    sourceId?: string;
-    targetId?: string;
-    endpointId?: string;
-    type?: string;
-}
-interface AiwgRelationshipEdgeSummary {
-    source_id: string;
-    target_id: string;
-    type: string;
-    source_path?: string;
-    target_path?: string;
-    direction?: AiwgFortemiRelationshipDirection;
-}
-interface AiwgRelationshipNodeSummary {
-    id: string;
-    type: AiwgFortemiRecordType;
-    title: string;
-}
-interface AiwgRelationshipTraversalResult {
-    nodes: AiwgRelationshipNodeSummary[];
-    edges: AiwgRelationshipEdgeSummary[];
-    complete: boolean;
-    scannedParts?: number;
-    fetchedParts?: number;
-}
-interface AiwgRelationshipSetOptions extends AiwgRelationshipTraversalOptions {
-    op: AiwgRelationshipSetOperation;
-    a: string;
-    b: string;
-}
-interface AiwgRelationshipSetResult {
-    ids: string[];
-    op: AiwgRelationshipSetOperation;
-}
-interface AiwgStaticEmbeddingRecord {
-    record_id: string;
-    embedding: number[];
-    embedding_id?: string;
-    granularity?: string;
-    input_hash: string;
-    source_path?: string;
-}
-interface AiwgStaticEmbeddingSet {
-    schema_version: 'aiwg.fortemi.embedding.set.v1';
-    id: string;
-    model: string;
-    dimensions: number;
-    generated_at: string;
-    granularity: 'title-summary' | 'body' | 'chunked-body' | string;
-    metric?: 'cosine' | 'dot' | 'euclidean';
-    input_hash_algorithm?: string;
-    embeddings: AiwgStaticEmbeddingRecord[];
-}
-interface AiwgHeadlessEmbeddingBackend {
-    model: string;
-    dimensions: number;
-    embed(input: string, record: AiwgFortemiRecord): number[] | Promise<number[]>;
-}
-interface AiwgPrivacyFilterOptions {
-    /** Include records classified `private` (default false). */
-    includePrivate?: boolean;
-    /** Include records flagged `pii` (default false). */
-    includePii?: boolean;
-}
-/** Drop `private`/`pii` records unless explicitly opted in (SEC6, default-safe). */
-declare function filterAiwgRecordsByPrivacy(records: AiwgFortemiRecord[], options?: AiwgPrivacyFilterOptions): AiwgFortemiRecord[];
-interface BuildAiwgStaticEmbeddingSetOptions {
-    id: string;
-    backend: AiwgHeadlessEmbeddingBackend;
-    records?: AiwgFortemiRecord[];
-    generatedAt?: string | Date;
-    granularity?: AiwgStaticEmbeddingSet['granularity'];
-    metric?: AiwgStaticEmbeddingSet['metric'];
-    textForRecord?: (record: AiwgFortemiRecord) => string;
-    /** Privacy filtering (SEC6). Default-safe: excludes `private`/`pii` records. */
-    privacy?: AiwgPrivacyFilterOptions;
-}
-interface AiwgStaticSemanticQueryOptions {
-    limit?: number;
-    offset?: number;
-    minScore?: number;
-}
-interface AiwgStaticSemanticResult {
-    item: AiwgFortemiRecord;
-    score: number;
-    embedding?: AiwgStaticEmbeddingRecord;
-}
-interface AiwgStaticHybridQueryOptions extends AiwgStaticSemanticQueryOptions, AiwgIndexQueryOptions {
-    lexicalWeight?: number;
-    semanticWeight?: number;
-}
-interface AiwgStaticDuplicatePair {
-    left: AiwgFortemiRecord;
-    right: AiwgFortemiRecord;
-    score: number;
-}
-interface AiwgReviewInput {
-    item_id: string;
-    action: AiwgReviewAction;
-    reason?: string;
-}
-interface AiwgIndexControllerSnapshot {
-    index: AiwgFortemiIndexExport | null;
-    chunked: {
-        manifest: AiwgFortemiChunkManifest;
-        cachedParts: number;
-        maxCachedParts: number;
-    } | null;
-    data: AiwgIndexQueryResult | null;
-    error: Error | null;
-    reviewDecisions: AiwgReviewDecision[];
-}
-type AiwgIndexControllerListener = (snapshot: AiwgIndexControllerSnapshot) => void;
-interface AiwgIndexController {
-    loadIndex(value: unknown): AiwgFortemiIndexExport;
-    loadChunkedIndex(manifest: unknown, loader: AiwgChunkedIndexLoader, options?: AiwgChunkedIndexLoadOptions): AiwgFortemiChunkManifest;
-    getIndex(): AiwgFortemiIndexExport | null;
-    getChunkedManifest(): AiwgFortemiChunkManifest | null;
-    getSnapshot(): AiwgIndexControllerSnapshot;
-    query(query?: string, options?: AiwgIndexQueryOptions): AiwgIndexQueryResult;
-    queryChunked(query?: string, options?: AiwgChunkedIndexQueryOptions): Promise<AiwgChunkedIndexQueryResult>;
-    getRecord(id: string): Promise<AiwgFortemiRecord>;
-    neighbors(id: string, options?: AiwgRelationshipTraversalOptions): Promise<AiwgRelationshipTraversalResult>;
-    relationshipQuery(options?: AiwgRelationshipQueryOptions): Promise<AiwgRelationshipTraversalResult>;
-    relationshipSet(options: AiwgRelationshipSetOptions): Promise<AiwgRelationshipSetResult>;
-    clearChunkCache(): void;
-    toCommunityGraph(options?: AiwgIndexGraphOptions): ReturnType<typeof aiwgFortemiIndexToCommunityGraph>;
-    toCommunityGraphChunked(options?: AiwgIndexGraphOptions & {
-        onProgress?: (progress: AiwgChunkedIndexProgress) => void;
-    }): Promise<ReturnType<typeof aiwgFortemiIndexToCommunityGraph>>;
-    setReviewDecision(input: AiwgReviewInput): AiwgReviewDecision;
-    clearReviewDecision(itemId: string): void;
-    createReviewDecisionExport(generatedAt?: string): AiwgReviewDecisionExport;
-    subscribe(listener: AiwgIndexControllerListener): () => void;
-}
-declare function validateAiwgFortemiIndexExport(value: unknown): AiwgIndexValidationResult;
-declare function assertAiwgFortemiIndexExport(value: unknown): AiwgFortemiIndexExport;
-declare function validateAiwgFortemiChunkManifest(value: unknown): AiwgChunkedIndexValidationResult;
-declare function assertAiwgFortemiChunkManifest(value: unknown): AiwgFortemiChunkManifest;
-declare function validateAiwgFortemiChunkPart(value: unknown, partRef?: AiwgFortemiChunkPartRef, manifest?: AiwgFortemiChunkManifest): AiwgChunkedIndexValidationResult;
-declare function assertAiwgFortemiChunkPart(value: unknown, partRef?: AiwgFortemiChunkPartRef, manifest?: AiwgFortemiChunkManifest): AiwgFortemiChunkPart;
-declare function resolveAiwgFetchUrl(href: string, baseUrl?: string | URL): string;
-declare function createAiwgFetchChunkLoader(baseUrl?: string | URL): AiwgChunkedIndexLoader;
-declare function encodeAiwgDetailId(id: string, encoding?: AiwgDetailIdEncoding): string;
-declare function aiwgDetailHrefForId(detail: AiwgFortemiChunkDetailRef, id: string): string;
-declare function createAiwgFetchDetailLoader(baseUrl?: string | URL): AiwgChunkedIndexDetailLoader;
-declare function getAiwgFortemiFacets(items: AiwgFortemiRecord[]): Record<string, Record<string, number>>;
-declare function buildAiwgStaticEmbeddingSet(index: AiwgFortemiIndexExport, options: BuildAiwgStaticEmbeddingSetOptions): Promise<AiwgStaticEmbeddingSet>;
-interface AiwgChunkedIndexBuildOptions {
-    partSize?: number;
-    projection?: Array<keyof AiwgFortemiRecord>;
-    detailHref?: string;
-    idEncoding?: AiwgDetailIdEncoding;
-    generatedAt?: string;
-    /** Privacy filtering (SEC6). Default-safe: excludes `private`/`pii` records. */
-    privacy?: AiwgPrivacyFilterOptions;
-}
-interface AiwgChunkedIndexBuildResult {
-    manifest: AiwgFortemiChunkManifest;
-    parts: Array<{
-        href: string;
-        part: AiwgFortemiChunkPart;
-    }>;
-    details: Array<{
-        id: string;
-        href: string;
-        record: AiwgFortemiRecord;
-    }>;
-}
-declare function buildAiwgChunkedIndex(index: AiwgFortemiIndexExport, options?: AiwgChunkedIndexBuildOptions): AiwgChunkedIndexBuildResult;
-declare function queryAiwgFortemiIndex(index: AiwgFortemiIndexExport, query?: string, options?: AiwgIndexQueryOptions): AiwgIndexQueryResult;
-declare function validateAiwgStaticEmbeddingSet(value: unknown): AiwgChunkedIndexValidationResult;
-declare function assertAiwgStaticEmbeddingSet(value: unknown): AiwgStaticEmbeddingSet;
-declare function queryAiwgSemanticIndex(index: AiwgFortemiIndexExport, embeddingSet: AiwgStaticEmbeddingSet, queryEmbedding: number[], options?: AiwgStaticSemanticQueryOptions): AiwgStaticSemanticResult[];
-declare function queryAiwgHybridIndex(index: AiwgFortemiIndexExport, embeddingSet: AiwgStaticEmbeddingSet, query: string, queryEmbedding: number[], options?: AiwgStaticHybridQueryOptions): AiwgStaticSemanticResult[];
-declare const DEFAULT_AIWG_DUPLICATE_SCAN_MAX_EMBEDDINGS = 5000;
-declare function findAiwgStaticDuplicatePairs(index: AiwgFortemiIndexExport, embeddingSet: AiwgStaticEmbeddingSet, threshold?: number, options?: {
-    maxEmbeddings?: number;
-}): AiwgStaticDuplicatePair[];
-declare function createAiwgReviewDecisionExport(source: Pick<AiwgFortemiIndexExport, 'schema_version'>, decisions: AiwgReviewDecision[], generatedAt?: string): AiwgReviewDecisionExport;
-declare function createAiwgIndexController(initialIndex?: AiwgFortemiIndexExport): AiwgIndexController;
-declare function aiwgFortemiIndexToCommunityGraph(index: AiwgFortemiIndexExport, options?: AiwgIndexGraphOptions): {
-    nodes: {
-        id: string;
-    }[];
-    edges: {
-        source: string;
-        target: string;
-        kind: string;
-        weight: number;
-    }[];
-    communities: {
-        id: string;
-        nodes: string[];
-    }[];
-};
-
-export { type AiwgFortemiSkosRelation as $, AIWG_SCAN_REQUIRED_FIELDS as A, type BlobStore as B, type AiwgChunkedIndexValidationResult as C, type AiwgFortemiAttachmentReference as D, type ExportOptions as E, type AiwgFortemiBinarySource as F, type AiwgFortemiChunk as G, type AiwgFortemiChunkDetailRef as H, type ImportOptions as I, type AiwgFortemiChunkManifest as J, type AiwgFortemiChunkPart as K, type AiwgFortemiChunkPartRef as L, type AiwgFortemiIndexExport as M, type AiwgFortemiIndexExportSchemaVersion as N, type AiwgFortemiProjectedRecord as O, type AiwgFortemiProvenance as P, type AiwgFortemiProvenanceEvent as Q, type AiwgFortemiRecord as R, type ShardAttachmentProjection as S, type AiwgFortemiRecordEmbedding as T, type AiwgFortemiRecordSchemaVersion as U, type AiwgFortemiRecordSource as V, type AiwgFortemiRecordType as W, type AiwgFortemiRelationship as X, type AiwgFortemiRelationshipDirection as Y, type AiwgFortemiSearchProjection as Z, type AiwgFortemiSkosConcept as _, type ShardCollection as a, validateAiwgFortemiChunkPart as a$, type AiwgFortemiSkosRelationType as a0, type AiwgHeadlessEmbeddingBackend as a1, type AiwgIndexController as a2, type AiwgIndexControllerListener as a3, type AiwgIndexControllerSnapshot as a4, type AiwgIndexGraphOptions as a5, type AiwgIndexQueryMatch as a6, type AiwgIndexQueryOptions as a7, type AiwgIndexQueryRankedItem as a8, type AiwgIndexQueryResult as a9, type ConflictStrategy as aA, type ImportCounts as aB, type ImportProgress as aC, type ImportProgressPhase as aD, MemoryBlobStore as aE, SHARD_FORMAT as aF, type ShardClusterRef as aG, type ShardLayout as aH, aiwgFortemiIndexToCommunityGraph as aI, assertAiwgFortemiChunkManifest as aJ, assertAiwgFortemiChunkPart as aK, assertAiwgFortemiIndexExport as aL, assertAiwgStaticEmbeddingSet as aM, buildAiwgChunkedIndex as aN, buildAiwgStaticEmbeddingSet as aO, createAiwgFetchChunkLoader as aP, createAiwgFetchDetailLoader as aQ, createAiwgIndexController as aR, createAiwgReviewDecisionExport as aS, createBlobStore as aT, filterAiwgRecordsByPrivacy as aU, findAiwgStaticDuplicatePairs as aV, getAiwgFortemiFacets as aW, queryAiwgFortemiIndex as aX, queryAiwgHybridIndex as aY, queryAiwgSemanticIndex as aZ, validateAiwgFortemiChunkManifest as a_, type AiwgIndexQueryWeights as aa, type AiwgIndexValidationResult as ab, type AiwgPrivacyClassification as ac, type AiwgPrivacyFilterOptions as ad, type AiwgProvenanceConfidence as ae, type AiwgRelationshipDirection as af, type AiwgRelationshipEdgeSummary as ag, type AiwgRelationshipNodeSummary as ah, type AiwgRelationshipQueryOptions as ai, type AiwgRelationshipSetOperation as aj, type AiwgRelationshipSetOptions as ak, type AiwgRelationshipSetResult as al, type AiwgRelationshipTraversalOptions as am, type AiwgRelationshipTraversalResult as an, type AiwgReviewAction as ao, type AiwgReviewDecision as ap, type AiwgReviewDecisionExport as aq, type AiwgReviewInput as ar, type AiwgStaticDuplicatePair as as, type AiwgStaticEmbeddingRecord as at, type AiwgStaticEmbeddingSet as au, type AiwgStaticHybridQueryOptions as av, type AiwgStaticSemanticQueryOptions as aw, type AiwgStaticSemanticResult as ax, type BuildAiwgStaticEmbeddingSetOptions as ay, CURRENT_SHARD_VERSION as az, type ShardEmbeddingConfig as b, validateAiwgFortemiIndexExport as b0, validateAiwgStaticEmbeddingSet as b1, type AiwgDetailIdEncoding as b2, DEFAULT_AIWG_DUPLICATE_SCAN_MAX_EMBEDDINGS as b3, aiwgDetailHrefForId as b4, encodeAiwgDetailId as b5, resolveAiwgFetchUrl as b6, type ShardEmbedding as c, type ShardEmbeddingSet as d, type ShardEmbeddingSetMember as e, type ShardLink as f, type ShardNote as g, type ShardNoteSkosTag as h, type ShardProvenanceEdge as i, type ShardSkosConcept as j, type ShardSkosRelation as k, type ShardSkosScheme as l, type ShardTag as m, type ShardTemplate as n, type ShardManifest as o, type ImportResult as p, type ShardComponent as q, type AiwgChunkedIndexBuildOptions as r, type AiwgChunkedIndexBuildResult as s, type AiwgChunkedIndexDetailLoader as t, type AiwgChunkedIndexLoadOptions as u, type AiwgChunkedIndexLoader as v, type AiwgChunkedIndexProgress as w, type AiwgChunkedIndexProgressPhase as x, type AiwgChunkedIndexQueryOptions as y, type AiwgChunkedIndexQueryResult as z };