Forensic Behavioral Analysis
Methodology White Paper
This document describes the analytical methods, scoring frameworks, and academic foundations underlying Verity's conversation forensics engine. It is intended for use by legal professionals, expert witnesses, and courts evaluating the admissibility and weight of Verity-generated reports.
Version
2.1
Updated
June 2026
Patterns
16 warning · 7 positive
Frameworks
AMPD · SARA · Dark Triad
Table of Contents
- Overview and Intended Use
- Input Processing and Format Support
- Subject Identification
- Pattern Detection Methodology
- Warning Patterns — Definitions and Citations
- Positive Patterns
- Confidence Score Calculation
- Relationship Health Score
- Personality and Risk Assessment Frameworks
- SARA Risk Assessment
- Limitations and Caveats
- Federal Rule of Evidence 702 Considerations
- Bibliography
1.Overview and Intended Use
Verity is a forensic conversation analysis system designed to assist licensed legal professionals in documenting behavioral patterns within digital communications. The system processes exported conversation files — from platforms including WhatsApp, SMS, Facebook Messenger, Instagram, Telegram, Discord, and email (.mbox) — and applies a rule-based pattern matching engine informed by established psychological literature on coercive control, domestic abuse dynamics, and relationship communication research.
Verity reports are intended as supporting forensic documentation for use by attorneys, court-appointed advocates, and mental health professionals. They are not a substitute for expert witness testimony from a qualified forensic psychologist, clinical diagnosis, or independent professional evaluation. The existence of a detected pattern in a conversation does not, by itself, establish abuse, coercive control, or any legal finding.
2.Input Processing and Format Support
The Verity parser accepts exported conversation files in the following formats, with automatic format detection based on file extension and content structure:
| Platform | Format | Detection Method |
|---|---|---|
| .txt | Date-time pattern at line start (US and EU formats) | |
| SMS Backup & Restore | .xml | <smses> root element detection |
| Facebook Messenger | .json | timestamp_ms field in messages array |
| Instagram DMs | .json | sender_name without timestamp_ms |
| Telegram Desktop | .json | from field + ISO date string |
| Google Messages | .json | text + date fields, no sender_name |
| Discord | .json | author.name + ISO timestamp string |
| Email threads | .mbox | RFC 4155 "From " envelope line |
| Generic | .csv | Dynamic header detection (timestamp, message, sender) |
Files up to 50 MB are supported. Multi-file uploads are accepted; messages from multiple files are merged and sorted by timestamp before analysis. There is no practical upper limit on message count — the engine has been tested against exports exceeding 80,000 messages.
3.Subject Identification
The analysis subject — the party whose behavioral patterns are being evaluated — is determined automatically using message volume heuristics:
- All unique sender identities are enumerated from the conversation.
- The sender with the fewest messages is classified as the analyzing party (the user).
- All remaining senders are classified as the subject(s).
- Pattern matching is applied only to the subject's messages.
- The subject with the highest message count among non-user senders is designated the primary subject for reporting.
This heuristic assumes the party who exported the conversation sent fewer messages than the subject being analyzed. In cases where message counts are equal, the first sender encountered in the export is classified as the user. Attorneys should verify subject identification on the report cover page before use.
4.Pattern Detection Methodology
Verity uses a lexical rule-based pattern matchingapproach. For each defined behavioral pattern, a set of regular expressions is tested against each of the subject's messages. A message is flagged for a pattern if any of the pattern's expressions matches the message text.
The approach is deterministic and fully auditable — the same input will always produce the same output, and the specific phrases that triggered each pattern flag are preserved and available in the report under "Flagged Message Activity." This makes the analysis transparent and reproducible, which is important for cross-examination purposes.
The engine applies several refinements to reduce false positives:
- Minimum message length: Messages shorter than 3 characters are not evaluated.
- Stonewalling disambiguation: Short responses that match stonewalling patterns are not flagged when the preceding message was a question or request, as this indicates a genuine (if brief) reply rather than dismissive disengagement.
- Cycle-apology detection: Apologies occurring within 72 hours of a flagged pattern match are identified as potentially cyclic rather than genuine repair, and are noted separately in the report.
- Escalation analysis: Flagged messages are mapped month-by-month to identify temporal escalation in pattern frequency, a factor relevant to coercive control assessments.
Pattern matching runs entirely against the subject's messages. Messages from the user/analyzing party are used only for context (e.g., determining whether a subject's short response followed a question) and are not themselves flagged.
5.Warning Patterns — Definitions and Citations
The following 16 warning patterns are evaluated. Severity levels (Critical / High / Medium) reflect the weight of the pattern in the health score calculation and the strength of its association with abusive relationship dynamics in the research literature.
Gaslighting
CriticalManipulating someone into questioning their own memory, perception, or sanity.
Stern, R. (2007). The Gaslight Effect. Morgan Road Books.
DARVO
CriticalDeny, Attack, Reverse Victim and Offender — flipping accountability onto the accuser.
Freyd, J. J. (1997). Violations of power, adaptive blindness, and betrayal trauma theory. Feminism & Psychology, 7(1), 22–32.
Coercive Control
CriticalUsing control, surveillance, and restriction to dominate a partner.
Stark, E. (2007). Coercive Control. Oxford University Press.
Threats
CriticalExplicit or implicit threats to harm, leave, expose, or punish.
Walker, L. E. (1979). The Battered Woman. Harper & Row.
Isolation Tactics
CriticalAttempting to cut the victim off from friends, family, or support networks.
Stark, E. (2007). Coercive Control. Oxford University Press.
Stonewalling
HighRefusing to engage, shutting down communication, or giving the silent treatment.
Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.
Blame Shifting
HighDeflecting responsibility for one's own actions onto the victim.
Bancroft, L. (2002). Why Does He Do That? Putnam.
Explosive Anger
HighSudden, disproportionate outbursts of rage, often to intimidate.
Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.
Character Criticism
HighAttacking the person's character rather than addressing specific behaviors.
Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.
Contempt
HighExpressing disgust or superiority — mocking, sneering, belittling.
Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.
Emotional Manipulation
HighUsing guilt, pity, or emotional leverage to control behavior.
Bancroft, L. (2002). Why Does He Do That? Putnam.
Defensiveness
MediumDeflecting criticism by counter-attacking or making excuses.
Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.
Love Bombing
MediumOverwhelming affection or flattery used as manipulation.
Carnes, P. (2015). The Betrayal Bond. Health Communications.
Minimizing
MediumDownplaying the victim's feelings, experiences, or concerns.
Bancroft, L. (2002). Why Does He Do That? Putnam.
Triangulation
MediumInvolving third parties to create jealousy, insecurity, or validation pressure.
Bowen, M. (1978). Family Therapy in Clinical Practice. Jason Aronson.
Deflection
MediumRedirecting accountability by raising unrelated grievances or changing the subject.
Bancroft, L. (2002). Why Does He Do That? Putnam.
6.Positive Patterns
Seven positive communication patterns are evaluated and, when detected, contribute a modest upward adjustment to the health score. Their presence does not negate warning patterns but provides contextual information about the full communication dynamic.
Active Listening
Demonstrating genuine interest in understanding the other party.
Empathy
Expressing compassion for the other party's emotional state.
Accountability
Taking genuine responsibility for one's own actions.
Healthy Boundaries
Setting or respecting limits in a calm, direct way.
Emotional Support
Offering encouragement or support during difficulty.
Appreciation
Expressing genuine gratitude or positive recognition.
Conflict Resolution
Working constructively toward compromise or mutual understanding.
7.Confidence Score Calculation
Each detected pattern is assigned a confidence score between 0.0 and 1.0 based on the ratio of flagged messages to total messages in the conversation:
ratio = flaggedMessageCount / totalMessageCount
ratio ≥ 0.10 → confidence = 0.95 (very high)
ratio ≥ 0.05 → confidence = 0.85 (high)
ratio ≥ 0.02 → confidence = 0.75 (moderate)
ratio ≥ 0.01 → confidence = 0.65 (low-moderate)
ratio < 0.01 → confidence = 0.55 (low — pattern present but infrequent)
Confidence scores are reported per-pattern in the Flagged Message Activity section. A low confidence score does not mean the pattern is absent — it means the detected instances represent a small proportion of the total conversation volume. Attorneys should weigh infrequent high-severity patterns (e.g., a single explicit threat) appropriately regardless of confidence score.
8.Relationship Health Score
The Relationship Health Score is a composite metric ranging from 0 to 100. It begins at 100 and applies deductions for each detected warning pattern, with partial credit for detected positive patterns.
// Warning pattern deduction (per pattern):
weight = severity_weight[pattern.severity]
raw_deduction = (flaggedCount / totalMessages) × weight × 100
deduction = min(max_deduction[severity], raw_deduction)
// Severity weights and maximum deductions:
Critical: weight = 4.0, max deduction = 45 pts
High: weight = 2.5, max deduction = 30 pts
Medium: weight = 1.5, max deduction = 18 pts
Low: weight = 0.5, max deduction = 8 pts
// Positive pattern bonus (per pattern):
bonus = min(8, (positiveCount / totalMessages) × 50)
score = clamp(100 − Σdeductions + Σbonuses, 0, 100)
Score interpretation:
9.Personality and Risk Assessment Frameworks
Verity incorporates two established personality assessment frameworks and one structured violence risk protocol. These are applied as supplementary analyses to the primary pattern detection.
Alternative Model of Personality Disorders (AMPD) — DSM-5 Section III
The AMPD framework (American Psychiatric Association, 2013) assesses personality functioning across five trait domains: Negative Affect, Detachment, Antagonism, Disinhibition, and Psychoticism. Verity maps detected communication patterns to elevations in these domains using a behavioral indicator crosswalk. For example, persistent gaslighting and DARVO patterns contribute to Antagonism scores; explosive anger contributes to Disinhibition; isolation tactics contribute to Antagonism and Detachment.
Note: AMPD scores in Verity reports reflect behavioral pattern indicators, not clinical assessment. They should not be interpreted as a clinical diagnosis and require evaluation by a qualified mental health professional for clinical application.
Dark Triad — Machiavellianism, Narcissism, Psychopathy
The Dark Triad (Paulhus & Williams, 2002) describes three overlapping but distinct personality constructs associated with interpersonal harm: Machiavellianism (strategic manipulation), Narcissism (grandiosity, entitlement), and Psychopathy (callousness, impulsivity). Verity maps communication patterns to these constructs — coercive control and deflection patterns contribute to Machiavellianism; contempt and love bombing to Narcissism; threats and explosive anger to Psychopathy.
Attachment Style
Based on Bowlby-Ainsworth attachment theory (Ainsworth, 1978), Verity classifies the subject's communication style across four attachment patterns: Secure, Anxious, Avoidant, and Disorganized. Stonewalling and emotional unavailability patterns contribute to Avoidant classification; emotional manipulation and future faking contribute to Anxious/Disorganized.
10.SARA Risk Assessment
The Spousal Assault Risk Assessment (SARA; Kropp et al., 1994) is a structured professional judgment tool widely used by courts, law enforcement, and mental health professionals to assess risk of intimate partner violence. Verity incorporates a 10-item SARA checklist as an attorney-completed assessment — the attorney reviews the factors and checks those that apply based on their knowledge of the case, not solely from the conversation data.
SARA items included in Verity:
- Past assault of family members
- Past assault of strangers or acquaintances
- Past violation of conditional release or court orders
- Recent relationship problems
- Recent employment problems
- Victim of or witness to family violence as a child
- Recent substance abuse or dependence
- Recent suicidal or homicidal ideation or intent
- Recent psychotic or manic symptoms
- Personality disorder with anger, impulsivity, or instability
Risk Level Thresholds
0–2 factors: Low · 3–4: Moderate · 5–7: High · 8–10: Severe
11.Limitations and Caveats
Text-only analysis
Verity analyzes written text only. Tone of voice, physical behavior, non-verbal communication, and in-person incidents are outside the scope of this analysis.
Language limitations
Pattern detection is optimized for English. Non-English conversations may produce inaccurate results. Partial support exists for Spanish and French phrases, but accuracy is not validated.
Context dependency
Some patterns (e.g., "you're crazy") may reflect colloquial usage rather than gaslighting in specific relationship contexts. The attorney's knowledge of the case provides essential interpretive context that the engine cannot supply.
Export completeness
Analysis is limited to messages included in the export. Deleted messages, voice calls, media-only messages, and in-app disappearing messages are not captured.
Subject identification
In group chats or conversations with multiple participants, subject identification heuristics may misclassify the analyzing party. The attorney should verify the identified subject on the cover page.
No clinical diagnosis
Pattern detection results are behavioral observations drawn from conversation data. They do not constitute a clinical diagnosis and cannot be used as such without independent expert evaluation.
Recency of training
The pattern library reflects research literature available as of 2025. Evolving research may identify new communication patterns or refine existing classifications.
12.Federal Rule of Evidence 702 Considerations
Federal Rule of Evidence 702 (and analogous state rules) governs the admissibility of expert testimony based on scientific, technical, or specialized knowledge. Under Daubert v. Merrell Dow Pharmaceuticals (1993) and its progeny, courts evaluate whether methodology is: (1) testable and tested; (2) subject to peer review and publication; (3) known or potential error rate; and (4) generally accepted in the relevant scientific community.
Verity's position on each Daubert factor:
1. Testability
SupportedThe pattern detection engine is fully deterministic and reproducible. Given identical input, the engine produces identical output. The regex-based detection approach is auditable — specific triggering phrases are preserved in the report and available for cross-examination.
2. Peer Review
PartialThe underlying behavioral frameworks (Gottman's Four Horsemen, DARVO, coercive control, AMPD, SARA) have extensive peer-reviewed literature. The specific implementation of these frameworks in Verity's detection engine has not been independently peer-reviewed as of this version. Attorneys are advised to pair Verity reports with testimony from a qualified expert witness for maximum admissibility.
3. Error Rate
DisclosedFalse positives are possible, particularly for colloquial usage of flagged phrases. The confidence score system provides a probabilistic indicator. Attorneys should review flagged excerpts individually. The engine does not produce false negatives for patterns that exceed the detection threshold — any absence of detection reflects absence of matching phrases, not absence of behavior.
4. General Acceptance
Framework-levelThe foundational frameworks are generally accepted: Gottman's communication research is cited in thousands of peer-reviewed articles; SARA is used by courts in 40+ jurisdictions; AMPD is included in DSM-5 Section III; coercive control theory is incorporated in statute in the UK, Scotland, and multiple US states. The computational application of these frameworks to conversation data is an emerging field.
13.Bibliography
Ainsworth, M. D. S. (1978). Patterns of Attachment. Lawrence Erlbaum Associates.
American Psychiatric Association. (2013). Diagnostic and Statistical Manual of Mental Disorders (5th ed.). APA Publishing.
Bancroft, L. (2002). Why Does He Do That? Inside the Minds of Angry and Controlling Men. Putnam.
Bowlby, J. (1969). Attachment and Loss, Vol. 1: Attachment. Basic Books.
Daubert v. Merrell Dow Pharmaceuticals, Inc., 509 U.S. 579 (1993).
Federal Rule of Evidence 702. Testimony by Expert Witnesses. (2023 amendment).
Freyd, J. J. (1997). Violations of power, adaptive blindness, and betrayal trauma theory. Feminism & Psychology, 7(1), 22–32.
Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.
Gottman, J. M., & Silver, N. (1999). The Seven Principles for Making Marriage Work. Crown.
Johnson, M. P. (2008). A Typology of Domestic Violence. Northeastern University Press.
Kropp, P. R., Hart, S. D., Webster, C. D., & Eaves, D. (1994). Manual for the Spousal Assault Risk Assessment Guide. British Columbia Institute on Family Violence.
Kumho Tire Co. v. Carmichael, 526 U.S. 137 (1999).
Paulhus, D. L., & Williams, K. M. (2002). The dark triad of personality. Journal of Research in Personality, 36(6), 556–563.
Stark, E. (2007). Coercive Control: How Men Entrap Women in Personal Life. Oxford University Press.
Stern, R. (2007). The Gaslight Effect. Morgan Road Books.
Walker, L. E. (1979). The Battered Woman. Harper & Row.
Verity Forensic Conversation Analysis · getverity.report
Methodology v2.1 · June 2026 · Subject to revision as research evolves