feat(cli): add CI gating flags for dependency checks

* Introduced --fail-on-diff and --fail-on-missing options
* Updated run() to return a result summary
* Enhanced README and tests to cover new functionality

package.json

@@ -1,6 +1,6 @@
 {
     "name": "@warkypublic/monorepo-dep-checker",
-    "version": "1.0.5",
+    "version": "1.0.6",
     "description": "A CLI tool to check and manage dependencies across packages in a monorepo",
     "type": "module",
     "main": "./dist/index.js",
@@ -17,8 +17,9 @@
     ],
     "scripts": {
         "build": "vite build",
-        "prepublishOnly": "npm run build",
+        "prepublishOnly": "npm run typecheck && npm run build",
         "test": "vitest run --silent=false",
+        "typecheck": "tsc --noEmit",
         "lint": "eslint ./src"
     },
     "keywords": [
@@ -50,6 +51,7 @@
         "eslint": "^9.26.0",
         "globals": "^16.0.0",
         "prettier-eslint": "^16.4.1",
+        "typescript": "^5.9.3",
         "typescript-eslint": "^8.32.0",
         "typesync": "^0.14.3",
         "vite": "^6.3.5",