@contextq/cli 0.1.0 → 0.3.0

package/dist/skills-sync.d.ts

@@ -1,62 +0,0 @@
-/**
- * skills-sync.ts — `contextq skills sync <dir>` core logic.
- *
- * T698: pulls the caller's tenant-distilled `type='procedure'` contexts
- * (T376) from the ContextQ API (`GET /api/agent/skills/export?format=json`,
- * server-side rendering lives in src/services/skill-export.service.ts) and
- * writes them onto disk as standard Agent Skills folders: `<dir>/<slug>/SKILL.md`.
- *
- * THE IDEMPOTENCY KEY IS `metadata.cluster_key`, NOT the folder name or the
- * skill's title. `runSkillDistillation()` upserts on cluster_key and
- * rewrites `content`/`name`/`description` IN PLACE on every scheduler tick
- * that adds a verified session to an existing cluster -- and because the
- * server-side slug includes a human-readable title prefix, a title rewrite
- * can change the freshly-computed slug even though the underlying cluster
- * (and its intended on-disk folder) is unchanged. A sync that keyed off the
- * freshly-computed slug/title would silently FORK a second folder on the
- * next run. This module instead reads each existing local folder's own
- * `metadata.cluster_key` back out of its `SKILL.md` frontmatter (no
- * separate sidecar index file to go stale) and, when a remote skill's
- * cluster_key matches an existing folder, REWRITES THAT FOLDER IN PLACE --
- * even if the server just handed back a different slug for it.
- *
- * Orphans (a local folder whose cluster_key is no longer present in the
- * remote payload -- the source context was deleted, archived, or its
- * consent was revoked) are REPORTED, never auto-deleted: the file may carry
- * user edits.
- *
- * Network-free and fully unit-testable: `fetchSkills` is injected rather
- * than hard-wired to `fetch()`, so tests exercise the on-disk merge logic
- * against an in-memory payload with no server needed.
- */
-export interface SkillPayload {
-    contextId: number;
-    /** Freshly computed by the server for THIS render -- may differ from the
-     *  folder a matching cluster_key already lives in; see module doc. */
-    slug: string;
-    clusterKey: string;
-    markdown: string;
-}
-export interface SyncResult {
-    written: string[];
-    updated: string[];
-    unchanged: string[];
-    /** Folder names present on disk before this run whose cluster_key is not
-     *  in the remote payload this run. Left on disk untouched. */
-    orphans: string[];
-}
-/**
- * Pull a scalar value out of the `metadata:` frontmatter block this project
- * renders (src/services/skill-export.service.ts / yamlString()). Format is
- * fixed and self-controlled (both write and read side live in this repo),
- * so a small anchored regex is enough -- no general YAML parser needed.
- * `^  <key>: "..."$` in multiline mode only matches an indented entry under
- * `metadata:`, never the top-level `name:`/`description:` lines.
- */
-export declare function extractFrontmatterMetadataValue(markdown: string, key: string): string | null;
-export declare function extractClusterKey(markdown: string): string | null;
-export interface SyncOptions {
-    dir: string;
-    fetchSkills: () => Promise<SkillPayload[]>;
-}
-export declare function syncSkills(opts: SyncOptions): Promise<SyncResult>;

package/dist/skills-sync.js

@@ -1,129 +0,0 @@
-/**
- * skills-sync.ts — `contextq skills sync <dir>` core logic.
- *
- * T698: pulls the caller's tenant-distilled `type='procedure'` contexts
- * (T376) from the ContextQ API (`GET /api/agent/skills/export?format=json`,
- * server-side rendering lives in src/services/skill-export.service.ts) and
- * writes them onto disk as standard Agent Skills folders: `<dir>/<slug>/SKILL.md`.
- *
- * THE IDEMPOTENCY KEY IS `metadata.cluster_key`, NOT the folder name or the
- * skill's title. `runSkillDistillation()` upserts on cluster_key and
- * rewrites `content`/`name`/`description` IN PLACE on every scheduler tick
- * that adds a verified session to an existing cluster -- and because the
- * server-side slug includes a human-readable title prefix, a title rewrite
- * can change the freshly-computed slug even though the underlying cluster
- * (and its intended on-disk folder) is unchanged. A sync that keyed off the
- * freshly-computed slug/title would silently FORK a second folder on the
- * next run. This module instead reads each existing local folder's own
- * `metadata.cluster_key` back out of its `SKILL.md` frontmatter (no
- * separate sidecar index file to go stale) and, when a remote skill's
- * cluster_key matches an existing folder, REWRITES THAT FOLDER IN PLACE --
- * even if the server just handed back a different slug for it.
- *
- * Orphans (a local folder whose cluster_key is no longer present in the
- * remote payload -- the source context was deleted, archived, or its
- * consent was revoked) are REPORTED, never auto-deleted: the file may carry
- * user edits.
- *
- * Network-free and fully unit-testable: `fetchSkills` is injected rather
- * than hard-wired to `fetch()`, so tests exercise the on-disk merge logic
- * against an in-memory payload with no server needed.
- */
-import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-/**
- * Pull a scalar value out of the `metadata:` frontmatter block this project
- * renders (src/services/skill-export.service.ts / yamlString()). Format is
- * fixed and self-controlled (both write and read side live in this repo),
- * so a small anchored regex is enough -- no general YAML parser needed.
- * `^  <key>: "..."$` in multiline mode only matches an indented entry under
- * `metadata:`, never the top-level `name:`/`description:` lines.
- */
-export function extractFrontmatterMetadataValue(markdown, key) {
-    const re = new RegExp(`^ {2}${key}: "((?:[^"\\\\]|\\\\.)*)"$`, 'm');
-    const match = markdown.match(re);
-    if (!match)
-        return null;
-    // Reverses yamlString()'s escaping (`\` -> `\\`, `"` -> `\"`): a backslash
-    // followed by any one character collapses to that character.
-    return match[1].replace(/\\(.)/g, '$1');
-}
-export function extractClusterKey(markdown) {
-    return extractFrontmatterMetadataValue(markdown, 'cluster_key');
-}
-/**
- * Discover existing skill folders directly under `dir` by reading each
- * `SKILL.md`'s own `cluster_key` back out -- this IS the persisted index;
- * there is no separate sidecar file to go stale. A subdirectory with no
- * `SKILL.md`, or a `SKILL.md` with no parseable `cluster_key` (not one this
- * tool wrote, or hand-edited past recognition), is left alone entirely --
- * never treated as ours to manage.
- */
-function scanLocalSkills(dir) {
-    if (!existsSync(dir))
-        return [];
-    const entries = [];
-    for (const name of readdirSync(dir)) {
-        const folderPath = join(dir, name);
-        if (!statSync(folderPath).isDirectory())
-            continue;
-        const skillPath = join(folderPath, 'SKILL.md');
-        if (!existsSync(skillPath))
-            continue;
-        const content = readFileSync(skillPath, 'utf-8');
-        const clusterKey = extractClusterKey(content);
-        if (!clusterKey)
-            continue;
-        entries.push({ folder: name, clusterKey });
-    }
-    return entries;
-}
-/** Rewrite the top-level `name: <slug>` frontmatter line to match `folder`,
- *  so `frontmatter.name` stays equal to the actual directory name (Agent
- *  Skills convention) even when an existing folder is being reused under a
- *  different name than the server's freshly-computed slug. Anchored to
- *  start-of-line so it can never touch the indented `metadata:` entries. */
-function withFrontmatterName(markdown, folder) {
-    return markdown.replace(/^name: .+$/m, `name: ${folder}`);
-}
-export async function syncSkills(opts) {
-    mkdirSync(opts.dir, { recursive: true });
-    const local = scanLocalSkills(opts.dir);
-    const localByClusterKey = new Map(local.map((e) => [e.clusterKey, e.folder]));
-    const usedFolders = new Set(local.map((e) => e.folder));
-    const remote = await opts.fetchSkills();
-    const result = { written: [], updated: [], unchanged: [], orphans: [] };
-    const seenClusterKeys = new Set();
-    for (const skill of remote) {
-        seenClusterKeys.add(skill.clusterKey);
-        const existingFolder = localByClusterKey.get(skill.clusterKey);
-        let folder = existingFolder;
-        if (!folder) {
-            // Brand-new cluster. Prefer the server-computed slug; only fall back
-            // to a suffixed name if an UNRELATED local folder already occupies
-            // it (astronomically unlikely given the slug's hash suffix, but
-            // deterministic and collision-safe rather than silently colliding).
-            folder = usedFolders.has(skill.slug) ? `${skill.slug}-c${skill.contextId}` : skill.slug;
-            usedFolders.add(folder);
-            localByClusterKey.set(skill.clusterKey, folder);
-        }
-        const markdown = folder === skill.slug ? skill.markdown : withFrontmatterName(skill.markdown, folder);
-        const folderPath = join(opts.dir, folder);
-        const skillPath = join(folderPath, 'SKILL.md');
-        const previous = existsSync(skillPath) ? readFileSync(skillPath, 'utf-8') : null;
-        if (previous === markdown) {
-            result.unchanged.push(folder);
-            continue;
-        }
-        mkdirSync(folderPath, { recursive: true });
-        writeFileSync(skillPath, markdown, 'utf-8');
-        result[previous === null ? 'written' : 'updated'].push(folder);
-    }
-    for (const entry of local) {
-        if (!seenClusterKeys.has(entry.clusterKey)) {
-            result.orphans.push(entry.folder);
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=skills-sync.js.map

package/dist/skills-sync.js.map

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

package/dist/slug.d.ts

@@ -1,48 +0,0 @@
-/**
- * slug.ts — shared slug validation/sanitization for --agent / --workspace.
- *
- * T656: the installer used to accept --agent / --workspace verbatim (or fall
- * back to basename(root), a directory name that can legally contain shell
- * metacharacters) and interpolate them, unescaped, into a shell command
- * string written into .claude/settings.local.json's SessionStart hook. That
- * command runs through a shell on every future session start in the target
- * repo, so an unsanitized value there is an auto-executing injection.
- *
- * SLUG_PATTERN mirrors the slug shape the server itself converges on: every
- * `slugify()` in the API (src/services/workspace.service.ts,
- * context.service.ts, tenant-slug.ts) lowercases, then collapses any run of
- * non [a-z0-9] chars to a single '-', then trims leading/trailing '-'. That
- * output is always a subset of [a-z0-9][a-z0-9_-]{0,63} — this pattern adds
- * '_' too (never produced by slugify(), but a common human-typed separator)
- * and stays deliberately ASCII-lowercase-only so the exact same pattern can
- * gate both --agent and --workspace with one rule: CLAUDE.md documents
- * "Workspace slugs are always lowercase" as a product convention, and this
- * installer extends that same lowercase-only discipline to --agent too
- * rather than maintaining two different regexes for two fields that both
- * end up as shell-interpolated env var values. This is a deliberately
- * STRICTER-than-the-API client-side gate (the boot API's `agent` field is
- * just `z.string().min(1).max(64)` with no charset check server-side) — the
- * goal here is never producing a value the API would reject, not permitting
- * everything the API happens to tolerate.
- */
-export declare const SLUG_PATTERN: RegExp;
-export declare const SLUG_PATTERN_DESCRIPTION = "lowercase letters, digits, \"-\", \"_\" (must start with a letter/digit, max 64 chars)";
-/**
- * Validates an EXPLICIT (user-typed) flag value against SLUG_PATTERN.
- * Throws a clear, actionable error naming the flag, the offending value, and
- * the allowed pattern -- never silently truncates or mutates an explicit
- * value (the caller may choose to lowercase --workspace first, since
- * workspace slugs are documented as always-lowercase in this product; see
- * index.ts). No such courtesy applies to --agent, which has no such
- * documented casing convention.
- */
-export declare function validateSlug(value: string, flagName: string): string;
-/**
- * Sanitizes a FALLBACK value (basename(root) -- the user never typed this,
- * it came from the filesystem) into something that always satisfies
- * SLUG_PATTERN: lowercase, replace every disallowed run with a single '-',
- * trim leading/trailing separators, cap at 64 chars. An empty result (e.g.
- * a directory name made entirely of disallowed characters) falls back to
- * the fixed default 'default' rather than producing an empty/invalid slug.
- */
-export declare function sanitizeSlugFallback(raw: string): string;

package/dist/slug.js

@@ -1,62 +0,0 @@
-/**
- * slug.ts — shared slug validation/sanitization for --agent / --workspace.
- *
- * T656: the installer used to accept --agent / --workspace verbatim (or fall
- * back to basename(root), a directory name that can legally contain shell
- * metacharacters) and interpolate them, unescaped, into a shell command
- * string written into .claude/settings.local.json's SessionStart hook. That
- * command runs through a shell on every future session start in the target
- * repo, so an unsanitized value there is an auto-executing injection.
- *
- * SLUG_PATTERN mirrors the slug shape the server itself converges on: every
- * `slugify()` in the API (src/services/workspace.service.ts,
- * context.service.ts, tenant-slug.ts) lowercases, then collapses any run of
- * non [a-z0-9] chars to a single '-', then trims leading/trailing '-'. That
- * output is always a subset of [a-z0-9][a-z0-9_-]{0,63} — this pattern adds
- * '_' too (never produced by slugify(), but a common human-typed separator)
- * and stays deliberately ASCII-lowercase-only so the exact same pattern can
- * gate both --agent and --workspace with one rule: CLAUDE.md documents
- * "Workspace slugs are always lowercase" as a product convention, and this
- * installer extends that same lowercase-only discipline to --agent too
- * rather than maintaining two different regexes for two fields that both
- * end up as shell-interpolated env var values. This is a deliberately
- * STRICTER-than-the-API client-side gate (the boot API's `agent` field is
- * just `z.string().min(1).max(64)` with no charset check server-side) — the
- * goal here is never producing a value the API would reject, not permitting
- * everything the API happens to tolerate.
- */
-export const SLUG_PATTERN = /^[a-z0-9][a-z0-9_-]{0,63}$/;
-export const SLUG_PATTERN_DESCRIPTION = 'lowercase letters, digits, "-", "_" (must start with a letter/digit, max 64 chars)';
-/**
- * Validates an EXPLICIT (user-typed) flag value against SLUG_PATTERN.
- * Throws a clear, actionable error naming the flag, the offending value, and
- * the allowed pattern -- never silently truncates or mutates an explicit
- * value (the caller may choose to lowercase --workspace first, since
- * workspace slugs are documented as always-lowercase in this product; see
- * index.ts). No such courtesy applies to --agent, which has no such
- * documented casing convention.
- */
-export function validateSlug(value, flagName) {
-    if (!SLUG_PATTERN.test(value)) {
-        throw new Error(`${flagName} value "${value}" is not a valid slug -- allowed: ${SLUG_PATTERN_DESCRIPTION}`);
-    }
-    return value;
-}
-/**
- * Sanitizes a FALLBACK value (basename(root) -- the user never typed this,
- * it came from the filesystem) into something that always satisfies
- * SLUG_PATTERN: lowercase, replace every disallowed run with a single '-',
- * trim leading/trailing separators, cap at 64 chars. An empty result (e.g.
- * a directory name made entirely of disallowed characters) falls back to
- * the fixed default 'default' rather than producing an empty/invalid slug.
- */
-export function sanitizeSlugFallback(raw) {
-    let out = raw
-        .toLowerCase()
-        .replace(/[^a-z0-9_-]+/g, '-')
-        .replace(/^[-_]+|[-_]+$/g, '');
-    out = out.slice(0, 64);
-    out = out.replace(/[-_]+$/g, '');
-    return out === '' ? 'default' : out;
-}
-//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,oFAAoF,CAAC;AAE7H;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,QAAgB;IAC1D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,WAAW,KAAK,qCAAqC,wBAAwB,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,GAAG,GAAG,GAAG;SACV,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;SAC7B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAEjC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAEjC,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC"}

package/dist/tasks-init.d.ts

@@ -1,14 +0,0 @@
-/**
- * tasks-init.ts — scaffold .contextq/tasks/TASKS.md.
- *
- * Mirrors skills/contextq/scripts/ctq-tasks-init.sh 1:1 (same manifest
- * header, same idempotent "leave it alone if it exists" behavior, same
- * narrow 3-line .gitignore patch for the churny per-machine overlay files).
- * Does not touch anything else in .gitignore.
- */
-export interface TasksInitResult {
-    path: string;
-    action: 'created' | 'skipped';
-    detail: string;
-}
-export declare function initTasksDir(root: string): TasksInitResult;

package/dist/tasks-init.js

@@ -1,51 +0,0 @@
-/**
- * tasks-init.ts — scaffold .contextq/tasks/TASKS.md.
- *
- * Mirrors skills/contextq/scripts/ctq-tasks-init.sh 1:1 (same manifest
- * header, same idempotent "leave it alone if it exists" behavior, same
- * narrow 3-line .gitignore patch for the churny per-machine overlay files).
- * Does not touch anything else in .gitignore.
- */
-import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { basename, join } from 'node:path';
-function manifestHeader(project) {
-    return `# Tasks: ${project}
-<!-- ctq-tasks manifest v1 (T442, repo-local fork of nf-tasks). Status tokens: [backlog] [todo] [doing] [done] [forbidden]. -->
-<!-- "blocked" is DERIVED — never a manual status. Two kinds: deps not all [done], OR a -->
-<!-- "blocker: <reason>" line on a [todo] (external wait); clear the line to release it. -->
-<!-- [backlog] = not ready yet; excluded from run planning. Promote with: flip todo <id> -->
-<!-- [forbidden] = too dangerous to ever run — permanent tombstone. Add 'reason: <why>'. -->
-<!--   Never archived. Flip back to todo only if mis-classified. -->
-<!--   Set with: flip forbidden <id>  -->
-<!-- Task header format is parsed: "## T<NN> [status] <free-text title>". Keep the id+status shape. -->
-<!-- See docs/tech/ctq-tasks-sync.md for the field mapping this manifest syncs against. -->
-
-`;
-}
-function patchGitignore(root) {
-    if (!existsSync(join(root, '.git')))
-        return;
-    const gitignorePath = join(root, '.gitignore');
-    const patterns = ['.contextq/tasks/status.log', '.contextq/tasks/.reconcile.lock/', '.contextq/tasks/sync-map.json'];
-    const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';
-    const existingLines = new Set(existing.split('\n').map((line) => line.trim()));
-    const missing = patterns.filter((p) => !existingLines.has(p));
-    if (missing.length === 0)
-        return;
-    const block = '\n# .contextq/tasks/ — TASKS.md + TASKS_ARCHIVE.md are tracked; the\n' +
-        '# overlay/lock/sync-map below are machine-local and ephemeral\n' +
-        missing.map((p) => `${p}\n`).join('');
-    appendFileSync(gitignorePath, block);
-}
-export function initTasksDir(root) {
-    const tasksDir = join(root, '.contextq', 'tasks');
-    const manifest = join(tasksDir, 'TASKS.md');
-    mkdirSync(tasksDir, { recursive: true });
-    patchGitignore(root);
-    if (existsSync(manifest)) {
-        return { path: manifest, action: 'skipped', detail: 'manifest already exists — left untouched' };
-    }
-    writeFileSync(manifest, manifestHeader(basename(root)));
-    return { path: manifest, action: 'created', detail: 'task manifest scaffolded' };
-}
-//# sourceMappingURL=tasks-init.js.map

package/dist/tasks-init.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tasks-init.js","sourceRoot":"","sources":["../src/tasks-init.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQ3C,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,YAAY,OAAO;;;;;;;;;;;CAW3B,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO;IAE5C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,CAAC,4BAA4B,EAAE,kCAAkC,EAAE,+BAA+B,CAAC,CAAC;IAErH,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,MAAM,KAAK,GACT,uEAAuE;QACvE,iEAAiE;QACjE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExC,cAAc,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE5C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,cAAc,CAAC,IAAI,CAAC,CAAC;IAErB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC;IACnG,CAAC;IAED,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;AACnF,CAAC"}