oh-my-opencode 5.1.29 → 5.1.30

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 (121) hide show
  1. package/README.ja.md +2 -0
  2. package/README.ko.md +2 -0
  3. package/README.md +2 -0
  4. package/README.ru.md +2 -0
  5. package/README.zh-cn.md +2 -0
  6. package/dist/cli/cli-program.d.ts +1 -20
  7. package/dist/cli/index.js +942 -49
  8. package/dist/cli/install-command-options.d.ts +20 -0
  9. package/dist/cli/service-auth/browser.d.ts +3 -0
  10. package/dist/cli/service-auth/cli-keystore.fixture.d.ts +7 -0
  11. package/dist/cli/service-auth/commands.d.ts +8 -0
  12. package/dist/cli/service-auth/device-flow.d.ts +15 -0
  13. package/dist/cli/service-auth/device-keys.d.ts +10 -0
  14. package/dist/cli/service-auth/device-name.d.ts +3 -0
  15. package/dist/cli/service-auth/keystore.d.ts +20 -0
  16. package/dist/cli/service-auth/loopback.d.ts +11 -0
  17. package/dist/cli/service-auth/protocol.d.ts +86 -0
  18. package/dist/cli/service-auth/refresh-child.fixture.d.ts +1 -0
  19. package/dist/cli/service-auth/session.d.ts +17 -0
  20. package/dist/cli/service-auth/terminal-text.d.ts +1 -0
  21. package/dist/cli/service-auth/test-support.d.ts +43 -0
  22. package/dist/cli/service-auth/tls-test-certificate.d.ts +4 -0
  23. package/dist/cli-node/index.js +942 -49
  24. package/dist/features/opencode-skill-loader/opencode-shell-skill-content.d.ts +8 -0
  25. package/dist/features/opencode-skill-loader/skill-content.d.ts +1 -0
  26. package/dist/hooks/non-interactive-env/non-interactive-env-hook.d.ts +5 -1
  27. package/dist/index.js +40660 -40393
  28. package/dist/shared/disabled-agents.d.ts +1 -0
  29. package/dist/shared/opencode-shell.d.ts +27 -0
  30. package/dist/skills/browser/SKILL.md +1 -1
  31. package/dist/skills/browser/runtime/omowright/manifest.json +1 -1
  32. package/dist/skills/ultimate-browsing/SKILL.md +14 -16
  33. package/dist/skills/ulw-research/SKILL.md +17 -18
  34. package/dist/skills/ulw-research/scripts/cli-support.test.ts +5 -3
  35. package/dist/skills/ulw-research/scripts/outcome.test.ts +10 -4
  36. package/dist/skills/ulw-research/scripts/report-tools.test.ts +3 -2
  37. package/dist/skills/visual-qa/scripts/cli.test.ts +5 -3
  38. package/dist/tools/session-manager/sdk-storage.d.ts +15 -2
  39. package/dist/tools/session-manager/storage.d.ts +4 -2
  40. package/dist/tui.js +85 -19
  41. package/package.json +15 -14
  42. package/packages/git-bash-mcp/dist/cli.js +1 -1
  43. package/packages/lsp-core/src/lsp/client-diagnostics-freshness.integration.test.ts +90 -0
  44. package/packages/lsp-core/src/lsp/client.ts +3 -1
  45. package/packages/lsp-core/src/lsp/workspace-apply-edit-test-support.ts +5 -2
  46. package/packages/lsp-daemon/dist/cli.js +1 -1
  47. package/packages/lsp-daemon/dist/client.js +1 -1
  48. package/packages/lsp-daemon/dist/index.js +1 -1
  49. package/packages/lsp-tools-mcp/dist/cli.js +1 -1
  50. package/packages/lsp-tools-mcp/dist/lsp/manager.js +1 -1
  51. package/packages/lsp-tools-mcp/dist/mcp.js +1 -1
  52. package/packages/lsp-tools-mcp/dist/tools.js +1 -1
  53. package/packages/omo-codex/plugin/.codex-plugin/plugin.json +1 -1
  54. package/packages/omo-codex/plugin/components/bootstrap/dist/cli.js +3 -2
  55. package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.json +1 -1
  56. package/packages/omo-codex/plugin/components/bootstrap/package.json +1 -1
  57. package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +1 -1
  58. package/packages/omo-codex/plugin/components/comment-checker/package.json +1 -1
  59. package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json +2 -2
  60. package/packages/omo-codex/plugin/components/git-bash/package.json +1 -1
  61. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json +1 -1
  62. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json +1 -1
  63. package/packages/omo-codex/plugin/components/lsp/dist/.omo-runtime-manifest.json +3 -3
  64. package/packages/omo-codex/plugin/components/lsp/dist/cli.js +1 -1
  65. package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +2 -2
  66. package/packages/omo-codex/plugin/components/lsp/package.json +1 -1
  67. package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +4 -4
  68. package/packages/omo-codex/plugin/components/rules/package.json +1 -1
  69. package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json +1 -1
  70. package/packages/omo-codex/plugin/components/teammode/package.json +1 -1
  71. package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +1 -1
  72. package/packages/omo-codex/plugin/components/telemetry/package.json +1 -1
  73. package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +1 -1
  74. package/packages/omo-codex/plugin/components/ultrawork/package.json +1 -1
  75. package/packages/omo-codex/plugin/components/ulw-execute-continuation/hooks/hooks.json +1 -1
  76. package/packages/omo-codex/plugin/components/ulw-execute-continuation/package.json +1 -1
  77. package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +5 -5
  78. package/packages/omo-codex/plugin/components/ulw-loop/package.json +1 -1
  79. package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json +1 -1
  80. package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json +1 -1
  81. package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json +1 -1
  82. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json +1 -1
  83. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json +1 -1
  84. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json +1 -1
  85. package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json +1 -1
  86. package/packages/omo-codex/plugin/hooks/post-tool-use-recording-spawn-admission.json +1 -1
  87. package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json +1 -1
  88. package/packages/omo-codex/plugin/hooks/pre-tool-use-guarding-ulw-loop-spawns.json +1 -1
  89. package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json +1 -1
  90. package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json +1 -1
  91. package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json +1 -1
  92. package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json +1 -1
  93. package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json +1 -1
  94. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-execute-continuation.json +1 -1
  95. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-loop-resume.json +1 -1
  96. package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json +1 -1
  97. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ultrawork-trigger.json +1 -1
  98. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ulw-loop-steering.json +1 -1
  99. package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json +1 -1
  100. package/packages/omo-codex/plugin/package-lock.json +12 -12
  101. package/packages/omo-codex/plugin/package.json +1 -1
  102. package/packages/omo-codex/plugin/scripts/auto-update-plan.mjs +2 -0
  103. package/packages/omo-codex/plugin/scripts/auto-update.mjs +2 -0
  104. package/packages/omo-codex/plugin/scripts/build-bundled-mcp-runtimes.mjs +2 -0
  105. package/packages/omo-codex/plugin/scripts/build-components.mjs +1 -0
  106. package/packages/omo-codex/plugin/scripts/materialize-shared-upstreams.mjs +42 -10
  107. package/packages/omo-codex/plugin/skills/browser/SKILL.md +1 -1
  108. package/packages/omo-codex/plugin/skills/browser/runtime/omowright/manifest.json +1 -1
  109. package/packages/omo-codex/plugin/skills/ultimate-browsing/SKILL.md +14 -16
  110. package/packages/omo-codex/plugin/skills/ulw-research/SKILL.md +17 -18
  111. package/packages/omo-codex/plugin/test/materialize-shared-upstreams.test.mjs +179 -0
  112. package/packages/omo-codex/plugin/test/windows-console-hide.test.mjs +150 -0
  113. package/packages/omo-codex/scripts/install-dist/install-local.mjs +7 -4
  114. package/packages/shared-skills/skills/browser/SKILL.md +1 -1
  115. package/packages/shared-skills/skills/browser/runtime/omowright/manifest.json +1 -1
  116. package/packages/shared-skills/skills/ultimate-browsing/SKILL.md +14 -16
  117. package/packages/shared-skills/skills/ulw-research/SKILL.md +17 -18
  118. package/packages/shared-skills/skills/ulw-research/scripts/cli-support.test.ts +5 -3
  119. package/packages/shared-skills/skills/ulw-research/scripts/outcome.test.ts +10 -4
  120. package/packages/shared-skills/skills/ulw-research/scripts/report-tools.test.ts +3 -2
  121. package/packages/shared-skills/skills/visual-qa/scripts/cli.test.ts +5 -3
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook pre-tool-use",
9
9
  "timeout": 5,
10
- "statusMessage": "(OmO 5.1.29) Enforcing Unlimited Goal Budget",
10
+ "statusMessage": "(OmO 5.1.30) Enforcing Unlimited Goal Budget",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook pre-tool-use"
12
12
  }
13
13
  ],
@@ -8,7 +8,7 @@
8
8
  "type": "command",
9
9
  "command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook pre-tool-use-spawn",
10
10
  "timeout": 5,
11
- "statusMessage": "(OmO 5.1.29) Guarding Ulw-Loop Spawns",
11
+ "statusMessage": "(OmO 5.1.30) Guarding Ulw-Loop Spawns",
12
12
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook pre-tool-use-spawn"
13
13
  }
14
14
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/git-bash/dist/cli.js\" hook pre-tool-use",
9
9
  "timeout": 5,
10
- "statusMessage": "(OmO 5.1.29) Recommending Git Bash MCP",
10
+ "statusMessage": "(OmO 5.1.30) Recommending Git Bash MCP",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\git-bash\\dist\\cli.js\" hook pre-tool-use"
12
12
  }
13
13
  ],
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/scripts/auto-update.mjs\" hook session-start",
9
9
  "timeout": 15,
10
- "statusMessage": "(OmO 5.1.29) Checking Auto Update",
10
+ "statusMessage": "(OmO 5.1.30) Checking Auto Update",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\scripts\\auto-update.mjs\" hook session-start"
12
12
  }
13
13
  ],
@@ -8,7 +8,7 @@
8
8
  "command": "node \"${PLUGIN_ROOT}/components/bootstrap/dist/cli.js\" hook session-start",
9
9
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\bootstrap.ps1\"",
10
10
  "timeout": 30,
11
- "statusMessage": "(OmO 5.1.29) Checking Bootstrap Provisioning"
11
+ "statusMessage": "(OmO 5.1.30) Checking Bootstrap Provisioning"
12
12
  }
13
13
  ]
14
14
  }
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook session-start",
9
9
  "timeout": 10,
10
- "statusMessage": "(OmO 5.1.29) Loading Project Rules",
10
+ "statusMessage": "(OmO 5.1.30) Loading Project Rules",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\rules\\dist\\cli.js\" hook session-start"
12
12
  }
13
13
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/telemetry/dist/cli.js\" hook session-start",
9
9
  "timeout": 15,
10
- "statusMessage": "(OmO 5.1.29) Recording Session Telemetry",
10
+ "statusMessage": "(OmO 5.1.30) Recording Session Telemetry",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\telemetry\\dist\\cli.js\" hook session-start"
12
12
  }
13
13
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/ulw-execute-continuation/dist/cli.js\" hook stop",
9
9
  "timeout": 10,
10
- "statusMessage": "(OmO 5.1.29) Checking Ulw-Execute Continuation",
10
+ "statusMessage": "(OmO 5.1.30) Checking Ulw-Execute Continuation",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-execute-continuation\\dist\\cli.js\" hook stop"
12
12
  }
13
13
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook stop",
9
9
  "timeout": 10,
10
- "statusMessage": "(OmO 5.1.29) Checking Ulw-Loop Resume",
10
+ "statusMessage": "(OmO 5.1.30) Checking Ulw-Loop Resume",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook stop"
12
12
  }
13
13
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/lazycodex-executor-verify/dist/cli.js\" hook subagent-stop",
9
9
  "timeout": 10,
10
- "statusMessage": "(OmO 5.1.29) Verifying LazyCodex Executor Evidence",
10
+ "statusMessage": "(OmO 5.1.30) Verifying LazyCodex Executor Evidence",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\lazycodex-executor-verify\\dist\\cli.js\" hook subagent-stop"
12
12
  }
13
13
  ],
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/ultrawork/dist/cli.js\" hook user-prompt-submit",
9
9
  "timeout": 5,
10
- "statusMessage": "(OmO 5.1.29) Checking Ultrawork Trigger",
10
+ "statusMessage": "(OmO 5.1.30) Checking Ultrawork Trigger",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ultrawork\\dist\\cli.js\" hook user-prompt-submit"
12
12
  }
13
13
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook user-prompt-submit",
9
9
  "timeout": 10,
10
- "statusMessage": "(OmO 5.1.29) Checking Ulw-Loop Steering",
10
+ "statusMessage": "(OmO 5.1.30) Checking Ulw-Loop Steering",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook user-prompt-submit"
12
12
  }
13
13
  ]
@@ -7,7 +7,7 @@
7
7
  "type": "command",
8
8
  "command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook user-prompt-submit",
9
9
  "timeout": 10,
10
- "statusMessage": "(OmO 5.1.29) Loading Project Rules",
10
+ "statusMessage": "(OmO 5.1.30) Loading Project Rules",
11
11
  "commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\rules\\dist\\cli.js\" hook user-prompt-submit"
12
12
  }
13
13
  ]
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@sisyphuslabs/omo-codex-plugin",
3
- "version": "5.1.29",
3
+ "version": "5.1.30",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@sisyphuslabs/omo-codex-plugin",
9
- "version": "5.1.29",
9
+ "version": "5.1.30",
10
10
  "workspaces": [
11
11
  "components/comment-checker",
12
12
  "components/git-bash",
@@ -95,7 +95,7 @@
95
95
  },
96
96
  "components/comment-checker": {
97
97
  "name": "@code-yeongyu/codex-comment-checker",
98
- "version": "5.1.29",
98
+ "version": "5.1.30",
99
99
  "license": "MIT",
100
100
  "bin": {
101
101
  "omo-comment-checker": "dist/cli.js"
@@ -117,7 +117,7 @@
117
117
  },
118
118
  "components/git-bash": {
119
119
  "name": "@sisyphuslabs/codex-git-bash-hook",
120
- "version": "5.1.29",
120
+ "version": "5.1.30",
121
121
  "bin": {
122
122
  "omo-git-bash-hook": "dist/cli.js"
123
123
  },
@@ -131,7 +131,7 @@
131
131
  },
132
132
  "components/lazycodex-executor-verify": {
133
133
  "name": "@code-yeongyu/codex-lazycodex-executor-verify",
134
- "version": "5.1.29",
134
+ "version": "5.1.30",
135
135
  "license": "MIT",
136
136
  "bin": {
137
137
  "lazycodex-executor-verify": "dist/cli.js"
@@ -149,7 +149,7 @@
149
149
  },
150
150
  "components/lsp": {
151
151
  "name": "@code-yeongyu/codex-lsp",
152
- "version": "5.1.29",
152
+ "version": "5.1.30",
153
153
  "license": "MIT",
154
154
  "dependencies": {
155
155
  "@code-yeongyu/lsp-daemon": "file:../../../../lsp-daemon",
@@ -171,7 +171,7 @@
171
171
  },
172
172
  "components/rules": {
173
173
  "name": "@code-yeongyu/codex-rules",
174
- "version": "5.1.29",
174
+ "version": "5.1.30",
175
175
  "license": "MIT",
176
176
  "dependencies": {
177
177
  "picomatch": "^4.0.7"
@@ -194,7 +194,7 @@
194
194
  },
195
195
  "components/teammode": {
196
196
  "name": "@sisyphuslabs/codex-teammode",
197
- "version": "5.1.29",
197
+ "version": "5.1.30",
198
198
  "devDependencies": {
199
199
  "@types/node": "^26.6.2",
200
200
  "@vitest/coverage-v8": "5.0.1",
@@ -208,7 +208,7 @@
208
208
  },
209
209
  "components/telemetry": {
210
210
  "name": "@code-yeongyu/codex-telemetry",
211
- "version": "5.1.29",
211
+ "version": "5.1.30",
212
212
  "license": "MIT",
213
213
  "bin": {
214
214
  "omo-telemetry": "dist/cli.js"
@@ -227,7 +227,7 @@
227
227
  },
228
228
  "components/ultrawork": {
229
229
  "name": "@code-yeongyu/codex-ultrawork",
230
- "version": "5.1.29",
230
+ "version": "5.1.30",
231
231
  "license": "MIT",
232
232
  "bin": {
233
233
  "omo-ultrawork": "dist/cli.js"
@@ -246,7 +246,7 @@
246
246
  },
247
247
  "components/ulw-execute-continuation": {
248
248
  "name": "@code-yeongyu/codex-ulw-execute-continuation",
249
- "version": "5.1.29",
249
+ "version": "5.1.30",
250
250
  "license": "MIT",
251
251
  "bin": {
252
252
  "omo-ulw-execute-continuation": "dist/cli.js"
@@ -264,7 +264,7 @@
264
264
  },
265
265
  "components/ulw-loop": {
266
266
  "name": "@code-yeongyu/codex-ulw-loop",
267
- "version": "5.1.29",
267
+ "version": "5.1.30",
268
268
  "license": "MIT",
269
269
  "bin": {
270
270
  "omo-ulw-loop": "dist/cli.js",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sisyphuslabs/omo-codex-plugin",
3
- "version": "5.1.29",
3
+ "version": "5.1.30",
4
4
  "description": "Aggregate Codex plugin root for OMO components.",
5
5
  "type": "module",
6
6
  "packageManager": "npm@11.12.1",
@@ -83,6 +83,7 @@ export function resolveLatestVersion(env) {
83
83
  encoding: "utf8",
84
84
  stdio: ["ignore", "pipe", "ignore"],
85
85
  timeout,
86
+ windowsHide: true,
86
87
  });
87
88
  if (result.status !== 0) return undefined;
88
89
  const version = result.stdout.trim();
@@ -96,6 +97,7 @@ export function defaultRunCommandForManualUpdate(command, args, options) {
96
97
  cwd: options.cwd,
97
98
  env: options.env,
98
99
  stdio: "inherit",
100
+ windowsHide: true,
99
101
  });
100
102
  child.once("error", reject);
101
103
  child.once("close", (code) => {
@@ -224,6 +224,7 @@ export async function runAutoUpdateCheck({
224
224
  const result = spawnSync(invocation.command, invocation.args, {
225
225
  env: plan.env,
226
226
  stdio: "ignore",
227
+ windowsHide: true,
227
228
  });
228
229
  const status = result.status ?? (result.error === undefined ? 0 : 1);
229
230
  await appendUpdateLog(env, now, "finished", { status });
@@ -241,6 +242,7 @@ export async function runAutoUpdateCheck({
241
242
  env: plan.env,
242
243
  stdio: "ignore",
243
244
  detached: true,
245
+ windowsHide: true,
244
246
  });
245
247
  await writeState(statePath, { lastAttemptedAt: now, lastStatus: "started", pendingNotice });
246
248
  await recordUpdateStartedNotice({ env, now, notices, pendingNotice, releaseNotes, plan });
@@ -46,6 +46,7 @@ function buildRuntime(runtime) {
46
46
  cwd: runtime.packageRoot,
47
47
  shell: process.platform === "win32",
48
48
  stdio: "inherit",
49
+ windowsHide: true,
49
50
  });
50
51
  if (install.error !== undefined) throw install.error;
51
52
  if (install.status !== 0) process.exit(install.status ?? 1);
@@ -55,6 +56,7 @@ function buildRuntime(runtime) {
55
56
  cwd: runtime.packageRoot,
56
57
  shell: process.platform === "win32",
57
58
  stdio: "inherit",
59
+ windowsHide: true,
58
60
  });
59
61
  if (result.error !== undefined) throw result.error;
60
62
  if (result.status !== 0) process.exit(result.status ?? 1);
@@ -104,6 +104,7 @@ function runCaptured(command, args, cwd, label) {
104
104
  cwd,
105
105
  shell: process.platform === "win32",
106
106
  stdio: ["ignore", "pipe", "pipe"],
107
+ windowsHide: true,
107
108
  });
108
109
  const chunks = [];
109
110
  child.stdout.on("data", (chunk) => chunks.push(chunk));
@@ -1,5 +1,6 @@
1
1
  import { execFileSync } from "node:child_process";
2
2
  import { dirname, join } from "node:path";
3
+ import { setTimeout as sleep } from "node:timers/promises";
3
4
  import { fileURLToPath, pathToFileURL } from "node:url";
4
5
 
5
6
  import { isCliEntry } from "./entry-guard.mjs";
@@ -18,23 +19,54 @@ const upstreamPaths = [
18
19
  "packages/shared-skills/upstreams/designpowers",
19
20
  ];
20
21
 
21
- function initSubmodules({ strict }) {
22
+ function describePinnedSubmodules() {
23
+ const pins = new Map();
22
24
  try {
23
- execFileSync("git", ["submodule", "update", "--init", "--recursive", ...upstreamPaths], {
25
+ // The index is the source of the gitlinks used by submodule update, not a
26
+ // remote branch or the (possibly missing) submodule working directory.
27
+ const entries = execFileSync("git", ["ls-files", "--stage", "-z", "--", ...upstreamPaths], {
24
28
  cwd: repoRoot,
25
- stdio: "inherit",
29
+ encoding: "utf8",
30
+ stdio: ["ignore", "pipe", "pipe"],
31
+ windowsHide: true,
26
32
  });
27
- return true;
28
- } catch (error) {
29
- const message = `[materialize-shared-upstreams] git submodule init failed: ${error instanceof Error ? error.message : String(error)}`;
30
- if (strict) throw new Error(message);
31
- process.stderr.write(`${message} - continuing without submodule refresh\n`);
32
- return false;
33
+ for (const entry of entries.split("\0")) {
34
+ const match = /^160000 ([0-9a-f]{40,64}) 0\t(.+)$/.exec(entry);
35
+ if (match) pins.set(match[2], match[1]);
36
+ }
37
+ } catch {
38
+ // A diagnostic failure must not replace the original fetch error.
39
+ }
40
+ return upstreamPaths.map((path) => `${path}@${pins.get(path) ?? "unknown (pinned SHA unavailable)"}`).join(", ");
41
+ }
42
+
43
+ async function initSubmodules({ strict }) {
44
+ const maxAttempts = 3;
45
+ for (let attempt = 1; attempt <= maxAttempts; attempt++) {
46
+ try {
47
+ execFileSync("git", ["submodule", "update", "--init", "--recursive", ...upstreamPaths], {
48
+ cwd: repoRoot,
49
+ stdio: "inherit",
50
+ windowsHide: true,
51
+ });
52
+ return true;
53
+ } catch (error) {
54
+ if (attempt < maxAttempts) {
55
+ const delayMs = 1000 * 2 ** (attempt - 1);
56
+ process.stderr.write(`[materialize-shared-upstreams] git submodule init failed (attempt ${attempt}/${maxAttempts}); retrying in ${delayMs}ms\n`);
57
+ await sleep(delayMs);
58
+ continue;
59
+ }
60
+ const message = `[materialize-shared-upstreams] git submodule init failed after ${maxAttempts} attempts: ${error instanceof Error ? error.message : String(error)}; pinned submodules: ${describePinnedSubmodules()}`;
61
+ if (strict) throw new Error(message, { cause: error });
62
+ process.stderr.write(`${message} - continuing without submodule refresh\n`);
63
+ return false;
64
+ }
33
65
  }
34
66
  }
35
67
 
36
68
  export async function materializeSharedUpstreams({ strict }) {
37
- initSubmodules({ strict });
69
+ await initSubmodules({ strict });
38
70
  const { materializeFrontendRefs } = await import(pathToFileURL(materializeScript).href);
39
71
  const result = await materializeFrontendRefs({ strict });
40
72
  const { stageOmowrightRuntime } = await import(pathToFileURL(stageOmowrightScript).href);
@@ -11,7 +11,7 @@ One library, two engines. omowright ships inside this skill; choose the engine b
11
11
  |---|---|---|
12
12
  | A site the user is signed into, their open tabs, a form, a click-through, a screenshot, web QA, an extension popup | **attached** — the user's own browser through BrowserSkill | `connectBrowserSkill()` |
13
13
  | A throwaway profile, bot-scoring evasion, a CAPTCHA, network interception, a QA flight trace, coordinate control, headless runs | **owned** — a browser your code launches | `connectPipe()` / `connectCloakProfile()` — [references/owned-engine/README.md](references/owned-engine/README.md) |
14
- | Text out of a URL, a 403 bypass, a platform that blocks fetchers | neither | the `ultimate-browsing` skill |
14
+ | A 403/WAF host the attached engine cannot open, a platform with a native reader, an archive snapshot | neither | the `ultimate-browsing` skill |
15
15
 
16
16
  **Attached is the default,** because it is the only engine carrying the user's logins and the only
17
17
  one where a human is a single call away. Never substitute one engine for the other silently: if
@@ -5,5 +5,5 @@
5
5
  "index.js": "b6b064fab277031c6c51f5a58b84b31040f9960bf767bf646adc0540c1d25c1b",
6
6
  "page-bundle.js": "bfd51e8383cf47200d57387bbbed258bce5a3a3d00c38fc108034d2888e23f0c"
7
7
  },
8
- "stagedAtUtc": "2026-10-09T17:46:21.855Z"
8
+ "stagedAtUtc": "2026-10-11T14:43:14.044Z"
9
9
  }
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  name: ultimate-browsing
3
- description: "Renders, drives, and screenshots web pages: JS-rendered sources, clicks and forms, persistent logins, WAF-blocked hosts (platform-native readers, stealth Chrome), and the browsing lane of a research run, with screenshots as provenance. Not for plain search or unblocked static fetch."
3
+ description: "Reaches web pages the user's browser cannot open: WAF-blocked and bot-scored hosts, platform-native readers (Chinese and social platforms), archive snapshots with provenance, and a browser you own for stealth or throwaway profiles. Not for plain search, an unblocked static fetch, or a page the user's browser can open."
4
4
  ---
5
5
 
6
6
  # Ultimate Browsing
7
7
 
8
- Web access for everything a plain fetch cannot finish: a page that renders in JS, a click or a form, a screenshot, a login that must persist across pages, or a host that blocks generic fetchers (WAF / 403 / Cloudflare). Start at the cheapest tier that can do the job and climb only when it cannot:
8
+ Web access for the hosts the user's browser cannot open (WAF / 403 / Cloudflare / bot-scored pages) and for platforms with a native reader. Reading and interaction on a page the user's browser can open belong to the `browser` skill's attached engine, not here. Start at the cheapest tier that can reach the blocked host and climb only when it cannot:
9
9
 
10
10
  **Tier 1 — insane-search** (headless extraction + WAF bypass) -> **Tier 1.5 — agent-reach** (platform-native APIs, esp. Chinese platforms) -> **Tier 2 — a real browser** through omowright from js eval: 2a the owned engine (a browser your code launches, CloakBrowser for stealth), 2b the attached engine (the user's own signed-in browser).
11
11
 
@@ -14,29 +14,27 @@ Web access for everything a plain fetch cannot finish: a page that renders in JS
14
14
  ```
15
15
  User request
16
16
  |
17
- +- extract text/data from a URL --------------------- TIER 1 insane-search
17
+ +- a page the user's browser can open (read, click, screenshot, QA, login) NOT this skill (browser skill, attached engine)
18
+ +- simple search query ------------------------------ NOT this skill (use web-search)
19
+ |
18
20
  +- URL blocked / 403 / Cloudflare / WAF ------------- TIER 1 insane-search
19
21
  +- YouTube/Vimeo/TikTok subtitles or metadata ------- TIER 1 insane-search (yt-dlp)
20
- +- read an article / blog / Reddit / HN / arXiv ----- TIER 1 insane-search
22
+ +- archive snapshot of a dead or changed page ------- TIER 1 insane-search (surrogates, provenance-tagged)
21
23
  |
22
24
  +- Chinese platform (xhs/douyin/weibo/bilibili/v2ex/wechat) TIER 1.5 agent-reach
23
25
  +- podcast transcript / stock forum ----------------- TIER 1.5 agent-reach
24
26
  +- Twitter feed / LinkedIn profile / GitHub via CLI - TIER 1.5 agent-reach
25
27
  |
26
- +- Tier 1/1.5 returned empty or partial ------------- TIER 2 2a owned engine -> 2b attached engine
27
- +- click / fill form / scroll / interact ------------ TIER 2 2a owned engine -> 2b attached engine
28
- +- screenshot / render / play video ----------------- TIER 2 2a owned engine -> 2b attached engine
29
- +- login session across pages / the user's account --- TIER 2 2b attached engine (their browser)
30
- +- test web app / QA / dogfood ---------------------- TIER 2 2a owned engine -> 2b attached engine
31
- |
32
- +- simple search query ------------------------------ NOT this skill (use web-search)
28
+ +- Tier 1/1.5 returned empty or partial ------------- TIER 2 2a owned engine (stealth)
29
+ +- a blocked host that also needs a click, a scroll or a screenshot TIER 2 2a owned engine
30
+ +- the user's account on a host the owned engine cannot pass TIER 2 2b attached engine (their browser)
33
31
  ```
34
32
 
35
33
  Read the matching reference before acting: [`references/insane-search/README.md`](references/insane-search/README.md), [`references/agent-reach/README.md`](references/agent-reach/README.md), or [`references/chrome-stealth.md`](references/chrome-stealth.md).
36
34
 
37
35
  ## Tier 1 — insane-search (headless extraction)
38
36
 
39
- **When**: content extraction, blocked-URL bypass, media metadata — no browser UI needed.
37
+ **When**: blocked-URL bypass, media metadata, archive surrogates — no browser UI needed.
40
38
  **Why first**: ~10x faster than a browser, no process spin-up; handles most "fetch this blocked page" requests via curl_cffi TLS impersonation, yt-dlp (1858 sites), official public APIs, mobile URL transforms, **Phase-2.5 surrogate archives** (Wayback / archive.today snapshots, provenance-tagged — see [`references/insane-search/cache-archive.md`](references/insane-search/cache-archive.md)), a key-gated Jina Reader (`JINA_API_KEY`), and a Playwright real-Chrome fallback. The engine lives **inside this skill** at `engine/` and is invoked as a module. Surrogate results are dated COPIES: a result whose `provenance` is `snapshot` must be reported with its `snapshot_timestamp`, never presented as the live page.
41
39
 
42
40
  ```bash
@@ -56,7 +54,7 @@ The full engine harness (rules R1-R7, the Phase 0 official-API index, the no-sit
56
54
 
57
55
  ### Escalate to Tier 1.5 or Tier 2 when
58
56
  - The target is a Chinese / social platform with a native reader -> Tier 1.5.
59
- - insane-search returns empty/partial, or the page needs JS interaction, a screenshot, a persistent login, or media playback -> Tier 2.
57
+ - insane-search returns empty/partial, or the blocked page needs JS interaction, a screenshot, or media playback -> Tier 2.
60
58
 
61
59
  ## Tier 1.5 — agent-reach (platform-native readers)
62
60
 
@@ -82,7 +80,7 @@ Routing table, per-platform auth (set `TWITTER_*` env vars, `gh auth login`, a t
82
80
 
83
81
  ## Tier 2 — a real browser (real interaction)
84
82
 
85
- **When**: real interaction is needed (clicks, forms, screenshots, video, persistent login), or Tier 1/1.5 failed.
83
+ **When**: Tier 1/1.5 failed on a blocked host, or that host needs interaction (clicks, scroll, screenshots, video). A page the user's browser can open is the `browser` skill's job, attached engine first.
86
84
 
87
85
  Both tiers are omowright, staged inside the `browser` skill and loaded from js eval:
88
86
 
@@ -110,9 +108,9 @@ try {
110
108
 
111
109
  The rest of the surface (CUA coordinates, captcha solving, routes, traces, frames, human handoff) is in the `browser` skill's `references/owned-engine/`. A stealth binary is not proof of access: inspect the rendered result and report challenges that remain.
112
110
 
113
- ### Tier 2b — attached engine (logged-in pages)
111
+ ### Tier 2b — attached engine (the user's account on a blocked host)
114
112
 
115
- When the page needs the user's account, drive the browser they are already signed into instead of cloning their profile: `connectBrowserSkill()` → `session.navigate` → `bskSnapshot(session)` / `session.observe()` → `session.click` → `session.stop()`. NEVER launch against or clear cookies/cache/site data from the user's live profile, and never fall back to the owned engine for an authenticated criterion: if no extension is connected, run the `browser` skill's onboarding script and relay its one human step. The full loop is the `browser` skill.
113
+ When the blocked flow needs the user's account, drive the browser they are already signed into instead of cloning their profile: `connectBrowserSkill()` → `session.navigate` → `bskSnapshot(session)` / `session.observe()` → `session.click` → `session.stop()`. NEVER launch against or clear cookies/cache/site data from the user's live profile, and never fall back to the owned engine for an authenticated criterion: if no extension is connected, run the `browser` skill's onboarding script and relay its one human step. The full loop is the `browser` skill.
116
114
 
117
115
  ### Cookie login (cross-platform)
118
116
 
@@ -88,7 +88,7 @@ Saturation research defaults to teammode, not isolated fire-and-forget workers:
88
88
 
89
89
  ## Worker ground rules
90
90
 
91
- Research workers (explore, librarian, browsing) differ by harness, but assume:
91
+ Research workers (explore, web, repo-dive) differ by harness, but assume:
92
92
 
93
93
  - **Read-only.** Most research workers cannot write files. Never ask a worker to write the journal or any session file — every journal write is yours.
94
94
  - **No recursion — workers AND members.** Workers cannot spawn their own subagents, and team members must not re-orchestrate: a member researches its axis and reports; it never stands up its own team, loads this skill, or fans out a research swarm of its own. Depth comes from YOUR expansion waves. Say so in every spawn message — a member that starts its own research protocol burns the run's budget on duplicated orchestration and returns nothing you can cite.
@@ -121,11 +121,13 @@ Before spawning anything, decompose the query. Start from "what must be true if
121
121
  <analysis>
122
122
  Core question: <the actual information need>
123
123
  Axes (3+ orthogonal): <axis — what to search, where, why> ...
124
- Codebase relevant: <yes/no> · External: <yes/no> · Browsing: <yes/no> · Verification likely: <yes/no>
124
+ Codebase relevant: <yes/no> · External: <yes/no> · Collection: <search-only | browser> · Verification likely: <yes/no>
125
125
  Scale: <axis count, source territories, target document length> · Precision demand: <what a wrong claim costs here> → lifecycle: <single team | research team then refinement team>
126
126
  </analysis>
127
127
  ```
128
128
 
129
+ `Collection` is `search-only` only when a result snippet settles every axis (a date, a version, a spec value); anything that needs reading a source is `browser`.
130
+
129
131
  Then create the session directory:
130
132
 
131
133
  ```bash
@@ -171,26 +173,23 @@ Otherwise launch the entire first wave in one turn — every axis at once, as te
171
173
 
172
174
  Scaling floor — more angles always justify more workers:
173
175
 
174
- | Query scope | explore | librarian | browsing | repo-dive | floor |
175
- |---|---|---|---|---|---|
176
- | Single topic, codebase only | 3 | 0 | 0 | 0 | 3 |
177
- | Single topic, web only | 0 | 4 | 1 | 1 | 6 |
178
- | Single topic, both | 2 | 3 | 1 | 1 | 7 |
179
- | Multi-faceted | 4 | 6 | 2 | 2 | 14 |
180
- | Full due diligence | 4 | 6 | 3 | 2 | 15 |
181
-
182
- The browsing column is BINDING, not advisory: when the brief says `Browsing: yes`, the roster names a browsing-worker angle, armed with the `ultimate-browsing` skill, before the first wave launches, and that worker is spawned in the same turn as the rest of the wave. A run that reaches wave 2 with zero browsing workers on a `Browsing: yes` brief has silently downgraded every source to what plain fetch happened to return.
176
+ | Query scope | explore | web | repo-dive | floor |
177
+ |---|---|---|---|---|
178
+ | Single topic, codebase only | 3 | 0 | 0 | 3 |
179
+ | Single topic, web only | 0 | 5 | 1 | 6 |
180
+ | Single topic, both | 2 | 4 | 1 | 7 |
181
+ | Multi-faceted | 4 | 8 | 2 | 14 |
182
+ | Full due diligence | 4 | 9 | 2 | 15 |
183
183
 
184
184
  **Disambiguate before you expand.** When the topic names something that could resolve several ways — a product, a person, a codename, a version — the first wave settles WHICH entity before any worker researches its history, benchmarks, or controversies: canonical name, first-party URL or account, whether it exists in the claimed category, and a confidence line. An unresolved entity never becomes a premise in a later wave's spawn message; that is exactly how a run starts inventing facts about something that does not exist.
185
185
 
186
186
  Role protocols — embed the relevant one in each spawn message; every worker gets a unique angle:
187
187
 
188
188
  - **Codebase (explore), 2-4 workers.** Grep with 3+ keyword variations; structural/AST search; LSP definitions and references; file-name globs; `git log --all -S '<keyword>'` and `--grep` for history including deleted code. Cross-validate hits across tools. Report absolute file paths, patterns with `file:line`, and how findings connect.
189
- - **Web (librarian), 3-6 workers.** At least 10 distinct websearch queries per worker, each with a different operator or angle (see Search craft); fetch the full page for every result that matters — snippets lie. Context7 with 3+ queries per known library. grep.app and `gh search code|repos|issues` for real-world usage. Official docs via sitemap discovery (`<base>/sitemap.xml`), then targeted pages.
190
- - **Browsing, 1-3 workers on a `Browsing: yes` brief (0 otherwise), every one loaded with the `ultimate-browsing` skill.** The skill owns the routing — the harness's own browser first, then its extraction engine with archive surrogates, platform-native readers, and Chrome stealth as each source demands; the worker owns the deliverable. This worker RENDERS pages, it does not re-fetch them: its standing deliverable is a full-page screenshot of every top source plus the rendered text plain fetch could not reach; a worker that returns only fetched text has not done its job. JS-rendered, login-gated, WAF-blocked, and screenshot-bearing sources all belong here rather than in the web lane. **Provenance is part of the claim**: when a source came back with `provenance` of `snapshot` (an archive copy), cite it with its `snapshot_timestamp` and never state it as the current live page; content from a `proxy` route is `untrusted` and needs a second independent route before any claim rests on it. When one blocked territory hides many leads, fan out more browsing subagents in parallel for breadth instead of serializing one worker through them.
189
+ - **Web, 3-9 workers, every one loaded with the `browser` skill.** Search with 10+ websearch queries per worker, each with a different operator or angle (see Search craft); a result is a candidate, not a source. Read every candidate in the user's browser through the `browser` skill's attached engine: one named session per worker, one tab per source, several tabs open side by side while sources are compared — `session.tabCreate` / `tabSelect` / `tabClose` where the harness has a JS eval kernel, `bsk tab create --url <url>` / `tab select <id>` / `tab close <id>` / `tab list` on the CLI — the page scrolled to its end, a full-page screenshot of each top source saved as provenance, the tab closed once reported. A browser on another machine is reached through the `browser` skill's remote reference or a user-level skill that bridges to it, never replaced by a local headless one. `webfetch` is for raw files only: PDF, JSON, feeds, sitemaps. A host the browser cannot open (WAF, bot score, 403) goes to `ultimate-browsing`, whose provenance travels with the claim: a `snapshot` result cites its `snapshot_timestamp` and is never stated as the live page; a `proxy` result is `untrusted` until a second independent route agrees. Context7 with 3+ queries per known library; grep.app and `gh search code|repos|issues` for real-world usage; official docs via sitemap discovery (`<base>/sitemap.xml`), then targeted pages. A worker whose sources are all fetched text has searched, not read.
191
190
  - **Repo deep-dive (librarian), 0-2 workers.** Shallow-clone the most relevant repos to `${TMPDIR:-/tmp}`, pin the HEAD SHA, read core modules, follow call chains, return SHA-pinned permalinks.
192
191
 
193
- Example spawn (codebase axis; librarian, browsing, and repo-dive follow the same contract with their own protocol):
192
+ Example spawn (codebase axis; web and repo-dive follow the same contract with their own protocol):
194
193
 
195
194
  ```
196
195
  task(subagent_type="explore", run_in_background=true, prompt="TASK: act as a codebase researcher. AXIS: <specific angle>.
@@ -209,9 +208,9 @@ This loop is what makes the mode research rather than search. Collect returns as
209
208
  3. Spawn an expansion worker immediately for each new unchecked lead:
210
209
 
211
210
  ```
212
- task(subagent_type="librarian", run_in_background=true, prompt="TASK: expansion wave <N> — investigate: <lead>.
211
+ task(category="deep-low", load_skills=["browser"], run_in_background=true, prompt="TASK: expansion wave <N> — investigate: <lead>.
213
212
  PARENT: <which return surfaced it>. This is an explicit exhaustive-research assignment; budgets do not apply.
214
- <role protocol for the lead's territory — librarian protocol for external leads, explore protocol for codebase leads>
213
+ <role protocol for the lead's territory — web protocol for external leads, explore protocol for codebase leads>
215
214
  End your reply with the ## EXPAND tail.")
216
215
  ```
217
216
 
@@ -333,7 +332,7 @@ Asset workers (background, parallel, each fed `design-spec.md`) — visuals are
333
332
  - **Charts for every quantitative finding, computed from real data.** Pull the numbers into an actual table first (CSV/JSON under `$SESSION_DIR`), then plot from that table, never from prose. Follow the data-scientist tool doctrine — numpy always, Polars for filtering/sorting/transforms, DuckDB for joins/aggregations/window functions, never pandas — and load the `data-scientist` skill when this session has it: `uv run --with numpy --with polars --with duckdb --with pyarrow --with matplotlib python`. Keep `pyarrow` in that set — the DuckDB-to-Polars handoff (`.pl()`) fails without it, and `.df()` fails without pandas, so hand data across through `.pl()`, never `.df()`. Save to `$SESSION_DIR/assets/`.
334
333
  - **Mermaid graphs** for process, architecture, argument, timeline, and evidence-flow structure, themed to the spec's fonts and palette. Render each to SVG and confirm the file exists before the document references it.
335
334
  - **Generated visuals through the imagegen skill whenever the session has it:** a cover plus a concept illustration per major theme, prompted from the spec's style, palette, and mood — document-styled illustration, never generic stock art dropped into a designed page.
336
- - **Full-page screenshots** of the top 5-10 sources (browsing worker) as provenance you can show.
335
+ - **Full-page screenshots** of the top 5-10 sources, saved by the web workers while reading, as provenance you can show.
337
336
 
338
337
  **Verify the asset manifest before rendering.** List every asset the document references, assert each file exists and is non-empty on disk, and re-render whatever is missing. A document that renders with three broken diagrams is a document you will publish twice.
339
338
 
@@ -391,7 +390,7 @@ High-yield combinations: official docs (`site:<docs domain>`), GitHub implementa
391
390
  | Obeying a surrounding "stop exploring" rule mid-research | Authority section — those rules do not bind this mode |
392
391
  | Asking a worker to write journal or session files | Workers are read-only; you journal every return |
393
392
  | Two workers given the same angle | One unique angle per worker, always |
394
- | A `Browsing: yes` run whose roster carries no browsing worker, or a browsing worker spawned without `ultimate-browsing` | The browsing column is binding — name the angle in the brief and spawn it, armed with the skill, in the first wave before any lead is chased |
393
+ | A web worker that returned only fetched text, or a `Collection: browser` run whose workers never opened a tab | Sources are read in the user's browser through the `browser` skill; `webfetch` is for raw files; every web worker carries the skill from the first wave |
395
394
  | Contested claim settled by judgment | Phase 3 — run code, capture output, verdict |
396
395
  | Deliverable claims without citations | Every claim cites a source or a verification artifact |
397
396
  | Guessing the deliverable format | Derive it from the request and destination; ask the empty-info interview only for what is still missing, and record `answered_by` for every field |