@x12i/memorix-data-journey

Evidence-backed data-journey cone and expected-vs-filled coverage.

What it is

Tier-1 projection engine (no product vocabulary):

1. Cone — actual observations → matrix rows / hierarchical columns / sparse DB|SVC cells
2. Coverage — Catalox/view expected slots − evidenced paths → unfilled (“nothing fills it”)

Descriptors are provided as an expected catalog only. They never paint cells.

Install

npm i @x12i/[email protected]

| Audience | Use this package? | |----------|-------------------| | Remote app | No — /api/data-journey/* | | Platform / service | Yes | | Cone audits / tests | Fixtures + projectMatrix / coverExpectedAgainstMatrix |

API surface (library)

import {
  projectMatrix,
  expectedPathsFromViews,
  coverExpectedAgainstMatrix,
  loadFixtureObservations,
} from "@x12i/memorix-data-journey";

| Export | Purpose | |--------|---------| | projectMatrix | Observations → sparse matrix | | expectedSlotsFromViews / expectedPathsFromViews | Views → expected journey paths | | coverExpectedPaths / coverExpectedAgainstMatrix | Expected − filled | | Adapters | content / pipeline / relationship / compose / fixtures |

HTTP (via service)

| Method | Path | |--------|------| | GET | /api/data-journey/object-types | | GET | /api/data-journey/journeys | | POST | /api/data-journey/matrix/query | | POST | /api/data-journey/matrix/columns/query | | POST | /api/data-journey/matrix/cells/query | | GET | /api/data-journey/evidence/{evidenceRef} | | GET | /api/data-journey/expected-slots | | POST | /api/data-journey/coverage |

Fixtures

Golden journey: fixtures/playbooks-pb-2/ (observations + views snapshot + expected matrices).

Not a second source of truth

Does not write subject data, invent journey phases from pipeline definitions, or fill cells from schemas/mappings.

Docs

| Doc | Role | |-----|------| | docs/matrix-semantics.md | Cone law + expected vs filled | | ../docs/evidence-capability-matrix.md | Audit register | | ../docs/runtime-data-journey.md | Stage narrative | | Hub | https://docs.memorix.x12i.com |

npm test