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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions