@software-dlc/cli 0.157.2

package/dist/local/git.js

@@ -0,0 +1,413 @@
+import { checkOperation, currentOperation } from './operation.js';
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { lstat, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+async function gitValue(cwd, args, input) {
+    checkOperation();
+    const command = execFileAsync('git', args, {
+        cwd,
+        encoding: 'utf8',
+        signal: currentOperation()?.signal
+    });
+    if (input !== undefined) {
+        // A git that exits before reading it all fails the command, not the process.
+        command.child.stdin?.on('error', () => { });
+        command.child.stdin?.end(input);
+    }
+    const signal = currentOperation()?.signal;
+    let kill_timer;
+    const on_abort = () => {
+        kill_timer = setTimeout(() => command.child.kill('SIGKILL'), 1000);
+    };
+    const closed = new Promise((resolve) => command.child.once('close', () => {
+        clearTimeout(kill_timer);
+        signal?.removeEventListener('abort', on_abort);
+        resolve();
+    }));
+    signal?.addEventListener('abort', on_abort, { once: true });
+    if (signal?.aborted)
+        on_abort();
+    const [result] = await Promise.allSettled([command, closed]);
+    checkOperation();
+    if (result.status === 'rejected')
+        throw result.reason;
+    return result.value.stdout.trim();
+}
+export async function discoverGitWorktree(cwd = process.cwd()) {
+    const [repository_root, git_dir, git_common_dir, head, ref, status] = await Promise.allSettled([
+        gitValue(cwd, ['rev-parse', '--show-toplevel']),
+        gitValue(cwd, ['rev-parse', '--path-format=absolute', '--git-dir']),
+        gitValue(cwd, [
+            'rev-parse',
+            '--path-format=absolute',
+            '--git-common-dir'
+        ]),
+        gitValue(cwd, ['rev-parse', 'HEAD']),
+        gitValue(cwd, ['symbolic-ref', '--quiet', 'HEAD']).catch(() => ''),
+        gitValue(cwd, ['status', '--porcelain=v1'])
+    ]);
+    const results = [repository_root, git_dir, git_common_dir, head, ref, status];
+    const failure = results.find((result) => result.status === 'rejected');
+    if (failure?.status === 'rejected')
+        throw failure.reason;
+    checkOperation();
+    const values = results.map((result) => result.status === 'fulfilled' ? result.value : '');
+    return {
+        repository_root: values[0],
+        git_dir: values[1],
+        git_common_dir: values[2],
+        ref: values[4] || null,
+        head: values[3],
+        is_dirty: values[5].length > 0
+    };
+}
+export function canonicalGitRepositoryIdentity(remote_url, cwd = process.cwd()) {
+    const value = remote_url.trim();
+    if (!value)
+        throw new Error('Git remote URL must not be empty.');
+    const scp = value.match(/^([^@\s]+@)?([^:/\s]+):(.+)$/);
+    if (scp && !value.includes('://')) {
+        const path = scp[3].replace(/^\/+|\/+$/g, '').replace(/\.git$/i, '');
+        return `${scp[2].toLowerCase()}/${path}`;
+    }
+    try {
+        const url = new URL(value);
+        if (url.protocol === 'file:') {
+            return `file://${resolve(decodeURIComponent(url.pathname))}`;
+        }
+        const path = url.pathname.replace(/^\/+|\/+$/g, '').replace(/\.git$/i, '');
+        return `${url.hostname.toLowerCase()}/${path}`;
+    }
+    catch {
+        return `file://${resolve(cwd, value.replace(/\.git$/i, ''))}`;
+    }
+}
+/**
+ * The project's integration branch (project.py INTEGRATION_BRANCH), from the
+ * coordination engine's project.json where engine_config.py finds it: beside
+ * an engine inside the repository (scripts/agent-coordination/), else in the
+ * worktree's sdlc-coordination/, else in the Git common dir's (a no-footprint
+ * repository's), which a repository the user's setup registered reads first.
+ * A file that is missing, unreadable, or names no valid branch gives main,
+ * the engine's default.
+ */
+export async function integrationBranch(cwd = process.cwd()) {
+    const [top, common] = (await gitValue(cwd, [
+        'rev-parse',
+        '--path-format=absolute',
+        '--show-toplevel',
+        '--git-common-dir'
+    ]).catch(() => '')).split('\n');
+    if (!top || !common)
+        return 'main';
+    const engine = join(top, 'scripts', 'agent-coordination', 'project.json');
+    const own = join(top, 'sdlc-coordination');
+    const shared = join(common, 'sdlc-coordination');
+    // engine_config.py folder: one folder, never the other as a fallback, and a
+    // shared one only when it is a real folder, not a link to one.
+    const sharedIsFolder = await lstat(shared).then((stat) => stat.isDirectory(), () => false);
+    const folder = sharedIsFolder && (!existsSync(own) || (await noFootprintListed(common)))
+        ? shared
+        : own;
+    const path = existsSync(engine) ? engine : join(folder, 'project.json');
+    let settings;
+    try {
+        settings = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return 'main';
+    }
+    const branch = settings
+        ?.integration?.branch;
+    return typeof branch === 'string' &&
+        !branch.startsWith('refs/') &&
+        INTEGRATION_BRANCH.test(branch)
+        ? branch
+        : 'main';
+}
+// A plain branch name, as project.py BRANCH accepts it.
+const INTEGRATION_BRANCH = /^(?!-)(?!.*\.\.)(?!.*\/\/)(?!.*@\{)(?!.*\.lock(\/|$))[A-Za-z0-9._/-]+(?<![./])$/;
+// Whether the user's setup registered the repository of this Git common dir as
+// no-footprint (engine_config.py listed). A list that is a link, not a plain
+// file, or over 1 MiB registers nothing.
+async function noFootprintListed(common) {
+    const base = process.env.XDG_CONFIG_HOME && isAbsolute(process.env.XDG_CONFIG_HOME)
+        ? process.env.XDG_CONFIG_HOME
+        : join(homedir(), '.config');
+    const path = join(base, 'softwaredlc', 'no-footprint.json');
+    try {
+        const stat = await lstat(path);
+        if (!stat.isFile() || stat.size > 1 << 20)
+            return false;
+        const doc = JSON.parse(await readFile(path, 'utf8'));
+        return (doc?.schema_version === 1 &&
+            Array.isArray(doc.repositories) &&
+            doc.repositories.includes(resolve(common)));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The remote a source reference's repository is named from: the one the local
+ * integration branch (integrationBranch), else main, else master tracks, else
+ * the one the current branch tracks, else origin (sources.py tracked_remote).
+ * In a fork setup origin is the developer's fork and the integration branch
+ * tracks upstream. Branch configuration is shared by every worktree, so a
+ * detached child workspace or an untracked thread branch names the repository
+ * as the main checkout does.
+ */
+export async function trackedRemoteName(cwd = process.cwd()) {
+    const current = await gitValue(cwd, [
+        'symbolic-ref',
+        '--quiet',
+        '--short',
+        'HEAD'
+    ]).catch(() => '');
+    for (const branch of new Set([
+        await integrationBranch(cwd),
+        'main',
+        'master',
+        current
+    ])) {
+        if (!branch)
+            continue;
+        const tracked = await gitValue(cwd, [
+            'config',
+            '--get',
+            `branch.${branch}.remote`
+        ]).catch(() => '');
+        if (tracked && tracked !== '.')
+            return tracked;
+    }
+    return 'origin';
+}
+/**
+ * `owner/name` from a hosted remote URL (https or ssh), or null for a local
+ * path or file URL, whose last two directories name no repository
+ * (sources.py owner_name). A hosted URL always has a colon (scheme or
+ * host:path); a relative path has none.
+ */
+export function remoteOwnerName(url) {
+    if (!url || !url.includes(':') || /^(?:[/.~]|file:)/.test(url))
+        return null;
+    const match = url.match(/[:/]([^/:]+)\/([^/]+?)(?:\.git)?\/?$/);
+    return match ? `${match[1]}/${match[2]}` : null;
+}
+/**
+ * Every `owner/name` the repository at `cwd` goes by at `commit`, the one
+ * source references record first (sources.py repository_names, the same set).
+ * The remotes, in order, are its tracked remote (trackedRemoteName), origin,
+ * the other remotes a local branch tracks, then any other whose
+ * remote-tracking branches contain `commit` or its first-parent root commit
+ * (they share its history); the first of them naming an `owner/name` whose branches
+ * contain `commit` comes first, else the first naming one; origin, when first,
+ * gives way to a remote named upstream (Git's name for a fork's parent) when
+ * its main line (origin/HEAD, else main, else master) holds nothing past
+ * upstream's branches. A fork (origin, however it is named)
+ * and its upstream are one repository here: a fork whose only branch tracks
+ * the fork while upstream holds the commit, or whose main line sits level
+ * with or behind upstream, pushed feature branches or not, is named from
+ * upstream; a fork whose main line has commits upstream lacks, and a
+ * canonical origin beside a fork of another name, keep their own, and a
+ * commit no remote holds yet names origin first, upstream still one of its
+ * names.
+ * A remote that neither a branch tracks nor shares the commit's history is not.
+ */
+export async function repositoryNames(cwd = process.cwd(), commit = 'HEAD') {
+    const { first, named } = await namedRemotes(cwd, commit);
+    return [
+        ...new Set([...(first ? [first.name] : []), ...named.map(({ name }) => name)])
+    ];
+}
+/**
+ * The remote whose `owner/name` source references record first
+ * (repositoryNames), or null when no remote names one. A source binding made
+ * with no remote named uses it, so a workspace commit's remote identity names
+ * the repository its references name.
+ */
+export async function namingRemote(cwd = process.cwd(), commit = 'HEAD') {
+    const { first, named } = await namedRemotes(cwd, commit);
+    return (first ?? named[0])?.remote ?? null;
+}
+async function namedRemotes(cwd, commit) {
+    const remotes = await gitRemoteNames(cwd);
+    const tracked = (await gitValue(cwd, ['config', '--get-regexp', '^branch\\..*\\.remote$']).catch(() => ''))
+        .split('\n')
+        .map((line) => line.trim().split(/\s+/).pop() ?? '')
+        .filter(Boolean);
+    // A remote's name may hold a slash: match each ref by the longest prefix.
+    const byLength = [...remotes].sort((a, b) => b.length - a.length);
+    // Each remote's remote-tracking branch commits that contain `contained`, or
+    // all of them when it is null.
+    const remoteTips = async (contained) => {
+        const tips = new Map();
+        const lines = (await gitValue(cwd, [
+            'for-each-ref',
+            ...(contained === null ? [] : ['--contains', contained]),
+            '--format=%(objectname) %(refname)',
+            'refs/remotes'
+        ]).catch(() => '')).split('\n');
+        for (const line of lines) {
+            const [tip, ref = ''] = line.trim().split(' ');
+            const remote = byLength.find((name) => ref.startsWith(`refs/remotes/${name}/`));
+            if (remote)
+                tips.set(remote, [...(tips.get(remote) ?? []), tip]);
+        }
+        return tips;
+    };
+    const remotesWith = async (contained) => [
+        ...(await remoteTips(contained)).keys()
+    ];
+    const tips = await remoteTips(commit);
+    const containing = [...tips.keys()];
+    // Sharing history: a branch holds the commit's first-parent root, so a
+    // fork's upstream stays one after both move on, while a library merged in
+    // (a subtree) has a root of its own.
+    const root = (await gitValue(cwd, [
+        'rev-list',
+        '--first-parent',
+        '--max-parents=0',
+        commit
+    ]).catch(() => ''))
+        .split(/\s+/)
+        .filter(Boolean)[0];
+    const sharing = root ? await remotesWith(root) : [];
+    const named = [];
+    for (const remote of new Set([
+        await trackedRemoteName(cwd),
+        'origin',
+        ...tracked,
+        ...containing,
+        ...sharing
+    ])) {
+        if (!remotes.includes(remote))
+            continue;
+        const url = await gitValue(cwd, ['remote', 'get-url', '--', remote]).catch(() => '');
+        const name = remoteOwnerName(url);
+        if (name)
+            named.push({ remote, name });
+    }
+    const holders = named.filter(({ remote }) => tips.has(remote));
+    let first = holders[0];
+    // Origin level with or behind upstream: its main line holds nothing past
+    // upstream's branches; a pushed feature branch is no commits of the fork's
+    // own. The tips go on stdin, each left out as ^<commit> (git before 2.42
+    // takes no --not there): a fork mirroring upstream's branches has more
+    // than a command line holds.
+    const upstream = holders.find(({ remote }) => remote === 'upstream');
+    if (first?.remote === 'origin' && upstream) {
+        let main = '';
+        // The branch refs/remotes/origin/HEAD names, else main, else master.
+        for (const ref of ['HEAD', 'main', 'master']) {
+            main = await gitValue(cwd, [
+                'rev-parse',
+                '--verify',
+                '--quiet',
+                `refs/remotes/origin/${ref}^{commit}`
+            ]).catch(() => '');
+            if (main)
+                break;
+        }
+        const revs = [
+            ...(main ? [main] : new Set(tips.get('origin'))),
+            ...[...new Set((await remoteTips(null)).get('upstream'))].map((tip) => `^${tip}`)
+        ];
+        const past = await gitValue(cwd, ['rev-list', '--count', '--stdin'], `${revs.join('\n')}\n`).catch(() => '');
+        if (past === '0')
+            first = upstream;
+    }
+    return { first, named };
+}
+/** The names of the repository's remotes. */
+export async function gitRemoteNames(cwd = process.cwd()) {
+    return (await gitValue(cwd, ['remote']).catch(() => ''))
+        .split(/\s+/)
+        .filter(Boolean);
+}
+export async function discoverGitRemoteIdentity(cwd = process.cwd(), remote_name = 'origin') {
+    const normalized_name = remote_name.trim();
+    if (!normalized_name)
+        throw new Error('Git remote name must not be empty.');
+    let remote_url;
+    try {
+        remote_url = await gitValue(cwd, [
+            'remote',
+            'get-url',
+            '--',
+            normalized_name
+        ]);
+    }
+    catch {
+        throw new Error(`Git remote ${normalized_name} was not found.`);
+    }
+    return {
+        remote_name: normalized_name,
+        remote_url,
+        repository_identity: canonicalGitRepositoryIdentity(remote_url, cwd)
+    };
+}
+export async function assertLocalWorkspacePathsIgnored(cwd) {
+    for (const path of ['sdlc/', '.sdlc/state/']) {
+        try {
+            await execFileAsync('git', ['check-ignore', '--quiet', '--no-index', '--', path], { cwd, encoding: 'utf8' });
+        }
+        catch (error) {
+            const code = typeof error === 'object' && error !== null && 'code' in error
+                ? error.code
+                : null;
+            if (code === 1) {
+                throw new Error(`Refusing local workspace setup because ${path} is not ignored by Git.`);
+            }
+            throw error;
+        }
+    }
+}
+export async function createDetachedGitWorktree(input) {
+    if (!isAbsolute(input.target_path)) {
+        throw new Error('Git worktree target path must be absolute.');
+    }
+    const target_path = resolve(input.target_path);
+    const source = await discoverGitWorktree(input.source_cwd);
+    const commit_id = input.commit_id.trim();
+    if (!commit_id)
+        throw new Error('Git worktree commit must not be empty.');
+    await execFileAsync('git', ['worktree', 'add', '--detach', '--', target_path, commit_id], { cwd: source.repository_root, encoding: 'utf8' });
+    const created = await discoverGitWorktree(target_path);
+    if (created.git_common_dir !== source.git_common_dir ||
+        created.head !== commit_id ||
+        created.ref !== null) {
+        await removeGitWorktree({
+            repository_cwd: source.repository_root,
+            target_path,
+            force: true
+        }).catch(() => undefined);
+        throw new Error('Created Git worktree does not match its requested base.');
+    }
+    return created;
+}
+export async function removeGitWorktree(input) {
+    if (!isAbsolute(input.target_path)) {
+        throw new Error('Git worktree target path must be absolute.');
+    }
+    const args = ['worktree', 'remove'];
+    if (input.force)
+        args.push('--force');
+    args.push('--', resolve(input.target_path));
+    await execFileAsync('git', args, {
+        cwd: input.repository_cwd,
+        encoding: 'utf8'
+    });
+}
+export async function listGitWorktreeStatus(cwd, input = {}) {
+    const args = ['status', '--porcelain=v1', '--untracked-files=all'];
+    if (input.include_ignored)
+        args.push('--ignored');
+    const status = await gitValue(cwd, args);
+    return status ? status.split('\n') : [];
+}
+//# sourceMappingURL=git.js.map

package/dist/local/git.js.map

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

package/dist/local/graph-read.d.ts

@@ -0,0 +1,168 @@
+import { type NodeOrigin, type NodeOriginResult, type PortableGraph } from '@software-dlc/graph/types';
+import type { LocalClaimView } from './workspace-claim-views.js';
+import type { LocalBuiltView } from './workspace-built-content.js';
+/** Where a term matched a node, best first. */
+export type FindReason = 'label' | 'id' | 'description' | 'criteria' | 'data';
+export declare const DEFAULT_FIND_LIMIT = 20;
+export declare const DEFAULT_SHOW_BUDGET = 2000;
+/** Relations listed per direction before the rest are only counted. */
+export declare const SHOW_RELATION_LIMIT = 50;
+export type FindRow = {
+    id: string;
+    t: string;
+    l: string;
+    d?: string;
+    p?: string;
+    pl?: string;
+    /** Built here or off the shelf; absent when the node has no origin. */
+    o?: NodeOrigin;
+    r: FindReason[];
+    /** With --view built: still built, but a merged plan removes it. */
+    removed?: true;
+};
+export type FindResult = {
+    version: 1;
+    view: LocalClaimView;
+    workspace_id: string | null;
+    commit_id: string | null;
+    terms: string[];
+    types?: string[];
+    origin?: NodeOrigin;
+    summary: {
+        /** Rows returned. */
+        n: number;
+        /** Nodes matching at least one term. */
+        matched_n: number;
+        /** Nodes matching every term. */
+        all_terms_n: number;
+        /** Matching nodes left out by the limit. */
+        omitted_n: number;
+        /** Matching nodes built here, with or without --origin. */
+        built_n: number;
+        /** Matching nodes off the shelf, with or without --origin. */
+        shelf_n: number;
+    };
+    n: FindRow[];
+    projection_dirty?: boolean;
+    /** With --view built: what blast radius reports of the same view. */
+    marked_for_removal?: LocalBuiltView['marked_for_removal'];
+    validation?: LocalBuiltView['validation'];
+    warnings?: string[];
+};
+/**
+ * Words a find of several words leaves out: common English words, and graph words
+ * a question names that every node would match. Words under 3 characters go anyway.
+ */
+export declare const FIND_STOP_WORDS: ReadonlySet<string>;
+/**
+ * Search terms from find's arguments. An argument holding spaces counts as its
+ * words. A find of one word keeps it as given, so ids, short words and words
+ * after -- still match; once there are more, each loses edge punctuation and a
+ * trailing 's, and short and stop words are left out unless none would remain,
+ * so a pasted question gives the same terms quoted or not. Terms are lowercased
+ * and distinct; phrases are the arguments of several words, for ranking.
+ */
+export declare function parseFindTerms(args: readonly string[]): {
+    terms: string[];
+    phrases: string[];
+};
+export declare function normalizeTerms(args: readonly string[]): string[];
+export declare function findGraphEntities(input: {
+    graph: PortableGraph;
+    terms: readonly string[];
+    types?: readonly string[];
+    origin?: NodeOrigin;
+    limit?: number;
+    view?: LocalClaimView;
+    workspace_id?: string;
+    commit_id?: string;
+    /** Ids the built view marks for removal. */
+    removed?: ReadonlySet<string>;
+}): FindResult;
+/** A relation of a shown entity: the edge, its type, and the node at its other end. */
+export type ShowRelation = {
+    e: string;
+    rel: string;
+    id: string;
+    t: string;
+    l: string;
+};
+export type ShowNode = {
+    kind: 'node';
+    id: string;
+    t: string;
+    l: string;
+    p?: string;
+    pl?: string;
+    /** Built here or off the shelf, and why; absent when the node has no origin. */
+    origin?: NodeOriginResult;
+    /** Domain data without label; a field longer than the budget gives its size in chars, and a text field its start. */
+    data: Record<string, unknown>;
+    /** The files the node's source references cite. */
+    sources?: Array<{
+        path: string;
+        repository?: string;
+    }>;
+    out: ShowRelation[];
+    in: ShowRelation[];
+    out_omitted?: number;
+    in_omitted?: number;
+    /** With --view built: still built, but a merged plan removes it. */
+    removed?: true;
+};
+export type ShowEdge = {
+    kind: 'edge';
+    id: string;
+    rel: string;
+    l?: string;
+    /** Domain data without type and label, budgeted as a node's is. */
+    data: Record<string, unknown>;
+    sources?: Array<{
+        path: string;
+        repository?: string;
+    }>;
+    s: {
+        id: string;
+        t: string;
+        l: string;
+    };
+    t: {
+        id: string;
+        t: string;
+        l: string;
+    };
+    removed?: true;
+};
+export type ShowResult = {
+    version: 1;
+    view: LocalClaimView;
+    workspace_id: string | null;
+    commit_id: string | null;
+    /** Per-field character budget, or null for --full. */
+    budget: number | null;
+    entities: Array<ShowNode | ShowEdge | {
+        kind: 'node' | 'edge';
+        id: string;
+        full: unknown;
+        origin?: NodeOriginResult;
+        removed?: true;
+    }>;
+    /** Ids that are no node or edge of the graph read. */
+    missing: string[];
+    projection_dirty?: boolean;
+    marked_for_removal?: LocalBuiltView['marked_for_removal'];
+    validation?: LocalBuiltView['validation'];
+    warnings?: string[];
+};
+export declare function showGraphEntities(input: {
+    graph: PortableGraph;
+    ids: readonly string[];
+    /** Per-field character budget; null returns each entity as stored. */
+    budget?: number | null;
+    view?: LocalClaimView;
+    workspace_id?: string;
+    commit_id?: string;
+    /** Ids the built view marks for removal. */
+    removed?: ReadonlySet<string>;
+}): ShowResult;
+//# sourceMappingURL=graph-read.d.ts.map

package/dist/local/graph-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-read.d.ts","sourceRoot":"","sources":["../../src/local/graph-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAcnE,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;AAc9E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,CAAC,CAAC,EAAE,UAAU,CAAC;IACf,CAAC,EAAE,UAAU,EAAE,CAAC;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE;QACP,qBAAqB;QACrB,CAAC,EAAE,MAAM,CAAC;QACV,wCAAwC;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,iCAAiC;QACjC,WAAW,EAAE,MAAM,CAAC;QACpB,4CAA4C;QAC5C,SAAS,EAAE,MAAM,CAAC;QAClB,2DAA2D;QAC3D,OAAO,EAAE,MAAM,CAAC;QAChB,8DAA8D;QAC9D,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,CAAC,EAAE,OAAO,EAAE,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;IAC1D,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAyCF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAO9C,CAAC;AAiBH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAS9F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAEhE;AAgED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B,GAAG,UAAU,CA0Eb;AAED,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,qHAAqH;IACrH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,mDAAmD;IACnD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sDAAsD;IACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,KAAK,CACX,QAAQ,GACR,QAAQ,GACR;QACE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,OAAO,CAAC,EAAE,IAAI,CAAC;KAChB,CACJ,CAAC;IACF,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;IAC1D,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AA6CF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B,GAAG,UAAU,CAyFb"}