@mccaskie-labs/workbench-config 0.3.0 → 0.3.2

package/dist/capabilities.gen.d.ts

@@ -1,4 +1,4 @@
-export declare const MANIFEST_VERSION: "de365af27674";
+export declare const MANIFEST_VERSION: "4a52a6ba9520";
 export declare const capabilities: {
     readonly ai: {
         readonly $schema: "./schema.json";
@@ -9,7 +9,7 @@ export declare const capabilities: {
         readonly status: "built";
         readonly surfaces: {
             readonly gateway: readonly ["POST /anthropic/v1/messages", "POST /anthropic/v1/messages/count_tokens"];
-            readonly package: readonly ["createAi", "Ai.text", "Ai.structured", "Ai.stream", "Ai.countTokens", "Ai.budget", "createFakeAi", "checkWriting", "writingStops", "writingNotes", "writingFixNote"];
+            readonly package: readonly ["createAi", "Ai.text", "Ai.structured", "Ai.stream", "Ai.countTokens", "Ai.budget", "createFakeAi", "checkWriting", "writingStops", "writingNotes", "writingFixNote", "Ai.reply", "checkGuide"];
         };
         readonly config: readonly [{
             readonly name: "WORKBENCH_GATEWAY_KEY";
@@ -114,6 +114,12 @@ export declare const capabilities: {
             readonly text: "Name a Workbench voice and spelling with the voice and spelling options, so the Gateway adds the text, or bring the app's own voice. Never paste Workbench's voice text into a prompt.";
             readonly enforced_by: "gateway";
             readonly probe: "ai.voice";
+        }, {
+            readonly id: "ai.reply-facts-from-code";
+            readonly kind: "must";
+            readonly text: "Draft replies with ai.reply from facts worked out by code (prices and dates from quote(), never from the AI), and show the draft in renderReplyBox for a person to check and copy. Never send a draft automatically, and never let a draft with needs_human_check go out unread.";
+            readonly enforced_by: "review";
+            readonly probe: "ai.reply";
         }];
         readonly examples: readonly [{
             readonly id: "ai.example.text";
@@ -127,6 +133,12 @@ export declare const capabilities: {
             readonly lang: "ts";
             readonly code: "const r = await ai.text({ model: 'claude-default', job: 'article.write', voice: 'conversational', spelling: 'en-AU', prompt })\nconst issues = checkWriting(r.text, { voice: 'conversational' })\nif (writingStops(issues).length > 0) await retryWith(prompt + writingFixNote(issues))";
             readonly probe: "ai.voice";
+        }, {
+            readonly id: "ai.example.reply";
+            readonly title: "Draft a reply to an enquiry";
+            readonly lang: "ts";
+            readonly code: "import { REPLY_GUIDES } from './replies.generated'\nconst ai = createAi({ key: env.WORKBENCH_GATEWAY_KEY, env: workbenchEnv(env), url: env.WORKBENCH_GATEWAY_URL, replyGuides: REPLY_GUIDES })\nconst q = quote(settings, ask)\nconst draft = await ai.reply({\n  guide: 'venue-quote',\n  facts: { venue_name: venue.name, date: ask.date, available: q.available, packages: q.options.map((o) => ({ name: o.package, price: o.total.amount })), alternatives: q.alternatives.map((a) => a.date) },\n  incoming: { text, intake: read },\n  language: account.reply_language,\n})\nreturn html(renderReplyBox(draft, { againAction: `/enquiries/${id}/reply` }))";
+            readonly probe: "ai.reply";
         }];
         readonly probes: readonly [{
             readonly id: "ai.text.claude-default";
@@ -193,18 +205,23 @@ export declare const capabilities: {
             readonly half: "runtime";
             readonly expect: "pass";
             readonly cost_hint_usd: 0.008;
+        }, {
+            readonly id: "ai.reply";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly cost_hint_usd: 0.005;
         }];
         readonly offer: {
             readonly pattern: "feature_or_content";
-            readonly when: "The client wants the app to write, summarise, sort, answer questions or pull details out of text with AI, as a feature visitors use, or wants wording for the site written once.";
+            readonly when: "The client wants the app to write, summarise, sort, answer questions or pull details out of text with AI, as a feature visitors use, or wants wording for the site written once, or wants ready-to-paste replies to the messages the business gets (quote requests, booking questions).";
             readonly say: "I'll do this with Workbench AI, which uses Claude through Workbench, so the app holds no AI key and spending has a monthly cap.";
             readonly answers_file: "workbench/ai/<name>.json";
             readonly per: "feature or piece of wording";
-            readonly answers_format: "For a feature: `{ \"format\": 1, \"route\": \"feature\", \"name\", \"about\" (the client's words), \"who\", \"cap_usd\", \"keep\", \"job\" }`, where `job` is the `X-Workbench-Job` the feature's calls send (`<name>` with dots, such as `quotes.estimate`), so its spending shows on its own line in Control. Write it, then build the feature with the package. For wording made once: `npx workbench-ai pick <name> <round>-<draft>` writes it from the draft the client picked, with the round's request ids and cost; never write one from nothing. Then put the wording into the strings catalogue (the workbench-strings skill), keyed for where it is shown. Drafts and their previews stay in `workbench/ai/drafts/`, which isn't committed.";
+            readonly answers_format: "For a feature: `{ \"format\": 1, \"route\": \"feature\", \"name\", \"about\" (the client's words), \"who\", \"cap_usd\", \"keep\", \"job\" }`, where `job` is the `X-Workbench-Job` the feature's calls send (`<name>` with dots, such as `quotes.estimate`), so its spending shows on its own line in Control. Write it, then build the feature with the package. For wording made once: `npx workbench-ai pick <name> <round>-<draft>` writes it from the draft the client picked, with the round's request ids and cost; never write one from nothing. Then put the wording into the strings catalogue (the workbench-strings skill), keyed for where it is shown. Drafts and their previews stay in `workbench/ai/drafts/`, which isn't committed. For replies: write the guide itself to `workbench/replies/<name>.json` (format 1: `name`, `version`, `voice`, `spelling`, `max_words`, `max_questions`, `facts` as a small JSON Schema with `x-money` on amounts and `format: date` on dates, `ask_order`, `guide` lines, `examples`, `never`), then run `npx workbench-ai replies generate`, which checks it and writes `src/replies.generated.ts`; never edit that file. Offer samples with `npx workbench-ai replies drafts <name> --languages <the client's languages>` (two to four, with the development key; tell the client the cost it prints) and keep the one the client picks with `npx workbench-ai replies pick <name> <round>-<draft>`, which makes it the guide's first example.";
             readonly questions: readonly [{
                 readonly id: "ai.route";
                 readonly sets: "route";
-                readonly ask: "Is this something visitors use on the site, or something made once for the site?";
+                readonly ask: "Is this something visitors use on the site, something made once for the site, or replies to the messages you get?";
                 readonly style: "cards";
                 readonly answers: readonly [{
                     readonly label: "Visitors use it";
@@ -214,9 +231,13 @@ export declare const capabilities: {
                     readonly label: "Made once for the site";
                     readonly value: "content";
                     readonly means: "Wording for a page, written once and kept: an About page, a welcome, product descriptions.";
+                }, {
+                    readonly label: "Replies to messages";
+                    readonly value: "reply";
+                    readonly means: "A ready-to-paste reply to a customer's message, with your prices and dates filled in from your own details. A person checks it and copies it; nothing is sent by itself.";
                 }];
                 readonly must_ask: true;
-                readonly note: "Ask it even when the client's words seem to say, as a quick check: the two routes are built and paid for differently.";
+                readonly note: "Ask it even when the client's words seem to say, as a quick check: the two routes are built and paid for differently. Replies are their own route: the facts (prices, dates) come from the app's own code, so ask where those facts come from before anything else.";
             }, {
                 readonly id: "ai.who";
                 readonly sets: "feature.who";
@@ -319,6 +340,156 @@ export declare const capabilities: {
                     readonly is: readonly ["content"];
                 };
                 readonly note: "Name the piece after where it goes (about_us, home_blurb): lower case and underscores. The client's own words, with any facts they give (when they started, where they are), go in --about, because the drafts never invent facts and leave [gaps] for the owner instead.";
+            }, {
+                readonly id: "ai.reply.purpose";
+                readonly sets: "reply.purpose";
+                readonly ask: "What are these replies answering?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Quote and price requests";
+                    readonly value: "quote";
+                    readonly means: "\"How much for Dec 12, 15 pax?\": the reply gives the price and asks only for what's missing.";
+                }, {
+                    readonly label: "Availability questions";
+                    readonly value: "availability";
+                    readonly means: "\"Available pa po ba sa Sabado?\": the reply says yes or offers other dates.";
+                }, {
+                    readonly label: "Booking or appointment requests";
+                    readonly value: "booking";
+                    readonly means: "\"May slot po ba bukas?\": the reply lists the free times and asks which one.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "What the messages are, in a few words.";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "Name the guide after it (venue-quote, appointment-slots): lower case and dashes. Say that prices and dates always come from the app's own details (workbench-availability's quote() where it's a booking), never from the AI.";
+            }, {
+                readonly id: "ai.reply.facts";
+                readonly sets: "reply.facts";
+                readonly ask: "Here are the details a reply can use. Keep, change or add?";
+                readonly style: "table";
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "Propose one row per fact from the client's words and what the app already holds: its name, what it is, where the app gets it, and whether it is money (x-money with the currency) or a date. Only these can appear in a reply; a fact the app doesn't have can't be quoted. Then ask which details a reply may ask the customer for, most important first (ask_order); intake's missing fields are asked from that list only.";
+            }, {
+                readonly id: "ai.reply.language";
+                readonly sets: "reply.language";
+                readonly ask: "Which language should replies use?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Match the message";
+                    readonly value: "match";
+                    readonly means: "English gets English, Taglish gets Taglish, Tagalog gets Tagalog. When it can't tell, it uses your fallback and asks you to check.";
+                }, {
+                    readonly label: "Always Taglish";
+                    readonly value: "taglish";
+                }, {
+                    readonly label: "Always English";
+                    readonly value: "en";
+                }, {
+                    readonly label: "Always Tagalog";
+                    readonly value: "tl";
+                }];
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "This is the default. Where the app has accounts (a venue each), make it each account's own setting in its portal, defaulting to this, and pass it to ai.reply as language; with match, pass the account's fallback as fallbackLanguage.";
+            }, {
+                readonly id: "ai.reply.voice";
+                readonly sets: "reply.voice";
+                readonly ask: "Which tone?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Conversational";
+                    readonly value: "conversational";
+                    readonly means: "Warm and natural, like a helpful person at the front desk.";
+                }, {
+                    readonly label: "Casual";
+                    readonly value: "casual";
+                    readonly means: "Relaxed and friendly, like chatting with a regular.";
+                }, {
+                    readonly label: "Plain";
+                    readonly value: "plain";
+                    readonly means: "Short and clear, nothing extra.";
+                }, {
+                    readonly label: "Formal";
+                    readonly value: "formal";
+                    readonly means: "Polite and proper, for a business that keeps a formal tone.";
+                }];
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+            }, {
+                readonly id: "ai.reply.length";
+                readonly sets: "reply.max_words";
+                readonly ask: "How long can a reply be, at most?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "About 90 words";
+                    readonly value: 90;
+                    readonly means: "Room for a price or two and one question.";
+                }, {
+                    readonly label: "About 50 words";
+                    readonly value: 50;
+                    readonly means: "A quick chat reply.";
+                }, {
+                    readonly label: "About 150 words";
+                    readonly value: 150;
+                    readonly means: "Room for several packages or options.";
+                }];
+                readonly other: {
+                    readonly kind: "whole";
+                    readonly min: 20;
+                    readonly max: 300;
+                    readonly description: "Words, from 20 to 300.";
+                };
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "A reply up to a quarter over passes quietly; one over twice as long is sent back to be written again, then flagged for a person to check.";
+            }, {
+                readonly id: "ai.reply.never";
+                readonly sets: "reply.never";
+                readonly ask: "Is there anything a reply must never say?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "The usual three";
+                    readonly value: "usual";
+                    readonly means: "Never promise a discount, confirm a booking, or ask for payment details. Code checks these as well as telling the AI.";
+                }, {
+                    readonly label: "The usual three, and more";
+                    readonly value: "usual_and_more";
+                    readonly means: "Those three plus things of your own (type them in Other).";
+                }, {
+                    readonly label: "Nothing";
+                    readonly value: "none";
+                    readonly means: "No rules beyond Workbench's own content rules.";
+                }];
+                readonly other: {
+                    readonly kind: "list";
+                    readonly min: 1;
+                    readonly max: 10;
+                    readonly description: "Each thing a reply must never do, in a few words (give medical advice, mention the pool).";
+                };
+                readonly must_ask: true;
+                readonly when: {
+                    readonly id: "ai.route";
+                    readonly is: readonly ["reply"];
+                };
+                readonly note: "Write each as a never line in the guide. Lines about payment details, discounts and confirming bookings are also checked by code; others go into the prompt only, so say so if the client's line matters a lot.";
             }];
             readonly not_asked: readonly [{
                 readonly sets: "model";
@@ -337,6 +508,9 @@ export declare const capabilities: {
                 readonly command: "npx workbench-ai drafts text <name> --about \"<what it is for, with the client's facts>\"";
             };
         };
+        readonly styles: {
+            readonly prefix: "wb-reply-";
+        };
         readonly delivery: {
             readonly choice: "built_in";
             readonly intro: "Writing, summarising and answering questions with Claude, with a monthly spending cap.";
@@ -454,6 +628,221 @@ export declare const capabilities: {
             readonly intro: "Counting page views and the things visitors do on the site.";
         };
     };
+    readonly availability: {
+        readonly $schema: "./schema.json";
+        readonly format: 1;
+        readonly component: "availability";
+        readonly title: "Availability and pricing";
+        readonly summary: "workbench-availability answers \"is this date free, and what does it cost?\" for a bookable thing (a venue, a room, a photographer's day) from its calendar and its price rules, with the same answer every time and one plain line per rule applied. A store over the app's own database stops two bookings landing on one date, and a tap-to-block calendar lets the owner close dates from a phone. It runs in the app itself, with no Gateway call, no AI and no cost.";
+        readonly status: "built";
+        readonly surfaces: {
+            readonly package: readonly ["quote", "createAvailability", "availabilityMigration", "calendarAction", "checkSettings", "stayClaims", "staysClash", "todayIn", "AvailabilityError"];
+        };
+        readonly rules: readonly [{
+            readonly id: "availability.quote-is-fact";
+            readonly kind: "must";
+            readonly text: "Take every availability answer and price the app shows or sends from quote() (or createAvailability's quote), and pass its lines and explain on as facts. Never let AI work out a price or a free date, and never write a price into a page or prompt by hand.";
+            readonly enforced_by: "review";
+            readonly probe: "availability.quote";
+        }, {
+            readonly id: "availability.book-through-block";
+            readonly kind: "must";
+            readonly text: "Book, hold and block dates only through createAvailability's block(), which runs availability_block() in one transaction: never insert into availability_blocks directly, so the exclusion constraint and the hold expiry always apply.";
+            readonly enforced_by: "database";
+            readonly probe: "availability.store";
+        }, {
+            readonly id: "availability.calendar-days";
+            readonly kind: "must";
+            readonly text: "Treat dates as calendar days (YYYY-MM-DD) in the account's time zone: pass todayIn(timeZone) as today, never new Date() in UTC.";
+            readonly enforced_by: "types";
+            readonly probe: "availability.quote";
+        }, {
+            readonly id: "availability.no-names-in-notes";
+            readonly kind: "must_not";
+            readonly text: "Write a guest's name or phone number into a block's note: link the app's own booking in subject instead. The .ics feed carries neither.";
+            readonly enforced_by: "review";
+            readonly probe: "availability.store";
+        }, {
+            readonly id: "availability.public-gets-the-quote";
+            readonly kind: "must_not";
+            readonly text: "Let a public page or the anonymous key read availability_blocks: public pages get the finished quote from the server.";
+            readonly enforced_by: "database";
+            readonly probe: "availability.store";
+        }, {
+            readonly id: "availability.daily-cleanup";
+            readonly kind: "must";
+            readonly text: "Run createAvailability's cleanup() once a day from the app's cron with the service client, so lapsed holds show as expired and old blocks are deleted on time.";
+            readonly enforced_by: "review";
+            readonly probe: "availability.store";
+        }, {
+            readonly id: "availability.calendar-as-shipped";
+            readonly kind: "must";
+            readonly text: "Draw the owner's calendar with renderCalendar and CALENDAR_SCRIPT (under the page's nonce), and hand the posted body to calendarAction behind the owner's sign-in. Never hand-write the calendar's markup or script.";
+            readonly enforced_by: "review";
+            readonly probe: "availability.calendar";
+        }];
+        readonly examples: readonly [{
+            readonly id: "availability.example.quote";
+            readonly title: "Answer \"is 12 Dec free, and how much?\"";
+            readonly lang: "ts";
+            readonly code: "import { createAvailability } from '@mccaskie-labs/workbench-availability'\nimport settings from '../workbench/availability.json'\n\nconst av = createAvailability({ db: serviceClient, account: venue.id, settings, country: 'PH', timeZone: 'Asia/Manila' })\nconst q = await av.quote({ resource: 'villa-sol-pool', date: '2026-12-12', stay: 'day_use', guests: { min: 15, max: 15 }, eventType: 'birthday' })\n// q.available 'yes'; q.options[0].total { amount: '9500.00', currency: 'PHP' }; q.explain ['Weekend day use: ₱9,500 (rule r-weekend)', ...]";
+            readonly probe: "availability.quote";
+        }, {
+            readonly id: "availability.example.calendar";
+            readonly title: "The owner's tap-to-block calendar";
+            readonly lang: "ts";
+            readonly code: "import { calendarAction } from '@mccaskie-labs/workbench-availability'\nimport { CALENDAR_SCRIPT, renderCalendar } from '@mccaskie-labs/workbench-availability/calendar'\n\nconst days = await av.month('villa-sol-pool', '2026-12')\nconst html = renderCalendar(days, t, { resource: 'villa-sol-pool', month: '2026-12', endpoint: '/owner/calendar', stays: [{ id: 'day_use', label: t('ui.stay.day_use')! }] })\n// The page adds <script nonce=...>${CALENDAR_SCRIPT}</script>; POST /owner/calendar (owner signed in):\nconst r = await calendarAction(av, await request.json())\nreturn Response.json(r.body, { status: r.status })";
+            readonly probe: "availability.calendar";
+        }];
+        readonly probes: readonly [{
+            readonly id: "availability.quote";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly smoke: true;
+            readonly cost_hint_usd: 0;
+            readonly note: "In the Worker itself: quote() on the spec's HmPo example (Sat 12 Dec ₱9,500, Sat 19 Dec ₱10,925 with peak, 25 guests ₱10,250 over capacity, no guests a from price) and the alternatives when 19 Dec is booked; no database, no Gateway call";
+        }, {
+            readonly id: "availability.store";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly cost_hint_usd: 0;
+            readonly note: "Against the probe app's own database: two block(booked) calls for one night at once (one lands, one refused as clash), a lapsed hold quoted free and marked expired by cleanup(), another account's resource unreachable, then every probe block removed";
+        }, {
+            readonly id: "availability.calendar";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly cost_hint_usd: 0;
+            readonly note: "The probe page draws a month with renderCalendar and CALENDAR_SCRIPT: tap, Block day, Undo leaves no block; a change made offline shows \"1 change waiting\" and is sent on reconnect";
+        }];
+        readonly offer: {
+            readonly pattern: "settings";
+            readonly when: "The client takes bookings for something with dates: a venue, a room, a resort day pass, a photographer's or hire business's days, or wants prices that depend on the day, season, holiday, number of guests or kind of event, or wants a calendar to block dates.";
+            readonly say: "I'll set this up with Workbench availability, so every price and free date comes out the same way each time, explained line by line, and you get a calendar to block dates from your phone. Here's how a business like yours usually books; tell me what to change.";
+            readonly answers_file: "workbench/availability.json";
+            readonly answers_format: "`{ \"format\": 1, \"status\": \"draft\" | \"done\", \"what\": \"<the client's words>\", \"stay_types\": [{ \"id\", \"start\", \"end\", \"clashes\" }], \"event_types\": [...], \"currency\": \"PHP\", \"alternatives\": { \"count\": 3, \"within_days\": 21 }, \"hold_days\": 3, \"holidays\": \"weekend\" | \"weekday\" | \"separate\" }`. Every stay type clashes with itself; list each pair that can't share a date on both sides. Take `currency` from workbench/country.json. checkSettings() reads this file at startup and names every problem. Each account's resources, packages and price rules are data in the app's database (availability_resources, availability_packages, availability_price_rules), entered on the owner's pages, never in this file. Copy availabilityMigration into supabase/migrations with its down file, and CALENDAR_WORDS into the strings catalogue.";
+            readonly questions: readonly [{
+                readonly id: "availability.what";
+                readonly sets: "availability.what";
+                readonly ask: "What do people book?";
+                readonly style: "table";
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "In the client's words, such as \"a resort's pool and function hall\" or \"me, as a photographer, by the half or full day\".";
+                };
+                readonly must_ask: true;
+                readonly note: "Only the client knows. Their answer names the resources (one per thing booked separately) and suggests the stay types to propose next.";
+            }, {
+                readonly id: "availability.stays";
+                readonly sets: "availability.stay_types";
+                readonly ask: "Here are the usual ways it's booked in a day, with their hours and which can't share a date. Accept them, change some, or add or remove?";
+                readonly style: "table";
+                readonly other: {
+                    readonly kind: "list";
+                    readonly min: 1;
+                    readonly max: 10;
+                    readonly description: "Each way it's booked, with its start and end time and the others it can't share a date with.";
+                };
+                readonly must_ask: true;
+                readonly note: "Propose from the client's answer to availability.what. A resort or venue: day use 08:00 to 17:00, night use 19:00 to 07:00, overnight 14:00 to 12:00 the next day (overnight clashes with both; day and night use don't clash with each other). A photographer or hire business: half day and full day, clashing with each other. One room or slot a day: a single stay type.";
+            }, {
+                readonly id: "availability.events";
+                readonly sets: "availability.event_types";
+                readonly ask: "Should prices depend on the kind of event? Here is the usual list.";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Yes, use this list";
+                    readonly value: "list";
+                    readonly means: "Birthday, debut, wedding, baptism, reunion, team building, other: a rule can add a fee for some of them.";
+                }, {
+                    readonly label: "No, same price for all";
+                    readonly value: "none";
+                    readonly means: "No event types; the quote never asks for one.";
+                }, {
+                    readonly label: "Yes, with my own list";
+                    readonly value: "own";
+                    readonly means: "Type the kinds of event the business prices differently.";
+                }];
+                readonly other: {
+                    readonly kind: "list";
+                    readonly min: 1;
+                    readonly max: 20;
+                    readonly description: "The kinds of event, each a short name.";
+                };
+                readonly note: "Recommend the usual list for venues and resorts; \"none\" for most other businesses. Write ids in lower case with underscores (team_building).";
+            }, {
+                readonly id: "availability.holidays";
+                readonly sets: "availability.holidays";
+                readonly ask: "Should holidays be priced like weekends?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "Yes, like a weekend";
+                    readonly value: "weekend";
+                    readonly means: "A regular holiday or special non-working day on a weekday costs the weekend price.";
+                }, {
+                    readonly label: "No, by the day of the week";
+                    readonly value: "weekday";
+                    readonly means: "Holidays cost what their day of the week costs.";
+                }, {
+                    readonly label: "Set holiday prices separately";
+                    readonly value: "separate";
+                    readonly means: "Holidays get their own price rules, entered on the owner's pages.";
+                }];
+                readonly other: {
+                    readonly kind: "text";
+                    readonly min: 3;
+                    readonly max: 200;
+                    readonly description: "How holidays should be priced, in the client's words.";
+                };
+                readonly note: "Holidays come from workbench-country's yearly list (the Philippines' proclamation each year); a local fiesta goes in the availability_holidays table. Special working days (the EDSA anniversary) are never priced as holidays.";
+            }, {
+                readonly id: "availability.holds";
+                readonly sets: "availability.hold_days";
+                readonly ask: "How long is a date held while waiting for a deposit?";
+                readonly style: "cards";
+                readonly answers: readonly [{
+                    readonly label: "3 days";
+                    readonly value: 3;
+                    readonly means: "The date shows as held (H) for 3 days, then is free again unless marked booked.";
+                }, {
+                    readonly label: "1 day";
+                    readonly value: 1;
+                }, {
+                    readonly label: "7 days";
+                    readonly value: 7;
+                }, {
+                    readonly label: "No holds";
+                    readonly value: 0;
+                    readonly means: "A date is free until it is booked; nothing is held.";
+                }];
+                readonly other: {
+                    readonly kind: "whole";
+                    readonly min: 0;
+                    readonly max: 60;
+                    readonly description: "Days, 0 to 60.";
+                };
+            }];
+            readonly not_asked: readonly [{
+                readonly sets: "availability.prices";
+                readonly why: "Each account's prices, packages and rules change often, so they are data the owner enters on their own pages (or that onboarding reads from their rate card), not project settings.";
+            }, {
+                readonly sets: "availability.alternatives";
+                readonly why: "Up to 3 nearest free dates within 21 days, same weekday first, suits every business so far; change it in the answers file if a client asks.";
+            }, {
+                readonly sets: "availability.currency";
+                readonly why: "It is the country's own, from workbench/country.json.";
+            }];
+            readonly needs: readonly ["country"];
+        };
+        readonly styles: {
+            readonly prefix: "wb-cal-";
+        };
+        readonly delivery: {
+            readonly choice: "optional";
+            readonly intro: "Which dates are free and what each costs, worked out the same way every time, with a calendar the owner taps to block dates.";
+        };
+    };
     readonly config: {
         readonly $schema: "./schema.json";
         readonly format: 1;
@@ -552,7 +941,7 @@ export declare const capabilities: {
         readonly summary: "workbench-country writes dates, times, numbers and money the way readers in the Philippines, Australia, the UK and the US expect, from one pack per country, and gives each pack's spelling for the Gateway. It runs in the app itself, with no Gateway call and no cost.";
         readonly status: "built";
         readonly surfaces: {
-            readonly package: readonly ["COUNTRY_PACKS", "countryPackFor", "audiencePack", "checkPack", "CountryPackError", "formatDate", "formatDateTime", "calendarDayIn", "formatNumber", "formatMoney", "formattingLocale", "currencySymbol", "currencySymbolFrom", "WORLDWIDE", "isWorldwide"];
+            readonly package: readonly ["COUNTRY_PACKS", "countryPackFor", "audiencePack", "checkPack", "CountryPackError", "formatDate", "formatDateTime", "calendarDayIn", "formatNumber", "formatMoney", "formattingLocale", "currencySymbol", "currencySymbolFrom", "WORLDWIDE", "isWorldwide", "HOLIDAYS", "holidaysFor", "holidayOn", "checkHolidays"];
         };
         readonly rules: readonly [{
             readonly id: "country.one-formatter";
@@ -572,6 +961,12 @@ export declare const capabilities: {
             readonly text: "Write an amount with a bare \"$\": Australian dollars are A$ and US dollars US$.";
             readonly enforced_by: "types";
             readonly probe: "country.packs";
+        }, {
+            readonly id: "country.holidays-from-proclamation";
+            readonly kind: "must";
+            readonly text: "Take public holidays from holidaysFor or holidayOn, never worked out or guessed: a year with no list returns undefined, and checkHolidays fails from 1 December until next year's list is in.";
+            readonly enforced_by: "review";
+            readonly probe: "country.holidays";
         }, {
             readonly id: "country.spelling-from-pack";
             readonly kind: "must";
@@ -599,6 +994,13 @@ export declare const capabilities: {
             readonly expect: "pass";
             readonly cost_hint_usd: 0;
             readonly note: "Every pack's spelling is one the Gateway accepts (en-PH, en-AU, en-GB, en-US), checked against the ai manifest's spellings; no Gateway call";
+        }, {
+            readonly id: "country.holidays";
+            readonly half: "runtime";
+            readonly expect: "pass";
+            readonly smoke: true;
+            readonly cost_hint_usd: 0;
+            readonly note: "The December probe: checkHolidays for every country with a built-in list, on today in that country's time zone. Fails when this year's list is missing, and from 1 December when next year's is, so the list is added from the proclamation before January's prices need it";
         }];
         readonly offer: {
             readonly pattern: "project";