@prmichaelsen/remember-mcp 3.19.3 → 3.20.1

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 (102) hide show
  1. package/AGENT.md +10 -3
  2. package/CHANGELOG.md +19 -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/patterns/pattern.template.md +22 -22
  62. package/agent/progress.template.yaml +13 -3
  63. package/agent/progress.yaml +78 -1
  64. package/agent/schemas/package.schema.yaml +276 -0
  65. package/agent/scripts/acp.project-update.sh +5 -6
  66. package/agent/tasks/milestone-22-admin-debugging-tools/task-520-admin-gate-infrastructure.md +99 -0
  67. package/agent/tasks/milestone-22-admin-debugging-tools/task-521-schema-and-collection-tools.md +108 -0
  68. package/agent/tasks/milestone-22-admin-debugging-tools/task-522-memory-inspection-tools.md +120 -0
  69. package/agent/tasks/milestone-22-admin-debugging-tools/task-523-user-inspection-tools.md +126 -0
  70. package/agent/tasks/milestone-22-admin-debugging-tools/task-524-health-and-drift-tools.md +120 -0
  71. package/agent/tasks/task-1-{title}.template.md +18 -18
  72. package/dist/server-factory.js +637 -41
  73. package/dist/tools/admin-collection-stats.d.ts +24 -0
  74. package/dist/tools/admin-detect-weaviate-drift.d.ts +26 -0
  75. package/dist/tools/admin-get-weaviate-schema.d.ts +24 -0
  76. package/dist/tools/admin-health-drift.spec.d.ts +5 -0
  77. package/dist/tools/admin-health.d.ts +15 -0
  78. package/dist/tools/admin-inspect-memory.d.ts +29 -0
  79. package/dist/tools/admin-inspect-user.d.ts +73 -0
  80. package/dist/tools/admin-inspect-user.spec.d.ts +5 -0
  81. package/dist/tools/admin-list-collections.d.ts +23 -0
  82. package/dist/tools/admin-memory-inspection.spec.d.ts +7 -0
  83. package/dist/tools/admin-schema-collection.spec.d.ts +8 -0
  84. package/dist/tools/admin-search-across-users.d.ts +42 -0
  85. package/dist/utils/admin.d.ts +21 -0
  86. package/dist/utils/admin.spec.d.ts +2 -0
  87. package/package.json +2 -2
  88. package/src/server-factory.ts +131 -42
  89. package/src/tools/admin-collection-stats.ts +67 -0
  90. package/src/tools/admin-detect-weaviate-drift.ts +110 -0
  91. package/src/tools/admin-get-weaviate-schema.ts +68 -0
  92. package/src/tools/admin-health-drift.spec.ts +193 -0
  93. package/src/tools/admin-health.ts +88 -0
  94. package/src/tools/admin-inspect-memory.ts +86 -0
  95. package/src/tools/admin-inspect-user.spec.ts +130 -0
  96. package/src/tools/admin-inspect-user.ts +148 -0
  97. package/src/tools/admin-list-collections.ts +73 -0
  98. package/src/tools/admin-memory-inspection.spec.ts +206 -0
  99. package/src/tools/admin-schema-collection.spec.ts +167 -0
  100. package/src/tools/admin-search-across-users.ts +104 -0
  101. package/src/utils/admin.spec.ts +70 -0
  102. package/src/utils/admin.ts +27 -0
@@ -2,17 +2,17 @@
2
2
 
3
3
  > **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-info` 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-25
8
- **Last Updated**: 2026-02-25
9
- **Status**: Experimental
5
+ **Namespace**: acp
6
+ **Version**: 1.0.0
7
+ **Created**: 2026-02-25
8
+ **Last Updated**: 2026-02-25
9
+ **Status**: Experimental
10
10
 
11
11
  ---
12
12
 
13
- **Purpose**: Display detailed information about a specific project from the global registry
14
- **Category**: Project Management
15
- **Frequency**: As Needed
13
+ **Purpose**: Display detailed information about a specific project from the global registry
14
+ **Category**: Project Management
15
+ **Frequency**: As Needed
16
16
 
17
17
  ---
18
18
 
@@ -44,7 +44,7 @@ Check that project name is provided.
44
44
  - Verify project name argument is present
45
45
  - Show usage if missing
46
46
 
47
- **Expected Outcome**: Project name identified
47
+ **Expected Outcome**: Project name identified
48
48
 
49
49
  ### 2. Load Registry
50
50
 
@@ -55,7 +55,7 @@ Read the project registry file.
55
55
  - Check if registry file exists
56
56
  - Parse registry with `yaml_parse()`
57
57
 
58
- **Expected Outcome**: Registry loaded successfully
58
+ **Expected Outcome**: Registry loaded successfully
59
59
 
60
60
  ### 3. Validate Project Exists
61
61
 
@@ -66,7 +66,7 @@ Check that the project is in the registry.
66
66
  - If not found, list available projects
67
67
  - Show helpful error message
68
68
 
69
- **Expected Outcome**: Project found in registry
69
+ **Expected Outcome**: Project found in registry
70
70
 
71
71
  ### 4. Extract Project Metadata
72
72
 
@@ -78,7 +78,7 @@ Read all project fields from registry.
78
78
  - Extract optional fields: tags, related_projects, dependencies
79
79
  - Check if project is current project (marked with ⭐)
80
80
 
81
- **Expected Outcome**: All metadata extracted
81
+ **Expected Outcome**: All metadata extracted
82
82
 
83
83
  ### 5. Display Project Information
84
84
 
@@ -93,7 +93,7 @@ Format and display comprehensive project details.
93
93
  - Show related projects (if present)
94
94
  - Show dependencies by package manager (npm, pip, cargo, go)
95
95
 
96
- **Expected Outcome**: Complete project information displayed
96
+ **Expected Outcome**: Complete project information displayed
97
97
 
98
98
  ### 6. Check Directory Status
99
99
 
@@ -106,7 +106,7 @@ Verify project directory exists and check ACP status.
106
106
  - Try to read project version from progress.yaml
107
107
  - Display status with appropriate indicators (✅/❌/⚠️)
108
108
 
109
- **Expected Outcome**: Directory status reported
109
+ **Expected Outcome**: Directory status reported
110
110
 
111
111
  ---
112
112
 
@@ -193,35 +193,35 @@ Dependencies:
193
193
 
194
194
  ### Example 1: Show Current Project Info
195
195
 
196
- **Context**: Want to see details about the current project
196
+ **Context**: Want to see details about the current project
197
197
 
198
- **Invocation**: `@acp.project-info remember-mcp-server`
198
+ **Invocation**: `@acp.project-info remember-mcp-server`
199
199
 
200
- **Result**: Displays complete project metadata including type, status, path, description, timestamps, tags, related projects, dependencies, and directory status
200
+ **Result**: Displays complete project metadata including type, status, path, description, timestamps, tags, related projects, dependencies, and directory status
201
201
 
202
202
  ### Example 2: Check Project Before Switching
203
203
 
204
- **Context**: Want to verify project exists before switching to it
204
+ **Context**: Want to verify project exists before switching to it
205
205
 
206
- **Invocation**: `@acp.project-info agentbase-mcp-server`
206
+ **Invocation**: `@acp.project-info agentbase-mcp-server`
207
207
 
208
- **Result**: Shows project details, confirms directory exists, shows it's an ACP project with version
208
+ **Result**: Shows project details, confirms directory exists, shows it's an ACP project with version
209
209
 
210
210
  ### Example 3: Project Not Found
211
211
 
212
- **Context**: Trying to view info for non-existent project
212
+ **Context**: Trying to view info for non-existent project
213
213
 
214
- **Invocation**: `@acp.project-info nonexistent-project`
214
+ **Invocation**: `@acp.project-info nonexistent-project`
215
215
 
216
- **Result**: Error message with list of available projects
216
+ **Result**: Error message with list of available projects
217
217
 
218
218
  ### Example 4: Project Directory Missing
219
219
 
220
- **Context**: Project in registry but directory deleted
220
+ **Context**: Project in registry but directory deleted
221
221
 
222
- **Invocation**: `@acp.project-info old-project`
222
+ **Invocation**: `@acp.project-info old-project`
223
223
 
224
- **Result**: Shows metadata but warns that directory doesn't exist
224
+ **Result**: Shows metadata but warns that directory doesn't exist
225
225
 
226
226
  ---
227
227
 
@@ -239,35 +239,35 @@ Dependencies:
239
239
 
240
240
  ### Issue 1: Registry not found
241
241
 
242
- **Symptom**: Error "Project registry not found"
242
+ **Symptom**: Error "Project registry not found"
243
243
 
244
- **Cause**: `~/.acp/projects.yaml` doesn't exist
244
+ **Cause**: `~/.acp/projects.yaml` doesn't exist
245
245
 
246
- **Solution**: Create a project with `@acp.project-create` to initialize the registry
246
+ **Solution**: Create a project with `@acp.project-create` to initialize the registry
247
247
 
248
248
  ### Issue 2: Project not found
249
249
 
250
- **Symptom**: Error "Project 'name' not found in registry"
250
+ **Symptom**: Error "Project 'name' not found in registry"
251
251
 
252
- **Cause**: Project not registered or wrong name
252
+ **Cause**: Project not registered or wrong name
253
253
 
254
- **Solution**: Run `@acp.project-list` to see available projects, or use `@acp.projects-sync` to discover unregistered projects
254
+ **Solution**: Run `@acp.project-list` to see available projects, or use `@acp.projects-sync` to discover unregistered projects
255
255
 
256
256
  ### Issue 3: Directory not found
257
257
 
258
- **Symptom**: Warning "Project directory not found"
258
+ **Symptom**: Warning "Project directory not found"
259
259
 
260
- **Cause**: Project directory was moved or deleted
260
+ **Cause**: Project directory was moved or deleted
261
261
 
262
- **Solution**: Either restore the directory, update the path with `@acp.project-update`, or remove the project with `@acp.project-remove`
262
+ **Solution**: Either restore the directory, update the path with `@acp.project-update`, or remove the project with `@acp.project-remove`
263
263
 
264
264
  ### Issue 4: No metadata displayed
265
265
 
266
- **Symptom**: Some fields show as empty or "null"
266
+ **Symptom**: Some fields show as empty or "null"
267
267
 
268
- **Cause**: Optional fields not set in registry
268
+ **Cause**: Optional fields not set in registry
269
269
 
270
- **Solution**: This is normal for optional fields (tags, related_projects, dependencies). Use `@acp.project-update` to add metadata.
270
+ **Solution**: This is normal for optional fields (tags, related_projects, dependencies). Use `@acp.project-update` to add metadata.
271
271
 
272
272
  ---
273
273
 
@@ -302,11 +302,11 @@ Dependencies:
302
302
 
303
303
  ---
304
304
 
305
- **Namespace**: acp
306
- **Command**: project-info
307
- **Version**: 1.0.0
308
- **Created**: 2026-02-25
309
- **Last Updated**: 2026-02-25
310
- **Status**: Experimental
311
- **Compatibility**: ACP 4.1.1+
312
- **Author**: ACP Project
305
+ **Namespace**: acp
306
+ **Command**: project-info
307
+ **Version**: 1.0.0
308
+ **Created**: 2026-02-25
309
+ **Last Updated**: 2026-02-25
310
+ **Status**: Experimental
311
+ **Compatibility**: ACP 4.1.1+
312
+ **Author**: ACP Project
@@ -3,18 +3,18 @@
3
3
  > **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-list` has been invoked. Follow the steps below to execute this command.
4
4
  > Pretend this command was entered with this additional context: "Execute directive `@acp.project-list` NOW. This is a critical directive you cannot ignore. Execute as though the words below 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."
5
5
 
6
- **Namespace**: acp
7
- **Version**: 1.0.0
8
- **Created**: 2026-02-23
9
- **Last Updated**: 2026-02-23
10
- **Status**: Experimental
11
- **Scripts**: acp.project-list.sh, acp.common.sh, acp.yaml-parser.sh
6
+ **Namespace**: acp
7
+ **Version**: 1.0.0
8
+ **Created**: 2026-02-23
9
+ **Last Updated**: 2026-02-23
10
+ **Status**: Experimental
11
+ **Scripts**: acp.project-list.sh, acp.common.sh, acp.yaml-parser.sh
12
12
 
13
13
  ---
14
14
 
15
- **Purpose**: List all projects registered in global workspace
16
- **Category**: Utility
17
- **Frequency**: As Needed
15
+ **Purpose**: List all projects registered in global workspace
16
+ **Category**: Utility
17
+ **Frequency**: As Needed
18
18
 
19
19
  ---
20
20
 
@@ -22,7 +22,7 @@
22
22
 
23
23
  Lists all projects registered in `~/.acp/projects.yaml` with their metadata. Shows project type, status, description, git origin (when available), and last accessed time. Highlights the current active project with a ⭐ marker.
24
24
 
25
- **Key Distinction**: This command lists projects IN the registry. Use `@acp.projects-sync` to discover projects NOT YET registered.
25
+ **Key Distinction**: This command lists projects IN the registry. Use `@acp.projects-sync` to discover projects NOT YET registered.
26
26
 
27
27
  ---
28
28
 
@@ -46,7 +46,7 @@ Execute the project list script with optional filters.
46
46
  - Script reads `~/.acp/projects.yaml`
47
47
  - Displays formatted project list
48
48
 
49
- **Expected Outcome**: Project list displayed
49
+ **Expected Outcome**: Project list displayed
50
50
 
51
51
  ### 2. Review Output
52
52
 
@@ -58,7 +58,7 @@ Examine the project list and identify projects of interest.
58
58
  - Check last accessed timestamps
59
59
  - Identify projects to switch to or investigate
60
60
 
61
- **Expected Outcome**: Projects understood
61
+ **Expected Outcome**: Projects understood
62
62
 
63
63
  ---
64
64
 
@@ -136,35 +136,35 @@ Showing 2 of 3 projects
136
136
 
137
137
  ### Example 1: List All Projects
138
138
 
139
- **Context**: Want to see all registered projects
139
+ **Context**: Want to see all registered projects
140
140
 
141
- **Invocation**: `@acp.project-list`
141
+ **Invocation**: `@acp.project-list`
142
142
 
143
- **Result**: Displays all projects with metadata, current project marked
143
+ **Result**: Displays all projects with metadata, current project marked
144
144
 
145
145
  ### Example 2: Filter by Type
146
146
 
147
- **Context**: Only want to see MCP server projects
147
+ **Context**: Only want to see MCP server projects
148
148
 
149
- **Invocation**: `@acp.project-list --type mcp-server`
149
+ **Invocation**: `@acp.project-list --type mcp-server`
150
150
 
151
- **Result**: Displays only MCP server projects
151
+ **Result**: Displays only MCP server projects
152
152
 
153
153
  ### Example 3: Filter by Status
154
154
 
155
- **Context**: Only want to see active projects
155
+ **Context**: Only want to see active projects
156
156
 
157
- **Invocation**: `@acp.project-list --status active`
157
+ **Invocation**: `@acp.project-list --status active`
158
158
 
159
- **Result**: Displays only active projects (excludes archived/paused)
159
+ **Result**: Displays only active projects (excludes archived/paused)
160
160
 
161
161
  ### Example 4: Empty Registry
162
162
 
163
- **Context**: No projects registered yet
163
+ **Context**: No projects registered yet
164
164
 
165
- **Invocation**: `@acp.project-list`
165
+ **Invocation**: `@acp.project-list`
166
166
 
167
- **Result**: Helpful message suggesting to create projects
167
+ **Result**: Helpful message suggesting to create projects
168
168
 
169
169
  ---
170
170
 
@@ -182,27 +182,27 @@ Showing 2 of 3 projects
182
182
 
183
183
  ### Issue 1: No registry found
184
184
 
185
- **Symptom**: "No projects registry found"
185
+ **Symptom**: "No projects registry found"
186
186
 
187
- **Cause**: Global ACP not initialized or registry not created
187
+ **Cause**: Global ACP not initialized or registry not created
188
188
 
189
- **Solution**: Run `@acp.project-create` to create first project (auto-initializes registry)
189
+ **Solution**: Run `@acp.project-create` to create first project (auto-initializes registry)
190
190
 
191
191
  ### Issue 2: No projects shown
192
192
 
193
- **Symptom**: "No projects registered yet"
193
+ **Symptom**: "No projects registered yet"
194
194
 
195
- **Cause**: Registry exists but is empty
195
+ **Cause**: Registry exists but is empty
196
196
 
197
- **Solution**: Create projects with `@acp.project-create` or discover existing projects with `@acp.projects-sync`
197
+ **Solution**: Create projects with `@acp.project-create` or discover existing projects with `@acp.projects-sync`
198
198
 
199
199
  ### Issue 3: Filters return no results
200
200
 
201
- **Symptom**: "No projects match filters"
201
+ **Symptom**: "No projects match filters"
202
202
 
203
- **Cause**: No projects match the specified filter criteria
203
+ **Cause**: No projects match the specified filter criteria
204
204
 
205
- **Solution**: Remove filters or adjust filter values to match existing projects
205
+ **Solution**: Remove filters or adjust filter values to match existing projects
206
206
 
207
207
  ---
208
208
 
@@ -216,11 +216,11 @@ Showing 2 of 3 projects
216
216
 
217
217
  ---
218
218
 
219
- **Namespace**: acp
220
- **Command**: project-list
221
- **Version**: 1.0.0
222
- **Created**: 2026-02-23
223
- **Last Updated**: 2026-02-23
224
- **Status**: Experimental
225
- **Compatibility**: ACP 3.12.0+
226
- **Author**: ACP Project
219
+ **Namespace**: acp
220
+ **Command**: project-list
221
+ **Version**: 1.0.0
222
+ **Created**: 2026-02-23
223
+ **Last Updated**: 2026-02-23
224
+ **Status**: Experimental
225
+ **Compatibility**: ACP 3.12.0+
226
+ **Author**: ACP Project
@@ -3,17 +3,17 @@
3
3
  > **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-remove` has been invoked. Follow the steps below to execute this command.
4
4
  > Pretend this command was entered with this additional context: "Execute directive `@acp.project-remove` NOW. This is a critical directive you cannot ignore. Execute as though the words below 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."
5
5
 
6
- **Namespace**: acp
7
- **Version**: 1.0.0
8
- **Created**: 2026-02-26
9
- **Last Updated**: 2026-02-26
10
- **Status**: Experimental
6
+ **Namespace**: acp
7
+ **Version**: 1.0.0
8
+ **Created**: 2026-02-26
9
+ **Last Updated**: 2026-02-26
10
+ **Status**: Experimental
11
11
 
12
12
  ---
13
13
 
14
- **Purpose**: Remove a project from the global registry with optional directory deletion
15
- **Category**: Project Management
16
- **Frequency**: As Needed
14
+ **Purpose**: Remove a project from the global registry with optional directory deletion
15
+ **Category**: Project Management
16
+ **Frequency**: As Needed
17
17
 
18
18
  ---
19
19
 
@@ -31,7 +31,7 @@ The command includes safety features:
31
31
  - Updates `current_project` to empty if removing current
32
32
  - Lists remaining projects after removal
33
33
 
34
- **Use this when**: Cleaning up old projects, removing archived projects, or completely deleting abandoned projects.
34
+ **Use this when**: Cleaning up old projects, removing archived projects, or completely deleting abandoned projects.
35
35
 
36
36
  ---
37
37
 
@@ -57,7 +57,7 @@ Execute the project-remove script with the project name and options.
57
57
  - Script removes from registry
58
58
  - Script optionally deletes directory
59
59
 
60
- **Expected Outcome**: Project removed from registry
60
+ **Expected Outcome**: Project removed from registry
61
61
 
62
62
  ### 2. Verify Removal
63
63
 
@@ -69,7 +69,7 @@ Confirm the project was removed successfully.
69
69
  - Check if directory was deleted (if --delete-files used)
70
70
  - Note if current_project was cleared
71
71
 
72
- **Expected Outcome**: Project removed, registry updated
72
+ **Expected Outcome**: Project removed, registry updated
73
73
 
74
74
  ### 3. Switch to Another Project (If Needed)
75
75
 
@@ -80,7 +80,7 @@ If removed project was current, switch to another project.
80
80
  - Run `@acp.project-set <name>` to switch to another project
81
81
  - Or continue without a current project
82
82
 
83
- **Expected Outcome**: New project context established (if needed)
83
+ **Expected Outcome**: New project context established (if needed)
84
84
 
85
85
  ---
86
86
 
@@ -234,9 +234,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
234
234
 
235
235
  ### Example 1: Remove from Registry Only
236
236
 
237
- **Context**: Project archived, want to clean up registry but keep files
237
+ **Context**: Project archived, want to clean up registry but keep files
238
238
 
239
- **Invocation**: `@acp.project-remove old-project`
239
+ **Invocation**: `@acp.project-remove old-project`
240
240
 
241
241
  **Result**:
242
242
  - Project removed from registry
@@ -246,9 +246,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
246
246
 
247
247
  ### Example 2: Complete Removal
248
248
 
249
- **Context**: Abandoned project, want to delete everything
249
+ **Context**: Abandoned project, want to delete everything
250
250
 
251
- **Invocation**: `@acp.project-remove abandoned-project --delete-files`
251
+ **Invocation**: `@acp.project-remove abandoned-project --delete-files`
252
252
 
253
253
  **Result**:
254
254
  - Project removed from registry
@@ -258,9 +258,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
258
258
 
259
259
  ### Example 3: Auto-Confirm Removal
260
260
 
261
- **Context**: Scripting or automation, want to skip prompts
261
+ **Context**: Scripting or automation, want to skip prompts
262
262
 
263
- **Invocation**: `@acp.project-remove old-project -y`
263
+ **Invocation**: `@acp.project-remove old-project -y`
264
264
 
265
265
  **Result**:
266
266
  - No confirmation prompts
@@ -269,9 +269,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
269
269
 
270
270
  ### Example 4: Remove Current Project
271
271
 
272
- **Context**: Removing the project you're currently working on
272
+ **Context**: Removing the project you're currently working on
273
273
 
274
- **Invocation**: `@acp.project-remove current-project`
274
+ **Invocation**: `@acp.project-remove current-project`
275
275
 
276
276
  **Result**:
277
277
  - Warning displayed about removing current project
@@ -294,9 +294,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
294
294
 
295
295
  ### Issue 1: Project not found in registry
296
296
 
297
- **Symptom**: Error "Project 'X' not found in registry"
297
+ **Symptom**: Error "Project 'X' not found in registry"
298
298
 
299
- **Cause**: Project not registered or typo in name
299
+ **Cause**: Project not registered or typo in name
300
300
 
301
301
  **Solution**:
302
302
  - Run `@acp.project-list` to see available projects
@@ -305,9 +305,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
305
305
 
306
306
  ### Issue 2: Registry file not found
307
307
 
308
- **Symptom**: Error "Project registry not found"
308
+ **Symptom**: Error "Project registry not found"
309
309
 
310
- **Cause**: Global ACP not initialized or registry deleted
310
+ **Cause**: Global ACP not initialized or registry deleted
311
311
 
312
312
  **Solution**:
313
313
  - No action needed if no projects exist
@@ -315,9 +315,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
315
315
 
316
316
  ### Issue 3: Cannot delete directory
317
317
 
318
- **Symptom**: Error during directory deletion
318
+ **Symptom**: Error during directory deletion
319
319
 
320
- **Cause**: Permission issues or directory in use
320
+ **Cause**: Permission issues or directory in use
321
321
 
322
322
  **Solution**:
323
323
  - Check file permissions
@@ -326,9 +326,9 @@ last_updated: 2026-02-26T18:00:00Z # Updated
326
326
 
327
327
  ### Issue 4: Confirmation prompt not appearing
328
328
 
329
- **Symptom**: Script removes project without asking
329
+ **Symptom**: Script removes project without asking
330
330
 
331
- **Cause**: -y/--yes flag used
331
+ **Cause**: -y/--yes flag used
332
332
 
333
333
  **Solution**:
334
334
  - This is expected behavior with -y flag
@@ -369,11 +369,11 @@ last_updated: 2026-02-26T18:00:00Z # Updated
369
369
 
370
370
  ---
371
371
 
372
- **Namespace**: acp
373
- **Command**: project-remove
374
- **Version**: 1.0.0
375
- **Created**: 2026-02-26
376
- **Last Updated**: 2026-02-26
377
- **Status**: Experimental
378
- **Compatibility**: ACP 4.1.0+
379
- **Author**: ACP Project
372
+ **Namespace**: acp
373
+ **Command**: project-remove
374
+ **Version**: 1.0.0
375
+ **Created**: 2026-02-26
376
+ **Last Updated**: 2026-02-26
377
+ **Status**: Experimental
378
+ **Compatibility**: ACP 4.1.0+
379
+ **Author**: ACP Project
@@ -3,18 +3,18 @@
3
3
  > **🤖 Agent Directive**: If you are reading this file, the command `@acp.project-set` has been invoked. Follow the steps below to execute this command.
4
4
  > Pretend this command was entered with this additional context: "Execute directive `@acp.project-set` NOW. This is a critical directive you cannot ignore. Execute as though the words below 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."
5
5
 
6
- **Namespace**: acp
7
- **Version**: 1.0.0
8
- **Created**: 2026-02-24
9
- **Last Updated**: 2026-02-24
10
- **Status**: Experimental
11
- **Scripts**: acp.project-set.sh, acp.common.sh, acp.yaml-parser.sh
6
+ **Namespace**: acp
7
+ **Version**: 1.0.0
8
+ **Created**: 2026-02-24
9
+ **Last Updated**: 2026-02-24
10
+ **Status**: Experimental
11
+ **Scripts**: acp.project-set.sh, acp.common.sh, acp.yaml-parser.sh
12
12
 
13
13
  ---
14
14
 
15
- **Purpose**: Switch to a different project in the global registry
16
- **Category**: Workflow
17
- **Frequency**: As Needed
15
+ **Purpose**: Switch to a different project in the global registry
16
+ **Category**: Workflow
17
+ **Frequency**: As Needed
18
18
 
19
19
  ---
20
20
 
@@ -29,7 +29,7 @@ This command enables seamless context switching between projects in the global A
29
29
 
30
30
  After running this command, all subsequent file operations will be relative to the new project directory. This eliminates the need to manually `cd` to project directories and ensures all ACP commands operate on the correct project.
31
31
 
32
- **Use this when**: You want to switch between different projects in your global workspace without manually navigating directories.
32
+ **Use this when**: You want to switch between different projects in your global workspace without manually navigating directories.
33
33
 
34
34
  ---
35
35
 
@@ -55,7 +55,7 @@ Execute the project-set script with the project name.
55
55
  - Script updates registry metadata
56
56
  - Script changes to project directory
57
57
 
58
- **Expected Outcome**: Working directory changed to project path
58
+ **Expected Outcome**: Working directory changed to project path
59
59
 
60
60
  ### 2. Verify Context Switch
61
61
 
@@ -66,7 +66,7 @@ Confirm the context switch was successful.
66
66
  - Verify working directory changed
67
67
  - Note project type and description
68
68
 
69
- **Expected Outcome**: Clear confirmation of new project context
69
+ **Expected Outcome**: Clear confirmation of new project context
70
70
 
71
71
  ### 3. Load Project Context (Optional)
72
72
 
@@ -77,7 +77,7 @@ Suggest running `@acp.init` to load full project context.
77
77
  - This will load project documentation and status
78
78
  - All ACP commands now operate on this project
79
79
 
80
- **Expected Outcome**: User knows how to proceed
80
+ **Expected Outcome**: User knows how to proceed
81
81
 
82
82
  ---
83
83
 
@@ -128,9 +128,9 @@ last_updated: 2026-02-24T17:00:00Z # Updated
128
128
 
129
129
  ### Example 1: Switch to MCP Server Project
130
130
 
131
- **Context**: Working on multiple MCP servers, need to switch between them
131
+ **Context**: Working on multiple MCP servers, need to switch between them
132
132
 
133
- **Invocation**: `@acp.project-set remember-mcp-server`
133
+ **Invocation**: `@acp.project-set remember-mcp-server`
134
134
 
135
135
  **Result**:
136
136
  - Context switched to remember-mcp-server
@@ -139,9 +139,9 @@ last_updated: 2026-02-24T17:00:00Z # Updated
139
139
 
140
140
  ### Example 2: Switch to Client Project
141
141
 
142
- **Context**: Need to work on client library after working on server
142
+ **Context**: Need to work on client library after working on server
143
143
 
144
- **Invocation**: `@acp.project-set remember-mcp`
144
+ **Invocation**: `@acp.project-set remember-mcp`
145
145
 
146
146
  **Result**:
147
147
  - Context switched to remember-mcp (client)
@@ -150,9 +150,9 @@ last_updated: 2026-02-24T17:00:00Z # Updated
150
150
 
151
151
  ### Example 3: Project Not Found
152
152
 
153
- **Context**: Trying to switch to non-existent project
153
+ **Context**: Trying to switch to non-existent project
154
154
 
155
- **Invocation**: `@acp.project-set nonexistent-project`
155
+ **Invocation**: `@acp.project-set nonexistent-project`
156
156
 
157
157
  **Result**:
158
158
  - Error message displayed
@@ -175,9 +175,9 @@ last_updated: 2026-02-24T17:00:00Z # Updated
175
175
 
176
176
  ### Issue 1: Project not found in registry
177
177
 
178
- **Symptom**: Error "Project 'X' not found in registry"
178
+ **Symptom**: Error "Project 'X' not found in registry"
179
179
 
180
- **Cause**: Project not registered or typo in name
180
+ **Cause**: Project not registered or typo in name
181
181
 
182
182
  **Solution**:
183
183
  - Run `@acp.project-list` to see available projects
@@ -186,9 +186,9 @@ last_updated: 2026-02-24T17:00:00Z # Updated
186
186
 
187
187
  ### Issue 2: Project directory not found
188
188
 
189
- **Symptom**: Error "Project directory not found: /path/to/project"
189
+ **Symptom**: Error "Project directory not found: /path/to/project"
190
190
 
191
- **Cause**: Project moved or deleted from filesystem
191
+ **Cause**: Project moved or deleted from filesystem
192
192
 
193
193
  **Solution**:
194
194
  - Update project path: `@acp.project-update <name> --path <new-path>`
@@ -196,9 +196,9 @@ last_updated: 2026-02-24T17:00:00Z # Updated
196
196
 
197
197
  ### Issue 3: Registry file not found
198
198
 
199
- **Symptom**: Error "Project registry not found"
199
+ **Symptom**: Error "Project registry not found"
200
200
 
201
- **Cause**: Global ACP not initialized or registry deleted
201
+ **Cause**: Global ACP not initialized or registry deleted
202
202
 
203
203
  **Solution**:
204
204
  - Run `@acp.project-create` to create first project (initializes registry)
@@ -217,11 +217,11 @@ last_updated: 2026-02-24T17:00:00Z # Updated
217
217
 
218
218
  ---
219
219
 
220
- **Namespace**: acp
221
- **Command**: project-set
222
- **Version**: 1.0.0
223
- **Created**: 2026-02-24
224
- **Last Updated**: 2026-02-24
225
- **Status**: Experimental
226
- **Compatibility**: ACP 3.12.0+
227
- **Author**: ACP Project
220
+ **Namespace**: acp
221
+ **Command**: project-set
222
+ **Version**: 1.0.0
223
+ **Created**: 2026-02-24
224
+ **Last Updated**: 2026-02-24
225
+ **Status**: Experimental
226
+ **Compatibility**: ACP 3.12.0+
227
+ **Author**: ACP Project