lcp 0.1.0

data/docs/feature-catalog.md

@@ -0,0 +1,763 @@
+# Feature Catalog
+
+Auto-generated from `docs/feature-catalog.yml`. Do not edit manually.
+Regenerate: `cd examples/showcase && bundle exec rake lcp_ruby:feature_catalog`
+
+621 features across 45 categories.
+
+## API Backed Models
+
+- **API-Backed Model (Host Provider)** — Host-provided data source (data_source type: :host, provider:). ActiveModel class, read-only. models/*.yml. _(beta)_ · `docs/reference/api-backed-models.md#data_sourceprovider` `docs/guides/api-backed-models.md#host-provided-data-source` `docs/design/api_backed_models.md#host-provided-data-source` `lib/lcp_ruby/data_source/host.rb` `lib/lcp_ruby/data_source/registry.rb`
+- **API-Backed Model (REST JSON)** — External REST API data source (data_source: type: rest_json). base_url:, auth:, pagination:, cache: in model YAML. _(beta)_ · `docs/reference/api-backed-models.md#data_sourcetype` `docs/guides/api-backed-models.md#quick-start-rest-json-adapter` `docs/design/api_backed_models.md#rest-json-adapter-configuration` `lib/lcp_ruby/data_source/rest_json.rb` `lib/lcp_ruby/data_source/base.rb`
+- **Caching & Resilience** — API cache wrapper (cache: ttl:, list_ttl:, stale_on_error:). Serves stale on failure. ApiErrorPlaceholder fallback. _(beta)_ · `docs/reference/api-backed-models.md#data_sourcecache` `docs/guides/api-backed-models.md#caching` `docs/design/api_backed_models.md#design` `lib/lcp_ruby/data_source/cached_wrapper.rb` `lib/lcp_ruby/data_source/resilient_wrapper.rb` `lib/lcp_ruby/data_source/api_error_placeholder.rb`
+- **Cross-Source Associations** — DB-to-API associations (belongs_to/has_many). Lazy accessors with batch preloading. Detected at boot. _(beta)_ · `docs/reference/api-backed-models.md#cross-source-associations` `docs/guides/api-backed-models.md#cross-source-associations` `docs/design/api_backed_models.md#cross-source-associations` `lib/lcp_ruby/data_source/api_preloader.rb` `lib/lcp_ruby/data_source/api_model_concern.rb`
+
+## Association Primary Key
+
+- **Boot-time validation: column exists** — Validate primary_key: column exists on target model. ConfigurationValidator check at boot. · `docs/reference/models.md` `docs/design/association_primary_key.md#validation-rules-boot-time` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **Boot-time validation: missing-index warning** — Warning if explicit FK field has no indexes: entry. Auto-index only runs for auto-created FKs. · `docs/reference/models.md` `docs/design/association_primary_key.md#missing-index-warning-on-the-join-column` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **Boot-time validation: reciprocity alignment** — Check forward/inverse declare same join pair. Disambiguate via inverse_of: or foreign_key match. · `docs/reference/models.md` `docs/design/association_primary_key.md#5b-reciprocity-check-extend-to-cover-fkpk-pair-alignment` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **Boot-time validation: type-compat warning** — Warning if FK and join column types differ. Covers auto-managed FK case via AssociationFkType. · `docs/reference/models.md` `docs/design/association_primary_key.md#fk-column-creation` `lib/lcp_ruby/metadata/configuration_validator.rb` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Boot-time validation: uniqueness (tri-state)** — Warning if join column lacks uniqueness constraint. Tri-state: :unique/:scoped/:not_unique. · `docs/reference/models.md` `docs/design/association_primary_key.md#helper-tri-state-uniqueness-check-for-a-column-on-a-model-definition` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **FK column type follows referenced column** — Auto-created FK type matches referenced column (string vema_code -> string FK). Not default bigint. · `docs/reference/models.md` `docs/design/association_primary_key.md#fk-column-creation` `lib/lcp_ruby/model_factory/schema_manager.rb` `lib/lcp_ruby/association_fk_type.rb`
+- **Form select posts business key (not id)** — Select options use join column value (e.g. `D-ENG`). AssociationJoinColumn.for(assoc) resolution. · `docs/reference/models.md` `docs/design/association_primary_key.md#7a-liblcp_rubyassociation_options_builderrb-emit-join-column-values-not-id` `lib/lcp_ruby/association_options_builder.rb` `app/helpers/lcp_ruby/form_helper.rb`
+- **Importer write-back via the join column** — Import always writes join column value to FK. Lookup by any attribute resolves to business key. · `docs/reference/models.md` `docs/design/association_primary_key.md#8-liblcp_rubyimportrow_processorrb-fk-write-back-via-the-associations-join-column` `lib/lcp_ruby/import/row_processor.rb`
+- **Inverse has_many with primary_key:** — Reverse side of custom-key belongs_to. Both sides declare same join pair. Reciprocity validation. · `docs/reference/models.md` `docs/design/association_primary_key.md#scenario-2-inverse-has_many-with-custom-join-keys` `lib/lcp_ruby/model_factory/association_applicator.rb`
+- **Rejected: through:, polymorphic, tree, cross-source** — MetadataError for primary_key: + through:/polymorphic:. Validator error for tree/cross-source. · `docs/reference/models.md` `docs/design/association_primary_key.md#scenario-5-rejected-primary_key-on-through-association-itself` `docs/design/association_primary_key.md#interaction-with-polymorphic` `docs/design/association_primary_key.md#interaction-with-tree` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **Virtual columns join via primary_key** — Virtual column subqueries use primary_key: for WHERE clause. Not hardcoded to id. · `docs/reference/models.md` `docs/design/association_primary_key.md#9-liblcp_rubyvirtual_columnsbuilderrb-use-the-associations-primary_key-in-joingroup-by` `lib/lcp_ruby/virtual_columns/`
+- **bind_to: model + primary_key:** — primary_key: allowed on bind_to target associations. YAML is join-column source. Host owns AR macro. · `docs/reference/models.md` `docs/design/association_primary_key.md#interaction-with-bind_to` `lib/lcp_ruby/model_factory/association_applicator.rb`
+- **has_one :through over a custom-key belongs_to** — Transparent through: composition over custom-key links. No primary_key: on through: itself. · `docs/reference/models.md` `docs/design/association_primary_key.md#scenario-3-has_one-through-over-a-custom-key-association` `lib/lcp_ruby/model_factory/association_applicator.rb`
+- **primary_key: on belongs_to** — Join on business key (primary_key: :vema_code). FK matches target column instead of id. No shadow _id. · `docs/reference/models.md` `docs/design/association_primary_key.md#yaml-syntax` `docs/design/association_primary_key.md#configuration-behavior` `lib/lcp_ruby/metadata/association_definition.rb` `lib/lcp_ruby/model_factory/association_applicator.rb`
+
+## Attachments
+
+- **Image Variants** — Active Storage image processing. variants: block with resize_to_limit. models/*.yml attachment:. · `docs/guides/attachments.md#image-variants` `docs/guides/attachments.md#display-configuration` `lib/lcp_ruby/model_factory/attachment_applicator.rb` `lib/lcp_ruby/display/renderers/attachment_preview.rb`
+- **Multiple File Upload** — Multi-file upload (mode: multiple). max_files:, max_size:, content_types:. models/*.yml attachment:. · `docs/guides/attachments.md#multiple-attachments` `docs/guides/attachments.md#complete-model-example` `lib/lcp_ruby/model_factory/attachment_applicator.rb`
+- **Single File Upload** — One file via Active Storage (type: attachment, mode: single). max_size:. models/*.yml attachment: block. · `docs/guides/attachments.md#single-attachment` `docs/guides/attachments.md#defining-attachment-fields` `lib/lcp_ruby/model_factory/attachment_applicator.rb`
+- **Upload Validations** — File validation: max_size:, content_types:, max_files:. Inline error messages. attachment: block. · `docs/guides/attachments.md#validation-options` `lib/lcp_ruby/model_factory/attachment_applicator.rb`
+
+## Auditing
+
+- **Audit History Section** — Show page audit timeline (audit_history section). Field diffs, user info, timestamps. Presenter config. · `docs/reference/auditing.md#show-page-section` `docs/guides/auditing.md#show-page-integration` `docs/design/auditing.md#presenter-integration` `lib/lcp_ruby/auditing/`
+- **Audit Log Model** — Dedicated audit log model. Fields: auditable_type/id, action, changes_data (JSON), user_snapshot. · `docs/reference/auditing.md#audit-log-model-contract` `docs/guides/auditing.md#querying-audit-logs` `docs/design/auditing.md#audit-log-table` `docs/design/auditing.md#1-lcprubyauditlog-internal-model` `lib/lcp_ruby/auditing/`
+- **Model Auditing** — Field-level change tracking (options: { auditing: true }). Create/update/destroy events with diffs. · `docs/reference/auditing.md#model-option` `docs/guides/auditing.md#basic-setup` `docs/design/auditing.md#yaml-configuration` `docs/design/auditing.md#what-auditing-enables` `lib/lcp_ruby/auditing/` `lib/lcp_ruby/model_factory/`
+
+## Authentication
+
+- **API Tokens — Personal Access Tokens** — Mint long-lived bearer tokens for non-interactive API access (Excel Power Query, CI/CD, automations). rails generate lcp_ruby:api_tokens. _(beta)_ · `docs/reference/api-tokens.md` `docs/design/api_tokens.md` `lib/lcp_ruby/api_tokens/token_generator.rb` `lib/lcp_ruby/api_tokens/verifier.rb` `lib/lcp_ruby/controller/bearer_authentication.rb` `lib/generators/lcp_ruby/api_tokens_generator.rb`
+- **Account Locking** — Lock after N failures. config.auth_lock_after_attempts, auth_lock_duration. Devise Lockable. · `docs/guides/host-application.md#authentication` `lib/generators/lcp_ruby/install_auth_generator.rb`
+- **Audit Logging** — Auth events via ActiveSupport::Notifications. Subscribe to authentication.lcp_ruby. · `docs/guides/host-application.md#auditing` `lib/generators/lcp_ruby/auditing_generator.rb`
+- **Authentication Modes** — Four auth modes: :external, :built_in, :oidc, :none. config.authentication in initializer. · `docs/guides/host-application.md#authentication` `docs/guides/host-application.md#step-5-set-up-current_user` `docs/design/oidc_auth.md` `lib/generators/lcp_ruby/install_auth_generator.rb`
+- **Bearer Authentication Resolver Registry** — Pluggable bearer-token resolvers. ResolverRegistry.register(name, priority:, matcher:, resolver:). v1 ships api_token; OIDC plugs in via the same API. _(beta)_ · `docs/reference/api-tokens.md` `docs/design/api_tokens.md` `lib/lcp_ruby/api_tokens/resolver_registry.rb` `lib/lcp_ruby/controller/bearer_authentication.rb`
+- **Install Generator** — rails generate lcp_ruby:install_auth. Sets up users migration, Devise config. rake lcp_ruby:create_admin. · `docs/guides/host-application.md#authentication` `docs/guides/host-application.md#feature-generators` `lib/generators/lcp_ruby/install_auth_generator.rb`
+- **Login Page** — Devise email/password login. config.authentication = :built_in. auth_after_login_path:. · `docs/guides/host-application.md#authentication` `lib/generators/lcp_ruby/install_auth_generator.rb`
+- **OIDC Adaptive Login Page** — One canonical /auth/login that adapts to auth.yml — OIDC buttons, Devise form, or both stacked. · `docs/reference/oidc.md#login-page` `docs/guides/oidc-setup.md` `docs/design/oidc_auth.md` `app/views/lcp_ruby/auth/sessions/new.html.erb` `app/views/layouts/lcp_ruby/auth.html.erb` `app/helpers/lcp_ruby/oidc_button_helper.rb` `app/controllers/lcp_ruby/auth/sessions_controller.rb`
+- **OIDC Authentication** — Single sign-on via OpenID Connect (Entra, Google, Okta, Keycloak, generic). config.authentication = :oidc + config/lcp_ruby/auth.yml. · `docs/reference/oidc.md` `docs/guides/oidc-setup.md` `docs/design/oidc_auth.md` `docs/design/oidc_auth.md` `lib/lcp_ruby/authentication/provider_registry.rb` `lib/lcp_ruby/authentication/user_resolver.rb` `lib/lcp_ruby/authentication/role_mapper.rb` `app/controllers/lcp_ruby/auth/callbacks_controller.rb` `lib/generators/lcp_ruby/templates/install_auth/oidc/`
+- **OIDC Bearer Validation** — Phase 2 — validate OAuth 2.0 access tokens issued by the same OIDC providers used for web login (Power BI, MSAL scripts, native apps). · `docs/reference/oidc-bearer.md` `docs/reference/oidc.md` `docs/design/oidc_auth.md` `docs/design/oidc_auth.md` `lib/lcp_ruby/authentication/jwks_cache.rb` `lib/lcp_ruby/authentication/bearer_jwt_verifier.rb` `lib/lcp_ruby/authentication/oidc_bearer_resolver.rb` `lib/lcp_ruby/authentication/test_support.rb` `lib/lcp_ruby/authentication/role_mapper.rb` `lib/generators/lcp_ruby/oidc_role_mappings_generator.rb`
+- **OIDC Custom Claims Synchronizer** — Host hook for syncing arbitrary claims into the user record on every login (avatars, profile_data, host associations). · `docs/reference/oidc.md#custom-synchronization` `docs/guides/oidc-setup.md#syncing-more-than-email--name` `docs/design/oidc_auth.md` `lib/lcp_ruby/authentication/user_resolver.rb` `lib/lcp_ruby/configuration.rb` `examples/showcase/config/initializers/lcp_ruby.rb`
+- **OIDC Logout Modes** — Per-provider logout.mode: local (default — destroy LCP session only) or rp_initiated (also redirect to IdP end_session_endpoint with id_token_hint). · `docs/reference/oidc.md#logout-flow` `docs/design/oidc_auth.md` `app/controllers/lcp_ruby/auth/sessions_controller.rb` `app/controllers/lcp_ruby/auth/callbacks_controller.rb`
+- **OIDC Migration redirect_uri Override** — Per-provider redirect_uri override + host-level redirect for legacy IdP App registrations whose callback URL doesn't match the engine mount. · `docs/reference/oidc.md#migration--legacy-redirect_uri-override` `docs/design/oidc_auth.md` `lib/lcp_ruby/authentication/omniauth_builder.rb` `lib/lcp_ruby/authentication/provider.rb`
+- **OIDC Provider Templates** — Per-IdP scaffolding (entra, google, okta, keycloak, generic). install_auth --provider=<name> writes a tailored auth.yml. · `docs/reference/oidc.md` `docs/guides/oidc-setup.md` `docs/design/oidc_auth.md` `lib/generators/lcp_ruby/install_auth_generator.rb` `lib/generators/lcp_ruby/templates/install_auth/oidc/`
+- **OIDC Role Mapping (yaml / host)** — Three-source principle for IdP claim → LCP role. role_source yaml (default) or host (resolver lambda); db reserved for Phase 2. · `docs/reference/oidc.md` `docs/guides/oidc-setup.md#role-mapping-options` `docs/design/oidc_auth.md` `lib/lcp_ruby/authentication/role_mapper.rb` `lib/lcp_ruby/metadata/auth_validator.rb`
+- **OIDC User Provisioning Hook** — Tenant filter via reject_if_host_missing + LcpRuby.configuration.user_provisioner. Returning nil rejects sign-in with host_rejected. · `docs/reference/oidc.md` `docs/guides/oidc-setup.md#provisioning-options` `docs/design/oidc_auth.md` `lib/lcp_ruby/authentication/user_resolver.rb` `lib/lcp_ruby/metadata/auth_validator.rb`
+- **Password Reset** — Devise Recoverable flow. config.auth_mailer_sender. Email token-based reset. · `docs/guides/host-application.md#authentication` `lib/generators/lcp_ruby/install_auth_generator.rb`
+- **Session Timeout** — Auto-logout via Devise Timeoutable. config.auth_session_timeout = 30.minutes. · `docs/guides/host-application.md#authentication` `lib/generators/lcp_ruby/install_auth_generator.rb`
+- **User Registration** — Self-registration opt-in. config.auth_allow_registration = true. Default role: viewer. · `docs/guides/host-application.md#authentication` `lib/generators/lcp_ruby/install_auth_generator.rb`
+
+## Background Jobs
+
+- **Background Jobs Generator** — Generator creates model/presenter/permissions/views (rails generate lcp_ruby:background_jobs). · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#generator` `lib/lcp_ruby/background_jobs/`
+- **Cooperative Cancellation** — Cooperative cancellation (check_cancellation!). DB flag checked in loop. Mark as cancelled. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#5-cancellation` `docs/design/background_jobs.md#d8-cooperative-cancellation-via-db-flag` `lib/lcp_ruby/background_jobs/`
+- **Declarative Handler (call_webhook)** — HTTP request handler (action: call_webhook). Net::HTTP, error classification, ${env:VAR} interpolation. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#call_webhook-details` `docs/design/background_jobs.md#d24-call_webhook-error-classification-and-response-handling` `lib/lcp_ruby/background_jobs/`
+- **Declarative Handler (fire_event)** — Event dispatch handler (action: fire_event). Fires named event. Combine with multi-step for sequences. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#declarative-handler` `docs/design/background_jobs.md#send-notification` `lib/lcp_ruby/background_jobs/`
+- **Declarative Handler (run_scope)** — No-code scope+operation handler (action: run_scope). destroy_all, delete_all, update_all, count. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#run_scope-details` `docs/design/background_jobs.md#d23-run_scope-calls-ruby-scope-methods-with-keyword-arguments` `lib/lcp_ruby/background_jobs/`
+- **Enqueue API** — Programmatic job enqueue (BackgroundJobs::Enqueuer.enqueue). Params, unique_by, triggered_by support. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#programmatic-api-ruby` `lib/lcp_ruby/background_jobs/`
+- **Event Triggers** — Jobs triggered by model events (triggers: [{ event: after_create }]). Automatic job enqueue on event. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#event-trigger-declarative` `docs/design/background_jobs.md#4-trigger-mechanism` `lib/lcp_ruby/background_jobs/`
+- **Job Definition (YAML)** — Declarative job config (config/lcp_ruby/jobs/*.yml). Handler, queue, retry, timeout, triggers. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#source-yamldsl-static` `docs/design/background_jobs.md#2-job-definition-three-sources` `lib/lcp_ruby/background_jobs/`
+- **Job Execution Model** — Async job tracking model (JobExecution). Status lifecycle, progress, log, errors. Generator: lcp_ruby:background_jobs. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#1-jobexecution-model` `lib/lcp_ruby/background_jobs/`
+- **Multi-Step Jobs** — Sequential step execution (steps: array). Each step is a handler action. Progress auto-tracked per step. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#d22-job-chaining-via-steps-or-workflow-no-dedicated-pipeline-concept` `docs/design/background_jobs.md#d30-steps-progress-per-step-granularity-only` `lib/lcp_ruby/background_jobs/`
+- **Retry Policy** — Configurable retry (retry:, retry_interval: exponential/linear/fixed). Max attempts with backoff. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#10-error-handling-and-retry` `docs/design/background_jobs.md#d19-retry-via-manual-re-enqueue-not-activejob-retry` `lib/lcp_ruby/background_jobs/`
+- **Ruby Class Handler** — Custom job logic (BaseHandler subclass). check_cancellation!, update_progress!, log!, attach_result!. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#ruby-class-handler` `docs/design/background_jobs.md#d5-declarative-ruby-class-handlers` `lib/lcp_ruby/background_jobs/`
+- **Schedule Adapter** — Cron-based scheduling (schedule: `0 3 * * *`). Requires external scheduler (e.g., solid_queue). · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#schedule-trigger-recurring` `docs/design/background_jobs.md#d7-single-scheduling-backend-in-v1` `lib/lcp_ruby/background_jobs/`
+- **Structured Job Log** — Append-only log entries (log! method). JSON array on execution. 2s flush debounce for performance. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#9-job-log` `docs/design/background_jobs.md#d21-job-log-for-retry-history-and-handler-messages` `lib/lcp_ruby/background_jobs/`
+- **Unique Key Enforcement** — Prevent duplicate jobs (unique_by: [field1, field2]). Checked before enqueue. Pending/running dedup. · `docs/design/background_jobs.md` `docs/reference/engine-configuration.md` `docs/guides/host-application.md` `docs/design/background_jobs.md#6-concurrency-uniqueness` `docs/design/background_jobs.md#d27-unique_key-computation-sha256-of-sorted-key-value-pairs` `lib/lcp_ruby/background_jobs/`
+
+## Batch Actions
+
+- **Auto-Derived Batch Actions (batch: true)** — Auto-derive batch from single action (batch: true or batch: { overrides }). Inherits name/type/icon. · `docs/guides/batch-actions.md#auto-derived-batch-actions` `docs/design/batch_action_auto_derive.md` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Action Toolbar** — Sticky footer toolbar on selection. Count, action buttons, clear. Stimulus: lcp-batch-select. · `docs/guides/batch-actions.md#enabling-batch-actions` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Actions on Soft Delete** — Batch delete calls discard!(by:) on soft-deletable models. Archive auto-derives restore/perm_destroy. · `docs/guides/batch-actions.md#batch-delete-soft-delete` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Delete (Destroy)** — Built-in batch delete. Respects soft delete (discard!/destroy!). Per-record permission check, skip count. · `docs/guides/batch-actions.md#batch-delete-hard-delete` `docs/design/batch_action_delete.md` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Permanently Destroy** — Hard-delete discarded records in batch. select_all_filter: false for safety. Archive presenters. · `docs/guides/batch-actions.md#archive-presenter-with-restore-and-permanent-delete` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Restore** — Batch restore soft-deleted records (on archive presenters). Auto-derived from single action with batch:. · `docs/guides/batch-actions.md#archive-presenter-with-restore-and-permanent-delete` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Result Log** — Operation log (result_log: true). batch_operation + batch_operation_item records. Detail link in flash. _(beta)_ · `docs/guides/batch-actions.md#result-logging` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Batch Select (Multiselect)** — Checkbox selection on index (batch: true on actions). Shift-click range, cross-page sessionStorage. · `docs/guides/batch-actions.md#selection-modes` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Bulk Custom Batch Action (batch_capable?)** — Single-call bulk execution (batch_capable? true). Receives full records array. For SQL UPDATE_ALL. · `docs/guides/batch-actions.md#bulk-execution-batch_capable` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Cross-Page Selection** — Selections persist across pagination (sessionStorage). Configurable max_explicit_ids (default 500). · `docs/guides/batch-actions.md#selection-modes` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Per-Record Custom Batch Action** — Per-record iteration for custom actions (batch_capable? false). Same class for single + batch. · `docs/guides/batch-actions.md#per-record-iteration-default` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Per-Record Permission in Batch** — Per-record permission check in batch. Denied records skipped. Split counts in flash message. · `docs/guides/batch-actions.md#per-record-permission-checks` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+- **Select All Matching Filter** — Bulk ops on entire filter set (select_all_filter). Backend receives filter params, not IDs. · `docs/guides/batch-actions.md#select-all-filter-mode` `docs/design/multiselect_and_batch_infrastructure.md` `lib/lcp_ruby/batch_actions/`
+
+## Bind To
+
+- **Bind To (Host Model) — basic** — Connect LCP metadata to existing AR class (bind_to:). Skip builder/schema. Presenters/permissions work. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to: Ransack required-but-missing detection** — Boot error if presenter has search but bound class lacks ransackable_attributes. Actionable message. · `docs/reference/host-controller-integration.md` `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to: associations are metadata-only** — YAML associations on bind_to are metadata-only. Never applied as AR macros. Host owns associations. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to: boot-time field warnings** — Cross-check YAML fields vs bound class columns/methods on boot. Warnings for typos, not errors. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to: label_method always applied** — to_label always defined on bind_to class (options.label_method). Not opt-in. For selects/breadcrumbs. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [attachments]** — Active Storage macros on bound class (bind_to_apply: [attachments]). has_one/many_attached from YAML. · `docs/reference/host-controller-integration.md` `docs/guides/attachments.md#defining-attachment-fields` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [positioning]** — Positioning gem integration on bound class (bind_to_apply: [positioning]). Drag-reorder in indexes. · `docs/reference/host-controller-integration.md` `docs/reference/models.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [ransack]** — Opt-in ransackable_attributes from YAML fields (bind_to_apply: [ransack]). Required for search/filters. · `docs/reference/host-controller-integration.md` `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [scopes]** — Register YAML scopes on bound class (bind_to_apply: [scopes]). AR scope class methods from YAML. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [soft_delete]** — Soft delete on bound class (bind_to_apply: [soft_delete]). discard!/undiscard!, kept/discarded scopes. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [transforms]** — Field normalizations on bound class (bind_to_apply: [transforms]). strip, downcase, normalize_url/phone. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [userstamps]** — Auto-set created_by/updated_by on bound class (bind_to_apply: [userstamps]). before_create/save callbacks. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: [validations]** — Apply YAML validators to bound class (bind_to_apply: [validations]). presence, length, numericality, etc. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **bind_to_apply: combined opt-ins** — Multiple applicators in one YAML (bind_to_apply: [ransack, scopes, ...]). Idempotent on reload. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/model_factory/`
+- **lcp_managed: auto_migrate=false escape hatch** — Production hosts with auto_migrate: false can pre-migrate FK columns by hand; LCP detects them and applies AR macros without modifying schema. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/engine.rb#all_managed_fk_columns_present?`
+- **lcp_managed: belongs_to + auto FK column** — Managed belongs_to on bind_to model — LCP adds the FK column AND declares the AR macro on the host class. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/improve-tasks/school-improve-tasks.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/model_factory/schema_manager.rb#add_managed_fk_columns!` `lib/lcp_ruby/model_factory/association_applicator.rb` `lib/lcp_ruby/engine.rb#apply_bind_to_managed_associations`
+- **lcp_managed: dual-row idempotence (field + belongs_to)** — Same column declared as both a managed `field:` row AND a managed `belongs_to:` row — added exactly once. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/model_factory/schema_manager.rb#apply_managed!`
+- **lcp_managed: enum field (column only, no AR macro)** — Managed enum field — LCP adds the column (as :string) but NOT an AR enum macro; host owns the macro. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/model_factory/schema_manager.rb#add_managed_field_columns!` `lib/lcp_ruby/model_factory/enum_applicator.rb`
+- **lcp_managed: has_many / has_one (no schema on this side)** — Managed has_many / has_one — LCP declares the AR macro on the host class without changing schema on the bound side; FK lives on the target. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/model_factory/association_applicator.rb#apply_has_many` `lib/lcp_ruby/model_factory/association_applicator.rb#apply_has_one`
+- **lcp_managed: polymorphic belongs_to** — Polymorphic managed belongs_to — LCP adds <name>_id + <name>_type pair with composite index, declares polymorphic AR macro. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/model_factory/schema_manager.rb#add_managed_fk_columns!`
+- **lcp_managed: regular column** — Per-item flag that makes LCP additively add a column to a bind_to host table at boot. `field: { name: ..., type: ..., lcp_managed: true }`. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/reference/host-controller-integration.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/model_factory/schema_manager.rb#apply_managed!` `lib/lcp_ruby/engine.rb#apply_bind_to_managed_schema`
+- **lcp_managed: validation + reload safety** — 7 ConfigurationValidator checks (type collision, sub-option mismatch, macro collision, method shadow, nullability, assoc options, dynamic-model misuse) + reload carve-out via lcp_managed_summary. · `docs/design/bind_to_managed_fields_and_associations.md` `docs/design/bind_to_managed_fields_and_associations.md` `lib/lcp_ruby/metadata/configuration_validator.rb#validate_managed_field_collisions` `lib/lcp_ruby/model_factory/managed_tracking.rb`
+
+## Composite Pages
+
+- **Composite Page (Semantic Layout)** — Multi-zone record page (area: main|tabs|sidebar|below). pages/*.yml zones: array. scope_context: for filtering. · `docs/reference/pages.md#composite-pages-semantic-layout` `docs/guides/composite-pages.md#composite-pages-guide` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/resolver.rb` `lib/lcp_ruby/pages/registry.rb`
+- **Conditional Zone on Composite Page** — Role-gated composite zone (visible_when: { role: admin }). Evaluated before queries. Same as dashboard zones. · `docs/reference/pages.md#conditional-zone-visibility` `docs/guides/composite-pages.md#conditional-zone-visibility` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/resolver.rb`
+- **Dialog Reload Zone (Single)** — Dialog success reloads one zone (on_success: :reload_zone, reload_zone: `name`). Turbo Frame src reassigned. · `docs/guides/composite-pages.md#reloading-zones-from-dialogs` `docs/guides/dialogs.md#zone-reload-after-dialog` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Dialog Reload Zones (Multiple)** — Dialog success reloads multiple zones (on_success: :reload_zones, reload_zones: [...]). Parallel Turbo refreshes. · `docs/guides/composite-pages.md#reloading-zones-from-dialogs` `docs/guides/dialogs.md#reload-multiple-zones` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Different Layout Examples** — Six composite layout variants demonstrated: main+tabs+sidebar, main+tabs, main+sidebar, main+below, form+below. · `docs/reference/pages.md#areas` `docs/guides/composite-pages.md#areas` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Form Zone (submit_redirect: self)** — Edit form in main zone (submit_redirect: self). Stays on composite page after save. Needs show+update perms. · `docs/reference/pages.md#form-zones` `docs/guides/composite-pages.md#form-zones` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Index Composite: Conditional Sidebar Zone** — visible_when on index composite sidebar. Same as regular composite zones. Role-based widget visibility. · `docs/reference/pages.md#conditional-zone-visibility` `docs/guides/composite-pages.md#conditional-zone-visibility` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Index Composite: Sidebar KPI Widgets** — Sidebar KPIs on index page (aggregate: count/sum). Scoped to full collection, not a single record. · `docs/reference/pages.md#widget-zones` `docs/reference/pages.md#widget-zones-with-scope_context` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Index-Level Composite Page** — Index table as main zone with sidebar KPIs. No record ID in URL. Tabs not supported. table_columns required. · `docs/reference/pages.md#index-level-composite-pages` `docs/guides/composite-pages.md#index-level-composite-pages` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/resolver.rb`
+- **Main + Below Layout** — Main zone + full-width below zone (area: below). No tabs or sidebar. Simple parent-child relationship view. · `docs/reference/pages.md#sidebarbelow-zones` `docs/guides/composite-pages.md#areas` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Main + Sidebar Layout** — Main + sidebar zones (area: sidebar). KPI widgets, presenter zones. Narrower right column for context data. · `docs/reference/pages.md#sidebarbelow-zones` `docs/guides/composite-pages.md#adding-a-sidebar` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Main + Tabs + Sidebar Layout** — Full semantic layout: main + tabs + sidebar. All composite features combined. Most complete page layout. · `docs/reference/pages.md#tab-navigation` `docs/guides/composite-pages.md#tab-navigation` `docs/guides/composite-pages.md#adding-a-sidebar` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Main + Tabs Layout** — Master-detail: main zone + tab bar (area: tabs). Each tab is a zone. First tab active by default. · `docs/reference/pages.md#tab-navigation` `docs/guides/composite-pages.md#tab-navigation` `docs/design/composite_pages_v2.md` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+- **Main + Tabs Layout (No Sidebar)** — Tabs-only composite: main + tabs, no sidebar. Full-width tabs below main. Simpler than full layout. · `docs/reference/pages.md#tab-navigation` `docs/guides/composite-pages.md#tab-navigation` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Record Click: dialog** — Row click opens modal (record_click: dialog). Show page in dialog via ?_dialog=1. Stays on composite page. · `docs/reference/pages.md#zone-record-click` `docs/guides/composite-pages.md#record-click-behavior` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Record Click: navigate** — Default row click (record_click: navigate). Full-page navigation to record show page. data-href attribute. · `docs/reference/pages.md#zone-record-click` `docs/guides/composite-pages.md#record-click-behavior` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Record Click: none** — Non-clickable rows (record_click: none). No cursor change, no click action. For informational lists. · `docs/reference/pages.md#zone-record-click` `docs/guides/composite-pages.md#record-click-behavior` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Record Source Zone** — Single-record zone by URL param (record_source: { param: field_id }). Shows one record, not a collection. · `docs/reference/pages.md#record-source-zones` `docs/guides/composite-pages.md#record-source-zones` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/widgets/record_source_resolver.rb`
+- **Show in Dialog** — Dialog frame for record show (record_click: dialog + ?_dialog=1). Read-only header + show sections + close button. · `docs/reference/pages.md#show-in-dialog` `docs/reference/dialogs.md#dialog-routing` `docs/design/modal_dialogs.md#dialog-trigger-client-side` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Sidebar Widget with scope_context** — Record-scoped sidebar KPI (scope_context: { fk: `:record.id` }). Aggregate filtered to parent record. · `docs/reference/pages.md#widget-zones-with-scope_context` `docs/reference/pages.md#scope_context` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/scope_context_resolver.rb` `lib/lcp_ruby/widgets/scope_applicator.rb`
+- **Tab Label i18n (label_key)** — Tab label via i18n (label_key:). Falls back to humanized zone name. Locale file under lcp_ruby.composite.*.tabs. · `docs/reference/pages.md#tab-navigation` `docs/guides/composite-pages.md#tab-navigation` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Tab Navigation (Turbo Frames)** — Tabs load via Turbo Frame requests to zone endpoint. No full page reload. Client-side tab switching. · `docs/reference/pages.md#tab-navigation` `docs/guides/composite-pages.md#tab-navigation` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Turbo Frame Lazy Loading** — First tab loads via src= immediately. Other tabs load on click. Reduces initial page load. No prefetch. · `docs/reference/pages.md#zone-endpoint` `docs/guides/composite-pages.md#zone-endpoint` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **URL Bookmarkability (?tab=)** — Tab state in URL (?tab=zone_name). history.replaceState on tab switch. Bookmarkable and shareable tab links. · `docs/reference/pages.md#tab-navigation` `docs/guides/composite-pages.md#tab-navigation` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Endpoint** — Per-zone HTTP endpoint (GET /:slug/:id/zones/:zone). Supports ?page=, ?sort=, ?direction=. Turbo Frame response. · `docs/reference/pages.md#zone-endpoint` `docs/guides/composite-pages.md#zone-endpoint` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Filters (full)** — Full advanced filter pipeline in zone (filters: full). Ransack + custom filters inside tab Turbo Frame. · `docs/reference/pages.md#zone-filters` `docs/guides/composite-pages.md#zone-filtering` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Filters (none)** — No search UI in zone (filters: none). Default for sidebar/below. For compact lists where search adds no value. · `docs/reference/pages.md#zone-filters` `docs/guides/composite-pages.md#zone-filtering` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Filters (quick)** — Quick text search in zone (filters: quick). Default for tabs. Renders inside Turbo Frame. No page reload. · `docs/reference/pages.md#zone-filters` `docs/guides/composite-pages.md#zone-filtering` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Pagination** — Kaminari pagination inside zone Turbo Frame (per_page on zone presenter). Only zone content updates on page click. · `docs/reference/pages.md#zone-attributes` `docs/guides/composite-pages.md#composite-pages-guide` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Sorting** — Sortable zone columns (sortable: true). Click header to sort within Turbo Frame. Independent per zone. · `docs/reference/pages.md#zone-attributes` `docs/guides/composite-pages.md#composite-pages-guide` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone Width (Grid Proportions)** — CSS grid ratio (width: 1-12). Default main:sidebar = 8:4. Custom e.g. 9:3 for wider main area. · `docs/reference/pages.md#zone-width` `docs/guides/composite-pages.md#custom-mainsidebar-proportions` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Zone default_scope** — Always-on base filter (default_scope: scope_name). Applied before zone scope_context. Cumulative with scope. · `docs/reference/pages.md#zone-default-scope` `docs/guides/composite-pages.md#default-scope` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **index_presenter (Index Presenter Override)** — Index action presenter override (index_presenter:). Needed when show zone has no table_columns. Same model required. · `docs/reference/pages.md#index-level-composite-pages` `docs/guides/composite-pages.md#index-presenter-override` `docs/design/composite_pages_v2.md` `app/views/lcp_ruby/resources/_semantic_page.html.erb` `app/views/lcp_ruby/resources/_semantic_index_page.html.erb` `app/controllers/lcp_ruby/resources_controller.rb`
+- **scope_context (Record Scoping)** — Dynamic zone filtering (scope_context: { field: `:record.id` }). Supports :record.<field>, :current_user, :current_date. · `docs/reference/pages.md#scope_context` `docs/guides/composite-pages.md#scope_context` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/scope_context_resolver.rb`
+
+## Custom Fields
+
+- **Boolean Custom Fields** — Boolean custom fields. default_value: true/false. custom_type: boolean. Renders as Yes/No badge. · `docs/guides/custom-fields.md#field-types` `docs/reference/custom-fields.md#custom-field-definition-attributes` `lib/lcp_ruby/custom_fields/applicator.rb` `lib/lcp_ruby/custom_fields/registry.rb`
+- **Conditional Custom Field Form** — visible_when on form sections by custom_type. Text/Numeric/Enum constraints shown conditionally. · `docs/guides/custom-fields.md#working-with-sections` `docs/reference/custom-fields.md#visibility-attributes` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Custom Field Display Options** — Visibility: show_in_table, show_in_form, show_in_show. sortable:, searchable:, column_width:, active:. · `docs/reference/custom-fields.md#rendering-attributes` `docs/reference/custom-fields.md#input_type` `docs/reference/custom-fields.md#renderer` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Custom Field Hints** — Optional hint: attribute on definitions. Displayed below form inputs. Propagated via LayoutBuilder. · `docs/reference/custom-fields.md#description` `docs/reference/custom-fields.md#placeholder` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Custom Field Permissions** — Per-field granularity: fields.readable/writable lists. custom_data aggregate. field_overrides:. · `docs/guides/custom-fields.md#permission-model` `docs/reference/custom-fields.md#permissions` `docs/reference/custom-fields.md#readable_by_roles` `docs/reference/custom-fields.md#writable_by_roles` `lib/lcp_ruby/custom_fields/applicator.rb` `lib/lcp_ruby/custom_fields/contract_validator.rb`
+- **Custom Field Sections** — Group fields by section: attribute. position: controls ordering. Rendered as separate headings. · `docs/guides/custom-fields.md#working-with-sections` `docs/reference/custom-fields.md#section` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Custom Fields Generator** — rails generate lcp_ruby:custom_fields. Creates model, presenter, permissions, view group. --format=yaml. · `docs/guides/custom-fields.md#step-1-generate-custom-field-definition-metadata` `docs/reference/custom-fields.md#how-it-works` `lib/generators/lcp_ruby/custom_fields_generator.rb` `lib/lcp_ruby/custom_fields/setup.rb`
+- **Custom Fields Overview** — Runtime user-defined fields. custom_fields: true in model options. Generator: lcp_ruby:custom_fields. · `docs/guides/custom-fields.md#custom-fields-guide` `docs/reference/custom-fields.md#custom-fields-reference` `lib/lcp_ruby/custom_fields/`
+- **Custom Fields on Multiple Models** — Multiple models with custom_fields: true. Scoped by target_model. Nested management routes. · `docs/guides/custom-fields.md#step-2-enable-custom-fields-on-a-model` `docs/reference/custom-fields.md#enabling-custom-fields` `lib/lcp_ruby/custom_fields/registry.rb` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Date & DateTime Custom Fields** — Date/datetime custom fields. custom_type: date/datetime. sortable:, show_in_table:. · `docs/guides/custom-fields.md#field-types` `docs/reference/custom-fields.md#custom_type` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Enum Custom Fields** — Enum custom fields. enum_values: array of strings or {value,label}. custom_type: enum. default_value:. · `docs/guides/custom-fields.md#enum-fields` `docs/reference/custom-fields.md#enum_values` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Numeric Custom Fields** — Integer/float/decimal custom fields. min_value:, max_value:, precision:. custom_type: integer/float/decimal. · `docs/guides/custom-fields.md#field-types` `docs/reference/custom-fields.md#min_value` `docs/reference/custom-fields.md#max_value` `docs/reference/custom-fields.md#precision` `lib/lcp_ruby/custom_fields/applicator.rb`
+- **Programmatic Custom Field Access** — Dynamic accessors: record.nickname. Low-level: read_custom_field/write_custom_field. No restart needed. · `docs/guides/custom-fields.md#programmatic-access` `docs/reference/custom-fields.md#programmatic-api` `docs/reference/custom-fields.md#reading-and-writing-values` `lib/lcp_ruby/custom_fields/registry.rb` `lib/lcp_ruby/custom_fields/query.rb`
+- **String Custom Fields** — String custom fields. min_length:, max_length:, searchable:, show_in_table:. custom_type: string. · `docs/guides/custom-fields.md#field-types` `docs/reference/custom-fields.md#min_length` `docs/reference/custom-fields.md#max_length` `lib/lcp_ruby/custom_fields/applicator.rb`
+
+## Custom Render Blocks
+
+- **Custom Form Section (type: custom)** — Replace form section with host partial. Receives form builder. additional_permitted_params for inputs. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Custom Render Blocks vs View Slots** — Substitution (render blocks) vs injection (view slots). Declarative YAML vs imperative Registry.register. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Custom Show Section (type: custom)** — Replace show section with host partial (custom_section). Receives record, presenter, evaluator locals. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Custom Zone in Composite Page (tabs)** — Custom zone in page tabs/sidebar (type: custom, partial:). Lazy Turbo Frame or eager: true rendering. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/` `lib/lcp_ruby/pages/`
+- **Custom Zone in Sidebar (eager: true)** — Inline-rendered sidebar zone (eager: true). No lazy loading. For lightweight or script-needing content. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Custom Zone with scope_context** — Pass resolved values to custom partials (scope_context:). Optional scoped_records AR relation. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Index render_with (custom index layout)** — Replace index content area with host partial (render_with). LCP layout preserved, records pre-filtered. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Production Error Handling for Custom Partials** — Graceful degradation in production. Dev: propagate. Prod: rescue, log, show error block. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **Show render_with (custom show layout)** — Replace show content area with host partial (show render_with). LCP frame preserved. Not in dialogs. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **action_set in render_with Partials** — Permission-aware action resolver in partials (action_set). collection_actions, single_actions(record). · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/`
+- **additional_permitted_params on Custom Form Sections** — Whitelist custom form inputs (additional_permitted_params:). Scalar names or nested hash specs. · `docs/guides/rendering-extension-points.md` `docs/design/custom_render_blocks.md` `lib/lcp_ruby/presenter/` `lib/lcp_ruby/controller/`
+
+## Dashboards
+
+- **Apply Button Dirty State** — .is-dirty class on the filter Apply button + i18n unapplied-count badge. Stimulus controller snapshots initial values, compares on change/input. · `docs/reference/page_filters.md#apply-button--dirty-state` `docs/design/page_filters_as_virtual_forms.md` `app/assets/javascripts/lcp_ruby/controllers/filter_dirty_controller.js`
+- **Auto-Refresh (depends_on)** — Auto-refresh zone on model CUD (depends_on: [model]). Turbo Streams broadcast. Requires turbo-rails gem. _(beta)_ · `docs/reference/pages.md#auto-refresh-depends_on` `docs/guides/composite-pages.md#auto-refresh-with-depends_on` `docs/design/dashboards.md#configuration-behavior` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+- **Cascading Filter Selects** — input_options.depends_on on filter association_select/multi_select. Parent change reloads child via /select_options. Reuses form-side cascade JS. · `docs/reference/page_filters.md#cascading-associations-depends_on` `docs/reference/cascading_selects.md` `docs/design/page_filters_as_virtual_forms.md` `app/controllers/lcp_ruby/resources_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/cascading_selects_controller.js` `app/helpers/lcp_ruby/form_helper.rb`
+- **Chart Axis Titles** — X/Y axis titles (xtitle:, xtitle_key:, ytitle:, ytitle_key:). Literal or i18n key. Not applicable to pie/donut. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart Colors** — Default Okabe-Ito 8-color palette; chart-level colors: array; per-series color:. Priority: per-series > colors[index] > palette. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/chart_palette.rb`
+- **Chart Empty-State Banner** — Localized empty banner when ALL series have zero rows. empty:/empty_key:. link_to: is suppressed. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb` `app/views/lcp_ruby/widgets/_chart.html.erb`
+- **Chart Legend Control** — Legend visibility/position via legend: enum (auto/true/false/top/bottom/left/right). auto is context-aware. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart Library Escape Hatch** — Raw Chart.js options passthrough via library:. Deep-merged over platform defaults; has last word. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart Line Smoothing** — curve: / points: for line/area charts. curve: false for sharp line; points: true for visible dot markers. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart PNG Download** — Chartkick PNG download button (download: true). Captures the canvas only; chart title outside the canvas is not included. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart Sort Order** — sort: asc / desc / none / value_asc / value_desc. Default asc for date group_period, none otherwise. value_* sorts by per-category sum for multi-series. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart Value Formatting** — Value prefix/suffix/precision/thousands. e.g. prefix: "€", thousands: " ", precision: 0. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Chart Widget** — Chartkick chart (widget type: chart). chart_type:, group_by:, aggregate:, group_period:. Supports line / bar / column / pie / donut / area. Requires chartkick gem. · `docs/reference/pages.md#chart` `docs/guides/dashboards.md#chart` `docs/design/dashboards.md#widget-zone-types` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb` `lib/lcp_ruby/widgets/chartkick_check.rb` `lib/lcp_ruby/widgets/chart_palette.rb` `lib/lcp_ruby/widgets/date_grouper.rb`
+- **Chart Y-Axis Bounds** — Y axis min:/max: numeric bounds. Not applicable to pie/donut. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Column Chart Type** — Vertical column chart (chart_type: column). Counterpart to bar (horizontal). Typical business reporting chart. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb` `app/views/lcp_ruby/widgets/_chart.html.erb`
+- **Conditional Zone (visible_when)** — Role/condition gated zone (visible_when: { role: admin }). Evaluated before data queries. Works on all page types. · `docs/reference/pages.md#conditional-zone-visibility` `docs/guides/dashboards.md#conditional-zones` `docs/design/dashboards.md#configuration-behavior` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+- **Dashboard Page (Grid Layout)** — Standalone grid page (layout: grid). pages/*.yml zones: array. KPI cards, text, list, presenter, chart widgets. · `docs/reference/pages.md#grid-positioning` `docs/guides/dashboards.md#grid-layout` `docs/design/dashboards.md#grid-layout` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+- **Date Range Filter** — input_type: date_range on filter form. Two date inputs, gteq/lteq translation via ScopeApplicator. · `docs/reference/page_filters.md#date-range-input_type-date_range` `docs/design/page_filters_as_virtual_forms.md` `lib/lcp_ruby/widgets/scope_applicator.rb`
+- **Embed Widget** — Iframe BI embed (widget type: embed). provider:, resource_type:, resource_id:. Metabase/Grafana JWT auth. _(beta)_ · `docs/reference/pages.md#embed-widget` `docs/guides/composite-pages.md#embedding-external-dashboards` `docs/design/dashboards.md#dashboard-with-external-bi-embed-tier-3` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Filter Auto-Submit Derivation** — auto_submit: derive | true | false. Derives Apply button vs auto-submit from filter_form shape (multi: / depends_on:). · `docs/reference/page_filters.md#auto_submit-derivation` `docs/design/page_filters_as_virtual_forms.md` `lib/lcp_ruby/pages/filter_form.rb`
+- **Grid CSS Positioning** — Zone placement (position: { row:, col:, width:, height: }). 12-column CSS grid. Zones span multiple cols/rows. · `docs/reference/pages.md#grid-positioning` `docs/guides/dashboards.md#grid-layout` `docs/design/dashboards.md#grid-layout` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+- **KPI Card Widget** — Aggregate metric card (widget type: kpi_card). model:, aggregate:, scope:, icon:, link_to:. In page zones. · `docs/reference/pages.md#kpi_card` `docs/guides/dashboards.md#kpi-card` `docs/design/dashboards.md#widget-zone-types` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **KPI Trend Indicator** — KPI with delta arrow (compare_scope: on kpi_card). Shows percentage change vs comparison scope. Up/down/neutral. · `docs/reference/pages.md#kpi_card` `docs/guides/dashboards.md#kpi-trend-indicators` `docs/design/dashboards.md#widget-zone-types` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Landing Page Configuration** — Post-login redirect (config.landing_page = { role => slug }). Per-role landing pages with default fallback. · `docs/reference/pages.md#page-attributes` `docs/guides/dashboards.md#3-configure-landing-page-optional` `docs/design/dashboards.md#dashboard-as-landing-page` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+- **List Widget** — Compact record list (widget type: list). model:, limit:, link_to:. Shows label_method values in a list. · `docs/reference/pages.md#list` `docs/guides/dashboards.md#list` `docs/design/dashboards.md#widget-zone-types` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Multi-Select Filter** — input_options.multi: true on filter form fields. URL emits bracket-array (?page_filter[field][]=…). Defensive Type::ArrayOf coercion. · `docs/reference/page_filters.md#multi-select-multi-true` `docs/reference/virtual_forms.md#security-invariants` `docs/design/page_filters_as_virtual_forms.md` `lib/lcp_ruby/virtual_fields/types/array_of.rb` `lib/lcp_ruby/pages/filter_form.rb`
+- **Multi-Series Chart** — Multiple data series in one chart (series: array). Each series has its own name, color, scope, and may override group_by/aggregate. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Page Filter Form** — Page-level filter bar (filter_form: array, form-syntax fields). Propagated to all zones via ScopeApplicator. Supports text, select, multi-select, association_select, date_range, boolean, … · `docs/reference/page_filters.md` `docs/reference/pages.md#page-filters` `docs/design/page_filters_as_virtual_forms.md` `lib/lcp_ruby/pages/filter_form.rb` `lib/lcp_ruby/pages/filter_form_validator.rb` `lib/lcp_ruby/widgets/scope_applicator.rb` `app/views/lcp_ruby/resources/_filter_form.html.erb`
+- **Presenter Zone on Dashboard** — Embedded index table in dashboard grid (presenter:, limit:). Reuses existing presenter columns. No widget config. · `docs/reference/pages.md#presenter-zones` `docs/guides/dashboards.md#presenter-zone` `docs/design/dashboards.md#widget-zone-types` `lib/lcp_ruby/widgets/presenter_zone_resolver.rb`
+- **Scope Filters** — Page-level AR-scope toggle bar (scope_filters: array). Each entry maps UI options to named scopes on the page model. widget: select/radio/button_group. · `docs/reference/page_filters.md#scope_filters-syntax` `docs/design/page_filters_as_virtual_forms.md` `lib/lcp_ruby/pages/scope_filter_set.rb` `lib/lcp_ruby/widgets/scope_applicator.rb` `app/views/lcp_ruby/resources/_scope_filters.html.erb`
+- **Stacked Chart** — Stack series on the Y axis (stacked: true). Legal for column/bar/line/area; hard error for pie/donut. · `docs/reference/pages.md#chart` `docs/design/chart_widget_multi_series.md` `lib/lcp_ruby/widgets/data_resolver.rb`
+- **Text Widget** — Static i18n content (widget type: text, content_key:). For welcome messages, announcements on dashboard pages. · `docs/reference/pages.md#text` `docs/guides/dashboards.md#text` `docs/design/dashboards.md#widget-zone-types` `app/helpers/lcp_ruby/dashboard_helper.rb` `app/views/lcp_ruby/resources/_grid_page.html.erb`
+
+## Dialogs
+
+- **Composite Dialog Page** — Multi-zone dialog (page dialog: { size: }). Form + sidebar/below zones in one dialog. All zones render inline. · `docs/reference/dialogs.md#composite-dialog-pages` `docs/reference/pages.md#composite-dialog-pages` `docs/guides/dialogs.md#composite-dialog-pages` `docs/design/modal_dialogs.md#configuration-behavior` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Composite Dialog: Sidebar with record_source** — Dialog sidebar showing context (record_source: { param: }). Loaded from defaults: { field: `:record.id` }. · `docs/reference/dialogs.md#composite-dialog-pages` `docs/reference/pages.md#record-source-zones` `docs/guides/dialogs.md#composite-dialog-pages` `docs/design/modal_dialogs.md#configuration-behavior` `lib/lcp_ruby/widgets/record_source_resolver.rb`
+- **Dialog Nesting (Max 2 Levels)** — Nested dialog on top of primary (max 2 levels). on_success: :reload re-fetches primary. :close closes nested only. · `docs/reference/dialogs.md#dialog-nesting` `docs/guides/dialogs.md#dialog-nesting` `docs/design/modal_dialogs.md#d7-no-nesting-in-tier-1` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Dialog Sizing** — Four dialog sizes (dialog size: :small|:medium|:large|:fullscreen). 400/600/800/95vw. Centered with backdrop. · `docs/reference/dialogs.md#dialog-config-object` `docs/reference/pages.md#dialog-configuration` `docs/design/modal_dialogs.md#dialog-config-properties` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Dual-Use Presenter (Page + Dialog)** — Same presenter as standalone page and dialog. Dialog renders form portion; page renders full CRUD. No duplication. · `docs/reference/dialogs.md#dialog-routing` `docs/guides/dialogs.md#dual-use-presenter` `docs/design/modal_dialogs.md#dual-use-presenter-page-and-dialog` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Page-Based Confirmation Dialog** — Full form before action (confirm: { page: `dialog_name` }). Virtual model validates, confirmation_data[] forwarded. · `docs/reference/dialogs.md#page-based-confirmation` `docs/guides/dialogs.md#page-based-confirmation-dialog` `docs/design/modal_dialogs.md#confirmation-dialog-lightweight-no-page-needed` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Presenter-Driven Dialog** — Dialog form via presenter (dialog size:, title_key:). Served at /lcp_dialog/:page/new. No slug needed. · `docs/reference/dialogs.md#dialog-action-configuration` `docs/reference/pages.md#dialog-only-pages` `docs/design/modal_dialogs.md#dialog-only-presenter-most-common-case` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Quick Create Dialog** — Collection-level dialog create (type: :dialog, on: :collection). Minimal form, on_success: :reload. No slug needed. · `docs/reference/dialogs.md#dialog-action-configuration` `docs/guides/dialogs.md#quick-create-dialog` `docs/design/modal_dialogs.md#quick-create-real-model-in-dialog` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Quick Note Dialog (Virtual Model)** — Virtual model dialog (table_name: `_virtual`). Validates but never persists. Per-row action from another presenter. · `docs/reference/dialogs.md#virtual-model-dialog-flow` `docs/guides/dialogs.md#virtual-model-dialog` `docs/design/modal_dialogs.md#virtual-model-dialog-no-persistence` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Resource Dialog (?_dialog=1)** — Open any resource as dialog (?_dialog=1). type: :dialog action, record: :current. Reuses existing controller/form. · `docs/reference/dialogs.md#dialog-routing` `docs/reference/pages.md#dialog-configuration` `docs/design/modal_dialogs.md#submit-flow-two-routing-paths` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Saved Filter Dialog** — Save filter presenter dialog with visible_when conditions. beforeSubmit JS hook injects condition_tree params. · `docs/reference/dialogs.md#dialog-action-configuration` `docs/guides/dialogs.md#quick-create-dialog` `docs/design/modal_dialogs.md#replacing-the-hardcoded-saved-filter-dialog` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Simple Browser Confirm** — Native browser confirm (confirm: true or confirm: `message`). Simplest one-line confirmation. · `docs/reference/dialogs.md#simple-boolean` `docs/reference/dialogs.md#confirm-dialog-variants` `docs/design/modal_dialogs.md#confirmation-dialog-lightweight-no-page-needed` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+- **Styled Confirmation Dialog** — Custom confirm prompt (confirm: { title_key:, message_key:, style: :danger }). Platform dialog, not browser native. · `docs/reference/dialogs.md#styled-confirmation` `docs/guides/dialogs.md#styled-confirmation-dialog` `docs/design/modal_dialogs.md#confirmation-dialog-lightweight-no-page-needed` `app/controllers/lcp_ruby/dialogs_controller.rb` `app/assets/javascripts/lcp_ruby/controllers/dialog_controller.js` `app/views/lcp_ruby/dialogs/_dialog_frame.html.erb`
+
+## Display Types
+
+- **Attachment Display Types** — File renderers (renderer: attachment_preview/list/link). variant:. presenters/*.yml show fields. · `docs/guides/display-types.md#image` `docs/guides/display-types.md#avatar` `docs/guides/attachments.md#display-configuration` `docs/guides/attachments.md#attachment_preview` `docs/guides/attachments.md#attachment_list` `docs/guides/attachments.md#attachment_link` `docs/reference/presenters.md#attachment_preview` `docs/reference/presenters.md#attachment_list` `docs/reference/presenters.md#attachment_link` `lib/lcp_ruby/display/renderers/attachment_preview.rb` `lib/lcp_ruby/display/renderers/attachment_list.rb` `lib/lcp_ruby/display/renderers/attachment_link.rb` `lib/lcp_ruby/display/renderers/image.rb` `lib/lcp_ruby/display/renderers/avatar.rb`
+- **Badge Display** — Colored pill renderer (renderer: badge). color_map: per value. presenters/*.yml column options. · `docs/guides/display-types.md#badge` `docs/reference/presenters.md#badge` `lib/lcp_ruby/display/renderers/badge.rb`
+- **Boolean Icon Display** — Yes/No colored text (renderer: boolean_icon). true_icon:, false_icon:. presenters/*.yml columns. · `docs/guides/display-types.md#boolean_icon` `docs/reference/presenters.md#boolean_icon` `lib/lcp_ruby/display/renderers/boolean_icon.rb`
+- **Code Display** — Monospace <code> rendering (renderer: code). For UUIDs, JSON, IDs. presenters/*.yml columns/show. · `docs/guides/display-types.md#code` `docs/reference/presenters.md#code` `lib/lcp_ruby/display/renderers/code.rb`
+- **Collection Display** — Array value renderer (renderer: collection). separator:, limit:, item_renderer:. presenters/*.yml. · `docs/guides/display-types.md#collection-renderer` `docs/reference/presenters.md#collection-renderer` `lib/lcp_ruby/display/renderers/collection.rb`
+- **Color Swatch Display** — Colored square preview (renderer: color_swatch). Safe CSS validation. presenters/*.yml columns. · `docs/guides/display-types.md#color_swatch` `docs/reference/presenters.md#color_swatch` `lib/lcp_ruby/display/renderers/color_swatch.rb`
+- **Currency Display** — Money formatter (renderer: currency). currency:, precision:. presenters/*.yml column options. · `docs/guides/display-types.md#currency` `docs/reference/presenters.md#currency` `lib/lcp_ruby/display/renderers/currency.rb`
+- **Email / Phone / URL Link Displays** — Clickable links (renderer: email_link/phone_link/url_link). mailto:, tel:, external. presenters/*.yml. · `docs/guides/display-types.md#email_link` `docs/guides/display-types.md#phone_link` `docs/guides/display-types.md#url_link` `docs/reference/presenters.md#email_link` `docs/reference/presenters.md#phone_link` `docs/reference/presenters.md#url_link` `lib/lcp_ruby/display/renderers/email_link.rb` `lib/lcp_ruby/display/renderers/phone_link.rb` `lib/lcp_ruby/display/renderers/url_link.rb`
+- **Heading Display** — Bold <strong> text (renderer: heading). link_to: show for clickable. presenters/*.yml columns. · `docs/guides/display-types.md#heading` `docs/reference/presenters.md#heading` `lib/lcp_ruby/display/renderers/heading.rb`
+- **Internal Link Display** — In-app link (renderer: internal_link). label: custom text. presenters/*.yml column options. · `docs/guides/display-types.md#internal_link` `docs/reference/presenters.md#internal_link` `lib/lcp_ruby/display/renderers/internal_link.rb`
+- **Markdown Display** — GFM-to-HTML renderer (renderer: markdown). Commonmarker-based. presenters/*.yml show fields. · `docs/guides/display-types.md#rich_text` `docs/reference/presenters.md#rich_text` `lib/lcp_ruby/display/renderers/markdown.rb`
+- **Number / Percentage / File Size Displays** — Numeric formatters (renderer: number/percentage/file_size). precision:. presenters/*.yml columns. · `docs/guides/display-types.md#number` `docs/guides/display-types.md#percentage` `docs/guides/display-types.md#file_size` `docs/reference/presenters.md#number` `docs/reference/presenters.md#percentage` `docs/reference/presenters.md#file_size` `lib/lcp_ruby/display/renderers/number.rb` `lib/lcp_ruby/display/renderers/percentage.rb` `lib/lcp_ruby/display/renderers/file_size.rb`
+- **Progress Bar Display** — Visual bar (renderer: progress_bar). max: default 100. presenters/*.yml column options. · `docs/guides/display-types.md#progress_bar` `docs/reference/presenters.md#progress_bar` `lib/lcp_ruby/display/renderers/progress_bar.rb`
+- **Rating Display** — Star rating renderer (renderer: rating). max: configurable. presenters/*.yml column options. · `docs/guides/display-types.md#rating` `docs/reference/presenters.md#rating` `lib/lcp_ruby/display/renderers/rating.rb`
+- **Relative Date Display** — Human-readable time ago (renderer: relative_date). '3 days ago' style. presenters/*.yml columns. · `docs/guides/display-types.md#relative_date` `docs/reference/presenters.md#relative_date` `lib/lcp_ruby/display/renderers/relative_date.rb`
+- **Truncate Display** — Ellipsis text overflow (renderer: truncate). max: char limit, tooltip on hover. presenters/*.yml. · `docs/guides/display-types.md#truncate` `docs/reference/presenters.md#truncate` `lib/lcp_ruby/display/renderers/truncate.rb`
+
+## Export
+
+- **Association Field Expansion** — Dot-path fields for belongs_to/has_one (e.g. department.name). Max depth 3, auto eager-loading. · `docs/reference/export.md#dot-path-fields` `docs/guides/export.md#association-fields` `docs/design/export.md#recursive-belongs_tohas_one-field-resolution` `lib/lcp_ruby/export/`
+- **Batch Export** — Export selected records via batch toolbar. Explicit IDs or filter mode. Session token for large sets. · `docs/reference/export.md#batch-export` `docs/guides/export.md` `docs/design/export.md#d13-unified-export-covers-both-collection-and-batch` `docs/design/batch_action_export.md` `lib/lcp_ruby/export/`
+- **CSV Export** — CSV with UTF-8 BOM (export formats: [:csv]). Configurable delimiter (csv_delimiter: `;`). · `docs/reference/export.md#csv-format` `docs/guides/export.md` `docs/design/export.md#csv-generation` `docs/design/export.md#d14-csv-encoding-utf-8-with-bom` `lib/lcp_ruby/export/`
+- **Collection Export** — Toolbar export button with dialog (export formats: [:csv, :xlsx]). Field picker, format choice, filters. · `docs/reference/export.md#collection-export` `docs/guides/export.md#basic-setup` `docs/design/export.md#enabling-export-on-a-presenter` `lib/lcp_ruby/export/`
+- **Export Column Headers (i18n)** — i18n headers (lcp_ruby.export.headers.<model>.<path>). Humanized fallback. Dot-path segments joined. · `docs/reference/export.md#column-headers-i18n` `docs/guides/export.md#custom-column-headers` `docs/design/export.md#column-headers` `lib/lcp_ruby/export/`
+- **Export Dialog** — Built-in dialog with Stimulus controller (lcp-export-dialog). Fetch-based download, no page reload. · `docs/reference/export.md#export-dialog` `docs/guides/export.md` `docs/design/export.md#export-dialog` `docs/design/export.md#dialog-ui-layout` `lib/lcp_ruby/export/`
+- **Export Formatting Options** — Per-type formatting: enum_mode, date_format, boolean_mode, decimal_separator. Saved with profiles. · `docs/reference/export.md#formatting-options` `docs/guides/export.md#formatting-options` `docs/design/export.md#field-value-formatting` `docs/design/export.md#d15-field-value-formatting-is-configurable` `lib/lcp_ruby/export/`
+- **Export Generator** — Generator: lcp_ruby:export. Creates export_profile + export_log models, presenters, permissions. · `docs/reference/export.md#generator` `docs/design/export.md#generator` `lib/lcp_ruby/export/`
+- **Export History** — Log exports (save_history: true). export_log model with fields, filters, file attachment, user. · `docs/reference/export.md#export-history` `docs/guides/export.md#export-history` `docs/design/export.md#export_log-export-history-with-file-attachment` `docs/design/export.md#d3-export_log-is-opt-in` `lib/lcp_ruby/export/`
+- **Export Max Records** — Safety limit (export max_records: 5000). COUNT check before loading. Dialog error if exceeded. · `docs/reference/export.md` `docs/guides/export.md#max-records` `docs/design/export.md#max_records-enforcement` `lib/lcp_ruby/export/`
+- **Export Profiles** — Save/reuse field selections (export_profile model). Visibility: personal/role/global. Stale field detection. · `docs/reference/export.md#export-profiles` `docs/guides/export.md#saved-profiles` `docs/design/export.md#export_profile-saved-field-selections-reusable` `docs/design/export.md#d11-profile-visibility-personal-role-global` `lib/lcp_ruby/export/`
+- **Export Sort Preservation** — Exported file preserves current sort order. Sort params passed via URL to export handler. · `docs/reference/export.md` `docs/guides/export.md#filter-and-sort-preservation` `docs/design/export.md#d18-sort-order-preserved` `lib/lcp_ruby/export/`
+- **Export with Filters** — Collection export preserves current filter/sort state. Exported file matches screen (minus pagination). · `docs/reference/export.md` `docs/guides/export.md#filter-and-sort-preservation` `docs/design/export.md#passing-current-filters-and-sort-to-the-dialog` `docs/design/export.md#d8-filters-passed-via-url-params` `lib/lcp_ruby/export/`
+- **Export with Soft Delete** — Active view exports non-discarded. Archive exports discarded. Batch explicit exports selected IDs. · `docs/reference/export.md#soft-delete-integration` `docs/guides/export.md#soft-delete-integration` `docs/design/export.md#d17-soft-delete-follows-presenter-scope` `lib/lcp_ruby/export/`
+- **Field Ceiling** — Restrict export fields (export fields: [...]). Permission ceiling further filtered by readable_fields. · `docs/reference/export.md#fields-ceiling-and-fk-mapping` `docs/guides/export.md#field-ceiling` `docs/design/export.md#export-fields-what-appears-in-the-field-picker` `docs/design/export.md#d10-export-section-as-optional-ceiling` `lib/lcp_ruby/export/`
+- **Field Picker** — Checkbox tree for field selection. Expandable association groups, recursive depth 3, dot-path notation. · `docs/reference/export.md#field-picker` `docs/design/export.md#1-field_picker-input-type` `docs/design/export.md#d7-field-picker-is-a-platform-input-type` `lib/lcp_ruby/export/`
+- **Permission-Filtered Export** — Export respects permissions: action, field-level, association-level, record-level (policy_scope). · `docs/reference/export.md#permissions` `docs/guides/export.md#basic-setup` `docs/design/export.md#permission-integration` `lib/lcp_ruby/export/`
+- **XLSX Export** — Excel export (export formats: [:xlsx]). Requires caxlsx gem. Bold headers, auto column width. · `docs/reference/export.md#xlsx-format` `docs/guides/export.md#xlsx-support` `docs/design/export.md#xlsx-generation` `docs/design/export.md#d4-xlsx-as-optional-dependency` `lib/lcp_ruby/export/`
+
+## Extensibility
+
+- **Built-in Condition Service — `feature_flag`** — Returns true when a named feature flag is on. Default backend reads `LcpRuby.configuration.feature_flags`; hosts can swap in their own backend. · `docs/reference/menu.md#conditional-visibility` `docs/design/user-menu.md` `lib/lcp_ruby/condition_services/feature_flag.rb`
+- **Built-in Condition Service — `impersonating`** — Returns true when the current user is wrapped in `LcpRuby::ImpersonatedUser`. Use to gate "Stop impersonating" menu items / impersonation banner. · `docs/reference/menu.md#conditional-visibility` `docs/design/user-menu.md` `lib/lcp_ruby/condition_services/impersonating.rb`
+- **Condition DSL Builder** — Ruby DSL for conditions: field(:name).eq/gt/present, all/any/not_condition/collection blocks. · `docs/guides/extensibility.md#condition-services` `lib/lcp_ruby/dsl/condition_builder.rb` `lib/lcp_ruby/condition_evaluator.rb`
+- **Condition Services** — Custom Ruby evaluators for visible_when/disable_when. app/condition_services/. Returns boolean. · `docs/guides/extensibility.md#condition-services` `lib/lcp_ruby/condition_service_registry.rb` `lib/lcp_ruby/condition_evaluator.rb`
+- **Custom Actions** — Host-app Ruby action classes (type: custom). app/actions/ directory. ActionRegistry. · `docs/guides/custom-actions.md#custom-actions` `docs/guides/extensibility.md#custom-actions` `docs/guides/custom-actions.md#creating-an-action` `docs/guides/custom-actions.md#registering-the-action-in-yaml` `lib/lcp_ruby/actions/base_action.rb` `lib/lcp_ruby/actions/action_executor.rb` `lib/lcp_ruby/actions/action_registry.rb` `lib/lcp_ruby/actions/form_action_pipeline.rb`
+- **Custom Display Renderers** — Host-app renderer classes. app/renderers/ directory. Extends Display::BaseRenderer. Auto-discovered. · `docs/guides/custom-renderers.md#custom-renderers` `docs/guides/custom-renderers.md#creating-a-custom-renderer` `docs/guides/custom-renderers.md#auto-discovery` `lib/lcp_ruby/display/base_renderer.rb` `lib/lcp_ruby/display/renderer_registry.rb`
+- **Dev Metadata Reload (Auto-Watch)** — ActiveSupport::FileUpdateChecker against config/lcp_ruby/. YAML/DSL edits auto-trigger Engine.reload! on the next request. Dev only (enable_reloading). · `docs/getting-started.md#dev-workflow` `docs/reference/boot_lifecycle.md` `docs/design/boot_reload_lifecycle.md` `lib/lcp_ruby/engine.rb`
+- **Event Handlers** — Lifecycle callbacks (after_create, after_update). app/event_handlers/ directory. Events::BaseHandler. · `docs/guides/event-handlers.md#event-handlers` `docs/guides/extensibility.md#event-handlers` `docs/guides/event-handlers.md#creating-a-handler` `docs/guides/event-handlers.md#async-handlers` `lib/lcp_ruby/events/handler_base.rb` `lib/lcp_ruby/events/dispatcher.rb` `lib/lcp_ruby/events/handler_registry.rb` `lib/lcp_ruby/events/async_handler_job.rb`
+- **LcpRuby.on_models_loaded Hook** — Boot/reload hook: register a block that fires inside Engine.load_metadata! after every dynamic model is built. Persistent across reloads. · `docs/guides/extensibility.md#hook-timing` `docs/reference/boot_lifecycle.md` `docs/design/authorization_hardening.md#boot-lifecycle-lcprubyon_models_loaded-new-hook` `docs/design/boot_reload_lifecycle.md` `lib/lcp_ruby.rb` `lib/lcp_ruby/engine.rb`
+- **Value Services (Parameterized)** — Computed values for condition comparisons. service: key + params:. app/condition_services/ directory. · `docs/guides/extensibility.md#dynamic-defaults` `docs/guides/extensibility.md#computed-fields` `docs/guides/extensibility.md#service-validators` `lib/lcp_ruby/services/registry.rb` `lib/lcp_ruby/services/checker.rb` `lib/lcp_ruby/services/built_in_defaults.rb` `lib/lcp_ruby/services/built_in_transforms.rb`
+- **Virtual Forms (Synthetic Form Objects)** — LcpRuby::VirtualFields::VirtualField + VirtualForm + Type::ArrayOf. Per-request AM::API class for non-AR-backed forms. · `docs/reference/virtual_forms.md` `docs/reference/page_filters.md` `docs/design/page_filters_as_virtual_forms.md` `lib/lcp_ruby/virtual_fields/virtual_field.rb` `lib/lcp_ruby/virtual_fields/virtual_form.rb` `lib/lcp_ruby/virtual_fields/types/array_of.rb` `lib/lcp_ruby/virtual_fields/synthetic_marker.rb`
+
+## Field Types
+
+- **Array Field (Float)** — Multi-value floats (type: array, item_type: float). Cast to float on save. DSL field block. · `docs/reference/models.md#array-fields` `docs/reference/models.md#item_type` `docs/design/array_field_type.md` `lib/lcp_ruby/model_factory/array_type_applicator.rb` `lib/lcp_ruby/model_factory/array_type.rb`
+- **Array Field (Integer)** — Multi-value integers (type: array, item_type: integer). array_inclusion validates. DSL field block. · `docs/reference/models.md#array-fields` `docs/reference/models.md#item_type` `docs/design/array_field_type.md` `lib/lcp_ruby/model_factory/array_type_applicator.rb` `lib/lcp_ruby/model_factory/array_type.rb`
+- **Array Field (String)** — Multi-value strings (type: array, item_type: string). Chip input. DSL field block or models/*.yml. · `docs/reference/models.md#array-fields` `docs/reference/models.md#item_type` `docs/design/array_field_type.md` `lib/lcp_ruby/model_factory/array_type_applicator.rb` `lib/lcp_ruby/model_factory/array_type.rb`
+- **Attachment Field** — File upload (type: attachment). mode:, max_size:, content_types:, variants:. models/*.yml fields. · `docs/reference/models.md#attachment-fields` `docs/guides/attachments.md#defining-attachment-fields` `docs/guides/attachments.md#single-attachment` `docs/guides/attachments.md#multiple-attachments` `docs/guides/attachments.md#validation-options` `lib/lcp_ruby/model_factory/attachment_applicator.rb`
+- **Boolean Field** — True/false flag (type: boolean). default: true/false. models/*.yml fields section. · `docs/reference/models.md#type` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Color Type** — Hex color value (type: color). Validates #rrggbb, shows swatch preview. models/*.yml fields. · `docs/reference/types.md#built-in-types` `docs/guides/custom-types.md#example-d-hex_color-dsl` `lib/lcp_ruby/types/built_in_types.rb`
+- **Date / DateTime Field** — Calendar date or timestamp (type: date/datetime). strftime format. models/*.yml fields section. · `docs/reference/models.md#type` `docs/guides/display-types.md#date` `docs/guides/display-types.md#datetime` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Decimal / Float Field** — Decimal number (type: decimal/float). precision:, scale:. models/*.yml fields section. · `docs/reference/models.md#type` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Email Type** — Auto-validated email (type: email). Downcase+strip transform. models/*.yml fields section. · `docs/reference/types.md#built-in-types` `docs/reference/models.md#type` `lib/lcp_ruby/types/built_in_types.rb`
+- **Enum Field** — Predefined value list (type: enum). values:, default:. models/*.yml fields section. · `docs/reference/models.md#type` `docs/reference/models.md#enum_values` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Integer Field** — Whole number (type: integer). default:, min:, max:. models/*.yml fields section. · `docs/reference/models.md#type` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **JSON Field** — Arbitrary JSON data (type: json). Edited as textarea, displayed as code block. models/*.yml fields. · `docs/reference/models.md#type` `docs/reference/presenters.md#json-field-source-inline` `docs/reference/presenters.md#json-field-source-model-backed` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Phone Type** — Auto-validated phone (type: phone). normalize_phone transform. models/*.yml fields section. · `docs/reference/types.md#built-in-types` `docs/reference/models.md#type` `lib/lcp_ruby/types/built_in_types.rb`
+- **Rich Text Field** — HTML content via Action Text (type: rich_text). Trix editor in forms. models/*.yml fields section. · `docs/reference/models.md#type` `docs/guides/display-types.md#rich_text` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **String Field** — Short text (type: string). limit:, null:. models/*.yml fields section. · `docs/reference/models.md#type` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **Text Field** — Unlimited-length text (type: text). models/*.yml fields section. · `docs/reference/models.md#type` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **URL Type** — Auto-validated URL (type: url). normalize_url adds https://. models/*.yml fields section. · `docs/reference/types.md#built-in-types` `docs/reference/models.md#type` `lib/lcp_ruby/types/built_in_types.rb`
+- **UUID Field** — Unique identifier string (type: uuid). Displayed with code formatting. models/*.yml fields section. · `docs/reference/models.md#type` `lib/lcp_ruby/model_factory/schema_manager.rb`
+
+## Form
+
+- **Cascade Accessibility (a11y)** — aria-busy during AJAX rebuild, aria-live announcement on options-updated, focus restoration after Tom Select rebuild. · `docs/reference/cascading_selects.md` `docs/design/page_filters_as_virtual_forms.md#cascade-ux-accessibility` `app/assets/javascripts/lcp_ruby/controllers/cascading_selects_controller.js`
+- **Cascading Selects** — Dependent dropdowns (depends_on:). Parent change reloads child options. presenters/*.yml form field. · `docs/reference/presenters.md#how-association-selects-work` `docs/guides/selectbox.md#cascading-dependent-selects` `docs/guides/selectbox.md#two-level-cascade` `docs/guides/selectbox.md#three-level-cascade` `docs/guides/selectbox.md#depends_on-options` `lib/lcp_ruby/association_options_builder.rb`
+- **Conditional Disable (disable_when)** — Disable fields by other field values (disable_when: {field:, operator:, value:}). Native widget API. presenters/*.yml form fields. · `docs/reference/presenters.md#conditional-disabling` `docs/reference/condition-operators.md#condition-operators-reference` `docs/guides/conditional-rendering.md#disable_when-on-fields` `docs/guides/conditional-rendering.md#form-section-disable_when` `docs/design/unified_condition_operators.md#unified-condition-operators-design-document` `lib/lcp_ruby/condition_evaluator.rb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Conditional Visibility (visible_when)** — Show/hide fields by other field values (visible_when: {field:, operator:, value:}). Client-side. presenters/*.yml form fields. · `docs/reference/presenters.md#conditional-visibility` `docs/reference/condition-operators.md#condition-operators-reference` `docs/guides/conditional-rendering.md#visible_when-on-fields` `docs/guides/conditional-rendering.md#section-level-conditions` `docs/design/unified_condition_operators.md#unified-condition-operators-design-document` `lib/lcp_ruby/condition_evaluator.rb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Date Range Form Input** — input_type: date_range as general form input. Pairs <field>_from / <field>_to date pickers in a <fieldset>. · `docs/reference/forms.md` `docs/reference/page_filters.md#date-range-input_type-date_range` `docs/design/page_filters_as_virtual_forms.md` `app/helpers/lcp_ruby/form_helper.rb`
+- **Dialog Behavior — show_result** — Render a result partial after dialog form submit (one-time secret display,
+recovery codes, generated credentials). dialog_behavior show_result + result.style. _(beta)_ · `docs/reference/api-tokens.md` `docs/design/api_tokens.md` `app/controllers/concerns/lcp_ruby/dialog_rendering.rb` `app/views/lcp_ruby/dialogs/_show_secret.html.erb`
+- **Field Renderer — copy_code** — Monospace value with inline clipboard-copy button. Reusable in show layouts, dialog result partials, and index cells. _(beta)_ · `docs/reference/api-tokens.md` `docs/design/api_tokens.md` `lib/lcp_ruby/display/renderers/copy_code.rb` `app/assets/javascripts/lcp_ruby/controllers/clipboard_controller.js`
+- **Form-Level Reverse-Cascade Opt-Out** — data-lcp-reverse-cascade="off" on form. Filter forms opt out — child change does NOT auto-fill its parent. · `docs/reference/cascading_selects.md` `docs/reference/page_filters.md` `docs/design/page_filters_as_virtual_forms.md` `app/assets/javascripts/lcp_ruby/controllers/cascading_selects_controller.js`
+- **JSON Field Inline Editing** — Edit JSON fields as key-value pairs inline (type: json, input_type: json_editor). presenters/*.yml form fields. · `docs/reference/presenters.md#json-field-source-inline` `docs/guides/presenters.md#json-field-source-inline` `docs/design/inline_collection_editor.md#3-json-field-source-json_field` `docs/design/inline_collection_editor.md#3a-inline-mode-fields-declared-in-presenter` `lib/lcp_ruby/presenter/layout_builder.rb` `lib/lcp_ruby/controller/crud_helpers.rb`
+- **JSON Field Sub-Sections** — Render JSON keys as separate form sub-sections. presenters/*.yml form section type: json_section. · `docs/reference/presenters.md#sub-sections-in-nested-rows` `docs/guides/presenters.md#sub-sections-in-nested-rows` `docs/design/inline_collection_editor.md#phase-5-sub-sections-in-nested-rows` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **JSON Field with Virtual Model** — Map JSON keys to virtual model fields for typed editing. models/*.yml virtual_attributes + presenters/*.yml. · `docs/reference/presenters.md#json-field-source-model-backed` `docs/guides/presenters.md#json-field-source-model-backed` `docs/design/inline_collection_editor.md#3b-model-backed-mode-fields-from-a-virtual-model` `lib/lcp_ruby/presenter/layout_builder.rb` `lib/lcp_ruby/controller/crud_helpers.rb`
+- **Multi-Column Form Layout** — Side-by-side form fields (columns: 2/3). presenters/*.yml form section layout. · `docs/reference/presenters.md#form-section-attributes` `docs/reference/presenters.md#layout` `docs/guides/presenters.md#flat-vs-tabs-layout` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Multi-Select Cascade Activation** — render_multi_select honors depends_on (was silent no-op before PR 3). Same JS path as association_select. · `docs/reference/forms.md` `docs/reference/page_filters.md#cascading-associations-depends_on` `docs/design/page_filters_as_virtual_forms.md` `app/helpers/lcp_ruby/form_helper.rb`
+- **Nested Forms** — Inline editing of associations (type: nested, accepts_nested_attributes_for). Sortable rows. presenters/*.yml form sections. · `docs/reference/presenters.md#nested-fields` `docs/reference/presenters.md#association-source` `docs/guides/presenters.md#nested-fields` `docs/guides/presenters.md#association-source-has_many` `docs/design/inline_collection_editor.md#design-inline-collection-editor` `lib/lcp_ruby/presenter/layout_builder.rb` `lib/lcp_ruby/controller/crud_helpers.rb`
+- **Selectbox Sorting** — Sort selectbox options (sort: true/false, sort_direction:). presenters/*.yml form field. · `docs/reference/presenters.md#input-options` `docs/guides/selectbox.md#selectbox-guide` `lib/lcp_ruby/association_options_builder.rb`
+- **has_one Nested Fields in Form** — Inline has_one editing (nested_fields section). Zero or one nested record. Auto-create on save. · `docs/reference/presenters.md#nested-fields` `docs/reference/presenters.md#nested-fields-section-attributes` `docs/guides/presenters.md#nested-fields` `docs/design/inline_collection_editor.md#design-inline-collection-editor` `lib/lcp_ruby/presenter/layout_builder.rb` `lib/lcp_ruby/controller/crud_helpers.rb`
+
+## Form Submit Actions
+
+- **Confirmation Dialogs** — Pre-submit confirmation (confirm: true, confirm_message:). data-turbo-confirm or window.confirm. · `docs/guides/action-buttons.md` `docs/reference/workflow.md` `docs/guides/workflow.md#confirmation-dialogs` `docs/design/form_submit_actions.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/controller/` `lib/lcp_ruby/workflow/`
+- **Cross-Presenter Redirect** — Navigate to different presenter after save (redirect: { association: :order, action: :show }). · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **Default Form Actions (Backward Compatibility)** — Default Save + Cancel when no form actions configured. Full backward compatibility. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/`
+- **Deferred Event Dispatch** — Events deferred until after transaction commit (defer_events: true). Prevents rollback event firing. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/` `lib/lcp_ruby/events/`
+- **Dialog: Save & Close / Save & Add Another** — Dialog-specific behavior (dialog_behavior: :close/:reset/:reload). Reset clears form for next entry. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **Double-Submit Protection** — Stimulus controller disables buttons on submit (lcp-form-actions). Re-enables after response/5s timeout. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **Form Action i18n** — 4-level i18n lookup: explicit label > presenter-specific > global > humanized name fallback. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/`
+- **Multiple Submit Buttons** — Multiple form submit buttons (actions: { form: [...] }). Each sends _form_action param. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/` `lib/lcp_ruby/controller/`
+- **Overflow Dropdown** — Collapse excess buttons into More dropdown (max_inline_actions:). position: :dropdown forces dropdown. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/`
+- **Pipeline Execution** — Ordered operation list per button (pipeline: [:save, { transition: :submit }]). Single transaction. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **Redirect per Button** — Per-button redirect target (redirect: :show/:edit/:new/:index). Falls back to redirect_after. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **Role-Restricted Form Actions** — Role-based button visibility (only_roles:, except_roles:). Re-checked at submit time. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/` `lib/lcp_ruby/authorization/`
+- **Single Action Pipeline (Show Page)** — Pipeline on show page single actions. No save step. Direct transition or custom action execution. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **only_on (Create / Update)** — Restrict button to create or update context (only_on: :create/:update). Checked at render + submit. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/`
+- **set_fields (Field Injection)** — Inject field values on submit (set_fields:). Merged after user params. Same syntax as workflow. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/controller/`
+- **visible_when on Form Actions** — Conditional button visibility (visible_when:). Server-side evaluation against record state. · `docs/guides/action-buttons.md` `docs/design/form_submit_actions.md` `lib/lcp_ruby/presenter/` `lib/lcp_ruby/condition_evaluator.rb`
+
+## Grouped Query
+
+- **Grouped Query Mode (query_mode: :grouped)** — GROUP BY index mode (query_mode: :grouped, group_by:). Aggregates: count, sum, avg, min, max. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: Aggregate Functions** — SQL aggregates on columns (aggregate: :count or { function: :sum, field: :amount }). Standard renderers. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: Association Dot-Path JOINs** — Group by association field (group_by: [`category.name`]). Auto-generates LEFT JOIN. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: Date Period Grouping** — Date truncation grouping ({ field:, period: :month }). DATE_TRUNC (PG) or strftime (SQLite). · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: HAVING Conditions** — Filter groups by aggregate value (having: { count: { gt: 5 } }). SQL HAVING clause from config. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: LIMIT (Top N Groups)** — Limit grouped results (limit: N on grouped index). Top N groups by sort order. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: Multi-Column Group By** — Group by multiple fields (group_by: [:stage, :region]). Each combination = one row. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: Row Click Filter** — Click grouped row to drill-down (row_click: :filter, target:). Auto-builds Ransack filter params. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+- **Grouped Query: View Group Integration** — Grouped + flat presenters coexist in view groups. Overview (grouped) to detail (flat) drill-through. · `docs/design/grouped_query_presenter.md` `docs/reference/presenters.md` `app/helpers/lcp_ruby/grouped_query_helper.rb` `docs/design/grouped_query_presenter.md` `lib/lcp_ruby/grouped_query/`
+
+## Groups
+
+- **DB-Backed Groups (Model)** — Store groups in DB (group_source: :model). Dynamic group management via UI. Generator available. · `docs/reference/groups.md#source-model-db` `docs/reference/groups.md#model-contracts` `docs/guides/groups.md#db-backed-groups` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/model_loader.rb` `lib/lcp_ruby/groups/contract.rb` `lib/lcp_ruby/groups/contract_validator.rb`
+- **Group Cache Invalidation** — Auto-invalidate group cache on membership/role changes. Groups::Registry.invalidate!. · `docs/reference/groups.md#cache-invalidation` `docs/guides/groups.md#testing-groups` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb` `lib/lcp_ruby/groups/change_handler.rb`
+- **Group Memberships** — Assign users to groups (has_many :memberships). Membership model links users and groups. · `docs/reference/groups.md#source-model-db` `docs/reference/groups.md#membership-only-mode` `docs/guides/groups.md#step-3-membership-only-mode-default` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/model_loader.rb` `lib/generators/lcp_ruby/templates/groups/group_membership_model.rb`
+- **Group Role Mappings** — Map roles to groups (group_roles:). All group members inherit mapped roles. · `docs/reference/groups.md#role-resolution-strategy` `docs/guides/groups.md#role-resolution-strategies` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb` `lib/generators/lcp_ruby/templates/groups/group_role_mapping_model.rb`
+- **Group Source Configuration** — Set group source per-environment (config.group_source = :yaml/:model/:host). config/initializers/lcp_ruby.rb. · `docs/reference/groups.md#configuration` `docs/reference/groups.md#complexity-levels` `docs/guides/groups.md#quick-start-with-yaml-groups` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/setup.rb`
+- **Groups Generator** — Scaffold DB group models (rails g lcp_ruby:groups). Creates group, membership, and role mapping models. · `docs/reference/groups.md#source-model-db` `docs/guides/groups.md#step-1-run-the-generator` `docs/design/groups_roles_and_org_structure.md` `lib/generators/lcp_ruby/groups_generator.rb` `lib/generators/lcp_ruby/templates/groups/group_model.rb` `lib/generators/lcp_ruby/templates/groups/group_presenter.rb`
+- **Groups Overview** — Organize users into groups for shared role assignments. config/lcp_ruby/groups.yml or DB-backed. · `docs/reference/groups.md#groups-reference` `docs/guides/groups.md#groups-guide` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb` `lib/lcp_ruby/groups/setup.rb`
+- **Groups Registry API** — Query groups programmatically (Groups::Registry.for_user, .all, .find). Cached lookups. · `docs/reference/groups.md#registry-api` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb`
+- **Groups with Impersonation** — Impersonation inherits target user group roles. Groups resolved for impersonated identity. · `docs/reference/groups.md#impersonation` `docs/guides/impersonation.md#impersonation-view-as-role-x` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb` `lib/lcp_ruby/authorization/impersonated_user.rb`
+- **Host Adapter (AD/LDAP)** — Integrate external directory groups (group_source: :host). Implement Groups::HostAdapter contract. · `docs/reference/groups.md#source-host-adapter` `docs/guides/groups.md#host-adapter-for-adldap` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/host_loader.rb`
+- **Role Resolution: Direct Only** — Use only direct user roles (role_resolution: :direct_only). Ignore group roles. · `docs/reference/groups.md#role-resolution-strategy` `docs/guides/groups.md#direct-only` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb`
+- **Role Resolution: Groups Only** — Use only group-assigned roles (role_resolution: :groups_only). Ignore direct user roles. · `docs/reference/groups.md#role-resolution-strategy` `docs/guides/groups.md#groups-only` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb`
+- **Role Resolution: Merged** — Combine direct + group roles (role_resolution: :merged). Union of all role sources. Default mode. · `docs/reference/groups.md#role-resolution-strategy` `docs/guides/groups.md#merged-default` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/registry.rb`
+- **YAML Groups (Static)** — Define groups in YAML (group_source: :yaml). config/lcp_ruby/groups.yml with members and roles. · `docs/reference/groups.md#source-yaml` `docs/guides/groups.md#quick-start-with-yaml-groups` `docs/design/groups_roles_and_org_structure.md` `lib/lcp_ruby/groups/yaml_loader.rb`
+
+## Host Controller
+
+- **Concern dependency guards** — method_defined? checks at class load time. Descriptive error if concerns included in wrong order. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **Hybrid routing (static catch-all + dynamic per-presenter)** — Two routing layers: explicit slug routes for host controllers + :lcp_slug catch-all for LCP. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/routing/`
+- **LcpRuby::Controller::Authentication concern** — current_user, effective_user, authenticate_user!. Sets LcpRuby::Current.user for the request. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::Authorization concern** — Pundit-compatible authorize/policy_scope. Presenter-based policy lookup. authorize_presenter_access. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::CrudHelpers concern** — permitted_params, set_record, setup_show/index_view_objects. For rendering LCP view templates. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::ErrorHandling concern** — rescue_from for MetadataError, RecordNotFound. No dependencies. Include in any host controller. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::Impersonation concern** — Override effective_user for impersonation. Must include before Authorization in MRO. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::PathHelpers concern** — All LCP *_path helpers: resource_path, new_resource_path, edit_resource_path, etc. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::PresenterSetup concern** — Core concern: set_presenter_and_model from params[:lcp_slug]. Registers 11 LCP view helpers. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::Search concern** — Search/sort/filter pipeline. apply_advanced_search, apply_sort, apply_saved_filter. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **LcpRuby::Controller::ViewHelpers concern** — Sort, breadcrumbs, view-group helpers. current_sort_field, toggle_direction, filter_metadata. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **View instance variable contract** — Required ivars for LCP templates: @column_set, @action_set, @field_resolver, @layout_builder. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **action_controllers: per-action override** — Override specific actions only (action_controllers: { new: `wizard#new` }). Rest flows through LCP. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/` `lib/lcp_ruby/routing/`
+- **controller: + read_only + custom views (gradual adoption)** — Host controller with own ERB views (controller: + read_only: true). Gradual LCP nav integration. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+- **controller: full CRUD takeover** — Route all CRUD to host controller (controller: `checkouts`). Include LcpRuby::Controller::* concerns. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/` `lib/lcp_ruby/routing/`
+- **lcp_ruby:host_controller generator** — Generator scaffolds host controller with selected concerns. Auto-resolves dependencies, correct order. · `docs/reference/host-controller-integration.md` `docs/design/host_app_controller_integration.md` `lib/lcp_ruby/controller/`
+
+## I18n
+
+- **Automatic locale binding** — around_action chain: current_user.profile[:locale] → Accept-Language → I18n.default_locale — authenticated and anonymous pages alike. · `docs/reference/i18n.md` `docs/design/my_settings_on_user.md` `lib/lcp_ruby/controller/locale_binding.rb` `app/controllers/lcp_ruby/application_controller.rb` `app/controllers/lcp_ruby/auth/base_controller.rb`
+
+## Import
+
+- **Association Lookup** — FK lookup by attribute (e.g. Category.find_by(name:)). Direct ID or text-to-ID resolution. · `docs/reference/import.md#association-lookup` `docs/guides/import.md` `docs/design/import.md#association-resolution` `docs/design/import.md#d6-association-resolution-via-lookup-attribute` `lib/lcp_ruby/import/`
+- **CSV Import** — CSV import with auto encoding detection (BOM, UTF-8, fallback). Auto delimiter detection. · `docs/reference/import.md` `docs/guides/import.md#basic-setup` `docs/design/import.md#file-parsing` `docs/design/import.md#d4-file-format-detected-from-file-not-user-input` `lib/lcp_ruby/import/`
+- **Collection Import** — Toolbar import button with two-phase dialog. Upload + mapping. Runs as background job. · `docs/reference/import.md#presenter-configuration` `docs/guides/import.md#basic-setup` `docs/design/import.md#enabling-import-on-a-presenter` `lib/lcp_ruby/import/`
+- **Column Auto-Mapping** — Auto-match CSV headers to fields. Exact name, humanized label, underscore normalization. · `docs/reference/import.md#auto-mapping` `docs/guides/import.md` `docs/design/import.md#d12-auto-mapping-by-name-label-and-alias` `lib/lcp_ruby/import/`
+- **Duplicate Column Handling** — Duplicate CSV headers get column-index prefix (e.g. `3:Name`). Ensures unique mapping keys. · `docs/reference/import.md#column-mapping` `docs/design/import.md` `lib/lcp_ruby/import/`
+- **Import Background Job** — Import runs as background job (data_import). Progress tracking, cancellation, no auto-retry. · `docs/reference/import.md#background-execution` `docs/guides/import.md` `docs/design/import.md#importjobhandler-background-job-execution` `docs/design/import.md#d1-reuse-job_execution-not-a-separate-import_job-table` `lib/lcp_ruby/import/`
+- **Import Error Report** — Auto-generated error CSV on job_execution (result_file). Row number, status, error, original data. · `docs/reference/import.md` `docs/guides/import.md` `docs/design/import.md#d9-error-report-as-csv-attachment` `lib/lcp_ruby/import/`
+- **Import Generator** — Generator: lcp_ruby:import. Creates import_row + import_profile models. Prereq: background_jobs generator. · `docs/reference/import.md#generator` `docs/guides/import.md#basic-setup` `docs/design/import.md#generator` `lib/lcp_ruby/import/`
+- **Import Max Rows** — Safety limit (import max_rows: 5000). File parsed in phase 1, rejected before job enqueue. · `docs/reference/import.md` `docs/guides/import.md` `docs/design/import.md#i7-max-rows-check-on-xlsx-sheet-switch` `lib/lcp_ruby/import/`
+- **Import Nested Permission Filtering** — Nested import fields respect target model permissions (field_writable? on target evaluator). · `docs/reference/import.md#permission-filtering` `docs/guides/import.md#permissions` `docs/design/import.md` `lib/lcp_ruby/import/`
+- **Import Nested has_one** — Import flat CSV into parent + has_one associations. Dot-notation mapping to nested_attributes. · `docs/reference/import.md#nested-has_one-import` `docs/guides/import.md#nested-has_one-import` `docs/design/import_nested_has_one.md` `docs/design/import.md` `lib/lcp_ruby/import/`
+- **Import Per-Row Tracking** — Per-row import_row records. Status: pending/created/updated/skipped/error. source_data, target_record_id. · `docs/reference/import.md#per-row-tracking` `docs/design/import.md#import_row-per-row-tracking-generated` `docs/design/import.md#d2-import_row-as-a-dedicated-table` `lib/lcp_ruby/import/`
+- **Import Profiles** — Save column mappings + strategy (import_profile model). Visibility: personal/role/global. · `docs/reference/import.md#import-profiles` `docs/guides/import.md#saved-profiles` `docs/design/import.md#import_profile-saved-column-mappings-generated` `docs/design/import.md#d14-import_profile-follows-export_profile-pattern` `lib/lcp_ruby/import/`
+- **Import Strategies** — Four strategies: create_only, update_only, upsert, skip_existing. Match attribute for find+update. · `docs/reference/import.md#import-strategies` `docs/guides/import.md#import-strategies` `docs/design/import.md#import-strategies` `docs/design/import.md#d5-strategy-chosen-per-import-not-per-presenter` `lib/lcp_ruby/import/`
+- **Import Undo** — Undo completed imports. Created records destroyed, updated reverted via previous_values snapshot. · `docs/reference/import.md` `docs/design/import.md#undo-import` `docs/design/import.md#d11-full-undo-via-previous_values-snapshot` `lib/lcp_ruby/import/`
+- **Nested Associations Whitelist** — Control which has_one associations appear in import (nested_associations: [:profile]). · `docs/reference/import.md#nested-associations-whitelist` `docs/design/import.md` `docs/design/import_nested_has_one.md` `lib/lcp_ruby/import/`
+- **Nested Blank Strategy** — Blank value handling in nested import (nested_blank_strategy: `skip` or `null`). · `docs/reference/import.md#blank-handling` `docs/guides/import.md#nested-has_one-import` `docs/design/import_nested_has_one.md` `lib/lcp_ruby/import/`
+- **Nested Field Auto-Mapping** — Auto-map CSV headers to nested fields by suffix. Direct fields win collisions. · `docs/reference/import.md#column-mapping-format` `docs/design/import_nested_has_one.md` `lib/lcp_ruby/import/`
+- **Permission-Filtered Import** — Import respects permissions: action, strategy (create/update), field-level (writable_fields only). · `docs/reference/import.md#permissions` `docs/guides/import.md#permissions` `docs/design/import.md#permission-integration` `lib/lcp_ruby/import/`
+- **Two-Phase Import Dialog** — Phase 1: upload + strategy. Phase 2: column mapping. Result.continue for multi-step dialog flow. · `docs/reference/import.md` `docs/guides/import.md` `docs/design/import.md#import-dialog` `docs/design/import.md#d3-two-phase-dialog-with-resultcontinue` `lib/lcp_ruby/import/`
+- **Type Coercion** — String-to-type coercion pipeline. Configurable date/boolean/decimal parsing. Enum label reverse lookup. · `docs/reference/import.md#type-coercion` `docs/guides/import.md#type-coercion` `docs/design/import.md#type-coercion-and-value-parsing` `lib/lcp_ruby/import/`
+- **Upsert with Nested Records** — Upsert strategy with nested has_one: find parent, update/create nested. update_only: true preserves IDs. · `docs/reference/import.md#upsert-behavior` `docs/guides/import.md#nested-has_one-import` `docs/design/import_nested_has_one.md` `docs/design/import.md` `lib/lcp_ruby/import/`
+- **XLSX Import** — Excel import via roo gem. Multi-sheet support, sheet selector in mapping phase. · `docs/reference/import.md` `docs/guides/import.md` `docs/design/import.md#d10-xlsx-reading-via-roo-gem-optional-dependency` `lib/lcp_ruby/import/`
+
+## Input Types
+
+- **Array Input** — Tag chip input (input_type: array_input). suggestions:, max:, placeholder:. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/design/array_field_type.md#10-form-input--array_input` `docs/design/array_field_type.md` `app/helpers/lcp_ruby/form_helper.rb`
+- **Number Input with Prefix/Suffix** — Number field with addon (input_type: number). prefix:, suffix: for units. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/reference/presenters.md#input-options` `app/helpers/lcp_ruby/form_helper.rb`
+- **Radio Group Input** — Horizontal radio buttons (input_type: radio_group). Best for 2-5 enum options. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/guides/presenters.md#input-types` `app/helpers/lcp_ruby/form_helper.rb`
+- **Rich Text Editor Input** — WYSIWYG Trix editor (input_type: rich_text_editor). For rich_text fields. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/guides/presenters.md#input-types` `app/helpers/lcp_ruby/form_helper.rb`
+- **Select Input** — Standard HTML dropdown (input_type: select). Auto-populated for enums. presenters/*.yml form fields. · `docs/reference/presenters.md#input-types` `docs/reference/presenters.md#input-options` `docs/guides/presenters.md#input-types` `docs/guides/selectbox.md#association-select` `app/helpers/lcp_ruby/form_helper.rb`
+- **Slider Input** — Range slider (input_type: slider). min:, max:, step: via input_options. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/guides/presenters.md#input-types` `app/helpers/lcp_ruby/form_helper.rb`
+- **Textarea Input** — Multi-line text box (input_type: textarea). rows:, hint:, char_counter:. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/guides/presenters.md#input-types` `app/helpers/lcp_ruby/form_helper.rb`
+- **Toggle Input** — iOS-style boolean switch (input_type: toggle). presenters/*.yml form field input_type. · `docs/reference/presenters.md#input-types` `docs/guides/presenters.md#input-types` `app/helpers/lcp_ruby/form_helper.rb`
+- **Tom Select (Enhanced Select)** — Searchable dropdown (input_type: association_select/multi_select). search:, allow_create:. presenters/*.yml. · `docs/reference/presenters.md#input-types` `docs/reference/presenters.md#how-association-selects-work` `docs/guides/selectbox.md#remote-search` `docs/guides/selectbox.md#inline-create` `docs/guides/selectbox.md#multi-select` `app/helpers/lcp_ruby/form_helper.rb`
+- **Tree Select Input** — Hierarchical dropdown (input_type: tree_select). For parent-child associations. presenters/*.yml form. · `docs/reference/presenters.md#input-types` `docs/guides/selectbox.md#tree-select` `docs/design/tree_structures.md` `app/helpers/lcp_ruby/form_helper.rb`
+
+## Master Detail
+
+- **Master-Detail Split View** — Selection-driven split view (selection: single). Sidebar master list, main+tabs detail. record_source: selection. · `docs/reference/pages.md#master-detail-pages` `docs/guides/composite-pages.md#master-detail-pages` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/resolver.rb`
+
+## Model Features
+
+- **Array Condition Operators** — Array-aware visible_when/disable_when operators: contains, any_of, empty. presenters/*.yml conditions. · `docs/reference/models.md#array-fields` `lib/lcp_ruby/model_factory/array_type_applicator.rb`
+- **Array Query Scopes** — Auto-generated with_<field>/with_any_<field> scopes for array fields. type: array in models/*.yml or DSL. · `docs/reference/models.md#array-fields` `docs/reference/model-dsl.md#array-fields` `lib/lcp_ruby/model_factory/array_type_applicator.rb` `lib/lcp_ruby/model_factory/scope_applicator.rb`
+- **Array Validations** — Array-specific validations (array_length, array_inclusion, array_uniqueness). validates: on array fields. models/*.rb. · `docs/reference/models.md#array_length` `docs/reference/models.md#array_inclusion` `docs/reference/models.md#array_uniqueness` `docs/reference/model-dsl.md#array_length` `lib/lcp_ruby/model_factory/validation_applicator.rb` `lib/lcp_ruby/model_factory/array_type_applicator.rb`
+- **Associations** — AR associations (belongs_to, has_many, has_many :through). associations: key. models/*.yml or DSL. · `docs/reference/models.md#associations` `docs/reference/model-dsl.md#associations` `lib/lcp_ruby/model_factory/association_applicator.rb`
+- **Computed Fields** — Read-only fields computed by Ruby service class on save. computed: { service: ClassName }. models/*.yml. · `docs/reference/models.md#computed` `docs/guides/computed-fields.md#computed-fields-guide` `docs/reference/model-dsl.md#examples` `lib/lcp_ruby/model_factory/computed_applicator.rb`
+- **Custom Types** — Reusable field types with base_type + validations + transforms. config/lcp_ruby/types/*.yml. · `docs/reference/models.md#type` `docs/reference/model-dsl.md#business-types` `lib/lcp_ruby/types/type_registry.rb` `lib/lcp_ruby/types/built_in_types.rb`
+- **Default Values** — Static or service-computed field defaults. default: key (literal or service: class). models/*.yml. · `docs/reference/models.md#default` `docs/reference/model-dsl.md#boolean-with-default` `lib/lcp_ruby/model_factory/default_applicator.rb`
+- **Nested has_one Boolean Shorthand** — nested_attributes: true shorthand on has_one. Defaults: reject_if: :all_blank, update_only: true. · `docs/reference/models.md#boolean-shorthand` `docs/reference/models.md#nested-attributes` `lib/lcp_ruby/model_factory/association_applicator.rb`
+- **Scopes** — Named query scopes via where/where_not/order/limit. scopes: key in model definition. models/*.yml. · `docs/reference/models.md#scopes` `docs/reference/model-dsl.md#scopes` `lib/lcp_ruby/model_factory/scope_applicator.rb`
+- **Timestamps** — Auto-managed created_at/updated_at columns. timestamps: true in model options. models/*.yml or DSL. · `docs/reference/models.md#timestamps` `docs/reference/model-dsl.md#timestamps` `lib/lcp_ruby/model_factory/builder.rb`
+- **Transforms** — Auto value transforms on save (strip, downcase, parameterize). transforms: key on fields. models/*.yml. · `docs/reference/models.md#transforms` `docs/reference/model-dsl.md#examples` `lib/lcp_ruby/model_factory/transform_applicator.rb`
+- **Validations** — Declarative field validations (presence, uniqueness, format, length). validations: key. models/*.yml. · `docs/reference/models.md#validations` `docs/reference/model-dsl.md#validations` `lib/lcp_ruby/model_factory/validation_applicator.rb`
+
+## Model Inheritance
+
+- **Abstract + STI Combined Chain** — STI parent can inherit from abstract model. Three-level chain: abstract -> STI parent -> children. · `docs/reference/models.md#chaining-with-abstract-inheritance` `docs/design/model_inheritance.md#3-impact-on-other-subsystems` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **Abstract Base Model** — Abstract parent model (abstract: true). No table/AR class. Prefix with underscore. models/*.rb or *.yml. · `docs/reference/models.md#abstract` `docs/reference/model-dsl.md#abstract` `docs/design/model_inheritance.md#1-abstract-base-models` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **Additive Validation Inheritance** — Parent validations always concatenated with child (no override). validates: is additive across inherits:. · `docs/reference/models.md#validations` `docs/design/model_inheritance.md#4-validation-rules` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb` `lib/lcp_ruby/model_factory/validation_applicator.rb`
+- **Chained Inheritance (3 levels)** — Multi-level abstract inheritance resolved by topological sort. inherits: chains. models/*.rb or *.yml. · `docs/reference/models.md#inherits` `docs/design/model_inheritance.md#example-3-chained-abstract-inheritance` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **Field Override in Child** — Child redefines parent field by same name (full replacement). field :name in child model. models/*.rb. · `docs/reference/models.md#inherits` `docs/design/model_inheritance.md#1-abstract-base-models` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **Multiple Children from Same Parent** — One abstract model inherited by many concrete children independently. inherits: key. models/*.rb. · `docs/reference/models.md#abstract` `docs/design/model_inheritance.md#example-1-shared-address-block` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **Option Inheritance (Deep Merge)** — Model options (timestamps, userstamps, etc.) deep-merged from parent. Override individual opts in child. · `docs/reference/models.md#inherits` `docs/design/model_inheritance.md#1-abstract-base-models` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **STI Automatic Type Scoping** — Rails auto WHERE type = class. Parent.all returns all types. Child.all returns only that type. · `docs/reference/models.md#single-table-inheritance-sti` `docs/reference/models.md#how-it-works` `docs/design/model_inheritance.md#2-single-table-inheritance-sti` `lib/lcp_ruby/model_factory/builder.rb`
+- **STI Child Model** — STI child model (inherits: :parent). No own table. Child-specific columns added to parent table. · `docs/reference/models.md#single-table-inheritance-sti` `docs/reference/models.md#enabling-sti` `docs/design/model_inheritance.md#2-single-table-inheritance-sti` `lib/lcp_ruby/model_factory/builder.rb` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **STI Parent Model (options.sti: true)** — Single Table Inheritance (options.sti: true). Adds type column. Children share parent table. · `docs/reference/models.md#sti` `docs/reference/models.md#enabling-sti` `docs/design/model_inheritance.md#2-single-table-inheritance-sti` `lib/lcp_ruby/model_factory/builder.rb`
+- **STI Permission Fallback** — STI children inherit parent permissions. Lookup chain: child -> parent -> _default. · `docs/reference/models.md#permission-fallback` `docs/design/model_inheritance.md#3-impact-on-other-subsystems` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **STI Shared Table** — All STI children share parent table. SchemaManager#add_sti_child_columns! adds nullable columns. · `docs/reference/models.md#single-table-inheritance-sti` `docs/reference/models.md#restrictions` `docs/design/model_inheritance.md#2-single-table-inheritance-sti` `lib/lcp_ruby/model_factory/schema_manager.rb`
+- **STI Validation Rules** — Boot-time validation: no table_name on children, no nested STI, no non-abstract/non-STI inherits. · `docs/reference/models.md#validations` `docs/design/model_inheritance.md#4-validation-rules` `lib/lcp_ruby/model_factory/validation_applicator.rb`
+- **Scope Inheritance** — Scopes from abstract parents inherited by children. Override by same name. scope: in models/*.rb or *.yml. · `docs/reference/models.md#scopes` `docs/reference/models.md#inherits` `docs/design/model_inheritance.md#1-abstract-base-models` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb` `lib/lcp_ruby/model_factory/scope_applicator.rb`
+- **Separate Presenters per STI Variant** — Each STI variant gets own presenter with unique slug, columns, form layout. Parent shows all types. · `docs/reference/models.md#single-table-inheritance-sti` `docs/reference/presenters.md#model` `docs/design/model_inheritance.md#3-impact-on-other-subsystems` `lib/lcp_ruby/metadata/presenter_definition.rb`
+- **Simple Inheritance (inherits:)** — Pull parent fields/validations/scopes into child. inherits: :_parent_name in define_model. models/*.rb. · `docs/reference/models.md#inherits` `docs/reference/model-dsl.md#inherits-keyword-argument` `docs/design/model_inheritance.md#1-abstract-base-models` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb`
+- **YAML Format Inheritance** — Inheritance works in YAML and DSL interchangeably. inherits: key in models/*.yml. Can cross formats. · `docs/reference/models.md#inherits` `docs/reference/models.md#abstract` `docs/design/model_inheritance.md#1-abstract-base-models` `lib/lcp_ruby/metadata/model_inheritance_resolver.rb` `lib/lcp_ruby/metadata/loader.rb`
+
+## Monitoring
+
+- **ActiveSupport::Notifications Events** — Instrumented events: request/error/cache/workflow_transition/boot/reload .lcp_ruby. Custom subscriptions. · `docs/reference/monitoring.md#asnotifications-events` `docs/guides/monitoring.md` `docs/design/monitoring.md#layer-1-activesupportnotifications-instrumentation` `lib/lcp_ruby/metrics/`
+- **Authorization Invariant Validator** — Boot-time check that permission YAML references runtime concepts (custom scope methods, columns, parent permissions) that actually exist. AUTH-001..009 codes; dev/test raises, prod records via record_error. · `docs/reference/invariant_check.md` `docs/design/authorization_hardening.md` `lib/lcp_ruby/authorization/runtime_invariant_validator.rb` `lib/lcp_ruby/authorization/invariant_check/configuration.rb` `lib/tasks/lcp_ruby_invariant_check.rake`
+- **Custom Metric Collectors** — Host app collectors (app/lcp_metrics/). DSL: gauge/counter/histogram. cache_ttl, subscribe events. · `docs/reference/monitoring.md#custom-collectors` `docs/guides/monitoring.md#custom-collectors` `docs/design/monitoring.md#host-app-custom-metrics` `docs/design/monitoring.md#auto-discovered-collectors` `lib/lcp_ruby/metrics/`
+- **Error Fingerprinting & Deduplication** — SHA256 fingerprint (class + message + frame). Normalized IDs/UUIDs. Atomic upsert on occurrence. · `docs/reference/monitoring.md#fingerprint-algorithm` `docs/design/monitoring.md#error-log` `lib/lcp_ruby/metrics/`
+- **Error Log (Model + Presenter)** — Fingerprint-based error log (lcp_error_log). Dedup by SHA256. Generator: lcp_ruby:monitoring. · `docs/reference/monitoring.md#error-log-model` `docs/guides/monitoring.md#error-log` `docs/design/monitoring.md#error-log` `docs/design/monitoring.md#model` `lib/lcp_ruby/metrics/`
+- **Error Log Cleanup (Data Retention)** — cleanup_before scope for data retention. Combine with background jobs for automated daily cleanup. · `docs/reference/monitoring.md` `docs/guides/monitoring.md#cleanup` `docs/design/monitoring.md#cleanup` `lib/lcp_ruby/metrics/`
+- **Error Rate Limiting** — In-memory rate limiter per fingerprint (error_log_rate_limit: 1s). Batched flush. 10K entry cap. · `docs/reference/monitoring.md#rate-limiting` `docs/design/monitoring.md#rate-limiting-write-pressure-protection` `lib/lcp_ruby/metrics/`
+- **Health Check Endpoint** — Built-in /lcp_health JSON endpoint. DB + boot checks. 200/503. Unauthenticated for K8s probes. · `docs/reference/monitoring.md#health-check` `docs/guides/monitoring.md#health-check` `docs/design/monitoring.md#layer-3-health-check-endpoint` `docs/design/monitoring.md#health-check-response` `lib/lcp_ruby/metrics/`
+- **Monitoring Dashboard (Page)** — Dashboard page (/monitoring). KPI cards from Prometheus metrics + recent errors list widget. · `docs/reference/monitoring.md` `docs/guides/monitoring.md#monitoring-dashboard` `docs/design/monitoring.md#monitoring-dashboard` `docs/design/monitoring.md#layer-5-dashboard-visualization` `lib/lcp_ruby/metrics/` `lib/lcp_ruby/pages/`
+- **Monitoring Generator** — Single generator (lcp_ruby:monitoring). Creates error log model, presenter, permissions, dashboard page. · `docs/reference/monitoring.md#generator` `docs/design/monitoring.md#generator-output` `lib/lcp_ruby/metrics/`
+- **Prometheus Metrics Endpoint** — /metrics endpoint in Prometheus format. Requires prometheus-client gem. 9 built-in metrics. · `docs/reference/monitoring.md#prometheus-metrics` `docs/guides/monitoring.md#prometheus-grafana` `docs/design/monitoring.md#prometheus-metrics` `docs/design/monitoring.md#layer-2-prometheus-metrics-collection` `lib/lcp_ruby/metrics/`
+- **Verify Authorized Framework Guarantee** — after_action :verify_authorized on ResourcesController. Future contributor forgets authorize → 500 in dev/test (Pundit::AuthorizationNotPerformedError). Skips 4xx/5xx + Devise. · `docs/design/authorization_hardening.md` `docs/design/authorization_hardening.md` `lib/lcp_ruby/authorized_controller.rb` `lib/lcp_ruby/controller/authorization.rb`
+
+## Navigation
+
+- **Bare Widget Items (widget:)** — `widget: true` drops the `<a>`/`<button_to>` wrapper entirely so the `render:` partial can emit interactive HTML — search inputs, theme pickers, etc. · `docs/reference/menu.md#custom-renderers` `docs/design/user-menu.md` `app/views/lcp_ruby/navigation/_widget_item.html.erb` `lib/lcp_ruby/metadata/menu_item.rb`
+- **Breadcrumb Navigation** — Hierarchical path for parent-child models. breadcrumb.relation: in view group YAML. views/*.yml. · `docs/guides/menu.md#menu-guide` `docs/reference/menu.md#menu-reference` `app/views/lcp_ruby/shared/_breadcrumbs.html.erb` `lib/lcp_ruby/controller/view_helpers.rb`
+- **Bundled Lucide icon library** — Lucide ships in the engine layout and replaces every <i data-lucide="…"> placeholder with an inline SVG, on full-page loads and Turbo navigations. · `docs/reference/engine-configuration.md#bundled-front-end-assets` `docs/reference/menu.md#icon-only-items` `vendor/assets/javascripts/lcp_ruby/lucide.min.js` `app/assets/javascripts/lcp_ruby/lucide_init.js` `app/views/layouts/lcp_ruby/application.html.erb` `app/helpers/lcp_ruby/layout_helper.rb`
+- **Computed Menu Items (provider: / panel_provider:)** — Compute menu items at render time from a registered Ruby class — "Current organization", multi-tenant switchers, "recently visited", DB-backed lists. · `docs/reference/menu.md#computed-items-provider` `docs/design/user-menu.md` `examples/showcase/app/lcp_services/menu_items/recent_announcements.rb` `app/helpers/lcp_ruby/layout_helper.rb` `lib/lcp_ruby/services/registry.rb`
+- **Custom Panel Renderer (render_panel:)** — A partial owns the inner HTML of a `:group`'s dropdown panel — for profile-card headers, tenant switchers, custom dropdown layouts. · `docs/reference/menu.md#custom-renderers` `docs/design/user-menu.md` `app/views/lcp_ruby/menu_renderers/_user_menu_panel.html.erb` `app/views/lcp_ruby/navigation/_panel_item.html.erb`
+- **Custom Trigger Renderer (render:)** — A partial owns the inner HTML of a menu item's link/button — for items where `<icon> <label>` doesn't fit (avatar+name+caret, search input, …). · `docs/reference/menu.md#custom-renderers` `docs/design/user-menu.md` `app/views/lcp_ruby/menu_renderers/_user_menu.html.erb` `lib/lcp_ruby/metadata/menu_item.rb`
+- **Dropdown Menu** — Top nav with dropdowns. menu.yml top_menu: with children: arrays. Supports icons, separators. · `docs/guides/menu.md#step-2-add-dropdown-grouping` `docs/reference/menu.md#group-dropdown-collapsible-section` `lib/lcp_ruby/metadata/menu_definition.rb` `lib/lcp_ruby/metadata/menu_item.rb` `app/views/lcp_ruby/navigation/_top.html.erb`
+- **Field Anchors** — Deep links to show-page fields via #field-{name} URL hash. Auto-generated id attributes. · `docs/guides/menu.md#menu-guide` `lib/lcp_ruby/controller/view_helpers.rb`
+- **Icon-Only Menu Items** — Render menu items with only an icon (no visible label). Notifications bell, help link, compact secondary entries — with screen-reader-friendly aria_label. · `docs/reference/menu.md#icon-only-items` `docs/design/menu_icon_only_items.md` `lib/lcp_ruby/metadata/menu_item.rb` `app/views/lcp_ruby/navigation/_item_content.html.erb` `app/helpers/lcp_ruby/layout_helper.rb`
+- **Menu HTTP Method Override (button_to)** — `method:` on a menu item dispatches to `button_to` (with CSRF + form-wrapping) instead of `<a href>` — for sign-out, custom actions, anything non-GET. · `docs/reference/menu.md#method-aware-rendering` `docs/design/user-menu.md` `app/views/lcp_ruby/navigation/_link_or_button.html.erb` `lib/lcp_ruby/metadata/menu_item.rb`
+- **Menu Item Disabled State (disable_when)** — Render a menu item visible but in a disabled (greyed-out, non-clickable) state when a condition is true. Mirror of visible_when. · `docs/reference/menu.md#disabled-state` `docs/design/user-menu.md` `lib/lcp_ruby/metadata/menu_item.rb` `app/views/lcp_ruby/navigation/_link_or_button.html.erb` `app/assets/javascripts/lcp_ruby/controllers/menu_controller.js`
+- **Mobile Header (sidebar-only off-canvas trigger)** — Thin sticky header strip with hamburger button. Auto-rendered in sidebar-only layouts when below_breakpoint: off_canvas is active — provides a way to open the drawer when no top_menu exists to host an auto-injected sidebar_toggle. · `docs/reference/menu.md#mobile-header-sidebar-only-layouts` `docs/design/responsive-menu.md#101-mobile_headerhtmlerb--sidebar-only-off-canvas-trigger` `docs/design/responsive-menu.md` `app/views/lcp_ruby/navigation/_mobile_header.html.erb` `app/assets/javascripts/lcp_ruby/controllers/sidebar_toggle_controller.js` `app/assets/javascripts/lcp_ruby/controllers/responsive_sidebar_controller.js` `app/views/layouts/lcp_ruby/application.html.erb`
+- **Nested Menu Dropdowns** — Sub-groups inside dropdowns/sidebar. Max 2 levels of children: nesting. Flyout submenus. · `docs/guides/menu.md#organizing-large-dropdowns-with-sub-groups` `docs/reference/menu.md#nested-sub-groups` `lib/lcp_ruby/metadata/menu_definition.rb` `lib/lcp_ruby/metadata/menu_item.rb`
+- **Path Templating in Menu YAML** — `{namespace.member}` tokens in `url:` / `label:` / `aria_label:` / `defaults:` resolve at render time. Three closed-whitelist namespaces. · `docs/reference/menu.md#path-templating` `docs/design/user-menu.md#path-templating` `lib/lcp_ruby/metadata/path_template.rb` `app/helpers/lcp_ruby/layout_helper.rb`
+- **Per-Item Responsive Keys (priority / pin / hide_below / show_below)** — Per-item knobs for the responsive top nav. responsive_priority orders overflow collapse; pin: always anchors an item; hide_below / show_below toggle visibility at viewport thresholds; collapse_label_below drops the label on rails. · `docs/reference/menu.md#per-item-responsive-keys` `docs/design/responsive-menu.md` `docs/design/responsive-menu.md` `lib/lcp_ruby/metadata/menu_item.rb` `lib/lcp_ruby/metadata/configuration_validator.rb` `app/helpers/lcp_ruby/layout_helper.rb` `app/views/lcp_ruby/navigation/_top_item.html.erb`
+- **Presenter Resolver in Menu (slug-rename-resilient)** — `presenter: + alias: + action:` resolves a menu URL via the presenter's record_alias and action contract — survives slug renames. · `docs/reference/menu.md#presenter-resolver` `docs/design/user-menu.md` `lib/lcp_ruby/metadata/menu_item_resolver.rb` `lib/lcp_ruby/metadata/menu_item.rb`
+- **Rail-Collapsed Sidebar Flyout** — In collapsed-rail mode, clicking a group icon opens its children as an absolute-positioned flyout panel to the right of the rail. ESC and outside-click close. · `docs/reference/menu.md#rail-collapsed-flyouts` `docs/design/responsive-menu.md#102-rail-collapsed-group-flyout` `docs/design/responsive-menu.md` `app/assets/javascripts/lcp_ruby/controllers/sidebar_controller.js` `app/assets/stylesheets/lcp_ruby/application.css`
+- **Responsive Sidebar (rail + off-canvas + cookie persistence)** — Two sidebar modes: rail (collapse to icon-only above breakpoint) and off_canvas (slide-in drawer below breakpoint). Rail state persists via a server-readable cookie for FOUC-free SSR. · `docs/reference/menu.md#sidebar-modes` `docs/design/responsive-menu.md` `docs/design/responsive-menu.md` `lib/lcp_ruby/metadata/responsive_policy.rb` `app/assets/javascripts/lcp_ruby/controllers/sidebar_controller.js` `app/assets/javascripts/lcp_ruby/controllers/responsive_sidebar_controller.js` `app/helpers/lcp_ruby/layout_helper.rb` `app/views/lcp_ruby/navigation/_sidebar.html.erb`
+- **Responsive Top-Nav Modes (none / wrap / overflow_more / hamburger)** — Four modes for how the top nav adapts below a breakpoint. Default overflow_more @ 768px collapses items that don't fit into a *More* dropdown. hamburger mode hides the whole nav behind a drawer. · `docs/reference/menu.md#top-nav-modes` `docs/design/responsive-menu.md` `docs/design/responsive-menu.md` `lib/lcp_ruby/metadata/responsive_policy.rb` `lib/lcp_ruby/metadata/menu_definition.rb` `lib/lcp_ruby/schemas/menu.json` `app/assets/javascripts/lcp_ruby/controllers/responsive_top_nav_controller.js` `app/views/lcp_ruby/navigation/_top.html.erb`
+- **Right-aligned Top Menu Items** — Declarative right alignment in top_menu via position: right. Complement to sidebar position: bottom. · `docs/guides/menu.md#right-aligned-top-bar-items` `docs/reference/menu.md#position` `docs/design/menu_position_right.md` `lib/lcp_ruby/metadata/menu_item.rb` `app/views/lcp_ruby/navigation/_top.html.erb` `app/views/lcp_ruby/navigation/_top_item.html.erb` `app/helpers/lcp_ruby/layout_helper.rb`
+- **Sidebar Navigation** — Collapsible sidebar groups. menu.yml sidebar_menu:. position: bottom for pinned items. · `docs/guides/menu.md#step-4-switch-to-sidebar` `docs/guides/menu.md#step-5-combined-layout` `docs/reference/menu.md#menu-reference` `lib/lcp_ruby/metadata/menu_definition.rb` `app/views/lcp_ruby/navigation/_sidebar.html.erb` `app/views/lcp_ruby/navigation/_sidebar_item.html.erb` `app/views/lcp_ruby/navigation/_both_sidebar.html.erb`
+- **Sidebar Toggle Marker (sidebar_toggle: true + auto-inject)** — A platform-owned menu item that opens the sidebar off-canvas drawer. Auto-injected into top_menu when below_breakpoint: off_canvas is active, unless explicit one is authored or auto_inject_toggle: false. · `docs/reference/menu.md#sidebar_toggle-marker` `docs/design/responsive-menu.md` `docs/design/responsive-menu.md` `lib/lcp_ruby/metadata/menu_item.rb` `app/helpers/lcp_ruby/layout_helper.rb` `app/views/lcp_ruby/navigation/_sidebar_toggle.html.erb` `app/views/lcp_ruby/navigation/_top_item.html.erb`
+- **Touch-Friendly Dropdowns (lcp-dropdown primitive)** — Top-nav dropdowns open on click/tap/keyboard, not just hover. ESC closes, outside-click closes, ArrowDown opens + focuses first item. Hover still works on real mouse (guarded by @media (hover: hover)). · `docs/design/responsive-menu.md` `docs/design/responsive-menu.md` `app/assets/javascripts/lcp_ruby/controllers/dropdown_controller.js` `app/assets/javascripts/lcp_ruby/controllers/submenu_controller.js` `app/views/lcp_ruby/navigation/_top_item.html.erb`
+
+## Page Source
+
+- **DB-Stored Page Definitions** — Runtime page creation (page_source: :model). DB pages override YAML/auto pages. Deactivation fallback. · `docs/reference/pages.md` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/`
+- **Page Cache Invalidation** — Auto-clear page cache on save (after_commit). Pages::Registry.reload! + Resolver.clear!. · `docs/reference/pages.md` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/`
+- **Page Config Model Contract** — Required contract: name (unique), definition (json), active (boolean). Generator: lcp_ruby:pages. · `docs/reference/pages.md` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/`
+- **Page Definition Validation** — JSON validation on save: must have name, non-empty zones. Parsed through PageDefinition.from_hash. · `docs/reference/pages.md` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **Page Override Priority** — Priority order: DB pages > YAML pages > auto-generated. Deactivating DB page falls back to YAML/auto. · `docs/reference/pages.md` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/pages/`
+
+## Pagination Footer
+
+- **First/Last Page Links (pagination_ends)** — Show/hide First/Last links (pagination_ends true). Global config or per-presenter. CSS-driven visibility. · `docs/reference/presenters.md` `docs/design/pagination_footer.md` `docs/guides/presenters.md` `docs/design/pagination_footer.md#footer-bar-layout` `app/views/lcp_ruby/slots/index/_pagination_footer.html.erb`
+- **Grouped Layout Record Count** — Shows `N groups` instead of `N records` for query_mode: :grouped. Separate i18n keys for grouped counts. · `docs/reference/presenters.md` `docs/design/pagination_footer.md` `docs/guides/presenters.md` `docs/design/pagination_footer.md#behavior-per-layout` `app/views/lcp_ruby/slots/index/_pagination_footer.html.erb`
+- **Pagination Footer Bar** — Unified footer bar: per-page selector + record count + Kaminari links. per_page:, per_page_options:, show_record_count:. · `docs/reference/presenters.md` `docs/design/pagination_footer.md` `docs/guides/presenters.md` `docs/design/pagination_footer.md#feature-specification-pagination-footer` `app/views/lcp_ruby/slots/index/_pagination_footer.html.erb`
+- **Pagination Styling** — Kaminari pagination CSS under .lcp-pagination-footer. Current page highlighted, hover states, consistent spacing. · `docs/reference/presenters.md` `docs/design/pagination_footer.md` `docs/guides/presenters.md` `docs/design/pagination_footer.md#pagination-styling` `app/views/lcp_ruby/slots/index/_pagination_footer.html.erb`
+- **Record Count (show_record_count)** — Record count text in footer (show_record_count true|false). Adapts to layout: range for paged, total for tree. · `docs/reference/presenters.md` `docs/design/pagination_footer.md` `docs/guides/presenters.md` `docs/design/pagination_footer.md#record-count-text` `app/views/lcp_ruby/slots/index/_pagination_footer.html.erb`
+- **Tree Layout Record Count** — Tree views show total count only, no page links or per-page selector. All records loaded without Kaminari. · `docs/reference/presenters.md` `docs/design/pagination_footer.md` `docs/guides/presenters.md` `docs/design/pagination_footer.md#behavior-per-layout` `app/views/lcp_ruby/slots/index/_pagination_footer.html.erb`
+
+## Permission Source
+
+- **DB-Backed Permission Source** — Store permissions in DB (config.permission_source = :model). Runtime permission editing via UI. · `docs/reference/permission-source.md#permission-source-reference` `docs/reference/permission-source.md#configuration` `docs/guides/permission-source.md#quick-start` `lib/lcp_ruby/permissions/source_resolver.rb` `lib/lcp_ruby/permissions/registry.rb` `lib/lcp_ruby/permissions/setup.rb`
+- **Permission Definition Contract** — Required interface for permission models (resource, role, rules). Permissions::Contract validates. · `docs/reference/permission-source.md#model-contract` `docs/reference/permission-source.md#json-definition-structure` `docs/guides/permission-source.md#json-definition-format` `lib/lcp_ruby/permissions/contract_validator.rb`
+- **Permission Definition Validator** — Validates permission definitions at load time. Checks field names, operators, value types. · `docs/reference/permission-source.md#definition-validation` `docs/guides/permission-source.md#troubleshooting` `lib/lcp_ruby/permissions/definition_validator.rb` `lib/lcp_ruby/permissions/contract_validator.rb`
+- **Permission Registry & Caching** — In-memory permission cache (Permissions::Registry.all, .for_role). Auto-invalidates on DB change. · `docs/reference/permission-source.md#registry-api` `docs/reference/permission-source.md#cache-invalidation` `lib/lcp_ruby/permissions/registry.rb` `lib/lcp_ruby/permissions/change_handler.rb`
+- **Permission Source Generator** — Scaffold DB permission model (rails g lcp_ruby:permission_source). Creates migration, model, YAML. · `docs/reference/permission-source.md#generator` `docs/guides/permission-source.md#step-1-generate-permission-config-metadata` `lib/generators/lcp_ruby/permission_source_generator.rb` `lib/generators/lcp_ruby/templates/permission_source/model.rb` `lib/generators/lcp_ruby/templates/permission_source/presenter.rb`
+- **Source Resolution Priority** — Merge order for multi-source permissions (YAML < DB < host). config.permission_source_priority. · `docs/reference/permission-source.md#source-priority` `docs/guides/permission-source.md#mixing-yaml-and-db-permissions` `lib/lcp_ruby/permissions/source_resolver.rb`
+
+## Permissions
+
+- **Collection Conditions (has_many Quantifiers)** — Quantify over has_many (quantifier: any/all/none, conditions:). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#collection-conditions` `docs/guides/conditional-rendering.md#collection-conditions` `docs/design/advanced_conditions.md#4-collection-conditions-has_many-quantifiers` `docs/design/unified_condition_operators.md#collection-conditions-has_many-quantifiers` `lib/lcp_ruby/condition_evaluator.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **Compound Conditions (all / any / not)** — Combine permission conditions with boolean logic (all:, any:, not:). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#compound-conditions` `docs/guides/conditional-rendering.md#compound-conditions` `docs/design/advanced_conditions.md#1-compound-conditions-all-any-not` `docs/design/unified_condition_operators.md#compound-conditions-allanynot` `lib/lcp_ruby/condition_evaluator.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **Compound Record Rules** — Nest all:/any:/not: inside record_rules for complex boolean logic. permissions/*.yml record_rules. · `docs/reference/permissions.md#record-rules` `docs/reference/condition-operators.md#compound-conditions` `docs/guides/conditional-rendering.md#action-conditions` `docs/design/advanced_conditions.md#complex-record-rule-with-compound-conditions` `docs/design/record_rules_action_visibility.md#record-rules-action-visibility-design-document` `lib/lcp_ruby/authorization/permission_evaluator.rb` `lib/lcp_ruby/condition_evaluator.rb`
+- **Dot-Path Fields in Conditions** — Traverse associations in conditions (field: `project.owner.email`). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#dot-path-fields` `docs/guides/conditional-rendering.md#dot-path-fields` `docs/design/advanced_conditions.md#3-dot-path-fields-in-conditions` `docs/design/unified_condition_operators.md#dot-path-fields-in-conditions-and-eager-loading` `lib/lcp_ruby/condition_evaluator.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **Dynamic Value References (current_user.<method>)** — Reference current user attrs in conditions (value: current_user.email). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#current_user-attribute-of-the-authenticated-user` `docs/guides/conditional-rendering.md#current_user-attribute-of-the-authenticated-user` `docs/design/advanced_conditions.md#2-dynamic-value-references` `docs/design/unified_condition_operators.md#dynamic-value-references` `lib/lcp_ruby/condition_evaluator.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **Dynamic Value References (date)** — Date-relative conditions (value: current_date or current_datetime). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#date-dynamic-datetime` `docs/guides/conditional-rendering.md#date-dynamic-datetime` `docs/design/advanced_conditions.md#2-dynamic-value-references` `docs/design/unified_condition_operators.md#dynamic-value-references` `lib/lcp_ruby/condition_evaluator.rb`
+- **Dynamic Value References (record.<field>)** — Compare two record fields in conditions (value: record.other_field). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#field_ref-another-field-on-the-same-record` `docs/guides/conditional-rendering.md#field_ref-another-field-on-the-same-record` `docs/design/advanced_conditions.md#2-dynamic-value-references` `docs/design/unified_condition_operators.md#dynamic-value-references` `lib/lcp_ruby/condition_evaluator.rb`
+- **Eager Loading Validation for Conditions** — Auto-validates eager loading for dot-path conditions. Warns on N+1 risks. PermissionEvaluator internals. · `docs/reference/condition-operators.md#condition-operators-reference` `docs/guides/conditional-rendering.md#conditional-rendering` `docs/design/advanced_conditions.md#eager-loading-validation` `docs/design/unified_condition_operators.md#dot-path-fields-in-conditions-and-eager-loading` `lib/lcp_ruby/metadata/configuration_validator.rb` `lib/lcp_ruby/presenter/includes_resolver.rb`
+- **Field-Level Permissions** — Show/hide/readonly fields per role (fields: {name: {visible:, editable:}}). permissions/*.yml. · `docs/reference/permissions.md#field-overrides` `docs/reference/permissions.md#fields` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **Impersonation** — Act as another user/role for testing. config.enable_impersonation. permissions/*.yml impersonation: section. · `docs/guides/impersonation.md#impersonation-view-as-role-x` `docs/guides/impersonation.md#setup` `docs/guides/impersonation.md#security` `lib/lcp_ruby/authorization/impersonated_user.rb`
+- **Inherited Record Permissions** — Declarative `inherits_from:` cascade — record visible iff parent visible (via belongs_to). Top-level key on permission YAML. · `docs/guides/inherited-permissions.md` `docs/reference/permissions.md#inherits_from` `docs/guides/hierarchical-authorization.md` `docs/design/hierarchical_record_permissions.md` `lib/lcp_ruby/metadata/permission_definition.rb` `lib/lcp_ruby/authorization/scope_builder.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb` `lib/lcp_ruby/authorization/inherited_parent_validator.rb` `lib/lcp_ruby/authorization/association_lookup.rb` `lib/lcp_ruby/authorization/cache.rb` `lib/lcp_ruby/model_factory/inherited_parent_validator_applicator.rb`
+- **Lookup Value Reference** — Reference another model value in conditions (value: {lookup: {model:, field:}}). permissions/*.yml. · `docs/reference/condition-operators.md#lookup-query-another-model` `docs/guides/conditional-rendering.md#lookup-query-another-model` `docs/design/advanced_conditions.md#match-against-a-codelist-value` `lib/lcp_ruby/condition_evaluator.rb`
+- **Permission Coverage Merge with `_default`** — Per-model permission YAMLs coverage-merge with the `_default` entry by default. `extends:` keyword opts out (`"none"`) or declares intent explicitly (`"_default"`). permissions/*.yml top-level key. · `docs/guides/permissions.md` `docs/reference/permissions.md#extends` `docs/design/permissions_default_role_coverage.md` `lib/lcp_ruby/metadata/permission_merger.rb` `lib/lcp_ruby/metadata/permission_definition.rb` `lib/lcp_ruby/metadata/loader.rb` `lib/lcp_ruby/metadata/configuration_validator.rb` `lib/lcp_ruby/tasks/permission_resolve_formatter.rb` `lib/tasks/lcp_ruby.rake`
+- **Permission Scopes** — Scope queries per role (scopes: {index: {where:}}). permissions/*.yml roles: section. · `docs/reference/permissions.md#scope` `docs/reference/permissions.md#scope-type-field_match` `docs/reference/permissions.md#scope-type-association` `docs/reference/permissions.md#scope-type-where` `docs/reference/permissions.md#scope-type-custom` `docs/design/scoped_permissions.md` `docs/design/unified_permission_scopes.md` `lib/lcp_ruby/authorization/scope_builder.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+- **Record-Level Rules** — Row-level access rules (record_rules: [{field:, operator:, value:}]). permissions/*.yml per role. · `docs/reference/permissions.md#record-rules` `docs/reference/permissions.md#record-rule-attributes` `docs/reference/permissions.md#effect-attributes` `docs/design/record_rules_action_visibility.md#record-rules-action-visibility-design-document` `lib/lcp_ruby/authorization/permission_evaluator.rb` `lib/lcp_ruby/condition_evaluator.rb`
+- **Role-Based CRUD** — CRUD permissions per role (crud: [index, show, ...]). permissions/*.yml roles: section. · `docs/reference/permissions.md#permissions-reference` `docs/reference/permissions.md#role-configuration` `docs/reference/permissions.md#crud` `lib/lcp_ruby/authorization/permission_evaluator.rb` `lib/lcp_ruby/authorization/policy_factory.rb`
+- **String Operators (starts_with / ends_with / contains)** — String matching in conditions (operator: starts_with/ends_with/contains). permissions/*.yml record_rules. · `docs/reference/condition-operators.md#string-pattern-matching` `docs/reference/condition-operators.md#operator-type-compatibility` `docs/design/unified_condition_operators.md#additional-operators` `lib/lcp_ruby/condition_evaluator.rb`
+
+## Positioning
+
+- **Basic Positioning** — Auto sequential position. positioning: true in model. Requires position integer field. Gap closing. · `docs/reference/models.md` `docs/reference/model-dsl.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#design-record-positioning` `docs/design/record_positioning.md#examples` `docs/design/record_positioning.md#simple-ordered-list` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+- **Concurrent Edit Detection** — list_version SHA-256 hash. 409 Conflict on mismatch. Atomic reorder with version tracking. · `docs/reference/presenters.md` `docs/guides/presenters.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#concurrent-reordering` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+- **Permission-Controlled Reordering** — Reorder requires update CRUD + position in writable fields. Two-level permission check. · `docs/reference/presenters.md` `docs/reference/permissions.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#permission-integration` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+- **Position Auto-Management** — Auto bookkeeping: append on create, gap close on destroy, shift on reorder. positioning gem. · `docs/reference/models.md` `docs/reference/model-dsl.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#gem-choice-positioning` `docs/design/record_positioning.md#bulk-create-seeding-performance` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+- **Positioning DSL** — DSL: positioning field:, scope:. Presenter: reorderable true. YAML: positioning: true. · `docs/reference/model-dsl.md` `docs/reference/models.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#model-yaml-new-top-level-positioning-key` `docs/design/record_positioning.md#model-dsl` `docs/design/record_positioning.md#dsl-equivalent` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+- **Reorderable Index** — Drag-and-drop reordering. reorderable: true in presenter index block. Drag handles column. · `docs/reference/presenters.md` `docs/reference/presenter-dsl.md` `docs/guides/presenters.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#presenter-reorderable-true-on-index` `docs/design/record_positioning.md#frontend-index-table-drag-and-drop` `docs/design/record_positioning.md#controller-reorder-action` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+- **Scoped Positioning** — Independent ordering per parent. positioning scope: :parent_id. Each scope has own sequence. · `docs/reference/models.md` `docs/reference/model-dsl.md` `docs/design/record_positioning.md` `docs/design/record_positioning.md#scoped-positioning` `docs/design/record_positioning.md#scope-change-via-normal-edit` `lib/lcp_ruby/model_factory/positioning_applicator.rb`
+
+## Presenter
+
+- **404 Error Page** — Custom not-found page for missing records. presenters/*.yml error_pages: section. · `docs/reference/engine-configuration.md` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Association List — Link Through** — Link association list items to their records (link_through: true). presenters/*.yml show association. · `docs/reference/presenters.md#association-list-sections` `docs/reference/presenters.md#link-through-a-join-model-to-the-real-entity` `docs/reference/presenter-dsl.md#association_listtitle-association-display_template-nil-link-nil-link_through-nil-sort-nil-limit-nil-empty_message-nil-scope-nil-visible_when-nil-disable_when-nil` `docs/guides/presenters.md#linking-through-join-models` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Auto-Search** — Search as you type without submit button (auto_search: true). presenters/*.yml index: search options. · `docs/reference/presenter-dsl.md#auto_searchvalue-true` `docs/reference/presenters.md#search-attributes` `docs/guides/presenters.md#type-aware-quick-search` `lib/lcp_ruby/search/quick_search.rb` `lib/lcp_ruby/controller/search.rb`
+- **Canonical Presenter Selection** — Multi-presenter model link resolution via default: true (per-model canonical) and link_presenter: (per-link override). presenters/*.yml top-level + show.field / index.table_columns / show.association_list. · `docs/reference/presenters.md#multiple-presenters-per-model` `docs/reference/presenters.md#default` `docs/reference/presenter-dsl.md#default` `lib/lcp_ruby/presenter/enrichment.rb` `lib/lcp_ruby/metadata/configuration_validator.rb`
+- **Column Configuration** — Table column control: width, sortable, link_to, pinned, summary. table_columns: in index. presenters/*.yml. · `docs/reference/presenters.md#table_columns` `docs/reference/presenters.md#column-attributes` `docs/reference/presenter-dsl.md#columnfield_name-options` `docs/guides/presenters.md#columns-sorting-and-pagination` `lib/lcp_ruby/presenter/column_set.rb`
+- **Copy URL Button** — Copy record URL to clipboard button on show page. presenters/*.yml show: copy_url: true. · `docs/reference/presenters.md#copy_url` `docs/reference/presenter-dsl.md#copy_urlvalue` `app/views/lcp_ruby/slots/show/_copy_url.html.erb` `spec/integration/copy_url_spec.rb`
+- **Copyable Fields** — Click-to-copy on field values (copyable: true). presenters/*.yml field display option. · `docs/reference/presenters.md#show-field-attributes` `app/helpers/lcp_ruby/display_helper.rb` `lib/lcp_ruby/schemas/presenter.json`
+- **Empty Value Display** — Customize empty/nil display (empty_value: `---`). Global or per-field. presenters/*.yml display options. · `docs/reference/presenters.md#empty_value` `docs/reference/presenter-dsl.md#empty_value` `app/helpers/lcp_ruby/display_helper.rb`
+- **Field/Column Link Through** — Link show fields and index columns to the associated record via link:/link_through:. presenters/*.yml show.field or index.table_columns. · `docs/reference/presenter-dsl.md#section-fields-show` `docs/reference/presenter-dsl.md#column-options` `docs/design/show_field_link_through.md` `lib/lcp_ruby/presenter/enrichment.rb` `lib/lcp_ruby/presenter/link_resolver.rb` `app/helpers/lcp_ruby/link_through_helper.rb`
+- **Info Blocks** — In-form informational callouts. type: info with text: in form section fields. presenters/*.yml or DSL. · `docs/reference/presenters.md#info-pseudo-field` `docs/reference/presenter-dsl.md#infotext` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/presenter/layout_builder.rb` `lib/lcp_ruby/schemas/presenter.json` `app/views/lcp_ruby/resources/_form_section.html.erb`
+- **NULL Filter (Predefined Scope)** — Filter by NULL/NOT NULL via predefined scope (where: {field: nil}). presenters/*.yml filters. · `docs/reference/models.md#null-empty-value-scopes` `docs/reference/presenters.md#predefined-filter-attributes` `lib/lcp_ruby/model_factory/scope_applicator.rb` `lib/lcp_ruby/controller/search.rb`
+- **Predefined Filters** — Scope-based filter tabs above index table. predefined_filters: in search: block. presenters/*.yml or DSL. · `docs/reference/presenters.md#predefined-filter-attributes` `docs/reference/presenter-dsl.md#filtername-label-default-false-scope-nil` `docs/guides/presenters.md#filter-presets` `docs/design/saved_filters.md#predefined-filters-vs-saved-filters-interaction` `lib/lcp_ruby/controller/search.rb`
+- **Presenter Inheritance (DSL)** — Presenter inherits from another via inherits: key. Child overrides specific sections. presenters/*.rb DSL. · `docs/reference/presenter-dsl.md#inheritance` `docs/reference/presenter-dsl.md#inheritance-semantics` `docs/guides/presenters.md#dsl-inheritance` `docs/guides/presenters.md#inheritance-rules` `lib/lcp_ruby/dsl/presenter_builder.rb` `lib/lcp_ruby/dsl/dsl_loader.rb`
+- **Redirect After CRUD** — Custom redirect after create/update/destroy (redirect_to:). presenters/*.yml actions config. · `docs/reference/presenters.md#redirect_after` `docs/reference/presenter-dsl.md#redirect_after` `docs/reference/presenters.md#interaction-with-redirect_after` `app/controllers/lcp_ruby/resources_controller.rb`
+- **Row Click** — Clickable table rows navigating to show page. row_click: show in index: block. presenters/*.yml or DSL. · `docs/reference/presenters.md#row_click` `docs/reference/presenter-dsl.md#row_clickvalue` `lib/lcp_ruby/dsl/presenter_builder.rb` `lib/lcp_ruby/schemas/presenter.json` `app/views/lcp_ruby/resources/_table_index.html.erb`
+- **Row Styling — Built-in CSS Classes** — Seven utility classes: lcp-row-danger/warning/success/info/muted/bold/strikethrough. CSS vars. · `docs/reference/presenters.md#built-in-utility-classes` `docs/reference/presenters.md#item_classes` `docs/design/row_styling.md#built-in-utility-css-classes` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — Rule Accumulation** — Multiple item_class rules accumulate. All matching CSS classes applied simultaneously. · `docs/reference/presenters.md#item_classes` `docs/guides/presenters.md#conditional-row-styling-item_classes` `docs/design/row_styling.md#evaluation-rules` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — Service Condition** — Complex row styling logic via service class (when: { service: :overdue_check }). Server-side eval. · `docs/reference/presenters.md#item_classes` `docs/guides/conditional-rendering.md#service-conditions` `docs/design/row_styling.md#condition-services` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — Tiles & Tree Support** — item_classes work across table, tiles, tree layouts. Same config, different element targets. · `docs/reference/presenters.md#cross-layout-support` `docs/reference/presenters.md#item_classes` `docs/design/row_styling.md#cross-view-support` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — eq Operator** — Conditional row CSS (item_class with eq operator). Match field value to apply class. presenter DSL. · `docs/reference/presenters.md#item_classes` `docs/reference/presenters.md#rule-attributes` `docs/design/row_styling.md#yaml-configuration` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — gt / lt Operators (Numeric)** — Numeric comparison for row styling (gt/gte/lt/lte). Works on integer, float, date, datetime. · `docs/reference/presenters.md#item_classes` `docs/guides/conditional-rendering.md#operator-reference` `docs/design/row_styling.md#evaluation-rules` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — in / not_in Operators** — Match field against value list (operator: :in/:not_in). Group multiple values under one style. · `docs/reference/presenters.md#item_classes` `docs/guides/conditional-rendering.md#operator-reference` `docs/design/row_styling.md#evaluation-rules` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — matches Operator (Regex)** — Regex match for row styling (matches/not_matches). String/text fields. 1s safety timeout. · `docs/reference/presenters.md#item_classes` `docs/guides/conditional-rendering.md#operator-reference` `docs/design/row_styling.md#evaluation-rules` `lib/lcp_ruby/condition_evaluator.rb`
+- **Row Styling — present / blank Operators** — Unary operators for row styling (present/blank). Flag incomplete records. No value param needed. · `docs/reference/presenters.md#item_classes` `docs/guides/conditional-rendering.md#operator-reference` `docs/design/row_styling.md#evaluation-rules` `lib/lcp_ruby/condition_evaluator.rb`
+- **Section Descriptions** — Descriptive text below section headings. description: key on sections in show/form. presenters/*.yml. · `docs/reference/presenters.md#section-attributes` `docs/reference/presenter-dsl.md#sectiontitle-columns-1-description-nil-responsive-nil-visible_when-nil-disable_when-nil-block` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Show Section Disable (disable_when)** — Disable show-page sections by record values (disable_when:). Server-side evaluation. presenters/*.yml show sections. · `docs/reference/presenters.md#section-attributes` `docs/guides/conditional-rendering.md#form-section-disable_when` `docs/guides/conditional-rendering.md#disable-section-on-closed-records` `lib/lcp_ruby/condition_evaluator.rb`
+- **Show Section Visibility (visible_when)** — Show/hide show-page sections by record values (visible_when:). Server-side evaluation. presenters/*.yml show sections. · `docs/reference/presenters.md#section-attributes` `docs/guides/conditional-rendering.md#section-level-conditions` `docs/guides/conditional-rendering.md#show-page-conditions` `lib/lcp_ruby/condition_evaluator.rb`
+- **Sticky Table Header** — Keep table header visible on scroll (sticky_header: true). presenters/*.yml index: table options. · `docs/reference/presenters.md#table_columns` `app/views/lcp_ruby/resources/_table_index.html.erb`
+- **View Descriptions** — Descriptive subtitle text on index/show/form views. description: key in view blocks. presenters/*.yml. · `docs/reference/presenters.md#description` `docs/reference/presenter-dsl.md#descriptiontext` `docs/design/composite_pages_v2.md` `lib/lcp_ruby/dsl/presenter_builder.rb` `lib/lcp_ruby/schemas/presenter.json` `app/views/lcp_ruby/resources/index.html.erb` `app/views/lcp_ruby/resources/show.html.erb` `app/views/lcp_ruby/resources/_form.html.erb`
+- **View Switcher** — Multiple presenter views for same data (view_group:). views/*.yml primary: + views: array. · `docs/reference/view-groups.md#switcher` `docs/guides/view-groups.md#adding-multiple-views-for-a-model` `docs/design/view_switcher_context.md` `lib/lcp_ruby/metadata/view_group_definition.rb` `lib/lcp_ruby/dsl/view_group_builder.rb` `app/helpers/lcp_ruby/layout_helper.rb`
+- **has_one Fields in Show View** — Dot-path fields for has_one in show (association.field). Requires includes: for eager loading. · `docs/reference/presenters.md#show-field-attributes` `docs/reference/presenter-dsl.md#section-fields-show` `docs/guides/presenters.md#sections-and-fields` `lib/lcp_ruby/presenter/field_value_resolver.rb`
+
+## Record Aliases
+
+- **Record Alias Resolution Priority** — Resolution order: alias match (highest) > slug field > numeric ID (fallback). Aliases shadow slugs if names collide. · `docs/guides/record-aliases.md` `docs/design/record_aliases.md` `lib/lcp_ruby/controller/crud_helpers.rb`
+- **Record Alias URL Preservation** — Alias-based URLs are preserved across show, edit, update, and zone navigation. /preferences/me/edit stays /preferences/me/edit. · `docs/guides/record-aliases.md` `docs/design/record_aliases.md` `lib/lcp_ruby/controller/path_helpers.rb` `lib/lcp_ruby/controller/crud_helpers.rb`
+- **Record Alias: current_user Strategy** — record_alias :me, resolve: :current_user, field: :user — resolves alias to the record belonging to the logged-in user. · `docs/guides/record-aliases.md` `docs/reference/presenters.md` `docs/design/record_aliases.md` `lib/lcp_ruby/controller/crud_helpers.rb` `lib/lcp_ruby/record_aliases/setup.rb` `lib/lcp_ruby/metadata/presenter_definition.rb`
+- **Record Alias: current_user on self (User model)** — record_alias :me, resolve: :current_user — no field:, resolves directly to the logged-in user's own row on the user model. · `docs/guides/record-aliases.md` `docs/reference/presenters.md` `docs/design/my_settings_on_user.md` `lib/lcp_ruby/controller/crud_helpers.rb` `lib/lcp_ruby/record_aliases/setup.rb` `lib/lcp_ruby/record_aliases/metadata_checker.rb`
+- **Record Alias: field_on_user Strategy** — record_alias :my, resolve: :field_on_user, user_field: :team_id — resolves alias by reading a FK from current_user. · `docs/guides/record-aliases.md` `docs/reference/presenters.md` `docs/design/record_aliases.md` `lib/lcp_ruby/controller/crud_helpers.rb` `lib/lcp_ruby/record_aliases/setup.rb`
+- **Record Alias: scope Strategy** — record_alias :latest, resolve: :scope, scope: :latest — resolves alias to the first record from a named scope. · `docs/guides/record-aliases.md` `docs/reference/presenters.md` `docs/design/record_aliases.md` `lib/lcp_ruby/controller/crud_helpers.rb` `lib/lcp_ruby/record_aliases/setup.rb`
+- **Slug Field** — Human-readable URLs via slug_field on model. find_by(slug:) when param is non-numeric, to_param returns slug. · `docs/guides/record-aliases.md` `docs/reference/models.md` `docs/design/record_aliases.md` `lib/lcp_ruby/model_factory/builder.rb` `lib/lcp_ruby/controller/crud_helpers.rb` `lib/lcp_ruby/record_aliases/setup.rb`
+- **Slug Field Reserved Segment Validation** — Auto-added exclusion validation prevents slug values that clash with routing segments (new, edit, actions, etc.). · `docs/guides/record-aliases.md` `docs/design/record_aliases.md` `lib/lcp_ruby/reserved_route_segments.rb` `lib/lcp_ruby/model_factory/builder.rb`
+
+## Role Source
+
+- **Active/Inactive Roles** — Toggle roles on/off (active: boolean). Inactive roles excluded from resolution. role model field. · `docs/reference/role-source.md#model-contract` `docs/guides/role-source.md#activeinactive-roles` `lib/lcp_ruby/roles/registry.rb` `lib/lcp_ruby/roles/contract_validator.rb`
+- **DB-Backed Role Source** — Store roles in DB (config.role_source = :model). Dynamic role management via UI. config/initializers/lcp_ruby.rb. · `docs/reference/role-source.md#role-source-reference` `docs/reference/role-source.md#configuration` `docs/guides/role-source.md#quick-start` `lib/lcp_ruby/roles/registry.rb` `lib/lcp_ruby/roles/setup.rb`
+- **Role Model Contract** — Required interface for role models (name, slug, permissions). Roles::Contract validates compliance. · `docs/reference/role-source.md#model-contract` `docs/guides/role-source.md#custom-model-setup` `lib/lcp_ruby/roles/contract_validator.rb`
+- **Role Model Generator** — Scaffold DB role model (rails g lcp_ruby:role_model). Creates migration, model, YAML, and seed data. · `docs/reference/role-source.md#generator` `docs/reference/role-source.md#generated-model-fields` `docs/guides/role-source.md#step-1-run-the-generator` `lib/generators/lcp_ruby/role_model_generator.rb` `lib/generators/lcp_ruby/templates/role_model/model.rb` `lib/generators/lcp_ruby/templates/role_model/presenter.rb`
+- **Role Registry & Caching** — In-memory role cache (Roles::Registry.all, .find). Auto-invalidates on DB change. · `docs/reference/role-source.md#registry` `docs/reference/role-source.md#cache-invalidation` `docs/guides/role-source.md#cache-behavior` `lib/lcp_ruby/roles/registry.rb` `lib/lcp_ruby/roles/change_handler.rb`
+- **Role Validation in Authorization** — PermissionEvaluator validates roles exist in registry before evaluating. Raises on unknown role. · `docs/reference/role-source.md#effect-on-authorization` `docs/reference/role-source.md#configuration-validation` `docs/reference/role-source.md#boot-sequence` `docs/guides/role-source.md#how-role-validation-works` `lib/lcp_ruby/roles/registry.rb` `lib/lcp_ruby/authorization/permission_evaluator.rb`
+
+## Scaffolding
+
+- **lcp_ruby:ensure_tables + db Lifecycle Integration** — Rake task that materialises platform tables idempotently in topological order. db:prepare / db:setup enhanced; db:reset inherits via db:setup. · `docs/getting-started.md#resetting-the-database` `docs/reference/boot_lifecycle.md#database-lifecycle` `docs/design/boot_reload_lifecycle.md` `lib/tasks/lcp_ruby_db.rake` `lib/lcp_ruby/engine.rb`
+- **lcp_ruby:entity generator** — One-shot scaffold of model + presenter + permissions + view group from a CLI field grammar. Covers v1 types/associations, v2 DB constraints + feature flags, v3 sections/renderers/color_map/link/polymorphic. · `docs/getting-started.md#scaffolding-new-entities` `docs/guides/menu.md#adding-entities-to-the-menu` `docs/design/entity_generator.md` `docs/design/entity_generator_menu_flag.md` `lib/generators/lcp_ruby/entity_generator.rb` `lib/generators/lcp_ruby/entity/` `lib/generators/lcp_ruby/generators/entity_menu_writer.rb` `lib/generators/lcp_ruby/templates/entity/`
+
+## Search
+
+- **Advanced Filter Builder** — Visual filter UI with AND/OR. advanced_filter block. max_conditions:, filterable_fields:, presets. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/advanced_search.md#design-advanced-search-filter-builder` `docs/design/advanced_search.md#10-visual-filter-builder-ui-design` `lib/lcp_ruby/search/filter_metadata_builder.rb` `lib/lcp_ruby/search/filter_param_builder.rb` `lib/lcp_ruby/search/query_builder.rb`
+- **Association Select Parameter** — Dropdown for belongs_to. type: :association_select. Local or remote (search: true) mode. Tom Select. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md#parameter-types` `lib/lcp_ruby/search/parameter_definition.rb` `lib/lcp_ruby/search/parameterized_scope_applicator.rb`
+- **Boolean Select Parameter** — Three-option dropdown: All/Yes/No. type: :boolean_select. i18n labels. Omits param on All. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md#parameter-types` `lib/lcp_ruby/search/parameter_definition.rb`
+- **Cascading Field Picker** — Association drill-down in filter. max_association_depth:. Dot-path fields like department.name. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `lib/lcp_ruby/search/parameter_definition.rb`
+- **Date Range Parameter** — From/To date pickers. type: :date_range. Generates gteq/lteq Ransack params. Open-ended ranges. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md#parameter-types` `lib/lcp_ruby/search/parameter_definition.rb` `lib/lcp_ruby/search/relative_date_expander.rb`
+- **Enum Select Parameter** — Dropdown for enum fields. type: :enum_select. Auto-derived options or explicit options:. Tom Select. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md#parameter-types` `lib/lcp_ruby/search/parameter_definition.rb`
+- **Filter Presets** — Pre-configured filter combos. preset :name, conditions: [...] in advanced_filter block. One-click apply. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#predefined-filters-vs-saved-filters-interaction` `docs/design/advanced_search.md#predefined-filter-buttons-filter` `lib/lcp_ruby/search/query_builder.rb`
+- **Number Range Parameter** — Min/Max inputs for numeric fields. type: :number_range. Generates gteq/lteq Ransack params. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md#parameter-types` `lib/lcp_ruby/search/parameter_definition.rb`
+- **Parameter Include Blank** — Customize blank option: include_blank: string/false/nil. Default shows All. Rails convention. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `lib/lcp_ruby/search/parameter_definition.rb`
+- **Parameter Visibility (visible_when)** — Role-based parameter visibility. visible_when: {role: :admin}. Hidden params stripped from query. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `lib/lcp_ruby/search/parameter_definition.rb` `lib/lcp_ruby/condition_evaluator.rb`
+- **Parameterized Scopes** — Scopes with typed params. type: parameterized in model scopes. @scope_name(key: val) QL syntax. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#parameterized-scopes` `docs/design/saved_filters.md#model-yaml-configuration` `docs/design/saved_filters.md#ruby-side` `lib/lcp_ruby/search/parameterized_scope_applicator.rb` `lib/lcp_ruby/search/parameter_definition.rb`
+- **Query Language (QL)** — Text query syntax: field op value AND/OR. query_language: true. Round-trips with visual builder. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/advanced_search.md#8-query-language-ql` `docs/design/saved_filters.md#ql-syntax-for-parameterized-scopes` `lib/lcp_ruby/search/query_language_parser.rb` `lib/lcp_ruby/search/query_language_serializer.rb`
+- **Relative Date Operators** — Dynamic date operators: last_n_days, this_week/month/quarter/year. Date/datetime field filters. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/advanced_search.md#relative-date-functions` `lib/lcp_ruby/search/relative_date_expander.rb`
+- **Saved Filter Default** — Auto-apply filter on page load. default_filter: true. Priority: personal > group > role > global. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#scenario-5-default-filter` `docs/design/saved_filters.md#default-filter-priority` `lib/lcp_ruby/saved_filters/resolver.rb`
+- **Saved Filter Display Modes** — display: :inline (pinned buttons) or :dropdown (single menu). max_visible_pinned:. saved_filters block. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#index-page-display` `docs/design/saved_filters.md#inline-mode-default` `docs/design/saved_filters.md#dropdown-mode` `docs/design/saved_filters.md#sidebar-mode` `lib/lcp_ruby/saved_filters/resolver.rb`
+- **Saved Filter Pinning** — Prominent toolbar buttons. allow_pinning: true, max_visible_pinned: 5. Inline display mode. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#saved-filter-data-model` `lib/lcp_ruby/saved_filters/resolver.rb`
+- **Saved Filter Visibility** — Four levels: personal, role, group, global. visibility: key. Ownership rules enforce access. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#saved-filter-permissions` `docs/design/saved_filters.md#scenario-2-role-shared-filter` `docs/design/saved_filters.md#scenario-3-global-filter` `docs/design/saved_filters.md#scenario-4-group-shared-filter` `lib/lcp_ruby/saved_filters/resolver.rb` `lib/lcp_ruby/saved_filters/contract_validator.rb`
+- **Saved Filters** — User-persistent named filters. saved_filters block. Generator: lcp_ruby:saved_filters. CRUD + pinning. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/saved_filters.md#feature-specification-saved-filters-parameterized-scopes` `docs/design/saved_filters.md#saved-filter-data-model` `docs/design/advanced_search.md#9-saved-filters-configuration-source-principle` `lib/lcp_ruby/saved_filters/` `lib/generators/lcp_ruby/saved_filters_generator.rb`
+- **Search Parameter Controls** — Typed toolbar filters. parameter :name, type: enum_select/association_select/boolean_select/number_range/date_range. · `docs/reference/presenters.md` `docs/reference/condition-operators.md` `docs/guides/conditional-rendering.md` `docs/design/advanced_search.md` `docs/design/search_parameter_controls.md` `docs/design/saved_filters.md` `docs/design/search_parameter_controls.md` `docs/design/advanced_search.md#1-presenter-configuration-search-key-extension` `lib/lcp_ruby/search/parameter_definition.rb` `lib/lcp_ruby/search/param_sanitizer.rb`
+
+## Theming
+
+- **Server-side preference binding** — LayoutHelper reads theme/density/border_radius from user.profile_data on every authenticated request; first paint is correct with no localStorage round-trip. · `docs/reference/engine-configuration.md` `docs/guides/theming.md` `docs/design/my_settings_on_user.md` `app/helpers/lcp_ruby/layout_helper.rb` `app/controllers/lcp_ruby/preferences_controller.rb`
+
+## Tiles
+
+- **Card Actions** — Per-card action style (card.actions :dropdown|:inline|:none). Controls how row actions render on each card. · `docs/guides/tiles.md#tile-configuration-reference` `docs/design/tiles_view.md#tile-card-structure` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Card Description** — Body text on card (card.description_field:). Clamped via max_lines: (default 3). CSS line-clamp truncation. · `docs/guides/tiles.md#tile-fields` `docs/design/tiles_view.md#tile-card-structure` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Card Fields with Renderers** — Label-value pairs in card body (field :name, renderer:). All display renderers supported. Dot-paths too. partial: also supported (parity with table columns). · `docs/guides/tiles.md#tile-fields` `docs/design/tiles_view.md#tile-card-structure` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Card Subtitle with Renderer** — Formatted subtitle below title (card.subtitle_field:). Supports renderer: :badge with color_map: options. · `docs/guides/tiles.md#tile-fields` `docs/design/tiles_view.md#tile-card-structure` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Card Title Field** — Required card heading (card.title_field:). Combined with index-level row_click :show makes the title a clickable link. · `docs/guides/tiles.md#tile-fields` `docs/design/tiles_view.md#tile-card-structure` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Dot-Path Fields in Cards** — Association traversal in card fields (field `assoc.attr`). Auto eager-loads belongs_to to prevent N+1. · `docs/guides/tiles.md#dot-path-fields` `docs/design/tiles_view.md#tile-field-resolution` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Kanban Layout (Phase 1)** — Column-based pipeline view (layout: :kanban). Drag cards between columns via PATCH /:id/kanban_move. group_by → workflow / enum / belongs_to. · `docs/design/kanban_view.md` `docs/design/kanban_view.md#phase-1-mvp` `lib/lcp_ruby/kanban/default_provider.rb` `app/views/lcp_ruby/resources/_kanban_index.html.erb` `app/assets/javascripts/lcp_ruby/controllers/kanban_board_controller.js`
+- **Per-Page Selector** — Records-per-page dropdown (per_page_options N, N, N). In pagination footer. Works on all layouts. · `docs/guides/tiles.md#per-page-selector` `docs/design/tiles_view.md#per-page-selector` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Sort Dropdown** — Tile sort controls (sort_field :name, label:). Dropdown + direction toggle. Appears when any sort_field defined. · `docs/guides/tiles.md#sort-dropdown` `docs/design/tiles_view.md#sort-dropdown` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Summary Bar** — Aggregate bar below tiles (summary { field :f, function: :sum }). 5 SQL fns: sum, avg, count, min, max. · `docs/guides/tiles.md#summary-bar` `docs/design/tiles_view.md#summary-bar` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Tile Columns** — Cards per row (tile { columns N }). Default 3. Responsive breakpoints: 2 cols <1200px, 1 col <768px. · `docs/guides/tiles.md#tile-configuration-reference` `docs/design/tiles_view.md#tile-configuration-yaml` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Tiles Layout** — Card grid index layout (layout: :tiles). card: block (zones) + tile: block (grid columns). title_field required. · `docs/guides/tiles.md#quick-setup` `docs/design/tiles_view.md#feature-specification-tiles-view-index-layout` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Tiles with Inheritance** — Reuse parent presenter via inherits:. Child redefines only index block for tiles layout. Shares show/form. · `docs/guides/tiles.md#inheritance` `docs/design/tiles_view.md#tile-configuration-yaml` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Tiles with Predefined Filters** — Filter buttons on tile grid (filter :name, scope:). Inherited from parent presenter when using inherits:. · `docs/guides/tiles.md#combining-with-other-features` `docs/design/tiles_view.md#interaction-with-existing-features` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+- **Tiles with View Groups** — View switcher integration. Add tiles presenter to view_group YAML. Preserves search/filter context on switch. · `docs/guides/tiles.md#combining-with-other-features` `docs/design/tiles_view.md#view-group-integration` `app/views/lcp_ruby/resources/_tiles_index.html.erb` `lib/lcp_ruby/presenter/layout_builder.rb`
+
+## Types
+
+- **Built-in Business Types** — Four built-in types: email, phone, url, color. Format validation + specialized renderers (mailto/tel/link). · `docs/reference/types.md` `docs/guides/custom-types.md` `lib/lcp_ruby/types/`
+- **Custom Type Definition (DSL)** — Ruby DSL for custom types (define_type block). Same attributes as YAML: base_type, transforms, etc. · `docs/reference/types.md` `docs/guides/custom-types.md` `lib/lcp_ruby/types/` `lib/lcp_ruby/dsl/`
+- **Custom Type Definition (YAML)** — Reusable field type bundle (config/lcp_ruby/types/*.yml). base_type, validations, renderer, input_type. · `docs/reference/types.md` `docs/guides/custom-types.md` `lib/lcp_ruby/types/` `lib/lcp_ruby/metadata/`
+- **Macro + Type Reserved-Name Detection** — Validator + generator preflight reject field names that shadow methods generated by AR's `enum` macro or by tree/positioning/workflow macros (e.g. `field :value, :enum` clashes with `Klass.values`; `field :ancestors` on a tree model clashes with the generated `record.ancestors`). · `docs/reference/types.md#reserved_clashes` `docs/reference/models.md` `docs/design/type_system_defaults.md` `lib/lcp_ruby/metadata/reserved_names.rb` `lib/lcp_ruby/metadata/configuration_validator.rb` `lib/generators/lcp_ruby/entity_generator.rb`
+- **Renderer-Name as Type-Name Synonym (C7 fix)** — Pass a type name where a renderer name is expected (e.g. `renderer: :enum` resolves to `:badge`); runtime registry falls through to the type registry. · `docs/reference/presenters.md#aliases` `docs/reference/model-dsl.md` `docs/design/type_system_defaults.md` `lib/lcp_ruby/display/renderer_registry.rb` `lib/lcp_ruby/types/type_registry.rb`
+- **Row-Friendliness Warning + display_in_index Opt-In** — Validator warns when an index column references a row-unfriendly type (`:text`, `:rich_text`, `:attachment`, `:json`, `:array`, `:file`); silenced by explicit `renderer:`, `partial:`, or `display_in_index: true` opt-in. · `docs/reference/types.md#default_index_visible` `docs/reference/presenters.md` `docs/reference/presenter-dsl.md` `docs/design/type_system_defaults.md` `lib/lcp_ruby/metadata/configuration_validator.rb` `lib/lcp_ruby/types/type_registry.rb`
+- **Type-Driven Renderer Defaults** — With `runtime_type_renderers` flag on, presenter columns whose `renderer:` is absent get the type's default renderer at column-set build time (boolean → boolean_icon, enum → badge, text → truncate). · `docs/reference/engine-configuration.md#runtime_type_renderers` `docs/reference/presenters.md#type-driven-renderer-defaults-runtime_type_renderers` `docs/reference/types.md#renderer` `docs/design/type_system_defaults.md` `lib/lcp_ruby/presenter/column_set.rb` `lib/lcp_ruby/types/type_registry.rb`
+- **Type-Driven null:false Validators** — Field declared `null: false` auto-applies the type's `null_false_validation` rule at runtime (boolean → inclusion, everything else → presence; custom types can compose multiple rules per type). · `docs/reference/types.md#null_false_validation` `docs/reference/model-dsl.md` `docs/design/type_system_defaults.md` `lib/lcp_ruby/model_factory/validation_applicator.rb` `lib/lcp_ruby/types/type_registry.rb`
+
+## Virtual Fields
+
+- **Backward Compatibility (aggregates key)** — YAML alias: aggregates -> virtual_columns, sql -> expression. Old keys still work. · `docs/guides/virtual-columns.md#backward-compatibility` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/collector.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **Declarative Aggregates** — Shorthand aggregate DSL. function: count/sum/avg/min/max. association:, where:, distinct:, default:. · `docs/guides/virtual-columns.md#1-declarative-aggregates` `docs/guides/virtual-columns.md#where-conditions-declarative-aggregates` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/collector.rb` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **Expression Column (Boolean)** — Raw SQL in SELECT. expression: with EXISTS/CASE. %{table} placeholder. virtual_column DSL. · `docs/guides/virtual-columns.md#2-expression-columns` `docs/guides/virtual-columns.md#null-safety-for-boolean-expressions` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **Expression Column (Derived Value)** — Inline SQL derived value. CASE expression for division. expression: key. virtual_column DSL. · `docs/guides/virtual-columns.md#2-expression-columns` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **Expression with Auto-Include** — auto_include: true for always-available columns. Used by item_classes. default: for COALESCE. · `docs/guides/virtual-columns.md#auto-include` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **External Source (Computed Field)** — source: :external. Host defines getter/setter via on_model_ready. Read-only computed values. _(beta)_ · `docs/guides/computed-fields.md#computed-fields-guide` `docs/guides/computed-fields.md#service-syntax-custom-logic` `docs/guides/computed-fields.md#writing-a-computed-service` `docs/design/fields_accessors.md#design-external-field-accessors` `lib/lcp_ruby/services/registry.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **External Source (Derived Field)** — External field deriving from other virtual fields. Display-only. on_model_ready define_method. _(beta)_ · `docs/guides/computed-fields.md#computed-fields-guide` `docs/guides/computed-fields.md#derived-from-associations` `docs/design/fields_accessors.md#design-external-field-accessors` `docs/design/fields_accessors.md#form-a-source-external` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb` `lib/lcp_ruby/services/registry.rb`
+- **JOIN Deduplication** — Multiple columns sharing same JOIN. Builder deduplicates identical join: clauses. Single SQL JOIN. · `docs/guides/virtual-columns.md#3-expression-join-columns` `docs/design/virtual_columns.md` `docs/design/advanced_search.md#duplicate-rows-from-has_many-joins` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **JOIN-based Column** — Value from related table. expression: + join: LEFT JOIN. %{table} placeholder. virtual_column DSL. · `docs/guides/virtual-columns.md#3-expression-join-columns` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **JSON Field Accessor (Boolean)** — Boolean in JSON column. Checkbox input. source: {service: json_field, options: {column:, key:}}. _(beta)_ · `docs/design/fields_accessors.md` `docs/guides/virtual-columns.md` `docs/design/fields_accessors.md#built-in-json_field-accessor` `docs/design/fields_accessors.md#json-column-with-virtual-editors` `lib/lcp_ruby/services/accessors/json_field.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **JSON Field Accessor (Integer with Validation)** — Integer in JSON with numericality validation. Errors on virtual field name, not JSON column. _(beta)_ · `docs/design/fields_accessors.md` `docs/guides/virtual-columns.md` `docs/design/fields_accessors.md#built-in-json_field-accessor` `docs/design/fields_accessors.md#json-column-with-virtual-editors` `lib/lcp_ruby/services/accessors/json_field.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **JSON Field Accessor (String)** — json_field service: reads/writes JSON column key. source: {service: json_field, options: {column:, key:}}. _(beta)_ · `docs/design/fields_accessors.md` `docs/guides/virtual-columns.md` `docs/design/fields_accessors.md#built-in-json_field-accessor` `docs/design/fields_accessors.md#json-column-with-virtual-editors` `lib/lcp_ruby/services/accessors/json_field.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **Multiple Virtual Fields from One JSON Column** — Many typed fields sharing one JSON column. Each targets different key. Single properties column. _(beta)_ · `docs/design/fields_accessors.md` `docs/guides/virtual-columns.md` `docs/design/fields_accessors.md#json-column-with-virtual-editors` `lib/lcp_ruby/services/accessors/json_field.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **Row Styling with Virtual Columns** — item_classes using virtual columns. auto_include: true columns available. Multiple rules stack. · `docs/guides/virtual-columns.md#conditional-rendering-with-virtual-columns` `docs/guides/virtual-columns.md#row-styling-based-on-virtual-column` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb`
+- **Service Virtual Column** — Ruby service class. service: key. self.call + optional self.sql_expression. app/lcp_services/. · `docs/guides/virtual-columns.md#4-service-columns` `docs/guides/virtual-columns.md#service-with-arel-db-portability` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **Sorting by Virtual Columns** — sortable: true on virtual columns. SQL ORDER BY for expressions/JOINs. sql_expression for services. · `docs/guides/virtual-columns.md#displaying-virtual-columns` `docs/guides/virtual-columns.md#index-page-table-columns` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **User profile as preference store** — user.profile_data + service: json_field — expose per-user preferences as first-class presenter fields without a satellite table. · `docs/reference/engine-configuration.md` `docs/reference/presenters.md` `docs/design/my_settings_on_user.md` `lib/lcp_ruby/services/accessors/json_field.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb` `lib/lcp_ruby/model_factory/enum_applicator.rb`
+- **Virtual Columns Overview** — Query-time computed values via SQL. aggregate/expression/join/window/service. virtual_column DSL. · `docs/guides/virtual-columns.md#virtual-columns-guide` `docs/guides/virtual-columns.md#how-it-works` `docs/guides/virtual-columns.md#four-virtual-column-types` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+- **Virtual Enum (Inclusion Validation)** — Enum without DB column. Auto inclusion validation. values: + json_field source. Select input + badge. _(beta)_ · `docs/guides/virtual-columns.md#virtual-columns-guide` `docs/design/fields_accessors.md#design-external-field-accessors` `lib/lcp_ruby/services/accessors/json_field.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **Virtual Field with Default** — Static defaults on virtual fields. default: value applied on create. Works with json_field source. _(beta)_ · `docs/guides/virtual-columns.md#virtual-columns-guide` `docs/design/fields_accessors.md#design-external-field-accessors` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb` `lib/lcp_ruby/services/built_in_defaults.rb`
+- **Virtual Fields Overview** — No-column fields. source: {service: json_field} or source: :external. Stored in JSON or computed. _(beta)_ · `docs/guides/virtual-columns.md#virtual-columns-guide` `docs/guides/computed-fields.md#computed-fields-guide` `docs/guides/virtual-columns.md#virtual-columns-vs-computed-fields` `docs/guides/computed-fields.md#computed-fields-vs-virtual-columns` `docs/design/virtual_columns.md` `docs/design/fields_accessors.md#design-external-field-accessors` `lib/lcp_ruby/virtual_columns/` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb` `lib/lcp_ruby/model_factory/service_accessor_applicator.rb`
+- **Window Function Column** — SQL window functions: ROW_NUMBER, RANK. PARTITION BY + ORDER BY. expression: in virtual_column. · `docs/guides/virtual-columns.md#advanced-patterns` `docs/guides/virtual-columns.md#window-functions` `docs/design/virtual_columns.md` `lib/lcp_ruby/virtual_columns/builder.rb` `lib/lcp_ruby/model_factory/virtual_column_applicator.rb`
+
+## Workflow
+
+- **Approval Bypass Condition** — Auto-approve matching records (bypass_when:). Standard condition operators. Skips all steps. · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Approval Resolution Transitions** — Auto-fire system transitions on resolution (resolution: { approved/rejected/returned: transition }). · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Approval Status Widget** — Show approval progress (widget type: approval_status). Steps, tasks, action buttons, comments. · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Approval Task Actions (Controller)** — POST endpoints: approve, reject, return_task, claim, delegate. TaskManager backend. · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/` `lib/lcp_ruby/controller/`
+- **Approval Task Delegation** — Delegate task to another user (allow_delegation: true). Configurable max_delegation_depth. · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Auto-Set Fields (set_fields)** — Auto-populate fields on transition (set_fields:). Supports :now, :today, current_user.id, literals. · `docs/reference/workflow.md#set_fields-value-expressions` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/value_resolver.rb` `lib/lcp_ruby/workflow/transition_executor.rb`
+- **Clear Fields (value: null)** — Reset fields to nil on transition (set_fields: { field: :null }). For rework/reset flows. · `docs/reference/workflow.md#set_fields-value-expressions` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/value_resolver.rb`
+- **Confirmation Dialogs** — Pre-submit confirmation (confirm: true, confirm_message:). data-turbo-confirm or window.confirm. · `docs/guides/action-buttons.md` `docs/reference/workflow.md` `docs/guides/workflow.md#confirmation-dialogs` `docs/design/form_submit_actions.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/controller/` `lib/lcp_ruby/workflow/`
+- **Direct Enum Update Blocking** — Blocks direct field changes on workflow field. Only transitions can change state. before_save callback. · `docs/reference/workflow.md#direct-enum-update-blocking` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/`
+- **Dual-Use Triggers (trigger: both)** — Transition visible as UI button AND callable programmatically (trigger: :both). · `docs/reference/workflow.md#trigger-values` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/transition_definition.rb`
+- **Field Copy (field_ref)** — Copy field values on transition (field_ref:). Snapshot of source field at transition time. · `docs/reference/workflow.md#set_fields-value-expressions` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/value_resolver.rb`
+- **Field-Based Approvers** — Resolve approvers from record field (type: `field`, field: `reviewer_id`). Read at creation time. · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Multi-Step Approval Engine** — Multi-step approval on workflow state (approval block). Sequential/parallel steps, typed approvers. · `docs/reference/workflow-approvals.md` `docs/guides/workflow.md#approval-engine` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Multiple Source States** — Single transition from multiple states (from: [:draft, :returned]). Shared guard/set_fields config. · `docs/reference/workflow.md#transition-keys` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/transition_definition.rb`
+- **Presenter Transition Overrides** — Show/hide transition buttons per presenter. Same workflow, different UI per user role view. · `docs/reference/workflow.md#presenter-integration` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/` `lib/lcp_ruby/presenter/`
+- **Readonly Fields per State** — Lock fields by state (readonly_fields: [:title] or :all). Server-enforced + form disabled rendering. · `docs/reference/workflow.md#readonly_fields` `docs/guides/workflow.md#locking-fields-per-state` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/state_definition.rb`
+- **Required Comments** — Require comment before transition (require_comment: true). Stored in workflow audit log. · `docs/reference/workflow.md#transition-keys` `docs/guides/workflow.md#requiring-comments` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/transition_definition.rb` `lib/lcp_ruby/workflow/transition_executor.rb`
+- **Required Reject Comment** — Force comment on rejection (require_reject_comment: true). Stored on task, shown in widget. · `docs/reference/workflow-approvals.md` `docs/reference/workflow.md#approvals` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Rework Policy (Reset All)** — Reset approval on rework (rework_policy: { reset: `all` }). Creates new request, increments count. · `docs/reference/workflow-approvals.md` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Role-Based Approvers** — Assign tasks to role members (type: `role`, role: `admin`). All matching users get tasks. · `docs/reference/workflow-approvals.md` `docs/guides/workflow.md#approval-engine` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Sequential Approval Strategy** — Steps execute in order (strategy :sequential). Step N+1 activates after step N completes. · `docs/reference/workflow-approvals.md` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **Short-Circuit Rejection** — Stop approval on first reject (short_circuit: true, on_reject: `any`). Skips remaining steps. · `docs/reference/workflow-approvals.md` `docs/design/workflow_approvals.md` `lib/lcp_ruby/workflow/approval/`
+- **State Categories** — Semantic categories on states (category: :draft/:terminal/etc). For UI grouping and dashboard filters. · `docs/reference/workflow.md#state-categories` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/state_definition.rb`
+- **System Triggers** — Hidden transitions (trigger: :system). For approval engines, background jobs, external integrations. · `docs/reference/workflow.md#trigger-values` `docs/guides/workflow.md#system-triggers` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/transition_definition.rb` `lib/lcp_ruby/workflow/transition_executor.rb`
+- **Timeline States** — Ordered state subset for timeline (timeline_states:). Off-path states shown as badges. · `docs/reference/workflow.md#timeline_states` `docs/guides/workflow.md#show-page-timeline` `docs/design/workflow_renderers.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/`
+- **Transition Guards** — Guard conditions on transitions (guard: { all/any/not }). Same 15 operators as visible_when. · `docs/reference/workflow.md#guard-conditions` `docs/guides/workflow.md#guard-conditions` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/transition_executor.rb` `lib/lcp_ruby/condition_evaluator.rb`
+- **Transition Roles** — Per-transition role restrictions (roles: [:admin]). Intersection with CRUD update permission. · `docs/reference/workflow.md#transition-keys` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/transition_definition.rb`
+- **Wildcard Source State (from: "*")** — Transition from any state (from: `*`). Expanded to all state names at load time. Admin emergency use. · `docs/reference/workflow.md#transition-keys` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/`
+- **Workflow Audit Log** — Transition history (audit_log: true). Records who, from/to state, comment, metadata, user snapshot. · `docs/reference/workflow.md#audit-log` `docs/guides/workflow.md#step-2-set-up-audit-logging` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/audit_writer.rb` `lib/lcp_ruby/workflow/audit_registry.rb`
+- **Workflow Badge Renderer** — Colored badge display (workflow_badge renderer). Colors from state definition. Auto-detected on index. · `docs/reference/workflow.md#renderer-integration` `docs/guides/workflow.md#index-page-badge` `docs/design/workflow_renderers.md` `lib/lcp_ruby/workflow/` `lib/lcp_ruby/display/`
+- **Workflow DSL** — Ruby DSL alternative to YAML (define_workflow block). Same features: states, transitions, guards. · `docs/reference/workflow.md#dsl-format` `docs/guides/workflow.md#using-the-dsl` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/` `lib/lcp_ruby/dsl/`
+- **Workflow Events (on_entry / on_exit)** — Events fired on state enter/exit (on_entry:, on_exit:). Standard event handler dispatch. · `docs/reference/workflow.md` `docs/guides/workflow.md#writing-event-handlers` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/` `lib/lcp_ruby/events/`
+- **Workflow Graph (Mermaid Diagram)** — Mermaid state diagram widget (workflow_graph). Shows states, transitions, guards, roles, audit steps. · `docs/reference/workflow.md` `docs/guides/workflow.md#composite-page-workflow-graph` `docs/design/workflow_diagram_dialog.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/mermaid_builder.rb`
+- **Workflow Renderer Auto-Detection** — Auto-injects workflow_badge on index, workflow_timeline on show. No manual renderer: config needed. · `docs/reference/workflow.md#renderer-integration` `docs/guides/workflow.md#visualizing-workflow-status` `docs/design/workflow_renderers.md` `lib/lcp_ruby/workflow/` `lib/lcp_ruby/display/`
+- **Workflow State Machine** — Metadata-driven state machine (workflow: block). States, transitions, guards. models/*.yml or workflow/*.yml. · `docs/reference/workflow.md#workflow-reference` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/state_machine.rb` `lib/lcp_ruby/workflow/`
+- **Workflow Timeline Renderer** — Horizontal step indicator on show page (workflow_timeline). Completed/current/future steps. · `docs/reference/workflow.md#renderer-integration` `docs/guides/workflow.md#show-page-timeline` `docs/design/workflow_renderers.md` `lib/lcp_ruby/workflow/` `lib/lcp_ruby/display/`
+- **Workflow Versioning** — Per-record version freeze (workflow_version field). Records keep original workflow definition. · `docs/reference/workflow.md` `docs/guides/workflow.md` `docs/design/workflow_state_machine.md` `lib/lcp_ruby/workflow/`