pantrybase 0.1.0 → 0.2.0

package/.claude-plugin/plugin.json

@@ -1,13 +1,19 @@
 {
   "name": "pantrybase",
   "displayName": "Pantrybase",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local-first recipe knowledge base for Claude Code: capture meal-box recipe cards from photos, search by ingredient, tag, allergen or mood, match recipes to your pantry, and synthesize new recipes. SQLite FTS5 + vector search, markdown recipes as the source of truth.",
   "author": {
     "name": "Ryan Dick"
   },
   "license": "MIT",
-  "keywords": ["recipes", "pantry", "meal-kit", "knowledge-graph", "search"],
+  "keywords": [
+    "recipes",
+    "pantry",
+    "meal-kit",
+    "knowledge-graph",
+    "search"
+  ],
   "mcpServers": {
     "pantrybase": {
       "command": "${CLAUDE_PLUGIN_ROOT}/bin/pb-server",

package/dist/{chunk-2EMC6TJB.js → chunk-QUWSBZ2V.js}

@@ -1056,6 +1056,7 @@ function loadProfile(dir) {
     recognise: raw.recognise ?? [],
     sides: { front: raw.sides?.front ?? [], back: raw.sides?.back ?? [] },
     pairing: raw.pairing ?? "content",
+    orientation: raw.orientation ?? null,
     nutrition_basis: raw.nutrition_basis ?? "per_serving",
     default_servings: raw.default_servings ?? null,
     kitchen_section: raw.kitchen_section ?? null,
@@ -2421,6 +2422,25 @@ async function openImage(file) {
   const input = HEIF_EXTS.has(path6.extname(file).toLowerCase()) ? await heifToJpeg(file) : file;
   return sharp(input, { failOn: "none" }).rotate();
 }
+async function rotateFile(file, degrees) {
+  const ext = path6.extname(file).toLowerCase();
+  const upright = await (await openImage(file)).toBuffer();
+  let pipeline = sharp(upright, { failOn: "none" }).rotate(degrees);
+  let target = file;
+  if (ext === ".png") pipeline = pipeline.png();
+  else if (ext === ".webp") pipeline = pipeline.webp({ quality: 92 });
+  else if (ext === ".tif" || ext === ".tiff") pipeline = pipeline.tiff();
+  else {
+    pipeline = pipeline.jpeg({ quality: 92, mozjpeg: true });
+    if (HEIF_EXTS.has(ext)) target = `${file.slice(0, -ext.length)}.jpg`;
+  }
+  const out = await pipeline.toBuffer();
+  const tmp = `${target}.rotating-${process.pid}`;
+  fs9.writeFileSync(tmp, out);
+  fs9.renameSync(tmp, target);
+  if (target !== file) fs9.rmSync(file, { force: true });
+  return target;
+}
 async function imageForModel(file, maxPx = MODEL_MAX_PX) {
   const base = await (await openImage(file)).resize(maxPx, maxPx, { fit: "inside", withoutEnlargement: true }).toBuffer({ resolveWithObject: true });
   let data = base.data;
@@ -2686,6 +2706,29 @@ async function addUpload(ctx, name, data) {
   await scanInbox(ctx);
   return ctx.store.ingestByPath(relativeToData(ctx.paths, target));
 }
+function shapeOf(item) {
+  const w = item.width ?? 0;
+  const h = item.height ?? 0;
+  if (w > h * 1.1) return "landscape";
+  if (h > w * 1.1) return "portrait";
+  return "square";
+}
+function dominantShape(all) {
+  const counts = { landscape: 0, portrait: 0, square: 0 };
+  for (const i of all) if (i.width && i.height) counts[shapeOf(i)]++;
+  const total = counts.landscape + counts.portrait + counts.square;
+  if (total < 3) return null;
+  const [shape, n] = Object.entries(counts).sort(
+    (a, b) => b[1] - a[1]
+  )[0] ?? ["square", 0];
+  return shape !== "square" && n / total >= 0.7 ? shape : null;
+}
+function rotationHint(item, dominant) {
+  if (!dominant) return void 0;
+  const shape = shapeOf(item);
+  if (shape === "square" || shape === dominant) return void 0;
+  return `${shape} while most photos are ${dominant} \u2014 it may be sideways; if the text doesn't read upright, pb_inbox_rotate it`;
+}
 function retakeHint(item, all) {
   let best;
   for (const other of all) {
@@ -2698,26 +2741,63 @@ function retakeHint(item, all) {
   }
   return best;
 }
-function viewItem(item, all) {
+function viewItem(item, all, dominant = all ? dominantShape(all) : null) {
   const v = {
     id: item.id,
     name: item.original_name,
     captured_at: item.captured_at,
     size: `${item.width}x${item.height}`,
-    status: item.status
+    status: item.status,
+    version: item.mtime
   };
   if (item.recipe_slug) v.recipe_slug = item.recipe_slug;
   if (item.reason) v.reason = item.reason;
   if (all) {
     const r = retakeHint(item, all);
     if (r) v.retake_of = r;
+    const hint = rotationHint(item, dominant);
+    if (hint) v.rotation_hint = hint;
   }
   return v;
 }
+function viewItems(items, all) {
+  const dominant = dominantShape(all);
+  return items.map((i) => viewItem(i, all, dominant));
+}
 function nextBatch(ctx, window = 4) {
   const all = ctx.store.allIngest();
   const items = all.filter((i) => i.status === "pending").slice(0, Math.max(1, window));
-  return { progress: ctx.store.ingestCounts(), items: items.map((i) => viewItem(i, all)) };
+  return { progress: ctx.store.ingestCounts(), items: viewItems(items, all) };
+}
+async function rotateItem(ctx, id, degrees) {
+  const [item] = ctx.store.ingestByIds([id]);
+  if (!item) throw new Error(`no photo #${id}`);
+  const abs = path7.join(ctx.paths.data, item.path);
+  if (!fs10.existsSync(abs)) throw new Error(`photo #${id} is missing on disk (${item.path})`);
+  const heif = /\.(heic|heif)$/i.test(abs);
+  if (item.status === "done" && heif) {
+    throw new Error(
+      `photo #${id} is an archived HEIC; rotating would rename the file ${item.recipe_slug} uses`
+    );
+  }
+  const target = await rotateFile(abs, degrees);
+  const info = await inspectImage(target);
+  const rel = relativeToData(ctx.paths, target);
+  const clash = ctx.store.ingestBySha(info.sha256);
+  if (clash && clash.id !== item.id)
+    throw new Error(`rotated photo #${id} is identical to #${clash.id}`);
+  ctx.store.updateIngest(item.id, {
+    path: rel,
+    sha256: info.sha256,
+    phash: info.phash,
+    width: info.width,
+    height: info.height,
+    bytes: info.bytes,
+    mtime: info.mtime,
+    mime: info.mime
+  });
+  const updated = ctx.store.ingestByIds([id])[0] ?? item;
+  return viewItem(updated, ctx.store.allIngest());
 }
 function resolveItems(ctx, ids, status, reason) {
   const out = { moved: 0, refused: [] };
@@ -3159,7 +3239,7 @@ function routes(ctx, version) {
       });
       return {
         counts: ctx.store.ingestCounts(),
-        items: items.map((i) => ({ ...viewItem(i, all), path: i.path }))
+        items: viewItems(items, all).map((v, n) => ({ ...v, path: items[n]?.path ?? "" }))
       };
     }),
     r("POST", /^\/api\/inbox\/upload$/, async (req) => {
@@ -3170,6 +3250,13 @@ function routes(ctx, version) {
       const item = await addUpload(ctx, name, data);
       return { item: item ? viewItem(item) : null, counts: ctx.store.ingestCounts() };
     }),
+    r("POST", /^\/api\/inbox\/rotate$/, async (req) => {
+      const body = await readJson(req);
+      if (typeof body.id !== "number" || ![90, 180, 270].includes(body.degrees ?? 0)) {
+        throw new HttpError(400, "id and degrees (90|180|270, clockwise) required");
+      }
+      return { item: await rotateItem(ctx, body.id, body.degrees) };
+    }),
     r("POST", /^\/api\/inbox\/resolve$/, async (req) => {
       const body = await readJson(req);
       if (!body.ids?.length || !["pending", "skipped", "failed"].includes(body.status ?? "")) {
@@ -3323,8 +3410,9 @@ export {
   imageForModel,
   maybeScanInbox,
   importPaths,
-  viewItem,
+  viewItems,
   nextBatch,
+  rotateItem,
   resolveItems,
   planAttach,
   finalizeAttach,
@@ -3338,4 +3426,4 @@ export {
   matchRecipes,
   startUiServer
 };
-//# sourceMappingURL=chunk-2EMC6TJB.js.map
+//# sourceMappingURL=chunk-QUWSBZ2V.js.map

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   resolveProjectRoot,
   searchRecipes,
   startUiServer
-} from "./chunk-2EMC6TJB.js";
+} from "./chunk-QUWSBZ2V.js";
 
 // src/cli.ts
 import { spawn } from "child_process";

package/dist/server.js

@@ -28,12 +28,13 @@ import {
   removeFromPantry,
   resolveItem,
   resolveItems,
+  rotateItem,
   scoreRecipes,
   searchRecipes,
   startUiServer,
-  viewItem,
+  viewItems,
   writeRecipeFile
-} from "./chunk-2EMC6TJB.js";
+} from "./chunk-QUWSBZ2V.js";
 
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -136,7 +137,7 @@ import path from "path";
 import { z as z3 } from "zod";
 var pb_inbox_image_default = defineTool({
   name: "pb_inbox_image",
-  description: "Show one queued (or archived) photo as an image, resized for reading (long edge \u2264 1600px by default; ask for up to 2400 if small print is unreadable). HEIC is converted automatically.",
+  description: "Show one queued (or archived) photo as an image, resized for reading (long edge \u2264 1600px by default; ask for up to 2400 if small print is unreadable). HEIC is converted automatically. If the text runs sideways or upside down, fix it with pb_inbox_rotate and look again.",
   schema: {
     id: z3.number().int(),
     max_px: z3.number().int().min(400).max(2400).optional()
@@ -175,7 +176,10 @@ var pb_inbox_list_default = defineTool({
   },
   handler: ({ status, limit, offset }, ctx) => {
     const items = ctx.store.listIngest({ status, limit: limit ?? 20, offset });
-    return text({ counts: ctx.store.ingestCounts(), items: items.map((i) => viewItem(i)) });
+    return text({
+      counts: ctx.store.ingestCounts(),
+      items: viewItems(items, ctx.store.allIngest())
+    });
   }
 });
 
@@ -183,7 +187,7 @@ var pb_inbox_list_default = defineTool({
 import { z as z5 } from "zod";
 var pb_inbox_next_default = defineTool({
   name: "pb_inbox_next",
-  description: "The next pending inbox photos in capture order, plus queue progress. Cards are usually shot front then back (a back has no title), so look at the photos in order with pb_inbox_image, group the ones that belong to one card, and save it with pb_save_recipe {ingest:[{id, side}]}. `retake_of` flags a near-identical photo: attach it as an extra image or skip it with pb_inbox_resolve.",
+  description: "The next pending inbox photos in capture order, plus queue progress. Cards are usually shot front then back (a back has no title), so look at the photos in order with pb_inbox_image, group the ones that belong to one card, and save it with pb_save_recipe {ingest:[{id, side}]}. `retake_of` flags a near-identical photo: attach it as an extra image or skip it with pb_inbox_resolve. `rotation_hint` flags a photo whose shape differs from the rest \u2014 rotate it with pb_inbox_rotate if it reads sideways.",
   schema: {
     window: z5.number().int().min(1).max(12).optional().describe("How many photos to return (default 4)")
   },
@@ -210,14 +214,26 @@ var pb_inbox_resolve_default = defineTool({
   }
 });
 
-// src/mcp/tools/pb_ingest_source.ts
+// src/mcp/tools/pb_inbox_rotate.ts
 import { z as z7 } from "zod";
+var pb_inbox_rotate_default = defineTool({
+  name: "pb_inbox_rotate",
+  description: "Turn a photo upright when its text runs sideways or upside down (camera orientation flags are already applied, so this is for photos whose pixels are rotated). Degrees are clockwise: text reading bottom-to-top needs 90, upside down needs 180, top-to-bottom needs 270. The file is fixed on disk (HEIC becomes JPEG), so the archive, thumbnails and retake detection all see the upright photo. Call before pb_inbox_image when pb_inbox_next gives a rotation_hint, or after a photo shows up sideways; view it again to confirm.",
+  schema: {
+    id: z7.number().int(),
+    degrees: z7.union([z7.literal(90), z7.literal(180), z7.literal(270)])
+  },
+  handler: async ({ id, degrees }, ctx) => text({ rotated: degrees, item: await rotateItem(ctx, id, degrees) })
+});
+
+// src/mcp/tools/pb_ingest_source.ts
+import { z as z8 } from "zod";
 var pb_ingest_source_default = defineTool({
   name: "pb_ingest_source",
   description: "Copy recipe photos (JPEG, PNG, WebP, HEIC, TIFF) from files or folders into pantrybase/inbox/ for extraction. Originals are never moved or changed; photos already known (same bytes) are skipped. Folders are searched recursively by default. Returns counts and the queue state; then work through it with pb_inbox_next.",
   schema: {
-    paths: z7.array(z7.string()).min(1).describe("Files or folders; relative to the project, absolute, or ~/\u2026"),
-    recursive: z7.boolean().optional()
+    paths: z8.array(z8.string()).min(1).describe("Files or folders; relative to the project, absolute, or ~/\u2026"),
+    recursive: z8.boolean().optional()
   },
   handler: async ({ paths, recursive }, ctx) => {
     const r = await importPaths(ctx, paths, { recursive });
@@ -234,13 +250,13 @@ var pb_ingest_source_default = defineTool({
 });
 
 // src/mcp/tools/pb_list_tags.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var pb_list_tags_default = defineTool({
   name: "pb_list_tags",
   description: "Tags and facets in use, with recipe counts, grouped by category. With vocabulary:true also returns the allowed vocabulary (closed categories list every value). Call once before a batch of saves and reuse existing values.",
   schema: {
-    category: z8.enum(ALL_CATEGORIES).optional(),
-    vocabulary: z8.boolean().optional()
+    category: z9.enum(ALL_CATEGORIES).optional(),
+    vocabulary: z9.boolean().optional()
   },
   handler: ({ category, vocabulary }, ctx) => {
     const used = {};
@@ -259,7 +275,7 @@ var pb_list_tags_default = defineTool({
 });
 
 // src/mcp/tools/pb_merge_ingredients.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 
 // src/ingredients/merge.ts
 import fs from "fs";
@@ -363,8 +379,8 @@ var pb_merge_ingredients_default = defineTool({
   name: "pb_merge_ingredients",
   description: "Merge an ingredient into another when they are the same thing (e.g. 'pitted dates' into 'dates'). Rewrites every recipe file that uses it, moves aliases and the pantry entry, and records the alias in ingredients.yaml so future saves resolve to the target. Check pb_save_recipe's new_ingredients after a batch for candidates.",
   schema: {
-    from: z9.string().min(1),
-    into: z9.string().min(1)
+    from: z10.string().min(1),
+    into: z10.string().min(1)
   },
   handler: ({ from, into }, ctx) => text(mergeIngredients(ctx, from, into))
 });
@@ -381,7 +397,7 @@ var pb_open_ui_default = defineTool({
 });
 
 // src/mcp/tools/pb_pantry.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var pb_pantry_list = defineTool({
   name: "pb_pantry_list",
   description: "What's in the pantry: canonical ingredient names with optional quantity, unit and note.",
@@ -403,12 +419,12 @@ var pb_pantry_add = defineTool({
   name: "pb_pantry_add",
   description: "Add items to the pantry (or update their quantity). Names are matched to the ingredient catalog (aliases, plurals and regional names: 'eggs', 'baby marrow', 'spring onions'); unknown names become new ingredients.",
   schema: {
-    items: z10.array(
-      z10.object({
-        name: z10.string().min(1),
-        qty: z10.number().nullable().optional(),
-        unit: z10.string().nullable().optional(),
-        note: z10.string().nullable().optional()
+    items: z11.array(
+      z11.object({
+        name: z11.string().min(1),
+        qty: z11.number().nullable().optional(),
+        unit: z11.string().nullable().optional(),
+        note: z11.string().nullable().optional()
       })
     ).min(1)
   },
@@ -418,8 +434,8 @@ var pb_pantry_remove = defineTool({
   name: "pb_pantry_remove",
   description: "Remove items from the pantry by name, or everything with all:true.",
   schema: {
-    names: z10.array(z10.string()).optional(),
-    all: z10.boolean().optional()
+    names: z11.array(z11.string()).optional(),
+    all: z11.boolean().optional()
   },
   handler: ({ names, all }, ctx) => {
     if (all) return text({ cleared: ctx.store.pantryClear() });
@@ -428,19 +444,19 @@ var pb_pantry_remove = defineTool({
 });
 
 // src/mcp/tools/pb_pantry_match.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 var pb_pantry_match_default = defineTool({
   name: "pb_pantry_match",
   description: "What can I cook? Ranks recipes by how much of their required ingredients the pantry covers (staples like salt, oil and 'from your kitchen' items, and optional items, never count against a recipe; printed alternatives and the parts of composite ingredients do count). Add `ingredients` for things you have right now; use_pantry:false to match only those. Returns coverage, what's missing, and near misses (1\u20132 items short).",
   schema: {
-    ingredients: z11.array(z11.string()).optional(),
-    use_pantry: z11.boolean().optional().describe("default true"),
-    min_coverage: z11.number().min(0).max(1).optional().describe("default 0.5"),
-    max_missing: z11.number().int().min(0).optional(),
-    limit: z11.number().int().min(1).max(50).optional().describe("default 10"),
-    tags: z11.partialRecord(z11.enum(ALL_CATEGORIES), z11.array(z11.string())).optional(),
-    exclude_allergens: z11.array(z11.string()).optional(),
-    max_total_min: z11.number().optional()
+    ingredients: z12.array(z12.string()).optional(),
+    use_pantry: z12.boolean().optional().describe("default true"),
+    min_coverage: z12.number().min(0).max(1).optional().describe("default 0.5"),
+    max_missing: z12.number().int().min(0).optional(),
+    limit: z12.number().int().min(1).max(50).optional().describe("default 10"),
+    tags: z12.partialRecord(z12.enum(ALL_CATEGORIES), z12.array(z12.string())).optional(),
+    exclude_allergens: z12.array(z12.string()).optional(),
+    max_total_min: z12.number().optional()
   },
   handler: ({ ingredients, use_pantry, min_coverage, max_missing, limit, ...filters }, ctx) => {
     const r = matchRecipes(ctx, {
@@ -467,12 +483,12 @@ var pb_pantry_match_default = defineTool({
 });
 
 // src/mcp/tools/pb_providers.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 var pb_providers_default = defineTool({
   name: "pb_providers",
   description: "Meal-box provider profiles. Without `id`: list them (id, name, how to recognise a card). With `id`: the extraction guide for that provider's cards plus the tag vocabulary \u2014 read it once before extracting a batch of cards.",
   schema: {
-    id: z12.string().optional().describe('e.g. "ucook"; "generic" for anything else')
+    id: z13.string().optional().describe('e.g. "ucook"; "generic" for anything else')
   },
   handler: ({ id }, ctx) => {
     if (!id) {
@@ -500,6 +516,7 @@ var pb_providers_default = defineTool({
         `- Brands stripped from canonical names: ${p.brands.join(", ") || "none"}`,
         `- Kitchen items treated as equipment: ${Object.keys(p.equipment_terms).join(", ") || "none"}`,
         `- Nutrition basis default: ${p.nutrition_basis}; default servings: ${p.default_servings ?? "none"}`,
+        `- Upright card shape: ${p.orientation ?? "varies"} (photos that don't match are flagged with rotation_hint; fix them with pb_inbox_rotate)`,
         "",
         "## Tag vocabulary (closed = only these values; open = top values, new ones allowed)",
         ...Object.entries(summary).map(
@@ -511,13 +528,13 @@ var pb_providers_default = defineTool({
 });
 
 // src/mcp/tools/pb_rebuild.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 var pb_rebuild_default = defineTool({
   name: "pb_rebuild",
   description: "Re-sync the index from pantrybase/recipes/*.md (markdown is the source of truth), reloading ingredients.yaml, vocabulary.yaml and provider profiles. Default is incremental (mtime/hash); full:true re-parses every file (use after editing the vocabulary or catalog); reembed:true also recomputes all embeddings.",
   schema: {
-    full: z13.boolean().optional(),
-    reembed: z13.boolean().optional()
+    full: z14.boolean().optional(),
+    reembed: z14.boolean().optional()
   },
   handler: ({ full, reembed }, ctx) => {
     const reloaded = ctx.refresh(true);
@@ -527,7 +544,7 @@ var pb_rebuild_default = defineTool({
 });
 
 // src/mcp/tools/pb_save_recipe.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 
 // src/files/slug.ts
 var MAX_SLUG = 60;
@@ -628,10 +645,10 @@ var pb_save_recipe_default = defineTool({
   description: "Save a recipe (new or, with `slug`, an update). Writes pantrybase/recipes/<slug>.md as the source of truth and indexes it. For meal-box cards read pb_providers {id} first and follow its guide; set provider.id so its rules apply. Pass `ingest` with every inbox photo of the card ({id, side}) \u2014 they are archived to images/<slug>/ and marked done; re-sending already-attached photos is a safe no-op. Ingredients need `raw` (as printed) and `canonical` (generic singular name, no brand) plus source box|kitchen. Steps are objects {title, text, techniques, uses, equipment, temp_c, minutes} (plain strings are accepted). Tags by category (protein, diet, starch, flavor, texture, cuisine, dish, meal, method, time, season, other) are normalised against the vocabulary. Write a `blurb` in your own words for semantic search and record unreadable fields in extraction.uncertain. Returns {saved, slug, \u2026} or {saved:false, duplicate_of:[\u2026]} \u2014 if it is a different recipe pass allow_duplicate:true; if it is the same card, attach the photos to that slug or skip them.",
   schema: {
     ...recipeInputSchema.shape,
-    ingest: z14.array(z14.object({ id: z14.number().int(), side: z14.enum(IMAGE_SIDES) })).optional().describe(
+    ingest: z15.array(z15.object({ id: z15.number().int(), side: z15.enum(IMAGE_SIDES) })).optional().describe(
       "Inbox photos of this card, e.g. [{id: 12, side: 'front'}, {id: 13, side: 'back'}]"
     ),
-    allow_duplicate: z14.boolean().optional()
+    allow_duplicate: z15.boolean().optional()
   },
   handler: ({ allow_duplicate, ingest, ...input }, ctx) => {
     return text(saveRecipe(ctx, input, { allow_duplicate, ingest }));
@@ -639,22 +656,22 @@ var pb_save_recipe_default = defineTool({
 });
 
 // src/mcp/tools/pb_search.ts
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
 var pb_search_default = defineTool({
   name: "pb_search",
   description: "Search recipes: hybrid keyword + semantic ranking (RRF) over title, blurb, ingredients and method, with filters. Omit `query` to just filter/browse. Tag filters accept any category \u2014 assigned tags (cuisine, diet, dish, protein, flavor\u2026) and derived facets (allergen, equipment, technique, chef, provider, plan); parents expand (cuisine:asian matches thai). Returns compact summaries; use pb_get_recipe for details.",
   schema: {
-    query: z15.string().optional().describe("Free text: dish, ingredient, technique, mood, occasion\u2026"),
-    limit: z15.number().int().min(1).max(100).optional().describe("default 10"),
-    tags: z15.partialRecord(z15.enum(ALL_CATEGORIES), z15.array(z15.string())).optional().describe("e.g. {cuisine:['thai'], diet:['vegetarian']} \u2014 OR within a category, AND across"),
-    exclude_allergens: z15.array(z15.string()).optional().describe('e.g. ["dairy", "tree-nuts"]'),
-    exclude_ingredients: z15.array(z15.string()).optional(),
-    max_total_min: z15.number().optional(),
-    max_active_min: z15.number().optional().describe("Hands-on minutes"),
-    provider: z15.string().optional(),
-    source_kind: z15.enum(SOURCE_KINDS).optional(),
-    needs_review: z15.boolean().optional().describe("true = only recipes flagged for review"),
-    mode: z15.enum(["hybrid", "lexical", "semantic"]).optional()
+    query: z16.string().optional().describe("Free text: dish, ingredient, technique, mood, occasion\u2026"),
+    limit: z16.number().int().min(1).max(100).optional().describe("default 10"),
+    tags: z16.partialRecord(z16.enum(ALL_CATEGORIES), z16.array(z16.string())).optional().describe("e.g. {cuisine:['thai'], diet:['vegetarian']} \u2014 OR within a category, AND across"),
+    exclude_allergens: z16.array(z16.string()).optional().describe('e.g. ["dairy", "tree-nuts"]'),
+    exclude_ingredients: z16.array(z16.string()).optional(),
+    max_total_min: z16.number().optional(),
+    max_active_min: z16.number().optional().describe("Hands-on minutes"),
+    provider: z16.string().optional(),
+    source_kind: z16.enum(SOURCE_KINDS).optional(),
+    needs_review: z16.boolean().optional().describe("true = only recipes flagged for review"),
+    mode: z16.enum(["hybrid", "lexical", "semantic"]).optional()
   },
   handler: async ({ query, limit, mode, ...filters }, ctx) => {
     const res = await searchRecipes(ctx, { query, limit, mode, filters });
@@ -695,7 +712,7 @@ var pb_stats_default = defineTool({
 });
 
 // src/mcp/tools/pb_synthesis_context.ts
-import { z as z16 } from "zod";
+import { z as z17 } from "zod";
 
 // src/synthesis/context.ts
 var STEP_CHARS = 220;
@@ -829,14 +846,14 @@ var pb_synthesis_context_default = defineTool({
   name: "pb_synthesis_context",
   description: "Material for inventing a new recipe from the collection: a few relevant source recipes in compact form, the ingredients, pairings, techniques, cuisines and flavours they share, and (with use_pantry) what the pantry covers and what is commonly missing. Pick sources by `query`, explicit `slugs`, pantry fit, or tag filters. Then write the recipe and save it with pb_save_recipe (source.kind 'synthesized', derived_from the slugs you drew on).",
   schema: {
-    query: z16.string().optional().describe('What to make, e.g. "quick spicy noodle dinner"'),
-    slugs: z16.array(z16.string()).optional(),
-    use_pantry: z16.boolean().optional(),
-    ingredients: z16.array(z16.string()).optional().describe("Extra things available right now"),
-    tags: z16.partialRecord(z16.enum(ALL_CATEGORIES), z16.array(z16.string())).optional(),
-    exclude_allergens: z16.array(z16.string()).optional(),
-    max_total_min: z16.number().optional(),
-    n: z16.number().int().min(1).max(12).optional().describe("Number of source recipes (default 5)")
+    query: z17.string().optional().describe('What to make, e.g. "quick spicy noodle dinner"'),
+    slugs: z17.array(z17.string()).optional(),
+    use_pantry: z17.boolean().optional(),
+    ingredients: z17.array(z17.string()).optional().describe("Extra things available right now"),
+    tags: z17.partialRecord(z17.enum(ALL_CATEGORIES), z17.array(z17.string())).optional(),
+    exclude_allergens: z17.array(z17.string()).optional(),
+    max_total_min: z17.number().optional(),
+    n: z17.number().int().min(1).max(12).optional().describe("Number of source recipes (default 5)")
   },
   handler: async ({ query, slugs, use_pantry, ingredients, n, ...filters }, ctx) => text(await synthesisContext(ctx, { query, slugs, use_pantry, ingredients, n, filters }))
 });
@@ -858,6 +875,7 @@ var tools = [
   pb_ingest_source_default,
   pb_inbox_next_default,
   pb_inbox_image_default,
+  pb_inbox_rotate_default,
   pb_inbox_resolve_default,
   pb_inbox_list_default,
   pb_save_recipe_default,