devchain-cli 0.11.4 → 0.12.0

package/dist/server/modules/codebase-overview-analyzer/repositories/overview-scope.repository.js

@@ -0,0 +1,188 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OverviewScopeRepository = void 0;
+const common_1 = require("@nestjs/common");
+const promises_1 = require("fs/promises");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+const settings_service_1 = require("../../settings/services/settings.service");
+const db_provider_1 = require("../../storage/db/db.provider");
+const sqlite_raw_1 = require("../../storage/db/sqlite-raw");
+const better_sqlite3_1 = require("drizzle-orm/better-sqlite3");
+const scope_schema_1 = require("../types/scope.schema");
+const logger_1 = require("../../../common/logging/logger");
+const logger = (0, logger_1.createLogger)('OverviewScopeRepository');
+const SETTINGS_KEY = 'codebaseScope.projects';
+const CONFIG_DIR = '.devchain';
+const CONFIG_FILE = 'overview.json';
+let OverviewScopeRepository = class OverviewScopeRepository {
+    constructor(settingsService, db) {
+        this.settingsService = settingsService;
+        this.db = db;
+        this.sqlite = (0, sqlite_raw_1.getRawSqliteClient)(db);
+    }
+    readUserEntries(projectRoot, projectId) {
+        const repoFilePath = this.getRepoFilePath(projectRoot);
+        if ((0, fs_1.existsSync)(repoFilePath)) {
+            return this.readFromRepoFile(repoFilePath);
+        }
+        return this.readFromSqlite(projectId);
+    }
+    async writeUserEntries(projectRoot, projectId, entries) {
+        const repoFilePath = this.getRepoFilePath(projectRoot);
+        if ((0, fs_1.existsSync)(repoFilePath)) {
+            await this.writeToRepoFile(projectRoot, repoFilePath, entries);
+        }
+        else {
+            this.writeToSqlite(projectId, entries);
+        }
+    }
+    getStorageMode(projectRoot) {
+        return (0, fs_1.existsSync)(this.getRepoFilePath(projectRoot)) ? 'repo-file' : 'local-only';
+    }
+    getRepoFilePath(projectRoot) {
+        return (0, path_1.join)(projectRoot, CONFIG_DIR, CONFIG_FILE);
+    }
+    readFromRepoFile(filePath) {
+        try {
+            const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+            const result = scope_schema_1.ScopeConfigSchema.safeParse(JSON.parse(content));
+            if (!result.success) {
+                logger.warn({ filePath, issues: result.error.issues }, 'Repo scope file failed validation');
+                return [];
+            }
+            return result.data.entries;
+        }
+        catch (error) {
+            logger.warn({ error, filePath }, 'Failed to read repo scope file');
+            return [];
+        }
+    }
+    readFromSqlite(projectId) {
+        const raw = this.settingsService.getSetting(SETTINGS_KEY);
+        if (!raw)
+            return [];
+        try {
+            const map = JSON.parse(raw);
+            const rawEntries = map[projectId];
+            if (!Array.isArray(rawEntries))
+                return [];
+            const valid = [];
+            for (const entry of rawEntries) {
+                const result = scope_schema_1.FolderScopeEntrySchema.safeParse(entry);
+                if (result.success) {
+                    valid.push(result.data);
+                }
+                else {
+                    logger.warn({ projectId, entry, issues: result.error.issues }, 'Dropping invalid SQLite scope entry');
+                }
+            }
+            return valid;
+        }
+        catch (error) {
+            logger.warn({ error, projectId }, 'Failed to parse SQLite scope data');
+            return [];
+        }
+    }
+    async writeToRepoFile(projectRoot, filePath, entries) {
+        const configDir = (0, path_1.join)(projectRoot, CONFIG_DIR);
+        const validatedDir = this.validatePath(configDir, projectRoot);
+        const validatedFile = this.validatePath(filePath, projectRoot);
+        try {
+            if (!(0, fs_1.existsSync)(validatedDir)) {
+                await (0, promises_1.mkdir)(validatedDir, { recursive: true });
+            }
+            const tmpPath = validatedFile + '.tmp';
+            const content = JSON.stringify({ schemaVersion: 1, entries }, null, 2);
+            await (0, promises_1.writeFile)(tmpPath, content, 'utf-8');
+            await (0, promises_1.rename)(tmpPath, validatedFile);
+            logger.info({ filePath: validatedFile }, 'Scope config written to repo file');
+        }
+        catch (error) {
+            throw this.shapeWriteError(error, validatedFile);
+        }
+    }
+    writeToSqlite(projectId, entries) {
+        const raw = this.settingsService.getSetting(SETTINGS_KEY);
+        let map = {};
+        try {
+            if (raw)
+                map = JSON.parse(raw);
+        }
+        catch {
+            map = {};
+        }
+        map[projectId] = entries;
+        const now = new Date().toISOString();
+        this.sqlite
+            .prepare(`INSERT INTO settings (id, key, value, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?)
+         ON CONFLICT(key) DO UPDATE SET
+           value = excluded.value,
+           updated_at = excluded.updated_at`)
+            .run((0, crypto_1.randomUUID)(), SETTINGS_KEY, JSON.stringify(map), now, now);
+        logger.info({ projectId }, 'Scope config written to SQLite');
+    }
+    validatePath(targetPath, projectRoot) {
+        const resolved = (0, path_1.resolve)(targetPath);
+        const resolvedRoot = (0, path_1.resolve)(projectRoot);
+        const rel = (0, path_1.relative)(resolvedRoot, resolved);
+        if (rel.startsWith('..')) {
+            throw {
+                code: 'INVALID_PATH',
+                message: `Path escapes project root: ${targetPath}`,
+            };
+        }
+        return resolved;
+    }
+    shapeWriteError(err, filePath) {
+        const manualEditPath = filePath;
+        if (err.code === 'EACCES') {
+            return {
+                code: 'PERMISSION_DENIED',
+                message: `Permission denied writing to ${filePath}. Check file/directory permissions.`,
+                manualEditPath,
+            };
+        }
+        if (err.code === 'EROFS') {
+            return {
+                code: 'READ_ONLY_FILESYSTEM',
+                message: `Filesystem is read-only. Cannot write to ${filePath}.`,
+                manualEditPath,
+            };
+        }
+        if (err.code === 'ENOSPC') {
+            return {
+                code: 'DISK_FULL',
+                message: `Disk full. Cannot write to ${filePath}.`,
+                manualEditPath,
+            };
+        }
+        return {
+            code: 'PERMISSION_DENIED',
+            message: `Failed to write scope config: ${err.message}`,
+            manualEditPath,
+        };
+    }
+};
+exports.OverviewScopeRepository = OverviewScopeRepository;
+exports.OverviewScopeRepository = OverviewScopeRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(db_provider_1.DB_CONNECTION)),
+    __metadata("design:paramtypes", [settings_service_1.SettingsService,
+        better_sqlite3_1.BetterSQLite3Database])
+], OverviewScopeRepository);
+//# sourceMappingURL=overview-scope.repository.js.map

package/dist/server/modules/codebase-overview-analyzer/repositories/overview-scope.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview-scope.repository.js","sourceRoot":"","sources":["../../../../src/modules/codebase-overview-analyzer/repositories/overview-scope.repository.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/codebase-overview-analyzer/services/codebase-overview-analyzer.service.d.ts

@@ -0,0 +1,71 @@
+import type { CodebaseOverviewSnapshot, RegionNode, DistrictNode, TargetDetail, DependencyPairDetail, DistrictFilePage } from '@devchain/codebase-overview';
+import { IdentityResolverService } from './identity-resolver.service';
+import { HotspotScoringService } from './hotspot-scoring.service';
+import { DistrictSplittingService } from './district-splitting.service';
+import { DependencyAggregationService } from './dependency-aggregation.service';
+import { EvidenceQueryService } from './evidence-query.service';
+import { LanguageAdapterRegistryService } from './language-adapter-registry.service';
+import { ScopeResolverService } from './scope-resolver.service';
+import { ScopeAutoDetectorService } from './scope-auto-detector.service';
+import { OverviewScopeRepository } from '../repositories/overview-scope.repository';
+interface ScannedFile {
+    path: string;
+    loc: number;
+    lastModified: number;
+}
+interface RepoCapabilities {
+    isGitRepo: boolean;
+    isShallow: boolean;
+    totalCommits: number;
+    oldestCommitTimestamp: number | null;
+    gitHistoryDays: number | null;
+}
+interface SegmentResult {
+    regions: RegionNode[];
+    districts: DistrictNode[];
+    districtFileMap: Map<string, string[]>;
+}
+export declare class CodebaseOverviewAnalyzerService {
+    private readonly identityResolver;
+    private readonly hotspotScoring;
+    private readonly districtSplitting;
+    private readonly dependencyAggregation;
+    private readonly evidenceQuery;
+    private readonly adapterRegistry;
+    private readonly scopeResolver;
+    private readonly scopeAutoDetector;
+    private readonly scopeRepository;
+    private readonly identityStore;
+    private readonly queryStore;
+    constructor(identityResolver: IdentityResolverService, hotspotScoring: HotspotScoringService, districtSplitting: DistrictSplittingService, dependencyAggregation: DependencyAggregationService, evidenceQuery: EvidenceQueryService, adapterRegistry: LanguageAdapterRegistryService, scopeResolver: ScopeResolverService, scopeAutoDetector: ScopeAutoDetectorService, scopeRepository: OverviewScopeRepository);
+    getSnapshot(projectPath: string, projectId: string): Promise<CodebaseOverviewSnapshot>;
+    getTargetDetails(projectPath: string, targetId: string): Promise<TargetDetail | null>;
+    getDependencyPairDetails(projectPath: string, fromDistrictId: string, toDistrictId: string): DependencyPairDetail | null;
+    listDistrictFiles(projectPath: string, districtId: string, cursor?: string): DistrictFilePage | null;
+    private execGit;
+    private getRecentCommits;
+    private getTopAuthors;
+    private buildExemplarEdges;
+    getFileAuthorMap(projectPath: string): Promise<Map<string, Map<string, number>>>;
+    detectCapabilities(projectPath: string): Promise<RepoCapabilities>;
+    private extractObservedFolders;
+    private scanFiles;
+    private listGitFiles;
+    private listFsFiles;
+    private getLocMap;
+    private computeFallbackLineCounts;
+    private getChurnMap;
+    private getDailyChurnMap;
+    private getWindowedAuthorMap;
+    private static readonly GLOBAL_CONTRIBUTORS_CAP;
+    private buildGlobalContributors;
+    private computeExcludedAuthorCount;
+    segmentFiles(files: ScannedFile[]): SegmentResult;
+    private getCurrentCommitSha;
+    private detectGitRenames;
+    private storeIdentityState;
+    private buildWarnings;
+    private analyzeWithAdapters;
+    private computeMetrics;
+}
+export {};