nexo-brain 2.2.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (256) hide show
  1. package/README.md +5 -5
  2. package/package.json +6 -3
  3. package/src/auto_update.py +26 -0
  4. package/src/crons/manifest.json +6 -13
  5. package/src/crons/sync.py +150 -6
  6. package/src/db/__init__.py +13 -0
  7. package/src/db/_core.py +1 -0
  8. package/src/db/_cron_runs.py +74 -0
  9. package/src/db/_entities.py +1 -0
  10. package/src/db/_episodic.py +41 -6
  11. package/src/db/_learnings.py +1 -0
  12. package/src/db/_reminders.py +1 -0
  13. package/src/db/_schema.py +64 -0
  14. package/src/db/_sessions.py +1 -0
  15. package/src/db/_skills.py +515 -0
  16. package/src/hooks/session-stop.sh +13 -101
  17. package/src/plugin_loader.py +1 -0
  18. package/src/plugins/episodic_memory.py +5 -3
  19. package/src/plugins/schedule.py +212 -0
  20. package/src/plugins/skills.py +264 -0
  21. package/src/plugins/update.py +1 -0
  22. package/src/scripts/deep-sleep/apply_findings.py +111 -8
  23. package/src/scripts/deep-sleep/collect.py +34 -11
  24. package/src/scripts/deep-sleep/extract-prompt.md +38 -0
  25. package/src/scripts/deep-sleep/extract.py +81 -8
  26. package/src/scripts/deep-sleep/synthesize-prompt.md +29 -1
  27. package/src/scripts/deep-sleep/synthesize.py +4 -1
  28. package/src/scripts/nexo-catchup.py +65 -29
  29. package/src/scripts/nexo-cron-wrapper.sh +53 -0
  30. package/src/scripts/nexo-daily-self-audit.py +4 -2
  31. package/src/scripts/nexo-deep-sleep.sh +66 -77
  32. package/src/scripts/nexo-evolution-run.py +13 -0
  33. package/src/scripts/nexo-learning-housekeep.py +157 -1
  34. package/src/scripts/nexo-learning-validator.py +19 -0
  35. package/src/scripts/nexo-postmortem-consolidator.py +3 -2
  36. package/src/scripts/nexo-sleep.py +16 -11
  37. package/src/scripts/nexo-synthesis.py +46 -3
  38. package/src/scripts/nexo-watchdog.sh +91 -30
  39. package/src/server.py +6 -1
  40. package/src/tools_coordination.py +1 -0
  41. package/src/tools_sessions.py +1 -0
  42. package/scripts/migrate-to-unified 2.sh +0 -813
  43. package/scripts/migrate-to-unified.sh +0 -813
  44. package/scripts/migrate-v1.5-to-v1.6 2.py +0 -778
  45. package/scripts/migrate-v1.5-to-v1.6.py +0 -778
  46. package/scripts/migrate-v1.7-to-v1.8 2.py +0 -214
  47. package/scripts/migrate-v1.7-to-v1.8.py +0 -214
  48. package/scripts/pre-commit-check 2.sh +0 -55
  49. package/scripts/pre-commit-check.sh +0 -55
  50. package/src/__pycache__/auto_update.cpython-310.pyc +0 -0
  51. package/src/__pycache__/hnsw_index.cpython-310.pyc +0 -0
  52. package/src/__pycache__/kg_populate.cpython-310.pyc +0 -0
  53. package/src/__pycache__/knowledge_graph.cpython-310.pyc +0 -0
  54. package/src/__pycache__/plugin_loader.cpython-310.pyc +0 -0
  55. package/src/__pycache__/tools_coordination.cpython-310.pyc +0 -0
  56. package/src/__pycache__/tools_credentials.cpython-310.pyc +0 -0
  57. package/src/__pycache__/tools_learnings.cpython-310.pyc +0 -0
  58. package/src/__pycache__/tools_menu.cpython-310.pyc +0 -0
  59. package/src/__pycache__/tools_reminders.cpython-310.pyc +0 -0
  60. package/src/__pycache__/tools_reminders_crud.cpython-310.pyc +0 -0
  61. package/src/__pycache__/tools_sessions.cpython-310.pyc +0 -0
  62. package/src/__pycache__/tools_task_history.cpython-310.pyc +0 -0
  63. package/src/auto_close_sessions 2.py +0 -159
  64. package/src/auto_update 2.py +0 -634
  65. package/src/claim_graph 2.py +0 -323
  66. package/src/cognitive/__init__ 2.py +0 -62
  67. package/src/cognitive/__pycache__/__init__.cpython-310.pyc +0 -0
  68. package/src/cognitive/__pycache__/_core.cpython-310.pyc +0 -0
  69. package/src/cognitive/__pycache__/_decay.cpython-310.pyc +0 -0
  70. package/src/cognitive/__pycache__/_ingest.cpython-310.pyc +0 -0
  71. package/src/cognitive/__pycache__/_memory.cpython-310.pyc +0 -0
  72. package/src/cognitive/__pycache__/_search.cpython-310.pyc +0 -0
  73. package/src/cognitive/__pycache__/_trust.cpython-310.pyc +0 -0
  74. package/src/cognitive/_core 2.py +0 -567
  75. package/src/cognitive/_decay 2.py +0 -382
  76. package/src/cognitive/_ingest 2.py +0 -892
  77. package/src/cognitive/_memory 2.py +0 -912
  78. package/src/cognitive/_search 2.py +0 -949
  79. package/src/cognitive/_trust 2.py +0 -464
  80. package/src/crons/manifest 2.json +0 -106
  81. package/src/crons/sync 2.py +0 -217
  82. package/src/dashboard/__init__ 2.py +0 -0
  83. package/src/dashboard/__pycache__/__init__.cpython-310.pyc +0 -0
  84. package/src/dashboard/__pycache__/app.cpython-310.pyc +0 -0
  85. package/src/dashboard/app 2.py +0 -789
  86. package/src/db/__init__ 2.py +0 -89
  87. package/src/db/__pycache__/__init__.cpython-310.pyc +0 -0
  88. package/src/db/__pycache__/__init__.cpython-312.pyc +0 -0
  89. package/src/db/__pycache__/__init__.cpython-314.pyc +0 -0
  90. package/src/db/__pycache__/_core.cpython-310.pyc +0 -0
  91. package/src/db/__pycache__/_core.cpython-312.pyc +0 -0
  92. package/src/db/__pycache__/_core.cpython-314.pyc +0 -0
  93. package/src/db/__pycache__/_credentials.cpython-310.pyc +0 -0
  94. package/src/db/__pycache__/_credentials.cpython-312.pyc +0 -0
  95. package/src/db/__pycache__/_credentials.cpython-314.pyc +0 -0
  96. package/src/db/__pycache__/_entities.cpython-310.pyc +0 -0
  97. package/src/db/__pycache__/_entities.cpython-312.pyc +0 -0
  98. package/src/db/__pycache__/_entities.cpython-314.pyc +0 -0
  99. package/src/db/__pycache__/_episodic.cpython-310.pyc +0 -0
  100. package/src/db/__pycache__/_episodic.cpython-312.pyc +0 -0
  101. package/src/db/__pycache__/_episodic.cpython-314.pyc +0 -0
  102. package/src/db/__pycache__/_evolution.cpython-310.pyc +0 -0
  103. package/src/db/__pycache__/_evolution.cpython-312.pyc +0 -0
  104. package/src/db/__pycache__/_evolution.cpython-314.pyc +0 -0
  105. package/src/db/__pycache__/_fts.cpython-310.pyc +0 -0
  106. package/src/db/__pycache__/_fts.cpython-312.pyc +0 -0
  107. package/src/db/__pycache__/_fts.cpython-314.pyc +0 -0
  108. package/src/db/__pycache__/_learnings.cpython-310.pyc +0 -0
  109. package/src/db/__pycache__/_learnings.cpython-312.pyc +0 -0
  110. package/src/db/__pycache__/_learnings.cpython-314.pyc +0 -0
  111. package/src/db/__pycache__/_reminders.cpython-310.pyc +0 -0
  112. package/src/db/__pycache__/_reminders.cpython-312.pyc +0 -0
  113. package/src/db/__pycache__/_reminders.cpython-314.pyc +0 -0
  114. package/src/db/__pycache__/_schema.cpython-310.pyc +0 -0
  115. package/src/db/__pycache__/_schema.cpython-312.pyc +0 -0
  116. package/src/db/__pycache__/_schema.cpython-314.pyc +0 -0
  117. package/src/db/__pycache__/_sessions.cpython-310.pyc +0 -0
  118. package/src/db/__pycache__/_sessions.cpython-312.pyc +0 -0
  119. package/src/db/__pycache__/_sessions.cpython-314.pyc +0 -0
  120. package/src/db/__pycache__/_tasks.cpython-310.pyc +0 -0
  121. package/src/db/__pycache__/_tasks.cpython-312.pyc +0 -0
  122. package/src/db/__pycache__/_tasks.cpython-314.pyc +0 -0
  123. package/src/db/_core 2.py +0 -417
  124. package/src/db/_credentials 2.py +0 -124
  125. package/src/db/_entities 2.py +0 -178
  126. package/src/db/_episodic 2.py +0 -738
  127. package/src/db/_evolution 2.py +0 -54
  128. package/src/db/_fts 2.py +0 -406
  129. package/src/db/_learnings 2.py +0 -168
  130. package/src/db/_reminders 2.py +0 -338
  131. package/src/db/_schema 2.py +0 -364
  132. package/src/db/_sessions 2.py +0 -300
  133. package/src/db/_tasks 2.py +0 -91
  134. package/src/evolution_cycle 2.py +0 -266
  135. package/src/hnsw_index 2.py +0 -254
  136. package/src/hooks/auto_capture 2.py +0 -208
  137. package/src/hooks/caffeinate-guard 2.sh +0 -8
  138. package/src/hooks/capture-session 2.sh +0 -21
  139. package/src/hooks/capture-tool-logs 2.sh +0 -127
  140. package/src/hooks/daily-briefing-check 2.sh +0 -33
  141. package/src/hooks/inbox-hook 2.sh +0 -76
  142. package/src/hooks/post-compact 2.sh +0 -148
  143. package/src/hooks/pre-compact 2.sh +0 -151
  144. package/src/hooks/session-start 2.sh +0 -268
  145. package/src/hooks/session-stop 2.sh +0 -140
  146. package/src/kg_populate 2.py +0 -290
  147. package/src/knowledge_graph 2.py +0 -257
  148. package/src/maintenance 2.py +0 -59
  149. package/src/migrate_embeddings 2.py +0 -122
  150. package/src/plugin_loader 2.py +0 -202
  151. package/src/plugins/__init__ 2.py +0 -0
  152. package/src/plugins/__pycache__/__init__ 2.cpython-310.pyc +0 -0
  153. package/src/plugins/__pycache__/__init__.cpython-310.pyc +0 -0
  154. package/src/plugins/__pycache__/adaptive_mode 2.cpython-310.pyc +0 -0
  155. package/src/plugins/__pycache__/adaptive_mode.cpython-310.pyc +0 -0
  156. package/src/plugins/__pycache__/agents 2.cpython-310.pyc +0 -0
  157. package/src/plugins/__pycache__/agents.cpython-310.pyc +0 -0
  158. package/src/plugins/__pycache__/artifact_registry 2.cpython-310.pyc +0 -0
  159. package/src/plugins/__pycache__/artifact_registry.cpython-310.pyc +0 -0
  160. package/src/plugins/__pycache__/backup 2.cpython-310.pyc +0 -0
  161. package/src/plugins/__pycache__/backup.cpython-310.pyc +0 -0
  162. package/src/plugins/__pycache__/cognitive_memory 2.cpython-310.pyc +0 -0
  163. package/src/plugins/__pycache__/cognitive_memory.cpython-310.pyc +0 -0
  164. package/src/plugins/__pycache__/core_rules 2.cpython-310.pyc +0 -0
  165. package/src/plugins/__pycache__/core_rules.cpython-310.pyc +0 -0
  166. package/src/plugins/__pycache__/cortex 2.cpython-310.pyc +0 -0
  167. package/src/plugins/__pycache__/cortex.cpython-310.pyc +0 -0
  168. package/src/plugins/__pycache__/entities 2.cpython-310.pyc +0 -0
  169. package/src/plugins/__pycache__/entities.cpython-310.pyc +0 -0
  170. package/src/plugins/__pycache__/episodic_memory 2.cpython-310.pyc +0 -0
  171. package/src/plugins/__pycache__/episodic_memory.cpython-310.pyc +0 -0
  172. package/src/plugins/__pycache__/evolution 2.cpython-310.pyc +0 -0
  173. package/src/plugins/__pycache__/evolution.cpython-310.pyc +0 -0
  174. package/src/plugins/__pycache__/guard 2.cpython-310.pyc +0 -0
  175. package/src/plugins/__pycache__/guard.cpython-310.pyc +0 -0
  176. package/src/plugins/__pycache__/knowledge_graph_tools 2.cpython-310.pyc +0 -0
  177. package/src/plugins/__pycache__/knowledge_graph_tools.cpython-310.pyc +0 -0
  178. package/src/plugins/__pycache__/preferences 2.cpython-310.pyc +0 -0
  179. package/src/plugins/__pycache__/preferences.cpython-310.pyc +0 -0
  180. package/src/plugins/__pycache__/update 2.cpython-310.pyc +0 -0
  181. package/src/plugins/__pycache__/update.cpython-310.pyc +0 -0
  182. package/src/plugins/adaptive_mode 2.py +0 -805
  183. package/src/plugins/agents 2.py +0 -52
  184. package/src/plugins/artifact_registry 2.py +0 -450
  185. package/src/plugins/backup 2.py +0 -104
  186. package/src/plugins/cognitive_memory 2.py +0 -564
  187. package/src/plugins/core_rules 2.py +0 -252
  188. package/src/plugins/cortex 2.py +0 -299
  189. package/src/plugins/entities 2.py +0 -67
  190. package/src/plugins/episodic_memory 2.py +0 -533
  191. package/src/plugins/evolution 2.py +0 -115
  192. package/src/plugins/guard 2.py +0 -746
  193. package/src/plugins/knowledge_graph_tools 2.py +0 -105
  194. package/src/plugins/preferences 2.py +0 -47
  195. package/src/plugins/update 2.py +0 -256
  196. package/src/requirements 2.txt +0 -12
  197. package/src/rules/__init__ 2.py +0 -0
  198. package/src/rules/core-rules 2.json +0 -331
  199. package/src/rules/migrate 2.py +0 -207
  200. package/src/scripts/check-context 2.py +0 -264
  201. package/src/scripts/nexo-auto-update 2.py +0 -6
  202. package/src/scripts/nexo-backup 2.sh +0 -25
  203. package/src/scripts/nexo-brain-activation 2.sh +0 -140
  204. package/src/scripts/nexo-catchup 2.py +0 -242
  205. package/src/scripts/nexo-cognitive-decay 2.py +0 -182
  206. package/src/scripts/nexo-daily-self-audit 2.py +0 -552
  207. package/src/scripts/nexo-deep-sleep 2.sh +0 -97
  208. package/src/scripts/nexo-evolution-run 2.py +0 -597
  209. package/src/scripts/nexo-followup-hygiene 2.py +0 -112
  210. package/src/scripts/nexo-github-monitor 2.py +0 -256
  211. package/src/scripts/nexo-github-monitor.py +0 -256
  212. package/src/scripts/nexo-immune 2.py +0 -927
  213. package/src/scripts/nexo-inbox-hook 2.sh +0 -74
  214. package/src/scripts/nexo-install 2.py +0 -6
  215. package/src/scripts/nexo-learning-housekeep 2.py +0 -245
  216. package/src/scripts/nexo-learning-validator 2.py +0 -207
  217. package/src/scripts/nexo-migrate 2.py +0 -232
  218. package/src/scripts/nexo-postmortem-consolidator 2.py +0 -421
  219. package/src/scripts/nexo-pre-commit 2.py +0 -120
  220. package/src/scripts/nexo-prevent-sleep 2.sh +0 -29
  221. package/src/scripts/nexo-proactive-dashboard 2.py +0 -345
  222. package/src/scripts/nexo-reflection 2.py +0 -253
  223. package/src/scripts/nexo-runtime-preflight 2.py +0 -274
  224. package/src/scripts/nexo-send-email 2.py +0 -25
  225. package/src/scripts/nexo-send-email.py +0 -25
  226. package/src/scripts/nexo-send-reply 2.py +0 -178
  227. package/src/scripts/nexo-send-reply.py +0 -178
  228. package/src/scripts/nexo-sleep 2.py +0 -592
  229. package/src/scripts/nexo-snapshot-restore 2.sh +0 -35
  230. package/src/scripts/nexo-synthesis 2.py +0 -253
  231. package/src/scripts/nexo-tcc-approve 2.sh +0 -79
  232. package/src/scripts/nexo-update 2.sh +0 -161
  233. package/src/scripts/nexo-watchdog 2.sh +0 -878
  234. package/src/scripts/nexo-watchdog-smoke 2.py +0 -119
  235. package/src/server 2.py +0 -733
  236. package/src/storage_router 2.py +0 -32
  237. package/src/tools_coordination 2.py +0 -102
  238. package/src/tools_credentials 2.py +0 -68
  239. package/src/tools_learnings 2.py +0 -220
  240. package/src/tools_menu 2.py +0 -227
  241. package/src/tools_reminders 2.py +0 -86
  242. package/src/tools_reminders_crud 2.py +0 -159
  243. package/src/tools_sessions 2.py +0 -476
  244. package/src/tools_task_history 2.py +0 -57
  245. package/templates/CLAUDE.md 2.template +0 -63
  246. package/templates/openclaw 2.json +0 -13
  247. package/tests/__init__ 2.py +0 -0
  248. package/tests/__init__.py +0 -0
  249. package/tests/conftest 2.py +0 -71
  250. package/tests/conftest.py +0 -71
  251. package/tests/test_cognitive 2.py +0 -205
  252. package/tests/test_cognitive.py +0 -205
  253. package/tests/test_knowledge_graph 2.py +0 -140
  254. package/tests/test_knowledge_graph.py +0 -140
  255. package/tests/test_migrations 2.py +0 -137
  256. package/tests/test_migrations.py +0 -137
@@ -1,214 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- NEXO Migration Script: v1.7.x -> v1.8.0 (Hybrid Architecture)
4
-
5
- Migrates CLAUDE.md to the new hybrid architecture where:
6
- - CLAUDE.md = bootstrap (identity, profile, format, autonomy, project atlas)
7
- - MCP instructions field = tool-coupled behavioral rules
8
- - nexo_context_packet = on-demand area-specific context
9
-
10
- The MCP server now carries all tool-coupled rules in its `instructions` field,
11
- so CLAUDE.md no longer needs to duplicate them. This reduces CLAUDE.md from
12
- ~130 lines to ~50 lines, saving ~3K context tokens per session.
13
-
14
- Safe to run multiple times (idempotent). Creates a backup before modifying.
15
-
16
- Usage:
17
- python3 migrate-v1.7-to-v1.8.py [--dry-run] [--nexo-home /path/to/nexo]
18
- """
19
-
20
- import argparse
21
- import os
22
- import re
23
- import shutil
24
- import sys
25
- from datetime import datetime
26
-
27
-
28
- # Sections that are now in the MCP instructions field and should be REMOVED from CLAUDE.md
29
- MCP_OWNED_SECTIONS = [
30
- "Heartbeat",
31
- "Guard",
32
- "Delegation",
33
- "Reminders & Followups",
34
- "Reminders y Followups",
35
- "Memory",
36
- "Memoria",
37
- "Trust Score",
38
- "Adaptive Mode",
39
- "Dissonance",
40
- "Disonancia",
41
- "Observe the User",
42
- "Observar a Francisco", # legacy personal CLAUDE.md files
43
- "Observar al Usuario",
44
- "Change Log",
45
- "Session Diary",
46
- "Cortex",
47
- "Operational Codex",
48
- ]
49
-
50
- # Sections that STAY in CLAUDE.md (bootstrap layer)
51
- BOOTSTRAP_SECTIONS = [
52
- "Startup",
53
- "User Profile",
54
- "Francisco", # legacy personal CLAUDE.md files
55
- "Formato",
56
- "Format",
57
- "Autonomy",
58
- "Autonomía",
59
- "Project Atlas",
60
- "Atlas de Proyectos",
61
- "Hooks",
62
- "Menu",
63
- "Platforms",
64
- "Plataformas",
65
- "Repo",
66
- ]
67
-
68
-
69
- def find_nexo_home(override=None):
70
- if override:
71
- return override
72
- candidates = [
73
- os.path.expanduser("~/nexo"),
74
- os.path.expanduser("~/.nexo"),
75
- os.path.expanduser("~/claude/nexo-mcp"),
76
- ]
77
- for c in candidates:
78
- if os.path.isdir(c):
79
- return c
80
- return None
81
-
82
-
83
- def find_claude_md():
84
- """Find the CLAUDE.md file that contains NEXO instructions."""
85
- candidates = [
86
- os.path.expanduser("~/.claude/CLAUDE.md"),
87
- os.path.expanduser("~/CLAUDE.md"),
88
- ]
89
- for c in candidates:
90
- if os.path.isfile(c):
91
- return c
92
- return None
93
-
94
-
95
- def parse_sections(content):
96
- """Parse markdown into sections by ## headers."""
97
- sections = []
98
- current_header = None
99
- current_lines = []
100
-
101
- for line in content.split("\n"):
102
- if line.startswith("## "):
103
- if current_header is not None:
104
- sections.append((current_header, "\n".join(current_lines)))
105
- current_header = line[3:].strip()
106
- current_lines = [line]
107
- else:
108
- current_lines.append(line)
109
-
110
- if current_header is not None:
111
- sections.append((current_header, "\n".join(current_lines)))
112
- elif current_lines:
113
- sections.append(("_preamble", "\n".join(current_lines)))
114
-
115
- return sections
116
-
117
-
118
- def is_mcp_owned(header):
119
- """Check if a section header matches an MCP-owned section."""
120
- header_lower = header.lower()
121
- for section in MCP_OWNED_SECTIONS:
122
- if section.lower() in header_lower:
123
- return True
124
- return False
125
-
126
-
127
- def migrate_claude_md(path, dry_run=False):
128
- """Slim down CLAUDE.md by removing MCP-owned sections."""
129
- with open(path, "r") as f:
130
- content = f.read()
131
-
132
- original_lines = len(content.strip().split("\n"))
133
- sections = parse_sections(content)
134
-
135
- # Separate preamble, bootstrap, and MCP-owned sections
136
- preamble = ""
137
- kept = []
138
- removed = []
139
-
140
- for header, body in sections:
141
- if header == "_preamble":
142
- preamble = body
143
- elif is_mcp_owned(header):
144
- removed.append(header)
145
- else:
146
- kept.append((header, body))
147
-
148
- if not removed:
149
- print(" CLAUDE.md already migrated (no MCP-owned sections found).")
150
- return False
151
-
152
- # Add hybrid architecture note to preamble
153
- if "MCP instructions" not in preamble and "instructions" not in preamble:
154
- preamble = preamble.rstrip() + (
155
- "\nTool-coupled behavioral rules (heartbeat, guard, trust, memory, diary) "
156
- "now live in the MCP server instructions field and are injected automatically.\n"
157
- )
158
-
159
- # Reconstruct
160
- new_content = preamble + "\n"
161
- for header, body in kept:
162
- new_content += "\n" + body + "\n"
163
-
164
- new_lines = len(new_content.strip().split("\n"))
165
-
166
- print(f" Sections removed (now in MCP): {', '.join(removed)}")
167
- print(f" Lines: {original_lines} → {new_lines} (saved {original_lines - new_lines})")
168
-
169
- if dry_run:
170
- print(" [DRY RUN] No changes written.")
171
- return True
172
-
173
- # Backup
174
- backup = path + f".backup-{datetime.now().strftime(\"%Y%m%d-%H%M%S\")}"
175
- shutil.copy2(path, backup)
176
- print(f" Backup: {backup}")
177
-
178
- with open(path, "w") as f:
179
- f.write(new_content)
180
- print(" CLAUDE.md updated.")
181
- return True
182
-
183
-
184
- def main():
185
- parser = argparse.ArgumentParser(description="Migrate NEXO to v1.8 hybrid architecture")
186
- parser.add_argument("--dry-run", action="store_true", help="Show what would change without modifying files")
187
- parser.add_argument("--nexo-home", help="Override NEXO home directory")
188
- args = parser.parse_args()
189
-
190
- print("NEXO v1.7 → v1.8 Migration (Hybrid Architecture)")
191
- print("=" * 50)
192
- print()
193
-
194
- # Step 1: Find and migrate CLAUDE.md
195
- claude_md = find_claude_md()
196
- if claude_md:
197
- print(f"Found CLAUDE.md: {claude_md}")
198
- migrate_claude_md(claude_md, dry_run=args.dry_run)
199
- else:
200
- print("No CLAUDE.md found (skipping).")
201
-
202
- print()
203
- print("Migration complete.")
204
- print()
205
- print("What changed:")
206
- print(" - CLAUDE.md now contains only bootstrap (identity, format, autonomy)")
207
- print(" - Tool-coupled rules are in the MCP server instructions field")
208
- print(" - Context-specific rules load on-demand via nexo_context_packet")
209
- print()
210
- print("The MCP server must be restarted for instructions to take effect.")
211
-
212
-
213
- if __name__ == "__main__":
214
- main()
@@ -1,214 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- NEXO Migration Script: v1.7.x -> v1.8.0 (Hybrid Architecture)
4
-
5
- Migrates CLAUDE.md to the new hybrid architecture where:
6
- - CLAUDE.md = bootstrap (identity, profile, format, autonomy, project atlas)
7
- - MCP instructions field = tool-coupled behavioral rules
8
- - nexo_context_packet = on-demand area-specific context
9
-
10
- The MCP server now carries all tool-coupled rules in its `instructions` field,
11
- so CLAUDE.md no longer needs to duplicate them. This reduces CLAUDE.md from
12
- ~130 lines to ~50 lines, saving ~3K context tokens per session.
13
-
14
- Safe to run multiple times (idempotent). Creates a backup before modifying.
15
-
16
- Usage:
17
- python3 migrate-v1.7-to-v1.8.py [--dry-run] [--nexo-home /path/to/nexo]
18
- """
19
-
20
- import argparse
21
- import os
22
- import re
23
- import shutil
24
- import sys
25
- from datetime import datetime
26
-
27
-
28
- # Sections that are now in the MCP instructions field and should be REMOVED from CLAUDE.md
29
- MCP_OWNED_SECTIONS = [
30
- "Heartbeat",
31
- "Guard",
32
- "Delegation",
33
- "Reminders & Followups",
34
- "Reminders y Followups",
35
- "Memory",
36
- "Memoria",
37
- "Trust Score",
38
- "Adaptive Mode",
39
- "Dissonance",
40
- "Disonancia",
41
- "Observe the User",
42
- "Observar a Francisco", # legacy personal CLAUDE.md files
43
- "Observar al Usuario",
44
- "Change Log",
45
- "Session Diary",
46
- "Cortex",
47
- "Operational Codex",
48
- ]
49
-
50
- # Sections that STAY in CLAUDE.md (bootstrap layer)
51
- BOOTSTRAP_SECTIONS = [
52
- "Startup",
53
- "User Profile",
54
- "Francisco", # legacy personal CLAUDE.md files
55
- "Formato",
56
- "Format",
57
- "Autonomy",
58
- "Autonomía",
59
- "Project Atlas",
60
- "Atlas de Proyectos",
61
- "Hooks",
62
- "Menu",
63
- "Platforms",
64
- "Plataformas",
65
- "Repo",
66
- ]
67
-
68
-
69
- def find_nexo_home(override=None):
70
- if override:
71
- return override
72
- candidates = [
73
- os.path.expanduser("~/nexo"),
74
- os.path.expanduser("~/.nexo"),
75
- os.path.expanduser("~/claude/nexo-mcp"),
76
- ]
77
- for c in candidates:
78
- if os.path.isdir(c):
79
- return c
80
- return None
81
-
82
-
83
- def find_claude_md():
84
- """Find the CLAUDE.md file that contains NEXO instructions."""
85
- candidates = [
86
- os.path.expanduser("~/.claude/CLAUDE.md"),
87
- os.path.expanduser("~/CLAUDE.md"),
88
- ]
89
- for c in candidates:
90
- if os.path.isfile(c):
91
- return c
92
- return None
93
-
94
-
95
- def parse_sections(content):
96
- """Parse markdown into sections by ## headers."""
97
- sections = []
98
- current_header = None
99
- current_lines = []
100
-
101
- for line in content.split("\n"):
102
- if line.startswith("## "):
103
- if current_header is not None:
104
- sections.append((current_header, "\n".join(current_lines)))
105
- current_header = line[3:].strip()
106
- current_lines = [line]
107
- else:
108
- current_lines.append(line)
109
-
110
- if current_header is not None:
111
- sections.append((current_header, "\n".join(current_lines)))
112
- elif current_lines:
113
- sections.append(("_preamble", "\n".join(current_lines)))
114
-
115
- return sections
116
-
117
-
118
- def is_mcp_owned(header):
119
- """Check if a section header matches an MCP-owned section."""
120
- header_lower = header.lower()
121
- for section in MCP_OWNED_SECTIONS:
122
- if section.lower() in header_lower:
123
- return True
124
- return False
125
-
126
-
127
- def migrate_claude_md(path, dry_run=False):
128
- """Slim down CLAUDE.md by removing MCP-owned sections."""
129
- with open(path, "r") as f:
130
- content = f.read()
131
-
132
- original_lines = len(content.strip().split("\n"))
133
- sections = parse_sections(content)
134
-
135
- # Separate preamble, bootstrap, and MCP-owned sections
136
- preamble = ""
137
- kept = []
138
- removed = []
139
-
140
- for header, body in sections:
141
- if header == "_preamble":
142
- preamble = body
143
- elif is_mcp_owned(header):
144
- removed.append(header)
145
- else:
146
- kept.append((header, body))
147
-
148
- if not removed:
149
- print(" CLAUDE.md already migrated (no MCP-owned sections found).")
150
- return False
151
-
152
- # Add hybrid architecture note to preamble
153
- if "MCP instructions" not in preamble and "instructions" not in preamble:
154
- preamble = preamble.rstrip() + (
155
- "\nTool-coupled behavioral rules (heartbeat, guard, trust, memory, diary) "
156
- "now live in the MCP server instructions field and are injected automatically.\n"
157
- )
158
-
159
- # Reconstruct
160
- new_content = preamble + "\n"
161
- for header, body in kept:
162
- new_content += "\n" + body + "\n"
163
-
164
- new_lines = len(new_content.strip().split("\n"))
165
-
166
- print(f" Sections removed (now in MCP): {', '.join(removed)}")
167
- print(f" Lines: {original_lines} → {new_lines} (saved {original_lines - new_lines})")
168
-
169
- if dry_run:
170
- print(" [DRY RUN] No changes written.")
171
- return True
172
-
173
- # Backup
174
- backup = path + f".backup-{datetime.now().strftime(\"%Y%m%d-%H%M%S\")}"
175
- shutil.copy2(path, backup)
176
- print(f" Backup: {backup}")
177
-
178
- with open(path, "w") as f:
179
- f.write(new_content)
180
- print(" CLAUDE.md updated.")
181
- return True
182
-
183
-
184
- def main():
185
- parser = argparse.ArgumentParser(description="Migrate NEXO to v1.8 hybrid architecture")
186
- parser.add_argument("--dry-run", action="store_true", help="Show what would change without modifying files")
187
- parser.add_argument("--nexo-home", help="Override NEXO home directory")
188
- args = parser.parse_args()
189
-
190
- print("NEXO v1.7 → v1.8 Migration (Hybrid Architecture)")
191
- print("=" * 50)
192
- print()
193
-
194
- # Step 1: Find and migrate CLAUDE.md
195
- claude_md = find_claude_md()
196
- if claude_md:
197
- print(f"Found CLAUDE.md: {claude_md}")
198
- migrate_claude_md(claude_md, dry_run=args.dry_run)
199
- else:
200
- print("No CLAUDE.md found (skipping).")
201
-
202
- print()
203
- print("Migration complete.")
204
- print()
205
- print("What changed:")
206
- print(" - CLAUDE.md now contains only bootstrap (identity, format, autonomy)")
207
- print(" - Tool-coupled rules are in the MCP server instructions field")
208
- print(" - Context-specific rules load on-demand via nexo_context_packet")
209
- print()
210
- print("The MCP server must be restarted for instructions to take effect.")
211
-
212
-
213
- if __name__ == "__main__":
214
- main()
@@ -1,55 +0,0 @@
1
- #!/bin/bash
2
- # Pre-commit hook: prevent private data from being committed to the public repo.
3
- # Installed by nexo-brain or manually: cp scripts/pre-commit-check.sh .git/hooks/pre-commit
4
-
5
- RED='\033[0;31m'
6
- NC='\033[0m'
7
-
8
- # Add patterns specific to your private data here.
9
- # These are checked against staged files to prevent accidental leaks.
10
- # The pre-commit-check.sh script itself is excluded from scanning.
11
- BLOCKED_PATTERNS=(
12
- # Add your own patterns below, e.g.:
13
- # "my-private-api-key"
14
- # "my-private-domain.com"
15
- # "my-server-ip"
16
- )
17
-
18
- STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR)
19
-
20
- if [ -z "$STAGED_FILES" ]; then
21
- exit 0
22
- fi
23
-
24
- FOUND=0
25
- for pattern in "${BLOCKED_PATTERNS[@]}"; do
26
- MATCHES=$(echo "$STAGED_FILES" | xargs grep -l "$pattern" 2>/dev/null)
27
- if [ -n "$MATCHES" ]; then
28
- echo -e "${RED}BLOCKED: Found private data pattern '$pattern' in:${NC}"
29
- echo "$MATCHES" | sed 's/^/ /'
30
- FOUND=1
31
- fi
32
- done
33
-
34
- # Also check for .db files, tokens, credentials
35
- DB_FILES=$(echo "$STAGED_FILES" | grep -E '\.(db|db-wal|db-shm|key|pem)$')
36
- if [ -n "$DB_FILES" ]; then
37
- echo -e "${RED}BLOCKED: Database/key files staged:${NC}"
38
- echo "$DB_FILES" | sed 's/^/ /'
39
- FOUND=1
40
- fi
41
-
42
- TOKEN_FILES=$(echo "$STAGED_FILES" | grep -E '_token\.|credentials|\.env$')
43
- if [ -n "$TOKEN_FILES" ]; then
44
- echo -e "${RED}BLOCKED: Token/credential files staged:${NC}"
45
- echo "$TOKEN_FILES" | sed 's/^/ /'
46
- FOUND=1
47
- fi
48
-
49
- if [ $FOUND -eq 1 ]; then
50
- echo ""
51
- echo -e "${RED}Commit blocked. Remove private data before pushing to public repo.${NC}"
52
- exit 1
53
- fi
54
-
55
- exit 0
@@ -1,55 +0,0 @@
1
- #!/bin/bash
2
- # Pre-commit hook: prevent private data from being committed to the public repo.
3
- # Installed by nexo-brain or manually: cp scripts/pre-commit-check.sh .git/hooks/pre-commit
4
-
5
- RED='\033[0;31m'
6
- NC='\033[0m'
7
-
8
- # Add patterns specific to your private data here.
9
- # These are checked against staged files to prevent accidental leaks.
10
- # The pre-commit-check.sh script itself is excluded from scanning.
11
- BLOCKED_PATTERNS=(
12
- # Add your own patterns below, e.g.:
13
- # "my-private-api-key"
14
- # "my-private-domain.com"
15
- # "my-server-ip"
16
- )
17
-
18
- STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR)
19
-
20
- if [ -z "$STAGED_FILES" ]; then
21
- exit 0
22
- fi
23
-
24
- FOUND=0
25
- for pattern in "${BLOCKED_PATTERNS[@]}"; do
26
- MATCHES=$(echo "$STAGED_FILES" | xargs grep -l "$pattern" 2>/dev/null)
27
- if [ -n "$MATCHES" ]; then
28
- echo -e "${RED}BLOCKED: Found private data pattern '$pattern' in:${NC}"
29
- echo "$MATCHES" | sed 's/^/ /'
30
- FOUND=1
31
- fi
32
- done
33
-
34
- # Also check for .db files, tokens, credentials
35
- DB_FILES=$(echo "$STAGED_FILES" | grep -E '\.(db|db-wal|db-shm|key|pem)$')
36
- if [ -n "$DB_FILES" ]; then
37
- echo -e "${RED}BLOCKED: Database/key files staged:${NC}"
38
- echo "$DB_FILES" | sed 's/^/ /'
39
- FOUND=1
40
- fi
41
-
42
- TOKEN_FILES=$(echo "$STAGED_FILES" | grep -E '_token\.|credentials|\.env$')
43
- if [ -n "$TOKEN_FILES" ]; then
44
- echo -e "${RED}BLOCKED: Token/credential files staged:${NC}"
45
- echo "$TOKEN_FILES" | sed 's/^/ /'
46
- FOUND=1
47
- fi
48
-
49
- if [ $FOUND -eq 1 ]; then
50
- echo ""
51
- echo -e "${RED}Commit blocked. Remove private data before pushing to public repo.${NC}"
52
- exit 1
53
- fi
54
-
55
- exit 0