@software-dlc/cli 0.157.2

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @software-dlc/cli
+
+## 0.157.2
+
+## 0.157.1
+
+## 0.157.0
+
+### Minor Changes
+
+- 2086842: Graph: the sdlc CLI and its MCP servers publish as @software-dlc/cli, which replaces @software-dlc/sdlc with the same bins and exports (`@software-dlc/cli/mcp`, `@software-dlc/cli/portable`) and no coordination engine; a version refusal (`@software-dlc/graph/client/api-version`) says `npm install -g @software-dlc/cli@latest`

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-ALv2
+
+## Notice
+
+Copyright 2026 SoftwareDLC Inc.
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -0,0 +1,31 @@
+# @software-dlc/cli
+
+The `sdlc` command and the local MCP servers that read and change an SDLC
+graph of your code on your own machine. It needs no SoftwareDLC account: a
+graph lives in your repository's Git common directory, and nothing is written
+to your tracked files.
+
+```bash
+npm install -g @software-dlc/cli
+sdlc workspace init
+sdlc --help
+```
+
+It ships three commands:
+
+| Command | What it does |
+| --- | --- |
+| `sdlc` | the local graph workflow: workspaces, commits, source evidence, packages, `sdlc viewer`, and the hosted sync when a project is connected |
+| `sdlc-worktree-mcp` | the MCP server the SoftwareDLC plugin starts in a repository you approved with `sdlc allow-mcp` |
+| `sdlc-graph-to-code-mcp` | the MCP server for a hosted project's Developer API |
+
+The graph libraries it uses are `@software-dlc/graph`, which it depends on at
+an exact version.
+
+## Changes and migrations
+
+The installed package carries its changelog and migration guides:
+`node_modules/@software-dlc/cli/CHANGELOG.md` and
+`node_modules/@software-dlc/cli/migrations/`, one `<version>.md` guide for
+each version that needs a migration. Each guide starts with a JSON header
+naming the features and stores it changes, then the steps.

package/dist/checkout.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Where `sdlc view` and the viewer's Worktrees page find the repository and the view's code: a
+ * SoftwareDLC checkout's own, or the packaged engine's (iss-473). Public, beside the view seam:
+ * the CLI says outside a Git repository that it needs one before it says what to install, and the
+ * view code (cli-view) imports it from here.
+ */
+/** What `sdlc view` says in a workspace build with no packaged engine, outside a SoftwareDLC checkout. */
+export declare const NOT_A_SOFTWAREDLC_CHECKOUT = "sdlc view shows the local SDLC threads of a SoftwareDLC checkout, and this directory is not in one (its main checkout has no packages/sdlc and tools/vscode-threads).";
+/** What `sdlc view` says when SDLC_VIEW_ROOT names no view code: never another engine's view in its place. */
+export declare const NOT_A_VIEW_ROOT = "sdlc view runs the view code of the checkout SDLC_VIEW_ROOT names, and it names no SoftwareDLC checkout with tools/vscode-threads.";
+/** What `sdlc view` says outside a Git repository. */
+export declare const NOT_A_GIT_REPOSITORY = "sdlc view shows the local SDLC threads of a Git repository, and this directory is not in one.";
+/** The repository the current directory belongs to: its main checkout and current worktree. */
+export declare function locateCheckout(cwd: string): {
+    main: string;
+    worktree: string;
+} | null;
+/**
+ * Where the view's code comes from: the main checkout of a SoftwareDLC repository, never the
+ * current worktree's branch, so viewing does not run code a branch under review changed.
+ * SDLC_VIEW_ROOT names another checkout explicitly, for working on the view itself.
+ */
+export declare function viewCodeRoot(checkout: {
+    main: string;
+    worktree: string;
+} | null, override?: string | undefined): string | null;
+/**
+ * Where an engine root keeps its commands and the view's code: a SoftwareDLC checkout's
+ * scripts/agent-coordination and tools/vscode-threads, or, for a packaged engine (its PACKAGED
+ * marker), its own folder and its view/ (copy-engine.mjs).
+ */
+export declare function engineLayout(root: string): {
+    scripts: string;
+    view: string;
+};
+/**
+ * The packaged engine that ships with the module at `here` (the view code's own URL, never this
+ * file's: the public CLI holds no engine), carrying the view's code, for a repository that is not
+ * a SoftwareDLC checkout (iss-473): the engine/ of the nearest folder above it with a package.json.
+ * Null when that package has no such engine.
+ */
+export declare function packagedEngine(here: string): string | null;
+//# sourceMappingURL=checkout.d.ts.map

package/dist/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../src/checkout.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AAEH,0GAA0G;AAC1G,eAAO,MAAM,0BAA0B,0KACkI,CAAC;AAE1K,8GAA8G;AAC9G,eAAO,MAAM,eAAe,uIAC0G,CAAC;AAEvI,sDAAsD;AACtD,eAAO,MAAM,oBAAoB,kGACgE,CAAC;AAElG,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWrF;AAuBD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACnD,QAAQ,qBAA6B,GACpC,MAAM,GAAG,IAAI,CAKf;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1D"}

package/dist/checkout.js

@@ -0,0 +1,92 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Where `sdlc view` and the viewer's Worktrees page find the repository and the view's code: a
+ * SoftwareDLC checkout's own, or the packaged engine's (iss-473). Public, beside the view seam:
+ * the CLI says outside a Git repository that it needs one before it says what to install, and the
+ * view code (cli-view) imports it from here.
+ */
+/** What `sdlc view` says in a workspace build with no packaged engine, outside a SoftwareDLC checkout. */
+export const NOT_A_SOFTWAREDLC_CHECKOUT = 'sdlc view shows the local SDLC threads of a SoftwareDLC checkout, and this directory is not in one (its main checkout has no packages/sdlc and tools/vscode-threads).';
+/** What `sdlc view` says when SDLC_VIEW_ROOT names no view code: never another engine's view in its place. */
+export const NOT_A_VIEW_ROOT = 'sdlc view runs the view code of the checkout SDLC_VIEW_ROOT names, and it names no SoftwareDLC checkout with tools/vscode-threads.';
+/** What `sdlc view` says outside a Git repository. */
+export const NOT_A_GIT_REPOSITORY = 'sdlc view shows the local SDLC threads of a Git repository, and this directory is not in one.';
+/** The repository the current directory belongs to: its main checkout and current worktree. */
+export function locateCheckout(cwd) {
+    try {
+        const git = (args) => execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        const common = git(['rev-parse', '--path-format=absolute', '--git-common-dir']);
+        const worktree = git(['rev-parse', '--show-toplevel']);
+        const main = path.basename(common) === '.git' ? path.dirname(common) : worktree;
+        return { main, worktree };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The SoftwareDLC repository's own package for this CLI, which marks a checkout as one: a
+ * @software-dlc/ package in packages/sdlc whose bin names sdlc, under whichever name it ships.
+ */
+function isSoftwareDlcCheckout(root) {
+    try {
+        const require = createRequire(import.meta.url);
+        const manifest = require(path.join(root, 'packages', 'sdlc', 'package.json'));
+        const bin = manifest.bin;
+        return (typeof manifest.name === 'string' &&
+            manifest.name.startsWith('@software-dlc/') &&
+            bin !== null &&
+            typeof bin === 'object' &&
+            'sdlc' in bin);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Where the view's code comes from: the main checkout of a SoftwareDLC repository, never the
+ * current worktree's branch, so viewing does not run code a branch under review changed.
+ * SDLC_VIEW_ROOT names another checkout explicitly, for working on the view itself.
+ */
+export function viewCodeRoot(checkout, override = process.env.SDLC_VIEW_ROOT) {
+    const root = override ? path.resolve(override) : checkout?.main;
+    if (!root || !isSoftwareDlcCheckout(root))
+        return null;
+    const dir = path.join(root, 'tools', 'vscode-threads');
+    return hasViewCode(dir) ? dir : null;
+}
+function hasViewCode(dir) {
+    return ['core.js', 'terminal.js'].every((f) => existsSync(path.join(dir, f)));
+}
+/**
+ * Where an engine root keeps its commands and the view's code: a SoftwareDLC checkout's
+ * scripts/agent-coordination and tools/vscode-threads, or, for a packaged engine (its PACKAGED
+ * marker), its own folder and its view/ (copy-engine.mjs).
+ */
+export function engineLayout(root) {
+    return existsSync(path.join(root, 'PACKAGED'))
+        ? { scripts: root, view: path.join(root, 'view') }
+        : { scripts: path.join(root, 'scripts', 'agent-coordination'), view: path.join(root, 'tools', 'vscode-threads') };
+}
+/**
+ * The packaged engine that ships with the module at `here` (the view code's own URL, never this
+ * file's: the public CLI holds no engine), carrying the view's code, for a repository that is not
+ * a SoftwareDLC checkout (iss-473): the engine/ of the nearest folder above it with a package.json.
+ * Null when that package has no such engine.
+ */
+export function packagedEngine(here) {
+    let dir = path.dirname(fileURLToPath(here));
+    while (!existsSync(path.join(dir, 'package.json'))) {
+        const up = path.dirname(dir);
+        if (up === dir)
+            return null;
+        dir = up;
+    }
+    const engine = path.join(dir, 'engine');
+    return existsSync(path.join(engine, 'PACKAGED')) && hasViewCode(engineLayout(engine).view) ? engine : null;
+}
+//# sourceMappingURL=checkout.js.map

package/dist/checkout.js.map

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

package/dist/cli-arguments.d.ts

@@ -0,0 +1,13 @@
+import type { GraphTarget } from '@software-dlc/graph/types';
+export declare function argumentValue(args: string[], name: string): string | null;
+export declare function hasArgument(args: string[], name: string): boolean;
+export declare function argumentValues(args: string[], name: string): string[];
+export declare function explicitGraphTarget(args: string[], prefix: 'target' | 'source'): GraphTarget | null;
+export declare function requiredArgument(args: string[], name: string): string;
+export declare function optionalIntegerArgument(input: {
+    args: string[];
+    name: string;
+    min: number;
+    max: number;
+}): number | undefined;
+//# sourceMappingURL=cli-arguments.d.ts.map

package/dist/cli-arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-arguments.d.ts","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrE;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAC1B,WAAW,GAAG,IAAI,CAiCpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,GAAG,SAAS,CAUrB"}

package/dist/cli-arguments.js

@@ -0,0 +1,67 @@
+export function argumentValue(args, name) {
+    const index = args.indexOf(name);
+    return index >= 0 ? (args[index + 1] ?? null) : null;
+}
+export function hasArgument(args, name) {
+    return args.includes(name);
+}
+export function argumentValues(args, name) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === name && args[index + 1]) {
+            values.push(args[index + 1]);
+            index += 1;
+        }
+        else if (argument.startsWith(`${name}=`)) {
+            values.push(argument.slice(name.length + 1));
+        }
+    }
+    return values;
+}
+export function explicitGraphTarget(args, prefix) {
+    const branch_id = argumentValue(args, `--${prefix}-branch-id`);
+    const pull_request_id = argumentValue(args, `--${prefix}-pull-request-id`);
+    const commit_id = argumentValue(args, `--${prefix}-commit-id`);
+    const worktree_id = argumentValue(args, `--${prefix}-worktree-id`);
+    const ids = [branch_id, pull_request_id, commit_id, worktree_id].filter(Boolean);
+    if (ids.length === 0)
+        return null;
+    if (ids.length !== 1) {
+        throw new Error(`Provide exactly one explicit ${prefix} graph target.`);
+    }
+    if (worktree_id) {
+        const revision = Number(requiredArgument(args, `--${prefix}-worktree-revision`));
+        if (!Number.isInteger(revision) || revision < 0) {
+            throw new Error(`--${prefix}-worktree-revision must be a nonnegative integer.`);
+        }
+        return {
+            worktree_id,
+            worktree_revision: revision,
+            worktree_root_hash: requiredArgument(args, `--${prefix}-worktree-root-hash`)
+        };
+    }
+    if (branch_id)
+        return { branch_id };
+    if (pull_request_id)
+        return { pull_request_id };
+    return { commit_id: commit_id };
+}
+export function requiredArgument(args, name) {
+    const value = argumentValue(args, name);
+    if (!value) {
+        throw new Error(`Missing required ${name} value.`);
+    }
+    return value;
+}
+export function optionalIntegerArgument(input) {
+    const raw = argumentValue(input.args, input.name);
+    if (raw === null)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < input.min || value > input.max) {
+        throw new Error(`${input.name} must be an integer from ${input.min} through ${input.max}.`);
+    }
+    return value;
+}
+//# sourceMappingURL=cli-arguments.js.map

package/dist/cli-arguments.js.map

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

package/dist/cli-branch-history.d.ts

@@ -0,0 +1,48 @@
+import { type GraphClientOptions } from '@software-dlc/graph/client';
+/** The command result and its exit code; refusals throw. */
+export type BranchHistoryCommandResult = {
+    output: unknown;
+    exit_code: 0 | 2;
+};
+/**
+ * The AI workspace this checkout is bound to, at the revision it last saved or
+ * synced; null when the checkout has no binding or no active session.
+ */
+export type LocalWorkspace = {
+    worktree_id: string;
+    revision: number | null;
+};
+/** `sdlc branch commit`: commits the bound (or named) branch's Working changes. */
+export declare function branchCommitCommand(input: {
+    args: string[];
+    client: GraphClientOptions;
+    bound_branch_id: string | null;
+    /** The checkout's project; a branch outside it is refused before writing. */
+    project_id: string;
+    local_workspace?: LocalWorkspace | null;
+    /** Delays before each repeat of a pending commit; tests shorten them. */
+    validation_wait_ms?: readonly number[];
+}): Promise<BranchHistoryCommandResult>;
+/**
+ * `sdlc branch apply`: applies the bound (or named) branch's AI workspace
+ * proposal to its Working graph. --expected-workspace-revision is the proposal
+ * revision the caller approved, by default the one this checkout last saved or
+ * synced; the workspace and the Working revision default to the branch's
+ * current ones.
+ */
+export declare function branchApplyCommand(input: {
+    args: string[];
+    client: GraphClientOptions;
+    bound_branch_id: string | null;
+    /** The checkout's project; a branch outside it is refused before writing. */
+    project_id: string;
+    local_workspace?: LocalWorkspace | null;
+}): Promise<BranchHistoryCommandResult>;
+/** `sdlc pr review|approve|merge`: pull-request steps as the key's user. */
+export declare function pullRequestCommand(input: {
+    args: string[];
+    client: GraphClientOptions;
+    /** The checkout's project; a pull request outside it is refused before writing. */
+    project_id: string;
+}): Promise<BranchHistoryCommandResult>;
+//# sourceMappingURL=cli-branch-history.d.ts.map

package/dist/cli-branch-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-branch-history.d.ts","sourceRoot":"","sources":["../src/cli-branch-history.ts"],"names":[],"mappings":"AAGA,OAAO,EAUL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAUpC,4DAA4D;AAC5D,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;CAClB,CAAC;AAsEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAkCF,mFAAmF;AACnF,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAiGtC;AAQD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACzC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAiFtC;AAED,4EAA4E;AAC5E,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA6GtC"}