Commit cd3f73

2026-07-29 00:26:01 AeThex Docs: Publish canonical release and domain documentation
/dev/null .. changelog.md
@@ 0,0 1,68 @@
+ # Changelog
+
+ This changelog tracks notable changes to the AeThex platform, documentation, and APIs.
+
+ | Field | Value |
+ |---|---|
+ | Documentation status | Active |
+ | Applies to | AeThex platform |
+ | Last source review | 2026-06-30 |
+
+ ## Format
+
+ Entries are listed newest first. Changes are categorized as Added, Changed, Deprecated, Removed, Fixed, or Security.
+
+ ---
+
+ ## 2026-07-29
+
+ ### Added
+ - Canonical domain registry covering product, community, documentation, infrastructure, status, alias, and legacy classifications.
+ - Release-system standard separating ecosystem releases, product changelogs, release notes, documentation changes, deployments, incidents, advisories, and announcements.
+ - Release directory guide for the cross-Trinity public index at `aethex.us/releases`.
+
+ ### Changed
+ - Confirmed `docs.aethex.support` as the canonical AeThex documentation host.
+ - Marked the previous `docs.aethex.tech` GitBook surface for a path-preserving legacy redirect.
+
+ ### Fixed
+ - Restored the source pages required for canonical `/changelog`, `/release-notes`, `/releases`, `/release-system`, and `/domain-registry` routes.
+
+ ---
+
+ ## 2026-06-30
+
+ ### Added
+ - Batch Requests API (`POST /api/batch`).
+ - Presigned upload support for files over 10 MB.
+ - Enterprise IP allowlisting.
+
+ ### Changed
+ - KAEL context budget increased for Pro tier.
+ - Knowledge re-indexing latency reduced to under 2 minutes.
+
+ ### Fixed
+ - `filter[tags][in]` now correctly handles comma-separated values.
+
+ ---
+
+ ## 2026-06-01
+
+ ### Added
+ - KAEL streaming endpoint (`/api/chat/stream`).
+ - Device trust integration with MDM certificate validation.
+ - AeThex sandbox environment.
+
+ ### Security
+ - Credential scanning now covers GitLab in addition to GitHub.
+
+ ---
+
+ > For KAEL-specific changes, see [[KAEL Changelog]].
+ > For API versioning changes, see [[API Versioning]].
+
+ ## Related documentation
+
+ - [[KAEL Changelog]]
+ - [[API Versioning]]
+ - [[Release Notes]]
/dev/null .. domain-registry.md
@@ 0,0 1,68 @@
+ # Domain Registry
+
+ The Domain Registry maps AeThex public hostnames to the products, programs, and infrastructure that own them. It is the authoritative documentation index for domain purpose; DNS availability alone does not prove that a product is complete or supported.
+
+ | Field | Value |
+ |---|---|
+ | Documentation status | Active |
+ | Maintainer | AeThex documentation maintainers |
+ | Canonical documentation | [docs.aethex.support](https://docs.aethex.support) |
+ | Public release directory | [aethex.us/releases](https://aethex.us/releases) |
+ | Last verified | 2026-07-29 |
+
+ ## Classification
+
+ Every hostname is assigned one of these types:
+
+ | Type | Meaning |
+ |---|---|
+ | Product | A public AeThex product or application |
+ | Program | A Corporation, Foundation, or Labs program |
+ | Community | A community- or customer-owned property |
+ | Documentation | Public operating manuals and reference material |
+ | Infrastructure | API, authentication, source, automation, hosting, or storage |
+ | Status | Availability and incident reporting |
+ | Alias | Redirect or alternate hostname with no independent content |
+ | Legacy | Retained temporarily for migration or link compatibility |
+
+ ## Canonical documentation and release hosts
+
+ | Hostname | Type | Purpose | Canonical relationship |
+ |---|---|---|---|
+ | `aethex.us` | Program | Public AeThex ecosystem surface | Owns the cross-Trinity release directory |
+ | `aethex.us/releases` | Program | Curated releases across Corporation, Foundation, and Labs | Canonical public release index |
+ | `docs.aethex.support` | Documentation | AeThex operating manuals and technical reference | Canonical documentation host |
+ | `docs.aethex.tech` | Legacy | Previous GitBook documentation host | Planned path-preserving redirect to `docs.aethex.support` |
+ | `status.aethex.tech` | Status | Current service availability and incidents | Does not publish product releases |
+ | `git.aethex.tech` | Infrastructure | Source repositories and collaboration | Engineering history, not public release notes |
+
+ ## Initial product mappings
+
+ These mappings establish the release system without claiming that every reachable hostname is a separate product.
+
+ | Primary hostname | Product or property | Type | Release surface |
+ |---|---|---|---|
+ | `aethex.bot` | AeThex Bot | Product | `aethex.bot/changelog` |
+ | `aethex.bot/warden` | Warden | Product | Filtered through `aethex.us/releases` until a dedicated route is published |
+ | `rra.aethex.bot` | RRA | Community | Community-specific deployment history |
+ | `oakdale.aethex.tech` | Oakdale | Product/property | Product-specific deployment history |
+ | `aethex.support` | AeThex Support | Product | Support-specific release history |
+ | `docs.aethex.support` | AeThex Documentation | Documentation | Documentation changelog |
+
+ ## Registry rules
+
+ - A hostname is not promoted to a product merely because it resolves or returns HTTP 200.
+ - Product pages identify a primary owner, maturity, repository, canonical documentation, and release history.
+ - API, CDN, authentication, status, source-control, secrets, and automation hosts remain infrastructure unless they have an independently supported public product.
+ - Community and customer changes do not enter the AeThex platform changelog unless the shared AeThex product changed.
+ - Aliases redirect to the canonical hostname and do not maintain separate documentation.
+ - Legacy hosts retain path-compatible redirects for durable external links.
+ - New or changed mappings require an entry in the documentation changelog.
+
+ ## Related documentation
+
+ - [[Service Directory]]
+ - [[Trinity]]
+ - [[Release System]]
+ - [[Documentation Standards]]
+ - [[Changelog]]
/dev/null .. release-notes.md
@@ 0,0 1,43 @@
+ # Release Notes
+
+ Release notes explain the behavior, compatibility, migration requirements, known limitations, and availability of an approved AeThex release. They supplement the public release record; they are not a second independently maintained changelog.
+
+ | Field | Value |
+ |---|---|
+ | Documentation status | Active |
+ | Applies to | Corporation, Foundation, and Labs |
+ | Public release directory | [aethex.us/releases](https://aethex.us/releases) |
+ | Last source review | 2026-07-29 |
+
+ ## Where releases live
+
+ - [aethex.us/releases](https://aethex.us/releases) is the canonical public directory across the three Trinity arms.
+ - Product `/changelog` pages are filtered views of the same approved release records.
+ - Product documentation on this site explains released behavior.
+ - [[Changelog]] records changes to the AeThex platform and documentation history currently preserved here.
+ - Repository commits and deployment records remain engineering history.
+
+ ## Required release-note content
+
+ A substantial product release should document:
+
+ 1. What changed and who it affects.
+ 2. Production availability and release channel.
+ 3. Affected products, components, and domains.
+ 4. Authentication, permission, data, or privacy changes.
+ 5. Compatibility and migration requirements.
+ 6. Known limitations.
+ 7. Rollback, correction, deprecation, or supersession state.
+ 8. Links to the permanent release record and relevant product documentation.
+
+ ## Historical material
+
+ Older release claims are retained only when they can be tied to current source, deployment evidence, or an approved historical record. Reachability, placeholder content, roadmap text, and unverified implementation notes are not sufficient evidence of a public release.
+
+ ## Related documentation
+
+ - [[Releases]]
+ - [[Release System]]
+ - [[Changelog]]
+ - [[Domain Registry]]
+ - [[API Versioning]]
/dev/null .. release-system.md
@@ 0,0 1,88 @@
+ # Release System
+
+ AeThex separates public releases, product changelogs, documentation changes, deployments, incidents, and community announcements. These records may reference one another, but they are not interchangeable.
+
+ | Field | Value |
+ |---|---|
+ | Documentation status | Active |
+ | Applies to | Corporation, Foundation, and Labs |
+ | Public release directory | [aethex.us/releases](https://aethex.us/releases) |
+ | Canonical documentation | [docs.aethex.support](https://docs.aethex.support) |
+ | Last verified | 2026-07-29 |
+
+ ## Public hierarchy
+
+ 1. **Ecosystem releases** — `aethex.us/releases` presents curated public changes across all three Trinity arms.
+ 2. **Trinity views** — Corporation, Foundation, and Labs filters use the same release records.
+ 3. **Product changelogs** — product domains show only releases that affect that product.
+ 4. **Release details** — permanent pages describe changes, availability, affected domains, documentation, and known limitations.
+ 5. **Technical documentation** — `docs.aethex.support` explains how released behavior works.
+ 6. **Engineering history** — repositories and staff deployment records retain commits, builds, and rollback details.
+
+ ## Record types
+
+ | Record | Purpose | Public location |
+ |---|---|---|
+ | Release | Curated user-visible product change | `aethex.us/releases` |
+ | Product changelog entry | Product-filtered release | Product `/changelog` |
+ | Release note | Detailed behavior, compatibility, and migration information | `docs.aethex.support` |
+ | Documentation change | Change to manuals or reference material | Documentation changelog |
+ | Deployment | Environment, build, commit, and rollback evidence | Engineering/staff history |
+ | Incident | Availability degradation and resolution | Status service |
+ | Security advisory | Coordinated vulnerability disclosure | Security advisory section |
+ | Announcement | News that may not change a product | Product or community feed |
+
+ ## Required release fields
+
+ - Stable release identifier
+ - Title and plain-language summary
+ - Primary Trinity owner
+ - Collaborating Trinity arms, when applicable
+ - Product and affected components
+ - Primary and affected domains
+ - Release channel and maturity
+ - Version or dated web-release identifier
+ - Publication and production-availability timestamps
+ - Added, changed, fixed, security, deprecated, and removed items as applicable
+ - Documentation and migration links
+ - Known limitations
+ - Deployment evidence
+ - Author and approver
+ - Correction, supersession, rollback, or withdrawal state
+
+ ## Publication flow
+
+ ```text
+ Code or configuration change
+ → engineering/deployment record
+ → draft public release
+ → product-owner review
+ → documentation verification
+ → approved canonical release
+ → aethex.us/releases
+ → product changelog
+ → optional Discord or email announcement
+ ```
+
+ Deployments may create draft release material, but they do not automatically become public releases.
+
+ ## Ownership and scope
+
+ - One Trinity arm is the primary owner; other arms may be contributors.
+ - A cross-Trinity release is one record with multiple contributors, not three duplicated releases.
+ - Shared product changes belong to the shared product.
+ - Customer configuration belongs to that customer or community deployment history.
+ - Infrastructure-only work remains in the engineering log unless it changes public behavior.
+ - Documentation-only work appears in the documentation changelog.
+
+ ## Corrections
+
+ Published history is not silently rewritten. Corrections identify what changed and when. Withdrawn, rolled-back, superseded, and deprecated releases retain their permanent URLs and current state.
+
+ ## Related documentation
+
+ - [[Releases]]
+ - [[Domain Registry]]
+ - [[Changelog]]
+ - [[Release Notes]]
+ - [[Documentation Standards]]
/dev/null .. releases.md
@@ 0,0 1,34 @@
+ # Releases
+
+ The canonical public AeThex release directory is [aethex.us/releases](https://aethex.us/releases). It combines approved releases from AeThex Corporation, AeThex Foundation, and AeThex Labs without mixing raw commits, incidents, community conversation, or customer-only configuration.
+
+ | Field | Value |
+ |---|---|
+ | Documentation status | Active |
+ | Applies to | Public AeThex releases |
+ | Canonical release directory | [aethex.us/releases](https://aethex.us/releases) |
+ | Release-system documentation | [[Release System]] |
+ | Last verified | 2026-07-29 |
+
+ ## Find a release
+
+ - Browse all approved releases at [aethex.us/releases](https://aethex.us/releases).
+ - Use the Corporation, Foundation, and Labs filters to identify organizational ownership.
+ - Use product and release-channel filters for product-specific history.
+ - Open a release for affected domains, documentation, availability, limitations, and technical provenance.
+
+ ## Documentation versus releases
+
+ - The release directory explains **what changed**.
+ - Product changelogs show **what changed for one product**.
+ - This documentation explains **how the product works**.
+ - The documentation changelog records **what changed in the manuals**.
+ - The status service explains **whether a service is currently available**.
+
+ ## Related documentation
+
+ - [[Release System]]
+ - [[Release Notes]]
+ - [[Changelog]]
+ - [[Domain Registry]]
+ - [[Service Directory]]
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9