@x12i/memorix-opx-pack
v3.0.7
Published
Permanent opx/fieldstone acceptance pack: agent metadata, fixtures, opx-source, harness.
Readme
@x12i/memorix-opx-pack
Permanent opx acceptance pack for Memorix: agent metadata, fixtures, a localhost opx-source, harness, and APS simulation assets.
This is tier-4 product vocabulary (object types, pipelines, views) on top of the platform — not an engine.
Platform gate acceptance uses fresh sandbox* (or similar) orgs with agentIds: ["opx"]. Never point acceptance at live customer orgs.
Install
npm install @x12i/[email protected]Usually you run it from the monorepo rather than depending on it from a product app.
Contents
| Path | Purpose |
|------|---------|
| metadata/ | Agent opx, child agents, abstracts, object types, relationships, views, pipelines, sources, services |
| fixtures/opx-source-data.json | Deterministic source payloads (legacy path; mirrored under simulation/data/) |
| simulation/ | APS package-sim assets — pack.simulation.json + data (MX-CF-FR-022). Host rebuild blocked on APS-CF-CR-005 |
| opx-source/server.mjs | Temporary local REST until APS package-sim replaces it — do not grow as a second simulator |
| scripts/harness.mjs | up / down / reset / accept |
| examples/v2/ | Golden memorix-record/2 records |
Exports: . · ./metadata/* · ./fixtures/* · ./simulation/*.
Simulation (Studio)
- Engine:
@x12i/api-simulatoronly — seedocs/connector-framework/APS-CF-requirements.md(FR-009…012) andMX-CF-simulation-requirements.md. - Connectors:
opx-rest/restadvertisecapabilities.simulation: true. - External packs: ship
simulation/pack.simulation.jsonthe same way; do not invent a private mock HTTP server. If APS lacks an API, write an FR/CR.
KnowX (knowledge extract / associate) lives in @x12i/memorix-knowx-pack (agent knowx, child of opx).
Quick start
Prefer the monorepo stack (opx-source :5102, service :5100, Studio :5101, stack-status :5103):
# from repo root
node scripts/dev-stack.mjs
# opens /_live for service + opx-source
# with Nexum worker (zone nexum · worker :7500 · read :7502 · compiler :7504)
node scripts/dev-stack.mjs --nexumopx-source complies via @x12i/core-service (zone port, /health, /_live).
Services (pack): opx-enrich-priority (enrich), nexum (analyze · MEMORIX_NEXUM_URL default :7500). Nexum is the knowledge-graph analyze worker (successor to Graphifier; Graphifier is not supported).
Sample pipelines: opx-nexum-analyze (Nexum + write-record mode nexum).
Pack-only:
npm install && npm test
node scripts/harness.mjs up # OPX_SOURCE_PORT default 5102
node scripts/harness.mjs accept # run acceptance against isolated org
node scripts/harness.mjs downHow it connects
opx-source (:5102)
→ Memory pull (credentialRef / fixture connector)
→ pipelines in metadata/
→ data + relationships
→ Studio Explore / OperateViews in this pack are also the descriptor source for data-journey coverage expected slots when metadata is installed.
