verus-pm 0.1.0

package/README.md

@@ -0,0 +1,243 @@
+<div align="center">
+
+# ⚡ Verus
+
+**AI-powered project management for developer teams**
+
+Task tracking · Documentation · Kanban Board · Time Tracking · Semantic Search  
+All in one command — CLI + Web Dashboard included.
+
+[![npm](https://img.shields.io/npm/v/verus.svg?style=flat-square)](https://www.npmjs.com/package/verus)
+[![Go](https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat-square&logo=go)](https://go.dev)
+[![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
+
+</div>
+
+---
+
+## 📦 Installation
+
+```bash
+npm install -g verus
+```
+
+That's it. CLI + Web Dashboard + MCP Server — all in one package.
+
+### Verify
+
+```bash
+verus version
+```
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# 1. Initialize in your project
+cd your-project
+verus init
+
+# 2. Create tasks
+verus task create "Implement user auth" --priority high --labels "backend,auth"
+
+# 3. Open Web Dashboard
+verus browser
+```
+
+---
+
+## ✨ Features
+
+| Feature | CLI | Web Dashboard |
+|---------|-----|---------------|
+| 🎯 Task Management | `verus task create/edit/list` | Full CRUD + detail sheets |
+| 📋 Kanban Board | `verus board` | Drag-and-drop columns |
+| 📝 Documentation | `verus doc create/view` | Markdown editor + Mermaid |
+| ⏱️ Time Tracking | `verus time start/stop` | Live timer in header |
+| 🔍 Search | `verus search <query>` | ⌘K command palette |
+| 🤖 MCP Server | `verus mcp` | — |
+| 📦 Templates | `verus template run` | Browse + run |
+| 🔄 Imports | `verus import add` | Manage sources |
+| 🛠️ Skills | `verus skill install` | — |
+| 🔐 Offline Search | `verus model download` | — |
+
+---
+
+## 📋 CLI Reference
+
+### Tasks
+
+```bash
+verus task list                              # List all
+verus task list --status in-progress         # Filter
+verus task create "Fix login bug" -p high    # Create
+verus task view abc123                       # View
+verus task edit abc123 --status done         # Update
+verus task edit abc123 --ac "Tests pass"     # Add AC
+verus task delete abc123                     # Delete
+```
+
+### Docs
+
+```bash
+verus doc list                               # List all
+verus doc create "API Design" --folder specs # Create
+verus doc view specs/api-design              # View
+```
+
+### Time Tracking
+
+```bash
+verus time start abc123          # Start timer
+verus time stop abc123           # Stop & record
+verus time status                # Active timers
+verus time add abc123 2h30m      # Add manually
+verus time report                # Summary
+```
+
+### Board, Search & Config
+
+```bash
+verus board                      # Kanban in terminal
+verus search "authentication"    # Full-text search
+verus config get                 # Show config
+verus config set name "My App"   # Set value
+```
+
+### Models, Templates & Imports
+
+```bash
+verus model list                 # Available models
+verus model download all-MiniLM-L6-v2
+verus template list              # List templates
+verus template run component     # Generate code
+verus import add <git-url>       # Import
+verus import sync                # Sync all
+```
+
+### Skills & Sync
+
+```bash
+verus skill list                 # List skills
+verus skill install              # Install built-in skills
+verus sync agents                # Sync to IDE
+verus sync mcp                   # Generate .mcp.json
+```
+
+### Server
+
+```bash
+verus serve                      # Start API (port 3456)
+verus browser                    # Open Web UI
+verus mcp                        # Start MCP server
+```
+
+---
+
+## 🌐 Web Dashboard
+
+Included in the npm package — no separate install needed.
+
+**Pages:** Dashboard · Kanban · Tasks · Docs · Templates · Imports · Config
+
+**Features:** Dark/light mode · ⌘K search · Real-time SSE · Time tracker · Responsive sidebar
+
+---
+
+## 🤖 MCP Integration
+
+```bash
+verus sync mcp    # Generates .mcp.json for your IDE
+```
+
+Or manually add to `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "verus": { "command": "verus", "args": ["mcp"] }
+  }
+}
+```
+
+---
+
+## 🔧 Development (Local)
+
+### Prerequisites
+
+- **Go 1.22+** — `go version`
+- **Node.js 18+** — `node -v`
+
+### First-time Setup
+
+```bash
+git clone https://github.com/thanhduy1812/verus.git
+cd verus
+
+# Build Go binary + UI → install globally via npm link
+make npm-local
+```
+
+This builds everything and links `verus` globally. Verify:
+
+```bash
+verus version
+verus browser
+```
+
+### Fast Iteration
+
+After editing code, rebuild **only what changed**:
+
+```bash
+# After Go code changes (~1s)
+make dev-go
+
+# After UI changes (~7s)
+make dev-ui
+```
+
+No need to `npm link` again — changes are live immediately.
+
+### Live Dev Mode (Hot Reload)
+
+For frontend development with Vite HMR:
+
+```bash
+make dev
+# API:  http://localhost:3456
+# UI:   http://localhost:5173
+```
+
+### All Make Targets
+
+```
+make npm-local    # First time: build all + npm link
+make dev-go       # Rebuild Go binary only (~1s)
+make dev-ui       # Rebuild UI only (~7s)
+make dev          # Live dev servers (Go + Vite HMR)
+make npm-package  # Build for npm publishing
+make clean        # Remove build artifacts
+make help         # Show all targets
+```
+
+---
+
+## 📂 Project Structure
+
+```
+.verus/                  # Created by `verus init`
+├── config.yaml          # Project config
+├── tasks/               # Task files
+├── docs/                # Documentation
+├── templates/           # Code generation
+└── skills/              # AI skills
+```
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE) for details.

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "verus-pm",
+  "version": "0.1.0",
+  "description": "AI-powered project management — CLI + Web Dashboard in one command",
+  "bin": {
+    "verus": "./bin/verus",
+    "vr": "./bin/verus"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "cli",
+    "task-management",
+    "kanban",
+    "project-management",
+    "documentation",
+    "developer-tools",
+    "ai",
+    "mcp"
+  ],
+  "author": "thanhduy1812",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thanhduy1812/verus.git"
+  },
+  "homepage": "https://github.com/thanhduy1812/verus",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,133 @@
+/**
+ * Verus postinstall — downloads the self-contained Go binary for current platform.
+ * The binary includes the embedded WebUI, so no separate UI files needed.
+ *
+ * Strategy:
+ * 1. Check if binary already exists (dev build via `make npm-local`)
+ * 2. Download pre-built binary from GitHub Releases
+ * 3. Try building from source (if in source repo + Go installed)
+ */
+
+const { existsSync, mkdirSync, chmodSync, createWriteStream, unlinkSync } = require("node:fs");
+const { join } = require("node:path");
+const { execSync } = require("node:child_process");
+const https = require("node:https");
+
+const binDir = join(__dirname, "..", "bin");
+const REPO = "thanhduy1812/verus";
+
+function info(msg) { console.log(`  ℹ ${msg}`); }
+function ok(msg)   { console.log(`  ✅ ${msg}`); }
+function warn(msg) { console.log(`  ⚠️  ${msg}`); }
+
+const PLATFORMS = { darwin: "darwin", linux: "linux", win32: "windows" };
+const ARCHS = { x64: "amd64", arm64: "arm64", arm: "arm" };
+
+async function main() {
+  console.log("\n  ⚡ Verus — installing binary...\n");
+
+  const platform = PLATFORMS[process.platform];
+  const arch = ARCHS[process.arch];
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const binaryName = `verus${ext}`;
+  const binaryPath = join(binDir, binaryName);
+
+  if (!platform || !arch) {
+    warn(`Unsupported platform: ${process.platform}-${process.arch}`);
+    warn(`Download manually from: https://github.com/${REPO}/releases`);
+    return;
+  }
+
+  // Already exists? (dev build via make npm-local)
+  if (existsSync(binaryPath)) {
+    ok(`Binary exists: ${binaryPath}`);
+    return;
+  }
+
+  mkdirSync(binDir, { recursive: true });
+  info(`Platform: ${platform}-${arch}`);
+
+  // 1. Try GitHub Releases first (fastest for end users)
+  try {
+    const release = await fetchJSON(`https://api.github.com/repos/${REPO}/releases/latest`);
+    if (release && release.tag_name) {
+      const tag = release.tag_name;
+      const assetName = `verus-${platform}-${arch}${ext}`;
+      const url = `https://github.com/${REPO}/releases/download/${tag}/${assetName}`;
+      info(`Downloading ${tag} (${assetName})...`);
+      await downloadFile(url, binaryPath);
+      chmodSync(binaryPath, 0o755);
+      ok(`Installed verus ${tag}`);
+      return;
+    }
+  } catch (e) { /* Release not available yet */ }
+
+  // 2. Try building from source (if in source repo + Go installed)
+  try {
+    execSync("go version", { stdio: "pipe" });
+    const goModPath = join(__dirname, "..", "..", "go.mod");
+    if (existsSync(goModPath)) {
+      const sourceRoot = join(__dirname, "..", "..");
+      info("Building from source (Go found + source repo detected)...");
+
+      // Build UI first if possible
+      const uiDir = join(sourceRoot, "ui");
+      const uiDistDir = join(sourceRoot, "internal", "server", "ui_dist");
+      if (existsSync(join(uiDir, "package.json"))) {
+        try {
+          info("Building UI...");
+          execSync("npm install --silent && npm run build", { cwd: uiDir, stdio: "pipe" });
+          mkdirSync(uiDistDir, { recursive: true });
+          execSync(`cp -R ${join(uiDir, "dist")}/* "${uiDistDir}/"`, { stdio: "pipe" });
+        } catch (e) {
+          info("UI build skipped (non-critical)");
+        }
+      }
+
+      execSync(`CGO_ENABLED=0 go build -ldflags "-s -w" -o "${binaryPath}" .`, {
+        cwd: sourceRoot,
+        stdio: "inherit",
+      });
+      chmodSync(binaryPath, 0o755);
+      ok("Built from source");
+      return;
+    }
+  } catch (e) { /* Go not available */ }
+
+  warn("Could not install binary automatically.");
+  warn(`Download from: https://github.com/${REPO}/releases`);
+  warn(`Place binary at: ${binaryPath}`);
+}
+
+function fetchJSON(url) {
+  return new Promise((resolve, reject) => {
+    https.get(url, { headers: { "User-Agent": "verus-npm" } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return fetchJSON(res.headers.location).then(resolve).catch(reject);
+      }
+      let data = "";
+      res.on("data", (c) => (data += c));
+      res.on("end", () => { try { resolve(JSON.parse(data)); } catch { resolve(null); } });
+    }).on("error", reject);
+  });
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    https.get(url, { headers: { "User-Agent": "verus-npm" } }, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return downloadFile(res.headers.location, dest).then(resolve).catch(reject);
+      }
+      if (res.statusCode !== 200) { reject(new Error(`HTTP ${res.statusCode}`)); return; }
+      const file = createWriteStream(dest);
+      res.pipe(file);
+      file.on("finish", () => { file.close(); resolve(); });
+      file.on("error", (e) => { unlinkSync(dest); reject(e); });
+    }).on("error", reject);
+  });
+}
+
+main().catch((err) => {
+  console.error("  ❌ Install error:", err.message);
+  process.exit(0); // Don't break npm install
+});