rrce-workflow 0.3.19 → 0.3.22

package/agent-core/prompts/_base.md

@@ -8,6 +8,11 @@ Use values from the **System Context** table above. Never guess or construct pat
 - `WORKSPACE_ROOT` - Project source code location
 - `RRCE_HOME` - Global RRCE installation directory
 
+**If System Context is missing or incorrect:**
+1. Call `rrce_resolve_path(project: "PROJECT_NAME")` to get authoritative paths
+2. If resolution fails, call `rrce_list_projects()` to see available projects
+3. If both fail, ask the user for clarification before proceeding
+
 ## Tool Preference Order
 1. **Context bundling** (`rrce_get_context_bundle`) - single call aggregates project context + knowledge + code
 2. **Semantic search** (`rrce_search_knowledge`, `rrce_search_code`) - finds concepts without exact matches

package/agent-core/prompts/design.md

@@ -2,7 +2,7 @@
 name: RRCE Design
 description: Research requirements and create execution plan in a single interactive session. Combines clarification and task breakdown.
 argument-hint: TASK_SLUG=<slug> REQUEST="<user prompt>" [TITLE="<task title>"]
-tools: ['rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_search_tasks', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_list_projects', 'rrce_create_task', 'rrce_update_task', 'websearch', 'codesearch', 'read', 'write', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_search_tasks', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_list_projects', 'rrce_create_task', 'rrce_update_task', 'rrce_start_session', 'rrce_end_session', 'rrce_update_agent_todos', 'websearch', 'codesearch', 'read', 'write', 'glob', 'grep']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter a task slug (kebab-case identifier)"

package/agent-core/prompts/develop.md

@@ -2,7 +2,7 @@
 name: RRCE Develop
 description: Execute the planned tasks to deliver working code and tests. The ONLY agent authorized to modify source code.
 argument-hint: "TASK_SLUG=<slug> [BRANCH=<git ref>]"
-tools: ['rrce_prefetch_task_context', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_index_knowledge', 'rrce_update_task', 'rrce_start_session', 'rrce_end_session', 'rrce_update_agent_todos', 'read', 'write', 'edit', 'bash', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_prefetch_task_context', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_find_related_files', 'rrce_get_project_context', 'rrce_validate_phase', 'rrce_index_knowledge', 'rrce_update_task', 'rrce_start_session', 'rrce_end_session', 'rrce_update_agent_todos', 'read', 'write', 'edit', 'bash', 'glob', 'grep']
 required-args:
   - name: TASK_SLUG
     prompt: "Enter the task slug to execute"

package/agent-core/prompts/doctor.md

@@ -2,7 +2,7 @@
 name: RRCE Doctor
 description: Analyze codebase health using semantic search; identify issues and recommend improvement tasks.
 argument-hint: "[PROJECT_NAME=<name>] [FOCUS_AREA=<area>]"
-tools: ['rrce_search_knowledge', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_create_task', 'read', 'write', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_create_task', 'read', 'write', 'glob', 'grep']
 required-args: []
 optional-args:
   - name: PROJECT_NAME

package/agent-core/prompts/documentation.md

@@ -2,7 +2,7 @@
 name: RRCE Documentation
 description: Produce project documentation aligned with the latest delivery.
 argument-hint: "DOC_TYPE=<type> [TASK_SLUG=<slug> | TARGET_PATH=<relative>] [RELEASE_REF=<tag/sha>]"
-tools: ['rrce_search_knowledge', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_update_task', 'read', 'write', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_prefetch_task_context', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_update_task', 'read', 'write', 'glob', 'grep']
 required-args:
   - name: DOC_TYPE
     prompt: "Enter the documentation type (e.g., api, architecture, runbook, changelog)"

package/agent-core/prompts/init.md

@@ -2,7 +2,7 @@
 name: RRCE Init
 description: Initialize project context and semantic search index by analyzing codebase structure, tech stack, and conventions.
 argument-hint: "[PROJECT_NAME=<name>]"
-tools: ['rrce_search_knowledge', 'rrce_index_knowledge', 'rrce_get_project_context', 'rrce_list_projects', 'read', 'write', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_search_symbols', 'rrce_get_file_summary', 'rrce_index_knowledge', 'rrce_get_project_context', 'rrce_list_projects', 'rrce_start_session', 'rrce_end_session', 'read', 'write', 'glob', 'grep']
 required-args: []
 optional-args:
   - name: PROJECT_NAME

package/agent-core/prompts/sync.md

@@ -2,7 +2,7 @@
 name: RRCE Sync
 description: Reconcile project state with the RRCE knowledge base and update semantic index.
 argument-hint: "[SCOPE=<path|module>]"
-tools: ['rrce_search_knowledge', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_update_task', 'read', 'write', 'glob', 'grep']
+tools: ['rrce_resolve_path', 'rrce_get_context_bundle', 'rrce_search_knowledge', 'rrce_search_code', 'rrce_get_project_context', 'rrce_index_knowledge', 'rrce_list_projects', 'rrce_update_task', 'read', 'write', 'glob', 'grep']
 required-args: []
 optional-args:
   - name: SCOPE
@@ -33,14 +33,15 @@ Non-Negotiables
 3. Version every knowledge edit by stamping an ISO date (e.g. `Updated: 2024-11-01`) near the top of the section you modify.
 4. Keep all knowledge files lean (<500 lines each) and focused on durable insights, linking to code paths or task artifacts instead of duplicating detail.
 5. Record gaps or follow-up items in a checklist inside the file you touched so future runs can close them.
-6. **Semantic Indexing (MANDATORY)**: After updating any knowledge files, run the indexer to keep search current:
-   ```
-   Tool: rrce_index_knowledge
-   Args: { "project": "{{WORKSPACE_NAME}}" }
-   ```
-   Tool: rrce_index_knowledge
-   Args: { "project": "{{WORKSPACE_NAME}}" }
-   ```
+6. **Semantic Indexing (MANDATORY)**: After updating any knowledge files, run the indexer to keep search current.
+
+## Reindexing Guidance
+
+| Scenario | Tool Argument | Rationale |
+|----------|---------------|-----------|
+| Routine updates | `{ "project": "{{WORKSPACE_NAME}}" }` | Incremental (fastest). Only updates changed files. |
+| Major refactors | `{ "project": "{{WORKSPACE_NAME}}", "force": true }` | Forces re-calculation of hashes for all files without wiping. |
+| Corrupt index / Stale vectors | `{ "project": "{{WORKSPACE_NAME}}", "clean": true }` | Wipes index files and rebuilds from scratch. Resolves vector drift. |
 
 Deliverable
 - Updated `{{RRCE_DATA}}/knowledge/*` files that accurately reflect the present project state, each carrying the latest `Updated:` marker and lean checklist.