argustack 0.1.7 → 0.1.9

package/README.md

@@ -1,445 +1,105 @@
 # Argustack
 
-**RAG engine for project intelligence — ask AI about your Jira, Git, and databases**
+[![npm version](https://img.shields.io/npm/v/argustack.svg)](https://www.npmjs.com/package/argustack)
+[![npm downloads](https://img.shields.io/npm/dm/argustack.svg)](https://www.npmjs.com/package/argustack)
+[![license](https://img.shields.io/npm/l/argustack.svg)](LICENSE)
 
-[RAG](https://en.wikipedia.org/wiki/Retrieval-augmented_generation) (Retrieval-Augmented Generation) — an architecture where AI answers questions based on **your** data, not its training set:
+**Ask AI about your Jira, Git, and GitHub — powered by local data, not cloud APIs.**
 
-1. **Retrieval** — pull and index your project data locally (PostgreSQL + pgvector)
-2. **Augmentation** — inject relevant context into the AI prompt
-3. **Generation** — LLM generates answers grounded in your actual Jira tickets, code, and databases
+Argustack downloads your project data into local PostgreSQL, cross-references everything, and gives Claude direct access via 15 MCP tools. All data stays on your machine.
 
-Argustack builds this knowledge base from your project's sources of truth:
+> *Was ticket PROJ-123 implemented as described?*
+> *Who reviewed the PR and what was the feedback?*
+> *How long will it take Sarah to fix this bug?*
 
-```
-     YOUR SOURCES                                YOUR MACHINE
-  ┌──────────────────────┐        ┌─────────────────────────────────────┐
-  │  Jira Cloud / Server │        │                                     │
-  │  (issues, comments,  │  pull  │  PostgreSQL (Docker, localhost)     │
-  │   changelogs, etc.)  │ ──────►│  ├── issues          (all fields)  │
-  └──────────────────────┘        │  ├── issue_comments  (discussions) │
-                                  │  ├── issue_changelogs (history)    │
-  ┌──────────────────────┐        │  ├── issue_worklogs  (time logs)  │
-  │  Git repository      │  pull  │  ├── issue_links     (relations)  │
-  │  (commits, files,    │ ──────►│  ├── commits         (history)    │
-  │   diffs, authors)    │        │  ├── commit_files    (per-file Δ) │
-  └──────────────────────┘        │  ├── commit_issue_refs (cross-ref)│
-                                  │  │                                  │
-  ┌──────────────────────┐        │  │  GitHub (optional, via token)    │
-  │  GitHub API          │  pull  │  ├── pull_requests   (PRs + meta) │
-  │  (PRs, reviews,      │ ──────►│  ├── pr_reviews      (approvals)  │
-  │   releases)          │        │  ├── pr_comments     (discussions) │
-  └──────────────────────┘        │  ├── pr_issue_refs   (PR↔Jira)    │
-                                  │  └── releases        (tags)        │
-  ┌──────────────────────┐        │                                     │
-  │  Database (planned)  │        │  MCP Server (localhost, stdio)      │
-  └──────────────────────┘        │  └── queries DB ──► Claude / LLM   │
-                                  │                                     │
-                                  │  .env (credentials — never leaves) │
-                                  └─────────────────────────────────────┘
-```
-
-> *Is this bug still relevant or already fixed in code?*
-> *Was the feature implemented as described in the ticket?*
-> *Who worked on this module and what changed last month?*
-> *Which commits and PRs reference ticket PROJ-123?*
-> *Who approved the PR and what was the review feedback?*
-
-## How it works
+## Features
 
-**Retrieval** — pulls all data from Jira, Git, and GitHub into local PostgreSQL with pgvector. Every field, every comment, every changelog entry, every commit with per-file diffs, every PR with reviews and approvals. Raw JSON preserved as-is. Nothing is filtered or lost.
-
-**Augmentation** — MCP server gives Claude Desktop / Claude Code direct access to your local database. Full-text search, semantic search (pgvector embeddings), filters, raw SQL, aggregate statistics, cross-source timeline, cross-reference between Jira issues, Git commits, and GitHub PRs — all without leaving your machine.
-
-**Generation** — ask questions in natural language. Claude queries your local data and answers with full project context.
+- **Jira** — issues, comments, changelogs, worklogs, links, all custom fields
+- **Git** — commits, per-file diffs, automatic issue cross-references
+- **GitHub** — PRs, reviews, comments, releases, automatic issue cross-references
+- **CSV import** — Jira CSV export for teams without API access
+- **Cross-source timeline** — Jira + Git + GitHub events in chronological order
+- **Semantic search** — find issues by meaning, not just keywords (pgvector)
+- **Task estimation** — predict duration per developer based on actual history
+- **15 MCP tools** — Claude queries your data directly via SQL
+- **100% local** — no cloud, no accounts, no telemetry
 
 ## Quick Start
 
-### Prerequisites
-
-- [Node.js](https://nodejs.org/) >= 20
-- [Docker](https://www.docker.com/) (or [OrbStack](https://orbstack.dev/) / Podman)
-
-### Install & setup
-
 ```bash
 npm i -g argustack
-argustack init
-```
-
-Argustack supports **two modes** of initialization:
-
-#### Interactive mode (default)
-
-Run `argustack init` and follow the prompts:
-
+argustack init          # interactive setup — sources, credentials, Docker
+argustack sync          # pull all data
+argustack mcp install   # connect to Claude Desktop
 ```
-? Workspace directory: ~/projects/my-team
-? Sources: ✔ Jira — issues, comments, changelogs
-           ✔ Git — commits, diffs, authors
-           ✔ GitHub — PRs, reviews, releases
-? Jira URL: https://your-team.atlassian.net
-? Email: you@company.com
-? API Token: ****
-
-Testing connection... Connected! Found 3 projects: MKT, BRAND, WEB
-
-? Projects to pull: ✔ MKT  ✔ BRAND
-? Where is your Git repository?
-  ● Clone from GitHub — select repos using your token
-? GitHub token (PAT): ****
-
-Fetching repositories... Found 12 repos.
 
-? Repositories to clone: ✔ your-org/frontend  ✔ your-org/backend
-? GitHub source: Auto-configured from clone step
-
-? Start database and sync now? Yes
-
-✔ Database running!
-✔ Jira sync complete!
-  MKT: 506 issues (150/506 ████░░░░ 30% → 506/506 done)
-✔ Git sync complete!
-  your-org/frontend: 735 commits (400/735 ██████░░ 54% → 735/735 done)
-✔ GitHub sync complete!
-  66 PRs (30/66 ██████░░ 45% → 66/66 done), 124 reviews, 3 releases
-```
+That's it. Ask Claude about your project.
 
-The interactive setup will:
+### Non-interactive mode
 
-1. Ask which sources you have (Jira, Git, GitHub, Database)
-2. Collect credentials and test connections
-3. For Git — choose local path, clone from GitHub (multi-select repos), or clone from URL
-4. For GitHub — auto-configured if you cloned from GitHub in the previous step, or enter a Personal Access Token (see [GitHub token setup](#github-token-setup))
-5. Create a workspace with Docker config
-6. Start PostgreSQL + pgweb automatically
-7. Pull all your data
-
-#### Non-interactive mode (for AI agents and CI/CD)
-
-Pass `--no-interactive` with all values as CLI flags — no prompts, no terminal needed:
+For AI agents and CI/CD — pass everything as flags:
 
 ```bash
-argustack init \
-  --no-interactive \
-  --dir ~/projects/my-team \
+argustack init --no-interactive \
   --source jira,git,github \
   --jira-url "https://your-team.atlassian.net" \
   --jira-email "you@company.com" \
   --jira-token "ATATT3x..." \
-  --jira-projects PAP,MKT \
-  --git-repo /path/to/repo1,/path/to/repo2 \
+  --jira-projects PROJ,MKT \
+  --git-repo /path/to/repo \
   --github-token "github_pat_..." \
   --github-owner your-org \
   --github-repo your-repo
 ```
 
-Then start the database and sync:
-
-```bash
-cd ~/projects/my-team
-docker compose up -d
-argustack sync
-```
-
-All available flags:
-
-| Flag | Description |
-|------|-------------|
-| `--no-interactive` | Run without prompts — all values from flags |
-| `-d, --dir <path>` | Workspace directory (default: current) |
-| `-s, --source <list>` | Comma-separated: `jira,git,github,csv,db` |
-| `--jira-url <url>` | Jira instance URL |
-| `--jira-email <email>` | Jira user email |
-| `--jira-token <token>` | Jira API token |
-| `--jira-projects <keys>` | Comma-separated project keys, or `all` |
-| `--git-repo <paths>` | Git repo paths, comma-separated |
-| `--github-token <token>` | GitHub Personal Access Token |
-| `--github-owner <owner>` | GitHub repo owner |
-| `--github-repo <repo>` | GitHub repo name |
-| `--csv-file <path>` | Path to Jira CSV export file |
-| `--db-port <port>` | Argustack PostgreSQL port (default: `5434`) |
-| `--pgweb-port <port>` | pgweb UI port (default: `8086`) |
-
-This mode is ideal for:
-- **AI agents** — a project manager tells their AI agent "set up argustack" and it runs everything autonomously
-- **CI/CD pipelines** — automated workspace provisioning
-- **Scripted setups** — reproducible environment creation
-
-Browse your data at [localhost:8086](http://localhost:8086) — pgweb UI for running SQL queries and exploring tables in your browser.
-
-### Connect to Claude
-
-```bash
-argustack mcp install
-```
-
-Adds Argustack as an MCP server to Claude Desktop. Now you can ask Claude questions about your project data directly.
-
 ## Commands
 
 ```bash
-argustack init                       # create workspace (interactive prompts)
-argustack init --no-interactive ...  # create workspace from CLI flags (no prompts)
-argustack sync                       # pull data from all configured sources
-argustack sync jira                  # pull Jira only
-argustack sync git                   # pull Git commits only
-argustack sync github                # pull GitHub PRs, reviews, releases
-argustack sync csv                   # import from Jira CSV export
-argustack sync csv -f /path/to.csv   # import specific CSV file
-argustack sync -p PROJ               # pull specific Jira project
-argustack sync --since 2025-01-01    # incremental pull (only new/updated)
+argustack init                       # create workspace
+argustack sync                       # pull all sources
+argustack sync jira|git|github|csv   # pull specific source
+argustack sync --since 2025-01-01    # incremental pull
+argustack embed                      # generate embeddings (requires OpenAI key)
+argustack mcp install                # connect to Claude Desktop
 argustack sources                    # list configured sources
 argustack status                     # workspace info
-argustack embed                      # generate embeddings for semantic search
-argustack mcp install                # connect to Claude Desktop
 ```
 
-## What gets stored
-
-All data goes into local PostgreSQL in Docker on your machine (nothing leaves `localhost`):
-
-### Jira tables
-
-| Table | Content |
-|-------|---------|
-| `issues` | All issues — typed columns + `custom_fields` JSONB + full `raw_json` |
-| `issue_comments` | Comments with authors and timestamps |
-| `issue_changelogs` | Every field change in history |
-| `issue_worklogs` | Time tracking entries |
-| `issue_links` | Issue-to-issue relationships |
-
-Every custom field is preserved exactly as Jira returns it. 500 custom fields? All stored. Zero filtering, zero data loss.
-
-### Git tables
-
-| Table | Content |
-|-------|---------|
-| `commits` | Commit hash, message, author, email, date, full-text search |
-| `commit_files` | Per-file changes — path, status, additions, deletions |
-| `commit_issue_refs` | Cross-reference: commit ↔ Jira issue (extracted from commit messages) |
-
-Commit messages mentioning issue keys like `PROJ-123` or `PROJ-45` are automatically linked to Jira issues.
-
-### GitHub tables
-
-Select "GitHub" during `argustack init` or add later with `argustack source add github`:
-
-| Table | Content |
-|-------|---------|
-| `pull_requests` | PRs — state, author, reviewers, additions/deletions, merge info, full-text search |
-| `pr_reviews` | Review approvals and change requests |
-| `pr_comments` | Inline review comments with file paths and line numbers |
-| `pr_files` | Per-file changes in each PR |
-| `pr_issue_refs` | Cross-reference: PR ↔ Jira issue (extracted from PR title and body) |
-| `releases` | GitHub releases with tags, notes, and full-text search |
-
-PR titles and bodies mentioning issue keys like `PROJ-123` are automatically linked to Jira issues — just like commits.
-
 ## MCP Tools
 
-When connected to Claude, these tools are available:
+After sync, Claude queries your data through these tools:
 
-### Jira tools
-
-| Tool | What it does |
-|------|-------------|
-| `query_issues` | Search issues — full-text, filters, or raw SQL |
-| `get_issue` | Full issue details with comments, changelogs, custom fields |
-| `issue_stats` | Aggregate stats — by status, type, assignee, project |
+| Tool | Purpose |
+|------|---------|
+| `query_issues` | Search issues — full-text, filters, raw SQL |
+| `get_issue` | Full issue details with comments and changelogs |
+| `issue_stats` | Aggregates by status, type, assignee |
 | `pull_jira` | Sync latest data from Jira |
-| `list_projects` | List available Jira projects |
-
-### Git tools
-
-| Tool | What it does |
-|------|-------------|
-| `query_commits` | Search commits by text, author, date, file path, or raw SQL. Optional `repo_path` filter for multi-repo workspaces |
-| `issue_commits` | Cross-reference: find all commits mentioning a Jira issue key. Optional `repo_path` filter |
-| `commit_stats` | Aggregate stats — top authors, most changed files, linked issues. Optional `repo_path` filter |
-
-### GitHub tools
-
-| Tool | What it does |
-|------|-------------|
-| `query_prs` | Search PRs — full-text, state, author, base branch, or raw SQL |
-| `issue_prs` | Cross-reference: find all PRs mentioning a Jira issue key with reviews |
-| `query_releases` | List releases with full-text search |
-
-### Cross-source tools
-
-| Tool | What it does |
-|------|-------------|
-| `issue_timeline` | Chronological timeline — changelogs + commits + PRs for one issue |
-| `semantic_search` | Find similar issues by meaning (pgvector embeddings) |
-| `estimate` | Predict task duration per developer. With effort data: "without bugs" / "with bugs" predictions. With CSV only: resolution timeline in business days (lead time, not active dev) |
-
-### System tools
-
-| Tool | What it does |
-|------|-------------|
+| `list_projects` | Available Jira projects |
+| `query_commits` | Search commits by text, author, date, file |
+| `issue_commits` | All commits mentioning a Jira issue key |
+| `commit_stats` | Top authors, most changed files |
+| `query_prs` | Search PRs by text, state, author |
+| `issue_prs` | All PRs mentioning a Jira issue key |
+| `query_releases` | List releases with search |
+| `issue_timeline` | Full chronological timeline: Jira + Git + GitHub |
+| `semantic_search` | Find similar issues by meaning (pgvector) |
+| `estimate` | Predict task duration per developer |
 | `workspace_info` | Current workspace configuration |
 
-## Embeddings & Semantic Search
-
-**Embeddings** turn issue text into numerical vectors that capture meaning. Two issues about "login not working" and "SSO authentication fails" will have similar vectors — even though they share zero keywords.
-
-How it works:
-
-1. `argustack embed` sends each issue's `summary + description` to OpenAI API (`text-embedding-3-small` model)
-2. Returns a 1536-dimensional vector per issue, stored in PostgreSQL via pgvector
-3. `semantic_search` MCP tool embeds your question, then finds issues with the closest vectors using cosine similarity
-
-```bash
-# Generate embeddings for all issues (requires OPENAI_API_KEY in .env)
-argustack embed
-```
-
-After embedding, ask Claude: *"Find issues similar to payment timeout errors"* — it will search by meaning, not keywords.
-
-**Costs:** text-embedding-3-small costs ~$0.02 per 1M tokens. 10,000 issues ≈ $0.05-0.10.
-
-**Optional:** Embeddings require an OpenAI API key. All other features work without it.
-
-## GitHub token setup
-
-Argustack only reads data from GitHub — it never writes anything. You need a **fine-grained Personal Access Token** with read-only permissions.
-
-1. Go to [github.com/settings/personal-access-tokens/new](https://github.com/settings/personal-access-tokens/new)
-2. **Token name** — anything (e.g. `argustack`)
-3. **Description** — optional, can leave empty
-4. **Resource owner** — your account, or the organization that owns the repo
-5. **Expiration** — "No expiration" recommended. Token is read-only and stays in your local `.env`
-6. **Repository access** — pick one:
-   - **Only select repositories** (recommended) — pick specific repos, max 50
-   - **All repositories** — all your current and future repos
-   - **Public repositories** — read-only access to public repos only
-5. **Permissions** → Repository permissions (3 total):
-
-| Permission | Access | Why |
-|---|---|---|
-| **Contents** | Read-only | Releases, downloads, tags |
-| **Metadata** | Read-only | Repository info (auto-selected, required) |
-| **Pull requests** | Read-only | PRs, reviews, comments, files |
-
-7. Click "Generate token" and copy it
-
-During `argustack init`, select "GitHub" as a source and paste the token when asked. Or add to `.env` manually:
-
-```bash
-GITHUB_TOKEN=github_pat_...
-GITHUB_OWNER=your-org
-GITHUB_REPO=your-repo
-```
-
-Then run `argustack source add github` and `argustack sync github`.
-
-## Multiple workspaces
-
-Each data source = separate workspace (like git repos):
-
-```
-~/projects/
-├── client-alpha/       # argustack init → Alpha's Jira + Git
-│   ├── .argustack/
-│   ├── .env            # Alpha credentials
-│   └── docker-compose.yml
-│
-├── client-beta/        # argustack init → Beta's Jira + Git
-│   ├── .argustack/
-│   ├── .env            # Beta credentials
-│   └── docker-compose.yml
-```
-
-## Security & Credentials
-
-**Argustack is a CLI tool. It has no backend, no cloud, no accounts.** Everything runs on your machine.
-
-When you run `argustack init`, it creates a `.env` file in your workspace with your credentials:
-
-```bash
-# .env — YOUR file, on YOUR machine, never uploaded anywhere
-
-# === Jira ===
-JIRA_URL=https://your-team.atlassian.net
-JIRA_EMAIL=you@company.com
-JIRA_API_TOKEN=your-api-token-here
-JIRA_PROJECTS=PROJ,OTHER
-
-# === Git ===
-GIT_REPO_PATHS=/path/to/repo1,/path/to/repo2
-
-# === GitHub ===
-GITHUB_TOKEN=github_pat_...
-GITHUB_OWNER=your-org
-GITHUB_REPO=your-repo
-
-# === Argustack internal PostgreSQL (match docker-compose.yml) ===
-DB_HOST=localhost
-DB_PORT=5434
-DB_USER=argustack
-DB_PASSWORD=argustack_local
-DB_NAME=argustack
-
-# === OpenAI embeddings (optional, for semantic search) ===
-# OPENAI_API_KEY=sk-...
-```
-
-**Where credentials go:**
-
-| What | Where | Who can see |
-|------|-------|-------------|
-| Jira token | `.env` on your disk | Only you |
-| GitHub token | `.env` on your disk | Only you |
-| Jira data | PostgreSQL in Docker on `localhost:5434` | Only you |
-| Git + GitHub data | PostgreSQL in Docker on `localhost:5434` | Only you |
-| Database password | `.env` on your disk | Only you |
-| Source code (this repo) | GitHub | Everyone — **no secrets here** |
-
-**What Argustack does NOT do:**
-- Does not send your data to any external server
-- Does not have analytics, telemetry, or tracking
-- Does not store credentials anywhere except your local `.env`
-- Does not require registration or accounts
-
-**`.env` is in `.gitignore`** — if you accidentally run `git add .`, your credentials won't be committed.
-
-## Architecture — Hexagonal (Ports & Adapters)
-
-```
-Driving adapters (entries):         cli/, mcp/
-Driven adapters (external systems): adapters/jira/, adapters/git/, adapters/github/, adapters/postgres/
-
-Dependency Rule: cli/,mcp/ → use-cases/ → core/ports ← adapters/
-```
-
-Core has zero dependencies — only pure TypeScript types and interfaces. Adapters implement core ports and are independently replaceable.
+## Security
 
-## Tech Stack
+Argustack is a CLI tool with no backend, no cloud, no accounts. Credentials stay in `.env` on your machine. Data stays in PostgreSQL on `localhost`. Nothing is uploaded anywhere.
 
-- TypeScript / Node.js — Hexagonal Architecture
-- Commander.js — CLI (driving adapter)
-- MCP SDK — Claude integration (driving adapter)
-- jira.js — Jira REST API (driven adapter)
-- Octokit — GitHub REST API (driven adapter)
-- es-git — native Git bindings, N-API, powered by libgit2 (driven adapter)
-- csv-parse — streaming RFC 4180 CSV parser (driven adapter)
-- PostgreSQL 16 + pgvector — storage + vector search (driven adapter)
-- Docker — database infrastructure
+## Documentation
 
-## Roadmap
+Full documentation available at **[Argustack DataRoom](https://app.paperlink.online/s/0aa7d2d6/argustack)**:
 
-- [x] Jira pull (all fields, comments, changelogs, worklogs, links)
-- [x] Git pull (commits, per-file diffs, issue cross-references)
-- [x] GitHub pull (PRs, reviews, comments, files, releases, Jira cross-references)
-- [x] MCP server for Claude Desktop / Claude Code (15 tools)
-- [x] Embeddings + semantic search (OpenAI text-embedding-3-small, pgvector)
-- [x] Cross-source timeline (issue_timeline: changelogs + commits + PRs)
-- [x] Multi-repo Git support (multiple repos per workspace, `GIT_REPO_PATHS`)
-- [x] Progress indicators during sync (e.g. `150/506 issues (30%)`)
-- [x] CSV import (Jira export without API token)
-- [x] Estimate tool — task duration prediction with data-source awareness
-- [ ] Database adapter (schema, sample data)
-- [ ] Cross-source analysis (Jira ticket vs actual code vs DB state)
+- **Quick Start Guide** — from zero to first query in 5 minutes
+- **Use Cases & Examples** — real scenarios for PMs, team leads, developers, CTOs
+- **MCP Tools Reference** — all 15 tools with parameters and examples
+- **Estimate Tool Deep Dive** — algorithm, scoring, data sources
+- **Architecture Guide** — hexagonal architecture, directory structure, extending
 
 ## License
 

package/dist/adapters/db/client.d.ts

@@ -0,0 +1,13 @@
+import type { Knex } from 'knex';
+import type { DbEngine } from '../../core/types/database.js';
+export interface DbConnectionConfig {
+    engine: DbEngine;
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    name: string;
+}
+export declare function createKnexClient(config: DbConnectionConfig): Knex;
+//# sourceMappingURL=client.d.ts.map

package/dist/adapters/db/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/adapters/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAK7D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAyCD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CA+BjE"}

package/dist/adapters/db/client.js

@@ -0,0 +1,70 @@
+import knex from 'knex';
+const STATEMENT_TIMEOUT_MS = 30_000;
+const POOL_IDLE_TIMEOUT_MS = 10_000;
+const ENGINE_TO_KNEX_CLIENT = {
+    postgresql: 'pg',
+    mysql: 'mysql2',
+    mssql: 'tedious',
+    sqlite: 'better-sqlite3',
+    oracledb: 'oracledb',
+};
+function buildAfterCreate(engine) {
+    return function afterCreate(conn, done) {
+        if (engine === 'postgresql') {
+            conn.query('SET default_transaction_read_only = true', (err) => {
+                if (err) {
+                    done(err, conn);
+                    return;
+                }
+                conn.query(`SET statement_timeout = '${String(STATEMENT_TIMEOUT_MS)}'`, (err2) => {
+                    done(err2, conn);
+                });
+            });
+        }
+        else if (engine === 'mysql') {
+            conn.query('SET SESSION TRANSACTION READ ONLY', (err) => {
+                if (err) {
+                    done(err, conn);
+                    return;
+                }
+                conn.query(`SET SESSION max_execution_time = ${String(STATEMENT_TIMEOUT_MS)}`, (err2) => {
+                    done(err2, conn);
+                });
+            });
+        }
+        else {
+            done(null, conn);
+        }
+    };
+}
+export function createKnexClient(config) {
+    const client = ENGINE_TO_KNEX_CLIENT[config.engine];
+    if (config.engine === 'sqlite') {
+        return knex({
+            client,
+            connection: { filename: config.database, options: { readonly: true } },
+            useNullAsDefault: true,
+            pool: { min: 0, max: 1 },
+        });
+    }
+    return knex({
+        client,
+        connection: {
+            host: config.host,
+            port: config.port,
+            user: config.user,
+            password: config.password,
+            database: config.database,
+            ssl: config.host !== 'localhost' && config.host !== '127.0.0.1'
+                ? { rejectUnauthorized: false }
+                : false,
+        },
+        pool: {
+            min: 0,
+            max: 2,
+            idleTimeoutMillis: POOL_IDLE_TIMEOUT_MS,
+            afterCreate: buildAfterCreate(config.engine),
+        },
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/adapters/db/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/adapters/db/client.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,oBAAoB,GAAG,MAAM,CAAC;AACpC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAYpC,MAAM,qBAAqB,GAA6B;IACtD,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,SAAS,gBAAgB,CAAC,MAAgB;IACxC,OAAO,SAAS,WAAW,CACzB,IAAkE,EAClE,IAA2C;QAE3C,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,0CAA0C,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC7D,IAAI,GAAG,EAAE,CAAC;oBACR,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBAChB,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,4BAA4B,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC/E,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACnB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,mCAAmC,EAAE,CAAC,GAAG,EAAE,EAAE;gBACtD,IAAI,GAAG,EAAE,CAAC;oBACR,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBAChB,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,oCAAoC,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;oBACtF,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACnB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B;IACzD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;YACV,MAAM;YACN,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YACtE,gBAAgB,EAAE,IAAI;YACtB,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;QACV,MAAM;QACN,UAAU,EAAE;YACV,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,EAAE,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;gBAC7D,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE;gBAC/B,CAAC,CAAC,KAAK;SACV;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;YACN,iBAAiB,EAAE,oBAAoB;YACvC,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC;SAC7C;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/db/index.d.ts

@@ -0,0 +1,4 @@
+export { DbProvider } from './provider.js';
+export { type DbConnectionConfig } from './client.js';
+export { validateSql, type SqlValidationResult } from './sql-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/adapters/db/index.js

@@ -0,0 +1,3 @@
+export { DbProvider } from './provider.js';
+export { validateSql } from './sql-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,WAAW,EAA4B,MAAM,oBAAoB,CAAC"}

package/dist/adapters/db/mapper.d.ts

@@ -0,0 +1,31 @@
+import type { DbTable, DbColumn, DbForeignKey, DbIndex } from '../../core/types/database.js';
+export interface RawTableRow {
+    table_schema: string;
+    table_name: string;
+}
+export interface RawColumnRow {
+    table_name: string;
+    column_name: string;
+    data_type: string;
+    is_nullable: string;
+    column_default: string | null;
+    ordinal_position: number;
+}
+export interface RawForeignKeyRow {
+    table_name: string;
+    column_name: string;
+    referenced_table: string;
+    referenced_column: string;
+}
+export interface RawIndexRow {
+    table_name: string;
+    index_name: string;
+    column_name: string;
+    is_unique: boolean;
+    is_primary: boolean;
+}
+export declare function mapTableRow(row: RawTableRow, sourceName: string): Omit<DbTable, 'columns'>;
+export declare function mapColumnRow(row: RawColumnRow, primaryKeys: Set<string>): DbColumn;
+export declare function mapForeignKeyRow(row: RawForeignKeyRow): DbForeignKey;
+export declare function mapIndexRows(rows: RawIndexRow[]): DbIndex[];
+//# sourceMappingURL=mapper.d.ts.map

package/dist/adapters/db/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../../src/adapters/db/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE7F,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAQ1F;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,QAAQ,CAWlF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,YAAY,CAOpE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAyB3D"}