pi-apexlang 0.2.2 → 0.4.0

package/skills/apexlang/assets/component-policies.json

@@ -292,21 +292,30 @@
     },
     {
       "id": "REGION_RULE_006",
-      "scope": "region.metricChart.interactions",
-      "whenAny": [
-        {
-          "regionType": "Metric Card"
-        },
-        {
-          "regionType": "Chart"
-        }
-      ],
+      "scope": "region.chart.interactions",
+      "when": {
+        "regionType": "Chart"
+      },
       "forbid": [
         "links",
         "actions"
       ],
       "severity": "error",
-      "message": "Metric Card and Chart regions must not own links or actions; model navigation through adjacent components."
+      "message": "Chart regions must not own links or actions; model navigation through adjacent components."
+    },
+    {
+      "id": "REGION_RULE_019",
+      "scope": "region.metricCard.interactions",
+      "when": {
+        "regionType": "Metric Card"
+      },
+      "requireValues": {
+        "actions.position": [
+          "link"
+        ]
+      },
+      "severity": "error",
+      "message": "Metric Card row actions use the compiler-backed link position and do not use action templates."
     },
     {
       "id": "REGION_RULE_007",

package/skills/apexlang/assets/contracts/grammar-semantic-rules.json

@@ -0,0 +1,134 @@
+{
+  "schemaVersion": 1,
+  "purpose": "Compact renderer requirements selected by grammar components and variant conditions.",
+  "rules": [
+    {
+      "id": "canonical-page-identity",
+      "match": { "components": ["page"] },
+      "level": "must",
+      "scope": "page-local",
+      "check": "canonical-page-identity",
+      "requirements": [
+        "Declare the numeric page id in both `page <id> (` and `page: <id>`.",
+        "For pNNNNN-<slug>.apx, set alias to the uppercase slug with hyphens preserved."
+      ]
+    },
+    {
+      "id": "normal-static-content-slot",
+      "match": { "conditions": ["page.pageMode=normal", "region.type=staticContent"] },
+      "level": "must",
+      "scope": "page-local",
+      "check": "normal-static-content-slot",
+      "requirements": [
+        "Place static-content regions in `layout.slot: body`; `contentBody` is for modal-dialog content."
+      ]
+    },
+    {
+      "id": "normal-page-breadcrumb-region",
+      "match": { "conditions": ["page.pageMode=normal"] },
+      "level": "must",
+      "scope": "page-local",
+      "check": "normal-page-breadcrumb-region",
+      "requirements": [
+        "Render a named `region breadcrumb (` block with `type: breadcrumb`, `source.breadcrumb: @breadcrumb`, and `layout.slot: breadcrumbBar`."
+      ]
+    },
+    {
+      "id": "normal-page-breadcrumb-entry",
+      "match": { "conditions": ["page.pageMode=normal"] },
+      "level": "must",
+      "scope": "app-local",
+      "check": "shared-breadcrumb-entry",
+      "requirements": [
+        "Add a shared breadcrumb entry whose pageNumber matches this non-modal page."
+      ]
+    },
+    {
+      "id": "normal-page-body-regions",
+      "match": { "components": ["region"], "conditions": ["page.pageMode=normal"] },
+      "level": "must",
+      "scope": "page-local",
+      "check": "normal-page-body-regions",
+      "requirements": [
+        "Place every non-breadcrumb region on a normal page in `layout.slot: body`; reserve `contentBody` for modal-dialog content."
+      ]
+    },
+    {
+      "id": "normal-page-template-decision",
+      "match": { "conditions": ["page.pageMode=normal"] },
+      "level": "decision",
+      "scope": "page-local",
+      "requirements": ["Do not invent page template references."],
+      "decisions": [
+        {
+          "when": "No special page layout is requested or selected.",
+          "use": "appearance.pageTemplate: @/standard"
+        },
+        {
+          "when": "A special page layout is requested.",
+          "use": "Its compiler- or contract-verified template; stop if unavailable."
+        }
+      ]
+    },
+    {
+      "id": "static-content-region",
+      "match": { "conditions": ["region.type=staticContent"] },
+      "level": "decision",
+      "scope": "page-local",
+      "requirements": [
+        "Use `source.text` for plain text or `source.htmlCode` only when HTML is requested; do not add SQL.",
+        "Do not invent region template references."
+      ],
+      "decisions": [
+        {
+          "when": "Ordinary body content with no special shell.",
+          "use": "appearance.template: @/standard"
+        },
+        {
+          "when": "A special shell or interaction pattern is requested.",
+          "use": "A compiler- or contract-verified region template; stop if unavailable."
+        }
+      ]
+    },
+    {
+      "id": "same-app-button-target",
+      "match": { "conditions": ["button.action=redirectThisApp"] },
+      "level": "must",
+      "scope": "page-local",
+      "check": "same-app-button-target",
+      "requirements": [
+        "Use an object-valued `behavior.target` property; scalar page numbers and f?p URL strings are invalid."
+      ],
+      "shape": "target: {\n  page: <task-page-number>\n  clearCache: <task-page-number-if-needed>\n}"
+    },
+    {
+      "id": "button-presentation-evidence",
+      "match": { "components": ["button"] },
+      "level": "decision",
+      "scope": "page-local",
+      "requirements": [
+        "Derive `layout.slot` from the verified parent region template; do not infer it from the region type alone.",
+        "Emit alignment, row/column flags, `hot`, icons, and template options only from explicit task intent or a selected construction contract.",
+        "Do not invent button template references or presentation choices."
+      ],
+      "decisions": [
+        {
+          "when": "Text-only button with no specialized template.",
+          "use": "appearance.buttonTemplate: @/text"
+        },
+        {
+          "when": "The task explicitly marks the button primary.",
+          "use": "appearance.hot: true"
+        },
+        {
+          "when": "The task requests an icon.",
+          "use": "Select @/text-with-icon or @/icon from label intent; do not guess."
+        },
+        {
+          "when": "Unsaved-change behavior is relevant.",
+          "use": "Apply workflow or app policy; do not force doNotCheck globally."
+        }
+      ]
+    }
+  ]
+}

package/skills/apexlang/assets/contracts/package-layers.json

@@ -0,0 +1,56 @@
+{
+  "schemaVersion": 1,
+  "purpose": "Progressive public-package layer contract. The public skill keeps one entrypoint while assets are grouped by load responsibility.",
+  "decision_order": [
+    "apexlang-core",
+    "apexlang-metadata",
+    "apexlang-patterns",
+    "apexlang-runtime"
+  ],
+  "trace_required": true,
+  "layers": [
+    {
+      "id": "apexlang-core",
+      "summary": "Router, workflow entrypoints, local context discovery, stop conditions, and import approval rules.",
+      "required_paths": ["SKILL.md", "assets/routing-catalog-main.json", "assets/routing-load-policy.json", "assets/workspace-intelligence.json"],
+      "load_policy": "always_first"
+    },
+    {
+      "id": "apexlang-metadata",
+      "summary": "Grammar, compiler property lookup tools, compiler-truth audit, and curated fallback component attributes.",
+      "required_paths": [
+        "assets/grammar/apexlang.ebnf",
+        "assets/contracts/grammar-semantic-rules.json",
+        "runtime/grammar_contract.mjs",
+        "tools/query-valid-props.mjs",
+        "tools/compiler-truth-audit.mjs",
+        "assets/component-attributes.json"
+      ],
+      "load_policy": "when_structural_legality_or_validation_is_needed",
+      "model_context_policy": "tool_results_only",
+      "runtime_only_paths": ["assets/grammar/apexlang.ebnf", "assets/component-attributes.json"],
+      "model_interfaces": ["tools/query-valid-props.mjs", "tools/compiler-truth-audit.mjs"]
+    },
+    {
+      "id": "apexlang-patterns",
+      "summary": "Structured page construction packs plus selected templates and domain references.",
+      "required_paths": [
+        "assets/contracts/page-patterns.json",
+        "assets/contracts/page-construction-packs.json",
+        "assets/apex-generation/components.registry.json",
+        "templates",
+        "references/domains/README.md"
+      ],
+      "load_policy": "when_generation_requires_page_or_app_pattern_selection",
+      "model_context_policy": "resolver_projection_only",
+      "model_interfaces": ["tools/apexctl.mjs context resolve"]
+    },
+    {
+      "id": "apexlang-runtime",
+      "summary": "SQLcl preflight, live validate/import gates, and failure repair loop references.",
+      "required_paths": ["references/ops/sqlcl.md", "references/ops/runtime-gates.md", "runtime/runtime.bundle.mjs", "assets/validator-fix-recipes.json"],
+      "load_policy": "when_live_db_or_runtime_validation_is_requested_or_required",
+      "model_context_policy": "projected_repair_results_only"
+    }
+  ]
+}

package/skills/apexlang/assets/contracts/page-construction-packs.json

@@ -0,0 +1,154 @@
+{
+  "schemaVersion": 1,
+  "purpose": "Renderer-facing construction packs for common page workflows. Each pack declares inputs, emitted components, validation gates, and follow-on references.",
+  "selection_order": ["visual-summary-cards", "report-modal-form", "dashboard", "master-detail", "smart-filter-search", "faceted-search", "carousel-static-content", "lov-backed-form"],
+  "packs": [
+    {
+      "id": "visual-summary-cards",
+      "pattern_id": "visual-summary-cards",
+      "inputs": {
+        "required": ["app_path", "page_id", "cards_source", "source_mode", "title_mapping"],
+        "optional": ["subtitle_mapping", "body_mapping", "secondary_body_mapping", "primary_key_mapping", "icon_mapping", "media_mapping", "badge_mapping", "conditional_style_mapping", "card_target", "refresh_trigger", "page_items_to_submit", "fixed_grid_columns", "authorization_scheme", "rest_web_credential", "rest_allowed_url_prefixes"]
+      },
+      "components": ["page:visualSummary", "region:cards", "action:cardNavigationWhenRequested", "dynamicAction:cardsRefreshWhenRequested"],
+      "renderer_rules": ["emit_cards_source_mapping_first", "select_exact_sql_or_rest_source_shape", "prefer_native_icon_media_badge_and_action_blocks", "emit_component_appearance_layout_grid", "omit_only_fixed_grid_columns_for_ut_responsive_auto_layout", "project_only_allowlisted_conditional_css_tokens", "emit_exact_refresh_dynamic_action_when_requested", "apply_page_region_action_and_rest_security", "exclude_filter_and_search_orchestration", "validate_generated_apx"],
+      "validation_rules": ["CARDS_VISUAL_SUMMARY_PATTERN_REQUIRED_001", "CARDS_SOURCE_MAPPING_REQUIRED_001", "CARDS_INTERACTION_BOUNDARY_REQUIRED_001", "CARDS_SECURITY_REQUIRED_001", "CARDS_CONDITIONAL_STYLE_ALLOWLIST_REQUIRED_001", "DEFAULT_GUIDANCE_LAYER_REQUIRED_001"]
+    },
+    {
+      "id": "report-modal-form",
+      "pattern_id": "report-modal-form",
+      "inputs": {
+        "required": ["app_path", "report_page_id", "form_page_id", "source_table_or_query", "primary_key", "report_columns", "form_items"],
+        "optional": ["authorization_scheme", "breadcrumb_parent", "create_button_label", "edit_action_label"]
+      },
+      "components": ["page:report", "region:interactiveReport", "button:create", "page:modalForm", "process:formAutomaticRowProcessing"],
+      "renderer_rules": ["emit_ir_first", "query_property_mapper_for_non_exact_shapes", "validate_generated_apx"],
+      "validation_rules": ["INTERACTIVE_REPORT_COLUMN_COVERAGE_001", "FORM_DRAWER_DEFAULT_END_REQUIRED_001"]
+    },
+    {
+      "id": "dashboard",
+      "pattern_id": "dashboard",
+      "inputs": {
+        "required": ["app_path", "page_id", "metrics", "chart_series"],
+        "optional": ["supporting_report_source", "time_filter_item", "drill_targets"]
+      },
+      "components": ["page:dashboard", "templateComponent:metricCard", "region:chart", "region:reportOrCards"],
+      "renderer_rules": ["emit_ir_first", "prefer_metric_card_template_components", "validate_generated_apx"],
+      "validation_rules": ["DASHBOARD_KPI_METRIC_CARD_REQUIRED_001", "DEFAULT_GUIDANCE_LAYER_REQUIRED_001"]
+    },
+    {
+      "id": "master-detail",
+      "pattern_id": "master-detail",
+      "inputs": {
+        "required": ["app_path", "page_id", "master_source", "detail_source", "join_key"],
+        "optional": ["modal_detail_target", "map_layer_target", "refresh_behavior"]
+      },
+      "components": ["region:masterResults", "region:detailResults", "dynamicAction:selectionRefresh"],
+      "renderer_rules": ["emit_ir_first", "explicit_refresh_for_child_context", "validate_generated_apx"],
+      "validation_rules": ["MASTER_DETAIL_DYNAMIC_ACTION_REQUIRED_001", "MAP_LAYER_CONTEXT_BIND_REQUIRED_001"]
+    },
+    {
+      "id": "smart-filter-search",
+      "pattern_id": "smart-filter-search",
+      "inputs": {
+        "required": ["app_path", "page_id", "results_source", "base_region_static_id", "searchable_attributes", "match_semantics", "min_chars", "max_len", "tokenization_policy", "settings_contract", "security_scope", "performance_readiness", "generation_plan"],
+        "optional": ["results_region_alias", "results_region_type", "authorization_scheme"]
+      },
+      "contract": {
+        "base_region": {
+          "count": 1,
+          "static_id_required": true,
+          "allowed_source_modes": ["secured_view", "canonical_sql"],
+          "apex_version": "24.2",
+          "allowed_region_types": ["classicReport", "cards", "map", "calendar"],
+          "canonical_sql_snapshot_required": true,
+          "object_evidence_must_match_source": true,
+          "secured_view_evidence": ["object", "source", "object_type:view", "secured:true"],
+          "allow_sql_auto_modification": false
+        },
+        "search": {
+          "searchable_attributes_allowlist_required": true,
+          "match_semantics": ["contains", "starts", "exact"],
+          "match_semantics_count": 1,
+          "match_semantic_definitions": {
+            "contains": "normalized_token_within_value",
+            "starts": "normalized_value_starts_with_token",
+            "exact": "normalized_value_equals_token"
+          },
+          "min_chars_required": true,
+          "min_chars": {"type": "positive_integer", "minimum": 1},
+          "max_len_required": true,
+          "max_len": {"type": "positive_integer", "minimum": 1, "greater_than_or_equal_to": "min_chars"},
+          "tokenization_policy_required": true,
+          "tokenization_policy": {
+            "required_decisions": ["trimming", "repeated_whitespace", "punctuation_boundaries", "case_normalization", "accent_normalization", "duplicate_tokens", "token_order"],
+            "consistency_scope": ["search", "suggestions", "refinements"]
+          },
+          "compiler_evidence_required": true,
+          "unsupported_behavior_outcome": "stop_missing_inputs",
+          "allow_base_sql_rewrite": false
+        },
+        "settings": {
+          "compiler_evidence_required": true,
+          "required_properties": ["maxSuggestionChips", "moreFiltersSuggestionChip", "compactNosThreshold", "showTotalRowCount"],
+          "maxSuggestionChips": 100,
+          "moreFiltersSuggestionChip": true,
+          "compactNosThreshold": 10000,
+          "showTotalRowCount": "explicit_boolean",
+          "totalRowCountLabel": {
+            "when": {"showTotalRowCount": true},
+            "value": "Results"
+          },
+          "unsupported_property_outcome": "stop_missing_inputs"
+        },
+        "security": {
+          "suggestions_use_base_dataset": true,
+          "authorization_and_condition_match_base": true
+        },
+        "performance": {
+          "required_evidence": ["index_strategy", "statistics_status", "expected_cardinality"]
+        },
+        "generation_plan": {
+          "required_sections": ["base_source", "search", "settings_contract", "security_scope", "performance_readiness", "runtime_acceptance"],
+          "compiler_evidence": ["match_semantics", "min_chars", "max_len", "tokenization_policy"]
+        }
+      },
+      "components": ["region:smartFilters", "filter:search", "region:filteredResults"],
+      "renderer_rules": ["emit_smart_filters_before_results", "target_exactly_one_base_region", "require_proven_base_source_contract", "query_compiler_truth_for_settings", "stop_on_unrepresentable_search_behavior", "enforce_compiler_supported_ticket_settings", "require_performance_readiness_evidence", "validate_generated_apx"],
+      "validation_rules": ["SMART_FILTER_TOPOLOGY_REQUIRED_001", "SMART_FILTER_RESULTS_REGION_REQUIRED_001", "SMART_FILTER_RESULTS_REGION_ORDER_REQUIRED_001", "SMART_FILTER_BASE_SOURCE_CONTRACT_REQUIRED_001", "SMART_FILTER_SEARCH_SOURCE_REQUIRED_001", "SMART_FILTER_SEARCHABLE_COLUMNS_BASE_PROJECTION_REQUIRED_001", "SMART_FILTER_SECURITY_SCOPE_MATCH_REQUIRED_001", "SMART_FILTER_REFINEMENT_SOURCE_SCOPE_REQUIRED_001", "SMART_FILTER_SEARCH_BEHAVIOR_CONTRACT_REQUIRED_001", "SMART_FILTER_SETTINGS_VALUE_REQUIRED_001", "SMART_FILTER_PERFORMANCE_READINESS_REQUIRED_001", "SMART_FILTER_ACCESSIBILITY_GUIDANCE_REQUIRED_001", "SMART_FILTER_RUNTIME_ACCEPTANCE_REQUIRED_001"]
+    },
+    {
+      "id": "faceted-search",
+      "pattern_id": "faceted-search",
+      "inputs": {
+        "required": ["app_path", "page_id", "results_source", "facet_columns"],
+        "optional": ["results_region_alias", "default_filters", "saved_report"]
+      },
+      "components": ["region:facetedSearch", "region:results", "facet:items"],
+      "renderer_rules": ["emit_ir_first", "target_results_region_only", "validate_generated_apx"],
+      "validation_rules": ["FACET_SOURCE_DATA_TYPE_REQUIRED_001"]
+    },
+    {
+      "id": "carousel-static-content",
+      "pattern_id": "carousel-static-content",
+      "inputs": {
+        "required": ["app_path", "page_id", "content_items"],
+        "optional": ["action_targets", "template_variant", "empty_state"]
+      },
+      "components": ["region:staticContent", "templateComponent:contentRowOrCards"],
+      "renderer_rules": ["emit_ir_first", "avoid_unsupported_custom_html", "validate_generated_apx"],
+      "validation_rules": ["GENERATION_PLAN_REQUIRED_001"]
+    },
+    {
+      "id": "lov-backed-form",
+      "pattern_id": "lov-backed-form",
+      "inputs": {
+        "required": ["app_path", "page_id", "form_source", "lov_source", "display_column", "return_column", "target_item"],
+        "optional": ["display_null", "cascading_parent_item", "authorization_scheme"]
+      },
+      "components": ["sharedComponent:lov", "item:selectListOrPopupLov", "process:formAutomaticRowProcessing"],
+      "renderer_rules": ["emit_ir_first", "verify_lov_columns", "query_property_mapper_for_item_variant", "validate_generated_apx"],
+      "validation_rules": ["COMPILER_TRUTH_EVIDENCE_REQUIRED_001"]
+    }
+  ]
+}

package/skills/apexlang/assets/contracts/page-patterns.json

@@ -0,0 +1,119 @@
+{
+  "schemaVersion": 1,
+  "purpose": "Compact selector catalog for supported APEX page patterns. Use this before Markdown templates when choosing a page construction path.",
+  "authority": {
+    "syntax": "assets/grammar/apexlang.ebnf",
+    "semantics": "tools/query-valid-props.mjs and compiler-truth audit",
+    "fallback_policy": "assets/component-attributes.json is curated fallback context only"
+  },
+  "patterns": [
+    {
+      "id": "visual-summary-cards",
+      "name": "Visual summary cards",
+      "intent_keywords": ["visual summary", "people cards", "person cards", "product cards", "status cards", "status tiles", "entity cards", "cards region", "cards"],
+      "selection_require_any": ["visual summary", "people cards", "person cards", "product cards", "status cards", "status tiles", "entity cards", "cards region", "cards"],
+      "selection_exclude_any": ["faceted search", "facets", "filters", "filtering", "smart filters", "search page", "search cards", "cards search"],
+      "required_inputs": ["cards_source", "source_mode", "title_mapping"],
+      "generated_components": ["cards_region"],
+      "validation_rules": [
+        "CARDS_VISUAL_SUMMARY_PATTERN_REQUIRED_001",
+        "CARDS_SOURCE_MAPPING_REQUIRED_001",
+        "CARDS_INTERACTION_BOUNDARY_REQUIRED_001",
+        "CARDS_SECURITY_REQUIRED_001",
+        "CARDS_CONDITIONAL_STYLE_ALLOWLIST_REQUIRED_001"
+      ],
+      "reference_paths": [
+        "references/policies/memory-bank/30-pages/apex.cards-page.md",
+        "templates/region-components/cards/cards._common.md"
+      ]
+    },
+    {
+      "id": "report-modal-form",
+      "name": "Report plus modal form",
+      "intent_keywords": ["report", "interactive report", "crud", "modal form", "drawer form", "create edit"],
+      "selection_require_any": ["crud", "modal form", "drawer form", "create edit"],
+      "required_inputs": ["source_table_or_query", "primary_key", "report_columns", "form_items", "target_page_ids"],
+      "generated_components": ["interactive_report_region", "modal_form_page", "create_button", "edit_link_or_row_action", "automatic_row_processing"],
+      "validation_rules": [
+        "FORM_DRAWER_DEFAULT_END_REQUIRED_001",
+        "INTERACTIVE_REPORT_COLUMN_COVERAGE_001",
+        "DECLARATIVE_BUTTON_TARGET_REQUIRED"
+      ],
+      "reference_paths": [
+        "templates/page-examples/interactive-report-page/interactive-report-page.example.md",
+        "templates/page-examples/form-page/form-page.example.md",
+        "references/domains/page-components/regions/form/workflow-modal-crud-form.md"
+      ]
+    },
+    {
+      "id": "dashboard",
+      "name": "Dashboard",
+      "intent_keywords": ["dashboard", "kpi", "metric", "chart", "operations summary"],
+      "required_inputs": ["metrics", "chart_series", "supporting_report_or_cards_region"],
+      "generated_components": ["metric_card_template_components", "chart_region", "supporting_results_region"],
+      "validation_rules": ["DASHBOARD_KPI_METRIC_CARD_REQUIRED_001", "DEFAULT_GUIDANCE_LAYER_REQUIRED_001"],
+      "reference_paths": [
+        "references/policies/memory-bank/30-pages/apex.dashboard.md",
+        "templates/template-components/metric-card/metric-card._common.md",
+        "references/domains/page-components/regions/dashboard/workflow-dashboard.md"
+      ]
+    },
+    {
+      "id": "master-detail",
+      "name": "Master detail",
+      "intent_keywords": ["master detail", "parent child", "detail region", "selected row"],
+      "required_inputs": ["master_source", "detail_source", "join_key", "selection_behavior"],
+      "generated_components": ["master_results_region", "detail_results_or_form_region", "selection_dynamic_action"],
+      "validation_rules": ["MASTER_DETAIL_DYNAMIC_ACTION_REQUIRED_001", "GENERATION_PLAN_REQUIRED_001"],
+      "reference_paths": ["references/domains/README.md", "references/workflows/apexlang/application-spec.template.md"]
+    },
+    {
+      "id": "smart-filter-search",
+      "name": "Smart Filter Search",
+      "intent_keywords": ["smart filter", "smart filters", "smart filter search", "smart filters region"],
+      "required_inputs": ["results_source", "base_region_static_id", "searchable_attributes", "match_semantics", "min_chars", "max_len", "tokenization_policy", "settings_contract", "security_scope", "performance_readiness", "generation_plan"],
+      "readiness_required_inputs": ["results_source", "base_region_static_id", "searchable_attributes", "match_semantics", "min_chars", "max_len", "tokenization_policy", "settings_contract", "security_scope", "performance_readiness", "generation_plan"],
+      "generated_components": ["smart_filters_region", "search_filter", "filtered_results_region"],
+      "validation_rules": ["SMART_FILTER_TOPOLOGY_REQUIRED_001", "SMART_FILTER_RESULTS_REGION_REQUIRED_001", "SMART_FILTER_RESULTS_REGION_ORDER_REQUIRED_001", "SMART_FILTER_BASE_SOURCE_CONTRACT_REQUIRED_001", "SMART_FILTER_SEARCH_SOURCE_REQUIRED_001", "SMART_FILTER_SEARCHABLE_COLUMNS_BASE_PROJECTION_REQUIRED_001", "SMART_FILTER_SECURITY_SCOPE_MATCH_REQUIRED_001", "SMART_FILTER_REFINEMENT_SOURCE_SCOPE_REQUIRED_001", "SMART_FILTER_SEARCH_BEHAVIOR_CONTRACT_REQUIRED_001", "SMART_FILTER_SETTINGS_VALUE_REQUIRED_001", "SMART_FILTER_PERFORMANCE_READINESS_REQUIRED_001", "SMART_FILTER_ACCESSIBILITY_GUIDANCE_REQUIRED_001", "SMART_FILTER_RUNTIME_ACCEPTANCE_REQUIRED_001"],
+      "reference_paths": [
+        "references/policies/memory-bank/30-pages/apex.smart-filter-search.md",
+        "templates/region-components/smart-filter-search/smart-filter-search._common.md"
+      ]
+    },
+    {
+      "id": "faceted-search",
+      "name": "Faceted search",
+      "intent_keywords": ["faceted search", "facets", "filters", "filtering", "smart filters", "search page", "search cards", "cards search"],
+      "required_inputs": ["results_source", "facet_columns", "results_region_alias"],
+      "generated_components": ["faceted_search_region", "filtered_results_region", "facet_items"],
+      "validation_rules": ["FACET_SOURCE_DATA_TYPE_REQUIRED_001"],
+      "reference_paths": [
+        "templates/page-examples/faceted-search/faceted-search.example.md",
+        "templates/region-components/faceted-search/faceted-search._common.md"
+      ]
+    },
+    {
+      "id": "carousel-static-content",
+      "name": "Carousel or static content",
+      "intent_keywords": ["carousel", "static content", "empty state", "cards", "content band"],
+      "selection_require_any": ["carousel", "static content", "empty state", "content band"],
+      "required_inputs": ["content_items", "region_purpose", "navigation_or_action_targets"],
+      "generated_components": ["static_content_region", "template_component_or_cards_region"],
+      "validation_rules": ["GENERATION_PLAN_REQUIRED_001", "DEFAULT_GUIDANCE_LAYER_REQUIRED_001"],
+      "reference_paths": ["templates/region-components/static-content/README.md"]
+    },
+    {
+      "id": "lov-backed-form",
+      "name": "LOV-backed form",
+      "intent_keywords": ["lov", "select list", "popup lov", "lookup", "reference data"],
+      "required_inputs": ["form_source", "lov_source", "display_column", "return_column", "target_item"],
+      "generated_components": ["shared_lov", "form_item", "form_process"],
+      "validation_rules": ["COMPILER_TRUTH_EVIDENCE_REQUIRED_001", "DEFAULT_GUIDANCE_LAYER_REQUIRED_001"],
+      "reference_paths": [
+        "templates/shared-components/lovs/lovs.dynamic.query.md",
+        "templates/items/select-list/select-list.lov-shared.md",
+        "references/domains/README.md"
+      ]
+    }
+  ]
+}