opencode-dux 1.0.0

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 (302) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +452 -0
  3. package/dist/agents/descriptions.d.ts +6 -0
  4. package/dist/agents/designer.d.ts +2 -0
  5. package/dist/agents/explorer.d.ts +2 -0
  6. package/dist/agents/fixer.d.ts +2 -0
  7. package/dist/agents/index.d.ts +22 -0
  8. package/dist/agents/interpreter.d.ts +2 -0
  9. package/dist/agents/librarian.d.ts +2 -0
  10. package/dist/agents/oracle.d.ts +2 -0
  11. package/dist/agents/orchestrator.d.ts +27 -0
  12. package/dist/agents/overrides.d.ts +18 -0
  13. package/dist/agents/prompt-blocks.d.ts +97 -0
  14. package/dist/agents/steward.d.ts +3 -0
  15. package/dist/cli/config-io.d.ts +24 -0
  16. package/dist/cli/config-manager.d.ts +4 -0
  17. package/dist/cli/index.d.ts +2 -0
  18. package/dist/cli/index.js +1006 -0
  19. package/dist/cli/install.d.ts +2 -0
  20. package/dist/cli/mcps.d.ts +13 -0
  21. package/dist/cli/model-key-normalization.d.ts +1 -0
  22. package/dist/cli/paths.d.ts +35 -0
  23. package/dist/cli/providers.d.ts +137 -0
  24. package/dist/cli/skills.d.ts +22 -0
  25. package/dist/cli/system.d.ts +5 -0
  26. package/dist/cli/types.d.ts +38 -0
  27. package/dist/config/constants.d.ts +12 -0
  28. package/dist/config/index.d.ts +4 -0
  29. package/dist/config/loader.d.ts +40 -0
  30. package/dist/config/runtime-preset.d.ts +12 -0
  31. package/dist/config/schema.d.ts +281 -0
  32. package/dist/config/utils.d.ts +10 -0
  33. package/dist/discovery/local/types.d.ts +79 -0
  34. package/dist/discovery/local.d.ts +73 -0
  35. package/dist/discovery/mcp-servers.d.ts +88 -0
  36. package/dist/discovery/skills.d.ts +94 -0
  37. package/dist/hooks/apply-patch/codec.d.ts +7 -0
  38. package/dist/hooks/apply-patch/errors.d.ts +25 -0
  39. package/dist/hooks/apply-patch/execution-context.d.ts +27 -0
  40. package/dist/hooks/apply-patch/index.d.ts +15 -0
  41. package/dist/hooks/apply-patch/matching.d.ts +26 -0
  42. package/dist/hooks/apply-patch/operations.d.ts +3 -0
  43. package/dist/hooks/apply-patch/patch.d.ts +2 -0
  44. package/dist/hooks/apply-patch/prepared-changes.d.ts +17 -0
  45. package/dist/hooks/apply-patch/resolution.d.ts +19 -0
  46. package/dist/hooks/apply-patch/rewrite.d.ts +7 -0
  47. package/dist/hooks/apply-patch/test-helpers.d.ts +6 -0
  48. package/dist/hooks/apply-patch/types.d.ts +80 -0
  49. package/dist/hooks/auto-update-checker/cache.d.ts +11 -0
  50. package/dist/hooks/auto-update-checker/checker.d.ts +32 -0
  51. package/dist/hooks/auto-update-checker/constants.d.ts +11 -0
  52. package/dist/hooks/auto-update-checker/index.d.ts +18 -0
  53. package/dist/hooks/auto-update-checker/types.d.ts +22 -0
  54. package/dist/hooks/chat-headers.d.ts +16 -0
  55. package/dist/hooks/context-pressure-reminder/index.d.ts +33 -0
  56. package/dist/hooks/delegate-task-retry/guidance.d.ts +2 -0
  57. package/dist/hooks/delegate-task-retry/hook.d.ts +8 -0
  58. package/dist/hooks/delegate-task-retry/index.d.ts +4 -0
  59. package/dist/hooks/delegate-task-retry/patterns.d.ts +11 -0
  60. package/dist/hooks/filter-available-skills/index.d.ts +32 -0
  61. package/dist/hooks/foreground-fallback/index.d.ts +72 -0
  62. package/dist/hooks/image-hook.d.ts +5 -0
  63. package/dist/hooks/index.d.ts +14 -0
  64. package/dist/hooks/json-error-recovery/hook.d.ts +18 -0
  65. package/dist/hooks/json-error-recovery/index.d.ts +1 -0
  66. package/dist/hooks/phase-reminder/index.d.ts +26 -0
  67. package/dist/hooks/post-file-tool-nudge/index.d.ts +19 -0
  68. package/dist/hooks/task-session-manager/index.d.ts +52 -0
  69. package/dist/hooks/todo-continuation/index.d.ts +53 -0
  70. package/dist/hooks/todo-continuation/todo-hygiene.d.ts +35 -0
  71. package/dist/index.d.ts +5 -0
  72. package/dist/index.js +31782 -0
  73. package/dist/mcp/context7.d.ts +6 -0
  74. package/dist/mcp/grep-app.d.ts +6 -0
  75. package/dist/mcp/index.d.ts +13 -0
  76. package/dist/mcp/types.d.ts +12 -0
  77. package/dist/mcp/websearch.d.ts +9 -0
  78. package/dist/skills/registry.d.ts +29 -0
  79. package/dist/subscriptions/accounts-store.d.ts +57 -0
  80. package/dist/subscriptions/index.d.ts +13 -0
  81. package/dist/subscriptions/neuralwatt-scraper.d.ts +14 -0
  82. package/dist/subscriptions/opencode-go-scraper.d.ts +27 -0
  83. package/dist/subscriptions/types.d.ts +115 -0
  84. package/dist/subscriptions/usage-service.d.ts +74 -0
  85. package/dist/tools/ast-grep/cli.d.ts +15 -0
  86. package/dist/tools/ast-grep/constants.d.ts +25 -0
  87. package/dist/tools/ast-grep/downloader.d.ts +5 -0
  88. package/dist/tools/ast-grep/index.d.ts +10 -0
  89. package/dist/tools/ast-grep/tools.d.ts +3 -0
  90. package/dist/tools/ast-grep/types.d.ts +30 -0
  91. package/dist/tools/ast-grep/utils.d.ts +4 -0
  92. package/dist/tools/delegate.d.ts +14 -0
  93. package/dist/tools/index.d.ts +5 -0
  94. package/dist/tools/preset-manager.d.ts +27 -0
  95. package/dist/tools/smartfetch/binary.d.ts +3 -0
  96. package/dist/tools/smartfetch/cache.d.ts +6 -0
  97. package/dist/tools/smartfetch/constants.d.ts +12 -0
  98. package/dist/tools/smartfetch/index.d.ts +3 -0
  99. package/dist/tools/smartfetch/network.d.ts +38 -0
  100. package/dist/tools/smartfetch/secondary-model.d.ts +28 -0
  101. package/dist/tools/smartfetch/tool.d.ts +3 -0
  102. package/dist/tools/smartfetch/types.d.ts +122 -0
  103. package/dist/tools/smartfetch/utils.d.ts +18 -0
  104. package/dist/tui-state.d.ts +168 -0
  105. package/dist/tui.d.ts +37 -0
  106. package/dist/tui.js +1896 -0
  107. package/dist/utils/agent-variant.d.ts +63 -0
  108. package/dist/utils/compat.d.ts +30 -0
  109. package/dist/utils/env.d.ts +1 -0
  110. package/dist/utils/index.d.ts +9 -0
  111. package/dist/utils/internal-initiator.d.ts +6 -0
  112. package/dist/utils/logger.d.ts +8 -0
  113. package/dist/utils/polling.d.ts +21 -0
  114. package/dist/utils/session-manager.d.ts +55 -0
  115. package/dist/utils/session.d.ts +90 -0
  116. package/dist/utils/subagent-depth.d.ts +35 -0
  117. package/dist/utils/system-collapse.d.ts +6 -0
  118. package/dist/utils/task.d.ts +4 -0
  119. package/dist/utils/zip-extractor.d.ts +1 -0
  120. package/index.ts +1 -0
  121. package/opencode-dux.schema.json +634 -0
  122. package/package.json +103 -0
  123. package/src/agents/descriptions.ts +55 -0
  124. package/src/agents/designer.test.ts +86 -0
  125. package/src/agents/designer.ts +154 -0
  126. package/src/agents/display-name.test.ts +186 -0
  127. package/src/agents/explorer.test.ts +79 -0
  128. package/src/agents/explorer.ts +144 -0
  129. package/src/agents/fixer.test.ts +79 -0
  130. package/src/agents/fixer.ts +145 -0
  131. package/src/agents/index.test.ts +472 -0
  132. package/src/agents/index.ts +248 -0
  133. package/src/agents/interpreter.ts +136 -0
  134. package/src/agents/librarian.test.ts +80 -0
  135. package/src/agents/librarian.ts +145 -0
  136. package/src/agents/oracle.test.ts +89 -0
  137. package/src/agents/oracle.ts +184 -0
  138. package/src/agents/orchestrator.test.ts +116 -0
  139. package/src/agents/orchestrator.ts +574 -0
  140. package/src/agents/overrides.ts +95 -0
  141. package/src/agents/prompt-blocks.test.ts +114 -0
  142. package/src/agents/prompt-blocks.ts +640 -0
  143. package/src/agents/steward.ts +146 -0
  144. package/src/cli/config-io.test.ts +536 -0
  145. package/src/cli/config-io.ts +473 -0
  146. package/src/cli/config-manager.test.ts +141 -0
  147. package/src/cli/config-manager.ts +4 -0
  148. package/src/cli/index.ts +88 -0
  149. package/src/cli/install.ts +282 -0
  150. package/src/cli/mcps.test.ts +62 -0
  151. package/src/cli/mcps.ts +39 -0
  152. package/src/cli/model-key-normalization.test.ts +21 -0
  153. package/src/cli/model-key-normalization.ts +60 -0
  154. package/src/cli/paths.test.ts +167 -0
  155. package/src/cli/paths.ts +144 -0
  156. package/src/cli/providers.test.ts +118 -0
  157. package/src/cli/providers.ts +141 -0
  158. package/src/cli/skills.test.ts +111 -0
  159. package/src/cli/skills.ts +103 -0
  160. package/src/cli/system.test.ts +91 -0
  161. package/src/cli/system.ts +180 -0
  162. package/src/cli/types.ts +43 -0
  163. package/src/config/constants.ts +58 -0
  164. package/src/config/index.ts +4 -0
  165. package/src/config/loader.test.ts +1194 -0
  166. package/src/config/loader.ts +269 -0
  167. package/src/config/model-resolution.test.ts +176 -0
  168. package/src/config/runtime-preset.test.ts +61 -0
  169. package/src/config/runtime-preset.ts +37 -0
  170. package/src/config/schema.ts +248 -0
  171. package/src/config/utils.test.ts +41 -0
  172. package/src/config/utils.ts +23 -0
  173. package/src/discovery/local/types.ts +85 -0
  174. package/src/discovery/local.ts +322 -0
  175. package/src/discovery/mcp-servers.ts +804 -0
  176. package/src/discovery/skills.ts +959 -0
  177. package/src/hooks/apply-patch/codec.test.ts +184 -0
  178. package/src/hooks/apply-patch/codec.ts +352 -0
  179. package/src/hooks/apply-patch/errors.ts +117 -0
  180. package/src/hooks/apply-patch/execution-context.ts +432 -0
  181. package/src/hooks/apply-patch/hook.test.ts +768 -0
  182. package/src/hooks/apply-patch/index.ts +126 -0
  183. package/src/hooks/apply-patch/matching.test.ts +215 -0
  184. package/src/hooks/apply-patch/matching.ts +586 -0
  185. package/src/hooks/apply-patch/operations.test.ts +1535 -0
  186. package/src/hooks/apply-patch/operations.ts +3 -0
  187. package/src/hooks/apply-patch/patch.ts +9 -0
  188. package/src/hooks/apply-patch/prepared-changes.ts +400 -0
  189. package/src/hooks/apply-patch/resolution.test.ts +420 -0
  190. package/src/hooks/apply-patch/resolution.ts +437 -0
  191. package/src/hooks/apply-patch/rewrite.ts +496 -0
  192. package/src/hooks/apply-patch/test-helpers.ts +52 -0
  193. package/src/hooks/apply-patch/types.ts +111 -0
  194. package/src/hooks/auto-update-checker/cache.test.ts +179 -0
  195. package/src/hooks/auto-update-checker/cache.ts +188 -0
  196. package/src/hooks/auto-update-checker/checker.test.ts +159 -0
  197. package/src/hooks/auto-update-checker/checker.ts +308 -0
  198. package/src/hooks/auto-update-checker/constants.ts +33 -0
  199. package/src/hooks/auto-update-checker/index.test.ts +282 -0
  200. package/src/hooks/auto-update-checker/index.ts +225 -0
  201. package/src/hooks/auto-update-checker/types.ts +26 -0
  202. package/src/hooks/chat-headers.test.ts +236 -0
  203. package/src/hooks/chat-headers.ts +97 -0
  204. package/src/hooks/context-pressure-reminder/index.test.ts +179 -0
  205. package/src/hooks/context-pressure-reminder/index.ts +137 -0
  206. package/src/hooks/delegate-task-retry/guidance.ts +41 -0
  207. package/src/hooks/delegate-task-retry/hook.ts +23 -0
  208. package/src/hooks/delegate-task-retry/index.test.ts +38 -0
  209. package/src/hooks/delegate-task-retry/index.ts +7 -0
  210. package/src/hooks/delegate-task-retry/patterns.ts +79 -0
  211. package/src/hooks/filter-available-skills/index.test.ts +297 -0
  212. package/src/hooks/filter-available-skills/index.ts +160 -0
  213. package/src/hooks/foreground-fallback/index.test.ts +624 -0
  214. package/src/hooks/foreground-fallback/index.ts +374 -0
  215. package/src/hooks/image-hook.ts +6 -0
  216. package/src/hooks/index.ts +17 -0
  217. package/src/hooks/json-error-recovery/hook.ts +73 -0
  218. package/src/hooks/json-error-recovery/index.test.ts +111 -0
  219. package/src/hooks/json-error-recovery/index.ts +6 -0
  220. package/src/hooks/phase-reminder/index.test.ts +74 -0
  221. package/src/hooks/phase-reminder/index.ts +85 -0
  222. package/src/hooks/post-file-tool-nudge/index.test.ts +94 -0
  223. package/src/hooks/post-file-tool-nudge/index.ts +63 -0
  224. package/src/hooks/task-session-manager/index.test.ts +833 -0
  225. package/src/hooks/task-session-manager/index.ts +434 -0
  226. package/src/hooks/todo-continuation/index.test.ts +3026 -0
  227. package/src/hooks/todo-continuation/index.ts +878 -0
  228. package/src/hooks/todo-continuation/todo-hygiene.test.ts +204 -0
  229. package/src/hooks/todo-continuation/todo-hygiene.ts +207 -0
  230. package/src/index.ts +1672 -0
  231. package/src/mcp/context7.ts +14 -0
  232. package/src/mcp/grep-app.ts +11 -0
  233. package/src/mcp/index.test.ts +96 -0
  234. package/src/mcp/index.ts +66 -0
  235. package/src/mcp/types.ts +16 -0
  236. package/src/mcp/websearch.ts +47 -0
  237. package/src/skills/codemap/README.md +60 -0
  238. package/src/skills/codemap/SKILL.md +174 -0
  239. package/src/skills/codemap/scripts/codemap.mjs +483 -0
  240. package/src/skills/codemap/scripts/codemap.test.ts +129 -0
  241. package/src/skills/registry.ts +218 -0
  242. package/src/skills/simplify/README.md +19 -0
  243. package/src/skills/simplify/SKILL.md +138 -0
  244. package/src/subscriptions/accounts-store.test.ts +236 -0
  245. package/src/subscriptions/accounts-store.ts +184 -0
  246. package/src/subscriptions/index.ts +30 -0
  247. package/src/subscriptions/neuralwatt-scraper.ts +108 -0
  248. package/src/subscriptions/opencode-go-scraper.ts +301 -0
  249. package/src/subscriptions/types.ts +145 -0
  250. package/src/subscriptions/usage-service.test.ts +202 -0
  251. package/src/subscriptions/usage-service.ts +651 -0
  252. package/src/tools/ast-grep/cli.ts +257 -0
  253. package/src/tools/ast-grep/constants.ts +214 -0
  254. package/src/tools/ast-grep/downloader.ts +131 -0
  255. package/src/tools/ast-grep/index.ts +24 -0
  256. package/src/tools/ast-grep/tools.ts +117 -0
  257. package/src/tools/ast-grep/types.ts +51 -0
  258. package/src/tools/ast-grep/utils.ts +126 -0
  259. package/src/tools/delegate-handoff.test.ts +18 -0
  260. package/src/tools/delegate.ts +508 -0
  261. package/src/tools/index.ts +8 -0
  262. package/src/tools/preset-manager.test.ts +795 -0
  263. package/src/tools/preset-manager.ts +332 -0
  264. package/src/tools/smartfetch/binary.ts +58 -0
  265. package/src/tools/smartfetch/cache.test.ts +34 -0
  266. package/src/tools/smartfetch/cache.ts +112 -0
  267. package/src/tools/smartfetch/constants.ts +29 -0
  268. package/src/tools/smartfetch/index.ts +8 -0
  269. package/src/tools/smartfetch/network.test.ts +178 -0
  270. package/src/tools/smartfetch/network.ts +614 -0
  271. package/src/tools/smartfetch/secondary-model.test.ts +85 -0
  272. package/src/tools/smartfetch/secondary-model.ts +276 -0
  273. package/src/tools/smartfetch/tool.test.ts +60 -0
  274. package/src/tools/smartfetch/tool.ts +832 -0
  275. package/src/tools/smartfetch/types.ts +135 -0
  276. package/src/tools/smartfetch/utils.test.ts +24 -0
  277. package/src/tools/smartfetch/utils.ts +456 -0
  278. package/src/tui-state.test.ts +867 -0
  279. package/src/tui-state.ts +1255 -0
  280. package/src/tui.test.ts +336 -0
  281. package/src/tui.ts +1539 -0
  282. package/src/utils/agent-variant.test.ts +244 -0
  283. package/src/utils/agent-variant.ts +187 -0
  284. package/src/utils/compat.ts +91 -0
  285. package/src/utils/env.ts +12 -0
  286. package/src/utils/index.ts +9 -0
  287. package/src/utils/internal-initiator.ts +28 -0
  288. package/src/utils/logger.test.ts +220 -0
  289. package/src/utils/logger.ts +136 -0
  290. package/src/utils/polling.test.ts +191 -0
  291. package/src/utils/polling.ts +67 -0
  292. package/src/utils/session-manager.test.ts +173 -0
  293. package/src/utils/session-manager.ts +356 -0
  294. package/src/utils/session.test.ts +110 -0
  295. package/src/utils/session.ts +389 -0
  296. package/src/utils/subagent-depth.test.ts +170 -0
  297. package/src/utils/subagent-depth.ts +75 -0
  298. package/src/utils/system-collapse.test.ts +86 -0
  299. package/src/utils/system-collapse.ts +24 -0
  300. package/src/utils/task.test.ts +24 -0
  301. package/src/utils/task.ts +20 -0
  302. package/src/utils/zip-extractor.ts +102 -0
@@ -0,0 +1,126 @@
1
+ import type { PluginInput } from '@opencode-ai/plugin';
2
+
3
+ import { log } from '../../utils/logger';
4
+ import {
5
+ createApplyPatchInternalError,
6
+ getApplyPatchErrorDetails,
7
+ isApplyPatchError,
8
+ isApplyPatchVerificationError,
9
+ } from './errors';
10
+ import { rewritePatch } from './operations';
11
+ import type { ApplyPatchRuntimeOptions } from './types';
12
+
13
+ const APPLY_PATCH_RESCUE_OPTIONS: ApplyPatchRuntimeOptions = {
14
+ prefixSuffix: true,
15
+ lcsRescue: true,
16
+ };
17
+
18
+ interface ToolExecuteBeforeInput {
19
+ tool: string;
20
+ directory?: string;
21
+ }
22
+
23
+ interface ToolExecuteBeforeOutput {
24
+ args?: {
25
+ patchText?: unknown;
26
+ [key: string]: unknown;
27
+ };
28
+ }
29
+
30
+ export function createApplyPatchHook(ctx: PluginInput) {
31
+ function logHookStatus(
32
+ state:
33
+ | 'rewrite'
34
+ | 'unchanged'
35
+ | 'skipped'
36
+ | 'blocked'
37
+ | 'validation'
38
+ | 'verification'
39
+ | 'internal',
40
+ data?: Record<string, unknown>,
41
+ ) {
42
+ log(`apply-patch hook ${state}`, data);
43
+ }
44
+
45
+ return {
46
+ 'tool.execute.before': async (
47
+ input: ToolExecuteBeforeInput,
48
+ output: ToolExecuteBeforeOutput,
49
+ ): Promise<void> => {
50
+ if (input.tool !== 'apply_patch') {
51
+ return;
52
+ }
53
+
54
+ const args = output.args;
55
+ if (!args || typeof args.patchText !== 'string') {
56
+ return;
57
+ }
58
+ const patchText = args.patchText;
59
+
60
+ const root = input.directory || ctx.directory || process.cwd();
61
+ const worktree = ctx.worktree || root;
62
+ try {
63
+ const result = await rewritePatch(
64
+ root,
65
+ patchText,
66
+ APPLY_PATCH_RESCUE_OPTIONS,
67
+ worktree,
68
+ );
69
+
70
+ if (result.changed) {
71
+ args.patchText = result.patchText;
72
+ logHookStatus('rewrite');
73
+ return;
74
+ }
75
+
76
+ logHookStatus('unchanged');
77
+ return;
78
+ } catch (error) {
79
+ const normalizedError = isApplyPatchError(error)
80
+ ? error
81
+ : createApplyPatchInternalError(
82
+ `Unexpected hook failure before native apply: ${error instanceof Error ? error.message : String(error)}`,
83
+ error,
84
+ );
85
+ const details = getApplyPatchErrorDetails(normalizedError);
86
+
87
+ if (
88
+ normalizedError.kind === 'blocked' &&
89
+ // Only the plugin-side outside-workspace preflight should fail open.
90
+ // Keep the code check explicit so any future blocked error remains
91
+ // fail-closed by default.
92
+ details?.code === 'outside_workspace'
93
+ ) {
94
+ logHookStatus('skipped', {
95
+ kind: details.kind,
96
+ code: details.code,
97
+ reason: normalizedError.message,
98
+ failOpen: true,
99
+ rescueOptions: APPLY_PATCH_RESCUE_OPTIONS,
100
+ rewriteStage: 'before-native',
101
+ });
102
+ return;
103
+ }
104
+
105
+ logHookStatus(
106
+ isApplyPatchVerificationError(normalizedError)
107
+ ? 'verification'
108
+ : normalizedError.kind === 'validation'
109
+ ? 'validation'
110
+ : normalizedError.kind === 'internal'
111
+ ? 'internal'
112
+ : 'blocked',
113
+ {
114
+ kind: details?.kind ?? 'internal',
115
+ code: details?.code ?? 'internal_unexpected',
116
+ reason: normalizedError.message,
117
+ failOpen: false,
118
+ rescueOptions: APPLY_PATCH_RESCUE_OPTIONS,
119
+ rewriteStage: 'before-native',
120
+ },
121
+ );
122
+ throw normalizedError;
123
+ }
124
+ },
125
+ };
126
+ }
@@ -0,0 +1,215 @@
1
+ import { describe, expect, test } from 'bun:test';
2
+
3
+ import {
4
+ autoRescueComparators,
5
+ permissiveComparators,
6
+ prefix,
7
+ rescueByLcs,
8
+ rescueByPrefixSuffix,
9
+ seek,
10
+ seekMatch,
11
+ suffix,
12
+ } from './matching';
13
+
14
+ describe('apply-patch/matching', () => {
15
+ test('seek finds matches with unicode and trim-end', () => {
16
+ expect(seek(['console.log(“hola”); '], ['console.log("hola");'], 0)).toBe(
17
+ 0,
18
+ );
19
+ });
20
+
21
+ test('seek does not rescue trim-only matches with different indentation', () => {
22
+ expect(seek([' console.log("hola");'], ['console.log("hola");'], 0)).toBe(
23
+ -1,
24
+ );
25
+ });
26
+
27
+ test('prefix and suffix detect common edges', () => {
28
+ const oldLines = [
29
+ 'const title = "Hola";',
30
+ 'old-value',
31
+ 'const footer = "Fin";',
32
+ ];
33
+ const newLines = [
34
+ 'const title = “Hola”;',
35
+ 'new-value',
36
+ 'const footer = “Fin”;',
37
+ ];
38
+
39
+ expect(prefix(oldLines, newLines)).toBe(1);
40
+ expect(suffix(oldLines, newLines, 1)).toBe(1);
41
+ });
42
+
43
+ test('rescueByPrefixSuffix rescues a single stale block', () => {
44
+ const result = rescueByPrefixSuffix(
45
+ ['top', 'const title = “Hola”;', 'stale-value', 'const footer = “Fin”;'],
46
+ ['const title = "Hola";', 'old-value', 'const footer = "Fin";'],
47
+ ['const title = “Hola”;', 'new-value', 'const footer = “Fin”;'],
48
+ 0,
49
+ );
50
+
51
+ expect(result).toEqual({
52
+ kind: 'match',
53
+ hit: {
54
+ start: 2,
55
+ del: 1,
56
+ add: ['new-value'],
57
+ },
58
+ });
59
+ });
60
+
61
+ test('rescueByPrefixSuffix marks ambiguity when multiple locations exist', () => {
62
+ expect(
63
+ rescueByPrefixSuffix(
64
+ ['left', 'stale-one', 'right', 'gap', 'left', 'stale-two', 'right'],
65
+ ['left', 'old', 'right'],
66
+ ['left', 'new', 'right'],
67
+ 0,
68
+ ),
69
+ ).toEqual({ kind: 'ambiguous', phase: 'prefix_suffix' });
70
+ });
71
+
72
+ test('rescueByPrefixSuffix preserves one-line unicode plus trim-end pairing', () => {
73
+ expect(
74
+ rescueByPrefixSuffix(
75
+ ['left “x”', 'stale', 'right '],
76
+ ['left "x"', 'old', 'right'],
77
+ ['left "x"', 'new', 'right'],
78
+ 0,
79
+ ),
80
+ ).toEqual({
81
+ kind: 'match',
82
+ hit: {
83
+ start: 1,
84
+ del: 1,
85
+ add: ['new'],
86
+ },
87
+ });
88
+ });
89
+
90
+ test('rescueByPrefixSuffix keeps tolerant one-line ambiguity detection', () => {
91
+ expect(
92
+ rescueByPrefixSuffix(
93
+ ['left', 'stale-one', 'right', 'left ', 'stale-two', 'right'],
94
+ ['left', 'old', 'right'],
95
+ ['left', 'new', 'right'],
96
+ 0,
97
+ ),
98
+ ).toEqual({ kind: 'ambiguous', phase: 'prefix_suffix' });
99
+ });
100
+
101
+ test('rescueByPrefixSuffix ignores one-line right hits before the left edge', () => {
102
+ expect(
103
+ rescueByPrefixSuffix(
104
+ ['right', 'left', 'stale'],
105
+ ['left', 'old', 'right'],
106
+ ['left', 'new', 'right'],
107
+ 0,
108
+ ),
109
+ ).toEqual({ kind: 'miss' });
110
+ });
111
+
112
+ test('rescueByLcs respects the start and finds a single candidate', () => {
113
+ const result = rescueByLcs(
114
+ [
115
+ 'head',
116
+ 'left',
117
+ 'stable-old',
118
+ 'keep',
119
+ 'right',
120
+ 'gap',
121
+ 'anchor',
122
+ 'left',
123
+ 'stale-old',
124
+ 'keep',
125
+ 'right',
126
+ 'tail',
127
+ ],
128
+ ['left', 'old', 'keep', 'right'],
129
+ ['left', 'new', 'keep', 'right'],
130
+ 5,
131
+ );
132
+
133
+ expect(result).toEqual({
134
+ kind: 'match',
135
+ hit: {
136
+ start: 7,
137
+ del: 4,
138
+ add: ['left', 'new', 'keep', 'right'],
139
+ },
140
+ });
141
+ });
142
+
143
+ test('rescueByLcs marks ambiguity when two windows tie without common edges', () => {
144
+ expect(
145
+ rescueByLcs(
146
+ ['head', 'alpha', 'beta', 'mid', 'alpha', 'beta', 'tail'],
147
+ ['alpha', 'beta'],
148
+ ['ALPHA', 'BETA'],
149
+ 0,
150
+ ),
151
+ ).toEqual({ kind: 'ambiguous', phase: 'lcs' });
152
+ });
153
+
154
+ test('rescueByLcs rejects windows with only one matching edge even when the score is high', () => {
155
+ expect(
156
+ rescueByLcs(
157
+ ['a', 'a', 'a', 'a', 'b', 'c'],
158
+ ['a', 'b', 'c', 'd'],
159
+ ['A', 'B', 'C', 'D'],
160
+ 0,
161
+ ),
162
+ ).toEqual({ kind: 'miss' });
163
+ });
164
+
165
+ test('rescueByLcs prunes a disproportionate chunk even when it has compatible edges', () => {
166
+ const oldLines = Array.from({ length: 49 }, (_, index) => `line-${index}`);
167
+ const lines = [...oldLines];
168
+ lines[24] = 'line-24-stale';
169
+
170
+ expect(
171
+ rescueByLcs(
172
+ lines,
173
+ oldLines,
174
+ oldLines.map((line, index) => (index === 24 ? 'line-24-new' : line)),
175
+ 0,
176
+ ),
177
+ ).toEqual({ kind: 'miss' });
178
+ });
179
+
180
+ test('rescueByLcs discards an implausible window before expensive scoring', () => {
181
+ expect(
182
+ rescueByLcs(
183
+ ['left', 'noise-a', 'keep', 'noise-b', 'right'],
184
+ ['left', 'old-a', 'old-b', 'old-c', 'right'],
185
+ ['left', 'new-a', 'new-b', 'new-c', 'right'],
186
+ 0,
187
+ ),
188
+ ).toEqual({ kind: 'miss' });
189
+ });
190
+
191
+ test('seek matches mixed curly and straight quotes', () => {
192
+ expect(
193
+ seek(
194
+ ["const title = \u201cit's ready\u201d; "],
195
+ ['const title = "it\'s ready";'],
196
+ 0,
197
+ ),
198
+ ).toBe(0);
199
+ });
200
+
201
+ test('seekMatch reports when the match was only tolerant and safe', () => {
202
+ expect(
203
+ seekMatch(['console.log(“hola”); '], ['console.log("hola");'], 0),
204
+ ).toEqual({
205
+ index: 0,
206
+ comparator: 'unicode-trim-end',
207
+ exact: false,
208
+ });
209
+ });
210
+
211
+ test('comparator separation distinguishes safe rescue from permissive comparators', () => {
212
+ expect(autoRescueComparators).toHaveLength(4);
213
+ expect(permissiveComparators).toHaveLength(6);
214
+ });
215
+ });