Add changelog-driven release announcements

Author: Rieranthony

.github/workflows/release.yml

@@ -4,7 +4,13 @@ on:
   push:
     branches:
       - main
-  workflow_dispatch: {}
+  workflow_dispatch:
+    inputs:
+      announcement_dry_run:
+        description: "Generate release announcement copy without publishing to Discord or X"
+        required: false
+        default: false
+        type: boolean
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -232,3 +238,29 @@ jobs:
                 }
               }
             }
+
+      - name: Announce widget release
+        if: steps.browser_package.outputs.published == 'true'
+        continue-on-error: true
+        env:
+          ANNOUNCEMENT_CHANGELOG_BASE_URL: ${{ vars.ANNOUNCEMENT_CHANGELOG_BASE_URL }}
+          BROWSER_VERSION: ${{ steps.browser_package.outputs.version }}
+          DISCORD_RELEASE_WEBHOOK_URL: ${{ secrets.DISCORD_RELEASE_WEBHOOK_URL }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPOSITORY: ${{ github.repository }}
+          X_ACCESS_TOKEN: ${{ secrets.X_ACCESS_TOKEN }}
+          X_ACCESS_TOKEN_SECRET: ${{ secrets.X_ACCESS_TOKEN_SECRET }}
+          X_API_KEY: ${{ secrets.X_API_KEY }}
+          X_API_SECRET: ${{ secrets.X_API_SECRET }}
+        shell: bash
+        run: |
+          args=(
+            --version "${BROWSER_VERSION}"
+            --repo "${REPOSITORY}"
+          )
+
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" && "${{ inputs.announcement_dry_run }}" == "true" ]]; then
+            args+=(--dry-run)
+          fi
+
+          bun run packages/release/src/announce-widget-release.ts "${args[@]}"

apps/facehash-landing/tsconfig.tsbuildinfo

@@ -4,38 +4,68 @@ description: "Script tag embeds, automatic shadcn theming, and AI knowledge clar
 tiny-excerpt: "Script embeds and AI clarification"
 date: "2026-04-20"
 author: "Cossistant Team"
+discord-announcement: |
+  Cossistant v0.2.0 is live.
+  You can now ship the widget with a simple script tag, inherit shadcn theming automatically, and let the AI ask for clarification when knowledge is missing.
+  Read the full changelog: https://cossistant.com/changelog/2026-04-20-v0.2.0
+x-announcement: |
+  Cossistant v0.2.0 is out: script tag embeds, automatic shadcn theming, and AI clarification when knowledge is missing.
+  https://cossistant.com/changelog/2026-04-20-v0.2.0
 ---
 
 Major improvements to widget flexibility with script tag embeds, automatic theme detection, and smarter AI knowledge handling.
 
+<ScreenshotFrame
+  backgroundColor="bg-background-300"
+  backgroundImageSrc=""
+  items={[
+    {
+      alt: "Clarify knowledge gaps",
+      browserUrl: "https://cossistant.com",
+      legend: "Clarify knowledge gaps",
+      src: "https://cdn.cossistant.com/changelog/2026-04-20.png",
+      type: "browser",
+    },
+
+]}
+type="browser"
+/>
+
 ### Highlights
 
 - <HighlightLine variant="new">
-    **Script tag embeds**: Install Cossistant via CDN without React using a simple script tag.
+    **Script tag embeds**: Install Cossistant via CDN without React using a
+    simple script tag.
   </HighlightLine>
 - <HighlightLine variant="new">
-    **Auto shadcn detection**: Widget automatically inherits your shadcn theme variables.
+    **Auto shadcn detection**: Widget automatically inherits your shadcn theme
+    variables.
   </HighlightLine>
 - <HighlightLine variant="new">
-    **Knowledge clarification**: AI asks for clarification when it spots knowledge gaps.
+    **Knowledge clarification**: AI asks for clarification when it spots
+    knowledge gaps.
   </HighlightLine>
 
 ### Support Widget
 
 - <HighlightLine variant="new">
-    **Browser package**: New `@cossistant/browser` package for non-React apps via script tag.
+    **Browser package**: New `@cossistant/browser` package for non-React apps
+    via script tag.
   </HighlightLine>
 - <HighlightLine variant="updated">
-    **Theme detection**: Automatically detects and uses shadcn CSS variables when present.
+    **Theme detection**: Automatically detects and uses shadcn CSS variables
+    when present.
   </HighlightLine>
 - <HighlightLine variant="updated">
-    **Modular core**: Refactored widget architecture for better customization and reusability.
+    **Modular core**: Refactored widget architecture for better customization
+    and reusability.
   </HighlightLine>
 
 ### Dashboard
 
 - <HighlightLine variant="new">
-    **Knowledge clarification requests**: Review and respond to AI knowledge gap requests.
+    **Knowledge clarification requests**: Review and respond to AI knowledge gap
+    requests.
   </HighlightLine>
 - <HighlightLine variant="new">
     **Visitor geolocation**: Enhanced visitor detail pages with location data.
@@ -47,7 +77,8 @@ Major improvements to widget flexibility with script tag embeds, automatic theme
 ### Bug Fixes & Improvements
 
 - <HighlightLine variant="fixed">
-    **AI reliability**: More consistent AI agent responses with improved error handling.
+    **AI reliability**: More consistent AI agent responses with improved error
+    handling.
   </HighlightLine>
 - <HighlightLine variant="fixed">
     **Vite support**: Better compatibility with Vite-based projects.
@@ -62,13 +93,28 @@ Major improvements to widget flexibility with script tag embeds, automatic theme
 npm install @cossistant/react@0.2.0 @cossistant/next@0.2.0
 ```
 
-### Example
+### Use Cossistant with a script tag
+
+Perfect to use outside of React, with Vue, or in tools like Framer and Webflow.
+You can point to a specific version for predictable upgrades, or use `latest`
+to always load the newest release.
 
 ```html showLineNumbers
-<!-- Script tag embed (no React required) -->
-<script 
-  src="https://cdn.cossistant.com/widget/v0.2.0/cossistant.min.js"
-  data-project-id="your-project-id"
-  data-theme="auto"
-></script>
-```
+<!-- Pin to a specific version -->
+<script async src="https://cdn.cossistant.com/widget/0.2.0/loader.js"></script>
+<script>
+  window.Cossistant.init({
+    publicKey: "pk_live_...",
+  });
+</script>
+```
+
+```html showLineNumbers
+<!-- Or always use the latest release -->
+<script async src="https://cdn.cossistant.com/widget/latest/loader.js"></script>
+<script>
+  window.Cossistant.init({
+    publicKey: "pk_live_...",
+  });
+</script>
+```

apps/web/content/changelog/2026-04-20-v0.2.0.mdx

@@ -123,6 +123,8 @@ export const changelog = defineCollections({
 		version: z.string().optional(),
 		description: z.string(),
 		"tiny-excerpt": z.string().optional(),
+		"discord-announcement": z.string().optional(),
+		"x-announcement": z.string().optional(),
 		date: z.string(),
 		author: z.string(),
 	}),

apps/web/source.config.ts

@@ -54,6 +54,8 @@ type ChangelogFrontmatter = {
 	date: string;
 	author: string;
 	"tiny-excerpt"?: string;
+	"discord-announcement"?: string;
+	"x-announcement"?: string;
 };
 
 type BlogTagRegistryEntry = {

apps/web/src/lib/seo-content.ts

@@ -32,6 +32,11 @@
   - `/Users/anthonyriera/code/cossistant-monorepo/README.md`
   - `/Users/anthonyriera/code/cossistant-monorepo/apps/web/content/docs/(root)/what.mdx`
   - `/Users/anthonyriera/code/cossistant-monorepo/apps/web/content/docs/support-component/index.mdx`
+- Cossistant's default fast path is the `<Support />` component, and the widget can be styled through Tailwind-friendly support styles and stable styling hooks
+  - Source:
+    - `/Users/anthonyriera/code/cossistant-monorepo/apps/web/content/docs/support-component/index.mdx`
+    - `/Users/anthonyriera/code/cossistant-monorepo/apps/web/content/docs/quickstart/react.mdx`
+    - `/Users/anthonyriera/code/cossistant-monorepo/packages/react/README.md`
 - Tinybird is explicitly used for:
   - inbox analytics
   - live visitor presence
@@ -111,6 +116,7 @@
 | Cossistant is open source and code-first | `/README.md` and `/apps/web/content/blog/introducing-cossistant.mdx` | verified |
 | Cossistant is API-driven and provides backend infrastructure | `/README.md` | verified |
 | Cossistant offers headless support primitives and custom builds | `/apps/web/content/docs/(root)/what.mdx` and `/apps/web/content/docs/support-component/index.mdx` | verified |
+| Cossistant ships with a `<Support />` component and can be styled with Tailwind or used in more headless ways | `/apps/web/content/docs/support-component/index.mdx`, `/apps/web/content/docs/quickstart/react.mdx`, and `/packages/react/README.md` | verified |
 | Tinybird powers inbox analytics and live visitor presence | `/apps/web/content/docs/self-host/analytics.mdx` | verified |
 | Tinybird endpoints include inbox analytics, online now, visitor presence, and geo presence locations | `/tinybird/README.md` | verified |
 | Frontend Tinybird access uses short-lived JWTs scoped by website and pipe | `/apps/api/src/lib/tinybird-jwt.ts` | verified |

bun.lock

@@ -9,13 +9,15 @@
   "dependencies": {
     "@dotenvx/dotenvx": "^1.51.2",
     "@openrouter/ai-sdk-provider": "^2.5.1",
+    "@xdevplatform/xdk": "^0.5.0",
     "ai": "^6.0.154",
     "commander": "^14.0.0",
     "execa": "^9.6.0",
     "fs-extra": "^11.3.1",
     "kleur": "^4.1.5",
     "ora": "^8.2.0",
     "prompts": "^2.4.2",
+    "yaml": "^2.8.3",
     "zod": "^3.24.1"
   },
   "devDependencies": {
@@ -26,6 +28,7 @@
   },
   "scripts": {
     "release": "bun run src/index.ts",
-    "check-types": "tsc --noEmit --project tsconfig.json"
+    "check-types": "tsc --noEmit --project tsconfig.json",
+    "test": "bun test src"
   }
 }