Skip to content

Conversation

@rpothin
Copy link
Owner

@rpothin rpothin commented Jan 28, 2026

Summary

This PR implements the v0.1.4 remediation plan addressing 4 issues identified during testing of v0.1.3 in the demo repository.

Issues Resolved

🔴 Issue 1: Commit Message Quality

Problem: Commit messages contained conversational preambles ("I'll check...") and were truncated mid-word.

Solution:

  • Introduced [COMMIT_MESSAGE] block in agent prompts for explicit commit messages
  • Implemented priority-based extractSummary() with fallback chain
  • Added truncateAtWord() helper to avoid mid-word cuts

🔴 Issue 2: Progress Verbosity Config Not Applied

Problem: progressVerbosity config was ignored; standard showed same output as minimal.

Solution:

  • Capture rawResponse and actions in iteration records during loop execution
  • Update formatIteration() to show actions at standard verbosity level
  • full verbosity now shows raw AI response in addition to actions

🟡 Issue 3: Progress File Not Persisting Task History

Problem: After multi-task runs, progress file only showed the last task (previous tasks lost).

Solution:

  • Wire up existing session-based progress tracking architecture
  • Replace save() with setCurrentTask() for iteration updates
  • Replace appendTaskResult() with recordTaskCompletion() for task completion

🟡 Issue 4: Push Reminder Message

Problem: Users unaware their changes weren't pushed when autoPush: false.

Solution:

  • Added informational message at end of run when auto-push is disabled
  • Message guides users to push manually or enable auto-push in config

Files Changed

File Changes
src/core/prompt-examples.ts [COMMIT_MESSAGE] block and examples
src/core/context-builder.ts Commit message guidelines in prompts
src/core/loop-engine.ts extractSummary() rewrite, rawResponse/actions capture
src/core/checkpoint-manager.ts Word-boundary truncation
src/core/progress-tracker.ts Standard verbosity actions display
src/commands/run.ts Session-based tracking, push reminder message
README.md Updated progressVerbosity description
docs/cookbook.md Updated verbosity levels documentation
docs/architecture.md Added v0.1.4 Enhancements section

Testing

  • npm run build - Compiles successfully
  • npm run lint - No linting errors
  • npm run test - 311 tests passing

Version

Bumped to v0.1.4

Related

  • Remediation plan: plans/v0-1-4_REMEDIATION_PLAN.md

…rbosity, progress persistence, and push flag

Issue 1 - Commit Message Quality:
- Add [COMMIT_MESSAGE] block to prompt examples and format instructions
- Add commit message guidelines to context builder
- Rewrite extractSummary() with priority-based extraction
- Add truncateAtWord() helper for word-boundary truncation

Issue 2 - Progress Verbosity:
- Capture rawResponse and actions in loop-engine iteration records
- Update formatIteration() to show actions for standard/full verbosity

Issue 3 - Progress File Persistence:
- Wire up session-based progress tracking (startSession, setCurrentTask)
- Replace save()/appendTaskResult() with recordTaskCompletion()

Issue 4 - Auto-Push Flag:
- Add --push CLI flag to run command
- Show info message when push is disabled but changes were made

Version bumped to 0.1.4
- README.md: Add --push flag, update progressVerbosity description
- cookbook.md: Add --push examples, update verbosity levels
- architecture.md: Add v0.1.4 Enhancements section
Remove CLI flag to avoid confusion with config-based push behavior.
Configuration provides clear options: per-task, per-run, or manual.

Updated message when autoPush is false:
- Shows how to push manually: git push
- Shows how to enable auto-push in config
@rpothin rpothin self-assigned this Jan 28, 2026
@rpothin rpothin added bug Something isn't working documentation Improvements or additions to documentation enhancement New feature or request labels Jan 28, 2026 — with GitHub Codespaces
- Increase stash test timeout from 5s to 10s for slower Windows git
- Add retry logic and delay to temp directory cleanup
- Fixes EBUSY file lock errors on Windows
@rpothin rpothin merged commit f007699 into main Jan 28, 2026
10 checks passed
@rpothin rpothin deleted the v0.1.4_preparation branch January 28, 2026 21:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant