raptor-aios 0.1.0

package/dist/commands/verify/a11y.js

@@ -0,0 +1,121 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { scanA11yFiles, parseSpec } from "../../_core/dist/index.js";
+import { featureDir, requireProjectRoot } from "../../shared/project.js";
+const UI_EXT = [".tsx", ".jsx"];
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".raptor",
+    ".git",
+    "android",
+    "ios",
+    "dist",
+    "build",
+    "__tests__",
+]);
+function collectUiFiles(root) {
+    const out = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (SKIP_DIRS.has(e))
+                continue;
+            const p = join(dir, e);
+            const st = statSync(p);
+            if (st.isDirectory())
+                walk(p);
+            else if (UI_EXT.some((x) => e.endsWith(x)) &&
+                !/\.test\.|\.spec\./.test(e)) {
+                out.push(p);
+            }
+        }
+    };
+    walk(root);
+    return out;
+}
+export default class VerifyA11y extends Command {
+    static description = "Measure accessibility against the M3 declaration: statically scan UI source for " +
+        "interactive elements without accessible names, unlabeled images/inputs, etc.";
+    static examples = [
+        "<%= config.bin %> verify a11y",
+        "<%= config.bin %> verify a11y 001-home-screen",
+        "<%= config.bin %> verify a11y --path src --strict",
+    ];
+    static args = {
+        feature: Args.string({
+            description: "Feature slug (optional — cross-references its spec a11y declaration)",
+            required: false,
+        }),
+    };
+    static flags = {
+        path: Flags.string({
+            description: "Directory (or file) to scan",
+            default: "src",
+        }),
+        strict: Flags.boolean({
+            description: "Treat warnings as failures too",
+            default: false,
+        }),
+        json: Flags.boolean({ description: "Emit JSON", default: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VerifyA11y);
+        const root = requireProjectRoot();
+        const target = join(root, flags.path);
+        const scanRoot = existsSync(target) ? target : root;
+        // Collect UI files; also include a root App.tsx/App.jsx if present.
+        const files = collectUiFiles(scanRoot);
+        for (const appName of ["App.tsx", "App.jsx"]) {
+            const appPath = join(root, appName);
+            if (existsSync(appPath) && !files.includes(appPath))
+                files.push(appPath);
+        }
+        const report = scanA11yFiles(files.map((p) => ({
+            path: p.replace(root + "/", ""),
+            content: readFileSync(p, "utf8"),
+        })));
+        // Cross-reference the feature's declared a11y (M3), if a feature was given.
+        let declared;
+        if (args.feature) {
+            try {
+                const spec = parseSpec(join(featureDir(root, args.feature), "spec.md"));
+                const a11y = spec.data.a11y;
+                declared = a11y?.wcag_level;
+            }
+            catch {
+                /* feature optional */
+            }
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({ declared, ...report }, null, 2));
+        }
+        else {
+            this.log("=== a11y verification (static scan) ===\n");
+            if (declared)
+                this.log(`  Declared WCAG level (M3): ${declared}`);
+            this.log(`  Files scanned: ${report.filesScanned}\n`);
+            if (report.findings.length === 0) {
+                this.log("  ✅ No accessibility violations found — UI backs the M3 declaration.\n");
+            }
+            else {
+                for (const f of report.findings) {
+                    const icon = f.severity === "error" ? "🔴" : "🟡";
+                    this.log(`  ${icon} ${f.rule} [${f.severity}] ${f.file}:${f.line}`);
+                    this.log(`     ${f.message}`);
+                }
+                this.log(`\n  Summary: ${report.errors} error(s), ${report.warnings} warning(s).`);
+            }
+        }
+        const failing = report.errors + (flags.strict ? report.warnings : 0);
+        if (failing > 0)
+            this.exit(1);
+    }
+}
+//# sourceMappingURL=a11y.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { Command } from "@oclif/core";
+export default class VerifyArchitecture extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        path: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=architecture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"architecture.d.ts","sourceRoot":"","sources":["../../../src/commands/verify/architecture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AA6B7C,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,OAAgB,WAAW,SAEmD;IAE9E,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA8B3B"}

package/dist/commands/verify/architecture.js

@@ -0,0 +1,71 @@
+import { Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { analyzeArchitecture } from "../../_core/dist/index.js";
+import { requireProjectRoot } from "../../shared/project.js";
+const CODE_EXT = [".ts", ".tsx", ".js", ".jsx"];
+const SKIP = new Set(["node_modules", ".raptor", ".git", "android", "ios", "dist", "build", "__tests__"]);
+function collect(root) {
+    const out = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (SKIP.has(e))
+                continue;
+            const p = join(dir, e);
+            if (statSync(p).isDirectory())
+                walk(p);
+            else if (CODE_EXT.some((x) => e.endsWith(x)) && !/\.test\.|\.spec\./.test(e))
+                out.push(p);
+        }
+    };
+    walk(root);
+    return out;
+}
+export default class VerifyArchitecture extends Command {
+    static description = "M8 (experimental): static clean-architecture check over the import graph — domain purity, " +
+        "layer direction (domain⟵data⟵presentation), and no cross-feature imports.";
+    static examples = [
+        "<%= config.bin %> verify architecture",
+        "<%= config.bin %> verify architecture --path src --json",
+    ];
+    static flags = {
+        path: Flags.string({ description: "Directory to scan", default: "src" }),
+        json: Flags.boolean({ description: "Emit JSON", default: false }),
+    };
+    async run() {
+        const { flags } = await this.parse(VerifyArchitecture);
+        const root = requireProjectRoot();
+        const scanRoot = existsSync(join(root, flags.path)) ? join(root, flags.path) : root;
+        const report = analyzeArchitecture(collect(scanRoot).map((p) => ({
+            path: p.replace(root + "/", ""),
+            content: readFileSync(p, "utf8"),
+        })));
+        if (flags.json) {
+            this.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            this.log("=== M8 clean-architecture verification (import graph) ===\n");
+            this.log(`  Files scanned: ${report.filesScanned}\n`);
+            if (report.findings.length === 0) {
+                this.log("  ✅ No layering violations found.\n");
+            }
+            else {
+                for (const f of report.findings) {
+                    this.log(`  🔴 ${f.rule} ${f.file}:${f.line}`);
+                    this.log(`     ${f.message}`);
+                }
+                this.log(`\n  Summary: ${report.errors} violation(s).`);
+            }
+        }
+        if (report.errors > 0)
+            this.exit(1);
+    }
+}
+//# sourceMappingURL=architecture.js.map

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

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

package/dist/commands/verify/audit.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "@oclif/core";
+export default class VerifyAudit extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        quick: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        strict: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        coverage: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private collectFeatures;
+    private printResult;
+    private fmtError;
+}
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/verify/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/commands/verify/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAYnD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,OAAgB,WAAW,SAGuC;IAElE,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,IAAI;;MAMlB;IAEF,OAAgB,KAAK;;;;MAenB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC1B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/commands/verify/audit.js

@@ -0,0 +1,108 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, readdirSync } from "node:fs";
+import { basename, join } from "node:path";
+import { validateAuditFile, } from "../../_core/dist/index.js";
+import { auditableDir, requireProjectRoot } from "../../shared/project.js";
+export default class VerifyAudit extends Command {
+    static description = "Validate audit.jsonl against the canonical JSON Schema (raptor.audit.v1). " +
+        "Modes: --quick (schema only), default (schema + monotonic), " +
+        "--strict (also CRLF check), --coverage (not yet implemented).";
+    static examples = [
+        "<%= config.bin %> verify audit",
+        "<%= config.bin %> verify audit 001-login-biometrico",
+        "<%= config.bin %> verify audit 001-login --quick",
+        "<%= config.bin %> verify audit 001-login --strict",
+    ];
+    static args = {
+        feature: Args.string({
+            description: "Feature slug or NNN-slug (omit to verify audit for all features)",
+            required: false,
+        }),
+    };
+    static flags = {
+        quick: Flags.boolean({
+            description: "Schema validation only (used by pre-commit hook)",
+            exclusive: ["strict", "coverage"],
+        }),
+        strict: Flags.boolean({
+            description: "Schema + monotonic sequence/ts + CRLF check (used by pre-push hook)",
+            exclusive: ["quick", "coverage"],
+        }),
+        coverage: Flags.boolean({
+            description: "Detect code diffs without matching audit entries (CI mode, not yet implemented)",
+            exclusive: ["quick", "strict"],
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VerifyAudit);
+        const root = requireProjectRoot();
+        const mode = flags.coverage
+            ? "coverage"
+            : flags.strict
+                ? "strict"
+                : flags.quick
+                    ? "quick"
+                    : "default";
+        if (mode === "coverage") {
+            this.warn("--coverage mode is not yet implemented (planned: git diff vs code.generated/task.completed entries).");
+            return;
+        }
+        const features = this.collectFeatures(root, args.feature);
+        if (features.length === 0) {
+            this.log("(no features with audit.jsonl found)");
+            return;
+        }
+        let anyInvalid = false;
+        for (const dir of features) {
+            const featureName = basename(dir);
+            const auditPath = join(dir, "audit.jsonl");
+            const result = validateAuditFile(auditPath, {
+                strict: mode === "strict",
+            });
+            this.printResult(featureName, mode, result);
+            if (!result.valid)
+                anyInvalid = true;
+        }
+        if (anyInvalid)
+            this.exit(1);
+    }
+    collectFeatures(root, slug) {
+        if (slug) {
+            const dir = auditableDir(root, slug);
+            const audit = join(dir, "audit.jsonl");
+            return existsSync(audit) ? [dir] : [];
+        }
+        const bases = [
+            join(root, ".raptor", "specs"),
+            join(root, ".raptor", "hotfixes"),
+        ];
+        const dirs = [];
+        for (const base of bases) {
+            if (!existsSync(base))
+                continue;
+            for (const d of readdirSync(base)) {
+                if (!/^\d{3,}-/.test(d))
+                    continue;
+                const full = join(base, d);
+                if (existsSync(join(full, "audit.jsonl")))
+                    dirs.push(full);
+            }
+        }
+        return dirs;
+    }
+    printResult(featureName, mode, result) {
+        const tag = result.valid ? "✓" : "✗";
+        const summary = `${result.validLines}/${result.totalLines} lines valid`;
+        this.log(`${tag} ${featureName} [${mode}] — ${summary}`);
+        if (!result.valid) {
+            for (const e of result.errors)
+                this.log(`    ${this.fmtError(e)}`);
+        }
+    }
+    fmtError(e) {
+        const loc = e.line ? `line ${e.line}` : "(file)";
+        const path = e.path ? ` ${e.path}` : "";
+        return `${loc}${path}: ${e.message} [${e.keyword}]`;
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/verify/audit.js.map

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

package/dist/commands/verify/constitution.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "@oclif/core";
+export default class VerifyConstitution extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        strict: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=constitution.d.ts.map

package/dist/commands/verify/constitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.d.ts","sourceRoot":"","sources":["../../../src/commands/verify/constitution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAW7C,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,OAAgB,WAAW,SACuF;IAElH,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;MAMnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoF3B"}

package/dist/commands/verify/constitution.js

@@ -0,0 +1,91 @@
+import { Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CORE_VERSION, coreHash, extractCoreBlock, } from "../../_core/dist/index.js";
+import { currentActor, requireProjectRoot } from "../../shared/project.js";
+import { runAfterHook, runBeforeHook } from "../../shared/hooks.js";
+export default class VerifyConstitution extends Command {
+    static description = "Validate the RAPTOR-CORE block in .raptor/constitution.md against the installed CLI version (C4 enforcement).";
+    static examples = [
+        "<%= config.bin %> verify constitution",
+        "<%= config.bin %> verify constitution --strict",
+    ];
+    static flags = {
+        strict: Flags.boolean({
+            description: "Fail if block version differs from installed CLI (default: warn only).",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(VerifyConstitution);
+        const root = requireProjectRoot();
+        const path = join(root, ".raptor", "constitution.md");
+        const actor = currentActor("human");
+        runBeforeHook(this, {
+            event: "before_verify_constitution",
+            command: `raptor verify constitution${flags.strict ? " --strict" : ""}`,
+            projectRoot: root,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            extra: flags.strict ? { strict: "1" } : {},
+        });
+        if (!existsSync(path)) {
+            this.log(`✗ constitution.md missing at ${path}`);
+            this.exit(1);
+        }
+        const source = readFileSync(path, "utf8");
+        const extracted = extractCoreBlock(source);
+        if (!extracted) {
+            this.log("✗ RAPTOR-CORE markers not found in constitution.md");
+            this.log("  Run `raptor repair constitution` to restore the canonical block.");
+            this.exit(1);
+        }
+        const expectedHash = coreHash();
+        this.log(`Constitution: ${path}`);
+        this.log(`  Declared version: ${extracted.version}`);
+        this.log(`  Declared hash:    ${extracted.declaredHash}`);
+        this.log(`  Computed hash:    ${extracted.computedHash}`);
+        this.log(`  CLI version:      ${CORE_VERSION}`);
+        this.log(`  CLI hash:         ${expectedHash}`);
+        if (!extracted.isIntact) {
+            this.log("");
+            this.log(`✗ Hash mismatch — block was edited without updating the declared hash.`);
+            this.log("  The declared hash does not match the hash of the body.");
+            this.log("  Remediation: run `raptor repair constitution` to restore the canonical block.");
+            this.exit(1);
+        }
+        if (!extracted.isCanonical) {
+            const versionDiff = extracted.version !== CORE_VERSION;
+            const bodyDiff = extracted.declaredHash !== expectedHash;
+            this.log("");
+            if (bodyDiff) {
+                this.log("✗ Block body differs from the canonical text shipped with this CLI.");
+                this.log("  The declared hash is self-consistent but the text was altered.");
+                this.log("  Remediation: run `raptor repair constitution`.");
+                this.exit(1);
+            }
+            if (versionDiff) {
+                const msg = `Block version (${extracted.version}) differs from CLI version (${CORE_VERSION}).`;
+                if (flags.strict) {
+                    this.log(`✗ ${msg}`);
+                    this.log("  Remediation: run `raptor repair constitution` (upgrade) or downgrade the CLI.");
+                    this.exit(1);
+                }
+                this.warn(msg);
+            }
+        }
+        this.log("");
+        this.log("✓ RAPTOR-CORE block is intact and canonical.");
+        runAfterHook(this, {
+            event: "after_verify_constitution",
+            command: `raptor verify constitution${flags.strict ? " --strict" : ""}`,
+            projectRoot: root,
+            actor: { user: actor.email ?? actor.user, via: actor.via },
+            extra: {
+                result: "ok",
+                declared_version: extracted.version,
+                cli_version: CORE_VERSION,
+            },
+        });
+    }
+}
+//# sourceMappingURL=constitution.js.map

package/dist/commands/verify/constitution.js.map

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

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

@@ -0,0 +1,14 @@
+import { Command } from "@oclif/core";
+export default class VerifyOsMatrix extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        fix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=os-matrix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"os-matrix.d.ts","sourceRoot":"","sources":["../../../src/commands/verify/os-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAwBnD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAgB,WAAW,SAEyF;IAEpH,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAGnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgF3B"}

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

@@ -0,0 +1,108 @@
+import { Args, Command, Flags } from "@oclif/core";
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parsePlan, parseAndroidMinSdk, parseIosDeploymentTarget, androidVersionToApi, evaluateOsMatrix, } from "../../_core/dist/index.js";
+import { featureDir, requireProjectRoot } from "../../shared/project.js";
+function findPbxproj(root) {
+    const iosDir = join(root, "ios");
+    if (!existsSync(iosDir))
+        return undefined;
+    for (const e of readdirSync(iosDir)) {
+        if (e.endsWith(".xcodeproj")) {
+            const p = join(iosDir, e, "project.pbxproj");
+            if (existsSync(p))
+                return p;
+        }
+    }
+    return undefined;
+}
+export default class VerifyOsMatrix extends Command {
+    static description = "Measure the M4 OS support matrix: compare the declared plan.os_matrix against the real native config " +
+        "(android/build.gradle minSdkVersion, iOS deployment target). --fix aligns the native config to the declaration.";
+    static examples = [
+        "<%= config.bin %> verify os-matrix 001-home-screen",
+        "<%= config.bin %> verify os-matrix 001-home-screen --fix",
+    ];
+    static args = {
+        feature: Args.string({ description: "Feature slug (NNN-slug)", required: true }),
+    };
+    static flags = {
+        fix: Flags.boolean({ description: "Align the native config to the declared os_matrix", default: false }),
+        json: Flags.boolean({ description: "Emit JSON", default: false }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(VerifyOsMatrix);
+        const root = requireProjectRoot();
+        const planPath = join(featureDir(root, args.feature), "plan.md");
+        if (!existsSync(planPath))
+            this.error(`plan.md not found for ${args.feature}`);
+        const declared = parsePlan(planPath).data.os_matrix;
+        if (!declared)
+            this.error("plan.md has no os_matrix — declare it (M4) first.");
+        const gradlePath = join(root, "android", "build.gradle");
+        const pbxprojPath = findPbxproj(root);
+        const podfilePath = join(root, "ios", "Podfile");
+        const androidMinSdk = existsSync(gradlePath)
+            ? parseAndroidMinSdk(readFileSync(gradlePath, "utf8"))
+            : undefined;
+        let iosTarget;
+        if (pbxprojPath)
+            iosTarget = parseIosDeploymentTarget(readFileSync(pbxprojPath, "utf8"));
+        if (!iosTarget && existsSync(podfilePath))
+            iosTarget = parseIosDeploymentTarget(readFileSync(podfilePath, "utf8"));
+        const evaluation = evaluateOsMatrix(declared, { androidMinSdk, iosTarget });
+        // --fix: rewrite native config to match the declaration.
+        const fixed = [];
+        if (flags.fix) {
+            for (const c of evaluation.checks) {
+                if (c.status !== "mismatch")
+                    continue;
+                if (c.platform === "android" && declared.android_min && existsSync(gradlePath)) {
+                    const api = androidVersionToApi(String(declared.android_min));
+                    if (api !== undefined) {
+                        const raw = readFileSync(gradlePath, "utf8");
+                        const next = raw.replace(/(minSdkVersion\s*=?\s*)\d+/, `$1${api}`);
+                        if (next !== raw) {
+                            writeFileSync(gradlePath, next);
+                            fixed.push(`android/build.gradle minSdkVersion → ${api}`);
+                        }
+                    }
+                }
+                if (c.platform === "ios" && declared.ios_min && pbxprojPath) {
+                    const raw = readFileSync(pbxprojPath, "utf8");
+                    const next = raw.replace(/(IPHONEOS_DEPLOYMENT_TARGET\s*=\s*)[0-9.]+/g, `$1${declared.ios_min}`);
+                    if (next !== raw) {
+                        writeFileSync(pbxprojPath, next);
+                        fixed.push(`iOS IPHONEOS_DEPLOYMENT_TARGET → ${declared.ios_min}`);
+                    }
+                }
+            }
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({ ...evaluation, fixed }, null, 2));
+        }
+        else {
+            this.log("=== M4 OS matrix verification (declared vs native) ===\n");
+            for (const c of evaluation.checks) {
+                const icon = c.status === "match" ? "✅" : c.status === "mismatch" ? "🔴" : "⚠️";
+                this.log(`  ${icon} ${c.platform}: declared ${c.declared} | native ${c.native}`);
+                if (c.status !== "match")
+                    this.log(`     ${c.detail}`);
+            }
+            if (fixed.length > 0) {
+                this.log("\n  🔧 Fixed:");
+                for (const f of fixed)
+                    this.log(`     ${f}`);
+                this.log("  Re-run to confirm.");
+            }
+            this.log(evaluation.ok
+                ? "\n  ✅ Native OS matrix matches the M4 declaration."
+                : flags.fix
+                    ? "\n  Applied fixes — re-run 'raptor verify os-matrix' to confirm."
+                    : "\n  🔴 Mismatch — pass --fix to align the native config, or update plan.os_matrix.");
+        }
+        if (!evaluation.ok && !flags.fix)
+            this.exit(1);
+    }
+}
+//# sourceMappingURL=os-matrix.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { Command } from "@oclif/core";
+export default class VerifyPerf extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        feature: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        package: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        activity: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        runs: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        device: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=perf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../../../src/commands/verify/perf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAcnD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,OAAgB,WAAW,SAC2F;IAEtH,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;;MAMnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6E3B"}