@telora/mcp-products 0.21.28 → 0.21.30

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 (36) hide show
  1. package/dist/handlers/componentHandlers.d.ts +3 -0
  2. package/dist/handlers/componentHandlers.js +128 -0
  3. package/dist/handlers/componentHandlers.js.map +1 -0
  4. package/dist/handlers/contractHandlers.d.ts +3 -0
  5. package/dist/handlers/contractHandlers.js +150 -0
  6. package/dist/handlers/contractHandlers.js.map +1 -0
  7. package/dist/handlers/factoryHandlers.js +3 -182
  8. package/dist/handlers/factoryHandlers.js.map +1 -1
  9. package/dist/handlers/index.d.ts +3 -0
  10. package/dist/handlers/index.js +3 -0
  11. package/dist/handlers/index.js.map +1 -1
  12. package/dist/handlers/prerequisiteTreeHandlers.d.ts +3 -0
  13. package/dist/handlers/prerequisiteTreeHandlers.js +416 -0
  14. package/dist/handlers/prerequisiteTreeHandlers.js.map +1 -0
  15. package/dist/handlers/realityTreeHandlers.js +6 -4
  16. package/dist/handlers/realityTreeHandlers.js.map +1 -1
  17. package/dist/index.js +72 -2
  18. package/dist/index.js.map +1 -1
  19. package/dist/scanner/ast-extraction.d.ts +10 -0
  20. package/dist/scanner/ast-extraction.js +156 -0
  21. package/dist/scanner/ast-extraction.js.map +1 -0
  22. package/dist/scanner/file-discovery.d.ts +9 -0
  23. package/dist/scanner/file-discovery.js +134 -0
  24. package/dist/scanner/file-discovery.js.map +1 -0
  25. package/dist/scanner/index.d.ts +19 -0
  26. package/dist/scanner/index.js +193 -0
  27. package/dist/scanner/index.js.map +1 -0
  28. package/dist/scanner/relationship-extraction.d.ts +11 -0
  29. package/dist/scanner/relationship-extraction.js +187 -0
  30. package/dist/scanner/relationship-extraction.js.map +1 -0
  31. package/dist/scanner/types.d.ts +45 -0
  32. package/dist/scanner/types.js +3 -0
  33. package/dist/scanner/types.js.map +1 -0
  34. package/dist/shared.js +34 -7
  35. package/dist/shared.js.map +1 -1
  36. package/package.json +2 -1
@@ -0,0 +1,193 @@
1
+ // Scanner orchestrator: runs file discovery, AST extraction, relationship
2
+ // extraction, and persists results via the product API.
3
+ import * as path from 'node:path';
4
+ import { execSync } from 'node:child_process';
5
+ import { discoverFiles, classifyDirectory } from './file-discovery.js';
6
+ import { createProject, extractMembers } from './ast-extraction.js';
7
+ import { extractRelationships, parseTsconfigPaths } from './relationship-extraction.js';
8
+ import { callProductApi } from '../shared.js';
9
+ /**
10
+ * Run a full component scan: discover files, parse AST, extract relationships,
11
+ * persist to DB via product API.
12
+ */
13
+ export async function runScan(creds, options) {
14
+ const { productId, repoPath, sourceRoot = 'src/', maxScans } = options;
15
+ // Get current commit SHA
16
+ let commitSha = null;
17
+ try {
18
+ commitSha = execSync('git rev-parse HEAD', { cwd: repoPath, encoding: 'utf-8' }).trim();
19
+ }
20
+ catch {
21
+ // Not a git repo or no commits — continue without SHA
22
+ }
23
+ // Step 1: Create scan record
24
+ const createResult = await callProductApi(creds, {
25
+ action: 'component_scan_create',
26
+ productId,
27
+ sourceRoot,
28
+ fields: { commitSha },
29
+ });
30
+ const scanId = createResult.scan.id;
31
+ try {
32
+ // Step 2: Discover files
33
+ const files = discoverFiles(repoPath, sourceRoot);
34
+ // Step 3: Build directory hierarchy
35
+ const { components } = buildComponentHierarchy(files, sourceRoot);
36
+ // Step 4: Extract members via AST
37
+ const members = [];
38
+ const project = createProject(repoPath);
39
+ const knownPaths = new Set(files.map(f => f.path));
40
+ for (const file of files) {
41
+ const absPath = path.resolve(repoPath, file.path);
42
+ const tempId = file.path; // path is the temp ID
43
+ try {
44
+ const sourceFile = project.addSourceFileAtPath(absPath);
45
+ const extractedMembers = extractMembers(sourceFile);
46
+ for (const m of extractedMembers) {
47
+ members.push({
48
+ componentTempId: tempId,
49
+ memberType: m.memberType,
50
+ name: m.name,
51
+ signature: m.signature,
52
+ required: m.required,
53
+ defaultValue: m.defaultValue,
54
+ });
55
+ }
56
+ }
57
+ catch {
58
+ // Skip files that can't be parsed
59
+ continue;
60
+ }
61
+ }
62
+ // Step 5: Extract relationships
63
+ const relationships = [];
64
+ const pathAliases = parseTsconfigPaths(repoPath);
65
+ const tempIdByPath = new Map();
66
+ for (const c of components) {
67
+ tempIdByPath.set(c.path, c.tempId);
68
+ }
69
+ for (const file of files) {
70
+ const absPath = path.resolve(repoPath, file.path);
71
+ try {
72
+ const sourceFile = project.getSourceFile(absPath);
73
+ if (!sourceFile)
74
+ continue;
75
+ const extracted = extractRelationships(sourceFile, file.path, knownPaths, repoPath, pathAliases);
76
+ for (const rel of extracted) {
77
+ const sourceTempId = tempIdByPath.get(rel.sourcePath);
78
+ const targetTempId = tempIdByPath.get(rel.targetPath);
79
+ if (sourceTempId && targetTempId && sourceTempId !== targetTempId) {
80
+ relationships.push({
81
+ sourceTempId,
82
+ targetTempId,
83
+ relationshipType: rel.relationshipType,
84
+ metadata: rel.metadata,
85
+ });
86
+ }
87
+ }
88
+ }
89
+ catch {
90
+ continue;
91
+ }
92
+ }
93
+ // Deduplicate relationships (same source+target+type)
94
+ const relKey = (r) => `${r.sourceTempId}|${r.targetTempId}|${r.relationshipType}`;
95
+ const seenRels = new Set();
96
+ const uniqueRelationships = relationships.filter(r => {
97
+ const key = relKey(r);
98
+ if (seenRels.has(key))
99
+ return false;
100
+ seenRels.add(key);
101
+ return true;
102
+ });
103
+ // Step 6: Persist everything (also triggers cleanup of old scans)
104
+ const persistPayload = {
105
+ action: 'component_scan_persist',
106
+ scanId,
107
+ components,
108
+ members,
109
+ relationships: uniqueRelationships,
110
+ };
111
+ if (maxScans !== undefined)
112
+ persistPayload.maxScans = maxScans;
113
+ const persistResult = await callProductApi(creds, persistPayload);
114
+ return {
115
+ scanId,
116
+ componentCount: persistResult.componentCount,
117
+ memberCount: persistResult.memberCount,
118
+ relationshipCount: persistResult.relationshipCount,
119
+ commitSha,
120
+ };
121
+ }
122
+ catch (err) {
123
+ // Mark scan as failed
124
+ try {
125
+ await callProductApi(creds, {
126
+ action: 'component_scan_update',
127
+ scanId,
128
+ fields: {
129
+ status: 'failed',
130
+ metadata: { error: err.message },
131
+ },
132
+ });
133
+ }
134
+ catch {
135
+ // Best effort
136
+ }
137
+ throw err;
138
+ }
139
+ }
140
+ /**
141
+ * Build the component hierarchy from discovered files.
142
+ * Creates directory components as parents, file components as children.
143
+ */
144
+ function buildComponentHierarchy(files, sourceRoot) {
145
+ const components = [];
146
+ const dirTempIds = new Map();
147
+ // Collect all unique directories
148
+ const dirs = new Set();
149
+ for (const file of files) {
150
+ let dir = file.parentDir;
151
+ while (dir && dir !== '.' && dir !== sourceRoot.replace(/\/$/, '')) {
152
+ dirs.add(dir);
153
+ dir = path.dirname(dir);
154
+ // Stop at sourceRoot level
155
+ if (dir.length < sourceRoot.replace(/\/$/, '').length)
156
+ break;
157
+ }
158
+ }
159
+ // Sort directories by depth (parents first)
160
+ const sortedDirs = [...dirs].sort((a, b) => {
161
+ const aDepth = a.split('/').length;
162
+ const bDepth = b.split('/').length;
163
+ return aDepth - bDepth;
164
+ });
165
+ // Create directory components
166
+ for (const dir of sortedDirs) {
167
+ const parentDir = path.dirname(dir);
168
+ const parentTempId = dirTempIds.get(parentDir);
169
+ const tempId = `dir:${dir}`;
170
+ dirTempIds.set(dir, tempId);
171
+ components.push({
172
+ tempId,
173
+ parentTempId: parentTempId,
174
+ name: path.basename(dir),
175
+ path: dir,
176
+ componentType: classifyDirectory(dir),
177
+ });
178
+ }
179
+ // Create file components
180
+ for (const file of files) {
181
+ const parentTempId = dirTempIds.get(file.parentDir);
182
+ components.push({
183
+ tempId: file.path,
184
+ parentTempId: parentTempId,
185
+ name: file.name,
186
+ path: file.path,
187
+ componentType: file.componentType,
188
+ lineCount: file.lineCount,
189
+ });
190
+ }
191
+ return { components, dirTempIds };
192
+ }
193
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanner/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wDAAwD;AAExD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,cAAc,EAAsB,MAAM,cAAc,CAAC;AAuBlE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,KAAoB,EACpB,OAAoB;IAEpB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEvE,yBAAyB;IACzB,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,CAAC;QACH,SAAS,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;IAED,6BAA6B;IAC7B,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE;QAC/C,MAAM,EAAE,uBAAuB;QAC/B,SAAS;QACT,UAAU;QACV,MAAM,EAAE,EAAE,SAAS,EAAE;KACtB,CAA6B,CAAC;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,yBAAyB;QACzB,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAElD,oCAAoC;QACpC,MAAM,EAAE,UAAU,EAAE,GAAG,uBAAuB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAElE,kCAAkC;QAClC,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,sBAAsB;YAEhD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBACxD,MAAM,gBAAgB,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;gBAEpD,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC;wBACX,eAAe,EAAE,MAAM;wBACvB,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,YAAY,EAAE,CAAC,CAAC,YAAY;qBAC7B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;gBAClC,SAAS;YACX,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,aAAa,GAAwB,EAAE,CAAC;QAC9C,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAClD,IAAI,CAAC,UAAU;oBAAE,SAAS;gBAE1B,MAAM,SAAS,GAAG,oBAAoB,CACpC,UAAU,EACV,IAAI,CAAC,IAAI,EACT,UAAU,EACV,QAAQ,EACR,WAAW,CACZ,CAAC;gBAEF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBACtD,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBACtD,IAAI,YAAY,IAAI,YAAY,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;wBAClE,aAAa,CAAC,IAAI,CAAC;4BACjB,YAAY;4BACZ,YAAY;4BACZ,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;4BACtC,QAAQ,EAAE,GAAG,CAAC,QAAQ;yBACvB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,MAAM,MAAM,GAAG,CAAC,CAAoB,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACrG,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACnD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YACpC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,MAAM,cAAc,GAA4B;YAC9C,MAAM,EAAE,wBAAwB;YAChC,MAAM;YACN,UAAU;YACV,OAAO;YACP,aAAa,EAAE,mBAAmB;SACnC,CAAC;QACF,IAAI,QAAQ,KAAK,SAAS;YAAE,cAAc,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAE/D,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,cAAc,CAE/D,CAAC;QAEF,OAAO;YACL,MAAM;YACN,cAAc,EAAE,aAAa,CAAC,cAAc;YAC5C,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,iBAAiB,EAAE,aAAa,CAAC,iBAAiB;YAClD,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sBAAsB;QACtB,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,KAAK,EAAE;gBAC1B,MAAM,EAAE,uBAAuB;gBAC/B,MAAM;gBACN,MAAM,EAAE;oBACN,MAAM,EAAE,QAAQ;oBAChB,QAAQ,EAAE,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE;iBAC5C;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,KAAuB,EACvB,UAAkB;IAElB,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7C,iCAAiC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QACzB,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxB,2BAA2B;YAC3B,IAAI,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM;gBAAE,MAAM;QAC/D,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACnC,OAAO,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,OAAO,GAAG,EAAE,CAAC;QAC5B,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE5B,UAAU,CAAC,IAAI,CAAC;YACd,MAAM;YACN,YAAY,EAAE,YAAY;YAC1B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxB,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,iBAAiB,CAAC,GAAG,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpD,UAAU,CAAC,IAAI,CAAC;YACd,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,YAAY,EAAE,YAAY;YAC1B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { SourceFile } from 'ts-morph';
2
+ import type { ExtractedRelationship } from './types.js';
3
+ /**
4
+ * Extract import relationships from a source file.
5
+ * Only tracks imports that resolve to discovered components (internal).
6
+ */
7
+ export declare function extractRelationships(sourceFile: SourceFile, sourcePath: string, knownPaths: Set<string>, repoRoot: string, pathAliases: Record<string, string>): ExtractedRelationship[];
8
+ /**
9
+ * Parse tsconfig.json paths to extract alias mappings.
10
+ */
11
+ export declare function parseTsconfigPaths(repoRoot: string): Record<string, string>;
@@ -0,0 +1,187 @@
1
+ // Extract import relationships between discovered components.
2
+ import * as path from 'node:path';
3
+ import * as fs from 'node:fs';
4
+ /**
5
+ * Extract import relationships from a source file.
6
+ * Only tracks imports that resolve to discovered components (internal).
7
+ */
8
+ export function extractRelationships(sourceFile, sourcePath, knownPaths, repoRoot, pathAliases) {
9
+ const relationships = [];
10
+ // Process import declarations
11
+ for (const importDecl of sourceFile.getImportDeclarations()) {
12
+ const moduleSpecifier = importDecl.getModuleSpecifierValue();
13
+ const resolvedPath = resolveImportPath(sourcePath, moduleSpecifier, knownPaths, repoRoot, pathAliases);
14
+ if (!resolvedPath)
15
+ continue;
16
+ const namedImports = importDecl.getNamedImports().map(ni => ni.getName());
17
+ const defaultImport = importDecl.getDefaultImport()?.getText();
18
+ const namespaceImport = importDecl.getNamespaceImport()?.getText();
19
+ const allImports = [
20
+ ...namedImports,
21
+ ...(defaultImport ? [defaultImport] : []),
22
+ ...(namespaceImport ? [namespaceImport] : []),
23
+ ];
24
+ relationships.push({
25
+ sourcePath,
26
+ targetPath: resolvedPath,
27
+ relationshipType: 'imports',
28
+ metadata: { namedImports: allImports },
29
+ });
30
+ }
31
+ // Process re-exports (export { X } from './Y')
32
+ for (const exportDecl of sourceFile.getExportDeclarations()) {
33
+ const moduleSpecifier = exportDecl.getModuleSpecifierValue();
34
+ if (!moduleSpecifier)
35
+ continue;
36
+ const resolvedPath = resolveImportPath(sourcePath, moduleSpecifier, knownPaths, repoRoot, pathAliases);
37
+ if (!resolvedPath)
38
+ continue;
39
+ const namedExports = exportDecl.getNamedExports().map(ne => ne.getName());
40
+ const isStarExport = exportDecl.isNamespaceExport() || namedExports.length === 0;
41
+ relationships.push({
42
+ sourcePath,
43
+ targetPath: resolvedPath,
44
+ relationshipType: 're_exports',
45
+ metadata: {
46
+ namedExports: isStarExport ? ['*'] : namedExports,
47
+ },
48
+ });
49
+ }
50
+ // Detect JSX renders (component A renders component B)
51
+ detectRenders(sourceFile, sourcePath, knownPaths, repoRoot, pathAliases, relationships);
52
+ return relationships;
53
+ }
54
+ /**
55
+ * Resolve an import specifier to a known component path.
56
+ */
57
+ function resolveImportPath(sourcePath, specifier, knownPaths, repoRoot, pathAliases) {
58
+ // Skip external packages
59
+ if (!specifier.startsWith('.') && !specifier.startsWith('@/') && !specifier.startsWith('~/')) {
60
+ // Check path aliases
61
+ let resolved = null;
62
+ for (const [alias, target] of Object.entries(pathAliases)) {
63
+ const aliasPrefix = alias.replace('/*', '/');
64
+ const targetPrefix = target.replace('/*', '/');
65
+ if (specifier.startsWith(aliasPrefix)) {
66
+ const rest = specifier.slice(aliasPrefix.length);
67
+ resolved = targetPrefix + rest;
68
+ break;
69
+ }
70
+ // Exact match (no wildcard)
71
+ if (alias === specifier) {
72
+ resolved = target;
73
+ break;
74
+ }
75
+ }
76
+ if (!resolved)
77
+ return null;
78
+ return tryResolveToKnown(resolved, knownPaths);
79
+ }
80
+ // Handle @/ alias (common in Vite/Next projects)
81
+ if (specifier.startsWith('@/') || specifier.startsWith('~/')) {
82
+ const aliasValue = pathAliases['@/*'] || pathAliases['~/*'] || 'src/*';
83
+ const targetPrefix = aliasValue.replace('/*', '/');
84
+ const rest = specifier.slice(2); // remove @/ or ~/
85
+ return tryResolveToKnown(targetPrefix + rest, knownPaths);
86
+ }
87
+ // Relative import
88
+ const sourceDir = path.dirname(sourcePath);
89
+ const resolved = path.normalize(path.join(sourceDir, specifier));
90
+ return tryResolveToKnown(resolved, knownPaths);
91
+ }
92
+ /**
93
+ * Try to resolve a partial path to a known component path.
94
+ * Handles: exact match, .ts/.tsx extension, /index.ts barrel.
95
+ */
96
+ function tryResolveToKnown(partial, knownPaths) {
97
+ // Normalize separators
98
+ const normalized = partial.replace(/\\/g, '/');
99
+ // Exact match
100
+ if (knownPaths.has(normalized))
101
+ return normalized;
102
+ // Try extensions
103
+ const extensions = ['.ts', '.tsx', '.js', '.jsx'];
104
+ for (const ext of extensions) {
105
+ const withExt = normalized + ext;
106
+ if (knownPaths.has(withExt))
107
+ return withExt;
108
+ }
109
+ // Try index file
110
+ for (const ext of extensions) {
111
+ const indexPath = normalized + '/index' + ext;
112
+ if (knownPaths.has(indexPath))
113
+ return indexPath;
114
+ }
115
+ return null;
116
+ }
117
+ /**
118
+ * Detect JSX render relationships by scanning import declarations
119
+ * and checking if imported identifiers appear in JSX-like patterns.
120
+ */
121
+ function detectRenders(sourceFile, sourcePath, knownPaths, repoRoot, pathAliases, relationships) {
122
+ const text = sourceFile.getFullText();
123
+ // Collect imported component names (PascalCase = likely React component)
124
+ const importedComponents = new Map(); // name -> resolved path
125
+ for (const importDecl of sourceFile.getImportDeclarations()) {
126
+ const moduleSpecifier = importDecl.getModuleSpecifierValue();
127
+ const resolvedPath = resolveImportPath(sourcePath, moduleSpecifier, knownPaths, repoRoot, pathAliases);
128
+ if (!resolvedPath)
129
+ continue;
130
+ const defaultImport = importDecl.getDefaultImport()?.getText();
131
+ if (defaultImport && isPascalCase(defaultImport)) {
132
+ importedComponents.set(defaultImport, resolvedPath);
133
+ }
134
+ for (const named of importDecl.getNamedImports()) {
135
+ const name = named.getAliasNode()?.getText() || named.getName();
136
+ if (isPascalCase(name)) {
137
+ importedComponents.set(name, resolvedPath);
138
+ }
139
+ }
140
+ }
141
+ // Check if any imported PascalCase identifiers appear as JSX tags
142
+ for (const [name, targetPath] of importedComponents) {
143
+ // Look for <ComponentName or <ComponentName> patterns
144
+ const jsxPattern = new RegExp(`<${name}[\\s/>]`);
145
+ if (jsxPattern.test(text)) {
146
+ // Don't duplicate if we already have an imports relationship for this target
147
+ const existingImport = relationships.find(r => r.sourcePath === sourcePath && r.targetPath === targetPath && r.relationshipType === 'imports');
148
+ if (existingImport) {
149
+ // Upgrade: also add a renders relationship
150
+ relationships.push({
151
+ sourcePath,
152
+ targetPath,
153
+ relationshipType: 'renders',
154
+ metadata: { renderedComponent: name },
155
+ });
156
+ }
157
+ }
158
+ }
159
+ }
160
+ function isPascalCase(name) {
161
+ return /^[A-Z][a-zA-Z0-9]*$/.test(name);
162
+ }
163
+ /**
164
+ * Parse tsconfig.json paths to extract alias mappings.
165
+ */
166
+ export function parseTsconfigPaths(repoRoot) {
167
+ const aliases = {};
168
+ try {
169
+ const tsconfigPath = path.join(repoRoot, 'tsconfig.json');
170
+ const content = JSON.parse(fs.readFileSync(tsconfigPath, 'utf-8'));
171
+ const paths = content?.compilerOptions?.paths;
172
+ if (paths) {
173
+ for (const [alias, targets] of Object.entries(paths)) {
174
+ const targetArray = targets;
175
+ if (targetArray.length > 0) {
176
+ aliases[alias] = targetArray[0];
177
+ }
178
+ }
179
+ }
180
+ }
181
+ catch {
182
+ // Default alias if tsconfig not found
183
+ aliases['@/*'] = 'src/*';
184
+ }
185
+ return aliases;
186
+ }
187
+ //# sourceMappingURL=relationship-extraction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relationship-extraction.js","sourceRoot":"","sources":["../../src/scanner/relationship-extraction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ export type ComponentType = 'page' | 'component' | 'hook' | 'context' | 'library' | 'utility' | 'type_definition' | 'barrel';
2
+ export type MemberType = 'prop' | 'method' | 'hook_return' | 'export_function' | 'export_const' | 'export_type' | 'state' | 'context_value';
3
+ export type RelationshipType = 'imports' | 're_exports' | 'renders';
4
+ export interface DiscoveredFile {
5
+ path: string;
6
+ name: string;
7
+ componentType: ComponentType;
8
+ lineCount: number;
9
+ parentDir: string;
10
+ }
11
+ export interface ExtractedMember {
12
+ memberType: MemberType;
13
+ name: string;
14
+ signature?: string;
15
+ required?: boolean;
16
+ defaultValue?: string;
17
+ }
18
+ export interface ExtractedRelationship {
19
+ sourcePath: string;
20
+ targetPath: string;
21
+ relationshipType: RelationshipType;
22
+ metadata?: Record<string, unknown>;
23
+ }
24
+ export interface ComponentInput {
25
+ tempId: string;
26
+ parentTempId?: string;
27
+ name: string;
28
+ path: string;
29
+ componentType: ComponentType;
30
+ lineCount?: number;
31
+ }
32
+ export interface MemberInput {
33
+ componentTempId: string;
34
+ memberType: MemberType;
35
+ name: string;
36
+ signature?: string;
37
+ required?: boolean;
38
+ defaultValue?: string;
39
+ }
40
+ export interface RelationshipInput {
41
+ sourceTempId: string;
42
+ targetTempId: string;
43
+ relationshipType: RelationshipType;
44
+ metadata?: Record<string, unknown>;
45
+ }
@@ -0,0 +1,3 @@
1
+ // Scanner types shared across modules
2
+ export {};
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scanner/types.ts"],"names":[],"mappings":"AAAA,sCAAsC"}
package/dist/shared.js CHANGED
@@ -1,20 +1,47 @@
1
1
  // ---------------------------------------------------------------------------
2
2
  // Shared types, credential loading, and API client used by all handler modules
3
3
  // ---------------------------------------------------------------------------
4
- // ---------------------------------------------------------------------------
5
- // Credential loading -- env vars only
6
- // ---------------------------------------------------------------------------
4
+ import { existsSync, readFileSync } from "node:fs";
5
+ import { join } from "node:path";
6
+ import { homedir } from "node:os";
7
+ function resolveDaemonStateDir() {
8
+ const env = process.env.TELORA_STATE_DIR;
9
+ if (env)
10
+ return env;
11
+ return join(homedir(), ".telora");
12
+ }
13
+ function loadFromDaemonJson() {
14
+ const path = join(resolveDaemonStateDir(), "daemon.json");
15
+ try {
16
+ if (!existsSync(path))
17
+ return null;
18
+ const parsed = JSON.parse(readFileSync(path, "utf-8"));
19
+ return parsed;
20
+ }
21
+ catch {
22
+ return null;
23
+ }
24
+ }
7
25
  export function loadCredentials() {
8
- // Support both new TELORA_TRACKER_ID (profile-based UUID) and legacy TELORA_ACCESS_TOKEN
9
- const accessToken = process.env.TELORA_TRACKER_ID || process.env.TELORA_ACCESS_TOKEN;
26
+ let accessToken = process.env.TELORA_TRACKER_ID || process.env.TELORA_ACCESS_TOKEN;
10
27
  if (!process.env.TELORA_TRACKER_ID && process.env.TELORA_ACCESS_TOKEN) {
11
28
  console.error("[telora-products] Warning: TELORA_ACCESS_TOKEN is deprecated. Use TELORA_TRACKER_ID instead.");
12
29
  }
13
- const teloraUrl = process.env.TELORA_URL;
30
+ let teloraUrl = process.env.TELORA_URL;
31
+ if (!accessToken || !teloraUrl) {
32
+ const daemonConfig = loadFromDaemonJson();
33
+ if (daemonConfig) {
34
+ if (!accessToken && daemonConfig.trackerId)
35
+ accessToken = daemonConfig.trackerId;
36
+ if (!teloraUrl && daemonConfig.teloraUrl)
37
+ teloraUrl = daemonConfig.teloraUrl;
38
+ }
39
+ }
14
40
  if (accessToken && teloraUrl) {
15
41
  return { accessToken, teloraUrl };
16
42
  }
17
- throw new Error("MCP server not configured. Run: npx @telora/mcp-products init");
43
+ throw new Error("MCP server not configured. Run `telora-daemon connect <token>` to wire the workstation, " +
44
+ "or set TELORA_TRACKER_ID and TELORA_URL env vars.");
18
45
  }
19
46
  // ---------------------------------------------------------------------------
20
47
  // API client
@@ -1 +1 @@
1
- {"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@telora/mcp-products",
3
- "version": "0.21.28",
3
+ "version": "0.21.30",
4
4
  "description": "MCP server exposing Telora product operations to Claude Code",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -38,6 +38,7 @@
38
38
  },
39
39
  "dependencies": {
40
40
  "@modelcontextprotocol/sdk": "^1.12.1",
41
+ "ts-morph": "^28.0.0",
41
42
  "zod": "^4.3.6"
42
43
  },
43
44
  "devDependencies": {