@x12i/memorix-catalox-manager
v1.32.0
Published
Authoring and governance console for Memorix Catalox catalog kinds
Readme
@x12i/memorix-catalox-manager
Authoring and governance console for Memorix Catalox catalog kinds — browse, author, and publish metadata against live Catalox.
Backed by memorix-catalox-api (/api/catalox/*, default :5180). Design/spec references live under .operational/catalox-manager/.
Ownership: this app = Catalox catalog kinds / publish / integrity. Schema UI = Metadata Studio (entities, agents, narratives, reconcile). Both talk to the same catalox-api. See .operational/PACKAGE-OWNERSHIP.md.
Sibling: Pipeline Manager
Catalox Manager and Pipeline Manager share the same memorix-catalox database but different APIs:
| Product | API | Focus |
|---------|-----|--------|
| Catalox Manager (this app) | memorix-catalox-api (:5180) | Shape / schema / consumers / governance |
| Pipeline Manager | memorix-explorer-api (:5181) | Runtime / lifecycle / promotion against data |
Three process catalogs are used from both lenses:
memorix-associator-presetsmemorix-associated-properties-registrymemorix-enrichment-playbooks
That dual use is intentional and documented here — not advertised with in-app “overlap” badges.
Pipeline Manager’s Catalog status page is read-only and points here for metadata fixes.
Quick start
cd memorix-catalox-manager
npm install
# Starts memorix-catalox-api on :5180 and Vite on :5177
npm run devOpen http://localhost:5177/
Features
| Route | Purpose |
|-------|---------|
| / | Dashboard — shape/process tiles, item counts |
| /catalogs/:catalogId | Item list (kind filter for mixed catalogs) |
| /catalogs/:catalogId/items/:itemId | Overview · Author · Publish · Consumers · Raw |
| /governance/coverage | All 13 kinds + primary home |
| /governance/publish-log | Live GET /api/catalox/publish-log |
| /governance/schema-versions | Confirmed versions + audit |
| /governance/legacy-ids | Two documented remaps |
| /settings | Read-only memorix / memorix-catalox |
Honesty
- No kitchen-recalls mock data — empty when Catalox has nothing (not false
unavailable). - Author / Publish write live Catalox when
MEMORIX_CATALOX_ENABLE_METADATA_WRITES=true. - Schema versions: only
memorix.dashboardAnalytics.v1andmemorix.analyticsRollup.v1are “confirmed”.
Environment
| Variable | Default | Description |
|----------|---------|-------------|
| VITE_DEV_PORT | 5177 | Vite dev server |
| MEMORIX_CATALOX_API_PORT | 5180 | Catalox API |
| VITE_MEMORIX_CATALOX_API | /api/catalox | API base |
