postgresai 0.12.0-beta.6 → 0.14.0-dev.7

package/dist/lib/init.js

@@ -0,0 +1,359 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskConnectionString = maskConnectionString;
+exports.parseLibpqConninfo = parseLibpqConninfo;
+exports.describePgConfig = describePgConfig;
+exports.resolveAdminConnection = resolveAdminConnection;
+exports.promptHidden = promptHidden;
+exports.resolveMonitoringPassword = resolveMonitoringPassword;
+exports.buildInitPlan = buildInitPlan;
+exports.applyInitPlan = applyInitPlan;
+const readline = __importStar(require("readline"));
+const url_1 = require("url");
+function quoteIdent(ident) {
+    // Always quote. Escape embedded quotes by doubling.
+    return `"${ident.replace(/"/g, "\"\"")}"`;
+}
+function maskConnectionString(dbUrl) {
+    // Hide password if present (postgresql://user:pass@host/db).
+    try {
+        const u = new url_1.URL(dbUrl);
+        if (u.password)
+            u.password = "*****";
+        return u.toString();
+    }
+    catch {
+        return dbUrl.replace(/\/\/([^:/?#]+):([^@/?#]+)@/g, "//$1:*****@");
+    }
+}
+function isLikelyUri(value) {
+    return /^postgres(ql)?:\/\//i.test(value.trim());
+}
+function tokenizeConninfo(input) {
+    const s = input.trim();
+    const tokens = [];
+    let i = 0;
+    const isSpace = (ch) => ch === " " || ch === "\t" || ch === "\n" || ch === "\r";
+    while (i < s.length) {
+        while (i < s.length && isSpace(s[i]))
+            i++;
+        if (i >= s.length)
+            break;
+        let tok = "";
+        let inSingle = false;
+        while (i < s.length) {
+            const ch = s[i];
+            if (!inSingle && isSpace(ch))
+                break;
+            if (ch === "'" && !inSingle) {
+                inSingle = true;
+                i++;
+                continue;
+            }
+            if (ch === "'" && inSingle) {
+                inSingle = false;
+                i++;
+                continue;
+            }
+            if (ch === "\\" && i + 1 < s.length) {
+                tok += s[i + 1];
+                i += 2;
+                continue;
+            }
+            tok += ch;
+            i++;
+        }
+        tokens.push(tok);
+        while (i < s.length && isSpace(s[i]))
+            i++;
+    }
+    return tokens;
+}
+function parseLibpqConninfo(input) {
+    const tokens = tokenizeConninfo(input);
+    const cfg = {};
+    for (const t of tokens) {
+        const eq = t.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = t.slice(0, eq).trim();
+        const rawVal = t.slice(eq + 1);
+        const val = rawVal.trim();
+        if (!key)
+            continue;
+        switch (key) {
+            case "host":
+                cfg.host = val;
+                break;
+            case "port": {
+                const p = Number(val);
+                if (Number.isFinite(p))
+                    cfg.port = p;
+                break;
+            }
+            case "user":
+                cfg.user = val;
+                break;
+            case "password":
+                cfg.password = val;
+                break;
+            case "dbname":
+            case "database":
+                cfg.database = val;
+                break;
+            // ignore everything else (sslmode, options, application_name, etc.)
+            default:
+                break;
+        }
+    }
+    return cfg;
+}
+function describePgConfig(cfg) {
+    if (cfg.connectionString)
+        return maskConnectionString(cfg.connectionString);
+    const user = cfg.user ? cfg.user : "<user>";
+    const host = cfg.host ? cfg.host : "<host>";
+    const port = cfg.port ? String(cfg.port) : "<port>";
+    const db = cfg.database ? cfg.database : "<db>";
+    // Don't include password
+    return `postgresql://${user}:*****@${host}:${port}/${db}`;
+}
+function resolveAdminConnection(opts) {
+    const conn = (opts.conn || "").trim();
+    const dbUrlFlag = (opts.dbUrlFlag || "").trim();
+    const hasPsqlParts = !!(opts.host || opts.port || opts.username || opts.dbname || opts.adminPassword || opts.envPassword);
+    if (conn && dbUrlFlag) {
+        throw new Error("Provide either positional connection string or --db-url, not both");
+    }
+    if (conn || dbUrlFlag) {
+        const v = conn || dbUrlFlag;
+        if (isLikelyUri(v)) {
+            return { clientConfig: { connectionString: v }, display: maskConnectionString(v) };
+        }
+        // libpq conninfo (dbname=... host=...)
+        const cfg = parseLibpqConninfo(v);
+        if (opts.envPassword && !cfg.password)
+            cfg.password = opts.envPassword;
+        return { clientConfig: cfg, display: describePgConfig(cfg) };
+    }
+    if (!hasPsqlParts) {
+        throw new Error("Connection is required. Provide a connection string/conninfo as a positional arg, or use --db-url, or use -h/-p/-U/-d.");
+    }
+    const cfg = {};
+    if (opts.host)
+        cfg.host = opts.host;
+    if (opts.port !== undefined && opts.port !== "")
+        cfg.port = Number(opts.port);
+    if (opts.username)
+        cfg.user = opts.username;
+    if (opts.dbname)
+        cfg.database = opts.dbname;
+    if (opts.adminPassword)
+        cfg.password = opts.adminPassword;
+    if (opts.envPassword && !cfg.password)
+        cfg.password = opts.envPassword;
+    return { clientConfig: cfg, display: describePgConfig(cfg) };
+}
+async function promptHidden(prompt) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: true,
+    });
+    // Mask input by overriding internal write method.
+    const anyRl = rl;
+    const out = process.stdout;
+    anyRl._writeToOutput = (str) => {
+        // Keep newlines and carriage returns; mask everything else.
+        if (str === "\n" || str === "\r\n") {
+            out.write(str);
+        }
+        else {
+            out.write("*");
+        }
+    };
+    try {
+        const answer = await new Promise((resolve) => rl.question(prompt, resolve));
+        // Ensure we end the masked line cleanly.
+        process.stdout.write("\n");
+        return answer;
+    }
+    finally {
+        rl.close();
+    }
+}
+async function resolveMonitoringPassword(opts) {
+    const fromFlag = (opts.passwordFlag || "").trim();
+    if (fromFlag)
+        return fromFlag;
+    const fromEnv = (opts.passwordEnv || "").trim();
+    if (fromEnv)
+        return fromEnv;
+    if (!process.stdin.isTTY) {
+        throw new Error("Monitoring user password is required in non-interactive mode (use --password or PGAI_MON_PASSWORD)");
+    }
+    const prompter = opts.prompt || promptHidden;
+    while (true) {
+        const pw = (await prompter(`Enter password for monitoring user ${opts.monitoringUser}: `)).trim();
+        if (pw)
+            return pw;
+        // eslint-disable-next-line no-console
+        console.error("Password cannot be empty");
+    }
+}
+async function buildInitPlan(params) {
+    const monitoringUser = params.monitoringUser || "postgres_ai_mon";
+    const database = params.database;
+    const qRole = quoteIdent(monitoringUser);
+    const qDb = quoteIdent(database);
+    const steps = [];
+    // Role creation/update is done in two alternative steps. Caller decides by checking role existence.
+    if (params.roleExists === false) {
+        steps.push({
+            name: "create monitoring user",
+            sql: `create user ${qRole} with password $1;`,
+            params: [params.monitoringPassword],
+        });
+    }
+    else if (params.roleExists === true) {
+        steps.push({
+            name: "update monitoring user password",
+            sql: `alter user ${qRole} with password $1;`,
+            params: [params.monitoringPassword],
+        });
+    }
+    else {
+        // Unknown: caller will rebuild after probing role existence.
+    }
+    steps.push({
+        name: "grant connect on database",
+        sql: `grant connect on database ${qDb} to ${qRole};`,
+    }, {
+        name: "grant pg_monitor",
+        sql: `grant pg_monitor to ${qRole};`,
+    }, {
+        name: "grant select on pg_index",
+        sql: `grant select on pg_catalog.pg_index to ${qRole};`,
+    }, {
+        name: "create or replace public.pg_statistic view",
+        sql: `create or replace view public.pg_statistic as
+select
+    n.nspname as schemaname,
+    c.relname as tablename,
+    a.attname,
+    s.stanullfrac as null_frac,
+    s.stawidth as avg_width,
+    false as inherited
+from pg_catalog.pg_statistic s
+join pg_catalog.pg_class c on c.oid = s.starelid
+join pg_catalog.pg_namespace n on n.oid = c.relnamespace
+join pg_catalog.pg_attribute a on a.attrelid = s.starelid and a.attnum = s.staattnum
+where a.attnum > 0 and not a.attisdropped;`,
+    }, {
+        name: "grant select on public.pg_statistic",
+        sql: `grant select on public.pg_statistic to ${qRole};`,
+    }, {
+        name: "ensure access to public schema (for hardened clusters)",
+        sql: `grant usage on schema public to ${qRole};`,
+    }, {
+        name: "set monitoring user search_path",
+        sql: `alter user ${qRole} set search_path = "$user", public, pg_catalog;`,
+    });
+    if (params.includeOptionalPermissions) {
+        steps.push({
+            name: "create rds_tools extension (optional)",
+            sql: "create extension if not exists rds_tools;",
+            optional: true,
+        }, {
+            name: "grant rds_tools.pg_ls_multixactdir() (optional)",
+            sql: `grant execute on function rds_tools.pg_ls_multixactdir() to ${qRole};`,
+            optional: true,
+        }, {
+            name: "grant pg_stat_file(text) (optional)",
+            sql: `grant execute on function pg_catalog.pg_stat_file(text) to ${qRole};`,
+            optional: true,
+        }, {
+            name: "grant pg_stat_file(text, boolean) (optional)",
+            sql: `grant execute on function pg_catalog.pg_stat_file(text, boolean) to ${qRole};`,
+            optional: true,
+        }, {
+            name: "grant pg_ls_dir(text) (optional)",
+            sql: `grant execute on function pg_catalog.pg_ls_dir(text) to ${qRole};`,
+            optional: true,
+        }, {
+            name: "grant pg_ls_dir(text, boolean, boolean) (optional)",
+            sql: `grant execute on function pg_catalog.pg_ls_dir(text, boolean, boolean) to ${qRole};`,
+            optional: true,
+        });
+    }
+    return { monitoringUser, database, steps };
+}
+async function applyInitPlan(params) {
+    const applied = [];
+    const skippedOptional = [];
+    // Apply non-optional steps in a single transaction.
+    await params.client.query("begin;");
+    try {
+        for (const step of params.plan.steps.filter((s) => !s.optional)) {
+            try {
+                await params.client.query(step.sql, step.params);
+                applied.push(step.name);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                throw new Error(`Failed at step "${step.name}": ${msg}`);
+            }
+        }
+        await params.client.query("commit;");
+    }
+    catch (e) {
+        await params.client.query("rollback;");
+        throw e;
+    }
+    // Apply optional steps outside of the transaction so a failure doesn't abort everything.
+    for (const step of params.plan.steps.filter((s) => s.optional)) {
+        try {
+            await params.client.query(step.sql, step.params);
+            applied.push(step.name);
+        }
+        catch {
+            skippedOptional.push(step.name);
+            // best-effort: ignore
+        }
+    }
+    return { applied, skippedOptional };
+}
+//# sourceMappingURL=init.js.map

package/dist/lib/init.js.map

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

package/dist/lib/issues.d.ts

@@ -1,7 +1,75 @@
+export interface IssueActionItem {
+    id: string;
+    issue_id: string;
+    title: string;
+    description: string | null;
+    severity: number;
+    is_done: boolean;
+    done_by: number | null;
+    done_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface Issue {
+    id: string;
+    title: string;
+    description: string | null;
+    created_at: string;
+    updated_at: string;
+    status: number;
+    url_main: string | null;
+    urls_extra: string[] | null;
+    data: unknown | null;
+    author_id: number;
+    org_id: number;
+    project_id: number | null;
+    is_ai_generated: boolean;
+    assigned_to: number[] | null;
+    labels: string[] | null;
+    is_edited: boolean;
+    author_display_name: string;
+    comment_count: number;
+    action_items: IssueActionItem[];
+}
+export interface IssueComment {
+    id: string;
+    issue_id: string;
+    author_id: number;
+    parent_comment_id: string | null;
+    content: string;
+    created_at: string;
+    updated_at: string;
+    data: unknown | null;
+}
+export type IssueListItem = Pick<Issue, "id" | "title" | "status" | "created_at">;
+export type IssueDetail = Pick<Issue, "id" | "title" | "description" | "status" | "created_at" | "author_display_name">;
 export interface FetchIssuesParams {
     apiKey: string;
     apiBaseUrl: string;
     debug?: boolean;
 }
-export declare function fetchIssues(params: FetchIssuesParams): Promise<unknown>;
+export declare function fetchIssues(params: FetchIssuesParams): Promise<IssueListItem[]>;
+export interface FetchIssueCommentsParams {
+    apiKey: string;
+    apiBaseUrl: string;
+    issueId: string;
+    debug?: boolean;
+}
+export declare function fetchIssueComments(params: FetchIssueCommentsParams): Promise<IssueComment[]>;
+export interface FetchIssueParams {
+    apiKey: string;
+    apiBaseUrl: string;
+    issueId: string;
+    debug?: boolean;
+}
+export declare function fetchIssue(params: FetchIssueParams): Promise<IssueDetail | null>;
+export interface CreateIssueCommentParams {
+    apiKey: string;
+    apiBaseUrl: string;
+    issueId: string;
+    content: string;
+    parentCommentId?: string;
+    debug?: boolean;
+}
+export declare function createIssueComment(params: CreateIssueCommentParams): Promise<IssueComment>;
 //# sourceMappingURL=issues.d.ts.map

package/dist/lib/issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../lib/issues.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAsE7E"}
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../lib/issues.ts"],"names":[],"mappings":"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"}