@sparkleideas/agentdb 3.0.0-alpha.3-patch.1

package/package.json

@@ -0,0 +1,164 @@
+{
+  "name": "@sparkleideas/agentdb",
+  "version": "3.0.0-alpha.3-patch.1",
+  "description": "AgentDB v3 - Intelligent agentic vector database with RVF native format, RuVector-powered graph DB, Cypher queries, ACID persistence. 150x faster than SQLite with self-learning GNN, 6 cognitive memory patterns, semantic routing, COW branching, and comprehensive MCP integration. Runs anywhere: Node.js, browsers, edge, offline.",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "@sparkleideas/agentdb": "dist/src/cli/agentdb-cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    },
+    "./wasm": "./dist/src/wasm-loader.js",
+    "./package.json": "./package.json",
+    "./cli": "./dist/src/cli/agentdb-cli.js",
+    "./cli/commands/migrate": "./dist/src/cli/commands/migrate.js",
+    "./db-fallback": "./dist/src/db-fallback.js",
+    "./backends": "./dist/src/backends/index.js",
+    "./backends/self-learning": "./dist/src/backends/rvf/SelfLearningRvfBackend.js",
+    "./backends/native-accelerator": "./dist/src/backends/rvf/NativeAccelerator.js",
+    "./security": "./dist/src/security/input-validation.js",
+    "./wrappers": "./dist/src/wrappers/index.js",
+    "./wrappers/gnn": "./dist/src/wrappers/gnn-wrapper.js",
+    "./wrappers/agentdb-fast": "./dist/src/wrappers/agentdb-fast.js",
+    "./wrappers/attention": "./dist/src/wrappers/attention-fallbacks.js",
+    "./wrappers/embedding": "./dist/src/wrappers/embedding-service.js",
+    "./controllers": "./dist/src/controllers/index.js",
+    "./controllers/CausalMemoryGraph": "./dist/src/controllers/CausalMemoryGraph.js",
+    "./controllers/CausalRecall": "./dist/src/controllers/CausalRecall.js",
+    "./controllers/ExplainableRecall": "./dist/src/controllers/ExplainableRecall.js",
+    "./controllers/NightlyLearner": "./dist/src/controllers/NightlyLearner.js",
+    "./controllers/ReflexionMemory": "./dist/src/controllers/ReflexionMemory.js",
+    "./controllers/SkillLibrary": "./dist/src/controllers/SkillLibrary.js",
+    "./controllers/EmbeddingService": "./dist/src/controllers/EmbeddingService.js",
+    "./controllers/WASMVectorSearch": "./dist/src/controllers/WASMVectorSearch.js",
+    "./controllers/EnhancedEmbeddingService": "./dist/src/controllers/EnhancedEmbeddingService.js",
+    "./controllers/MMRDiversityRanker": "./dist/src/controllers/MMRDiversityRanker.js",
+    "./controllers/ContextSynthesizer": "./dist/src/controllers/ContextSynthesizer.js",
+    "./controllers/MetadataFilter": "./dist/src/controllers/MetadataFilter.js",
+    "./controllers/QUICServer": "./dist/src/controllers/QUICServer.js",
+    "./controllers/QUICClient": "./dist/src/controllers/QUICClient.js",
+    "./controllers/SyncCoordinator": "./dist/src/controllers/SyncCoordinator.js",
+    "./controllers/HNSWIndex": "./dist/src/controllers/HNSWIndex.js",
+    "./controllers/AttentionService": "./dist/src/controllers/AttentionService.js",
+    "./services/federated-learning": "./dist/src/services/federated-learning.js",
+    "./model": "./dist/src/model/ModelCacheLoader.js"
+  },
+  "scripts": {
+    "build": "npm run build:ts && npm run copy:schemas && npm run build:browser",
+    "build:ts": "tsc",
+    "copy:schemas": "mkdir -p dist/schemas && cp src/schemas/*.sql dist/schemas/",
+    "build:browser": "node scripts/build-browser.js && node scripts/build-browser-v2.js",
+    "build:napi": "bash scripts/optimize-napi.sh",
+    "build:wasm": "bash scripts/optimize-wasm.sh",
+    "build:optimized": "npm run build:napi && npm run build:wasm && npm run build",
+    "postinstall": "node scripts/postinstall.cjs || true",
+    "dev": "tsx src/cli/agentdb-cli.ts",
+    "test": "vitest",
+    "test:unit": "vitest --run",
+    "test:browser": "vitest browser-bundle-unit.test.js --run",
+    "test:ci": "npm run test:browser && npm run build && npm run verify:bundle",
+    "verify:bundle": "node scripts/verify-bundle.js",
+    "cli": "node dist/src/cli/agentdb-cli.js",
+    "docker:test": "docker build -f docs/SQLITE-FIX-DOCKER-TEST.Dockerfile -t agentdb-test . && docker run --rm agentdb-test",
+    "benchmark": "tsx benchmarks/simple-benchmark.ts",
+    "benchmark:full": "tsx benchmarks/benchmark-runner.ts",
+    "benchmark:build": "cd benchmarks && tsc",
+    "benchmark:attention": "tsx benchmarks/attention-performance.ts",
+    "benchmark:backends": "tsx benchmarks/compare-backends.ts",
+    "benchmark:profile": "tsx scripts/profile-hot-paths.ts",
+    "benchmark:ruvector": "tsx benchmarks/ruvector-benchmark.ts",
+    "benchmark:all": "npm run benchmark:attention && npm run benchmark:backends && npm run benchmark:profile && npm run benchmark:ruvector",
+    "build:model": "node scripts/build-model-rvf.mjs"
+  },
+  "keywords": [
+    "agentdb",
+    "vector-database",
+    "ai-agents",
+    "memory",
+    "causal-reasoning",
+    "reflexion",
+    "episodic-memory",
+    "skill-library",
+    "lifelong-learning",
+    "explainable-ai",
+    "provenance",
+    "hnsw",
+    "embeddings",
+    "sqlite",
+    "sql.js",
+    "wasm"
+  ],
+  "author": "ruv",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agentic-flow.git",
+    "directory": "packages/agentdb"
+  },
+  "bugs": {
+    "url": "https://github.com/ruvnet/agentic-flow/issues"
+  },
+  "homepage": "https://agentdb.ruv.io",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.1",
+    "@opentelemetry/api": "^1.9.0",
+    "ajv": "^8.18.0",
+    "jsonwebtoken": "^9.0.2",
+    "sql.js": "^1.13.0"
+  },
+  "devDependencies": {
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.10.2",
+    "dotenv": "^16.4.7",
+    "esbuild": "^0.25.11",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.15"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/src/",
+    "dist/schemas/",
+    "dist/models/",
+    "scripts/postinstall.cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "@opentelemetry/resources": "^1.25.0",
+    "@opentelemetry/sdk-node": "^0.52.0",
+    "@opentelemetry/semantic-conventions": "^1.25.0",
+    "@ruvector/attention": "^0.1.2",
+    "@ruvector/gnn": "^0.1.23",
+    "@ruvector/graph-node": "^2.0.2",
+    "@ruvector/router": "^0.1.15",
+    "@ruvector/ruvllm": "^2.5.1",
+    "@ruvector/rvf": "^0.1.9",
+    "@ruvector/rvf-node": "^0.1.7",
+    "@ruvector/rvf-solver": "^0.1.7",
+    "@ruvector/rvf-wasm": "^0.1.6",
+    "@ruvector/sona": "^0.1.4",
+    "@xenova/transformers": "^2.17.2",
+    "argon2": "^0.44.0",
+    "better-sqlite3": "^11.8.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "hnswlib-node": "^3.0.0",
+    "inquirer": "^9.3.8",
+    "ruvector": "^0.1.30",
+    "ruvector-attention-wasm": "^0.1.0"
+  },
+  "overrides": {
+    "@xenova/transformers": {
+      "sharp": "^0.33.0"
+    }
+  }
+}

package/scripts/README.md

@@ -0,0 +1,314 @@
+# AgentDB Scripts Directory
+
+This directory contains build, validation, and deployment scripts for AgentDB v2.
+
+## Build Scripts
+
+### Browser Builds
+
+#### `build-browser.js`
+**Purpose:** Original browser bundle builder
+**Usage:** `node scripts/build-browser.js`
+**Output:** `dist/agentdb.browser.js`
+**Features:**
+- Basic SQL.js WASM integration
+- Single-file browser bundle
+- CDN-ready output
+
+#### `build-browser-v2.js`
+**Purpose:** Enhanced v2 browser bundle with advanced features
+**Usage:** `node scripts/build-browser-v2.js`
+**Output:** `dist/agentdb.browser.v2.js`
+**Features:**
+- Multi-backend support (SQL.js/IndexedDB auto-detection)
+- GNN optimization integration
+- IndexedDB persistence
+- Cross-tab synchronization
+- 100% v1 API backward compatibility
+- Enhanced error handling
+
+**Recommended:** Use this for new projects requiring browser support.
+
+#### `build-browser-advanced.cjs`
+**Purpose:** Advanced browser features build
+**Usage:** `node scripts/build-browser-advanced.cjs`
+**Features:**
+- Advanced WASM optimization
+- Progressive loading
+- Service worker integration
+- Memory management enhancements
+
+### Dependencies
+
+#### `postinstall.cjs`
+**Purpose:** Post-installation setup and verification
+**Auto-runs:** After `npm install`
+**Tasks:**
+- Validates environment
+- Checks native dependencies (better-sqlite3)
+- Sets up development environment
+- Verifies WASM files
+
+## Validation Scripts
+
+### `comprehensive-review.ts`
+**Purpose:** Complete v2 feature validation and performance testing
+**Usage:** `tsx scripts/comprehensive-review.ts`
+**Tests:**
+- @ruvector/core integration
+- @ruvector/gnn integration
+- ReasoningBank functionality
+- All v2 controllers (HNSW, QUIC, etc.)
+- Backend performance comparison
+- Memory usage analysis
+- Optimization opportunities
+
+**Output:** Comprehensive test report with metrics
+
+### `validate-security-fixes.ts`
+**Purpose:** Security validation and audit
+**Usage:** `tsx scripts/validate-security-fixes.ts`
+**Checks:**
+- SQL injection prevention
+- Input sanitization
+- Path traversal protection
+- Dependency vulnerabilities
+- Code signing verification
+
+### `verify-bundle.js`
+**Purpose:** Bundle integrity verification
+**Usage:** `node scripts/verify-bundle.js`
+**Validates:**
+- Bundle size limits
+- Export completeness
+- API surface consistency
+- WASM file integrity
+
+### `verify-core-tools-6-10.sh`
+**Purpose:** Core tools validation (tools 6-10)
+**Usage:** `bash scripts/verify-core-tools-6-10.sh`
+**Tests:**
+- Tool 6: Batch insert operations
+- Tool 7: Hybrid search
+- Tool 8: QUIC synchronization
+- Tool 9: Learning plugins
+- Tool 10: Performance benchmarks
+
+## Release Scripts
+
+### `npm-release.sh`
+**Purpose:** Automated NPM release workflow
+**Usage:** `bash scripts/npm-release.sh [version]`
+**Process:**
+1. Version bump (semver)
+2. Changelog generation
+3. Build verification
+4. Test suite execution
+5. Bundle validation
+6. NPM publish
+7. Git tag creation
+
+**Requirements:**
+- NPM authentication
+- Git repository
+- Clean working tree
+
+### `pre-release-validation.sh`
+**Purpose:** Pre-release quality gate
+**Usage:** `bash scripts/pre-release-validation.sh`
+**Validates:**
+- All tests passing
+- No TypeScript errors
+- Bundle integrity
+- Documentation accuracy
+- Security audit clean
+- Performance benchmarks met
+
+## Testing Scripts
+
+### `docker-test.sh`
+**Purpose:** Docker environment testing
+**Usage:** `bash scripts/docker-test.sh`
+**Tests:**
+- Installation in clean environment
+- Runtime dependencies
+- Cross-platform compatibility
+- Network isolation scenarios
+
+### `docker-validation.sh`
+**Purpose:** Comprehensive Docker validation suite
+**Usage:** `bash scripts/docker-validation.sh`
+**Includes:**
+- Multi-stage build verification
+- Container security scan
+- Resource usage monitoring
+- Integration test suite
+
+## AgentDB Version
+
+**Current Version:** 1.6.1
+**Target:** v2.0.0 with full backward compatibility
+
+All scripts are designed to work with:
+- **Node.js:** >=18.0.0
+- **TypeScript:** ^5.7.2
+- **Better-sqlite3:** ^11.8.1 (optional)
+- **@ruvector/core:** ^0.1.15
+- **@ruvector/gnn:** ^0.1.15
+
+## Development Workflow
+
+### 1. Local Development
+```bash
+npm run build          # Full build pipeline
+npm run dev           # Development mode with tsx
+npm test              # Run test suite
+```
+
+### 2. Browser Testing
+```bash
+npm run build:browser  # Build browser bundle
+npm run test:browser   # Test browser bundle
+npm run verify:bundle  # Verify bundle integrity
+```
+
+### 3. Pre-Release Validation
+```bash
+bash scripts/pre-release-validation.sh
+tsx scripts/comprehensive-review.ts
+tsx scripts/validate-security-fixes.ts
+```
+
+### 4. Release
+```bash
+bash scripts/npm-release.sh patch  # Patch release
+bash scripts/npm-release.sh minor  # Minor release
+bash scripts/npm-release.sh major  # Major release
+```
+
+## Script Dependencies
+
+### Required Global Tools
+- `node` (>=18.0.0)
+- `npm` (>=9.0.0)
+- `bash` (>=4.0)
+- `tsx` (for TypeScript scripts)
+- `docker` (for container tests)
+
+### Package Scripts Integration
+
+Scripts integrate with `package.json` scripts:
+
+```json
+{
+  "scripts": {
+    "build": "npm run build:ts && npm run copy:schemas && npm run build:browser",
+    "build:browser": "node scripts/build-browser.js",
+    "postinstall": "node scripts/postinstall.cjs || true",
+    "verify:bundle": "node scripts/verify-bundle.js",
+    "docker:test": "bash scripts/docker-test.sh"
+  }
+}
+```
+
+## Troubleshooting
+
+### Build Failures
+
+**Problem:** Browser bundle build fails
+**Solution:**
+```bash
+# Clear dist and rebuild
+rm -rf dist
+npm run build
+```
+
+**Problem:** WASM files not loading
+**Solution:**
+```bash
+# Re-download dependencies
+rm -rf node_modules
+npm install
+```
+
+### Validation Failures
+
+**Problem:** Security validation fails
+**Solution:**
+```bash
+npm audit fix
+tsx scripts/validate-security-fixes.ts
+```
+
+**Problem:** Bundle size exceeded
+**Solution:**
+```bash
+# Check bundle analysis
+npm run verify:bundle
+# Consider code splitting or lazy loading
+```
+
+### Release Issues
+
+**Problem:** NPM publish fails
+**Solution:**
+```bash
+# Verify authentication
+npm whoami
+npm login
+
+# Check version
+npm version patch --no-git-tag-version
+```
+
+## Best Practices
+
+1. **Always run validation before releases:**
+   ```bash
+   bash scripts/pre-release-validation.sh
+   ```
+
+2. **Test browser builds locally:**
+   ```bash
+   npm run test:browser
+   ```
+
+3. **Keep dependencies updated:**
+   ```bash
+   npm outdated
+   npm update
+   ```
+
+4. **Run security audits regularly:**
+   ```bash
+   tsx scripts/validate-security-fixes.ts
+   ```
+
+5. **Verify Docker compatibility:**
+   ```bash
+   bash scripts/docker-test.sh
+   ```
+
+## Contributing
+
+When adding new scripts:
+
+1. Add executable permissions: `chmod +x script-name.sh`
+2. Include shebang line: `#!/usr/bin/env node` or `#!/usr/bin/env bash`
+3. Add comprehensive error handling
+4. Document in this README
+5. Add to package.json scripts if appropriate
+6. Include validation tests
+
+## Support
+
+For issues with scripts:
+- Check logs in `logs/` directory
+- Review error messages carefully
+- Verify Node.js/npm versions
+- Check GitHub Issues: https://github.com/ruvnet/agentic-flow/issues
+
+---
+
+**Last Updated:** 2025-11-29
+**AgentDB Version:** 1.6.1 → 2.0.0

package/scripts/postinstall.cjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * AgentDB Post-Install Script
+ * Verifies sql.js (WASM SQLite) is available — no native compilation needed.
+ */
+
+function main() {
+  // Skip in CI environments or if explicitly disabled
+  if (process.env.CI || process.env.AGENTDB_SKIP_POSTINSTALL === 'true') {
+    return;
+  }
+
+  // Verify core dependency: sql.js
+  try {
+    require('sql.js');
+    console.log('[@sparkleideas/agentdb] sql.js (WASM SQLite): OK');
+  } catch {
+    console.error('[@sparkleideas/agentdb] sql.js not found — run: npm install sql.js');
+  }
+
+  // Check optional deps without failing
+  try {
+    require('better-sqlite3');
+    console.log('[@sparkleideas/agentdb] better-sqlite3: available (optional)');
+  } catch {
+    console.log('[@sparkleideas/agentdb] better-sqlite3: not installed (optional, sql.js used)');
+  }
+}
+
+main();