Open source 1.0: README, example, agent skill, docs and the React publish workflow

.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,48 @@
+name: Bug report
+description: Something the SDK, a check or a helper does wrong
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Do not paste real user data, project keys or tokens. For a security or privacy problem, use "Report a vulnerability" on the Security tab instead of an issue.
+  - type: dropdown
+    id: package
+    attributes:
+      label: Package
+      options:
+        - "@codepress/interactions-browser"
+        - "@codepress/interactions-react"
+        - "@codepress/interactions-playwright"
+        - Python SDK
+        - Example or skill
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version and browser
+      placeholder: "1.0.0, Chrome 140 on macOS"
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Page that reproduces it
+      description: Minimal HTML and CSS, a small component, or a link to a repository.
+      render: html
+    validations:
+      required: true
+  - type: textarea
+    id: reported
+    attributes:
+      label: What was reported
+      description: The finding line (from formatFinding or expectNoFindings), the events, or the error.
+      render: text
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected
+      description: For a wrong or missing finding, say what is on screen.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/check-request.yml

@@ -0,0 +1,22 @@
+name: Check request
+description: A UI problem the checks should find, or evidence a finding should carry
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: The problem users see
+      description: What goes wrong on screen or when clicking, and why it matters.
+    validations:
+      required: true
+  - type: textarea
+    id: example
+    attributes:
+      label: A page that shows it
+      description: Minimal HTML and CSS, or a component.
+      render: html
+  - type: textarea
+    id: measurement
+    attributes:
+      label: How it could be measured
+      description: What in a snapshot (element boxes, flags, text boxes, hit tests) or in the click timeline tells it apart from intended layouts. Checks never read page text.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security or privacy problem
+    url: https://github.com/quantfive/codepress-interactions/security/advisories/new
+    about: Report it privately instead of in a public issue.

.github/workflows/ci.yml

@@ -59,6 +59,10 @@ jobs:
         working-directory: packages/playwright
         run: pnpm run build && pnpm run pack:check
 
+      - name: Check the packed files (React adapter)
+        working-directory: packages/react
+        run: pnpm run build && pnpm run pack:check
+
   python:
     name: Python tests and lint
     runs-on: ubuntu-24.04

.github/workflows/publish-playwright.yml

@@ -126,8 +126,17 @@ jobs:
             echo "published=false" >> "$GITHUB_OUTPUT"
             echo "publish=false" >> "$GITHUB_OUTPUT"
           elif [ "$RELEASE" = "true" ]; then
-            echo "published=false" >> "$GITHUB_OUTPUT"
-            echo "publish=true" >> "$GITHUB_OUTPUT"
+            # The tarball depends on the browser package's version range; do not
+            # publish until npm has the browser version this checkout builds against.
+            BROWSER_VERSION=$(node -p "require('../browser/package.json').version")
+            if [ -z "$(npm view "@codepress/interactions-browser@$BROWSER_VERSION" version 2>/dev/null)" ]; then
+              echo "::warning::@codepress/interactions-browser@$BROWSER_VERSION is not on npm yet, so this run does not publish $PACKAGE@$VERSION. Publish the browser package first (publish-browser.yml), then re-run this workflow with dry_run off."
+              echo "published=false" >> "$GITHUB_OUTPUT"
+              echo "publish=false" >> "$GITHUB_OUTPUT"
+            else
+              echo "published=false" >> "$GITHUB_OUTPUT"
+              echo "publish=true" >> "$GITHUB_OUTPUT"
+            fi
           else
             echo "published=false" >> "$GITHUB_OUTPUT"
             echo "publish=false" >> "$GITHUB_OUTPUT"