Sofia/DB-cleanup
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Activity

docs(definitions): install the paper's Appendix B glossary as the canonical definitions

Browse Source 
merge-output/DEFINITIONS.md holds the research paper's (v5 FINAL, February 2026)
Appendix B verbatim: eleven scenario definitions and six violence categories,
plus a mapping from DB labels to glossary names and the owner's clarifications
on the Detention flag from 2026-09-06/07. The README's own paraphrase is
replaced by a pointer so there is one source of truth.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GZZENdTLzNGsbNy4DyF1yt
This commit is contained in:
StellarCrow
2026-09-07 06:04:36 +02:00
co-authored by Claude Fable 5.1
parent de707f8751
commit e36ceae8d6
2 changed files with 95 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README-START-HERE.md
+9 -34
View File
@@ -68,42 +68,17 @@ tests - just Python scripts that regenerate the .txt files, plus Markdown notes.
Put that inside main() if another script imports the file.
--------------------------------------------------------------------------------
## Definitions: detention (violence type) vs Kidnapping (scenario)
## Definitions
Added 2026-09-06 after the flag turned out to be mislabelled. The rule for every file,
summary and correction from now on:
The canonical definitions of the eleven scenarios and six violence categories are the research
paper's Appendix B glossary, copied verbatim into merge-output/DEFINITIONS.md together with the
owner's clarifications on the Detention flag. Read that file; do not paraphrase it elsewhere.
**Detention** is a VIOLENCE TYPE. The DB flag `kidnappings` (sheet column "Kidnappings") is
the detention flag and should be renamed `detention` on the DB side. It is 1 when the
attackers had physical control of the victim at any point, in any place, for any length of
time: tied, taped, handcuffed or zip-tied; locked in a room or vehicle; held at gunpoint
while forced to unlock or transfer; taken away in a car; held under a fake arrest; kept for
hours or days. It is 0 when control was never gained: a snatch or mugging in passing, a
break-in of empty premises, threats or extortion at a distance, a plot foiled before contact,
an attempt the victim fled or fought off before being restrained. Judgment line (owner's rule, 2026-09-06/07): if attackers force entry into the victim's space, a home,
an office, a hotel room, a car, and there beat the victim or hold them until they hand over what
is wanted, that is detention, however short; the victim would have left if they could. Control
that was never gained is not: a plot foiled before contact, an attempt the victim fought off at
the door or in the street, a snatch in passing, a break-in of empty premises. Who was held does
not change the flag: detention used on guards, staff, a concierge or a relative to force submission
or execute the theft counts as 1 even when the record's named victim was absent.
**Kidnapping** is a SCENARIO, one of eleven attack patterns. It means the victim was taken
from where they were to a place under the attackers' control and held there, usually for a
ransom or a forced transfer. Express Kidnapping is the short, ATM-style variant. A Kidnapping
scenario always involves detention, and usually other violence types too: weapon threats,
assault, torture, drugging. Detention also occurs in other scenarios without making them
kidnappings: a family tied up in a Home Invasion, a P2P buyer handcuffed in a hotel room, a
fake arrest under Authority Misuse, a victim zip-tied in a Dodged Attack that was interrupted.
**Wording in summaries.** "Violence Used" names the violence types, and names detention
explicitly whenever it occurred ("Detention — held at gunpoint for about an hour"). The
words kidnapped / abducted are reserved for a victim being taken away; a victim held where
they were is "held", "detained", "tied up", not "kidnapped". Foiled attempts say
"No detention — the attempt was foiled" only when the source says so.
Per-case flag review against this rule: merge-output/detention-flag-review.md (proposals for
Sofia, with the evidence line for each). The DB export stays untouched.
The one point that keeps biting: the DB field `kidnappings` is the DETENTION violence category
(victim, guard, staff or relative held against their will, restrained, or prevented from leaving,
for any length of time), not the Kidnapping scenario (victim taken away to a controlled location).
Forced entry followed by beating or holding the victim in place is detention, however short.
Per-case flag review with evidence: merge-output/detention-flag-review.md.
--------------------------------------------------------------------------------
## The deliverable, and what still needs the human