SeaweedFS integration

.github/workflows/gwy-code-quality.yaml

@@ -39,6 +39,7 @@ jobs:
             - uses: actions/checkout@v6
 
             # this ubuntu-latest version ships node 18, which was causing issues
+            # https://github.com/actions/setup-node#usage
             - uses: actions/setup-node@v6
               with:
                   node-version: 24
@@ -52,7 +53,7 @@ jobs:
 
             - name: Cache prek hooks
               id: cache-prek
-              uses: actions/cache@v4
+              uses: actions/cache@v5
               # https://github.com/actions/cache/blob/main/examples.md#python---pip
               with:
                   key: prek-gateway-${{ hashFiles('gateway/.pre-commit-config.yaml') }}
@@ -99,8 +100,8 @@ jobs:
               run: |
                   npm install -g rust-just
 
-            - name: Deploy action
-              run: ./scripts/deploy.sh ci
+            - name: Deploy action (RustFS only — no SeaweedFS)
+              run: SDS_SKIP_SFS=true ./scripts/deploy.sh ci
               working-directory: ./gateway
 
             - name: Run tests

.github/workflows/sdk-code-quality.yaml

@@ -38,6 +38,7 @@ jobs:
             - uses: actions/checkout@v6
 
             # this ubuntu-latest version ships node 18, which was causing issues
+            # https://github.com/actions/setup-node#usage
             - uses: actions/setup-node@v6
               with:
                   node-version: 24
@@ -48,16 +49,12 @@ jobs:
 
             - name: Cache prek hooks
               id: cache-prek
-              uses: actions/cache@v4
+              uses: actions/cache@v5
               # https://github.com/actions/cache/blob/main/examples.md#python---pip
               with:
                   key: prek-${{ hashFiles('.pre-commit-config.yaml') }}
                   path: ~/.cache/prek/
 
-            - name: Install gateway frontend dependencies
-              working-directory: ./gateway
-              run: npm ci
-
             - name: Install hooks
               working-directory: ./sdk
               run: uv run --dev prek install --install-hooks

.gitignore

@@ -1,8 +1,9 @@
-.DS_Store
-
 .agents
-seaweedfs
-**/agents.md
+.config/agents/
 .coverage
 .coverage.*
+.DS_Store
+**/agents.md
+agents.md
 htmlcov/
+seaweedfs

.pre-commit-config.yaml

@@ -88,7 +88,7 @@ repos:
 
     # linter for markdown files - see .rumdl.toml to configure rules
     - repo: https://github.com/rvben/rumdl-pre-commit
-      rev: v0.2.4
+      rev: v0.2.5
       hooks:
           - id: rumdl # Lint only (fails on issues)
           - id: rumdl-fmt # Auto-format and fail if issues remain

gateway/.envs/example/storage.env

@@ -0,0 +1,24 @@
+# ====================== STORAGE ENV ======================
+# PRIMARY (RustFS) — S3-compatible storage, default for local/CI
+# SECONDARY (SeaweedFS) — S3-compatible object store for local/dev
+
+# PRIMARY (RustFS) credentials
+PRIMARY_ACCESS_KEY_ID=admin
+PRIMARY_ENDPOINT_URL=sds-gateway-local-rustfs:9000
+PRIMARY_S3_ENDPOINT_URL=http://sds-gateway-local-rustfs:9000
+PRIMARY_SECRET_ACCESS_KEY=admin
+PRIMARY_STORAGE_BUCKET_NAME=spectrumx
+PRIMARY_STORAGE_USE_HTTPS=false
+
+# SECONDARY (SeaweedFS) credentials
+SECONDARY_ACCESS_KEY_ID=admin
+SECONDARY_SECRET_ACCESS_KEY=admin
+SECONDARY_ENDPOINT_URL=sds-gateway-local-sfs-s3:8333
+SECONDARY_S3_ENDPOINT_URL=http://sds-gateway-local-sfs-s3:8333
+SECONDARY_STORAGE_BUCKET_NAME=spectrumx
+SECONDARY_STORAGE_USE_HTTPS=false
+
+# Transition controls
+OBJECT_STORE_DUAL_WRITE_STRICT=false
+OBJECT_STORE_READ_FALLBACK_TO_SECONDARY_ENABLED=false
+OBJECT_STORE_WRITE_BOTH_ENABLED=false

gateway/.envs/example/storage.prod.env

@@ -0,0 +1,26 @@
+# ====================== STORAGE ENV (PRODUCTION) ======================
+# SeaweedFS config — see seaweedfs/compose.production.yaml
+# RustFS config — see gateway/compose.<env>.yaml
+
+# PRIMARY credentials (RustFS in local and ci, SeaweedFS in prod)
+PRIMARY_ACCESS_KEY_ID=admin
+PRIMARY_ENDPOINT_URL=sds-gateway-prod-sfs-s3:8333
+PRIMARY_S3_ENDPOINT_URL=http://sds-gateway-prod-sfs-s3:8333
+PRIMARY_SECRET_ACCESS_KEY=admin
+PRIMARY_STORAGE_BUCKET_NAME=spectrumx
+PRIMARY_STORAGE_USE_HTTPS=false
+
+# SECONDARY credentials (usually RustFS in prod; absent in local and ci)
+SECONDARY_ACCESS_KEY_ID=minioadmin
+SECONDARY_ENDPOINT_URL=prod-secondary-rustfs:9000
+SECONDARY_ROOT_PASSWORD=<GENERATED SECONDARY ROOT PASSWORD>
+SECONDARY_ROOT_USER=minioadmin
+SECONDARY_S3_ENDPOINT_URL=http://prod-secondary-rustfs:9000
+SECONDARY_SECRET_ACCESS_KEY=<SAME AS SECONDARY_ROOT_PASSWORD>
+SECONDARY_STORAGE_BUCKET_NAME=spectrumx
+SECONDARY_STORAGE_USE_HTTPS=false
+
+# Transition controls
+OBJECT_STORE_DUAL_WRITE_STRICT=false
+OBJECT_STORE_READ_FALLBACK_TO_SECONDARY_ENABLED=false
+OBJECT_STORE_WRITE_BOTH_ENABLED=false