Release v0.9.14: New features and improvements

.github/workflows/docker-image-alpha.yml

@@ -66,8 +66,8 @@ jobs:
         uses: docker/metadata-action@v5
         with:
           images: |
-            calciumion/new-api
-            ghcr.io/${{ env.GHCR_REPOSITORY }}
+            nick3/new-api
+            ghcr.io/${{ github.repository }}
 
       - name: Build & push single-arch (to both registries)
         uses: docker/build-push-action@v6
@@ -76,10 +76,10 @@ jobs:
           platforms: ${{ matrix.platform }}
           push: true
           tags: |
-            calciumion/new-api:alpha-${{ matrix.arch }}
-            calciumion/new-api:${{ steps.version.outputs.value }}-${{ matrix.arch }}
-            ghcr.io/${{ env.GHCR_REPOSITORY }}:alpha-${{ matrix.arch }}
-            ghcr.io/${{ env.GHCR_REPOSITORY }}:${{ steps.version.outputs.value }}-${{ matrix.arch }}
+            nick3/new-api:alpha-${{ matrix.arch }}
+            nick3/new-api:${{ steps.version.outputs.value }}-${{ matrix.arch }}
+            ghcr.io/${{ github.repository }}:alpha-${{ matrix.arch }}
+            ghcr.io/${{ github.repository }}:${{ steps.version.outputs.value }}-${{ matrix.arch }}
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
@@ -118,16 +118,16 @@ jobs:
       - name: Create & push manifest (Docker Hub - alpha)
         run: |
           docker buildx imagetools create \
-            -t calciumion/new-api:alpha \
-            calciumion/new-api:alpha-amd64 \
-            calciumion/new-api:alpha-arm64
+            -t nick3/new-api:alpha \
+            nick3/new-api:alpha-amd64 \
+            nick3/new-api:alpha-arm64
 
       - name: Create & push manifest (Docker Hub - versioned alpha)
         run: |
           docker buildx imagetools create \
-            -t calciumion/new-api:${VERSION} \
-            calciumion/new-api:${VERSION}-amd64 \
-            calciumion/new-api:${VERSION}-arm64
+            -t nick3/new-api:${VERSION} \
+            nick3/new-api:${VERSION}-amd64 \
+            nick3/new-api:${VERSION}-arm64
 
       - name: Log in to GHCR
         uses: docker/login-action@v3

.github/workflows/docker-image-arm64.yml

@@ -63,8 +63,8 @@ jobs:
         uses: docker/metadata-action@v5
         with:
           images: |
-            calciumion/new-api
-#            ghcr.io/${{ env.GHCR_REPOSITORY }}
+            nick3/new-api
+            ghcr.io/${{ github.repository }}
 
       - name: Build & push single-arch (to both registries)
         uses: docker/build-push-action@v6
@@ -73,10 +73,10 @@ jobs:
           platforms: ${{ matrix.platform }}
           push: true
           tags: |
-            calciumion/new-api:${{ env.TAG }}-${{ matrix.arch }}
-            calciumion/new-api:latest-${{ matrix.arch }}
-#            ghcr.io/${{ env.GHCR_REPOSITORY }}:${{ env.TAG }}-${{ matrix.arch }}
-#            ghcr.io/${{ env.GHCR_REPOSITORY }}:latest-${{ matrix.arch }}
+            nick3/new-api:${{ env.TAG }}-${{ matrix.arch }}
+            nick3/new-api:latest-${{ matrix.arch }}
+#            ghcr.io/${{ github.repository }}:${{ env.TAG }}-${{ matrix.arch }}
+#            ghcr.io/${{ github.repository }}:latest-${{ matrix.arch }}
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
@@ -104,16 +104,16 @@ jobs:
       - name: Create & push manifest (Docker Hub - version)
         run: |
           docker buildx imagetools create \
-            -t calciumion/new-api:${TAG} \
-            calciumion/new-api:${TAG}-amd64 \
-            calciumion/new-api:${TAG}-arm64
+            -t nick3/new-api:${TAG} \
+            nick3/new-api:${TAG}-amd64 \
+            nick3/new-api:${TAG}-arm64
 
       - name: Create & push manifest (Docker Hub - latest)
         run: |
           docker buildx imagetools create \
-            -t calciumion/new-api:latest \
-            calciumion/new-api:latest-amd64 \
-            calciumion/new-api:latest-arm64
+            -t nick3/new-api:latest \
+            nick3/new-api:latest-amd64 \
+            nick3/new-api:latest-arm64
 
       # ---- GHCR ----
 #      - name: Log in to GHCR

.gitignore

@@ -16,6 +16,8 @@ new-api
 tiktoken_cache
 .eslintcache
 .gocache
+/.spec-workflow
 
 electron/node_modules
 electron/dist
+/.serena

AGENTS.md

@@ -0,0 +1,29 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `main.go` launches the Gin backend, loading cross-cutting helpers from `middleware/`, `logger/`, and configuration in `setting/`.
+- HTTP flow maps from `router/` to handler logic in `controller/`, with business services in `service/`, persistence in `model/`, and shared contracts in `dto/` and `types/`.
+- Frontend lives in `web/` (Vite + Bun), shared utilities in `common/` and `constant/`, docs in `docs/`, and maintenance scripts or migrations in `bin/`.
+
+## Build, Test, and Development Commands
+- `go run main.go` or `make start-backend` runs the API against the active `.env`; use `go build ./...` before raising a PR.
+- Inside `web/`, execute `bun install` then `bun run dev`; bundle assets with `make build-frontend` when preparing releases.
+- `docker compose up -d` spins up supporting services for end-to-end checks; shut down with `docker compose down`.
+
+## Coding Style & Naming Conventions
+- Back-end code must pass `gofmt` and `go vet ./...`; keep packages single-purpose and exported identifiers in PascalCase, internals in camelCase.
+- Prefer dependency injection through interfaces, avoid cyclic imports, and centralize shared constants in `constant/`.
+- Frontend follows Prettier (`bun run lint:fix`) and ESLint (`bun run eslint:fix`); stick to functional components, hook-based state, and kebab-case filenames in `web/public/`.
+- Add new configuration keys to `.env.example` using uppercase snake_case with concise inline notes.
+
+## Testing Guidelines
+- Write table-driven `*_test.go` cases alongside implementation and run `go test ./... -race`; mock external services via interfaces.
+- Use `bin/time_test.sh <domain> <key> <count> [model]` for latency baselines and document findings in PRs; add Vitest specs under `web/src/__tests__/` as UI logic grows.
+
+## Commit & Pull Request Guidelines
+- Follow the repository’s Conventional Commit pattern (`fix:`, `feat:`, `chore:`) with subjects ≤72 characters and informative bodies.
+- PRs should outline scope, risk, verification, linked issues, and include screenshots or payload samples when altering UX or APIs; confirm Go build/test and frontend lint/build before requesting review.
+
+## Security & Configuration Tips
+- Keep secrets out of version control; rely on `.env` locally and managed secret stores in deployment.
+- Rotate provider credentials through the admin console and document operational changes in `docs/`.

RELEASE_NOTES.md

@@ -0,0 +1,34 @@
+## Release v0.9.8
+
+Release date: 2025-10-15
+
+Summary
+- Minor release: small improvements and housekeeping following v0.9.7-patch.1. No breaking API changes.
+
+Notable changes
+- Chore: Bump version to v0.9.8 and update release metadata.
+- Chore: Prepare release notes.
+
+Migration notes
+- No database migrations required.
+
+Contact
+- If you see any issues after upgrading, please open an issue or contact the maintainers.
+
+# Release v0.9.7-patch.1
+
+Release date: 2025-10-13
+
+Summary
+- Patch release to address minor regressions and housekeeping after the alpha cycle. This does not introduce new public APIs.
+
+Notable fixes
+- Fix: Restore backwards-compatible behavior in configuration parsing that could break some deployments.
+- Fix: Correct logging header to include request IDs for certain background jobs.
+- Chore: Bump version and update release metadata.
+
+Migration notes
+- No database migrations required.
+
+Contact
+- If you see any issues after upgrading, please open an issue or contact the maintainers.

VERSION

@@ -0,0 +1 @@
+v0.9.8

bin/add_log_detail_index.sql

@@ -0,0 +1,20 @@
+-- Migration: Add index on log_details.created_at for efficient retention cleanup
+-- Date: 2025-09-30
+-- Purpose: Optimize the log detail retention cleanup process by adding an index
+--          on the created_at column to avoid full table scans during deletion.
+
+-- Check if index exists before creating (for MySQL/MariaDB)
+-- For existing databases, run this migration to add the index:
+
+CREATE INDEX IF NOT EXISTS idx_log_details_created_at ON log_details(created_at);
+
+-- For PostgreSQL, use:
+-- CREATE INDEX IF NOT EXISTS idx_log_details_created_at ON log_details(created_at);
+
+-- For SQLite:
+-- CREATE INDEX IF NOT EXISTS idx_log_details_created_at ON log_details(created_at);
+
+-- Verify the index was created:
+-- MySQL: SHOW INDEX FROM log_details WHERE Key_name = 'idx_log_details_created_at';
+-- PostgreSQL: SELECT * FROM pg_indexes WHERE tablename = 'log_details' AND indexname = 'idx_log_details_created_at';
+-- SQLite: SELECT * FROM sqlite_master WHERE type = 'index' AND tbl_name = 'log_details' AND name = 'idx_log_details_created_at';

common/constants.go

@@ -72,6 +72,7 @@ var DebugEnabled bool
 var MemoryCacheEnabled bool
 
 var LogConsumeEnabled = true
+var DetailedLogRetentionDays = 30
 
 var SMTPServer = ""
 var SMTPPort = 587

common/gin.go

@@ -18,17 +18,20 @@ import (
 const KeyRequestBody = "key_request_body"
 
 func GetRequestBody(c *gin.Context) ([]byte, error) {
-	requestBody, _ := c.Get(KeyRequestBody)
-	if requestBody != nil {
-		return requestBody.([]byte), nil
+	if cached, ok := c.Get(KeyRequestBody); ok {
+		if data, ok := cached.([]byte); ok {
+			return data, nil
+		}
 	}
-	requestBody, err := io.ReadAll(c.Request.Body)
+	raw, err := io.ReadAll(c.Request.Body)
 	if err != nil {
 		return nil, err
 	}
 	_ = c.Request.Body.Close()
-	c.Set(KeyRequestBody, requestBody)
-	return requestBody.([]byte), nil
+	CapturePayloadForLog(c, constant.ContextKeyLoggedRequestBody, raw)
+	c.Set(KeyRequestBody, raw)
+	c.Request.Body = io.NopCloser(bytes.NewBuffer(raw))
+	return raw, nil
 }
 
 func UnmarshalBodyReusable(c *gin.Context, v any) error {