@domandigital/craft 0.20.2 → 0.20.3

package/dist/{chunk-2OBDCIVW.js → chunk-S3L7TEJF.js}

@@ -39,7 +39,18 @@ var SOURCE_KINDS = [
 var CHOICE_KEYS = ["accent", "ground", "display", "body", "shape", "motif", "signature"];
 var CONSIDERATION = ["low", "considered", "high"];
 var PAGE_TYPES = ["home", "service", "about", "pricing", "booking", "contact", "article", "landing"];
+var PROOF_KINDS = ["work", "people", "credentials", "reviews", "experience", "outcomes"];
+var PROOF_DEPTHS = ["first-look", "on-request"];
+var VIEWPORTS = ["mobile", "tablet", "desktop"];
 var HIERARCHY_FIELDS = ["primaryAction", "order", "lead", "journey"];
+var CONFIDENCE_LENSES = ["relevance", "hierarchy", "evidence", "identity", "action", "disclosure", "personality", "differentiation", "mobile"];
+var REVIEW_BASES = ["observed", "inferred", "preference", "unknown"];
+var INSPECTED_KINDS = ["screenshot", "rendered", "source", "measurement", "content"];
+var REPORTED_KINDS = ["audit", "stakeholder", "customer"];
+var EVIDENCE_KINDS = [...INSPECTED_KINDS, ...REPORTED_KINDS];
+var CHANGE_CLASSES = ["confirmed-correction", "design-hypothesis", "optional-refinement", "no-change"];
+var CHANGE_STEPS = ["copy", "relocate", "group", "imagery", "trust-placement", "adjust-component", "remove-redundancy", "restructure", "new-component"];
+var ADDITIONS = ["carousel", "javascript", "dependency", "animation", "testimonial", "cta", "duplicate-content"];
 
 // src/direction/research.ts
 function tradeOf(brief) {
@@ -71,14 +82,17 @@ function researchPrompt(input) {
     "4. **Their words.** The phrases they actually use for the problem and for what they want. Quote them exactly.",
     "5. **Who else is involved.** Who do they have to explain or justify the choice to (a partner, a landlord, a tenant, a manager), and what would make them look good or bad to that person?",
     "6. **Consideration.** Do they decide in minutes, days or months? What do they compare before deciding?",
-    "7. **Where they look.** What do they search for, and where do they ask?",
+    "7. **Where they look.** What do they search for, and where do they ask? On a phone or a computer, and at what moment: standing in a kitchen, on a commute, at a desk?",
+    "8. **What would settle it.** Before they would get in touch, what do they check or want to see: work that was actually done, who they would deal with, a registration they can look up, what other customers said, how long the person has done this? Say which of these the people you found actually mention, and do not assume all of them matter.",
+    "9. **The next step.** How do they usually take it: ring, book, send an enquiry, ask for a quotation, look further first? What stops them taking it, and what do they want to know before they do?",
     "",
     "## Do not",
     "",
     `- Do not describe, list, rank or summarise what ${category} websites look like, or how they are laid out.`,
     '- Do not suggest colours, fonts, layouts, sections or visual "inspiration" from this category.',
     "- Do not summarise competitors' marketing. Their claims are the category average; the customer's words are the point.",
-    "- Do not invent quotes. If you cannot find a source for something, say so."
+    "- Do not invent quotes. If you cannot find a source for something, say so.",
+    "- Do not assume the next step is a phone call, or that a business needs a founder's photograph, reviews, credentials or a gallery. Report what these customers say they need, including that they need none of it."
   ];
   if (input.visual) {
     lines.push(
@@ -370,6 +384,165 @@ function checkOrder(declared, page, snapshot, strict = false) {
   return [{ severity: strict ? "error" : "warn", at: `hierarchy.${page}.order`, message: `the page runs ${rendered.join(", ")}; the file says ${said.join(", ")}` }];
 }
 
+// src/direction/confidence.ts
+function viewportOf(width) {
+  return width < 768 ? "mobile" : width < 1024 ? "tablet" : "desktop";
+}
+var isObject = (x) => Boolean(x) && typeof x === "object" && !Array.isArray(x);
+function validateConfidence(page, confidence, job, sources) {
+  const problems = [];
+  const base = `hierarchy.${page}.confidence`;
+  const err = (at, message) => problems.push({ severity: "error", at: `${base}${at}`, message });
+  if (!isObject(confidence)) {
+    err("", "confidence is an object: `examined` (the widths looked at) and `proof` (what the page offers)");
+    return problems;
+  }
+  if (confidence.examined !== void 0) {
+    if (!Array.isArray(confidence.examined)) err(".examined", `a list of widths: ${VIEWPORTS.join(", ")}`);
+    else for (const v of confidence.examined) if (!VIEWPORTS.includes(v)) err(".examined", `"${String(v)}" is not a width craft knows. Widths are: ${VIEWPORTS.join(", ")}`);
+  }
+  if (confidence.proof !== void 0 && !Array.isArray(confidence.proof)) err(".proof", "a list of evidence items");
+  const proof = Array.isArray(confidence.proof) ? confidence.proof : [];
+  proof.forEach((raw, i) => {
+    const at = `.proof[${i}]`;
+    if (!isObject(raw)) return err(at, "an evidence item is an object: kind, what, position, depth, because");
+    if (!PROOF_KINDS.includes(raw.kind)) err(`${at}.kind`, `one of ${PROOF_KINDS.join(", ")}`);
+    if (typeof raw.what !== "string" || contentWords(raw.what).size < 2) err(`${at}.what`, 'what it is, in a few words: "photographs of three finished bathrooms", not "proof"');
+    if (typeof raw.position !== "string" || !POSITIONS.has(raw.position)) err(`${at}.position`, 'the section it sits in, or "header" or "sticky"');
+    if (!PROOF_DEPTHS.includes(raw.depth)) err(`${at}.depth`, `${PROOF_DEPTHS.join(" or ")}: met without being sought, or detail a visitor opens`);
+    problems.push(...checkReason({ at: `${base}${at}`, because: raw.because, evidence: raw.evidence, sources, tie: "job", job }));
+  });
+  return problems;
+}
+var IDENTITY_WORRY = /\b(?:strangers?|who(?:'s| is| would| will) (?:coming|doing|treating|seeing|dealing|there)|(?:someone|somebody) (?:i|they|we) (?:have not|haven't|do not|don't) (?:met|know)|have not met|haven't met|not met|in (?:my|their|the) (?:home|house)|into (?:my|their|the) (?:home|house)|accountab\w+)\b/i;
+var LATE_SECTION = 3;
+var identityText = (job) => [job.emotional?.value, job.social?.value, ...Array.isArray(job.objections) ? job.objections : [], ...Array.isArray(job.language) ? job.language : []].filter((x) => typeof x === "string").join(" ");
+var lensOf = (kind) => kind === "people" ? "identity" : "evidence";
+function decisionText(h) {
+  const proof = Array.isArray(h.confidence?.proof) ? h.confidence.proof : [];
+  return [
+    h.primaryAction?.value,
+    h.primaryAction?.because,
+    h.lead?.value,
+    h.lead?.because,
+    ...Array.isArray(h.order) ? h.order.map((o) => o?.because) : [],
+    ...Array.isArray(h.journey) ? h.journey.map((s) => s?.because) : [],
+    ...proof.flatMap((p) => isObject(p) ? [p.what, p.because] : [])
+  ].filter((x) => typeof x === "string").join(" ");
+}
+function assessConfidence(hierarchy, job, ctx = {}) {
+  const findings = [];
+  if (!isObject(hierarchy)) return findings;
+  for (const [key, raw] of Object.entries(hierarchy)) {
+    const h = raw;
+    if (!PAGE_TYPES.includes(key) || !isObject(h) || !isObject(h.confidence)) continue;
+    const page = key;
+    const at = (rest) => `hierarchy.${page}.confidence${rest}`;
+    const add = (f) => findings.push({ page, ...f });
+    const c = h.confidence;
+    const proof = (Array.isArray(c.proof) ? c.proof : []).filter(isObject);
+    const order = new Set((Array.isArray(h.order) ? h.order : []).map((o) => o?.role));
+    const bands = new Set((Array.isArray(c.examined) ? c.examined : []).filter((v) => VIEWPORTS.includes(v)));
+    if (ctx.snapshot && (ctx.snapshotPage ?? "home") === page) bands.add(viewportOf(ctx.snapshot.viewport.width));
+    for (const pos of Array.isArray(h.primaryAction?.positions) ? h.primaryAction.positions : []) {
+      if (POSITIONS.has(pos) && pos !== "header" && pos !== "sticky" && !order.has(pos)) {
+        add({
+          lens: "action",
+          basis: "observed",
+          at: `hierarchy.${page}.primaryAction.positions`,
+          message: `the ask "${h.primaryAction.value}" sits in "${pos}", and the declared order has no such section`,
+          why: "A visitor can only take the next step where the page offers it. Either the order or the position is out of date."
+        });
+      }
+    }
+    proof.forEach((p, i) => {
+      const where = at(`.proof[${i}]`);
+      if (POSITIONS.has(p.position) && p.position !== "header" && p.position !== "sticky" && !order.has(p.position)) {
+        add({
+          lens: "hierarchy",
+          basis: "observed",
+          at: `${where}.position`,
+          message: `${p.kind} evidence "${p.what}" sits in "${p.position}", and the declared order has no such section`,
+          why: "Evidence a visitor is meant to meet has to be on the page, in a section the order names."
+        });
+      }
+      const cited = Array.isArray(p.evidence) ? p.evidence : [];
+      if (cited.length === 0) {
+        add({
+          lens: lensOf(p.kind),
+          basis: "unknown",
+          at: `${where}.evidence`,
+          message: `no source in the file shows that "${p.what}" exists`,
+          why: "Confidence built on evidence that is only planned or imagined is the opposite of confidence. Confirm it with the client, and cite what shows it, before the page claims it."
+        });
+      }
+    });
+    const firstLook = new Set(proof.filter((p) => p.depth === "first-look").map((p) => p.kind));
+    proof.forEach((p, i) => {
+      if (p.depth === "on-request" && !firstLook.has(p.kind)) {
+        add({
+          lens: "disclosure",
+          basis: "inferred",
+          at: at(`.proof[${i}].depth`),
+          message: `${p.kind} evidence "${p.what}" is held back for visitors who seek it, and nothing of the same kind is met first`,
+          why: "Detail can wait only if the visitor can tell it is there. Nothing at first look means the evidence may never be found. A line in the header or a short sample in the hero would do; this is a hypothesis, not a rule."
+        });
+      }
+    });
+    if (job && IDENTITY_WORRY.test(identityText(job))) {
+      const sections = Array.isArray(h.order) ? h.order.map((o) => o?.role) : [];
+      const before = (pos) => pos === "header" || pos === "sticky" ? 0 : sections.indexOf(pos);
+      const met = proof.filter((p) => p.kind === "people" && before(p.position) >= 0).map((p) => ({ position: p.position, before: before(p.position) }));
+      const earliest = met.length > 0 ? met.reduce((a, b) => b.before < a.before ? b : a) : void 0;
+      if (earliest && earliest.before >= LATE_SECTION) {
+        add({
+          lens: "identity",
+          basis: "inferred",
+          at: at(".proof"),
+          message: `the job worries about who the visitor would deal with, and the first person is met in "${earliest.position}", after ${earliest.before} other sections`,
+          why: `A visitor who wants to know who is coming may leave or ask before getting there. The smallest change is a name and a line where the ask is first made, not the whole biography moved up: it can stay where it is. This is a hypothesis about the order as declared; check it on the width where it matters.${bands.has("mobile") ? "" : " It has not been examined on a phone."}`
+        });
+      }
+    }
+    if (job && Array.isArray(job.objections)) {
+      const said = contentWords(decisionText(h));
+      job.objections.forEach((o, i) => {
+        if (typeof o !== "string") return;
+        if (shares(contentWords(o), said).length === 0) {
+          add({
+            lens: "relevance",
+            basis: "unknown",
+            at: `job.objections[${i}]`,
+            message: `no decision recorded for this page names the worry "${o}"`,
+            why: "A visitor who arrives with this worry needs something that meets it. Either a decision here does, and its reason should say so, or this page does not have to answer it. This reads wording only: it can miss an answer that uses other words."
+          });
+        }
+      });
+    }
+    if (bands.size === 0) {
+      add({
+        lens: "mobile",
+        basis: "unknown",
+        at: at(".examined"),
+        message: "no width recorded: say which widths these decisions were examined at",
+        why: "The phone is the base layout (STANDARD.md section 10). What was seen at one width says nothing about another until it has been looked at there."
+      });
+    } else {
+      for (const band of VIEWPORTS) {
+        if (bands.has(band)) continue;
+        add({
+          lens: "mobile",
+          basis: "unknown",
+          at: at(".examined"),
+          message: band === "mobile" ? "not examined on a phone" : `not examined at ${band} width; what was seen at ${[...bands].join(" and ")} is not carried to it`,
+          why: band === "mobile" ? "The phone is the base layout every wider one is derived from (STANDARD.md section 10). A page not looked at there has not been looked at where it is designed first." : "Order, prominence and what fits can differ at another width, and nothing recorded shows they do not. Examine it there before treating the finding as true of it."
+        });
+      }
+    }
+  }
+  return findings;
+}
+
 // src/direction/job.ts
 var JOB_VERBS = new Set(
   "find choose pick book get fix stop avoid know feel understand compare decide keep protect prepare plan sort arrange replace repair learn prove show recover reduce save spend hire check see buy sell move start finish handle manage meet reach return treat look end make give take bring hand leave trust rely feel prove explain secure settle solve restore improve change become stay pass sign agree ask call reassure justify confirm".split(" ")
@@ -700,6 +873,7 @@ function validateDirection(input, ctx = {}) {
   }
   let job = false;
   let hierarchy = [];
+  let confidence;
   if (d.version === 2) {
     const j = validateJob(d.job, sources, { brief: typeof d.brief === "string" ? d.brief : "", readSource: ctx.readSource });
     problems.push(...j.problems);
@@ -707,6 +881,10 @@ function validateDirection(input, ctx = {}) {
     const h = validateHierarchy(d.hierarchy, d.job, sources);
     problems.push(...h.problems);
     hierarchy = h.pages;
+    const pages = d.hierarchy && typeof d.hierarchy === "object" && !Array.isArray(d.hierarchy) ? d.hierarchy : {};
+    const recorded = Object.entries(pages).filter(([k, p]) => PAGE_TYPES.includes(k) && p && typeof p === "object" && p.confidence !== void 0);
+    for (const [page, p] of recorded) problems.push(...validateConfidence(page, p.confidence, d.job, sources));
+    if (recorded.length) confidence = assessConfidence(d.hierarchy, d.job, { snapshot: ctx.snapshot, snapshotPage: ctx.page });
     if (ctx.snapshot) problems.push(...checkOrder(d.hierarchy?.[ctx.page ?? "home"], ctx.page ?? "home", ctx.snapshot, ctx.strict));
   }
   if (ctx.estate?.length) {
@@ -723,6 +901,7 @@ function validateDirection(input, ctx = {}) {
     valid: problems.every((p) => p.severity !== "error"),
     problems,
     decided,
+    ...confidence ? { confidence } : {},
     layers: { job, hierarchy, tokens: { decided, total: CHOICE_KEYS.length }, complete: complete && problems.every((p) => p.severity !== "error") }
   };
 }
@@ -730,8 +909,20 @@ function validateDirection(input, ctx = {}) {
 export {
   DIRECTION_VERSION,
   PAGE_TYPES,
+  VIEWPORTS,
+  CONFIDENCE_LENSES,
+  REVIEW_BASES,
+  INSPECTED_KINDS,
+  EVIDENCE_KINDS,
+  CHANGE_CLASSES,
+  CHANGE_STEPS,
+  ADDITIONS,
   PROPOSED,
+  PREFERENCE,
+  CONVENTION,
+  checkReason,
   researchPrompt,
+  SECTION_ROLES,
   summariseDirection,
   compareDirections,
   compareToDeclared,