@enjoys/context-engine 1.0.0 → 1.0.2

package/data/commands/dart.json

@@ -0,0 +1,216 @@
+{
+  "name": "dart",
+  "description": "Dart SDK command-line tool",
+  "category": "mobile",
+  "platforms": [
+    "linux",
+    "macos",
+    "windows"
+  ],
+  "shells": [
+    "bash",
+    "zsh",
+    "fish",
+    "powershell"
+  ],
+  "subcommands": [
+    {
+      "name": "analyze",
+      "description": "Analyze the project's Dart code.",
+      "args": [
+        {
+          "name": "[directory]",
+          "type": "path",
+          "required": false,
+          "description": "The directory to analyze"
+        }
+      ],
+      "options": [
+        {
+          "name": "--fatal-infos",
+          "description": "Treat info level issues as fatal."
+        },
+        {
+          "name": "--fatal-warnings",
+          "description": "Treat warning level issues as fatal."
+        }
+      ],
+      "examples": [
+        "dart analyze",
+        "dart analyze lib/"
+      ]
+    },
+    {
+      "name": "compile",
+      "description": "Compile Dart to various formats.",
+      "args": [],
+      "options": [],
+      "examples": [
+        "dart compile exe bin/myapp.dart",
+        "dart compile js bin/myapp.dart"
+      ]
+    },
+    {
+      "name": "create",
+      "description": "Create a new Dart project.",
+      "args": [
+        {
+          "name": "<directory>",
+          "type": "path",
+          "required": true,
+          "description": "Directory to create the project in"
+        }
+      ],
+      "options": [
+        {
+          "name": "--template",
+          "short": "-t",
+          "description": "The template used to generate the project.",
+          "type": "string"
+        }
+      ],
+      "examples": [
+        "dart create cli_app",
+        "dart create -t server-shelf server_app"
+      ]
+    },
+    {
+      "name": "format",
+      "description": "Idiomatically format Dart source code.",
+      "args": [
+        {
+          "name": "[files or directories...]",
+          "type": "path",
+          "required": false,
+          "description": "The files or directories to format"
+        }
+      ],
+      "options": [
+        {
+          "name": "--output",
+          "short": "-o",
+          "description": "Set where to write formatted output [write|show|json|none].",
+          "type": "string"
+        },
+        {
+          "name": "--set-exit-if-changed",
+          "description": "Return exit code 1 if there are any formatting changes."
+        }
+      ],
+      "examples": [
+        "dart format lib/",
+        "dart format -o none --set-exit-if-changed ."
+      ]
+    },
+    {
+      "name": "pub",
+      "description": "Work with packages.",
+      "args": [],
+      "options": [],
+      "examples": [
+        "dart pub get",
+        "dart pub upgrade",
+        "dart pub add http"
+      ]
+    },
+    {
+      "name": "run",
+      "description": "Run a Dart program.",
+      "args": [
+        {
+          "name": "<executable>",
+          "type": "string",
+          "required": true,
+          "description": "The program to run"
+        },
+        {
+          "name": "[args...]",
+          "type": "string",
+          "required": false,
+          "description": "Arguments to pass to the program"
+        }
+      ],
+      "options": [
+        {
+          "name": "--enable-asserts",
+          "description": "Enable assert statements."
+        },
+        {
+          "name": "--enable-experiment",
+          "description": "Enable one or more experimental features.",
+          "type": "string"
+        }
+      ],
+      "examples": [
+        "dart run bin/myapp.dart",
+        "dart run test"
+      ]
+    },
+    {
+      "name": "test",
+      "description": "Run tests for a project.",
+      "args": [
+        {
+          "name": "[files or directories...]",
+          "type": "path",
+          "required": false,
+          "description": "The tests to run"
+        }
+      ],
+      "options": [
+        {
+          "name": "--name",
+          "short": "-n",
+          "description": "A regular expression matching the name of the test to run.",
+          "type": "string"
+        },
+        {
+          "name": "--tags",
+          "short": "-t",
+          "description": "Run only tests with all of the specified tags.",
+          "type": "string"
+        }
+      ],
+      "examples": [
+        "dart test",
+        "dart test test/my_test.dart"
+      ]
+    }
+  ],
+  "globalOptions": [
+    {
+      "name": "--verbose",
+      "short": "-v",
+      "description": "Show additional command output."
+    },
+    {
+      "name": "--version",
+      "description": "Print the Dart SDK version."
+    },
+    {
+      "name": "--help",
+      "short": "-h",
+      "description": "Print this usage information."
+    }
+  ],
+  "examples": [
+    "dart run bin/myapp.dart",
+    "dart pub get",
+    "dart format lib/",
+    "dart test"
+  ],
+  "relatedCommands": [
+    "flutter"
+  ],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "version",
+        "description": "Dart SDK Version",
+        "command": "dart --version 2>/dev/null",
+        "parser": "text",
+        "cacheFor": 3600
+      }
+    ]
+  }
+}

package/data/commands/dbmate.json

@@ -0,0 +1,257 @@
+{
+  "name": "dbmate",
+  "description": "Dbmate is a lightweight, framework-agnostic database migration tool written in Go. It supports PostgreSQL, MySQL, SQLite, ClickHouse, and BigQuery with plain SQL migrations.",
+  "category": "database-orm",
+  "platforms": ["linux", "macos", "windows"],
+  "shells": ["bash", "zsh", "fish", "powershell"],
+  "subcommands": [
+    {
+      "name": "new",
+      "description": "Create a new migration file with a timestamp prefix. The file contains empty -- migrate:up and -- migrate:down sections for writing SQL.",
+      "args": [
+        {"name": "name", "type": "string", "required": true, "description": "Name for the migration (used in the filename)"}
+      ],
+      "options": [],
+      "examples": [
+        "dbmate new create_users_table",
+        "dbmate new add_email_to_users",
+        "dbmate new create_orders_and_items",
+        "dbmate new add_index_on_users_email",
+        "dbmate -d ./migrations/postgres new create_sessions_table"
+      ]
+    },
+    {
+      "name": "up",
+      "description": "Apply all pending migrations in chronological order. Creates the database if it does not exist. Skips migrations that have already been applied.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL (overrides DATABASE_URL)", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name containing the database URL (default: DATABASE_URL)", "type": "string"},
+        {"name": "--migrations-dir", "short": "-d", "description": "Path to the migrations directory", "type": "string"},
+        {"name": "--migrations-table", "description": "Name of the migrations tracking table (default: schema_migrations)", "type": "string"},
+        {"name": "--no-dump-schema", "description": "Skip updating the schema dump file after migration"},
+        {"name": "--strict", "description": "Fail if migrations are applied out of order"},
+        {"name": "--verbose", "description": "Show verbose output including SQL being executed"}
+      ],
+      "examples": [
+        "dbmate up",
+        "dbmate -u 'postgres://user:pass@localhost:5432/mydb?sslmode=disable' up",
+        "dbmate -e MY_DATABASE_URL up",
+        "dbmate -d ./db/migrations up",
+        "dbmate up --strict",
+        "dbmate up --verbose",
+        "dbmate up --no-dump-schema"
+      ]
+    },
+    {
+      "name": "down",
+      "description": "Roll back the most recently applied migration by executing its -- migrate:down section.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--migrations-dir", "short": "-d", "description": "Path to migrations directory", "type": "string"},
+        {"name": "--migrations-table", "description": "Name of the migrations tracking table", "type": "string"},
+        {"name": "--no-dump-schema", "description": "Skip updating the schema dump file"},
+        {"name": "--verbose", "description": "Show verbose output"}
+      ],
+      "examples": [
+        "dbmate down",
+        "dbmate -u 'postgres://user:pass@localhost:5432/mydb' down",
+        "dbmate down --verbose"
+      ]
+    },
+    {
+      "name": "rollback",
+      "description": "Alias for the 'down' command. Roll back the most recently applied migration.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--migrations-dir", "short": "-d", "description": "Path to migrations directory", "type": "string"},
+        {"name": "--verbose", "description": "Show verbose output"}
+      ],
+      "examples": [
+        "dbmate rollback",
+        "dbmate rollback --verbose"
+      ]
+    },
+    {
+      "name": "migrate",
+      "description": "Apply all pending migrations (alias for 'up'). Creates the database if it doesn't exist and applies migrations in order.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--migrations-dir", "short": "-d", "description": "Path to migrations directory", "type": "string"},
+        {"name": "--strict", "description": "Fail if migrations are out of order"},
+        {"name": "--verbose", "description": "Show verbose output"}
+      ],
+      "examples": [
+        "dbmate migrate",
+        "dbmate -u 'mysql://root:pass@localhost:3306/mydb' migrate",
+        "dbmate migrate --strict"
+      ]
+    },
+    {
+      "name": "create",
+      "description": "Create the database specified in the connection URL if it does not already exist.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"}
+      ],
+      "examples": [
+        "dbmate create",
+        "dbmate -u 'postgres://user:pass@localhost:5432/newdb' create",
+        "dbmate -e STAGING_DATABASE_URL create"
+      ]
+    },
+    {
+      "name": "drop",
+      "description": "Drop the database specified in the connection URL. WARNING: This permanently destroys the database and all data.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"}
+      ],
+      "examples": [
+        "dbmate drop",
+        "dbmate -u 'postgres://user:pass@localhost:5432/testdb' drop",
+        "dbmate -e TEST_DATABASE_URL drop"
+      ]
+    },
+    {
+      "name": "dump",
+      "description": "Dump the current database schema to a file (default: db/schema.sql). Uses the database's native dump utility (pg_dump, mysqldump, etc.).",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--schema-file", "short": "-s", "description": "Path for the schema dump file (default: db/schema.sql)", "type": "string"}
+      ],
+      "examples": [
+        "dbmate dump",
+        "dbmate dump -s ./schema/database.sql",
+        "dbmate -u 'postgres://user:pass@localhost:5432/mydb' dump"
+      ]
+    },
+    {
+      "name": "status",
+      "description": "Display the status of all migrations, showing which have been applied and which are pending.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--migrations-dir", "short": "-d", "description": "Path to migrations directory", "type": "string"},
+        {"name": "--migrations-table", "description": "Name of the migrations tracking table", "type": "string"}
+      ],
+      "examples": [
+        "dbmate status",
+        "dbmate -u 'postgres://user:pass@localhost:5432/mydb' status",
+        "dbmate -d ./db/migrations status"
+      ]
+    },
+    {
+      "name": "wait",
+      "description": "Wait for the database to become available. Useful in Docker/container environments where the database may take time to start.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--wait-timeout", "description": "Timeout in seconds to wait for database (default: 60s)", "type": "string"}
+      ],
+      "examples": [
+        "dbmate wait",
+        "dbmate wait --wait-timeout=120",
+        "dbmate -u 'postgres://user:pass@db:5432/mydb' wait && dbmate up",
+        "dbmate wait && dbmate migrate"
+      ]
+    },
+    {
+      "name": "load",
+      "description": "Load the schema file (db/schema.sql) directly into the database, bypassing individual migrations. Useful for initializing a new database from a known schema.",
+      "args": [],
+      "options": [
+        {"name": "--url", "short": "-u", "description": "Database connection URL", "type": "string"},
+        {"name": "--env", "short": "-e", "description": "Environment variable name for database URL", "type": "string"},
+        {"name": "--schema-file", "short": "-s", "description": "Path to the schema file to load", "type": "string"}
+      ],
+      "examples": [
+        "dbmate load",
+        "dbmate load -s ./schema/database.sql",
+        "dbmate -u 'postgres://user:pass@localhost:5432/newdb' load"
+      ]
+    }
+  ],
+  "globalOptions": [
+    {"name": "--help", "short": "-h", "description": "Show help information"},
+    {"name": "--version", "short": "-V", "description": "Show dbmate version"},
+    {"name": "--url", "short": "-u", "description": "Database connection URL (default: $DATABASE_URL)", "type": "string"},
+    {"name": "--env", "short": "-e", "description": "Environment variable name containing the database URL", "type": "string"},
+    {"name": "--migrations-dir", "short": "-d", "description": "Path to the migrations directory (default: ./db/migrations)", "type": "string"},
+    {"name": "--migrations-table", "description": "Name of the table to track applied migrations (default: schema_migrations)", "type": "string"},
+    {"name": "--schema-file", "short": "-s", "description": "Path to the schema dump file (default: ./db/schema.sql)", "type": "string"},
+    {"name": "--no-dump-schema", "description": "Do not update the schema dump file after migrating"},
+    {"name": "--wait-timeout", "description": "Timeout in seconds for the wait command (default: 60)", "type": "string"},
+    {"name": "--strict", "description": "Fail if migrations would be applied out of order"},
+    {"name": "--verbose", "description": "Show verbose output"}
+  ],
+  "examples": [
+    "dbmate new create_users_table",
+    "dbmate up",
+    "dbmate down",
+    "dbmate status",
+    "dbmate create",
+    "dbmate drop",
+    "dbmate dump",
+    "dbmate load",
+    "dbmate wait && dbmate up",
+    "DATABASE_URL='postgres://user:pass@localhost:5432/mydb' dbmate up",
+    "dbmate -u 'sqlite:./data/app.db' up",
+    "dbmate -u 'mysql://root:pass@localhost:3306/mydb' migrate",
+    "dbmate -d ./migrations -s ./schema.sql up --no-dump-schema",
+    "dbmate rollback",
+    "dbmate new add_indexes && dbmate up"
+  ],
+  "relatedCommands": ["flyway", "alembic", "liquibase", "pg_dump", "psql", "mysql"],
+  "contextEngine": {
+    "detectors": [
+      {
+        "name": "dbmate_migrations_detect",
+        "description": "Detect dbmate migration files",
+        "command": "find . -path '*/db/migrations/*.sql' -type f 2>/dev/null | head -10",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "dbmate_schema_detect",
+        "description": "Detect dbmate schema dump file",
+        "command": "find . -path '*/db/schema.sql' -type f 2>/dev/null | head -3",
+        "parser": "lines",
+        "cacheFor": 60
+      },
+      {
+        "name": "dbmate_version",
+        "description": "Get installed dbmate version",
+        "command": "dbmate --version 2>/dev/null || echo 'not installed'",
+        "parser": "lines",
+        "cacheFor": 120
+      },
+      {
+        "name": "dbmate_database_url_detect",
+        "description": "Check if DATABASE_URL environment variable is set",
+        "command": "echo ${DATABASE_URL:+set} || echo 'not set'",
+        "parser": "lines",
+        "cacheFor": 30
+      },
+      {
+        "name": "dbmate_status_detect",
+        "description": "Get current migration status",
+        "command": "dbmate status 2>/dev/null | head -15 || echo 'not available'",
+        "parser": "lines",
+        "cacheFor": 30
+      }
+    ]
+  }
+}