Eve library

Phase 142 implementation evidence

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

This file maps completed checklist claims to executable repository evidence. The sections are chronological: early implementation notes record intentionally unclaimed gaps, and the later completion sections identify the code and tests that subsequently closed each gap. Partial adjacency is not treated as completion.

Metron core — event model, schema, pipeline, ingestion, SDK#

  • libs/neith/metron-core/src/model.ts defines the event envelope, six-event semantic taxonomy, recursive property values, consent context, and SDK route lineage.
  • libs/neith/metron-core/src/schema.ts implements versioned schemas, JSON Schema and TypeScript generation, required/recommended fields, PII and physical-value metadata, nested values, evolution rules, deprecation, and a usage heatmap.
  • libs/neith/metron-core/src/pipeline.ts implements schema enforcement, deterministic sampling, test-traffic filtering, consent gating, late-event rejection, bounded deduplication, PII redaction/hashing, region-partitioned durable storage, and replay. These primitives do not yet complete the broader fraud, encryption, consent-standard, sampling-mode, or reconciliation items.
  • libs/neith/metron-core/src/ingestion.ts implements authenticated source configuration, origin restrictions, per-minute quotas, residency assignment, durable acceptance, and reasoned dead letters.
  • libs/neith/metron-core/src/sdk.ts implements browser/Node capture semantics, identity/group/alias/page/screen calls, batches, durable offline retry, and normalization for Segment, Mixpanel, GA4, PostHog, and Amplitude payloads.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-core --skip-nx-cache
  PASS 4 tests
pnpm exec nx typecheck neith-metron-core --skip-nx-cache
  PASS

Metron core — production ingestion and processing extensions#

  • libs/neith/metron-core/src/compression.ts implements deterministic negotiation and native gzip, Brotli, and Zstandard compression/decompression.
  • libs/neith/metron-core/src/protobuf.ts implements a documented metron.v1 proto3 Event/EventBatch contract and bounds-checked wire codec preserving nested context/property types.
  • libs/neith/metron-core/src/sources.ts implements curl/HTTP JSON and protobuf handling, Nginx QUIC/HTTP3 TLS termination configuration, constant-time Stripe/Shopify/custom webhook verification, checkpointed NDJSON/JSON/protobuf object/file backfill, and allow-listed header-sanitizing server-side tags. Together with the Postgres logical decoder in metron-destinations, this covers webhook and CDC source ingestion.
  • libs/neith/metron-core/src/stream.ts provides broker-neutral Kafka/ Redpanda/NATS/sovereign-log publish, consumer-group polling, ordered ack, delayed retry, and dead-letter behavior.
  • libs/neith/metron-core/src/advanced-pipeline.ts adds injected IP/device enrichment, URL/referrer/campaign normalization, bot/fraud/test filtering, SHA-256 hashing and authenticated field encryption, purpose plus TCF/US consent validation and expiry, head/tail/stratified sampling, watermark-based late reconciliation, and allow-listed parallel destination fan-out.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-core --skip-nx-cache
  PASS 10 tests
pnpm exec nx typecheck neith-metron-core --skip-nx-cache
  PASS

Metron identity — identity graph and account stitching#

  • libs/neith/metron-identity/src/identity-graph.ts implements anonymous to authenticated merges, normalized device/user/session identity ownership, deterministic and scored probabilistic candidate matching, alias chains, protected-trait conflict detection, hierarchical group membership, B2B rollups, reviewed identity splitting, retention expiry, and erasure tombstones with deterministic receipts.
  • libs/neith/metron-identity/src/sessions.ts implements ordered sessionization with inactivity, acquisition-source change, and product-defined boundaries.
  • The initial backend split primitive did not claim 142.2.9; the manual operator UI that subsequently completed it is documented in the analytics-workspace section below.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-identity --skip-nx-cache
  PASS 6 tests
pnpm exec nx typecheck neith-metron-identity --skip-nx-cache
  PASS

Metron warehouse — native storage and query primitives#

  • libs/neith/metron-warehouse/src/column-store.ts implements workspace/time partitions, hot/warm/cold lifecycle and retention purging, user/event/region skip indexes, aggregate event-count views, object-tier movement, and AES-GCM encryption with an injected customer key provider.
  • libs/neith/metron-warehouse/src/query.ts implements partition-pruned query plans, event/funnel/retention/path/flow DSL evaluation, result caching, slot-based concurrency and cost limits, cancellation/timeout/retry semantics, and versioned saved queries, workbooks, and result snapshots.
  • libs/neith/metron-warehouse/src/sketches.ts implements bounded HyperLogLog, T-Digest quantile, and Theta distinct-count sketches. The HLL uses an avalanche finalizer so sequential identifiers do not bias register selection.
  • The initial storage/query primitives did not claim external ClickHouse, DuckDB/Parquet, S3, Iceberg/Delta, SQL/protocol integrations, codec application, warm-tier routing, or the explain-plan UI. Their subsequent completion is documented in the warehouse-backends and analytics-workspace sections below.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-warehouse --skip-nx-cache
  PASS 6 tests
pnpm exec nx typecheck neith-metron-warehouse --skip-nx-cache
  PASS

Metron insights — reports and advanced analytics#

  • libs/neith/metron-insights/src/reports.ts implements interval trends and property breakdowns, ordered/unordered funnels with conversion and drop-off, four retention modes, saved/subscribed cohort definitions, path trees and Sankey edges, five-stage lifecycle classification, DAU/MAU/power-user engagement, session depth/duration/drop reports, cumulative revenue/LTV and MRR/ARR curves, and feature reach/adoption/stickiness matrices.
  • libs/neith/metron-insights/src/advanced.ts implements seasonal anomaly and change-point detection, Pearson property correlation search, local linear regression discontinuity uplift, Kaplan-Meier survival, normalized multi-touch attribution, logistic propensity and churn scoring, constrained next-best-action ranking, RFM segmentation, and standardized cohort effect comparison.
  • The initial reports implementation did not claim dashboard items. Their subsequent user-facing surface and Playwright coverage are documented in the analytics-workspace section below.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-insights --skip-nx-cache
  PASS 6 tests
pnpm exec nx typecheck neith-metron-insights --skip-nx-cache
  PASS

Metron replay — privacy, analysis, and collaboration workflows#

  • libs/neith/metron-replay/src/recorder.ts implements purpose-specific consent gating, DOM/canvas event acceptance, hard rejection of audio/video media, bounded recording, recursive-safe cloning, and a native system/secure view masking primitive.
  • libs/neith/metron-replay/src/privacy.ts masks payment-card candidates, IBANs, SSNs, emails, password/private fields, configured attributes, selectors, and custom regular expressions before events enter a session.
  • libs/neith/metron-replay/src/analysis.ts implements rage/dead/u-turn detection, console/network/crash/trace correlation, normalized interaction grids, and segment plus failed-funnel replay selection.
  • libs/neith/metron-replay/src/workflows.ts implements tokenized bookmarked clips, time-aligned cross-team annotations, Neith PM ticket drafts, the most restrictive plan/segment retention policy, and a priority token-bucket edge upload queue.
  • The initial replay primitives did not claim browser DOM/canvas capture hooks or native mobile screen capture. Their subsequent implementation is documented in the replay-capture section below.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-replay --skip-nx-cache
  PASS 7 tests
pnpm exec nx typecheck neith-metron-replay --skip-nx-cache
  PASS

Metron experiment — flags, allocation, governance, and inference#

  • libs/neith/metron-experiment/src/flags.ts implements kill switches, user/account/region/device/custom targeting, segment gates, scheduled ramps, sticky deterministic allocation, dependencies, mutually exclusive sets, snapshot-based local SDK evaluation, multi-reviewer approvals, scheduled activation, and a previous-hash-linked record of every mutation.
  • libs/neith/metron-experiment/src/experiments.ts implements weighted A/B and n-arm allocation, multivariate factor payloads, durable holdouts, periodic switchbacks, automatic experiment/flag pause on guardrail regression, and minimum-sample heterogeneous treatment effects by selected attributes.
  • libs/neith/metron-experiment/src/statistics.ts implements Welch-style frequentist inference with confidence intervals, seeded beta-binomial Monte Carlo probability, alpha-spending sequential boundaries, CUPED covariance adjustment with measured variance reduction, and weighted stratification.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-experiment --skip-nx-cache
  PASS 8 tests
pnpm exec nx typecheck neith-metron-experiment --skip-nx-cache
  PASS

Metron destinations — delivery orchestration, reverse ETL, and CDC#

  • libs/neith/metron-destinations/src/catalog.ts defines authentication, endpoint, payload-limit, and idempotency contracts for all 29 named warehouse, object, stream, HTTP, CRM, messaging, advertising, and sovereign providers. A catalog alone did not claim items 142.7.1–142.7.7; the executable transports that subsequently completed them are documented below.
  • libs/neith/metron-destinations/src/engine.ts implements allow-list projection before enqueue, idempotency-key deduplication, bounded batches and concurrency, exponential retry, terminal/retry-exhausted dead letters and replay, per-destination records/bytes/cost, multi-version health, deterministic canary routing, pinned transports, and explicit canary promotion.
  • libs/neith/metron-destinations/src/reverse-etl.ts implements a validated warehouse model catalog with stable row fingerprints and mapped SaaS operations plus ordered, transaction-buffered Postgres logical decoding, duplicate LSN suppression, and committed checkpoints.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-destinations --skip-nx-cache
  PASS 7 tests
pnpm exec nx typecheck neith-metron-destinations --skip-nx-cache
  PASS
  • libs/neith/metron-privacy/src/consent.ts validates TCF 2.2, GPP, and US privacy strings, stores expiring per-purpose/per-vendor decisions, supports wildcard vendors, and enforces DNT/GPC global opt-outs with audit records.
  • libs/neith/metron-privacy/src/governance.ts implements verified, deadline aware access/portability/rectification/erasure workflows; owned inventory and field-level lineage; five-zone residency; multi-reviewer event privacy gates; legal-hold-aware retention; k-anonymity; Laplace differential privacy; SOC 2, ISO 27001, HIPAA, PCI DSS, and GDPR control mappings; and region-aware age gates with verified, expiring parental consent.
  • libs/neith/metron-privacy/src/classification.ts combines explicit value patterns with a scored logistic semantic classifier whose weights and confidence threshold are inspectable and replaceable.
  • libs/neith/metron-privacy/src/crypto.ts implements authenticated AES-256-GCM field encryption bound to workspace/path/version, wrapped customer keys, rotation handles, escrow policy, and distinct managed/BYOK/HYOK modes.
  • libs/neith/metron-privacy/src/audit.ts initially provided stable-payload hashes and a verified HMAC-linked chain, which did not claim asymmetric non-repudiation. The Ed25519 proof chain that subsequently completed 142.8.13 is documented below.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-privacy --skip-nx-cache
  PASS 8 tests
pnpm exec nx typecheck neith-metron-privacy --skip-nx-cache
  PASS

Metron mobile attribution — privacy-preserving marketing measurement#

  • libs/neith/metron-mobile-attrib/src/skan.ts implements verified, transaction-deduplicated SKAdNetwork 4.x postback ingestion, sequence/fine/ coarse conversion mapping, redownload tracking, and aggregate reporting. The verifier is injected so production can bind Apple's current trust material.
  • libs/neith/metron-mobile-attrib/src/privacy-sandbox.ts implements Attribution Reporting API source/trigger matching, expiry, priority, deduplication, deterministic report delay, event reports, and aggregate contributions.
  • libs/neith/metron-mobile-attrib/src/attribution.ts implements install and post-install journeys, single-use expiring HTTPS/app deferred links, consent-filtered SHA-256 audience seeds, FX-normalized cost/CPM/CPC ingestion, install-farm and click-injection signals, contextual recency attribution with no device fingerprint, separate click/view budgets, and normalized linear, time-decay, position-based, and Markov-style multi-touch credit.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-mobile-attrib --skip-nx-cache
  PASS 7 tests
pnpm exec nx typecheck neith-metron-mobile-attrib --skip-nx-cache
  PASS

Metron surveys — feedback collection, analysis, and incentives#

  • libs/neith/metron-surveys/src/builder.ts implements validated choice, multi-choice, text, numeric, rating, boolean, NPS, CSAT, and CES questions; conditional branches; runtime answer validation; required-field completion; and correctly bounded NPS/CSAT/CES and Superhuman PMF templates.
  • libs/neith/metron-surveys/src/runtime.ts implements attribute/segment targeting, event/segment/signup/last-active triggers, rolling impression and cooldown limits, exact/base/default locale fallback with partial translation, and idempotent in-app/email/SMS/chat adapter delivery.
  • libs/neith/metron-surveys/src/analysis.ts implements inspectable sentiment scoring, theme extraction with examples, deterministic summaries, response joins to behavioral traits for warehouse output, and idempotent gift/credit/ coupon issuance guarded by response speed, straight-line, shared-IP velocity, and per-user rate signals.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-surveys --skip-nx-cache
  PASS 6 tests
pnpm exec nx typecheck neith-metron-surveys --skip-nx-cache
  PASS

Metron migration — protocols, schemas, reports, and identity imports#

  • libs/neith/metron-migration/src/protocols.ts implements authenticated Segment batch/source parsing and destination serialization plus Mixpanel base64/JSON, Amplitude HTTP v2, PostHog capture/batch, and GA4 Measurement Protocol normalization with event taxonomy, identity, time, properties, context, insertion IDs, and per-row error preservation.
  • libs/neith/metron-migration/src/importers.ts validates self-describing Iglu JSON Schemas and semantic versions, attaches Snowplow Enrich mappings, bulk maps warehouse rows with nested targets and typed transforms, normalizes Mixpanel/Amplitude/Looker/Tableau dashboards and layouts, translates ordered funnels and four retention semantics, and merges identity-table rows while preserving every alias and exposing cross-profile identity conflicts.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-migration --skip-nx-cache
  PASS 7 tests
pnpm exec nx typecheck neith-metron-migration --skip-nx-cache
  PASS

Metron operator — administration and operational workspace#

  • libs/neith/metron-operator/src/admin.ts implements roles, granular permissions, teams, SCIM provisioning/deactivation, optimistic versions, and active-member authorization.
  • libs/neith/metron-operator/src/billing.ts implements idempotent usage metering, quota utilization, seats, included volume/overage estimates, event-level cost rollups, and upward-only self-service plan changes.
  • libs/neith/metron-operator/src/governance.ts implements risk-ordered steward review with dual approval for high-risk work and a read-only, permissioned, optimistic-version SQL lab with team/workspace sharing and result snapshots.
  • libs/neith/metron-operator/src/operations.ts implements email/chat/ PagerDuty/webhook routing, threshold rules, active on-call rotations, critical escalation, severity-ordered/stale source health, and chronological public incidents through resolution.
  • libs/neith/metron-operator/src/workspace.ts renders the operator surface. Following frontend-skill, it uses a restrained cardless workspace, persistent ink-dark navigation, one cyan action/status accent, contextual inspectors, compact transitions, mobile navigation, and reduced-motion behavior. It exposes teams/SCIM, plan/quota/cost, steward decisions, SQL, alert routing/on-call, source health, and public incident workflows.

Verification on 2026-07-12:

text
pnpm exec nx test neith-metron-operator --skip-nx-cache
  PASS 7 tests
pnpm exec nx typecheck neith-metron-operator --skip-nx-cache
  PASS
pnpm exec nx e2e neith-metron-operator --skip-nx-cache
  PASS 5 Playwright tests (Chromium, one worker)

Metron privacy — non-repudiable audit proofs#

  • libs/neith/metron-privacy/src/audit.ts adds an append-only SHA-256 chain signed with Ed25519. Exported proofs contain only the public key and signed entries, bind every entry to its sequence, predecessor, payload digest, and key identifier, and can be verified offline without access to signing material. The existing symmetric tamper-evident log remains compatible.
  • Coverage verifies an authentic multi-entry proof and rejects a modified historical actor while using only the exported public proof.

Verification on 2026-07-12:

text
pnpm exec vitest run --config libs/neith/metron-privacy/vitest.config.ts
  PASS 9 tests
pnpm exec tsc --noEmit -p libs/neith/metron-privacy/tsconfig.json
  PASS

Metron warehouse — sovereign backends and query protocols#

  • libs/neith/metron-warehouse/src/backends.ts provides parameterized ClickHouse insertion/querying, read-only DuckDB over Parquet, an S3-compatible cold tier, versioned Iceberg/Delta manifests, event-aware compression selection, and parameterized event SQL compilation.
  • libs/neith/metron-warehouse/src/api.ts exposes the same query and explain service through REST, GraphQL, JSON-encoded gRPC, and MCP tool contracts.
  • Existing query planning supplies partition pruning, hot/warm/cold route visibility, deterministic caching, estimated cost, slot enforcement, and cancellation/retry behavior.

Verification on 2026-07-12:

text
pnpm exec eslint libs/neith/metron-warehouse/src/{backends,api,index}.ts --max-warnings=0
  PASS
pnpm exec vitest run --config libs/neith/metron-warehouse/vitest.config.ts libs/neith/metron-warehouse/src/metron-warehouse.spec.ts
  PASS 9 tests
pnpm exec tsc --noEmit -p libs/neith/metron-warehouse/tsconfig.json
  PASS

Metron destinations — executable provider sinks#

  • libs/neith/metron-destinations/src/provider-transport.ts turns the 29-provider catalog into executable transports with endpoint-variable validation, OAuth/service-account/API-key/SigV4/connection authentication, provider idempotency headers, JSON or NDJSON batching, payload limits, partial rejection handling, retry classification, abort propagation, and health checks.
  • Tests dispatch representative warehouse, object-store, stream, webhook, CRM, messaging, and advertising batches and cover missing credentials and HTTP 429 retry semantics. Every named provider shares the same descriptor-backed transport path, including sovereign endpoints.

Verification on 2026-07-12:

text
pnpm exec eslint libs/neith/metron-destinations/src/{provider-transport,index}.ts --max-warnings=0
  PASS
pnpm exec vitest run --config libs/neith/metron-destinations/vitest.config.ts libs/neith/metron-destinations/src/metron-destinations.spec.ts
  PASS 9 tests
pnpm exec tsc --noEmit -p libs/neith/metron-destinations/tsconfig.json
  PASS

Metron analytics workspace — dashboards, identity split, and query plans#

  • libs/neith/metron-operator/src/analytics-workspace.ts follows the frontend-skill app guidance with a restrained cardless workspace, one cyan accent, a north-star anchor, compact canvas/inspector/filter transitions, mobile layout, and reduced-motion behavior.
  • Dashboard workflows include draggable tiles, Notes/Wiki/Sheets/Slides embed, region/plan parameters, email/chat digests, per-tile refresh, cache state, cross-filter drilldown, executive/team/personal spaces, expiring public share, and dashboard-as-code YAML.
  • Identity profiles expose a reviewed, audited manual split inspector. Explain plan exposes pruned partitions, hot/warm tiers, estimated rows/cost, cache state, and query execution feedback.

Verification on 2026-07-12:

text
pnpm exec eslint libs/neith/metron-operator/src/{analytics-workspace,index}.ts --max-warnings=0
  PASS
pnpm exec vitest run --config vitest.config.ts src/metron-operator.spec.ts
  PASS 7 tests
pnpm exec tsc --noEmit -p tsconfig.json
  PASS
pnpm exec playwright test --config playwright.config.ts
  PASS 8 Chromium tests, one worker (3 analytics + 5 existing)

Metron replay — browser mutation/canvas and mobile view capture#

  • libs/neith/metron-replay/src/capture.ts records deterministic DOM mutation operations with stable node/parent identifiers and allow-listed canvas commands. Selector, attribute, default PII, and canvas text masking happen before events leave the capture boundary; audio/video/pixel capture is not part of the representation.
  • iOS and Android capture serialize view geometry and hierarchy while masking secure and system-owned views recursively. Tests assert system keyboard text is removed and no pixel payload is produced.

Verification on 2026-07-12:

text
pnpm exec eslint libs/neith/metron-replay/src/{capture,index}.ts --max-warnings=0
  PASS
pnpm exec vitest run --config libs/neith/metron-replay/vitest.config.ts libs/neith/metron-replay/src/metron-replay.spec.ts
  PASS 9 tests
pnpm exec tsc --noEmit -p libs/neith/metron-replay/tsconfig.json
  PASS

Metron SDK matrix — native, server, game, and mobile clients#

  • sdks/metron/ adds Swift with Objective-C exposure, Kotlin with Java interop, Rust, Go, Python, Ruby, PHP, C# for .NET/Unity, C++ for native/Unreal, Dart for Flutter, React Native TypeScript, and Elixir clients.
  • Every client emits the same versioned track envelope, maintains an acknowledgement-safe offline batch queue, carries SDK lineage, source-key authorization, and an idempotency key. Platform clients use native HTTP facilities where available; embeddable Rust/C++/PHP/Elixir surfaces expose batch and header material for host transports.
  • sdk-matrix.ts is the shared conformance inventory. Its automated gate reads all twelve shipped sources and rejects missing event, queue, lineage, authentication, or idempotency contracts.

Verification on 2026-07-12:

text
pnpm exec vitest run --config libs/neith/metron-core/vitest.config.ts libs/neith/metron-core/src/metron-core.spec.ts libs/neith/metron-core/src/metron-ingestion.spec.ts
  PASS 11 tests
pnpm exec tsc --noEmit -p libs/neith/metron-core/tsconfig.json
  PASS
cargo check --manifest-path sdks/metron/rust/Cargo.toml
  PASS
python3 compile(...sdks/metron/python/metron.py...)
  PASS
g++ -std=c++17 -x c++ -fsyntax-only sdks/metron/cpp/metron.hpp
  PASS (pragma-once warning when compiled as the primary file)
pnpm exec tsc --ignoreConfig --noEmit ... sdks/metron/react-native/index.ts
  PASS

The host has no Swift, Kotlin, Go, Ruby, PHP, Dart, or Elixir compiler. dotnet is a runtime-only install with no SDK, so C# compilation is also unavailable; those sources are covered by the cross-language conformance gate, with Cargo and C# project manifests included for downstream CI/toolchain builds.

Completion audit — 2026-07-14#

  • The authoritative checklist contains 205 unique task identifiers, all checked, with no unchecked, partial, or blocked item.
  • All 12 scoped Vitest configurations pass: 13 files and 94 tests across core, identity, warehouse, insights, replay, experiment, destinations, privacy, mobile attribution, surveys, migration, and operator.
  • All 12 library TypeScript projects pass tsc --noEmit, and ESLint reports no errors across their source trees.
  • The operator Playwright configuration passes all 8 Chromium tests with one worker, covering the analytics workspace and operator workflows on desktop and reduced-motion mobile layouts.
  • Native SDK verification passes the 12-language source conformance test, Rust cargo check, Python bytecode compilation, C++17 syntax checking, and strict standalone React Native TypeScript compilation. Compilers unavailable on this host remain explicitly recorded above rather than being represented as run.
  • The audit found and removed a fixed click-injection confidence value: the mobile-attribution score is now derived from observed click-to-install latency, remains bounded, and has regression coverage proving distinct evidence yields distinct scores.