nexo-brain 5.3.26 → 5.3.28

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 (212) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/package.json +1 -1
  3. package/src/hook_guardrails.py +44 -0
  4. package/src/server.py +3 -0
  5. package/src/tools_sessions.py +6 -1
  6. package/src/dashboard/static/favicon 2.svg +0 -32
  7. package/src/dashboard/static/nexo-logo 2.png +0 -0
  8. package/src/dashboard/static/nexo-logo 2.svg +0 -40
  9. package/src/dashboard/static/style 2.css +0 -2458
  10. package/src/dashboard/templates/adaptive 2.html +0 -118
  11. package/src/dashboard/templates/artifacts 2.html +0 -133
  12. package/src/dashboard/templates/backups 2.html +0 -136
  13. package/src/dashboard/templates/base 2.html +0 -417
  14. package/src/dashboard/templates/calendar 2.html +0 -591
  15. package/src/dashboard/templates/chat 2.html +0 -356
  16. package/src/dashboard/templates/claims 2.html +0 -259
  17. package/src/dashboard/templates/cortex 2.html +0 -321
  18. package/src/dashboard/templates/credentials 2.html +0 -128
  19. package/src/dashboard/templates/crons 2.html +0 -370
  20. package/src/dashboard/templates/dashboard 2.html +0 -494
  21. package/src/dashboard/templates/dreams 2.html +0 -252
  22. package/src/dashboard/templates/email 2.html +0 -160
  23. package/src/dashboard/templates/evolution 2.html +0 -189
  24. package/src/dashboard/templates/feed 2.html +0 -249
  25. package/src/dashboard/templates/followup_health 2.html +0 -170
  26. package/src/dashboard/templates/graph 2.html +0 -201
  27. package/src/dashboard/templates/guard 2.html +0 -259
  28. package/src/dashboard/templates/inbox 2.html +0 -251
  29. package/src/dashboard/templates/memory 2.html +0 -420
  30. package/src/dashboard/templates/operations 2.html +0 -608
  31. package/src/dashboard/templates/plugins 2.html +0 -185
  32. package/src/dashboard/templates/protocol 2.html +0 -199
  33. package/src/dashboard/templates/rules 2.html +0 -246
  34. package/src/dashboard/templates/sentiment 2.html +0 -247
  35. package/src/dashboard/templates/sessions 2.html +0 -218
  36. package/src/dashboard/templates/skills 2.html +0 -329
  37. package/src/dashboard/templates/somatic 2.html +0 -73
  38. package/src/dashboard/templates/triggers 2.html +0 -133
  39. package/src/dashboard/templates/trust 2.html +0 -360
  40. package/src/db/__init__ 2.py +0 -259
  41. package/src/db/_core 2.py +0 -437
  42. package/src/db/_credentials 2.py +0 -124
  43. package/src/db/_episodic 2.py +0 -762
  44. package/src/db/_evolution 2.py +0 -54
  45. package/src/db/_fts 2.py +0 -406
  46. package/src/db/_goal_profiles 2.py +0 -376
  47. package/src/db/_hot_context 2.py +0 -660
  48. package/src/db/_outcomes 2.py +0 -800
  49. package/src/db/_personal_scripts 2.py +0 -582
  50. package/src/db/_sessions 2.py +0 -330
  51. package/src/db/_tasks 2.py +0 -91
  52. package/src/db/_watchers 2.py +0 -173
  53. package/src/doctor/formatters 2.py +0 -52
  54. package/src/doctor/models 2.py +0 -69
  55. package/src/doctor/planes 2.py +0 -87
  56. package/src/doctor/providers/__init__ 2.py +0 -1
  57. package/src/doctor/providers/deep 2.py +0 -367
  58. package/src/evolution_cycle 2.py +0 -519
  59. package/src/hooks/auto_capture 2.py +0 -208
  60. package/src/hooks/caffeinate-guard 2.sh +0 -8
  61. package/src/hooks/capture-session 2.sh +0 -21
  62. package/src/hooks/capture-tool-logs 2.sh +0 -158
  63. package/src/hooks/daily-briefing-check 2.sh +0 -33
  64. package/src/hooks/heartbeat-enforcement 2.py +0 -90
  65. package/src/hooks/heartbeat-posttool 2.sh +0 -18
  66. package/src/hooks/inbox-hook 2.sh +0 -76
  67. package/src/hooks/post-compact 2.sh +0 -152
  68. package/src/hooks/pre-compact 2.sh +0 -169
  69. package/src/hooks/protocol-guardrail 2.sh +0 -10
  70. package/src/hooks/protocol-pretool-guardrail 2.sh +0 -9
  71. package/src/hooks/session-stop 2.sh +0 -52
  72. package/src/kg_populate 2.py +0 -292
  73. package/src/maintenance 2.py +0 -53
  74. package/src/memory_backends 2.py +0 -71
  75. package/src/migrate_embeddings 2.py +0 -124
  76. package/src/nexo_sdk 2.py +0 -103
  77. package/src/observability 2.py +0 -199
  78. package/src/plugin_loader 2.py +0 -217
  79. package/src/plugins/__init__ 2.py +0 -0
  80. package/src/plugins/artifact_registry 2.py +0 -450
  81. package/src/plugins/backup 2.py +0 -127
  82. package/src/plugins/claims_tools 2.py +0 -119
  83. package/src/plugins/cognitive_memory 2.py +0 -609
  84. package/src/plugins/core_rules 2.py +0 -252
  85. package/src/plugins/cortex 2.py +0 -1155
  86. package/src/plugins/entities 2.py +0 -67
  87. package/src/plugins/episodic_memory 2.py +0 -560
  88. package/src/plugins/evolution 2.py +0 -167
  89. package/src/plugins/goal_engine 2.py +0 -142
  90. package/src/plugins/guard 2.py +0 -862
  91. package/src/plugins/impact 2.py +0 -29
  92. package/src/plugins/knowledge_graph_tools 2.py +0 -137
  93. package/src/plugins/media_memory_tools 2.py +0 -98
  94. package/src/plugins/memory_export 2.py +0 -196
  95. package/src/plugins/outcomes 2.py +0 -130
  96. package/src/plugins/personal_scripts 2.py +0 -117
  97. package/src/plugins/preferences 2.py +0 -47
  98. package/src/plugins/protocol 2.py +0 -1449
  99. package/src/plugins/simple_api 2.py +0 -106
  100. package/src/plugins/skills 2.py +0 -341
  101. package/src/plugins/state_watchers 2.py +0 -79
  102. package/src/plugins/update 2.py +0 -986
  103. package/src/plugins/user_state_tools 2.py +0 -43
  104. package/src/plugins/workflow 2.py +0 -588
  105. package/src/protocol_settings 2.py +0 -59
  106. package/src/public_contribution 2.py +0 -466
  107. package/src/public_evolution_queue 2.py +0 -241
  108. package/src/requirements 2.txt +0 -14
  109. package/src/retroactive_learnings 2.py +0 -373
  110. package/src/rules/__init__ 2.py +0 -0
  111. package/src/rules/core-rules 2.json +0 -331
  112. package/src/rules/migrate 2.py +0 -207
  113. package/src/runtime_power 2.py +0 -874
  114. package/src/script_registry 2.py +0 -1559
  115. package/src/scripts/check-context 2.py +0 -272
  116. package/src/scripts/deep-sleep/apply_findings 2.py +0 -2327
  117. package/src/scripts/deep-sleep/collect 2.py +0 -928
  118. package/src/scripts/deep-sleep/extract 2.py +0 -330
  119. package/src/scripts/deep-sleep/extract-prompt 2.md +0 -285
  120. package/src/scripts/deep-sleep/synthesize 2.py +0 -312
  121. package/src/scripts/deep-sleep/synthesize-prompt 2.md +0 -336
  122. package/src/scripts/nexo-agent-run 2.py +0 -75
  123. package/src/scripts/nexo-auto-update 2.py +0 -6
  124. package/src/scripts/nexo-backup 2.sh +0 -25
  125. package/src/scripts/nexo-brain-activation 2.sh +0 -140
  126. package/src/scripts/nexo-catchup 2.py +0 -300
  127. package/src/scripts/nexo-cognitive-decay 2.py +0 -257
  128. package/src/scripts/nexo-cortex-cycle 2.py +0 -293
  129. package/src/scripts/nexo-cron-wrapper 2.sh +0 -53
  130. package/src/scripts/nexo-daily-self-audit 2.py +0 -2161
  131. package/src/scripts/nexo-dashboard 2.sh +0 -29
  132. package/src/scripts/nexo-deep-sleep 2.sh +0 -86
  133. package/src/scripts/nexo-evolution-run 2.py +0 -1664
  134. package/src/scripts/nexo-followup-hygiene 2.py +0 -139
  135. package/src/scripts/nexo-hook-record 2.py +0 -42
  136. package/src/scripts/nexo-immune 2.py +0 -936
  137. package/src/scripts/nexo-impact-scorer 2.py +0 -117
  138. package/src/scripts/nexo-inbox-hook 2.sh +0 -74
  139. package/src/scripts/nexo-install 2.py +0 -6
  140. package/src/scripts/nexo-learning-housekeep 2.py +0 -401
  141. package/src/scripts/nexo-learning-validator 2.py +0 -266
  142. package/src/scripts/nexo-migrate 2.py +0 -260
  143. package/src/scripts/nexo-outcome-checker 2.py +0 -127
  144. package/src/scripts/nexo-postmortem-consolidator 2.py +0 -456
  145. package/src/scripts/nexo-pre-commit 2.py +0 -120
  146. package/src/scripts/nexo-prevent-sleep 2.sh +0 -35
  147. package/src/scripts/nexo-proactive-dashboard 2.py +0 -354
  148. package/src/scripts/nexo-reflection 2.py +0 -256
  149. package/src/scripts/nexo-runtime-preflight 2.py +0 -274
  150. package/src/scripts/nexo-sleep 2.py +0 -631
  151. package/src/scripts/nexo-snapshot-restore 2.sh +0 -35
  152. package/src/scripts/nexo-sync-clients 2.py +0 -16
  153. package/src/scripts/nexo-synthesis 2.py +0 -475
  154. package/src/scripts/nexo-tcc-approve 2.sh +0 -79
  155. package/src/scripts/nexo-update 2.sh +0 -306
  156. package/src/scripts/nexo-watchdog 2.sh +0 -1207
  157. package/src/scripts/nexo-watchdog-smoke 2.py +0 -119
  158. package/src/scripts/rehydrate_learnings_from_archive 2.py +0 -245
  159. package/src/server 2.py +0 -1296
  160. package/src/skills/run-nexo-audit-phase/guide 2.md +0 -43
  161. package/src/skills/run-nexo-audit-phase/skill 2.json +0 -59
  162. package/src/skills/run-nexo-core-fix-cycle/guide 2.md +0 -17
  163. package/src/skills/run-nexo-core-fix-cycle/script 2.py +0 -276
  164. package/src/skills/run-nexo-core-fix-cycle/skill 2.json +0 -58
  165. package/src/skills/run-release-final-audit/guide 2.md +0 -16
  166. package/src/skills/run-release-final-audit/script 2.py +0 -259
  167. package/src/skills/run-release-final-audit/skill 2.json +0 -77
  168. package/src/skills/run-runtime-doctor/guide 2.md +0 -12
  169. package/src/skills/run-runtime-doctor/script 2.py +0 -21
  170. package/src/skills/run-runtime-doctor/skill 2.json +0 -25
  171. package/src/skills_runtime 2.py +0 -932
  172. package/src/state_watchers_runtime 2.py +0 -475
  173. package/src/storage_router 2.py +0 -32
  174. package/src/system_catalog 2.py +0 -786
  175. package/src/tools_coordination 2.py +0 -103
  176. package/src/tools_credentials 2.py +0 -68
  177. package/src/tools_drive 2.py +0 -487
  178. package/src/tools_hot_context 2.py +0 -163
  179. package/src/tools_learnings 2.py +0 -612
  180. package/src/tools_menu 2.py +0 -229
  181. package/src/tools_reminders 2.py +0 -88
  182. package/src/tools_reminders_crud 2.py +0 -363
  183. package/src/tools_sessions 2.py +0 -1054
  184. package/src/tools_system_catalog 2.py +0 -19
  185. package/src/tools_task_history 2.py +0 -57
  186. package/src/tools_transcripts 2.py +0 -98
  187. package/src/transcript_utils 2.py +0 -412
  188. package/src/user_context 2.py +0 -46
  189. package/src/user_data_portability 2.py +0 -328
  190. package/src/user_state_model 2.py +0 -170
  191. package/templates/CLAUDE.md 2.template +0 -108
  192. package/templates/CODEX.AGENTS.md 2.template +0 -66
  193. package/templates/launchagents/README 2.md +0 -132
  194. package/templates/launchagents/com.nexo.auto-close-sessions 2.plist +0 -39
  195. package/templates/launchagents/com.nexo.catchup 2.plist +0 -39
  196. package/templates/launchagents/com.nexo.cognitive-decay 2.plist +0 -40
  197. package/templates/launchagents/com.nexo.dashboard 2.plist +0 -43
  198. package/templates/launchagents/com.nexo.deep-sleep 2.plist +0 -43
  199. package/templates/launchagents/com.nexo.evolution 2.plist +0 -44
  200. package/templates/launchagents/com.nexo.followup-hygiene 2.plist +0 -45
  201. package/templates/launchagents/com.nexo.immune 2.plist +0 -41
  202. package/templates/launchagents/com.nexo.postmortem 2.plist +0 -45
  203. package/templates/launchagents/com.nexo.self-audit 2.plist +0 -47
  204. package/templates/launchagents/com.nexo.synthesis 2.plist +0 -45
  205. package/templates/launchagents/com.nexo.watchdog 2.plist +0 -37
  206. package/templates/nexo_helper 2.py +0 -301
  207. package/templates/openclaw 2.json +0 -13
  208. package/templates/plugin-template 2.py +0 -40
  209. package/templates/script-template 2.py +0 -59
  210. package/templates/script-template 2.sh +0 -13
  211. package/templates/skill-script-template 2.py +0 -48
  212. package/templates/skill-template 2.md +0 -33
@@ -1,119 +0,0 @@
1
- #!/usr/bin/env python3
2
- """
3
- NEXO Watchdog Smoke
4
-
5
- Runs the same health checks as the shell watchdog, but never restores files,
6
- restarts services, disables evolution or notifies the user.
7
- """
8
-
9
- from __future__ import annotations
10
-
11
- import hashlib
12
- import json
13
- import os
14
- import sqlite3
15
- import subprocess
16
- from datetime import datetime
17
- from pathlib import Path
18
-
19
- HOME = Path.home()
20
- NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(HOME / ".nexo")))
21
- NEXO_CODE = Path(os.environ.get("NEXO_CODE", str(NEXO_HOME)))
22
- BRAIN_DIR = NEXO_HOME / "brain"
23
- LOG_DIR = NEXO_HOME / "logs"
24
- SUMMARY_FILE = LOG_DIR / "watchdog-smoke-summary.json"
25
- HASH_REGISTRY = NEXO_HOME / "scripts" / ".watchdog-hashes"
26
- RESTORE_LOG = LOG_DIR / "snapshot-restores.log"
27
-
28
-
29
- def _read_restore_count_for_current_hour() -> int:
30
- if not RESTORE_LOG.exists():
31
- return 0
32
- needle = datetime.now().strftime("%Y-%m-%d %H")
33
- return sum(1 for line in RESTORE_LOG.read_text(errors="ignore").splitlines()
34
- if needle in line and "/.codex/memories/nexo-" not in line)
35
-
36
-
37
- def _sha256(path: Path) -> str:
38
- return hashlib.sha256(path.read_bytes()).hexdigest()
39
-
40
-
41
- def main() -> int:
42
- LOG_DIR.mkdir(parents=True, exist_ok=True)
43
- findings = []
44
-
45
- db_path = NEXO_HOME / "data" / "nexo.db"
46
- integrity = "missing"
47
- if db_path.exists():
48
- try:
49
- conn = sqlite3.connect(str(db_path), timeout=10)
50
- integrity = conn.execute("PRAGMA integrity_check").fetchone()[0]
51
- conn.close()
52
- except Exception as exc:
53
- integrity = f"error:{exc}"
54
- if integrity != "ok":
55
- findings.append({"severity": "ERROR", "area": "sqlite", "msg": f"integrity={integrity}"})
56
-
57
- # Check if the NEXO MCP server process is alive (replaces legacy cortex process check)
58
- nexo_server_running = subprocess.run(
59
- ["pgrep", "-f", "nexo-brain"],
60
- capture_output=True,
61
- text=True,
62
- ).returncode == 0
63
- if not nexo_server_running:
64
- findings.append({"severity": "INFO", "area": "server", "msg": "nexo-brain not running (normal if no active session)"})
65
-
66
- backups = sorted((NEXO_HOME / "backups").glob("nexo-*.db"), key=lambda p: p.stat().st_mtime, reverse=True)
67
- if backups:
68
- age_seconds = int(datetime.now().timestamp() - backups[0].stat().st_mtime)
69
- if age_seconds > 7200:
70
- findings.append({"severity": "WARN", "area": "backup", "msg": f"latest backup age={age_seconds}s"})
71
- else:
72
- findings.append({"severity": "WARN", "area": "backup", "msg": "no backups found"})
73
-
74
- if HASH_REGISTRY.exists():
75
- for line in HASH_REGISTRY.read_text().splitlines():
76
- if not line.strip():
77
- continue
78
- filepath, expected_hash = line.split("|", 1)
79
- path = Path(filepath)
80
- if path.exists() and _sha256(path) != expected_hash:
81
- findings.append({"severity": "ERROR", "area": "immutable", "msg": f"hash mismatch: {filepath}"})
82
-
83
- restore_count = _read_restore_count_for_current_hour()
84
- if restore_count > 2:
85
- findings.append({"severity": "ERROR", "area": "restore_loop", "msg": f"{restore_count} restores this hour"})
86
- elif restore_count > 0:
87
- findings.append({"severity": "INFO", "area": "restore_activity", "msg": f"{restore_count} restores this hour"})
88
-
89
- # Check brain/ (canonical) first, fall back to cortex/ (legacy)
90
- objective = BRAIN_DIR / "evolution-objective.json"
91
- if not objective.exists():
92
- objective = NEXO_HOME / "cortex" / "evolution-objective.json"
93
- evolution_enabled = None
94
- if objective.exists():
95
- obj = json.loads(objective.read_text())
96
- evolution_enabled = obj.get("evolution_enabled", True)
97
- if not evolution_enabled:
98
- findings.append({
99
- "severity": "WARN",
100
- "area": "evolution",
101
- "msg": f"disabled: {obj.get('disabled_reason', 'unknown')}",
102
- })
103
-
104
- summary = {
105
- "timestamp": datetime.now().isoformat(),
106
- "ok": not any(f["severity"] == "ERROR" for f in findings),
107
- "integrity": integrity,
108
- "server_running": nexo_server_running,
109
- "evolution_enabled": evolution_enabled,
110
- "restore_count_current_hour": restore_count,
111
- "findings": findings,
112
- }
113
- SUMMARY_FILE.write_text(json.dumps(summary, indent=2, ensure_ascii=False))
114
- print(json.dumps(summary, ensure_ascii=False))
115
- return 1 if any(f["severity"] == "ERROR" for f in findings) else 0
116
-
117
-
118
- if __name__ == "__main__":
119
- raise SystemExit(main())
@@ -1,245 +0,0 @@
1
- #!/usr/bin/env python3
2
- from __future__ import annotations
3
-
4
- """Rehydrate archived markdown learnings back into the NEXO learnings table.
5
-
6
- The original Evolution #5 incident found an empty learnings table while the
7
- historical archive still existed as markdown grouped by domain. This helper
8
- parses the archive format used in those files:
9
-
10
- - markdown tables with `Error | Solucion`
11
- - dated sections with bullet/numbered operational learnings
12
-
13
- Dry-run is the default. Pass `--apply` to insert missing learnings.
14
- """
15
-
16
- import argparse
17
- import re
18
- import sys
19
- from dataclasses import dataclass
20
- from pathlib import Path
21
-
22
- REPO_SRC = Path(__file__).resolve().parents[1]
23
- if str(REPO_SRC) not in sys.path:
24
- sys.path.insert(0, str(REPO_SRC))
25
-
26
- from db import create_learning, get_db, init_db # noqa: E402
27
- from runtime_home import export_resolved_nexo_home # noqa: E402
28
-
29
- NEXO_HOME = export_resolved_nexo_home()
30
- TABLE_HEADER_TITLES = {"error", "problema", "issue"}
31
- DEFAULT_ARCHIVE_DIRS = (
32
- NEXO_HOME / "claude" / "operations" / "archive" / "learnings",
33
- Path.home() / "claude" / "operations" / "archive" / "learnings",
34
- Path.home() / ".claude" / "operations" / "archive" / "learnings",
35
- )
36
-
37
-
38
- @dataclass(frozen=True)
39
- class LearningCandidate:
40
- category: str
41
- title: str
42
- content: str
43
- reasoning: str
44
- prevention: str
45
- status: str = "active"
46
-
47
-
48
- def _strip_markdown(text: str) -> str:
49
- text = text.replace("**", "").replace("__", "")
50
- text = text.replace("~~", "")
51
- text = re.sub(r"`([^`]*)`", r"\1", text)
52
- text = re.sub(r"\[([^\]]+)\]\([^)]+\)", r"\1", text)
53
- text = re.sub(r"\s+", " ", text).strip(" |")
54
- return text.strip()
55
-
56
-
57
- def _derive_title(text: str) -> str:
58
- first_sentence = re.split(r"(?<=[.!?])\s+", text, maxsplit=1)[0].strip()
59
- if not first_sentence:
60
- first_sentence = text.strip()
61
- return first_sentence[:180].rstrip(" .")
62
-
63
-
64
- def _derive_prevention(text: str) -> str:
65
- match = re.search(r"(Regla:\s*.*|SIEMPRE\s+.*|NUNCA\s+.*)", text, flags=re.IGNORECASE)
66
- if match:
67
- return match.group(1).strip()
68
- return text[:500].strip()
69
-
70
-
71
- def _candidate_reasoning(path: Path, section: str) -> str:
72
- section_note = f" [{section}]" if section and section != path.stem else ""
73
- return f"Rehydrated from markdown archive {path.name}{section_note}"
74
-
75
-
76
- def _parse_table_row(path: Path, section: str, line: str) -> LearningCandidate | None:
77
- parts = [_strip_markdown(cell) for cell in line.strip().strip("|").split("|")]
78
- if len(parts) < 2:
79
- return None
80
- title, prevention = parts[0], parts[1]
81
- if title.lower() in TABLE_HEADER_TITLES or set(title) <= {"-"}:
82
- return None
83
- if not title or not prevention:
84
- return None
85
- status = "superseded" if "obsoleto" in prevention.lower() or "obsoleto" in title.lower() else "active"
86
- content = f"{title}. {prevention}"
87
- return LearningCandidate(
88
- category=path.stem,
89
- title=title,
90
- content=content,
91
- reasoning=_candidate_reasoning(path, section),
92
- prevention=prevention,
93
- status=status,
94
- )
95
-
96
-
97
- def _consume_bullet_block(lines: list[str], start: int) -> tuple[str, int]:
98
- pieces = [re.sub(r"^([-*]|\d+\.)\s+", "", lines[start].strip())]
99
- idx = start + 1
100
- while idx < len(lines):
101
- stripped = lines[idx].strip()
102
- if not stripped:
103
- break
104
- if stripped.startswith("## ") or stripped.startswith("|"):
105
- break
106
- if re.match(r"^([-*]|\d+\.)\s+", stripped):
107
- break
108
- pieces.append(stripped)
109
- idx += 1
110
- return _strip_markdown(" ".join(pieces)), idx
111
-
112
-
113
- def _parse_bullet(path: Path, section: str, text: str) -> LearningCandidate | None:
114
- if len(text) < 12:
115
- return None
116
- title = _derive_title(text)
117
- prevention = _derive_prevention(text)
118
- status = "superseded" if "obsoleto" in text.lower() else "active"
119
- return LearningCandidate(
120
- category=path.stem,
121
- title=title,
122
- content=text,
123
- reasoning=_candidate_reasoning(path, section),
124
- prevention=prevention,
125
- status=status,
126
- )
127
-
128
-
129
- def parse_archive_file(path: Path) -> list[LearningCandidate]:
130
- lines = path.read_text(encoding="utf-8", errors="ignore").splitlines()
131
- section = path.stem
132
- results: list[LearningCandidate] = []
133
- idx = 0
134
- while idx < len(lines):
135
- stripped = lines[idx].strip()
136
- if stripped.startswith("## "):
137
- section = _strip_markdown(stripped[3:])
138
- idx += 1
139
- continue
140
- if stripped.startswith("|") and not re.match(r"^\|\s*-", stripped):
141
- row = _parse_table_row(path, section, stripped)
142
- if row is not None:
143
- results.append(row)
144
- idx += 1
145
- continue
146
- if re.match(r"^([-*]|\d+\.)\s+", stripped):
147
- block, next_idx = _consume_bullet_block(lines, idx)
148
- row = _parse_bullet(path, section, block)
149
- if row is not None:
150
- results.append(row)
151
- idx = next_idx
152
- continue
153
- idx += 1
154
- return results
155
-
156
-
157
- def parse_archive_dir(archive_dir: Path) -> list[LearningCandidate]:
158
- candidates: list[LearningCandidate] = []
159
- for path in sorted(archive_dir.glob("*.md")):
160
- candidates.extend(parse_archive_file(path))
161
-
162
- deduped: list[LearningCandidate] = []
163
- seen: set[tuple[str, str]] = set()
164
- for item in candidates:
165
- key = (item.category.lower(), item.title.lower())
166
- if key in seen:
167
- continue
168
- seen.add(key)
169
- deduped.append(item)
170
- return deduped
171
-
172
-
173
- def resolve_archive_dir(explicit: str = "") -> Path:
174
- if explicit:
175
- path = Path(explicit).expanduser()
176
- if not path.is_dir():
177
- raise FileNotFoundError(f"archive dir not found: {path}")
178
- return path
179
- for candidate in DEFAULT_ARCHIVE_DIRS:
180
- if candidate.is_dir():
181
- return candidate
182
- raise FileNotFoundError(
183
- "No learnings archive found. Tried: "
184
- + ", ".join(str(path) for path in DEFAULT_ARCHIVE_DIRS)
185
- )
186
-
187
-
188
- def apply_candidates(candidates: list[LearningCandidate], *, apply: bool) -> dict:
189
- init_db()
190
- conn = get_db()
191
- existing = {
192
- (row[0].lower(), row[1].lower())
193
- for row in conn.execute("SELECT category, title FROM learnings").fetchall()
194
- }
195
- inserted = 0
196
- skipped = 0
197
- for item in candidates:
198
- key = (item.category.lower(), item.title.lower())
199
- if key in existing:
200
- skipped += 1
201
- continue
202
- if apply:
203
- create_learning(
204
- item.category,
205
- item.title,
206
- item.content,
207
- reasoning=item.reasoning,
208
- prevention=item.prevention,
209
- status=item.status,
210
- )
211
- existing.add(key)
212
- inserted += 1
213
- return {
214
- "parsed": len(candidates),
215
- "inserted": inserted,
216
- "skipped_existing": skipped,
217
- "mode": "apply" if apply else "dry-run",
218
- }
219
-
220
-
221
- def build_arg_parser() -> argparse.ArgumentParser:
222
- parser = argparse.ArgumentParser(description=__doc__)
223
- parser.add_argument("--archive-dir", default="", help="Override archive directory")
224
- parser.add_argument("--apply", action="store_true", help="Insert parsed learnings into the DB")
225
- return parser
226
-
227
-
228
- def main(argv: list[str] | None = None) -> int:
229
- args = build_arg_parser().parse_args(argv)
230
- try:
231
- archive_dir = resolve_archive_dir(args.archive_dir)
232
- except FileNotFoundError as exc:
233
- print(f"ERROR: {exc}", file=sys.stderr)
234
- return 1
235
- candidates = parse_archive_dir(archive_dir)
236
- summary = apply_candidates(candidates, apply=args.apply)
237
- print(
238
- f"{summary['mode']}: archive={archive_dir} parsed={summary['parsed']} "
239
- f"inserted={summary['inserted']} skipped_existing={summary['skipped_existing']}"
240
- )
241
- return 0
242
-
243
-
244
- if __name__ == "__main__":
245
- raise SystemExit(main())