# AGLA GRAPHIC RESOURCES

Status: PROVISIONAL SOURCE COLLECTION / VALIDATED ICON PACKAGE / VALIDATED FIGURAE NUMERIC SOURCE CONTRACT

This directory contains reproducible graphic derivatives of the AGLA A/T/Q/S
notation and separately bounded source contracts for semantic figures.
Directory placement creates no doctrinal or runtime authority.

For the ATQS notation collection, semantic authority remains with:

- `TENET/TENET_ICONUM_REGIMINUM.md` for pedagogical icon seeds;
- `TENET/TENET_NOTATIONIS_STYLATAE_ATQS.md` for styled alphanumerics and
  regimen markers.

The generated SVG files are production curve masters. They contain outline
paths only: no text elements, font references, embedded font data, or semantic
authority. PNG files are transparent raster derivatives. Pedagogical icons
also have a 512-pixel recognition/reference variant in addition to the seven
sizes used by the multisize ICO files.

In ordinary text, code, storage, and parsing, an icon is not a canonical
machine token. Under the human-authorized image-input M2M amendment, a primary
image match can become machine-actionable only through a version-pinned
manifest binding, confidence, quality, and ambiguity checks, explicit
FORMAL/LOCAL selection, and normalization to canonical plain form.
See `IMAGE_INPUT_RECOGNITION.md`.

## Directory contract

- `01_SVG_OUTLINES`: one 1024-unit outline SVG per logical asset.
- `02_PNG_RASTERS`: transparent PNG derivatives at 16, 24, 32, 48, 64, 128,
  and 256 pixels.
- `03_ICO_MULTISIZE`: one ICO per logical asset, containing all seven PNG
  frames.
- `04_PROVISIONAL_ROTAE`: black-and-white 2048-pixel ROTA A/T/Q/S audit
  previews. These previews are not canonical ROTAS artifacts.
- `05_ATQS_ICON_PACKAGE`: immutable, consumption-ready 36-slot releases plus
  the explicitly promoted `latest` pointer.
- `06_FIGURAE_A_III_VECTOR_PACKAGE`: provisional, human-authored Figure A/III
  visual-source contract with palette/state JSON, a generated semantic Figure
  A SVG candidate, dynamic focus/rotation contracts, human/data projection
  profiles, and package-local validation. It is not part of the closed
  116-asset ATQS glyph build.
- `PROVENANCE`: build-input, licensing, Drive-sync inventory, and
  future-download notes. Drive is distribution/provenance only, never a build
  or runtime dependency.
- `TEMPLATES`: release documentation and JSON Schema copied by the package
  generator.
- `TOOLS`: deterministic build, lookup, image-candidate resolver, and package
  validator.

## Naming contract

Filenames are ASCII-only and use explicit regimen and status fields so they
remain collision-safe on case-insensitive filesystems. Examples:

```text
AGLA_ATQS_ICON_REGIMEN_A_AB.svg
AGLA_ATQS_ALNUM_REGIMEN_A_FORMAL_B_032PX.png
AGLA_ATQS_MARKER_REGIMEN_S_LOCAL_MULTISIZE.ico
```

Stable manifest identities use dotted notation such as `ATQS.ICON.A.AB` and
`ATQS.ALNUM.T.LOCAL.C`. Unicode display strings are never used as filenames or
primary identifiers because mathematical alphanumerics collapse under NFKC.

## Rebuild

From the repository root:

```powershell
powershell -ExecutionPolicy Bypass -File .\AGLA_ArsGeneralisLlullApplied\00_TRANSVERSAL_ARTIFACTS\GRAPHIC_RESOURCES\TOOLS\BUILD_GRAPHIC_RESOURCES.ps1
```

The build fails if any source code point lacks a real outline. It then writes
the manifest, SHA-256 inventory, SVGs, PNGs, ICOs, and provisional ROTAE
previews. The four previews preserve the canonical clockwise order
`B C D E F G H I K`, beginning at twelve o'clock. Formal alphanumerics occupy
the outer ring, pedagogical glyphs occupy the inner ring, and both are rotated
tangentially according to wheel position.

## Build an immutable icon release

From the repository root:

```powershell
powershell -ExecutionPolicy Bypass -File .\AGLA_ArsGeneralisLlullApplied\00_DEPLOYMENT\GENERATE_ATQS_ICON_PACKAGE.ps1 -PackageVersion 0.1.0 -HumanVisualAuditApproved -PromoteLatest
```

The generator selects exactly the 36 `PEDAGOGICAL_ICON` records, refuses to
overwrite an existing version, computes exact and perceptual hashes, and emits
SVG/PNG/ICO assets, JSON/CSV manifests, a JSON Schema, gallery, SVG sprite,
audit reports, documentation, and checksums.

Validate the immutable release and promoted pointer:

```powershell
./AGLA_ArsGeneralisLlullApplied/00_TRANSVERSAL_ARTIFACTS/GRAPHIC_RESOURCES/TOOLS/VALIDATE_ATQS_ICON_PACKAGE.ps1 -ManifestPath ./AGLA_ArsGeneralisLlullApplied/00_TRANSVERSAL_ARTIFACTS/GRAPHIC_RESOURCES/05_ATQS_ICON_PACKAGE/v0_1_0/manifest/agla_atqs_icons.manifest.json
./AGLA_ArsGeneralisLlullApplied/00_TRANSVERSAL_ARTIFACTS/GRAPHIC_RESOURCES/TOOLS/VALIDATE_ATQS_ICON_PACKAGE.ps1 -ManifestPath ./AGLA_ArsGeneralisLlullApplied/00_TRANSVERSAL_ARTIFACTS/GRAPHIC_RESOURCES/05_ATQS_ICON_PACKAGE/latest/manifest/agla_atqs_icons.manifest.json
```

The complete case registry is `TESTS_ATQS_ICON_PACKAGE.md`. The release usage
guide covers Markdown, HTML, inline SVG, CSS masks, chat, PDF, cards, slides,
accessibility, caching, and fallbacks.

## Figures A / III visual source contract

Start at:

```text
06_FIGURAE_A_III_VECTOR_PACKAGE/README.md
```

The package assigns human-approved, exact RGB primary-third colors only to the
nine A dignities. It keeps reusable ATQS icon geometry monochrome and binds
color dynamically by explicit context. A human-directed ppm visual metric maps
directed convertibility to tone and reserves alpha for future UI state. That
metric is not a current OPERA A output or doctrinal contraction grade.

Its approved **Breachable Representation Distance** principle requires human
and machine projections to resolve to one semantic source through stable IDs,
versioned transforms, and manifests. An eventual `.ai` master may serve as
editable authoring geometry; the supplied authoring SVG is currently the
byte-preserved geometry source. Semantic SVG is the required inspectable vector
interchange; EPS/PDF are lossy/traceable derivatives rather than semantic
interchange masters.

The human-authored SVG has been supplied. A deterministic v0.2.0 semantic SVG
candidate, companion manifest, and visual-QA preview are now
`GENERATED_VALIDATION_PENDING / NON_RUNTIME`; the authoring source remains
byte-exact. The `.ai`, EPS, ASE, formal `HUMAN_RENDER`, controlled
`DATA_RENDER`, immutable release, and engine-specific scene adapters remain
`NOT_GENERATED`. The synchronized local repository is the source; Drive remains
optional development/mobile distribution, never a build or runtime dependency.

Build, synchronize, and validate the v0.2.0 contract from the repository root:

```powershell
powershell -ExecutionPolicy Bypass -File .\AGLA_ArsGeneralisLlullApplied\00_TRANSVERSAL_ARTIFACTS\GRAPHIC_RESOURCES\06_FIGURAE_A_III_VECTOR_PACKAGE\TOOLS\BUILD_FIGURA_A_SEMANTIC_SVG.ps1
powershell -ExecutionPolicy Bypass -File .\AGLA_ArsGeneralisLlullApplied\00_TRANSVERSAL_ARTIFACTS\GRAPHIC_RESOURCES\06_FIGURAE_A_III_VECTOR_PACKAGE\TOOLS\SYNC_FIGURAE_A_III_DERIVED_VALUES.ps1
powershell -ExecutionPolicy Bypass -File .\AGLA_ArsGeneralisLlullApplied\00_TRANSVERSAL_ARTIFACTS\GRAPHIC_RESOURCES\06_FIGURAE_A_III_VECTOR_PACKAGE\TOOLS\VALIDATE_FIGURAE_A_III_VECTOR_PACKAGE.ps1
```