@tekyzinc/gsd-t 2.51.10 → 2.53.11

package/bin/graph-indexer.js

@@ -1,147 +1,147 @@
-'use strict';
-const fs = require('fs');
-const path = require('path');
-const store = require('./graph-store');
-const { getParser } = require('./graph-parsers');
-const { buildOverlay } = require('./graph-overlay');
-
-const DEFAULT_EXCLUDE = [
-  'node_modules', '.git', 'dist', 'build',
-  'coverage', '.gsd-t', '.claude', '__pycache__'
-];
-
-const SUPPORTED_EXTS = [
-  '.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.py'
-];
-
-function walkFiles(dir, exclude) {
-  const results = [];
-  try {
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-    for (const e of entries) {
-      if (exclude.includes(e.name)) continue;
-      if (e.name.startsWith('.')) continue;
-      const full = path.join(dir, e.name);
-      if (e.isDirectory()) {
-        results.push(...walkFiles(full, exclude));
-      } else if (e.isFile()) {
-        const ext = path.extname(e.name);
-        if (SUPPORTED_EXTS.includes(ext)) {
-          results.push(full);
-        }
-      }
-    }
-  } catch { /* skip inaccessible dirs */ }
-  return results;
-}
-
-function indexProject(projectRoot, options = {}) {
-  const start = Date.now();
-  const force = options.force || false;
-  const exclude = options.exclude || DEFAULT_EXCLUDE;
-  const errors = [];
-
-  // Find source files
-  const allFiles = walkFiles(projectRoot, exclude);
-
-  // Check staleness
-  if (!force) {
-    const { stale, changedFiles } = store.isStale(
-      projectRoot, allFiles
-    );
-    if (!stale) {
-      const meta = store.readMeta(projectRoot);
-      return {
-        success: true,
-        entityCount: meta ? meta.entityCount : 0,
-        relationshipCount: meta ? meta.relationshipCount : 0,
-        duration: Date.now() - start,
-        errors: [],
-        filesProcessed: 0,
-        filesSkipped: allFiles.length
-      };
-    }
-  }
-
-  // Parse all files
-  const allEntities = [];
-  const allImports = [];
-  const allCalls = [];
-  const fileHashes = {};
-  let filesProcessed = 0;
-  let filesSkipped = 0;
-
-  for (const filePath of allFiles) {
-    const ext = path.extname(filePath);
-    const parser = getParser(ext);
-    if (!parser) { filesSkipped++; continue; }
-
-    const rel = path.relative(projectRoot, filePath)
-      .replace(/\\/g, '/');
-    try {
-      const content = fs.readFileSync(filePath, 'utf8');
-      fileHashes[rel] = store.hashContent(content);
-      const result = parser(content, rel);
-      allEntities.push(...result.entities);
-      allImports.push(...result.imports);
-      allCalls.push(...result.calls);
-      filesProcessed++;
-    } catch (e) {
-      errors.push(`Parse error in ${rel}: ${e.message}`);
-      filesSkipped++;
-    }
-  }
-
-  // Build GSD-T overlay
-  const overlay = buildOverlay(projectRoot, allEntities);
-
-  // Resolve call edges (map callee names to entity IDs)
-  const resolvedCalls = [];
-  const entityByName = new Map();
-  for (const e of allEntities) {
-    if (!entityByName.has(e.name)) {
-      entityByName.set(e.name, e);
-    }
-  }
-  for (const call of allCalls) {
-    const target = entityByName.get(call.callee);
-    if (target) {
-      resolvedCalls.push({
-        caller: call.caller,
-        callee: target.id,
-        line: call.line
-      });
-    }
-  }
-
-  // Write to storage
-  store.writeIndex(projectRoot, { entities: allEntities });
-  store.writeCalls(projectRoot, { edges: resolvedCalls });
-  store.writeImports(projectRoot, { edges: allImports });
-  store.writeContracts(projectRoot, overlay.contracts);
-  store.writeRequirements(projectRoot, overlay.requirements);
-  store.writeTests(projectRoot, overlay.tests);
-  store.writeSurfaces(projectRoot, overlay.surfaces);
-
-  const relCount = resolvedCalls.length + allImports.length;
-  store.writeMeta(projectRoot, {
-    lastIndexed: new Date().toISOString(),
-    provider: 'native',
-    entityCount: allEntities.length,
-    relationshipCount: relCount,
-    duration: Date.now() - start,
-    fileHashes
-  });
-
-  return {
-    success: true,
-    entityCount: allEntities.length,
-    relationshipCount: relCount,
-    duration: Date.now() - start,
-    errors,
-    filesProcessed,
-    filesSkipped
-  };
-}
-
-module.exports = { indexProject, walkFiles, DEFAULT_EXCLUDE };
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const store = require('./graph-store');
+const { getParser } = require('./graph-parsers');
+const { buildOverlay } = require('./graph-overlay');
+
+const DEFAULT_EXCLUDE = [
+  'node_modules', '.git', 'dist', 'build',
+  'coverage', '.gsd-t', '.claude', '__pycache__'
+];
+
+const SUPPORTED_EXTS = [
+  '.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.py'
+];
+
+function walkFiles(dir, exclude) {
+  const results = [];
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const e of entries) {
+      if (exclude.includes(e.name)) continue;
+      if (e.name.startsWith('.')) continue;
+      const full = path.join(dir, e.name);
+      if (e.isDirectory()) {
+        results.push(...walkFiles(full, exclude));
+      } else if (e.isFile()) {
+        const ext = path.extname(e.name);
+        if (SUPPORTED_EXTS.includes(ext)) {
+          results.push(full);
+        }
+      }
+    }
+  } catch { /* skip inaccessible dirs */ }
+  return results;
+}
+
+function indexProject(projectRoot, options = {}) {
+  const start = Date.now();
+  const force = options.force || false;
+  const exclude = options.exclude || DEFAULT_EXCLUDE;
+  const errors = [];
+
+  // Find source files
+  const allFiles = walkFiles(projectRoot, exclude);
+
+  // Check staleness
+  if (!force) {
+    const { stale, changedFiles } = store.isStale(
+      projectRoot, allFiles
+    );
+    if (!stale) {
+      const meta = store.readMeta(projectRoot);
+      return {
+        success: true,
+        entityCount: meta ? meta.entityCount : 0,
+        relationshipCount: meta ? meta.relationshipCount : 0,
+        duration: Date.now() - start,
+        errors: [],
+        filesProcessed: 0,
+        filesSkipped: allFiles.length
+      };
+    }
+  }
+
+  // Parse all files
+  const allEntities = [];
+  const allImports = [];
+  const allCalls = [];
+  const fileHashes = {};
+  let filesProcessed = 0;
+  let filesSkipped = 0;
+
+  for (const filePath of allFiles) {
+    const ext = path.extname(filePath);
+    const parser = getParser(ext);
+    if (!parser) { filesSkipped++; continue; }
+
+    const rel = path.relative(projectRoot, filePath)
+      .replace(/\\/g, '/');
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      fileHashes[rel] = store.hashContent(content);
+      const result = parser(content, rel);
+      allEntities.push(...result.entities);
+      allImports.push(...result.imports);
+      allCalls.push(...result.calls);
+      filesProcessed++;
+    } catch (e) {
+      errors.push(`Parse error in ${rel}: ${e.message}`);
+      filesSkipped++;
+    }
+  }
+
+  // Build GSD-T overlay
+  const overlay = buildOverlay(projectRoot, allEntities);
+
+  // Resolve call edges (map callee names to entity IDs)
+  const resolvedCalls = [];
+  const entityByName = new Map();
+  for (const e of allEntities) {
+    if (!entityByName.has(e.name)) {
+      entityByName.set(e.name, e);
+    }
+  }
+  for (const call of allCalls) {
+    const target = entityByName.get(call.callee);
+    if (target) {
+      resolvedCalls.push({
+        caller: call.caller,
+        callee: target.id,
+        line: call.line
+      });
+    }
+  }
+
+  // Write to storage
+  store.writeIndex(projectRoot, { entities: allEntities });
+  store.writeCalls(projectRoot, { edges: resolvedCalls });
+  store.writeImports(projectRoot, { edges: allImports });
+  store.writeContracts(projectRoot, overlay.contracts);
+  store.writeRequirements(projectRoot, overlay.requirements);
+  store.writeTests(projectRoot, overlay.tests);
+  store.writeSurfaces(projectRoot, overlay.surfaces);
+
+  const relCount = resolvedCalls.length + allImports.length;
+  store.writeMeta(projectRoot, {
+    lastIndexed: new Date().toISOString(),
+    provider: 'native',
+    entityCount: allEntities.length,
+    relationshipCount: relCount,
+    duration: Date.now() - start,
+    fileHashes
+  });
+
+  return {
+    success: true,
+    entityCount: allEntities.length,
+    relationshipCount: relCount,
+    duration: Date.now() - start,
+    errors,
+    filesProcessed,
+    filesSkipped
+  };
+}
+
+module.exports = { indexProject, walkFiles, DEFAULT_EXCLUDE };

package/bin/graph-overlay.js

@@ -1,195 +1,195 @@
-'use strict';
-const fs = require('fs');
-const path = require('path');
-
-/**
- * GSD-T context mapper — enriches code entities with
- * domain ownership, contract mapping, requirement traceability,
- * test mapping, debt mapping, and surface detection.
- */
-
-function readFileOrEmpty(filePath) {
-  try { return fs.readFileSync(filePath, 'utf8'); }
-  catch { return ''; }
-}
-
-function listDirs(dirPath) {
-  try {
-    return fs.readdirSync(dirPath, { withFileTypes: true })
-      .filter(d => d.isDirectory())
-      .map(d => d.name);
-  } catch { return []; }
-}
-
-function buildDomainMap(projectRoot) {
-  const domainsDir = path.join(projectRoot, '.gsd-t', 'domains');
-  const map = {};
-  for (const domain of listDirs(domainsDir)) {
-    const scopePath = path.join(domainsDir, domain, 'scope.md');
-    const content = readFileOrEmpty(scopePath);
-    const fileRefs = [];
-    for (const line of content.split('\n')) {
-      const m = line.match(/[-*]\s+`([^`]+)`/);
-      if (m) fileRefs.push(m[1].replace(/\s*\(.*\)/, '').trim());
-    }
-    map[domain] = fileRefs;
-  }
-  return map;
-}
-
-function mapDomains(entities, projectRoot) {
-  const domainMap = buildDomainMap(projectRoot);
-  for (const entity of entities) {
-    for (const [domain, files] of Object.entries(domainMap)) {
-      if (files.some(f => entity.file.includes(f))) {
-        entity.domain = domain;
-        break;
-      }
-    }
-  }
-}
-
-function mapContracts(entities, projectRoot) {
-  const contractsDir = path.join(
-    projectRoot, '.gsd-t', 'contracts'
-  );
-  const mappings = [];
-  try {
-    const files = fs.readdirSync(contractsDir)
-      .filter(f => f.endsWith('.md'));
-    for (const file of files) {
-      const content = readFileOrEmpty(
-        path.join(contractsDir, file)
-      );
-      for (const entity of entities) {
-        if (content.includes(entity.name)) {
-          mappings.push({
-            entity: entity.id,
-            contract: file,
-            section: ''
-          });
-        }
-      }
-    }
-  } catch { /* no contracts dir */ }
-  return { mappings };
-}
-
-function mapRequirements(entities, projectRoot) {
-  const reqPath = path.join(
-    projectRoot, 'docs', 'requirements.md'
-  );
-  const content = readFileOrEmpty(reqPath);
-  const mappings = [];
-  if (!content) return { mappings };
-
-  const reqLines = content.split('\n');
-  for (const entity of entities) {
-    for (const line of reqLines) {
-      const reqMatch = line.match(/(REQ-\d+)/);
-      if (reqMatch && line.includes(entity.name)) {
-        mappings.push({
-          entity: entity.id,
-          requirement: reqMatch[1]
-        });
-      }
-    }
-  }
-  return { mappings };
-}
-
-function mapTests(entities, projectRoot) {
-  const mappings = [];
-  const testDirs = ['test', 'tests', '__tests__', 'spec'];
-  for (const dir of testDirs) {
-    const testDir = path.join(projectRoot, dir);
-    try {
-      const files = fs.readdirSync(testDir)
-        .filter(f => /\.(test|spec)\.(js|ts|py)$/.test(f));
-      for (const testFile of files) {
-        const content = readFileOrEmpty(
-          path.join(testDir, testFile)
-        );
-        for (const entity of entities) {
-          if (content.includes(entity.name)) {
-            mappings.push({
-              entity: entity.id,
-              testFile: path.join(dir, testFile),
-              testName: ''
-            });
-          }
-        }
-      }
-    } catch { /* no test dir */ }
-  }
-  return { mappings };
-}
-
-function mapDebt(entities, projectRoot) {
-  const debtPath = path.join(
-    projectRoot, '.gsd-t', 'techdebt.md'
-  );
-  const content = readFileOrEmpty(debtPath);
-  const mappings = [];
-  if (!content) return mappings;
-
-  for (const entity of entities) {
-    const lines = content.split('\n');
-    for (const line of lines) {
-      const debtMatch = line.match(/(TD-\d+)/);
-      if (debtMatch && (
-        line.includes(entity.name) ||
-        line.includes(entity.file)
-      )) {
-        mappings.push({
-          id: debtMatch[1],
-          entity: entity.id,
-          description: line.trim()
-        });
-      }
-    }
-  }
-  return mappings;
-}
-
-function detectSurfaces(entities, projectRoot) {
-  const surfaceDirs = {
-    'web': ['web', 'frontend', 'client', 'webapp', 'www'],
-    'mobile': ['mobile', 'app', 'ios', 'android', 'react-native'],
-    'cli': ['cli', 'bin', 'commands'],
-    'api': ['api', 'server', 'backend', 'routes'],
-    'shared': ['shared', 'common', 'lib', 'utils', 'core']
-  };
-
-  const mappings = [];
-  for (const entity of entities) {
-    const surfaces = [];
-    for (const [surface, dirs] of Object.entries(surfaceDirs)) {
-      if (dirs.some(d => entity.file.startsWith(d + '/') ||
-                        entity.file.startsWith(d + '\\'))) {
-        surfaces.push(surface);
-      }
-    }
-    if (surfaces.length > 0) {
-      mappings.push({ entity: entity.id, surfaces });
-    }
-  }
-  return { mappings };
-}
-
-function buildOverlay(projectRoot, entities) {
-  mapDomains(entities, projectRoot);
-  const contracts = mapContracts(entities, projectRoot);
-  const requirements = mapRequirements(entities, projectRoot);
-  const tests = mapTests(entities, projectRoot);
-  const surfaces = detectSurfaces(entities, projectRoot);
-  const debt = mapDebt(entities, projectRoot);
-
-  return { contracts, requirements, tests, surfaces, debt };
-}
-
-module.exports = {
-  buildOverlay, buildDomainMap, mapDomains,
-  mapContracts, mapRequirements, mapTests,
-  mapDebt, detectSurfaces
-};
+'use strict';
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * GSD-T context mapper — enriches code entities with
+ * domain ownership, contract mapping, requirement traceability,
+ * test mapping, debt mapping, and surface detection.
+ */
+
+function readFileOrEmpty(filePath) {
+  try { return fs.readFileSync(filePath, 'utf8'); }
+  catch { return ''; }
+}
+
+function listDirs(dirPath) {
+  try {
+    return fs.readdirSync(dirPath, { withFileTypes: true })
+      .filter(d => d.isDirectory())
+      .map(d => d.name);
+  } catch { return []; }
+}
+
+function buildDomainMap(projectRoot) {
+  const domainsDir = path.join(projectRoot, '.gsd-t', 'domains');
+  const map = {};
+  for (const domain of listDirs(domainsDir)) {
+    const scopePath = path.join(domainsDir, domain, 'scope.md');
+    const content = readFileOrEmpty(scopePath);
+    const fileRefs = [];
+    for (const line of content.split('\n')) {
+      const m = line.match(/[-*]\s+`([^`]+)`/);
+      if (m) fileRefs.push(m[1].replace(/\s*\(.*\)/, '').trim());
+    }
+    map[domain] = fileRefs;
+  }
+  return map;
+}
+
+function mapDomains(entities, projectRoot) {
+  const domainMap = buildDomainMap(projectRoot);
+  for (const entity of entities) {
+    for (const [domain, files] of Object.entries(domainMap)) {
+      if (files.some(f => entity.file.includes(f))) {
+        entity.domain = domain;
+        break;
+      }
+    }
+  }
+}
+
+function mapContracts(entities, projectRoot) {
+  const contractsDir = path.join(
+    projectRoot, '.gsd-t', 'contracts'
+  );
+  const mappings = [];
+  try {
+    const files = fs.readdirSync(contractsDir)
+      .filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const content = readFileOrEmpty(
+        path.join(contractsDir, file)
+      );
+      for (const entity of entities) {
+        if (content.includes(entity.name)) {
+          mappings.push({
+            entity: entity.id,
+            contract: file,
+            section: ''
+          });
+        }
+      }
+    }
+  } catch { /* no contracts dir */ }
+  return { mappings };
+}
+
+function mapRequirements(entities, projectRoot) {
+  const reqPath = path.join(
+    projectRoot, 'docs', 'requirements.md'
+  );
+  const content = readFileOrEmpty(reqPath);
+  const mappings = [];
+  if (!content) return { mappings };
+
+  const reqLines = content.split('\n');
+  for (const entity of entities) {
+    for (const line of reqLines) {
+      const reqMatch = line.match(/(REQ-\d+)/);
+      if (reqMatch && line.includes(entity.name)) {
+        mappings.push({
+          entity: entity.id,
+          requirement: reqMatch[1]
+        });
+      }
+    }
+  }
+  return { mappings };
+}
+
+function mapTests(entities, projectRoot) {
+  const mappings = [];
+  const testDirs = ['test', 'tests', '__tests__', 'spec'];
+  for (const dir of testDirs) {
+    const testDir = path.join(projectRoot, dir);
+    try {
+      const files = fs.readdirSync(testDir)
+        .filter(f => /\.(test|spec)\.(js|ts|py)$/.test(f));
+      for (const testFile of files) {
+        const content = readFileOrEmpty(
+          path.join(testDir, testFile)
+        );
+        for (const entity of entities) {
+          if (content.includes(entity.name)) {
+            mappings.push({
+              entity: entity.id,
+              testFile: path.join(dir, testFile),
+              testName: ''
+            });
+          }
+        }
+      }
+    } catch { /* no test dir */ }
+  }
+  return { mappings };
+}
+
+function mapDebt(entities, projectRoot) {
+  const debtPath = path.join(
+    projectRoot, '.gsd-t', 'techdebt.md'
+  );
+  const content = readFileOrEmpty(debtPath);
+  const mappings = [];
+  if (!content) return mappings;
+
+  for (const entity of entities) {
+    const lines = content.split('\n');
+    for (const line of lines) {
+      const debtMatch = line.match(/(TD-\d+)/);
+      if (debtMatch && (
+        line.includes(entity.name) ||
+        line.includes(entity.file)
+      )) {
+        mappings.push({
+          id: debtMatch[1],
+          entity: entity.id,
+          description: line.trim()
+        });
+      }
+    }
+  }
+  return mappings;
+}
+
+function detectSurfaces(entities, projectRoot) {
+  const surfaceDirs = {
+    'web': ['web', 'frontend', 'client', 'webapp', 'www'],
+    'mobile': ['mobile', 'app', 'ios', 'android', 'react-native'],
+    'cli': ['cli', 'bin', 'commands'],
+    'api': ['api', 'server', 'backend', 'routes'],
+    'shared': ['shared', 'common', 'lib', 'utils', 'core']
+  };
+
+  const mappings = [];
+  for (const entity of entities) {
+    const surfaces = [];
+    for (const [surface, dirs] of Object.entries(surfaceDirs)) {
+      if (dirs.some(d => entity.file.startsWith(d + '/') ||
+                        entity.file.startsWith(d + '\\'))) {
+        surfaces.push(surface);
+      }
+    }
+    if (surfaces.length > 0) {
+      mappings.push({ entity: entity.id, surfaces });
+    }
+  }
+  return { mappings };
+}
+
+function buildOverlay(projectRoot, entities) {
+  mapDomains(entities, projectRoot);
+  const contracts = mapContracts(entities, projectRoot);
+  const requirements = mapRequirements(entities, projectRoot);
+  const tests = mapTests(entities, projectRoot);
+  const surfaces = detectSurfaces(entities, projectRoot);
+  const debt = mapDebt(entities, projectRoot);
+
+  return { contracts, requirements, tests, surfaces, debt };
+}
+
+module.exports = {
+  buildOverlay, buildDomainMap, mapDomains,
+  mapContracts, mapRequirements, mapTests,
+  mapDebt, detectSurfaces
+};