git-nostr-hook 0.0.1

package/README.md

@@ -0,0 +1,59 @@
+# git-nostr-hook
+
+Git hook that publishes repository state to Nostr (NIP-34) on every commit.
+
+## Install
+
+```bash
+npm install -g git-nostr-hook
+git-nostr-hook install
+```
+
+## Setup
+
+Set your Nostr private key:
+
+```bash
+git config --global nostr.privkey <64-char-hex-key>
+```
+
+Generate a key if needed:
+
+```bash
+npx noskey
+```
+
+## Usage
+
+Once installed, every `git commit` automatically publishes a Kind 30617 event to Nostr relays with:
+
+- Repository name
+- Branch refs (like `git ls-remote`)
+- Clone/web URLs
+- Latest commit message
+
+## Commands
+
+```bash
+git-nostr-hook install    # Install global git hook
+git-nostr-hook uninstall  # Remove global git hook
+git-nostr-hook run        # Run manually
+```
+
+## How It Works
+
+1. Git runs `.git-hooks/post-commit` after every commit
+2. Hook reads private key from `git config nostr.privkey`
+3. Builds a Kind 30617 (NIP-34 repository announcement) event
+4. Signs with Schnorr signature
+5. Publishes to relays: `relay.damus.io`, `nos.lol`, `relay.nostr.band`
+
+## NIP-34
+
+This implements [NIP-34](https://github.com/nostr-protocol/nips/blob/master/34.md) - Git repositories on Nostr.
+
+Kind 30617 is a replaceable event, so each commit updates the previous announcement.
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+
+/**
+ * git-nostr-hook CLI
+ *
+ * Usage:
+ *   git-nostr-hook install    Install global git hook
+ *   git-nostr-hook uninstall  Remove global git hook
+ *   git-nostr-hook run        Run the hook manually
+ */
+
+import { existsSync, mkdirSync, writeFileSync, unlinkSync, readFileSync } from 'fs';
+import { execSync } from 'child_process';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOOKS_DIR = join(homedir(), '.git-hooks');
+const HOOK_PATH = join(HOOKS_DIR, 'post-commit');
+
+const HOOK_SCRIPT = `#!/usr/bin/env node
+import { run } from 'git-nostr-hook/lib/hook.js';
+run().catch(() => {});
+`;
+
+function install() {
+  console.log('Installing git-nostr-hook...\n');
+
+  // Create hooks directory
+  if (!existsSync(HOOKS_DIR)) {
+    mkdirSync(HOOKS_DIR, { recursive: true });
+    console.log(`✓ Created ${HOOKS_DIR}`);
+  }
+
+  // Create package.json for ES modules
+  const pkgPath = join(HOOKS_DIR, 'package.json');
+  if (!existsSync(pkgPath)) {
+    writeFileSync(pkgPath, JSON.stringify({
+      name: "git-hooks",
+      type: "module",
+      private: true
+    }, null, 2));
+    console.log('✓ Created package.json');
+  }
+
+  // Write the hook
+  writeFileSync(HOOK_PATH, HOOK_SCRIPT);
+  execSync(`chmod +x "${HOOK_PATH}"`);
+  console.log('✓ Installed post-commit hook');
+
+  // Set global hooks path
+  execSync('git config --global core.hooksPath ~/.git-hooks');
+  console.log('✓ Set global core.hooksPath');
+
+  console.log('\n✅ Installation complete!\n');
+  console.log('Next steps:');
+  console.log('  1. Set your Nostr private key:');
+  console.log('     git config --global nostr.privkey <64-char-hex-key>\n');
+  console.log('  2. Generate a key if needed:');
+  console.log('     npx noskey\n');
+  console.log('  3. Make a commit in any repo to test!');
+}
+
+function uninstall() {
+  console.log('Uninstalling git-nostr-hook...\n');
+
+  // Remove the hook
+  if (existsSync(HOOK_PATH)) {
+    unlinkSync(HOOK_PATH);
+    console.log('✓ Removed post-commit hook');
+  }
+
+  // Unset global hooks path
+  try {
+    execSync('git config --global --unset core.hooksPath');
+    console.log('✓ Unset global core.hooksPath');
+  } catch {
+    // Already unset
+  }
+
+  console.log('\n✅ Uninstalled successfully!');
+}
+
+async function runHook() {
+  const { run } = await import('../lib/hook.js');
+  await run();
+}
+
+function help() {
+  console.log(`
+git-nostr-hook v0.0.1
+
+Publish repository state to Nostr (NIP-34) on every commit.
+
+Usage:
+  git-nostr-hook install     Install global git hook
+  git-nostr-hook uninstall   Remove global git hook
+  git-nostr-hook run         Run the hook manually
+  git-nostr-hook help        Show this help
+
+Setup:
+  git config --global nostr.privkey <hex-private-key>
+
+Learn more: https://github.com/nostrapps/git-nostr-hook
+`);
+}
+
+const command = process.argv[2];
+
+switch (command) {
+  case 'install':
+    install();
+    break;
+  case 'uninstall':
+    uninstall();
+    break;
+  case 'run':
+    runHook().catch(err => {
+      console.error('Error:', err.message);
+      process.exit(1);
+    });
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    help();
+    break;
+  default:
+    help();
+}

package/lib/hook.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+/**
+ * Git post-commit hook that publishes repository state to Nostr (NIP-34)
+ *
+ * This hook:
+ * 1. Reads the private key from: git config nostr.privkey
+ * 2. Builds a Kind 30617 event (repository announcement)
+ * 3. Signs and publishes to Nostr relays
+ */
+
+import { execSync } from 'child_process';
+import { finalizeEvent } from 'nostr-tools/pure';
+import { Relay } from 'nostr-tools/relay';
+
+const RELAYS = [
+  'wss://relay.damus.io',
+  'wss://nos.lol',
+  'wss://relay.nostr.band'
+];
+
+function git(cmd) {
+  try {
+    return execSync(`git ${cmd}`, { encoding: 'utf8' }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function getBranchRefs() {
+  const refs = [];
+  const branches = git('for-each-ref --format="%(refname:short) %(objectname)" refs/heads/');
+  if (branches) {
+    for (const line of branches.split('\n')) {
+      const [branch, sha] = line.split(' ');
+      if (branch && sha) {
+        refs.push([`refs/heads/${branch}`, sha]);
+      }
+    }
+  }
+  return refs;
+}
+
+function buildRepoEvent(secretKey) {
+  const repoName = git('rev-parse --show-toplevel')?.split('/').pop() || 'unknown';
+  const remoteUrl = git('remote get-url origin');
+  const currentBranch = git('symbolic-ref --short HEAD') || 'main';
+  const commitMsg = git('log -1 --pretty=%s');
+
+  const tags = [
+    ['d', repoName],
+    ['name', repoName],
+    ['HEAD', `ref: refs/heads/${currentBranch}`],
+  ];
+
+  if (remoteUrl) {
+    tags.push(['clone', remoteUrl]);
+    const webUrl = remoteUrl.replace(/\.git$/, '').replace('git@github.com:', 'https://github.com/');
+    if (webUrl.startsWith('https://')) {
+      tags.push(['web', webUrl]);
+    }
+  }
+
+  for (const ref of getBranchRefs()) {
+    tags.push(ref);
+  }
+
+  const event = {
+    kind: 30617,
+    created_at: Math.floor(Date.now() / 1000),
+    tags,
+    content: `Latest commit: ${commitMsg}`
+  };
+
+  return finalizeEvent(event, secretKey);
+}
+
+async function publishToRelay(relayUrl, event) {
+  try {
+    const relay = await Relay.connect(relayUrl);
+    await relay.publish(event);
+    console.log(`✓ Published to ${relayUrl}`);
+    relay.close();
+    return true;
+  } catch (err) {
+    console.log(`✗ Failed ${relayUrl}: ${err.message}`);
+    return false;
+  }
+}
+
+export async function run() {
+  console.log('\n📡 git-nostr-hook\n');
+
+  const privkeyHex = git('config nostr.privkey');
+  if (!privkeyHex) {
+    console.log('⚠ No nostr.privkey configured. Skipping.');
+    console.log('  Set with: git config nostr.privkey <hex-key>');
+    process.exit(0);
+  }
+
+  const secretKey = Uint8Array.from(Buffer.from(privkeyHex, 'hex'));
+  const event = buildRepoEvent(secretKey);
+
+  console.log('Event ID:', event.id);
+  console.log('Pubkey:', event.pubkey);
+  console.log('');
+
+  const results = await Promise.allSettled(
+    RELAYS.map(relay => publishToRelay(relay, event))
+  );
+
+  const succeeded = results.filter(r => r.status === 'fulfilled' && r.value).length;
+  console.log(`\n✓ Published to ${succeeded}/${RELAYS.length} relays\n`);
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  run().catch(err => {
+    console.error('Error:', err.message);
+    process.exit(1);
+  });
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "git-nostr-hook",
+  "version": "0.0.1",
+  "description": "Git hook that publishes repository state to Nostr (NIP-34)",
+  "type": "module",
+  "bin": {
+    "git-nostr-hook": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/"
+  ],
+  "keywords": [
+    "git",
+    "nostr",
+    "nip34",
+    "hook",
+    "post-commit"
+  ],
+  "author": "nostrapps",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nostrapps/git-nostr-hook.git"
+  },
+  "homepage": "https://github.com/nostrapps/git-nostr-hook",
+  "dependencies": {
+    "nostr-tools": "^2.7.0"
+  }
+}