@delfos-ai/cli 1.0.3

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 (190) hide show
  1. package/README.md +93 -0
  2. package/dist/api/delfos-api.client.d.ts +32 -0
  3. package/dist/api/delfos-api.client.d.ts.map +1 -0
  4. package/dist/api/delfos-api.client.js +43 -0
  5. package/dist/api/delfos-api.client.js.map +1 -0
  6. package/dist/commands/login.command.d.ts +15 -0
  7. package/dist/commands/login.command.d.ts.map +1 -0
  8. package/dist/commands/login.command.js +164 -0
  9. package/dist/commands/login.command.js.map +1 -0
  10. package/dist/commands/logout.command.d.ts +8 -0
  11. package/dist/commands/logout.command.d.ts.map +1 -0
  12. package/dist/commands/logout.command.js +46 -0
  13. package/dist/commands/logout.command.js.map +1 -0
  14. package/dist/commands/mcp/mcp-memory.command.d.ts +11 -0
  15. package/dist/commands/mcp/mcp-memory.command.d.ts.map +1 -0
  16. package/dist/commands/mcp/mcp-memory.command.js +22 -0
  17. package/dist/commands/mcp/mcp-memory.command.js.map +1 -0
  18. package/dist/commands/memory/index.d.ts +3 -0
  19. package/dist/commands/memory/index.d.ts.map +1 -0
  20. package/dist/commands/memory/index.js +14 -0
  21. package/dist/commands/memory/index.js.map +1 -0
  22. package/dist/commands/memory/memory-index.command.d.ts +3 -0
  23. package/dist/commands/memory/memory-index.command.d.ts.map +1 -0
  24. package/dist/commands/memory/memory-index.command.js +57 -0
  25. package/dist/commands/memory/memory-index.command.js.map +1 -0
  26. package/dist/commands/memory/memory-init.command.d.ts +3 -0
  27. package/dist/commands/memory/memory-init.command.d.ts.map +1 -0
  28. package/dist/commands/memory/memory-init.command.js +72 -0
  29. package/dist/commands/memory/memory-init.command.js.map +1 -0
  30. package/dist/commands/memory/memory-read.command.d.ts +3 -0
  31. package/dist/commands/memory/memory-read.command.d.ts.map +1 -0
  32. package/dist/commands/memory/memory-read.command.js +52 -0
  33. package/dist/commands/memory/memory-read.command.js.map +1 -0
  34. package/dist/commands/memory/memory-status.command.d.ts +7 -0
  35. package/dist/commands/memory/memory-status.command.d.ts.map +1 -0
  36. package/dist/commands/memory/memory-status.command.js +43 -0
  37. package/dist/commands/memory/memory-status.command.js.map +1 -0
  38. package/dist/commands/memory/memory-write.command.d.ts +3 -0
  39. package/dist/commands/memory/memory-write.command.d.ts.map +1 -0
  40. package/dist/commands/memory/memory-write.command.js +66 -0
  41. package/dist/commands/memory/memory-write.command.js.map +1 -0
  42. package/dist/config/cli-config.d.ts +13 -0
  43. package/dist/config/cli-config.d.ts.map +1 -0
  44. package/dist/config/cli-config.js +31 -0
  45. package/dist/config/cli-config.js.map +1 -0
  46. package/dist/config/memory.config.d.ts +61 -0
  47. package/dist/config/memory.config.d.ts.map +1 -0
  48. package/dist/config/memory.config.js +22 -0
  49. package/dist/config/memory.config.js.map +1 -0
  50. package/dist/features/memory-index/index.d.ts +5 -0
  51. package/dist/features/memory-index/index.d.ts.map +1 -0
  52. package/dist/features/memory-index/index.js +3 -0
  53. package/dist/features/memory-index/index.js.map +1 -0
  54. package/dist/features/memory-index/memory-index.schema.d.ts +96 -0
  55. package/dist/features/memory-index/memory-index.schema.d.ts.map +1 -0
  56. package/dist/features/memory-index/memory-index.schema.js +14 -0
  57. package/dist/features/memory-index/memory-index.schema.js.map +1 -0
  58. package/dist/features/memory-index/vault-indexer.d.ts +17 -0
  59. package/dist/features/memory-index/vault-indexer.d.ts.map +1 -0
  60. package/dist/features/memory-index/vault-indexer.js +140 -0
  61. package/dist/features/memory-index/vault-indexer.js.map +1 -0
  62. package/dist/features/memory-init/vault-scaffolder.d.ts +20 -0
  63. package/dist/features/memory-init/vault-scaffolder.d.ts.map +1 -0
  64. package/dist/features/memory-init/vault-scaffolder.js +109 -0
  65. package/dist/features/memory-init/vault-scaffolder.js.map +1 -0
  66. package/dist/features/memory-read/index.d.ts +4 -0
  67. package/dist/features/memory-read/index.d.ts.map +1 -0
  68. package/dist/features/memory-read/index.js +3 -0
  69. package/dist/features/memory-read/index.js.map +1 -0
  70. package/dist/features/memory-read/memory-read.schema.d.ts +79 -0
  71. package/dist/features/memory-read/memory-read.schema.d.ts.map +1 -0
  72. package/dist/features/memory-read/memory-read.schema.js +25 -0
  73. package/dist/features/memory-read/memory-read.schema.js.map +1 -0
  74. package/dist/features/memory-read/rag-reader.d.ts +8 -0
  75. package/dist/features/memory-read/rag-reader.d.ts.map +1 -0
  76. package/dist/features/memory-read/rag-reader.js +79 -0
  77. package/dist/features/memory-read/rag-reader.js.map +1 -0
  78. package/dist/features/memory-server/config-loader.d.ts +6 -0
  79. package/dist/features/memory-server/config-loader.d.ts.map +1 -0
  80. package/dist/features/memory-server/config-loader.js +39 -0
  81. package/dist/features/memory-server/config-loader.js.map +1 -0
  82. package/dist/features/memory-server/index.d.ts +5 -0
  83. package/dist/features/memory-server/index.d.ts.map +1 -0
  84. package/dist/features/memory-server/index.js +4 -0
  85. package/dist/features/memory-server/index.js.map +1 -0
  86. package/dist/features/memory-server/memory-server.d.ts +6 -0
  87. package/dist/features/memory-server/memory-server.d.ts.map +1 -0
  88. package/dist/features/memory-server/memory-server.js +197 -0
  89. package/dist/features/memory-server/memory-server.js.map +1 -0
  90. package/dist/features/memory-server/memory-server.schema.d.ts +194 -0
  91. package/dist/features/memory-server/memory-server.schema.d.ts.map +1 -0
  92. package/dist/features/memory-server/memory-server.schema.js +58 -0
  93. package/dist/features/memory-server/memory-server.schema.js.map +1 -0
  94. package/dist/features/memory-server/tools/memory-index.handler.d.ts +10 -0
  95. package/dist/features/memory-server/tools/memory-index.handler.d.ts.map +1 -0
  96. package/dist/features/memory-server/tools/memory-index.handler.js +27 -0
  97. package/dist/features/memory-server/tools/memory-index.handler.js.map +1 -0
  98. package/dist/features/memory-server/tools/memory-read.handler.d.ts +10 -0
  99. package/dist/features/memory-server/tools/memory-read.handler.d.ts.map +1 -0
  100. package/dist/features/memory-server/tools/memory-read.handler.js +33 -0
  101. package/dist/features/memory-server/tools/memory-read.handler.js.map +1 -0
  102. package/dist/features/memory-server/tools/memory-status.handler.d.ts +9 -0
  103. package/dist/features/memory-server/tools/memory-status.handler.d.ts.map +1 -0
  104. package/dist/features/memory-server/tools/memory-status.handler.js +35 -0
  105. package/dist/features/memory-server/tools/memory-status.handler.js.map +1 -0
  106. package/dist/features/memory-server/tools/memory-write.handler.d.ts +8 -0
  107. package/dist/features/memory-server/tools/memory-write.handler.d.ts.map +1 -0
  108. package/dist/features/memory-server/tools/memory-write.handler.js +42 -0
  109. package/dist/features/memory-server/tools/memory-write.handler.js.map +1 -0
  110. package/dist/features/memory-shared/chunker.d.ts +16 -0
  111. package/dist/features/memory-shared/chunker.d.ts.map +1 -0
  112. package/dist/features/memory-shared/chunker.js +93 -0
  113. package/dist/features/memory-shared/chunker.js.map +1 -0
  114. package/dist/features/memory-shared/markdown-parser.d.ts +7 -0
  115. package/dist/features/memory-shared/markdown-parser.d.ts.map +1 -0
  116. package/dist/features/memory-shared/markdown-parser.js +24 -0
  117. package/dist/features/memory-shared/markdown-parser.js.map +1 -0
  118. package/dist/features/memory-shared/vault-path-validator.d.ts +14 -0
  119. package/dist/features/memory-shared/vault-path-validator.d.ts.map +1 -0
  120. package/dist/features/memory-shared/vault-path-validator.js +56 -0
  121. package/dist/features/memory-shared/vault-path-validator.js.map +1 -0
  122. package/dist/features/memory-shared/vault-scanner.d.ts +8 -0
  123. package/dist/features/memory-shared/vault-scanner.d.ts.map +1 -0
  124. package/dist/features/memory-shared/vault-scanner.js +35 -0
  125. package/dist/features/memory-shared/vault-scanner.js.map +1 -0
  126. package/dist/features/memory-shared/vault-slug.d.ts +9 -0
  127. package/dist/features/memory-shared/vault-slug.d.ts.map +1 -0
  128. package/dist/features/memory-shared/vault-slug.js +17 -0
  129. package/dist/features/memory-shared/vault-slug.js.map +1 -0
  130. package/dist/features/memory-write/index.d.ts +6 -0
  131. package/dist/features/memory-write/index.d.ts.map +1 -0
  132. package/dist/features/memory-write/index.js +4 -0
  133. package/dist/features/memory-write/index.js.map +1 -0
  134. package/dist/features/memory-write/memory-write.schema.d.ts +36 -0
  135. package/dist/features/memory-write/memory-write.schema.d.ts.map +1 -0
  136. package/dist/features/memory-write/memory-write.schema.js +14 -0
  137. package/dist/features/memory-write/memory-write.schema.js.map +1 -0
  138. package/dist/features/memory-write/note-formatter.d.ts +11 -0
  139. package/dist/features/memory-write/note-formatter.d.ts.map +1 -0
  140. package/dist/features/memory-write/note-formatter.js +38 -0
  141. package/dist/features/memory-write/note-formatter.js.map +1 -0
  142. package/dist/features/memory-write/vault-writer.d.ts +6 -0
  143. package/dist/features/memory-write/vault-writer.d.ts.map +1 -0
  144. package/dist/features/memory-write/vault-writer.js +61 -0
  145. package/dist/features/memory-write/vault-writer.js.map +1 -0
  146. package/dist/index.d.ts +3 -0
  147. package/dist/index.d.ts.map +1 -0
  148. package/dist/index.js +24 -0
  149. package/dist/index.js.map +1 -0
  150. package/dist/infrastructure/embeddings/embedding-provider.d.ts +9 -0
  151. package/dist/infrastructure/embeddings/embedding-provider.d.ts.map +1 -0
  152. package/dist/infrastructure/embeddings/embedding-provider.js +5 -0
  153. package/dist/infrastructure/embeddings/embedding-provider.js.map +1 -0
  154. package/dist/infrastructure/embeddings/local-embedding.provider.d.ts +18 -0
  155. package/dist/infrastructure/embeddings/local-embedding.provider.d.ts.map +1 -0
  156. package/dist/infrastructure/embeddings/local-embedding.provider.js +38 -0
  157. package/dist/infrastructure/embeddings/local-embedding.provider.js.map +1 -0
  158. package/dist/infrastructure/logger/index.d.ts +21 -0
  159. package/dist/infrastructure/logger/index.d.ts.map +1 -0
  160. package/dist/infrastructure/logger/index.js +116 -0
  161. package/dist/infrastructure/logger/index.js.map +1 -0
  162. package/dist/infrastructure/vector-db/chroma.adapter.d.ts +76 -0
  163. package/dist/infrastructure/vector-db/chroma.adapter.d.ts.map +1 -0
  164. package/dist/infrastructure/vector-db/chroma.adapter.js +137 -0
  165. package/dist/infrastructure/vector-db/chroma.adapter.js.map +1 -0
  166. package/dist/utils/config.d.ts +13 -0
  167. package/dist/utils/config.d.ts.map +1 -0
  168. package/dist/utils/config.js +13 -0
  169. package/dist/utils/config.js.map +1 -0
  170. package/dist/utils/pkce.d.ts +17 -0
  171. package/dist/utils/pkce.d.ts.map +1 -0
  172. package/dist/utils/pkce.js +28 -0
  173. package/dist/utils/pkce.js.map +1 -0
  174. package/dist/utils/port.d.ts +7 -0
  175. package/dist/utils/port.d.ts.map +1 -0
  176. package/dist/utils/port.js +33 -0
  177. package/dist/utils/port.js.map +1 -0
  178. package/package.json +59 -0
  179. package/templates/.gitkeep +0 -0
  180. package/templates/obsidian-vault/AI-Context/global-rules.md +129 -0
  181. package/templates/obsidian-vault/AI-Context/tool-preferences.md +128 -0
  182. package/templates/obsidian-vault/Patterns/architecture-patterns.md +147 -0
  183. package/templates/obsidian-vault/Patterns/coding-standards.md +90 -0
  184. package/templates/obsidian-vault/Projects/example-project/Decisions/example-decision.md +51 -0
  185. package/templates/obsidian-vault/Projects/example-project/Migrations/example-migration.md +85 -0
  186. package/templates/obsidian-vault/Projects/example-project/Overview.md +43 -0
  187. package/templates/obsidian-vault/Projects/example-project/Sessions/session-1.md +66 -0
  188. package/templates/obsidian-vault/Templates/decision.md +57 -0
  189. package/templates/obsidian-vault/Templates/migration.md +86 -0
  190. package/templates/obsidian-vault/Templates/session.md +87 -0
@@ -0,0 +1,43 @@
1
+ ---
2
+ title: Example Project Overview
3
+ tags:
4
+ - project
5
+ - overview
6
+ created: {{date}}
7
+ ---
8
+
9
+ # Example Project
10
+
11
+ ## Overview
12
+
13
+ This is an example project to demonstrate how to structure your documentation within the Delfos AI Layer memory system. Each project should have its own directory with an Overview.md file that provides context for AI agents.
14
+
15
+ ## Stack
16
+
17
+ - **Language**: TypeScript
18
+ - **Framework**: Express.js
19
+ - **Database**: PostgreSQL
20
+ - **Cache**: Redis
21
+ - **Queue**: BullMQ
22
+
23
+ ## Key Links
24
+
25
+ - Repository: `https://github.com/example/repo`
26
+ - Documentation: `https://docs.example.com`
27
+ - API Reference: `https://api.example.com/docs`
28
+
29
+ ## Architecture
30
+
31
+ The application follows a vertical slice architecture pattern:
32
+ - `features/` - Contains feature-specific code (routes, handlers, workers)
33
+ - `infrastructure/` - Cross-cutting concerns (database, logging, queue)
34
+ - `shared/` - Shared utilities and types
35
+
36
+ ## AI Memory Integration
37
+
38
+ This project is integrated with Delfos AI Layer for memory context. The AI agents can reference:
39
+ - Technical decisions in `Decisions/`
40
+ - Migration notes in `Migrations/`
41
+ - Session summaries in `Sessions/`
42
+
43
+ Use the Templates/ folder to create consistent documentation for each type of activity.
@@ -0,0 +1,66 @@
1
+ ---
2
+ title: Example Session Summary
3
+ tags:
4
+ - session
5
+ - development
6
+ created: {{date}}
7
+ ---
8
+
9
+ # Development Session: Memory Integration Implementation
10
+
11
+ ## Date & Duration
12
+
13
+ - **Date**: {{date}}
14
+ - **Duration**: 4 hours
15
+ - **Focus**: Implementing Obsidian memory integration
16
+
17
+ ## Objectives
18
+
19
+ 1. Set up memory infrastructure (VaultPathValidator, ObsidianConnectionsRepository)
20
+ 2. Implement vault scaffolding for CLI init command
21
+ 3. Create template vault structure with example content
22
+ 4. Write unit and functional tests
23
+
24
+ ## Progress
25
+
26
+ ### Completed
27
+
28
+ - ✅ VaultPathValidator implementation with security checks
29
+ - ✅ ObsidianConnectionsRepository with Directus integration
30
+ - ✅ MemoryConfig schema and validation
31
+ - ✅ Template vault structure created
32
+ - ✅ Vault scaffolder implementation
33
+ - ✅ CLI command `memory init` implemented
34
+
35
+ ### In Progress
36
+
37
+ - 🔄 Unit tests for vault-scaffolder
38
+ - 🔄 Functional tests for memory init command
39
+
40
+ ### Blocked
41
+
42
+ - None
43
+
44
+ ## Key Decisions Made
45
+
46
+ 1. **Template placeholders**: Using `{{vault_name}}` and `{{date}}` for simple substitution
47
+ 2. **Idempotent scaffolding**: Files are not overwritten if they exist
48
+ 3. **Directus integration**: Using service token for obsidian_connections upserts
49
+
50
+ ## Issues Encountered
51
+
52
+ 1. **Path traversal**: Fixed by checking for `..` segments before path resolution
53
+ 2. **Template encoding**: Used UTF-8 encoding for file operations
54
+
55
+ ## Next Steps
56
+
57
+ 1. Complete test coverage
58
+ 2. Run full validation suite
59
+ 3. Document usage in README
60
+ 4. Create MCP server integration
61
+
62
+ ## Notes for Future Sessions
63
+
64
+ - Consider adding more template examples for different use cases
65
+ - The vault structure should be flexible for user customization
66
+ - Add support for custom template directories in future
@@ -0,0 +1,57 @@
1
+ ---
2
+ title: <!-- Replace with decision title -->
3
+ tags:
4
+ - decision
5
+ - <!-- Add relevant tags -->
6
+ created: {{date}}
7
+ ---
8
+
9
+ # Technical Decision: <!-- Replace with decision title -->
10
+
11
+ ## Context
12
+
13
+ <!-- Describe the problem or situation that led to this decision -->
14
+ <!-- What are we trying to solve? -->
15
+ <!-- What constraints are we working under? -->
16
+
17
+ ## Decision
18
+
19
+ <!-- State the decision clearly -->
20
+ <!-- What did we choose? -->
21
+
22
+ ## Trade-offs
23
+
24
+ **Pros:**
25
+ <!-- List advantages -->
26
+ <!-- Why is this a good choice? -->
27
+
28
+ **Cons:**
29
+ <!-- List disadvantages -->
30
+ <!-- What are the downsides? -->
31
+
32
+ ## Implementation Details
33
+
34
+ <!-- How will this be implemented? -->
35
+ <!-- Code snippets, configuration changes, etc. -->
36
+
37
+ ## Alternatives Considered
38
+
39
+ <!-- What other options did we evaluate? -->
40
+ <!-- Why did we reject them? -->
41
+
42
+ - **Alternative 1**: Reason for rejection
43
+ - **Alternative 2**: Reason for rejection
44
+ - **Alternative 3**: Reason for rejection
45
+
46
+ ## Status
47
+
48
+ <!-- One of: Proposed, Approved, Implemented, Deprecated -->
49
+ **Status**: Proposed
50
+
51
+ ## Related Links
52
+
53
+ <!-- Links to relevant documentation, issues, PRs -->
54
+ <!-- Example: -->
55
+ <!-- - Issue: #[number] -->
56
+ <!-- - PR: #[number] -->
57
+ <!-- - Documentation: [URL] -->
@@ -0,0 +1,86 @@
1
+ ---
2
+ title: <!-- Replace with migration title -->
3
+ tags:
4
+ - migration
5
+ - <!-- Add relevant tags -->
6
+ created: {{date}}
7
+ ---
8
+
9
+ # Migration: <!-- Replace with migration title -->
10
+
11
+ ## Overview
12
+
13
+ <!-- Brief description of what this migration does -->
14
+ <!-- Why is it needed? -->
15
+
16
+ ## Version
17
+
18
+ - **From**: <!-- Current version -->
19
+ - **To**: <!-- Target version -->
20
+
21
+ ## Breaking Changes
22
+
23
+ <!-- List any breaking changes -->
24
+ <!-- What will break? What needs to be updated? -->
25
+
26
+ 1. **Change 1**: Description
27
+ 2. **Change 2**: Description
28
+ 3. **Change 3**: Description
29
+
30
+ ## Migration Steps
31
+
32
+ <!-- Step-by-step instructions for performing the migration -->
33
+ <!-- Include code examples, commands, etc. -->
34
+
35
+ ### Step 1: <!-- Step title -->
36
+
37
+ <!-- Description and code -->
38
+
39
+ ### Step 2: <!-- Step title -->
40
+
41
+ <!-- Description and code -->
42
+
43
+ ### Step 3: <!-- Step title -->
44
+
45
+ <!-- Description and code -->
46
+
47
+ ## Testing
48
+
49
+ <!-- How to verify the migration worked -->
50
+ <!-- Test commands, manual checks, etc. -->
51
+
52
+ - [ ] Test 1
53
+ - [ ] Test 2
54
+ - [ ] Test 3
55
+
56
+ ## Rollback Plan
57
+
58
+ <!-- If something goes wrong, how to revert -->
59
+ <!-- Step-by-step rollback instructions -->
60
+
61
+ 1. <!-- Rollback step 1 -->
62
+ 2. <!-- Rollback step 2 -->
63
+ 3. <!-- Rollback step 3 -->
64
+
65
+ ## Data Changes
66
+
67
+ <!-- Any database schema changes? -->
68
+ <!-- Any data transformations? -->
69
+ <!-- Are they reversible? -->
70
+
71
+ ## Performance Impact
72
+
73
+ <!-- Will this affect performance? -->
74
+ <!-- How to measure? -->
75
+
76
+ ## Status
77
+
78
+ <!-- One of: Planned, In Progress, Completed, Rolled Back -->
79
+ **Status**: Planned
80
+
81
+ ## Related
82
+
83
+ <!-- Link to related decisions, issues, PRs -->
84
+ <!-- Example: -->
85
+ <!-- - Decision: [[decision-link]] -->
86
+ <!-- - Issue: #[number] -->
@@ -0,0 +1,87 @@
1
+ ---
2
+ title: <!-- Replace with session title -->
3
+ tags:
4
+ - session
5
+ - <!-- Add relevant tags -->
6
+ created: {{date}}
7
+ ---
8
+
9
+ # Development Session: <!-- Replace with session title -->
10
+
11
+ ## Date & Duration
12
+
13
+ - **Date**: {{date}}
14
+ - **Duration**: <!-- e.g., 4 hours -->
15
+ - **Focus**: <!-- Main focus of this session -->
16
+
17
+ ## Objectives
18
+
19
+ <!-- What did you set out to accomplish? -->
20
+
21
+ 1. <!-- Objective 1 -->
22
+ 2. <!-- Objective 2 -->
23
+ 3. <!-- Objective 3 -->
24
+
25
+ ## Progress
26
+
27
+ ### Completed
28
+
29
+ <!-- What got done? -->
30
+ - ✅ <!-- Completed item 1 -->
31
+ - ✅ <!-- Completed item 2 -->
32
+
33
+ ### In Progress
34
+
35
+ <!-- What's still being worked on? -->
36
+ - 🔄 <!-- In progress item 1 -->
37
+ - 🔄 <!-- In progress item 2 -->
38
+
39
+ ### Blocked
40
+
41
+ <!-- What's blocking progress? -->
42
+ - 🚫 <!-- Blocked item 1 -->
43
+ - 🚫 <!-- Blocked item 2 -->
44
+
45
+ ## Key Decisions Made
46
+
47
+ <!-- Important decisions made during this session -->
48
+ <!-- Why were they made? -->
49
+
50
+ 1. <!-- Decision 1 and rationale -->
51
+ 2. <!-- Decision 2 and rationale -->
52
+
53
+ ## Issues Encountered
54
+
55
+ <!-- Problems that came up -->
56
+ <!-- How were they resolved? -->
57
+
58
+ 1. **Issue**: Description
59
+ - **Resolution**: How it was fixed
60
+
61
+ 2. **Issue**: Description
62
+ - **Resolution**: How it was fixed
63
+
64
+ ## Next Steps
65
+
66
+ <!-- What needs to be done next? -->
67
+ <!-- What should be the focus of the next session? -->
68
+
69
+ 1. <!-- Next step 1 -->
70
+ 2. <!-- Next step 2 -->
71
+
72
+ ## Notes for Future Sessions
73
+
74
+ <!-- Any context that would be helpful for future work -->
75
+ <!-- Links to relevant documentation, decisions, etc. -->
76
+
77
+ <!-- Example notes: -->
78
+ <!-- - Remember to check the decision log for context on X -->
79
+ <!-- - The Y component needs refactoring before we can add Z -->
80
+ <!-- - See migration note for database schema changes -->
81
+
82
+ ## Related
83
+
84
+ <!-- Link to related work -->
85
+ <!-- Example: -->
86
+ <!-- - Previous session: [[session-link]] -->
87
+ <!-- - Related decision: [[decision-link]] -->