@fortemi/core 2026.7.14 → 2026.8.0

package/README.md

@@ -39,7 +39,8 @@ Most browser note and knowledge apps choose between a thin IndexedDB wrapper, a
 | Queryable knowledge | SQL-backed repositories for notes, links, tags, collections, SKOS concepts, jobs, and search |
 | Retrieval quality | Full-text search, pgvector-backed semantic search, hybrid ranking, snippets, facets, and filters |
 | AI-ready workflows | Optional embeddings, local LLM capability discovery, job provenance, and fallback routing |
-| Portable archives | Knowledge Shard tar.gz import/export with set-scoped exports, chunked imports, checksums, BLAKE3-addressed blob sidecars, and profile-scoped conformance |
+| Portable archives | Knowledge Shard tar.gz import/export with set-scoped exports, chunked imports, checksums, BLAKE3-addressed blob sidecars, profile-scoped conformance, and typed loss reports for omitted source identities |
+| Source-addressed ingest | Atomic batch upsert keyed by tenant, archive, namespace, and external id, with replay-safe outcomes for PGlite and RecordStore |
 | Agent integration | Manifest-backed tools and direct helper functions for bridge adapters and automation |
 | UI freedom | A headless package you can use from React, another framework, a browser extension, or a custom host |
 
@@ -177,6 +178,27 @@ receipt disables the claim, while the verifier requires the packaged receipt
 bytes to match their declared digests. RecordStore remains `record-v1` only.
 This receipt does not establish suite-wide portability or complete backup.
 
+### Supported-platform conformance
+
+The authority-owned suite matrix treats Fortemi as the schema/API/runtime
+authority, `@fortemi/core` as the reusable conformance consumer, and HotM as an
+application consumer. [Fortemi run
+6393](https://git.integrolabs.net/Fortemi/fortemi/actions/runs/6393) passed the
+same receipt-bound contract on Linux x86_64, Linux arm64, and macOS arm64. Its
+React/Core participant is commit
+`ccf96fad6025025293e40e250c85f088c8999d86`,
+`@fortemi/core@2026.7.14`, with tgz SHA-256
+`e282f504a842261c3f598a7f2ee0d6a85e03dc213ddf545a18daf5f603a742cc`
+and tar payload SHA-256
+`47482320b543307c2d44f3a87a2268ead6faf265c6bd38cf33011e0ac7f8e77a`.
+
+The supported claim is limited to the declared contract surface and exact
+Knowledge Shard `2.0.0/full-v1` tuple on those platform cells. Windows remains
+deferred to [Fortemi
+#1096](https://git.integrolabs.net/Fortemi/fortemi/issues/1096). This does not
+change the Fortemi #1081 `NO-GO` audit or prove complete backup, universal
+portability, launched GUI/native-dialog behavior, or RecordStore `full-v1`.
+
 Knowledge Shard 2.0 treats absent, `null`, empty, and non-empty values as
 distinct authority states. PGlite persists `core-v1` field presence in a
 transactional sidecar, while RecordStore carries its `record-v1` projection and
@@ -331,6 +353,7 @@ bytes.
 | Capability system | Embeddings, local LLM, GPU detection, local-provider discovery, fallback routing |
 | Job queue | Server-compatible background workflow for revisions, titles, embeddings, concepts, and links |
 | Knowledge Shards | Tar.gz import/export with checksums, BLAKE3-addressed blob sidecars, progress callbacks, yielding imports, set-scoped embedding exports, and profile-scoped conformance |
+| Lifecycle controls | Source-addressed import, metadata-scoped search locators, and terminal purge receipts that omit raw external ids and content |
 | Service-worker helpers | Route registration primitives for standalone browser integration |
 
 ## Search and Knowledge Model

package/dist/aiwg-index-schema.d.ts

@@ -5,5 +5,4 @@ interface AiwgIndexSchemaValidationResult {
 declare function getAiwgFortemiIndexExportSchema(): unknown;
 declare function validateAiwgFortemiIndexExportSchema(value: unknown): AiwgIndexSchemaValidationResult;
 declare function validateAiwgFortemiProjectedRecordSchema(value: unknown): AiwgIndexSchemaValidationResult;
-
 export { type AiwgIndexSchemaValidationResult, getAiwgFortemiIndexExportSchema, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema };

package/dist/aiwg-index.d.ts

@@ -1,12 +1,12 @@
 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';
-type AiwgOperationalStateClassification = 'fresh' | 'historical' | 'superseded' | 'contradicted' | 'needs-source';
-type AiwgOperationalStateConfidence = 'source' | 'candidate' | 'reviewed' | 'rejected';
+type AiwgPrivacyClassification = 'private' | 'public' | 'sanitized';
+type AiwgProvenanceConfidence = 'candidate' | 'rejected' | 'reviewed' | 'source';
+type AiwgReviewAction = 'accept' | 'defer' | 'reject';
+type AiwgFortemiRelationshipDirection = 'downstream' | 'related' | 'upstream';
+type AiwgOperationalStateClassification = 'contradicted' | 'fresh' | 'historical' | 'needs-source' | 'superseded';
+type AiwgOperationalStateConfidence = 'candidate' | 'rejected' | 'reviewed' | 'source';
 interface AiwgFortemiRecordSource {
     path: string;
     repo_relative_path: string;
@@ -98,16 +98,16 @@ interface AiwgFortemiRecordEmbedding {
 interface AiwgFortemiAttachmentReference {
     id: string;
     path: string;
-    mime: string | null;
+    mime: null | string;
     checksum: string;
     bytes: number;
 }
 interface AiwgFortemiBinarySource {
-    extracted_text: string | null;
+    extracted_text: null | string;
     created_at?: string;
-    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';
+    deleted_at?: null | string;
+    extraction_status?: 'blocked' | 'deferred' | 'extracted' | 'failed' | 'pending';
+    reason?: 'extraction_pending' | 'extractor_failed' | 'large_binary' | 'no_extracted_text' | 'quarantined' | 'unsupported_mime' | null;
     attachment: AiwgFortemiAttachmentReference;
 }
 interface AiwgOperationalState {
@@ -128,7 +128,7 @@ interface AiwgOperationalState {
     current_action_selector?: boolean;
 }
 interface AiwgStateTransfer {
-    deleted_at: string | null;
+    deleted_at: null | string;
 }
 interface AiwgFortemiRecord {
     schema_version: AiwgFortemiRecordSchemaVersion;
@@ -159,8 +159,8 @@ interface AiwgFortemiRecord {
     state_transfer?: AiwgStateTransfer;
     privacy: {
         classification: AiwgPrivacyClassification;
-        pii: boolean;
         locality?: string;
+        pii: boolean;
     };
     updated_at: string;
 }
@@ -168,9 +168,9 @@ interface AiwgFortemiIndexExport {
     schema_version: AiwgFortemiIndexExportSchemaVersion;
     generated_at: string;
     source: {
-        repo: string;
-        privacy: AiwgPrivacyClassification;
         graph?: string;
+        privacy: AiwgPrivacyClassification;
+        repo: string;
     };
     items: AiwgFortemiRecord[];
     compatibility?: {
@@ -184,8 +184,8 @@ interface AiwgFortemiChunkPartRef {
     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';
+type AiwgFortemiProjectedRecord = Pick<AiwgFortemiRecord, 'concepts' | 'facets' | 'id' | 'privacy' | 'schema_version' | 'tags' | 'text' | 'title' | 'type'> & Partial<AiwgFortemiRecord>;
+type AiwgDetailIdEncoding = 'base64url' | 'uri';
 interface AiwgFortemiChunkDetailRef {
     href: string;
     encoding?: AiwgDetailIdEncoding;
@@ -231,7 +231,7 @@ interface AiwgIndexQueryOptions {
     snippetLength?: number;
     weights?: Partial<AiwgIndexQueryWeights>;
     includeMatches?: boolean;
-    searchProfile?: 'default' | 'aiwg-discovery';
+    searchProfile?: 'aiwg-discovery' | 'default';
 }
 interface AiwgIndexQueryWeights {
     title: number;
@@ -243,7 +243,7 @@ interface AiwgIndexQueryWeights {
     source: number;
 }
 interface AiwgIndexQueryMatch {
-    field: 'title' | 'text' | 'tag' | 'concept' | 'facet' | 'id' | 'source';
+    field: 'concept' | 'facet' | 'id' | 'source' | 'tag' | 'text' | 'title';
     value: string;
     score?: number;
     reason?: string;
@@ -302,8 +302,8 @@ interface AiwgIndexGraphOptions {
     relationshipWeights?: Record<string, number>;
     includeDanglingRelationships?: boolean;
 }
-type AiwgRelationshipDirection = 'in' | 'out' | 'both';
-type AiwgRelationshipSetOperation = 'intersection' | 'union' | 'difference';
+type AiwgRelationshipDirection = 'both' | 'in' | 'out';
+type AiwgRelationshipSetOperation = 'difference' | 'intersection' | 'union';
 interface AiwgRelationshipTraversalOptions {
     direction?: AiwgRelationshipDirection;
     relationshipType?: string;
@@ -359,7 +359,7 @@ interface AiwgStaticEmbeddingSet {
     model: string;
     dimensions: number;
     generated_at: string;
-    granularity: 'title-summary' | 'body' | 'chunked-body' | string;
+    granularity: 'body' | 'chunked-body' | 'title-summary' | string;
     metric?: 'cosine' | 'dot' | 'euclidean';
     input_hash_algorithm?: string;
     embeddings: AiwgStaticEmbeddingRecord[];
@@ -381,7 +381,7 @@ interface BuildAiwgStaticEmbeddingSetOptions {
     id: string;
     backend: AiwgHeadlessEmbeddingBackend;
     records?: AiwgFortemiRecord[];
-    generatedAt?: string | Date;
+    generatedAt?: Date | string;
     granularity?: AiwgStaticEmbeddingSet['granularity'];
     metric?: AiwgStaticEmbeddingSet['metric'];
     textForRecord?: (record: AiwgFortemiRecord) => string;
@@ -415,8 +415,8 @@ interface AiwgReviewInput {
 interface AiwgIndexControllerSnapshot {
     index: AiwgFortemiIndexExport | null;
     chunked: {
-        manifest: AiwgFortemiChunkManifest;
         cachedParts: number;
+        manifest: AiwgFortemiChunkManifest;
         maxCachedParts: number;
     } | null;
     data: AiwgIndexQueryResult | null;
@@ -475,8 +475,8 @@ interface AiwgChunkedIndexBuildResult {
         part: AiwgFortemiChunkPart;
     }>;
     details: Array<{
-        id: string;
         href: string;
+        id: string;
         record: AiwgFortemiRecord;
     }>;
 }
@@ -493,19 +493,18 @@ declare function findAiwgStaticDuplicatePairs(index: AiwgFortemiIndexExport, emb
 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: {
+    communities: {
         id: string;
+        nodes: string[];
     }[];
     edges: {
+        kind: string;
         source: string;
         target: string;
-        kind: string;
         weight: number;
     }[];
-    communities: {
+    nodes: {
         id: string;
-        nodes: string[];
     }[];
 };
-
 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 AiwgDetailIdEncoding, 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 AiwgOperationalState, type AiwgOperationalStateClassification, type AiwgOperationalStateConfidence, 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 AiwgStateTransfer, type AiwgStaticDuplicatePair, type AiwgStaticEmbeddingRecord, type AiwgStaticEmbeddingSet, type AiwgStaticHybridQueryOptions, type AiwgStaticSemanticQueryOptions, type AiwgStaticSemanticResult, type BuildAiwgStaticEmbeddingSetOptions, DEFAULT_AIWG_DUPLICATE_SCAN_MAX_EMBEDDINGS, aiwgDetailHrefForId, aiwgFortemiIndexToCommunityGraph, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, encodeAiwgDetailId, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, getAiwgFortemiFacets, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, resolveAiwgFetchUrl, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgStaticEmbeddingSet };