@promptci/core 0.0.1

package/dist/prompt-cache.js

@@ -0,0 +1,151 @@
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+/**
+ * B4: every id in this file was keyed by `${file.fileType}` — two files
+ * sharing a fileType (e.g. CLAUDE.md and .claude/notes.md, both 'claude')
+ * collided on the same id for each of the 5 checks below.
+ */
+function promptCacheIssueId(kind, filePath) {
+    const hash = crypto.createHash('sha1').update(`prompt-cache-${kind}:${filePath}`).digest('hex').slice(0, 12);
+    return `prompt-cache-${kind}-${hash}`;
+}
+const DATE_PATTERNS = [
+    /\b(?:last\s+updated|last\s+modified|updated\s+at|modified\s+at|date)\b\s*:\s*\b\d{4}-\d{2}-\d{2}\b/i,
+    /\b\d{4}-\d{2}-\d{2}t\d{2}:\d{2}:\d{2}\b/i,
+    /\b(?:january|february|march|april|may|june|july|august|september|october|november|december)\s+\d{1,2}(?:st|nd|rd|th)?,\s+\d{4}\b/i,
+];
+const SCAN_REPORT_PATTERNS = [
+    /health\s+score\s*:\s*\d+/i,
+    /files\s+scanned\s*:\s*\d+/i,
+    /promptci\s+report/i,
+    /\bgenerated\s+by\s+promptci\b/i,
+    /latest\s+scan\s+results/i,
+    /scan\s+history/i,
+];
+const BRANCH_TASK_PATTERNS = [
+    /current\s+branch\s*:\s*\S+/i,
+    /git\s+branch\s*:\s*\S+/i,
+    /current\s+task\s*:\s*\S+/i,
+];
+const LOCAL_PATH_PATTERN = /(?:[a-zA-Z]:\\users\\[a-zA-Z0-9_-]+)|(?:\/users\/[a-zA-Z0-9_-]+\/)|(?:\/home\/(?!runner)[a-zA-Z0-9_-]+\/)/i;
+export function detectPromptCacheFriendliness(files) {
+    const issues = [];
+    // Focus only on persistent, always-loaded instruction files
+    const targetFiles = files.filter((f) => ['claude', 'agents', 'cursor', 'copilot', 'prompt'].includes(f.fileType));
+    for (const file of targetFiles) {
+        const fileName = path.basename(file.path);
+        // 1. Timestamps and Dates
+        for (const pat of DATE_PATTERNS) {
+            if (pat.test(file.content)) {
+                issues.push({
+                    id: promptCacheIssueId('volatile-timestamp', file.path),
+                    severity: 'warning',
+                    category: 'context_bloat',
+                    title: 'Volatile timestamp in instruction file',
+                    summary: `The instruction file "${fileName}" contains a volatile date or timestamp. Frequently changing dates in persistent instruction files invalidate prompt caches.`,
+                    filePaths: [file.path],
+                    locations: [],
+                    evidence: [`Matched pattern: ${pat.toString()}`],
+                    recommendation: 'Move volatile dates to a separate task-specific prompt or scratch file, or remove them from canonical instructions.',
+                    fixRecipe: 'Remove the "Last updated: <date>" or timestamp line from the file.',
+                    confidence: 0.85,
+                });
+                break; // one is enough
+            }
+        }
+        // 2. Pasted Scan Outputs/Reports
+        for (const pat of SCAN_REPORT_PATTERNS) {
+            if (pat.test(file.content)) {
+                issues.push({
+                    id: promptCacheIssueId('pasted-report', file.path),
+                    severity: 'warning',
+                    category: 'context_bloat',
+                    title: 'Pasted scan report or summary in instructions',
+                    summary: `The instruction file "${fileName}" contains pasted scan results or reports. Committing generated reports into canonical instruction files breaks prompt caching and bloats context.`,
+                    filePaths: [file.path],
+                    locations: [],
+                    evidence: [`Matched pattern: ${pat.toString()}`],
+                    recommendation: 'Link to the generated report file or read it on-demand instead of pasting its contents into canonical instructions.',
+                    fixRecipe: 'Delete the pasted report summary block and reference the report file path instead.',
+                    confidence: 0.9,
+                });
+                break;
+            }
+        }
+        // 3. Current Branch or Task status
+        for (const pat of BRANCH_TASK_PATTERNS) {
+            if (pat.test(file.content)) {
+                issues.push({
+                    id: promptCacheIssueId('volatile-branch-task', file.path),
+                    severity: 'warning',
+                    category: 'context_bloat',
+                    title: 'Volatile branch or task status in instructions',
+                    summary: `The instruction file "${fileName}" contains active git branch or task details. Frequently updated task status or branch names break prompt caching.`,
+                    filePaths: [file.path],
+                    locations: [],
+                    evidence: [`Matched pattern: ${pat.toString()}`],
+                    recommendation: 'Move branch-specific notes and active task details to git commit messages, PR descriptions, or a temporary scratch file.',
+                    fixRecipe: 'Remove active branch and task notes from the persistent instructions.',
+                    confidence: 0.85,
+                });
+                break;
+            }
+        }
+        // 4. Local User Paths
+        if (LOCAL_PATH_PATTERN.test(file.content)) {
+            const match = file.content.match(LOCAL_PATH_PATTERN)?.[0] ?? '';
+            issues.push({
+                id: promptCacheIssueId('local-paths', file.path),
+                severity: 'warning',
+                category: 'context_bloat',
+                title: 'Local machine paths in instructions',
+                summary: `The instruction file "${fileName}" contains absolute local machine paths ("${match}"). These paths change per environment, preventing prompt caching and causing instruction drift.`,
+                filePaths: [file.path],
+                locations: [],
+                evidence: [`Found absolute local path: ${match}`],
+                recommendation: 'Use repository-relative paths instead of absolute local machine paths.',
+                fixRecipe: 'Replace absolute local paths with repository-relative paths.',
+                confidence: 0.8,
+            });
+        }
+        // 5. Large Tables (more than 15 rows)
+        const lines = file.content.split(/\r?\n/);
+        let maxTableRows = 0;
+        let currentTableRows = 0;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('|') && trimmed.endsWith('|')) {
+                if (/^\|[-\s:|]+\|$/.test(trimmed)) {
+                    continue;
+                }
+                currentTableRows++;
+            }
+            else {
+                if (currentTableRows > maxTableRows) {
+                    maxTableRows = currentTableRows;
+                }
+                currentTableRows = 0;
+            }
+        }
+        if (currentTableRows > maxTableRows) {
+            maxTableRows = currentTableRows;
+        }
+        if (maxTableRows > 15) {
+            issues.push({
+                id: promptCacheIssueId('large-table', file.path),
+                severity: 'warning',
+                category: 'context_bloat',
+                title: 'Large table in instruction file',
+                summary: `The instruction file "${fileName}" contains a large Markdown table (${maxTableRows} rows). Large tables bloat prompt context and reduce caching friendliness.`,
+                filePaths: [file.path],
+                locations: [],
+                evidence: [`Markdown table with ${maxTableRows} rows found in ${fileName}.`],
+                recommendation: 'Move large tables to separate documentation files (e.g. under docs/) or load them on-demand via tools instead of keeping them in always-loaded instructions.',
+                fixRecipe: 'Extract the table to a separate document and link to it.',
+                confidence: 0.9,
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=prompt-cache.js.map

package/dist/prompt-cache.js.map

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

package/dist/repo-context.d.ts

@@ -0,0 +1,37 @@
+import type { ManifestData } from './manifest-consistency.js';
+import type { InstructionFile, ProjectType, ScanInput, ScanMetrics } from './types.js';
+export type PackageManagerName = 'pnpm' | 'npm' | 'yarn' | 'bun' | 'unknown';
+export type PackageJsonFacts = {
+    raw?: string;
+    packageManager?: string;
+    packageManagerName: PackageManagerName;
+    enginesNode?: string;
+    scripts: Record<string, string>;
+    dependencies: Record<string, string>;
+    devDependencies: Record<string, string>;
+    peerDependencies: Record<string, string>;
+    lockfiles: string[];
+};
+export type WorkflowCommand = {
+    filePath: string;
+    command: string;
+    line: number;
+};
+export type WorkflowFacts = {
+    files: string[];
+    commands: WorkflowCommand[];
+};
+export type RepoContext = {
+    repoRoot: string;
+    files: InstructionFile[];
+    projectType: ProjectType;
+    manifests: ManifestData;
+    packageJson: PackageJsonFacts;
+    workflows: WorkflowFacts;
+    metrics: ScanMetrics;
+    contextBudget?: number;
+    fileContextBudget?: number;
+};
+export declare function parsePackageJsonFacts(raw: string | undefined, lockfiles: string[]): PackageJsonFacts;
+export declare function buildRepoContext(input: ScanInput): Promise<RepoContext>;
+//# sourceMappingURL=repo-context.d.ts.map

package/dist/repo-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-context.d.ts","sourceRoot":"","sources":["../src/repo-context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AA8EF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAwCpG;AAyED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAmC7E"}

package/dist/repo-context.js

@@ -0,0 +1,221 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { detectProjectType, detectProjectTypeFromContent } from './project-type.js';
+import { scanFiles } from './scanner.js';
+const LOCKFILES = [
+    'pnpm-lock.yaml',
+    'package-lock.json',
+    'yarn.lock',
+    'bun.lockb',
+    'bun.lock',
+];
+function emptyPackageJsonFacts() {
+    return {
+        packageManagerName: 'unknown',
+        scripts: {},
+        dependencies: {},
+        devDependencies: {},
+        peerDependencies: {},
+        lockfiles: [],
+    };
+}
+function resolveWithinRoot(repoRoot, relativePath) {
+    const root = path.resolve(repoRoot);
+    const resolved = path.resolve(root, relativePath);
+    const relative = path.relative(root, resolved);
+    if (relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error(`Path escapes repo root: ${relativePath}`);
+    }
+    return resolved;
+}
+async function readRootFile(repoRoot, relativePath) {
+    try {
+        return await fs.readFile(resolveWithinRoot(repoRoot, relativePath), 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+async function existingRootFiles(repoRoot, relativePaths) {
+    const found = [];
+    for (const rel of relativePaths) {
+        try {
+            const stat = await fs.stat(resolveWithinRoot(repoRoot, rel));
+            if (stat.isFile())
+                found.push(rel);
+        }
+        catch {
+            // absent file
+        }
+    }
+    return found;
+}
+function packageManagerFromString(packageManager) {
+    if (!packageManager)
+        return 'unknown';
+    if (packageManager.startsWith('pnpm@'))
+        return 'pnpm';
+    if (packageManager.startsWith('npm@'))
+        return 'npm';
+    if (packageManager.startsWith('yarn@'))
+        return 'yarn';
+    if (packageManager.startsWith('bun@'))
+        return 'bun';
+    return 'unknown';
+}
+function packageManagerFromLockfiles(lockfiles) {
+    if (lockfiles.includes('pnpm-lock.yaml'))
+        return 'pnpm';
+    if (lockfiles.includes('package-lock.json'))
+        return 'npm';
+    if (lockfiles.includes('yarn.lock'))
+        return 'yarn';
+    if (lockfiles.some((f) => f.startsWith('bun.lock')))
+        return 'bun';
+    return 'unknown';
+}
+function stringRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return {};
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+        if (typeof v === 'string')
+            out[key] = v;
+    }
+    return out;
+}
+export function parsePackageJsonFacts(raw, lockfiles) {
+    const facts = emptyPackageJsonFacts();
+    facts.raw = raw;
+    facts.lockfiles = lockfiles;
+    if (!raw) {
+        facts.packageManagerName = packageManagerFromLockfiles(lockfiles);
+        return facts;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        facts.packageManagerName = packageManagerFromLockfiles(lockfiles);
+        return facts;
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        facts.packageManagerName = packageManagerFromLockfiles(lockfiles);
+        return facts;
+    }
+    const obj = parsed;
+    facts.packageManager = typeof obj.packageManager === 'string' ? obj.packageManager : undefined;
+    facts.packageManagerName =
+        packageManagerFromString(facts.packageManager) !== 'unknown'
+            ? packageManagerFromString(facts.packageManager)
+            : packageManagerFromLockfiles(lockfiles);
+    facts.scripts = stringRecord(obj.scripts);
+    facts.dependencies = stringRecord(obj.dependencies);
+    facts.devDependencies = stringRecord(obj.devDependencies);
+    facts.peerDependencies = stringRecord(obj.peerDependencies);
+    if (typeof obj.engines === 'object' && obj.engines !== null && !Array.isArray(obj.engines)) {
+        const engines = obj.engines;
+        facts.enginesNode = typeof engines.node === 'string' ? engines.node : undefined;
+    }
+    return facts;
+}
+function extractWorkflowCommands(filePath, content) {
+    const lines = content.split(/\r?\n/);
+    const commands = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const match = /^(\s*)(?:-\s*)?run:\s*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        const indent = match[1].length;
+        const rest = match[2].trim();
+        if (rest && !/^[|>][+-]?$/.test(rest)) {
+            commands.push({ filePath, command: rest, line: i + 1 });
+            continue;
+        }
+        const block = [];
+        for (let j = i + 1; j < lines.length; j++) {
+            const next = lines[j];
+            if (next.trim() === '') {
+                block.push('');
+                continue;
+            }
+            const nextIndent = next.match(/^\s*/)?.[0].length ?? 0;
+            if (nextIndent <= indent)
+                break;
+            block.push(next.trim());
+        }
+        const command = block.filter(Boolean).join('\n').trim();
+        if (command)
+            commands.push({ filePath, command, line: i + 1 });
+    }
+    return commands;
+}
+async function readWorkflowFacts(repoRoot) {
+    const workflowDir = resolveWithinRoot(repoRoot, path.join('.github', 'workflows'));
+    let entries;
+    try {
+        entries = await fs.readdir(workflowDir, { withFileTypes: true });
+    }
+    catch {
+        return { files: [], commands: [] };
+    }
+    const files = entries
+        .filter((entry) => entry.isFile() && /\.(ya?ml)$/i.test(entry.name))
+        .map((entry) => path.join(workflowDir, entry.name))
+        .sort();
+    const commands = [];
+    for (const file of files) {
+        const relative = path.relative(repoRoot, file);
+        const content = await fs.readFile(file, 'utf-8');
+        commands.push(...extractWorkflowCommands(relative, content));
+    }
+    return {
+        files: files.map((file) => path.relative(repoRoot, file)),
+        commands,
+    };
+}
+function buildMetrics(files) {
+    return {
+        estimatedInstructionTokens: files.reduce((sum, file) => sum + file.estimatedTokens, 0),
+        instructionFileCount: files.length,
+        largestInstructionFiles: [...files]
+            .sort((a, b) => b.estimatedTokens - a.estimatedTokens)
+            .slice(0, 5)
+            .map((file) => ({ path: file.path, estimatedTokens: file.estimatedTokens })),
+    };
+}
+export async function buildRepoContext(input) {
+    const repoRoot = path.resolve(input.repoPath);
+    const files = await scanFiles({ ...input, repoPath: repoRoot });
+    let projectType = input.projectType && input.projectType !== 'auto'
+        ? input.projectType
+        : await detectProjectType(repoRoot);
+    if (projectType === 'unknown') {
+        projectType = detectProjectTypeFromContent(files);
+    }
+    const [packageJson, pyproject, lockfiles, workflows] = await Promise.all([
+        readRootFile(repoRoot, 'package.json'),
+        readRootFile(repoRoot, 'pyproject.toml'),
+        existingRootFiles(repoRoot, LOCKFILES),
+        readWorkflowFacts(repoRoot),
+    ]);
+    const manifests = {};
+    if (packageJson)
+        manifests.packageJson = packageJson;
+    if (pyproject)
+        manifests.pyproject = pyproject;
+    return {
+        repoRoot,
+        files,
+        projectType,
+        manifests,
+        packageJson: parsePackageJsonFacts(packageJson, lockfiles),
+        workflows,
+        metrics: buildMetrics(files),
+        contextBudget: input.contextBudget,
+        fileContextBudget: input.fileContextBudget,
+    };
+}
+//# sourceMappingURL=repo-context.js.map

package/dist/repo-context.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Markdown and JSON report generation for PromptCI scan results.
+ */
+import type { ScanReport, ScanTrend } from './types.js';
+export type WriteReportOptions = {
+    /** Override path for the markdown report (default: <repoPath>/.promptci/latest.md) */
+    mdPath?: string;
+    /** Override path for the JSON report (default: <repoPath>/.promptci/report.json) */
+    jsonPath?: string;
+    /**
+     * If false, skip archiving the previous report before overwriting.
+     * Defaults to true. Set to false when writing to custom paths.
+     */
+    archive?: boolean;
+};
+/**
+ * One entry in the history index — a compact summary of a single past scan.
+ * Stored in .promptci/history/index.json as an append-only array.
+ */
+export type HistoryEntry = {
+    /** ISO-8601 timestamp of when the scan was run. */
+    generatedAt: string;
+    /** Health score at time of scan (0–100). */
+    healthScore: number;
+    /** Issue counts by severity. */
+    issueCount: {
+        critical: number;
+        high: number;
+        warning: number;
+        info: number;
+    };
+    /** Path to the archived markdown report, relative to the repo root. */
+    archiveMdPath: string;
+    /** Path to the archived JSON report, relative to the repo root. */
+    archiveJsonPath: string;
+};
+/**
+ * Generate a Markdown-formatted scan report.
+ */
+export declare function generateMarkdownReport(report: ScanReport): string;
+/**
+ * Serialize a ScanReport to JSON (schema v0.1).
+ *
+ * All file paths are repo-relative so reports are portable — the absolute
+ * repo root is preserved as `repoPath` so callers can reconstruct full paths.
+ * Verbose section content is excluded from filesScanned to keep output compact.
+ */
+export declare function generateJsonReport(report: ScanReport, pretty?: boolean): string;
+/** Path to the history index file for a given repo. */
+export declare function historyIndexPath(repoPath: string): string;
+/**
+ * Read the history index for a repo, returning an empty array if it doesn't
+ * exist yet or cannot be parsed.
+ */
+export declare function readHistoryIndex(repoPath: string): Promise<HistoryEntry[]>;
+/**
+ * Archive the current latest.md and report.json (if they exist) into
+ * .promptci/history/<slug>/ and append a compact entry to the history index.
+ *
+ * The slug is derived from the report's generatedAt timestamp so archives are
+ * human-readable on disk. Returns the new HistoryEntry, or null if there was
+ * nothing to archive.
+ */
+export declare function archiveExistingReport(repoPath: string, latestMdPath: string, latestJsonPath: string): Promise<HistoryEntry | null>;
+/**
+ * Write markdown and JSON reports to disk.
+ *
+ * Default output paths (relative to the repo root):
+ *   .promptci/latest.md
+ *   .promptci/report.json
+ *
+ * Before overwriting, the previous reports are archived to:
+ *   .promptci/history/<timestamp>/report.md
+ *   .promptci/history/<timestamp>/report.json
+ *
+ * A compact history index is maintained at:
+ *   .promptci/history/index.json
+ *
+ * The .promptci/ directory is created if it does not exist.
+ */
+export declare function writeReport(report: ScanReport, options?: WriteReportOptions): Promise<{
+    mdPath: string;
+    jsonPath: string;
+    archivedEntry: HistoryEntry | null;
+}>;
+export declare function computeTrend(report: ScanReport, previousReport: Record<string, unknown> | null, history: HistoryEntry[]): Promise<ScanTrend | null>;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAgC,UAAU,EAAkB,SAAS,EAAE,MAAM,YAAY,CAAC;AAGtG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AA0KF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAsJjE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,UAAO,GAAG,MAAM,CA4C5E;AAID,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAUhF;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA6D9B;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC,CA4BnF;AAWD,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC9C,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAqF3B"}