@ginkoai/cli 2.0.1 → 2.0.3

package/dist/commands/roadmap/index.js

@@ -0,0 +1,208 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-11
+ * @tags: [roadmap, cli, epic, product-management, ADR-056, now-next-later]
+ * @related: [../graph/api-client.ts, ADR-056]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { GraphApiClient } from '../graph/api-client.js';
+import { loadGraphConfig } from '../graph/config.js';
+/**
+ * Get status icon based on roadmap_status
+ */
+function getStatusIcon(status) {
+    switch (status) {
+        case 'not_started':
+            return chalk.gray('○');
+        case 'in_progress':
+            return chalk.blue('◐');
+        case 'completed':
+            return chalk.green('●');
+        case 'cancelled':
+            return chalk.red('✗');
+        default:
+            return chalk.gray('?');
+    }
+}
+/**
+ * Get lane header with icon
+ */
+function getLaneHeader(lane, count) {
+    switch (lane) {
+        case 'now':
+            return chalk.green(`⚡ Now`) + chalk.dim(` (${count})`);
+        case 'next':
+            return chalk.cyan(`📋 Next`) + chalk.dim(` (${count})`);
+        case 'later':
+            return chalk.yellow(`💭 Later`) + chalk.dim(` (${count})`);
+        case 'done':
+            return chalk.gray(`✓ Done`) + chalk.dim(` (${count})`);
+        case 'dropped':
+            return chalk.red(`✗ Dropped`) + chalk.dim(` (${count})`);
+    }
+}
+/**
+ * Format decision factors as tags
+ */
+function formatDecisionFactors(factors) {
+    if (!factors || factors.length === 0)
+        return '';
+    return chalk.dim(`[${factors.slice(0, 2).join(', ')}]`);
+}
+/**
+ * Display roadmap in CLI format
+ */
+function displayRoadmap(response, options) {
+    const { lanes, summary } = response;
+    // Header
+    console.log(chalk.bold('\n🗺️  Product Roadmap\n'));
+    // Summary line
+    const summaryParts = [];
+    if (summary.byLane.now > 0) {
+        summaryParts.push(chalk.green(`${summary.byLane.now} now`));
+    }
+    if (summary.byLane.next > 0) {
+        summaryParts.push(chalk.cyan(`${summary.byLane.next} next`));
+    }
+    if (options.all && summary.byLane.later > 0) {
+        summaryParts.push(chalk.yellow(`${summary.byLane.later} later`));
+    }
+    if (options.all && summary.byLane.done > 0) {
+        summaryParts.push(chalk.gray(`${summary.byLane.done} done`));
+    }
+    if (options.all && summary.byLane.dropped > 0) {
+        summaryParts.push(chalk.red(`${summary.byLane.dropped} dropped`));
+    }
+    if (summary.byStatus.in_progress) {
+        summaryParts.push(chalk.blue(`${summary.byStatus.in_progress} in progress`));
+    }
+    if (summaryParts.length > 0) {
+        console.log(chalk.dim(`   ${summaryParts.join(' · ')}\n`));
+    }
+    // Check if empty
+    const hasContent = lanes.some(l => l.epics.length > 0);
+    if (!hasContent) {
+        console.log(chalk.yellow('   No epics found on the roadmap.\n'));
+        console.log(chalk.dim('   Tip: Run `ginko roadmap --all` to include Later items.'));
+        return;
+    }
+    // Display each lane
+    for (const laneGroup of lanes) {
+        if (laneGroup.epics.length === 0)
+            continue;
+        console.log(getLaneHeader(laneGroup.lane, laneGroup.epics.length));
+        console.log(chalk.dim('   ' + '─'.repeat(50)));
+        for (const epic of laneGroup.epics) {
+            const icon = getStatusIcon(epic.roadmap_status);
+            const title = epic.title;
+            const id = chalk.dim(`(${epic.id})`);
+            // Build extra info
+            const extras = [];
+            // Show decision factors for Later items
+            if (laneGroup.lane === 'later' && epic.decision_factors) {
+                extras.push(formatDecisionFactors(epic.decision_factors));
+            }
+            // Show tags if present
+            if (epic.tags && epic.tags.length > 0) {
+                extras.push(chalk.dim(epic.tags.slice(0, 2).join(', ')));
+            }
+            console.log(`   ${icon} ${title} ${id}${extras.length ? ' ' + extras.join(' ') : ''}`);
+        }
+        console.log('');
+    }
+    // Footer - show hidden counts
+    if (!options.all) {
+        const hiddenCounts = [];
+        if (summary.byLane.later > 0)
+            hiddenCounts.push(`${summary.byLane.later} later`);
+        if (summary.byLane.done > 0)
+            hiddenCounts.push(`${summary.byLane.done} done`);
+        if (summary.byLane.dropped > 0)
+            hiddenCounts.push(`${summary.byLane.dropped} dropped`);
+        if (hiddenCounts.length > 0) {
+            console.log(chalk.dim(`   ${hiddenCounts.join(', ')} hidden. Use --all to show.`));
+        }
+    }
+    console.log(chalk.dim('   Tip: Use --lane or --status to filter'));
+}
+/**
+ * Main roadmap command
+ */
+export async function roadmapAction(options) {
+    try {
+        // Get graph config
+        const config = await loadGraphConfig();
+        if (!config || !config.graphId) {
+            console.log(chalk.red('\n✗ Graph not initialized. Run `ginko graph init` first.\n'));
+            process.exit(1);
+        }
+        // Build query params
+        const params = new URLSearchParams();
+        params.set('graphId', config.graphId);
+        if (options.all) {
+            params.set('all', 'true');
+        }
+        if (options.lane) {
+            params.set('lane', options.lane);
+        }
+        if (options.status) {
+            params.set('status', options.status);
+        }
+        // Call the API
+        const client = new GraphApiClient();
+        const response = await client.request('GET', `/api/v1/graph/roadmap?${params.toString()}`);
+        // Output
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+        }
+        else {
+            displayRoadmap(response, options);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(chalk.red(`\n✗ Failed to load roadmap: ${message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Create the roadmap command
+ */
+export function roadmapCommand() {
+    const roadmap = new Command('roadmap')
+        .description('View product roadmap (Now/Next/Later priority lanes)')
+        .option('-a, --all', 'Include Later, Done, and Dropped items')
+        .option('-l, --lane <lane>', 'Filter by lane (now, next, later, done, dropped)')
+        .option('-s, --status <status>', 'Filter by status (not_started, in_progress, completed, cancelled)')
+        .option('--json', 'Output as JSON')
+        .addHelpText('after', `
+${chalk.gray('Lanes (ADR-056):')}
+  ${chalk.green('⚡ Now')}      Fully planned, committed, ready for implementation
+  ${chalk.cyan('📋 Next')}     Committed but may need additional planning
+  ${chalk.yellow('💭 Later')}    Proposed but not yet committed (has decision factors)
+  ${chalk.gray('✓ Done')}      Completed work (hidden by default)
+  ${chalk.red('✗ Dropped')}   Cancelled/abandoned work (hidden by default)
+
+${chalk.gray('Examples:')}
+  ${chalk.green('ginko roadmap')}                    ${chalk.gray('# Show Now and Next lanes')}
+  ${chalk.green('ginko roadmap --all')}              ${chalk.gray('# Include Later, Done, Dropped')}
+  ${chalk.green('ginko roadmap --lane now')}         ${chalk.gray('# Show only Now lane')}
+  ${chalk.green('ginko roadmap --lane done')}        ${chalk.gray('# Show completed work')}
+  ${chalk.green('ginko roadmap --status in_progress')} ${chalk.gray('# Show only in-progress epics')}
+
+${chalk.gray('Status Icons:')}
+  ${chalk.gray('○')} not_started    ${chalk.blue('◐')} in_progress
+  ${chalk.green('●')} completed      ${chalk.red('✗')} cancelled
+
+${chalk.gray('Decision Factors (for Later items):')}
+  planning, value, feasibility, architecture, design, risks, market-fit, dependencies
+`)
+        .action(roadmapAction);
+    return roadmap;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/roadmap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/roadmap/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/start/start-reflection.d.ts

@@ -115,8 +115,10 @@ export declare class StartReflectionCommand extends ReflectionCommand {
     /**
      * Display concise human output (TASK-11)
      *
-     * Shows only essential info for instant productivity (6-8 lines).
-     * Used with --concise flag.
+     * Now uses table view by default (EPIC-012 Sprint 1).
+     * - Default: Table view with branding
+     * - --compact: Previous concise format without borders
+     * - --no-table: Plain text format for piping
      */
     private displayConciseOutput;
     /**

package/dist/commands/start/start-reflection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-reflection.d.ts","sourceRoot":"","sources":["../../../src/commands/start/start-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAqCrE;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,cAAc,CAAuB;;IAQ7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;;OAGG;YACW,kBAAkB;IAmChC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA8ErC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA0R/D;;;;;OAKG;YACW,kBAAkB;IA6VhC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;IA+BlC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDlF;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,0BAA0B;IA2DxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;YACW,aAAa;IAM3B;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;YACW,WAAW;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAmCpD;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAI1B;IAEF;;;;;OAKG;YACW,iBAAiB;IAwI/B;;;;;OAKG;YACW,cAAc;IA+I5B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;;OAIG;YACW,cAAc;IAa5B;;OAEG;YACW,oBAAoB;IAuBlC;;;;;OAKG;YACW,kBAAkB;IA0BhC;;;;OAIG;YACW,oBAAoB;CAsDnC;AAGD,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"start-reflection.d.ts","sourceRoot":"","sources":["../../../src/commands/start/start-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAqDrE;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,cAAc,CAAuB;;IAQ7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;;OAGG;YACW,kBAAkB;IAmChC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA8ErC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA0V/D;;;;;OAKG;YACW,kBAAkB;IA6VhC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;IA+BlC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDlF;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,0BAA0B;IA2DxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;YACW,aAAa;IAM3B;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;YACW,WAAW;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAmCpD;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAI1B;IAEF;;;;;OAKG;YACW,iBAAiB;IAwI/B;;;;;OAKG;YACW,cAAc;IA+I5B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;OAIG;YACW,cAAc;IAa5B;;OAEG;YACW,oBAAoB;IAuBlC;;;;;OAKG;YACW,kBAAkB;IA0BhC;;;;OAIG;YACW,oBAAoB;CAsDnC;AAGD,eAAe,sBAAsB,CAAC"}

package/dist/commands/start/start-reflection.js

@@ -21,8 +21,9 @@ import { SessionSynthesizer } from '../../utils/synthesis.js';
 import { loadContextStrategic, formatContextSummary } from '../../utils/context-loader.js';
 import { initializeQueue } from '../../lib/event-queue.js';
 import { formatContextSummary as formatEventContextSummary } from '../../lib/context-loader-events.js';
-import { loadSprintChecklist, formatSprintChecklist, formatCurrentTaskDetails } from '../../lib/sprint-loader.js';
-import { formatHumanOutput, formatVerboseOutput, formatAIContextJSONL } from '../../lib/output-formatter.js';
+import { loadSprintChecklist, formatSprintChecklist, formatCurrentTaskDetails, detectSprintProgression } from '../../lib/sprint-loader.js';
+import { formatHumanOutput, formatVerboseOutput, formatAIContextJSONL, formatTableOutput, formatEpicComplete, formatSprintProgressionPrompt } from '../../lib/output-formatter.js';
+import { getUserCurrentSprint, setUserCurrentSprint, createAssignmentFromFile, getSprintFileFromAssignment } from '../../lib/user-sprint.js';
 import { GraphApiClient } from '../graph/api-client.js';
 import { isGraphInitialized, getGraphId } from '../graph/config.js';
 import { isAuthenticated } from '../../utils/auth-storage.js';
@@ -189,70 +190,96 @@ export class StartReflectionCommand extends ReflectionCommand {
             const sessionDir = path.join(ginkoDir, 'sessions', userSlug);
             const projectRoot = await getProjectRoot();
             // Load sprint checklist for session context
-            // Strategy: Load both local and graph, use the more complete/current one
-            // Local file is authoritative for solo work; graph is authoritative for team collaboration
+            // Strategy: User sprint first, then local/graph
+            // EPIC-012: Per-user sprint tracking enables multiple users on different sprints
             let sprintChecklist = null;
             let sprintSource = 'local';
-            // Always load local sprint first (fast, authoritative for file-based workflows)
-            const localSprint = await loadSprintChecklist(projectRoot);
-            // Try to load from graph if authenticated
-            let graphSprint = null;
-            if (await isAuthenticated() && await isGraphInitialized()) {
+            // First, check if user has a specific sprint assignment
+            const userSprint = await getUserCurrentSprint();
+            let userSprintLoaded = false;
+            if (userSprint) {
                 try {
-                    spinner.text = 'Checking graph for sprint updates...';
-                    const graphId = await getGraphId();
-                    if (graphId) {
-                        const client = new GraphApiClient();
-                        const graphResponse = await client.getActiveSprint(graphId);
-                        graphSprint = this.convertGraphSprintToChecklist(graphResponse);
+                    const userSprintFile = await getSprintFileFromAssignment(userSprint);
+                    if (await fs.pathExists(userSprintFile)) {
+                        const userSprintChecklist = await loadSprintChecklist(projectRoot, userSprintFile);
+                        if (userSprintChecklist) {
+                            sprintChecklist = userSprintChecklist;
+                            sprintSource = 'user';
+                            userSprintLoaded = true;
+                        }
                     }
                 }
-                catch (error) {
-                    // Graph unavailable - use local only
-                    spinner.text = 'Graph unavailable, using local sprint file';
+                catch {
+                    // User sprint file may have been deleted - clear the assignment
+                    // We'll fall back to global sprint
                 }
             }
-            // Compare and choose the more complete/current sprint
-            // Priority: Local file is source of truth - it represents what the user is actively working on
-            // Graph data may be stale (e.g., still showing Sprint 1 when user moved to Sprint 2)
-            if (localSprint && graphSprint) {
-                // If the sprints are different (different names), always use local
-                // This handles the case where graph hasn't been synced with new sprint
-                const localName = localSprint.name?.toLowerCase() || '';
-                const graphName = graphSprint.name?.toLowerCase() || '';
-                const sprintsAreDifferent = localName !== graphName &&
-                    !localName.includes(graphName) &&
-                    !graphName.includes(localName);
-                if (sprintsAreDifferent) {
-                    // Local file is the source of truth for which sprint we're on
-                    sprintChecklist = localSprint;
-                    sprintSource = 'local';
+            // If no user sprint, load global sprint (CURRENT-SPRINT.md)
+            let localSprint = null;
+            if (!userSprintLoaded) {
+                localSprint = await loadSprintChecklist(projectRoot);
+            }
+            // Only check graph/local if user sprint wasn't already loaded
+            if (!userSprintLoaded) {
+                // Try to load from graph if authenticated
+                let graphSprint = null;
+                if (await isAuthenticated() && await isGraphInitialized()) {
+                    try {
+                        spinner.text = 'Checking graph for sprint updates...';
+                        const graphId = await getGraphId();
+                        if (graphId) {
+                            const client = new GraphApiClient();
+                            const graphResponse = await client.getActiveSprint(graphId);
+                            graphSprint = this.convertGraphSprintToChecklist(graphResponse);
+                        }
+                    }
+                    catch (error) {
+                        // Graph unavailable - use local only
+                        spinner.text = 'Graph unavailable, using local sprint file';
+                    }
                 }
-                else {
-                    // Same sprint - prefer local if it has more tasks OR higher completion count
-                    // This handles case where graph has stale/test data
-                    const localTotal = localSprint.progress?.total || 0;
-                    const graphTotal = graphSprint.progress?.total || 0;
-                    const localProgress = localSprint.progress?.complete || 0;
-                    const graphProgress = graphSprint.progress?.complete || 0;
-                    if (localTotal > graphTotal || localProgress > graphProgress) {
+                // Compare and choose the more complete/current sprint
+                // Priority: Local file is source of truth - it represents what the user is actively working on
+                // Graph data may be stale (e.g., still showing Sprint 1 when user moved to Sprint 2)
+                if (localSprint && graphSprint) {
+                    // If the sprints are different (different names), always use local
+                    // This handles the case where graph hasn't been synced with new sprint
+                    const localName = localSprint.name?.toLowerCase() || '';
+                    const graphName = graphSprint.name?.toLowerCase() || '';
+                    const sprintsAreDifferent = localName !== graphName &&
+                        !localName.includes(graphName) &&
+                        !graphName.includes(localName);
+                    if (sprintsAreDifferent) {
+                        // Local file is the source of truth for which sprint we're on
                         sprintChecklist = localSprint;
                         sprintSource = 'local';
                     }
                     else {
-                        sprintChecklist = graphSprint;
-                        sprintSource = 'graph';
+                        // Same sprint - prefer local if it has more tasks OR higher completion count
+                        // This handles case where graph has stale/test data
+                        const localTotal = localSprint.progress?.total || 0;
+                        const graphTotal = graphSprint.progress?.total || 0;
+                        const localProgress = localSprint.progress?.complete || 0;
+                        const graphProgress = graphSprint.progress?.complete || 0;
+                        if (localTotal > graphTotal || localProgress > graphProgress) {
+                            sprintChecklist = localSprint;
+                            sprintSource = 'local';
+                        }
+                        else {
+                            sprintChecklist = graphSprint;
+                            sprintSource = 'graph';
+                        }
                     }
                 }
-            }
-            else if (localSprint) {
-                sprintChecklist = localSprint;
-                sprintSource = 'local';
-            }
-            else if (graphSprint) {
-                sprintChecklist = graphSprint;
-                sprintSource = 'graph';
-            }
+                else if (localSprint) {
+                    sprintChecklist = localSprint;
+                    sprintSource = 'local';
+                }
+                else if (graphSprint) {
+                    sprintChecklist = graphSprint;
+                    sprintSource = 'graph';
+                }
+            } // end if (!userSprintLoaded)
             // Load session log content before archiving
             const previousSessionLog = await SessionLogManager.loadSessionLog(sessionDir);
             const hasLog = previousSessionLog.length > 100; // Non-empty log
@@ -377,7 +404,29 @@ export class StartReflectionCommand extends ReflectionCommand {
             const aiContext = await this.buildAIContext(context, activeSynthesis, strategyContext, eventContext, sprintChecklist, isFirstTimeMember);
             // Store AI context for MCP/external access
             await this.storeAIContext(aiContext, sessionDir);
-            // 12. Display output based on mode (TASK-P2: Concise is now default)
+            // 12. Check sprint progression and epic completion (EPIC-012 Sprint 1)
+            let sprintProgression = null;
+            if (sprintChecklist) {
+                sprintProgression = await detectSprintProgression(sprintChecklist, projectRoot);
+                // Display epic completion message if all sprints done
+                if (sprintProgression?.isEpicComplete && sprintProgression.epicName) {
+                    console.log(formatEpicComplete(sprintProgression.epicName, sprintProgression.currentEpicId));
+                }
+                // Handle sprint progression (current sprint is 100% complete)
+                if (sprintProgression?.isSprintComplete && sprintProgression.nextSprintId && !sprintProgression.isEpicComplete) {
+                    console.log(formatSprintProgressionPrompt(sprintProgression.currentSprintId, sprintProgression.nextSprintId, sprintProgression.nextSprintName || 'Next Sprint'));
+                    // Auto-progress if flag is set
+                    if (options.autoProgress && sprintProgression.nextSprintFile) {
+                        spinner.text = 'Auto-advancing to next sprint...';
+                        const assignment = await createAssignmentFromFile(sprintProgression.nextSprintFile, sprintProgression.nextSprintName || 'Next Sprint', 'auto');
+                        if (assignment) {
+                            await setUserCurrentSprint(assignment);
+                            spinner.succeed(`Advanced to sprint: ${sprintProgression.nextSprintId}`);
+                        }
+                    }
+                }
+            }
+            // 13. Display output based on mode (TASK-P2: Table is now default)
             if (options.verbose) {
                 // Verbose mode: Full session info (~80 lines)
                 await this.displaySessionInfo(context, contextLevel, activeSynthesis, strategyContext, eventContext, sprintChecklist);
@@ -386,8 +435,11 @@ export class StartReflectionCommand extends ReflectionCommand {
                 console.log(chalk.dim(formatContextSummary(strategyContext)));
             }
             else {
-                // Default mode: Concise human-optimized output (≤20 lines)
-                this.displayConciseOutput(aiContext);
+                // Default mode: Table view (use --compact for previous format)
+                this.displayConciseOutput(aiContext, {
+                    compact: options.compact,
+                    table: options.table
+                });
             }
             spinner.succeed('Session initialized with strategic context!');
             // EPIC-008 Sprint 2: Check team context staleness
@@ -1323,12 +1375,22 @@ Example output structure:
     /**
      * Display concise human output (TASK-11)
      *
-     * Shows only essential info for instant productivity (6-8 lines).
-     * Used with --concise flag.
+     * Now uses table view by default (EPIC-012 Sprint 1).
+     * - Default: Table view with branding
+     * - --compact: Previous concise format without borders
+     * - --no-table: Plain text format for piping
      */
-    displayConciseOutput(aiContext) {
+    displayConciseOutput(aiContext, options = {}) {
         console.log('');
-        console.log(formatHumanOutput(aiContext, { workMode: aiContext.session.workMode }));
+        // Table view is now the default
+        // --compact uses previous concise format
+        // --no-table (table === false) uses concise format
+        if (options.compact || options.table === false) {
+            console.log(formatHumanOutput(aiContext, { workMode: aiContext.session.workMode }));
+        }
+        else {
+            console.log(formatTableOutput(aiContext));
+        }
         console.log('');
     }
     /**