swarmdo 1.27.0 → 1.29.0

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

@@ -99,7 +99,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;
   }

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.29.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):**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swarmdo",
-  "version": "1.27.0",
+  "version": "1.29.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",

package/v3/@swarmdo/cli/.claude/helpers/auto-memory-hook.mjs

@@ -99,7 +99,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;
   }

package/v3/@swarmdo/cli/bin/cli.js

@@ -93,6 +93,20 @@ console.log = (...args) => {
   _origLog.apply(console, args);
 };
 
+// Claude Code plugin hint (code.claude.com/docs/en/plugin-hints): when a
+// session runs swarmdo through Claude Code's Bash tool, emit the one-line
+// marker so Claude Code can offer to install our plugin. Emitted here in the
+// bin shim — NOT in dist/src/index.js — so it also covers the #2256 fast
+// paths below (--version/--help are exactly the probes Claude runs on an
+// unfamiliar CLI). Claude Code strips the line from all output before it
+// reaches the model and only prompts if/when swarmdo-core is listed in the
+// official Anthropic marketplace; until then it is silently dropped.
+if (process.env.CLAUDECODE) {
+  process.stderr.write(
+    '<claude-code-hint v="1" type="plugin" value="swarmdo-core@claude-plugins-official" />\n'
+  );
+}
+
 // #2256 fast path: --version / -V / --help / -h must NOT trigger heavy
 // imports (agentic-flow, swarmvector ONNX, etc.) — those eagerly download a
 // 23 MB ONNX model on cold cache, blocking 60+ s and causing SIGTERM
@@ -116,6 +130,30 @@ console.log = (...args) => {
   // loading. The version short-circuit is the only one safe to inline.
 }
 
+// #45 fast path: `compact-snapshot` is wired to UserPromptSubmit (fires on
+// EVERY prompt) and PreCompact, so it must not pay the full-CLI bootstrap
+// (~0.6s incl. the 23 MB ONNX load). Its own module imports only fs/git/output
+// + the pure engine, so dispatch it directly and exit before any heavy import.
+// A bare `--help` still falls through to the rich help path below.
+{
+  const _argv = process.argv.slice(2);
+  if (_argv[0] === 'compact-snapshot' && !_argv.includes('--help') && !_argv.includes('-h')) {
+    try {
+      const mod = await import('../dist/src/commands/compact-snapshot.js');
+      const cmd = mod.default ?? mod.compactSnapshotCommand;
+      const rest = _argv.slice(1);
+      const args = rest.filter((a) => !a.startsWith('-'));
+      const flags = {};
+      for (const a of rest) if (a.startsWith('--')) flags[a.replace(/^--/, '')] = true;
+      const res = await cmd.action({ cwd: process.cwd(), args, flags, rawArgs: rest });
+      process.exit(res && typeof res.exitCode === 'number' ? res.exitCode : 0);
+    } catch (e) {
+      // Best-effort: a failure here must never block a turn (it runs in hooks).
+      process.exit(0);
+    }
+  }
+}
+
 // Check if we should run in MCP server mode
 // Conditions:
 //   1. stdin is being piped AND no CLI arguments provided (auto-detect)

package/v3/@swarmdo/cli/dist/src/apply/apply.d.ts

@@ -41,6 +41,12 @@ export interface HunkResult {
     at?: number;
     /** how many context lines were trimmed to make it fit */
     fuzzUsed?: number;
+    /**
+     * True when the matched block occurs at MORE THAN ONE position in the file —
+     * the hunk landed at the nearest, but a duplicate/boilerplate block elsewhere
+     * means it may have modified the wrong occurrence. Callers should verify.
+     */
+    ambiguous?: boolean;
 }
 export interface ApplyResult {
     ok: boolean;

package/v3/@swarmdo/cli/dist/src/apply/apply.js

@@ -19,7 +19,10 @@ export function parsePatch(text) {
     let hunk = null;
     const stripPrefix = (p) => p.replace(/^[ab]\//, '').replace(/\t.*$/, '').trim();
     for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
+        // CRLF tolerance (#9): a diff generated on/for CRLF files carries \r on
+        // every line; strip it so hunk content compares EOL-agnostically.
+        const raw = lines[i];
+        const line = raw.endsWith('\r') ? raw.slice(0, -1) : raw;
         if (line.startsWith('diff --git')) {
             cur = null;
             hunk = null;
@@ -90,6 +93,16 @@ function blockMatchesAt(source, at, block) {
             return false;
     return true;
 }
+/** How many positions in `source` the `block` matches. Pure. */
+function countMatches(source, block) {
+    if (block.length === 0)
+        return 0;
+    let n = 0;
+    for (let i = 0; i + block.length <= source.length; i++)
+        if (blockMatchesAt(source, i, block))
+            n++;
+    return n;
+}
 /**
  * Find where `block` occurs in `source`, preferring the position nearest
  * `expected` (0-based). Returns -1 if not found. Deterministic: on ties the
@@ -117,9 +130,19 @@ function findBlock(source, block, expected) {
 export function applyPatch(source, patch, opts = {}) {
     const fuzz = opts.fuzz ?? 2;
     const trailingNewline = source.endsWith('\n');
+    // CRLF support (#9): match EOL-agnostically, then write inserted lines with
+    // the file's dominant EOL so CRLF sources stay CRLF. `lines` keeps each
+    // line's original bytes (untouched lines round-trip exactly); `matchLines`
+    // is the \r-stripped twin every comparison runs against. The two are spliced
+    // in lockstep so indices stay aligned.
+    const crlfCount = (source.match(/\r\n/g) ?? []).length;
+    const newlineCount = (source.match(/\n/g) ?? []).length;
+    const dominantCrlf = crlfCount > newlineCount - crlfCount;
     const lines = source.split('\n');
     if (trailingNewline)
         lines.pop(); // drop the empty element from a trailing \n
+    const stripCr = (s) => (s.endsWith('\r') ? s.slice(0, -1) : s);
+    const matchLines = lines.map(stripCr);
     let offset = 0;
     const results = [];
     // If a hunk that reaches EOF carries an explicit no-newline marker, it — not
@@ -142,7 +165,7 @@ export function applyPatch(source, patch, opts = {}) {
                 if (lead > leadTrimmable || tail > tailTrimmable)
                     continue;
                 const trimmed = oldBlock.slice(lead, oldBlock.length - tail);
-                const at = findBlock(lines, trimmed, expected + lead);
+                const at = findBlock(matchLines, trimmed, expected + lead);
                 if (at >= 0) {
                     placed = at - lead;
                     usedFuzz = f;
@@ -156,13 +179,18 @@ export function applyPatch(source, patch, opts = {}) {
             results.push({ hunk, applied: false });
             continue;
         }
-        // Splice: remove oldBlock.length lines at `placed`, insert newBlock.
-        // (trimLead/trimTail only affected *matching*, not what we replace.)
-        void trimLead;
-        void trimTail;
-        lines.splice(placed, oldBlock.length, ...newBlock);
+        // A hunk is AMBIGUOUS if the block it matched on occurs elsewhere too — the
+        // nearest-match tiebreak may have picked the wrong duplicate. Check the
+        // matched (trimmed) block against the current lines BEFORE splicing.
+        const matchedBlock = oldBlock.slice(trimLead, oldBlock.length - trimTail);
+        const ambiguous = countMatches(matchLines, matchedBlock) > 1;
+        // Splice: remove oldBlock.length lines at `placed`, insert newBlock —
+        // raw lines get the file's dominant EOL, the match twin stays stripped.
+        const insertRaw = dominantCrlf ? newBlock.map((l) => l + '\r') : newBlock;
+        lines.splice(placed, oldBlock.length, ...insertRaw);
+        matchLines.splice(placed, oldBlock.length, ...newBlock);
         offset += newBlock.length - oldBlock.length;
-        results.push({ hunk, applied: true, at: placed, fuzzUsed: usedFuzz });
+        results.push({ hunk, applied: true, at: placed, fuzzUsed: usedFuzz, ...(ambiguous && { ambiguous: true }) });
         // If this hunk's new content is now the tail of the file, its markers
         // determine whether the file ends with a newline.
         if (placed + newBlock.length === lines.length)
@@ -173,6 +201,11 @@ export function applyPatch(source, patch, opts = {}) {
     const endWithNewline = eofNoEol === undefined ? trailingNewline : !eofNoEol;
     if (endWithNewline)
         result += '\n';
+    // An inserted line that became the no-trailing-newline tail carries the
+    // dominant-EOL \r it was given for joining — a bare CR at EOF is never
+    // meaningful, so drop it.
+    else if (result.endsWith('\r'))
+        result = result.slice(0, -1);
     return { ok: results.every((r) => r.applied), result, hunks: results };
 }
 /**