@mks2508/better-logger 0.0.2-alpha.2 → 0.11.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (247) hide show
  1. package/.github/workflows/ci-quality.yml +357 -0
  2. package/.github/workflows/docs-demo.yml +119 -0
  3. package/.github/workflows/releases-core.yml +512 -0
  4. package/.github/workflows/releases-full.yml +582 -0
  5. package/.github/{workflows → workflows-backup}/ci.yml +12 -110
  6. package/.github/workflows-backup/nightly.yml +196 -0
  7. package/.github/workflows-backup/release-optimized.yml +373 -0
  8. package/.release-notes-0.2.0.md +129 -0
  9. package/.yamllint +28 -0
  10. package/CHANGELOG.json +749 -0
  11. package/CLAUDE.md +92 -1
  12. package/README.md +142 -498
  13. package/bun.lock +323 -0
  14. package/demo.html +9 -2
  15. package/dist/Logger.d.ts +176 -0
  16. package/dist/Logger.d.ts.map +1 -0
  17. package/dist/Logger.js +498 -0
  18. package/dist/chunks/Logger-C2-cR3No.js +2 -0
  19. package/dist/chunks/Logger-C2-cR3No.js.map +1 -0
  20. package/dist/chunks/Logger-CVwk8cgA.js +2159 -0
  21. package/dist/chunks/Logger-CVwk8cgA.js.map +1 -0
  22. package/dist/chunks/RemoteLogHandler-CjWpWZGl.js +33 -0
  23. package/dist/chunks/RemoteLogHandler-CjWpWZGl.js.map +1 -0
  24. package/dist/chunks/RemoteLogHandler-ymkQ97xl.js +2 -0
  25. package/dist/chunks/RemoteLogHandler-ymkQ97xl.js.map +1 -0
  26. package/dist/chunks/StyleBuilder-BoJTmskd.js +361 -0
  27. package/dist/chunks/StyleBuilder-BoJTmskd.js.map +1 -0
  28. package/dist/chunks/StyleBuilder-LPLzsoHY.js +4 -0
  29. package/dist/chunks/StyleBuilder-LPLzsoHY.js.map +1 -0
  30. package/dist/cli/CommandProcessor.d.ts +103 -0
  31. package/dist/cli/CommandProcessor.d.ts.map +1 -0
  32. package/dist/cli/CommandProcessor.js +184 -0
  33. package/dist/cli/commands/ConfigCommand.d.ts +17 -0
  34. package/dist/cli/commands/ConfigCommand.d.ts.map +1 -0
  35. package/dist/cli/commands/ConfigCommand.js +88 -0
  36. package/dist/cli/commands/ExportCommand.d.ts +51 -0
  37. package/dist/cli/commands/ExportCommand.d.ts.map +1 -0
  38. package/dist/cli/commands/ExportCommand.js +243 -0
  39. package/dist/cli/commands/HistoryCommand.d.ts +50 -0
  40. package/dist/cli/commands/HistoryCommand.d.ts.map +1 -0
  41. package/dist/cli/commands/HistoryCommand.js +96 -0
  42. package/dist/cli/commands/StatusCommand.d.ts +33 -0
  43. package/dist/cli/commands/StatusCommand.d.ts.map +1 -0
  44. package/dist/cli/commands/StatusCommand.js +93 -0
  45. package/dist/cli/commands/ThemeCommand.d.ts +33 -0
  46. package/dist/cli/commands/ThemeCommand.d.ts.map +1 -0
  47. package/dist/cli/commands/ThemeCommand.js +79 -0
  48. package/dist/cli/help.d.ts +15 -0
  49. package/dist/cli/help.d.ts.map +1 -0
  50. package/dist/cli/help.js +118 -0
  51. package/dist/cli/index.d.ts +15 -0
  52. package/dist/cli/index.d.ts.map +1 -0
  53. package/dist/cli/index.js +46 -0
  54. package/dist/constants.d.ts +91 -0
  55. package/dist/constants.d.ts.map +1 -0
  56. package/dist/constants.js +80 -0
  57. package/dist/core.cjs +1 -1
  58. package/dist/core.cjs.map +1 -1
  59. package/dist/core.d.ts +130 -0
  60. package/dist/core.d.ts.map +1 -0
  61. package/dist/core.js +258 -242
  62. package/dist/core.js.map +1 -1
  63. package/dist/example.d.ts +18 -0
  64. package/dist/example.d.ts.map +1 -0
  65. package/dist/example.js +154 -0
  66. package/dist/exports-module.d.ts +203 -0
  67. package/dist/exports-module.d.ts.map +1 -0
  68. package/dist/exports-module.js +260 -0
  69. package/dist/exports.cjs +1 -1
  70. package/dist/exports.cjs.map +1 -1
  71. package/dist/exports.js +2 -2
  72. package/dist/handlers/AnalyticsLogHandler.d.ts +11 -0
  73. package/dist/handlers/AnalyticsLogHandler.d.ts.map +1 -0
  74. package/dist/handlers/AnalyticsLogHandler.js +19 -0
  75. package/dist/handlers/ExportLogHandler.d.ts +103 -0
  76. package/dist/handlers/ExportLogHandler.d.ts.map +1 -0
  77. package/dist/handlers/ExportLogHandler.js +516 -0
  78. package/dist/handlers/FileLogHandler.d.ts +13 -0
  79. package/dist/handlers/FileLogHandler.d.ts.map +1 -0
  80. package/dist/handlers/FileLogHandler.js +24 -0
  81. package/dist/handlers/RemoteLogHandler.d.ts +14 -0
  82. package/dist/handlers/RemoteLogHandler.d.ts.map +1 -0
  83. package/dist/handlers/RemoteLogHandler.js +37 -0
  84. package/dist/handlers/index.d.ts +8 -0
  85. package/dist/handlers/index.d.ts.map +1 -0
  86. package/dist/handlers/index.js +7 -0
  87. package/dist/index.cjs +1 -1
  88. package/dist/index.cjs.map +1 -1
  89. package/dist/index.d.ts +86 -0
  90. package/dist/index.d.ts.map +1 -0
  91. package/dist/index.js +89 -103
  92. package/dist/main.d.ts +2 -0
  93. package/dist/main.d.ts.map +1 -0
  94. package/dist/main.js +139 -0
  95. package/dist/styling/StyleBuilder.d.ts +132 -0
  96. package/dist/styling/StyleBuilder.d.ts.map +1 -0
  97. package/dist/styling/StyleBuilder.js +268 -0
  98. package/dist/styling/banners.d.ts +45 -0
  99. package/dist/styling/banners.d.ts.map +1 -0
  100. package/dist/styling/banners.js +155 -0
  101. package/dist/styling/index.d.ts +7 -0
  102. package/dist/styling/index.d.ts.map +1 -0
  103. package/dist/styling/index.js +6 -0
  104. package/dist/styling/themes.d.ts +10 -0
  105. package/dist/styling/themes.d.ts.map +1 -0
  106. package/dist/styling/themes.js +231 -0
  107. package/dist/styling-module.d.ts +185 -0
  108. package/dist/styling-module.d.ts.map +1 -0
  109. package/dist/styling-module.js +199 -0
  110. package/dist/styling.cjs +1 -1
  111. package/dist/styling.cjs.map +1 -1
  112. package/dist/styling.js +4 -4
  113. package/dist/types/Logger.d.ts +172 -0
  114. package/dist/types/Logger.d.ts.map +1 -0
  115. package/dist/types/cli/CommandProcessor.d.ts +100 -0
  116. package/dist/types/cli/CommandProcessor.d.ts.map +1 -0
  117. package/dist/types/cli/commands/ConfigCommand.d.ts +14 -0
  118. package/dist/types/cli/commands/ConfigCommand.d.ts.map +1 -0
  119. package/dist/types/cli/commands/ExportCommand.d.ts +48 -0
  120. package/dist/types/cli/commands/ExportCommand.d.ts.map +1 -0
  121. package/dist/types/cli/commands/HistoryCommand.d.ts +47 -0
  122. package/dist/types/cli/commands/HistoryCommand.d.ts.map +1 -0
  123. package/dist/types/cli/commands/StatusCommand.d.ts +30 -0
  124. package/dist/types/cli/commands/StatusCommand.d.ts.map +1 -0
  125. package/dist/types/cli/commands/ThemeCommand.d.ts +30 -0
  126. package/dist/types/cli/commands/ThemeCommand.d.ts.map +1 -0
  127. package/dist/types/cli/help.d.ts +12 -0
  128. package/dist/types/cli/help.d.ts.map +1 -0
  129. package/dist/types/cli/index.d.ts +15 -0
  130. package/dist/types/cli/index.d.ts.map +1 -0
  131. package/dist/types/constants.d.ts +88 -0
  132. package/dist/types/constants.d.ts.map +1 -0
  133. package/dist/types/core.d.ts +71 -211
  134. package/dist/types/core.d.ts.map +1 -0
  135. package/dist/types/core.js +13 -0
  136. package/dist/types/example.d.ts +18 -0
  137. package/dist/types/example.d.ts.map +1 -0
  138. package/dist/types/exports-module.d.ts +196 -0
  139. package/dist/types/exports-module.d.ts.map +1 -0
  140. package/dist/types/handlers/AnalyticsLogHandler.d.ts +8 -0
  141. package/dist/types/handlers/AnalyticsLogHandler.d.ts.map +1 -0
  142. package/dist/types/handlers/ExportLogHandler.d.ts +100 -0
  143. package/dist/types/handlers/ExportLogHandler.d.ts.map +1 -0
  144. package/dist/types/handlers/FileLogHandler.d.ts +10 -0
  145. package/dist/types/handlers/FileLogHandler.d.ts.map +1 -0
  146. package/dist/types/handlers/RemoteLogHandler.d.ts +11 -0
  147. package/dist/types/handlers/RemoteLogHandler.d.ts.map +1 -0
  148. package/dist/types/handlers/index.d.ts +8 -0
  149. package/dist/types/handlers/index.d.ts.map +1 -0
  150. package/dist/types/handlers.d.ts +88 -0
  151. package/dist/types/handlers.d.ts.map +1 -0
  152. package/dist/types/handlers.js +4 -0
  153. package/dist/types/index.d.ts +7 -675
  154. package/dist/types/index.d.ts.map +1 -0
  155. package/dist/types/index.js +4 -0
  156. package/dist/types/main.d.ts +2 -0
  157. package/dist/types/main.d.ts.map +1 -0
  158. package/dist/types/styling/StyleBuilder.d.ts +132 -0
  159. package/dist/types/styling/StyleBuilder.d.ts.map +1 -0
  160. package/dist/types/styling/banners.d.ts +42 -0
  161. package/dist/types/styling/banners.d.ts.map +1 -0
  162. package/dist/types/styling/index.d.ts +7 -0
  163. package/dist/types/styling/index.d.ts.map +1 -0
  164. package/dist/types/styling/themes.d.ts +7 -0
  165. package/dist/types/styling/themes.d.ts.map +1 -0
  166. package/dist/types/styling-module.d.ts +178 -0
  167. package/dist/types/styling-module.d.ts.map +1 -0
  168. package/dist/types/types/core.d.ts +71 -0
  169. package/dist/types/types/core.d.ts.map +1 -0
  170. package/dist/types/types/handlers.d.ts +85 -0
  171. package/dist/types/types/handlers.d.ts.map +1 -0
  172. package/dist/types/types/index.d.ts +7 -0
  173. package/dist/types/types/index.d.ts.map +1 -0
  174. package/dist/types/utils/index.d.ts +7 -0
  175. package/dist/types/utils/index.d.ts.map +1 -0
  176. package/dist/types/utils/output.d.ts +29 -0
  177. package/dist/types/utils/output.d.ts.map +1 -0
  178. package/dist/types/utils/stackTrace.d.ts +6 -0
  179. package/dist/types/utils/stackTrace.d.ts.map +1 -0
  180. package/dist/types/utils/timestamps.d.ts +20 -0
  181. package/dist/types/utils/timestamps.d.ts.map +1 -0
  182. package/dist/utils/index.d.ts +7 -0
  183. package/dist/utils/index.d.ts.map +1 -0
  184. package/dist/utils/index.js +6 -0
  185. package/dist/utils/output.d.ts +32 -0
  186. package/dist/utils/output.d.ts.map +1 -0
  187. package/dist/utils/output.js +97 -0
  188. package/dist/utils/stackTrace.d.ts +9 -0
  189. package/dist/utils/stackTrace.d.ts.map +1 -0
  190. package/dist/utils/stackTrace.js +81 -0
  191. package/dist/utils/timestamps.d.ts +20 -0
  192. package/dist/utils/timestamps.d.ts.map +1 -0
  193. package/dist/utils/timestamps.js +71 -0
  194. package/docs/API.md +691 -0
  195. package/docs/DEVELOPMENT.md +731 -0
  196. package/docs/PACKAGES.md +244 -0
  197. package/docs/_config.yml +36 -0
  198. package/docs/index.md +179 -0
  199. package/examples/README.md +208 -0
  200. package/examples/basic-logging.js +75 -0
  201. package/examples/data-export.js +234 -0
  202. package/examples/package.json +16 -0
  203. package/examples/performance-timing.js +170 -0
  204. package/examples/styling-themes.js +207 -0
  205. package/package.json +32 -21
  206. package/packages/core/package.json +35 -0
  207. package/packages/exports/package.json +41 -0
  208. package/packages/styling/package.json +41 -0
  209. package/project-utils/README.md +172 -0
  210. package/project-utils/auto-release-gemini.ts +1193 -0
  211. package/project-utils/commit-generator.ts +1385 -0
  212. package/project-utils/commit-ui.ts +264 -0
  213. package/project-utils/git-utils.ts +199 -0
  214. package/project-utils/github-release-manager.ts +466 -0
  215. package/project-utils/prompt-templates.js +345 -0
  216. package/project-utils/prompt-templates.ts +422 -0
  217. package/project-utils/version-manager.ts +1078 -0
  218. package/src/Logger.ts +2 -1
  219. package/src/cli/CommandProcessor.ts +173 -2
  220. package/src/cli/commands/HistoryCommand.ts +117 -0
  221. package/src/cli/index.ts +12 -0
  222. package/src/handlers/ExportLogHandler.ts +141 -0
  223. package/tests/test-conflict-resolution.ts +391 -0
  224. package/tests/validate-workflows.sh +131 -0
  225. package/tests/yaml-autofix.sh +146 -0
  226. package/vite.config.ts +152 -50
  227. package/.claude/settings.local.json +0 -22
  228. package/.npmrc.bak +0 -1
  229. package/dist/chunks/Logger-BQhMKy_T.js +0 -2
  230. package/dist/chunks/Logger-BQhMKy_T.js.map +0 -1
  231. package/dist/chunks/Logger-BrFKFZcD.js +0 -978
  232. package/dist/chunks/Logger-BrFKFZcD.js.map +0 -1
  233. package/dist/chunks/core-2opW4Pi3.js +0 -194
  234. package/dist/chunks/core-2opW4Pi3.js.map +0 -1
  235. package/dist/chunks/core-DyugwSYZ.js +0 -4
  236. package/dist/chunks/core-DyugwSYZ.js.map +0 -1
  237. package/dist/chunks/exports-BNP3R7dp.js +0 -421
  238. package/dist/chunks/exports-BNP3R7dp.js.map +0 -1
  239. package/dist/chunks/exports-U1xLBXrY.js +0 -2
  240. package/dist/chunks/exports-U1xLBXrY.js.map +0 -1
  241. package/dist/chunks/styling-DhUDzwlE.js +0 -654
  242. package/dist/chunks/styling-DhUDzwlE.js.map +0 -1
  243. package/dist/chunks/styling-tmRDI28D.js +0 -2
  244. package/dist/chunks/styling-tmRDI28D.js.map +0 -1
  245. package/dist/types/exports.d.ts +0 -600
  246. package/dist/types/styling.d.ts +0 -751
  247. /package/.github/{workflows → workflows-backup}/release.yml +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mks2508/better-logger",
3
- "version": "0.0.2-alpha.2",
3
+ "version": "0.11.0-alpha.1",
4
4
  "type": "module",
5
5
  "description": "State-of-the-art console logger with advanced CSS styling, SVG support, animations, and CLI interface",
6
6
  "main": "dist/index.js",
@@ -27,37 +27,48 @@
27
27
  "url": "https://github.com/MKS2508/advanced-logger/issues"
28
28
  },
29
29
  "homepage": "https://mks2508.github.io/advanced-logger/",
30
- "publishConfig": {
31
- "registry": "https://registry.npmjs.org/"
32
- },
33
30
  "scripts": {
34
31
  "dev": "vite",
35
- "build": "tsc && vite build",
36
- "build:watch": "vite build --watch",
37
- "build:analyze": "vite build --mode analyze",
38
- "preview": "vite preview",
32
+ "build": "tsc && BUILD_MODE=full vite build",
33
+ "build:full": "tsc && BUILD_MODE=full vite build",
34
+ "build:core": "tsc && BUILD_MODE=core vite build",
35
+ "build:styling": "tsc && BUILD_MODE=styling vite build",
36
+ "build:exports": "tsc && BUILD_MODE=exports vite build",
37
+ "build:all": "npm run build:full && npm run build:core && npm run build:styling && npm run build:exports",
39
38
  "clean": "rm -rf dist node_modules/.vite",
40
39
  "type-check": "tsc --noEmit",
41
- "lint": "echo 'Linting with ESLint...' && exit 0",
42
- "lint:fix": "echo 'Fixing with ESLint...' && exit 0",
43
40
  "test": "echo 'Running tests...' && exit 0",
44
- "test:watch": "echo 'Running tests in watch mode...' && exit 0",
45
- "test:coverage": "echo 'Running tests with coverage...' && exit 0",
46
41
  "test:performance": "echo 'Running performance benchmarks...' && exit 0",
47
42
  "test:visual": "echo 'Running visual tests...' && exit 0",
48
- "prepublishOnly": "npm run clean && npm run type-check && npm run build",
49
- "release": "npm version patch && npm publish --access public",
50
- "release:minor": "npm version minor && npm publish --access public",
51
- "release:major": "npm version major && npm publish --access public",
52
- "release:alpha": "npm version prerelease --preid=alpha && npm publish --access public --tag alpha",
53
- "release:beta": "npm version prerelease --preid=beta && npm publish --access public --tag beta",
54
- "demo:serve": "python3 -m http.server 8080",
43
+ "test:workflows": "bun tests/test-conflict-resolution.ts",
44
+ "lint:yaml": "yamllint -c .yamllint .github/workflows/",
45
+ "fix:yaml": "./tests/yaml-autofix.sh",
46
+ "validate:workflows": "./tests/validate-workflows.sh",
55
47
  "size-limit": "echo 'Checking bundle sizes...' && ls -la dist/",
56
48
  "ci:install": "npm ci",
57
- "ci:build": "npm run build",
49
+ "ci:build": "npm run build:all",
58
50
  "ci:test": "npm run test",
59
51
  "ci:publish": "npm publish --access public --ignore-scripts",
60
- "ci:publish:github": "npm publish --registry=https://npm.pkg.github.com --access public --ignore-scripts"
52
+ "ci:publish:github": "npm publish --registry=https://npm.pkg.github.com --access public --ignore-scripts",
53
+ "commit:auto": "bun project-utils/commit-generator.ts --auto-approve --quiet",
54
+ "commit:ui": "bun project-utils/commit-ui.ts",
55
+ "version:auto": "bun project-utils/version-manager.ts --auto-approve",
56
+ "version:patch": "bun project-utils/version-manager.ts --type patch --auto-approve",
57
+ "version:minor": "bun project-utils/version-manager.ts --type minor --auto-approve",
58
+ "version:major": "bun project-utils/version-manager.ts --type major --auto-approve",
59
+ "version:alpha": "bun project-utils/version-manager.ts --prefix alpha --auto-approve",
60
+ "version:beta": "bun project-utils/version-manager.ts --prefix beta --auto-approve",
61
+ "version:stable": "bun project-utils/version-manager.ts --prefix '' --auto-approve",
62
+ "release:github": "bun project-utils/github-release-manager.ts --auto-approve",
63
+ "release:full": "npm run version:auto && npm run build:all && npm run release:github && npm run ci:publish",
64
+ "release:auto": "bun project-utils/auto-release-gemini.ts --ai --auto-approve",
65
+ "publish:core": "cd packages/core && npm publish --access public",
66
+ "publish:styling": "cd packages/styling && npm publish --access public",
67
+ "publish:exports": "cd packages/exports && npm publish --access public",
68
+ "publish:all-packages": "npm run publish:core && npm run publish:styling && npm run publish:exports",
69
+ "workflow:full": "npm run commit:auto && npm run release:full",
70
+ "workflow:commit": "npm run commit:auto",
71
+ "workflow:release": "npm run version:auto && npm run build:all && npm run release:github"
61
72
  },
62
73
  "devDependencies": {
63
74
  "terser": "^5.43.1",
@@ -0,0 +1,35 @@
1
+ {
2
+ "name": "@mks2508/better-logger-core",
3
+ "version": "0.11.0-alpha.1",
4
+ "type": "module",
5
+ "description": "Core logging functionality for Better Logger - Advanced console logger with hierarchical levels",
6
+ "main": "dist/index.js",
7
+ "types": "dist/types/core.d.ts",
8
+ "keywords": [
9
+ "logger",
10
+ "console",
11
+ "core",
12
+ "typescript",
13
+ "browser",
14
+ "debug"
15
+ ],
16
+ "author": "MKS2508",
17
+ "license": "MIT",
18
+ "repository": {
19
+ "type": "git",
20
+ "url": "git+https://github.com/MKS2508/advanced-logger.git",
21
+ "directory": "packages/core"
22
+ },
23
+ "bugs": {
24
+ "url": "https://github.com/MKS2508/advanced-logger/issues"
25
+ },
26
+ "homepage": "https://mks2508.github.io/advanced-logger/",
27
+ "publishConfig": {
28
+ "access": "public",
29
+ "registry": "https://registry.npmjs.org/"
30
+ },
31
+ "files": [
32
+ "dist",
33
+ "README.md"
34
+ ]
35
+ }
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "@mks2508/better-logger-exports",
3
+ "version": "0.11.0-alpha.1",
4
+ "type": "module",
5
+ "description": "Export handlers for Better Logger - File, Remote, Analytics and custom log destinations",
6
+ "main": "dist/index.js",
7
+ "types": "dist/types/exports-module.d.ts",
8
+ "keywords": [
9
+ "logger",
10
+ "console",
11
+ "exports",
12
+ "handlers",
13
+ "file",
14
+ "remote",
15
+ "analytics",
16
+ "typescript",
17
+ "browser"
18
+ ],
19
+ "author": "MKS2508",
20
+ "license": "MIT",
21
+ "repository": {
22
+ "type": "git",
23
+ "url": "git+https://github.com/MKS2508/advanced-logger.git",
24
+ "directory": "packages/exports"
25
+ },
26
+ "bugs": {
27
+ "url": "https://github.com/MKS2508/advanced-logger/issues"
28
+ },
29
+ "homepage": "https://mks2508.github.io/advanced-logger/",
30
+ "publishConfig": {
31
+ "access": "public",
32
+ "registry": "https://registry.npmjs.org/"
33
+ },
34
+ "files": [
35
+ "dist",
36
+ "README.md"
37
+ ],
38
+ "peerDependencies": {
39
+ "@mks2508/better-logger-core": "^0.11.0-alpha.1"
40
+ }
41
+ }
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "@mks2508/better-logger-styling",
3
+ "version": "0.11.0-alpha.1",
4
+ "type": "module",
5
+ "description": "Advanced CSS styling system for Better Logger - Console styling with gradients, animations and SVG support",
6
+ "main": "dist/index.js",
7
+ "types": "dist/types/styling-module.d.ts",
8
+ "keywords": [
9
+ "logger",
10
+ "console",
11
+ "styling",
12
+ "css",
13
+ "svg",
14
+ "animation",
15
+ "gradients",
16
+ "typescript",
17
+ "browser"
18
+ ],
19
+ "author": "MKS2508",
20
+ "license": "MIT",
21
+ "repository": {
22
+ "type": "git",
23
+ "url": "git+https://github.com/MKS2508/advanced-logger.git",
24
+ "directory": "packages/styling"
25
+ },
26
+ "bugs": {
27
+ "url": "https://github.com/MKS2508/advanced-logger/issues"
28
+ },
29
+ "homepage": "https://mks2508.github.io/advanced-logger/",
30
+ "publishConfig": {
31
+ "access": "public",
32
+ "registry": "https://registry.npmjs.org/"
33
+ },
34
+ "files": [
35
+ "dist",
36
+ "README.md"
37
+ ],
38
+ "peerDependencies": {
39
+ "@mks2508/better-logger-core": "^0.11.0-alpha.1"
40
+ }
41
+ }
@@ -0,0 +1,172 @@
1
+ # Project Utils - Sistema de Automatización Completa con AI
2
+
3
+ ## 🚀 Comandos de Workflow Automatizado
4
+
5
+ ### Comandos Individuales
6
+ ```bash
7
+ # Commits automatizados
8
+ npm run commit:auto # Commit automático silencioso
9
+ npm run commit:ui # UI interactiva para commits
10
+
11
+ # Versionado automatizado
12
+ npm run version:auto # Auto-detectar tipo de versión
13
+ npm run version:patch # Forzar versión patch
14
+ npm run version:minor # Forzar versión minor
15
+ npm run version:major # Forzar versión major
16
+ npm run version:alpha # Versión alpha
17
+ npm run version:beta # Versión beta
18
+ npm run version:stable # Versión estable
19
+
20
+ # GitHub Releases
21
+ npm run release:github # Crear release en GitHub
22
+ npm run release:full # Versión + Build + GitHub + Publish NPM
23
+ npm run release:auto # 🤖 Release completa con AI (RECOMENDADO)
24
+ ```
25
+
26
+ ### 🤖 Release Automatizado con AI (NUEVO)
27
+ ```bash
28
+ # Release completo con AI - Un solo comando hace todo:
29
+ # ✅ Genera nueva versión
30
+ # ✅ Build de todos los módulos
31
+ # ✅ Commit inteligente con AI
32
+ # ✅ GitHub release con release notes
33
+ # ✅ Publicación dual NPM (público + GitHub Packages)
34
+
35
+ # Ejemplos de uso:
36
+ npm run release:auto -- --type minor --prefix alpha --publish-npm
37
+ npm run release:auto -- --type patch --publish-npm --publish-github
38
+ npm run release:auto -- --dry-run --type minor --prefix beta
39
+ ```
40
+
41
+ ### Workflows Clásicos (Legacy)
42
+ ```bash
43
+ npm run workflow:full # Commit + Versión + Build + Release + Publish
44
+ npm run workflow:commit # Solo commit automático
45
+ npm run workflow:release # Versión + Build + GitHub Release
46
+ ```
47
+
48
+ ## 🔧 Parámetros de Automatización
49
+
50
+ ### 🤖 auto-release-gemini.ts (RECOMENDADO)
51
+ ```bash
52
+ # Release alpha con AI completo
53
+ bun project-utils/auto-release-gemini.ts \
54
+ --ai --auto-approve \
55
+ --type minor --prefix alpha \
56
+ --work-type feature --affected-components "exports,handlers" \
57
+ --context "enhanced export functionality" \
58
+ --publish-npm --publish-github
59
+
60
+ # Release beta con contexto de performance
61
+ bun project-utils/auto-release-gemini.ts \
62
+ --type minor --prefix beta \
63
+ --work-type improvement --performance-impact major \
64
+ --context "performance optimizations" \
65
+ --publish-npm
66
+
67
+ # Solo mostrar qué haría (dry run)
68
+ bun project-utils/auto-release-gemini.ts --dry-run \
69
+ --type patch --prefix alpha --publish-npm
70
+
71
+ # Release para CI/CD
72
+ bun project-utils/auto-release-gemini.ts --auto-approve --ai \
73
+ --type patch --publish-npm --publish-github
74
+ ```
75
+
76
+ **Parámetros disponibles:**
77
+ - **Version Manager**: `--type` (major|minor|patch), `--prefix` (alpha|beta|rc|'')
78
+ - **Commit AI**: `--work-type`, `--affected-components`, `--context`, `--performance-impact`
79
+ - **Publicación**: `--publish-npm`, `--publish-github`
80
+ - **Control**: `--dry-run`, `--auto-approve`, `--ai`/`--no-ai`, `--force`
81
+
82
+ ### Scripts Individuales (Legacy)
83
+
84
+ #### commit-generator.ts
85
+ ```bash
86
+ bun project-utils/commit-generator.ts \
87
+ --auto-approve --quiet \
88
+ --work-type feature \
89
+ --affected-components "core,styling" \
90
+ --context "logger improvements"
91
+ ```
92
+
93
+ #### version-manager.ts
94
+ ```bash
95
+ bun project-utils/version-manager.ts --auto-approve --type minor --prefix alpha
96
+ ```
97
+
98
+ #### github-release-manager.ts
99
+ ```bash
100
+ bun project-utils/github-release-manager.ts --auto-approve --force
101
+ ```
102
+
103
+ ## 📁 Archivos Temporales
104
+
105
+ Ubicación: `project-utils/.temp/`
106
+ - `commit-proposal-YYYYMMDD-HHMMSS.md` - Propuestas de commit
107
+ - `gemini-prompt.txt` - Prompts enviados a Gemini
108
+ - `gemini-response.md` - Respuestas de Gemini
109
+ - `analysis-context.json` - Contexto de análisis
110
+
111
+ ## 🔄 Reutilización de Propuestas
112
+
113
+ 1. Generar propuesta: `npm run commit:generate`
114
+ 2. Revisar en `project-utils/.temp/commit-proposal-*.md`
115
+ 3. Ejecutar: `node project-utils/commit-generator.ts --proposal-file <ruta> --auto-approve`
116
+
117
+ ## 🎯 Casos de Uso
118
+
119
+ ### 🤖 Desarrollo con AI (RECOMENDADO)
120
+ ```bash
121
+ # 1. Hacer cambios en código
122
+ # 2. Release completo con AI en un comando
123
+ npm run release:auto -- --type patch --prefix alpha --publish-npm
124
+
125
+ # Para releases importantes
126
+ npm run release:auto -- \
127
+ --type minor --prefix beta \
128
+ --work-type feature \
129
+ --affected-components "core,exports" \
130
+ --context "major logging enhancements" \
131
+ --publish-npm --publish-github
132
+ ```
133
+
134
+ ### 🔍 Testing y Validación
135
+ ```bash
136
+ # Ver qué haría sin ejecutar
137
+ npm run release:auto -- --dry-run --type minor --prefix alpha --publish-npm
138
+
139
+ # Testing de instalación después de release
140
+ npm install @mks2508/better-logger@0.4.0-alpha.1
141
+ npm install @mks2508/better-logger@0.4.0-alpha.1 --registry=https://npm.pkg.github.com
142
+ ```
143
+
144
+ ### 🌐 CI/CD Pipeline
145
+ ```bash
146
+ # Workflow para CI/CD completamente automatizado
147
+ npm run release:auto -- --auto-approve --ai \
148
+ --type patch --publish-npm --publish-github
149
+ ```
150
+
151
+ ### 🕧 Desarrollo Manual (Legacy)
152
+ ```bash
153
+ npm run commit:auto # Commit manual
154
+ npm run version:minor # Versión manual
155
+ npm run release:github # Solo GitHub release
156
+ ```
157
+
158
+ ## ⚙️ Configuración
159
+
160
+ Todos los scripts respetan los parámetros:
161
+ - `--auto-approve`: Ejecución automática sin confirmaciones
162
+ - `--quiet`: Solo errores y resultados finales
163
+ - `--no-push`: No hacer push (solo commits locales)
164
+ - `--force`: Forzar operaciones (recrear releases, etc.)
165
+
166
+ ## 🔒 Validaciones de Seguridad
167
+
168
+ - Solo funciona en rama `master`
169
+ - Validación de conflictos antes de ejecutar
170
+ - Commits atómicos con rollback en caso de error
171
+ - Logs completos de todas las operaciones
172
+ - Validación de estado del repositorio antes de auto-approve