raptor-aios 0.1.0

package/dist/_core/dist/verify/a11y.js

@@ -0,0 +1,153 @@
+/**
+ * Accessibility verification — STATIC analysis of UI source.
+ *
+ * This is the "verification edge" for M3: instead of only trusting the
+ * `a11y` declaration in spec.md frontmatter, this actually scans the rendered
+ * UI source and flags interactive elements that are not screen-reader
+ * operable. Framework focus: React Native (Pressable/Touchable/Button,
+ * Image, TextInput), but the heuristics are plain JSX so they generalize.
+ *
+ * Heuristic, not a full AST: it captures each opening tag's prop block (up to
+ * the first `>`) and checks for accessibility props. Good enough for a lint;
+ * it never executes code.
+ */
+const INTERACTIVE = [
+    "Pressable",
+    "TouchableOpacity",
+    "TouchableHighlight",
+    "TouchableWithoutFeedback",
+    "TouchableNativeFeedback",
+];
+function hasA11yLabelOrRole(props) {
+    return /\baccessibilityLabel\b|\baccessibilityRole\b|\baccessibilityLabelledBy\b|\baria-label\b/.test(props);
+}
+function isHiddenFromA11y(props) {
+    return (/\baccessibilityElementsHidden\b/.test(props) ||
+        /importantForAccessibility\s*=\s*["'{]?\s*no/.test(props) ||
+        /\baccessible\s*=\s*\{?\s*false\b/.test(props));
+}
+/**
+ * Extract a JSX opening tag's prop block starting right after the tag name.
+ * Scans to the `>` that closes the tag at bracket-depth 0, so `=>` arrow
+ * functions, JSX expressions and `>` inside `{}`/`()`/`[]`/strings don't end
+ * the tag prematurely. Returns null if no closing `>` is found.
+ */
+function extractTagProps(content, from) {
+    let curly = 0;
+    let paren = 0;
+    let brack = 0;
+    let str = null;
+    for (let i = from; i < content.length; i++) {
+        const c = content[i];
+        if (str) {
+            if (c === str && content[i - 1] !== "\\")
+                str = null;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === "`") {
+            str = c;
+        }
+        else if (c === "{")
+            curly++;
+        else if (c === "}")
+            curly--;
+        else if (c === "(")
+            paren++;
+        else if (c === ")")
+            paren--;
+        else if (c === "[")
+            brack++;
+        else if (c === "]")
+            brack--;
+        else if (c === ">" && curly === 0 && paren === 0 && brack === 0) {
+            return content.slice(from, i);
+        }
+    }
+    return null;
+}
+function lineOf(content, index) {
+    let line = 1;
+    for (let i = 0; i < index && i < content.length; i++) {
+        if (content[i] === "\n")
+            line++;
+    }
+    return line;
+}
+/** Scan a single source file's content for a11y violations. */
+export function scanA11ySource(file, content) {
+    const findings = [];
+    const emit = (rule, severity, element, index, message) => {
+        findings.push({ rule, severity, file, line: lineOf(content, index), element, message });
+    };
+    const scanTag = (tag, onMatch) => {
+        const re = new RegExp(`<${tag}\\b`, "g");
+        let m;
+        while ((m = re.exec(content)) !== null) {
+            const props = extractTagProps(content, re.lastIndex);
+            if (props !== null)
+                onMatch(props, m.index);
+        }
+    };
+    // A11Y-INTERACTIVE: touchables without a label/role and not hidden.
+    // A11Y-TOUCH-TARGET: inline size below the 44dp minimum (M3 refinement).
+    for (const tag of INTERACTIVE) {
+        scanTag(tag, (props, idx) => {
+            if (isHiddenFromA11y(props))
+                return;
+            if (!hasA11yLabelOrRole(props)) {
+                emit("A11Y-INTERACTIVE", "error", tag, idx, `<${tag}> is interactive but has no accessibilityLabel/accessibilityRole — not screen-reader operable.`);
+            }
+            const w = props.match(/\bwidth:\s*(\d+)/);
+            const h = props.match(/\bheight:\s*(\d+)/);
+            if (w && h && (Number(w[1]) < 44 || Number(h[1]) < 44)) {
+                emit("A11Y-TOUCH-TARGET", "warning", tag, idx, `<${tag}> inline size ${w[1]}x${h[1]}dp is below the 44dp minimum touch target.`);
+            }
+        });
+    }
+    // A11Y-FONT-SCALING: disabling font scaling breaks Dynamic Type (M3 refinement).
+    for (const tag of ["Text", "TextInput"]) {
+        scanTag(tag, (props, idx) => {
+            if (/\ballowFontScaling\s*=\s*\{?\s*false\b/.test(props)) {
+                emit("A11Y-FONT-SCALING", "warning", tag, idx, `<${tag}> sets allowFontScaling={false} — text won't scale with the user's font size.`);
+            }
+        });
+    }
+    // A11Y-BUTTON: <Button> needs a title (its accessible name) or a label.
+    scanTag("Button", (props, idx) => {
+        if (isHiddenFromA11y(props))
+            return;
+        if (!hasA11yLabelOrRole(props) && !/\btitle\s*=/.test(props)) {
+            emit("A11Y-BUTTON", "error", "Button", idx, "<Button> has no title or accessibilityLabel — no accessible name.");
+        }
+    });
+    // A11Y-IMAGE: images that carry content need a label (or be explicitly hidden).
+    scanTag("Image", (props, idx) => {
+        if (isHiddenFromA11y(props))
+            return;
+        if (!/\bsource\s*=/.test(props))
+            return; // decorative/no-source: skip
+        if (!hasA11yLabelOrRole(props)) {
+            emit("A11Y-IMAGE", "warning", "Image", idx, "<Image> has a source but no accessibilityLabel — screen readers announce nothing (or hide it explicitly).");
+        }
+    });
+    // A11Y-INPUT: text inputs need a label (placeholder is not a label).
+    scanTag("TextInput", (props, idx) => {
+        if (isHiddenFromA11y(props))
+            return;
+        if (!hasA11yLabelOrRole(props)) {
+            emit("A11Y-INPUT", "warning", "TextInput", idx, "<TextInput> has no accessibilityLabel — a placeholder is not an accessible label.");
+        }
+    });
+    return findings;
+}
+/** Aggregate a scan across multiple files. */
+export function scanA11yFiles(files) {
+    const findings = files.flatMap((f) => scanA11ySource(f.path, f.content));
+    return {
+        filesScanned: files.length,
+        findings,
+        errors: findings.filter((f) => f.severity === "error").length,
+        warnings: findings.filter((f) => f.severity === "warning").length,
+    };
+}
+//# sourceMappingURL=a11y.js.map

package/dist/_core/dist/verify/a11y.js.map

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

package/dist/_core/dist/verify/architecture.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Clean-architecture verification (M8 — radar/experimental) — STATIC analysis
+ * of the import graph to enforce mobile layering:
+ *
+ *  - domain purity: files under `domain/` must not import react/react-native/UI.
+ *  - layer direction: domain ⟶ (nothing); data ⟶ domain only; presentation ⟶
+ *    domain/data. So `domain/` importing data/presentation/components/screens is
+ *    a violation; `data/` importing presentation/components/screens is too.
+ *  - no cross-feature imports: `features/A/**` must not import `features/B/**`.
+ *
+ * Pure: takes {path, content} and returns findings. Heuristic (path-segment +
+ * import-string based), never executes code. Rules only fire when a project
+ * actually uses these folder conventions.
+ */
+export interface ArchFinding {
+    rule: string;
+    severity: "error" | "warning";
+    file: string;
+    line: number;
+    importPath: string;
+    message: string;
+}
+/** Extract module specifiers from import/export-from/require statements. */
+export declare function extractImports(content: string): Array<{
+    spec: string;
+    index: number;
+}>;
+export interface ArchReport {
+    filesScanned: number;
+    findings: ArchFinding[];
+    errors: number;
+}
+export declare function analyzeArchitecture(files: Array<{
+    path: string;
+    content: string;
+}>): ArchReport;
+//# sourceMappingURL=architecture.d.ts.map

package/dist/_core/dist/verify/architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../src/verify/architecture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAoBD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAatF;AAQD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,UAAU,CAkEZ"}

package/dist/_core/dist/verify/architecture.js

@@ -0,0 +1,113 @@
+/**
+ * Clean-architecture verification (M8 — radar/experimental) — STATIC analysis
+ * of the import graph to enforce mobile layering:
+ *
+ *  - domain purity: files under `domain/` must not import react/react-native/UI.
+ *  - layer direction: domain ⟶ (nothing); data ⟶ domain only; presentation ⟶
+ *    domain/data. So `domain/` importing data/presentation/components/screens is
+ *    a violation; `data/` importing presentation/components/screens is too.
+ *  - no cross-feature imports: `features/A/**` must not import `features/B/**`.
+ *
+ * Pure: takes {path, content} and returns findings. Heuristic (path-segment +
+ * import-string based), never executes code. Rules only fire when a project
+ * actually uses these folder conventions.
+ */
+const UI_IMPORTS = /^(react|react-native)(\/|$)/;
+const LAYER_KEYWORDS = ["domain", "data", "presentation", "components", "screens"];
+function segments(p) {
+    return p.split(/[\\/]/).filter(Boolean);
+}
+function layerOf(path) {
+    const segs = segments(path);
+    return LAYER_KEYWORDS.find((k) => segs.includes(k));
+}
+function featureOf(path) {
+    const m = path.match(/(?:^|[\\/])features[\\/]([^\\/]+)[\\/]/);
+    return m ? m[1] : undefined;
+}
+/** Extract module specifiers from import/export-from/require statements. */
+export function extractImports(content) {
+    const out = [];
+    const patterns = [
+        /\bimport\b[^'"`]*?from\s*['"]([^'"]+)['"]/g,
+        /\bimport\s*['"]([^'"]+)['"]/g,
+        /\bexport\b[^'"`]*?from\s*['"]([^'"]+)['"]/g,
+        /\brequire\(\s*['"]([^'"]+)['"]\s*\)/g,
+    ];
+    for (const re of patterns) {
+        let m;
+        while ((m = re.exec(content)) !== null)
+            out.push({ spec: m[1], index: m.index });
+    }
+    return out;
+}
+function lineOf(content, index) {
+    let line = 1;
+    for (let i = 0; i < index && i < content.length; i++)
+        if (content[i] === "\n")
+            line++;
+    return line;
+}
+export function analyzeArchitecture(files) {
+    const findings = [];
+    for (const { path, content } of files) {
+        const fileLayer = layerOf(path);
+        const fileFeature = featureOf(path);
+        for (const { spec, index } of extractImports(content)) {
+            const line = lineOf(content, index);
+            const importLayer = layerOf(spec);
+            const importFeature = featureOf(spec);
+            // 1. domain purity
+            if (fileLayer === "domain" && UI_IMPORTS.test(spec)) {
+                findings.push({
+                    rule: "ARCH-DOMAIN-PURITY",
+                    severity: "error",
+                    file: path,
+                    line,
+                    importPath: spec,
+                    message: `domain/ must stay UI-free but imports "${spec}".`,
+                });
+            }
+            // 2. layer direction
+            const forbiddenForDomain = ["data", "presentation", "components", "screens"];
+            const forbiddenForData = ["presentation", "components", "screens"];
+            if (fileLayer === "domain" && importLayer && forbiddenForDomain.includes(importLayer)) {
+                findings.push({
+                    rule: "ARCH-LAYER-DIRECTION",
+                    severity: "error",
+                    file: path,
+                    line,
+                    importPath: spec,
+                    message: `domain/ must not depend on ${importLayer}/ (inner layer importing outer).`,
+                });
+            }
+            else if (fileLayer === "data" && importLayer && forbiddenForData.includes(importLayer)) {
+                findings.push({
+                    rule: "ARCH-LAYER-DIRECTION",
+                    severity: "error",
+                    file: path,
+                    line,
+                    importPath: spec,
+                    message: `data/ must not depend on ${importLayer}/ (wrong dependency direction).`,
+                });
+            }
+            // 3. no cross-feature imports
+            if (fileFeature && importFeature && fileFeature !== importFeature) {
+                findings.push({
+                    rule: "ARCH-CROSS-FEATURE",
+                    severity: "error",
+                    file: path,
+                    line,
+                    importPath: spec,
+                    message: `feature "${fileFeature}" imports feature "${importFeature}" — features must be independent.`,
+                });
+            }
+        }
+    }
+    return {
+        filesScanned: files.length,
+        findings,
+        errors: findings.filter((f) => f.severity === "error").length,
+    };
+}
+//# sourceMappingURL=architecture.js.map

package/dist/_core/dist/verify/architecture.js.map

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

package/dist/_core/dist/verify/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Verification edge — actually measure the app against its declared
+ * mobile budgets/criteria (a11y, perf), complementing the declarative gates.
+ */
+export { type A11ySeverity, type A11yFinding, type A11yReport, scanA11ySource, scanA11yFiles, } from "./a11y.js";
+export { type AmStartTimings, type PerfEvaluation, parseAmStartOutput, evaluatePerf, median, parseHermesEnabled, } from "./perf.js";
+export { type OsMatrixCheck, type OsMatrixEvaluation, androidVersionToApi, androidApiToVersion, parseAndroidMinSdk, parseIosDeploymentTarget, evaluateOsMatrix, } from "./os-matrix.js";
+export { type StoreCheck, type StoresEvaluation, extractAndroidPermission, extractIosUsageKey, parseManifestPermissions, parseInfoPlistKeys, evaluateStores, } from "./stores.js";
+export { type ArchFinding, type ArchReport, extractImports, analyzeArchitecture, } from "./architecture.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/_core/dist/verify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,cAAc,EACd,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/_core/dist/verify/index.js

@@ -0,0 +1,10 @@
+/**
+ * Verification edge — actually measure the app against its declared
+ * mobile budgets/criteria (a11y, perf), complementing the declarative gates.
+ */
+export { scanA11ySource, scanA11yFiles, } from "./a11y.js";
+export { parseAmStartOutput, evaluatePerf, median, parseHermesEnabled, } from "./perf.js";
+export { androidVersionToApi, androidApiToVersion, parseAndroidMinSdk, parseIosDeploymentTarget, evaluateOsMatrix, } from "./os-matrix.js";
+export { extractAndroidPermission, extractIosUsageKey, parseManifestPermissions, parseInfoPlistKeys, evaluateStores, } from "./stores.js";
+export { extractImports, analyzeArchitecture, } from "./architecture.js";
+//# sourceMappingURL=index.js.map

package/dist/_core/dist/verify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,cAAc,EACd,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EAGL,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAGL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGL,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,cAAc,EACd,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/_core/dist/verify/os-matrix.d.ts

@@ -0,0 +1,35 @@
+/**
+ * OS support matrix verification (M4) — measure the DECLARED os_matrix
+ * (plan.md frontmatter) against the REAL native config of a React Native CLI
+ * project: Android `minSdkVersion` (android/build.gradle) and the iOS
+ * deployment target (xcodeproj `IPHONEOS_DEPLOYMENT_TARGET`, Podfile fallback).
+ *
+ * Pure functions (take file content) so the logic is testable; the CLI reads
+ * the files and may apply `--fix`.
+ */
+/** Resolve a declared Android min ("7.0" or an API number "24") to an API level. */
+export declare function androidVersionToApi(value: string): number | undefined;
+export declare function androidApiToVersion(api: number): string;
+/** Parse `minSdkVersion = N` (or `minSdkVersion N`) from a build.gradle. */
+export declare function parseAndroidMinSdk(gradle: string): number | undefined;
+/** Parse the iOS deployment target from a pbxproj or a Podfile literal. */
+export declare function parseIosDeploymentTarget(content: string): string | undefined;
+export interface OsMatrixCheck {
+    platform: "android" | "ios";
+    declared: string;
+    native: string;
+    status: "match" | "mismatch" | "missing";
+    detail: string;
+}
+export interface OsMatrixEvaluation {
+    checks: OsMatrixCheck[];
+    ok: boolean;
+}
+export declare function evaluateOsMatrix(declared: {
+    ios_min?: string;
+    android_min?: string;
+}, native: {
+    androidMinSdk?: number;
+    iosTarget?: string;
+}): OsMatrixEvaluation;
+//# sourceMappingURL=os-matrix.d.ts.map

package/dist/_core/dist/verify/os-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-matrix.d.ts","sourceRoot":"","sources":["../../src/verify/os-matrix.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5E;AAOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,MAAM,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,kBAAkB,CAqDpB"}

package/dist/_core/dist/verify/os-matrix.js

@@ -0,0 +1,104 @@
+/**
+ * OS support matrix verification (M4) — measure the DECLARED os_matrix
+ * (plan.md frontmatter) against the REAL native config of a React Native CLI
+ * project: Android `minSdkVersion` (android/build.gradle) and the iOS
+ * deployment target (xcodeproj `IPHONEOS_DEPLOYMENT_TARGET`, Podfile fallback).
+ *
+ * Pure functions (take file content) so the logic is testable; the CLI reads
+ * the files and may apply `--fix`.
+ */
+/** Android marketing version → API level. */
+const ANDROID_API_BY_VERSION = {
+    "5.0": 21, "5.1": 22, "6.0": 23, "7.0": 24, "7.1": 25, "8.0": 26, "8.1": 27,
+    "9": 28, "9.0": 28, "10": 29, "11": 30, "12": 31, "12L": 32, "13": 33,
+    "14": 34, "15": 35, "16": 36,
+};
+/** Resolve a declared Android min ("7.0" or an API number "24") to an API level. */
+export function androidVersionToApi(value) {
+    const v = value.trim();
+    if (ANDROID_API_BY_VERSION[v] !== undefined)
+        return ANDROID_API_BY_VERSION[v];
+    if (/^\d+$/.test(v)) {
+        const n = Number(v);
+        if (n >= 21)
+            return n; // already an API level
+    }
+    return undefined;
+}
+export function androidApiToVersion(api) {
+    const found = Object.entries(ANDROID_API_BY_VERSION).find(([, a]) => a === api);
+    return found ? found[0] : `API ${api}`;
+}
+/** Parse `minSdkVersion = N` (or `minSdkVersion N`) from a build.gradle. */
+export function parseAndroidMinSdk(gradle) {
+    const m = gradle.match(/minSdkVersion\s*=?\s*(\d+)/);
+    return m ? Number(m[1]) : undefined;
+}
+/** Parse the iOS deployment target from a pbxproj or a Podfile literal. */
+export function parseIosDeploymentTarget(content) {
+    const pb = content.match(/IPHONEOS_DEPLOYMENT_TARGET\s*=\s*([0-9.]+)/);
+    if (pb)
+        return pb[1];
+    const pod = content.match(/platform\s+:ios,\s*['"]([0-9.]+)['"]/);
+    if (pod)
+        return pod[1];
+    return undefined;
+}
+function normIos(v) {
+    // "15.1" and "15.10" stay distinct; trim trailing ".0" so "15.0" == "15".
+    return v.trim().replace(/\.0+$/, "");
+}
+export function evaluateOsMatrix(declared, native) {
+    const checks = [];
+    // Android
+    if (declared.android_min !== undefined) {
+        const declApi = androidVersionToApi(String(declared.android_min));
+        if (native.androidMinSdk === undefined) {
+            checks.push({
+                platform: "android",
+                declared: `${declared.android_min} (API ${declApi ?? "?"})`,
+                native: "(not found)",
+                status: "missing",
+                detail: "Could not read minSdkVersion from android/build.gradle.",
+            });
+        }
+        else {
+            const match = declApi === native.androidMinSdk;
+            checks.push({
+                platform: "android",
+                declared: `${declared.android_min} (API ${declApi ?? "?"})`,
+                native: `API ${native.androidMinSdk} (${androidApiToVersion(native.androidMinSdk)})`,
+                status: match ? "match" : "mismatch",
+                detail: match
+                    ? "Declared android_min matches the native minSdkVersion."
+                    : `Declared API ${declApi} but native minSdkVersion is ${native.androidMinSdk}.`,
+            });
+        }
+    }
+    // iOS
+    if (declared.ios_min !== undefined) {
+        if (native.iosTarget === undefined) {
+            checks.push({
+                platform: "ios",
+                declared: declared.ios_min,
+                native: "(not found)",
+                status: "missing",
+                detail: "Could not read IPHONEOS_DEPLOYMENT_TARGET (xcodeproj/Podfile).",
+            });
+        }
+        else {
+            const match = normIos(String(declared.ios_min)) === normIos(native.iosTarget);
+            checks.push({
+                platform: "ios",
+                declared: String(declared.ios_min),
+                native: native.iosTarget,
+                status: match ? "match" : "mismatch",
+                detail: match
+                    ? "Declared ios_min matches the native deployment target."
+                    : `Declared ${declared.ios_min} but native target is ${native.iosTarget}.`,
+            });
+        }
+    }
+    return { checks, ok: checks.every((c) => c.status === "match") };
+}
+//# sourceMappingURL=os-matrix.js.map

package/dist/_core/dist/verify/os-matrix.js.map

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

package/dist/_core/dist/verify/perf.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Performance verification — measure the running app, don't just declare it.
+ *
+ * This is the "verification edge" for M5: instead of only trusting
+ * `perf_budget.ttfi_ms` in plan.md, this measures the real cold-start of the
+ * installed app on a device/emulator (Android `am start -W`) and compares it
+ * to the declared budget.
+ *
+ * This module is the PURE part (parsing + evaluation); the adb invocation
+ * lives in the CLI so the logic stays testable.
+ */
+export interface AmStartTimings {
+    /** Total time to fully drawn / displayed, ms. */
+    totalTimeMs?: number;
+    /** Wait time reported by the activity manager, ms. */
+    waitTimeMs?: number;
+}
+/**
+ * Parse the output of `adb shell am start -W <pkg>/<activity>`.
+ * Looks for `TotalTime:` and `WaitTime:` lines.
+ */
+export declare function parseAmStartOutput(output: string): AmStartTimings;
+export interface PerfEvaluation {
+    measuredMs: number;
+    budgetMs: number;
+    pass: boolean;
+    marginMs: number;
+    message: string;
+}
+/**
+ * Compare a measured cold-start against the declared TTFI budget.
+ * `measuredMs` is the best available signal (prefer TotalTime, else WaitTime).
+ */
+export declare function evaluatePerf(timings: AmStartTimings, budgetMs: number): PerfEvaluation | null;
+/**
+ * Whether Hermes is enabled (Android `gradle.properties` `hermesEnabled=true`).
+ * Hermes materially affects JS startup/TTFI, so it is part of the M5 picture.
+ * Returns undefined when the flag isn't present.
+ */
+export declare function parseHermesEnabled(gradleProperties: string): boolean | undefined;
+/** Median of a list of samples (for multi-run measurement). */
+export declare function median(samples: number[]): number;
+//# sourceMappingURL=perf.d.ts.map

package/dist/_core/dist/verify/perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../../src/verify/perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAWjE;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,cAAc,GAAG,IAAI,CAcvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAGhF;AAED,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAOhD"}

package/dist/_core/dist/verify/perf.js

@@ -0,0 +1,69 @@
+/**
+ * Performance verification — measure the running app, don't just declare it.
+ *
+ * This is the "verification edge" for M5: instead of only trusting
+ * `perf_budget.ttfi_ms` in plan.md, this measures the real cold-start of the
+ * installed app on a device/emulator (Android `am start -W`) and compares it
+ * to the declared budget.
+ *
+ * This module is the PURE part (parsing + evaluation); the adb invocation
+ * lives in the CLI so the logic stays testable.
+ */
+/**
+ * Parse the output of `adb shell am start -W <pkg>/<activity>`.
+ * Looks for `TotalTime:` and `WaitTime:` lines.
+ */
+export function parseAmStartOutput(output) {
+    const num = (re) => {
+        const m = output.match(re);
+        return m ? Number(m[1]) : undefined;
+    };
+    const result = {};
+    const total = num(/TotalTime:\s*(\d+)/);
+    const wait = num(/WaitTime:\s*(\d+)/);
+    if (total !== undefined)
+        result.totalTimeMs = total;
+    if (wait !== undefined)
+        result.waitTimeMs = wait;
+    return result;
+}
+/**
+ * Compare a measured cold-start against the declared TTFI budget.
+ * `measuredMs` is the best available signal (prefer TotalTime, else WaitTime).
+ */
+export function evaluatePerf(timings, budgetMs) {
+    const measuredMs = timings.totalTimeMs ?? timings.waitTimeMs;
+    if (measuredMs === undefined)
+        return null;
+    const pass = measuredMs <= budgetMs;
+    const marginMs = budgetMs - measuredMs;
+    return {
+        measuredMs,
+        budgetMs,
+        pass,
+        marginMs,
+        message: pass
+            ? `cold-start ${measuredMs}ms is within the ${budgetMs}ms TTFI budget (margin ${marginMs}ms).`
+            : `cold-start ${measuredMs}ms EXCEEDS the ${budgetMs}ms TTFI budget by ${-marginMs}ms.`,
+    };
+}
+/**
+ * Whether Hermes is enabled (Android `gradle.properties` `hermesEnabled=true`).
+ * Hermes materially affects JS startup/TTFI, so it is part of the M5 picture.
+ * Returns undefined when the flag isn't present.
+ */
+export function parseHermesEnabled(gradleProperties) {
+    const m = gradleProperties.match(/^\s*hermesEnabled\s*=\s*(true|false)/m);
+    return m ? m[1] === "true" : undefined;
+}
+/** Median of a list of samples (for multi-run measurement). */
+export function median(samples) {
+    if (samples.length === 0)
+        return NaN;
+    const sorted = [...samples].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? Math.round((sorted[mid - 1] + sorted[mid]) / 2)
+        : sorted[mid];
+}
+//# sourceMappingURL=perf.js.map

package/dist/_core/dist/verify/perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.js","sourceRoot":"","sources":["../../src/verify/perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,GAAG,GAAG,CAAC,EAAU,EAAsB,EAAE;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC,CAAC;IACF,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC;IACpD,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAuB,EACvB,QAAgB;IAEhB,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC;IAC7D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,IAAI,GAAG,UAAU,IAAI,QAAQ,CAAC;IACpC,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvC,OAAO;QACL,UAAU;QACV,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,OAAO,EAAE,IAAI;YACX,CAAC,CAAC,cAAc,UAAU,oBAAoB,QAAQ,0BAA0B,QAAQ,MAAM;YAC9F,CAAC,CAAC,cAAc,UAAU,kBAAkB,QAAQ,qBAAqB,CAAC,QAAQ,KAAK;KAC1F,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,gBAAwB;IACzD,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC1E,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,MAAM,CAAC,OAAiB;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC;AACnB,CAAC"}