monomind 1.6.0 → 1.6.1

package/packages/@monomind/cli/dist/src/mcp-tools/github-tools.d.ts

@@ -1,9 +0,0 @@
-/**
- * GitHub MCP Tools for CLI
- *
- * Real GitHub integration via `gh` CLI and `git` commands.
- * Falls back to local state management when CLI tools are unavailable.
- */
-import { type MCPTool } from './types.js';
-export declare const githubTools: MCPTool[];
-//# sourceMappingURL=github-tools.d.ts.map

package/packages/@monomind/cli/dist/src/mcp-tools/github-tools.js

@@ -1,472 +0,0 @@
-/**
- * GitHub MCP Tools for CLI
- *
- * Real GitHub integration via `gh` CLI and `git` commands.
- * Falls back to local state management when CLI tools are unavailable.
- */
-import { getProjectCwd } from './types.js';
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { join } from 'node:path';
-import { execSync } from 'node:child_process';
-// Storage paths
-const STORAGE_DIR = '.monomind';
-const GITHUB_DIR = 'github';
-const GITHUB_FILE = 'store.json';
-function getGitHubDir() {
-    return join(getProjectCwd(), STORAGE_DIR, GITHUB_DIR);
-}
-function getGitHubPath() {
-    return join(getGitHubDir(), GITHUB_FILE);
-}
-function ensureGitHubDir() {
-    const dir = getGitHubDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-}
-function loadGitHubStore() {
-    try {
-        const path = getGitHubPath();
-        if (existsSync(path)) {
-            return JSON.parse(readFileSync(path, 'utf-8'));
-        }
-    }
-    catch {
-        // Return empty store
-    }
-    return { repos: {}, prs: {}, issues: {}, version: '3.0.0' };
-}
-function saveGitHubStore(store) {
-    ensureGitHubDir();
-    writeFileSync(getGitHubPath(), JSON.stringify(store, null, 2), 'utf-8');
-}
-/** Run a shell command, return stdout or null on failure */
-function run(cmd, cwd) {
-    try {
-        return execSync(cmd, { encoding: 'utf-8', timeout: 15000, cwd: cwd || getProjectCwd(), stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-    }
-    catch {
-        return null;
-    }
-}
-/** Check if gh CLI is available */
-function hasGhCli() {
-    return run('gh --version') !== null;
-}
-export const githubTools = [
-    {
-        name: 'github_repo_analyze',
-        description: 'Analyze a GitHub repository',
-        category: 'github',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string', description: 'Repository owner' },
-                repo: { type: 'string', description: 'Repository name' },
-                branch: { type: 'string', description: 'Branch to analyze' },
-                deep: { type: 'boolean', description: 'Deep analysis' },
-            },
-        },
-        handler: async (input) => {
-            const store = loadGitHubStore();
-            const branch = input.branch || 'main';
-            const cwd = getProjectCwd();
-            // Try real git analysis first
-            const commitCount = run('git rev-list --count HEAD', cwd);
-            const branchCount = run('git branch -a --no-color | wc -l', cwd);
-            const contributors = run('git shortlog -sn --no-merges HEAD | wc -l', cwd);
-            const currentBranch = run('git rev-parse --abbrev-ref HEAD', cwd);
-            const remoteUrl = run('git remote get-url origin', cwd);
-            // Parse owner/repo from remote URL
-            let owner = input.owner || '';
-            let repo = input.repo || '';
-            if (remoteUrl && (!owner || !repo)) {
-                const m = remoteUrl.match(/[:/]([^/]+)\/([^/.]+?)(?:\.git)?$/);
-                if (m) {
-                    owner = owner || m[1];
-                    repo = repo || m[2];
-                }
-            }
-            const repoKey = `${owner || 'local'}/${repo || 'repo'}`;
-            if (commitCount !== null) {
-                // Real git data available
-                const repoInfo = {
-                    owner: owner || 'local',
-                    name: repo || 'repo',
-                    branch: currentBranch || branch,
-                    lastAnalyzed: new Date().toISOString(),
-                    metrics: {
-                        commits: parseInt(commitCount, 10) || 0,
-                        branches: parseInt(branchCount || '0', 10) || 0,
-                        contributors: parseInt(contributors || '0', 10) || 0,
-                        openIssues: 0,
-                        openPRs: 0,
-                    },
-                };
-                // Try gh CLI for issue/PR counts
-                if (hasGhCli()) {
-                    const issueCount = run(`gh issue list --state open --limit 1000 --json number --jq 'length'`);
-                    const prCount = run(`gh pr list --state open --limit 1000 --json number --jq 'length'`);
-                    if (issueCount !== null)
-                        repoInfo.metrics.openIssues = parseInt(issueCount, 10) || 0;
-                    if (prCount !== null)
-                        repoInfo.metrics.openPRs = parseInt(prCount, 10) || 0;
-                }
-                store.repos[repoKey] = repoInfo;
-                saveGitHubStore(store);
-                return {
-                    success: true,
-                    _real: true,
-                    repository: repoKey,
-                    branch: repoInfo.branch,
-                    metrics: repoInfo.metrics,
-                    remoteUrl: remoteUrl || null,
-                    lastAnalyzed: repoInfo.lastAnalyzed,
-                };
-            }
-            // No git — return local store data
-            return {
-                success: false,
-                error: 'Not a git repository or git not available.',
-                localData: { storedRepos: Object.keys(store.repos) },
-            };
-        },
-    },
-    {
-        name: 'github_pr_manage',
-        description: 'Manage pull requests',
-        category: 'github',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['list', 'create', 'review', 'merge', 'close'], description: 'Action to perform' },
-                owner: { type: 'string', description: 'Repository owner' },
-                repo: { type: 'string', description: 'Repository name' },
-                prNumber: { type: 'number', description: 'PR number' },
-                title: { type: 'string', description: 'PR title' },
-                branch: { type: 'string', description: 'Source branch' },
-                baseBranch: { type: 'string', description: 'Target branch' },
-                body: { type: 'string', description: 'PR description' },
-            },
-        },
-        handler: async (input) => {
-            const store = loadGitHubStore();
-            const action = input.action || 'list';
-            const gh = hasGhCli();
-            if (action === 'list') {
-                if (gh) {
-                    const raw = run('gh pr list --state all --limit 20 --json number,title,state,headRefName,createdAt');
-                    if (raw) {
-                        try {
-                            const prs = JSON.parse(raw);
-                            return { success: true, _real: true, source: 'gh-cli', pullRequests: prs, total: prs.length };
-                        }
-                        catch { /* fall through */ }
-                    }
-                }
-                const prs = Object.values(store.prs);
-                return { success: true, source: 'local-store', pullRequests: prs, total: prs.length, open: prs.filter(pr => pr.status === 'open').length };
-            }
-            if (action === 'create') {
-                if (gh) {
-                    const title = input.title || 'New PR';
-                    const headBranch = input.branch || run('git rev-parse --abbrev-ref HEAD') || 'feature';
-                    const baseBranch = input.baseBranch || 'main';
-                    const body = input.body || '';
-                    const result = run(`gh pr create --title "${title.replace(/"/g, '\\"')}" --base "${baseBranch}" --head "${headBranch}" --body "${body.replace(/"/g, '\\"')}"`);
-                    if (result) {
-                        return { success: true, _real: true, action: 'created', url: result };
-                    }
-                }
-                // Fallback: local store
-                const prId = `pr-${Date.now()}`;
-                const pr = { id: prId, title: input.title || 'New PR', status: 'open', branch: input.branch || 'feature', baseBranch: input.baseBranch || 'main', createdAt: new Date().toISOString() };
-                store.prs[prId] = pr;
-                saveGitHubStore(store);
-                return { success: true, source: 'local-store', action: 'created', pullRequest: pr };
-            }
-            if (action === 'review') {
-                const prNumber = input.prNumber;
-                if (gh && prNumber) {
-                    const raw = run(`gh pr view ${prNumber} --json number,title,state,body,additions,deletions,changedFiles,reviews,mergeable,statusCheckRollup`);
-                    if (raw) {
-                        try {
-                            return { success: true, _real: true, action: 'review', pullRequest: JSON.parse(raw) };
-                        }
-                        catch { /* fall through */ }
-                    }
-                }
-                return { success: false, error: prNumber ? 'gh CLI not available or PR not found. Install gh: https://cli.github.com' : 'prNumber is required for review.' };
-            }
-            if (action === 'merge') {
-                const prNumber = input.prNumber;
-                if (gh && prNumber) {
-                    const result = run(`gh pr merge ${prNumber} --merge`);
-                    if (result !== null) {
-                        return { success: true, _real: true, action: 'merged', prNumber, mergedAt: new Date().toISOString() };
-                    }
-                }
-                // Fallback: local store
-                const prKey = Object.keys(store.prs).find(k => k.includes(String(prNumber)));
-                if (prKey && store.prs[prKey]) {
-                    store.prs[prKey].status = 'merged';
-                    saveGitHubStore(store);
-                }
-                return { success: true, source: 'local-store', action: 'merged', prNumber, mergedAt: new Date().toISOString() };
-            }
-            if (action === 'close') {
-                const prNumber = input.prNumber;
-                if (gh && prNumber) {
-                    const result = run(`gh pr close ${prNumber}`);
-                    if (result !== null) {
-                        return { success: true, _real: true, action: 'closed', prNumber, closedAt: new Date().toISOString() };
-                    }
-                }
-                const prKey = Object.keys(store.prs).find(k => k.includes(String(prNumber)));
-                if (prKey && store.prs[prKey]) {
-                    store.prs[prKey].status = 'closed';
-                    saveGitHubStore(store);
-                }
-                return { success: true, source: 'local-store', action: 'closed', prNumber, closedAt: new Date().toISOString() };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'github_issue_track',
-        description: 'Track and manage issues',
-        category: 'github',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['list', 'create', 'update', 'close', 'assign'], description: 'Action to perform' },
-                owner: { type: 'string', description: 'Repository owner' },
-                repo: { type: 'string', description: 'Repository name' },
-                issueNumber: { type: 'number', description: 'Issue number' },
-                title: { type: 'string', description: 'Issue title' },
-                body: { type: 'string', description: 'Issue body' },
-                labels: { type: 'array', items: { type: 'string' }, description: 'Issue labels' },
-                assignees: { type: 'array', items: { type: 'string' }, description: 'Assignees' },
-            },
-        },
-        handler: async (input) => {
-            const store = loadGitHubStore();
-            const action = input.action || 'list';
-            const gh = hasGhCli();
-            if (action === 'list') {
-                if (gh) {
-                    const raw = run('gh issue list --state all --limit 20 --json number,title,state,labels,createdAt');
-                    if (raw) {
-                        try {
-                            const issues = JSON.parse(raw);
-                            return { success: true, _real: true, source: 'gh-cli', issues, total: issues.length };
-                        }
-                        catch { /* fall through */ }
-                    }
-                }
-                const issues = Object.values(store.issues);
-                return { success: true, source: 'local-store', issues, total: issues.length, open: issues.filter(i => i.status === 'open').length };
-            }
-            if (action === 'create') {
-                const title = input.title || 'New Issue';
-                const body = input.body || '';
-                const labels = input.labels || [];
-                if (gh) {
-                    const labelArg = labels.length > 0 ? ` --label "${labels.join(',')}"` : '';
-                    const result = run(`gh issue create --title "${title.replace(/"/g, '\\"')}" --body "${body.replace(/"/g, '\\"')}"${labelArg}`);
-                    if (result) {
-                        return { success: true, _real: true, action: 'created', url: result };
-                    }
-                }
-                const issueId = `issue-${Date.now()}`;
-                const issue = { id: issueId, title, status: 'open', labels, createdAt: new Date().toISOString() };
-                store.issues[issueId] = issue;
-                saveGitHubStore(store);
-                return { success: true, source: 'local-store', action: 'created', issue };
-            }
-            if (action === 'update') {
-                const issueNumber = input.issueNumber;
-                if (gh && issueNumber) {
-                    const parts = [];
-                    if (input.title)
-                        parts.push(`--title "${input.title.replace(/"/g, '\\"')}"`);
-                    if (input.labels)
-                        parts.push(`--add-label "${input.labels.join(',')}"`);
-                    if (parts.length > 0) {
-                        const result = run(`gh issue edit ${issueNumber} ${parts.join(' ')}`);
-                        if (result !== null)
-                            return { success: true, _real: true, action: 'updated', issueNumber };
-                    }
-                }
-                const issueKey = Object.keys(store.issues).find(k => k.includes(String(issueNumber)));
-                if (issueKey && store.issues[issueKey]) {
-                    if (input.title)
-                        store.issues[issueKey].title = input.title;
-                    if (input.labels)
-                        store.issues[issueKey].labels = input.labels;
-                    saveGitHubStore(store);
-                }
-                return { success: true, source: 'local-store', action: 'updated', issueNumber };
-            }
-            if (action === 'close') {
-                const issueNumber = input.issueNumber;
-                if (gh && issueNumber) {
-                    const result = run(`gh issue close ${issueNumber}`);
-                    if (result !== null)
-                        return { success: true, _real: true, action: 'closed', issueNumber, closedAt: new Date().toISOString() };
-                }
-                const issueKey = Object.keys(store.issues).find(k => k.includes(String(issueNumber)));
-                if (issueKey && store.issues[issueKey]) {
-                    store.issues[issueKey].status = 'closed';
-                    saveGitHubStore(store);
-                }
-                return { success: true, source: 'local-store', action: 'closed', issueNumber, closedAt: new Date().toISOString() };
-            }
-            return { success: false, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'github_workflow',
-        description: 'Manage GitHub Actions workflows',
-        category: 'github',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['list', 'trigger', 'status', 'cancel'], description: 'Action to perform' },
-                owner: { type: 'string', description: 'Repository owner' },
-                repo: { type: 'string', description: 'Repository name' },
-                workflowId: { type: 'string', description: 'Workflow ID or name' },
-                ref: { type: 'string', description: 'Branch or tag ref' },
-            },
-        },
-        handler: async (input) => {
-            const action = input.action || 'list';
-            const gh = hasGhCli();
-            if (!gh) {
-                return { success: false, error: 'gh CLI not available. Install: https://cli.github.com' };
-            }
-            if (action === 'list') {
-                const raw = run('gh run list --limit 10 --json databaseId,displayTitle,status,conclusion,headBranch,createdAt');
-                if (raw) {
-                    try {
-                        return { success: true, _real: true, runs: JSON.parse(raw) };
-                    }
-                    catch { /* fall through */ }
-                }
-                const workflows = run('gh workflow list --json id,name,state');
-                if (workflows) {
-                    try {
-                        return { success: true, _real: true, workflows: JSON.parse(workflows) };
-                    }
-                    catch { /* fall through */ }
-                }
-            }
-            if (action === 'status') {
-                const workflowId = input.workflowId;
-                if (workflowId) {
-                    const raw = run(`gh run view ${workflowId} --json databaseId,displayTitle,status,conclusion,jobs`);
-                    if (raw) {
-                        try {
-                            return { success: true, _real: true, run: JSON.parse(raw) };
-                        }
-                        catch { /* fall through */ }
-                    }
-                }
-                // List recent runs as fallback
-                const recent = run('gh run list --limit 5 --json databaseId,displayTitle,status,conclusion');
-                if (recent) {
-                    try {
-                        return { success: true, _real: true, recentRuns: JSON.parse(recent) };
-                    }
-                    catch { /* fall through */ }
-                }
-            }
-            if (action === 'trigger') {
-                const workflowId = input.workflowId;
-                const ref = input.ref || 'main';
-                if (workflowId) {
-                    const result = run(`gh workflow run "${workflowId}" --ref "${ref}"`);
-                    if (result !== null)
-                        return { success: true, _real: true, action: 'triggered', workflowId, ref };
-                }
-                return { success: false, error: 'workflowId is required to trigger a workflow.' };
-            }
-            if (action === 'cancel') {
-                const workflowId = input.workflowId;
-                if (workflowId) {
-                    const result = run(`gh run cancel ${workflowId}`);
-                    if (result !== null)
-                        return { success: true, _real: true, action: 'cancelled', runId: workflowId };
-                }
-                return { success: false, error: 'workflowId (run ID) is required to cancel.' };
-            }
-            return { success: false, error: `Unknown action: ${action}` };
-        },
-    },
-    {
-        name: 'github_metrics',
-        description: 'Get repository metrics and statistics',
-        category: 'github',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                owner: { type: 'string', description: 'Repository owner' },
-                repo: { type: 'string', description: 'Repository name' },
-                metric: { type: 'string', enum: ['all', 'commits', 'contributors', 'traffic', 'releases'], description: 'Metric type' },
-                timeRange: { type: 'string', description: 'Time range (e.g., "7d", "30d", "90d")' },
-            },
-        },
-        handler: async (input) => {
-            const metric = input.metric || 'all';
-            const timeRange = input.timeRange || '30d';
-            const cwd = getProjectCwd();
-            // Parse time range
-            const days = parseInt(timeRange, 10) || 30;
-            const since = new Date(Date.now() - days * 86400000).toISOString().split('T')[0];
-            const result = { _real: true, timeRange: `${days}d`, since };
-            const wantAll = metric === 'all';
-            if (wantAll || metric === 'commits') {
-                const total = run(`git rev-list --count HEAD`, cwd);
-                const recent = run(`git rev-list --count --since="${since}" HEAD`, cwd);
-                result.commits = {
-                    total: parseInt(total || '0', 10),
-                    sincePeriod: parseInt(recent || '0', 10),
-                };
-            }
-            if (wantAll || metric === 'contributors') {
-                const allContrib = run('git shortlog -sn --no-merges HEAD', cwd);
-                if (allContrib) {
-                    const lines = allContrib.split('\n').filter(Boolean);
-                    result.contributors = {
-                        total: lines.length,
-                        top: lines.slice(0, 10).map(l => {
-                            const m = l.trim().match(/^(\d+)\t(.+)$/);
-                            return m ? { commits: parseInt(m[1], 10), name: m[2].trim() } : null;
-                        }).filter(Boolean),
-                    };
-                }
-            }
-            if (wantAll || metric === 'releases') {
-                if (hasGhCli()) {
-                    const raw = run('gh release list --limit 10 --json tagName,name,publishedAt,isPrerelease');
-                    if (raw) {
-                        try {
-                            result.releases = JSON.parse(raw);
-                        }
-                        catch { /* skip */ }
-                    }
-                }
-                if (!result.releases) {
-                    const tags = run('git tag --sort=-creatordate | head -10', cwd);
-                    result.releases = tags ? tags.split('\n').filter(Boolean).map(t => ({ tagName: t })) : [];
-                }
-            }
-            // Always include branch info
-            const branchCount = run('git branch -a --no-color | wc -l', cwd);
-            const currentBranch = run('git rev-parse --abbrev-ref HEAD', cwd);
-            result.branches = { total: parseInt(branchCount || '0', 10), current: currentBranch };
-            return { success: true, ...result };
-        },
-    },
-];
-//# sourceMappingURL=github-tools.js.map

package/packages/@monomind/cli/dist/src/mcp-tools/graphify-tools.d.ts

@@ -1,73 +0,0 @@
-/**
- * Graphify MCP Tools
- *
- * Bridges @monoes/graph's knowledge graph into monomind's MCP tool surface.
- * Agents can query the codebase knowledge graph without reading files —
- * god_nodes(), query_graph(), shortest_path() give structural understanding
- * in milliseconds vs. reading dozens of source files.
- *
- * Graph is built automatically on `monomind init` and stored at
- * .monomind/graph/graph.json (legacy: graphify-out/graph.json).
- * Rebuild manually: call graphify_build via MCP.
- */
-import { type MCPTool } from './types.js';
-/**
- * Build or rebuild the knowledge graph for a directory.
- */
-export declare const graphifyBuildTool: MCPTool;
-/**
- * Query the knowledge graph with natural language.
- */
-export declare const graphifyQueryTool: MCPTool;
-/**
- * Get the most connected (god) nodes — the core abstractions.
- */
-export declare const graphifyGodNodesTool: MCPTool;
-/**
- * Get full details for a specific node.
- */
-export declare const graphifyGetNodeTool: MCPTool;
-/**
- * Find shortest path between two concepts.
- */
-export declare const graphifyShortestPathTool: MCPTool;
-/**
- * Get all nodes in a community (cluster of related components).
- */
-export declare const graphifyGetCommunityTool: MCPTool;
-/**
- * Get graph statistics: node/edge counts, communities, confidence breakdown.
- */
-export declare const graphifyStatsTool: MCPTool;
-/**
- * Find surprising cross-community connections (architectural insights).
- */
-export declare const graphifySurprisesTool: MCPTool;
-/**
- * Generate or open the interactive HTML visualization of the knowledge graph.
- */
-export declare const graphifyVisualizeTool: MCPTool;
-/**
- * Start a background file watcher that rebuilds the knowledge graph + HTML
- * whenever source files change (debounced 2 s).
- */
-export declare const graphifyWatchTool: MCPTool;
-/**
- * Stop the background graph watcher started by graphify_watch.
- */
-export declare const graphifyWatchStopTool: MCPTool;
-/**
- * Read the GRAPH_REPORT.md generated during the last build.
- */
-export declare const graphifyReportTool: MCPTool;
-/**
- * Suggest questions the knowledge graph can answer about the codebase.
- */
-export declare const graphifySuggestTool: MCPTool;
-/**
- * Run a corpus health check on the project files.
- */
-export declare const graphifyHealthTool: MCPTool;
-export declare const graphifyTools: MCPTool[];
-export default graphifyTools;
-//# sourceMappingURL=graphify-tools.d.ts.map