@xelth/eck-snapshot 5.9.0 → 6.4.1

package/src/cli/commands/envSync.js

@@ -1,319 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import crypto from 'crypto';
-import zlib from 'zlib';
-import { promisify } from 'util';
-import chalk from 'chalk';
-import ora from 'ora';
-import inquirer from 'inquirer';
-
-const gzip = promisify(zlib.gzip);
-const gunzip = promisify(zlib.gunzip);
-
-const SYNC_FILENAME = '.eck-sync.enc';
-const ECK_DIR = '.eck';
-
-// Files to include (relative to .eck/). Snapshots excluded intentionally.
-const INCLUDE_FILES = [
-  'anchor',
-  'claude-mcp-config.json',
-  'CONTEXT.md',
-  'ENVIRONMENT.md',
-  'JOURNAL.md',
-  'OPERATIONS.md',
-  'ROADMAP.md',
-  'TECH_DEBT.md',
-  'update_seq',
-];
-
-// Crypto constants
-const PBKDF2_ITERATIONS = 100_000;
-const PBKDF2_DIGEST = 'sha512';
-const KEY_LENGTH = 32;
-const SALT_LENGTH = 16;
-const IV_LENGTH = 12;
-const AUTH_TAG_LENGTH = 16;
-const ALGORITHM = 'aes-256-gcm';
-const FORMAT_VERSION = 1;
-
-// ── Password ────────────────────────────────────────────────────────
-
-async function getPassword(action = 'encrypt') {
-  const envKey = process.env.ECK_SYNC_KEY;
-  if (envKey) {
-    if (envKey.length < 4) throw new Error('ECK_SYNC_KEY must be at least 4 characters');
-    return envKey;
-  }
-
-  const verb = action === 'encrypt' ? 'encrypt' : 'decrypt';
-  const { password } = await inquirer.prompt([{
-    type: 'password',
-    name: 'password',
-    message: `Enter password to ${verb} .eck/ environment:`,
-    mask: '*',
-    validate: (input) => input.length >= 4 || 'Password must be at least 4 characters',
-  }]);
-
-  if (action === 'encrypt') {
-    const { confirm } = await inquirer.prompt([{
-      type: 'password',
-      name: 'confirm',
-      message: 'Confirm password:',
-      mask: '*',
-    }]);
-    if (password !== confirm) throw new Error('Passwords do not match');
-  }
-
-  return password;
-}
-
-// ── Encryption ──────────────────────────────────────────────────────
-
-function encrypt(plainBuffer, password) {
-  const salt = crypto.randomBytes(SALT_LENGTH);
-  const key = crypto.pbkdf2Sync(password, salt, PBKDF2_ITERATIONS, KEY_LENGTH, PBKDF2_DIGEST);
-  const iv = crypto.randomBytes(IV_LENGTH);
-
-  const cipher = crypto.createCipheriv(ALGORITHM, key, iv);
-  const encrypted = Buffer.concat([cipher.update(plainBuffer), cipher.final()]);
-  const authTag = cipher.getAuthTag();
-
-  // Binary: salt(16) + iv(12) + authTag(16) + ciphertext
-  return Buffer.concat([salt, iv, authTag, encrypted]);
-}
-
-function decrypt(encBuffer, password) {
-  const minSize = SALT_LENGTH + IV_LENGTH + AUTH_TAG_LENGTH + 1;
-  if (encBuffer.length < minSize) {
-    throw new Error('Encrypted file is too small or corrupted');
-  }
-
-  let offset = 0;
-  const salt = encBuffer.subarray(offset, offset += SALT_LENGTH);
-  const iv = encBuffer.subarray(offset, offset += IV_LENGTH);
-  const authTag = encBuffer.subarray(offset, offset += AUTH_TAG_LENGTH);
-  const ciphertext = encBuffer.subarray(offset);
-
-  const key = crypto.pbkdf2Sync(password, salt, PBKDF2_ITERATIONS, KEY_LENGTH, PBKDF2_DIGEST);
-  const decipher = crypto.createDecipheriv(ALGORITHM, key, iv);
-  decipher.setAuthTag(authTag);
-
-  try {
-    return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
-  } catch {
-    throw new Error('Decryption failed. Wrong password or corrupted file.');
-  }
-}
-
-// ── Path templating ─────────────────────────────────────────────────
-
-function templatizePaths(content, projectRoot, homeDir, filename) {
-  let result = content;
-
-  if (filename.endsWith('.json')) {
-    // JSON files store backslashes escaped: C:\\Users\\...
-    const projEsc = projectRoot.replace(/\\/g, '\\\\');
-    const homeEsc = homeDir.replace(/\\/g, '\\\\');
-    result = result.replaceAll(projEsc, '{{PROJECT_ROOT}}');
-    result = result.replaceAll(homeEsc, '{{HOME}}');
-  }
-
-  // Forward-slash and raw variants
-  const projFwd = projectRoot.replace(/\\/g, '/');
-  const homeFwd = homeDir.replace(/\\/g, '/');
-  result = result.replaceAll(projectRoot, '{{PROJECT_ROOT}}');
-  result = result.replaceAll(projFwd, '{{PROJECT_ROOT}}');
-  result = result.replaceAll(homeDir, '{{HOME}}');
-  result = result.replaceAll(homeFwd, '{{HOME}}');
-
-  return result;
-}
-
-function resolveTemplates(content, projectRoot, homeDir, filename) {
-  let result = content;
-
-  if (filename.endsWith('.json')) {
-    // JSON needs escaped backslashes on Windows
-    const projEsc = projectRoot.replace(/\\/g, '\\\\');
-    const homeEsc = homeDir.replace(/\\/g, '\\\\');
-    result = result.replaceAll('{{PROJECT_ROOT}}', projEsc);
-    result = result.replaceAll('{{HOME}}', homeEsc);
-  } else {
-    result = result.replaceAll('{{PROJECT_ROOT}}', projectRoot);
-    result = result.replaceAll('{{HOME}}', homeDir);
-  }
-
-  return result;
-}
-
-// ── Push ─────────────────────────────────────────────────────────────
-
-export async function envPush(options = {}) {
-  const projectRoot = process.cwd();
-  const eckDir = path.join(projectRoot, ECK_DIR);
-  const outputPath = path.join(projectRoot, SYNC_FILENAME);
-  const homeDir = os.homedir();
-  const spinner = ora();
-
-  try {
-    // Verify .eck/ exists
-    spinner.start('Checking .eck/ directory...');
-    try {
-      await fs.access(eckDir);
-    } catch {
-      spinner.fail('.eck/ directory not found');
-      console.log(chalk.yellow('Run eck-snapshot first to create .eck/ context files.'));
-      process.exit(1);
-    }
-    spinner.succeed('.eck/ directory found');
-
-    // Read included files
-    spinner.start('Reading .eck/ files...');
-    const payload = {
-      version: FORMAT_VERSION,
-      timestamp: new Date().toISOString(),
-      files: {},
-    };
-
-    let fileCount = 0;
-    for (const filename of INCLUDE_FILES) {
-      const filePath = path.join(eckDir, filename);
-      try {
-        const content = await fs.readFile(filePath, 'utf-8');
-        const templated = templatizePaths(content, projectRoot, homeDir, filename);
-        payload.files[filename] = { content: templated, encoding: 'utf8' };
-        fileCount++;
-        if (options.verbose) {
-          console.log(chalk.gray(`  + ${filename} (${Buffer.byteLength(content)} bytes)`));
-        }
-      } catch {
-        if (options.verbose) {
-          console.log(chalk.gray(`  - ${filename} (not found, skipping)`));
-        }
-      }
-    }
-
-    if (fileCount === 0) {
-      spinner.fail('No .eck/ files found to pack');
-      process.exit(1);
-    }
-    spinner.succeed(`Read ${fileCount} files from .eck/`);
-
-    // Compress
-    spinner.start('Compressing...');
-    const jsonStr = JSON.stringify(payload, null, 2);
-    const compressed = await gzip(Buffer.from(jsonStr, 'utf-8'));
-    spinner.succeed(`Compressed: ${Buffer.byteLength(jsonStr)} -> ${compressed.length} bytes`);
-
-    // Encrypt
-    const password = await getPassword('encrypt');
-    spinner.start('Encrypting...');
-    const encrypted = encrypt(compressed, password);
-    spinner.succeed(`Encrypted: ${encrypted.length} bytes`);
-
-    // Write
-    await fs.writeFile(outputPath, encrypted);
-
-    console.log(chalk.green.bold('\nEnvironment pushed successfully!'));
-    console.log(chalk.gray(`  Files packed: ${fileCount}`));
-    console.log(chalk.gray(`  Output size:  ${encrypted.length} bytes`));
-    console.log(chalk.gray(`  Output file:  ${SYNC_FILENAME}`));
-    console.log(chalk.yellow('\nCommit .eck-sync.enc to git to share across machines.'));
-
-  } catch (error) {
-    spinner.fail(`Push failed: ${error.message}`);
-    if (options.verbose) console.error(error.stack);
-    process.exit(1);
-  }
-}
-
-// ── Pull ─────────────────────────────────────────────────────────────
-
-export async function envPull(options = {}) {
-  const projectRoot = process.cwd();
-  const eckDir = path.join(projectRoot, ECK_DIR);
-  const inputPath = path.join(projectRoot, SYNC_FILENAME);
-  const homeDir = os.homedir();
-  const spinner = ora();
-
-  try {
-    // Verify .eck-sync.enc exists
-    spinner.start(`Checking ${SYNC_FILENAME}...`);
-    try {
-      await fs.access(inputPath);
-    } catch {
-      spinner.fail(`${SYNC_FILENAME} not found in project root`);
-      console.log(chalk.yellow('Run "eck-snapshot env push" first, or pull the file from git.'));
-      process.exit(1);
-    }
-    spinner.succeed(`${SYNC_FILENAME} found`);
-
-    // Conflict check
-    if (!options.force) {
-      try {
-        await fs.access(eckDir);
-        const { action } = await inquirer.prompt([{
-          type: 'list',
-          name: 'action',
-          message: '.eck/ directory already exists. What would you like to do?',
-          choices: [
-            { name: 'Overwrite existing files', value: 'overwrite' },
-            { name: 'Cancel', value: 'cancel' },
-          ],
-        }]);
-        if (action === 'cancel') {
-          console.log(chalk.yellow('Pull cancelled.'));
-          return;
-        }
-      } catch {
-        // .eck/ doesn't exist, proceed
-      }
-    }
-
-    // Read + decrypt
-    spinner.start('Reading encrypted file...');
-    const encrypted = await fs.readFile(inputPath);
-    spinner.succeed(`Read ${encrypted.length} bytes`);
-
-    const password = await getPassword('decrypt');
-    spinner.start('Decrypting...');
-    const compressed = decrypt(encrypted, password);
-    spinner.succeed('Decrypted');
-
-    // Decompress + parse
-    spinner.start('Decompressing...');
-    const jsonBuffer = await gunzip(compressed);
-    const payload = JSON.parse(jsonBuffer.toString('utf-8'));
-    spinner.succeed('Decompressed');
-
-    if (payload.version !== FORMAT_VERSION) {
-      throw new Error(`Unsupported format version: ${payload.version} (expected ${FORMAT_VERSION})`);
-    }
-
-    // Restore files
-    await fs.mkdir(eckDir, { recursive: true });
-
-    const fileNames = Object.keys(payload.files);
-    spinner.start(`Restoring ${fileNames.length} files...`);
-
-    for (const filename of fileNames) {
-      const { content } = payload.files[filename];
-      const resolved = resolveTemplates(content, projectRoot, homeDir, filename);
-      await fs.writeFile(path.join(eckDir, filename), resolved, 'utf-8');
-      if (options.verbose) {
-        console.log(chalk.gray(`  + ${filename}`));
-      }
-    }
-    spinner.succeed(`Restored ${fileNames.length} files to .eck/`);
-
-    console.log(chalk.green.bold('\nEnvironment pulled successfully!'));
-    console.log(chalk.gray(`  Files restored: ${fileNames.length}`));
-    console.log(chalk.gray(`  Packed at:      ${payload.timestamp}`));
-
-  } catch (error) {
-    spinner.fail(`Pull failed: ${error.message}`);
-    if (options.verbose) console.error(error.stack);
-    process.exit(1);
-  }
-}

package/src/cli/commands/generateProfileGuide.js

@@ -1,144 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import ora from 'ora';
-import chalk from 'chalk';
-import { loadSetupConfig } from '../../config.js';
-import { scanDirectoryRecursively, generateDirectoryTree, initializeEckManifest, loadConfig } from '../../utils/fileUtils.js';
-
-function buildPrompt(projectPath) {
-  const normalizedPath = path.resolve(projectPath);
-  return `You are a code architect helping a developer curate manual context profiles for a repository.
-Project root: ${normalizedPath}
-
-Use the project directory tree provided separately to identify logical groupings of files that should travel together during focused work.
-
-Instructions:
-1. Propose profile names that reflect the responsibilities or layers of the codebase.
-2. For each profile, add a "description" field explaining what the profile covers.
-3. For each profile, produce "include" and "exclude" arrays of glob patterns using proper micromatch syntax:
-
-   CORRECT glob patterns:
-   ✓ "src/**/*"           - all files recursively in src/
-   ✓ "src/**/*.js"        - all JS files recursively in src/
-   ✓ "**/node_modules/**" - node_modules anywhere
-   ✓ "**/*.test.js"       - test files anywhere
-   ✓ "packages/**/package.json" - all package.json in packages subdirs
-
-   INCORRECT patterns (DO NOT USE):
-   ✗ "src//"              - double slash is invalid
-   ✗ "src/**/"            - trailing slash is incorrect
-   ✗ "/node_modules/"     - leading/trailing slashes don't work as expected
-   ✗ "src/.js"            - missing ** means only root level
-
-4. Always include a sensible catch-all profile (for example, "default") if one is not obvious.
-5. Call out generated assets, tests, or vendor files in "exclude" arrays when appropriate.
-6. Return **only** valid JSON. Do not wrap the response in markdown fences or add commentary.
-
-Example profile structure:
-{
-  "backend": {
-    "description": "Backend API and services",
-    "include": ["src/api/**/*", "src/services/**/*"],
-    "exclude": ["**/*.test.js", "**/node_modules/**"]
-  }
-}
-`;
-}
-
-function buildGuideContent({ prompt, directoryTree }) {
-  const timestamp = new Date().toISOString();
-  const trimmedTree = directoryTree.trimEnd();
-
-  return [
-    '# Profile Generation Guide',
-    '',
-    `Generated: ${timestamp}`,
-    '',
-    '## How to Use',
-    '- Copy the prompt below into your AI assistant or follow it yourself.',
-    '- When using an AI, paste the directory tree afterward so it has full project context.',
-    "- Review the suggested profiles, then save the JSON to `.eck/profiles.json` when you are satisfied.",
-    '',
-    '## Recommended Prompt',
-    '```text',
-    prompt.trimEnd(),
-    '```',
-    '',
-    '## Project Directory Tree',
-    '```text',
-    trimmedTree,
-    '```',
-    ''
-  ].join('\n');
-}
-
-export async function generateProfileGuide(repoPath = process.cwd(), options = {}) {
-  const spinner = ora('Preparing profile generation guide...').start();
-  const projectPath = path.resolve(repoPath);
-
-  try {
-    spinner.text = 'Ensuring .eck manifest directory is initialized...';
-    await initializeEckManifest(projectPath);
-
-    spinner.text = 'Loading configuration...';
-    const setupConfig = await loadSetupConfig();
-    const userConfig = await loadConfig(options.config);
-    const combinedConfig = {
-      ...userConfig,
-      ...(setupConfig.fileFiltering || {}),
-      ...(setupConfig.performance || {})
-    };
-
-    spinner.text = 'Scanning repository files...';
-    const allFiles = await scanDirectoryRecursively(projectPath, combinedConfig, projectPath);
-
-    spinner.text = 'Building directory tree...';
-    const maxDepth = Number(combinedConfig.maxDepth ?? 10);
-    const directoryTree = await generateDirectoryTree(projectPath, '', allFiles, 0, Number.isFinite(maxDepth) ? maxDepth : 10, combinedConfig);
-
-    if (!directoryTree) {
-      throw new Error('Failed to generate directory tree or project is empty.');
-    }
-
-    // 1. Create the Guide Markdown
-    const prompt = buildPrompt(projectPath);
-    const guideContent = buildGuideContent({ prompt, directoryTree });
-    const guidePath = path.join(projectPath, '.eck', 'profile_generation_guide.md');
-
-    await fs.mkdir(path.dirname(guidePath), { recursive: true });
-    spinner.text = 'Writing guide to .eck/profile_generation_guide.md...';
-    await fs.writeFile(guidePath, guideContent, 'utf-8');
-
-    // 2. Ensure profiles.json exists (or create a stub)
-    const profilesPath = path.join(projectPath, '.eck', 'profiles.json');
-    let profilesCreated = false;
-    try {
-        await fs.access(profilesPath);
-    } catch {
-        // File doesn't exist, create a stub for easy pasting
-        const stubContent = {
-            "_instruction": "PASTE THE JSON RESPONSE FROM THE AI HERE",
-            "example_profile": {
-                "description": "Example profile structure",
-                "include": ["src/**"],
-                "exclude": ["**/*.test.js"]
-            }
-        };
-        await fs.writeFile(profilesPath, JSON.stringify(stubContent, null, 2));
-        profilesCreated = true;
-    }
-
-    spinner.succeed(`Profile generation guide saved to ${guidePath}`);
-
-    // 3. Print clear instructions
-    console.log(chalk.cyan('\n📋 Next Steps (Workflow):'));
-    console.log(`1. Open: ${chalk.bold('.eck/profile_generation_guide.md')}`);
-    console.log('2. Copy the PROMPT + TREE content and paste it into an AI (Gemini 1.5 Pro, Claude Opus, ChatGPT).');
-    console.log('3. Copy the JSON response from the AI.');
-    console.log(`4. Paste the JSON into: ${chalk.bold('.eck/profiles.json')} ${profilesCreated ? '(I created this file for you)' : '(File exists)'}`);
-    console.log('\n✅ Once saved, run: ' + chalk.green('eck-snapshot --profile <profile_name>'));
-  } catch (error) {
-    spinner.fail(`Failed to generate profile guide: ${error.message}`);
-    throw error;
-  }
-}

package/src/cli/commands/pruneSnapshot.js

@@ -1,106 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import ora from 'ora';
-import { executePrompt as askClaude } from '../../services/claudeCliService.js';
-import { parseSnapshotContent, parseSize, formatSize } from '../../utils/fileUtils.js';
-
-function extractJson(text) {
-  const match = text.match(/```(json)?([\s\S]*?)```/);
-  if (match && match[2]) {
-    return match[2].trim();
-  }
-  const firstBracket = text.indexOf('[');
-  const lastBracket = text.lastIndexOf(']');
-  if (firstBracket !== -1 && lastBracket !== -1 && lastBracket > firstBracket) {
-    return text.substring(firstBracket, lastBracket + 1).trim();
-  }
-  return text.trim();
-}
-
-export async function pruneSnapshot(snapshotFile, options) {
-  const spinner = ora('Starting snapshot pruning process...').start();
-  try {
-    const targetSize = parseSize(options.targetSize);
-    spinner.text = `Reading snapshot file: ${snapshotFile}`;
-    const snapshotContent = await fs.readFile(snapshotFile, 'utf-8');
-    const snapshotHeader = snapshotContent.split('--- File: /')[0];
-    const files = parseSnapshotContent(snapshotContent);
-
-    if (files.length === 0) {
-      spinner.warn('No files found in the snapshot.');
-      return;
-    }
-
-    const currentSize = Buffer.byteLength(snapshotContent, 'utf-8');
-    if (currentSize <= targetSize) {
-      spinner.succeed(`Snapshot is already smaller than the target size. (${formatSize(currentSize)} < ${formatSize(targetSize)})`);
-      return;
-    }
-
-    spinner.text = 'Asking AI to rank files by importance...';
-    const filePaths = files.map(f => f.path);
-
-    const prompt = `Return a JSON array ranking these file paths by importance (most important first).
-
-Important files: package.json, index.js, main entry points, core logic, configuration
-Less important: tests, documentation, examples
-
-Files to rank:
-${filePaths.join('\n')}
-
-Return format (NOTHING else, no markdown, no explanations, ONLY the array):
-["file1", "file2", "file3"]`;
-
-    const aiResponseObject = await askClaude(prompt);
-    const rawText = aiResponseObject.response || aiResponseObject.response_text || aiResponseObject.result;
-    const cleanedJson = extractJson(rawText);
-
-    let rankedFiles;
-    try {
-      rankedFiles = JSON.parse(cleanedJson);
-      if (!Array.isArray(rankedFiles) || rankedFiles.some(item => typeof item !== 'string')) {
-        throw new Error('AI response is not an array of strings.');
-      }
-    } catch (e) {
-      spinner.fail(`Failed to parse AI's file ranking: ${e.message}`);
-      console.error('Received from AI:', cleanedJson);
-      return;
-    }
-
-    spinner.text = 'Building pruned snapshot...';
-    const fileMap = new Map(files.map(f => [f.path, f.content]));
-    let newSnapshotContent = snapshotHeader;
-    let newSize = Buffer.byteLength(newSnapshotContent, 'utf-8');
-    let filesIncluded = 0;
-
-    for (const filePath of rankedFiles) {
-      if (fileMap.has(filePath)) {
-        const fileContent = fileMap.get(filePath);
-        const fileEntry = `--- File: /${filePath} ---\n\n${fileContent}\n\n`;
-        const entrySize = Buffer.byteLength(fileEntry, 'utf-8');
-
-        if (newSize + entrySize > targetSize) {
-          break;
-        }
-
-        newSnapshotContent += fileEntry;
-        newSize += entrySize;
-        filesIncluded++;
-      }
-    }
-
-    const outputFilename = `${path.basename(snapshotFile, path.extname(snapshotFile))}_pruned_${options.targetSize}${path.extname(snapshotFile)}`;
-    const outputPath = path.join(path.dirname(snapshotFile), outputFilename);
-
-    await fs.writeFile(outputPath, newSnapshotContent);
-
-    spinner.succeed('Snapshot pruning complete!');
-    console.log(`- Original Size: ${formatSize(currentSize)}`);
-    console.log(`- New Size: ${formatSize(newSize)}`);
-    console.log(`- Files Included: ${filesIncluded} / ${files.length}`);
-    console.log(`- Pruned snapshot saved to: ${outputPath}`);
-
-  } catch (error) {
-    spinner.fail(`An error occurred during pruning: ${error.message}`);
-  }
-}