openclacky 1.5.22 → 1.5.24

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 (130) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +104 -0
  3. data/docs/secretary-prototype.md +286 -0
  4. data/lib/clacky/agent/cost_tracker.rb +55 -36
  5. data/lib/clacky/agent/hook_manager.rb +4 -1
  6. data/lib/clacky/agent/llm_caller.rb +46 -12
  7. data/lib/clacky/agent/memory_injector.rb +209 -0
  8. data/lib/clacky/agent/memory_updater.rb +16 -0
  9. data/lib/clacky/agent/session_serializer.rb +15 -11
  10. data/lib/clacky/agent/skill_manager.rb +30 -8
  11. data/lib/clacky/agent.rb +124 -17
  12. data/lib/clacky/agent_config.rb +7 -3
  13. data/lib/clacky/agent_profile.rb +33 -6
  14. data/lib/clacky/anthropic_stream_aggregator.rb +11 -1
  15. data/lib/clacky/bedrock_stream_aggregator.rb +11 -1
  16. data/lib/clacky/billing/platform_billing.rb +7 -0
  17. data/lib/clacky/cli.rb +4 -3
  18. data/lib/clacky/client.rb +30 -25
  19. data/lib/clacky/default_extensions/advisor/README.md +25 -0
  20. data/lib/clacky/default_extensions/advisor/README.zh.md +25 -0
  21. data/lib/clacky/default_extensions/advisor/ext.yml +1 -1
  22. data/lib/clacky/default_extensions/advisor/icon.svg +14 -0
  23. data/lib/clacky/default_extensions/advisor/panels/advisor/view.js +7 -1
  24. data/lib/clacky/default_extensions/coding/ext.yml +0 -1
  25. data/lib/clacky/default_extensions/computer-use/README.md +48 -0
  26. data/lib/clacky/default_extensions/computer-use/README.zh.md +48 -0
  27. data/lib/clacky/default_extensions/computer-use/ext.yml +1 -1
  28. data/lib/clacky/default_extensions/computer-use/icon.svg +16 -0
  29. data/lib/clacky/default_extensions/ext-studio/ext.yml +0 -1
  30. data/lib/clacky/default_extensions/general/ext.yml +0 -1
  31. data/lib/clacky/default_extensions/git/README.md +41 -0
  32. data/lib/clacky/default_extensions/git/README.zh.md +41 -0
  33. data/lib/clacky/default_extensions/git/ext.yml +1 -1
  34. data/lib/clacky/default_extensions/git/icon.svg +15 -0
  35. data/lib/clacky/default_extensions/git/panels/git/view.js +106 -27
  36. data/lib/clacky/default_extensions/meeting/README.md +46 -0
  37. data/lib/clacky/default_extensions/meeting/README.zh.md +47 -0
  38. data/lib/clacky/default_extensions/meeting/ext.yml +1 -1
  39. data/lib/clacky/default_extensions/meeting/icon.svg +13 -0
  40. data/lib/clacky/default_extensions/preview/README.md +29 -0
  41. data/lib/clacky/default_extensions/preview/README.zh.md +29 -0
  42. data/lib/clacky/default_extensions/preview/ext.yml +1 -1
  43. data/lib/clacky/default_extensions/preview/icon.svg +13 -0
  44. data/lib/clacky/default_extensions/secretary/README.md +69 -0
  45. data/lib/clacky/default_extensions/secretary/README.zh.md +69 -0
  46. data/lib/clacky/default_extensions/secretary/agents/secretary.md +41 -0
  47. data/lib/clacky/default_extensions/secretary/agents/worker.md +35 -0
  48. data/lib/clacky/default_extensions/secretary/api/handler.rb +8 -0
  49. data/lib/clacky/default_extensions/secretary/ext.yml +42 -0
  50. data/lib/clacky/default_extensions/secretary/icon.svg +17 -0
  51. data/lib/clacky/default_extensions/secretary/panels/work/view.js +344 -0
  52. data/lib/clacky/default_extensions/secretary/tools/delegate_work.rb +37 -0
  53. data/lib/clacky/default_extensions/secretary/tools/manage_work.rb +22 -0
  54. data/lib/clacky/default_extensions/secretary/tools/yield_work.rb +35 -0
  55. data/lib/clacky/default_extensions/time_machine/README.md +32 -0
  56. data/lib/clacky/default_extensions/time_machine/README.zh.md +32 -0
  57. data/lib/clacky/default_extensions/time_machine/ext.yml +1 -1
  58. data/lib/clacky/default_extensions/time_machine/icon.svg +14 -0
  59. data/lib/clacky/default_skills/channel-manager/SKILL.md +103 -13
  60. data/lib/clacky/default_skills/channel-manager/dingtalk_setup.rb +4 -2
  61. data/lib/clacky/default_skills/channel-manager/discord_setup.rb +9 -2
  62. data/lib/clacky/default_skills/channel-manager/weixin_setup.rb +10 -1
  63. data/lib/clacky/default_skills/cron-task-creator/SKILL.md +183 -206
  64. data/lib/clacky/default_skills/cron-task-creator/evals/evals.json +45 -0
  65. data/lib/clacky/default_skills/media-gen/SKILL.md +31 -14
  66. data/lib/clacky/default_skills/onboard/SKILL.md +5 -7
  67. data/lib/clacky/default_skills/persist-memory/SKILL.md +15 -1
  68. data/lib/clacky/extension/api_extension.rb +23 -2
  69. data/lib/clacky/extension/loader.rb +2 -0
  70. data/lib/clacky/extension/verifier.rb +2 -2
  71. data/lib/clacky/json_ui_controller.rb +14 -1
  72. data/lib/clacky/locales/en.rb +14 -0
  73. data/lib/clacky/locales/i18n.rb +25 -3
  74. data/lib/clacky/locales/zh.rb +14 -0
  75. data/lib/clacky/message_history.rb +15 -2
  76. data/lib/clacky/openai_responses_stream_aggregator.rb +11 -1
  77. data/lib/clacky/openai_stream_aggregator.rb +11 -1
  78. data/lib/clacky/prompts/base.md +1 -1
  79. data/lib/clacky/providers.rb +32 -17
  80. data/lib/clacky/server/backup_manager.rb +98 -2
  81. data/lib/clacky/server/browser_manager.rb +10 -5
  82. data/lib/clacky/server/channel/adapters/base.rb +18 -0
  83. data/lib/clacky/server/channel/adapters/feishu/message_parser.rb +1 -0
  84. data/lib/clacky/server/channel/adapters/telegram/adapter.rb +1 -0
  85. data/lib/clacky/server/channel/channel_config.rb +185 -48
  86. data/lib/clacky/server/channel/channel_manager.rb +247 -110
  87. data/lib/clacky/server/git_panel.rb +2 -1
  88. data/lib/clacky/server/http_server.rb +517 -175
  89. data/lib/clacky/server/preview.rb +26 -5
  90. data/lib/clacky/server/scheduler.rb +166 -85
  91. data/lib/clacky/server/web_ui_controller.rb +12 -0
  92. data/lib/clacky/session_manager.rb +4 -1
  93. data/lib/clacky/skill.rb +1 -1
  94. data/lib/clacky/tools/base.rb +7 -1
  95. data/lib/clacky/ui_interface.rb +5 -0
  96. data/lib/clacky/utils/file_processor.rb +23 -11
  97. data/lib/clacky/utils/model_pricing.rb +19 -0
  98. data/lib/clacky/version.rb +1 -1
  99. data/lib/clacky/web/app.css +621 -52
  100. data/lib/clacky/web/app.js +103 -9
  101. data/lib/clacky/web/components/code-editor.js +73 -4
  102. data/lib/clacky/web/components/custom-select.js +7 -18
  103. data/lib/clacky/web/components/hint-tip.js +172 -0
  104. data/lib/clacky/web/components/model-picker.js +1 -1
  105. data/lib/clacky/web/components/notify.js +37 -10
  106. data/lib/clacky/web/components/onboard.js +1 -1
  107. data/lib/clacky/web/components/sidebar.js +70 -0
  108. data/lib/clacky/web/features/backup/store.js +64 -27
  109. data/lib/clacky/web/features/backup/view.js +42 -11
  110. data/lib/clacky/web/features/channels/store.js +19 -4
  111. data/lib/clacky/web/features/channels/view.js +94 -33
  112. data/lib/clacky/web/features/extensions/view.js +15 -8
  113. data/lib/clacky/web/features/new-session/view.js +33 -22
  114. data/lib/clacky/web/features/profile/view.js +4 -4
  115. data/lib/clacky/web/features/tasks/store.js +5 -3
  116. data/lib/clacky/web/features/tasks/view.js +99 -26
  117. data/lib/clacky/web/features/trash/view.js +4 -4
  118. data/lib/clacky/web/features/workspace/view.js +193 -57
  119. data/lib/clacky/web/i18n.js +189 -17
  120. data/lib/clacky/web/index.html +165 -53
  121. data/lib/clacky/web/projects.js +15 -2
  122. data/lib/clacky/web/sessions.js +316 -86
  123. data/lib/clacky/web/settings.js +304 -75
  124. data/lib/clacky/web/utils.js +261 -0
  125. data/lib/clacky/web/ws-dispatcher.js +24 -3
  126. data/lib/clacky/web/ws.js +16 -4
  127. data/lib/clacky/work/service.rb +544 -0
  128. data/lib/clacky/work/store.rb +57 -0
  129. data/lib/clacky.rb +1 -0
  130. metadata +35 -1
@@ -0,0 +1,209 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "json"
4
+
5
+ module Clacky
6
+ class Agent
7
+ # Automatic long-term memory injection (opt-in: memory_inject_enabled).
8
+ #
9
+ # Before each user message a picker model (the provider's lite model, else
10
+ # the primary) selects relevant files from a wide memories listing
11
+ # (+load_memories_meta+); their bodies are appended as a system_injected
12
+ # user message. Append-only keeps the prompt-cache prefix intact. Files
13
+ # already injected on the active task chain are skipped; compression drops
14
+ # those messages, which naturally allows re-injection later.
15
+ #
16
+ # Best-effort: any failure is logged and the turn proceeds without memories.
17
+ module MemoryInjector
18
+ MEMORY_INJECT_MAX_FILES = 3
19
+ MEMORY_INJECT_FILE_BYTES = 4096
20
+ MEMORY_INJECT_STALE_DAYS = 30
21
+ MEMORY_PICKER_PREV_REPLY_CHARS = 600
22
+ MEMORY_PICKER_USER_CHARS = 2000
23
+ # Thinking models spend part of this budget on reasoning; 200 truncated the JSON.
24
+ MEMORY_PICKER_MAX_TOKENS = 1024
25
+ MEMORY_PICKER_READ_TIMEOUT = 20
26
+ # The picker can't grep, so it needs a far wider view than the
27
+ # 20-file LRU shortlist the recall/persist skills get.
28
+ MEMORY_PICKER_LISTING_LIMIT = 200
29
+
30
+ MEMORY_PICKER_SYSTEM_PROMPT = <<~PROMPT
31
+ You select long-term memory files relevant to the user's latest message.
32
+ A memory is relevant only if it would change how the assistant handles this message
33
+ (preferences, conventions, project facts, prior decisions). Skip loosely related ones.
34
+ Reply with JSON only: {"files": ["<filename>.md"]} using at most #{MEMORY_INJECT_MAX_FILES} filenames from the list.
35
+ Reply {"files": []} when nothing is relevant (greetings, acknowledgements, small talk).
36
+ PROMPT
37
+
38
+ private def inject_relevant_memories(user_input, task_id:)
39
+ return unless @config.memory_inject_enabled
40
+ return if @is_subagent
41
+
42
+ message = user_input.to_s.strip
43
+ return if message.empty?
44
+ return if Dir.glob(File.join(memories_base_dir, "*.md")).empty?
45
+
46
+ visible = memory_visible_messages
47
+ picked = pick_relevant_memories(message, visible) - injected_memory_files(visible)
48
+ return if picked.empty?
49
+
50
+ @history.append({
51
+ role: "user",
52
+ content: build_memory_reminder(picked),
53
+ system_injected: true,
54
+ memory_recall: true,
55
+ memory_files: picked,
56
+ task_id: task_id
57
+ })
58
+ rescue StandardError => e
59
+ Clacky::Logger.warn("memory_inject.failed", error: e)
60
+ end
61
+
62
+ # Messages on the active task chain, so undone branches neither count as
63
+ # injected nor feed the picker.
64
+ private def memory_visible_messages
65
+ chain = active_task_chain
66
+ @history.to_a.select { |m| !m[:task_id] || chain.include?(m[:task_id]) }
67
+ end
68
+
69
+ private def injected_memory_files(messages)
70
+ messages.select { |m| m[:memory_recall] }.flat_map { |m| Array(m[:memory_files]) }.uniq
71
+ end
72
+
73
+ private def pick_relevant_memories(message, visible)
74
+ model = memory_picker_model
75
+ # send_messages_with_tools rather than send_messages: only it returns usage.
76
+ response = memory_picker_client(model).send_messages_with_tools(
77
+ [
78
+ { role: "system", content: MEMORY_PICKER_SYSTEM_PROMPT },
79
+ { role: "user", content: memory_picker_prompt(message, visible) }
80
+ ],
81
+ model: model,
82
+ tools: [],
83
+ max_tokens: MEMORY_PICKER_MAX_TOKENS
84
+ )
85
+ track_auxiliary_cost(response[:usage], model: response[:routed_model] || model) if response[:usage]
86
+ if response[:finish_reason] == "length"
87
+ Clacky::Logger.warn("memory_inject.picker_truncated", model: model, max_tokens: MEMORY_PICKER_MAX_TOKENS)
88
+ end
89
+ parse_memory_picker_reply(response[:content].to_s)
90
+ .select { |name| memory_file_name?(name) }
91
+ .uniq
92
+ .first(MEMORY_INJECT_MAX_FILES)
93
+ end
94
+
95
+ private def memory_picker_model
96
+ lite = @config.lite_model_config_for_current
97
+ (lite && lite["model"]) || current_model
98
+ end
99
+
100
+ # A dedicated client so a slow picker gives up quickly instead of holding
101
+ # the turn for the main client's 300s read timeout.
102
+ private def memory_picker_client(model)
103
+ lite = @config.lite_model_config_for_current
104
+ if lite
105
+ Clacky::Client.new(
106
+ lite["api_key"],
107
+ base_url: lite["base_url"],
108
+ model: model,
109
+ anthropic_format: lite["anthropic_format"] == true,
110
+ read_timeout: MEMORY_PICKER_READ_TIMEOUT
111
+ )
112
+ else
113
+ Clacky::Client.new(
114
+ @config.api_key,
115
+ base_url: @config.base_url,
116
+ model: model,
117
+ anthropic_format: @config.anthropic_format?,
118
+ api_format: @config.api_format,
119
+ read_timeout: MEMORY_PICKER_READ_TIMEOUT
120
+ )
121
+ end
122
+ end
123
+
124
+ private def memory_picker_prompt(message, visible)
125
+ <<~PROMPT
126
+ #{load_memories_meta(limit: MEMORY_PICKER_LISTING_LIMIT)}
127
+
128
+ Previous assistant reply (excerpt):
129
+ #{previous_reply_excerpt(last_assistant_reply_text(visible))}
130
+
131
+ User message:
132
+ #{message[0, MEMORY_PICKER_USER_CHARS]}
133
+ PROMPT
134
+ end
135
+
136
+ # Long replies open with the conclusion but close with the question the
137
+ # user is answering, so keep both ends.
138
+ private def previous_reply_excerpt(text)
139
+ return "(none)" if text.empty?
140
+
141
+ limit = MEMORY_PICKER_PREV_REPLY_CHARS
142
+ return text if text.length <= limit
143
+
144
+ half = limit / 2
145
+ "#{text[0, half]}\n...\n#{text[-half, half]}"
146
+ end
147
+
148
+ private def parse_memory_picker_reply(text)
149
+ json = begin
150
+ JSON.parse(text)
151
+ rescue JSON::ParserError
152
+ match = text.match(/\{.*\}/m)
153
+ match ? (JSON.parse(match[0]) rescue nil) : nil
154
+ end
155
+ files = json.is_a?(Hash) ? json["files"] : nil
156
+ files.is_a?(Array) ? files.map(&:to_s) : []
157
+ end
158
+
159
+ # Bare filename that exists in the memories dir; rejects hallucinated
160
+ # names and any path components.
161
+ private def memory_file_name?(name)
162
+ name.end_with?(".md") && File.basename(name) == name &&
163
+ File.file?(File.join(memories_base_dir, name))
164
+ end
165
+
166
+ private def last_assistant_reply_text(visible)
167
+ msg = visible.reverse.find { |m| m[:role] == "assistant" && !m[:content].to_s.strip.empty? }
168
+ return "" unless msg
169
+
170
+ content = msg[:content]
171
+ text = if content.is_a?(Array)
172
+ content.map { |b| b.is_a?(Hash) ? (b[:text] || b["text"]).to_s : "" }.join("\n")
173
+ else
174
+ content.to_s
175
+ end
176
+ text.strip
177
+ end
178
+
179
+ private def build_memory_reminder(names)
180
+ parts = [
181
+ "<system-reminder>",
182
+ "Relevant long-term memories (auto-selected from ~/.clacky/memories/). " \
183
+ "Apply them where they fit; the user's current instructions take precedence.",
184
+ ""
185
+ ]
186
+ names.each do |name|
187
+ path = File.join(memories_base_dir, name)
188
+ mtime = File.mtime(path)
189
+ parts << "## #{name} (last updated #{mtime.strftime("%Y-%m-%d")})"
190
+ parts << memory_inject_body(path)
191
+ age_days = ((Time.now - mtime) / 86_400).floor
192
+ if age_days > MEMORY_INJECT_STALE_DAYS
193
+ parts << "(This memory is #{age_days} days old; verify it against the current state before relying on it.)"
194
+ end
195
+ parts << ""
196
+ end
197
+ parts << "</system-reminder>"
198
+ parts.join("\n")
199
+ end
200
+
201
+ private def memory_inject_body(path)
202
+ body = File.read(path, encoding: "UTF-8").sub(/\A---\n.*?\n---\n*/m, "").strip
203
+ return body if body.bytesize <= MEMORY_INJECT_FILE_BYTES
204
+
205
+ "#{body.byteslice(0, MEMORY_INJECT_FILE_BYTES).scrub("")}\n...(truncated; read #{path} for the rest)"
206
+ end
207
+ end
208
+ end
209
+ end
@@ -188,6 +188,22 @@ module Clacky
188
188
  - Any task that produced no lasting decisions or preferences
189
189
  - Repeating or slightly rephrasing what is already in memory
190
190
 
191
+ ## Never persist what can be re-derived
192
+
193
+ Code and git are the source of truth; a memory that copies them goes stale
194
+ silently and later misleads. Do NOT persist:
195
+
196
+ - Code structure, architecture, file paths, class/method names, line numbers
197
+ - Implementation details of a feature that was just built or changed
198
+ - Git history, change logs, PR contents, or "what was modified"
199
+ - Debugging steps, root-cause narratives, or how a bug was fixed
200
+ - Content already in project rules or docs (.clackyrules, README, AGENTS.md, etc.)
201
+ - Temporary task state, progress, or TODOs of the current conversation
202
+
203
+ If a session's only takeaways fall into this list, write nothing. When a
204
+ whitelisted item involves code, persist only the decision and its reason,
205
+ not the implementation.
206
+
191
207
  ═══════════════════════════════════════════════════════════════
192
208
  EXECUTOR MANUAL (from persist-memory skill)
193
209
  ═══════════════════════════════════════════════════════════════
@@ -20,7 +20,13 @@ module Clacky
20
20
  @archived_at = session_data[:archived_at]
21
21
  @history = MessageHistory.new(session_data[:messages] || [])
22
22
  @input_queue = (session_data[:pending_inputs] || []).map do |entry|
23
- entry.reject { |key, _| key == :steer_target }.merge(delivery: "queue")
23
+ options = (entry[:options] || {}).dup
24
+ # Old queued inputs stored both the references and their generated text.
25
+ legacy_references = options.delete(:references_display)
26
+ unless Array(legacy_references).empty?
27
+ options[:reference_contexts] = Array(legacy_references) + Array(options[:reference_contexts])
28
+ end
29
+ entry.reject { |key, _| key == :steer_target }.merge(delivery: "queue", options: options)
24
30
  end
25
31
  @accepting_steering = false
26
32
  @todos = session_data[:todos] || [] # Restore todos from session
@@ -136,17 +142,15 @@ module Clacky
136
142
  model_entry = @config.find_model_by_name_and_url(saved_model_name, saved_base_url)
137
143
  if model_entry && model_entry["id"]
138
144
  switch_model_by_id(model_entry["id"])
139
- end
140
- end
141
145
 
142
- # Re-apply the per-session sub-model pin (if any). Done AFTER
143
- # switch_model_by_id so the overlay isn't cleared by the card switch
144
- # invariant. Validation happens at write-time (the WebUI/API enforces
145
- # the name belongs to the card's provider) — at restore-time we trust
146
- # what we previously wrote.
147
- saved_sub_model = session_data.dig(:config, :sub_model)
148
- if saved_sub_model && !saved_sub_model.to_s.empty?
149
- set_session_sub_model(saved_sub_model)
146
+ # The sub-model pin belongs to the saved card's provider, so it is
147
+ # only re-applied when that card was found; on the fallback card it
148
+ # would pair a foreign model name with the wrong credentials.
149
+ saved_sub_model = session_data.dig(:config, :sub_model)
150
+ if saved_sub_model && !saved_sub_model.to_s.empty?
151
+ set_session_sub_model(saved_sub_model)
152
+ end
153
+ end
150
154
  end
151
155
 
152
156
  # Rebuild and refresh the system prompt so any newly installed skills
@@ -98,6 +98,14 @@ module Clacky
98
98
  # so excessive mcp.json entries don't quietly bloat the system prompt.
99
99
  MAX_CONTEXT_MCP_SERVERS = 10
100
100
 
101
+ # Bounds on the memories listing injected into recall/persist-memory skills.
102
+ # The file cap is an LRU shortlist, not a hard limit: older files stay
103
+ # reachable via grep. Per-field caps stop one oversized frontmatter from
104
+ # bloating the whole list.
105
+ MAX_MEMORIES_META_FILES = 20
106
+ MAX_MEMORY_TOPIC_CHARS = 100
107
+ MAX_MEMORY_DESCRIPTION_CHARS = 150
108
+
101
109
  # Process-wide deduper for the "skill context limit" warning so that
102
110
  # every newly constructed Agent (sub-agents, retries, web turns…) doesn't
103
111
  # re-emit the same line.
@@ -489,16 +497,18 @@ module Clacky
489
497
 
490
498
  # Scan ~/.clacky/memories/ and return a formatted summary of all memory files.
491
499
  # Parses YAML frontmatter (same pattern as Skill#parse_frontmatter) for each file.
500
+ # @param limit [Integer] max files listed, newest first
492
501
  # @return [String] Formatted list of memory topics and descriptions
493
- def load_memories_meta
502
+ def load_memories_meta(limit: MAX_MEMORIES_META_FILES)
494
503
  memories_dir = memories_base_dir
495
504
  return "(No long-term memories found.)" unless Dir.exist?(memories_dir)
496
505
 
497
- files = Dir.glob(File.join(memories_dir, "*.md"))
498
- .sort_by { |f| File.mtime(f) }
499
- .reverse
500
- .first(20)
501
- return "(No long-term memories found.)" if files.empty?
506
+ all_files = Dir.glob(File.join(memories_dir, "*.md"))
507
+ .sort_by { |f| File.mtime(f) }
508
+ .reverse
509
+ return "(No long-term memories found.)" if all_files.empty?
510
+
511
+ files = all_files.first(limit)
502
512
 
503
513
  lines = ["Available memory files in ~/.clacky/memories/:"]
504
514
  lines << ""
@@ -506,8 +516,8 @@ module Clacky
506
516
  files.each do |path|
507
517
  filename = File.basename(path)
508
518
  fm = parse_memory_frontmatter(path)
509
- topic = fm["topic"] || filename.sub(/\.md$/, "")
510
- description = fm["description"] || "(no description)"
519
+ topic = truncate_memory_field(fm["topic"] || filename.sub(/\.md$/, ""), MAX_MEMORY_TOPIC_CHARS)
520
+ description = truncate_memory_field(fm["description"] || "(no description)", MAX_MEMORY_DESCRIPTION_CHARS)
511
521
  # Use file mtime as the "last seen" signal (covers both writes and
512
522
  # touch-on-recall LRU bumps). Authoritative — no longer relies on
513
523
  # an LLM-maintained `updated_at` frontmatter field.
@@ -518,9 +528,21 @@ module Clacky
518
528
  lines << entry
519
529
  end
520
530
 
531
+ omitted = all_files.size - files.size
532
+ if omitted > 0
533
+ lines << ""
534
+ lines << "(#{omitted} older memories not listed — search ~/.clacky/memories/ with grep if needed)"
535
+ end
536
+
521
537
  lines.join("\n")
522
538
  end
523
539
 
540
+ # Collapse to a single line so each memory occupies exactly one entry in the listing.
541
+ private def truncate_memory_field(value, max_chars)
542
+ text = value.to_s.gsub(/\s+/, " ").strip
543
+ text.length > max_chars ? "#{text[0, max_chars]}…" : text
544
+ end
545
+
524
546
  # Base directory for long-term memories. Override in tests for isolation.
525
547
  # @return [String]
526
548
  def memories_base_dir