@miller-tech/uap 1.8.1 → 1.10.0

package/dist/utils/string-similarity.js

@@ -10,13 +10,19 @@ import { createHash } from 'crypto';
  * Returns a value between 0 (no overlap) and 1 (identical)
  */
 export function jaccardSimilarity(a, b) {
-    const setA = new Set(a.toLowerCase().split(/\s+/).filter(w => w.length > 1));
-    const setB = new Set(b.toLowerCase().split(/\s+/).filter(w => w.length > 1));
+    const setA = new Set(a
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((w) => w.length > 1));
+    const setB = new Set(b
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((w) => w.length > 1));
     if (setA.size === 0 && setB.size === 0)
         return 1;
     if (setA.size === 0 || setB.size === 0)
         return 0;
-    const intersection = new Set([...setA].filter(x => setB.has(x)));
+    const intersection = new Set([...setA].filter((x) => setB.has(x)));
     const union = new Set([...setA, ...setB]);
     return intersection.size / union.size;
 }
@@ -31,28 +37,11 @@ export function contentHash(text) {
         .slice(0, 16); // 16 hex chars = 64 bits, sufficient for dedup
 }
 /**
- * Improved token estimation
- * More accurate than simple length/4 for mixed code and prose
+ * Improved token estimation — delegates to the canonical implementation
+ * in context-compressor.ts to maintain a single source of truth.
+ * Kept as a public API alias for backward compatibility.
  */
-export function estimateTokensAccurate(text) {
-    if (!text || text.length === 0)
-        return 0;
-    // Split by whitespace and count
-    const words = text.split(/\s+/).filter(w => w.length > 0);
-    // Count special characters that typically become separate tokens
-    const specialChars = (text.match(/[{}()\[\]<>:;,."'`@#$%^&*+=|\\/?!~-]/g) || []).length;
-    // Code tokens: variable names split on camelCase/snake_case
-    const codeTokens = (text.match(/[a-z][A-Z]|_[a-z]/g) || []).length;
-    // Numbers often tokenize separately
-    const numbers = (text.match(/\d+/g) || []).length;
-    // Base: words + adjustments
-    // Average English word is ~1.3 tokens, code identifiers ~1.5
-    const baseTokens = words.length * 1.3;
-    const specialTokens = specialChars * 0.5;
-    const extraCodeTokens = codeTokens * 0.3;
-    const numberTokens = numbers * 0.5;
-    return Math.ceil(baseTokens + specialTokens + extraCodeTokens + numberTokens);
-}
+export { estimateTokens as estimateTokensAccurate } from '../memory/context-compressor.js';
 /**
  * Simple stemming for keyword matching
  * Handles common English suffixes for better fuzzy matching
@@ -60,7 +49,20 @@ export function estimateTokensAccurate(text) {
 export function simpleStem(word) {
     const lower = word.toLowerCase();
     // Common suffixes to strip
-    const suffixes = ['ing', 'ed', 'es', 's', 'er', 'est', 'ly', 'tion', 'ment', 'ness', 'able', 'ible'];
+    const suffixes = [
+        'ing',
+        'ed',
+        'es',
+        's',
+        'er',
+        'est',
+        'ly',
+        'tion',
+        'ment',
+        'ness',
+        'able',
+        'ible',
+    ];
     for (const suffix of suffixes) {
         if (lower.endsWith(suffix) && lower.length > suffix.length + 2) {
             const stem = lower.slice(0, -suffix.length);
@@ -95,6 +97,28 @@ export function fuzzyKeywordMatch(text, keyword) {
     }
     return false;
 }
+/**
+ * Calculate cosine similarity between two numeric vectors.
+ * Shared implementation used by EmbeddingService and ServerlessQdrantManager.
+ * Returns a value between -1 (opposite) and 1 (identical).
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error('Vectors must have same dimensions');
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dotProduct / denominator;
+}
 /**
  * Calculate text similarity using multiple methods
  * Returns weighted average for more robust comparison

package/dist/utils/string-similarity.js.map

@@ -1 +1 @@
-{"version":3,"file":"string-similarity.js","sourceRoot":"","sources":["../../src/utils/string-similarity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"string-similarity.js","sourceRoot":"","sources":["../../src/utils/string-similarity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAS,EAAE,CAAS;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,CAAC;SACE,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAC/B,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,CAAC;SACE,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAC/B,CAAC;IAEF,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAE1C,OAAO,YAAY,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;SACtD,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,+CAA+C;AAClE,CAAC;AAED;;;;GAIG;AACH,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE3F;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEjC,2BAA2B;IAC3B,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,GAAG;QACH,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5C,6CAA6C;YAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACvE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAE3C,oBAAoB;IACpB,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAElD,gBAAgB;IAChB,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAClD,uEAAuE;QACvE,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACzE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,UAAU,GAAG,WAAW,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS;IACjD,mBAAmB;IACnB,MAAM,OAAO,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAExC,8BAA8B;IAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E,uBAAuB;IACvB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC"}

package/docs/INDEX.md

@@ -1,66 +1,67 @@
-# UAP Documentation Index
+# UAP Documentation
 
-> Universal Agent Protocol v1.0.0 - Documentation Hub
+> @miller-tech/uap -- Documentation Hub
 
 ---
 
 ## Getting Started
 
-- [Overview](getting-started/OVERVIEW.md) - What is UAP, core concepts, 4-layer memory architecture
-- [Setup](getting-started/SETUP.md) - Installation, dependencies, configuration
-- [Integration](getting-started/INTEGRATION.md) - opencode, ForgeCode, Claude Code, VSCode
+- [Overview](getting-started/OVERVIEW.md) -- What is UAP, core concepts, 4-layer memory architecture
+- [Setup](getting-started/SETUP.md) -- Installation, dependencies, configuration
+- [Integration](getting-started/INTEGRATION.md) -- Claude Code, Factory.AI, OpenCode, ForgeCode, VSCode, Cursor
 
 ## Architecture
 
-- [System Analysis](architecture/SYSTEM_ANALYSIS.md) - Complete UAP feature analysis and architecture
-- [Multi-Model Architecture](architecture/MULTI_MODEL.md) - Planner/executor two-tier design (92-98% cost reduction)
-- [UAP Protocol](architecture/UAP_PROTOCOL.md) - Protocol v1.0 specification and compliance requirements
-- [UAP Compliance](architecture/UAP_COMPLIANCE.md) - Protocol deviations and enforcement plan
-- [Strict Droids](architecture/UAP_STRICT_DROIDS.md) - JSON schema validation for droid definitions
+- [System Analysis](architecture/SYSTEM_ANALYSIS.md) -- Complete UAP feature analysis and architecture
+- [Multi-Model Architecture](architecture/MULTI_MODEL.md) -- Planner/executor two-tier design
+- [UAP Protocol](architecture/UAP_PROTOCOL.md) -- Protocol specification and compliance requirements
+- [UAP Compliance](architecture/UAP_COMPLIANCE.md) -- Protocol enforcement plan
+- [Strict Droids](architecture/UAP_STRICT_DROIDS.md) -- JSON schema validation for droid definitions
 
 ## Reference
 
-- [API Reference](reference/API_REFERENCE.md) - CLI commands, DB schema, API endpoints
-- [CLI Reference](reference/UAP_CLI_REFERENCE.md) - UAP CLI command reference (init, task, memory, worktree)
-- [Feature Inventory](reference/FEATURES.md) - Complete feature status and implementation details
+- [API Reference](reference/API_REFERENCE.md) -- CLI commands, DB schema, API endpoints
+- [CLI Reference](reference/UAP_CLI_REFERENCE.md) -- Full CLI command reference (25 commands, 109 subcommands)
+- [Feature Inventory](reference/FEATURES.md) -- Complete feature status and implementation details
+- [Harness Matrix](reference/HARNESS-MATRIX.md) -- Per-harness integration details
 
 ## Deployment
 
-- [Deployment Guide](deployment/DEPLOYMENT.md) - Model providers, IaC, CI/CD pipelines
-- [Deployment Strategies](deployment/DEPLOYMENT_STRATEGIES.md) - Window bucketing, batch processing, resource isolation
-- [Deploy Batching](deployment/DEPLOY_BATCHING.md) - Batch windows and bucketing system
-- [Deploy Batcher Analysis](deployment/DEPLOY_BATCHER_ANALYSIS.md) - DeployBatcher class architecture deep-dive
-- [Deploy Bucketing Analysis](deployment/DEPLOY_BUCKETING_ANALYSIS.md) - Bucketing capability report
-- [Qwen3.5 / llama.cpp](deployment/QWEN35_LLAMA_CPP.md) - Local LLM deployment with LoRA fine-tuning
+- [Deployment Guide](deployment/DEPLOYMENT.md) -- Model providers, IaC, CI/CD pipelines
+- [Deployment Strategies](deployment/DEPLOYMENT_STRATEGIES.md) -- Window bucketing, batch processing
+- [Deploy Batching](deployment/DEPLOY_BATCHING.md) -- Batch windows and bucketing system
+- [Deploy Batcher Analysis](deployment/DEPLOY_BATCHER_ANALYSIS.md) -- DeployBatcher architecture
+- [Deploy Bucketing Analysis](deployment/DEPLOY_BUCKETING_ANALYSIS.md) -- Bucketing capability report
+- [Qwen3.5 / llama.cpp](deployment/QWEN35_LLAMA_CPP.md) -- Local LLM deployment with LoRA fine-tuning
 
 ## Integrations
 
-- [MCP Router](integrations/MCP_ROUTER_SETUP.md) - 98% token reduction via meta-tool routing
-- [RTK Integration](integrations/RTK_INTEGRATION.md) - Rust Token Killer CLI proxy analysis
+- [MCP Router](integrations/MCP_ROUTER_SETUP.md) -- 98% token reduction via meta-tool routing
+- [RTK Integration](integrations/RTK_INTEGRATION.md) -- Rust Token Killer CLI proxy
 
 ## Benchmarks
 
-- [Validation Plan](benchmarks/VALIDATION_PLAN.md) - Benchmark methodology and test cases
-- [Validation Results](benchmarks/VALIDATION_RESULTS.md) - Benchmark results (49.7% token reduction)
-- [Token Optimization](benchmarks/TOKEN_OPTIMIZATION.md) - Per-feature token savings analysis
-- [Accuracy Analysis](benchmarks/ACCURACY_ANALYSIS.md) - Internal vs Terminal-Bench comparison
+- [Validation Plan](benchmarks/VALIDATION_PLAN.md) -- Benchmark methodology and test cases
+- [Validation Results](benchmarks/VALIDATION_RESULTS.md) -- Benchmark results
+- [Token Optimization](benchmarks/TOKEN_OPTIMIZATION.md) -- Per-feature token savings analysis
+- [Accuracy Analysis](benchmarks/ACCURACY_ANALYSIS.md) -- Internal vs Terminal-Bench comparison
 
 ## Research
 
-- [Memory Systems Comparison](research/MEMORY_SYSTEMS_COMPARISON.md) - MemGPT, LangGraph, Mem0, A-MEM analysis
-- [Behavioral Patterns](research/BEHAVIORAL_PATTERNS.md) - Pattern analysis from 54-task Terminal-Bench
-- [Terminal-Bench Learnings](research/TERMINAL_BENCH_LEARNINGS.md) - Universal agent patterns discovered
-- [Performance Analysis](research/PERFORMANCE_ANALYSIS_2026-01-18.md) - UAP v1.0.2 vs baseline benchmarking
-- [Pattern Analysis](research/PATTERN_ANALYSIS_2026-01-18.md) - v1.1.0 deep failure study
-- [Performance Test Plan](research/PERFORMANCE_TEST_PLAN.md) - Vanilla vs UAP-enhanced droid test plan
-- [Domain Strategies](research/DOMAIN_STRATEGIES.md) - CoreWars, specialized task guides
+- [Memory Systems Comparison](research/MEMORY_SYSTEMS_COMPARISON.md) -- MemGPT, LangGraph, Mem0, A-MEM analysis
+- [Behavioral Patterns](research/BEHAVIORAL_PATTERNS.md) -- Pattern analysis from Terminal-Bench
+- [Terminal-Bench Learnings](research/TERMINAL_BENCH_LEARNINGS.md) -- Universal agent patterns discovered
+- [Performance Analysis](research/PERFORMANCE_ANALYSIS_2026-01-18.md) -- UAP vs baseline benchmarking
+- [Pattern Analysis](research/PATTERN_ANALYSIS_2026-01-18.md) -- Deep failure study
+- [Performance Test Plan](research/PERFORMANCE_TEST_PLAN.md) -- Vanilla vs UAP-enhanced test plan
+- [Domain Strategies](research/DOMAIN_STRATEGIES.md) -- CoreWars, specialized task guides
 
 ## Operations
 
-- [Troubleshooting](operations/TROUBLESHOOTING.md) - Common issues, recovery procedures, debugging
+- [Troubleshooting](operations/TROUBLESHOOTING.md) -- Common issues, recovery procedures, debugging
 
 ---
 
 ## Archive
 
-Historical documents preserved for reference in [archive/](archive/). These are superseded or point-in-time documents that are no longer actively maintained.
+Historical documents preserved for reference in [archive/](archive/).

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@miller-tech/uap",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
     "uap": "./dist/bin/cli.js",
-    "uap-tool-calls": "./dist/bin/tool-calls.js",
     "uap-tool-call-test": "./tools/agents/scripts/tool_call_test.py",
     "uap-tool-call-wrapper": "./tools/agents/scripts/tool_call_wrapper.py",
     "uap-template-verify": "./tools/agents/scripts/chat_template_verifier.py",
@@ -25,19 +24,17 @@
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
     "format": "prettier --write src/**/*.ts",
-    "prepare": "npm run build",
     "prepublishOnly": "npm run build && npm test",
-    "install:web": "bash scripts/install-web.sh",
-    "install:desktop": "bash scripts/install-desktop.sh",
-    "install:all": "bash scripts/install.sh",
-    "install:cloakbrowser": "tsx scripts/install-cloakbrowser.ts",
-    "postinstall": "echo '\n✨ Run: npx universal-agent-protocol init --interactive'",
+    "install:web": "bash scripts/setup/install-web.sh",
+    "install:desktop": "bash scripts/setup/install-desktop.sh",
+    "install:cloakbrowser": "tsx scripts/setup/install-cloakbrowser.ts",
+    "postinstall": "echo '\n✨ Run: npx @miller-tech/uap init --interactive'",
     "version:patch": "bash scripts/version-bump.sh patch",
     "version:minor": "bash scripts/version-bump.sh minor",
     "version:major": "bash scripts/version-bump.sh major",
-    "update-uap": "bash scripts/update-uap-compliance.sh",
-    "verify-uap": "bash scripts/verify-compliance.sh",
-    "check-claude": "bash scripts/verify-compliance.sh"
+    "update-uap": "bash scripts/maintenance/update-uap-compliance.sh",
+    "verify-uap": "bash scripts/maintenance/verify-compliance.sh",
+    "check-claude": "bash scripts/maintenance/verify-compliance.sh"
   },
   "keywords": [
     "claude",
@@ -107,11 +104,13 @@
   "files": [
     "dist",
     "docs",
-    "benchmark-results",
+    "config",
     "templates",
     "tools/agents",
-    "scripts/install-cloakbrowser.ts",
-    "scripts/convert-policy-to-claude.ts",
+    "scripts/setup",
+    "scripts/version-bump.sh",
+    "scripts/validate-build.sh",
+    "scripts/maintenance",
     "README.md",
     "LICENSE"
   ]

package/scripts/maintenance/publish-npm.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+# Quick NPM Publish Script - Triggers GitHub Actions Workflow
+
+set -e
+
+VERSION=$(node -p 'require("./package.json").version' 2>/dev/null || echo "unknown")
+echo "=========================================="
+echo "  Universal Agent Protocol v${VERSION}"
+echo "  Publishing to NPM..."
+echo "=========================================="
+echo ""
+
+REPO="DammianMiller/universal-agent-protocol"
+WORKFLOW_ID="deploy-publish.yml"
+
+# Check if gh CLI is installed
+if ! command -v gh &> /dev/null; then
+    echo "❌ GitHub CLI (gh) not found!"
+    echo ""
+    echo "Install it first:"
+    echo "  macOS: brew install gh"
+    echo "  Linux: https://cli.github.com/"
+    echo "  Windows: winget install github.cli"
+    echo ""
+    echo "Then run this script again."
+    exit 1
+fi
+
+# Check if logged in to GitHub
+if ! gh auth status &> /dev/null; then
+    echo "❌ Not logged in to GitHub!"
+    echo ""
+    echo "Login first:"
+    echo "  gh auth login"
+    echo ""
+    echo "Use -H flag for HTTP host if needed."
+    exit 1
+fi
+
+echo "✅ GitHub CLI authenticated"
+echo ""
+
+# Get workflow ID
+echo "🔄 Fetching workflow information..."
+WORKFLOW_ID=$(gh api "/repos/$REPO/actions/workflows" \
+  --jq '.workflows[] | select(.name == "Build, Test & Publish to NPM") | .id')
+
+if [ -z "$WORKFLOW_ID" ]; then
+    echo "❌ Could not find workflow: $WORKFLOW_ID"
+    exit 1
+fi
+
+echo "✅ Found workflow ID: $WORKFLOW_ID"
+echo ""
+
+# Trigger the workflow
+echo "🚀 Triggering publish workflow..."
+RESPONSE=$(gh api \
+  --method POST \
+  "/repos/$REPO/actions/workflows/${WORKFLOW_ID}/dispatches" \
+  -f ref="master" \
+  -f inputs='{"publish":"true","dry_run":"false"}')
+
+echo "$RESPONSE" | jq '.workflow_run.id' > /tmp/run_id.txt
+RUN_ID=$(cat /tmp/run_id.txt)
+
+if [ -z "$RUN_ID" ]; then
+    echo "❌ Failed to trigger workflow"
+    exit 1
+fi
+
+echo ""
+echo "✅ Workflow triggered successfully!"
+echo ""
+echo "📊 Run ID: $RUN_ID"
+echo ""
+echo "Monitor progress at:"
+echo "https://github.com/$REPO/actions/runs/$RUN_ID"
+echo ""
+echo "=========================================="
+echo "  Your NPM publish is in progress!"
+echo "=========================================="

package/scripts/maintenance/publish.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Publishing universal-agent-protocol to npm..."
+
+# Check if NPM_TOKEN is set
+if [ -z "$NPM_TOKEN" ]; then
+  echo "❌ Error: NPM_TOKEN environment variable is not set"
+  echo "   Please set it before running this script"
+  exit 1
+fi
+
+# Build the project
+echo "📦 Building project..."
+npm run build
+
+# Run tests
+echo "🧪 Running tests..."
+npm test
+
+# Run lint
+echo "🔍 Running lint..."
+npm run lint
+
+# Publish to npm
+echo "📤 Publishing to npm..."
+npm publish --access public
+
+echo "✅ Published successfully!"

package/scripts/maintenance/update-droids.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+"""Update all droids with v2.3.0 compatibility headers."""
+
+import os
+
+DROIDS_DIR = os.path.join(
+    os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
+    ".factory",
+    "droids",
+)
+
+droids = [
+    "code-quality-guardian",
+    "debug-expert",
+    "documentation-expert",
+    "ml-training-expert",
+    "performance-optimizer",
+    "security-auditor",
+    "sysadmin-expert",
+    "terminal-bench-optimizer",
+]
+
+
+def update_droid_file(droid_name):
+    droid_file = os.path.join(DROIDS_DIR, f"{droid_name}.md")
+
+    if not os.path.exists(droid_file):
+        print(f"  ✗ {droid_name}: File not found")
+        return False
+
+    with open(droid_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    if "CLAUDE.md v2.3.0" in content and "@Skill:" in content:
+        print(f"  - {droid_name}: Already current")
+        return True
+
+    lines = content.split("\n")
+
+    title_idx = None
+    for i, line in enumerate(lines):
+        if line.startswith("# ") or line.startswith("## "):
+            title_idx = i
+            break
+
+    if title_idx is None:
+        print(f"  ⚠ {droid_name}: No heading found")
+        return False
+
+    compat_note = f"""> **Compatibility**: CLAUDE.md v2.3.0+  
+> **Integration**: Invoked via `Task(subagent_type: "{droid_name}", prompt: "...")` in PARALLEL REVIEW PROTOCOL  
+> **Skill Loading**: This droid can load domain-specific guidance via `@Skill:<skill-name>.md` when applicable
+"""
+
+    lines.insert(title_idx + 1, compat_note)
+
+    if "MANDATORY" not in content:
+        for i, line in enumerate(lines):
+            if line.startswith("## ") and i > title_idx + 3:
+                before_section = lines[:i]
+                after_section = lines[i:]
+
+                mandatory_check = """
+### MANDATORY Pre-Checks
+
+Before applying this droid's guidance:
+
+- [ ] **MANDATORY**: Worktree created (`uam worktree create <slug>`)
+- [ ] Schema diff gate completed (if tests involved)
+- [ ] Environment check performed
+- [ ] Memory queried for relevant past failures
+- [ ] Parallel review protocol followed
+
+"""
+                lines = before_section + [mandatory_check] + after_section
+                break
+
+    with open(droid_file, "w", encoding="utf-8") as f:
+        f.write("\n".join(lines))
+
+    print(f"  ✓ {droid_name}: Updated")
+    return True
+
+
+print("=== Updating Droids for CLAUDE.md v2.3.0 ===\n")
+
+updated = 0
+for droid in droids:
+    if update_droid_file(droid):
+        updated += 1
+
+print(f"\n=== Summary ===")
+print(f"Updated: {updated}/{len(droids)} droids")

package/scripts/maintenance/update-skills.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+"""Update all skills with v2.3.0 compatibility headers and protocol references."""
+
+import os
+from pathlib import Path
+
+SKILLS_DIR = os.path.join(
+    os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))),
+    ".factory",
+    "skills",
+)
+
+skills_to_update = {
+    "chess-engine": ("Game AI", ["chess", "engine", "analysis", "game"]),
+    "codebase-navigator": (
+        "Navigation",
+        ["navigate", "codebase", "explore", "understand"],
+    ),
+    "compression": ("Algorithms", ["compress", "optimize", "size", "minify"]),
+    "git-forensics": ("Git", ["git", "history", "forensics", "recover", "blame"]),
+    "near-miss": ("Debugging", ["near miss", "bug", "error", "debug", "fix"]),
+    "polyglot": ("Localization", ["polyglot", "i18n", "l10n", "translation", "locale"]),
+    "service-config": ("Configuration", ["config", "configuration", "settings", "env"]),
+    "terminal-bench-strategies": (
+        "Benchmarking",
+        ["terminal-bench", "benchmark", "test", "evaluate"],
+    ),
+}
+
+
+def add_rtk_header(content, skill_name):
+    rtk_addition = f"""---
+name: {skill_name}
+version: "2.0.0"
+compatibility: CLAUDE.md v2.3.0+
+---
+
+> **RTK Integration**: Supports `@hooks-session-start.md`, `@PreCompact.md`
+
+"""
+    if content.startswith("---"):
+        end_frontmatter = content.find("---", 3)
+        if end_frontmatter > 0:
+            return (
+                content[: end_frontmatter + 3]
+                + rtk_addition
+                + content[end_frontmatter + 3 :]
+            )
+    return rtk_addition + content
+
+
+def add_decision_loop_ref(content, skill_name):
+    decision_loop = f"""
+## Protocol Integration
+
+### DECISION LOOP Position
+
+This skill applies at **step 5** of the DECISION LOOP:
+
+```
+1. CLASSIFY  -> complexity? backup needed? tools?
+2. PROTECT   -> cp file file.bak (for configs, DBs)
+3. MEMORY    -> query relevant context + past failures
+4. AGENTS    -> check overlaps (if multi-agent)
+5. SKILLS    -> @Skill:{skill_name}.md for domain-specific guidance
+6. WORK      -> implement (ALWAYS use worktree for ANY file changes)
+7. REVIEW    -> self-review diff before testing
+8. TEST      -> completion gates pass
+9. LEARN     -> store outcome in memory
+```
+"""
+    if "# " in content:
+        first_heading = content.find("# ")
+        return content[:first_heading] + decision_loop + content[first_heading:]
+    return content
+
+
+def add_uam_compliance(content):
+    uam_section = """
+## UAM Protocol Compliance
+
+### MANDATORY Worktree Enforcement
+
+Before applying this skill:
+- [ ] **MANDATORY**: Worktree created (`uam worktree create <slug>`)
+- [ ] Schema diff gate completed (if tests involved)
+- [ ] Environment check performed
+- [ ] Memory queried for relevant past failures
+
+### Completion Gates Checklist
+
+```
+[x] Schema diffed against test expectations
+[x] Tests: X/Y (must be 100%, run 3+ times)
+[x] Outputs verified: ls -la
+[x] Worktree created and PR prepared
+[x] MANDATORY cleanup after PR merge
+```
+"""
+    if "## Common Pitfalls" in content:
+        return content.replace(
+            "## Common Pitfalls", uam_section + "\n## Common Pitfalls"
+        )
+    if "## References" in content:
+        return content.replace("## References", uam_section + "\n## References")
+    return content + "\n\n" + uam_section
+
+
+def update_skill_file(skill_dir, skill_name):
+    skill_file = os.path.join(skill_dir, "SKILL.md")
+
+    if not os.path.exists(skill_file):
+        print(f"  ✗ {skill_name}: SKILL.md not found")
+        return False
+
+    with open(skill_file, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    original_content = content
+    content = add_rtk_header(content, skill_name)
+    content = add_decision_loop_ref(content, skill_name)
+    content = add_uam_compliance(content)
+
+    if content != original_content:
+        with open(skill_file, "w", encoding="utf-8") as f:
+            f.write(content)
+        print(f"  ✓ {skill_name}: Updated")
+        return True
+
+    print(f"  - {skill_name}: Already updated")
+    return False
+
+
+print("=== Updating Skills for CLAUDE.md v2.3.0 ===\n")
+
+updated = 0
+for skill_name, (category, triggers) in skills_to_update.items():
+    skill_dir = os.path.join(SKILLS_DIR, skill_name)
+
+    if not os.path.exists(skill_dir):
+        print(f"  ✗ {skill_name}: Directory not found")
+        continue
+
+    if update_skill_file(skill_dir, skill_name):
+        updated += 1
+
+print(f"\n=== Summary ===")
+print(f"Updated: {updated}/{len(skills_to_update)} skills")