feat(core): enhance error handling, type safety, and documentation

- Add comprehensive error handling with try/catch blocks and meaningful error messages
- Improve type safety with proper IEnvDeps interface replacing 'any' types
- Add complete JSDoc documentation for all classes and methods
- Add return type annotations for better TypeScript support
- Add ensureInitialized() validation method
- Fix missing return statement in createRepoByClone() method
- Remove deprecated @types/minimatch dependency
- Complete readme rewrite with modern styling, accurate documentation, and proper API examples
- Update license from LICENSE to license.md following project guidelines

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/smartgit",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "A smart wrapper for nodegit that simplifies Git operations in Node.js.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
@@ -40,7 +40,6 @@
     "@push.rocks/smartstring": "^4.0.15",
     "@push.rocks/smarttime": "^4.1.1",
     "@types/diff": "^8.0.0",
-    "@types/minimatch": "^6.0.0",
     "diff": "^8.0.2",
     "isomorphic-git": "^1.32.2"
   },