sdl-mcp 0.10.2 → 0.10.3

package/README.md

@@ -159,6 +159,7 @@ Cards include **confidence-scored call resolution** (the pass-2 resolver traces
 - Confidence-scored dependency edges trace real call relationships across files
 - Community detection and call-chain tracing reveal architectural structure
 - ETag-based conditional requests avoid re-fetching unchanged symbols
+- Workflow ETag caching now seeds `slice.build` with `knownCardEtags` so repeated slice builds can skip unchanged cards
 
 [Indexing & Language Support Deep Dive →](./docs/feature-deep-dives/indexing-languages.md)
 
@@ -263,7 +264,7 @@ Raw code access (Rung 4) is **policy-gated**. Agents must provide:
 
 Requests that don't meet policy are denied with actionable guidance ("try `getHotPath` with these identifiers instead"). Every access is audit-logged.
 
-The sandboxed runtime execution tool (`sdl.runtime.execute`) has its own governance layer: disabled by default, executable allowlisting, CWD jailing, environment scrubbing, concurrency limits, and timeout enforcement. The `outputMode` parameter (`"minimal"` | `"summary"` | `"intent"`) defaults to `"minimal"` for ~95% token savings, with `sdl.runtime.queryOutput` enabling on-demand output retrieval when needed.
+The sandboxed runtime execution tool (`sdl.runtime.execute`) has its own governance layer: enabled by default, but still guarded by executable allowlisting, CWD jailing, environment scrubbing, concurrency limits, and timeout enforcement. The `outputMode` parameter (`"minimal"` | `"summary"` | `"intent"`) defaults to `"minimal"` for ~95% token savings, with `sdl.runtime.queryOutput` enabling on-demand output retrieval when needed.
 
 **Why it matters:**
 - Proof-of-need gating prevents agents from wastefully reading raw code
@@ -306,9 +307,9 @@ Run tests, linters, and scripts through SDL-MCP's governance layer instead of un
 
 ---
 
-### Development Memories — Cross-Session Knowledge Persistence
+### Development Memories — Cross-Session Knowledge Persistence (Opt-In)
 
-Agents forget everything between sessions. SDL-MCP fixes this with a **graph-backed memory system** that lets agents store decisions, bugfix context, and task notes linked directly to the symbols and files they relate to. Memories are stored both in the graph database (for fast querying) and as checked-in markdown files (for version control and team sharing).
+Agents forget everything between sessions. SDL-MCP fixes this with an **opt-in graph-backed memory system** that lets agents store decisions, bugfix context, and task notes linked directly to the symbols and files they relate to. Memory is **disabled by default** and must be explicitly enabled in the configuration. When enabled, memories are stored both in the graph database (for fast querying) and as checked-in markdown files (for version control and team sharing).
 
 ```mermaid
 flowchart LR
@@ -322,11 +323,12 @@ flowchart LR
     Graph --> Recall["Relevant memory surfaced<br/>race condition fix in authenticate()"]
 ```
 
-Memories are **automatically surfaced** inside graph slices — when an agent builds a slice touching symbols with linked memories, those memories appear alongside the cards. During re-indexing, memories linked to changed symbols are **flagged as stale**, prompting agents to review and update them. Four MCP tools (`store`, `query`, `remove`, `surface`) provide full CRUD plus intelligent ranking by confidence, recency, and symbol overlap.
+When enabled, memories are **automatically surfaced** inside graph slices — when an agent builds a slice touching symbols with linked memories, those memories appear alongside the cards. During re-indexing, memories linked to changed symbols are **flagged as stale**, prompting agents to review and update them. Four MCP tools (`store`, `query`, `remove`, `surface`) provide full CRUD plus intelligent ranking by confidence, recency, and symbol overlap. Memory tools are only available when memory is enabled in the configuration.
 
 **Why it matters:**
 - Structured knowledge **persists across sessions**, linked directly to symbols and files
-- Automatically surfaced inside graph slices when touching related symbols
+- Opt-in and disabled by default — enable via `"memory": { "enabled": true }` in config
+- When enabled, automatically surfaced inside graph slices when touching related symbols
 - Stale memories flagged when linked symbols change during re-indexing
 - Dual storage: graph DB for fast querying + markdown files for version control and team sharing
 
@@ -394,7 +396,7 @@ Each gateway tool accepts an `action` discriminator field (e.g., `{ action: "sym
 <tr><td rowspan="4"><strong>Repository</strong></td>
     <td><code>sdl.repo.register</code></td><td>Register a codebase for indexing</td></tr>
 <tr><td><code>sdl.repo.status</code></td><td>Health, versions, watcher, prefetch, live-index stats</td></tr>
-<tr><td><code>sdl.repo.overview</code></td><td>Codebase summary: stats, directories, hotspots, clusters</td></tr>
+<tr><td><code>sdl.repo.overview</code></td><td>Codebase summary: stats, directories, hotspots, clusters, with conditional ETag fetch support</td></tr>
 <tr><td><code>sdl.index.refresh</code></td><td>Trigger full or incremental re-indexing</td></tr>
 
 <tr><td rowspan="3"><strong>Live Buffer</strong></td>
@@ -413,8 +415,8 @@ Each gateway tool accepts an `action` discriminator field (e.g., `{ action: "sym
 <tr><td><code>sdl.slice.spillover.get</code></td><td>Page through overflow symbols beyond the budget</td></tr>
 
 <tr><td rowspan="3"><strong>Code Access</strong></td>
-    <td><code>sdl.code.getSkeleton</code></td><td>Signatures + control flow, bodies elided</td></tr>
-<tr><td><code>sdl.code.getHotPath</code></td><td>Lines matching specific identifiers + context</td></tr>
+    <td><code>sdl.code.getSkeleton</code></td><td>Signatures + control flow, bodies elided, with conditional ETag fetch support</td></tr>
+<tr><td><code>sdl.code.getHotPath</code></td><td>Lines matching specific identifiers + context, with conditional ETag fetch support</td></tr>
 <tr><td><code>sdl.code.needWindow</code></td><td>Full source code (policy-gated, requires justification)</td></tr>
 
 <tr><td><strong>Deltas</strong></td>
@@ -428,10 +430,10 @@ Each gateway tool accepts an `action` discriminator field (e.g., `{ action: "sym
     <td><code>sdl.pr.risk.analyze</code></td><td>Scored PR risk with findings and test recommendations</td></tr>
 
 <tr><td><strong>Context</strong></td>
-    <td><code>sdl.context.summary</code></td><td>Token-bounded portable briefing (markdown/JSON/clipboard)</td></tr>
+    <td><code>sdl.context.summary</code></td><td>Token-bounded portable briefing (markdown/JSON/clipboard) with conditional ETag fetch support</td></tr>
 
 <tr><td rowspan="3"><strong>Agent</strong></td>
-    <td><code>sdl.agent.context</code></td><td>Task-shaped context retrieval with budget-controlled rung planning</td></tr>
+    <td><code>sdl.agent.context</code></td><td>Task-shaped context retrieval with budget-controlled rung planning and conditional ETag fetch support</td></tr>
 <tr><td><code>sdl.agent.feedback</code></td><td>Record which symbols were useful or missing</td></tr>
 <tr><td><code>sdl.agent.feedback.query</code></td><td>Query aggregated feedback statistics</td></tr>
 

package/config/sdlmcp.config.example.json

@@ -32,7 +32,12 @@
       "includeNodeModulesTypes": true,
       "packageJsonPath": null,
       "tsconfigPath": null,
-      "workspaceGlobs": null
+      "workspaceGlobs": null,
+      "memory": {
+        "enabled": true,
+        "surfacingEnabled": true,
+        "fileSyncEnabled": false
+      }
     }
   ],
   "graphDatabase": {
@@ -160,10 +165,12 @@
     "toolQueueTimeoutMs": 30000
   },
   "runtime": {
-    "enabled": false,
+    "enabled": true,
     "allowedRuntimes": [
       "node",
-      "python"
+      "typescript",
+      "python",
+      "shell"
     ],
     "allowedExecutables": [],
     "maxDurationMs": 30000,
@@ -194,5 +201,8 @@
   },
   "security": {
     "allowedRepoRoots": []
+  },
+  "memory": {
+    "enabled": false
   }
 }

package/config/sdlmcp.config.schema.json

@@ -99,6 +99,45 @@
             "items": {
               "type": "string"
             }
+          },
+          "memory": {
+            "type": "object",
+            "description": "Memory subsystem configuration. Memory is disabled by default.",
+            "properties": {
+              "enabled": {
+                "type": "boolean",
+                "description": "Master enable for the memory subsystem. When false, all memory features are disabled.",
+                "default": false
+              },
+              "toolsEnabled": {
+                "type": "boolean",
+                "description": "Enable memory CRUD tools (store, query, remove, surface)",
+                "default": true
+              },
+              "fileSyncEnabled": {
+                "type": "boolean",
+                "description": "Enable .sdl-memory file read/import/write/delete",
+                "default": true
+              },
+              "surfacingEnabled": {
+                "type": "boolean",
+                "description": "Enable memory injection into repo.status and slice.build",
+                "default": true
+              },
+              "hintsEnabled": {
+                "type": "boolean",
+                "description": "Enable _memoryHint post-dispatch guidance",
+                "default": true
+              },
+              "defaultSurfaceLimit": {
+                "type": "integer",
+                "description": "Default number of memories to surface when limit is omitted",
+                "default": 5,
+                "minimum": 1,
+                "maximum": 50
+              }
+            },
+            "additionalProperties": false
           }
         }
       }
@@ -483,7 +522,7 @@
         },
         "model": {
           "type": "string",
-          "enum": ["all-MiniLM-L6-v2", "nomic-embed-text-v1.5"],
+          "enum": ["all-MiniLM-L6-v2", "nomic-embed-text-v1.5", "jina-embeddings-v2-base-code"],
           "default": "all-MiniLM-L6-v2"
         },
         "modelCacheDir": {
@@ -916,8 +955,8 @@
         }
       },
       "default": {
-        "enabled": false,
-        "allowedRuntimes": ["node", "python"],
+        "enabled": true,
+        "allowedRuntimes": ["node", "typescript", "python", "shell"],
         "allowedExecutables": [],
         "maxDurationMs": 30000,
         "maxConcurrentJobs": 2,
@@ -1031,6 +1070,45 @@
         "enabled": true,
         "exclusive": true
       }
+    },
+    "memory": {
+      "type": "object",
+      "description": "Memory subsystem configuration. Memory is disabled by default.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Master enable for the memory subsystem. When false, all memory features are disabled.",
+          "default": false
+        },
+        "toolsEnabled": {
+          "type": "boolean",
+          "description": "Enable memory CRUD tools (store, query, remove, surface)",
+          "default": true
+        },
+        "fileSyncEnabled": {
+          "type": "boolean",
+          "description": "Enable .sdl-memory file read/import/write/delete",
+          "default": true
+        },
+        "surfacingEnabled": {
+          "type": "boolean",
+          "description": "Enable memory injection into repo.status and slice.build",
+          "default": true
+        },
+        "hintsEnabled": {
+          "type": "boolean",
+          "description": "Enable _memoryHint post-dispatch guidance",
+          "default": true
+        },
+        "defaultSurfaceLimit": {
+          "type": "integer",
+          "description": "Default number of memories to surface when limit is omitted",
+          "default": 5,
+          "minimum": 1,
+          "maximum": 50
+        }
+      },
+      "additionalProperties": false
     }
   }
 }