@eyeauras/youtrack-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI CLI Factory contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,349 @@
+# YouTrack CLI
+
+The scoped package provides the `youtrack-cli` command:
+
+```sh
+npm install --global @eyeauras/youtrack-cli
+youtrack-cli --help
+youtrack-cli profile configure
+```
+
+Requires Node.js 22+ and npm. Compiled JavaScript and the Core dependency are installed
+automatically; no repository checkout, .NET, TypeScript compiler or browser is needed.
+Interactive profile configuration guides endpoint/authentication setup; secrets use the
+OS credential store. Existing `youtrack-cli` profiles and permissions are unchanged.
+Licensed under MIT. See the [release guide](https://github.com/iXab3r/EyeAuras.CliFactory/blob/main/docs/npm-release.md).
+
+YouTrack uses the same `@eyeauras/cli-factory` workspace as TeamCity. The CLI
+provides standard profiles/auth/permissions and 118 REST operations: 98 ReadOnly and 20 Update.
+A separate ReadOnly command downloads one selected issue attachment; it is not REST operation 119.
+There are 117 service leaves: 116 for REST operations plus download. Two `--direct` selectors
+each select a second REST endpoint without adding another leaf.
+The foundational read projections are:
+
+| Command | Default fields |
+|---|---|
+| `user me` | `id,login` |
+| `project list` | `id,name,shortName` |
+| `issues list [--query <query>]` | `id,idReadable,summary,project(id,name,shortName),updated,resolved` |
+| `issues get <issueID>` | Issue-list fields plus `description,created` |
+| `issues comments list <issueID>` | `id,text,author(id,login),created,updated` |
+
+REST reads support explicit `--fields <projection>`. Projection results retain the server's
+field names, `$type` and nullable values; authentication always validates fixed `id,login`.
+Offset collections use `--top 50 --skip 0` by default; top is 1–100 and skip a nonnegative integer.
+Paging accepts unsigned decimal digits, including leading zeros; signs (including `-0`), whitespace,
+fractions, exponents and unsafe integers reject. Invalid syntax, range and overflow now fail before
+onboarding or credential access on CLI, execute and RPC. The static errors are
+`YouTrack top must be a decimal integer between 1 and 100.` and
+`YouTrack skip must be a nonnegative safe decimal integer.`; they never include the supplied input.
+Directly callable service methods retain their own range validation.
+Each collection command makes one request, and rejects an oversized server page. No `--all`
+or implicit nested follow-up requests are provided. Issue IDs are encoded as opaque path
+segments, including readable IDs such as `DEMO-1`.
+
+```powershell
+npm run youtrack -- project list --top 3 --profile youtrack-dev
+npm run youtrack -- issues list --query "project: DEMO #Unresolved" --profile youtrack-dev
+npm run youtrack -- issues get DEMO-1 --fields "id,summary,description" --profile youtrack-dev
+npm run youtrack -- issues comments list DEMO-1 --top 3 --profile youtrack-dev
+```
+
+Handlers return domain values for human, `--json` and persistent `--json-rpc` output.
+Empty collections are `[]`. Signed/credential-bearing URLs and the active bearer token are
+scrubbed recursively, including explicitly projected nested fields. Unsigned URLs remain
+unchanged. Failures expose HTTP status and safe Retry-After information, never raw server
+errors or authentication material. Remote mutations require the Update gate, described below.
+The ReadOnly download command writes only its explicitly requested local file beneath profile AppData.
+
+JSON responses now have an 8 MiB limit on actual decoded bytes, including responses without a
+Content-Length header. This allows room for the existing bounded pages and text-rich projections;
+it does not guarantee every requested projection will fit. Narrow `--fields` or reduce `--top` if
+needed. Invalid/truncated identity transfer lengths, overflow, stream failure or cancellation fail
+with `YouTrack response stream failed, exceeded 8 MiB, or was cancelled.` without response content.
+Compressed wire length is syntax-checked but not compared with decoded size. Existing HTTP status,
+Retry-After, empty/null mutation and UTF-8 BOM behavior are unchanged. Attachment-download limits
+remain separate; no request is retried automatically.
+
+## Sign in locally
+
+Build from the repository root with `npm run build`, then use your current terminal and
+the normal CLI pipeline; no wrapper or auxiliary terminal window is required:
+
+```powershell
+npm run youtrack -- profile configure youtrack-dev
+```
+
+Only if this terminal can see the existing configured profile, resume token login without changing it:
+
+```powershell
+npm run youtrack -- auth login --profile youtrack-dev
+```
+
+If login reports a missing profile, run `profile configure` first in that same terminal; do not assume
+profile visibility is identical across terminal environments.
+
+Enter the YouTrack server URL when configuring a new profile, then enter your permanent token at the
+factory's hidden token prompt. Never put a token in chat or command-line arguments.
+Use the server origin and any context path (for example `https://youtrack.example.com/track`),
+without `/api`, credentials, query or fragment. HTTPS is required; HTTP is accepted only
+for explicit `localhost`, `127.0.0.1` or `[::1]` development addresses. Redirects are refused.
+
+Create a token in your YouTrack profile with the YouTrack service scope and only the
+account permissions you need. See JetBrains' [permanent token documentation](https://www.jetbrains.com/help/youtrack/devportal/authentication-with-permanent-token.html).
+The identity fields follow [My User Profile](https://www.jetbrains.com/help/youtrack/devportal/resource-api-users-me.html).
+
+The candidate is validated before storage in the operating-system credential store.
+Non-secret profiles live in current-user AppData for application `youtrack-cli`; the
+credential namespace is separate from TeamCity and every YouTrack profile is isolated.
+`ReadOnly` starts enabled and `Update` disabled. Every mutation requires an explicitly enabled Update category.
+
+For automation, supply token input from a trusted secret source on stdin:
+
+```powershell
+npm run youtrack -- auth login --profile youtrack-dev --token-stdin
+```
+
+The factory selects a new candidate from explicit `--token-stdin`, then `YOUTRACK_TOKEN`,
+then the hidden prompt in an ordinary interactive CLI with all three standard streams
+attached to TTYs. JSON, JSON-RPC, programmatic calls and redirected streams never prompt.
+`--token-stdin` is unavailable in JSON-RPC/programmatic execution because stdin belongs to
+the transport; provide the configured environment candidate instead.
+Stored credentials remain available for service calls but are never configure/login candidates.
+Use secret-manager stdin without putting the token in shell history; there is no token flag
+or plaintext fallback.
+
+Configure validates the proposed settings and candidate before changing an existing profile or
+credential. Missing or rejected input leaves the existing pair unchanged; a new profile is not
+created. After successful validation, configure removes the old credential, saves configuration,
+then stores the new credential. A storage failure may leave an unauthenticated profile; no old
+credential is restored against changed settings. Repeat `profile configure <name> --token-stdin`
+after repairing local storage. Errors never include backend credential diagnostics.
+`auth login` replaces credentials without changing endpoint settings. These rules govern the
+authentication lifecycle; ordinary non-authentication `profile set` remains a separate operation.
+
+## Controlled mutations
+
+`Update` is disabled by default and isolated per profile. Enable it only when you deliberately
+intend to write, using the standard `permissions grant Update --profile <name>` command.
+This documentation does not enable it automatically. The local proof remains ReadOnly.
+
+| Command | Required `--body` JSON object |
+|---|---|
+| `issues create` | Nonempty `project.id` and `summary`; optional string or null `description` |
+| `issues update <issueID>` | Nonempty subset of `summary` and `description`; summary must be nonempty |
+| `issues comments add <issueID>` | Nonempty `text` only |
+
+Missing `--body` and malformed JSON fail before profile onboarding or credential access.
+Description and comment text preserve multiline Markdown. Omitted fields remain unchanged;
+`description: null` clears the description. Unknown fields (including nested project properties)
+are rejected locally. The `issues create` and `issues update` bodies do not accept custom fields,
+state/assignee, visibility or notification controls. Use the separate `issues fields set` command
+for supported custom-field changes described below. A project may require custom fields without
+defaults; creation then fails safely with the server's status rather than guessing missing values.
+
+For Windows **CMD**, replace the example project ID before deliberately running a write:
+
+```cmd
+npm run youtrack -- issues create --body "{\"project\":{\"id\":\"PROJECT_ID\"},\"summary\":\"Example issue\"}" --profile youtrack-dev
+```
+
+The equivalent **PowerShell 7** command uses ordinary single quotes around JSON:
+
+```powershell
+npm run youtrack -- issues create --body '{"project":{"id":"PROJECT_ID"},"summary":"Example issue"}' --profile youtrack-dev
+```
+
+Windows **PowerShell 5.1** requires escaping the inner quotes through the npm/CMD pipeline:
+
+```powershell
+npm run youtrack -- issues create --body '{\"project\":{\"id\":\"PROJECT_ID\"},\"summary\":\"Example issue\"}' --profile youtrack-dev
+```
+
+Updates return `id,idReadable,summary,updated`; comment creation returns the same finite fields
+as comment reads. An empty successful mutation response becomes JSON `null`. No mutation retries,
+implicit follow-up reads or automatic permission grants occur. Malformed bodies and remote errors
+use safe diagnostics without echoing submitted JSON or server response text.
+
+## Additional commands through operation 50
+
+The same tree is available through normal npm commands, JSON and JSON-RPC. Use leaf `--help`
+for exact arguments and permission categories; no endpoint, header or arbitrary HTTP escape hatch exists.
+
+| Family | Additional commands | Operations |
+|---|---|---:|
+| Queries and commands | `commands assist/apply`, `search assist`, `issues count`, `saved-queries list/get` | 6 |
+| Project, users and fields | `project get`, `project field list/get`, `user list`, `issues fields list/get/set` | 7 |
+| Links and tags | `link-types list/get`, `tags list/get`, `issues links list/get/issues/add/remove`, `issues tags list/add/remove` | 12 |
+| Activity and context | `activities page`, `issues activity page`, `issues comments get/update`, `issues vcs-changes list/get`, `issues sprints list` | 7 |
+| Work time | `issues time-tracking get`, `issues work-items list/get/add/update`, `work-items list/get` | 7 |
+| Attachments | `issues attachments list/get/upload` | 3 |
+
+`commands assist`, `search assist` and `issues count` use POST on the wire but remain ReadOnly:
+they compute suggestions or counts without applying changes. Assist is not a dry run or a guarantee
+that a later command will succeed. Required `--query` is preserved exactly; optional `--caret` is
+between zero and its length. `commands apply` requires 1–20 comma-separated explicit issue IDs via
+`--issues`, never an implicit search expansion. It has no run-as or silent mode. Count returns the
+server's `count`, including `-1` (pending) or `null`; the CLI never polls automatically.
+
+Activity commands require `--categories <categories>` and support `--cursor`, `--reverse` and
+`--fields`. They return one server-defined page with `activities`, before/after cursors and flags.
+They do not support offset or page-size flags and do not fetch a next page automatically.
+Activity time, author and issue-query filters are outside this block.
+
+Project fields expose field types and settings without following bundle references. Issue fields
+preserve polymorphic values, including scalar, null and array values. `issues fields set` accepts
+an explicit `$type` and `value`: single/multi Enum, Build, Version, Owned, Group and User types;
+State, Simple, Date, Period and Text types. References use explicit identity selectors (`id`,
+`name`, and `login` for users); the CLI performs no name lookup. Single values can use `null`,
+multi values use `[]` to clear. Period values accept nonnegative 32-bit integer `minutes`
+and/or `presentation`; dates use
+integer Unix milliseconds. Text values use `{ "text": "..." }`. StateMachine fields instead
+require `$type` and `{ "event": { "id": "..." } }`; inspect `possibleEvents` explicitly with
+`--fields` before selecting a transition. Unknown types and body fields fail locally.
+
+Relationship additions accept only `{ "id": "TARGET_ID" }`. Link IDs include the explicit
+direction returned by YouTrack. `issues links remove <issueID> <linkID> <targetIssueID>` unlinks
+the target; `issues tags remove <issueID> <tagID>` unassigns the tag. Neither deletes the issue or
+tag itself. Comment updates accept only nonempty `text`, preserving multiline Markdown.
+
+Work-item creation requires `duration.minutes` (nonnegative 32-bit integer) and/or nonempty
+`duration.presentation`. Both may be supplied; YouTrack interprets presentation text. Writable
+fields are `duration`, `date`, `author`, `type`, `text`, `created` and `updated`. Dates/timestamps
+use integer Unix milliseconds; `author` and `type` use `{ "id": "..." }` or `null`. Text may be
+empty, multiline or null; `updated` may also be null. Updates require at least one field and
+preserve omitted fields. No client-side date, user or duration conversion is guessed. Work-item
+writes accept `--fields`; only global `work-items list` supports `--query`. Other date/author
+filters are outside this block. Time-tracking inspection defaults to `id,enabled`, without
+expanding work items.
+
+Attachment reads default to `id,name,size,mimeType`; explicit read projections still scrub signed
+URLs. Upload requires one explicit `--file <path>` and sends one native multipart request, returning
+metadata only. Missing/blank/invalid path syntax fails before onboarding. Regular-file and read
+checks occur inside the Update handler before HTTP, so denied uploads do not inspect files.
+Only the basename becomes the multipart filename; errors never echo local paths. No attachment
+binary download or signed-URL follow-up was included in the first 50 operations; the separate
+download capability is documented below.
+
+## Additional commands through operation 100
+
+These add fifty REST operations. Two `--direct` switches each select between two documented
+read endpoints, so at this stage the tree had 98 service leaves for 100 operations.
+
+| Family | Additional commands | Operations |
+|---|---|---:|
+| Global fields and choices | `field list/get`, `field type list`, `bundle enum/state list/get`, `bundle enum/state value list/get` | 11 |
+| User directory and bundles | `user get`, `bundle user list/get`, `bundle user member list`, `bundle user group list/get`, `bundle user individual list/get` | 8 |
+| Groups and project teams | `group list/get`, `group member list [--direct]`, `group subgroup list`, `project team get`, `project team group list`, `project team user list [--direct]` | 9 |
+| Time metadata | `time-tracking settings get`, `time-tracking work-time get`, `work-item-type list/get`, `project time-tracking get`, `project work-item-type list/get` | 7 |
+| Boards and sprints | `agile list/get`, `sprint list/get/create/update` | 6 |
+| Articles | `article list/get/create/update`, `article comment list/get/add/update`, `project article list` | 9 |
+
+Every new read supports `--fields`. Offset lists retain one-page `--top`/`--skip` behavior;
+details and settings reads have no paging flags. Bundle defaults omit nested values and members:
+use the matching paginated child command. Archived enum/state values are preserved; state
+`isResolved` is a resolution classification, not a list of workflow transition events.
+Global field, bundle and value detail IDs are opaque database IDs; no name lookup is performed.
+
+User-bundle `member list` includes membership supplied by groups and directly added users.
+`individual list/get` covers only users added directly, and `group list/get` covers attached
+groups. `group member list` and `project team user list` return all visible members by default;
+`--direct` selects the server's direct-membership endpoint. The CLI does not crawl groups or
+infer membership locally. Project-team endpoints require YouTrack 2026.1 or later; unavailable
+or denied routes remain errors, with no alternate Hub route or permission changes.
+
+Time metadata exposes the server's work schedule and available work-item types without changing
+settings or synthesizing locale/calendar defaults. Global/project type lists are paginated;
+other metadata reads return one object. No new date, author, search or archive filters are added
+by these directory commands.
+
+Sprint reads use an explicit board ID; the literal sprint ID `current` goes directly to the
+same documented detail/update route. Create requires a nonempty single-line `name`; update
+requires at least one supported field. Writable fields are `name`, `goal`, `start`, `finish`,
+`archived` and `isDefault`. Goal preserves empty/multiline text or null; dates are safe integer
+Unix milliseconds or null; flags are booleans. Create additionally accepts
+`previousSprint: { "id": "..." }`, which explicitly moves unresolved issues from that sprint.
+It is never inferred and is rejected on update. `isDefault: true` affects where matching new
+board issues go. Sprint issue-membership payloads, agile mutations and deletion remain outside
+this block. Reads and writes support `--fields`; there is no carryover lookup or polling.
+
+Article create accepts nonempty `project.id` and `summary`, with optional string/null `content`.
+Article update accepts a nonempty subset of `summary` and `content`; comments accept only
+nonempty `text`, preserving multiline Markdown. Omission keeps fields unchanged; content null
+clears it. These narrow bodies exclude parent/hierarchy, visibility, reporter, stars, tags,
+nested attachments/comments and comment pinning/reactions. The REST entities have additional
+writable properties, but this CLI does not forward them. Article and comment reads/writes
+support `--fields`; article lists have no query flag. Article attachment transfer and hierarchy
+reads are documented below. Hierarchy writes, draft publishing, notification suppression and
+deletion remain unsupported.
+
+## Remaining bundles, article hierarchy and attachment transfer
+
+`bundle build/owned/version list/get` and their `value list/get` children expose twelve
+ReadOnly operations. Lists use the normal bounded page; bundle defaults do not expand values.
+Archived values and nullable owners are preserved without local lookup or filtering. Version
+value `startDate` requires YouTrack 2023.1 or later; the CLI does not substitute another field.
+
+`article attachment list/get/upload` and `article child list/get` plus `article parent get`
+add six operations. The hierarchy commands read only the selected relationship and never
+recursively traverse descendants. A literal JSON null parent remains null; an empty body,
+404 or malformed response is still an error. Article attachment upload requires one explicit
+`--file`, the Update gate, and uses native multipart after checking that the file is regular.
+It supports `--fields` for the response. No implicit file discovery or article binary download
+is provided, and upload never grants permissions.
+
+```powershell
+npm run youtrack -- issues attachments download DEMO-1 1-1 --profile youtrack-dev
+npm run youtrack -- issues attachments download DEMO-1 1-1 --name report.txt --max-bytes 1048576 --profile youtrack-dev
+```
+
+Issue attachment download first reads the exact attachment's fixed metadata, then requests only
+its returned URL. The file request sends neither Authorization nor cookies, follows no redirects,
+and accepts only the configured origin and documented attachment path beneath its context.
+External/CDN URLs fail rather than relaxing this policy. Signatures stay in memory and never
+appear in metadata output, errors or the download result.
+
+Files go beneath the selected profile's `AppDataDirectory/downloads`. `--name` must be a safe
+single basename; the default prefixes the sanitized attachment name with its ID. Existing
+filenames are never overwritten. The default limit is 25 MiB; `--max-bytes` accepts 1–104857600
+and is enforced while streaming as well as against Content-Length. Core stages bytes in a fresh
+private directory under this profile's `temp`, then hard-links only the complete identity-checked
+file into `downloads`. Partial files are removed when their identities remain trusted. Output
+contains only sanitized ID/name, local path, byte count and content type.
+No binary data is printed. Publication uses an exclusive hard link; unsupported filesystems
+fail without a copy/rename fallback. Existing links or junctions in the directory chain and detectable directory/staged/destination
+replacement are rejected. Unknown replacement files are never removed. This protects
+current-user-owned AppData; it cannot prevent every malicious same-account replacement after the
+last identity check. Errors report whether publication occurred and whether private staging cleanup
+failed, without raw filesystem/service details. The local proof never invokes download or upload.
+
+## Local proof and offline tests
+
+After configuring a profile, explicitly run:
+
+```powershell
+npm run test:integration --workspace @eyeauras/youtrack-cli -- --profile youtrack-dev
+```
+
+The explicit local proof uses twenty-four fixed ReadOnly rows through the compiled CLI, named profile
+and OS keyring: current user; projects and issues (up to three each); one selected issue and its
+comments; one selected project and its custom fields; users; and the selected issue's custom
+fields, attachments, tags, links and work items. It also reads global fields, user bundles,
+groups, the selected project's team/time settings, global work-item types, agiles and articles.
+It also lists build, owned-field and version bundles. No bundle values or article descendants
+are followed, and no binary download is invoked.
+Every collection is capped at three. Projects
+exercise their default projection; all added reads request only `id`. IDs remain in memory.
+Output contains only static PASS/FAIL/SKIP, endpoint templates and counts. Denied or malformed
+attempted reads fail. Reads without a usable project/issue prerequisite are skipped; skipped rows
+are not availability evidence, and failed prerequisites still fail the overall proof. No real
+writes, automatic pagination or further resource discovery occur. CI and arbitrary URL/token/
+command arguments are refused; inherited `YOUTRACK_TOKEN` is removed case-insensitively.
+The shared Core proof invoker keeps the 30-second timeout and separate 64-KiB stdout/stderr bounds;
+see the [shared CI and process contract](../../docs/testing.md).
+Do not run it in CI or add it to generic test commands. A failed proof requires local
+configuration/TLS/permission investigation; its payloads are deliberately not logged.
+
+`npm test` builds and runs deterministic offline tests, including MSW against the actual
+client and declaration, synthetic profile/credential isolation, JSON-RPC and proof safety.
+Tests inject `AppArguments` rather than redirecting the user's data directories.

package/dist/src/agile-commands.d.ts

@@ -0,0 +1,2 @@
+export declare const agileRootCommands: import("@eyeauras/cli-factory").CommandDefinition[];
+//# sourceMappingURL=agile-commands.d.ts.map

package/dist/src/agile-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agile-commands.d.ts","sourceRoot":"","sources":["../../src/agile-commands.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,qDA6B7B,CAAC"}

package/dist/src/agile-commands.js

@@ -0,0 +1,18 @@
+import { command } from "@eyeauras/cli-factory";
+import { pagedRead, projectedBodyUpdate, projectedRead } from "./cli-support.js";
+import { createSprint, getAgile, getSprint, listAgiles, listSprints, updateSprint } from "./agile.js";
+export const agileRootCommands = [
+    command("agile", "Inspect agile boards", [
+        pagedRead("list", "List one page of accessible agile boards", listAgiles),
+        projectedRead("get <agile>", "Read an agile board without expanding its sprints or projects", getAgile),
+    ]),
+    command("sprint", "Inspect and explicitly manage sprint plans", [
+        pagedRead("list <agile>", "List one page of a board's sprints", listSprints),
+        projectedRead("get <agile> <sprint>", "Read a sprint; use current for the board's current sprint", getSprint),
+        projectedBodyUpdate("create <agile>", "Create with name; optional previousSprint.id moves unresolved issues from that sprint. " +
+            "isDefault: true automatically adds matching new issues. Neither setting is inferred.", createSprint),
+        projectedBodyUpdate("update <agile> <sprint>", "Update supplied name/goal/start/finish/archived/isDefault; use current for the current sprint. " +
+            "isDefault: true automatically adds matching new issues; previousSprint is creation-only.", updateSprint),
+    ]),
+];
+//# sourceMappingURL=agile-commands.js.map

package/dist/src/agile-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agile-commands.js","sourceRoot":"","sources":["../../src/agile-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,OAAO,EAAE,sBAAsB,EAAE;QACvC,SAAS,CAAC,MAAM,EAAE,0CAA0C,EAAE,UAAU,CAAC;QACzE,aAAa,CACX,aAAa,EACb,+DAA+D,EAC/D,QAAQ,CACT;KACF,CAAC;IACF,OAAO,CAAC,QAAQ,EAAE,4CAA4C,EAAE;QAC9D,SAAS,CAAC,cAAc,EAAE,oCAAoC,EAAE,WAAW,CAAC;QAC5E,aAAa,CACX,sBAAsB,EACtB,2DAA2D,EAC3D,SAAS,CACV;QACD,mBAAmB,CACjB,gBAAgB,EAChB,yFAAyF;YACvF,sFAAsF,EACxF,YAAY,CACb;QACD,mBAAmB,CACjB,yBAAyB,EACzB,iGAAiG;YAC/F,0FAA0F,EAC5F,YAAY,CACb;KACF,CAAC;CACH,CAAC"}

package/dist/src/agile.d.ts

@@ -0,0 +1,8 @@
+import { type Connection, type ProjectionOptions, type YouTrackObject } from "./client.js";
+export declare const listAgiles: (connection: Connection, options?: import("./client.js").PageOptions | undefined) => Promise<YouTrackObject[]>;
+export declare const getAgile: (connection: Connection, agile: string, options?: ProjectionOptions | undefined) => Promise<YouTrackObject>;
+export declare const listSprints: (connection: Connection, agile: string, options?: import("./client.js").PageOptions | undefined) => Promise<YouTrackObject[]>;
+export declare const getSprint: (connection: Connection, agile: string, sprint: string, options?: ProjectionOptions | undefined) => Promise<YouTrackObject>;
+export declare function createSprint(connection: Connection, agile: string, input: unknown, options?: ProjectionOptions): Promise<YouTrackObject | null>;
+export declare function updateSprint(connection: Connection, agile: string, sprint: string, input: unknown, options?: ProjectionOptions): Promise<YouTrackObject | null>;
+//# sourceMappingURL=agile.d.ts.map

package/dist/src/agile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agile.d.ts","sourceRoot":"","sources":["../../src/agile.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AASrB,eAAO,MAAM,UAAU,gHAA8C,CAAC;AACtE,eAAO,MAAM,QAAQ,6GAAuC,CAAC;AAC7D,eAAO,MAAM,WAAW,+HAGvB,CAAC;AACF,eAAO,MAAM,SAAS,6HAIrB,CAAC;AAkDF,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,kCAQhC;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,kCAQhC"}

package/dist/src/agile.js

@@ -0,0 +1,64 @@
+import { encodedID, fields, mutate, mutationBody, nullableText, readCollectionAt, readObjectAt, requiredText, } from "./client.js";
+const agileFields = "id,name,currentSprint(id,name,start,finish,archived),status(valid,hasJobs)";
+const sprintFields = "id,name,goal,start,finish,archived,isDefault,agile(id,name)";
+function agilePath(agile) {
+    return `api/agiles/${encodedID(agile, "agile ID")}`;
+}
+export const listAgiles = readCollectionAt("api/agiles", agileFields);
+export const getAgile = readObjectAt(agilePath, agileFields);
+export const listSprints = readCollectionAt((agile) => `${agilePath(agile)}/sprints`, sprintFields);
+export const getSprint = readObjectAt((agile, sprint) => `${agilePath(agile)}/sprints/${encodedID(sprint, "sprint ID")}`, sprintFields);
+function sprintBody(input, creating) {
+    const body = mutationBody(input, [
+        "name", "goal", "start", "finish", "archived", "isDefault",
+        ...(creating ? ["previousSprint"] : []),
+    ]);
+    if (creating && !Object.hasOwn(body, "name")) {
+        throw new Error("YouTrack sprint creation requires name.");
+    }
+    if (Object.keys(body).length === 0) {
+        throw new Error("YouTrack sprint update requires at least one writable field.");
+    }
+    const result = {};
+    if (Object.hasOwn(body, "name")) {
+        if (typeof body.name !== "string") {
+            throw new Error("YouTrack sprint name must be nonempty single-line text.");
+        }
+        result.name = requiredText(body.name, "sprint name");
+    }
+    if (Object.hasOwn(body, "goal")) {
+        result.goal = nullableText(body.goal, "sprint goal");
+    }
+    for (const key of ["start", "finish"]) {
+        if (Object.hasOwn(body, key)) {
+            const value = body[key];
+            if (value !== null && (typeof value !== "number" || !Number.isSafeInteger(value))) {
+                throw new Error(`YouTrack sprint ${key} must be a safe integer UTC timestamp in milliseconds or null.`);
+            }
+            result[key] = value;
+        }
+    }
+    for (const key of ["archived", "isDefault"]) {
+        if (Object.hasOwn(body, key)) {
+            if (typeof body[key] !== "boolean") {
+                throw new Error(`YouTrack sprint ${key} must be boolean.`);
+            }
+            result[key] = body[key];
+        }
+    }
+    if (Object.hasOwn(body, "previousSprint")) {
+        const previous = mutationBody(body.previousSprint, ["id"]);
+        if (typeof previous.id !== "string") {
+            throw new Error("YouTrack previousSprint.id must be nonempty text.");
+        }
+        result.previousSprint = { id: requiredText(previous.id, "previousSprint.id") };
+    }
+    return result;
+}
+export async function createSprint(connection, agile, input, options = {}) {
+    return mutate(connection, `${agilePath(agile)}/sprints`, sprintBody(input, true), fields(options, sprintFields));
+}
+export async function updateSprint(connection, agile, sprint, input, options = {}) {
+    return mutate(connection, `${agilePath(agile)}/sprints/${encodedID(sprint, "sprint ID")}`, sprintBody(input, false), fields(options, sprintFields));
+}
+//# sourceMappingURL=agile.js.map

package/dist/src/agile.js.map

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

package/dist/src/article-extras-commands.d.ts

@@ -0,0 +1,2 @@
+export declare const articlesExtraChildren: import("@eyeauras/cli-factory").CommandDefinition[];
+//# sourceMappingURL=article-extras-commands.d.ts.map

package/dist/src/article-extras-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-extras-commands.d.ts","sourceRoot":"","sources":["../../src/article-extras-commands.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,qBAAqB,qDAgDjC,CAAC"}

package/dist/src/article-extras-commands.js

@@ -0,0 +1,27 @@
+import { command } from "@eyeauras/cli-factory";
+import { requiredText } from "./client.js";
+import { pagedRead, projectedRead, updateCommand, projectionOptions, readOptions } from "./cli-support.js";
+import { getArticleAttachment, getChildArticle, getParentArticle, listArticleAttachments, listChildArticles, uploadArticleAttachment, } from "./article-extras.js";
+export const articlesExtraChildren = [
+    command("attachment", "Inspect article attachment metadata and upload one file", [
+        pagedRead("list <article>", "List one page of attachment metadata without downloading files", listArticleAttachments),
+        projectedRead("get <article> <attachment>", "Read attachment metadata without downloading its contents", getArticleAttachment),
+        updateCommand("upload <article>", "Upload one selected regular file to an existing article", async (connection, { args, options }, context) => uploadArticleAttachment(connection, args.article, String(options.file), readOptions(options)), [
+            ...projectionOptions,
+            {
+                flags: "--file <path>",
+                description: "Required explicit local input file; no copies or recursion",
+                required: true,
+                parse: (value) => requiredText(value, "file path"),
+            },
+        ]),
+    ]),
+    command("child", "Inspect immediate child articles without recursive traversal", [
+        pagedRead("list <article>", "List one page of immediate child articles", listChildArticles),
+        projectedRead("get <article> <child>", "Read the specified child of the parent article", getChildArticle),
+    ]),
+    command("parent", "Inspect an article's parent", [
+        projectedRead("get <article>", "Read the parent; preserve a successful JSON null for no parent", getParentArticle),
+    ]),
+];
+//# sourceMappingURL=article-extras-commands.js.map

package/dist/src/article-extras-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-extras-commands.js","sourceRoot":"","sources":["../../src/article-extras-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,CAAC,YAAY,EAAE,yDAAyD,EAAE;QAC/E,SAAS,CACP,gBAAgB,EAChB,gEAAgE,EAChE,sBAAsB,CACvB;QACD,aAAa,CACX,4BAA4B,EAC5B,2DAA2D,EAC3D,oBAAoB,CACrB;QACD,aAAa,CACX,kBAAkB,EAClB,yDAAyD,EACzD,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,CAC/C,uBAAuB,CACrB,UAAU,EACV,IAAI,CAAC,OAAO,EACZ,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EACpB,WAAW,CAAC,OAAO,CAAC,CACrB,EACH;YACI,GAAG,iBAAiB;YACpB;gBACE,KAAK,EAAE,eAAe;gBACtB,WAAW,EAAE,4DAA4D;gBACzE,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,CAAC;aACnD;SACF,CACJ;KACF,CAAC;IACF,OAAO,CAAC,OAAO,EAAE,8DAA8D,EAAE;QAC/E,SAAS,CAAC,gBAAgB,EAAE,2CAA2C,EAAE,iBAAiB,CAAC;QAC3F,aAAa,CACX,uBAAuB,EACvB,gDAAgD,EAChD,eAAe,CAChB;KACF,CAAC;IACF,OAAO,CAAC,QAAQ,EAAE,6BAA6B,EAAE;QAC/C,aAAa,CACX,eAAe,EACf,gEAAgE,EAChE,gBAAgB,CACjB;KACF,CAAC;CACH,CAAC"}

package/dist/src/article-extras.d.ts

@@ -0,0 +1,8 @@
+import { type Connection, type PageOptions, type ProjectionOptions, type YouTrackObject } from "./client.js";
+export declare const listArticleAttachments: (connection: Connection, articleID: string, options?: PageOptions | undefined) => Promise<YouTrackObject[]>;
+export declare const getArticleAttachment: (connection: Connection, articleID: string, attachmentID: string, options?: ProjectionOptions | undefined) => Promise<YouTrackObject>;
+export declare function uploadArticleAttachment(connection: Connection, articleID: string, filePath: string, options?: ProjectionOptions): Promise<YouTrackObject[] | null>;
+export declare const listChildArticles: (connection: Connection, articleID: string, options?: PageOptions | undefined) => Promise<YouTrackObject[]>;
+export declare const getChildArticle: (connection: Connection, articleID: string, childID: string, options?: ProjectionOptions | undefined) => Promise<YouTrackObject>;
+export declare function getParentArticle(connection: Connection, articleID: string, options?: ProjectionOptions): Promise<YouTrackObject | null>;
+//# sourceMappingURL=article-extras.d.ts.map

package/dist/src/article-extras.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-extras.d.ts","sourceRoot":"","sources":["../../src/article-extras.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAUrB,eAAO,MAAM,sBAAsB,6GAGlC,CAAC;AACF,eAAO,MAAM,oBAAoB,uIAIhC,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAKlC;AAED,eAAO,MAAM,iBAAiB,6GAG7B,CAAC;AACF,eAAO,MAAM,eAAe,kIAI3B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC"}

package/dist/src/article-extras.js

@@ -0,0 +1,22 @@
+import { attachmentForm } from "./attachment-form.js";
+import { encodedID, fields, readCollectionAt, readNullableObject, readObjectAt, uploadObjectCollection, } from "./client.js";
+const attachmentFields = "id,name,size,mimeType";
+const articleListFields = "id,idReadable,summary,project(id,shortName),updated";
+const articleDetailFields = `${articleListFields},content,parentArticle(id,idReadable),created`;
+function articlePath(articleID) {
+    return `api/articles/${encodedID(articleID, "article ID")}`;
+}
+export const listArticleAttachments = readCollectionAt((articleID) => `${articlePath(articleID)}/attachments`, attachmentFields);
+export const getArticleAttachment = readObjectAt((articleID, attachmentID) => `${articlePath(articleID)}/attachments/${encodedID(attachmentID, "attachment ID")}`, attachmentFields);
+export async function uploadArticleAttachment(connection, articleID, filePath, options = {}) {
+    const path = `${articlePath(articleID)}/attachments`;
+    const projection = fields(options, attachmentFields);
+    const form = await attachmentForm(filePath);
+    return uploadObjectCollection(connection, path, form, projection);
+}
+export const listChildArticles = readCollectionAt((articleID) => `${articlePath(articleID)}/childArticles`, articleListFields);
+export const getChildArticle = readObjectAt((articleID, childID) => `${articlePath(articleID)}/childArticles/${encodedID(childID, "child article ID")}`, articleDetailFields);
+export async function getParentArticle(connection, articleID, options = {}) {
+    return readNullableObject(connection, `${articlePath(articleID)}/parentArticle`, { fields: fields(options, articleDetailFields) });
+}
+//# sourceMappingURL=article-extras.js.map

package/dist/src/article-extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-extras.js","sourceRoot":"","sources":["../../src/article-extras.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,GAKvB,MAAM,aAAa,CAAC;AAErB,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,iBAAiB,GAAG,qDAAqD,CAAC;AAChF,MAAM,mBAAmB,GAAG,GAAG,iBAAiB,+CAA+C,CAAC;AAEhG,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,gBAAgB,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CACpD,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,cAAc,EAC9D,gBAAgB,CACjB,CAAC;AACF,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAC9C,CAAC,SAAiB,EAAE,YAAoB,EAAE,EAAE,CAC1C,GAAG,WAAW,CAAC,SAAS,CAAC,gBAAgB,SAAS,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,EACrF,gBAAgB,CACjB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAsB,EACtB,SAAiB,EACjB,QAAgB,EAChB,OAAO,GAAsB,EAAE;IAE/B,MAAM,IAAI,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,sBAAsB,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAC/C,CAAC,SAAiB,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,gBAAgB,EAChE,iBAAiB,CAClB,CAAC;AACF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CACzC,CAAC,SAAiB,EAAE,OAAe,EAAE,EAAE,CACrC,GAAG,WAAW,CAAC,SAAS,CAAC,kBAAkB,SAAS,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,EACrF,mBAAmB,CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAsB,EACtB,SAAiB,EACjB,OAAO,GAAsB,EAAE;IAE/B,OAAO,kBAAkB,CACvB,UAAU,EACV,GAAG,WAAW,CAAC,SAAS,CAAC,gBAAgB,EACzC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,CACjD,CAAC;AACJ,CAAC"}

package/dist/src/articles-commands.d.ts

@@ -0,0 +1,3 @@
+export declare const articlesRootCommands: import("@eyeauras/cli-factory").CommandDefinition[];
+export declare const articlesProjectChildren: import("@eyeauras/cli-factory").CommandDefinition[];
+//# sourceMappingURL=articles-commands.d.ts.map

package/dist/src/articles-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"articles-commands.d.ts","sourceRoot":"","sources":["../../src/articles-commands.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,oBAAoB,qDA8BhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,qDAInC,CAAC"}

package/dist/src/articles-commands.js

@@ -0,0 +1,25 @@
+import { command } from "@eyeauras/cli-factory";
+import { articlesExtraChildren } from "./article-extras-commands.js";
+import { pagedRead, projectedBodyUpdate, projectedRead } from "./cli-support.js";
+import { addArticleComment, createArticle, getArticle, getArticleComment, listArticleComments, listArticles, listProjectArticles, updateArticle, updateArticleComment, } from "./articles.js";
+export const articlesRootCommands = [
+    command("article", "Read and write knowledge-base articles", [
+        ...articlesExtraChildren,
+        pagedRead("list", "List one page of accessible articles", listArticles),
+        projectedRead("get <article>", "Read article content and parent identity", getArticle),
+        projectedBodyUpdate("create", "Create an article with project.id, summary and optional content", createArticle),
+        projectedBodyUpdate("update <article>", "Update summary/content; null content clears it and omitted fields stay unchanged", updateArticle),
+        command("comment", "Read and write article comments", [
+            pagedRead("list <article>", "List one page of comments", listArticleComments),
+            projectedRead("get <article> <comment>", "Read an article comment", getArticleComment),
+            projectedBodyUpdate("add <article>", "Add an article comment with nonempty text", addArticleComment),
+            projectedBodyUpdate("update <article> <comment>", "Replace an article comment's text", updateArticleComment),
+        ]),
+    ]),
+];
+export const articlesProjectChildren = [
+    command("article", "Inspect project knowledge-base articles", [
+        pagedRead("list <project>", "List one page of articles in a project", listProjectArticles),
+    ]),
+];
+//# sourceMappingURL=articles-commands.js.map

package/dist/src/articles-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"articles-commands.js","sourceRoot":"","sources":["../../src/articles-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,CAAC,SAAS,EAAE,wCAAwC,EAAE;QAC3D,GAAG,qBAAqB;QACxB,SAAS,CAAC,MAAM,EAAE,sCAAsC,EAAE,YAAY,CAAC;QACvE,aAAa,CAAC,eAAe,EAAE,0CAA0C,EAAE,UAAU,CAAC;QACtF,mBAAmB,CACjB,QAAQ,EACR,iEAAiE,EACjE,aAAa,CACd;QACD,mBAAmB,CACjB,kBAAkB,EAClB,kFAAkF,EAClF,aAAa,CACd;QACD,OAAO,CAAC,SAAS,EAAE,iCAAiC,EAAE;YACpD,SAAS,CAAC,gBAAgB,EAAE,2BAA2B,EAAE,mBAAmB,CAAC;YAC7E,aAAa,CAAC,yBAAyB,EAAE,yBAAyB,EAAE,iBAAiB,CAAC;YACtF,mBAAmB,CACjB,eAAe,EACf,2CAA2C,EAC3C,iBAAiB,CAClB;YACD,mBAAmB,CACjB,4BAA4B,EAC5B,mCAAmC,EACnC,oBAAoB,CACrB;SACF,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,OAAO,CAAC,SAAS,EAAE,yCAAyC,EAAE;QAC5D,SAAS,CAAC,gBAAgB,EAAE,wCAAwC,EAAE,mBAAmB,CAAC;KAC3F,CAAC;CACH,CAAC"}