@dotdotgod/context 0.3.11 → 0.4.0

package/README.md

@@ -28,7 +28,7 @@ The runtime policies apply to dotdotgod execution and retrieval tools. Each host
 
 ## Tool Surface
 
-- `execute`, `batch_execute`, `execute_file`
+- `execute`, `execute_file`
 - `index`, `search`, `fetch_and_index`
 - `session_resume`, `ingestion_job_start`, `ingestion_job_status`, `ingestion_job_cancel`
 - `context_heal`, `stats`, `doctor`, `purge`
@@ -55,9 +55,9 @@ The dotdotgod execution tools support four output modes:
 
 Each command has one **10 MiB combined capture ceiling** shared by stdout and stderr. If either stream exceeds the remaining shared budget, the runtime terminates the process and reports `captureLimitExceeded`. A direct response is capped at **1 MiB per stream**, even if a caller requests more. Automatically indexed command output defaults to session scope and a 24-hour expiry.
 
-`batch_execute` accepts up to 100 commands, uses concurrency from 1 through 8, and preserves input order. Execution and explicit shell mode remain write-capable operations subject to the host's approval model.
+`execute` requires a `commands` array of 1..100 entries and always returns ordered `results`, even for one command. Group independent known commands and separate dependent commands without bypassing safety gates. It accepts up to 100 commands, uses concurrency from 1 through 8, and preserves input order. Execution and explicit shell mode remain write-capable operations subject to the host's approval model.
 
-`execute`, `batch_execute`, and `execute_file` share an `inherit-filtered-v1` child-environment policy. It preserves compatibility-oriented inheritance while filtering `NODE_OPTIONS`, `PYTHONPATH`, `RUBYOPT`, `LD_PRELOAD`, and supported-platform `DYLD_*` variables. Callers may provide string overrides or remove inherited variables with `null`, but cannot restore reserved variables. Results report filtered names without values. This policy applies only to these dotdotgod tools and does not isolate ordinary inherited credentials.
+`execute` and `execute_file` share an `inherit-filtered-v1` child-environment policy. It preserves compatibility-oriented inheritance while filtering `NODE_OPTIONS`, `PYTHONPATH`, `RUBYOPT`, `LD_PRELOAD`, and supported-platform `DYLD_*` variables. Callers may provide string overrides or remove inherited variables with `null`, but cannot restore reserved variables. Results report filtered names without values. This policy applies only to these dotdotgod tools and does not isolate ordinary inherited credentials.
 
 ## Local Storage And Retrieval
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/context",
-  "version": "0.3.11",
+  "version": "0.4.0",
   "description": "Local-first MCP execution, indexing, and retrieval runtime for dotdotgod adapters.",
   "type": "module",
   "license": "Elastic-2.0",
@@ -28,7 +28,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "zod": "^3.25.76",
-    "@dotdotgod/cli": "0.3.11"
+    "@dotdotgod/cli": "0.4.0"
   },
   "engines": {
     "node": ">=22.5.0"

package/src/server.mjs

@@ -2,7 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { ContextStore, contextDbPath, healContextDatabase } from './store.mjs';
-import { executeBatch, executeCommand, executeFile } from './execute.mjs';
+import { executeBatch, executeFile } from './execute.mjs';
 import { fetchAndIndex, indexFile } from './content.mjs';
 import { runDoctor } from './doctor.mjs';
 import { projectEmbeddingInstall, projectEmbeddingStatus, projectImpact, projectInitialize, projectLoad } from './project.mjs';
@@ -47,9 +47,7 @@ function register(name, description, inputSchema, handler, annotations) {
   });
 }
 
-register('execute', 'Run one local command while keeping large stdout/stderr outside model context.', commandSchema,
-  (input, extra) => executeCommand(input, { root, store: getStore(), sessionId, signal: extra.signal }), { openWorldHint: true, destructiveHint: true });
-register('batch_execute', 'Run labeled local commands sequentially or with bounded concurrency and index large outputs.', {
+register('execute', 'Run 1..100 labeled local commands with bounded concurrency. Group independent known commands; separate commands dependent on earlier results. Inspect every results entry status and indexed.id. Do not bypass permissions or safety gates.', {
   commands: z.array(z.object(commandSchema)).min(1).max(100), concurrency: z.number().int().min(1).max(8).optional(), cwd: z.string().optional(), timeoutMs: z.number().int().positive().optional(),
 }, (input, extra) => executeBatch(input, { root, store: getStore(), sessionId, signal: extra.signal }), { openWorldHint: true, destructiveHint: true });
 register('execute_file', 'Process a local file in an isolated child process; only bounded stdout/stderr is returned.', {
@@ -60,7 +58,7 @@ register('index', 'Index a local text file or bounded directory into the project
   includeExtensions: z.array(z.string()).max(100).optional(), excludePaths: z.array(z.string()).max(500).optional(), followFileSymlinks: z.boolean().optional(),
   maxDepth: z.number().int().nonnegative().optional(), maxVisitedEntries: z.number().int().nonnegative().optional(), maxFiles: z.number().int().nonnegative().optional(), maxAggregateBytes: z.number().int().nonnegative().optional(),
 }, (input, extra) => ({ ok: true, ...indexFile(getStore(), { ...input, root }, sessionId, extra.signal) }), { readOnlyHint: true });
-register('search', 'Search indexed command, file, and fetched content and return bounded excerpts.', {
+register('search', 'Search indexed content for bounded excerpts. For failure diagnostics try fail OR error OR reason. Query * browses bounded excerpts with the same source/scope/session filters and limit; neither no matches nor partial excerpts prove diagnostics are absent.', {
   query: z.string().min(1), scope: scopeSchema, source: z.string().optional(), limit: z.number().int().min(1).max(50).optional(), sessionOnly: z.boolean().optional(),
 }, (input) => ({
   ok: true,

package/src/store.mjs

@@ -246,7 +246,13 @@ export class ContextStore {
     if (source) { filters.push('(s.id = ? OR s.label LIKE ?)'); filterParams.push(source, `%${source}%`); }
     const filterSql = filters.length ? ` AND ${filters.join(' AND ')}` : '';
     const select = 'SELECT c.source_id, c.ordinal, c.body, s.label, s.kind, s.scope, s.metadata';
-    const porterRows = this.db.prepare(`
+    const wildcard = String(query ?? '').trim() === '*';
+    const porterRows = wildcard ? this.db.prepare(`
+      ${select}, 0 AS rank
+      FROM chunks c JOIN sources s ON s.id = c.source_id
+      WHERE 1 = 1${filterSql}
+      ORDER BY s.created_at DESC, s.id, c.ordinal LIMIT ?
+    `).all(...filterParams, candidateLimit) : this.db.prepare(`
       ${select}, bm25(chunks) AS rank
       FROM chunks c JOIN sources s ON s.id = c.source_id
       WHERE chunks MATCH ?${filterSql}
@@ -265,7 +271,7 @@ export class ContextStore {
     `).all(...labelParams, ...filterParams, candidateLimit);
     const typoWindow = Math.min(500, candidateLimit * 5);
     const typoHalf = Math.max(1, Math.floor(typoWindow / 2));
-    const trigramRows = this.db.prepare(`
+    const trigramRows = wildcard ? [] : this.db.prepare(`
       SELECT * FROM (
         SELECT ${select.replace('SELECT ', '')}, 0 AS rank
         FROM chunks c JOIN sources s ON s.id = c.source_id
@@ -290,7 +296,7 @@ export class ContextStore {
       return { sourceId: row.source_id, ordinal: Number(row.ordinal), body: row.body, label: row.label, kind: row.kind, scope: row.scope, rank: row.rank, metadata: readProvenanceMetadata(storedMetadata) };
     };
     const fused = reciprocalRankFusion([
-      { name: 'porter-bm25', candidates: porterRows.map(toCandidate) },
+      { name: wildcard ? 'bounded-browse' : 'porter-bm25', candidates: porterRows.map(toCandidate) },
       { name: 'label-path', candidates: labelRows.map(toCandidate) },
       { name: 'trigram-v1', candidates: trigramRows.map(toCandidate) },
     ], { limit: candidateLimit });
@@ -303,7 +309,7 @@ export class ContextStore {
         scope: row.scope,
         ordinal: row.ordinal,
         rank: row.rank,
-        text: excerpt(row.body, query),
+        text: excerpt(row.body, wildcard ? '' : query),
         metadata: row.metadata,
         trust: row.metadata.trust,
         sourceType: row.metadata.sourceType,