FLUX DOCUMENTATION SYSTEM Layer 9 — GOVERNANCE | versions flux.dantesisofo.com/wiki/versions/
| Version | Date | Status | Summary |
|---|---|---|---|
| v1.0 | 2026-05-13 | LOCKED | Archive launch. Frame count, PDF structure, filename convention, S3 namespace. |
| v1.1 | 2026-05-14 | LOCKED | Public catalog. CAT_NNN namespace. publish_submission.py. FLUX_CATALOG/ prefix. |
| v1.2 | 2026-05-15 | LOCKED | Physical calibration. Gutter compensation. Auto-generation trigger. File lock. |
| v1.3 | 2026-05-19 | LOCKED | Catalog stability. _next_catalog_id() fix. S3 sync on save. Catalog = 18 entries. |
| v2.0 | 2026-05-20 | CURRENT | Documentation architecture. 8-layer wiki. Intelligence layer. Hardware ordered. NAS structure. |
LOCKED means the decision cannot be changed without:
LOCKED is not advisory. It is not a strong preference. It is a protocol constraint.
The following are LOCKED as of v2.0:
FRAMES_PER_ISSUE = 36
PDF page count = 44
PDF page layout = as specified in DECISION-002
Canonical filename format = YYYY-MM-DD_HH-MM-SS_PhotographerName_OriginalFilename.JPG
_next_catalog_id() must scan S3, not catalog.json
_save_catalog() must immediately sync to S3
Changing any of these without following the protocol above invalidates the version record.
FLUX uses semantic versioning with protocol-specific semantics.
A major version changes when: - The protocol's core structure changes (frame count, PDF layout, filename format) - The documentation architecture changes fundamentally - A new protocol layer is introduced that restructures existing layers - Backward compatibility with prior issues is broken
v1.0 → v2.0 was a major bump because the documentation architecture was restructured from flat to 8-layer.
A minor version changes when: - New protocol capabilities are added (new pipeline, new namespace, new script) - Bug fixes that affect protocol behavior (catalog ID collision fix) - Infrastructure decisions that change system architecture - New DECISION entries that extend rather than replace prior decisions
v1.0 → v1.1 was a minor bump because the public catalog was added without changing the core protocol. v1.2 → v1.3 was a minor bump because catalog bugs were fixed without changing protocol constants.
FLUX does not currently use patch versions. All changes are either minor or major.
FLUX has three distinct versioning tracks:
The specification: frame count, PDF structure, filename convention.
The protocol version increments when any DECISION marked LOCKED is created or superseded. The current protocol version is embedded in every generated PDF on the protocol page (page 3).
Current: FLUX Protocol v2.0
The codebase: flux_constants.py, generate_flux_issue.py, approve_worker.py, issue_builder_worker.py, publish_submission.py.
Implementation version increments with code changes. Implementation must be compatible with the protocol version it targets. An implementation at v1.3 code should not be used to generate v2.0 issues.
Current: FLUX Implementation v2.0 (tracks protocol)
The documentation: FLUX_WIKI/*.md, generate_wiki.py.
Wiki version increments with documentation changes. The wiki version is embedded in every wiki page footer and in the generated PDFs.
Current: FLUX_WIKI_v2.0
The three versions are synchronized at major releases. They may diverge at minor releases (e.g., the wiki can be updated without a protocol change).
Protocol: FLUX Protocol v2.0 — CURRENT
Implementation: FLUX Implementation v2.0 — CURRENT
Wiki: FLUX_WIKI_v2.0 — CURRENT
Personal issues: FLUX_001–FLUX_423+ (as of 2026-05-20)
Public catalog: CAT_001–CAT_018 (as of 2026-05-20)
| Document | Layer | Relationship |
|---|---|---|
| CHANGELOG | Layer 9 — Governance | Full chronological history of all version changes |
| DECISIONS LOG | Layer 9 — Governance | RFC records for all LOCKED decisions |
| PROTOCOL | Layer 2 — Protocol | The versioned protocol specification |
FLUX_WIKI_v2.0 — flux.dantesisofo.com/wiki/versions/