# FourFoldLabs Crucible
> Component catalog, shared packages, and AI-optimized knowledge graph for the FourFoldLabs monorepo.

## Machine-Readable Endpoints
- [/graph.json](/graph.json) — full nodes + edges manifest of packages, blocks, categories, plugins, docs
- [/packages.json](/packages.json) — array of all `@fourfoldlabs/*` packages with version + description
- [/blocks.json](/blocks.json) — array of all blocks with category, tier, since
- [/plugins.json](/plugins.json) — array of Claude Code plugins grouping the packages
- [/llms-full.txt](/llms-full.txt) — full consumer guides + builder specs as plaintext

## Block Categories
- [KPIs & Metrics](/blocks/kpis) ([json](/blocks/kpis.json)): Single-value metric displays — numbers, trends, and comparisons.
- [Charts](/blocks/charts) ([json](/blocks/charts.json)): Visualizations powered by Recharts — line, bar, area, donut, and more.
- [Lists & Views](/blocks/lists) ([json](/blocks/lists.json)): Tables, feeds, grids, timelines, calendars, and collection views.
- [Page Shells](/blocks/page-shells) ([json](/blocks/page-shells.json)): App shells and page-level structural blocks — sidebars, top navs, headers.
- [Feedback](/blocks/feedback) ([json](/blocks/feedback.json)): Dialogs, callouts, empty states, and guided flows.
- [Indicators](/blocks/indicators) ([json](/blocks/indicators.json)): Inline status badges, trend arrows, progress markers, and tags.
- [Inputs & Controls](/blocks/inputs) ([json](/blocks/inputs.json)): File uploads, filter bars, and action grids.
- [Content](/blocks/content) ([json](/blocks/content.json)): CMS content primitives — cards, images, and quotes. Editable wrappers live in @fourfoldlabs/cms-ui.

## Packages
- [@fourfoldlabs/ai](/packages/ai) ([json](/packages/ai.json)): Anthropic client wrapper, streaming chat, context registry, insight cache
- [@fourfoldlabs/api-core](/packages/api-core) ([json](/packages/api-core.json)): Hono middleware factories, response helpers, logger, and AppEnv type
- [@fourfoldlabs/audit](/packages/audit) ([json](/packages/audit.json)): Audit logging: Drizzle schema, write service, and shared types
- [@fourfoldlabs/audit-ui](/packages/audit-ui) ([json](/packages/audit-ui.json)): Audit UI: AuditLogTable component, API client, and Zustand store
- [@fourfoldlabs/auth](/packages/auth) ([json](/packages/auth.json)): Pluggable auth strategy with bcrypt + JWT, DI-based middleware factories
- [@fourfoldlabs/blocks](/packages/blocks) ([json](/packages/blocks.json)): 34 reusable React building blocks — charts, KPIs, tables, shells, forms, indicators
- [@fourfoldlabs/chat](/packages/chat) ([json](/packages/chat.json)): React chat panel, SSE streaming client, Zustand store with composable slice
- [@fourfoldlabs/cms](/packages/cms) ([json](/packages/cms.json)): Content management: media library, newsletters, calendar events, announcements, and campaigns — Drizzle schema, services, and shared types
- [@fourfoldlabs/cms-ui](/packages/cms-ui) ([json](/packages/cms-ui.json)): CMS React components, API client, and Zustand store
- [@fourfoldlabs/email](/packages/email) ([json](/packages/email.json)): Transport-agnostic email sender with Resend implementation and dev-mode fallback
- [@fourfoldlabs/events](/packages/events) ([json](/packages/events.json)): SSE event bus: in-memory pub/sub, Redis adapter, Hono SSE route factory, and React hook
- [@fourfoldlabs/export](/packages/export) ([json](/packages/export.json)): Data export engine: streaming CSV, PDF via background jobs, column formatters, Hono route factory, and ExportButton component
- [@fourfoldlabs/forms](/packages/forms) ([json](/packages/forms.json)): Dynamic form builder: Drizzle schema, runtime Zod validation, conditional logic, and shared types
- [@fourfoldlabs/forms-ui](/packages/forms-ui) ([json](/packages/forms-ui.json)): Forms UI: FormRenderer, FormBuilder, FormManager, SubmissionTable, API client, and Zustand store
- [@fourfoldlabs/iam](/packages/iam) ([json](/packages/iam.json)): Identity and access management: groups, memberships, role helpers, Drizzle schema, services, and Hono middleware
- [@fourfoldlabs/iam-ui](/packages/iam-ui) ([json](/packages/iam-ui.json)): IAM React components, API client, and Zustand store
- [@fourfoldlabs/integrations](/packages/integrations) ([json](/packages/integrations.json)): Third-party integration framework: encrypted credentials, provider interface, sync runner via background jobs, and shared types
- [@fourfoldlabs/integrations-ui](/packages/integrations-ui) ([json](/packages/integrations-ui.json)): Integrations UI: IntegrationManager, ConnectionForm, IntegrationCard, SyncHistory, API client, and Zustand store
- [@fourfoldlabs/jobs](/packages/jobs) ([json](/packages/jobs.json)): Background job queue: Drizzle schema, polling worker, cron scheduler, and service functions
- [@fourfoldlabs/mcp](/packages/mcp) ([json](/packages/mcp.json)): MCP server factory, HTTP transport for Hono, token generation utilities
- [@fourfoldlabs/notifications](/packages/notifications) ([json](/packages/notifications.json)): React notification bell/panel, HTTP client factory, Zustand store
- [@fourfoldlabs/shared](/packages/shared) ([json](/packages/shared.json)): Zero-dependency utilities — cn(), formatters, Zod schemas, and API response types
- [@fourfoldlabs/ui](/packages/ui) ([json](/packages/ui.json)): shadcn/radix UI primitives — single source of truth for all FourFoldLabs apps
- [@fourfoldlabs/webhooks](/packages/webhooks) ([json](/packages/webhooks.json)): Outbound event system: webhook endpoints, HMAC-SHA256 signed delivery via background jobs, retry with exponential backoff
- [@fourfoldlabs/webhooks-ui](/packages/webhooks-ui) ([json](/packages/webhooks-ui.json)): Webhooks UI: WebhookManager, WebhookForm, API client, and Zustand store
- [@fourfoldlabs/workflows](/packages/workflows) ([json](/packages/workflows.json)): Multi-step approval workflows: Drizzle schema, state machine engine with guards and effects, and shared types
- [@fourfoldlabs/workflows-ui](/packages/workflows-ui) ([json](/packages/workflows-ui.json)): Workflows UI: WorkflowActions, WorkflowStatusBadge, WorkflowTimeline, API client, and Zustand store

## HTML References
- [/blocks](/blocks) — interactive block showcase
- [/packages](/packages) — interactive package reference