feat(scanner): Multi-language repository scanner with 94.47% test coverage (#13)

* feat(scanner): implement multi-language scanner with TypeScript and Markdown support

- Add scanner type definitions and interfaces
- Implement TypeScriptScanner using ts-morph for deep AST analysis
- Implement MarkdownScanner using remark for documentation
- Create ScannerRegistry for managing multiple language scanners
- Add comprehensive tests (all passing)
- Fix pre-commit hook to use correct Biome syntax

Features:
- TypeScript: extracts functions, classes, methods, interfaces with type info
- Markdown: extracts documentation sections with headings
- Pluggable architecture: easy to add more language scanners
- Tested on dev-agent codebase itself

Issue: #3

* test(scanner): improve test coverage to 94.47% and add comprehensive exclusions

Coverage improvements:
- Overall scanner package: 88.02% → 94.47% (+6.45%)
- Registry: 68.42% → 100% (+31.58% - perfect coverage!)
- Tests: 8 → 24 tests (tripled)

New test coverage:
- Scanner error handling and recovery
- Language-specific scanner retrieval
- Auto glob pattern building
- Default exclusions verification
- Mixed language repositories
- Method extraction from classes
- Case-insensitive file extensions

Best practice exclusions (industry standards):
- Dependencies: node_modules, vendor, bower_components, third_party
- Build artifacts: dist, build, out, target, .next, .turbo
- Version control: .git, .svn, .hg
- IDE/Editor: .vscode, .idea, .vs, .fleet
- Caches: .cache, .parcel-cache, .eslintcache
- Test coverage: coverage, .nyc_output
- Lock files: package-lock.json, yarn.lock, pnpm-lock.yaml
- Analysis/reports: analysis-reports, .research, benchmarks
- Test fixtures: __fixtures__, __snapshots__

Improvements:
- Case-insensitive file extension handling
- Comprehensive default exclusion patterns
- Better error handling documentation

Author: prosdev

.gitignore

@@ -13,6 +13,13 @@ out
 # TypeScript
 *.tsbuildinfo
 
+# Build artifacts in src (should only be in dist/)
+packages/*/src/**/*.js
+packages/*/src/**/*.d.ts
+packages/*/src/**/*.map
+!packages/*/src/**/*.test.js
+!packages/*/src/**/*.spec.js
+
 # Testing
 coverage
 

.husky/pre-commit

@@ -1,11 +1,17 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
 # Get staged files
-files=$(git diff --cached --name-only --diff-filter=ACMR "*.ts" "*.tsx" "*.js" "*.jsx" | xargs)
+files=$(git diff --cached --name-only --diff-filter=ACMR "*.ts" "*.tsx" "*.js" "*.jsx")
 
 if [ -n "$files" ]; then
-  echo "Running Biome on staged files: $files"
-  pnpm lint-staged $files
-  git add $files
+  echo "Running Biome on staged files..."
+  echo "$files" | xargs pnpm lint-staged
+  
+  # Re-add files after formatting
+  echo "$files" | xargs git add
 fi
 
 # Run TypeScript type check
-pnpm typecheck
+echo "Running type check..."
+pnpm typecheck

package.json

@@ -15,7 +15,7 @@
     "format": "turbo format",
     "typecheck": "turbo typecheck",
     "prepare": "husky",
-    "lint-staged": "biome check --write --no-errors-on-unmatched --files",
+    "lint-staged": "biome check --write --no-errors-on-unmatched",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm build && changeset publish"

packages/core/package.json

@@ -22,6 +22,16 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^24.10.1",
     "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "globby": "^16.0.0",
+    "remark": "^15.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "ts-morph": "^27.0.2",
+    "unified": "^11.0.5"
   }
 }