feat: add npm workspaces and developer quick start (#199)

* feat: add npm workspaces and developer quick start
- Add npm workspaces configuration to root package.json
- Add lint:all, test:all, compile:all, watch:all scripts
- Add .nvmrc with Node.js 20
- Add Quick Start for Developers section to README
- Add Extension Initialization Flow diagram (Mermaid)

🖥️ IDE: [Cursor](https://cursor.sh)
🔌 Extension: [Claude Code](https://claude.ai/download)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Model-Raw: claude-opus-4-5-20251101

* fix(ci): use workspace-specific npm ci for extension isolation
- Change npm ci to npm ci --workspace=git-id-switcher in all workflows
- Use matrix variable in hash-check.yml for future extension support
- Ensures each extension's CI runs independently without interference

🖥️ IDE: [Cursor](https://cursor.sh)
🔌 Extension: [Claude Code](https://claude.ai/download)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Model-Raw: claude-opus-4-5-20251101

* fix(ci): restore original workflow structure and handle husky in CI
- Revert workflows to working-directory approach (pre-workspace change)
- Add || true to prepare script to handle husky absence in CI
- CI runs npm ci in extensions/git-id-switcher directory
- Local development still works with npm workspaces from root

🖥️ IDE: [Cursor](https://cursor.sh)
🔌 Extension: [Claude Code](https://claude.ai/download)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Model-Raw: claude-opus-4-5-20251101

* fix(package): add --no-dependencies flag to vsce package
Prevents vsce from traversing workspace dependencies in npm workspaces
environment, which caused invalid relative path errors when packaging.

🖥️ IDE: [Cursor](https://cursor.sh)
🔌 Extension: [Claude Code](https://claude.ai/download)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Model-Raw: claude-opus-4-5-20251101

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: nullvariant

.nvmrc

@@ -0,0 +1 @@
+20

README.md

@@ -40,6 +40,49 @@ VS Code extensions by [Null;Variant](https://github.com/nullvariant).
 
 <img src="https://assets.nullvariant.com/nullvariant-vscode-extensions/extensions/git-id-switcher/images/demo.png" width="600" alt="Git ID Switcher Demo">
 
+## Quick Start for Developers
+
+Get started in 5 steps:
+
+```bash
+# 1. Clone
+git clone https://github.com/nullvariant/nullvariant-vscode-extensions.git
+cd nullvariant-vscode-extensions
+
+# 2. Install dependencies (from repository root)
+npm install
+
+# 3. Compile
+npm run compile:all
+
+# 4. Run tests
+npm run test:all
+
+# 5. Start watch mode for development
+npm run watch:all
+```
+
+For linting: `npm run lint:all`
+
+## Extension Initialization Flow
+
+```mermaid
+flowchart TD
+    A[Extension Activated] --> B{Workspace Trusted?}
+    B -->|No| C[Restricted Mode]
+    B -->|Yes| D[initializeState]
+    D --> E{Saved Identity?}
+    E -->|Yes| I[Apply Identity]
+    E -->|No| F{Detect from Git Config?}
+    F -->|Yes| I
+    F -->|No| G{Detect from SSH Agent?}
+    G -->|Yes| I
+    G -->|No| H[No Identity]
+    I --> J[Update Status Bar]
+    H --> J
+    J --> K[Ready]
+```
+
 ## Development
 
 ### Prerequisites

extensions/git-id-switcher/package.json

@@ -271,7 +271,7 @@
     "test:coverage": "npm run compile && npx c8 --reporter=lcov --reporter=text node out/test/runTests.js",
     "test:fuzz": "npm run compile && node -e \"require('./out/test/validation.fuzz.test').runFuzzingTests()\"",
     "test:e2e": "npm run compile && vscode-test",
-    "package": "vsce package",
+    "package": "vsce package --no-dependencies",
     "publish": "echo '❌ Do not use vsce publish directly. Push a tag instead: git tag git-id-switcher-vX.X.X && git push --tags' && exit 1",
     "generate:readme": "node scripts/generate-root-readme.js"
   },

extensions/git-id-switcher/src/documentation.internal.ts

@@ -58,7 +58,7 @@ export const DOCUMENT_HASHES: Record<string, string> = {
   'extensions/git-id-switcher/LICENSE': 'e2383295422577622666fa2ff00e5f03abd8f2772d74cca5d5443020ab23d03d',
   'extensions/git-id-switcher/README.md': 'cc8dc766afdd43c1fb9051b5270617382c845ebabd103654f190ce63850e3c6e',
   'LICENSE': 'e2383295422577622666fa2ff00e5f03abd8f2772d74cca5d5443020ab23d03d',
-  'README.md': '65c7c62bae6132227288b5a230c21b9be5591f5e55da9143f0f7405e9e6bb190',
+  'README.md': 'e6c0c4e5924873eabd0e49973e29457abc5e8171ba4ff9da77700e6a19c28f9d',
   'SECURITY.md': '72dbadafd9a5caaa4e16f6b1f19a5255f7f84310432bf3c8207c163f5f8088da',
 };