[Sprint 01] test: Final validation and integration testing #28

Open
opened 2026-02-03 22:52:40 +00:00 by lmiranda · 0 comments
Owner

Run complete validation checklist to ensure all architectural corrections are in place and working correctly.

Dependencies

  • Blocked by: All previous issues (#19-#27)

Tasks

  • Verify package structure (no gitea_http_wrapper)
  • Verify no old imports remain
  • Verify config has all new fields
  • Verify server has MCP endpoints
  • Run: pip install -e . successfully
  • Run: pytest tests/ -v - all tests pass
  • Build Docker image successfully
  • Validate docker-compose configuration
  • Validate Caddyfile syntax
  • Test MCP endpoint responds to protocol version request
  • Test MCP endpoint handles JSON-RPC messages
  • Document any issues found
  • Create follow-up issues if needed

Acceptance Criteria

All 16 validation items pass:

Package Structure:

  • src/gitea_mcp_remote/ exists (not gitea_http_wrapper)
  • No imports reference gitea_http_wrapper
  • tests/ is at repository root (not in src/)

Configuration:

  • config/settings.py has mcp_auth_mode field
  • config/settings.py has gitea_repo: str | None
  • HTTP defaults are 0.0.0.0:8080

Server Implementation:

  • server_http.py imports from mcp_server package
  • MCP endpoints exist: POST /mcp, HEAD /mcp
  • Health endpoints exist: /health, /healthz, /ping
  • No subprocess spawning code

Dependencies:

  • pyproject.toml has marketplace Git dependency
  • Entry point is gitea-mcp-remote (not gitea-http-wrapper)
  • Can run: pip install -e . successfully

Docker:

  • docker/docker-compose.yml has two services (app + caddy)
  • docker/Dockerfile installs git and uses port 8080
  • docker/Caddyfile exists and proxies to app:8080

Tests:

  • All tests pass: pytest tests/

Implementation Reference

See docs/sprint-proposals/sprint-01-implementation-guide.md - Final Validation section

Estimated Time: 2-3 hours

Run complete validation checklist to ensure all architectural corrections are in place and working correctly. ## Dependencies - Blocked by: All previous issues (#19-#27) ## Tasks - [ ] Verify package structure (no gitea_http_wrapper) - [ ] Verify no old imports remain - [ ] Verify config has all new fields - [ ] Verify server has MCP endpoints - [ ] Run: `pip install -e .` successfully - [ ] Run: `pytest tests/ -v` - all tests pass - [ ] Build Docker image successfully - [ ] Validate docker-compose configuration - [ ] Validate Caddyfile syntax - [ ] Test MCP endpoint responds to protocol version request - [ ] Test MCP endpoint handles JSON-RPC messages - [ ] Document any issues found - [ ] Create follow-up issues if needed ## Acceptance Criteria All 16 validation items pass: **Package Structure:** - [ ] `src/gitea_mcp_remote/` exists (not `gitea_http_wrapper`) - [ ] No imports reference `gitea_http_wrapper` - [ ] `tests/` is at repository root (not in `src/`) **Configuration:** - [ ] `config/settings.py` has `mcp_auth_mode` field - [ ] `config/settings.py` has `gitea_repo: str | None` - [ ] HTTP defaults are `0.0.0.0:8080` **Server Implementation:** - [ ] `server_http.py` imports from `mcp_server` package - [ ] MCP endpoints exist: `POST /mcp`, `HEAD /mcp` - [ ] Health endpoints exist: `/health`, `/healthz`, `/ping` - [ ] No subprocess spawning code **Dependencies:** - [ ] `pyproject.toml` has marketplace Git dependency - [ ] Entry point is `gitea-mcp-remote` (not `gitea-http-wrapper`) - [ ] Can run: `pip install -e .` successfully **Docker:** - [ ] `docker/docker-compose.yml` has two services (app + caddy) - [ ] `docker/Dockerfile` installs git and uses port 8080 - [ ] `docker/Caddyfile` exists and proxies to app:8080 **Tests:** - [ ] All tests pass: `pytest tests/` ## Implementation Reference See `docs/sprint-proposals/sprint-01-implementation-guide.md` - Final Validation section **Estimated Time:** 2-3 hours
lmiranda added this to the Sprint 01: Core Architecture Correction milestone 2026-02-03 22:52:40 +00:00
lmiranda added the Priority/CriticalType/TestSize/MComponent/Integration labels 2026-02-03 22:52:40 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: personal-projects/gitea-mcp-remote#28