@vclawhub/vclaw 0.2.1 → 0.2.4

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/dist/cli.js

@@ -1,95 +1,16 @@
-#!/usr/bin/env bun
-// @bun
+#!/usr/bin/env node
+// vclaw — VClaw Hub CLI wrapper
+// Detects Bun at runtime, spawns the real CLI.
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
 
-// src/cli.ts
-var {$ } = globalThis.Bun;
-var PROJECT_ROOT = import.meta.dirname + "/..";
-var HELP = `
-VClaw Agent \u2014 Local Agentic Mesh Wrapper
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+const bunPath = join(__dirname, "cli.bun.ts");
 
-Usage:
-  bunx @vclawhub/vclaw install            Install the full stack
-  bunx @vclawhub/vclaw up                 Launch NATS + pi-web.dev
-  bunx @vclawhub/vclaw up --onboard <email>  Launch + join vchat.email
-  bunx @vclawhub/vclaw up --uninstall       Remove everything
-  bunx @vclawhub/vclaw onboard <email>    Join the vchat.email network
-  bunx @vclawhub/vclaw help               Show this message
-
-Examples:
-  bunx @vclawhub/vclaw install
-  bunx @vclawhub/vclaw up
-  bunx @vclawhub/vclaw up --onboard alice@example.com
-`;
-var cmd = process.argv[2]?.toLowerCase();
-switch (cmd) {
-  case "install": {
-    const localScript = `${PROJECT_ROOT}/install.sh`;
-    const { exitCode } = await $`test -f ${localScript}`.quiet();
-    if (exitCode === 0) {
-      console.log("\uD83D\uDCE6 Running local install.sh...");
-      await $`bash ${localScript}`;
-    } else {
-      console.log("\uD83D\uDCE6 Fetching installer from vclawhub.com...");
-      await $`curl -fsSL https://vclawhub.com/install | sh`;
-    }
-    break;
-  }
-  case "up": {
-    const onboardFlag = process.argv.indexOf("--onboard");
-    let email = "";
-    if (onboardFlag !== -1 && process.argv[onboardFlag + 1]) {
-      email = process.argv[onboardFlag + 1];
-    }
-    const localScript = `${PROJECT_ROOT}/vclaw-up`;
-    const uninstallFlag = process.argv.indexOf("--uninstall");
-    const { exitCode } = await $`test -f ${localScript}`.quiet();
-    if (exitCode === 0 && uninstallFlag !== -1) {
-      console.log("\uD83E\uDDF9 Uninstalling VClaw Hub...");
-      await $`bash ${localScript} --uninstall`;
-      process.exit(0);
-    } else if (exitCode === 0 && email) {
-      console.log("\uD83D\uDE80 Launching stack and joining vchat.email network...");
-      await $`bash ${localScript} --onboard ${email}`;
-    } else if (exitCode === 0) {
-      console.log("\uD83D\uDE80 Launching local agentic mesh...");
-      await $`bash ${localScript}`;
-    } else if (email) {
-      console.log("\uD83D\uDE80 Starting NATS server...");
-      const natsServer = Bun.which("nats-server");
-      if (!natsServer) {
-        console.error("\u274C nats-server not found. Run 'vclaw-agent install' first.");
-        process.exit(1);
-      }
-      const dataDir = `${process.env.HOME}/.local/share/vclaw`;
-      await $`mkdir -p ${dataDir}/nats-data`;
-      await $`nats-server --port 4222 --jetstream --store_dir ${dataDir}/nats-data > ${dataDir}/nats-server.log 2>&1 &`.quiet();
-      console.log("  \u2714 NATS server started on 127.0.0.1:4222");
-      const piUrl = "https://pi-web.dev/?connect=127.0.0.1:4222";
-      await $`bunx open ${piUrl}`.quiet().catch(() => {});
-      console.log(`  \u2714 Browser opened to ${piUrl}`);
-      console.log(`
-\uD83D\uDCE1 Onboarding to vchat.email...`);
-      await $`bunx @vchatemail/agent ensoul --email ${email}`;
-    } else {
-      console.error("\u274C vclaw-up not found. Run 'vclaw-agent install' first.");
-      process.exit(1);
-    }
-    break;
-  }
-  case "onboard": {
-    const email = process.argv[3];
-    if (!email) {
-      console.error("\u274C Usage: bunx @vclawhub/vclaw onboard <email>");
-      process.exit(1);
-    }
-    console.log(`\uD83D\uDCE1 Joining vchat.email network as ${email}...`);
-    await $`bunx @vchatemail/agent ensoul --email ${email}`;
-    break;
-  }
-  case "help":
-  case "--help":
-  case "-h":
-  default:
-    console.log(HELP);
-    break;
-}
+// Try bun first, then bunx
+const { status } = spawnSync("bun", [bunPath, ...args], {
+  stdio: "inherit",
+});
+process.exit(status ?? 1);

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@vclawhub/vclaw",
-  "version": "0.2.1",
+  "version": "0.2.4",
   "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,10 +17,10 @@
   "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": {
@@ -34,15 +34,15 @@
     "scripts/"
   ],
   "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",
+    "build": "bun build ./src/cli.bun.ts --target=bun --outfile=dist/cli.bun.js && cp src/cli.ts dist/cli.js",
+    "compile:darwin-arm64": "bun build --compile --target=bun-darwin-arm64 ./src/cli.bun.ts --outfile=dist/vclaw-darwin-arm64",
+    "compile:darwin-x64": "bun build --compile --target=bun-darwin-x64 ./src/cli.bun.ts --outfile=dist/vclaw-darwin-x64",
+    "compile:linux-x64": "bun build --compile --target=bun-linux-x64 ./src/cli.bun.ts --outfile=dist/vclaw-linux-x64",
+    "compile:linux-arm64": "bun build --compile --target=bun-linux-arm64 ./src/cli.bun.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",
+    "dev": "bun --watch ./src/cli.bun.ts",
     "prepublishOnly": "bun run build",
-    "start": "bun run ./src/cli.ts"
+    "start": "bun run ./src/cli.bun.ts"
   },
   "engines": {
     "bun": ">=1.2"