84 lines
4.5 KiB
Markdown
84 lines
4.5 KiB
Markdown
# Workday-MCP status page
|
|
|
|
**Updated:** 2026-04-03
|
|
|
|
This page is the high-visibility execution status for the Workday Integration
|
|
Suite (WIS) deliverables in this repository.
|
|
|
|
## Traffic-light legend
|
|
|
|
| Status | Meaning |
|
|
| --- | --- |
|
|
| 🟢 Green | Functional / production-ready |
|
|
| 🟡 Yellow | In progress / development |
|
|
| 🔴 Red | Blocked / not started |
|
|
|
|
## Program status summary
|
|
|
|
| Component | WIS traceability | Status | Notes |
|
|
| --- | --- | --- | --- |
|
|
| Modular runtime architecture (`server.py` + `lib/data.py`) | WIS-006 | 🟢 Green | Migrated from single-file script to modular layout for maintainability and cleaner backend swap-in. |
|
|
| Worker status tool (`get_worker_status`) | WIS-009 | 🟢 Green | Tool returns structured, allowlist-oriented worker payloads from deterministic mock data. |
|
|
| Worker manager lookup (`get_worker_manager`) | WIS-017 prep | 🟢 Green | Manager relationship resolution supports normal, missing-manager, and unresolved-manager scenarios. |
|
|
| Manager mismatch scan (`scan_manager_mismatches`) | WIS-017 | 🟢 Green | Prototype is functional and scans all current mock records, including intentional mismatch scenarios. |
|
|
| Mock data foundation (9 worker records) | WIS-007, WIS-017 | 🟢 Green | Dataset includes valid hierarchy records and one intentional mismatch for detector validation. |
|
|
| Transition to real Workday API backend | WIS-008 | 🟡 Yellow | Next milestone: replace mock-backed execution path with API token flow and secure secret handling. |
|
|
| Non-prod Workday auth and access readiness | WIS-001, WIS-002, WIS-003 | 🔴 Red | External dependency closure required before end-to-end non-prod API validation can complete. |
|
|
|
|
## Discipline drives quality
|
|
|
|
| Engineering discipline pillar | Current state | Evidence |
|
|
| --- | --- | --- |
|
|
| Type hinting discipline | 🟢 Green | Function signatures and return contracts in [Workday/workday-mcp/server.py](Workday/workday-mcp/server.py) and typed mock map in [Workday/workday-mcp/lib/data.py](Workday/workday-mcp/lib/data.py). |
|
|
| Pylance quality gate | 🟢 Green | Current implementation maintains zero known Pylance errors in active Workday-MCP runtime files. |
|
|
| Modular structure discipline | 🟢 Green | Separation of orchestration (`server.py`) and dataset/backend data layer (`lib/data.py`) enables controlled evolution to API mode. |
|
|
| Traceability discipline | 🟢 Green | WIS IDs embedded in docstrings and aligned with sprint board/backlog artifacts. |
|
|
|
|
## Current sprint alignment (WIS roadmap)
|
|
|
|
| Workstream | Primary IDs | Status | Outcome target |
|
|
| --- | --- | --- | --- |
|
|
| Core read tooling stabilization | WIS-006 to WIS-011 | 🟡 Yellow | Preserve schema stability while preparing backend transition to real API calls. |
|
|
| Mismatch detection execution | WIS-014 to WIS-018 | 🟡 Yellow | WIS-017 manager mismatch detector is prototyped and functional; remaining categories continue in sequence. |
|
|
| Automation and reporting | WIS-019 to WIS-026 | 🔴 Red | Daily/weekly flow automation and KPI reporting start after API-path readiness and detector completion. |
|
|
|
|
## Recent activity
|
|
|
|
- Completed modular architecture migration from single-file runtime to
|
|
`server.py` + `lib/data.py`.
|
|
- Implemented and validated three operational MCP tools:
|
|
`get_worker_status`, `get_worker_manager`, and `scan_manager_mismatches`.
|
|
- Confirmed WIS-017 prototype behavior against 9 mock worker records,
|
|
including intentional manager mismatch coverage.
|
|
- Established next delivery focus on WIS-008 (mock-to-real Workday API
|
|
transition).
|
|
|
|
## Next milestone focus
|
|
|
|
| Milestone | ID | Status | Exit criteria |
|
|
| --- | --- | --- | --- |
|
|
| Mock-to-API transition | WIS-008 | 🟡 Yellow | Obtain non-prod credentials, complete secure token flow, execute first API-backed read tool in runtime path. |
|
|
|
|
## Local Development Quick-Start
|
|
|
|
### 1. Activate Environment
|
|
|
|
`source .venv/Scripts/activate`
|
|
|
|
### 2. Launch Inspector
|
|
|
|
`npx @modelcontextprotocol/inspector python server.py`
|
|
|
|
### 3. Port Cleanup (If Blocked)
|
|
|
|
- **Proxy (6277):** `taskkill //F //IM node.exe`
|
|
- **Inspector (6274):** `taskkill //F //IM node.exe`
|
|
|
|
## Reference documents
|
|
|
|
- [Workday execution backlog](Workday/Planning/workday-ad-identity-sync-next-steps.md)
|
|
- [Workday sprint board](Workday/Planning/workday-ad-identity-sync-sprint-board.md)
|
|
- [Workday implementation plan](Workday/Planning/workday-mcp-implementation-plan.md)
|
|
- [Workday installation guide](Workday/Planning/workday-mcp-install-guide.md)
|
|
- [Workday runtime entrypoint](Workday/workday-mcp/server.py)
|