SPT Documentation

Appearance

Changelog ​

All notable changes to the SPTFlo project (formerly SPTFlo) are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.5.0] - 2026-02-27 ​

SPTFlo v3.5 — First Major Stable Release ​

This release marks the official rebranding from SPTFlo to SPTFlo and represents the first major stable release after 5,800+ commits, 55 alpha iterations, and 10 months of development.

Highlights ​

  • Rebranding: SPTFlo → SPTFlo across all packages (@sptflo/cli, sptflo, sptflo)
  • agentic-flow v3.0.0-alpha.1 Integration: Full deep integration with 10 subpath exports (ReasoningBank, Router, Orchestration, Agent Booster, SDK, Security, QUIC transport)
  • SptDB v3.0.0-alpha.9: 8 new controllers (HierarchicalMemory, MemoryConsolidation, SemanticRouter, GNNService, SPFOptimizer, MutationGuard, AttestationLog, GuardedVectorBackend) + 6 MCP tools
  • 215 MCP Tools: Full Model Context Protocol server with vector memory, neural training, swarm coordination
  • Security Hardening: Command injection fix, TOCTOU race fix, eliminated hardcoded HMAC keys, timing attack fixes
  • Doctor Health Check: New agentic-flow diagnostic (filesystem-based, ESM-compatible)
  • 0 Production Vulnerabilities: Clean npm audit across all packages

Added ​

  • agentic-flow-bridge.ts — Unified lazy-loading bridge for all agentic-flow v3 modules
  • Tiered embedding resolution: ReasoningBank WASM (Tier 1) → @sptflo/embeddings (Tier 2) → mock fallback (Tier 3)
  • Agent Booster local import with npx fallback
  • checkAgenticFlow() doctor health check
  • 7 TypeScript module declarations for agentic-flow subpath exports
  • ADR-056: agentic-flow v3 Integration Architecture

Fixed ​

  • Command injection vulnerability in enhanced-model-router.ts (SAFE_LANGUAGES whitelist)
  • TOCTOU race condition in bridge singleton initialization (Promise-based caching)
  • 22 agent/skill files updated from stale v1.5.11/v2.0.0-alpha to v3.0.0-alpha.1
  • ESM compatibility for doctor checks (filesystem-based instead of require.resolve)
  • @smartpointstech/gnn pinned to 0.1.25 to fix fatal process crash (issue #216)

Changed ​

  • All 3 packages bumped from 3.1.0-alpha.55 to 3.5.0
  • Publish tags changed from alpha/v3alpha to latest
  • agentic-flow minimum version: 0.1.0 → 3.0.0-alpha.1
  • sptdb minimum version: 2.0.0-alpha.3.4 → 3.0.0-alpha.10

[3.1.0-alpha.55] - 2026-02-27 ​

SptDB 3.0.0-alpha.9 Integration (ADR-053/ADR-055) ​

  • Activated 8 SptDB v3 controllers with MutationGuard proof engine
  • Added 6 new MCP tools: sptdb_hierarchical_*, sptdb_consolidation_*, sptdb_semantic_*
  • Fixed controller registry activation bugs (ADR-055)
  • Statusline fixes for real-time controller status
  • Pinned @smartpointstech/gnn@0.1.25 to fix fatal process crash

[3.1.0-alpha.43] - 2026-02-15 ​

SPTFlo Branding Fix ​

  • Fixed CLI branding: show 'sptflo' instead of 'sptflo' when run via npx sptflo
  • Fixed Windows ESM import crash with pathToFileURL
  • Fixed init hook prompt overflow and description field

[3.1.0-alpha.36] - 2026-02-10 ​

Stability & Compatibility ​

  • Fixed hooks backward compatibility: --success and --file made optional
  • Fixed Windows npm install crash (404 optional dependencies)
  • Bumped sptdb to 2.0.0-alpha.3.6
  • Fixed V3 build errors (missing helmet, VERSION type, vitest spy)

[3.1.0-alpha.29] - 2026-02-01 ​

Security & Agent Teams ​

  • Security fixes, backward compatibility, and Agent Teams hooks
  • Added --settings flag to upgrade command for Agent Teams
  • Fixed npm 11 install crash by pinning sptdb

v3.0.0-alpha Series (2025-10 to 2026-02) ​

v3.0.0-alpha.184 — CLI Help & Categorization (2025-12) ​

  • Fixed CLI help categorization across 26 commands
  • Published install optimizations
  • curl-style installer script
  • SEO-optimized npm packages for discovery

v3.0.0-alpha.170 — Plugins & Marketplace (2025-12) ​

  • Plugin Marketplace: 8 official plugins + IPFS registry via Pinata
  • Gas Town Bridge Plugin: WASM-accelerated orchestrator integration
  • 10 spt WASM Plugins: 50 MCP tools for neural computation
  • @sptflo/teammate-plugin: MCP tools for Agent Teams coordination

v3.0.0-alpha.150 — SONA & SemanticRouter (2025-11) ​

  • SemanticRouter: SONA WASM integration with verified benchmarks
  • Fixed phantom Claude popups on Windows
  • Fixed statusline safe multi-line output for Claude Desktop
  • Fixed MCP tool naming (/ → _) for Claude Desktop compatibility
  • Memory namespace support in delete command

v3.0.0-alpha.100 — @sptflo/guidance (2025-11) ​

  • @sptflo/guidance Control Plane: Governance, compliance, and policy enforcement
  • Wave 1: Proof, gateway, memory-gate, coherence, hooks, persistence primitives
  • Wave 2: Conformance kit, capability algebra, evolution pipeline, artifact ledger
  • Wave 3: Civilization-grade primitives (trust, truth, uncertainty, time, authority)
  • Rust WASM Policy Kernel: SIMD128-accelerated policy evaluation
  • ContinueGate: Safety gate for agent continuation decisions
  • 22-benchmark suite with before/after performance reporting
  • CLAUDE.md generators, analyzer, and auto-optimizer
  • Content-aware executor with statistical validation (Spearman ρ, Cohen's d)

v3.0.0-alpha.50 — Core V3 Implementation (2025-10) ​

  • Complete V3 implementation across all ADRs
  • ADR-003: Coordinator consolidation + security tests
  • Complete hooks system with SptDB, HNSW, tests
  • ReasoningBank guidance system with CLI
  • V2→V3 migration documentation
  • MCP memory tools upgraded to sql.js + HNSW backend
  • Claims-based authorization (ADR-016)
  • Node.js worker daemon system
  • Auto-update system for @sptflo packages (ADR-025)
  • Replaced all mock implementations with real functionality

v3.0.0-alpha.1 — Foundation (2025-10) ​

  • Complete V3 monorepo structure (@sptflo/cli, shared, memory, hooks, security)
  • 26 CLI commands with 140+ subcommands
  • 215 MCP tools via FastMCP 3.x
  • spt intelligence system (SONA, MoE, HNSW, EWC++, Flash Attention)
  • Hive-Mind consensus (Byzantine, Raft, Gossip, CRDT, Quorum)
  • 17 hooks + 12 background workers
  • 60+ specialized agent types
  • Cross-platform helper system

v2.7.x Series (2025-08 to 2025-10) ​

v2.7.34 — PostgreSQL & Neural Persistence ​

  • PostgreSQL Bridge with attention, GNN, hyperbolic embeddings
  • Neural pattern persistence to disk
  • Hive-mind --claude flag for spawn command
  • Real statusline data, hive-mind shutdown fixes, daemon persistence
  • Multi-platform builds (Linux, macOS, Windows) in CI/CD

v2.7.0 — agentic-flow Integration ​

  • Deep integration with agentic-flow coordination engine
  • SDK architecture analysis and hooks & learning integration
  • Modular installation strategy
  • Optimized v3 migration plan

v2.0.0-alpha Series (2025-05 to 2025-08) ​

v2.0.0-alpha.128 — Maturity ​

  • Comprehensive hive-mind optimization
  • Database schema robustness (missing columns, optimization errors)
  • Auto-rebuild better-sqlite3 on NODE_MODULE_VERSION mismatch
  • InMemoryStore interval cleanup for clean process exit

v2.0.0-alpha.53 — Hook Safety ​

  • Critical hook safety system
  • Hive-mind optimization command
  • Safety & security features documentation
  • Neural Link System with safety protocols

v2.0.0-alpha.33 — Windows & WSL ​

  • Windows/WSL compatibility fixes
  • Module import error resolution
  • README restructure for v2.0.0 features
  • Comprehensive test suite

v1.x Series (2025-01 to 2025-05) ​

v1.0.71 — Final v1 Release ​

  • npm publishing compatibility
  • Full CLI command functionality
  • SMART integration with full prompt loading
  • Cross-platform support

v1.0.50 — Swarm & SMART ​

  • Parallel execution for swarm tasks
  • Background task management
  • Swarm command with improved error handling
  • Claude Code slash commands integration

v1.0.28 — Project Management ​

  • CLI project management commands
  • System monitoring and SMART commands
  • Orchestration templates (monitoring, optimization, security review)

v1.0.1 — Initial Release (2025-01-01) ​

  • Complete SPTFlo AI Agent Orchestration System
  • Configuration guide and comprehensive tests
  • Initial commit

Milestone Summary ​

MilestoneVersionDateKey Feature
Initial Releasev1.0.12025-01AI agent orchestration system
SMART Integrationv1.0.502025-03Swarm + SMART methodology
Alpha Foundationv2.0.0-alpha.332025-05V2 alpha with hook safety
agentic-flowv2.7.02025-08agentic-flow coordination engine
V3 Foundationv3.0.0-alpha.12025-10V3 monorepo, 215 MCP tools
Plugin Marketplacev3.0.0-alpha.1702025-128 plugins + IPFS registry
Guidance Control Planev3.0.0-alpha.1002026-01WASM policy kernel, ContinueGate
SptDB v3v3.1.0-alpha.552026-028 controllers, MutationGuard
SPTFlo v3.5v3.5.02026-02-27First stable release, rebranding

Released under the MIT License.

Copyright 2024-present SmartPoints Technology