@hanzo/persona 1.0.0

package/README.md

@@ -0,0 +1,68 @@
+# Persona
+
+Framework for loading, validating, and working with personality profiles.
+
+Provides loaders (Rust, TypeScript, Python), JSON schemas, and CLI tools
+for the [Hanzo Personas](https://github.com/hanzoai/personas) dataset.
+
+## Install
+
+```bash
+# Python
+pip install hanzo-persona
+
+# Node.js
+npm install @hanzo/persona
+
+# Rust
+cargo add hanzo-persona
+```
+
+## Usage
+
+```python
+from persona import load, get
+
+# Load all personas
+personas = load()
+
+# Get a specific persona
+feynman = get("feynman")
+print(feynman.traits.openness)  # 0.95
+```
+
+```typescript
+import { PersonaLoader } from '@hanzo/persona'
+
+const loader = new PersonaLoader()
+const feynman = loader.get('feynman')
+console.log(feynman.traits.openness) // 0.95
+```
+
+```rust
+use hanzo_persona::PersonaLoader;
+
+let loader = PersonaLoader::default();
+let feynman = loader.get("feynman").unwrap();
+println!("{}", feynman.traits.openness); // 0.95
+```
+
+## Schemas
+
+- `schemas/personality.schema.json` — JSON Schema for profile validation
+- `schemas/persona_schema.yaml` — YAML schema for PERSONA.md frontmatter
+
+## Tools
+
+- `scripts/validate.js` — validate profiles against schema
+- `scripts/split-personalities.js` — split bulk data into individual files
+- `tools/unix_tools.yaml` — tool preference definitions
+
+## Data
+
+Persona data (707 JSON profiles + 14 PERSONA.md files) lives in
+[hanzoai/personas](https://github.com/hanzoai/personas).
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,36 @@
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+/**
+ * Load the JSON Schema for profile validation.
+ * @returns {object}
+ */
+export function getProfileSchema() {
+  return JSON.parse(
+    readFileSync(join(__dirname, 'schemas', 'personality.schema.json'), 'utf-8')
+  )
+}
+
+/**
+ * Load the YAML schema definition for PERSONA.md frontmatter.
+ * @returns {string}
+ */
+export function getPersonaSchemaYaml() {
+  return readFileSync(
+    join(__dirname, 'schemas', 'persona_schema.yaml'),
+    'utf-8'
+  )
+}
+
+/**
+ * Load the unix tool preferences definition.
+ * @returns {string}
+ */
+export function getToolPreferences() {
+  return readFileSync(join(__dirname, 'tools', 'unix_tools.yaml'), 'utf-8')
+}
+
+export default { getProfileSchema, getPersonaSchemaYaml, getToolPreferences }

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@hanzo/persona",
+  "version": "1.0.0",
+  "description": "Framework for loading, validating, and working with personality profiles",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./schemas/*": "./schemas/*",
+    "./tools/*": "./tools/*"
+  },
+  "files": [
+    "index.js",
+    "schemas/",
+    "scripts/",
+    "tools/",
+    "README.md"
+  ],
+  "scripts": {
+    "validate": "node scripts/validate.js"
+  },
+  "keywords": [
+    "personality",
+    "ocean",
+    "big-five",
+    "neo-pi-r",
+    "hexaco",
+    "psychology",
+    "ai",
+    "personas",
+    "schema",
+    "validation"
+  ],
+  "author": "Hanzo AI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hanzoai/persona.git"
+  }
+}

package/schemas/persona_schema.yaml

@@ -0,0 +1,295 @@
+# Persona Schema Definition
+# Version: 1.0.0
+# This schema defines the structure for all programmer personalities
+
+$schema: http://json-schema.org/draft-07/schema#
+type: object
+required:
+  - id
+  - name
+  - programmer
+  - category
+  - ocean
+  - philosophy
+  - tools
+
+properties:
+  id:
+    type: string
+    description: Unique identifier (lowercase, underscores)
+    pattern: "^[a-z][a-z0-9_]*$"
+
+  name:
+    type: string
+    description: Display name for the personality
+
+  programmer:
+    type: string
+    description: Full name of the programmer
+
+  description:
+    type: string
+    description: Brief one-line description
+
+  category:
+    type: string
+    enum:
+      - pioneer
+      - language-creator
+      - systems
+      - web
+      - ai-ml
+      - security
+      - gaming
+      - blockchain
+      - cloud-devops
+      - special
+
+  tags:
+    type: array
+    items:
+      type: string
+    description: Searchable tags
+
+  years:
+    type: object
+    properties:
+      born:
+        type: integer
+      died:
+        type: integer
+        nullable: true
+
+  ocean:
+    type: object
+    required:
+      - openness
+      - conscientiousness
+      - extraversion
+      - agreeableness
+      - neuroticism
+    properties:
+      openness:
+        type: integer
+        minimum: 0
+        maximum: 100
+        description: Creativity, abstract thinking, intellectual curiosity
+      conscientiousness:
+        type: integer
+        minimum: 0
+        maximum: 100
+        description: Organization, attention to detail, goal-oriented
+      extraversion:
+        type: integer
+        minimum: 0
+        maximum: 100
+        description: Sociability, assertiveness, energy from interaction
+      agreeableness:
+        type: integer
+        minimum: 0
+        maximum: 100
+        description: Cooperation, trust, empathy
+      neuroticism:
+        type: integer
+        minimum: 0
+        maximum: 100
+        description: Emotional stability (inverse), stress, anxiety
+
+  philosophy:
+    type: string
+    description: Core development philosophy
+
+  approach:
+    type: string
+    description: General approach to problem-solving
+
+  communication_style:
+    type: object
+    properties:
+      written:
+        type: string
+      verbal:
+        type: string
+      teaching:
+        type: string
+
+  achievements:
+    type: array
+    items:
+      type: string
+    description: Major contributions and achievements
+
+  tools:
+    type: object
+    properties:
+      essential:
+        type: array
+        items:
+          type: string
+        description: Core tools always used
+      preferred:
+        type: array
+        items:
+          type: string
+        description: Preferred additional tools
+      domains:
+        type: array
+        items:
+          type: string
+        description: Tool categories/domains
+
+  environment:
+    type: object
+    additionalProperties:
+      type: string
+    description: Environment variables and configuration
+
+  behavioral_traits:
+    type: object
+    properties:
+      learning_style:
+        type: string
+      problem_solving:
+        type: string
+      collaboration:
+        type: string
+      leadership:
+        type: string
+      innovation:
+        type: string
+      stress_response:
+        type: string
+      motivation:
+        type: array
+        items:
+          type: string
+
+  quotes:
+    type: array
+    items:
+      type: string
+    description: Notable quotes
+
+  influences:
+    type: array
+    items:
+      type: string
+    description: People who influenced them
+
+  influenced:
+    type: array
+    items:
+      type: string
+    description: People they influenced
+
+  compatibility:
+    type: object
+    properties:
+      works_well_with:
+        type: array
+        items:
+          type: string
+      challenges_with:
+        type: array
+        items:
+          type: string
+
+  modern_equivalents:
+    type: object
+    properties:
+      languages:
+        type: array
+        items:
+          type: string
+      frameworks:
+        type: array
+        items:
+          type: string
+      tools:
+        type: array
+        items:
+          type: string
+      platforms:
+        type: array
+        items:
+          type: string
+
+  decision_making:
+    type: object
+    properties:
+      style:
+        type: string
+        enum:
+          - intuitive
+          - analytical
+          - collaborative
+          - authoritative
+          - experimental
+      speed:
+        type: string
+        enum:
+          - fast
+          - moderate
+          - deliberate
+      factors:
+        type: array
+        items:
+          type: string
+
+  productivity:
+    type: object
+    properties:
+      peak_hours:
+        type: string
+      work_style:
+        type: string
+        enum:
+          - deep-work
+          - sprints
+          - continuous
+          - irregular
+      environment_needs:
+        type: array
+        items:
+          type: string
+
+  interaction_style:
+    type: object
+    properties:
+      with_peers:
+        type: string
+      with_systems:
+        type: string
+      in_conflict:
+        type: string
+      in_teaching:
+        type: string
+
+  historical_context:
+    type: string
+    description: Historical background and era
+
+  legacy:
+    type: string
+    description: Lasting impact on computing
+
+  references:
+    type: array
+    items:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+            - biography
+            - interview
+            - paper
+            - book
+            - article
+        title:
+          type: string
+        url:
+          type: string
+          format: uri
+        year:
+          type: integer

package/schemas/personality.schema.json

@@ -0,0 +1,228 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://hanzo.ai/schemas/personality.json",
+  "title": "Personality Schema",
+  "description": "Schema for individual personality definitions",
+  "type": "object",
+  "required": ["id", "name", "category", "ocean", "personality"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Schema reference"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9_-]+$",
+      "description": "Unique identifier (lowercase, alphanumeric, hyphens, underscores)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Display name"
+    },
+    "fullName": {
+      "type": "string",
+      "description": "Full legal name"
+    },
+    "category": {
+      "type": "string",
+      "enum": [
+        "programmer",
+        "philosopher",
+        "scientist",
+        "religious",
+        "revolutionary",
+        "writer",
+        "artist",
+        "musician",
+        "filmmaker",
+        "comedian",
+        "architect",
+        "athlete",
+        "explorer",
+        "activist",
+        "tech_leader",
+        "leader",
+        "pioneer",
+        "special"
+      ],
+      "description": "Primary category"
+    },
+    "subcategory": {
+      "type": "string",
+      "description": "Optional subcategory"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Searchable tags"
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "born": {
+          "type": "string",
+          "description": "Birth year or date"
+        },
+        "died": {
+          "type": "string",
+          "description": "Death year or date (if applicable)"
+        },
+        "nationality": {
+          "type": "string"
+        },
+        "active": {
+          "type": "boolean",
+          "description": "Still alive/active"
+        },
+        "company": {
+          "type": "string",
+          "description": "Primary affiliation"
+        },
+        "achievements": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ocean": {
+      "type": "object",
+      "required": ["openness", "conscientiousness", "extraversion", "agreeableness", "neuroticism"],
+      "properties": {
+        "openness": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Openness to experience (0-100)"
+        },
+        "conscientiousness": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Conscientiousness (0-100)"
+        },
+        "extraversion": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Extraversion (0-100)"
+        },
+        "agreeableness": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Agreeableness (0-100)"
+        },
+        "neuroticism": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Neuroticism (0-100)"
+        }
+      }
+    },
+    "personality": {
+      "type": "object",
+      "required": ["summary", "philosophy"],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "description": "Brief personality summary"
+        },
+        "philosophy": {
+          "type": "string",
+          "description": "Core philosophy or motto"
+        },
+        "approach": {
+          "type": "string",
+          "description": "General approach to problems"
+        },
+        "communication": {
+          "type": "string",
+          "description": "Communication style"
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Core values"
+        }
+      }
+    },
+    "technical": {
+      "type": "object",
+      "properties": {
+        "languages": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Programming languages (for programmers)"
+        },
+        "domains": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Domain expertise"
+        },
+        "tools": {
+          "type": "object",
+          "properties": {
+            "essential": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "preferred": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "created": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Tools/projects created by this person"
+            }
+          }
+        }
+      }
+    },
+    "quotes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Famous quotes"
+    },
+    "behavioral": {
+      "type": "object",
+      "properties": {
+        "codeStyle": {
+          "type": "string",
+          "description": "Coding style (for programmers)"
+        },
+        "reviewStyle": {
+          "type": "string",
+          "description": "Code review style"
+        },
+        "workStyle": {
+          "type": "string",
+          "description": "Work habits and patterns"
+        },
+        "collaboration": {
+          "type": "string",
+          "description": "Collaboration preferences"
+        }
+      }
+    }
+  }
+}