4.1 KiB
4.1 KiB
Project Status - Guardrail MCP Server
Last Updated: 2026-03-14 Branch: main Current Version: v2.8.0
Completed Sprints
Sprint 004: Document Ingestion System - COMPLETED
- Status: ✅ COMPLETE
- Date Completed: 2026-02-09
- Team: 4 parallel agents
Implemented:
- Database migrations for ingest tracking
- Markdown parser with YAML frontmatter support
- Ingest service (repo sync + file upload)
- Update checker (Docker + Guardrail versions)
- Web UI file upload with drag-and-drop
- Update notifier with daily checks
API Endpoints:
- POST /api/ingest/upload - File upload
- POST /api/ingest/sync - Repo sync
- GET /api/ingest/status - Sync status
- GET /api/ingest/orphans - Orphaned docs
- DELETE /api/ingest/orphans/:id - Delete orphan
- GET /api/updates/status - Check updates
- POST /api/updates/check - Trigger check
Sprint 001: MCP Gap Implementation - COMPLETED
- Status: ✅ COMPLETE
- Date Completed: 2026-02-08
- Coverage: 11 tools, 8 resources
Implemented:
- 5 gap tools (validate_scope, validate_commit, prevent_regression, check_test_prod_separation, validate_push)
- 6 gap resources (agent-guardrails, four-laws, halt-conditions, workflows, standards, pre-work-checklist)
Sprint 002: Web UI Implementation - COMPLETED
- Status: ✅ COMPLETE
- Date Completed: 2026-02-08
- Coverage: 26/26 API endpoints, 6/6 pages
Implemented:
- Complete SPA with 6 pages (Dashboard, Documents, Rules, Projects, Failures, IDE Tools)
- 26 API endpoints in api.js
- 5 reusable components (Navigation, DataTable, Forms, Modal, Toast)
- 3 CSS files (variables, components, layout)
- Hash-based routing
Known Issues/Enhancements:
| Item | Priority | Status |
|---|---|---|
| Missing createFailure() method | High | ✅ Fixed |
| Missing --sidebar-width-mobile | Medium | ✅ Fixed |
| Missing slideIn keyframes | Low | Already exists |
| Tooltip component | Low | Not implemented |
| Dropdown menu component | Low | Not implemented |
| 404 page | Low | Redirects to dashboard |
Sprint 003: Documentation Parity - PENDING
- Status: ⏳ NOT STARTED
- Focus: Align documentation with implementation
Planned Work:
- Update API documentation to match implementation
- Add Web UI user guide
- Document all MCP tools and resources
- Update README with deployment instructions
Deployment Status
AI01 (0.0.0.0):
- MCP Port: 8094
- Web UI Port: 8095
- Version: v1.11.7
- Status: ✅ Running
- Features: Ingest system, update notifications, file upload, auth fixes, comprehensive documentation
Web UI Access:
- URL: http://0.0.0.0:8095/web/
- API Key:
<REDACTED — rotate and set via environment variable>
Code Review Rounds Completed
Round 1: SPA Fallback Fix
- Fixed static file serving order
- SPA fallback now checks file existence
Round 2: CORS and JS Fixes
- Added OPTIONS support for CORS preflight
- Fixed Failures.js parameter name
Round 3: Database Type Fixes
- Fixed Project.ActiveRules type (pq.StringArray)
- Fixed Project.Metadata type (jsonb handling)
- Fixed PreventionRule.PatternHash (nullable)
Next Steps
-
Sprint 003: Documentation Parity
- Update API.md with all endpoints
- Add Web UI user guide
- Update CHANGELOG
-
Optional Enhancements
- Add tooltip component
- Add dropdown menu component
- Implement 404 page
- Add light theme support
Agent Team Reviews Completed
| Agent | Focus | Status |
|---|---|---|
| API Review | api.js endpoints | ✅ 26/26 complete |
| Pages Review | 6 SPA pages | ✅ All complete |
| Components Review | 5 components | ✅ All complete |
| Design System Review | CSS files | ✅ 85% complete |
| Routing Review | Router + app.js | ✅ Complete |
Git Commits
| Commit | Description |
|---|---|
| 4dbb19a | fix(web-ui): add missing API endpoint and CSS variable |
| 7b01d34 | docs: mark Sprint 001 as completed |
| 771a977 | fix(models): fix database type scanning issues |
| 08354a5 | fix(web-ui): CORS preflight and JS fixes |
| 1be578f | fix(web-ui): fix SPA fallback route blocking static files |