@aidemd-mcp/server 0.3.1 → 0.3.3

package/.aide/docs/index.md

@@ -11,7 +11,7 @@
 
 ## Pipeline Agents
 
-AIDE ships eight canonical agents that `aide_init` installs to `.claude/agents/aide/`. Each agent maps to one pipeline role:
+AIDE ships nine canonical agents that `aide_init` installs to `.claude/agents/aide/`. Eight map to pipeline phases; one is a read-only investigator:
 
 | Agent | Model | Phase(s) | Brain Access |
 |---|---|---|---|
@@ -23,8 +23,9 @@ AIDE ships eight canonical agents that `aide_init` installs to `.claude/agents/a
 | `aide-qa` | sonnet | qa | none |
 | `aide-aligner` | opus | align | none |
 | `aide-auditor` | opus | refactor | read (playbook + brain) |
+| `aide-explorer` | sonnet | investigation (read-only) | read |
 
-The orchestrator (`/aide`) delegates to these agents by name. Each agent gets fresh context per phase — handoff is via files (`.aide`, `plan.aide`, `todo.aide`), not conversation.
+The orchestrator (`/aide`) delegates to these agents by name. Each agent gets fresh context per phase — handoff is via files (`.aide`, `plan.aide`, `todo.aide`), not conversation. The explorer is the exception: it is a non-pipeline agent used for bug tracing, codebase questions, and intent-tree navigation — it never writes files.
 
 ## Skills
 

package/dist/tools/discover/buildTree/index.js

@@ -47,7 +47,10 @@ export default function buildTree(files, root) {
             const connector = isLastFile ? "└──" : "├──";
             const name = basename(file.relativePath);
             const tag = `[${file.type}]`;
-            const summary = file.summary ? ` — ${file.summary}` : "";
+            const label = file.type === "intent" || file.type === "research"
+                ? file.description || ""
+                : file.summary || "";
+            const summary = label ? ` — ${label}` : "";
             lines.push(`  ${connector} ${name} ${tag}${summary}`);
         }
         if (d < sortedDirs.length - 1)

package/dist/tools/init/initContent/index.d.ts

@@ -33,6 +33,7 @@ declare const DOC_PATHS: {
     readonly "agents/aide/aide-qa": ".claude/agents/aide/aide-qa.md";
     readonly "agents/aide/aide-auditor": ".claude/agents/aide/aide-auditor.md";
     readonly "agents/aide/aide-aligner": ".claude/agents/aide/aide-aligner.md";
+    readonly "agents/aide/aide-explorer": ".claude/agents/aide/aide-explorer.md";
     readonly "commands/aide/align": ".claude/commands/aide/align.md";
     readonly "cascading-alignment": ".aide/docs/cascading-alignment.md";
     readonly "skills/study-playbook": ".claude/skills/study-playbook/SKILL.md";

package/dist/tools/init/initContent/index.js

@@ -57,6 +57,7 @@ const DOC_PATHS = {
     "agents/aide/aide-qa": ".claude/agents/aide/aide-qa.md",
     "agents/aide/aide-auditor": ".claude/agents/aide/aide-auditor.md",
     "agents/aide/aide-aligner": ".claude/agents/aide/aide-aligner.md",
+    "agents/aide/aide-explorer": ".claude/agents/aide/aide-explorer.md",
     "commands/aide/align": ".claude/commands/aide/align.md",
     "cascading-alignment": ".aide/docs/cascading-alignment.md",
     "skills/study-playbook": ".claude/skills/study-playbook/SKILL.md",
@@ -96,6 +97,7 @@ const AGENT_DOCS = [
     { canonical: "agents/aide/aide-qa", hostFilename: "aide/aide-qa.md" },
     { canonical: "agents/aide/aide-auditor", hostFilename: "aide/aide-auditor.md" },
     { canonical: "agents/aide/aide-aligner", hostFilename: "aide/aide-aligner.md" },
+    { canonical: "agents/aide/aide-explorer", hostFilename: "aide/aide-explorer.md" },
 ];
 /**
  * The canonical list of skill templates that ship into the host's skill

package/dist/util/scan/index.js

@@ -3,31 +3,22 @@ import { join, relative } from "node:path";
 import { classifyFile } from "../../util/classify/index.js";
 import { SKIP_DIRS } from "../../types/index.js";
 import parseFrontmatter from "../../util/parseFrontmatter/index.js";
-/** Extract the first meaningful body line as the summary, truncated to ~80 chars. */
-function extractSummary(content) {
+/** Count checked and total checkbox items in content. */
+function countCheckboxes(content) {
     const lines = content.split("\n");
-    let bodyStart = 0;
-    // Skip YAML frontmatter if present
-    if (lines[0] && lines[0].trim() === "---") {
-        let closingIdx = -1;
-        for (let i = 1; i < lines.length; i++) {
-            if (lines[i].trim() === "---") {
-                closingIdx = i;
-                break;
-            }
+    let done = 0;
+    let total = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("- [x]") || trimmed.startsWith("- [X]")) {
+            done++;
+            total++;
+        }
+        else if (trimmed.startsWith("- [ ]")) {
+            total++;
         }
-        bodyStart = closingIdx !== -1 ? closingIdx + 1 : lines.length;
-    }
-    // Find the first non-empty, non-heading line after frontmatter
-    for (let i = bodyStart; i < lines.length; i++) {
-        const line = lines[i].trim();
-        if (!line || line.startsWith("#"))
-            continue;
-        if (line.length <= 80)
-            return line;
-        return line.slice(0, 77) + "...";
     }
-    return "";
+    return { done, total };
 }
 /** Normalize a Windows or mixed path to POSIX forward slashes. */
 function toPosix(p) {
@@ -66,14 +57,18 @@ async function walk(dir, root, files, shallow) {
         let summary = "";
         let description = "";
         let status;
+        const type = classifyFile(entry.name);
         if (!shallow) {
             try {
                 const buf = await readFile(fullPath, { encoding: "utf-8" });
-                summary = extractSummary(buf.slice(0, 1000));
                 const { frontmatter } = parseFrontmatter(buf);
                 description = deriveDescription(frontmatter);
                 if (frontmatter?.status)
                     status = frontmatter.status;
+                if (type === "plan" || type === "todo") {
+                    const { done, total } = countCheckboxes(buf);
+                    summary = total > 0 ? `${done}/${total} done` : "";
+                }
             }
             catch {
                 // skip unreadable files
@@ -97,7 +92,7 @@ async function walk(dir, root, files, shallow) {
         files.push({
             path: fullPath,
             relativePath: toPosix(relative(root, fullPath)),
-            type: classifyFile(entry.name),
+            type,
             summary,
             description,
             status,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@aidemd-mcp/server",
-	"version": "0.3.1",
+	"version": "0.3.3",
 	"description": "MCP server that teaches any agent the AIDE methodology through tool descriptions and progressive disclosure tooling",
 	"type": "module",
 	"bin": {