{"_id":"@affectively/behavioral-taxonomy","_rev":"4-a19b2e5a3dd717da44cfeaccb085ac5c","name":"@affectively/behavioral-taxonomy","dist-tags":{"latest":"5.0.0"},"versions":{"1.0.0":{"name":"@affectively/behavioral-taxonomy","version":"1.0.0","keywords":["behavioral-science","emotions","psychology","affective-computing","cognitive-biases","personality-traits","mental-health","emotion-ai","nlp","taxonomy"],"author":{"name":"AFFECTIVELY","email":"opensource@affectively.app"},"license":"CC-BY-4.0","_id":"@affectively/behavioral-taxonomy@1.0.0","maintainers":[{"name":"buley","email":"buley@outlook.com"}],"homepage":"https://github.com/affectively-ai/behavioral-taxonomy#readme","bugs":{"url":"https://github.com/affectively-ai/behavioral-taxonomy/issues"},"dist":{"shasum":"4982679c3b404ce19f1f891691198a42cff5ad4d","tarball":"https://registry.npmjs.org/@affectively/behavioral-taxonomy/-/behavioral-taxonomy-1.0.0.tgz","fileCount":11,"integrity":"sha512-+zePGqNAzjBVXsJAPSMjK4zhC/aTeIsOYo48PSSmAJ1LQS6gB0WPkR3bDmwmQvZD1GOcjgVQKuDyTQv71b7pgA==","signatures":[{"sig":"MEUCIQDYqB/0ARgtziJriEAFsFVKlblaZPWxPrKKJI86awNT5wIgPWvGKMHRSbpCU67i5jOKgwX0WOKhrTun6jIVA/ryQYE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9765222},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./data/biases":{"import":"./data/biases.json","require":"./data/biases.json"},"./data/traits":{"import":"./data/traits.json","require":"./data/traits.json"},"./data/emotions":{"import":"./data/emotions.json","require":"./data/emotions.json"},"./data/behavioral-loops":{"import":"./data/behavioralLoops.json","require":"./data/behavioralLoops.json"}},"gitHead":"eda78c5f445d8e7cdac6aec8bdfe999e1509eec9","scripts":{"lint":"eslint src/","test":"bun test","build":"tsup src/index.ts --format cjs,esm --dts","prepublishOnly":"npm run build"},"_npmUser":{"name":"buley","email":"buley@outlook.com"},"repository":{"url":"git+https://github.com/affectively-ai/behavioral-taxonomy.git","type":"git"},"_npmVersion":"11.6.2","description":"A structured taxonomy of 1,140+ human behavioral loops, emotions, cognitive biases, and personality traits for affective computing applications.","directories":{},"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.9.0"},"_npmOperationalInternal":{"tmp":"tmp/behavioral-taxonomy_1.0.0_1768339356314_0.1741501571200792","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is deprecated and no longer supported. Do not use."},"1.0.1":{"name":"@affectively/behavioral-taxonomy","version":"1.0.1","keywords":["behavioral-science","emotions","psychology","affective-computing","cognitive-biases","personality-traits","mental-health","emotion-ai","nlp","taxonomy"],"author":{"name":"AFFECTIVELY","email":"opensource@affectively.ai"},"license":"CC-BY-4.0","_id":"@affectively/behavioral-taxonomy@1.0.1","maintainers":[{"name":"buley","email":"buley@outlook.com"}],"homepage":"https://github.com/affectively-ai/behavioral-taxonomy#readme","bugs":{"url":"https://github.com/affectively-ai/behavioral-taxonomy/issues"},"dist":{"shasum":"94aac2bab54ff843511aae578323d3774704e057","tarball":"https://registry.npmjs.org/@affectively/behavioral-taxonomy/-/behavioral-taxonomy-1.0.1.tgz","fileCount":11,"integrity":"sha512-1SKc385nE4DWRFIwI32Jy9W6ZRboII49teSezaAguqFdLTBx3pZw3a88eZF32uOLBAQLbMT2tZ6Xo4dCIss4RA==","signatures":[{"sig":"MEQCIFiw/GYpT4C2DBQMCF31TUb472zRKPAvlLHuHxsYw8gBAiBMzJwbCgWWqD95mp6lJw1bZcbcF/X/S+4dC1TZUepvwA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9765040},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./data/biases":{"import":"./data/biases.json","require":"./data/biases.json"},"./data/traits":{"import":"./data/traits.json","require":"./data/traits.json"},"./data/emotions":{"import":"./data/emotions.json","require":"./data/emotions.json"},"./data/behavioral-loops":{"import":"./data/behavioralLoops.json","require":"./data/behavioralLoops.json"}},"gitHead":"c86c38e503b2d9dd727361879f3a9df881ab1008","scripts":{"lint":"eslint src/","test":"bun test","build":"tsup src/index.ts --format cjs,esm --dts","prepublishOnly":"npm run build"},"_npmUser":{"name":"buley","email":"buley@outlook.com"},"repository":{"url":"git+https://github.com/affectively-ai/behavioral-taxonomy.git","type":"git"},"_npmVersion":"11.6.2","description":"A structured taxonomy of 1,140+ human behavioral loops, emotions, cognitive biases, and personality traits for affective computing applications.","directories":{},"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.9.0"},"_npmOperationalInternal":{"tmp":"tmp/behavioral-taxonomy_1.0.1_1768341099319_0.14276787655546008","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is deprecated and no longer supported. Do not use."},"5.0.0":{"name":"@affectively/behavioral-taxonomy","version":"5.0.0","keywords":["behavioral-science","emotions","psychology","affective-computing","cognitive-biases","personality-traits","mental-health","emotion-ai","nlp","taxonomy"],"author":{"name":"AFFECTIVELY","email":"opensource@affectively.ai"},"license":"CC-BY-4.0","_id":"@affectively/behavioral-taxonomy@5.0.0","maintainers":[{"name":"buley","email":"buley@outlook.com"}],"homepage":"https://github.com/affectively-ai/behavioral-taxonomy#readme","bugs":{"url":"https://github.com/affectively-ai/behavioral-taxonomy/issues"},"dist":{"shasum":"8a0412dd906debe632cbc5b1ce38b5c4ce7a89c3","tarball":"https://registry.npmjs.org/@affectively/behavioral-taxonomy/-/behavioral-taxonomy-5.0.0.tgz","fileCount":11,"integrity":"sha512-Uq0nzgsIi8OIeqV+HjICFUwKg/UUMVNRXAWSMTgXRS+6I5MXwaaBQfpYSFRzDEs7435PHzmH07qyag9uVoMSxg==","signatures":[{"sig":"MEQCIFVX76fXK21rjzfyQvfMPXYh+Qf3ZHcLqkzNK7ijNptrAiA7GjdQfray18jk/1K4tg28/TDuvDVU7WSWpRtiVfHLgA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9767830},"main":"dist/index.js","types":"dist/index.d.ts","module":"dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./data/biases":{"import":"./data/biases.json","require":"./data/biases.json"},"./data/traits":{"import":"./data/traits.json","require":"./data/traits.json"},"./data/emotions":{"import":"./data/emotions.json","require":"./data/emotions.json"},"./data/behavioral-loops":{"import":"./data/behavioralLoops.json","require":"./data/behavioralLoops.json"}},"scripts":{"lint":"eslint src/","test":"bun test","build":"tsup src/index.ts --format cjs,esm --dts","prepublishOnly":"npm run build"},"_npmUser":{"name":"buley","email":"buley@outlook.com"},"repository":{"url":"git+https://github.com/affectively-ai/behavioral-taxonomy.git","type":"git"},"_npmVersion":"11.8.0","description":"A structured taxonomy of 1,140+ human behavioral loops, emotions, cognitive biases, and personality traits for affective computing applications.","directories":{},"_nodeVersion":"25.5.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.9.0"},"_npmOperationalInternal":{"tmp":"tmp/behavioral-taxonomy_5.0.0_1773156207206_0.01614720403941705","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is deprecated and no longer supported. Do not use."}},"time":{"created":"2026-01-13T21:22:36.246Z","modified":"2026-03-27T20:03:13.333Z","1.0.0":"2026-01-13T21:22:36.569Z","1.0.1":"2026-01-13T21:51:39.532Z","5.0.0":"2026-03-10T15:23:27.428Z"},"bugs":{"url":"https://github.com/affectively-ai/behavioral-taxonomy/issues"},"author":{"name":"AFFECTIVELY","email":"opensource@affectively.ai"},"license":"CC-BY-4.0","homepage":"https://github.com/affectively-ai/behavioral-taxonomy#readme","keywords":["behavioral-science","emotions","psychology","affective-computing","cognitive-biases","personality-traits","mental-health","emotion-ai","nlp","taxonomy"],"repository":{"url":"git+https://github.com/affectively-ai/behavioral-taxonomy.git","type":"git"},"description":"A structured taxonomy of 1,140+ human behavioral loops, emotions, cognitive biases, and personality traits for affective computing applications.","maintainers":[{"name":"buley","email":"buley@outlook.com"}],"readme":"# @affectively/behavioral-taxonomy\r\n\r\nA comprehensive, structured taxonomy of **1,140+ human behavioral loops**, emotions, cognitive biases, and personality traits for affective computing applications.\r\n\r\n[![npm version](https://img.shields.io/npm/v/@affectively/behavioral-taxonomy.svg)](https://www.npmjs.com/package/@affectively/behavioral-taxonomy)\r\n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\r\n\r\n## Overview\r\n\r\nThis package provides the foundational behavioral science data structures used by the [AFFECTIVELY](https://affectively.ai) platform. It categorizes human behavior into structured, machine-readable formats suitable for:\r\n\r\n- Emotion AI / Affective Computing\r\n- Natural Language Processing\r\n- Behavioral Analysis\r\n- Mental Health Applications\r\n- Human-Computer Interaction Research\r\n- Game Design & Narrative Systems\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @affectively/behavioral-taxonomy\r\n# or\r\nyarn add @affectively/behavioral-taxonomy\r\n# or\r\nbun add @affectively/behavioral-taxonomy\r\n```\r\n\r\n## Quick Start\r\n\r\n```typescript\r\nimport { \r\n getBehavioralLoops, \r\n getEmotions, \r\n getBiases, \r\n getTraits \r\n} from '@affectively/behavioral-taxonomy';\r\n\r\n// Get all behavioral loops\r\nconst loops = getBehavioralLoops();\r\nconsole.log(`Loaded ${loops.metadata.totalLoops} behavioral loops`);\r\n\r\n// Find loops by category\r\nconst digitalLoops = loops.categories.find(c => c.id === 'digital-cognitive');\r\n\r\n// Get emotion taxonomy\r\nconst emotions = getEmotions();\r\n\r\n// Get cognitive biases\r\nconst biases = getBiases();\r\n```\r\n\r\n## Data Structures\r\n\r\n### Behavioral Loops\r\n\r\nEach loop follows a structured format:\r\n\r\n```typescript\r\ninterface BehavioralLoop {\r\n id: number;\r\n name: string;\r\n logic: {\r\n given: string; // Initial condition\r\n when: string; // Trigger event\r\n then: string; // Resulting behavior\r\n result: string; // Long-term outcome\r\n };\r\n taxonomy: {\r\n origin: 'GENETIC' | 'BEHAVIORAL' | 'NARRATIVE' | 'DIGITAL' | 'ENVIRONMENTAL';\r\n modality: 'VISUAL_STATIC' | 'VISUAL_DYNAMIC' | 'AUDITORY' | 'HAPTIC' | 'OLFACTORY' | 'META' | 'PROXEMIC';\r\n mutability: 'IMMUTABLE' | 'STUBBORN' | 'FLUID' | 'VOLATILE';\r\n valences: ('ATTRACTION' | 'REPULSION' | 'DOMINANCE' | 'SUBMISSION' | 'TRUST' | 'DECEPTION' | 'DISRUPTION')[];\r\n };\r\n operator: {\r\n name: string; // Named psychological mechanism\r\n mechanism: string; // Description of how it works\r\n };\r\n veracity: {\r\n objectiveGrounding: number; // 0-1: Evidence basis\r\n socialConsensus: number; // 0-1: Social agreement\r\n recursiveAmplification: number; // 0-1: Self-reinforcing strength\r\n frictionIndex: number; // 0-1: Resistance to change\r\n };\r\n intervention: {\r\n difficulty: number; // 1-10: How hard to change\r\n interdict: string; // How to block the loop\r\n minimize: string; // How to reduce intensity\r\n recognize: string; // How to detect it\r\n leverage?: string; // How to use positively\r\n };\r\n meta: {\r\n tags: string[];\r\n relatedArchetypes?: string[];\r\n academicFields?: string[];\r\n };\r\n}\r\n```\r\n\r\n### Categories\r\n\r\nLoops are organized into 279 categories including:\r\n\r\n- Digital & Cognitive Loops\r\n- Dental & Oral Signals\r\n- Dermatological & Tactile Signals\r\n- Aging & Temporal Biomarkers\r\n- Ocular & Gaze Signals\r\n- Olfactory & Chemical Signals\r\n- Micro-movement & Gait\r\n- And many more...\r\n\r\n## Direct JSON Access\r\n\r\nFor maximum flexibility, you can import the raw JSON data:\r\n\r\n```typescript\r\n// ESM\r\nimport behavioralLoops from '@affectively/behavioral-taxonomy/data/behavioral-loops';\r\nimport emotions from '@affectively/behavioral-taxonomy/data/emotions';\r\nimport biases from '@affectively/behavioral-taxonomy/data/biases';\r\nimport traits from '@affectively/behavioral-taxonomy/data/traits';\r\n\r\n// CommonJS\r\nconst behavioralLoops = require('@affectively/behavioral-taxonomy/data/behavioral-loops');\r\n```\r\n\r\n## Academic Citation\r\n\r\nIf you use this dataset in academic work, please cite:\r\n\r\n```bibtex\r\n@dataset{affectively_behavioral_taxonomy_2026,\r\n author = {AFFECTIVELY},\r\n title = {Human Behavioral Loop Taxonomy},\r\n year = {2026},\r\n publisher = {npm},\r\n version = {1.0.0},\r\n url = {https://github.com/affectively-ai/behavioral-taxonomy}\r\n}\r\n```\r\n\r\n## License\r\n\r\nThis dataset is licensed under [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/).\r\n\r\nYou are free to:\r\n- **Share** — copy and redistribute the material in any medium or format\r\n- **Adapt** — remix, transform, and build upon the material for any purpose, even commercially\r\n\r\nUnder the following terms:\r\n- **Attribution** — You must give appropriate credit to AFFECTIVELY, provide a link to the license, and indicate if changes were made.\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.\r\n\r\n## Related Packages\r\n\r\n- [`@affectively/utils`](https://www.npmjs.com/package/@affectively/utils) - Utility functions\r\n- [`@affectively/mcp-server-framework`](https://www.npmjs.com/package/@affectively/mcp-server-framework) - MCP server scaffolding\r\n\r\n## Support\r\n\r\n- [GitHub Issues](https://github.com/affectively-ai/behavioral-taxonomy/issues)\r\n- [Documentation](https://affectively.ai/docs)\r\n- [Discord Community](https://discord.gg/affectively)\r\n\r\n---\r\n\r\nMade with ️ by [AFFECTIVELY](https://affectively.ai)\r\n","readmeFilename":"README.md"}