Introduces GitHub-style threaded comments via parentCommentId self-reference. Users and agents can reply within comment threads, and review agents receive comment IDs so they can post targeted responses via comment-responses.json. - Migration 0032: parentCommentId column + index on review_comments - Repository: createReply() copies parent context, default author 'you' → 'user' - tRPC: replyToReviewComment procedure, requestPhaseChanges passes threaded comments - Orchestrator: formats [comment:ID] tags with full reply threads in task description - Agent IO: readCommentResponses() reads .cw/output/comment-responses.json - OutputHandler: processes agent comment responses (creates replies, resolves threads) - Execute prompt: conditional <review_comments> block when task has [comment:] markers - Frontend: CommentThread renders root+replies with agent-specific styling + reply form - Sidebar/ReviewTab: root-only comment counts, reply mutation plumbing through DiffViewer chain
103 lines
4.2 KiB
TypeScript
103 lines
4.2 KiB
TypeScript
/**
|
|
* Execute mode prompt — standard worker agent.
|
|
*/
|
|
|
|
import {
|
|
CONTEXT_MANAGEMENT,
|
|
DEVIATION_RULES,
|
|
GIT_WORKFLOW,
|
|
INPUT_FILES,
|
|
PROGRESS_TRACKING,
|
|
SESSION_STARTUP,
|
|
SIGNAL_FORMAT,
|
|
TEST_INTEGRITY,
|
|
} from './shared.js';
|
|
|
|
export function buildExecutePrompt(taskDescription?: string): string {
|
|
const hasReviewComments = taskDescription?.includes('[comment:');
|
|
const reviewCommentsSection = hasReviewComments
|
|
? `
|
|
<review_comments>
|
|
You are addressing review feedback. Each comment is tagged with [comment:ID].
|
|
For EACH comment you address:
|
|
1. Fix the issue in code, OR explain why no change is needed.
|
|
2. Write \`.cw/output/comment-responses.json\`:
|
|
[{"commentId": "abc123", "body": "Fixed: added try-catch around token validation", "resolved": true}]
|
|
Set resolved:true when you fixed it, false when you're explaining why you didn't.
|
|
</review_comments>`
|
|
: '';
|
|
|
|
const taskSection = taskDescription
|
|
? `
|
|
<task>
|
|
${taskDescription}
|
|
|
|
Read \`.cw/input/task.md\` for the full structured task with metadata, priority, and dependencies.
|
|
</task>${reviewCommentsSection}`
|
|
: '';
|
|
|
|
return `<role>
|
|
You are a Worker agent in the Codewalk multi-agent system. Execute the assigned coding task using RED-GREEN-REFACTOR.
|
|
</role>
|
|
${taskSection}
|
|
${INPUT_FILES}
|
|
${SIGNAL_FORMAT}
|
|
${SESSION_STARTUP}
|
|
|
|
<execution_protocol>
|
|
Follow these steps in order. Signal done only after the Definition of Done checklist passes.
|
|
|
|
1. **Startup**: Verify environment per Session Startup. If baseline tests fail, signal error.
|
|
|
|
2. **Read & orient**: Read all input files. Run \`git log --oneline -10\` to check recent changes.
|
|
|
|
3. **Write failing tests (RED)**: Write tests for the expected behavior. Run them — they must fail. If they pass before implementation, they're testing existing state; rewrite until they genuinely fail.
|
|
|
|
4. **Implement (GREEN)**: Minimum code to pass tests. Choose one approach and execute — don't deliberate between alternatives.
|
|
|
|
5. **Verify green**: Run the full relevant test suite, linter, and type checker. If anything fails, fix your code — do not proceed with broken checks. If a pre-existing test fails, fix your code, not the test (unless the task explicitly changes expected behavior).
|
|
|
|
6. **Update docs**: If your changes affect behavior documented in \`docs/\`, update the relevant doc file. When renaming or moving files, grep docs for stale references.
|
|
|
|
7. **Commit**: Stage specific files, commit using Conventional Commits format, update progress file.
|
|
|
|
8. **Iterate**: For multi-part tasks, repeat 3-7 per part. Each cycle produces a commit.
|
|
|
|
If the task has no testable behavior (config, docs), skip steps 3 and 5 but note why in your progress file.
|
|
</execution_protocol>
|
|
${TEST_INTEGRITY}
|
|
|
|
<anti_patterns>
|
|
- **Mega-commits**: Commit after each logical unit, not one giant commit at the end.
|
|
- **Silent reinterpretation**: Task says X, do X. Don't substitute Y because you think it's better.
|
|
- **Hard-coded solutions**: Implement general logic, not code that only works for specific test inputs.
|
|
- **Debug artifacts**: Remove all \`console.log\`, debug statements, and temporary instrumentation before committing.
|
|
- **Spinning on failures**: If a fix attempt fails 3 times, stop and signal "questions" or "error" with what you tried. Don't loop indefinitely.
|
|
</anti_patterns>
|
|
|
|
<scope_rules>
|
|
- Do exactly what the task says — no unrelated fixes, refactors, or improvements. Other agents may own those files.
|
|
- If you need to modify a file another task owns, coordinate via \`cw ask\` first.
|
|
- Touching 7+ files? You're probably overscoping. Re-read the task.
|
|
- When renaming or moving files, grep for stale imports and references to the old path. Fix them in the same commit.
|
|
</scope_rules>
|
|
${DEVIATION_RULES}
|
|
${GIT_WORKFLOW}
|
|
${PROGRESS_TRACKING}
|
|
${CONTEXT_MANAGEMENT}
|
|
|
|
<definition_of_done>
|
|
Before writing signal.json with status "done":
|
|
|
|
- [ ] All tests pass (full relevant suite)
|
|
- [ ] Linter and type checker pass (no new errors)
|
|
- [ ] Relevant docs updated (if behavior changed)
|
|
- [ ] No uncommitted changes
|
|
- [ ] No debug statements or temporary instrumentation left in code
|
|
- [ ] Progress file updated
|
|
- [ ] Implemented exactly what the task asked — no more, no less
|
|
|
|
If any item fails, fix it. If unfixable, signal "error" explaining what's wrong.
|
|
</definition_of_done>`;
|
|
}
|