madoc-platform

Understand and modify the full Madoc TS crowdsourcing contribution and review pipeline. Use when changing claim creation rules, crowdsourcing-task and crowdsourcing-review lifecycle behavior, reviewer assignment policy, or project settings that control submission/review flow in services/madoc-ts.

Work on Madoc TS site UI structure, React routes, and site-specific SSR behaviors. Use when adding or updating site pages, loaders, or site theme usage in services/madoc-ts.

Build, run, and debug the Madoc Docker/compose stack with the Docker daemon already running, including rebuilding images, starting/stopping services, inspecting containers/images, and using pm2 inside the madoc-ts container (server/queue/scheduler/auth) plus frontend rebuilds for volume-mounted assets.

Work on Madoc TS project export extension configs, export plan handling, and file output helpers. Use when adding export types or modifying export data flows in services/madoc-ts.

Work on Madoc TS admin UI structure, React routes, and admin-specific SSR behaviors. Use when adding admin screens, updating management flows, or adjusting admin-only UI in services/madoc-ts.

Work on Madoc TS activity stream endpoints and IIIF collection/manifest routing. Use when changing activity stream routes or IIIF data responses in services/madoc-ts.

Map and modify Madoc TS startup, server composition, routing setup, and SSR entrypoints. Use when tracing request flow, adding top-level middleware, wiring new services at boot, or debugging startup/SSR integration for services/madoc-ts.

Trace or modify Madoc TS authentication and authorization. Use when working on login strategies, JWT parsing/verification, cookie handling, or route-level authorization in services/madoc-ts.

Work on Madoc TS auth server, Passport-based auth strategies, and login provider flow. Use when adding auth providers, changing login behavior, or updating auth server verification logic in services/madoc-ts.

Work on Madoc TS JWT parsing, verification, and service token behavior. Use when changing JWT payload handling, signature verification, or service JWT configuration in services/madoc-ts.

Work on Madoc TS auth-related middleware, request guards, and state setup. Use when changing parse/set JWT behavior, auth error handling, or middleware order in services/madoc-ts.

Work on Madoc TS automation bots, bot definitions, and task event handling. Use when adding new bots, updating bot triggers, or changing bot execution flows in services/madoc-ts.

Work on Madoc TS capture model server APIs, repositories, and migration helpers. Use when modifying capture model routes, repository queries, or model migration flows in services/madoc-ts.

Work on Madoc TS capture model server flows and enrichment integrations. Use when updating capture model definitions, extending capture model extension wiring, or debugging enrichment data flow in services/madoc-ts.

Work on Madoc TS runtime configuration, path conventions, and Docker build/runtime setup. Use when adjusting env vars, file paths, or Docker build steps in services/madoc-ts.

Work on Madoc TS cron job orchestration and scheduled maintenance tasks. Use when adding cron jobs, changing cron task behavior, or updating queue restart logic in services/madoc-ts.

Work on Madoc TS database migrations and migration tooling. Use when adding SQL migrations, running Slonik migrator, or updating migration paths in services/madoc-ts.

Work on Madoc TS SQL query modules and shared query helpers. Use when adding or modifying queries in services/madoc-ts/src/database/queries or related SQL helper usage.

Edit Madoc TS email templates and rendering helpers. Use when changing MJML email content or updating plain-text email generation in services/madoc-ts.

Work on Madoc TS completion sources and autocomplete backend integration. Use when adding completion sources, changing completion request handling, or updating external source integration in services/madoc-ts.

Understand and extend the Madoc TS extension framework. Use when adding extensions, registry definitions, or plugin-backed extension behavior in services/madoc-ts.

Work on Madoc TS media extension upload, metadata, and API flows. Use when changing media ingestion rules, thumbnail generation, or media API calls in services/madoc-ts.

Work on Madoc TS page block extension definitions, editors, and rendering hooks. Use when adding page block types, updating block editors, or changing block rendering flow in services/madoc-ts.

Work on Madoc TS project template extensions and project creation hooks. Use when adding project templates, updating project extension hooks, or adjusting template metadata in services/madoc-ts.

Work on Madoc TS site manager extension APIs for sites, users, invitations, terms, and badges. Use when changing site management flows or site manager API calls in services/madoc-ts.

Work on Madoc TS theme extension registration, theme API calls, and theme lifecycle management. Use when adding theme extension definitions, plugin overrides, or theme API flows in services/madoc-ts.

Work on Madoc TS frontend structure for site and admin. Use when changing React routes, SSR render entrypoints, shared utilities, or component organization in services/madoc-ts.

Work on Madoc TS theme packaging, site theme assets, and theme integration points. Use when adding or updating themes, theme assets, or theme extension wiring in services/madoc-ts.

Work on Madoc TS API client wiring and gateway task definitions. Use when modifying ApiClient behavior, adding task types, or changing task handler integration in services/madoc-ts.

Work on Madoc TS internationalization setup for server and client. Use when changing i18next backend configuration, language detection, or locale loading in services/madoc-ts.

Work on Madoc TS media upload, storage, and thumbnail generation. Use when editing media APIs, media extension flows, or storage-backed asset handling in services/madoc-ts.

Work on Madoc TS webhook routing, execution, and registry behavior. Use when adding webhook events, adjusting webhook routes, or modifying webhook signing/validation in services/madoc-ts.

Work on Madoc TS plugin loading, sandboxed module registration, and plugin-to-extension wiring. Use when modifying plugin load paths, plugin registration, or plugin integration points in services/madoc-ts.

Create new Madoc TS project templates. Use when adding a new project template type, wiring template configuration/setup hooks, or defining capture model defaults for project creation in services/madoc-ts.

Work on Madoc TS queue worker and scheduler setup using BullMQ. Use when updating task dispatch, worker configuration, or queue event handling in services/madoc-ts.

Work on Madoc TS repository classes and data access patterns. Use when adding repository methods, refactoring DB access, or updating repository/query boundaries in services/madoc-ts.

Work on Madoc TS admin route handlers, request/response patterns, and admin HTTP endpoints. Use when adding or modifying admin routes in services/madoc-ts.

Work on Madoc TS site route handlers, request/response patterns, and site HTTP endpoints. Use when adding or modifying site routes in services/madoc-ts.

Trace, add, or refactor HTTP routes in services/madoc-ts. Use when working on request handlers, route registration, route grouping, or route-level middleware and permissions.

Work on Madoc TS admin SSR pipeline, HTML template injection, and admin render routing. Use when changing admin SSR behavior, template tokens, or admin SSR data wiring in services/madoc-ts.