Geometry & Quality

Project Systems

The sigil must be visually meaningful, not merely deterministic. Geometry and quality gates prove the artifact preserves WRW topology, avoids accidental scribble, supports 2D/3D presentation, and stays reproducible.

A deterministic system can still produce bad output — so Sigil proves its visuals.

The core distinction

Independent primitives, never a synthetic bridge

Each WRW anchor primitive must remain an independent stroke unless canon explicitly defines a connection. Flattening unrelated strokes into one path is the failure mode that creates accidental bridges and unreadable scribble.

Good · independent primitives

One stroke per anchor primitive; no invented connectors; star ellipse and wolf curls stay independent. Result: a readable, canon-faithful mark that passes the gate.

Bad · synthetic bridge (rejected)

All primitives flattened into one path with invented joins. Result: diagonal artifacts and scribble — rejected by long-segment / bridge detection.

Machine-checkable proof

Topology report

The report is recorded alongside the mesh statistics in the PersonalCodex.

Stroke = primitive count

Generated stroke count equals the anchor primitive count.

Zero synthetic bridges

No connectors invented to join unrelated primitives.

Max segment ≤ 0.14

The direct detector for accidental cross-canvas connectors.

Motifs detected

Star and both wolf motifs survive generation.

Two layers

Raw vs. normalized geometry

The ASHStabilizationNormalizer produces a presentation form, recording both hashes so the two layers are independently auditable.

Raw geometry

The direct generated identity artifact — raw_sigil_hash.

Normalized

Presentation-refined form — normalized_sigil_hash.

Keeping them distinct lets Sigil improve presentation without losing reproducibility: a normalization change moves the normalized hash while the raw hash stays pinned to the canonical identity.

Quality gates & verification

Proof controls, not just CI

Each gate is a real script that passes or fails with a non-zero exit, and most leave a durable artifact a technical evaluation can point to.

Topology guard

Proves WRW primitive topology and no-bridge behavior; rejects appendTransition.

Visual artifact gate

Validates the quality-report JSON, geometry metrics, and a human visual review.

Uniqueness tests

Proves different profiles produce distinct hashes, mesh digests, and lore.

Lore hygiene

Proves user-facing lore is composed narrative, not raw debug/excerpt output.

Forsetti compliance

Proves Sigil does not patch the host framework or escalate privileges.

Final release gate

Combines quality, app, repo, and compliance checks into one pass/fail.

What the quality report must prove. The gate parses sigil-quality-report.json and fails unless every check holds: schema sigil.quality_report.v1; anchor & stroke counts ≥ 14; no synthetic bridges; max normalized segment ≤ 0.14; star and both wolf motifs detected; Kripke controls geometry; guarded grammar controls geometry; and a human manual_visual_review_status = passed.

RAVEN FORGE · INDEPENDENT SOFTWARE · ARCHITECTURE · RESEARCH