@sun-asterisk/sungen 3.2.3 → 3.2.5

package/dist/cli/commands/login.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * `sungen login` / `sungen logout`.
+ *
+ * login  — RFC 8252 native-app login (PKCE-S256 + loopback + one-time code)
+ *          against the FastSchema backend; caches the token at
+ *          ~/.sungen/credentials.json (0600).
+ * logout — clears that file.
+ *
+ * Mirrors the structure of `commands/figma.ts` (commander + scrubbed errors).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performLogin = performLogin;
+exports.registerLoginCommand = registerLoginCommand;
+const pkce_1 = require("../../tools/sungen-auth/pkce");
+const loopback_server_1 = require("../../tools/sungen-auth/loopback-server");
+const login_flow_1 = require("../../tools/sungen-auth/login-flow");
+const credentials_store_1 = require("../../tools/sungen-auth/credentials-store");
+const open_browser_1 = require("../../tools/sungen-auth/open-browser");
+const api_base_url_1 = require("../../tools/sungen-auth/api-base-url");
+/**
+ * Run the full login flow against `apiBaseUrl`, persist the token, and return
+ * the stored credentials. Reused by `sungen feedback` for on-demand re-auth.
+ */
+async function performLogin(apiBaseUrl) {
+    const pkce = (0, pkce_1.generatePkce)();
+    const correlation = (0, pkce_1.randomCorrelation)();
+    const loopback = await (0, loopback_server_1.startLoopback)();
+    try {
+        const result = await (0, login_flow_1.runLoginFlow)({
+            apiBaseUrl,
+            pkce,
+            correlation,
+            redirectUri: loopback.redirectUri,
+            openBrowser: open_browser_1.openBrowser,
+            waitForCode: (corr, timeoutMs) => loopback.waitForCode(corr, timeoutMs),
+        });
+        const creds = {
+            token: result.token,
+            email: result.email,
+            api_base_url: apiBaseUrl,
+            expires_at: result.expires_at,
+        };
+        (0, credentials_store_1.saveCredentials)(creds);
+        return creds;
+    }
+    finally {
+        loopback.close();
+    }
+}
+function registerLoginCommand(program) {
+    program
+        .command('login')
+        .description('Log in to the sungen feedback backend (opens your browser)')
+        .option('--api-base-url <url>', 'Backend base URL (overrides SUNGEN_API_BASE_URL + stored value)')
+        .action(async (options) => {
+        const apiBaseUrl = (0, api_base_url_1.resolveApiBaseUrl)(options.apiBaseUrl);
+        try {
+            const creds = await performLogin(apiBaseUrl);
+            console.log(`Logged in as ${creds.email}.`);
+            console.log(`Token saved to ${(0, credentials_store_1.credentialsPath)()} (mode 0600).`);
+        }
+        catch (err) {
+            console.error(`Login failed: ${err?.message ?? err}`);
+            process.exit(1);
+        }
+    });
+    program
+        .command('logout')
+        .description('Remove the cached sungen login token')
+        .action(() => {
+        (0, credentials_store_1.clearCredentials)();
+        console.log(`Logged out. Removed ${(0, credentials_store_1.credentialsPath)()} (if present).`);
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/cli/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/cli/commands/login.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAeH,oCAwBC;AAED,oDAwBC;AA9DD,uDAA+E;AAC/E,6EAAwE;AACxE,mEAAkE;AAClE,iFAA+G;AAC/G,uEAAmE;AACnE,uEAAyE;AAGzE;;;GAGG;AACI,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,MAAM,IAAI,GAAG,IAAA,mBAAY,GAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,IAAA,wBAAiB,GAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAa,GAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAY,EAAC;YAChC,UAAU;YACV,IAAI;YACJ,WAAW;YACX,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAX,0BAAW;YACX,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;SACxE,CAAC,CAAC;QACH,MAAM,KAAK,GAAgB;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;QACF,IAAA,mCAAe,EAAC,KAAK,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,sBAAsB,EAAE,iEAAiE,CAAC;SACjG,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;QACjD,MAAM,UAAU,GAAG,IAAA,gCAAiB,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAA,mCAAe,GAAE,eAAe,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,GAAG,EAAE;QACX,IAAA,oCAAgB,GAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAA,mCAAe,GAAE,gBAAgB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/qa-feedback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `sungen qa-feedback` — the LOCAL QA-feedback log (test-design knowledge +
+ * product telemetry), persisted to .sungen/feedback/feedback.jsonl.
+ *
+ * This is the persistence primitive behind the `/sungen:feedback` slash command
+ * (which auto-attaches screen/viewpoint/decision context and then calls
+ * `sungen qa-feedback record`). It is rarely typed by hand.
+ *
+ * NOTE: distinct from `sungen feedback` (see commands/feedback.ts) — that command
+ * submits PRODUCT feedback to the remote backend. This one only writes locally.
+ */
+import { Command } from 'commander';
+export declare function registerQaFeedbackCommand(program: Command): void;
+//# sourceMappingURL=qa-feedback.d.ts.map

package/dist/cli/commands/qa-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-feedback.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/qa-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0DhE"}

package/dist/cli/commands/qa-feedback.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * `sungen qa-feedback` — the LOCAL QA-feedback log (test-design knowledge +
+ * product telemetry), persisted to .sungen/feedback/feedback.jsonl.
+ *
+ * This is the persistence primitive behind the `/sungen:feedback` slash command
+ * (which auto-attaches screen/viewpoint/decision context and then calls
+ * `sungen qa-feedback record`). It is rarely typed by hand.
+ *
+ * NOTE: distinct from `sungen feedback` (see commands/feedback.ts) — that command
+ * submits PRODUCT feedback to the remote backend. This one only writes locally.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQaFeedbackCommand = registerQaFeedbackCommand;
+const feedback_1 = require("../../harness/feedback");
+const TYPES = ['test-design', 'product', 'other'];
+const DECISIONS = ['accept', 'reject', 'edit', 'add', 'none'];
+function registerQaFeedbackCommand(program) {
+    const fb = program
+        .command('qa-feedback')
+        .description('Local-first QA feedback log (test-design knowledge + product telemetry). Primarily invoked by the /sungen:feedback slash command.');
+    fb
+        .command('record')
+        .description('Record a feedback entry')
+        .requiredOption('--message <text>', 'The feedback')
+        .option('--type <t>', `Feedback type (${TYPES.join('|')})`, 'test-design')
+        .option('-s, --screen <name>', 'Screen/flow the feedback relates to')
+        .option('--target <ref>', 'What it is about (viewpoint id / scenario / command / artifact)')
+        .option('--decision <d>', `QA decision (${DECISIONS.join('|')})`, 'none')
+        .option('--reason <text>', 'Why')
+        .option('--source <who>', 'Who gave the feedback', 'qa')
+        .action((o) => {
+        try {
+            if (!TYPES.includes(o.type))
+                throw new Error(`--type must be one of ${TYPES.join(', ')}`);
+            if (!DECISIONS.includes(o.decision))
+                throw new Error(`--decision must be one of ${DECISIONS.join(', ')}`);
+            const p = (0, feedback_1.recordFeedback)({
+                type: o.type,
+                screen: o.screen,
+                target: o.target,
+                decision: o.decision,
+                message: o.message,
+                reason: o.reason,
+                source: o.source,
+            });
+            console.log(`✓ feedback recorded (${o.type}${o.screen ? ' · ' + o.screen : ''}) → ${p}`);
+        }
+        catch (e) {
+            console.error('Error:', e instanceof Error ? e.message : e);
+            process.exit(1);
+        }
+    });
+    fb
+        .command('list')
+        .description('List / summarise recorded feedback')
+        .option('-s, --screen <name>', 'Filter by screen')
+        .option('--type <t>', 'Filter by type')
+        .option('--json', 'Output raw JSON')
+        .action((o) => {
+        try {
+            const s = (0, feedback_1.summarize)({ screen: o.screen, type: o.type });
+            if (o.json) {
+                console.log(JSON.stringify(s, null, 2));
+                return;
+            }
+            console.log(`\n━━━ Feedback (${s.total}) ━━━`);
+            console.log(`  by type: ${Object.entries(s.byType).map(([k, v]) => `${k}=${v}`).join('  ') || '—'}`);
+            console.log(`  by decision: ${Object.entries(s.byDecision).map(([k, v]) => `${k}=${v}`).join('  ') || '—'}\n`);
+            for (const e of s.entries.slice(-20)) {
+                console.log(`  [${e.type}${e.decision && e.decision !== 'none' ? '/' + e.decision : ''}] ${e.screen ? e.screen + ' · ' : ''}${e.target ? e.target + ' — ' : ''}${e.message}`);
+                if (e.reason)
+                    console.log(`      reason: ${e.reason}`);
+            }
+            console.log('');
+        }
+        catch (e) {
+            console.error('Error:', e instanceof Error ? e.message : e);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=qa-feedback.js.map

package/dist/cli/commands/qa-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-feedback.js","sourceRoot":"","sources":["../../../src/cli/commands/qa-feedback.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -24,6 +24,7 @@ const eval_1 = require("./commands/eval");
 const manifest_1 = require("./commands/manifest");
 const ledger_1 = require("./commands/ledger");
 const feedback_1 = require("./commands/feedback");
+const qa_feedback_1 = require("./commands/qa-feedback");
 const script_check_1 = require("./commands/script-check");
 const trace_1 = require("./commands/trace");
 const challenge_1 = require("./commands/challenge");
@@ -32,6 +33,7 @@ const capability_1 = require("./commands/capability");
 const flow_check_1 = require("./commands/flow-check");
 const context_1 = require("./commands/context");
 const repair_1 = require("./commands/repair");
+const login_1 = require("./commands/login");
 const registry_1 = require("../capabilities/registry");
 const discover_1 = require("../capabilities/discover");
 // Read version from package.json so `--version` never drifts from the released version.
@@ -62,6 +64,7 @@ async function main() {
     (0, manifest_1.registerManifestCommand)(program);
     (0, ledger_1.registerLedgerCommand)(program);
     (0, feedback_1.registerFeedbackCommand)(program);
+    (0, qa_feedback_1.registerQaFeedbackCommand)(program);
     (0, script_check_1.registerScriptCheckCommand)(program);
     (0, trace_1.registerTraceCommand)(program);
     (0, challenge_1.registerChallengeCommand)(program);
@@ -72,6 +75,7 @@ async function main() {
     (0, repair_1.registerRepairCommand)(program);
     (0, ingest_1.registerIngestCommand)(program);
     (0, eval_1.registerEvalCommand)(program);
+    (0, login_1.registerLoginCommand)(program);
     // Capability-contributed CLI commands (Capability SPI): drivers own their authoring commands
     // (e.g. @sungen/driver-api → `sungen api import`). Discover, then register each.
     (0, discover_1.discoverAndRegisterCapabilities)();

package/dist/cli/index.js.map

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

package/dist/dashboard/snapshot-builder.d.ts

@@ -14,6 +14,9 @@ import { EnvironmentInfo } from '../exporters/types';
 import { DashboardSnapshot, ScenarioSnapshot } from './types';
 export interface DashboardTarget {
     name: string;
+    kind: 'screen' | 'flow' | 'api';
+    /** Derived convenience (`kind === 'flow'`) — kept for the flow-specific
+     *  branches that predate the api tier. */
     isFlow: boolean;
 }
 export interface BuildSnapshotOptions {

package/dist/dashboard/snapshot-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-builder.d.ts","sourceRoot":"","sources":["../../src/dashboard/snapshot-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEL,iBAAiB,EAGjB,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAQjB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,CAwBvF;AAwSD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAkBnE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAK5E;AAwFD,YAAY,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"snapshot-builder.d.ts","sourceRoot":"","sources":["../../src/dashboard/snapshot-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAEL,iBAAiB,EAGjB,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAQjB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IAChC;8CAC0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,CAwBvF;AA8XD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAwBnE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAU5E;AAwFD,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/dashboard/snapshot-builder.js

@@ -96,6 +96,24 @@ function buildDashboardSnapshot(options) {
 // ----------------------------------------------------------------------------
 // Per-target build
 // ----------------------------------------------------------------------------
+/**
+ * True when this is a mobile project (`platform: mobile` in qa/capabilities.yaml).
+ * Mobile projects run per-OS (android/ios) — the dashboard surfaces those on a
+ * distinct platform axis (one FeatureSnapshot per OS) rather than as locale tabs.
+ * Mirrors `isMobileProject` in src/cli/commands/delivery.ts.
+ */
+function isMobileProject(cwd) {
+    try {
+        const p = path.join(cwd, 'qa', 'capabilities.yaml');
+        if (!fs.existsSync(p))
+            return false;
+        const parsed = (0, yaml_1.parse)(fs.readFileSync(p, 'utf-8'));
+        return parsed?.platform === 'mobile';
+    }
+    catch {
+        return false;
+    }
+}
 function buildOneScreen(cwd, target, env) {
     const base = qaDir(cwd, target);
     const featuresDir = path.join(base, 'features');
@@ -111,28 +129,49 @@ function buildOneScreen(cwd, target, env) {
         return null;
     const specMdFile = path.join(base, 'requirements', 'spec.md');
     const specLink = fs.existsSync(specMdFile) ? path.relative(cwd, specMdFile) : undefined;
+    const mobile = isMobileProject(cwd);
     const features = [];
     for (const featureBaseName of featureBaseNames) {
-        const fs2 = buildOneFeature(cwd, target, featureBaseName, env, specLink);
-        if (fs2)
-            features.push(fs2);
+        features.push(...buildOneFeature(cwd, target, featureBaseName, env, specLink, mobile));
     }
     if (features.length === 0)
         return null;
     // Flat scenarios across all features (each scenario already carries its
     // own `featureBaseName`, so consumers that want to group can do so cheaply).
+    // For mobile, per-OS features flatten here so the Compare view can key each
+    // scenario by (tcId, platform) via its OS-precise testEnvironment.
     const scenarios = features.flatMap((f) => f.scenarios);
-    const label = target.isFlow ? `flow/${target.name}` : target.name;
-    const primary = features[0];
+    const label = target.kind === 'flow' ? `flow/${target.name}`
+        : target.kind === 'api' ? `api/${target.name}`
+            : target.name;
+    // Screen-level platform axis: 'mobile' when any feature is OS-tagged; the
+    // union of OSes that actually produced a result file this run.
+    const execSet = new Set();
+    let anyPlatform = false;
+    for (const f of features) {
+        if (f.platform)
+            anyPlatform = true;
+        for (const p of f.executedPlatforms ?? [])
+            execSet.add(p);
+    }
+    const executedPlatforms = execSet.size > 0
+        ? ['android', 'ios'].filter((p) => execSet.has(p))
+        : undefined;
+    // Representative feature for the back-compat top-level fields: prefer Android
+    // (deterministic, matches delivery's summary-row preference).
+    const primary = features.find((f) => f.platform === 'android') ?? features[0];
     return {
         name: label,
         isFlow: target.isFlow,
+        kind: target.kind,
+        platform: anyPlatform ? 'mobile' : undefined,
         featureName: primary.featureName,
         featurePath: primary.featurePath,
         specLink,
         summary: rollupScreenSummary(features),
         scenarios,
         features,
+        executedPlatforms,
     };
 }
 /**
@@ -140,14 +179,14 @@ function buildOneScreen(cwd, target, env) {
  * TC IDs are generated using `featureBaseName` as the prefix so they match
  * the delivery CSV (e.g. `HOME-MODAL-UI-001`, not `HOME-UI-001`).
  */
-function buildOneFeature(cwd, target, featureBaseName, env, specLink) {
+function buildOneFeature(cwd, target, featureBaseName, env, specLink, mobile) {
     const base = qaDir(cwd, target);
     const genBase = generatedDir(cwd, target);
     const featureFile = path.join(base, 'features', `${featureBaseName}.feature`);
     const testDataFile = path.join(base, 'test-data', `${featureBaseName}.yaml`);
     const specFile = path.join(genBase, `${featureBaseName}.spec.ts`);
     if (!fs.existsSync(featureFile))
-        return null;
+        return [];
     const feature = (0, feature_parser_1.parseFeatureMetadata)(featureFile);
     const spec = fs.existsSync(specFile)
         ? (0, spec_parser_1.parseSpecFile)(specFile)
@@ -164,24 +203,15 @@ function buildOneFeature(cwd, target, featureBaseName, env, specLink) {
     // 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.
-    // NOTE (mobile): for a `platform: mobile` project the "locale" variants are
-    // actually the per-OS runs (android / ios) — the dashboard reuses the locale
-    // switcher to surface them as tabs. The env column per tab is OS-precise (see
-    // resolvePlatformAppId below), but the top-level featurePath (base variant)
-    // defaults to the Android id. Delivery has a dedicated per-OS path; aligning the
-    // dashboard onto a distinct "platform" axis is a possible follow-up.
     const variants = discoverLocaleVariants(genBase, featureBaseName);
-    // Build per-locale ScreenSnapshot, then collect into FeatureSnapshot.locales[].
-    // Base variant is also used to populate the top-level (`scenarios`, `summary`)
-    // for back-compat with consumers that don't read the locales array.
-    const locales = [];
-    let baseBuilt = null;
-    for (const variant of variants) {
+    // 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.
+    const buildVariant = (variant) => {
         const testData = fs.existsSync(testDataFile)
             ? (0, test_data_resolver_1.loadTestData)(testDataFile, variant.locale || null)
             : {};
         const results = variant.resultsPath ? (0, playwright_report_parser_1.loadPlaywrightReport)(variant.resultsPath) : null;
-        const built = (0, json_exporter_1.buildScreenSnapshot)({
+        return (0, json_exporter_1.buildScreenSnapshot)({
             screen: featureBaseName,
             isFlow: target.isFlow,
             featureName: feature.featureName,
@@ -196,15 +226,63 @@ function buildOneFeature(cwd, target, featureBaseName, env, specLink) {
             featureBaseName,
             selectorKeyMap,
         });
+    };
+    // -- 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
+    //    entry as `locales[]`. This mirrors the delivery per-OS deliverables. --
+    if (mobile) {
+        const osOf = (loc) => /^android(\.|$)/.test(loc) ? 'android' : /^ios(\.|$)/.test(loc) ? 'ios' : null;
+        const osVariants = variants.filter((v) => osOf(v.locale));
+        if (osVariants.length > 0) {
+            const executedPlatforms = ['android', 'ios'].filter((os) => osVariants.some((v) => osOf(v.locale) === os && v.resultsPath));
+            const feats = [];
+            for (const os of ['android', 'ios']) {
+                const group = osVariants.filter((v) => osOf(v.locale) === os);
+                if (group.length === 0)
+                    continue;
+                const localeSnaps = [];
+                let primaryBuilt = null;
+                for (const v of group) {
+                    const built = buildVariant(v);
+                    localeSnaps.push({ locale: v.locale, displayCode: v.displayCode, summary: built.summary, scenarios: built.scenarios });
+                    // Representative = the bare OS run (locale === os); else the first overlay.
+                    if (v.locale === os || !primaryBuilt)
+                        primaryBuilt = built;
+                }
+                if (!primaryBuilt)
+                    continue;
+                feats.push({
+                    featureBaseName,
+                    featureName: primaryBuilt.featureName,
+                    featurePath: primaryBuilt.featurePath,
+                    specLink: primaryBuilt.specLink,
+                    summary: primaryBuilt.summary,
+                    scenarios: primaryBuilt.scenarios,
+                    platform: os,
+                    executedPlatforms,
+                    locales: localeSnaps.length >= 2 ? localeSnaps : undefined,
+                });
+            }
+            if (feats.length > 0)
+                return feats;
+        }
+        // Mobile project but no per-OS result files yet → fall through to the base
+        // (locale-axis) path so the test CASES still render.
+    }
+    // -- Web / i18n (locale axis): one FeatureSnapshot; variants become locales[]. --
+    const locales = [];
+    let baseBuilt = null;
+    for (const variant of variants) {
+        const built = buildVariant(variant);
         locales.push({
             locale: variant.locale,
             displayCode: variant.displayCode,
             summary: built.summary,
             scenarios: built.scenarios,
         });
-        if (variant.locale === '') {
+        if (variant.locale === '')
             baseBuilt = built;
-        }
     }
     // Guarantee a base entry — every feature in the dashboard must have
     // something to fall back to even if base results file is missing.
@@ -218,18 +296,18 @@ function buildOneFeature(cwd, target, featureBaseName, env, specLink) {
         };
     }
     if (!baseBuilt)
-        return null;
-    return {
-        featureBaseName,
-        featureName: baseBuilt.featureName,
-        featurePath: baseBuilt.featurePath,
-        specLink: baseBuilt.specLink,
-        summary: baseBuilt.summary,
-        scenarios: baseBuilt.scenarios,
-        // 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,
-    };
+        return [];
+    return [{
+            featureBaseName,
+            featureName: baseBuilt.featureName,
+            featurePath: baseBuilt.featurePath,
+            specLink: baseBuilt.specLink,
+            summary: baseBuilt.summary,
+            scenarios: baseBuilt.scenarios,
+            // 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,
+        }];
 }
 /**
  * Scan the generated directory for `<basename>-test-result*.json` files
@@ -327,40 +405,65 @@ function bumpKey(record, key) {
 // ----------------------------------------------------------------------------
 // Path helpers (mirror delivery.ts to stay consistent)
 // ----------------------------------------------------------------------------
+/** qa/ subfolder for a unit kind (mirrors delivery.ts's qaParent). */
+function qaParent(kind) {
+    return kind === 'flow' ? 'flows' : kind === 'api' ? 'api' : 'screens';
+}
 function qaDir(cwd, target) {
-    return path.join(cwd, 'qa', target.isFlow ? 'flows' : 'screens', target.name);
+    return path.join(cwd, 'qa', qaParent(target.kind), target.name);
 }
 function generatedDir(cwd, target) {
-    return target.isFlow
-        ? path.join(cwd, 'specs', 'generated', 'flows', target.name)
-        : path.join(cwd, 'specs', 'generated', target.name);
+    // Mirrors delivery.ts: screen → specs/generated/<name>, flow → …/flows/<name>,
+    // api → …/api/<name> (api flows carry name 'flows/<flow>', composing correctly).
+    const sub = target.kind === 'flow'
+        ? path.join('flows', target.name)
+        : target.kind === 'api'
+            ? path.join('api', target.name)
+            : target.name;
+    return path.join(cwd, 'specs', 'generated', sub);
 }
 // ----------------------------------------------------------------------------
 // Discovery (also used by CLI)
 // ----------------------------------------------------------------------------
 function listDashboardTargets(cwd) {
     const targets = [];
-    const screensDir = path.join(cwd, 'qa', 'screens');
-    if (fs.existsSync(screensDir)) {
-        for (const d of fs.readdirSync(screensDir, { withFileTypes: true })) {
-            if (d.isDirectory())
-                targets.push({ name: d.name, isFlow: false });
+    const scan = (kind, skip = () => false) => {
+        const dir = path.join(cwd, 'qa', qaParent(kind));
+        if (!fs.existsSync(dir))
+            return;
+        for (const d of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (d.isDirectory() && !skip(d.name))
+                targets.push({ name: d.name, kind, isFlow: kind === 'flow' });
         }
-    }
-    const flowsDir = path.join(cwd, 'qa', 'flows');
-    if (fs.existsSync(flowsDir)) {
-        for (const d of fs.readdirSync(flowsDir, { withFileTypes: true })) {
+    };
+    scan('screen');
+    scan('flow');
+    scan('api', (n) => n === 'flows'); // api areas: qa/api/<area> (the flows/ container is a nested tier)
+    // api flows: qa/api/flows/<flow> → name 'flows/<flow>', kind 'api'
+    // (paths compose to qa/api/flows/… + specs/generated/api/flows/…), mirroring delivery.ts.
+    const apiFlowsRoot = path.join(cwd, 'qa', 'api', 'flows');
+    if (fs.existsSync(apiFlowsRoot)) {
+        for (const d of fs.readdirSync(apiFlowsRoot, { withFileTypes: true })) {
             if (d.isDirectory())
-                targets.push({ name: d.name, isFlow: true });
+                targets.push({ name: path.posix.join('flows', d.name), kind: 'api', isFlow: false });
         }
     }
     return targets.sort((a, b) => a.name.localeCompare(b.name));
 }
 function resolveTargetType(cwd, name) {
-    if (fs.existsSync(path.join(cwd, 'qa', 'flows', name))) {
-        return { name, isFlow: true };
-    }
-    return { name, isFlow: false };
+    if (fs.existsSync(path.join(cwd, 'qa', 'flows', name)))
+        return { name, kind: 'flow', isFlow: true };
+    // Screen before api so `dashboard <name>` resolves the same unit as `delivery <name>`
+    // when a repo has both qa/screens/<name> and qa/api/<name> (delivery.ts precedence).
+    if (fs.existsSync(path.join(cwd, 'qa', 'screens', name)))
+        return { name, kind: 'screen', isFlow: false };
+    if (fs.existsSync(path.join(cwd, 'qa', 'api', name)))
+        return { name, kind: 'api', isFlow: false };
+    // `flows/<flow>` or a bare api-flow name → qa/api/flows/<flow>
+    const apiFlow = name.startsWith('flows/') ? name : path.posix.join('flows', name);
+    if (fs.existsSync(path.join(cwd, 'qa', 'api', apiFlow)))
+        return { name: apiFlow, kind: 'api', isFlow: false };
+    return { name, kind: 'screen', isFlow: false };
 }
 // ----------------------------------------------------------------------------
 // Run ID + environment metadata (Vietnam Indochina Time, UTC+7, no DST)