@lumifai/harness-tool-pack-postgres 0.0.1 → 0.1.0

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@lumifai/harness-tool-pack-postgres",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lumif-ai/lumif-harness.git",
+    "directory": "packages/tool-packs/postgres"
+  },
   "engines": {
     "node": ">=22.13.0"
   },
@@ -22,12 +27,12 @@
     "skills"
   ],
   "dependencies": {
+    "@lumifai/harness-tool-packs": "0.1.0",
     "@mastra/core": "1.50.1",
     "csv-parse": "^7.0.0",
     "pg": "^8.16.3",
     "pg-cursor": "^2.21.0",
-    "pg-sql2": "^5.0.1",
-    "@lumifai/harness-tool-packs": "0.0.1"
+    "pg-sql2": "^5.0.1"
   },
   "devDependencies": {
     "@types/pg": "^8.15.5",

package/skills/postgres-write/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: postgres-write
+description: Deterministic PostgreSQL insert and update tools that read JSON from the workspace
+version: 1.1.0
+tags:
+  - database
+  - postgres
+  - write
+---
+
+# PostgreSQL Write Tools
+
+Use the `postgres` tool pack to persist workspace JSON files into PostgreSQL deterministically.
+Pair these tools with the `postgres` discovery workflow before unfamiliar tables.
+
+These tools do **not** run arbitrary SQL. Boot config must set `allowedTables` (and optionally `allowedColumns`).
+
+## Tools
+
+| Tool                        | Purpose                                     |
+| --------------------------- | ------------------------------------------- |
+| `postgres_insert_from_file` | JSON file → `INSERT` rows (optional upsert) |
+| `postgres_update_from_file` | JSON patch → `UPDATE` one row               |
+
+## Insert file format
+
+Path is **workspace-relative** (no leading `/`), e.g. `campaigns/123/brief.json`.
+
+Single row:
+
+```json
+{
+  "id": "campaign-123",
+  "name": "Fintech outreach",
+  "metadata": { "region": "US" }
+}
+```
+
+Multiple rows (every row must have the **same keys**):
+
+```json
+[
+  { "id": "c1", "name": "Campaign A", "metadata": {} },
+  { "id": "c2", "name": "Campaign B", "metadata": {} }
+]
+```
+
+Tool args:
+
+- `conflictColumns` — e.g. `["id"]` for idempotent saves
+- `onConflict` — `ignore` (default when conflictColumns set) or `update` (upsert non-key columns)
+
+Empty arrays are rejected.
+
+## Update file format
+
+Flat object — **only columns to change**:
+
+```json
+{
+  "name": "Updated campaign name",
+  "metadata": { "region": "EU", "status": "confirmed" }
+}
+```
+
+Lookup via tool args (not in the file):
+
+- `whereColumn` — defaults to `id`
+- `whereValue` — required unless `resolveWhereValue` is configured at server boot
+
+## Workflow
+
+1. Optionally inspect the table with `postgres_describe_table`.
+2. Write JSON to the workspace (`write_file`).
+3. Call `postgres_insert_from_file` or `postgres_update_from_file`.
+
+## Safety rules
+
+- Only write to tables/columns allowed in boot config.
+- Do not include the lookup column in update JSON files.
+- Writes require user approval by default.