Skip to content

v0.8: docs/LIFE_TIER_SPEC.md + life-package.schema.json::tier + Schema D appendix #104

@devin-ai-integration

Description

@devin-ai-integration

This sub-issue tracks the v0.8 Tier system — the multi-dimensional credit-rating
mechanism that scores every .life on 6 independent dimensions, derives a
weighted composite score, and maps it to a memorable 12-tier Cosmic Evolution
naming scheme (Quark → Singularity).

The tier replaces v0.7's single-dimension verification_level and provides a
machine-readable signal for loaders, registries, and runtime fallback decisions.

Scope

  • New file: docs/LIFE_TIER_SPEC.md — full normative spec
  • Update: schemas/life-package.schema.json — add tier block; deprecate verification_level (back-compat: tier.dimensions.identity_verification)
  • New file: docs/appendix/TIER_NAMING_SCHEMA_D.md — Schema D Cosmic Evolution naming registry
  • Update: tools/build_life_package.py — auto-compute tier block from package contents
  • New tests: tests/sanity/tier/*.json
  • CHANGELOG.md v0.8 Draft entry

Schema sketch

life-package.json::tier:

{
  "tier": {
    "score": 67,
    "level": "VII",
    "name": "Main Sequence",
    "glyph": "",
    "dimensions": {
      "identity_verification": "kyc_verified",
      "asset_completeness": "comprehensive",
      "consent_completeness": "notarized",
      "detail_level": "high_fidelity",
      "audit_chain_strength": "signed_chain",
      "jurisdiction_clarity": "declared"
    },
    "computed_at": "...",
    "computed_by": "tools/build_life_package.py@..."
  }
}

Six dimensions

# Dimension Levels (low → high)
1 identity_verification unverified → self_attested → email_verified → id_verified → kyc_verified → notarized
2 asset_completeness minimal → partial → standard → comprehensive → archive_grade
3 consent_completeness none → text_only → signed → notarized → multi_party_attested
4 detail_level low_fidelity → medium → high_fidelity → cinematic
5 audit_chain_strength minimal → linked → signed_chain → notarized_chain
6 jurisdiction_clarity unspecified → declared → cross_validated → court_recognized

Default weights: consent ×2, identity ×2, others ×1. Score normalised 0–100.

Schema D Cosmic Evolution (12 tiers)

Tier Name Glyph Score
I Quark 0–8
II Atom 9–16
III Molecule ⋮⋮ 17–24
IV Stardust 25–32
V Nebula 🌫 33–40
VI Protostar 41–50
VII Main Sequence 51–60
VIII Red Giant 61–68
IX White Dwarf 69–76
X Neutron Star 77–84
XI Pulsar 85–92
XII Singularity 93–100

Decisions referenced

  • All 6 dimensions adopted (final per Topic 3 discussion).
  • Naming theme: sci-fi / cosmic; rejected: tarot, zodiac, moon phases, minerals, pure geometric, Schema E (Data Architecture), Schema F (hybrid).
  • Spec freezes machine fields (score, level, dimensions); name + glyph live in extensible appendix.
  • Tier is fully public; no hiding.
  • score, level, dimensions MUST be auto-computed by builder; issuer MUST NOT hand-fill.

(See docs/LIFE_ASSET_ARCHITECTURE.md topic 3 tier section for full rationale.)

Acceptance criteria

  • docs/LIFE_TIER_SPEC.md is normative and complete
  • schemas/life-package.schema.json adds tier block with frozen machine fields
  • Schema D appendix lists all 12 tiers with score ranges
  • tools/build_life_package.py computes the tier block at build time
  • At least 15 sanity tests (positive + negative covering each tier boundary)
  • tools/batch_validate.py runs all tier sanity tests
  • examples/minimal-life-package/ rebuilt with a real tier block
  • Back-compat: existing v0.7 verification_level still validates as alias for tier.dimensions.identity_verification
  • CHANGELOG.md v0.8 Draft entry
  • CI green

Parent epic: see top of #N1.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions