@tritard/waterbrother 0.8.21 → 0.8.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tritard/waterbrother",
-  "version": "0.8.21",
+  "version": "0.8.22",
   "description": "Waterbrother: Grok-powered coding CLI with local tools, sessions, operator modes, and approval controls",
   "type": "module",
   "bin": {

package/src/agent.js

@@ -59,12 +59,11 @@ When you use tools:
   - define the typography, color system, spacing rhythm, and motion restraint through the code you write
   - avoid fake press badges, fake testimonials, fake founder lore, and placeholder image services unless explicitly requested
   - avoid generic Tailwind CDN template output and default premium-blog serif/sans pairings
-  - avoid invented publication brands, named authors, issue numbers, staff credits, or editorial worldbuilding unless the user explicitly asked for fictional framing
   - avoid browser-default Georgia/Times plus system-sans typography as a final design answer
   - avoid fake keyboard shortcuts, fake command palettes, and demo-only interaction chrome
-  - avoid generic reflective-editorial copy about slowness, attention, or the examined life unless the user explicitly asked for that voice
-  - prefer fewer sections and at least one asymmetrical or compositionally distinctive move over a fully balanced template layout
   - prefer fewer stronger sections over a busy page with fake search, fake filters, or filler widgets
+  - adapt the above rules to the site type; docs and dashboards may need clearer repetitive utility layouts than editorial or portfolio pages
+  - only apply benchmark-grade strictness about publication framing, reflective-editorial copy, and forced asymmetry when the task is clearly a benchmark/comparison ask
 - After making code or file edits:
   - lead with the file path or paths you changed
   - summarize concrete changes, not vibes or quality claims
@@ -124,9 +123,13 @@ function buildSystemPrompt(profile, experienceMode = "standard", autonomyMode =
           `- tone: ${frontend.tone || "unknown"}`,
           `- content mode: ${frontend.contentMode || "designed-placeholder"}`,
           `- asset policy: ${frontend.assetPolicy || "no-placeholder-images-unless-explicit"}`,
-          `- layout starter: ${frontend.layoutStarter || "choose a strong non-generic section grammar"}`
+          `- layout starter: ${frontend.layoutStarter || "choose a strong non-generic section grammar"}`,
+          `- benchmark mode: ${frontend.benchmarkMode ? "on" : "off"}`
         ].join("\n")
       );
+      if (Array.isArray(frontend.siteTypeRules) && frontend.siteTypeRules.length > 0) {
+        ctxLines.push(`Site-type rules:\n- ${frontend.siteTypeRules.join("\n- ")}`);
+      }
     }
     if (executionContext.reminders) ctxLines.push(`Scope reminders:\n${executionContext.reminders}`);
     if (ctxLines.length > 0) base += `\n\nExecution context:\n${ctxLines.join("\n")}`;

package/src/frontend.js

@@ -49,6 +49,22 @@ Rules:
 
 const BENCHMARK_FRONTEND_PROMPT = /\b(?:benchmark|squarespace quality|ultimate design|first class|on par|codex|claude code|cc)\b/i;
 
+const UNIVERSAL_FRONTEND_REMINDERS = [
+  "Choose one visual direction and stay consistent across typography, spacing, color, and motion.",
+  "Choose a real type system with deliberate character. Browser-default Georgia/Times plus system sans is not an acceptable final design direction.",
+  "Prefer hand-authored CSS variables and layout rules over generic template utility sprawl when feasible.",
+  "Cut fake credibility elements, fake brands, fake testimonials, and filler interface chrome unless explicitly requested.",
+  "Do not add fake keyboard shortcuts, fake command palettes, or demo-only interactive chrome unless the interface truly needs them.",
+  "Avoid placeholder image services, Inter/Playfair default pairings, Tailwind CDN starter aesthetics, and generic premium-blog tropes.",
+  "Prefer fewer sections with stronger hierarchy over a long page full of low-value widgets."
+];
+
+const BENCHMARK_FRONTEND_REMINDERS = [
+  "For benchmark frontend tasks, cut generic reflective-editorial copy. Use sharper, more concrete language or neutral structural placeholders instead of atmosphere-writing.",
+  "For benchmark frontend tasks, force at least one asymmetrical or compositionally distinctive move instead of a fully balanced template layout.",
+  "Benchmark mode: treat fake issue framing, fake publication history, fake keyboard shortcuts, and invented named contributors as disallowed outputs. Use neutral structural placeholders if needed."
+];
+
 const SITE_TYPES = [
   ["blog", /\b(blog|journal|essays?|articles?|publication|editorial)\b/i],
   ["landing", /\b(landing page|homepage|home page|marketing site|product site|launch page|hero section)\b/i],
@@ -73,6 +89,30 @@ const AUDIENCE_HINTS = [
   ["operators", /\b(founders?|operators?|engineers?|designers?)\b/i]
 ];
 
+const SITE_TYPE_RULES = {
+  blog: [
+    "For blogs and editorial sites, prefer structural placeholder labels over inventing fictional publication brands, named editors, or fake biographical lore.",
+    "Do not invent issue numbers, seasonal issue metadata, staff credits, or named authors/photographers unless the user explicitly asked for fictional worldbuilding.",
+    "Do not add a newsletter/signup block unless the user explicitly asked for one or the site type clearly requires capture."
+  ],
+  landing: [
+    "For landing pages, prioritize the value proposition, proof, and one primary action over editorial atmosphere.",
+    "CTA sections are acceptable when they are genuinely part of the requested product flow; avoid fake testimonials or fake customer logos."
+  ],
+  portfolio: [
+    "For portfolios, let work samples, case studies, and identity carry the page rather than editorial filler.",
+    "Do not add newsletter/signup blocks or publication framing unless explicitly requested."
+  ],
+  docs: [
+    "For docs and help centers, clarity and information scent matter more than asymmetry or art direction.",
+    "Balanced, repetitive utility layouts are acceptable when they improve scanability."
+  ],
+  dashboard: [
+    "For dashboards and app UI, useful controls and information density matter more than editorial composition.",
+    "Do not remove necessary navigation or controls just to make the page feel minimal."
+  ]
+};
+
 const ARCHETYPE_RULES = {
   "editorial-minimal": [
     "Use restrained editorial hierarchy with fewer, larger blocks of content.",
@@ -252,6 +292,10 @@ function inferAssetPolicy(text) {
   return "no-placeholder-images-unless-explicit";
 }
 
+function getSiteTypeRules(siteType) {
+  return SITE_TYPE_RULES[siteType] || [];
+}
+
 export function isFrontendGenerationPrompt(promptText = "", profile = "coder") {
   const text = String(promptText || "").trim();
   if (!text) return false;
@@ -277,23 +321,14 @@ export function buildFrontendExecutionContext({ promptText = "", profile = "code
   }
   const assetPolicy = inferAssetPolicy(text);
   const layoutStarter = getLayoutStarter(siteType, archetype);
+  const siteTypeRules = getSiteTypeRules(siteType);
   const reminders = [
     `Frontend brief: site type = ${siteType}, archetype = ${archetype}, audience = ${audience}, tone = ${tone}.`,
     `Content mode: ${contentMode}. Asset policy: ${assetPolicy}.`,
     layoutStarter ? `Layout starter: ${layoutStarter[0]}` : "",
-    "Choose one visual direction and stay consistent across typography, spacing, color, and motion.",
-    "Choose a real type system with deliberate character. Browser-default Georgia/Times plus system sans is not an acceptable final design direction.",
-    "Prefer hand-authored CSS variables and layout rules over generic template utility sprawl when feasible.",
-    "Cut fake credibility elements, fake brands, fake testimonials, and filler interface chrome unless explicitly requested.",
-    "For blogs and editorial sites, prefer structural placeholder labels over inventing fictional publication brands, named editors, or fake biographical lore.",
-    "Do not invent issue numbers, seasonal issue metadata, staff credits, or named authors/photographers unless the user explicitly asked for fictional worldbuilding.",
-    "Do not add a newsletter/signup block unless the user explicitly asked for one or the site type clearly requires capture.",
-    "Do not add fake keyboard shortcuts, fake command palettes, or demo-only interactive chrome unless the interface truly needs them.",
-    "Avoid placeholder image services, Inter/Playfair default pairings, Tailwind CDN starter aesthetics, and generic premium-blog tropes.",
-    "Prefer fewer sections with stronger hierarchy over a long page full of low-value widgets.",
-    "For benchmark frontend tasks, cut generic reflective-editorial copy. Use sharper, more concrete language or neutral structural placeholders instead of atmosphere-writing.",
-    "For benchmark frontend tasks, force at least one asymmetrical or compositionally distinctive move instead of a fully balanced template layout.",
-    benchmarkMode ? "Benchmark mode: treat fake issue framing, fake publication history, fake keyboard shortcuts, and invented named contributors as disallowed outputs. Use neutral structural placeholders if needed." : "",
+    ...UNIVERSAL_FRONTEND_REMINDERS,
+    ...siteTypeRules,
+    ...(benchmarkMode ? BENCHMARK_FRONTEND_REMINDERS : []),
     ...(layoutStarter ? [layoutStarter[1]] : []),
     ...(ARCHETYPE_RULES[archetype] || [])
   ].join("\n");
@@ -307,7 +342,8 @@ export function buildFrontendExecutionContext({ promptText = "", profile = "code
       contentMode,
       assetPolicy,
       layoutStarter: layoutStarter ? layoutStarter[0] : null,
-      benchmarkMode
+      benchmarkMode,
+      siteTypeRules
     },
     reminders
   };
@@ -355,12 +391,12 @@ export function detectFrontendSlop({ promptText = "", assistantText = "", receip
     flags.push("fake keyboard or command-palette gimmick");
     score += 3;
   }
-  if (siteType === "blog" && benchmarkMode && /\b(?:measure of time in ordinary things|quiet rituals|architecture of memory|cult of productivity|considered writing|the slow accumulation of days|craft of attention|in defense of silence)\b/i.test(haystack)) {
+  if (siteType === "blog" && benchmarkMode && /\b(?:measure of time in ordinary things|quiet rituals|architecture of memory|cult of productivity|considered writing|the slow accumulation of days|craft of attention|in defense of silence|meditation on permanence and ephemerality|stillness and the act of looking|deliberate observation)\b/i.test(haystack)) {
     flags.push("benchmark blog fell back to reflective-editorial atmosphere copy");
     score += 3;
   }
   const editorialLayoutHits = GENERIC_EDITORIAL_LAYOUT_PATTERNS.filter((pattern) => pattern.test(haystack)).length;
-  if (siteType === "blog" && editorialLayoutHits >= 3) {
+  if (siteType === "blog" && benchmarkMode && editorialLayoutHits >= 3) {
     flags.push("generic editorial starter layout");
     score += 2;
   }