rrce-workflow 0.1.5 → 0.2.6

package/agent-core/prompts/documentation.md

@@ -48,7 +48,7 @@ Non-Negotiables
 6. Close the loop in `meta.json` when working within a task by setting `agents.documentation.status`, refreshing `checklist`, and updating overall `status`.
 
 Path Resolution
-- Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
+- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
   - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
   - `workspace`: Data in `<workspace>/.rrce-workflow/`
   - `both`: **Dual storage** - data stored in BOTH locations simultaneously
@@ -56,7 +56,7 @@ Path Resolution
     - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
     - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
 - Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` (always `~/.rrce-workflow`)
+- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
 - Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
 

package/agent-core/prompts/executor.md

@@ -52,17 +52,14 @@ Non-Negotiables
 6. Update `meta.json` as you proceed so statuses stay accurate.
 
 Path Resolution
-- Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
-  - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
+- **Config file**: `.rrce-workflow/config.yaml` (read this first to resolve paths)
+- Storage mode: Determined by `config.yaml` → `storage.mode` (default: `global`)
+  - `global`: Data in `{{RRCE_HOME}}/workspaces/<workspace-name>/`
   - `workspace`: Data in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data stored in BOTH locations simultaneously
-    - Primary (for reads): `<workspace>/.rrce-workflow/`
-    - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
-    - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
+  - `both`: Dual storage - data in BOTH locations
 - Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` (always `~/.rrce-workflow`)
-- Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
+- Global home: `{{RRCE_HOME}}` - **To resolve:** read `config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
+- Workspace name: `{{WORKSPACE_NAME}}` (from `config.yaml` → `project.name`)
 
 Cross-Project References
 - Reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project>/knowledge/`

package/agent-core/prompts/init.md

@@ -34,17 +34,18 @@ Non-Negotiables
 6. Keep output actionable and scannable; use structured sections.
 
 Path Resolution
-- Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
-  - `global`: Data stored in `~/.rrce-workflow/workspaces/<workspace-name>/`
+- **Config file**: `.rrce-workflow/config.yaml` (read this first to resolve paths)
+- Storage mode: Determined by `config.yaml` → `storage.mode` (default: `global`)
+  - `global`: Data stored in `{{RRCE_HOME}}/workspaces/<workspace-name>/`
   - `workspace`: Data stored in `<workspace>/.rrce-workflow/`
-  - `both`: **Dual storage** - data stored in BOTH locations simultaneously
-    - Primary (for reads): `<workspace>/.rrce-workflow/`
-    - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
-    - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
+  - `both`: **Dual storage** - data in BOTH locations
 - Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` (always `~/.rrce-workflow`)
+- Global home: `{{RRCE_HOME}}` - **To resolve:**
+  1. Read `.rrce-workflow/config.yaml`
+  2. If `storage.globalPath` exists, use that value
+  3. Otherwise, default to `~/.rrce-workflow`
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
-- Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
+- Workspace name: `{{WORKSPACE_NAME}}` (from `config.yaml` → `project.name` or directory name)
 
 Cross-Project References
 - To reference another project's context: `{{RRCE_HOME}}/workspaces/<other-project-name>/knowledge/`

package/agent-core/prompts/planning_orchestrator.md

@@ -44,7 +44,7 @@ Non-Negotiables
 6. Keep the written plan under 500 lines and reference supporting materials explicitly.
 
 Path Resolution
-- Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
+- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
   - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
   - `workspace`: Data in `<workspace>/.rrce-workflow/`
   - `both`: **Dual storage** - data stored in BOTH locations simultaneously
@@ -52,7 +52,7 @@ Path Resolution
     - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
     - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
 - Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` (always `~/.rrce-workflow`)
+- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
 - Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
 

package/agent-core/prompts/research_discussion.md

@@ -38,7 +38,7 @@ Non-Negotiables
 6. Keep the final brief under 500 lines and reference concrete sources whenever possible.
 
 Path Resolution
-- Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
+- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
   - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
   - `workspace`: Data in `<workspace>/.rrce-workflow/`
   - `both`: **Dual storage** - data stored in BOTH locations simultaneously
@@ -46,7 +46,7 @@ Path Resolution
     - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
     - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
 - Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` (always `~/.rrce-workflow`)
+- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
 - Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
 

package/agent-core/prompts/sync.md

@@ -38,7 +38,7 @@ Non-Negotiables
 5. Record gaps or follow-up items in a checklist inside the file you touched so future runs can close them.
 
 Path Resolution
-- Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
+- Storage mode: Determined by `config.yaml → `storage.mode`` → global config → default (`global`)
   - `global`: Data in `~/.rrce-workflow/workspaces/<workspace-name>/`
   - `workspace`: Data in `<workspace>/.rrce-workflow/`
   - `both`: **Dual storage** - data stored in BOTH locations simultaneously
@@ -46,7 +46,7 @@ Path Resolution
     - Secondary (auto-synced): `~/.rrce-workflow/workspaces/<workspace-name>/`
     - When writing, always write to `{{RRCE_DATA}}` - the system ensures both locations stay in sync
 - Data path: `{{RRCE_DATA}}` (resolves to primary storage based on mode)
-- Global home: `{{RRCE_HOME}}` (always `~/.rrce-workflow`)
+- Global home: `{{RRCE_HOME}}` - **To resolve:** read `.rrce-workflow/config.yaml` → `storage.globalPath`, or default `~/.rrce-workflow`
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
 - Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
 

package/agent-core/templates/documentation_output.md

@@ -1,10 +1,10 @@
 <!--
   RRCE Template Variables:
   - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
-      - global: ~/.rrce-workflow/workspaces/<workspace-name>/
+      - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)
-  - {{RRCE_HOME}}: Always ~/.rrce-workflow
+  - {{RRCE_HOME}}: Global home (default: ~/.rrce-workflow, customizable via storage.globalPath in config)
   - {{WORKSPACE_ROOT}}: Workspace root directory
   - {{WORKSPACE_NAME}}: Workspace name from config or directory name
 -->

package/agent-core/templates/executor_output.md

@@ -1,10 +1,10 @@
 <!--
   RRCE Template Variables:
   - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
-      - global: ~/.rrce-workflow/workspaces/<workspace-name>/
+      - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)
-  - {{RRCE_HOME}}: Always ~/.rrce-workflow
+  - {{RRCE_HOME}}: Global home (default: ~/.rrce-workflow, customizable via storage.globalPath in config)
   - {{WORKSPACE_ROOT}}: Workspace root directory
   - {{WORKSPACE_NAME}}: Workspace name from config or directory name
 -->

package/agent-core/templates/init_output.md

@@ -1,10 +1,10 @@
 <!--
   RRCE Template Variables:
   - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
-      - global: ~/.rrce-workflow/workspaces/<workspace-name>/
+      - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)
-  - {{RRCE_HOME}}: Always ~/.rrce-workflow
+  - {{RRCE_HOME}}: Global home (default: ~/.rrce-workflow, customizable via storage.globalPath in config)
   - {{WORKSPACE_ROOT}}: Workspace root directory
   - {{WORKSPACE_NAME}}: Workspace name from config or directory name
 -->

package/agent-core/templates/planning_output.md

@@ -1,10 +1,10 @@
 <!--
   RRCE Template Variables:
   - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
-      - global: ~/.rrce-workflow/workspaces/<workspace-name>/
+      - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)
-  - {{RRCE_HOME}}: Always ~/.rrce-workflow
+  - {{RRCE_HOME}}: Global home (default: ~/.rrce-workflow, customizable via storage.globalPath in config)
   - {{WORKSPACE_ROOT}}: Workspace root directory
   - {{WORKSPACE_NAME}}: Workspace name from config or directory name
 -->

package/agent-core/templates/research_output.md

@@ -1,10 +1,10 @@
 <!--
   RRCE Template Variables:
   - {{RRCE_DATA}}: Primary storage path (resolves based on storage mode in .rrce-workflow.yaml)
-      - global: ~/.rrce-workflow/workspaces/<workspace-name>/
+      - global: {{RRCE_HOME}}/workspaces/<workspace-name>/
       - workspace: <workspace>/.rrce-workflow/
       - both: <workspace>/.rrce-workflow/ (primary, auto-synced to global)
-  - {{RRCE_HOME}}: Always ~/.rrce-workflow
+  - {{RRCE_HOME}}: Global home (default: ~/.rrce-workflow, customizable via storage.globalPath in config)
   - {{WORKSPACE_ROOT}}: Workspace root directory
   - {{WORKSPACE_NAME}}: Workspace name from config or directory name
 -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rrce-workflow",
-  "version": "0.1.5",
+  "version": "0.2.6",
   "description": "RRCE-Workflow TUI - Agentic code workflow generator for AI-assisted development",
   "author": "RRCE Team",
   "license": "MIT",

package/src/commands/wizard/index.ts

@@ -0,0 +1,114 @@
+import { intro, select, spinner, note, outro, cancel, isCancel } from '@clack/prompts';
+import pc from 'picocolors';
+import * as fs from 'fs';
+import { getGitUser } from '../../lib/git';
+import { 
+  detectWorkspaceRoot, 
+  getWorkspaceName, 
+  listGlobalProjects, 
+  getLocalWorkspacePath,
+  getConfigPath
+} from '../../lib/paths';
+
+// Import flows
+import { runSetupFlow } from './setup-flow';
+import { runLinkProjectsFlow } from './link-flow';
+import { runSyncToGlobalFlow } from './sync-flow';
+import { runUpdateFlow } from './update-flow';
+
+export async function runWizard() {
+  intro(pc.cyan(pc.inverse(' RRCE-Workflow Setup ')));
+
+  const s = spinner();
+  s.start('Detecting environment');
+
+  const workspacePath = detectWorkspaceRoot();
+  const workspaceName = getWorkspaceName(workspacePath);
+  const gitUser = getGitUser();
+
+  await new Promise(r => setTimeout(r, 800)); // Dramatic pause
+  s.stop('Environment detected');
+
+  note(
+    `Git User:  ${pc.bold(gitUser || '(not found)')}
+Workspace: ${pc.bold(workspaceName)}`,
+    'Context'
+  );
+
+  // Check for existing projects in global storage
+  const existingProjects = listGlobalProjects(workspaceName);
+  
+  // Check if already configured (using getConfigPath for new/legacy support)
+  const configFilePath = getConfigPath(workspacePath);
+  const isAlreadyConfigured = fs.existsSync(configFilePath);
+  
+  // Check current storage mode from config
+  let currentStorageMode: string | null = null;
+  if (isAlreadyConfigured) {
+    try {
+      const configContent = fs.readFileSync(configFilePath, 'utf-8');
+      const modeMatch = configContent.match(/mode:\s*(global|workspace|both)/);
+      currentStorageMode = modeMatch?.[1] ?? null;
+    } catch {
+      // Ignore parse errors
+    }
+  }
+
+  // Check if workspace has local data that could be synced
+  const localDataPath = getLocalWorkspacePath(workspacePath);
+  const hasLocalData = fs.existsSync(localDataPath);
+
+  // If already configured, show menu
+  if (isAlreadyConfigured) {
+    const menuOptions: { value: string; label: string; hint?: string }[] = [];
+    
+    // Add link option if other projects exist
+    if (existingProjects.length > 0) {
+      menuOptions.push({ 
+        value: 'link', 
+        label: 'Link other project knowledge', 
+        hint: `${existingProjects.length} projects available` 
+      });
+    }
+    
+    // Add sync to global option if using workspace-only mode
+    if (currentStorageMode === 'workspace' && hasLocalData) {
+      menuOptions.push({ 
+        value: 'sync-global', 
+        label: 'Sync to global storage', 
+        hint: 'Share knowledge with other projects' 
+      });
+    }
+    
+    menuOptions.push({ value: 'update', label: 'Update from package', hint: 'Get latest prompts & templates' });
+    menuOptions.push({ value: 'exit', label: 'Exit' });
+
+    const action = await select({
+      message: 'This workspace is already configured. What would you like to do?',
+      options: menuOptions,
+    });
+
+    if (isCancel(action) || action === 'exit') {
+      outro('Exited.');
+      process.exit(0);
+    }
+
+    if (action === 'link') {
+      await runLinkProjectsFlow(workspacePath, workspaceName, existingProjects);
+      return;
+    }
+
+    if (action === 'sync-global') {
+      await runSyncToGlobalFlow(workspacePath, workspaceName);
+      return;
+    }
+
+    if (action === 'update') {
+      await runUpdateFlow(workspacePath, workspaceName, currentStorageMode);
+      return;
+    }
+  }
+
+  // Run full setup flow for new workspaces
+  await runSetupFlow(workspacePath, workspaceName, existingProjects);
+}

package/src/commands/wizard/link-flow.ts

@@ -0,0 +1,101 @@
+import { multiselect, spinner, note, outro, cancel, isCancel } from '@clack/prompts';
+import pc from 'picocolors';
+import * as fs from 'fs';
+import { listGlobalProjects, getEffectiveRRCEHome, getConfigPath } from '../../lib/paths';
+import { generateVSCodeWorkspace } from './vscode';
+
+/**
+ * Run the link-only flow for adding other project knowledge to an existing workspace
+ */
+export async function runLinkProjectsFlow(
+  workspacePath: string, 
+  workspaceName: string, 
+  existingProjects?: string[]
+) {
+  // Get projects if not provided
+  const projects = existingProjects ?? listGlobalProjects(workspaceName);
+  
+  if (projects.length === 0) {
+    outro(pc.yellow('No other projects found in global storage.'));
+    return;
+  }
+
+  const customGlobalPath = getEffectiveRRCEHome(workspacePath);
+  
+  const linkedProjects = await multiselect({
+    message: 'Select projects to link:',
+    options: projects.map(name => ({
+      value: name,
+      label: name,
+      hint: `${customGlobalPath}/workspaces/${name}/knowledge`
+    })),
+    required: true,
+  });
+
+  if (isCancel(linkedProjects)) {
+    cancel('Cancelled.');
+    process.exit(0);
+  }
+
+  const selectedProjects = linkedProjects as string[];
+
+  if (selectedProjects.length === 0) {
+    outro('No projects selected.');
+    return;
+  }
+
+  const s = spinner();
+  s.start('Linking projects');
+
+  // Update config.yaml with linked projects
+  const configFilePath = getConfigPath(workspacePath);
+  let configContent = fs.readFileSync(configFilePath, 'utf-8');
+
+  // Check if linked_projects section exists
+  if (configContent.includes('linked_projects:')) {
+    // Append to existing section - find and update
+    const lines = configContent.split('\n');
+    const linkedIndex = lines.findIndex(l => l.trim() === 'linked_projects:');
+    if (linkedIndex !== -1) {
+      // Find where to insert new projects (after existing ones)
+      let insertIndex = linkedIndex + 1;
+      while (insertIndex < lines.length && lines[insertIndex]?.startsWith('  - ')) {
+        insertIndex++;
+      }
+      // Add new projects that aren't already there
+      for (const name of selectedProjects) {
+        if (!configContent.includes(`  - ${name}`)) {
+          lines.splice(insertIndex, 0, `  - ${name}`);
+          insertIndex++;
+        }
+      }
+      configContent = lines.join('\n');
+    }
+  } else {
+    // Add new linked_projects section
+    configContent += `\nlinked_projects:\n`;
+    selectedProjects.forEach(name => {
+      configContent += `  - ${name}\n`;
+    });
+  }
+
+  fs.writeFileSync(configFilePath, configContent);
+
+  // Update VSCode workspace file
+  generateVSCodeWorkspace(workspacePath, workspaceName, selectedProjects, customGlobalPath);
+
+  s.stop('Projects linked');
+
+  // Show summary
+  const workspaceFile = `${workspaceName}.code-workspace`;
+  const summary = [
+    `Linked projects:`,
+    ...selectedProjects.map(p => `  ✓ ${p}`),
+    ``,
+    `Workspace file: ${pc.cyan(workspaceFile)}`,
+  ];
+
+  note(summary.join('\n'), 'Link Summary');
+
+  outro(pc.green(`✓ Projects linked! Open ${pc.bold(workspaceFile)} in VSCode to access linked knowledge.`));
+}