@synchronized-studio/cmsassets-agent 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,811 @@
+import { z } from 'zod';
+
+declare const FrameworkName: z.ZodEnum<["nuxt", "nuxt2", "next", "remix", "astro", "sveltekit", "express", "hono", "fastify", "unknown"]>;
+type FrameworkName = z.infer<typeof FrameworkName>;
+declare const CmsType: z.ZodEnum<["prismic", "contentful", "sanity", "shopify", "cloudinary", "imgix", "generic", "unknown"]>;
+type CmsType = z.infer<typeof CmsType>;
+declare const PackageManager: z.ZodEnum<["npm", "yarn", "pnpm", "bun"]>;
+type PackageManager = z.infer<typeof PackageManager>;
+declare const Confidence: z.ZodEnum<["high", "medium", "low"]>;
+type Confidence = z.infer<typeof Confidence>;
+declare const InjectionType: z.ZodEnum<["return", "res.json", "assignment", "useFetch-transform", "useAsyncData-transform", "loader-return", "getServerSideProps-return", "getStaticProps-return", "load-return", "frontmatter-assignment", "asyncData-return", "vuex-action-return"]>;
+type InjectionType = z.infer<typeof InjectionType>;
+declare const VerifyProfile: z.ZodEnum<["quick", "full"]>;
+type VerifyProfile = z.infer<typeof VerifyProfile>;
+declare const FrameworkInfo: z.ZodObject<{
+    name: z.ZodEnum<["nuxt", "nuxt2", "next", "remix", "astro", "sveltekit", "express", "hono", "fastify", "unknown"]>;
+    version: z.ZodString;
+    configFile: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+    version: string;
+    configFile: string | null;
+}, {
+    name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+    version: string;
+    configFile: string | null;
+}>;
+type FrameworkInfo = z.infer<typeof FrameworkInfo>;
+declare const CmsInfo: z.ZodObject<{
+    type: z.ZodEnum<["prismic", "contentful", "sanity", "shopify", "cloudinary", "imgix", "generic", "unknown"]>;
+    params: z.ZodRecord<z.ZodString, z.ZodString>;
+    detectedFrom: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+    params: Record<string, string>;
+    detectedFrom: string[];
+}, {
+    type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+    params: Record<string, string>;
+    detectedFrom: string[];
+}>;
+type CmsInfo = z.infer<typeof CmsInfo>;
+declare const InjectionCandidate: z.ZodObject<{
+    filePath: z.ZodString;
+    line: z.ZodNumber;
+    type: z.ZodEnum<["return", "res.json", "assignment", "useFetch-transform", "useAsyncData-transform", "loader-return", "getServerSideProps-return", "getStaticProps-return", "load-return", "frontmatter-assignment", "asyncData-return", "vuex-action-return"]>;
+    score: z.ZodNumber;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    targetCode: z.ZodString;
+    context: z.ZodString;
+    reasons: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+    filePath: string;
+    line: number;
+    score: number;
+    confidence: "high" | "medium" | "low";
+    targetCode: string;
+    context: string;
+    reasons: string[];
+}, {
+    type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+    filePath: string;
+    line: number;
+    score: number;
+    confidence: "high" | "medium" | "low";
+    targetCode: string;
+    context: string;
+    reasons: string[];
+}>;
+type InjectionCandidate = z.infer<typeof InjectionCandidate>;
+declare const ScanResult: z.ZodObject<{
+    framework: z.ZodObject<{
+        name: z.ZodEnum<["nuxt", "nuxt2", "next", "remix", "astro", "sveltekit", "express", "hono", "fastify", "unknown"]>;
+        version: z.ZodString;
+        configFile: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+        version: string;
+        configFile: string | null;
+    }, {
+        name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+        version: string;
+        configFile: string | null;
+    }>;
+    cms: z.ZodObject<{
+        type: z.ZodEnum<["prismic", "contentful", "sanity", "shopify", "cloudinary", "imgix", "generic", "unknown"]>;
+        params: z.ZodRecord<z.ZodString, z.ZodString>;
+        detectedFrom: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+        params: Record<string, string>;
+        detectedFrom: string[];
+    }, {
+        type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+        params: Record<string, string>;
+        detectedFrom: string[];
+    }>;
+    injectionPoints: z.ZodArray<z.ZodObject<{
+        filePath: z.ZodString;
+        line: z.ZodNumber;
+        type: z.ZodEnum<["return", "res.json", "assignment", "useFetch-transform", "useAsyncData-transform", "loader-return", "getServerSideProps-return", "getStaticProps-return", "load-return", "frontmatter-assignment", "asyncData-return", "vuex-action-return"]>;
+        score: z.ZodNumber;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        targetCode: z.ZodString;
+        context: z.ZodString;
+        reasons: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+        filePath: string;
+        line: number;
+        score: number;
+        confidence: "high" | "medium" | "low";
+        targetCode: string;
+        context: string;
+        reasons: string[];
+    }, {
+        type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+        filePath: string;
+        line: number;
+        score: number;
+        confidence: "high" | "medium" | "low";
+        targetCode: string;
+        context: string;
+        reasons: string[];
+    }>, "many">;
+    packageManager: z.ZodEnum<["npm", "yarn", "pnpm", "bun"]>;
+    projectRoot: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    cms: {
+        type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+        params: Record<string, string>;
+        detectedFrom: string[];
+    };
+    framework: {
+        name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+        version: string;
+        configFile: string | null;
+    };
+    injectionPoints: {
+        type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+        filePath: string;
+        line: number;
+        score: number;
+        confidence: "high" | "medium" | "low";
+        targetCode: string;
+        context: string;
+        reasons: string[];
+    }[];
+    packageManager: "npm" | "yarn" | "pnpm" | "bun";
+    projectRoot: string;
+}, {
+    cms: {
+        type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+        params: Record<string, string>;
+        detectedFrom: string[];
+    };
+    framework: {
+        name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+        version: string;
+        configFile: string | null;
+    };
+    injectionPoints: {
+        type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+        filePath: string;
+        line: number;
+        score: number;
+        confidence: "high" | "medium" | "low";
+        targetCode: string;
+        context: string;
+        reasons: string[];
+    }[];
+    packageManager: "npm" | "yarn" | "pnpm" | "bun";
+    projectRoot: string;
+}>;
+type ScanResult = z.infer<typeof ScanResult>;
+declare const FilePatch: z.ZodObject<{
+    filePath: z.ZodString;
+    description: z.ZodString;
+    importToAdd: z.ZodString;
+    wrapTarget: z.ZodObject<{
+        line: z.ZodNumber;
+        originalCode: z.ZodString;
+        transformedCode: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        originalCode: string;
+        transformedCode: string;
+    }, {
+        line: number;
+        originalCode: string;
+        transformedCode: string;
+    }>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    reasons: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    filePath: string;
+    confidence: "high" | "medium" | "low";
+    reasons: string[];
+    importToAdd: string;
+    wrapTarget: {
+        line: number;
+        originalCode: string;
+        transformedCode: string;
+    };
+}, {
+    description: string;
+    filePath: string;
+    confidence: "high" | "medium" | "low";
+    reasons: string[];
+    importToAdd: string;
+    wrapTarget: {
+        line: number;
+        originalCode: string;
+        transformedCode: string;
+    };
+}>;
+type FilePatch = z.infer<typeof FilePatch>;
+declare const PatchPlan: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    scan: z.ZodObject<{
+        framework: z.ZodObject<{
+            name: z.ZodEnum<["nuxt", "nuxt2", "next", "remix", "astro", "sveltekit", "express", "hono", "fastify", "unknown"]>;
+            version: z.ZodString;
+            configFile: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+            version: string;
+            configFile: string | null;
+        }, {
+            name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+            version: string;
+            configFile: string | null;
+        }>;
+        cms: z.ZodObject<{
+            type: z.ZodEnum<["prismic", "contentful", "sanity", "shopify", "cloudinary", "imgix", "generic", "unknown"]>;
+            params: z.ZodRecord<z.ZodString, z.ZodString>;
+            detectedFrom: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+            params: Record<string, string>;
+            detectedFrom: string[];
+        }, {
+            type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+            params: Record<string, string>;
+            detectedFrom: string[];
+        }>;
+        injectionPoints: z.ZodArray<z.ZodObject<{
+            filePath: z.ZodString;
+            line: z.ZodNumber;
+            type: z.ZodEnum<["return", "res.json", "assignment", "useFetch-transform", "useAsyncData-transform", "loader-return", "getServerSideProps-return", "getStaticProps-return", "load-return", "frontmatter-assignment", "asyncData-return", "vuex-action-return"]>;
+            score: z.ZodNumber;
+            confidence: z.ZodEnum<["high", "medium", "low"]>;
+            targetCode: z.ZodString;
+            context: z.ZodString;
+            reasons: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+            filePath: string;
+            line: number;
+            score: number;
+            confidence: "high" | "medium" | "low";
+            targetCode: string;
+            context: string;
+            reasons: string[];
+        }, {
+            type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+            filePath: string;
+            line: number;
+            score: number;
+            confidence: "high" | "medium" | "low";
+            targetCode: string;
+            context: string;
+            reasons: string[];
+        }>, "many">;
+        packageManager: z.ZodEnum<["npm", "yarn", "pnpm", "bun"]>;
+        projectRoot: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        cms: {
+            type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+            params: Record<string, string>;
+            detectedFrom: string[];
+        };
+        framework: {
+            name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+            version: string;
+            configFile: string | null;
+        };
+        injectionPoints: {
+            type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+            filePath: string;
+            line: number;
+            score: number;
+            confidence: "high" | "medium" | "low";
+            targetCode: string;
+            context: string;
+            reasons: string[];
+        }[];
+        packageManager: "npm" | "yarn" | "pnpm" | "bun";
+        projectRoot: string;
+    }, {
+        cms: {
+            type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+            params: Record<string, string>;
+            detectedFrom: string[];
+        };
+        framework: {
+            name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+            version: string;
+            configFile: string | null;
+        };
+        injectionPoints: {
+            type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+            filePath: string;
+            line: number;
+            score: number;
+            confidence: "high" | "medium" | "low";
+            targetCode: string;
+            context: string;
+            reasons: string[];
+        }[];
+        packageManager: "npm" | "yarn" | "pnpm" | "bun";
+        projectRoot: string;
+    }>;
+    install: z.ZodObject<{
+        package: z.ZodLiteral<"@synchronized-studio/response-transformer">;
+        command: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        package: "@synchronized-studio/response-transformer";
+        command: string;
+    }, {
+        package: "@synchronized-studio/response-transformer";
+        command: string;
+    }>;
+    env: z.ZodObject<{
+        key: z.ZodLiteral<"CMS_ASSETS_URL">;
+        placeholder: z.ZodString;
+        files: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        key: "CMS_ASSETS_URL";
+        placeholder: string;
+        files: string[];
+    }, {
+        key: "CMS_ASSETS_URL";
+        placeholder: string;
+        files: string[];
+    }>;
+    patches: z.ZodArray<z.ZodObject<{
+        filePath: z.ZodString;
+        description: z.ZodString;
+        importToAdd: z.ZodString;
+        wrapTarget: z.ZodObject<{
+            line: z.ZodNumber;
+            originalCode: z.ZodString;
+            transformedCode: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            originalCode: string;
+            transformedCode: string;
+        }, {
+            line: number;
+            originalCode: string;
+            transformedCode: string;
+        }>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        reasons: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        filePath: string;
+        confidence: "high" | "medium" | "low";
+        reasons: string[];
+        importToAdd: string;
+        wrapTarget: {
+            line: number;
+            originalCode: string;
+            transformedCode: string;
+        };
+    }, {
+        description: string;
+        filePath: string;
+        confidence: "high" | "medium" | "low";
+        reasons: string[];
+        importToAdd: string;
+        wrapTarget: {
+            line: number;
+            originalCode: string;
+            transformedCode: string;
+        };
+    }>, "many">;
+    policies: z.ZodObject<{
+        maxFilesAutoApply: z.ZodDefault<z.ZodNumber>;
+        allowLlmFallback: z.ZodDefault<z.ZodBoolean>;
+        /** When true, try LLM for any failed AST patch (not just low confidence). Useful for testing. */
+        llmFallbackForAll: z.ZodDefault<z.ZodBoolean>;
+        /** When true, skip AST entirely and use LLM for all patches (testing only). */
+        llmOnly: z.ZodDefault<z.ZodBoolean>;
+        verifyProfile: z.ZodDefault<z.ZodEnum<["quick", "full"]>>;
+    }, "strip", z.ZodTypeAny, {
+        maxFilesAutoApply: number;
+        allowLlmFallback: boolean;
+        llmFallbackForAll: boolean;
+        llmOnly: boolean;
+        verifyProfile: "quick" | "full";
+    }, {
+        maxFilesAutoApply?: number | undefined;
+        allowLlmFallback?: boolean | undefined;
+        llmFallbackForAll?: boolean | undefined;
+        llmOnly?: boolean | undefined;
+        verifyProfile?: "quick" | "full" | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    scan: {
+        cms: {
+            type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+            params: Record<string, string>;
+            detectedFrom: string[];
+        };
+        framework: {
+            name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+            version: string;
+            configFile: string | null;
+        };
+        injectionPoints: {
+            type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+            filePath: string;
+            line: number;
+            score: number;
+            confidence: "high" | "medium" | "low";
+            targetCode: string;
+            context: string;
+            reasons: string[];
+        }[];
+        packageManager: "npm" | "yarn" | "pnpm" | "bun";
+        projectRoot: string;
+    };
+    install: {
+        package: "@synchronized-studio/response-transformer";
+        command: string;
+    };
+    schemaVersion: "1.0";
+    env: {
+        key: "CMS_ASSETS_URL";
+        placeholder: string;
+        files: string[];
+    };
+    patches: {
+        description: string;
+        filePath: string;
+        confidence: "high" | "medium" | "low";
+        reasons: string[];
+        importToAdd: string;
+        wrapTarget: {
+            line: number;
+            originalCode: string;
+            transformedCode: string;
+        };
+    }[];
+    policies: {
+        maxFilesAutoApply: number;
+        allowLlmFallback: boolean;
+        llmFallbackForAll: boolean;
+        llmOnly: boolean;
+        verifyProfile: "quick" | "full";
+    };
+}, {
+    scan: {
+        cms: {
+            type: "unknown" | "prismic" | "contentful" | "sanity" | "shopify" | "cloudinary" | "imgix" | "generic";
+            params: Record<string, string>;
+            detectedFrom: string[];
+        };
+        framework: {
+            name: "nuxt" | "nuxt2" | "next" | "remix" | "astro" | "sveltekit" | "express" | "hono" | "fastify" | "unknown";
+            version: string;
+            configFile: string | null;
+        };
+        injectionPoints: {
+            type: "return" | "res.json" | "assignment" | "useFetch-transform" | "useAsyncData-transform" | "loader-return" | "getServerSideProps-return" | "getStaticProps-return" | "load-return" | "frontmatter-assignment" | "asyncData-return" | "vuex-action-return";
+            filePath: string;
+            line: number;
+            score: number;
+            confidence: "high" | "medium" | "low";
+            targetCode: string;
+            context: string;
+            reasons: string[];
+        }[];
+        packageManager: "npm" | "yarn" | "pnpm" | "bun";
+        projectRoot: string;
+    };
+    install: {
+        package: "@synchronized-studio/response-transformer";
+        command: string;
+    };
+    schemaVersion: "1.0";
+    env: {
+        key: "CMS_ASSETS_URL";
+        placeholder: string;
+        files: string[];
+    };
+    patches: {
+        description: string;
+        filePath: string;
+        confidence: "high" | "medium" | "low";
+        reasons: string[];
+        importToAdd: string;
+        wrapTarget: {
+            line: number;
+            originalCode: string;
+            transformedCode: string;
+        };
+    }[];
+    policies: {
+        maxFilesAutoApply?: number | undefined;
+        allowLlmFallback?: boolean | undefined;
+        llmFallbackForAll?: boolean | undefined;
+        llmOnly?: boolean | undefined;
+        verifyProfile?: "quick" | "full" | undefined;
+    };
+}>;
+type PatchPlan = z.infer<typeof PatchPlan>;
+declare const PatchedFileReport: z.ZodObject<{
+    filePath: z.ZodString;
+    applied: z.ZodBoolean;
+    method: z.ZodEnum<["ast", "llm", "skipped"]>;
+    reason: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    applied: boolean;
+    method: "llm" | "ast" | "skipped";
+    durationMs: number;
+    reason?: string | undefined;
+}, {
+    filePath: string;
+    applied: boolean;
+    method: "llm" | "ast" | "skipped";
+    durationMs: number;
+    reason?: string | undefined;
+}>;
+type PatchedFileReport = z.infer<typeof PatchedFileReport>;
+declare const ApplyReport: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    timestamp: z.ZodString;
+    projectRoot: z.ZodString;
+    gitBranch: z.ZodNullable<z.ZodString>;
+    gitCommit: z.ZodNullable<z.ZodString>;
+    installed: z.ZodBoolean;
+    envUpdated: z.ZodBoolean;
+    files: z.ZodArray<z.ZodObject<{
+        filePath: z.ZodString;
+        applied: z.ZodBoolean;
+        method: z.ZodEnum<["ast", "llm", "skipped"]>;
+        reason: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        filePath: string;
+        applied: boolean;
+        method: "llm" | "ast" | "skipped";
+        durationMs: number;
+        reason?: string | undefined;
+    }, {
+        filePath: string;
+        applied: boolean;
+        method: "llm" | "ast" | "skipped";
+        durationMs: number;
+        reason?: string | undefined;
+    }>, "many">;
+    totalDurationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    projectRoot: string;
+    schemaVersion: "1.0";
+    files: {
+        filePath: string;
+        applied: boolean;
+        method: "llm" | "ast" | "skipped";
+        durationMs: number;
+        reason?: string | undefined;
+    }[];
+    timestamp: string;
+    gitBranch: string | null;
+    gitCommit: string | null;
+    installed: boolean;
+    envUpdated: boolean;
+    totalDurationMs: number;
+}, {
+    projectRoot: string;
+    schemaVersion: "1.0";
+    files: {
+        filePath: string;
+        applied: boolean;
+        method: "llm" | "ast" | "skipped";
+        durationMs: number;
+        reason?: string | undefined;
+    }[];
+    timestamp: string;
+    gitBranch: string | null;
+    gitCommit: string | null;
+    installed: boolean;
+    envUpdated: boolean;
+    totalDurationMs: number;
+}>;
+type ApplyReport = z.infer<typeof ApplyReport>;
+declare const VerifyReport: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    profile: z.ZodEnum<["quick", "full"]>;
+    lintPassed: z.ZodNullable<z.ZodBoolean>;
+    buildPassed: z.ZodNullable<z.ZodBoolean>;
+    testsPassed: z.ZodNullable<z.ZodBoolean>;
+    patchedFiles: z.ZodArray<z.ZodString, "many">;
+    warnings: z.ZodArray<z.ZodString, "many">;
+    durationMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    profile: "quick" | "full";
+    schemaVersion: "1.0";
+    durationMs: number;
+    lintPassed: boolean | null;
+    buildPassed: boolean | null;
+    testsPassed: boolean | null;
+    patchedFiles: string[];
+    warnings: string[];
+}, {
+    profile: "quick" | "full";
+    schemaVersion: "1.0";
+    durationMs: number;
+    lintPassed: boolean | null;
+    buildPassed: boolean | null;
+    testsPassed: boolean | null;
+    patchedFiles: string[];
+    warnings: string[];
+}>;
+type VerifyReport = z.infer<typeof VerifyReport>;
+declare const AiFileResult: z.ZodObject<{
+    filePath: z.ZodString;
+    passed: z.ZodBoolean;
+    issues: z.ZodArray<z.ZodString, "many">;
+    fixAttempted: z.ZodBoolean;
+    fixApplied: z.ZodBoolean;
+    iterations: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    issues: string[];
+    filePath: string;
+    passed: boolean;
+    fixAttempted: boolean;
+    fixApplied: boolean;
+    iterations: number;
+}, {
+    issues: string[];
+    filePath: string;
+    passed: boolean;
+    fixAttempted: boolean;
+    fixApplied: boolean;
+    iterations: number;
+}>;
+type AiFileResult = z.infer<typeof AiFileResult>;
+declare const AiReviewReport: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    filesReviewed: z.ZodNumber;
+    filesPassed: z.ZodNumber;
+    filesFixed: z.ZodNumber;
+    filesFailed: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        filePath: z.ZodString;
+        passed: z.ZodBoolean;
+        issues: z.ZodArray<z.ZodString, "many">;
+        fixAttempted: z.ZodBoolean;
+        fixApplied: z.ZodBoolean;
+        iterations: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        issues: string[];
+        filePath: string;
+        passed: boolean;
+        fixAttempted: boolean;
+        fixApplied: boolean;
+        iterations: number;
+    }, {
+        issues: string[];
+        filePath: string;
+        passed: boolean;
+        fixAttempted: boolean;
+        fixApplied: boolean;
+        iterations: number;
+    }>, "many">;
+    totalDurationMs: z.ZodNumber;
+    tokensUsed: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: "1.0";
+    totalDurationMs: number;
+    filesReviewed: number;
+    filesPassed: number;
+    filesFixed: number;
+    filesFailed: number;
+    results: {
+        issues: string[];
+        filePath: string;
+        passed: boolean;
+        fixAttempted: boolean;
+        fixApplied: boolean;
+        iterations: number;
+    }[];
+    tokensUsed: number;
+}, {
+    schemaVersion: "1.0";
+    totalDurationMs: number;
+    filesReviewed: number;
+    filesPassed: number;
+    filesFixed: number;
+    filesFailed: number;
+    results: {
+        issues: string[];
+        filePath: string;
+        passed: boolean;
+        fixAttempted: boolean;
+        fixApplied: boolean;
+        iterations: number;
+    }[];
+    tokensUsed: number;
+}>;
+type AiReviewReport = z.infer<typeof AiReviewReport>;
+
+declare function scan(projectRoot?: string): ScanResult;
+
+declare function createPlan(scan: ScanResult): PatchPlan;
+
+interface ApplyOptions {
+    dryRun?: boolean;
+    includeTests?: boolean;
+    maxFiles?: number;
+}
+declare function applyPlan(plan: PatchPlan, opts?: ApplyOptions): Promise<ApplyReport>;
+
+interface VerifyOptions {
+    profile?: VerifyProfile;
+    framework?: FrameworkName;
+    patchedFiles?: string[];
+}
+declare function verify(root: string, opts?: VerifyOptions): VerifyReport;
+
+interface AiReviewOptions {
+    maxIterations?: number;
+    model?: string;
+}
+declare function aiReviewAll(root: string, patchedFiles: string[], plan: PatchPlan, opts?: AiReviewOptions): Promise<AiReviewReport>;
+
+declare const gitOps: {
+    isGitRepo(cwd: string): boolean;
+    isClean(cwd: string): boolean;
+    getCurrentBranch(cwd: string): string | null;
+    getHeadCommit(cwd: string): string | null;
+    createBranch(cwd: string, name: string): boolean;
+    stageAll(cwd: string): void;
+    commit(cwd: string, message: string): string | null;
+    rollbackToCommit(cwd: string, commitHash: string): boolean;
+    getLastCommitByAgent(cwd: string): string | null;
+    getCommitBefore(cwd: string, commitHash: string): string | null;
+    push(cwd: string, remote?: string): boolean;
+};
+
+interface AgentReport {
+    version: '1.0';
+    timestamp: string;
+    scan?: ScanResult;
+    plan?: PatchPlan;
+    apply?: ApplyReport;
+    verify?: VerifyReport;
+    aiReview?: AiReviewReport;
+}
+declare function createReport(parts: Omit<AgentReport, 'version' | 'timestamp'>): AgentReport;
+declare function saveReport(root: string, report: AgentReport): string;
+declare function savePlanFile(root: string, plan: PatchPlan): string;
+declare function loadPlanFile(filePath: string): PatchPlan | null;
+
+/**
+ * Unified engine used by all distribution channels:
+ * - npx CLI (commands call these directly)
+ * - GitHub App (webhook handler calls runFullPipeline)
+ * - Admin panel (API endpoint calls runFullPipeline)
+ *
+ * Every channel uses the same scan -> plan -> apply -> verify pipeline
+ * to guarantee identical results regardless of trigger source.
+ */
+
+interface PipelineOptions {
+    projectRoot: string;
+    dryRun?: boolean;
+    includeTests?: boolean;
+    maxFiles?: number;
+    allowLlmFallback?: boolean;
+    verifyProfile?: VerifyProfile;
+    gitBranch?: boolean;
+    gitCommit?: boolean;
+    savePlan?: boolean;
+    saveReport?: boolean;
+    cmsOverride?: string;
+    paramsOverride?: Record<string, string>;
+    slug?: string;
+    aiVerify?: boolean;
+    aiModel?: string;
+    aiMaxIterations?: number;
+}
+interface PipelineResult {
+    scan: ScanResult;
+    plan: PatchPlan;
+    report: AgentReport;
+    aiReview?: AiReviewReport;
+    planFilePath?: string;
+    reportFilePath?: string;
+}
+declare function runFullPipeline(opts: PipelineOptions): Promise<PipelineResult>;
+
+export { AiFileResult, AiReviewReport, ApplyReport, CmsInfo, CmsType, Confidence, FilePatch, FrameworkInfo, FrameworkName, InjectionCandidate, InjectionType, PackageManager, PatchPlan, PatchedFileReport, type PipelineOptions, type PipelineResult, ScanResult, VerifyProfile, VerifyReport, aiReviewAll, applyPlan, createPlan, createReport, gitOps, loadPlanFile, runFullPipeline, savePlanFile, saveReport, scan, verify };