@fortemi/core 2026.7.7 → 2026.7.9

package/dist/index.d.ts

@@ -458,6 +458,11 @@ interface BlobStore {
     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).
@@ -476,6 +481,7 @@ declare class MemoryBlobStore implements BlobStore {
     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>;
@@ -624,12 +630,55 @@ declare function signShard(input: SignShardInput): Promise<Uint8Array>;
  *
  * 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.0.0";
+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' | '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';
+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;
@@ -639,6 +688,12 @@ interface ShardAttachmentReference {
 }
 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`. */
@@ -669,9 +724,19 @@ interface ShardMigrationHistoryEntry {
     changes: string[];
 }
 /** Manifest included in every shard as manifest.json. */
+interface ShardProducer {
+    name: string;
+    version: string;
+    revision?: string;
+}
 interface ShardManifest {
     version: string;
-    matric_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[];
@@ -685,6 +750,11 @@ interface ShardManifest {
 }
 /** 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;
@@ -728,9 +798,10 @@ interface ImportOptions {
     /**
      * 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).
+     * 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;
     /**
@@ -783,6 +854,13 @@ interface ImportResult {
     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 {
@@ -802,7 +880,8 @@ interface ShardNote {
     tags: string[];
     created_at: string;
     updated_at: string;
-    deleted_at: string | null;
+    /** 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 {
@@ -811,6 +890,9 @@ interface ShardCollection {
     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. */
@@ -975,84 +1057,16 @@ interface ShardArtifactFreshness {
     };
 }
 
-/**
- * LinksRepository — bidirectional note link management.
- *
- * Responsibilities:
- * - Create typed links between notes with duplicate prevention
- * - Soft-delete links
- * - Query outbound, inbound, and backlinks for a note
- */
-
-interface LinkRow {
-    id: string;
-    source_note_id: string;
-    target_note_id: string;
-    link_type: string;
-    confidence: number | null;
-    created_at: Date;
-    updated_at: Date | null;
-    deleted_at: Date | null;
-}
-declare class LinksRepository {
-    private db;
-    constructor(db: DatabaseClient);
-    create(sourceNoteId: string, targetNoteId: string, linkType?: string): Promise<LinkRow>;
-    get(id: string): Promise<LinkRow>;
-    listForNote(noteId: string): Promise<{
-        outbound: LinkRow[];
-        inbound: LinkRow[];
-    }>;
-    getBacklinks(noteId: string): Promise<string[]>;
-    delete(id: string): Promise<void>;
-}
-
-/**
- * CollectionsRepository — folder/category management for notes.
- *
- * Responsibilities:
- * - Create, read, update, and soft-delete collections
- * - Prevent circular parent references
- * - Assign and unassign notes from collections
- * - Return flat list and shallow tree views
- */
-
-interface CollectionRow {
-    id: string;
-    name: string;
-    description: string | null;
-    parent_id: string | null;
-    position: number;
-    created_at: Date;
-    updated_at: Date;
-    deleted_at: Date | null;
-}
-interface CollectionCreateInput {
-    name: string;
-    description?: string;
-    parent_id?: string;
-}
-declare class CollectionsRepository {
-    private db;
-    constructor(db: DatabaseClient);
-    create(input: CollectionCreateInput): Promise<CollectionRow>;
-    get(id: string): Promise<CollectionRow>;
-    list(): Promise<CollectionRow[]>;
-    listTree(): Promise<Array<CollectionRow & {
-        children: CollectionRow[];
-    }>>;
-    update(id: string, fields: Partial<Pick<CollectionRow, 'name' | 'description' | 'parent_id' | 'position'>>): Promise<CollectionRow>;
-    delete(id: string): Promise<void>;
-    assignNote(collectionId: string, noteId: string): Promise<void>;
-    unassignNote(collectionId: string, noteId: string): Promise<void>;
-    getNotesInCollection(collectionId: string): Promise<string[]>;
-}
-
 /**
  * Field mapper — converts between browser schema and shard (server) schema.
  *
  * The browser uses different field names than the server shard format.
  * This module handles all rename transforms bidirectionally.
+ *
+ * @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
  */
 
 /** Browser-format note row from the export query (denormalized). */
@@ -1077,8 +1091,17 @@ interface BrowserNoteExport {
 declare function noteToShard(note: BrowserNoteExport): ShardNote;
 /** Convert a shard note back to browser-insertable format. */
 declare function noteFromShard(shard: ShardNote): BrowserNoteExport;
-/** Convert a browser link to shard format. */
-declare function linkToShard(link: LinkRow): ShardLink;
+/** Convert a browser link to shard format (accepts SQL rows or canonical ISO-string records). */
+declare function linkToShard(link: {
+    id: string;
+    source_note_id: string;
+    target_note_id: string;
+    link_type: string;
+    confidence: number | null;
+    created_at: Date | string;
+    updated_at?: Date | string | null;
+    deleted_at?: Date | string | null;
+}): ShardLink;
 /** Convert a browser URL-target link row to shard format. */
 declare function urlLinkToShard(link: {
     id: string;
@@ -1088,6 +1111,8 @@ declare function urlLinkToShard(link: {
     confidence: number | null;
     metadata_json?: Record<string, unknown> | string | null;
     created_at: Date | string;
+    updated_at?: Date | string | null;
+    deleted_at?: Date | string | null;
 }): ShardLink;
 /** Convert a shard link back to browser-insertable format. */
 declare function linkFromShard(shard: ShardLink): {
@@ -1098,10 +1123,20 @@ declare function linkFromShard(shard: ShardLink): {
     link_type: string;
     confidence: number | null;
     created_at: string;
+    updated_at: string | null;
+    deleted_at: string | null;
     metadata: Record<string, unknown> | null;
 };
-/** Convert a browser collection to shard format. */
-declare function collectionToShard(collection: CollectionRow, noteCount?: number): ShardCollection;
+/** Convert a browser collection to shard format (accepts SQL rows or canonical ISO-string records). */
+declare function collectionToShard(collection: {
+    id: string;
+    name: string;
+    description: string | null;
+    parent_id: string | null;
+    created_at: Date | string;
+    updated_at?: Date | string;
+    deleted_at?: Date | string | null;
+}, noteCount?: number): ShardCollection;
 /** Convert a shard collection back to browser-insertable format. */
 declare function collectionFromShard(shard: ShardCollection): {
     id: string;
@@ -1109,6 +1144,8 @@ declare function collectionFromShard(shard: ShardCollection): {
     description: string | null;
     parent_id: string | null;
     created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
 };
 /**
  * Convert SKOS concepts + note_tag associations into shard flat tag format.
@@ -2714,6 +2751,79 @@ declare class TagsRepository {
     }>>;
 }
 
+/**
+ * CollectionsRepository — folder/category management for notes.
+ *
+ * Responsibilities:
+ * - Create, read, update, and soft-delete collections
+ * - Prevent circular parent references
+ * - Assign and unassign notes from collections
+ * - Return flat list and shallow tree views
+ */
+
+interface CollectionRow {
+    id: string;
+    name: string;
+    description: string | null;
+    parent_id: string | null;
+    position: number;
+    created_at: Date;
+    updated_at: Date;
+    deleted_at: Date | null;
+}
+interface CollectionCreateInput {
+    name: string;
+    description?: string;
+    parent_id?: string;
+}
+declare class CollectionsRepository {
+    private db;
+    constructor(db: DatabaseClient);
+    create(input: CollectionCreateInput): Promise<CollectionRow>;
+    get(id: string): Promise<CollectionRow>;
+    list(): Promise<CollectionRow[]>;
+    listTree(): Promise<Array<CollectionRow & {
+        children: CollectionRow[];
+    }>>;
+    update(id: string, fields: Partial<Pick<CollectionRow, 'name' | 'description' | 'parent_id' | 'position'>>): Promise<CollectionRow>;
+    delete(id: string): Promise<void>;
+    assignNote(collectionId: string, noteId: string): Promise<void>;
+    unassignNote(collectionId: string, noteId: string): Promise<void>;
+    getNotesInCollection(collectionId: string): Promise<string[]>;
+}
+
+/**
+ * LinksRepository — bidirectional note link management.
+ *
+ * Responsibilities:
+ * - Create typed links between notes with duplicate prevention
+ * - Soft-delete links
+ * - Query outbound, inbound, and backlinks for a note
+ */
+
+interface LinkRow {
+    id: string;
+    source_note_id: string;
+    target_note_id: string;
+    link_type: string;
+    confidence: number | null;
+    created_at: Date;
+    updated_at: Date | null;
+    deleted_at: Date | null;
+}
+declare class LinksRepository {
+    private db;
+    constructor(db: DatabaseClient);
+    create(sourceNoteId: string, targetNoteId: string, linkType?: string): Promise<LinkRow>;
+    get(id: string): Promise<LinkRow>;
+    listForNote(noteId: string): Promise<{
+        outbound: LinkRow[];
+        inbound: LinkRow[];
+    }>;
+    getBacklinks(noteId: string): Promise<string[]>;
+    delete(id: string): Promise<void>;
+}
+
 /**
  * SkosRepository — SKOS taxonomy management (schemes, concepts, relations).
  *
@@ -4091,6 +4201,28 @@ declare function appendPluginScript(descriptor: PluginScriptDescriptor, policy:
 declare function parseCspReport(body: unknown): CspViolationReport;
 declare function createCspReportHandler(onReport: (report: CspViolationReport) => void | Promise<void>): (request: Request) => Promise<Response>;
 
+/**
+ * Knowledge Shard portability profiles derived from the pinned Fortemi receipt.
+ *
+ * @implements @.aiwg/adrs/ADR-011-shard-server-conformance-and-version-negotiation.md
+ * @schema @packages/core/schemas/knowledge-shard/upstream-contract.json
+ * @created 2026-07-17
+ * @agent Codex
+ */
+
+declare const CORE_V1_COMPONENTS: readonly ["notes", "collections", "tags", "templates", "links"];
+declare function getKnowledgeShardProfileRegistry(): ShardProfileRegistryEntry[];
+interface CreateShardCapabilityReportInput {
+    backend: ShardBackend;
+    operation: ShardOperation;
+    requestedProfile: string | null;
+    declaredComponents?: readonly ShardComponent[];
+    omittedComponents?: readonly ShardComponent[];
+    losses?: readonly ShardLossEntry[];
+}
+declare function createShardCapabilityReport(input: CreateShardCapabilityReportInput): ShardCapabilityReport;
+declare function profileSupportError(report: ShardCapabilityReport): string | null;
+
 /**
  * Minimal tar + gzip packing/unpacking for shard archives.
  *
@@ -4161,8 +4293,17 @@ declare function validateChecksums(checksums: Record<string, string>, files: Map
  * Shard export pipeline — query all entities, serialize, pack into .shard archive.
  *
  * Pipeline: query DB → field-map → serialize (JSONL/JSON) → compute checksums → build manifest → tar.gz
+ *
+ * @implements @.aiwg/adrs/ADR-011-shard-server-conformance-and-version-negotiation.md
+ * @depends @packages/core/src/shard/profile-registry.ts
+ * @schema @packages/core/schemas/knowledge-shard.schema.receipt.json
+ * @created 2026-07-17
+ * @agent Codex
  */
 
+declare function exportShardWithReport(db: DatabaseClient, options: ExportOptions & {
+    profile: string;
+}): Promise<ShardExportResult>;
 /**
  * Export knowledge data from the database as a .shard archive (Uint8Array).
  *
@@ -4177,6 +4318,11 @@ declare function exportShard(db: DatabaseClient, options?: ExportOptions): Promi
  *
  * Pipeline: ArrayBuffer → gunzip → untar → parse manifest → validate checksums →
  *           parse components → field-map → BEGIN transaction → INSERT all → COMMIT
+ *
+ * @implements @.aiwg/adrs/ADR-011-shard-server-conformance-and-version-negotiation.md
+ * @depends @packages/core/src/shard/schema-validator.ts
+ * @created 2026-07-17
+ * @agent Codex
  */
 
 /**
@@ -4197,11 +4343,16 @@ interface ShardSchemaValidationResult {
     errors: string[];
 }
 type ShardFiles = Map<string, Uint8Array>;
+type CoreV1SchemaVersion = '1.0.0' | '1.1.0' | '1.2.0';
 declare function getKnowledgeShardSchema(): unknown;
+declare function getKnowledgeShardContractReceipt(): unknown;
 declare function validateShardManifest(value: unknown): ShardSchemaValidationResult;
 declare function validateShardArchive(input: Uint8Array | ArrayBuffer | ShardFiles): ShardSchemaValidationResult;
-declare function validateShardComponentRecord(component: ShardComponent | 'templates', value: unknown): ShardSchemaValidationResult;
-declare function assertShardComponentRecord(component: ShardComponent | 'templates', value: unknown): void;
+declare function validateCoreV1ShardArchive(input: Uint8Array | ArrayBuffer | ShardFiles): Promise<ShardSchemaValidationResult>;
+declare function validateRecordV1ShardArchive(input: Uint8Array | ArrayBuffer | ShardFiles): Promise<ShardSchemaValidationResult>;
+declare function validateFullV1ShardArchive(input: Uint8Array | ArrayBuffer | ShardFiles): Promise<ShardSchemaValidationResult>;
+declare function validateShardComponentRecord(component: ShardComponent | 'templates', value: unknown, profile?: 'core-v1' | 'record-v1' | 'full-v1', version?: CoreV1SchemaVersion): ShardSchemaValidationResult;
+declare function assertShardComponentRecord(component: ShardComponent | 'templates', value: unknown, profile?: 'core-v1' | 'record-v1' | 'full-v1', version?: CoreV1SchemaVersion): void;
 
 /**
  * Pluggable semantic providers for the in-place shard reader (issue #189).
@@ -4549,9 +4700,8 @@ interface AiwgKnowledgeShardOptions {
     createdAt?: string;
     matricVersion?: string;
     /**
-     * Include React-native SKOS and provenance component files. The default
-     * portable profile keeps those projections in lossless note metadata so the
-     * shard remains importable by the current Fortemi server.
+     * 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;
 }
@@ -4891,7 +5041,7 @@ interface NoteOriginalRecord {
 interface NoteRevisedCurrentRecord {
     /** Keyed by note id (mirrors the SQL PK `note_id`). */
     id: string;
-    content: string;
+    content: string | null;
     ai_metadata: unknown | null;
     generation_count: number;
     model: string | null;
@@ -4983,6 +5133,8 @@ interface JournalEntry {
 interface RecordStoreCapabilities {
     crud: true;
     journal: true;
+    /** Multi-collection record and journal mutations commit atomically. */
+    atomicBatch?: true;
     /** Bounded substring scan over titles/content — not ranked FTS. */
     boundedTextScan: true;
     fullTextSearch: false;
@@ -4994,6 +5146,17 @@ interface RecordListOptions {
     /** Maximum records returned (applied after filtering). */
     limit?: number;
 }
+type RecordMutation = {
+    [C in RecordCollectionName]: {
+        op: 'put';
+        collection: C;
+        record: RecordCollections[C];
+    };
+}[RecordCollectionName] | {
+    op: 'delete';
+    collection: RecordCollectionName;
+    id: string;
+};
 /**
  * The writable canonical structured-record store. Implementations MUST make
  * each `put`/`remove` an atomic commit of the record mutation plus its
@@ -5006,6 +5169,11 @@ interface RecordStore {
     put<C extends RecordCollectionName>(collection: C, record: RecordCollections[C]): Promise<JournalEntry>;
     /** Hard-remove one record, journaled atomically (soft-delete is a field upstream). */
     remove(collection: RecordCollectionName, id: string): Promise<JournalEntry>;
+    /**
+     * Commit all record mutations and their journal entries as one transaction.
+     * An error leaves both record state and the journal unchanged.
+     */
+    applyBatch?(mutations: readonly RecordMutation[]): Promise<JournalEntry[]>;
     /** All records of a collection (insertion order not guaranteed). */
     list<C extends RecordCollectionName>(collection: C, opts?: RecordListOptions): Promise<RecordCollections[C][]>;
     /** Journal entries with `seq > sinceSeq`, ascending. */
@@ -5030,6 +5198,7 @@ declare class MemoryRecordStore implements RecordStore {
     get<C extends RecordCollectionName>(collection: C, id: string): Promise<RecordCollections[C] | null>;
     put<C extends RecordCollectionName>(collection: C, record: RecordCollections[C]): Promise<JournalEntry>;
     remove(collection: RecordCollectionName, id: string): Promise<JournalEntry>;
+    applyBatch(mutations: readonly RecordMutation[]): Promise<JournalEntry[]>;
     list<C extends RecordCollectionName>(collection: C, opts?: RecordListOptions): Promise<RecordCollections[C][]>;
     journalSince(sinceSeq: number, limit?: number): Promise<JournalEntry[]>;
     headSeq(): Promise<number>;
@@ -5069,6 +5238,7 @@ declare class IdbRecordStore implements RecordStore {
     get<C extends RecordCollectionName>(collection: C, id: string): Promise<RecordCollections[C] | null>;
     put<C extends RecordCollectionName>(collection: C, record: RecordCollections[C]): Promise<JournalEntry>;
     remove(collection: RecordCollectionName, id: string): Promise<JournalEntry>;
+    applyBatch(mutations: readonly RecordMutation[]): Promise<JournalEntry[]>;
     list<C extends RecordCollectionName>(collection: C, opts?: RecordListOptions): Promise<RecordCollections[C][]>;
     journalSince(sinceSeq: number, limit?: number): Promise<JournalEntry[]>;
     headSeq(): Promise<number>;
@@ -5099,6 +5269,8 @@ interface CanonicalNoteCreateInput {
 interface CanonicalNoteUpdateInput {
     title?: string;
     content?: string;
+    format?: string;
+    visibility?: string;
     is_starred?: boolean;
     is_pinned?: boolean;
     is_archived?: boolean;
@@ -5214,6 +5386,140 @@ declare function projectAttachments(db: DatabaseClient, store: RecordStore): Pro
  */
 declare function dropAttachmentProjection(db: DatabaseClient): Promise<void>;
 
-declare const VERSION = "2026.7.7";
+/**
+ * PGlite record projection — notes tier (#323 cycle 2, ADR-013 D3).
+ *
+ * Projects canonical note / tag / link / collection state (RecordStore) into
+ * the optional PGlite tables, completing the projection the attachment tier
+ * (#320, attachment-projection.ts) deferred to this cycle. Properties:
+ *
+ * - Idempotent: rows upsert on their primary keys; re-running with the same
+ *   canonical state changes nothing.
+ * - Rebuildable: dropping the projection rows and re-projecting yields
+ *   equivalent query results — canonical records are the source of truth.
+ * - Reconciling: canonically hard-removed rows (note_tag, collection_note)
+ *   are deleted from the projection so parity holds after removals, not just
+ *   after inserts.
+ * - Bytes never enter PGlite; `projectRecords` composes this pass with the
+ *   attachment projection for a full canonical → PGlite rebuild.
+ */
+
+interface NoteProjectionResult {
+    notes: number;
+    tags: number;
+    links: number;
+    collections: number;
+    memberships: number;
+}
+interface RecordProjectionResult extends NoteProjectionResult {
+    attachments: AttachmentProjectionResult;
+}
+/**
+ * Project all canonical note-tier records into PGlite. Safe to run at any
+ * time: startup, after journal consumption, or as a full rebuild after the
+ * projection was dropped. Parent rows land before children (note before
+ * note_original / tags / links / memberships) so FKs hold.
+ */
+declare function projectNotes(db: DatabaseClient, store: RecordStore): Promise<NoteProjectionResult>;
+/**
+ * Full canonical → PGlite projection: note tier, then attachment tier
+ * (parents before children). This is the "PGlite is a derived, rebuildable
+ * projection" invariant (#322 acceptance) made executable.
+ */
+declare function projectRecords(db: DatabaseClient, store: RecordStore): Promise<RecordProjectionResult>;
+/**
+ * Drop the note-tier projection rows (test/rebuild support). Canonical
+ * records are untouched. Callers must drop dependent projections first
+ * (attachments via `dropAttachmentProjection`, plus any embedding/SKOS rows
+ * created outside the canonical tier) so FKs allow the deletes.
+ */
+declare function dropNoteProjection(db: DatabaseClient): Promise<void>;
+
+/**
+ * Writable non-PGlite `DataBackend` over the canonical RecordStore
+ * (#323 cycle 2, ADR-013 D3) — the record tier in the backend seam.
+ *
+ * Fills the seam's historical gap: the static shard backend is read-only and
+ * the PGlite backend needs a database. This adapter serves the canonical
+ * repositories' full write surface plus the bounded read tier (id / recent /
+ * tag / link lookups and a bounded substring scan) with instant startup.
+ *
+ * Capability boundary, reported honestly: `semantic: 'none'` (no vectors) and
+ * search is a bounded scan, not ranked FTS. SKOS concepts and provenance
+ * edges are not part of the canonical record collections, so `conceptsOf` /
+ * `provenanceOf` are deliberately absent — callers feature-detect via the
+ * optional methods rather than receiving silently empty emulations.
+ * `merge: true` is served by `importShardToRecords` (record-shard.ts).
+ */
+
+interface RecordBackendOptions {
+    id?: string;
+}
+interface RecordBackendManageNoteResult {
+    action: string;
+    note_id: string;
+    note?: CanonicalNoteView;
+}
+/**
+ * Wrap a canonical `RecordStore` as a writable `DataBackend`. Reads and
+ * writes delegate to `CanonicalNotesRepository`; `manageNote` accepts the
+ * same Zod-validated input as the PGlite tool (update / delete / restore /
+ * archive / unarchive / star / unstar).
+ */
+declare function createRecordBackend(store: RecordStore, options?: RecordBackendOptions): DataBackend;
+
+/**
+ * DB-free Knowledge Shard export/import over the canonical RecordStore
+ * (#323 cycle 2, ADR-013 D3/D6) — the same `.shard` archive format as the
+ * PGlite pipeline (`shard/shard-export.ts` / `shard/shard-import.ts`), built
+ * from and applied to canonical records with zero PGlite.
+ *
+ * Capability boundary (reported, never emulated): the canonical tier holds
+ * notes, tags, note-to-note links, collections, and attachment manifests.
+ * Shard components outside that set (templates, embeddings, SKOS, provenance,
+ * graph/community artifacts, URL links) are skipped on import with explicit
+ * warnings, and are never emitted on export.
+ *
+ * Atomicity: manifest, version, signature (ADR-014 verify-before-persist),
+ * and checksum validation all run before mutation. Verified sidecar bytes are
+ * promoted with rollback, then every record and journal mutation commits in
+ * one multi-collection RecordStore batch.
+ *
+ * @implements @.aiwg/adrs/ADR-011-shard-server-conformance-and-version-negotiation.md
+ * @depends @packages/core/src/shard/schema-validator.ts
+ * @created 2026-07-17
+ * @agent Codex
+ */
+
+declare function exportShardFromRecordsWithReport(store: RecordStore, options: ExportOptions & {
+    profile: string;
+}): Promise<ShardExportResult>;
+/**
+ * Export canonical records as a `.shard` archive (Uint8Array), format-parity
+ * with the PGlite `exportShard`. Honored options: `collectionId` / `tag`
+ * filters, `clusterNotesSize`, and the portable byte sidecar
+ * (`includeBlobs` + `blobStore`). Embedding options are inert — the canonical
+ * tier stores no embeddings, so there is nothing to include.
+ */
+declare function exportShardFromRecords(store: RecordStore, options?: ExportOptions): Promise<Uint8Array>;
+/**
+ * Import a `.shard` archive into the canonical RecordStore (and optionally
+ * hydrate attachment bytes into a Bytecask BlobStore) with zero PGlite.
+ *
+ * Honors `conflictStrategy` (`skip` default / `replace` / `error` — `error`
+ * conflicts are pre-scanned so nothing is written), the ADR-014
+ * `verifySignature`/`trustStore` policy, and byte-sidecar hydration via
+ * `blobStore`. Components the canonical tier cannot persist are skipped with
+ * explicit warnings and reported under `skipped`.
+ */
+declare function importShardToRecords(store: RecordStore, data: Uint8Array | ArrayBuffer, options?: ImportOptions): Promise<ImportResult>;
+
+/**
+ * @implements @.aiwg/adrs/ADR-011-shard-server-conformance-and-version-negotiation.md
+ * @source @packages/core/src/shard/schema-validator.ts
+ * @created 2026-07-17
+ * @agent Codex
+ */
+declare const VERSION = "2026.7.9";
 
-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, 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, 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 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 RecordCollectionName, type RecordCollections, type RecordListOptions, 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 ShardBackendOptions, type ShardClusterRef, type ShardCollection, type ShardComponent, type ShardComponentStore, type ShardEmbedding, type ShardEmbeddingConfig, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLayout, type ShardLink, type ShardListOptions, type ShardManifest, type ShardNote, type ShardNoteFull, type ShardNoteSkosTag, 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, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dropAttachmentProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, migrateLegacyBlobStore, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, projectAttachments, 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, validateFortemiCompatibilityResponse, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
+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 };