@unrdf/project-engine 5.0.1 → 26.4.2

package/src/project-engine/metrics.mjs

@@ -1,146 +0,0 @@
-/**
- * @file Metrics Collection - Gather and report project metrics
- * @module @unrdf/project-engine/metrics
- */
-
-import { z } from 'zod';
-import { analyzePackage } from './code-analyzer.mjs';
-import { listPackages } from './build-utils.mjs';
-
-/**
- * Project metrics schema
- */
-const ProjectMetricsSchema = z.object({
-  timestamp: z.string(),
-  totalPackages: z.number(),
-  totalLinesOfCode: z.number(),
-  totalExports: z.number(),
-  averageTestCoverage: z.number().min(0).max(100),
-  packages: z.array(
-    z.object({
-      name: z.string(),
-      linesOfCode: z.number(),
-      exportCount: z.number(),
-      testCoverage: z.number(),
-      complexity: z.enum(['low', 'medium', 'high']),
-    })
-  ),
-});
-
-/**
- * Collect metrics for all packages in monorepo
- * @param {string} [monorepoPath='.'] - Path to monorepo root
- * @returns {Promise<Object>} Comprehensive metrics data
- *
- * @throws {TypeError} If monorepoPath is not a string
- * @throws {Error} If metrics collection fails
- *
- * @example
- * const metrics = await collectMetrics('.');
- * console.log('Total packages:', metrics.totalPackages);
- * console.log('Average coverage:', metrics.averageTestCoverage);
- */
-export async function collectMetrics(monorepoPath = '.') {
-  if (typeof monorepoPath !== 'string') {
-    throw new TypeError('collectMetrics: monorepoPath must be a string');
-  }
-
-  try {
-    const packages = await listPackages(monorepoPath);
-
-    let totalLinesOfCode = 0;
-    let totalExports = 0;
-    let totalCoverage = 0;
-    const packageMetrics = [];
-
-    for (const pkg of packages) {
-      try {
-        const analysis = await analyzePackage(pkg.path);
-
-        totalLinesOfCode += analysis.linesOfCode;
-        totalExports += analysis.exportCount;
-        totalCoverage += analysis.testCoverage;
-
-        packageMetrics.push({
-          name: analysis.name,
-          linesOfCode: analysis.linesOfCode,
-          exportCount: analysis.exportCount,
-          testCoverage: analysis.testCoverage,
-          complexity: analysis.complexity,
-        });
-      } catch (error) {
-        // Skip packages that fail analysis
-        console.error(`Failed to analyze ${pkg.name}: ${error.message}`);
-      }
-    }
-
-    const averageTestCoverage =
-      packageMetrics.length > 0 ? Math.round(totalCoverage / packageMetrics.length) : 0;
-
-    const metrics = {
-      timestamp: new Date().toISOString(),
-      totalPackages: packageMetrics.length,
-      totalLinesOfCode,
-      totalExports,
-      averageTestCoverage,
-      packages: packageMetrics,
-    };
-
-    return ProjectMetricsSchema.parse(metrics);
-  } catch (error) {
-    throw new Error(`collectMetrics failed: ${error.message}`);
-  }
-}
-
-/**
- * Format metrics as human-readable report
- * @param {Object} metrics - Metrics data from collectMetrics
- * @returns {string} Formatted text report
- *
- * @throws {TypeError} If metrics is not an object
- *
- * @example
- * const metrics = await collectMetrics();
- * const report = reportMetrics(metrics);
- * console.log(report);
- */
-export function reportMetrics(metrics) {
-  if (typeof metrics !== 'object' || metrics === null) {
-    throw new TypeError('reportMetrics: metrics must be an object');
-  }
-
-  const lines = [];
-
-  lines.push('='.repeat(60));
-  lines.push('PROJECT METRICS REPORT');
-  lines.push('='.repeat(60));
-  lines.push('');
-  lines.push(`Generated: ${new Date(metrics.timestamp).toLocaleString()}`);
-  lines.push('');
-  lines.push('OVERVIEW');
-  lines.push('-'.repeat(60));
-  lines.push(`Total Packages:        ${metrics.totalPackages}`);
-  lines.push(`Total Lines of Code:   ${metrics.totalLinesOfCode.toLocaleString()}`);
-  lines.push(`Total Exports:         ${metrics.totalExports}`);
-  lines.push(`Average Test Coverage: ${metrics.averageTestCoverage}%`);
-  lines.push('');
-  lines.push('PACKAGE BREAKDOWN');
-  lines.push('-'.repeat(60));
-  lines.push('');
-
-  // Sort packages by lines of code descending
-  const sorted = [...metrics.packages].sort((a, b) => b.linesOfCode - a.linesOfCode);
-
-  for (const pkg of sorted) {
-    lines.push(`Package: ${pkg.name}`);
-    lines.push(`  Lines of Code:   ${pkg.linesOfCode.toLocaleString()}`);
-    lines.push(`  Exports:         ${pkg.exportCount}`);
-    lines.push(`  Test Coverage:   ${pkg.testCoverage}%`);
-    lines.push(`  Complexity:      ${pkg.complexity}`);
-    lines.push('');
-  }
-
-  lines.push('='.repeat(60));
-
-  return lines.join('\n');
-}

package/src/project-model.mjs

@@ -1,111 +0,0 @@
-/**
- * @file Project model builder - convert FS graph to project structure
- * @module project-engine/project-model
- */
-
-import { UnrdfDataFactory as DataFactory } from '@unrdf/core/rdf/n3-justified-only';
-import { z } from 'zod';
-
-const { namedNode, literal } = DataFactory;
-
-const ProjectModelOptionsSchema = z.object({
-  fsStore: z.custom(val => val && typeof val.getQuads === 'function', {
-    message: 'fsStore must be an RDF store with getQuads method',
-  }),
-  baseIri: z.string().default('http://example.org/unrdf/project#'),
-  conventions: z
-    .object({
-      sourcePaths: z.array(z.string()).default(['src']),
-      featurePaths: z.array(z.string()).default(['features', 'modules']),
-      testPaths: z.array(z.string()).default(['__tests__', 'test', 'tests', 'spec']),
-    })
-    .optional(),
-});
-
-/**
- * Build project model from filesystem graph
- *
- * @param {Object} options
- * @param {Store} options.fsStore - FS store from scanFileSystemToStore
- * @param {string} [options.baseIri] - Base IRI for project resources
- * @param {Object} [options.conventions] - Naming conventions
- * @returns {Store} Enhanced store with project structure
- */
-export function buildProjectModelFromFs(options) {
-  const validated = ProjectModelOptionsSchema.parse(options);
-  const { fsStore, baseIri, conventions } = validated;
-
-  const store = fsStore;
-  const projectIri = namedNode(`${baseIri}project`);
-
-  store.addQuad(
-    projectIri,
-    namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'),
-    namedNode('http://example.org/unrdf/project#Project')
-  );
-
-  const features = extractFeatures(store, baseIri, conventions);
-
-  for (const [featureName, feature] of Object.entries(features)) {
-    const featureIri = namedNode(`${baseIri}feature/${encodeURIComponent(featureName)}`);
-
-    store.addQuad(projectIri, namedNode('http://example.org/unrdf/project#hasFeature'), featureIri);
-    store.addQuad(
-      featureIri,
-      namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'),
-      namedNode('http://example.org/unrdf/project#Feature')
-    );
-    store.addQuad(
-      featureIri,
-      namedNode('http://www.w3.org/2000/01/rdf-schema#label'),
-      literal(featureName)
-    );
-
-    for (const filePath of feature.files) {
-      const fileIri = namedNode(`http://example.org/unrdf/fs#${encodeURIComponent(filePath)}`);
-      store.addQuad(
-        fileIri,
-        namedNode('http://example.org/unrdf/project#belongsToFeature'),
-        featureIri
-      );
-    }
-  }
-
-  return store;
-}
-
-/**
- * Extract features from directory structure
- *
- * @private
- */
-function extractFeatures(store, baseIri, conventions) {
-  const features = {};
-  const sourcePaths = conventions?.sourcePaths || ['src'];
-
-  const fileQuads = store.getQuads(
-    null,
-    namedNode('http://example.org/unrdf/filesystem#relativePath'),
-    null
-  );
-
-  for (const quad of fileQuads) {
-    const filePath = quad.object.value;
-    const inSourcePath = sourcePaths.some(
-      srcPath => filePath.startsWith(srcPath + '/') || filePath === srcPath
-    );
-
-    if (inSourcePath) {
-      const match = filePath.match(/^src\/([^/]+)/);
-      if (match) {
-        const featureName = match[1];
-        if (!features[featureName]) {
-          features[featureName] = { files: [] };
-        }
-        features[featureName].files.push(filePath);
-      }
-    }
-  }
-
-  return features;
-}

package/src/project-report.mjs

@@ -1,348 +0,0 @@
-/**
- * @file Project report generator - convert ontology to human-readable summary
- * @module project-engine/project-report
- */
-
-import { UnrdfDataFactory as DataFactory } from '@unrdf/core/rdf/n3-justified-only';
-import { z } from 'zod';
-
-const { namedNode } = DataFactory;
-
-const ProjectReportOptionsSchema = z.object({
-  baseIri: z.string().optional(),
-  includeFileList: z.boolean().optional(),
-});
-
-/**
- * @typedef {Object} FeatureReport
- * @property {string} iri - Feature IRI
- * @property {string} name - Feature name
- * @property {{view: boolean, api: boolean, schema: boolean, test: boolean, doc: boolean}} roles - Role presence
- * @property {number} fileCount - Number of files in feature
- * @property {number} testCoverage - Estimated test coverage percentage
- * @property {boolean} hasMissingTests - Whether feature lacks tests
- */
-
-/**
- * @typedef {Object} DomainEntity
- * @property {string} name - Entity name
- * @property {number} fieldCount - Number of fields
- * @property {boolean} hasView - Has view component
- * @property {boolean} hasApi - Has API endpoint
- */
-
-/**
- * @typedef {Object} ProjectStats
- * @property {number} featureCount - Total features
- * @property {number} totalFiles - Total files
- * @property {number} testCoverageAverage - Average test coverage
- * @property {Record<string, number>} filesByRole - Files grouped by role
- */
-
-/**
- * @typedef {Object} ProjectReport
- * @property {FeatureReport[]} features - Feature reports
- * @property {string} stackProfile - Detected stack profile string
- * @property {ProjectStats} stats - Project statistics
- * @property {DomainEntity[]} domainEntities - Domain entities
- * @property {string} summary - Human-readable summary
- */
-
-const NS = {
-  rdf: 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',
-  rdfs: 'http://www.w3.org/2000/01/rdf-schema#',
-  fs: 'http://example.org/unrdf/filesystem#',
-  proj: 'http://example.org/unrdf/project#',
-};
-
-/**
- * Build human-readable project report from ontology store
- *
- * @param {Object} projectStore - N3 Store with project ontology
- * @param {Object} [options] - Report options
- * @returns {ProjectReport}
- */
-export function buildProjectReport(projectStore, options = {}) {
-  const validatedOptions = ProjectReportOptionsSchema.parse(options);
-  const store = projectStore;
-  const baseIri = validatedOptions.baseIri || 'http://example.org/unrdf/project#';
-
-  const features = extractFeatureReports(store, baseIri);
-  const stackProfile = buildStackProfile(store);
-  const stats = computeStats(store, features);
-  const domainEntities = extractDomainEntities(store, features);
-  const summary = generateSummary(features, stats, stackProfile);
-
-  return {
-    features,
-    stackProfile,
-    stats,
-    domainEntities,
-    summary,
-  };
-}
-
-/**
- * Extract feature reports from store
- *
- * @param {Object} store - N3 Store
- * @param {string} baseIri - Base IRI
- * @returns {FeatureReport[]}
- */
-function extractFeatureReports(store, _baseIri) {
-  const features = [];
-
-  const featureQuads = store.getQuads(
-    null,
-    namedNode(`${NS.rdf}type`),
-    namedNode(`${NS.proj}Feature`)
-  );
-
-  for (const quad of featureQuads) {
-    const featureIri = quad.subject.value;
-    const labelQuads = store.getQuads(quad.subject, namedNode(`${NS.rdfs}label`), null);
-    const name =
-      labelQuads.length > 0 ? labelQuads[0].object.value : extractNameFromIri(featureIri);
-
-    const fileQuads = store.getQuads(null, namedNode(`${NS.proj}belongsToFeature`), quad.subject);
-    const fileCount = fileQuads.length;
-
-    const roles = countRolesForFeature(store, fileQuads);
-    const hasTests = roles.test > 0;
-    const testCoverage =
-      fileCount > 0 && hasTests
-        ? Math.min(100, Math.round((roles.test / (fileCount - roles.test)) * 100))
-        : 0;
-
-    features.push({
-      iri: featureIri,
-      name,
-      roles: {
-        view: roles.component > 0 || roles.page > 0,
-        api: roles.api > 0,
-        schema: roles.schema > 0,
-        test: roles.test > 0,
-        doc: roles.doc > 0,
-      },
-      fileCount,
-      testCoverage,
-      hasMissingTests: !hasTests && fileCount > 0,
-    });
-  }
-
-  return features.sort((a, b) => a.name.localeCompare(b.name));
-}
-
-/**
- * Count roles for files in a feature
- *
- * @param {Object} store - N3 Store
- * @param {Array} fileQuads - File quads belonging to feature
- * @returns {Object} Role counts
- */
-function countRolesForFeature(store, fileQuads) {
-  const counts = {
-    component: 0,
-    page: 0,
-    api: 0,
-    schema: 0,
-    test: 0,
-    doc: 0,
-    hook: 0,
-    service: 0,
-    state: 0,
-    config: 0,
-    other: 0,
-  };
-
-  for (const fq of fileQuads) {
-    const roleQuads = store.getQuads(fq.subject, namedNode(`${NS.proj}roleString`), null);
-
-    for (const rq of roleQuads) {
-      const role = rq.object.value.toLowerCase();
-      if (counts[role] !== undefined) {
-        counts[role]++;
-      } else {
-        counts.other++;
-      }
-    }
-  }
-
-  return counts;
-}
-
-/**
- * Build stack profile string
- *
- * @param {Object} store - N3 Store
- * @returns {string}
- */
-function buildStackProfile(store) {
-  const parts = [];
-
-  const stackQuads = store.getQuads(null, namedNode(`${NS.proj}hasStack`), null);
-
-  if (stackQuads.length > 0) {
-    for (const sq of stackQuads) {
-      parts.push(sq.object.value);
-    }
-  }
-
-  if (parts.length === 0) {
-    const filePaths = new Set();
-    const pathQuads = store.getQuads(null, namedNode(`${NS.fs}relativePath`), null);
-    for (const pq of pathQuads) {
-      filePaths.add(pq.object.value);
-    }
-
-    if (filePaths.has('next.config.js') || filePaths.has('next.config.mjs')) {
-      if (filePaths.has('src/app') || [...filePaths].some(p => p.startsWith('src/app/'))) {
-        parts.push('react-next-app-router');
-      } else {
-        parts.push('react-next-pages');
-      }
-    }
-    if (filePaths.has('nest-cli.json')) {
-      parts.push('nest');
-    }
-    if (filePaths.has('vitest.config.js') || filePaths.has('vitest.config.mjs')) {
-      parts.push('vitest');
-    } else if (filePaths.has('jest.config.js')) {
-      parts.push('jest');
-    }
-  }
-
-  return parts.join(' + ') || 'unknown';
-}
-
-/**
- * Compute project statistics
- *
- * @param {Object} store - N3 Store
- * @param {FeatureReport[]} features - Feature reports
- * @returns {ProjectStats}
- */
-function computeStats(store, features) {
-  const roleQuads = store.getQuads(null, namedNode(`${NS.proj}roleString`), null);
-
-  const filesByRole = {};
-  for (const rq of roleQuads) {
-    const role = rq.object.value;
-    filesByRole[role] = (filesByRole[role] || 0) + 1;
-  }
-
-  const pathQuads = store.getQuads(null, namedNode(`${NS.fs}relativePath`), null);
-  const totalFiles = pathQuads.length;
-
-  const coverages = features.filter(f => f.fileCount > 0).map(f => f.testCoverage);
-  const testCoverageAverage =
-    coverages.length > 0 ? Math.round(coverages.reduce((a, b) => a + b, 0) / coverages.length) : 0;
-
-  return {
-    featureCount: features.length,
-    totalFiles,
-    testCoverageAverage,
-    filesByRole,
-  };
-}
-
-/**
- * Extract domain entities from features
- *
- * @param {Object} store - N3 Store
- * @param {FeatureReport[]} features - Feature reports
- * @returns {DomainEntity[]}
- */
-function extractDomainEntities(store, features) {
-  const entities = [];
-
-  const allRoleQuads = store.getQuads(null, namedNode(`${NS.proj}roleString`), null);
-  const schemaQuads = allRoleQuads.filter(q => q.object.value === 'Schema');
-
-  for (const sq of schemaQuads) {
-    const pathQuads = store.getQuads(sq.subject, namedNode(`${NS.fs}relativePath`), null);
-
-    if (pathQuads.length > 0) {
-      const filePath = pathQuads[0].object.value;
-      const nameMatch = filePath.match(/([A-Z][a-z]+(?:[A-Z][a-z]+)*)/);
-      const name = nameMatch ? nameMatch[1] : extractNameFromPath(filePath);
-
-      const featureMatch = features.find(
-        f => filePath.includes(f.name) || f.name.toLowerCase() === name.toLowerCase()
-      );
-
-      entities.push({
-        name,
-        fieldCount: 8,
-        hasView: featureMatch?.roles.view || false,
-        hasApi: featureMatch?.roles.api || false,
-      });
-    }
-  }
-
-  const seen = new Set();
-  return entities.filter(e => {
-    if (seen.has(e.name)) return false;
-    seen.add(e.name);
-    return true;
-  });
-}
-
-/**
- * Generate human-readable summary
- *
- * @param {FeatureReport[]} features - Feature reports
- * @param {ProjectStats} stats - Stats
- * @param {string} stackProfile - Stack profile
- * @returns {string}
- */
-function generateSummary(features, stats, _stackProfile) {
-  const parts = [];
-
-  const structure =
-    stats.featureCount > 10 ? 'Large' : stats.featureCount > 5 ? 'Well-structured' : 'Compact';
-  parts.push(`${structure} ${stats.featureCount}-feature project`);
-
-  if (stats.testCoverageAverage > 0) {
-    parts[0] += ` with ${stats.testCoverageAverage}% test coverage`;
-  }
-
-  const missingTests = features.filter(f => f.hasMissingTests).map(f => f.name);
-  if (missingTests.length > 0 && missingTests.length <= 3) {
-    parts.push(`Missing tests: ${missingTests.join(', ')}`);
-  } else if (missingTests.length > 3) {
-    parts.push(
-      `Missing tests: ${missingTests.slice(0, 2).join(', ')} and ${missingTests.length - 2} more`
-    );
-  }
-
-  const missingDocs = features.filter(f => !f.roles.doc && f.fileCount > 3).map(f => f.name);
-  if (missingDocs.length > 0 && missingDocs.length <= 2) {
-    parts.push(`Consider docs for: ${missingDocs.join(', ')}`);
-  }
-
-  return parts.join('. ') + '.';
-}
-
-/**
- * Extract name from IRI
- *
- * @param {string} iri - Feature IRI
- * @returns {string}
- */
-function extractNameFromIri(iri) {
-  const match = iri.match(/\/([^/]+)$/);
-  return match ? decodeURIComponent(match[1]) : 'unknown';
-}
-
-/**
- * Extract name from file path
- *
- * @param {string} filePath - File path
- * @returns {string}
- */
-function extractNameFromPath(filePath) {
-  const parts = filePath.split('/');
-  const fileName = parts[parts.length - 1];
-  return fileName.replace(/\.(tsx?|jsx?|mjs|json)$/, '');
-}