md-redline 0.1.0

package/src/lib/agent-prompts.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from 'vitest';
+import { buildAddressCommentsPrompt } from './agent-prompts';
+
+describe('buildAddressCommentsPrompt', () => {
+  it('builds a single-file handoff prompt', () => {
+    const prompt = buildAddressCommentsPrompt({
+      filePaths: ['/tmp/spec.md'],
+      commentCounts: new Map([['/tmp/spec.md', 2]]),
+      enableResolve: false,
+    });
+
+    expect(prompt).toContain("I've left review comments in /tmp/spec.md");
+    expect(prompt).toContain('Read /tmp/spec.md');
+    expect(prompt).toContain('remove the entire `<!-- @comment{...} -->` marker');
+    expect(prompt).not.toContain('## Files to review');
+  });
+
+  it('includes multi-file counts and resolve instructions', () => {
+    const prompt = buildAddressCommentsPrompt({
+      filePaths: ['/tmp/a.md', '/tmp/b.md'],
+      commentCounts: new Map([
+        ['/tmp/a.md', 1],
+        ['/tmp/b.md', 3],
+      ]),
+      enableResolve: true,
+    });
+
+    expect(prompt).toContain('## Files to review');
+    expect(prompt).toContain('/tmp/a.md (1 comment)');
+    expect(prompt).toContain('/tmp/b.md (3 comments)');
+    expect(prompt).toContain('"status":"resolved"');
+    expect(prompt).toContain('add a reply to the `replies` array');
+  });
+});

package/src/lib/agent-prompts.ts

@@ -0,0 +1,68 @@
+export interface BuildAddressCommentsPromptOptions {
+  filePaths: string[];
+  commentCounts: Map<string, number>;
+  enableResolve: boolean;
+}
+
+export function buildAddressCommentsPrompt({
+  filePaths,
+  commentCounts,
+  enableResolve,
+}: BuildAddressCommentsPromptOptions): string {
+  if (filePaths.length === 0) return '';
+
+  const afterAction = enableResolve
+    ? 'After addressing a comment that required a document edit, resolve it by setting `"status":"resolved"` and `"resolved":true` in the marker JSON. If a comment only needed a reply (e.g. answering a question), leave it open.'
+    : 'After addressing a comment, remove the entire `<!-- @comment{...} -->` marker from the file';
+
+  const isSingle = filePaths.length === 1;
+  const fileRef = isSingle ? filePaths[0] : 'the files listed below';
+  const fileList = isSingle
+    ? ''
+    : '\n\n## Files to review\n' +
+      filePaths
+        .map((path, index) => {
+          const count = commentCounts.get(path) ?? 0;
+          return `${index + 1}. ${path} (${count} comment${count !== 1 ? 's' : ''})`;
+        })
+        .join('\n');
+
+  return `I've left review comments in ${fileRef} using inline comment markers. Please read ${isSingle ? 'the file' : 'each file'} and address them.${fileList}
+
+## Comment format
+
+Comments are embedded as HTML comment markers: \`<!-- @comment{JSON} -->\`
+Each marker is placed immediately before the text it refers to (the "anchor").
+The JSON contains these fields:
+- \`anchor\`: the exact text the comment refers to
+- \`text\`: my feedback - this is what I need you to address
+- \`replies\`: threaded discussion - read for additional context
+
+## Identifying yourself
+
+Whenever you add a reply to a comment's \`replies\` array, set the \`"author"\` field to your own tool or model name (for example \`"Claude"\`, \`"Codex"\`, or \`"Gemini CLI"\`). Do not use a generic name like \`"Agent"\`.
+
+## Important: edit the original files
+
+You MUST edit the files at the exact paths listed above. Do NOT copy them to a different location, do NOT create new files. If you cannot access a file at its given path (e.g. workspace restrictions), stop and tell me immediately instead of working around it.
+
+## What to do
+
+1. ${isSingle ? `Read ${filePaths[0]}` : 'For each file listed above,'} find all \`<!-- @comment{...} -->\` markers
+2. For each comment, read the \`text\` field and address the feedback by editing the document or answering the question
+${
+  enableResolve
+    ? `3. For every comment you address, add a reply to the \`replies\` array: \`"replies":[{"id":"<unique-id>","text":"your answer or description of the change","author":"<your tool name>","timestamp":"<ISO-8601>"}]\` (append to any existing replies)
+4. ${afterAction}
+5. If a comment is unclear or you are unsure how to address it, leave the marker in place and ask me about it`
+    : `3. ${afterAction}
+4. If a comment is unclear or you are unsure how to address it, leave the marker in place and ask me about it`
+}
+
+## How to respond
+
+After you are done, give me a brief summary:
+- How many comments you addressed${isSingle ? '' : ' (grouped by file)'}
+- For each one, whether you resolved it (document edit) or left it open (question/discussion)${enableResolve ? '' : ' or removed the marker'}
+- Any comments you left in place and why`;
+}

package/src/lib/comment-editor-state.ts

@@ -0,0 +1,6 @@
+export type CommentCardEditorState =
+  | { mode: 'comment-edit'; token: number }
+  | { mode: 'reply-compose'; token: number }
+  | { mode: 'reply-edit'; replyId: string; token: number };
+
+export type SidebarCommentEditorState = ({ commentId: string } & CommentCardEditorState) | null;