javi-forge 0.1.0

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 (500) hide show
  1. package/.gitignore.template +105 -0
  2. package/.releaserc +44 -0
  3. package/README.md +45 -0
  4. package/ai-config/.skillignore +15 -0
  5. package/ai-config/AUTO_INVOKE.md +300 -0
  6. package/ai-config/agents/_TEMPLATE.md +93 -0
  7. package/ai-config/agents/business/api-designer.md +1657 -0
  8. package/ai-config/agents/business/business-analyst.md +1331 -0
  9. package/ai-config/agents/business/product-strategist.md +206 -0
  10. package/ai-config/agents/business/project-manager.md +178 -0
  11. package/ai-config/agents/business/requirements-analyst.md +1277 -0
  12. package/ai-config/agents/business/technical-writer.md +1679 -0
  13. package/ai-config/agents/creative/ux-designer.md +205 -0
  14. package/ai-config/agents/data-ai/ai-engineer.md +487 -0
  15. package/ai-config/agents/data-ai/analytics-engineer.md +953 -0
  16. package/ai-config/agents/data-ai/data-engineer.md +173 -0
  17. package/ai-config/agents/data-ai/data-scientist.md +672 -0
  18. package/ai-config/agents/data-ai/mlops-engineer.md +814 -0
  19. package/ai-config/agents/data-ai/prompt-engineer.md +772 -0
  20. package/ai-config/agents/development/angular-expert.md +620 -0
  21. package/ai-config/agents/development/backend-architect.md +795 -0
  22. package/ai-config/agents/development/database-specialist.md +212 -0
  23. package/ai-config/agents/development/frontend-specialist.md +686 -0
  24. package/ai-config/agents/development/fullstack-engineer.md +668 -0
  25. package/ai-config/agents/development/golang-pro.md +338 -0
  26. package/ai-config/agents/development/java-enterprise.md +400 -0
  27. package/ai-config/agents/development/javascript-pro.md +422 -0
  28. package/ai-config/agents/development/nextjs-pro.md +474 -0
  29. package/ai-config/agents/development/python-pro.md +570 -0
  30. package/ai-config/agents/development/react-pro.md +487 -0
  31. package/ai-config/agents/development/rust-pro.md +246 -0
  32. package/ai-config/agents/development/spring-boot-4-expert.md +326 -0
  33. package/ai-config/agents/development/typescript-pro.md +336 -0
  34. package/ai-config/agents/development/vue-specialist.md +605 -0
  35. package/ai-config/agents/infrastructure/cloud-architect.md +472 -0
  36. package/ai-config/agents/infrastructure/deployment-manager.md +358 -0
  37. package/ai-config/agents/infrastructure/devops-engineer.md +455 -0
  38. package/ai-config/agents/infrastructure/incident-responder.md +519 -0
  39. package/ai-config/agents/infrastructure/kubernetes-expert.md +705 -0
  40. package/ai-config/agents/infrastructure/monitoring-specialist.md +674 -0
  41. package/ai-config/agents/infrastructure/performance-engineer.md +658 -0
  42. package/ai-config/agents/orchestrator.md +241 -0
  43. package/ai-config/agents/quality/accessibility-auditor.md +1204 -0
  44. package/ai-config/agents/quality/code-reviewer-compact.md +123 -0
  45. package/ai-config/agents/quality/code-reviewer.md +363 -0
  46. package/ai-config/agents/quality/dependency-manager.md +743 -0
  47. package/ai-config/agents/quality/e2e-test-specialist.md +1005 -0
  48. package/ai-config/agents/quality/performance-tester.md +1086 -0
  49. package/ai-config/agents/quality/security-auditor.md +133 -0
  50. package/ai-config/agents/quality/test-engineer.md +453 -0
  51. package/ai-config/agents/specialists/api-designer.md +87 -0
  52. package/ai-config/agents/specialists/backend-architect.md +73 -0
  53. package/ai-config/agents/specialists/code-reviewer.md +77 -0
  54. package/ai-config/agents/specialists/db-optimizer.md +75 -0
  55. package/ai-config/agents/specialists/devops-engineer.md +83 -0
  56. package/ai-config/agents/specialists/documentation-writer.md +78 -0
  57. package/ai-config/agents/specialists/frontend-developer.md +75 -0
  58. package/ai-config/agents/specialists/performance-analyst.md +82 -0
  59. package/ai-config/agents/specialists/refactor-specialist.md +74 -0
  60. package/ai-config/agents/specialists/security-auditor.md +74 -0
  61. package/ai-config/agents/specialists/test-engineer.md +81 -0
  62. package/ai-config/agents/specialists/ux-consultant.md +76 -0
  63. package/ai-config/agents/specialized/agent-generator.md +1190 -0
  64. package/ai-config/agents/specialized/blockchain-developer.md +149 -0
  65. package/ai-config/agents/specialized/code-migrator.md +892 -0
  66. package/ai-config/agents/specialized/context-manager.md +978 -0
  67. package/ai-config/agents/specialized/documentation-writer.md +1078 -0
  68. package/ai-config/agents/specialized/ecommerce-expert.md +1756 -0
  69. package/ai-config/agents/specialized/embedded-engineer.md +1714 -0
  70. package/ai-config/agents/specialized/error-detective.md +1034 -0
  71. package/ai-config/agents/specialized/fintech-specialist.md +1659 -0
  72. package/ai-config/agents/specialized/freelance-project-planner-v2.md +1988 -0
  73. package/ai-config/agents/specialized/freelance-project-planner-v3.md +2136 -0
  74. package/ai-config/agents/specialized/freelance-project-planner-v4.md +4503 -0
  75. package/ai-config/agents/specialized/freelance-project-planner.md +722 -0
  76. package/ai-config/agents/specialized/game-developer.md +1963 -0
  77. package/ai-config/agents/specialized/healthcare-dev.md +1620 -0
  78. package/ai-config/agents/specialized/mobile-developer.md +188 -0
  79. package/ai-config/agents/specialized/parallel-plan-executor.md +506 -0
  80. package/ai-config/agents/specialized/plan-executor.md +485 -0
  81. package/ai-config/agents/specialized/solo-dev-planner-modular/00-INDEX.md +485 -0
  82. package/ai-config/agents/specialized/solo-dev-planner-modular/01-CORE.md +3493 -0
  83. package/ai-config/agents/specialized/solo-dev-planner-modular/02-SELF-CORRECTION.md +778 -0
  84. package/ai-config/agents/specialized/solo-dev-planner-modular/03-PROGRESSIVE-SETUP.md +918 -0
  85. package/ai-config/agents/specialized/solo-dev-planner-modular/04-DEPLOYMENT.md +1537 -0
  86. package/ai-config/agents/specialized/solo-dev-planner-modular/05-TESTING.md +2633 -0
  87. package/ai-config/agents/specialized/solo-dev-planner-modular/06-OPERATIONS.md +5610 -0
  88. package/ai-config/agents/specialized/solo-dev-planner-modular/INSTALL.md +335 -0
  89. package/ai-config/agents/specialized/solo-dev-planner-modular/QUICK-REFERENCE.txt +215 -0
  90. package/ai-config/agents/specialized/solo-dev-planner-modular/README.md +260 -0
  91. package/ai-config/agents/specialized/solo-dev-planner-modular/START-HERE.md +379 -0
  92. package/ai-config/agents/specialized/solo-dev-planner-modular/WORKFLOW-DIAGRAM.md +355 -0
  93. package/ai-config/agents/specialized/solo-dev-planner-modular/solo-dev-planner.md +279 -0
  94. package/ai-config/agents/specialized/template-writer.md +347 -0
  95. package/ai-config/agents/specialized/test-runner.md +99 -0
  96. package/ai-config/agents/specialized/vibekanban-smart-worker.md +244 -0
  97. package/ai-config/agents/specialized/wave-executor.md +138 -0
  98. package/ai-config/agents/specialized/workflow-optimizer.md +1114 -0
  99. package/ai-config/commands/git/changelog.md +32 -0
  100. package/ai-config/commands/git/ci-local.md +70 -0
  101. package/ai-config/commands/git/commit.md +35 -0
  102. package/ai-config/commands/git/fix-issue.md +23 -0
  103. package/ai-config/commands/git/pr-create.md +42 -0
  104. package/ai-config/commands/git/pr-review.md +50 -0
  105. package/ai-config/commands/git/worktree.md +39 -0
  106. package/ai-config/commands/refactoring/cleanup.md +24 -0
  107. package/ai-config/commands/refactoring/dead-code.md +40 -0
  108. package/ai-config/commands/refactoring/extract.md +31 -0
  109. package/ai-config/commands/testing/e2e.md +30 -0
  110. package/ai-config/commands/testing/tdd.md +36 -0
  111. package/ai-config/commands/testing/test-coverage.md +30 -0
  112. package/ai-config/commands/testing/test-fix.md +24 -0
  113. package/ai-config/commands/workflow/generate-agents-md.md +85 -0
  114. package/ai-config/commands/workflow/planning.md +47 -0
  115. package/ai-config/commands/workflows/compound.md +89 -0
  116. package/ai-config/commands/workflows/plan.md +77 -0
  117. package/ai-config/commands/workflows/review.md +78 -0
  118. package/ai-config/commands/workflows/work.md +75 -0
  119. package/ai-config/config.yaml +18 -0
  120. package/ai-config/hooks/_TEMPLATE.md +96 -0
  121. package/ai-config/hooks/block-dangerous-commands.md +75 -0
  122. package/ai-config/hooks/commit-guard.md +90 -0
  123. package/ai-config/hooks/context-loader.md +73 -0
  124. package/ai-config/hooks/improve-prompt.md +91 -0
  125. package/ai-config/hooks/learning-log.md +72 -0
  126. package/ai-config/hooks/model-router.md +86 -0
  127. package/ai-config/hooks/secret-scanner.md +64 -0
  128. package/ai-config/hooks/skill-validator.md +102 -0
  129. package/ai-config/hooks/task-artifact.md +114 -0
  130. package/ai-config/hooks/validate-workflow.md +100 -0
  131. package/ai-config/prompts/base.md +71 -0
  132. package/ai-config/prompts/modes/debug.md +34 -0
  133. package/ai-config/prompts/modes/deploy.md +40 -0
  134. package/ai-config/prompts/modes/research.md +32 -0
  135. package/ai-config/prompts/modes/review.md +33 -0
  136. package/ai-config/prompts/review-policy.md +79 -0
  137. package/ai-config/skills/_TEMPLATE.md +157 -0
  138. package/ai-config/skills/backend/api-gateway/SKILL.md +254 -0
  139. package/ai-config/skills/backend/bff-concepts/SKILL.md +239 -0
  140. package/ai-config/skills/backend/bff-spring/SKILL.md +364 -0
  141. package/ai-config/skills/backend/chi-router/SKILL.md +396 -0
  142. package/ai-config/skills/backend/error-handling/SKILL.md +255 -0
  143. package/ai-config/skills/backend/exceptions-spring/SKILL.md +323 -0
  144. package/ai-config/skills/backend/fastapi/SKILL.md +302 -0
  145. package/ai-config/skills/backend/gateway-spring/SKILL.md +390 -0
  146. package/ai-config/skills/backend/go-backend/SKILL.md +457 -0
  147. package/ai-config/skills/backend/gradle-multimodule/SKILL.md +274 -0
  148. package/ai-config/skills/backend/graphql-concepts/SKILL.md +352 -0
  149. package/ai-config/skills/backend/graphql-spring/SKILL.md +398 -0
  150. package/ai-config/skills/backend/grpc-concepts/SKILL.md +283 -0
  151. package/ai-config/skills/backend/grpc-spring/SKILL.md +445 -0
  152. package/ai-config/skills/backend/jwt-auth/SKILL.md +412 -0
  153. package/ai-config/skills/backend/notifications-concepts/SKILL.md +259 -0
  154. package/ai-config/skills/backend/recommendations-concepts/SKILL.md +261 -0
  155. package/ai-config/skills/backend/search-concepts/SKILL.md +263 -0
  156. package/ai-config/skills/backend/search-spring/SKILL.md +375 -0
  157. package/ai-config/skills/backend/spring-boot-4/SKILL.md +172 -0
  158. package/ai-config/skills/backend/websockets/SKILL.md +532 -0
  159. package/ai-config/skills/data-ai/ai-ml/SKILL.md +423 -0
  160. package/ai-config/skills/data-ai/analytics-concepts/SKILL.md +195 -0
  161. package/ai-config/skills/data-ai/analytics-spring/SKILL.md +340 -0
  162. package/ai-config/skills/data-ai/duckdb-analytics/SKILL.md +440 -0
  163. package/ai-config/skills/data-ai/langchain/SKILL.md +238 -0
  164. package/ai-config/skills/data-ai/mlflow/SKILL.md +302 -0
  165. package/ai-config/skills/data-ai/onnx-inference/SKILL.md +290 -0
  166. package/ai-config/skills/data-ai/powerbi/SKILL.md +352 -0
  167. package/ai-config/skills/data-ai/pytorch/SKILL.md +274 -0
  168. package/ai-config/skills/data-ai/scikit-learn/SKILL.md +321 -0
  169. package/ai-config/skills/data-ai/vector-db/SKILL.md +301 -0
  170. package/ai-config/skills/database/graph-databases/SKILL.md +218 -0
  171. package/ai-config/skills/database/graph-spring/SKILL.md +361 -0
  172. package/ai-config/skills/database/pgx-postgres/SKILL.md +512 -0
  173. package/ai-config/skills/database/redis-cache/SKILL.md +343 -0
  174. package/ai-config/skills/database/sqlite-embedded/SKILL.md +388 -0
  175. package/ai-config/skills/database/timescaledb/SKILL.md +320 -0
  176. package/ai-config/skills/docs/api-documentation/SKILL.md +293 -0
  177. package/ai-config/skills/docs/docs-spring/SKILL.md +377 -0
  178. package/ai-config/skills/docs/mustache-templates/SKILL.md +190 -0
  179. package/ai-config/skills/docs/technical-docs/SKILL.md +447 -0
  180. package/ai-config/skills/frontend/astro-ssr/SKILL.md +441 -0
  181. package/ai-config/skills/frontend/frontend-design/SKILL.md +54 -0
  182. package/ai-config/skills/frontend/frontend-web/SKILL.md +368 -0
  183. package/ai-config/skills/frontend/mantine-ui/SKILL.md +396 -0
  184. package/ai-config/skills/frontend/tanstack-query/SKILL.md +439 -0
  185. package/ai-config/skills/frontend/zod-validation/SKILL.md +417 -0
  186. package/ai-config/skills/frontend/zustand-state/SKILL.md +350 -0
  187. package/ai-config/skills/infrastructure/chaos-engineering/SKILL.md +244 -0
  188. package/ai-config/skills/infrastructure/chaos-spring/SKILL.md +378 -0
  189. package/ai-config/skills/infrastructure/devops-infra/SKILL.md +435 -0
  190. package/ai-config/skills/infrastructure/docker-containers/SKILL.md +420 -0
  191. package/ai-config/skills/infrastructure/kubernetes/SKILL.md +456 -0
  192. package/ai-config/skills/infrastructure/opentelemetry/SKILL.md +546 -0
  193. package/ai-config/skills/infrastructure/traefik-proxy/SKILL.md +474 -0
  194. package/ai-config/skills/infrastructure/woodpecker-ci/SKILL.md +315 -0
  195. package/ai-config/skills/mobile/ionic-capacitor/SKILL.md +504 -0
  196. package/ai-config/skills/mobile/mobile-ionic/SKILL.md +448 -0
  197. package/ai-config/skills/prompt-improver/SKILL.md +125 -0
  198. package/ai-config/skills/quality/ghagga-review/SKILL.md +216 -0
  199. package/ai-config/skills/references/hooks-patterns/SKILL.md +238 -0
  200. package/ai-config/skills/references/mcp-servers/SKILL.md +275 -0
  201. package/ai-config/skills/references/plugins-reference/SKILL.md +110 -0
  202. package/ai-config/skills/references/skills-reference/SKILL.md +420 -0
  203. package/ai-config/skills/references/subagent-templates/SKILL.md +193 -0
  204. package/ai-config/skills/systems-iot/modbus-protocol/SKILL.md +410 -0
  205. package/ai-config/skills/systems-iot/mqtt-rumqttc/SKILL.md +408 -0
  206. package/ai-config/skills/systems-iot/rust-systems/SKILL.md +386 -0
  207. package/ai-config/skills/systems-iot/tokio-async/SKILL.md +324 -0
  208. package/ai-config/skills/testing/playwright-e2e/SKILL.md +289 -0
  209. package/ai-config/skills/testing/testcontainers/SKILL.md +299 -0
  210. package/ai-config/skills/testing/vitest-testing/SKILL.md +381 -0
  211. package/ai-config/skills/workflow/ci-local-guide/SKILL.md +118 -0
  212. package/ai-config/skills/workflow/claude-automation-recommender/SKILL.md +299 -0
  213. package/ai-config/skills/workflow/claude-md-improver/SKILL.md +158 -0
  214. package/ai-config/skills/workflow/finishing-a-development-branch/SKILL.md +117 -0
  215. package/ai-config/skills/workflow/git-github/SKILL.md +334 -0
  216. package/ai-config/skills/workflow/git-github/references/examples.md +160 -0
  217. package/ai-config/skills/workflow/git-workflow/SKILL.md +214 -0
  218. package/ai-config/skills/workflow/ide-plugins/SKILL.md +277 -0
  219. package/ai-config/skills/workflow/ide-plugins-intellij/SKILL.md +401 -0
  220. package/ai-config/skills/workflow/obsidian-brain-workflow/SKILL.md +199 -0
  221. package/ai-config/skills/workflow/using-git-worktrees/SKILL.md +100 -0
  222. package/ai-config/skills/workflow/verification-before-completion/SKILL.md +73 -0
  223. package/ai-config/skills/workflow/wave-workflow/SKILL.md +178 -0
  224. package/ci-local/README.md +170 -0
  225. package/ci-local/ci-local.sh +297 -0
  226. package/ci-local/hooks/commit-msg +74 -0
  227. package/ci-local/hooks/pre-commit +162 -0
  228. package/ci-local/hooks/pre-push +41 -0
  229. package/ci-local/install.sh +49 -0
  230. package/ci-local/semgrep.yml +214 -0
  231. package/dist/commands/analyze.d.ts +9 -0
  232. package/dist/commands/analyze.d.ts.map +1 -0
  233. package/dist/commands/analyze.js +55 -0
  234. package/dist/commands/analyze.js.map +1 -0
  235. package/dist/commands/analyze.test.d.ts +2 -0
  236. package/dist/commands/analyze.test.d.ts.map +1 -0
  237. package/dist/commands/analyze.test.js +145 -0
  238. package/dist/commands/analyze.test.js.map +1 -0
  239. package/dist/commands/doctor.d.ts +7 -0
  240. package/dist/commands/doctor.d.ts.map +1 -0
  241. package/dist/commands/doctor.js +158 -0
  242. package/dist/commands/doctor.js.map +1 -0
  243. package/dist/commands/doctor.test.d.ts +2 -0
  244. package/dist/commands/doctor.test.d.ts.map +1 -0
  245. package/dist/commands/doctor.test.js +200 -0
  246. package/dist/commands/doctor.test.js.map +1 -0
  247. package/dist/commands/init.d.ts +9 -0
  248. package/dist/commands/init.d.ts.map +1 -0
  249. package/dist/commands/init.js +283 -0
  250. package/dist/commands/init.js.map +1 -0
  251. package/dist/commands/init.test.d.ts +2 -0
  252. package/dist/commands/init.test.d.ts.map +1 -0
  253. package/dist/commands/init.test.js +271 -0
  254. package/dist/commands/init.test.js.map +1 -0
  255. package/dist/commands/sync.d.ts +8 -0
  256. package/dist/commands/sync.d.ts.map +1 -0
  257. package/dist/commands/sync.js +201 -0
  258. package/dist/commands/sync.js.map +1 -0
  259. package/dist/constants.d.ts +21 -0
  260. package/dist/constants.d.ts.map +1 -0
  261. package/dist/constants.js +57 -0
  262. package/dist/constants.js.map +1 -0
  263. package/dist/e2e/aggressive.e2e.test.d.ts +2 -0
  264. package/dist/e2e/aggressive.e2e.test.d.ts.map +1 -0
  265. package/dist/e2e/aggressive.e2e.test.js +350 -0
  266. package/dist/e2e/aggressive.e2e.test.js.map +1 -0
  267. package/dist/e2e/commands.e2e.test.d.ts +2 -0
  268. package/dist/e2e/commands.e2e.test.d.ts.map +1 -0
  269. package/dist/e2e/commands.e2e.test.js +213 -0
  270. package/dist/e2e/commands.e2e.test.js.map +1 -0
  271. package/dist/index.d.ts +3 -0
  272. package/dist/index.d.ts.map +1 -0
  273. package/dist/index.js +82 -0
  274. package/dist/index.js.map +1 -0
  275. package/dist/lib/common.d.ts +17 -0
  276. package/dist/lib/common.d.ts.map +1 -0
  277. package/dist/lib/common.js +111 -0
  278. package/dist/lib/common.js.map +1 -0
  279. package/dist/lib/common.test.d.ts +2 -0
  280. package/dist/lib/common.test.d.ts.map +1 -0
  281. package/dist/lib/common.test.js +316 -0
  282. package/dist/lib/common.test.js.map +1 -0
  283. package/dist/lib/frontmatter.d.ts +18 -0
  284. package/dist/lib/frontmatter.d.ts.map +1 -0
  285. package/dist/lib/frontmatter.js +61 -0
  286. package/dist/lib/frontmatter.js.map +1 -0
  287. package/dist/lib/frontmatter.test.d.ts +2 -0
  288. package/dist/lib/frontmatter.test.d.ts.map +1 -0
  289. package/dist/lib/frontmatter.test.js +257 -0
  290. package/dist/lib/frontmatter.test.js.map +1 -0
  291. package/dist/lib/template.d.ts +24 -0
  292. package/dist/lib/template.d.ts.map +1 -0
  293. package/dist/lib/template.js +78 -0
  294. package/dist/lib/template.js.map +1 -0
  295. package/dist/lib/template.test.d.ts +2 -0
  296. package/dist/lib/template.test.d.ts.map +1 -0
  297. package/dist/lib/template.test.js +201 -0
  298. package/dist/lib/template.test.js.map +1 -0
  299. package/dist/types/index.d.ts +48 -0
  300. package/dist/types/index.d.ts.map +1 -0
  301. package/dist/types/index.js +2 -0
  302. package/dist/types/index.js.map +1 -0
  303. package/dist/ui/AnalyzeUI.d.ts +7 -0
  304. package/dist/ui/AnalyzeUI.d.ts.map +1 -0
  305. package/dist/ui/AnalyzeUI.js +100 -0
  306. package/dist/ui/AnalyzeUI.js.map +1 -0
  307. package/dist/ui/App.d.ts +13 -0
  308. package/dist/ui/App.d.ts.map +1 -0
  309. package/dist/ui/App.js +100 -0
  310. package/dist/ui/App.js.map +1 -0
  311. package/dist/ui/CIContext.d.ts +9 -0
  312. package/dist/ui/CIContext.d.ts.map +1 -0
  313. package/dist/ui/CIContext.js +9 -0
  314. package/dist/ui/CIContext.js.map +1 -0
  315. package/dist/ui/CISelector.d.ts +8 -0
  316. package/dist/ui/CISelector.d.ts.map +1 -0
  317. package/dist/ui/CISelector.js +45 -0
  318. package/dist/ui/CISelector.js.map +1 -0
  319. package/dist/ui/Doctor.d.ts +3 -0
  320. package/dist/ui/Doctor.d.ts.map +1 -0
  321. package/dist/ui/Doctor.js +89 -0
  322. package/dist/ui/Doctor.js.map +1 -0
  323. package/dist/ui/Header.d.ts +8 -0
  324. package/dist/ui/Header.d.ts.map +1 -0
  325. package/dist/ui/Header.js +30 -0
  326. package/dist/ui/Header.js.map +1 -0
  327. package/dist/ui/MemorySelector.d.ts +8 -0
  328. package/dist/ui/MemorySelector.d.ts.map +1 -0
  329. package/dist/ui/MemorySelector.js +46 -0
  330. package/dist/ui/MemorySelector.js.map +1 -0
  331. package/dist/ui/NameInput.d.ts +8 -0
  332. package/dist/ui/NameInput.d.ts.map +1 -0
  333. package/dist/ui/NameInput.js +69 -0
  334. package/dist/ui/NameInput.js.map +1 -0
  335. package/dist/ui/OptionSelector.d.ts +12 -0
  336. package/dist/ui/OptionSelector.d.ts.map +1 -0
  337. package/dist/ui/OptionSelector.js +69 -0
  338. package/dist/ui/OptionSelector.js.map +1 -0
  339. package/dist/ui/Progress.d.ts +11 -0
  340. package/dist/ui/Progress.d.ts.map +1 -0
  341. package/dist/ui/Progress.js +58 -0
  342. package/dist/ui/Progress.js.map +1 -0
  343. package/dist/ui/StackSelector.d.ts +9 -0
  344. package/dist/ui/StackSelector.d.ts.map +1 -0
  345. package/dist/ui/StackSelector.js +65 -0
  346. package/dist/ui/StackSelector.js.map +1 -0
  347. package/dist/ui/Summary.d.ts +12 -0
  348. package/dist/ui/Summary.d.ts.map +1 -0
  349. package/dist/ui/Summary.js +114 -0
  350. package/dist/ui/Summary.js.map +1 -0
  351. package/dist/ui/SyncUI.d.ts +10 -0
  352. package/dist/ui/SyncUI.d.ts.map +1 -0
  353. package/dist/ui/SyncUI.js +64 -0
  354. package/dist/ui/SyncUI.js.map +1 -0
  355. package/dist/ui/Welcome.d.ts +7 -0
  356. package/dist/ui/Welcome.d.ts.map +1 -0
  357. package/dist/ui/Welcome.js +45 -0
  358. package/dist/ui/Welcome.js.map +1 -0
  359. package/dist/ui/theme.d.ts +10 -0
  360. package/dist/ui/theme.d.ts.map +1 -0
  361. package/dist/ui/theme.js +9 -0
  362. package/dist/ui/theme.js.map +1 -0
  363. package/modules/engram/.gitignore-snippet.txt +6 -0
  364. package/modules/engram/.mcp-config-snippet.json +11 -0
  365. package/modules/engram/README.md +146 -0
  366. package/modules/engram/install-engram.sh +216 -0
  367. package/modules/ghagga/.env.example +43 -0
  368. package/modules/ghagga/README.md +153 -0
  369. package/modules/ghagga/docker-compose.yml +80 -0
  370. package/modules/ghagga/setup-ghagga.sh +139 -0
  371. package/modules/memory-simple/.project/NOTES.md +22 -0
  372. package/modules/memory-simple/README.md +23 -0
  373. package/modules/obsidian-brain/.obsidian/app.json +23 -0
  374. package/modules/obsidian-brain/.obsidian/appearance.json +5 -0
  375. package/modules/obsidian-brain/.obsidian/bookmarks.json +34 -0
  376. package/modules/obsidian-brain/.obsidian/community-plugins.json +1 -0
  377. package/modules/obsidian-brain/.obsidian/core-plugins-migration.json +21 -0
  378. package/modules/obsidian-brain/.obsidian/core-plugins.json +18 -0
  379. package/modules/obsidian-brain/.obsidian/daily-notes.json +5 -0
  380. package/modules/obsidian-brain/.obsidian/graph.json +37 -0
  381. package/modules/obsidian-brain/.obsidian/hotkeys.json +14 -0
  382. package/modules/obsidian-brain/.obsidian/plugins/dataview/data.json +25 -0
  383. package/modules/obsidian-brain/.obsidian/plugins/obsidian-kanban/data.json +29 -0
  384. package/modules/obsidian-brain/.obsidian/plugins/templater-obsidian/data.json +18 -0
  385. package/modules/obsidian-brain/.obsidian/snippets/project-memory.css +71 -0
  386. package/modules/obsidian-brain/.obsidian-gitignore-snippet.txt +8 -0
  387. package/modules/obsidian-brain/.project/Attachments/.gitkeep +0 -0
  388. package/modules/obsidian-brain/.project/Memory/BLOCKERS.md +78 -0
  389. package/modules/obsidian-brain/.project/Memory/CONTEXT.md +102 -0
  390. package/modules/obsidian-brain/.project/Memory/DASHBOARD.md +73 -0
  391. package/modules/obsidian-brain/.project/Memory/DECISIONS.md +87 -0
  392. package/modules/obsidian-brain/.project/Memory/KANBAN.md +15 -0
  393. package/modules/obsidian-brain/.project/Memory/README.md +61 -0
  394. package/modules/obsidian-brain/.project/Memory/WAVES.md +78 -0
  395. package/modules/obsidian-brain/.project/Sessions/TEMPLATE.md +99 -0
  396. package/modules/obsidian-brain/.project/Templates/ADR.md +33 -0
  397. package/modules/obsidian-brain/.project/Templates/Blocker.md +21 -0
  398. package/modules/obsidian-brain/.project/Templates/Session.md +88 -0
  399. package/modules/obsidian-brain/README.md +268 -0
  400. package/modules/obsidian-brain/new-wave.sh +182 -0
  401. package/package.json +51 -0
  402. package/schemas/agent.schema.json +34 -0
  403. package/schemas/ai-config.schema.json +28 -0
  404. package/schemas/skill.schema.json +44 -0
  405. package/src/commands/analyze.test.ts +145 -0
  406. package/src/commands/analyze.ts +69 -0
  407. package/src/commands/doctor.test.ts +208 -0
  408. package/src/commands/doctor.ts +163 -0
  409. package/src/commands/init.test.ts +298 -0
  410. package/src/commands/init.ts +285 -0
  411. package/src/constants.ts +69 -0
  412. package/src/e2e/aggressive.e2e.test.ts +557 -0
  413. package/src/e2e/commands.e2e.test.ts +298 -0
  414. package/src/index.tsx +106 -0
  415. package/src/lib/common.test.ts +318 -0
  416. package/src/lib/common.ts +127 -0
  417. package/src/lib/frontmatter.test.ts +291 -0
  418. package/src/lib/frontmatter.ts +77 -0
  419. package/src/lib/template.test.ts +226 -0
  420. package/src/lib/template.ts +99 -0
  421. package/src/types/index.ts +53 -0
  422. package/src/ui/AnalyzeUI.tsx +133 -0
  423. package/src/ui/App.tsx +175 -0
  424. package/src/ui/CIContext.tsx +25 -0
  425. package/src/ui/CISelector.tsx +72 -0
  426. package/src/ui/Doctor.tsx +122 -0
  427. package/src/ui/Header.tsx +48 -0
  428. package/src/ui/MemorySelector.tsx +73 -0
  429. package/src/ui/NameInput.tsx +82 -0
  430. package/src/ui/OptionSelector.tsx +100 -0
  431. package/src/ui/Progress.tsx +88 -0
  432. package/src/ui/StackSelector.tsx +101 -0
  433. package/src/ui/Summary.tsx +134 -0
  434. package/src/ui/Welcome.tsx +54 -0
  435. package/src/ui/theme.ts +10 -0
  436. package/stryker.config.json +19 -0
  437. package/tasks/_TEMPLATE/files-edited.md +3 -0
  438. package/tasks/_TEMPLATE/plan.md +3 -0
  439. package/tasks/_TEMPLATE/research.md +3 -0
  440. package/tasks/_TEMPLATE/verification.md +5 -0
  441. package/templates/common/dependabot/cargo.yml +11 -0
  442. package/templates/common/dependabot/github-actions.yml +16 -0
  443. package/templates/common/dependabot/gomod.yml +15 -0
  444. package/templates/common/dependabot/gradle.yml +15 -0
  445. package/templates/common/dependabot/header.yml +3 -0
  446. package/templates/common/dependabot/maven.yml +15 -0
  447. package/templates/common/dependabot/npm.yml +20 -0
  448. package/templates/common/dependabot/pip.yml +11 -0
  449. package/templates/dependabot.yml +162 -0
  450. package/templates/github/ci-go.yml +41 -0
  451. package/templates/github/ci-java.yml +45 -0
  452. package/templates/github/ci-monorepo.yml +150 -0
  453. package/templates/github/ci-node.yml +42 -0
  454. package/templates/github/ci-python.yml +42 -0
  455. package/templates/github/ci-rust.yml +42 -0
  456. package/templates/github/dependabot-automerge.yml +40 -0
  457. package/templates/gitlab/gitlab-ci-go.yml +88 -0
  458. package/templates/gitlab/gitlab-ci-java.yml +79 -0
  459. package/templates/gitlab/gitlab-ci-monorepo.yml +126 -0
  460. package/templates/gitlab/gitlab-ci-node.yml +63 -0
  461. package/templates/gitlab/gitlab-ci-python.yml +147 -0
  462. package/templates/gitlab/gitlab-ci-rust.yml +67 -0
  463. package/templates/global/claude-settings.json +98 -0
  464. package/templates/global/codex-config.toml +8 -0
  465. package/templates/global/copilot-instructions/base-rules.instructions.md +13 -0
  466. package/templates/global/copilot-instructions/sdd-orchestrator.instructions.md +37 -0
  467. package/templates/global/gemini-commands/cleanup.toml +20 -0
  468. package/templates/global/gemini-commands/commit.toml +15 -0
  469. package/templates/global/gemini-commands/dead-code.toml +22 -0
  470. package/templates/global/gemini-commands/plan.toml +30 -0
  471. package/templates/global/gemini-commands/review.toml +17 -0
  472. package/templates/global/gemini-commands/sdd-apply.toml +22 -0
  473. package/templates/global/gemini-commands/sdd-ff.toml +14 -0
  474. package/templates/global/gemini-commands/sdd-new.toml +21 -0
  475. package/templates/global/gemini-commands/sdd-verify.toml +21 -0
  476. package/templates/global/gemini-commands/tdd.toml +26 -0
  477. package/templates/global/gemini-settings.json +8 -0
  478. package/templates/global/opencode-config.json +44 -0
  479. package/templates/global/sdd-instructions.md +47 -0
  480. package/templates/global/sdd-orchestrator-claude.md +46 -0
  481. package/templates/global/sdd-orchestrator-copilot.md +34 -0
  482. package/templates/renovate.json +69 -0
  483. package/templates/woodpecker/monorepo/backend.yml +34 -0
  484. package/templates/woodpecker/monorepo/frontend.yml +34 -0
  485. package/templates/woodpecker/monorepo/summary.yml +25 -0
  486. package/templates/woodpecker/woodpecker-go.yml +51 -0
  487. package/templates/woodpecker/woodpecker-java.yml +67 -0
  488. package/templates/woodpecker/woodpecker-node.yml +47 -0
  489. package/templates/woodpecker/woodpecker-python.yml +108 -0
  490. package/templates/woodpecker/woodpecker-rust.yml +57 -0
  491. package/tsconfig.json +19 -0
  492. package/vitest.config.ts +16 -0
  493. package/workflows/reusable-build-go.yml +111 -0
  494. package/workflows/reusable-build-java.yml +120 -0
  495. package/workflows/reusable-build-node.yml +145 -0
  496. package/workflows/reusable-build-python.yml +159 -0
  497. package/workflows/reusable-build-rust.yml +135 -0
  498. package/workflows/reusable-docker.yml +120 -0
  499. package/workflows/reusable-ghagga-review.yml +165 -0
  500. package/workflows/reusable-release.yml +91 -0
@@ -0,0 +1,114 @@
1
+ import React, { useEffect } from 'react';
2
+ import { Box, Text, useApp, useInput } from 'ink';
3
+ import { theme } from './theme.js';
4
+ import { useCIMode } from './CIContext.js';
5
+ /** Map stack to the install command hint */
6
+ function getInstallHint(stack) {
7
+ switch (stack) {
8
+ case 'node': return 'pnpm install';
9
+ case 'python': return 'pip install -r requirements.txt';
10
+ case 'go': return 'go mod tidy';
11
+ case 'rust': return 'cargo build';
12
+ case 'java-gradle': return './gradlew build';
13
+ case 'java-maven': return 'mvn install';
14
+ case 'elixir': return 'mix deps.get';
15
+ default: return null;
16
+ }
17
+ }
18
+ export default function Summary({ steps, dryRun, projectName, stack, elapsedMs }) {
19
+ const { exit } = useApp();
20
+ const isCI = useCIMode();
21
+ const done = steps.filter(s => s.status === 'done').length;
22
+ const skipped = steps.filter(s => s.status === 'skipped').length;
23
+ const errors = steps.filter(s => s.status === 'error');
24
+ const elapsed = elapsedMs != null
25
+ ? `${(elapsedMs / 1000).toFixed(1)}s`
26
+ : null;
27
+ // Auto-exit in CI mode
28
+ useEffect(() => {
29
+ if (isCI) {
30
+ const t = setTimeout(() => exit(), 100);
31
+ return () => clearTimeout(t);
32
+ }
33
+ return undefined;
34
+ }, [isCI, exit]);
35
+ useInput((_, key) => {
36
+ if (key.return || key.escape)
37
+ exit();
38
+ }, { isActive: !isCI });
39
+ const installHint = getInstallHint(stack);
40
+ return (React.createElement(Box, { flexDirection: "column" },
41
+ React.createElement(Text, { bold: true, color: errors.length > 0 ? theme.warning : theme.success },
42
+ dryRun ? '\u25cb Dry run complete' : '\u2713 Project scaffolded',
43
+ elapsed && React.createElement(Text, { color: theme.muted },
44
+ " Completed in ",
45
+ elapsed)),
46
+ React.createElement(Box, { marginTop: 1 },
47
+ React.createElement(Text, { color: theme.muted }, " Project: "),
48
+ React.createElement(Text, { color: theme.primary, bold: true }, projectName),
49
+ stack && React.createElement(Text, { color: theme.muted },
50
+ " (",
51
+ stack,
52
+ ")")),
53
+ dryRun && (React.createElement(Box, { marginTop: 1 },
54
+ React.createElement(Text, { color: theme.warning, bold: true }, " No changes were made (dry run)"))),
55
+ React.createElement(Box, { marginTop: 1, flexDirection: "column" }, steps.map(step => (React.createElement(Box, { key: step.id, marginLeft: 2 }, step.status === 'done' ? (React.createElement(Text, { color: theme.success },
56
+ '\u2713',
57
+ " ",
58
+ step.label,
59
+ step.detail ? React.createElement(Text, { color: theme.muted, dimColor: true },
60
+ " ",
61
+ step.detail) : null)) : step.status === 'skipped' ? (React.createElement(Text, { color: theme.muted },
62
+ '\u2013',
63
+ " ",
64
+ step.label,
65
+ step.detail ? React.createElement(Text, { dimColor: true },
66
+ " ",
67
+ step.detail) : null)) : step.status === 'error' ? (React.createElement(Text, { color: theme.error },
68
+ '\u2717',
69
+ " ",
70
+ step.label,
71
+ step.detail ? React.createElement(Text, { color: theme.muted, dimColor: true },
72
+ " ",
73
+ step.detail) : null)) : null)))),
74
+ React.createElement(Box, { marginTop: 1, flexDirection: "column" },
75
+ React.createElement(Text, { color: theme.success },
76
+ " ",
77
+ '\u2713',
78
+ " ",
79
+ done,
80
+ " steps completed"),
81
+ skipped > 0 && (React.createElement(Text, { color: theme.muted },
82
+ " ",
83
+ '\u2013',
84
+ " ",
85
+ skipped,
86
+ " steps skipped")),
87
+ errors.length > 0 && (React.createElement(Box, { flexDirection: "column" },
88
+ React.createElement(Text, { color: theme.error },
89
+ " ",
90
+ '\u2717',
91
+ " ",
92
+ errors.length,
93
+ " errors:"),
94
+ errors.map(e => (React.createElement(Text, { key: `err-${e.id}`, color: theme.error },
95
+ " ",
96
+ '\u2022',
97
+ " ",
98
+ e.label,
99
+ ": ",
100
+ e.detail)))))),
101
+ !dryRun && errors.length === 0 && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
102
+ React.createElement(Text, { color: theme.muted, bold: true }, " Next steps:"),
103
+ React.createElement(Text, { color: theme.primary },
104
+ " cd ",
105
+ projectName),
106
+ installHint && React.createElement(Text, { color: theme.primary },
107
+ " ",
108
+ installHint),
109
+ React.createElement(Text, { color: theme.primary }, " npx javi-ai sync"),
110
+ React.createElement(Text, { color: theme.primary }, " javi-forge doctor"))),
111
+ React.createElement(Box, { marginTop: 1 },
112
+ React.createElement(Text, { color: theme.muted, dimColor: true }, "Press Enter to exit"))));
113
+ }
114
+ //# sourceMappingURL=Summary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Summary.js","sourceRoot":"","sources":["../../src/ui/Summary.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import React from 'react';
2
+ import type { AI_CLI } from '../types/index.js';
3
+ interface Props {
4
+ target: AI_CLI | 'all';
5
+ mode: 'overwrite' | 'merge';
6
+ dryRun: boolean;
7
+ }
8
+ export default function SyncUI({ target, mode, dryRun }: Props): React.JSX.Element;
9
+ export {};
10
+ //# sourceMappingURL=SyncUI.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SyncUI.d.ts","sourceRoot":"","sources":["../../src/ui/SyncUI.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAIlD,OAAO,KAAK,EAAY,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAIzD,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,GAAG,KAAK,CAAA;IACtB,IAAI,EAAE,WAAW,GAAG,OAAO,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,qBAwE7D"}
@@ -0,0 +1,64 @@
1
+ import React, { useEffect, useState } from 'react';
2
+ import { Box, Text, useApp, useInput } from 'ink';
3
+ import Spinner from 'ink-spinner';
4
+ import { syncAIConfig } from '../commands/sync.js';
5
+ import Header from './Header.js';
6
+ import { theme } from './theme.js';
7
+ export default function SyncUI({ target, mode, dryRun }) {
8
+ const { exit } = useApp();
9
+ const [steps, setSteps] = useState([]);
10
+ const [finished, setFinished] = useState(false);
11
+ useEffect(() => {
12
+ syncAIConfig({ target, mode, projectDir: process.cwd(), dryRun }, (step) => setSteps(prev => {
13
+ const idx = prev.findIndex(s => s.id === step.id);
14
+ if (idx >= 0) {
15
+ const next = [...prev];
16
+ next[idx] = step;
17
+ return next;
18
+ }
19
+ return [...prev, step];
20
+ })).then(() => setFinished(true));
21
+ }, [target, mode, dryRun]);
22
+ useInput((_, key) => {
23
+ if (finished && (key.return || key.escape))
24
+ exit();
25
+ });
26
+ const done = steps.filter(s => s.status === 'done').length;
27
+ const errors = steps.filter(s => s.status === 'error').length;
28
+ return (React.createElement(Box, { flexDirection: "column", padding: 1 },
29
+ React.createElement(Header, { subtitle: "sync", dryRun: dryRun }),
30
+ React.createElement(Box, { flexDirection: "column" }, steps.map(step => (React.createElement(Box, { key: step.id, marginLeft: 2 }, step.status === 'running' ? (React.createElement(Text, { color: theme.warning },
31
+ React.createElement(Spinner, { type: "dots" }),
32
+ ' ',
33
+ step.label)) : step.status === 'done' ? (React.createElement(Text, { color: theme.success },
34
+ '\u2713',
35
+ " ",
36
+ step.label,
37
+ step.detail && React.createElement(Text, { color: theme.muted, dimColor: true },
38
+ " ",
39
+ step.detail))) : step.status === 'error' ? (React.createElement(Text, { color: theme.error },
40
+ '\u2717',
41
+ " ",
42
+ step.label,
43
+ step.detail && React.createElement(Text, { color: theme.muted, dimColor: true },
44
+ " ",
45
+ step.detail))) : (React.createElement(Text, { color: theme.muted },
46
+ '\u2013',
47
+ " ",
48
+ step.label,
49
+ step.detail && React.createElement(Text, { dimColor: true },
50
+ " ",
51
+ step.detail))))))),
52
+ finished && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
53
+ React.createElement(Text, { bold: true, color: errors > 0 ? theme.warning : theme.success },
54
+ dryRun ? '\u25cb Dry run complete' : '\u2713 Sync complete',
55
+ ' ',
56
+ "(",
57
+ done,
58
+ " done",
59
+ errors > 0 ? `, ${errors} errors` : '',
60
+ ")"),
61
+ React.createElement(Box, { marginTop: 1 },
62
+ React.createElement(Text, { color: theme.muted, dimColor: true }, "Press Enter to exit"))))));
63
+ }
64
+ //# sourceMappingURL=SyncUI.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SyncUI.js","sourceRoot":"","sources":["../../src/ui/SyncUI.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import React from 'react';
2
+ interface Props {
3
+ onDone: () => void;
4
+ }
5
+ export default function Welcome({ onDone }: Props): React.JSX.Element;
6
+ export {};
7
+ //# sourceMappingURL=Welcome.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Welcome.d.ts","sourceRoot":"","sources":["../../src/ui/Welcome.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAOxC,UAAU,KAAK;IACb,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,qBA0ChD"}
@@ -0,0 +1,45 @@
1
+ import React, { useEffect } from 'react';
2
+ import { Box, Text } from 'ink';
3
+ import Spinner from 'ink-spinner';
4
+ import Header from './Header.js';
5
+ import { theme } from './theme.js';
6
+ import { useCIMode } from './CIContext.js';
7
+ export default function Welcome({ onDone }) {
8
+ const isCI = useCIMode();
9
+ useEffect(() => {
10
+ // Skip welcome delay in CI mode
11
+ const timer = setTimeout(onDone, isCI ? 0 : 1500);
12
+ return () => clearTimeout(timer);
13
+ }, [onDone, isCI]);
14
+ return (React.createElement(Box, { flexDirection: "column", padding: 1 },
15
+ React.createElement(Header, null),
16
+ React.createElement(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2 },
17
+ React.createElement(Text, null, "Bootstrap AI-ready projects with:"),
18
+ React.createElement(Box, { marginTop: 1, flexDirection: "column" },
19
+ React.createElement(Text, null,
20
+ React.createElement(Text, { color: theme.primary },
21
+ '\u25c6',
22
+ " Templates "),
23
+ React.createElement(Text, { color: theme.muted }, " Go, Java, Node, Python, Rust CI")),
24
+ React.createElement(Text, null,
25
+ React.createElement(Text, { color: theme.success },
26
+ '\u25c6',
27
+ " Memory "),
28
+ React.createElement(Text, { color: theme.muted }, " Engram, Obsidian Brain")),
29
+ React.createElement(Text, null,
30
+ React.createElement(Text, { color: theme.accent },
31
+ '\u25c6',
32
+ " SDD "),
33
+ React.createElement(Text, { color: theme.muted }, " Spec-Driven Development")),
34
+ React.createElement(Text, null,
35
+ React.createElement(Text, { color: theme.warning },
36
+ '\u25c6',
37
+ " Review "),
38
+ React.createElement(Text, { color: theme.muted }, " GHAGGA code review"))),
39
+ React.createElement(Box, { marginTop: 1 },
40
+ React.createElement(Text, { color: theme.muted },
41
+ React.createElement(Spinner, { type: "dots" }),
42
+ ' ',
43
+ "Detecting your environment...")))));
44
+ }
45
+ //# sourceMappingURL=Welcome.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Welcome.js","sourceRoot":"","sources":["../../src/ui/Welcome.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,OAAO,MAAM,aAAa,CAAA;AACjC,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAM1C,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,MAAM,EAAS;IAC/C,MAAM,IAAI,GAAG,SAAS,EAAE,CAAA;IAExB,SAAS,CAAC,GAAG,EAAE;QACb,gCAAgC;QAChC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACjD,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IAElB,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,OAAO,EAAE,CAAC;QACpC,oBAAC,MAAM,OAAG;QAEV,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;YACrD,oBAAC,IAAI,4CAAyC;YAC9C,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC,EAAE,aAAa,EAAC,QAAQ;gBACvC,oBAAC,IAAI;oBACH,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO;wBAAG,QAAQ;uCAAoB;oBACzD,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,uCAAyC,CAC5D;gBACP,oBAAC,IAAI;oBACH,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO;wBAAG,QAAQ;uCAAoB;oBACzD,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,8BAAgC,CACnD;gBACP,oBAAC,IAAI;oBACH,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,MAAM;wBAAG,QAAQ;uCAAoB;oBACxD,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,+BAAiC,CACpD;gBACP,oBAAC,IAAI;oBACH,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO;wBAAG,QAAQ;uCAAoB;oBACzD,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,0BAA4B,CAC/C,CACH;YACN,oBAAC,GAAG,IAAC,SAAS,EAAE,CAAC;gBACf,oBAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK;oBACtB,oBAAC,OAAO,IAAC,IAAI,EAAC,MAAM,GAAG;oBACtB,GAAG;oDACC,CACH,CACF,CACF,CACP,CAAA;AACH,CAAC"}
@@ -0,0 +1,10 @@
1
+ export declare const theme: {
2
+ readonly primary: "#f97316";
3
+ readonly success: "green";
4
+ readonly warning: "yellow";
5
+ readonly error: "red";
6
+ readonly muted: "gray";
7
+ readonly accent: "magenta";
8
+ };
9
+ export type ThemeColor = typeof theme[keyof typeof theme];
10
+ //# sourceMappingURL=theme.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;CAOR,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,CAAA"}
@@ -0,0 +1,9 @@
1
+ export const theme = {
2
+ primary: '#f97316', // orange
3
+ success: 'green',
4
+ warning: 'yellow',
5
+ error: 'red',
6
+ muted: 'gray',
7
+ accent: 'magenta',
8
+ };
9
+ //# sourceMappingURL=theme.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAG,SAAS,EAAG,SAAS;IAC/B,OAAO,EAAG,OAAO;IACjB,OAAO,EAAG,QAAQ;IAClB,KAAK,EAAK,KAAK;IACf,KAAK,EAAK,MAAM;IAChB,MAAM,EAAI,SAAS;CACX,CAAA"}
@@ -0,0 +1,6 @@
1
+
2
+ # Engram (AI agent memory)
3
+ .engram/
4
+ *.engram.db
5
+ *.engram.db-wal
6
+ *.engram.db-shm
@@ -0,0 +1,11 @@
1
+ {
2
+ "mcpServers": {
3
+ "engram": {
4
+ "command": "engram",
5
+ "args": ["mcp"],
6
+ "env": {
7
+ "ENGRAM_PROJECT": "__PROJECT_NAME__"
8
+ }
9
+ }
10
+ }
11
+ }
@@ -0,0 +1,146 @@
1
+ # Engram - Persistent Memory for AI Agents
2
+
3
+ > Tu agente AI olvida todo cuando termina la sesion. Engram le da memoria persistente.
4
+
5
+ ## Que es Engram
6
+
7
+ [Engram](https://github.com/Gentleman-Programming/engram) es un sistema de memoria persistente para agentes AI de coding.
8
+ Funciona como servidor MCP que permite a Claude Code, OpenCode, Cursor y otros agentes guardar y buscar memorias estructuradas entre sesiones.
9
+
10
+ ## Comparacion con otros modulos de memoria
11
+
12
+ | Modulo | Para quien | Persistencia | Busqueda |
13
+ |--------|-----------|-------------|----------|
14
+ | `memory-simple` | Humanos | Archivo NOTES.md | Manual |
15
+ | `obsidian-brain` | Humanos | Vault Obsidian + Kanban | Dataview queries |
16
+ | **`engram`** | **Agentes AI** | **SQLite + FTS5** | **Full-text search** |
17
+
18
+ **Engram complementa a obsidian-brain:** uno es para humanos (docs, kanban, decisiones), el otro para agentes AI (patrones, bugfixes, contexto entre sesiones).
19
+
20
+ ## Instalacion
21
+
22
+ ### Opcion 1: Via init-project.sh (recomendado)
23
+
24
+ ```bash
25
+ ./scripts/init-project.sh
26
+ # Seleccionar opcion 5 en modulo de memoria
27
+ ```
28
+
29
+ ### Opcion 2: Manual
30
+
31
+ ```bash
32
+ # Instalar binario
33
+ ./optional/engram/install-engram.sh
34
+
35
+ # Copiar config MCP a tu proyecto
36
+ cp optional/engram/.mcp-config-snippet.json tu-proyecto/.mcp.json
37
+
38
+ # Agregar al .gitignore
39
+ cat optional/engram/.gitignore-snippet.txt >> tu-proyecto/.gitignore
40
+ ```
41
+
42
+ ### Opcion 3: Desde releases
43
+
44
+ ```bash
45
+ # Linux/macOS
46
+ curl -fsSL https://github.com/Gentleman-Programming/engram/releases/latest/download/engram_$(uname -s)_$(uname -m).tar.gz | tar xz
47
+ sudo mv engram /usr/local/bin/
48
+
49
+ # Windows (PowerShell)
50
+ ./optional/engram/install-engram.ps1
51
+ ```
52
+
53
+ ## Configuracion MCP
54
+
55
+ ### Claude Code
56
+
57
+ Agregar a `.mcp.json` en la raiz del proyecto:
58
+
59
+ ```json
60
+ {
61
+ "mcpServers": {
62
+ "engram": {
63
+ "command": "engram",
64
+ "args": ["mcp"],
65
+ "env": {
66
+ "ENGRAM_PROJECT": "mi-proyecto"
67
+ }
68
+ }
69
+ }
70
+ }
71
+ ```
72
+
73
+ ### OpenCode
74
+
75
+ Engram incluye un plugin nativo para OpenCode:
76
+
77
+ ```bash
78
+ # Copiar plugin
79
+ cp $(which engram)/../plugin/opencode/engram.ts ~/.opencode/plugins/
80
+ ```
81
+
82
+ ## Herramientas MCP Disponibles
83
+
84
+ Engram expone 10 herramientas via MCP:
85
+
86
+ | Herramienta | Descripcion |
87
+ |-------------|-------------|
88
+ | `mem_search` | Buscar memorias por texto (FTS5) |
89
+ | `mem_save` | Guardar observacion (bugfix, decision, patron) |
90
+ | `mem_get_observation` | Obtener contenido completo de una observacion |
91
+ | `mem_timeline` | Timeline cronologico alrededor de resultados |
92
+ | `mem_session_start` | Iniciar sesion de trabajo |
93
+ | `mem_session_end` | Finalizar sesion con resumen |
94
+ | `mem_session_list` | Listar sesiones recientes |
95
+ | `mem_stats` | Estadisticas de la base de memorias |
96
+ | `mem_search_sessions` | Buscar sesiones por texto |
97
+ | `mem_compact` | Compactar memorias antiguas |
98
+
99
+ ### Patron de Busqueda Progresiva
100
+
101
+ Engram usa un modelo de 3 capas para optimizar tokens:
102
+
103
+ 1. `mem_search` - Resultados compactos (titulo + tipo)
104
+ 2. `mem_timeline` - Contexto cronologico
105
+ 3. `mem_get_observation` - Contenido completo sin truncar
106
+
107
+ ## Tipos de Observaciones
108
+
109
+ | Tipo | Cuando usar |
110
+ |------|------------|
111
+ | `decision` | Decisiones arquitecturales (ADRs) |
112
+ | `pattern` | Patrones de codigo recurrentes |
113
+ | `bugfix` | Bugs encontrados y sus soluciones |
114
+ | `convention` | Convenciones del proyecto |
115
+ | `learning` | Aprendizajes generales |
116
+
117
+ ## Uso con Obsidian Brain
118
+
119
+ Engram y obsidian-brain son complementarios:
120
+
121
+ ```
122
+ obsidian-brain (.project/Memory/) engram (SQLite)
123
+ ├── CONTEXT.md → Estado humano ├── Patterns → Patrones del agente
124
+ ├── KANBAN.md → Tareas visuales ├── Bugfixes → Soluciones automaticas
125
+ ├── DECISIONS.md → ADRs humanos ├── Decisions → Contexto del agente
126
+ └── BLOCKERS.md → Issues humanos └── Conventions → Reglas aprendidas
127
+ ```
128
+
129
+ Para instalar ambos, selecciona obsidian-brain (opcion 1) en init-project.sh y luego instala engram por separado con `install-engram.sh`.
130
+
131
+ ## Privacidad
132
+
133
+ Engram incluye proteccion de privacidad en dos niveles:
134
+ - Tags `<private>` se eliminan antes de transmision HTTP
135
+ - En la capa de almacenamiento, contenido privado se reemplaza con `[REDACTED]`
136
+
137
+ ## Sincronizacion con Git
138
+
139
+ Engram soporta sincronizar memorias via Git (para equipos):
140
+
141
+ ```bash
142
+ engram sync push # Exportar memorias
143
+ engram sync pull # Importar memorias del equipo
144
+ ```
145
+
146
+ Las memorias se exportan como JSONL comprimido con gzip.