prismalens 0.5.0-rc.3 → 0.5.1

package/NOTICE

@@ -3,3 +3,26 @@ Copyright 2026 Sumit Patel
 
 This product includes software developed as part of the PrismaLens project
 (https://prismalens.io).
+
+The npm package bundles third-party software in two places:
+
+1. The web dashboard. Its third-party code and licences are listed in
+   THIRD_PARTY_NOTICES.txt, next to this file.
+
+2. The agent adapters, under node_modules/@prismalens/agent-adapters/. They
+   let an installed Claude Code or Codex answer the Agent Client Protocol:
+   - @agentclientprotocol/claude-agent-acp, @agentclientprotocol/codex-acp and
+     @agentclientprotocol/sdk (Apache-2.0);
+   - @anthropic-ai/claude-agent-sdk, under Anthropic's own terms rather than
+     an open-source licence. Its LICENSE.md reads: "© Anthropic PBC. All
+     rights reserved. Use is subject to the Legal Agreements outlined here:
+     https://code.claude.com/docs/en/legal-and-compliance";
+   - @openai/codex, the Codex CLI package codex-acp depends on (Apache-2.0,
+     as its package.json declares), without its platform binaries;
+   - their dependencies (MIT, ISC, BSD-2-Clause, BSD-3-Clause and
+     Unlicense).
+   Each keeps its own licence file in its package directory, except
+   @openai/codex and standardwebhooks (MIT), which ship none.
+
+Everything else the package needs, npm installs next to it from the registry,
+each with its own licence file.

package/README.md

@@ -1,38 +1,78 @@
 # prismalens
 
-PrismaLens is an AI-powered root-cause investigation tool for on-call engineers. It analyzes firing alerts against your repositories and telemetry, producing an ordered-evidence report that ranks hypotheses by observed evidence without synthetic confidence scores. The CLI runs standalone or boots the full local application.
+PrismaLens is a self-hosted incident investigator. When an alert arrives, the
+coding agent you already use reads a snapshot of the service's code, under a
+permission level you pick, and writes an ordered-evidence report: hypotheses
+ranked by the evidence behind them, with no numeric confidence scores. The run,
+the evidence and the cause stay on the incident. The agent runs as your user;
+PrismaLens adds no sandbox. This package is the `pl` command: it starts the
+app, checks a machine, pairs devices and manages a background service.
 
 ## Install
 
-Requires Node.js 24+.
+PrismaLens is alpha: any 0.x release may break, so read the
+[release notes](https://github.com/prismalens/prismalens/releases) before upgrading.
+
+### npm
+
+Needs Node.js 24+.
 
 ```bash
 npm install -g prismalens
 ```
 
+To try it once without installing, run `npx prismalens@latest up`.
+
+### macOS and Linux, without Node
+
+```bash
+curl -fsSL https://prismalens.io/install.sh | sh
+```
+
+### Windows, without Node (preview)
+
+```powershell
+irm https://prismalens.io/install.ps1 | iex
+```
+
+Both installers bring their own Node, check the download against the
+release's `SHA256SUMS`, and put `pl` on your PATH.
+
+### Homebrew, and Scoop (preview)
+
+```bash
+brew install prismalens/tap/prismalens
+```
+
+```powershell
+scoop bucket add prismalens https://github.com/prismalens/scoop-bucket
+scoop install prismalens
+```
+
 ## Quick start
 
-Check the environment, then start the web interface or run an investigation directly:
+Check the machine, then start the app:
 
 ```bash
-prismalens doctor
+pl doctor
 pl up
-pl investigate --repo . --query "checkout latency spike after 14:00 UTC"
 ```
 
+`pl up` serves the dashboard on http://localhost:6473 and opens your browser
+on a one-time link that pairs it; there is no account. Investigations need a
+coding agent on PATH; `pl doctor` lists the ones PrismaLens knows and how to
+install each.
+
 ## Commands
 
 | Command | Description |
 | --- | --- |
-| `up` | Run PrismaLens as a single process serving the API and web dashboard. |
-| `investigate` | Run a root-cause investigation on a firing alert or query. |
-| `listen` | Start a local HTTP webhook receiver for incoming Alertmanager alerts. |
-| `serve` | Run the JSON-RPC server over stdio for desktop and API integrations. |
-| `doctor` | Preflight-check the environment for harness binaries and credentials. |
-| `init` | Scaffold a default configuration file in the current directory. |
-| `status` | List recent investigation runs and their execution states. |
-| `report` | Display the stored investigation report for a specific run ID. |
-| `auth` | Manage stored credentials for model providers. |
+| `up` | Run PrismaLens as a single process serving the API and web dashboard (default port 6473); `--tailscale-serve` also publishes it on your tailnet over HTTPS. |
+| `doctor` | Preflight-check the environment: the coding agents on PATH, each one's ACP handshake (answers ACP, sign in needed, no answer in 10s, or failed to start; Claude Code checks its sign-in only when a run starts), the model a run gets, and Git. |
+| `pair` | Print a one-time link that pairs another device with this instance, with `--tailscale` on its tailnet HTTPS address, or with `--operator` this machine's own browser. |
+| `reset` | Delete the workspace — database, secrets and logs — after naming the path and asking. |
+| `upgrade` | Upgrade the way PrismaLens was installed: npm, the installer, Homebrew or Scoop. A background service tries the new version first and goes back to the old one and its database if it fails. |
+| `service` | Run PrismaLens in the background for this user (`install`, `status`, `restart`, `uninstall`); Linux and macOS. `install --tailscale-serve` publishes it on your tailnet over HTTPS on every start. |
 
 ## Documentation
 
@@ -40,5 +80,5 @@ Complete documentation, guides, and configuration references are available at ht
 
 ## License
 
-Apache-2.0
-
+Apache-2.0. The package also bundles the agent adapters, including the Claude
+Agent SDK under Anthropic's own terms; `NOTICE` lists them and their licences.