@thinkdata/cli 0.2.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +119 -0
  2. package/dist/bin/thinkdata.js +12 -0
  3. package/dist/bin/thinkdata.js.map +1 -1
  4. package/dist/cli.js +52450 -0
  5. package/dist/commands/auth.js +1 -1
  6. package/dist/commands/auth.js.map +1 -1
  7. package/dist/commands/compare.js +1 -1
  8. package/dist/commands/compare.js.map +1 -1
  9. package/dist/commands/extract.d.ts +2 -0
  10. package/dist/commands/extract.d.ts.map +1 -1
  11. package/dist/commands/extract.js +57 -4
  12. package/dist/commands/extract.js.map +1 -1
  13. package/dist/commands/mcp.d.ts +8 -0
  14. package/dist/commands/mcp.d.ts.map +1 -0
  15. package/dist/commands/mcp.js +91 -0
  16. package/dist/commands/mcp.js.map +1 -0
  17. package/dist/commands/serve.js +7 -7
  18. package/dist/commands/serve.js.map +1 -1
  19. package/dist/extractors/index.d.ts +15 -2
  20. package/dist/extractors/index.d.ts.map +1 -1
  21. package/dist/extractors/index.js +46 -10
  22. package/dist/extractors/index.js.map +1 -1
  23. package/dist/extractors/mssql.d.ts.map +1 -1
  24. package/dist/extractors/mssql.js +3 -0
  25. package/dist/extractors/mssql.js.map +1 -1
  26. package/dist/extractors/mysql.d.ts.map +1 -1
  27. package/dist/extractors/mysql.js +3 -1
  28. package/dist/extractors/mysql.js.map +1 -1
  29. package/dist/extractors/oracle.d.ts.map +1 -1
  30. package/dist/extractors/oracle.js +3 -0
  31. package/dist/extractors/oracle.js.map +1 -1
  32. package/dist/extractors/postgres.d.ts.map +1 -1
  33. package/dist/extractors/postgres.js +39 -24
  34. package/dist/extractors/postgres.js.map +1 -1
  35. package/dist/mcp/client.d.ts +104 -0
  36. package/dist/mcp/client.d.ts.map +1 -0
  37. package/dist/mcp/client.js +103 -0
  38. package/dist/mcp/client.js.map +1 -0
  39. package/dist/mcp/resources.d.ts +12 -0
  40. package/dist/mcp/resources.d.ts.map +1 -0
  41. package/dist/mcp/resources.js +113 -0
  42. package/dist/mcp/resources.js.map +1 -0
  43. package/dist/mcp/toolManifest.d.ts +20 -0
  44. package/dist/mcp/toolManifest.d.ts.map +1 -0
  45. package/dist/mcp/toolManifest.js +38 -0
  46. package/dist/mcp/toolManifest.js.map +1 -0
  47. package/dist/mcp/tools.d.ts +4 -0
  48. package/dist/mcp/tools.d.ts.map +1 -0
  49. package/dist/mcp/tools.js +652 -0
  50. package/dist/mcp/tools.js.map +1 -0
  51. package/dist/types.d.ts +6 -0
  52. package/dist/types.d.ts.map +1 -1
  53. package/package.json +19 -10
@@ -0,0 +1,113 @@
1
+ export function registerResources(server, client) {
2
+ // ── 다이어그램 목록 ──
3
+ server.resource('diagrams', 'thinkerd://diagrams', {
4
+ description: 'ThinkERD 프로젝트의 모든 다이어그램 목록을 반환합니다.',
5
+ }, async () => {
6
+ const diagrams = await client.listDiagrams();
7
+ return {
8
+ contents: [{
9
+ uri: 'thinkerd://diagrams',
10
+ mimeType: 'application/json',
11
+ text: JSON.stringify(diagrams, null, 2),
12
+ }],
13
+ };
14
+ });
15
+ // ── 다이어그램 스키마 (엔터티 + 관계) ──
16
+ server.resource('diagram-schema', 'thinkerd://diagrams/{diagramId}/schema', {
17
+ description: '특정 다이어그램의 전체 스키마(엔터티, 컬럼, 관계)를 JSON으로 반환합니다.',
18
+ }, async (uri) => {
19
+ const diagramId = extractParam(uri.href, 'diagrams');
20
+ const data = await client.getDiagram(diagramId);
21
+ return {
22
+ contents: [{
23
+ uri: uri.href,
24
+ mimeType: 'application/json',
25
+ text: JSON.stringify(data, null, 2),
26
+ }],
27
+ };
28
+ });
29
+ // ── 단일 엔터티 상세 ──
30
+ server.resource('entity-detail', 'thinkerd://diagrams/{diagramId}/entities/{entityId}', {
31
+ description: '특정 엔터티의 논리명, 물리명, 컬럼 상세(타입, PK/FK, Nullable 등)를 반환합니다.',
32
+ }, async (uri) => {
33
+ const parts = uri.href.split('/');
34
+ const entitiesIdx = parts.indexOf('entities');
35
+ const diagramsIdx = parts.indexOf('diagrams');
36
+ const diagramId = parts[diagramsIdx + 1];
37
+ const entityId = parts[entitiesIdx + 1];
38
+ const entity = await client.getEntity(diagramId, entityId);
39
+ return {
40
+ contents: [{
41
+ uri: uri.href,
42
+ mimeType: 'application/json',
43
+ text: JSON.stringify(entity, null, 2),
44
+ }],
45
+ };
46
+ });
47
+ // ── DDL 생성 ──
48
+ server.resource('diagram-ddl', 'thinkerd://diagrams/{diagramId}/ddl', {
49
+ description: '다이어그램의 DDL(CREATE TABLE 구문)을 생성하여 반환합니다.',
50
+ }, async (uri) => {
51
+ const diagramId = extractParam(uri.href, 'diagrams');
52
+ const ddl = await client.generateDDL(diagramId);
53
+ return {
54
+ contents: [{
55
+ uri: uri.href,
56
+ mimeType: 'text/plain',
57
+ text: typeof ddl === 'string' ? ddl : JSON.stringify(ddl),
58
+ }],
59
+ };
60
+ });
61
+ // ── 표준 사전 ──
62
+ server.resource('dictionary', 'thinkerd://projects/{projectId}/dictionary', {
63
+ description: '프로젝트의 표준 사전(단어, 도메인, 금칙어)을 반환합니다.',
64
+ }, async (uri) => {
65
+ const projectId = extractParam(uri.href, 'projects');
66
+ const words = await client.getDictionary(projectId);
67
+ return {
68
+ contents: [{
69
+ uri: uri.href,
70
+ mimeType: 'application/json',
71
+ text: JSON.stringify(words, null, 2),
72
+ }],
73
+ };
74
+ });
75
+ // ── 프로젝트 스키마 요약 (온톨로지) ──
76
+ server.resource('project-summary', 'thinkerd://projects/{projectId}/summary', {
77
+ description: '프로젝트 전체 데이터 모델의 요약(엔터티 수, 관계 수, 주제영역 구성, RDF 트리플 수)을 반환합니다.',
78
+ }, async (uri) => {
79
+ const projectId = extractParam(uri.href, 'projects');
80
+ const summary = await client.getProjectSummary(projectId);
81
+ return {
82
+ contents: [{
83
+ uri: uri.href,
84
+ mimeType: 'application/json',
85
+ text: JSON.stringify(summary, null, 2),
86
+ }],
87
+ };
88
+ });
89
+ // ── 메타데이터 품질 보고 ──
90
+ server.resource('metadata-quality', 'thinkerd://projects/{projectId}/quality', {
91
+ description: '프로젝트의 메타데이터 풍부도(설명, 동의어, 속성 입력률)를 분석한 품질 보고서를 반환합니다.',
92
+ }, async (uri) => {
93
+ const projectId = extractParam(uri.href, 'projects');
94
+ const report = await client.checkMetadataQuality(projectId);
95
+ return {
96
+ contents: [{
97
+ uri: uri.href,
98
+ mimeType: 'application/json',
99
+ text: JSON.stringify(report, null, 2),
100
+ }],
101
+ };
102
+ });
103
+ }
104
+ /** URI에서 특정 세그먼트 뒤의 ID를 추출하는 유틸리티 */
105
+ function extractParam(href, segment) {
106
+ const parts = href.split('/');
107
+ const idx = parts.indexOf(segment);
108
+ if (idx === -1 || idx + 1 >= parts.length) {
109
+ throw new Error(`Invalid URI: cannot extract '${segment}' parameter from ${href}`);
110
+ }
111
+ return parts[idx + 1];
112
+ }
113
+ //# sourceMappingURL=resources.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * 배송되는 도구 목록의 **정본**.
3
+ *
4
+ * ## 왜 목록을 따로 적는가
5
+ *
6
+ * 2026-08-29 점검에서 **레포에 18종, npm에 5종**이 있는 것이 발견됐다. 13종은 한
7
+ * 번도 배송된 적이 없었다. 원인은 배포 자동화가 태그를 밀 때만 도는데 **태그 미는
8
+ * 것을 잊은 것**이고, 더 근본적으로는 "레포에 있는 것"과 "실제로 나간 것"을
9
+ * **아무도 대조하지 않은 것**이다.
10
+ *
11
+ * 그래서 대조를 사람이 아니라 테스트가 한다. 도구를 추가·삭제하면 이 파일도 같이
12
+ * 고쳐야 하고, 안 고치면 `toolContract.test.ts`가 실패한다.
13
+ *
14
+ * `@thinkdata/governance-types`의 `copilot-actions.ts`가 액션 프로토콜에 대해
15
+ * 하는 역할과 같다 (CLAUDE.md §4.5).
16
+ */
17
+ /** 등록되는 도구 이름 — `registerTools`와 정확히 일치해야 한다 */
18
+ export declare const TOOL_MANIFEST: readonly ["get_entity", "search_entities", "generate_ddl", "validate_schema", "harvest_schema_semantics", "propose_schema_change", "get_business_dictionary", "analyze_legacy_sql", "semantic_search", "get_business_context", "generate_sql", "get_project_context", "find_join_path", "get_project_summary", "query_ontology", "check_metadata_quality"];
19
+ export type ToolName = (typeof TOOL_MANIFEST)[number];
20
+ //# sourceMappingURL=toolManifest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toolManifest.d.ts","sourceRoot":"","sources":["../../src/mcp/toolManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gDAAgD;AAChD,eAAO,MAAM,aAAa,4VAmBhB,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * 배송되는 도구 목록의 **정본**.
3
+ *
4
+ * ## 왜 목록을 따로 적는가
5
+ *
6
+ * 2026-08-29 점검에서 **레포에 18종, npm에 5종**이 있는 것이 발견됐다. 13종은 한
7
+ * 번도 배송된 적이 없었다. 원인은 배포 자동화가 태그를 밀 때만 도는데 **태그 미는
8
+ * 것을 잊은 것**이고, 더 근본적으로는 "레포에 있는 것"과 "실제로 나간 것"을
9
+ * **아무도 대조하지 않은 것**이다.
10
+ *
11
+ * 그래서 대조를 사람이 아니라 테스트가 한다. 도구를 추가·삭제하면 이 파일도 같이
12
+ * 고쳐야 하고, 안 고치면 `toolContract.test.ts`가 실패한다.
13
+ *
14
+ * `@thinkdata/governance-types`의 `copilot-actions.ts`가 액션 프로토콜에 대해
15
+ * 하는 역할과 같다 (CLAUDE.md §4.5).
16
+ */
17
+ /** 등록되는 도구 이름 — `registerTools`와 정확히 일치해야 한다 */
18
+ export const TOOL_MANIFEST = [
19
+ // ── 스키마 조회 ──
20
+ 'get_entity',
21
+ 'search_entities',
22
+ 'generate_ddl',
23
+ 'validate_schema',
24
+ 'harvest_schema_semantics',
25
+ 'propose_schema_change',
26
+ 'get_business_dictionary',
27
+ 'analyze_legacy_sql',
28
+ // ── 의미 계층·온톨로지 ──
29
+ 'semantic_search',
30
+ 'get_business_context',
31
+ 'generate_sql',
32
+ 'get_project_context',
33
+ 'find_join_path',
34
+ 'get_project_summary',
35
+ 'query_ontology',
36
+ 'check_metadata_quality',
37
+ ];
38
+ //# sourceMappingURL=toolManifest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toolManifest.js","sourceRoot":"","sources":["../../src/mcp/toolManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,eAAe;IACf,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,iBAAiB;IACjB,0BAA0B;IAC1B,uBAAuB;IACvB,yBAAyB;IACzB,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;IACjB,sBAAsB;IACtB,cAAc;IACd,qBAAqB;IACrB,gBAAgB;IAChB,qBAAqB;IACrB,gBAAgB;IAChB,wBAAwB;CAClB,CAAA"}
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ThinkERDClient } from './client.js';
3
+ export declare function registerTools(server: McpServer, client: ThinkERDClient): void;
4
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA0vB7E"}