💫 Toolkit to help you get started with SDD or any other process!
Add /selftest.extension core extension to test other extensions (#1758)
Dhilipd3fc0567434e
diff --git a/extensions/catalog.json b/extensions/catalog.jsonindex bdebd83dd..f06cfe574 100644--- a/extensions/catalog.json+++ b/extensions/catalog.json@@ -1,6 +1,21 @@{"schema_version": "1.0",- "updated_at": "2026-02-03T00:00:00Z",+ "updated_at": "2026-03-10T00:00:00Z","catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.json",- "extensions": {}-}+ "extensions": {+ "selftest": {+ "name": "Spec Kit Self-Test Utility",+ "id": "selftest",+ "version": "1.0.0",+ "description": "Verifies catalog extensions by programmatically walking through the discovery, installation, and registration lifecycle.",+ "author": "spec-kit-core",+ "repository": "https://github.com/github/spec-kit",+ "download_url": "https://github.com/github/spec-kit/releases/download/selftest-v1.0.0/selftest.zip",+ "tags": [+ "testing",+ "core",+ "utility"+ ]+ }+ }+}\ No newline at end of filediff --git a/extensions/selftest/commands/selftest.md b/extensions/selftest/commands/selftest.mdnew file mode 100644index 000000000..6f5655edd--- /dev/null+++ b/extensions/selftest/commands/selftest.md@@ -0,0 +1,69 @@+---+description: "Validate the lifecycle of an extension from the catalog."+---++# Extension Self-Test: `$ARGUMENTS`++This command drives a self-test simulating the developer experience with the `$ARGUMENTS` extension.++## Goal++Validate the end-to-end lifecycle (discovery, installation, registration) for the extension: `$ARGUMENTS`.+If `$ARGUMENTS` is empty, you must tell the user to provide an extension name, for example: `/speckit.selftest.extension linear`.++## Steps++### Step 1: Catalog Discovery Validation++Check if the extension exists in the Spec Kit catalog.+Execute this command and verify that it completes successfully and that the returned extension ID exactly matches `$ARGUMENTS`. If the command fails or the ID does not match `$ARGUMENTS`, fail the test.++```bash+specify extension info "$ARGUMENTS"+```++### Step 2: Simulate Installation++First, try to add the extension to the current workspace configuration directly. If the catalog provides the extension as `install_allowed: false` (discovery-only), this step is *expected* to fail.++```bash+specify extension add "$ARGUMENTS"+```++Then, simulate adding the extension by installing it from its catalog download URL, which should bypass the restriction.+Obtain the extension's `download_url` from the catalog metadata (for example, via a catalog info command or UI), then run:++```bash+specify extension add "$ARGUMENTS" --from "<download_url>"+```++### Step 3: Registration Verification++Once the `add` command completes, verify the installation by checking the project configuration.+Use terminal tools (like `cat`) to verify that the following file contains a record for `$ARGUMENTS`.++```bash+cat .specify/extensions/.registry/$ARGUMENTS.json+```++### Step 4: Verification Report++Analyze the standard output of the three steps.+Generate a terminal-style test output format detailing the results of discovery, installation, and registration. Return this directly to the user.++Example output format:+```text+============================= test session starts ==============================+collected 3 items++test_selftest_discovery.py::test_catalog_search [PASS/FAIL]+ Details: [Provide execution result of specify extension search]++test_selftest_installation.py::test_extension_add [PASS/FAIL]+ Details: [Provide execution result of specify extension add]++test_selftest_registration.py::test_config_verification [PASS/FAIL]+ Details: [Provide execution result of registry record verification]++============================== [X] passed in ... ==============================+```diff --git a/extensions/selftest/extension.yml b/extensions/selftest/extension.ymlnew file mode 100644index 000000000..2d47fdf2c--- /dev/null+++ b/extensions/selftest/extension.yml@@ -0,0 +1,16 @@+schema_version: "1.0"+extension:+ id: selftest+ name: Spec Kit Self-Test Utility+ version: 1.0.0+ description: Verifies catalog extensions by programmatically walking through the discovery, installation, and registration lifecycle.+ author: spec-kit-core+ repository: https://github.com/github/spec-kit+ license: MIT+requires:+ speckit_version: ">=0.2.0"+provides:+ commands:+ - name: speckit.selftest.extension+ file: commands/selftest.md+ description: Validate the lifecycle of an extension from the catalog.