@planu/cli 0.15.2

package/dist/engine/doc-generator/executive-summary/section-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-builders.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/section-builders.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/executive-summary/svg-diagrams.d.ts

@@ -0,0 +1,8 @@
+import type { ArchitectureSnapshot, ExecutiveSummarySpecEntry, RiskProfile } from '../../../types/index.js';
+/** Generate an SVG showing stacked architecture layers with gradient colors. */
+export declare function generateArchitectureSvg(arch: ArchitectureSnapshot): string;
+/** Generate an SVG timeline: horizontal bars proportional to devHours, colored by difficulty. */
+export declare function generateTimelineSvg(specs: ExecutiveSummarySpecEntry[]): string;
+/** Generate an SVG stacked horizontal bar for risk distribution. */
+export declare function generateRiskDistributionSvg(risk: RiskProfile): string;
+//# sourceMappingURL=svg-diagrams.d.ts.map

package/dist/engine/doc-generator/executive-summary/svg-diagrams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-diagrams.d.ts","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/svg-diagrams.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAUjC,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAwC1E;AAED,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,yBAAyB,EAAE,GAAG,MAAM,CA8B9E;AAED,oEAAoE;AACpE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA6CrE"}

package/dist/engine/doc-generator/executive-summary/svg-diagrams.js

@@ -0,0 +1,124 @@
+const DIFFICULTY_COLORS = {
+    1: '#10B981', // trivial — green
+    2: '#3B82F6', // simple — blue
+    3: '#F59E0B', // moderate — amber
+    4: '#EF4444', // complex — red
+    5: '#7C3AED', // expert — purple
+};
+/** Generate an SVG showing stacked architecture layers with gradient colors. */
+export function generateArchitectureSvg(arch) {
+    const layers = arch.layers.length > 0 ? arch.layers : ['No layers detected'];
+    const boxHeight = 40;
+    const boxWidth = 360;
+    const gap = 10;
+    const totalHeight = layers.length * (boxHeight + gap) + gap + 40;
+    const svgWidth = 440;
+    const gradients = layers.map((_, i) => {
+        const ratio = layers.length > 1 ? i / (layers.length - 1) : 0;
+        const r = Math.round(79 + (124 - 79) * ratio);
+        const g = Math.round(70 + (58 - 70) * ratio);
+        const b = Math.round(229 + (237 - 229) * ratio);
+        return `rgb(${r},${g},${b})`;
+    });
+    const boxes = layers
+        .map((layer, i) => {
+        const y = gap + i * (boxHeight + gap);
+        const color = gradients[i] ?? '#4F46E5';
+        const arrowY = y + boxHeight;
+        const arrow = i < layers.length - 1
+            ? `<line x1="${svgWidth / 2}" y1="${arrowY}" x2="${svgWidth / 2}" y2="${arrowY + gap}" stroke="#94a3b8" stroke-width="2" marker-end="url(#arrow)"/>`
+            : '';
+        return `
+    <rect x="${(svgWidth - boxWidth) / 2}" y="${y}" width="${boxWidth}" height="${boxHeight}" rx="6" fill="${color}" opacity="0.9"/>
+    <text x="${svgWidth / 2}" y="${y + boxHeight / 2 + 5}" text-anchor="middle" font-family="sans-serif" font-size="13" fill="white" font-weight="600">${escapeXml(layer)}</text>
+    ${arrow}`;
+    })
+        .join('');
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${svgWidth} ${totalHeight}" style="max-width:100%;font-family:sans-serif">
+  <defs>
+    <marker id="arrow" markerWidth="8" markerHeight="8" refX="4" refY="4" orient="auto">
+      <path d="M0,0 L8,4 L0,8 Z" fill="#94a3b8"/>
+    </marker>
+  </defs>
+  ${boxes}
+</svg>`;
+}
+/** Generate an SVG timeline: horizontal bars proportional to devHours, colored by difficulty. */
+export function generateTimelineSvg(specs) {
+    if (specs.length === 0) {
+        return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 60" style="max-width:100%">
+  <text x="200" y="35" text-anchor="middle" font-family="sans-serif" font-size="14" fill="#94a3b8">No specs available</text>
+</svg>`;
+    }
+    const maxHours = Math.max(...specs.map((s) => s.devHours), 1);
+    const rowHeight = 28;
+    const labelWidth = 150;
+    const barMaxWidth = 220;
+    const svgWidth = labelWidth + barMaxWidth + 60;
+    const svgHeight = specs.length * rowHeight + 20;
+    const rows = specs
+        .map((spec, i) => {
+        const y = 10 + i * rowHeight;
+        const barWidth = Math.round((spec.devHours / maxHours) * barMaxWidth);
+        const color = DIFFICULTY_COLORS[spec.difficulty] ?? '#94a3b8';
+        const label = spec.title.length > 20 ? spec.title.slice(0, 18) + '…' : spec.title;
+        return `
+    <text x="${labelWidth - 5}" y="${y + 16}" text-anchor="end" font-family="sans-serif" font-size="11" fill="#374151">${escapeXml(label)}</text>
+    <rect x="${labelWidth}" y="${y + 4}" width="${barWidth}" height="18" rx="3" fill="${color}" opacity="0.85"/>
+    <text x="${labelWidth + barWidth + 5}" y="${y + 16}" font-family="sans-serif" font-size="10" fill="#6b7280">${spec.devHours}h</text>`;
+    })
+        .join('');
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${svgWidth} ${svgHeight}" style="max-width:100%;font-family:sans-serif">
+  ${rows}
+</svg>`;
+}
+/** Generate an SVG stacked horizontal bar for risk distribution. */
+export function generateRiskDistributionSvg(risk) {
+    const total = risk.low + risk.medium + risk.high + risk.critical;
+    if (total === 0) {
+        return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 60" style="max-width:100%">
+  <text x="200" y="35" text-anchor="middle" font-family="sans-serif" font-size="14" fill="#94a3b8">No risk data</text>
+</svg>`;
+    }
+    const barWidth = 380;
+    const barHeight = 30;
+    const svgWidth = 420;
+    const svgHeight = 90;
+    const segments = [
+        { count: risk.low, color: '#10B981', label: 'Low' },
+        { count: risk.medium, color: '#F59E0B', label: 'Medium' },
+        { count: risk.high, color: '#F97316', label: 'High' },
+        { count: risk.critical, color: '#EF4444', label: 'Critical' },
+    ];
+    let xOffset = 20;
+    const bars = segments
+        .map(({ count, color }) => {
+        if (count === 0) {
+            return '';
+        }
+        const width = Math.round((count / total) * barWidth);
+        const bar = `<rect x="${xOffset}" y="10" width="${width}" height="${barHeight}" fill="${color}" opacity="0.9"/><text x="${xOffset + width / 2}" y="30" text-anchor="middle" font-family="sans-serif" font-size="11" fill="white" font-weight="600">${count}</text>`;
+        xOffset += width;
+        return bar;
+    })
+        .join('');
+    const legend = segments
+        .map(({ color, label }, i) => {
+        const lx = 20 + i * 100;
+        return `<rect x="${lx}" y="52" width="12" height="12" fill="${color}" rx="2"/><text x="${lx + 16}" y="63" font-family="sans-serif" font-size="11" fill="#374151">${label}</text>`;
+    })
+        .join('');
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${svgWidth} ${svgHeight}" style="max-width:100%;font-family:sans-serif">
+  ${bars}
+  ${legend}
+</svg>`;
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=svg-diagrams.js.map

package/dist/engine/doc-generator/executive-summary/svg-diagrams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-diagrams.js","sourceRoot":"","sources":["../../../../src/engine/doc-generator/executive-summary/svg-diagrams.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/guide-generators.d.ts

@@ -0,0 +1,4 @@
+export { generateReadme, generateSetupGuide } from './readme-setup-generators.js';
+export { generateArchitectureDoc, generateApiReference, generateUserGuide, } from './arch-api-user-generators.js';
+export { generateDeploymentGuide } from './deployment-generator.js';
+//# sourceMappingURL=guide-generators.d.ts.map

package/dist/engine/doc-generator/guide-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-generators.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/guide-generators.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/engine/doc-generator/guide-generators.js

@@ -0,0 +1,9 @@
+// Planu — Guide Document Generators (barrel re-export)
+// Implementation split across:
+//   readme-setup-generators.ts  — generateReadme, generateSetupGuide
+//   arch-api-user-generators.ts — generateArchitectureDoc, generateApiReference, generateUserGuide
+//   deployment-generator.ts     — generateDeploymentGuide
+export { generateReadme, generateSetupGuide } from './readme-setup-generators.js';
+export { generateArchitectureDoc, generateApiReference, generateUserGuide, } from './arch-api-user-generators.js';
+export { generateDeploymentGuide } from './deployment-generator.js';
+//# sourceMappingURL=guide-generators.js.map

package/dist/engine/doc-generator/guide-generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-generators.js","sourceRoot":"","sources":["../../../src/engine/doc-generator/guide-generators.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,+BAA+B;AAC/B,qEAAqE;AACrE,mGAAmG;AACnG,0DAA0D;AAE1D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/engine/doc-generator/mobile-distribution-android.d.ts

@@ -0,0 +1,6 @@
+import type { DocSection } from '../../types/index.js';
+/**
+ * Builds the Android Google Play Internal Testing & Production submission section.
+ */
+export declare function buildAndroidDistributionSection(): DocSection;
+//# sourceMappingURL=mobile-distribution-android.d.ts.map

package/dist/engine/doc-generator/mobile-distribution-android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-distribution-android.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/mobile-distribution-android.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,UAAU,CAuC5D"}

package/dist/engine/doc-generator/mobile-distribution-android.js

@@ -0,0 +1,47 @@
+// engine/doc-generator/mobile-distribution-android.ts — SPEC-013 tech-debt criterion 15
+// Android/Google Play distribution section builder.
+// SRP: one responsibility — generate Android store submission steps.
+/**
+ * Builds the Android Google Play Internal Testing & Production submission section.
+ */
+export function buildAndroidDistributionSection() {
+    return {
+        title: 'Android — Google Play Internal Testing & Production',
+        level: 2,
+        content: [
+            '### Prerequisites',
+            '- Google Play Console account ($25 one-time)',
+            '- App created in Play Console with package name registered',
+            '- Upload keystore configured in `app/build.gradle` signing config',
+            '',
+            '### Step 1: Build signed AAB',
+            '```bash',
+            './gradlew bundleRelease',
+            '# Verify signing:',
+            'jarsigner -verify -verbose -certs \\',
+            '  app/build/outputs/bundle/release/app-release.aab',
+            '```',
+            '',
+            '### Step 2: Upload to Internal Testing',
+            '```bash',
+            'fastlane supply --aab app/build/outputs/bundle/release/app-release.aab \\',
+            '  --track internal',
+            '```',
+            '- In Play Console: Release → Testing → Internal testing → Create release',
+            '- Upload AAB, add testers by email or Google Groups',
+            '- Testers install via Play Store opt-in link (instant, no review)',
+            '',
+            '### Step 3: Promote to Production',
+            '```bash',
+            'fastlane supply --track internal --track_promote_to production',
+            '```',
+            '- Complete content rating questionnaire',
+            '- Verify target API level meets Play Store requirements (current: API 34+)',
+            '- Set phased rollout percentage: 1% → 5% → 10% → 100% over 7 days',
+            '- Monitor Android Vitals: crash rate < 1.09%, ANR rate < 0.47%',
+            '',
+            '> **Verification:** Bundle in Play Console "Available to testers" status. `jarsigner -verify` passes.',
+        ].join('\n'),
+    };
+}
+//# sourceMappingURL=mobile-distribution-android.js.map

package/dist/engine/doc-generator/mobile-distribution-android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-distribution-android.js","sourceRoot":"","sources":["../../../src/engine/doc-generator/mobile-distribution-android.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,oDAAoD;AACpD,qEAAqE;AAIrE;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,KAAK,EAAE,qDAAqD;QAC5D,KAAK,EAAE,CAAC;QACR,OAAO,EAAE;YACP,mBAAmB;YACnB,8CAA8C;YAC9C,4DAA4D;YAC5D,mEAAmE;YACnE,EAAE;YACF,8BAA8B;YAC9B,SAAS;YACT,yBAAyB;YACzB,mBAAmB;YACnB,sCAAsC;YACtC,oDAAoD;YACpD,KAAK;YACL,EAAE;YACF,wCAAwC;YACxC,SAAS;YACT,2EAA2E;YAC3E,oBAAoB;YACpB,KAAK;YACL,0EAA0E;YAC1E,qDAAqD;YACrD,mEAAmE;YACnE,EAAE;YACF,mCAAmC;YACnC,SAAS;YACT,gEAAgE;YAChE,KAAK;YACL,yCAAyC;YACzC,4EAA4E;YAC5E,mEAAmE;YACnE,gEAAgE;YAChE,EAAE;YACF,uGAAuG;SACxG,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC"}

package/dist/engine/doc-generator/mobile-distribution-guide.d.ts

@@ -0,0 +1,7 @@
+import type { GeneratedDocument, ProjectKnowledge, Spec } from '../../types/index.js';
+/**
+ * Generates a developer-facing mobile distribution guide.
+ * Covers iOS TestFlight, Google Play Internal Testing, EAS Build/Submit, and Flutter commands.
+ */
+export declare function generateMobileDistributionGuide(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+//# sourceMappingURL=mobile-distribution-guide.d.ts.map

package/dist/engine/doc-generator/mobile-distribution-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-distribution-guide.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/mobile-distribution-guide.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EAEjB,gBAAgB,EAChB,IAAI,EAEL,MAAM,sBAAsB,CAAC;AAoQ9B;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CA4DnB"}

package/dist/engine/doc-generator/mobile-distribution-guide.js

@@ -0,0 +1,288 @@
+// engine/doc-generator/mobile-distribution-guide.ts — SPEC-013 tech-debt criterion 15
+// Orchestrator: assembles the mobile distribution guide from platform-specific builders.
+// SRP: detection + assembly only. Platform content lives in sibling modules.
+import { buildIOSDistributionSection } from './mobile-distribution-ios.js';
+import { buildAndroidDistributionSection } from './mobile-distribution-android.js';
+// --- Platform detection helpers ---
+function detectFromApps(knowledge, platforms) {
+    for (const app of knowledge.apps) {
+        if (app.mobilePlatform === 'ios') {
+            platforms.add('ios');
+        }
+        if (app.mobilePlatform === 'android') {
+            platforms.add('android');
+        }
+        if (app.mobileFramework === 'flutter') {
+            platforms.add('flutter');
+        }
+        if (app.mobileFramework === 'react-native') {
+            platforms.add('react-native');
+        }
+    }
+}
+function detectFromFramework(knowledge, platforms) {
+    const fw = (knowledge.framework ?? '').toLowerCase();
+    if (fw.includes('flutter')) {
+        platforms.add('flutter');
+    }
+    if (fw.includes('react-native') || fw.includes('reactnative')) {
+        platforms.add('react-native');
+    }
+    if (fw.includes('expo')) {
+        platforms.add('expo');
+        platforms.add('react-native');
+    }
+}
+function detectFromStack(knowledge, platforms) {
+    for (const tech of knowledge.stack) {
+        const lower = tech.toLowerCase();
+        if (lower === 'flutter') {
+            platforms.add('flutter');
+        }
+        if (lower === 'react-native') {
+            platforms.add('react-native');
+        }
+        if (lower === 'expo') {
+            platforms.add('expo');
+        }
+    }
+}
+function detectFromSpecs(specs, platforms) {
+    for (const spec of specs) {
+        if (spec.target === 'ios') {
+            platforms.add('ios');
+        }
+        if (spec.target === 'android') {
+            platforms.add('android');
+        }
+        const tags = spec.tags.join(' ').toLowerCase();
+        if (tags.includes('flutter')) {
+            platforms.add('flutter');
+        }
+        if (tags.includes('react-native') || tags.includes('expo')) {
+            platforms.add('react-native');
+        }
+    }
+}
+function detectMobilePlatforms(knowledge, specs) {
+    const platforms = new Set();
+    detectFromApps(knowledge, platforms);
+    detectFromFramework(knowledge, platforms);
+    detectFromStack(knowledge, platforms);
+    detectFromSpecs(specs, platforms);
+    return Array.from(platforms);
+}
+// --- Cross-platform section builders (Flutter / React Native / Expo / Bare RN) ---
+function buildFlutterDistributionSection() {
+    return {
+        title: 'Flutter — Multi-Platform Build & Submit',
+        level: 2,
+        content: [
+            '### iOS Build',
+            '```bash',
+            'flutter build ipa --release',
+            '# Output: build/ios/ipa/MyApp.ipa',
+            '# Then follow iOS → TestFlight steps below',
+            '```',
+            '',
+            '### Android Build',
+            '```bash',
+            'flutter build appbundle --release',
+            '# Output: build/app/outputs/bundle/release/app-release.aab',
+            '# Then follow Android → Google Play steps below',
+            'flutter build apk --release  # for direct APK distribution',
+            '```',
+            '',
+            '### CI/CD with Fastlane + Flutter',
+            '```bash',
+            'lane :deploy_ios do',
+            '  sh "flutter build ipa --release"',
+            '  pilot(ipa: "build/ios/ipa/MyApp.ipa")',
+            'end',
+            'lane :deploy_android do',
+            '  sh "flutter build appbundle --release"',
+            '  supply(aab: "build/app/outputs/bundle/release/app-release.aab", track: "internal")',
+            'end',
+            '```',
+            '',
+            '> **Verification:** `flutter build` exits 0. No deprecated APIs in `flutter analyze`.',
+        ].join('\n'),
+    };
+}
+function buildExpoDistributionSection() {
+    return {
+        title: 'React Native (Expo EAS) — Build & Submit',
+        level: 2,
+        content: [
+            '### Setup EAS CLI',
+            '```bash',
+            'npm install -g eas-cli',
+            'eas login',
+            'eas build:configure  # creates eas.json',
+            '```',
+            '',
+            '### Build with EAS Build',
+            '```bash',
+            'eas build --platform ios --profile production',
+            'eas build --platform android --profile production',
+            'eas build --platform all --profile production',
+            '```',
+            '',
+            '### Submit with EAS Submit',
+            '```bash',
+            'eas submit --platform ios    # → TestFlight',
+            'eas submit --platform android  # → Google Play internal track',
+            'eas submit --platform all',
+            '```',
+            '',
+            '### OTA Updates with EAS Update',
+            '```bash',
+            'eas update --branch production --message "Hotfix: fix login flow"',
+            '```',
+            '',
+            '### eas.json example',
+            '```json',
+            '{',
+            '  "build": {',
+            '    "production": {',
+            '      "ios": { "buildType": "appstore" },',
+            '      "android": { "buildType": "app-bundle" }',
+            '    }',
+            '  }',
+            '}',
+            '```',
+            '',
+            '> **Verification:** EAS Build shows "Finished". EAS Submit shows "Submitted".',
+        ].join('\n'),
+    };
+}
+function buildBareReactNativeDistributionSection() {
+    return {
+        title: 'React Native (Bare Workflow) — Build & Submit',
+        level: 2,
+        content: [
+            '### iOS Build',
+            '```bash',
+            'cd ios && pod install && cd ..',
+            'xcodebuild -workspace ios/MyApp.xcworkspace -scheme MyApp \\',
+            '  -configuration Release -archivePath build/MyApp.xcarchive archive',
+            '# Or via Fastlane:',
+            'fastlane gym --workspace ios/MyApp.xcworkspace --scheme MyApp',
+            '```',
+            '',
+            '### Android Build',
+            '```bash',
+            'cd android && ./gradlew bundleRelease',
+            '# Output: android/app/build/outputs/bundle/release/app-release.aab',
+            '```',
+            '',
+            '### Submit',
+            '- iOS: `fastlane pilot upload` or Transporter.app',
+            '- Android: `fastlane supply` or Play Console manually',
+            '',
+            '### Metro bundler release check',
+            '```bash',
+            'react-native bundle --platform ios --dev false \\',
+            '  --entry-file index.js --bundle-output ios/main.jsbundle',
+            '```',
+            '',
+            '> **Verification:** Release build launches without Metro bundler. No yellow-box warnings.',
+        ].join('\n'),
+    };
+}
+function buildReactNativeDistributionSection(isExpo) {
+    if (isExpo) {
+        return buildExpoDistributionSection();
+    }
+    return buildBareReactNativeDistributionSection();
+}
+function buildPhasedRolloutSection() {
+    return {
+        title: 'Phased Rollout Strategy',
+        level: 2,
+        content: [
+            '| Day | iOS (Phased Release) | Android (Play Console) |',
+            '|-----|---------------------|------------------------|',
+            '| 1   | 1% of users         | 1% rollout             |',
+            '| 2   | 2%                  | 5%                     |',
+            '| 3   | 5%                  | 10%                    |',
+            '| 4   | 10%                 | 20%                    |',
+            '| 5   | 20%                 | 50%                    |',
+            '| 6   | 50%                 | 100%                   |',
+            '| 7   | 100%                | (monitor)              |',
+            '',
+            '**Halt criteria:** Crash-free rate drops below 99.5% OR critical issues exceed 0.1%.',
+            '',
+            '**Rollback procedure:**',
+            '- iOS: halt phased release in App Store Connect',
+            '- Android: halt rollout in Play Console, push fix via expedited review',
+        ].join('\n'),
+    };
+}
+function addStoreSectionsIfMissing(platforms, sections) {
+    const isCrossPlatform = platforms.includes('flutter') ||
+        platforms.includes('react-native') ||
+        platforms.includes('expo');
+    if (isCrossPlatform) {
+        if (!sections.some((s) => s.title.includes('TestFlight'))) {
+            sections.push(buildIOSDistributionSection());
+        }
+        if (!sections.some((s) => s.title.includes('Google Play'))) {
+            sections.push(buildAndroidDistributionSection());
+        }
+    }
+}
+// --- Main generator ---
+/**
+ * Generates a developer-facing mobile distribution guide.
+ * Covers iOS TestFlight, Google Play Internal Testing, EAS Build/Submit, and Flutter commands.
+ */
+export function generateMobileDistributionGuide(knowledge, specs, _language) {
+    const platforms = detectMobilePlatforms(knowledge, specs);
+    const sections = [];
+    const isExpo = platforms.includes('expo') || knowledge.stack.some((t) => t.toLowerCase() === 'expo');
+    sections.push({
+        title: 'Mobile Distribution Guide',
+        level: 1,
+        content: [
+            'This guide covers the full distribution pipeline for mobile applications:',
+            'build signing, beta testing, store submission, and phased rollout.',
+            '',
+            `**Detected platforms:** ${platforms.length > 0 ? platforms.join(', ') : 'none detected — configure manually'}`,
+        ].join('\n'),
+    });
+    if (platforms.includes('flutter')) {
+        sections.push(buildFlutterDistributionSection());
+    }
+    if (platforms.includes('react-native') || platforms.includes('expo')) {
+        sections.push(buildReactNativeDistributionSection(isExpo));
+    }
+    if (platforms.includes('ios') &&
+        !platforms.includes('flutter') &&
+        !platforms.includes('react-native')) {
+        sections.push(buildIOSDistributionSection());
+    }
+    if (platforms.includes('android') &&
+        !platforms.includes('flutter') &&
+        !platforms.includes('react-native')) {
+        sections.push(buildAndroidDistributionSection());
+    }
+    addStoreSectionsIfMissing(platforms, sections);
+    sections.push(buildPhasedRolloutSection());
+    const content = sections
+        .map((s) => `${'#'.repeat(s.level)} ${s.title}\n\n${s.content}`)
+        .join('\n\n');
+    return {
+        type: 'mobile-distribution-guide',
+        title: 'Mobile Distribution Guide',
+        path: 'docs/mobile-distribution.md',
+        content,
+        audience: 'developer',
+        sections,
+        diagrams: [],
+        relatedSpecs: specs
+            .filter((s) => s.target === 'ios' || s.target === 'android')
+            .map((s) => s.id),
+    };
+}
+//# sourceMappingURL=mobile-distribution-guide.js.map

package/dist/engine/doc-generator/mobile-distribution-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-distribution-guide.js","sourceRoot":"","sources":["../../../src/engine/doc-generator/mobile-distribution-guide.ts"],"names":[],"mappings":"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"}

package/dist/engine/doc-generator/mobile-distribution-ios.d.ts

@@ -0,0 +1,6 @@
+import type { DocSection } from '../../types/index.js';
+/**
+ * Builds the iOS TestFlight & App Store submission section.
+ */
+export declare function buildIOSDistributionSection(): DocSection;
+//# sourceMappingURL=mobile-distribution-ios.d.ts.map

package/dist/engine/doc-generator/mobile-distribution-ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-distribution-ios.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/mobile-distribution-ios.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,UAAU,CAkDxD"}

package/dist/engine/doc-generator/mobile-distribution-ios.js

@@ -0,0 +1,58 @@
+// engine/doc-generator/mobile-distribution-ios.ts — SPEC-013 tech-debt criterion 15
+// iOS/TestFlight distribution section builder.
+// SRP: one responsibility — generate iOS store submission steps.
+/**
+ * Builds the iOS TestFlight & App Store submission section.
+ */
+export function buildIOSDistributionSection() {
+    return {
+        title: 'iOS — TestFlight & App Store Submission',
+        level: 2,
+        content: [
+            '### Prerequisites',
+            '- Active Apple Developer Program membership ($99/year)',
+            '- App ID registered in App Store Connect',
+            '- Distribution certificate and provisioning profile configured',
+            '',
+            '### Step 1: Build signed IPA',
+            '```bash',
+            '# Via Fastlane (recommended)',
+            'fastlane gym --scheme MyApp --export_method app-store',
+            '',
+            '# Via Xcode CLI',
+            'xcodebuild -project MyApp.xcodeproj -scheme MyApp \\',
+            '  -archivePath build/MyApp.xcarchive archive',
+            'xcodebuild -exportArchive -archivePath build/MyApp.xcarchive \\',
+            '  -exportOptionsPlist ExportOptions.plist \\',
+            '  -exportPath build/ipa',
+            '```',
+            '',
+            '### Step 2: Upload to TestFlight (internal testing)',
+            '```bash',
+            '# Via Fastlane pilot',
+            'fastlane pilot upload --ipa build/ipa/MyApp.ipa',
+            '',
+            '# Via xcrun altool',
+            'xcrun altool --upload-app --type ios \\',
+            '  --file build/ipa/MyApp.ipa \\',
+            '  --apiKey <API_KEY> --apiIssuer <ISSUER_ID>',
+            '```',
+            '- Go to App Store Connect → TestFlight → Invite internal testers',
+            '- Internal testers receive email; install via TestFlight app',
+            '- External testing requires beta review (1-3 business days)',
+            '',
+            '### Step 3: Submit to App Store',
+            '```bash',
+            '# Via Fastlane deliver',
+            'fastlane deliver --force',
+            '```',
+            '- Complete in App Store Connect: screenshots, App Privacy, Export Compliance',
+            '- Add `PrivacyInfo.xcprivacy` if using required APIs',
+            '- Submit for review — typical wait: 1-3 business days',
+            '- Phased rollout: go to Pricing & Availability → Phased Release (7-day rollout)',
+            '',
+            '> **Verification:** Build appears in TestFlight. App Store Connect shows "In Review".',
+        ].join('\n'),
+    };
+}
+//# sourceMappingURL=mobile-distribution-ios.js.map

package/dist/engine/doc-generator/mobile-distribution-ios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-distribution-ios.js","sourceRoot":"","sources":["../../../src/engine/doc-generator/mobile-distribution-ios.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,+CAA+C;AAC/C,iEAAiE;AAIjE;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,KAAK,EAAE,yCAAyC;QAChD,KAAK,EAAE,CAAC;QACR,OAAO,EAAE;YACP,mBAAmB;YACnB,wDAAwD;YACxD,0CAA0C;YAC1C,gEAAgE;YAChE,EAAE;YACF,8BAA8B;YAC9B,SAAS;YACT,8BAA8B;YAC9B,uDAAuD;YACvD,EAAE;YACF,iBAAiB;YACjB,sDAAsD;YACtD,8CAA8C;YAC9C,iEAAiE;YACjE,8CAA8C;YAC9C,yBAAyB;YACzB,KAAK;YACL,EAAE;YACF,qDAAqD;YACrD,SAAS;YACT,sBAAsB;YACtB,iDAAiD;YACjD,EAAE;YACF,oBAAoB;YACpB,yCAAyC;YACzC,iCAAiC;YACjC,8CAA8C;YAC9C,KAAK;YACL,kEAAkE;YAClE,8DAA8D;YAC9D,6DAA6D;YAC7D,EAAE;YACF,iCAAiC;YACjC,SAAS;YACT,wBAAwB;YACxB,0BAA0B;YAC1B,KAAK;YACL,8EAA8E;YAC9E,sDAAsD;YACtD,uDAAuD;YACvD,iFAAiF;YACjF,EAAE;YACF,uFAAuF;SACxF,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC"}