@vclawhub/vclaw 0.2.1 → 0.2.3

package/README.md

@@ -157,7 +157,7 @@ Detects your OS/arch, downloads NATS server, pi.dev CLI, vclaw binary, and the `
 ### Option B: From source
 
 ```bash
-git clone https://github.com/VillageCity/vclaw-agent.git
+git clone https://github.com/chatek/vclaw-agent.git
 cd vclaw-agent
 ./install.sh
 ```
@@ -217,9 +217,25 @@ vclaw-agent/
 │   └── nats-leaf.conf             # Canonical NATS leaf-node config
 ├── scripts/
 │   └── vchat-onboard.sh           # vchat.email network join
-├── .github/workflows/
-│   └── publish.yml                # CI/CD — Bun build + publish
+├── deploy/                        # OS provisioning roles
+│   └── roles/
+│       ├── 01-nats-leaf.sh        # NATS leaf node setup
+│       ├── 02-pi-agent.sh         # Pi Agent + skills
+│       ├── 03-pi-web.sh           # PI WEB + session daemon
+│       └── 07-vclawos-agent.sh    # @vclawos/agent build & link
+├── vendors/
+│   ├── pi/                        # pi-mono monorepo (vendored submodule)
+│   ├── pi-web/                    # PI WEB (vendored submodule)
+│   ├── nats-s3/                   # NATS S3 storage plugin
+│   └── synadia-nats-pi-channel/   # @synadia-ai/nats-pi-channel (vendored tarball)
+├── vclaw-pkg/                     # @vclawos/* npm packages
+│   └── packages/
+│       ├── agent/                 # @vclawos/agent runtime
+│       ├── pi-mono/               # @vclawos/pi-mono wrapper
+│       └── pi-web/                # @vclawos/pi-web wrapper
 ├── .pi/agent/skills/              # 9 agent skill packages
+├── .github/workflows/
+│   └── publish.yml                # CI/CD — Bun + pnpm parallel publish
 └── docs/
     ├── NODES_members.md           # Node inventory & deployment profiles
     ├── archive/                   # Archived reference docs
@@ -234,33 +250,64 @@ vclaw-agent/
 
 ## Publishing to npm
 
-Publish `@vclawhub/vclaw` to npmjs.com with a single command:
+Two groups of packages publish to the npm registry:
+
+| Package | Build Tool | How to Install |
+|---------|-----------|----------------|
+| **`@vclawhub/vclaw`** (root — wrapper CLI) | **Bun** `bun build --target=bun` | `bunx @vclawhub/vclaw install` |
+| **`@vclawos/agent`**, `pi-mono`, `pi-web` (vclaw-pkg/) | **pnpm** (TypeScript → tsc) | `npm install @vclawos/agent` |
+
+A publish token is stored in `.env.d/vclawhub.env` under `VCLAW_NPM_TOKEN`.
+
+### Local publish: wrapper CLI (Bun)
 
 ```bash
+# Build and publish the root wrapper package
 source .env.d/vclawhub.env
 export NPM_TOKEN="${VCLAW_NPM_TOKEN}"
-bun run build
+bun run build              # bun build ./src/cli.ts → dist/cli.js
 bun publish --access public
 ```
 
-Then anyone can use it:
+Users can then install and run it in one step:
 
 ```bash
+# Global install
+bun install -g @vclawhub/vclaw
+vclaw-agent up
+
+# Or direct execution (no install)
 bunx @vclawhub/vclaw install
-bunx @vclawhub/vclaw up
 bunx @vclawhub/vclaw up --onboard you@email.com
 ```
 
+### Local publish: vclaw-pkg packages (pnpm)
+
+```bash
+cd vclaw-pkg
+source ../.env.d/vclawhub.env
+export NPM_TOKEN="${VCLAW_NPM_TOKEN}"
+pnpm publish:all
+```
+
 ### CI/CD — GitHub Actions
 
-The workflow at `.github/workflows/publish.yml` runs automatically when a `v*` tag is pushed:
+The workflow at `.github/workflows/publish.yml` runs automatically when a `v*` tag is pushed. It publishes **both** groups in parallel:
 
 ```mermaid
 graph LR
     A[git tag v0.1.0] --> B[Workflow triggers]
-    B --> C[Bun build src/cli.ts]
-    C --> D[publish @vclawhub/vclaw]
-    D --> E[GitHub Release with changelog]
+    B --> C[publish-root job]
+    B --> D[publish-packages job]
+    C --> E[Bun build src/cli.ts]
+    C --> F[publish @vclawhub/vclaw]
+    D --> G[pnpm build all]
+    D --> H[pnpm test]
+    D --> I[publish @vclawos/*]
+    E --> J[create-release job]
+    F --> J
+    I --> J
+    J --> K[GitHub Release with changelog]
 ```
 
 #### Step-by-step: Add the secret to GitHub
@@ -271,20 +318,24 @@ graph LR
 4. **Value:** the automation token from `.env.d/vclawhub.env`
 5. Click **Add secret**.
 
+That's it — the workflow reads it automatically.
+
 #### To trigger a publish
 
 ```bash
+# Tag the current commit and push
 git tag v0.1.0
 git push origin v0.1.0
 ```
 
 The workflow then:
-1. Bun-bundles `src/cli.ts` → `dist/cli.js`, publishes `@vclawhub/vclaw`
-2. Creates a GitHub Release with auto-generated notes
+1. **publish-root** — Bun-bundles `src/cli.ts` → `dist/cli.js`, publishes `@vclawhub/vclaw`
+2. **publish-packages** — pnpm installs, builds, tests, and publishes all `@vclawos/*` packages
+3. **create-release** — creates a GitHub Release with auto-generated notes (runs after both succeed)
 
 #### Manual trigger
 
-Run the workflow manually from the GitHub Actions UI, entering a version tag.
+You can also run the workflow manually from the GitHub Actions UI by selecting **Run workflow** and entering a version tag.
 
 ### Skill: bun-registry-publish
 
@@ -301,7 +352,9 @@ Pi Agent has a built-in skill (`~/.pi/agent/skills/bun-registry-publish/SKILL.md
 | NATS Server | [https://nats.io](https://nats.io) |
 | vchat.email | [https://vchat.email](https://vchat.email) |
 | @vchatemail/agent (npm) | [https://www.npmjs.com/package/@vchatemail/agent](https://www.npmjs.com/package/@vchatemail/agent) |
-| @vclawhub/vclaw (npm) | [https://www.npmjs.com/package/@vclawhub/vclaw](https://www.npmjs.com/package/@vclawhub/vclaw) |
+| @vclawos/agent (npm) | [https://www.npmjs.com/package/@vclawos/agent](https://www.npmjs.com/package/@vclawos/agent) |
+| @synadia-ai/nats-pi-channel (pi.dev) | [https://pi.dev/packages/@synadia-ai/nats-pi-channel](https://pi.dev/packages/@synadia-ai/nats-pi-channel) |
+| @synadia-ai/nats-pi-channel (GitHub) | [https://github.com/synadia-ai/nats-pi-channel](https://github.com/synadia-ai/nats-pi-channel) |
 | VClaw Hub Install | `https://vclawhub.com/install` (serves `install.sh`) |
 
 ---

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@vclawhub/vclaw",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "private": false,
   "type": "module",
-  "description": "VClaw Hub — one-command setup for pi.dev + pi-web.dev + NATS leaf node + vchat.email network",
+  "description": "VClaw Agent — one-command setup for pi.dev + pi-web.dev + NATS leaf node + vchat.email network",
   "keywords": [
     "pi-agent",
     "pi-web",
@@ -17,14 +17,14 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/VillageCity/vclaw-agent.git"
+    "url": "git+https://github.com/chatek/vclaw-agent.git"
   },
   "bugs": {
-    "url": "https://github.com/VillageCity/vclaw-agent/issues"
+    "url": "https://github.com/chatek/vclaw-agent/issues"
   },
   "homepage": "https://vclawhub.com",
   "bin": {
-    "vclaw": "dist/cli.js"
+    "vclaw": "./dist/cli.js"
   },
   "files": [
     "dist/cli.js",
@@ -35,11 +35,6 @@
   ],
   "scripts": {
     "build": "bun build ./src/cli.ts --target=bun --outdir=dist",
-    "compile:darwin-arm64": "bun build --compile --target=bun-darwin-arm64 ./src/cli.ts --outfile=dist/vclaw-darwin-arm64",
-    "compile:darwin-x64": "bun build --compile --target=bun-darwin-x64 ./src/cli.ts --outfile=dist/vclaw-darwin-x64",
-    "compile:linux-x64": "bun build --compile --target=bun-linux-x64 ./src/cli.ts --outfile=dist/vclaw-linux-x64",
-    "compile:linux-arm64": "bun build --compile --target=bun-linux-arm64 ./src/cli.ts --outfile=dist/vclaw-linux-arm64",
-    "compile:all": "bun run compile:darwin-arm64 && bun run compile:darwin-x64 && bun run compile:linux-x64 && bun run compile:linux-arm64",
     "dev": "bun --watch ./src/cli.ts",
     "prepublishOnly": "bun run build",
     "start": "bun run ./src/cli.ts"