kortext 2.2.0 → 3.0.0

package/dist/server/engine/item-lifecycle.js

@@ -0,0 +1,74 @@
+const TRANSITIONS = {
+    start: { from: ['to_do'], to: 'in_progress' },
+    review: { from: ['in_progress'], to: 'review' },
+    done: { from: ['review'], to: 'done' },
+    block: { from: ['in_progress', 'review'], to: 'blocked' },
+    unblock: { from: ['blocked'], to: 'in_progress' },
+    cancel: { from: ['to_do', 'in_progress', 'review', 'blocked'], to: 'cancelled' },
+};
+const TERMINAL_STATES = new Set(['done', 'cancelled']);
+export class IllegalTransitionError extends Error {
+    itemId;
+    transition;
+    fromStatus;
+    constructor(itemId, transition, fromStatus) {
+        super(`illegal transition '${transition}' on item ${itemId} from status '${fromStatus}'`);
+        this.itemId = itemId;
+        this.transition = transition;
+        this.fromStatus = fromStatus;
+        this.name = 'IllegalTransitionError';
+    }
+}
+export class ItemLifecycle {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    create(input) {
+        if (input.owner && this.opts.personas.get(input.owner) === null) {
+            throw new Error(`unknown persona for owner: ${input.owner}`);
+        }
+        return this.opts.repos.backlog.create({
+            id: input.id,
+            type: input.type,
+            title: input.title,
+            owner: input.owner ?? null,
+            parent_id: input.parent_id ?? null,
+            body_md: input.body_md ?? '',
+        });
+    }
+    transition(itemId, action, by, reason) {
+        const current = this.opts.repos.backlog.get(itemId);
+        if (!current) {
+            throw new Error(`backlog item not found: ${itemId}`);
+        }
+        if (TERMINAL_STATES.has(current.status)) {
+            throw new IllegalTransitionError(itemId, action, current.status);
+        }
+        const rule = TRANSITIONS[action];
+        if (!rule.from.includes(current.status)) {
+            throw new IllegalTransitionError(itemId, action, current.status);
+        }
+        const updated = this.opts.repos.backlog.transitionStatus(itemId, rule.to);
+        this.opts.repos.auditLog.append({
+            actor: by,
+            action: 'item_transition',
+            resource_type: 'backlog_item',
+            resource_id: itemId,
+            payload: {
+                from: current.status,
+                to: rule.to,
+                transition: action,
+                reason: reason ?? null,
+            },
+        });
+        return updated;
+    }
+    /** Items in any non-terminal state — useful for dashboard "active" view. */
+    listOpen() {
+        return this.opts.repos.backlog
+            .list({ limit: 1000 })
+            .filter((i) => !TERMINAL_STATES.has(i.status));
+    }
+}
+//# sourceMappingURL=item-lifecycle.js.map

package/dist/server/engine/item-lifecycle.js.map

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

package/dist/server/engine/persona-registry.js

@@ -0,0 +1,108 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+const H1_RE = /^#\s+([\w-]+)\s*$/;
+const DESCRIPTION_RE = /^-\s*description\s*:\s*(.+?)\s*$/i;
+export function parsePersonaMarkdown(source, fileId) {
+    const lines = source.split('\n');
+    let handleId = null;
+    let description = null;
+    for (const raw of lines) {
+        const line = raw.replace(/\r$/, '');
+        if (handleId === null) {
+            const m = line.match(H1_RE);
+            if (m?.[1]) {
+                handleId = m[1];
+                continue;
+            }
+        }
+        if (description === null) {
+            const d = line.match(DESCRIPTION_RE);
+            if (d?.[1]) {
+                description = d[1];
+            }
+        }
+        if (handleId !== null && description !== null)
+            break;
+    }
+    if (!handleId) {
+        throw new Error(`missing H1 handle (expected '# <handle>') in ${fileId}`);
+    }
+    if (!description) {
+        throw new Error(`missing '- description:' bullet in ${fileId}`);
+    }
+    return {
+        handle: `+${handleId}`,
+        id: handleId,
+        description,
+        systemPrompt: source,
+    };
+}
+export function loadPersonasFromDir(dir) {
+    const dirStat = statSync(dir);
+    if (!dirStat.isDirectory()) {
+        throw new Error(`persona registry: not a directory: ${dir}`);
+    }
+    const byHandle = new Map();
+    const errors = [];
+    const refresh = () => {
+        byHandle.clear();
+        errors.length = 0;
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isFile())
+                continue;
+            if (!entry.name.endsWith('.md'))
+                continue;
+            const fullPath = join(dir, entry.name);
+            const fileId = basename(entry.name, '.md');
+            try {
+                const source = readFileSync(fullPath, 'utf8');
+                const def = parsePersonaMarkdown(source, fileId);
+                byHandle.set(def.handle, def);
+            }
+            catch (err) {
+                errors.push({
+                    file: entry.name,
+                    reason: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    };
+    refresh();
+    return {
+        get(handle) {
+            const canonical = handle.startsWith('+') ? handle : `+${handle}`;
+            return byHandle.get(canonical) ?? null;
+        },
+        list() {
+            return [...byHandle.values()];
+        },
+        errors() {
+            return [...errors];
+        },
+        reload: refresh,
+    };
+}
+/**
+ * Shared prompt resolver for CLI executors.
+ *
+ * If `source` is a registry, look up the canonical systemPrompt. Otherwise
+ * fall back to a disk-direct read from `<agentsDir>/<handle>.md` — the
+ * pre-Faz-5 behavior, kept for tests and stand-alone use.
+ *
+ * Returns an empty string when the persona is unknown / file missing. The
+ * caller decides whether that's an error (CLI executors silently continue
+ * today; `kortext doctor` raises it as a consistency finding).
+ */
+export function readPersonaPrompt(handle, source) {
+    if (!handle)
+        return '';
+    if ('list' in source) {
+        return source.get(handle)?.systemPrompt ?? '';
+    }
+    const id = handle.replace(/^\+/, '');
+    const path = join(source.agentsDir, `${id}.md`);
+    if (!existsSync(path))
+        return '';
+    return readFileSync(path, 'utf8');
+}
+//# sourceMappingURL=persona-registry.js.map

package/dist/server/engine/persona-registry.js.map

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

package/dist/server/engine/worker-pool.js

@@ -0,0 +1,324 @@
+import { isAbsolute, join } from 'node:path';
+import { readFileSync } from 'node:fs';
+async function runSafetyGuards(step, logPath, safety, worktreePath, runId) {
+    if (!safety)
+        return null;
+    const outputFiles = step.outputs.map((rel) => isAbsolute(rel) ? rel : join(worktreePath, rel));
+    const filesToScan = logPath ? [...outputFiles, logPath] : outputFiles;
+    if (safety.secretScanner && filesToScan.length > 0) {
+        const report = await safety.secretScanner.scanForStep(runId, filesToScan);
+        if (report.shouldFailRun) {
+            const f = report.findings[0];
+            return `secret/token detected in step output: ${f?.finding_type} at ${f?.scanned_path}:${f?.line_number}`;
+        }
+    }
+    if (safety.harmfulFilter && filesToScan.length > 0) {
+        for (const file of filesToScan) {
+            let body;
+            try {
+                body = readFileSync(file, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            const report = safety.harmfulFilter.scanText(body);
+            if (report.shouldFailRun) {
+                const f = report.findings[0];
+                return `banned/harmful phrase detected in ${file}:${f?.line_number} — ${f?.message}`;
+            }
+        }
+    }
+    return null;
+}
+export async function runWorkflow(graph, executor, repos, options = {}) {
+    const concurrency = Math.max(1, options.concurrency ?? 3);
+    const triggeredBy = options.triggeredBy ?? 'system';
+    const run = repos.runs.createRun({
+        workflow_id: graph.workflowId,
+        item_id: options.itemId ?? null,
+        status: 'queued',
+        worktree_path: options.worktreePath ?? null,
+        triggered_by: triggeredBy,
+    });
+    repos.runs.transitionRun(run.id, 'running');
+    repos.auditLog.append({
+        actor: 'system',
+        action: 'pipeline.started',
+        resource_type: 'run',
+        resource_id: String(run.id),
+        payload: { workflow_id: graph.workflowId, concurrency },
+    });
+    // Pre-create step rows so the dashboard can render the full plan immediately.
+    const stepRowByKey = new Map();
+    const orderedNodes = [...graph.nodes.values()].sort((a, b) => a.step.index - b.step.index);
+    const preCompleted = options.preCompletedStepKeys ?? new Set();
+    for (const node of orderedNodes) {
+        const isResumed = preCompleted.has(node.step.key);
+        const row = repos.runs.addStep({
+            run_id: run.id,
+            step_index: node.step.index,
+            step_name: `${node.step.phase} — ${node.step.persona ?? '(no persona)'}: ${node.step.description.slice(0, 80)}`,
+            persona: node.step.persona,
+            status: 'pending',
+        });
+        stepRowByKey.set(node.step.key, row.id);
+        if (isResumed) {
+            repos.runs.transitionStep(row.id, 'skipped', {
+                output_summary: 'resumed-from-previous-run',
+            });
+        }
+    }
+    const gateByStepIndex = new Map();
+    for (const gate of options.gates ?? []) {
+        if (gate.afterStepIndex >= 0)
+            gateByStepIndex.set(gate.afterStepIndex, gate);
+    }
+    const firedGateIndices = new Set();
+    let pendingGate = null;
+    let rejectionReason = null;
+    // Resumed runs (Orchestrator.retryRun) replay the lowest gate that sat
+    // *after* one of the resumed steps. Without this, the scheduler's barrier
+    // would block forever — the gate would never fire because the step that
+    // would have fired it was pre-marked as skipped.
+    for (const node of orderedNodes) {
+        if (!preCompleted.has(node.step.key))
+            continue;
+        const gate = gateByStepIndex.get(node.step.index);
+        if (gate && !pendingGate) {
+            pendingGate = gate;
+            firedGateIndices.add(gate.afterStepIndex);
+            repos.auditLog.append({
+                actor: 'orchestrator',
+                action: 'gate.paused',
+                resource_type: 'run',
+                resource_id: String(run.id),
+                payload: {
+                    phase: gate.phase,
+                    after_step_index: gate.afterStepIndex,
+                    reason: 'resumed',
+                },
+            });
+        }
+    }
+    const done = new Set(preCompleted);
+    const running = new Map();
+    const aborter = new AbortController();
+    let failedStepKey = null;
+    let firstError = null;
+    const ctxFor = (runStepId) => ({
+        workflowId: graph.workflowId,
+        runId: run.id,
+        runStepId,
+        worktreePath: options.worktreePath ?? process.cwd(),
+        signal: aborter.signal,
+    });
+    const launch = (stepKey) => {
+        const node = graph.nodes.get(stepKey);
+        if (!node)
+            return;
+        const runStepId = stepRowByKey.get(stepKey);
+        repos.runs.transitionStep(runStepId, 'running');
+        repos.auditLog.append({
+            actor: executor.name,
+            action: 'pipeline.step.started',
+            resource_type: 'run_step',
+            resource_id: String(runStepId),
+            payload: { run_id: run.id, step_key: stepKey, persona: node.step.persona },
+        });
+        const promise = executor
+            .execute(node.step, ctxFor(runStepId))
+            .then(async (result) => {
+            if (result.ok) {
+                // Apply safety guards before we mark the step as succeeded.
+                const safetyError = await runSafetyGuards(node.step, result.logPath ?? null, options.safety, options.worktreePath ?? process.cwd(), run.id);
+                if (safetyError) {
+                    repos.runs.transitionStep(runStepId, 'failed', {
+                        output_summary: result.outputSummary ?? null,
+                        error_message: safetyError,
+                        log_path: result.logPath ?? null,
+                    });
+                    repos.auditLog.append({
+                        actor: 'safety',
+                        action: 'pipeline.step.failed',
+                        resource_type: 'run_step',
+                        resource_id: String(runStepId),
+                        payload: { run_id: run.id, step_key: stepKey, error: safetyError },
+                    });
+                    if (!failedStepKey) {
+                        failedStepKey = stepKey;
+                        firstError = safetyError;
+                        aborter.abort();
+                    }
+                    return;
+                }
+                repos.runs.transitionStep(runStepId, 'succeeded', {
+                    output_summary: result.outputSummary ?? null,
+                    log_path: result.logPath ?? null,
+                });
+                repos.auditLog.append({
+                    actor: executor.name,
+                    action: 'pipeline.step.succeeded',
+                    resource_type: 'run_step',
+                    resource_id: String(runStepId),
+                    payload: { run_id: run.id, step_key: stepKey },
+                });
+                done.add(stepKey);
+                // Gate trigger: a gate fires once after the step at its afterStepIndex completes.
+                const gate = gateByStepIndex.get(node.step.index);
+                if (gate && !firedGateIndices.has(gate.afterStepIndex)) {
+                    firedGateIndices.add(gate.afterStepIndex);
+                    pendingGate = gate;
+                    repos.auditLog.append({
+                        actor: 'orchestrator',
+                        action: 'gate.paused',
+                        resource_type: 'run',
+                        resource_id: String(run.id),
+                        payload: { phase: gate.phase, after_step_index: gate.afterStepIndex },
+                    });
+                }
+            }
+            else {
+                repos.runs.transitionStep(runStepId, 'failed', {
+                    output_summary: result.outputSummary ?? null,
+                    error_message: result.errorMessage ?? 'unknown failure',
+                    log_path: result.logPath ?? null,
+                });
+                repos.auditLog.append({
+                    actor: executor.name,
+                    action: 'pipeline.step.failed',
+                    resource_type: 'run_step',
+                    resource_id: String(runStepId),
+                    payload: { run_id: run.id, step_key: stepKey, error: result.errorMessage },
+                });
+                if (!failedStepKey) {
+                    failedStepKey = stepKey;
+                    firstError = result.errorMessage ?? null;
+                    aborter.abort();
+                }
+            }
+        })
+            .catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            repos.runs.transitionStep(runStepId, 'failed', { error_message: msg });
+            if (!failedStepKey) {
+                failedStepKey = stepKey;
+                firstError = msg;
+                aborter.abort();
+            }
+        })
+            .finally(() => {
+            running.delete(stepKey);
+        });
+        running.set(stepKey, promise);
+    };
+    // Scheduler loop.
+    while (done.size + (failedStepKey ? 1 : 0) < graph.size ||
+        running.size > 0 ||
+        pendingGate !== null) {
+        // Gate barrier: when a gate is pending we drain in-flight work first,
+        // then ask the controller for approve/reject before scheduling more steps.
+        const gateToProcess = pendingGate;
+        if (gateToProcess && running.size === 0 && !failedStepKey && !rejectionReason) {
+            if (!options.gateController) {
+                throw new Error(`gate encountered but no gateController provided (phase: ${gateToProcess.phase})`);
+            }
+            pendingGate = null;
+            const decision = await options.gateController.pauseAtGate({
+                gate: gateToProcess,
+                runId: run.id,
+                workflowId: graph.workflowId,
+            });
+            if (decision.decision === 'approve') {
+                repos.auditLog.append({
+                    actor: 'orchestrator',
+                    action: 'gate.resumed',
+                    resource_type: 'run',
+                    resource_id: String(run.id),
+                    payload: { phase: gateToProcess.phase, decision: 'approve' },
+                });
+            }
+            else {
+                rejectionReason = decision.reason;
+                repos.auditLog.append({
+                    actor: 'orchestrator',
+                    action: 'gate.rejected',
+                    resource_type: 'run',
+                    resource_id: String(run.id),
+                    payload: { phase: gateToProcess.phase, reason: decision.reason },
+                });
+                aborter.abort();
+            }
+        }
+        if (!failedStepKey && !rejectionReason && !pendingGate) {
+            // Gate barrier: do not start any step whose index lies past an un-fired gate.
+            // This makes gates semantically equivalent to a phase boundary even when the
+            // pure data-flow DAG sees later steps as already runnable in parallel.
+            let barrier = Number.POSITIVE_INFINITY;
+            for (const idx of gateByStepIndex.keys()) {
+                if (!firedGateIndices.has(idx) && idx < barrier)
+                    barrier = idx;
+            }
+            const ready = graph.readyKeys(done).filter((k) => {
+                if (running.has(k))
+                    return false;
+                const node = graph.nodes.get(k);
+                if (node && node.step.index > barrier)
+                    return false;
+                return true;
+            });
+            while (ready.length > 0 && running.size < concurrency) {
+                const next = ready.shift();
+                launch(next);
+            }
+        }
+        if (running.size === 0 && !pendingGate)
+            break;
+        if (running.size > 0) {
+            await Promise.race(running.values());
+        }
+    }
+    // Mark any un-started steps as skipped (only happens after failure or rejection).
+    if (failedStepKey || rejectionReason) {
+        for (const [key, rowId] of stepRowByKey) {
+            if (done.has(key))
+                continue;
+            if (key === failedStepKey)
+                continue;
+            const row = repos.runs.getStep(rowId);
+            if (row && row.status === 'pending') {
+                repos.runs.transitionStep(rowId, 'skipped');
+            }
+        }
+    }
+    let finalStatus;
+    let finalError;
+    if (rejectionReason) {
+        finalStatus = 'cancelled';
+        finalError = `rejected: ${rejectionReason}`;
+    }
+    else if (failedStepKey) {
+        finalStatus = 'failed';
+        finalError = firstError;
+    }
+    else {
+        finalStatus = 'succeeded';
+        finalError = null;
+    }
+    const finalRun = repos.runs.transitionRun(run.id, finalStatus, {
+        error_message: finalError,
+    });
+    repos.auditLog.append({
+        actor: 'system',
+        action: `pipeline.${finalStatus}`,
+        resource_type: 'run',
+        resource_id: String(run.id),
+        payload: {
+            workflow_id: graph.workflowId,
+            failed_step: failedStepKey,
+            step_count: graph.size,
+            rejection_reason: rejectionReason,
+        },
+    });
+    return { run: finalRun, failedStepKey };
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/server/engine/worker-pool.js.map

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

package/dist/server/engine/workflow-loader.js

@@ -0,0 +1,55 @@
+import { readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadWorkflowFromFile, } from "./workflow-parser.js";
+/**
+ * Scan `dir` and build a registry of workflows.
+ *
+ * - Only `*.md` files at the top level are considered (no recursion).
+ * - Files that parse to zero steps are treated as malformed: they go to
+ *   `errors()` and are NOT included in `list()`/`get()`.
+ * - A non-existent directory throws — this is a config bug, not an
+ *   operational error.
+ */
+export function loadWorkflowsFromDir(dir) {
+    // statSync throws ENOENT for missing dirs — that's the contract.
+    const dirStat = statSync(dir);
+    if (!dirStat.isDirectory()) {
+        throw new Error(`workflow loader: not a directory: ${dir}`);
+    }
+    const definitions = new Map();
+    const errors = [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (!entry.name.endsWith('.md'))
+            continue;
+        const fullPath = join(dir, entry.name);
+        try {
+            const def = loadWorkflowFromFile(fullPath);
+            if (def.steps.length === 0) {
+                errors.push({ file: entry.name, reason: 'no steps parsed (empty workflow)' });
+                continue;
+            }
+            definitions.set(def.id, def);
+        }
+        catch (err) {
+            errors.push({
+                file: entry.name,
+                reason: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        get(id) {
+            return definitions.get(id) ?? null;
+        },
+        list() {
+            return [...definitions.values()];
+        },
+        errors() {
+            return [...errors];
+        },
+    };
+}
+//# sourceMappingURL=workflow-loader.js.map

package/dist/server/engine/workflow-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-loader.js","sourceRoot":"","sources":["../../../server/engine/workflow-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,oBAAoB,GAErB,MAAM,sBAAsB,CAAC;AA4B9B;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,iEAAiE;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAE1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;gBAC9E,SAAS;YACX,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,CAAC,EAAE;YACJ,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QACrC,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,MAAM;YACJ,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}