rahman-resources 0.13.0 → 1.2.0

package/lib/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generatedAt": "2026-05-15T05:11:02.213Z",
+  "generatedAt": "2026-05-16T12:03:28.553Z",
   "repo": "rahmanef63/resource-site",
   "branch": "main",
   "layouts": [
@@ -802,6 +802,456 @@
         "indonesia"
       ],
       "primaryFile": "app/preview/riset-kit/public/page.tsx"
+    },
+    {
+      "slug": "hero-centered",
+      "title": "Hero — Centered",
+      "category": "marketing",
+      "description": "Single-column centered hero with eyebrow pill, headline, sub-copy, and dual CTA. Radial gradient backdrop.",
+      "source": "kitab",
+      "repoPath": "app/preview/hero-centered",
+      "pullPaths": [
+        "app/preview/hero-centered"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Pure layout. Drop into landing pages where the product needs minimum framing. Replace the eyebrow pill with a status badge or release tag. Two CTAs is the sweet spot.",
+      "tags": [
+        "block",
+        "hero",
+        "centered",
+        "marketing"
+      ],
+      "primaryFile": "app/preview/hero-centered/page.tsx"
+    },
+    {
+      "slug": "hero-split",
+      "title": "Hero — Split (Text + Visual)",
+      "category": "marketing",
+      "description": "Two-column hero: left copy + feature list + CTAs, right visual slot. 9-cell mock grid placeholder for product shot.",
+      "source": "kitab",
+      "repoPath": "app/preview/hero-split",
+      "pullPaths": [
+        "app/preview/hero-split"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Right column accepts any visual — screenshot, product mock, illustration, or live demo iframe. Feature list pairs Lucide icons with one-line value props.",
+      "tags": [
+        "block",
+        "hero",
+        "split",
+        "marketing",
+        "product"
+      ],
+      "primaryFile": "app/preview/hero-split/page.tsx"
+    },
+    {
+      "slug": "hero-bento-bg",
+      "title": "Hero — Bento Background",
+      "category": "marketing",
+      "description": "Bento mini-grid behind a centered headline. Radial mask focuses the eye on the copy while the grid hints at features.",
+      "source": "kitab",
+      "repoPath": "app/preview/hero-bento-bg",
+      "pullPaths": [
+        "app/preview/hero-bento-bg"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Background tiles get a radial mask so the center stays readable. Use 6-8 tiles with asymmetric spans (col-span-2 row-span-2 for one, others 1x1). Lucide icon in each tile.",
+      "tags": [
+        "block",
+        "hero",
+        "bento",
+        "marketing",
+        "decorative"
+      ],
+      "primaryFile": "app/preview/hero-bento-bg/page.tsx"
+    },
+    {
+      "slug": "hero-video-loop",
+      "title": "Hero — Video Loop (dark)",
+      "category": "marketing",
+      "description": "Dark-mode hero with conic-gradient animated backdrop (stand-in for video). Play CTA, headline, dual CTA.",
+      "source": "kitab",
+      "repoPath": "app/preview/hero-video-loop",
+      "pullPaths": [
+        "app/preview/hero-video-loop"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Replace the conic-gradient backdrop with a muted <video autoplay loop>. Keep the dark theme — light text on motion only reads when the contrast is hard.",
+      "tags": [
+        "block",
+        "hero",
+        "video",
+        "marketing",
+        "dark"
+      ],
+      "primaryFile": "app/preview/hero-video-loop/page.tsx"
+    },
+    {
+      "slug": "hero-animated-text",
+      "title": "Hero — Animated Text",
+      "category": "marketing",
+      "description": "Rotating word inside the headline cycles every 2s with gradient text + fade-slide transition. Lightweight, no extra deps.",
+      "source": "kitab",
+      "repoPath": "app/preview/hero-animated-text",
+      "pullPaths": [
+        "app/preview/hero-animated-text"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use absolute-positioned word slots with translate-y + opacity transitions. The invisible placeholder word keeps the bounding box stable.",
+      "tags": [
+        "block",
+        "hero",
+        "motion",
+        "marketing",
+        "kinetic"
+      ],
+      "primaryFile": "app/preview/hero-animated-text/page.tsx"
+    },
+    {
+      "slug": "pricing-three",
+      "title": "Pricing — Three Tier",
+      "category": "marketing",
+      "description": "Classic 3-tier card layout. Middle tier highlighted with Most Popular badge + soft shadow.",
+      "source": "kitab",
+      "repoPath": "app/preview/pricing-three",
+      "pullPaths": [
+        "app/preview/pricing-three"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Three is the magic number for SaaS pricing — fewer feels limited, more triggers analysis paralysis. Middle tier should be the one you actually want to sell.",
+      "tags": [
+        "block",
+        "pricing",
+        "marketing",
+        "saas"
+      ],
+      "primaryFile": "app/preview/pricing-three/page.tsx"
+    },
+    {
+      "slug": "pricing-four",
+      "title": "Pricing — Four Tier",
+      "category": "marketing",
+      "description": "Four-tier with Best Value badge on tier 3. Compact card chrome, 4-column grid that collapses gracefully.",
+      "source": "kitab",
+      "repoPath": "app/preview/pricing-four",
+      "pullPaths": [
+        "app/preview/pricing-four"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use when you genuinely have four distinct tiers (free / solo / team / enterprise). Don't pad to four — use the three-tier variant if the fourth is forced.",
+      "tags": [
+        "block",
+        "pricing",
+        "marketing",
+        "saas"
+      ],
+      "primaryFile": "app/preview/pricing-four/page.tsx"
+    },
+    {
+      "slug": "pricing-toggle",
+      "title": "Pricing — Monthly/Yearly Toggle",
+      "category": "marketing",
+      "description": "3-tier with a monthly/yearly pill toggle. Yearly price strikethroughs the monthly, -20% savings badge inside the toggle.",
+      "source": "kitab",
+      "repoPath": "app/preview/pricing-toggle",
+      "pullPaths": [
+        "app/preview/pricing-toggle"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Default to yearly — that's the conversion-optimized choice. Show the monthly strikethrough so the savings feel real, not implied.",
+      "tags": [
+        "block",
+        "pricing",
+        "marketing",
+        "interactive"
+      ],
+      "primaryFile": "app/preview/pricing-toggle/page.tsx"
+    },
+    {
+      "slug": "pricing-compare",
+      "title": "Pricing — Feature Comparison",
+      "category": "marketing",
+      "description": "Single comparison table: feature rows × plan columns. Check/Minus icons, header row with prices, sticky CTA row.",
+      "source": "kitab",
+      "repoPath": "app/preview/pricing-compare",
+      "pullPaths": [
+        "app/preview/pricing-compare"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use for complex products where buyers actually compare. Mix boolean rows (Check/Minus) with string-value rows (\"1\", \"10\", \"Unlimited\") for clarity.",
+      "tags": [
+        "block",
+        "pricing",
+        "marketing",
+        "comparison",
+        "table"
+      ],
+      "primaryFile": "app/preview/pricing-compare/page.tsx"
+    },
+    {
+      "slug": "pricing-slider",
+      "title": "Pricing — Usage Slider",
+      "category": "marketing",
+      "description": "Range slider drives the price. Tier name and per-seat cost update live. Single-card layout, focus on the math.",
+      "source": "kitab",
+      "repoPath": "app/preview/pricing-slider",
+      "pullPaths": [
+        "app/preview/pricing-slider"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use for usage-based or seat-based products. Make the breakpoints transparent — buyers should be able to predict the next price without surprises.",
+      "tags": [
+        "block",
+        "pricing",
+        "marketing",
+        "interactive",
+        "usage"
+      ],
+      "primaryFile": "app/preview/pricing-slider/page.tsx"
+    },
+    {
+      "slug": "accordion-faq",
+      "title": "Accordion — Classic FAQ",
+      "category": "marketing",
+      "description": "Single-open FAQ accordion. ChevronDown rotates, content reveals below. Clean, compact, perfect for support pages.",
+      "source": "kitab",
+      "repoPath": "app/preview/accordion-faq",
+      "pullPaths": [
+        "app/preview/accordion-faq"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Single-open keeps the page short. Use when answers are independent. Switch to multi-open if buyers tend to scan multiple answers at once.",
+      "tags": [
+        "block",
+        "accordion",
+        "faq",
+        "marketing"
+      ],
+      "primaryFile": "app/preview/accordion-faq/page.tsx"
+    },
+    {
+      "slug": "accordion-grouped",
+      "title": "Accordion — Grouped Sections",
+      "category": "marketing",
+      "description": "FAQ split into themed groups (Getting Started / Slices / Billing). Each group is its own card. Independent open state per item.",
+      "source": "kitab",
+      "repoPath": "app/preview/accordion-grouped",
+      "pullPaths": [
+        "app/preview/accordion-grouped"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use when the FAQ is long (>10 items) and questions cluster naturally. Each group's Item owns its open state for predictable UX.",
+      "tags": [
+        "block",
+        "accordion",
+        "faq",
+        "marketing",
+        "grouped"
+      ],
+      "primaryFile": "app/preview/accordion-grouped/page.tsx"
+    },
+    {
+      "slug": "accordion-sidebar",
+      "title": "Accordion — Sidebar Navigation",
+      "category": "marketing",
+      "description": "Docs-style: left nav switches sections, right pane shows the section's accordion. Two-axis navigation in one layout.",
+      "source": "kitab",
+      "repoPath": "app/preview/accordion-sidebar",
+      "pullPaths": [
+        "app/preview/accordion-sidebar"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use for help/docs pages with section breadth. Keep section count ≤ 5 — beyond that, the sidebar gets noisy. Reset accordion state on section change.",
+      "tags": [
+        "block",
+        "accordion",
+        "docs",
+        "sidebar",
+        "navigation"
+      ],
+      "primaryFile": "app/preview/accordion-sidebar/page.tsx"
+    },
+    {
+      "slug": "accordion-animated",
+      "title": "Accordion — Smooth Animated",
+      "category": "marketing",
+      "description": "Grid-row transition for true height animation, no janky calc. Each item is a rounded card with rotating plus → primary close icon.",
+      "source": "kitab",
+      "repoPath": "app/preview/accordion-animated",
+      "pullPaths": [
+        "app/preview/accordion-animated"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "The grid-template-rows trick lets CSS animate to-auto-height natively. No JS measurement, no jank. Pair with rounded card chrome for premium feel.",
+      "tags": [
+        "block",
+        "accordion",
+        "marketing",
+        "motion"
+      ],
+      "primaryFile": "app/preview/accordion-animated/page.tsx"
+    },
+    {
+      "slug": "accordion-multi",
+      "title": "Accordion — Multi-open",
+      "category": "marketing",
+      "description": "All items can be open at once. Expand-all / Collapse-all toggle in header. Best for compare-style reading.",
+      "source": "kitab",
+      "repoPath": "app/preview/accordion-multi",
+      "pullPaths": [
+        "app/preview/accordion-multi"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use when answers reference each other or buyers want to keep multiple sections visible (changelogs, release notes, feature comparison FAQs).",
+      "tags": [
+        "block",
+        "accordion",
+        "marketing",
+        "multi-open"
+      ],
+      "primaryFile": "app/preview/accordion-multi/page.tsx"
+    },
+    {
+      "slug": "blog-grid",
+      "title": "Blog — Card Grid",
+      "category": "cms",
+      "description": "3-column responsive card grid. Cover thumbnail (HSL gradient), title, excerpt, author·date·read meta. Default blog index shape.",
+      "source": "kitab",
+      "repoPath": "app/preview/blog-grid",
+      "pullPaths": [
+        "app/preview/blog-grid"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Default to 3 columns at lg. Use the Thumb helper for cover generation when posts don't ship an image yet — HSL gradient by post.hue keeps each card distinct.",
+      "tags": [
+        "block",
+        "blog",
+        "cms",
+        "grid"
+      ],
+      "primaryFile": "app/preview/blog-grid/page.tsx"
+    },
+    {
+      "slug": "blog-list",
+      "title": "Blog — Dense List",
+      "category": "cms",
+      "description": "Single-column scannable list. Thumbnail left, meta + title + excerpt right. High density, low scroll.",
+      "source": "kitab",
+      "repoPath": "app/preview/blog-list",
+      "pullPaths": [
+        "app/preview/blog-list"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use for archives or category pages where the reader is hunting a specific post. Compact thumbnail keeps the line height tight.",
+      "tags": [
+        "block",
+        "blog",
+        "cms",
+        "list"
+      ],
+      "primaryFile": "app/preview/blog-list/page.tsx"
+    },
+    {
+      "slug": "blog-magazine",
+      "title": "Blog — Magazine Layout",
+      "category": "cms",
+      "description": "Editorial spread: large hero post (2/3 width) + secondary featured + tail of headlines. Issue-number header gives quarterly feel.",
+      "source": "kitab",
+      "repoPath": "app/preview/blog-magazine",
+      "pullPaths": [
+        "app/preview/blog-magazine"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use for content-heavy publications. Hero post earns the visual real estate; the sidebar carries breadth. Mix typography sizes for editorial rhythm.",
+      "tags": [
+        "block",
+        "blog",
+        "cms",
+        "editorial",
+        "magazine"
+      ],
+      "primaryFile": "app/preview/blog-magazine/page.tsx"
+    },
+    {
+      "slug": "blog-masonry",
+      "title": "Blog — Masonry",
+      "category": "cms",
+      "description": "CSS columns-based masonry with varying card heights for organic rhythm. break-inside-avoid keeps each card intact.",
+      "source": "kitab",
+      "repoPath": "app/preview/blog-masonry",
+      "pullPaths": [
+        "app/preview/blog-masonry"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "CSS columns are the cheap masonry — no JS, no layout shift. Vary the thumbnail height via a HEIGHTS array (h-44 to h-80). DOM order ≠ visual order — design around it.",
+      "tags": [
+        "block",
+        "blog",
+        "cms",
+        "masonry"
+      ],
+      "primaryFile": "app/preview/blog-masonry/page.tsx"
+    },
+    {
+      "slug": "blog-featured",
+      "title": "Blog — Featured Hero + Tail",
+      "category": "cms",
+      "description": "Full-bleed cover hero on the first post, then a tight 2-column grid for the rest. Cinematic open, fast scroll for the tail.",
+      "source": "kitab",
+      "repoPath": "app/preview/blog-featured",
+      "pullPaths": [
+        "app/preview/blog-featured"
+      ],
+      "files": [],
+      "dependencies": [],
+      "shadcnComponents": [],
+      "agentRecipe": "Use for marketing-driven content sites (newsletter, podcast, brand journal) where the lead story carries the visit. Tail grid keeps the index scrollable without losing the hero impact.",
+      "tags": [
+        "block",
+        "blog",
+        "cms",
+        "featured",
+        "hero"
+      ],
+      "primaryFile": "app/preview/blog-featured/page.tsx"
     }
   ],
   "recipes": [],
@@ -937,7 +1387,7 @@
       "slug": "mdx-blog",
       "title": "MDX Blog",
       "category": "content",
-      "description": "Markdown-with-JSX untuk blog post. File-based under content/blog/*.mdx. Auto-generate ToC, reading-time, syntax highlight, plus embed React components inline.",
+      "description": "Markdown-with-JSX untuk blog post. File-based MDX content collection. Portable defineMdxBlog(opts) factory dengan 4 config props (basePath, contentDir, labels.list, nav) — defaults preserve legacy /blog + content/blog. Auto-generate ToC, reading-time, syntax highlight, plus embed React components inline.",
       "source": "rahmanef63/resource-site",
       "docsUrl": "https://github.com/hashicorp/next-mdx-remote",
       "install": "npm i next-mdx-remote rehype-pretty-code remark-gfm reading-time",
@@ -997,23 +1447,24 @@
     },
     {
       "slug": "command-menu",
-      "title": "Command Menu (⌘K)",
+      "title": "Command Menu",
       "category": "ui",
-      "description": "Global ⌘K command palette. Auto-builds entries from your feature registry (defineFeature) + custom actions. Fuzzy search via cmdk. Mount once at app shell; listens globally. Facade slice — pulls from template-base/frontend/slices/command-menu which re-exports shared/foundation/utils/system/command-menu.",
-      "source": "superspace + kitab-core",
+      "description": "Renderless ⌘K command palette + generic search modal. Consumer supplies CommandGroup[] + onSelect + label bag; slice owns dialog chrome, ⌘K hotkey, MRU history. Pulled UP from notion-page-clone's command-palette renderless surface (Wave N+3.7) — Nosion adapters dropped at the kitab boundary.",
+      "source": "notion-page-clone (consumerVersion 0.3.0) + earlier superspace facade",
       "docsUrl": "https://cmdk.paco.me",
       "install": "npm i cmdk",
       "npmPackages": [
         "cmdk"
       ],
       "exampleCode": "",
-      "agentRecipe": "Mount <CommandMenu actions={...} /> once at the dashboard shell level. Listens for Cmd+K globally. Actions auto-build from feature registry + workspace + theme/sign-out. Add custom commands via actions prop or by registering in command-registry.ts.",
+      "agentRecipe": "Wire <CommandPalette groups={...} onHistorySelect={...} labels={...} /> at the dashboard shell. Build groups from your feature registry; each item.onSelect handles navigation. Use <SearchModal bindings={{ pages, databases, recents, isLoading, onQueryChange, onSelectPage, onSelectDatabase }} /> for the search dialog — see slice README.md for adapter shapes.",
       "tags": [
         "ui",
         "palette",
         "cmd-k",
         "navigation",
-        "keyboard"
+        "keyboard",
+        "search"
       ]
     },
     {
@@ -1172,12 +1623,12 @@
       "slug": "icon-picker",
       "title": "Notion-Style Icon Picker",
       "category": "ui",
-      "description": "Emoji + lucide icon picker with search, 10-color Notion palette, Twemoji/native toggle. One string stores emoji OR lucide:Name OR with ?c=hex tint — backwards-compat with raw-emoji fields. Single icon field stores emoji or 'lucide:Name' plus optional '?c=hex'.",
+      "description": "Emoji + lucide icon picker with search, 10-color Notion palette, Twemoji/native toggle, recents tracking. One string stores emoji OR lucide:Name OR with ?c=hex tint — backwards-compat with raw-emoji fields. Two variants: Popover (compact trigger) and Inline (full sheet/dialog use). Lifted 2026-05-16 from notion-page-clone — full implementation (19 files) including emoji-keywords search index, twemoji renderer, lucide-catalog, recents store, style-pref hook.",
       "source": "notion-page-clone",
       "install": "npx rahman-resources add icon-picker",
       "npmPackages": [],
       "exampleCode": "",
-      "agentRecipe": "parseIconValue() decodes; lucideValue()/withColor() build. Add 'icon: v.string()' to Convex table — no migration needed for existing emoji fields. Popover variant for inline UI, Inline for sheets/dialogs.",
+      "agentRecipe": "Run `npx rr add icon-picker`. parseIconValue() decodes; lucideValue()/withColor() build. Add 'icon: v.string()' to Convex table — no migration needed for existing emoji fields. <IconPicker> wraps any trigger (Popover); <IconPickerInline> for sheets/dialogs. <DynamicIcon> renders from parsed value.",
       "tags": [
         "icon",
         "emoji",
@@ -1187,6 +1638,42 @@
         "notion"
       ]
     },
+    {
+      "slug": "cta",
+      "title": "Call to Action",
+      "category": "ui",
+      "description": "Brutalist call-to-action section — eyebrow label, serif headline, body, arrow CTA. Pair with CtaButton standalone for inline placements. Lifted 2026-05-16 from rahmanef.com; assumes Tailwind tracking-brutal / tracking-brutal-sm utilities OR drop them for the default tracking scale.",
+      "source": "rahmanef.com",
+      "install": "npx rahman-resources add cta",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add cta`. <CtaView eyebrow title body href ctaLabel /> renders the full section; <CtaButton href label /> drops a standalone arrow button anywhere. Override tracking-brutal utilities in tailwind.config or swap for tracking-wide if your design system has no brutal preset.",
+      "tags": [
+        "ui",
+        "marketing",
+        "cta",
+        "section",
+        "brutalist"
+      ]
+    },
+    {
+      "slug": "rate-limit",
+      "title": "Rate Limit",
+      "category": "infra",
+      "description": "Convex-backed per-key request counter. Atomic check-and-increment via `consume` mutation; expired rows pruned by `_pruneExpired` internalMutation wired to a 5-min cron. Replaces single-replica in-memory Map so multi-replica Next deployments share buckets. Caller chooses key namespace (csp:<ip>, mcp:<ip>, oauth_token:<ip>). Lifted 2026-05-16 from rahmanef.com.",
+      "source": "rahmanef.com",
+      "install": "npx rahman-resources add rate-limit",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `npx rr add rate-limit`. Compose `rateLimitTables` into root convex/schema.ts. Wire `internal.features.rate_limit.mutations._pruneExpired` into convex/crons.ts every 5 min. Call `api.features.rate_limit.mutations.consume({ key, limit, windowMs })` from server-side handlers — keep a fail-open wrapper so a Convex outage doesn't 503 the route.",
+      "tags": [
+        "infra",
+        "rate-limit",
+        "convex",
+        "backend",
+        "throttle"
+      ]
+    },
     {
       "slug": "contact-form-resend",
       "title": "Contact Form + Resend",
@@ -1208,17 +1695,36 @@
       "slug": "admin",
       "title": "Admin — Generic Shell",
       "category": "infra",
-      "description": "Landing page scaffold + Convex admin probe (isAdmin / counts). Consumer composes feature panels into the grid. Gated by requireAdmin on Convex side; superadmin email gate via SUPER_ADMIN_EMAIL env.",
+      "description": "Per-instance admin landing scaffold + portable nav-from-registry factory. Consumer supplies a SliceRegistryAdapter (each slice declares its own admin.activity[]) + queryTable reader; the slice's buildAdminStats(opts) emits the { counts, unreadMessages, activity } shape Convex's admin.stats query returns. Pulled UP from rahmanef.com (Wave N+3.1, commit b542389) — domain literals dropped at the kitab boundary. Gated by requireAdmin on Convex side; superadmin email gate via SUPER_ADMIN_EMAIL env.",
       "source": "rahmanef63/resource-site",
       "install": "npx rahman-resources add admin",
       "npmPackages": [],
       "exampleCode": "",
-      "agentRecipe": "Run `rr add admin`. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address.",
+      "agentRecipe": "Run `rr add admin`. Wire <AdminPage labels={...} /> at /admin and call buildAdminStats({ sliceRegistry, queryTable }) inside convex/features/admin/queries.ts — sliceRegistry.entries flat-maps each feature's admin.activity[] declarations. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address.",
       "tags": [
         "infra",
         "admin",
         "shell",
-        "crud"
+        "crud",
+        "nav-from-registry"
+      ]
+    },
+    {
+      "slug": "platform-admin",
+      "title": "Platform Admin — Multi-Tenant Control Plane",
+      "category": "infra",
+      "description": "Multi-tenant SaaS control plane. Workspace lifecycle ops (list/delete/cascade), per-tenant tier presets (gates + quota), KPI dashboard grid. Consumer-domain bits injected via adapter props (tenantTablesAdapter / tierPresets / kpiSources). Contract-only scaffold; canonical implementation lands via /rr-send from superspace. See docs/contract-negotiations-2026-05-15.md §4.",
+      "source": "rahmanef63/resource-site",
+      "install": "npx rahman-resources add platform-admin",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Contract-only scaffold. Wait for superspace /rr-send platform-admin before adopting. Distinct from per-instance `admin` slug.",
+      "tags": [
+        "infra",
+        "admin",
+        "multi-tenant",
+        "saas",
+        "platform"
       ]
     },
     {
@@ -1242,12 +1748,12 @@
       "slug": "comments",
       "title": "Comments — Threaded",
       "category": "content",
-      "description": "Workspace-scoped threaded comments anchored to pages or blocks. Soft-delete + resolve semantics. useComments(opts) hook returns items + openCount + CRUD mutations.",
+      "description": "Polymorphic-target threaded comments. Consumer picks `TargetRef = { kind, id, subId? }` (e.g. page+block, blog+slug, task+id). Renderless <CommentsThread> + <CommentsAnchor> wrappers. useComments(bindings, opts) hook returns items + openCount + CRUD + forbiddenWords guard. Adapter pattern — see contract-negotiations §1.",
       "source": "rahmanef63/resource-site",
       "install": "npx rahman-resources add comments",
       "npmPackages": [],
       "exampleCode": "",
-      "agentRecipe": "Run `rr add comments`. Use useComments({ pageId } | { blockId }) — returns items, openCount, addComment, editComment, resolveComment, deleteComment. resolvedAt!=null = thread closed but visible.",
+      "agentRecipe": "Run `rr add comments`. Wire Convex bindings ({ list, create, update, resolve, remove }) then use <CommentsThread target={{ kind, id, subId? }} bindings={bindings} forbiddenWords={[...]}>{render-prop}</CommentsThread> OR <CommentsAnchor target=... bindings=... pathMap={(t)=>...}>. v0.2.0 polymorphic — pick `kind` literal per host domain.",
       "tags": [
         "content",
         "social",
@@ -1260,12 +1766,12 @@
       "slug": "seo",
       "title": "SEO — AI Metadata Generator",
       "category": "content",
-      "description": "Service slice for SEO metadata generation — Anthropic-backed action with per-user 24h cost guard. No public route. Backend exposes generate + generateAndApply mutations gated by requireAdmin.",
+      "description": "Service slice for SEO metadata generation — Anthropic-backed action with per-user 24h cost guard + portable persona prop. No public route. Backend exposes generate + generateAndApply mutations gated by requireAdmin; consumers inject brand voice via the personaContext arg (or buildSeoSystemPrompt factory).",
       "source": "rahmanef63/resource-site",
       "install": "npx rahman-resources add seo",
       "npmPackages": [],
       "exampleCode": "",
-      "agentRecipe": "Run `rr add seo`. Call seo.generate from server actions or admin mutations. Cost guard rate-limits per-user within 24h via callsInWindow query.",
+      "agentRecipe": "Run `rr add seo`. Call seo.generate from server actions or admin mutations with `personaContext` describing your brand voice (or rely on the generic default). Cost guard rate-limits per-user within 24h via callsInWindow query.",
       "tags": [
         "content",
         "seo",
@@ -1589,8 +2095,8 @@
       "title": "MDX Blog",
       "category": "content",
       "kind": "ui",
-      "version": "0.1.0",
-      "description": "Markdown-with-JSX untuk blog post. File-based under content/blog/*.mdx. Auto-generate ToC, reading-time, syntax highlight, plus embed React components inline.",
+      "version": "0.2.0",
+      "description": "Markdown-with-JSX untuk blog post. File-based MDX content collection. Portable defineMdxBlog(opts) factory dengan 4 config props (basePath, contentDir, labels.list, nav) — defaults preserve legacy /blog + content/blog. Auto-generate ToC, reading-time, syntax highlight, plus embed React components inline.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/mdx-blog",
       "convexPaths": [],
@@ -1681,13 +2187,13 @@
     },
     {
       "slug": "command-menu",
-      "title": "Command Menu (⌘K)",
+      "title": "Command Menu",
       "category": "ui",
       "kind": "ui",
-      "version": "0.1.0",
-      "description": "Global ⌘K command palette. Auto-builds entries from your feature registry (defineFeature) + custom actions. Fuzzy search via cmdk. Mount once at app shell; listens globally. Facade slice — pulls from template-base/frontend/slices/command-menu which re-exports shared/foundation/utils/system/command-menu.",
-      "source": "superspace + kitab-core",
-      "slicePath": "template-base/frontend/slices/command-menu",
+      "version": "0.2.0",
+      "description": "Renderless ⌘K command palette + generic search modal. Consumer supplies CommandGroup[] + onSelect + label bag; slice owns dialog chrome, ⌘K hotkey, MRU history. Pulled UP from notion-page-clone's command-palette renderless surface (Wave N+3.7) — Nosion adapters dropped at the kitab boundary.",
+      "source": "notion-page-clone (consumerVersion 0.3.0) + earlier superspace facade",
+      "slicePath": "frontend/slices/command-menu",
       "convexPaths": [],
       "npm": [
         "cmdk@^1.0.0"
@@ -1704,9 +2210,10 @@
         "palette",
         "cmd-k",
         "navigation",
-        "keyboard"
+        "keyboard",
+        "search"
       ],
-      "agentRecipe": "Mount <CommandMenu actions={...} /> once at the dashboard shell level. Listens for Cmd+K globally. Actions auto-build from feature registry + workspace + theme/sign-out. Add custom commands via actions prop or by registering in command-registry.ts."
+      "agentRecipe": "Wire <CommandPalette groups={...} onHistorySelect={...} labels={...} /> at the dashboard shell. Build groups from your feature registry; each item.onSelect handles navigation. Use <SearchModal bindings={{ pages, databases, recents, isLoading, onQueryChange, onSelectPage, onSelectDatabase }} /> for the search dialog — see slice README.md for adapter shapes."
     },
     {
       "slug": "motion-primitives",
@@ -1958,16 +2465,18 @@
       "title": "Notion-Style Icon Picker",
       "category": "ui",
       "kind": "ui",
-      "version": "0.1.0",
-      "description": "Emoji + lucide icon picker with search, 10-color Notion palette, Twemoji/native toggle. One string stores emoji OR lucide:Name OR with ?c=hex tint — backwards-compat with raw-emoji fields. Single icon field stores emoji or 'lucide:Name' plus optional '?c=hex'.",
+      "version": "0.2.0",
+      "description": "Emoji + lucide icon picker with search, 10-color Notion palette, Twemoji/native toggle, recents tracking. One string stores emoji OR lucide:Name OR with ?c=hex tint — backwards-compat with raw-emoji fields. Two variants: Popover (compact trigger) and Inline (full sheet/dialog use). Lifted 2026-05-16 from notion-page-clone — full implementation (19 files) including emoji-keywords search index, twemoji renderer, lucide-catalog, recents store, style-pref hook.",
       "source": "notion-page-clone",
-      "slicePath": "template-base/frontend/slices/notion/slices/icon-picker",
+      "slicePath": "frontend/slices/icon-picker",
       "convexPaths": [],
       "npm": [],
       "shadcn": [
         "popover",
         "button",
-        "input"
+        "input",
+        "scroll-area",
+        "tabs"
       ],
       "env": [],
       "peers": [],
@@ -1980,7 +2489,59 @@
         "twemoji",
         "notion"
       ],
-      "agentRecipe": "parseIconValue() decodes; lucideValue()/withColor() build. Add 'icon: v.string()' to Convex table — no migration needed for existing emoji fields. Popover variant for inline UI, Inline for sheets/dialogs."
+      "agentRecipe": "Run `npx rr add icon-picker`. parseIconValue() decodes; lucideValue()/withColor() build. Add 'icon: v.string()' to Convex table — no migration needed for existing emoji fields. <IconPicker> wraps any trigger (Popover); <IconPickerInline> for sheets/dialogs. <DynamicIcon> renders from parsed value."
+    },
+    {
+      "slug": "cta",
+      "title": "Call to Action",
+      "category": "ui",
+      "kind": "ui",
+      "version": "0.1.0",
+      "description": "Brutalist call-to-action section — eyebrow label, serif headline, body, arrow CTA. Pair with CtaButton standalone for inline placements. Lifted 2026-05-16 from rahmanef.com; assumes Tailwind tracking-brutal / tracking-brutal-sm utilities OR drop them for the default tracking scale.",
+      "source": "rahmanef.com",
+      "slicePath": "frontend/slices/cta",
+      "convexPaths": [],
+      "npm": [
+        "lucide-react@^0.400.0"
+      ],
+      "shadcn": [],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "ui",
+        "marketing",
+        "cta",
+        "section",
+        "brutalist"
+      ],
+      "agentRecipe": "Run `npx rr add cta`. <CtaView eyebrow title body href ctaLabel /> renders the full section; <CtaButton href label /> drops a standalone arrow button anywhere. Override tracking-brutal utilities in tailwind.config or swap for tracking-wide if your design system has no brutal preset."
+    },
+    {
+      "slug": "rate-limit",
+      "title": "Rate Limit",
+      "category": "infra",
+      "kind": "backend",
+      "version": "0.1.0",
+      "description": "Convex-backed per-key request counter. Atomic check-and-increment via `consume` mutation; expired rows pruned by `_pruneExpired` internalMutation wired to a 5-min cron. Replaces single-replica in-memory Map so multi-replica Next deployments share buckets. Caller chooses key namespace (csp:<ip>, mcp:<ip>, oauth_token:<ip>). Lifted 2026-05-16 from rahmanef.com.",
+      "source": "rahmanef.com",
+      "slicePath": "frontend/slices/rate-limit",
+      "convexPaths": [
+        "convex/features/rate-limit"
+      ],
+      "npm": [],
+      "shadcn": [],
+      "env": [],
+      "peers": [],
+      "providers": [],
+      "tags": [
+        "infra",
+        "rate-limit",
+        "convex",
+        "backend",
+        "throttle"
+      ],
+      "agentRecipe": "Run `npx rr add rate-limit`. Compose `rateLimitTables` into root convex/schema.ts. Wire `internal.features.rate_limit.mutations._pruneExpired` into convex/crons.ts every 5 min. Call `api.features.rate_limit.mutations.consume({ key, limit, windowMs })` from server-side handlers — keep a fail-open wrapper so a Convex outage doesn't 503 the route."
     },
     {
       "slug": "contact-form-resend",
@@ -2031,8 +2592,8 @@
       "title": "Admin — Generic Shell",
       "category": "infra",
       "kind": "full",
-      "version": "0.1.0",
-      "description": "Landing page scaffold + Convex admin probe (isAdmin / counts). Consumer composes feature panels into the grid. Gated by requireAdmin on Convex side; superadmin email gate via SUPER_ADMIN_EMAIL env.",
+      "version": "0.2.0",
+      "description": "Per-instance admin landing scaffold + portable nav-from-registry factory. Consumer supplies a SliceRegistryAdapter (each slice declares its own admin.activity[]) + queryTable reader; the slice's buildAdminStats(opts) emits the { counts, unreadMessages, activity } shape Convex's admin.stats query returns. Pulled UP from rahmanef.com (Wave N+3.1, commit b542389) — domain literals dropped at the kitab boundary. Gated by requireAdmin on Convex side; superadmin email gate via SUPER_ADMIN_EMAIL env.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/admin",
       "convexPaths": [
@@ -2062,16 +2623,61 @@
         "infra",
         "admin",
         "shell",
-        "crud"
+        "crud",
+        "nav-from-registry"
       ],
-      "agentRecipe": "Run `rr add admin`. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address."
+      "agentRecipe": "Run `rr add admin`. Wire <AdminPage labels={...} /> at /admin and call buildAdminStats({ sliceRegistry, queryTable }) inside convex/features/admin/queries.ts — sliceRegistry.entries flat-maps each feature's admin.activity[] declarations. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address."
+    },
+    {
+      "slug": "platform-admin",
+      "title": "Platform Admin — Multi-Tenant Control Plane",
+      "category": "infra",
+      "kind": "full",
+      "version": "0.1.0",
+      "description": "Multi-tenant SaaS control plane. Workspace lifecycle ops (list/delete/cascade), per-tenant tier presets (gates + quota), KPI dashboard grid. Consumer-domain bits injected via adapter props (tenantTablesAdapter / tierPresets / kpiSources). Contract-only scaffold; canonical implementation lands via /rr-send from superspace. See docs/contract-negotiations-2026-05-15.md §4.",
+      "source": "rahmanef63/resource-site",
+      "slicePath": "frontend/slices/platform-admin",
+      "convexPaths": [
+        "convex/features/platform-admin"
+      ],
+      "npm": [],
+      "shadcn": [],
+      "env": [
+        {
+          "name": "PLATFORM_ADMIN_EMAILS",
+          "scope": "convex",
+          "required": true,
+          "description": "Comma-separated list of platform admin email addresses."
+        }
+      ],
+      "peers": [
+        {
+          "slug": "convex-auth",
+          "range": "^0.1",
+          "reason": "Actor identity for audit + tier-set ops."
+        },
+        {
+          "slug": "audit-log",
+          "range": "^0.2",
+          "reason": "padmin_audit table feeds through audit-log TenantAdapter."
+        }
+      ],
+      "providers": [],
+      "tags": [
+        "infra",
+        "admin",
+        "multi-tenant",
+        "saas",
+        "platform"
+      ],
+      "agentRecipe": "Contract-only scaffold. Wait for superspace /rr-send platform-admin before adopting. Distinct from per-instance `admin` slug."
     },
     {
       "slug": "audit-log",
       "title": "Audit Log — Workspace Events",
       "category": "infra",
       "kind": "backend",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "description": "Workspace-scoped audit event recorder. Canonical logAuditEvent helper for mutations + actions; supports entity tracking, before/after diff, IP/user-agent capture.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/audit-log",
@@ -2102,8 +2708,8 @@
       "title": "Comments — Threaded",
       "category": "content",
       "kind": "full",
-      "version": "0.1.0",
-      "description": "Workspace-scoped threaded comments anchored to pages or blocks. Soft-delete + resolve semantics. useComments(opts) hook returns items + openCount + CRUD mutations.",
+      "version": "0.2.0",
+      "description": "Polymorphic-target threaded comments. Consumer picks `TargetRef = { kind, id, subId? }` (e.g. page+block, blog+slug, task+id). Renderless <CommentsThread> + <CommentsAnchor> wrappers. useComments(bindings, opts) hook returns items + openCount + CRUD + forbiddenWords guard. Adapter pattern — see contract-negotiations §1.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/comments",
       "convexPaths": [
@@ -2131,15 +2737,15 @@
         "threaded",
         "annotations"
       ],
-      "agentRecipe": "Run `rr add comments`. Use useComments({ pageId } | { blockId }) — returns items, openCount, addComment, editComment, resolveComment, deleteComment. resolvedAt!=null = thread closed but visible."
+      "agentRecipe": "Run `rr add comments`. Wire Convex bindings ({ list, create, update, resolve, remove }) then use <CommentsThread target={{ kind, id, subId? }} bindings={bindings} forbiddenWords={[...]}>{render-prop}</CommentsThread> OR <CommentsAnchor target=... bindings=... pathMap={(t)=>...}>. v0.2.0 polymorphic — pick `kind` literal per host domain."
     },
     {
       "slug": "seo",
       "title": "SEO — AI Metadata Generator",
       "category": "content",
       "kind": "full",
-      "version": "0.1.0",
-      "description": "Service slice for SEO metadata generation — Anthropic-backed action with per-user 24h cost guard. No public route. Backend exposes generate + generateAndApply mutations gated by requireAdmin.",
+      "version": "0.2.0",
+      "description": "Service slice for SEO metadata generation — Anthropic-backed action with per-user 24h cost guard + portable persona prop. No public route. Backend exposes generate + generateAndApply mutations gated by requireAdmin; consumers inject brand voice via the personaContext arg (or buildSeoSystemPrompt factory).",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/seo",
       "convexPaths": [
@@ -2169,7 +2775,7 @@
         "anthropic",
         "metadata-generator"
       ],
-      "agentRecipe": "Run `rr add seo`. Call seo.generate from server actions or admin mutations. Cost guard rate-limits per-user within 24h via callsInWindow query."
+      "agentRecipe": "Run `rr add seo`. Call seo.generate from server actions or admin mutations with `personaContext` describing your brand voice (or rely on the generic default). Cost guard rate-limits per-user within 24h via callsInWindow query."
     },
     {
       "slug": "document-checklist",