@owlmeans/postgres 0.1.15 → 0.1.16

package/README.md

@@ -124,10 +124,9 @@ Extends `PostgresDbService` from `@owlmeans/postgres-resource`:
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
 
-This package ships embedded Claude Code skills and GitHub Copilot instructions under
-`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
-agent-skills installer to place them into your project's native locations
-(`.claude/skills/` and `.github/instructions/`):
+This package ships embedded agent skills under `agent-meta/`. After installing your
+`@owlmeans/*` packages, run the OwlMeans agent-skills installer to place them into
+your project's skill store (`.agents/skills/`):
 
 ```sh
 npx @owlmeans/agent-skills

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
-  "schemaVersion": 1,
+  "schemaVersion": 2,
   "package": "@owlmeans/postgres",
-  "version": "0.1.15",
-  "generatedAt": "2026-08-07T18:11:56.992Z",
+  "version": "0.1.16",
+  "generatedAt": "2026-08-14T10:14:48.861Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {
@@ -10,14 +10,7 @@
       "name": "postgres",
       "category": "package-specific",
       "file": "skills/postgres/SKILL.md",
-      "canonicalPath": ".claude/skills/postgres/SKILL.md"
-    },
-    {
-      "kind": "instruction",
-      "name": "postgres",
-      "category": "package-specific",
-      "file": "instructions/postgres.instructions.md",
-      "canonicalPath": ".github/instructions/postgres.instructions.md"
+      "canonicalPath": ".agents/skills/postgres/SKILL.md"
     }
   ]
 }

package/agent-meta/skills/postgres/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/postgres
 
 **Layer:** Infra
-**Install:** `"@owlmeans/postgres": "^0.1.15"` in `dependencies`
+**Install:** `"@owlmeans/postgres": "^0.1.16"` in `dependencies`
 
 Pooled `pg` connections for a server context, plus the admin path that provisions the role, database
 and schema an app connects with. All DDL for application tables belongs to [[postgres-resource]] —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/postgres",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,17 +22,17 @@
     }
   },
   "dependencies": {
-    "@owlmeans/basic-keys": "^0.1.15",
-    "@owlmeans/context": "^0.1.15",
-    "@owlmeans/postgres-resource": "^0.1.15",
-    "@owlmeans/resource": "^0.1.15",
-    "@owlmeans/server-context": "^0.1.15",
+    "@owlmeans/basic-keys": "^0.1.16",
+    "@owlmeans/context": "^0.1.16",
+    "@owlmeans/postgres-resource": "^0.1.16",
+    "@owlmeans/resource": "^0.1.16",
+    "@owlmeans/server-context": "^0.1.16",
     "drizzle-orm": "~0.45.2",
     "pg": "^8.22.0"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-integration": "^0.1.15",
+    "@owlmeans/test-integration": "^0.1.16",
     "@types/bun": "^1.3.14",
     "@types/node": "^26.1.0",
     "@types/pg": "^8.20.4",

package/agent-meta/instructions/postgres.instructions.md

@@ -1,57 +0,0 @@
----
-description: "How to use @owlmeans/postgres — PostgreSQL connection service (makePostgresDbService / appendPostgres) registered on a server context, plus the least-privilege bootstrap admin path."
-applyTo: "**/context.ts, **/config.ts, **/*.ts, **/*.tsx"
----
-<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
-
-# @owlmeans/postgres
-
-**Layer:** Infra
-**Install:** `"@owlmeans/postgres": "^0.1.15"` in `dependencies`
-
-## Key Exports
-
-| Export | Description |
-|--------|-------------|
-| `makePostgresDbService(alias?)` | PostgreSQL connection service factory |
-| `appendPostgres(context, alias?)` | Registers the service **and** its drain middleware |
-| `PostgresService`, `BootstrapOptions`, `BootstrapReport` | Service contract and the admin path |
-| `bootstrapDb`, `drainMiddleware`, `parseUrl`, `prepareConfig`, `probe`, `ensureSchema` | Helpers |
-| `DEFAULT_ALIAS` (`'postgres'`), `DEF_ADMIN_ALIAS` (`'pg-admin'`), `DEF_POOL_SIZE`, `DEF_RETRIES` | Constants |
-
-## Usage
-
-```typescript
-import { appendPostgres } from '@owlmeans/postgres'
-appendPostgres<C, T>(context)
-
-cfg.dbs = [{
-  service: 'postgres', alias: 'postgres',
-  host: '/etc/app-config/pg-host', user: '/etc/app-config/pg-role-name',
-  secret: '/etc/master-secret/pg-app-password',
-  schema: 'app', meta: { database: '/etc/app-config/pg-db-name' }
-}]
-```
-
-## Rules
-
-- Use `appendPostgres`, not a bare `registerService` — the drain middleware is half the wiring.
-- `DbConfig.schema` is the Postgres **SCHEMA** (layer-suffixed by `dbName()`); the **DATABASE** is
-  `meta.database` and is never suffixed. `meta.url` accepts a whole connection string and wins over
-  `host`/`user`/`secret`. A value starting with `/` is read as a file.
-- `init()` already probes readiness (`SELECT 1`, 30×2s) and creates the schema — do not hand-roll a
-  retry loop. Auth / missing-database / permission codes fail fast instead of retrying.
-- Keep the pool small; `max_connections` is a cluster-wide cap, so an oversized pool starves other
-  clients. Default `DEF_POOL_SIZE` is 10.
-- All application-table DDL belongs to `@owlmeans/postgres-resource`. This service only creates the
-  schema.
-- Superuser credentials go under a **separate** config alias (`pg-admin`), never the app's own entry.
-- `bootstrap()` is idempotent and replaces hand-written `CREATE ROLE` / `CREATE DATABASE` / `GRANT`
-  SQL. If such SQL exists in a deployment script or doc, collapse it into a `bootstrap()` call.
-- Use `defer()` for work that depends on another resource being initialized (foreign keys); it is
-  drained by the middleware once the context is up.
-
-## Depends On
-
-- `@owlmeans/postgres-resource`, `@owlmeans/resource`, `@owlmeans/context`,
-  `@owlmeans/server-context`, `@owlmeans/basic-keys`, `pg`, `drizzle-orm`