nexo-brain 2.0.0 → 2.2.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 (370) hide show
  1. package/README.md +143 -44
  2. package/bin/nexo-brain.js +53 -26
  3. package/package.json +15 -3
  4. package/scripts/migrate-to-unified 2.sh +813 -0
  5. package/scripts/migrate-v1.5-to-v1.6 2.py +778 -0
  6. package/scripts/migrate-v1.7-to-v1.8 2.py +214 -0
  7. package/scripts/pre-commit-check 2.sh +55 -0
  8. package/src/__pycache__/auto_update.cpython-310.pyc +0 -0
  9. package/src/__pycache__/hnsw_index.cpython-310.pyc +0 -0
  10. package/src/__pycache__/kg_populate.cpython-310.pyc +0 -0
  11. package/src/__pycache__/knowledge_graph.cpython-310.pyc +0 -0
  12. package/src/__pycache__/plugin_loader.cpython-310.pyc +0 -0
  13. package/src/__pycache__/tools_coordination.cpython-310.pyc +0 -0
  14. package/src/__pycache__/tools_credentials.cpython-310.pyc +0 -0
  15. package/src/__pycache__/tools_learnings.cpython-310.pyc +0 -0
  16. package/src/__pycache__/tools_menu.cpython-310.pyc +0 -0
  17. package/src/__pycache__/tools_reminders.cpython-310.pyc +0 -0
  18. package/src/__pycache__/tools_reminders_crud.cpython-310.pyc +0 -0
  19. package/src/__pycache__/tools_sessions.cpython-310.pyc +0 -0
  20. package/src/__pycache__/tools_task_history.cpython-310.pyc +0 -0
  21. package/src/auto_close_sessions 2.py +159 -0
  22. package/src/auto_update 2.py +634 -0
  23. package/src/claim_graph 2.py +323 -0
  24. package/src/cognitive/__init__ 2.py +62 -0
  25. package/src/cognitive/__pycache__/__init__.cpython-310.pyc +0 -0
  26. package/src/cognitive/__pycache__/_core.cpython-310.pyc +0 -0
  27. package/src/cognitive/__pycache__/_decay.cpython-310.pyc +0 -0
  28. package/src/cognitive/__pycache__/_ingest.cpython-310.pyc +0 -0
  29. package/src/cognitive/__pycache__/_memory.cpython-310.pyc +0 -0
  30. package/src/cognitive/__pycache__/_search.cpython-310.pyc +0 -0
  31. package/src/cognitive/__pycache__/_trust.cpython-310.pyc +0 -0
  32. package/src/cognitive/_core 2.py +567 -0
  33. package/src/cognitive/_decay 2.py +382 -0
  34. package/src/cognitive/_ingest 2.py +892 -0
  35. package/src/cognitive/_memory 2.py +912 -0
  36. package/src/cognitive/_search 2.py +949 -0
  37. package/src/cognitive/_trust 2.py +464 -0
  38. package/src/cognitive/_trust.py +10 -36
  39. package/src/crons/manifest 2.json +106 -0
  40. package/src/crons/manifest.json +106 -0
  41. package/src/crons/sync 2.py +217 -0
  42. package/src/crons/sync.py +217 -0
  43. package/src/dashboard/__init__ 2.py +0 -0
  44. package/src/dashboard/__pycache__/__init__.cpython-310.pyc +0 -0
  45. package/src/dashboard/__pycache__/app.cpython-310.pyc +0 -0
  46. package/src/dashboard/app 2.py +789 -0
  47. package/src/dashboard/app.py +16 -2
  48. package/src/dashboard/templates/dashboard.html +3 -2
  49. package/src/db/__init__ 2.py +89 -0
  50. package/src/db/__pycache__/__init__.cpython-310.pyc +0 -0
  51. package/src/db/__pycache__/__init__.cpython-312.pyc +0 -0
  52. package/src/db/__pycache__/__init__.cpython-314.pyc +0 -0
  53. package/src/db/__pycache__/_core.cpython-310.pyc +0 -0
  54. package/src/db/__pycache__/_core.cpython-312.pyc +0 -0
  55. package/src/db/__pycache__/_core.cpython-314.pyc +0 -0
  56. package/src/db/__pycache__/_credentials.cpython-310.pyc +0 -0
  57. package/src/db/__pycache__/_credentials.cpython-312.pyc +0 -0
  58. package/src/db/__pycache__/_credentials.cpython-314.pyc +0 -0
  59. package/src/db/__pycache__/_entities.cpython-310.pyc +0 -0
  60. package/src/db/__pycache__/_entities.cpython-312.pyc +0 -0
  61. package/src/db/__pycache__/_entities.cpython-314.pyc +0 -0
  62. package/src/db/__pycache__/_episodic.cpython-310.pyc +0 -0
  63. package/src/db/__pycache__/_episodic.cpython-312.pyc +0 -0
  64. package/src/db/__pycache__/_episodic.cpython-314.pyc +0 -0
  65. package/src/db/__pycache__/_evolution.cpython-310.pyc +0 -0
  66. package/src/db/__pycache__/_evolution.cpython-312.pyc +0 -0
  67. package/src/db/__pycache__/_evolution.cpython-314.pyc +0 -0
  68. package/src/db/__pycache__/_fts.cpython-310.pyc +0 -0
  69. package/src/db/__pycache__/_fts.cpython-312.pyc +0 -0
  70. package/src/db/__pycache__/_fts.cpython-314.pyc +0 -0
  71. package/src/db/__pycache__/_learnings.cpython-310.pyc +0 -0
  72. package/src/db/__pycache__/_learnings.cpython-312.pyc +0 -0
  73. package/src/db/__pycache__/_learnings.cpython-314.pyc +0 -0
  74. package/src/db/__pycache__/_reminders.cpython-310.pyc +0 -0
  75. package/src/db/__pycache__/_reminders.cpython-312.pyc +0 -0
  76. package/src/db/__pycache__/_reminders.cpython-314.pyc +0 -0
  77. package/src/db/__pycache__/_schema.cpython-310.pyc +0 -0
  78. package/src/db/__pycache__/_schema.cpython-312.pyc +0 -0
  79. package/src/db/__pycache__/_schema.cpython-314.pyc +0 -0
  80. package/src/db/__pycache__/_sessions.cpython-310.pyc +0 -0
  81. package/src/db/__pycache__/_sessions.cpython-312.pyc +0 -0
  82. package/src/db/__pycache__/_sessions.cpython-314.pyc +0 -0
  83. package/src/db/__pycache__/_tasks.cpython-310.pyc +0 -0
  84. package/src/db/__pycache__/_tasks.cpython-312.pyc +0 -0
  85. package/src/db/__pycache__/_tasks.cpython-314.pyc +0 -0
  86. package/src/db/_core 2.py +417 -0
  87. package/src/db/_credentials 2.py +124 -0
  88. package/src/db/_entities 2.py +178 -0
  89. package/src/db/_episodic 2.py +738 -0
  90. package/src/db/_episodic.py +1 -1
  91. package/src/db/_evolution 2.py +54 -0
  92. package/src/db/_fts 2.py +406 -0
  93. package/src/db/_learnings 2.py +168 -0
  94. package/src/db/_reminders 2.py +338 -0
  95. package/src/db/_reminders.py +9 -5
  96. package/src/db/_schema 2.py +364 -0
  97. package/src/db/_sessions 2.py +300 -0
  98. package/src/db/_tasks 2.py +91 -0
  99. package/src/evolution_cycle 2.py +266 -0
  100. package/src/hnsw_index 2.py +254 -0
  101. package/src/hooks/auto_capture 2.py +208 -0
  102. package/src/hooks/caffeinate-guard 2.sh +8 -0
  103. package/src/hooks/capture-session 2.sh +21 -0
  104. package/src/hooks/capture-session.sh +2 -0
  105. package/src/hooks/capture-tool-logs 2.sh +127 -0
  106. package/src/hooks/capture-tool-logs.sh +3 -2
  107. package/src/hooks/daily-briefing-check 2.sh +33 -0
  108. package/src/hooks/inbox-hook 2.sh +76 -0
  109. package/src/hooks/inbox-hook.sh +3 -2
  110. package/src/hooks/post-compact 2.sh +148 -0
  111. package/src/hooks/post-compact.sh +1 -1
  112. package/src/hooks/pre-compact 2.sh +151 -0
  113. package/src/hooks/pre-compact.sh +1 -1
  114. package/src/hooks/session-start 2.sh +268 -0
  115. package/src/hooks/session-start.sh +6 -3
  116. package/src/hooks/session-stop 2.sh +140 -0
  117. package/src/hooks/session-stop.sh +3 -2
  118. package/src/kg_populate 2.py +290 -0
  119. package/src/knowledge_graph 2.py +257 -0
  120. package/src/maintenance 2.py +59 -0
  121. package/src/migrate_embeddings 2.py +122 -0
  122. package/src/plugin_loader 2.py +202 -0
  123. package/src/plugins/__init__ 2.py +0 -0
  124. package/src/plugins/__pycache__/__init__ 2.cpython-310.pyc +0 -0
  125. package/src/plugins/__pycache__/__init__.cpython-310.pyc +0 -0
  126. package/src/plugins/__pycache__/adaptive_mode 2.cpython-310.pyc +0 -0
  127. package/src/plugins/__pycache__/adaptive_mode.cpython-310.pyc +0 -0
  128. package/src/plugins/__pycache__/agents 2.cpython-310.pyc +0 -0
  129. package/src/plugins/__pycache__/agents.cpython-310.pyc +0 -0
  130. package/src/plugins/__pycache__/artifact_registry 2.cpython-310.pyc +0 -0
  131. package/src/plugins/__pycache__/artifact_registry.cpython-310.pyc +0 -0
  132. package/src/plugins/__pycache__/backup 2.cpython-310.pyc +0 -0
  133. package/src/plugins/__pycache__/backup.cpython-310.pyc +0 -0
  134. package/src/plugins/__pycache__/cognitive_memory 2.cpython-310.pyc +0 -0
  135. package/src/plugins/__pycache__/cognitive_memory.cpython-310.pyc +0 -0
  136. package/src/plugins/__pycache__/core_rules 2.cpython-310.pyc +0 -0
  137. package/src/plugins/__pycache__/core_rules.cpython-310.pyc +0 -0
  138. package/src/plugins/__pycache__/cortex 2.cpython-310.pyc +0 -0
  139. package/src/plugins/__pycache__/cortex.cpython-310.pyc +0 -0
  140. package/src/plugins/__pycache__/entities 2.cpython-310.pyc +0 -0
  141. package/src/plugins/__pycache__/entities.cpython-310.pyc +0 -0
  142. package/src/plugins/__pycache__/episodic_memory 2.cpython-310.pyc +0 -0
  143. package/src/plugins/__pycache__/episodic_memory.cpython-310.pyc +0 -0
  144. package/src/plugins/__pycache__/evolution 2.cpython-310.pyc +0 -0
  145. package/src/plugins/__pycache__/evolution.cpython-310.pyc +0 -0
  146. package/src/plugins/__pycache__/guard 2.cpython-310.pyc +0 -0
  147. package/src/plugins/__pycache__/guard.cpython-310.pyc +0 -0
  148. package/src/plugins/__pycache__/knowledge_graph_tools 2.cpython-310.pyc +0 -0
  149. package/src/plugins/__pycache__/knowledge_graph_tools.cpython-310.pyc +0 -0
  150. package/src/plugins/__pycache__/preferences 2.cpython-310.pyc +0 -0
  151. package/src/plugins/__pycache__/preferences.cpython-310.pyc +0 -0
  152. package/src/plugins/__pycache__/update 2.cpython-310.pyc +0 -0
  153. package/src/plugins/__pycache__/update.cpython-310.pyc +0 -0
  154. package/src/plugins/adaptive_mode 2.py +805 -0
  155. package/src/plugins/agents 2.py +52 -0
  156. package/src/plugins/artifact_registry 2.py +450 -0
  157. package/src/plugins/backup 2.py +104 -0
  158. package/src/plugins/cognitive_memory 2.py +564 -0
  159. package/src/plugins/core_rules 2.py +252 -0
  160. package/src/plugins/core_rules.py +34 -17
  161. package/src/plugins/cortex 2.py +299 -0
  162. package/src/plugins/entities 2.py +67 -0
  163. package/src/plugins/episodic_memory 2.py +533 -0
  164. package/src/plugins/evolution 2.py +115 -0
  165. package/src/plugins/guard 2.py +746 -0
  166. package/src/plugins/knowledge_graph_tools 2.py +105 -0
  167. package/src/plugins/preferences 2.py +47 -0
  168. package/src/plugins/update 2.py +256 -0
  169. package/src/plugins/update.py +18 -0
  170. package/src/requirements 2.txt +12 -0
  171. package/src/rules/__init__ 2.py +0 -0
  172. package/src/rules/core-rules 2.json +331 -0
  173. package/src/rules/migrate 2.py +207 -0
  174. package/src/scripts/check-context 2.py +264 -0
  175. package/src/scripts/check-context.py +4 -7
  176. package/src/scripts/deep-sleep/apply_findings.py +570 -167
  177. package/src/scripts/deep-sleep/collect.py +480 -0
  178. package/src/scripts/deep-sleep/extract-prompt.md +233 -0
  179. package/src/scripts/deep-sleep/extract.py +249 -0
  180. package/src/scripts/deep-sleep/synthesize-prompt.md +197 -0
  181. package/src/scripts/deep-sleep/synthesize.py +191 -0
  182. package/src/scripts/nexo-auto-update 2.py +6 -0
  183. package/src/scripts/nexo-backup 2.sh +25 -0
  184. package/src/scripts/nexo-brain-activation 2.sh +140 -0
  185. package/src/scripts/nexo-catchup 2.py +242 -0
  186. package/src/scripts/nexo-catchup.py +5 -8
  187. package/src/scripts/nexo-cognitive-decay 2.py +182 -0
  188. package/src/scripts/nexo-daily-self-audit 2.py +552 -0
  189. package/src/scripts/nexo-daily-self-audit.py +28 -19
  190. package/src/scripts/nexo-deep-sleep 2.sh +97 -0
  191. package/src/scripts/nexo-deep-sleep.sh +31 -16
  192. package/src/scripts/nexo-evolution-run 2.py +597 -0
  193. package/src/scripts/nexo-evolution-run.py +5 -20
  194. package/src/scripts/nexo-followup-hygiene 2.py +112 -0
  195. package/src/scripts/nexo-followup-hygiene.py +4 -2
  196. package/src/scripts/nexo-github-monitor 2.py +256 -0
  197. package/src/scripts/nexo-github-monitor.py +6 -9
  198. package/src/scripts/nexo-immune 2.py +927 -0
  199. package/src/scripts/nexo-immune.py +4 -17
  200. package/src/scripts/nexo-inbox-hook 2.sh +74 -0
  201. package/src/scripts/nexo-install 2.py +6 -0
  202. package/src/scripts/nexo-learning-housekeep 2.py +245 -0
  203. package/src/scripts/nexo-learning-validator 2.py +207 -0
  204. package/src/scripts/nexo-learning-validator.py +0 -29
  205. package/src/scripts/nexo-migrate 2.py +232 -0
  206. package/src/scripts/nexo-postmortem-consolidator 2.py +421 -0
  207. package/src/scripts/nexo-postmortem-consolidator.py +9 -20
  208. package/src/scripts/nexo-pre-commit 2.py +120 -0
  209. package/src/scripts/nexo-prevent-sleep 2.sh +29 -0
  210. package/src/scripts/nexo-proactive-dashboard 2.py +345 -0
  211. package/src/scripts/nexo-proactive-dashboard.py +1 -0
  212. package/src/scripts/nexo-reflection 2.py +253 -0
  213. package/src/scripts/nexo-runtime-preflight 2.py +274 -0
  214. package/src/scripts/nexo-send-email 2.py +25 -0
  215. package/src/scripts/nexo-send-reply 2.py +178 -0
  216. package/src/scripts/nexo-sleep 2.py +592 -0
  217. package/src/scripts/nexo-sleep.py +8 -18
  218. package/src/scripts/nexo-snapshot-restore 2.sh +35 -0
  219. package/src/scripts/nexo-synthesis 2.py +253 -0
  220. package/src/scripts/nexo-synthesis.py +8 -19
  221. package/src/scripts/nexo-tcc-approve 2.sh +79 -0
  222. package/src/scripts/nexo-update 2.sh +161 -0
  223. package/src/scripts/nexo-watchdog 2.sh +878 -0
  224. package/src/scripts/nexo-watchdog-smoke 2.py +119 -0
  225. package/src/server 2.py +733 -0
  226. package/src/server.py +6 -1
  227. package/src/storage_router 2.py +32 -0
  228. package/src/tools_coordination 2.py +102 -0
  229. package/src/tools_credentials 2.py +68 -0
  230. package/src/tools_learnings 2.py +220 -0
  231. package/src/tools_menu 2.py +227 -0
  232. package/src/tools_menu.py +1 -1
  233. package/src/tools_reminders 2.py +86 -0
  234. package/src/tools_reminders_crud 2.py +159 -0
  235. package/src/tools_reminders_crud.py +7 -0
  236. package/src/tools_sessions 2.py +476 -0
  237. package/src/tools_sessions.py +67 -0
  238. package/src/tools_task_history 2.py +57 -0
  239. package/templates/CLAUDE.md 2.template +63 -0
  240. package/templates/openclaw 2.json +13 -0
  241. package/tests/__init__ 2.py +0 -0
  242. package/tests/conftest 2.py +71 -0
  243. package/tests/test_cognitive 2.py +205 -0
  244. package/tests/test_knowledge_graph 2.py +140 -0
  245. package/tests/test_migrations 2.py +137 -0
  246. package/src/__pycache__/auto_close_sessions.cpython-310.pyc +0 -0
  247. package/src/__pycache__/auto_close_sessions.cpython-314.pyc +0 -0
  248. package/src/__pycache__/auto_update.cpython-314.pyc +0 -0
  249. package/src/__pycache__/claim_graph.cpython-310.pyc +0 -0
  250. package/src/__pycache__/claim_graph.cpython-314.pyc +0 -0
  251. package/src/__pycache__/evolution_cycle.cpython-310.pyc +0 -0
  252. package/src/__pycache__/evolution_cycle.cpython-314.pyc +0 -0
  253. package/src/__pycache__/hnsw_index.cpython-314.pyc +0 -0
  254. package/src/__pycache__/kg_populate.cpython-314.pyc +0 -0
  255. package/src/__pycache__/knowledge_graph.cpython-314.pyc +0 -0
  256. package/src/__pycache__/maintenance.cpython-310.pyc +0 -0
  257. package/src/__pycache__/maintenance.cpython-314.pyc +0 -0
  258. package/src/__pycache__/migrate_embeddings.cpython-310.pyc +0 -0
  259. package/src/__pycache__/migrate_embeddings.cpython-314.pyc +0 -0
  260. package/src/__pycache__/plugin_loader.cpython-314.pyc +0 -0
  261. package/src/__pycache__/server.cpython-310.pyc +0 -0
  262. package/src/__pycache__/server.cpython-314.pyc +0 -0
  263. package/src/__pycache__/storage_router.cpython-310.pyc +0 -0
  264. package/src/__pycache__/storage_router.cpython-314.pyc +0 -0
  265. package/src/__pycache__/tools_coordination.cpython-314.pyc +0 -0
  266. package/src/__pycache__/tools_credentials.cpython-314.pyc +0 -0
  267. package/src/__pycache__/tools_learnings.cpython-314.pyc +0 -0
  268. package/src/__pycache__/tools_menu.cpython-314.pyc +0 -0
  269. package/src/__pycache__/tools_reminders.cpython-314.pyc +0 -0
  270. package/src/__pycache__/tools_reminders_crud.cpython-314.pyc +0 -0
  271. package/src/__pycache__/tools_sessions.cpython-314.pyc +0 -0
  272. package/src/__pycache__/tools_task_history.cpython-314.pyc +0 -0
  273. package/src/cognitive/__pycache__/__init__.cpython-314.pyc +0 -0
  274. package/src/cognitive/__pycache__/_core.cpython-314.pyc +0 -0
  275. package/src/cognitive/__pycache__/_decay.cpython-314.pyc +0 -0
  276. package/src/cognitive/__pycache__/_ingest.cpython-314.pyc +0 -0
  277. package/src/cognitive/__pycache__/_memory.cpython-314.pyc +0 -0
  278. package/src/cognitive/__pycache__/_search.cpython-314.pyc +0 -0
  279. package/src/cognitive/__pycache__/_trust.cpython-314.pyc +0 -0
  280. package/src/dashboard/__pycache__/__init__.cpython-314.pyc +0 -0
  281. package/src/dashboard/__pycache__/app.cpython-314.pyc +0 -0
  282. package/src/hooks/__pycache__/auto_capture.cpython-310.pyc +0 -0
  283. package/src/hooks/__pycache__/auto_capture.cpython-314.pyc +0 -0
  284. package/src/plugins/__pycache__/__init__.cpython-314.pyc +0 -0
  285. package/src/plugins/__pycache__/adaptive_mode.cpython-314.pyc +0 -0
  286. package/src/plugins/__pycache__/agents.cpython-314.pyc +0 -0
  287. package/src/plugins/__pycache__/artifact_registry.cpython-314.pyc +0 -0
  288. package/src/plugins/__pycache__/backup.cpython-314.pyc +0 -0
  289. package/src/plugins/__pycache__/cognitive_memory.cpython-314.pyc +0 -0
  290. package/src/plugins/__pycache__/core_rules.cpython-314.pyc +0 -0
  291. package/src/plugins/__pycache__/cortex.cpython-314.pyc +0 -0
  292. package/src/plugins/__pycache__/entities.cpython-314.pyc +0 -0
  293. package/src/plugins/__pycache__/episodic_memory.cpython-314.pyc +0 -0
  294. package/src/plugins/__pycache__/evolution.cpython-314.pyc +0 -0
  295. package/src/plugins/__pycache__/guard.cpython-314.pyc +0 -0
  296. package/src/plugins/__pycache__/knowledge_graph_tools.cpython-314.pyc +0 -0
  297. package/src/plugins/__pycache__/preferences.cpython-314.pyc +0 -0
  298. package/src/rules/__pycache__/__init__.cpython-310.pyc +0 -0
  299. package/src/rules/__pycache__/__init__.cpython-314.pyc +0 -0
  300. package/src/rules/__pycache__/migrate.cpython-310.pyc +0 -0
  301. package/src/rules/__pycache__/migrate.cpython-314.pyc +0 -0
  302. package/src/scripts/__pycache__/check-context.cpython-310.pyc +0 -0
  303. package/src/scripts/__pycache__/check-context.cpython-314.pyc +0 -0
  304. package/src/scripts/__pycache__/nexo-auto-update.cpython-310.pyc +0 -0
  305. package/src/scripts/__pycache__/nexo-auto-update.cpython-314.pyc +0 -0
  306. package/src/scripts/__pycache__/nexo-catchup.cpython-310.pyc +0 -0
  307. package/src/scripts/__pycache__/nexo-catchup.cpython-314.pyc +0 -0
  308. package/src/scripts/__pycache__/nexo-cognitive-decay.cpython-310.pyc +0 -0
  309. package/src/scripts/__pycache__/nexo-cognitive-decay.cpython-314.pyc +0 -0
  310. package/src/scripts/__pycache__/nexo-daily-self-audit.cpython-310.pyc +0 -0
  311. package/src/scripts/__pycache__/nexo-daily-self-audit.cpython-314.pyc +0 -0
  312. package/src/scripts/__pycache__/nexo-evolution-run.cpython-310.pyc +0 -0
  313. package/src/scripts/__pycache__/nexo-evolution-run.cpython-314.pyc +0 -0
  314. package/src/scripts/__pycache__/nexo-followup-hygiene.cpython-310.pyc +0 -0
  315. package/src/scripts/__pycache__/nexo-followup-hygiene.cpython-314.pyc +0 -0
  316. package/src/scripts/__pycache__/nexo-github-monitor.cpython-310.pyc +0 -0
  317. package/src/scripts/__pycache__/nexo-github-monitor.cpython-314.pyc +0 -0
  318. package/src/scripts/__pycache__/nexo-immune.cpython-310.pyc +0 -0
  319. package/src/scripts/__pycache__/nexo-immune.cpython-314.pyc +0 -0
  320. package/src/scripts/__pycache__/nexo-install.cpython-310.pyc +0 -0
  321. package/src/scripts/__pycache__/nexo-install.cpython-314.pyc +0 -0
  322. package/src/scripts/__pycache__/nexo-learning-housekeep.cpython-310.pyc +0 -0
  323. package/src/scripts/__pycache__/nexo-learning-housekeep.cpython-314.pyc +0 -0
  324. package/src/scripts/__pycache__/nexo-learning-validator.cpython-310.pyc +0 -0
  325. package/src/scripts/__pycache__/nexo-learning-validator.cpython-314.pyc +0 -0
  326. package/src/scripts/__pycache__/nexo-migrate.cpython-310.pyc +0 -0
  327. package/src/scripts/__pycache__/nexo-migrate.cpython-314.pyc +0 -0
  328. package/src/scripts/__pycache__/nexo-postmortem-consolidator.cpython-310.pyc +0 -0
  329. package/src/scripts/__pycache__/nexo-postmortem-consolidator.cpython-314.pyc +0 -0
  330. package/src/scripts/__pycache__/nexo-pre-commit.cpython-310.pyc +0 -0
  331. package/src/scripts/__pycache__/nexo-pre-commit.cpython-314.pyc +0 -0
  332. package/src/scripts/__pycache__/nexo-proactive-dashboard.cpython-310.pyc +0 -0
  333. package/src/scripts/__pycache__/nexo-proactive-dashboard.cpython-314.pyc +0 -0
  334. package/src/scripts/__pycache__/nexo-reflection.cpython-310.pyc +0 -0
  335. package/src/scripts/__pycache__/nexo-reflection.cpython-314.pyc +0 -0
  336. package/src/scripts/__pycache__/nexo-runtime-preflight.cpython-310.pyc +0 -0
  337. package/src/scripts/__pycache__/nexo-runtime-preflight.cpython-314.pyc +0 -0
  338. package/src/scripts/__pycache__/nexo-send-email.cpython-310.pyc +0 -0
  339. package/src/scripts/__pycache__/nexo-send-email.cpython-314.pyc +0 -0
  340. package/src/scripts/__pycache__/nexo-send-reply.cpython-310.pyc +0 -0
  341. package/src/scripts/__pycache__/nexo-send-reply.cpython-314.pyc +0 -0
  342. package/src/scripts/__pycache__/nexo-sleep.cpython-310.pyc +0 -0
  343. package/src/scripts/__pycache__/nexo-sleep.cpython-314.pyc +0 -0
  344. package/src/scripts/__pycache__/nexo-synthesis.cpython-310.pyc +0 -0
  345. package/src/scripts/__pycache__/nexo-synthesis.cpython-314.pyc +0 -0
  346. package/src/scripts/__pycache__/nexo-watchdog-smoke.cpython-310.pyc +0 -0
  347. package/src/scripts/__pycache__/nexo-watchdog-smoke.cpython-314.pyc +0 -0
  348. package/src/scripts/deep-sleep/__pycache__/analyze_session.cpython-310.pyc +0 -0
  349. package/src/scripts/deep-sleep/__pycache__/analyze_session.cpython-314.pyc +0 -0
  350. package/src/scripts/deep-sleep/__pycache__/apply_findings.cpython-310.pyc +0 -0
  351. package/src/scripts/deep-sleep/__pycache__/apply_findings.cpython-314.pyc +0 -0
  352. package/src/scripts/deep-sleep/__pycache__/collect_transcripts.cpython-310.pyc +0 -0
  353. package/src/scripts/deep-sleep/__pycache__/collect_transcripts.cpython-314.pyc +0 -0
  354. package/src/scripts/deep-sleep/analyze_session.py +0 -217
  355. package/src/scripts/deep-sleep/collect_transcripts.py +0 -145
  356. package/src/scripts/deep-sleep/prompt.md +0 -109
  357. package/tests/__pycache__/__init__.cpython-310.pyc +0 -0
  358. package/tests/__pycache__/__init__.cpython-314.pyc +0 -0
  359. package/tests/__pycache__/conftest.cpython-310-pytest-9.0.2.pyc +0 -0
  360. package/tests/__pycache__/conftest.cpython-310.pyc +0 -0
  361. package/tests/__pycache__/conftest.cpython-314-pytest-9.0.2.pyc +0 -0
  362. package/tests/__pycache__/test_cognitive.cpython-310-pytest-9.0.2.pyc +0 -0
  363. package/tests/__pycache__/test_cognitive.cpython-310.pyc +0 -0
  364. package/tests/__pycache__/test_cognitive.cpython-314-pytest-9.0.2.pyc +0 -0
  365. package/tests/__pycache__/test_knowledge_graph.cpython-310-pytest-9.0.2.pyc +0 -0
  366. package/tests/__pycache__/test_knowledge_graph.cpython-310.pyc +0 -0
  367. package/tests/__pycache__/test_knowledge_graph.cpython-314-pytest-9.0.2.pyc +0 -0
  368. package/tests/__pycache__/test_migrations.cpython-310-pytest-9.0.2.pyc +0 -0
  369. package/tests/__pycache__/test_migrations.cpython-310.pyc +0 -0
  370. package/tests/__pycache__/test_migrations.cpython-314-pytest-9.0.2.pyc +0 -0
@@ -0,0 +1,191 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Deep Sleep v2 -- Phase 3: Synthesize extractions into actionable findings.
4
+
5
+ One Claude call that reads all per-session extractions and produces a
6
+ unified synthesis with cross-session patterns, morning agenda, context
7
+ packets, and deduplicated actions.
8
+
9
+ Environment variables:
10
+ NEXO_HOME -- root of the NEXO installation (default: ~/.nexo)
11
+ """
12
+ import json
13
+ import os
14
+ import shutil
15
+ import subprocess
16
+ import sys
17
+ from datetime import datetime
18
+ from pathlib import Path
19
+
20
+ NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
21
+ DEEP_SLEEP_DIR = NEXO_HOME / "operations" / "deep-sleep"
22
+ PROMPT_FILE = Path(__file__).parent / "synthesize-prompt.md"
23
+
24
+ CLAUDE_TIMEOUT = 21600 # 3h safety net (prevents zombie processes)
25
+
26
+
27
+ def find_claude_cli() -> str:
28
+ """Find the Claude CLI binary."""
29
+ candidates = [
30
+ Path.home() / ".local" / "bin" / "claude",
31
+ Path("/usr/local/bin/claude"),
32
+ ]
33
+ for c in candidates:
34
+ if c.exists():
35
+ return str(c)
36
+ which = shutil.which("claude")
37
+ if which:
38
+ return which
39
+ return "claude"
40
+
41
+
42
+ def extract_json_from_response(text: str) -> dict | None:
43
+ """Parse JSON from Claude's response, handling markdown fences."""
44
+ text = text.strip()
45
+
46
+ if text.startswith("```"):
47
+ lines = text.split("\n")
48
+ end = len(lines)
49
+ for i in range(len(lines) - 1, 0, -1):
50
+ if lines[i].strip() == "```":
51
+ end = i
52
+ break
53
+ text = "\n".join(lines[1:end]).strip()
54
+
55
+ brace_start = text.find("{")
56
+ if brace_start < 0:
57
+ return None
58
+
59
+ depth = 0
60
+ for i in range(brace_start, len(text)):
61
+ if text[i] == "{":
62
+ depth += 1
63
+ elif text[i] == "}":
64
+ depth -= 1
65
+ if depth == 0:
66
+ try:
67
+ return json.loads(text[brace_start:i + 1])
68
+ except json.JSONDecodeError:
69
+ break
70
+ return None
71
+
72
+
73
+ def main():
74
+ target_date = sys.argv[1] if len(sys.argv) > 1 else datetime.now().strftime("%Y-%m-%d")
75
+
76
+ extractions_file = DEEP_SLEEP_DIR / f"{target_date}-extractions.json"
77
+ context_file = DEEP_SLEEP_DIR / f"{target_date}-context.txt"
78
+
79
+ if not extractions_file.exists():
80
+ print(f"[synthesize] No extractions file for {target_date}. Run extract.py first.")
81
+ sys.exit(1)
82
+
83
+ # Check if there are any findings worth synthesizing
84
+ with open(extractions_file) as f:
85
+ extractions = json.load(f)
86
+
87
+ total_findings = extractions.get("total_findings", 0)
88
+ if total_findings == 0:
89
+ print(f"[synthesize] No findings to synthesize for {target_date}.")
90
+ # Write minimal synthesis
91
+ output = {
92
+ "date": target_date,
93
+ "sessions_analyzed": extractions.get("sessions_analyzed", 0),
94
+ "cross_session_patterns": [],
95
+ "morning_agenda": [],
96
+ "context_packets": [],
97
+ "actions": [],
98
+ "summary": f"No significant findings for {target_date}."
99
+ }
100
+ output_file = DEEP_SLEEP_DIR / f"{target_date}-synthesis.json"
101
+ with open(output_file, "w") as f:
102
+ json.dump(output, f, indent=2, ensure_ascii=False)
103
+ print(f"[synthesize] Output: {output_file}")
104
+ return
105
+
106
+ # Build prompt
107
+ prompt_template = PROMPT_FILE.read_text()
108
+ prompt = prompt_template.replace("{{EXTRACTIONS_FILE}}", str(extractions_file))
109
+ prompt = prompt.replace("{{CONTEXT_FILE}}", str(context_file))
110
+
111
+ claude_bin = find_claude_cli()
112
+ print(f"[synthesize] Phase 3: Synthesizing {total_findings} findings from {target_date}")
113
+ print(f"[synthesize] Claude CLI: {claude_bin}")
114
+
115
+ try:
116
+ env = os.environ.copy()
117
+ env["NEXO_HEADLESS"] = "1" # Skip stop hook post-mortem
118
+
119
+ result = subprocess.run(
120
+ [
121
+ claude_bin,
122
+ "-p", prompt,
123
+ "--model", "opus",
124
+ "--output-format", "text",
125
+ "--allowedTools",
126
+ "Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__nexo_startup,mcp__nexo__nexo_learning_search,mcp__nexo__nexo_recall,mcp__nexo__nexo_reminders"
127
+ ],
128
+ capture_output=True,
129
+ text=True,
130
+ timeout=CLAUDE_TIMEOUT,
131
+ env=env
132
+ )
133
+
134
+ if result.returncode != 0:
135
+ print(f"[synthesize] Claude CLI error (exit {result.returncode}): {result.stderr[:300]}", file=sys.stderr)
136
+ sys.exit(1)
137
+
138
+ # Filter hook contamination
139
+ output_text = "\n".join(
140
+ l for l in result.stdout.strip().splitlines()
141
+ if not l.strip().startswith("Post-mortem")
142
+ )
143
+ parsed = extract_json_from_response(output_text)
144
+
145
+ # Fallback: Opus might have written the file directly via Write tool
146
+ if not parsed:
147
+ for candidate in [
148
+ DEEP_SLEEP_DIR / f"{target_date}-analysis.json",
149
+ DEEP_SLEEP_DIR / f"{target_date}-synthesis.json",
150
+ ]:
151
+ if candidate.exists() and candidate.stat().st_size > 100:
152
+ try:
153
+ parsed = json.load(open(candidate))
154
+ print(f"[synthesize] Opus wrote file directly: {candidate}")
155
+ break
156
+ except Exception:
157
+ continue
158
+
159
+ if not parsed:
160
+ debug_file = DEEP_SLEEP_DIR / f"debug-synthesize-{target_date}.txt"
161
+ debug_file.write_text(result.stdout[:10000])
162
+ print(f"[synthesize] Failed to parse JSON. Raw output saved to {debug_file}", file=sys.stderr)
163
+ sys.exit(1)
164
+
165
+ # Write synthesis output
166
+ output_file = DEEP_SLEEP_DIR / f"{target_date}-synthesis.json"
167
+ with open(output_file, "w") as f:
168
+ json.dump(parsed, f, indent=2, ensure_ascii=False)
169
+
170
+ n_actions = len(parsed.get("actions", []))
171
+ n_patterns = len(parsed.get("cross_session_patterns", []))
172
+ n_agenda = len(parsed.get("morning_agenda", []))
173
+ n_packets = len(parsed.get("context_packets", []))
174
+
175
+ print(f"[synthesize] Done.")
176
+ print(f" Actions: {n_actions}")
177
+ print(f" Cross-session patterns: {n_patterns}")
178
+ print(f" Morning agenda items: {n_agenda}")
179
+ print(f" Context packets: {n_packets}")
180
+ print(f"[synthesize] Output: {output_file}")
181
+
182
+ except subprocess.TimeoutExpired:
183
+ print(f"[synthesize] Claude CLI timeout ({CLAUDE_TIMEOUT}s)", file=sys.stderr)
184
+ sys.exit(1)
185
+ except FileNotFoundError:
186
+ print(f"[synthesize] Claude CLI not found at: {claude_bin}", file=sys.stderr)
187
+ sys.exit(1)
188
+
189
+
190
+ if __name__ == "__main__":
191
+ main()
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env python3
2
+ """DEPRECATED: Updates are handled automatically by NEXO on startup."""
3
+ import sys
4
+ print("This script is deprecated. NEXO auto-updates on startup.")
5
+ print("To update manually, use the nexo_update MCP tool.")
6
+ sys.exit(0)
@@ -0,0 +1,25 @@
1
+ #!/bin/bash
2
+ # NEXO DB hourly backup — crontab: 0 * * * * $NEXO_HOME/scripts/nexo-backup.sh
3
+ NEXO_HOME="${NEXO_HOME:-$HOME/.nexo}"
4
+ NEXO_DIR="$NEXO_HOME"
5
+ BACKUP_DIR="$NEXO_HOME/backups"
6
+ WEEKLY_DIR="$BACKUP_DIR/weekly"
7
+ DB="$NEXO_HOME/data/nexo.db"
8
+ RETENTION_HOURS=48
9
+
10
+ mkdir -p "$BACKUP_DIR" "$WEEKLY_DIR"
11
+
12
+ # Hourly backup
13
+ TIMESTAMP=$(date +%Y-%m-%d-%H%M)
14
+ sqlite3 "$DB" ".backup '$BACKUP_DIR/nexo-$TIMESTAMP.db'"
15
+
16
+ # Weekly backup — save one per week (Sundays)
17
+ WEEK=$(date +%Y-W%V)
18
+ WEEKLY_FILE="$WEEKLY_DIR/weekly-$WEEK.db"
19
+ if [ ! -f "$WEEKLY_FILE" ] && [ "$(date +%u)" = "7" ]; then
20
+ cp "$BACKUP_DIR/nexo-$TIMESTAMP.db" "$WEEKLY_FILE"
21
+ fi
22
+
23
+ # Cleanup: hourly >48h, weekly >90 days
24
+ find "$BACKUP_DIR" -maxdepth 1 -name "nexo-*.db" -mmin +$((RETENTION_HOURS * 60)) -delete
25
+ find "$WEEKLY_DIR" -name "weekly-*.db" -mtime +90 -delete
@@ -0,0 +1,140 @@
1
+ #!/usr/bin/env bash
2
+ # nexo-brain-activation.sh — NF24: Spontaneous Activation
3
+ # Reads user_model.json, detects significant shifts, and generates insights
4
+ # for NEXO startup. If nothing relevant: exit 0 with no output.
5
+
6
+ set -euo pipefail
7
+
8
+ BRAIN_DIR="~/.nexo/brain"
9
+ MODEL_FILE="$BRAIN_DIR/user_model.json"
10
+ SUMMARIES_DIR="$BRAIN_DIR/daily_summaries"
11
+
12
+ # --- Guard: required file ---
13
+ if [[ ! -f "$MODEL_FILE" ]]; then
14
+ exit 0
15
+ fi
16
+
17
+ # --- Inline Python to parse JSON and analyze ---
18
+ python3 - <<'PYEOF'
19
+ import json
20
+ import sys
21
+ import os
22
+ import glob
23
+ from datetime import datetime, timedelta
24
+
25
+ BRAIN_DIR = os.path.expanduser("~/.nexo/brain")
26
+ MODEL_FILE = os.path.join(BRAIN_DIR, "user_model.json")
27
+ SUMMARIES_DIR = os.path.join(BRAIN_DIR, "daily_summaries")
28
+
29
+ # ── Load model ──────────────────────────────────────────────────────────
30
+ try:
31
+ with open(MODEL_FILE) as f:
32
+ model = json.load(f)
33
+ except Exception:
34
+ sys.exit(0)
35
+
36
+ insights = []
37
+
38
+ # ── 1. Analyze evolution_log — last 3-5 entries ─────────────────────
39
+ evolution = model.get("evolution_log", [])
40
+ recent = evolution[-5:] if len(evolution) >= 5 else evolution
41
+
42
+ # Detect entries from the last 3 days
43
+ today = datetime.now().date()
44
+ cutoff = today - timedelta(days=3)
45
+
46
+ recent_obs = []
47
+ for entry in recent:
48
+ try:
49
+ entry_date = datetime.strptime(entry["date"], "%Y-%m-%d").date()
50
+ if entry_date >= cutoff:
51
+ recent_obs.append(entry)
52
+ except Exception:
53
+ pass
54
+
55
+ if recent_obs:
56
+ for obs in recent_obs[-2:]: # max 2 most recent
57
+ insights.append(obs["observation"].strip())
58
+
59
+ # ── 2. Detect trait changes >0.1 between entries (if history exists) ──
60
+ # The current model only has a snapshot; if in the future there is history
61
+ # in evolution_log with trait deltas, this can be expanded here.
62
+ # Detect the most extreme trait as the dominant identity signal.
63
+ traits = model.get("traits", {})
64
+ if traits:
65
+ dominant = max(traits, key=lambda k: traits[k])
66
+ dominant_val = traits[dominant]
67
+ weakest = min(traits, key=lambda k: traits[k])
68
+ weakest_val = traits[weakest]
69
+ # Only report if extreme (>0.9 or <0.2) to avoid noise
70
+ if dominant_val >= 0.9:
71
+ insights.append(f"Dominant trait: {dominant}={dominant_val} (highest recorded)")
72
+ if weakest_val <= 0.2:
73
+ insights.append(f"Lowest trait: {weakest}={weakest_val} (low tolerance active)")
74
+
75
+ # ── 3. Recent contradictions (last 3 days) ─────────────────────────
76
+ contradictions = model.get("contradictions", [])
77
+ recent_contradictions = []
78
+ for c in contradictions:
79
+ try:
80
+ c_date = datetime.strptime(c["date"], "%Y-%m-%d").date()
81
+ if c_date >= cutoff:
82
+ recent_contradictions.append(c)
83
+ except Exception:
84
+ pass
85
+
86
+ for c in recent_contradictions:
87
+ insights.append(f"Contradiction detected: {c['description'].strip()}")
88
+
89
+ # ── 4. Current active focus ─────────────────────────────────────────────────
90
+ current_focus = model.get("current_focus", [])
91
+ # Only include if there are focus items (and it's not initial startup)
92
+ if len(current_focus) > 0 and len(insights) == 0:
93
+ # If no other insights, report focus as minimum context
94
+ focus_str = ", ".join(current_focus)
95
+ insights.append(f"Current focus: {focus_str}")
96
+
97
+ # ── 5. Goals: active/dormant changes ─────────────────────────────────────
98
+ goals_active = model.get("goals_active", [])
99
+ goals_dormant = model.get("goals_dormant", [])
100
+ # If there are dormant goals, mention them (may need reactivation)
101
+ if goals_dormant:
102
+ insights.append(f"Goal dormant: {goals_dormant[0]}")
103
+
104
+ # ── Read last daily summary ─────────────────────────────────────────────
105
+ summary_text = ""
106
+ try:
107
+ files = sorted(glob.glob(os.path.join(SUMMARIES_DIR, "*.md")))
108
+ if files:
109
+ with open(files[-1]) as f:
110
+ lines = [l.rstrip() for l in f.readlines() if l.strip()]
111
+ # Take up to 3 lines of content (exclude header)
112
+ content_lines = [l for l in lines if not l.startswith("# Resumen") and not l.startswith("# Summary")]
113
+ summary_text = " | ".join(content_lines[:3])
114
+ except Exception:
115
+ pass
116
+
117
+ # ── Output ────────────────────────────────────────────────────────────────
118
+ # If no real insights, exit without output
119
+ if not insights and not summary_text:
120
+ sys.exit(0)
121
+
122
+ # Deduplicate and limit
123
+ seen = set()
124
+ unique_insights = []
125
+ for ins in insights:
126
+ key = ins[:60]
127
+ if key not in seen:
128
+ seen.add(key)
129
+ unique_insights.append(ins)
130
+
131
+ if unique_insights:
132
+ print("BRAIN_INSIGHTS:")
133
+ for ins in unique_insights[:5]:
134
+ print(f"- {ins}")
135
+
136
+ if summary_text:
137
+ print("RECENT_SUMMARY:")
138
+ print(summary_text[:400])
139
+
140
+ PYEOF
@@ -0,0 +1,242 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ NEXO Catch-Up — Runs at Mac boot to execute any missed scheduled tasks.
4
+
5
+ When the Mac was asleep/off during scheduled times, launchd does NOT retry
6
+ missed StartCalendarInterval jobs. This script detects what was missed and
7
+ runs them in the correct order.
8
+
9
+ Scheduled tasks (ordered by intended run time):
10
+ 03:00 — cognitive-decay (Ebbinghaus decay + STM→LTM promotion)
11
+ 03:00 — evolution (weekly, Sundays only)
12
+ 04:00 — sleep (session cleanup)
13
+ 07:00 — self-audit (health checks + weekly cognitive GC on Sundays)
14
+ 23:30 — postmortem (consolidation + sensory register)
15
+
16
+ Logic: For each task, check if its last successful run was before the
17
+ most recent scheduled time. If so, run it now.
18
+ """
19
+
20
+ import json
21
+ import os
22
+ import subprocess
23
+ import sys
24
+ from datetime import datetime, timedelta
25
+ from pathlib import Path
26
+
27
+ CLAUDE_CLI = Path.home() / ".local" / "bin" / "claude"
28
+
29
+ HOME = Path.home()
30
+ NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
31
+ LOG_DIR = NEXO_HOME / "logs"
32
+ LOG_DIR.mkdir(parents=True, exist_ok=True)
33
+ LOG_FILE = LOG_DIR / "catchup.log"
34
+ STATE_FILE = NEXO_HOME / "operations" / ".catchup-state.json"
35
+
36
+ SCRIPTS = NEXO_HOME / "scripts"
37
+
38
+ # Resolve Python: prefer NEXO's venv, then the same Python running this script
39
+ def _resolve_python() -> str:
40
+ """Find the best Python to use for subprocess calls."""
41
+ # Check for NEXO_CODE env var pointing to the repo's src/
42
+ nexo_code = os.environ.get("NEXO_CODE", "")
43
+ if nexo_code:
44
+ venv_python = Path(nexo_code).parent / ".venv" / "bin" / "python"
45
+ if venv_python.exists():
46
+ return str(venv_python)
47
+ # Check for venv relative to NEXO_HOME
48
+ venv_python = NEXO_HOME / ".venv" / "bin" / "python"
49
+ if venv_python.exists():
50
+ return str(venv_python)
51
+ # Fall back to the same Python running this script
52
+ return sys.executable
53
+
54
+ NEXO_PYTHON = _resolve_python()
55
+
56
+
57
+ def log(msg: str):
58
+ ts = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
59
+ line = f"[{ts}] {msg}"
60
+ print(line, flush=True)
61
+ with open(LOG_FILE, "a") as f:
62
+ f.write(line + "\n")
63
+
64
+
65
+ def load_state() -> dict:
66
+ if STATE_FILE.exists():
67
+ try:
68
+ return json.loads(STATE_FILE.read_text())
69
+ except Exception:
70
+ pass
71
+ return {}
72
+
73
+
74
+ def save_state(state: dict):
75
+ STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
76
+ STATE_FILE.write_text(json.dumps(state, indent=2))
77
+
78
+
79
+ def last_scheduled_time(hour: int, minute: int, weekday: int = None) -> datetime:
80
+ """Calculate the most recent time this task should have run."""
81
+ now = datetime.now()
82
+ today_at = now.replace(hour=hour, minute=minute, second=0, microsecond=0)
83
+
84
+ if weekday is not None:
85
+ # Weekly task — find the most recent matching weekday
86
+ days_since = (now.weekday() - weekday) % 7
87
+ target = now - timedelta(days=days_since)
88
+ target = target.replace(hour=hour, minute=minute, second=0, microsecond=0)
89
+ if target > now:
90
+ target -= timedelta(weeks=1)
91
+ return target
92
+
93
+ # Daily task
94
+ if today_at <= now:
95
+ return today_at
96
+ else:
97
+ return today_at - timedelta(days=1)
98
+
99
+
100
+ def should_run(task_name: str, hour: int, minute: int, state: dict, weekday: int = None) -> bool:
101
+ """Check if task needs catch-up: last run was before last scheduled time."""
102
+ last_run_str = state.get(task_name)
103
+ last_scheduled = last_scheduled_time(hour, minute, weekday)
104
+
105
+ if not last_run_str:
106
+ # Never ran — should run
107
+ return True
108
+
109
+ try:
110
+ last_run = datetime.fromisoformat(last_run_str)
111
+ except ValueError:
112
+ return True
113
+
114
+ return last_run < last_scheduled
115
+
116
+
117
+ def run_task(name: str, python: str, script: str, state: dict) -> bool:
118
+ """Execute a task and update state."""
119
+ script_path = str(SCRIPTS / script)
120
+ if not Path(script_path).exists():
121
+ log(f" SKIP {name}: script not found ({script_path})")
122
+ return False
123
+
124
+ log(f" RUNNING {name}: {script}")
125
+ try:
126
+ result = subprocess.run(
127
+ [python, script_path],
128
+ capture_output=True, text=True, timeout=21600,
129
+ env={**os.environ, "HOME": str(HOME), "NEXO_CATCHUP": "1"}
130
+ )
131
+ if result.returncode == 0:
132
+ log(f" OK {name} (exit 0)")
133
+ else:
134
+ log(f" WARN {name} (exit {result.returncode})")
135
+ if result.stderr:
136
+ log(f" stderr: {result.stderr[:300]}")
137
+ state[name] = datetime.now().isoformat()
138
+ save_state(state)
139
+ return True
140
+ except subprocess.TimeoutExpired:
141
+ log(f" TIMEOUT {name} (300s)")
142
+ return False
143
+ except Exception as e:
144
+ log(f" ERROR {name}: {e}")
145
+ return False
146
+
147
+
148
+ def main():
149
+ log("=== NEXO Catch-Up starting (boot/wake) ===")
150
+ state = load_state()
151
+
152
+ # Define tasks in execution order (matching their intended schedule order)
153
+ # Note: auto-update is handled by the MCP server on startup, not by catchup.
154
+ tasks = [
155
+ # (name, hour, minute, python, script, weekday)
156
+ ("cognitive-decay", 3, 0, NEXO_PYTHON, "nexo-cognitive-decay.py", None),
157
+ ("evolution", 3, 0, NEXO_PYTHON, "nexo-evolution-run.py", 6), # Sunday = 6
158
+ ("sleep", 4, 0, NEXO_PYTHON, "nexo-sleep.py", None),
159
+ ("self-audit", 7, 0, NEXO_PYTHON, "nexo-daily-self-audit.py", None),
160
+ ("github-monitor", 8, 0, NEXO_PYTHON, "nexo-github-monitor.py", None),
161
+ ("postmortem", 23, 30, NEXO_PYTHON, "nexo-postmortem-consolidator.py", None),
162
+ ]
163
+
164
+ ran = 0
165
+ skipped = 0
166
+ for name, hour, minute, python, script, weekday in tasks:
167
+ if should_run(name, hour, minute, state, weekday):
168
+ log(f" {name} — missed scheduled run, catching up...")
169
+ if run_task(name, python, script, state):
170
+ ran += 1
171
+ else:
172
+ skipped += 1
173
+
174
+ if ran == 0:
175
+ log("All tasks up to date, nothing to catch up.")
176
+ elif ran >= 3:
177
+ # Many tasks caught up — ask CLI to assess system state
178
+ _cli_post_catchup_assessment(ran, skipped, state)
179
+ else:
180
+ log(f"Caught up {ran} tasks, {skipped} already current.")
181
+
182
+ log("=== Catch-Up complete ===")
183
+
184
+
185
+ def _cli_post_catchup_assessment(ran: int, skipped: int, state: dict):
186
+ """When 3+ tasks were missed, use CLI to assess if there are concerns."""
187
+ if not CLAUDE_CLI.exists():
188
+ log(f"Caught up {ran} tasks, {skipped} already current. (CLI unavailable for assessment)")
189
+ return
190
+ )
191
+ if auth_check.returncode != 0:
192
+ # CLI not authenticated, skip gracefully
193
+ print(f"[{datetime.now().strftime('%H:%M:%S')}] Claude CLI not authenticated. Skipping CLI analysis.")
194
+ return
195
+
196
+ assessment_file = LOG_DIR / "catchup-assessment.md"
197
+ state_summary = json.dumps(state, indent=2, default=str)
198
+
199
+ prompt = f"""You are the NEXO Catch-Up system. The Mac was off/asleep and {ran} scheduled tasks just ran as catch-up ({skipped} were already current).
200
+
201
+ Task run state (timestamps of last successful runs):
202
+ {state_summary}
203
+
204
+ Assess:
205
+ 1. How long was the system likely offline? (compare timestamps to now)
206
+ 2. Are there any tasks that depend on each other where order matters?
207
+ 3. Any tasks that may have produced stale results because they ran late?
208
+ 4. Should any task be re-run at its normal time today?
209
+
210
+ Write a brief assessment (max 20 lines) to: {assessment_file}
211
+
212
+ Format:
213
+ ## Catch-Up Assessment — {datetime.now().strftime('%Y-%m-%d %H:%M')}
214
+ - Offline duration: ~Xh
215
+ - Tasks caught up: {ran}
216
+ - Concerns: ...
217
+ - Recommendation: ..."""
218
+
219
+ log(f"Caught up {ran} tasks — running CLI assessment...")
220
+ env = os.environ.copy()
221
+ env["NEXO_HEADLESS"] = "1" # Skip stop hook post-mortem
222
+ env.pop("CLAUDECODE", None)
223
+ env.pop("CLAUDE_CODE", None)
224
+
225
+ try:
226
+ result = subprocess.run(
227
+ [str(CLAUDE_CLI), "-p", prompt, "--model", "opus", "--output-format", "text",
228
+ "--allowedTools", "Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*"],
229
+ capture_output=True, text=True, timeout=21600, env=env
230
+ )
231
+ if result.returncode == 0:
232
+ log(f"Assessment written to {assessment_file}")
233
+ else:
234
+ log(f"CLI assessment exited {result.returncode}")
235
+ except subprocess.TimeoutExpired:
236
+ log("CLI assessment timed out (90s)")
237
+ except Exception as e:
238
+ log(f"CLI assessment error: {e}")
239
+
240
+
241
+ if __name__ == "__main__":
242
+ main()
@@ -125,7 +125,7 @@ def run_task(name: str, python: str, script: str, state: dict) -> bool:
125
125
  try:
126
126
  result = subprocess.run(
127
127
  [python, script_path],
128
- capture_output=True, text=True, timeout=300,
128
+ capture_output=True, text=True, timeout=21600,
129
129
  env={**os.environ, "HOME": str(HOME), "NEXO_CATCHUP": "1"}
130
130
  )
131
131
  if result.returncode == 0:
@@ -187,10 +187,6 @@ def _cli_post_catchup_assessment(ran: int, skipped: int, state: dict):
187
187
  if not CLAUDE_CLI.exists():
188
188
  log(f"Caught up {ran} tasks, {skipped} already current. (CLI unavailable for assessment)")
189
189
  return
190
-
191
- auth_check = subprocess.run(
192
- [str(CLAUDE_CLI), "-p", "Reply with exactly: ok", "--bare", "--output-format", "text", "--model", "haiku"],
193
- capture_output=True, text=True, timeout=15
194
190
  )
195
191
  if auth_check.returncode != 0:
196
192
  # CLI not authenticated, skip gracefully
@@ -222,14 +218,15 @@ Format:
222
218
 
223
219
  log(f"Caught up {ran} tasks — running CLI assessment...")
224
220
  env = os.environ.copy()
221
+ env["NEXO_HEADLESS"] = "1" # Skip stop hook post-mortem
225
222
  env.pop("CLAUDECODE", None)
226
223
  env.pop("CLAUDE_CODE", None)
227
224
 
228
225
  try:
229
226
  result = subprocess.run(
230
- [str(CLAUDE_CLI), "-p", prompt, "--model", "opus", "--output-format", "text", "--bare",
231
- "--allowedTools", "Read,Write,Edit,Glob,Grep"],
232
- capture_output=True, text=True, timeout=90, env=env
227
+ [str(CLAUDE_CLI), "-p", prompt, "--model", "opus", "--output-format", "text",
228
+ "--allowedTools", "Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*"],
229
+ capture_output=True, text=True, timeout=21600, env=env
233
230
  )
234
231
  if result.returncode == 0:
235
232
  log(f"Assessment written to {assessment_file}")