@sashabogi/foundation 0.1.5 → 0.1.7

package/dist/tools/demerzel/snapshot.js

@@ -0,0 +1,169 @@
+/**
+ * Demerzel Snapshot Generator
+ *
+ * Creates optimized text snapshots of codebases for analysis.
+ * Handles file filtering, exclusion patterns, and formatting.
+ *
+ * Ported from Argus to Foundation.
+ */
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, mkdirSync } from 'fs';
+import { join, relative, extname, dirname } from 'path';
+export const DEFAULT_EXTENSIONS = [
+    'ts', 'tsx', 'js', 'jsx', 'rs', 'py', 'go', 'java', 'rb', 'php',
+    'swift', 'kt', 'scala', 'c', 'cpp', 'h', 'hpp', 'cs', 'md', 'json'
+];
+export const DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules',
+    '.git',
+    'target',
+    'dist',
+    'build',
+    '.next',
+    'coverage',
+    '__pycache__',
+    '.venv',
+    'vendor',
+    '.DS_Store',
+    '*.lock',
+    'package-lock.json',
+    '*.min.js',
+    '*.min.css',
+];
+const DEFAULT_OPTIONS = {
+    extensions: DEFAULT_EXTENSIONS,
+    excludePatterns: DEFAULT_EXCLUDE_PATTERNS,
+    maxFileSize: 1024 * 1024, // 1MB
+    includeHidden: false,
+};
+function shouldExclude(filePath, patterns) {
+    const normalizedPath = filePath.replace(/\\/g, '/');
+    for (const pattern of patterns) {
+        // Glob-like pattern matching
+        if (pattern.startsWith('*')) {
+            const suffix = pattern.slice(1);
+            if (normalizedPath.endsWith(suffix))
+                return true;
+        }
+        else if (normalizedPath.includes(`/${pattern}/`) || normalizedPath.endsWith(`/${pattern}`) || normalizedPath === pattern) {
+            return true;
+        }
+    }
+    return false;
+}
+function hasValidExtension(filePath, extensions) {
+    const ext = extname(filePath).slice(1).toLowerCase();
+    return extensions.includes(ext);
+}
+function collectFiles(dir, options, baseDir = dir) {
+    const files = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            const relativePath = relative(baseDir, fullPath);
+            // Skip hidden files unless explicitly included
+            if (!options.includeHidden && entry.name.startsWith('.')) {
+                continue;
+            }
+            // Check exclusion patterns
+            if (shouldExclude(relativePath, options.excludePatterns)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                files.push(...collectFiles(fullPath, options, baseDir));
+            }
+            else if (entry.isFile()) {
+                // Check extension
+                if (!hasValidExtension(entry.name, options.extensions)) {
+                    continue;
+                }
+                // Check file size
+                try {
+                    const stats = statSync(fullPath);
+                    if (stats.size > options.maxFileSize) {
+                        continue;
+                    }
+                }
+                catch {
+                    continue;
+                }
+                files.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // Directory not readable, skip
+    }
+    return files.sort();
+}
+export function createSnapshot(projectPath, outputPath, options = {}) {
+    const mergedOptions = {
+        ...DEFAULT_OPTIONS,
+        ...options,
+    };
+    if (!existsSync(projectPath)) {
+        throw new Error(`Project path does not exist: ${projectPath}`);
+    }
+    const stats = statSync(projectPath);
+    if (!stats.isDirectory()) {
+        throw new Error(`Project path is not a directory: ${projectPath}`);
+    }
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+    }
+    // Collect all files
+    const files = collectFiles(projectPath, mergedOptions);
+    // Build snapshot content
+    const lines = [];
+    // Header
+    lines.push('================================================================================');
+    lines.push('CODEBASE SNAPSHOT');
+    lines.push(`Project: ${projectPath}`);
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push(`Extensions: ${mergedOptions.extensions.join(', ')}`);
+    lines.push(`Files: ${files.length}`);
+    lines.push('================================================================================');
+    lines.push('');
+    // Process each file
+    for (const filePath of files) {
+        const relativePath = relative(projectPath, filePath);
+        lines.push('');
+        lines.push('================================================================================');
+        lines.push(`FILE: ./${relativePath}`);
+        lines.push('================================================================================');
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            lines.push(content);
+        }
+        catch {
+            lines.push('[Unable to read file]');
+        }
+    }
+    // Write snapshot
+    const content = lines.join('\n');
+    writeFileSync(outputPath, content);
+    const totalLines = content.split('\n').length;
+    const totalSize = Buffer.byteLength(content, 'utf-8');
+    return {
+        outputPath,
+        fileCount: files.length,
+        totalLines,
+        totalSize,
+        files: files.map(f => relative(projectPath, f)),
+    };
+}
+export function getSnapshotStats(snapshotPath) {
+    if (!existsSync(snapshotPath)) {
+        throw new Error(`Snapshot file does not exist: ${snapshotPath}`);
+    }
+    const content = readFileSync(snapshotPath, 'utf-8');
+    const totalLines = content.split('\n').length;
+    const totalSize = Buffer.byteLength(content, 'utf-8');
+    // Count FILE: markers
+    const fileMatches = content.match(/^FILE: /gm);
+    const fileCount = fileMatches ? fileMatches.length : 0;
+    return { fileCount, totalLines, totalSize };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/tools/demerzel/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/tools/demerzel/snapshot.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sashabogi/foundation",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Unified MCP server for AI-assisted development: codebase intelligence, multi-agent orchestration, and workflow patterns",
   "type": "module",
   "main": "dist/index.js",
@@ -52,6 +52,7 @@
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.0",
+    "@clack/prompts": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "better-sqlite3": "^12.0.0",
     "chalk": "^5.3.0",