{"_id":"@bytesbrains/pi-auditor","_rev":"3-d57e363ed4446f2521154920f00df0b3","name":"@bytesbrains/pi-auditor","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@bytesbrains/pi-auditor","version":"1.0.0","keywords":["pi-package","pi-extension","doctor","audit","auditor","rag","context-engineering","digestibility"],"author":{"name":"nandal","email":"nandal@users.noreply.github.com"},"license":"MIT","_id":"@bytesbrains/pi-auditor@1.0.0","maintainers":[{"name":"nandal","email":"sandeep@nandal.in"}],"homepage":"https://github.com/nandal/pi-ext/tree/main/doctor","bugs":{"url":"https://github.com/nandal/pi-ext/issues"},"pi":{"extensions":["./src/index.ts"]},"dist":{"shasum":"6428e636bc0825067a9e19277e10cea3b9a6591c","tarball":"https://registry.npmjs.org/@bytesbrains/pi-auditor/-/pi-auditor-1.0.0.tgz","fileCount":9,"integrity":"sha512-OLK9/rk1gEsijVZGWGniWG51QJIiEhWuCKaWWheIudAjWuuCd6aGxsng2KonRnIYmhcF2d8IiSSuGt3A2oN8iA==","signatures":[{"sig":"MEQCIDu7Hw3rZP9CiKGw8fUvZYjMBaQ2N7e9IoOkLOnVWeURAiBCaQDFaym0oBs/xg7LmxGVU6C6GofBu3OjynEi7nqwgw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32776},"main":"./src/index.ts","engines":{"node":">=18"},"gitHead":"1fca2cfdcbdf155b60d39efd9495773b47cb49a1","_npmUser":{"name":"nandal","email":"sandeep@nandal.in"},"repository":{"url":"git+https://github.com/nandal/pi-ext.git","type":"git","directory":"doctor"},"_npmVersion":"11.3.0","description":"Audit repo files for RAG digestibility — find god files, measure chunk fragmentation, and generate split suggestions.","directories":{},"_nodeVersion":"24.2.0","_hasShrinkwrap":false,"peerDependencies":{"typebox":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-auditor_1.0.0_1778871432846_0.6770734541339092","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@bytesbrains/pi-auditor","version":"1.0.1","keywords":["pi-package","pi-extension","doctor","audit","auditor","rag","context-engineering","digestibility"],"author":{"name":"nandal","email":"nandal@users.noreply.github.com"},"license":"MIT","_id":"@bytesbrains/pi-auditor@1.0.1","maintainers":[{"name":"nandal","email":"sandeep@nandal.in"}],"homepage":"https://github.com/nandal/pi-ext/tree/main/doctor","bugs":{"url":"https://github.com/nandal/pi-ext/issues"},"pi":{"extensions":["./src/index.ts"]},"dist":{"shasum":"baf0ef339ec5d4afaa71e099cf172f25b593235b","tarball":"https://registry.npmjs.org/@bytesbrains/pi-auditor/-/pi-auditor-1.0.1.tgz","fileCount":9,"integrity":"sha512-988h0k+3GtablbVFvXLzz6J3+4GJZuoZJkGywAUo/9BuRbh4evX1dc0KabnN60vNAHrnK4nb9Y/c/15XjzoBnQ==","signatures":[{"sig":"MEUCIQCfF5bGgBaj/tjmkiiAv50L/tvfzSJl5dFLfZc62xye5wIga102T8Xz1zzw1Lt8QhT5FzbJexY+VHZaNKiayB4w4Co=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32841},"main":"./src/index.ts","engines":{"node":">=18"},"gitHead":"dd8d17694ac2dc7b5429ae8171fcf6ea414e0c97","_npmUser":{"name":"nandal","email":"sandeep@nandal.in"},"repository":{"url":"git+https://github.com/nandal/pi-ext.git","type":"git","directory":"doctor"},"_npmVersion":"11.3.0","description":"Audit repo files for RAG digestibility — find god files, measure chunk fragmentation, and generate split suggestions.","directories":{},"_nodeVersion":"24.2.0","_hasShrinkwrap":false,"peerDependencies":{"typebox":"*","@earendil-works/pi-coding-agent":"*"},"_npmOperationalInternal":{"tmp":"tmp/pi-auditor_1.0.1_1778881572671_0.5099814739969535","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@bytesbrains/pi-auditor","version":"1.0.2","description":"Audit repo files for RAG digestibility — find god files, measure chunk fragmentation, and generate split suggestions.","keywords":["pi-package","pi-extension","doctor","audit","auditor","rag","context-engineering","digestibility"],"author":{"name":"BytesBrains Pte Ltd","url":"https://bytesbrains.com"},"repository":{"type":"git","url":"git+https://github.com/bytesbrains/pi-auditor.git"},"homepage":"https://github.com/bytesbrains/pi-auditor#readme","bugs":{"url":"https://github.com/bytesbrains/pi-auditor/issues"},"license":"MIT","main":"./src/index.ts","engines":{"node":">=18"},"peerDependencies":{"@earendil-works/pi-coding-agent":"*","typebox":"*"},"pi":{"extensions":["./src/index.ts"]},"_id":"@bytesbrains/pi-auditor@1.0.2","gitHead":"cfbe69fba9402a322cf26e5450d7a876b5544248","_nodeVersion":"24.2.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-EPgiIX7vWmlUIA/fPWlMvjmwzv5rynOcLh9fTCAAbtbFCthoZ0xMB69sqK6oukPyBcNeoYOCBxXYxLjptshPuw==","shasum":"e35abb609345d8b9e5946c7c8c61e34cebe6f731","tarball":"https://registry.npmjs.org/@bytesbrains/pi-auditor/-/pi-auditor-1.0.2.tgz","fileCount":9,"unpackedSize":33077,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDevieTFPQ29WeRf1XDzIr8yOzhWQlaf740I1ZG2kSCcQIhAP2aLUTh6+VZs4RDen+EbMPe5t6f+GAUgxfskOpSFj7b"}]},"_npmUser":{"name":"nandal","email":"sandeep@nandal.in"},"directories":{},"maintainers":[{"name":"nandal","email":"sandeep@nandal.in"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-auditor_1.0.2_1783472783465_0.7271832583878797"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-15T18:57:12.779Z","modified":"2026-07-08T01:06:23.747Z","1.0.0":"2026-05-15T18:57:12.990Z","1.0.1":"2026-05-15T21:46:12.821Z","1.0.2":"2026-07-08T01:06:23.621Z"},"bugs":{"url":"https://github.com/bytesbrains/pi-auditor/issues"},"author":{"name":"BytesBrains Pte Ltd","url":"https://bytesbrains.com"},"license":"MIT","homepage":"https://github.com/bytesbrains/pi-auditor#readme","keywords":["pi-package","pi-extension","doctor","audit","auditor","rag","context-engineering","digestibility"],"repository":{"type":"git","url":"git+https://github.com/bytesbrains/pi-auditor.git"},"description":"Audit repo files for RAG digestibility — find god files, measure chunk fragmentation, and generate split suggestions.","maintainers":[{"name":"nandal","email":"sandeep@nandal.in"}],"readme":"# Doctor for Pi\n\n[![npm version](https://img.shields.io/npm/v/@bytesbrains/pi-auditor)](https://www.npmjs.com/package/@bytesbrains/pi-auditor)\n[![license](https://img.shields.io/npm/l/@bytesbrains/pi-auditor)](./LICENSE)\n\n> Audit repositories for RAG digestibility — find oversized \"god files\" that fragment poorly in vector indexes, get split suggestions, and track file size distribution.\n\n## Install\n\n```bash\npi install npm:@bytesbrains/pi-auditor\n```\n\nOr add to your `.pi/settings.json`:\n\n```json\n{\n  \"packages\": [\"npm:@bytesbrains/pi-auditor\"]\n}\n```\n\n## Commands\n\n| Command | What it does |\n|---|---|\n| `/doctor:audit` | Full digestibility report with size distribution, god files, and assessment |\n| `/doctor:god-files [--threshold N]` | List files exceeding the LOC threshold with split suggestions |\n| `/doctor:rules [init\\|show\\|set <key> <value>]` | Manage `.doctorrc.yml` configuration |\n\n## Tools (LLM-callable)\n\n| Tool | What it does |\n|---|---|\n| `doctor_audit` | Run full audit, returns structured JSON report |\n| `doctor_check_file <path>` | Audit a single file for RAG compatibility |\n\n## Configuration\n\nDoctor reads `.doctorrc.yml` from the working directory (falls back to sensible defaults):\n\n```yaml\nfiles:\n  maxLines: 200          # warn above this LOC\n  criticalLines: 500     # error above this LOC\n  ignore:\n    - \"*generated*\"\n    - \"*.d.ts\"\n    - \"migrations/*.sql\"\n    - \"test-data/*.json\"\n```\n\nCreated automatically on first run, or via `/doctor:rules init`.\n\n## Example\n\n```\nYou: /doctor:audit\n\n📊 Digestibility Report  —  ✓ GOOD\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n  Files analyzed:          87\n  Total LOC:               12,430\n  Total functions:         312\n  Total exports:           246\n\n  RAG-friendly (≤200 LOC):  85 (97.7%)  ✓\n  Warning (201–500 LOC):      2 (2.3%)   ⚠\n  Critical (>500 LOC):        0 (0%)     ✗\n\n📈 File Size Distribution\n  0–50       ██████████████████████████ 52 (60%)\n  51–100     ███████ 15 (17%)\n  101–200    ██████ 13 (15%)\n  201–500    █ 2 (2%)\n\n🩺 Assessment: 0 critical files. 2 files exceed the 200-LOC limit.\n   → Run /doctor:god-files for detailed split suggestions.\n```\n\n## License\n\nMIT © [nandal](https://github.com/nandal)\n\n---\n\nBuilt and maintained by [BytesBrains](https://bytesbrains.com) — AI automation & agents, engineered to production standards.\n*The model proposes, code guarantees.*\n","readmeFilename":"README.md"}