paqad-ai 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# paqad-ai
+
+## 1.0.3
+
+### Patch Changes
+
+- [#15](https://github.com/Eliyce/paqad-ai/pull/15) [`99b1e5b`](https://github.com/Eliyce/paqad-ai/commit/99b1e5b18f42634006f88e16c7eb2fc7091d3f43) Thanks [@HLasani](https://github.com/HLasani)! - First automated release via Changesets + GitHub Actions. No runtime change — this release exists only to validate the new publish pipeline (CI gating, version PR, npm provenance).
+
+All notable changes to this project will be documented in this file. See [Changesets](https://github.com/changesets/changesets) for commit guidelines.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Paqad
+Copyright (c) 2026 Haider Lasani <haider@eliyce.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -9,7 +9,14 @@
 
 **AI agents that think before they type.** paqad-ai reads your codebase, detects your stack, builds optional hybrid RAG context, and generates the docs, rules, MCP configs, security checks, and workflows your coding agents need to operate with real project context.
 
-[![npm version](https://img.shields.io/npm/v/paqad-ai)](https://npmjs.com/package/paqad-ai) [![license](https://img.shields.io/npm/l/paqad-ai)](./LICENSE) [![website](https://img.shields.io/badge/website-paqad.ai-0A7A5C)](https://paqad.ai) [![docs](https://img.shields.io/badge/docs-paqad.ai-1f6feb)](https://paqad.ai)
+[![npm version](https://img.shields.io/npm/v/paqad-ai.svg?style=flat-square)](https://www.npmjs.com/package/paqad-ai)
+[![npm downloads](https://img.shields.io/npm/dm/paqad-ai.svg?style=flat-square)](https://www.npmjs.com/package/paqad-ai)
+[![CI](https://img.shields.io/github/actions/workflow/status/Eliyce/paqad-ai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/Eliyce/paqad-ai/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/npm/l/paqad-ai.svg?style=flat-square)](./LICENSE)
+[![Node](https://img.shields.io/node/v/paqad-ai.svg?style=flat-square)](https://nodejs.org)
+[![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](./CONTRIBUTING.md)
+[![website](https://img.shields.io/badge/website-paqad.ai-0A7A5C?style=flat-square)](https://paqad.ai)
+[![docs](https://img.shields.io/badge/docs-paqad.ai-1f6feb?style=flat-square)](https://paqad.ai)
 
 ---
 
@@ -62,6 +69,7 @@ npx paqad-ai onboard
 | **Stack detection**      | Lockfile-driven framework, trait, and archetype detection across 9 ecosystems        |
 | **Documentation**        | Stack, architecture, design-system, registry, and module documentation flows         |
 | **Hybrid RAG**           | Optional vector indexing, hybrid retrieval, reranking, evals, and benchmarks         |
+| **Project graph**        | One-command WebGL map of modules, files, chunks, symbols, imports, and similarities  |
 | **Security**             | OWASP-mapped pentest workflow with incremental retests                               |
 | **Spec compliance**      | Obligation extraction, test evidence checks, and failing skeleton generation         |
 | **Built-in agent roles** | 20 internal specialist roles for routing, review, design, verification, and security |
@@ -480,6 +488,30 @@ paqad-ai rag eval --model-graded           # Also run the optional model-graded
 
 Benchmark comparisons support `lexical-vs-rag`, `rag-vs-candidate`, and `feature-off-vs-on`.
 
+### `paqad-ai graph`
+
+Open an interactive WebGL map of your project in the browser. One command, no extra install — the server, frontend, and Force Atlas 2 layout worker all ship inside `paqad-ai`.
+
+```bash
+paqad-ai graph                          # Opens http://127.0.0.1:5371 in your browser
+paqad-ai graph --no-open                # Print the URL and skip auto-open
+paqad-ai graph --port 8080              # Custom port (auto-increments if busy)
+paqad-ai graph --host 0.0.0.0           # Share on a trusted network (loopback by default)
+paqad-ai graph --threshold 0.85         # Initial similarity threshold
+paqad-ai graph --no-watch               # Disable live reload on .paqad/ changes
+```
+
+**What you get:**
+
+- Modules, files, chunks, symbols, and the full import graph rendered together as one explorable map
+- Click-through detail panel: module file lists, file `imports_in` / `imports_out`, chunk content with show-more, symbol metadata
+- Search across modules, files, symbols, and file basenames — `/` to focus, `n` / `N` to cycle matches; the camera pans to each hit
+- Similarity slider — adjust the cosine threshold and watch the orange semantic-neighbour edges redraw on demand. Works with `local`, `openai`, and `voyageai` embeddings.
+- Four intelligence overlays — health, defect density (log-scaled), risk floor, complexity correction — with a persistent legend
+- Live reload — change anything under `.paqad/` and the graph updates in place while preserving viewport and selection
+
+**Pre-conditions:** the current directory must contain a `.paqad/` from a previous `paqad-ai onboard`. RAG is optional — without it the graph still renders fully, with similarity and chunk nodes disabled behind a clear banner.
+
 ### Security workflows
 
 Security and retest flows are part of the framework runtime and agent workflows in this package version. They are not exposed as standalone top-level CLI commands in `paqad-ai` today.
@@ -574,6 +606,7 @@ Entry files stay thin. Knowledge lives in shared instruction bundles that extern
 | **Refresh**          | `paqad-ai refresh`                     | Re-detect stack, update derived docs                      |
 | **Update**           | `paqad-ai update`                      | Regenerate framework files after version bump             |
 | **RAG**              | `paqad-ai rag ...`                     | Build, inspect, clear, and benchmark hybrid retrieval     |
+| **Project graph**    | `paqad-ai graph`                       | Interactive browser view of modules, files, chunks, deps  |
 | **Documentation**    | Ask agent: _"create documentation"_    | Stack → architecture → design system → modules            |
 | **Pentest**          | Ask agent: _"run pentest"_             | 5-step scan → findings → report                           |
 | **Retest**           | Ask agent: _"retest pentest"_          | Replay findings → fixed / still-open / needs-verification |