chore(memory): update memory entries for decisions, preferences, and quirks

Author: vchan-in

.memory/cleanup.log

@@ -0,0 +1,10 @@
+
+--- Cleanup: 2026-02-27T13:49:52.191Z ---
+Merged 2 similar entries → "ADRs live in docs/decisions/ but are NOT in the Zensical nav…"
+Pruned [Decision] (score 22): "Model resolution always happens inside lm.ts. Call…"
+
+--- Cleanup: 2026-02-27T15:01:41.609Z ---
+Merged 2 similar entries → "Use replaceAll() instead of replace() for string replacement…"
+Pruned [Preference] (score 15): "Dedup thresholds guard writes. Cleanup merge thres…"
+Pruned [Preference] (score 14): "Use replaceAll() instead of replace() for string r…"
+Pruned [Decision] (score 20): "The default category limit fallback is 20, hardcod…"

.memory/decisions.md

@@ -30,7 +30,16 @@ Memories stored by HackLM Memory.
 
 - [gap-analysis-no-changelog] Gap analysis prompt forbids changelog/past-event suggestions. The LM must not suggest entries phrased as "last cleanup did X" or "removed Y yesterday".
 
-- [category-limits-rationale] Instruction=15, Decision=20, others unchanged. Instructions and Decisions grow fastest on active projects. Context length is not the constraint — quality is.
+- [open-source-license] Project is licensed under GPL-3.0-only. MIT removed. Both root LICENSE and extension/LICENSE hold the GPL v3 text. Both package.json files have "license": "GPL-3.0-only".
 
+- [docs-site-zensical] Docs site uses Zensical (pip install zensical). Config in zensical.toml at repo root. Serve: .venv/Scripts/zensical.exe serve. Build: zensical build → site/. Deploys to GitHub Pages via .github/workflows/docs.yml on push to main.
 
-- [model-resolution] Model resolution always happens inside lm.ts. Callers pass a family string or nothing. They never call vscode.lm.selectChatModels directly. This keeps fallback logic in one place.
+
+- [globalstate-keys-file] All globalState keys live in extension/src/globalStateKeys.ts as named exports. Never use bare string literals for globalState keys elsewhere.
+
+- [category-limits-source] CATEGORY_LIMITS constant removed from markdownStore.ts. Category limits come from VS Code config only (package.json defaults via config.get). Default fallback is hardcoded as 20 in utils.ts.
+
+- [stale-slug-pruner-removed] pruneStaleEntries removed from cleanupMemory.ts. Stale slugs last-cleanup and last-session-debrief no longer exist. ADRs 0001 and 0013 deleted from docs/decisions/ as they documented completed migration periods.
+
+
+- [adr-location] ADRs live in docs/decisions.md but are NOT in the Zensical nav. The nav has an ADR page (docs/adr.md) instead. That page links back to docs/decisions.md on GitHub.

.memory/preferences.md

@@ -28,13 +28,17 @@ Memories stored by HackLM Memory.
 
 - [globalstate-cleanup-log-key] The cleanup log is stored under a namespaced globalState key, same as all other extension state. Never write it to a bare key or a separate file outside globalState.
 
-- [tree-view-message-on-empty] When a tree view has no data to show, set treeView.message to a short guidance string in code. This supplements viewsWelcome and handles dynamic empty states after initial load.
-
 - [globalstate-keys-enumerated] All globalState key names are defined as constants in a single file. Never scatter bare string keys across modules.
 
 - [tree-item-context-value] Every TreeItem that supports commands sets a contextValue string. Without it, when-clause conditions in package.json menus cannot target that item type.
 
+- [globalstate-keys] All globalState key constants live in one file. No module defines its own key inline. Import from the constants file or the key does not exist.
 
-- [dedup-cleanup-thresholds] Dedup thresholds and cleanup merge thresholds serve different purposes. Never unify them into a single constant. Write thresholds guard against storing duplicates. Cleanup thresholds control when stored entries get merged or removed.
+- [docs-site-local-serve] Run the docs site locally with .venv/Scripts/zensical.exe serve. Build the static output with zensical build. Output goes to site/. Never commit the site/ directory.
+
+- [adr-link-to-adrs] The ADR page (docs/adr.md) links to docs/decisions.md for the full ADR list. Keep that link current when new ADRs are added.
+
+- [node-protocol-imports] Use node: protocol for built-in imports (node:fs/promises, node:path). Never import bare 'fs/promises' or 'path'.
+
+- [lm-model-resolution-centralized] Model selection and resolution happen only in lm.ts. No other module calls selectChatModels directly. Import the resolved model from lm.ts or do not use it.
 
-- [globalstate-keys] All globalState key constants live in one file. No module defines its own key inline. Import from the constants file or the key does not exist.

.memory/quirks.md

@@ -6,5 +6,6 @@ Memories stored by HackLM Memory.
 
 - [tree-item-id] Every TreeItem must have a stable unique id set explicitly. Without it, VS Code cannot preserve reveal state or selection across refreshes.
 
-
 - [empty-justification] Passing an empty options object to sendRequest suppresses the justification string in the VS Code permission prompt. The user sees a blank reason. Always pass a justification.
+
+- [adr-location] ADRs live in docs/decisions.md (a single flat file, not a directory). No separate per-ADR files. Add new ADRs as new H2 sections at the bottom of that file.