formatting and clean up and hooks

.githooks/pre-commit

···
+#!/bin/bash
+
+# Get all staged files
+staged_files=$(git diff --cached --name-only --diff-filter=ACM)
+if [ -z "$staged_files" ]; then
+    echo "No staged files found."
+    exit 0
+fi
+
+echo "📦 staged files:"
+echo "$staged_files" | sed 's/^/  /'
+
+# Format all staged files that deno can handle
+formattable=$(echo "$staged_files" | grep -E '\.(ts|tsx|js|jsx|json|jsonc)$' || true)
+
+if [ -n "$formattable" ]; then
+    echo "🎨 deno fmt..."
+    echo "$formattable" | xargs deno fmt
+    
+    # Re-stage formatted files
+    echo "$formattable" | xargs git add
+    echo "  ✓ formatted and re-staged files"
+fi
+
+# Type check TypeScript files
+checkable=$(echo "$staged_files" | grep -E '\.(ts|tsx)$' || true)
+if [ -n "$checkable" ] && [ "$SKIP_DENO_CHECK" != "1" ]; then
+    failed=0
+    echo "🧹 deno lint..."
+    if echo "$checkable" | xargs deno lint --fix; then
+        echo "  ✓ lint passed"
+    else
+        echo "lint failed; skip with SKIP_DENO_CHECK=1 git commit"
+        echo "skip: SKIP_DENO_CHECK=1 git commit"
+        failed=1
+    fi
+    echo "🔧 deno check..."
+    if deno check; then
+        echo "  ✓ type check passed"
+    else
+        echo "type check failed; skip with SKIP_DENO_CHECK=1 git commit"
+        failed=1
+    fi
+
+    [[ $failed -ne 0 ]] && exit 1
+fi
+echo "🚀 All checks passed!"
+exit 0

readme.org

···
 
 * Development
 
+Run the pwa+server with:
+
 #+BEGIN_SRC bash
 $ deno run dev
 #+END_SRC
···
 - docker compose for deployment with self-hosted KV
 
 See [[./devlog.org]] for design and architecture information.
+
+* Contributing
+
+- run ~git config core.hooksPath .githooks~ to install pre-commit hooks for lint/fmt
+- not really open to contributions right now, come back later.
 
 * License & Copyright
 

src/types/branded-id.ts

···
 import { z } from "zod/v4";
 
 /** result from a branded id maker invocation */
-export interface BrandedIdResult<T extends string, Z extends z.ZodType> {
+export interface BrandedId<T extends string, Z extends z.ZodType> {
   generator: () => T;
   validator: (i?: unknown) => i is T;
   parser: (i?: unknown) => T;
···
 }
 
 /** given a branded id maker, return the branded id type */
-export type inferBrandedId<T> = T extends BrandedIdResult<infer U, infer _> ? U
+export type inferBrandedId<T> = T extends BrandedId<infer U, infer _> ? U
   : never;
 
 /**
···
     validator,
     parser,
     schema,
-  } satisfies BrandedIdResult<BrandType, typeof schema>;
+  } satisfies BrandedId<BrandType, typeof schema>;
 }