Initial release of new plugin v1.0.0 (#1)

* Adds a Salesforce CLI plugin that loads `.env` files before every `sf` command via a prerun hook, plus `sf dotenv inspect` and `sf dotenv export` subcommands
* The plugin includes `should-log-env` config, `SF_DOTENV_DISABLED` / `SF_DOTENV_FILE` env overrides
* The repo has been setup with Jest tests, ESLint/Prettier/Husky tooling, and a few GitHub actions to handle PRs and releases

---------

Co-authored-by: James Simone <16430727+jamessimone@users.noreply.github.com>

Author: jongpie

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: 'npm'
+    directory: '/'
+    schedule:
+      interval: 'weekly'
+    allow:
+      - dependency-type: 'production'
+    labels:
+      - 'dependency-update'

.github/workflows/build.yml

@@ -0,0 +1,38 @@
+name: Build
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths-ignore:
+      - 'README.md'
+      - 'LICENSE'
+      - '.gitignore'
+      - '.npmrc'
+      - '.prettierrc'
+      - '.prettierignore'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Verify code with ESLint
+        run: npm run lint:verify
+
+      - name: 'Verify formatting with Prettier'
+        run: npm run prettier:verify
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm run test:coverage

.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to NPM
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v5
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Verify tag matches package.json version
+        env:
+          REF_NAME: ${{ github.ref_name }}
+        run: |
+          TAG_VERSION="${REF_NAME#v}"
+          PKG_VERSION="$(node -p "require('./package.json').version")"
+          if [ "$TAG_VERSION" != "$PKG_VERSION" ]; then
+            echo "::error::Tag version ($TAG_VERSION) does not match package.json version ($PKG_VERSION)."
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,43 @@
+# Environment files
+.env*
+.sfdx
+
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build output
+lib/
+dist/
+build/
+oclif.manifest.json
+
+# Logs
+logs
+*.log
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# IDE files (project shared .vscode/settings.json and extensions.json are committed)
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

.lintstagedrc.cjs

@@ -0,0 +1,11 @@
+module.exports = {
+  '*.{ts,js,json,yml,yaml,md}': (filenames) => filenames.map((filename) => `prettier --write '${filename}'`),
+  '{src,test}/**/*.ts': (filenames) => {
+    if (filenames.length === 0) {
+      return [];
+    }
+
+    const quoted = filenames.map((f) => `"${f}"`).join(' ');
+    return [`eslint --fix ${quoted}`, 'npm run test'];
+  },
+};

.npmrc

@@ -0,0 +1 @@
+registry=https://registry.npmjs.org

.prettierignore

@@ -0,0 +1,12 @@
+# Dependencies
+node_modules/
+
+# Build output
+lib/
+coverage/
+oclif.manifest.json
+
+# Local IDE / agent state
+.claude/
+.sfdx/
+.vscode/

.prettierrc

@@ -0,0 +1,8 @@
+{
+  "printWidth": 120,
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "useTabs": false
+}