docs: add comprehensive Postman Native Git cookbook

Add complete cookbook demonstrating how to integrate Postman collections
into existing development workflows using Native Git capabilities.

Documentation added:
- README.md: Main cookbook with quick start and workflow overview
- docs/SETUP.md: Step-by-step setup guide for all platforms
- docs/SPECTRAL.md: Spectral linting guide with security rules
- docs/CI_CD.md: CI/CD integration (GitHub Actions, GitLab, CircleCI)
- docs/COMMIT_HOOKS.md: Git hooks setup and configuration
- docs/TESTING.md: Testing guide for the example API
- docs/QUICK_REFERENCE.md: Quick command reference

GitHub Actions workflows:
- spectral-lint.yaml: Lint collections on changes
- run-collections.yaml: Run collections on PRs with matrix testing
- secret-scan.yaml: Scan for exposed credentials
- scheduled-health-check.yaml: Automated API health monitoring
- postman.yaml: Publish to Postman workspace

Git hooks and configuration:
- .husky/pre-commit: Run linting, tests, and collections
- .husky/pre-commit-examples.sh: 10 hook pattern examples
- .spectral.yaml: Collection linting rules with security checks
- .spectral/lint-with-names.js: Enhanced linting script

Example implementation:
- Express.js banking API (src/)
- Jest unit and integration tests (tests/)
- Postman collections with test scripts (postman/collections/)
- OpenAPI specification (openapi/)
- Environment files and globals (postman/environments/)

Workflows covered:
1. Pre-commit/pre-push hooks with Postman collections
2. CI/CD pipeline integration with automated testing
3. Spectral linting for enforcing collection best practices
4. Secret detection to prevent credential exposure

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Gbahdeyboh

.eslintignore

@@ -0,0 +1,8 @@
+node_modules/
+coverage/
+dist/
+build/
+*.min.js
+.postman/
+openapi/.openapi-generator-ignore
+

.eslintrc.json

@@ -0,0 +1,66 @@
+{
+  "env": {
+    "node": true,
+    "es2021": true,
+    "jest": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:node/recommended"
+  ],
+  "plugins": [
+    "jest"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "rules": {
+    "indent": ["error", 2],
+    "linebreak-style": ["error", "unix"],
+    "quotes": ["error", "single"],
+    "semi": ["error", "always"],
+    "no-console": "off",
+    "no-unused-vars": ["error", { 
+      "argsIgnorePattern": "^_",
+      "varsIgnorePattern": "^_"
+    }],
+    "no-var": "error",
+    "prefer-const": "error",
+    "prefer-arrow-callback": "warn",
+    "arrow-spacing": ["error", { "before": true, "after": true }],
+    "comma-dangle": ["error", "never"],
+    "no-multiple-empty-lines": ["error", { "max": 2, "maxEOF": 1 }],
+    "eol-last": ["error", "always"],
+    "object-curly-spacing": ["error", "always"],
+    "array-bracket-spacing": ["error", "never"],
+    "keyword-spacing": ["error", { "before": true, "after": true }],
+    "space-before-function-paren": ["error", {
+      "anonymous": "always",
+      "named": "never",
+      "asyncArrow": "always"
+    }],
+    "space-before-blocks": "error",
+    "node/no-unpublished-require": "off",
+    "node/no-missing-require": "off",
+    "node/no-unsupported-features/es-syntax": ["error", {
+      "ignores": ["modules"]
+    }]
+  },
+  "overrides": [
+    {
+      "files": ["tests/**/*.js", "**/*.test.js", "**/*.spec.js"],
+      "env": {
+        "jest": true
+      },
+      "rules": {
+        "jest/no-disabled-tests": "warn",
+        "jest/no-focused-tests": "error",
+        "jest/no-identical-title": "error",
+        "jest/prefer-to-have-length": "warn",
+        "jest/valid-expect": "error"
+      }
+    }
+  ]
+}
+

.github/workflows/postman.yaml

@@ -0,0 +1,32 @@
+name: Publish to Postman Workspace
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  postman:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "yarn"
+
+      - run: curl -o- "https://dl-cli.pstmn.io/install/unix.sh" | sh
+
+      - name: Validate and sync
+        env:
+          POSTMAN_API_KEY: ${{ secrets.POSTMAN_API_KEY }}
+        run: |
+          postman login --with-api-key "$POSTMAN_API_KEY"
+          yarn install --frozen-lockfile
+          yarn start &
+          sleep 3
+          yarn test:api
+          postman workspace push -y

.github/workflows/run-collections.yaml

@@ -0,0 +1,129 @@
+name: Run Postman Collections
+
+on:
+  pull_request:
+    branches: [main, develop]
+  push:
+    branches: [main, develop]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  test-collections:
+    name: Test Collections
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18, 20]
+      fail-fast: false
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Postman CLI
+        run: curl -o- "https://dl-cli.pstmn.io/install/unix.sh" | sh
+
+      - name: Run unit and integration tests
+        run: npm test
+
+      - name: Start API server
+        run: |
+          npm start &
+          SERVER_PID=$!
+          echo "SERVER_PID=$SERVER_PID" >> $GITHUB_ENV
+
+      - name: Wait for server to be ready
+        run: |
+          timeout 60 bash -c '
+            until curl -f -s http://localhost:3000/health > /dev/null 2>&1; do
+              echo "Waiting for server to start..."
+              sleep 2
+            done
+          '
+          echo "✅ Server is ready!"
+
+      - name: Authenticate with Postman
+        env:
+          POSTMAN_API_KEY: ${{ secrets.POSTMAN_API_KEY }}
+        run: postman login --with-api-key "$POSTMAN_API_KEY"
+
+      - name: Run Postman collections
+        run: |
+          for collection in postman/collections/*.postman_collection.json; do
+            if [ -f "$collection" ]; then
+              echo "📬 Running collection: $(basename "$collection")"
+              postman collection run "$collection" \
+                --reporter cli,json \
+                --reporter-json-export "results-$(basename "$collection" .json).json"
+
+              if [ $? -ne 0 ]; then
+                echo "❌ Collection failed: $collection"
+                exit 1
+              fi
+            fi
+          done
+          echo "✅ All collections passed!"
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: postman-results-node-${{ matrix.node-version }}
+          path: results-*.json
+          retention-days: 7
+
+      - name: Stop server
+        if: always()
+        run: |
+          if [ -n "$SERVER_PID" ]; then
+            kill $SERVER_PID 2>/dev/null || true
+          fi
+
+      - name: Comment on PR with results
+        if: always() && github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          script: |
+            const fs = require('fs');
+            const results = fs.readdirSync('.')
+              .filter(file => file.startsWith('results-') && file.endsWith('.json'));
+
+            let passed = 0;
+            let failed = 0;
+
+            results.forEach(file => {
+              try {
+                const data = JSON.parse(fs.readFileSync(file, 'utf8'));
+                if (data.run && data.run.stats) {
+                  passed += data.run.stats.tests.passed || 0;
+                  failed += data.run.stats.tests.failed || 0;
+                }
+              } catch (e) {
+                console.error(`Error reading ${file}:`, e);
+              }
+            });
+
+            const status = failed === 0 ? '✅' : '❌';
+            const message = `${status} **Postman Collections Test Results (Node ${{ matrix.node-version }})**
+
+            - ✅ Passed: ${passed}
+            - ❌ Failed: ${failed}
+            - 📊 Total: ${passed + failed}
+            `;
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: message
+            });