npm package: @safetnsr/human-edge
Description: Know what makes you irreplaceable. Analyzes your git history and scores how AI-replaceable vs uniquely human each contribution is.
Author: safetnsr
Latest version: 0.1.0
Deprecated: merged into @safetnsr/vet — use: npx @safetnsr/vet edge

# human-edge

Know what makes you irreplaceable. Analyzes your git history and scores how AI-replaceable vs uniquely human each contribution is.

## install

```bash
npx @safetnsr/human-edge
```

## usage

```bash
npx @safetnsr/human-edge
```

```
  🧠 YOUR HUMAN EDGE REPORT
  2025-09-01 → 2026-02-28 · 247 commits analyzed
  ────────────────────────────────────────────────────

  Overall Score: 73/100
  Strong human edge — your work is hard to automate

  Category Breakdown
  🏗️ Architecture      42 (17%) ████
  🔍 Debugging          31 (13%) ███
  🔗 Integration        28 (11%) ███
  ⚡ Feature            89 (36%) ████████
  📋 Boilerplate        38 (15%) ████
  🎨 Cosmetic           19  (8%) ██

  🏆 Most Irreplaceable
  90 a1b2c3d4  refactor auth system across 5 modules
  90 e5f6g7h8  redesign database connection pooling
  85 i9j0k1l2  fix race condition in payment queue

  ⚠️  Most Automatable
  10 m3n4o5p6  format: run prettier
  20 q7r8s9t0  scaffold user CRUD endpoints
  20 u1v2w3x4  add boilerplate test files

  ────────────────────────────────────────────────────
  → Balanced mix. Push toward more integration and architecture work.
```

## flags

| Flag | Description | Default |
|------|-------------|---------|
| `--since <period>` | Time period to analyze | `6months` |
| `--author <name>` | Filter by git author | all authors |
| `--path <dir>` | Scope to subdirectory | entire repo |
| `--json` | JSON output for agents | off |
| `--export <file>` | Save as markdown report | off |
| `--explain` | Show per-commit reasoning | off |
| `--top <N>` | Limit commits shown | 3 |
| `-h, --help` | Show help | - |

## scoring

| Score | Category | What it means |
|-------|----------|---------------|
| 90 | Architecture | Cross-directory structural changes |
| 85 | Debugging | Targeted fixes requiring deep context |
| 80 | Integration | Multi-system wiring (API/DB/queue) |
| 60 | Feature | Moderate new code additions |
| 20 | Boilerplate | Scaffolding, CRUD, templates |
| 10 | Cosmetic | Renames, formatting, whitespace |

## agent interface (--json)

```json
{
  "score": 73,
  "totalCommits": 247,
  "analyzedCommits": 247,
  "period": { "from": "2025-09-01", "to": "2026-02-28" },
  "distribution": {
    "architecture": 42,
    "debugging": 31,
    "integration": 28,
    "feature": 89,
    "boilerplate": 38,
    "cosmetic": 19
  },
  "topIrreplaceable": [...],
  "topAutomatable": [...],
  "recommendation": "..."
}
```

## examples

```bash
# analyze current repo, last 6 months
npx @safetnsr/human-edge

# your commits only, last 3 months
npx @safetnsr/human-edge --since 3months --author "Jane"

# scope to a specific directory
npx @safetnsr/human-edge --path src/auth

# export report
npx @safetnsr/human-edge --export report.md --explain

# pipe JSON to another tool
npx @safetnsr/human-edge --json | jq '.score'
```

## pair with

- [@safetnsr/ai-ready](https://github.com/safetnsr/ai-ready) — pre-session codebase AI-readiness scorer
- [@safetnsr/vibe-check](https://github.com/safetnsr/vibe-check) — post-session code quality audit
- [@safetnsr/session-distill](https://github.com/safetnsr/session-distill) — generate CLAUDE.md from session history

## license

MIT