ƒxyzƒxyz Docs
Architecture

Current State

Latest implementation tracker for scoring, identity, governance, and the remaining open phases.

This page distills the latest architecture tracker in the repo into a docs-friendly form. It exists so the docs app has a current implementation page that is closer to March 2026 reality than older audits or theory notes.

Confirmed As Implemented

AreaStatusWhat changed
Canonical contribution propertyDonem.contribution_level is the normalized field across the stack
Shared contribution typeDoneContributionLevel is the canonical type across surfaces
CES scoring alignmentDoneRanking cron uses the same CES scoring function as the service layer
Member standing modelDoneStanding is lifecycle state, not a synonym for contribution level
Member identity resolverDoneIdentity data now exposes standing, ring, expertise, and persona context
Governance re-enableDoneGovernance-related wiring was brought back into the active architecture
Docs / weight syncDoneEqual-weight scoring defaults and CES language were synced across architecture docs

The Current Member Model

The repo now treats these as separate axes:

  • Standing: lifecycle state such as GUEST, ACTIVE, or SUSPENDED
  • Contribution level: OBSERVER through FOUNDER
  • Ring: percentile-relative ranking bucket
  • Expertise: domain profile and rites

That separation matters because older docs and older work logs often collapse those ideas into one tier field.

Live Scoring Posture

  • CES scoring is active with equal default weights and an HHI diversity bonus.
  • The rankings cron computes synthesized scores from token balances and then writes cache and percentile data back to Neo4j.
  • Investment thresholds can still raise the floor on contribution level where later phases rely on that model.

What Is Still Open

PhaseStatusRemaining work
On-chain identityOpensol-did integration comes later in the stack
NFT live updatesOpenMetadata refresh is not fully triggered by every relevant state change
Privacy / CryptoGrapherOpenDesigned, partially framed, not fully surfaced
Bridge complianceOpenCompliance and production hardening are still active tracks

How To Read Older Docs

Use these rules when older architecture pages or work logs disagree:

  1. Prefer the current code over older synthesis docs.
  2. Prefer the unified architecture tracker over February "state of play" audits.
  3. Treat work logs as evidence of decision history, not as current product truth.

The strongest source documents behind this page are docs/architecture/unified-architecture-state.md, docs/plans/2026-03-11-full-architecture-integration.md, and the live scoring code in packages/neo4j/src/services/contribution-score.ts.

On this page