Skip to content

Commit 31bd6bf

Browse files
authored
Merge pull request #410 from constructive-io/fix/links
Fix/links
2 parents 050f9c4 + 35a2acc commit 31bd6bf

151 files changed

Lines changed: 4169 additions & 8906 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/workflows/run-tests.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: Constructive matrix tests
1+
name: CI tests
22
on:
33
push:
44
branches:
@@ -148,8 +148,8 @@ jobs:
148148

149149
- name: seed app_user
150150
run: |
151-
pnpm --filter @launchql/cli exec node dist/index.js admin-users bootstrap --yes
152-
pnpm --filter @launchql/cli exec node dist/index.js admin-users add --test --yes
151+
pnpm --filter pgpm exec node dist/index.js admin-users bootstrap --yes
152+
pnpm --filter pgpm exec node dist/index.js admin-users add --test --yes
153153
154154
- name: Test ${{ matrix.package }}
155155
run: cd ./${{ matrix.package }} && pnpm test

AGENTS.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# LaunchQL Agent Navigation Guide
1+
# Constructive Agent Navigation Guide
22

3-
This guide helps AI agents quickly navigate and understand the LaunchQL codebase without having to read everything. LaunchQL is a comprehensive full-stack framework for building secure, role-aware GraphQL APIs backed by PostgreSQL databases.
3+
This guide helps AI agents quickly navigate and understand the Constructive codebase without having to read everything. Constructive is a comprehensive full-stack framework for building secure, role-aware GraphQL APIs backed by PostgreSQL databases.
44

55
## 🎯 Quick Start for Agents
66

@@ -12,17 +12,17 @@ This guide helps AI agents quickly navigate and understand the LaunchQL codebase
1212
5. **`packages/types`** - TypeScript type definitions
1313

1414
**Key Classes to Understand:**
15-
- **`LaunchQLPackage`** (`packages/core/src/core/class/launchql.ts`) - Workspace and module management
16-
- **`LaunchQLMigrate`** (`packages/core/src/migrate/client.ts`) - Database migration operations
15+
- **`PgpmPackage`** (`packages/core/src/core/class/pgpm.ts`) - Workspace and module management
16+
- **`PgpmMigrate`** (`packages/core/src/migrate/client.ts`) - Database migration operations
1717

1818
## 📦 Package Categories
1919

2020
### 🏗️ Core Framework
2121
| Package | Purpose | Key Files |
2222
|---------|---------|-----------|
23-
| **`core`** | Main orchestration, migrations, dependency resolution | `src/core/class/launchql.ts`, `src/migrate/client.ts` |
23+
| **`core`** | Main orchestration, migrations, dependency resolution | `src/core/class/pgpm.ts`, `src/migrate/client.ts` |
2424
| **`cli`** | Command-line interface (`lql` command) | `src/commands.ts`, `src/commands/deploy.ts` |
25-
| **`types`** | TypeScript type definitions | `src/launchql.ts` |
25+
| **`types`** | TypeScript type definitions | `src/pgpm.ts` |
2626
| **`env`** | Environment and configuration management | - |
2727

2828
### 🚀 API & Server
@@ -89,8 +89,8 @@ This guide helps AI agents quickly navigate and understand the LaunchQL codebase
8989

9090
## 🔑 Key Classes and Entry Points
9191

92-
### LaunchQLPackage Class
93-
**Location:** `packages/core/src/core/class/launchql.ts`
92+
### PgpmPackage Class
93+
**Location:** `packages/core/src/core/class/pgpm.ts`
9494

9595
**Purpose:** High-level orchestration for workspace and module management
9696

@@ -107,7 +107,7 @@ This guide helps AI agents quickly navigate and understand the LaunchQL codebase
107107
- `getContext()` - Determine if in workspace, module, or outside
108108
- `isInWorkspace()` / `isInModule()` - Context checks
109109

110-
### LaunchQLMigrate Class
110+
### PgpmMigrate Class
111111
**Location:** `packages/core/src/migrate/client.ts`
112112

113113
**Purpose:** Low-level database migration operations
@@ -122,7 +122,7 @@ This guide helps AI agents quickly navigate and understand the LaunchQL codebase
122122

123123
**Configuration:**
124124
- Supports `content` or `ast` hash methods for SQL files
125-
- Configurable via `LaunchQLMigrateOptions`
125+
- Configurable via `PgpmMigrateOptions`
126126

127127
### CLI Command Structure
128128
**Location:** `packages/cli/src/commands.ts`
@@ -150,7 +150,7 @@ export default async (argv: ParsedArgs, prompter: Inquirerer, options: CLIOption
150150
### 1. Module Development Workflow
151151
```typescript
152152
// 1. Initialize workspace
153-
const pkg = new LaunchQLPackage(cwd);
153+
const pkg = new PgpmPackage(cwd);
154154
pkg.initWorkspace();
155155

156156
// 2. Create module
@@ -177,7 +177,7 @@ await db.query('SELECT 1'); // Ready for testing
177177
### 3. Migration Workflow
178178
```typescript
179179
// Direct migration operations
180-
const migrate = new LaunchQLMigrate(pgConfig);
180+
const migrate = new PgpmMigrate(pgConfig);
181181
await migrate.deploy({ modulePath: './my-module' });
182182
await migrate.verify({ modulePath: './my-module' });
183183
```
@@ -187,7 +187,7 @@ await migrate.verify({ modulePath: './my-module' });
187187
### Module Structure
188188
```
189189
my-module/
190-
├── launchql.plan # Migration plan
190+
├── pgpm.plan # Migration plan
191191
├── my-module.control # Extension metadata
192192
├── Makefile # Build configuration
193193
├── deploy/ # Deploy scripts

FOOTER.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -47,18 +47,18 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
4747

4848
### 🔁 Streaming & Uploads
4949

50+
* [etag-hash](https://github.com/constructive-io/constructive/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
51+
* [etag-stream](https://github.com/constructive-io/constructive/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
52+
* [uuid-hash](https://github.com/constructive-io/constructive/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
53+
* [uuid-stream](https://github.com/constructive-io/constructive/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
5054
* [launchql/s3-streamer](https://github.com/constructive-io/constructive/tree/main/packages/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
51-
* [launchql/etag-hash](https://github.com/constructive-io/constructive/tree/main/packages/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
52-
* [launchql/etag-stream](https://github.com/constructive-io/constructive/tree/main/packages/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
53-
* [launchql/uuid-hash](https://github.com/constructive-io/constructive/tree/main/packages/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
54-
* [launchql/uuid-stream](https://github.com/constructive-io/constructive/tree/main/packages/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
5555
* [launchql/upload-names](https://github.com/constructive-io/constructive/tree/main/packages/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
5656

5757
### 🧰 CLI & Codegen
5858

5959
* [pgpm](https://github.com/constructive-io/constructive/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
6060
* [@launchql/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation.
61-
* [constructive-io/constructive-gen](https://github.com/constructive-io/constructive/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
61+
* [launchql-gen](https://github.com/constructive-io/constructive/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
6262
* [@launchql/query-builder](https://github.com/constructive-io/constructive/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.
6363
* [@launchql/query](https://github.com/constructive-io/constructive/tree/main/packages/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
6464

GRAPHQL_ISSUES.md

Lines changed: 0 additions & 109 deletions
This file was deleted.

Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,5 +31,5 @@ openhands:
3131
-v ~/.openhands:/.openhands \
3232
-p 4444:3000 \
3333
--add-host host.docker.internal:host-gateway \
34-
--name launchql-openhands \
34+
--name constructive-openhands \
3535
docker.all-hands.dev/all-hands-ai/openhands:0.44

QUICKSTART.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# 🚀 Quickstart: LaunchQL CLI Basics
22

3+
LaunchQL is different from PGPM in that it ships with a GraphQL server. All commands are the same except pgpm has no explorer/server.
4+
35
### 1. Install the CLI
46

57
Make sure you have the LaunchQL CLI available:

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -288,13 +288,13 @@ This architecture eliminates the traditional ORM layer and API boilerplate, lett
288288

289289
- **[pgpm](https://github.com/constructive-io/constructive/tree/main/packages/pgpm)** - PostgreSQL Package Manager for modular database development with npm-style dependency management
290290
- **[@launchql/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli)** - Full-featured command-line toolkit for LaunchQL projects with scaffolding, migrations, and deployment
291-
- **[@launchql/core](https://github.com/constructive-io/constructive/tree/main/packages/core)** - Core migration engine with module orchestration and dependency resolution
291+
- **[@pgpmjs/core](https://github.com/constructive-io/constructive/tree/main/packages/core)** - Core migration engine with module orchestration and dependency resolution
292292

293293
### 🚀 GraphQL API & Server
294294

295295
- **[@launchql/server](https://github.com/constructive-io/constructive/tree/main/packages/server)** - Express-based API server powered by PostGraphile with RLS integration and JWT authentication
296296
- **[@launchql/explorer](https://github.com/constructive-io/constructive/tree/main/packages/explorer)** - GraphiQL interface for exploring your auto-generated GraphQL API
297-
- **[@launchql/graphile-settings](https://github.com/constructive-io/constructive/tree/main/packages/graphile-settings)** - Centralized PostGraphile plugin configuration with connection filters, PostGIS, and full-text search
297+
- **[graphile-settings](https://github.com/constructive-io/constructive/tree/main/graphile/graphile-settings)** - Centralized PostGraphile plugin configuration with connection filters, PostGIS, and full-text search
298298

299299
### 🧪 Testing & Quality Assurance
300300

__fixtures__/stage/extensions/@pgpm/achievements/README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# @pgpm/achievements
22

33
<p align="center" width="100%">
4-
<img height="250" src="https://raw.githubusercontent.com/launchql/launchql/refs/heads/main/assets/outline-logo.svg" />
4+
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
55
</p>
66

77
<p align="center" width="100%">
8-
<a href="https://github.com/launchql/pgpm-modules/actions/workflows/ci.yml">
9-
<img height="20" src="https://github.com/launchql/pgpm-modules/actions/workflows/ci.yml/badge.svg" />
8+
<a href="https://github.com/constructive-io/pgpm-modules/actions/workflows/ci.yml">
9+
<img height="20" src="https://github.com/constructive-io/pgpm-modules/actions/workflows/ci.yml/badge.svg" />
1010
</a>
11-
<a href="https://github.com/launchql/pgpm-modules/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
12-
<a href="https://www.npmjs.com/package/@pgpm/achievements"><img height="20" src="https://img.shields.io/github/package-json/v/launchql/pgpm-modules?filename=packages%2Fmetrics%2Fachievements%2Fpackage.json"/></a>
11+
<a href="https://github.com/constructive-io/pgpm-modules/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
12+
<a href="https://www.npmjs.com/package/@pgpm/achievements"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/pgpm-modules?filename=packages%2Fmetrics%2Fachievements%2Fpackage.json"/></a>
1313
</p>
1414

1515
Achievement system for tracking user progress and milestones.
@@ -275,13 +275,13 @@ pnpm test
275275

276276
## Related Tooling
277277

278-
* [pgpm](https://github.com/launchql/launchql/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
279-
* [pgsql-test](https://github.com/launchql/launchql/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
280-
* [supabase-test](https://github.com/launchql/launchql/tree/main/packages/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
281-
* [graphile-test](https://github.com/launchql/launchql/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
282-
* [pgsql-parser](https://github.com/launchql/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
283-
* [libpg-query-node](https://github.com/launchql/libpg-query-node): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
284-
* [pg-proto-parser](https://github.com/launchql/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
278+
* [pgpm](https://github.com/constructive-io/constructive/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
279+
* [pgsql-test](https://github.com/constructive-io/constructive/tree/main/packages/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
280+
* [supabase-test](https://github.com/constructive-io/constructive/tree/main/packages/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
281+
* [graphile-test](https://github.com/constructive-io/constructive/tree/main/packages/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
282+
* [pgsql-parser](https://github.com/constructive-io/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
283+
* [libpg-query-node](https://github.com/constructive-io/libpg-query-node): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
284+
* [pg-proto-parser](https://github.com/constructive-io/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
285285

286286
## Disclaimer
287287

__fixtures__/stage/extensions/@pgpm/achievements/package.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,10 +29,10 @@
2929
},
3030
"repository": {
3131
"type": "git",
32-
"url": "https://github.com/launchql/pgpm-modules"
32+
"url": "https://github.com/constructive-io/pgpm-modules"
3333
},
34-
"homepage": "https://github.com/launchql/pgpm-modules",
34+
"homepage": "https://github.com/constructive-io/pgpm-modules",
3535
"bugs": {
36-
"url": "https://github.com/launchql/pgpm-modules/issues"
36+
"url": "https://github.com/constructive-io/pgpm-modules/issues"
3737
}
3838
}

0 commit comments

Comments
 (0)