docs: add use cases tutorials for AI workflows #392

jumski · 2025-11-18T09:28:00Z

Add new tutorial section covering common AI patterns:

Automatic embeddings with database triggers
Structured output using Zod schemas
RAG pipeline with query transformation and reranking
Chatbot with parallel history and knowledge retrieval

All tutorials demonstrate proper pgflow DSL patterns with
factual, working examples using AI SDK and standard libraries.

changeset-bot · 2025-11-18T09:28:04Z

⚠️ No Changeset found

Latest commit: 83bc3bd

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

jumski · 2025-11-18T09:28:17Z

docs: add use cases tutorials for AI workflows #392 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

nx-cloud · 2025-11-18T09:29:13Z

View your CI Pipeline Execution ↗ for commit 83bc3bd

Command	Status	Duration	Result
`nx run edge-worker:test:integration`	✅ Succeeded	4m 25s	View ↗
`nx affected -t verify-exports --base=origin/mai...`	✅ Succeeded	3s	View ↗
`nx affected -t build --configuration=production...`	✅ Succeeded	3s	View ↗
`nx affected -t lint typecheck test --parallel -...`	✅ Succeeded	2m 21s	View ↗
`nx run cli:e2e`	✅ Succeeded	4s	View ↗
`nx run client:e2e`	✅ Succeeded	1m 8s	View ↗
`nx run edge-worker:e2e`	✅ Succeeded	39s	View ↗
`nx run core:pgtap`	✅ Succeeded	<1s	View ↗

☁️ Nx Cloud last updated this comment at 2025-12-18 16:14:32 UTC

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2025-11-18T09:31:40Z

CLAUDE.md

@@ -0,0 +1 @@
+/home/jumski/Code/pgflow-dev/claude/source/CLAUDE.md


Replace broken absolute CLAUDE symlink

CLAUDE.md is committed as a symlink to /home/jumski/Code/pgflow-dev/claude/source/CLAUDE.md, which only exists on the author’s machine. In any other checkout the target is missing, leaving the doc unreadable and leaking a local path, so any process expecting this file will fail; the link should be made relative or the actual content checked in.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2025-11-18T09:31:41Z

pkgs/website/src/content/docs/tutorials/use-cases/rag-pipeline.mdx

+-- Create index for faster similarity search
+create index on documents using ivfflat (embedding vector_cosine_ops);


Add ivfflat list count to documents index

The RAG pipeline schema creates an IVFFLAT index without specifying the required WITH (lists = ...) option (create index on documents using ivfflat (embedding vector_cosine_ops);). pgvector rejects this statement with “missing required parameter lists”, so running the migration as written will fail and the tutorial cannot be followed until a list count is provided.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2025-11-18T09:31:41Z

pkgs/website/src/content/docs/tutorials/use-cases/chatbot.mdx

+);
+
+create index on knowledge_base using ivfflat (embedding vector_cosine_ops);


Specify lists for knowledge base IVFFLAT index

The chatbot schema also creates an IVFFLAT index without the mandatory WITH (lists = ...) parameter (create index on knowledge_base using ivfflat ...). PostgreSQL/pgvector will error with “missing required parameter lists”, preventing users from applying the migration or running the tutorial; the index needs an explicit list count.

Useful? React with 👍 / 👎.

Add new tutorial section covering common AI patterns: - Automatic embeddings with database triggers - Structured output using Zod schemas - RAG pipeline with query transformation and reranking - Chatbot with parallel history and knowledge retrieval All tutorials demonstrate proper pgflow DSL patterns with factual, working examples using AI SDK and standard libraries.

jumski · 2025-12-18T16:14:22Z

Merge activity

Dec 18, 4:14 PM UTC: A user started a stack merge that includes this pull request via Graphite.
Dec 18, 4:14 PM UTC: @jumski merged this pull request with Graphite.

github-actions · 2025-12-18T16:17:17Z

🔍 Preview Deployment: Website

✅ Deployment successful!

🔗 Preview URL: https://pr-392.pgflow.pages.dev

📝 Details:

Branch: claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC
Commit: b1595b4194ed932c26e266dbd3259d8751a93e1c
View Logs

_Last updated: _

chatgpt-codex-connector bot reviewed Nov 18, 2025

View reviewed changes

jumski temporarily deployed to preview November 19, 2025 04:47 — with GitHub Actions Inactive

jumski force-pushed the claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC branch from 843cc1b to 9750eff Compare November 19, 2025 10:20

jumski temporarily deployed to preview November 19, 2025 10:30 — with GitHub Actions Inactive

jumski force-pushed the claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC branch from 9750eff to 62aac2a Compare November 26, 2025 13:06

jumski temporarily deployed to preview November 26, 2025 13:15 — with GitHub Actions Inactive

jumski force-pushed the claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC branch 5 times, most recently from d400ef5 to ee999b9 Compare December 18, 2025 15:21

jumski had a problem deploying to preview December 18, 2025 15:30 — with GitHub Actions Failure

jumski force-pushed the claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC branch from ee999b9 to 45e1651 Compare December 18, 2025 15:30

jumski had a problem deploying to preview December 18, 2025 15:39 — with GitHub Actions Failure

jumski force-pushed the claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC branch from 45e1651 to a04deab Compare December 18, 2025 15:54

jumski force-pushed the claude/add-use-cases-tutorials-011CUrzyLUcAZQ8EY4BCi1eC branch from a04deab to 83bc3bd Compare December 18, 2025 15:59

jumski temporarily deployed to preview December 18, 2025 16:14 — with GitHub Actions Inactive

jumski merged commit afe9e85 into main Dec 18, 2025
16 of 25 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: add use cases tutorials for AI workflows #392

docs: add use cases tutorials for AI workflows #392

Uh oh!

jumski commented Nov 18, 2025

Uh oh!

changeset-bot bot commented Nov 18, 2025 •

edited

Loading

Uh oh!

jumski commented Nov 18, 2025 •

edited

Loading

Uh oh!

nx-cloud bot commented Nov 18, 2025 •

edited

Loading

Uh oh!

chatgpt-codex-connector bot left a comment

Uh oh!

chatgpt-codex-connector bot Nov 18, 2025

Uh oh!

chatgpt-codex-connector bot Nov 18, 2025

Uh oh!

chatgpt-codex-connector bot Nov 18, 2025

Uh oh!

jumski commented Dec 18, 2025 •

edited

Loading

Uh oh!

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -0,0 +1 @@
		/home/jumski/Code/pgflow-dev/claude/source/CLAUDE.md No newline at end of file

		-- Create index for faster similarity search
		create index on documents using ivfflat (embedding vector_cosine_ops);

		);

		create index on knowledge_base using ivfflat (embedding vector_cosine_ops);

docs: add use cases tutorials for AI workflows #392

docs: add use cases tutorials for AI workflows #392

Uh oh!

Conversation

jumski commented Nov 18, 2025

Uh oh!

changeset-bot bot commented Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

jumski commented Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nx-cloud bot commented Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Nov 18, 2025

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot Nov 18, 2025

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot Nov 18, 2025

Choose a reason for hiding this comment

Uh oh!

jumski commented Dec 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merge activity

Uh oh!

Uh oh!

github-actions bot commented Dec 18, 2025

🔍 Preview Deployment: Website

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot bot commented Nov 18, 2025 •

edited

Loading

jumski commented Nov 18, 2025 •

edited

Loading

nx-cloud bot commented Nov 18, 2025 •

edited

Loading

jumski commented Dec 18, 2025 •

edited

Loading