Skip to content

feat: add experimental live progress monitoring for work sessions #939

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
konard wants to merge 5 commits into
base: main
Choose a base branch
from
Open

feat: add experimental live progress monitoring for work sessions #939

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
7833574
Initial commit with task details
konard Dec 16, 2025
c308660
feat: add experimental live progress monitoring for work sessions
konard Dec 16, 2025
89e7bf1
Revert "Initial commit with task details"
konard Dec 16, 2025
9d6929f
fix: resolve merge conflicts and complete live progress monitoring in…
konard Jan 11, 2026
2104abe
style: format changeset file with prettier
konard Jan 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions .changeset/working-session-live-progress.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
'@link-assistant/hive-mind': minor
---

Add experimental live progress monitoring for work sessions

- Implement `--working-session-live-progress` CLI flag for both solve and hive commands
- Create new progress monitoring module (`solve.progress-monitoring.lib.mjs`) with:
- Live TODO list tracking from TodoWrite tool calls
- Progress bar visualization (percentage complete)
- Automatic PR description updates with progress section
- Rate limiting to avoid GitHub API throttling
- Integrate progress monitoring into interactive mode
- Updates PR description when TodoWrite tool is invoked
- Displays task completion stats and progress bar
- Supports work session identification
- Add comprehensive test suite (29 tests) covering:
- Progress calculation and formatting
- CLI configuration in solve and hive
- Option forwarding from hive to solve
- Interactive mode integration
- Feature is experimental and requires `--interactive-mode` to be enabled
- Implements issue #936
7 changes: 7 additions & 0 deletions src/claude.lib.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -907,6 +907,8 @@ export const executeClaudeCommand = async params => {

// Create interactive mode handler if enabled
let interactiveHandler = null;
// Generate a unique session ID for this work session
const workSessionId = `session-${Date.now()}`;
if (argv.interactiveMode && owner && repo && prNumber) {
await log('🔌 Interactive mode: Creating handler for real-time PR comments', { verbose: true });
interactiveHandler = createInteractiveHandler({
Expand All @@ -916,7 +918,12 @@ export const executeClaudeCommand = async params => {
$,
log,
verbose: argv.verbose,
enableProgressMonitoring: argv.workingSessionLiveProgress || false,
sessionId: workSessionId,
});
if (argv.workingSessionLiveProgress) {
await log(`📊 Live progress monitoring: ENABLED (session: ${workSessionId})`, { verbose: true });
}
} else if (argv.interactiveMode) {
await log('⚠️ Interactive mode: Disabled - missing PR info (owner/repo/prNumber)', { verbose: true });
}
Expand Down
5 changes: 5 additions & 0 deletions src/hive.config.lib.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -291,6 +291,11 @@ export const createYargsConfig = yargsInstance => {
description: 'Execute the AI tool using bunx (experimental, may improve speed and memory usage) - passed to solve command',
default: false,
})
.option('working-session-live-progress', {
type: 'boolean',
description: '[EXPERIMENTAL] Enable live progress monitoring in PR descriptions. Updates PR with TODO list progress. Only supported for --tool claude with --interactive-mode.',
default: false,
})
.parserConfiguration({
'boolean-negation': true,
'strip-dashed': false,
Expand Down
1 change: 1 addition & 0 deletions src/hive.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -764,6 +764,7 @@ if (isDirectExecution) {
if (argv.watch) args.push('--watch');
if (argv.prefixForkNameWithOwnerName) args.push('--prefix-fork-name-with-owner-name');
if (argv.interactiveMode) args.push('--interactive-mode');
if (argv.workingSessionLiveProgress) args.push('--working-session-live-progress');
if (argv.promptExploreSubAgent) args.push('--prompt-explore-sub-agent');
if (argv.promptIssueReporting) args.push('--prompt-issue-reporting');
if (argv.promptCaseStudies) args.push('--prompt-case-studies');
Expand Down
38 changes: 37 additions & 1 deletion src/interactive-mode.lib.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -211,10 +211,12 @@ const getToolIcon = toolName => {
* @param {Function} options.$ - command-stream $ function
* @param {Function} options.log - Logging function
* @param {boolean} [options.verbose=false] - Enable verbose logging
* @param {boolean} [options.enableProgressMonitoring=false] - Enable live progress monitoring
* @param {string} [options.sessionId=null] - Work session identifier for progress tracking
* @returns {Object} Handler object with event processing methods
*/
export const createInteractiveHandler = options => {
const { owner, repo, prNumber, $, log, verbose = false } = options;
const { owner, repo, prNumber, $, log, verbose = false, enableProgressMonitoring = false, sessionId = null } = options;

// State tracking for the handler
const state = {
Expand All @@ -237,6 +239,30 @@ export const createInteractiveHandler = options => {
toolUseRegistry: new Map(),
};

// Initialize progress monitor if enabled
let progressMonitor = null;
if (enableProgressMonitoring) {
(async () => {
try {
const { createProgressMonitor } = await import('./solve.progress-monitoring.lib.mjs');
progressMonitor = createProgressMonitor({
owner,
repo,
prNumber,
$,
log,
verbose,
sessionId,
});
if (verbose) {
await log('📊 Progress monitoring: ENABLED', { verbose: true });
}
} catch (error) {
await log(`⚠️ Failed to initialize progress monitoring: ${error.message}`);
}
})();
}

/**
* Post a comment to the PR (with rate limiting)
* @param {string} body - Comment body
Expand Down Expand Up @@ -536,6 +562,16 @@ ${createRawJsonSection(data)}`;
}

inputDisplay = createCollapsible(`📋 Todos (${todos.length} items)`, todosPreview, true);

// Update progress monitoring if enabled
if (progressMonitor && input.todos) {
// Don't await to avoid blocking comment posting
progressMonitor.updateProgress(input.todos).catch(error => {
if (verbose) {
log(`⚠️ Progress update failed: ${error.message}`, { verbose: true });
}
});
}
} else if (toolName === 'Task') {
inputDisplay = `**Description:** ${input.description || 'N/A'}`;
if (input.prompt) {
Expand Down
5 changes: 5 additions & 0 deletions src/solve.config.lib.mjs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -317,6 +317,11 @@ export const createYargsConfig = yargsInstance => {
// Use yargs built-in strict mode to reject unrecognized options
// This prevents issues like #453 and #482 where unknown options are silently ignored
.strict()
.option('working-session-live-progress', {
type: 'boolean',
description: '[EXPERIMENTAL] Enable live progress monitoring in PR descriptions. Updates PR with TODO list progress. Only supported for --tool claude with --interactive-mode.',
default: false,
})
.help('h')
.alias('h', 'help')
);
Expand Down
Loading