@sun-asterisk/sungen 3.2.2-beta.9 → 3.2.3-beta.3

package/dist/orchestrator/ai-skills/writer.js

@@ -0,0 +1,129 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyOutputs = applyOutputs;
+/**
+ * applyOutputs — write a BuiltFile[] to disk with the agreed semantics (decisions 2, T2).
+ *
+ *   managed (skills/commands): ALWAYS overwritten (version-managed, no rollback)
+ *   config  (CLAUDE.md/AGENTS.md/copilot-instructions): skip-if-exists unless `force`
+ *   orphans: managed files written last run but not this run are DELETED (manifest-derived,
+ *            replaces the hand-curated STALE list — decision T2)
+ *   detect-and-warn: if a managed file on disk was hand-edited since we wrote it, warn
+ *   dry-run: report adds/overwrites/skips/deletes/warnings without touching disk
+ *
+ * Manifest: <cwd>/.sungen/manifest.json = { version, managed: { <path>: <sha256> } }
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const MANIFEST_REL = path.join('.sungen', 'manifest.json');
+const sha = (s) => crypto.createHash('sha256').update(s).digest('hex');
+function readManifest(cwd) {
+    const p = path.join(cwd, MANIFEST_REL);
+    if (!fs.existsSync(p))
+        return { version: '', managed: {} };
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf8'));
+    }
+    catch {
+        return { version: '', managed: {} };
+    }
+}
+function applyOutputs(cwd, outputs, opts) {
+    const r = { created: [], overwritten: [], skippedConfig: [], deletedOrphans: [], handEditWarnings: [] };
+    const prev = readManifest(cwd);
+    const newManaged = {};
+    const write = (rel, content) => {
+        if (opts.dryRun)
+            return;
+        const abs = path.join(cwd, rel);
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, content, 'utf8');
+    };
+    for (const f of outputs) {
+        const abs = path.join(cwd, f.outputPath);
+        const exists = fs.existsSync(abs);
+        if (f.cls === 'config') {
+            if (exists && !opts.force) {
+                r.skippedConfig.push(f.outputPath);
+                continue;
+            }
+            (exists ? r.overwritten : r.created).push(f.outputPath);
+            write(f.outputPath, f.content);
+            continue;
+        }
+        // managed: always overwrite, but warn if hand-edited since our last write
+        if (exists) {
+            const current = fs.readFileSync(abs, 'utf8');
+            const recorded = prev.managed[f.outputPath];
+            if (recorded && sha(current) !== recorded && sha(current) !== sha(f.content)) {
+                r.handEditWarnings.push(f.outputPath);
+            }
+            if (current !== f.content)
+                r.overwritten.push(f.outputPath);
+        }
+        else {
+            r.created.push(f.outputPath);
+        }
+        write(f.outputPath, f.content);
+        newManaged[f.outputPath] = sha(f.content);
+    }
+    // Orphan cleanup: managed files we wrote last time but not now.
+    for (const oldPath of Object.keys(prev.managed)) {
+        if (newManaged[oldPath])
+            continue;
+        r.deletedOrphans.push(oldPath);
+        if (!opts.dryRun) {
+            const abs = path.join(cwd, oldPath);
+            if (fs.existsSync(abs))
+                fs.rmSync(abs, { force: true });
+            // prune now-empty skill dir
+            const dir = path.dirname(abs);
+            try {
+                if (fs.existsSync(dir) && fs.readdirSync(dir).length === 0)
+                    fs.rmdirSync(dir);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    if (!opts.dryRun) {
+        const mPath = path.join(cwd, MANIFEST_REL);
+        fs.mkdirSync(path.dirname(mPath), { recursive: true });
+        fs.writeFileSync(mPath, JSON.stringify({ version: opts.version, managed: newManaged }, null, 2));
+    }
+    return r;
+}
+//# sourceMappingURL=writer.js.map

package/dist/orchestrator/ai-skills/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/writer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,oCAyDC;AA3FD;;;;;;;;;;;GAWG;AACH,uCAAyB;AACzB,2CAA6B;AAC7B,+CAAiC;AASjC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAI/E,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3D,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAAC,CAAC;AACvG,CAAC;AAED,SAAgB,YAAY,CAAC,GAAW,EAAE,OAAoB,EAAE,IAAkB;IAChF,MAAM,CAAC,GAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;IACrH,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,UAAU,GAA2B,EAAE,CAAC;IAE9C,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,OAAe,EAAE,EAAE;QAC7C,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC5E,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACxD,KAAK,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,0EAA0E;QAC1E,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7E,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACxC,CAAC;YACD,IAAI,OAAO,KAAK,CAAC,CAAC,OAAO;gBAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC/B,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,gEAAgE;IAChE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QAClC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACpC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,4BAA4B;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC;gBAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;oBAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC/G,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC3C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/orchestrator/flow-manager.d.ts

@@ -7,6 +7,12 @@ export interface FlowOptions {
     name: string;
     path?: string;
     description?: string;
+    /**
+     * Mobile navigation recipe for the flow's starting screen. A `>`-separated list of nav steps
+     * that take the app from launch to the first screen in the flow. Scaffolded into the Background.
+     * Ignored (with a warning) for web projects.
+     */
+    reach?: string;
 }
 export declare class FlowManager {
     private cwd;
@@ -18,5 +24,10 @@ export declare class FlowManager {
     private generateSpecTemplate;
     private generateViewpointTemplate;
     private generateFeatureTemplate;
+    /**
+     * Build the Background block for a mobile flow — same structure as screen-manager.
+     * The `--reach` steps represent how to reach the FIRST screen of the flow from app launch.
+     */
+    private buildMobileBackground;
 }
 //# sourceMappingURL=flow-manager.d.ts.map

package/dist/orchestrator/flow-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-manager.d.ts","sourceRoot":"","sources":["../../src/orchestrator/flow-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;;IAOnB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0FlD,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,oBAAoB;IAiC5B,OAAO,CAAC,yBAAyB;IAmDjC,OAAO,CAAC,uBAAuB;CAyBhC"}
+{"version":3,"file":"flow-manager.d.ts","sourceRoot":"","sources":["../../src/orchestrator/flow-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;;IAOnB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2HlD,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,oBAAoB;IAiE5B,OAAO,CAAC,yBAAyB;IAmDjC,OAAO,CAAC,uBAAuB;IAkD/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAmC9B"}

package/dist/orchestrator/flow-manager.js

@@ -41,6 +41,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowManager = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const capability_1 = require("../harness/capability");
 class FlowManager {
     constructor() {
         this.cwd = process.cwd();
@@ -48,6 +49,14 @@ class FlowManager {
     }
     async addFlow(options) {
         this.validateFlowName(options.name);
+        // Detect project platform from qa/capabilities.yaml
+        const caps = (0, capability_1.readCapabilities)(this.cwd);
+        const isMobile = caps.platform === 'mobile';
+        // --reach is mobile-only; warn and drop when the project is web
+        if (options.reach && !isMobile) {
+            console.warn(`Warning: --reach is a mobile navigation recipe and is ignored for web projects. Dropping it.`);
+            options = { ...options, reach: undefined };
+        }
         const flowName = this.normalizeFlowName(options.name);
         const flowDir = path.join(this.flowsDir, flowName);
         const featuresDir = path.join(flowDir, 'features');
@@ -77,27 +86,39 @@ class FlowManager {
             console.error(`  ${error instanceof Error ? error.message : String(error)}`);
             process.exit(1);
         }
-        fs.writeFileSync(featurePath, this.generateFeatureTemplate(options, flowName), 'utf-8');
+        fs.writeFileSync(featurePath, this.generateFeatureTemplate(options, flowName, isMobile), 'utf-8');
         const startPath = options.path || '/login';
-        fs.writeFileSync(selectorPath, [
-            `# ${options.name} Flow Selectors`,
-            `# Namespace keys by screen to avoid duplicates: "login:submit", "awards:submit"`,
-            ``,
-            `# --- Login screen ---`,
-            `login:`,
-            `  type: 'page'`,
-            `  value: '${startPath}'`,
-            ``,
-            `# "login:email":`,
-            `#   type: 'testid'`,
-            `#   value: 'email-input'`,
-            ``,
-            `# "login:submit":`,
-            `#   type: 'role'`,
-            `#   value: 'button'`,
-            `#   name: 'Login'`,
-            ``,
-        ].join('\n'), 'utf-8');
+        const selectorLines = isMobile
+            ? [
+                `# ${options.name} Flow Selectors (mobile)`,
+                `# Namespace keys by screen: "home:button", "settings:save"`,
+                `# Generated at /sungen:run-test via Appium MCP — accessibility-id preferred.`,
+                ``,
+                `# "home:element":`,
+                `#   type: 'accessibility-id'`,
+                `#   value: 'element-id'`,
+                ``,
+            ]
+            : [
+                `# ${options.name} Flow Selectors`,
+                `# Namespace keys by screen to avoid duplicates: "login:submit", "awards:submit"`,
+                ``,
+                `# --- Login screen ---`,
+                `login:`,
+                `  type: 'page'`,
+                `  value: '${startPath}'`,
+                ``,
+                `# "login:email":`,
+                `#   type: 'testid'`,
+                `#   value: 'email-input'`,
+                ``,
+                `# "login:submit":`,
+                `#   type: 'role'`,
+                `#   value: 'button'`,
+                `#   name: 'Login'`,
+                ``,
+            ];
+        fs.writeFileSync(selectorPath, selectorLines.join('\n'), 'utf-8');
         fs.writeFileSync(testDataPath, [
             `# ${options.name} Flow Test Data`,
             `# Namespace by phase: login.email, submission.nominee`,
@@ -105,7 +126,7 @@ class FlowManager {
             ``,
         ].join('\n'), 'utf-8');
         const specPath = path.join(requirementsDir, 'spec.md');
-        fs.writeFileSync(specPath, this.generateSpecTemplate(options, flowName), 'utf-8');
+        fs.writeFileSync(specPath, this.generateSpecTemplate(options, flowName, isMobile), 'utf-8');
         const viewpointPath = path.join(requirementsDir, 'test-viewpoint.md');
         fs.writeFileSync(viewpointPath, this.generateViewpointTemplate(options), 'utf-8');
         console.log(`Created files:`);
@@ -116,12 +137,22 @@ class FlowManager {
         console.log(`  ${path.relative(this.cwd, viewpointPath)}`);
         console.log(`  ${path.relative(this.cwd, requirementsUiDir)}/`);
         console.log('');
-        console.log('Next steps:');
-        console.log(`  1. Fill requirements/spec.md with flow specification (screens, transitions, business rules)`);
-        console.log(`     Optionally add UI designs to requirements/ui/`);
-        console.log(`  2. Generate test cases: /sungen:create-test ${flowName}`);
-        console.log(`  3. Compile: sungen generate --flow ${flowName}`);
-        console.log(`  4. Run: npx playwright test\n`);
+        if (isMobile) {
+            console.log('Next steps:');
+            console.log(`  1. Fill requirements/spec.md with flow specification (screens, transitions, business rules)`);
+            console.log(`     Use sungen-capture-mobile to scan each screen via Appium MCP`);
+            console.log(`  2. Generate test cases: /sungen:create-test ${flowName}`);
+            console.log(`  3. Compile: sungen generate --flow ${flowName} --framework appium`);
+            console.log(`  4. Run: npm run test:mobile\n`);
+        }
+        else {
+            console.log('Next steps:');
+            console.log(`  1. Fill requirements/spec.md with flow specification (screens, transitions, business rules)`);
+            console.log(`     Optionally add UI designs to requirements/ui/`);
+            console.log(`  2. Generate test cases: /sungen:create-test ${flowName}`);
+            console.log(`  3. Compile: sungen generate --flow ${flowName}`);
+            console.log(`  4. Run: npx playwright test\n`);
+        }
     }
     validateFlowName(name) {
         if (!name || name.trim().length === 0) {
@@ -140,7 +171,38 @@ class FlowManager {
             .replace(/^-+|-+$/g, '')
             .replace(/-+/g, '-');
     }
-    generateSpecTemplate(options, flowName) {
+    generateSpecTemplate(options, flowName, isMobile) {
+        if (isMobile) {
+            return `# ${options.name} Flow Specification
+
+## Overview
+- **Platform:** mobile (Android + iOS)
+- **Auth Required:** no
+- **Starting screen reach:** ${options.reach || '<!-- nav recipe to reach the first screen, e.g. "tap [Tab] > tap [Row]" -->'}
+
+## Screens in Flow
+<!-- List all screens this flow visits, in order -->
+
+| # | Screen | Reach | Description |
+|---|--------|-------|-------------|
+| 1 | [Screen Name] | tap [element] | [What user does here] |
+
+## Flow Steps
+
+### Step 1: [Screen Name]
+- **Action:** [What the user taps]
+- **Expected:** [What should happen]
+- **Transition:** Navigates to Step 2
+
+## Business Rules
+<!-- Rules that affect the flow: permissions, conditions, limits -->
+- [Rule 1]
+
+## Notes
+<!-- Edge cases, known issues, environment-specific behavior -->
+- [Note 1]
+`;
+        }
         const startPath = options.path || '/login';
         return `# ${options.name} Flow Specification
 
@@ -222,8 +284,31 @@ class FlowManager {
             '',
         ].join('\n');
     }
-    generateFeatureTemplate(options, flowName) {
+    generateFeatureTemplate(options, flowName, isMobile) {
         const description = options.description || `complete the ${options.name} flow`;
+        if (isMobile) {
+            const background = this.buildMobileBackground(options.reach);
+            return `@flow @platform:mobile
+Feature: ${options.name} Flow
+
+  As a user
+  I want to ${description}
+  So that I can accomplish my end-to-end goal
+
+  # Mobile (Appium) flow — selectors use colon namespace: "home:element", "settings:save".
+  # See sungen-mobile-gestures for swipe/long-press/scroll steps.
+
+${background}
+  @high
+  Scenario: Sample step for ${options.name}
+    When User tap [Home:element]
+    Then User see [Settings] screen
+
+  Scenario: Sample next step for ${options.name}
+    When User tap [Settings:element]
+    Then User see [Result:header] header with {{result_text}}
+`;
+        }
         return `@flow
 Feature: ${options.name} Flow
 
@@ -246,6 +331,39 @@ Feature: ${options.name} Flow
     Then User see "expected result" text
 `;
     }
+    /**
+     * Build the Background block for a mobile flow — same structure as screen-manager.
+     * The `--reach` steps represent how to reach the FIRST screen of the flow from app launch.
+     */
+    buildMobileBackground(reach) {
+        const normalizeStep = (raw) => raw
+            .trim()
+            .replace(/^(given|when|and|then|but)\s+/i, '')
+            .replace(/^user\s+/i, '')
+            .trim();
+        const steps = (reach || '')
+            .split('>')
+            .map(normalizeStep)
+            .filter(Boolean);
+        if (steps.length === 0) {
+            return [
+                '  Background:',
+                '    # Navigation recipe — how to reach the first screen of this flow from app launch.',
+                '    # Prefill with --reach "tap [Tab] > tap [Row]" at add-flow time.',
+                '    Given User is on [Home] screen',
+                '    # When User tap [<tab or button that leads to the first screen>]',
+                '',
+            ].join('\n');
+        }
+        const navLines = steps.map((body, i) => `    ${i === 0 ? 'When' : 'And'} User ${body}`);
+        return [
+            '  Background:',
+            '    # Navigation recipe — replayed by capture-mobile to land on the first screen.',
+            '    Given User is on [Home] screen',
+            ...navLines,
+            '',
+        ].join('\n');
+    }
 }
 exports.FlowManager = FlowManager;
 //# sourceMappingURL=flow-manager.js.map

package/dist/orchestrator/flow-manager.js.map

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

package/dist/orchestrator/mobile-runtime-scaffolder.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Mobile Runtime Scaffolder
+ *
+ * Emits the Appium/WebdriverIO harness files into a project directory.
+ * Called by ProjectInitializer (init --mobile) and, in Phase 02, by `capability add mobile`.
+ * Never duplicated — always imported from here.
+ */
+export interface MobileInitOptions {
+    enabled: boolean;
+    /** Mobile-only project: skip all web (Playwright) scaffolding, deps, and Chromium download. */
+    mobileOnly?: boolean;
+    appPackage?: string;
+    appActivity?: string;
+    appApk?: string;
+    androidUdid?: string;
+    iosBundleId?: string;
+    iosDevice?: string;
+    iosVersion?: string;
+}
+export interface ScaffoldResult {
+    created: string[];
+    skipped: string[];
+}
+/**
+ * Emit the mobile runtime harness into `cwd`.
+ *
+ * Files written:
+ *   wdio.conf.ts                        — project root (seeded from mobile options)
+ *   specs/reporters/pw-shape-reporter.ts — Playwright-shaped JSON reporter for WDIO
+ *   .env.appium                          — seeded from flags (gitignored)
+ *   .env.appium.example                 — committed placeholder guide
+ *
+ * The caller is responsible for adding `test:mobile` to package.json scripts and
+ * writing qa/capabilities.yaml — helpers for both are exported below.
+ */
+export declare function emitMobileRuntime(cwd: string, opts: MobileInitOptions): ScaffoldResult;
+/**
+ * Write qa/capabilities.yaml for a mobile project.
+ * Uses the canonical writeCapabilities from harness/capability so the format is always consistent.
+ */
+export declare function writeMobileCapabilities(cwd: string): string;
+/**
+ * Best-effort provision of the mobile runtime into a project that has opted into mobile
+ * (`sungen init --mobile` / `sungen capability add mobile` — never auto-run; consent-gated).
+ *
+ * Installs everything the runner needs:
+ *   1. `@sungen/driver-mobile` + its WebdriverIO/Appium runtime (declared as that package's `dependencies`).
+ *      A local `file:` spec (dev/dogfood) uses `npm install --install-links` so npm COPIES the package and
+ *      installs its transitive deps — a plain file: install only SYMLINKS it and skips the runtime. A
+ *      published/registry spec installs deps normally.
+ *   2. the appium PLATFORM drivers (uiautomator2 / xcuitest, ~/.appium-managed) — NOT npm packages, so
+ *      installed via the appium CLI here (installAppiumPlatformDrivers), so a session can actually start.
+ *
+ * Non-fatal: logs a warning on failure so offline/air-gapped init still scaffolds correctly.
+ *
+ * @returns true if the driver install succeeded (or was already present), false on failure
+ */
+export declare function installMobileDriver(cwd: string): boolean;
+//# sourceMappingURL=mobile-runtime-scaffolder.d.ts.map

package/dist/orchestrator/mobile-runtime-scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-runtime-scaffolder.d.ts","sourceRoot":"","sources":["../../src/orchestrator/mobile-runtime-scaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAkEtF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAgGD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAyCxD"}