repo-cloak-cli 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    paths-ignore:
+      - '*.md'
+      - '.gitignore'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: 🎭 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: 📥 Install dependencies
+        run: npm ci
+
+      - name: 🧪 Run tests (if any)
+        run: npm test --if-present
+        continue-on-error: true
+
+      - name: 🚀 Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/version-bump.yml

@@ -0,0 +1,49 @@
+name: Version Bump & Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_type:
+        description: 'Version bump type'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  version-and-publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: 🎭 Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: 🔧 Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: 📥 Install dependencies
+        run: npm ci
+
+      - name: 📝 Bump version
+        run: npm version ${{ inputs.version_type }} -m "chore: bump version to %s"
+
+      - name: 📤 Push changes
+        run: git push --follow-tags
+
+      - name: 🚀 Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# repo-cloak 🎭
+
+> **Selectively extract and anonymize files from repositories**
+
+Perfect for sharing code with AI agents without exposing proprietary details. Extract specific files, replace sensitive information (company names, project names, etc.), and restore them later.
+
+[![npm version](https://img.shields.io/npm/v/repo-cloak.svg)](https://www.npmjs.com/package/repo-cloak)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Features
+
+- 🔍 **Interactive file browser** - Navigate and select files with a beautiful TUI
+- 🎭 **Smart anonymization** - Replace sensitive keywords while preserving case
+- 📁 **Structure preservation** - Maintains original folder hierarchy
+- 🔄 **Push/Pull workflow** - Extract files, work on them, push back with original names
+- 💾 **Mapping file** - Tracks all replacements for seamless restoration
+- 🌍 **Cross-platform** - Works on Windows, macOS, and Linux
+
+## 📦 Installation
+
+```bash
+npm install -g repo-cloak-cli
+```
+
+Or use directly with npx:
+
+```bash
+npx repo-cloak-cli
+```
+
+## 🚀 Quick Start
+
+### Pull (Extract & Anonymize)
+
+```bash
+# Interactive mode
+repo-cloak pull
+
+# With options
+repo-cloak pull --source ./my-project --dest ./extracted
+```
+
+1. Select files/folders to extract
+2. Enter destination path
+3. Add keyword replacements (e.g., "Microsoft Corp" → "ACME Inc")
+4. Confirm and extract!
+
+### Push (Restore)
+
+```bash
+# Interactive mode
+repo-cloak push
+
+# With options
+repo-cloak push --source ./extracted --dest ./my-project
+```
+
+Restores all files with original keywords replaced back.
+
+## 🎯 Use Cases
+
+- **AI Code Review** - Share proprietary code with AI tools by anonymizing company/project names
+- **Open Source Templates** - Extract project templates while removing internal references
+- **Code Samples** - Create sanitized examples from production code
+- **Compliance** - Remove sensitive identifiers before sharing code externally
+
+## 📋 Commands
+
+| Command | Description |
+|---------|-------------|
+| `repo-cloak` | Interactive menu to choose pull or push |
+| `repo-cloak pull` | Extract and anonymize files |
+| `repo-cloak push` | Restore files with original names |
+| `repo-cloak --help` | Show help |
+| `repo-cloak --version` | Show version |
+
+## 🔧 Options
+
+### Pull Options
+- `-s, --source <path>` - Source directory (default: current directory)
+- `-d, --dest <path>` - Destination directory
+- `-q, --quiet` - Minimal output
+
+### Push Options
+- `-s, --source <path>` - Cloaked backup directory
+- `-d, --dest <path>` - Destination directory
+- `-q, --quiet` - Minimal output
+
+## 📁 How It Works
+
+1. **Pull** creates a `.repo-cloak-map.json` file in the destination that stores:
+   - Original source path
+   - All keyword replacements
+   - File list with mappings
+   - Timestamp
+
+2. **Push** reads this mapping file to:
+   - Reverse all keyword replacements
+   - Restore files to original or new location
+
+## 🔒 Privacy by Design
+
+- No data is sent to any external servers
+- All processing happens locally
+- Binary files are copied without modification
+- Hidden files and common ignored directories (node_modules, .git) are skipped
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+MIT © Shazni Shiraz
+
+---
+
+Made with ❤️ for developers who need to share code safely

package/bin/repo-cloak.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+/**
+ * repo-cloak CLI Entry Point
+ * 🎭 Selectively extract and anonymize files from repositories
+ */
+
+import { run } from '../src/cli.js';
+
+run();

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "repo-cloak-cli",
+  "version": "1.0.0",
+  "description": "🎭 Selectively extract and anonymize files from repositories. Perfect for sharing code with AI agents without exposing proprietary details.",
+  "main": "src/index.js",
+  "type": "module",
+  "bin": {
+    "repo-cloak": "./bin/repo-cloak.js",
+    "cloak": "./bin/repo-cloak.js"
+  },
+  "scripts": {
+    "start": "node bin/repo-cloak.js",
+    "test": "node --test",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "cli",
+    "anonymize",
+    "extract",
+    "repository",
+    "code",
+    "privacy",
+    "ai",
+    "llm",
+    "obfuscate",
+    "cloak",
+    "mask",
+    "sanitize"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.7.0",
+    "glob": "^10.3.10",
+    "inquirer": "^9.2.12",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {}
+}

package/src/cli.js

@@ -0,0 +1,84 @@
+/**
+ * CLI Command Router
+ * Handles command-line arguments and routes to appropriate handlers
+ */
+
+import { Command } from 'commander';
+import { showBanner } from './ui/banner.js';
+import { pull } from './commands/pull.js';
+import { push } from './commands/push.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Read version from package.json
+const packageJson = JSON.parse(
+    readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')
+);
+
+const program = new Command();
+
+program
+    .name('repo-cloak')
+    .description('🎭 Selectively extract and anonymize files from repositories')
+    .version(packageJson.version);
+
+program
+    .command('pull')
+    .description('Extract files and anonymize sensitive information')
+    .option('-s, --source <path>', 'Source directory (default: current directory)')
+    .option('-d, --dest <path>', 'Destination directory')
+    .option('-q, --quiet', 'Minimal output')
+    .action(async (options) => {
+        await showBanner();
+        await pull(options);
+    });
+
+program
+    .command('push')
+    .description('Restore files with original names from a cloaked backup')
+    .option('-s, --source <path>', 'Source cloaked directory')
+    .option('-d, --dest <path>', 'Destination directory (original location)')
+    .option('-q, --quiet', 'Minimal output')
+    .action(async (options) => {
+        await showBanner();
+        await push(options);
+    });
+
+// Default command (no subcommand) - show interactive menu
+program
+    .action(async () => {
+        await showBanner();
+        const { default: inquirer } = await import('inquirer');
+
+        const { action } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices: [
+                    { name: '📤 Pull - Extract & anonymize files', value: 'pull' },
+                    { name: '📥 Push - Restore files with original names', value: 'push' },
+                    { name: '❌ Exit', value: 'exit' }
+                ]
+            }
+        ]);
+
+        if (action === 'pull') {
+            await pull({});
+        } else if (action === 'push') {
+            await push({});
+        }
+    });
+
+export async function run() {
+    try {
+        await program.parseAsync(process.argv);
+    } catch (error) {
+        console.error('Error:', error.message);
+        process.exit(1);
+    }
+}

package/src/commands/pull.js

@@ -0,0 +1,128 @@
+/**
+ * Pull Command
+ * Extract files and anonymize sensitive information
+ */
+
+import ora from 'ora';
+import chalk from 'chalk';
+import { existsSync, mkdirSync } from 'fs';
+import { resolve, relative } from 'path';
+
+import { selectFiles } from '../ui/fileSelector.js';
+import {
+    promptSourceDirectory,
+    promptDestinationDirectory,
+    promptKeywordReplacements,
+    showSummaryAndConfirm
+} from '../ui/prompts.js';
+import { showSuccess, showError, showInfo } from '../ui/banner.js';
+import { getAllFiles } from '../core/scanner.js';
+import { copyFiles } from '../core/copier.js';
+import { createAnonymizer } from '../core/anonymizer.js';
+import { createMapping, saveMapping } from '../core/mapper.js';
+
+export async function pull(options = {}) {
+    try {
+        // Step 1: Get source directory
+        const sourceDir = options.source
+            ? resolve(options.source)
+            : await promptSourceDirectory();
+
+        if (!existsSync(sourceDir)) {
+            showError(`Source directory does not exist: ${sourceDir}`);
+            return;
+        }
+
+        console.log(chalk.dim(`\n   Source: ${sourceDir}\n`));
+
+        // Step 2: Select files
+        const selectedFiles = await selectFiles(sourceDir);
+
+        if (selectedFiles.length === 0) {
+            showError('No files selected. Aborting.');
+            return;
+        }
+
+        console.log(chalk.green(`\n✓ Selected ${selectedFiles.length} files\n`));
+
+        // Step 3: Get destination directory
+        const destDir = options.dest
+            ? resolve(options.dest)
+            : await promptDestinationDirectory();
+
+        // Step 4: Get keyword replacements
+        const replacements = await promptKeywordReplacements();
+
+        // Step 5: Confirm
+        const confirmed = await showSummaryAndConfirm(
+            selectedFiles.length,
+            destDir,
+            replacements
+        );
+
+        if (!confirmed) {
+            showInfo('Operation cancelled.');
+            return;
+        }
+
+        // Step 6: Create destination directory
+        if (!existsSync(destDir)) {
+            mkdirSync(destDir, { recursive: true });
+            console.log(chalk.dim(`   Created directory: ${destDir}`));
+        }
+
+        // Step 7: Copy and anonymize files
+        const spinner = ora('Copying and anonymizing files...').start();
+
+        const anonymizer = createAnonymizer(replacements);
+        let lastFile = '';
+
+        const results = await copyFiles(
+            selectedFiles,
+            sourceDir,
+            destDir,
+            anonymizer,
+            (current, total, file) => {
+                lastFile = file;
+                spinner.text = `Copying files... ${current}/${total} - ${file}`;
+            }
+        );
+
+        spinner.succeed(`Copied ${results.copied} files`);
+
+        if (results.transformed > 0) {
+            console.log(chalk.cyan(`   📝 ${results.transformed} files had content replaced`));
+        }
+
+        if (results.errors.length > 0) {
+            console.log(chalk.yellow(`   ⚠️  ${results.errors.length} files had errors`));
+            results.errors.forEach(e => {
+                console.log(chalk.dim(`      - ${e.file}: ${e.error}`));
+            });
+        }
+
+        // Step 8: Save mapping file
+        const mapping = createMapping({
+            sourceDir,
+            destDir,
+            replacements,
+            files: selectedFiles.map(f => ({
+                relativePath: relative(sourceDir, f)
+            }))
+        });
+
+        const mapPath = saveMapping(destDir, mapping);
+        console.log(chalk.dim(`   📋 Mapping saved: ${mapPath}`));
+
+        // Done!
+        showSuccess('Extraction complete!');
+        console.log(chalk.white(`   📂 Files extracted to: ${chalk.cyan.bold(destDir)}`));
+        console.log(chalk.dim(`\n   To restore later, run: ${chalk.white('repo-cloak push')}\n`));
+
+    } catch (error) {
+        showError(`Pull failed: ${error.message}`);
+        if (process.env.DEBUG) {
+            console.error(error);
+        }
+    }
+}

package/src/commands/push.js

@@ -0,0 +1,145 @@
+/**
+ * Push Command
+ * Restore files with original names from a cloaked backup
+ */
+
+import ora from 'ora';
+import chalk from 'chalk';
+import { existsSync, mkdirSync, readdirSync } from 'fs';
+import { resolve, join, relative } from 'path';
+
+import {
+    promptBackupFolder,
+    promptDestinationDirectory,
+    confirmAction
+} from '../ui/prompts.js';
+import { showSuccess, showError, showInfo, showWarning } from '../ui/banner.js';
+import { getAllFiles } from '../core/scanner.js';
+import { copyFiles } from '../core/copier.js';
+import { createDeanonymizer } from '../core/anonymizer.js';
+import { loadMapping, hasMapping, getReplacements, getOriginalSource } from '../core/mapper.js';
+
+export async function push(options = {}) {
+    try {
+        // Step 1: Get source (cloaked) directory
+        const cloakedDir = options.source
+            ? resolve(options.source)
+            : await promptBackupFolder();
+
+        if (!existsSync(cloakedDir)) {
+            showError(`Directory does not exist: ${cloakedDir}`);
+            return;
+        }
+
+        // Step 2: Check for mapping file
+        if (!hasMapping(cloakedDir)) {
+            showError('No repo-cloak mapping file found in this directory.');
+            console.log(chalk.dim('   Make sure you selected a directory created by "repo-cloak pull"'));
+            return;
+        }
+
+        // Step 3: Load mapping
+        const spinner = ora('Loading mapping file...').start();
+        const mapping = loadMapping(cloakedDir);
+        spinner.succeed('Mapping file loaded');
+
+        console.log(chalk.dim(`\n   Original source: ${mapping.source?.path || 'Unknown'}`));
+        console.log(chalk.dim(`   Extracted on: ${mapping.timestamp}`));
+        console.log(chalk.dim(`   Replacements: ${mapping.replacements?.length || 0}`));
+        console.log(chalk.dim(`   Files: ${mapping.files?.length || 0}\n`));
+
+        // Show replacements that will be reversed
+        if (mapping.replacements && mapping.replacements.length > 0) {
+            console.log(chalk.cyan('   Replacements to reverse:'));
+            mapping.replacements.forEach(r => {
+                console.log(chalk.dim(`      "${r.replacement}" → "${r.original}"`));
+            });
+            console.log('');
+        }
+
+        // Step 4: Get destination directory
+        const originalPath = getOriginalSource(mapping);
+        let destDir;
+
+        if (options.dest) {
+            destDir = resolve(options.dest);
+        } else if (originalPath && existsSync(originalPath)) {
+            const useOriginal = await confirmAction(
+                `Restore to original location? (${originalPath})`
+            );
+
+            if (useOriginal) {
+                destDir = originalPath;
+            } else {
+                destDir = await promptDestinationDirectory();
+            }
+        } else {
+            if (originalPath) {
+                console.log(chalk.yellow(`   Original path no longer exists: ${originalPath}`));
+            }
+            destDir = await promptDestinationDirectory();
+        }
+
+        // Step 5: Confirm
+        const confirmed = await confirmAction(
+            `Restore ${mapping.files?.length || 0} files to ${destDir}?`
+        );
+
+        if (!confirmed) {
+            showInfo('Operation cancelled.');
+            return;
+        }
+
+        // Step 6: Get all files from cloaked directory
+        const files = getAllFiles(cloakedDir);
+
+        if (files.length === 0) {
+            showWarning('No files found in the cloaked directory.');
+            return;
+        }
+
+        // Step 7: Create destination if needed
+        if (!existsSync(destDir)) {
+            mkdirSync(destDir, { recursive: true });
+            console.log(chalk.dim(`   Created directory: ${destDir}`));
+        }
+
+        // Step 8: Copy and de-anonymize files
+        const restoreSpinner = ora('Restoring files...').start();
+
+        const deanonymizer = createDeanonymizer(getReplacements(mapping));
+
+        const results = await copyFiles(
+            files,
+            cloakedDir,
+            destDir,
+            deanonymizer,
+            (current, total, file) => {
+                restoreSpinner.text = `Restoring files... ${current}/${total} - ${file}`;
+            }
+        );
+
+        restoreSpinner.succeed(`Restored ${results.copied} files`);
+
+        if (results.transformed > 0) {
+            console.log(chalk.cyan(`   📝 ${results.transformed} files had content restored`));
+        }
+
+        if (results.errors.length > 0) {
+            console.log(chalk.yellow(`   ⚠️  ${results.errors.length} files had errors`));
+            results.errors.forEach(e => {
+                console.log(chalk.dim(`      - ${e.file}: ${e.error}`));
+            });
+        }
+
+        // Done!
+        showSuccess('Restoration complete!');
+        console.log(chalk.white(`   📂 Files restored to: ${chalk.cyan.bold(destDir)}\n`));
+
+    } catch (error) {
+        showError(`Push failed: ${error.message}`);
+        if (process.env.DEBUG) {
+            console.error(error);
+        }
+    }
+}