synabun 2.0.10 → 2.2.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 (656) hide show
  1. package/CHANGELOG.md +207 -0
  2. package/README.md +25 -2
  3. package/THIRD-PARTY-LICENSES.md +22 -0
  4. package/bin/synabun.js +71 -24
  5. package/docs/whatsapp.md +13 -13
  6. package/hooks/claude-code/pre-websearch.mjs +12 -1
  7. package/hooks/claude-code/shared.mjs +5 -0
  8. package/hooks/claude-code/stop.mjs +1 -1
  9. package/lib/claude-hooks.js +172 -18
  10. package/lib/client-config-repair.js +30 -17
  11. package/lib/desktop-app.js +7 -1
  12. package/lib/external-tools.js +7 -6
  13. package/lib/first-launch-protection.js +57 -12
  14. package/lib/mcp-dist.js +176 -0
  15. package/lib/release-npm-ci.mjs +138 -0
  16. package/lib/release-publish.mjs +91 -0
  17. package/lib/release-scan.mjs +50 -0
  18. package/lib/server-crash-record.js +123 -0
  19. package/lib/server-exit.js +318 -0
  20. package/lib/server-supervisor.js +508 -0
  21. package/lib/start-launcher.js +37 -4
  22. package/lib/tools-cli.js +45 -0
  23. package/lib/update-snapshot.js +302 -0
  24. package/lib/virustotal.mjs +203 -0
  25. package/lib/windows-crash-event.js +269 -0
  26. package/mcp-server/dist/http.d.ts +20 -1
  27. package/mcp-server/dist/http.d.ts.map +1 -1
  28. package/mcp-server/dist/http.js +59 -12
  29. package/mcp-server/dist/http.js.map +1 -1
  30. package/mcp-server/dist/index.d.ts +33 -27
  31. package/mcp-server/dist/index.d.ts.map +1 -1
  32. package/mcp-server/dist/index.js +128 -143
  33. package/mcp-server/dist/index.js.map +1 -1
  34. package/mcp-server/dist/preload.js +1 -1
  35. package/mcp-server/dist/preload.js.map +1 -1
  36. package/mcp-server/dist/services/budget-judgments.d.ts +1 -1
  37. package/mcp-server/dist/services/budget-judgments.d.ts.map +1 -1
  38. package/mcp-server/dist/services/budget-judgments.js +5 -3
  39. package/mcp-server/dist/services/budget-judgments.js.map +1 -1
  40. package/mcp-server/dist/services/codex-config-heal.d.ts +6 -2
  41. package/mcp-server/dist/services/codex-config-heal.d.ts.map +1 -1
  42. package/mcp-server/dist/services/codex-config-heal.js +81 -28
  43. package/mcp-server/dist/services/codex-config-heal.js.map +1 -1
  44. package/mcp-server/dist/services/identity.d.ts +2 -2
  45. package/mcp-server/dist/services/identity.js +2 -2
  46. package/mcp-server/dist/services/memory-judge-backfill.d.ts +6 -0
  47. package/mcp-server/dist/services/memory-judge-backfill.d.ts.map +1 -1
  48. package/mcp-server/dist/services/memory-judge-backfill.js +7 -1
  49. package/mcp-server/dist/services/memory-judge-backfill.js.map +1 -1
  50. package/mcp-server/dist/services/memory-sessions.d.ts +1 -1
  51. package/mcp-server/dist/services/memory-sessions.d.ts.map +1 -1
  52. package/mcp-server/dist/services/memory-sessions.js +28 -2
  53. package/mcp-server/dist/services/memory-sessions.js.map +1 -1
  54. package/mcp-server/dist/services/neural-interface.d.ts +18 -11
  55. package/mcp-server/dist/services/neural-interface.d.ts.map +1 -1
  56. package/mcp-server/dist/services/neural-interface.js +67 -11
  57. package/mcp-server/dist/services/neural-interface.js.map +1 -1
  58. package/mcp-server/dist/services/server-instructions.d.ts +7 -2
  59. package/mcp-server/dist/services/server-instructions.d.ts.map +1 -1
  60. package/mcp-server/dist/services/server-instructions.js +22 -63
  61. package/mcp-server/dist/services/server-instructions.js.map +1 -1
  62. package/mcp-server/dist/services/tool-catalog.d.ts +120 -0
  63. package/mcp-server/dist/services/tool-catalog.d.ts.map +1 -0
  64. package/mcp-server/dist/services/tool-catalog.js +339 -0
  65. package/mcp-server/dist/services/tool-catalog.js.map +1 -0
  66. package/mcp-server/dist/services/tool-list-refresh-barrier.d.ts +12 -0
  67. package/mcp-server/dist/services/tool-list-refresh-barrier.d.ts.map +1 -0
  68. package/mcp-server/dist/services/tool-list-refresh-barrier.js +40 -0
  69. package/mcp-server/dist/services/tool-list-refresh-barrier.js.map +1 -0
  70. package/mcp-server/dist/services/tool-list.d.ts +108 -0
  71. package/mcp-server/dist/services/tool-list.d.ts.map +1 -0
  72. package/mcp-server/dist/services/tool-list.js +334 -0
  73. package/mcp-server/dist/services/tool-list.js.map +1 -0
  74. package/mcp-server/dist/services/tool-runtime.d.ts +161 -0
  75. package/mcp-server/dist/services/tool-runtime.d.ts.map +1 -0
  76. package/mcp-server/dist/services/tool-runtime.js +400 -0
  77. package/mcp-server/dist/services/tool-runtime.js.map +1 -0
  78. package/mcp-server/dist/services/typesafe-config.js +1 -1
  79. package/mcp-server/dist/services/typesafe-config.js.map +1 -1
  80. package/mcp-server/dist/services/whiteboard-geometry.d.ts +26 -2
  81. package/mcp-server/dist/services/whiteboard-geometry.d.ts.map +1 -1
  82. package/mcp-server/dist/services/whiteboard-geometry.js +91 -8
  83. package/mcp-server/dist/services/whiteboard-geometry.js.map +1 -1
  84. package/mcp-server/dist/tools/agents.d.ts +14 -14
  85. package/mcp-server/dist/tools/agents.d.ts.map +1 -1
  86. package/mcp-server/dist/tools/agents.js +29 -19
  87. package/mcp-server/dist/tools/agents.js.map +1 -1
  88. package/mcp-server/dist/tools/browser-batch.d.ts +3 -3
  89. package/mcp-server/dist/tools/choice.d.ts +6 -0
  90. package/mcp-server/dist/tools/choice.d.ts.map +1 -1
  91. package/mcp-server/dist/tools/choice.js +18 -13
  92. package/mcp-server/dist/tools/choice.js.map +1 -1
  93. package/mcp-server/dist/tools/git-tools.js +2 -2
  94. package/mcp-server/dist/tools/git-tools.js.map +1 -1
  95. package/mcp-server/dist/tools/image-tools.d.ts +1 -1
  96. package/mcp-server/dist/tools/image-tools.js +1 -1
  97. package/mcp-server/dist/tools/morelogin.d.ts.map +1 -1
  98. package/mcp-server/dist/tools/morelogin.js +9 -6
  99. package/mcp-server/dist/tools/morelogin.js.map +1 -1
  100. package/mcp-server/dist/tools/skill-tools.d.ts +505 -0
  101. package/mcp-server/dist/tools/skill-tools.d.ts.map +1 -0
  102. package/mcp-server/dist/tools/skill-tools.js +642 -0
  103. package/mcp-server/dist/tools/skill-tools.js.map +1 -0
  104. package/mcp-server/dist/tools/skill.d.ts +7 -0
  105. package/mcp-server/dist/tools/skill.d.ts.map +1 -0
  106. package/mcp-server/dist/tools/skill.js +11 -0
  107. package/mcp-server/dist/tools/skill.js.map +1 -0
  108. package/mcp-server/dist/tools/tool-groups.d.ts +68 -0
  109. package/mcp-server/dist/tools/tool-groups.d.ts.map +1 -0
  110. package/mcp-server/dist/tools/tool-groups.js +147 -0
  111. package/mcp-server/dist/tools/tool-groups.js.map +1 -0
  112. package/mcp-server/dist/tools/whiteboard-format.d.ts.map +1 -1
  113. package/mcp-server/dist/tools/whiteboard-format.js +7 -4
  114. package/mcp-server/dist/tools/whiteboard-format.js.map +1 -1
  115. package/mcp-server/dist/tools/whiteboard-tools.d.ts +64 -13
  116. package/mcp-server/dist/tools/whiteboard-tools.d.ts.map +1 -1
  117. package/mcp-server/dist/tools/whiteboard-tools.js +30 -5
  118. package/mcp-server/dist/tools/whiteboard-tools.js.map +1 -1
  119. package/mcp-server/package-lock.json +2 -2
  120. package/mcp-server/package.json +1 -1
  121. package/mcp-server/src/http.ts +75 -12
  122. package/mcp-server/src/index.ts +147 -154
  123. package/mcp-server/src/preload.ts +12 -12
  124. package/mcp-server/src/services/budget-judgments.ts +5 -3
  125. package/mcp-server/src/services/codex-config-heal.ts +80 -29
  126. package/mcp-server/src/services/identity.ts +2 -2
  127. package/mcp-server/src/services/memory-judge-backfill.ts +7 -1
  128. package/mcp-server/src/services/memory-sessions.ts +24 -3
  129. package/mcp-server/src/services/neural-interface.ts +81 -21
  130. package/mcp-server/src/services/server-instructions.ts +29 -64
  131. package/mcp-server/src/services/tool-catalog.ts +403 -0
  132. package/mcp-server/src/services/tool-list-refresh-barrier.ts +33 -0
  133. package/mcp-server/src/services/tool-list.ts +410 -0
  134. package/mcp-server/src/services/tool-runtime.ts +457 -0
  135. package/mcp-server/src/services/typesafe-config.ts +1 -1
  136. package/mcp-server/src/services/whiteboard-geometry.ts +94 -9
  137. package/mcp-server/src/tools/agents.ts +29 -20
  138. package/mcp-server/src/tools/choice.ts +17 -12
  139. package/mcp-server/src/tools/git-tools.ts +2 -2
  140. package/mcp-server/src/tools/image-tools.ts +1 -1
  141. package/mcp-server/src/tools/morelogin.ts +6 -4
  142. package/mcp-server/src/tools/skill-tools.ts +592 -0
  143. package/mcp-server/src/tools/skill.ts +13 -0
  144. package/mcp-server/src/tools/tool-groups.ts +164 -0
  145. package/mcp-server/src/tools/whiteboard-format.ts +9 -3
  146. package/mcp-server/src/tools/whiteboard-tools.ts +39 -5
  147. package/neural-interface/i18n/en.json +3953 -228
  148. package/neural-interface/i18n/pt-BR.json +3901 -179
  149. package/neural-interface/lib/agent-sandbox-elevation.js +6 -0
  150. package/neural-interface/lib/antigravity/acp-client-host.js +554 -0
  151. package/neural-interface/lib/antigravity/acp-connection.js +299 -0
  152. package/neural-interface/lib/antigravity/bypass.js +100 -0
  153. package/neural-interface/lib/antigravity/catalog.js +273 -0
  154. package/neural-interface/lib/antigravity/home.js +260 -0
  155. package/neural-interface/lib/antigravity/migrate-gemini.js +139 -0
  156. package/neural-interface/lib/antigravity/panel-bridge.js +1058 -0
  157. package/neural-interface/lib/antigravity/policy-hook.mjs +78 -0
  158. package/neural-interface/lib/antigravity/policy.js +74 -0
  159. package/neural-interface/lib/antigravity/tool-call.js +178 -0
  160. package/neural-interface/lib/antigravity/transcripts.js +252 -0
  161. package/neural-interface/lib/antigravity/usage.js +43 -0
  162. package/neural-interface/lib/assistant-api.js +128 -28
  163. package/neural-interface/lib/assistant-brains/antigravity.js +423 -0
  164. package/neural-interface/lib/assistant-brains/claude.js +4 -3
  165. package/neural-interface/lib/assistant-brains/codex-browser-policy-hook.mjs +12 -2
  166. package/neural-interface/lib/assistant-brains/codex-route-gate-hook.mjs +32 -9
  167. package/neural-interface/lib/assistant-brains/codex.js +9 -5
  168. package/neural-interface/lib/assistant-brains/opencode.js +120 -54
  169. package/neural-interface/lib/assistant-brains/opencode2-browser-policy/index.js +28 -13
  170. package/neural-interface/lib/assistant-brains/opencode2-route-gate/index.js +59 -19
  171. package/neural-interface/lib/assistant-budget-planner.js +7 -3
  172. package/neural-interface/lib/assistant-budget-split.js +42 -15
  173. package/neural-interface/lib/assistant-catalog.js +81 -15
  174. package/neural-interface/lib/assistant-config.js +6 -3
  175. package/neural-interface/lib/assistant-dispatch.js +1073 -200
  176. package/neural-interface/lib/assistant-envelope.js +156 -2
  177. package/neural-interface/lib/assistant-evidence.js +80 -0
  178. package/neural-interface/lib/assistant-hidden-models.js +7 -5
  179. package/neural-interface/lib/assistant-persona.js +93 -19
  180. package/neural-interface/lib/assistant-plan-permissions.js +25 -9
  181. package/neural-interface/lib/assistant-route-gate-codex.js +3 -0
  182. package/neural-interface/lib/assistant-route-gate.js +6 -4
  183. package/neural-interface/lib/assistant-router.js +245 -38
  184. package/neural-interface/lib/assistant-runtime.js +214 -30
  185. package/neural-interface/lib/assistant-task-prompt.js +87 -21
  186. package/neural-interface/lib/assistant-tools.js +51 -0
  187. package/neural-interface/lib/assistant-usage.js +29 -0
  188. package/neural-interface/lib/backup-service.js +626 -4
  189. package/neural-interface/lib/backup-zip-reader.js +10 -5
  190. package/neural-interface/lib/backup-zip-writer.js +257 -0
  191. package/neural-interface/lib/browser-execution.js +10 -2
  192. package/neural-interface/lib/browser-guard-cdp.js +84 -0
  193. package/neural-interface/lib/browser-network-guard.js +476 -0
  194. package/neural-interface/lib/browser-policy-roots.js +64 -0
  195. package/neural-interface/lib/browser-tool-policy.js +198 -38
  196. package/neural-interface/lib/claude-agent-bridge.js +11 -2
  197. package/neural-interface/lib/claude-history-cache.js +210 -0
  198. package/neural-interface/lib/claude-hooks-status.js +103 -0
  199. package/neural-interface/lib/claude-model-catalog.js +5 -1
  200. package/neural-interface/lib/claude-temporary.js +5 -11
  201. package/neural-interface/lib/cli-install-api.js +1 -1
  202. package/neural-interface/lib/cli-install.js +163 -154
  203. package/neural-interface/lib/cli-resolver.js +13 -3
  204. package/neural-interface/lib/cli-update-planner.js +52 -41
  205. package/neural-interface/lib/cloudflared/tunnel.js +42 -2
  206. package/neural-interface/lib/codex-mcp-approvals.js +11 -0
  207. package/neural-interface/lib/codex-rollout-reader.js +52 -0
  208. package/neural-interface/lib/codex-worker-app-server.js +191 -0
  209. package/neural-interface/lib/confined-fs.js +30 -3
  210. package/neural-interface/lib/crash-notice-api.js +98 -0
  211. package/neural-interface/lib/editor-completion-opencode.js +68 -68
  212. package/neural-interface/lib/editor-git-api.js +3 -20
  213. package/neural-interface/lib/exec-loop-command.js +13 -10
  214. package/neural-interface/lib/file-explorer-api.js +74 -40
  215. package/neural-interface/lib/file-explorer-watch.js +9 -3
  216. package/neural-interface/lib/git-bash/install.js +52 -6
  217. package/neural-interface/lib/git-bash/manager.js +59 -17
  218. package/neural-interface/lib/git-bash/pins.js +12 -0
  219. package/neural-interface/lib/git-read.js +2 -2
  220. package/neural-interface/lib/git-status-runner.js +390 -0
  221. package/neural-interface/lib/git-status-watchdog.js +40 -0
  222. package/neural-interface/lib/greeting/budgets.js +1 -0
  223. package/neural-interface/lib/greeting/engine.js +2 -2
  224. package/neural-interface/lib/greeting/sources.js +10 -12
  225. package/neural-interface/lib/greeting/writer.js +1 -1
  226. package/neural-interface/lib/http-guards.js +8 -2
  227. package/neural-interface/lib/install-details.js +4 -1
  228. package/neural-interface/lib/mcp-agent-servers.js +67 -0
  229. package/neural-interface/lib/mcp-client-config.js +35 -33
  230. package/neural-interface/lib/mcp-external-servers.js +332 -0
  231. package/neural-interface/lib/mcp-installer.js +2 -1
  232. package/neural-interface/lib/{mcp-profile-refresh-coordinator.js → mcp-tools-refresh-coordinator.js} +4 -4
  233. package/neural-interface/lib/memory-session-capture.js +17 -3
  234. package/neural-interface/lib/morelogin.js +177 -25
  235. package/neural-interface/lib/native-loop-providers.js +965 -66
  236. package/neural-interface/lib/native-loop-runtime.js +290 -42
  237. package/neural-interface/lib/opencode-config.js +557 -0
  238. package/neural-interface/lib/opencode-db-schema.js +17 -34
  239. package/neural-interface/lib/opencode-history.js +48 -218
  240. package/neural-interface/lib/opencode-mcp-ready.js +108 -0
  241. package/neural-interface/lib/opencode-native-boundary.js +53 -0
  242. package/neural-interface/lib/opencode-protocol.js +249 -112
  243. package/neural-interface/lib/opencode-runtime-config.js +32 -22
  244. package/neural-interface/lib/opencode-serve-records.js +39 -21
  245. package/neural-interface/lib/opencode-v2-client.js +48 -153
  246. package/neural-interface/lib/opencode-v2-ws-requests.js +36 -210
  247. package/neural-interface/lib/opencode-worker-data.js +27 -0
  248. package/neural-interface/lib/opencode2-client.js +73 -37
  249. package/neural-interface/lib/opencode2-proxy.js +23 -63
  250. package/neural-interface/lib/opencode2-translate.js +51 -2
  251. package/neural-interface/lib/owner-authority.js +249 -0
  252. package/neural-interface/lib/page-session.js +275 -0
  253. package/neural-interface/lib/path-confine.js +12 -9
  254. package/neural-interface/lib/peer-identity.js +793 -0
  255. package/neural-interface/lib/pty-host/core.js +28 -1
  256. package/neural-interface/lib/pty-host/lifetime.js +12 -0
  257. package/neural-interface/lib/pty-host/manager.js +12 -1
  258. package/neural-interface/lib/remote-policy.js +1 -1
  259. package/neural-interface/lib/request-gate.js +20 -2
  260. package/neural-interface/lib/rulesets/api.js +7 -6
  261. package/neural-interface/lib/rulesets/fs-safe.js +1 -1
  262. package/neural-interface/lib/rulesets/installer.js +180 -36
  263. package/neural-interface/lib/rulesets/json-edit.js +1 -1
  264. package/neural-interface/lib/rulesets/render.js +1 -1
  265. package/neural-interface/lib/session-cache-builder.js +81 -31
  266. package/neural-interface/lib/session-title-generator.js +58 -36
  267. package/neural-interface/lib/skills/api-v2.js +495 -0
  268. package/neural-interface/lib/skills/bundle.js +418 -0
  269. package/neural-interface/lib/skills/catalog.js +298 -0
  270. package/neural-interface/lib/skills/creation-api.js +191 -0
  271. package/neural-interface/lib/skills/creation-brief.js +247 -0
  272. package/neural-interface/lib/skills/creation-sources.js +285 -0
  273. package/neural-interface/lib/skills/creation.js +843 -0
  274. package/neural-interface/lib/skills/deploy.js +569 -0
  275. package/neural-interface/lib/skills/digest.js +119 -0
  276. package/neural-interface/lib/skills/discover.js +111 -0
  277. package/neural-interface/lib/skills/draft-confinement.js +216 -0
  278. package/neural-interface/lib/skills/eval-confinement.js +399 -0
  279. package/neural-interface/lib/skills/eval-sandbox.js +280 -0
  280. package/neural-interface/lib/skills/eval-trace.js +135 -0
  281. package/neural-interface/lib/skills/evals-api.js +212 -0
  282. package/neural-interface/lib/skills/evals.js +1573 -0
  283. package/neural-interface/lib/skills/export.js +203 -0
  284. package/neural-interface/lib/skills/frontmatter.js +64 -0
  285. package/neural-interface/lib/skills/health.js +75 -0
  286. package/neural-interface/lib/skills/json-edit.js +165 -0
  287. package/neural-interface/lib/skills/known-bridge-digests.json +441 -0
  288. package/neural-interface/lib/skills/known-bridges.js +96 -0
  289. package/neural-interface/lib/skills/library.js +823 -0
  290. package/neural-interface/lib/skills/local-store.js +21 -0
  291. package/neural-interface/lib/skills/migration.js +433 -0
  292. package/neural-interface/lib/skills/operations.js +45 -0
  293. package/neural-interface/lib/skills/ownership.js +427 -0
  294. package/neural-interface/lib/skills/packages.js +88 -0
  295. package/neural-interface/lib/skills/reviews.js +212 -0
  296. package/neural-interface/lib/skills/revision.js +80 -0
  297. package/neural-interface/lib/skills/roots.js +269 -0
  298. package/neural-interface/lib/skills/runtime-checks.js +358 -0
  299. package/neural-interface/lib/skills/scan-assets.js +252 -0
  300. package/neural-interface/lib/skills/scan-context.js +26 -0
  301. package/neural-interface/lib/skills/scan-shell.js +324 -0
  302. package/neural-interface/lib/skills/scan.js +364 -0
  303. package/neural-interface/lib/skills/scanners.js +54 -0
  304. package/neural-interface/lib/skills/service.js +530 -0
  305. package/neural-interface/lib/skills/telemetry.js +119 -0
  306. package/neural-interface/lib/sqlite-integrity-worker.js +22 -0
  307. package/neural-interface/lib/synabun-version.js +1 -1
  308. package/neural-interface/lib/system-activity.js +1 -1
  309. package/neural-interface/lib/tool-lists.js +124 -0
  310. package/neural-interface/lib/whatsapp/brain.js +7 -3
  311. package/neural-interface/lib/whatsapp/bridge.js +6 -3
  312. package/neural-interface/lib/whatsapp/cards.js +22 -9
  313. package/neural-interface/lib/whatsapp/config.js +1 -1
  314. package/neural-interface/lib/worker-confinement.js +1268 -0
  315. package/neural-interface/lib/worker-guard-setting.js +56 -0
  316. package/neural-interface/lib/worker-mcp-channel.js +175 -0
  317. package/neural-interface/lib/worker-question.js +74 -0
  318. package/neural-interface/lib/worker-relay-ports.js +227 -0
  319. package/neural-interface/lib/worker-resume.js +238 -0
  320. package/neural-interface/lib/worker-sandbox.js +329 -0
  321. package/neural-interface/package-lock.json +34 -12
  322. package/neural-interface/package.json +3 -2
  323. package/neural-interface/public/index.html +3 -1
  324. package/neural-interface/public/index2d.html +19 -11
  325. package/neural-interface/public/onboarding.html +3 -3
  326. package/neural-interface/public/shared/account-menu.js +8 -5
  327. package/neural-interface/public/shared/agent-runtime-options.js +125 -31
  328. package/neural-interface/public/shared/agy/agy-bypass.js +47 -0
  329. package/neural-interface/public/shared/agy/agy-client.js +266 -0
  330. package/neural-interface/public/shared/agy/agy-commands.js +120 -0
  331. package/neural-interface/public/shared/agy/agy-copy.js +326 -0
  332. package/neural-interface/public/shared/agy/agy-diff.js +161 -0
  333. package/neural-interface/public/shared/agy/agy-events.js +469 -0
  334. package/neural-interface/public/shared/agy/agy-greeting.js +26 -0
  335. package/neural-interface/public/shared/agy/agy-options.js +232 -0
  336. package/neural-interface/public/shared/agy/agy-panel.js +2543 -0
  337. package/neural-interface/public/shared/agy/agy-render.js +392 -0
  338. package/neural-interface/public/shared/agy/agy-setup.js +149 -0
  339. package/neural-interface/public/shared/agy/agy-styles.js +604 -0
  340. package/neural-interface/public/shared/agy/agy-tabs-logic.js +181 -0
  341. package/neural-interface/public/shared/api.js +1527 -1336
  342. package/neural-interface/public/shared/app-frame.js +192 -0
  343. package/neural-interface/public/shared/assistant/asst-agents-dock.js +36 -6
  344. package/neural-interface/public/shared/assistant/asst-api.js +1 -1
  345. package/neural-interface/public/shared/assistant/asst-ask-styles.js +270 -0
  346. package/neural-interface/public/shared/assistant/asst-ask-tail.js +118 -0
  347. package/neural-interface/public/shared/assistant/asst-ask.js +397 -0
  348. package/neural-interface/public/shared/assistant/asst-brain-picker.js +105 -44
  349. package/neural-interface/public/shared/assistant/asst-budget.js +5 -4
  350. package/neural-interface/public/shared/assistant/asst-control.js +205 -26
  351. package/neural-interface/public/shared/assistant/asst-followups-card.js +383 -0
  352. package/neural-interface/public/shared/assistant/asst-followups.js +417 -0
  353. package/neural-interface/public/shared/assistant/asst-hosts.js +16 -7
  354. package/neural-interface/public/shared/assistant/asst-limit-dock.js +45 -0
  355. package/neural-interface/public/shared/assistant/asst-limit-wait.js +327 -0
  356. package/neural-interface/public/shared/assistant/asst-limit.js +168 -0
  357. package/neural-interface/public/shared/assistant/asst-mascot.js +49 -12
  358. package/neural-interface/public/shared/assistant/asst-menu.js +7 -6
  359. package/neural-interface/public/shared/assistant/asst-panel.js +151 -19
  360. package/neural-interface/public/shared/assistant/asst-rack-styles.js +66 -49
  361. package/neural-interface/public/shared/assistant/asst-render.js +445 -82
  362. package/neural-interface/public/shared/assistant/asst-route.js +304 -53
  363. package/neural-interface/public/shared/assistant/asst-routes-editor.js +9 -8
  364. package/neural-interface/public/shared/assistant/asst-scenes.js +56 -1
  365. package/neural-interface/public/shared/assistant/asst-sidepanel.js +117 -10
  366. package/neural-interface/public/shared/assistant/asst-slash.js +17 -9
  367. package/neural-interface/public/shared/assistant/asst-state.js +87 -24
  368. package/neural-interface/public/shared/assistant/asst-stop.js +127 -0
  369. package/neural-interface/public/shared/assistant/asst-styles.js +93 -21
  370. package/neural-interface/public/shared/assistant/asst-tool-kinds.js +190 -23
  371. package/neural-interface/public/shared/assistant/asst-usage.js +2 -1
  372. package/neural-interface/public/shared/automation-context.js +5 -2
  373. package/neural-interface/public/shared/cc-dropdown.js +89 -19
  374. package/neural-interface/public/shared/cdx/cdx-context-menu.js +10 -9
  375. package/neural-interface/public/shared/cdx/cdx-copy.js +16 -0
  376. package/neural-interface/public/shared/cdx/cdx-output-model.js +22 -1
  377. package/neural-interface/public/shared/cdx/cdx-output.js +34 -10
  378. package/neural-interface/public/shared/cdx/cdx-panel.js +59 -151
  379. package/neural-interface/public/shared/cdx/cdx-preview.js +12 -0
  380. package/neural-interface/public/shared/cdx/cdx-protocol.js +39 -11
  381. package/neural-interface/public/shared/cdx/cdx-render.js +57 -38
  382. package/neural-interface/public/shared/cdx/cdx-requests.js +14 -4
  383. package/neural-interface/public/shared/cdx/cdx-skill-hints.js +54 -0
  384. package/neural-interface/public/shared/cdx/cdx-styles.js +15 -3
  385. package/neural-interface/public/shared/cdx/cdx-tabs.js +127 -44
  386. package/neural-interface/public/shared/cdx/cdx-ws.js +0 -1
  387. package/neural-interface/public/shared/cli-install-controller.js +218 -0
  388. package/neural-interface/public/shared/cli-install-view.js +11 -12
  389. package/neural-interface/public/shared/cli-status.js +11 -10
  390. package/neural-interface/public/shared/constants.js +5 -4
  391. package/neural-interface/public/shared/context-menu-areas.js +34 -0
  392. package/neural-interface/public/shared/context-menu-logic.js +243 -0
  393. package/neural-interface/public/shared/context-menu-model.js +367 -0
  394. package/neural-interface/public/shared/context-menu.js +372 -0
  395. package/neural-interface/public/shared/cp/cp-context-menu.js +10 -9
  396. package/neural-interface/public/shared/cp/cp-restore.js +162 -0
  397. package/neural-interface/public/shared/cp/cp-tool-cards.js +10 -3
  398. package/neural-interface/public/shared/crash-notice-view.js +168 -0
  399. package/neural-interface/public/shared/desktop-bridge.js +17 -0
  400. package/neural-interface/public/shared/desktop-titlebar-view.js +12 -0
  401. package/neural-interface/public/shared/desktop-titlebar.js +13 -4
  402. package/neural-interface/public/shared/desktop-update-view.js +21 -0
  403. package/neural-interface/public/shared/editor/editor-panel-logic.js +2 -2
  404. package/neural-interface/public/shared/explorer/fx-api.js +4 -4
  405. package/neural-interface/public/shared/explorer/fx-links.js +3 -3
  406. package/neural-interface/public/shared/explorer/fx-logic.js +1 -1
  407. package/neural-interface/public/shared/explorer/fx-main.js +48 -16
  408. package/neural-interface/public/shared/explorer/fx-tree.js +1 -0
  409. package/neural-interface/public/shared/greeting/greeting-card.js +2 -2
  410. package/neural-interface/public/shared/greeting/greeting-view.js +1 -0
  411. package/neural-interface/public/shared/html-shell.js +30 -15
  412. package/neural-interface/public/shared/i18n.js +2 -0
  413. package/neural-interface/public/shared/ocp-v2/ocp-v2-approvals.js +7 -7
  414. package/neural-interface/public/shared/ocp-v2/ocp-v2-binding.js +4 -4
  415. package/neural-interface/public/shared/ocp-v2/ocp-v2-changes-logic.js +3 -101
  416. package/neural-interface/public/shared/ocp-v2/ocp-v2-childpanel.js +2 -0
  417. package/neural-interface/public/shared/ocp-v2/ocp-v2-compact-button.js +1 -3
  418. package/neural-interface/public/shared/ocp-v2/ocp-v2-composer-logic.js +2 -6
  419. package/neural-interface/public/shared/ocp-v2/ocp-v2-context-menu.js +11 -11
  420. package/neural-interface/public/shared/ocp-v2/ocp-v2-context-model.js +0 -3
  421. package/neural-interface/public/shared/ocp-v2/ocp-v2-events.js +8 -4
  422. package/neural-interface/public/shared/ocp-v2/ocp-v2-manager.js +7 -7
  423. package/neural-interface/public/shared/ocp-v2/ocp-v2-outcome-notifications.js +16 -0
  424. package/neural-interface/public/shared/ocp-v2/ocp-v2-panel.js +74 -259
  425. package/neural-interface/public/shared/ocp-v2/ocp-v2-plan.js +1 -2
  426. package/neural-interface/public/shared/ocp-v2/ocp-v2-projectbar.js +95 -202
  427. package/neural-interface/public/shared/ocp-v2/ocp-v2-rehydrate.js +13 -4
  428. package/neural-interface/public/shared/ocp-v2/ocp-v2-render.js +13 -22
  429. package/neural-interface/public/shared/ocp-v2/ocp-v2-send.js +4 -4
  430. package/neural-interface/public/shared/ocp-v2/ocp-v2-session-actions.js +8 -61
  431. package/neural-interface/public/shared/ocp-v2/ocp-v2-sessions-logic.js +2 -91
  432. package/neural-interface/public/shared/ocp-v2/ocp-v2-slash-hints.js +16 -15
  433. package/neural-interface/public/shared/ocp-v2/ocp-v2-state.js +8 -21
  434. package/neural-interface/public/shared/ocp-v2/ocp-v2-status-logic.js +1 -99
  435. package/neural-interface/public/shared/ocp-v2/ocp-v2-status.js +5 -35
  436. package/neural-interface/public/shared/ocp-v2/ocp-v2-styles.js +17 -21
  437. package/neural-interface/public/shared/ocp-v2/{ocp-v2-profile-inheritance.js → ocp-v2-tools-inheritance.js} +16 -16
  438. package/neural-interface/public/shared/ocp-v2/ocp-v2-ws.js +60 -50
  439. package/neural-interface/public/shared/page-session.js +96 -0
  440. package/neural-interface/public/shared/provider-icons.js +4 -2
  441. package/neural-interface/public/shared/registry.js +5 -3
  442. package/neural-interface/public/shared/retired-2d.js +3 -0
  443. package/neural-interface/public/shared/schedules-view.js +195 -61
  444. package/neural-interface/public/shared/settings/settings-claude-hooks.js +135 -0
  445. package/neural-interface/public/shared/settings/settings-data.js +3 -1
  446. package/neural-interface/public/shared/settings/settings-ia.js +6 -6
  447. package/neural-interface/public/shared/settings/settings-opencode.js +89 -0
  448. package/neural-interface/public/shared/settings/settings-rules.js +2 -2
  449. package/neural-interface/public/shared/settings/settings-skill-folders-pane.js +265 -0
  450. package/neural-interface/public/shared/settings/settings-skill-folders.js +130 -0
  451. package/neural-interface/public/shared/settings/settings-worker-guard.js +72 -0
  452. package/neural-interface/public/shared/showcase-privacy.js +6 -1
  453. package/neural-interface/public/shared/sidepanel-session-status.js +3 -3
  454. package/neural-interface/public/shared/skills/ss-args.js +96 -0
  455. package/neural-interface/public/shared/skills/ss-creation.js +222 -0
  456. package/neural-interface/public/shared/skills/ss-dialog.js +133 -0
  457. package/neural-interface/public/shared/skills/ss-doc.js +173 -0
  458. package/neural-interface/public/shared/skills/ss-eval-adapters.js +269 -0
  459. package/neural-interface/public/shared/skills/ss-eval-grade.js +359 -0
  460. package/neural-interface/public/shared/skills/ss-eval-optimise.js +153 -0
  461. package/neural-interface/public/shared/skills/ss-eval-plan.js +315 -0
  462. package/neural-interface/public/shared/skills/ss-evals.js +417 -0
  463. package/neural-interface/public/shared/skills/ss-form.js +159 -0
  464. package/neural-interface/public/shared/skills/ss-frontmatter.js +376 -0
  465. package/neural-interface/public/shared/skills/ss-ids.js +32 -0
  466. package/neural-interface/public/shared/skills/ss-lint.js +149 -0
  467. package/neural-interface/public/shared/skills/ss-presets.js +117 -0
  468. package/neural-interface/public/shared/skills/ss-profiles.js +513 -0
  469. package/neural-interface/public/shared/skills/ss-resources.js +165 -0
  470. package/neural-interface/public/shared/skills/ss-review-view.js +190 -0
  471. package/neural-interface/public/shared/skills/ss-tabs.js +79 -0
  472. package/neural-interface/public/shared/skills/ss-unicode.js +135 -0
  473. package/neural-interface/public/shared/skills/studio/sx-actions.js +222 -0
  474. package/neural-interface/public/shared/skills/studio/sx-cm.js +101 -0
  475. package/neural-interface/public/shared/skills/studio/sx-create-ai-view.js +749 -0
  476. package/neural-interface/public/shared/skills/studio/sx-create-ai.js +237 -0
  477. package/neural-interface/public/shared/skills/studio/sx-create-view.js +254 -0
  478. package/neural-interface/public/shared/skills/studio/sx-create.js +126 -0
  479. package/neural-interface/public/shared/skills/studio/sx-diff-view.js +43 -0
  480. package/neural-interface/public/shared/skills/studio/sx-diff.js +133 -0
  481. package/neural-interface/public/shared/skills/studio/sx-docs.js +480 -0
  482. package/neural-interface/public/shared/skills/studio/sx-dom.js +230 -0
  483. package/neural-interface/public/shared/skills/studio/sx-edit-view.js +848 -0
  484. package/neural-interface/public/shared/skills/studio/sx-editor-model.js +193 -0
  485. package/neural-interface/public/shared/skills/studio/sx-errors.js +22 -0
  486. package/neural-interface/public/shared/skills/studio/sx-fixes-view.js +359 -0
  487. package/neural-interface/public/shared/skills/studio/sx-fixes.js +327 -0
  488. package/neural-interface/public/shared/skills/studio/sx-geometry.js +82 -0
  489. package/neural-interface/public/shared/skills/studio/sx-import.js +262 -0
  490. package/neural-interface/public/shared/skills/studio/sx-inspector.js +308 -0
  491. package/neural-interface/public/shared/skills/studio/sx-install-flow.js +282 -0
  492. package/neural-interface/public/shared/skills/studio/sx-install.js +313 -0
  493. package/neural-interface/public/shared/skills/studio/sx-library-view.js +748 -0
  494. package/neural-interface/public/shared/skills/studio/sx-library.js +479 -0
  495. package/neural-interface/public/shared/skills/studio/sx-main.js +690 -0
  496. package/neural-interface/public/shared/skills/studio/sx-operations-view.js +98 -0
  497. package/neural-interface/public/shared/skills/studio/sx-operations.js +11 -0
  498. package/neural-interface/public/shared/skills/studio/sx-plan.js +158 -0
  499. package/neural-interface/public/shared/skills/studio/sx-publish-view.js +621 -0
  500. package/neural-interface/public/shared/skills/studio/sx-review-view.js +369 -0
  501. package/neural-interface/public/shared/skills/studio/sx-review.js +148 -0
  502. package/neural-interface/public/shared/skills/studio/sx-scan.js +35 -0
  503. package/neural-interface/public/shared/skills/studio/sx-snippets.js +96 -0
  504. package/neural-interface/public/shared/skills/studio/sx-subject.js +249 -0
  505. package/neural-interface/public/shared/skills/studio/sx-test-view.js +994 -0
  506. package/neural-interface/public/shared/skills/studio/sx-test.js +328 -0
  507. package/neural-interface/public/shared/skills/studio/sx-versions-view.js +241 -0
  508. package/neural-interface/public/shared/skills/studio/sx-workspace-view.js +426 -0
  509. package/neural-interface/public/shared/state.js +1 -1
  510. package/neural-interface/public/shared/streaming-markdown.js +58 -0
  511. package/neural-interface/public/shared/styleguide/sg-panel.js +4 -2
  512. package/neural-interface/public/shared/styles.css +1822 -1756
  513. package/neural-interface/public/shared/synabun-mascot.js +1115 -9
  514. package/neural-interface/public/shared/text-cache.js +29 -0
  515. package/neural-interface/public/shared/tool-list-picker.js +55 -0
  516. package/neural-interface/public/shared/tool-list-storage.js +24 -0
  517. package/neural-interface/public/shared/tool-list-view.js +112 -0
  518. package/neural-interface/public/shared/topright-overflow-logic.js +54 -0
  519. package/neural-interface/public/shared/tour/tour-actor.js +268 -0
  520. package/neural-interface/public/shared/tour/tour-beats.js +336 -0
  521. package/neural-interface/public/shared/tour/tour-engine.js +884 -0
  522. package/neural-interface/public/shared/tour/tour-ink.js +390 -0
  523. package/neural-interface/public/shared/tour/tour-stage.js +440 -0
  524. package/neural-interface/public/shared/tour/tour-state.js +40 -0
  525. package/neural-interface/public/shared/tour/tour-tips.js +99 -0
  526. package/neural-interface/public/shared/tour/tour.css +144 -0
  527. package/neural-interface/public/shared/ui-antigravity-panel.js +19 -0
  528. package/neural-interface/public/shared/ui-assistant.js +2 -0
  529. package/neural-interface/public/shared/ui-automation-studio.js +111 -140
  530. package/neural-interface/public/shared/ui-claude-panel.js +376 -82
  531. package/neural-interface/public/shared/ui-cli-banner.js +23 -167
  532. package/neural-interface/public/shared/ui-command-runner.js +6 -3
  533. package/neural-interface/public/shared/ui-context-menu.js +295 -0
  534. package/neural-interface/public/shared/ui-cost-widget.js +57 -59
  535. package/neural-interface/public/shared/ui-crash-notice.js +187 -0
  536. package/neural-interface/public/shared/ui-detail.js +15 -3
  537. package/neural-interface/public/shared/ui-file-explorer.js +48 -6
  538. package/neural-interface/public/shared/ui-file-links.js +2 -2
  539. package/neural-interface/public/shared/ui-games.js +2 -2
  540. package/neural-interface/public/shared/ui-image-gallery.js +50 -47
  541. package/neural-interface/public/shared/ui-judgments.js +1 -1
  542. package/neural-interface/public/shared/ui-keybinds.js +33 -2
  543. package/neural-interface/public/shared/ui-link.js +3 -3
  544. package/neural-interface/public/shared/ui-menubar.js +10 -20
  545. package/neural-interface/public/shared/ui-native-loop-router-state.js +5 -0
  546. package/neural-interface/public/shared/ui-native-loop-router.js +11 -1
  547. package/neural-interface/public/shared/ui-navbar.js +49 -24
  548. package/neural-interface/public/shared/ui-notifications.js +1 -0
  549. package/neural-interface/public/shared/ui-panels.js +96 -65
  550. package/neural-interface/public/shared/ui-resume.js +9 -7
  551. package/neural-interface/public/shared/ui-schedules-studio.js +546 -431
  552. package/neural-interface/public/shared/ui-scroll-follow.js +16 -5
  553. package/neural-interface/public/shared/ui-sessions.js +27 -15
  554. package/neural-interface/public/shared/ui-settings.js +683 -526
  555. package/neural-interface/public/shared/ui-sidepanel-session-entry.js +9 -2
  556. package/neural-interface/public/shared/ui-sidepanel-sessions.js +4 -4
  557. package/neural-interface/public/shared/ui-sidepanel-state.js +23 -12
  558. package/neural-interface/public/shared/ui-sidepanel-tray.js +48 -7
  559. package/neural-interface/public/shared/ui-sidepanel-windows.js +18 -13
  560. package/neural-interface/public/shared/ui-skills.js +33 -2830
  561. package/neural-interface/public/shared/ui-styleguide.js +5 -2
  562. package/neural-interface/public/shared/ui-sync.js +15 -5
  563. package/neural-interface/public/shared/ui-terminal.js +270 -190
  564. package/neural-interface/public/shared/ui-tool-updates.js +6 -4
  565. package/neural-interface/public/shared/ui-tooltip.js +81 -51
  566. package/neural-interface/public/shared/ui-topright-overflow.js +233 -0
  567. package/neural-interface/public/shared/ui-trash.js +6 -4
  568. package/neural-interface/public/shared/ui-tutorial-layout.js +3 -117
  569. package/neural-interface/public/shared/ui-tutorial-preview.js +103 -0
  570. package/neural-interface/public/shared/ui-tutorial-steps.js +3 -65
  571. package/neural-interface/public/shared/ui-tutorial.css +47 -100
  572. package/neural-interface/public/shared/ui-tutorial.js +285 -509
  573. package/neural-interface/public/shared/ui-update.js +38 -2
  574. package/neural-interface/public/shared/ui-whiteboard.js +312 -59
  575. package/neural-interface/public/shared/ui-worker-end.js +5 -1
  576. package/neural-interface/public/shared/ui-workspaces.js +3 -2
  577. package/neural-interface/public/shared/view-variant.js +66 -0
  578. package/neural-interface/public/shared/whatsapp/wa-view.js +3 -3
  579. package/neural-interface/public/shared/whiteboard-list.js +172 -0
  580. package/neural-interface/public/shared/worker-end.js +10 -3
  581. package/neural-interface/public/shared/worker-questions.js +34 -0
  582. package/neural-interface/public/shared/worker-restart.js +12 -0
  583. package/neural-interface/public/sidepanel-session.html +2 -2
  584. package/neural-interface/public/variant/2d/background.js +2 -1
  585. package/neural-interface/public/variant/2d/context-menu.js +8 -2
  586. package/neural-interface/public/variant/2d/graph.js +42 -20
  587. package/neural-interface/public/variant/2d/hulls.js +14 -9
  588. package/neural-interface/public/variant/2d/lasso.js +11 -7
  589. package/neural-interface/public/variant/2d/main.js +32 -1
  590. package/neural-interface/public/variant/2d/minimap.js +11 -13
  591. package/neural-interface/public/variant/3d/main.js +69 -6
  592. package/neural-interface/public/variant/3d/map-controls.js +24 -9
  593. package/neural-interface/public/vendor/caveat/OFL.txt +93 -0
  594. package/neural-interface/public/vendor/caveat/caveat-latin-400-normal.woff2 +0 -0
  595. package/neural-interface/public/vendor/caveat/caveat-latin-700-normal.woff2 +0 -0
  596. package/neural-interface/public/vendor/caveat/caveat.css +17 -0
  597. package/neural-interface/public/vendor/caveat/manifest.json +12 -0
  598. package/neural-interface/public/vendor/yaml/LICENSE +13 -0
  599. package/neural-interface/public/vendor/yaml/manifest.json +4 -0
  600. package/neural-interface/public/vendor/yaml/yaml-2.9.1.min.js +137 -0
  601. package/neural-interface/scripts/build-vendor.mjs +32 -0
  602. package/neural-interface/server.js +4553 -2855
  603. package/neural-interface/templates/rulesets/README.md +1 -1
  604. package/neural-interface/templates/rulesets/core.md +1 -1
  605. package/neural-interface/templates/rulesets/legacy-hashes.json +23 -5
  606. package/neural-interface/templates/rulesets/manifest.json +8 -8
  607. package/npm-shrinkwrap.json +34 -12
  608. package/package.json +17 -3
  609. package/postinstall.js +9 -4
  610. package/preuninstall.js +1 -1
  611. package/setup.js +97 -322
  612. package/skills/skill-forge/SKILL.md +177 -0
  613. package/skills/skill-forge/evals/evals.json +54 -0
  614. package/skills/skill-forge/references/package.md +105 -0
  615. package/skills/skill-forge/references/review-and-recovery.md +63 -0
  616. package/skills/skill-forge/references/runtime-profiles.md +20 -0
  617. package/skills/skill-forge/references/sources-and-capabilities.md +51 -0
  618. package/skills/synabun/SKILL.md +10 -7
  619. package/skills/synabun/modules/audit.md +1 -5
  620. package/skills/synabun/modules/changelog.md +1 -5
  621. package/skills/synabun/modules/idea.md +1 -1
  622. package/skills/synabun/modules/memorize.md +6 -9
  623. package/skills/synabun/modules/schedule.md +6 -6
  624. package/mcp-server/dist/services/profiles.d.ts +0 -120
  625. package/mcp-server/dist/services/profiles.d.ts.map +0 -1
  626. package/mcp-server/dist/services/profiles.js +0 -387
  627. package/mcp-server/dist/services/profiles.js.map +0 -1
  628. package/mcp-server/dist/tools/leonardo-browser-tools.d.ts +0 -97
  629. package/mcp-server/dist/tools/leonardo-browser-tools.d.ts.map +0 -1
  630. package/mcp-server/dist/tools/leonardo-browser-tools.js +0 -228
  631. package/mcp-server/dist/tools/leonardo-browser-tools.js.map +0 -1
  632. package/mcp-server/dist/tools/leonardo.d.ts +0 -13
  633. package/mcp-server/dist/tools/leonardo.d.ts.map +0 -1
  634. package/mcp-server/dist/tools/leonardo.js +0 -21
  635. package/mcp-server/dist/tools/leonardo.js.map +0 -1
  636. package/mcp-server/dist/tools/profile.d.ts +0 -17
  637. package/mcp-server/dist/tools/profile.d.ts.map +0 -1
  638. package/mcp-server/dist/tools/profile.js +0 -114
  639. package/mcp-server/dist/tools/profile.js.map +0 -1
  640. package/mcp-server/src/services/profiles.ts +0 -428
  641. package/mcp-server/src/tools/leonardo-browser-tools.ts +0 -291
  642. package/mcp-server/src/tools/leonardo.ts +0 -30
  643. package/mcp-server/src/tools/profile.ts +0 -122
  644. package/neural-interface/lib/assistant-brains/opencode-browser-policy.js +0 -47
  645. package/neural-interface/lib/assistant-brains/opencode-route-gate.js +0 -62
  646. package/neural-interface/lib/mcp-profile-servers.js +0 -120
  647. package/neural-interface/public/shared/ui-tutorial-draw.js +0 -311
  648. package/skills/leonardo/SKILL.md +0 -168
  649. package/skills/leonardo/icon.svg +0 -1
  650. package/skills/leonardo/modules/browser-guide.md +0 -378
  651. package/skills/leonardo/modules/image-prompter.md +0 -283
  652. package/skills/leonardo/modules/model-advisor.md +0 -100
  653. package/skills/leonardo/modules/prompt-library.md +0 -110
  654. package/skills/leonardo/modules/style-guide.md +0 -186
  655. package/skills/leonardo/modules/video-prompter.md +0 -317
  656. /package/neural-interface/templates/rulesets/{gemini.md → antigravity.md} +0 -0
@@ -0,0 +1,324 @@
1
+ // Literal shell dataflow only. Tokens are never expanded or executed.
2
+ const runner = /^(?:bash|sh|zsh|dash|ksh|fish|python[23]?|node|perl|ruby|php|lua|pwsh|powershell|deno|bun|osascript|tclsh|Rscript|source|\.)$/;
3
+ // Arity belongs to the wrapper, never to a shared spelling: e.g. sudo -n
4
+ // takes no value, while nice/xargs -n do. Optional values must be attached.
5
+ const options = (value, none) => ({ value: new Set(value.split(' ').filter(Boolean)), none: new Set(none.split(' ').filter(Boolean)) });
6
+ const wrapperOptions = {
7
+ exec: options('-a', '-c -l -f'),
8
+ command: options('', '-p -v -V'),
9
+ env: options('-u --unset -C --chdir -a --argv0 -P -S --split-string', '-i --ignore-environment -0 --null -v --debug --block-signal --default-signal --ignore-signal --list-signal-handling'),
10
+ nohup: options('', '--help --version'),
11
+ timeout: options('-k --kill-after -s --signal', '--foreground --preserve-status -v --verbose'),
12
+ xargs: options('-a --arg-file -d --delimiter -E -I -L -n --max-args -P --max-procs -s --max-chars -J -R -S --process-slot-var', '-0 --null -o --open-tty -p --interactive -r --no-run-if-empty -t --verbose -x --exit -e --eof -i --replace -l --max-lines'),
13
+ nice: options('-n --adjustment', '--help --version'),
14
+ time: options('-o --output -f --format', '-a --append -p --portability -v --verbose -q --quiet -h -l'),
15
+ setsid: options('', '-c --ctty -f --fork -w --wait'),
16
+ sudo: options('-a --auth-type -c --login-class -u --user -g --group -C --close-from -D --chdir -h --host -p --prompt -r --role -t --type -U --other-user -T --command-timeout -R --chroot', '-A --askpass -B --bell -e --edit -v --validate -n --non-interactive -s --shell -k --reset-timestamp -P --preserve-groups -b --background -E --preserve-env -H --set-home -i --login -K --remove-timestamp -l --list -N --no-update -S --stdin -V --version'),
17
+ };
18
+ const wrapper = new RegExp(`^(?:${Object.keys(wrapperOptions).join('|')})$`);
19
+ function optionArgument(w, option) {
20
+ const table = wrapperOptions[w];
21
+ if (option.startsWith('--')) {
22
+ const equals = option.indexOf('='), flag = equals < 0 ? option : option.slice(0, equals);
23
+ return table.value.has(flag) ? { flag, attached: equals < 0 ? null : option.slice(equals + 1) } : null;
24
+ }
25
+ // Walk short clusters until a required value (possibly attached) or unknown
26
+ // option. Unknown arity never consumes the next token: it may be the program.
27
+ for (let i = 1; i < option.length; i++) {
28
+ const flag = `-${option[i]}`;
29
+ if (table.value.has(flag)) return { flag, attached: option.slice(i + 1) || null };
30
+ if (!table.none.has(flag)) return null;
31
+ if (w === 'xargs' && ['-e', '-i', '-l'].includes(flag)) return null;
32
+ }
33
+ return null;
34
+ }
35
+ const media = /\.(?:png|jpe?g|gif|webp|ico|svg|woff2?|ttf|otf|mp[34]|m4[av]|wav|ogg|flac|webm|mov|avi)$/i;
36
+ const key = (p) => p?.replace(/^\.\//, '').replace(/\$\{([A-Za-z_]\w*)\}/g, '\$$1');
37
+ const base = (p) => p?.split('/').at(-1);
38
+ const tokenize = (s) => (s.match(/(?:"[^"\n]*"|'[^'\n]*'|[^\s"'|;&>])+/g) || []).map((s) => s.replace(/["']/g, ''));
39
+ function unwrap(tokens) {
40
+ let t = tokens.slice(), wrapped = false;
41
+ while (/^[A-Za-z_]\w*=/.test(t[0])) t.shift();
42
+ for (let n = 0; n < 12 && wrapper.test(base(t[0])); n++) {
43
+ const w = base(t.shift()); wrapped = true;
44
+ while (t[0]?.startsWith('-') || ['env', 'sudo'].includes(w) && /^[A-Za-z_]\w*=/.test(t[0])) {
45
+ const option = t.shift();
46
+ if (option === '--') break;
47
+ const argument = optionArgument(w, option);
48
+ if (argument) {
49
+ const value = argument.attached ?? t.shift();
50
+ // env's split-string value can itself name the program. Tokenize the
51
+ // literal value only; never perform shell expansion or execution.
52
+ if (w === 'env' && ['-S', '--split-string'].includes(argument.flag)) t.unshift(...tokenize(value || ''));
53
+ }
54
+ }
55
+ if (['env', 'sudo'].includes(w)) while (/^[A-Za-z_]\w*=/.test(t[0])) t.shift();
56
+ if (w === 'timeout') t.shift();
57
+ }
58
+ return { tokens: t, wrapped };
59
+ }
60
+ function commands(file, functions) {
61
+ // A bounded literal function body: calls substitute positional tokens, never eval shell strings.
62
+ const source = /\.(?:md|markdown|mdx)$/i.test(file.path) ? file.text.replace(/`([^`\n]+)`/g, ';$1;') : file.text;
63
+ const text = source.replace(/(?:^|[\n;])\s*(?:function\s+)?([A-Za-z_]\w*)\s*\(\)\s*\{([^{}]*)\}/g, (all, name, body, offset) => {
64
+ functions.set(name, { text: body, file: file.path, line: file.text.slice(0, offset).split('\n').length });
65
+ return all.replace(/[^\n]/g, ' ');
66
+ });
67
+ return { ...file, text };
68
+ }
69
+ export function shellFindings(files) {
70
+ if (!files.some((f) => /\b(?:curl|wget|base64)\b/.test(f.text))) return { hits: [], complete: true };
71
+ const functions = new Map(), prepared = files.map((f) => commands(f, functions));
72
+ const hits = new Map(); let remaining = 100000;
73
+ function walk(file, outputs, collect, depth = 0, written = new Set()) {
74
+ if (depth > 8) { remaining = -1; return; }
75
+ let line = file.line || 1, pipe = null;
76
+ const normalized = file.text.replace(/\\\r?\n/g, '');
77
+ for (const part of normalized.split(/(\n|;|&&|\|\||\|)/)) {
78
+ if (--remaining < 0) return;
79
+ if (part === '\n') { line++; pipe = null; continue; }
80
+ if (/^(?:;|&&|\|\|)$/.test(part)) { pipe = null; continue; }
81
+ if (part === '|' || !part.trim()) continue;
82
+ const raw = part.trim().replace(/^`+|`+$/g, '');
83
+ if (raw.startsWith('#')) continue;
84
+ const { tokens: t, wrapped } = unwrap(tokenize(raw));
85
+ const cmd = base(t[0]); if (!cmd) continue;
86
+ const fn = functions.get(cmd);
87
+ if (fn) {
88
+ const body = fn.text.replace(/\$\{?([1-9])\}?/g, (_, n) => t[Number(n)] || '');
89
+ walk({ ...fn, path: file.path, text: body, line }, outputs, collect, depth + 1, written); continue;
90
+ }
91
+ // A wrapper does not turn a bare PATH command into a relative file path.
92
+ const arg = runner.test(cmd) ? t.slice(1).find((v) => !v.startsWith('-')) : t[0].includes('/') ? t[0] : null;
93
+ const emit = (ruleId) => {
94
+ if (collect) hits.set(`${file.path}:${line}:${ruleId}`, { ruleId, file: file.path, line, evidence: raw });
95
+ };
96
+ if (arg && outputs.has(key(arg))) emit(outputs.get(key(arg)));
97
+ if (runner.test(cmd) && arg && media.test(arg)) emit('S-09-asset-exec');
98
+ const remote = cmd === 'curl' || cmd === 'wget';
99
+ const decode = cmd === 'base64' && t.some((s) => /^(?:-d|-D|--decode)$/.test(s));
100
+ const origin = remote ? 'S-08-remote-file' : decode ? 'S-09-decode-file' : null;
101
+ const redirect = /(?:^|\s)>{1,2}\s*((?:"[^"]*"|'[^']*'|[^\s;|&])+)/.exec(raw);
102
+ let destination = redirect?.[1].replace(/["']/g, '');
103
+ if (remote) {
104
+ for (let i = 1; i < t.length; i++) {
105
+ const long = (cmd === 'curl' ? /^--output(?:=(.*))?$/ : /^--output-document(?:=(.*))?$/).exec(t[i]);
106
+ const short = (cmd === 'curl' ? /^-[a-zA-Z]*?o(.*)$/ : /^-[a-zA-Z]*?O(.*)$/).exec(t[i]);
107
+ if (long || short) destination = (long || short)[1] || t[i + 1];
108
+ }
109
+ }
110
+ if (destination && destination !== '-') {
111
+ written.add(key(destination)); outputs.delete(key(destination));
112
+ if (origin || pipe) outputs.set(key(destination), origin || pipe);
113
+ }
114
+ if (cmd === 'tee') for (const dest of t.slice(1).filter((s) => !s.startsWith('-'))) {
115
+ written.add(key(dest)); outputs.delete(key(dest)); if (pipe) outputs.set(key(dest), pipe);
116
+ }
117
+ if (['cp', 'mv', 'ln', 'install'].includes(cmd)) {
118
+ const args = t.slice(1).filter((s, i, a) => !s.startsWith('-') && !['-m', '-o', '-g', '-t'].includes(a[i - 1]));
119
+ if (args.length >= 2) {
120
+ const source = key(args.at(-2)), dest = key(args.at(-1)), taint = outputs.get(source);
121
+ written.add(dest); outputs.delete(dest); if (taint) outputs.set(dest, taint);
122
+ if (cmd === 'mv') outputs.delete(source);
123
+ }
124
+ }
125
+ if (cmd === 'rm') for (const p of t.slice(1)) outputs.delete(key(p));
126
+ pipe = origin || (cmd === 'tee' ? pipe : null);
127
+ }
128
+ }
129
+ // Files have no reliable execution order. Seed each from the *other* files' final literal outputs,
130
+ // then preserve production/overwrite/removal order within that file. Iterate for cross-file copies.
131
+ let summaries = prepared.map(() => new Map());
132
+ for (let pass = 0; pass <= prepared.length && remaining > 0; pass++) {
133
+ let changed = false;
134
+ const next = prepared.map((file, i) => {
135
+ const seed = new Map(summaries.flatMap((s, j) => j === i ? [] : [...s]));
136
+ const written = new Set(); walk(file, seed, false, 0, written);
137
+ const own = new Map([...seed].filter(([p]) => written.has(p)));
138
+ if (JSON.stringify([...own]) !== JSON.stringify([...summaries[i]])) changed = true;
139
+ return own;
140
+ });
141
+ summaries = next; if (!changed) break;
142
+ }
143
+ for (let i = 0; i < prepared.length && remaining > 0; i++) walk(prepared[i], new Map(summaries.flatMap((s, j) => j === i ? [] : [...s])), true);
144
+ return { hits: [...hits.values()], complete: remaining >= 0 };
145
+ }
146
+
147
+ // A command-shaped printable run in an image/font cannot be treated as passive metadata.
148
+ export function looksLikeShell(text) {
149
+ return /(?:^|\n)\s*#!\s*\/[A-Za-z]|(?:^|[;|&`])\s*(?:(?:[A-Za-z_]\w*=\S+)\s+)*(?:curl|wget|sh|bash|zsh|dash|source|python[23]?|node|perl|ruby|php|lua|pwsh|deno|bun|osascript|tclsh|exec|eval|env|nohup|timeout|sudo|command|xargs|nice|time|setsid|chmod|chown|rm|cp|mv|ln|touch|mkdir|printf|echo|cat|tee|base64|export|unset|alias|read|set|trap)\s+\S|(?:^|[;|&`])\s*(?:\.\s+["']?(?:[\w$~]|\.{0,2}\/)[^\s;|&]*|(?:\.{1,2}\/|\/(?:usr\/bin|bin|tmp)\/)\S+\s+\S)|\$\([^)]*\)/.test(text);
150
+ }
151
+
152
+ const passive = new Set('cp mv ln rm mkdir ls stat file du wc touch shasum sha256sum md5 md5sum open xdg-open qlmanage sips magick convert identify optipng pngcrush cwebp ffmpeg fc-list fc-cache'.split(' '));
153
+ const readers = new Set(['cat', 'head', 'tail', 'xxd']);
154
+ const executableMode = (cmd, raw) => cmd === 'chmod' && /(?:^|\s)(?:[ugoa]*\+[^\s]*x|[0-7]*[1357][0-7]{2})(?:\s|$)/.test(raw)
155
+ || cmd === 'install' && /(?:-m\s*|--mode[=\s]+)0?7[0-7]{2}\b/.test(raw);
156
+ function reviewParts(line) {
157
+ const parts = []; let current = '', quote = null;
158
+ for (let i = 0; i < line.length; i++) {
159
+ const c = line[i];
160
+ if (c === '\\' && quote !== "'") { current += c + (line[++i] || ''); continue; }
161
+ if (quote) { current += c; if (c === quote) quote = null; continue; }
162
+ if (c === '"' || c === "'") { quote = c; current += c; continue; }
163
+ if (c === '$' && line[i + 1] === '{') { const end = line.indexOf('}', i + 2); if (end >= 0) { current += line.slice(i, end + 1); i = end; continue; } }
164
+ if (c === '$' && line[i + 1] === '(') continue;
165
+ if (';|&(){}'.includes(c)) {
166
+ let separator = ';';
167
+ if (c === '|' || c === '&') { separator = c; if (line[i + 1] === c) { separator += c; i++; } }
168
+ parts.push(current, separator); current = '';
169
+ } else current += c;
170
+ }
171
+ parts.push(current); return parts;
172
+ }
173
+
174
+ // Raw-text catch-alls: no token expansion, quoting or command position can hide these
175
+ // capabilities. Vocabulary deliberately avoids English verbs such as plain "fetch"/"run".
176
+ const downloadText = /\b(?:curl|wget|aria2c|iwr|irm|Invoke-WebRequest|Invoke-RestMethod|uudecode)\b|\bgit\s+clone\b|\b(?:fetch|https?)\s+(?:-[\w-]+\s+)*https?:\/\/|\b(?:fetch|urlopen|URI\.open|requests\.(?:get|request)|https?\.get)\s*\(|\b(?:python[23]?|node|ruby|perl)\b[^\n]*(?:get|request)[^\n]*https?:\/\/|\bbase64\b[^\n]*?(?:--decode\b|-[A-Za-z]*[dD][A-Za-z]*\b)|\bopenssl\s+(?:base64|enc)\b[^\n]*?\s-d\b|\bxxd\s+[^\n]*?-r\b/i;
177
+ const runText = /\b(?:bash|sh|zsh|dash|ksh|fish|python[23]?|node|perl|ruby|php|lua|pwsh|powershell|deno|bun|osascript|tclsh|Rscript|npx|eval|Invoke-Expression|iex)\b|\bpnpm\s+dlx\b|\bexec\s+["'`$./\w]|(?:^|[;|&()"'`])\s*(?:(?:env|nohup|command|sudo|exec)\s+(?:-[\w-]+\s+)*)?(?:\.{1,2}\/|\/[\w.-]+\/)[\w./$-]+|\$\{?[A-Za-z_]\w*\}?["']?\s+["'./\w$]|\bchmod\s+[^\n]*?(?:\+\w*x|[0-7]*[1357][0-7]{2})\b|\binstall\s+[^\n]*?(?:-m\s*|--mode[=\s]+)0?7[0-7]{2}\b/i;
178
+ // Unlike interpreter names, "make" is common prose. Require command position
179
+ // in code, or an unfenced command list starting with a known shell program.
180
+ function makeCommand(line) {
181
+ // Consume a command character so an empty start cannot skip a leading brace.
182
+ for (const match of line.matchAll(/(?:^|[;|&(`{])\s*(?:(?:if|then|elif|else|do|while|until|!)\s+)*([^\s;|&(`{])/g)) {
183
+ const { tokens } = unwrap(tokenize(line.slice(match.index + match[0].length - 1)));
184
+ if (/^make(?=[)}`]|$)/.test(tokens[0] || '')) return true;
185
+ }
186
+ return false;
187
+ }
188
+ function makeRun(line, code) {
189
+ if (code) return makeCommand(line);
190
+ if ([...line.matchAll(/`([^`\n]+)`/g)].some((m) => makeCommand(m[1]))) return true;
191
+ return /^\s*(?:curl|wget|base64|echo|printf)\s/.test(line) && makeCommand(line);
192
+ }
193
+ const rawRun = (line, code) => runText.test(line) || makeRun(line, code) || /(?:^|[;|&(`])\s*\.\s+(?:["'$./~]|[a-z_][\w.-]*)/.test(line) || /\bsource\s+(?:["'`$./]|[\w-]+\.[\w.-]+)/.test(line)
194
+ // A substitution in command position runs its result, including $(<file) and
195
+ // $(cat file). Assignment/echo arguments alone do not run the substituted data.
196
+ || /(?:^|[;|&(`])\s*(?:[A-Za-z_]\w*=\S+\s+)*(?:(?:env|nohup|command|sudo|exec)\s+(?:(?:-[\w-]+|[A-Za-z_]\w*=\S+)\s+)*)?["']?\$\(/.test(line)
197
+ || (downloadText.test(line) || /\b(?:cat|head|tail|xxd|tee)\s+[^|]+\|/.test(line)) && !/^\s*\|.*\|\s*$/.test(line) && [...line.matchAll(/\|\s*([\w$./\\-]+)(?=\s|["'`)]|$)/g)].some((m) => !passive.has(base(m[1])) && !readers.has(base(m[1])) && base(m[1]) !== 'tee');
198
+ const assetText = /(?:[\w$~./-]+|\$\{\w+\})\.(?:png|jpe?g|gif|webp|ico|svg|woff2?|ttf|otf|mp[34]|m4[av]|wav|ogg|flac|webm|mov|avi)(?=$|[^\w.-])/i;
199
+ const instruction = /^(?:Use|Run|Fetch|Read|See|Open|Copy|Move|Install|Download|Put|Place|Add|Include|Embed|Display|Save|The|This|A|An)\b\s*/i;
200
+ const article = /^(?:The|This|A|An|the|this|a|an)\b/;
201
+
202
+ function presentationFree(line) {
203
+ // References are data, even when a value happens to contain a program's name.
204
+ return line.replace(/!\[[^\]]*\]\([^)]*\)/g, '')
205
+ .replace(/<\/?[A-Za-z][^>]*>/g, '')
206
+ .replace(/\burl\(\s*(?:"[^"]*"|'[^']*'|[^)]*)\)/gi, '')
207
+ .replace(/(["'][^"'\n]+["']\s*:\s*)(?:"[^"\n]*"|'[^'\n]*')/g, '$1');
208
+ }
209
+ function assetInputs(line) {
210
+ // URLs name remote resources, not local executable asset operands. Mask only
211
+ // known curl/wget output options; preserve uploads, nested programs and later
212
+ // commands, even if they use the very same filename as the output destination.
213
+ return presentationFree(line).replace(/\bhttps?:\/\/[^\s"'`<>()[\]{};|]+/gi, '')
214
+ .replace(/\b(curl|wget)\b[^;|&\n]*/g, (command, program) => command.replace(program === 'curl'
215
+ ? /\s(?:--output(?:=|\s+)|-[A-Za-z]*?o\s*)(?:"[^"\n]*"|'[^'\n]*'|[^\s;|&()<>"']+)/g
216
+ : /\s(?:--output-document(?:=|\s+)|-[A-Za-z]*?O\s*)(?:"[^"\n]*"|'[^'\n]*'|[^\s;|&()<>"']+)/g, (output) => /\$\(|`/.test(output) ? output : ' '))
217
+ .replace(/\d*>{1,2}\s*(?:"[^"\n]*"|'[^'\n]*'|[^\s;|&()<>]+)/g, (output) => /\$\(|`/.test(output) ? output : '')
218
+ .replace(/(?:^|[;|&])\s*(?:echo|printf)\b[^;|&\n]*/g, (command, offset, text) => {
219
+ // Literal presentation remains passive beside another command on this line.
220
+ // Keep executable substitutions and anything handed down a pipe visible.
221
+ if (/\$\(|`/.test(command) || text[offset + command.length] === '|') return command;
222
+ return command.replace(new RegExp(assetText.source, 'gi'), '');
223
+ });
224
+ }
225
+ function assetRun(line, markdown, fenced) {
226
+ // A destination written by a tool is data, not an asset passed in to run.
227
+ const raw = assetInputs(line);
228
+ if (!assetText.test(raw)) return false;
229
+ // Inspect inline code as code; on prose instructions remove only the instruction word.
230
+ const inline = markdown && !fenced ? [...raw.matchAll(/`([^`\n]+)`/g)].map((m) => m[1]) : [];
231
+ const proseLine = raw.trim().replace(/^[-*+]\s+/, '');
232
+ // A real passive command (notably `open`) keeps its quoted filename arguments.
233
+ const proseBody = passive.has(proseLine.match(/^\S+/)?.[0]) ? proseLine : proseLine.replace(instruction, '');
234
+ const candidates = [markdown && !fenced ? proseBody : raw, ...inline];
235
+ for (const [index, candidate] of candidates.entries()) {
236
+ if (!assetText.test(candidate)) continue;
237
+ const prose = markdown && !fenced && index === 0;
238
+ const proseLead = prose && (article.test(raw.trim()) || article.test(candidate.trim()));
239
+ // Raw punctuation exposes nested/quoted bodies, including process substitutions. No
240
+ // shell tokenizer is used: e.g. php "$(cat logo.png)" still names both on this line.
241
+ for (const match of candidate.matchAll(/(?:^|[;|&(){}"'`])\s*(?:(?:if|then|elif|else|do|while|until|!)\s+)*((?:[\w$~./\\-]|\$\{\w+\})+)(?=\s|["'`,()<]|$)/g)) {
242
+ const cmd = base(match[1].replace(/^\\/, ''));
243
+ if (!cmd || media.test(cmd) || ['true', 'false', 'echo', 'printf'].includes(cmd) || passive.has(cmd) || readers.has(cmd)) continue;
244
+ // Quoted arguments of a passive program are still arguments, not new
245
+ // programs. Substitutions/argv expressions retain their raw punctuation.
246
+ if (/^["']/.test(match[0]) && match.index > 0 && !/[([{},;|&]$/.test(candidate.slice(0, match.index).trim())) continue;
247
+ const rest = candidate.slice(match.index + match[0].length).replace(/^["'`]+/, '');
248
+ if (prose && match.index === 0 && /^[A-Z][a-z]+$/.test(cmd) && /^\s+`/.test(rest)) continue;
249
+ if (prose && match.index === 0 && !runner.test(cmd) && !wrapper.test(cmd) && /^[A-Za-z]+$/.test(cmd)
250
+ && (/^(?:image|logo|font|asset|media|icon|picture|illustration)$/i.test(cmd)
251
+ || /^\s+(?:is|are|was|were|lives|contains|shows|belongs|the|an?|to|of)\b/i.test(rest))) continue;
252
+ // An article-led description is prose, but never skip the whole line: code
253
+ // later in that same line must still be inspected. A code-shaped first
254
+ // operand also survives ("The php <(cat logo.png)" is still reviewable).
255
+ if (proseLead && match.index === 0 && (article.test(cmd)
256
+ || !/^\s+(?:[-<$"'`(]|[\w$~./-]+\.(?:png|jpe?g|gif|webp|ico|svg|woff2?|ttf|otf|mp[34]|m4[av]|wav|ogg|flac|webm|mov|avi)\b)/i.test(rest))) continue;
257
+ if (cmd === 'git' && /^\s+(?:add|mv|rm)\b/.test(rest)) continue;
258
+ if (cmd === 'chmod' && !executableMode(cmd, candidate)) continue;
259
+ // The raw line already names an asset. Any remaining command-shaped program
260
+ // is reviewable, even when other operands precede the asset.
261
+ if (runner.test(cmd) || wrapper.test(cmd) || cmd === 'busybox' || executableMode(cmd, candidate)
262
+ || /^\s+\S/.test(rest)
263
+ || /^\s*</.test(rest) || /^\s*$/.test(rest) && /[|>]/.test(candidate)) return true;
264
+ }
265
+ // A reader redirecting into a program is command evidence even if the program is
266
+ // unknown. Plain file output and ordinary cat/head/tail/xxd stay passive.
267
+ if (/\b(?:cat|head|tail|xxd)\b/.test(candidate) && />\s*(?:>\(|\$\()/.test(candidate)) return true;
268
+ }
269
+ return false;
270
+ }
271
+
272
+ // Join continuations while retaining the original first physical line as evidence.
273
+ const fenceMarker = /^\s*(`{3,}|~{3,})/;
274
+ function logicalLines(text, markdown) {
275
+ const result = []; let value = '', first = 1;
276
+ const lines = text.split('\n');
277
+ for (const [index, line] of lines.entries()) {
278
+ // Fence syntax belongs to the physical Markdown line. Neither its info
279
+ // string nor a preceding continuation may absorb the adjacent code line.
280
+ if (markdown && fenceMarker.test(line)) {
281
+ if (first < index + 1) result.push({ text: value, line: first });
282
+ result.push({ text: line.replace(/\r$/, ''), line: index + 1 });
283
+ value = ''; first = index + 2; continue;
284
+ }
285
+ value += line.replace(/\r$/, '');
286
+ if (index < lines.length - 1 && value.endsWith('\\')) { value = value.slice(0, -1); continue; }
287
+ result.push({ text: value, line: first }); value = ''; first = index + 2;
288
+ }
289
+ if (value) result.push({ text: value, line: first });
290
+ return result;
291
+ }
292
+
293
+ export function shellReviewFindings(files) {
294
+ let download = null, run = null;
295
+ const hits = [];
296
+ for (const file of files) {
297
+ const markdown = /\.(?:md|markdown|mdx|txt)$/i.test(file.path);
298
+ let fence = null;
299
+ for (const { text: line, line: lineNo } of logicalLines(file.text, markdown)) {
300
+ // Only the file's own shebang is excluded, not comments, examples or quoted text.
301
+ if (lineNo === 1 && line.startsWith('#!')) continue;
302
+ if (markdown) {
303
+ const marker = fenceMarker.exec(line)?.[1];
304
+ if (marker) { if (!fence) fence = marker; else if (marker[0] === fence[0] && marker.length >= fence.length) fence = null; continue; }
305
+ }
306
+ const location = { file: file.path, line: lineNo, evidence: line.trim() };
307
+ if (!download && downloadText.test(line)) download = location;
308
+ if (!run && rawRun(line, !markdown || !!fence)) run = location;
309
+ if (assetRun(line, markdown, !!fence)) hits.push({ ruleId: 'S-09-asset-exec', ...location });
310
+ // Retain the precise pipe-through-tee evidence from 1.6. It is additional
311
+ // evidence; the two catch-alls above never depend on this command parser.
312
+ const parts = reviewParts(line); let pipedDownload = false;
313
+ for (let i = 0; i < parts.length; i += 2) {
314
+ const raw = parts[i].trim().replace(/^(?:(?:if|then|elif|else|do|while|until|!)\s+)+/, '');
315
+ const { tokens: t } = unwrap(tokenize(raw)), cmd = base(t[0]);
316
+ if (pipedDownload && runner.test(cmd)) hits.push({ ruleId: 'S-08-remote-pipe', ...location });
317
+ pipedDownload = parts[i + 1] === '|' && (/^(?:curl|wget)$/.test(cmd) || pipedDownload);
318
+ }
319
+ }
320
+ }
321
+ if (download && run) hits.push({ ruleId: 'S-08-download-run', file: download.file, line: download.line,
322
+ locations: { download, run }, evidence: `${download.file}:${download.line} ${download.evidence} → ${run.file}:${run.line} ${run.evidence}` });
323
+ return hits;
324
+ }