docrev 0.10.1 → 0.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/.gitattributes +1 -1
  2. package/CHANGELOG.md +184 -173
  3. package/PLAN-tables-and-postprocess.md +850 -850
  4. package/README.md +431 -431
  5. package/bin/rev.js +11 -11
  6. package/bin/rev.ts +145 -145
  7. package/completions/rev.bash +127 -127
  8. package/completions/rev.ps1 +210 -210
  9. package/completions/rev.zsh +207 -207
  10. package/dist/lib/anchor-match.d.ts +1 -1
  11. package/dist/lib/anchor-match.d.ts.map +1 -1
  12. package/dist/lib/anchor-match.js +47 -17
  13. package/dist/lib/anchor-match.js.map +1 -1
  14. package/dist/lib/build.js +4 -4
  15. package/dist/lib/commands/sync.d.ts.map +1 -1
  16. package/dist/lib/commands/sync.js +78 -100
  17. package/dist/lib/commands/sync.js.map +1 -1
  18. package/dist/lib/commands/utilities.js +164 -164
  19. package/dist/lib/commands/word-tools.js +8 -8
  20. package/dist/lib/grammar.js +3 -3
  21. package/dist/lib/macro-filter.lua +201 -201
  22. package/dist/lib/pdf-comments.js +44 -44
  23. package/dist/lib/plugins.js +57 -57
  24. package/dist/lib/pptx-color-filter.lua +37 -37
  25. package/dist/lib/pptx-themes.js +115 -115
  26. package/dist/lib/sections.d.ts.map +1 -1
  27. package/dist/lib/sections.js +5 -2
  28. package/dist/lib/sections.js.map +1 -1
  29. package/dist/lib/spelling.js +2 -2
  30. package/dist/lib/templates.js +387 -387
  31. package/dist/lib/themes.js +51 -51
  32. package/eslint.config.js +27 -27
  33. package/issues.md +180 -0
  34. package/lib/anchor-match.ts +308 -276
  35. package/lib/annotations.ts +644 -644
  36. package/lib/build.ts +1766 -1766
  37. package/lib/citations.ts +160 -160
  38. package/lib/commands/build.ts +855 -855
  39. package/lib/commands/citations.ts +515 -515
  40. package/lib/commands/comments.ts +1050 -1050
  41. package/lib/commands/context.ts +176 -176
  42. package/lib/commands/core.ts +309 -309
  43. package/lib/commands/doi.ts +435 -435
  44. package/lib/commands/file-ops.ts +372 -372
  45. package/lib/commands/history.ts +320 -320
  46. package/lib/commands/index.ts +87 -87
  47. package/lib/commands/init.ts +259 -259
  48. package/lib/commands/merge-resolve.ts +378 -378
  49. package/lib/commands/preview.ts +178 -178
  50. package/lib/commands/project-info.ts +244 -244
  51. package/lib/commands/quality.ts +517 -517
  52. package/lib/commands/response.ts +454 -454
  53. package/lib/commands/section-boundaries.ts +82 -82
  54. package/lib/commands/sections.ts +451 -451
  55. package/lib/commands/sync.ts +676 -709
  56. package/lib/commands/text-ops.ts +449 -449
  57. package/lib/commands/utilities.ts +448 -448
  58. package/lib/commands/verify-anchors.ts +272 -272
  59. package/lib/commands/word-tools.ts +340 -340
  60. package/lib/comment-realign.ts +517 -517
  61. package/lib/config.ts +84 -84
  62. package/lib/crossref.ts +781 -781
  63. package/lib/csl.ts +191 -191
  64. package/lib/dependencies.ts +98 -98
  65. package/lib/diff-engine.ts +465 -465
  66. package/lib/doi-cache.ts +115 -115
  67. package/lib/doi.ts +897 -897
  68. package/lib/equations.ts +506 -506
  69. package/lib/errors.ts +346 -346
  70. package/lib/format.ts +541 -541
  71. package/lib/git.ts +326 -326
  72. package/lib/grammar.ts +303 -303
  73. package/lib/image-registry.ts +180 -180
  74. package/lib/import.ts +911 -911
  75. package/lib/journals.ts +543 -543
  76. package/lib/macro-filter.lua +201 -201
  77. package/lib/macros.ts +273 -273
  78. package/lib/merge.ts +633 -633
  79. package/lib/orcid.ts +144 -144
  80. package/lib/pdf-comments.ts +263 -263
  81. package/lib/pdf-import.ts +524 -524
  82. package/lib/plugins.ts +362 -362
  83. package/lib/postprocess.ts +188 -188
  84. package/lib/pptx-color-filter.lua +37 -37
  85. package/lib/pptx-template.ts +469 -469
  86. package/lib/pptx-themes.ts +483 -483
  87. package/lib/protect-restore.ts +520 -520
  88. package/lib/rate-limiter.ts +94 -94
  89. package/lib/response.ts +197 -197
  90. package/lib/restore-references.ts +240 -240
  91. package/lib/review.ts +327 -327
  92. package/lib/schema.ts +488 -488
  93. package/lib/scientific-words.ts +73 -73
  94. package/lib/sections.ts +428 -425
  95. package/lib/slides.ts +756 -756
  96. package/lib/spelling.ts +334 -334
  97. package/lib/templates.ts +526 -526
  98. package/lib/themes.ts +742 -742
  99. package/lib/trackchanges.ts +247 -247
  100. package/lib/tui.ts +450 -450
  101. package/lib/types.ts +550 -550
  102. package/lib/undo.ts +250 -250
  103. package/lib/utils.ts +69 -69
  104. package/lib/variables.ts +179 -179
  105. package/lib/word-extraction.ts +806 -806
  106. package/lib/word.ts +643 -643
  107. package/lib/wordcomments.ts +840 -840
  108. package/package.json +137 -137
  109. package/scripts/postbuild.js +47 -47
  110. package/site/assets/extra.css +208 -0
  111. package/site/commands.html +926 -0
  112. package/site/configuration.html +469 -0
  113. package/site/index.html +288 -0
  114. package/site/troubleshooting.html +461 -0
  115. package/site/workflow.html +518 -0
  116. package/skill/REFERENCE.md +539 -539
  117. package/skill/SKILL.md +295 -295
  118. package/tsconfig.json +26 -26
  119. package/types/index.d.ts +525 -525
@@ -1,94 +1,94 @@
1
- /**
2
- * Rate Limiter - Prevents API abuse with exponential backoff
3
- */
4
-
5
- export interface RateLimiterOptions {
6
- minDelay?: number;
7
- maxDelay?: number;
8
- maxRetries?: number;
9
- backoffFactor?: number;
10
- }
11
-
12
- export class RateLimiter {
13
- private minDelay: number;
14
- private maxDelay: number;
15
- private maxRetries: number;
16
- private backoffFactor: number;
17
- private lastRequestTime: number;
18
- private currentDelay: number;
19
- private consecutiveErrors: number;
20
-
21
- constructor(options: RateLimiterOptions = {}) {
22
- this.minDelay = options.minDelay || 100; // Min delay between requests (ms)
23
- this.maxDelay = options.maxDelay || 30000; // Max delay after backoff (ms)
24
- this.maxRetries = options.maxRetries || 3; // Max retry attempts
25
- this.backoffFactor = options.backoffFactor || 2;
26
- this.lastRequestTime = 0;
27
- this.currentDelay = this.minDelay;
28
- this.consecutiveErrors = 0;
29
- }
30
-
31
- async wait(): Promise<void> {
32
- const now = Date.now();
33
- const elapsed = now - this.lastRequestTime;
34
- if (elapsed < this.currentDelay) {
35
- await new Promise(r => setTimeout(r, this.currentDelay - elapsed));
36
- }
37
- this.lastRequestTime = Date.now();
38
- }
39
-
40
- onSuccess(): void {
41
- // Gradually reduce delay on success
42
- this.consecutiveErrors = 0;
43
- this.currentDelay = Math.max(this.minDelay, this.currentDelay / this.backoffFactor);
44
- }
45
-
46
- onError(statusCode: number): boolean {
47
- this.consecutiveErrors++;
48
- // Exponential backoff
49
- if (statusCode === 429 || statusCode >= 500) {
50
- this.currentDelay = Math.min(this.maxDelay, this.currentDelay * this.backoffFactor);
51
- }
52
- return this.consecutiveErrors <= this.maxRetries;
53
- }
54
-
55
- async fetchWithRetry(url: string, options: RequestInit = {}): Promise<Response> {
56
- let lastError: Error | undefined;
57
-
58
- for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
59
- await this.wait();
60
-
61
- try {
62
- const response = await fetch(url, options);
63
-
64
- if (response.status === 429) {
65
- // Rate limited - back off
66
- const retryAfter = response.headers.get('Retry-After');
67
- const delay = retryAfter ? parseInt(retryAfter, 10) * 1000 : this.currentDelay * 2;
68
- this.currentDelay = Math.min(this.maxDelay, delay);
69
- if (!this.onError(429)) break;
70
- continue;
71
- }
72
-
73
- if (response.status >= 500 && attempt < this.maxRetries) {
74
- // Server error - retry with backoff
75
- if (!this.onError(response.status)) break;
76
- continue;
77
- }
78
-
79
- this.onSuccess();
80
- return response;
81
- } catch (err) {
82
- lastError = err as Error;
83
- if (!this.onError(0)) break;
84
- }
85
- }
86
-
87
- throw lastError || new Error('Max retries exceeded');
88
- }
89
- }
90
-
91
- // Shared rate limiters for different APIs
92
- export const crossrefLimiter = new RateLimiter({ minDelay: 100, maxDelay: 10000 });
93
- export const dataciteLimiter = new RateLimiter({ minDelay: 100, maxDelay: 10000 });
94
- export const doiOrgLimiter = new RateLimiter({ minDelay: 200, maxDelay: 15000 });
1
+ /**
2
+ * Rate Limiter - Prevents API abuse with exponential backoff
3
+ */
4
+
5
+ export interface RateLimiterOptions {
6
+ minDelay?: number;
7
+ maxDelay?: number;
8
+ maxRetries?: number;
9
+ backoffFactor?: number;
10
+ }
11
+
12
+ export class RateLimiter {
13
+ private minDelay: number;
14
+ private maxDelay: number;
15
+ private maxRetries: number;
16
+ private backoffFactor: number;
17
+ private lastRequestTime: number;
18
+ private currentDelay: number;
19
+ private consecutiveErrors: number;
20
+
21
+ constructor(options: RateLimiterOptions = {}) {
22
+ this.minDelay = options.minDelay || 100; // Min delay between requests (ms)
23
+ this.maxDelay = options.maxDelay || 30000; // Max delay after backoff (ms)
24
+ this.maxRetries = options.maxRetries || 3; // Max retry attempts
25
+ this.backoffFactor = options.backoffFactor || 2;
26
+ this.lastRequestTime = 0;
27
+ this.currentDelay = this.minDelay;
28
+ this.consecutiveErrors = 0;
29
+ }
30
+
31
+ async wait(): Promise<void> {
32
+ const now = Date.now();
33
+ const elapsed = now - this.lastRequestTime;
34
+ if (elapsed < this.currentDelay) {
35
+ await new Promise(r => setTimeout(r, this.currentDelay - elapsed));
36
+ }
37
+ this.lastRequestTime = Date.now();
38
+ }
39
+
40
+ onSuccess(): void {
41
+ // Gradually reduce delay on success
42
+ this.consecutiveErrors = 0;
43
+ this.currentDelay = Math.max(this.minDelay, this.currentDelay / this.backoffFactor);
44
+ }
45
+
46
+ onError(statusCode: number): boolean {
47
+ this.consecutiveErrors++;
48
+ // Exponential backoff
49
+ if (statusCode === 429 || statusCode >= 500) {
50
+ this.currentDelay = Math.min(this.maxDelay, this.currentDelay * this.backoffFactor);
51
+ }
52
+ return this.consecutiveErrors <= this.maxRetries;
53
+ }
54
+
55
+ async fetchWithRetry(url: string, options: RequestInit = {}): Promise<Response> {
56
+ let lastError: Error | undefined;
57
+
58
+ for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
59
+ await this.wait();
60
+
61
+ try {
62
+ const response = await fetch(url, options);
63
+
64
+ if (response.status === 429) {
65
+ // Rate limited - back off
66
+ const retryAfter = response.headers.get('Retry-After');
67
+ const delay = retryAfter ? parseInt(retryAfter, 10) * 1000 : this.currentDelay * 2;
68
+ this.currentDelay = Math.min(this.maxDelay, delay);
69
+ if (!this.onError(429)) break;
70
+ continue;
71
+ }
72
+
73
+ if (response.status >= 500 && attempt < this.maxRetries) {
74
+ // Server error - retry with backoff
75
+ if (!this.onError(response.status)) break;
76
+ continue;
77
+ }
78
+
79
+ this.onSuccess();
80
+ return response;
81
+ } catch (err) {
82
+ lastError = err as Error;
83
+ if (!this.onError(0)) break;
84
+ }
85
+ }
86
+
87
+ throw lastError || new Error('Max retries exceeded');
88
+ }
89
+ }
90
+
91
+ // Shared rate limiters for different APIs
92
+ export const crossrefLimiter = new RateLimiter({ minDelay: 100, maxDelay: 10000 });
93
+ export const dataciteLimiter = new RateLimiter({ minDelay: 100, maxDelay: 10000 });
94
+ export const doiOrgLimiter = new RateLimiter({ minDelay: 200, maxDelay: 15000 });
package/lib/response.ts CHANGED
@@ -1,197 +1,197 @@
1
- /**
2
- * Response letter generator
3
- * Extract comments and replies from markdown files for journal resubmission
4
- */
5
-
6
- import * as fs from 'fs';
7
- import * as path from 'path';
8
-
9
- interface Reply {
10
- author: string;
11
- text: string;
12
- }
13
-
14
- interface CommentWithReplies {
15
- author: string;
16
- text: string;
17
- replies: Reply[];
18
- context: string;
19
- file: string;
20
- line: number;
21
- }
22
-
23
- interface ResponseOptions {
24
- title?: string;
25
- authorName?: string;
26
- includeContext?: boolean;
27
- includeLocation?: boolean;
28
- }
29
-
30
- /**
31
- * Parse a comment with potential replies
32
- * Format: {>>Author: comment<<} {>>Reply Author: reply<<}
33
- */
34
- export function parseCommentsWithReplies(text: string, file: string = ''): CommentWithReplies[] {
35
- const comments: CommentWithReplies[] = [];
36
- const lines = text.split('\n');
37
-
38
- // Pattern for comments: {>>Author: text<<}
39
- const commentPattern = /\{>>([^:]+):\s*([^<]+)<<\}/g;
40
-
41
- for (let lineNum = 0; lineNum < lines.length; lineNum++) {
42
- const line = lines[lineNum];
43
- if (!line) continue;
44
- const matches = [...line.matchAll(commentPattern)];
45
-
46
- if (matches.length === 0) continue;
47
-
48
- // Get context (surrounding text without comments)
49
- const contextLine = line.replace(/\{>>[\s\S]+?<<\}/g, '').trim();
50
- const context = contextLine.slice(0, 100) + (contextLine.length > 100 ? '...' : '');
51
-
52
- // First match is the original comment, rest are replies
53
- const [first, ...rest] = matches;
54
- if (!first || !first[1] || !first[2]) continue;
55
-
56
- comments.push({
57
- author: first[1].trim(),
58
- text: first[2].trim(),
59
- replies: rest.map(m => ({
60
- author: m[1]?.trim() || '',
61
- text: m[2]?.trim() || '',
62
- })),
63
- context,
64
- file,
65
- line: lineNum + 1,
66
- });
67
- }
68
-
69
- return comments;
70
- }
71
-
72
- /**
73
- * Group comments by reviewer
74
- */
75
- export function groupByReviewer(comments: CommentWithReplies[]): Map<string, CommentWithReplies[]> {
76
- const grouped = new Map<string, CommentWithReplies[]>();
77
-
78
- for (const comment of comments) {
79
- const reviewer = comment.author;
80
- if (!grouped.has(reviewer)) {
81
- grouped.set(reviewer, []);
82
- }
83
- grouped.get(reviewer)!.push(comment);
84
- }
85
-
86
- return grouped;
87
- }
88
-
89
- /**
90
- * Generate response letter in Markdown format
91
- */
92
- export function generateResponseLetter(comments: CommentWithReplies[], options: ResponseOptions = {}): string {
93
- const {
94
- title = 'Response to Reviewers',
95
- authorName = 'Author',
96
- includeContext = true,
97
- includeLocation = true,
98
- } = options;
99
-
100
- const lines: string[] = [];
101
- lines.push(`# ${title}`);
102
- lines.push('');
103
- lines.push(`We thank the reviewers for their constructive feedback. Below we address each comment.`);
104
- lines.push('');
105
-
106
- // Group by reviewer
107
- const grouped = groupByReviewer(comments);
108
-
109
- // Sort reviewers (put known reviewer names first, then others)
110
- const reviewers = [...grouped.keys()].sort((a, b) => {
111
- // "Reviewer" names first, then alphabetical
112
- const aIsReviewer = a.toLowerCase().includes('reviewer');
113
- const bIsReviewer = b.toLowerCase().includes('reviewer');
114
- if (aIsReviewer && !bIsReviewer) return -1;
115
- if (!aIsReviewer && bIsReviewer) return 1;
116
- return a.localeCompare(b);
117
- });
118
-
119
- for (const reviewer of reviewers) {
120
- // Skip if this is the author's own comments (replies)
121
- if (reviewer.toLowerCase() === authorName.toLowerCase()) continue;
122
- if (reviewer.toLowerCase() === 'claude') continue;
123
-
124
- const reviewerComments = grouped.get(reviewer)!;
125
- lines.push(`## ${reviewer}`);
126
- lines.push('');
127
-
128
- for (let i = 0; i < reviewerComments.length; i++) {
129
- const c = reviewerComments[i];
130
- if (!c) continue;
131
-
132
- lines.push(`### Comment ${i + 1}`);
133
- if (includeLocation) {
134
- lines.push(`*${c.file}:${c.line}*`);
135
- }
136
- lines.push('');
137
-
138
- // Original comment
139
- lines.push(`> **${c.author}:** ${c.text}`);
140
- lines.push('');
141
-
142
- // Context if available
143
- if (includeContext && c.context) {
144
- lines.push(`*Context:* "${c.context}"`);
145
- lines.push('');
146
- }
147
-
148
- // Replies
149
- if (c.replies.length > 0) {
150
- lines.push('**Response:**');
151
- lines.push('');
152
- for (const reply of c.replies) {
153
- lines.push(`${reply.text}`);
154
- }
155
- } else {
156
- lines.push('**Response:**');
157
- lines.push('');
158
- lines.push('*[TODO: Add response]*');
159
- }
160
- lines.push('');
161
- lines.push('---');
162
- lines.push('');
163
- }
164
- }
165
-
166
- // Summary stats
167
- const totalComments = comments.filter(c =>
168
- !c.author.toLowerCase().includes('claude') &&
169
- c.author.toLowerCase() !== authorName.toLowerCase()
170
- ).length;
171
- const answered = comments.filter(c => c.replies.length > 0).length;
172
-
173
- lines.push('## Summary');
174
- lines.push('');
175
- lines.push(`- Total comments: ${totalComments}`);
176
- lines.push(`- Addressed: ${answered}`);
177
- lines.push(`- Pending: ${totalComments - answered}`);
178
-
179
- return lines.join('\n');
180
- }
181
-
182
- /**
183
- * Collect comments from multiple files
184
- */
185
- export function collectComments(files: string[]): CommentWithReplies[] {
186
- const allComments: CommentWithReplies[] = [];
187
-
188
- for (const file of files) {
189
- if (!fs.existsSync(file)) continue;
190
-
191
- const text = fs.readFileSync(file, 'utf-8');
192
- const comments = parseCommentsWithReplies(text, path.basename(file));
193
- allComments.push(...comments);
194
- }
195
-
196
- return allComments;
197
- }
1
+ /**
2
+ * Response letter generator
3
+ * Extract comments and replies from markdown files for journal resubmission
4
+ */
5
+
6
+ import * as fs from 'fs';
7
+ import * as path from 'path';
8
+
9
+ interface Reply {
10
+ author: string;
11
+ text: string;
12
+ }
13
+
14
+ interface CommentWithReplies {
15
+ author: string;
16
+ text: string;
17
+ replies: Reply[];
18
+ context: string;
19
+ file: string;
20
+ line: number;
21
+ }
22
+
23
+ interface ResponseOptions {
24
+ title?: string;
25
+ authorName?: string;
26
+ includeContext?: boolean;
27
+ includeLocation?: boolean;
28
+ }
29
+
30
+ /**
31
+ * Parse a comment with potential replies
32
+ * Format: {>>Author: comment<<} {>>Reply Author: reply<<}
33
+ */
34
+ export function parseCommentsWithReplies(text: string, file: string = ''): CommentWithReplies[] {
35
+ const comments: CommentWithReplies[] = [];
36
+ const lines = text.split('\n');
37
+
38
+ // Pattern for comments: {>>Author: text<<}
39
+ const commentPattern = /\{>>([^:]+):\s*([^<]+)<<\}/g;
40
+
41
+ for (let lineNum = 0; lineNum < lines.length; lineNum++) {
42
+ const line = lines[lineNum];
43
+ if (!line) continue;
44
+ const matches = [...line.matchAll(commentPattern)];
45
+
46
+ if (matches.length === 0) continue;
47
+
48
+ // Get context (surrounding text without comments)
49
+ const contextLine = line.replace(/\{>>[\s\S]+?<<\}/g, '').trim();
50
+ const context = contextLine.slice(0, 100) + (contextLine.length > 100 ? '...' : '');
51
+
52
+ // First match is the original comment, rest are replies
53
+ const [first, ...rest] = matches;
54
+ if (!first || !first[1] || !first[2]) continue;
55
+
56
+ comments.push({
57
+ author: first[1].trim(),
58
+ text: first[2].trim(),
59
+ replies: rest.map(m => ({
60
+ author: m[1]?.trim() || '',
61
+ text: m[2]?.trim() || '',
62
+ })),
63
+ context,
64
+ file,
65
+ line: lineNum + 1,
66
+ });
67
+ }
68
+
69
+ return comments;
70
+ }
71
+
72
+ /**
73
+ * Group comments by reviewer
74
+ */
75
+ export function groupByReviewer(comments: CommentWithReplies[]): Map<string, CommentWithReplies[]> {
76
+ const grouped = new Map<string, CommentWithReplies[]>();
77
+
78
+ for (const comment of comments) {
79
+ const reviewer = comment.author;
80
+ if (!grouped.has(reviewer)) {
81
+ grouped.set(reviewer, []);
82
+ }
83
+ grouped.get(reviewer)!.push(comment);
84
+ }
85
+
86
+ return grouped;
87
+ }
88
+
89
+ /**
90
+ * Generate response letter in Markdown format
91
+ */
92
+ export function generateResponseLetter(comments: CommentWithReplies[], options: ResponseOptions = {}): string {
93
+ const {
94
+ title = 'Response to Reviewers',
95
+ authorName = 'Author',
96
+ includeContext = true,
97
+ includeLocation = true,
98
+ } = options;
99
+
100
+ const lines: string[] = [];
101
+ lines.push(`# ${title}`);
102
+ lines.push('');
103
+ lines.push(`We thank the reviewers for their constructive feedback. Below we address each comment.`);
104
+ lines.push('');
105
+
106
+ // Group by reviewer
107
+ const grouped = groupByReviewer(comments);
108
+
109
+ // Sort reviewers (put known reviewer names first, then others)
110
+ const reviewers = [...grouped.keys()].sort((a, b) => {
111
+ // "Reviewer" names first, then alphabetical
112
+ const aIsReviewer = a.toLowerCase().includes('reviewer');
113
+ const bIsReviewer = b.toLowerCase().includes('reviewer');
114
+ if (aIsReviewer && !bIsReviewer) return -1;
115
+ if (!aIsReviewer && bIsReviewer) return 1;
116
+ return a.localeCompare(b);
117
+ });
118
+
119
+ for (const reviewer of reviewers) {
120
+ // Skip if this is the author's own comments (replies)
121
+ if (reviewer.toLowerCase() === authorName.toLowerCase()) continue;
122
+ if (reviewer.toLowerCase() === 'claude') continue;
123
+
124
+ const reviewerComments = grouped.get(reviewer)!;
125
+ lines.push(`## ${reviewer}`);
126
+ lines.push('');
127
+
128
+ for (let i = 0; i < reviewerComments.length; i++) {
129
+ const c = reviewerComments[i];
130
+ if (!c) continue;
131
+
132
+ lines.push(`### Comment ${i + 1}`);
133
+ if (includeLocation) {
134
+ lines.push(`*${c.file}:${c.line}*`);
135
+ }
136
+ lines.push('');
137
+
138
+ // Original comment
139
+ lines.push(`> **${c.author}:** ${c.text}`);
140
+ lines.push('');
141
+
142
+ // Context if available
143
+ if (includeContext && c.context) {
144
+ lines.push(`*Context:* "${c.context}"`);
145
+ lines.push('');
146
+ }
147
+
148
+ // Replies
149
+ if (c.replies.length > 0) {
150
+ lines.push('**Response:**');
151
+ lines.push('');
152
+ for (const reply of c.replies) {
153
+ lines.push(`${reply.text}`);
154
+ }
155
+ } else {
156
+ lines.push('**Response:**');
157
+ lines.push('');
158
+ lines.push('*[TODO: Add response]*');
159
+ }
160
+ lines.push('');
161
+ lines.push('---');
162
+ lines.push('');
163
+ }
164
+ }
165
+
166
+ // Summary stats
167
+ const totalComments = comments.filter(c =>
168
+ !c.author.toLowerCase().includes('claude') &&
169
+ c.author.toLowerCase() !== authorName.toLowerCase()
170
+ ).length;
171
+ const answered = comments.filter(c => c.replies.length > 0).length;
172
+
173
+ lines.push('## Summary');
174
+ lines.push('');
175
+ lines.push(`- Total comments: ${totalComments}`);
176
+ lines.push(`- Addressed: ${answered}`);
177
+ lines.push(`- Pending: ${totalComments - answered}`);
178
+
179
+ return lines.join('\n');
180
+ }
181
+
182
+ /**
183
+ * Collect comments from multiple files
184
+ */
185
+ export function collectComments(files: string[]): CommentWithReplies[] {
186
+ const allComments: CommentWithReplies[] = [];
187
+
188
+ for (const file of files) {
189
+ if (!fs.existsSync(file)) continue;
190
+
191
+ const text = fs.readFileSync(file, 'utf-8');
192
+ const comments = parseCommentsWithReplies(text, path.basename(file));
193
+ allComments.push(...comments);
194
+ }
195
+
196
+ return allComments;
197
+ }