@x12i/catalox 5.2.0 → 5.9.7

package/CHANGELOG.md

@@ -0,0 +1,147 @@
+# Changelog
+
+## 5.9.7
+
+**Alignment fixes**
+
+- Publish **`@x12i/catalox-contracts`** alongside **`@x12i/catalox`** so runtime imports resolve on npm (5.9.6 tarball referenced contracts without publishing them).
+- Root **`@x12i/catalox`** declares engine runtime dependencies (`@x12i/helpers`, `firebase-admin`, etc.).
+- HTTP API: **`GET/PUT /v1/catalogs/:catalogId/items/:itemId/native-record`** maps to `getNativeCatalogItem` / `replaceNativeCatalogItem`.
+- Client SDK: **`getNativeCatalogItem`**, **`replaceNativeCatalogItem`** on `CataloxClientBound`.
+- OpenAPI updated to **5.9.6** surface (native-record routes).
+- Docs and scripts: source links point at **`packages/engine/src/`** (legacy root `src/` removed); `scripts/data/*` imports use workspace packages.
+- CI workflow file excluded from git until PAT has `workflow` scope (`.github/` gitignored).
+
+## 5.9.6
+
+**New — generic catalog content helpers (embedder surface)**
+
+Domain apps (skills, snippets, templates, etc.) can compose these without Catalox knowing item roles or catalog ids:
+
+- **Field codec** — `normalizeTextForStorage` / `toPresentationText` (aliases `normalizeForStorage` / `toPresentationMarkdown`) for storage ⇄ presentation text round-trip.
+- **Template tokens** — `extractTokenNamesFromText`, `extractTokenNamesFromStrings`, `extractTemplateTokensFromFields` for `{{token}}` (optional `${token}`) placeholder discovery.
+- **Derived items** — `readIndexedParentItemId`, `withDerivedParentIndexed`, `computeDerivedFieldOverrides`, `resolveDerivedItemData`, `resolveDerivedItem`, `emptyDataFieldsPatch` for parent/child sparse-override catalogs (`indexed.parentItemId` convention).
+- Contracts: `CATALOG_DERIVED_PARENT_INDEXED_KEY`, `DerivedItemFieldOverrides`, `ResolvedDerivedItem`, `ExtractedTemplateInputs`.
+
+**New — authenticated full-document native replace (FR-CATALOX-1 / FR-CATALOX-2)**
+
+- **`replaceNativeCatalogItem(ctx, catalogId, record)`** — generic, authenticated full-document native replace. Persists with **no field-level merge** (`merge: false`), so keys omitted from `record.data` / `record.indexed` / `record.metadata` are **removed**, not preserved from a prior revision. Enforces the same access model as `upsertNativeCatalogItem` (app binding `canWrite`, or `ctx.superAdmin` for provision) and the same scope write gate. Catalox owns `metadata.lastUpdate`, preserves `metadata.createdAt`, and increments `version`.
+- **`replaceNativeCatalogItems(ctx, catalogId, records, { atomic? })`** — batch variant. `atomic` defaults to `true` (validate all rows, then commit per store batch chunk of ≤450 writes).
+- **`getNativeCatalogItem(ctx, catalogId, itemId, options?)`** — authenticated read returning the stored `NativeCatalogItemRecord` envelope by logical `itemId` (respects `canRead`).
+- Store layer: `replace` / `batchReplace` added to the Firestore, Mongo, and in-memory `NativeItemStore` implementations.
+- Bound API (`CataloxBound`) and CLI (`catalox items replace`, `catalox items batch-replace`) wrappers.
+- `upsertNativeCatalogItem` merge semantics are **unchanged**; replace is an additive, opt-in API.
+- Docs: README native write contract table, [`docs/native-catalog-storage-and-api.md`](docs/native-catalog-storage-and-api.md) §6, [`docs/cli-items.md`](docs/cli-items.md).
+
+## 5.9.5
+
+**New — monorepo and internal HTTP API**
+
+- npm workspaces monorepo: `@x12i/catalox-contracts`, `@x12i/catalox-engine`, `@x12i/catalox-api`, `@x12i/catalox-client`, `@x12i/catalox-authix-bridge`, `@x12i/catalox-openapi`, `catalox-service`.
+- Internal HTTP API (Fastify) with dual auth: open mode (`X-Catalox-Context`) and authix mode (`Authorization: Bearer`).
+- `createCataloxClient` SDK with `withContext` and `withToken`.
+- Root `@x12i/catalox` re-exports `@x12i/catalox-engine` for backward compatibility.
+- Docs: [`docs/catalox-v6/5.9.5/`](docs/catalox-v6/5.9.5/), transition reference [`docs/catalox-v6/6.0.0/transition-from-5.9.5.md`](docs/catalox-v6/6.0.0/transition-from-5.9.5.md).
+
+## 5.9.0
+
+**Breaking — local snapshot schema**
+
+- Local file snapshots use **`catalox.catalog.local.v1`** (`CATALOX_CATALOG_LOCAL_SCHEMA_V1`). Legacy **`funcx.catalog.local.v1`** snapshots are rejected at load.
+- Export rename: `FUNCX_*` local types/constants removed from the public embedder surface in favor of **`CATALOX_*`** / `CataloxCatalogLocalSnapshotV1`.
+
+**New — MongoDB as primary persistence**
+
+- **`createCatalox({ mongo: MongoStore })`** wires Mongo-backed domain stores (parity with Firestore collection names).
+- **`createCataloxFromMongoEnv`**, **`initMongoPersistenceFromEnv`**, **`testMongoConnectionFromEnv`** via **`@x12i/helpers/mongo`** (`@x12i/catalox/mongo`).
+- Native item reads report **`sourceType: "mongo"`** when wired from Mongo stores.
+- Firestore operator features (GCS backup/export, migrations, record history) fail fast on Mongo and local modes.
+
+**New — local file store (embedder)**
+
+- **`createCatalox({ store: LocalFileStore })`** for offline read-only catalog runtime without Firebase.
+- Docs: [`docs/local-file-store.md`](docs/local-file-store.md), [`docs/mongo-persistence.md`](docs/mongo-persistence.md).
+
+**Package**
+
+- Version **5.9.0**; `@x12i/helpers` **^1.7.0**; export **`@x12i/catalox/mongo`**.
+- npm tarball includes local + mongo persistence docs.
+
+## 5.1.1
+
+- **CAT-001:** `getCatalogItem`, `updateNativeCatalogItem`, `deleteNativeCatalogItem`, and smart-property target resolution use `storageDocIdForItem(logicalId)` when `findByLogicalItemId` returns no rows (fixes logical ids containing `/`, e.g. `@scope/pkg`, `skillCode:code`).
+- **CAT-005:** `listCatalogItems` on native catalogs uses Firestore `array-contains` on `indexed.*` for multi-value / indexed smart-property filters; multi-value smart properties always index as arrays.
+- **CAT-003:** still open — no cross-catalog transaction API.
+
+## 5.1.0
+
+- **Smart properties:** `CatalogDescriptor.smartProperties` and `smartPropertyRules` — descriptor-driven FK fields on native upsert/patch with optional auto-create, usage metadata on targets (`usageCount`, `lastUsedAt`, `firstUsedAt`), scope union, and `minPropertiesFilled` validation. Docs: `docs/smart-properties.md`, README section.
+- **CLI:** `catalox items validate --no-auto-create` for smart-property target checks.
+- **Pagenti preset:** `pagenti@v4` — unified smart properties on skills, knowledge, and execution; `pagenti_target_skill` FK catalog for `skillCode`; composite identity on execution (`npm run seed:pagenti`).
+
+## 5.0.0
+
+**Breaking — flexible native item scope**
+
+- **Item binding:** native rows use `scope: { domains?: string[], agents?: string[], … }`. Empty `{}` = generic item. Legacy `scope.kind` / `scoped.agent.domainId` shapes are rejected at runtime (run migration first).
+- **Token scope:** set `context.scope` from the validated token. This is the mandatory visibility boundary for scoped items.
+- **Fetch scope:** `options.scope.scope` narrows the request (intersects with token per dimension). Fetch scope cannot grant access when `context.scope` is empty unless `superAdmin` or `unrestrictedScope`.
+- **Fetch controls:** `includeGeneric` (default true), `scopedOnly`, `genericOnly`, `includeScopeInResponse` (default true). List/get responses include item `scope`.
+- **Storage:** one logical row per `itemId`; safe Firestore doc ids use `id~<base64url>` when `itemId` contains `/` (legacy `cx~m~` rows migrated).
+- **Migration:** `catalox firestore migrate-native-item-scope` (`--dry-run`, `--verify-only`, `--scope-mapping`, `--i-have-backups`). Reports `conflict_physical_variants` when same `itemId` has differing payloads.
+- **Removed:** `NativeCatalogStoredScope`, `NativeCatalogStoredScopeV1`, singular `context.domainId` / `context.agentId` for item visibility, `metadata.domainIds` / `agentIds` as visibility drivers.
+
+## 4.0.3
+
+- **Seed presets:** **`--preset <id>`** on **`catalox seed apply`** (mutually exclusive with **`--file`**). **`applyCataloxSeedPreset`** accepts **`{ preset, cwd? }`**; **`resolveCataloxSeedPresetPath`**, **`getBundledCataloxPresetsDir`**, **`CataloxSeedPresetResolveError`** exported from **`@x12i/catalox`**. Bundled **`presets/registry.json`** (aliases such as **`native-map@v1`**). Embedder packages can publish a manifest path via **`"catalox": { "seedPreset": "./path/within-package.json" }`** in **`package.json`** (default **`catalox-seed-preset.json`**).
+- **Firestore probe:** **`testFirestoreConnectionFromEnv`**, **`CATALOX_FIRESTORE_PROBE_COLLECTION_ID`**, and **`TestFirestoreConnectionFromEnvResult`** re-exported from **`@x12i/catalox`** (same as **`@x12i/catalox/firebase`**).
+- **Docs:** onboarding happy path updated for **`--preset`** and preset selector table.
+
+## 4.0.0
+
+- **Firebase bootstrap:** credential resolution order **`GOOGLE_SERVICE_ACCOUNT_BASE64`** → optional **`serviceAccountPath`** → ADC; optional **`FIRESTORE_DATABASE_ID`** for named databases.
+- **`testFirestoreConnectionFromEnv`:** Firestore probe uses collection **`cataloxConnectivityProbe`** (avoids reserved `__…__` ids). Export **`CATALOX_FIRESTORE_PROBE_COLLECTION_ID`**.
+- **CLI:** **`catalox firestore probe`**, **`catalox seed apply --app … --file …`** (`--god` when manifest includes descriptors).
+- **Library:** **`applyCataloxSeedPreset`**, **`parseCataloxSeedManifest`**, **`loadCataloxSeedManifestFromPath`** (`src/catalox/seed-preset.ts`, re-exported from **`@x12i/catalox`**).
+- **`Catalox.upsertCatalogDescriptor`** / **`CataloxBound.upsertCatalogDescriptor`** (super-admin). Contract **`UpsertCatalogDescriptorInput`**.
+- **Docs:** `docs/onboarding-happy-path.md`, `docs/native-map-catalog-preset.md`; example **`presets/native-map-v1.json`** (published in npm tarball).
+
+## 3.2.0
+
+- Dependency refresh:
+  - `@x12i/logxer` to `^4.0.2`
+  - `@x12i/helpers` to `^1.5.2`
+
+## 3.1.1
+
+- **Live tests:** Firestore integration test now sets **`queryableFields`** on the patched descriptor so equality filters match stored **`indexed.*`** rows (same rule as production descriptors).
+- **Live tests:** Record-history integration test covers **update**, **get event**, **restore**, and **GCS object** cleanup when a bucket is configured.
+- **Package:** publish **`firestore.indexes.json`** in the npm tarball for operators deploying **`catalogItemHistory`** queries.
+
+## 3.1.0
+
+- **Per-record history:** optional **`recordHistory`** on **`createCatalox`** (or **`CATALOX_RECORD_HISTORY_*`** env for CLI) writes **GCS NDJSON** + Firestore **`catalogItemHistory`** on native upsert/update/delete/batch/move. APIs: **`listCatalogItemHistory`**, **`getCatalogItemHistoryEvent`**, **`restoreCatalogItemFromHistory`**, **`replayCatalogToPointInTime`**. CLI: **`catalox history …`**. See `docs/record-history.md`, `firestore.indexes.json`.
+- **Catalog lifecycle:** **`deleteCatalog`**, **`restoreDeletedCatalog`**, **`renameCatalog`** (hard rename) + CLI **`catalox catalog …`**. See `docs/catalog-crud.md`.
+
+## 3.0.0
+
+- **`createCatalox(config)`** — single factory for Firestore-backed stores, authz, optional Mongo/API adapters, optional renderer snippet store (`src/catalox/create-catalox.ts`).
+- **`catalox.withContext(ctx)`** / `bindCataloxContext(catalox, ctx)` — **`CataloxBound`**: same APIs without repeating `CataloxContext` on every call (`src/catalox/catalox-bound.ts`).
+- **Breaking — lists:** **`CatalogListResult`** includes **`listOutcome: "ok" | "mapping_blocked"`**.
+- **Breaking — get item:** **`getCatalogItem`** returns **`CatalogGetItemResult`** (`found` | `not_found` | `mapping_blocked`), not `null`.
+- **Package:** `main` / `types` and `exports["."]` resolve to `packages/engine/dist/...`. Subpaths `@x12i/catalox/embedder`, `/operator`, `/mapping`, `/firebase`, `/mongo`.
+
+## 1.3.0
+
+- Expanded the public **descriptor contract** with optional UI metadata:
+  - `filterSpec`
+  - `presentationSpec`
+  - `customRenderer`
+- Added new public contracts for:
+  - `FieldSource` (cross-catalog option/value sources)
+  - filter + presentation specs
+  - custom renderer maps (`CatalogListRenderMap`, `CatalogItemRenderMap`)
+- Added public docs:
+  - `docs/catalog-list-render-map.md`
+  - `docs/catalog-item-render-map.md`
+

package/README.md

@@ -96,8 +96,35 @@ This repo is currently set up as a workspace package.
 | **`@x12i/catalox/embedder`** | Catalog runtime only: **`createCatalox`**, **`Catalox`**, **`withContext` / `CataloxBound`**, contracts, errors, adapters, **`validateMappingSpec` / `executeMapping`**. |
 | **`@x12i/catalox/operator`** | Markdown/diagrams/JSX, validation, bindings, **`ContextResolver`**, backup/GCS transfer helpers, identity/json-io, etc. |
 | **`@x12i/catalox/firebase`** | Firestore-backed store classes for advanced wiring. |
+| **`@x12i/catalox/mongo`** | MongoDB persistence bootstrap + store classes (`createCataloxFromMongoEnv`, `MongoStore`). |
 | **`@x12i/catalox/mapping`** | Full mapping module (including **`helper-gap-report`**). |
 
+### Local file store (offline embedder)
+
+Read catalog metadata and native items from a **`catalox.catalog.local.v1`** snapshot on disk — no Firebase credentials on the read path.
+
+```ts
+import { createCatalox, LocalFileStore, bindCataloxContext } from "@x12i/catalox/embedder";
+
+const catalox = createCatalox({
+  store: new LocalFileStore({ root: ".catalox/local", access: "read-only" }),
+});
+```
+
+See [`docs/local-file-store.md`](docs/local-file-store.md) for snapshot schema, out-of-scope operator features, and the no-legacy policy (`funcx.catalog.local.v1` is rejected).
+
+### MongoDB persistence (embedder)
+
+Use MongoDB as the primary metadata + native-item backend instead of Firestore:
+
+```ts
+import { createCataloxFromMongoEnv } from "@x12i/catalox/mongo";
+
+const { catalox } = await createCataloxFromMongoEnv();
+```
+
+Or pass a connected **`MongoStore`** to **`createCatalox({ mongo })`**. Operator backup/GCS/history features remain Firestore-only in v5.9 — see [`docs/mongo-persistence.md`](docs/mongo-persistence.md).
+
 ## Configuration (real connections)
 
 Catalox is a library: you provide initialized clients + runtime env. For a **full list of environment variables**, CLI vs library behavior, and integration-test requirements, see [`docs/environment.md`](docs/environment.md).
@@ -220,6 +247,7 @@ Example `.env` (do not commit secrets):
 
 ```bash
 MONGO_URI=mongodb://127.0.0.1:27017
+# MONGO_LIVE_TESTS=1   # opt-in for test/integration/mongo.live.test.ts
 # Optional: ADC via GOOGLE_APPLICATION_CREDENTIALS, workload identity, etc.
 # GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
 # Recommended for CLI + live tests: base64-encoded service account JSON (same shape as a key file)
@@ -254,7 +282,7 @@ The `catalox` binary loads `.env` via `dotenv`. Use **`CATALOX_*`** for **Catalo
 
 ```bash
 npm run cli -- firestore report-native-layout --app "narrix"
-# same as: node dist/src/cli/index.js firestore report-native-layout --app "narrix"
+# same as: node packages/engine/dist/cli/index.js firestore report-native-layout --app "narrix"
 ```
 
 #### `firestore` CLI quick reference
@@ -818,6 +846,66 @@ await catalox.upsertNativeCatalogItem({ appId: "myAppId" }, "signals", {
 await catalox.batchUpsertNativeCatalogItems({ appId: "myAppId" }, "signals", items);
 ```
 
+### Full-document replace (no merge)
+
+Use when the stored row must **drop** keys that are absent from the new payload (for example deprecated `data` or `indexed` fields). `upsertNativeCatalogItem` persists with Firestore merge and cannot reliably remove omitted top-level keys.
+
+```ts
+await catalox.replaceNativeCatalogItem({ appId: "myAppId" }, "signals", {
+  itemId: "S1",
+  catalogId: "signals",
+  data: { categoryId: "core", code: "S1", title: "Example" },
+  indexed: { categoryId: "core", code: "S1" },
+  metadata: { createdAt: "2026-01-01T00:00:00.000Z", lastUpdate: "2026-01-01T00:00:00.000Z" },
+});
+
+await catalox.replaceNativeCatalogItems({ superAdmin: true }, "signals", records, { atomic: true });
+```
+
+| API | Persistence | Use when |
+|-----|-------------|----------|
+| `upsertNativeCatalogItem` | merge (`merge: true`) | Partial upserts; flat strategy catalogs |
+| `updateNativeCatalogItem` | shallow-merge patch into `data` | Field-level edits |
+| `replaceNativeCatalogItem` | full replace (`merge: false`) | Normalized rows must drop deprecated keys |
+
+Authenticated read of the stored native envelope (not the unified list projection):
+
+```ts
+const row = await catalox.getNativeCatalogItem({ appId: "myAppId" }, "signals", "S1");
+```
+
+### Generic catalog content helpers (5.9.6+)
+
+Domain apps compose these from `@x12i/catalox` without Catalox knowing item roles or catalog ids:
+
+```ts
+import {
+  normalizeTextForStorage,
+  toPresentationText,
+  extractTemplateTokensFromFields,
+  computeDerivedFieldOverrides,
+  resolveDerivedItemData,
+  readIndexedParentItemId,
+  CATALOG_DERIVED_PARENT_INDEXED_KEY,
+} from "@x12i/catalox";
+
+// Storage ⇄ presentation text
+const stored = normalizeTextForStorage(editorMarkdown);
+const shown = toPresentationText(stored);
+
+// Template placeholders in text fields
+const { tokens, byField } = extractTemplateTokensFromFields({
+  body: "Summarize {{topic}} for {{audience}}",
+});
+
+// Derived items (parent catalog row + sparse overrides in child catalog)
+const overrides = computeDerivedFieldOverrides(parentData, nextData);
+const merged = resolveDerivedItemData(parentData, overrides);
+const parentId = readIndexedParentItemId(childRecord); // indexed.parentItemId
+```
+
+Aliases `normalizeForStorage` / `toPresentationMarkdown` and `extractTemplateTokensFromTexts` are exported for embedders migrating from ad-hoc helpers.
+
 ### List native items with equality filtering
 
 ```ts
@@ -970,7 +1058,7 @@ When **`CATALOX_RECORD_HISTORY_BUCKET`** is set, **`test/integration/record-hist
 - **`catalox.withContext(ctx)`** / **`bindCataloxContext(catalox, ctx)`** — **`CataloxBound`**: same APIs without repeating `CataloxContext` on every call (`src/catalox/catalox-bound.ts`).
 - **Breaking — lists:** **`CatalogListResult`** includes **`listOutcome: "ok" | "mapping_blocked"`**. Mapping validation failures use **`mapping_blocked`** (see **`issues`**). Empty **`items`** with **`listOutcome === "ok"`** means zero matching rows.
 - **Breaking — get item:** **`getCatalogItem`** returns **`CatalogGetItemResult`** (`found` | `not_found` | `mapping_blocked`), not **`null`**.
-- **Package:** **`main` / `types`** and **`exports["."]`** resolve to **`dist/src/...`**. Subpaths **`@x12i/catalox/embedder`**, **`/operator`**, **`/mapping`**, **`/firebase`**. Root **`@x12i/catalox`** re-exports embedder + operator (preserves most existing root imports).
+- **Package:** **`main` / `types`** and **`exports["."]`** resolve to **`packages/engine/dist/...`**. Subpaths **`@x12i/catalox/embedder`**, **`/operator`**, **`/mapping`**, **`/firebase`**, **`/mongo`**. Root **`@x12i/catalox`** re-exports embedder + operator (preserves most existing root imports). Runtime dependency **`@x12i/catalox-contracts`** is published alongside the root package.
 
 ### 2.7.0
 

package/package.json

@@ -1,79 +1,65 @@
 {
   "name": "@x12i/catalox",
-  "version": "5.2.0",
+  "version": "5.9.7",
   "description": "Platform infrastructure for reusable, interoperable catalogs across apps and data sources.",
   "license": "MIT",
   "private": false,
   "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "catalog",
-    "firestore",
-    "firebase",
-    "metadata",
-    "mapping",
-    "mongo",
-    "adapter",
-    "gcs",
-    "google-cloud-storage",
-    "x12i"
+  "packageManager": "npm@10.9.2",
+  "files": [
+    "packages/engine/dist",
+    "packages/engine/presets",
+    "packages/engine/schemas",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "workspaces": [
+    "packages/*",
+    "apps/*"
   ],
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
+      "types": "./packages/engine/dist/index.d.ts",
+      "default": "./packages/engine/dist/index.js"
     },
     "./embedder": {
-      "types": "./dist/src/embedder.d.ts",
-      "default": "./dist/src/embedder.js"
+      "types": "./packages/engine/dist/embedder.d.ts",
+      "default": "./packages/engine/dist/embedder.js"
     },
     "./operator": {
-      "types": "./dist/src/operator.d.ts",
-      "default": "./dist/src/operator.js"
+      "types": "./packages/engine/dist/operator.d.ts",
+      "default": "./packages/engine/dist/operator.js"
     },
     "./mapping": {
-      "types": "./dist/src/mapping/index.d.ts",
-      "default": "./dist/src/mapping/index.js"
+      "types": "./packages/engine/dist/mapping/index.d.ts",
+      "default": "./packages/engine/dist/mapping/index.js"
     },
     "./firebase": {
-      "types": "./dist/src/firebase/index.d.ts",
-      "default": "./dist/src/firebase/index.js"
+      "types": "./packages/engine/dist/firebase/index.d.ts",
+      "default": "./packages/engine/dist/firebase/index.js"
+    },
+    "./mongo": {
+      "types": "./packages/engine/dist/mongo/index.d.ts",
+      "default": "./packages/engine/dist/mongo/index.js"
     }
   },
   "bin": {
-    "catalox": "./dist/src/cli/index.js"
+    "catalox": "./packages/engine/dist/cli/index.js"
   },
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "files": [
-    "dist",
-    "docs/catalox-ui-contract.md",
-    "docs/cli-items.md",
-    "docs/cli-snapshot-export.md",
-    "docs/cli-toolbox.md",
-    "presets",
-    "schemas",
-    "README.md",
-    "LICENSE",
-    "firestore.indexes.json"
-  ],
   "scripts": {
-    "cli": "node dist/src/cli/index.js",
-    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm run clean && tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build && npm test",
-    "test": "npm run test:unit",
-    "test:unit": "node --import tsx --test \"test/unit/**/*.test.ts\"",
-    "test:integration": "node --import tsx --test \"test/integration/**/*.test.ts\"",
-    "lint": "node -e \"console.log('no lint configured')\"",
-    "seed:pagenti": "tsx scripts/seed-pagenti.ts --app pagenti",
-    "backup:full": "node dist/src/cli/index.js firestore backup --app pagenti --god --label full-backup-all-apps --snapshots"
+    "build": "turbo run build",
+    "test": "turbo run test",
+    "clean": "turbo run clean",
+    "prepack": "npm run build",
+    "cli": "node packages/engine/dist/cli/index.js",
+    "test:integration": "npm run test:integration -w @x12i/catalox-engine",
+    "seed:pagenti": "tsx scripts/seed-pagenti.ts --app pagenti"
   },
   "dependencies": {
     "@google-cloud/storage": "^7.19.0",
-    "@x12i/helpers": "^1.5.2",
+    "@x12i/catalox-contracts": "5.9.7",
+    "@x12i/helpers": "^1.7.0",
     "@x12i/logxer": "^4.6.0",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
@@ -83,15 +69,10 @@
     "html-entities": "^2.6.0",
     "mongodb": "^6.0.0"
   },
-  "optionalDependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "typescript": "^5.0.0"
-  },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "@x12i/env": "^4.0.1",
     "tsx": "^4.0.0",
+    "turbo": "^2.5.0",
     "typescript": "^5.0.0"
   },
   "engines": {

package/packages/engine/dist/adapters/api/api-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { ApiCatalogAdapterConfig } from "@x12i/catalox-contracts/adapters.js";
+import type { CatalogQueryOptions } from "@x12i/catalox-contracts/catalogs.js";
+import type { CataloxContext } from "@x12i/catalox-contracts/context.js";
+import type { CatalogId } from "@x12i/catalox-contracts/ids.js";
+import type { UnifiedCatalogItem } from "@x12i/catalox-contracts/items.js";
+import type { CatalogFieldMappingSpec, MappingExecutionOptions } from "@x12i/catalox-contracts/mappings.js";
+export type ApiAdapterRuntime = {
+    fetchImpl?: typeof fetch;
+};
+export declare class ApiCatalogAdapter {
+    private readonly runtime;
+    constructor(runtime?: ApiAdapterRuntime);
+    listItems(context: CataloxContext, catalogId: CatalogId, config: ApiCatalogAdapterConfig, mapping: {
+        responseMapping: CatalogFieldMappingSpec[];
+        options?: MappingExecutionOptions;
+    }, options?: CatalogQueryOptions): Promise<{
+        items: UnifiedCatalogItem[];
+        nextCursor?: string;
+        issues?: import("@x12i/catalox-contracts/mappings.js").CatalogMappingIssue[];
+    }>;
+}
+//# sourceMappingURL=api-adapter.d.ts.map

package/packages/engine/dist/adapters/api/api-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/api/api-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAI5G,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAYF,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,iBAAsB;IAEtD,SAAS,CACb,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE;QAAE,eAAe,EAAE,uBAAuB,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,uBAAuB,CAAA;KAAE,EAC1F,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,qCAAqC,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;CAkD/I"}

package/packages/engine/dist/adapters/api/api-adapter.js

@@ -0,0 +1,64 @@
+import { CatalogBindingError } from "@x12i/catalox-contracts/errors.js";
+import { executeMapping } from "../../mapping/execute-mapping.js";
+function deepGetFallback(obj, path) {
+    const parts = path.split(".").map((p) => p.trim()).filter(Boolean);
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null)
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+export class ApiCatalogAdapter {
+    runtime;
+    constructor(runtime = {}) {
+        this.runtime = runtime;
+    }
+    async listItems(context, catalogId, config, mapping, options) {
+        const fetchImpl = this.runtime.fetchImpl ?? fetch;
+        if (!config.endpoint)
+            throw new Error("API adapter missing endpoint.");
+        if (!context.appId)
+            throw new CatalogBindingError({ reason: "missing_appId", message: "API adapter requires context.appId." });
+        const url = new URL(config.endpoint);
+        if (options?.limit != null)
+            url.searchParams.set("limit", String(options.limit));
+        if (options?.offset != null)
+            url.searchParams.set("offset", String(options.offset));
+        const res = await fetchImpl(url.toString(), { method: config.method ?? "GET" });
+        if (!res.ok)
+            throw new Error(`API request failed: ${res.status}`);
+        const body = (await res.json());
+        const itemsPath = config.pagination?.itemsPath;
+        const rawItems = itemsPath ? deepGetFallback(body, itemsPath) : body;
+        const arr = Array.isArray(rawItems) ? rawItems : [];
+        const out = [];
+        const issues = [];
+        for (const row of arr) {
+            const source = row;
+            const mapped = executeMapping(source, mapping.responseMapping, mapping.options);
+            if (mapped.issues)
+                issues.push(...mapped.issues);
+            const itemId = config.itemIdSourcePath ? deepGetFallback(source, config.itemIdSourcePath) : undefined;
+            out.push({
+                itemId: itemId != null ? String(itemId) : JSON.stringify(source),
+                catalogId,
+                appId: context.appId,
+                sourceMode: "mapped",
+                sourceType: "api",
+                sourceRef: { endpoint: config.endpoint },
+                data: mapped.data,
+                metadata: { domainIds: [], agentIds: [] },
+            });
+        }
+        const nextCursorPath = config.pagination?.nextCursorPath;
+        const nextCursor = nextCursorPath ? deepGetFallback(body, nextCursorPath) : undefined;
+        return {
+            items: out,
+            ...(typeof nextCursor === "string" ? { nextCursor } : {}),
+            ...(issues.length ? { issues } : {}),
+        };
+    }
+}
+//# sourceMappingURL=api-adapter.js.map

package/packages/engine/dist/adapters/api/api-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-adapter.js","sourceRoot":"","sources":["../../../src/adapters/api/api-adapter.ts"],"names":[],"mappings":"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"}

package/packages/engine/dist/adapters/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/packages/engine/dist/adapters/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/packages/engine/dist/adapters/mongo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/mongo/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/packages/engine/dist/adapters/mongo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/mongo/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/packages/engine/dist/adapters/mongo/mongo-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { MongoCatalogAdapterConfig } from "@x12i/catalox-contracts/adapters.js";
+import type { CatalogQueryOptions } from "@x12i/catalox-contracts/catalogs.js";
+import type { CataloxContext } from "@x12i/catalox-contracts/context.js";
+import type { CatalogId } from "@x12i/catalox-contracts/ids.js";
+import type { UnifiedCatalogItem } from "@x12i/catalox-contracts/items.js";
+import type { MappingExecutionOptions } from "@x12i/catalox-contracts/mappings.js";
+export type MongoAdapterRuntime = {
+    mongoUri: string;
+};
+export declare class MongoCatalogAdapter {
+    private readonly runtime;
+    constructor(runtime: MongoAdapterRuntime);
+    listItems(context: CataloxContext, catalogId: CatalogId, config: MongoCatalogAdapterConfig, mapping: {
+        mapping: import("@x12i/catalox-contracts/mappings.js").CatalogFieldMappingSpec[];
+        options?: MappingExecutionOptions;
+    }, options?: CatalogQueryOptions): Promise<{
+        items: UnifiedCatalogItem[];
+        issues?: import("@x12i/catalox-contracts/mappings.js").CatalogMappingIssue[];
+    }>;
+}
+//# sourceMappingURL=mongo-adapter.d.ts.map

package/packages/engine/dist/adapters/mongo/mongo-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/mongo/mongo-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAKnF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEnD,SAAS,CACb,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,qCAAqC,EAAE,uBAAuB,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,uBAAuB,CAAA;KAAE,EAChI,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC;QAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,qCAAqC,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC;CA2D1H"}

package/packages/engine/dist/adapters/mongo/mongo-adapter.js

@@ -0,0 +1,61 @@
+import { MongoClient } from "mongodb";
+import { CatalogBindingError } from "@x12i/catalox-contracts/errors.js";
+import { executeMapping } from "../../mapping/execute-mapping.js";
+import { resolveMongoDbName } from "./resolve-db.js";
+export class MongoCatalogAdapter {
+    runtime;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async listItems(context, catalogId, config, mapping, options) {
+        if (!context.appId)
+            throw new CatalogBindingError({ reason: "missing_appId", message: "Mongo adapter requires context.appId." });
+        const client = new MongoClient(this.runtime.mongoUri);
+        await client.connect();
+        try {
+            const dbName = config.databaseResolution.kind === "lookup"
+                ? resolveMongoDbName(context.appId, { kind: "appId-direct" })
+                : resolveMongoDbName(context.appId, config.databaseResolution);
+            const db = client.db(dbName);
+            const coll = db.collection(config.collection);
+            const filter = {
+                ...(config.queryDefaults?.filter ?? {}),
+                ...(options?.filter ?? {}),
+            };
+            const sort = (options?.sort ?? config.queryDefaults?.sort ?? {});
+            const limit = options?.limit ?? 100;
+            const skip = options?.offset ?? 0;
+            const cursor = coll.find(filter).sort(sort).skip(skip).limit(limit);
+            const docs = (await cursor.toArray());
+            const items = [];
+            const issues = [];
+            for (const doc of docs) {
+                const source = doc;
+                const mapped = executeMapping(source, mapping.mapping, mapping.options);
+                if (mapped.issues)
+                    issues.push(...mapped.issues);
+                const itemId = (config.idSourcePath ? source?.[config.idSourcePath] : undefined) ??
+                    String(doc._id);
+                items.push({
+                    itemId: String(itemId),
+                    catalogId,
+                    appId: context.appId,
+                    sourceMode: "mapped",
+                    sourceType: "mongo",
+                    sourceRef: {
+                        database: dbName,
+                        collection: config.collection,
+                        sourceRecordId: String(doc._id),
+                    },
+                    data: mapped.data,
+                    metadata: { domainIds: [], agentIds: [] },
+                });
+            }
+            return issues.length ? { items, issues } : { items };
+        }
+        finally {
+            await client.close();
+        }
+    }
+}
+//# sourceMappingURL=mongo-adapter.js.map

package/packages/engine/dist/adapters/mongo/mongo-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-adapter.js","sourceRoot":"","sources":["../../../src/adapters/mongo/mongo-adapter.ts"],"names":[],"mappings":"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"}

package/packages/engine/dist/adapters/mongo/resolve-db.d.ts

@@ -0,0 +1,4 @@
+import type { AppId } from "@x12i/catalox-contracts/ids.js";
+import type { MongoDatabaseResolution } from "@x12i/catalox-contracts/adapters.js";
+export declare function resolveMongoDbName(appId: AppId, resolution: MongoDatabaseResolution): string;
+//# sourceMappingURL=resolve-db.d.ts.map

package/packages/engine/dist/adapters/mongo/resolve-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-db.d.ts","sourceRoot":"","sources":["../../../src/adapters/mongo/resolve-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,uBAAuB,GAAG,MAAM,CAO5F"}