@tryvitris/website-harness 0.0.0-stage → 0.1.0-beta.6

package/bin/chunks/chunk-DRJQ4OOU.js

@@ -0,0 +1,514 @@
+// src/agent/jev/questions.ts
+import { createHash } from "node:crypto";
+import { choice, noul, score } from "@typesafe-ai/sdk";
+var QUESTION_VERSION = "2026-09-17.2";
+function canonicalJsonStringify(val) {
+  if (val === null || val === void 0) {
+    return "null";
+  }
+  if (typeof val === "boolean" || typeof val === "number") {
+    return JSON.stringify(val);
+  }
+  if (typeof val === "string") {
+    return JSON.stringify(val);
+  }
+  if (Array.isArray(val)) {
+    return `[${val.map((item) => canonicalJsonStringify(item)).join(",")}]`;
+  }
+  if (typeof val === "object") {
+    const obj = val;
+    const sortedKeys = Object.keys(obj).sort();
+    const entries = [];
+    for (const key of sortedKeys) {
+      if (obj[key] !== void 0) {
+        entries.push(`${JSON.stringify(key)}:${canonicalJsonStringify(obj[key])}`);
+      }
+    }
+    return `{${entries.join(",")}}`;
+  }
+  return JSON.stringify(val);
+}
+function questionSemanticsHash(q) {
+  const serialized = canonicalJsonStringify(q);
+  return createHash("sha256").update(serialized).digest("hex");
+}
+var GROUNDING_RELATION_CRITERIA = {
+  supports: "The cited evidence excerpt directly proves, confirms, or states the claim to be true.",
+  contradicts: "The cited evidence excerpt directly contradicts the claim or asserts an opposite fact.",
+  says_nothing: "The cited evidence excerpt does not address, mention, or verify what the claim asserts."
+};
+var PATH_REFERENCED_GROUNDING_INSTRUCTION_TEMPLATE = "Evaluate how the evidence excerpt at state.{evidencePath} relates to the claim at state.{claimPath}.\nDetermine whether the cited evidence supports, contradicts, or says nothing about the claim.";
+var EMBEDDED_GROUNDING_INSTRUCTION_TEMPLATE = "Evaluate how the evidence excerpt relates to the claim.\n\nClaim:\n{claim}\n\nEvidence Excerpt:\n{excerpt}";
+var GROUNDING_TASK_INSTRUCTIONS = PATH_REFERENCED_GROUNDING_INSTRUCTION_TEMPLATE;
+var GROUNDING_TASK_SEMANTICS = {
+  task: "grounding",
+  version: QUESTION_VERSION,
+  pathReferencedTemplate: PATH_REFERENCED_GROUNDING_INSTRUCTION_TEMPLATE,
+  embeddedTemplate: EMBEDDED_GROUNDING_INSTRUCTION_TEMPLATE,
+  criteria: GROUNDING_RELATION_CRITERIA
+};
+var GROUNDING_SEMANTICS_HASH = questionSemanticsHash(GROUNDING_TASK_SEMANTICS);
+function makeGroundingQuestion(claim, excerpt) {
+  const instructions = EMBEDDED_GROUNDING_INSTRUCTION_TEMPLATE.replace("{claim}", claim).replace("{excerpt}", excerpt);
+  return choice(instructions, GROUNDING_RELATION_CRITERIA);
+}
+function makePathReferencedGroundingQuestion(claimPath, evidencePath) {
+  const instructions = PATH_REFERENCED_GROUNDING_INSTRUCTION_TEMPLATE.replace("{claimPath}", claimPath).replace("{evidencePath}", evidencePath);
+  return choice(instructions, GROUNDING_RELATION_CRITERIA);
+}
+var ROUTING_SCOPE_CRITERIA = {
+  business: "Adds, removes, or modifies core business facts, services, offerings, pricing tiers, hours, or locations.",
+  copy: "Edits wording, headlines, captions, subheads, or text without introducing ungrounded facts or changing visual design.",
+  pages: "Changes component layout, spacing, buttons, navigation structure, or presentation without altering business facts.",
+  direction: "Changes overall visual theme, brand styling, typography, color palette, or aesthetic look-and-feel.",
+  ambiguous: "The request is vague, unclear, or lacks sufficient detail to determine a single engineering change scope.",
+  mixed: "The request clearly combines multiple independent changes across different scopes (e.g., both copy wording and UI layout, or both business facts and visual theme)."
+};
+function makeRoutingQuestion(instruction, context) {
+  let instructions = `Classify the following operator change request into the primary scope of work required.
+
+Operator Request:
+${instruction}`;
+  if (context?.trim()) {
+    instructions += `
+
+Current Site Context:
+${context.trim()}`;
+  }
+  return choice(instructions, ROUTING_SCOPE_CRITERIA);
+}
+function makeMultiScopeRoutingQuestions(instruction, context) {
+  const contextNote = context?.trim() ? `
+Current Context:
+${context.trim()}` : "";
+  return {
+    business: noul(
+      `Does this operator change request add, remove, or modify core business facts, offerings, services, pricing, hours, or locations?
+
+Request: ${instruction}${contextNote}`,
+      {
+        true: "Modifies core business facts, services, pricing, hours, or offerings.",
+        false: "Does not modify core business facts or offerings."
+      }
+    ),
+    copy: noul(
+      `Does this operator change request edit text copy, headlines, taglines, wording, or body paragraphs without introducing ungrounded facts?
+
+Request: ${instruction}${contextNote}`,
+      {
+        true: "Edits text copy, headlines, body wording, or captions.",
+        false: "Does not edit text copy or wording."
+      }
+    ),
+    pages: noul(
+      `Does this operator change request change component layout, spacing, buttons, page structure, or navigation chrome?
+
+Request: ${instruction}${contextNote}`,
+      {
+        true: "Changes component layout, spacing, buttons, or navigation structure.",
+        false: "Does not change component layout or UI structure."
+      }
+    ),
+    direction: noul(
+      `Does this operator change request change visual theme, colors, typography, aesthetic density, or art direction?
+
+Request: ${instruction}${contextNote}`,
+      {
+        true: "Changes visual theme, styling, colors, typography, or aesthetic look-and-feel.",
+        false: "Does not change visual styling or theme."
+      }
+    )
+  };
+}
+var CTA_CONSISTENCY_CRITERIA = {
+  consistent: "The planned call-to-action wording, destination route, and intended interaction directly align with storyboard actions.",
+  contradictory: "The planned call-to-action promises an action (e.g., direct scheduling, instant booking, checkout) that is not supported or conflicts with storyboard action definitions.",
+  unaddressed: "The planned call-to-action is not addressed or present in the storyboard actions."
+};
+function makeCtaConsistencyQuestion(plannedCta, storyboardAction) {
+  const instructions = `Evaluate whether the planned CTA copy is consistent with the storyboard action contract.
+
+Planned CTA:
+${plannedCta}
+
+Storyboard Action Contract:
+${storyboardAction}`;
+  return choice(instructions, CTA_CONSISTENCY_CRITERIA);
+}
+var EVIDENCE_RELEVANCE_RUBRIC = [
+  { score: 0, description: "Irrelevant: the excerpt has no bearing on the claim or task." },
+  { score: 1, description: "Tangential: the excerpt mentions a related topic but does not address the claim." },
+  { score: 2, description: "Partial: the excerpt contains information adjacent to the claim but misses key qualifications." },
+  { score: 3, description: "Relevant: the excerpt directly addresses the claim with useful detail." },
+  { score: 4, description: "Essential: the excerpt is the primary or sole source of evidence for the claim." }
+];
+function makeEvidenceRelevanceScoreQuestion(claim, excerpt) {
+  const instructions = `Rate how relevant the evidence excerpt is to evaluating the claim.
+
+Claim:
+${claim}
+
+Evidence Excerpt:
+${excerpt}`;
+  return score(instructions, EVIDENCE_RELEVANCE_RUBRIC);
+}
+var DIRECTION_SCORE_RUBRICS = {
+  business_fit: [
+    { score: 0, description: "Mismatch: aesthetic completely conflicts with the business domain and target audience." },
+    { score: 1, description: "Generic: generic modern layout without domain personality." },
+    { score: 2, description: "Adequate: acceptable styling that does not detract from credibility." },
+    { score: 3, description: "Strong: well-tuned aesthetic that builds immediate credibility and industry fit." },
+    { score: 4, description: "Exemplary: bespoke vernacular craft perfectly tailored to the business." }
+  ],
+  typography: [
+    { score: 0, description: "Poor: illegible, chaotic, or inappropriate type choices." },
+    { score: 1, description: "Bland: default system fonts with weak hierarchy." },
+    { score: 2, description: "Functional: clear contrast and readable hierarchy." },
+    { score: 3, description: "Refined: intentional font pairing with elegant rhythm and scale." },
+    { score: 4, description: "Editorial: publication-grade typographic pacing and bespoke details." }
+  ],
+  composition: [
+    { score: 0, description: "Cluttered: disorganized elements with poor rhythm." },
+    { score: 1, description: "Rigid: repetitive card grid without breathing room." },
+    { score: 2, description: "Balanced: clean spatial structure and adequate whitespace." },
+    { score: 3, description: "Dynamic: intentional pacing, focal points, and visual interest." },
+    { score: 4, description: "Harmonious: masterfully balanced visual density and narrative cadence." }
+  ],
+  authenticity: [
+    { score: 0, description: "Stock/AI: feels unmistakably like an automated stock template." },
+    { score: 1, description: "Imitative: borrows standard SaaS patterns inappropriately." },
+    { score: 2, description: "Honest: straightforward presentation without pretension." },
+    { score: 3, description: "Distinctive: distinctive personality grounded in actual customer work." },
+    { score: 4, description: "Singular: unforgettable signature identity that could belong to no other business." }
+  ]
+};
+function makeDirectionScoreQuestion(dimension, businessSummary, directionSpec) {
+  const rubric = DIRECTION_SCORE_RUBRICS[dimension];
+  const instructions = `Rate the design direction on the dimension "${dimension}".
+
+Business Context:
+${businessSummary}
+
+Design Direction Specification:
+${directionSpec}`;
+  return score(instructions, rubric);
+}
+var MEDIA_RELEVANCE_RUBRIC = [
+  { score: 0, description: "Irrelevant or deceptive: image depicts unrelated objects, incorrect industry, or stock placeholder." },
+  { score: 1, description: "Generic decorative: stock asset that loosely relates but lacks authentic local connection." },
+  { score: 2, description: "Plausible: depicts appropriate trade or setting but without specific customer evidence." },
+  { score: 3, description: "Authentic & Relevant: directly illustrates the actual work, team, facility, or region." },
+  { score: 4, description: "Heroic: prime authentic original capture perfectly embodying the core offer." }
+];
+var FIELD_SELECTION_NO_MATCH = "no_match";
+var FIELD_SELECTION_INSTRUCTION_TEMPLATE = "Select which supplied source span is the value of field `{field}` for this business. Copy a candidate verbatim; do not invent a value. Choose no_match if none of the spans belong to this business or the correct value is absent.";
+var FIELD_CANDIDATE_NOUL_TEMPLATE = "Is the source span at state.{valuePath} a valid `{field}` value that belongs to this business (not a third-party, unrelated, or stale mention)?";
+function makeFieldSelectionQuestion(field, candidates) {
+  const criteria = {};
+  for (const c of candidates) {
+    criteria[c.id] = `Use the verbatim source span "${c.value}" from ${c.source} as this field's value.`;
+  }
+  criteria[FIELD_SELECTION_NO_MATCH] = "None of the supplied candidate spans is the correct value for this field, or the correct value is absent from the candidate set.";
+  const listed = candidates.map((c) => `- ${c.id}: "${c.value}" (source: ${c.source}; excerpt: ${c.excerpt})`).join("\n");
+  const instructions = `${FIELD_SELECTION_INSTRUCTION_TEMPLATE.replace("{field}", field)}
+
+Candidates:
+${listed}`;
+  return choice(instructions, criteria);
+}
+function makeFieldCandidateNoulQuestion(field, candidate) {
+  return noul(
+    `Is the source span "${candidate.value}" a valid ${field} value that belongs to this business (not a third-party, unrelated, or stale mention)?
+Source: ${candidate.source}
+Excerpt: ${candidate.excerpt}`,
+    {
+      true: `This span is a legitimate ${field} value for this business and may coexist with other accepted ${field} values.`,
+      false: `This span does not belong to this business, is third-party, or is not a ${field} value.`
+    }
+  );
+}
+var FIELD_SELECTION_TASK_SEMANTICS = {
+  task: "field_selection",
+  version: QUESTION_VERSION,
+  template: FIELD_SELECTION_INSTRUCTION_TEMPLATE,
+  noulTemplate: FIELD_CANDIDATE_NOUL_TEMPLATE,
+  noMatch: FIELD_SELECTION_NO_MATCH
+};
+var FIELD_SELECTION_SEMANTICS_HASH = questionSemanticsHash(FIELD_SELECTION_TASK_SEMANTICS);
+function makeMediaRelevanceQuestion(sectionText, imageDescription) {
+  const instructions = `Rate how relevant and authentic the media asset is for the planned section.
+
+Section Copy:
+${sectionText}
+
+Media Asset Description:
+${imageDescription}`;
+  return score(instructions, MEDIA_RELEVANCE_RUBRIC);
+}
+var CLAIM_ERROR_NOUL_TRUE = "This error is present in the supplied assertion relative to the evidence.";
+var CLAIM_ERROR_NOUL_FALSE = "This error is not present.";
+function makeClaimErrorNoulQuestion(errorKind, assertion, evidence) {
+  const prompts = {
+    unsupported: "Is this assertion unsupported by the supplied evidence?",
+    contradiction: "Does the supplied evidence contradict this assertion?",
+    dropped_qualification: "Did the assertion drop a material qualification present in the evidence?",
+    exaggerated_strength: "Does the assertion exaggerate the strength of the evidence (superlative or certainty the source does not support)?",
+    off_target_evidence: "Is the supplied evidence off-target for what the assertion claims?"
+  };
+  return noul(
+    `${prompts[errorKind]}
+
+Assertion:
+${assertion}
+
+Evidence:
+${evidence}`,
+    { true: CLAIM_ERROR_NOUL_TRUE, false: CLAIM_ERROR_NOUL_FALSE }
+  );
+}
+var CLAIM_ERROR_TASK_SEMANTICS = {
+  version: QUESTION_VERSION,
+  primitive: "noul",
+  true: CLAIM_ERROR_NOUL_TRUE,
+  false: CLAIM_ERROR_NOUL_FALSE
+};
+var CLAIM_ERROR_SEMANTICS_HASH = questionSemanticsHash(CLAIM_ERROR_TASK_SEMANTICS);
+function makeIntentCoverageNoulQuestion(question, pageText) {
+  return noul(
+    `Does the supplied page text actually answer this visitor question with supporting facts present?
+
+Visitor question:
+${question}
+
+Page text:
+${pageText}`,
+    {
+      true: "The text answers the question with supporting facts.",
+      false: "The text does not answer the question or lacks supporting facts."
+    }
+  );
+}
+var INTENT_COVERAGE_TASK_SEMANTICS = {
+  version: QUESTION_VERSION,
+  primitive: "noul",
+  true: "The text answers the question with supporting facts.",
+  false: "The text does not answer the question or lacks supporting facts."
+};
+var INTENT_COVERAGE_SEMANTICS_HASH = questionSemanticsHash(INTENT_COVERAGE_TASK_SEMANTICS);
+var CTA_FIDELITY_CRITERIA = {
+  consistent: "The CTA label/promise matches the recorded textual behavior contract.",
+  mismatch: "The CTA label/promise does not match the recorded destination or action (e.g. Schedule pointing at a generic contact form)."
+};
+function makeCtaFidelityQuestion(label, behavior) {
+  return choice(
+    `Compare the CTA label/promise with the recorded textual behavior contract. Broken links are a separate deterministic failure and are not this question.
+
+CTA label:
+${label}
+
+Recorded behavior:
+${behavior}`,
+    CTA_FIDELITY_CRITERIA
+  );
+}
+var CTA_FIDELITY_TASK_SEMANTICS = {
+  version: QUESTION_VERSION,
+  primitive: "choice",
+  criteria: CTA_FIDELITY_CRITERIA
+};
+var CTA_FIDELITY_SEMANTICS_HASH = questionSemanticsHash(CTA_FIDELITY_TASK_SEMANTICS);
+var CONTINUITY_CRITERIA = {
+  preserved: "The later stage preserves the earlier meaning.",
+  narrowed: "The later stage narrows the earlier meaning without contradicting it.",
+  broadened: "The later stage broadens the earlier meaning.",
+  contradicted: "The later stage contradicts the earlier meaning.",
+  omitted: "The later stage omits the earlier meaning."
+};
+function makeContinuityQuestion(earlier, later, edge) {
+  return choice(
+    `Judge semantic continuity on edge "${edge}".
+
+Earlier:
+${earlier}
+
+Later:
+${later}`,
+    CONTINUITY_CRITERIA
+  );
+}
+var CONTINUITY_TASK_SEMANTICS = {
+  version: QUESTION_VERSION,
+  primitive: "choice",
+  criteria: CONTINUITY_CRITERIA
+};
+var CONTINUITY_SEMANTICS_HASH = questionSemanticsHash(CONTINUITY_TASK_SEMANTICS);
+function makeRedundancyNoulQuestion(first, second) {
+  return noul(
+    `Does the second instance add a distinct visitor-relevant fact, proof, or next step beyond the first?
+
+First:
+${first}
+
+Second:
+${second}`,
+    {
+      true: "The second instance adds a distinct visitor-relevant fact, proof, or next step.",
+      false: "The second instance is redundant for the visitor."
+    }
+  );
+}
+var CREATIVE_SCORE_RUBRICS = [
+  { score: 0, description: "Fail: does not serve this dimension." },
+  { score: 1, description: "Weak: generic or incomplete on this dimension." },
+  { score: 2, description: "Adequate: usable but not distinctive." },
+  { score: 3, description: "Strong: clearly serves this dimension with evidence." },
+  { score: 4, description: "Excellent: distinctive and concrete on this dimension." }
+];
+function makeCreativeDimensionQuestion(dimension, proposal, context) {
+  return score(
+    `Rate the textual proposal on "${dimension}". Jev has not seen pixels.
+
+Context:
+${context}
+
+Proposal:
+${proposal}`,
+    CREATIVE_SCORE_RUBRICS
+  );
+}
+var COMPONENT_FIT_RUBRICS = [
+  { score: 0, description: "Fail: incompatible with this dimension." },
+  { score: 1, description: "Weak fit; would need heavy adaptation." },
+  { score: 2, description: "Usable starting point with documented adaptations." },
+  { score: 3, description: "Strong fit on this dimension from metadata alone." },
+  { score: 4, description: "Excellent fit; little adaptation required." }
+];
+function makeComponentFitQuestion(dimension, candidate, state) {
+  return score(
+    `Score "${dimension}" for this block using only the supplied textual metadata. Jev has not seen pixels or screenshots.
+
+Section state:
+${state}
+
+Candidate:
+${candidate}`,
+    COMPONENT_FIT_RUBRICS
+  );
+}
+function makeRhythmRepetitionQuestion(pageRhythm, candidate) {
+  return noul(
+    `Would reusing this block create repetitive page rhythm relative to adjacent sections?
+
+Adjacent / page rhythm:
+${pageRhythm}
+
+Candidate:
+${candidate}`,
+    {
+      true: "Reuse would create repetitive page rhythm.",
+      false: "Reuse would not create repetitive page rhythm."
+    }
+  );
+}
+var COMPONENT_FIT_TASK_SEMANTICS = {
+  version: QUESTION_VERSION,
+  primitive: "score+noul",
+  rubrics: COMPONENT_FIT_RUBRICS
+};
+var COMPONENT_FIT_SEMANTICS_HASH = questionSemanticsHash(COMPONENT_FIT_TASK_SEMANTICS);
+var DIRECTION_DECISION_CRITERIA = {
+  supports: "The textual proposal supports this check.",
+  contradicts: "The textual proposal conflicts with this check.",
+  says_nothing: "The proposal does not contain enough text to decide."
+};
+var DIRECTION_DECISION_CHECKS = [
+  "hierarchy_serves_goal",
+  "uses_distinctive_evidence",
+  "requires_unavailable_imagery",
+  "alternatives_differ_in_experience",
+  "contradicts_user_constraint"
+];
+function makeDirectionDecisionQuestion(check, proposal, context) {
+  return choice(
+    `Judge the textual proposal only. You have not seen pixels.
+Check: ${check}
+Context:
+${context}
+Proposal:
+${proposal}`,
+    DIRECTION_DECISION_CRITERIA
+  );
+}
+var COMPOSITION_REPETITION_CRITERIA = {
+  serves_narrative: "The repeated treatment serves one visitor job or one deliberate list.",
+  unrelated_repetition: "Equal treatment repeats sections that answer different jobs without a rationale.",
+  insufficient_evidence: "The section notes do not say enough to judge repetition."
+};
+function makeCompositionRepetitionQuestion(pagePath, sectionContext) {
+  return choice(
+    `Judge whether repetition serves the narrative on ${pagePath}. Do not score universal beauty. You have not seen pixels.
+${sectionContext}`,
+    COMPOSITION_REPETITION_CRITERIA
+  );
+}
+
+export {
+  QUESTION_VERSION,
+  canonicalJsonStringify,
+  questionSemanticsHash,
+  GROUNDING_RELATION_CRITERIA,
+  PATH_REFERENCED_GROUNDING_INSTRUCTION_TEMPLATE,
+  EMBEDDED_GROUNDING_INSTRUCTION_TEMPLATE,
+  GROUNDING_TASK_INSTRUCTIONS,
+  GROUNDING_TASK_SEMANTICS,
+  GROUNDING_SEMANTICS_HASH,
+  makeGroundingQuestion,
+  makePathReferencedGroundingQuestion,
+  ROUTING_SCOPE_CRITERIA,
+  makeRoutingQuestion,
+  makeMultiScopeRoutingQuestions,
+  CTA_CONSISTENCY_CRITERIA,
+  makeCtaConsistencyQuestion,
+  EVIDENCE_RELEVANCE_RUBRIC,
+  makeEvidenceRelevanceScoreQuestion,
+  DIRECTION_SCORE_RUBRICS,
+  makeDirectionScoreQuestion,
+  MEDIA_RELEVANCE_RUBRIC,
+  FIELD_SELECTION_NO_MATCH,
+  FIELD_SELECTION_INSTRUCTION_TEMPLATE,
+  FIELD_CANDIDATE_NOUL_TEMPLATE,
+  makeFieldSelectionQuestion,
+  makeFieldCandidateNoulQuestion,
+  FIELD_SELECTION_TASK_SEMANTICS,
+  FIELD_SELECTION_SEMANTICS_HASH,
+  makeMediaRelevanceQuestion,
+  CLAIM_ERROR_NOUL_TRUE,
+  CLAIM_ERROR_NOUL_FALSE,
+  makeClaimErrorNoulQuestion,
+  CLAIM_ERROR_TASK_SEMANTICS,
+  CLAIM_ERROR_SEMANTICS_HASH,
+  makeIntentCoverageNoulQuestion,
+  INTENT_COVERAGE_TASK_SEMANTICS,
+  INTENT_COVERAGE_SEMANTICS_HASH,
+  CTA_FIDELITY_CRITERIA,
+  makeCtaFidelityQuestion,
+  CTA_FIDELITY_TASK_SEMANTICS,
+  CTA_FIDELITY_SEMANTICS_HASH,
+  CONTINUITY_CRITERIA,
+  makeContinuityQuestion,
+  CONTINUITY_TASK_SEMANTICS,
+  CONTINUITY_SEMANTICS_HASH,
+  makeRedundancyNoulQuestion,
+  CREATIVE_SCORE_RUBRICS,
+  makeCreativeDimensionQuestion,
+  COMPONENT_FIT_RUBRICS,
+  makeComponentFitQuestion,
+  makeRhythmRepetitionQuestion,
+  COMPONENT_FIT_TASK_SEMANTICS,
+  COMPONENT_FIT_SEMANTICS_HASH,
+  DIRECTION_DECISION_CRITERIA,
+  DIRECTION_DECISION_CHECKS,
+  makeDirectionDecisionQuestion,
+  COMPOSITION_REPETITION_CRITERIA,
+  makeCompositionRepetitionQuestion
+};