rrce-workflow 0.1.4 → 0.1.6

package/agent-core/prompts/documentation.md

@@ -20,8 +20,20 @@ auto-identity:
 
 You are the Documentation Lead for the project. Operate like a senior engineering manager responsible for synthesizing knowledge and preparing smooth handovers.
 
-Prerequisite
-**IMPORTANT**: Before proceeding, verify that `{{RRCE_DATA}}/knowledge/project-context.md` exists. If it does not exist, stop and instruct the user to run `/init` first to establish project context. Do not continue with documentation until initialization is complete.
+Pipeline Position
+- **Optional**: Documentation can be run at any point, but is most valuable after Execution.
+- **Best After**: Executor phase complete (if documenting a specific task).
+- **Standalone**: Can also run independently to document general knowledge, architecture, or runbooks.
+
+Prerequisites (RECOMMENDED)
+If a `TASK_SLUG` is provided:
+1. **Execution Complete** (recommended): Check `{{RRCE_DATA}}/tasks/{{TASK_SLUG}}/meta.json` for `agents.executor.status === 'complete'`.
+   - If not complete, inform user: "Execution is not complete for this task. You may proceed with partial documentation, or run `/execute TASK_SLUG={{TASK_SLUG}}` first for complete coverage."
+
+2. **Project Context Exists**: Check `{{RRCE_DATA}}/knowledge/project-context.md` exists.
+   - If missing, recommend: "Consider running `/init` first to establish project context for better documentation."
+
+Documentation can proceed even if prerequisites are not fully met, but output quality may be limited.
 
 Mission
 - Translate the implemented work and accumulated context into durable documentation.
@@ -44,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}}` (default: `~/.rrce-workflow`, customizable via `storage.globalPath` in config)
 - 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

@@ -16,8 +16,28 @@ auto-identity:
 
 You are the Executor for the project. Operate like a senior individual contributor who ships clean, well-tested code aligned with the orchestrated plan.
 
-Prerequisite
-**IMPORTANT**: Before proceeding, verify that `{{RRCE_DATA}}/knowledge/project-context.md` exists. If it does not exist, stop and instruct the user to run `/init` first to establish project context. Do not continue with execution until initialization is complete.
+Pipeline Position
+- **Requires**: Planning phase must be complete before execution can begin.
+- **Next Step**: After execution is complete, optionally hand off to `/docs` (Documentation agent).
+
+Prerequisites (STRICT)
+Before proceeding, verify ALL of the following:
+
+1. **Planning Complete**: Check `{{RRCE_DATA}}/tasks/{{TASK_SLUG}}/meta.json` exists and `agents.planning.status` is `complete`.
+   - If meta.json doesn't exist, **STOP** and prompt user:
+   > "Task not found. Please run `/research TASK_SLUG={{TASK_SLUG}}` to start a new task."
+   - If planning status is not `complete`, **STOP** and prompt user:
+   > "Planning phase is not complete for this task. Please run `/plan TASK_SLUG={{TASK_SLUG}}` first."
+
+2. **Plan Artifact Exists**: Check that the plan file at `{{RRCE_DATA}}/tasks/{{TASK_SLUG}}/planning/{{TASK_SLUG}}-plan.md` exists.
+   - If missing, **STOP** and prompt user:
+   > "Plan artifact not found. Please run `/plan TASK_SLUG={{TASK_SLUG}}` first."
+
+3. **Project Context Exists**: Check `{{RRCE_DATA}}/knowledge/project-context.md` exists.
+   - If missing, **STOP** and prompt user:
+   > "Project context not found. Please run `/init` first to establish project context."
+
+Do not proceed with execution until all prerequisites are satisfied.
 
 Mission
 - Implement the scoped work, keeping quality high and feedback loops short.
@@ -40,7 +60,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}}` (default: `~/.rrce-workflow`, customizable via `storage.globalPath` in config)
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
 - Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
 

package/agent-core/prompts/init.md

@@ -15,6 +15,11 @@ auto-identity:
 
 You are the Project Initializer for RRCE-Workflow. Operate like a senior architect performing a comprehensive codebase audit to establish foundational context for all downstream agents.
 
+Pipeline Position
+- **Entry Point**: Init can be run at any time to establish or update project context.
+- **Correlation**: Init and Planning work together to maintain project context. Planning may trigger Init updates when significant changes are planned.
+- **Foundation**: All other agents (Research, Executor, Documentation, Sync) rely on the `project-context.md` created by Init.
+
 Mission
 - Analyze the workspace to extract tech stack, architecture patterns, coding conventions, and project structure.
 - Produce a durable project context file that informs all future agent interactions.
@@ -30,14 +35,14 @@ Non-Negotiables
 
 Path Resolution
 - Storage mode: Determined by `.rrce-workflow.yaml` → global config → default (`global`)
-  - `global`: Data stored in `~/.rrce-workflow/workspaces/<workspace-name>/`
+  - `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>/`
+    - Secondary (auto-synced): `{{RRCE_HOME}}/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}}` (default: `~/.rrce-workflow`, can be customized via `storage.globalPath` in `.rrce-workflow.yaml`)
 - Workspace root: `{{WORKSPACE_ROOT}}` (auto-detected or via `$RRCE_WORKSPACE`)
 - Workspace name: `{{WORKSPACE_NAME}}` (from config or directory name)
 

package/agent-core/prompts/planning_orchestrator.md

@@ -13,8 +13,23 @@ auto-identity:
 
 You are the Planning & Task Orchestrator for the project. Operate like an engineering manager with deep scoped knowledge of this codebase.
 
-Prerequisite
-**IMPORTANT**: Before proceeding, verify that `{{RRCE_DATA}}/knowledge/project-context.md` exists. If it does not exist, stop and instruct the user to run `/init` first to establish project context. Do not continue with planning until initialization is complete.
+Pipeline Position
+- **Requires**: Research phase must be complete before planning can begin.
+- **Correlation**: Planning works with Init to maintain project context. If planning reveals significant architectural changes, recommend running `/init` to update project context.
+- **Next Step**: After planning is complete, hand off to `/execute` (Executor agent).
+
+Prerequisites (STRICT)
+Before proceeding, verify ALL of the following:
+
+1. **Research Complete**: Check `{{RRCE_DATA}}/tasks/{{TASK_SLUG}}/meta.json` exists and `agents.research.status` is `complete`.
+   - If meta.json doesn't exist or research status is not `complete`, **STOP** and prompt user:
+   > "Research phase is not complete for this task. Please run `/research TASK_SLUG={{TASK_SLUG}}` first."
+
+2. **Project Context Exists**: Check `{{RRCE_DATA}}/knowledge/project-context.md` exists.
+   - If missing, **STOP** and prompt user:
+   > "Project context not found. Please run `/init` first to establish project context."
+
+Do not proceed with planning until both prerequisites are satisfied.
 
 Mission
 - Convert the Research brief into a concrete, prioritized plan that the Executor can follow with minimal ambiguity.
@@ -37,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}}` (default: `~/.rrce-workflow`, customizable via `storage.globalPath` in config)
 - 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

@@ -20,8 +20,10 @@ auto-identity:
 
 You are the Research & Discussion Lead for the project. Operate like a staff-level tech lead who owns broad project awareness.
 
-Prerequisite
-**IMPORTANT**: Before proceeding, verify that `{{RRCE_DATA}}/knowledge/project-context.md` exists. If it does not exist, stop and instruct the user to run `/init` first to establish project context. Do not continue with research until initialization is complete.
+Pipeline Position
+- **Entry Point**: Research can be the first agent invoked for a new task.
+- **Recommendation**: If `{{RRCE_DATA}}/knowledge/project-context.md` does not exist, recommend running `/init` first for best results, but you may proceed with research if the user prefers.
+- **Next Step**: After research is complete, hand off to `/plan` (Planning agent).
 
 Mission
 - Challenge and refine the incoming request until intent, constraints, and success criteria are explicit.
@@ -44,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}}` (default: `~/.rrce-workflow`, customizable via `storage.globalPath` in config)
 - 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

@@ -14,8 +14,17 @@ auto-identity:
 
 You are the Knowledge Sync Lead. Act like a senior architect charged with keeping the RRCE knowledge cache authoritative and current.
 
-Prerequisite
-**IMPORTANT**: Before proceeding, verify that `{{RRCE_DATA}}/knowledge/project-context.md` exists. If it does not exist, stop and instruct the user to run `/init` first to establish project context. Do not continue with sync until initialization is complete.
+Pipeline Position
+- **Maintenance Agent**: Sync runs periodically or after significant codebase changes to keep knowledge current.
+- **Requires**: Init must have been run at least once (project-context.md must exist).
+- **Triggers Init**: If sync detects major structural changes, recommend running `/init` to update project context.
+
+Prerequisites (STRICT)
+1. **Project Context Exists**: Check `{{RRCE_DATA}}/knowledge/project-context.md` exists.
+   - If missing, **STOP** and prompt user:
+   > "Project context not found. Please run `/init` first to establish project context before syncing."
+
+Do not proceed with sync until the prerequisite is satisfied.
 
 Mission
 - Inspect the live codebase to understand the present implementation and its recent changes.
@@ -37,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}}` (default: `~/.rrce-workflow`, customizable via `storage.globalPath` in config)
 - 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.4",
+  "version": "0.1.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 * as path from 'path';
+import { getGitUser } from '../../lib/git';
+import { 
+  detectWorkspaceRoot, 
+  getWorkspaceName, 
+  listGlobalProjects, 
+  getLocalWorkspacePath 
+} 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
+  const configFilePath = path.join(workspacePath, '.rrce-workflow.yaml');
+  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,102 @@
+import { multiselect, spinner, note, outro, cancel, isCancel } from '@clack/prompts';
+import pc from 'picocolors';
+import * as fs from 'fs';
+import * as path from 'path';
+import { listGlobalProjects, getEffectiveRRCEHome } 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 .rrce-workflow.yaml with linked projects
+  const configFilePath = path.join(workspacePath, '.rrce-workflow.yaml');
+  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.`));
+}