Drupal Module Documentation Reference¶

Authority: This file is the canonical per-module documentation index for all Drupal modules Bluefly uses, authors, or maintains.

Pattern: Every major Drupal module publishes its authoritative usage docs at https://project.pages.drupalcode.org/<module>/ (GitLab Pages). That URL — not drupal.org/project/ — is the agent's bible for how to use the module. Always read the module's own docs before writing any code or configuration that touches it.

Standard: drupal-standard.md §§2–8 (six-bucket model, assembly ladder, anti-patterns) is the Bluefly engineering authority. This file is the per-module lookup index agents use to find the right doc.

How to find module docs¶

Pages.drupalcode.org (primary): https://project.pages.drupalcode.org/<module>/ — the project's own GitLab Pages doc site. Full API, config, concepts, examples.
drupal.org/project/ (secondary): project page, release history, issue queue, security advisory coverage.
git.drupalcode.org/project/ (source): canonical source for reading actual code, .info.yml, hooks, and plugin implementations.
Bluefly drupal-standard.md §11: how to interact with drupal.org via glab CLI (issue-fork model, two-hostname rule).

Core Drupal AI Stack¶

Module	d.o Project	Module Docs	GitLab Source	Notes
`drupal/ai` (AI Core)	drupal.org/project/ai	project.pages.drupalcode.org/ai	git.drupalcode.org/project/ai	Provider abstraction — all LLM calls go through `\Drupal::service('ai.provider')`. Rule A.
`drupal/ai_agents`	drupal.org/project/ai_agents	project.pages.drupalcode.org/ai_agents	git.drupalcode.org/project/ai_agents	Agent orchestration, tool-calling loop. Rule B.
`drupal/ai_context`	drupal.org/project/ai_context	ai-context-b13f05.pages.drupalcode.org	git.drupalcode.org/project/ai_context	AI context items — structured context bundles for agents. Use `ai_context_item` bundles, never custom entity types.
`drupal/tool` (Tool API)	drupal.org/project/tool	project.pages.drupalcode.org/tool	git.drupalcode.org/project/tool	`@Tool` plugin — every executable capability. Rule C.
`drupal/tool_belt`	drupal.org/project/tool_belt	project.pages.drupalcode.org/tool_belt	git.drupalcode.org/project/tool_belt	Prebuilt CRUD/Drupal tools. Enable submodules; no custom CRUD plugins.
`drupal/mcp`	drupal.org/project/mcp	project.pages.drupalcode.org/mcp	git.drupalcode.org/project/mcp	MCP umbrella.
`drupal/mcp_server`	drupal.org/project/mcp_server	project.pages.drupalcode.org/mcp_server	git.drupalcode.org/project/mcp_server	Expose Drupal to external AI. Rule D.
`drupal/mcp_client`	drupal.org/project/mcp_client	project.pages.drupalcode.org/mcp_client	git.drupalcode.org/project/mcp_client	Drupal calls external tools. Rule D.
`drupal/mcp_tools`	drupal.org/project/mcp_tools	project.pages.drupalcode.org/mcp_tools	git.drupalcode.org/project/mcp_tools	MCP tool plugins for standard Drupal operations.
`drupal/api_normalization`	drupal.org/project/api_normalization	project.pages.drupalcode.org/api_normalization	git.drupalcode.org/project/api_normalization	Import OpenAPI specs → auto-generates Tool plugins. Bluefly contrib-ready.

Workflow & Automation¶

Module	d.o Project	Module Docs	GitLab Source	Notes
`drupal/eca`	drupal.org/project/eca	project.pages.drupalcode.org/eca	git.drupalcode.org/project/eca	Event-Condition-Action — all event-driven automation. Rule E.
`drupal/flowdrop`	drupal.org/project/flowdrop	project.pages.drupalcode.org/flowdrop	git.drupalcode.org/project/flowdrop	Pipeline engine with pause/approval nodes.
`drupal/orchestration`	drupal.org/project/orchestration	project.pages.drupalcode.org/orchestration	git.drupalcode.org/project/orchestration	External orchestrator bridge (Activepieces/n8n/Zapier). NOT a local engine.
`drupal/modeler_api`	drupal.org/project/modeler_api	project.pages.drupalcode.org/modeler_api	git.drupalcode.org/project/modeler_api	Visual ECA modelling API.

Drupal CMS & Site Templates¶

Module	d.o Project	Module Docs	GitLab Source	Notes
`drupal/cms`	drupal.org/project/drupal_cms	project.pages.drupalcode.org/drupal_cms	git.drupalcode.org/project/drupal_cms	Drupal CMS meta-package (Starshot). Bluefly target platform.
`drupal/drupal_cms_site_template_base`	drupal.org/project/drupal_cms_site_template_base	project.pages.drupalcode.org/drupal_cms_site_template_base	git.drupalcode.org/project/drupal_cms_site_template_base	Bluefly's upstream scaffold for authoring new site templates. Includes CI, Tugboat, Project Browser integration.
`drupal/site_template_helper`	drupal.org/project/site_template_helper	project.pages.drupalcode.org/site_template_helper	git.drupalcode.org/project/site_template_helper	Enables `drush site:export`. Security-covered. Required `--dev` dep for template authoring.
`drupal/recipe_generator`	drupal.org/project/recipe_generator	project.pages.drupalcode.org/recipe_generator	git.drupalcode.org/project/recipe_generator	Drush add-on: `drush generate recipe` → interactive `composer.json` + `recipe.yml` scaffold. Use 2.0.x for Drupal 11.
`drupal/canvas`	drupal.org/project/canvas	project.pages.drupalcode.org/canvas	git.drupalcode.org/project/canvas	Canvas (SDC + React) page composition. Bluefly page layer.

Platform, Security & Observability¶

Module	d.o Project	Module Docs	GitLab Source	Notes
`drupal/key`	drupal.org/project/key	project.pages.drupalcode.org/key	git.drupalcode.org/project/key	Secret/credential management. Never hardcode keys.
`drupal/simple_oauth`	drupal.org/project/simple_oauth	project.pages.drupalcode.org/simple_oauth	git.drupalcode.org/project/simple_oauth	OAuth2 server for Drupal.
`drupal/langfuse`	drupal.org/project/langfuse	project.pages.drupalcode.org/langfuse	git.drupalcode.org/project/langfuse	LLM observability / cost tracking.
`drupal/upgrade_status`	drupal.org/project/upgrade_status	project.pages.drupalcode.org/upgrade_status	git.drupalcode.org/project/upgrade_status	Drupal upgrade readiness checker.
`drupal/monitoring`	drupal.org/project/monitoring	project.pages.drupalcode.org/monitoring	git.drupalcode.org/project/monitoring	Site health monitoring.
`drupal/advancedqueue`	drupal.org/project/advancedqueue	project.pages.drupalcode.org/advancedqueue	git.drupalcode.org/project/advancedqueue	Advanced queue system.
`drupal/ai_search`	drupal.org/project/ai_search	project.pages.drupalcode.org/ai_search	git.drupalcode.org/project/ai_search	AI-powered search. Pairs with Qdrant on Oracle.

Bluefly-Authored Drupal.org Modules (Contrib-Ready)¶

These are published by Bluefly. The authoritative source is the GitLab project under blueflyio/agent-platform/drupal/contrib-ready/. Read §11 of drupal-standard.md before any Drupal.org contribution workflow.

Module	d.o Project	Module Docs	GitLab Source	Notes
`drupal/api_normalization`	drupal.org/project/api_normalization	project.pages.drupalcode.org/api_normalization	git.drupalcode.org/project/api_normalization	Bluefly-authored. Gate 1 (PHPCS/drupal-check) must pass before installing on bluefly.io.
`drupal/ai_agents_ossa`	drupal.org/project/ai_agents_ossa	project.pages.drupalcode.org/ai_agents_ossa	Bluefly GitLab	Bluefly-authored. OSSA agent manifest import.
`drupal/ai_provider_apple`	drupal.org/project/ai_provider_apple	project.pages.drupalcode.org/ai_provider_apple	Bluefly GitLab	Bluefly-authored. Apple Intelligence provider.
`drupal/dita_ccms`	drupal.org/project/dita_ccms	project.pages.drupalcode.org/dita_ccms	Bluefly GitLab	Bluefly-authored. DITA CCMS integration.
`drupal/duadp`	drupal.org/project/duadp	project.pages.drupalcode.org/duadp	Bluefly GitLab	Bluefly-authored. Drupal Universal Agent Discovery Protocol.

AI Providers¶

Module	d.o Project	Notes
`drupal/ai_provider_anthropic`	drupal.org/project/ai_provider_anthropic	Anthropic/Claude. Preferred primary.
`drupal/ai_provider_openai`	drupal.org/project/ai_provider_openai	OpenAI.
`drupal/ai_vdb_provider_postgres`	drupal.org/project/ai_vdb_provider_postgres	pgvector on Oracle PostgreSQL.
LiteLLM provider	—	Configured via LiteLLM proxy on Oracle. See `drupal-standard.md` §9.

Usage Rule for Agents¶

When a formula step requires working with any of the modules above:

Read the module's own docs first (column "Module Docs" above).
Check the drupal.org project page for security advisory coverage and release status.
Check drupal-standard.md for the applicable Bluefly enforcement rule (A–J).
Do not write custom code until you have confirmed no module surface covers the need (ten-layer assembly ladder, §6).
For Bluefly-authored modules: the authoritative source is the GitLab project under blueflyio/agent-platform/drupal/contrib-ready/, not the installed copy in web/modules/.

Lookup Pattern for Unlisted Modules¶

If a module is not in this table:

# 1. Check if it has a pages.drupalcode.org site
curl -sI "https://project.pages.drupalcode.org/<module>/" | grep "HTTP/"

# 2. Fall back to d.o project page
# https://www.drupal.org/project/<module>

# 3. Read the GitLab source
# https://git.drupalcode.org/project/<module>

Add newly confirmed doc URLs to this table via MR to blucity-docs → release/v0.1.x.