TheFlow
|
9023338700
|
feat: add comprehensive governance services API documentation
Task 12 Progress - Governance Services Documentation Complete:
Added comprehensive documentation for all 6 governance services:
1. InstructionPersistenceClassifier
- POST /api/governance/classify
- Quadrant classification (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM)
- Persistence levels (HIGH/MEDIUM/LOW)
- Request/response examples with quadrant types table
2. CrossReferenceValidator
- POST /api/governance/validate
- Prevents training pattern override (27027 failure mode)
- Validation status types (APPROVED/REJECTED/WARNING)
- Conflict detection and recommendations
3. BoundaryEnforcer
- POST /api/governance/enforce
- Values decision blocking (privacy, ethics, sovereignty)
- Boundary categories and alternatives
- Human approval requirements
4. ContextPressureMonitor
- POST /api/governance/pressure
- Multi-factor session health tracking
- Pressure levels (NORMAL/ELEVATED/HIGH/CRITICAL/DANGEROUS)
- Checkpoint recommendations
5. MetacognitiveVerifier
- POST /api/governance/verify
- AI self-checks for complex operations
- Scope creep detection
- Confidence scoring and alternatives
6. AuditLogger
- GET /api/audit/audit-logs (with filtering)
- GET /api/audit/audit-analytics
- Comprehensive audit trail
- Aggregated analytics
Changes:
- api-reference.html: 17KB → 37KB (880 lines)
- Updated sidebar navigation with governance services
- All endpoints documented with request/response examples
- Status types, decision categories, and lookup tables included
Future Work:
- docs/plans/TRANSLATION_APPROACH.md: DeepL translation strategy for Task 19
- Remaining: OpenAPI spec, code examples (JS/Python), rate limiting docs
Deployed to: https://agenticgovernance.digital/api-reference.html
|
2025-10-12 11:02:26 +13:00 |
|