pni501 (Project Nemesis Index)

Project Nemesis Index (PNI) evaluates software development project health and generates diagnostic reports to help engineering teams identify risks, maintain architectural integrity, and improve delivery velocity.

Overview

Software projects naturally accumulate friction—technical debt, uneven test coverage, stagnant dependencies, architectural drift, and workflow bottlenecks. PNI (Project Nemesis Index) analyzes software repositories to produce quantifiable health scores and actionable reports.

• Package Name (PyPI): pni501
• Import Module: pni
• CLI Command: pni501
• Developer Management Tool: ./pcli

Installation

Install via pip:

pip install pni501

Or using uv:

uv add pni501

Quickstart

Verify the installation:

pni501 version

Display CLI options and help:

pni501 --help

Development

This project is managed with uv and uses ./pcli (tools/pcli) for development workflows.

1. Shell Setup

Run ./pcli to inspect available toolsets or source it to enable dynamic autocompletion:

./pcli                    # Display available toolsets
source ./pcli             # Register 'pcli' shell alias & autocompletion

2. Available Toolsets

# Code Quality
./pcli code-check lint [--fix]
./pcli code-check type
./pcli code-check lines
./pcli code-check all

# Testing
./pcli test all
./pcli test pni
./pcli test pcli

# PyPI Management
./pcli pypi check-version
./pcli pypi publish --test-pypi
./pcli pypi publish

License

This project is licensed under the Apache 2.0 License. See LICENSE for details.