[codex] integrate discovery interface contract extension

.github/workflows/community-smoke.yml

@@ -116,7 +116,7 @@ jobs:
             speckit-preview-high-html; do
             test -f ".claude/skills/$preview_skill/SKILL.md"
           done
-          test -f .claude/skills/speckit-discovery-feasibility/SKILL.md
+          test -f .claude/skills/speckit-discovery-contract/SKILL.md
           test -f .claude/skills/speckit-intake-visual-design/SKILL.md
           test -f .claude/skills/speckit-intake-prd/SKILL.md
           test -f .claude/skills/speckit-intake-test-cases/SKILL.md
@@ -190,8 +190,8 @@ jobs:
                 done
                 ;;
               discovery)
-                test -f .claude/skills/speckit-discovery-feasibility/SKILL.md
-                grep -q "evidence-backed feasibility study" .claude/skills/speckit-discovery-feasibility/SKILL.md
+                test -f .claude/skills/speckit-discovery-contract/SKILL.md
+                grep -q "interface-contract discovery facilitator" .claude/skills/speckit-discovery-contract/SKILL.md
                 ;;
               intake)
                 test -f .claude/skills/speckit-intake-visual-design/SKILL.md
@@ -208,8 +208,7 @@ jobs:
 
           /tmp/specify-community-smoke-venv/bin/specify extension remove discovery --force
           /tmp/specify-community-smoke-venv/bin/specify extension add discovery
-          test -f .claude/skills/speckit-discovery-feasibility/SKILL.md
-          test -f .claude/skills/speckit-discovery-decision/SKILL.md
+          test -f .claude/skills/speckit-discovery-contract/SKILL.md
 
           /tmp/specify-community-smoke-venv/bin/specify preset resolve plan-template | tee resolve-plan-template.txt
           grep -q "workflow-preset" resolve-plan-template.txt

extensions/catalog.community.json

@@ -1041,10 +1041,10 @@
     "discovery": {
       "name": "Spec Kit Discovery Extension",
       "id": "discovery",
-      "description": "Run technical discovery commands for feasibility, technology selection, scenario-specific technical decisions, legacy codebase assessment, implementation understanding, and proof-of-concept validation.",
+      "description": "Validate pre-development interface feasibility by finding the key interface design from uc.md, spec.md, or arch.md and producing one verified interface contract artifact.",
       "author": "bigsmartben",
-      "version": "0.2.0",
-      "download_url": "https://github.com/bigsmartben/spec-kit-discovery/archive/refs/tags/v0.2.0.zip",
+      "version": "0.3.0",
+      "download_url": "https://github.com/bigsmartben/spec-kit-discovery/archive/38f660c815f3ef95d80f143dac6c6411b12a9f04.zip",
       "repository": "https://github.com/bigsmartben/spec-kit-discovery",
       "homepage": "https://github.com/bigsmartben/spec-kit-discovery",
       "documentation": "https://github.com/bigsmartben/spec-kit-discovery/blob/main/docs/usage.md",
@@ -1056,21 +1056,24 @@
         "speckit_version": ">=0.1.0"
       },
       "provides": {
-        "commands": 6,
+        "commands": 1,
         "hooks": 0
       },
       "tags": [
         "discovery",
-        "workflow",
-        "validation",
-        "feasibility",
-        "decision"
+        "interface-contract",
+        "api",
+        "event",
+        "webhook",
+        "technical-validation",
+        "pre-development",
+        "validation"
       ],
       "verified": false,
       "downloads": 0,
       "stars": 0,
       "created_at": "2026-06-23T00:00:00Z",
-      "updated_at": "2026-06-23T00:00:00Z"
+      "updated_at": "2026-07-06T00:00:00Z"
     },
     "docguard": {
       "name": "DocGuard — CDD Enforcement",

extensions/catalog.json

@@ -120,8 +120,8 @@
     "discovery": {
       "name": "Spec Kit Discovery Extension",
       "id": "discovery",
-      "version": "0.2.0",
-      "description": "Run technical discovery commands for feasibility, technology selection, scenario-specific technical decisions, legacy codebase assessment, implementation understanding, and proof-of-concept validation",
+      "version": "0.3.0",
+      "description": "Validate pre-development interface feasibility by finding the key interface design from uc.md, spec.md, or arch.md and producing one verified interface contract artifact",
       "author": "bigsmartben",
       "repository": "https://github.com/bigsmartben/spec-kit-discovery",
       "license": "MIT",
@@ -130,15 +130,17 @@
         "speckit_version": ">=0.1.0"
       },
       "provides": {
-        "commands": 6
+        "commands": 1
       },
       "tags": [
         "discovery",
-        "feasibility",
-        "selection",
-        "codebase",
-        "poc",
-        "decision"
+        "interface-contract",
+        "api",
+        "event",
+        "webhook",
+        "technical-validation",
+        "pre-development",
+        "validation"
       ]
     },
     "repository-governance": {

extensions/discovery/.gitignore

@@ -1,36 +1,16 @@
 .DS_Store
 Thumbs.db
-__pycache__/
-*.py[cod]
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-.coverage
-htmlcov/
 
 # Local editor state
 .idea/
 .vscode/
 *.swp
 *.swo
 
-# Python environments and builds
-.venv/
-venv/
-dist/
-build/
-*.egg-info/
-*.zip
-.env
-.env.*
-!.env.example
-
 # Spec Kit local-only config generated by installed extensions
 .specify/extensions/**/*-config.local.yml
 
 # Logs and temporary files
 *.log
-.tmp/
 tmp/
 temp/
-.worktrees/

extensions/discovery/CATALOG-SUBMISSION.md

@@ -2,31 +2,32 @@
 
 Extension ID: discovery
 Name: Spec Kit Discovery Extension
-Version: 0.2.0
-Description: Run technical discovery commands for feasibility, technology selection, scenario-specific technical decisions, legacy codebase assessment, implementation understanding, and proof-of-concept validation.
+Version: 0.3.0
+Description: Validate pre-development interface feasibility by finding the key interface design from uc.md, spec.md, or arch.md, validating that design with non-persistent evidence, and producing one verified interface contract artifact.
 Author: bigsmartben
 Repository URL: https://github.com/bigsmartben/spec-kit-discovery
-Download URL: https://github.com/bigsmartben/spec-kit-discovery/archive/refs/tags/v0.2.0.zip
+Source commit SHA: 38f660c815f3ef95d80f143dac6c6411b12a9f04
+Download URL: https://github.com/bigsmartben/spec-kit-discovery/archive/38f660c815f3ef95d80f143dac6c6411b12a9f04.zip
 Documentation URL: https://github.com/bigsmartben/spec-kit-discovery#readme
 License: MIT
 Required Spec Kit version: >=0.1.0
-Commands count: 6
+Commands count: 1
 Hooks count: 0
-Tags: discovery, feasibility, selection, codebase, poc, decision
+Tags: discovery, interface-contract, api, event, webhook, technical-validation, pre-development, validation
 
 ## Key Features
 
-- Adds `speckit.discovery.feasibility`, `speckit.discovery.techselect`, and `speckit.discovery.codebase`.
-- Adds `speckit.discovery.codebase-api-imp` for source-backed implementation overviews.
-- Adds `speckit.discovery.poc` for bounded proof-of-concept planning and validation.
-- Adds `speckit.discovery.decision` with `type: api|performance|migration|ux|compatibility` routing.
-- Keeps outputs focused on evidence, assumptions, unknowns, planning decisions, and validation scope before formal implementation planning.
+- Adds `/speckit.discovery.contract` as the single public discovery command.
+- Extracts candidate interface designs from `uc.md`, `spec.md`, or `arch.md`.
+- Selects the key source-backed interface design to validate before formal development.
+- Produces one persistent artifact: `interface-contract.md`.
+- Keeps validation evidence non-persistent and embedded in the contract.
 
 ## Testing Performed
 
-- Validated the bundled manifest with `ExtensionManifest`.
-- Ran `uv run pytest tests/integrations/test_cli.py -k "community_extensions_and_workflow_preset_auto_installed or no_git_keeps_community_defaults"`.
-- Ran `uv run pytest tests/test_arch_templates.py tests/test_presets.py -k "community_smoke_checks_wheel_assets_and_extension_dev_reinstall or init_next_steps_do_not_list_arch_as_core_workflow"`.
-- Built the CLI wheel with `uv build --wheel` and verified `specify_cli/core_pack/extensions/discovery/extension.yml` and representative command/template files were included.
-- Smoke-tested `specify init`, `specify extension remove discovery --force`, and `specify extension add discovery` in a temporary project.
-- Verified release `v0.2.0` installs with `Commands: 6`.
+- Confirmed source `commands/` contains only `discovery.md`.
+- Confirmed source `templates/` contains only `interface-contract.md`.
+- Confirmed source `extension.yml` registers `speckit.discovery.contract` with `commands/discovery.md`.
+- Checked old command/template naming residuals with `rg`; no matches.
+- Ran `git diff --check`; passed.
+- Checked Markdown/YAML trailing whitespace with `rg`; no matches.

extensions/discovery/CHANGELOG.md

@@ -1,12 +1,22 @@
 # Changelog
 
+## [0.3.0] - 2026-07-06
+
+### Changed
+
+- Refocused the extension on pre-development interface feasibility validation.
+- Replaced the broad six-command discovery surface with `/speckit.discovery.contract`.
+- Added `templates/interface-contract.md` as the core verified interface contract artifact.
+- Updated documentation and manifest metadata to describe key interface design discovery from `uc.md`, `spec.md`, or `arch.md`, selected-design validation, and non-persistent validation evidence.
+- Tightened the workflow so `interface-contract.md` is the only persistent output artifact.
+
 ## [0.2.0] - 2026-06-23
 
 ### Changed
 
-- Consolidated API integration, performance, data migration, UX workflow, and compatibility discovery into `speckit.discovery.decision` with type-specific routing.
-- Updated documentation to describe the six-command public interface.
-- Replaced references to the old API integration command with `/speckit.discovery.decision type: api`.
+- Introduced an intermediate legacy decision-routing surface for API integration, performance, data migration, UX workflow, and compatibility discovery.
+- Updated documentation for the then-current multi-command public interface.
+- Replaced earlier API integration references with that legacy decision route.
 
 ## [0.1.0] - 2026-06-23