bgit-cli 2.0.0

package/README.md

@@ -0,0 +1,277 @@
+# bgit - Bitcoin-Enabled Git Wrapper
+
+**Version:** 2.0.0
+**Timestamp your commits on BitcoinSV blockchain using HandCash OAuth**
+
+```
+██████╗       ██████╗ ██╗████████╗
+██╔══██╗     ██╔════╝ ██║╚══██╔══╝
+██████╔╝     ██║  ███╗ ██║   ██║
+██╔══██╗     ██║   ██║ ██║   ██║
+██████╔╝ ██╗ ╚██████╔╝ ██║   ██║
+╚═════╝  ╚═╝  ╚═════╝  ╚═╝   ╚═╝
+
+> Bitcoin-Native Git Wrapper
+> Pay-to-Operate • Universal History
+```
+
+---
+
+## What is bgit?
+
+bgit is a Git wrapper that timestamps your commits on the **BitcoinSV blockchain** using **HandCash** micropayments. Every commit you make gets a cryptographically provable timestamp on-chain, creating an immutable record of your code history.
+
+---
+
+## Quick Start
+
+### Installation
+
+```bash
+# Install globally
+npm install -g bgit-cli
+
+# Verify installation
+bgit --version
+```
+
+### First-Time Setup
+
+```bash
+# Authenticate with HandCash (opens browser)
+bgit auth login
+
+# Check authentication status
+bgit auth status
+```
+
+### Use It Like Git
+
+```bash
+# Free commands (no payment)
+bgit status
+bgit log
+bgit diff
+
+# Paid commands (0.001 BSV each)
+bgit commit -m "Initial commit"  # ← Timestamps commit hash on-chain
+bgit push origin main            # ← Payment required before push
+```
+
+---
+
+## Payment Model
+
+bgit uses a **minimal payment model** for maximum usability:
+
+### 🆓 Free Commands
+
+All **read-only** operations are FREE:
+- `bgit status` - Check working tree
+- `bgit log` - View commit history
+- `bgit diff` - See changes
+- `bgit show` - Inspect commits
+- `bgit branch` - List branches
+- ... and 150+ other read commands
+
+### 💰 Paid Commands (0.001 BSV each)
+
+Only **"publishing"** operations require payment:
+- `bgit commit` - Create commit + timestamp hash on-chain
+- `bgit push` - Payment gatekeeper before push
+
+**Why this model?** Developers run status/log hundreds of times per day. Paying for reads would cost $10-50/day. Commits/pushes are "publishing" events worth timestamping.
+
+### 🔧 Universal Mode (Optional)
+
+Enable payment for ALL 155 git commands:
+
+```bash
+# Enable universal mode
+bgit config payment-mode universal
+
+# Now EVERY command requires payment
+bgit status  # ← Costs 0.001 BSV
+bgit log     # ← Costs 0.001 BSV
+
+# Switch back to minimal
+bgit config payment-mode minimal
+```
+
+---
+
+## Authentication
+
+### OAuth Flow
+
+1. Run `bgit auth login`
+2. Browser opens to HandCash authorization page
+3. Click "Authorize" to connect your wallet
+4. Token is encrypted and saved locally
+5. All future commands use saved token
+
+### Auth Commands
+
+```bash
+bgit auth login    # Authenticate with HandCash
+bgit auth status   # Show auth status + wallet balance
+bgit auth logout   # Delete credentials
+```
+
+### Security Features
+
+- **AES-256-GCM Encryption** - Bank-grade token encryption
+- **Machine-Specific Key** - Token only works on your machine
+- **File Permissions** - 600 (config), 700 (directory)
+- **No Token Logging** - Tokens never appear in logs
+
+---
+
+## How It Works
+
+### Commit Flow
+
+```bash
+bgit commit -m "Add feature"
+
+# What happens:
+# 1. Execute git commit FIRST
+# 2. Capture commit hash (abc123...)
+# 3. Send 0.001 BSV payment to $b0ase
+# 4. Payment note: "bgit commit: abc123..."
+# 5. ✅ Commit hash timestamped on BitcoinSV!
+```
+
+### Money Flow
+
+```
+Your HandCash Wallet
+    ↓
+0.001 BSV (developer premium) + 0.00001 BSV (network fee)
+    ↓
+    ├──→ 0.001 BSV → $b0ase (developer)
+    └──→ 0.00001 BSV → BSV miners
+```
+
+---
+
+## Configuration
+
+```bash
+# Show current payment mode
+bgit config payment-mode
+
+# Set to minimal (default: commit/push only)
+bgit config payment-mode minimal
+
+# Set to universal (all 155 commands)
+bgit config payment-mode universal
+```
+
+**Config Location:** `~/.bgit/config.json`
+
+---
+
+## Examples
+
+### Daily Workflow
+
+```bash
+# Check status (free)
+bgit status
+
+# Work on code
+bgit checkout -b new-feature
+bgit add src/
+
+# Commit (paid: 0.001 BSV)
+bgit commit -m "Implement feature"
+
+# Push (paid: 0.001 BSV)
+bgit push origin new-feature
+```
+
+**Total cost:** 0.002 BSV (~$0.10)
+
+---
+
+## FAQ
+
+**Q: Why only commit/push by default?**
+A: Usability. Developers run status/log 100+ times/day. Charging for reads kills adoption. Commits/pushes are publishing events worth timestamping.
+
+**Q: How much does it cost?**
+A: Minimal mode: ~$0.50-1/day for typical developer (10-20 commits). Universal mode: $2.50-25/day depending on usage.
+
+**Q: Where do payments go?**
+A: Developer wallet ($b0ase). This is revenue for maintaining bgit.
+
+**Q: Is my token secure?**
+A: Yes. AES-256-GCM encryption with machine-specific key. File permissions 600.
+
+**Q: What if payment fails?**
+A: Commits succeed, payment failure is warned. Pushes are blocked until payment succeeds.
+
+---
+
+## Requirements
+
+- **Node.js:** >= 16.0.0
+- **Git:** Any version
+- **HandCash Account:** https://handcash.io
+- **BSV Funds:** At least 0.01 BSV (~$0.50)
+
+---
+
+## Troubleshooting
+
+**"No auth token found"**
+```bash
+bgit auth login
+```
+
+**"Insufficient balance"**
+Add funds at https://handcash.io
+
+**"Config corrupted"**
+```bash
+rm -rf ~/.bgit/
+bgit auth login
+```
+
+---
+
+## Development
+
+```bash
+# Clone
+git clone https://github.com/yourusername/bgit.git
+cd bgit
+
+# Install
+npm install
+
+# Test
+./index.js auth login
+./index.js commit -m "test"
+```
+
+---
+
+## License
+
+ISC
+
+---
+
+## Links
+
+- **GitHub:** https://github.com/yourusername/bgit
+- **HandCash:** https://handcash.io
+- **Issues:** https://github.com/yourusername/bgit/issues
+
+---
+
+**Made with ❤️ for the Bitcoin developer community**
+
+Timestamp your code. Prove your work. Build on BSV.

package/UNIVERSAL_PLAN.md

@@ -0,0 +1,31 @@
+# Plan: Universal bgit Integration
+
+The current implementation by Claude provides a robust OAuth foundation but lacks two critical features requested by the user:
+1.  **Universal History**: Currently, only `commit` and `push` are paid. We need *all* 155 commands to be paid.
+2.  **Aesthetics**: The ASCII Banner is missing from the entry point.
+
+## Execution Steps
+
+### 1. Refactor `lib/command-router.js`
+**Current Logic:**
+```javascript
+const PAYMENT_GATED_COMMANDS = ['commit', 'push'];
+```
+
+**New Logic:**
+- Import `commands` from `lib/commands.js`.
+- Treat **all** of them as payment-gated.
+- Unified flow: `ensureAuth` -> `pay` -> `execute`.
+
+### 2. Restore Banner in `index.js`
+- Import `showBanner` from `lib/banner.js`.
+- Call it at the start of `main()` (if no specific subcommands like `json` output are requested, to avoid breaking scripts).
+
+### 3. Verify
+- Run `node index.js status`.
+- Expectation:
+    - Banner shows.
+    - "Opening browser..." (if not authed) OR "Paying..." (if authed).
+    - `git status` output.
+
+This aligns the robust "Claude" architecture with the "b0ase" Vision.

package/handcash.js

@@ -0,0 +1,36 @@
+const { HandCashConnect } = require('@handcash/handcash-connect');
+
+async function pay(note) {
+    const appId = process.env.HANDCASH_APP_ID;
+    const appSecret = process.env.HANDCASH_APP_SECRET;
+    const authToken = process.env.HANDCASH_AUTH_TOKEN;
+    const treasury = process.env.BGIT_TREASURY_HANDLE || '$b0ase';
+
+    if (!appId || !appSecret || !authToken) {
+        console.error('Missing HandCash Credentials (APP_ID, APP_SECRET, or AUTH_TOKEN)');
+        return;
+    }
+
+    try {
+        const handCashConnect = new HandCashConnect({
+            appId: appId,
+            appSecret: appSecret,
+        });
+        const account = handCashConnect.getAccountFromAuthToken(authToken);
+
+        const paymentParameters = {
+            description: note || 'bGit Commit',
+            payments: [
+                { destination: treasury, currencyCode: 'BSV', sendAmount: 0.001 }
+            ]
+        };
+
+        const result = await account.wallet.pay(paymentParameters);
+        console.log(`[bGit] Payment Sent! ID: ${result.transactionId}`);
+        if (note) console.log(`[bGit] Timestamp: ${note}`);
+    } catch (error) {
+        console.error('[bGit] Payment Failed:', error.message);
+    }
+}
+
+module.exports = { pay };

package/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+/**
+ * bgit - Bitcoin-enabled Git wrapper
+ *
+ * Usage:
+ *   bgit <git-command> [args...]  - Execute git command with optional payment
+ *   bgit auth login               - Authenticate with HandCash
+ *   bgit auth logout              - Log out and delete credentials
+ *   bgit auth status              - Show authentication status
+ *
+ * Payment-gated commands: commit, push
+ * All other git commands pass through without payment
+ */
+
+const chalk = require('chalk');
+const showBanner = require('./lib/banner');
+const { ensureAuthenticated, loginCommand, logoutCommand, statusCommand } = require('./lib/auth');
+const { routeCommand, needsAuthentication } = require('./lib/command-router');
+const { getPaymentMode, setPaymentMode } = require('./lib/config');
+
+async function main() {
+  try {
+    // Parse command-line arguments
+    const args = process.argv.slice(2);
+
+    if (args.length === 0) {
+      // No arguments - show help
+      showHelp();
+      process.exit(0);
+    }
+
+    const command = args[0];
+    const subcommand = args[1];
+
+    // Show banner for git commands (not auth/config subcommands)
+    if (command !== 'auth' && command !== 'config') {
+      showBanner();
+    }
+
+    // Handle special 'auth' commands
+    if (command === 'auth') {
+      if (subcommand === 'login') {
+        await loginCommand();
+        process.exit(0);
+      } else if (subcommand === 'logout') {
+        await logoutCommand();
+        process.exit(0);
+      } else if (subcommand === 'status') {
+        await statusCommand();
+        process.exit(0);
+      } else {
+        console.error(chalk.red(`Unknown auth command: ${subcommand}`));
+        console.log(chalk.gray('\nAvailable auth commands:'));
+        console.log(chalk.gray('  bgit auth login   - Authenticate with HandCash'));
+        console.log(chalk.gray('  bgit auth logout  - Log out and delete credentials'));
+        console.log(chalk.gray('  bgit auth status  - Show authentication status\n'));
+        process.exit(1);
+      }
+    }
+
+    // Handle special 'config' commands
+    if (command === 'config') {
+      if (subcommand === 'payment-mode') {
+        const mode = args[2]; // 'minimal' or 'universal'
+
+        if (!mode) {
+          // Show current mode
+          const current = getPaymentMode();
+          console.log(chalk.blue.bold('\n💰 Payment Mode Configuration\n'));
+          console.log(`Current mode: ${chalk.cyan(current)}\n`);
+          console.log(chalk.bold('Available modes:'));
+          console.log(chalk.gray('  minimal    - Only commit/push require payment (default)'));
+          console.log(chalk.gray('  universal  - All 155 git commands require payment\n'));
+          console.log(chalk.bold('Usage:'));
+          console.log(chalk.gray('  bgit config payment-mode <mode>\n'));
+          console.log(chalk.bold('Examples:'));
+          console.log(chalk.gray('  bgit config payment-mode minimal'));
+          console.log(chalk.gray('  bgit config payment-mode universal\n'));
+          process.exit(0);
+        }
+
+        // Set mode
+        try {
+          setPaymentMode(mode);
+          process.exit(0);
+        } catch (error) {
+          console.error(chalk.red(`\n❌ ${error.message}\n`));
+          process.exit(1);
+        }
+      } else {
+        console.error(chalk.red(`Unknown config command: ${subcommand}`));
+        console.log(chalk.gray('\nAvailable config commands:'));
+        console.log(chalk.gray('  bgit config payment-mode  - Configure payment mode\n'));
+        process.exit(1);
+      }
+    }
+
+    // For git commands, check if authentication is needed
+    let authToken = null;
+
+    if (needsAuthentication(command)) {
+      // Payment-gated command - ensure authenticated
+      authToken = await ensureAuthenticated();
+    }
+
+    // Route to appropriate git command handler
+    const exitCode = await routeCommand(args, authToken);
+    process.exit(exitCode);
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+
+    // Show helpful hints for common errors
+    if (error.message.includes('authentication') || error.message.includes('token')) {
+      console.log(chalk.gray('Try running: bgit auth login\n'));
+    } else if (error.message.includes('payment') || error.message.includes('balance')) {
+      console.log(chalk.gray('Add funds to your HandCash wallet: https://handcash.io\n'));
+    }
+
+    process.exit(1);
+  }
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log(chalk.blue.bold('\nbgit - Bitcoin-enabled Git wrapper\n'));
+  console.log(chalk.bold('Usage:'));
+  console.log('  bgit <git-command> [args...]  Execute git command with optional payment');
+  console.log('  bgit auth <subcommand>        Manage authentication\n');
+
+  console.log(chalk.bold('Authentication Commands:'));
+  console.log('  bgit auth login               Authenticate with HandCash');
+  console.log('  bgit auth logout              Log out and delete credentials');
+  console.log('  bgit auth status              Show authentication status\n');
+
+  console.log(chalk.bold('Payment-Gated Commands:'));
+  console.log('  bgit commit                   Git commit + on-chain timestamp (0.001 BSV)');
+  console.log('  bgit push                     Git push + payment (0.001 BSV)\n');
+
+  console.log(chalk.bold('Pass-Through Commands:'));
+  console.log('  All other git commands work without payment (status, log, diff, etc.)\n');
+
+  console.log(chalk.bold('Examples:'));
+  console.log(chalk.gray('  bgit auth login                         # First-time setup'));
+  console.log(chalk.gray('  bgit commit -m "Initial commit"         # Commit + timestamp'));
+  console.log(chalk.gray('  bgit push origin main                   # Push with payment'));
+  console.log(chalk.gray('  bgit status                             # Free, no payment'));
+  console.log(chalk.gray('  bgit log                                # Free, no payment\n'));
+
+  console.log(chalk.bold('Learn More:'));
+  console.log('  GitHub: https://github.com/yourusername/bgit');
+  console.log('  HandCash: https://handcash.io\n');
+}
+
+// Run main function
+main();

package/index.js.backup

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const { pay } = require('./handcash');
+const { exec } = require('child_process');
+const commands = require('./lib/commands');
+const showBanner = require('./lib/banner');
+
+program
+    .name('bgit')
+    .description('Bitcoin Git - Pay to Operate')
+    .version('0.0.1');
+
+// Show banner if running without specific command (just 'bgit')
+if (process.argv.length <= 2) {
+    showBanner();
+}
+
+// Universal Command Handler
+const handleCommand = (cmd, args) => {
+    // Construct git command
+    const gitCmd = `git ${cmd} ${args.join(' ')}`;
+
+    // Execute Git
+    exec(gitCmd, (error, stdout, stderr) => {
+        if (error) {
+            console.error(`[bGit] Error: ${error.message}`);
+            return;
+        }
+        if (stderr) {
+            console.error(stderr);
+        }
+        console.log(stdout);
+
+        // Pay-to-Operate for ALL commands
+        let note = `bgit-${cmd}`;
+
+        // Extract commit hash if available
+        if (cmd === 'commit') {
+            const match = stdout.match(/\[.* ([a-f0-9]+)\]/);
+            if (match) {
+                note += ` ${match[1]}`;
+            }
+        }
+
+        pay(note).catch(err => console.error('[bGit] Payment Error:', err.message));
+    });
+};
+
+// Register all 155 commands
+commands.forEach(cmd => {
+    program
+        .command(cmd, { isDefault: false })
+        .description(`Executes git ${cmd} and pays for usage`)
+        .allowUnknownOption()
+        .action((options, command) => {
+            // Reconstruct args
+            const args = command.args;
+            handleCommand(cmd, args);
+        });
+});
+
+// Catch-all for any args passed to known commands
+program.on('command:*', function (operands) {
+    console.error(`error: unknown command '${operands[0]}'`);
+    process.exit(1);
+});
+
+program.parse(process.argv);