test: comprehensive E2E test suite

.env.example

@@ -0,0 +1,5 @@
+GOOGLE_OAUTH_CLIENT_ID=your_client_id_here
+GOOGLE_OAUTH_CLIENT_SECRET=your_client_secret_here
+WORKSPACE_MCP_PORT=8000
+# Optional: Set to true to enable OAuth 2.1 features
+# MCP_ENABLE_OAUTH21=true

.gitattributes

@@ -0,0 +1,8 @@
+# Auto-generated .gitattributes for cross-platform line ending consistency
+# Default: LF for all text files
+* text=auto eol=lf
+
+# Windows scripts require CRLF
+*.ps1 text eol=crlf
+*.psm1 text eol=crlf
+

.gitignore

@@ -22,10 +22,19 @@ venv/
 
 # ---- Secrets -----------------------------------------------------------
 client_secret.json
+.workspace_mcp_paused
+secrets/*.generated.env
 
 # ---- Logs --------------------------------------------------------------
 mcp_server_debug.log
 
 # ---- Local development files -------------------------------------------
 /.credentials
 /.claude
+
+# Generated metadata - do not commit
+_open_prs.json
+_open_issues.json
+issues.json
+_repo_metadata.json
+

.kilo-prompt/mission.txt

@@ -0,0 +1,35 @@
+Repo: Coldaine/google_workspace_mcp
+
+You are a coding agent with repo read/write + shell + PR capability.
+
+Mission:
+1) Read docs to determine what MCP surface area is implemented (Gmail/Drive/Calendar/etc).
+2) Produce a plan to make the MCP server reliable and operator-friendly.
+3) Execute Milestone 1 now.
+
+Required reading:
+- README.md + docs/
+- MCP server spec / tool list (if present)
+- Auth setup instructions (OAuth, service accounts) and security constraints
+- Open issues/PRs
+
+Deliverables:
+A) "Tool inventory":
+   - List each MCP tool, inputs/outputs, and auth requirements
+   - Known limitations and failure modes
+
+B) "Execution plan":
+   - Milestone 1: correctness + usability: working quickstart, env example, minimal smoke tests
+   - Milestone 2+: expand tool coverage + stronger error models
+
+C) Execute Milestone 1:
+   - Add a smoke test mode that runs without real credentials (mock layer) + an integration test path (optional)
+   - Harden error messages for auth failures and quota failures
+   - Open PR
+
+Constraints:
+- No credentials in repo; strong .env.example and redaction.
+- Avoid interactive flows in CI; provide local-only integration tests.
+
+Stopping condition:
+- One PR open that improves quickstart reliability + adds minimal test coverage.

.kilo-prompt/review-mission.txt

@@ -0,0 +1,22 @@
+You are a coding agent working on PR #7 in this repository (branch: kilo/mock-services-and-env).
+
+Your mission is to fully address all open review comments and ensure the PR is complete and correct.
+
+Steps:
+1. Run: gh pr view 7 --comments
+2. Run: gh pr diff 7
+3. Read tests/mock_services.py, .env.example, and any referenced tool files (gdrive/drive_tools.py, gsheets/sheets_tools.py, gcalendar/calendar_tools.py)
+4. Address EVERY comment:
+   - P1: MockCalendarService defines `list` twice (calendarList.list and events.list) — Python only keeps the second, breaking calendarList flow. Fix: split into separate resource classes.
+   - P1: MockSheetsService defines `get` twice (spreadsheets.get and values.get) — use separate _SpreadsheetsResource and _ValuesResource sub-objects.
+   - P2: MockDriveService.update — body=None causes TypeError when merged with **body. Guard: if body is not None else {}.
+   - Remove unused imports: AsyncMock, Optional (causes ruff check failure).
+   - export_media imports HttpRequest but never uses it — either use it or remove it (suggestion: return MagicMock(spec=HttpRequest)).
+   - .env.example: USER_GOOGLE_EMAIL is marked REQUIRED but should be OPTIONAL — update comment as suggested.
+   - .env.example: port default inconsistency (4100 vs 8000) — align to actual runtime default.
+5. Run `python -m pytest tests/mock_services.py` (or similar) to verify fixes.
+6. Commit all fixes to the PR branch.
+7. Push.
+8. Reply to review: gh pr review 7 --comment -b "Addressed all comments: ..."
+
+Stopping condition: All review bugs fixed, tests pass, committed and pushed.