Spike: npm -> pnpm

.github/workflows/build.yml

@@ -52,12 +52,15 @@
 
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate tsconfig
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
@@ -75,7 +78,7 @@
         run: ./node_modules/.bin/nx test api
       - run: cp apps/api/docker-package.json dist/apps/api/.
       - run: cp package.json dist/apps/api/.
-      - run: cp package-lock.json dist/apps/api/.
+      - run: cp pnpm-lock.yaml dist/apps/api/.
       - run: cp tsconfig.base.effective.json dist/apps/api/.
 
       - name: Upload API build artifacts
@@ -95,22 +98,25 @@
 
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate tsconfig
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
         run: node scripts/select-tsconfig.mjs
       - name: Generate Chakra types
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
-        run: npm run chakra:typegen
+        run: pnpm chakra:typegen
       - name: Typechecks
-        run: npm run typecheck:frontend
+        run: pnpm typecheck:frontend
       - name: Test Frontend
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
@@ -144,12 +150,15 @@
 
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate tsconfig
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
@@ -165,6 +174,7 @@
           NODE_OPTIONS: '--max-old-space-size=16384 --no-experimental-strip-types'
         run: ./node_modules/.bin/nx test mcp-server
       - run: cp tsconfig.base.effective.json dist/apps/mcp-server/.
+      - run: cp pnpm-lock.yaml dist/apps/mcp-server/.
 
       - name: Upload MCP-Server build artifacts
         uses: actions/upload-artifact@v4
@@ -183,12 +193,15 @@
 
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate tsconfig
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
@@ -224,11 +237,14 @@
 
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Set up Bun
         uses: oven-sh/setup-bun@v2
@@ -239,7 +255,7 @@
         id: get-version
         run: echo "version=$(node -p "require('./apps/cli/package.json').version")" >> $GITHUB_OUTPUT
 
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate tsconfig
         env:
           PACKMIND_EDITION: ${{ vars.PACKMIND_EDITION }}
@@ -272,6 +288,9 @@
           echo "Built executables (with embedded WASM files):"
           ls -lh dist/apps/cli-executables/
 
+      - name: Install dist CLI runtime dependencies
+        run: sh scripts/install-dist-cli-deps.sh
+
       - name: Test executables
         run: |
           node dist/apps/cli/main.cjs --version
@@ -300,14 +319,17 @@
 
     steps:
       - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
 
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
+          cache: 'pnpm'
 
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+      - run: pnpm install --frozen-lockfile --prefer-offline
 
       - name: Generate tsconfig
         env:
@@ -316,6 +338,9 @@
 
       - run: ./node_modules/.bin/nx run packmind-cli:build
 
+      - name: Install dist CLI runtime dependencies
+        run: sh scripts/install-dist-cli-deps.sh
+
       - name: Fix CLI artifacts permissions
         run: |
           chmod +x dist/apps/cli/main.cjs || true
@@ -358,12 +383,12 @@
           NODE_OPTIONS: '--max-old-space-size=16384 --no-experimental-strip-types'
         run: ./node_modules/.bin/nx test cli-e2e-tests
 
-      - name: Install latest production CLI from npm
+      - name: Install latest production CLI from registry
         run: |
           PROD_CLI_DIR="$(mktemp -d)"
           cd "${PROD_CLI_DIR}"
-          npm init -y --silent
-          npm install @packmind/cli
+          pnpm init
+          pnpm add @packmind/cli
           CLI_BINARY_PATH="$(node -e "console.log(require.resolve('@packmind/cli'))")"
           cd -
           echo "Installed CLI version: $(node "${CLI_BINARY_PATH}" --version)"

.github/workflows/docker.yml

@@ -92,11 +92,15 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
+
       - name: Set up Node.js ${{ inputs.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ inputs.node-version }}
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Get package version
         id: get-version
@@ -145,7 +149,7 @@ jobs:
           fi
 
       - name: Install dependencies
-        run: npm ci --ignore-scripts --no-audit --no-fund
+        run: pnpm install --frozen-lockfile --prefer-offline
 
       # Download all build artifacts
       - name: Download API build artifacts

.github/workflows/quality.yml

@@ -58,12 +58,15 @@
       - uses: actions/checkout@v4
         with:
           fetch-depth: 10
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate Proprietary tsconfig
         env:
           PACKMIND_EDITION: ${{ env.ENTERPRISE_EDITION }}
@@ -73,7 +76,7 @@
           PACKMIND_EDITION: ${{ env.ENTERPRISE_EDITION }}
         run: ./node_modules/.bin/nx run-many -t lint --tuiAutoExit
       - name: Check code formatting
-        run: npm run prettier:check
+        run: pnpm prettier:check
 
   sonarqube:
     if: vars.PACKMIND_EDITION != 'proprietary'
@@ -87,12 +90,15 @@
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
       - name: Use Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      - run: npm ci --ignore-scripts --no-audit --no-fund
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile --prefer-offline
       - name: Generate Proprietary tsconfig
         env:
           PACKMIND_EDITION: ${{ env.ENTERPRISE_EDITION }}

.github/workflows/tmp-cli-lint-windows.yml

@@ -18,17 +18,25 @@
       - name: Checkout
         uses: actions/checkout@v4
 
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
+
       - name: Use Node.js 24.15.0
         uses: actions/setup-node@v4
         with:
           node-version: '24.15.0'
-          cache: 'npm'
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: npm ci --ignore-scripts --no-audit --no-fund
+        run: pnpm install --frozen-lockfile --prefer-offline
 
       - name: Build CLI
-        run: npm run packmind-cli:build
+        run: pnpm packmind-cli:build
+
+      - name: Install dist CLI runtime dependencies
+        shell: bash
+        run: sh scripts/install-dist-cli-deps.sh
 
       - name: Run CLI lint
         run: node dist/apps/cli/main.cjs lint .

.gitignore

@@ -49,4 +49,7 @@ apps/mcp-server/key.pem
 docker/nginx/ssl
 
 .nx/polygraph
-.nx/self-healing
+.nx/self-healing
+
+# Node.js V8 compile cache (auto-generated by Node 22+ when NODE_COMPILE_CACHE is set)
+node-compile-cache/

.husky/pre-commit

@@ -1,2 +1,2 @@
-npx pretty-quick --staged
+pnpm exec pretty-quick --staged
 scripts/precommit-lint.sh

.npmrc

@@ -0,0 +1,8 @@
+package-manager-strict=false
+auto-install-peers=true
+strict-peer-dependencies=false
+shamefully-hoist=false
+enable-pre-post-scripts=true
+public-hoist-pattern[]=@types/*
+public-hoist-pattern[]=*eslint*
+public-hoist-pattern[]=*prettier*

apps/api/docker-package.json

@@ -6,7 +6,7 @@
   "main": "main.js",
   "engines": {
     "node": "24.15.0",
-    "npm": "11.12.1"
+    "pnpm": ">=9.0.0 <10.0.0"
   },
   "dependencies": {
     "@amplitude/analytics-node": "^1.5.18",

apps/cli/jest.config.ts

@@ -11,6 +11,6 @@
   moduleFileExtensions: standardModuleFileExtensions,
   coverageDirectory: '../../coverage/apps/cli',
   transformIgnorePatterns: [
-    '/node_modules/(?!(chalk|#ansi-styles|#supports-color|slug)/)',
+    'node_modules/(?!(?:.*[\\\\/])?(chalk|#ansi-styles|#supports-color|slug)[@\\\\/])',
   ],
 };

apps/cli/package.json

@@ -36,10 +36,13 @@
   },
   "dependencies": {
     "@types/inquirer": "^9.0.9",
+    "dotenv": "^16",
     "inquirer": "^13.0.2",
-    "zod": "^4.3.5",
+    "minimatch": "^10",
     "semver": "^7.7.4",
-    "which": "^4.0.0"
+    "undici": "^7",
+    "which": "^4.0.0",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
     "@types/which": "^3.0.4"

apps/frontend/jest.config.ts

@@ -20,7 +20,7 @@ module.exports = {
     ],
   },
   transformIgnorePatterns: [
-    '/node_modules/(?!(slug|marked|@chakra-ui|@zag-js|framer-motion|lucide-react)).+\\.[tj]sx?$',
+    'node_modules/(?!(?:.*[\\\\/])?(slug|marked|@chakra-ui|@zag-js|framer-motion|lucide-react)[@\\\\/]).+\\.[tj]sx?$',
   ],
   testMatch: ['<rootDir>/src/**/*.(spec|test).[jt]s?(x)'],
   setupFilesAfterEnv: ['<rootDir>/src/test-setup.ts'],

apps/frontend/package.json

@@ -3,6 +3,7 @@
   "version": "0.0.0",
   "private": true,
   "dependencies": {
+    "@packmind/assets": "workspace:*",
     "@types/nprogress": "0.2.3",
     "nprogress": "0.2.0"
   }