tinybeeai 0.0.0-stage → 0.16.1

package/bin/tinybeeai.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// `npx tinybeeai install` entry. Like bin/localdost.js: in a checkout with dev dependencies it runs the
+// TypeScript source through tsx; in an npm install it runs the compiled CLI from dist/.
+import { existsSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const root = fileURLToPath(new URL('..', import.meta.url));
+const source = `${root}src/cli/tinybee.ts`;
+const built = `${root}dist/cli/tinybee.js`;
+
+let register;
+if (existsSync(source) && !process.env.LOCALDOST_USE_DIST) {
+  try {
+    ({ register } = await import('tsx/esm/api'));
+  } catch {
+    /* no dev dependencies: use dist */
+  }
+}
+
+const entry = register ? source : existsSync(built) ? built : undefined;
+if (!entry) {
+  console.error('tinybeeai: no build found. Run `npm ci && npm run build` in the package folder.');
+  process.exit(1);
+}
+if (register) register();
+// The CLI runs when it is the process entry, so argv[1] has to name the file it checks against.
+process.argv[1] = entry;
+await import(pathToFileURL(entry).href);

package/compose.yml

@@ -0,0 +1,63 @@
+# localdost on Docker Compose.
+#
+#   LOCALDOST_TOKEN=$(openssl rand -hex 24) docker compose up -d --build
+#   docker compose --profile tunnel up -d    # also starts the Cloudflare tunnel
+#
+# Other settings (GITHUB_*, JIRA_*, LINEAR_*, ANTHROPIC_API_KEY, NTFY_*) come from .env,
+# which is optional. See .env.example.
+
+name: localdost
+
+services:
+  app:
+    build:
+      context: .
+      target: app
+    image: localdost:app
+    restart: unless-stopped
+    ports:
+      - '${LOCALDOST_PORT:-4319}:4319'
+    env_file:
+      - path: .env
+        required: false
+    environment:
+      # Every /api/* call needs this bearer token. Compose refuses to start without it.
+      LOCALDOST_TOKEN: ${LOCALDOST_TOKEN:?LOCALDOST_TOKEN is required. Generate one with openssl rand -hex 24, then export it or add it to .env}
+      LOCALDOST_PUBLIC_URL: ${LOCALDOST_PUBLIC_URL:-}
+      LOCALDOST_DATA_DIR: /data
+      HOST: 0.0.0.0
+      PORT: '4319'
+    volumes:
+      - localdost-data:/data
+      # Docker runner mode (watch.runner.mode = 'docker') starts test containers through the host
+      # Docker daemon. WARNING: the socket gives this container root-equivalent control of the
+      # host. Mount it only on a machine dedicated to localdost, and add the socket's group id:
+      #   group_add: ['${DOCKER_GID:-999}']
+      # - /var/run/docker.sock:/var/run/docker.sock
+    security_opt:
+      - no-new-privileges:true
+    cap_drop:
+      - ALL
+    tmpfs:
+      - /tmp
+
+  # Optional public URL for webhooks and phone access. Create a tunnel in the Cloudflare
+  # dashboard that points to http://app:4319, then set CLOUDFLARE_TUNNEL_TOKEN and set
+  # LOCALDOST_PUBLIC_URL to the tunnel hostname.
+  tunnel:
+    image: cloudflare/cloudflared:2026.10.0
+    profiles: ['tunnel']
+    restart: unless-stopped
+    command: ['tunnel', '--no-autoupdate', 'run']
+    environment:
+      TUNNEL_TOKEN: ${CLOUDFLARE_TUNNEL_TOKEN:-}
+    depends_on:
+      app:
+        condition: service_healthy
+    security_opt:
+      - no-new-privileges:true
+    cap_drop:
+      - ALL
+
+volumes:
+  localdost-data:

package/demo/payloads/ci_failure.json

@@ -0,0 +1,46 @@
+{
+  "source": "github",
+  "eventName": "workflow_run",
+  "headers": {
+    "content-type": "application/json",
+    "x-github-event": "workflow_run",
+    "x-github-delivery": "demo-ci-failure-0001",
+    "user-agent": "GitHub-Hookshot/demo"
+  },
+  "body": {
+    "action": "completed",
+    "workflow_run": {
+      "id": 11872340561,
+      "name": "e2e",
+      "display_title": "Stack loyalty discount on top of promo codes",
+      "event": "push",
+      "status": "completed",
+      "conclusion": "failure",
+      "head_branch": "main",
+      "head_sha": "9f3c2a17b4e8d05c61a2f7e9b0c3d4e5f6a7b8c9",
+      "run_attempt": 1,
+      "html_url": "https://github.com/demo/shop-web/actions/runs/11872340561",
+      "pull_requests": []
+    },
+    "workflow": {
+      "name": "e2e",
+      "path": ".github/workflows/e2e.yml"
+    },
+    "repository": {
+      "id": 811000123,
+      "name": "shop-web",
+      "full_name": "demo/shop-web",
+      "private": true,
+      "owner": {
+        "login": "demo",
+        "type": "Organization"
+      },
+      "html_url": "https://github.com/demo/shop-web",
+      "default_branch": "main"
+    },
+    "sender": {
+      "login": "lead-dev"
+    },
+    "localdost_demo_log": "2026-10-07T09:20:11.402Z Running 14 tests using 2 workers\n2026-10-07T09:20:14.118Z   ✓  1 [chromium] › tests/smoke.spec.ts:3:5 › home page loads @smoke (1.2s)\n2026-10-07T09:20:19.877Z   ✘  2 [chromium] › tests/checkout.spec.ts:3:5 › discount applied at checkout (5.4s)\n2026-10-07T09:20:31.004Z   1 failed\n2026-10-07T09:20:31.004Z     [chromium] › tests/checkout.spec.ts:3:5 › discount applied at checkout\n2026-10-07T09:20:31.005Z     Error: Timed out 3000ms waiting for expect(locator).toHaveText(expected)\n2026-10-07T09:20:31.005Z     Locator: getByTestId('total')\n2026-10-07T09:20:31.005Z     Expected string: \"$108.00\"\n2026-10-07T09:20:31.005Z     Received string: \"$120.00\"\n2026-10-07T09:20:31.006Z       at tests/checkout.spec.ts:12:43\n2026-10-07T09:20:31.120Z   13 passed (19.7s)\n2026-10-07T09:20:31.540Z ##[error]Process completed with exit code 1."
+  }
+}

package/demo/payloads/outage.json

@@ -0,0 +1,18 @@
+{
+  "source": "probe",
+  "eventName": "probe_down",
+  "headers": {},
+  "body": {
+    "source": "probe",
+    "kind": "probe_down",
+    "dedupeKey": "probe:shop.demo.local:down:demo-0001",
+    "title": "https://shop.demo.local/checkout is failing (HTTP 503)",
+    "url": "https://shop.demo.local/checkout",
+    "probe": {
+      "url": "https://shop.demo.local/checkout",
+      "status": 503,
+      "error": "Service Unavailable: upstream pricing-service timed out after 10000 ms",
+      "consecutiveFailures": 3
+    }
+  }
+}

package/demo/payloads/pr_comment_edited.json

@@ -0,0 +1,50 @@
+{
+  "source": "github",
+  "eventName": "issue_comment",
+  "headers": {
+    "content-type": "application/json",
+    "x-github-event": "issue_comment",
+    "x-github-delivery": "demo-issue-comment-edited-0001",
+    "user-agent": "GitHub-Hookshot/demo"
+  },
+  "body": {
+    "action": "edited",
+    "issue": {
+      "number": 58,
+      "title": "Search: debounce 300 ms and ignore one-letter queries",
+      "pull_request": {
+        "url": "https://api.github.com/repos/demo/shop-web/pulls/58"
+      }
+    },
+    "comment": {
+      "id": 2400000058,
+      "body": "<!-- localdost:pr-summary -->\n<!-- localdost:qa-review head=7c6d5e4f3a2b -->\n### QA review\n\n#### What to test\n\n- [x] **Must** \u00b7 e2e \u00b7 Search: Type one letter, then two letters, in search and check the result list. <!-- qa:t:746738 -->\n- [ ] **Should** \u00b7 run `tests/smoke.spec.ts`: Run the smoke spec to confirm the app still loads. <!-- qa:t:cfc3b9 -->",
+      "author_association": "MEMBER",
+      "user": {
+        "login": "localdost-demo",
+        "type": "User"
+      }
+    },
+    "changes": {
+      "body": {
+        "from": "<!-- localdost:pr-summary -->\n<!-- localdost:qa-review head=7c6d5e4f3a2b -->\n### QA review\n\n#### What to test\n\n- [ ] **Must** \u00b7 e2e \u00b7 Search: Type one letter, then two letters, in search and check the result list. <!-- qa:t:746738 -->\n- [ ] **Should** \u00b7 run `tests/smoke.spec.ts`: Run the smoke spec to confirm the app still loads. <!-- qa:t:cfc3b9 -->"
+      }
+    },
+    "repository": {
+      "id": 811000123,
+      "name": "shop-web",
+      "full_name": "demo/shop-web",
+      "private": true,
+      "owner": {
+        "login": "demo",
+        "type": "Organization"
+      },
+      "html_url": "https://github.com/demo/shop-web",
+      "default_branch": "main"
+    },
+    "sender": {
+      "login": "an-tester",
+      "type": "User"
+    }
+  }
+}

package/demo/payloads/pr_merged.json

@@ -0,0 +1,80 @@
+{
+  "source": "github",
+  "eventName": "pull_request",
+  "headers": {
+    "content-type": "application/json",
+    "x-github-event": "pull_request",
+    "x-github-delivery": "demo-pr-merged-0001",
+    "user-agent": "GitHub-Hookshot/demo"
+  },
+  "body": {
+    "action": "closed",
+    "number": 57,
+    "pull_request": {
+      "number": 57,
+      "state": "closed",
+      "merged": true,
+      "title": "Stack loyalty discount on top of promo codes",
+      "body": "Implements SHOP-142. Loyalty tier rate now applies after the promo code.\n\nTested locally with a gold member.",
+      "html_url": "https://github.com/demo/shop-web/pull/57",
+      "user": {
+        "login": "mai-dev",
+        "type": "User"
+      },
+      "merged_by": {
+        "login": "lead-dev"
+      },
+      "merged_at": "2026-10-07T09:12:44Z",
+      "merge_commit_sha": "9f3c2a17b4e8d05c61a2f7e9b0c3d4e5f6a7b8c9",
+      "head": {
+        "ref": "feat/shop-142-loyalty-stacking",
+        "sha": "4b1e0c9d8a7f6e5d4c3b2a1908f7e6d5c4b3a291",
+        "repo": {
+          "full_name": "demo/shop-web",
+          "fork": false
+        }
+      },
+      "base": {
+        "ref": "main",
+        "sha": "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d",
+        "repo": {
+          "full_name": "demo/shop-web"
+        }
+      },
+      "additions": 22,
+      "deletions": 4,
+      "changed_files": 2
+    },
+    "repository": {
+      "id": 811000123,
+      "name": "shop-web",
+      "full_name": "demo/shop-web",
+      "private": true,
+      "owner": {
+        "login": "demo",
+        "type": "Organization"
+      },
+      "html_url": "https://github.com/demo/shop-web",
+      "default_branch": "main"
+    },
+    "sender": {
+      "login": "lead-dev"
+    },
+    "inlineDiff": [
+      {
+        "path": "src/checkout/discount.ts",
+        "status": "modified",
+        "additions": 13,
+        "deletions": 4,
+        "patch": "@@ -1,18 +1,26 @@\n import type { Cart } from '../cart/types';\n+import { loyaltyRate } from '../loyalty/tiers';\n\n const PROMO_CODES: Record<string, number> = { LOYAL10: 0.1, WELCOME5: 0.05 };\n\n-export function applyDiscount(cart: Cart): number {\n-  const subtotal = cart.items.reduce((sum, i) => sum + i.price * i.qty, 0);\n-  const rate = PROMO_CODES[cart.code ?? ''] ?? 0;\n-  return round2(subtotal - subtotal * rate);\n+export function applyDiscount(cart: Cart, customer?: { tier?: string }): number {\n+  const subtotal = cart.items.reduce((sum, i) => sum + i.price * i.qty, 0);\n+  const promo = PROMO_CODES[cart.code ?? ''] ?? 0;\n+  const loyalty = loyaltyRate(customer?.tier);\n+  // stack loyalty on top of the promo code (SHOP-142)\n+  const discounted = subtotal * (1 - promo) * (1 - loyalty);\n+  if (loyalty === 0) {\n+    return round2(subtotal);\n+  }\n+  return round2(discounted);\n }\n\n function round2(n: number): number {\n   return Math.round(n * 100) / 100;\n }"
+      },
+      {
+        "path": "src/loyalty/tiers.ts",
+        "status": "added",
+        "additions": 9,
+        "deletions": 0,
+        "patch": "@@ -0,0 +1,9 @@\n+const RATES: Record<string, number> = { silver: 0.02, gold: 0.05, platinum: 0.08 };\n+\n+export function loyaltyRate(tier?: string): number {\n+  if (!tier) {\n+    return 0;\n+  }\n+  return RATES[tier.toLowerCase()] ?? 0;\n+}"
+      }
+    ]
+  }
+}

package/demo/payloads/pr_opened.json

@@ -0,0 +1,69 @@
+{
+  "source": "github",
+  "eventName": "pull_request",
+  "headers": {
+    "content-type": "application/json",
+    "x-github-event": "pull_request",
+    "x-github-delivery": "demo-pr-opened-0001",
+    "user-agent": "GitHub-Hookshot/demo"
+  },
+  "body": {
+    "action": "opened",
+    "number": 58,
+    "pull_request": {
+      "number": 58,
+      "state": "open",
+      "merged": false,
+      "draft": false,
+      "title": "Search: debounce 300 ms and ignore one-letter queries",
+      "body": "Cuts search API calls by about 40% on mobile.",
+      "html_url": "https://github.com/demo/shop-web/pull/58",
+      "user": {
+        "login": "an-dev",
+        "type": "User"
+      },
+      "head": {
+        "ref": "perf/search-debounce",
+        "sha": "7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d",
+        "repo": {
+          "full_name": "demo/shop-web",
+          "fork": false
+        }
+      },
+      "base": {
+        "ref": "main",
+        "sha": "9f3c2a17b4e8d05c61a2f7e9b0c3d4e5f6a7b8c9",
+        "repo": {
+          "full_name": "demo/shop-web"
+        }
+      },
+      "additions": 4,
+      "deletions": 3,
+      "changed_files": 1
+    },
+    "repository": {
+      "id": 811000123,
+      "name": "shop-web",
+      "full_name": "demo/shop-web",
+      "private": true,
+      "owner": {
+        "login": "demo",
+        "type": "Organization"
+      },
+      "html_url": "https://github.com/demo/shop-web",
+      "default_branch": "main"
+    },
+    "sender": {
+      "login": "an-dev"
+    },
+    "inlineDiff": [
+      {
+        "path": "src/search/SearchBox.tsx",
+        "status": "modified",
+        "additions": 4,
+        "deletions": 3,
+        "patch": "@@ -12,7 +12,9 @@ export function SearchBox({ onSearch }: Props) {\n   const [query, setQuery] = useState('');\n-  const debounced = useDebounce(query, 150);\n+  // fewer requests while typing on mobile\n+  const debounced = useDebounce(query, 300);\n+  const trimmed = debounced.trim();\n   useEffect(() => {\n-    if (debounced) onSearch(debounced);\n-  }, [debounced]);\n+    if (trimmed.length >= 2) onSearch(trimmed);\n+  }, [trimmed]);"
+      }
+    ]
+  }
+}

package/demo/payloads/pr_synchronize.json

@@ -0,0 +1,69 @@
+{
+  "source": "github",
+  "eventName": "pull_request",
+  "headers": {
+    "content-type": "application/json",
+    "x-github-event": "pull_request",
+    "x-github-delivery": "demo-pr-synchronize-0001",
+    "user-agent": "GitHub-Hookshot/demo"
+  },
+  "body": {
+    "action": "synchronize",
+    "number": 58,
+    "pull_request": {
+      "number": 58,
+      "state": "open",
+      "merged": false,
+      "draft": false,
+      "title": "Search: debounce 300 ms and ignore one-letter queries",
+      "body": "Cuts search API calls by about 40% on mobile.",
+      "html_url": "https://github.com/demo/shop-web/pull/58",
+      "user": {
+        "login": "an-dev",
+        "type": "User"
+      },
+      "head": {
+        "ref": "perf/search-debounce",
+        "sha": "b2e4c6a8d0f1e3c5a7b9d1f3e5c7a9b1d3f5e7a9",
+        "repo": {
+          "full_name": "demo/shop-web",
+          "fork": false
+        }
+      },
+      "base": {
+        "ref": "main",
+        "sha": "9f3c2a17b4e8d05c61a2f7e9b0c3d4e5f6a7b8c9",
+        "repo": {
+          "full_name": "demo/shop-web"
+        }
+      },
+      "additions": 6,
+      "deletions": 3,
+      "changed_files": 1
+    },
+    "repository": {
+      "id": 811000123,
+      "name": "shop-web",
+      "full_name": "demo/shop-web",
+      "private": true,
+      "owner": {
+        "login": "demo",
+        "type": "Organization"
+      },
+      "html_url": "https://github.com/demo/shop-web",
+      "default_branch": "main"
+    },
+    "sender": {
+      "login": "an-dev"
+    },
+    "inlineDiff": [
+      {
+        "path": "src/search/SearchBox.tsx",
+        "status": "modified",
+        "additions": 6,
+        "deletions": 3,
+        "patch": "@@ -12,7 +12,11 @@ export function SearchBox({ onSearch }: Props) {\n   const [query, setQuery] = useState('');\n-  const debounced = useDebounce(query, 150);\n+  // fewer requests while typing on mobile\n+  const debounced = useDebounce(query, 300);\n+  const trimmed = debounced.trim();\n   useEffect(() => {\n-    if (debounced) onSearch(debounced);\n-  }, [debounced]);\n+    if (trimmed.length >= 2) onSearch(trimmed);\n+    else if (!trimmed) onSearch('');\n+  }, [trimmed]);\n+  const hint = trimmed.length === 1 ? 'Type one more letter' : '';"
+      }
+    ]
+  }
+}

package/demo/payloads/ticket_created.json

@@ -0,0 +1,138 @@
+{
+  "source": "jira",
+  "eventName": "jira:issue_created",
+  "headers": {
+    "content-type": "application/json",
+    "x-atlassian-webhook-identifier": "demo-jira-0001"
+  },
+  "body": {
+    "timestamp": 1791364800000,
+    "webhookEvent": "jira:issue_created",
+    "issue_event_type_name": "issue_created",
+    "user": {
+      "accountId": "557058:demo-po",
+      "displayName": "Product Owner"
+    },
+    "issue": {
+      "id": "10442",
+      "key": "SHOP-142",
+      "self": "https://demo-shop.atlassian.net/rest/api/3/issue/10442",
+      "fields": {
+        "summary": "Apply loyalty discount on top of promo codes",
+        "description": {
+          "type": "doc",
+          "version": 1,
+          "content": [
+            {
+              "type": "paragraph",
+              "content": [
+                {
+                  "type": "text",
+                  "text": "Loyalty members should get their tier discount at checkout, also when they use a promo code. Right now the promo code replaces the loyalty discount, and support gets tickets about it every week."
+                }
+              ]
+            },
+            {
+              "type": "paragraph",
+              "content": [
+                {
+                  "type": "text",
+                  "text": "Tiers: silver 2%, gold 5%, platinum 8%."
+                }
+              ]
+            },
+            {
+              "type": "heading",
+              "attrs": {
+                "level": 3
+              },
+              "content": [
+                {
+                  "type": "text",
+                  "text": "Acceptance criteria"
+                }
+              ]
+            },
+            {
+              "type": "bulletList",
+              "content": [
+                {
+                  "type": "listItem",
+                  "content": [
+                    {
+                      "type": "paragraph",
+                      "content": [
+                        {
+                          "type": "text",
+                          "text": "Loyalty discount works correctly together with promo codes"
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "type": "listItem",
+                  "content": [
+                    {
+                      "type": "paragraph",
+                      "content": [
+                        {
+                          "type": "text",
+                          "text": "Total should be calculated properly"
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "type": "listItem",
+                  "content": [
+                    {
+                      "type": "paragraph",
+                      "content": [
+                        {
+                          "type": "text",
+                          "text": "Works for all tiers etc"
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        "issuetype": {
+          "name": "Story"
+        },
+        "priority": {
+          "name": "High"
+        },
+        "labels": ["checkout", "loyalty"],
+        "project": {
+          "key": "SHOP",
+          "name": "Shop"
+        },
+        "reporter": {
+          "displayName": "Product Owner"
+        },
+        "status": {
+          "name": "To Do"
+        }
+      }
+    },
+    "inlineTicket": {
+      "key": "SHOP-142",
+      "id": "10442",
+      "tracker": "jira",
+      "title": "Apply loyalty discount on top of promo codes",
+      "description": "Loyalty members should get their tier discount at checkout, also when they use a promo code. Right now the promo code replaces the loyalty discount, and support gets tickets about it every week.\n\nTiers: silver 2%, gold 5%, platinum 8%.",
+      "acceptanceCriteria": "- Loyalty discount works correctly together with promo codes\n- Total should be calculated properly\n- Works for all tiers etc",
+      "type": "Story",
+      "priority": "High",
+      "labels": ["checkout", "loyalty"],
+      "url": "https://demo-shop.atlassian.net/browse/SHOP-142",
+      "reporter": "Product Owner"
+    }
+  }
+}

package/demo/sample-app/playwright.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig, devices } from '@playwright/test';
+
+const DEFAULT_URL = 'http://localhost:4320';
+const baseURL = process.env.BASE_URL ?? DEFAULT_URL;
+const local = /^http:\/\/(127\.0\.0\.1|localhost):4320\/?$/.test(baseURL);
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  retries: 0,
+  workers: 2,
+  timeout: 15_000,
+  expect: { timeout: 3_000 },
+  // JSON to stdout; the runner parses it.
+  reporter: [['json']],
+  use: { baseURL, trace: 'retain-on-failure' },
+  projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }],
+  // Reuses the shop localdost started in-process, so the seeded bug state is shared.
+  webServer: local ? { command: 'node server.ts 4320', url: `${DEFAULT_URL}/health`, reuseExistingServer: true, timeout: 15_000 } : undefined,
+});