Metadata-Version: 2.5
Name: nablr
Version: 4.16.1
Summary: nablr — AI-powered SDLC governance. 19 expert personas enforcing quality gates via Model Context Protocol (MCP).
Project-URL: Homepage, https://nablr.dev
Project-URL: Repository, https://github.com/nablrco/nablr
Project-URL: Bug Tracker, https://github.com/nablrco/nablr/issues
Author-email: Mishtert T <Mishtert.Thangaraj@myridius.com>
License: Proprietary
License-File: LICENSE
Keywords: agents,ai,code-quality,governance,mcp,relay-engineering,sdlc
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.12
Requires-Dist: bandit>=1.9.2
Requires-Dist: fastmcp<4.0.0,>=3.4.2
Requires-Dist: mcp>=1.25.0
Requires-Dist: networkx>=3.4
Requires-Dist: pydantic>=2.12.5
Requires-Dist: semgrep>=1.176.1
Requires-Dist: structlog>=25.5.0
Requires-Dist: tree-sitter-markdown>=0.3.0
Requires-Dist: tree-sitter-python>=0.21.0
Requires-Dist: tree-sitter-typescript>=0.21.0
Requires-Dist: tree-sitter>=0.21.0
Requires-Dist: watchdog>=4.0.0
Description-Content-Type: text/markdown

# nablr

![Security Scan](https://github.com/nablrco/nablr/actions/workflows/security-scan.yml/badge.svg)
![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)
![PyPI](https://img.shields.io/pypi/v/nablr)

<!-- STORY-DOCS-CLAIMS-001 FR-10: Python badge floor corrected to match
pyproject.toml's requires-python. FR-1/FR-2: persona and scanner counts
below corrected to match AVAILABLE_AGENTS/ScanTargetAction's real sizes. -->

**AI-powered SDLC governance via Model Context Protocol.**

**nablr** *(pronounced like "enabler")* connects to your AI assistant (Cursor, Claude Desktop, Windsurf) and enforces quality gates across your entire software delivery lifecycle — 18 expert personas, 12 built-in scanners, full workflow orchestration.

> Documentation: [docs.nablr.dev](https://docs.nablr.dev)

---

## Why nablr

AI assistants accelerate typing, not engineering.

| What they promised | What actually happens |
|--------------------|----------------------|
| Ship faster | More code, same bugs |
| Higher quality | AI-generated tech debt |
| Reduce costs | Increased rework cycles |

nablr is the orchestration layer that fixes this: quality enforcement, workflow context, and persistent state injected directly into your AI assistant via MCP.

---

## What a licence unlocks

nablr needs a licence key. There is no free tier. Buy a plan or the paid 10-day trial at [nablr.dev](https://nablr.dev). Your key arrives by email. Then call the `set_license_key` tool with it.

| Capability | With a licence |
|-----------|----------------|
| 12 built-in scanners | ✅ |
| Workflow orchestration | ✅ |
| Codebase mapping | ✅ |
| Persona prompts | 18 (all) |
| Rule files + language/framework configs | Ships in every install, plus server-fetched freshness |

---

## Installation

Requires [`uv`](https://docs.astral.sh/uv/getting-started/installation/).

Add to your AI assistant config:

```json
{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"]
    }
  }
}
```

Config file locations:
- **Cursor**: `~/.cursor/mcp.json`
- **Claude Desktop** (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windsurf**: `~/.codeium/windsurf/mcp_config.json`

Restart your AI assistant after saving. Full setup guide at [docs.nablr.dev/quickstart](https://docs.nablr.dev/quickstart).

---

## Quick start

```
# Entry point — loads nablr context into your AI assistant
activate nablr

# Activate the key from your purchase email
Call set_license_key with sk_nablr_<your-key>

# Invoke a persona
Set agent to developer

# Run a scanner
Scan this directory for technical debt

# Full SDLC workflow
Set agent to discovery  →  Set agent to architect  →  Set agent to developer
```

---

## Personas

18 expert agents covering every SDLC phase: Discovery, Product Manager, QA Lead, Specifier, Architect, Developer, Tester, Test Designer, PR Reviewer, Scrum Master, Security Owner, Forensic Engineer, Strategist, Platform Engineer, Impact Architect, Migration Planner, Parity Tester, Cutover Engineer.

Every persona requires a licence.

---

## Security

nablr makes exactly one category of outbound call: license validation to `nablr-api.nablrco.workers.dev:443`. Your code never leaves your machine.

Paid assets are pre-cached to `~/.nablr_cache/assets/` on activation — all subsequent prompt generation works fully offline.

```bash
# Verify no unexpected network calls
uv run python scripts/airgap_proof.py
```

Full security details at [docs.nablr.dev/security](https://docs.nablr.dev/security).

---

## License

Proprietary. All rights reserved. © nablr
