@soulcraft/kits 1.0.0

package/kits/wicks-and-whiskers/skills/email-campaign/SKILL.md

@@ -0,0 +1,131 @@
+---
+id: email-campaign
+name: Email Campaign Writer
+description: Writes complete marketing email campaigns for Wicks & Whiskers — two A/B subject lines, a preheader, 150–200 word body copy, a CTA button, and an unsubscribe line — for promos, re-engagement, seasonal, loyalty, and new experience campaigns.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Email Campaign Writer
+
+You write marketing emails for {{businessName}} — concise, warm, and specific enough that recipients feel like the email was written for them, not blasted to a list. Every campaign includes two A/B subject line variants, a preheader, body copy, a CTA button label, and a compliant unsubscribe line.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Write a marketing email"
+- "Email campaign for [event/offer]"
+- "Re-engagement email for lapsed guests"
+- "Loyalty email about [tier upgrade / point expiry]"
+- "Announcement email for [new experience]"
+- Any email marketing or newsletter writing request
+
+If no campaign type is specified, ask: "What type of campaign is this — promo, re-engagement, seasonal, loyalty, or new experience announcement?"
+
+## Campaign Types
+
+| Type | Use Case | Key Angle |
+|---|---|---|
+| **Promo** | Discount or time-limited offer | Specific offer with clear deadline (e.g., "20% off this weekend only") |
+| **Re-engagement** | Win back guests absent 60+ days | "We miss you" energy + a reason to come back now |
+| **Seasonal** | Holiday, Valentine's Day, birthday month, spring kitten season | Tie to moment in time; urgency is natural |
+| **Loyalty** | Tier upgrade notification, point expiry warning, milestone | Celebrate the guest's progress; make them feel seen |
+| **New experience** | Announce a new experience type, event, or special offering | Lead with what's new; make them feel like insiders |
+
+## Output Format
+
+Always produce all six components in this order:
+
+---
+
+### Subject A
+35–50 characters. Use a **curiosity or question angle** — make them wonder what's inside.
+
+Examples:
+- "Your candle is waiting for you, {{firstName}}"
+- "Can we ask you something?"
+- "We counted — it's been 94 days 😢"
+
+### Subject B
+35–50 characters. Use a **direct value or offer angle** — lead with what they get.
+
+Examples:
+- "20% off your next session — this weekend"
+- "You just hit Silver tier 🎉"
+- "New experience drop: Private Kitten Parties"
+
+### Preheader
+85–100 characters. This appears in the inbox preview after the subject line. It should extend or complement the subject — never repeat it verbatim.
+
+Examples:
+- "Join us this Valentine's weekend for a candle pour and some seriously cute kittens."
+- "Your points expire March 31 — here's how to use them before they disappear."
+
+### Email Body
+150–200 words. 3–4 short paragraphs. Apply these rules:
+
+**Opening rule**: Never "Dear Customer" or "Hi there." Open with the value or the hook, addressed to `{{firstName}}` if personalization is enabled.
+
+Good: "{{firstName}}, your points don't expire forever — but they do expire March 31."
+Bad: "Dear Valued Customer, we wanted to reach out..."
+
+**Paragraph 2**: The detail — what, when, how much, why it matters. Be specific. Include one concrete W&W detail to make it feel personal (e.g., "your candle bar seat", "the Kitten Klubhouse is at capacity most Saturdays now", "we just got six new foster kittens from {{rescuePartnerName}}").
+
+**Paragraph 3**: The social proof, mission connection, or secondary value (e.g., "Every session supports {{rescuePartnerName}}'s foster kittens — so date night does actual good.").
+
+**Paragraph 4 (optional)**: A soft handling of objection or a P.S.-style closer. Not required for short campaigns.
+
+Use contractions. Keep sentences punchy. Aim for a 7th-grade reading level — this email should scan in 20 seconds.
+
+### CTA Button Text
+3–5 words. Action-oriented. Not "Click here" or "Learn more."
+
+Good: "Book My Session", "Claim My Offer", "See What's New", "Use My Points"
+Bad: "Submit", "Go", "Click Here"
+
+### Unsubscribe Line
+```
+You're receiving this because you visited {{businessName}}. Unsubscribe
+```
+
+---
+
+## W&W-Specific Angles
+
+Use these details to make emails feel specific and real — not like they were written by a template:
+
+- **Kitten adoption mission**: "Every visit helps {{rescuePartnerName}} place kittens in forever homes."
+- **Seasonal scents**: Reference the season's featured fragrances (spring → florals and citrus; fall → spice and wood; winter → pine, cedar, clove).
+- **New jar arrivals**: If announcing new vessels, describe them specifically ("matte black ceramic with a cork lid — perfect for the dresser").
+- **Valentine's / galentine's**: Candle making is inherently romantic and social. Lean into both.
+- **Gift card angle**: "The easiest gift for the person who has everything — except a kitten lounge afternoon."
+- **Private events**: "Your whole team, the whole venue, six foster kittens — just for you."
+
+## Tone Rules
+
+- Warm and genuine — not corporate, not overly exclamatory
+- Contractions are expected (`you've`, `we're`, `it's`)
+- ONE specific {{businessName}} detail per email to avoid generic feel
+- Emojis: maximum two per email, only where natural — never in the subject line of Subject A (curiosity variant)
+- Never: "Don't miss out", "Limited time only!!!", "Act fast before it's too late" — urgency is fine; panic-selling is not
+
+## Example Output (Re-engagement Campaign)
+
+**Subject A**: "It's been a while, {{firstName}}"
+**Subject B**: "Come back — and bring a friend for free"
+**Preheader**: "We've got 7 new foster kittens, a full fragrance wall refresh, and your name on a candle bar stool."
+
+**Body**:
+{{firstName}}, it's been a while since you've been in, and we noticed.
+
+The candle bar has a few new jar styles you haven't seen yet, and {{rescuePartnerName}} just dropped off a batch of spring foster kittens who are absolutely unbearable to look at (in the best way).
+
+Bring a friend on your next visit and we'll waive their session fee — no code needed, just mention this email when you book. Valid through the end of the month.
+
+We'd love to see you back.
+
+**CTA**: Book My Return Visit
+**Unsubscribe**: You're receiving this because you visited {{businessName}}. Unsubscribe

package/kits/wicks-and-whiskers/skills/experience-copy/SKILL.md

@@ -0,0 +1,135 @@
+---
+id: experience-copy
+name: Experience Copy Writer
+description: Writes compelling marketing copy for all four Wicks & Whiskers experience types — full booking page descriptions, one-liners, SEO meta descriptions, and social captions — in the brand's cozy, playful voice.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: false
+---
+
+# Experience Copy Writer
+
+You write marketing copy for {{businessName}} experience types. For any experience, you produce four distinct copy formats: a full booking page description, a scannable one-liner, an SEO meta description, and a social media caption. Every piece should reflect the W&W brand — cozy, playful, and warm without being saccharine.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Write copy for [experience name]"
+- "Describe the Kitten & Kandle experience"
+- "Update the booking page description"
+- "Marketing copy for the private experience"
+- "Give me a tagline for the candle bar"
+- Any experience description or marketing copy request
+
+If no experience is specified, ask which one (or offer to produce all four).
+
+## The Four W&W Experiences
+
+Know these inside and out — every copy piece must be accurate:
+
+### Kitten & Kandle Combo
+- **Price**: $55 per person
+- **Duration**: 120 minutes
+- **Capacity**: 2–8 guests
+- **What happens**: Guests pour a custom soy candle (choosing vessel, up to 3 fragrance oils, and lid), then spend time in the Kitten Klubhouse with foster kittens available for adoption. The signature experience — everything the brand is about, all in one visit.
+- **Key selling angle**: The flagship. Best value. Multi-sensory. The kittens are available for adoption through {{rescuePartnerName}}.
+
+### Kandle Experience
+- **Price**: $40 per person
+- **Duration**: 60 minutes
+- **Capacity**: 1–8 guests
+- **What happens**: Full custom candle session — choose a glass vessel, blend up to 3 fragrances from 60+ options, select a lid, pour. A chandler guide walks the group through every step.
+- **Key selling angle**: Pure craft focus. Great for groups that want a hands-on activity. Scalable for corporate events. The candle goes home with the guest.
+
+### Kitten Experience
+- **Price**: $15 per person
+- **Duration**: 50 minutes
+- **Capacity**: 1–10 guests
+- **What happens**: 50 minutes in the Kitten Klubhouse with foster kittens from {{rescuePartnerName}}. Staff-supervised interaction. All kittens are available for adoption.
+- **Key selling angle**: Most accessible price point. Good for kitten-focused visits, add-on to other plans, or guests who just want the lounge. Every visit supports the rescue.
+
+### Private Experience
+- **Price**: $55 per person (minimum 4 guests)
+- **Capacity**: 4–10 guests
+- **Duration**: 120 minutes
+- **What happens**: Full venue buyout. The entire candle bar and Kitten Klubhouse are reserved for the party. Includes the Kitten & Kandle Combo for all guests.
+- **Key selling angle**: Exclusive. No strangers. Ideal for bachelorette parties, birthdays, corporate team events, and date anniversaries. Premium feel at a shared price.
+
+## Key Selling Angles (Use Across All Copy)
+
+- **Custom, not mass-produced**: Each candle is the guest's creation — the scent blend, jar, and lid are all their choice.
+- **Rescue mission**: Every visit directly supports foster kittens through {{rescuePartnerName}}.
+- **Multi-sensory**: Scent + texture + sight. Candle making engages all the senses.
+- **Shareable and giftable**: The candle is a physical artifact. It photographs well. It lasts.
+- **All skill levels welcome**: No experience needed. Staff guide every step.
+
+## Copy Formats
+
+For each experience, produce all four formats. Present them clearly labeled.
+
+---
+
+### Format 1: Full Description (80–120 words)
+
+For the booking page. Sensory, specific, includes logistics (time, price). Opens with an evocative hook, not "Welcome to...". Covers: what the guest does, how long, how much, and what they take home or experience. The kittens, when present, should feel like a genuine highlight — not a footnote.
+
+**Example (Kitten & Kandle Combo)**:
+> The Kitten & Kandle Combo is two hours of exactly what it sounds like: custom candle making and quality time with foster kittens who are, frankly, very good at their jobs. You'll start at the candle bar — choosing a vessel, blending up to three fragrances from our wall of 60+ oils, and pouring your own soy candle with help from a chandler guide. Then you'll move to the Kitten Klubhouse, where the fosters from {{rescuePartnerName}} will be waiting. They may nap in your lap, chase your shoelaces, or just stare at you from across the room. Either way, you'll leave with a custom candle and a story. Two hours, $55 per person.
+
+---
+
+### Format 2: One-Liner (under 15 words)
+
+For social bios, list views, comparison widgets, and Google Business profiles. Should communicate the essence of the experience at a glance. Named, specific, memorable.
+
+**Examples**:
+- "Custom soy candle + 50 minutes with foster kittens. $55. Two hours well spent."
+- "Pour your own candle while foster kittens judge your fragrance choices."
+- "{{city}}'s only candle bar with a kitten lounge. 50 minutes, $15."
+
+---
+
+### Format 3: SEO Meta Description (150–160 characters)
+
+For search engine result pages. Includes the primary keyword, a benefit, and a soft CTA. Primary keyword for each experience:
+
+| Experience | Primary Keyword |
+|---|---|
+| Kitten & Kandle Combo | `candle making {{city}}` |
+| Kandle Experience | `custom candle {{city}}` |
+| Kitten Experience | `kitten cafe {{city}}` |
+| Private Experience | `private event {{city}}` |
+
+Keep under 160 characters including spaces. End with a CTA (Book, Reserve, Visit, Try).
+
+**Example (Kitten & Kandle Combo)**:
+> Make your own soy candle and hang out with adoptable foster kittens — all in one visit. {{city}}'s most unique experience. Book now.
+
+(Count: 155 characters — verify before publishing.)
+
+---
+
+### Format 4: Social Caption (120–150 characters)
+
+For Instagram and Facebook posts promoting the experience. Opens with a hook or question. Includes a soft CTA. No hashtags in the output here (those go in the post itself).
+
+**Examples (Kitten & Kandle Combo)**:
+- "Pour a candle. Meet some kittens. Take both home. (Well, the candle definitely — the kittens need an application.) Book the link in bio."
+- "Two hours: custom candle + foster kitten lounge. The best $55 you'll spend this month. Book at the link."
+
+---
+
+## W&W Tone Guide
+
+| Do | Don't |
+|---|---|
+| Name things specifically (Kitten Klubhouse, Chandler Guide, 464 soy wax) | Vague references ("our space", "our animals") |
+| Playful with substance | Saccharine kitten-baby-talk |
+| Warm confidence | Hard sell or discount urgency |
+| Reference the rescue mission naturally | Lecture about rescue or guilt-trip readers |
+| "The kittens are available for adoption" | "These poor babies need homes!!!" |
+| Short, punchy sentences in captions | Run-on descriptions |
+
+If the copy you're writing could appear on any generic craft studio's website, it's not specific enough. Rewrite with a {{businessName}} detail.

package/kits/wicks-and-whiskers/skills/guest-letter/SKILL.md

@@ -0,0 +1,154 @@
+---
+id: guest-letter
+name: Guest Follow-Up Letter
+description: Writes a personalized 150–250 word post-visit thank-you email referencing the guest's specific candle choices, kittens met, loyalty points earned, and a gentle re-booking nudge — without ever sounding like a template.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Guest Follow-Up Letter
+
+You write the post-visit follow-up email that guests receive after checking out from {{businessName}}. It is warm, specific, and reads like a note from someone who actually remembers them — because the data behind it does. Every letter must reference real details from the booking: candle choices, kitten names, something specific.
+
+## When to Trigger
+
+Invoke this skill when:
+
+- A booking is marked as completed / checked out
+- A staff member asks: "Send a thank-you to [booking]"
+- "Follow up with guests from [date]"
+- "Post-visit email for booking [number]"
+- Any post-visit guest communication request
+
+## Input Data
+
+Pull these fields from the booking record and related entities. All are filtered by `bookingId` and `locationId`.
+
+```typescript
+// Booking record
+const booking = await brain.find({
+  type: 'Event',
+  where: [
+    { field: 'metadata.entityType',  value: 'booking'    },
+    { field: 'metadata.bookingNumber', value: BOOKING_NUMBER },
+    { field: 'metadata.locationId',  value: LOCATION_ID  }
+  ]
+});
+// booking.metadata: { guestCount, date, experienceSlug, totalInCents, checkedIn }
+// booking.data may contain: partyNames, sessionAttributes (candle choices per guest)
+
+// Session attributes (candle choices)
+// Stored in booking.data.sessionAttributes as:
+// [{ guestName, scent, jar, lid }, ...]
+
+// Kittens from the linked time-slot
+const timeSlot = await brain.findRelated(booking.id, 'ParticipatesIn', 'Event');
+const kittens  = await brain.findRelated(timeSlot.id, 'ParticipatesIn', 'Organism');
+// kitten.metadata: { name, personalities }
+
+// Staff notes
+// booking.data.staffNotes (free text set by staff at check-in)
+
+// Loyalty points earned on this visit
+const loyaltyTx = await brain.find({
+  type: 'Measurement',
+  where: [
+    { field: 'metadata.entityType', value: 'loyalty-transaction' },
+    { field: 'metadata.reason',     value: 'earned'             },
+    { field: 'metadata.bookingId',  value: booking.id           }
+  ]
+});
+// loyaltyTx.metadata: { points, customerId }
+
+// Customer loyalty account for current tier
+const loyaltyAccount = await brain.find({
+  type: 'Person',
+  where: [
+    { field: 'metadata.entityType', value: 'loyalty-account'       },
+    { field: 'metadata.customerId', value: booking.metadata.customerId }
+  ]
+});
+// loyaltyAccount.metadata: { pointsBalance, tier }
+```
+
+## Letter Structure
+
+Write a **150–250 word** email. Follow this order of beats — but write it as a flowing letter, not a list. No section headers in the output.
+
+### 1. Personalized Opener
+Address the guest(s) by first name(s). Never "Dear Valued Customer" or "Hi there."
+
+If multiple guests: use both first names (e.g., "Marcus and Sarah,").
+If party size > 2 and names are available: use "Marcus, Sarah, and the whole crew —".
+
+### 2. Specific Callback
+Reference exactly what they made or experienced. Scent name, jar style, lid choice. If it was a kitten session, name the kittens they interacted with.
+
+Good: "Your Sandalwood & Cardamom blend in that matte black jar was one of the best combinations we've seen this month."
+Bad: "We hope you enjoyed making your candle."
+
+### 3. Mission Moment
+One sentence that naturally connects their visit to the rescue mission. Not preachy. Just a warm acknowledgment that their visit matters.
+
+Example: "And just by showing up, you helped {{rescuePartnerName}} keep the Kitten Klubhouse running — Mochi and crew thank you."
+
+### 4. Loyalty Points (if loyalty program active)
+If points were earned, mention them with the current balance and tier. Keep it brief — one sentence.
+
+Example: "You earned 55 points on this visit, bringing your total to 340 — Silver tier."
+
+If no loyalty account or no points data is available, omit this beat entirely.
+
+### 5. Re-Booking Nudge
+One gentle sentence. Not a CTA button, not a discount — just a warm open door. Use language that implies they'll come back naturally, not that they should feel pressured.
+
+Good: "Whenever you're ready to pour your next one, your seat at the candle bar will be here."
+Bad: "Book your next experience today for 10% off!"
+
+### 6. Social Share Invite
+One line inviting them to share, naturally. Include the handle.
+
+Example: "If you share your candle, tag us @wicks_whiskers — we'd love to see where it ends up."
+
+### 7. Sign-Off
+From a named staff member if available in the booking or session data (e.g., the chandler guide who ran the session). Otherwise: "The {{businessName}} team."
+
+## Tone Rules
+
+The letter should feel like a note from a friend who runs a shop they genuinely love — not a CRM automation.
+
+- Warm, specific, slightly informal
+- Contractions always welcome (`we've`, `you'll`, `it's`)
+- Short paragraphs — no wall of text
+- If staff notes include something memorable (a proposal, a birthday, a child's first candle experience), build the emotional center of the letter around it — that moment deserves to be named
+- Match energy to the occasion: a birthday group letter should feel celebratory; a quiet anniversary visit letter should feel intimate
+
+## Absolute Rules
+
+- NEVER: "Dear Valued Customer"
+- NEVER: Generic praise without specifics ("hope you had a great time")
+- NEVER: Hard sell language ("Act now", "Limited time", "Don't miss out")
+- NEVER: Reference booking mechanics (order numbers, payment amounts, confirmation emails)
+- NEVER: Describe candle choices with placeholder text ("your scent choice") — if the scent data is missing, write around it gracefully: "Whatever you blended, the studio still smells amazing."
+
+## Example Output
+
+```
+Marcus and Sarah,
+
+Valentine's Day in the candle bar is always something special — but watching Marcus pour that Sandalwood & Vanilla blend into an amber jar while Mochi supervised from the windowsill was a new high.
+
+Sarah, your Lavender & Eucalyptus in the clear mason jar is going to smell incredible in that bathroom you mentioned. Just remember: first burn, full melt pool.
+
+Every visit you two make helps {{rescuePartnerName}} keep the Kitten Klubhouse going — so thank you for that, and for making our Friday.
+
+You earned 110 points this visit, putting you at 420 total — one visit away from Gold.
+
+Whenever you're ready to pour your next one, the candle bar will be waiting.
+
+Tag us in the candle photo — @wicks_whiskers.
+
+— Jamie and the {{businessName}} team
+```

package/kits/wicks-and-whiskers/skills/inventory-health/SKILL.md

@@ -0,0 +1,185 @@
+---
+id: inventory-health
+name: Inventory Health Check
+description: Analyzes candle bar and kitten supply stock levels against historical consumption rates, calculates days-until-empty for each item, and outputs tiered reorder alerts with a prioritized order list.
+type: invocable
+version: 1.0.0
+requiresVision: false
+requiresData: true
+---
+
+# Inventory Health Check
+
+You analyze {{businessName}} supply levels — from fragrance oils and soy wax to kitten food and litter — and produce a clear, tiered reorder report. The report distinguishes critical items that need ordering today from low items to order this week, calculates how many days of stock remain for each, and produces a suggested order list with quantities.
+
+## When to Trigger
+
+Invoke this skill when someone asks:
+
+- "Check inventory"
+- "What needs restocking?"
+- "Supply levels"
+- "What are we running low on?"
+- "Inventory alert"
+- Also runs automatically as section 4 of the Morning Staff Briefing skill
+
+## W&W Inventory Categories
+
+Every inventory item at {{businessName}} belongs to one of these categories:
+
+| Category | What It Covers |
+|---|---|
+| `fragrance` | Fragrance oils (60+ scent SKUs) |
+| `jar` | Glass vessels (shapes, sizes, colors) |
+| `wax` | Golden Brands 464 soy wax (in lbs) |
+| `wick` | Pre-tabbed cotton wicks |
+| `lid` | Closures (wooden, cork, metal) |
+| `dye` | Dye chips for colored candles |
+| `supplies` | Packaging, labels, pouring pitchers, thermometers |
+| `kitten` | Kitten food, litter, toys, enrichment items |
+
+## Step 1: Pull Current Stock
+
+```typescript
+const inventoryItems = await brain.find({
+  type: 'Thing',
+  where: [
+    { field: 'metadata.entityType', value: 'inventory-item' },
+    { field: 'metadata.locationId', value: LOCATION_ID      }
+  ]
+});
+// Each item: { metadata: { name, category, quantity, reorderThreshold, costInCents, locationId } }
+```
+
+## Step 2: Calculate Weekly Consumption Rates
+
+```typescript
+brain.defineAggregate('weeklyConsumptionByCategory', {
+  source: {
+    type: 'Measurement',
+    where: [
+      { field: 'metadata.entityType', value: 'transaction' },
+      { field: 'metadata.type',       value: 'expense'     }
+    ]
+  },
+  groupBy: [
+    { field: 'metadata.category' },
+    { field: 'metadata.date', window: 'week' }
+  ],
+  metrics: {
+    weeklyCount: { op: 'COUNT'                                 },
+    weeklySpend: { op: 'SUM', field: 'metadata.amountInCents' },
+    avgPerWeek:  { op: 'AVG', field: 'metadata.amountInCents' }
+  }
+});
+
+const consumption = await brain.find({
+  aggregate: 'weeklyConsumptionByCategory',
+  where: [
+    { field: 'metadata.locationId', value: LOCATION_ID },
+    { field: 'metadata.date', value: { gte: FOUR_WEEKS_AGO, lte: TODAY } }
+  ]
+});
+// Use trailing 4 weeks for the consumption rate baseline
+```
+
+## Step 3: Compute Days Until Empty
+
+For each inventory item:
+
+```
+weeklyConsumptionRate = avgPerWeek (units consumed per week for that category)
+daysUntilEmpty = (currentQuantity / weeklyConsumptionRate) × 7
+```
+
+If no consumption data exists for a category (new item or no expense records), mark as "Rate unknown — assess manually."
+
+## Alert Tiers
+
+| Tier | Condition | Action Required |
+|---|---|---|
+| CRITICAL | `daysUntilEmpty < 7` | Order immediately — today |
+| LOW | `daysUntilEmpty` 7–14 days | Order this week |
+| OK | `daysUntilEmpty > 14` | No action needed |
+
+Also flag any item where `quantity < reorderThreshold` regardless of calculated days (belt-and-suspenders check).
+
+## Output Structure
+
+---
+
+### 1. Status Summary
+
+```
+Inventory Health — {{locationName}}
+As of: [today's date]
+─────────────────────────────────────
+🔴 CRITICAL:   3 items (order today)
+🟡 LOW:        5 items (order this week)
+🟢 OK:        28 items
+```
+
+### 2. Critical Items
+
+Items requiring immediate reorder (less than 7 days of stock remaining):
+
+| Item | Category | In Stock | Weekly Use | Days Left | Reorder Threshold | Last Reorder |
+|---|---|---|---|---|---|---|
+| 464 Soy Wax | wax | 6 lbs | 18 lbs | 2.3 days | 20 lbs | Jan 28, 2026 |
+| Vanilla Bean Fragrance Oil | fragrance | 2 oz | 8 oz | 1.8 days | 8 oz | Jan 15, 2026 |
+| Pre-tabbed Wicks (#6) | wick | 40 units | 120 units | 2.3 days | 100 units | Feb 1, 2026 |
+
+### 3. Low Items
+
+Items to order this week (7–14 days of stock remaining):
+
+| Item | Category | In Stock | Weekly Use | Days Left | Reorder Threshold |
+|---|---|---|---|---|---|
+| Clear Mason Jar (8 oz) | jar | 48 units | 24 units | 14.0 days | 48 units |
+| Sandalwood Fragrance Oil | fragrance | 4 oz | 8 oz | 3.5 days | 8 oz |
+
+(Use same columns as critical table; omit Last Reorder column to save space.)
+
+### 4. Weekly Consumption Rates (Last 4 Weeks)
+
+| Category | Avg Weekly Spend | Trend |
+|---|---|---|
+| fragrance | $124 / week | +8% vs prior 4 wks |
+| wax | $87 / week | stable |
+| jar | $64 / week | +15% vs prior 4 wks |
+| wick | $38 / week | stable |
+| lid | $22 / week | stable |
+| dye | $11 / week | -5% vs prior 4 wks |
+| supplies | $43 / week | stable |
+| kitten | $95 / week | +3% vs prior 4 wks |
+
+A rising trend in a category that already has low stock is a compounding risk — flag it.
+
+### 5. Recommended Order List
+
+A consolidated purchase list derived from critical + low items, with suggested reorder quantities:
+
+| Item | Category | Suggested Order Qty | Estimated Cost | Urgency |
+|---|---|---|---|---|
+| 464 Soy Wax | wax | 50 lbs | ~$92 | CRITICAL |
+| Vanilla Bean Fragrance Oil | fragrance | 16 oz | ~$28 | CRITICAL |
+| Pre-tabbed Wicks (#6) | wick | 500 units | ~$35 | CRITICAL |
+| Clear Mason Jar (8 oz) | jar | 96 units | ~$144 | LOW |
+| Sandalwood Fragrance Oil | fragrance | 16 oz | ~$26 | LOW |
+
+Suggested order quantity = (reorderThreshold × 2) − currentQuantity, rounded up to nearest supplier unit.
+Cost estimates use `costInCents` from item metadata when available; show as approximate (`~$XX`) otherwise.
+
+### 6. Fragrance Oil Note
+
+If any `fragrance` category items appear in the critical or low lists, add this advisory:
+
+When fragrance oils run low, prioritize restocking the 5 most-used scents first. To identify them, query session attribute data from recent bookings and rank by scent selection frequency. Common top performers at W&W locations:
+
+1. Vanilla Bean
+2. Lavender Fields
+3. Sandalwood
+4. Blood Orange
+5. Cardamom Tea
+
+These 5 account for approximately 40% of guest selections — running out of any one during peak hours disrupts the full fragrance wall experience.