@fortemi/core 2026.5.0 → 2026.5.2

package/README.md

@@ -1,8 +1,34 @@
+<div align="center">
+
 # @fortemi/core
 
-Browser-only knowledge management core. PGlite (PostgreSQL WASM) data layer, single-writer worker, 11 MCP tools, job queue, capability system, SKOS taxonomy, hybrid search. 100% JSON format parity with the [`fortemi`](https://github.com/Fortemi/fortemi) Rust server.
+**Headless browser knowledge-management core powered by PGlite, typed repositories, and agent tool helpers**
+
+Local PostgreSQL-compatible storage, migrations, note/search repositories, capability orchestration, Knowledge Shards, and bridge-ready tool metadata for browser applications.
+
+```bash
+pnpm add @fortemi/core
+```
+
+[![npm version](https://img.shields.io/npm/v/@fortemi/core/latest?label=npm&color=CB3837&logo=npm&style=flat-square)](https://www.npmjs.com/package/@fortemi/core)
+[![npm downloads](https://img.shields.io/npm/dm/@fortemi/core?color=CB3837&logo=npm&style=flat-square)](https://www.npmjs.com/package/@fortemi/core)
+[![License: AGPL-3.0-only](https://img.shields.io/badge/License-AGPL--3.0--only-blue.svg?style=flat-square)](https://github.com/Fortemi/fortemi-react/blob/main/LICENSE)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen?style=flat-square&logo=node.js)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org)
+
+[**Install**](#installation) · [**Quick Start**](#quick-start) · [**Surface**](#what-you-get) · [**Tools**](#tool-surface) · [**Docs**](#documentation) · [**License**](#license)
 
-## Install
+</div>
+
+---
+
+## What @fortemi/core Is
+
+`@fortemi/core` is the headless Fortemi runtime for browser applications. It provides a PGlite-backed archive, repository classes, migrations, eventing, capability management, Knowledge Shard import/export, and tool helpers that can be called from UI code or bridge adapters.
+
+Use `@fortemi/core` directly when you are building your own UI, integrating Fortemi into a non-React host, or wiring agent/tool calls against an existing browser database context.
+
+## Installation
 
 ```bash
 pnpm add @fortemi/core
@@ -10,57 +36,95 @@ pnpm add @fortemi/core
 npm install @fortemi/core
 ```
 
-Peer-installed dependencies — these install automatically as regular dependencies:
+Runtime dependencies installed with the package:
 
-- `@electric-sql/pglite` — PostgreSQL compiled to WASM
-- `@noble/hashes` — cryptographic hashing
-- `fflate` — gzip / tar for Knowledge Shards
-- `uuid` — UUIDv7 generation
-- `zod` — runtime validation
+| Dependency | Purpose |
+|---|---|
+| `@electric-sql/pglite` | PostgreSQL compiled to WASM, plus pgvector |
+| `@noble/hashes` | SHA hashing for content and integrity checks |
+| `fflate` | Tar/gzip handling for Knowledge Shards |
+| `uuid` | UUIDv7 identifiers |
+| `zod` | Runtime input validation for tool helpers |
 
-## Quick start
+## Quick Start
 
 ```ts
-import { createFortemi, registerServiceWorker } from '@fortemi/core';
-
-// Spin up the in-browser database and worker. OPFS on Chrome,
-// IndexedDB on Firefox, in-memory on Safari.
-const core = await createFortemi({
-  persistence: 'auto',
-  archive: 'default',
-});
-
-// Create a note (server-format parity).
-const note = await core.notes.create({
+import {
+  ArchiveManager,
+  NotesRepository,
+  SearchRepository,
+  TypedEventBus,
+  registerServiceWorker,
+} from '@fortemi/core'
+
+const events = new TypedEventBus()
+const archiveManager = new ArchiveManager('opfs', events)
+const db = await archiveManager.open('default')
+
+const notes = new NotesRepository(db, events)
+const search = new SearchRepository(db)
+
+const note = await notes.create({
   title: 'Hello',
-  body: 'First note in the local archive.',
-});
+  content: 'First note in the local archive.',
+})
 
-// Search (full-text by default; hybrid once semantic capability initializes).
-const results = await core.search.query({ text: 'hello' });
+const results = await search.search('hello')
 
-// Optional: expose MCP REST endpoints on localhost:3000 via service worker.
-await registerServiceWorker();
+// Optional: register standalone service-worker routes.
+await registerServiceWorker()
 ```
 
-## What it provides
+## What You Get
 
 | Surface | Description |
 |---|---|
-| **PGlite worker** | Single-writer Postgres WASM in a dedicated worker; all DB operations serialized via `postMessage` |
-| **Repositories** | Notes, search, tags, collections, links, SKOS concepts, attachments |
-| **MCP tools** | `capture_knowledge`, `manage_note`, `search`, `get_note`, `list_notes`, `manage_tags`, `manage_collections`, `manage_links`, `manage_archive`, `manage_capabilities`, `manage_attachments` |
-| **Service worker** | Optional MCP JSON-RPC over HTTP on `localhost:3000` (request interception) |
-| **Capability system** | Opt-in WASM modules: embeddings (transformers.js), local LLM (WebLLM), GPU detection |
-| **Inference providers** | OpenAI-compatible (remote + local), auto-discovery (Ollama, LM Studio, llama.cpp, vLLM, Jan), capability-aware fallback |
-| **Job queue** | Server-compatible pipeline: `ai_revision` (1), `title_generation` (2), `embedding` (3), `concept_tagging` (4), `linking` (5) |
-| **Knowledge Shards** | Tar.gz bundles with checksums for import/export; field-mapped JSON format parity |
-| **Migrations** | 5 numbered schema migrations matching the fortemi server |
+| PGlite archive | `opfs`, `idb`, and `memory` persistence modes with migrations on open |
+| Repositories | Notes, search, tags, collections, links, SKOS concepts, and attachments |
+| Event bus | Typed subscriptions for note, job, archive, and capability events |
+| 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 and JSON format parity |
+| Service-worker helpers | Route registration primitives for standalone browser integration |
+
+## Tool Surface
+
+`FortemiToolManifest` registers 10 bridge-visible Mnemos tools:
+
+`capture_knowledge`, `manage_note`, `search`, `get_note`, `list_notes`, `manage_tags`, `manage_collections`, `manage_links`, `manage_archive`, `manage_capabilities`.
+
+The package also exports 11 direct helper functions from `@fortemi/core`, including `manageAttachments` for attachment metadata and blob operations.
+
+```ts
+import { fortemiManifest } from '@fortemi/core'
+
+const capabilities = fortemiManifest.toPlinyCapabilities()
+```
+
+## Browser Storage
+
+| Mode | Storage | Best for |
+|---|---|---|
+| `opfs` | Origin Private File System access-handle pool | Chrome and Edge production apps |
+| `idb` | IndexedDB-backed PGlite data directory | Firefox and broad compatibility |
+| `memory` | In-memory database | Tests, demos, restricted browser contexts |
+
+## React Bindings
+
+For React applications, install `@fortemi/react`. It wraps `@fortemi/core` with `FortemiProvider`, context access, and 21 hooks.
+
+```bash
+pnpm add @fortemi/react @fortemi/core react
+```
 
-## React bindings
+## Documentation
 
-If you're building a React app, use [`@fortemi/react`](https://www.npmjs.com/package/@fortemi/react) instead — it wraps `@fortemi/core` with `FortemiProvider` and 21 hooks.
+- [Repository API](https://github.com/Fortemi/fortemi-react/blob/main/docs/api-reference.md#repositories)
+- [Integration guide](https://github.com/Fortemi/fortemi-react/blob/main/docs/integration.md)
+- [Search guide](https://github.com/Fortemi/fortemi-react/blob/main/docs/search.md)
+- [Extending Fortemi](https://github.com/Fortemi/fortemi-react/blob/main/docs/extending.md)
+- [Supply-chain controls](https://github.com/Fortemi/fortemi-react/blob/main/docs/security/supply-chain.md)
 
 ## License
 
-[AGPL-3.0-only](https://github.com/Fortemi/fortemi-react/blob/main/LICENSE).
+AGPL-3.0-only. See [LICENSE](https://github.com/Fortemi/fortemi-react/blob/main/LICENSE).

package/dist/index.d.ts

@@ -2370,6 +2370,6 @@ declare function exportShard(db: DatabaseClient, options?: ExportOptions): Promi
  */
 declare function importShard(db: DatabaseClient, data: Uint8Array | ArrayBuffer, options?: ImportOptions): Promise<ImportResult>;
 
-declare const VERSION = "2026.5.0";
+declare const VERSION = "2026.5.2";
 
 export { type ArchiveInfo, ArchiveManager, type AttachInput, type AttachmentBlobRow, type AttachmentRow, AttachmentsRepository, type BlobStore, type BrowserNoteExport, CURRENT_SHARD_VERSION, type CapabilityInfo, CapabilityManager, type CapabilityName, type CapabilityState, type CaptureKnowledgeInput, CaptureKnowledgeInputSchema, type CaptureKnowledgeResult, type CollectionCreateInput, type CollectionRow, CollectionsRepository, type CompletionRequest, type CompletionResponse, type ConditionResult, type ConflictStrategy, type CooldownConfig, type CooldownEvent, type CspDirectiveName, type CspDirectives, type CspViolationReport, type DatabaseClient, type DiscoveredProvider, type DiscoveryOptions, type EmbedFunction, type EmbedRequest, type EmbedResponse, type EnqueueJobInput, type ErrorCategory, type EventMap, type ExportOptions, type FallbackEvent, FallbackRouter, type FallbackRouterConfig, type FortemiConfig, type FortemiCore, type FortemiToolDefinition, FortemiToolManifest, type GetNoteInput, GetNoteInputSchema, type GpuCapabilities, type IDisposable, type ImportCounts, type ImportOptions, type ImportResult, type InferenceCapabilities, type InferenceProvider, JOB_CAPABILITIES, JOB_PRIORITIES, type JobQueueOptions, JobQueueWorker, type JobStatus, type JobType, LOCAL_ENDPOINTS, 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, type Migration, MigrationRunner, type ModelCategory, type ModelFitResult, type ModelInfo, type NoteCreateInput, type NoteFull, type NoteListOptions, type NoteRevision, type NoteSummary, type NoteUpdateInput, NotesRepository, OpenAICompatibleProvider, type OpenAIProviderConfig, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, type PaginatedResult, type PersistenceMode, type PlinyCapability, type PluginCspOptions, type PluginScriptDescriptor, type PluginScriptPolicy, type ProbeResult, type ProbeStatus, type ProviderCapabilities, ProviderRegistry, type ProviderTier, type QueryExecutor, type QueryResult, type RecommendedTier, type RouteHandler, SHARD_FORMAT, type SWRegistrationResult, type SearchFacets, type SearchInput, SearchInputSchema, type SearchOptions, SearchRepository, type SearchResponse, type SearchResult, type ShardCollection, type ShardComponent, type ShardEmbedding, type ShardEmbeddingSet, type ShardEmbeddingSetMember, type ShardLink, type ShardManifest, type ShardNote, type ShardTag, type SkosConcept, type SkosRelation, SkosRepository, type SkosScheme, type StorageBackend, type StorageBackendFactory, type StorageOpenRequest, type StorageTopology, type StreamChunk, TagsRepository, TransactionProxy, TypedEventBus, VERSION, type VramTier, type WorkerRequest, type WorkerResponse, aiRevisionHandler, allMigrations, appendPluginScript, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, collectionFromShard, collectionToShard, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createBlobStore, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteInstance, createRoutes, defaultStorageBackendFactory, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchPluginScript, fortemiManifest, generateId, getEmbedFunction, getJobQueueStatus, getLlmFunction, getNote, importShard, isPluginScriptAllowed, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteToShard, packTarGz, parseCspReport, registerLlmCapability, registerSemanticCapability, registerServiceWorker, searchTool, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateChecksums, verifySri };

package/dist/index.js

@@ -5131,7 +5131,7 @@ function parseJsonArray(data) {
 }
 
 // src/index.ts
-var VERSION = "2026.5.0";
+var VERSION = "2026.5.2";
 
 export { ArchiveManager, AttachmentsRepository, CURRENT_SHARD_VERSION, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LOCAL_ENDPOINTS, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, ProviderRegistry, SHARD_FORMAT, SearchInputSchema, SearchRepository, SkosRepository, TagsRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, allMigrations, appendPluginScript, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, collectionFromShard, collectionToShard, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createBlobStore, createCspReportHandler, createFortemi, createLegacyProvider, createPGliteInstance, createRoutes, defaultStorageBackendFactory, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, fetchPluginScript, fortemiManifest, generateId, getEmbedFunction, getJobQueueStatus, getLlmFunction, getNote, importShard, isPluginScriptAllowed, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, noteFromShard, noteToShard, packTarGz, parseCspReport, registerLlmCapability, registerSemanticCapability, registerServiceWorker, searchTool, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, suggestTags, tagsFromShard, tagsToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, validateChecksums, verifySri };
 //# sourceMappingURL=index.js.map