Maintained fork of minio/docs. It applies security patches and maintenance fixes on top of upstream. Part of the Dark Gravity factory. License: CC BY 4.0.
This repository forms the central documentation build engine and architectural reference source for the Sovereign MinIO Ecosystem under @lgcorzo. It powers static site generation, API reference compilation, and deployment guides across all core components of the autonomous storage factory.
This repository is actively maintained under @lgcorzo as a critical pillar of the Dark Gravity Factory autonomous AI production ecosystem.
-
Full Supply-Chain Autonomy:
- Zero reliance on upstream breaking license changes, deprecation notices, or unannounced URL host retirements.
- Independent verification, hermetic build environments, and complete ownership of docs build toolchains and rendering scripts.
-
Dark Gravity Factory Core Integration:
- Serves as the central knowledge engine powering autonomous agent pipelines, developer documentation, deployment runbooks, and architectural specifications across high-throughput storage and cryptographic security modules.
-
Compliance & Security Standards:
- Maintained with automated security scanning and versioned documentation designed to facilitate auditing and traceability.
- Continuous security posture with zero-CVE SLAs enforced through automated daily vulnerability scanning (
Trivy,CodeQL,govulncheck).
-
Ecosystem Interoperability:
- Seamless cross-reference integration across all 38 repositories in the
@lgcorzosovereign ecosystem (MinIO Server, MC CLI, KES, Operator, DirectPV, Console, SIMD libraries, and client SDKs).
- Seamless cross-reference integration across all 38 repositories in the
- For full repository matrix, live release tags, Dependabot status, and cluster deployment specs, see SOVEREIGN_ECOSYSTEM_STATUS.md.
- For the architectural decoupling roadmap and Go module independence strategy, see SOVEREIGN_GO_MODULE_DECOUPLING_PLAN.md.
The following table summarizes the 38 interconnected repositories maintained under the @lgcorzo sovereign umbrella:
| Tier | Component Type | Repositories | Role in Dark Gravity Factory |
|---|---|---|---|
| Tier 1 | Core Storage & Infrastructure | minio, mc, operator, kes, console, directpv, warp, sidekick, certgen, dperf |
High-throughput object storage, K8s orchestration, cryptographic KMS, web console, bare-metal storage provisioning, and performance benchmarking. |
| Tier 2 | Crypto & SIMD Acceleration | sha256-simd, md5-simd, blake2b-simd, simdjson-go, highwayhash, crc64nvme, sio, asm2plan9s |
Hardware-accelerated cryptographic primitives, SIMD JSON parsing, and streaming encryption for maximum throughput. |
| Tier 3 | SDKs & Core Client Libraries | minio-go, madmin-go, kms-go, pkg, cli, colorjson, csvparser, dnscache, filepath, mtls, multipart-debug, mux, pkger, selfupdate, websocket, xxml, zipindex |
Multi-language SDKs, administrative management APIs, KMS protocols, and low-level utility libraries for sovereign services. |
| Tier 4 | Testing & Documentation | mint, docs, minio-cf |
Automated integration testing suites, Sphinx/Markdown documentation engines, and cloud template configurations. |
The @lgcorzo MinIO ecosystem operates with Full Sovereignty (100% Operational & Deployment Independence):
- Git Remote Topology: 100% Sovereign. Zero active upstream remotes exist across any of the 38 repositories. All default branches (
main/master) push exclusively togithub.com/lgcorzo/*and are under independent access control and branch protection. - Artifact & Container Registry: 100% Sovereign & Automated. Upstream image registries (
quay.io/minio/*,docker.io/minio/*) are completely decommissioned from deployment manifests. All container runtimes (operator,operator-sidecar,minio,mc) are compiled automatically by GitHub Actions CI/CD pipelines (.github/workflows/docker-publish.ymlin each repository) upon commit pushes and tag creation, building hermetic multi-arch (linux/amd64,linux/arm64) images and publishing directly to GitHub Container Registry (ghcr.io/lgcorzo/*). Zero manual local builds are required for distribution. - Zero-
:latestTagging Policy: All production images and Helm charts strictly bind to immutable semantic tags (v*.*.*-lgcorzo.*). - Security & Vulnerability Remediation: Fully decoupled from upstream patch cycles. GitHub CodeQL static code analysis, Dependabot security updates, and automated patching are active across 100% of the repositories (38/38).
- Sovereignty Baseline Date: October 10, 2026
- As of this milestone date, the entire 38-repository cluster achieved:
- Complete resolution and closure of all outstanding security and dependency issues (74/74 issues resolved).
- End-to-end continuous deployment via FluxCD into live Kubernetes clusters using strictly sovereign images.
- Removal of legacy upstream
replacedirectives (e.g.directpvpinning directly togithub.com/lgcorzo/sha256-simd v1.0.2).
The ecosystem provides reproducible, verifiable proof of autonomy:
- Live Production Workloads: Kubernetes clusters running MicroK8s in the
storagenamespace deploy exclusively fromghcr.io/lgcorzo/*:minio-operatorrunningghcr.io/lgcorzo/operator:v7.1.1-lgcorzo.3mlflow-minio-pool-0-0runningghcr.io/lgcorzo/minio:v0.1.0-lgcorzo.2with sidecarv7.1.1-lgcorzo.3- Bucket provisioning jobs running
ghcr.io/lgcorzo/mc:v0.1.1-lgcorzo.2
- Independent Toolchains: The client CLI (
mc) and core server build against the modern Go 1.26 toolchain (golang:1.26-alpine) with independent multi-arch (linux/amd64,linux/arm64) compilation. - Decoupled Security Governance: CodeQL scans run independently on sovereign GitHub Actions pipelines, resolving security vulnerabilities (such as
golang.org/x/crypto v0.36.0+) without waiting for upstream releases.
From October 10, 2026 onward, @lgcorzo default branches follow a distinct architectural trajectory independent of upstream:
- No Upstream Rebase Mandate: The repositories no longer perform automated fast-forward or destructive rebases from upstream repositories. Upstream changes are treated as third-party reference sources, not authoritative base branches.
- AIStor Extension Architecture: Non-AWS additions and sovereign enhancements follow the AIStor extension standard, focusing on enterprise-grade multi-tenancy, autonomous AI data pipelines, and structured auditability and traceability.
- Sovereign Go Module Architecture: Moving systematically through the Sovereign Go Module Decoupling Plan using replace-overlays and sovereign module namespaces (
github.com/lgcorzo/*), ensuring stability and freedom from upstream licensing restrictions.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Upstream Tracking Branch β
β (weekly upstream-sync cron) β
ββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββ
β
βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Dark Gravity Factory CA/CD β
β (Daily Trivy / CodeQL / VulnCheck Scans + Autonomous AST Patching) β
ββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββ
β
βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Human-in-the-Loop (HITL) Gate β
β (Mandatory code review & sign-off prior to merge) β
ββββββββββββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββββββββββββ
β
βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Hermetic Multi-Stage Build & Release β
β (Multi-arch AMD64/ARM64, GHCR + Local Registry, Minisign/Cosign) β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
@lgcorzo/docs uses Sphinx to generate static HTML pages using ReSTructured Text (rST) and Markdown.
- Any GNU/Linux Operating System, or macOS 12.3 or later.
- Python 3.10.x or later and
pip python3-venv- Node.js 18+ and
npm git
- Clone docs repository locally:
git clone https://github.com/lgcorzo/docs && cd docs/- Create and activate a Python virtual environment:
python3 -m venv venv && source venv/bin/activate- Install Python and Node.js dependencies:
pip install -r requirements.txt && npm install && npm run build- Compile documentation:
make SYNC_SDK=true mindocs- Preview the generated documentation at
http://localhost:8000:
python3 -m http.server --directory build/$(git rev-parse --abbrev-ref HEAD)/mindocs/htmlTo sync Operator CRD documentation:
make sync-operator-crdThis script:
- Downloads and converts
tenant_crd.adocfromgithub.com/lgcorzo/operator. - Downloads Operator Helm
values.yamland Tenant Helmvalues.yaml. - Converts AsciiDoc to XML/Markdown and applies Sphinx ingest formatting.
This project is licensed under a Creative Commons Attribution 4.0 International License. See CONTRIBUTING.md for contribution guidelines.
- Changes vs. Upstream: Security dependency updates, CI/CD workflow fixes, and CodeQL remediation are tracked in the commit history and Pull Requests.
- Agent Tagging (
[agent]): Commits and pull requests generated automatically by agents in the Dark Gravity pipeline are prefixed with[agent]to distinguish automated maintenance from manual work.