rahman-resources 0.12.0 → 1.0.0

package/bin/cli.js

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
-// rahman-resources — installer for the Rahman kitab.
+// Rahman Resources (rr) — shadcn-style installer for vertical slices.
+// Aliases: `rahman-resources`, `resources`, `rr` (all run this file).
 // Usage:
-//   npx rahman-resources init <app-name> [--template <slug>] [--features a,b] [--skills x,y] [--with-shadcn-all]
-//   npx rahman-resources add <slug> [target-dir] [--at root|preview] [--with-shadcn-all]
-//   npx rahman-resources add-skill <slug> [target-dir]
-//   npx rahman-resources scaffold-slice <slug> [--category <cat>] [--target <dir>]
-//   npx rahman-resources list [layouts|recipes|features|skills|slices]
-//   npx rahman-resources info <slug>
-//   npx rahman-resources doctor
-//   npx rahman-resources mcp                # not implemented in CLI; install rahman-resources-mcp
+//   npx rr init <app-name> [--template <slug>] [--features a,b] [--skills x,y] [--with-shadcn-all]
+//   npx rr add <slug> [target-dir] [--at root|preview] [--with-shadcn-all]
+//   npx rr add-skill <slug> [target-dir]
+//   npx rr scaffold-slice <slug> [--category <cat>] [--target <dir>]
+//   npx rr list [layouts|recipes|features|skills|slices]
+//   npx rr info <slug>
+//   npx rr doctor
+//   npx rr mcp                # not implemented in CLI; install rahman-resources-mcp
 
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
@@ -113,22 +114,25 @@ function printHelp() {
   console.log(`
 ${kleur.bold("rahman-resources")} — scaffold + install templates, recipes, features, Claude skills
 
+${kleur.bold("Rahman Resources (rr)")} — shadcn-style installer for vertical slices.
+${kleur.dim("Bins: rahman-resources / resources / rr (all run this CLI).")}
+
 ${kleur.bold("Usage:")}
-  npx rahman-resources init <app-name> [--template <slug>] [--features a,b] [--skills x,y]
-                                       [--no-install] [--with-shadcn-reinit] [--with-shadcn-all]
-  npx rahman-resources add <slug> [target-dir] [--at root|preview] [--with-shadcn-all]
-  npx rahman-resources add-skill <slug> [target-dir]
-  npx rahman-resources scaffold-slice <slug> [--category <cat>] [--target <dir>]
-  npx rahman-resources lift <source>:<path> [--target <dir>] [--dry-run]
-  npx rahman-resources publish-slice <local-slice-dir> [--open-pr]
-  npx rahman-resources list [layouts|recipes|features|skills|slices]
-  npx rahman-resources info <slug>
-  npx rahman-resources doctor
-  npx rahman-resources graph [slug] [--all] [--json]
-  npx rahman-resources compose <slug>... [--json] [--rr-path <path>] [--no-deps] [--strict]
-  npx rahman-resources update <slug> [--apply] [--force] [--rr-path P] [--json]
-  npx rahman-resources migrate <slug> --from <v1> [--to <v2>] [--json] [--write-files] [--force-overwrite]
-  npx rahman-resources mcp
+  npx rr init <app-name> [--template <slug>] [--features a,b] [--skills x,y]
+                         [--no-install] [--with-shadcn-reinit] [--with-shadcn-all]
+  npx rr add <slug> [target-dir] [--at root|preview] [--with-shadcn-all]
+  npx rr add-skill <slug> [target-dir]
+  npx rr scaffold-slice <slug> [--category <cat>] [--target <dir>]
+  npx rr lift <source>:<path> [--target <dir>] [--dry-run]
+  npx rr publish-slice <local-slice-dir> [--open-pr]
+  npx rr list [layouts|recipes|features|skills|slices]
+  npx rr info <slug>
+  npx rr doctor
+  npx rr graph [slug] [--all] [--json]
+  npx rr compose <slug>... [--json] [--rr-path <path>] [--no-deps] [--strict]
+  npx rr update <slug> [--apply] [--force] [--rr-path P] [--json]
+  npx rr migrate <slug> --from <v1> [--to <v2>] [--json] [--write-files] [--force-overwrite]
+  npx rr mcp
 
 ${kleur.bold("Init flags:")}
   --no-install            skip 'npm install' step (faster scaffolds; you run it manually)
@@ -145,13 +149,17 @@ ${kleur.bold("Add flags:")}
   --force                 skip compose pre-flight entirely
 
 ${kleur.bold("Examples:")}
-  npx rahman-resources init my-app
-  npx rahman-resources init my-app --template personal-brand-os --skills frontend-design,mcp-builder
-  npx rahman-resources init my-app --no-install
-  npx rahman-resources add personal-brand-os . --at root
-  npx rahman-resources add personal-brand-os . --with-shadcn-all
-  npx rahman-resources add-skill webapp-testing
-  npx rahman-resources list skills
+  npx rr init my-app
+  npx rr init my-app --template personal-brand-os --skills frontend-design,mcp-builder
+  npx rr init my-app --no-install
+  npx rr add personal-brand-os . --at root
+  npx rr add personal-brand-os . --with-shadcn-all
+  npx rr add-skill webapp-testing
+  npx rr list skills
+
+${kleur.dim("Slice install destination (consumer): slices/<slug>/")}
+${kleur.dim("Shared utils destination (cascade): shared/<name>/")}
+${kleur.dim("Consumer's components/ui/ + lib/utils.ts (shadcn) are never touched.")}
 `);
 }
 

package/lib/contract.ts

@@ -92,6 +92,66 @@ export interface SliceContractProvides {
   components?: string[];
 }
 
+// ---------------------------------------------------------------------------
+// `bidir` block — Wave N+3 (Bidirectional Sync Detection Layer)
+// ---------------------------------------------------------------------------
+
+/**
+ * How the kitab treats sync between this slice and consumer copies.
+ *
+ * - `auto-pr`: when `rr scan-consumers` sees an `up-needed` verdict on a
+ *   consumer's `.kitab.json`, the operator workflow auto-opens a PR against
+ *   the kitab. Reserved for slices with strict generalisation gates.
+ * - `notify`: surface in the scan report; no auto-action.
+ * - `manual`: default — operator picks up via `/rr-prep` + `/rr-send`.
+ * - `frozen`: kitab refuses both UP and DOWN sync. Lock for retired slices.
+ */
+export type SliceSyncPolicy = "auto-pr" | "notify" | "manual" | "frozen";
+
+/**
+ * Generalisation level a consumer-side `.kitab.json` MUST claim before
+ * `rr-send` accepts the push back into the kitab.
+ *
+ * - `portable`: no consumer-specific business terms baked in. UP-sync allowed.
+ * - `needs-adapter`: requires a thin adapter wired by the consumer; UP-sync
+ *   blocked until blockers are addressed (or the contract drops the slice
+ *   to `consumer-locked`).
+ * - `consumer-locked`: contains business-specific logic that cannot be
+ *   generalised. Only DOWN-sync allowed.
+ */
+export type GeneralizationLevel =
+  | "portable"
+  | "needs-adapter"
+  | "consumer-locked";
+
+/**
+ * Generalisation contract — what the audit-bp `forbiddenTerms` rule scans
+ * for, and which props the consumer MUST inject.
+ */
+export interface SliceGeneralization {
+  level: GeneralizationLevel;
+  /**
+   * Identifiers / business terms that MUST NOT appear in the slice source
+   * tree. Audit-bp scans .ts/.tsx files. Empty when the slice is generic.
+   */
+  forbiddenTerms?: string[];
+  /**
+   * Props the consumer must inject for the slice to remain portable —
+   * e.g. `["basePath", "labels", "permission"]`.
+   */
+  requiredProps?: string[];
+}
+
+/**
+ * Bidirectional sync block. Optional, additive — slices without it default to
+ * `{ syncPolicy: "manual", generalization: { level: "portable" } }` for
+ * legacy compatibility with Wave N+1 contracts.
+ */
+export interface SliceBidirContract {
+  syncPolicy: SliceSyncPolicy;
+  generalization: SliceGeneralization;
+}
+
 // ---------------------------------------------------------------------------
 // Top-level contract
 // ---------------------------------------------------------------------------
@@ -121,6 +181,8 @@ export interface SliceContract {
   conflicts?: string[];
   /** Map of previous-version → migration script id. */
   migrationFrom?: Record<string, string>;
+  /** Wave N+3 — bidirectional sync policy + generalisation gate. */
+  bidir?: SliceBidirContract;
 }
 
 // ---------------------------------------------------------------------------
@@ -222,6 +284,60 @@ export function defineSliceContract(c: SliceContract): SliceContract {
     }
   }
 
+  // bidir block — Wave N+3
+  if (c.bidir !== undefined) {
+    if (!c.bidir || typeof c.bidir !== "object") {
+      throw new Error(`defineSliceContract(${c.id}): bidir must be an object`);
+    }
+    const policies = ["auto-pr", "notify", "manual", "frozen"];
+    if (!policies.includes(c.bidir.syncPolicy)) {
+      throw new Error(
+        `defineSliceContract(${c.id}): bidir.syncPolicy "${String(c.bidir.syncPolicy)}" must be one of ${policies.join("|")}`,
+      );
+    }
+    if (!c.bidir.generalization || typeof c.bidir.generalization !== "object") {
+      throw new Error(
+        `defineSliceContract(${c.id}): bidir.generalization must be an object`,
+      );
+    }
+    const levels = ["portable", "needs-adapter", "consumer-locked"];
+    if (!levels.includes(c.bidir.generalization.level)) {
+      throw new Error(
+        `defineSliceContract(${c.id}): bidir.generalization.level "${String(c.bidir.generalization.level)}" must be one of ${levels.join("|")}`,
+      );
+    }
+    const ft = c.bidir.generalization.forbiddenTerms;
+    if (ft !== undefined) {
+      if (!Array.isArray(ft)) {
+        throw new Error(
+          `defineSliceContract(${c.id}): bidir.generalization.forbiddenTerms must be an array`,
+        );
+      }
+      for (const t of ft) {
+        if (typeof t !== "string" || t.length === 0) {
+          throw new Error(
+            `defineSliceContract(${c.id}): bidir.generalization.forbiddenTerms entries must be non-empty strings`,
+          );
+        }
+      }
+    }
+    const rp = c.bidir.generalization.requiredProps;
+    if (rp !== undefined) {
+      if (!Array.isArray(rp)) {
+        throw new Error(
+          `defineSliceContract(${c.id}): bidir.generalization.requiredProps must be an array`,
+        );
+      }
+      for (const p of rp) {
+        if (typeof p !== "string" || p.length === 0) {
+          throw new Error(
+            `defineSliceContract(${c.id}): bidir.generalization.requiredProps entries must be non-empty strings`,
+          );
+        }
+      }
+    }
+  }
+
   // Conflicts
   if (c.conflicts) {
     if (!Array.isArray(c.conflicts)) {

package/lib/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generatedAt": "2026-05-15T03:23:22.231Z",
+  "generatedAt": "2026-05-16T08:10:45.510Z",
   "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"
       ]
     },
     {
@@ -1208,17 +1659,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 +1712,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 +1730,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",
@@ -1273,6 +1743,24 @@
         "anthropic",
         "metadata-generator"
       ]
+    },
+    {
+      "slug": "document-checklist",
+      "title": "Document Checklist — Job-Search Doc Tracker",
+      "category": "content",
+      "description": "Track required job-search documents (CV, KTP, ijazah, etc.) with country-scoped seed templates and per-user completion state. Ships an Indonesian default checklist. Toggle completed + notes + expiry per item.",
+      "source": "rahmanef63/CareerPack",
+      "install": "npx rahman-resources add document-checklist",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Run `rr add document-checklist`. Wire <DocumentChecklist bindings={{ current, seed, updateStatus }} countryTemplateSlot={<CountryTemplateCard bindings={{ templates, getTemplate, instantiate }} />} /> — bindings sourced from api.features['document-checklist'].* queries/mutations.",
+      "tags": [
+        "career",
+        "documents",
+        "checklist",
+        "job-search",
+        "indonesia"
+      ]
     }
   ],
   "slices": [
@@ -1571,8 +2059,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": [],
@@ -1663,13 +2151,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"
@@ -1686,9 +2174,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",
@@ -2013,8 +2502,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": [
@@ -2044,16 +2533,61 @@
         "infra",
         "admin",
         "shell",
-        "crud"
+        "crud",
+        "nav-from-registry"
+      ],
+      "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": "Run `rr add admin`. Set SUPER_ADMIN_EMAIL via `npx convex env set` to lock down /admin to one address."
+      "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",
@@ -2084,8 +2618,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": [
@@ -2113,15 +2647,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": [
@@ -2151,7 +2685,54 @@
         "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",
+      "title": "Document Checklist — Job-Search Doc Tracker",
+      "category": "content",
+      "kind": "full",
+      "version": "0.1.0",
+      "description": "Track required job-search documents (CV, KTP, ijazah, etc.) with country-scoped seed templates and per-user completion state. Ships an Indonesian default checklist. Toggle completed + notes + expiry per item.",
+      "source": "rahmanef63/CareerPack",
+      "slicePath": "frontend/slices/document-checklist",
+      "convexPaths": [
+        "convex/features/document-checklist"
+      ],
+      "npm": [
+        "lucide-react"
+      ],
+      "shadcn": [
+        "badge",
+        "button",
+        "card",
+        "dialog",
+        "label",
+        "popover",
+        "calendar",
+        "progress",
+        "scroll-area",
+        "skeleton",
+        "tabs",
+        "textarea"
+      ],
+      "env": [],
+      "peers": [
+        {
+          "slug": "convex-auth",
+          "range": "^0.1",
+          "reason": "Auth identity for user-scoped checklist state."
+        }
+      ],
+      "providers": [],
+      "tags": [
+        "career",
+        "documents",
+        "checklist",
+        "job-search",
+        "indonesia"
+      ],
+      "agentRecipe": "Run `rr add document-checklist`. Wire <DocumentChecklist bindings={{ current, seed, updateStatus }} countryTemplateSlot={<CountryTemplateCard bindings={{ templates, getTemplate, instantiate }} />} /> — bindings sourced from api.features['document-checklist'].* queries/mutations."
     }
   ]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rahman-resources",
-  "version": "0.12.0",
-  "description": "Scaffolder + installer for Rahman Resources kitab — npx rahman-resources init/add/lift/scaffold-slice/publish-slice. Tier-3 portable feature slices + manifest + skills + CRUD workflows.",
+  "version": "1.0.0",
+  "description": "Rahman Resources (rr) — shadcn-style installer for vertical slices. `npx resources add <slug>` copies slice into your project's `slices/<slug>/`. You own the files.",
   "type": "module",
   "license": "MIT",
   "author": "Rahman <casadezian@gmail.com>",
@@ -12,7 +12,9 @@
     "directory": "packages/cli"
   },
   "bin": {
-    "rahman-resources": "bin/cli.js"
+    "rahman-resources": "bin/cli.js",
+    "resources": "bin/cli.js",
+    "rr": "bin/cli.js"
   },
   "files": [
     "bin",