@mossbear/protocol 0.1.0-alpha.58 → 0.1.0-alpha.59

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.
@@ -0,0 +1,34 @@
1
+ import * as v from 'valibot';
2
+ /** A passage selected in a rendered artifact, with source text for relocation. */
3
+ export declare const CommentAnchorSchema: v.ObjectSchema<{
4
+ readonly quote: v.ObjectSchema<{
5
+ readonly exact: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 2000, undefined>]>;
6
+ readonly prefix: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>;
7
+ readonly suffix: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>;
8
+ }, undefined>;
9
+ readonly block: v.OptionalSchema<v.ObjectSchema<{
10
+ readonly source: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 8000, undefined>]>;
11
+ readonly lines: v.ObjectSchema<{
12
+ readonly start: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
13
+ readonly end: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>]>;
14
+ }, undefined>;
15
+ }, undefined>, undefined>;
16
+ readonly element: v.OptionalSchema<v.ObjectSchema<{
17
+ readonly selector: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>;
18
+ readonly tag: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 64, undefined>]>;
19
+ }, undefined>, undefined>;
20
+ }, undefined>;
21
+ export type CommentAnchor = v.InferOutput<typeof CommentAnchorSchema>;
22
+ export type BlockLocation = {
23
+ status: 'located' | 'changed';
24
+ lines: {
25
+ start: number;
26
+ end: number;
27
+ };
28
+ } | {
29
+ status: 'orphaned';
30
+ lines: null;
31
+ };
32
+ /** Relocate a Markdown source block without depending on a renderer or DOM. */
33
+ export declare function locateBlock(block: NonNullable<CommentAnchor['block']>, currentSource: string): BlockLocation;
34
+ //# sourceMappingURL=commentAnchor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commentAnchor.d.ts","sourceRoot":"","sources":["../src/commentAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,kFAAkF;AAClF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;aAqB9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AACrE,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAA;AAqCvC,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAC1C,aAAa,EAAE,MAAM,GACpB,aAAa,CA6Ef"}
@@ -0,0 +1,122 @@
1
+ import * as v from 'valibot';
2
+ /** A passage selected in a rendered artifact, with source text for relocation. */
3
+ export const CommentAnchorSchema = v.object({
4
+ quote: v.object({
5
+ exact: v.pipe(v.string(), v.minLength(1), v.maxLength(2000)),
6
+ prefix: v.pipe(v.string(), v.maxLength(64)),
7
+ suffix: v.pipe(v.string(), v.maxLength(64)),
8
+ }),
9
+ block: v.optional(v.object({
10
+ source: v.pipe(v.string(), v.minLength(1), v.maxLength(8000)),
11
+ lines: v.object({
12
+ start: v.pipe(v.number(), v.integer(), v.minValue(1)),
13
+ end: v.pipe(v.number(), v.integer(), v.minValue(1)),
14
+ }),
15
+ })),
16
+ element: v.optional(v.object({
17
+ selector: v.pipe(v.string(), v.maxLength(2000)),
18
+ tag: v.pipe(v.string(), v.maxLength(64)),
19
+ })),
20
+ });
21
+ function lineAt(source, offset) {
22
+ let line = 1;
23
+ for (let i = 0; i < offset; i += 1)
24
+ if (source[i] === '\n')
25
+ line += 1;
26
+ return line;
27
+ }
28
+ /** Distance with a fixed error budget. Rows outside the budget are skipped. */
29
+ function boundedDistance(a, b, budget) {
30
+ if (Math.abs(a.length - b.length) > budget)
31
+ return budget + 1;
32
+ let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
33
+ for (let i = 1; i <= a.length; i += 1) {
34
+ const current = new Array(b.length + 1).fill(budget + 1);
35
+ current[0] = i;
36
+ let rowMin = current[0];
37
+ for (let j = Math.max(1, i - budget); j <= Math.min(b.length, i + budget); j += 1) {
38
+ current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
39
+ rowMin = Math.min(rowMin, current[j]);
40
+ }
41
+ if (rowMin > budget)
42
+ return budget + 1;
43
+ previous = current;
44
+ }
45
+ return previous[b.length];
46
+ }
47
+ /** Cheap ranking before the bounded edit-distance pass. */
48
+ function sampledOverlap(samples, candidate) {
49
+ let shared = 0;
50
+ for (const sample of samples)
51
+ if (candidate.includes(sample))
52
+ shared += 1;
53
+ return shared;
54
+ }
55
+ /** Relocate a Markdown source block without depending on a renderer or DOM. */
56
+ export function locateBlock(block, currentSource) {
57
+ const exactMatches = [];
58
+ let at = currentSource.indexOf(block.source);
59
+ while (at !== -1) {
60
+ const before = at === 0 || currentSource[at - 1] === '\n';
61
+ const end = at + block.source.length;
62
+ const after = end === currentSource.length || currentSource[end] === '\n';
63
+ if (before && after)
64
+ exactMatches.push(at);
65
+ at = currentSource.indexOf(block.source, at + 1);
66
+ }
67
+ if (exactMatches.length > 0) {
68
+ const closest = exactMatches.reduce((best, candidate) => Math.abs(lineAt(currentSource, candidate) - block.lines.start) <
69
+ Math.abs(lineAt(currentSource, best) - block.lines.start)
70
+ ? candidate
71
+ : best);
72
+ const start = lineAt(currentSource, closest);
73
+ return {
74
+ status: 'located',
75
+ lines: { start, end: start + block.source.split('\n').length - 1 },
76
+ };
77
+ }
78
+ const lines = currentSource.split('\n');
79
+ const span = block.source.split('\n').length;
80
+ const budget = Math.min(256, Math.max(2, Math.floor(block.source.length * 0.2)));
81
+ const samples = [];
82
+ const sampleLength = Math.min(8, block.source.length);
83
+ for (let i = 0; i <= block.source.length - sampleLength; i += Math.max(1, Math.floor(block.source.length / 16)))
84
+ samples.push(block.source.slice(i, i + sampleLength));
85
+ const candidates = [];
86
+ const maxCandidates = 8;
87
+ let best = null;
88
+ // The source may be rewrapped across many lines. Grow each candidate only
89
+ // while its character length can still fit inside the edit budget.
90
+ for (let start = 0; start < lines.length; start += 1) {
91
+ for (let length = 1; length <= Math.min(lines.length - start, span + budget); length += 1) {
92
+ if (Math.abs(length - span) > budget)
93
+ continue;
94
+ const candidate = lines.slice(start, start + length).join('\n');
95
+ if (candidate.length > block.source.length + budget)
96
+ break;
97
+ if (Math.abs(block.source.length - candidate.length) > budget)
98
+ continue;
99
+ const score = sampledOverlap(samples, candidate);
100
+ candidates.push({ source: candidate, start: start + 1, end: start + length, score });
101
+ }
102
+ }
103
+ candidates.sort((a, b) => b.score - a.score ||
104
+ Math.abs(a.start - block.lines.start) - Math.abs(b.start - block.lines.start));
105
+ // Fuzzy relocation is best effort. Bound the expensive edit-distance work
106
+ // per comment even when every line of a long document is similar in length.
107
+ for (const candidate of candidates.slice(0, maxCandidates)) {
108
+ const distance = boundedDistance(block.source, candidate.source, budget);
109
+ if (distance <= budget &&
110
+ (best === null ||
111
+ distance < best.distance ||
112
+ (distance === best.distance &&
113
+ Math.abs(candidate.start - block.lines.start) <
114
+ Math.abs(best.start - block.lines.start)))) {
115
+ best = { distance, start: candidate.start, end: candidate.end };
116
+ }
117
+ }
118
+ return best
119
+ ? { status: 'changed', lines: { start: best.start, end: best.end } }
120
+ : { status: 'orphaned', lines: null };
121
+ }
122
+ //# sourceMappingURL=commentAnchor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commentAnchor.js","sourceRoot":"","sources":["../src/commentAnchor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=commentAnchor.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commentAnchor.test.d.ts","sourceRoot":"","sources":["../src/commentAnchor.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,48 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { locateBlock } from './commentAnchor.js';
3
+ describe('comment passage relocation', () => {
4
+ it('points to the nearest copy after a duplicate passage moves', () => {
5
+ const block = { source: 'A repeated paragraph.', lines: { start: 4, end: 4 } };
6
+ expect(locateBlock(block, 'A repeated paragraph.\n\nMiddle\n\nA repeated paragraph.')).toEqual({
7
+ status: 'located',
8
+ lines: { start: 5, end: 5 },
9
+ });
10
+ });
11
+ it('flags changed words at their current lines', () => {
12
+ const block = { source: 'Review the old draft.', lines: { start: 8, end: 8 } };
13
+ expect(locateBlock(block, 'Heading\nReview the new draft.')).toEqual({
14
+ status: 'changed',
15
+ lines: { start: 2, end: 2 },
16
+ });
17
+ });
18
+ it('leaves a deleted passage unlocated', () => {
19
+ const block = {
20
+ source: 'A unique paragraph about permissions.',
21
+ lines: { start: 2, end: 2 },
22
+ };
23
+ expect(locateBlock(block, 'Completely different content')).toEqual({
24
+ status: 'orphaned',
25
+ lines: null,
26
+ });
27
+ });
28
+ it('does not locate a word embedded in a different line', () => {
29
+ const block = { source: 'cat', lines: { start: 1, end: 1 } };
30
+ expect(locateBlock(block, 'concatenate')).toEqual({ status: 'orphaned', lines: null });
31
+ });
32
+ it('finds a changed passage after it moves past similar length prose', () => {
33
+ const original = 'Review the old draft with examples for the setup guide.';
34
+ const changed = 'Review the new draft with examples for the setup guide.';
35
+ const filler = Array.from({ length: 300 }, (_, i) => `Paragraph ${i} has approximately the same length as the review passage.`);
36
+ const block = { source: original, lines: { start: 2, end: 2 } };
37
+ expect(locateBlock(block, [...filler, changed].join('\n'))).toEqual({
38
+ status: 'changed',
39
+ lines: { start: 301, end: 301 },
40
+ });
41
+ });
42
+ it('follows a paragraph reflowed across several source lines', () => {
43
+ const original = 'Review the new draft with concrete examples for the setup guide.';
44
+ const block = { source: original, lines: { start: 1, end: 1 } };
45
+ expect(locateBlock(block, 'Heading\nReview the new draft\nwith concrete examples\nfor the setup guide.')).toEqual({ status: 'changed', lines: { start: 2, end: 4 } });
46
+ });
47
+ });
48
+ //# sourceMappingURL=commentAnchor.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"commentAnchor.test.js","sourceRoot":"","sources":["../src/commentAnchor.test.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -7,6 +7,7 @@
7
7
  export * from './agentGuidancePaths.js';
8
8
  export * from './aliasPaths.js';
9
9
  export * from './bundleSlug.js';
10
+ export * from './commentAnchor.js';
10
11
  export * from './contextKinds.js';
11
12
  export * from './pairing.js';
12
13
  export * from './schemas.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA"}
package/dist/index.js CHANGED
@@ -7,6 +7,7 @@
7
7
  export * from './agentGuidancePaths.js';
8
8
  export * from './aliasPaths.js';
9
9
  export * from './bundleSlug.js';
10
+ export * from './commentAnchor.js';
10
11
  export * from './contextKinds.js';
11
12
  export * from './pairing.js';
12
13
  export * from './schemas.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,yBAAyB,CAAA;AACvC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA"}