# Qeshet Identity System

**Purpose:** Define the Covenant Systems identity mark as a modular SVG, motion, print, and source-awareness system.

Qeshet is not “rainbow decoration.” It is the Covenant signature mark, a wayfinding grammar, a section-role signal, and a symbol of structure, promise, continuity, and truth-seeking.

The goal is to make the mark beautiful enough to give Covenant a memorable identity, but restrained enough that long documents remain calm and readable.

---

## 1. Identity thesis

Qeshet should communicate:

```text
covenant / continuity / structure / verification / spectrum / source-traceability
```

It should feel like:

```text
an archival seal
a terminal-native system glyph
a spectrum path through knowledge
a calm verification mark
a source packet moving through a document system
```

It should not feel like:

```text
generic rainbow logo
SaaS badge
casino reward animation
cyberpunk neon ornament
random gradient decoration
```

---

## 2. Core visual anatomy

Every Qeshet variant should be built from a small vocabulary.

```text
Arc        = covenant, continuity, spectrum, promise
Packet     = source/data/evidence moving through the system
Shell      = terminal frame, containment, seriousness
Seal ring  = document authority, provenance, export readiness
Spine      = structural wayfinding through a document
Node       = source, claim, appendix, evidence unit
```

### 2.1 Arc

The arc is the primary identity element.

Rules:

```text
Use restrained spectrum segments.
Prefer thick enough strokes to survive PDF.
Avoid bright rainbow saturation.
Do not use decorative rainbow text.
```

### 2.2 Packet

The packet is a small moving or static dot/lozenge.

Meaning:

```text
source packet
citation packet
knowledge unit
evidence moving through the system
```

Allowed uses:

```text
animated website mark
loading/processing state
source verification transition
export readiness
```

Avoid:

```text
fast orbiting
constant motion near body text
random confetti-like packets
```

### 2.3 Shell

The shell frames Qeshet in web/dashboard modes.

Meaning:

```text
terminal containment
source-aware system boundary
dark chrome around warm paper
```

### 2.4 Seal ring

The seal ring is for formal documents.

Meaning:

```text
document identity
source packet integrity
export readiness
archive mark
```

### 2.5 Spine

The spine translates Qeshet into document navigation.

Meaning:

```text
section role
document progression
long-form orientation
```

---

## 3. Variants

## 3.1 QeshetMarkAnimated

**Purpose:** Primary website/app identity mark.

**Render targets:**

```text
topbar
Vault home hero
collapsed dock expand button
component lab
HTML dashboards
```

**Behavior:**

```text
slow arc drift
small packet movement
active-state glow only when useful
reduced-motion static fallback
```

**Attention role:**

- Primary identity anchor on website.
- Permitted as “one beautiful surprise” on the main Vault surface.
- Should not sit next to dense reading text in animated form.

**Suggested component path:**

```text
components/qeshet/qeshet-mark.html
components/qeshet/qeshet.css
components/svg/qeshet-animated.svg
```

**Component props:**

```yaml
variant: animated
size: sm | md | hero
state: idle | active | verified | export-ready
motion: auto | reduced | none
label: Covenant Systems Qeshet mark
```

---

## 3.2 QeshetSealStatic

**Purpose:** Formal identity seal for title pages, PDF, print, and exports.

**Render targets:**

```text
Scholar title page
Dossier cover
Memo masthead
Data report header
PDF footer
Export seal
```

**Behavior:**

```text
static only
works in color or single-color fallback
survives print
```

**Attention role:**

- Authority and identity.
- Should make a title page feel like a designed artifact.
- Can be high-salience on covers, low-salience elsewhere.

**Suggested component path:**

```text
components/svg/qeshet-seal.svg
components/qeshet/qeshet-seal.html
```

**Component props:**

```yaml
variant: seal
size: sm | md | title
tone: full-spectrum | monochrome | muted
label: Covenant Systems Qeshet seal
```

---

## 3.3 QeshetWatermark

**Purpose:** Very low-salience background mark.

**Render targets:**

```text
PDF title page
section divider page
public doctrine page
component lab background
```

**Behavior:**

```text
static
low opacity
not placed behind dense body text unless extremely subtle
```

**Attention role:**

- Atmospheric identity.
- Should not compete with title or TOS.

**Suggested component path:**

```text
components/svg/qeshet-watermark.svg
```

---

## 3.4 QeshetDockIcon

**Purpose:** Collapsed Library rail identity and expand control.

**Render targets:**

```text
collapsed Library dock
small app icon
favicon family
```

**Behavior:**

```text
static or very subtle motion
clear silhouette at small size
```

**Attention role:**

- Dock landmark.
- The collapsed rail should feel intentional, not broken.

**Suggested component path:**

```text
components/svg/qeshet-dock-icon.svg
```

---

## 3.5 QeshetSectionGlyph

**Purpose:** Small role mark for section banners.

**Render targets:**

```text
section openers
TOS entries
document spine
appendix links
```

**Behavior:**

```text
static
role color may override one segment
```

**Attention role:**

- Reinforces section role.
- Should be quiet in body text.

**Suggested component path:**

```text
components/svg/qeshet-section-glyph.svg
```

---

## 3.6 QeshetExportSeal

**Purpose:** Validated/export-ready state mark.

**Render targets:**

```text
export panel
PDF cover
dossier packet
source validation result
```

**Behavior:**

```text
static in PDF
optional calm state transition in HTML
```

**Attention role:**

- Completion reward without pressure.
- Indicates readiness or source validation result.

**Suggested component path:**

```text
components/svg/export-seal.svg
```

---

## 4. Spectrum role grammar

Qeshet color is not generic rainbow. It maps to document meaning.

```text
red/orange = orientation, summary, urgency-with-restraint
gold       = structure, findings, core claims
green      = method, evidence, verification
aqua       = analysis, linked context, synthesis
blue       = citations, sources, references, records
purple     = appendices, meta, deep detail, templates
```

### 4.1 Role use examples

```text
Vault mode active       = orange
Findings section        = gold
Evidence/method section = green
Analysis/synthesis      = aqua
Source register         = blue
Appendix navigator      = purple
```

### 4.2 Color accessibility rule

Never let color carry required meaning alone.

Every color cue should be paired with at least one of:

```text
visible label
position
linework
glyph
state text
section role
source count
heading hierarchy
```

---

## 5. Dopamine / attention rules

The Qeshet system should reward comprehension, not addiction.

Good reward moments:

```text
The user expands a TOS branch and sees the document structure clarify.
The user verifies a source and gets a calm confirmation state.
The user selects a Library mode and sees the active mode become obvious.
The user completes export validation and sees the export seal become available.
```

Avoid:

```text
streaks
badges as noise
fake urgency
variable-ratio effects
urgent pulsing
flashy reward animation
```

### 5.1 Qeshet salience budget

```text
Website hero       = one high-salience Qeshet moment
Topbar             = medium identity mark
Dock               = small landmark
Document body      = low-salience section glyphs
PDF title page     = high-salience static seal or watermark
PDF body           = low-salience static glyphs/spine
```

---

## 6. Motion system

## 6.1 Allowed motion

```text
slow arc drift
small packet traversal
gentle active-state transition
short line reveal on open/close
```

## 6.2 Forbidden motion

```text
fast spinning
urgent pulse
infinite motion beside dense body text
flashing
motion required to understand state
```

## 6.3 Reduced-motion behavior

```text
Animated arc becomes static.
Packet freezes or disappears.
State remains visible through color + label + linework.
```

Suggested CSS pattern:

```css
@media (prefers-reduced-motion: reduce) {
  .qeshet-mark *,
  .qeshet-mark::before,
  .qeshet-mark::after {
    animation: none !important;
    transition: none !important;
  }
}
```

---

## 7. SVG accessibility rules

## Meaningful SVG

Use when the mark communicates identity, source state, or export state.

Requirements:

```html
<svg role="img" aria-labelledby="qeshet-title qeshet-desc">
  <title id="qeshet-title">Covenant Systems Qeshet seal</title>
  <desc id="qeshet-desc">A restrained spectrum arc inside a terminal seal.</desc>
</svg>
```

## Decorative SVG

Use for background watermarks or repeated visual texture.

Requirements:

```html
<svg aria-hidden="true" focusable="false">...</svg>
```

## Complex diagrams

For citation ladders and source graphs:

```text
include title
include desc
also include a visible text explanation near the SVG
```

---

## 8. Suggested tokens

```css
:root {
  --cv-qeshet-red: #cc4b42;
  --cv-qeshet-orange: #e06c1f;
  --cv-qeshet-gold: #d79921;
  --cv-qeshet-green: #98971a;
  --cv-qeshet-aqua: #689d6a;
  --cv-qeshet-blue: #458588;
  --cv-qeshet-purple: #b16286;

  --cv-qeshet-shell: #141817;
  --cv-qeshet-paper: #ebdbb2;
  --cv-qeshet-muted: #a89984;

  --cv-qeshet-stroke-sm: 2;
  --cv-qeshet-stroke-md: 4;
  --cv-qeshet-stroke-lg: 7;
  --cv-qeshet-radius: 14px;
  --cv-qeshet-motion-slow: 9000ms;
}
```

---

## 9. Implementation checklist

```text
[ ] Create static qeshet-seal.svg.
[ ] Create qeshet-watermark.svg.
[ ] Create qeshet-dock-icon.svg.
[ ] Create animated HTML/CSS version.
[ ] Add reduced-motion fallback.
[ ] Add print-safe static fallback.
[ ] Add accessible titles/descriptions.
[ ] Add component README.
[ ] Add examples in /components or /toc-lab.
[ ] Test small-size legibility.
[ ] Test PDF rendering.
```

---

## 10. Quality gate

A Qeshet implementation is acceptable only if:

```text
It is recognizable at small and large sizes.
It does not look like generic rainbow decoration.
It has an accessible-name strategy.
It has reduced-motion fallback if animated.
It has static PDF/print form.
It reinforces orientation, verification, or identity.
It does not distract from body reading.
It can be reused by future AI/Codex work.
```

---

## 11. Starter assets in this package

This package includes prototype SVGs:

```text
components/svg/qeshet-seal.svg
components/svg/qeshet-watermark.svg
components/svg/qeshet-dock-icon.svg
components/svg/spectrum-spine.svg
components/svg/terminal-tree-connector.svg
components/svg/export-seal.svg
```

These are **starter directions**, not final brand locks.
