API Reference

Compiler endpoints for the full agentic loop.

FounderSignal exposes a small public API surface that proves the workflow is more than static text. The endpoints run agent confrontation, artifact compilation, correction refinement, workspace packet generation, GitHub packet generation, Vault handoff, eve manifest inspection, Cron verification, and system-status checks.

POST/api/agent-confrontation

Runs VC, security, and growth specialist checks.

POST/api/compile-brief

Returns `spec`, `schema`, `tasks`, and `manifest` artifacts.

POST/api/refine-artifacts

Applies founder correction and returns updated artifacts.

POST/api/workspace-packet

Generates a Codex/GPT/vibe-coder handoff packet with `/goal`, files, guardrails, and acceptance checks.

POST/api/github-loop

Creates a GitHub issue packet or issue when repo credentials are configured.

POST/api/vault-commit

Returns a session id and SHA-256 content hash.

GET/api/eve-manifest

Returns the eve-style agent directory contract.

GET/api/cron/founder-signal-check

Runs the daily signal review hook.

GET/api/system-status

Verifies route, artifact, and Cron contracts.

Compile Brief

POST /api/compile-brief

curl -X POST https://foundersignal-buildweek.vercel.app/api/compile-brief \
  -H "Content-Type: application/json" \
  -d '{"idea":"B2B AI workflow","customer":"founder-led teams","score":88}'

Workspace Packet

POST /api/workspace-packet

curl -X POST https://foundersignal-buildweek.vercel.app/api/workspace-packet \
  -H "Content-Type: application/json" \
  -d '{"idea":"AI onboarding agent for service founders","customer":"solo service operators","score":86,"corrections":["Keep MVP under one week"]}'

Correction Loop

POST /api/refine-artifacts

curl -X POST https://foundersignal-buildweek.vercel.app/api/refine-artifacts \
  -H "Content-Type: application/json" \
  -d '{"idea":"B2B AI workflow","correction":"Must support tenant-level RLS","previous_response_id":"fs_live_demo"}'

Response Contract

artifact payload

{
  "ok": true,
  "data": {
    "artifacts": {
      "spec": "string",
      "schema": "string",
      "tasks": "string",
      "manifest": "string"
    },
    "previous_response_id": "string"
  }
}