Repository navigation
F-Layer v1.2.0 — Documentation and security preview
Pre-releaseDigest
Preliminary publication: release-1.2 is not complete. This snapshot was
published as stable before milestone acceptance was complete. The stable
classification was withdrawn on 2026-10-08. Task #27 and Feature #8 still require
genuine human translation reviews; stable publication requires the completed,
closed milestone. The existing tag and audited assets are preserved for traceability.
F-Layer v1.2.0 makes its documentation easier to inspect and publish: every tracked
file has an accountable place in the generated reference, and EN/RU/ZH-CN routes
show their actual translation status. The documentation toolchain includes the
setuptools security correction. Runtime and CLI behavior stay compatible with
1.1.0; Russian and Simplified Chinese prose remains explicitly draft.
What's Changed
Added
- File and definition inventories that distinguish public installed-wheel APIs,
rendered repository Markdown, locale overlays, and source-only engineering files. - Complete canonical Markdown navigation, including policy, ADR templates,
architecture, development, release guidance, and the GitHub PR template. - Executable CLI and callable-protocol API coverage, whole-package wheel/source
parity, exact anchors, local-link checks, and rendered-page reachability gates. - Implemented architecture diagrams and strict multilingual builds with localized
navigation, draft/fallback banners, and 18 source-bound RU/ZH-CN draft pages. - A review handoff linking canonical sources, both locale drafts, required human
roles, current source hashes, and publication evidence requirements.
Fixed
- Broken generated links from repository review material to locale draft sources,
with regression evidence for both languages and preserved fragments. - Snapshot installation instructions select
v1.2.0in English, Russian,
and Simplified Chinese and retain the supported console/module commands.
Changed
- New files in existing coverage categories are discovered automatically;
unknown or ambiguous categories and missing wheel payloads fail validation. - Reviewed translation status remains separate from build success. Drafts and
missing translations are labeled explicitly; automation creates no approvals.
Security
- Pin setuptools
83.0.0in the documentation toolchain for
GHSA-h35f-9h28-mq5c / CVE-2026-59890, replacing vulnerable80.9.0. - Preserve all other documentation pins, the Hatchling package backend,
static API rendering, and existing ownership/mutation-consent boundaries.
Validation
- Python quality passed on the exact released master commit.
- Documentation quality gates passed on the exact released master commit.
- Release artifact validation passed on the exact released master commit.
- Tagged artifact audit passed annotated-tag/version ownership, repeated byte-identical builds, source-archive rebuild parity, archive ownership and wheel RECORD checks.
- The attached wheel, source archive and build-evidence.json were downloaded and matched their audited SHA256 values and sizes before publication.
- Tests use isolated resources; no live cloud mutation or PyPI upload was performed.
Source commit: 3937447.
Breaking Changes
None. Runtime APIs, CLI commands, owned-state contracts, and provider behavior
remain compatible with 1.1.0. This release adds documentation and validation tooling.
Try it from source
git clone https://github.com/Fuzzy-Technologies/F-Layer.git
cd F-Layer
git checkout v1.2.0
python -m pip install .
flayer --help
python -m flayer check --format jsonPython 3.11 or newer is required. The attached wheel is an alternative to source
installation; a package-index upload is a separate owner-controlled operation.
Notes
- Selects accepted release-1.2 PRs #46, #48, #59, and #60 on the tagged 1.1.0
baseline, plus bounded release stabilization. Plugin discovery, ecosystem
integration contracts, and the static-site deployment profile remain later work. - All 18 authored RU/ZH-CN pages remain drafts. Generated APIs and untranslated
repository material use explicit English fallback. Human editorial/technical
reviews remain outstanding, so Task #27, Feature #8, and the milestone must
be completed before a stable release can be published. - No live cloud deployment or PyPI upload is performed by this release.
- Detailed changelog
- Release provenance