docs: remove unpublished npm paths and align binary/docs with git install

Author: Abiola Bakare

CHANGELOG.md

@@ -2,10 +2,13 @@
 
 ## 2.1.1
 
-- packaged Pi-memory v2 for public install (npm/bun/pi package)
+- packaged Pi-Memory v2 for public git install via Pi (`pi install git:...`)
 - added setup/doctor/smoke scripts
 - bundled extension, skill, and prompts
 - documented install, architecture, extension lifecycle, and agent usage
+- clarified three-layer memory model and JSONL-vs-memory positioning
+- added manual compaction controls documentation (`/compact-threshold`, `/compact`)
+- aligned binary version output with package version (`2.1.1`)
 - improved packaged extension binary resolution order:
   1) `PI_MEMORY_BIN`
   2) `~/.pi/memory/pi-memory`

README.md

@@ -74,57 +74,39 @@ This installs all Pi components declared in `package.json`:
 curl -fsSL https://raw.githubusercontent.com/SiliconState/Pi-Memory/main/scripts/install.sh | bash
 ```
 
-### npm package (after publish)
-
-```bash
-pi install npm:@siliconstate/pi-memory
-```
-
 Then verify:
 
 ```bash
 ~/.pi/memory/pi-memory --version
 ```
 
-### npm global (after npm publish)
-
-```bash
-npm i -g @siliconstate/pi-memory
-pi-memory-setup
-pi-memory-doctor
-```
-
-### bun global (after npm publish)
-
-```bash
-bun add -g @siliconstate/pi-memory
-pi-memory-setup
-pi-memory-doctor
-```
-
-> If native compile is skipped during install, run `pi-memory-setup` manually.
+> If native compile is skipped during install, rerun the curl installer or follow manual compile troubleshooting in `docs/INSTALL.md`.
+>
+> npm/bun publish is planned but not currently live. For now, use the git install (or curl wrapper) above.
 
 ---
 
 ## Quick Start
 
 ```bash
+BIN="${PI_MEMORY_BIN:-$HOME/.pi/memory/pi-memory}"
+
 # initialize MEMORY.md markers
-pi-memory init
+"$BIN" init
 
 # log memory records
-pi-memory log decision "Use SQLite for memory" --choice "Single local DB" --rationale "Simple + durable"
-pi-memory log finding "Extension hooks run at session_shutdown" --category architecture --confidence verified
-pi-memory log lesson "Forgot to sync MEMORY.md" --fix "Run sync before compaction"
-pi-memory log entity "SessionManager" --type concept --description "Pi session tree manager"
+"$BIN" log decision "Use SQLite for memory" --choice "Single local DB" --rationale "Simple + durable"
+"$BIN" log finding "Extension hooks run at session_shutdown" --category architecture --confidence verified
+"$BIN" log lesson "Forgot to sync MEMORY.md" --fix "Run sync before compaction"
+"$BIN" log entity "SessionManager" --type concept --description "Pi session tree manager"
 
 # inspect
-pi-memory query --limit 20
-pi-memory search "compaction"
-pi-memory state <project>
+"$BIN" query --limit 20
+"$BIN" search "compaction"
+"$BIN" state <project>
 
 # sync docs
-pi-memory sync MEMORY.md --limit 15
+"$BIN" sync MEMORY.md --limit 15
 ```
 
 ---

docs/AGENT-USAGE.md

@@ -2,6 +2,8 @@
 
 This guide is for agent authors/operators using Pi-Memory in Pi workflows.
 
+If `pi-memory` is not on PATH in your environment, call it explicitly as `~/.pi/memory/pi-memory`.
+
 ## Core operating rules
 
 1. Log decisions when choices are made, not after the session ends.

docs/INSTALL.md

@@ -28,27 +28,11 @@ curl -fsSL https://raw.githubusercontent.com/SiliconState/Pi-Memory/main/scripts
 
 The installer script runs `pi install ...` and falls back to direct compile if needed.
 
-## Option C: Pi CLI install from npm (after publish)
+## npm/bun status
 
-```bash
-pi install npm:@siliconstate/pi-memory
-```
-
-## Option D: npm global install (after npm publish)
-
-```bash
-npm i -g @siliconstate/pi-memory
-pi-memory-setup
-pi-memory-doctor
-```
+npm/bun publish is planned but not currently live.
 
-## Option E: bun global install (after npm publish)
-
-```bash
-bun add -g @siliconstate/pi-memory
-pi-memory-setup
-pi-memory-doctor
-```
+Use Option A (`pi install git:...`) or Option B (curl installer) for now.
 
 ## Native build output
 
@@ -74,10 +58,21 @@ export PI_MEMORY_BIN=/custom/path/pi-memory
 
 ### `Failed to compile pi-memory`
 
-Install build prerequisites and rerun:
+Install build prerequisites and rerun the installer:
 
 ```bash
-pi-memory-setup
+pi install git:github.com/SiliconState/Pi-Memory
+```
+
+If needed, compile manually:
+
+```bash
+CC_BIN="${CC:-cc}"
+SRC="$HOME/.pi/agent/git/github.com/SiliconState/Pi-Memory/native/pi-memory.c"
+[ -f "$SRC" ] || SRC="$HOME/.pi/git/github.com/SiliconState/Pi-Memory/native/pi-memory.c"
+mkdir -p "$HOME/.pi/memory"
+"$CC_BIN" -Wall -Wextra -Wpedantic -O2 -std=c11 -o "$HOME/.pi/memory/pi-memory" "$SRC" -lsqlite3
+chmod +x "$HOME/.pi/memory/pi-memory"
 ```
 
 ### Extension can’t find binary
@@ -90,14 +85,7 @@ export PI_MEMORY_BIN="$HOME/.pi/memory/pi-memory"
 
 ### Check health quickly
 
-Always works:
-
 ```bash
 ~/.pi/memory/pi-memory --version
-```
-
-If installed via npm/bun global, you can also run:
-
-```bash
-pi-memory-doctor
+~/.pi/memory/pi-memory help
 ```

native/pi-memory.c

@@ -50,7 +50,7 @@
 #include <sys/types.h>
 #include <unistd.h>
 
-#define VERSION       "2.1.0"
+#define VERSION       "2.1.1"
 #define MAX_PATH      1024
 #define MAX_BUF       8192
 #define MAX_JSON_VAL  65536