@soleri/core 2.4.0 → 2.6.0

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

@@ -0,0 +1,46 @@
+/**
+ * PostgreSQL persistence provider (working stub).
+ *
+ * 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.
+ */
+import type { PersistenceProvider, PersistenceParams, RunResult, FtsSearchOptions } from './types.js';
+/**
+ * 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`
+ */
+export declare function translateSql(sql: string, params?: PersistenceParams): {
+    sql: string;
+    values: unknown[];
+};
+/**
+ * PostgreSQL persistence provider.
+ *
+ * Uses pg.Pool for connection management. Created via async factory
+ * `PostgresPersistenceProvider.create()`.
+ */
+export declare class PostgresPersistenceProvider implements PersistenceProvider {
+    readonly backend: "postgres";
+    private pool;
+    private constructor();
+    /**
+     * Async factory. Dynamically imports `pg` (optional dependency).
+     */
+    static create(connectionString: string, poolSize?: number): Promise<PostgresPersistenceProvider>;
+    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;
+    close(): void;
+}
+//# sourceMappingURL=postgres-provider.d.ts.map

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

@@ -0,0 +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,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAUlG,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"}

package/dist/persistence/postgres-provider.js

@@ -0,0 +1,115 @@
+/**
+ * PostgreSQL persistence provider (working stub).
+ *
+ * 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.
+ */
+/**
+ * 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`
+ */
+export function translateSql(sql, params) {
+    let translated = sql.replace(/unixepoch\(\)/gi, 'EXTRACT(EPOCH FROM NOW())::integer');
+    if (!params)
+        return { sql: translated, values: [] };
+    if (Array.isArray(params)) {
+        let idx = 0;
+        translated = translated.replace(/\?/g, () => `$${++idx}`);
+        return { sql: translated, values: params };
+    }
+    // Named params: @name -> $N
+    const values = [];
+    const nameMap = new Map();
+    translated = translated.replace(/@(\w+)/g, (_match, name) => {
+        if (!nameMap.has(name)) {
+            nameMap.set(name, values.length + 1);
+            values.push(params[name]);
+        }
+        return `$${nameMap.get(name)}`;
+    });
+    return { sql: translated, values };
+}
+/**
+ * PostgreSQL persistence provider.
+ *
+ * Uses pg.Pool for connection management. Created via async factory
+ * `PostgresPersistenceProvider.create()`.
+ */
+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;
+    }
+    /**
+     * Async factory. Dynamically imports `pg` (optional dependency).
+     */
+    static async create(connectionString, poolSize = 10) {
+        const { default: pg } = await import('pg');
+        const pool = new pg.Pool({
+            connectionString,
+            max: poolSize,
+            idleTimeoutMillis: 30_000,
+        });
+        return new PostgresPersistenceProvider(pool);
+    }
+    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).');
+    }
+    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).');
+    }
+    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).');
+    }
+    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).');
+    }
+    transaction(fn) {
+        void fn;
+        throw new Error('PostgresPersistenceProvider.transaction() is not yet implemented. ' +
+            'Full PostgreSQL support requires async PersistenceProvider (v7.0).');
+    }
+    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;
+    }
+    close() {
+        if (this.pool) {
+            // Fire-and-forget pool end; sync interface constraint
+            void this.pool.end();
+        }
+    }
+}
+//# sourceMappingURL=postgres-provider.js.map

package/dist/persistence/postgres-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-provider.js","sourceRoot":"","sources":["../../src/persistence/postgres-provider.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,28 @@
+/**
+ * SQLite persistence provider backed by better-sqlite3.
+ *
+ * Supports both positional (array) and named (object) parameters.
+ * Exposes getDatabase() for backward-compat consumers that need the raw db.
+ */
+import Database from 'better-sqlite3';
+import type { PersistenceProvider, PersistenceParams, RunResult, FtsSearchOptions } from './types.js';
+export declare class SQLitePersistenceProvider implements PersistenceProvider {
+    readonly backend: "sqlite";
+    private db;
+    constructor(path?: string);
+    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;
+    close(): void;
+    /**
+     * Escape hatch: get the raw better-sqlite3 Database.
+     * Used by modules that need direct db access (ProjectRegistry, BrainIntelligence, etc.).
+     * @deprecated Use provider methods instead.
+     */
+    getDatabase(): Database.Database;
+}
+//# sourceMappingURL=sqlite-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-provider.d.ts","sourceRoot":"","sources":["../../src/persistence/sqlite-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtG,qBAAa,yBAA0B,YAAW,mBAAmB;IACnE,QAAQ,CAAC,OAAO,EAAG,QAAQ,CAAU;IACrC,OAAO,CAAC,EAAE,CAAoB;gBAElB,IAAI,GAAE,MAAmB;IAUrC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS;IAOvD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,SAAS;IAOxF,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,EAAE;IAO9E,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI9B,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;IA0BN,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS/B,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;CAMjC"}

package/dist/persistence/sqlite-provider.js

@@ -0,0 +1,97 @@
+/**
+ * SQLite persistence provider backed by better-sqlite3.
+ *
+ * Supports both positional (array) and named (object) parameters.
+ * Exposes getDatabase() for backward-compat consumers that need the raw db.
+ */
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+export class SQLitePersistenceProvider {
+    backend = 'sqlite';
+    db;
+    constructor(path = ':memory:') {
+        if (path !== ':memory:')
+            mkdirSync(dirname(path), { recursive: true });
+        this.db = new Database(path);
+        if (path !== ':memory:') {
+            this.db.pragma('cache_size = -64000'); // 64MB
+            this.db.pragma('temp_store = MEMORY');
+            this.db.pragma('mmap_size = 268435456'); // 256MB
+        }
+    }
+    execSql(sql) {
+        this.db.exec(sql);
+    }
+    run(sql, params) {
+        const stmt = this.db.prepare(sql);
+        if (!params)
+            return stmt.run();
+        if (Array.isArray(params))
+            return stmt.run(...params);
+        return stmt.run(params);
+    }
+    get(sql, params) {
+        const stmt = this.db.prepare(sql);
+        if (!params)
+            return stmt.get();
+        if (Array.isArray(params))
+            return stmt.get(...params);
+        return stmt.get(params);
+    }
+    all(sql, params) {
+        const stmt = this.db.prepare(sql);
+        if (!params)
+            return stmt.all();
+        if (Array.isArray(params))
+            return stmt.all(...params);
+        return stmt.all(params);
+    }
+    transaction(fn) {
+        return this.db.transaction(fn)();
+    }
+    ftsSearch(table, query, options) {
+        const ftsTable = `${table}_fts`;
+        const cols = options?.columns?.length ? options.columns.join(', ') : `${table}.*`;
+        const orderBy = options?.orderByRank !== false ? `ORDER BY rank` : '';
+        const limit = options?.limit ? `LIMIT ${options.limit}` : '';
+        const offset = options?.offset ? `OFFSET ${options.offset}` : '';
+        const filterClauses = [];
+        const filterParams = [query];
+        if (options?.filters) {
+            for (const [key, value] of Object.entries(options.filters)) {
+                filterClauses.push(`${table}.${key} = ?`);
+                filterParams.push(value);
+            }
+        }
+        const filterSql = filterClauses.length
+            ? `AND ${filterClauses.join(' AND ')}`
+            : '';
+        const sql = `SELECT ${cols} FROM ${ftsTable} JOIN ${table} ON ${table}.rowid = ${ftsTable}.rowid WHERE ${ftsTable} MATCH ? ${filterSql} ${orderBy} ${limit} ${offset}`;
+        return this.all(sql, filterParams);
+    }
+    ftsRebuild(table) {
+        const ftsTable = `${table}_fts`;
+        try {
+            this.execSql(`INSERT INTO ${ftsTable}(${ftsTable}) VALUES('rebuild')`);
+        }
+        catch {
+            // Graceful degradation: FTS table may not exist
+        }
+    }
+    close() {
+        this.db.close();
+    }
+    /**
+     * Escape hatch: get the raw better-sqlite3 Database.
+     * Used by modules that need direct db access (ProjectRegistry, BrainIntelligence, etc.).
+     * @deprecated Use provider methods instead.
+     */
+    getDatabase() {
+        if (process.env.NODE_ENV !== 'test' && process.env.VITEST !== 'true') {
+            console.warn('SQLitePersistenceProvider.getDatabase() is deprecated. Use provider methods instead.');
+        }
+        return this.db;
+    }
+}
+//# sourceMappingURL=sqlite-provider.js.map

package/dist/persistence/sqlite-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-provider.js","sourceRoot":"","sources":["../../src/persistence/sqlite-provider.ts"],"names":[],"mappings":"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"}

package/dist/persistence/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Abstract persistence layer.
+ *
+ * Decouples Vault (and future modules) from any specific database engine.
+ * The default implementation is SQLitePersistenceProvider (better-sqlite3).
+ */
+export type PersistenceParams = unknown[] | Record<string, unknown>;
+export interface RunResult {
+    changes: number;
+    lastInsertRowid: number | bigint;
+}
+/**
+ * Minimal database provider interface.
+ *
+ * Supports both positional (`?`) and named (`@param`) parameter styles.
+ * Implementations must handle both array and object params.
+ */
+export interface PersistenceProvider {
+    /** Run raw SQL (DDL, multi-statement). No return value. */
+    execSql(sql: string): void;
+    /** Run a parameterized statement (INSERT, UPDATE, DELETE). */
+    run(sql: string, params?: PersistenceParams): RunResult;
+    /** Get a single row. Returns undefined if no match. */
+    get<T = Record<string, unknown>>(sql: string, params?: PersistenceParams): T | undefined;
+    /** Get all matching rows. */
+    all<T = Record<string, unknown>>(sql: string, params?: PersistenceParams): T[];
+    /** Run a function inside a transaction. Commits on success, rolls back on error. */
+    transaction<T>(fn: () => T): T;
+    /** Identifies the backend engine. */
+    readonly backend: 'sqlite' | 'postgres';
+    /** Full-text search abstraction. */
+    ftsSearch<T = Record<string, unknown>>(table: string, query: string, options?: FtsSearchOptions): T[];
+    /** Rebuild FTS index for a table. */
+    ftsRebuild(table: string): void;
+    /** Close the connection. */
+    close(): void;
+}
+export interface PersistenceConfig {
+    type: 'sqlite' | 'postgres';
+    path: string;
+    /** PostgreSQL connection string. */
+    connectionString?: string;
+    /** PostgreSQL pool size. */
+    poolSize?: number;
+}
+export interface FtsSearchOptions {
+    /** Columns to search (default: all FTS columns). */
+    columns?: string[];
+    /** Max results. */
+    limit?: number;
+    /** Skip N results. */
+    offset?: number;
+    /** Additional WHERE conditions on the base table. */
+    filters?: Record<string, unknown>;
+    /** Order by FTS relevance rank (default: true). */
+    orderByRank?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,8DAA8D;IAC9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAExD,uDAAuD;IACvD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,GAAG,SAAS,CAAC;IAEzF,6BAA6B;IAC7B,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,CAAC,EAAE,CAAC;IAE/E,oFAAoF;IACpF,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE/B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC;IAExC,oCAAoC;IACpC,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,CAAC,EAAE,CAAC;IAEtG,qCAAqC;IACrC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC,4BAA4B;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/persistence/types.js

@@ -0,0 +1,8 @@
+/**
+ * Abstract persistence layer.
+ *
+ * Decouples Vault (and future modules) from any specific database engine.
+ * The default implementation is SQLitePersistenceProvider (better-sqlite3).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/persistence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/persistence/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/planning/gap-analysis.d.ts

@@ -1,23 +1,66 @@
 /**
- * 6-pass gap analysis engine for plan grading.
- * Ported from Salvador MCP's plan-gap-content.ts / plan-gap-technical.ts.
+ * Gap analysis engine for plan grading.
+ * Ported from Salvador MCP's plan-gap-content.ts / plan-gap-technical.ts /
+ * plan-gap-domain.ts / plan-gap-antipattern.ts.
  *
- * Passes:
+ * 6 built-in passes (always run):
  *   1. Structure     — required fields present and sufficiently long
  *   2. Completeness  — measurable objectives, decision rationale, scope exclusions
  *   3. Feasibility   — overly broad scope, missing dependency awareness
  *   4. Risk          — breaking changes without mitigation, missing verification
  *   5. Clarity       — ambiguous language, vague criteria
  *   6. Semantic Quality — generic objectives, shallow rationale, non-concrete approach
+ *
+ * Opt-in pass factories (registered via customPasses):
+ *   - createToolFeasibilityPass  — validates tool_chain entries and ordering
+ *   - createFlowAlignmentPass    — validates flow and target_mode against registries
+ *   - createAntiPatternPass      — detects content anti-patterns and vague criteria
  */
 import type { Plan } from './planner.js';
-import type { PlanGap } from './gap-types.js';
+import type { PlanGap, GapSeverity } from './gap-types.js';
 /** A custom gap analysis pass that agents can register. */
 export type GapAnalysisPass = (plan: Plan) => PlanGap[];
 export interface GapAnalysisOptions {
     /** Custom gap analysis passes appended after the 6 built-in passes. */
     customPasses?: GapAnalysisPass[];
 }
+/**
+ * Factory: tool chain feasibility pass.
+ * Validates that tool_chain entries are known and ordering rules are respected.
+ * Ported from Salvador's analyzeToolFeasibility.
+ *
+ * @param validTools - Set of valid tool names for this agent
+ * @param orderingRules - Ordering constraints (e.g., search before create)
+ */
+export declare function createToolFeasibilityPass(validTools: Set<string>, orderingRules?: Array<{
+    before: string;
+    after: string;
+    reason: string;
+}>): GapAnalysisPass;
+/**
+ * Factory: flow and mode alignment pass.
+ * Validates flow and target_mode against known values and intent alignment.
+ * Ported from Salvador's analyzeFlowAlignment.
+ *
+ * @param validFlows - Set of valid flow names for this agent
+ * @param validModes - Set of valid operational modes for this agent
+ * @param intentFlowMap - Maps detected intents to expected flows
+ */
+export declare function createFlowAlignmentPass(validFlows: Set<string>, validModes: Set<string>, intentFlowMap?: Record<string, string[]>): GapAnalysisPass;
+/**
+ * Factory: content anti-pattern pass.
+ * Detects common anti-patterns in plan content.
+ * Ported from Salvador's analyzeContentAntiPatterns.
+ *
+ * @param antiPatterns - Regex patterns to check against approach text
+ * @param mitigationPatterns - Patterns that indicate the plan is already mitigating
+ */
+export declare function createAntiPatternPass(antiPatterns?: Array<{
+    pattern: RegExp;
+    severity: GapSeverity;
+    description: string;
+    recommendation: string;
+}>, mitigationPatterns?: RegExp[]): GapAnalysisPass;
 /**
  * Run all 6 built-in gap analysis passes on a plan, plus any custom passes.
  * Returns a combined list of all gaps found, ordered by pass.

package/dist/planning/gap-analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gap-analysis.d.ts","sourceRoot":"","sources":["../../src/planning/gap-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAA4B,MAAM,gBAAgB,CAAC;AAwcxE,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,EAAE,CAkBlF"}
+{"version":3,"file":"gap-analysis.d.ts","sourceRoot":"","sources":["../../src/planning/gap-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAe,MAAM,gBAAgB,CAAC;AAqfxE,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAOD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,aAAa,CAAC,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,eAAe,CA2CjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACvC,eAAe,CAoEjB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,CAAC,EAAE,KAAK,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,EACF,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,eAAe,CAwDjB;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,EAAE,CAkBlF"}