@x12i/memorix-pipeline-manager
v1.32.1
Published
Visual pipeline and association manager UI for Memorix enrichment
Readme
@x12i/memorix-pipeline-manager
Visual UI for Memorix enrichment — dashboard, pipeline health, association design, plan/apply, registry, and record inspect.
Backed by memorix-explorer-api (no separate backend package). Design reference: .operational/mock.html (look/IA only — not a data source).
Sibling: Catalox Manager
Pipeline Manager and Catalox Manager share the same memorix-catalox database but different APIs:
- This app →
memorix-explorer-api(:5181) — data / runtime / lifecycle - Catalox Manager →
memorix-catalox-api(:5180) — metadata manage + execute
Three process catalogs are used from both lenses:
memorix-associator-presetsmemorix-associated-properties-registrymemorix-enrichment-playbooks
Catalog status in this app is read-only: it reports Mongo ↔ Catalox gaps and points to Catalox Manager for metadata fixes.
Sibling: Pipeline Simulator
Pipeline Simulator (:5179) is a local sandbox that should copy real data and never write live Catalox/entities. Data Simulator (:5178) previews descriptors against copied/seed records.
Quick start
cd memorix-pipeline-manager
npm install
# Starts memorix-explorer-api on :5181 and Vite on :5176
npm run devOpen http://localhost:5176/
Features
| Route | Purpose |
|-------|---------|
| / | Dashboard — per-OT health, recent runs, failure reasons |
| /objects/:objectType | Pipeline workspace |
| /objects/:objectType/health | Stage counts + run history |
| /objects/:objectType/inspect/:recordId? | Record inspector (Overview / Buckets / Associations / Narratives / System) |
| /objects/:objectType/associations | Association designer + plan/apply |
| /objects/:objectType/registry | Registry + parity (read-only regenerate note) |
| /objects/:objectType/library | Parts catalog (resolvers / insights / presets) |
| /objects/:objectType/narratives | Narrative signals catalog |
| /objects/:objectType/runs/new | Run configuration (documented scopes only) |
| /objects/:objectType/runs/:runId | Run detail |
| /objects/:objectType/troubleshoot | Per-run failure reasons |
| /settings | Env + local notification prefs (no fake RBAC) |
Association designer workflow
- Pick source object type and join paths (
data.*) - Pick target object type, content type, and payload form
- Define snapshot join paths
- Preview diagram
- Build → Validate → Plan → Apply → Verify
- Promote to registry (requires
MEMORIX_EXPLORER_ENABLE_METADATA_WRITES=true)
Ranked “Top” associations are not offered until the schema is confirmed.
Environment
| Variable | Default | Description |
|----------|---------|-------------|
| VITE_DEV_PORT | 5176 | Vite dev server port |
| EXPLORER_API_PORT | 5181 | Explorer API port |
| VITE_MEMORIX_EXPLORER_API | /api/explorer | API base (prod override) |
