@fortemi/core 2026.7.10 → 2026.7.11

package/dist/index.d.ts

@@ -5066,6 +5066,8 @@ interface CollectionRecord {
     id: string;
     name: string;
     description: string | null;
+    /** Omitted only by legacy schema-v1 callers; built-in stores normalize it to null. */
+    parent_id?: string | null;
     created_at: string;
     updated_at: string;
     deleted_at: string | null;
@@ -5224,7 +5226,7 @@ declare class MemoryRecordStore implements RecordStore {
  */
 
 /** Logical record-schema version stored in `meta` (independent of DB_VERSION). */
-declare const RECORD_SCHEMA_VERSION = 1;
+declare const RECORD_SCHEMA_VERSION = 2;
 interface CreateRecordStoreOptions {
     /** Injectable factory for tests (fake-indexeddb). Defaults to the global. */
     indexedDB?: IDBFactory;
@@ -5304,7 +5306,7 @@ declare class CanonicalNotesRepository {
     softDeleteLink(linkId: string): Promise<void>;
     /** Active links touching a note (either direction). */
     linksOf(noteId: string): Promise<LinkRecord0[]>;
-    createCollection(name: string, description?: string): Promise<CollectionRecord>;
+    createCollection(name: string, description?: string, parentId?: string | null): Promise<CollectionRecord>;
     addNoteToCollection(collectionId: string, noteId: string): Promise<void>;
     notesInCollection(collectionId: string): Promise<NoteRecord0[]>;
 }
@@ -5520,6 +5522,6 @@ declare function importShardToRecords(store: RecordStore, data: Uint8Array | Arr
  * @created 2026-07-17
  * @agent Codex
  */
-declare const VERSION = "2026.7.10";
+declare const VERSION = "2026.7.11";
 
 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 };

package/dist/index.js

@@ -7664,7 +7664,7 @@ function createTarHeader(filename, size) {
   writeOctal(header, 108, 0, 8);
   writeOctal(header, 116, 0, 8);
   writeOctal(header, 124, size, 12);
-  writeOctal(header, 136, Math.floor(Date.now() / 1e3), 12);
+  writeOctal(header, 136, 0, 12);
   header[156] = 48;
   writeString(header, 257, USTAR_MAGIC, 8);
   const checksum = computeHeaderChecksum(header);
@@ -7736,7 +7736,7 @@ function packTarGz(files, opts) {
       "Refusing to create archive: uncompressed size " + tarData.byteLength + " exceeds cap " + cap + " bytes"
     );
   }
-  return gzipSync(tarData);
+  return gzipSync(tarData, { mtime: 0 });
 }
 var DEFAULT_MAX_DECOMPRESSED_BYTES = 256 * 1024 * 1024;
 function unpackTarGz(data, opts) {
@@ -14516,6 +14516,22 @@ function coreReferenceErrors(records) {
       errors.push(`collections.json[${index}] parent_id does not reference a declared collection`);
     }
   }
+  const collectionById = new Map(collections.map((collection) => [collection.id, collection]));
+  const visiting = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const visitCollection = (collection) => {
+    if (visited.has(collection.id)) return;
+    if (visiting.has(collection.id)) {
+      errors.push(`collection hierarchy contains a cycle at ${String(collection.id)}`);
+      return;
+    }
+    visiting.add(collection.id);
+    const parent = collection.parent_id === null ? void 0 : collectionById.get(collection.parent_id);
+    if (parent) visitCollection(parent);
+    visiting.delete(collection.id);
+    visited.add(collection.id);
+  };
+  for (const collection of collections) visitCollection(collection);
   for (const [index, note] of notes.entries()) {
     if (note.collection_id !== null && !collectionIds.has(note.collection_id)) {
       errors.push(`notes.jsonl[${index}] collection_id does not reference a declared collection`);
@@ -20200,6 +20216,18 @@ var RECORD_STORE_CAPABILITIES = {
   vectorSearch: false,
   sqlJoins: false
 };
+function normalizeRecordMutation(mutation) {
+  if (mutation.op === "put" && mutation.collection === "collection") {
+    return {
+      ...mutation,
+      record: {
+        ...mutation.record,
+        parent_id: mutation.record.parent_id ?? null
+      }
+    };
+  }
+  return mutation;
+}
 
 // src/records/memory-record-store.ts
 var MemoryRecordStore = class {
@@ -20245,7 +20273,8 @@ var MemoryRecordStore = class {
       }
       return records;
     };
-    for (const mutation of mutations) {
+    for (const rawMutation of mutations) {
+      const mutation = normalizeRecordMutation(rawMutation);
       const entry = mutation.op === "put" ? {
         seq: ++stagedSeq,
         ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -20292,7 +20321,7 @@ var MemoryRecordStore = class {
 var DB_VERSION = 1;
 var JOURNAL_STORE = "journal";
 var META_STORE = "meta";
-var RECORD_SCHEMA_VERSION = 1;
+var RECORD_SCHEMA_VERSION = 2;
 function requestToPromise(request) {
   return new Promise((resolve, reject) => {
     request.onsuccess = () => resolve(request.result);
@@ -20340,16 +20369,25 @@ var IdbRecordStore = class _IdbRecordStore {
     return store;
   }
   async ensureSchemaVersion() {
-    const tx = this.db.transaction(META_STORE, "readwrite");
+    const tx = this.db.transaction([META_STORE, "collection"], "readwrite");
     const meta = tx.objectStore(META_STORE);
     const current = await requestToPromise(meta.get("schemaVersion"));
-    if (current === void 0) {
-      meta.put(RECORD_SCHEMA_VERSION, "schemaVersion");
-    } else if (current > RECORD_SCHEMA_VERSION) {
+    if (current !== void 0 && current > RECORD_SCHEMA_VERSION) {
       throw new Error(
         `IdbRecordStore: records were written by a newer schema (v${current} > v${RECORD_SCHEMA_VERSION}); refusing to open`
       );
     }
+    if ((current ?? 0) < 2) {
+      const collections = await requestToPromise(
+        tx.objectStore("collection").getAll()
+      );
+      for (const collection of collections) {
+        if (!Object.hasOwn(collection, "parent_id")) {
+          tx.objectStore("collection").put({ ...collection, parent_id: null });
+        }
+      }
+    }
+    meta.put(RECORD_SCHEMA_VERSION, "schemaVersion");
     await transactionComplete(tx);
   }
   async get(collection, id) {
@@ -20368,12 +20406,13 @@ var IdbRecordStore = class _IdbRecordStore {
   }
   async applyBatch(mutations) {
     if (mutations.length === 0) return [];
-    const collections = [...new Set(mutations.map((mutation) => mutation.collection))];
+    const normalizedMutations = mutations.map(normalizeRecordMutation);
+    const collections = [...new Set(normalizedMutations.map((mutation) => mutation.collection))];
     const tx = this.db.transaction([...collections, JOURNAL_STORE], "readwrite");
     const completed = transactionComplete(tx);
     const pendingEntries = [];
     try {
-      for (const mutation of mutations) {
+      for (const mutation of normalizedMutations) {
         const records = tx.objectStore(mutation.collection);
         const pending = mutation.op === "put" ? {
           ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -20620,12 +20659,16 @@ ${revised.get(note.id) ?? ""}`.toLowerCase();
     );
   }
   // ── Collections ───────────────────────────────────────────────────────────
-  async createCollection(name, description) {
+  async createCollection(name, description, parentId = null) {
+    if (parentId !== null && !await this.store.get("collection", parentId)) {
+      throw new Error(`Parent collection not found: ${parentId}`);
+    }
     const ts = nowIso();
     const collection = {
       id: generateId(),
       name,
       description: description ?? null,
+      parent_id: parentId,
       created_at: ts,
       updated_at: ts,
       deleted_at: null
@@ -20808,6 +20851,32 @@ async function dropAttachmentProjection(db) {
 }
 
 // src/records/record-projection.ts
+function collectionsParentFirst(collections) {
+  const byId = new Map(collections.map((collection) => [collection.id, collection]));
+  const ordered = [];
+  const visiting = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const visit = (collection) => {
+    if (visited.has(collection.id)) return;
+    if (visiting.has(collection.id)) {
+      throw new Error(`Collection hierarchy contains a cycle at ${collection.id}`);
+    }
+    visiting.add(collection.id);
+    const parentId = collection.parent_id ?? null;
+    if (parentId !== null) {
+      const parent = byId.get(parentId);
+      if (!parent) {
+        throw new Error(`Collection ${collection.id} references missing parent ${parentId}`);
+      }
+      visit(parent);
+    }
+    visiting.delete(collection.id);
+    visited.add(collection.id);
+    ordered.push(collection);
+  };
+  for (const collection of collections) visit(collection);
+  return ordered;
+}
 async function projectNotes(db, store) {
   const [noteRows, originals, revised, tags, links, collections, memberships] = await Promise.all([
     store.list("note"),
@@ -20818,16 +20887,25 @@ async function projectNotes(db, store) {
     store.list("collection"),
     store.list("collection_note")
   ]);
-  for (const c of collections) {
+  for (const c of collectionsParentFirst(collections)) {
     await db.query(
-      `INSERT INTO collection (id, name, description, created_at, updated_at, deleted_at)
-       VALUES ($1, $2, $3, $4, $5, $6)
+      `INSERT INTO collection (id, name, description, parent_id, created_at, updated_at, deleted_at)
+       VALUES ($1, $2, $3, $4, $5, $6, $7)
        ON CONFLICT (id) DO UPDATE SET
          name = EXCLUDED.name,
          description = EXCLUDED.description,
+         parent_id = EXCLUDED.parent_id,
          updated_at = EXCLUDED.updated_at,
          deleted_at = EXCLUDED.deleted_at`,
-      [c.id, c.name, c.description, c.created_at, c.updated_at, c.deleted_at]
+      [
+        c.id,
+        c.name,
+        c.description,
+        c.parent_id ?? null,
+        c.created_at,
+        c.updated_at,
+        c.deleted_at
+      ]
     );
   }
   for (const n of noteRows) {
@@ -21325,12 +21403,11 @@ async function buildRecordShardArchive(store, options, profile) {
   const orderedCollections = collections.sort((a, b) => a.name.localeCompare(b.name));
   const shardCollections = orderedCollections.map((c) => {
     const mapped = collectionToShard(
-      // Canonical collections are flat (no parent hierarchy yet).
       {
         id: c.id,
         name: c.name,
         description: c.description,
-        parent_id: null,
+        parent_id: c.parent_id ?? null,
         created_at: c.created_at,
         updated_at: c.updated_at,
         deleted_at: c.deleted_at
@@ -21764,6 +21841,7 @@ async function importShardToRecords(store, data, options) {
       id: col.id,
       name: col.name,
       description: col.description,
+      parent_id: col.parent_id,
       created_at: col.created_at,
       updated_at: col.updated_at,
       deleted_at: col.deleted_at
@@ -22038,7 +22116,7 @@ async function importShardToRecords(store, data, options) {
 }
 
 // src/index.ts
-var VERSION = "2026.7.10";
+var VERSION = "2026.7.11";
 
 export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DB_SNAPSHOT_SCHEMA_VERSION, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LOCAL_ENDPOINTS, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, TagsRepository, TransactionProxy, TypedEventBus, VERSION, 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, getAiwgFortemiIndexExportSchema, 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, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
 //# sourceMappingURL=index.js.map