declapract-typescript-ehmpathy 0.41.0 → 0.42.0

package/dist/practices/cicd-common/best-practice/.github/workflows/.install.yml

@@ -5,10 +5,10 @@ on:
     outputs:
       node-modules-cache-key:
         description: a max(stable) cache key to the node modules of this commit's dependencies
-        value: ${{ jobs.npm.outputs.node-modules-cache-key }}
+        value: ${{ jobs.pnpm.outputs.node-modules-cache-key }}
 
 jobs:
-  npm:
+  pnpm:
     runs-on: ubuntu-24.04
     outputs:
       node-modules-cache-key: ${{ steps.cache.outputs.cache-primary-key }}
@@ -16,15 +16,18 @@ jobs:
       - name: checkout
         uses: actions/checkout@v3
 
+      - name: setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: set node-version
         uses: actions/setup-node@v3
         with:
-          node-version-file: '.nvmrc'
+          node-version-file: ".nvmrc"
 
       - name: node-modules deps hash
         id: deps-hash
         run: |
-          PACKAGE_DEPS_HASH=$(jq '.packages' package-lock.json | jq 'del(."".version)' | md5sum | awk '{print $1}');
+          PACKAGE_DEPS_HASH=$(md5sum pnpm-lock.yaml | awk '{print $1}');
           echo "PACKAGE_DEPS_HASH=$PACKAGE_DEPS_HASH"
           echo "package-deps-hash=$PACKAGE_DEPS_HASH" >> "$GITHUB_OUTPUT"
       - name: node-modules cache get
@@ -32,11 +35,11 @@ jobs:
         id: cache
         with:
           path: ./node_modules
-          key: ${{ runner.os }}-node-${{ steps.deps-hash.outputs.package-deps-hash }}
+          key: ${{ runner.os }}-pnpm-${{ steps.deps-hash.outputs.package-deps-hash }}
 
       - name: node-modules cache miss install
         if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci --ignore-scripts --prefer-offline --no-audit
+        run: pnpm install --frozen-lockfile --ignore-scripts
 
       - name: node-modules cache set
         if: steps.cache.outputs.cache-hit != 'true'

package/dist/practices/cicd-service/best-practice/.github/workflows/.deploy-sls.yml

@@ -67,14 +67,10 @@ jobs:
 
       - name: node-modules cache get
         uses: actions/cache/restore@v4
-        id: cache
         with:
           path: ./node_modules
           key: ${{ needs.install.outputs.node-modules-cache-key }}
-
-      - name: node-modules cache miss install
-        if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci --ignore-scripts --prefer-offline --no-audit
+          fail-on-cache-miss: true
 
       - name: deploy
         run: STAGE=${{ inputs.stage }} DEPLOYER_NAME=$GITHUB_ACTOR npm run deploy
@@ -107,14 +103,10 @@ jobs:
 
       - name: node-modules cache get
         uses: actions/cache/restore@v4
-        id: cache
         with:
           path: ./node_modules
           key: ${{ needs.install.outputs.node-modules-cache-key }}
-
-      - name: node-modules cache miss install
-        if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci --ignore-scripts --prefer-offline --no-audit
+          fail-on-cache-miss: true
 
       - name: vpc:tunnel:open
         if: inputs.needs-vpn-for-acceptance
@@ -160,14 +152,10 @@ jobs:
 
       - name: node-modules cache get
         uses: actions/cache/restore@v4
-        id: cache
         with:
           path: ./node_modules
           key: ${{ needs.install.outputs.node-modules-cache-key }}
-
-      - name: node-modules cache miss install
-        if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci --ignore-scripts --prefer-offline --no-audit
+          fail-on-cache-miss: true
 
       - name: prune
         run: STAGE=${{ inputs.stage }} DEPLOYER_NAME=$GITHUB_ACTOR npm run deploy:prune

package/dist/practices/cicd-service/best-practice/.github/workflows/.sql-schema-control.yml

@@ -48,14 +48,10 @@ jobs:
 
       - name: node-modules cache get
         uses: actions/cache/restore@v4
-        id: cache
         with:
           path: ./node_modules
           key: ${{ needs.install.outputs.node-modules-cache-key }}
-
-      - name: node-modules cache miss install
-        if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci --ignore-scripts --prefer-offline --no-audit
+          fail-on-cache-miss: true
 
       - name: configure aws credentials
         uses: aws-actions/configure-aws-credentials@v1
@@ -114,14 +110,10 @@ jobs:
 
       - name: node-modules cache get
         uses: actions/cache/restore@v4
-        id: cache
         with:
           path: ./node_modules
           key: ${{ needs.install.outputs.node-modules-cache-key }}
-
-      - name: node-modules cache miss install
-        if: steps.cache.outputs.cache-hit != 'true'
-        run: npm ci --ignore-scripts --prefer-offline --no-audit
+          fail-on-cache-miss: true
 
       - name: configure aws credentials
         uses: aws-actions/configure-aws-credentials@v1

package/dist/practices/pnpm/bad-practices/package-lock-json/package-lock.json.declapract.ts

@@ -0,0 +1,3 @@
+import { FileCheckType } from 'declapract';
+
+export const check = FileCheckType.EXISTS;

package/dist/practices/pnpm/best-practice/.agent/repo=.this/skills/use.npm.alias.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+#
+# SKILL: use.npm.alias
+#
+# Installs shell aliases that redirect npm commands to pnpm for faster package management.
+#
+# What it does:
+#   1. Creates an alias 'npm.slow' pointing to the original npm binary
+#   2. Creates an alias 'npm' that redirects to pnpm
+#   3. Persists aliases to ~/.bash_aliases (sourced by ~/.bashrc)
+#
+# When to use:
+#   - After setting up a new development environment
+#   - When you want npm commands to use pnpm transparently
+#
+# Usage:
+#   ./.agent/repo=.this/skills/use.npm.alias.sh
+#
+set -euo pipefail
+
+BASH_ALIASES="${HOME}/.bash_aliases"
+
+# ensure ~/.bash_aliases exists
+touch "$BASH_ALIASES"
+
+# findsert npm.slow (only add if not already defined)
+if ! grep -q "^alias npm.slow=" "$BASH_ALIASES" 2>/dev/null; then
+  NPM_PATH=$(which npm)
+  echo "alias npm.slow=\"$NPM_PATH\"" >> "$BASH_ALIASES"
+  echo "Added: alias npm.slow=\"$NPM_PATH\""
+fi
+
+# upsert npm => pnpm
+if grep -q "^alias npm=" "$BASH_ALIASES" 2>/dev/null; then
+  sed -i 's/^alias npm=.*/alias npm="pnpm"/' "$BASH_ALIASES"
+else
+  echo 'alias npm="pnpm"' >> "$BASH_ALIASES"
+fi
+echo "Added: alias npm=\"pnpm\""
+
+# report
+echo ""
+echo "Aliases installed to $BASH_ALIASES"
+echo "Run 'source $BASH_ALIASES' or open a new terminal to activate."

package/dist/practices/pnpm/best-practice/package.json

@@ -0,0 +1,3 @@
+{
+  "packageManager": "pnpm@10.24.0"
+}

package/dist/practices/pnpm/best-practice/package.json.declapract.ts

@@ -0,0 +1,3 @@
+import { FileCheckType } from 'declapract';
+
+export const check = FileCheckType.CONTAINS;

package/dist/useCases.yml

@@ -17,6 +17,7 @@ use-cases:
       - prettier
       - tests
       - typescript
+      - pnpm
   npm-package:
     extends:
       - typescript-project

package/package.json

@@ -2,7 +2,7 @@
   "name": "declapract-typescript-ehmpathy",
   "author": "ehmpathy",
   "description": "declapract best practices declarations for typescript",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "license": "MIT",
   "main": "src/index.js",
   "repository": "ehmpathy/declapract-typescript-ehmpathy",