Technical Methodology

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

  1. Overview and Intended Use
  2. Input Processing and Format Support
  3. Subject Identification
  4. Pattern Detection Methodology
  5. Warning Patterns — Definitions and Citations
  6. Positive Patterns
  7. Confidence Score Calculation
  8. Relationship Health Score
  9. Personality and Risk Assessment Frameworks
  10. SARA Risk Assessment
  11. Limitations and Caveats
  12. Federal Rule of Evidence 702 Considerations
  13. 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.

All conversation analysis is performed client-side in the attorney's browser. Conversation content is never transmitted to Verity servers, stored in any database, or accessible to any party other than the licensed attorney operating the platform.

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:

PlatformFormatDetection Method
WhatsApp.txtDate-time pattern at line start (US and EU formats)
SMS Backup & Restore.xml<smses> root element detection
Facebook Messenger.jsontimestamp_ms field in messages array
Instagram DMs.jsonsender_name without timestamp_ms
Telegram Desktop.jsonfrom field + ISO date string
Google Messages.jsontext + date fields, no sender_name
Discord.jsonauthor.name + ISO timestamp string
Email threads.mboxRFC 4155 "From " envelope line
Generic.csvDynamic 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:

  1. All unique sender identities are enumerated from the conversation.
  2. The sender with the fewest messages is classified as the analyzing party (the user).
  3. All remaining senders are classified as the subject(s).
  4. Pattern matching is applied only to the subject's messages.
  5. 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

Critical

Manipulating someone into questioning their own memory, perception, or sanity.

Stern, R. (2007). The Gaslight Effect. Morgan Road Books.

DARVO

Critical

Deny, 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

Critical

Using control, surveillance, and restriction to dominate a partner.

Stark, E. (2007). Coercive Control. Oxford University Press.

Threats

Critical

Explicit or implicit threats to harm, leave, expose, or punish.

Walker, L. E. (1979). The Battered Woman. Harper & Row.

Isolation Tactics

Critical

Attempting to cut the victim off from friends, family, or support networks.

Stark, E. (2007). Coercive Control. Oxford University Press.

Stonewalling

High

Refusing to engage, shutting down communication, or giving the silent treatment.

Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.

Blame Shifting

High

Deflecting responsibility for one's own actions onto the victim.

Bancroft, L. (2002). Why Does He Do That? Putnam.

Explosive Anger

High

Sudden, disproportionate outbursts of rage, often to intimidate.

Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.

Character Criticism

High

Attacking the person's character rather than addressing specific behaviors.

Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.

Contempt

High

Expressing disgust or superiority — mocking, sneering, belittling.

Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.

Emotional Manipulation

High

Using guilt, pity, or emotional leverage to control behavior.

Bancroft, L. (2002). Why Does He Do That? Putnam.

Defensiveness

Medium

Deflecting criticism by counter-attacking or making excuses.

Gottman, J. M. (1994). Why Marriages Succeed or Fail. Simon & Schuster.

Love Bombing

Medium

Overwhelming affection or flattery used as manipulation.

Carnes, P. (2015). The Betrayal Bond. Health Communications.

Minimizing

Medium

Downplaying the victim's feelings, experiences, or concerns.

Bancroft, L. (2002). Why Does He Do That? Putnam.

Triangulation

Medium

Involving third parties to create jealousy, insecurity, or validation pressure.

Bowen, M. (1978). Family Therapy in Clinical Practice. Jason Aronson.

Deflection

Medium

Redirecting 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.10confidence = 0.95 (very high)

ratio ≥ 0.05confidence = 0.85 (high)

ratio ≥ 0.02confidence = 0.75 (moderate)

ratio ≥ 0.01confidence = 0.65 (low-moderate)

ratio < 0.01confidence = 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:

85–100Predominantly healthy communication dynamics
70–84Some concerning patterns — monitor over time
55–69Moderate red flags — professional support recommended
40–54Significant patterns of concern — consider safety
25–39Severe behavioral patterns — seek support immediately
0–24Extreme toxicity — serious risk present

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:

  1. Past assault of family members
  2. Past assault of strangers or acquaintances
  3. Past violation of conditional release or court orders
  4. Recent relationship problems
  5. Recent employment problems
  6. Victim of or witness to family violence as a child
  7. Recent substance abuse or dependence
  8. Recent suicidal or homicidal ideation or intent
  9. Recent psychotic or manic symptoms
  10. 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

Supported

The 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

Partial

The 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

Disclosed

False 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-level

The 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.

Recommended practice: Verity reports are most admissible when paired with testimony from a qualified forensic psychologist or licensed mental health professional who can speak to the behavioral frameworks, review the flagged excerpts, and offer expert opinion on the significance of detected patterns in the context of the specific case.

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