devsmind-mcp 2.1.1 → 2.2.2

package/dist/cli/integrations/prompt.js

@@ -0,0 +1,360 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RULE_END = exports.RULE_START = exports.CancelledError = void 0;
+exports.selectPrompt = selectPrompt;
+exports.confirmPrompt = confirmPrompt;
+exports.pickTarget = pickTarget;
+exports.pickTransport = pickTransport;
+exports.pickMcpScope = pickMcpScope;
+exports.pickRuleScope = pickRuleScope;
+exports.pickMemoryScope = pickMemoryScope;
+exports.pickMode = pickMode;
+exports.pickDirectory = pickDirectory;
+exports.mergeMcpConfig = mergeMcpConfig;
+exports.writeConfigFile = writeConfigFile;
+exports.mergeRuleFile = mergeRuleFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const prompts_1 = __importDefault(require("prompts"));
+const registry_1 = require("./registry");
+/** Thrown when the user cancels a prompt (Esc / Ctrl-C). Callers treat it as a clean abort. */
+class CancelledError extends Error {
+    constructor() {
+        super('cancelled');
+        this.name = 'CancelledError';
+    }
+}
+exports.CancelledError = CancelledError;
+function assertAnswer(value) {
+    if (value === undefined)
+        throw new CancelledError();
+    return value;
+}
+// ─── Basic prompt wrappers (abort on cancel) ─────────────────────────────────
+async function selectPrompt(message, choices, initial = 0) {
+    const res = await (0, prompts_1.default)({ type: 'select', name: 'v', message, choices, initial });
+    return assertAnswer(res.v);
+}
+async function confirmPrompt(message, initial = true) {
+    const res = await (0, prompts_1.default)({ type: 'confirm', name: 'v', message, initial });
+    return assertAnswer(res.v);
+}
+// ─── Target / transport / scope / mode pickers ───────────────────────────────
+async function pickTarget() {
+    const ides = registry_1.TARGETS.filter(t => t.kind === 'ide');
+    const clis = registry_1.TARGETS.filter(t => t.kind === 'cli');
+    const choices = [];
+    if (ides.length) {
+        choices.push({ title: '── IDEs ──', value: null });
+        for (const t of ides)
+            choices.push({ title: `  ${t.label}`, value: t });
+    }
+    if (clis.length) {
+        choices.push({ title: '── CLI tools ──', value: null });
+        for (const t of clis)
+            choices.push({ title: `  ${t.label}`, value: t });
+    }
+    // Skip the non-selectable header rows if one is chosen.
+    const picked = await selectPrompt('What are you working in?', choices, 1);
+    if (!picked) {
+        // Header row selected — re-ask.
+        return pickTarget();
+    }
+    return picked;
+}
+async function pickTransport(target) {
+    const transports = target.mcp.transports;
+    if (transports.length === 1)
+        return transports[0];
+    const describe = {
+        stdio: 'stdio — the tool launches DevsMind itself. Run `devsmind sync` after pulling graph changes.',
+        http: 'HTTP — connect to a server you start with `devsmind start`.',
+    };
+    return selectPrompt('Which connection type?', transports.map(t => ({ title: t.toUpperCase(), value: t, description: describe[t] })), 0);
+}
+async function pickMcpScope(target) {
+    const scopes = target.mcp.scopes;
+    if (scopes.length === 1)
+        return scopes[0];
+    return pickScopeGeneric(scopes, s => s.scope);
+}
+async function pickRuleScope(target) {
+    const scopes = target.rules.scopes;
+    if (scopes.length === 1)
+        return scopes[0];
+    return pickScopeGeneric(scopes, s => s.scope);
+}
+/** Assumes `target.memory.supported` and `scopes` are already checked by the caller. */
+async function pickMemoryScope(target) {
+    const scopes = target.memory.scopes ?? [];
+    if (scopes.length === 1)
+        return scopes[0];
+    return pickScopeGeneric(scopes, s => s.scope);
+}
+async function pickScopeGeneric(scopes, scopeOf) {
+    const label = {
+        project: 'This project only',
+        global: 'Global (all your projects)',
+    };
+    return selectPrompt('Which scope?', scopes.map(s => ({ title: label[scopeOf(s)], value: s })), 0);
+}
+async function pickMode() {
+    return selectPrompt('How do you want to do this?', [
+        { title: '🤖 Let the terminal set it up for me', value: 'auto', description: 'Creates/merges the config file for you (with a preview + confirmation).' },
+        { title: '📋 Just show me what to add (manual)', value: 'manual', description: 'Prints the exact file path and snippet to copy-paste.' },
+    ]);
+}
+// ─── Directory navigator ("cd around, use this folder") ──────────────────────
+/**
+ * Interactive directory browser. Lets the user cd up/down from `startDir`,
+ * type/paste a path (handy for other drives or far-away folders), and confirm a
+ * folder. Returns the chosen absolute directory. Only existing directories can
+ * be confirmed. Throws {@link CancelledError} if the user aborts.
+ */
+async function pickDirectory(startDir, purpose, opts = {}) {
+    const allowTyped = opts.allowTyped !== false;
+    let currentDir = path.resolve(startDir);
+    if (!existsDir(currentDir))
+        currentDir = process.cwd();
+    // Defensive cap: a human never navigates thousands of steps; this only trips
+    // if the prompt stream is misbehaving (e.g. non-interactive), and prevents a hang.
+    let guard = 0;
+    while (guard++ < 5000) {
+        console.log(`\n📂 ${purpose}`);
+        console.log(`   Current: ${currentDir.replace(/\\/g, '/')}`);
+        const choices = [];
+        choices.push({ title: `✅ Use this folder`, value: { action: 'use' } });
+        const parent = path.dirname(currentDir);
+        if (parent !== currentDir) {
+            choices.push({ title: '⬆  Go up (..)', value: { action: 'up' } });
+        }
+        if (allowTyped) {
+            choices.push({ title: '⌨️  Type / paste a path…', value: { action: 'type' } });
+        }
+        let subdirs = [];
+        try {
+            subdirs = fs.readdirSync(currentDir, { withFileTypes: true })
+                .filter(d => d.isDirectory() && (opts.showHidden || !d.name.startsWith('.') || d.name === '.devmind'))
+                .map(d => d.name)
+                .sort();
+        }
+        catch {
+            subdirs = [];
+        }
+        for (const name of subdirs) {
+            choices.push({ title: `📁 ${name}/`, value: { action: 'into', dir: name } });
+        }
+        const res = await selectPrompt('Navigate or select:', choices, 0);
+        if (res.action === 'use')
+            return currentDir;
+        if (res.action === 'up')
+            currentDir = parent;
+        if (res.action === 'into' && res.dir)
+            currentDir = path.join(currentDir, res.dir);
+        if (res.action === 'type') {
+            const typed = await (0, prompts_1.default)({ type: 'text', name: 'v', message: 'Enter a folder path:', initial: currentDir });
+            const v = typed.v;
+            if (typeof v === 'string' && v.trim()) {
+                const resolved = path.resolve(v.trim().replace(/^~(?=[\\/]|$)/, os.homedir()));
+                if (existsDir(resolved)) {
+                    currentDir = resolved;
+                }
+                else {
+                    console.log(`   ⚠️  Not an existing folder: ${resolved.replace(/\\/g, '/')}`);
+                }
+            }
+        }
+    }
+    throw new CancelledError();
+}
+function existsDir(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Merge a single named server entry into an MCP config file, without clobbering
+ * any existing servers. Supports JSON (nested serverMapPath) and TOML (Codex).
+ */
+function mergeMcpConfig(filePath, format, serverMapPath, serverName, entry) {
+    const existed = fs.existsSync(filePath);
+    if (format === 'toml') {
+        return mergeTomlServer(filePath, serverMapPath, serverName, entry, existed);
+    }
+    // JSON (and JSONC-tolerant tools — we emit clean JSON).
+    let root = {};
+    if (existed) {
+        try {
+            const txt = fs.readFileSync(filePath, 'utf-8').trim();
+            root = txt ? JSON.parse(txt) : {};
+        }
+        catch {
+            throw new Error(`${filePath} exists but is not valid JSON. Fix or remove it, then re-run (or use manual mode).`);
+        }
+    }
+    // Walk/create the nested server-map container.
+    let container = root;
+    for (const key of serverMapPath) {
+        if (typeof container[key] !== 'object' || container[key] === null || Array.isArray(container[key])) {
+            container[key] = {};
+        }
+        container = container[key];
+    }
+    container[serverName] = entry;
+    const content = JSON.stringify(root, null, 2) + '\n';
+    return { content, existed, preview: content };
+}
+// ─── Minimal TOML section writer (for Codex ~/.codex/config.toml) ─────────────
+function tomlValue(v) {
+    if (typeof v === 'string')
+        return JSON.stringify(v); // TOML basic strings match JSON string escaping
+    if (typeof v === 'number' || typeof v === 'boolean')
+        return String(v);
+    if (Array.isArray(v))
+        return '[' + v.map(tomlValue).join(', ') + ']';
+    // Nested tables are not expected in our entries; fall back to JSON-ish inline.
+    return JSON.stringify(v);
+}
+/**
+ * Render a `[header]` table for the given entry. Only flat key/value pairs and
+ * arrays of primitives are expected (command/args/url/headers-as-inline).
+ */
+function renderTomlTable(header, entry) {
+    const lines = [`[${header}]`];
+    for (const [k, v] of Object.entries(entry)) {
+        if (v && typeof v === 'object' && !Array.isArray(v)) {
+            // Inline table for objects like env/headers.
+            const inner = Object.entries(v)
+                .map(([ik, iv]) => `${ik} = ${tomlValue(iv)}`)
+                .join(', ');
+            lines.push(`${k} = { ${inner} }`);
+        }
+        else {
+            lines.push(`${k} = ${tomlValue(v)}`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+function mergeTomlServer(filePath, serverMapPath, serverName, entry, existed) {
+    // Header e.g. "mcp_servers.devsmind"
+    const header = [...serverMapPath, serverName].join('.');
+    const table = renderTomlTable(header, entry);
+    let existing = '';
+    if (existed) {
+        try {
+            existing = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            existing = '';
+        }
+    }
+    let content;
+    const headerLine = `[${header}]`;
+    if (existing.includes(headerLine)) {
+        // Replace the existing table (from its header to the next table header or EOF).
+        const lines = existing.split(/\r?\n/);
+        const start = lines.findIndex(l => l.trim() === headerLine);
+        let end = lines.length;
+        for (let i = start + 1; i < lines.length; i++) {
+            if (/^\s*\[/.test(lines[i])) {
+                end = i;
+                break;
+            }
+        }
+        const before = lines.slice(0, start).join('\n').replace(/\s*$/, '');
+        const after = lines.slice(end).join('\n').replace(/^\s*/, '');
+        content = [before, table.trimEnd(), after].filter(s => s.length).join('\n\n') + '\n';
+    }
+    else {
+        const base = existing.trimEnd();
+        content = (base ? base + '\n\n' : '') + table;
+    }
+    return { content, existed, preview: table };
+}
+/** Write merged content, creating parent dirs as needed. */
+function writeConfigFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+// ─── Rule file merging ───────────────────────────────────────────────────────
+exports.RULE_START = '<!-- devsmind:rule:start -->';
+exports.RULE_END = '<!-- devsmind:rule:end -->';
+/**
+ * Produce the new contents of a rules file.
+ * - `standalone`: the file is dedicated to DevsMind — write the (optionally
+ *   wrapped) rule body outright.
+ * - `append-section`: merge a delimited DevsMind block into a shared file,
+ *   replacing any prior block so re-runs update in place instead of duplicating.
+ */
+function mergeRuleFile(filePath, ruleBody, style, wrap) {
+    const existed = fs.existsSync(filePath);
+    if (style === 'standalone') {
+        const body = wrap ? wrap(ruleBody) : ruleBody;
+        const content = body.replace(/\n*$/, '\n');
+        return { content, existed, preview: content };
+    }
+    const block = `${exports.RULE_START}\n${ruleBody}\n${exports.RULE_END}`;
+    const existing = existed ? safeRead(filePath) : '';
+    const startIdx = existing.indexOf(exports.RULE_START);
+    const endIdx = existing.indexOf(exports.RULE_END);
+    let content;
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        content = existing.slice(0, startIdx) + block + existing.slice(endIdx + exports.RULE_END.length);
+    }
+    else {
+        const base = existing.replace(/\n*$/, '');
+        content = (base ? base + '\n\n' : '') + block;
+    }
+    if (!content.endsWith('\n'))
+        content += '\n';
+    return { content, existed, preview: block };
+}
+function safeRead(filePath) {
+    try {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/integrations/prompt.js.map

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

package/dist/cli/integrations/registry.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Registry of AI coding tools DevsMind can integrate with. This single table
+ * drives both `devsmind mcp` (add the MCP server) and `devsmind rule` (write the
+ * workspace rule). To fix or add a tool, edit an entry here — nothing else.
+ */
+export type Transport = 'stdio' | 'http';
+export type ConfigFormat = 'json' | 'toml';
+export type Scope = 'project' | 'global';
+/** A path that may differ per-OS. Strings may contain a leading `~` for the home dir. */
+export type OsPath = string | {
+    win32: string;
+    darwin: string;
+    linux: string;
+};
+export interface McpScope {
+    scope: Scope;
+    /** Project paths are relative to the workspace root; global paths are absolute (may start with `~`). */
+    file: OsPath;
+    format: ConfigFormat;
+    /** Key-path to the server map, e.g. ['mcpServers'] or ['servers'] or ['mcp_servers']. */
+    serverMapPath: string[];
+}
+export interface RuleScope {
+    scope: Scope;
+    file: OsPath;
+}
+/**
+ * Where to seed a tool's own persistent agent-memory/skills store — distinct
+ * from `rules`, which is a static file a human maintains. Only populated for
+ * tools where research confirmed the tool actually reads back a file it didn't
+ * create itself (see `memory.supported` below); everything else gets manual
+ * guidance instead of a write that might silently do nothing or get clobbered.
+ */
+export interface MemoryScope {
+    scope: Scope;
+    /** Directory to seed. For tools whose exact path includes an undocumented
+     *  per-project hash (Claude Code), this is the nearest KNOWN parent — the
+     *  user confirms the rest via the folder navigator. */
+    dir: OsPath;
+    /** Filename DevsMind owns within that directory — never the tool's own index/log file. */
+    file: string;
+    format: 'markdown' | 'skill-md';
+    /** True when `dir` is only a starting point and the user must navigate to the real folder. */
+    needsUserConfirmedDir?: boolean;
+}
+export interface IdeTarget {
+    id: string;
+    label: string;
+    kind: 'ide' | 'cli';
+    mcp: {
+        scopes: McpScope[];
+        /** Supported transports; first is the preferred default. */
+        transports: Transport[];
+        /** The value object placed under serverMap['devsmind'] for a given transport. */
+        entry: (t: Transport, ctx: EntryContext) => Record<string, unknown>;
+        /** Optional CLI one-liner installer (e.g. `claude mcp add ...`). */
+        cliInstaller?: (t: Transport, ctx: EntryContext) => string;
+        /** Extra guidance printed in manual mode. */
+        note?: string;
+    };
+    rules: {
+        scopes: RuleScope[];
+        /** `standalone` = dedicated devsmind file; `append-section` = merge a delimited block into a shared file. */
+        style: 'standalone' | 'append-section';
+        /** Optional transform of the rule body before writing (e.g. Cursor .mdc frontmatter). */
+        wrap?: (body: string) => string;
+    };
+    memory: {
+        /** False when no safe write path exists — manual guidance only, no file is ever touched. */
+        supported: boolean;
+        /** The tool's own name for this feature — use it verbatim in prompts, not a generic "memory". */
+        featureName: string;
+        scopes?: MemoryScope[];
+        wrap?: (body: string) => string;
+        /** Shown (instead of writing) when supported is false, or as extra context alongside a write. */
+        note: string;
+        /** Claude Code only: also offer to append a one-line pointer into MEMORY.md so an
+         *  unreferenced topic file (loaded only "on demand") is actually discoverable. */
+        pointerFile?: {
+            file: string;
+            style: 'append-section';
+        };
+    };
+}
+/** Context available when rendering a server entry. */
+export interface EntryContext {
+    devmindDir: string;
+    port: number;
+}
+/** Standard stdio entry: the IDE spawns `devsmind start --stdio`. */
+export declare function stdioEntry(): Record<string, unknown>;
+/** Standard HTTP entry: connect to the already-running server. */
+export declare function httpEntry(ctx: EntryContext): Record<string, unknown>;
+/** Resolve an {@link OsPath} to a concrete string for the current platform, expanding a leading `~`. */
+export declare function resolveOsPath(p: OsPath): string;
+/**
+ * Resolve the absolute file path for a config/rule scope.
+ * Project scopes are joined onto `workspaceRoot`; global scopes are absolute.
+ */
+export declare function resolveScopeFile(file: OsPath, scope: Scope, workspaceRoot: string): string;
+export declare const TARGETS: IdeTarget[];
+export declare function getTarget(id: string): IdeTarget | undefined;