@compilr-dev/sdk 0.2.4 → 0.2.6

package/dist/index.d.ts

@@ -65,5 +65,7 @@ export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permis
 export type { PermissionRule, PermissionMode, PermissionLevel } from './permissions.js';
 export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
 export type { MCPServerEntry, MCPConfigFile, ResolvedMCPServer } from './mcp-config.js';
+export { generateProject, isGitConfigured, generateCompilrMd, generateConfigJson, generateReadmeMd, generateCodingStandardsMd, generatePackageJson, generateTsconfig, generateGitignore, generateCompilrMdForImport, detectProjectInfo, detectGitInfo, prettifyName, getLanguageLabel, getFrameworkLabel, validateImportPath, isValidProjectName, projectExists, TECH_STACK_LABELS, CODING_STANDARDS_LABELS, REPO_PATTERN_LABELS, WORKFLOW_VERSION, } from './project-generator/index.js';
+export type { TechStack, CodingStandards, GeneratorRepoPattern, ProjectConfig, GenerationResult, CompilrConfig, DetectedProject, GitInfo, ImportProjectConfig, } from './project-generator/index.js';
 export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 export { gitStatusTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitStashTool, gitBlameTool, gitFileHistoryTool, detectProjectTool, findProjectRootTool, runTestsTool, runLintTool, runBuildTool, runFormatTool, findDefinitionTool, findReferencesTool, findTodosTool, checkOutdatedTool, findVulnerabilitiesTool, analyzeTestCoverageTool, getFileStructureTool, getComplexityTool, allCodingTools, unifiedTools, } from '@compilr-dev/agents-coding';

package/dist/index.js

@@ -165,6 +165,18 @@ export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permis
 // =============================================================================
 export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
 // =============================================================================
+// Project Generator (templates, scaffolding, detection)
+// =============================================================================
+export { 
+// Generator
+generateProject, isGitConfigured, 
+// Templates
+generateCompilrMd, generateConfigJson, generateReadmeMd, generateCodingStandardsMd, generatePackageJson, generateTsconfig, generateGitignore, generateCompilrMdForImport, 
+// Detection
+detectProjectInfo, detectGitInfo, prettifyName, getLanguageLabel, getFrameworkLabel, validateImportPath, isValidProjectName, projectExists, 
+// Constants
+TECH_STACK_LABELS, CODING_STANDARDS_LABELS, REPO_PATTERN_LABELS, WORKFLOW_VERSION, } from './project-generator/index.js';
+// =============================================================================
 // Individual Tool Re-exports (for consumers that build custom tool registries)
 // =============================================================================
 // Base tools from @compilr-dev/agents

package/dist/platform/sqlite/db.js

@@ -4,6 +4,7 @@
  * Uses better-sqlite3 (optional peer dependency).
  * Consumers must install better-sqlite3 to use the SQLite repositories.
  */
+import { createRequire } from 'module';
 import * as fs from 'fs';
 import * as path from 'path';
 import { SCHEMA_SQL, SCHEMA_VERSION } from './schema.js';
@@ -17,9 +18,10 @@ export function getDatabase(dbPath) {
     const existing = instances.get(dbPath);
     if (existing)
         return existing;
-    // Dynamic require of better-sqlite3 — it's an optional peer dep
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const BetterSqlite3 = require('better-sqlite3');
+    // Dynamic require of better-sqlite3 — it's an optional peer dep.
+    // Use createRequire() for ESM compatibility (works in Node.js and Electron).
+    const esmRequire = createRequire(import.meta.url);
+    const BetterSqlite3 = esmRequire('better-sqlite3');
     // Ensure directory exists
     fs.mkdirSync(path.dirname(dbPath), { recursive: true });
     const db = new BetterSqlite3(dbPath);

package/dist/project-generator/detection.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Project Detection Utilities
+ *
+ * Utilities for detecting project information from an existing directory.
+ * Used by the import project feature.
+ */
+import type { DetectedProject, GitInfo } from './types.js';
+/**
+ * Detect project information from a directory path
+ */
+export declare function detectProjectInfo(projectPath: string): DetectedProject;
+/**
+ * Detect git repository information
+ */
+export declare function detectGitInfo(projectPath: string): GitInfo;
+/**
+ * Convert kebab-case or snake_case to Title Case
+ */
+export declare function prettifyName(name: string): string;
+/**
+ * Get a human-readable label for detected language
+ */
+export declare function getLanguageLabel(language: string | null): string;
+/**
+ * Get a human-readable label for detected framework
+ */
+export declare function getFrameworkLabel(framework: string | null): string;
+/**
+ * Check if a path is a valid directory that can be imported
+ */
+export declare function validateImportPath(importPath: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate project name
+ */
+export declare function isValidProjectName(name: string): boolean;
+/**
+ * Check if project directory already exists
+ */
+export declare function projectExists(name: string, basePath: string): boolean;

package/dist/project-generator/detection.js

@@ -0,0 +1,401 @@
+/**
+ * Project Detection Utilities
+ *
+ * Utilities for detecting project information from an existing directory.
+ * Used by the import project feature.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+const LANGUAGE_MARKERS = [
+    // Node.js / JavaScript / TypeScript
+    {
+        file: 'package.json',
+        language: 'node',
+        packageManager: 'npm',
+        frameworkDetector: (content) => {
+            try {
+                const pkg = JSON.parse(content);
+                const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+                if (deps['next'])
+                    return 'next';
+                if (deps['nuxt'])
+                    return 'nuxt';
+                if (deps['react'])
+                    return 'react';
+                if (deps['vue'])
+                    return 'vue';
+                if (deps['svelte'])
+                    return 'svelte';
+                if (deps['@angular/core'])
+                    return 'angular';
+                if (deps['express'])
+                    return 'express';
+                if (deps['fastify'])
+                    return 'fastify';
+                if (deps['koa'])
+                    return 'koa';
+                if (deps['hono'])
+                    return 'hono';
+                if (deps['electron'])
+                    return 'electron';
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+        nameExtractor: (content) => {
+            try {
+                const pkg = JSON.parse(content);
+                return pkg.name ?? null;
+            }
+            catch {
+                return null;
+            }
+        },
+    },
+    // Go
+    {
+        file: 'go.mod',
+        language: 'go',
+        packageManager: 'go',
+        nameExtractor: (content) => {
+            const match = content.match(/^module\s+(.+)$/m);
+            if (match) {
+                const parts = match[1].split('/');
+                return parts[parts.length - 1];
+            }
+            return null;
+        },
+    },
+    // Python
+    {
+        file: 'pyproject.toml',
+        language: 'python',
+        packageManager: 'pip',
+        frameworkDetector: (content) => {
+            if (content.includes('fastapi'))
+                return 'fastapi';
+            if (content.includes('django'))
+                return 'django';
+            if (content.includes('flask'))
+                return 'flask';
+            return null;
+        },
+        nameExtractor: (content) => {
+            const match = content.match(/^name\s*=\s*["'](.+)["']/m);
+            return match ? match[1] : null;
+        },
+    },
+    {
+        file: 'requirements.txt',
+        language: 'python',
+        packageManager: 'pip',
+        frameworkDetector: (content) => {
+            if (content.includes('fastapi'))
+                return 'fastapi';
+            if (content.includes('django'))
+                return 'django';
+            if (content.includes('flask'))
+                return 'flask';
+            return null;
+        },
+    },
+    {
+        file: 'setup.py',
+        language: 'python',
+        packageManager: 'pip',
+    },
+    // Rust
+    {
+        file: 'Cargo.toml',
+        language: 'rust',
+        packageManager: 'cargo',
+        nameExtractor: (content) => {
+            const match = content.match(/^name\s*=\s*["'](.+)["']/m);
+            return match ? match[1] : null;
+        },
+    },
+    // Java
+    { file: 'pom.xml', language: 'java', packageManager: 'maven' },
+    { file: 'build.gradle', language: 'java', packageManager: 'gradle' },
+    { file: 'build.gradle.kts', language: 'kotlin', packageManager: 'gradle' },
+    // PHP
+    {
+        file: 'composer.json',
+        language: 'php',
+        packageManager: 'composer',
+        frameworkDetector: (content) => {
+            try {
+                const pkg = JSON.parse(content);
+                const deps = pkg.require ?? {};
+                if (deps['laravel/framework'])
+                    return 'laravel';
+                if (deps['symfony/framework-bundle'])
+                    return 'symfony';
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+        nameExtractor: (content) => {
+            try {
+                const pkg = JSON.parse(content);
+                if (pkg.name) {
+                    const parts = pkg.name.split('/');
+                    return parts[parts.length - 1];
+                }
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+    },
+    // Ruby
+    {
+        file: 'Gemfile',
+        language: 'ruby',
+        packageManager: 'bundler',
+        frameworkDetector: (content) => {
+            if (content.includes("'rails'") || content.includes('"rails"'))
+                return 'rails';
+            if (content.includes("'sinatra'") || content.includes('"sinatra"'))
+                return 'sinatra';
+            return null;
+        },
+    },
+    // .NET
+    { file: '*.csproj', language: 'dotnet', packageManager: 'nuget' },
+    { file: '*.fsproj', language: 'dotnet', packageManager: 'nuget' },
+];
+// =============================================================================
+// Main Detection Functions
+// =============================================================================
+/**
+ * Detect project information from a directory path
+ */
+export function detectProjectInfo(projectPath) {
+    const folderName = path.basename(projectPath);
+    const result = {
+        name: folderName,
+        displayName: prettifyName(folderName),
+        nameSource: 'folder',
+        language: null,
+        framework: null,
+        packageManager: null,
+        hasGit: false,
+        gitRemote: null,
+        gitBranch: null,
+        hasCompilrMd: false,
+        hasClaudeMd: false,
+    };
+    // Check for COMPILR.md and CLAUDE.md
+    result.hasCompilrMd = fs.existsSync(path.join(projectPath, 'COMPILR.md'));
+    result.hasClaudeMd = fs.existsSync(path.join(projectPath, 'CLAUDE.md'));
+    // Detect git info
+    const gitInfo = detectGitInfo(projectPath);
+    result.hasGit = gitInfo.hasGit;
+    result.gitRemote = gitInfo.remote;
+    result.gitBranch = gitInfo.branch;
+    // Detect language and framework from markers
+    for (const marker of LANGUAGE_MARKERS) {
+        let filePath = null;
+        if (marker.file.includes('*')) {
+            const pattern = marker.file.replace('*', '');
+            try {
+                const files = fs.readdirSync(projectPath);
+                const match = files.find((f) => f.endsWith(pattern));
+                if (match) {
+                    filePath = path.join(projectPath, match);
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        else {
+            filePath = path.join(projectPath, marker.file);
+        }
+        if (filePath && fs.existsSync(filePath)) {
+            if (!result.language) {
+                result.language = marker.language;
+            }
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                if (marker.nameExtractor && result.nameSource === 'folder') {
+                    const extractedName = marker.nameExtractor(content);
+                    if (extractedName) {
+                        result.name = extractedName;
+                        result.displayName = prettifyName(extractedName);
+                        result.nameSource = marker.file;
+                    }
+                }
+                if (!result.framework && marker.frameworkDetector) {
+                    result.framework = marker.frameworkDetector(content);
+                }
+                if (!result.packageManager && marker.packageManager) {
+                    result.packageManager = marker.packageManager;
+                }
+            }
+            catch {
+                // File read failed, continue
+            }
+        }
+    }
+    // Detect package manager overrides for Node.js
+    if (result.language === 'node') {
+        if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
+            result.packageManager = 'pnpm';
+        }
+        else if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
+            result.packageManager = 'yarn';
+        }
+        else if (fs.existsSync(path.join(projectPath, 'bun.lockb'))) {
+            result.packageManager = 'bun';
+        }
+    }
+    // Detect package manager overrides for Python
+    if (result.language === 'python') {
+        if (fs.existsSync(path.join(projectPath, 'poetry.lock'))) {
+            result.packageManager = 'poetry';
+        }
+        else if (fs.existsSync(path.join(projectPath, 'pdm.lock'))) {
+            result.packageManager = 'pdm';
+        }
+        else if (fs.existsSync(path.join(projectPath, 'uv.lock'))) {
+            result.packageManager = 'uv';
+        }
+    }
+    return result;
+}
+/**
+ * Detect git repository information
+ */
+export function detectGitInfo(projectPath) {
+    const result = {
+        hasGit: false,
+        remote: null,
+        branch: null,
+    };
+    const gitPath = path.join(projectPath, '.git');
+    if (!fs.existsSync(gitPath)) {
+        return result;
+    }
+    result.hasGit = true;
+    try {
+        const remote = execSync('git remote get-url origin', {
+            cwd: projectPath,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (remote) {
+            result.remote = remote;
+        }
+    }
+    catch {
+        // No remote configured
+    }
+    try {
+        const branch = execSync('git branch --show-current', {
+            cwd: projectPath,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (branch) {
+            result.branch = branch;
+        }
+    }
+    catch {
+        // Detached HEAD or git command failed
+    }
+    return result;
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Convert kebab-case or snake_case to Title Case
+ */
+export function prettifyName(name) {
+    return name.replace(/[-_]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * Get a human-readable label for detected language
+ */
+export function getLanguageLabel(language) {
+    if (!language)
+        return 'Unknown';
+    const labels = {
+        node: 'Node.js / TypeScript',
+        go: 'Go',
+        python: 'Python',
+        rust: 'Rust',
+        java: 'Java',
+        kotlin: 'Kotlin',
+        php: 'PHP',
+        ruby: 'Ruby',
+        dotnet: '.NET (C#/F#)',
+    };
+    return labels[language] ?? language;
+}
+/**
+ * Get a human-readable label for detected framework
+ */
+export function getFrameworkLabel(framework) {
+    if (!framework)
+        return 'Not detected';
+    const labels = {
+        react: 'React',
+        vue: 'Vue.js',
+        svelte: 'Svelte',
+        angular: 'Angular',
+        next: 'Next.js',
+        nuxt: 'Nuxt.js',
+        express: 'Express.js',
+        fastify: 'Fastify',
+        koa: 'Koa',
+        hono: 'Hono',
+        electron: 'Electron',
+        fastapi: 'FastAPI',
+        django: 'Django',
+        flask: 'Flask',
+        rails: 'Ruby on Rails',
+        sinatra: 'Sinatra',
+        laravel: 'Laravel',
+        symfony: 'Symfony',
+    };
+    return labels[framework] ?? framework;
+}
+/**
+ * Check if a path is a valid directory that can be imported
+ */
+export function validateImportPath(importPath) {
+    if (!fs.existsSync(importPath)) {
+        return { valid: false, error: 'Path does not exist' };
+    }
+    try {
+        const stats = fs.statSync(importPath);
+        if (!stats.isDirectory()) {
+            return { valid: false, error: 'Path is not a directory' };
+        }
+    }
+    catch {
+        return { valid: false, error: 'Cannot access path' };
+    }
+    return { valid: true };
+}
+/**
+ * Validate project name
+ */
+export function isValidProjectName(name) {
+    return /^[a-z][a-z0-9-]{1,49}$/.test(name);
+}
+/**
+ * Check if project directory already exists
+ */
+export function projectExists(name, basePath) {
+    return fs.existsSync(path.join(basePath, name));
+}

package/dist/project-generator/generator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Project Generator
+ *
+ * Main module for generating project scaffolding.
+ */
+import type { ProjectConfig, GenerationResult } from './types.js';
+/**
+ * Generate a new project from configuration
+ */
+export declare function generateProject(config: ProjectConfig, basePath: string): GenerationResult;
+/**
+ * Check if git user.name and user.email are configured
+ */
+export declare function isGitConfigured(): boolean;