cbrowser 18.78.0 → 18.80.0

package/dist/values/big-five-inference.js

@@ -0,0 +1,241 @@
+/**
+ * Inferring Big Five scores from a free-text persona description.
+ *
+ * WHY THIS ROUTE EXISTS
+ *
+ * A persona's thirteen motivational values come from one of three routes, and
+ * they are not equally trustworthy: answers someone gave, then published Big
+ * Five correlations, then our own bridge from cognitive traits. The third route
+ * cannot reach four of the thirteen axes at all — hedonism, power, universalism
+ * and the relatedness need have no cognitive trait pointing at them — so a
+ * persona that falls to it gets four placeholders.
+ *
+ * In practice almost every persona falls to it, because personas are usually
+ * written as a sentence of description and nobody answers a questionnaire. The
+ * four unreachable axes are therefore not an edge case; they are the normal
+ * outcome.
+ *
+ * This route closes that, and it does so by moving the inference to where the
+ * evidence is better rather than by inventing links. A description like "a
+ * cautious retiree who double-checks everything before buying" is much closer to
+ * what a personality instrument actually measures than `patience: 0.4` is. Once
+ * a Big Five profile exists, all thirteen axes derive through correlations three
+ * independent bodies of research agree on.
+ *
+ * WHY IT IS LABELLED SEPARATELY, AND BELOW STATED BIG FIVE
+ *
+ * The estimate is a model reading prose. That is a real error source with no
+ * published calibration behind it, and it is NOT the same evidential object as
+ * five numbers a human supplied. Merging the two under one `big_five` label
+ * would hide exactly the distinction the route ordering exists to express — so
+ * this is its own route, `bigfive_inferred`, ranked below `big_five` and above
+ * `cognitive_traits`.
+ *
+ * The ranking is a claim about where the uncertainty sits, not about accuracy.
+ * Inferred Big Five has weak INPUTS and a strong BRIDGE (published correlations
+ * to values). The cognitive-trait route has stronger inputs — the persona's
+ * stated traits — and a weak bridge our own table invents. Those are different
+ * failure modes, and the honest reason to prefer this one is coverage: it
+ * reaches thirteen axes instead of nine, and it says out loud that it guessed.
+ *
+ * @since 2026-08-01
+ */
+/**
+ * Anchors for each factor, written as OBSERVABLE BEHAVIOUR rather than as trait
+ * adjectives.
+ *
+ * Asking a model "how open is this person, 0 to 1?" invites it to pattern-match
+ * on the word rather than on the description, and the failure is invisible
+ * because any number in range looks like an answer. Anchoring each end in
+ * something a description could actually say makes the estimate checkable
+ * against the text.
+ */
+export const BIG_FIVE_INFERENCE_ANCHORS = {
+    openness: {
+        low: "Prefers the familiar; sticks to what already works; describes routine, tradition, or 'the way I have always done it'.",
+        high: "Seeks novelty and variety; curious about unfamiliar things; described as imaginative, exploratory, interested in ideas.",
+        doNotConfuse: "Not the same as intelligence or competence. A highly skilled person who dislikes change is LOW openness.",
+    },
+    conscientiousness: {
+        low: "Improvises, leaves things half-finished, decides quickly on partial information, describes themselves as disorganised or spontaneous.",
+        high: "Plans, checks, finishes; keeps lists; described as careful, thorough, reliable, detail-oriented.",
+        doNotConfuse: "Not the same as slow. Someone fast AND thorough is high conscientiousness with high processing speed.",
+    },
+    extraversion: {
+        low: "Drained by interaction; prefers solitary work; described as reserved, private, quiet.",
+        high: "Energised by people; seeks stimulation and social contact; described as outgoing, talkative, assertive.",
+        doNotConfuse: "Not the same as social skill or confidence. A capable, confident person who finds people tiring is LOW extraversion.",
+    },
+    agreeableness: {
+        low: "Blunt, sceptical of others' motives, competitive, willing to argue; described as demanding or hard to please.",
+        high: "Cooperative, trusting, accommodating; avoids conflict; described as warm, helpful, considerate.",
+        doNotConfuse: "Not the same as being nice under duress. Someone who complies to avoid conflict but resents it is not high agreeableness.",
+    },
+    neuroticism: {
+        low: "Even-tempered under pressure; recovers quickly from setbacks; described as calm, steady, unflappable.",
+        high: "Worries, anticipates problems, rattled by uncertainty; described as anxious, stressed, easily frustrated.",
+        doNotConfuse: "Not the same as being careful. A calm person who double-checks is conscientious, NOT neurotic.",
+    },
+};
+/**
+ * Words that bear on each factor, used to ask whether a quote is about the
+ * thing it is cited for.
+ *
+ * The existence check ("is this phrase in the description?") closed the
+ * fabrication hole and left a second one open: a REAL phrase cited for the
+ * WRONG factor passes it completely. "power user" is in the description, so
+ * quoting it under extraversion satisfies every check — and it is a claim about
+ * expertise, not about whether people energise or drain this person.
+ *
+ * The lexicons are deliberately generous, because the cost of the two errors is
+ * not symmetric. Missing a real cue produces a warning on an honest quote;
+ * accepting an unrelated one produces a personality score with a citation that
+ * looks checked. So a miss is cheap and an over-tight list is not.
+ *
+ * What this CANNOT do is judge whether a related quote supports the DIRECTION
+ * of the score — "loves a crowded room" cited for extraversion 0.1 matches the
+ * lexicon and is still backwards. That needs a reader. This narrows the gap; it
+ * does not close it, and the response says so. (2026-08-01)
+ */
+export const BIG_FIVE_CUES = {
+    openness: ["curious", "curiosity", "explore", "explorat", "novel", "new ", "variety", "imagin", "creativ",
+        "idea", "experiment", "tries", "try ", "unfamiliar", "routine", "tradition", "familiar", "same way",
+        "always done", "set in", "adventur", "interest"],
+    conscientiousness: ["careful", "carefully", "thorough", "methodical", "organis", "organiz", "plan", "checks",
+        "double-check", "double check", "detail", "reliable", "diligent", "disciplin", "list", "systematic",
+        "sloppy", "disorgan", "spontaneous", "improvis", "half-finish", "rushes", "skips", "hasty", "meticulous"],
+    extraversion: ["outgoing", "talkative", "social", "sociable", "people", "group", "team", "assertive",
+        "energis", "energiz", "chatty", "gregarious", "reserved", "quiet", "private", "solitary", "alone",
+        "introvert", "extrovert", "shy", "withdraw", "keeps to"],
+    agreeableness: ["cooperat", "trusting", "trusts", "warm", "helpful", "considerate", "kind", "accommodat",
+        "polite", "agreeab", "conflict", "blunt", "argu", "sceptic", "skeptic", "competitive", "demanding",
+        "hard to please", "critical", "suspicious", "confront", "patient with", "generous"],
+    neuroticism: ["anxious", "anxiety", "worry", "worries", "stress", "nervous", "frustrat", "rattled",
+        "overwhelm", "panic", "tense", "upset", "fear", "afraid", "calm", "steady", "even-temper", "unflappable",
+        "relaxed", "composed", "resilient", "recovers", "self-doubt", "doubts"],
+};
+/** Does this quote contain any word that bears on this factor? */
+export function quoteRelatesToFactor(factor, quote) {
+    const cues = BIG_FIVE_CUES[factor];
+    if (!cues)
+        return true;
+    const q = quote.toLowerCase();
+    return cues.some((c) => q.includes(c));
+}
+/**
+ * Validate an inferred profile before it is stored.
+ *
+ * Two things are rejected, both because they are the shapes a guess takes when
+ * a model had nothing to go on:
+ *
+ *   - A score with no supporting quote. The quote is the audit trail; without it
+ *     nobody can tell an estimate grounded in the text from one produced to fill
+ *     the field. A required quote is also the cheapest brake on inventing a
+ *     number the description does not support.
+ *   - All five landing at 0.5. That is the shape of "no signal" wearing the
+ *     shape of "measured average", which is the same 0.5 ambiguity this whole
+ *     values layer went to some length to remove elsewhere.
+ */
+export function validateInferredBigFive(scores, evidence, 
+/**
+ * The description the scores were inferred from.
+ *
+ * Without it the quote requirement is cosmetic: any string satisfies "a quote
+ * is present", including the string "NO SUPPORTING TEXT". Checked against the
+ * source, a quote is evidence; unchecked, it is a field someone filled in.
+ * (2026-08-01)
+ */
+description) {
+    const FACTORS = Object.keys(BIG_FIVE_INFERENCE_ANCHORS);
+    const missing = FACTORS.filter((f) => typeof scores[f] !== "number");
+    if (missing.length) {
+        return { ok: false, reason: `missing scores for ${missing.join(", ")} — all five factors are required, because deriving values from a partial profile silently leaves axes at baseline` };
+    }
+    const outOfRange = FACTORS.filter((f) => scores[f] < 0 || scores[f] > 1);
+    if (outOfRange.length) {
+        return { ok: false, reason: `out of range: ${outOfRange.join(", ")} (expected 0-1)` };
+    }
+    const quoted = new Set((evidence ?? []).filter((e) => e.quote?.trim()).map((e) => e.factor));
+    const unquoted = FACTORS.filter((f) => !quoted.has(f));
+    if (unquoted.length) {
+        return { ok: false, reason: `no supporting quote for ${unquoted.join(", ")} — every factor must cite the words in the description that justify its score, so a reader can check the estimate against the text rather than trusting it` };
+    }
+    // The quote must actually BE in the description.
+    //
+    // Comparison is on letters and digits only, so punctuation, case and
+    // whitespace differences do not reject an honest quote -- but a phrase that
+    // is not in the text at all cannot pass, which is the whole point. A quote
+    // reading "NO SUPPORTING TEXT" was accepted verbatim before this.
+    if (description) {
+        const norm = (t) => t.toLowerCase().replace(/[^a-z0-9]+/g, "");
+        const haystack = norm(description);
+        const fabricated = (evidence ?? [])
+            .filter((e) => e.quote?.trim() && !haystack.includes(norm(e.quote)))
+            .map((e) => `${e.factor} ("${e.quote.slice(0, 40)}")`);
+        if (fabricated.length) {
+            return { ok: false, reason: `these quotes do not appear in the description: ${fabricated.join("; ")}. A quote nobody can find in the source is not evidence. If the description does not speak to a factor, omit the whole profile rather than filling the field — see the note below.` };
+        }
+    }
+    // One quote cited for several factors is the shape of a caller who found a
+    // single quotable sentence and used it everywhere. Two can be legitimate --
+    // "anxious about getting it wrong, so she checks twice" genuinely speaks to
+    // neuroticism AND conscientiousness. Three or more is one sentence doing the
+    // work of a personality profile.
+    const byQuote = new Map();
+    for (const e of evidence ?? []) {
+        if (!e.quote?.trim())
+            continue;
+        const k = e.quote.trim().toLowerCase();
+        byQuote.set(k, [...(byQuote.get(k) ?? []), e.factor]);
+    }
+    const overused = [...byQuote.entries()].filter(([, fs]) => fs.length >= 3);
+    if (overused.length) {
+        const [q, fs] = overused[0];
+        return { ok: false, reason: `the same quote ("${q.slice(0, 50)}") is cited for ${fs.length} factors (${fs.join(", ")}). One sentence is not evidence for most of a personality profile — quote the specific words behind each score, or omit the profile` };
+    }
+    // Does each quote have anything to do with the factor it is cited for?
+    //
+    // The existence check accepts a real phrase cited for the wrong factor:
+    // "power user" appears in the description, so quoting it under extraversion
+    // passed every gate while making a claim about expertise, not sociability.
+    const unrelated = (evidence ?? [])
+        .filter((e) => e.quote?.trim() && BIG_FIVE_CUES[e.factor] && !quoteRelatesToFactor(e.factor, e.quote))
+        .map((e) => `${e.factor} ("${e.quote.slice(0, 40)}")`);
+    // Every quote unrelated means the citations are decoration. Some unrelated is
+    // reported rather than rejected: the lexicons are heuristics, and rejecting an
+    // honest quote for missing a keyword would teach callers to pad quotes with
+    // cue words, which is worse than the problem.
+    if (unrelated.length >= FACTORS.length) {
+        return { ok: false, reason: `none of the quotes contain any word bearing on the factor they are cited for (${unrelated.join("; ")}). Quote the words that make the case for THAT factor` };
+    }
+    if (FACTORS.every((f) => scores[f] === 0.5)) {
+        return { ok: false, reason: "all five factors are exactly 0.5, which is what 'no signal' looks like wearing the shape of 'measured average'. If the description genuinely does not support an estimate, omit the profile and let the persona use the cognitive-trait route, which reports its own gaps" };
+    }
+    return unrelated.length ? { ok: true, unrelatedQuotes: unrelated } : { ok: true };
+}
+/** The block handed to the inferring model. Behavioural anchors, not adjectives. */
+export function bigFiveInferenceReference() {
+    return {
+        instruction: "Estimate this persona's Big Five personality profile from the description, 0-1 per factor. "
+            + "For EACH factor, quote the words in the description that justify the score — the quote is checked against the description and a phrase that is not in it is rejected. "
+            // The previous wording told callers to decline individual factors while
+            // the schema required all five, which are not both satisfiable. The
+            // profile is all-or-nothing on purpose: a partial one silently leaves
+            // axes at baseline, which is the ambiguity this whole layer exists to
+            // remove. So the honest out is omitting the profile, not part of it.
+            + "It is ALL FIVE OR NONE: if the description does not support estimating every factor, omit bigFive entirely rather than filling the weak ones. "
+            + "A persona with no Big Five profile derives its values from cognitive traits and reports its own gaps; a persona with an invented one does not.",
+        why: "Big Five scores unlock all thirteen motivational values through published correlations. "
+            + "Without them the persona falls back to deriving values from cognitive traits, which cannot reach "
+            + "hedonism, power, universalism or the relatedness need at all — those four stay at the 0.5 baseline.",
+        factors: BIG_FIVE_INFERENCE_ANCHORS,
+        output_shape: {
+            bigFive: { openness: 0.7, conscientiousness: 0.3, extraversion: 0.8, agreeableness: 0.6, neuroticism: 0.2 },
+            bigFiveEvidence: [
+                { factor: "openness", score: 0.7, quote: "curious about unfamiliar tools" },
+                { factor: "conscientiousness", score: 0.3, quote: "skims content, decides fast" },
+            ],
+        },
+    };
+}
+//# sourceMappingURL=big-five-inference.js.map

package/dist/values/big-five-inference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-five-inference.js","sourceRoot":"","sources":["../../src/values/big-five-inference.ts"],"names":[],"mappings":"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"}

package/dist/values/big-five-values.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Big Five -> Schwartz values.
+ *
+ * Why this exists alongside the cognitive-trait correlations: the published
+ * literature relates VALUES to the Big Five, not to patience or satisficing or
+ * information foraging. Deriving a value from a cognitive trait therefore
+ * always crosses a gap the research does not cover -- the direction may be
+ * reasonable, but the bridge is ours. Deriving it from the Big Five does not
+ * cross that gap, because the Big Five is the construct the studies measured.
+ *
+ * This also fills the four axes no cognitive trait reaches. hedonism and power
+ * are Extraversion territory; universalism is Openness and Agreeableness;
+ * relatedness is the weakest of the four and is labelled accordingly.
+ *
+ * WHAT IS ESTABLISHED AND WHAT IS NOT
+ *
+ * The DIRECTION of each link below is reported consistently across Roccas,
+ * Sagiv, Schwartz & Knafo (2002, N=246), Fischer & Boer's three-level
+ * meta-analysis (2015, N=9,935 across 14 countries), and Parks-Leduc, Feldman
+ * & Bardi's meta-analysis of 60 studies. Those three agree on sign for every
+ * pairing used here.
+ *
+ * The MAGNITUDES are ours. The published correlations are modest -- the
+ * meta-analyses stress that traits and values are distinct constructs and the
+ * relationships "are not generally large" -- and none of the sources reachable
+ * for this work published a full r-value table. So every weight here is a
+ * modelling choice scaled to the reported relative strength, not a coefficient
+ * copied from a paper. `evidence` on each row says which half you are reading.
+ *
+ * Anyone recalibrating this should change the weights freely and the signs only
+ * with a citation.
+ *
+ * @since 2026-08-01
+ */
+export type BigFiveFactor = 'openness' | 'conscientiousness' | 'extraversion' | 'agreeableness' | 'neuroticism';
+export interface BigFiveScores {
+    openness: number;
+    conscientiousness: number;
+    extraversion: number;
+    agreeableness: number;
+    neuroticism: number;
+}
+export interface BigFiveValueLink {
+    factor: BigFiveFactor;
+    value: string;
+    /** Ours. Scaled to reported relative strength, not a published coefficient. */
+    weight: number;
+    direction: 'positive' | 'negative';
+    /**
+     * `direction-established` — sign agreed by the three sources named above;
+     * weight is a modelling choice.
+     * `direction-inferred` — sign follows from theory or from a weaker/adjacent
+     * finding, and should be treated as a hypothesis.
+     */
+    evidence: 'direction-established' | 'direction-inferred';
+    source: string;
+}
+export declare const BIG_FIVE_VALUE_LINKS: BigFiveValueLink[];
+/**
+ * Values from a Big Five profile, same squash as the trait derivation so the
+ * two paths produce comparable numbers.
+ */
+export declare function deriveValuesFromBigFive(scores: Partial<BigFiveScores>): {
+    values: Record<string, number>;
+    contributions: Array<{
+        factor: string;
+        value: string;
+        contribution: number;
+        evidence: string;
+    }>;
+    /** Axes with at least one link whose direction is a hypothesis, not a finding. */
+    hypothesisAxes: string[];
+};
+/** Axes this table can reach — all thirteen, which is the point of adding it. */
+export declare function bigFiveReachableAxes(): string[];
+//# sourceMappingURL=big-five-values.d.ts.map

package/dist/values/big-five-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-five-values.d.ts","sourceRoot":"","sources":["../../src/values/big-five-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,mBAAmB,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAEhH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EAyFlD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChG,kFAAkF;IAClF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CA0BA;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/values/big-five-values.js

@@ -0,0 +1,152 @@
+/**
+ * Big Five -> Schwartz values.
+ *
+ * Why this exists alongside the cognitive-trait correlations: the published
+ * literature relates VALUES to the Big Five, not to patience or satisficing or
+ * information foraging. Deriving a value from a cognitive trait therefore
+ * always crosses a gap the research does not cover -- the direction may be
+ * reasonable, but the bridge is ours. Deriving it from the Big Five does not
+ * cross that gap, because the Big Five is the construct the studies measured.
+ *
+ * This also fills the four axes no cognitive trait reaches. hedonism and power
+ * are Extraversion territory; universalism is Openness and Agreeableness;
+ * relatedness is the weakest of the four and is labelled accordingly.
+ *
+ * WHAT IS ESTABLISHED AND WHAT IS NOT
+ *
+ * The DIRECTION of each link below is reported consistently across Roccas,
+ * Sagiv, Schwartz & Knafo (2002, N=246), Fischer & Boer's three-level
+ * meta-analysis (2015, N=9,935 across 14 countries), and Parks-Leduc, Feldman
+ * & Bardi's meta-analysis of 60 studies. Those three agree on sign for every
+ * pairing used here.
+ *
+ * The MAGNITUDES are ours. The published correlations are modest -- the
+ * meta-analyses stress that traits and values are distinct constructs and the
+ * relationships "are not generally large" -- and none of the sources reachable
+ * for this work published a full r-value table. So every weight here is a
+ * modelling choice scaled to the reported relative strength, not a coefficient
+ * copied from a paper. `evidence` on each row says which half you are reading.
+ *
+ * Anyone recalibrating this should change the weights freely and the signs only
+ * with a citation.
+ *
+ * @since 2026-08-01
+ */
+export const BIG_FIVE_VALUE_LINKS = [
+    // ── Openness ──
+    { factor: 'openness', value: 'selfDirection', weight: 0.7, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002); Fischer & Boer (2015) — Openness is the strongest correlate of self-direction' },
+    { factor: 'openness', value: 'universalism', weight: 0.6, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002); Parks-Leduc et al. (2015) — Openness correlates with universalism' },
+    { factor: 'openness', value: 'stimulation', weight: 0.6, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Openness associated with stimulation' },
+    { factor: 'openness', value: 'tradition', weight: 0.5, direction: 'negative',
+        evidence: 'direction-established',
+        source: 'Fischer & Boer (2015) — Openness–Conservation is among the strongest reported relationships, negative' },
+    { factor: 'openness', value: 'conformity', weight: 0.4, direction: 'negative',
+        evidence: 'direction-established',
+        source: 'Fischer & Boer (2015) — Openness opposes the Conservation dimension' },
+    // ── Extraversion ──
+    { factor: 'extraversion', value: 'hedonism', weight: 0.6, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002); Parks-Leduc et al. (2015) — Extraversion correlates positively with hedonism' },
+    { factor: 'extraversion', value: 'power', weight: 0.5, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Parks-Leduc et al. (2015) — Extraversion correlates most positively with stimulation, hedonism, achievement and power' },
+    { factor: 'extraversion', value: 'achievement', weight: 0.5, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Extraversion associated with achievement' },
+    { factor: 'extraversion', value: 'stimulation', weight: 0.5, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Extraversion associated with stimulation' },
+    { factor: 'extraversion', value: 'tradition', weight: 0.3, direction: 'negative',
+        evidence: 'direction-established',
+        source: 'Parks-Leduc et al. (2015) — Extraversion correlates most negatively with tradition' },
+    // ── Agreeableness ──
+    { factor: 'agreeableness', value: 'benevolence', weight: 0.7, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002); Fischer & Boer (2015) — Agreeableness–Transcendence is among the strongest reported' },
+    { factor: 'agreeableness', value: 'universalism', weight: 0.5, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Parks-Leduc et al. (2015) — Agreeableness correlates positively with universalism' },
+    { factor: 'agreeableness', value: 'conformity', weight: 0.4, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Agreeableness associated with conformity' },
+    { factor: 'agreeableness', value: 'tradition', weight: 0.4, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Agreeableness associated with tradition' },
+    { factor: 'agreeableness', value: 'power', weight: 0.5, direction: 'negative',
+        evidence: 'direction-established',
+        source: 'Parks-Leduc et al. (2015) — Agreeableness correlates most negatively with power and achievement' },
+    { factor: 'agreeableness', value: 'achievement', weight: 0.3, direction: 'negative',
+        evidence: 'direction-established',
+        source: 'Parks-Leduc et al. (2015) — Agreeableness correlates negatively with achievement' },
+    // ── Conscientiousness ──
+    { factor: 'conscientiousness', value: 'achievement', weight: 0.6, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Conscientiousness associated with achievement' },
+    { factor: 'conscientiousness', value: 'conformity', weight: 0.5, direction: 'positive',
+        evidence: 'direction-established',
+        source: 'Roccas et al. (2002) — Conscientiousness associated with conformity' },
+    { factor: 'conscientiousness', value: 'security', weight: 0.4, direction: 'positive',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Conscientiousness sits on the Conservation side of the circumplex with conformity, and security is the third Conservation value. No source reachable for this work reported the pairing directly.' },
+    { factor: 'conscientiousness', value: 'hedonism', weight: 0.4, direction: 'negative',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Hedonism opposes Conservation on the circumplex, so a Conscientiousness–hedonism negative follows from the structure rather than from a reported coefficient.' },
+    // ── Neuroticism ──
+    { factor: 'neuroticism', value: 'security', weight: 0.4, direction: 'positive',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Threat sensitivity plausibly raises the priority of safety and stability. Reported Neuroticism–value correlations are the weakest of the five factors, so this is the least confident row here.' },
+    // ── Relatedness need (SDT, not Schwartz) ──
+    { factor: 'agreeableness', value: 'relatednessNeed', weight: 0.5, direction: 'positive',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Need-support research reports that people experiencing relatedness satisfaction tend to be more agreeable and extroverted, which is a correlate of satisfaction rather than of the need itself. Treated as the weakest link in this table.' },
+    { factor: 'extraversion', value: 'relatednessNeed', weight: 0.4, direction: 'positive',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Same basis and same caveat as the Agreeableness link above.' },
+    // ── Autonomy and competence needs ──
+    { factor: 'openness', value: 'autonomyNeed', weight: 0.4, direction: 'positive',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Openness predicts self-direction, and autonomy is the SDT construct nearest to it. An inference across two frameworks, not a reported pairing.' },
+    { factor: 'conscientiousness', value: 'competenceNeed', weight: 0.4, direction: 'positive',
+        evidence: 'direction-inferred',
+        source: 'HYPOTHESIS. Conscientiousness predicts achievement, and competence is the SDT construct nearest to it. Same cross-framework caveat.' },
+];
+/**
+ * Values from a Big Five profile, same squash as the trait derivation so the
+ * two paths produce comparable numbers.
+ */
+export function deriveValuesFromBigFive(scores) {
+    const AXES = ['selfDirection', 'stimulation', 'hedonism', 'achievement', 'power', 'security',
+        'conformity', 'tradition', 'benevolence', 'universalism',
+        'autonomyNeed', 'competenceNeed', 'relatednessNeed'];
+    const raw = {};
+    AXES.forEach((a) => { raw[a] = 0; });
+    const contributions = [];
+    const hypothesis = new Set();
+    for (const link of BIG_FIVE_VALUE_LINKS) {
+        const s = scores[link.factor];
+        if (typeof s !== 'number')
+            continue;
+        const c = (s - 0.5) * link.weight * (link.direction === 'positive' ? 1 : -1);
+        raw[link.value] = (raw[link.value] ?? 0) + c;
+        if (Math.abs(c) > 0.02) {
+            contributions.push({ factor: link.factor, value: link.value,
+                contribution: Math.round(c * 100) / 100, evidence: link.evidence });
+        }
+        if (link.evidence === 'direction-inferred')
+            hypothesis.add(link.value);
+    }
+    const values = {};
+    AXES.forEach((a) => { values[a] = Math.round((0.5 + 0.5 * Math.tanh(raw[a])) * 100) / 100; });
+    return { values, contributions, hypothesisAxes: [...hypothesis] };
+}
+/** Axes this table can reach — all thirteen, which is the point of adding it. */
+export function bigFiveReachableAxes() {
+    return [...new Set(BIG_FIVE_VALUE_LINKS.map((l) => l.value))];
+}
+//# sourceMappingURL=big-five-values.js.map

package/dist/values/big-five-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"big-five-values.js","sourceRoot":"","sources":["../../src/values/big-five-values.ts"],"names":[],"mappings":"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"}

package/dist/values/index.d.ts

@@ -10,5 +10,5 @@
  */
 export { type SchwartzValues, type HigherOrderValues, type SDTNeeds, type MaslowLevel, type PersonaValues, type ValueTraitCorrelation, calculateHigherOrderValues, createPersonaValues, VALUE_TRAIT_CORRELATIONS, DEFAULT_VALUES, } from "./schwartz-values.js";
 export { type ValueBehaviors, type InfluencePattern, type ValueProfilePattern, VALUE_BEHAVIORS, INFLUENCE_PATTERNS, VALUE_PROFILE_PATTERNS, calculatePatternSusceptibility, rankInfluencePatternsForProfile, } from "./value-mappings.js";
-export { type PersonaValueProfile, PERSONA_VALUE_PROFILES, getPersonaValues, hasPersonaValues, resolvePersonaName, registerPersonaValues, } from "./persona-values.js";
+export { type PersonaValueProfile, PERSONA_VALUE_PROFILES, getPersonaValues, resolveValuesForPersona, hasPersonaValues, resolvePersonaName, registerPersonaValues, } from "./persona-values.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/values/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/values/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/values/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/values/index.js

@@ -13,5 +13,5 @@ export { calculateHigherOrderValues, createPersonaValues, VALUE_TRAIT_CORRELATIO
 // Value-behavior mappings and influence patterns
 export { VALUE_BEHAVIORS, INFLUENCE_PATTERNS, VALUE_PROFILE_PATTERNS, calculatePatternSusceptibility, rankInfluencePatternsForProfile, } from "./value-mappings.js";
 // Persona value profiles
-export { PERSONA_VALUE_PROFILES, getPersonaValues, hasPersonaValues, resolvePersonaName, registerPersonaValues, } from "./persona-values.js";
+export { PERSONA_VALUE_PROFILES, getPersonaValues, resolveValuesForPersona, hasPersonaValues, resolvePersonaName, registerPersonaValues, } from "./persona-values.js";
 //# sourceMappingURL=index.js.map

package/dist/values/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/values/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iCAAiC;AACjC,OAAO,EAOL,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,iDAAiD;AACjD,OAAO,EAIL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,yBAAyB;AACzB,OAAO,EAEL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/values/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iCAAiC;AACjC,OAAO,EAOL,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,iDAAiD;AACjD,OAAO,EAIL,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAE7B,yBAAyB;AACzB,OAAO,EAEL,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/values/persona-completeness.d.ts

@@ -0,0 +1,91 @@
+/**
+ * What a persona must account for before it can be submitted.
+ *
+ * THE PROBLEM
+ *
+ * `persona_create_submit_traits` accepted whatever it was given. A caller who
+ * named three traits got back a complete 26-trait persona, because
+ * `buildTraitsFromAnswers` fills every unsupplied one from a research baseline.
+ * The persona then looked finished from the outside — full trait vector, real
+ * numbers, no warning in the payload — while most of those numbers were
+ * population defaults nobody had considered for this person.
+ *
+ * Five personas on this install carry exactly that history: each is missing the
+ * same four traits (selfEfficacy, satisficing, trustCalibration,
+ * interruptRecovery), which means one creation session skipped them and nothing
+ * asked. Filling them afterwards is archaeology — reading the description months
+ * later and hoping it still supports a number.
+ *
+ * THE RULE
+ *
+ * Every trait must be ACCOUNTED FOR at submission: either given a value, or
+ * named explicitly as something the description does not support. Both are fine
+ * answers. Silence is not, because silence and "0.5 is genuinely right here"
+ * produce the same persona and nothing downstream can tell them apart.
+ *
+ * This is the same contract the Big Five inference already uses — supply it with
+ * evidence, or omit it deliberately and let the caller know what that costs.
+ *
+ * WHY REJECT RATHER THAN WARN
+ *
+ * A warning in a response is read once, by a model that has already moved on to
+ * the next tool call. The persona is written either way, and the gap is only
+ * discovered when someone audits months later. Refusing the write is the only
+ * version of this that changes what gets stored.
+ *
+ * @since 2026-08-01
+ */
+/** Traits a persona description can realistically speak to, and what to look for. */
+export declare const TRAIT_INFERENCE_CRITERIA: Record<string, string>;
+/**
+ * siteFamiliarity is deliberately NOT in the list above.
+ *
+ * It is a persona-SITE variable, not a disposition. The same person is familiar
+ * with one site and new to another, so no description can answer it: "prior
+ * experience with THIS site" has no value until a site is named. Requiring it
+ * per persona forced a number that was wrong for every site except whichever
+ * one the author happened to be thinking of, and the completeness contract made
+ * that mandatory rather than optional.
+ *
+ * It is supplied per run instead, on the tools that audit a specific site.
+ * A stored persona value, where one exists, is a fallback for callers that do
+ * not pass it. (2026-08-01)
+ */
+export declare const SITE_SCOPED_TRAITS: readonly ["siteFamiliarity"];
+export declare const ALL_TRAITS: string[];
+/**
+ * How a supplied trait value was arrived at.
+ *
+ * The contract enforced ACCOUNTING and reported it as if it were honesty. A
+ * caller who invented six values and supplied all 26 got back "26 of 26
+ * supplied; 0 filled from research baselines" -- which reads as a quality
+ * signal while six of those numbers were unfalsifiable inventions. The contract
+ * had no way to tell, and the output format erased the question.
+ *
+ * `supported` means the description says it. `asserted` means the caller
+ * decided it anyway -- a legitimate thing to do, and a different epistemic
+ * object. Naming which is which costs a word and restores the distinction the
+ * count destroyed. (2026-08-01)
+ */
+export type TraitProvenanceKind = "supported" | "asserted";
+export interface CompletenessVerdict {
+    ok: boolean;
+    unaccounted: string[];
+    message?: string;
+    /** Traits the caller decided rather than read out of the description. */
+    asserted?: string[];
+    /** Traits supplied with no provenance stated — unknown, not supported. */
+    unlabelled?: string[];
+}
+/**
+ * Every trait must be supplied or explicitly declared unsupported.
+ *
+ * `unsupported` is a first-class answer, not a failure: a description that says
+ * nothing about someone's response to scarcity should not be made to produce a
+ * number. What it must not do is stay silent, because the persona is built
+ * either way and a defaulted trait is indistinguishable from a considered one.
+ */
+export declare function assessTraitCompleteness(supplied: Record<string, number> | undefined, unsupported: string[] | undefined, 
+/** Per-trait: did the description support this, or did the caller assert it? */
+provenance?: Record<string, TraitProvenanceKind>): CompletenessVerdict;
+//# sourceMappingURL=persona-completeness.d.ts.map

package/dist/values/persona-completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-completeness.d.ts","sourceRoot":"","sources":["../../src/values/persona-completeness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0B3D,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,8BAA+B,CAAC;AAE/D,eAAO,MAAM,UAAU,UAAwC,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC5C,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS;AACjC,gFAAgF;AAChF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC/C,mBAAmB,CAsBrB"}