azcodr 1.4.0 → 1.5.1

package/.agents/skills/lets-build/references/project_readme_template.md

@@ -1,79 +1,79 @@
-# {{PROJECT_NAME}}
-
-> **{{PROJECT_TAGLINE_OR_MISSION}}**
-
----
-
-## 🌟 Architecture & Stack
-
-- **Architecture:** Hexagonal (Ports & Adapters) with strict systemic atomicity and zero-downtime database patterns.
-- **Language & Runtime:** {{LANGUAGE_AND_RUNTIME}}
-- **Package Manager & Build:** {{PACKAGE_MANAGER_AND_BUILD_TOOL}}
-- **Primary Transport:** {{TRANSPORT_PROTOCOL_AND_FRAMEWORK}}
-- **Persistence Engine:** {{DATABASE_ENGINE}} (Migrations via {{MIGRATION_TOOL}})
-- **Multi-Tenancy Isolation:** {{TENANCY_ISOLATION_MODEL}}
-- **Dynamic Extensibility:** Common Expression Language (CEL) / JSON Schema Draft 2020-12
-- **Observability:** OpenTelemetry (OTel) OTLP export over gRPC/HTTP
-- **Security & DevSecOps:** Semgrep SAST, Gitleaks, Trivy scanning, CycloneDX SBOM
-
----
-
-## 🗂️ Project Structure
-
-```
-.
-├── specs/                            # Canonical contract specifications
-│   ├── openapi/                      # OpenAPI 3.1 REST specifications
-│   ├── protobuf/                     # Protocol Buffers v3 definitions
-│   ├── schemas/                      # Universal JSON Schema Draft 2020-12
-│   └── tokens/                       # W3C DTCG Design Tokens
-├── src/                              # Hexagonal Application Source
-│   ├── domain/                       # Core Invariant Domain (Entities, Value Objects)
-│   ├── ports/                        # Primary (Use Cases) and Secondary (Repositories) Ports
-│   └── adapters/                     # Ingress (HTTP/gRPC) and Egress (SQL/Broker) Adapters
-├── tests/
-│   ├── unit/                         # Fast unit tests using test doubles
-│   ├── integration/                  # Adapter tests with transactional rollback
-│   ├── contracts/                    # Consumer contract tests (Pact)
-│   └── acceptance/                   # BDD Gherkin / Cucumber features
-├── deploy/                           # OCI Distroless Dockerfiles & Compose manifests
-├── docs/rules/                       # 28 cohesive single-responsibility architectural rules
-├── memory.md                         # Master memory hub & Lightweight ADR ledger
-└── AGENTS.md                         # Lean agentic directives (< 120 lines)
-```
-
----
-
-## ⚡ Quickstart & Development
-
-### 1. Prerequisites
-- {{PREREQUISITES_LIST}}
-- Docker & Docker Compose
-
-### 2. Environment Setup
-```bash
-cp .env.example .env
-```
-
-### 3. Install Dependencies
-```bash
-{{INSTALL_COMMAND}}
-```
-
-### 4. Run Development Environment
-```bash
-{{DEV_RUN_COMMAND}}
-```
-
-### 5. Run Tests & Verification
-```bash
-{{TEST_COMMAND}}
-```
-
----
-
-## 🏛️ Architecture Governance & Decisions
-
-This project is governed by the **28 Cohesive Domain Rules** located in `docs/rules/` and Architectural Decision Records in `memory.md`:
-- **ADR Ledger:** See `memory.md` for project-specific Architectural Decision Records.
-- **Architectural Rules:** See `docs/rules/` for TDD, Clean Code, Multi-Tenancy, Database Design, and DevSecOps directives.
+# {{PROJECT_NAME}}
+
+> **{{PROJECT_TAGLINE_OR_MISSION}}**
+
+---
+
+## 🌟 Architecture & Stack
+
+- **Architecture:** Hexagonal (Ports & Adapters) with strict systemic atomicity and zero-downtime database patterns.
+- **Language & Runtime:** {{LANGUAGE_AND_RUNTIME}}
+- **Package Manager & Build:** {{PACKAGE_MANAGER_AND_BUILD_TOOL}}
+- **Primary Transport:** {{TRANSPORT_PROTOCOL_AND_FRAMEWORK}}
+- **Persistence Engine:** {{DATABASE_ENGINE}} (Migrations via {{MIGRATION_TOOL}})
+- **Multi-Tenancy Isolation:** {{TENANCY_ISOLATION_MODEL}}
+- **Dynamic Extensibility:** Common Expression Language (CEL) / JSON Schema Draft 2020-12
+- **Observability:** OpenTelemetry (OTel) OTLP export over gRPC/HTTP
+- **Security & DevSecOps:** Semgrep SAST, Gitleaks, Trivy scanning, CycloneDX SBOM
+
+---
+
+## 🗂️ Project Structure
+
+```
+.
+├── specs/                            # Canonical contract specifications
+│   ├── openapi/                      # OpenAPI 3.1 REST specifications
+│   ├── protobuf/                     # Protocol Buffers v3 definitions
+│   ├── schemas/                      # Universal JSON Schema Draft 2020-12
+│   └── tokens/                       # W3C DTCG Design Tokens
+├── src/                              # Hexagonal Application Source
+│   ├── domain/                       # Core Invariant Domain (Entities, Value Objects)
+│   ├── ports/                        # Primary (Use Cases) and Secondary (Repositories) Ports
+│   └── adapters/                     # Ingress (HTTP/gRPC) and Egress (SQL/Broker) Adapters
+├── tests/
+│   ├── unit/                         # Fast unit tests using test doubles
+│   ├── integration/                  # Adapter tests with transactional rollback
+│   ├── contracts/                    # Consumer contract tests (Pact)
+│   └── acceptance/                   # BDD Gherkin / Cucumber features
+├── deploy/                           # OCI Distroless Dockerfiles & Compose manifests
+├── docs/rules/                       # 28 cohesive single-responsibility architectural rules
+├── memory.md                         # Master memory hub & Lightweight ADR ledger
+└── AGENTS.md                         # Lean agentic directives (< 120 lines)
+```
+
+---
+
+## ⚡ Quickstart & Development
+
+### 1. Prerequisites
+- {{PREREQUISITES_LIST}}
+- Docker & Docker Compose
+
+### 2. Environment Setup
+```bash
+cp .env.example .env
+```
+
+### 3. Install Dependencies
+```bash
+{{INSTALL_COMMAND}}
+```
+
+### 4. Run Development Environment
+```bash
+{{DEV_RUN_COMMAND}}
+```
+
+### 5. Run Tests & Verification
+```bash
+{{TEST_COMMAND}}
+```
+
+---
+
+## 🏛️ Architecture Governance & Decisions
+
+This project is governed by the **28 Cohesive Domain Rules** located in `docs/rules/` and Architectural Decision Records in `memory.md`:
+- **ADR Ledger:** See `memory.md` for project-specific Architectural Decision Records.
+- **Architectural Rules:** See `docs/rules/` for TDD, Clean Code, Multi-Tenancy, Database Design, and DevSecOps directives.

package/.agents/skills/lets-build/scripts/bootstrap_workspace.sh

@@ -1,136 +1,255 @@
-#!/usr/bin/env bash
-# ==============================================================================
-# bootstrap_workspace.sh
-# Topology-Aware Deterministic Scaffolder (Strict YAGNI, Zero Speculative Bloat)
-# ==============================================================================
-
-set -euo pipefail
-
-WORKSPACE_ROOT="${1:-$(pwd)}"
-TOPOLOGY="${2:-backend}"
-LANGUAGE="${3:-generic}"
-
-echo "🚀 Initializing Topology-Aware Workspace in: ${WORKSPACE_ROOT}"
-echo "🏗️ Target Topology: ${TOPOLOGY}"
-echo "📦 Target Language Profile: ${LANGUAGE}"
-echo "--------------------------------------------------------------"
-
-# Helper to create leaf directory with .gitkeep to ensure Git tracks empty structures
-create_leaf() {
-  local dir="$1"
-  mkdir -p "${dir}"
-  if [[ -z "$(ls -A "${dir}" 2>/dev/null)" ]]; then
-    touch "${dir}/.gitkeep"
-  fi
-}
-
-case "${TOPOLOGY}" in
-  extension)
-    echo "1. Scaffolding Browser Extension Source Tree (src/)..."
-    create_leaf "${WORKSPACE_ROOT}/src/background"
-    create_leaf "${WORKSPACE_ROOT}/src/content"
-    create_leaf "${WORKSPACE_ROOT}/src/popup"
-    create_leaf "${WORKSPACE_ROOT}/src/shared"
-    create_leaf "${WORKSPACE_ROOT}/public"
-    
-    echo "2. Scaffolding Extension Test Suites (tests/)..."
-    create_leaf "${WORKSPACE_ROOT}/tests/unit"
-    create_leaf "${WORKSPACE_ROOT}/tests/e2e"
-    ;;
-
-  game|engine)
-    echo "1. Scaffolding Game/Engine Source Tree (src/)..."
-    create_leaf "${WORKSPACE_ROOT}/src/core"
-    create_leaf "${WORKSPACE_ROOT}/src/ecs"
-    create_leaf "${WORKSPACE_ROOT}/src/renderer"
-    create_leaf "${WORKSPACE_ROOT}/src/assets"
-    
-    echo "2. Scaffolding Game/Engine Test Suites (tests/)..."
-    create_leaf "${WORKSPACE_ROOT}/tests/unit"
-    create_leaf "${WORKSPACE_ROOT}/tests/benchmarks"
-    ;;
-
-  cli)
-    echo "1. Scaffolding CLI Source Tree (src/)..."
-    create_leaf "${WORKSPACE_ROOT}/src/cmd"
-    create_leaf "${WORKSPACE_ROOT}/src/core"
-    create_leaf "${WORKSPACE_ROOT}/src/io"
-    
-    echo "2. Scaffolding CLI Test Suites (tests/)..."
-    create_leaf "${WORKSPACE_ROOT}/tests/unit"
-    create_leaf "${WORKSPACE_ROOT}/tests/integration"
-    ;;
-
-  backend|web|saas)
-    echo "1. Scaffolding Backend / Enterprise Source Tree (src/)..."
-    create_leaf "${WORKSPACE_ROOT}/src/domain/entities"
-    create_leaf "${WORKSPACE_ROOT}/src/domain/value_objects"
-    create_leaf "${WORKSPACE_ROOT}/src/domain/services"
-    create_leaf "${WORKSPACE_ROOT}/src/ports/primary"
-    create_leaf "${WORKSPACE_ROOT}/src/ports/secondary"
-    create_leaf "${WORKSPACE_ROOT}/src/adapters/primary"
-    create_leaf "${WORKSPACE_ROOT}/src/adapters/secondary"
-    
-    echo "2. Scaffolding Specifications (specs/)..."
-    create_leaf "${WORKSPACE_ROOT}/specs/openapi"
-    create_leaf "${WORKSPACE_ROOT}/specs/tokens"
-    
-    echo "3. Scaffolding Backend Test Suites (tests/)..."
-    create_leaf "${WORKSPACE_ROOT}/tests/unit"
-    create_leaf "${WORKSPACE_ROOT}/tests/integration"
-    create_leaf "${WORKSPACE_ROOT}/tests/contracts"
-    create_leaf "${WORKSPACE_ROOT}/tests/acceptance"
-    
-    echo "4. Scaffolding Deployment Infrastructure (deploy/)..."
-    create_leaf "${WORKSPACE_ROOT}/deploy/docker"
-    create_leaf "${WORKSPACE_ROOT}/deploy/compose"
-
-    TOKEN_SPEC="${WORKSPACE_ROOT}/specs/tokens/tokens.json"
-    if [[ ! -f "${TOKEN_SPEC}" ]]; then
-      cat << 'EOF' > "${TOKEN_SPEC}"
-{
-  "color": {
-    "brand": {
-      "primary": { "$value": "#2563eb", "$type": "color" },
-      "secondary": { "$value": "#475569", "$type": "color" },
-      "accent": { "$value": "#f59e0b", "$type": "color" }
-    }
-  },
-  "dimension": {
-    "radius": {
-      "base": { "$value": "6px", "$type": "dimension" }
-    }
-  }
-}
-EOF
-    fi
-    ;;
-
-  *)
-    echo "1. Scaffolding Generic / Library Source Tree (src/)..."
-    create_leaf "${WORKSPACE_ROOT}/src"
-    create_leaf "${WORKSPACE_ROOT}/tests/unit"
-    ;;
-esac
-
-# Deterministically generate boundary verification smoke test script (Phase 5 requirement)
-SMOKE_TEST="${WORKSPACE_ROOT}/scripts/smoke_test.sh"
-if [[ ! -f "${SMOKE_TEST}" ]]; then
-  echo "5. Generating boundary smoke test verification script (scripts/smoke_test.sh)..."
-  mkdir -p "${WORKSPACE_ROOT}/scripts"
-  cat << 'EOF' > "${SMOKE_TEST}"
-#!/usr/bin/env bash
-# ==============================================================================
-# Boundary Verification Smoke Test (Phase 5 Verification Gate)
-# ==============================================================================
-set -euo pipefail
-
-echo "Running boundary smoke verification..."
-# Extend with project-specific runtime health checks (e.g. ping health endpoint, CLI --help)
-echo "✅ Boundary smoke verification passed!"
-EOF
-  chmod +x "${SMOKE_TEST}"
-fi
-
-echo "--------------------------------------------------------------"
-echo "✅ Topology '${TOPOLOGY}' scaffolded with strict YAGNI (0 speculative folders)!"
+#!/usr/bin/env bash
+# ==============================================================================
+# bootstrap_workspace.sh
+# Topology-Aware Deterministic Scaffolder (Strict YAGNI, Zero Speculative Bloat)
+# ==============================================================================
+
+set -euo pipefail
+
+WORKSPACE_ROOT="${1:-$(pwd)}"
+TOPOLOGY="${2:-backend}"
+LANGUAGE="${3:-generic}"
+
+echo "🚀 Initializing Topology-Aware Workspace in: ${WORKSPACE_ROOT}"
+echo "🏗️ Target Topology: ${TOPOLOGY}"
+echo "📦 Target Language Profile: ${LANGUAGE}"
+echo "--------------------------------------------------------------"
+
+# Helper to create leaf directory with .gitkeep to ensure Git tracks empty structures
+create_leaf() {
+  local dir="$1"
+  mkdir -p "${dir}"
+  if [[ -z "$(ls -A "${dir}" 2>/dev/null)" ]]; then
+    touch "${dir}/.gitkeep"
+  fi
+}
+
+case "${TOPOLOGY}" in
+  extension)
+    echo "1. Scaffolding Browser Extension Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src/background"
+    create_leaf "${WORKSPACE_ROOT}/src/content"
+    create_leaf "${WORKSPACE_ROOT}/src/popup"
+    create_leaf "${WORKSPACE_ROOT}/src/shared"
+    create_leaf "${WORKSPACE_ROOT}/public"
+    
+    echo "2. Scaffolding Extension Test Suites (tests/)..."
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    create_leaf "${WORKSPACE_ROOT}/tests/e2e"
+    ;;
+
+  game|engine)
+    echo "1. Scaffolding Game/Engine Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src/core"
+    create_leaf "${WORKSPACE_ROOT}/src/ecs"
+    create_leaf "${WORKSPACE_ROOT}/src/renderer"
+    create_leaf "${WORKSPACE_ROOT}/src/assets"
+    
+    echo "2. Scaffolding Game/Engine Test Suites (tests/)..."
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    create_leaf "${WORKSPACE_ROOT}/tests/benchmarks"
+    ;;
+
+  cli)
+    echo "1. Scaffolding CLI Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src/cmd"
+    create_leaf "${WORKSPACE_ROOT}/src/core"
+    create_leaf "${WORKSPACE_ROOT}/src/io"
+    
+    echo "2. Scaffolding CLI Test Suites (tests/)..."
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    create_leaf "${WORKSPACE_ROOT}/tests/integration"
+    ;;
+
+  web|saas|fullstack)
+    echo "1. Scaffolding Backend / Enterprise Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src/domain/entities"
+    create_leaf "${WORKSPACE_ROOT}/src/domain/value_objects"
+    create_leaf "${WORKSPACE_ROOT}/src/domain/services"
+    create_leaf "${WORKSPACE_ROOT}/src/ports/primary"
+    create_leaf "${WORKSPACE_ROOT}/src/ports/secondary"
+    create_leaf "${WORKSPACE_ROOT}/src/adapters/primary"
+    create_leaf "${WORKSPACE_ROOT}/src/adapters/secondary"
+
+    echo "2. Scaffolding Web Frontend Client Source Tree (client/)..."
+    create_leaf "${WORKSPACE_ROOT}/client/src/components/layout"
+    create_leaf "${WORKSPACE_ROOT}/client/src/components/ui"
+    create_leaf "${WORKSPACE_ROOT}/client/src/pages"
+    create_leaf "${WORKSPACE_ROOT}/client/src/hooks"
+    create_leaf "${WORKSPACE_ROOT}/client/src/services"
+    create_leaf "${WORKSPACE_ROOT}/client/public"
+    
+    echo "3. Scaffolding Specifications (specs/)..."
+    create_leaf "${WORKSPACE_ROOT}/specs/openapi"
+    create_leaf "${WORKSPACE_ROOT}/specs/tokens"
+    
+    echo "4. Scaffolding Fullstack Test Suites (tests/)..."
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    create_leaf "${WORKSPACE_ROOT}/tests/integration"
+    create_leaf "${WORKSPACE_ROOT}/tests/contracts"
+    create_leaf "${WORKSPACE_ROOT}/tests/client"
+    create_leaf "${WORKSPACE_ROOT}/tests/acceptance"
+    
+    echo "5. Scaffolding Deployment Infrastructure (deploy/)..."
+    create_leaf "${WORKSPACE_ROOT}/deploy/docker"
+    create_leaf "${WORKSPACE_ROOT}/deploy/compose"
+
+    TOKEN_SPEC="${WORKSPACE_ROOT}/specs/tokens/tokens.json"
+    if [[ ! -f "${TOKEN_SPEC}" ]]; then
+      cat << 'EOF' > "${TOKEN_SPEC}"
+{
+  "color": {
+    "brand": {
+      "primary": { "$value": "#2563eb", "$type": "color" },
+      "secondary": { "$value": "#475569", "$type": "color" },
+      "accent": { "$value": "#f59e0b", "$type": "color" }
+    }
+  },
+  "dimension": {
+    "radius": {
+      "base": { "$value": "6px", "$type": "dimension" }
+    }
+  }
+}
+EOF
+    fi
+    ;;
+
+  backend)
+    echo "1. Scaffolding Headless Backend Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src/domain/entities"
+    create_leaf "${WORKSPACE_ROOT}/src/domain/value_objects"
+    create_leaf "${WORKSPACE_ROOT}/src/domain/services"
+    create_leaf "${WORKSPACE_ROOT}/src/ports/primary"
+    create_leaf "${WORKSPACE_ROOT}/src/ports/secondary"
+    create_leaf "${WORKSPACE_ROOT}/src/adapters/primary"
+    create_leaf "${WORKSPACE_ROOT}/src/adapters/secondary"
+    
+    echo "2. Scaffolding Specifications (specs/)..."
+    create_leaf "${WORKSPACE_ROOT}/specs/openapi"
+    create_leaf "${WORKSPACE_ROOT}/specs/tokens"
+    
+    echo "3. Scaffolding Backend Test Suites (tests/)..."
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    create_leaf "${WORKSPACE_ROOT}/tests/integration"
+    create_leaf "${WORKSPACE_ROOT}/tests/contracts"
+    create_leaf "${WORKSPACE_ROOT}/tests/acceptance"
+    
+    echo "4. Scaffolding Deployment Infrastructure (deploy/)..."
+    create_leaf "${WORKSPACE_ROOT}/deploy/docker"
+    create_leaf "${WORKSPACE_ROOT}/deploy/compose"
+
+    TOKEN_SPEC="${WORKSPACE_ROOT}/specs/tokens/tokens.json"
+    if [[ ! -f "${TOKEN_SPEC}" ]]; then
+      cat << 'EOF' > "${TOKEN_SPEC}"
+{
+  "color": {
+    "brand": {
+      "primary": { "$value": "#2563eb", "$type": "color" },
+      "secondary": { "$value": "#475569", "$type": "color" },
+      "accent": { "$value": "#f59e0b", "$type": "color" }
+    }
+  },
+  "dimension": {
+    "radius": {
+      "base": { "$value": "6px", "$type": "dimension" }
+    }
+  }
+}
+EOF
+    fi
+    ;;
+
+  frontend)
+    echo "1. Scaffolding Frontend Client Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src/components/layout"
+    create_leaf "${WORKSPACE_ROOT}/src/components/ui"
+    create_leaf "${WORKSPACE_ROOT}/src/pages"
+    create_leaf "${WORKSPACE_ROOT}/src/hooks"
+    create_leaf "${WORKSPACE_ROOT}/src/services"
+    create_leaf "${WORKSPACE_ROOT}/public"
+    
+    echo "2. Scaffolding Specifications (specs/)..."
+    create_leaf "${WORKSPACE_ROOT}/specs/tokens"
+    
+    echo "3. Scaffolding Frontend Test Suites (tests/)..."
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    create_leaf "${WORKSPACE_ROOT}/tests/acceptance"
+    ;;
+
+  *)
+    echo "1. Scaffolding Generic / Library Source Tree (src/)..."
+    create_leaf "${WORKSPACE_ROOT}/src"
+    create_leaf "${WORKSPACE_ROOT}/tests/unit"
+    ;;
+esac
+
+# Ensure memory.md in fresh projects starts with a clean ADR slate (ADR-001)
+MEMORY_FILE="${WORKSPACE_ROOT}/memory.md"
+if [[ -f "${MEMORY_FILE}" ]]; then
+  if grep -qE "ADR-00[1-9]|ADR-0[1-9][0-9]|#### ADR-" "${MEMORY_FILE}"; then
+    if ! grep -q "No decisions recorded yet" "${MEMORY_FILE}"; then
+      echo "🧹 Sanitizing memory.md: Resetting legacy template ADRs to clean slate (ADR-001)..."
+    cat << 'EOF' > "${MEMORY_FILE}"
+# Workspace Memory, Architecture Decisions & Knowledge Hub
+
+> **Core Purpose:** Authoritative persistent memory ledger for the workspace repository (`./`), maintaining Lightweight Architectural Decision Records (ADRs), system topologies, and living domain contracts.
+
+---
+
+## 1. Quick Navigation & Knowledge Repositories
+
+- 📖 **[Living Ubiquitous Language Glossary](./docs/knowledge/ubiquitous_language.md)**: Authoritative, single-name domain vocabulary contract.
+- 📜 **[Lightweight ADR Master Index](#adr-master-index)**: Summary of all architectural decisions and direct links to governing rules.
+
+---
+
+## 2. Consolidated Architectural Decision Records (ADRs)
+
+### ADR Master Index
+
+| ID | Title | Date | Status | Governing Rule / Skill |
+|---|---|---|---|---|
+| *(No decisions recorded yet)* | *Record initial architecture decisions during Phase 3 of /lets-build.* | *YYYY-MM-DD* | *ACCEPTED* | *e.g. [`clean_code.md`](./docs/rules/clean_code.md)* |
+
+---
+
+### Lightweight Decision Summaries
+
+<!--
+Record project Architectural Decision Records (ADRs) below as decisions are finalized.
+Format:
+
+#### ADR-001: [Imperative Title]
+- **Date:** YYYY-MM-DD | **Status:** ACCEPTED
+- **Context:** Problem space, constraints, and operational context requiring a decision.
+- **Decision:** Chosen architecture, invariants, and implementation patterns.
+- **Consequences:** Positive benefits and deliberate trade-offs accepted.
+- **Enforced In:** Relevant rule files in docs/rules/ or code paths.
+-->
+EOF
+    fi
+  fi
+fi
+
+# Deterministically generate boundary verification smoke test script (Phase 5 requirement)
+SMOKE_TEST="${WORKSPACE_ROOT}/scripts/smoke_test.sh"
+if [[ ! -f "${SMOKE_TEST}" ]]; then
+  echo "5. Generating boundary smoke test verification script (scripts/smoke_test.sh)..."
+  mkdir -p "${WORKSPACE_ROOT}/scripts"
+  cat << 'EOF' > "${SMOKE_TEST}"
+#!/usr/bin/env bash
+# ==============================================================================
+# Boundary Verification Smoke Test (Phase 5 Verification Gate)
+# ==============================================================================
+set -euo pipefail
+
+echo "Running boundary smoke verification..."
+# Extend with project-specific runtime health checks (e.g. ping health endpoint, CLI --help)
+echo "✅ Boundary smoke verification passed!"
+EOF
+  chmod +x "${SMOKE_TEST}"
+fi
+
+echo "--------------------------------------------------------------"
+echo "✅ Topology '${TOPOLOGY}' scaffolded with strict YAGNI (0 speculative folders)!"