@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.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 (282) hide show
  1. package/AGENTS.md +157 -155
  2. package/CHANGELOG.md +301 -322
  3. package/README.md +335 -345
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/commands/cursor-prompt.js +6 -6
  7. package/dist/commands/init.js +597 -528
  8. package/dist/commands/loop-benchmark.js +11 -11
  9. package/dist/commands/pi-reuse-benchmark.js +16 -16
  10. package/dist/executors/shell-executor.js +200 -21
  11. package/dist/infrastructure/evaluation/candidate-store.js +5 -1
  12. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  13. package/dist/task/runtime.js +27 -27
  14. package/dist/worker/observe/static/api.js +46 -46
  15. package/dist/worker/observe/static/app.js +150 -150
  16. package/dist/worker/observe/static/constants.js +148 -148
  17. package/dist/worker/observe/static/copy.js +67 -67
  18. package/dist/worker/observe/static/dag-helpers.js +172 -172
  19. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  20. package/dist/worker/observe/static/dag-layout.js +83 -83
  21. package/dist/worker/observe/static/dag-model.js +72 -72
  22. package/dist/worker/observe/static/dom.js +212 -53
  23. package/dist/worker/observe/static/format-pool.js +67 -67
  24. package/dist/worker/observe/static/format.js +292 -292
  25. package/dist/worker/observe/static/index.html +308 -308
  26. package/dist/worker/observe/static/kpi.js +94 -94
  27. package/dist/worker/observe/static/relations.js +133 -133
  28. package/dist/worker/observe/static/router.js +93 -93
  29. package/dist/worker/observe/static/run-processing.js +148 -148
  30. package/dist/worker/observe/static/shell-chrome.js +68 -68
  31. package/dist/worker/observe/static/state.js +267 -253
  32. package/dist/worker/observe/static/styles.css +1902 -1902
  33. package/dist/worker/observe/static/views/batch.js +227 -227
  34. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  35. package/dist/worker/observe/static/views/dag-inspector.js +627 -607
  36. package/dist/worker/observe/static/views/dag.js +371 -362
  37. package/dist/worker/observe/static/views/dashboard.js +509 -252
  38. package/dist/worker/observe/static/views/failures.js +143 -143
  39. package/dist/worker/observe/static/views/feature.js +492 -492
  40. package/dist/worker/observe/static/views/pool.js +350 -350
  41. package/dist/worker/observe/static/views/run.js +453 -453
  42. package/dist/worker/observe/static/views/session-timeline.js +219 -205
  43. package/dist/worker/observe/static/views/shell.js +7 -7
  44. package/dist/worker/observe/static/views/task.js +314 -314
  45. package/dist/worker/observe/static/views/timeline.js +163 -163
  46. package/dist/workflows/dag/backend-test-case-manifest.js +503 -0
  47. package/dist/workflows/dag/backend-test-execution-contract.js +353 -0
  48. package/dist/workflows/dag/backend-test-result-contract.js +568 -0
  49. package/dist/workflows/dag/canvas-observer.js +275 -275
  50. package/dist/workflows/dag/decision-envelope.js +57 -2
  51. package/dist/workflows/dag/frontend-implementation-contract.js +240 -0
  52. package/dist/workflows/dag/frontend-project-capability.js +309 -0
  53. package/dist/workflows/dag/frontend-repair.js +341 -0
  54. package/dist/workflows/dag/frontend-risk.js +161 -0
  55. package/dist/workflows/dag/frontend-verification-trace.js +190 -0
  56. package/dist/workflows/dag/init-hybrid.js +1020 -125
  57. package/dist/workflows/dag/repair-artifact.js +43 -3
  58. package/dist/workflows/dag/skill-instructions.js +4 -2
  59. package/dist/workflows/dag/types.js +29 -8
  60. package/docs/README.md +105 -104
  61. package/docs/agent-dag-recovery-playbook.md +195 -195
  62. package/docs/agent-dag-runner.md +67 -67
  63. package/docs/architecture/README.md +26 -26
  64. package/docs/architecture/dag-execution.md +140 -140
  65. package/docs/architecture/evolution.md +54 -54
  66. package/docs/architecture/facts-and-state.md +71 -71
  67. package/docs/architecture/runtime-boundaries.md +191 -191
  68. package/docs/architecture/system-overview.md +93 -93
  69. package/docs/architecture/worker-and-feature.md +85 -85
  70. package/docs/cursor-prompt-sidecar.md +36 -36
  71. package/docs/decisions/README.md +18 -18
  72. package/docs/design/README.md +167 -167
  73. package/docs/development-principles.md +73 -73
  74. package/docs/exec-plans/README.md +6 -6
  75. package/docs/exec-plans/active/README.md +1 -4
  76. package/docs/exec-plans/completed/README.md +106 -84
  77. package/docs/feature-workflow.md +414 -389
  78. package/docs/harness-methodology-debugging.md +153 -153
  79. package/docs/harness-methodology-tdd.md +130 -130
  80. package/docs/harness-methodology-verification.md +27 -27
  81. package/docs/init-surface.manifest.json +307 -289
  82. package/docs/loop-agent-harness.md +142 -142
  83. package/docs/production-readiness.md +96 -96
  84. package/docs/progress/README.md +76 -60
  85. package/docs/reports/README.md +150 -108
  86. package/docs/skills/README.md +7 -7
  87. package/docs/skills/vetted-skill-registry.md +29 -29
  88. package/docs/templates/adr.md +60 -60
  89. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  90. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  91. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  92. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  93. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  94. package/docs/templates/agent-dag-report.schema.json +473 -473
  95. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  96. package/docs/templates/agent-dag.base.json +190 -190
  97. package/docs/templates/agent-dag.final-verification.json +185 -185
  98. package/docs/templates/agent-dag.schema.json +411 -411
  99. package/docs/templates/agent-dag.supervised-implementation.json +620 -501
  100. package/docs/templates/backend-test-analysis.schema.json +44 -44
  101. package/docs/templates/backend-test-case-manifest.schema.json +190 -0
  102. package/docs/templates/backend-test-dag.classify.prompt.md +75 -0
  103. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -202
  104. package/docs/templates/backend-test-dag.json +559 -311
  105. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -125
  106. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -81
  107. package/docs/templates/backend-test-execution.schema.json +133 -0
  108. package/docs/templates/backend-test-result.schema.json +99 -0
  109. package/docs/templates/branch-merge-report.md +93 -0
  110. package/docs/templates/exec-plan.md +64 -64
  111. package/docs/templates/feature-spec.md +53 -53
  112. package/docs/templates/frontend-design-contract.md +42 -42
  113. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -0
  114. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -0
  115. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -0
  116. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -0
  117. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -0
  118. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -0
  119. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -0
  120. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -0
  121. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -0
  122. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -0
  123. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -0
  124. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -0
  125. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -0
  126. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -0
  127. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -0
  128. package/docs/templates/frontend-eval/metrics.md +138 -0
  129. package/docs/templates/frontend-eval/smoke-targets.md +53 -0
  130. package/docs/templates/frontend-implementation-contract.schema.json +27 -0
  131. package/docs/templates/frontend-task-constraints.md +35 -35
  132. package/docs/templates/frontend-task-requirement.md +70 -70
  133. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  134. package/docs/templates/frontend-test-dag.json +23 -23
  135. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  136. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  137. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  138. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  139. package/docs/templates/harness.schema.json +221 -221
  140. package/docs/templates/hybrid-dag.json +188 -188
  141. package/docs/templates/init-evolution-review.md +35 -35
  142. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  143. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  144. package/docs/templates/knowledge-sync-dag.json +178 -178
  145. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  146. package/docs/templates/product-line/AGENTS.md +8 -8
  147. package/docs/templates/product-line/README.md +9 -9
  148. package/docs/templates/product-line/acceptance.yaml +14 -14
  149. package/docs/templates/product-line/closeout.yaml +9 -9
  150. package/docs/templates/product-line/design.md +13 -13
  151. package/docs/templates/product-line/links.md +10 -10
  152. package/docs/templates/product-line/requirement.md +17 -17
  153. package/docs/templates/product-line/task-graph.yaml +15 -15
  154. package/docs/templates/product-line/task.yaml +64 -64
  155. package/docs/templates/product-line/test-plan.md +7 -7
  156. package/docs/templates/production-readiness-checklist.md +57 -57
  157. package/docs/templates/progress-log.md +17 -17
  158. package/docs/templates/project-start-checklist.md +9 -9
  159. package/docs/templates/qa-report.md +48 -48
  160. package/docs/templates/sprint-contract.md +29 -29
  161. package/docs/templates/worker-dogfood-evidence.md +80 -80
  162. package/docs/templates/worker-dogfood-setup.md +68 -68
  163. package/docs/verification-matrix.md +70 -70
  164. package/examples/decision-gate-agent-dag.json +177 -177
  165. package/examples/example-dag.json +46 -46
  166. package/examples/hybrid-loop-agent-dag.json +189 -189
  167. package/harness.json +66 -66
  168. package/package.json +52 -88
  169. package/scripts/check-product-line-docs.sh +29 -29
  170. package/scripts/check-task-pool-root.sh +32 -32
  171. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  172. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  173. package/scripts/kb-graph-incremental-prepare.sh +5 -5
  174. package/scripts/kb-graph-materialize.mjs +105 -105
  175. package/scripts/kb-graph-materialize.sh +4 -4
  176. package/scripts/kb-graph-promote.mjs +164 -164
  177. package/scripts/kb-graph-promote.sh +4 -4
  178. package/scripts/kb-query.mjs +554 -554
  179. package/scripts/kb-query.sh +5 -5
  180. package/skills/agent-worker/SKILL.md +39 -39
  181. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  182. package/skills/ai-engineering-context/SKILL.md +48 -48
  183. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  184. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  185. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  186. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  187. package/skills/analyze-product-dependencies/references/example.md +76 -76
  188. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  189. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  190. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  191. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  192. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  193. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  194. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  195. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  196. package/skills/analyze-product-requirements/SKILL.md +90 -90
  197. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  198. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  199. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  200. package/skills/analyze-product-requirements/references/example.md +86 -86
  201. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  202. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  203. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  204. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  205. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  206. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  207. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  208. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  209. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  210. package/skills/browser-tools/SKILL.md +196 -0
  211. package/skills/browser-tools/browser-content.js +103 -0
  212. package/skills/browser-tools/browser-cookies.js +35 -0
  213. package/skills/browser-tools/browser-eval.js +53 -0
  214. package/skills/browser-tools/browser-hn-scraper.js +108 -0
  215. package/skills/browser-tools/browser-nav.js +44 -0
  216. package/skills/browser-tools/browser-pick.js +162 -0
  217. package/skills/browser-tools/browser-screenshot.js +34 -0
  218. package/skills/browser-tools/browser-start.js +86 -0
  219. package/skills/browser-tools/package-lock.json +2556 -0
  220. package/skills/browser-tools/package.json +19 -0
  221. package/skills/code-review-core/SKILL.md +20 -20
  222. package/skills/codebase-scout/SKILL.md +19 -19
  223. package/skills/frontend-design-review/SKILL.md +66 -66
  224. package/skills/frontend-design-review/references/review-checklist.md +58 -58
  225. package/skills/frontend-implementation/SKILL.md +49 -47
  226. package/skills/frontend-implementation/references/code-standards.md +32 -32
  227. package/skills/frontend-implementation/references/design-spec.md +46 -46
  228. package/skills/frontend-implementation/references/node-contracts.md +27 -76
  229. package/skills/frontend-review/SKILL.md +59 -59
  230. package/skills/frontend-review/references/review-findings.md +47 -47
  231. package/skills/frontend-verification/SKILL.md +53 -53
  232. package/skills/frontend-verification/references/verification-checklist.md +68 -68
  233. package/skills/grill-me/SKILL.md +10 -10
  234. package/skills/grill-with-docs/SKILL.md +88 -88
  235. package/skills/grill-with-docs/adr-format.md +47 -47
  236. package/skills/grill-with-docs/context-format.md +60 -60
  237. package/skills/init-capability-evolution/SKILL.md +70 -70
  238. package/skills/loop-agent/SKILL.md +151 -151
  239. package/skills/loop-agent/references/README.md +67 -67
  240. package/skills/loop-agent/references/command-reference.md +527 -505
  241. package/skills/loop-agent/references/docs-converge.md +126 -126
  242. package/skills/loop-agent/references/harness-policy.md +263 -263
  243. package/skills/loop-agent/references/hybrid-dag.md +243 -238
  244. package/skills/loop-agent/references/learned/README.md +21 -21
  245. package/skills/loop-agent/references/long-running-loop.md +57 -57
  246. package/skills/loop-agent/references/model-routing.md +36 -36
  247. package/skills/loop-agent/references/multi-worktree.md +54 -54
  248. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  249. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  250. package/skills/loop-agent/references/pi-prompt.md +23 -23
  251. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  252. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  253. package/skills/loop-agent/references/task-workflow.md +89 -89
  254. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -139
  255. package/skills/playwright-cli/SKILL.md +420 -420
  256. package/skills/playwright-cli/references/element-attributes.md +23 -23
  257. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  258. package/skills/playwright-cli/references/request-mocking.md +87 -87
  259. package/skills/playwright-cli/references/running-code.md +241 -241
  260. package/skills/playwright-cli/references/session-management.md +225 -225
  261. package/skills/playwright-cli/references/storage-state.md +275 -275
  262. package/skills/playwright-cli/references/test-generation.md +433 -433
  263. package/skills/playwright-cli/references/tracing.md +139 -139
  264. package/skills/playwright-cli/references/video-recording.md +143 -143
  265. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  266. package/skills/requesting-code-review/SKILL.md +101 -101
  267. package/skills/requesting-code-review/code-reviewer.md +168 -168
  268. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  269. package/skills/systematic-debugging/SKILL.md +296 -296
  270. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  271. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  272. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  273. package/skills/systematic-debugging/find-polluter.sh +63 -63
  274. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  275. package/skills/systematic-debugging/test-academic.md +14 -14
  276. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  277. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  278. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  279. package/skills/test-driven-development/SKILL.md +20 -20
  280. package/skills/using-git-worktrees/SKILL.md +215 -215
  281. package/skills/verification-before-completion/SKILL.md +154 -154
  282. package/skills/webapp-testing/SKILL.md +19 -19
@@ -0,0 +1,53 @@
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+
5
+ const code = process.argv.slice(2).join(" ");
6
+ if (!code) {
7
+ console.log("Usage: browser-eval.js 'code'");
8
+ console.log("\nExamples:");
9
+ console.log(' browser-eval.js "document.title"');
10
+ console.log(' browser-eval.js "document.querySelectorAll(\'a\').length"');
11
+ process.exit(1);
12
+ }
13
+
14
+ const b = await Promise.race([
15
+ puppeteer.connect({
16
+ browserURL: "http://localhost:9222",
17
+ defaultViewport: null,
18
+ }),
19
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
20
+ ]).catch((e) => {
21
+ console.error("✗ Could not connect to browser:", e.message);
22
+ console.error(" Run: browser-start.js");
23
+ process.exit(1);
24
+ });
25
+
26
+ const p = (await b.pages()).at(-1);
27
+
28
+ if (!p) {
29
+ console.error("✗ No active tab found");
30
+ process.exit(1);
31
+ }
32
+
33
+ const result = await p.evaluate((c) => {
34
+ const AsyncFunction = (async () => {}).constructor;
35
+ return new AsyncFunction(`return (${c})`)();
36
+ }, code);
37
+
38
+ if (Array.isArray(result)) {
39
+ for (let i = 0; i < result.length; i++) {
40
+ if (i > 0) console.log("");
41
+ for (const [key, value] of Object.entries(result[i])) {
42
+ console.log(`${key}: ${value}`);
43
+ }
44
+ }
45
+ } else if (typeof result === "object" && result !== null) {
46
+ for (const [key, value] of Object.entries(result)) {
47
+ console.log(`${key}: ${value}`);
48
+ }
49
+ } else {
50
+ console.log(result);
51
+ }
52
+
53
+ await b.disconnect();
@@ -0,0 +1,108 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Hacker News Scraper
5
+ *
6
+ * Fetches and parses submissions from Hacker News front page.
7
+ * Usage: node browser-hn-scraper.js [--limit <number>]
8
+ */
9
+
10
+ import * as cheerio from 'cheerio';
11
+
12
+ /**
13
+ * Scrapes Hacker News front page
14
+ * @param {number} limit - Maximum number of submissions to return (default: 30)
15
+ * @returns {Promise<Array>} Array of submission objects
16
+ */
17
+ async function scrapeHackerNews(limit = 30) {
18
+ const url = 'https://news.ycombinator.com';
19
+
20
+ try {
21
+ const response = await fetch(url);
22
+ if (!response.ok) {
23
+ throw new Error(`HTTP error! status: ${response.status}`);
24
+ }
25
+
26
+ const html = await response.text();
27
+ const $ = cheerio.load(html);
28
+ const submissions = [];
29
+
30
+ // Each submission has class 'athing'
31
+ $('.athing').each((index, element) => {
32
+ if (submissions.length >= limit) return false; // Stop when limit reached
33
+
34
+ const $element = $(element);
35
+ const id = $element.attr('id');
36
+
37
+ // Get title and URL from titleline
38
+ const $titleLine = $element.find('.titleline > a').first();
39
+ const title = $titleLine.text().trim();
40
+ const url = $titleLine.attr('href');
41
+
42
+ // Get the next row which contains metadata (points, author, comments)
43
+ const $metadataRow = $element.next();
44
+ const $subtext = $metadataRow.find('.subtext');
45
+
46
+ // Get points
47
+ const $score = $subtext.find(`#score_${id}`);
48
+ const pointsText = $score.text();
49
+ const points = pointsText ? parseInt(pointsText.match(/\d+/)?.[0] || '0') : 0;
50
+
51
+ // Get author
52
+ const author = $subtext.find('.hnuser').text().trim();
53
+
54
+ // Get time
55
+ const time = $subtext.find('.age').attr('title') || $subtext.find('.age').text().trim();
56
+
57
+ // Get comments count
58
+ const $commentsLink = $subtext.find('a').last();
59
+ const commentsText = $commentsLink.text();
60
+ let commentsCount = 0;
61
+
62
+ if (commentsText.includes('comment')) {
63
+ const match = commentsText.match(/(\d+)/);
64
+ commentsCount = match ? parseInt(match[0]) : 0;
65
+ }
66
+
67
+ submissions.push({
68
+ id,
69
+ title,
70
+ url,
71
+ points,
72
+ author,
73
+ time,
74
+ comments: commentsCount,
75
+ hnUrl: `https://news.ycombinator.com/item?id=${id}`
76
+ });
77
+ });
78
+
79
+ return submissions;
80
+ } catch (error) {
81
+ console.error('Error scraping Hacker News:', error.message);
82
+ throw error;
83
+ }
84
+ }
85
+
86
+ // CLI interface
87
+ if (import.meta.url === `file://${process.argv[1]}`) {
88
+ const args = process.argv.slice(2);
89
+ let limit = 30;
90
+
91
+ // Parse --limit argument
92
+ const limitIndex = args.indexOf('--limit');
93
+ if (limitIndex !== -1 && args[limitIndex + 1]) {
94
+ limit = parseInt(args[limitIndex + 1]);
95
+ }
96
+
97
+ scrapeHackerNews(limit)
98
+ .then(submissions => {
99
+ console.log(JSON.stringify(submissions, null, 2));
100
+ console.error(`\n✓ Scraped ${submissions.length} submissions`);
101
+ })
102
+ .catch(error => {
103
+ console.error('Failed to scrape:', error.message);
104
+ process.exit(1);
105
+ });
106
+ }
107
+
108
+ export { scrapeHackerNews };
@@ -0,0 +1,44 @@
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+
5
+ const args = process.argv.slice(2);
6
+ const newTab = args.includes("--new");
7
+ const reload = args.includes("--reload");
8
+ const url = args.find(a => !a.startsWith("--"));
9
+
10
+ if (!url) {
11
+ console.log("Usage: browser-nav.js <url> [--new] [--reload]");
12
+ console.log("\nExamples:");
13
+ console.log(" browser-nav.js https://example.com # Navigate current tab");
14
+ console.log(" browser-nav.js https://example.com --new # Open in new tab");
15
+ console.log(" browser-nav.js https://example.com --reload # Navigate and force reload");
16
+ process.exit(1);
17
+ }
18
+
19
+ const b = await Promise.race([
20
+ puppeteer.connect({
21
+ browserURL: "http://localhost:9222",
22
+ defaultViewport: null,
23
+ }),
24
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
25
+ ]).catch((e) => {
26
+ console.error("✗ Could not connect to browser:", e.message);
27
+ console.error(" Run: browser-start.js");
28
+ process.exit(1);
29
+ });
30
+
31
+ if (newTab) {
32
+ const p = await b.newPage();
33
+ await p.goto(url, { waitUntil: "domcontentloaded" });
34
+ console.log("✓ Opened:", url);
35
+ } else {
36
+ const p = (await b.pages()).at(-1);
37
+ await p.goto(url, { waitUntil: "domcontentloaded" });
38
+ if (reload) {
39
+ await p.reload({ waitUntil: "domcontentloaded" });
40
+ }
41
+ console.log("✓ Navigated to:", url);
42
+ }
43
+
44
+ await b.disconnect();
@@ -0,0 +1,162 @@
1
+ #!/usr/bin/env node
2
+
3
+ import puppeteer from "puppeteer-core";
4
+
5
+ const message = process.argv.slice(2).join(" ");
6
+ if (!message) {
7
+ console.log("Usage: browser-pick.js 'message'");
8
+ console.log("\nExample:");
9
+ console.log(' browser-pick.js "Click the submit button"');
10
+ process.exit(1);
11
+ }
12
+
13
+ const b = await Promise.race([
14
+ puppeteer.connect({
15
+ browserURL: "http://localhost:9222",
16
+ defaultViewport: null,
17
+ }),
18
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
19
+ ]).catch((e) => {
20
+ console.error("✗ Could not connect to browser:", e.message);
21
+ console.error(" Run: browser-start.js");
22
+ process.exit(1);
23
+ });
24
+
25
+ const p = (await b.pages()).at(-1);
26
+
27
+ if (!p) {
28
+ console.error("✗ No active tab found");
29
+ process.exit(1);
30
+ }
31
+
32
+ // Inject pick() helper into current page
33
+ await p.evaluate(() => {
34
+ if (!window.pick) {
35
+ window.pick = async (message) => {
36
+ if (!message) {
37
+ throw new Error("pick() requires a message parameter");
38
+ }
39
+ return new Promise((resolve) => {
40
+ const selections = [];
41
+ const selectedElements = new Set();
42
+
43
+ const overlay = document.createElement("div");
44
+ overlay.style.cssText =
45
+ "position:fixed;top:0;left:0;width:100%;height:100%;z-index:2147483647;pointer-events:none";
46
+
47
+ const highlight = document.createElement("div");
48
+ highlight.style.cssText =
49
+ "position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);transition:all 0.1s";
50
+ overlay.appendChild(highlight);
51
+
52
+ const banner = document.createElement("div");
53
+ banner.style.cssText =
54
+ "position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:#1f2937;color:white;padding:12px 24px;border-radius:8px;font:14px sans-serif;box-shadow:0 4px 12px rgba(0,0,0,0.3);pointer-events:auto;z-index:2147483647";
55
+
56
+ const updateBanner = () => {
57
+ banner.textContent = `${message} (${selections.length} selected, Cmd/Ctrl+click to add, Enter to finish, ESC to cancel)`;
58
+ };
59
+ updateBanner();
60
+
61
+ document.body.append(banner, overlay);
62
+
63
+ const cleanup = () => {
64
+ document.removeEventListener("mousemove", onMove, true);
65
+ document.removeEventListener("click", onClick, true);
66
+ document.removeEventListener("keydown", onKey, true);
67
+ overlay.remove();
68
+ banner.remove();
69
+ selectedElements.forEach((el) => {
70
+ el.style.outline = "";
71
+ });
72
+ };
73
+
74
+ const onMove = (e) => {
75
+ const el = document.elementFromPoint(e.clientX, e.clientY);
76
+ if (!el || overlay.contains(el) || banner.contains(el)) return;
77
+ const r = el.getBoundingClientRect();
78
+ highlight.style.cssText = `position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);top:${r.top}px;left:${r.left}px;width:${r.width}px;height:${r.height}px`;
79
+ };
80
+
81
+ const buildElementInfo = (el) => {
82
+ const parents = [];
83
+ let current = el.parentElement;
84
+ while (current && current !== document.body) {
85
+ const parentInfo = current.tagName.toLowerCase();
86
+ const id = current.id ? `#${current.id}` : "";
87
+ const cls = current.className
88
+ ? `.${current.className.trim().split(/\s+/).join(".")}`
89
+ : "";
90
+ parents.push(parentInfo + id + cls);
91
+ current = current.parentElement;
92
+ }
93
+
94
+ return {
95
+ tag: el.tagName.toLowerCase(),
96
+ id: el.id || null,
97
+ class: el.className || null,
98
+ text: el.textContent?.trim().slice(0, 200) || null,
99
+ html: el.outerHTML.slice(0, 500),
100
+ parents: parents.join(" > "),
101
+ };
102
+ };
103
+
104
+ const onClick = (e) => {
105
+ if (banner.contains(e.target)) return;
106
+ e.preventDefault();
107
+ e.stopPropagation();
108
+ const el = document.elementFromPoint(e.clientX, e.clientY);
109
+ if (!el || overlay.contains(el) || banner.contains(el)) return;
110
+
111
+ if (e.metaKey || e.ctrlKey) {
112
+ if (!selectedElements.has(el)) {
113
+ selectedElements.add(el);
114
+ el.style.outline = "3px solid #10b981";
115
+ selections.push(buildElementInfo(el));
116
+ updateBanner();
117
+ }
118
+ } else {
119
+ cleanup();
120
+ const info = buildElementInfo(el);
121
+ resolve(selections.length > 0 ? selections : info);
122
+ }
123
+ };
124
+
125
+ const onKey = (e) => {
126
+ if (e.key === "Escape") {
127
+ e.preventDefault();
128
+ cleanup();
129
+ resolve(null);
130
+ } else if (e.key === "Enter" && selections.length > 0) {
131
+ e.preventDefault();
132
+ cleanup();
133
+ resolve(selections);
134
+ }
135
+ };
136
+
137
+ document.addEventListener("mousemove", onMove, true);
138
+ document.addEventListener("click", onClick, true);
139
+ document.addEventListener("keydown", onKey, true);
140
+ });
141
+ };
142
+ }
143
+ });
144
+
145
+ const result = await p.evaluate((msg) => window.pick(msg), message);
146
+
147
+ if (Array.isArray(result)) {
148
+ for (let i = 0; i < result.length; i++) {
149
+ if (i > 0) console.log("");
150
+ for (const [key, value] of Object.entries(result[i])) {
151
+ console.log(`${key}: ${value}`);
152
+ }
153
+ }
154
+ } else if (typeof result === "object" && result !== null) {
155
+ for (const [key, value] of Object.entries(result)) {
156
+ console.log(`${key}: ${value}`);
157
+ }
158
+ } else {
159
+ console.log(result);
160
+ }
161
+
162
+ await b.disconnect();
@@ -0,0 +1,34 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import puppeteer from "puppeteer-core";
6
+
7
+ const b = await Promise.race([
8
+ puppeteer.connect({
9
+ browserURL: "http://localhost:9222",
10
+ defaultViewport: null,
11
+ }),
12
+ new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), 5000)),
13
+ ]).catch((e) => {
14
+ console.error("✗ Could not connect to browser:", e.message);
15
+ console.error(" Run: browser-start.js");
16
+ process.exit(1);
17
+ });
18
+
19
+ const p = (await b.pages()).at(-1);
20
+
21
+ if (!p) {
22
+ console.error("✗ No active tab found");
23
+ process.exit(1);
24
+ }
25
+
26
+ const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
27
+ const filename = `screenshot-${timestamp}.png`;
28
+ const filepath = join(tmpdir(), filename);
29
+
30
+ await p.screenshot({ path: filepath });
31
+
32
+ console.log(filepath);
33
+
34
+ await b.disconnect();
@@ -0,0 +1,86 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { spawn, execSync } from "node:child_process";
4
+ import puppeteer from "puppeteer-core";
5
+
6
+ const useProfile = process.argv[2] === "--profile";
7
+
8
+ if (process.argv[2] && process.argv[2] !== "--profile") {
9
+ console.log("Usage: browser-start.js [--profile]");
10
+ console.log("\nOptions:");
11
+ console.log(" --profile Copy your default Chrome profile (cookies, logins)");
12
+ process.exit(1);
13
+ }
14
+
15
+ const SCRAPING_DIR = `${process.env.HOME}/.cache/browser-tools`;
16
+
17
+ // Check if already running on :9222
18
+ try {
19
+ const browser = await puppeteer.connect({
20
+ browserURL: "http://localhost:9222",
21
+ defaultViewport: null,
22
+ });
23
+ await browser.disconnect();
24
+ console.log("✓ Chrome already running on :9222");
25
+ process.exit(0);
26
+ } catch {}
27
+
28
+ // Setup profile directory
29
+ execSync(`mkdir -p "${SCRAPING_DIR}"`, { stdio: "ignore" });
30
+
31
+ // Remove SingletonLock to allow new instance
32
+ try {
33
+ execSync(`rm -f "${SCRAPING_DIR}/SingletonLock" "${SCRAPING_DIR}/SingletonSocket" "${SCRAPING_DIR}/SingletonCookie"`, { stdio: "ignore" });
34
+ } catch {}
35
+
36
+ if (useProfile) {
37
+ console.log("Syncing profile...");
38
+ execSync(
39
+ `rsync -a --delete \
40
+ --exclude='SingletonLock' \
41
+ --exclude='SingletonSocket' \
42
+ --exclude='SingletonCookie' \
43
+ --exclude='*/Sessions/*' \
44
+ --exclude='*/Current Session' \
45
+ --exclude='*/Current Tabs' \
46
+ --exclude='*/Last Session' \
47
+ --exclude='*/Last Tabs' \
48
+ "${process.env.HOME}/Library/Application Support/Google/Chrome/" "${SCRAPING_DIR}/"`,
49
+ { stdio: "pipe" },
50
+ );
51
+ }
52
+
53
+ // Start Chrome with flags to force new instance
54
+ spawn(
55
+ "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
56
+ [
57
+ "--remote-debugging-port=9222",
58
+ `--user-data-dir=${SCRAPING_DIR}`,
59
+ "--no-first-run",
60
+ "--no-default-browser-check",
61
+ ],
62
+ { detached: true, stdio: "ignore" },
63
+ ).unref();
64
+
65
+ // Wait for Chrome to be ready
66
+ let connected = false;
67
+ for (let i = 0; i < 30; i++) {
68
+ try {
69
+ const browser = await puppeteer.connect({
70
+ browserURL: "http://localhost:9222",
71
+ defaultViewport: null,
72
+ });
73
+ await browser.disconnect();
74
+ connected = true;
75
+ break;
76
+ } catch {
77
+ await new Promise((r) => setTimeout(r, 500));
78
+ }
79
+ }
80
+
81
+ if (!connected) {
82
+ console.error("✗ Failed to connect to Chrome");
83
+ process.exit(1);
84
+ }
85
+
86
+ console.log(`✓ Chrome started on :9222${useProfile ? " with your profile" : ""}`);