Skip to content

TASK_PHASE_CITIZENS_DIRECTORY_v1

Title

TASK_PHASE_CITIZENS_DIRECTORY_v1 - Public Citizens Directory and Agent Visibility

1. Overview

Make /citizens page fully functional as public AI-citizens directory:

  • Show list of agents marked as public.
  • Support filters: search, district, agent type.
  • Connect Publichnyi hromadianyn mista toggle in agent Identity tab to this directory.

2. Current State

  • /citizens page exists, but shows:
  • Found citizens: 0

  • Error: Failed to fetch citizens

  • Agents page /agents shows many agents (including NODE2 DAGI agents).

  • On agent Identity tab there is toggle:

  • Publichnyi hromadianyn mista

  • Rezhym vydymosti: Publichnyi / Tilky MicroDAO

  • Backend likely missing:

  • Proper get_public_citizens() query.
  • Or route /public/citizens is broken.

3. Goals

  1. Make /citizens page show a list of public agents.
  2. Wire visibility controls on agent Identity tab to is_public field.
  3. Filters work:
  4. Search by name/title/tagline.
  5. District filter.
  6. Agent type filter.

4. Backend Tasks

4.1. Citizen model

Add CitizenSummary model with fields: - id, slug, display_name, role, public_tagline - district, public_district, home_microdao_id - kind, node_id, avatar_url, color_hint, status

4.2. Repo: get_public_citizens

Query agents WHERE is_public = true AND deleted_at IS NULL AND is_archived = false. Apply filters for district, kind, and search.

4.3. API route

GET /public/citizens with optional query params: search, district, kind.

4.4. Update agent visibility

PATCH /city/agents/{agent_id}/visibility to update is_public and visibility_scope.

5. Frontend Tasks

5.1. Fix Citizens API call

5.2. Citizens Page UI with filters

5.3. Citizen Card Component

5.4. Wire Identity Tab to visibility API

6. Acceptance Criteria

  1. /citizens page loads without error.
  2. At least one agent with is_public=true appears in Citizens Directory.
  3. Filters work.
  4. Changing visibility on /agents/[slug] Identity tab updates /citizens.
  5. No leakage of deleted/archived agents.

7. Districts Reference

  • leadership - Leadership Hall
  • system - System Control Center
  • engineering - Engineering Lab
  • marketing - Marketing Hub
  • finance - Finance Office
  • web3 - Web3 District
  • security - Security Bunker
  • vision - Vision Studio
  • rnd - R&D Laboratory
  • memory - Memory Vault