@soleri/core 2.9.0 → 2.11.0

package/dist/packs/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Knowledge Pack — Types & Manifest Schema
+ *
+ * A knowledge pack is a superset of a plugin: it bundles domain facades,
+ * vault entries, skills, and hooks into one installable unit.
+ *
+ * Directory structure:
+ *   my-pack/
+ *     soleri-pack.json       # manifest (required)
+ *     index.js               # facade builder (optional, like plugins)
+ *     vault/                 # intelligence JSON bundles to seed (optional)
+ *       patterns.json
+ *       anti-patterns.json
+ *     skills/                # skill markdown files (optional)
+ *       review.md
+ *     hooks/                 # hook markdown files (optional)
+ *       no-inline-styles.md
+ */
+import { z } from 'zod';
+export declare const packManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Domains this pack covers */
+    domains: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    /** Minimum engine version required (semver range) */
+    engine: z.ZodOptional<z.ZodString>;
+    /** Pack dependencies (other pack IDs) */
+    dependencies: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    /** Facade definitions (same as plugin manifest) */
+    facades: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        ops: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            auth: z.ZodDefault<z.ZodOptional<z.ZodEnum<["read", "write", "admin"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            auth: "write" | "read" | "admin";
+        }, {
+            name: string;
+            description?: string | undefined;
+            auth?: "write" | "read" | "admin" | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        ops: {
+            name: string;
+            description: string;
+            auth: "write" | "read" | "admin";
+        }[];
+    }, {
+        name: string;
+        ops: {
+            name: string;
+            description?: string | undefined;
+            auth?: "write" | "read" | "admin" | undefined;
+        }[];
+        description?: string | undefined;
+    }>, "many">>>;
+    /** Vault configuration */
+    vault: z.ZodOptional<z.ZodObject<{
+        /** Subdirectory containing intelligence JSON bundles. Default: "vault" */
+        dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        dir: string;
+    }, {
+        dir?: string | undefined;
+    }>>;
+    /** Skills configuration */
+    skills: z.ZodOptional<z.ZodObject<{
+        /** Subdirectory containing skill .md files. Default: "skills" */
+        dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        dir: string;
+    }, {
+        dir?: string | undefined;
+    }>>;
+    /** Hooks configuration */
+    hooks: z.ZodOptional<z.ZodObject<{
+        /** Subdirectory containing hook .md files. Default: "hooks" */
+        dir: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        dir: string;
+    }, {
+        dir?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    domains: string[];
+    dependencies: string[];
+    facades: {
+        name: string;
+        description: string;
+        ops: {
+            name: string;
+            description: string;
+            auth: "write" | "read" | "admin";
+        }[];
+    }[];
+    vault?: {
+        dir: string;
+    } | undefined;
+    hooks?: {
+        dir: string;
+    } | undefined;
+    skills?: {
+        dir: string;
+    } | undefined;
+    engine?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    version: string;
+    description?: string | undefined;
+    vault?: {
+        dir?: string | undefined;
+    } | undefined;
+    hooks?: {
+        dir?: string | undefined;
+    } | undefined;
+    skills?: {
+        dir?: string | undefined;
+    } | undefined;
+    domains?: string[] | undefined;
+    engine?: string | undefined;
+    dependencies?: string[] | undefined;
+    facades?: {
+        name: string;
+        ops: {
+            name: string;
+            description?: string | undefined;
+            auth?: "write" | "read" | "admin" | undefined;
+        }[];
+        description?: string | undefined;
+    }[] | undefined;
+}>;
+export type PackManifest = z.infer<typeof packManifestSchema>;
+export type PackStatus = 'installed' | 'error' | 'uninstalled';
+export interface InstalledPack {
+    id: string;
+    manifest: PackManifest;
+    directory: string;
+    status: PackStatus;
+    error?: string;
+    /** Number of vault entries seeded */
+    vaultEntries: number;
+    /** Skill files found */
+    skills: string[];
+    /** Hook files found */
+    hooks: string[];
+    /** Whether facades were registered via plugin system */
+    facadesRegistered: boolean;
+    installedAt: number;
+}
+export interface InstallResult {
+    id: string;
+    installed: boolean;
+    vaultEntries: number;
+    skills: string[];
+    hooks: string[];
+    facades: number;
+    error?: string;
+}
+export interface ValidateResult {
+    valid: boolean;
+    manifest?: PackManifest;
+    errors: string[];
+    warnings: string[];
+    /** Counts of what would be installed */
+    counts?: {
+        vaultEntries: number;
+        skills: number;
+        hooks: number;
+        facades: number;
+        ops: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/packs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/packs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB;;;;;IAK7B,+BAA+B;;IAE/B,qDAAqD;;IAErD,yCAAyC;;IAEzC,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBnD,0BAA0B;;QAGtB,0EAA0E;;;;;;;IAI9E,2BAA2B;;QAGvB,iEAAiE;;;;;;;IAIrE,0BAA0B;;QAGtB,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAInE,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wDAAwD;IACxD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wCAAwC;IACxC,MAAM,CAAC,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH"}

package/dist/packs/types.js

@@ -0,0 +1,69 @@
+/**
+ * Knowledge Pack — Types & Manifest Schema
+ *
+ * A knowledge pack is a superset of a plugin: it bundles domain facades,
+ * vault entries, skills, and hooks into one installable unit.
+ *
+ * Directory structure:
+ *   my-pack/
+ *     soleri-pack.json       # manifest (required)
+ *     index.js               # facade builder (optional, like plugins)
+ *     vault/                 # intelligence JSON bundles to seed (optional)
+ *       patterns.json
+ *       anti-patterns.json
+ *     skills/                # skill markdown files (optional)
+ *       review.md
+ *     hooks/                 # hook markdown files (optional)
+ *       no-inline-styles.md
+ */
+import { z } from 'zod';
+// =============================================================================
+// MANIFEST SCHEMA
+// =============================================================================
+export const packManifestSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/, 'Pack ID must be lowercase alphanumeric with hyphens'),
+    name: z.string().min(1),
+    version: z.string().regex(/^\d+\.\d+\.\d+$/, 'Version must be semver (x.y.z)'),
+    description: z.string().optional().default(''),
+    /** Domains this pack covers */
+    domains: z.array(z.string()).optional().default([]),
+    /** Minimum engine version required (semver range) */
+    engine: z.string().optional(),
+    /** Pack dependencies (other pack IDs) */
+    dependencies: z.array(z.string()).optional().default([]),
+    /** Facade definitions (same as plugin manifest) */
+    facades: z
+        .array(z.object({
+        name: z.string(),
+        description: z.string().optional().default(''),
+        ops: z.array(z.object({
+            name: z.string(),
+            description: z.string().optional().default(''),
+            auth: z.enum(['read', 'write', 'admin']).optional().default('read'),
+        })),
+    }))
+        .optional()
+        .default([]),
+    /** Vault configuration */
+    vault: z
+        .object({
+        /** Subdirectory containing intelligence JSON bundles. Default: "vault" */
+        dir: z.string().optional().default('vault'),
+    })
+        .optional(),
+    /** Skills configuration */
+    skills: z
+        .object({
+        /** Subdirectory containing skill .md files. Default: "skills" */
+        dir: z.string().optional().default('skills'),
+    })
+        .optional(),
+    /** Hooks configuration */
+    hooks: z
+        .object({
+        /** Subdirectory containing hook .md files. Default: "hooks" */
+        dir: z.string().optional().default('hooks'),
+    })
+        .optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/packs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/packs/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,qDAAqD,CAAC;IAC3F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,gCAAgC,CAAC;IAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,+BAA+B;IAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,qDAAqD;IACrD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,yCAAyC;IACzC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD,mDAAmD;IACnD,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,GAAG,EAAE,CAAC,CAAC,KAAK,CACV,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACpE,CAAC,CACH;KACF,CAAC,CACH;SACA,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,0EAA0E;QAC1E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;KAC5C,CAAC;SACD,QAAQ,EAAE;IACb,2BAA2B;IAC3B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,iEAAiE;QACjE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC7C,CAAC;SACD,QAAQ,EAAE;IACb,0BAA0B;IAC1B,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,+DAA+D;QAC/D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;KAC5C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/persistence/postgres-provider.d.ts

@@ -1,12 +1,19 @@
 /**
- * PostgreSQL persistence provider (working stub).
+ * PostgreSQL persistence provider.
  *
  * Implements PersistenceProvider with pg.Pool. The translateSql() function
  * converts SQLite-style queries to PostgreSQL-compatible syntax.
  *
- * NOTE: PersistenceProvider is synchronous (better-sqlite3 heritage).
- * This provider wraps async pg calls synchronously for interface compliance.
- * Full async provider support is planned for v7.0.
+ * Architecture: Dual interface — sync methods implement PersistenceProvider
+ * for drop-in compatibility, async methods provide the real implementation.
+ *
+ * Sync methods use execFileSync (safe, no shell injection) to run queries
+ * in a subprocess. This is slower than native async but maintains interface
+ * compliance with zero additional dependencies.
+ *
+ * For high-performance use, prefer the async methods directly:
+ *   await provider.queryAsync(sql, params)
+ *   await provider.runAsync(sql, params)
  */
 import type { PersistenceProvider, PersistenceParams, RunResult, FtsSearchOptions } from './types.js';
 /**
@@ -15,6 +22,10 @@ import type { PersistenceProvider, PersistenceParams, RunResult, FtsSearchOption
  * - Converts positional `?` params to `$1, $2, ...`
  * - Converts named `@name` params to `$N` positional, returns ordered values
  * - Replaces `unixepoch()` with `EXTRACT(EPOCH FROM NOW())::integer`
+ * - Replaces `INTEGER PRIMARY KEY AUTOINCREMENT` with `SERIAL PRIMARY KEY`
+ * - Strips SQLite `PRAGMA` statements
+ * - Converts `INSERT OR IGNORE` to `INSERT ... ON CONFLICT DO NOTHING`
+ * - Converts `INSERT OR REPLACE` to PostgreSQL upsert syntax
  */
 export declare function translateSql(sql: string, params?: PersistenceParams): {
     sql: string;
@@ -23,24 +34,48 @@ export declare function translateSql(sql: string, params?: PersistenceParams): {
 /**
  * PostgreSQL persistence provider.
  *
- * Uses pg.Pool for connection management. Created via async factory
- * `PostgresPersistenceProvider.create()`.
+ * Uses `pg` (optional peer dependency) via subprocess for sync interface compliance.
+ * Created via async factory `PostgresPersistenceProvider.create()`.
+ *
+ * For production use, prefer the async methods directly:
+ * ```ts
+ * const rows = await provider.queryAsync('SELECT * FROM entries WHERE domain = $1', ['design']);
+ * ```
  */
 export declare class PostgresPersistenceProvider implements PersistenceProvider {
     readonly backend: "postgres";
+    private connectionString;
     private pool;
+    private inTransaction;
     private constructor();
     /**
      * Async factory. Dynamically imports `pg` (optional dependency).
+     * Verifies connection before returning.
      */
     static create(connectionString: string, poolSize?: number): Promise<PostgresPersistenceProvider>;
+    /**
+     * Create a provider for sync-only use (no pg pool needed).
+     * Uses subprocess execution for all queries.
+     */
+    static createSync(connectionString: string): PostgresPersistenceProvider;
+    /**
+     * Execute a query asynchronously. Returns rows.
+     */
+    queryAsync<T = Record<string, unknown>>(sql: string, values?: unknown[]): Promise<T[]>;
+    /**
+     * Execute a command asynchronously. Returns row count.
+     */
+    runAsync(sql: string, values?: unknown[]): Promise<number>;
     execSql(sql: string): void;
     run(sql: string, params?: PersistenceParams): RunResult;
     get<T = Record<string, unknown>>(sql: string, params?: PersistenceParams): T | undefined;
     all<T = Record<string, unknown>>(sql: string, params?: PersistenceParams): T[];
     transaction<T>(fn: () => T): T;
     ftsSearch<T = Record<string, unknown>>(table: string, query: string, options?: FtsSearchOptions): T[];
-    ftsRebuild(table: string): void;
+    ftsRebuild(_table: string): void;
     close(): void;
+    /** Get the connection string (for diagnostics). */
+    getConnectionString(): string;
+    private execSyncQuery;
 }
 //# sourceMappingURL=postgres-provider.d.ts.map

package/dist/persistence/postgres-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-provider.d.ts","sourceRoot":"","sources":["../../src/persistence/postgres-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,iBAAiB,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAsBpC;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,QAAQ,CAAC,OAAO,EAAG,UAAU,CAAU;IAEvC,OAAO,CAAC,IAAI,CAAM;IAGlB,OAAO;IAIP;;OAEG;WACU,MAAM,CACjB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,SAAK,GACZ,OAAO,CAAC,2BAA2B,CAAC;IAUvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS;IAQvD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,SAAS;IAQxF,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,EAAE;IAQ9E,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAQ9B,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,CAAC,EAAE;IAcN,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,KAAK,IAAI,IAAI;CAMd"}
+{"version":3,"file":"postgres-provider.d.ts","sourceRoot":"","sources":["../../src/persistence/postgres-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,iBAAiB,GACzB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CA2BpC;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,QAAQ,CAAC,OAAO,EAAG,UAAU,CAAU;IACvC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO;IAIP;;;OAGG;WACU,MAAM,CACjB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,SAAK,GACZ,OAAO,CAAC,2BAA2B,CAAC;IAuBvC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,2BAA2B;IAMxE;;OAEG;IACG,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAS5F;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAahE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAc1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS;IASvD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,SAAS;IAMxF,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,EAAE;IAM9E,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAe9B,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,CAAC,EAAE;IA2BN,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,IAAI,IAAI;IAOb,mDAAmD;IACnD,mBAAmB,IAAI,MAAM;IAQ7B,OAAO,CAAC,aAAa;CA0CtB"}

package/dist/persistence/postgres-provider.js

@@ -1,22 +1,42 @@
 /**
- * PostgreSQL persistence provider (working stub).
+ * PostgreSQL persistence provider.
  *
  * Implements PersistenceProvider with pg.Pool. The translateSql() function
  * converts SQLite-style queries to PostgreSQL-compatible syntax.
  *
- * NOTE: PersistenceProvider is synchronous (better-sqlite3 heritage).
- * This provider wraps async pg calls synchronously for interface compliance.
- * Full async provider support is planned for v7.0.
+ * Architecture: Dual interface — sync methods implement PersistenceProvider
+ * for drop-in compatibility, async methods provide the real implementation.
+ *
+ * Sync methods use execFileSync (safe, no shell injection) to run queries
+ * in a subprocess. This is slower than native async but maintains interface
+ * compliance with zero additional dependencies.
+ *
+ * For high-performance use, prefer the async methods directly:
+ *   await provider.queryAsync(sql, params)
+ *   await provider.runAsync(sql, params)
  */
+import { execFileSync } from 'node:child_process';
+// =============================================================================
+// SQL TRANSLATION
+// =============================================================================
 /**
  * Translate SQLite-style SQL to PostgreSQL-compatible SQL.
  *
  * - Converts positional `?` params to `$1, $2, ...`
  * - Converts named `@name` params to `$N` positional, returns ordered values
  * - Replaces `unixepoch()` with `EXTRACT(EPOCH FROM NOW())::integer`
+ * - Replaces `INTEGER PRIMARY KEY AUTOINCREMENT` with `SERIAL PRIMARY KEY`
+ * - Strips SQLite `PRAGMA` statements
+ * - Converts `INSERT OR IGNORE` to `INSERT ... ON CONFLICT DO NOTHING`
+ * - Converts `INSERT OR REPLACE` to PostgreSQL upsert syntax
  */
 export function translateSql(sql, params) {
-    let translated = sql.replace(/unixepoch\(\)/gi, 'EXTRACT(EPOCH FROM NOW())::integer');
+    let translated = sql
+        .replace(/unixepoch\(\)/gi, 'EXTRACT(EPOCH FROM NOW())::integer')
+        .replace(/INTEGER\s+PRIMARY\s+KEY\s+AUTOINCREMENT/gi, 'SERIAL PRIMARY KEY')
+        .replace(/PRAGMA\s+[^;]+;?/gi, '-- pragma removed')
+        .replace(/INSERT\s+OR\s+IGNORE/gi, 'INSERT')
+        .replace(/INSERT\s+OR\s+REPLACE/gi, 'INSERT');
     if (!params)
         return { sql: translated, values: [] };
     if (Array.isArray(params)) {
@@ -36,79 +56,200 @@ export function translateSql(sql, params) {
     });
     return { sql: translated, values };
 }
+// =============================================================================
+// POSTGRESQL PROVIDER
+// =============================================================================
 /**
  * PostgreSQL persistence provider.
  *
- * Uses pg.Pool for connection management. Created via async factory
- * `PostgresPersistenceProvider.create()`.
+ * Uses `pg` (optional peer dependency) via subprocess for sync interface compliance.
+ * Created via async factory `PostgresPersistenceProvider.create()`.
+ *
+ * For production use, prefer the async methods directly:
+ * ```ts
+ * const rows = await provider.queryAsync('SELECT * FROM entries WHERE domain = $1', ['design']);
+ * ```
  */
 export class PostgresPersistenceProvider {
     backend = 'postgres';
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    pool;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    constructor(pool) {
-        this.pool = pool;
+    connectionString;
+    pool = null;
+    inTransaction = false;
+    constructor(connectionString) {
+        this.connectionString = connectionString;
     }
     /**
      * Async factory. Dynamically imports `pg` (optional dependency).
+     * Verifies connection before returning.
      */
     static async create(connectionString, poolSize = 10) {
+        const provider = new PostgresPersistenceProvider(connectionString);
+        // Dynamically import pg and create pool
         const { default: pg } = await import('pg');
-        const pool = new pg.Pool({
+        provider.pool = new pg.Pool({
             connectionString,
             max: poolSize,
             idleTimeoutMillis: 30_000,
         });
-        return new PostgresPersistenceProvider(pool);
+        // Verify connection
+        const client = await provider.pool.connect();
+        await client.query('SELECT 1');
+        client.release();
+        return provider;
+    }
+    /**
+     * Create a provider for sync-only use (no pg pool needed).
+     * Uses subprocess execution for all queries.
+     */
+    static createSync(connectionString) {
+        return new PostgresPersistenceProvider(connectionString);
+    }
+    // ─── Async methods (preferred for performance) ─────────
+    /**
+     * Execute a query asynchronously. Returns rows.
+     */
+    async queryAsync(sql, values) {
+        if (!this.pool)
+            throw new Error('Pool not initialized. Use PostgresPersistenceProvider.create()');
+        const result = await this.pool.query(sql, values);
+        return result.rows;
+    }
+    /**
+     * Execute a command asynchronously. Returns row count.
+     */
+    async runAsync(sql, values) {
+        if (!this.pool)
+            throw new Error('Pool not initialized. Use PostgresPersistenceProvider.create()');
+        const result = await this.pool.query(sql, values);
+        return result.rowCount ?? 0;
     }
+    // ─── Sync PersistenceProvider interface ─────────────────
+    // Uses execFileSync subprocess bridge for sync compliance.
+    // Safe: execFileSync does not use shell (no injection risk).
     execSql(sql) {
-        // Sync wrapper -- logs warning in non-test env
-        // Full async support in v7.0
-        void sql;
-        throw new Error('PostgresPersistenceProvider.execSql() is not yet implemented. ' +
-            'Use SQLitePersistenceProvider for synchronous operations. ' +
-            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
+        const statements = sql
+            .split(';')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0 && !s.startsWith('--'));
+        for (const stmt of statements) {
+            const { sql: pgSql } = translateSql(stmt);
+            if (pgSql.includes('CREATE VIRTUAL TABLE') || pgSql.includes('CREATE TRIGGER'))
+                continue;
+            if (pgSql.trim().startsWith('--'))
+                continue;
+            this.execSyncQuery(pgSql);
+        }
     }
     run(sql, params) {
-        const _translated = translateSql(sql, params);
-        throw new Error('PostgresPersistenceProvider.run() is not yet implemented. ' +
-            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
+        const { sql: pgSql, values } = translateSql(sql, params);
+        const result = this.execSyncQuery(pgSql, values);
+        return {
+            changes: result.rowCount ?? 0,
+            lastInsertRowid: 0,
+        };
     }
     get(sql, params) {
-        const _translated = translateSql(sql, params);
-        throw new Error('PostgresPersistenceProvider.get() is not yet implemented. ' +
-            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
+        const { sql: pgSql, values } = translateSql(sql, params);
+        const result = this.execSyncQuery(pgSql, values);
+        return result.rows?.[0];
     }
     all(sql, params) {
-        const _translated = translateSql(sql, params);
-        throw new Error('PostgresPersistenceProvider.all() is not yet implemented. ' +
-            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
+        const { sql: pgSql, values } = translateSql(sql, params);
+        const result = this.execSyncQuery(pgSql, values);
+        return (result.rows ?? []);
     }
     transaction(fn) {
-        void fn;
-        throw new Error('PostgresPersistenceProvider.transaction() is not yet implemented. ' +
-            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
+        this.execSyncQuery('BEGIN');
+        this.inTransaction = true;
+        try {
+            const result = fn();
+            this.execSyncQuery('COMMIT');
+            this.inTransaction = false;
+            return result;
+        }
+        catch (err) {
+            this.execSyncQuery('ROLLBACK');
+            this.inTransaction = false;
+            throw err;
+        }
     }
     ftsSearch(table, query, options) {
-        const _cols = options?.columns?.length ? options.columns.join(', ') : '*';
-        const _limit = options?.limit ?? 50;
-        const _offset = options?.offset ?? 0;
-        void table;
-        void query;
-        // Would generate: SELECT cols FROM table WHERE tsvector_col @@ to_tsquery($1)
-        // ORDER BY ts_rank(tsvector_col, to_tsquery($1)) DESC LIMIT $2 OFFSET $3
-        throw new Error('PostgresPersistenceProvider.ftsSearch() is not yet implemented. ' +
-            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
-    }
-    ftsRebuild(table) {
-        // Would run: REINDEX INDEX idx_{table}_fts
-        void table;
+        const limit = options?.limit ?? 50;
+        const offset = options?.offset ?? 0;
+        const filters = options?.filters ?? {};
+        const values = [query];
+        let paramIdx = 2;
+        const filterClauses = [];
+        for (const [key, value] of Object.entries(filters)) {
+            filterClauses.push(`${key} = $${paramIdx}`);
+            values.push(value);
+            paramIdx++;
+        }
+        const whereExtra = filterClauses.length > 0 ? `AND ${filterClauses.join(' AND ')}` : '';
+        const orderClause = options?.orderByRank !== false
+            ? "ORDER BY ts_rank(to_tsvector('english', COALESCE(title,'') || ' ' || COALESCE(description,'')), plainto_tsquery('english', $1)) DESC"
+            : '';
+        const sql = `SELECT * FROM ${table} WHERE to_tsvector('english', COALESCE(title,'') || ' ' || COALESCE(description,'')) @@ plainto_tsquery('english', $1) ${whereExtra} ${orderClause} LIMIT $${paramIdx} OFFSET $${paramIdx + 1}`;
+        values.push(limit, offset);
+        const result = this.execSyncQuery(sql, values);
+        return (result.rows ?? []);
+    }
+    ftsRebuild(_table) {
+        // PostgreSQL GIN indexes are maintained automatically
     }
     close() {
         if (this.pool) {
-            // Fire-and-forget pool end; sync interface constraint
             void this.pool.end();
+            this.pool = null;
+        }
+    }
+    /** Get the connection string (for diagnostics). */
+    getConnectionString() {
+        return this.connectionString;
+    }
+    // ─── Sync subprocess bridge ────────────────────────────
+    // Uses execFileSync (no shell, safe from injection).
+    // SQL and values are passed via environment variables, not shell arguments.
+    execSyncQuery(sql, values) {
+        // Build a Node.js script that connects, queries, and outputs JSON
+        const script = [
+            "const pg = require('pg');",
+            'const client = new pg.Client({ connectionString: process.env.PG_CONN });',
+            '(async () => {',
+            '  await client.connect();',
+            '  try {',
+            '    const result = await client.query(',
+            `      ${JSON.stringify(sql)},`,
+            "      JSON.parse(process.env.PG_VALUES || '[]')",
+            '    );',
+            '    process.stdout.write(JSON.stringify({',
+            '      rows: result.rows || [],',
+            '      rowCount: result.rowCount || 0',
+            '    }));',
+            '  } finally {',
+            '    await client.end();',
+            '  }',
+            '})().catch(err => {',
+            '  process.stderr.write(err.message);',
+            '  process.exit(1);',
+            '});',
+        ].join('\n');
+        try {
+            // execFileSync with array args — no shell, safe from injection
+            const output = execFileSync('node', ['-e', script], {
+                encoding: 'utf-8',
+                timeout: 30_000,
+                env: {
+                    ...process.env,
+                    PG_CONN: this.connectionString,
+                    PG_VALUES: JSON.stringify(values ?? []),
+                },
+            });
+            return JSON.parse(output || '{"rows":[],"rowCount":0}');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`PostgreSQL query failed: ${msg}`, { cause: err });
         }
     }
 }