@ao_zorin/zocket 1.1.0 → 1.3.0

package/docs/AI_AUTODEPLOY.md

@@ -6,22 +6,22 @@ This is the file you can send to an AI coding agent so it can deploy zocket end-
 
 If this repo is already present locally:
 ```bash
-python3 scripts/ai-autodeploy.py --repo-url https://github.com/your-org/zocket.git --repo-ref main
+bash scripts/install-zocket.sh --source local
 ```
 
-If only the file is available, the script will clone the repo and run the platform installer.
+If only the file is available, the script will fetch and run the platform installer:
+```bash
+curl -fsSL https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.sh | bash
+```
 
 ## Agent task prompt (copy/paste)
 
 ```text
 Deploy zocket on this machine with secure defaults:
 1) Detect OS and shell.
-2) Run scripts/ai-autodeploy.py with:
-   --lang en
-   --web-port 18001
-   --mcp-port 18002
-   --mcp-mode metadata
-   --autostart user (Linux/macOS) or enabled startup task (Windows)
+2) Run installer:
+   - Linux/macOS: curl -fsSL https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.sh | bash
+   - Windows: irm https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.ps1 | iex
 3) Verify:
    - web panel on http://127.0.0.1:18001
    - MCP SSE endpoint on http://127.0.0.1:18002/sse (Claude Code)
@@ -33,11 +33,7 @@ Deploy zocket on this machine with secure defaults:
 ## Optional production profile (Linux system services)
 
 ```bash
-python3 scripts/ai-autodeploy.py \
-  --repo-url https://github.com/your-org/zocket.git \
-  --repo-ref main \
-  --autostart system \
-  --zocket-home /var/lib/zocket
+bash scripts/install-zocket.sh --source git --repo-url https://github.com/aozorin/zocket.git --repo-ref main --autostart system --zocket-home /var/lib/zocket
 ```
 
 ## Post-deploy checklist for agent

package/docs/GIT_NPM_RELEASE.md

@@ -1,4 +1,4 @@
-# Git + npm + Python Release Guide
+# Git + npm Release Guide
 
 ## 1) Initialize git project
 
@@ -17,15 +17,7 @@ git push -u origin main
 bash scripts/release-check.sh
 ```
 
-## 3) Publish Python package (PyPI)
-
-```bash
-python3 -m pip install --upgrade build twine
-python3 -m build
-twine upload dist/*
-```
-
-## 4) Publish npm package
+## 3) Publish npm package
 
 Update metadata in `package.json`:
 - `name`
@@ -39,15 +31,14 @@ npm login
 npm publish --access public
 ```
 
-## 5) Tag release
+## 4) Tag release
 
 ```bash
 git tag -a v1.0.0 -m "zocket v1.0.0"
 git push origin v1.0.0
 ```
 
-## 6) Optional GitHub Release artifacts
+## 5) Optional GitHub Release artifacts
 
 Upload:
-- Python wheels/sdist from `dist/`
 - npm package tarball from `npm pack`

package/docs/INSTALL.md

@@ -1,16 +1,20 @@
 # Install Guide (Windows / Linux / macOS)
 
-This guide installs **zocket** as:
+This guide installs **zocket** (Node.js) as:
 - local web panel on `127.0.0.1:18001`
 - MCP SSE server on `127.0.0.1:18002/sse` (Claude Code)
 - MCP streamable HTTP server on `127.0.0.1:18003/mcp` (Codex)
-- optional MCP stdio server for local CLI use
 
 ## 1) Quick Install (recommended)
 
 ### Linux and macOS
 ```bash
-curl -fsSL https://raw.githubusercontent.com/your-org/zocket/main/scripts/install-zocket.sh | bash
+curl -fsSL https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.sh | bash
+```
+
+MCP-only (no web panel):
+```bash
+curl -fsSL https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.sh | bash -s -- --no-web
 ```
 
 If you run from a local clone:
@@ -20,7 +24,14 @@ bash scripts/install-zocket.sh --source local
 
 ### Windows (PowerShell)
 ```powershell
-irm https://raw.githubusercontent.com/your-org/zocket/main/scripts/install-zocket.ps1 | iex
+irm https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.ps1 | iex
+```
+
+MCP-only (no web panel):
+```powershell
+$tmp = "$env:TEMP\\install-zocket.ps1"
+irm https://raw.githubusercontent.com/aozorin/zocket/main/scripts/install-zocket.ps1 -OutFile $tmp
+powershell -ExecutionPolicy Bypass -File $tmp -NoWeb
 ```
 
 If you run from a local clone:
@@ -32,16 +43,15 @@ powershell -ExecutionPolicy Bypass -File .\scripts\install-zocket.ps1 -Source Lo
 
 ### Debian/Ubuntu and Debian-based
 Installer auto-installs:
-- `python3`
-- `python3-venv`
-- `python3-pip`
+- `nodejs`
+- `npm`
 - `git`
 - `curl`
 
 Equivalent manual install:
 ```bash
 sudo apt-get update
-sudo apt-get install -y python3 python3-venv python3-pip git curl
+sudo apt-get install -y nodejs npm git curl
 ```
 
 ### Other Linux distros
@@ -52,22 +62,21 @@ Installer supports:
 - `apk` (Alpine)
 
 If your distro is unsupported, install manually:
-- Python `>=3.10`
-- `pip`
-- `venv`
+- Node.js `>=18`
+- `npm`
 - `git`
 
 ## 3) macOS details
 
 Installer uses Homebrew when dependencies are missing:
 ```bash
-brew install python git curl
+brew install node git curl
 ```
 
 ## 4) Windows details
 
 Requirements:
-- Python 3.10+ (recommended from `python.org` or `winget`)
+- Node.js 18+ (recommended from `nodejs.org` or `winget`)
 - Git for Windows
 
 Autostart (enabled by default):
@@ -75,10 +84,8 @@ Autostart (enabled by default):
 powershell -ExecutionPolicy Bypass -File .\scripts\install-zocket.ps1
 ```
 
-This creates scheduled tasks:
-- `ZocketWeb`
-- `ZocketMcpSse`
-- `ZocketMcpStreamable`
+This creates scheduled task:
+- `Zocket`
 
 Disable autostart:
 ```powershell
@@ -87,128 +94,58 @@ powershell -ExecutionPolicy Bypass -File .\scripts\install-zocket.ps1 -EnableAut
 
 ## 5) NPM package usage
 
-This repo now includes an npm wrapper package.
-
 Global install from npm:
 ```bash
-npm i -g @zocket/cli
-zocket setup
+npm i -g @ao_zorin/zocket
 ```
 
-Or install from your git repo (example):
-```bash
-npm i -g github:your-org/zocket
-```
-
-First-run setup:
+Then use normal CLI:
 ```bash
-zocket setup
+zocket init
+zocket start --host 127.0.0.1 --web-port 18001 --mcp-port 18002 --mcp-stream-port 18003 --mode admin
 ```
 
-Then use normal CLI:
+MCP-only (no web panel):
 ```bash
-zocket init
-zocket web --host 127.0.0.1 --port 18001
-zocket mcp --transport sse --mode metadata --host 127.0.0.1 --port 18002
-zocket mcp --transport streamable-http --mode metadata --host 127.0.0.1 --port 18003
+zocket server --host 127.0.0.1 --mcp-port 18002 --mcp-stream-port 18003 --mode admin
 ```
 
 ## 6) Systemd hardening on Linux (production)
 
 If you install with `--autostart system`, the installer creates and enables:
-- `zocket-web.service` (web panel on 18001)
-- `zocket-mcp-sse.service` (Claude Code, 18002)
-- `zocket-mcp-http.service` (Codex, 18003)
+- `zocket.service` (web + SSE + streamable HTTP)
 
 Check:
 ```bash
-systemctl status zocket-web.service --no-pager
-systemctl status zocket-mcp-sse.service --no-pager
-systemctl status zocket-mcp-http.service --no-pager
+systemctl status zocket.service --no-pager
 ```
 
 ### Linux user-level autostart (no root)
 ```bash
-systemctl --user enable --now zocket-web.service
-systemctl --user enable --now zocket-mcp-sse.service
-systemctl --user enable --now zocket-mcp-http.service
-systemctl --user status zocket-web.service --no-pager
-systemctl --user status zocket-mcp-sse.service --no-pager
-systemctl --user status zocket-mcp-http.service --no-pager
+systemctl --user enable --now zocket.service
+systemctl --user status zocket.service --no-pager
 ```
 
 ### macOS launchd autostart (installed by script)
 Installer creates and loads:
-- `~/Library/LaunchAgents/dev.zocket.web.plist`
-- `~/Library/LaunchAgents/dev.zocket.mcp-sse.plist`
-- `~/Library/LaunchAgents/dev.zocket.mcp-streamable.plist`
-
-If you need to install manually, use:
-
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-  <dict>
-    <key>Label</key><string>dev.zocket.web</string>
-    <key>ProgramArguments</key>
-    <array>
-      <string>/Users/YOUR_USER/.local/share/zocket/venv/bin/python3</string>
-      <string>-m</string><string>zocket</string>
-      <string>web</string><string>--host</string><string>127.0.0.1</string>
-      <string>--port</string><string>18001</string>
-    </array>
-    <key>EnvironmentVariables</key>
-    <dict>
-      <key>ZOCKET_HOME</key><string>/Users/YOUR_USER/.zocket</string>
-    </dict>
-    <key>RunAtLoad</key><true/>
-    <key>KeepAlive</key><true/>
-  </dict>
-</plist>
-```
-
-SSE MCP (`dev.zocket.mcp-sse.plist`):
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-  <dict>
-    <key>Label</key><string>dev.zocket.mcp-sse</string>
-    <key>ProgramArguments</key>
-    <array>
-      <string>/Users/YOUR_USER/.local/share/zocket/venv/bin/python3</string>
-      <string>-m</string><string>zocket</string>
-      <string>mcp</string><string>--transport</string><string>sse</string>
-      <string>--mode</string><string>metadata</string>
-      <string>--host</string><string>127.0.0.1</string>
-      <string>--port</string><string>18002</string>
-    </array>
-    <key>EnvironmentVariables</key>
-    <dict>
-      <key>ZOCKET_HOME</key><string>/Users/YOUR_USER/.zocket</string>
-    </dict>
-    <key>RunAtLoad</key><true/>
-    <key>KeepAlive</key><true/>
-  </dict>
-</plist>
-```
+- `~/Library/LaunchAgents/dev.zocket.plist`
 
-Streamable HTTP MCP (`dev.zocket.mcp-streamable.plist`):
+Manual example:
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
   <dict>
-    <key>Label</key><string>dev.zocket.mcp-streamable</string>
+    <key>Label</key><string>dev.zocket</string>
     <key>ProgramArguments</key>
     <array>
-      <string>/Users/YOUR_USER/.local/share/zocket/venv/bin/python3</string>
-      <string>-m</string><string>zocket</string>
-      <string>mcp</string><string>--transport</string><string>streamable-http</string>
-      <string>--mode</string><string>metadata</string>
+      <string>/usr/local/bin/zocket</string>
+      <string>start</string>
       <string>--host</string><string>127.0.0.1</string>
-      <string>--port</string><string>18003</string>
+      <string>--web-port</string><string>18001</string>
+      <string>--mcp-port</string><string>18002</string>
+      <string>--mcp-stream-port</string><string>18003</string>
+      <string>--mode</string><string>admin</string>
     </array>
     <key>EnvironmentVariables</key>
     <dict>
@@ -220,11 +157,9 @@ Streamable HTTP MCP (`dev.zocket.mcp-streamable.plist`):
 </plist>
 ```
 
-Load services:
+Load service:
 ```bash
-launchctl load ~/Library/LaunchAgents/dev.zocket.web.plist
-launchctl load ~/Library/LaunchAgents/dev.zocket.mcp-sse.plist
-launchctl load ~/Library/LaunchAgents/dev.zocket.mcp-streamable.plist
+launchctl load ~/Library/LaunchAgents/dev.zocket.plist
 ```
 
 ### Windows autostart (Task Scheduler)
@@ -234,13 +169,10 @@ powershell -ExecutionPolicy Bypass -File .\scripts\install-zocket.ps1 -EnableAut
 ```
 
 Or create manually:
-- task `ZocketWeb` on logon
-- task `ZocketMcpSse` on logon
-- task `ZocketMcpStreamable` on logon
-- actions:
-  - `python -m zocket web --host 127.0.0.1 --port 18001`
-  - `python -m zocket mcp --transport sse --mode metadata --host 127.0.0.1 --port 18002`
-  - `python -m zocket mcp --transport streamable-http --mode metadata --host 127.0.0.1 --port 18003`
+- task `Zocket` on logon
+- action:
+  - `zocket start --host 127.0.0.1 --web-port 18001 --mcp-port 18002 --mcp-stream-port 18003 --mode admin`
+  - add `--no-web` for MCP-only
 
 ## 7) First web open
 
@@ -255,5 +187,5 @@ Open `http://127.0.0.1:18001` and choose one:
 curl -I http://127.0.0.1:18001/login
 curl -I http://127.0.0.1:18002/sse
 curl -I http://127.0.0.1:18003/mcp
-zocket mcp --transport stdio --mode metadata
+zocket start --host 127.0.0.1 --web-port 18001 --mcp-port 18002 --mcp-stream-port 18003 --mode admin
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ao_zorin/zocket",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Local encrypted vault + web panel + MCP server for AI agent workflows",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
     "@anthropic-ai/sdk": "^0.78.0",
     "@hono/node-server": "^1.13.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "blessed": "^0.1.81",
     "commander": "^12.0.0",
     "hono": "^4.0.0",
     "proper-lockfile": "^4.1.2",
@@ -33,6 +34,7 @@
   },
   "devDependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
+    "@types/blessed": "^0.1.24",
     "@types/node": "^20.0.0",
     "@types/proper-lockfile": "^4.1.4",
     "js-tiktoken": "^1.0.21",

package/scripts/install-zocket.ps1

@@ -1,9 +1,8 @@
 Param(
-  [ValidateSet("Auto", "Local", "Git", "PyPI")]
+  [ValidateSet("Auto", "Local", "Git", "Npm")]
   [string]$Source = "Auto",
-  [string]$RepoUrl = "https://github.com/your-org/zocket.git",
+  [string]$RepoUrl = "https://github.com/aozorin/zocket.git",
   [string]$RepoRef = "main",
-  [string]$InstallRoot = "$env:LOCALAPPDATA\zocket",
   [string]$ZocketHome = "$env:USERPROFILE\.zocket",
   [ValidateSet("en", "ru")]
   [string]$Lang = "en",
@@ -11,106 +10,71 @@ Param(
   [int]$McpPort = 18002,
   [int]$McpStreamPort = 18003,
   [ValidateSet("metadata", "admin")]
-  [string]$McpMode = "metadata",
-  [bool]$EnableAutostart = $true
+  [string]$McpMode = "admin",
+  [bool]$EnableAutostart = $true,
+  [switch]$NoWeb
 )
 
 $ErrorActionPreference = "Stop"
 
-function Resolve-Python {
-  if (Get-Command py -ErrorAction SilentlyContinue) {
-    return @{Cmd = "py"; Prefix = @("-3")}
-  }
-  if (Get-Command python -ErrorAction SilentlyContinue) {
-    return @{Cmd = "python"; Prefix = @()}
+function Ensure-Dir([string]$Path) {
+  if (-not (Test-Path -LiteralPath $Path)) {
+    New-Item -ItemType Directory -Path $Path | Out-Null
   }
-  throw "Python 3.10+ not found. Install Python and rerun."
 }
 
-function Run-Step([string]$Cmd, [string[]]$Args) {
-  & $Cmd @Args
-  if ($LASTEXITCODE -ne 0) {
-    throw "Command failed: $Cmd $($Args -join ' ')"
+function Ensure-Node {
+  if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    throw "Node.js not found. Install Node.js 18+ and rerun."
   }
-}
-
-function Ensure-Dir([string]$Path) {
-  if (-not (Test-Path -LiteralPath $Path)) {
-    New-Item -ItemType Directory -Path $Path | Out-Null
+  if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
+    throw "npm not found. Install Node.js 18+ (includes npm) and rerun."
   }
 }
 
+Ensure-Node
+
 $repoRoot = Split-Path -Parent $PSScriptRoot
 if ($Source -eq "Auto") {
-  if (Test-Path -LiteralPath (Join-Path $repoRoot "pyproject.toml")) {
+  if (Test-Path -LiteralPath (Join-Path $repoRoot "package.json")) {
     $Source = "Local"
   } else {
-    $Source = "Git"
+    $Source = "Npm"
   }
 }
 
-Ensure-Dir $InstallRoot
-$srcDir = Join-Path $InstallRoot "src"
-
-$pkgSource = $null
 if ($Source -eq "Local") {
-  $pkgSource = $repoRoot
+  npm i -g $repoRoot
 } elseif ($Source -eq "Git") {
-  if (Test-Path -LiteralPath (Join-Path $srcDir ".git")) {
-    Run-Step "git" @("-C", $srcDir, "fetch", "--all", "--tags")
-    Run-Step "git" @("-C", $srcDir, "checkout", $RepoRef)
-    Run-Step "git" @("-C", $srcDir, "pull", "--ff-only")
-  } else {
-    if (Test-Path -LiteralPath $srcDir) {
-      Remove-Item -LiteralPath $srcDir -Recurse -Force
-    }
-    Run-Step "git" @("clone", "--depth", "1", "--branch", $RepoRef, $RepoUrl, $srcDir)
-  }
-  $pkgSource = $srcDir
+  npm i -g "git+$RepoUrl#$RepoRef"
 } else {
-  $pkgSource = "zocket"
+  npm i -g @ao_zorin/zocket
 }
 
-$py = Resolve-Python
-$venvDir = Join-Path $InstallRoot "venv"
-$venvPy = Join-Path $venvDir "Scripts\python.exe"
-$zocketExe = Join-Path $venvDir "Scripts\zocket.exe"
-
-Run-Step $py.Cmd ($py.Prefix + @("-m", "venv", $venvDir))
-Run-Step $venvPy @("-m", "pip", "install", "--upgrade", "pip", "setuptools", "wheel")
-
-if ($Source -eq "PyPI") {
-  Run-Step $venvPy @("-m", "pip", "install", "--upgrade", $pkgSource)
-} else {
-  Run-Step $venvPy @("-m", "pip", "install", "--upgrade", $pkgSource)
+$zocketBin = (Get-Command zocket).Source
+if (-not $zocketBin) {
+  throw "zocket binary not found after install"
 }
 
 Ensure-Dir $ZocketHome
 $env:ZOCKET_HOME = $ZocketHome
 
-if (-not (Test-Path -LiteralPath (Join-Path $ZocketHome "vault.enc"))) {
-  Run-Step $zocketExe @("init")
-}
-Run-Step $zocketExe @("config", "set-language", $Lang)
+& $zocketBin init | Out-Null
 
 if ($EnableAutostart) {
-  $webTask = "ZocketWeb"
-  $mcpSseTask = "ZocketMcpSse"
-  $mcpStreamTask = "ZocketMcpStreamable"
-
-  $webCmd = "`"$venvPy`" -m zocket web --host 127.0.0.1 --port $WebPort"
-  $mcpSseCmd = "`"$venvPy`" -m zocket mcp --transport sse --mode $McpMode --host 127.0.0.1 --port $McpPort"
-  $mcpStreamCmd = "`"$venvPy`" -m zocket mcp --transport streamable-http --mode $McpMode --host 127.0.0.1 --port $McpStreamPort"
-
-  schtasks /Create /F /SC ONLOGON /RL LIMITED /TN $webTask /TR $webCmd | Out-Null
-  schtasks /Create /F /SC ONLOGON /RL LIMITED /TN $mcpSseTask /TR $mcpSseCmd | Out-Null
-  schtasks /Create /F /SC ONLOGON /RL LIMITED /TN $mcpStreamTask /TR $mcpStreamCmd | Out-Null
+  $taskName = "Zocket"
+  $cmd = "\"$zocketBin\" start --host 127.0.0.1 --web-port $WebPort --mcp-port $McpPort --mcp-stream-port $McpStreamPort --mode $McpMode"
+  if ($NoWeb) { $cmd = "$cmd --no-web" }
+  schtasks /Create /F /SC ONLOGON /RL LIMITED /TN $taskName /TR $cmd | Out-Null
 }
 
 Write-Output "zocket installed successfully."
-Write-Output "venv: $venvDir"
-Write-Output "zocket: $zocketExe"
+Write-Output "zocket: $zocketBin"
 Write-Output "ZOCKET_HOME=$ZocketHome"
-Write-Output "web panel: http://127.0.0.1:$WebPort"
+if ($NoWeb) {
+  Write-Output "web panel: disabled"
+} else {
+  Write-Output "web panel: http://127.0.0.1:$WebPort"
+}
 Write-Output "mcp sse:   http://127.0.0.1:$McpPort/sse"
 Write-Output "mcp http:  http://127.0.0.1:$McpStreamPort/mcp"