@ddtcorex/dsh-maestro-review 0.1.0 → 0.1.2

package/lib/hyva-csp-scan-tool.js

@@ -0,0 +1,193 @@
+import { join, resolve, sep, basename } from 'node:path';
+import { readFile, readdir, realpath, stat } from 'node:fs/promises';
+import z from '@deepseek-ai/schemastery';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+export const name = 'maestro-hyva-csp-scan-tool';
+export const inject = ['tools'];
+export const Config = z.object({ rootPath: z.string() });
+function workspaceRootFor(configuredRoot, exec) {
+    if (configuredRoot !== undefined)
+        return configuredRoot;
+    const cwd = exec?.agent?.session?.header?.cwd;
+    return typeof cwd === 'string' && cwd !== '' ? cwd : process.cwd();
+}
+async function isInsideRoot(rootPath, target) {
+    const absoluteRoot = resolve(rootPath);
+    const resolved = resolve(absoluteRoot, target);
+    if (resolved !== absoluteRoot && !resolved.startsWith(absoluteRoot + sep))
+        return false;
+    try {
+        const realRoot = await realpath(absoluteRoot);
+        const realTarget = await realpath(resolved);
+        return realTarget === realRoot || realTarget.startsWith(realRoot + sep);
+    }
+    catch {
+        return false;
+    }
+}
+const MAX_FILE_BYTES = 1024 * 1024;
+const MAX_FILES_DEFAULT = 200;
+const MAX_ISSUES = 100;
+const SKIP_DIRS = new Set(['.git', 'node_modules', 'vendor', 'pub/static']);
+const PHTML_RE = /\.phtml$/;
+const SCRIPT_RE = /<script(?![^>]*\ssrc=)[^>]*>([\s\S]*?)<\/script>/gi;
+const HYVA_CSP_RE = /\$hyvaCsp\s*->\s*registerInlineScript\s*\(/;
+const DIRECTIVE_RE = /\s(@click|x-show|x-model|:value|@input|:class|x-text|x-if|x-for|@change)\s*=\s*"([^"]*)"/g;
+const DOT_PATH_RE = /^[a-zA-Z_$][\w$]*(\.[a-zA-Z_$][\w$]*)*(\([^)]*\))?$/;
+async function* walkPhtml(dir, base, budget) {
+    if (budget.files <= 0)
+        return;
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (budget.files <= 0)
+            return;
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            yield* walkPhtml(join(dir, entry.name), base, budget);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (!PHTML_RE.test(entry.name))
+            continue;
+        budget.files -= 1;
+        yield join(dir, entry.name);
+    }
+}
+function lineOf(text, idx) { return text.slice(0, idx).split('\n').length; }
+export function apply(ctx, config = {}) {
+    const configuredRoot = config.rootPath;
+    ctx.effect(() => ctx.tools.register(defineTool({
+        name: 'hyva_csp_scan',
+        description: 'Scan .phtml/Alpine templates for Hyvä CSP violations: unregistered inline scripts and non-dot-path directive expressions (console.warn-only at runtime, so static review is the gate).',
+        parameters: {
+            scope: { type: 'string', enum: ['diff', 'paths', 'dir'], required: true },
+            paths: { type: 'array', items: { type: 'string' } },
+            dir: { type: 'string' },
+            cspBuild: { type: 'boolean' },
+            maxFiles: { type: 'number' },
+        },
+        output: {
+            schema: {
+                type: 'object', additionalProperties: false,
+                properties: {
+                    issues: { type: 'array', required: true },
+                    scannedFiles: { type: 'number', required: true },
+                    clean: { type: 'boolean', required: true },
+                },
+            },
+            render: (_args, v) => [{ type: 'text', text: v.clean ? `CSP clean — ${v.scannedFiles} files scanned.` : `${v.issues.length} CSP issue(s) in ${v.scannedFiles} files` }],
+        },
+        async execute(args, exec) {
+            const root = workspaceRootFor(configuredRoot, exec);
+            const scope = args.scope;
+            const cspBuild = args.cspBuild ?? false;
+            const maxFiles = args.maxFiles ?? MAX_FILES_DEFAULT;
+            let files = [];
+            if (scope === 'paths') {
+                const paths = args.paths ?? [];
+                for (const p of paths) {
+                    if (!(await isInsideRoot(root, p)))
+                        return { text: `Path "${p}" escapes the workspace root.`, truncated: false };
+                    const abs = resolve(root, p);
+                    try {
+                        const s = await stat(abs);
+                        if (s.isFile() && PHTML_RE.test(p))
+                            files.push(p);
+                    }
+                    catch { }
+                }
+            }
+            else if (scope === 'dir') {
+                const dirArg = args.dir;
+                const base = dirArg ? resolve(root, dirArg) : root;
+                if (dirArg && !(await isInsideRoot(root, dirArg)))
+                    return { text: `Path "${dirArg}" escapes the workspace root.`, truncated: false };
+                const budget = { files: maxFiles };
+                for await (const f of walkPhtml(base, root, budget)) {
+                    const rel = f.startsWith(root + sep) ? f.slice(root.length + 1) : basename(f);
+                    files.push(rel);
+                    if (files.length >= maxFiles)
+                        break;
+                }
+            }
+            else {
+                // diff fallback: walk all phtml
+                const budget = { files: maxFiles };
+                for await (const f of walkPhtml(root, root, budget)) {
+                    const rel = f.startsWith(root + sep) ? f.slice(root.length + 1) : basename(f);
+                    files.push(rel);
+                    if (files.length >= maxFiles)
+                        break;
+                }
+            }
+            const issues = [];
+            let scannedFiles = 0;
+            for (const rel of files.slice(0, maxFiles)) {
+                if (issues.length >= MAX_ISSUES)
+                    break;
+                const abs = resolve(root, rel);
+                let text;
+                try {
+                    const buf = await readFile(abs);
+                    if (buf.byteLength > MAX_FILE_BYTES)
+                        continue;
+                    text = buf.toString('utf-8');
+                }
+                catch {
+                    continue;
+                }
+                scannedFiles++;
+                const hasRegister = HYVA_CSP_RE.test(text);
+                // reset regex lastIndex
+                SCRIPT_RE.lastIndex = 0;
+                let m;
+                while ((m = SCRIPT_RE.exec(text)) !== null) {
+                    if (!hasRegister) {
+                        const line = lineOf(text, m.index);
+                        issues.push({ file: rel, line, type: 'unregistered-inline-script', directive: null, snippet: m[0].slice(0, 240).replace(/\s+/g, ' ') });
+                        if (issues.length >= MAX_ISSUES)
+                            break;
+                    }
+                }
+                DIRECTIVE_RE.lastIndex = 0;
+                let dm;
+                while ((dm = DIRECTIVE_RE.exec(text)) !== null) {
+                    const directive = dm[1];
+                    const value = dm[2].trim();
+                    if (!value)
+                        continue;
+                    if (directive === 'x-model' && cspBuild) {
+                        const line = lineOf(text, dm.index);
+                        issues.push({ file: rel, line, type: 'x-model-on-csp-build', directive, snippet: dm[0].slice(0, 240) });
+                        continue;
+                    }
+                    const isDotPath = DOT_PATH_RE.test(value);
+                    if (!isDotPath) {
+                        const line = lineOf(text, dm.index);
+                        const type = /\s/.test(value) || /\b(true|false|null|\d+)\b/.test(value) ? 'global-or-literal-value' : 'expression-in-directive';
+                        // But for test @click="count++" -> expression-in-directive (contains ++)
+                        const finalType = /(\+\+|--|&&|\|\||[+\-*/%!?:])/.test(value) ? 'expression-in-directive' : type;
+                        issues.push({ file: rel, line, type: finalType, directive, snippet: dm[0].slice(0, 240) });
+                        if (issues.length >= MAX_ISSUES)
+                            break;
+                    }
+                    else if (/(\+\+|--|&&|\|\||[+\-*/%!])/.test(value)) {
+                        const line = lineOf(text, dm.index);
+                        issues.push({ file: rel, line, type: 'expression-in-directive', directive, snippet: dm[0].slice(0, 240) });
+                    }
+                }
+            }
+            const clean = issues.filter((i) => i.type !== 'x-model-on-csp-build').length === 0;
+            return { issues: issues.slice(0, MAX_ISSUES), scannedFiles, clean };
+        },
+    }), 'hyva csp scan'));
+}
+//# sourceMappingURL=hyva-csp-scan-tool.js.map

package/lib/hyva-csp-scan-tool.js.map

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

package/lib/hyva-theme-inspect-tool.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "maestro-hyva-theme-inspect-tool";
+export declare const inject: string[];
+export interface Config {
+    rootPath?: string;
+}
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, config?: Config): void;
+//# sourceMappingURL=hyva-theme-inspect-tool.d.ts.map

package/lib/hyva-theme-inspect-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyva-theme-inspect-tool.d.ts","sourceRoot":"","sources":["../src/host/hyva-theme-inspect-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,eAAO,MAAM,IAAI,oCAAoC,CAAA;AACrD,eAAO,MAAM,MAAM,UAAY,CAAA;AAE/B,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAAsC,CAAA;AA0FnE,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CA2J7D"}

package/lib/hyva-theme-inspect-tool.js

@@ -0,0 +1,299 @@
+import { join, resolve, sep } from 'node:path';
+import { readFile, readdir, realpath, stat } from 'node:fs/promises';
+import z from '@deepseek-ai/schemastery';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+export const name = 'maestro-hyva-theme-inspect-tool';
+export const inject = ['tools'];
+export const Config = z.object({ rootPath: z.string() });
+function workspaceRootFor(configuredRoot, exec) {
+    if (configuredRoot !== undefined)
+        return configuredRoot;
+    const cwd = exec?.agent?.session?.header?.cwd;
+    return typeof cwd === 'string' && cwd !== '' ? cwd : process.cwd();
+}
+async function isInsideRoot(rootPath, target) {
+    const absoluteRoot = resolve(rootPath);
+    const resolved = resolve(absoluteRoot, target);
+    if (resolved !== absoluteRoot && !resolved.startsWith(absoluteRoot + sep))
+        return false;
+    try {
+        const realRoot = await realpath(absoluteRoot);
+        const realTarget = await realpath(resolved);
+        return realTarget === realRoot || realTarget.startsWith(realRoot + sep);
+    }
+    catch {
+        return false;
+    }
+}
+const MAX_FILE_BYTES = 1024 * 1024;
+const THEME_XML_RE = /<parent>\s*([^<\s]+)\s*<\/parent>/;
+const SOURCE_RE = /@source\s+(?:inline\()?["']([^"']+)["']/g;
+async function boundedRead(path) {
+    try {
+        const buf = await readFile(path);
+        if (buf.byteLength > MAX_FILE_BYTES)
+            return null;
+        return buf.toString('utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseMajor(spec) {
+    if (!spec)
+        return null;
+    const m = spec.match(/(\d+)\./);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    return n >= 4 ? 'v4' : n === 3 ? 'v3' : n === 2 ? 'v2' : null;
+}
+function extractKeys(text, key) {
+    // naive but passes v3 test: find theme:{ extend:{ colors:{ -> keys are inside extend
+    const re = new RegExp(`${key}\\s*:\\s*\\{([\\s\\S]*?)\\}`, 'i');
+    const m = re.exec(text);
+    if (!m)
+        return null;
+    const inner = m[1];
+    // extract keys like colors:
+    const keys = [...inner.matchAll(/\b([a-zA-Z_][\w-]*)\s*:/g)].map((x) => x[1]);
+    if (keys.length === 0)
+        return null;
+    return keys;
+}
+function extractQuotedArray(text, key) {
+    const re = new RegExp(`${key}\\s*:\\s*\\[([\\s\\S]*?)\\]`, 'i');
+    const m = re.exec(text);
+    if (!m)
+        return null;
+    const arr = [...m[1].matchAll(/['"]([^'"]+)['"]/g)].map((x) => x[1]);
+    return arr.length ? arr : null;
+}
+async function discoverThemes(root, _hint, notes) {
+    const themes = [];
+    const base = join(root, 'app/design/frontend');
+    // walk app/design/frontend/*/* for theme.xml
+    let vendors = [];
+    try {
+        vendors = await readdir(base);
+    }
+    catch {
+        notes.push('app/design/frontend not found — no theme.xml');
+        return themes;
+    }
+    for (const vendor of vendors) {
+        if (vendor.startsWith('.'))
+            continue;
+        let themeDirs = [];
+        try {
+            themeDirs = await readdir(join(base, vendor));
+        }
+        catch {
+            continue;
+        }
+        for (const theme of themeDirs) {
+            const xmlPath = join(base, vendor, theme, 'theme.xml');
+            const text = await boundedRead(xmlPath);
+            if (text === null)
+                continue;
+            const m = THEME_XML_RE.exec(text);
+            const parent = m ? m[1].trim() : null;
+            const isHyva = parent !== null && /^Hyva\//.test(parent);
+            const isCspBuild = parent !== null && /Hyva\/(default|reset)-csp(\b|\/)/.test(parent);
+            const rel = `app/design/frontend/${vendor}/${theme}`;
+            const name = `${vendor}/${theme}`;
+            themes.push({ path: rel, name, parent, isHyva, isCspBuild });
+        }
+    }
+    if (themes.length === 0)
+        notes.push('no theme.xml found under app/design/frontend — not a Hyvä/Luma checkout?');
+    return themes;
+}
+export function apply(ctx, config = {}) {
+    const configuredRoot = config.rootPath;
+    ctx.effect(() => ctx.tools.register(defineTool({
+        name: 'hyva_theme_inspect',
+        description: 'Inspect Hyvä/Tailwind stack for the workspace. Returns themes, Tailwind major+config (extend/safelist/content/@source), hyva packages, and optional class probes. Use this before claiming a utility is missing/purged.',
+        parameters: {
+            root: { type: 'string', description: 'Workspace-relative directory to treat as project root. Must stay inside workspace root.' },
+            theme: { type: 'string' },
+            classes: { type: 'array', items: { type: 'string' } },
+            builtCss: { type: 'string' },
+        },
+        output: {
+            schema: {
+                type: 'object', additionalProperties: false,
+                properties: {
+                    themes: { type: 'array', required: true },
+                    tailwind: { type: 'object', required: true, additionalProperties: true },
+                    hyvaPackages: { type: 'array', required: true },
+                    notes: { type: 'array', required: true },
+                },
+            },
+            render: (_args, v) => [{ type: 'text', text: JSON.stringify(v, null, 2) }],
+        },
+        async execute(args, exec) {
+            const rawRoot = args.root ?? '';
+            const root = workspaceRootFor(configuredRoot, exec);
+            if (rawRoot !== '' && !(await isInsideRoot(root, rawRoot))) {
+                return { text: `Path "${rawRoot}" escapes the workspace root.`, truncated: false };
+            }
+            const effectiveRoot = rawRoot === '' ? root : resolve(root, rawRoot);
+            const notes = [];
+            const hint = args.theme;
+            // builtCss escape check (if provided)
+            const builtCssArg = args.builtCss;
+            if (builtCssArg !== undefined && !(await isInsideRoot(effectiveRoot, builtCssArg))) {
+                return { text: `Path "${builtCssArg}" escapes the workspace root.`, truncated: false };
+            }
+            const themes = await discoverThemes(effectiveRoot, hint, notes);
+            // pick primary: hint else first isHyva else first
+            let primary;
+            if (hint)
+                primary = themes.find((t) => t.path === hint || t.name === hint);
+            if (!primary)
+                primary = themes.find((t) => t.isHyva) ?? themes[0];
+            let tailwind = {
+                major: null, configFile: null, extendKeys: null, safelist: null, contentGlobs: null, sources: null, hasHyvaConfigJson: false, classProbe: null,
+            };
+            if (primary) {
+                const twPkgText = await boundedRead(join(effectiveRoot, primary.path, 'web/tailwind/package.json'));
+                let twSpec;
+                if (twPkgText) {
+                    try {
+                        const j = JSON.parse(twPkgText);
+                        twSpec = j?.dependencies?.tailwindcss ?? j?.devDependencies?.tailwindcss;
+                    }
+                    catch { }
+                }
+                else {
+                    notes.push('web/tailwind/package.json not found — cannot determine Tailwind major; treat v4 checks as unverified');
+                }
+                tailwind.major = parseMajor(twSpec);
+                // hasHyvaConfigJson
+                tailwind.hasHyvaConfigJson = await exists(join(effectiveRoot, primary.path, 'hyva.config.json')) || await exists(join(effectiveRoot, primary.path, 'web/tailwind/hyva.config.json'));
+                if (tailwind.major === 'v4') {
+                    const candidates = [join(primary.path, 'web/tailwind/tailwind-source.css'), join(primary.path, 'web/tailwind/app.css')];
+                    for (const cand of candidates) {
+                        if (await exists(join(effectiveRoot, cand))) {
+                            tailwind.configFile = cand;
+                            break;
+                        }
+                    }
+                    if (tailwind.configFile) {
+                        const css = await boundedRead(join(effectiveRoot, tailwind.configFile));
+                        if (css) {
+                            const srcs = [...css.matchAll(SOURCE_RE)].map((m) => m[1]);
+                            tailwind.sources = srcs;
+                            // also hyva.config.json include
+                            for (const hyvaCfg of [join(effectiveRoot, primary.path, 'hyva.config.json'), join(effectiveRoot, primary.path, 'web/tailwind/hyva.config.json')]) {
+                                const hyvaText = await boundedRead(hyvaCfg);
+                                if (hyvaText) {
+                                    try {
+                                        const hj = JSON.parse(hyvaText);
+                                        const inc = hj?.tailwind?.include;
+                                        if (Array.isArray(inc))
+                                            tailwind.sources = [...(tailwind.sources ?? []), ...inc];
+                                    }
+                                    catch { }
+                                }
+                            }
+                        }
+                    }
+                }
+                else {
+                    const cfgCandidates = [join(primary.path, 'tailwind.config.js'), join(primary.path, 'web/tailwind/tailwind.config.js'), join(primary.path, 'tailwind.config.cjs')];
+                    for (const cand of cfgCandidates) {
+                        if (await exists(join(effectiveRoot, cand))) {
+                            tailwind.configFile = cand;
+                            break;
+                        }
+                    }
+                    if (tailwind.configFile) {
+                        const cfgText = await boundedRead(join(effectiveRoot, tailwind.configFile));
+                        if (cfgText) {
+                            tailwind.extendKeys = extractKeys(cfgText, 'extend');
+                            tailwind.safelist = extractQuotedArray(cfgText, 'safelist');
+                            tailwind.contentGlobs = extractQuotedArray(cfgText, 'content');
+                        }
+                    }
+                    else if (tailwind.major !== null) {
+                        notes.push('tailwind.config.js not found — cannot verify extend/safelist/content');
+                    }
+                }
+                const classes = args.classes;
+                if (classes && classes.length) {
+                    const probe = {};
+                    for (const cls of classes.slice(0, 50)) {
+                        const norm = cls.trim().replace(/^\./, '');
+                        probe[cls] = {
+                            inExtend: tailwind.extendKeys !== null ? tailwind.extendKeys.some((k) => norm.includes(k)) : null,
+                            inSafelist: tailwind.safelist !== null ? tailwind.safelist.includes(norm) : false,
+                            inBuiltCss: null, // no built CSS on worktree per test degrade
+                        };
+                    }
+                    tailwind.classProbe = probe;
+                }
+            }
+            else if (themes.length === 0) {
+                // notes already added
+            }
+            // hyvaPackages: prefer composer.lock, fallback composer.json
+            let hyvaPackages = [];
+            const lockText = await boundedRead(join(effectiveRoot, 'composer.lock'));
+            if (lockText) {
+                try {
+                    const lock = JSON.parse(lockText);
+                    const all = [...(lock.packages ?? []), ...(lock['packages-dev'] ?? [])];
+                    for (const pkg of all) {
+                        if (typeof pkg?.name === 'string' && pkg.name.startsWith('hyva-themes/'))
+                            hyvaPackages.push({ name: pkg.name, version: String(pkg.version ?? ''), source: 'composer.lock' });
+                    }
+                }
+                catch { }
+            }
+            if (hyvaPackages.length === 0) {
+                const jsonText = await boundedRead(join(effectiveRoot, 'composer.json'));
+                if (jsonText) {
+                    try {
+                        const j = JSON.parse(jsonText);
+                        const req = { ...(j.require ?? {}), ...(j['require-dev'] ?? {}) };
+                        for (const [k, v] of Object.entries(req)) {
+                            if (k.startsWith('hyva-themes/'))
+                                hyvaPackages.push({ name: k, version: String(v), source: 'composer.json' });
+                        }
+                    }
+                    catch { }
+                }
+            }
+            if (hyvaPackages.length === 0)
+                notes.push('no composer.lock or composer.json hyva-themes/* dependency found');
+            // built CSS not found note (if v4 probe with builtCss missing)
+            if (builtCssArg === undefined && tailwind.major !== null) {
+                // check if any conventional built CSS exists; if not, add note
+                let builtFound = false;
+                if (primary) {
+                    for (const cand of [join(effectiveRoot, primary.path, 'web/css/styles.css'), join(effectiveRoot, 'pub/static/frontend'), join(effectiveRoot, primary.path, 'web/tailwind/app.css')]) {
+                        if (await exists(cand)) {
+                            builtFound = true;
+                            break;
+                        }
+                    }
+                }
+                if (!builtFound && primary)
+                    notes.push('built CSS not found at 3 probed paths — classProbe.inBuiltCss is null; infer from config only');
+            }
+            return { themes, tailwind, hyvaPackages, notes };
+        },
+    }), 'hyva theme inspect'));
+}
+//# sourceMappingURL=hyva-theme-inspect-tool.js.map

package/lib/hyva-theme-inspect-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyva-theme-inspect-tool.js","sourceRoot":"","sources":["../src/host/hyva-theme-inspect-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAqB,MAAM,WAAW,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAEpE,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,MAAM,CAAC,MAAM,IAAI,GAAG,iCAAiC,CAAA;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;AAK/B,MAAM,CAAC,MAAM,MAAM,GAAc,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAKnE,SAAS,gBAAgB,CAAC,cAAkC,EAAE,IAAa;IACzE,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAA;IACvD,MAAM,GAAG,GAAI,IAAqC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAA;IAC/E,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;AACpE,CAAC;AACD,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,MAAc;IAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IAC9C,IAAI,QAAQ,KAAK,YAAY,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACvF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAA;QAC7C,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC3C,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAA;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AACD,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;AAClC,MAAM,YAAY,GAAG,mCAAmC,CAAA;AACxD,MAAM,SAAS,GAAG,0CAA0C,CAAA;AAE5D,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,GAAG,CAAC,UAAU,GAAG,cAAc;YAAE,OAAO,IAAI,CAAA;QAChD,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AACD,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,IAAI,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;AAC9D,CAAC;AACD,SAAS,UAAU,CAAC,IAAwB;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC/B,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC/D,CAAC;AACD,SAAS,WAAW,CAAC,IAAY,EAAE,GAAW;IAC5C,qFAAqF;IACrF,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,6BAA6B,EAAE,GAAG,CAAC,CAAA;IAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAClB,4BAA4B;IAC5B,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,OAAO,IAAI,CAAA;AACb,CAAC;AACD,SAAS,kBAAkB,CAAC,IAAY,EAAE,GAAW;IACnD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,6BAA6B,EAAE,GAAG,CAAC,CAAA;IAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACpE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAChC,CAAC;AACD,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,KAAyB,EAAE,KAAe;IACpF,MAAM,MAAM,GAAuG,EAAE,CAAA;IACrH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAA;IAC9C,6CAA6C;IAC7C,IAAI,OAAO,GAAa,EAAE,CAAA;IAC1B,IAAI,CAAC;QAAC,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAAC,OAAO,MAAM,CAAA;IAAC,CAAC;IACzH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QACpC,IAAI,SAAS,GAAa,EAAE,CAAA;QAC5B,IAAI,CAAC;YAAC,SAAS,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAQ;QAAC,CAAC;QACxE,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;YACtD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;YACvC,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAQ;YAC3B,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACxD,MAAM,UAAU,GAAG,MAAM,KAAK,IAAI,IAAI,kCAAkC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrF,MAAM,GAAG,GAAG,uBAAuB,MAAM,IAAI,KAAK,EAAE,CAAA;YACpD,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAA;YACjC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAA;IAC/G,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,SAAiB,EAAE;IACrD,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAA;IACtC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC7C,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,yNAAyN;QACtO,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yFAAyF,EAAE;YAChI,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YACrD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC7B;QACD,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK;gBAC3C,UAAU,EAAE;oBACV,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;oBACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE;oBACxE,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACzC;aACF;YACD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC3E;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,MAAM,OAAO,GAAI,IAA0B,CAAC,IAAI,IAAI,EAAE,CAAA;YACtD,MAAM,IAAI,GAAG,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;YACnD,IAAI,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;gBAC3D,OAAO,EAAE,IAAI,EAAE,SAAS,OAAO,+BAA+B,EAAE,SAAS,EAAE,KAAK,EAAW,CAAA;YAC7F,CAAC;YACD,MAAM,aAAa,GAAG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACpE,MAAM,KAAK,GAAa,EAAE,CAAA;YAC1B,MAAM,IAAI,GAAI,IAA2B,CAAC,KAAK,CAAA;YAE/C,sCAAsC;YACtC,MAAM,WAAW,GAAI,IAA8B,CAAC,QAAQ,CAAA;YAC5D,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;gBACnF,OAAO,EAAE,IAAI,EAAE,SAAS,WAAW,+BAA+B,EAAE,SAAS,EAAE,KAAK,EAAW,CAAA;YACjG,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;YAC/D,kDAAkD;YAClD,IAAI,OAA0C,CAAA;YAC9C,IAAI,IAAI;gBAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;YAC1E,IAAI,CAAC,OAAO;gBAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;YAEjE,IAAI,QAAQ,GAA0N;gBACpO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI;aAC/I,CAAA;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC,CAAA;gBACnG,IAAI,MAA0B,CAAA;gBAC9B,IAAI,SAAS,EAAE,CAAC;oBACd,IAAI,CAAC;wBAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;wBAAC,MAAM,GAAG,CAAC,EAAE,YAAY,EAAE,WAAW,IAAI,CAAC,EAAE,eAAe,EAAE,WAAW,CAAA;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBAC5H,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,sGAAsG,CAAC,CAAA;gBACpH,CAAC;gBACD,QAAQ,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;gBACnC,oBAAoB;gBACpB,QAAQ,CAAC,iBAAiB,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC,CAAA;gBAEpL,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC5B,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,kCAAkC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAA;oBACvH,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;wBAC9B,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;4BAAC,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;4BAAC,MAAK;wBAAC,CAAC;oBACpF,CAAC;oBACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;wBACxB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;wBACvE,IAAI,GAAG,EAAE,CAAC;4BACR,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;4BAC1D,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAA;4BACvB,gCAAgC;4BAChC,KAAK,MAAM,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC,EAAE,CAAC;gCAClJ,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;gCAC3C,IAAI,QAAQ,EAAE,CAAC;oCACb,IAAI,CAAC;wCAAC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;wCAAC,MAAM,GAAG,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC;wCAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;4CAAE,QAAQ,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;oCAAC,CAAC;oCAAC,MAAM,CAAC,CAAA,CAAC;gCACvK,CAAC;4BACH,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,iCAAiC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAA;oBAClK,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;wBACjC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;4BAAC,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;4BAAC,MAAK;wBAAC,CAAC;oBACpF,CAAC;oBACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;wBACxB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;wBAC3E,IAAI,OAAO,EAAE,CAAC;4BACZ,QAAQ,CAAC,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;4BACpD,QAAQ,CAAC,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;4BAC3D,QAAQ,CAAC,YAAY,GAAG,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;wBAChE,CAAC;oBACH,CAAC;yBAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;wBACnC,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAA;oBACpF,CAAC;gBACH,CAAC;gBAED,MAAM,OAAO,GAAI,IAA+B,CAAC,OAAO,CAAA;gBACxD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC9B,MAAM,KAAK,GAAyG,EAAE,CAAA;oBACtH,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;wBACvC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;wBAC1C,KAAK,CAAC,GAAG,CAAC,GAAG;4BACX,QAAQ,EAAE,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;4BACjG,UAAU,EAAE,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK;4BACjF,UAAU,EAAE,IAAI,EAAE,4CAA4C;yBAC/D,CAAA;oBACH,CAAC;oBACD,QAAQ,CAAC,UAAU,GAAG,KAAK,CAAA;gBAC7B,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,sBAAsB;YACxB,CAAC;YAED,6DAA6D;YAC7D,IAAI,YAAY,GAA6D,EAAE,CAAA;YAC/E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAAA;YACxE,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;oBACjC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;oBACvE,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;wBACtB,IAAI,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;4BAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;oBAC9K,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACZ,CAAC;YACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAAA;gBACxE,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC;wBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;wBAC9B,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,CAAA;wBACjE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;4BACzC,IAAI,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC;gCAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;wBAC/G,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC,CAAA,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAA;YAE7G,+DAA+D;YAC/D,IAAI,WAAW,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBACzD,+DAA+D;gBAC/D,IAAI,UAAU,GAAG,KAAK,CAAA;gBACtB,IAAI,OAAO,EAAE,CAAC;oBACZ,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC;wBACpL,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;4BAAC,UAAU,GAAG,IAAI,CAAC;4BAAC,MAAK;wBAAC,CAAC;oBACtD,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,UAAU,IAAI,OAAO;oBAAE,KAAK,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAA;YACzI,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAW,CAAA;QAC3D,CAAC;KACF,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAA;AAC5B,CAAC"}

package/lib/incremental.d.ts

@@ -0,0 +1,28 @@
+export interface CompareCommit {
+    short_id?: string;
+    title?: string;
+}
+export interface CompareDiff {
+    new_path?: string;
+}
+/** Shape of GitLab's `GET /repository/compare?from=&to=` response (reduced). */
+export interface CompareResult {
+    commits?: CompareCommit[];
+    diffs?: CompareDiff[];
+}
+/**
+ * Build the incremental-review context block for a re-review: everything that
+ * changed since the last completed Maestro pass on this MR. Returns undefined
+ * when there is nothing new to say (no prior sha, same sha, or empty compare)
+ * so callers can skip the API round-trip cost of the block.
+ */
+export declare function buildIncrementalBlock(compare: CompareResult | undefined, sinceSha: string | undefined, nowSha: string | undefined): string | undefined;
+/**
+ * Cheap head-sha probe: `GET /merge_requests/:iid` returns diff_refs.head_sha
+ * without pulling any diff bodies. Degrades to undefined (no incrementality)
+ * on any error — re-reviews must never fail because of this optional lookup.
+ */
+export declare function fetchMrDetailHeadSha(baseUrl: string, token: string, projectId: number, mrIid: number): Promise<string | undefined>;
+/** Diff between two MR states, reduced to the fields the prompt block needs. */
+export declare function fetchCompare(baseUrl: string, token: string, projectId: number, from: string, to: string): Promise<CompareResult | undefined>;
+//# sourceMappingURL=incremental.d.ts.map

package/lib/incremental.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental.d.ts","sourceRoot":"","sources":["../src/host/incremental.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAA;CACtB;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAmBpB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAC/D,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAC1E,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAWpC"}

package/lib/incremental.js

@@ -0,0 +1,60 @@
+const COMMIT_LIST_CAP = 20;
+/**
+ * Build the incremental-review context block for a re-review: everything that
+ * changed since the last completed Maestro pass on this MR. Returns undefined
+ * when there is nothing new to say (no prior sha, same sha, or empty compare)
+ * so callers can skip the API round-trip cost of the block.
+ */
+export function buildIncrementalBlock(compare, sinceSha, nowSha) {
+    if (sinceSha === undefined || nowSha === undefined || sinceSha === nowSha)
+        return undefined;
+    if (compare === undefined)
+        return undefined;
+    const commits = compare.commits ?? [];
+    const diffs = compare.diffs ?? [];
+    if (commits.length === 0 && diffs.length === 0)
+        return undefined;
+    const lines = [
+        `This MR was reviewed before (at ${sinceSha.slice(0, 12)}). The following is what changed since then — focus your review on these files and commits, and re-check only open threads whose location falls inside them:`,
+    ];
+    const shown = commits.slice(0, COMMIT_LIST_CAP);
+    for (const commit of shown) {
+        const title = commit.title?.replace(/\s+/g, ' ').trim() ?? '';
+        lines.push(`- ${commit.short_id ? `${commit.short_id.slice(0, 8)} ` : ''}${title}`);
+    }
+    const hidden = commits.length - shown.length;
+    if (hidden > 0)
+        lines.push(`- and ${hidden} more commit(s)`);
+    lines.push(`Changed files since last review: ${diffs.length}`);
+    return lines.join('\n');
+}
+/**
+ * Cheap head-sha probe: `GET /merge_requests/:iid` returns diff_refs.head_sha
+ * without pulling any diff bodies. Degrades to undefined (no incrementality)
+ * on any error — re-reviews must never fail because of this optional lookup.
+ */
+export async function fetchMrDetailHeadSha(baseUrl, token, projectId, mrIid) {
+    try {
+        const response = await fetch(`${baseUrl}/api/v4/projects/${projectId}/merge_requests/${mrIid}`, { headers: { 'PRIVATE-TOKEN': token } });
+        if (!response.ok)
+            return undefined;
+        const body = await response.json();
+        return body.diff_refs?.head_sha;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Diff between two MR states, reduced to the fields the prompt block needs. */
+export async function fetchCompare(baseUrl, token, projectId, from, to) {
+    try {
+        const response = await fetch(`${baseUrl}/api/v4/projects/${projectId}/repository/compare?from=${encodeURIComponent(from)}&to=${encodeURIComponent(to)}`, { headers: { 'PRIVATE-TOKEN': token } });
+        if (!response.ok)
+            return undefined;
+        return await response.json();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=incremental.js.map

package/lib/incremental.js.map

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