Skip to content

lexs-works/AEGIS

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
README.md
README.md
 
 

Repository files navigation

AEGIS VERSIONING · 0.β.0526

A semantic versioning standard for software, hardware, and brainware.

English · Deutsch · Русский

ENGLISH

Overview

AEGIS is a semantic versioning system where each version string encodes the lifecycle stage, the algorithm generation, and the iteration of a product.

Unlike SemVer, AEGIS separates maturity (stage) from compatibility (major marker). Unlike CalVer, the date is not a release timestamp — it is tied to the brainware generation that defines the product's logic.

AEGIS is suitable for software, hardware, specifications, and models (brainware).

Format

X.Y.ZZZZ-N
Component Meaning When it changes
X Major marker Only for breaking changes (API, protocol, backwards compatibility)
Y Greek letter — lifecycle stage When the product moves to a new stage
ZZZZ Date (MMYY or DDMMYY) Always tied to the brainware date
N Iteration Patches within a version; not applicable to α or β

Absence of N is equivalent to N=0.

Stage Letters

Letter Stage Meaning
α announce Project announced; requirements gathered; vision formed
β brainware Schemas, specifications, algorithms, models — no code
π proto First working code; features may be missing or unstable
δ dev Active development, optimisation, polishing
ρ roll Rolling releases; continuous stream of updates
σ sigma Stable branch; production-ready; may receive additions
μ micro Limited version; lives its own independent life
φ final Final; only critical security fixes

Stage order (linear): α < β < π < δ < σ < φ

Special stages: ρ (rolling) and μ (micro) exist outside the linear sequence.

Key Rules

1. Major Marker (X)

  • Increments only for backwards-incompatible changes.
  • Never resets when Y changes. It is a product generation counter.

2. Stage Letter (Y)

  • Changes when the product enters a new lifecycle phase.
  • Standard path: α → β → π/δ → σ/ρ → φ.
  • μ is an independent branch with its own X.

3. Date (ZZZZ)

  • Always tied to the brainware (β) date. Not the code release date.
  • MMYY for normal releases; DDMMYY when day precision is needed.
  • Changes only when a new β is released.
  • Code release dates belong in the changelog, not the version string.

4. Iteration (N)

  • Not applicable to α and β.
  • Each Y has its own independent N. Only ZZZZ is inherited across stage transitions.

Special Cases

Rolling (ρ)

  • X is the same as the main branch.
  • ZZZZ is the build date.
  • Multiple builds per day increment N.
  • Each rolling build must reference its brainware: β-ref: X.β.ZZZZ.
  • Micro-brainware changes are stored in the repository; not exposed in the release.

Micro (μ)

  • Independent X starting at 0.
  • May never synchronise with the main branch.
  • ZZZZ is its own date (tied to its own β if any).

Examples

0.α.0426 Announce, April 2026
0.β.0426 Brainware, April 2026 (algorithms frozen)

0.π.0426 Proto on April β
0.δ.0426 Dev on April β

0.β.0526 New brainware, May 2026 (algorithms revised)
0.δ.0526 Dev on May β

0.σ.0526 Stable release on May β
0.σ.0526-1 First patch (β unchanged)
0.σ.0526-2 Second patch

1.α.0726 Major gen.2 announced (breaking changes)
1.β.0726 Brainware for gen.2
1.σ.0726 Stable gen.2

0.μ.0826 Micro fork from 0.σ.0526 (independent X=0)
1.μ.0926 Micro update (own X=1)

1.ρ.150127 Rolling build, β-ref: 1.β.0726

Comparison with Other Systems

Criterion SemVer CalVer AEGIS
Compatibility info Yes (major.minor.patch) No Yes (X — major marker)
Freshness info No Yes (date) Yes (ZZZZ tied to β)
Lifecycle stage Suffixes like -alpha, -beta No Yes (Greek letter Y)
Algorithm generation Hidden Hidden Explicit (ZZZZ tied to β)
Machine-sortable Yes Yes Yes (with AEGIS-aware parser)
Human-readable Medium Medium High (stage + generation + patch)
Suitable for brainware/specs No No Yes (native β stage)
Resistant to marketing abuse Low Medium High (letters restrict claims)

Key advantage: AEGIS tells you what the product is (stage), what logic it uses (brainware date), and how refined it is (iteration) — all in one string. No other system captures all three dimensions.

Examples for Hardware

AEGIS is recommended for hardware projects as well.

  • 0.α.0326 Soldering iron concept announced, March 2026
  • 0.β.0426 Thermal calculations and schematics (brainware)
  • 0.π.0426 First physical prototype (cast iron accumulator)
  • 0.σ.0426 Production-ready version

  • 1.α.0127 Second generation announced (new type accumulator)
  • 1.β.0227 Thermodynamic models
  • 1.σ.0227 Gen 2 in production

Formal Grammar (BNF)

<version>    ::= <major> "." <stage> "." <date> ["-" <iteration>]
<major>      ::= <digit>+
<stage>      ::= "α" | "β" | "π" | "δ" | "ρ" | "σ" | "μ" | "φ"
<date>       ::= <month><year> | <day><month><year>
<month>      ::= "01" | "02" | ... | "12"
<day>        ::= "01" | "02" | ... | "31"
<year>       ::= <digit><digit>
<iteration>  ::= <digit>+

License

AEGIS 0.β.0526 — Standard. No Derivatives.

This standard is published for public use as-is. Modification of the specification is prohibited. Any use of this standard in a project, repository, or product must include attribution with a link to the canonical repository.

This work is licensed under CC BY-ND 4.0 (Creative Commons Attribution-NoDerivatives 4.0 International).

Full licence text: https://creativecommons.org/licenses/by-nd/4.0/legalcode

Attribution Stamp

This project uses AEGIS Versioning.
Standard: AEGIS 0.β.0526 — https://github.com/ye-olde-legende/aegis

The shield is not to hide behind. The shield is to advance.

DEUTSCH

Übersicht

AEGIS ist ein semantisches Versionierungssystem, bei dem jede Versionszeichenkette die Lebenszyklusphase, die Algorithmus-Generation und die Iteration eines Produkts kodiert.

Im Gegensatz zu SemVer trennt AEGIS Reife (Phase) von Kompatibilität (Major-Marker). Anders als CalVer ist das Datum kein Veröffentlichungszeitstempel, sondern an die Brainware-Generation gebunden.

AEGIS eignet sich für Software, Hardware, Spezifikationen und Modelle.

Format

X.Y.ZZZZ-N
Komponente Bedeutung Änderungsregel
X Major-Marker Nur bei inkompatiblen Änderungen
Y Griechischer Buchstabe — Phase Bei Übergang in neue Lebenszyklusphase
ZZZZ Datum (MMYY oder DDMMYY) Stets an das Brainware-Datum gebunden
N Iteration Patches innerhalb einer Version; nicht für α/β

Phasen-Buchstaben

Buchstabe Phase Bedeutung
α announce Projekt angekündigt; Anforderungen gesammelt
β brainware Schemata, Spezifikationen, Algorithmen, Modelle
π proto Erster funktionierender Code; instabil
δ dev Aktive Entwicklung, Optimierung
ρ roll Rolling Releases; kontinuierliche Updates
σ sigma Stabiler Zweig; produktionsreif
μ micro Eingeschränkte Version; eigenständig
φ final Final; nur kritische Sicherheitsupdates

Beispiele

0.α.0426          Ankündigung, April 2026
0.β.0426          Brainware, April 2026

0.π.0426          Prototyp auf April-β
0.σ.0526          Stabil auf Mai-β

1.α.0726          Major-Version gen.2 angekündigt
1.σ.0726          Stabil gen.2

0.μ.0826           Micro-Abspaltung von 0.σ.0526

1.ρ.150127         Rolling Build, β-ref: 1.β.0726

Formal Grammar (BNF)

<version>    ::= <major> "." <stage> "." <date> ["-" <iteration>]
<major>      ::= <digit>+
<stage>      ::= "α" | "β" | "π" | "δ" | "ρ" | "σ" | "μ" | "φ"
<date>       ::= <month><year> | <day><month><year>
<month>      ::= "01".."12"
<day>        ::= "01".."31"
<year>       ::= <digit><digit>
<iteration>  ::= <digit>+

LIZENZ

AEGIS 0.β.0526 — Standard. Keine Bearbeitung.

Dieser Standard wird unverändert zur öffentlichen Nutzung veröffentlicht. Jegliche Änderung der Spezifikation ist untersagt. Bei Verwendung in Projekten, Repositories oder Produkten ist eine Quellenangabe mit Verweis auf das kanonische Repository erforderlich.

Dieses Werk steht unter CC BY-ND 4.0 (Creative Commons Namensnennung — Keine Bearbeitungen 4.0 International).

Vollständiger Lizenztext: https://creativecommons.org/licenses/by-nd/4.0/legalcode

Attributionsvermerk

Dieses Projekt verwendet AEGIS Versioning.
Standard: AEGIS 0.β.0526 — https://github.com/ye-olde-legende/aegis

Der Schild ist nicht zum Verstecken. Der Schild ist, um vorwärts zu gehen.

РУССКИЙ

Обзор

AEGIS — семантическая система версионирования, в которой каждая версионная строка кодирует стадию жизненного цикла, поколение алгоритма и итерацию продукта.

В отличие от SemVer, AEGIS разделяет зрелость (стадия) и совместимость (мажорный маркер). В отличие от CalVer, дата привязана не к выпуску, а к brainware-поколению, определяющему логику продукта.

AEGIS подходит для программных, аппаратных, спецификационных и модельных проектов.

X.Y.ZZZZ-N
Компонент Значение Правило смены
X Мажорный маркер Только при несовместимых изменениях
Y Греческая буква — стадия При переходе на новую стадию
ZZZZ Дата (MMYY или DDMMYY) Всегда привязана к дате brainware
N Итерация Правки/патчи; не применяется к α и β

Буквы стадий

Буква Стадия Значение
α announce Анонс; сбор требований; формирование видения
β brainware Схемы, спецификации, алгоритмы, модели
π proto Первый работающий код; нестабилен
δ dev Активная разработка, оптимизация
ρ roll Роллинг-релизы; непрерывный поток обновлений
σ sigma Стабильная ветка; готовый продукт
μ micro Ограниченная версия; живёт своей жизнью
φ final Финал; только критические исправления

Примеры

0.α.0426          Анонс, апрель 2026
0.β.0426          Brainware, апрель 2026

0.π.0426          Прототип на апрельской β
0.σ.0526          Стабильный релиз на майской β

1.α.0726          Анонс мажорной смены поколения
1.σ.0726          Стабильная версия второго поколения

0.μ.0826          Микро-версия от 0.σ.0526

1.ρ.150127        Роллинг-сборка, β-ref: 1.β.0726

Примеры для аппаратных решений

0.α.0326          Анонс концепта паяльника, март 2026
0.β.0426          Тепловые расчёты и схемы (brainware)
0.π.0526          Первый прототип (чугунный аккумулятор)
0.σ.0626          Готовое изделие

1.α.0127          Анонс второго поколения (новый тип аккумулятора)
1.β.0227          Расчёты термодинамики
1.σ.0327          Второе поколение в производстве

Сравнение с другими системами

Критерий SemVer CalVer AEGIS
Информация о совместимости Да (major.minor.patch) Нет Да (X — маркер)
Информация о свежести Нет Да (дата) Да (ZZZZ от β)
Стадия жизненного цикла Суффиксы (-alpha, -beta) Нет Да (буква Y)
Поколение алгоритма Скрыто Скрыто Явно (ZZZZ от β)
Пригодность для спецификаций Нет Нет Да (стадия β)
Устойчивость к маркетингу Низкая Средняя Высокая

Ключевое преимущество: AEGIS сообщает, чем является продукт (стадия), на какой логике он построен (дата brainware), и насколько отлажен (итерация) — в одной строке. Ни одна другая система не охватывает все три измерения.

Формальная грамматика (BNF)

<version>    ::= <major> "." <stage> "." <date> ["-" <iteration>]
<major>      ::= <digit>+
<stage>      ::= "α" | "β" | "π" | "δ" | "ρ" | "σ" | "μ" | "φ"
<date>       ::= <month><year> | <day><month><year>
<month>      ::= "01" | "02" | ... | "12"
<day>        ::= "01" | "02" | ... | "31"
<year>       ::= <digit><digit>
<iteration>  ::= <digit>+

Лицензия

AEGIS 0.β.0526 — Стандарт. Без права изменения.

Данный стандарт опубликован для публичного использования в неизменном виде. Изменение спецификации запрещено. При использовании в проектах, репозиториях или продуктах обязательно указание ссылки на канонический репозиторий.

Произведение распространяется по лицензии CC BY-ND 4.0 (Creative Commons С указанием авторства — Без производных 4.0 Международная).

Полный текст: https://creativecommons.org/licenses/by-nd/4.0/legalcode

Штамп указания

В проекте используется AEGIS Versioning.
Стандарт: AEGIS 0.β.0526 — https://github.com/ye-olde-legende/aegis

Щит — не для укрытия. Щит — чтобы идти вперёд.

About

A semantic versioning standard for software, hardware, and brainware

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Contributors