claw-code/.guardrails/STATUS.md

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:


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