promptdock 0.1.0__tar.gz

promptdock-0.1.0/.dockerignore

@@ -0,0 +1,11 @@
+.git
+.venv
+.venv-*
+**/__pycache__
+**/node_modules
+dist
+.pytest_cache
+.mypy_cache
+.ruff_cache
+src/promptdock/ui/static
+.env

promptdock-0.1.0/.env.example

@@ -0,0 +1 @@
+DATABASE_URL=postgresql+psycopg://promptdock:promptdock@localhost:5432/promptdock

promptdock-0.1.0/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

promptdock-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_call: # reused by release.yml
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run mypy
+      - run: uv run mypy tests
+
+  test:
+    name: test (Python ${{ matrix.python-version }}, Postgres ${{ matrix.postgres }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        postgres: ["14", "17"]
+    env:
+      PROMPTDOCK_TEST_POSTGRES_IMAGE: postgres:${{ matrix.postgres }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync
+      - run: uv run pytest -v
+
+  ui:
+    name: dashboard build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: ui/package-lock.json
+      - run: npm ci
+        working-directory: ui
+      - run: npm run build
+        working-directory: ui
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync
+      # Serves the real build through `serve --ui` (skipped in the other jobs).
+      - run: uv run pytest -v tests/test_ui.py

promptdock-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,114 @@
+name: Release
+
+# Push a tag like v0.1.0 to publish that version everywhere:
+#   tests -> build UI -> uv build -> PyPI (Trusted Publishing) -> GHCR image -> GitHub Release
+# No tokens live on anyone's laptop: PyPI trusts this workflow, GHCR uses GITHUB_TOKEN.
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    uses: ./.github/workflows/ci.yml
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check the tag matches pyproject.toml
+        id: version
+        run: |
+          version=$(grep -m1 '^version = ' pyproject.toml | cut -d'"' -f2)
+          if [ "v$version" != "$GITHUB_REF_NAME" ]; then
+            echo "Tag $GITHUB_REF_NAME does not match pyproject.toml version $version" >&2
+            exit 1
+          fi
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: ui/package-lock.json
+      - run: npm ci && npm run build
+        working-directory: ui
+      - uses: astral-sh/setup-uv@v5
+      - run: uv build
+      - name: Check the dashboard is inside the wheel
+        run: unzip -l dist/*.whl | grep -q 'promptdock/ui/static/index.html'
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  docker:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-qemu-action@v3
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository_owner }}/promptdock
+          tags: |
+            type=raw,value=${{ needs.build.outputs.version }}
+            type=raw,value=latest
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+
+  github-release:
+    needs: [build, pypi, docker]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Release notes from CHANGELOG.md
+        run: |
+          awk -v heading="## [${{ needs.build.outputs.version }}]" '
+            index($0, heading) == 1 { found = 1; next }
+            found && (index($0, "## [") == 1 || index($0, "[") == 1) { exit }
+            found { print }
+          ' CHANGELOG.md > notes.md
+          test -s notes.md || echo "See CHANGELOG.md" > notes.md
+      - run: gh release create "$GITHUB_REF_NAME" dist/* --title "PromptDock $GITHUB_REF_NAME" --notes-file notes.md
+        env:
+          GH_TOKEN: ${{ github.token }}

promptdock-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.env
+node_modules/
+src/promptdock/ui/static/
+.promptdock-snapshot.json
+.venv-*/

promptdock-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        entry: uv run mypy
+        language: system
+        types: [python]
+        pass_filenames: false

promptdock-0.1.0/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to this project are documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the
+project uses [semantic versioning](https://semver.org/) (staying on 0.x until the API is
+stable).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-11-01
+
+First release.
+
+### Added
+
+- **Versions and tags.** Immutable, numbered prompt versions (text or chat messages, Jinja2
+  variables detected, identical content deduplicated) and tags (`dev`, `preprod`, `prod`
+  by default, plus custom ones) that point at them. Promote moves a tag; rollback undoes
+  the last promote, again and again like undo. Every move is recorded in an audit log with
+  from/to versions, a self-reported actor and an optional reason.
+- **Eval results and gates.** Submit results in a fixed schema (`prompt`, `version`,
+  `metric`, `score`, `run_id`, `evaluator`, `metadata`). A gate on a tag requires the latest
+  score per metric to meet `min` (higher is better) / `max` (lower is better) rules and,
+  optionally, be at least as good as the current version. `force` with a reason bypasses
+  a failing gate and is recorded. Rollback never runs the gate.
+- **Leaderboard and diff.** Versions x metrics with the latest score, sortable by any
+  column; text diff of two versions plus `model_config` and variable changes. Promote
+  warns when a version needs new template variables (`strict` refuses instead).
+- **Client** (`pip install promptdock`). One API in library mode (`Client(db_url=...)`,
+  straight to Postgres) and server mode (`Client(base_url=..., token=...)`): `get_prompt`
+  returns a `Prompt` with `.render(**values)`, `.version`, `.model_config`. Sandboxed
+  rendering with `MissingVariableError`, 60 s cache, last-known-good fallback when the
+  database or server is down, optional snapshot file for cold starts.
+- **REST server** (`pip install promptdock[server]`, `promptdock serve`). OpenAPI docs at
+  `/docs`, ETag/304 on the prompt fetch. No user accounts: listens on 127.0.0.1 by default,
+  optional shared `PROMPTDOCK_TOKEN`, warning when exposed without one; actor via the
+  `X-Actor` header.
+- **Dashboard** (`pip install promptdock[ui]`, `promptdock serve --ui`). Prompts, versions,
+  tags with promote (gate result shown) and rollback (confirm), leaderboard with a
+  score-over-versions chart per metric, diff, audit log.
+- **CLI.** `migrate`, `serve`, `prompts list`, `versions list|show`, `promote`, `rollback`,
+  `history`, `evals push`, `export` / `push` (YAML files; never overwrites, never moves
+  `prod`), `gate set|show|clear`, `leaderboard`, `diff`, `mcp`.
+- **MCP server** (`pip install promptdock[mcp]`, `promptdock mcp`). Tools for agents:
+  `list_prompts`, `get_prompt`, `create_version`, `compare_versions`, `get_leaderboard`,
+  and `promote` only with `--allow-promote` (never forced); actor `mcp:<OS username>`.
+- **Docker image** `ghcr.io/shreyamhetre/promptdock` (migrates, then serves API and
+  dashboard) and `docker compose --profile server up` for local use.
+- Read-only database views with names instead of ids: `v_prompt_status`, `v_versions`,
+  `v_tags`, `v_tag_history`, `v_eval_results`.
+- Examples for OpenAI, Anthropic and LangChain, and an LLM-as-judge eval script.
+- No telemetry or usage tracking.
+
+[Unreleased]: https://github.com/shreyamhetre/PromptDock/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/shreyamhetre/PromptDock/releases/tag/v0.1.0

promptdock-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing
+
+## Setup
+
+1. Install [uv](https://docs.astral.sh/uv/) and Docker.
+2. Install dependencies: `uv sync`
+3. Install git hooks: `uv run pre-commit install`
+4. Start a local Postgres: `docker compose up -d`
+5. Copy `.env.example` to `.env` (or export `DATABASE_URL`).
+
+## Checks
+
+```bash
+uv run ruff check .        # lint
+uv run ruff format .       # format
+uv run mypy                # type check
+uv run pytest              # tests (DB tests start Postgres via testcontainers)
+```
+
+Tests use Postgres 16 by default. CI runs Python 3.10–3.13 against Postgres 14 and 17;
+to try another version locally: `PROMPTDOCK_TEST_POSTGRES_IMAGE=postgres:14 uv run pytest`.
+
+## Dashboard
+
+The UI source lives in `ui/` (React + Vite + Recharts). Build it into the Python package
+with `cd ui && npm ci && npm run build` (output: `src/promptdock/ui/static/`, git-ignored
+but included in the wheel). For live reload, run `promptdock serve` and `npm run dev`
+(it proxies API calls to port 8000).
+
+## Workflow
+
+- `main` is protected: open a pull request, get one review, keep CI green.
+- Track work as GitHub Issues with a milestone per phase.
+- Keep business logic in `src/promptdock/core/`; backends and server routes only call into it.

promptdock-0.1.0/Dockerfile

@@ -0,0 +1,34 @@
+# PromptDock server + dashboard.
+#   docker build -t promptdock .
+#   docker run -p 8000:8000 -e DATABASE_URL=postgresql://... -e PROMPTDOCK_TOKEN=... promptdock
+# Configure with DATABASE_URL (required) and PROMPTDOCK_TOKEN (optional, recommended: the
+# container listens on 0.0.0.0, so without a token anyone who can reach it has access).
+
+# 1. Build the dashboard (Node is only needed here, never at runtime).
+FROM node:22-slim AS ui
+WORKDIR /build/ui
+COPY ui/package.json ui/package-lock.json ./
+RUN npm ci --no-audit --no-fund
+COPY ui/ ./
+RUN npm run build
+
+# 2. Build the wheel with the dashboard inside it.
+FROM python:3.12-slim AS wheel
+COPY --from=ghcr.io/astral-sh/uv:0.13 /uv /bin/uv
+WORKDIR /build
+COPY pyproject.toml README.md LICENSE ./
+COPY src ./src
+COPY --from=ui /build/src/promptdock/ui/static ./src/promptdock/ui/static
+RUN uv build --wheel --out-dir /dist
+
+# 3. Runtime: just the installed package.
+FROM python:3.12-slim
+RUN useradd --create-home --uid 10001 promptdock
+COPY --from=wheel /dist /tmp/dist
+RUN pip install --no-cache-dir --timeout 120 --retries 5 "$(ls /tmp/dist/*.whl)[server,ui]" \
+    && rm -rf /tmp/dist
+USER promptdock
+EXPOSE 8000
+HEALTHCHECK --interval=30s --timeout=5s --start-period=20s \
+  CMD python -c "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/health')"
+CMD ["sh", "-c", "promptdock migrate && exec promptdock serve --ui --host 0.0.0.0 --port 8000"]

promptdock-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shreya Mhetre and Parth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

promptdock-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.5
+Name: promptdock
+Version: 0.1.0
+Summary: Focused prompt versioning: immutable versions, movable tags, eval-gated promotion.
+Project-URL: Homepage, https://github.com/shreyamhetre/PromptDock
+Project-URL: Repository, https://github.com/shreyamhetre/PromptDock
+Project-URL: Issues, https://github.com/shreyamhetre/PromptDock/issues
+Project-URL: Changelog, https://github.com/shreyamhetre/PromptDock/blob/main/CHANGELOG.md
+Author: Shreya Mhetre, Parth
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: alembic>=1.13
+Requires-Dist: httpx>=0.27
+Requires-Dist: jinja2>=3.1
+Requires-Dist: psycopg[binary]>=3.1
+Requires-Dist: pydantic>=2.6
+Requires-Dist: pyyaml>=6
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: typer>=0.12
+Provides-Extra: all
+Requires-Dist: fastapi>=0.110; extra == 'all'
+Requires-Dist: mcp<3,>=2.3; extra == 'all'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: fastapi>=0.110; extra == 'dev'
+Requires-Dist: mcp<3,>=2.3; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: testcontainers[postgres]>=4; extra == 'dev'
+Requires-Dist: types-pyyaml; extra == 'dev'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.3; extra == 'mcp'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'server'
+Provides-Extra: ui
+Requires-Dist: fastapi>=0.110; extra == 'ui'
+Requires-Dist: uvicorn[standard]>=0.29; extra == 'ui'
+Description-Content-Type: text/markdown
+
+# PromptDock
+
+Focused prompt versioning. PromptDock stores **immutable prompt versions**, points **tags**
+(`dev`, `preprod`, `prod`, or your own) at them, and attaches **eval results** so a tag can only
+move to a version that passes its gate. Promote and rollback move a pointer, never your code.
+
+> Status: 0.1 — early. The API may still change before 1.0.
+
+PromptDock collects **no telemetry or usage data**. It only talks to your own Postgres and,
+if you run one, your own PromptDock server.
+
+## Ways to use it
+
+| Mode | Install | Run |
+| --- | --- | --- |
+| Library | `pip install promptdock` | import and use |
+| Server | `pip install promptdock[server]` | `promptdock serve` |
+| Server + UI | `pip install promptdock[ui]` | `promptdock serve --ui` |
+| Docker | `docker run ghcr.io/shreyamhetre/promptdock` | — |
+
+All modes use Postgres (14 or newer), configured with `DATABASE_URL`. Python 3.10+.
+
+The idea in one table — apps always ask for a **tag**; you move tags, never app code:
+
+| Step | What you do | Versions | dev | preprod | prod |
+| --- | --- | --- | --- | --- | --- |
+| 1 | save the prompt | v1 | – | – | – |
+| 2 | promote v1 to dev, then preprod, then prod | v1 | v1 | v1 | v1 |
+| 3 | edit and save | v1, v2 | v1 | v1 | v1 |
+| 4 | promote v2 to dev, preprod, prod (evals pass the gate) | v1, v2 | v2 | v2 | v2 |
+| 5 | v2 misbehaves: roll back prod | v1, v2 | v2 | v2 | **v1** |
+
+## Quickstart (library mode)
+
+```bash
+export DATABASE_URL=postgresql://user:password@localhost:5432/promptdock
+promptdock migrate
+```
+
+```python
+from promptdock import Client
+
+client = Client()  # reads DATABASE_URL; or Client("postgresql://...", actor="shreya")
+
+client.create_prompt("support-bot")
+client.create_version(
+    "support-bot",
+    [
+        {"role": "system", "content": "You support {{ product }}."},
+        {"role": "user", "content": "{{ question }}"},
+    ],
+    model_config={"model": "gpt-4o", "temperature": 0.2},
+    commit_message="first version",
+)
+client.promote("support-bot", "prod", 1)  # recorded with actor = your OS username
+
+# In your app: always ask for a tag, never a hard-coded version.
+prompt = client.get_prompt("support-bot", tag="prod")
+messages = prompt.render(product="PromptDock", question="How do I roll back?")
+# call your LLM with messages and prompt.model_config
+
+client.rollback("support-bot", "prod")  # apps pick this up within the cache TTL (60 s)
+```
+
+Reads are cached for `cache_ttl` seconds (default 60). If the database is unreachable,
+`get_prompt` returns the last version it fetched and logs a warning; pass
+`snapshot_path="prompts.json"` to keep those copies on disk for restarts.
+
+## Quickstart (server mode)
+
+```bash
+pip install "promptdock[server]"
+promptdock migrate
+promptdock serve                      # http://127.0.0.1:8000, API docs at /docs
+```
+
+```python
+from promptdock import Client
+
+client = Client(base_url="http://127.0.0.1:8000")  # same methods as library mode
+prompt = client.get_prompt("support-bot", tag="prod")
+```
+
+Any language can call the REST API, e.g.
+`curl "http://127.0.0.1:8000/prompts/support-bot?tag=prod"`.
+
+**Who did it:** send `X-Actor: <name>` on changes (the Python client sends its `actor`,
+which defaults to your OS username). It is recorded in the history, not verified.
+
+### Securing your server
+
+There are no user accounts. `promptdock serve` only listens on
+this machine by default. To share it, either run it on a private network or set a shared
+token: `PROMPTDOCK_TOKEN=... promptdock serve --host 0.0.0.0`. Every request except
+`/health` must then send `Authorization: Bearer <token>`; clients pass `token=...` (or set
+`PROMPTDOCK_TOKEN`). Listening on `0.0.0.0` without a token prints a warning.
+
+## Quickstart (Docker)
+
+```bash
+docker run -p 8000:8000   -e DATABASE_URL=postgresql://user:password@db-host:5432/promptdock   -e PROMPTDOCK_TOKEN=change-me   ghcr.io/shreyamhetre/promptdock
+```
+
+The container runs `promptdock migrate`, then serves the API and dashboard on port 8000
+(`/docs`, `/ui/`). It listens on `0.0.0.0`, so set `PROMPTDOCK_TOKEN` unless it runs on a
+private network. To try it locally with a bundled Postgres:
+`docker compose --profile server up -d`.
+
+## Dashboard
+
+```bash
+pip install "promptdock[ui]"
+promptdock serve --ui          # http://127.0.0.1:8000/ui/
+```
+
+Prompts list, versions and tags, a sortable leaderboard with a score-over-versions chart
+per metric, diffs between any two versions, and the audit log. You can promote (the gate
+result is shown) and roll back (with a confirm step). It asks once for your name (sent as
+`X-Actor`) and, if the server has one, the token; both stay in your browser. No Node is
+needed to run it.
+
+## Command line
+
+The CLI connects like the client: `PROMPTDOCK_URL` (+ `PROMPTDOCK_TOKEN`) for a server,
+otherwise `DATABASE_URL`. Changes are recorded with `--actor` (default: your OS username).
+
+```bash
+promptdock export ./prompts                  # one YAML file per prompt (latest version)
+# ...edit ./prompts/support-bot.yaml...
+promptdock push ./prompts --tag dev -m "friendlier tone"   # new versions only for changed files
+promptdock evals push results.jsonl          # eval results, one JSON object per line
+promptdock promote support-bot prod 3 --reason "evals passed"
+promptdock rollback support-bot prod --reason "complaints"
+promptdock versions list support-bot
+promptdock history support-bot prod
+```
+
+`push` never overwrites anything and never moves `prod`; promote to `prod` explicitly.
+
+```bash
+promptdock gate set support-bot prod --min accuracy=0.85 --max latency_ms=1200
+promptdock leaderboard support-bot --sort accuracy
+promptdock diff support-bot 3 7
+```
+
+A gate uses the latest result per metric; a missing metric fails. `--force --reason ...`
+bypasses a failing gate and is recorded. Rollback never runs the gate.
+
+## AI agents (MCP)
+
+`pip install "promptdock[mcp]"`, then add PromptDock to your agent's MCP config. For
+Claude Desktop (`claude_desktop_config.json`) or Cursor (`.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "promptdock": {
+      "command": "promptdock",
+      "args": ["mcp"],
+      "env": { "DATABASE_URL": "postgresql://user:password@localhost:5432/promptdock" }
+    }
+  }
+}
+```
+
+Use `PROMPTDOCK_URL` (+ `PROMPTDOCK_TOKEN`) instead of `DATABASE_URL` to go through a
+server. Tools: `list_prompts`, `get_prompt`, `create_version`, `compare_versions`,
+`get_leaderboard`. `promote` is only offered with `"args": ["mcp", "--allow-promote"]`,
+gates still apply, and agents can never force. Agent changes are recorded with the actor
+`mcp:<your OS username>`.
+
+## Development
+
+See [CONTRIBUTING.md](https://github.com/shreyamhetre/PromptDock/blob/main/CONTRIBUTING.md). The dashboard source is in `ui/` (React + Vite + Recharts):
+`cd ui && npm ci && npm run build` writes the built files into `src/promptdock/ui/static/`.
+
+## License
+
+MIT