@sun-asterisk/sungen 2.4.5 → 2.5.0

package/dist/orchestrator/templates/specs-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"specs-base.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"specs-base.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-base.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/templates/specs-base.ts

@@ -1,12 +1,27 @@
 import { test as base, expect } from '@playwright/test';
 import type { BrowserContext, Page } from '@playwright/test';
 
+type CleanupConfig = {
+  overlay?: boolean;
+  forms?: boolean;
+  scroll?: boolean;
+  storage?: boolean;
+};
+
 // Share one context per storageState — avoids creating multiple sessions
 // that trigger server rate limiting or session invalidation
 const contextCache = new Map<string, { context: BrowserContext; page: Page }>();
 const GOTO_PATCHED = Symbol('goto-patched');
 
-const test = base.extend({
+const test = base.extend<{
+  autoCleanup: CleanupConfig;
+  screenshotOnFailure: boolean;
+  _autoCleanup: void;
+  _autoScreenshot: void;
+}>({
+  autoCleanup: [{}, { option: true }],
+  screenshotOnFailure: [false, { option: true }],
+
   page: async ({ browser, storageState }, use) => {
     if (storageState) {
       const cacheKey = typeof storageState === 'string' ? storageState : JSON.stringify(storageState);
@@ -28,12 +43,6 @@ const test = base.extend({
           try {
             const currentPath = new URL(page.url()).pathname;
             if (currentPath === url || currentPath === url + '/') {
-              // Dismiss any open overlays (dropdowns, dialogs) from previous test
-              await page.keyboard.press('Escape').catch(() => {});
-              await page.locator('body').click({ position: { x: 1, y: 1 }, force: true }).catch(() => {});
-
-              // Safety check: if a fixed-position overlay (modal/dialog) is still present, full reload
-              // eslint-disable-next-line no-eval -- runs in browser context via Playwright
               const hasOverlay = await page.evaluate(`(() => {
                 const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
                 if (!el) return false;
@@ -68,6 +77,55 @@ const test = base.extend({
       await context.close();
     }
   },
+
+  // Auto-cleanup fixture: runs teardown after each test based on @cleanup:* tags
+  _autoCleanup: [async ({ page, autoCleanup }, use) => {
+    await use();
+
+    if (autoCleanup.overlay) {
+      await page.keyboard.press('Escape').catch(() => {});
+      await page.locator('body').click({ position: { x: 1, y: 1 }, force: true }).catch(() => {});
+      // Dismiss persistent fixed overlays (modals, dialogs)
+      const hasOverlay = await page.evaluate(`(() => {
+        const el = document.elementFromPoint(window.innerWidth / 2, window.innerHeight / 2);
+        if (!el) return false;
+        let current = el;
+        while (current && current !== document.body) {
+          if (getComputedStyle(current).position === 'fixed') return true;
+          current = current.parentElement;
+        }
+        return false;
+      })()`).catch(() => false);
+      if (hasOverlay) {
+        await page.keyboard.press('Escape').catch(() => {});
+      }
+    }
+    if (autoCleanup.forms) {
+      await page.evaluate(`(() => {
+        document.querySelectorAll('input:not([type=hidden]):not([type=submit])').forEach(el => { el.value = ''; });
+        document.querySelectorAll('textarea').forEach(el => { el.value = ''; });
+        document.querySelectorAll('select').forEach(el => { el.selectedIndex = 0; });
+      })()`).catch(() => {});
+    }
+    if (autoCleanup.scroll) {
+      await page.evaluate('window.scrollTo(0, 0)').catch(() => {});
+    }
+    if (autoCleanup.storage) {
+      await page.evaluate('sessionStorage.clear()').catch(() => {});
+    }
+  }, { auto: true }],
+
+  // Auto-screenshot fixture: captures screenshot on test failure
+  _autoScreenshot: [async ({ page, screenshotOnFailure }, use, testInfo) => {
+    await use();
+
+    if (screenshotOnFailure && testInfo.status !== testInfo.expectedStatus) {
+      await testInfo.attach('screenshot', {
+        body: await page.screenshot(),
+        contentType: 'image/png',
+      });
+    }
+  }, { auto: true }],
 });
 
 export { test, expect };

package/dist/orchestrator/templates/specs-test-data.d.ts

@@ -0,0 +1,14 @@
+export declare class TestDataLoader {
+    private data;
+    private constructor();
+    /**
+     * Load test data for a screen/feature combination.
+     *
+     * Priority (later wins):
+     * 1. {feature}.yaml — base data
+     * 2. {feature}.{SUNGEN_ENV}.yaml — environment-specific (if SUNGEN_ENV set)
+     */
+    static load(screenName: string, featureName: string): TestDataLoader;
+    get(key: string): string;
+}
+//# sourceMappingURL=specs-test-data.d.ts.map

package/dist/orchestrator/templates/specs-test-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs-test-data.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-test-data.ts"],"names":[],"mappings":"AAIA,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAsB;IAElC,OAAO;IAIP;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc;IAcpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAczB"}

package/dist/orchestrator/templates/specs-test-data.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestDataLoader = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+class TestDataLoader {
+    constructor(data) {
+        this.data = data;
+    }
+    /**
+     * Load test data for a screen/feature combination.
+     *
+     * Priority (later wins):
+     * 1. {feature}.yaml — base data
+     * 2. {feature}.{SUNGEN_ENV}.yaml — environment-specific (if SUNGEN_ENV set)
+     */
+    static load(screenName, featureName) {
+        const baseDir = path.join(process.cwd(), 'qa', 'screens', screenName, 'test-data');
+        const env = process.env.SUNGEN_ENV;
+        let data = loadYamlSync(path.join(baseDir, `${featureName}.yaml`)) || {};
+        if (env) {
+            const envData = loadYamlSync(path.join(baseDir, `${featureName}.${env}.yaml`));
+            if (envData)
+                data = deepMerge(data, envData);
+        }
+        return new TestDataLoader(data);
+    }
+    get(key) {
+        const parts = key.split('.');
+        let current = this.data;
+        for (const part of parts) {
+            if (current == null || typeof current !== 'object') {
+                throw new Error(`Test data key not found: ${key} (failed at '${part}')`);
+            }
+            current = current[part];
+        }
+        if (current === undefined || current === null) {
+            throw new Error(`Test data key not found: ${key}`);
+        }
+        return String(current);
+    }
+}
+exports.TestDataLoader = TestDataLoader;
+function loadYamlSync(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return yaml_1.default.parse(content) || null;
+}
+function deepMerge(base, override) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (value && typeof value === 'object' && !Array.isArray(value) &&
+            result[key] && typeof result[key] === 'object' && !Array.isArray(result[key])) {
+            result[key] = deepMerge(result[key], value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=specs-test-data.js.map

package/dist/orchestrator/templates/specs-test-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs-test-data.js","sourceRoot":"","sources":["../../../src/orchestrator/templates/specs-test-data.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/templates/specs-test-data.ts

@@ -0,0 +1,66 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import yaml from 'yaml';
+
+export class TestDataLoader {
+  private data: Record<string, any>;
+
+  private constructor(data: Record<string, any>) {
+    this.data = data;
+  }
+
+  /**
+   * Load test data for a screen/feature combination.
+   *
+   * Priority (later wins):
+   * 1. {feature}.yaml — base data
+   * 2. {feature}.{SUNGEN_ENV}.yaml — environment-specific (if SUNGEN_ENV set)
+   */
+  static load(screenName: string, featureName: string): TestDataLoader {
+    const baseDir = path.join(process.cwd(), 'qa', 'screens', screenName, 'test-data');
+    const env = process.env.SUNGEN_ENV;
+
+    let data = loadYamlSync(path.join(baseDir, `${featureName}.yaml`)) || {};
+
+    if (env) {
+      const envData = loadYamlSync(path.join(baseDir, `${featureName}.${env}.yaml`));
+      if (envData) data = deepMerge(data, envData);
+    }
+
+    return new TestDataLoader(data);
+  }
+
+  get(key: string): string {
+    const parts = key.split('.');
+    let current: any = this.data;
+    for (const part of parts) {
+      if (current == null || typeof current !== 'object') {
+        throw new Error(`Test data key not found: ${key} (failed at '${part}')`);
+      }
+      current = current[part];
+    }
+    if (current === undefined || current === null) {
+      throw new Error(`Test data key not found: ${key}`);
+    }
+    return String(current);
+  }
+}
+
+function loadYamlSync(filePath: string): Record<string, any> | null {
+  if (!fs.existsSync(filePath)) return null;
+  const content = fs.readFileSync(filePath, 'utf-8');
+  return yaml.parse(content) || null;
+}
+
+function deepMerge(base: Record<string, any>, override: Record<string, any>): Record<string, any> {
+  const result = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (value && typeof value === 'object' && !Array.isArray(value) &&
+        result[key] && typeof result[key] === 'object' && !Array.isArray(result[key])) {
+      result[key] = deepMerge(result[key], value);
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sun-asterisk/sungen",
-  "version": "2.4.5",
+  "version": "2.5.0",
   "description": "Deterministic E2E Test Compiler - Gherkin + Selectors → Playwright tests",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -40,6 +40,7 @@
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
     "dotenv": "^17.2.3",
+    "exceljs": "^4.4.0",
     "fast-glob": "^3.3.3",
     "glob": "^13.0.0",
     "handlebars": "^4.7.8",

package/src/cli/commands/delivery.ts

@@ -0,0 +1,348 @@
+/**
+ * `sungen delivery` CLI command.
+ * Exports Gherkin scenarios + Playwright results → CSV test case file.
+ */
+
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { execSync } from 'child_process';
+import { parseFeatureMetadata } from '../../exporters/feature-parser';
+import { parseSpecFile } from '../../exporters/spec-parser';
+import { loadTestData, resolveTestDataPath } from '../../exporters/test-data-resolver';
+import { loadPlaywrightReport } from '../../exporters/playwright-report-parser';
+import { mergeFeatureAndSpec } from '../../exporters/scenario-merger';
+import {
+  buildTestCaseRows,
+  buildSummary,
+  renderCsv,
+  writeCsv,
+} from '../../exporters/csv-exporter';
+import { renderXlsx, writeXlsx } from '../../exporters/xlsx-exporter';
+import { EnvironmentInfo, PreflightCheck, ScreenSummary } from '../../exporters/types';
+
+const COLOR = {
+  reset: '\x1b[0m',
+  gray: '\x1b[90m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  bold: '\x1b[1m',
+};
+
+function log(msg: string): void {
+  console.log(msg);
+}
+
+// ----------------------------------------------------------------------------
+// Discovery
+// ----------------------------------------------------------------------------
+
+function listAllScreens(cwd: string): string[] {
+  const screensDir = path.join(cwd, 'qa', 'screens');
+  if (!fs.existsSync(screensDir)) return [];
+  return fs
+    .readdirSync(screensDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory())
+    .map((d) => d.name)
+    .sort();
+}
+
+// ----------------------------------------------------------------------------
+// Pre-flight checks
+// ----------------------------------------------------------------------------
+
+/**
+ * Resolve the results file path for a screen.
+ * Prefer the per-screen co-located file, fall back to the global `test-results/results.json`.
+ */
+function resolveResultsPath(cwd: string, screen: string): string | null {
+  const perScreen = path.join(cwd, 'specs', 'generated', screen, `${screen}-test-result.json`);
+  if (fs.existsSync(perScreen)) return perScreen;
+  const global = path.join(cwd, 'test-results', 'results.json');
+  if (fs.existsSync(global)) return global;
+  return null;
+}
+
+function runPreflight(cwd: string, screen: string): PreflightCheck {
+  const featureFile = path.join(cwd, 'qa', 'screens', screen, 'features', `${screen}.feature`);
+  const testDataFile = resolveTestDataPath(cwd, screen);
+  const selectorsFile = path.join(cwd, 'qa', 'screens', screen, 'selectors', `${screen}.yaml`);
+  const specFile = path.join(cwd, 'specs', 'generated', screen, `${screen}.spec.ts`);
+  const resultsFile = resolveResultsPath(cwd, screen);
+
+  const featureOk = checkFeatureReal(featureFile);
+  const testDataOk = checkTestDataHasVars(testDataFile);
+  const selectorsOk = checkSelectorsHasEntries(selectorsFile, screen);
+  const specOk = fs.existsSync(specFile);
+  const resultsOk = resultsFile !== null;
+
+  const missing: string[] = [];
+  const suggestions: string[] = [];
+
+  if (!featureOk) {
+    missing.push(`feature file missing/empty: ${path.relative(cwd, featureFile)}`);
+    suggestions.push(`/sungen:create-test ${screen}`);
+  }
+  if (!testDataOk) {
+    missing.push(`test-data.yaml has no variables: ${path.relative(cwd, testDataFile)}`);
+    suggestions.push(`/sungen:create-test ${screen}`);
+  }
+  if (!selectorsOk) {
+    missing.push(`selectors.yaml missing entries: ${path.relative(cwd, selectorsFile)}`);
+    suggestions.push(`/sungen:run-test ${screen}`);
+  }
+  if (!specOk) {
+    missing.push(`compiled .spec.ts missing: ${path.relative(cwd, specFile)}`);
+    suggestions.push(`sungen generate --screen ${screen}`);
+  }
+  if (!resultsOk) {
+    missing.push(`test-result.json missing (optional)`);
+    suggestions.push(`PLAYWRIGHT_JSON_OUTPUT_NAME=specs/generated/${screen}/${screen}-test-result.json npx playwright test specs/generated/${screen}/${screen}.spec.ts`);
+  }
+
+  return {
+    screen,
+    featureOk,
+    testDataOk,
+    selectorsOk,
+    specOk,
+    resultsOk,
+    missing,
+    suggestions: Array.from(new Set(suggestions)),
+  };
+}
+
+function checkFeatureReal(featureFile: string): boolean {
+  if (!fs.existsSync(featureFile)) return false;
+  const content = fs.readFileSync(featureFile, 'utf-8');
+  if (!/Feature:/i.test(content)) return false;
+  // Treat as empty if only the sample scaffold scenario is present
+  const sample = /Scenario:\s*Sample scenario for /.test(content);
+  const realScenarios = (content.match(/\n\s*Scenario:/g) || []).length;
+  // If sample present and only 1 scenario → it's the scaffold only
+  if (sample && realScenarios <= 1) return false;
+  return realScenarios >= 1;
+}
+
+function checkTestDataHasVars(testDataFile: string): boolean {
+  if (!fs.existsSync(testDataFile)) return false;
+  const content = fs.readFileSync(testDataFile, 'utf-8');
+  // Any non-comment line with `key: value`
+  const lines = content.split('\n').filter((l) => !l.trim().startsWith('#') && l.includes(':'));
+  return lines.length > 0;
+}
+
+function checkSelectorsHasEntries(selectorsFile: string, screen: string): boolean {
+  if (!fs.existsSync(selectorsFile)) return false;
+  const content = fs.readFileSync(selectorsFile, 'utf-8');
+  // Very small check: YAML has more than just a single `<screen>: page` entry
+  const topLevelKeys = (content.match(/^[a-zA-Z_][^\s:]*:\s*$/gm) || []).length +
+    (content.match(/^[a-zA-Z_][^\s:]*:\s/gm) || []).length;
+  return topLevelKeys > 1;
+}
+
+function hasBlockingMissing(p: PreflightCheck): boolean {
+  return !p.featureOk || !p.testDataOk || !p.selectorsOk || !p.specOk;
+}
+
+// ----------------------------------------------------------------------------
+// Environment
+// ----------------------------------------------------------------------------
+
+function getEnvironment(cwd: string): EnvironmentInfo {
+  let baseURL = '';
+  let projectName = 'chromium';
+  const configPath = path.join(cwd, 'playwright.config.ts');
+  if (fs.existsSync(configPath)) {
+    const c = fs.readFileSync(configPath, 'utf-8');
+    const baseMatch = c.match(/baseURL:\s*['"]([^'"]+)['"]/);
+    if (baseMatch) baseURL = baseMatch[1];
+    const projMatch = c.match(/name:\s*['"]([^'"]+)['"]/);
+    if (projMatch) projectName = projMatch[1];
+  }
+
+  let executor = process.env.CI_USER || process.env.USER || '';
+  try {
+    const gitUser = execSync('git config user.name', { cwd, encoding: 'utf-8' }).trim();
+    if (gitUser) executor = gitUser;
+  } catch {
+    // ignore
+  }
+
+  return { baseURL, projectName, executor };
+}
+
+// ----------------------------------------------------------------------------
+// Per-screen export
+// ----------------------------------------------------------------------------
+
+async function exportScreen(
+  cwd: string,
+  screen: string,
+  env: EnvironmentInfo
+): Promise<ScreenSummary | null> {
+  const featureFile = path.join(cwd, 'qa', 'screens', screen, 'features', `${screen}.feature`);
+  const testDataFile = resolveTestDataPath(cwd, screen);
+  const specFile = path.join(cwd, 'specs', 'generated', screen, `${screen}.spec.ts`);
+  const resultsFile = resolveResultsPath(cwd, screen);
+  const specMdFile = path.join(cwd, 'qa', 'screens', screen, 'requirements', 'spec.md');
+
+  try {
+    const feature = parseFeatureMetadata(featureFile);
+    const spec = parseSpecFile(specFile);
+    const testData = loadTestData(testDataFile);
+    const results = resultsFile ? loadPlaywrightReport(resultsFile) : null;
+
+    const merged = mergeFeatureAndSpec(feature, spec);
+    const rows = buildTestCaseRows({
+      screen,
+      featureName: feature.featureName,
+      merged,
+      testData,
+      results,
+      env,
+    });
+
+    const specLink = fs.existsSync(specMdFile) ? path.relative(cwd, specMdFile) : '';
+    const tempSummary = buildSummary(screen, rows, '');
+    const csv = renderCsv(tempSummary, rows, specLink);
+    const csvPath = writeCsv(cwd, screen, csv);
+    const wb = renderXlsx(tempSummary, rows, specLink);
+    await writeXlsx(cwd, screen, wb);
+    return buildSummary(screen, rows, path.relative(cwd, csvPath));
+  } catch (err) {
+    console.error(`${COLOR.red}Error exporting ${screen}:${COLOR.reset} ${err instanceof Error ? err.message : err}`);
+    return null;
+  }
+}
+
+// ----------------------------------------------------------------------------
+// Reporter
+// ----------------------------------------------------------------------------
+
+function printPreflightTable(checks: PreflightCheck[]): void {
+  log(`\n${COLOR.bold}Pre-flight source check${COLOR.reset}`);
+  log(`${COLOR.gray}Columns: feature | test-data | selectors | .spec.ts | test-result.json${COLOR.reset}\n`);
+
+  const ok = (b: boolean) => (b ? `${COLOR.green}✓${COLOR.reset}` : `${COLOR.red}✗${COLOR.reset}`);
+
+  for (const c of checks) {
+    log(
+      `  ${c.screen.padEnd(20)} ${ok(c.featureOk)}  ${ok(c.testDataOk)}  ${ok(c.selectorsOk)}  ${ok(c.specOk)}  ${ok(c.resultsOk)}`
+    );
+  }
+  log('');
+
+  // Show suggestions for any blocking misses
+  const blockers = checks.filter(hasBlockingMissing);
+  if (blockers.length > 0) {
+    log(`${COLOR.yellow}Blocking issues:${COLOR.reset}`);
+    for (const b of blockers) {
+      log(`  ${COLOR.bold}${b.screen}${COLOR.reset}`);
+      for (const m of b.missing) log(`    - ${COLOR.red}✗${COLOR.reset} ${m}`);
+      for (const s of b.suggestions) log(`    ${COLOR.cyan}→ ${s}${COLOR.reset}`);
+    }
+    log('');
+  }
+
+  // Warn about optional misses (results.json)
+  const warnings = checks.filter((c) => !hasBlockingMissing(c) && !c.resultsOk);
+  if (warnings.length > 0) {
+    log(`${COLOR.yellow}Warnings (optional missing):${COLOR.reset}`);
+    for (const w of warnings) {
+      log(`  ${w.screen}: test-result.json missing — execution columns will be empty`);
+    }
+    log('');
+  }
+}
+
+function printSummaryTable(summaries: ScreenSummary[]): void {
+  log(`\n${COLOR.bold}Delivery export complete${COLOR.reset}`);
+  log('');
+  log('  Screen               TCs  Passed  Failed  Pending  N/A  File');
+  log('  ' + '-'.repeat(80));
+  for (const s of summaries) {
+    log(
+      `  ${s.screen.padEnd(20)} ${String(s.total).padStart(3)}  ${String(s.passed).padStart(6)}  ${String(s.failed).padStart(6)}  ${String(s.pending).padStart(7)}  ${String(s.na).padStart(3)}  ${s.outputFile}`
+    );
+  }
+  log('');
+
+  const totalNotCompiled = summaries.reduce((a, s) => a + s.notCompiled, 0);
+  if (totalNotCompiled > 0) {
+    log(`${COLOR.yellow}Note: ${totalNotCompiled} scenario(s) flagged "Not compiled" in CSV. Re-run \`sungen generate\` to compile them.${COLOR.reset}\n`);
+  }
+}
+
+// ----------------------------------------------------------------------------
+// Command registration
+// ----------------------------------------------------------------------------
+
+export function registerDeliveryCommand(program: Command): void {
+  program
+    .command('delivery')
+    .description('Export Gherkin + Playwright results → CSV test case deliverable')
+    .argument('[screens...]', 'Specific screen names. Omit to process all screens.')
+    .option('--skip-preflight', 'Skip pre-flight checks (not recommended)')
+    .option('--continue-on-missing', 'Skip screens with blocking misses instead of aborting')
+    .action(async (screens: string[], options: { skipPreflight?: boolean; continueOnMissing?: boolean }) => {
+      try {
+        const cwd = process.cwd();
+
+        // 1. Scope detection
+        let targetScreens: string[];
+        if (screens && screens.length > 0) {
+          targetScreens = screens;
+        } else {
+          targetScreens = listAllScreens(cwd);
+          if (targetScreens.length === 0) {
+            console.error(`${COLOR.red}No screens found in qa/screens/${COLOR.reset}`);
+            process.exit(1);
+          }
+        }
+
+        log(`${COLOR.bold}sungen delivery${COLOR.reset} — exporting ${targetScreens.length} screen(s): ${targetScreens.join(', ')}\n`);
+
+        // 2. Pre-flight
+        let toExport: string[];
+        if (options.skipPreflight) {
+          toExport = targetScreens;
+        } else {
+          const checks = targetScreens.map((s) => runPreflight(cwd, s));
+          printPreflightTable(checks);
+
+          const blockers = checks.filter(hasBlockingMissing);
+          if (blockers.length > 0) {
+            if (options.continueOnMissing) {
+              toExport = checks.filter((c) => !hasBlockingMissing(c)).map((c) => c.screen);
+              log(`${COLOR.yellow}Continuing with ${toExport.length} ready screen(s).${COLOR.reset}\n`);
+            } else {
+              console.error(
+                `${COLOR.red}Aborted:${COLOR.reset} ${blockers.length} screen(s) have blocking issues.\n` +
+                `Run the suggested commands above, or use ${COLOR.cyan}--continue-on-missing${COLOR.reset} to skip them.`
+              );
+              process.exit(1);
+            }
+          } else {
+            toExport = checks.map((c) => c.screen);
+          }
+        }
+
+        // 3. Export
+        const env = getEnvironment(cwd);
+        const summaries: ScreenSummary[] = [];
+        for (const screen of toExport) {
+          const s = await exportScreen(cwd, screen, env);
+          if (s) summaries.push(s);
+        }
+
+        // 4. Summary
+        printSummaryTable(summaries);
+      } catch (err) {
+        console.error(`${COLOR.red}Fatal:${COLOR.reset} ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+      }
+    });
+}