@njeybe/nativ 2.0.0 → 2.0.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 2.0.2
+
+- **`nativ doctor` no longer reports a failure on a brand-new project.** Right after `nativ init`, Claude Code lists the project's `nativ` MCP server as "Pending approval" until you approve it, which is the expected first state. Doctor showed it as a red failure and exited 1. It is now a warning that tells you to open `claude` in the folder and approve the server; a server that genuinely fails to connect is still a failure.
+
+## 2.0.1
+
+Documentation and package metadata only; no behaviour changes.
+
+- **npm is the only install path.** The source repository is private, so the instructions for `npm install -g github:…` and for adding the plugin marketplace were removed from the README and the installation guide. `nativ setup` is the complete route: it writes the agents, the enforcement hook, the MCP entry and the permission rules, which a plugin cannot ship.
+- The plugin files still ship inside the package (`plugin/`) and can be tried for one session with `claude --plugin-dir`.
+- `package.json` no longer declares `repository`, `homepage` or `bugs`, so the npm page has no dead links.
+- The 2.0.0 entry below still mentions the plugin marketplace; that route is not available outside the private repository.
+
 ## 2.0.0
 
 nativ is now role-based and Claude-first. The roles (architect, project manager, worker, verifier) are fixed; the model behind each one is configurable, and Claude Code is the default host for all of them. Antigravity and Gemini still work as an optional architect.

package/README.md

@@ -36,17 +36,14 @@ Why it works:
 
 ### 1. Install
 
-You need Node.js 20 or newer and Git. You do **not** need a clone of this repository.
+You need Node.js 20 or newer and Git.
 
 ```bash
-# From npm
 npm install -g @njeybe/nativ
-
-# Or straight from GitHub (builds on install, about a minute)
-npm install -g github:njeybe/nativ
+nativ --version
 ```
 
-Check it with `nativ --version`. Developing nativ itself? See [docs/installation.md](docs/installation.md) for the clone and `npm link` route.
+The package is `@njeybe/nativ`; the command is `nativ`. More options, including running it without installing, are in [docs/installation.md](docs/installation.md).
 
 ### 2. Set up a project
 
@@ -69,14 +66,11 @@ Setup **merges**: it never overwrites your own settings, hooks, MCP servers or e
 
 Open Claude Code in the folder once and accept the workspace trust dialog. Until you do, Claude Code ignores the project's `permissions.allow` entries.
 
-### 3. Or install it as a Claude Code plugin
+### 3. About the Claude Code plugin
 
-```text
-/plugin marketplace add njeybe/nativ
-/plugin install nativ@nativ
-```
+You do not need the plugin. `nativ setup` writes the same agents, enforcement hook and MCP entry into your project, and also the permission rules that deny `nativ task unlock` and `nativ db sync`, block reading `.env*` files, and make Claude Code ask before any write under `.ai/`. **A plugin cannot ship permission rules**, so `nativ setup` is the complete route.
 
-The plugin brings the agents, the enforcement hooks, the MCP server and a skill that teaches the task loop. It calls the `nativ` command, so install the CLI first. **A plugin cannot ship permission rules**, so also run `nativ setup` in the project to add the rules that deny `nativ task unlock` and `nativ db sync`, block reading `.env*` files, and make Claude Code ask before any write under `.ai/`.
+The plugin files ship inside the package (`plugin/`). To try them for a single Claude Code session, point `claude --plugin-dir` at that folder under your global `node_modules` (`npm root -g` prints its location).
 
 ### 4. Work
 
@@ -96,7 +90,7 @@ Run it after updating Claude Code or nativ. It also asks Claude Code itself whet
 ### 6. Update
 
 ```bash
-npm install -g @njeybe/nativ@latest   # or: npm install -g github:njeybe/nativ
+npm install -g @njeybe/nativ@latest
 nativ update                      # in each project
 nativ doctor
 ```

package/dist/commands/doctor.js

@@ -38,6 +38,13 @@ export function analyzeMcpList(text) {
     else if (/Connected/.test(line)) {
         checks.push({ id: 'mcp-connected', status: 'ok', message: `Claude Code connects to the nativ MCP server (${line.replace(/\s+-\s+.*$/, '').trim()})` });
     }
+    else if (/Pending approval/i.test(line)) {
+        // A new project's .mcp.json is not started until the user approves it. That is the expected first state.
+        checks.push({ id: 'mcp-pending', status: 'warn', message: 'The nativ MCP server is waiting for your approval. Open `claude` in this folder and approve it; nothing is wrong with the setup.' });
+    }
+    else if (/Needs authentication/i.test(line)) {
+        checks.push({ id: 'mcp-auth', status: 'warn', message: `Claude Code says the nativ MCP server needs authentication: ${line.trim()}` });
+    }
     else {
         checks.push({ id: 'mcp-connected', status: 'fail', message: `Claude Code lists the nativ MCP server but it is not connected: ${line.trim()}` });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@njeybe/nativ",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Role-based multi-agent workflow harness: Claude Code by default, other AI agents pluggable",
   "type": "module",
   "main": "dist/index.js",
@@ -24,14 +24,6 @@
     "start": "node bin/cli.js",
     "test": "node tests/test-task-router.mjs && node tests/test-contract-generator.mjs && node tests/test-verify-gatekeeper.mjs && node tests/test-mcp-server.mjs && node tests/test-data-studio.mjs && node tests/test-fragmented-env.mjs && node tests/test-env-example-detection.mjs && node tests/test-contract-governor.mjs && node tests/test-worktree-lifecycle.mjs && node tests/test-agent-supervisor.mjs && node tests/test-concurrency-locks.mjs && node tests/test-telemetry-engine.mjs && node tests/test-benchmark-suite.mjs && node tests/test-providers.mjs && node tests/test-tier1-liaison.mjs && node tests/test-enforcement.mjs && node tests/test-setup-doctor.mjs && node tests/test-update.mjs && node tests/test-validate.mjs && node tests/test-plugin-manifest.mjs && node tests/test-v2-e2e.mjs && npx tsx tests/test-studio-pipeline-api.mjs && npx tsx tests/test-studio-light-ui.mjs"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/njeybe/nativ.git"
-  },
-  "homepage": "https://github.com/njeybe/nativ#readme",
-  "bugs": {
-    "url": "https://github.com/njeybe/nativ/issues"
-  },
   "keywords": [
     "ai",
     "agent",

package/plugin/.claude-plugin/plugin.json

@@ -1,13 +1,11 @@
 {
   "name": "nativ",
   "displayName": "nativ",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Role-based multi-agent workflow for Claude Code: architect, worker and verifier agents, task-scope enforcement, and the nativ MCP server.",
   "author": {
     "name": "JB Natividad"
   },
-  "homepage": "https://github.com/njeybe/nativ",
-  "repository": "https://github.com/njeybe/nativ",
   "license": "MIT",
   "keywords": [
     "multi-agent",