@aglyn/plugins-ai 1.0.0-beta.233 → 1.0.0-beta.235

package/src/lib/model/ai-site-kinds.d.ts

@@ -124,8 +124,18 @@ export interface AiSiteKind {
     blurb: string;
     /** A word from the icon set the card shows. */
     icon: string;
-    /** Words in "what kind of site" that suggest this kind, matched whole. */
+    /**
+     * Specific nouns and phrases that name this kind on their own ("roofer",
+     * "law firm", "food bank"), matched whole and singular or plural. One is
+     * enough to pick the kind ({@link aiSiteKindFor}).
+     */
     keywords: readonly string[];
+    /**
+     * Generic words that only lean toward this kind ("club", "studio",
+     * "classes", "shop"): they add a little weight, break a tie, and never pick
+     * a narrow kind on their own.
+     */
+    hints: readonly string[];
     /** The starter whose shape this kind follows, where one fits (`STARTER_TEMPLATES`). */
     starter: string;
     look: AiSiteLookFamily;
@@ -146,14 +156,26 @@ export declare function aiSiteKind(id: unknown): AiSiteKind | null;
 /** A pairing by id, or `null`. */
 export declare function aiSiteFontPairing(id: unknown): AiSiteFontPairing | null;
 /**
- * The kind a "what kind of site" answer suggests, or `business` when nothing
- * in it matches: the card the guided start selects until the person picks
- * another. A longer keyword wins over a shorter one ("wedding photographer"
- * is photography, not events), and of two as long the later one wins, since
- * English puts the noun last ("a food blog" is a blog).
+ * The kind a "what kind of site" answer suggests, read with "who it's for"
+ * when there is one: the card the guided start selects until the person
+ * picks another. Deterministic and local, no model call (AGL-3660).
+ *
+ * Every kind scores what it finds. A specific keyword ("roofer", "food bank")
+ * is enough alone; a phrase outweighs its words and claims them ("wedding
+ * photographer" is photography, not events); a generic hint ("club",
+ * "studio", "classes", "shop") only leans, so "a neighborhood book club" is
+ * community, built from club + neighborhood + meetups + neighbors, and never
+ * fitness on "club". The head noun — the last keyword before the answer's
+ * first modifier — earns a bonus ("a bookstore with author events" is a
+ * store); when the answer and audience name nothing specific, a generic head
+ * noun that only one kind has may decide ("a bike shop" is a store, "a hiking
+ * group" a community). The audience counts half. The highest score wins; of two equal,
+ * the one named later, since English puts the noun last ("a food blog" is a
+ * blog). A best score of no more than a stray hint, or a tie that order
+ * cannot settle, is `business`, the most general kind.
  */
-export declare function aiSiteKindFor(siteType: string): AiSiteKind;
-/** The kind a job's inputs name, else the one its business type suggests; `null` for a job that names neither. */
+export declare function aiSiteKindFor(siteType: string, audience?: string): AiSiteKind;
+/** The kind a job's inputs name, else the one its business type and audience suggest; `null` for a job that names neither. */
 export declare function aiSiteKindOfInputs(inputs: Readonly<Record<string, unknown>> | null | undefined): AiSiteKind | null;
 /** The site's own look tokens a unit is handed (AGL-3660), read defensively. */
 export declare function aiSiteStyleTokens(inputs: Readonly<Record<string, unknown>> | null | undefined): {