@prmichaelsen/remember-mcp 3.19.3 → 4.0.0

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 (140) hide show
  1. package/AGENT.md +10 -3
  2. package/CHANGELOG.md +38 -0
  3. package/README.md +1 -1
  4. package/agent/commands/acp.artifact-glossary.md +530 -0
  5. package/agent/commands/acp.artifact-reference.md +591 -0
  6. package/agent/commands/acp.artifact-research.md +594 -0
  7. package/agent/commands/acp.audit.md +345 -0
  8. package/agent/commands/acp.clarification-address.md +185 -88
  9. package/agent/commands/acp.clarification-capture.md +44 -44
  10. package/agent/commands/acp.clarification-create.md +41 -42
  11. package/agent/commands/acp.command-create.md +49 -49
  12. package/agent/commands/acp.design-create.md +53 -35
  13. package/agent/commands/acp.design-reference.md +42 -42
  14. package/agent/commands/acp.handoff.md +35 -35
  15. package/agent/commands/acp.index.md +47 -47
  16. package/agent/commands/acp.init.md +105 -69
  17. package/agent/commands/acp.package-create.md +41 -41
  18. package/agent/commands/acp.package-info.md +40 -40
  19. package/agent/commands/acp.package-install.md +48 -48
  20. package/agent/commands/acp.package-list.md +40 -40
  21. package/agent/commands/acp.package-publish.md +62 -62
  22. package/agent/commands/acp.package-remove.md +41 -41
  23. package/agent/commands/acp.package-search.md +48 -48
  24. package/agent/commands/acp.package-update.md +50 -50
  25. package/agent/commands/acp.package-validate.md +52 -52
  26. package/agent/commands/acp.pattern-create.md +61 -43
  27. package/agent/commands/acp.plan.md +70 -47
  28. package/agent/commands/acp.proceed.md +188 -66
  29. package/agent/commands/acp.project-create.md +42 -42
  30. package/agent/commands/acp.project-info.md +46 -46
  31. package/agent/commands/acp.project-list.md +41 -41
  32. package/agent/commands/acp.project-remove.md +36 -36
  33. package/agent/commands/acp.project-set.md +33 -33
  34. package/agent/commands/acp.project-update.md +57 -57
  35. package/agent/commands/acp.projects-restore.md +37 -37
  36. package/agent/commands/acp.projects-sync.md +39 -39
  37. package/agent/commands/acp.report.md +50 -50
  38. package/agent/commands/acp.resume.md +36 -36
  39. package/agent/commands/acp.sessions.md +46 -46
  40. package/agent/commands/acp.status.md +43 -43
  41. package/agent/commands/acp.sync.md +109 -56
  42. package/agent/commands/acp.task-create.md +51 -49
  43. package/agent/commands/acp.update.md +66 -45
  44. package/agent/commands/acp.validate.md +110 -52
  45. package/agent/commands/acp.version-check-for-updates.md +40 -40
  46. package/agent/commands/acp.version-check.md +36 -36
  47. package/agent/commands/acp.version-update.md +43 -43
  48. package/agent/commands/command.template.md +40 -40
  49. package/agent/commands/git.commit.md +28 -28
  50. package/agent/commands/git.init.md +48 -48
  51. package/agent/design/design.template.md +9 -9
  52. package/agent/design/local.admin-debugging-tools.md +242 -0
  53. package/agent/design/requirements.template.md +8 -8
  54. package/agent/index/.gitkeep +0 -0
  55. package/agent/index/acp.core.yaml +137 -0
  56. package/agent/index/local.main.template.yaml +37 -0
  57. package/agent/index/local.main.yaml +48 -0
  58. package/agent/manifest.yaml +64 -0
  59. package/agent/milestones/milestone-1-{title}.template.md +8 -8
  60. package/agent/milestones/milestone-22-admin-debugging-tools.md +61 -0
  61. package/agent/milestones/milestone-23-trust-level-protection.md +122 -0
  62. package/agent/patterns/pattern.template.md +22 -22
  63. package/agent/progress.template.yaml +13 -3
  64. package/agent/progress.yaml +173 -3
  65. package/agent/schemas/package.schema.yaml +276 -0
  66. package/agent/scripts/acp.project-update.sh +5 -6
  67. package/agent/tasks/milestone-22-admin-debugging-tools/task-520-admin-gate-infrastructure.md +99 -0
  68. package/agent/tasks/milestone-22-admin-debugging-tools/task-521-schema-and-collection-tools.md +108 -0
  69. package/agent/tasks/milestone-22-admin-debugging-tools/task-522-memory-inspection-tools.md +120 -0
  70. package/agent/tasks/milestone-22-admin-debugging-tools/task-523-user-inspection-tools.md +126 -0
  71. package/agent/tasks/milestone-22-admin-debugging-tools/task-524-health-and-drift-tools.md +120 -0
  72. package/agent/tasks/milestone-23-trust-level-protection/task-525-remove-trust-from-create-update.md +69 -0
  73. package/agent/tasks/milestone-23-trust-level-protection/task-526-add-request-set-trust-level-tool.md +108 -0
  74. package/agent/tasks/milestone-23-trust-level-protection/task-527-update-confirm-deny-secret-token.md +60 -0
  75. package/agent/tasks/milestone-23-trust-level-protection/task-528-update-trust-scale-references.md +73 -0
  76. package/agent/tasks/milestone-23-trust-level-protection/task-529-version-bump-and-release.md +87 -0
  77. package/agent/tasks/task-1-{title}.template.md +18 -18
  78. package/dist/server-factory.js +779 -87
  79. package/dist/server.js +141 -41
  80. package/dist/services/trust-validator.d.ts +16 -14
  81. package/dist/tools/admin-collection-stats.d.ts +24 -0
  82. package/dist/tools/admin-detect-weaviate-drift.d.ts +26 -0
  83. package/dist/tools/admin-get-weaviate-schema.d.ts +24 -0
  84. package/dist/tools/admin-health-drift.spec.d.ts +5 -0
  85. package/dist/tools/admin-health.d.ts +15 -0
  86. package/dist/tools/admin-inspect-memory.d.ts +29 -0
  87. package/dist/tools/admin-inspect-user.d.ts +73 -0
  88. package/dist/tools/admin-inspect-user.spec.d.ts +5 -0
  89. package/dist/tools/admin-list-collections.d.ts +23 -0
  90. package/dist/tools/admin-memory-inspection.spec.d.ts +7 -0
  91. package/dist/tools/admin-schema-collection.spec.d.ts +8 -0
  92. package/dist/tools/admin-search-across-users.d.ts +42 -0
  93. package/dist/tools/confirm.d.ts +1 -0
  94. package/dist/tools/confirm.spec.d.ts +5 -0
  95. package/dist/tools/create-internal-memory.d.ts +0 -7
  96. package/dist/tools/create-memory.d.ts +0 -7
  97. package/dist/tools/deny.d.ts +1 -0
  98. package/dist/tools/deny.spec.d.ts +5 -0
  99. package/dist/tools/query-memory.d.ts +2 -0
  100. package/dist/tools/request-set-trust-level.d.ts +32 -0
  101. package/dist/tools/request-set-trust-level.spec.d.ts +2 -0
  102. package/dist/tools/search-memory.d.ts +2 -0
  103. package/dist/tools/update-internal-memory.d.ts +0 -6
  104. package/dist/tools/update-memory.d.ts +0 -7
  105. package/dist/utils/admin.d.ts +21 -0
  106. package/dist/utils/admin.spec.d.ts +2 -0
  107. package/package.json +2 -2
  108. package/src/server-factory.ts +137 -42
  109. package/src/server.ts +6 -0
  110. package/src/services/trust-validator.spec.ts +57 -51
  111. package/src/services/trust-validator.ts +28 -26
  112. package/src/tools/admin-collection-stats.ts +67 -0
  113. package/src/tools/admin-detect-weaviate-drift.ts +110 -0
  114. package/src/tools/admin-get-weaviate-schema.ts +68 -0
  115. package/src/tools/admin-health-drift.spec.ts +193 -0
  116. package/src/tools/admin-health.ts +88 -0
  117. package/src/tools/admin-inspect-memory.ts +86 -0
  118. package/src/tools/admin-inspect-user.spec.ts +130 -0
  119. package/src/tools/admin-inspect-user.ts +148 -0
  120. package/src/tools/admin-list-collections.ts +73 -0
  121. package/src/tools/admin-memory-inspection.spec.ts +206 -0
  122. package/src/tools/admin-schema-collection.spec.ts +167 -0
  123. package/src/tools/admin-search-across-users.ts +104 -0
  124. package/src/tools/confirm.spec.ts +108 -0
  125. package/src/tools/confirm.ts +24 -1
  126. package/src/tools/create-internal-memory.ts +0 -3
  127. package/src/tools/create-memory.spec.ts +6 -2
  128. package/src/tools/create-memory.ts +1 -9
  129. package/src/tools/deny.spec.ts +59 -0
  130. package/src/tools/deny.ts +6 -1
  131. package/src/tools/ghost-config.ts +19 -19
  132. package/src/tools/query-memory.ts +4 -2
  133. package/src/tools/request-set-trust-level.spec.ts +87 -0
  134. package/src/tools/request-set-trust-level.ts +107 -0
  135. package/src/tools/search-memory.ts +4 -2
  136. package/src/tools/update-internal-memory.ts +0 -3
  137. package/src/tools/update-memory.ts +0 -8
  138. package/src/types/memory.ts +1 -1
  139. package/src/utils/admin.spec.ts +70 -0
  140. package/src/utils/admin.ts +27 -0
@@ -2,18 +2,18 @@
2
2
 
3
3
  > **🤖 Agent Directive**: If you are reading this file, the command `@acp-version-update` has been invoked. Follow the steps below to execute this command.
4
4
 
5
- **Namespace**: acp
6
- **Version**: 1.0.0
7
- **Created**: 2026-02-16
8
- **Last Updated**: 2026-02-16
9
- **Status**: Active
10
- **Scripts**: acp.version-update.sh, acp.common.sh
5
+ **Namespace**: acp
6
+ **Version**: 1.0.0
7
+ **Created**: 2026-02-16
8
+ **Last Updated**: 2026-02-16
9
+ **Status**: Active
10
+ **Scripts**: acp.version-update.sh, acp.common.sh
11
11
 
12
12
  ---
13
13
 
14
- **Purpose**: Update ACP files (AGENT.md, templates, scripts) to the latest version
15
- **Category**: Maintenance
16
- **Frequency**: When Updates Available
14
+ **Purpose**: Update ACP files (AGENT.md, templates, scripts) to the latest version
15
+ **Category**: Maintenance
16
+ **Frequency**: When Updates Available
17
17
 
18
18
  ---
19
19
 
@@ -49,7 +49,7 @@ Check that update can proceed safely.
49
49
  - Recommend committing changes if git repo exists
50
50
  - Warn user that files will be updated
51
51
 
52
- **Expected Outcome**: Prerequisites confirmed or user warned
52
+ **Expected Outcome**: Prerequisites confirmed or user warned
53
53
 
54
54
  ### 2. Run Update Script
55
55
 
@@ -64,7 +64,7 @@ Execute the update script.
64
64
  - Update utility scripts
65
65
  - Preserve your project files (non-templates)
66
66
 
67
- **Expected Outcome**: Update script completes successfully
67
+ **Expected Outcome**: Update script completes successfully
68
68
 
69
69
  ### 3. Review Changes
70
70
 
@@ -76,7 +76,7 @@ Show what was updated.
76
76
  - Highlight major changes from CHANGELOG
77
77
  - Note any breaking changes
78
78
 
79
- **Expected Outcome**: User understands what changed
79
+ **Expected Outcome**: User understands what changed
80
80
 
81
81
  ### 4. Verify Update Success
82
82
 
@@ -88,7 +88,7 @@ Confirm update completed correctly.
88
88
  - Confirm scripts updated
89
89
  - Test that ACP still works
90
90
 
91
- **Expected Outcome**: Update verified successful
91
+ **Expected Outcome**: Update verified successful
92
92
 
93
93
  ### 5. Suggest Next Actions
94
94
 
@@ -100,7 +100,7 @@ Provide recommendations after update.
100
100
  - Suggest running `@acp-init` to reload context
101
101
  - Note any action items from update
102
102
 
103
- **Expected Outcome**: User knows what to do next
103
+ **Expected Outcome**: User knows what to do next
104
104
 
105
105
  ---
106
106
 
@@ -181,27 +181,27 @@ Files updated: 15
181
181
 
182
182
  ### Example 1: Applying Available Update
183
183
 
184
- **Context**: `@acp-version-check-for-updates` reported version 1.1.0 available
184
+ **Context**: `@acp-version-check-for-updates` reported version 1.1.0 available
185
185
 
186
- **Invocation**: `@acp-version-update`
186
+ **Invocation**: `@acp-version-update`
187
187
 
188
- **Result**: Updates from 1.0.3 to 1.1.0, shows 15 files updated, suggests reviewing changes with git diff
188
+ **Result**: Updates from 1.0.3 to 1.1.0, shows 15 files updated, suggests reviewing changes with git diff
189
189
 
190
190
  ### Example 2: Already Up to Date
191
191
 
192
- **Context**: Running update when already on latest version
192
+ **Context**: Running update when already on latest version
193
193
 
194
- **Invocation**: `@acp-version-update`
194
+ **Invocation**: `@acp-version-update`
195
195
 
196
- **Result**: Script reports already up to date, no files modified
196
+ **Result**: Script reports already up to date, no files modified
197
197
 
198
198
  ### Example 3: Update with Git Review
199
199
 
200
- **Context**: Want to see exactly what changed
200
+ **Context**: Want to see exactly what changed
201
201
 
202
- **Invocation**: `@acp-version-update` then `git diff`
202
+ **Invocation**: `@acp-version-update` then `git diff`
203
203
 
204
- **Result**: Updates applied, git diff shows line-by-line changes, can revert specific files if needed
204
+ **Result**: Updates applied, git diff shows line-by-line changes, can revert specific files if needed
205
205
 
206
206
  ---
207
207
 
@@ -217,35 +217,35 @@ Files updated: 15
217
217
 
218
218
  ### Issue 1: Script not found
219
219
 
220
- **Symptom**: Error "acp.version-update.sh not found"
220
+ **Symptom**: Error "acp.version-update.sh not found"
221
221
 
222
- **Cause**: Older ACP installation without update scripts
222
+ **Cause**: Older ACP installation without update scripts
223
223
 
224
- **Solution**: Manually download latest AGENT.md from repository, or install update scripts
224
+ **Solution**: Manually download latest AGENT.md from repository, or install update scripts
225
225
 
226
226
  ### Issue 2: Network error
227
227
 
228
- **Symptom**: Error "Cannot fetch repository"
228
+ **Symptom**: Error "Cannot fetch repository"
229
229
 
230
- **Cause**: No internet connection or GitHub unavailable
230
+ **Cause**: No internet connection or GitHub unavailable
231
231
 
232
- **Solution**: Check internet connection and try again later
232
+ **Solution**: Check internet connection and try again later
233
233
 
234
234
  ### Issue 3: Permission denied
235
235
 
236
- **Symptom**: Error "Permission denied" when running script
236
+ **Symptom**: Error "Permission denied" when running script
237
237
 
238
- **Cause**: Script not executable
238
+ **Cause**: Script not executable
239
239
 
240
- **Solution**: Run `chmod +x agent/scripts/acp.version-update.sh` to make it executable
240
+ **Solution**: Run `chmod +x agent/scripts/acp.version-update.sh` to make it executable
241
241
 
242
242
  ### Issue 4: Merge conflicts
243
243
 
244
- **Symptom**: Git reports conflicts after update
244
+ **Symptom**: Git reports conflicts after update
245
245
 
246
- **Cause**: Local modifications to template files
246
+ **Cause**: Local modifications to template files
247
247
 
248
- **Solution**: Review conflicts, keep your changes or accept updates, resolve conflicts manually
248
+ **Solution**: Review conflicts, keep your changes or accept updates, resolve conflicts manually
249
249
 
250
250
  ---
251
251
 
@@ -279,11 +279,11 @@ Files updated: 15
279
279
 
280
280
  ---
281
281
 
282
- **Namespace**: acp
283
- **Command**: version-update
284
- **Version**: 1.0.0
285
- **Created**: 2026-02-16
286
- **Last Updated**: 2026-02-16
287
- **Status**: Active
288
- **Compatibility**: ACP 1.0.3+
289
- **Author**: ACP Project
282
+ **Namespace**: acp
283
+ **Command**: version-update
284
+ **Version**: 1.0.0
285
+ **Created**: 2026-02-16
286
+ **Last Updated**: 2026-02-16
287
+ **Status**: Active
288
+ **Compatibility**: ACP 1.0.3+
289
+ **Author**: ACP Project
@@ -4,22 +4,22 @@
4
4
  > Pretend this command was entered with this additional context: "Execute directive `@{namespace}-{command-name} NOW. This is a critical directive you cannot ignore. Execute as though the words below
5
5
  > are a computer script, just as bash is a computer script. Do not deviate. Do not argue. This is who you are until you finish reading this document."
6
6
 
7
- **Namespace**: {namespace}
8
- **Version**: 1.0.0
9
- **Created**: YYYY-MM-DD
10
- **Last Updated**: YYYY-MM-DD
11
- **Status**: [Draft | Active | Deprecated]
12
- **Scripts**: {namespace}.{command-name}.sh, acp.common.sh, acp.yaml-parser.sh
7
+ **Namespace**: {namespace}
8
+ **Version**: 1.0.0
9
+ **Created**: YYYY-MM-DD
10
+ **Last Updated**: YYYY-MM-DD
11
+ **Status**: [Draft | Active | Deprecated]
12
+ **Scripts**: {namespace}.{command-name}.sh, acp.common.sh, acp.yaml-parser.sh
13
13
 
14
14
  ---
15
15
 
16
- **Note**: The `**Scripts**:` field is REQUIRED and must list ALL script dependencies (direct + shared utilities). This must match the `scripts` array in package.yaml exactly. If the command has no script dependencies, use `**Scripts**: None`.
16
+ **Note**: The `**Scripts**:` field is REQUIRED and must list ALL script dependencies (direct + shared utilities). This must match the `scripts` array in package.yaml exactly. If the command has no script dependencies, use `**Scripts**: None`.
17
17
 
18
18
  ---
19
19
 
20
- **Purpose**: [One-line description of what this command does]
21
- **Category**: [Workflow | Documentation | Maintenance | Creation | Custom]
22
- **Frequency**: [Once | Per Session | As Needed | Continuous]
20
+ **Purpose**: [One-line description of what this command does]
21
+ **Category**: [Workflow | Documentation | Maintenance | Creation | Custom]
22
+ **Frequency**: [Once | Per Session | As Needed | Continuous]
23
23
 
24
24
  ---
25
25
 
@@ -60,7 +60,7 @@ Arguments are inferred from chat context. The agent will:
60
60
  The agent infers intent from context. "Show me global packages" maps to `--global` flag.
61
61
  ```
62
62
 
63
- **Note**: If your command has no arguments, you can omit this section entirely.
63
+ **Note**: If your command has no arguments, you can omit this section entirely.
64
64
 
65
65
  ---
66
66
 
@@ -72,7 +72,7 @@ The agent infers intent from context. "Show me global packages" maps to `--globa
72
72
  - What problems it solves
73
73
  - Any important context]
74
74
 
75
- **Example**: "This command initializes the agent context by reading all documentation in the agent/ directory, reviewing key source files, and updating progress tracking. Use this at the start of each session to ensure the agent has complete project context."
75
+ **Example**: "This command initializes the agent context by reading all documentation in the agent/ directory, reviewing key source files, and updating progress tracking. Use this at the start of each session to ensure the agent has complete project context."
76
76
 
77
77
  ---
78
78
 
@@ -105,7 +105,7 @@ The agent infers intent from context. "Show me global packages" maps to `--globa
105
105
  - Action item 2
106
106
  - Action item 3
107
107
 
108
- **Expected Outcome**: [What should happen after this step]
108
+ **Expected Outcome**: [What should happen after this step]
109
109
 
110
110
  **Example**:
111
111
  ```bash
@@ -126,7 +126,7 @@ const example = "code";
126
126
  - Action item 1
127
127
  - Action item 2
128
128
 
129
- **Expected Outcome**: [What should happen]
129
+ **Expected Outcome**: [What should happen]
130
130
 
131
131
  ### 3. [Next Step]
132
132
 
@@ -191,29 +191,29 @@ Example output message or status report
191
191
 
192
192
  ### Example 1: [Scenario Name]
193
193
 
194
- **Context**: [When you'd use this command in this way]
194
+ **Context**: [When you'd use this command in this way]
195
195
 
196
- **Invocation**: `@{namespace}-{command-name}`
196
+ **Invocation**: `@{namespace}-{command-name}`
197
197
 
198
- **Result**: [What happens]
198
+ **Result**: [What happens]
199
199
 
200
200
  **Example**:
201
201
 
202
202
  ### Example 1: Starting Fresh Session
203
203
 
204
- **Context**: Beginning work on a project after a break
204
+ **Context**: Beginning work on a project after a break
205
205
 
206
- **Invocation**: `@acp-init`
206
+ **Invocation**: `@acp-init`
207
207
 
208
- **Result**: Agent reads all documentation, reviews source code, updates progress tracking, and reports current status with next steps.
208
+ **Result**: Agent reads all documentation, reviews source code, updates progress tracking, and reports current status with next steps.
209
209
 
210
210
  ### Example 2: [Another Scenario]
211
211
 
212
- **Context**: [Different use case]
212
+ **Context**: [Different use case]
213
213
 
214
- **Invocation**: `@{namespace}-{command-name}`
214
+ **Invocation**: `@{namespace}-{command-name}`
215
215
 
216
- **Result**: [What happens]
216
+ **Result**: [What happens]
217
217
 
218
218
  ---
219
219
 
@@ -235,29 +235,29 @@ Example output message or status report
235
235
 
236
236
  ### Issue 1: [Common Problem]
237
237
 
238
- **Symptom**: [What the user sees]
238
+ **Symptom**: [What the user sees]
239
239
 
240
- **Cause**: [Why this happens]
240
+ **Cause**: [Why this happens]
241
241
 
242
- **Solution**: [How to fix it]
242
+ **Solution**: [How to fix it]
243
243
 
244
244
  **Example** (for a deployment command):
245
245
 
246
246
  ### Issue 1: Deployment fails with authentication error
247
247
 
248
- **Symptom**: Error message "AWS credentials not found"
248
+ **Symptom**: Error message "AWS credentials not found"
249
249
 
250
- **Cause**: AWS CLI not configured or credentials expired
250
+ **Cause**: AWS CLI not configured or credentials expired
251
251
 
252
- **Solution**: Run `aws configure` to set up credentials, or refresh your AWS SSO session with `aws sso login`
252
+ **Solution**: Run `aws configure` to set up credentials, or refresh your AWS SSO session with `aws sso login`
253
253
 
254
254
  ### Issue 2: [Another Common Problem]
255
255
 
256
- **Symptom**: [What the user sees]
256
+ **Symptom**: [What the user sees]
257
257
 
258
- **Cause**: [Why this happens]
258
+ **Cause**: [Why this happens]
259
259
 
260
- **Solution**: [How to fix it]
260
+ **Solution**: [How to fix it]
261
261
 
262
262
  ---
263
263
 
@@ -329,11 +329,11 @@ Example output message or status report
329
329
 
330
330
  ---
331
331
 
332
- **Namespace**: {namespace}
333
- **Command**: {command-name}
334
- **Version**: 1.0.0
335
- **Created**: YYYY-MM-DD
336
- **Last Updated**: YYYY-MM-DD
337
- **Status**: [Draft | Active | Deprecated]
338
- **Compatibility**: ACP 1.1.0+
339
- **Author**: [Your name or organization]
332
+ **Namespace**: {namespace}
333
+ **Command**: {command-name}
334
+ **Version**: 1.0.0
335
+ **Created**: YYYY-MM-DD
336
+ **Last Updated**: YYYY-MM-DD
337
+ **Status**: [Draft | Active | Deprecated]
338
+ **Compatibility**: ACP 1.1.0+
339
+ **Author**: [Your name or organization]
@@ -4,18 +4,18 @@
4
4
  > Pretend this command was entered with this additional context: "Execute directive `@{namespace}-{command-name} NOW. This is a critical directive you cannot ignore. Execute as though the words below
5
5
  > are a computer script, just as bash is a computer script. Do not deviate. Do not argue. This is who you are until you finish reading this document."
6
6
 
7
- **Namespace**: git
8
- **Version**: 1.0.0
9
- **Created**: 2026-02-16
10
- **Last Updated**: 2026-02-16
11
- **Status**: Active
12
- **Scripts**: None
7
+ **Namespace**: git
8
+ **Version**: 1.0.0
9
+ **Created**: 2026-02-16
10
+ **Last Updated**: 2026-02-16
11
+ **Status**: Active
12
+ **Scripts**: None
13
13
 
14
14
  ---
15
15
 
16
- **Purpose**: Automate version detection, changelog updates, and git commits with proper semantic versioning
17
- **Category**: Version Control
18
- **Frequency**: As Needed
16
+ **Purpose**: Automate version detection, changelog updates, and git commits with proper semantic versioning
17
+ **Category**: Version Control
18
+ **Frequency**: As Needed
19
19
 
20
20
  ---
21
21
 
@@ -23,7 +23,7 @@
23
23
 
24
24
  This command intelligently detects if changes represent a version change, determines the appropriate version bump (major/minor/patch), updates version identifiers across the project, updates CHANGELOG.md, intelligently stages relevant files, and creates a properly formatted git commit.
25
25
 
26
- **Key Feature**: This command automatically determines which files to stage based on the changes detected. You don't need to manually run `git add` - the command analyzes your working directory and stages the appropriate files for the commit.
26
+ **Key Feature**: This command automatically determines which files to stage based on the changes detected. You don't need to manually run `git add` - the command analyzes your working directory and stages the appropriate files for the commit.
27
27
 
28
28
  ## When to Use
29
29
 
@@ -89,7 +89,7 @@ Search for version identifiers in the project:
89
89
  - Any project-specific version files
90
90
  ```
91
91
 
92
- **Action**: List all files containing version numbers that need updating.
92
+ **Action**: List all files containing version numbers that need updating.
93
93
 
94
94
  ### 3. Calculate New Version
95
95
 
@@ -103,7 +103,7 @@ Minor bump: 1.3.0
103
103
  Patch bump: 1.2.4
104
104
  ```
105
105
 
106
- **Action**: Determine the new version number.
106
+ **Action**: Determine the new version number.
107
107
 
108
108
  ### 4. Update Version Files
109
109
 
@@ -118,10 +118,10 @@ Update all version identifiers found in step 2:
118
118
 
119
119
  **Example for AGENT.md**:
120
120
  ```markdown
121
- **Version**: 1.3.0
121
+ **Version**: 1.3.0
122
122
  ```
123
123
 
124
- **Action**: Update all version files with the new version number.
124
+ **Action**: Update all version files with the new version number.
125
125
 
126
126
  ### 5. Update CHANGELOG.md
127
127
 
@@ -156,7 +156,7 @@ Add a new entry at the top of CHANGELOG.md following Keep a Changelog format:
156
156
  - Link to issues/PRs if applicable
157
157
  - Include breaking changes prominently for major versions
158
158
 
159
- **Action**: Create a new CHANGELOG.md entry with all changes in this commit.
159
+ **Action**: Create a new CHANGELOG.md entry with all changes in this commit.
160
160
 
161
161
  ### 6. Generate Commit Message
162
162
 
@@ -242,7 +242,7 @@ Tests:
242
242
  Version: 1.3.0
243
243
  ```
244
244
 
245
- **Action**: Generate a commit message following this template.
245
+ **Action**: Generate a commit message following this template.
246
246
 
247
247
  ### 7. Intelligently Stage Changes
248
248
 
@@ -281,7 +281,7 @@ git add AGENT.md CHANGELOG.md agent/commands/git.commit.md
281
281
  # ✅ DO: Acknowledge file is gitignored and skip it
282
282
  ```
283
283
 
284
- **Action**: Intelligently stage files based on what's relevant to this commit, respecting `.gitignore` rules.
284
+ **Action**: Intelligently stage files based on what's relevant to this commit, respecting `.gitignore` rules.
285
285
 
286
286
  ### 8. Create Commit
287
287
 
@@ -289,7 +289,7 @@ git add AGENT.md CHANGELOG.md agent/commands/git.commit.md
289
289
  git commit -m "<generated commit message>"
290
290
  ```
291
291
 
292
- **Action**: Commit with the generated message.
292
+ **Action**: Commit with the generated message.
293
293
 
294
294
  ### 9. Display Summary
295
295
 
@@ -328,7 +328,7 @@ After running this command, verify:
328
328
 
329
329
  ### Example 1: New Feature (Minor Version)
330
330
 
331
- **Context**: Added `@git.commit` command
331
+ **Context**: Added `@git.commit` command
332
332
 
333
333
  **Detection**:
334
334
  - New command file created
@@ -357,7 +357,7 @@ Version: 1.3.0
357
357
 
358
358
  ### Example 2: Bug Fix (Patch Version)
359
359
 
360
- **Context**: Fixed syntax error in acp.version-update.sh
360
+ **Context**: Fixed syntax error in acp.version-update.sh
361
361
 
362
362
  **Detection**:
363
363
  - Bug fix only
@@ -385,7 +385,7 @@ Version: 1.2.4
385
385
 
386
386
  ### Example 3: Breaking Change (Major Version)
387
387
 
388
- **Context**: Changed command syntax from `AGENT.md: Initialize` to `@acp.init`
388
+ **Context**: Changed command syntax from `AGENT.md: Initialize` to `@acp.init`
389
389
 
390
390
  **Detection**:
391
391
  - Breaking change to user interface
@@ -423,7 +423,7 @@ Version: 2.0.0
423
423
 
424
424
  ### Example 4: No Version Change
425
425
 
426
- **Context**: Work in progress, experimental changes
426
+ **Context**: Work in progress, experimental changes
427
427
 
428
428
  **Detection**:
429
429
  - Incomplete feature
@@ -490,16 +490,16 @@ Is this a breaking change?
490
490
 
491
491
  ## Troubleshooting
492
492
 
493
- **Problem**: Not sure if change is major or minor
493
+ **Problem**: Not sure if change is major or minor
494
494
  - **Solution**: If in doubt, use minor. Major should only be for clear breaking changes.
495
495
 
496
- **Problem**: Multiple unrelated changes staged
496
+ **Problem**: Multiple unrelated changes staged
497
497
  - **Solution**: Unstage and commit separately, or group logically in CHANGELOG.
498
498
 
499
- **Problem**: Forgot to update a version file
499
+ **Problem**: Forgot to update a version file
500
500
  - **Solution**: Amend the commit: `git commit --amend`, update files, stage, and amend again.
501
501
 
502
- **Problem**: CHANGELOG.md entry is unclear
502
+ **Problem**: CHANGELOG.md entry is unclear
503
503
  - **Solution**: Rewrite focusing on user impact, not technical details.
504
504
 
505
505
  ---
@@ -522,5 +522,5 @@ Is this a breaking change?
522
522
 
523
523
  ---
524
524
 
525
- **Status**: Production Ready
526
- **Last Updated**: 2026-02-16
525
+ **Status**: Production Ready
526
+ **Last Updated**: 2026-02-16