verus-pm 0.1.0 → 0.2.0

package/README.md

@@ -21,7 +21,7 @@ All in one command — CLI + Web Dashboard included.
 npm install -g verus
 ```
 
-That's it. CLI + Web Dashboard + MCP Server — all in one package.
+That's it. CLI + Web Dashboard + MCP Server — all in one *high-performance native Go binary* shipped via npm.
 
 ### Verify
 
@@ -61,76 +61,156 @@ verus browser
 | 🔄 Imports | `verus import add` | Manage sources |
 | 🛠️ Skills | `verus skill install` | — |
 | 🔐 Offline Search | `verus model download` | — |
+| 🔄 Update | `verus update` | — |
 
 ---
 
 ## 📋 CLI Reference
 
+### Project Setup
+
+```bash
+verus init                       # Interactive project setup
+verus init my-project            # Init with name
+verus init --no-wizard           # Non-interactive (use defaults)
+verus init --force               # Reinitialize existing project
+verus update                     # Update skills, rules, .mcp.json (keeps tasks/docs)
+verus update --no-skills         # Skip skill update
+verus update --no-rules          # Skip agent guideline update
+verus update --no-mcp            # Skip .mcp.json update
+verus update --no-config         # Skip config/flow update
+verus validate                   # Validate project integrity
+```
+
 ### 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
+verus task list                              # List all tasks
+verus task list --status in-progress         # Filter by status
+verus task list --priority high              # Filter by priority
+verus task list --assignee "@me"             # Filter by assignee
+verus task create "Fix login bug" -p high    # Create with priority
+verus task create "Auth" --labels "be,auth"  # Create with labels
+verus task view abc123                       # View task detail
+verus task edit abc123 --status done         # Update status
+verus task edit abc123 --priority high       # Update priority
+verus task edit abc123 --ac "Tests pass"     # Add acceptance criteria
+verus task delete abc123                     # Delete task
 ```
 
-### Docs
+### Documentation
 
 ```bash
-verus doc list                               # List all
-verus doc create "API Design" --folder specs # Create
-verus doc view specs/api-design              # View
+verus doc list                               # List all docs
+verus doc create "API Design"                # Create doc
+verus doc create "Auth Spec" --folder specs  # Create in folder
+verus doc view specs/auth-spec               # View doc content
 ```
 
 ### 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
+verus time start abc123          # Start timer for task
+verus time stop abc123           # Stop timer & record
+verus time status                # Show active timers
+verus time add abc123 2h30m      # Add time manually
+verus time report                # Time report (by task)
+verus time report --group label  # Report grouped by label
+verus time report --group status # Report grouped by status
 ```
 
-### Board, Search & Config
+### Board & Search
 
 ```bash
-verus board                      # Kanban in terminal
-verus search "authentication"    # Full-text search
-verus config get                 # Show config
+verus board                      # Kanban board in terminal
+verus search "authentication"    # Full-text search (tasks + docs)
+verus search "bug" --type task   # Search tasks only
+verus search "api" --type doc    # Search docs only
+verus search "auth" --limit 5    # Limit results
+verus search --reindex           # Rebuild search index
+```
+
+### Configuration
+
+```bash
+verus config get                 # Show all config
+verus config get name            # Get specific value
 verus config set name "My App"   # Set value
 ```
 
-### Models, Templates & Imports
+### Models (Semantic Search)
+
+```bash
+verus model list                 # List available embedding models
+verus model download gte-small   # Download a model
+verus model path                 # Show model storage directory
+verus model remove gte-small     # Remove a downloaded model
+```
+
+### Templates
+
+```bash
+verus template list              # List available templates
+verus template run component     # Run template (generates code)
+```
+
+### Imports
+
+```bash
+verus import add <git-url>       # Import from git repo
+verus import add <npm-package>   # Import from npm
+verus import list                # List imported sources
+verus import sync                # Sync all imports (pull latest)
+verus import remove <name>       # Remove an import
+```
+
+### Skills
+
+```bash
+verus skill list                 # List all skills (project + built-in)
+verus skill install              # Install all built-in skills
+verus skill install <name>       # Install specific skill
+verus skill sync                 # Sync skills to AI platforms
+```
+
+### Sync (Agent Integration)
+
+```bash
+verus sync agents                # Update AGENTS.md, GEMINI.md, CLAUDE.md
+verus sync agents --platform claude  # Sync for specific platform
+verus sync mcp                   # Setup MCP in .mcp.json + Claude Code
+verus sync mcp --project         # Only create .mcp.json
+verus sync mcp --global          # Only setup Claude Code CLI
+verus sync skills                # Sync skills from .agent/skills/ to .verus/skills/
+```
+
+### Server & Web UI
 
 ```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
+verus serve                      # Start API server (port 3456)
+verus serve -p 8080              # Start on custom port
+verus browser                    # Open Web UI (starts server if needed)
+verus browser --no-open          # Start server without opening browser
+verus browser -p 8080            # Use custom port
 ```
 
-### Skills & Sync
+### MCP Server
 
 ```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
+verus mcp                        # Start MCP server (stdio transport)
+verus mcp --port 3457            # Start MCP server (HTTP SSE transport)
+verus mcp --root /path/to/proj   # Explicitly set project root
 ```
 
-### Server
+### Utilities
 
 ```bash
-verus serve                      # Start API (port 3456)
-verus browser                    # Open Web UI
-verus mcp                        # Start MCP server
+verus version                    # Show version
+verus guidelines                 # Show AI agent guidelines
+verus guidelines --plain         # Plain text output
+verus completion bash            # Generate shell completions
+verus completion zsh
+verus completion fish
 ```
 
 ---
@@ -147,11 +227,11 @@ Included in the npm package — no separate install needed.
 
 ## 🤖 MCP Integration
 
-```bash
-verus sync mcp    # Generates .mcp.json for your IDE
-```
+Verus provides an MCP (Model Context Protocol) server for AI agent integration, allowing tools like Claude Code, Antigravity, Cursor, and others to create/manage tasks, docs, and more.
+
+### Stdio Transport (Default)
 
-Or manually add to `.mcp.json`:
+The most common way to connect — `verus init` auto-generates `.mcp.json`:
 
 ```json
 {
@@ -161,6 +241,48 @@ Or manually add to `.mcp.json`:
 }
 ```
 
+The MCP server auto-detects the project from the working directory set by your IDE.
+
+### HTTP SSE Transport
+
+For multi-process setups or debugging:
+
+```bash
+verus mcp --port 3457
+```
+
+Then configure your MCP client to connect via SSE to `http://localhost:3457/sse`.
+
+### Available MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_task` | Create a new task |
+| `list_tasks` | List tasks with filters |
+| `get_task` | Get task by ID |
+| `update_task` | Update task fields |
+| `delete_task` | Delete a task |
+| `get_board` | Get task board by status |
+| `create_doc` | Create documentation |
+| `list_docs` | List all docs |
+| `get_doc` | Get doc by path |
+| `update_doc` | Update doc content/metadata |
+| `search` | Search tasks and docs |
+| `list_templates` | List code templates |
+| `get_template` | Get template config |
+| `run_template` | Run code generation |
+| `create_template` | Create template scaffold |
+| `start_time` | Start task timer |
+| `stop_time` | Stop task timer |
+| `time_status` | Active timers |
+| `add_time` | Add time entry |
+| `get_time_report` | Time report |
+| `get_config` | Get project config |
+| `set_config` | Set config value |
+| `validate` | Validate project integrity |
+
+> **Note**: `verus browser` runs the Web UI independently of the MCP service. Web UI logs never interrupt the `stdio` JSON-RPC connection.
+
 ---
 
 ## 🔧 Development (Local)
@@ -180,7 +302,7 @@ cd verus
 make npm-local
 ```
 
-This builds everything and links `verus` globally. Verify:
+Verify:
 
 ```bash
 verus version
@@ -201,6 +323,16 @@ make dev-ui
 
 No need to `npm link` again — changes are live immediately.
 
+### Full Rebuild
+
+After pulling changes or major updates:
+
+```bash
+make rebuild
+```
+
+This kills old processes, cleans artifacts, rebuilds UI + Go binary, and re-links npm globally.
+
 ### Live Dev Mode (Hot Reload)
 
 For frontend development with Vite HMR:
@@ -215,10 +347,12 @@ make dev
 
 ```
 make npm-local    # First time: build all + npm link
+make rebuild      # Full rebuild: clean + 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 release      # Build release binaries (cross-platform)
 make clean        # Remove build artifacts
 make help         # Show all targets
 ```
@@ -229,11 +363,20 @@ make help         # Show all targets
 
 ```
 .verus/                  # Created by `verus init`
-├── config.yaml          # Project config
-├── tasks/               # Task files
-├── docs/                # Documentation
-├── templates/           # Code generation
-└── skills/              # AI skills
+├── config.json          # Project config (internal)
+├── config.yaml          # Project settings
+├── flow.yaml            # Workflow & status definitions
+├── tasks/               # Task files (markdown + frontmatter)
+├── docs/                # Documentation (markdown)
+├── templates/           # Code generation templates
+├── skills/              # AI skills (SKILL.md files)
+└── search-index/        # FTS5 search index (auto-generated)
+
+.mcp.json                # MCP server config (auto-generated by init)
+AGENTS.md                # Agent guidelines (generic)
+GEMINI.md                # Antigravity/Gemini rules
+CLAUDE.md                # Claude Code rules
+.cursorrules             # Cursor rules
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "verus-pm",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI-powered project management — CLI + Web Dashboard in one command",
   "bin": {
     "verus": "./bin/verus",