@fortemi/core 2026.7.11 → 2026.7.13

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import { PGlite } from '@electric-sql/pglite';
-import { ProbeReport } from '@bytecask/core';
+import { S as ShardAttachmentProjection, a as ShardCollection, b as ShardEmbeddingConfig, c as ShardEmbedding, d as ShardEmbeddingSet, e as ShardEmbeddingSetMember, f as ShardLink, g as ShardNote, h as ShardNoteSkosTag, i as ShardProvenanceEdge, j as ShardSkosConcept, k as ShardSkosRelation, l as ShardSkosScheme, m as ShardTag, n as ShardTemplate, o as ShardManifest, B as BlobStore, p as BlobReconcileOptions, q as BlobReconcileResult, r as BlobGcOptions, s as BlobGcResult, t as ShardBackend, u as ShardOperation, v as ShardComponent, w as ShardLossEntry, x as ShardCapabilityReport, y as ShardProfileRegistryEntry, E as ExportOptions, z as ShardExportResult, I as ImportOptions, A as ImportResult } from './aiwg-index-shard-BhF8kKAU.js';
+export { C as AIWG_SCAN_REQUIRED_FIELDS, D as AiwgChunkedIndexBuildOptions, F as AiwgChunkedIndexBuildResult, G as AiwgChunkedIndexDetailLoader, H as AiwgChunkedIndexLoadOptions, J as AiwgChunkedIndexLoader, K as AiwgChunkedIndexProgress, L as AiwgChunkedIndexProgressPhase, M as AiwgChunkedIndexQueryOptions, N as AiwgChunkedIndexQueryResult, O as AiwgChunkedIndexValidationResult, P as AiwgFortemiAttachmentReference, Q as AiwgFortemiBinarySource, R as AiwgFortemiChunk, T as AiwgFortemiChunkDetailRef, U as AiwgFortemiChunkManifest, V as AiwgFortemiChunkPart, W as AiwgFortemiChunkPartRef, X as AiwgFortemiIndexExport, Y as AiwgFortemiIndexExportSchemaVersion, Z as AiwgFortemiProjectedRecord, _ as AiwgFortemiProvenance, $ as AiwgFortemiProvenanceEvent, a0 as AiwgFortemiRecord, a1 as AiwgFortemiRecordEmbedding, a2 as AiwgFortemiRecordSchemaVersion, a3 as AiwgFortemiRecordSource, a4 as AiwgFortemiRecordType, a5 as AiwgFortemiRelationship, a6 as AiwgFortemiRelationshipDirection, a7 as AiwgFortemiSearchProjection, a8 as AiwgFortemiSkosConcept, a9 as AiwgFortemiSkosRelation, aa as AiwgFortemiSkosRelationType, ab as AiwgHeadlessEmbeddingBackend, ac as AiwgIndexController, ad as AiwgIndexControllerListener, ae as AiwgIndexControllerSnapshot, af as AiwgIndexGraphOptions, ag as AiwgIndexQueryMatch, ah as AiwgIndexQueryOptions, ai as AiwgIndexQueryRankedItem, aj as AiwgIndexQueryResult, ak as AiwgIndexQueryWeights, al as AiwgIndexValidationResult, am as AiwgKnowledgeShardConversionResult, an as AiwgKnowledgeShardOptions, ao as AiwgPrivacyClassification, ap as AiwgPrivacyFilterOptions, aq as AiwgProvenanceConfidence, ar as AiwgRelationshipDirection, as as AiwgRelationshipEdgeSummary, at as AiwgRelationshipNodeSummary, au as AiwgRelationshipQueryOptions, av as AiwgRelationshipSetOperation, aw as AiwgRelationshipSetOptions, ax as AiwgRelationshipSetResult, ay as AiwgRelationshipTraversalOptions, az as AiwgRelationshipTraversalResult, aA as AiwgReviewAction, aB as AiwgReviewDecision, aC as AiwgReviewDecisionExport, aD as AiwgReviewInput, aE as AiwgStaticDuplicatePair, aF as AiwgStaticEmbeddingRecord, aG as AiwgStaticEmbeddingSet, aH as AiwgStaticHybridQueryOptions, aI as AiwgStaticSemanticQueryOptions, aJ as AiwgStaticSemanticResult, aK as AllowlistTrustStore, aL as BlobBackendKind, aM as BlobStoreDiagnostics, aN as BuildAiwgStaticEmbeddingSetOptions, aO as CURRENT_SHARD_VERSION, aP as ConflictStrategy, aQ as CreateBlobStoreOptions, aR as ImportCounts, aS as ImportProgress, aT as ImportProgressPhase, aU as KnowledgeShardProfile, aV as MemoryBlobStore, aW as SHARD_FORMAT, aX as SIGNATURE_ENTRY, aY as SIGNING_ENVELOPE_VERSION, aZ as ShardAuthorityStatus, a_ as ShardClusterRef, a$ as ShardLayout, b0 as ShardSignatureEnvelope, b1 as ShardSignatureVerdict, b2 as ShardSigner, b3 as ShardSigningPayload, b4 as ShardTrustStore, b5 as SignShardInput, b6 as TrustedKey, b7 as VerifyShardSignatureInput, b8 as aiwgFortemiIndexFromKnowledgeShard, b9 as aiwgFortemiIndexToCommunityGraph, ba as aiwgFortemiIndexToKnowledgeShard, bb as aiwgFortemiIndexToKnowledgeShardWithReport, bc as assertAiwgFortemiChunkManifest, bd as assertAiwgFortemiChunkPart, be as assertAiwgFortemiIndexExport, bf as assertAiwgStaticEmbeddingSet, bg as buildAiwgChunkedIndex, bh as buildAiwgStaticEmbeddingSet, bi as createAiwgFetchChunkLoader, bj as createAiwgFetchDetailLoader, bk as createAiwgIndexController, bl as createAiwgReviewDecisionExport, bm as createBlobStore, bn as createLazyBlobStore, bo as filterAiwgRecordsByPrivacy, bp as findAiwgStaticDuplicatePairs, bq as getAiwgFortemiFacets, br as isShardSigningSupported, bs as queryAiwgFortemiIndex, bt as queryAiwgHybridIndex, bu as queryAiwgSemanticIndex, bv as sidecarBlobDigests, bw as signShard, bx as validateAiwgFortemiChunkManifest, by as validateAiwgFortemiChunkPart, bz as validateAiwgFortemiIndexExport, bA as validateAiwgStaticEmbeddingSet, bB as verifyShardSignature } from './aiwg-index-shard-BhF8kKAU.js';
 import { z, ZodType } from 'zod';
 export { AiwgIndexSchemaValidationResult, getAiwgFortemiIndexExportSchema, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema } from './aiwg-index-schema.js';
+import '@bytecask/core';
 
 /**
  * Generate a RFC 9562 UUIDv7 identifier.
@@ -390,673 +392,6 @@ declare class PGliteWorkerStorageBackendFactory implements StorageBackendFactory
     open(input: StorageOpenRequest): Promise<StorageBackend>;
 }
 
-/**
- * Content-addressed attachment-byte storage — the Fortemi `BlobStore` seam.
- *
- * The store computes the key: `put(bytes)` BLAKE3-hashes the payload and
- * returns the canonical checksum encoding `blake3:<64-char lowercase hex>`
- * (server convention; ADR-012 D1/D3). Every method at this seam speaks that
- * canonical encoding — the bare-hex ⇄ prefixed conversions live in
- * `shard/blob-sidecar.ts` helpers and inside the bytecask adapter here, and
- * nowhere else.
- *
- * Lifecycle authority (ADR-013 D2): canonical attachment manifests decide
- * which bytes are live. `reconcile(liveChecksums)` hands that authoritative
- * set to the store; `gc()` physically removes only unreferenced,
- * age-thresholded objects. Internal refcounts are an implementation detail,
- * never a source of truth.
- *
- * Implementations:
- *   - `createBlobStore()`  — `@bytecask/core` behind a dynamic import
- *     (IndexedDB tier by default, OPFS opt-in, memory fallback). Zero bundle
- *     cost until the first byte operation (ADR-012 D6).
- *   - `createLazyBlobStore()` — synchronous facade that defers the dynamic
- *     import until the first method call (what `FortemiProvider` wires).
- *   - `MemoryBlobStore`    — dependency-free in-process implementation for
- *     tests and the no-persistence tier.
- */
-
-type BlobBackendKind = 'idb' | 'opfs' | 'memory';
-interface BlobStoreDiagnostics {
-    /** The storage tier actually serving bytes. */
-    backend: BlobBackendKind;
-    /** Tier-probe outcome from `@bytecask/core` (null for memory/test stores). */
-    probe: ProbeReport | null;
-}
-interface BlobReconcileOptions {
-    /** Physically remove unreferenced objects now instead of leaving them for gc(). */
-    removeUnreferenced?: boolean;
-}
-interface BlobReconcileResult {
-    /** Live checksums whose bytes are present. */
-    referenced: number;
-    /** Live checksums whose bytes are absent — the reference-only set. */
-    missing: string[];
-    /** Stored checksums not in the live set — GC candidates. */
-    unreferenced: string[];
-    /** Objects physically removed (only when `removeUnreferenced`). */
-    removed: number;
-    bytesFreed: number;
-}
-interface BlobGcOptions {
-    /** Collect only unreferenced objects at least this old (ms). Default 0. */
-    minAgeMs?: number;
-}
-interface BlobGcResult {
-    collected: number;
-    bytesFreed: number;
-}
-/**
- * The Fortemi attachment-byte seam. All checksums are the canonical
- * `blake3:<hex>` encoding stored in `attachment_blob.content_hash` and shard
- * projection records.
- */
-interface BlobStore {
-    /** Store bytes, return their canonical checksum. Idempotent (content-addressed). */
-    put(bytes: Uint8Array): Promise<string>;
-    /** Fetch bytes by canonical checksum; null when absent (reference-only). */
-    read(checksum: string): Promise<Uint8Array | null>;
-    /** True when the bytes for this checksum are physically present. */
-    has(checksum: string): Promise<boolean>;
-    /**
-     * Physically remove one checksum. Import staging uses this only to roll back
-     * content that was absent before promotion.
-     */
-    delete?(checksum: string): Promise<boolean>;
-    /**
-     * Reconcile stored bytes against the authoritative live-checksum set
-     * derived from canonical attachment manifests (ADR-013 D4).
-     */
-    reconcile(liveChecksums: Iterable<string>, opts?: BlobReconcileOptions): Promise<BlobReconcileResult>;
-    /** Physically remove unreferenced, age-thresholded objects. */
-    gc(opts?: BlobGcOptions): Promise<BlobGcResult>;
-    /** Selected backend + probe report, for capability/diagnostic surfaces. */
-    diagnostics(): Promise<BlobStoreDiagnostics>;
-    close(): Promise<void>;
-}
-declare class MemoryBlobStore implements BlobStore {
-    private now;
-    private entries;
-    constructor(now?: () => number);
-    put(bytes: Uint8Array): Promise<string>;
-    read(checksum: string): Promise<Uint8Array | null>;
-    has(checksum: string): Promise<boolean>;
-    delete(checksum: string): Promise<boolean>;
-    reconcile(liveChecksums: Iterable<string>, opts?: BlobReconcileOptions): Promise<BlobReconcileResult>;
-    gc(opts?: BlobGcOptions): Promise<BlobGcResult>;
-    diagnostics(): Promise<BlobStoreDiagnostics>;
-    close(): Promise<void>;
-}
-interface CreateBlobStoreOptions {
-    /** Force a tier; omit to probe IndexedDB → OPFS → memory (measured default). */
-    backend?: BlobBackendKind;
-    /** Injectable IDBFactory for tests (fake-indexeddb). Defaults to the global. */
-    indexedDB?: IDBFactory;
-    /** Skip the one-shot migration of the pre-bytecask blob layout. */
-    migrateLegacy?: boolean;
-}
-/**
- * Construct the bytecask-backed BlobStore for one archive namespace.
- *
- * `@bytecask/core` is reached only through a dynamic `import()` here, so
- * hosts that never touch attachment bytes never load it. The namespace is a
- * function of `archiveName` alone — identical in DB-free and PGlite modes.
- *
- * Tiering: IndexedDB by default (measured default per bytecask's C3
- * benchmark), memory fallback when IndexedDB is unavailable. The OPFS opt-in
- * tier arrives with the upstream `createBlobStore()` factory switch
- * (`@bytecask/core` 2026.7.2); requesting it now fails loudly rather than
- * silently falling back.
- */
-declare function createBlobStore(archiveName: string, options?: CreateBlobStoreOptions): Promise<BlobStore>;
-/**
- * Synchronous facade over {@link createBlobStore}: construction is free, the
- * dynamic import happens on the first byte operation. This is what
- * `FortemiProvider` wires so hosts that never touch attachment bytes never
- * pay for the substrate (ADR-012 D6).
- */
-declare function createLazyBlobStore(archiveName: string, options?: CreateBlobStoreOptions): BlobStore;
-
-/**
- * Signed Knowledge-Shard verification (#324, ADR-014).
- *
- * Authenticity — as distinct from the consistency the in-archive checksums
- * provide (SEC7) — comes from an Ed25519 signature over a canonical payload
- * that commits to the manifest digest and the referenced blob-byte digests.
- * Verification is pure and side-effect-free; it runs BEFORE any record or
- * blob mutation (ADR-013 D6 / ADR-014 D3). Bytecask never sees keys.
- */
-
-declare const SIGNATURE_ENTRY = "signature.json";
-declare const SIGNING_ENVELOPE_VERSION = "1";
-declare const SIGNING_ALGORITHM = "ed25519";
-interface ShardSigner {
-    key_id: string;
-    algorithm: typeof SIGNING_ALGORITHM;
-    /** Raw 32-byte Ed25519 public key, base64url. */
-    public_key: string;
-}
-/** The signed payload (never contains its own signature — ADR-014 D2). */
-interface ShardSigningPayload {
-    format_version: typeof SIGNING_ENVELOPE_VERSION;
-    signer: ShardSigner;
-    /** SHA-256 hex of the canonical manifest.json bytes. */
-    manifest_digest: string;
-    /** Sorted bare-hex BLAKE3 digests of referenced sidecar blobs. */
-    blob_digests: string[];
-}
-/** `signature.json` archive entry: the payload plus its base64url signature. */
-interface ShardSignatureEnvelope extends ShardSigningPayload {
-    signature: string;
-}
-interface TrustedKey {
-    key_id: string;
-    /** Raw 32-byte Ed25519 public key, base64url. */
-    public_key: string;
-    revoked?: boolean;
-}
-interface ShardTrustStore {
-    resolve(keyId: string): TrustedKey | null | Promise<TrustedKey | null>;
-}
-/** In-memory allowlist trust store seeded from `{ key_id, public_key }` entries. */
-declare class AllowlistTrustStore implements ShardTrustStore {
-    private keys;
-    constructor(keys: TrustedKey[]);
-    resolve(keyId: string): TrustedKey | null;
-    /** Mark a key revoked without removing it (still resolvable, verdict `revoked`). */
-    revoke(keyId: string): void;
-}
-type ShardSignatureVerdict = {
-    ok: true;
-    keyId: string;
-} | {
-    ok: false;
-    reason: 'unsigned';
-} | {
-    ok: false;
-    reason: 'malformed';
-    detail: string;
-} | {
-    ok: false;
-    reason: 'unknown-signer';
-    keyId: string;
-} | {
-    ok: false;
-    reason: 'revoked';
-    keyId: string;
-} | {
-    ok: false;
-    reason: 'bad-signature';
-    keyId: string;
-} | {
-    ok: false;
-    reason: 'content-mismatch';
-    detail: string;
-} | {
-    ok: false;
-    reason: 'unsupported';
-};
-/** True when this runtime's WebCrypto verifies Ed25519 (ADR-014 D1). */
-declare function isShardSigningSupported(): Promise<boolean>;
-/** Sorted bare-hex BLAKE3 digests of the sidecar blobs present in the archive. */
-declare function sidecarBlobDigests(files: Map<string, Uint8Array>): string[];
-interface VerifyShardSignatureInput {
-    files: Map<string, Uint8Array>;
-    trustStore: ShardTrustStore;
-}
-/**
- * Verify a shard's Ed25519 signature over its canonical payload. Pure: reads
- * archive bytes, resolves the key, checks the signature and the
- * manifest/blob-digest commitments. No persistence, no mutation.
- */
-declare function verifyShardSignature(input: VerifyShardSignatureInput): Promise<ShardSignatureVerdict>;
-interface SignShardInput {
-    files: Map<string, Uint8Array>;
-    keyId: string;
-    /** Ed25519 private key (raw 32-byte seed or PKCS8), imported by the caller. */
-    privateKey: CryptoKey;
-    /** Raw 32-byte public key, base64url — embedded in the envelope + trust store. */
-    publicKey: string;
-}
-/**
- * Produce the `signature.json` envelope for an assembled archive `files` map.
- * The caller adds the returned bytes to the archive under {@link SIGNATURE_ENTRY}
- * (excluded from manifest.checksums — it post-dates the manifest).
- */
-declare function signShard(input: SignShardInput): Promise<Uint8Array>;
-
-/**
- * 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.
- *
- * @implements @.aiwg/adrs/ADR-011-shard-server-conformance-and-version-negotiation.md
- * @schema @packages/core/schemas/knowledge-shard.schema.receipt.json
- * @created 2026-07-17
- * @agent Codex
- */
-
-declare const CURRENT_SHARD_VERSION = "1.2.0";
-declare const SHARD_FORMAT = "matric-shard";
-/** Components that can appear in a shard archive. */
-type ShardComponent = 'notes' | 'collections' | 'tags' | 'templates' | 'links' | 'note_originals' | 'note_original_history' | 'note_revised_current' | 'note_revisions' | 'embedding_sets' | 'embedding_configs' | 'embedding_set_members' | 'embeddings' | 'provenance_activities' | 'named_locations' | 'provenance_locations' | 'provenance_devices' | 'provenance_records' | 'skos_schemes' | 'skos_concepts' | 'skos_labels' | 'skos_notes' | 'skos_relations' | 'skos_mapping_relations' | 'skos_scheme_memberships' | 'note_skos_tags' | 'skos_collections' | 'skos_collection_members' | 'provenance_edges' | 'community_assignments' | 'communities' | 'graph_edges' | 'graph_sources';
-type KnowledgeShardProfile = 'core-v1' | 'full-v1' | 'record-v1';
-type ShardBackend = 'pglite' | 'record-store';
-type ShardOperation = 'export' | 'import';
-type ShardAuthorityStatus = 'supported' | 'candidate' | 'reserved' | 'unknown' | 'unprofiled';
-interface ShardProfileRegistryEntry {
-    profile: KnowledgeShardProfile;
-    authority_status: 'supported' | 'candidate' | 'reserved';
-    components: ShardComponent[];
-}
-interface ShardLossEntry {
-    code: string;
-    message: string;
-    component?: ShardComponent;
-    count?: number;
-}
-interface ShardCapabilityReport {
-    schema_version: 'fortemi.shard.capability-report.v1';
-    backend: ShardBackend;
-    operation: ShardOperation;
-    requested_profile: string | null;
-    authority_status: ShardAuthorityStatus;
-    backend_supported: boolean;
-    portable: boolean;
-    authority: {
-        repository: string;
-        commit: string;
-        contract_sha256: string;
-        contract_revision: string;
-        schema_version: string;
-        schema_bundle_sha256: string;
-    };
-    advertised_profiles: KnowledgeShardProfile[];
-    supported_components: ShardComponent[];
-    declared_components: ShardComponent[];
-    unsupported_components: ShardComponent[];
-    omitted_components: ShardComponent[];
-    losses: ShardLossEntry[];
-}
-interface ShardAttachmentReference {
-    id: string;
-    path: string;
-    mime: string | null;
-    checksum: string;
-    bytes: number;
-}
-interface ShardAttachmentProjection {
-    extracted_text: string | null;
-    /** Legacy unprofiled relationship timestamp; outside core-v1. */
-    created_at?: string;
-    /** Legacy unprofiled attachment tombstone; outside core-v1. */
-    deleted_at?: string | null;
-    extraction_status?: 'extracted' | 'pending' | 'failed' | 'blocked' | 'deferred';
-    reason?: null | 'extraction_pending' | 'extractor_failed' | 'quarantined' | 'large_binary' | 'unsupported_mime' | 'no_extracted_text';
-    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 ShardProducer {
-    name: string;
-    version: string;
-    revision?: string;
-}
-interface ShardManifest {
-    version: string;
-    /** Named server-owned portability profile. Required for canonical interchange. */
-    profile?: string;
-    /** Structured producer identity used by canonical profiles. */
-    producer?: ShardProducer;
-    /** @deprecated Legacy producer release field. */
-    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 {
-    /**
-     * Explicit portability profile. Only profiles advertised by the selected
-     * producer are accepted. Omit to retain the legacy unprofiled React archive.
-     */
-    profile?: string;
-    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 promoted before
-     * the logical transaction. A transaction failure removes only bytes that
-     * were absent before promotion. Stores without the optional `delete`
-     * capability fail before promotion. Absent → reference-only metadata.
-     */
-    blobStore?: BlobStore;
-    /**
-     * Publisher-provenance policy for signed shards (#324, ADR-014):
-     * - `require` — reject unsigned or bad-signature shards (default when a
-     *   `trustStore` is supplied);
-     * - `prefer` — verify signed shards; import unsigned ones with a warning;
-     *   still reject a present-but-invalid signature;
-     * - `trusted-local-only` — ignore signatures (own-export import).
-     * When both `trustStore` and this are omitted, verification is skipped
-     * entirely (checksum-only, unchanged behavior).
-     */
-    verifySignature?: 'require' | 'prefer' | 'trusted-local-only';
-    /** Trust store resolving signer key_id → public key (required for `require`/`prefer`). */
-    trustStore?: ShardTrustStore;
-}
-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;
-    capability_report: ShardCapabilityReport;
-}
-interface ShardExportResult {
-    success: boolean;
-    archive: Uint8Array | null;
-    errors: string[];
-    capability_report: ShardCapabilityReport;
-}
-/** Note as serialized in the shard JSONL. */
-interface ShardNote {
-    id: string;
-    title: string | null;
-    original_content: string;
-    revised_content: string | null;
-    metadata?: Record<string, unknown> | 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;
-    /** Schema 1.1 core-v1 tombstone; legacy unprofiled archives also carry it. */
-    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;
-    /** Legacy unprofiled fields; outside core-v1. */
-    updated_at?: string;
-    deleted_at?: string | null;
-    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;
-    /** Optional for legacy React shards exported before URL links existed. */
-    to_url?: string | null;
-    kind: string;
-    score: number | null;
-    created_at: string;
-    /** Optional for legacy React shards exported before link metadata existed. */
-    metadata?: Record<string, unknown> | null;
-}
-/**
- * Embedding set as serialized in the shard JSON array.
- *
- * Fields beyond id/model/dimension are optional for backward compatibility:
- * legacy React shards omit them and import falls back to the same defaults
- * `embeddingSetFromShard` applies (name → model, is_system → false, …).
- */
-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;
-    /** Optional for legacy React shards; import defaults to 'materialized'. */
-    membership_type?: string;
-    /** Optional for legacy React shards; import falls back to the manifest timestamp. */
-    added_at?: string;
-    /** Optional for legacy React shards; import defaults to NULL. */
-    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.
- *
- * Server metadata fields (`chunk_index`, `text`, `model`) are optional for
- * backward compatibility: legacy React shards exported before migration 0016
- * carry only `id`, `note_id`, `embedding_set_id`, `vector`, `created_at`.
- * Import normalizes absent metadata to schema defaults (0, '', NULL).
- */
-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;
-    };
-}
-
 /**
  * Field mapper — converts between browser schema and shard (server) schema.
  *
@@ -1082,7 +417,7 @@ interface BrowserNoteExport {
     deleted_at: Date | string | null;
     original_content: string;
     revised_content: string | null;
-    ai_metadata?: Record<string, unknown> | null;
+    ai_metadata?: unknown;
     collection_id?: string | null;
     attachments?: ShardAttachmentProjection[];
     tags: string[];
@@ -1125,7 +460,7 @@ declare function linkFromShard(shard: ShardLink): {
     created_at: string;
     updated_at: string | null;
     deleted_at: string | null;
-    metadata: Record<string, unknown> | null;
+    metadata: unknown;
 };
 /** Convert a browser collection to shard format (accepts SQL rows or canonical ISO-string records). */
 declare function collectionToShard(collection: {
@@ -2981,19 +2316,19 @@ declare const CaptureKnowledgeInputSchema: z.ZodObject<{
     }, {
         content: string;
         title?: string | undefined;
-        format?: "markdown" | "plain" | "html" | undefined;
         tags?: string[] | undefined;
+        format?: "markdown" | "plain" | "html" | undefined;
     }>, "many">>;
     template: z.ZodOptional<z.ZodString>;
     variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     source: string;
     format: "markdown" | "plain" | "html";
-    visibility: "private" | "shared" | "public";
+    visibility: "private" | "public" | "shared";
     action: "create" | "bulk_create" | "from_template";
     title?: string | undefined;
-    archive_id?: string | undefined;
     tags?: string[] | undefined;
+    archive_id?: string | undefined;
     content?: string | undefined;
     notes?: {
         format: "markdown" | "plain" | "html";
@@ -3007,16 +2342,16 @@ declare const CaptureKnowledgeInputSchema: z.ZodObject<{
     action: "create" | "bulk_create" | "from_template";
     source?: string | undefined;
     title?: string | undefined;
-    archive_id?: string | undefined;
-    format?: "markdown" | "plain" | "html" | undefined;
-    visibility?: "private" | "shared" | "public" | undefined;
     tags?: string[] | undefined;
+    format?: "markdown" | "plain" | "html" | undefined;
+    archive_id?: string | undefined;
+    visibility?: "private" | "public" | "shared" | undefined;
     content?: string | undefined;
     notes?: {
         content: string;
         title?: string | undefined;
-        format?: "markdown" | "plain" | "html" | undefined;
         tags?: string[] | undefined;
+        format?: "markdown" | "plain" | "html" | undefined;
     }[] | undefined;
     template?: string | undefined;
     variables?: Record<string, string> | undefined;
@@ -3066,14 +2401,14 @@ declare const SearchInputSchema: z.ZodObject<{
     limit: number;
     offset: number;
     include_facets: boolean;
-    mode: "auto" | "text" | "semantic" | "hybrid";
+    mode: "text" | "auto" | "semantic" | "hybrid";
     query: string;
     source?: string | undefined;
+    tags?: string[] | undefined;
     format?: "markdown" | "plain" | "html" | undefined;
-    visibility?: "private" | "shared" | "public" | undefined;
+    visibility?: "private" | "public" | "shared" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
-    tags?: string[] | undefined;
     collection_id?: string | undefined;
     date_from?: Date | undefined;
     date_to?: Date | undefined;
@@ -3082,18 +2417,18 @@ declare const SearchInputSchema: z.ZodObject<{
 }, {
     query: string;
     source?: string | undefined;
+    tags?: string[] | undefined;
     format?: "markdown" | "plain" | "html" | undefined;
-    visibility?: "private" | "shared" | "public" | undefined;
+    visibility?: "private" | "public" | "shared" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
-    tags?: string[] | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     collection_id?: string | undefined;
     date_from?: Date | undefined;
     date_to?: Date | undefined;
     include_facets?: boolean | undefined;
-    mode?: "auto" | "text" | "semantic" | "hybrid" | undefined;
+    mode?: "text" | "auto" | "semantic" | "hybrid" | undefined;
     embeddingSetId?: string | undefined;
     query_embedding?: number[] | undefined;
 }>;
@@ -3173,20 +2508,20 @@ 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";
+    sort: "updated_at" | "title" | "created_at";
     limit: number;
     offset: number;
     order: "asc" | "desc";
+    tags?: string[] | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
-    tags?: string[] | undefined;
     include_deleted?: boolean | undefined;
     collection_id?: string | undefined;
 }, {
-    sort?: "created_at" | "updated_at" | "title" | undefined;
+    tags?: string[] | undefined;
+    sort?: "updated_at" | "title" | "created_at" | undefined;
     is_starred?: boolean | undefined;
     is_archived?: boolean | undefined;
-    tags?: string[] | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     order?: "asc" | "desc" | undefined;
@@ -3229,16 +2564,16 @@ declare const ManageCollectionsInputSchema: z.ZodObject<{
     note_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     action: "create" | "delete" | "list" | "assign" | "unassign" | "list_tree";
+    name?: string | undefined;
     collection_id?: string | undefined;
     note_id?: string | undefined;
-    name?: string | undefined;
     description?: string | undefined;
     parent_id?: string | undefined;
 }, {
     action: "create" | "delete" | "list" | "assign" | "unassign" | "list_tree";
+    name?: string | undefined;
     collection_id?: string | undefined;
     note_id?: string | undefined;
-    name?: string | undefined;
     description?: string | undefined;
     parent_id?: string | undefined;
 }>;
@@ -4216,6 +3551,7 @@ interface CreateShardCapabilityReportInput {
     backend: ShardBackend;
     operation: ShardOperation;
     requestedProfile: string | null;
+    requestedSchemaVersion?: string | null;
     declaredComponents?: readonly ShardComponent[];
     omittedComponents?: readonly ShardComponent[];
     losses?: readonly ShardLossEntry[];
@@ -4289,6 +3625,12 @@ declare function validateChecksums(checksums: Record<string, string>, files: Map
     failures: string[];
 }>;
 
+/** Presence semantics for Knowledge Shard schema 2.0 (Fortemi #1083). */
+
+type ShardPresenceState = 'absent' | 'null' | 'empty' | 'value';
+type StoredPresenceState = ShardPresenceState | 'legacy-indeterminate';
+type ShardPresenceMap = Record<string, StoredPresenceState>;
+
 /**
  * Shard export pipeline — query all entities, serialize, pack into .shard archive.
  *
@@ -4343,7 +3685,7 @@ interface ShardSchemaValidationResult {
     errors: string[];
 }
 type ShardFiles = Map<string, Uint8Array>;
-type CoreV1SchemaVersion = '1.0.0' | '1.1.0' | '1.2.0';
+type CoreV1SchemaVersion = '1.0.0' | '1.1.0' | '1.2.0' | '2.0.0';
 declare function getKnowledgeShardSchema(): unknown;
 declare function getKnowledgeShardContractReceipt(): unknown;
 declare function validateShardManifest(value: unknown): ShardSchemaValidationResult;
@@ -4520,493 +3862,6 @@ declare function getPrefetchedSha256(url: string): string | undefined;
  */
 declare function clearPrefetchedShard(url?: string): void;
 
-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 AiwgKnowledgeShardOptions {
-    createdAt?: string;
-    matricVersion?: string;
-    /**
-     * Reserved for a future full-v1 converter. Passing true currently fails
-     * closed because a partial rich-component inventory is not a valid profile.
-     */
-    includeNativeRichComponents?: boolean;
-}
-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 createAiwgFetchChunkLoader(baseUrl?: string | URL): AiwgChunkedIndexLoader;
-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 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[];
-    }[];
-};
-/**
- * Convert the static AIWG/Fortemi v2 index contract into a portable Knowledge
- * Shard. Every note retains the complete source envelope and record in metadata,
- * so the native note/link/SKOS/provenance projections are reversible.
- */
-declare function aiwgFortemiIndexToKnowledgeShard(index: AiwgFortemiIndexExport, options?: AiwgKnowledgeShardOptions): Promise<Uint8Array>;
-/**
- * Recover the exact AIWG index envelope and records embedded by
- * {@link aiwgFortemiIndexToKnowledgeShard}.
- */
-declare function aiwgFortemiIndexFromKnowledgeShard(bytes: Uint8Array): AiwgFortemiIndexExport;
-
 /**
  * Canonical RecordStore contract — the writable structured-record layer that
  * exists independently of PGlite (#323, ADR-013 D3).
@@ -5016,7 +3871,12 @@ declare function aiwgFortemiIndexFromKnowledgeShard(bytes: Uint8Array): AiwgFort
  * replay of the change journal — rebuildable at any time without touching
  * canonical records or attachment bytes.
  */
-interface NoteRecord0 {
+
+interface PresenceTrackedRecord {
+    /** Internal schema-2.0 state; never serialized as a shard component field. */
+    __fortemi_presence?: ShardPresenceMap;
+}
+interface NoteRecord0 extends PresenceTrackedRecord {
     id: string;
     archive_id: string | null;
     title: string | null;
@@ -5031,14 +3891,14 @@ interface NoteRecord0 {
     updated_at: string;
     deleted_at: string | null;
 }
-interface NoteOriginalRecord {
+interface NoteOriginalRecord extends PresenceTrackedRecord {
     id: string;
     note_id: string;
     content: string;
     content_hash: string;
     created_at: string;
 }
-interface NoteRevisedCurrentRecord {
+interface NoteRevisedCurrentRecord extends PresenceTrackedRecord {
     /** Keyed by note id (mirrors the SQL PK `note_id`). */
     id: string;
     content: string | null;
@@ -5048,21 +3908,23 @@ interface NoteRevisedCurrentRecord {
     is_user_edited: boolean;
     updated_at: string;
 }
-interface NoteTagRecord {
+interface NoteTagRecord extends PresenceTrackedRecord {
     id: string;
     note_id: string;
     tag: string;
     created_at: string;
 }
-interface LinkRecord0 {
+interface LinkRecord0 extends PresenceTrackedRecord {
     id: string;
     source_note_id: string;
     target_note_id: string;
     link_type: string;
     created_at: string;
     deleted_at: string | null;
+    /** Exact record-v1 shard metadata; internal projection state, not a domain field. */
+    __fortemi_shard_metadata?: unknown;
 }
-interface CollectionRecord {
+interface CollectionRecord extends PresenceTrackedRecord {
     id: string;
     name: string;
     description: string | null;
@@ -5072,13 +3934,13 @@ interface CollectionRecord {
     updated_at: string;
     deleted_at: string | null;
 }
-interface CollectionNoteRecord {
+interface CollectionNoteRecord extends PresenceTrackedRecord {
     id: string;
     collection_id: string;
     note_id: string;
     created_at: string;
 }
-interface AttachmentRecord {
+interface AttachmentRecord extends PresenceTrackedRecord {
     id: string;
     note_id: string;
     blob_id: string;
@@ -5090,13 +3952,21 @@ interface AttachmentRecord {
     position: number;
     created_at: string;
     deleted_at: string | null;
+    /** Exact record-v1 extraction projection state. */
+    __fortemi_extraction_status?: 'extracted' | 'pending' | 'failed' | 'blocked' | 'deferred';
+    __fortemi_extraction_reason?: unknown;
+    __fortemi_projection_presence?: ShardPresenceMap;
 }
-interface AttachmentBlobRecord {
+interface AttachmentBlobRecord extends PresenceTrackedRecord {
     id: string;
     content_hash: string;
     size_bytes: number;
     created_at: string;
 }
+interface ShardManifestRecord extends PresenceTrackedRecord {
+    id: string;
+    manifest: Record<string, unknown>;
+}
 /** Collection name → record type. The store is generic over this map. */
 interface RecordCollections {
     note: NoteRecord0;
@@ -5108,6 +3978,7 @@ interface RecordCollections {
     collection_note: CollectionNoteRecord;
     attachment: AttachmentRecord;
     attachment_blob: AttachmentBlobRecord;
+    shard_manifest: ShardManifestRecord;
 }
 type RecordCollectionName = keyof RecordCollections;
 declare const RECORD_COLLECTIONS: readonly RecordCollectionName[];
@@ -5522,6 +4393,6 @@ declare function importShardToRecords(store: RecordStore, data: Uint8Array | Arr
  * @created 2026-07-17
  * @agent Codex
  */
-declare const VERSION = "2026.7.11";
+declare const VERSION = "2026.7.13";
 
-export { AIWG_SCAN_REQUIRED_FIELDS, type AiwgChunkedIndexBuildOptions, type AiwgChunkedIndexBuildResult, type AiwgChunkedIndexDetailLoader, type AiwgChunkedIndexLoadOptions, type AiwgChunkedIndexLoader, type AiwgChunkedIndexProgress, type AiwgChunkedIndexProgressPhase, type AiwgChunkedIndexQueryOptions, type AiwgChunkedIndexQueryResult, type AiwgChunkedIndexValidationResult, type AiwgFortemiAttachmentReference, type AiwgFortemiBinarySource, type AiwgFortemiChunk, type AiwgFortemiChunkDetailRef, type AiwgFortemiChunkManifest, type AiwgFortemiChunkPart, type AiwgFortemiChunkPartRef, type AiwgFortemiIndexExport, type AiwgFortemiIndexExportSchemaVersion, type AiwgFortemiProjectedRecord, type AiwgFortemiProvenance, type AiwgFortemiProvenanceEvent, type AiwgFortemiRecord, type AiwgFortemiRecordEmbedding, type AiwgFortemiRecordSchemaVersion, type AiwgFortemiRecordSource, type AiwgFortemiRecordType, type AiwgFortemiRelationship, type AiwgFortemiRelationshipDirection, type AiwgFortemiSearchProjection, type AiwgFortemiSkosConcept, type AiwgFortemiSkosRelation, type AiwgFortemiSkosRelationType, type AiwgHeadlessEmbeddingBackend, type AiwgIndexController, type AiwgIndexControllerListener, type AiwgIndexControllerSnapshot, type AiwgIndexGraphOptions, type AiwgIndexQueryMatch, type AiwgIndexQueryOptions, type AiwgIndexQueryRankedItem, type AiwgIndexQueryResult, type AiwgIndexQueryWeights, type AiwgIndexValidationResult, type AiwgKnowledgeShardOptions, type AiwgPrivacyClassification, type AiwgPrivacyFilterOptions, type AiwgProvenanceConfidence, type AiwgRelationshipDirection, type AiwgRelationshipEdgeSummary, type AiwgRelationshipNodeSummary, type AiwgRelationshipQueryOptions, type AiwgRelationshipSetOperation, type AiwgRelationshipSetOptions, type AiwgRelationshipSetResult, type AiwgRelationshipTraversalOptions, type AiwgRelationshipTraversalResult, type AiwgReviewAction, type AiwgReviewDecision, type AiwgReviewDecisionExport, type AiwgReviewInput, type AiwgStaticDuplicatePair, type AiwgStaticEmbeddingRecord, type AiwgStaticEmbeddingSet, type AiwgStaticHybridQueryOptions, type AiwgStaticSemanticQueryOptions, type AiwgStaticSemanticResult, AllowlistTrustStore, type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRecord, type AttachmentBlobRow, type AttachmentProjectionResult, type AttachmentRecord, type AttachmentRow, AttachmentsRepository, type BackendCandidate, type BackendCapabilities, type BackendConcept, type BackendLink, type BackendListOptions, type BackendNote, type BackendNoteFull, type BackendProvenanceEdge, type BackendRequest, type BackendSearchHit, type BackendSearchQueryOptions, type BackendSearchResult, type BackendSelection, type BackendSemanticTier, type BackendStartupCost, type BlobBackendKind, type BlobGcOptions, type BlobGcResult, type BlobReconcileOptions, type BlobReconcileResult, type BlobStore, type BlobStoreDiagnostics, type BridgeCapability, type BridgeProviderInfo, type BrowserNoteExport, type BuildAiwgStaticEmbeddingSetOptions, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, type CanonicalAttachInput, CanonicalAttachmentsRepository, type CanonicalNoteCreateInput, type CanonicalNoteUpdateInput, type CanonicalNoteView, CanonicalNotesRepository, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionNoteRecord, type CollectionRecord, 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 CosineSemanticProviderOptions, type CreateBlobStoreOptions, type CreatePGliteOptions, type CreateRecordStoreOptions, type CspDirectiveName, type CspDirectives, type CspViolationReport, DB_SNAPSHOT_SCHEMA_VERSION, type DataBackend, type DatabaseClient, type DbSnapshot, type DbSnapshotCompat, type DbSnapshotCompression, type DbSnapshotExpectations, type DbSnapshotMeta, type DbSnapshotSource, DbSnapshotVersionError, type DiscoveredProvider, type DiscoveryOptions, type DumpDbSnapshotOptions, type DumpableDb, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, type EmbedFunction, type EmbedRequest, type EmbedRequestMessage, type EmbedResponse, type EmbedResponseMessage, type EmbedTransportPort, type EmbedWorkerOptions, 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, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FetchFortemiCompatibilityOptions, type FortemiBridge, type FortemiBridgeCapabilities, type FortemiBridgeHost, type FortemiCompatibilityCapability, type FortemiCompatibilityResponse, type FortemiCompatibilityState, type FortemiCompatibilityValidationResult, type FortemiConfig, type FortemiCore, type FortemiInferenceRouter, type FortemiRequiredCompatibilityCapability, type FortemiSecretStore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type GraphCommunity, type GraphEdge, type GraphNode, GraphRepository, type IDisposable, IdbRecordStore, type ImportCounts, type ImportOptions, type ImportProgress, type ImportProgressPhase, type ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, type JournalEntry, type KnowledgeShardProfile, LOCAL_ENDPOINTS, type LegacyMigrationReport, type LinkRecord0, 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, MemoryRecordStore, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteOriginalRecord, type NoteProjectionResult, type NoteRecord0, type NoteRevisedCurrentRecord, type NoteRevision, type NoteSkosTag, type NoteSummary, type NoteTagRecord, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, type OpenShardOptions, type PGliteBackendOptions, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, type PGliteWorkerStorageBackendFactoryOptions, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type PrefetchOptions, type PrefetchResult, type ProbeResult, type ProbeStatus, type ProvenanceEdge, ProvenanceRepository, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, type RecommendedTier, type RecordBackendManageNoteResult, type RecordBackendOptions, type RecordCollectionName, type RecordCollections, type RecordListOptions, type RecordMutation, type RecordProjectionResult, type RecordProvenanceInput, type RecordStore, type RecordStoreCapabilities, type RemoteBackendConfig, type RemoteBackendPaths, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RestoreDbSnapshotOptions, type RouteHandler, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SUPPORTED_PGLITE_VERSION, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardAuthorityStatus, type ShardBackend, type ShardBackendOptions, type ShardCapabilityReport, type ShardClusterRef, type ShardCollection, type ShardComponent, type ShardComponentStore, type ShardEmbedding, type ShardEmbeddingConfig, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardExportResult, type ShardLayout, type ShardLink, type ShardListOptions, type ShardLossEntry, type ShardManifest, type ShardNote, type ShardNoteFull, type ShardNoteSkosTag, type ShardOperation, type ShardProfileRegistryEntry, type ShardProvenanceEdge, type ShardReader, type ShardReaderNote, type ShardReaderSource, type ShardSchemaValidationResult, type ShardSearchOptions, type ShardSearchRankedNote, type ShardSearchResult, type ShardSearchWeights, type ShardSignatureEnvelope, type ShardSignatureVerdict, type ShardSigner, type ShardSigningPayload, type ShardSkosConcept, type ShardSkosRelation, type ShardSkosScheme, type ShardTag, type ShardTemplate, type ShardTrustStore, type SignShardInput, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StaticSemanticProvider, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, type TrustedKey, TypedEventBus, VERSION, type VectorEntry, type VerifyShardSignatureInput, type VirtualEmbeddingSetDefinition, type VirtualEmbeddingSetSource, type VirtualEmbeddingSetValidationError, type VirtualMaterializationPolicy, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, computeBlobHash, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, importShardToRecords, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, migrateLegacyBlobStore, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
+export { type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRecord, type AttachmentBlobRow, type AttachmentProjectionResult, type AttachmentRecord, type AttachmentRow, AttachmentsRepository, type BackendCandidate, type BackendCapabilities, type BackendConcept, type BackendLink, type BackendListOptions, type BackendNote, type BackendNoteFull, type BackendProvenanceEdge, type BackendRequest, type BackendSearchHit, type BackendSearchQueryOptions, type BackendSearchResult, type BackendSelection, type BackendSemanticTier, type BackendStartupCost, BlobGcOptions, BlobGcResult, BlobReconcileOptions, BlobReconcileResult, BlobStore, type BridgeCapability, type BridgeProviderInfo, type BrowserNoteExport, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, type CanonicalAttachInput, CanonicalAttachmentsRepository, type CanonicalNoteCreateInput, type CanonicalNoteUpdateInput, type CanonicalNoteView, CanonicalNotesRepository, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionNoteRecord, type CollectionRecord, 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 CooldownConfig, type CooldownEvent, type CosineSemanticProviderOptions, type CreatePGliteOptions, type CreateRecordStoreOptions, type CspDirectiveName, type CspDirectives, type CspViolationReport, DB_SNAPSHOT_SCHEMA_VERSION, type DataBackend, type DatabaseClient, type DbSnapshot, type DbSnapshotCompat, type DbSnapshotCompression, type DbSnapshotExpectations, type DbSnapshotMeta, type DbSnapshotSource, DbSnapshotVersionError, type DiscoveredProvider, type DiscoveryOptions, type DumpDbSnapshotOptions, type DumpableDb, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, type EmbedFunction, type EmbedRequest, type EmbedRequestMessage, type EmbedResponse, type EmbedResponseMessage, type EmbedTransportPort, type EmbedWorkerOptions, 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, ExportOptions, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FetchFortemiCompatibilityOptions, type FortemiBridge, type FortemiBridgeCapabilities, type FortemiBridgeHost, type FortemiCompatibilityCapability, type FortemiCompatibilityResponse, type FortemiCompatibilityState, type FortemiCompatibilityValidationResult, type FortemiConfig, type FortemiCore, type FortemiInferenceRouter, type FortemiRequiredCompatibilityCapability, type FortemiSecretStore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type GraphCommunity, type GraphEdge, type GraphNode, GraphRepository, type IDisposable, IdbRecordStore, ImportOptions, ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, type JournalEntry, LOCAL_ENDPOINTS, type LegacyMigrationReport, type LinkRecord0, 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, MemoryRecordStore, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteOriginalRecord, type NoteProjectionResult, type NoteRecord0, type NoteRevisedCurrentRecord, type NoteRevision, type NoteSkosTag, type NoteSummary, type NoteTagRecord, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, type OpenShardOptions, type PGliteBackendOptions, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, type PGliteWorkerStorageBackendFactoryOptions, type PaginatedResult, type PersistenceMode, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type PrefetchOptions, type PrefetchResult, type PresenceTrackedRecord, type ProbeResult, type ProbeStatus, type ProvenanceEdge, ProvenanceRepository, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, type RecommendedTier, type RecordBackendManageNoteResult, type RecordBackendOptions, type RecordCollectionName, type RecordCollections, type RecordListOptions, type RecordMutation, type RecordProjectionResult, type RecordProvenanceInput, type RecordStore, type RecordStoreCapabilities, type RemoteBackendConfig, type RemoteBackendPaths, type ResolvedEmbeddingRow, type ResolvedEmbeddingSet, type RestoreDbSnapshotOptions, type RouteHandler, SUPPORTED_PGLITE_VERSION, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, ShardBackend, type ShardBackendOptions, ShardCapabilityReport, ShardCollection, ShardComponent, type ShardComponentStore, ShardEmbedding, ShardEmbeddingConfig, ShardEmbeddingSet, ShardEmbeddingSetMember, ShardExportResult, ShardLink, type ShardListOptions, ShardLossEntry, ShardManifest, ShardNote, type ShardNoteFull, ShardNoteSkosTag, ShardOperation, ShardProfileRegistryEntry, ShardProvenanceEdge, type ShardReader, type ShardReaderNote, type ShardReaderSource, type ShardSchemaValidationResult, type ShardSearchOptions, type ShardSearchRankedNote, type ShardSearchResult, type ShardSearchWeights, ShardSkosConcept, ShardSkosRelation, ShardSkosScheme, ShardTag, ShardTemplate, type SimilarityGraphCacheKey, type SimilarityGraphOptions, type SimilarityGraphRequest, type SimilarityGraphResult, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StaticSemanticProvider, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VectorEntry, type VirtualEmbeddingSetDefinition, type VirtualEmbeddingSetSource, type VirtualEmbeddingSetValidationError, type VirtualMaterializationPolicy, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, assertShardComponentRecord, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, computeBlobHash, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, importShardToRecords, isPluginScriptAllowed, isShardPrefetched, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, migrateLegacyBlobStore, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, urlLinkToShard, validateChecksums, validateCoreV1ShardArchive, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifySri };