@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.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