@sun-asterisk/sungen 3.2.5 → 3.2.7

package/dist/orchestrator/templates/specs-api.js

@@ -34,6 +34,8 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.api = void 0;
+exports.inferMime = inferMime;
+exports.resolveFixture = resolveFixture;
 exports.joinApiUrl = joinApiUrl;
 /* eslint-disable */
 /**
@@ -75,6 +77,37 @@ function loadConfig() {
 function substitute(text, params) {
     return text.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => encodeURIComponent(String(params[p] ?? '')));
 }
+/** Bind `:param` tokens WITHOUT URL-encoding — for headers, body-file paths, and multipart file paths. */
+function substituteRaw(text, params) {
+    return text.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => String(params[p] ?? ''));
+}
+/** Delete any case-insensitive variant of a header (HTTP header names are case-insensitive, but a
+ *  plain object keys on exact case — so a datasource `Content-Type` and our `content-type` would
+ *  both be sent). Call before setting, or to let Playwright own the header (multipart boundary). */
+function deleteHeader(headers, name) {
+    const lower = name.toLowerCase();
+    for (const k of Object.keys(headers))
+        if (k.toLowerCase() === lower)
+            delete headers[k];
+}
+const MIME = {
+    png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif', webp: 'image/webp',
+    svg: 'image/svg+xml', pdf: 'application/pdf', csv: 'text/csv', txt: 'text/plain',
+    json: 'application/json', xml: 'application/xml', zip: 'application/zip', mp4: 'video/mp4',
+};
+function inferMime(name) {
+    return MIME[(name.split('.').pop() || '').toLowerCase()] || 'application/octet-stream';
+}
+/** Resolve a fixture path: cwd-relative/absolute first, else qa/fixtures/<path>. */
+function resolveFixture(p, label) {
+    const direct = path.isAbsolute(p) ? p : path.join(process.cwd(), p);
+    if (fs.existsSync(direct))
+        return direct;
+    const inFixtures = path.join(process.cwd(), 'qa', 'fixtures', p);
+    if (fs.existsSync(inFixtures))
+        return inFixtures;
+    throw new Error(`API Driver: ${label} — fixture "${p}" not found (looked in ${direct} and qa/fixtures/${p}).`);
+}
 /**
  * Join a datasource base URL with a catalog path. Concatenate rather than rely on Playwright's
  * baseURL resolution: an absolute path (`/user/1`) resolves against the base ORIGIN and would drop
@@ -116,7 +149,7 @@ class ApiClient {
         const headers = { ...(conf.headers || {}) };
         // catalog headers; :param tokens bind at runtime — raw (no URL-encoding, unlike the path)
         for (const [k, v] of Object.entries(req.headers || {}))
-            headers[k] = String(v).replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => String(params[p] ?? ''));
+            headers[k] = substituteRaw(String(v), params);
         // Body: substitute `:param` into the body template (object values), then encode per `encoding`.
         let body;
         if (req.body !== undefined && req.body !== null) {
@@ -124,8 +157,43 @@ class ApiClient {
         }
         // Map the wire format to the right Playwright option (#345): json → data (application/json,
         // default), form → form (application/x-www-form-urlencoded), multipart → multipart (form-data).
+        // A `files` block is a real upload: read each fixture into a { name, mimeType, buffer } part and
+        // send multipart, with any `body` values riding along as text fields.
         const bodyOpt = {};
-        if (body !== undefined) {
+        if (req.bodyFile) {
+            // Raw-binary body: the whole request body is the fixture's bytes. Content-Type comes from the
+            // spec's mimeType (default application/octet-stream) — this is what octet-stream upload
+            // endpoints expect (a multipart body would be rejected 415).
+            const spec = typeof req.bodyFile === 'string' ? { path: req.bodyFile } : req.bodyFile;
+            const fpath = substituteRaw(String(spec.path), params);
+            if (fpath) {
+                const resolved = resolveFixture(fpath, label);
+                bodyOpt.data = fs.readFileSync(resolved);
+                // Own the Content-Type: drop any datasource default (case-insensitive) so we don't send both.
+                deleteHeader(headers, 'content-type');
+                headers['content-type'] = spec.mimeType ?? 'application/octet-stream';
+            }
+        }
+        else if (req.files && Object.keys(req.files).length) {
+            const mp = {};
+            if (body && typeof body === 'object')
+                for (const [k, v] of Object.entries(body))
+                    mp[k] = typeof v === 'string' ? v : JSON.stringify(v);
+            for (const [field, raw] of Object.entries(req.files)) {
+                const spec = typeof raw === 'string' ? { path: raw } : raw;
+                const fpath = substituteRaw(String(spec.path), params);
+                if (!fpath)
+                    continue; // empty param → omit the part (a missing-file / wrong-type error row)
+                const resolved = resolveFixture(fpath, label);
+                const filename = spec.filename ?? path.basename(resolved);
+                mp[spec.name ?? field] = { name: filename, mimeType: spec.mimeType ?? inferMime(filename), buffer: fs.readFileSync(resolved) };
+            }
+            // Playwright generates the multipart/form-data Content-Type (with boundary); drop any datasource
+            // default Content-Type so it doesn't conflict with / duplicate the generated one.
+            deleteHeader(headers, 'content-type');
+            bodyOpt.multipart = mp;
+        }
+        else if (body !== undefined) {
             const enc = req.encoding ?? 'json';
             if (enc === 'form')
                 bodyOpt.form = body;
@@ -139,7 +207,7 @@ class ApiClient {
         // authenticated cookies. Disposed per call so no request context lingers and hangs the process.
         const ctx = await test_1.request.newContext({
             extraHTTPHeaders: headers,
-            timeout: conf.timeout_ms ?? 15000,
+            timeout: req.timeout ?? conf.timeout_ms ?? 15000, // per-endpoint override → datasource → 15s
             ...(opts.storageState ? { storageState: opts.storageState } : {}),
         });
         try {
@@ -177,6 +245,66 @@ class ApiClient {
             statuses: responses.map((r) => r.status),
         };
     }
+    /**
+     * Validate a response body against a named JSON Schema from `qa/api/schemas.yaml` (populated by
+     * `sungen api import` from the OpenAPI `components.schemas`). Backs `expect {{name.body}} matches
+     * schema [Ref]` — a full-contract check beyond individual field asserts. Returns `{ ok, errors }`;
+     * the generated assertion feeds `errors` into the failure message. Uses Ajv (a QA-project dep).
+     */
+    assertSchema(value, schemaName) {
+        return assertSchemaImpl(value, schemaName);
+    }
+}
+// ── Response-schema validation (Ajv) ─────────────────────────────────────────────────────────────
+// Schemas live in qa/api/schemas.yaml (name → JSON Schema, incl. #/components/schemas/* $refs).
+// Loaded + compiled lazily so a project that never asserts a schema needs no Ajv resolution.
+let _apiSchemas;
+function loadApiSchemas() {
+    if (_apiSchemas !== undefined)
+        return _apiSchemas || {};
+    const file = [path.join(process.cwd(), 'qa', 'api', 'schemas.yaml'), path.join(process.cwd(), 'schemas.yaml')].find((f) => fs.existsSync(f));
+    if (!file) {
+        _apiSchemas = null;
+        return {};
+    }
+    const { parse } = require('yaml');
+    _apiSchemas = parse(fs.readFileSync(file, 'utf8')) || {};
+    return _apiSchemas || {};
+}
+let _ajv;
+function getAjv() {
+    if (_ajv)
+        return _ajv;
+    const Ajv = require('ajv');
+    _ajv = new Ajv({ allErrors: true, strict: false });
+    try {
+        require('ajv-formats')(_ajv);
+    }
+    catch { /* formats optional */ }
+    // Register every named schema under its component ref so inter-schema $refs resolve.
+    for (const [name, schema] of Object.entries(loadApiSchemas())) {
+        try {
+            _ajv.addSchema(schema, `#/components/schemas/${name}`);
+        }
+        catch { /* dup/invalid → skip */ }
+    }
+    return _ajv;
+}
+function assertSchemaImpl(value, schemaName) {
+    const schema = loadApiSchemas()[schemaName];
+    if (!schema)
+        return { ok: false, errors: `schema "${schemaName}" not found in qa/api/schemas.yaml` };
+    let validate;
+    try {
+        const ajv = getAjv();
+        validate = ajv.getSchema(`#/components/schemas/${schemaName}`) || ajv.compile(schema);
+    }
+    catch (e) {
+        return { ok: false, errors: `schema "${schemaName}" failed to compile: ${e?.message || e}` };
+    }
+    const ok = validate(value) === true;
+    const errors = ok ? '' : (validate.errors || []).map((e) => `${e.instancePath || '(root)'} ${e.message}`).join('; ') || 'did not match schema';
+    return { ok, errors };
 }
 exports.api = new ApiClient();
 //# sourceMappingURL=specs-api.js.map

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

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

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

@@ -48,6 +48,37 @@ function loadConfig(): Record<string, ApiDataSource> {
 function substitute(text: string, params: Record<string, any>): string {
   return text.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => encodeURIComponent(String(params[p] ?? '')));
 }
+/** Bind `:param` tokens WITHOUT URL-encoding — for headers, body-file paths, and multipart file paths. */
+function substituteRaw(text: string, params: Record<string, any>): string {
+  return text.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => String(params[p] ?? ''));
+}
+/** Delete any case-insensitive variant of a header (HTTP header names are case-insensitive, but a
+ *  plain object keys on exact case — so a datasource `Content-Type` and our `content-type` would
+ *  both be sent). Call before setting, or to let Playwright own the header (multipart boundary). */
+function deleteHeader(headers: Record<string, string>, name: string): void {
+  const lower = name.toLowerCase();
+  for (const k of Object.keys(headers)) if (k.toLowerCase() === lower) delete headers[k];
+}
+
+/** A multipart file field embedded by the compiler (string = shorthand for { path }). */
+type FileSpec = string | { path: string; mimeType?: string; filename?: string; name?: string };
+
+const MIME: Record<string, string> = {
+  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif', webp: 'image/webp',
+  svg: 'image/svg+xml', pdf: 'application/pdf', csv: 'text/csv', txt: 'text/plain',
+  json: 'application/json', xml: 'application/xml', zip: 'application/zip', mp4: 'video/mp4',
+};
+export function inferMime(name: string): string {
+  return MIME[(name.split('.').pop() || '').toLowerCase()] || 'application/octet-stream';
+}
+/** Resolve a fixture path: cwd-relative/absolute first, else qa/fixtures/<path>. */
+export function resolveFixture(p: string, label: string): string {
+  const direct = path.isAbsolute(p) ? p : path.join(process.cwd(), p);
+  if (fs.existsSync(direct)) return direct;
+  const inFixtures = path.join(process.cwd(), 'qa', 'fixtures', p);
+  if (fs.existsSync(inFixtures)) return inFixtures;
+  throw new Error(`API Driver: ${label} — fixture "${p}" not found (looked in ${direct} and qa/fixtures/${p}).`);
+}
 
 /**
  * Join a datasource base URL with a catalog path. Concatenate rather than rely on Playwright's
@@ -82,7 +113,7 @@ class ApiClient {
    */
   async call(
     label: string,
-    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; headers?: Record<string, string>; datasource?: string },
+    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
     params: Record<string, any> = {},
     opts: { storageState?: string } = {},
   ): Promise<{ status: number; ok: boolean; body: any; headers: Record<string, string> }> {
@@ -94,7 +125,7 @@ class ApiClient {
     const headers: Record<string, string> = { ...(conf.headers || {}) };
     // catalog headers; :param tokens bind at runtime — raw (no URL-encoding, unlike the path)
     for (const [k, v] of Object.entries(req.headers || {}))
-      headers[k] = String(v).replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_m, p) => String(params[p] ?? ''));
+      headers[k] = substituteRaw(String(v), params);
     // Body: substitute `:param` into the body template (object values), then encode per `encoding`.
     let body: any;
     if (req.body !== undefined && req.body !== null) {
@@ -102,8 +133,39 @@ class ApiClient {
     }
     // Map the wire format to the right Playwright option (#345): json → data (application/json,
     // default), form → form (application/x-www-form-urlencoded), multipart → multipart (form-data).
+    // A `files` block is a real upload: read each fixture into a { name, mimeType, buffer } part and
+    // send multipart, with any `body` values riding along as text fields.
     const bodyOpt: Record<string, unknown> = {};
-    if (body !== undefined) {
+    if (req.bodyFile) {
+      // Raw-binary body: the whole request body is the fixture's bytes. Content-Type comes from the
+      // spec's mimeType (default application/octet-stream) — this is what octet-stream upload
+      // endpoints expect (a multipart body would be rejected 415).
+      const spec = typeof req.bodyFile === 'string' ? { path: req.bodyFile } : req.bodyFile;
+      const fpath = substituteRaw(String(spec.path), params);
+      if (fpath) {
+        const resolved = resolveFixture(fpath, label);
+        bodyOpt.data = fs.readFileSync(resolved);
+        // Own the Content-Type: drop any datasource default (case-insensitive) so we don't send both.
+        deleteHeader(headers, 'content-type');
+        headers['content-type'] = spec.mimeType ?? 'application/octet-stream';
+      }
+    } else if (req.files && Object.keys(req.files).length) {
+      const mp: Record<string, any> = {};
+      if (body && typeof body === 'object')
+        for (const [k, v] of Object.entries(body as Record<string, unknown>)) mp[k] = typeof v === 'string' ? v : JSON.stringify(v);
+      for (const [field, raw] of Object.entries(req.files)) {
+        const spec = typeof raw === 'string' ? { path: raw } : raw;
+        const fpath = substituteRaw(String(spec.path), params);
+        if (!fpath) continue; // empty param → omit the part (a missing-file / wrong-type error row)
+        const resolved = resolveFixture(fpath, label);
+        const filename = spec.filename ?? path.basename(resolved);
+        mp[spec.name ?? field] = { name: filename, mimeType: spec.mimeType ?? inferMime(filename), buffer: fs.readFileSync(resolved) };
+      }
+      // Playwright generates the multipart/form-data Content-Type (with boundary); drop any datasource
+      // default Content-Type so it doesn't conflict with / duplicate the generated one.
+      deleteHeader(headers, 'content-type');
+      bodyOpt.multipart = mp;
+    } else if (body !== undefined) {
       const enc = req.encoding ?? 'json';
       if (enc === 'form') bodyOpt.form = body;
       else if (enc === 'multipart') bodyOpt.multipart = body;
@@ -115,7 +177,7 @@ class ApiClient {
     // authenticated cookies. Disposed per call so no request context lingers and hangs the process.
     const ctx: APIRequestContext = await request.newContext({
       extraHTTPHeaders: headers,
-      timeout: conf.timeout_ms ?? 15000,
+      timeout: req.timeout ?? conf.timeout_ms ?? 15000, // per-endpoint override → datasource → 15s
       ...(opts.storageState ? { storageState: opts.storageState } : {}),
     });
     try {
@@ -139,7 +201,7 @@ class ApiClient {
    */
   async callN(
     label: string,
-    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; headers?: Record<string, string>; datasource?: string },
+    req: { method: string; path: string; body?: unknown; encoding?: 'json' | 'form' | 'multipart'; files?: Record<string, FileSpec>; bodyFile?: FileSpec; headers?: Record<string, string>; timeout?: number; datasource?: string },
     params: Record<string, any> = {},
     n = 1,
     opts: { storageState?: string } = {},
@@ -160,6 +222,57 @@ class ApiClient {
       statuses: responses.map((r) => r.status),
     };
   }
+
+  /**
+   * Validate a response body against a named JSON Schema from `qa/api/schemas.yaml` (populated by
+   * `sungen api import` from the OpenAPI `components.schemas`). Backs `expect {{name.body}} matches
+   * schema [Ref]` — a full-contract check beyond individual field asserts. Returns `{ ok, errors }`;
+   * the generated assertion feeds `errors` into the failure message. Uses Ajv (a QA-project dep).
+   */
+  assertSchema(value: unknown, schemaName: string): { ok: boolean; errors: string } {
+    return assertSchemaImpl(value, schemaName);
+  }
+}
+
+// ── Response-schema validation (Ajv) ─────────────────────────────────────────────────────────────
+// Schemas live in qa/api/schemas.yaml (name → JSON Schema, incl. #/components/schemas/* $refs).
+// Loaded + compiled lazily so a project that never asserts a schema needs no Ajv resolution.
+let _apiSchemas: Record<string, any> | null | undefined;
+function loadApiSchemas(): Record<string, any> {
+  if (_apiSchemas !== undefined) return _apiSchemas || {};
+  const file = [path.join(process.cwd(), 'qa', 'api', 'schemas.yaml'), path.join(process.cwd(), 'schemas.yaml')].find((f) => fs.existsSync(f));
+  if (!file) { _apiSchemas = null; return {}; }
+  const { parse } = require('yaml');
+  _apiSchemas = (parse(fs.readFileSync(file, 'utf8')) as Record<string, any>) || {};
+  return _apiSchemas || {};
+}
+
+let _ajv: any;
+function getAjv(): any {
+  if (_ajv) return _ajv;
+  const Ajv = require('ajv');
+  _ajv = new Ajv({ allErrors: true, strict: false });
+  try { require('ajv-formats')(_ajv); } catch { /* formats optional */ }
+  // Register every named schema under its component ref so inter-schema $refs resolve.
+  for (const [name, schema] of Object.entries(loadApiSchemas())) {
+    try { _ajv.addSchema(schema, `#/components/schemas/${name}`); } catch { /* dup/invalid → skip */ }
+  }
+  return _ajv;
+}
+
+function assertSchemaImpl(value: unknown, schemaName: string): { ok: boolean; errors: string } {
+  const schema = loadApiSchemas()[schemaName];
+  if (!schema) return { ok: false, errors: `schema "${schemaName}" not found in qa/api/schemas.yaml` };
+  let validate: any;
+  try {
+    const ajv = getAjv();
+    validate = ajv.getSchema(`#/components/schemas/${schemaName}`) || ajv.compile(schema);
+  } catch (e: any) {
+    return { ok: false, errors: `schema "${schemaName}" failed to compile: ${e?.message || e}` };
+  }
+  const ok = validate(value) === true;
+  const errors = ok ? '' : (validate.errors || []).map((e: any) => `${e.instancePath || '(root)'} ${e.message}`).join('; ') || 'did not match schema';
+  return { ok, errors };
 }
 
 export const api = new ApiClient();

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

@@ -48,7 +48,26 @@ export class TestDataLoader {
     if (value === undefined || value === null) {
       throw new Error(`Test data key not found: ${key}`);
     }
-    return String(value);
+    return this.interpolate(String(value));
+  }
+
+  /**
+   * Substitute embedded `{{ref}}` cross-references inside a resolved string value.
+   * Each ref is looked up via resolve() (flat key, @cases row column, or dotted path),
+   * so `expected_operator_id_label: 'ID : {{operator.id}}'` yields the real value at
+   * runtime — matching the delivery report's substituteTestDataVars. `$`-prefixed
+   * dynamic vars ({{$timestamp}} …) are already substituted at load time and never
+   * match `[\w.]+`, so they are left untouched. Resolution recurses (a referenced value
+   * may itself hold refs) up to a depth cap that guards against reference cycles; an
+   * unknown or empty ref is left as the literal `{{ref}}` — never blanked.
+   */
+  private interpolate(value: string, depth: number = 0): string {
+    if (depth > 10 || value.indexOf('{{') === -1) return value;
+    return value.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (match, ref: string) => {
+      const resolved = this.resolve(ref);
+      if (resolved === undefined || resolved === null || resolved === '') return match;
+      return this.interpolate(String(resolved), depth + 1);
+    });
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sun-asterisk/sungen",
-  "version": "3.2.5",
+  "version": "3.2.7",
   "description": "Deterministic E2E Test Compiler - Gherkin + Selectors → Playwright tests",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -12,7 +12,7 @@
     "copy-templates": "mkdir -p dist/generators/test-generator/adapters/playwright/templates/steps && mkdir -p dist/generators/test-generator/templates && mkdir -p dist/orchestrator/templates && mkdir -p dist/dashboard/templates && cp -r src/generators/test-generator/adapters/playwright/templates/*.hbs dist/generators/test-generator/adapters/playwright/templates/ 2>/dev/null || true && cp -r src/generators/test-generator/adapters/playwright/templates/steps dist/generators/test-generator/adapters/playwright/templates/ && mkdir -p dist/generators/test-generator/adapters/appium/templates/steps && cp -r src/generators/test-generator/adapters/appium/templates/*.hbs dist/generators/test-generator/adapters/appium/templates/ 2>/dev/null || true && cp -r src/generators/test-generator/adapters/appium/templates/steps dist/generators/test-generator/adapters/appium/templates/ && cp src/generators/test-generator/templates/*.hbs dist/generators/test-generator/templates/ 2>/dev/null || true && cp -r src/orchestrator/templates/* dist/orchestrator/templates/ && cp src/dashboard/templates/index.html dist/dashboard/templates/index.html && mkdir -p dist/harness/catalog && cp src/harness/catalog/*.yaml dist/harness/catalog/",
     "build:dashboard": "cd ../../dashboard && npm install --silent && npm run build && cd - && cp ../../dashboard/dist/index.html src/dashboard/templates/index.html",
     "dev": "tsx src/cli/index.ts",
-    "test": "tsx tests/golden/run.ts && tsx tests/audit/run.ts && tsx tests/ingest/run.ts && tsx tests/eval/run.ts && tsx tests/exporter/run.ts && tsx tests/exporter/feature-parser-category.run.ts && tsx tests/exporter/api-detail-sheet.run.ts && tsx tests/exporter/overview-sheet.run.ts && tsx tests/exporter/delivery-divider-tcid.run.ts && tsx tests/exporter/note-expected-actual.run.ts && tsx tests/exporter/test-data-vars.run.ts && tsx tests/exporter/mobile-app-id.run.ts && tsx tests/exporter/api-testcase-cells.run.ts && tsx tests/dashboard/api-flows-discovery.run.ts && tsx tests/codegen/verb-ref-masking.run.ts && tsx tests/api-runtime/base-path-url-join.run.ts && tsx tests/capabilities/run.ts && tsx tests/openapi/run.ts && tsx tests/packaging/run.ts && tsx tests/generate-hint/run.ts && tsx tests/template-assertion/run.ts && tsx tests/journey/run.ts && tsx tests/harness/serial-cascade.run.ts && tsx tests/ai-skills/cross-assistant-orphan.run.ts && tsx tests/init/codex-mcp-config.run.ts && tsx src/orchestrator/ai-skills/golden-skills.test.ts",
+    "test": "tsx tests/golden/run.ts && tsx tests/audit/run.ts && tsx tests/ingest/run.ts && tsx tests/eval/run.ts && tsx tests/exporter/run.ts && tsx tests/exporter/feature-parser-category.run.ts && tsx tests/exporter/api-detail-sheet.run.ts && tsx tests/exporter/overview-sheet.run.ts && tsx tests/exporter/delivery-divider-tcid.run.ts && tsx tests/exporter/note-expected-actual.run.ts && tsx tests/exporter/test-data-vars.run.ts && tsx tests/exporter/mobile-app-id.run.ts && tsx tests/exporter/api-testcase-cells.run.ts && tsx tests/exporter/delivery-cases-result.run.ts && tsx tests/exporter/precondition-auth-role.run.ts && tsx tests/exporter/report-builder-parity.run.ts && tsx tests/dashboard/api-flows-discovery.run.ts && tsx tests/dashboard/status-results-fallback.run.ts && tsx tests/codegen/verb-ref-masking.run.ts && tsx tests/api-runtime/base-path-url-join.run.ts && tsx tests/api-runtime/file-upload-multipart.run.ts && tsx tests/api-runtime/schema-assertion.run.ts && tsx tests/runtime/test-data-cross-ref.run.ts && tsx tests/capabilities/run.ts && tsx tests/openapi/run.ts && tsx tests/api-field-coverage/run.ts && tsx tests/packaging/run.ts && tsx tests/generate-hint/run.ts && tsx tests/template-assertion/run.ts && tsx tests/journey/run.ts && tsx tests/harness/serial-cascade.run.ts && tsx tests/ai-skills/cross-assistant-orphan.run.ts && tsx tests/init/codex-mcp-config.run.ts && tsx src/orchestrator/ai-skills/golden-skills.test.ts",
     "test:update": "tsx tests/golden/run.ts --update && tsx tests/audit/run.ts --update && tsx tests/ingest/run.ts --update",
     "prepublishOnly": "npm run build:dashboard && npm run build"
   },
@@ -33,7 +33,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@sungen/driver-ui": "3.2.5",
+    "@sungen/driver-ui": "3.2.7",
     "@anthropic-ai/sdk": "^0.71.0",
     "@babel/parser": "^7.28.5",
     "@babel/traverse": "^7.28.5",

package/src/cli/commands/delivery.ts

@@ -12,7 +12,7 @@ import { parseFeatureMetadata } from '../../exporters/feature-parser';
 import { parseSpecFile } from '../../exporters/spec-parser';
 import { loadTestData } from '../../exporters/test-data-resolver';
 import { loadSelectorKeyMap } from '../../exporters/selector-key-resolver';
-import { loadPlaywrightReport } from '../../exporters/playwright-report-parser';
+import { loadPlaywrightReport, resolveResultsPath as resolveResultsPathShared } from '../../exporters/playwright-report-parser';
 import { mergeFeatureAndSpec } from '../../exporters/scenario-merger';
 import {
   buildTestCaseRows,
@@ -21,6 +21,7 @@ import {
   writeCsv,
 } from '../../exporters/csv-exporter';
 import { renderXlsxMultiSheet, writeXlsx, buildApiDetailRows, addApiDetailSheet } from '../../exporters/xlsx-exporter';
+import { loadApiCatalog } from '../../exporters/api-catalog-loader';
 import { resolvePlatformAppId } from '../../exporters/mobile-app-id';
 import { EnvironmentInfo, PreflightCheck, ScreenSummary, TestCaseRow, ApiCatalogEntry } from '../../exporters/types';
 
@@ -136,35 +137,8 @@ function qaDir(cwd: string, target: DeliveryTarget): string {
   return path.join(cwd, 'qa', qaParent(target.kind), target.screen);
 }
 
-/**
- * Load the apis.yaml catalog for an api-kind unit, merging the shared catalog under
- * the unit catalog. The runtime resolves an endpoint unit-scope-first then falls back
- * to the shared catalog (driver-api api-catalog.ts), so an endpoint defined only in
- * `qa/api/apis.yaml` still runs — we must load it too, or its request block would come
- * back empty (the very bug this feature fixes). Unit wins on a name collision.
- * Returns an empty object when neither file is present (graceful degradation).
- */
-function loadApiCatalog(cwd: string, target: DeliveryTarget): Record<string, ApiCatalogEntry> {
-  if (target.kind !== 'api') return {};
-  const shared = readApiCatalogFile(path.join(cwd, 'qa', 'api', 'apis.yaml'));
-  const unit = readApiCatalogFile(path.join(cwd, 'qa', 'api', target.screen, 'api', 'apis.yaml'));
-  return { ...shared, ...unit };
-}
-
-/** Parse one apis.yaml file into an endpoint map, unwrapping the optional `apis:` wrapper. */
-function readApiCatalogFile(catalogPath: string): Record<string, ApiCatalogEntry> {
-  if (!fs.existsSync(catalogPath)) return {};
-  try {
-    const parsed = parseYaml(fs.readFileSync(catalogPath, 'utf-8')) as Record<string, unknown> | null;
-    if (parsed && typeof parsed === 'object') {
-      // The runtime loader accepts both a flat map and an `apis:` wrapper — unwrap it
-      // here too so both loaders read the same file identically.
-      const root = parsed.apis && typeof parsed.apis === 'object' ? parsed.apis : parsed;
-      return root as Record<string, ApiCatalogEntry>;
-    }
-  } catch { /* malformed yaml — skip */ }
-  return {};
-}
+// apis.yaml catalog loading moved to ../../exporters/api-catalog-loader so the
+// dashboard snapshot builder loads the identical contract (shared + unit merge).
 
 function generatedDir(cwd: string, target: DeliveryTarget): string {
   const sub = target.kind === 'flow' ? path.join('flows', target.screen) : target.kind === 'api' ? path.join('api', target.screen) : target.screen;
@@ -188,17 +162,9 @@ function generatedDir(cwd: string, target: DeliveryTarget): string {
  * `SUNGEN_ENV` is set, so each locale run keeps its own results file.
  */
 function resolveResultsPath(cwd: string, target: DeliveryTarget): string | null {
-  const genDir = generatedDir(cwd, target);
-  const env = process.env.SUNGEN_ENV;
-  const candidates: string[] = [];
-  if (env) candidates.push(path.join(genDir, `${target.featureBaseName}-test-result.${env}.json`));
-  candidates.push(path.join(genDir, `${target.featureBaseName}-test-result.json`));
-  if (env) candidates.push(path.join(cwd, 'test-results', `results.${env}.json`));
-  candidates.push(path.join(cwd, 'test-results', 'results.json'));
-  for (const c of candidates) {
-    if (fs.existsSync(c)) return c;
-  }
-  return null;
+  // Shared with the dashboard snapshot builder (same candidate order incl. the
+  // test-results/results.json fallback) so the two surfaces can't drift.
+  return resolveResultsPathShared(cwd, generatedDir(cwd, target), target.featureBaseName);
 }
 
 /**
@@ -477,7 +443,7 @@ async function exportTarget(
     const explicitEnv = process.env.SUNGEN_ENV;
 
     // For api-kind units, load the endpoint catalog so we can add the API detail sheet.
-    const apiCatalog = loadApiCatalog(cwd, target);
+    const apiCatalog = loadApiCatalog(cwd, target.kind, target.screen);
     const hasApiCatalog = target.kind === 'api' && Object.keys(apiCatalog).length > 0;
 
     // Decide between single-locale and aggregated multi-locale flows.

package/src/dashboard/snapshot-builder.ts

@@ -19,12 +19,14 @@ import { parseFeatureMetadata } from '../exporters/feature-parser';
 import { parseSpecFile } from '../exporters/spec-parser';
 import { loadTestData } from '../exporters/test-data-resolver';
 import { loadSelectorKeyMap } from '../exporters/selector-key-resolver';
-import { loadPlaywrightReport } from '../exporters/playwright-report-parser';
+import { loadPlaywrightReport, resolveResultsPath } from '../exporters/playwright-report-parser';
 import { mergeFeatureAndSpec } from '../exporters/scenario-merger';
 import { buildScreenSnapshot } from '../exporters/json-exporter';
+import { loadApiCatalog } from '../exporters/api-catalog-loader';
+import { buildApiDetailRows } from '../exporters/xlsx-exporter';
 import { resolvePlatformAppId } from '../exporters/mobile-app-id';
 import { getPackageVersion } from '../exporters/package-info';
-import { EnvironmentInfo } from '../exporters/types';
+import { ApiCatalogEntry, EnvironmentInfo } from '../exporters/types';
 import {
   AggregateSummary,
   DashboardSnapshot,
@@ -126,9 +128,13 @@ function buildOneScreen(
   const specLink = fs.existsSync(specMdFile) ? path.relative(cwd, specMdFile) : undefined;
 
   const mobile = isMobileProject(cwd);
+  // api-kind units: load the endpoint catalog once per target — the same
+  // shared+unit merge delivery.ts uses — so Steps/Expected cells and the API
+  // detail sheet match the delivery CSV/XLSX exactly.
+  const apiCatalog = loadApiCatalog(cwd, target.kind, target.name);
   const features: FeatureSnapshot[] = [];
   for (const featureBaseName of featureBaseNames) {
-    features.push(...buildOneFeature(cwd, target, featureBaseName, env, specLink, mobile));
+    features.push(...buildOneFeature(cwd, target, featureBaseName, env, specLink, mobile, apiCatalog));
   }
   if (features.length === 0) return null;
 
@@ -183,6 +189,7 @@ function buildOneFeature(
   env: EnvironmentInfo,
   specLink: string | undefined,
   mobile: boolean,
+  apiCatalog: Record<string, ApiCatalogEntry>,
 ): FeatureSnapshot[] {
   const base = qaDir(cwd, target);
   const genBase = generatedDir(cwd, target);
@@ -210,7 +217,7 @@ function buildOneFeature(
   // Discover locale variants by scanning <feature>-test-result*.json files.
   // Always includes base ('') as the first entry, even if its results file
   // is missing — UI still needs to render the feature.
-  const variants = discoverLocaleVariants(genBase, featureBaseName);
+  const variants = discoverLocaleVariants(cwd, genBase, featureBaseName);
 
   // Build one per-variant ScreenSnapshot (test-data overlay + results + OS-precise
   // env column). Reused by both the web/i18n (locale-axis) and mobile (platform-axis) paths.
@@ -233,10 +240,21 @@ function buildOneFeature(
       env,
       featureBaseName,
       selectorKeyMap,
+      kind: target.kind,
+      apiCatalog,
     });
   };
   type Built = ReturnType<typeof buildVariant>;
 
+  // API detail sheet rows — the identical buildApiDetailRows call delivery.ts
+  // makes before addApiDetailSheet, precomputed so the (browser-side) XLSX
+  // export just passes them to the shared builder. Endpoint contract is
+  // locale-invariant → computed once per feature.
+  const apiDetailRows = target.kind === 'api' && Object.keys(apiCatalog).length > 0
+    ? buildApiDetailRows(apiCatalog, feature.scenarios)
+    : [];
+  const apiDetail = apiDetailRows.length > 0 ? apiDetailRows : undefined;
+
   // -- Mobile (platform axis): the per-OS runs (android / ios) are their own
   //    FeatureSnapshot entries — one per OS, `platform` tagged — NOT locale tabs.
   //    Locale overlays for a given OS (e.g. `android.ja`) nest inside that OS's
@@ -272,6 +290,7 @@ function buildOneFeature(
           platform: os,
           executedPlatforms,
           locales: localeSnaps.length >= 2 ? localeSnaps : undefined,
+          apiDetail,
         });
       }
       if (feats.length > 0) return feats;
@@ -318,6 +337,7 @@ function buildOneFeature(
     // Only expose `locales` array when 2+ variants exist — single-locale
     // features stay slimmer and UI can skip the locale tab UI entirely.
     locales: locales.length >= 2 ? locales : undefined,
+    apiDetail,
   }];
 }
 
@@ -342,15 +362,19 @@ interface FeatureLocaleVariant {
  * dashboard and the CSV/XLSX delivery agree on what locales exist for a
  * given feature.
  */
-function discoverLocaleVariants(genDir: string, featureBaseName: string): FeatureLocaleVariant[] {
+function discoverLocaleVariants(cwd: string, genDir: string, featureBaseName: string): FeatureLocaleVariant[] {
   const prefix = `${featureBaseName}-test-result`;
   const variants: FeatureLocaleVariant[] = [];
 
-  const basePath = path.join(genDir, `${prefix}.json`);
+  // Base variant resolves through the SHARED candidate chain (per-feature file
+  // first, then the global test-results/results.json playwright writes by
+  // default) — the same resolution delivery.ts uses. Without the fallback the
+  // dashboard showed every scenario Pending on projects that only have the
+  // global results file, while delivery correctly reported Passed.
   variants.push({
     locale: '',
     displayCode: DEFAULT_BASE_LOCALE.toUpperCase(),
-    resultsPath: fs.existsSync(basePath) ? basePath : null,
+    resultsPath: resolveResultsPath(cwd, genDir, featureBaseName),
   });
 
   if (fs.existsSync(genDir)) {