150 lines
4.1 KiB
Markdown
150 lines
4.1 KiB
Markdown
# 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
|
|
|
|
1. **Sprint 003: Documentation Parity**
|
|
- Update API.md with all endpoints
|
|
- Add Web UI user guide
|
|
- Update CHANGELOG
|
|
|
|
2. **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 |
|