@ainote/mcp 1.3.1 → 1.3.3

package/lib/tools/index.js

@@ -1,5 +1,5 @@
-export { getSharedTools } from './shared-tools.js';
-export { getChatGptTools } from './chatgpt-tools.js';
-export { getDevDocTools } from './dev-doc-tools.js';
-export { getOnboardingTools } from './onboarding-tools.js';
-export { toSuccessContent, toErrorContent } from './internal/formatters.js';
+export { getSharedTools } from './shared-tools.js';
+export { getChatGptTools } from './chatgpt-tools.js';
+export { getDevDocTools } from './dev-doc-tools.js';
+export { getOnboardingTools } from './onboarding-tools.js';
+export { toSuccessContent, toErrorContent } from './internal/formatters.js';

package/lib/tools/internal/claude-scanner.js

@@ -1,150 +1,150 @@
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import { canonicalizePath } from './path-mapper.js';
-
-const HOME = os.homedir();
-const CLAUDE_DIR = path.join(HOME, '.claude');
-
-const TEXT_EXTENSIONS = new Set([
-  '.md', '.txt', '.json', '.yaml', '.yml', '.toml',
-  '.js', '.ts', '.sh', '.py', '.rb', '.css', '.html'
-]);
-
-function isTextFile(p) {
-  return TEXT_EXTENSIONS.has(path.extname(p).toLowerCase());
-}
-
-function walkDir(root, maxFiles = 500) {
-  const out = [];
-  if (!fs.existsSync(root)) return out;
-
-  function visit(dir) {
-    if (out.length >= maxFiles) return;
-    let entries;
-    try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    for (const e of entries) {
-      if (e.name.startsWith('.')) continue;
-      const full = path.join(dir, e.name);
-      if (e.isDirectory()) {
-        visit(full);
-      } else if (e.isFile() && isTextFile(e.name)) {
-        out.push(full);
-      }
-      if (out.length >= maxFiles) return;
-    }
-  }
-  visit(root);
-  return out;
-}
-
-function detectContentType(p) {
-  const ext = path.extname(p).toLowerCase();
-  if (ext === '.json') return 'json';
-  if (ext === '.yaml' || ext === '.yml') return 'yaml';
-  if (ext === '.md') return 'markdown';
-  return 'text';
-}
-
-/**
- * Scan a Claude subdirectory (skills/agents/commands/hooks) and return file
- * descriptors ready for create_dev_doc calls.
- *
- * Returns: [{ title, content, content_type, local_path, relative_path }]
- *   - title:        unique per-file (e.g., "skills/ui-ux-pro-max/SKILL.md")
- *   - local_path:   canonicalized (~/...) so pull works cross-platform
- *   - relative_path: path relative to ~/.claude/<subdir>/
- */
-export function scanClaudeSubdir(subdir, { maxFiles = 500 } = {}) {
-  const root = path.join(CLAUDE_DIR, subdir);
-  const files = walkDir(root, maxFiles);
-  const results = [];
-  for (const abs of files) {
-    let content;
-    try {
-      content = fs.readFileSync(abs, 'utf8');
-    } catch {
-      continue;
-    }
-    const relativeFromClaude = path.relative(CLAUDE_DIR, abs);
-    const relativeFromSubdir = path.relative(root, abs);
-    results.push({
-      title: relativeFromClaude.replace(/\\/g, '/'),
-      content,
-      content_type: detectContentType(abs),
-      local_path: canonicalizePath(abs),
-      relative_path: relativeFromSubdir.replace(/\\/g, '/'),
-      size: content.length
-    });
-  }
-  return results;
-}
-
-/**
- * Read mcpServers section from ~/.claude.json.
- * Returns the object (possibly empty) and the canonicalized source path.
- */
-export function readMcpServers() {
-  const claudeJson = path.join(HOME, '.claude.json');
-  if (!fs.existsSync(claudeJson)) {
-    return { servers: {}, source: canonicalizePath(claudeJson), exists: false };
-  }
-  try {
-    const raw = fs.readFileSync(claudeJson, 'utf8');
-    const json = JSON.parse(raw);
-    return {
-      servers: json.mcpServers || {},
-      source: canonicalizePath(claudeJson),
-      exists: true
-    };
-  } catch (e) {
-    throw new Error(`Failed to parse ~/.claude.json: ${e.message}`);
-  }
-}
-
-/**
- * Sidecar pattern: write mcpServers snapshot to ~/.claude/mcp-servers.d/<name>.json
- * Never touches ~/.claude.json directly (avoids live-write corruption).
- */
-export function writeMcpServersSidecar(servers, { name = 'from-ainote' } = {}) {
-  const sidecarDir = path.join(CLAUDE_DIR, 'mcp-servers.d');
-  fs.mkdirSync(sidecarDir, { recursive: true });
-  const target = path.join(sidecarDir, `${name}.json`);
-  const tmp = `${target}.tmp.${process.pid}`;
-  fs.writeFileSync(tmp, JSON.stringify({ mcpServers: servers }, null, 2));
-  fs.renameSync(tmp, target);
-  return canonicalizePath(target);
-}
-
-/**
- * Preview what would be synced. Read-only, fast.
- */
-export function discoverSyncTargets() {
-  const result = {
-    claude_dir: canonicalizePath(CLAUDE_DIR),
-    targets: {}
-  };
-  for (const sub of ['skills', 'agents', 'commands', 'hooks']) {
-    const files = scanClaudeSubdir(sub);
-    result.targets[sub] = {
-      file_count: files.length,
-      total_bytes: files.reduce((a, b) => a + b.size, 0),
-      samples: files.slice(0, 3).map(f => f.title)
-    };
-  }
-  try {
-    const mcp = readMcpServers();
-    result.targets.mcp_servers = {
-      file_count: Object.keys(mcp.servers).length,
-      total_bytes: JSON.stringify(mcp.servers).length,
-      samples: Object.keys(mcp.servers).slice(0, 5)
-    };
-  } catch (e) {
-    result.targets.mcp_servers = { error: e.message };
-  }
-  return result;
-}
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { canonicalizePath } from './path-mapper.js';
+
+const HOME = os.homedir();
+const CLAUDE_DIR = path.join(HOME, '.claude');
+
+const TEXT_EXTENSIONS = new Set([
+  '.md', '.txt', '.json', '.yaml', '.yml', '.toml',
+  '.js', '.ts', '.sh', '.py', '.rb', '.css', '.html'
+]);
+
+function isTextFile(p) {
+  return TEXT_EXTENSIONS.has(path.extname(p).toLowerCase());
+}
+
+function walkDir(root, maxFiles = 500) {
+  const out = [];
+  if (!fs.existsSync(root)) return out;
+
+  function visit(dir) {
+    if (out.length >= maxFiles) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      if (e.name.startsWith('.')) continue;
+      const full = path.join(dir, e.name);
+      if (e.isDirectory()) {
+        visit(full);
+      } else if (e.isFile() && isTextFile(e.name)) {
+        out.push(full);
+      }
+      if (out.length >= maxFiles) return;
+    }
+  }
+  visit(root);
+  return out;
+}
+
+function detectContentType(p) {
+  const ext = path.extname(p).toLowerCase();
+  if (ext === '.json') return 'json';
+  if (ext === '.yaml' || ext === '.yml') return 'yaml';
+  if (ext === '.md') return 'markdown';
+  return 'text';
+}
+
+/**
+ * Scan a Claude subdirectory (skills/agents/commands/hooks) and return file
+ * descriptors ready for create_dev_doc calls.
+ *
+ * Returns: [{ title, content, content_type, local_path, relative_path }]
+ *   - title:        unique per-file (e.g., "skills/ui-ux-pro-max/SKILL.md")
+ *   - local_path:   canonicalized (~/...) so pull works cross-platform
+ *   - relative_path: path relative to ~/.claude/<subdir>/
+ */
+export function scanClaudeSubdir(subdir, { maxFiles = 500 } = {}) {
+  const root = path.join(CLAUDE_DIR, subdir);
+  const files = walkDir(root, maxFiles);
+  const results = [];
+  for (const abs of files) {
+    let content;
+    try {
+      content = fs.readFileSync(abs, 'utf8');
+    } catch {
+      continue;
+    }
+    const relativeFromClaude = path.relative(CLAUDE_DIR, abs);
+    const relativeFromSubdir = path.relative(root, abs);
+    results.push({
+      title: relativeFromClaude.replace(/\\/g, '/'),
+      content,
+      content_type: detectContentType(abs),
+      local_path: canonicalizePath(abs),
+      relative_path: relativeFromSubdir.replace(/\\/g, '/'),
+      size: content.length
+    });
+  }
+  return results;
+}
+
+/**
+ * Read mcpServers section from ~/.claude.json.
+ * Returns the object (possibly empty) and the canonicalized source path.
+ */
+export function readMcpServers() {
+  const claudeJson = path.join(HOME, '.claude.json');
+  if (!fs.existsSync(claudeJson)) {
+    return { servers: {}, source: canonicalizePath(claudeJson), exists: false };
+  }
+  try {
+    const raw = fs.readFileSync(claudeJson, 'utf8');
+    const json = JSON.parse(raw);
+    return {
+      servers: json.mcpServers || {},
+      source: canonicalizePath(claudeJson),
+      exists: true
+    };
+  } catch (e) {
+    throw new Error(`Failed to parse ~/.claude.json: ${e.message}`);
+  }
+}
+
+/**
+ * Sidecar pattern: write mcpServers snapshot to ~/.claude/mcp-servers.d/<name>.json
+ * Never touches ~/.claude.json directly (avoids live-write corruption).
+ */
+export function writeMcpServersSidecar(servers, { name = 'from-ainote' } = {}) {
+  const sidecarDir = path.join(CLAUDE_DIR, 'mcp-servers.d');
+  fs.mkdirSync(sidecarDir, { recursive: true });
+  const target = path.join(sidecarDir, `${name}.json`);
+  const tmp = `${target}.tmp.${process.pid}`;
+  fs.writeFileSync(tmp, JSON.stringify({ mcpServers: servers }, null, 2));
+  fs.renameSync(tmp, target);
+  return canonicalizePath(target);
+}
+
+/**
+ * Preview what would be synced. Read-only, fast.
+ */
+export function discoverSyncTargets() {
+  const result = {
+    claude_dir: canonicalizePath(CLAUDE_DIR),
+    targets: {}
+  };
+  for (const sub of ['skills', 'agents', 'commands', 'hooks']) {
+    const files = scanClaudeSubdir(sub);
+    result.targets[sub] = {
+      file_count: files.length,
+      total_bytes: files.reduce((a, b) => a + b.size, 0),
+      samples: files.slice(0, 3).map(f => f.title)
+    };
+  }
+  try {
+    const mcp = readMcpServers();
+    result.targets.mcp_servers = {
+      file_count: Object.keys(mcp.servers).length,
+      total_bytes: JSON.stringify(mcp.servers).length,
+      samples: Object.keys(mcp.servers).slice(0, 5)
+    };
+  } catch (e) {
+    result.targets.mcp_servers = { error: e.message };
+  }
+  return result;
+}

package/lib/tools/internal/encryption.js

@@ -1,88 +1,88 @@
-import { spawnSync } from 'child_process';
-import fs from 'fs';
-import os from 'os';
-import path from 'path';
-import { getAgeIdentity, getAgeRecipients } from './keychain.js';
-
-const TMPDIR = os.tmpdir();
-
-function ageBinary() {
-  const r = spawnSync('age', ['--version'], { encoding: 'utf8' });
-  if (r.status !== 0) {
-    throw new Error('age binary not found. Install: brew install age');
-  }
-  return 'age';
-}
-
-function withTmpFile(prefix, body, fn) {
-  const tmp = path.join(TMPDIR, `${prefix}.${process.pid}.${Date.now()}`);
-  fs.writeFileSync(tmp, body, { mode: 0o600 });
-  try {
-    return fn(tmp);
-  } finally {
-    try { fs.unlinkSync(tmp); } catch {}
-  }
-}
-
-/**
- * Encrypt plaintext for one or more recipients (age public keys).
- * Returns base64 ciphertext.
- */
-export async function encryptText(plaintext, { recipients } = {}) {
-  const recps = recipients || await getAgeRecipients();
-  if (!recps || recps.length === 0) {
-    throw new Error('No age recipients available. Run sync_init_encryption first.');
-  }
-  ageBinary();
-  return withTmpFile('ainote-enc-in', plaintext, (inputPath) => {
-    const args = ['-a']; // armored output
-    for (const r of recps) {
-      args.push('-r', r);
-    }
-    args.push(inputPath);
-    const r = spawnSync('age', args, { encoding: 'utf8' });
-    if (r.status !== 0) {
-      throw new Error(`age encrypt failed: ${r.stderr || 'unknown'}`);
-    }
-    return r.stdout;
-  });
-}
-
-/**
- * Decrypt armored age ciphertext with this machine's identity from Keychain.
- */
-export async function decryptText(ciphertext) {
-  ageBinary();
-  const identity = await getAgeIdentity();
-  if (!identity) {
-    throw new Error('No age identity for this machine. Run sync_init_encryption first.');
-  }
-  return withTmpFile('ainote-id', identity, (idPath) =>
-    withTmpFile('ainote-ct', ciphertext, (ctPath) => {
-      const r = spawnSync('age', ['-d', '-i', idPath, ctPath], { encoding: 'utf8' });
-      if (r.status !== 0) {
-        throw new Error(`age decrypt failed: ${r.stderr || 'unknown'}`);
-      }
-      return r.stdout;
-    })
-  );
-}
-
-/**
- * Generate a new age keypair. Returns { identity, recipient }.
- * Identity is the private key (AGE-SECRET-KEY-1...), recipient is the public (age1...).
- */
-export function generateKeypair() {
-  ageBinary();
-  const r = spawnSync('age-keygen', [], { encoding: 'utf8' });
-  if (r.status !== 0) {
-    throw new Error(`age-keygen failed: ${r.stderr || 'unknown'}`);
-  }
-  const out = r.stdout;
-  const recpMatch = out.match(/# public key: (age1[a-z0-9]+)/i);
-  const idMatch = out.match(/(AGE-SECRET-KEY-1[A-Z0-9]+)/);
-  if (!recpMatch || !idMatch) {
-    throw new Error('Could not parse age-keygen output');
-  }
-  return { identity: out, recipient: recpMatch[1], identity_line: idMatch[1] };
-}
+import { spawnSync } from 'child_process';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { getAgeIdentity, getAgeRecipients } from './keychain.js';
+
+const TMPDIR = os.tmpdir();
+
+function ageBinary() {
+  const r = spawnSync('age', ['--version'], { encoding: 'utf8' });
+  if (r.status !== 0) {
+    throw new Error('age binary not found. Install: brew install age');
+  }
+  return 'age';
+}
+
+function withTmpFile(prefix, body, fn) {
+  const tmp = path.join(TMPDIR, `${prefix}.${process.pid}.${Date.now()}`);
+  fs.writeFileSync(tmp, body, { mode: 0o600 });
+  try {
+    return fn(tmp);
+  } finally {
+    try { fs.unlinkSync(tmp); } catch {}
+  }
+}
+
+/**
+ * Encrypt plaintext for one or more recipients (age public keys).
+ * Returns base64 ciphertext.
+ */
+export async function encryptText(plaintext, { recipients } = {}) {
+  const recps = recipients || await getAgeRecipients();
+  if (!recps || recps.length === 0) {
+    throw new Error('No age recipients available. Run sync_init_encryption first.');
+  }
+  ageBinary();
+  return withTmpFile('ainote-enc-in', plaintext, (inputPath) => {
+    const args = ['-a']; // armored output
+    for (const r of recps) {
+      args.push('-r', r);
+    }
+    args.push(inputPath);
+    const r = spawnSync('age', args, { encoding: 'utf8' });
+    if (r.status !== 0) {
+      throw new Error(`age encrypt failed: ${r.stderr || 'unknown'}`);
+    }
+    return r.stdout;
+  });
+}
+
+/**
+ * Decrypt armored age ciphertext with this machine's identity from Keychain.
+ */
+export async function decryptText(ciphertext) {
+  ageBinary();
+  const identity = await getAgeIdentity();
+  if (!identity) {
+    throw new Error('No age identity for this machine. Run sync_init_encryption first.');
+  }
+  return withTmpFile('ainote-id', identity, (idPath) =>
+    withTmpFile('ainote-ct', ciphertext, (ctPath) => {
+      const r = spawnSync('age', ['-d', '-i', idPath, ctPath], { encoding: 'utf8' });
+      if (r.status !== 0) {
+        throw new Error(`age decrypt failed: ${r.stderr || 'unknown'}`);
+      }
+      return r.stdout;
+    })
+  );
+}
+
+/**
+ * Generate a new age keypair. Returns { identity, recipient }.
+ * Identity is the private key (AGE-SECRET-KEY-1...), recipient is the public (age1...).
+ */
+export function generateKeypair() {
+  ageBinary();
+  const r = spawnSync('age-keygen', [], { encoding: 'utf8' });
+  if (r.status !== 0) {
+    throw new Error(`age-keygen failed: ${r.stderr || 'unknown'}`);
+  }
+  const out = r.stdout;
+  const recpMatch = out.match(/# public key: (age1[a-z0-9]+)/i);
+  const idMatch = out.match(/(AGE-SECRET-KEY-1[A-Z0-9]+)/);
+  if (!recpMatch || !idMatch) {
+    throw new Error('Could not parse age-keygen output');
+  }
+  return { identity: out, recipient: recpMatch[1], identity_line: idMatch[1] };
+}

package/lib/tools/internal/formatters.js

@@ -1,80 +1,80 @@
-export function toSuccessContent(payload, options = {}) {
-  const { pretty = true } = options;
-  const text = pretty ? JSON.stringify(payload, null, 2) : JSON.stringify(payload);
-
-  return {
-    content: [
-      {
-        type: 'text',
-        text
-      }
-    ]
-  };
-}
-
-export function toErrorContent(error) {
-  const message = error?.message ?? String(error);
-  const details = error?.response?.data;
-  const textParts = [`Error: ${message}`];
-
-  if (details) {
-    try {
-      textParts.push(JSON.stringify(details, null, 2));
-    } catch (stringifyError) {
-      textParts.push(String(details));
-    }
-  }
-
-  return {
-    content: [
-      {
-        type: 'text',
-        text: textParts.join('\n')
-      }
-    ],
-    isError: true
-  };
-}
-
-/**
- * Parse structured data from MCP response
- * Looks for JSON resource in content array and extracts structured data
- */
-export function parseStructuredData(result) {
-  if (!result?.content || !Array.isArray(result.content)) {
-    return null;
-  }
-
-  // Look for resource content with JSON data
-  for (const item of result.content) {
-    if (item.type === 'resource' && item.resource?.mimeType === 'application/json') {
-      try {
-        return JSON.parse(item.resource.text);
-      } catch (error) {
-        console.error('Failed to parse structured data:', error);
-        return null;
-      }
-    }
-  }
-
-  return null;
-}
-
-/**
- * Enhance result with structured data annotation
- * Adds structured data to the response while preserving original text
- */
-export function enhanceWithStructuredData(result) {
-  const structuredData = parseStructuredData(result);
-
-  if (structuredData) {
-    // Add metadata about structured data availability
-    return {
-      ...result,
-      _structuredData: structuredData,
-      _hasStructuredData: true
-    };
-  }
-
-  return result;
-}
+export function toSuccessContent(payload, options = {}) {
+  const { pretty = true } = options;
+  const text = pretty ? JSON.stringify(payload, null, 2) : JSON.stringify(payload);
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text
+      }
+    ]
+  };
+}
+
+export function toErrorContent(error) {
+  const message = error?.message ?? String(error);
+  const details = error?.response?.data;
+  const textParts = [`Error: ${message}`];
+
+  if (details) {
+    try {
+      textParts.push(JSON.stringify(details, null, 2));
+    } catch (stringifyError) {
+      textParts.push(String(details));
+    }
+  }
+
+  return {
+    content: [
+      {
+        type: 'text',
+        text: textParts.join('\n')
+      }
+    ],
+    isError: true
+  };
+}
+
+/**
+ * Parse structured data from MCP response
+ * Looks for JSON resource in content array and extracts structured data
+ */
+export function parseStructuredData(result) {
+  if (!result?.content || !Array.isArray(result.content)) {
+    return null;
+  }
+
+  // Look for resource content with JSON data
+  for (const item of result.content) {
+    if (item.type === 'resource' && item.resource?.mimeType === 'application/json') {
+      try {
+        return JSON.parse(item.resource.text);
+      } catch (error) {
+        console.error('Failed to parse structured data:', error);
+        return null;
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Enhance result with structured data annotation
+ * Adds structured data to the response while preserving original text
+ */
+export function enhanceWithStructuredData(result) {
+  const structuredData = parseStructuredData(result);
+
+  if (structuredData) {
+    // Add metadata about structured data availability
+    return {
+      ...result,
+      _structuredData: structuredData,
+      _hasStructuredData: true
+    };
+  }
+
+  return result;
+}