Rename source files to kebab-case; Clean up uri-util exports

- Rename contentProvider -> content-provider, uriUtil -> uri-util (src + test)
- Replace private SCHEME alias with single exported GIT_CRYPT_SCHEME constant
- Update architecture sections in CLAUDE.md and CONTRIBUTING.md

Author: j-256

CLAUDE.md

@@ -20,9 +20,9 @@ src/
   extension.ts        # Activation, FileDecorationProvider, wiring
   git.ts              # execFile wrappers for git and git-crypt commands
   detector.ts         # GitCryptDetector: cached Set<string> of git-crypt files per repo
-  contentProvider.ts  # resolveContent(): decodes git-crypt: URI -> decrypted text
+  content-provider.ts # resolveContent(): decodes git-crypt: URI -> decrypted text
   diff.ts             # showDiff(), registerDiffCommand(): opens vscode.diff editor
-  uriUtil.ts          # encode/decode git-crypt://<hash>/<ref>/<path>?<repoRoot> URIs
+  uri-util.ts         # encode/decode git-crypt://<hash>/<ref>/<path>?<repoRoot> URIs
 test/
   fixture.ts          # Creates temporary git-crypt repo for tests
   *.test.ts           # Unit tests (node:test + tsx)

CONTRIBUTING.md

@@ -49,9 +49,9 @@ src/
   extension.ts        # Activation, wiring, file decoration provider
   git.ts              # Low-level git/git-crypt command helpers (execFile, no shell)
   detector.ts         # Cached set of git-crypt files per repository
-  contentProvider.ts  # Resolves git-crypt: URIs to decrypted content
+  content-provider.ts # Resolves git-crypt: URIs to decrypted content
   diff.ts             # Diff command (opens vscode.diff editor)
-  uriUtil.ts          # Encode/decode git-crypt: URI scheme
+  uri-util.ts         # Encode/decode git-crypt: URI scheme
 ```
 
 The extension activates lazily (`onStartupFinished`), checks for `git-crypt` availability, scans workspace repositories for git-crypt files via `git check-attr`, and registers commands and providers. All git interaction uses `execFile` with array arguments (no shell) to prevent command injection.

src/contentProvider.ts src/content-provider.tssrc/contentProvider.ts renamed to src/content-provider.ts

@@ -1,5 +1,5 @@
 import { getTextConv } from './git.js';
-import { decodeGitCryptUri } from './uriUtil.js';
+import { decodeGitCryptUri } from './uri-util.js';
 
 export async function resolveContent(uriString: string): Promise<string> {
   const { repoRoot, ref, relPath } = decodeGitCryptUri(uriString);

src/diff.ts

@@ -1,7 +1,7 @@
 import * as vscode from 'vscode';
 import * as path from 'node:path';
 import { GitCryptDetector } from './detector.js';
-import { encodeGitCryptUri } from './uriUtil.js';
+import { encodeGitCryptUri } from './uri-util.js';
 
 export async function showDiff(
   detector: GitCryptDetector,

src/extension.ts

@@ -1,8 +1,8 @@
 import * as vscode from 'vscode';
 import { isGitCryptAvailable, isRepoUnlocked } from './git.js';
 import { GitCryptDetector } from './detector.js';
-import { resolveContent } from './contentProvider.js';
-import { GIT_CRYPT_SCHEME } from './uriUtil.js';
+import { resolveContent } from './content-provider.js';
+import { GIT_CRYPT_SCHEME } from './uri-util.js';
 import { registerDiffCommand } from './diff.js';
 
 const log = vscode.window.createOutputChannel('git-crypt Diff');

src/uriUtil.ts src/uri-util.tssrc/uriUtil.ts renamed to src/uri-util.ts

@@ -1,12 +1,12 @@
 import * as crypto from 'node:crypto';
 
-const SCHEME = 'git-crypt';
+export const GIT_CRYPT_SCHEME = 'git-crypt';
 
 export function encodeGitCryptUri(repoRoot: string, ref: string, relPath: string): string {
   const rootHash = crypto.createHash('sha256').update(repoRoot).digest('hex').slice(0, 8);
   // Store repoRoot in query so it survives URI encoding round-trips
   const query = encodeURIComponent(repoRoot);
-  return `${SCHEME}://${rootHash}/${encodeURIComponent(ref)}/${relPath}?${query}`;
+  return `${GIT_CRYPT_SCHEME}://${rootHash}/${encodeURIComponent(ref)}/${relPath}?${query}`;
 }
 
 export interface DecodedGitCryptUri {
@@ -16,15 +16,15 @@ export interface DecodedGitCryptUri {
 }
 
 export function decodeGitCryptUri(uriString: string): DecodedGitCryptUri {
-  if (!uriString.startsWith(`${SCHEME}://`)) {
-    throw new Error(`Not a ${SCHEME} URI: ${uriString}`);
+  if (!uriString.startsWith(`${GIT_CRYPT_SCHEME}://`)) {
+    throw new Error(`Not a ${GIT_CRYPT_SCHEME} URI: ${uriString}`);
   }
 
   // Parse: git-crypt://<hash>/<ref>/<relPath>?<repoRoot>
-  const withoutScheme = uriString.slice(`${SCHEME}://`.length);
+  const withoutScheme = uriString.slice(`${GIT_CRYPT_SCHEME}://`.length);
   const queryIdx = withoutScheme.indexOf('?');
   if (queryIdx === -1) {
-    throw new Error(`Malformed ${SCHEME} URI (missing query): ${uriString}`);
+    throw new Error(`Malformed ${GIT_CRYPT_SCHEME} URI (missing query): ${uriString}`);
   }
 
   const pathPart = withoutScheme.slice(0, queryIdx);
@@ -33,19 +33,17 @@ export function decodeGitCryptUri(uriString: string): DecodedGitCryptUri {
   // pathPart = "<hash>/<ref>/<relPath>"
   const firstSlash = pathPart.indexOf('/');
   if (firstSlash === -1) {
-    throw new Error(`Malformed ${SCHEME} URI (missing ref): ${uriString}`);
+    throw new Error(`Malformed ${GIT_CRYPT_SCHEME} URI (missing ref): ${uriString}`);
   }
 
   const afterHash = pathPart.slice(firstSlash + 1);
   const secondSlash = afterHash.indexOf('/');
   if (secondSlash === -1) {
-    throw new Error(`Malformed ${SCHEME} URI (missing path): ${uriString}`);
+    throw new Error(`Malformed ${GIT_CRYPT_SCHEME} URI (missing path): ${uriString}`);
   }
 
   const ref = decodeURIComponent(afterHash.slice(0, secondSlash));
   const relPath = afterHash.slice(secondSlash + 1);
 
   return { repoRoot, ref, relPath };
 }
-
-export const GIT_CRYPT_SCHEME = SCHEME;

test/contentProvider.test.ts test/content-provider.test.tstest/contentProvider.test.ts renamed to test/content-provider.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, before, after } from 'node:test';
 import * as assert from 'node:assert/strict';
-import { resolveContent } from '../src/contentProvider.js';
-import { encodeGitCryptUri } from '../src/uriUtil.js';
+import { resolveContent } from '../src/content-provider.js';
+import { encodeGitCryptUri } from '../src/uri-util.js';
 import { createFixture, destroyFixture, type TestFixture } from './fixture.js';
 
 let fixture: TestFixture;

test/uriUtil.test.ts test/uri-util.test.tstest/uriUtil.test.ts renamed to test/uri-util.test.ts

@@ -1,6 +1,6 @@
 import { describe, it } from 'node:test';
 import * as assert from 'node:assert/strict';
-import { encodeGitCryptUri, decodeGitCryptUri } from '../src/uriUtil.js';
+import { encodeGitCryptUri, decodeGitCryptUri } from '../src/uri-util.js';
 
 describe('encodeGitCryptUri', () => {
   it('encodes a repo root, ref, and path into a URI string', () => {