@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.
- package/AGENT.md +10 -3
- package/CHANGELOG.md +19 -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/patterns/pattern.template.md +22 -22
- package/agent/progress.template.yaml +13 -3
- package/agent/progress.yaml +78 -1
- 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/task-1-{title}.template.md +18 -18
- package/dist/server-factory.js +637 -41
- 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/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 +131 -42
- 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/utils/admin.spec.ts +70 -0
- 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
|