ActsAsGeek Documentation

ActsAsGeek currently exposes a small set of verified product surfaces: uptime monitoring, public status pages, TaskFlow task creation, LLM usage ingestion, project inbox workflows, security run management, and integration credential storage.

Purpose

Use this documentation to understand what the codebase actually supports today and how to integrate with it. The live documentation route is /documentation. Most files under docs/ are now treated as archive, spec, or review material rather than current product docs.

Modules In Scope

• Monitoring: create monitors, run five-minute checks, and expose public status pages.
• TaskFlow: create tasks directly or generate them from a PRD with the authenticated API.
• Cost tracking: ingest LLM usage events through the SDK-backed route or the v1 envelope route.
• Security: manage security runs and reports; legacy pentest scan simulation still exists but is not production-ready.
• Inbox and agents: assign a limited set of agent types to inbox messages and execute them asynchronously.
• Integrations: store provider credentials, webhook endpoints, and project environment secrets.
• Portfolio Pulse: read a portfolio summary and per project pulse state.

Current Constraints

Partial: the security dashboard still returns mock compliance data, and the legacy /api/projects/[projectId]/pentest/scan route returns 501 in production.

Partial: Portfolio Pulse returns open_prs: 0 for every project; the GitHub-backed PR count is marked TODO in the source.

Not implemented: a separate public developer portal for the files under docs/. Those files are internal artifacts unless explicitly routed from app/documentation.