@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/detect-custom-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-custom-files.d.ts","sourceRoot":"","sources":["../../src/query/detect-custom-files.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyB/C;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,YA0D/B,CAAC"}

package/sdk/dist/query/detect-custom-files.js

@@ -0,0 +1,89 @@
+/**
+ * Detect user-added files under GSD-managed install dirs not listed in the manifest.
+ *
+ * Port of `detect-custom-files` from `get-shit-done/bin/gsd-tools.cjs` (lines 1161–1239).
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+const GSD_MANAGED_DIRS = [
+    'get-shit-done',
+    'agents',
+    join('commands', 'gsd'),
+    'hooks',
+    'skills',
+];
+function walkDir(dir, baseDir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...walkDir(fullPath, baseDir));
+        }
+        else {
+            const relPath = relative(baseDir, fullPath).split('\\').join('/');
+            results.push(relPath);
+        }
+    }
+    return results;
+}
+/**
+ * Args: `--config-dir <path>` (required) — runtime config directory to scan.
+ */
+export const detectCustomFiles = async (args) => {
+    const configDirIdx = args.indexOf('--config-dir');
+    const configDir = configDirIdx !== -1 ? args[configDirIdx + 1] : null;
+    if (!configDir) {
+        return { data: { error: 'Usage: detect-custom-files --config-dir <path>' } };
+    }
+    const resolvedConfigDir = resolve(configDir);
+    if (!existsSync(resolvedConfigDir)) {
+        return { data: { error: `Config directory not found: ${resolvedConfigDir}` } };
+    }
+    const manifestPath = join(resolvedConfigDir, 'gsd-file-manifest.json');
+    if (!existsSync(manifestPath)) {
+        return {
+            data: {
+                custom_files: [],
+                custom_count: 0,
+                manifest_found: false,
+            },
+        };
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        return {
+            data: {
+                custom_files: [],
+                custom_count: 0,
+                manifest_found: false,
+                error: 'manifest parse error',
+            },
+        };
+    }
+    const manifestKeys = new Set(Object.keys(manifest.files || {}));
+    const customFiles = [];
+    for (const managedDir of GSD_MANAGED_DIRS) {
+        const absDir = join(resolvedConfigDir, managedDir);
+        if (!existsSync(absDir))
+            continue;
+        for (const relPath of walkDir(absDir, resolvedConfigDir)) {
+            if (!manifestKeys.has(relPath)) {
+                customFiles.push(relPath);
+            }
+        }
+    }
+    return {
+        data: {
+            custom_files: customFiles,
+            custom_count: customFiles.length,
+            manifest_found: true,
+            manifest_version: manifest.version ?? null,
+        },
+    };
+};
+//# sourceMappingURL=detect-custom-files.js.map

package/sdk/dist/query/detect-custom-files.js.map

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

package/sdk/dist/query/detect-phase-type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Phase type detection (`detect.phase-type`).
+ *
+ * Replaces fragile grep-based UI/schema/API detection in workflows with a
+ * structured query. See `.planning/research/decision-routing-audit.md` §3.6.
+ */
+import type { QueryHandler } from './utils.js';
+export declare const detectPhaseType: QueryHandler;
+//# sourceMappingURL=detect-phase-type.d.ts.map

package/sdk/dist/query/detect-phase-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-phase-type.d.ts","sourceRoot":"","sources":["../../src/query/detect-phase-type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB/C,eAAO,MAAM,eAAe,EAAE,YAwG7B,CAAC"}

package/sdk/dist/query/detect-phase-type.js

@@ -0,0 +1,124 @@
+/**
+ * Phase type detection (`detect.phase-type`).
+ *
+ * Replaces fragile grep-based UI/schema/API detection in workflows with a
+ * structured query. See `.planning/research/decision-routing-audit.md` §3.6.
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { GSDError, ErrorClassification } from '../errors.js';
+import { escapeRegex, normalizePhaseName, planningPaths } from './helpers.js';
+import { findPhase } from './phase.js';
+import { detectSchemaFiles } from './schema-detect.js';
+// Copied from phase-ready.ts — do not import to avoid cross-module coupling.
+const UI_INDICATOR_RE = /UI|interface|frontend|component|layout|page|screen|view|form|dashboard|widget/i;
+const API_INDICATOR_RE = /route\.ts|controller\.|api\//i;
+const API_HEADING_RE = /\bAPI\b|endpoint|REST|GraphQL/i;
+const INFRA_RE = /docker|terraform|k8s|helm|infra/i;
+async function roadmapHeadingForPhase(projectDir, phaseNum, workstream) {
+    const roadmapPath = planningPaths(projectDir, workstream).roadmap;
+    let content;
+    try {
+        content = await readFile(roadmapPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const re = new RegExp(`#{2,4}\\s*Phase\\s+${escapeRegex(phaseNum)}\\s*:[^\\n]*`, 'i');
+    const m = content.match(re);
+    return m ? m[0] : null;
+}
+export const detectPhaseType = async (args, projectDir, workstream) => {
+    const raw = args[0];
+    if (!raw) {
+        throw new GSDError('phase number required for detect phase-type', ErrorClassification.Validation);
+    }
+    const phaseArg = normalizePhaseName(raw);
+    const phaseRes = await findPhase([raw], projectDir, workstream);
+    const pdata = phaseRes.data;
+    const found = Boolean(pdata.found);
+    // Build phase dir absolute path when found
+    let phaseDirFull = null;
+    if (found && pdata.directory) {
+        phaseDirFull = join(projectDir, pdata.directory);
+    }
+    const phaseNumForRoadmap = pdata.phase_number || phaseArg;
+    // Read ROADMAP heading — try both normalized forms
+    let heading = await roadmapHeadingForPhase(projectDir, phaseNumForRoadmap, workstream);
+    if (!heading && phaseNumForRoadmap !== phaseArg) {
+        heading = await roadmapHeadingForPhase(projectDir, phaseArg, workstream);
+    }
+    // Frontend detection
+    const headingUiMatch = heading ? UI_INDICATOR_RE.test(heading) : false;
+    const frontendIndicators = [];
+    if (heading && headingUiMatch) {
+        // Collect matched keywords from heading
+        const keywords = ['UI', 'interface', 'frontend', 'component', 'layout', 'page', 'screen', 'view', 'form', 'dashboard', 'widget'];
+        for (const kw of keywords) {
+            if (new RegExp(`\\b${kw}\\b`, 'i').test(heading)) {
+                frontendIndicators.push(kw);
+            }
+        }
+    }
+    let hasUiSpecFile = false;
+    let dirFiles = [];
+    if (phaseDirFull && existsSync(phaseDirFull)) {
+        try {
+            dirFiles = readdirSync(phaseDirFull, { recursive: false });
+        }
+        catch {
+            dirFiles = [];
+        }
+        hasUiSpecFile = dirFiles.some(f => f === 'UI-SPEC.md' || f.endsWith('-UI-SPEC.md'));
+    }
+    const has_frontend = headingUiMatch || hasUiSpecFile;
+    // Schema detection — build relative paths from phase dir for detectSchemaFiles
+    let schemaFiles = [];
+    let schemaOrm = null;
+    let hasSchema = false;
+    if (phaseDirFull && dirFiles.length > 0) {
+        // Also check subdirectory one level deep (e.g. prisma/schema.prisma)
+        const allRelPaths = [...dirFiles];
+        for (const f of dirFiles) {
+            const sub = join(phaseDirFull, f);
+            if (existsSync(sub)) {
+                try {
+                    const subStat = readdirSync(sub);
+                    for (const sf of subStat) {
+                        allRelPaths.push(`${f}/${sf}`);
+                    }
+                }
+                catch {
+                    // Not a directory — ignore
+                }
+            }
+        }
+        const detection = detectSchemaFiles(allRelPaths);
+        if (detection.detected) {
+            hasSchema = true;
+            schemaFiles = detection.matches;
+            schemaOrm = detection.orms[0] ?? null;
+        }
+    }
+    // API detection
+    const apiFromFiles = dirFiles.some(f => API_INDICATOR_RE.test(f));
+    const apiFromHeading = heading ? API_HEADING_RE.test(heading) : false;
+    const has_api = apiFromFiles || apiFromHeading;
+    // Infra detection
+    const has_infra = dirFiles.some(f => INFRA_RE.test(f));
+    return {
+        data: {
+            phase: phaseArg,
+            has_frontend,
+            frontend_indicators: frontendIndicators,
+            has_schema: hasSchema,
+            schema_orm: schemaOrm,
+            schema_files: schemaFiles,
+            push_command: null,
+            has_api,
+            has_infra,
+        },
+    };
+};
+//# sourceMappingURL=detect-phase-type.js.map

package/sdk/dist/query/detect-phase-type.js.map

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

package/sdk/dist/query/docs-init.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Docs-init — context bundle for the docs-update workflow.
+ *
+ * Full port of `cmdDocsInit` and helpers from `get-shit-done/bin/lib/docs.cjs`.
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Recursively scan project root `.md` files and `docs/` (or fallbacks) up to depth 4.
+ * Port of `scanExistingDocs` from docs.cjs.
+ */
+export declare function scanExistingDocs(cwd: string): Array<{
+    path: string;
+    has_gsd_marker: boolean;
+}>;
+/** Port of `detectProjectType` from docs.cjs. */
+export declare function detectProjectType(cwd: string): Record<string, boolean>;
+/** Port of `detectDocTooling` from docs.cjs. */
+export declare function detectDocTooling(cwd: string): Record<string, boolean>;
+/** Port of `detectMonorepoWorkspaces` from docs.cjs. */
+export declare function detectMonorepoWorkspaces(cwd: string): string[];
+/**
+ * Init payload for docs-update workflow — matches `gsd-tools docs-init` JSON.
+ * Port of `cmdDocsInit` from docs.cjs.
+ */
+export declare const docsInit: QueryHandler;
+//# sourceMappingURL=docs-init.d.ts.map

package/sdk/dist/query/docs-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-init.d.ts","sourceRoot":"","sources":["../../src/query/docs-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8B/C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC,CAqD9F;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CtE;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYrE;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B9D;AA6BD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,YAuBtB,CAAC"}

package/sdk/dist/query/docs-init.js

@@ -0,0 +1,231 @@
+/**
+ * Docs-init — context bundle for the docs-update workflow.
+ *
+ * Full port of `cmdDocsInit` and helpers from `get-shit-done/bin/lib/docs.cjs`.
+ */
+import { closeSync, existsSync, openSync, readFileSync, readSync, readdirSync, statSync, } from 'node:fs';
+import { join, relative } from 'node:path';
+import { loadConfig } from '../config.js';
+import { MODEL_PROFILES, resolveModel } from './config-query.js';
+import { detectRuntime, resolveAgentsDir, toPosixPath } from './helpers.js';
+const GSD_MARKER = '<!-- generated-by: gsd-doc-writer -->';
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '.planning', '.claude', '__pycache__',
+    'target', 'dist', 'build', '.next', '.nuxt', 'coverage',
+    '.vscode', '.idea',
+]);
+function pathExistsInternal(cwd, rel) {
+    try {
+        return existsSync(join(cwd, rel));
+    }
+    catch {
+        return false;
+    }
+}
+function hasGsdMarker(filePath) {
+    try {
+        const buf = Buffer.alloc(500);
+        const fd = openSync(filePath, 'r');
+        const bytesRead = readSync(fd, buf, 0, 500, 0);
+        closeSync(fd);
+        return buf.subarray(0, bytesRead).toString('utf-8').includes(GSD_MARKER);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Recursively scan project root `.md` files and `docs/` (or fallbacks) up to depth 4.
+ * Port of `scanExistingDocs` from docs.cjs.
+ */
+export function scanExistingDocs(cwd) {
+    const MAX_DEPTH = 4;
+    const results = [];
+    function walkDir(dir, depth) {
+        if (depth > MAX_DEPTH)
+            return;
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (SKIP_DIRS.has(entry.name))
+                    continue;
+                const abs = join(dir, entry.name);
+                const nameStr = entry.name.toString();
+                if (entry.isDirectory()) {
+                    walkDir(abs, depth + 1);
+                }
+                else if (entry.isFile() && nameStr.toLowerCase().endsWith('.md')) {
+                    const rel = toPosixPath(relative(cwd, abs));
+                    results.push({ path: rel, has_gsd_marker: hasGsdMarker(abs) });
+                }
+            }
+        }
+        catch { /* directory may not exist */ }
+    }
+    try {
+        const rootEntries = readdirSync(cwd, { withFileTypes: true });
+        for (const entry of rootEntries) {
+            const nameStr = entry.name.toString();
+            if (entry.isFile() && nameStr.toLowerCase().endsWith('.md')) {
+                const abs = join(cwd, nameStr);
+                const rel = toPosixPath(relative(cwd, abs));
+                results.push({ path: rel, has_gsd_marker: hasGsdMarker(abs) });
+            }
+        }
+    }
+    catch { /* best-effort */ }
+    const docsDir = join(cwd, 'docs');
+    walkDir(docsDir, 1);
+    try {
+        statSync(docsDir);
+    }
+    catch {
+        for (const alt of ['documentation', 'doc']) {
+            const altDir = join(cwd, alt);
+            try {
+                const st = statSync(altDir);
+                if (st.isDirectory()) {
+                    walkDir(altDir, 1);
+                    break;
+                }
+            }
+            catch { /* not present */ }
+        }
+    }
+    return results.sort((a, b) => a.path.localeCompare(b.path));
+}
+/** Port of `detectProjectType` from docs.cjs. */
+export function detectProjectType(cwd) {
+    const exists = (rel) => pathExistsInternal(cwd, rel);
+    let has_cli_bin = false;
+    try {
+        const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));
+        const bin = pkg.bin;
+        has_cli_bin = !!(bin && (typeof bin === 'string' || Object.keys(bin).length > 0));
+    }
+    catch { /* no package.json */ }
+    let is_monorepo = exists('pnpm-workspace.yaml') || exists('lerna.json');
+    if (!is_monorepo) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));
+            is_monorepo = Array.isArray(pkg.workspaces) && pkg.workspaces.length > 0;
+        }
+        catch { /* ignore */ }
+    }
+    let has_tests = exists('test') || exists('tests') || exists('__tests__') || exists('spec');
+    if (!has_tests) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));
+            const devDeps = Object.keys(pkg.devDependencies || {});
+            has_tests = devDeps.some(d => ['vitest', 'jest', 'mocha', 'jasmine', 'ava'].includes(d));
+        }
+        catch { /* ignore */ }
+    }
+    const deployFiles = [
+        'Dockerfile', 'docker-compose.yml', 'docker-compose.yaml',
+        'fly.toml', 'render.yaml', 'vercel.json', 'netlify.toml', 'railway.json',
+        '.github/workflows/deploy.yml', '.github/workflows/deploy.yaml',
+    ];
+    const has_deploy_config = deployFiles.some(f => exists(f));
+    return {
+        has_package_json: exists('package.json'),
+        has_api_routes: (exists('src/app/api') || exists('routes') || exists('src/routes') ||
+            exists('api') || exists('server')),
+        has_cli_bin,
+        is_open_source: exists('LICENSE') || exists('LICENSE.md'),
+        has_deploy_config,
+        is_monorepo,
+        has_tests,
+    };
+}
+/** Port of `detectDocTooling` from docs.cjs. */
+export function detectDocTooling(cwd) {
+    const exists = (rel) => pathExistsInternal(cwd, rel);
+    return {
+        docusaurus: exists('docusaurus.config.js') || exists('docusaurus.config.ts'),
+        vitepress: (exists('.vitepress/config.js') ||
+            exists('.vitepress/config.ts') ||
+            exists('.vitepress/config.mts')),
+        mkdocs: exists('mkdocs.yml'),
+        storybook: exists('.storybook'),
+    };
+}
+/** Port of `detectMonorepoWorkspaces` from docs.cjs. */
+export function detectMonorepoWorkspaces(cwd) {
+    try {
+        const content = readFileSync(join(cwd, 'pnpm-workspace.yaml'), 'utf-8');
+        const workspaces = [];
+        for (const line of content.split('\n')) {
+            const m = line.match(/^\s*-\s+['"]?(.+?)['"]?\s*$/);
+            if (m)
+                workspaces.push(m[1].trim());
+        }
+        if (workspaces.length > 0)
+            return workspaces;
+    }
+    catch { /* not present */ }
+    try {
+        const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));
+        if (Array.isArray(pkg.workspaces) && pkg.workspaces.length > 0) {
+            return pkg.workspaces;
+        }
+    }
+    catch { /* not present */ }
+    try {
+        const lerna = JSON.parse(readFileSync(join(cwd, 'lerna.json'), 'utf-8'));
+        if (Array.isArray(lerna.packages) && lerna.packages.length > 0) {
+            return lerna.packages;
+        }
+    }
+    catch { /* not present */ }
+    return [];
+}
+/**
+ * Port of `checkAgentsInstalled` from core.cjs (same logic as init.ts).
+ */
+function checkAgentsInstalled(config) {
+    const runtime = detectRuntime(config);
+    const agentsDir = resolveAgentsDir(runtime);
+    const expectedAgents = Object.keys(MODEL_PROFILES);
+    if (!existsSync(agentsDir)) {
+        return { agents_installed: false, missing_agents: expectedAgents };
+    }
+    const missing = [];
+    for (const agent of expectedAgents) {
+        const agentFile = join(agentsDir, `${agent}.md`);
+        const agentFileCopilot = join(agentsDir, `${agent}.agent.md`);
+        if (!existsSync(agentFile) && !existsSync(agentFileCopilot)) {
+            missing.push(agent);
+        }
+    }
+    return {
+        agents_installed: missing.length === 0,
+        missing_agents: missing,
+    };
+}
+/**
+ * Init payload for docs-update workflow — matches `gsd-tools docs-init` JSON.
+ * Port of `cmdDocsInit` from docs.cjs.
+ */
+export const docsInit = async (_args, projectDir) => {
+    const config = await loadConfig(projectDir);
+    const configExists = existsSync(join(projectDir, '.planning', 'config.json'));
+    const docModelResult = await resolveModel(['gsd-doc-writer'], projectDir);
+    const docWriterData = docModelResult.data;
+    const doc_writer_model = configExists ? (docWriterData?.model || '') : '';
+    const agentStatus = checkAgentsInstalled(config);
+    const data = {
+        doc_writer_model,
+        commit_docs: config.commit_docs,
+        existing_docs: scanExistingDocs(projectDir),
+        project_type: detectProjectType(projectDir),
+        doc_tooling: detectDocTooling(projectDir),
+        monorepo_workspaces: detectMonorepoWorkspaces(projectDir),
+        planning_exists: pathExistsInternal(projectDir, '.planning'),
+        project_root: projectDir,
+        agents_installed: agentStatus.agents_installed,
+        missing_agents: agentStatus.missing_agents,
+    };
+    return { data };
+};
+//# sourceMappingURL=docs-init.js.map

package/sdk/dist/query/docs-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-init.js","sourceRoot":"","sources":["../../src/query/docs-init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,QAAQ,GAET,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG5E,MAAM,UAAU,GAAG,uCAAuC,CAAC;AAE3D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa;IAC7D,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU;IACvD,SAAS,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,SAAS,kBAAkB,CAAC,GAAW,EAAE,GAAW;IAClD,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC/C,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,SAAS,GAAG,CAAC,CAAC;IACpB,MAAM,OAAO,GAAqD,EAAE,CAAC;IAErE,SAAS,OAAO,CAAC,GAAW,EAAE,KAAa;QACzC,IAAI,KAAK,GAAG,SAAS;YAAE,OAAO;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAa,CAAC;YACtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC1B,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnE,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;oBAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAa,CAAC;QAC1E,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC/B,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAEpB,IAAI,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;oBACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,MAAM,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEtE,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAA4B,CAAC;QACpG,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QACpB,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAEjC,IAAI,WAAW,GAAG,MAAM,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;IACxE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAA4B,CAAC;YACpG,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAK,GAAG,CAAC,UAAwB,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1F,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3F,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAA4B,CAAC;YACpG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAE,GAAG,CAAC,eAA2C,IAAI,EAAE,CAAC,CAAC;YACpF,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAG;QAClB,YAAY,EAAE,oBAAoB,EAAE,qBAAqB;QACzD,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc;QACxE,8BAA8B,EAAE,+BAA+B;KAChE,CAAC;IACF,MAAM,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D,OAAO;QACL,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC;QACxC,cAAc,EAAE,CACd,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC;YACjE,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAClC;QACD,WAAW;QACX,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC;QACzD,iBAAiB;QACjB,WAAW;QACX,SAAS;KACV,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtE,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,sBAAsB,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAC;QAC5E,SAAS,EAAE,CACT,MAAM,CAAC,sBAAsB,CAAC;YAC9B,MAAM,CAAC,sBAAsB,CAAC;YAC9B,MAAM,CAAC,uBAAuB,CAAC,CAChC;QACD,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACpD,IAAI,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,UAAU,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAA4B,CAAC;QACpG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,GAAG,CAAC,UAAsB,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAA4B,CAAC;QACpG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE7B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,MAA8B;IAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC;QACjD,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,WAAW,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC;QACtC,cAAc,EAAE,OAAO;KACxB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAiB,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9E,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC;IAC1E,MAAM,aAAa,GAAG,cAAc,CAAC,IAA+B,CAAC;IACrE,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAE,aAAa,EAAE,KAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAA+B,CAAC,CAAC;IAE1E,MAAM,IAAI,GAA4B;QACpC,gBAAgB;QAChB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,aAAa,EAAE,gBAAgB,CAAC,UAAU,CAAC;QAC3C,YAAY,EAAE,iBAAiB,CAAC,UAAU,CAAC;QAC3C,WAAW,EAAE,gBAAgB,CAAC,UAAU,CAAC;QACzC,mBAAmB,EAAE,wBAAwB,CAAC,UAAU,CAAC;QACzD,eAAe,EAAE,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC;QAC5D,YAAY,EAAE,UAAU;QACxB,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;QAC9C,cAAc,EAAE,WAAW,CAAC,cAAc;KAC3C,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC,CAAC"}

package/sdk/dist/query/fallow-audit.d.ts

@@ -0,0 +1,44 @@
+export interface FallowUnusedExport {
+    file?: string;
+    symbol?: string;
+    line?: number | null;
+}
+export interface FallowDuplicateBlock {
+    left?: {
+        file?: string;
+        start?: number | null;
+        end?: number | null;
+    };
+    right?: {
+        file?: string;
+        start?: number | null;
+        end?: number | null;
+    };
+    similarity?: number;
+}
+export interface FallowCircularDependency {
+    cycle?: string[];
+}
+export interface FallowReport {
+    unusedExports?: FallowUnusedExport[];
+    duplicates?: FallowDuplicateBlock[];
+    circularDependencies?: FallowCircularDependency[];
+}
+export interface NormalizedFallowFinding {
+    type: 'unused_export' | 'duplicate_block' | 'circular_dependency';
+    message: string;
+    file: string;
+    line: number | null;
+    related_file?: string;
+}
+export interface NormalizedFallowReport {
+    summary: {
+        unused_exports: number;
+        duplicates: number;
+        circular_dependencies: number;
+        total: number;
+    };
+    findings: NormalizedFallowFinding[];
+}
+export declare function normalizeFallowReport(report: FallowReport | null | undefined): NormalizedFallowReport;
+//# sourceMappingURL=fallow-audit.d.ts.map

package/sdk/dist/query/fallow-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallow-audit.d.ts","sourceRoot":"","sources":["../../src/query/fallow-audit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrE,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,oBAAoB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,eAAe,GAAG,iBAAiB,GAAG,qBAAqB,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAKD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CA4CrG"}

package/sdk/dist/query/fallow-audit.js

@@ -0,0 +1,44 @@
+// TODO(parity): SDK lacks a TS test harness for normalizeFallowReport. CJS parity tests live in
+// tests/feat-3210-fallow-integration.test.cjs (H1 suite). When a TS test runner is added,
+// mirror those cases here — especially the line:0 preservation assertions.
+export function normalizeFallowReport(report) {
+    const unused = Array.isArray(report?.unusedExports) ? report.unusedExports : [];
+    const duplicates = Array.isArray(report?.duplicates) ? report.duplicates : [];
+    const circular = Array.isArray(report?.circularDependencies) ? report.circularDependencies : [];
+    const findings = [];
+    for (const item of unused) {
+        findings.push({
+            type: 'unused_export',
+            message: `Unused export ${item.symbol || '<unknown>'}`,
+            file: item.file || '',
+            line: item.line ?? null,
+        });
+    }
+    for (const item of duplicates) {
+        findings.push({
+            type: 'duplicate_block',
+            message: `Duplicate block (${Math.round((item.similarity || 0) * 100)}% similarity)`,
+            file: item.left?.file || '',
+            line: item.left?.start ?? null,
+            related_file: item.right?.file || '',
+        });
+    }
+    for (const item of circular) {
+        findings.push({
+            type: 'circular_dependency',
+            message: `Circular dependency: ${(item.cycle || []).join(' -> ')}`,
+            file: Array.isArray(item.cycle) && item.cycle.length > 0 ? item.cycle[0] : '',
+            line: null,
+        });
+    }
+    return {
+        summary: {
+            unused_exports: unused.length,
+            duplicates: duplicates.length,
+            circular_dependencies: circular.length,
+            total: findings.length,
+        },
+        findings,
+    };
+}
+//# sourceMappingURL=fallow-audit.js.map

package/sdk/dist/query/fallow-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallow-audit.js","sourceRoot":"","sources":["../../src/query/fallow-audit.ts"],"names":[],"mappings":"AAwCA,gGAAgG;AAChG,0FAA0F;AAC1F,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,MAAuC;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhG,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,iBAAiB,IAAI,CAAC,MAAM,IAAI,WAAW,EAAE;YACtD,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;SACxB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,oBAAoB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,eAAe;YACpF,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI;YAC9B,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,wBAAwB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YAClE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YAC7E,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,cAAc,EAAE,MAAM,CAAC,MAAM;YAC7B,UAAU,EAAE,UAAU,CAAC,MAAM;YAC7B,qBAAqB,EAAE,QAAQ,CAAC,MAAM;YACtC,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB;QACD,QAAQ;KACT,CAAC;AACJ,CAAC"}