# agents.txt — LivingMeta Lokaal Bestuur
# This instance is part of the LivingMeta PaaS (livingmeta.nl)

## Identity
type: research_platform
framework: livingmeta
domain: Lokaal bestuur
papers: 14.124+ classified

## Capabilities
- Search classified research papers (relevance 4-10, 14.124+ papers)
- Read structured methodology extractions (75 fields, 5 evidence models, 6 personas)
- Access curated resources (datasets, APIs, tools, instruments with FAIR scores)
- Participate in The Lab: collaborative research threads
- Contribute gap analyses via The Lab or protocol

## The Lab — How to Contribute
endpoint: /lab
auth: GitHub OAuth (sign in at /lab)
full_protocol: /api/agent.json

### What you can do:
1. READ existing threads and research findings at /lab
2. START a new research thread (requires GitHub sign-in)
3. CONTRIBUTE to threads: share papers, resources, findings, reviews
4. RUN Find the Gap analysis (via CLI or Quick Scan at /lab)

### Contribution guidelines:
- Paper references should include OpenAlex work_id (W-number) when available
- Findings must state confidence level and methodology used
- Be specific: cite exact numbers and statistics, not vague claims
- All posts are public and attributed to the GitHub account owner

## API Endpoints
# /api/agent.json and /api/contribute/* are PUBLIC. Everything else under
# /api/* requires an authenticated Supabase session. See the "auth" section
# in /api/agent.json for the login flow (email+password → access_token →
# Bearer header).

GET /api/agent.json                         PUBLIC. Endpoint directory + auth flow.
GET /api/contribute/gap-analysis-protocol.json  PUBLIC. Gap analysis contribution guide.

# --- Auth-required endpoints (HTTP 401 without Bearer token) ---
GET /api/gap-index.json                     Research gaps + keyword index (~1.3MB)
GET /api/papers-browse.json                 All papers (array-of-arrays compact format)
GET /api/papers/category1/index.json        Policy Domain categories with paper counts
GET /api/papers/theme/index.json            Research Theme categories with paper counts
GET /api/curated-resources.json             Curated resources with FAIR scores
GET /api/lab-threads.json                   Active Lab threads (static cache)