huntr-cli 1.0.9

package/.env.example

@@ -0,0 +1,7 @@
+# Huntr CLI Environment Variables
+# Copy this to .env and fill in your values
+# NOTE: .env is in .gitignore and will NOT be committed to version control
+
+# Your Huntr API token (obtained from DevTools console: await window.Clerk.session.getToken())
+# This is used for cross-platform authentication (macOS, Linux, Windows)
+HUNTR_API_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Report a bug or issue with huntr-cli
+title: "[BUG] "
+labels: bug
+assignees: ''
+
+---
+
+## Description
+A clear and concise description of what the bug is.
+
+## Environment
+- **OS:** macOS / Linux / Windows
+- **Node version:** (run `node --version`)
+- **CLI version:** (run `huntr --version`)
+- **Installation method:** npm global / local / npx
+
+## Steps to Reproduce
+Steps to reproduce the behavior:
+1. Run `huntr ...`
+2. Expected behavior...
+3. Actual behavior...
+
+## Expected Behavior
+What should happen?
+
+## Actual Behavior
+What actually happens?
+
+## Error Message
+```
+Paste any error messages or stack traces here
+```
+
+## Screenshots / Terminal Output
+If applicable, add screenshots or terminal output.
+
+## Additional Context
+Add any other context about the problem here.
+
+## Workaround (if any)
+If you found a workaround, describe it here.

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Huntr Community
+    url: https://huntr.co
+    about: Visit Huntr's main site
+  - name: GitHub Discussions
+    url: https://github.com/mattmck/huntr-cli/discussions
+    about: Join discussions about huntr-cli

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,29 @@
+---
+name: Feature request
+about: Suggest an idea for huntr-cli
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+
+---
+
+## Description
+A clear and concise description of the feature request.
+
+## Problem Statement
+Is your feature request related to a problem? Describe it.
+
+## Proposed Solution
+Describe how you'd like the feature to work.
+
+## Example Usage
+How would a user use this feature? Provide an example command or workflow.
+
+## Alternative Solutions
+Are there alternative ways to accomplish this?
+
+## Additional Context
+Add any other context, screenshots, or information.
+
+## Related Issues
+Link any related issues or discussions.

package/.github/labels.json

@@ -0,0 +1,92 @@
+[
+  {
+    "name": "type/bug",
+    "color": "d73a49",
+    "description": "Something isn't working"
+  },
+  {
+    "name": "type/feature",
+    "color": "a2eeef",
+    "description": "New feature or enhancement"
+  },
+  {
+    "name": "type/docs",
+    "color": "0075ca",
+    "description": "Documentation improvements"
+  },
+  {
+    "name": "type/chore",
+    "color": "ffc274",
+    "description": "Build, dependencies, or tooling"
+  },
+  {
+    "name": "type/refactor",
+    "color": "cccccc",
+    "description": "Code restructuring without functional change"
+  },
+  {
+    "name": "type/test",
+    "color": "5319e7",
+    "description": "Test improvements or fixes"
+  },
+  {
+    "name": "type/perf",
+    "color": "fbca04",
+    "description": "Performance improvements"
+  },
+  {
+    "name": "priority/critical",
+    "color": "b60205",
+    "description": "Blocking issue, needs immediate attention"
+  },
+  {
+    "name": "priority/high",
+    "color": "ff6b6b",
+    "description": "High priority, should be addressed soon"
+  },
+  {
+    "name": "priority/low",
+    "color": "e4e669",
+    "description": "Low priority, nice-to-have"
+  },
+  {
+    "name": "status/in-progress",
+    "color": "1f883d",
+    "description": "Currently being worked on"
+  },
+  {
+    "name": "status/blocked",
+    "color": "b60205",
+    "description": "Blocked by another issue or PR"
+  },
+  {
+    "name": "status/needs-review",
+    "color": "d4c5f9",
+    "description": "Waiting for code review"
+  },
+  {
+    "name": "status/needs-testing",
+    "color": "ffc274",
+    "description": "Ready for testing"
+  },
+  {
+    "name": "scope/cli",
+    "color": "c2e0c6",
+    "description": "Core CLI commands and features"
+  },
+  {
+    "name": "scope/auth",
+    "color": "c2e0c6",
+    "description": "Authentication and token management"
+  },
+  {
+    "name": "scope/output",
+    "color": "c2e0c6",
+    "description": "Output formatting (PDF, Excel, CSV, JSON, etc.)"
+  },
+  {
+    "name": "scope/infra",
+    "color": "c2e0c6",
+    "description": "CI/CD, GitHub Actions, build tooling"
+  }
+]

package/.github/pull_request_template.md

@@ -0,0 +1,64 @@
+## Description
+<!-- A concise description of the changes in this PR -->
+
+Closes # (issue number if applicable)
+
+## Type of Change
+<!-- Mark the relevant option(s) with an "x" -->
+
+- [ ] 🐛 Bug fix (non-breaking change that fixes an issue)
+- [ ] ✨ New feature (non-breaking change that adds functionality)
+- [ ] 📚 Documentation (docs-only changes)
+- [ ] 🔄 Refactor (code restructuring without behavior changes)
+- [ ] 🎨 Style (code style, linting, formatting)
+- [ ] ⚡ Performance (performance improvement)
+- [ ] 🔐 Security (security fix)
+- [ ] 🧪 Test (test-related changes)
+- [ ] 🔧 Chore (build, dependencies, CI/CD)
+- [ ] 💥 Breaking change (change that breaks backward compatibility)
+
+## Changes
+<!-- List the specific changes made in this PR -->
+
+- Change 1
+- Change 2
+- Change 3
+
+## Testing
+<!-- Describe how you tested these changes -->
+
+- [ ] Unit tests added/updated
+- [ ] Manual testing performed
+- [ ] No new testing needed
+
+**Test plan:**
+1. Step 1
+2. Step 2
+3. Verify result
+
+## Checklist
+<!-- Ensure all items are checked before submitting -->
+
+- [ ] Code follows project style guidelines
+- [ ] Self-review completed
+- [ ] Comments added for complex logic
+- [ ] Documentation updated if needed
+- [ ] No new warnings generated
+- [ ] Commit messages follow conventional commits
+- [ ] Tested locally with `npm run build && npm run lint && npm run typecheck`
+- [ ] No breaking changes (or documented)
+
+## Screenshots / Examples
+<!-- If applicable, add screenshots or examples of the change -->
+
+## Deployment Notes
+<!-- Any notes for deploying this change -->
+
+## Related Issues
+<!-- Link related issues -->
+
+Closes #
+Related to #
+
+## Additional Context
+<!-- Add any other context or information here -->

package/.github/workflows/ci.yml

@@ -0,0 +1,87 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint code
+        run: npm run lint
+
+  typecheck:
+    name: Typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 1
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test

package/.github/workflows/labels.yml

@@ -0,0 +1,27 @@
+name: Sync Labels
+
+on:
+  push:
+    paths:
+      - .github/labels.json
+    branches:
+      - main
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * 0'  # Weekly on Sundays at midnight UTC
+
+jobs:
+  sync-labels:
+    name: Sync GitHub Labels
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      issues: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Sync labels
+        uses: crazy-max/ghaction-github-labeler@v4
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          yaml-file: .github/labels.json

package/.github/workflows/manual-publish.yml

@@ -0,0 +1,105 @@
+name: Manual Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 1.1.0)'
+        required: true
+        type: string
+      npm_tag:
+        description: 'npm tag (e.g., latest, beta, next)'
+        required: false
+        default: 'latest'
+        type: choice
+        options:
+          - latest
+          - beta
+          - next
+          - rc
+
+jobs:
+  publish:
+    name: Manual npm Publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Verify version format
+        run: |
+          if ! [[ "${{ github.event.inputs.version }}" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-z0-9]+)?$ ]]; then
+            echo "❌ Invalid version format: ${{ github.event.inputs.version }}"
+            exit 1
+          fi
+          echo "✓ Valid version format"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Update package.json version
+        run: npm version "${{ github.event.inputs.version }}" --no-git-tag-version
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --tag "${{ github.event.inputs.npm_tag }}"
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create git tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "v${{ github.event.inputs.version }}" -m "Version ${{ github.event.inputs.version }}"
+          git push origin "v${{ github.event.inputs.version }}"
+
+      - name: Create GitHub Release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ github.event.inputs.version }}
+          release_name: Version ${{ github.event.inputs.version }}
+          body: |
+            Published to npm: https://www.npmjs.com/package/huntr-cli
+            Tag: ${{ github.event.inputs.npm_tag }}
+          draft: false
+          prerelease: ${{ github.event.inputs.npm_tag != 'latest' }}
+
+      - name: Slack notification (success)
+        if: success()
+        uses: slackapi/slack-github-action@v1.24.0
+        with:
+          payload: |
+            {
+              "text": "✅ huntr-cli v${{ github.event.inputs.version }} published to npm"
+            }
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
+
+      - name: Slack notification (failure)
+        if: failure()
+        uses: slackapi/slack-github-action@v1.24.0
+        with:
+          payload: |
+            {
+              "text": "❌ huntr-cli v${{ github.event.inputs.version }} publish failed"
+            }
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

package/.github/workflows/publish.yml

@@ -0,0 +1,57 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    name: Publish npm Package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub release comment
+        if: success() && github.event_name == 'release'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.repos.createRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag_name: '${{ github.event.release.tag_name }}',
+              body: `✅ Published to npm: https://www.npmjs.com/package/huntr-cli@${{ github.event.release.tag_name }}`
+            })
+
+      - name: Notify success
+        if: success()
+        run: echo "✅ Published huntr-cli@${{ github.event.release.tag_name || 'latest' }} to npm"
+
+      - name: Notify on failure
+        if: failure()
+        run: echo "❌ npm publish failed. Check workflow logs at https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"

package/.github/workflows/release.yml

@@ -0,0 +1,124 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'package.json'
+      - 'src/**'
+      - '.github/workflows/release.yml'
+
+jobs:
+  release:
+    name: Create Release & Artifacts
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: write
+    # The 'paths' filter above ensures this only runs on package.json changes
+    # Tag existence check prevents duplicate releases
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Get version from package.json
+        id: package
+        run: |
+          VERSION=$(jq -r '.version' package.json)
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=v$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Check if tag exists
+        id: check_tag
+        run: |
+          if git rev-parse "refs/tags/${{ steps.package.outputs.tag }}" >/dev/null 2>&1; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
+      - name: Create distribution archives
+        run: |
+          mkdir -p dist-archives
+          cd dist
+          tar -czf ../dist-archives/huntr-cli-${{ steps.package.outputs.version }}.tar.gz .
+          zip -r ../dist-archives/huntr-cli-${{ steps.package.outputs.version }}.zip .
+          cd ..
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          # Get commits since last tag
+          LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+          if [ -z "$LAST_TAG" ]; then
+            COMMITS=$(git log --oneline --format="- %s")
+          else
+            COMMITS=$(git log "$LAST_TAG..HEAD" --oneline --format="- %s")
+          fi
+
+          # Save to file for use in release body
+          echo "$COMMITS" > changelog.txt
+
+      - name: Create GitHub Release
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: ncipollo/release-action@v1
+        with:
+          tag: ${{ steps.package.outputs.tag }}
+          name: Version ${{ steps.package.outputs.version }}
+          bodyFile: changelog.txt
+          draft: false
+          prerelease: ${{ contains(steps.package.outputs.version, '-') }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload release assets
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-artifacts-${{ steps.package.outputs.version }}
+          path: dist-archives/
+          retention-days: 90
+
+      - name: Notify release created
+        if: steps.check_tag.outputs.exists == 'false'
+        run: |
+          echo "✅ Release v${{ steps.package.outputs.version }} created!"
+          echo "   Tag: ${{ steps.package.outputs.tag }}"
+          echo "   Artifacts uploaded"
+          echo "   Publishing to npm will start automatically..."
+
+      - name: Sleep before npm publish
+        if: steps.check_tag.outputs.exists == 'false'
+        run: sleep 10  # Give GitHub time to create release
+
+      - name: Trigger publish workflow
+        if: steps.check_tag.outputs.exists == 'false'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.actions.createWorkflowDispatch({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              workflow_id: 'publish.yml',
+              ref: 'main'
+            })

package/.github/workflows/security-audit.yml

@@ -0,0 +1,44 @@
+name: Security Audit
+
+on:
+  push:
+    branches: [main, develop]
+  schedule:
+    # Run daily at midnight UTC
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+
+jobs:
+  audit:
+    name: Audit Dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run npm audit
+        run: npm audit --audit-level=moderate
+        continue-on-error: true
+
+      - name: Report vulnerabilities
+        if: failure()
+        run: |
+          echo "⚠️  Vulnerabilities found. Run 'npm audit' locally for details."
+          npm audit --json > audit-report.json || true
+          cat audit-report.json
+
+      - name: Upload audit report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: npm-audit-report
+          path: audit-report.json
+          retention-days: 30