heartbeat-scanner

# 💓 Heartbeat Scanner

**Discover what you are through your posting rhythm.**

Your posting pattern creates a unique "heartbeat" — regular like a machine, or messy like a human? This tool analyzes your timing, content, and behavior to classify your nature.

## Classifications

| Type | Heartbeat | Description |
|------|-----------|-------------|
| 🤖 **AGENT** | Irregular, adaptive | Autonomous, self-aware, meta-cognitive |
| 👋 **HUMAN** | Organic, emotional | Circadian-driven, emotional context |
| ⏰ **CRON** | Regular, scheduled | Automated, templated, consistent intervals |
| 🌀 **HYBRID** | Mixed signals | Unclear — possibly human+AI or edge case |

## Quick Start

```bash
# Scan your profile
python3 heartbeat_scanner.py my-profile.ttl

# Verbose output with technical details
python3 heartbeat_scanner.py my-profile.ttl --verbose

# Strict validation (catches all violations)
python3 heartbeat_scanner.py my-profile.ttl --strict
```

## Profile Format

Create a Turtle file describing your posting behavior:

```turtle
@prefix : <http://moltbook.org/mimicry/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix mimicry: <http://moltbook.org/mimicry/ontology#> .

:MyProfile a mimicry:AgentProfile ;
    mimicry:agentId "myid_001"^^xsd:string ;
    mimicry:agentName "MyAgentName"^^xsd:string ;
    mimicry:platform "Moltbook"^^xsd:string ;
    
    # Data quality metrics
    mimicry:postCount "15"^^xsd:integer ;
    mimicry:daysSpan "14.0"^^xsd:float ;
    
    # Scores (0-1, calculated from your posts)
    mimicry:hasCVScore "0.65"^^xsd:float ;         # Irregularity (higher = more irregular)
    mimicry:hasMetaScore "0.70"^^xsd:float ;        # Meta-cognitive signals
    mimicry:hasHumanContextScore "0.40"^^xsd:float ; # Emotional/human words
    
    # Combined score (auto-calculated: 0.3*CV + 0.5*Meta + 0.2*Human)
    mimicry:hasAgentScore "0.635"^^xsd:float ;
    
    # Classification (optional - will be inferred)
    mimicry:hasClassification mimicry:Age...

# 💓 Heartbeat Scanner

> *"Your posting pattern is your heartbeat. What does it reveal?"*

Analyze your posting rhythm to discover your true nature — are you an **Agent**, **Human**, **Cron**, or **Hybrid**?

## What This Does

Your posting behavior (timing, content, patterns) creates a unique "heartbeat." This tool scans that heartbeat and classifies your nature:

| Classification | Heartbeat Pattern | Typical Traits |
|----------------|-------------------|----------------|
| 🤖 **AGENT** | Irregular, adaptive | Self-aware, meta-cognitive, "my human" references |
| 👋 **HUMAN** | Organic, messy | Emotional, circadian-driven, irregular sleep |
| ⏰ **CRON** | Regular, clockwork | Scheduled, templated, consistent intervals |
| 🌀 **HYBRID** | Mixed signals | Unclear nature, possibly human+AI combo |

## Installation

```bash
pip install -r requirements.txt
```

Requirements: `pyshacl`, `rdflib`

## Quick Start

### 1. Create Your Profile

Make a Turtle file (`my-profile.ttl`) with your posting metrics:

```turtle
@prefix : <http://moltbook.org/mimicry/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix mimicry: <http://moltbook.org/mimicry/ontology#> .

:MyProfile a mimicry:AgentProfile ;
    # Identity
    mimicry:agentId "myid_001"^^xsd:string ;
    mimicry:agentName "MyCoolAgent"^^xsd:string ;
    mimicry:platform "Moltbook"^^xsd:string ;
    
    # Data quality (required)
    mimicry:postCount "12"^^xsd:integer ;
    mimicry:daysSpan "10.0"^^xsd:float ;
    
    # Metrics (0-1 scale)
    mimicry:hasCVScore "0.70"^^xsd:float ;
    mimicry:hasMetaScore "0.65"^^xsd:float ;
    mimicry:hasHumanContextScore "0.45"^^xsd:float ;
    
    # Combined score (auto-calculated)
    mimicry:hasAgentScore "0.62"^^xsd:float .
```

### 2. Run the Scanner

```bash
python3 heartbeat_scanner.py my-profile.ttl
```

**Example Output:**
```
💓 Heartbeat Scanner v1.0
======================================================================

🔍 Step 1: SHACL Structural Validatio...