argustack 0.1.34 → 0.3.1

package/dist/adapters/postgres/migrate-helpers.d.ts

@@ -0,0 +1,43 @@
+import type pg from 'pg';
+export interface LegacyDbConfig {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+}
+export declare function discoverLegacyDbConfig(workspaceRoot: string): LegacyDbConfig;
+/**
+ * Copy rows from a legacy table into the hub table for a specific
+ * workspace. Streams in batches to avoid loading the whole table in
+ * memory. Returns the number of rows copied.
+ */
+export declare function copyTable(src: pg.Pool, dst: pg.Pool, workspaceId: string, table: string, columns: readonly string[], options?: {
+    batchSize?: number;
+    idRemap?: Map<number, number>;
+    idColumn?: string;
+    remappedColumns?: readonly string[];
+}): Promise<number>;
+/**
+ * Build a map from legacy SERIAL `graph_entities.id` to the new hub id
+ * (also SERIAL, but distinct per workspace). The map is used to rewrite
+ * `graph_relationships.source_id/target_id` and
+ * `graph_observations.entity_id` during the copy.
+ */
+export declare function copyGraphEntities(src: pg.Pool, dst: pg.Pool, workspaceId: string): Promise<Map<number, number>>;
+/**
+ * Count rows in a table (no workspace filter — used against legacy pools).
+ */
+export declare function countTable(pool: pg.Pool, table: string): Promise<number>;
+/**
+ * Verify post-copy: for each table compare row counts between source
+ * (full legacy db) and hub (`WHERE workspace_id = $1`). Returns a list
+ * of mismatches; an empty list means perfect copy.
+ */
+export interface CountMismatch {
+    table: string;
+    legacy: number;
+    hub: number;
+}
+export declare function verifyCounts(src: pg.Pool, dst: pg.Pool, workspaceId: string, tables: readonly string[]): Promise<CountMismatch[]>;
+//# sourceMappingURL=migrate-helpers.d.ts.map

package/dist/adapters/postgres/migrate-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-helpers.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres/migrate-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAUzB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CA8B5E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,EAAE,CAAC,IAAI,EACZ,GAAG,EAAE,EAAE,CAAC,IAAI,EACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GAC1H,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,EAAE,CAAC,IAAI,EACZ,GAAG,EAAE,EAAE,CAAC,IAAI,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmB9B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,EAAE,CAAC,IAAI,EACZ,GAAG,EAAE,EAAE,CAAC,IAAI,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAc1B"}

package/dist/adapters/postgres/migrate-helpers.js

@@ -0,0 +1,136 @@
+/**
+ * Discover the legacy Postgres port for a per-workspace stack by reading
+ * the workspace's `.env` file. Falls back to 5434 (the historical default
+ * Argustack docker-compose used for per-workspace stacks).
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export function discoverLegacyDbConfig(workspaceRoot) {
+    const envPath = join(workspaceRoot, '.env');
+    const cfg = {
+        host: 'localhost',
+        port: 5434,
+        user: 'argustack',
+        password: 'argustack_local',
+        database: 'argustack',
+    };
+    if (!existsSync(envPath)) {
+        return cfg;
+    }
+    const content = readFileSync(envPath, 'utf-8');
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        if (line === '' || line.startsWith('#')) {
+            continue;
+        }
+        const eq = line.indexOf('=');
+        if (eq === -1) {
+            continue;
+        }
+        const key = line.slice(0, eq).trim();
+        const value = line.slice(eq + 1).trim().replace(/^["']|["']$/g, '');
+        switch (key) {
+            case 'DB_HOST':
+                cfg.host = value;
+                break;
+            case 'DB_PORT': {
+                const parsed = parseInt(value, 10);
+                cfg.port = !isNaN(parsed) && parsed > 0 ? parsed : 5434;
+                break;
+            }
+            case 'DB_USER':
+                cfg.user = value;
+                break;
+            case 'DB_PASSWORD':
+                cfg.password = value;
+                break;
+            case 'DB_NAME':
+                cfg.database = value;
+                break;
+            default: break;
+        }
+    }
+    return cfg;
+}
+/**
+ * Copy rows from a legacy table into the hub table for a specific
+ * workspace. Streams in batches to avoid loading the whole table in
+ * memory. Returns the number of rows copied.
+ */
+export async function copyTable(src, dst, workspaceId, table, columns, options = {}) {
+    const batchSize = options.batchSize ?? 500;
+    let total = 0;
+    let offset = 0;
+    const cols = columns.join(', ');
+    while (true) {
+        const result = await src.query(`SELECT ${cols} FROM ${table} ORDER BY 1 LIMIT $1 OFFSET $2`, [batchSize, offset]);
+        if (result.rows.length === 0) {
+            break;
+        }
+        for (const row of result.rows) {
+            const values = [workspaceId];
+            for (const col of columns) {
+                let v = row[col];
+                if (options.idRemap !== undefined && options.remappedColumns?.includes(col) === true) {
+                    const old = v;
+                    v = old !== null && options.idRemap.has(old) ? options.idRemap.get(old) : null;
+                }
+                values.push(v);
+            }
+            const placeholders = columns.map((_, i) => `$${String(i + 2)}`).join(', ');
+            try {
+                await dst.query(`INSERT INTO ${table} (workspace_id, ${cols}) VALUES ($1, ${placeholders}) ON CONFLICT DO NOTHING`, values);
+            }
+            catch {
+                /* skip rows that violate composite constraints (already migrated) */
+            }
+            total++;
+        }
+        offset += result.rows.length;
+        if (result.rows.length < batchSize) {
+            break;
+        }
+    }
+    return total;
+}
+/**
+ * Build a map from legacy SERIAL `graph_entities.id` to the new hub id
+ * (also SERIAL, but distinct per workspace). The map is used to rewrite
+ * `graph_relationships.source_id/target_id` and
+ * `graph_observations.entity_id` during the copy.
+ */
+export async function copyGraphEntities(src, dst, workspaceId) {
+    const map = new Map();
+    const result = await src.query(`SELECT id, name, type, properties FROM graph_entities`);
+    for (const row of result.rows) {
+        const inserted = await dst.query(`INSERT INTO graph_entities (workspace_id, name, type, properties)
+       VALUES ($1, $2, $3, $4::jsonb)
+       ON CONFLICT (workspace_id, name, type) DO UPDATE SET properties = EXCLUDED.properties
+       RETURNING id`, [workspaceId, row.name, row.type, JSON.stringify(row.properties ?? {})]);
+        const newId = inserted.rows[0]?.id;
+        if (newId !== undefined) {
+            map.set(row.id, newId);
+        }
+    }
+    return map;
+}
+/**
+ * Count rows in a table (no workspace filter — used against legacy pools).
+ */
+export async function countTable(pool, table) {
+    const result = await pool.query(`SELECT COUNT(*)::text AS count FROM ${table}`);
+    return Number(result.rows[0]?.count ?? '0');
+}
+export async function verifyCounts(src, dst, workspaceId, tables) {
+    const mismatches = [];
+    for (const table of tables) {
+        const legacy = await countTable(src, table);
+        const hub = await dst.query(`SELECT COUNT(*)::text AS count FROM ${table} WHERE workspace_id = $1`, [workspaceId]);
+        const hubCount = Number(hub.rows[0]?.count ?? '0');
+        if (legacy !== hubCount) {
+            mismatches.push({ table, legacy, hub: hubCount });
+        }
+    }
+    return mismatches;
+}
+//# sourceMappingURL=migrate-helpers.js.map

package/dist/adapters/postgres/migrate-helpers.js.map

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

package/dist/adapters/postgres/readiness-probe.d.ts

@@ -0,0 +1,22 @@
+import type { IHubReadinessProbe } from '../../core/ports/hub-readiness-probe.js';
+/**
+ * Adapter: polls the freshly-bootstrapped hub Postgres until it accepts
+ * an authenticated `SELECT 1`. Bridges the {@link IHubReadinessProbe}
+ * port — `BootstrapHubUseCase` knows nothing about pg.
+ */
+export declare class PgReadinessProbe implements IHubReadinessProbe {
+    private readonly credentials;
+    constructor(credentials: {
+        readonly user: string;
+        readonly password: string;
+        readonly database: string;
+        readonly host?: string;
+    });
+    waitForReady(port: number): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        details: string;
+    }>;
+}
+//# sourceMappingURL=readiness-probe.d.ts.map

package/dist/adapters/postgres/readiness-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-probe.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres/readiness-probe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAKlF;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IAEvD,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB;IAGG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA4BzF"}

package/dist/adapters/postgres/readiness-probe.js

@@ -0,0 +1,47 @@
+import { Client } from 'pg';
+const PG_HEALTH_TIMEOUT_MS = 60_000;
+const PG_HEALTH_INTERVAL_MS = 1_000;
+/**
+ * Adapter: polls the freshly-bootstrapped hub Postgres until it accepts
+ * an authenticated `SELECT 1`. Bridges the {@link IHubReadinessProbe}
+ * port — `BootstrapHubUseCase` knows nothing about pg.
+ */
+export class PgReadinessProbe {
+    credentials;
+    constructor(credentials) {
+        this.credentials = credentials;
+    }
+    async waitForReady(port) {
+        const deadline = Date.now() + PG_HEALTH_TIMEOUT_MS;
+        let lastError = 'unknown';
+        while (Date.now() < deadline) {
+            const client = new Client({
+                host: this.credentials.host ?? 'localhost',
+                port,
+                user: this.credentials.user,
+                password: this.credentials.password,
+                database: this.credentials.database,
+                connectionTimeoutMillis: 2000,
+            });
+            try {
+                await client.connect();
+                await client.query('SELECT 1');
+                await client.end();
+                return { ok: true };
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                try {
+                    await client.end();
+                }
+                catch { /* ignore */ }
+                await new Promise((r) => setTimeout(r, PG_HEALTH_INTERVAL_MS));
+            }
+        }
+        return {
+            ok: false,
+            details: `Postgres did not become ready in ${String(PG_HEALTH_TIMEOUT_MS / 1000)}s: ${lastError}`,
+        };
+    }
+}
+//# sourceMappingURL=readiness-probe.js.map

package/dist/adapters/postgres/readiness-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness-probe.js","sourceRoot":"","sources":["../../../src/adapters/postgres/readiness-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAG5B,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAER;IADnB,YACmB,WAKhB;QALgB,gBAAW,GAAX,WAAW,CAK3B;IACA,CAAC;IAEJ,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAC;QACnD,IAAI,SAAS,GAAG,SAAS,CAAC;QAC1B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;gBACxB,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW;gBAC1C,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;gBAC3B,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;gBACnC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;gBACnC,uBAAuB,EAAE,IAAI;aAC9B,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/B,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;gBACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAClD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,oCAAoC,MAAM,CAAC,oBAAoB,GAAG,IAAI,CAAC,MAAM,SAAS,EAAE;SAClG,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/postgres/schema.d.ts

@@ -1,6 +1,16 @@
 import type pg from 'pg';
 /**
- * Ensure all tables exist. Idempotent — safe to call every time.
+ * Ensure all tables exist in the Argustack hub Postgres.
+ *
+ * Hub model: one Postgres database hosts data for many tenants
+ * (workspaces). Every data table carries a `workspace_id TEXT NOT NULL
+ * REFERENCES workspaces(id) ON DELETE CASCADE` column. Composite UNIQUE
+ * and PRIMARY KEY constraints always include `workspace_id` first.
+ *
+ * Idempotent: safe to call on every CLI/MCP invocation. Re-running on a
+ * populated database is a no-op. Migration from legacy per-workspace
+ * databases is handled by `argustack migrate-to-hub` (H7) using a
+ * separate raw-pg reader.
  */
 export declare function ensureSchema(pool: pg.Pool): Promise<void>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/adapters/postgres/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyX/D"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqc/D"}