rahman-resources 0.7.0 → 0.9.0

package/bin/cli.js

@@ -25,6 +25,7 @@ import {
   rrExists,
   validateRr,
   addFeature as rrAddFeature,
+  addSlice as rrAddSlice,
   addSkill as rrAddSkill,
 } from "../lib/rr.mjs";
 import { runPostInit } from "../lib/post-init.mjs";
@@ -714,7 +715,7 @@ async function installSkill(slug, target) {
 
 // ─── doctor ───────────────────────────────────────────────────────────────
 
-function runDoctor() {
+function runDoctor(rest = []) {
   const target = process.cwd();
   if (!rrExists(target)) {
     console.log(kleur.yellow("⚠ No rr.json found in cwd. Run 'rahman-resources init <app>' first."));
@@ -722,16 +723,102 @@ function runDoctor() {
   }
   const rr = readRr(target);
   const issues = validateRr(rr);
-  if (issues.length === 0) {
-    console.log(kleur.green("✓ rr.json is valid."));
-    console.log(`  template:  ${kleur.cyan(rr.template?.slug ?? "(none)")}`);
-    console.log(`  features:  ${kleur.cyan(rr.features?.length ?? 0)}`);
-    console.log(`  skills:    ${kleur.cyan(rr.skills?.length ?? 0)}`);
+  const sliceCheck = rest.includes("--slices");
+
+  if (issues.length > 0) {
+    console.log(kleur.red(`✖ rr.json has ${issues.length} issue(s):`));
+    for (const i of issues) console.log(`  · ${i}`);
+    process.exit(1);
+  }
+
+  console.log(kleur.green("✓ rr.json is valid."));
+  console.log(`  template:  ${kleur.cyan(rr.template?.slug ?? "(none)")}`);
+  console.log(`  features:  ${kleur.cyan(rr.features?.length ?? 0)}`);
+  console.log(`  slices:    ${kleur.cyan(rr.slices?.length ?? 0)}`);
+  console.log(`  skills:    ${kleur.cyan(rr.skills?.length ?? 0)}`);
+
+  if (sliceCheck) doctorSlices(target, rr);
+}
+
+function doctorSlices(target, rr) {
+  console.log(kleur.bold(`\n→ Slice composition check\n`));
+  const installed = rr.slices ?? [];
+  if (installed.length === 0) {
+    console.log(kleur.dim("  (no slices installed — nothing to check)"));
     return;
   }
-  console.log(kleur.red(`✖ rr.json has ${issues.length} issue(s):`));
-  for (const i of issues) console.log(`  · ${i}`);
-  process.exit(1);
+
+  const errors = [];
+  const warnings = [];
+  const sliceMap = new Map((manifest.slices ?? []).map((s) => [s.slug, s]));
+  const present = new Set(installed.map((s) => s.slug));
+
+  for (const inst of installed) {
+    const def = sliceMap.get(inst.slug);
+    if (!def) {
+      warnings.push(`${inst.slug}: not in kitab manifest (custom slice — skipping peer check)`);
+      continue;
+    }
+
+    // 1. Slice path exists locally
+    const slicePath = path.join(target, def.slicePath);
+    if (!existsSync(slicePath)) {
+      errors.push(`${inst.slug}: missing on disk at ${def.slicePath}`);
+    }
+    const sliceJsonPath = path.join(slicePath, "slice.json");
+    if (existsSync(slicePath) && !existsSync(sliceJsonPath)) {
+      errors.push(`${inst.slug}: slice.json missing at ${def.slicePath}/slice.json`);
+    }
+
+    // 2. Convex paths exist locally (when declared)
+    for (const cp of def.convexPaths ?? []) {
+      const cpAbs = path.join(target, cp);
+      if (!existsSync(cpAbs)) {
+        warnings.push(`${inst.slug}: convex path missing at ${cp} (lift again with 'npx rr add ${inst.slug}')`);
+      }
+    }
+
+    // 3. Peers transitively present
+    for (const peer of def.peers ?? []) {
+      if (!present.has(peer.slug)) {
+        errors.push(`${inst.slug} requires peer ${peer.slug} ${peer.range} — not installed`);
+      }
+    }
+  }
+
+  // 4. Convex table-name collision across installed slices
+  const tableOwners = new Map();
+  for (const inst of installed) {
+    const def = sliceMap.get(inst.slug);
+    if (!def) continue;
+    for (const cp of def.convexPaths ?? []) {
+      const schemaFile = path.join(target, cp, "schema.ts");
+      if (!existsSync(schemaFile)) continue;
+      const body = readFileSync(schemaFile, "utf8");
+      const matches = [...body.matchAll(/^\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*defineTable\(/gm)];
+      for (const m of matches) {
+        const tName = m[1];
+        if (tableOwners.has(tName)) {
+          errors.push(`convex table "${tName}" declared by both ${tableOwners.get(tName)} and ${inst.slug}`);
+        } else {
+          tableOwners.set(tName, inst.slug);
+        }
+      }
+    }
+  }
+
+  if (warnings.length > 0) {
+    console.log(kleur.yellow(`  ⚠ ${warnings.length} warning(s):`));
+    for (const w of warnings) console.log(`    · ${w}`);
+  }
+  if (errors.length > 0) {
+    console.log(kleur.red(`\n  ✖ ${errors.length} error(s):`));
+    for (const e of errors) console.log(`    · ${e}`);
+    process.exit(1);
+  }
+  if (errors.length === 0 && warnings.length === 0) {
+    console.log(kleur.green(`  ✓ ${installed.length} slice(s) — composition healthy`));
+  }
 }
 
 function runMcpHint() {
@@ -910,6 +997,17 @@ async function runLift(rest) {
     await maybeRunShadcnAdd({ slug: parsed.slug ?? "lifted", shadcnComponents: plan.shadcn }, target, false);
   }
 
+  // Register the slice in the consumer's rr.json (if present).
+  if (parsed.kind === "rahman" && rrExists(target)) {
+    const slice = (manifest.slices ?? []).find((s) => s.slug === parsed.slug);
+    if (slice) {
+      const rr = readRr(target);
+      rrAddSlice(rr, parsed.slug, { version: slice.version, category: slice.category });
+      writeRr(rr, target);
+      console.log(kleur.dim(`  rr.json: slices += ${parsed.slug}@${slice.version}`));
+    }
+  }
+
   console.log(`\n${kleur.green("✓")} Lift complete.`);
   if (plan.env.length > 0) {
     console.log(`${kleur.bold("Don't forget:")} set the env vars listed above before running.\n`);
@@ -1022,25 +1120,72 @@ async function runPublishSlice(rest) {
     ps.on("exit", (code) => (code === 0 ? resolve() : reject(new Error(`validate-slice exited ${code}`))));
   });
 
+  // Read the slice's metadata so we can prefill the PR title + body.
+  const sliceMeta = JSON.parse(readFileSync(path.join(abs, "slice.json"), "utf8"));
+
   if (!flags["open-pr"]) {
-    console.log(`\n${kleur.yellow("dry-run — pass --open-pr to actually open a PR upstream.")}`);
+    console.log(`\n${kleur.yellow("dry-run — pass --open-pr to scaffold the PR command.")}`);
     return;
   }
 
-  // Open a PR. We don't push branches automatically — instruct the user.
-  console.log(`\n${kleur.bold("Opening PR upstream:")}`);
+  const ghAvailable = await checkGhInstalled();
+
+  if (!ghAvailable) {
+    console.log(`\n${kleur.yellow("⚠ `gh` CLI not found.")}`);
+    console.log(`Install it: ${kleur.cyan("https://cli.github.com")} then re-run with --open-pr.`);
+    console.log(`Manual fallback steps:`);
+    console.log(`
+  1. Fork ${kleur.cyan("https://github.com/rahmanef63/resource-site")} on GitHub.
+  2. Clone your fork: ${kleur.cyan("git clone https://github.com/<you>/resource-site && cd resource-site")}
+  3. Copy slice: ${kleur.cyan(`cp -r ${abs} frontend/slices/${sliceMeta.slug}`)}
+  4. Copy convex half: ${kleur.cyan(`cp -r ${abs.replace("frontend/slices", "convex/features")} convex/features/${sliceMeta.slug}`)} (if exists)
+  5. Add entry to ${kleur.cyan("lib/content/slices.ts")}
+  6. ${kleur.cyan("npm run slices:check")}
+  7. ${kleur.cyan(`git checkout -b feat/slice-${sliceMeta.slug} && git add -A && git commit -m "feat(slices): add ${sliceMeta.slug}" && git push -u origin feat/slice-${sliceMeta.slug}`)}
+  8. Open PR via GitHub UI.
+`);
+    return;
+  }
+
+  // gh installed — emit ready-to-run gh commands.
+  const branchName = `feat/slice-${sliceMeta.slug}`;
+  const title = `feat(slices): add ${sliceMeta.slug}`;
+  const body = [
+    `Adds the **${sliceMeta.title}** slice (${sliceMeta.category}, v${sliceMeta.version}).`,
+    "",
+    sliceMeta.description,
+    "",
+    "Validated locally with `npm run slices:check`.",
+    "",
+    "🤖 Generated with [`rahman-resources publish-slice`](https://github.com/rahmanef63/resource-site)",
+  ].join("\n");
+
+  console.log(`\n${kleur.bold("✓")} ${kleur.green("gh CLI detected.")} Run these from inside YOUR fork of the kitab repo:`);
   console.log(`
-  1. Fork ${kleur.cyan("https://github.com/rahmanef63/resource-site")} (if not already).
-  2. Clone your fork, copy this slice into ${kleur.cyan(`frontend/slices/<slug>/`)} and the
-     convex half into ${kleur.cyan(`convex/features/<slug>/`)}.
-  3. Add an entry to ${kleur.cyan("lib/content/slices.ts")}.
-  4. Run ${kleur.cyan("npm run slices:check")} locally.
-  5. ${kleur.cyan(`gh pr create --title "feat(slices): add <slug>" --body "..."`)}.
-
-  (Auto-PR via gh CLI not yet implemented — coming in a future release.)
+  # Inside your forked clone of rahmanef63/resource-site, copy the slice in:
+  ${kleur.cyan(`cp -r ${abs} frontend/slices/${sliceMeta.slug}`)}
+  ${kleur.cyan(`# Add ${sliceMeta.slug} entry to lib/content/slices.ts`)}
+  ${kleur.cyan(`npm run slices:check`)}
+
+  # Then open the PR (gh handles fork + push):
+  ${kleur.cyan(`git checkout -b ${branchName}`)}
+  ${kleur.cyan(`git add -A && git commit -m "${title}"`)}
+  ${kleur.cyan(`gh pr create --repo rahmanef63/resource-site \\
+    --title "${title}" \\
+    --body ${JSON.stringify(body)}`)}
+
+  ${kleur.dim("(If you haven't forked yet, run `gh repo fork rahmanef63/resource-site --clone` first.)")}
 `);
 }
 
+async function checkGhInstalled() {
+  return new Promise((resolve) => {
+    const ps = spawn("gh", ["--version"], { stdio: "ignore", shell: true });
+    ps.on("error", () => resolve(false));
+    ps.on("exit", (code) => resolve(code === 0));
+  });
+}
+
 // ─── helpers ──────────────────────────────────────────────────────────────
 
 async function pull(repoPath, dest) {

package/lib/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 2,
-  "generatedAt": "2026-05-09T13:25:41.865Z",
+  "generatedAt": "2026-05-09T14:19:40.545Z",
   "repo": "rahmanef63/resource-site",
   "branch": "main",
   "layouts": [
@@ -950,33 +950,12 @@
     }
   ],
   "features": [
-    {
-      "slug": "ai-sdk-openrouter",
-      "title": "AI SDK — OpenRouter Router",
-      "category": "ai",
-      "description": "Tier-routed LLM calls via OpenRouter. Nano (Haiku/4o-mini) for classification, mid (Sonnet/4o) for drafting, flagship (Opus) for deep reasoning. Cost log + retry baked in.",
-      "source": "@openrouter/ai-sdk-provider + ai",
-      "docsUrl": "https://sdk.vercel.ai/docs",
-      "install": "npm i ai @openrouter/ai-sdk-provider",
-      "npmPackages": [
-        "ai",
-        "@openrouter/ai-sdk-provider"
-      ],
-      "exampleCode": "// convex/shared/ai/router.ts\nimport { action } from \"./_generated/server\";\nimport { v } from \"convex/values\";\nimport { generateText } from \"ai\";\nimport { createOpenRouter } from \"@openrouter/ai-sdk-provider\";\n\nconst router = createOpenRouter({ apiKey: process.env.OPENROUTER_API_KEY! });\n\nconst TIER_TO_MODEL = {\n  nano: \"anthropic/claude-haiku-4-5\",\n  mid: \"anthropic/claude-sonnet-4-6\",\n  flagship: \"anthropic/claude-opus-4-7\",\n};\n\nexport const callModel = action({\n  args: {\n    feature: v.string(),\n    prompt: v.string(),\n    tier: v.union(v.literal(\"nano\"), v.literal(\"mid\"), v.literal(\"flagship\")),\n  },\n  handler: async (ctx, { feature, prompt, tier }) => {\n    const { text, usage } = await generateText({\n      model: router(TIER_TO_MODEL[tier]),\n      prompt,\n    });\n    await ctx.runMutation(internal.ai.logUsage, { feature, tier, usage });\n    return text;\n  },\n});",
-      "agentRecipe": "Wrap every AI call through ai-router action. Pick tier based on workload: nano for spam-flag/headline-suggest, mid for chat/draft, flagship for methodology-review. Log token usage to ai_usage table for cost dashboard.",
-      "tags": [
-        "ai",
-        "llm",
-        "openrouter",
-        "vercel-ai-sdk"
-      ]
-    },
     {
       "slug": "convex-auth",
       "title": "Convex Auth — Email Magic Link",
       "category": "auth",
-      "description": "@convex-dev/auth with email magic link only. No Clerk, no NextAuth. Self-hosted Convex friendly. Hard mandate per kitab CLAUDE.md.",
-      "source": "@convex-dev/auth",
+      "description": "@convex-dev/auth with email magic link via Resend. Self-hosted Convex friendly. Hard mandate per kitab CLAUDE.md (no Clerk).",
+      "source": "rahmanef63/resource-site",
       "docsUrl": "https://labs.convex.dev/auth",
       "install": "npm i @convex-dev/auth @auth/core resend",
       "npmPackages": [
@@ -984,51 +963,34 @@
         "@auth/core",
         "resend"
       ],
-      "exampleCode": "// convex/auth.ts\nimport { convexAuth } from \"@convex-dev/auth/server\";\nimport { ResendOTP } from \"./auth/ResendOTP\";\n\nexport const { auth, signIn, signOut, store, isAuthenticated } = convexAuth({\n  providers: [ResendOTP],\n});\n\n// app/proxy.ts (Next 16 — NOT middleware.ts)\nimport { convexAuthNextjsMiddleware } from \"@convex-dev/auth/nextjs/server\";\nexport default convexAuthNextjsMiddleware();",
-      "agentRecipe": "Mount auth in convex/auth.ts. Wire ResendOTP for magic-link delivery. Use convexAuthNextjsMiddleware in app/proxy.ts (Next 16 renamed middleware.ts → proxy.ts). Forbid Clerk per CLAUDE.md.",
+      "exampleCode": "// convex/auth.ts\nimport { convexAuth } from \"@convex-dev/auth/server\";\nimport Resend from \"@convex-dev/auth/providers/Resend\";\n\nexport const { auth, signIn, signOut, store, isAuthenticated } = convexAuth({\n  providers: [Resend({ from: \"auth@yourdomain.com\" })],\n});\n\n// app/proxy.ts (Next 16 — NOT middleware.ts)\nimport { convexAuthNextjsMiddleware } from \"@convex-dev/auth/nextjs/server\";\nexport default convexAuthNextjsMiddleware();",
+      "agentRecipe": "Run `rr add convex-auth`. Then create convex/auth.ts using the kitab pattern (Resend provider). Set env via `npx convex env set` for self-hosted.",
       "tags": [
         "auth",
         "convex",
-        "email-magic-link",
+        "magic-link",
         "no-clerk"
       ]
     },
     {
-      "slug": "broadcast-channel-sync",
-      "title": "BroadcastChannel — Cross-iframe Live Sync",
-      "category": "realtime",
-      "description": "Same-origin iframe live sync without backend. Used in T1 split preview tab — submit form di Public, action propagates ke Admin secara realtime via window.BroadcastChannel.",
-      "source": "Web Platform — BroadcastChannel API",
-      "docsUrl": "https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API",
-      "install": "// no install — Web Platform API",
-      "npmPackages": [],
-      "exampleCode": "\"use client\";\nimport * as React from \"react\";\n\nexport function StoreProvider({ children }) {\n  const [state, baseDispatch] = React.useReducer(reducer, SEED_STATE);\n  const channelRef = React.useRef<BroadcastChannel | null>(null);\n\n  React.useEffect(() => {\n    const ch = new BroadcastChannel(\"pbos:sync\");\n    channelRef.current = ch;\n    ch.onmessage = (e) => baseDispatch(e.data);\n    return () => ch.close();\n  }, []);\n\n  const dispatch = React.useCallback((action) => {\n    baseDispatch(action);\n    channelRef.current?.postMessage(action);\n  }, []);\n\n  return <Ctx.Provider value={{ state, dispatch }}>{children}</Ctx.Provider>;\n}",
-      "agentRecipe": "Use BroadcastChannel only for demo / cross-iframe state mirroring. Production data still goes through Convex realtime. The channel does not echo to the sender so no loop.",
-      "tags": [
-        "realtime",
-        "broadcast-channel",
-        "cross-iframe",
-        "demo-pattern"
-      ]
-    },
-    {
-      "slug": "convex-vector-search",
-      "title": "Convex Vector Index — Semantic Search",
-      "category": "search",
-      "description": "Built-in vector index on any Convex table. Embed via OpenAI text-embedding-3-small (1536-dim), query via vectorIndex().",
-      "source": "convex (built-in)",
-      "docsUrl": "https://docs.convex.dev/database/vector-search",
-      "install": "npm i openai",
+      "slug": "midtrans-payment",
+      "title": "Midtrans — Indonesia Payment",
+      "category": "payment",
+      "description": "Pembayaran lokal Indonesia via Midtrans Snap (BCA, Mandiri, BRI, e-wallet GoPay/OVO/Dana, QRIS). Webhook untuk konfirmasi. Provider-isolated under components/providers/midtrans + actions/midtrans so Doku/Stripe land as siblings.",
+      "source": "rahmanef63/resource-site",
+      "docsUrl": "https://docs.midtrans.com",
+      "install": "npm i midtrans-client",
       "npmPackages": [
-        "openai"
+        "midtrans-client"
       ],
-      "exampleCode": "// convex/schema.ts\nposts: defineTable({\n  title: v.string(),\n  body: v.string(),\n  embedding: v.array(v.float64()),\n}).vectorIndex(\"by_embedding\", {\n  vectorField: \"embedding\",\n  dimensions: 1536,\n  filterFields: [\"workspaceId\", \"status\"],\n}),\n\n// convex/posts.ts\nexport const search = action({\n  args: { query: v.string(), workspaceId: v.id(\"workspaces\") },\n  handler: async (ctx, args) => {\n    const emb = await embed(args.query);\n    return await ctx.vectorSearch(\"posts\", \"by_embedding\", {\n      vector: emb,\n      limit: 10,\n      filter: (q) => q.eq(\"workspaceId\", args.workspaceId),\n    });\n  },\n});",
-      "agentRecipe": "Add embedding field + vectorIndex per searchable table. Re-embed on upsert via Convex action. Cache embeddings — don't re-call OpenAI on every read.",
+      "exampleCode": "",
+      "agentRecipe": "Midtrans Snap untuk pembayaran instant. Webhook ke Convex HTTP action /api/midtrans-callback untuk update order status. Ingat: PPN 11% sudah included di amount, jangan double-count.",
       "tags": [
-        "search",
-        "vector",
-        "convex",
-        "rag"
+        "payment",
+        "midtrans",
+        "indonesia",
+        "qris",
+        "snap"
       ]
     },
     {
@@ -1036,7 +998,7 @@
       "title": "Resend — Transactional & Newsletter",
       "category": "email",
       "description": "Transactional email + newsletter blast via Resend. Double opt-in flow + audience segmentation. Magic-link delivery for Convex Auth.",
-      "source": "resend + react-email",
+      "source": "rahmanef63/resource-site",
       "docsUrl": "https://resend.com/docs",
       "install": "npm i resend react-email @react-email/components",
       "npmPackages": [
@@ -1044,41 +1006,62 @@
         "react-email",
         "@react-email/components"
       ],
-      "exampleCode": "// convex/shared/email/resend.ts\nimport { Resend } from \"resend\";\nimport { action } from \"../../_generated/server\";\n\nconst resend = new Resend(process.env.RESEND_API_KEY!);\n\nexport const sendNewsletter = action({\n  args: { audienceId: v.string(), subject: v.string(), html: v.string() },\n  handler: async (_, args) => {\n    await resend.broadcasts.create({\n      audienceId: args.audienceId,\n      from: \"lorem.dev <hi@lorem.dev>\",\n      subject: args.subject,\n      html: args.html,\n    });\n  },\n});",
+      "exampleCode": "",
       "agentRecipe": "Use Resend Audiences API for newsletter — store subscriber emails in Convex too for segmentation. Double opt-in: subscriber.create with status 'pending' → click link → status 'confirmed'.",
       "tags": [
         "email",
-        "resend",
         "newsletter",
-        "transactional"
+        "resend"
       ]
     },
     {
-      "slug": "midtrans-payment",
-      "title": "Midtrans — Indonesia Payment",
-      "category": "payment",
-      "description": "Pembayaran lokal Indonesia via Midtrans Snap (BCA, Mandiri, BRI, e-wallet GoPay/OVO/Dana, QRIS). Webhook untuk konfirmasi.",
-      "source": "midtrans-client",
-      "docsUrl": "https://docs.midtrans.com",
-      "install": "npm i midtrans-client",
+      "slug": "ai-router",
+      "title": "AI Router (OpenRouter)",
+      "category": "ai",
+      "description": "Tier-routed LLM access via OpenRouter — nano (Haiku) for classification, mid (Sonnet) for chat, flagship (Opus) for deep reasoning. Per-call usage log.",
+      "source": "rahmanef63/resource-site",
+      "docsUrl": "https://sdk.vercel.ai/docs",
+      "install": "npm i ai @openrouter/ai-sdk-provider",
       "npmPackages": [
-        "midtrans-client"
+        "ai",
+        "@openrouter/ai-sdk-provider"
       ],
-      "exampleCode": "// convex/shared/billing/midtrans.ts\nimport midtransClient from \"midtrans-client\";\nimport { action } from \"../../_generated/server\";\n\nconst snap = new midtransClient.Snap({\n  isProduction: false,\n  serverKey: process.env.MIDTRANS_SERVER_KEY!,\n});\n\nexport const createPayment = action({\n  args: { orderId: v.string(), amount: v.number(), customer: v.any() },\n  handler: async (_, args) => {\n    const tx = await snap.createTransaction({\n      transaction_details: { order_id: args.orderId, gross_amount: args.amount },\n      customer_details: args.customer,\n    });\n    return tx.redirect_url;\n  },\n});",
-      "agentRecipe": "Midtrans Snap untuk pembayaran instant. Webhook ke Convex HTTP action /api/midtrans-callback untuk update order status. Ingat: PPN 11% sudah included di amount, jangan double-count.",
+      "exampleCode": "",
+      "agentRecipe": "Wrap every AI call through ai-router action. Pick tier based on workload: nano for spam-flag/headline-suggest, mid for chat/draft, flagship for methodology-review. Log token usage to ai_usage table for cost dashboard.",
       "tags": [
-        "payment",
-        "midtrans",
-        "indonesia",
-        "qris"
+        "ai",
+        "llm",
+        "openrouter",
+        "tier-routing"
+      ]
+    },
+    {
+      "slug": "vector-search",
+      "title": "Convex Vector Search",
+      "category": "search",
+      "description": "Embeddings-based search via Convex's built-in vector index. Embed via OpenAI text-embedding-3-small (1536-dim), query via vectorIndex().",
+      "source": "rahmanef63/resource-site",
+      "docsUrl": "https://docs.convex.dev/database/vector-search",
+      "install": "npm i openai",
+      "npmPackages": [
+        "openai"
+      ],
+      "exampleCode": "",
+      "agentRecipe": "Add embedding field + vectorIndex per searchable table. Re-embed on upsert via Convex action. Cache embeddings — don't re-call OpenAI on every read.",
+      "tags": [
+        "search",
+        "vector",
+        "embeddings",
+        "convex",
+        "rag"
       ]
     },
     {
       "slug": "mdx-blog",
-      "title": "MDX — Blog Content",
+      "title": "MDX Blog",
       "category": "content",
-      "description": "Markdown-with-JSX untuk blog post. Auto-generate ToC, reading-time, syntax highlight, plus embed React components inline.",
-      "source": "next-mdx-remote",
+      "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.",
+      "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",
       "npmPackages": [
@@ -1087,33 +1070,51 @@
         "remark-gfm",
         "reading-time"
       ],
-      "exampleCode": "// app/blog/[slug]/page.tsx\nimport { MDXRemote } from \"next-mdx-remote/rsc\";\nimport readingTime from \"reading-time\";\n\nexport default async function Page({ params }) {\n  const { slug } = await params;\n  const post = await getPost(slug);\n  const stats = readingTime(post.body);\n\n  return (\n    <article>\n      <h1>{post.title}</h1>\n      <p>{stats.text}</p>\n      <MDXRemote\n        source={post.body}\n        options={{ mdxOptions: { rehypePlugins: [rehypePrettyCode], remarkPlugins: [remarkGfm] } }}\n      />\n    </article>\n  );\n}",
-      "agentRecipe": "Store post body sebagai markdown di Convex. Render dengan MDXRemote di [slug]/page.tsx. Auto-extract headings ke ToC via remark plugin custom.",
+      "exampleCode": "",
+      "agentRecipe": "Store post body sebagai markdown di content/blog/*.mdx. Render dengan MDXRemote di [slug]/page.tsx. Auto-extract headings ke ToC via remark plugin custom.",
       "tags": [
-        "mdx",
-        "markdown",
+        "content",
         "blog",
-        "content"
+        "mdx",
+        "static"
       ]
     },
     {
       "slug": "cal-com-booking",
-      "title": "Cal.com — Booking Embed",
+      "title": "Cal.com Booking",
       "category": "data",
-      "description": "Embed Cal.com booking widget di halaman Services. Self-hosted atau cloud. Webhook ke Convex untuk sync booking ke leads table.",
-      "source": "@calcom/embed-react",
+      "description": "Embedded Cal.com booking widget + webhook receiver to mirror bookings into Convex.",
+      "source": "rahmanef63/resource-site",
       "docsUrl": "https://cal.com/docs/integrations/web-app/embed",
       "install": "npm i @calcom/embed-react",
       "npmPackages": [
         "@calcom/embed-react"
       ],
-      "exampleCode": "\"use client\";\nimport Cal from \"@calcom/embed-react\";\n\nexport function CalEmbed({ eventType }: { eventType: string }) {\n  return (\n    <Cal\n      calLink={`lorem/${eventType}`}\n      style={{ width: \"100%\", height: \"600px\", overflow: \"scroll\" }}\n      config={{ layout: \"month_view\", theme: \"dark\" }}\n    />\n  );\n}",
-      "agentRecipe": "Embed Cal.com via @calcom/embed-react di halaman services. Configure webhook di Cal.com dashboard → POST ke /api/cal-webhook → create lead di Convex.",
+      "exampleCode": "",
+      "agentRecipe": "Embed Cal.com via @calcom/embed-react di halaman services. Configure webhook di Cal.com dashboard → POST ke /api/cal-webhook → upsert booking di Convex.",
       "tags": [
-        "booking",
-        "cal-com",
+        "data",
         "scheduling",
-        "embed"
+        "cal-com",
+        "bookings"
+      ]
+    },
+    {
+      "slug": "broadcast-channel-sync",
+      "title": "BroadcastChannel — Cross-tab Sync",
+      "category": "realtime",
+      "description": "Same-origin cross-tab + cross-iframe state sync via BroadcastChannel API. Tiny, no backend, no install.",
+      "source": "Web Platform — BroadcastChannel API",
+      "docsUrl": "https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API",
+      "install": "// no install — Web Platform API",
+      "npmPackages": [],
+      "exampleCode": "",
+      "agentRecipe": "Use BroadcastChannel only for demo / cross-iframe state mirroring. Production data still goes through Convex realtime. Use the useBroadcastSync(channelName, initial) hook from @/features/broadcast-channel-sync.",
+      "tags": [
+        "realtime",
+        "cross-tab",
+        "broadcast-channel",
+        "demo-pattern"
       ]
     }
   ],
@@ -1172,10 +1173,10 @@
     },
     {
       "slug": "midtrans-payment",
-      "title": "Midtrans Payment",
+      "title": "Midtrans — Indonesia Payment",
       "category": "payment",
       "version": "0.1.0",
-      "description": "Midtrans Snap checkout + webhook + transaction history. Provider-isolated under components/providers/midtrans + actions/midtrans so Doku/Stripe land as siblings.",
+      "description": "Pembayaran lokal Indonesia via Midtrans Snap (BCA, Mandiri, BRI, e-wallet GoPay/OVO/Dana, QRIS). Webhook untuk konfirmasi. Provider-isolated under components/providers/midtrans + actions/midtrans so Doku/Stripe land as siblings.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/midtrans-payment",
       "convexPaths": [
@@ -1224,14 +1225,14 @@
         "qris",
         "snap"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Midtrans Snap untuk pembayaran instant. Webhook ke Convex HTTP action /api/midtrans-callback untuk update order status. Ingat: PPN 11% sudah included di amount, jangan double-count."
     },
     {
       "slug": "resend-newsletter",
-      "title": "Resend Newsletter",
+      "title": "Resend — Transactional & Newsletter",
       "category": "email",
       "version": "0.1.0",
-      "description": "Subscribe form + admin send-broadcast pipeline via Resend.",
+      "description": "Transactional email + newsletter blast via Resend. Double opt-in flow + audience segmentation. Magic-link delivery for Convex Auth.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/resend-newsletter",
       "convexPaths": [
@@ -1266,7 +1267,7 @@
         "newsletter",
         "resend"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Use Resend Audiences API for newsletter — store subscriber emails in Convex too for segmentation. Double opt-in: subscriber.create with status 'pending' → click link → status 'confirmed'."
     },
     {
       "slug": "ai-router",
@@ -1301,14 +1302,14 @@
         "openrouter",
         "tier-routing"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Wrap every AI call through ai-router action. Pick tier based on workload: nano for spam-flag/headline-suggest, mid for chat/draft, flagship for methodology-review. Log token usage to ai_usage table for cost dashboard."
     },
     {
       "slug": "vector-search",
       "title": "Convex Vector Search",
       "category": "search",
       "version": "0.1.0",
-      "description": "Embeddings-based search via @convex-dev/vector-search. Embed on insert, query by vector similarity.",
+      "description": "Embeddings-based search via Convex's built-in vector index. Embed via OpenAI text-embedding-3-small (1536-dim), query via vectorIndex().",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/vector-search",
       "convexPaths": [
@@ -1334,16 +1335,17 @@
         "search",
         "vector",
         "embeddings",
-        "convex"
+        "convex",
+        "rag"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Add embedding field + vectorIndex per searchable table. Re-embed on upsert via Convex action. Cache embeddings — don't re-call OpenAI on every read."
     },
     {
       "slug": "mdx-blog",
       "title": "MDX Blog",
       "category": "content",
       "version": "0.1.0",
-      "description": "File-based MDX blog under content/blog/*.mdx. List + detail page + RSS feed. No backend.",
+      "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.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/mdx-blog",
       "convexPaths": [],
@@ -1364,7 +1366,7 @@
         "mdx",
         "static"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Store post body sebagai markdown di content/blog/*.mdx. Render dengan MDXRemote di [slug]/page.tsx. Auto-extract headings ke ToC via remark plugin custom."
     },
     {
       "slug": "cal-com-booking",
@@ -1403,15 +1405,15 @@
         "cal-com",
         "bookings"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Embed Cal.com via @calcom/embed-react di halaman services. Configure webhook di Cal.com dashboard → POST ke /api/cal-webhook → upsert booking di Convex."
     },
     {
       "slug": "broadcast-channel-sync",
-      "title": "BroadcastChannel Sync",
+      "title": "BroadcastChannel — Cross-tab Sync",
       "category": "realtime",
       "version": "0.1.0",
-      "description": "Cross-tab + cross-iframe state sync via BroadcastChannel + localStorage fallback. Tiny, no backend.",
-      "source": "rahmanef63/resource-site",
+      "description": "Same-origin cross-tab + cross-iframe state sync via BroadcastChannel API. Tiny, no backend, no install.",
+      "source": "Web Platform — BroadcastChannel API",
       "slicePath": "frontend/slices/broadcast-channel-sync",
       "convexPaths": [],
       "npm": [],
@@ -1422,9 +1424,10 @@
       "tags": [
         "realtime",
         "cross-tab",
-        "broadcast-channel"
+        "broadcast-channel",
+        "demo-pattern"
       ],
-      "agentRecipe": ""
+      "agentRecipe": "Use BroadcastChannel only for demo / cross-iframe state mirroring. Production data still goes through Convex realtime. Use the useBroadcastSync(channelName, initial) hook from @/features/broadcast-channel-sync."
     }
   ]
 }

package/lib/rr-schema.json

@@ -64,6 +64,20 @@
         }
       }
     },
+    "slices": {
+      "type": "array",
+      "description": "Tier-3 portable slice references — each entry mirrors a slice that has been lifted into this project.",
+      "items": {
+        "type": "object",
+        "required": ["slug"],
+        "properties": {
+          "slug": { "type": "string" },
+          "version": { "type": "string" },
+          "category": { "type": "string" },
+          "addedAt": { "type": "string", "format": "date" }
+        }
+      }
+    },
     "skills": {
       "type": "array",
       "items": {

package/lib/rr.mjs

@@ -36,6 +36,7 @@ export const DEFAULT_RR = {
   },
   template: null,
   features: [],
+  slices: [],
   skills: [],
   auth: { provider: "convex-auth" },
   convex: { self_hosted: true },
@@ -91,6 +92,23 @@ export function addFeature(rr, slug, version = "main") {
   return rr;
 }
 
+export function addSlice(rr, slug, opts = {}) {
+  rr.slices = rr.slices ?? [];
+  const existing = rr.slices.find((s) => s.slug === slug);
+  if (existing) {
+    if (opts.version) existing.version = opts.version;
+    if (opts.category) existing.category = opts.category;
+    return rr;
+  }
+  rr.slices.push({ slug, version: opts.version ?? "main", category: opts.category, addedAt: today() });
+  return rr;
+}
+
+export function removeSlice(rr, slug) {
+  rr.slices = (rr.slices ?? []).filter((s) => s.slug !== slug);
+  return rr;
+}
+
 export function addSkill(rr, slug, source = "anthropics", version = "main") {
   rr.skills = rr.skills ?? [];
   if (rr.skills.find((s) => s.slug === slug && s.source === source)) return rr;
@@ -125,6 +143,7 @@ export function validateRr(rr) {
     issues.push(`layout.kind must be vertical-slice|feature-folders (got ${rr.layout.kind})`);
   }
   if (rr.features && !Array.isArray(rr.features)) issues.push("features must be an array");
+  if (rr.slices && !Array.isArray(rr.slices)) issues.push("slices must be an array");
   if (rr.skills && !Array.isArray(rr.skills)) issues.push("skills must be an array");
   return issues;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rahman-resources",
-  "version": "0.7.0",
+  "version": "0.9.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.",
   "type": "module",
   "license": "MIT",