@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.package-list` 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-18
|
|
8
|
-
**Last Updated**: 2026-02-18
|
|
9
|
-
**Status**: Active
|
|
10
|
-
**Scripts**: acp.package-list.sh, acp.common.sh, acp.yaml-parser.sh
|
|
5
|
+
**Namespace**: acp
|
|
6
|
+
**Version**: 1.0.0
|
|
7
|
+
**Created**: 2026-02-18
|
|
8
|
+
**Last Updated**: 2026-02-18
|
|
9
|
+
**Status**: Active
|
|
10
|
+
**Scripts**: acp.package-list.sh, acp.common.sh, acp.yaml-parser.sh
|
|
11
11
|
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
**Purpose**: List installed ACP packages with versions, file counts, and optional details
|
|
15
|
-
**Category**: Information
|
|
16
|
-
**Frequency**: As Needed
|
|
14
|
+
**Purpose**: List installed ACP packages with versions, file counts, and optional details
|
|
15
|
+
**Category**: Information
|
|
16
|
+
**Frequency**: As Needed
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
@@ -73,7 +73,7 @@ Execute the list script with desired options.
|
|
|
73
73
|
./agent/scripts/acp.package-list.sh --global --verbose
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
-
**Expected Outcome**: Package list displayed
|
|
76
|
+
**Expected Outcome**: Package list displayed
|
|
77
77
|
|
|
78
78
|
### 2. Review Package Information
|
|
79
79
|
|
|
@@ -86,7 +86,7 @@ Analyze the displayed information.
|
|
|
86
86
|
- Note any outdated packages (if using --outdated)
|
|
87
87
|
- Note any modified packages (if using --modified)
|
|
88
88
|
|
|
89
|
-
**Expected Outcome**: Understanding of installed packages
|
|
89
|
+
**Expected Outcome**: Understanding of installed packages
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
@@ -190,35 +190,35 @@ To install a package:
|
|
|
190
190
|
|
|
191
191
|
### Example 1: Basic List
|
|
192
192
|
|
|
193
|
-
**Context**: Want to see what packages are installed
|
|
193
|
+
**Context**: Want to see what packages are installed
|
|
194
194
|
|
|
195
|
-
**Invocation**: `@acp.package-list`
|
|
195
|
+
**Invocation**: `@acp.package-list`
|
|
196
196
|
|
|
197
|
-
**Result**: Shows 3 packages with versions and file counts
|
|
197
|
+
**Result**: Shows 3 packages with versions and file counts
|
|
198
198
|
|
|
199
199
|
### Example 2: Detailed Information
|
|
200
200
|
|
|
201
|
-
**Context**: Need detailed info about installed packages
|
|
201
|
+
**Context**: Need detailed info about installed packages
|
|
202
202
|
|
|
203
|
-
**Invocation**: `@acp.package-list --verbose`
|
|
203
|
+
**Invocation**: `@acp.package-list --verbose`
|
|
204
204
|
|
|
205
|
-
**Result**: Shows all packages with source URLs, timestamps, file breakdowns, and modified files
|
|
205
|
+
**Result**: Shows all packages with source URLs, timestamps, file breakdowns, and modified files
|
|
206
206
|
|
|
207
207
|
### Example 3: Check for Outdated Packages
|
|
208
208
|
|
|
209
|
-
**Context**: Want to see which packages have updates available
|
|
209
|
+
**Context**: Want to see which packages have updates available
|
|
210
210
|
|
|
211
|
-
**Invocation**: `@acp.package-list --outdated`
|
|
211
|
+
**Invocation**: `@acp.package-list --outdated`
|
|
212
212
|
|
|
213
|
-
**Result**: Shows only firebase (1.2.0) has update available, suggests update command
|
|
213
|
+
**Result**: Shows only firebase (1.2.0) has update available, suggests update command
|
|
214
214
|
|
|
215
215
|
### Example 4: Find Modified Packages
|
|
216
216
|
|
|
217
|
-
**Context**: Want to see which packages have local modifications
|
|
217
|
+
**Context**: Want to see which packages have local modifications
|
|
218
218
|
|
|
219
|
-
**Invocation**: `@acp.package-list --modified`
|
|
219
|
+
**Invocation**: `@acp.package-list --modified`
|
|
220
220
|
|
|
221
|
-
**Result**: Shows only firebase has 1 modified file (firebase-security-rules.md)
|
|
221
|
+
**Result**: Shows only firebase has 1 modified file (firebase-security-rules.md)
|
|
222
222
|
|
|
223
223
|
---
|
|
224
224
|
|
|
@@ -235,27 +235,27 @@ To install a package:
|
|
|
235
235
|
|
|
236
236
|
### Issue 1: No packages shown
|
|
237
237
|
|
|
238
|
-
**Symptom**: "No packages installed" message
|
|
238
|
+
**Symptom**: "No packages installed" message
|
|
239
239
|
|
|
240
|
-
**Cause**: No packages installed or manifest doesn't exist
|
|
240
|
+
**Cause**: No packages installed or manifest doesn't exist
|
|
241
241
|
|
|
242
|
-
**Solution**: Install packages using `@acp.package-install`
|
|
242
|
+
**Solution**: Install packages using `@acp.package-install`
|
|
243
243
|
|
|
244
244
|
### Issue 2: File counts seem wrong
|
|
245
245
|
|
|
246
|
-
**Symptom**: File count doesn't match actual files
|
|
246
|
+
**Symptom**: File count doesn't match actual files
|
|
247
247
|
|
|
248
|
-
**Cause**: Manifest out of sync with actual files
|
|
248
|
+
**Cause**: Manifest out of sync with actual files
|
|
249
249
|
|
|
250
|
-
**Solution**: Reinstall package or manually fix manifest
|
|
250
|
+
**Solution**: Reinstall package or manually fix manifest
|
|
251
251
|
|
|
252
252
|
### Issue 3: Outdated check is slow
|
|
253
253
|
|
|
254
|
-
**Symptom**: `--outdated` flag takes a long time
|
|
254
|
+
**Symptom**: `--outdated` flag takes a long time
|
|
255
255
|
|
|
256
|
-
**Cause**: Cloning repositories to check versions
|
|
256
|
+
**Cause**: Cloning repositories to check versions
|
|
257
257
|
|
|
258
|
-
**Solution**: This is normal for multiple packages, be patient or check specific package with `@acp.package-update <name> --check`
|
|
258
|
+
**Solution**: This is normal for multiple packages, be patient or check specific package with `@acp.package-update <name> --check`
|
|
259
259
|
|
|
260
260
|
---
|
|
261
261
|
|
|
@@ -270,11 +270,11 @@ To install a package:
|
|
|
270
270
|
|
|
271
271
|
---
|
|
272
272
|
|
|
273
|
-
**Namespace**: acp
|
|
274
|
-
**Command**: package-list
|
|
275
|
-
**Version**: 1.0.0
|
|
276
|
-
**Created**: 2026-02-18
|
|
277
|
-
**Last Updated**: 2026-02-18
|
|
278
|
-
**Status**: Active
|
|
279
|
-
**Compatibility**: ACP 2.0.0+
|
|
280
|
-
**Author**: ACP Project
|
|
273
|
+
**Namespace**: acp
|
|
274
|
+
**Command**: package-list
|
|
275
|
+
**Version**: 1.0.0
|
|
276
|
+
**Created**: 2026-02-18
|
|
277
|
+
**Last Updated**: 2026-02-18
|
|
278
|
+
**Status**: Active
|
|
279
|
+
**Compatibility**: ACP 2.0.0+
|
|
280
|
+
**Author**: ACP Project
|
|
@@ -4,18 +4,18 @@
|
|
|
4
4
|
> Pretend this command was entered with this additional context: "Execute directive `@acp.package-publish` 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**: acp
|
|
8
|
-
**Version**: 1.0.0
|
|
9
|
-
**Created**: 2026-02-21
|
|
10
|
-
**Last Updated**: 2026-02-21
|
|
11
|
-
**Status**: Active
|
|
12
|
-
**Scripts**: acp.package-publish.sh, acp.common.sh, acp.yaml-parser.sh
|
|
7
|
+
**Namespace**: acp
|
|
8
|
+
**Version**: 1.0.0
|
|
9
|
+
**Created**: 2026-02-21
|
|
10
|
+
**Last Updated**: 2026-02-21
|
|
11
|
+
**Status**: Active
|
|
12
|
+
**Scripts**: acp.package-publish.sh, acp.common.sh, acp.yaml-parser.sh
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
16
|
-
**Purpose**: Automated package publishing with validation, version detection, CHANGELOG generation, and testing
|
|
17
|
-
**Category**: Maintenance
|
|
18
|
-
**Frequency**: As Needed
|
|
16
|
+
**Purpose**: Automated package publishing with validation, version detection, CHANGELOG generation, and testing
|
|
17
|
+
**Category**: Maintenance
|
|
18
|
+
**Frequency**: As Needed
|
|
19
19
|
|
|
20
20
|
---
|
|
21
21
|
|
|
@@ -57,7 +57,7 @@ Validate package before making any changes.
|
|
|
57
57
|
- Display success message
|
|
58
58
|
- Proceed to next step
|
|
59
59
|
|
|
60
|
-
**Expected Outcome**: Package validated successfully or user fixes issues
|
|
60
|
+
**Expected Outcome**: Package validated successfully or user fixes issues
|
|
61
61
|
|
|
62
62
|
### 2. Check Working Directory Status
|
|
63
63
|
|
|
@@ -76,7 +76,7 @@ Verify git state is clean or has only version-related changes.
|
|
|
76
76
|
- Custom: Check package.yaml release.branch or release.branches
|
|
77
77
|
- If not on release branch: Error with branch name
|
|
78
78
|
|
|
79
|
-
**Expected Outcome**: Working directory ready for publishing
|
|
79
|
+
**Expected Outcome**: Working directory ready for publishing
|
|
80
80
|
|
|
81
81
|
### 3. Check Remote Status
|
|
82
82
|
|
|
@@ -91,7 +91,7 @@ Ensure local is in sync with remote.
|
|
|
91
91
|
- If local is ahead or in sync:
|
|
92
92
|
- Proceed to next step
|
|
93
93
|
|
|
94
|
-
**Expected Outcome**: Local is up to date with remote
|
|
94
|
+
**Expected Outcome**: Local is up to date with remote
|
|
95
95
|
|
|
96
96
|
### 4. Analyze Commits for Version Bump
|
|
97
97
|
|
|
@@ -118,7 +118,7 @@ Detect version bump type from commit history.
|
|
|
118
118
|
Recommended: 1.3.0 (minor - new features added)
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
-
**Expected Outcome**: Version bump recommendation generated
|
|
121
|
+
**Expected Outcome**: Version bump recommendation generated
|
|
122
122
|
|
|
123
123
|
### 5. Confirm Version Bump
|
|
124
124
|
|
|
@@ -132,7 +132,7 @@ Ask user to confirm or override version bump.
|
|
|
132
132
|
- If custom: Prompt for version number and validate format
|
|
133
133
|
- Validate new version > current version
|
|
134
134
|
|
|
135
|
-
**Expected Outcome**: User confirms version number
|
|
135
|
+
**Expected Outcome**: User confirms version number
|
|
136
136
|
|
|
137
137
|
### 6. Commit Version Changes Using @git.commit
|
|
138
138
|
|
|
@@ -149,9 +149,9 @@ Use the @git.commit command to handle version bump and CHANGELOG.
|
|
|
149
149
|
- Create properly formatted commit
|
|
150
150
|
- Display commit results
|
|
151
151
|
|
|
152
|
-
**Expected Outcome**: Version changes committed via @git.commit
|
|
152
|
+
**Expected Outcome**: Version changes committed via @git.commit
|
|
153
153
|
|
|
154
|
-
**Note**: This step delegates to [`@git.commit`](git.commit.md) which handles:
|
|
154
|
+
**Note**: This step delegates to [`@git.commit`](git.commit.md) which handles:
|
|
155
155
|
- Version file updates
|
|
156
156
|
- CHANGELOG.md generation and updates
|
|
157
157
|
- Intelligent file staging
|
|
@@ -169,7 +169,7 @@ Tag the release commit.
|
|
|
169
169
|
- Display tag created
|
|
170
170
|
- Show tag details: `git show vX.Y.Z --no-patch`
|
|
171
171
|
|
|
172
|
-
**Expected Outcome**: Git tag created
|
|
172
|
+
**Expected Outcome**: Git tag created
|
|
173
173
|
|
|
174
174
|
### 8. Push to Remote
|
|
175
175
|
|
|
@@ -181,7 +181,7 @@ Push commits and tags to remote repository.
|
|
|
181
181
|
- Display push results
|
|
182
182
|
- Show remote URL
|
|
183
183
|
|
|
184
|
-
**Expected Outcome**: Changes pushed to remote
|
|
184
|
+
**Expected Outcome**: Changes pushed to remote
|
|
185
185
|
|
|
186
186
|
### 9. Wait for GitHub Processing
|
|
187
187
|
|
|
@@ -191,7 +191,7 @@ Give GitHub time to process the push.
|
|
|
191
191
|
- Wait 5-10 seconds
|
|
192
192
|
- Display: "Waiting for GitHub to process push..."
|
|
193
193
|
|
|
194
|
-
**Expected Outcome**: GitHub has processed the push
|
|
194
|
+
**Expected Outcome**: GitHub has processed the push
|
|
195
195
|
|
|
196
196
|
### 10. Test Installation from Remote
|
|
197
197
|
|
|
@@ -210,7 +210,7 @@ Verify package can be installed from remote.
|
|
|
210
210
|
- Cleanup temp directory
|
|
211
211
|
- Report test results
|
|
212
212
|
|
|
213
|
-
**Expected Outcome**: Package installs successfully from remote
|
|
213
|
+
**Expected Outcome**: Package installs successfully from remote
|
|
214
214
|
|
|
215
215
|
### 11. Generate Final Report
|
|
216
216
|
|
|
@@ -230,7 +230,7 @@ Display comprehensive publishing report.
|
|
|
230
230
|
- Consider announcing release
|
|
231
231
|
- Monitor for issues
|
|
232
232
|
|
|
233
|
-
**Expected Outcome**: User informed of successful publish
|
|
233
|
+
**Expected Outcome**: User informed of successful publish
|
|
234
234
|
|
|
235
235
|
---
|
|
236
236
|
|
|
@@ -395,43 +395,43 @@ Next steps:
|
|
|
395
395
|
|
|
396
396
|
### Example 1: Publishing New Feature Release
|
|
397
397
|
|
|
398
|
-
**Context**: Added 2 new patterns, ready to publish
|
|
398
|
+
**Context**: Added 2 new patterns, ready to publish
|
|
399
399
|
|
|
400
|
-
**Invocation**: `@acp.package-publish`
|
|
400
|
+
**Invocation**: `@acp.package-publish`
|
|
401
401
|
|
|
402
|
-
**Result**: Validates package, detects minor version bump (1.2.3 → 1.3.0), generates CHANGELOG, commits, tags, pushes, tests installation, confirms success
|
|
402
|
+
**Result**: Validates package, detects minor version bump (1.2.3 → 1.3.0), generates CHANGELOG, commits, tags, pushes, tests installation, confirms success
|
|
403
403
|
|
|
404
404
|
### Example 2: Publishing Bug Fix
|
|
405
405
|
|
|
406
|
-
**Context**: Fixed typo in documentation
|
|
406
|
+
**Context**: Fixed typo in documentation
|
|
407
407
|
|
|
408
|
-
**Invocation**: `@acp.package-publish`
|
|
408
|
+
**Invocation**: `@acp.package-publish`
|
|
409
409
|
|
|
410
|
-
**Result**: Validates, detects patch bump (1.2.3 → 1.2.4), generates CHANGELOG, publishes, tests, confirms success
|
|
410
|
+
**Result**: Validates, detects patch bump (1.2.3 → 1.2.4), generates CHANGELOG, publishes, tests, confirms success
|
|
411
411
|
|
|
412
412
|
### Example 3: Validation Failure
|
|
413
413
|
|
|
414
|
-
**Context**: Package has issues
|
|
414
|
+
**Context**: Package has issues
|
|
415
415
|
|
|
416
|
-
**Invocation**: `@acp.package-publish`
|
|
416
|
+
**Invocation**: `@acp.package-publish`
|
|
417
417
|
|
|
418
|
-
**Result**: Validation fails with 3 errors, offers auto-fix, user fixes issues, re-runs validation, then proceeds with publishing
|
|
418
|
+
**Result**: Validation fails with 3 errors, offers auto-fix, user fixes issues, re-runs validation, then proceeds with publishing
|
|
419
419
|
|
|
420
420
|
### Example 4: Wrong Branch
|
|
421
421
|
|
|
422
|
-
**Context**: On feature branch instead of main
|
|
422
|
+
**Context**: On feature branch instead of main
|
|
423
423
|
|
|
424
|
-
**Invocation**: `@acp.package-publish`
|
|
424
|
+
**Invocation**: `@acp.package-publish`
|
|
425
425
|
|
|
426
|
-
**Result**: Detects wrong branch, reports error: "Not on release branch. Current: feature/new-pattern, Expected: main, master, mainline, or release", stops publishing
|
|
426
|
+
**Result**: Detects wrong branch, reports error: "Not on release branch. Current: feature/new-pattern, Expected: main, master, mainline, or release", stops publishing
|
|
427
427
|
|
|
428
428
|
### Example 5: Remote Ahead
|
|
429
429
|
|
|
430
|
-
**Context**: Remote has commits not pulled locally
|
|
430
|
+
**Context**: Remote has commits not pulled locally
|
|
431
431
|
|
|
432
|
-
**Invocation**: `@acp.package-publish`
|
|
432
|
+
**Invocation**: `@acp.package-publish`
|
|
433
433
|
|
|
434
|
-
**Result**: Detects remote ahead, reports error: "Remote has 2 commits not in local. Run: git pull", stops publishing
|
|
434
|
+
**Result**: Detects remote ahead, reports error: "Remote has 2 commits not in local. Run: git pull", stops publishing
|
|
435
435
|
|
|
436
436
|
---
|
|
437
437
|
|
|
@@ -449,51 +449,51 @@ Next steps:
|
|
|
449
449
|
|
|
450
450
|
### Issue 1: Validation fails
|
|
451
451
|
|
|
452
|
-
**Symptom**: Package validation reports errors
|
|
452
|
+
**Symptom**: Package validation reports errors
|
|
453
453
|
|
|
454
|
-
**Cause**: Package has structural or content issues
|
|
454
|
+
**Cause**: Package has structural or content issues
|
|
455
455
|
|
|
456
|
-
**Solution**: Use auto-fix to resolve issues, or fix manually, then run `@acp.package-publish` again
|
|
456
|
+
**Solution**: Use auto-fix to resolve issues, or fix manually, then run `@acp.package-publish` again
|
|
457
457
|
|
|
458
458
|
### Issue 2: Not on release branch
|
|
459
459
|
|
|
460
|
-
**Symptom**: Error "Not on release branch"
|
|
460
|
+
**Symptom**: Error "Not on release branch"
|
|
461
461
|
|
|
462
|
-
**Cause**: Current branch is not configured as release branch
|
|
462
|
+
**Cause**: Current branch is not configured as release branch
|
|
463
463
|
|
|
464
|
-
**Solution**: Switch to release branch (`git checkout main`), or configure current branch in package.yaml release.branch field
|
|
464
|
+
**Solution**: Switch to release branch (`git checkout main`), or configure current branch in package.yaml release.branch field
|
|
465
465
|
|
|
466
466
|
### Issue 3: Remote ahead of local
|
|
467
467
|
|
|
468
|
-
**Symptom**: Error "Remote has commits not in local"
|
|
468
|
+
**Symptom**: Error "Remote has commits not in local"
|
|
469
469
|
|
|
470
|
-
**Cause**: Someone else pushed to remote
|
|
470
|
+
**Cause**: Someone else pushed to remote
|
|
471
471
|
|
|
472
|
-
**Solution**: Pull latest changes (`git pull`), resolve conflicts if any, then run `@acp.package-publish` again
|
|
472
|
+
**Solution**: Pull latest changes (`git pull`), resolve conflicts if any, then run `@acp.package-publish` again
|
|
473
473
|
|
|
474
474
|
### Issue 4: Test installation fails
|
|
475
475
|
|
|
476
|
-
**Symptom**: Package publishes but test installation fails
|
|
476
|
+
**Symptom**: Package publishes but test installation fails
|
|
477
477
|
|
|
478
|
-
**Cause**: Package structure issues or installation script problems
|
|
478
|
+
**Cause**: Package structure issues or installation script problems
|
|
479
479
|
|
|
480
|
-
**Solution**: Check package structure, verify all files exist, ensure package.yaml is correct, fix issues and publish patch version
|
|
480
|
+
**Solution**: Check package structure, verify all files exist, ensure package.yaml is correct, fix issues and publish patch version
|
|
481
481
|
|
|
482
482
|
### Issue 5: No commits since last tag
|
|
483
483
|
|
|
484
|
-
**Symptom**: Error "No commits since last release"
|
|
484
|
+
**Symptom**: Error "No commits since last release"
|
|
485
485
|
|
|
486
|
-
**Cause**: Nothing to publish
|
|
486
|
+
**Cause**: Nothing to publish
|
|
487
487
|
|
|
488
|
-
**Solution**: Make changes, commit them, then run `@acp.package-publish`
|
|
488
|
+
**Solution**: Make changes, commit them, then run `@acp.package-publish`
|
|
489
489
|
|
|
490
490
|
### Issue 6: Version already exists
|
|
491
491
|
|
|
492
|
-
**Symptom**: Error "Tag vX.Y.Z already exists"
|
|
492
|
+
**Symptom**: Error "Tag vX.Y.Z already exists"
|
|
493
493
|
|
|
494
|
-
**Cause**: Version was already published
|
|
494
|
+
**Cause**: Version was already published
|
|
495
495
|
|
|
496
|
-
**Solution**: Choose different version number, or delete existing tag if it was a mistake: `git tag -d vX.Y.Z && git push origin :refs/tags/vX.Y.Z`
|
|
496
|
+
**Solution**: Choose different version number, or delete existing tag if it was a mistake: `git tag -d vX.Y.Z && git push origin :refs/tags/vX.Y.Z`
|
|
497
497
|
|
|
498
498
|
---
|
|
499
499
|
|
|
@@ -531,11 +531,11 @@ Next steps:
|
|
|
531
531
|
|
|
532
532
|
---
|
|
533
533
|
|
|
534
|
-
**Namespace**: acp
|
|
535
|
-
**Command**: package-publish
|
|
536
|
-
**Version**: 1.0.0
|
|
537
|
-
**Created**: 2026-02-21
|
|
538
|
-
**Last Updated**: 2026-02-21
|
|
539
|
-
**Status**: Active
|
|
540
|
-
**Compatibility**: ACP 2.0.0+
|
|
541
|
-
**Author**: ACP Project
|
|
534
|
+
**Namespace**: acp
|
|
535
|
+
**Command**: package-publish
|
|
536
|
+
**Version**: 1.0.0
|
|
537
|
+
**Created**: 2026-02-21
|
|
538
|
+
**Last Updated**: 2026-02-21
|
|
539
|
+
**Status**: Active
|
|
540
|
+
**Compatibility**: ACP 2.0.0+
|
|
541
|
+
**Author**: ACP Project
|
|
@@ -2,18 +2,18 @@
|
|
|
2
2
|
|
|
3
3
|
> **🤖 Agent Directive**: If you are reading this file, the command `@acp.package-remove` has been invoked. Follow the steps below to execute this command.
|
|
4
4
|
|
|
5
|
-
**Namespace**: acp
|
|
6
|
-
**Version**: 2.0.0
|
|
7
|
-
**Created**: 2026-02-18
|
|
8
|
-
**Last Updated**: 2026-02-22
|
|
9
|
-
**Status**: Active
|
|
10
|
-
**Scripts**: acp.package-remove.sh, acp.common.sh, acp.yaml-parser.sh
|
|
5
|
+
**Namespace**: acp
|
|
6
|
+
**Version**: 2.0.0
|
|
7
|
+
**Created**: 2026-02-18
|
|
8
|
+
**Last Updated**: 2026-02-22
|
|
9
|
+
**Status**: Active
|
|
10
|
+
**Scripts**: acp.package-remove.sh, acp.common.sh, acp.yaml-parser.sh
|
|
11
11
|
|
|
12
12
|
---
|
|
13
13
|
|
|
14
|
-
**Purpose**: Remove installed ACP packages and clean up manifest
|
|
15
|
-
**Category**: Maintenance
|
|
16
|
-
**Frequency**: As Needed
|
|
14
|
+
**Purpose**: Remove installed ACP packages and clean up manifest
|
|
15
|
+
**Category**: Maintenance
|
|
16
|
+
**Frequency**: As Needed
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
@@ -62,7 +62,7 @@ Execute the remove script with the package name.
|
|
|
62
62
|
- Update manifest timestamp
|
|
63
63
|
- Report removal summary
|
|
64
64
|
|
|
65
|
-
**Expected Outcome**: Package removed successfully
|
|
65
|
+
**Expected Outcome**: Package removed successfully
|
|
66
66
|
|
|
67
67
|
### 2. Verify Removal
|
|
68
68
|
|
|
@@ -74,7 +74,7 @@ Check that files were removed correctly.
|
|
|
74
74
|
- If `--keep-modified` used, verify modified files were kept
|
|
75
75
|
- Confirm no orphaned files remain
|
|
76
76
|
|
|
77
|
-
**Expected Outcome**: Package completely removed (or modified files kept)
|
|
77
|
+
**Expected Outcome**: Package completely removed (or modified files kept)
|
|
78
78
|
|
|
79
79
|
### 3. Document Removal
|
|
80
80
|
|
|
@@ -86,7 +86,7 @@ Update progress tracking with removal notes.
|
|
|
86
86
|
- Note removal date
|
|
87
87
|
- List any kept files (if --keep-modified used)
|
|
88
88
|
|
|
89
|
-
**Expected Outcome**: Removal tracked in progress
|
|
89
|
+
**Expected Outcome**: Removal tracked in progress
|
|
90
90
|
|
|
91
91
|
---
|
|
92
92
|
|
|
@@ -188,35 +188,35 @@ Kept: 1 file(s) (modified)
|
|
|
188
188
|
|
|
189
189
|
### Example 1: Remove Package
|
|
190
190
|
|
|
191
|
-
**Context**: No longer need firebase package
|
|
191
|
+
**Context**: No longer need firebase package
|
|
192
192
|
|
|
193
|
-
**Invocation**: `@acp.package-remove firebase`
|
|
193
|
+
**Invocation**: `@acp.package-remove firebase`
|
|
194
194
|
|
|
195
|
-
**Result**: Prompts for confirmation, removes all 6 files, updates manifest
|
|
195
|
+
**Result**: Prompts for confirmation, removes all 6 files, updates manifest
|
|
196
196
|
|
|
197
197
|
### Example 2: Remove with Auto-Confirm
|
|
198
198
|
|
|
199
|
-
**Context**: Want to remove without prompts
|
|
199
|
+
**Context**: Want to remove without prompts
|
|
200
200
|
|
|
201
|
-
**Invocation**: `@acp.package-remove -y firebase`
|
|
201
|
+
**Invocation**: `@acp.package-remove -y firebase`
|
|
202
202
|
|
|
203
|
-
**Result**: Removes package immediately without confirmation
|
|
203
|
+
**Result**: Removes package immediately without confirmation
|
|
204
204
|
|
|
205
205
|
### Example 3: Keep Modified Files
|
|
206
206
|
|
|
207
|
-
**Context**: Want to remove package but keep customized files
|
|
207
|
+
**Context**: Want to remove package but keep customized files
|
|
208
208
|
|
|
209
|
-
**Invocation**: `@acp.package-remove --keep-modified firebase`
|
|
209
|
+
**Invocation**: `@acp.package-remove --keep-modified firebase`
|
|
210
210
|
|
|
211
|
-
**Result**: Removes 5 unmodified files, keeps 1 modified file, updates manifest
|
|
211
|
+
**Result**: Removes 5 unmodified files, keeps 1 modified file, updates manifest
|
|
212
212
|
|
|
213
213
|
### Example 4: Package Not Installed
|
|
214
214
|
|
|
215
|
-
**Context**: Try to remove non-existent package
|
|
215
|
+
**Context**: Try to remove non-existent package
|
|
216
216
|
|
|
217
|
-
**Invocation**: `@acp.package-remove nonexistent`
|
|
217
|
+
**Invocation**: `@acp.package-remove nonexistent`
|
|
218
218
|
|
|
219
|
-
**Result**: Error message "Package not installed: nonexistent", exits without changes
|
|
219
|
+
**Result**: Error message "Package not installed: nonexistent", exits without changes
|
|
220
220
|
|
|
221
221
|
---
|
|
222
222
|
|
|
@@ -233,27 +233,27 @@ Kept: 1 file(s) (modified)
|
|
|
233
233
|
|
|
234
234
|
### Issue 1: Package not found
|
|
235
235
|
|
|
236
|
-
**Symptom**: Error "Package not installed"
|
|
236
|
+
**Symptom**: Error "Package not installed"
|
|
237
237
|
|
|
238
|
-
**Cause**: Package name incorrect or not installed
|
|
238
|
+
**Cause**: Package name incorrect or not installed
|
|
239
239
|
|
|
240
|
-
**Solution**: Run `@acp.package-list` to see installed packages, check spelling
|
|
240
|
+
**Solution**: Run `@acp.package-list` to see installed packages, check spelling
|
|
241
241
|
|
|
242
242
|
### Issue 2: Files not removed
|
|
243
243
|
|
|
244
|
-
**Symptom**: Files still exist after removal
|
|
244
|
+
**Symptom**: Files still exist after removal
|
|
245
245
|
|
|
246
|
-
**Cause**: Files were modified and --keep-modified was used
|
|
246
|
+
**Cause**: Files were modified and --keep-modified was used
|
|
247
247
|
|
|
248
|
-
**Solution**: This is intentional. Remove manually or run without --keep-modified
|
|
248
|
+
**Solution**: This is intentional. Remove manually or run without --keep-modified
|
|
249
249
|
|
|
250
250
|
### Issue 3: Manifest corrupted after removal
|
|
251
251
|
|
|
252
|
-
**Symptom**: Manifest has syntax errors
|
|
252
|
+
**Symptom**: Manifest has syntax errors
|
|
253
253
|
|
|
254
|
-
**Cause**: Rare edge case in awk processing
|
|
254
|
+
**Cause**: Rare edge case in awk processing
|
|
255
255
|
|
|
256
|
-
**Solution**: Restore from git backup, reinstall packages
|
|
256
|
+
**Solution**: Restore from git backup, reinstall packages
|
|
257
257
|
|
|
258
258
|
---
|
|
259
259
|
|
|
@@ -283,11 +283,11 @@ Kept: 1 file(s) (modified)
|
|
|
283
283
|
|
|
284
284
|
---
|
|
285
285
|
|
|
286
|
-
**Namespace**: acp
|
|
287
|
-
**Command**: package-remove
|
|
288
|
-
**Version**: 1.0.0
|
|
289
|
-
**Created**: 2026-02-18
|
|
290
|
-
**Last Updated**: 2026-02-18
|
|
291
|
-
**Status**: Active
|
|
292
|
-
**Compatibility**: ACP 2.0.0+
|
|
293
|
-
**Author**: ACP Project
|
|
286
|
+
**Namespace**: acp
|
|
287
|
+
**Command**: package-remove
|
|
288
|
+
**Version**: 1.0.0
|
|
289
|
+
**Created**: 2026-02-18
|
|
290
|
+
**Last Updated**: 2026-02-18
|
|
291
|
+
**Status**: Active
|
|
292
|
+
**Compatibility**: ACP 2.0.0+
|
|
293
|
+
**Author**: ACP Project
|