@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.
- package/AGENT.md +10 -3
- package/CHANGELOG.md +38 -0
- package/README.md +1 -1
- package/agent/commands/acp.artifact-glossary.md +530 -0
- package/agent/commands/acp.artifact-reference.md +591 -0
- package/agent/commands/acp.artifact-research.md +594 -0
- package/agent/commands/acp.audit.md +345 -0
- package/agent/commands/acp.clarification-address.md +185 -88
- package/agent/commands/acp.clarification-capture.md +44 -44
- package/agent/commands/acp.clarification-create.md +41 -42
- package/agent/commands/acp.command-create.md +49 -49
- package/agent/commands/acp.design-create.md +53 -35
- package/agent/commands/acp.design-reference.md +42 -42
- package/agent/commands/acp.handoff.md +35 -35
- package/agent/commands/acp.index.md +47 -47
- package/agent/commands/acp.init.md +105 -69
- package/agent/commands/acp.package-create.md +41 -41
- package/agent/commands/acp.package-info.md +40 -40
- package/agent/commands/acp.package-install.md +48 -48
- package/agent/commands/acp.package-list.md +40 -40
- package/agent/commands/acp.package-publish.md +62 -62
- package/agent/commands/acp.package-remove.md +41 -41
- package/agent/commands/acp.package-search.md +48 -48
- package/agent/commands/acp.package-update.md +50 -50
- package/agent/commands/acp.package-validate.md +52 -52
- package/agent/commands/acp.pattern-create.md +61 -43
- package/agent/commands/acp.plan.md +70 -47
- package/agent/commands/acp.proceed.md +188 -66
- package/agent/commands/acp.project-create.md +42 -42
- package/agent/commands/acp.project-info.md +46 -46
- package/agent/commands/acp.project-list.md +41 -41
- package/agent/commands/acp.project-remove.md +36 -36
- package/agent/commands/acp.project-set.md +33 -33
- package/agent/commands/acp.project-update.md +57 -57
- package/agent/commands/acp.projects-restore.md +37 -37
- package/agent/commands/acp.projects-sync.md +39 -39
- package/agent/commands/acp.report.md +50 -50
- package/agent/commands/acp.resume.md +36 -36
- package/agent/commands/acp.sessions.md +46 -46
- package/agent/commands/acp.status.md +43 -43
- package/agent/commands/acp.sync.md +109 -56
- package/agent/commands/acp.task-create.md +51 -49
- package/agent/commands/acp.update.md +66 -45
- package/agent/commands/acp.validate.md +110 -52
- package/agent/commands/acp.version-check-for-updates.md +40 -40
- package/agent/commands/acp.version-check.md +36 -36
- package/agent/commands/acp.version-update.md +43 -43
- package/agent/commands/command.template.md +40 -40
- package/agent/commands/git.commit.md +28 -28
- package/agent/commands/git.init.md +48 -48
- package/agent/design/design.template.md +9 -9
- package/agent/design/local.admin-debugging-tools.md +242 -0
- package/agent/design/requirements.template.md +8 -8
- package/agent/index/.gitkeep +0 -0
- package/agent/index/acp.core.yaml +137 -0
- package/agent/index/local.main.template.yaml +37 -0
- package/agent/index/local.main.yaml +48 -0
- package/agent/manifest.yaml +64 -0
- package/agent/milestones/milestone-1-{title}.template.md +8 -8
- package/agent/milestones/milestone-22-admin-debugging-tools.md +61 -0
- package/agent/milestones/milestone-23-trust-level-protection.md +122 -0
- package/agent/patterns/pattern.template.md +22 -22
- package/agent/progress.template.yaml +13 -3
- package/agent/progress.yaml +173 -3
- package/agent/schemas/package.schema.yaml +276 -0
- package/agent/scripts/acp.project-update.sh +5 -6
- package/agent/tasks/milestone-22-admin-debugging-tools/task-520-admin-gate-infrastructure.md +99 -0
- package/agent/tasks/milestone-22-admin-debugging-tools/task-521-schema-and-collection-tools.md +108 -0
- package/agent/tasks/milestone-22-admin-debugging-tools/task-522-memory-inspection-tools.md +120 -0
- package/agent/tasks/milestone-22-admin-debugging-tools/task-523-user-inspection-tools.md +126 -0
- package/agent/tasks/milestone-22-admin-debugging-tools/task-524-health-and-drift-tools.md +120 -0
- package/agent/tasks/milestone-23-trust-level-protection/task-525-remove-trust-from-create-update.md +69 -0
- package/agent/tasks/milestone-23-trust-level-protection/task-526-add-request-set-trust-level-tool.md +108 -0
- package/agent/tasks/milestone-23-trust-level-protection/task-527-update-confirm-deny-secret-token.md +60 -0
- package/agent/tasks/milestone-23-trust-level-protection/task-528-update-trust-scale-references.md +73 -0
- package/agent/tasks/milestone-23-trust-level-protection/task-529-version-bump-and-release.md +87 -0
- package/agent/tasks/task-1-{title}.template.md +18 -18
- package/dist/server-factory.js +779 -87
- package/dist/server.js +141 -41
- package/dist/services/trust-validator.d.ts +16 -14
- package/dist/tools/admin-collection-stats.d.ts +24 -0
- package/dist/tools/admin-detect-weaviate-drift.d.ts +26 -0
- package/dist/tools/admin-get-weaviate-schema.d.ts +24 -0
- package/dist/tools/admin-health-drift.spec.d.ts +5 -0
- package/dist/tools/admin-health.d.ts +15 -0
- package/dist/tools/admin-inspect-memory.d.ts +29 -0
- package/dist/tools/admin-inspect-user.d.ts +73 -0
- package/dist/tools/admin-inspect-user.spec.d.ts +5 -0
- package/dist/tools/admin-list-collections.d.ts +23 -0
- package/dist/tools/admin-memory-inspection.spec.d.ts +7 -0
- package/dist/tools/admin-schema-collection.spec.d.ts +8 -0
- package/dist/tools/admin-search-across-users.d.ts +42 -0
- package/dist/tools/confirm.d.ts +1 -0
- package/dist/tools/confirm.spec.d.ts +5 -0
- package/dist/tools/create-internal-memory.d.ts +0 -7
- package/dist/tools/create-memory.d.ts +0 -7
- package/dist/tools/deny.d.ts +1 -0
- package/dist/tools/deny.spec.d.ts +5 -0
- package/dist/tools/query-memory.d.ts +2 -0
- package/dist/tools/request-set-trust-level.d.ts +32 -0
- package/dist/tools/request-set-trust-level.spec.d.ts +2 -0
- package/dist/tools/search-memory.d.ts +2 -0
- package/dist/tools/update-internal-memory.d.ts +0 -6
- package/dist/tools/update-memory.d.ts +0 -7
- package/dist/utils/admin.d.ts +21 -0
- package/dist/utils/admin.spec.d.ts +2 -0
- package/package.json +2 -2
- package/src/server-factory.ts +137 -42
- package/src/server.ts +6 -0
- package/src/services/trust-validator.spec.ts +57 -51
- package/src/services/trust-validator.ts +28 -26
- package/src/tools/admin-collection-stats.ts +67 -0
- package/src/tools/admin-detect-weaviate-drift.ts +110 -0
- package/src/tools/admin-get-weaviate-schema.ts +68 -0
- package/src/tools/admin-health-drift.spec.ts +193 -0
- package/src/tools/admin-health.ts +88 -0
- package/src/tools/admin-inspect-memory.ts +86 -0
- package/src/tools/admin-inspect-user.spec.ts +130 -0
- package/src/tools/admin-inspect-user.ts +148 -0
- package/src/tools/admin-list-collections.ts +73 -0
- package/src/tools/admin-memory-inspection.spec.ts +206 -0
- package/src/tools/admin-schema-collection.spec.ts +167 -0
- package/src/tools/admin-search-across-users.ts +104 -0
- package/src/tools/confirm.spec.ts +108 -0
- package/src/tools/confirm.ts +24 -1
- package/src/tools/create-internal-memory.ts +0 -3
- package/src/tools/create-memory.spec.ts +6 -2
- package/src/tools/create-memory.ts +1 -9
- package/src/tools/deny.spec.ts +59 -0
- package/src/tools/deny.ts +6 -1
- package/src/tools/ghost-config.ts +19 -19
- package/src/tools/query-memory.ts +4 -2
- package/src/tools/request-set-trust-level.spec.ts +87 -0
- package/src/tools/request-set-trust-level.ts +107 -0
- package/src/tools/search-memory.ts +4 -2
- package/src/tools/update-internal-memory.ts +0 -3
- package/src/tools/update-memory.ts +0 -8
- package/src/types/memory.ts +1 -1
- package/src/utils/admin.spec.ts +70 -0
- 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
|