Skip to content

feat(enterprise-adapter): versioned Upsilon lineage adapter + fixtures - #4

Merged
SunrisesIllNeverSee merged 5 commits into
mainfrom
feat/enterprise-lineage-adapter
Aug 30, 2026
Merged

SunrisesIllNeverSee merged 5 commits into
mainfrom
feat/enterprise-lineage-adapter

Conversation

@SunrisesIllNeverSee

Copy link
Copy Markdown
Owner

Summary

  • Adds the Upsilon Enterprise Lineage Adapter (upsilon/enterprise-adapter/0.1-draft) that bridges sigrank/0.1-draft portable observations into Upsilon's governed enterprise namespace.
  • The portable record is preserved verbatim. Enterprise derivations (construction, composite scores, outcome correlations, lineage) live in a separate enterprise namespace that never leaks into portable metrics.
  • The adapter validates pilot manifests against the canonical pilot schema, enforcing governance constraints (no personnel_action, no content_inspection).

Namespace separation

sigrank/0.1-draft portable record
  spec, timestamp, source, telemetry, metrics, warnings
        ↓ (adapter accepts this as input)
upsilon/enterprise-adapter/0.1-draft enterprise observation
  portable:   (preserved verbatim)
  enterprise: (separate namespace — cohort, window, lineage, derivations)

Fixtures (4)

  • complete-telemetry — all four pillars, all five metrics
  • partial-cache — cache_write/cache_read unavailable (null)
  • zero-values — zero cache distinct from null
  • invalid-version — rejects non-sigrank/0.1-draft records

Test plan

  • node --test tests/enterprise-adapter.test.mjs → 15/15 pass
  • node --test tests/ (all) → 30/30 pass
  • Adapter rejects invalid version, missing fields, negative telemetry, enterprise leaks
  • Pilot manifest validation enforces governance constraints

Generated with Devin

SunrisesIllNeverSee and others added 2 commits August 29, 2026 17:48
Add the Upsilon Enterprise Lineage Adapter
(upsilon/enterprise-adapter/0.1-draft) that bridges sigrank/0.1-draft
portable observations into Upsilon's governed enterprise namespace.

Namespace separation:
- portable: preserved verbatim (spec, telemetry, metrics, warnings)
- enterprise: separate namespace (cohort, window, lineage, derivations)
- Construction, composite scores, outcome correlations, and other
  enterprise derivations never leak into portable metrics

The adapter:
- Accepts sigrank/0.1-draft portable records
- Rejects records that don't declare the correct spec version
- Rejects records with enterprise leaks in portable metrics/fields
- Validates telemetry primitives (non-negative integers or null)
- Preserves null/zero distinction for unavailable cache
- Validates pilot manifests against the canonical pilot schema
- Enforces governance constraints (no personnel_action, no content_inspection)

Fixtures (4):
- complete-telemetry: all four pillars, all five metrics
- partial-cache: cache_write/cache_read unavailable (null)
- zero-values: zero cache distinct from null
- invalid-version: rejects non-sigrank/0.1-draft records

Schema:
- enterprise-adapter/upsilon-enterprise-observation.schema.json defines
  the enterprise observation structure with portable + enterprise namespaces

Tests (15):
- Adapter version + namespace contracts
- Fixture-driven tests (complete, partial, zero, invalid)
- Namespace separation (no enterprise leak into portable)
- Adapter rejection (missing fields, negative telemetry, enterprise leak)
- Pilot manifest validation (valid, wrong roles, punitive, inspecting)
- Enterprise observation schema validation

Verification:
- node --test tests/enterprise-adapter.test.mjs → 15/15 pass
- node --test tests/ (all) → 30/30 pass

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…ad arg fix

Add tests/enterprise-adapter-conformance.test.mjs — validates the portable
portion of enterprise observations against all 13 sigrank-standard
fixtures (pinned ref 224505a). Ensures the adapter preserves portable
metrics, telemetry, warnings, and namespace isolation across the same
fixture pack consumed by sigrank-mcp and sigrank-app.

Add .github/workflows/enterprise-adapter.yml — runs enterprise adapter
unit tests + standalone conformance gate on every push/PR touching the
adapter. Checks out sigrank-standard at the pinned ref.

Fix dead 4th argument in validatePilotManifest checkNode call (errors
array is captured via closure, not passed as parameter).

Rebased onto origin/main so this PR is independently reviewable without
PR #3 (worker recovery).

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@SunrisesIllNeverSee
SunrisesIllNeverSee force-pushed the feat/enterprise-lineage-adapter branch from 88b1551 to 10c9fe8 Compare August 29, 2026 21:48
SunrisesIllNeverSee and others added 3 commits August 29, 2026 21:00
actions/checkout cannot resolve a bare commit SHA with the default
depth=1 fetch. Adding fetch-depth: 0 allows the pinned ref (224505a)
to be resolved correctly.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
actions/checkout cannot resolve a bare commit SHA as a ref. Changed to
checkout main with fetch-depth: 0, then git reset --hard to the pinned
SHA. Updated pinned ref from 224505a (12 fixtures) to c73f152 (13
fixtures, includes enterprise-adapter-lineage fixture).

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Replace process.exit(2) with test.skip when sigrank-standard is not
available. This prevents the build job (which runs all tests via
npm run test:coverage) from failing when the cross-repo checkout
hasn't been performed.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@SunrisesIllNeverSee
SunrisesIllNeverSee merged commit 03c0e99 into main Aug 30, 2026
1 check passed
@SunrisesIllNeverSee
SunrisesIllNeverSee deleted the feat/enterprise-lineage-adapter branch August 30, 2026 01:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant