@kiyeonjeon21/datacontext 0.4.0 → 0.5.0

package/.cursorrules

@@ -86,6 +86,38 @@ REST API/MCP Tool 변경 시 아래 파일들도 확인:
 - `vscode-datacontext/README.md` — 문서
 - 자세한 내용: `docs/SYNC_GUIDE.md`
 
+## 🔴 Version Management (CRITICAL)
+
+### 버전 변경 시 반드시 업데이트할 파일들
+버전을 올릴 때 **모든 파일을 동시에** 업데이트하세요:
+
+| 파일 | 위치 | 예시 |
+|------|------|------|
+| `package.json` | `"version": "X.Y.Z"` | `"version": "0.4.1"` |
+| `CHANGELOG.md` | `## [X.Y.Z] - YYYY-MM-DD` | `## [0.4.1] - 2026-01-01` |
+
+### 버전 올리기 체크리스트
+```bash
+# 1. package.json 버전 업데이트
+# 2. CHANGELOG.md에 새 버전 엔트리 추가 (맨 위에)
+# 3. 빌드 및 테스트
+npm run build && npm test
+
+# 4. 배포
+npm publish --access public
+```
+
+### CHANGELOG 규칙
+- 버전 순서: 최신이 맨 위 (0.4.1 → 0.4.0 → 0.3.0 → ...)
+- 누락된 버전 없이 연속적으로 유지
+- 각 버전에 Added/Changed/Fixed/Removed 섹션 포함
+
+### ⚠️ 흔한 실수
+- ❌ package.json만 올리고 CHANGELOG 누락
+- ❌ CHANGELOG에 버전 순서 건너뛰기
+- ❌ 배포 후 버전 업데이트
+- ❌ VS Code Extension과 버전 싱크 누락 (별도 패키지지만 관련 변경 시 함께 배포)
+
 ## Testing
 ```bash
 npm test              # Run all tests

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-01-01
+
+### Added
+- **MongoDB Adapter**: Full support for MongoDB/NoSQL databases
+  - Schema inference from sample documents (auto-detects field types)
+  - Native MongoDB query execution (find, findOne, aggregate, count, distinct)
+  - Array and nested object type detection
+  - Collection indexing and statistics
+  - Connection string support: `mongodb://` and `mongodb+srv://`
+- New CLI command: `datacontext connect mongodb://...`
+- MongoDB support in REST API server
+- Test suite for MongoDB adapter
+
+### Changed
+- CLI now supports MongoDB connection strings
+- Updated documentation to include MongoDB examples
+
+## [0.4.1] - 2026-01-01
+
+### Added
+- **Relationships in Knowledge API**: `/api/knowledge` now includes `relationships` array
+  - All harvested FK relationships included in knowledge summary
+  - VS Code extension can now display relationships in Knowledge panel
+
+### Changed
+- `KnowledgeSummary` type now includes `relationships` and `totalRelationships` stat
+
 ## [0.3.0] - 2025-01-01
 
 ### Added

package/README.md

@@ -42,7 +42,7 @@ Every time you use AI to write SQL, you explain the same things:
 └─────────────────────────┬───────────────────────────────────────┘
                           │
 ┌─────────────────────────▼───────────────────────────────────────┐
-│  Your Database (PostgreSQL, MySQL, SQLite)                      │
+│  Your Database (PostgreSQL, MySQL, SQLite, MongoDB)             │
 └─────────────────────────────────────────────────────────────────┘
 ```
 
@@ -53,7 +53,7 @@ Every time you use AI to write SQL, you explain the same things:
 | Feature | Description |
 |---------|-------------|
 | 🔌 **MCP Protocol** | Works with Claude Desktop, Cursor IDE, and any MCP client |
-| 🗄️ **Multi-Database** | PostgreSQL, MySQL/MariaDB, SQLite |
+| 🗄️ **Multi-Database** | PostgreSQL, MySQL/MariaDB, SQLite, MongoDB |
 | 🔒 **Safety First** | Read-only by default, query validation, timeout protection |
 | 📚 **Knowledge Layer** | Store descriptions, business rules, query examples |
 | 🤖 **AI Glossary** | Auto-generate business terms from natural language (requires Anthropic API key) |
@@ -352,9 +352,28 @@ await service.shutdown();
 | PostgreSQL | ✅ Full | `postgres://` |
 | MySQL/MariaDB | ✅ Full | `mysql://` |
 | SQLite | ✅ Full | `./file.sqlite` |
+| MongoDB | ✅ Full | `mongodb://` |
 | BigQuery | 🔜 Planned | — |
 | Snowflake | 🔜 Planned | — |
 
+### MongoDB Support
+
+MongoDB is schema-less, but DataContext infers schema from sample documents:
+
+```bash
+# Connect to MongoDB
+datacontext serve mongodb://user:pass@localhost:27017/mydb
+
+# Or with authentication
+datacontext serve "mongodb://user:pass@localhost:27017/mydb?authSource=admin"
+```
+
+DataContext will:
+- List all collections
+- Infer field types from sample documents
+- Detect nested objects and arrays
+- Support native MongoDB queries (find, aggregate, etc.)
+
 ---
 
 ## License

package/dist/adapters/mongodb.d.ts

@@ -0,0 +1,207 @@
+/**
+ * MongoDB Database Adapter
+ * Implements DatabaseAdapter for MongoDB databases
+ *
+ * Key differences from SQL adapters:
+ * - MongoDB is schema-less, so we infer schema from sample documents
+ * - Collections are analogous to tables
+ * - No native SQL support - query() accepts MongoDB query JSON
+ *
+ * @example
+ * ```typescript
+ * const adapter = createMongoDBAdapter('mongodb://localhost:27017/mydb');
+ * await adapter.connect();
+ *
+ * // Get inferred schema
+ * const schema = await adapter.getSchema();
+ * console.log(schema.tables); // Collections with inferred fields
+ *
+ * // Execute MongoDB query (JSON format)
+ * const result = await adapter.query(JSON.stringify({
+ *   collection: "users",
+ *   operation: "find",
+ *   filter: { status: "active" },
+ *   limit: 10
+ * }));
+ * ```
+ */
+import { Document } from 'mongodb';
+import type { DatabaseAdapter, QueryResult, ConnectionConfig } from './base.js';
+import type { SchemaInfo, TableInfo } from '../schema/types.js';
+/**
+ * MongoDB query format for the query() method
+ */
+export interface MongoDBQuery {
+    /** Collection name to query */
+    collection: string;
+    /** Operation type */
+    operation: 'find' | 'findOne' | 'aggregate' | 'count' | 'distinct';
+    /** Query filter (for find, findOne, count) */
+    filter?: Document;
+    /** Aggregation pipeline (for aggregate) */
+    pipeline?: Document[];
+    /** Projection (fields to include/exclude) */
+    projection?: Document;
+    /** Sort specification */
+    sort?: Document;
+    /** Maximum documents to return */
+    limit?: number;
+    /** Documents to skip */
+    skip?: number;
+    /** Field name for distinct operation */
+    field?: string;
+}
+/**
+ * Configuration for schema inference
+ */
+export interface SchemaInferenceConfig {
+    /** Number of documents to sample per collection (default: 100) */
+    sampleSize: number;
+    /** Maximum depth for nested document analysis (default: 5) */
+    maxDepth: number;
+    /** Include array element type inference (default: true) */
+    inferArrayTypes: boolean;
+}
+/**
+ * MongoDB Adapter Implementation
+ */
+export declare class MongoDBAdapter implements DatabaseAdapter {
+    readonly name = "mongodb";
+    private client;
+    private db;
+    private config;
+    private databaseName;
+    private inferenceConfig;
+    constructor(config: ConnectionConfig, inferenceConfig?: Partial<SchemaInferenceConfig>);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    getDatabaseName(): string;
+    /**
+     * Execute a MongoDB query.
+     *
+     * Accepts a JSON string representing a MongoDB query operation.
+     * This is different from SQL adapters which accept SQL strings.
+     *
+     * @param queryJson - JSON string containing MongoDB query specification
+     * @returns Query result with rows, metadata, and timing
+     *
+     * @example
+     * ```typescript
+     * // Find documents
+     * const result = await adapter.query(JSON.stringify({
+     *   collection: "users",
+     *   operation: "find",
+     *   filter: { age: { $gt: 25 } },
+     *   projection: { name: 1, email: 1 },
+     *   limit: 10
+     * }));
+     *
+     * // Aggregate
+     * const result = await adapter.query(JSON.stringify({
+     *   collection: "orders",
+     *   operation: "aggregate",
+     *   pipeline: [
+     *     { $match: { status: "completed" } },
+     *     { $group: { _id: "$userId", total: { $sum: "$amount" } } }
+     *   ]
+     * }));
+     * ```
+     */
+    query(queryJson: string): Promise<QueryResult>;
+    /**
+     * List all collections in the database.
+     *
+     * @param schema - Ignored for MongoDB (uses database instead)
+     * @returns Array of collection names
+     */
+    listTables(schema?: string): Promise<string[]>;
+    /**
+     * Get detailed information about a collection.
+     *
+     * Infers schema from sample documents since MongoDB is schema-less.
+     *
+     * @param tableName - Collection name
+     * @param schema - Ignored for MongoDB
+     * @returns Inferred table info with columns representing document fields
+     */
+    getTable(tableName: string, schema?: string): Promise<TableInfo | null>;
+    /**
+     * Get complete schema information for the database.
+     *
+     * @param schema - Ignored for MongoDB
+     * @returns Schema info with all collections and their inferred structures
+     */
+    getSchema(schema?: string): Promise<SchemaInfo>;
+    /**
+     * Build connection string from individual config parameters
+     */
+    private buildConnectionString;
+    /**
+     * Infer column definitions from sample documents
+     */
+    private inferColumnsFromDocuments;
+    /**
+     * Create default field stats object
+     */
+    private createDefaultFieldStats;
+    /**
+     * Recursively collect field statistics from a document
+     */
+    private collectFieldStats;
+    /**
+     * Get MongoDB type name for a value
+     */
+    private getMongoDBType;
+    /**
+     * Get the most common type from type statistics
+     */
+    private getMostCommonType;
+    /**
+     * Generate a comment for a field based on statistics
+     */
+    private generateFieldComment;
+    /**
+     * Get indexes for a collection
+     */
+    private getIndexes;
+    /**
+     * Format bytes to human-readable string
+     */
+    private formatBytes;
+}
+/**
+ * Create a MongoDB adapter from connection string
+ *
+ * @param connectionString - MongoDB connection string (e.g., mongodb://localhost:27017/mydb)
+ * @param inferenceConfig - Optional schema inference configuration
+ * @returns MongoDB adapter instance
+ *
+ * @example
+ * ```typescript
+ * const adapter = createMongoDBAdapter('mongodb://localhost:27017/mydb');
+ * await adapter.connect();
+ * ```
+ */
+export declare function createMongoDBAdapter(connectionString: string, inferenceConfig?: Partial<SchemaInferenceConfig>): MongoDBAdapter;
+/**
+ * Create a MongoDB adapter from config object
+ *
+ * @param config - Connection configuration
+ * @param inferenceConfig - Optional schema inference configuration
+ * @returns MongoDB adapter instance
+ *
+ * @example
+ * ```typescript
+ * const adapter = createMongoDBAdapterFromConfig({
+ *   host: 'localhost',
+ *   port: 27017,
+ *   database: 'mydb',
+ *   user: 'admin',
+ *   password: 'secret'
+ * });
+ * await adapter.connect();
+ * ```
+ */
+export declare function createMongoDBAdapterFromConfig(config: ConnectionConfig, inferenceConfig?: Partial<SchemaInferenceConfig>): MongoDBAdapter;
+//# sourceMappingURL=mongodb.d.ts.map

package/dist/adapters/mongodb.d.ts.map

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