@bytesbrains/pi-auditor

Audit repo files for RAG digestibility — find god files, measure chunk fragmentation, and generate split suggestions.

Packages

Package details

extension

Install @bytesbrains/pi-auditor from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@bytesbrains/pi-auditor

Package: @bytesbrains/pi-auditor
Version: 1.0.1
Published: May 15, 2026
Downloads: not available
Author: nandal
License: MIT
Types: extension
Size: 32.1 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Doctor for Pi

Audit repositories for RAG digestibility — find oversized "god files" that fragment poorly in vector indexes, get split suggestions, and track file size distribution.

Install

pi install npm:@bytesbrains/pi-auditor

Or add to your .pi/settings.json:

{
  "packages": ["npm:@bytesbrains/pi-auditor"]
}

Commands

Command	What it does
`/doctor:audit`	Full digestibility report with size distribution, god files, and assessment
`/doctor:god-files [--threshold N]`	List files exceeding the LOC threshold with split suggestions
`/doctor:rules [init\|show\|set <key> <value>]`	Manage `.doctorrc.yml` configuration

Tools (LLM-callable)

Tool	What it does
`doctor_audit`	Run full audit, returns structured JSON report
`doctor_check_file <path>`	Audit a single file for RAG compatibility

Configuration

Doctor reads .doctorrc.yml from the working directory (falls back to sensible defaults):

files:
  maxLines: 200          # warn above this LOC
  criticalLines: 500     # error above this LOC
  ignore:
    - "*generated*"
    - "*.d.ts"
    - "migrations/*.sql"
    - "test-data/*.json"

Created automatically on first run, or via /doctor:rules init.

Example

You: /doctor:audit

📊 Digestibility Report  —  ✓ GOOD
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Files analyzed:          87
  Total LOC:               12,430
  Total functions:         312
  Total exports:           246

  RAG-friendly (≤200 LOC):  85 (97.7%)  ✓
  Warning (201–500 LOC):      2 (2.3%)   ⚠
  Critical (>500 LOC):        0 (0%)     ✗

📈 File Size Distribution
  0–50       ██████████████████████████ 52 (60%)
  51–100     ███████ 15 (17%)
  101–200    ██████ 13 (15%)
  201–500    █ 2 (2%)

🩺 Assessment: 0 critical files. 2 files exceed the 200-LOC limit.
   → Run /doctor:god-files for detailed split suggestions.