vectorforce 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to the `vectorforce` package will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.2.0] - 2026-10-31
+
+### Added
+- **Unified Remote Sync Commands (`vf remote`, `vf push`, `vf pull`)**:
+  - `vf remote set <URL> [--key <KEY>] [--project <ID>]`: Configure remote cloud synchronization endpoint in `.vectorforce/config.json`.
+  - `vf push`: Read local `.vectorforce/vectorforce.db`, wrap tasks & checkpoints in End-to-End Encrypted (E2EE) envelopes (`AES-256-GCM` + `X25519` + `Ed25519`), and push to VectorForce Cloud / Modal.com.
+  - `vf pull`: Pull the latest encrypted envelope from the cloud, verify the `Ed25519` digital signature, decrypt via `X25519` + `AES-256-GCM`, reconcile into local SQLite, and synthesize the **Meta Muse (`muse-spark-open`)** reasoning briefing.
+- **VectorForce Cloud & Modal.com Serverless Deployment**:
+  - Dedicated cloud sync server supporting multi-project registries, B2B2B sub-customer tenant isolation, and developer task assignment boards.
+  - One-command deployment to Modal.com (`modal_app.py`) with persistent `modal.Volume` storage for encrypted SQLite WAL databases.
+- **Interactive Team Handoff & Studio UI Upgrades**:
+  - Added direct browser download of `.vfhandoff.json` bundle files.
+  - Added interactive in-browser **Import & Reconcile Teammate Handoff Package** modal (`POST /api/handoff/import`) with SHA-256 manifest validation.
+  - Automatic resolution of active tasks and divergent checkpoint heads in Studio export endpoints.
+- **Automated npm Lifecycle Hooks**:
+  - Added `prepublishOnly` script in `package.json` to ensure `npm --prefix studio run build` and all 75 tests run automatically before every `npm publish`.
+
+### Changed
+- **CLI Commands Simplified**: Unified remote cloud sync under the standard `vf` command (following the `git remote`, `git push`, `git pull` mental model).
+- **Workspace Agent Protocols**: Upgraded workspace-level `AGENTS.md` and role definitions for `vectorforce-architect`, `vectorforce-auditor`, and `vectorforce-samples-builder`.
+
+### Fixed
+- Fixed `TypeError` in `TeamHandoffView.jsx` when resolving checkpoints with differing `id` vs `checkpoint_id` shapes.
+- Fixed divergent leaf head resolution in `/api/handoff/export` by auto-selecting the latest timestamped checkpoint.
+- Fixed ephemeral key generation in serverless environments by persisting machine identities in durable SQLite storage.
+
+---
+
+## [0.1.0] - 2026-10-27
+
+### Added
+- Initial public release of VectorForce — "Git for AI Context".
+- Zero-dependency local SQLite WAL persistence engine (`node:sqlite`).
+- Model Context Protocol (MCP) server over JSON-RPC 2.0 stdio with 9 core tools (`save_checkpoint`, `get_resume_briefing`, `check_workspace_drift`, `reason_about_task`, `list_tasks`, `set_document_policy`, `export_handoff`, `import_handoff`, `get_timeline`).
+- Automatic multi-harness configuration generators for Google Antigravity, Claude Code, Command Code, Meta Muse, and OpenAI Codex.
+- Multi-provider AI reasoning engine supporting Meta Muse (`muse-spark-1.3`, `muse-spark-open`), Fireworks AI, OpenRouter, Local Ollama, OpenAI, Anthropic, and custom BYOK endpoints.
+- Local VectorForce Studio Web UI (`vf studio`) on port 3210 with interactive SVG architecture dependency and blast-radius graph.

package/README.md

@@ -73,7 +73,24 @@ node bin/vf.js checkpoint --task auth-module \
   --doc "AGENTS.md"
 ```
 
-### 5. Reason Over Context (AI Engineering Memory)
+### 5. Multi-Machine & Team Cloud Sync (`vf remote`, `vf push`, `vf pull`)
+
+VectorForce follows the Git mental model for sharing context between two computers or across a team using Zero-Knowledge End-to-End Encryption (`X25519` + `AES-256-GCM` + `Ed25519`):
+
+```bash
+# 1. Connect local workspace to your Cloud Remote once:
+node bin/vf.js remote set https://omprakash-pce2011--vectorforce-cloud-vectorforce-cloud-web.modal.run \
+  --key vf_live_sub_98a7bc65f012e4d9 \
+  --project proj-bistro-pos
+
+# 2. Push local checkpoints & tasks to Cloud (E2EE):
+node bin/vf.js push
+
+# 3. Pull & reconcile context on Computer 2 (reconciles into SQLite & runs Meta Muse reasoning):
+node bin/vf.js pull
+```
+
+### 6. Reason Over Context (AI Engineering Memory)
 
 VectorForce prioritizes **Meta Muse (`muse-spark-1.3`)** and the open-weights **Meta Muse Spark Open (`muse-spark-open` • 1M token context window)** as its **#1 reasoning models**, while also supporting **Fireworks AI**, **OpenRouter**, **Local Ollama**, **OpenAI / Codex**, **Anthropic Claude**, and any **Custom BYOK** OpenAI-compatible endpoint:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vectorforce",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Portable engineering context platform - Git for AI context",
   "type": "module",
   "main": "src/index.js",
@@ -9,6 +9,8 @@
     "vectorforce": "bin/vf.js"
   },
   "scripts": {
+    "build": "npm --prefix studio run build",
+    "prepublishOnly": "npm --prefix studio run build && npm test",
     "test": "node --test \"test/**/*.test.js\"",
     "test:practical": "node scripts/practical-test-env.js"
   },
@@ -20,6 +22,7 @@
     "src",
     "studio/dist",
     "AGENTS.md",
+    "CHANGELOG.md",
     "commandcode.json",
     "musecode.json",
     "codex.json",