Integrate preview extension v1.3.0

.github/workflows/community-smoke.yml

@@ -97,15 +97,7 @@ jobs:
             speckit-arch-reverse; do
             test -f ".claude/skills/$arch_skill/SKILL.md"
           done
-          for preview_skill in \
-            speckit-preview-low-md \
-            speckit-preview-low-html \
-            speckit-preview-mid-md \
-            speckit-preview-mid-html \
-            speckit-preview-high-md \
-            speckit-preview-high-html; do
-            test -f ".claude/skills/$preview_skill/SKILL.md"
-          done
+          test -f .claude/skills/speckit-preview-wireflow/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
@@ -135,15 +127,7 @@ jobs:
                 test "$(find .claude/skills -maxdepth 1 -type d -name 'speckit-arch-*' | wc -l)" -eq 0
                 ;;
               preview)
-                for preview_skill in \
-                  speckit-preview-low-md \
-                  speckit-preview-low-html \
-                  speckit-preview-mid-md \
-                  speckit-preview-mid-html \
-                  speckit-preview-high-md \
-                  speckit-preview-high-html; do
-                  test ! -d ".claude/skills/$preview_skill"
-                done
+                test ! -d .claude/skills/speckit-preview-wireflow
                 ;;
               discovery)
                 test "$(find .claude/skills -maxdepth 1 -type d -name 'speckit-discovery-*' | wc -l)" -eq 0
@@ -166,16 +150,8 @@ jobs:
                 grep -q "architecture planning contract" .claude/skills/speckit-arch-generate/SKILL.md
                 ;;
               preview)
-                for preview_skill in \
-                  speckit-preview-low-md \
-                  speckit-preview-low-html \
-                  speckit-preview-mid-md \
-                  speckit-preview-mid-html \
-                  speckit-preview-high-md \
-                  speckit-preview-high-html; do
-                  test -f ".claude/skills/$preview_skill/SKILL.md"
-                  grep -q "evidence-backed" ".claude/skills/$preview_skill/SKILL.md"
-                done
+                test -f .claude/skills/speckit-preview-wireflow/SKILL.md
+                grep -q "Input-to-Design Synthesis Pass" .claude/skills/speckit-preview-wireflow/SKILL.md
                 ;;
               discovery)
                 test -f .claude/skills/speckit-discovery-contract/SKILL.md

extensions/catalog.community.json

@@ -1,6 +1,6 @@
 {
   "schema_version": "1.0",
-  "updated_at": "2026-07-03T00:00:00Z",
+  "updated_at": "2026-07-06T00:00:00Z",
   "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.community.json",
   "extensions": {
     "agent-assign": {
@@ -2524,10 +2524,10 @@
     "preview": {
       "name": "Spec Kit Preview",
       "id": "preview",
-      "description": "Generate evidence-backed low, mid, or high fidelity previews from Spec Kit artifacts as Markdown or self-contained HTML",
+      "description": "Generate one fidelity-specific HTML design artifact from spec.md and uc.md inputs with required low, mid, or high fidelity",
       "author": "bigsmartben",
-      "version": "1.2.0",
-      "download_url": "https://github.com/bigsmartben/spec-kit-preview/archive/refs/tags/v1.2.0.zip",
+      "version": "1.3.0",
+      "download_url": "https://github.com/bigsmartben/spec-kit-preview/archive/refs/tags/v1.3.0.zip",
       "repository": "https://github.com/bigsmartben/spec-kit-preview",
       "homepage": "https://github.com/bigsmartben/spec-kit-preview",
       "documentation": "https://github.com/bigsmartben/spec-kit-preview/blob/main/README.md",
@@ -2539,22 +2539,21 @@
         "speckit_version": ">=0.8.10.dev0"
       },
       "provides": {
-        "commands": 6,
+        "commands": 1,
         "hooks": 0
       },
       "tags": [
         "preview",
         "prototype",
         "html",
-        "markdown",
         "wireflow",
         "ux"
       ],
       "verified": false,
       "downloads": 0,
       "stars": 0,
       "created_at": "2026-05-15T00:00:00Z",
-      "updated_at": "2026-07-01T00:00:00Z"
+      "updated_at": "2026-07-06T00:00:00Z"
     },
     "product": {
       "name": "Product Spec Extension",

extensions/catalog.json

@@ -1,6 +1,6 @@
 {
   "schema_version": "1.0",
-  "updated_at": "2026-07-03T00:00:00Z",
+  "updated_at": "2026-07-06T00:00:00Z",
   "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.json",
   "extensions": {
     "agent-context": {
@@ -96,8 +96,8 @@
     "preview": {
       "name": "Spec Kit Preview",
       "id": "preview",
-      "version": "1.2.0",
-      "description": "Generate evidence-backed low, mid, or high fidelity previews from Spec Kit artifacts as Markdown or self-contained HTML",
+      "version": "1.3.0",
+      "description": "Generate one fidelity-specific HTML design artifact from spec.md and uc.md inputs with required low, mid, or high fidelity",
       "author": "bigsmartben",
       "repository": "https://github.com/bigsmartben/spec-kit-preview",
       "license": "MIT",
@@ -106,13 +106,12 @@
         "speckit_version": ">=0.8.10.dev0"
       },
       "provides": {
-        "commands": 6
+        "commands": 1
       },
       "tags": [
         "preview",
         "prototype",
         "html",
-        "markdown",
         "wireflow",
         "ux"
       ]

extensions/preview/.gitignore

@@ -1,23 +1,6 @@
 .venv/
-venv/
 __pycache__/
-*.py[cod]
+*.pyc
 .pytest_cache/
-.mypy_cache/
-.ruff_cache/
-.coverage
-htmlcov/
 dist/
-build/
-*.egg-info/
 *.zip
-*.log
-.env
-.env.*
-!.env.example
-.tmp/
-tmp/
-temp/
-.DS_Store
-Thumbs.db
-.worktrees/

extensions/preview/CATALOG-SUBMISSION.md

@@ -2,40 +2,43 @@
 
 Extension ID: preview
 Name: Spec Kit Preview
-Version: 1.2.0
-Description: Generate evidence-backed low, mid, or high fidelity previews from Spec Kit artifacts as Markdown or self-contained HTML
+Version: 1.3.0
+Description: Generate one fidelity-specific HTML design artifact from spec.md and uc.md inputs with required low, mid, or high fidelity
 Author: bigsmartben
 Repository URL: https://github.com/bigsmartben/spec-kit-preview
-Download URL: https://github.com/bigsmartben/spec-kit-preview/archive/refs/tags/v1.2.0.zip
+Download URL: https://github.com/bigsmartben/spec-kit-preview/archive/refs/tags/v1.3.0.zip
 Documentation URL: https://github.com/bigsmartben/spec-kit-preview/blob/main/README.md
 License: MIT
 Required Spec Kit version: >=0.8.10.dev0
-Commands count: 6
+Commands count: 1
 Hooks count: 0
-Tags: preview, prototype, html, markdown, wireflow, ux
+Tags: preview, prototype, html, wireflow, ux
 
 ## Key Features
 
-- Adds `speckit.preview.low-md` and `speckit.preview.low-html`.
-- Adds `speckit.preview.mid-md` and `speckit.preview.mid-html`.
-- Adds `speckit.preview.high-md` and `speckit.preview.high-html`.
-- Generates `specs/<feature>/preview/wireflow-low.md`, `wireflow-mid.md`, or `wireflow-high.md`.
-- Generates matching `wireflow-low.html`, `wireflow-mid.html`, or `wireflow-high.html`.
-- Optionally adapts mid-fidelity structured intake artifacts through `schemas/preview/mid-ir-adapter.schema.json`.
-- Uses fixed templates under `templates/preview/` for output sections, table schemas, HTML shells, and preserved-review slots.
+- Adds `speckit.preview.wireflow` as the single preview command.
+- Requires `low`, `mid`, or `high` as the first command argument.
+- Generates one HTML design artifact at `specs/<feature>/preview/wireflow.html`.
+- Requires `spec.md` and `uc.md` as first-class source inputs for design synthesis.
+- Runs an Input-to-Design Synthesis Pass before composing the design artifact.
+- Preserves `schemas/preview/mid-ir-adapter.schema.json` as an optional supporting input boundary for `mid` fidelity.
+- Uses evidence and quality conclusions to improve the fidelity-specific design artifact by exposing supported flows, gaps, and design questions.
+- Uses fixed `templates/preview/wireflow.html` output structure with design input mapping, interaction, state, and preserved design-note slots.
 - Uses `schemas/preview/contract.json` and `schemas/preview/contract.schema.json` as the structural validation source.
-- Keeps previews self-contained with inline CSS and fidelity-appropriate JavaScript.
+- Keeps the preview self-contained with inline CSS and template-local JavaScript.
 - Explicitly avoids production source, spec, plan, and task file changes.
-- Captures coverage evidence, inferred assumptions, unsupported items, and unresolved questions.
 
 ## Testing Performed
 
-- `python3 -m py_compile tests/validate-extension.py`
-- `python3 tests/validate-extension.py`
-- Validated `schemas/preview/mid-ir-adapter.schema.json` with Draft 2020-12 schema checks and adapter smoke payloads.
-- Confirmed adapter smoke payloads reject empty page purpose, missing `source_refs` for covered items, and root-level upstream `contract_type`.
+- `python -m py_compile tests/validate-extension.py`
+- `python tests/validate-extension.py`
+- Validator verified the manifest registers one `speckit.preview.wireflow` command.
+- Validator verified the command/template file set contains only `commands/speckit.preview.wireflow.md` and `templates/preview/wireflow.html`.
+- Validator verified declared schema files, including `schemas/preview/mid-ir-adapter.schema.json`.
+- Validator verified documentation alignment for `speckit.preview.wireflow` and `wireflow.html`.
+
 ## Release Checklist
 
-- Create release `v1.2.0` from this revision.
+- Create release `v1.3.0` from this revision.
 - Install release ZIP in a fresh Spec Kit project:
-  `specify extension add preview --from https://github.com/bigsmartben/spec-kit-preview/archive/refs/tags/v1.2.0.zip`
+  `specify extension add preview --from https://github.com/bigsmartben/spec-kit-preview/archive/refs/tags/v1.3.0.zip`

extensions/preview/CHANGELOG.md

@@ -1,23 +1,29 @@
 # Changelog
 
+## v1.3.0
+
+- Replaces separate fidelity and format commands with one `speckit.preview.wireflow` command.
+- Requires `low`, `mid`, or `high` as the first command argument.
+- Makes HTML the only generated artifact at `specs/<feature>/preview/wireflow.html`.
+- Uses `spec.md` and `uc.md` as required primary inputs for input-to-design synthesis.
+- Keeps structured IR mapping non-blocking for `mid` fidelity: missing, partial, or unmappable IR falls back to primary design inputs and is reported as a design question or delivery quality issue.
+
 ## v1.2.0
 
 - Adds a preview-owned `schemas/preview/mid-ir-adapter.schema.json` ingest contract for evidence-backed mid-fidelity structured IR adaptation.
-- Updates `speckit.preview.mid-md` and `speckit.preview.mid-html` to optionally consume `structured-ir.yaml`, `ir-assertions.yaml`, and `ir-evidence-packet.md` when they can be mapped to the preview adapter contract.
-- Keeps structured IR mapping non-blocking: missing, partial, or unmappable IR falls back to existing Spec Kit artifacts and is reported as an evidence gap.
 - Updates package validation so declared schema files are driven by `schemas/preview/contract.json` instead of a hard-coded schema file list.
 
 ## v1.1.0
 
-- Adds six preview commands: `speckit.preview.low-md`, `speckit.preview.low-html`, `speckit.preview.mid-md`, `speckit.preview.mid-html`, `speckit.preview.high-md`, and `speckit.preview.high-html`.
-- Adds separate Markdown and HTML output designs for low, mid, and high fidelity preview artifacts.
-- Adds fixed preview templates under `templates/preview/` so command prompts no longer define output structure inline.
-- Adds schema-backed validation contracts under `schemas/preview/` for command/template structure checks.
-- Adds consistent active feature detection and update-preservation guidance across preview commands.
-- Strengthens package validation for command/template responsibility separation, output boundaries, and fidelity-specific contracts.
+- Replaces the six preview commands with one `speckit.preview.wireflow` command.
+- Requires `low`, `mid`, or `high` as the first command argument.
+- Makes HTML the only generated artifact at `specs/<feature>/preview/wireflow.html`.
+- Adds a unified `templates/preview/wireflow.html` template.
+- Adds explicit Input-to-Design Synthesis Pass rules for `spec.md` and `uc.md`.
+- Adds schema-backed validation contracts under `schemas/preview/` for single-command and single-template checks.
+- Strengthens package validation for command/template responsibility separation, output boundaries, and documentation alignment.
 
 ## v1.0.0
 
 - Initial release.
-- Adds `speckit.preview.html` for generating self-contained interactive HTML prototypes from Spec Kit feature artifacts.
-
+- Adds an initial self-contained interactive HTML preview flow for Spec Kit feature artifacts.