@fortemi/core 2026.7.2 → 2026.7.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fortemi/core",
-  "version": "2026.7.2",
+  "version": "2026.7.4",
   "description": "Browser-only knowledge management core: PGlite (PostgreSQL WASM) data layer, single-writer worker, MCP tools, job queue, capability system, SKOS taxonomy, hybrid search. 100% JSON format parity with the fortemi Rust server.",
   "keywords": [
     "fortemi",
@@ -14,6 +14,7 @@
     "browser-database"
   ],
   "type": "module",
+  "sideEffects": false,
   "license": "AGPL-3.0-only",
   "author": "Joseph Magly <joe@magly.net>",
   "homepage": "https://github.com/Fortemi/fortemi-react",
@@ -31,6 +32,9 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "fortemi-compatibility": "./tools/verify-fortemi-compatibility.mjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -46,16 +50,20 @@
   },
   "files": [
     "dist",
+    "tools",
     "README.md",
     "LICENSE"
   ],
   "dependencies": {
-    "@electric-sql/pglite": "^0.4.1",
     "@noble/hashes": "^1.7.2",
+    "ajv": "^8.17.1",
     "fflate": "^0.8.2",
     "uuid": "^13.0.0",
     "zod": "^3.24.0"
   },
+  "optionalDependencies": {
+    "@electric-sql/pglite": "^0.4.1"
+  },
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.1",
@@ -67,6 +75,10 @@
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:db-table-parity": "vitest run src/__tests__/db-table-parity",
+    "test:portable-contract": "vitest run src/__tests__/aiwg-index.test.ts src/__tests__/shard/shard-conformance.spike.test.ts src/__tests__/shard/schema-validator.test.ts",
+    "shard:refresh-golden": "node scripts/refresh-knowledge-shard-golden.mjs",
+    "test:watch": "vitest",
+    "verify:fortemi-compatibility": "node tools/verify-fortemi-compatibility.mjs"
   }
 }

package/tools/verify-fortemi-compatibility.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import {
+  fetchAndValidateFortemiCompatibility,
+  formatFortemiCompatibilitySummary,
+} from '../dist/index.js'
+
+function usage() {
+  return `Usage: verify-fortemi-compatibility [--base-url URL] [--json]
+
+Validates a local Fortemi /api/v1/system/compatibility response using @fortemi/core.
+
+Environment:
+  FORTEMI_COMPATIBILITY_BASE_URL   Base URL or full compatibility endpoint URL
+  HOTM_FORTEMI_BASE_URL            HotM-compatible fallback base URL
+
+This is local compatibility evidence only. It is not hosted/mobile production proof.`
+}
+
+function parseArgs(argv) {
+  const parsed = {
+    baseUrl: process.env.FORTEMI_COMPATIBILITY_BASE_URL || process.env.HOTM_FORTEMI_BASE_URL || 'http://localhost:3000',
+    json: false,
+  }
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index]
+    if (arg === '--help' || arg === '-h') {
+      console.log(usage())
+      process.exit(0)
+    }
+    if (arg === '--json') {
+      parsed.json = true
+      continue
+    }
+    if (arg === '--base-url') {
+      const value = argv[index + 1]
+      if (!value) {
+        throw new Error('--base-url requires a value')
+      }
+      parsed.baseUrl = value
+      index += 1
+      continue
+    }
+    if (arg.startsWith('--base-url=')) {
+      parsed.baseUrl = arg.slice('--base-url='.length)
+      continue
+    }
+    throw new Error(`unknown argument: ${arg}`)
+  }
+
+  return parsed
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2))
+  const result = await fetchAndValidateFortemiCompatibility({ baseUrl: args.baseUrl })
+
+  if (args.json) {
+    console.log(JSON.stringify(result, null, 2))
+  } else if (result.ok && result.response) {
+    console.log(`Fortemi compatibility check passed: ${result.url}`)
+    console.log(formatFortemiCompatibilitySummary(result.response))
+    for (const warning of result.warnings) {
+      console.warn(`WARN: ${warning}`)
+    }
+  } else {
+    console.error(`Fortemi compatibility check failed: ${result.url}`)
+    for (const error of result.errors) {
+      console.error(`FAIL: ${error}`)
+    }
+    for (const warning of result.warnings) {
+      console.error(`WARN: ${warning}`)
+    }
+  }
+
+  process.exit(result.ok ? 0 : 1)
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+})