@hamak/smart-data-dico 1.1.1 → 1.6.0

package/bin/cli.js

@@ -2,7 +2,7 @@
 
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'node:path';
-import { existsSync, mkdirSync, cpSync } from 'fs';
+import { existsSync, mkdirSync, cpSync, writeFileSync } from 'fs';
 import { spawn } from 'child_process';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -44,19 +44,30 @@ if (flags.help) {
 const port = flags.port || process.env.PORT || '3001';
 const dataDir = resolve(flags.dataDir || process.env.DATA_DIR || './data-dictionaries');
 
-// Ensure data directory exists
+// Bootstrap the project on first run. The layout matches the current
+// conventions:
+//   - `dico.config.json`       — project marker (#104)
+//   - `.dico/stereotypes.yaml` — project-level stereotypes (#104)
+// Packages and perspectives are created on demand — no empty subfolders.
 if (!existsSync(dataDir)) {
   mkdirSync(dataDir, { recursive: true });
   console.log(`Created data directory: ${dataDir}`);
 
-  const defaultStereotypes = join(PKG_ROOT, 'data-dictionaries', 'stereotypes.yaml');
-  if (existsSync(defaultStereotypes)) {
-    cpSync(defaultStereotypes, join(dataDir, 'stereotypes.yaml'));
-    console.log('Copied default stereotypes');
+  const dicoDir = join(dataDir, '.dico');
+  mkdirSync(dicoDir, { recursive: true });
+
+  const configPath = join(dataDir, 'dico.config.json');
+  if (!existsSync(configPath)) {
+    writeFileSync(configPath, JSON.stringify({ version: 1 }, null, 2) + '\n', 'utf-8');
   }
 
-  mkdirSync(join(dataDir, 'microservices'), { recursive: true });
-  mkdirSync(join(dataDir, 'perspectives'), { recursive: true });
+  // Default stereotypes are shipped under the bundled sample.
+  const defaultStereotypes = join(PKG_ROOT, 'samples', 'eshop', '.dico', 'stereotypes.yaml');
+  const targetStereotypes = join(dicoDir, 'stereotypes.yaml');
+  if (existsSync(defaultStereotypes) && !existsSync(targetStereotypes)) {
+    cpSync(defaultStereotypes, targetStereotypes);
+    console.log('Copied default stereotypes to .dico/stereotypes.yaml');
+  }
 }
 
 // Determine how to run the server:

package/bin/dico-mcp.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * Smart Data Dictionary MCP launcher (#62).
+ *
+ * Boots the MCP server defined under `backend/src/mcp/server.ts` over stdio.
+ * Mirrors `bin/cli.js`:
+ *   - Resolves `--data-dir <path>` (falling back to env `DATA_DIR`).
+ *   - Prefers the bundled JS build if present; falls back to `tsx` over the
+ *     TypeScript source when running from a checkout.
+ *
+ * Critically: this script must NOT write to stdout. The MCP stdio transport
+ * uses stdout for JSON-RPC framing — any extra bytes will corrupt the stream.
+ * All chatter goes to stderr.
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join, resolve } from 'node:path';
+import { existsSync } from 'fs';
+import { spawn } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PKG_ROOT = join(__dirname, '..');
+
+const args = process.argv.slice(2);
+const flags = {};
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--data-dir' && args[i + 1]) {
+    flags.dataDir = args[++i];
+  } else if (args[i] === '--help' || args[i] === '-h') {
+    flags.help = true;
+  }
+}
+
+if (flags.help) {
+  process.stderr.write(`
+  dico-mcp - Smart Data Dictionary MCP server (stdio)
+
+  Usage:
+    dico-mcp [options]
+
+  Options:
+    --data-dir <path>   Project directory (overrides DATA_DIR env)
+    -h, --help          Show this help
+
+  Register with Claude Desktop / Cursor / Roo Code:
+    See backend/src/mcp/README.md for the JSON config snippets.
+
+`);
+  process.exit(0);
+}
+
+const dataDir = resolve(flags.dataDir || process.env.DATA_DIR || './data-dictionaries');
+
+const bundledServer = join(PKG_ROOT, 'backend', 'dist', 'mcp', 'cli.js');
+const sourceServer = join(PKG_ROOT, 'backend', 'src', 'mcp', 'cli.ts');
+
+let bin, binArgs;
+
+if (existsSync(bundledServer)) {
+  bin = process.execPath; // node
+  binArgs = [bundledServer];
+} else if (existsSync(sourceServer)) {
+  const tsxPaths = [
+    join(PKG_ROOT, 'node_modules', '.bin', 'tsx'),
+    join(PKG_ROOT, 'backend', 'node_modules', '.bin', 'tsx'),
+  ];
+  bin = tsxPaths.find(p => existsSync(p));
+  if (!bin) {
+    process.stderr.write('Error: tsx not found. Run `cd backend && npm install` first.\n');
+    process.exit(1);
+  }
+  binArgs = [sourceServer];
+} else {
+  process.stderr.write('Error: MCP server not found (neither bundled nor source).\n');
+  process.exit(1);
+}
+
+// Spawn the server, wiring its stdio straight through to ours so the parent
+// MCP client (Claude Desktop, Cursor, ...) talks to it directly.
+const child = spawn(bin, binArgs, {
+  cwd: PKG_ROOT,
+  env: {
+    ...process.env,
+    DATA_DIR: dataDir,
+  },
+  stdio: 'inherit',
+});
+
+child.on('error', (err) => {
+  process.stderr.write(`Failed to start MCP server: ${err.message}\n`);
+  process.exit(1);
+});
+
+child.on('exit', (code) => process.exit(code || 0));
+
+process.on('SIGINT', () => child.kill('SIGINT'));
+process.on('SIGTERM', () => child.kill('SIGTERM'));