@carllee1983/dbcli 1.30.0 → 1.32.0

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "dbcli-agent",
+  "version": "1.32.0",
+  "description": "Database CLI skill and command reference for AI agents.",
+  "contextFileName": "AGENTS.md"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carllee1983/dbcli",
-  "version": "1.30.0",
+  "version": "1.32.0",
   "description": "Database CLI for AI agents",
   "type": "module",
   "publishConfig": {
@@ -44,6 +44,15 @@
   "files": [
     "dist/",
     "assets/",
+    "plugins/",
+    "skills/",
+    ".codex-plugin/",
+    ".claude-plugin/",
+    ".cursor-plugin/",
+    ".agents/",
+    ".cursor/",
+    ".github/skills/",
+    "gemini-extension.json",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -53,15 +62,19 @@
     "build": "bun run scripts/build.ts",
     "prepublishOnly": "bun run build",
     "release:check": "bash scripts/release-check.sh",
+    "plugin:sync": "bun run scripts/sync-plugin-assets.ts --write",
+    "plugin:check": "bun run scripts/sync-plugin-assets.ts",
     "test": "bun test",
     "test:unit": "bun test tests/unit tests/core",
     "test:integration": "bun test tests/integration",
     "test:docker": "docker compose -f docker-compose.test.yml up -d --wait && bun test tests/integration/adapters; docker compose -f docker-compose.test.yml down",
     "docs:check": "bun run scripts/check-user-docs.ts",
+    "skill:check": "bun run scripts/check-skill-parity.ts",
+    "platform:check": "bun run scripts/check-platform-parity.ts",
     "typecheck": "tsc --noEmit --pretty false",
     "test:perf": "bun test ./tests/perf/*.bench.ts",
-    "lint": "eslint src tests --ext .ts --max-warnings=0",
-    "lint:fix": "eslint src tests --ext .ts --fix --max-warnings=0",
+    "lint": "eslint src tests scripts --ext .ts --max-warnings=0",
+    "lint:fix": "eslint src tests scripts --ext .ts --fix --max-warnings=0",
     "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\""
   },
   "dependencies": {
@@ -82,7 +95,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
-    "@happy-dom/global-registrator": "^20.9.0",
+    "@happy-dom/global-registrator": "^20.10.6",
     "@inquirer/prompts": "^8.4.3",
     "@testing-library/react": "^16.3.2",
     "@types/bun": "latest",
@@ -92,7 +105,7 @@
     "autoprefixer": "^10.5.0",
     "dts-bundle-generator": "^9.5.1",
     "eslint": "^10.4.0",
-    "happy-dom": "^20.9.0",
+    "happy-dom": "^20.10.6",
     "postcss": "^8.5.14",
     "prettier": "^3.8.3",
     "tailwindcss": "3.4.1",

package/plugins/dbcli-agent/.codex-plugin/plugin.json

@@ -0,0 +1,40 @@
+{
+  "name": "dbcli-agent",
+  "version": "1.31.0",
+  "description": "Database CLI skill and command reference for AI agents",
+  "author": {
+    "name": "Carl Lee",
+    "url": "https://github.com/CarlLee1983"
+  },
+  "homepage": "https://github.com/CarlLee1983/dbcli",
+  "repository": "https://github.com/CarlLee1983/dbcli",
+  "license": "MIT",
+  "keywords": [
+    "database",
+    "cli",
+    "ai-agent",
+    "postgresql",
+    "mysql",
+    "mongodb",
+    "redis",
+    "elasticsearch"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "dbcli Agent",
+    "shortDescription": "Use dbcli safely from Codex.",
+    "longDescription": "Installs the dbcli agent skill and reference guide so Codex can inspect schemas, query databases, respect blacklist boundaries, and recover from database errors through the dbcli command workflow.",
+    "developerName": "Carl Lee",
+    "category": "Productivity",
+    "capabilities": [
+      "Database",
+      "Local CLI",
+      "Agent Skill"
+    ],
+    "defaultPrompt": [
+      "Inspect my database with dbcli.",
+      "Show schema safely with dbcli.",
+      "Diagnose a dbcli query failure."
+    ]
+  }
+}

package/plugins/dbcli-agent/INSTALL.md

@@ -0,0 +1,241 @@
+# dbcli Agent Plugin Installation
+
+This repo follows the same installation shape as
+`DietrichGebert/ponytail`: the repository root contains the plugin metadata, a
+marketplace file, and portable agent skill/rule copies.
+
+## What Gets Installed
+
+The canonical skill files are:
+
+- `skills/dbcli/SKILL.md`
+- `skills/dbcli/reference.md`
+
+The skill tells agents how to use dbcli safely, including permission checks,
+blacklist rules, schema confirmation, dry runs, recovery envelopes, and the
+`bunx @carllee1983/dbcli <command>` fallback when `dbcli` is not globally
+installed.
+
+## Claude Code
+
+In Claude Code:
+
+```text
+/plugin marketplace add CarlLee1983/dbcli
+/plugin install dbcli-agent@dbcli-agent
+```
+
+Start a new Claude Code session after install so the skill is reloaded.
+
+## GitHub Copilot CLI
+
+From a shell:
+
+```bash
+copilot plugin marketplace add CarlLee1983/dbcli
+copilot plugin install dbcli-agent@dbcli-agent
+```
+
+In an interactive Copilot CLI session, use the slash equivalents:
+
+```text
+/plugin marketplace add CarlLee1983/dbcli
+/plugin install dbcli-agent@dbcli-agent
+```
+
+For instruction-only project fallback, this repo also ships:
+
+```text
+.github/skills/dbcli/SKILL.md
+.github/skills/dbcli/reference.md
+```
+
+## Codex
+
+From a shell:
+
+```bash
+codex plugin marketplace add CarlLee1983/dbcli
+codex
+```
+
+Then open `/plugins`, select the dbcli Agent marketplace, and install
+`dbcli-agent`. Start a new thread after install.
+
+The same marketplace install also applies to the Codex desktop app after it
+reloads plugin metadata.
+
+## Antigravity CLI
+
+Antigravity (`agy`) can install from the GitHub repository URL:
+
+```bash
+agy plugin install https://github.com/CarlLee1983/dbcli
+```
+
+The repo also includes `gemini-extension.json`, matching the extension layout
+used by Gemini/Antigravity-style agents.
+
+## Cursor
+
+Cursor can install plugins from Cursor Agent chat when the plugin is available
+in Cursor's plugin marketplace:
+
+```text
+/add-plugin dbcli-agent
+```
+
+Or search for `dbcli-agent` in Cursor's plugin marketplace.
+
+This repository includes Cursor plugin metadata at:
+
+```text
+.cursor-plugin/plugin.json
+```
+
+For Cursor marketplace review/indexing:
+
+1. Push this repository to GitHub and keep it public.
+2. Keep the single-plugin layout at the repository root:
+   `.cursor-plugin/plugin.json` plus `skills/dbcli/`.
+3. Confirm the manifest name is lowercase kebab-case (`dbcli-agent`) and that
+   `category`, `tags`, `homepage`, `repository`, and `skills` are present.
+4. Submit the repository URL to the Cursor plugin team for review/indexing.
+   The Cursor plugin template currently points submitters to the Cursor
+   community Slack or `kniparko@anysphere.com`.
+5. After indexing, users can install from Cursor Agent chat with
+   `/add-plugin dbcli-agent` or by searching the Cursor plugin marketplace.
+
+The repo also keeps an instruction-file fallback for projects that want to
+vendor the dbcli rule and reference directly.
+
+### Fallback A: from an existing dbcli checkout
+
+Run this from the target project where Cursor should see dbcli:
+
+```bash
+DBCLI_REPO=/path/to/dbcli
+mkdir -p .cursor/rules .cursor/skills/dbcli
+cp "$DBCLI_REPO/.cursor/rules/dbcli.mdc" .cursor/rules/dbcli.mdc
+cp "$DBCLI_REPO/.cursor/skills/dbcli/reference.md" .cursor/skills/dbcli/reference.md
+```
+
+### Fallback B: clone dbcli first
+
+```bash
+git clone https://github.com/CarlLee1983/dbcli.git /tmp/dbcli-agent-plugin
+cd /path/to/your/project
+mkdir -p .cursor/rules .cursor/skills/dbcli
+cp /tmp/dbcli-agent-plugin/.cursor/rules/dbcli.mdc .cursor/rules/dbcli.mdc
+cp /tmp/dbcli-agent-plugin/.cursor/skills/dbcli/reference.md .cursor/skills/dbcli/reference.md
+```
+
+### Fallback C: from this repo checkout
+
+When your shell is already inside the dbcli checkout, the local installer writes
+the Cursor files into the current working directory:
+
+```bash
+plugins/dbcli-agent/scripts/install-skills.sh cursor
+```
+
+Open or reload the target project in Cursor after installing fallback files.
+Cursor should read:
+
+```text
+.cursor/rules/dbcli.mdc
+.cursor/skills/dbcli/reference.md
+```
+
+## Local Checkout Installer
+
+If you are working from a checkout and want to install the skill into all
+supported local targets at once:
+
+```bash
+plugins/dbcli-agent/scripts/install-skills.sh all
+```
+
+Single-target installs:
+
+```bash
+plugins/dbcli-agent/scripts/install-skills.sh codex
+plugins/dbcli-agent/scripts/install-skills.sh claude
+plugins/dbcli-agent/scripts/install-skills.sh copilot
+plugins/dbcli-agent/scripts/install-skills.sh antigravity
+plugins/dbcli-agent/scripts/install-skills.sh agy
+plugins/dbcli-agent/scripts/install-skills.sh cursor
+```
+
+`agy` is an alias for `antigravity`.
+
+Install targets:
+
+| Target | Installed files |
+| --- | --- |
+| Codex | `~/.codex/skills/dbcli/SKILL.md` and `reference.md` |
+| Claude Code | `~/.claude/skills/dbcli/SKILL.md` and `reference.md` |
+| GitHub Copilot CLI | `.github/skills/dbcli/SKILL.md` and `reference.md` |
+| Antigravity | `~/.gemini/antigravity-cli/skills/dbcli/SKILL.md` and `reference.md` |
+| Cursor | `.cursor/rules/dbcli.mdc` and `.cursor/skills/dbcli/reference.md` |
+
+## Optional: Install the dbcli CLI
+
+The skill can run dbcli through `bunx`, so a global CLI install is not required.
+For a persistent `dbcli` executable in `PATH`, run:
+
+```bash
+plugins/dbcli-agent/scripts/install-dbcli.sh
+```
+
+The installer prefers Bun:
+
+```bash
+bun install -g @carllee1983/dbcli
+```
+
+If Bun is unavailable but npm exists, it falls back to:
+
+```bash
+npm install -g @carllee1983/dbcli
+```
+
+## Verify Installation
+
+For local script installs, check the files for the targets you installed:
+
+```bash
+test -f ~/.codex/skills/dbcli/SKILL.md
+test -f ~/.claude/skills/dbcli/SKILL.md
+test -f ~/.gemini/antigravity-cli/skills/dbcli/SKILL.md
+test -f .github/skills/dbcli/SKILL.md
+test -f .cursor/rules/dbcli.mdc
+```
+
+For marketplace installs, open a new agent session and confirm the `dbcli`
+skill is listed or can be invoked by a database task.
+
+## Keep Plugin Assets In Sync
+
+The portable copies are generated from:
+
+- `assets/SKILL.md`
+- `assets/reference.md`
+
+After editing either source file, refresh and check every copy:
+
+```bash
+bun run plugin:sync
+bun run plugin:check
+```
+
+## Troubleshooting
+
+If an agent cannot run `dbcli`, first check whether Bun is available:
+
+```bash
+bunx @carllee1983/dbcli --version
+```
+
+If that works, the skill can use dbcli without a global install. If it fails,
+install Bun or use the persistent CLI installer above.

package/plugins/dbcli-agent/README.md

@@ -0,0 +1,89 @@
+# dbcli Agent Plugin
+
+Agent skill bundle for dbcli.
+
+Full installation instructions: [INSTALL.md](./INSTALL.md).
+
+This repo can be installed like the Ponytail plugin. Use the command set for
+your agent:
+
+## Claude Code
+
+```text
+/plugin marketplace add CarlLee1983/dbcli
+/plugin install dbcli-agent@dbcli-agent
+```
+
+## Codex
+
+```bash
+codex plugin marketplace add CarlLee1983/dbcli
+```
+
+Then open `/plugins` and install `dbcli-agent`.
+
+## GitHub Copilot CLI
+
+```bash
+copilot plugin marketplace add CarlLee1983/dbcli
+copilot plugin install dbcli-agent@dbcli-agent
+```
+
+## Antigravity CLI
+
+```bash
+agy plugin install https://github.com/CarlLee1983/dbcli
+```
+
+## Cursor
+
+In Cursor Agent chat:
+
+```text
+/add-plugin dbcli-agent
+```
+
+Or search for `dbcli-agent` in Cursor's plugin marketplace. Fallback copy
+instructions are in [INSTALL.md](./INSTALL.md#cursor).
+
+Cursor marketplace review/indexing requires the GitHub repository URL and the
+root `.cursor-plugin/plugin.json`; submission steps are documented in
+[INSTALL.md](./INSTALL.md#cursor).
+
+Installing it as a plugin makes the `dbcli` skill available from
+`skills/dbcli/SKILL.md`, with the full command reference next to it.
+
+The same bundled skill files can also be installed into Claude Code,
+Antigravity, and Cursor without requiring a global `dbcli` install:
+
+```bash
+plugins/dbcli-agent/scripts/install-skills.sh all
+plugins/dbcli-agent/scripts/install-skills.sh codex
+plugins/dbcli-agent/scripts/install-skills.sh claude
+plugins/dbcli-agent/scripts/install-skills.sh antigravity
+plugins/dbcli-agent/scripts/install-skills.sh agy
+plugins/dbcli-agent/scripts/install-skills.sh cursor
+```
+
+Install targets:
+
+- Codex: `~/.codex/skills/dbcli/`
+- Claude Code: `~/.claude/skills/dbcli/`
+- Antigravity: `~/.gemini/antigravity-cli/skills/dbcli/`
+- Cursor: `.cursor/rules/dbcli.mdc` plus `.cursor/skills/dbcli/reference.md`
+
+The skill uses `dbcli` when it is already installed and falls back to
+`bunx @carllee1983/dbcli <command>` when the executable is not on `PATH`.
+
+For a persistent global CLI, run:
+
+```bash
+plugins/dbcli-agent/scripts/install-dbcli.sh
+```
+
+The plugin skill files are copied from `assets/SKILL.md` and
+`assets/reference.md`. Refresh them with:
+
+```bash
+bun run plugin:sync
+```

package/plugins/dbcli-agent/scripts/install-dbcli.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if command -v bun >/dev/null 2>&1; then
+  bun install -g @carllee1983/dbcli
+  exit 0
+fi
+
+if command -v npm >/dev/null 2>&1; then
+  npm install -g @carllee1983/dbcli
+  exit 0
+fi
+
+echo "Install Bun or npm first, then run: bun install -g @carllee1983/dbcli" >&2
+exit 1

package/plugins/dbcli-agent/scripts/install-skills.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+plugin_root="$(cd "${script_dir}/.." && pwd)"
+skill_dir="${plugin_root}/skills/dbcli"
+skill_file="${skill_dir}/SKILL.md"
+reference_file="${skill_dir}/reference.md"
+
+usage() {
+  cat <<'EOF'
+Usage:
+  install-skills.sh [all|codex|claude|copilot|antigravity|agy|cursor]
+
+Installs the bundled dbcli skill files into agent-specific locations:
+  codex        ~/.codex/skills/dbcli/
+  claude       ~/.claude/skills/dbcli/
+  copilot      ./.github/skills/dbcli/
+  antigravity  ~/.gemini/antigravity-cli/skills/dbcli/
+  cursor       ./.cursor/rules/dbcli.mdc + ./.cursor/skills/dbcli/reference.md
+
+Default: all
+EOF
+}
+
+copy_pair() {
+  local target_dir="$1"
+  mkdir -p "${target_dir}"
+  cp "${skill_file}" "${target_dir}/SKILL.md"
+  cp "${reference_file}" "${target_dir}/reference.md"
+  printf 'installed %s\n' "${target_dir}"
+}
+
+install_cursor() {
+  mkdir -p ".cursor/rules" ".cursor/skills/dbcli"
+  cp "${skill_file}" ".cursor/rules/dbcli.mdc"
+  cp "${reference_file}" ".cursor/skills/dbcli/reference.md"
+  printf 'installed %s\n' ".cursor/rules/dbcli.mdc"
+  printf 'installed %s\n' ".cursor/skills/dbcli/reference.md"
+}
+
+install_platform() {
+  local platform="$1"
+  case "${platform}" in
+    codex)
+      copy_pair "${HOME}/.codex/skills/dbcli"
+      ;;
+    claude)
+      copy_pair "${HOME}/.claude/skills/dbcli"
+      ;;
+    copilot)
+      copy_pair ".github/skills/dbcli"
+      ;;
+    antigravity|agy)
+      copy_pair "${HOME}/.gemini/antigravity-cli/skills/dbcli"
+      ;;
+    cursor)
+      install_cursor
+      ;;
+    all)
+      install_platform codex
+      install_platform claude
+      install_platform copilot
+      install_platform antigravity
+      install_platform cursor
+      ;;
+    -h|--help|help)
+      usage
+      ;;
+    *)
+      printf 'Unknown platform: %s\n\n' "${platform}" >&2
+      usage >&2
+      exit 2
+      ;;
+  esac
+}
+
+if [[ ! -f "${skill_file}" || ! -f "${reference_file}" ]]; then
+  printf 'Missing bundled skill files under %s\n' "${skill_dir}" >&2
+  exit 1
+fi
+
+install_platform "${1:-all}"