@vonneollc/knbase 0.1.0 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vonneollc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -35,20 +35,14 @@ System artifacts live in `.knbase/` (`config.json`, `index.json`,
 
 ## Quick setup (recommended, no clone)
 
-Once `knbase` is published to npm (see [Publishing to npm](#publishing-to-npm)),
-you can use it without cloning this repo.
-
-Install it once, globally:
-
-```bash
-npm install -g knbase
-```
+The package is published as [`@vonneollc/knbase`](https://www.npmjs.com/package/@vonneollc/knbase),
+so you can use it without cloning this repo.
 
 **1. Initialize governance in your project:**
 
 ```bash
 cd /path/to/your/project
-knbase init
+npx -y --package @vonneollc/knbase knbase init
 ```
 
 **2. Register the MCP server** with your agent. Cursor example
@@ -58,28 +52,39 @@ knbase init
 {
   "mcpServers": {
     "knbase": {
-      "command": "knbase-mcp",
+      "command": "npx",
+      "args": ["-y", "--package", "@vonneollc/knbase", "knbase-mcp"],
       "env": { "KNBASE_ROOT": "/absolute/path/to/your/project" }
     }
   }
 }
 ```
 
-Prefer not to install globally? Use `npx` instead — no install step at all:
+> **macOS / GUI apps:** apps like Cursor often don't inherit your shell `PATH`,
+> so `npx` (or `knbase-mcp`) may not be found. If the server fails to start, use
+> an absolute path for `command`. Find it with `which npx` (e.g.
+> `/opt/homebrew/bin/npx` for Homebrew Node), then set
+> `"command": "/opt/homebrew/bin/npx"`.
+
+Prefer a global install? Then the bins are available directly:
+
+```bash
+npm install -g @vonneollc/knbase
+which knbase-mcp     # e.g. /opt/homebrew/bin/knbase-mcp
+```
 
 ```json
 {
   "mcpServers": {
     "knbase": {
-      "command": "npx",
-      "args": ["-y", "--package", "knbase", "knbase-mcp"],
+      "command": "/opt/homebrew/bin/knbase-mcp",
       "env": { "KNBASE_ROOT": "/absolute/path/to/your/project" }
     }
   }
 }
 ```
 
-…and run CLI commands with `npx knbase <command>` (e.g. `npx knbase init`).
+…and run CLI commands with `knbase <command>` (e.g. `knbase init`).
 
 `KNBASE_ROOT` is optional; if omitted the server resolves the project root by
 walking up from the working directory (looking for `.knbase/` or `.git`). Each
@@ -177,6 +182,14 @@ npm run dev:mcp     # run the MCP server with tsx
 npm run dev:cli -- status
 ```
 
+## Contributing
+
+Contributions are welcome from everyone. Fork the repo, create a branch, and
+open a pull request. Bug reports and feature ideas via issues are equally
+appreciated. By contributing you agree that your contributions are licensed
+under the project's MIT license.
+
 ## License
 
-MIT
+Released under the [MIT License](./LICENSE) — free to use, modify, distribute,
+and build upon, including commercially.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vonneollc/knbase",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agent-agnostic AI project governance and memory system. Forces AI agents to read governance docs before acting, bootstraps them if missing, forces updates after each task, and maintains a combined mind map and activity log.",
   "type": "module",
   "bin": {