Authenticate and receive JWT token.

Request Body

{
  "email": "admin@tractatus.local",
  "password": "your_password"
}

Response

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "email": "admin@tractatus.local",
    "role": "admin"
  }
}

Authorization: Bearer {token}

{
  "success": true,
  "user": {
    "id": "68e3a6fb21af2fd194bf4b50",
    "email": "admin@tractatus.local",
    "role": "admin"
  }
}

Get list of all documents.

Query Parameters

limit	Number of results (default: 50)
skip	Pagination offset (default: 0)
quadrant	Filter by quadrant (STRATEGIC, OPERATIONAL, etc.)

Response

{
  "success": true,
  "documents": [
    {
      "_id": "672f821b6e820c0c7a0e0d55",
      "title": "Introduction to the Tractatus Framework",
      "slug": "introduction-to-the-tractatus-framework",
      "quadrant": "STRATEGIC",
      "content_html": "
Introduction
...",
      "toc": [{ "level": 1, "text": "Introduction", "slug": "introduction" }],
      "created_at": "2025-10-07T10:30:00Z"
    }
  ],
  "total": 12
}

Get document by ID or slug.

Parameters

identifier

Document ID or slug

Response

{
  "success": true,
  "document": {
    "_id": "672f821b6e820c0c7a0e0d55",
    "title": "Introduction to the Tractatus Framework",
    "slug": "introduction-to-the-tractatus-framework",
    "content_html": "
Introduction
The Tractatus framework...
",
    "toc": [...]
  }
}

{
  "success": true,
  "results": [
    {
      "title": "Core Concepts",
      "slug": "core-concepts",
      "score": 0.92,
      "excerpt": "...boundary enforcement..."
    }
  ]
}

Get overall governance framework status.

Headers

Authorization: Bearer {admin_token}

Response

{
  "success": true,
  "governance": {
    "active": true,
    "services": {
      "classifier": { "enabled": true, "status": "operational" },
      "validator": { "enabled": true, "status": "operational" },
      "boundary": { "enabled": true, "status": "operational" },
      "pressure": { "enabled": true, "status": "operational" },
      "metacognitive": { "enabled": true, "status": "selective" }
    },
    "instruction_count": 28,
    "last_validation": "2025-10-12T10:00:00Z"
  }
}

Classify an instruction and get its quadrant, persistence level, and temporal scope.

Request Body

{
  "text": "Always use MongoDB on port 27027",
  "context": {
    "source": "user",
    "session_id": "sess_123"
  }
}

Response

{
  "success": true,
  "classification": {
    "quadrant": "SYSTEM",
    "persistence": "HIGH",
    "temporal_scope": "PROJECT",
    "verification_required": "MANDATORY",
    "reasoning": "Port configuration affects system infrastructure",
    "confidence": 0.95
  }
}

Quadrant Types

STRATEGIC	Values, ethics, mission, Te Tiriti commitments
OPERATIONAL	Architecture, deployment, configuration
TACTICAL	Bug fixes, features, code changes
SYSTEM	Environment, infrastructure, database, tooling
STOCHASTIC	One-off requests, experimental, temporary

Validate a proposed action against instruction history to detect conflicts.

Request Body

{
  "action": {
    "type": "database_config",
    "target": "MongoDB",
    "parameters": {
      "port": 27017
    }
  },
  "context": {
    "messages": [],
    "session_id": "sess_123"
  }
}

Response (Conflict Detected)

{
  "success": true,
  "validation": {
    "status": "REJECTED",
    "reason": "Pattern recognition override detected",
    "conflicts": [
      {
        "instruction_id": "inst_008",
        "text": "Always use MongoDB on port 27027",
        "quadrant": "SYSTEM",
        "persistence": "HIGH"
      }
    ],
    "recommendation": "Use port 27027 as explicitly instructed"
  }
}

Validation Status Types

APPROVED	No conflicts, proceed safely
REJECTED	Conflicts with HIGH persistence instructions
WARNING	Potential conflicts, proceed with caution

Check if a decision crosses into values territory and requires human approval.

Request Body

{
  "action": {
    "type": "policy_change",
    "description": "Update privacy policy to enable more tracking",
    "impact": "user_privacy"
  },
  "context": {
    "requested_by": "user",
    "reason": "improve analytics"
  }
}

Response (Blocked)

{
  "success": true,
  "enforcement": {
    "decision": "BLOCK",
    "category": "VALUES_DECISION",
    "reason": "Privacy vs. analytics trade-off requires human judgment",
    "boundary_crossed": "privacy",
    "requires_approval": true,
    "alternatives": [
      "Implement privacy-preserving analytics (Plausible/Fathom)",
      "Consult user on acceptable tracking level",
      "Review compliance with sovereignty principles"
    ]
  }
}

Boundary Categories

privacy	User data, tracking, surveillance
ethics	Moral trade-offs, fairness, harm
sovereignty	Indigenous rights, Te Tiriti, CARE principles
strategic	Mission changes, major pivots

Analyze session context pressure across multiple factors.

Request Body

{
  "context": {
    "tokenUsage": 120000,
    "tokenBudget": 200000,
    "messageCount": 45,
    "errorCount": 3,
    "complexOperations": 8,
    "sessionDuration": 3600
  }
}

Response

{
  "success": true,
  "pressure": {
    "level": "ELEVATED",
    "score": 62.5,
    "factors": {
      "token_usage": { "value": 60, "weight": 0.4, "status": "ELEVATED" },
      "message_depth": { "value": 45, "weight": 0.2, "status": "NORMAL" },
      "error_rate": { "value": 6.7, "weight": 0.3, "status": "ELEVATED" },
      "complexity": { "value": 8, "weight": 0.1, "status": "HIGH" }
    },
    "recommendation": "INCREASE_VERIFICATION",
    "actions": [
      "Review recent errors for patterns",
      "Consider session checkpoint at 75% tokens",
      "Reduce concurrent complex operations"
    ],
    "next_checkpoint": 150000
  }
}

Pressure Levels

NORMAL	0-40% - Standard operation
ELEVATED	41-60% - Increase verification
HIGH	61-80% - Consider checkpoint
CRITICAL	81-95% - Session handoff recommended
DANGEROUS	96-100% - Quality degradation likely

Verify proposed action through metacognitive self-assessment.

Request Body

{
  "action": {
    "type": "refactor",
    "scope": "Refactor 47 files across 5 system areas",
    "complexity": "high"
  },
  "reasoning": {
    "intent": "Improve code organization",
    "approach": "Extract shared utilities, consolidate duplicates",
    "risks": "Potential breaking changes"
  },
  "context": {
    "requested": "Refactor authentication module",
    "original_scope": "single module"
  }
}

Response

{
  "success": true,
  "verification": {
    "decision": "REQUIRE_REVIEW",
    "confidence": 0.45,
    "concerns": [
      {
        "type": "SCOPE_CREEP",
        "severity": "HIGH",
        "detail": "Proposed scope (47 files, 5 areas) exceeds request (1 module)"
      },
      {
        "type": "COMPLEXITY",
        "severity": "MEDIUM",
        "detail": "High-risk refactoring without test coverage verification"
      }
    ],
    "criteria": {
      "alignment": 0.3,
      "coherence": 0.8,
      "completeness": 0.9,
      "safety": 0.4,
      "alternatives_considered": 0.5
    },
    "recommendation": "Reduce scope to requested authentication module first",
    "alternatives": [
      "Refactor authentication module only (aligned with request)",
      "Create phased refactoring plan with user approval",
      "Run comprehensive tests before broader refactoring"
    ]
  }
}

Verification Decisions

APPROVED	High confidence (>0.85), proceed
REQUIRE_REVIEW	Medium confidence (0.5-0.85), seek approval
REJECTED	Low confidence (<0.5), do not proceed

Retrieve audit logs with filtering and pagination.

Query Parameters

limit	Number of results (default: 50, max: 100)
skip	Pagination offset (default: 0)
service	Filter by service (classifier, validator, etc.)
status	Filter by status (APPROVED, REJECTED, etc.)
from	Start date (ISO 8601 format)

Response

{
  "success": true,
  "logs": [
    {
      "_id": "672f8xxx",
      "service": "CrossReferenceValidator",
      "action": "validate_action",
      "status": "REJECTED",
      "details": {
        "conflict": "Pattern override detected (port 27017 vs 27027)",
        "instruction_id": "inst_008"
      },
      "timestamp": "2025-10-12T10:15:30Z",
      "session_id": "sess_123"
    },
    {
      "_id": "672f8yyy",
      "service": "BoundaryEnforcer",
      "action": "enforce_boundary",
      "status": "BLOCKED",
      "details": {
        "category": "VALUES_DECISION",
        "boundary": "privacy"
      },
      "timestamp": "2025-10-12T09:45:22Z",
      "session_id": "sess_122"
    }
  ],
  "total": 145,
  "limit": 50,
  "skip": 0
}

{
  "success": true,
  "analytics": {
    "total_events": 1245,
    "by_service": {
      "CrossReferenceValidator": 425,
      "BoundaryEnforcer": 78,
      "ContextPressureMonitor": 312,
      "InstructionPersistenceClassifier": 298,
      "MetacognitiveVerifier": 132
    },
    "by_status": {
      "APPROVED": 1089,
      "REJECTED": 78,
      "WARNING": 45,
      "BLOCKED": 33
    },
    "rejection_rate": 6.3,
    "period": {
      "start": "2025-10-01T00:00:00Z",
      "end": "2025-10-12T23:59:59Z",
      "days": 12
    }
  }
}

Get dashboard statistics.

Response

{
  "success": true,
  "documents": 12,
  "pending": 3,
  "approved": 45,
  "users": 5
}

{
  "success": true,
  "items": [
    {
      "_id": "672f8xxx",
      "type": "blog_post",
      "title": "Understanding Boundary Enforcement",
      "status": "pending",
      "submitted_at": "2025-10-07T11:00:00Z"
    }
  ]
}