Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This guide helps AI agents quickly navigate the Constructive monorepo. Construct
- **`streaming/*`** – S3 helpers and stream hashing utilities
- **`extensions/*`** – PGPM extension modules (Postgres extensions packaged as PGPM modules)
- **`graphile/*`** – Graphile/PostGraphile plugins (kept under their own namespace)
- **`jobs/*`**, **`functions/*`** – supporting systems and examples
- **`jobs/*`** – job scheduler/worker (deprecated; function workloads have moved to the `constructive-functions` repo)

## Entry Points

Expand Down
7 changes: 4 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,14 +70,13 @@ React Query Hooks or Prisma-like ORM Client
| `postgres/` | PostgreSQL utilities - introspection, testing (pgsql-test), seeding, AST, query context |
| `packages/` | Shared utilities - CLI (`cnc`), ORM base, query builder, server utils, client |
| `uploads/` | File streaming - S3/MinIO, ETags, content-type detection, UUID hashing |
| `jobs/` | Knative job scheduling - worker, scheduler, service, functions |
| `functions/` | Knative cloud functions (e.g., send-verification-link, send-email) |
| `jobs/` | Knative job scheduling - worker, scheduler, service (deprecated: function workloads have moved to the `constructive-functions` repo; this directory will be removed in a follow-up) |

### Key Packages & CLIs

**`pgpm` CLI** (`pgpm/cli`) - PostgreSQL Package Manager. Commands: `init`, `add`, `deploy`, `revert`, `verify`, `plan`, `install`, `export`, `docker`, `dump`, `tag`. Manages SQL migrations in Sqitch-compatible format with dependency resolution.

**`cnc` CLI** (`packages/cli`, binary: `cnc` or `constructive`) - Full dev toolkit. Commands: `server` (start PostGraphile), `explorer` (GraphiQL UI), `codegen` (generate SDK), `get-graphql-schema`, `jobs`, `context`, `auth`, `execute`.
**`cnc` CLI** (`packages/cli`, binary: `cnc` or `constructive`) - Full dev toolkit. Commands: `server` (start PostGraphile), `explorer` (GraphiQL UI), `codegen` (generate SDK), `get-graphql-schema`, `context`, `auth`, `execute`.

**`graphql/codegen`** - Generates type-safe clients from GraphQL schema or endpoint:
- `--react-query` mode: TanStack Query v5 hooks with query key factories
Expand Down Expand Up @@ -115,6 +114,8 @@ test('example', async () => {

Background jobs use Knative: jobs are added to `app_jobs.jobs` table → `knative-job-worker` polls and picks up → POSTs to Knative function URL → function executes (e.g., send email) → returns status.

**Note:** Function implementations (`send-email`, `send-verification-link`, etc.) now live in the dedicated [`constructive-functions`](https://github.com/constructive-io/constructive-functions) repository under `functions/<name>/handler.ts`. The `functions/` directory previously hosted here has been removed; the `jobs/` directory is on the same deprecation path and will follow once the hub-side job-server cutover lands.

### Database Configuration

Tests require PostgreSQL. Standard PG env vars:
Expand Down
50 changes: 0 additions & 50 deletions docker/functions/send-email.Dockerfile

This file was deleted.

194 changes: 0 additions & 194 deletions functions/send-email/CHANGELOG.md

This file was deleted.

106 changes: 0 additions & 106 deletions functions/send-email/README.md

This file was deleted.

Loading
Loading