rebly-sections 1.0.1 → 1.2.0

package/assets/data/settings-profiles.csv

@@ -0,0 +1,235 @@
+Section Type,Setting ID,Setting Type,Label,Default,Required,Notes,Frequency Rank
+about,margin_top,range,Margin Top,,True,Appears in 147/657 about sections,1
+about,margin_bottom,range,Margin Bottom,,True,Appears in 147/657 about sections,2
+about,bg_breadcrumb,text,Bg Breadcrumb,,True,Appears in 112/657 about sections,3
+about,title,text,Title,,False,Appears in 100/657 about sections,4
+about,enable_s_servicebox,checkbox,Enable S Servicebox,,False,Appears in 99/657 about sections,5
+about,bg_image,image_picker,Bg Image,,False,Appears in 95/657 about sections,6
+about,enable_intro,checkbox,Enable Intro,,False,Appears in 94/657 about sections,7
+about,ins_userid,text,Ins Userid,,False,Appears in 81/657 about sections,8
+about,ins_access_token,text,Ins Access Token,,False,Appears in 81/657 about sections,9
+about,ins_limit_number,range,Ins Limit Number,,False,Appears in 81/657 about sections,10
+announcement,display_top_bar,checkbox,Display Top Bar,,True,Appears in 122/333 announcement sections,1
+announcement,top_bar_bg,checkbox,Top Bar Bg,,True,Appears in 122/333 announcement sections,2
+announcement,top_bar_links,url,Top Bar Links,,True,Appears in 122/333 announcement sections,3
+announcement,top_bar_link_hover,url,Top Bar Link Hover,,False,Appears in 122/333 announcement sections,4
+announcement,top_bar_text,richtext,Top Bar Text,,False,Appears in 120/333 announcement sections,5
+announcement,header_phone_value,checkbox,Header Phone Value,,False,Appears in 118/333 announcement sections,6
+announcement,header_mail_value,checkbox,Header Mail Value,,False,Appears in 118/333 announcement sections,7
+announcement,top_border_between_bars,checkbox,Top Border Between Bars,,False,Appears in 102/333 announcement sections,8
+announcement,enable_sidebar_multiple_choice,checkbox,Enable Sidebar Multiple Choice,,False,Appears in 92/333 announcement sections,9
+announcement,currency_icon,checkbox,Currency Icon,,False,Appears in 58/333 announcement sections,10
+blog,select_blog,blog,Select Blog,,True,Appears in 397/895 blog sections,1
+blog,blogs_limit,blog,Blogs Limit,,True,Appears in 397/895 blog sections,2
+blog,margin_top,range,Margin Top,,True,Appears in 248/895 blog sections,3
+blog,margin_bottom,range,Margin Bottom,,False,Appears in 248/895 blog sections,4
+blog,show_author,checkbox,Show Author,,False,Appears in 197/895 blog sections,5
+blog,blog_layout,blog,Blog Layout,,False,Appears in 189/895 blog sections,6
+blog,enable_widget_cate,checkbox,Enable Widget Cate,,False,Appears in 182/895 blog sections,7
+blog,enable_title,checkbox,Enable Title,,False,Appears in 178/895 blog sections,8
+blog,widget_cate_menu,checkbox,Widget Cate Menu,,False,Appears in 177/895 blog sections,9
+blog,widget_cate_title,text,Widget Cate Title,,False,Appears in 174/895 blog sections,10
+collection,section_title,text,Section Title,,True,Appears in 8/30 collection sections,1
+collection,bg_img,text,Bg Img,,True,Appears in 6/30 collection sections,2
+collection,section_sub_title,text,Section Sub Title,,True,Appears in 6/30 collection sections,3
+collection,heading_style_handle,select,Heading Style Handle,,False,Appears in 6/30 collection sections,4
+collection,heading_left_position,select,Heading Left Position,,False,Appears in 6/30 collection sections,5
+collection,product_column,product,Product Column,,False,Appears in 6/30 collection sections,6
+collection,product_column_md,product,Product Column Md,,False,Appears in 6/30 collection sections,7
+collection,title_color,color,Title Color,,False,Appears in 5/30 collection sections,8
+collection,margin_top,range,Margin Top,,False,Appears in 5/30 collection sections,9
+collection,margin_bottom,range,Margin Bottom,,False,Appears in 5/30 collection sections,10
+countdown,margin_top,range,Margin Top,,True,Appears in 141/151 countdown sections,1
+countdown,margin_bottom,range,Margin Bottom,,True,Appears in 141/151 countdown sections,2
+countdown,timecountdow,range,Timecountdow,,True,Appears in 93/151 countdown sections,3
+countdown,button_1,text,Button 1,,False,Appears in 92/151 countdown sections,4
+countdown,url_button1,url,Url Button1,,False,Appears in 85/151 countdown sections,5
+countdown,title_product,product,Title Product,,False,Appears in 85/151 countdown sections,6
+countdown,url_product,url,Url Product,,False,Appears in 64/151 countdown sections,7
+countdown,img_bg_countdown,range,Img Bg Countdown,,False,Appears in 62/151 countdown sections,8
+countdown,price_sale,text,Price Sale,,False,Appears in 59/151 countdown sections,9
+countdown,price_no_sale,text,Price No Sale,,False,Appears in 57/151 countdown sections,10
+cta,layout,select,Layout,,True,Appears in 4/90 cta sections,1
+cta,heading,text,Heading,,True,Appears in 4/90 cta sections,2
+cta,title,text,Title,,True,Appears in 3/90 cta sections,3
+cta,bg_color,color,Bg Color,,False,Appears in 3/90 cta sections,4
+cta,text_color,color,Text Color,,False,Appears in 3/90 cta sections,5
+cta,effect,text,Effect,,False,Appears in 3/90 cta sections,6
+cta,au_time,text,Au Time,,False,Appears in 3/90 cta sections,7
+cta,cl_bg,text,Cl Bg,,False,Appears in 3/90 cta sections,8
+cta,image,image_picker,Image,,False,Appears in 3/90 cta sections,9
+cta,hide_bgimg,checkbox,Hide Bgimg,,False,Appears in 3/90 cta sections,10
+faq,section_description,richtext,Section Description,,True,Appears in 66/248 faq sections,1
+faq,section_title,text,Section Title,,True,Appears in 45/248 faq sections,2
+faq,enable_slide,checkbox,Enable Slide,,True,Appears in 38/248 faq sections,3
+faq,bg_breadcrumb,text,Bg Breadcrumb,,False,Appears in 38/248 faq sections,4
+faq,enable_asked,checkbox,Enable Asked,,False,Appears in 38/248 faq sections,5
+faq,title_asked,text,Title Asked,,False,Appears in 38/248 faq sections,6
+faq,description_asked,richtext,Description Asked,,False,Appears in 38/248 faq sections,7
+faq,enable_newsletter,checkbox,Enable Newsletter,,False,Appears in 38/248 faq sections,8
+faq,newsletter_placeholder_input,text,Newsletter Placeholder Input,,False,Appears in 38/248 faq sections,9
+faq,iconmail,text,Iconmail,,False,Appears in 38/248 faq sections,10
+features,title,text,Title,,True,Appears in 166/343 features sections,1
+features,collection,collection,Collection,,True,Appears in 64/343 features sections,2
+features,background_color,color,Background Color,,True,Appears in 43/343 features sections,3
+features,section_title,text,Section Title,,False,Appears in 39/343 features sections,4
+features,grid,text,Grid,,False,Appears in 38/343 features sections,5
+features,margin,range,Margin,,False,Appears in 34/343 features sections,6
+features,full,text,Full,,False,Appears in 31/343 features sections,7
+features,blog,blog,Blog,,False,Appears in 30/343 features sections,8
+features,heading_position,select,Heading Position,,False,Appears in 29/343 features sections,9
+features,padding,range,Padding,,False,Appears in 29/343 features sections,10
+footer,copyright,checkbox,Copyright,,True,Appears in 275/504 footer sections,1
+footer,footer_show_methods_of_payment,checkbox,Footer Show Methods Of Payment,,True,Appears in 236/504 footer sections,2
+footer,footer_social_enable,checkbox,Footer Social Enable,,True,Appears in 220/504 footer sections,3
+footer,payment_icon_1,checkbox,Payment Icon 1,,False,Appears in 214/504 footer sections,4
+footer,payment_icon_2,checkbox,Payment Icon 2,,False,Appears in 214/504 footer sections,5
+footer,payment_icon_3,checkbox,Payment Icon 3,,False,Appears in 214/504 footer sections,6
+footer,payment_icon_4,checkbox,Payment Icon 4,,False,Appears in 214/504 footer sections,7
+footer,payment_icon_5,checkbox,Payment Icon 5,,False,Appears in 214/504 footer sections,8
+footer,payment_icon_6,checkbox,Payment Icon 6,,False,Appears in 214/504 footer sections,9
+footer,payment_icon_7,checkbox,Payment Icon 7,,False,Appears in 211/504 footer sections,10
+gallery,full,text,Full,,True,Appears in 63/215 gallery sections,1
+gallery,background_color,color,Background Color,,True,Appears in 63/215 gallery sections,2
+gallery,margin,range,Margin,,True,Appears in 62/215 gallery sections,3
+gallery,heading_position,select,Heading Position,,False,Appears in 61/215 gallery sections,4
+gallery,padding,range,Padding,,False,Appears in 59/215 gallery sections,5
+gallery,image,image_picker,Image,,False,Appears in 59/215 gallery sections,6
+gallery,spacing_both_ends,range,Spacing Both Ends,,False,Appears in 58/215 gallery sections,7
+gallery,section_heading,text,Section Heading,,False,Appears in 58/215 gallery sections,8
+gallery,section_sub_heading,text,Section Sub Heading,,False,Appears in 58/215 gallery sections,9
+gallery,section_description,richtext,Section Description,,False,Appears in 58/215 gallery sections,10
+header,display_search,header,Display Search,,True,Appears in 241/637 header sections,1
+header,logo_text,image_picker,Logo Text,,True,Appears in 231/637 header sections,2
+header,menubar_links,url,Menubar Links,,True,Appears in 231/637 header sections,3
+header,menubar_links_hover,url,Menubar Links Hover,,False,Appears in 231/637 header sections,4
+header,menu_active,header,Menu Active,,False,Appears in 231/637 header sections,5
+header,menubar_dropdown_bg,header,Menubar Dropdown Bg,,False,Appears in 231/637 header sections,6
+header,menubar_dropdown_caption,header,Menubar Dropdown Caption,,False,Appears in 231/637 header sections,7
+header,menubar_dropdown_caption_hover,header,Menubar Dropdown Caption Hover,,False,Appears in 231/637 header sections,8
+header,menubar_dropdown_links,url,Menubar Dropdown Links,,False,Appears in 231/637 header sections,9
+header,menubar_dropdown_links_hover,url,Menubar Dropdown Links Hover,,False,Appears in 231/637 header sections,10
+hero,margin_top,range,Margin Top,,True,Appears in 1371/2150 hero sections,1
+hero,margin_bottom,range,Margin Bottom,,True,Appears in 1371/2150 hero sections,2
+hero,img_banner1,text,Img Banner1,,True,Appears in 434/2150 hero sections,3
+hero,button_1,text,Button 1,,False,Appears in 388/2150 hero sections,4
+hero,url_banner1,url,Url Banner1,,False,Appears in 336/2150 hero sections,5
+hero,img_banner2,text,Img Banner2,,False,Appears in 318/2150 hero sections,6
+hero,title_1,text,Title 1,,False,Appears in 296/2150 hero sections,7
+hero,url_banner2,url,Url Banner2,,False,Appears in 276/2150 hero sections,8
+hero,button_2,text,Button 2,,False,Appears in 261/2150 hero sections,9
+hero,url_button1,url,Url Button1,,False,Appears in 254/2150 hero sections,10
+hero,heading_font,font_picker,Heading Font,,False,Typography control for hero heading,11
+hero,heading_size,select,Heading Size,,False,Small/Medium/Large heading scale,12
+hero,heading_tag,select,Heading Tag,,False,H1/H2/H3 for SEO hierarchy,13
+hero,color_scheme,color_scheme,Color Scheme,,False,Theme-wide color scheme,14
+logo,title,text,Title,,True,Appears in 19/32 logo sections,1
+logo,logo_max_width,image_picker,Logo Max Width,,True,Appears in 7/32 logo sections,2
+logo,logo,image_picker,Logo,,True,Appears in 6/32 logo sections,3
+logo,title_color,color,Title Color,,False,Appears in 5/32 logo sections,4
+logo,style,select,Style,,False,Appears in 2/32 logo sections,5
+logo,logos_in_rows,image_picker,Logos In Rows,,False,Appears in 2/32 logo sections,6
+logo,logo_per_slide_desktop,image_picker,Logo Per Slide Desktop,,False,Appears in 1/32 logo sections,7
+logo,logo_per_slide_tablet,image_picker,Logo Per Slide Tablet,,False,Appears in 1/32 logo sections,8
+logo,logo_per_slide_mobile,image_picker,Logo Per Slide Mobile,,False,Appears in 1/32 logo sections,9
+logo,fullwidth,range,Fullwidth,,False,Appears in 1/32 logo sections,10
+map,bg_breadcrumb,text,Bg Breadcrumb,,True,Appears in 109/311 map sections,1
+map,enable_s_contactform,checkbox,Enable S Contactform,,True,Appears in 86/311 map sections,2
+map,contactform_name,text,Contactform Name,,True,Appears in 86/311 map sections,3
+map,contactform_email,text,Contactform Email,,False,Appears in 86/311 map sections,4
+map,contactform_content,richtext,Contactform Content,,False,Appears in 86/311 map sections,5
+map,contactform_btn,text,Contactform Btn,,False,Appears in 86/311 map sections,6
+map,contactform_subject,text,Contactform Subject,,False,Appears in 76/311 map sections,7
+map,describe,text,Describe,,False,Appears in 58/311 map sections,8
+map,enable_map,checkbox,Enable Map,,False,Appears in 56/311 map sections,9
+map,enable_info,checkbox,Enable Info,,False,Appears in 44/311 map sections,10
+newsletter,margin_top,range,Margin Top,,True,Appears in 160/399 newsletter sections,1
+newsletter,margin_bottom,range,Margin Bottom,,True,Appears in 160/399 newsletter sections,2
+newsletter,title_newletter,text,Title Newletter,,True,Appears in 130/399 newsletter sections,3
+newsletter,content_newletter,richtext,Content Newletter,,False,Appears in 108/399 newsletter sections,4
+newsletter,title,text,Title,,False,Appears in 104/399 newsletter sections,5
+newsletter,color_title,color,Color Title,,False,Appears in 68/399 newsletter sections,6
+newsletter,color_content,color,Color Content,,False,Appears in 67/399 newsletter sections,7
+newsletter,bg_newsletters,text,Bg Newsletters,,False,Appears in 54/399 newsletter sections,8
+newsletter,select_style,select,Select Style,,False,Appears in 49/399 newsletter sections,9
+newsletter,select_width,range,Select Width,,False,Appears in 49/399 newsletter sections,10
+other,margin_top,range,Margin Top,,True,Appears in 760/1838 other sections,1
+other,margin_bottom,range,Margin Bottom,,True,Appears in 750/1838 other sections,2
+other,ins_userid,text,Ins Userid,,True,Appears in 318/1838 other sections,3
+other,ins_access_token,text,Ins Access Token,,False,Appears in 318/1838 other sections,4
+other,ins_limit_number,range,Ins Limit Number,,False,Appears in 318/1838 other sections,5
+other,title,text,Title,,False,Appears in 208/1838 other sections,6
+other,item_icon,text,Item Icon,,False,Appears in 155/1838 other sections,7
+other,bg_breadcrumb,text,Bg Breadcrumb,,False,Appears in 154/1838 other sections,8
+other,padding,range,Padding,,False,Appears in 128/1838 other sections,9
+other,margin,range,Margin,,False,Appears in 117/1838 other sections,10
+pricing,full,text,Full,,True,Appears in 9/16 pricing sections,1
+pricing,spacing_both_ends,range,Spacing Both Ends,,True,Appears in 9/16 pricing sections,2
+pricing,padding,range,Padding,,True,Appears in 9/16 pricing sections,3
+pricing,margin,range,Margin,,False,Appears in 9/16 pricing sections,4
+pricing,show_background_image,image_picker,Show Background Image,,False,Appears in 9/16 pricing sections,5
+pricing,background_image,image_picker,Background Image,,False,Appears in 9/16 pricing sections,6
+pricing,background_style,select,Background Style,,False,Appears in 9/16 pricing sections,7
+pricing,enable_overlay,checkbox,Enable Overlay,,False,Appears in 9/16 pricing sections,8
+pricing,background_color,color,Background Color,,False,Appears in 9/16 pricing sections,9
+pricing,overlay_transparency,text,Overlay Transparency,,False,Appears in 9/16 pricing sections,10
+product-grid,margin_top,range,Margin Top,,True,Appears in 1062/2508 product-grid sections,1
+product-grid,margin_bottom,range,Margin Bottom,,True,Appears in 1062/2508 product-grid sections,2
+product-grid,products_limit,product,Products Limit,,True,Appears in 471/2508 product-grid sections,3
+product-grid,select_collection,collection,Select Collection,,False,Appears in 469/2508 product-grid sections,4
+product-grid,title,text,Title,,False,Appears in 389/2508 product-grid sections,5
+product-grid,bg_breadcrumb,text,Bg Breadcrumb,,False,Appears in 356/2508 product-grid sections,6
+product-grid,color_title,color,Color Title,,False,Appears in 231/2508 product-grid sections,7
+product-grid,prod_per_row,range,Prod Per Row,,False,Appears in 203/2508 product-grid sections,8
+product-grid,title_section_product,product,Title Section Product,,False,Appears in 196/2508 product-grid sections,9
+product-grid,enable_info_collection,collection,Enable Info Collection,,False,Appears in 165/2508 product-grid sections,10
+rich-text,background_color,color,Background Color,,True,Appears in 48/203 rich-text sections,1
+rich-text,title,text,Title,,True,Appears in 39/203 rich-text sections,2
+rich-text,padding,range,Padding,,True,Appears in 38/203 rich-text sections,3
+rich-text,bg_color,color,Bg Color,,False,Appears in 28/203 rich-text sections,4
+rich-text,margin,range,Margin,,False,Appears in 27/203 rich-text sections,5
+rich-text,full,text,Full,,False,Appears in 25/203 rich-text sections,6
+rich-text,section_title,text,Section Title,,False,Appears in 25/203 rich-text sections,7
+rich-text,background_image,image_picker,Background Image,,False,Appears in 24/203 rich-text sections,8
+rich-text,newsletter_enable,checkbox,Newsletter Enable,,False,Appears in 24/203 rich-text sections,9
+rich-text,newsletter_form_heading,text,Newsletter Form Heading,,False,Appears in 23/203 rich-text sections,10
+sidebar,status,select,Status,,True,Appears in 8/11 sidebar sections,1
+sidebar,position,select,Position,,True,Appears in 8/11 sidebar sections,2
+sidebar,width,range,Width,,True,Appears in 4/11 sidebar sections,3
+sidebar,height,range,Height,,False,Appears in 4/11 sidebar sections,4
+sidebar,button_style,select,Button Style,,False,Appears in 4/11 sidebar sections,5
+sidebar,widget_text,richtext,Widget Text,,False,Appears in 4/11 sidebar sections,6
+sidebar,page_url,url,Page Url,,False,Appears in 4/11 sidebar sections,7
+sidebar,tabs,select,Tabs,,False,Appears in 4/11 sidebar sections,8
+sidebar,small_header,select,Small Header,,False,Appears in 4/11 sidebar sections,9
+sidebar,hide_cover,checkbox,Hide Cover,,False,Appears in 4/11 sidebar sections,10
+stats,full,checkbox,Full,,True,Appears in 18/21 stats sections,1
+stats,spacing_both_ends,range,Spacing Both Ends,,True,Appears in 18/21 stats sections,2
+stats,padding,range,Padding,,True,Appears in 18/21 stats sections,3
+stats,margin,range,Margin,,False,Appears in 18/21 stats sections,4
+stats,show_background_image,image_picker,Show Background Image,,False,Appears in 18/21 stats sections,5
+stats,background_image,image_picker,Background Image,,False,Appears in 18/21 stats sections,6
+stats,background_style,select,Background Style,,False,Appears in 18/21 stats sections,7
+stats,enable_overlay,checkbox,Enable Overlay,,False,Appears in 18/21 stats sections,8
+stats,background_color,color,Background Color,,False,Appears in 18/21 stats sections,9
+stats,overlay_transparency,checkbox,Overlay Transparency,,False,Appears in 18/21 stats sections,10
+testimonial,margin_top,range,Margin Top,,True,Appears in 100/254 testimonial sections,1
+testimonial,margin_bottom,range,Margin Bottom,,True,Appears in 100/254 testimonial sections,2
+testimonial,title,text,Title,,True,Appears in 59/254 testimonial sections,3
+testimonial,section_title,text,Section Title,,False,Appears in 56/254 testimonial sections,4
+testimonial,background_color,color,Background Color,,False,Appears in 40/254 testimonial sections,5
+testimonial,margin,range,Margin,,False,Appears in 36/254 testimonial sections,6
+testimonial,testimonial_bg,text,Testimonial Bg,,False,Appears in 35/254 testimonial sections,7
+testimonial,full,text,Full,,False,Appears in 34/254 testimonial sections,8
+testimonial,arrows,text,Arrows,,False,Appears in 33/254 testimonial sections,9
+testimonial,dots,text,Dots,,False,Appears in 32/254 testimonial sections,10
+video,title,text,Title,,True,Appears in 30/68 video sections,1
+video,margin_top,range,Margin Top,,True,Appears in 25/68 video sections,2
+video,margin_bottom,range,Margin Bottom,,True,Appears in 25/68 video sections,3
+video,video_bg,video_url,Video Bg,,False,Appears in 22/68 video sections,4
+video,section_video_url,url,Section Video Url,,False,Appears in 22/68 video sections,5
+video,video_url,url,Video Url,,False,Appears in 21/68 video sections,6
+video,image,image_picker,Image,,False,Appears in 12/68 video sections,7
+video,sub_title,text,Sub Title,,False,Appears in 11/68 video sections,8
+video,button_1,text,Button 1,,False,Appears in 10/68 video sections,9
+video,url_banner,url,Url Banner,,False,Appears in 10/68 video sections,10

package/assets/data/shopify-best-practices.csv

@@ -1,36 +1,58 @@
-No,Rule,Category,Severity,Keywords,Description,Do,Dont,Code Example
-1,Use JSON templates,os2-architecture,critical,"json templates os2 sections theme editor","OS2.0 themes must use JSON templates for section-based customization","Use .json template files in /templates/","Use .liquid template files for page templates",""
-2,Presets required,os2-architecture,critical,"presets theme editor add section visibility","Every section must have non-empty presets array for Theme Editor visibility","Include presets: [{name: 'Section Name'}]","Omit presets array from schema",""
-3,Use render not include,performance,critical,"render include snippet partial performance deprecated","render tag is isolated and faster; include is deprecated and shares scope","{% render 'snippet' %}","{% include 'snippet' %}",""
-4,block.shopify_attributes required,schema,critical,"block attributes theme editor interaction click targeting","All block wrapper elements must include block.shopify_attributes for Theme Editor click targeting","<div {{ block.shopify_attributes }}>","<div class='block'>",""
-5,App blocks support,os2-architecture,high,"app blocks third-party extension type app","Include @app block type to allow third-party app integrations","blocks: [{ type: '@app' }]","Omit @app from blocks array",""
-6,Scope CSS to section ID,css,critical,"css scope section id specificity conflict leakage","CSS must be scoped to section ID to prevent style leakage across sections","#shopify-section-{{ section.id }} .title {}",".title { color: red; }",""
-7,Lazy load images,images,high,"lazy load image performance lcp loading attribute","Use loading=lazy on all images except hero/above-fold to improve performance","<img loading='lazy' src='...' alt='...'>","<img src='...' alt='...'>",""
-8,Always include alt text,accessibility,critical,"alt text image accessibility screen reader a11y","All images must have descriptive alt text for screen reader accessibility","<img src='...' alt='{{ block.settings.image_alt | escape }}'>","<img src='...'>",""
-9,Use semantic HTML,accessibility,high,"semantic html heading landmark section article a11y","Use proper semantic HTML elements for accessibility and SEO","<section>, <article>, <h2>, <nav>","<div class='section'>, <div class='heading'>",""
-10,ARIA labels for interactive elements,accessibility,high,"aria label button link interactive element a11y wcag","Interactive elements without visible text must have aria-label","<button aria-label='Close menu'>X</button>","<button>X</button>",""
-11,Limit section settings,schema,high,"settings count performance theme editor limit","Sections should have 20 or fewer settings to keep Theme Editor manageable","Group related settings into blocks","Add every possible setting to section-level schema",""
-12,Use image_picker with width/height,images,high,"image_picker width height aspect ratio responsive","Always pair image_picker with width and height settings for responsive images","Add image_width and image_height number settings","Use fixed pixel dimensions in CSS only",""
-13,Responsive images with image_url,images,high,"image_url responsive srcset width filter shopify cdn","Use Shopify image_url filter with width parameter for responsive images","{{ image | image_url: width: 800 }}","{{ image.src }}",""
-14,No hardcoded colors,css,high,"hardcoded color hex rgb css variable token design system","Use CSS variables or design tokens instead of hardcoded color values","color: var(--color-foreground)","color: #333333",""
-15,Mobile-first CSS,css,high,"mobile first responsive breakpoint media query min-width","Write base styles for mobile, use min-width media queries for larger screens","@media (min-width: 750px) { ... }","@media (max-width: 750px) { ... }",""
-16,Defer non-critical JavaScript,javascript,high,"defer javascript performance async non-critical load","Non-critical JS should use defer or async attribute to avoid render blocking","<script src='...' defer>","<script src='...'>",""
-17,Use section.settings not hardcoded text,schema,critical,"section settings hardcoded text content customizable","All user-facing text must come from schema settings, not hardcoded in Liquid","{{ section.settings.heading }}","<h2>Our Products</h2>",""
-18,Unique section IDs,schema,high,"section id unique namespace conflict css js","Use section.id to namespace CSS and JS to avoid conflicts between section instances","section-{{ section.id }}","my-section",""
-19,Color scheme support,os2-architecture,high,"color scheme picker background foreground os2 theme editor","Sections should support color_scheme setting for theme-wide color customization","Include color_scheme setting with type: color_scheme","Hardcode background and text colors",""
-20,Keyboard navigation support,accessibility,high,"keyboard navigation focus tab order interactive a11y wcag","All interactive elements must be keyboard accessible with visible focus states","button:focus-visible { outline: 2px solid; }","button:focus { outline: none; }",""
-21,Use aspect-ratio CSS,images,high,"aspect ratio css image video embed responsive layout shift","Use CSS aspect-ratio to prevent layout shift while images load","aspect-ratio: 16 / 9","Use padding-top hack for aspect ratio",""
-22,Limit block types to 16,schema,high,"block types limit maximum theme editor performance","Sections should have no more than 16 block types defined in schema","Keep block types focused and minimal","Add many redundant block type variations",""
-23,Enable section everywhere,os2-architecture,high,"enabled on templates json section groups everywhere","Sections should work in section groups to appear on any page template","Add section to section groups in JSON templates","Hardcode section to specific template only",""
-24,Preload hero images,performance,high,"preload hero image lcp performance above-fold critical resource","Hero/above-fold images should use fetchpriority=high and preload link","<img fetchpriority='high' loading='eager' ...>","<img loading='lazy' ...> for hero images",""
-25,Minify inline JavaScript,javascript,high,"minify javascript inline performance whitespace","Inline JS in sections should be minimal and deferred to external files when possible","Use external JS files loaded via defer","Write large inline <script> blocks in section files",""
-26,Use content_for_index,os2-architecture,high,"content_for_index homepage sections index json template","Homepage template must use content_for_index tag instead of hardcoded sections","{% content_for_index %}","{% section 'featured-products' %}",""
-27,Valid JSON schema,schema,critical,"json schema valid syntax parse error theme editor crash","Section schema must be valid JSON or the Theme Editor will fail to load","Validate JSON with a linter before deploying","Write schema JSON without validation",""
-28,Translatable strings,seo,high,"t translation i18n locale string shopify translate","User-facing strings should use Shopify translation filters for multi-language support","{{ 'sections.hero.title' | t }}","{{ 'Welcome to our store' }}",""
-29,Structured data for SEO,seo,high,"structured data json-ld schema org seo rich snippets","Add JSON-LD structured data to relevant sections like product and article","<script type='application/ld+json'>...</script>","Skip structured data markup",""
-30,forloop.index for unique IDs,schema,high,"forloop index unique id accessibility aria html attribute","Use forloop.index to generate unique IDs when rendering blocks in loops","id='tab-{{ forloop.index }}'","id='tab-1' hardcoded",""
-31,Avoid liquid in CSS files,css,high,"liquid css performance dynamic styles inline style attribute","Avoid using Liquid variables in .css files; use CSS variables set via inline styles","style='--color: {{ settings.color }}'","Liquid in .css asset files",""
-32,Use paginate for long lists,performance,high,"paginate pagination collection loop performance limit","Use Shopify paginate tag for collection loops to avoid loading all products","{% paginate collection.products by 12 %}","{% for product in collection.products %}",""
-33,section.blocks loop order,schema,high,"blocks loop order theme editor drag drop sortable","Always loop blocks via section.blocks to respect Theme Editor sort order","{% for block in section.blocks %}","Hardcode block rendering order",""
-34,Lazy-load videos,performance,high,"video lazy load autoplay performance bandwidth","Videos should be lazy-loaded and not autoplay with sound by default","<video loading='lazy' muted autoplay playsinline>","<video autoplay>",""
-35,Remove unused assets,performance,high,"unused assets css javascript dead code performance bundle size","Remove unused CSS and JS assets to reduce page weight and improve load time","Audit and remove unused snippet files and assets","Leave unused Liquid snippets and JS files in theme",""
+No,Rule,Category,Severity,Keywords,Description,Do,Dont,Code Example
+1,Use JSON templates,os2-architecture,critical,json templates os2 sections theme editor,OS2.0 themes must use JSON templates for section-based customization,Use .json template files in /templates/,Use .liquid template files for page templates,
+2,Presets required,os2-architecture,critical,presets theme editor add section visibility,Every section must have non-empty presets array for Theme Editor visibility,Include presets: [{name: 'Section Name'}],Omit presets array from schema,
+3,Use render not include,performance,critical,render include snippet partial performance deprecated,render tag is isolated and faster; include is deprecated and shares scope,{% render 'snippet' %},{% include 'snippet' %},
+4,block.shopify_attributes required,schema,critical,block attributes theme editor interaction click targeting,All block wrapper elements must include block.shopify_attributes for Theme Editor click targeting,<div {{ block.shopify_attributes }}>,<div class='block'>,
+5,App blocks support,os2-architecture,high,app blocks third-party extension type app,Include @app block type to allow third-party app integrations,blocks: [{ type: '@app' }],Omit @app from blocks array,
+6,Scope CSS to section ID,css,critical,css scope section id specificity conflict leakage,CSS must be scoped to section ID to prevent style leakage across sections,#shopify-section-{{ section.id }} .title {},.title { color: red; },
+7,Lazy load images,images,high,lazy load image performance lcp loading attribute,Use loading=lazy on all images except hero/above-fold to improve performance,<img loading='lazy' src='...' alt='...'>,<img src='...' alt='...'>,
+8,Always include alt text,accessibility,critical,alt text image accessibility screen reader a11y,All images must have descriptive alt text for screen reader accessibility,<img src='...' alt='{{ block.settings.image_alt | escape }}'>,<img src='...'>,
+9,Use semantic HTML,accessibility,high,semantic html heading landmark section article a11y,Use proper semantic HTML elements for accessibility and SEO,"<section>, <article>, <h2>, <nav>","<div class='section'>, <div class='heading'>",
+10,ARIA labels for interactive elements,accessibility,high,aria label button link interactive element a11y wcag,Interactive elements without visible text must have aria-label,<button aria-label='Close menu'>X</button>,<button>X</button>,
+11,Limit section settings,schema,high,settings count performance theme editor limit,Sections should have 20 or fewer settings to keep Theme Editor manageable,Group related settings into blocks,Add every possible setting to section-level schema,
+12,Use image_picker with width/height,images,high,image_picker width height aspect ratio responsive,Always pair image_picker with width and height settings for responsive images,Add image_width and image_height number settings,Use fixed pixel dimensions in CSS only,
+13,Responsive images with image_url,images,high,image_url responsive srcset width filter shopify cdn,Use Shopify image_url filter with width parameter for responsive images,{{ image | image_url: width: 800 }},{{ image.src }},
+14,No hardcoded colors,css,high,hardcoded color hex rgb css variable token design system,Use CSS variables or design tokens instead of hardcoded color values,color: var(--color-foreground),color: #333333,
+15,Mobile-first CSS,css,high,mobile first responsive breakpoint media query min-width,"Write base styles for mobile, use min-width media queries for larger screens",@media (min-width: 750px) { ... },@media (max-width: 750px) { ... },
+16,Defer non-critical JavaScript,javascript,high,defer javascript performance async non-critical load,Non-critical JS should use defer or async attribute to avoid render blocking,<script src='...' defer>,<script src='...'>,
+17,Use section.settings not hardcoded text,schema,critical,section settings hardcoded text content customizable,"All user-facing text must come from schema settings, not hardcoded in Liquid",{{ section.settings.heading }},<h2>Our Products</h2>,
+18,Unique section IDs,schema,high,section id unique namespace conflict css js,Use section.id to namespace CSS and JS to avoid conflicts between section instances,section-{{ section.id }},my-section,
+19,Color scheme support,os2-architecture,high,color scheme picker background foreground os2 theme editor,Sections should support color_scheme setting for theme-wide color customization,Include color_scheme setting with type: color_scheme,Hardcode background and text colors,
+20,Keyboard navigation support,accessibility,high,keyboard navigation focus tab order interactive a11y wcag,All interactive elements must be keyboard accessible with visible focus states,button:focus-visible { outline: 2px solid; },button:focus { outline: none; },
+21,Use aspect-ratio CSS,images,high,aspect ratio css image video embed responsive layout shift,Use CSS aspect-ratio to prevent layout shift while images load,aspect-ratio: 16 / 9,Use padding-top hack for aspect ratio,
+22,Limit block types to 16,schema,high,block types limit maximum theme editor performance,Sections should have no more than 16 block types defined in schema,Keep block types focused and minimal,Add many redundant block type variations,
+23,Enable section everywhere,os2-architecture,high,enabled on templates json section groups everywhere,Sections should work in section groups to appear on any page template,Add section to section groups in JSON templates,Hardcode section to specific template only,
+24,Preload hero images,performance,high,preload hero image lcp performance above-fold critical resource,Hero/above-fold images should use fetchpriority=high and preload link,<img fetchpriority='high' loading='eager' ...>,<img loading='lazy' ...> for hero images,
+25,Minify inline JavaScript,javascript,high,minify javascript inline performance whitespace,Inline JS in sections should be minimal and deferred to external files when possible,Use external JS files loaded via defer,Write large inline <script> blocks in section files,
+26,Use content_for_index,os2-architecture,high,content_for_index homepage sections index json template,Homepage template must use content_for_index tag instead of hardcoded sections,{% content_for_index %},{% section 'featured-products' %},
+27,Valid JSON schema,schema,critical,json schema valid syntax parse error theme editor crash,Section schema must be valid JSON or the Theme Editor will fail to load,Validate JSON with a linter before deploying,Write schema JSON without validation,
+28,Translatable strings,seo,high,t translation i18n locale string shopify translate,User-facing strings should use Shopify translation filters for multi-language support,{{ 'sections.hero.title' | t }},{{ 'Welcome to our store' }},
+29,Structured data for SEO,seo,high,structured data json-ld schema org seo rich snippets,Add JSON-LD structured data to relevant sections like product and article,<script type='application/ld+json'>...</script>,Skip structured data markup,
+30,forloop.index for unique IDs,schema,high,forloop index unique id accessibility aria html attribute,Use forloop.index to generate unique IDs when rendering blocks in loops,id='tab-{{ forloop.index }}',id='tab-1' hardcoded,
+31,Avoid liquid in CSS files,css,high,liquid css performance dynamic styles inline style attribute,Avoid using Liquid variables in .css files; use CSS variables set via inline styles,style='--color: {{ settings.color }}',Liquid in .css asset files,
+32,Use paginate for long lists,performance,high,paginate pagination collection loop performance limit,Use Shopify paginate tag for collection loops to avoid loading all products,{% paginate collection.products by 12 %},{% for product in collection.products %},
+33,section.blocks loop order,schema,high,blocks loop order theme editor drag drop sortable,Always loop blocks via section.blocks to respect Theme Editor sort order,{% for block in section.blocks %},Hardcode block rendering order,
+34,Lazy-load videos,performance,high,video lazy load autoplay performance bandwidth,Videos should be lazy-loaded and not autoplay with sound by default,<video loading='lazy' muted autoplay playsinline>,<video autoplay>,
+35,Remove unused assets,performance,high,unused assets css javascript dead code performance bundle size,Remove unused CSS and JS assets to reduce page weight and improve load time,Audit and remove unused snippet files and assets,Leave unused Liquid snippets and JS files in theme,
+36,Block shopify_attributes,blocks,critical,block shopify_attributes wrapper attributes,All block wrapper elements must include block.shopify_attributes for editor integration,Add {{ block.shopify_attributes }} to every block wrapper div,Omit shopify_attributes from block wrappers,
+37,Block type limit,blocks,important,block limit max_blocks count,Set explicit max_blocks to prevent excessive block additions,Set max_blocks: 16 for typical repeatable content,Allow unlimited blocks (default 50) for UI-heavy sections,
+38,Block name clarity,blocks,recommended,block name label descriptive,Use descriptive block type names visible in theme editor,"Use type: ""testimonial"" name: ""Testimonial""","Use cryptic block type names like ""item1"" or ""block""",
+39,App block support,blocks,important,app block @app third party extension,Include @app block type to allow third-party app injection,"Add {""type"": ""@app""} to blocks array",Omit @app blocks — limits merchant customization,
+40,Image srcset responsive,performance,critical,image srcset responsive sizes width,Use srcset and sizes attributes for responsive images,Use image_url with width param + srcset for responsive loading,Use fixed-size images without srcset,
+41,Preload above-fold,performance,important,preload hero above fold LCP critical,Preload hero/above-fold images for faster LCP,"Add fetchpriority=""high"" to hero images",Lazy-load hero images,
+42,Font display swap,performance,important,font display swap loading custom fonts,Use font-display: swap for custom fonts to prevent FOIT,Set font-display: swap in @font-face declarations,Use font-display: block which delays text rendering,
+43,Defer non-critical JS,performance,important,defer javascript async script non-critical,Defer non-essential JavaScript to avoid blocking render,Use defer attribute or load scripts at end of body,Put heavy JS in <head> without defer,
+44,No Liquid in CSS/JS,performance,critical,liquid css javascript style script inline,Never use Liquid tags inside CSS or JS — prevents caching,Use CSS custom properties set via inline style attribute,Use {{ settings.color }} inside <style> blocks,
+45,Aria labels interactive,accessibility,critical,aria label button link interactive accessible a11y,All interactive elements must have accessible names,Add aria-label to icon-only buttons and links,Use icon-only buttons without text or aria-label,
+46,Focus visible styles,accessibility,important,focus visible outline keyboard navigation a11y,Ensure visible focus indicators for keyboard navigation,Style :focus-visible with visible outline or ring,Remove focus outlines with outline: none,
+47,Color contrast ratio,accessibility,important,color contrast WCAG ratio text background a11y,Maintain 4.5:1 contrast ratio for text on backgrounds,Test color combinations against WCAG 2.1 AA standards,Use low-contrast text like light gray on white,
+48,Semantic heading hierarchy,accessibility,important,heading hierarchy h1 h2 h3 semantic structure,Use proper heading hierarchy — no skipping levels,Use h1 > h2 > h3 in logical document order,Use h3 inside a section when h2 has not been used,
+49,Alt text images,accessibility,critical,alt text image description screen reader a11y,All content images must have descriptive alt text,Use image.alt or provide fallback alt text setting,"Leave alt="""" on content images (only valid for decorative)",
+50,Structured data JSON-LD,seo,recommended,structured data schema.org json-ld rich snippets,"Add JSON-LD structured data for products, articles, FAQs","Include <script type=""application/ld+json""> with schema.org markup",Rely solely on meta tags without structured data,
+51,Heading per section,seo,important,heading h2 section title SEO crawl hierarchy,Each section should have a configurable heading element,Use a heading_tag setting (h2/h3/h4) for section headings,Hardcode heading levels — breaks hierarchy across sections,
+52,Image alt from settings,seo,important,image alt text setting SEO accessible,Provide alt text settings or use Shopify image.alt,"Output alt=""{{ section.settings.image.alt | escape }}""",Omit alt attributes on section images,
+53,Typography controls required,schema,high,"font_picker heading typography control",Sections with heading text should include font_picker setting,Include font_picker setting for primary heading,Hardcode font-family in CSS only,
+54,Heading tag configurable,seo,high,"heading tag h1 h2 h3 SEO hierarchy select",Heading level must be configurable via select setting for SEO,Add heading_tag select setting (h1/h2/h3/h4),Hardcode <h1> or <h2> without merchant control,
+55,Color scheme over color picker,os2-architecture,high,"color_scheme color picker theme consistency",Prefer color_scheme setting over individual color pickers for theme consistency,Use type: color_scheme for section colors,Use individual color pickers for every color,
+56,Button styling controls,schema,high,"button style color background CTA",CTA buttons should have configurable style/color settings,Add button_style select and button color settings,Hardcode button background and text colors,
+57,No hardcoded font sizes,css,high,"font size hardcoded clamp responsive typography",Font sizes should use clamp() or CSS vars — never fixed px,Use clamp() or CSS custom properties for font-size,Use fixed px values like font-size: 48px,

package/assets/scripts/backfill-component-index.py

@@ -0,0 +1,102 @@
+#!/usr/bin/env python3
+"""Backfill _index.csv with entries for all .liquid files in component-library/.
+
+Scans all *.liquid files, parses schema, generates index rows for files
+not already present in _index.csv. Preserves existing rows unchanged.
+"""
+
+import csv
+import importlib.util
+import sys
+from pathlib import Path
+
+# Dynamic import of kb-builder for classify/score functions
+_scripts = Path(__file__).parent
+_spec = importlib.util.spec_from_file_location('kb_builder', _scripts / 'kb-builder.py')
+_mod = importlib.util.module_from_spec(_spec)
+_spec.loader.exec_module(_mod)
+parse_liquid_section = _mod.parse_liquid_section
+classify_section = _mod.classify_section
+score_completeness = _mod.score_completeness
+extract_ui_style_keywords = _mod.extract_ui_style_keywords
+
+INDEX_FIELDNAMES = [
+    'No', 'Name', 'Slug', 'Category', 'Keywords', 'Difficulty',
+    'Blocks Used', 'Settings Count', 'ui_style_keywords', 'File',
+    'Description', 'Completeness', 'Has Presets', 'Has App Block'
+]
+
+
+def backfill(data_dir: Path):
+    """Scan component-library/ and add missing entries to _index.csv."""
+    component_dir = data_dir / 'component-library'
+    index_path = component_dir / '_index.csv'
+
+    # Load existing index slugs
+    existing = {}
+    max_no = 0
+    if index_path.exists():
+        with open(index_path, newline='', encoding='utf-8') as f:
+            for row in csv.DictReader(f):
+                slug = row.get('Slug', '')
+                if slug:
+                    existing[slug] = row
+                    try:
+                        max_no = max(max_no, int(row.get('No', 0)))
+                    except (ValueError, TypeError):
+                        pass
+
+    # Find all .liquid files not in index
+    liquid_files = sorted(component_dir.glob('*.liquid'))
+    added = 0
+
+    for lf in liquid_files:
+        slug = lf.stem
+        if slug in existing:
+            continue
+
+        parsed = parse_liquid_section(lf)
+        if parsed:
+            section_type = parsed['section_type']
+            completeness = parsed['completeness']
+            schema_name = parsed['schema_name']
+        else:
+            # Fallback for files without valid schema
+            section_type = classify_section(slug, slug)
+            completeness = 0
+            schema_name = slug.replace('-', ' ').title()
+
+        max_no += 1
+        existing[slug] = {
+            'No': max_no,
+            'Name': schema_name,
+            'Slug': slug,
+            'Category': section_type,
+            'Keywords': f"{slug.replace('-', ' ')} {section_type}",
+            'Difficulty': 'intermediate',
+            'Blocks Used': parsed['blocks_used'] if parsed else '',
+            'Settings Count': parsed['settings_count'] if parsed else 0,
+            'ui_style_keywords': parsed['ui_style_keywords'] if parsed else slug.replace('-', ' '),
+            'File': f"{slug}.liquid",
+            'Description': f"{schema_name} section",
+            'Completeness': completeness,
+            'Has Presets': str(parsed['has_presets']) if parsed else 'False',
+            'Has App Block': str(parsed['has_app_block']) if parsed else 'False',
+        }
+        added += 1
+
+    # Rewrite index with all entries (sorted by No)
+    rows = sorted(existing.values(), key=lambda r: int(r.get('No', 0) or 0))
+    with open(index_path, 'w', newline='', encoding='utf-8') as f:
+        writer = csv.DictWriter(f, fieldnames=INDEX_FIELDNAMES)
+        writer.writeheader()
+        writer.writerows(rows)
+
+    total = len(rows)
+    print(f"Backfill complete: {added} new entries added, {total} total in index")
+
+
+if __name__ == '__main__':
+    default_data = Path(__file__).parent.parent / 'data'
+    data_dir = Path(sys.argv[1]) if len(sys.argv) > 1 else default_data
+    backfill(data_dir)

package/assets/scripts/core.py

@@ -4,6 +4,7 @@
 
 import csv
 import re
+import sys
 from pathlib import Path
 from math import log
 from collections import defaultdict
@@ -41,6 +42,16 @@ CSV_CONFIG = {
         "file": "shopify-best-practices.csv",
         "search_cols": ["Rule", "Category", "Keywords", "Description"],
         "output_cols": ["Rule", "Category", "Severity", "Description", "Do", "Dont", "Code Example"]
+    },
+    "block-patterns": {
+        "file": "block-patterns.csv",
+        "search_cols": ["Category", "Block Type", "Common Settings", "Use Case"],
+        "output_cols": ["Category", "Block Type", "Common Settings", "Use Case", "JSON Example", "Frequency Rank"]
+    },
+    "settings-profiles": {
+        "file": "settings-profiles.csv",
+        "search_cols": ["Section Type", "Setting ID", "Notes"],
+        "output_cols": ["Section Type", "Setting ID", "Setting Type", "Label", "Default", "Required", "Notes", "Frequency Rank"]
     }
 }
 
@@ -114,7 +125,7 @@ def _load_csv(filepath):
         return list(csv.DictReader(f))
 
 
-def _search_csv(filepath, search_cols, output_cols, query, max_results):
+def _search_csv(filepath, search_cols, output_cols, query, max_results, min_score=0.0):
     """Core search function using BM25"""
     if not filepath.exists():
         return []
@@ -126,11 +137,20 @@ def _search_csv(filepath, search_cols, output_cols, query, max_results):
     bm25.fit(documents)
     ranked = bm25.score(query)
 
+    # Filter by min_score threshold
+    candidates = [(idx, score) for idx, score in ranked[:max_results * 2] if score > 0]
+    if min_score > 0:
+        filtered = [(idx, score) for idx, score in candidates if score >= min_score]
+        if len(candidates) != len(filtered):
+            print(f"[DEBUG] BM25: filtered {len(candidates) - len(filtered)} low-score results (threshold={min_score})", file=sys.stderr)
+        candidates = filtered
+
     results = []
-    for idx, score in ranked[:max_results]:
-        if score > 0:
-            row = data[idx]
-            results.append({col: row.get(col, "") for col in output_cols if col in row})
+    for idx, score in candidates[:max_results]:
+        row = data[idx]
+        entry = {col: row.get(col, "") for col in output_cols if col in row}
+        entry['_score'] = score
+        results.append(entry)
 
     return results
 
@@ -142,7 +162,9 @@ domain_keywords = {
     "tokens": ["token", "spacing", "color", "font", "breakpoint", "shadow", "variable", "css var", "design token"],
     "components": ["section", "hero", "testimonial", "faq", "product grid", "cta", "newsletter", "gallery", "feature", "component", "pattern"],
     "themes": ["theme", "dawn", "impulse", "impact", "craft", "detect", "dna", "theme profile"],
-    "practices": ["best practice", "performance", "accessibility", "seo", "os2", "lazy load", "responsive", "a11y"]
+    "practices": ["best practice", "performance", "accessibility", "seo", "os2", "lazy load", "responsive", "a11y"],
+    "block-patterns": ["block", "blocks", "block type", "block config", "block pattern", "block setting"],
+    "settings-profiles": ["profile", "settings profile", "recommended settings", "section settings", "setting profile"]
 }
 
 
@@ -154,7 +176,7 @@ def detect_domain(query):
     return best if scores[best] > 0 else "components"
 
 
-def search(query, domain=None, max_results=MAX_RESULTS):
+def search(query, domain=None, max_results=MAX_RESULTS, min_score=0.0):
     """Main search function with auto-domain detection"""
     if domain is None:
         domain = detect_domain(query)
@@ -165,7 +187,7 @@ def search(query, domain=None, max_results=MAX_RESULTS):
     if not filepath.exists():
         return {"error": f"File not found: {filepath}", "domain": domain}
 
-    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results)
+    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results, min_score=min_score)
 
     return {
         "domain": domain,

package/assets/scripts/fix-schema-library.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+"""One-time script to remove filler stub rows from schema-library.csv.
+
+Keeps only rows where the 'No' field is a valid integer (real data rows).
+Rows like 'header,basic,,,,,...' have non-numeric 'No' values and are filler.
+"""
+
+import csv
+import sys
+from pathlib import Path
+
+
+def fix_schema_library(csv_path: Path):
+    """Read CSV, keep only rows with numeric 'No' field, rewrite file."""
+    rows = []
+    with open(csv_path, newline='', encoding='utf-8') as f:
+        reader = csv.DictReader(f)
+        fieldnames = reader.fieldnames
+        for row in reader:
+            no_val = row.get('No', '').strip()
+            try:
+                int(no_val)
+                rows.append(row)
+            except (ValueError, TypeError):
+                continue  # skip filler rows
+
+    with open(csv_path, 'w', newline='', encoding='utf-8') as f:
+        writer = csv.DictWriter(f, fieldnames=fieldnames)
+        writer.writeheader()
+        writer.writerows(rows)
+
+    print(f"Kept {len(rows)} data rows (removed filler stubs)")
+    print(f"Total lines: {len(rows) + 1} (header + data)")
+
+
+if __name__ == '__main__':
+    default_path = Path(__file__).parent.parent / 'data' / 'schema-library.csv'
+    csv_path = Path(sys.argv[1]) if len(sys.argv) > 1 else default_path
+    if not csv_path.exists():
+        print(f"File not found: {csv_path}")
+        sys.exit(1)
+    fix_schema_library(csv_path)