diff --git a/CLEANUP_NOTES.md b/CLEANUP_NOTES.md index f08641f..633e3ba 100644 --- a/CLEANUP_NOTES.md +++ b/CLEANUP_NOTES.md @@ -1,4 +1,4 @@ -## Cleanup Notes ~ May 4, 2026 +## Cleanup Notes ~ May 6, 2026 This repository currently mixes multiple partially finished workstreams. The goal is to recover to a clean, reviewable git state with focused commits so @@ -30,13 +30,55 @@ The current dirty tree appears to contain these distinct units: - [x] Inventory all modified and untracked files. - [x] Identify likely project groupings for clean commits. - [x] Confirm `LOCAL_CHANGELOG.md` aligns with Helpdesk API patch files. -- [ ] Stage and commit Helpdesk API patch as a focused unit. -- [ ] Stage and commit post-import automation as a focused unit. -- [ ] Stage and commit semantic index files as a focused unit. -- [ ] Stage and commit redMCP feature updates as a focused unit. -- [ ] Stage and commit redmine-communicator skill files (optional split). -- [ ] Run targeted syntax/tests for each committed unit. -- [ ] Confirm final worktree state and note any intentionally uncommitted files. +- [x] Stage and commit Helpdesk API patch as a focused unit. +- [x] Stage and commit post-import automation as a focused unit. +- [x] Stage and commit semantic index files as a focused unit. +- [x] Stage and commit redMCP feature updates as a focused unit. +- [x] Stage and commit redmine-communicator skill files (optional split). +- [x] Run targeted syntax/tests for each committed unit. +- [x] Confirm final worktree state and note any intentionally uncommitted files. + +## Cleanup result + +Committed units: + +- `fba494d` Add Helpdesk issue API include serializer +- `faad708` Automate post-import refresh and validation workflow +- `b305544` Add semantic-index service, deployment assets, and tests +- `4c931ba` Expand redMCP safe issue operations and HTTP handling +- `42fc831` Add redmine-communicator skill docs and setup tooling +- `def9084` Handoff notes for next agent/workflow +- `22c8e91` Sanitize noisy MCP text fields by default +- `a7d23cd` Resolve human project names in MCP project_id args + +Intentionally untracked local files: + +- `redMCP/startProd.sh` +- `roadmap/` + +Recent validation run for redMCP changes: + +- `php -l app/McpDispatcher.php` +- `php -l app/McpEnvironment.php` +- `php -l app/mcp-http-router.php` +- `php -l bin/redmcp-server.php` +- `php -l bin/test-redmine-structure.php` +- `php bin/test-redmine-structure.php` (`OK 90 assertions`) + +## Handoff notes for next session + +- Gitea private repo is created and current history was pushed. +- Monorepo approach is acceptable; keep path-scoped commits and deployment-unit + boundaries. +- Production semantic-index target is a separate host from production Redmine. +- redMCP improvement focus is operational quality: + - useful error/access logging without console spam, + - easy background operation, + - simple install/remove/status workflow. +- A single fixed systemd service is not preferred for redMCP because multiple + concurrent identities/API keys may be needed. Prefer an instance model. +- If systemd is used for redMCP, implement a simple operator script with + `install`, `remove`, and `status` flows. ## Notes to keep in mind