@enjoys/context-engine 1.0.0 → 1.0.1

package/data/commands/adb.json

@@ -0,0 +1,322 @@
+{
+  "name": "adb",
+  "description": "Android Debug Bridge",
+  "category": "mobile",
+  "platforms": [
+    "linux",
+    "macos",
+    "windows"
+  ],
+  "shells": [
+    "bash",
+    "zsh",
+    "fish",
+    "powershell"
+  ],
+  "subcommands": [
+    {
+      "name": "devices",
+      "description": "list connected devices",
+      "args": [],
+      "options": [
+        {
+          "name": "-l",
+          "description": "list device qualifiers"
+        }
+      ],
+      "examples": [
+        "adb devices",
+        "adb devices -l"
+      ]
+    },
+    {
+      "name": "connect",
+      "description": "connect to a device via TCP/IP",
+      "args": [
+        {
+          "name": "host[:port]",
+          "type": "string",
+          "required": true,
+          "description": "host name and optional port"
+        }
+      ],
+      "options": [],
+      "examples": [
+        "adb connect 192.168.1.100:5555"
+      ]
+    },
+    {
+      "name": "disconnect",
+      "description": "disconnect from a TCP/IP device",
+      "args": [
+        {
+          "name": "[host[:port]]",
+          "type": "string",
+          "required": false,
+          "description": "host name and optional port"
+        }
+      ],
+      "options": [],
+      "examples": [
+        "adb disconnect",
+        "adb disconnect 192.168.1.100:5555"
+      ]
+    },
+    {
+      "name": "push",
+      "description": "copy local files/directories to device",
+      "args": [
+        {
+          "name": "local",
+          "type": "path",
+          "required": true,
+          "description": "local path"
+        },
+        {
+          "name": "remote",
+          "type": "path",
+          "required": true,
+          "description": "remote path"
+        }
+      ],
+      "options": [
+        {
+          "name": "--sync",
+          "description": "only push files that are newer on the host than the device"
+        }
+      ],
+      "examples": [
+        "adb push file.txt /sdcard/"
+      ]
+    },
+    {
+      "name": "pull",
+      "description": "copy files/directories from device",
+      "args": [
+        {
+          "name": "remote",
+          "type": "path",
+          "required": true,
+          "description": "remote path"
+        },
+        {
+          "name": "[local]",
+          "type": "path",
+          "required": false,
+          "description": "local path"
+        }
+      ],
+      "options": [
+        {
+          "name": "-a",
+          "description": "preserve file timestamp and mode"
+        }
+      ],
+      "examples": [
+        "adb pull /sdcard/file.txt ."
+      ]
+    },
+    {
+      "name": "install",
+      "description": "push a single package to the device and install it",
+      "args": [
+        {
+          "name": "package",
+          "type": "path",
+          "required": true,
+          "description": "apk package path"
+        }
+      ],
+      "options": [
+        {
+          "name": "-r",
+          "description": "replace existing application"
+        },
+        {
+          "name": "-t",
+          "description": "allow test packages"
+        },
+        {
+          "name": "-d",
+          "description": "allow version code downgrade"
+        },
+        {
+          "name": "-g",
+          "description": "grant all runtime permissions"
+        }
+      ],
+      "examples": [
+        "adb install myapp.apk",
+        "adb install -r myapp.apk"
+      ]
+    },
+    {
+      "name": "uninstall",
+      "description": "remove this app package from the device",
+      "args": [
+        {
+          "name": "package",
+          "type": "string",
+          "required": true,
+          "description": "package name (e.g. com.example.myapp)"
+        }
+      ],
+      "options": [
+        {
+          "name": "-k",
+          "description": "keep the data and cache directories"
+        }
+      ],
+      "examples": [
+        "adb uninstall com.example.myapp"
+      ]
+    },
+    {
+      "name": "shell",
+      "description": "run remote shell interactively or run shell command",
+      "args": [
+        {
+          "name": "[command]",
+          "type": "string",
+          "required": false,
+          "description": "command to run on device shell"
+        }
+      ],
+      "options": [
+        {
+          "name": "-T",
+          "description": "disable PTY allocation"
+        },
+        {
+          "name": "-t",
+          "description": "force PTY allocation"
+        },
+        {
+          "name": "-n",
+          "description": "don't read from stdin"
+        }
+      ],
+      "examples": [
+        "adb shell",
+        "adb shell ls -l",
+        "adb shell pm list packages"
+      ]
+    },
+    {
+      "name": "logcat",
+      "description": "view device log",
+      "args": [],
+      "options": [
+        {
+          "name": "-s",
+          "description": "set default filter to silent",
+          "type": "string"
+        },
+        {
+          "name": "-f",
+          "description": "output to file",
+          "type": "path"
+        },
+        {
+          "name": "-c",
+          "description": "clear (flush) the entire log and exit"
+        },
+        {
+          "name": "-d",
+          "description": "dump the log and then exit (don't block)"
+        }
+      ],
+      "examples": [
+        "adb logcat",
+        "adb logcat *:E",
+        "adb logcat | grep myapp"
+      ]
+    },
+    {
+      "name": "reboot",
+      "description": "reboots the device",
+      "args": [
+        {
+          "name": "[bootloader|recovery|sideload|sideload-auto-reboot]",
+          "type": "string",
+          "required": false,
+          "description": "reboot target"
+        }
+      ],
+      "options": [],
+      "examples": [
+        "adb reboot",
+        "adb reboot bootloader"
+      ]
+    },
+    {
+      "name": "kill-server",
+      "description": "kill the server if it is running",
+      "args": [],
+      "options": [],
+      "examples": [
+        "adb kill-server"
+      ]
+    },
+    {
+      "name": "start-server",
+      "description": "ensure that there is a server running",
+      "args": [],
+      "options": [],
+      "examples": [
+        "adb start-server"
+      ]
+    }
+  ],
+  "globalOptions": [
+    {
+      "name": "-a",
+      "description": "listen on all network interfaces, not just localhost"
+    },
+    {
+      "name": "-d",
+      "description": "use USB device (error if multiple devices connected)"
+    },
+    {
+      "name": "-e",
+      "description": "use TCP/IP device (error if multiple TCP/IP devices available)"
+    },
+    {
+      "name": "-s",
+      "description": "use device with given serial",
+      "type": "string"
+    },
+    {
+      "name": "-H",
+      "description": "name of adb server host",
+      "type": "string"
+    },
+    {
+      "name": "-P",
+      "description": "port of adb server",
+      "type": "number"
+    }
+  ],
+  "examples": [
+    "adb devices",
+    "adb -s emulator-5554 shell",
+    "adb install app.apk",
+    "adb logcat -c"
+  ],
+  "relatedCommands": [
+    "fastlane",
+    "flutter"
+  ],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "devices",
+        "description": "Connected Android Devices",
+        "command": "adb devices 2>/dev/null",
+        "parser": "lines",
+        "cacheFor": 10,
+        "requiresCmd": "adb"
+      }
+    ]
+  }
+}

package/data/commands/alembic.json

@@ -0,0 +1,301 @@
+{
+  "name": "alembic",
+  "description": "Alembic is a lightweight database migration tool for SQLAlchemy, providing schema versioning, autogeneration of migrations, and branching support",
+  "category": "database-orm",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [
+    {
+      "name": "init",
+      "description": "Initialize a new Alembic environment, creating the migrations directory structure, alembic.ini configuration, and env.py script.",
+      "args": [
+        {"name": "directory", "type": "string", "required": true, "description": "Name of the migration directory to create (e.g., alembic, migrations)"}
+      ],
+      "options": [
+        {"name": "--template", "short": "-t", "description": "Template to use for the environment (generic, multidb, async, pylons)", "type": "string"},
+        {"name": "--package", "description": "Create __init__.py in the migration directory to make it a Python package"}
+      ],
+      "examples": [
+        "alembic init alembic",
+        "alembic init migrations",
+        "alembic init --template=async alembic",
+        "alembic init --template=multidb migrations",
+        "alembic init --package alembic"
+      ]
+    },
+    {
+      "name": "revision",
+      "description": "Create a new revision (migration) file. Supports both empty revisions and autogenerated ones based on model comparison.",
+      "args": [],
+      "options": [
+        {"name": "--message", "short": "-m", "description": "Message string for the revision", "type": "string"},
+        {"name": "--autogenerate", "description": "Auto-detect schema changes by comparing models with the database"},
+        {"name": "--head", "description": "Head revision to use as the parent (default: head)", "type": "string"},
+        {"name": "--splice", "description": "Allow a non-head revision as the parent, creating a branch"},
+        {"name": "--branch-label", "description": "Label for a new branch from this revision", "type": "string"},
+        {"name": "--version-path", "description": "Directory to store the revision file", "type": "string"},
+        {"name": "--rev-id", "description": "Custom revision identifier", "type": "string"},
+        {"name": "--depends-on", "description": "Revision(s) this depends on", "type": "string"},
+        {"name": "--sql", "description": "Produce SQL script instead of running the migration"}
+      ],
+      "examples": [
+        "alembic revision -m 'create users table'",
+        "alembic revision --autogenerate -m 'add email column'",
+        "alembic revision -m 'add orders' --head=branch1@head",
+        "alembic revision -m 'merge branches' --depends-on=abc123",
+        "alembic revision --autogenerate -m 'initial schema' --rev-id=001",
+        "alembic revision -m 'add index' --branch-label=feature"
+      ]
+    },
+    {
+      "name": "upgrade",
+      "description": "Apply migration(s) to upgrade the database schema to a target revision. Can upgrade to the latest, a specific revision, or a relative number.",
+      "args": [
+        {"name": "revision", "type": "string", "required": true, "description": "Target revision (head, revision ID, or relative like +2)"}
+      ],
+      "options": [
+        {"name": "--sql", "description": "Output SQL statements instead of executing them"},
+        {"name": "--tag", "description": "Tag to pass to the migration environment", "type": "string"}
+      ],
+      "examples": [
+        "alembic upgrade head",
+        "alembic upgrade +1",
+        "alembic upgrade +2",
+        "alembic upgrade abc123def",
+        "alembic upgrade branch1@head",
+        "alembic upgrade head --sql",
+        "alembic upgrade head --tag=deploy_v2",
+        "alembic upgrade abc123:head --sql > migration.sql"
+      ]
+    },
+    {
+      "name": "downgrade",
+      "description": "Revert migration(s) to downgrade the database schema to a previous revision or by a relative number of steps.",
+      "args": [
+        {"name": "revision", "type": "string", "required": true, "description": "Target revision (base, revision ID, or relative like -1)"}
+      ],
+      "options": [
+        {"name": "--sql", "description": "Output SQL statements instead of executing them"},
+        {"name": "--tag", "description": "Tag to pass to the migration environment", "type": "string"}
+      ],
+      "examples": [
+        "alembic downgrade -1",
+        "alembic downgrade -2",
+        "alembic downgrade base",
+        "alembic downgrade abc123def",
+        "alembic downgrade head:-1 --sql",
+        "alembic downgrade base --sql > rollback.sql"
+      ]
+    },
+    {
+      "name": "current",
+      "description": "Display the current revision(s) active in the database. Shows which migration the database is currently at.",
+      "args": [],
+      "options": [
+        {"name": "--verbose", "short": "-v", "description": "Show detailed revision info including path and docstring"}
+      ],
+      "examples": [
+        "alembic current",
+        "alembic current --verbose"
+      ]
+    },
+    {
+      "name": "heads",
+      "description": "Show the head revision(s) of the migration tree. Multiple heads indicate unmerged branches.",
+      "args": [],
+      "options": [
+        {"name": "--verbose", "short": "-v", "description": "Show detailed revision info"},
+        {"name": "--resolve-dependencies", "description": "Include dependency information in output"}
+      ],
+      "examples": [
+        "alembic heads",
+        "alembic heads --verbose",
+        "alembic heads --resolve-dependencies"
+      ]
+    },
+    {
+      "name": "history",
+      "description": "Show the full history of revisions from oldest to newest. Useful for understanding the migration chain and branches.",
+      "args": [],
+      "options": [
+        {"name": "--verbose", "short": "-v", "description": "Show detailed revision info for each entry"},
+        {"name": "--rev-range", "short": "-r", "description": "Limit history to a specific range (e.g., base:head, abc123:def456)", "type": "string"},
+        {"name": "--indicate-current", "short": "-i", "description": "Mark the current database revision in the output"}
+      ],
+      "examples": [
+        "alembic history",
+        "alembic history --verbose",
+        "alembic history -r base:head",
+        "alembic history -r abc123:def456",
+        "alembic history --indicate-current",
+        "alembic history -r -3:current --verbose"
+      ]
+    },
+    {
+      "name": "branches",
+      "description": "Show all branch points in the migration graph where the revision history has diverged.",
+      "args": [],
+      "options": [
+        {"name": "--verbose", "short": "-v", "description": "Show detailed revision info"}
+      ],
+      "examples": [
+        "alembic branches",
+        "alembic branches --verbose"
+      ]
+    },
+    {
+      "name": "show",
+      "description": "Display details of a specific revision including its revision ID, parent, description, and file path.",
+      "args": [
+        {"name": "revision", "type": "string", "required": true, "description": "Revision identifier to show"}
+      ],
+      "options": [],
+      "examples": [
+        "alembic show head",
+        "alembic show abc123def",
+        "alembic show base"
+      ]
+    },
+    {
+      "name": "merge",
+      "description": "Create a merge revision that combines two or more branch heads into a single revision, resolving branch divergence.",
+      "args": [
+        {"name": "revisions", "type": "string", "required": true, "description": "Two or more revision identifiers to merge (space-separated)"}
+      ],
+      "options": [
+        {"name": "--message", "short": "-m", "description": "Message for the merge revision", "type": "string"},
+        {"name": "--branch-label", "description": "Label for the merged branch", "type": "string"},
+        {"name": "--rev-id", "description": "Custom revision identifier for the merge", "type": "string"}
+      ],
+      "examples": [
+        "alembic merge heads -m 'merge branches'",
+        "alembic merge abc123 def456 -m 'merge feature and hotfix'",
+        "alembic merge heads --branch-label=merged"
+      ]
+    },
+    {
+      "name": "stamp",
+      "description": "Set the alembic_version table to a specific revision without running any migration scripts. Useful for marking an already-migrated database.",
+      "args": [
+        {"name": "revision", "type": "string", "required": true, "description": "Revision to stamp (head, base, or specific ID)"}
+      ],
+      "options": [
+        {"name": "--sql", "description": "Output SQL statements instead of executing them"},
+        {"name": "--purge", "description": "Delete all entries from version table before stamping"},
+        {"name": "--tag", "description": "Tag to pass to the migration environment", "type": "string"}
+      ],
+      "examples": [
+        "alembic stamp head",
+        "alembic stamp base",
+        "alembic stamp abc123def",
+        "alembic stamp head --purge",
+        "alembic stamp head --sql"
+      ]
+    },
+    {
+      "name": "edit",
+      "description": "Open a specific revision file in the system editor for manual editing.",
+      "args": [
+        {"name": "revision", "type": "string", "required": true, "description": "Revision identifier to edit"}
+      ],
+      "options": [],
+      "examples": [
+        "alembic edit head",
+        "alembic edit abc123def"
+      ]
+    },
+    {
+      "name": "check",
+      "description": "Check if there are any new schema changes that have not been versioned as migrations. Returns exit code 0 if in sync, 1 if changes detected.",
+      "args": [],
+      "options": [],
+      "examples": [
+        "alembic check"
+      ]
+    },
+    {
+      "name": "ensure_version",
+      "description": "Ensure the alembic_version table exists in the database without applying any migrations.",
+      "args": [],
+      "options": [
+        {"name": "--sql", "description": "Output SQL statements instead of executing them"}
+      ],
+      "examples": [
+        "alembic ensure_version",
+        "alembic ensure_version --sql"
+      ]
+    },
+    {
+      "name": "list_templates",
+      "description": "List all available Alembic environment templates that can be used with the init command.",
+      "args": [],
+      "options": [],
+      "examples": [
+        "alembic list_templates"
+      ]
+    }
+  ],
+  "globalOptions": [
+    {"name": "--help", "short": "-h", "description": "Show help information"},
+    {"name": "--version", "description": "Show Alembic version"},
+    {"name": "--config", "short": "-c", "description": "Path to the Alembic configuration file (default: alembic.ini)", "type": "string"},
+    {"name": "--name", "short": "-n", "description": "Name of the section in the config file to use for Alembic config", "type": "string"},
+    {"name": "--raiseerr", "short": "-x", "description": "Raise a full stack trace on error instead of a short message"},
+    {"name": "-x", "description": "Additional arguments consumed by env.py (e.g., -x dbname=mydb)", "type": "string"}
+  ],
+  "examples": [
+    "alembic init alembic",
+    "alembic revision --autogenerate -m 'initial schema'",
+    "alembic revision -m 'add users table'",
+    "alembic upgrade head",
+    "alembic downgrade -1",
+    "alembic downgrade base",
+    "alembic current",
+    "alembic history --verbose",
+    "alembic heads",
+    "alembic merge heads -m 'merge branches'",
+    "alembic stamp head",
+    "alembic check",
+    "alembic upgrade head --sql > migration.sql"
+  ],
+  "relatedCommands": ["python", "pip", "flask", "django-admin", "poetry", "pipenv"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "alembic_ini_detect",
+        "description": "Detect alembic.ini configuration file",
+        "command": "find . -maxdepth 2 -name 'alembic.ini' -type f 2>/dev/null | head -3",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "alembic_env_detect",
+        "description": "Detect Alembic env.py and migration directory",
+        "command": "find . -path '*/alembic/env.py' -o -path '*/migrations/env.py' 2>/dev/null | head -5",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "alembic_versions_detect",
+        "description": "Detect Alembic revision files",
+        "command": "find . -path '*/versions/*.py' -type f 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "alembic_current_revision",
+        "description": "Get the current Alembic revision in the database",
+        "command": "alembic current 2>/dev/null || echo 'not available'",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "alembic_package_detect",
+        "description": "Detect alembic in Python requirements or setup files",
+        "command": "grep -r 'alembic' requirements*.txt setup.py pyproject.toml 2>/dev/null | head -5",
+        "parser": "lines",
+        "cacheFor": 60
+      }
+    ]
+  }
+}