Release v0.1.3 - Remediation fixes for progress persistence, git reliability, and UX improvements #5
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Issue #1: Implemented session-based multi-task progress tracking - Added RunSession and TaskResult interfaces - New startSession(), recordTaskCompletion(), getSession() methods - generateFullSessionMarkdown() preserves complete task history - Progress file now includes all task iterations across the run - Issue #3: Added mutex protection for git operations - All CheckpointManager git operations now use async-mutex - Prevents concurrent access causing index.lock errors - Internal *Unsafe() methods for already-locked contexts Added async-mutex dependency and 6 new tests for progress tracking. Part of v0.1.3 remediation plan.
…gy, failure warning Issue #4: Enhanced prompt engineering for honesty - Added HONESTY_GUIDANCE section to context-builder with completion integrity rules - Added STUCK_EXAMPLE to prompt-examples showing proper stuck action format - Updated FORMAT_INSTRUCTIONS and MINIMAL_EXAMPLES to include STUCK action - Added failure warning in ActionExecutor when COMPLETE used despite failed commands Issue #2: Git push implementation with configurable pushStrategy - Added pushStrategy config option: 'per-task' | 'per-run' | 'manual' - per-task (default): Push after each task completes - per-run: Push once at the end of the run - manual: No automatic push Files modified: - src/core/context-builder.ts - HONESTY_GUIDANCE enhancement - src/core/prompt-examples.ts - STUCK_EXAMPLE and format updates - src/core/action-executor.ts - Failed command tracking and warning - src/core/config-schema.ts - pushStrategy option - src/commands/run.ts - pushStrategy implementation
…tion Issue #6: Git commit message format with task X/Y numbering - Added TaskContext interface for commit message context - Updated createCheckpoint: 'ghcralph: task X/Y iter N - summary' - Updated createTaskCheckpoint: 'ghcralph: task X/Y complete - title' - Compute totalTasksInPlan from planManager.getTasks() Issue #5: Progress file verbosity configuration - Added progressVerbosity: 'minimal' | 'standard' | 'full' config option - minimal: Just iteration header (for CI) - standard (default): Tokens, summary, error, duration - full: Standard + raw response + actions executed - Extended IterationRecord with rawResponse and actions fields Documentation: Updated README with new config options - Added pushStrategy and progressVerbosity to config table - Updated environment variables section - Updated example config file - Updated checkpoint message format description Files modified: - src/core/checkpoint-manager.ts - TaskContext and updated formatting - src/core/config-schema.ts - progressVerbosity option - src/core/progress-tracker.ts - verbosity-aware formatting - src/core/loop-state.ts - extended IterationRecord - src/commands/run.ts - task context and verbosity wiring - README.md - documentation updates Completes v0.1.3 remediation plan (all 6 issues addressed)
architecture.md: - Added v0.1.3 issues to identified issues table (6 new items) - Added v0.1.3 Enhancements section with detailed documentation: - Session-based progress tracking (RunSession, TaskResult) - Git mutex protection (async-mutex) - Configurable push strategy (per-task/per-run/manual) - Progress verbosity configuration (minimal/standard/full) - Task-numbered commit messages (task X/Y format) - Honesty guidance and failure warnings - Updated Summary section with new capabilities cookbook.md: - Updated configuration example with new options - Added Push Strategies documentation - Added Progress Verbosity documentation - Added troubleshooting sections: - Git lock errors (now fixed with mutex) - Push to remote configuration - Progress file verbosity settings
…tion guidance - Fixed 3 lint errors in progress-tracker.ts by using type assertions - Updated AGENT.md with explicit lint guidance: - Emphasized running lint before every commit - Updated Validate section with explicit command
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This release addresses 6 issues discovered during v0.1.2 testing, organized into 3 phases: Critical Fixes, Reliability Improvements, and UX Polish.
Issues Fixed
RunSessionandTaskResultpushStrategyoption (per-task/per-run/manual)async-mutexprogressVerbosityoption (minimal/standard/full)New Configuration Options
pushStrategy'per-task' | 'per-run' | 'manual''per-task'progressVerbosity'minimal' | 'standard' | 'full''standard'Changes
Phase 1: Critical Fixes
Phase 2: Reliability Improvements
Phase 3: UX Polish
ghcralph: task X/Y iter N - summaryFiles Changed
async-mutexfor git operation serializationBreaking Changes
None. All changes are backward compatible.
Testing
npm run typecheckpassesnpm testpasses (311 tests)npm run buildsucceedsDocumentation