swarmdo 1.27.0 → 1.30.0

package/.claude/helpers/auto-memory-hook.mjs

@@ -13,7 +13,7 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -52,13 +52,30 @@ async function gracefulExit(signal) {
 process.on('SIGTERM', () => { gracefulExit('SIGTERM'); });
 process.on('SIGINT', () => { gracefulExit('SIGINT'); });
 
-// Ensure data dir
-if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
-
 // ============================================================================
 // Simple JSON File Backend (implements IMemoryBackend interface)
 // ============================================================================
 
+// Collapse entries that are the SAME memory — identical content signature but
+// distinct ids — keeping the first occurrence. The auto-memory bridge
+// historically re-imported every session with a fresh random id, bloating the
+// store ~22x (#53); this heals already-bloated stores and de-dupes defensively.
+// Keyed by namespace + content hash (or raw content) so genuinely distinct
+// memories are never merged. Pure.
+function dedupeByContentSignature(entries) {
+  const seen = new Set();
+  const out = [];
+  for (const e of entries) {
+    const ns = (e && e.namespace) || 'default';
+    const body = (e && e.metadata && e.metadata.contentHash) || (e && (e.content || e.value)) || '';
+    const sig = ns + '\u0001' + body;
+    if (seen.has(sig)) continue;
+    seen.add(sig);
+    out.push(e);
+  }
+  return out;
+}
+
 class JsonFileBackend {
   constructor(filePath) {
     this.filePath = filePath;
@@ -70,7 +87,12 @@ class JsonFileBackend {
       try {
         const data = JSON.parse(readFileSync(this.filePath, 'utf-8'));
         if (Array.isArray(data)) {
-          for (const entry of data) this.entries.set(entry.id, entry);
+          // Collapse content-duplicates left by the pre-#53 import bug (same
+          // memory re-imported each session under a fresh id). Auto-heals an
+          // already-bloated store by rewriting it once when dupes are dropped.
+          const deduped = dedupeByContentSignature(data);
+          for (const entry of deduped) this.entries.set(entry.id, entry);
+          if (deduped.length < data.length) this._persist();
         }
       } catch { /* start fresh */ }
     }
@@ -99,7 +121,11 @@ class JsonFileBackend {
   async query(opts) {
     let results = [...this.entries.values()];
     if (opts?.namespace) results = results.filter(e => e.namespace === opts.namespace);
-    if (opts?.type) results = results.filter(e => e.type === opts.type);
+    // NOTE: opts.type is the QueryType search STRATEGY (semantic|keyword|hybrid|…),
+    // NOT an entry MemoryType. This JSON backend has no vector search, so the
+    // strategy is moot — filtering entries by it excluded everything (a 'hybrid'
+    // query matched no 'semantic' entries), which zeroed out the bridge's
+    // content-hash dedup and let the store bloat ~22x per re-import (#53).
     if (opts?.limit) results = results.slice(0, opts.limit);
     return results;
   }
@@ -613,33 +639,44 @@ async function doImportAll() {
 // Main
 // ============================================================================
 
-const command = process.argv[2] || 'status';
-
-// Dynamic import() failures can surface as unhandled rejections on a later
-// microtask even when the awaiting call site already caught them, which would
-// otherwise force a non-zero exit. Swallow to keep hooks exit-0, but surface the
-// reason under SWARMDO_DEBUG/DEBUG so genuine async bugs aren't silently hidden
-// (FIX 2 — the previous `() => {}` discarded every rejection process-wide).
-process.on('unhandledRejection', (reason) => {
-  if (DEBUG) {
-    const detail = reason && reason.message ? reason.message : String(reason);
-    process.stderr.write(`[AutoMemory] unhandledRejection (suppressed): ${detail}\n`);
-  }
-});
-
-try {
-  switch (command) {
-    case 'import': await doImport(); break;
-    case 'import-all': await doImportAll(); break;
-    case 'sync': await doSync(); break;
-    case 'status': await doStatus(); break;
-    default:
-      console.log('Usage: auto-memory-hook.mjs <import|sync|status>');
-      process.exit(1);
+// Only dispatch CLI commands when this file is executed directly
+// (`node auto-memory-hook.mjs …`), NOT when it is imported by a test —
+// importing must not run a command or exit the process (#53 regression test
+// imports JsonFileBackend + dedupeByContentSignature below).
+if (import.meta.url === pathToFileURL(process.argv[1] || '').href) {
+  // Ensure data dir (only when actually running a command, not on import)
+  if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
+  const command = process.argv[2] || 'status';
+
+  // Dynamic import() failures can surface as unhandled rejections on a later
+  // microtask even when the awaiting call site already caught them, which would
+  // otherwise force a non-zero exit. Swallow to keep hooks exit-0, but surface the
+  // reason under SWARMDO_DEBUG/DEBUG so genuine async bugs aren't silently hidden
+  // (FIX 2 — the previous `() => {}` discarded every rejection process-wide).
+  process.on('unhandledRejection', (reason) => {
+    if (DEBUG) {
+      const detail = reason && reason.message ? reason.message : String(reason);
+      process.stderr.write(`[AutoMemory] unhandledRejection (suppressed): ${detail}\n`);
+    }
+  });
+
+  try {
+    switch (command) {
+      case 'import': await doImport(); break;
+      case 'import-all': await doImportAll(); break;
+      case 'sync': await doSync(); break;
+      case 'status': await doStatus(); break;
+      default:
+        console.log('Usage: auto-memory-hook.mjs <import|sync|status>');
+        process.exit(1);
+    }
+  } catch (err) {
+    // Hooks must never crash Claude Code - fail silently
+    dim(`Error (non-critical): ${err.message}`);
   }
-} catch (err) {
-  // Hooks must never crash Claude Code - fail silently
-  dim(`Error (non-critical): ${err.message}`);
+  // Ensure clean exit for Claude Code hooks (exit 0 = success, no stderr = no error)
+  process.exit(0);
 }
-// Ensure clean exit for Claude Code hooks (exit 0 = success, no stderr = no error)
-process.exit(0);
+
+// Exported for unit tests (the run-guard above keeps import side-effect-free).
+export { JsonFileBackend, dedupeByContentSignature };

package/.claude-plugin/README.md

@@ -297,7 +297,7 @@ Then in Claude Code:
 
 ```bash
 # Add MCP servers to Claude Code
-claude mcp add swarmdo npx swarmdo@alpha mcp start
+claude mcp add swarmdo npx swarmdo@latest mcp start
 claude mcp add swarmdo-swarm npx swarmdo-swarm mcp start  # Optional
 ```
 
@@ -350,7 +350,7 @@ cp -r agents ~/.claude/agents/
 
 ```bash
 # Run setup via npx
-npx swarmdo@alpha init --plugin
+npx swarmdo@latest init --plugin
 
 # This will:
 # 1. Create .claude directory
@@ -499,7 +499,7 @@ Swarmdo integrates with 3 MCP servers providing 110+ tools:
   "mcpServers": {
     "swarmdo": {
       "command": "npx",
-      "args": ["swarmdo@alpha", "mcp", "start"]
+      "args": ["swarmdo@latest", "mcp", "start"]
     }
   }
 }

package/.claude-plugin/docs/INSTALLATION.md

@@ -128,7 +128,7 @@ The plugin defines MCP servers, but you may need to install the packages:
 
 ```bash
 # Core MCP (recommended)
-npm install -g swarmdo@alpha
+npm install -g swarmdo@latest
 
 # Optional enhanced coordination
 npm install -g swarmdo-swarm

package/.claude-plugin/docs/PLUGIN_SUMMARY.md

@@ -337,7 +337,7 @@ The plugin is configured via `.claude-plugin/plugin.json`:
   "mcpServers": {
     "swarmdo": {
       "command": "npx",
-      "args": ["swarmdo@alpha", "mcp", "start"]
+      "args": ["swarmdo@latest", "mcp", "start"]
     }
   }
 }

package/.claude-plugin/docs/QUICKSTART.md

@@ -202,7 +202,7 @@ The swarm automatically:
 
 ```bash
 # Core MCP (required)
-claude mcp add swarmdo npx swarmdo@alpha mcp start
+claude mcp add swarmdo npx swarmdo@latest mcp start
 
 # Enhanced coordination (optional)
 claude mcp add swarmdo-swarm npx swarmdo-swarm mcp start
@@ -296,10 +296,10 @@ ls ~/.claude/commands/
 cat ~/.claude/settings.json
 
 # Verify MCP package
-npx swarmdo@alpha --version
+npx swarmdo@latest --version
 
 # Reinstall if needed
-npm install -g swarmdo@alpha
+npm install -g swarmdo@latest
 ```
 
 ### Agents Not Spawning

package/.claude-plugin/hooks/hooks.json

@@ -50,6 +50,10 @@
           {
             "type": "command",
             "command": "/bin/bash -c 'INPUT=$(cat); CUSTOM=$(echo \"$INPUT\" | jq -r \".custom_instructions // \\\"\\\"\"); echo \"🔄 PreCompact Guidance:\"; echo \"📋 IMPORTANT: Review CLAUDE.md in project root for:\"; echo \"   • 54 available agents and concurrent usage patterns\"; echo \"   • Swarm coordination strategies (hierarchical, mesh, adaptive)\"; echo \"   • SPARC methodology workflows with batchtools optimization\"; echo \"   • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)\"; if [ -n \"$CUSTOM\" ]; then echo \"🎯 Custom compact instructions: $CUSTOM\"; fi; echo \"✅ Ready for compact operation\"'"
+          },
+          {
+            "type": "command",
+            "command": "/bin/bash -c '\"${CLAUDE_PLUGIN_ROOT}/bin/swarmdo\" compact-snapshot write || true'"
           }
         ]
       },
@@ -59,11 +63,15 @@
           {
             "type": "command",
             "command": "/bin/bash -c 'echo \"🔄 Auto-Compact Guidance (Context Window Full):\"; echo \"📋 CRITICAL: Before compacting, ensure you understand:\"; echo \"   • All 54 agents available in .claude/agents/ directory\"; echo \"   • Concurrent execution patterns from CLAUDE.md\"; echo \"   • Batchtools optimization for 300% performance gains\"; echo \"   • Swarm coordination strategies for complex tasks\"; echo \"⚡ Apply GOLDEN RULE: Always batch operations in single messages\"; echo \"✅ Auto-compact proceeding with full agent context\"'"
+          },
+          {
+            "type": "command",
+            "command": "/bin/bash -c '\"${CLAUDE_PLUGIN_ROOT}/bin/swarmdo\" compact-snapshot write || true'"
           }
         ]
       }
     ],
-    "Stop": [
+    "SessionEnd": [
       {
         "hooks": [
           {
@@ -72,6 +80,16 @@
           }
         ]
       }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c '\"${CLAUDE_PLUGIN_ROOT}/bin/swarmdo\" compact-snapshot read || true'"
+          }
+        ]
+      }
     ]
   }
 }

package/.claude-plugin/marketplace.json

@@ -2,8 +2,8 @@
   "name": "swarmdo",
   "description": "Swarmdo Marketplace: Claude Code native agents, swarms, workers, and MCP tools for continuous software engineering",
   "owner": {
-    "name": "upstream",
-    "url": "https://the upstream project (see NOTICE)"
+    "name": "SwarmDo",
+    "url": "https://github.com/SwarmDo/swarmdo"
   },
   "plugins": [
     {
@@ -74,7 +74,7 @@
     {
       "name": "swarmdo-agent",
       "source": "./plugins/swarmdo-agent",
-      "description": "Agent runtimes \u2014 local WASM-sandboxed agents (rvagent) + Anthropic Claude Managed Agents (cloud); one interface, local-vs-cloud backends"
+      "description": "Agent runtimes — local WASM-sandboxed agents (rvagent) + Anthropic Claude Managed Agents (cloud); one interface, local-vs-cloud backends"
     },
     {
       "name": "swarmdo-workflows",
@@ -109,7 +109,7 @@
     {
       "name": "swarmdo-adr",
       "source": "./plugins/swarmdo-adr",
-      "description": "ADR lifecycle management \u2014 create, index, supersede, and link Architecture Decision Records to code"
+      "description": "ADR lifecycle management — create, index, supersede, and link Architecture Decision Records to code"
     },
     {
       "name": "swarmdo-cost-tracker",
@@ -119,7 +119,7 @@
     {
       "name": "swarmdo-ddd",
       "source": "./plugins/swarmdo-ddd",
-      "description": "Domain-Driven Design scaffolding \u2014 bounded contexts, aggregate roots, domain events, and anti-corruption layers"
+      "description": "Domain-Driven Design scaffolding — bounded contexts, aggregate roots, domain events, and anti-corruption layers"
     },
     {
       "name": "swarmdo-federation",
@@ -129,7 +129,7 @@
     {
       "name": "swarmdo-graph-intelligence",
       "source": "./plugins/swarmdo-graph-intelligence",
-      "description": "Real-time graph intelligence \u2014 personalized PageRank, streaming delta updates, witness-signed reasoning, and federation-distributable vectors"
+      "description": "Real-time graph intelligence — personalized PageRank, streaming delta updates, witness-signed reasoning, and federation-distributable vectors"
     },
     {
       "name": "swarmdo-iot-cognitum",
@@ -139,57 +139,57 @@
     {
       "name": "swarmdo-knowledge-graph",
       "source": "./plugins/swarmdo-knowledge-graph",
-      "description": "Knowledge graph construction \u2014 entity extraction, relation mapping, and pathfinder graph traversal"
+      "description": "Knowledge graph construction — entity extraction, relation mapping, and pathfinder graph traversal"
     },
     {
       "name": "swarmdo-market-data",
       "source": "./plugins/swarmdo-market-data",
-      "description": "Market data ingestion \u2014 feed normalization, OHLCV vectorization, and HNSW-indexed pattern matching"
+      "description": "Market data ingestion — feed normalization, OHLCV vectorization, and HNSW-indexed pattern matching"
     },
     {
       "name": "swarmdo-migrations",
       "source": "./plugins/swarmdo-migrations",
-      "description": "Schema migration management \u2014 generate, validate, dry-run, and rollback database migrations"
+      "description": "Schema migration management — generate, validate, dry-run, and rollback database migrations"
     },
     {
       "name": "swarmdo-neural-trader",
       "source": "./plugins/swarmdo-neural-trader",
-      "description": "Neural trading strategies \u2014 self-learning LSTM/Transformer/N-BEATS models with Rust/NAPI backtesting"
+      "description": "Neural trading strategies — self-learning LSTM/Transformer/N-BEATS models with Rust/NAPI backtesting"
     },
     {
       "name": "swarmdo-observability",
       "source": "./plugins/swarmdo-observability",
-      "description": "Structured logging, distributed tracing, and metrics \u2014 correlate agent swarm activity with application telemetry"
+      "description": "Structured logging, distributed tracing, and metrics — correlate agent swarm activity with application telemetry"
     },
     {
       "name": "swarmdo-swarmvector",
       "source": "./plugins/swarmdo-swarmvector",
-      "description": "Self-learning vector database \u2014 HNSW, FlashAttention-3, Graph RAG, hybrid search, DiskANN, and Brain AGI"
+      "description": "Self-learning vector database — HNSW, FlashAttention-3, Graph RAG, hybrid search, DiskANN, and Brain AGI"
     },
     {
       "name": "swarmdo-sparc",
       "source": "./plugins/swarmdo-sparc",
-      "description": "SPARC methodology \u2014 Specification, Pseudocode, Architecture, Refinement, Completion phases with quality gates"
+      "description": "SPARC methodology — Specification, Pseudocode, Architecture, Refinement, Completion phases with quality gates"
     },
     {
       "name": "swarmdo-metaharness",
       "source": "./plugins/swarmdo-metaharness",
-      "description": "MetaHarness integration \u2014 surfaces score/genome/mint/mcp-scan/threat-model via skills; pairs with @metaharness/router (ADR-148/149) for cost-optimal model routing; honors ADR-150 optional-augmentation constraint"
+      "description": "MetaHarness integration — surfaces score/genome/mint/mcp-scan/threat-model via skills; pairs with @metaharness/router (ADR-148/149) for cost-optimal model routing; honors ADR-150 optional-augmentation constraint"
     },
     {
       "name": "swarmdo-arena",
       "source": "./plugins/swarmdo-arena",
-      "description": "Competitive ruliology for swarmdo swarms \u2014 arenas, tournaments, and adaptive co-evolution of program strategies (ADR-147/148); strategies-as-programs compete under payoff games"
+      "description": "Competitive ruliology for swarmdo swarms — arenas, tournaments, and adaptive co-evolution of program strategies (ADR-147/148); strategies-as-programs compete under payoff games"
     },
     {
       "name": "swarmdo-caveman",
       "source": "./plugins/swarmdo-caveman",
-      "description": "Token compression \u2014 /caveman-compress rewrites memory files into few-token caveman-speak, substance preserved (MIT, vendored)"
+      "description": "Token compression — /caveman-compress rewrites memory files into few-token caveman-speak, substance preserved (MIT, vendored)"
     },
     {
       "name": "swarmdo-ponytail",
       "source": "./plugins/swarmdo-ponytail",
-      "description": "Anti-over-engineering \u2014 /ponytail makes agents think like the laziest senior dev: YAGNI, stdlib first, one line before fifty (MIT, vendored)"
+      "description": "Anti-over-engineering — /ponytail makes agents think like the laziest senior dev: YAGNI, stdlib first, one line before fifty (MIT, vendored)"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,19 +1,13 @@
 {
   "name": "swarmdo",
-  "version": "2.5.0",
-  "description": "Enterprise AI agent orchestration plugin with 150+ commands, 74+ specialized agents, SPARC methodology, swarm coordination, GitHub integration, and neural training capabilities",
+  "version": "1.28.2",
+  "description": "AI agent orchestration for Claude Code: swarm coordination, 314 MCP tools, 60+ agent types, persistent AgentDB memory with HNSW vector search, self-learning hooks, SPARC methodology, and GitHub automation",
   "author": {
-    "name": "the upstream author",
+    "name": "SwarmDo Team",
     "email": "maintainers@swarmdo.com"
   },
-  "homepage": "the upstream project (see NOTICE)",
-  "repository": {
-    "type": "git",
-    "url": "the upstream project (see NOTICE)"
-  },
-  "bugs": {
-    "url": "the upstream project (see NOTICE)"
-  },
+  "homepage": "https://swarmdo.com",
+  "repository": "https://github.com/SwarmDo/swarmdo",
   "license": "MIT",
   "keywords": [
     "ai-agents",
@@ -31,43 +25,17 @@
     "code-review",
     "performance-optimization"
   ],
-  "category": "development",
-  "tags": [
-    "productivity",
-    "automation",
-    "ai",
-    "agents",
-    "swarm",
-    "coordination",
-    "sparc",
-    "github",
-    "neural-network",
-    "enterprise"
-  ],
-  "engines": {
-    "claudeCode": ">=2.0.0",
-    "node": ">=20.0.0"
-  },
   "mcpServers": {
     "swarmdo": {
       "command": "npx",
       "args": [
-        "swarmdo@alpha",
+        "-y",
+        "swarmdo@latest",
         "mcp",
         "start"
       ],
       "description": "Core Swarmdo MCP server for swarm coordination, agent management, and task orchestration (40+ tools)",
       "optional": false
-    },
-    "swarmdo-swarm": {
-      "command": "npx",
-      "args": [
-        "swarmdo-swarm",
-        "mcp",
-        "start"
-      ],
-      "description": "Enhanced swarm coordination with WASM acceleration (2.8-4.4x speed improvement)",
-      "optional": true
     }
   }
 }

package/.claude-plugin/scripts/install.sh

@@ -137,7 +137,7 @@ if [ "$INSTALL_TYPE" = "1" ] || [ "$INSTALL_TYPE" = "4" ]; then
   "mcpServers": {
     "swarmdo": {
       "command": "npx",
-      "args": ["swarmdo@alpha", "mcp", "start"],
+      "args": ["swarmdo@latest", "mcp", "start"],
       "description": "Core Swarmdo MCP server with 40+ orchestration tools"
     }
   }
@@ -154,7 +154,7 @@ Add to ~/.claude/settings.json:
   "mcpServers": {
     "swarmdo": {
       "command": "npx",
-      "args": ["swarmdo@alpha", "mcp", "start"]
+      "args": ["swarmdo@latest", "mcp", "start"]
     },
     "swarmdo-swarm": {
       "command": "npx",
@@ -174,7 +174,7 @@ MCP_INSTRUCTIONS
 
     if [ "$INSTALL_MCP" = "y" ]; then
         info "Installing swarmdo MCP server..."
-        npx swarmdo@alpha --version 2>/dev/null || npm install -g swarmdo@alpha
+        npx swarmdo@latest --version 2>/dev/null || npm install -g swarmdo@latest
         success "Swarmdo MCP server installed"
 
         read -p "Install optional swarmdo-swarm MCP? (y/n) [n]: " INSTALL_SWARM

package/.claude-plugin/scripts/swarmdo-hook.sh

@@ -27,7 +27,7 @@ if command -v swarmdo >/dev/null 2>&1; then
 elif command -v swarmdo >/dev/null 2>&1; then
   run swarmdo hooks "$@"
 else
-  run npx --prefer-offline --yes swarmdo@alpha hooks "$@"
+  run npx --prefer-offline --yes swarmdo@latest hooks "$@"
 fi
 
 exit 0

package/.claude-plugin/scripts/verify.sh

@@ -69,8 +69,8 @@ fi
 
 # Check MCP packages
 info "Checking MCP packages..."
-if npx swarmdo@alpha --version &> /dev/null; then
-    VERSION=$(npx swarmdo@alpha --version 2>/dev/null || echo "unknown")
+if npx swarmdo@latest --version &> /dev/null; then
+    VERSION=$(npx swarmdo@latest --version 2>/dev/null || echo "unknown")
     success "swarmdo MCP: $VERSION"
 else
     warning "swarmdo MCP not installed"

package/README.md

@@ -2,7 +2,7 @@
 
 [![swarmdo](swarmdo/assets/brand/logo-full.svg)](https://swarmdo.com)
 
-[![npm version (swarmdo)](https://img.shields.io/badge/npx%20swarmdo-v1.27.0-cb3837?style=for-the-badge&logo=npm&logoColor=white)](https://github.com/SwarmDo/swarmdo/releases)
+[![npm version (swarmdo)](https://img.shields.io/badge/npx%20swarmdo-v1.30.0-cb3837?style=for-the-badge&logo=npm&logoColor=white)](https://github.com/SwarmDo/swarmdo/releases)
 [![MIT License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://github.com/SwarmDo/swarmdo/blob/main/LICENSE)
 [![Website](https://img.shields.io/badge/swarmdo.com-e2a33c?style=for-the-badge&logoColor=black)](https://swarmdo.com)
 [![Star on GitHub](https://img.shields.io/github/stars/SwarmDo/swarmdo?style=for-the-badge&logo=github&color=gold)](https://github.com/SwarmDo/swarmdo)
@@ -47,17 +47,17 @@ There are **two different install paths** with very different surface areas. Pic
 
 | | **Claude Code Plugin** | **CLI install (`npx swarmdo init`)** |
 |---|---|---|
-| What it gives you | Slash commands + a few skills + agent definitions per-plugin | Full Swarmdo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon |
+| What it gives you | Slash commands + skills + agent definitions per-plugin; `swarmdo-core` also registers the swarmdo MCP server | Full Swarmdo loop — 98 agents, 60+ commands, 30 skills, MCP server, hooks, daemon |
 | Files in your workspace | **Zero** | `.claude/`, `.swarmdo/`, `CLAUDE.md`, helpers, settings |
-| MCP server registered | **No** (`memory_store`, `swarm_init`, etc. unavailable to Claude) | Yes |
+| MCP server registered | **Yes with `swarmdo-core`** (via the plugin's `.mcp.json`); other plugins are commands/skills only | Yes |
 | Hooks installed | No | Yes |
-| Best for | Try a single plugin's commands without committing to the full install | Production use — everything works as documented |
+| Best for | Try Swarmdo without committing files to your workspace | Production use — everything works as documented |
 
-### Path A — Claude Code Plugins (lite, slash commands only)
+### Path A — Claude Code Plugins (zero files in your repo)
 
 ```bash
 # Add the marketplace
-/plugin marketplace add upstream/swarmdo
+/plugin marketplace add SwarmDo/swarmdo
 
 # Install core + any plugins you need
 /plugin install swarmdo-core@swarmdo
@@ -66,7 +66,9 @@ There are **two different install paths** with very different surface areas. Pic
 /plugin install swarmdo-neural-trader@swarmdo
 ```
 
-This adds slash commands and agent definitions only. The Swarmdo MCP server is NOT registered, so `memory_store`, `swarm_init`, `agent_spawn`, etc. won't be callable from Claude. For the full loop, use Path B below.
+`swarmdo-core` registers the swarmdo MCP server (300+ tools) plus base agents and setup skills; the other plugins add their slash commands and agent definitions. Hooks and the daemon still require Path B.
+
+> 📦 `swarmdo-core` has been submitted to Anthropic's Claude Code plugin directory (community marketplace). Once approved it will also be installable via `/plugin install swarmdo-core@claude-community` — no marketplace-add needed.
 
 <details>
 <summary><strong>🔌 All 35 plugins</strong></summary>
@@ -159,7 +161,7 @@ This adds slash commands and agent definitions only. The Swarmdo MCP server is N
 
 ```bash
 # One-line install (POSIX shells only — see Windows note below)
-curl -fsSL https://cdn.jsdelivr.net/gh/upstream/swarmdo@main/scripts/install.sh | bash
+curl -fsSL https://cdn.jsdelivr.net/gh/SwarmDo/swarmdo@main/scripts/install.sh | bash
 ```
 
 **All platforms (including native Windows PowerShell / cmd):**
@@ -269,7 +271,7 @@ The recent release train added a full day-to-day operations layer around the swa
 
 | Command | What it does |
 |---------|-------------|
-| `swarmdo usage` (alias `cost`) | Claude Code **spend analytics** from your local transcripts — `daily`, `monthly`, `models`, `projects`, `sessions`, live 5-hour `blocks` burn, `errors` (tool-failure analytics), `cache` (prompt-cache efficiency + $ saved), and `diff` (period-over-period comparison with per-model movers) |
+| `swarmdo usage` (alias `cost`) | Claude Code **spend analytics** from your local transcripts — `daily`, `monthly` (with a month-end spend projection), `models`, `projects`, `sessions`, live 5-hour `blocks` burn, `errors` (tool-failure analytics), `cache` (prompt-cache efficiency + $ saved), `diff` (period-over-period comparison with per-model movers), `reflect` (a wrapped-style retrospective — busiest day, streak, top models/projects, peak hour, delegation ratio — with a shareable `--html` dashboard), and `limits` (an official-quota **exhaustion forecaster** over Claude Code's `rate_limits`); the standard views take `--csv` for spreadsheet export |
 | `swarmdo usage guard` | **Budget policy** — limits for the active 5h block / today / month via flags or `SWARMDO_GUARD_*` env → ok / warn / over; `--strict` exits 1, safe for CI gates and Stop hooks |
 | `swarmdo hud` | **One-screen ops HUD** — 5h block burn, task readiness, daemon workers, memory snapshots (`--watch`, `--json`) |
 | `swarmdo repair` (alias `tdd-repair`) | **Test-Driven Repair** — a bounded, budget-capped headless `claude` loop that fixes source until a failing test passes; dry-run unless `--confirm` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarmdo",
-  "version": "1.27.0",
+  "version": "1.30.0",
   "description": "Swarmdo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",