huntr-cli 1.0.9

package/tests/example.test.ts

@@ -0,0 +1,130 @@
+/**
+ * Example test suite to verify huntr-cli workflow
+ * 
+ * Run tests: npm test
+ * Run specific test: npm test -- --testNamePattern="boards"
+ */
+
+import { describe, it, expect } from 'vitest';
+
+describe('huntr-cli Workflow Tests', () => {
+  describe('Command Structure', () => {
+    it('should have huntr command configured in package.json bin', () => {
+      // This test verifies the command structure is correct
+      expect(process.env.npm_package_bin_huntr).toBeDefined();
+    });
+
+    it('should support boards list command', () => {
+      // Test that the boards list command exists
+      const commands = ['boards', 'jobs', 'activities'];
+      expect(commands).toContain('boards');
+    });
+
+    it('should support output format options', () => {
+      // Test that output formats are available
+      const formats = ['table', 'json', 'csv', 'pdf', 'excel'];
+      expect(formats.length).toBe(5);
+      expect(formats).toContain('json');
+      expect(formats).toContain('csv');
+    });
+  });
+
+  describe('Build & Compilation', () => {
+    it('should compile TypeScript without errors', () => {
+      // This test is skipped but documents the workflow
+      // In real CI, tsc --noEmit runs before tests
+      expect(true).toBe(true);
+    });
+
+    it('should pass linting checks', () => {
+      // This test documents that eslint runs in CI
+      // Pre-commit and pre-push hooks enforce this locally
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('Git Workflow', () => {
+    it('should enforce conventional commits', () => {
+      // Example commit types that should be used
+      const validTypes = ['feat', 'fix', 'docs', 'chore', 'refactor', 'test', 'perf'];
+      expect(validTypes).toContain('feat');
+      expect(validTypes).toContain('fix');
+    });
+
+    it('should trigger pre-commit hook on git commit', () => {
+      // Pre-commit hook runs eslint --fix automatically
+      expect(true).toBe(true);
+    });
+
+    it('should trigger pre-push hook on git push', () => {
+      // Pre-push hook runs: typecheck → lint → build
+      expect(true).toBe(true);
+    });
+  });
+
+  describe('Publishing Workflow', () => {
+    it('should auto-publish to npm on GitHub Release', () => {
+      // publish.yml triggers on GitHub Release
+      // Runs full CI then npm publish
+      expect(true).toBe(true);
+    });
+
+    it('should create artifacts on version bump', () => {
+      // release.yml detects version change
+      // Creates tar.gz and zip archives
+      // Creates GitHub Release with artifacts
+      expect(true).toBe(true);
+    });
+
+    it('should support semantic versioning', () => {
+      // npm version major|minor|patch
+      // Versions should follow semver: X.Y.Z
+      const semverRegex = /^\d+\.\d+\.\d+$/;
+      expect('1.0.0').toMatch(semverRegex);
+      expect('1.1.0').toMatch(semverRegex);
+      expect('2.0.0').toMatch(semverRegex);
+    });
+  });
+
+  describe('Output Formatting', () => {
+    it('should support field selection with --fields', () => {
+      // Example: huntr boards list --fields ID,Name
+      const fieldSelection = {
+        command: 'huntr boards list',
+        option: '--fields ID,Name',
+        supported: true,
+      };
+      expect(fieldSelection.supported).toBe(true);
+    });
+
+    it('should support multiple output formats', () => {
+      const formats = {
+        table: 'human-readable (default)',
+        json: 'machine-readable',
+        csv: 'spreadsheet import',
+        pdf: 'document export',
+        excel: 'spreadsheet (.xlsx)',
+      };
+      expect(Object.keys(formats).length).toBe(5);
+      expect(formats.table).toBeDefined();
+    });
+  });
+
+  describe('Documentation', () => {
+    it('should have complete documentation', () => {
+      const docs = [
+        'DEV-SETUP.md',
+        'CI-CD-SETUP.md',
+        'AUTOMATIC-PUBLISHING.md',
+        'ENTITY-TYPES.md',
+        'OUTPUT-FORMATS.md',
+      ];
+      expect(docs.length).toBe(5);
+    });
+
+    it('should have man page for huntr command', () => {
+      // completions/huntr.1 is available for: man huntr
+      expect(true).toBe(true);
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}