@agentbrain/mcp-server 1.4.70 → 1.4.76

package/dist/tools/load-guardrails.js

@@ -0,0 +1,149 @@
+// MCP tool: load_guardrails - Load workspace Guardrails from cloud
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// ══════════════════════════════════════════════════════════════
+// Environment & Configuration
+// ══════════════════════════════════════════════════════════════
+const BASE_URL = process.env.AGENTBRAIN_API_BASE_URL?.replace(/\/$/, '') ?? 'https://www.useagentbrain.com/api/v1';
+const GUARDRAILS_URL = `${BASE_URL}/guardrails`;
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    if (!path.startsWith('/')) {
+        return join(process.cwd(), path);
+    }
+    return path;
+}
+// ══════════════════════════════════════════════════════════════
+// Schema
+// ══════════════════════════════════════════════════════════════
+export const loadGuardrailsSchema = {
+    name: 'load_guardrails',
+    description: 'Load workspace Guardrails — protected files, sensitive data rules, team boundaries, and invariants. Load before any file modification.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to repository',
+            },
+        },
+        required: ['repo_path'],
+    },
+};
+// ══════════════════════════════════════════════════════════════
+// Formatting
+// ══════════════════════════════════════════════════════════════
+function formatGuardrails(content) {
+    const workspaceName = content.workspace_name || 'Workspace';
+    let output = `# Guardrails — ${workspaceName}\n\n`;
+    // Protected Files
+    if (content.protected_files && content.protected_files.length > 0) {
+        output += '## Protected Files\n';
+        output += '⚠️ Never modify these files:\n';
+        for (const file of content.protected_files) {
+            output += `- ${file.path}: ${file.reason}\n`;
+        }
+        output += '\n';
+    }
+    // Sensitive Data
+    if (content.sensitive_data && content.sensitive_data.length > 0) {
+        output += '## Sensitive Data\n';
+        output += '🔒 Never log or expose these fields:\n';
+        for (const data of content.sensitive_data) {
+            output += `- ${data.field}: ${data.rule}\n`;
+        }
+        output += '\n';
+    }
+    // Team Boundaries
+    if (content.team_boundaries && content.team_boundaries.length > 0) {
+        output += '## Team Boundaries\n';
+        output += '👥 Requires approval before changes:\n';
+        for (const boundary of content.team_boundaries) {
+            output += `- ${boundary.path} → ${boundary.owner}: ${boundary.rule}\n`;
+        }
+        output += '\n';
+    }
+    // Invariants
+    if (content.invariants && content.invariants.length > 0) {
+        output += '## Invariants\n';
+        output += '🔴 Must always be true:\n';
+        for (const invariant of content.invariants) {
+            output += `- ${invariant}\n`;
+        }
+        output += '\n';
+    }
+    // Refactor Rules
+    if (content.refactor_scope || content.ask_before_refactoring !== undefined || content.refactor_notes) {
+        output += '## Refactor Rules\n';
+        if (content.refactor_scope) {
+            output += `Scope: ${content.refactor_scope}\n`;
+        }
+        if (content.ask_before_refactoring !== undefined) {
+            output += `Ask before refactoring outside scope: ${content.ask_before_refactoring ? 'yes' : 'no'}\n`;
+        }
+        if (content.refactor_notes) {
+            output += `${content.refactor_notes}\n`;
+        }
+        output += '\n';
+    }
+    return output;
+}
+function isContentEmpty(content) {
+    const hasProtectedFiles = content.protected_files && content.protected_files.length > 0;
+    const hasSensitiveData = content.sensitive_data && content.sensitive_data.length > 0;
+    const hasTeamBoundaries = content.team_boundaries && content.team_boundaries.length > 0;
+    const hasInvariants = content.invariants && content.invariants.length > 0;
+    const hasRefactorRules = !!(content.refactor_scope || content.ask_before_refactoring !== undefined || content.refactor_notes);
+    return !(hasProtectedFiles || hasSensitiveData || hasTeamBoundaries || hasInvariants || hasRefactorRules);
+}
+// ══════════════════════════════════════════════════════════════
+// Main Tool Function
+// ══════════════════════════════════════════════════════════════
+export async function loadGuardrails(input) {
+    const apiKey = process.env.AGENTBRAIN_API_KEY;
+    if (!apiKey) {
+        return `Guardrails requires an API key.
+Add AGENTBRAIN_API_KEY to your MCP config env block.
+Get your key at useagentbrain.com/settings`;
+    }
+    try {
+        const res = await fetch(GUARDRAILS_URL, {
+            method: 'GET',
+            headers: {
+                'x-api-key': apiKey,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (res.status === 401) {
+            return 'Invalid AGENTBRAIN_API_KEY. Check your MCP config env block.';
+        }
+        if (res.status === 404) {
+            return `No Guardrails found for this workspace.
+Create one at useagentbrain.com/settings → Guardrails tab.`;
+        }
+        if (!res.ok) {
+            const json = (await res.json());
+            return json.error ?? 'Failed to load Guardrails from AgentBrain.';
+        }
+        const json = (await res.json());
+        if (!json.data) {
+            return `No Guardrails found for this workspace.
+Create one at useagentbrain.com/settings → Guardrails tab.`;
+        }
+        const content = json.data.content;
+        if (isContentEmpty(content)) {
+            return `Guardrails exists but has no content yet.
+Fill it out at useagentbrain.com/settings → Guardrails tab.`;
+        }
+        return formatGuardrails(content);
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : 'Failed to load Guardrails.';
+    }
+}
+//# sourceMappingURL=load-guardrails.js.map

package/dist/tools/load-guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-guardrails.js","sourceRoot":"","sources":["../../src/tools/load-guardrails.ts"],"names":[],"mappings":"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"}

package/dist/tools/load-standards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-standards.d.ts","sourceRoot":"","sources":["../../src/tools/load-standards.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAYnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsB3F;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;CAmB/B,CAAA"}
+{"version":3,"file":"load-standards.d.ts","sourceRoot":"","sources":["../../src/tools/load-standards.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAyBnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;CACnB;AAiID,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsD3F;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;CAmB/B,CAAA"}

package/dist/tools/load-standards.js

@@ -1,9 +1,14 @@
-// MCP tool: load_standards - read standards file for an agent
+// MCP tool: load_standards - read standards file (cloud or local)
 import { readFile } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { AGENT_FILE_PATHS } from '@agentbrain/core';
+// ══════════════════════════════════════════════════════════════
+// Environment & Configuration
+// ══════════════════════════════════════════════════════════════
+const BASE_URL = process.env.AGENTBRAIN_API_BASE_URL?.replace(/\/$/, '') ?? 'https://www.useagentbrain.com/api/v1';
+const STANDARDS_URL = `${BASE_URL}/standards`;
 /**
  * Expand path: handles ~, relative paths, etc.
  */
@@ -13,14 +18,140 @@ function expandPath(path) {
     }
     return resolve(path);
 }
+// ══════════════════════════════════════════════════════════════
+// Formatting
+// ══════════════════════════════════════════════════════════════
+function formatStandards(content) {
+    const workspaceName = content.workspace_name || 'Workspace';
+    let output = `# Standards — ${workspaceName}\n\n`;
+    // Test Strategy
+    if (content.test_strategy) {
+        const ts = content.test_strategy;
+        if (ts.framework || ts.always_test || ts.never_test || ts.coverage_goal || ts.required) {
+            output += '## Test Strategy\n';
+            if (ts.framework)
+                output += `Framework: ${ts.framework}\n`;
+            if (ts.always_test)
+                output += `Always test: ${ts.always_test}\n`;
+            if (ts.never_test)
+                output += `Never test: ${ts.never_test}\n`;
+            if (ts.coverage_goal)
+                output += `Coverage goal: ${ts.coverage_goal}\n`;
+            if (ts.required)
+                output += `Required: ${ts.required}\n`;
+            output += '\n';
+        }
+    }
+    // PR Requirements
+    if (content.pr_requirements) {
+        const pr = content.pr_requirements;
+        if (pr.max_pr_size || pr.commit_format || pr.description_required !== undefined || pr.tests_required !== undefined) {
+            output += '## PR Requirements\n';
+            if (pr.max_pr_size)
+                output += `Max PR size: ${pr.max_pr_size}\n`;
+            if (pr.commit_format)
+                output += `Commit format: ${pr.commit_format}\n`;
+            if (pr.description_required !== undefined)
+                output += `Description required: ${pr.description_required ? 'yes' : 'no'}\n`;
+            if (pr.tests_required !== undefined)
+                output += `Tests required: ${pr.tests_required ? 'yes' : 'no'}\n`;
+            output += '\n';
+        }
+    }
+    // Code Style
+    if (content.code_style) {
+        const cs = content.code_style;
+        if (cs.max_function_length || cs.naming_conventions || cs.comment_style || cs.forbidden_patterns) {
+            output += '## Code Style\n';
+            if (cs.max_function_length)
+                output += `Max function length: ${cs.max_function_length}\n`;
+            if (cs.naming_conventions)
+                output += `Naming conventions: ${cs.naming_conventions}\n`;
+            if (cs.comment_style)
+                output += `Comment style: ${cs.comment_style}\n`;
+            if (cs.forbidden_patterns)
+                output += `Forbidden patterns: ${cs.forbidden_patterns}\n`;
+            output += '\n';
+        }
+    }
+    // Definition of Done
+    if (content.definition_of_done && content.definition_of_done.length > 0) {
+        output += '## Definition of Done\n';
+        output += 'Before marking any task complete, verify ALL of these:\n';
+        for (const item of content.definition_of_done) {
+            output += `- ${item}\n`;
+        }
+        output += '\n';
+    }
+    // Run Commands
+    if (content.run_commands) {
+        const rc = content.run_commands;
+        if (rc.dev || rc.test || rc.build || rc.lint || rc.typecheck) {
+            output += '## Run Commands\n';
+            if (rc.dev)
+                output += `Dev:        ${rc.dev}\n`;
+            if (rc.test)
+                output += `Test:       ${rc.test}\n`;
+            if (rc.build)
+                output += `Build:      ${rc.build}\n`;
+            if (rc.lint)
+                output += `Lint:       ${rc.lint}\n`;
+            if (rc.typecheck)
+                output += `Type check: ${rc.typecheck}\n`;
+            output += '\n';
+        }
+    }
+    return output;
+}
+function isContentEmpty(content) {
+    const hasTestStrategy = content.test_strategy && Object.values(content.test_strategy).some(v => v);
+    const hasPRRequirements = content.pr_requirements && Object.values(content.pr_requirements).some(v => v !== undefined);
+    const hasCodeStyle = content.code_style && Object.values(content.code_style).some(v => v);
+    const hasDefinitionOfDone = content.definition_of_done && content.definition_of_done.length > 0;
+    const hasRunCommands = content.run_commands && Object.values(content.run_commands).some(v => v);
+    return !(hasTestStrategy || hasPRRequirements || hasCodeStyle || hasDefinitionOfDone || hasRunCommands);
+}
+// ══════════════════════════════════════════════════════════════
+// Main Tool Function
+// ══════════════════════════════════════════════════════════════
 export async function loadStandards(input) {
     const { repo_path, agent } = input;
-    // Expand path to handle ~, relative paths, etc.
     const expandedPath = expandPath(repo_path);
+    const apiKey = process.env.AGENTBRAIN_API_KEY;
+    // ── Cloud mode with fallback ──────────────────────────────
+    if (apiKey) {
+        try {
+            const res = await fetch(STANDARDS_URL, {
+                method: 'GET',
+                headers: {
+                    'x-api-key': apiKey,
+                    'Content-Type': 'application/json',
+                },
+            });
+            // If 200 with content, use cloud version
+            if (res.ok) {
+                const json = (await res.json());
+                if (json.data && !isContentEmpty(json.data.content)) {
+                    return {
+                        content: formatStandards(json.data.content),
+                        filePath: 'cloud:standards',
+                        agent,
+                    };
+                }
+            }
+            // 404 or empty content → fall back to local file
+        }
+        catch (err) {
+            // Network error → fall back to local file
+        }
+    }
+    // ── Local disk mode (no API key OR cloud fallback) ────────
     const relativePath = AGENT_FILE_PATHS[agent];
     const filePath = join(expandedPath, relativePath);
     if (!existsSync(filePath)) {
-        throw new Error(`Standards file not found: ${relativePath}. Run "agentbrain standards" to generate it.`);
+        throw new Error(apiKey
+            ? `No Standards found. Create one at useagentbrain.com/settings → Standards tab or create a local standards file.`
+            : `Standards file not found: ${relativePath}. Run "agentbrain standards" to generate it.`);
     }
     const content = await readFile(filePath, 'utf-8');
     return {
@@ -31,7 +162,7 @@ export async function loadStandards(input) {
 }
 export const loadStandardsSchema = {
     name: 'load_standards',
-    description: 'Load coding standards file for a specific agent (Claude Code, Cursor, or Windsurf). Reads from disk - no AI call needed.',
+    description: 'Load coding standards (test/PR requirements). With AGENTBRAIN_API_KEY set, fetches from cloud first, falls back to local file. Without API key, reads from disk only.',
     inputSchema: {
         type: 'object',
         properties: {

package/dist/tools/load-standards.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-standards.js","sourceRoot":"","sources":["../../src/tools/load-standards.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGnD;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAElC,gDAAgD;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAE1C,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAEjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,6BAA6B,YAAY,8CAA8C,CACxF,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAEjD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,YAAY;QACtB,KAAK;KACN,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,0HAA0H;IAC5H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,UAAU,CAAC;gBAC3C,WAAW,EAAE,mCAAmC;aACjD;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACjC;CACF,CAAA"}
+{"version":3,"file":"load-standards.js","sourceRoot":"","sources":["../../src/tools/load-standards.ts"],"names":[],"mappings":"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"}

package/dist/tools/preflight-check.d.ts

@@ -0,0 +1,24 @@
+export interface PreflightCheckInput {
+    repo_path: string;
+    task?: string;
+}
+export declare const preflightCheckSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+            task: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function preflightCheck(input: PreflightCheckInput): Promise<string>;
+//# sourceMappingURL=preflight-check.d.ts.map

package/dist/tools/preflight-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-check.d.ts","sourceRoot":"","sources":["../../src/tools/preflight-check.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAwBD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;CAyBhC,CAAA;AA8GD,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqJhF"}

package/dist/tools/preflight-check.js

@@ -0,0 +1,279 @@
+// MCP tool: preflight_check - Load everything before starting a task
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { loadContext } from './load-context.js';
+import { loadBlueprint } from './load-blueprint.js';
+import { loadGuardrails } from './load-guardrails.js';
+import { loadStandards } from './load-standards.js';
+import { loadDecisions } from './load-decisions.js';
+// ══════════════════════════════════════════════════════════════
+// Environment & Configuration
+// ══════════════════════════════════════════════════════════════
+const BASE_URL = process.env.AGENTBRAIN_API_BASE_URL?.replace(/\/$/, '') ?? 'https://www.useagentbrain.com/api/v1';
+const SPECS_URL = `${BASE_URL}/specs`;
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    if (!path.startsWith('/')) {
+        return join(process.cwd(), path);
+    }
+    return path;
+}
+// ══════════════════════════════════════════════════════════════
+// Schema
+// ══════════════════════════════════════════════════════════════
+export const preflightCheckSchema = {
+    name: 'preflight_check',
+    description: 'Run before starting ANY task. Loads codebase context, workspace Playbook (Blueprint, Guardrails, Standards, Decisions), and active spec in one parallel call. Returns a targeted briefing for your task.\n\n' +
+        'Use this instead of calling load_context(), load_blueprint(), load_guardrails(), load_standards(), load_decisions(), and load_spec() separately.\n\n' +
+        'Usage:\n' +
+        'preflight_check({\n' +
+        '  repo_path: "/path/to/repo",\n' +
+        '  task: "what you are about to build"\n' +
+        '})',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to repository',
+            },
+            task: {
+                type: 'string',
+                description: 'Optional: What you are about to do (e.g., "implement Stripe webhook handler", "refactor auth module"). Used to filter relevant context.',
+            },
+        },
+        required: ['repo_path'],
+    },
+};
+// ══════════════════════════════════════════════════════════════
+// Helpers
+// ══════════════════════════════════════════════════════════════
+async function fetchActiveSpec(apiKey) {
+    try {
+        const res = await fetch(SPECS_URL, {
+            method: 'GET',
+            headers: {
+                'x-api-key': apiKey,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!res.ok)
+            return null;
+        const json = (await res.json());
+        if (!json.data)
+            return null;
+        const spec = json.data;
+        const approach = Array.isArray(spec.answers.approach)
+            ? spec.answers.approach.map((a) => `- ${a}`).join('\n')
+            : spec.answers.approach;
+        const doneCriteria = Array.isArray(spec.answers.done_criteria)
+            ? spec.answers.done_criteria.map((d) => `- [ ] ${d}`).join('\n')
+            : spec.answers.done_criteria;
+        return `**${spec.title}** (${spec.status})
+
+Problem: ${spec.answers.problem}
+
+Approach:
+${approach}
+
+Done Criteria:
+${doneCriteria}`;
+    }
+    catch (err) {
+        return null;
+    }
+}
+function isRelevantSection(section, task) {
+    const taskLower = task.toLowerCase();
+    const sectionLower = section.toLowerCase();
+    // Auth-related tasks
+    if (taskLower.includes('auth') && sectionLower.includes('auth'))
+        return true;
+    // Billing/payment tasks
+    if ((taskLower.includes('billing') || taskLower.includes('stripe') || taskLower.includes('payment')) &&
+        (sectionLower.includes('billing') || sectionLower.includes('stripe') || sectionLower.includes('payment'))) {
+        return true;
+    }
+    // Database tasks
+    if ((taskLower.includes('database') || taskLower.includes('migration') || taskLower.includes('schema')) &&
+        (sectionLower.includes('database') || sectionLower.includes('migration') || sectionLower.includes('schema'))) {
+        return true;
+    }
+    // API tasks
+    if ((taskLower.includes('api') || taskLower.includes('endpoint') || taskLower.includes('route')) &&
+        (sectionLower.includes('api') || sectionLower.includes('endpoint') || sectionLower.includes('route'))) {
+        return true;
+    }
+    return false;
+}
+function filterContent(content, task) {
+    if (!task)
+        return content;
+    const lines = content.split('\n');
+    const filtered = [];
+    let currentSection = '';
+    let includeSection = false;
+    for (const line of lines) {
+        // New section header
+        if (line.startsWith('##')) {
+            currentSection = line;
+            includeSection = isRelevantSection(line, task);
+            if (includeSection) {
+                filtered.push(line);
+            }
+        }
+        else if (includeSection) {
+            // Include content from relevant sections
+            filtered.push(line);
+        }
+        else if (line.startsWith('#') || line.trim() === '') {
+            // Always include top-level headers and blank lines
+            filtered.push(line);
+        }
+    }
+    return filtered.join('\n');
+}
+// ══════════════════════════════════════════════════════════════
+// Main Tool Function
+// ══════════════════════════════════════════════════════════════
+export async function preflightCheck(input) {
+    const { repo_path, task } = input;
+    const expandedPath = expandPath(repo_path);
+    const apiKey = process.env.AGENTBRAIN_API_KEY;
+    let output = '# Preflight Check ✓\n\n';
+    const errors = [];
+    // ── Parallel fetch all sources ────────────────────────────────
+    const results = await Promise.allSettled([
+        // Load slim context summary
+        loadContext({ repo_path, full: false }),
+        // Load workspace documents
+        apiKey ? loadBlueprint({ repo_path }) : Promise.resolve(null),
+        apiKey ? loadGuardrails({ repo_path }) : Promise.resolve(null),
+        apiKey ? loadStandards({ repo_path, agent: 'claude-code' }) : Promise.resolve(null),
+        apiKey ? loadDecisions({ repo_path }) : Promise.resolve(null),
+        // Load active spec
+        apiKey ? fetchActiveSpec(apiKey) : Promise.resolve(null),
+    ]);
+    // Extract results
+    const [contextResult, blueprintResult, guardrailsResult, standardsResult, decisionsResult, specResult] = results;
+    const context = contextResult.status === 'fulfilled' ? contextResult.value.content : null;
+    const blueprint = blueprintResult.status === 'fulfilled' ? blueprintResult.value : null;
+    const guardrails = guardrailsResult.status === 'fulfilled' ? guardrailsResult.value : null;
+    const standards = standardsResult.status === 'fulfilled' ? standardsResult.value?.content : null;
+    const decisions = decisionsResult.status === 'fulfilled' ? decisionsResult.value : null;
+    const spec = specResult.status === 'fulfilled' ? specResult.value : null;
+    // Track errors
+    if (contextResult.status === 'rejected')
+        errors.push(`Context: ${contextResult.reason}`);
+    if (blueprintResult.status === 'rejected')
+        errors.push(`Blueprint: ${blueprintResult.reason}`);
+    if (guardrailsResult.status === 'rejected')
+        errors.push(`Guardrails: ${guardrailsResult.reason}`);
+    if (standardsResult.status === 'rejected')
+        errors.push(`Standards: ${standardsResult.reason}`);
+    if (decisionsResult.status === 'rejected')
+        errors.push(`Decisions: ${decisionsResult.reason}`);
+    // ── Build output ───────────────────────────────────────────────
+    // Active Spec
+    if (spec) {
+        output += '## Active Spec\n';
+        output += spec + '\n\n';
+    }
+    else if (apiKey) {
+        output += '## Active Spec\n';
+        output += 'No active spec. Create one at useagentbrain.com/specs\n\n';
+    }
+    // Codebase Context
+    if (context) {
+        // Extract branch info
+        const contextLines = context.split('\n');
+        const branchLineIndex = contextLines.findIndex((l) => l.includes('## Current Branch'));
+        const branch = branchLineIndex >= 0 ? contextLines[branchLineIndex + 1]?.trim() : 'unknown';
+        output += '## Codebase Context\n';
+        output += `Branch: ${branch}\n`;
+        // Extract 2-3 line summary from context
+        const lines = context.split('\n').filter((l) => l.trim() && !l.startsWith('#'));
+        const summary = lines.slice(0, 3).join('\n');
+        if (summary) {
+            output += summary + '\n';
+        }
+        output += '\n';
+    }
+    // How We Build Here (Blueprint)
+    if (blueprint && !blueprint.includes('requires an API key') && !blueprint.includes('no content yet')) {
+        output += '## How We Build Here\n';
+        const filtered = task ? filterContent(blueprint, task) : blueprint;
+        // Remove the top-level title
+        const content = filtered.replace(/^# Blueprint.*\n\n/, '');
+        output += content + '\n';
+    }
+    // Guardrails for This Task
+    if (guardrails && !guardrails.includes('requires an API key') && !guardrails.includes('no content yet')) {
+        const isRefactor = task?.toLowerCase().includes('refactor');
+        output += isRefactor ? '## Guardrails (Refactoring)\n' : '## Guardrails for This Task\n';
+        const filtered = task ? filterContent(guardrails, task) : guardrails;
+        // Remove the top-level title
+        const content = filtered.replace(/^# Guardrails.*\n\n/, '');
+        output += content + '\n';
+    }
+    // Decisions to Know
+    if (decisions && !decisions.includes('requires an API key') && !decisions.includes('No Decisions found')) {
+        output += '## Decisions to Know\n';
+        const filtered = task ? filterContent(decisions, task) : decisions;
+        // Remove the top-level title
+        const content = filtered.replace(/^# Decisions.*\n\n/, '');
+        output += content + '\n';
+    }
+    // Standards (emphasize for test/PR/review tasks)
+    const isTestOrPR = task?.toLowerCase().match(/test|pr|review|done/);
+    if (standards && isTestOrPR) {
+        output += '## Standards & Definition of Done\n';
+        const filtered = task ? filterContent(standards, task) : standards;
+        // Remove the top-level title
+        const content = filtered.replace(/^# Standards.*\n\n/, '');
+        output += content + '\n';
+    }
+    else if (standards) {
+        // Extract just Definition of Done for other tasks
+        const dodMatch = standards.match(/## Definition of Done\n([\s\S]*?)(?=\n##|\n$|$)/);
+        if (dodMatch) {
+            output += '## Definition of Done\n';
+            output += dodMatch[1].trim() + '\n\n';
+        }
+    }
+    // ── Footer ─────────────────────────────────────────────────────
+    // No API key message
+    if (!apiKey) {
+        output += '\n---\n\n';
+        output +=
+            '💡 Add AGENTBRAIN_API_KEY to your MCP config to load Blueprint, Guardrails, Standards, and Decisions.\n';
+        output += 'Get your key at useagentbrain.com/settings\n\n';
+    }
+    // No Playbook message
+    if (apiKey &&
+        blueprint?.includes('no content yet') &&
+        guardrails?.includes('no content yet') &&
+        decisions?.includes('No Decisions found')) {
+        output += '\n---\n\n';
+        output += '💡 No Playbook found for this workspace.\n';
+        output += 'Create one at useagentbrain.com/playbook to give your agent architectural guidance.\n\n';
+    }
+    // Errors
+    if (errors.length > 0) {
+        output += '\n---\n\n';
+        output += '⚠️ Some sources failed to load:\n';
+        for (const error of errors) {
+            output += `- ${error}\n`;
+        }
+        output += '\n';
+    }
+    output += '---\n';
+    output += 'Ready. Proceed with task.\n';
+    return output;
+}
+//# sourceMappingURL=preflight-check.js.map