@eyeauras/youtrack-cli 0.8.0 → 0.9.0

package/README.md

@@ -22,12 +22,12 @@ for each profile and reimport auxiliary secrets. Existing profiles and permissio
 
 Licensed under MIT. See the [release guide](docs/release.md).
 
-YouTrack consumes the exact published `@eyeauras/cli-factory` version declared in package.json. The CLI
-provides standard profiles/auth/permissions and 128 REST operations: 103 ReadOnly and 25 Update.
-Five workflow leaves reuse those operations instead of adding REST operations: issue and article
-attachment download, article export, and `issues batch validate/apply`. There are 131 service
-leaves: 126 for REST operations plus these five. Two `--direct` selectors each select a second
-REST endpoint without adding another leaf.
+YouTrack consumes the exact published `@eyeauras/cli-factory` version declared in package.json. The source revision described here
+provides profiles/auth/permissions and 282 REST operations: 140 ReadOnly and 142 Update.
+Nine workflow leaves reuse operations or manage local secrets: issue and article attachment
+downloads, article export, `issues batch validate/apply`, and initial-password/license import/delete.
+There are 289 service leaves: 280 for REST operations plus these nine. Two `--direct` selectors
+each select a second REST endpoint without adding another leaf.
 The foundational read projections are:
 
 | Command | Default fields |
@@ -38,7 +38,7 @@ The foundational read projections are:
 | `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
+REST reads support explicit `--fields <projection>`, except fixed-document `api-schema get`. Projection results retain the server's
 field names, `$type` and nullable values; authentication always validates fixed `id,login`.
 Offset collections use `--page-size 50 --start 0` by default. Page size requests rows per HTTP
 page; start is the zero-based raw offset. Both must be nonnegative safe integers, with a safe sum.
@@ -48,7 +48,7 @@ onboarding or credential access on CLI, execute and RPC. The static errors are
 `--page-size must be a nonnegative safe decimal integer.` and
 `--start must be a nonnegative integer.`; they never include the supplied input.
 Directly callable service methods retain their own range validation.
-All 49 offset lists return `{count,items,hasMore,nextStart}` across library, CLI, execute and RPC.
+All 62 offset lists return `{count,items,hasMore,nextStart}` across library, CLI, execute and RPC.
 Each ordinary list makes one request without lookahead and rejects an oversized server page.
 Nonempty pages have `hasMore:null`, including short pages: a server cap is not end evidence.
 Continue at `nextStart`, which advances by actual returned rows. A positive-size empty page has
@@ -108,51 +108,114 @@ Compressed wire length is syntax-checked but not compared with decoded size. HTT
 Retry-After, empty/null mutation and UTF-8 BOM behavior are unchanged. No request is retried
 automatically. Runtime memory and service limits still apply.
 
-## M01: issue workflows in 0.8.0
-
-The API inventory is frozen at 282 published operations (281 business routes plus schema metadata).
-M01 exposes 128 routes. Complete operation contracts cover 119/282 (42.20%); nine reachable routes
-still have explicitly deferred request controls. The [frozen audit](docs/rest-api-coverage/README.md)
-and [current mapping](docs/rest-api-coverage/current/coverage.json) keep these measures separate.
-
-- `issues list --custom-field <name>` is repeatable. Names, order and duplicates are preserved
-  as repeated native `customFields` parameters, including every request made by `--all`.
-- `issues activity list <issueID> --categories <categories>` reads one offset page;
-  `issues activity get <issueID> <activityID>` reads one item. These differ from the native
-  `issues activity page` cursor resource. The issue list/page support `--author`,
-  `--activity-start` and `--activity-end`; only the cursor page accepts `--activity-id`.
-  Cursor values and direction remain opaque, without automatic traversal. Activity time bounds
-  remain literal API strings, including native Long values.
-- Issue create/update, custom-field set, comment add/update, attachment upload, link add and
-  work-item add/update accept `--fields` and `--mute-update-notifications [boolean]`.
-  An omitted notification flag sends no parameter; a bare flag means true, and `false` is sent
-  as false. The server enforces Apply Commands Silently; this does not mute workflow notifications.
-  Only issue create and comment add accept `--draft-id`. Keep `--body` required; use `{}` when
-  publishing a draft without additional fields. Normal issue creation still requires project/summary.
-- `work-items list` adds repeatable `--author` and `--creator`, `--start-date`, `--end-date`, `--work-start`,
-  `--work-end`, `--created-start`, `--created-end`, `--updated-start`, `--updated-end`.
-  `--start` stays the raw offset; `--work-start` selects the native temporal `start` filter.
-  Filter values remain literal strings so a native Long does not lose precision in JavaScript.
-  YouTrack validates date formats, interval semantics and applicability.
-- `tags list --query <query>` searches the tag catalogue. `issues tags get <issueID> <tagID>`
-  inspects one assignment; tag add and existing tag/link remove commands accept `--fields`.
-- `issues attachments update <issueID> <attachmentID> --body <json>` updates native metadata.
-  `issues attachments delete <issueID> <attachmentID>` and
-  `issues work-items delete <issueID> <itemID>` remove only the selected resource.
-
-Write failures after submission report an unknown outcome when the reply is lost, unreadable or
-invalid, or the server returns 5xx. Check the selected object before retrying; no automatic retry
-is performed. HTTP 4xx rejection and local validation keep their distinct diagnostics.
-- `issues comments reaction list/get/add/remove` take issue/comment IDs, plus a reaction ID
-  for get/remove. Add requires `--body` containing native `reaction`; names are not restricted
-  to a hard-coded list. Reads use ReadOnly; add/remove use Update, even when remote service
-  permissions call these operations reads.
-
-Every new read/write supports `--fields`. DELETE projections follow the explicit official
-parameter tables; an omitted projection preserves the prior query-free DELETE. Successful empty
-write bodies return JSON null; nonempty native results are scrubbed as usual. Optional fields do
-not imply response/version guarantees beyond the public contract. All writes stay Update-gated,
-with no implicit lookup, automatic retry, target expansion or binary transfer follow-up.
+## Command guide
+
+Use a leaf's `--help` for its exact selectors, options and permission category. One declaration
+supplies human/JSON/execute/RPC; the SDK exports the same concrete operations. Native service
+rights and edition/version applicability are separate from local ReadOnly/Update gates.
+
+| Work | Commands and selectors |
+|---|---|
+| Everyday issues | `issues list/get/create/update/delete`, `issues fields list/get/set`, `issues comments`, `issues attachments`, `issues tags`, `issues links`, `issues work-items` |
+| Search and explicit bulk work | `search assist`, `commands assist/apply`, `issues count`, `issues batch validate/apply`, `saved-queries list/get/create/update/delete` |
+| Projects | `project list/get/create/update/delete`, `project issues`, `project field`, `project team`, `project time-tracking`, `project work-item-type`, `project article` |
+| People and access | `user me/list/get/create/update`, `user profile general/notifications/time-tracking`, `user saved-queries/tags`, `group`, `organization`, `role`, `role-assignment`, `permission-catalog` |
+| Knowledge base | `article list/get/create/update/delete/export`, `article child/parent`, `article comment` (including `article comment reaction`), `article tag/attachment`, `project article list` |
+| Iterations | `agile list/get/create/update/delete`, `sprint list/get/create/update/delete` with an agile selector |
+| Fields and bundles | `field list/get/create/update/delete`, `field type/defaults/instance`, `bundle enum/state/version/build/owned/user` and their selected value/member resources |
+| Work time and activity | `work-items list/get`, `work-item-type`, `time-tracking`, `activities list/get/page`, `issues activity list/get/page` |
+| Installation | `api-schema get`, `server telemetry get`, `server-settings get/update`, `server-settings appearance-settings/notification-settings/locale-settings/system-settings/rest-settings` |
+| Backups and licensing | `backup file list/get`, `backup settings get/update`, `backup status get`, `server-settings license get/update/import/delete` |
+| Local configuration | Core `profile`, `auth`, `permissions`; `user initial-password import/delete` and `server-settings license import/delete` |
+
+### Native selectors and controls
+
+`--body` is native JSON, with explicit descriptor objects and `$type` where required. Additional
+native fields, nulls, false and repeated selections are preserved; metadata forwarding does not
+promise every read-only attribute is writable. YouTrack resolves service values. The CLI does no
+implicit discovery, field-type guessing, search-to-write expansion, retry or compensation.
+
+- Issue/project-issue create/update and lists support repeatable `--custom-field` selectors where
+  declared. Write controls include `--fields`, `--mute-update-notifications [boolean]` and draft
+  publication `--draft-id` on the applicable leaves. Omission stays omitted; explicit false survives.
+- `commands apply --issues DEMO-1,DEMO-2 --query "State Fixed"` is Update. Optional `--comment`,
+  `--visibility <json>`, `--run-as <login>` and `--silent [boolean]` remain native; service rights
+  still apply. Assist/count POST requests remain ReadOnly and never poll/apply automatically.
+- Activity filters use `--author`, `--activity-start`, `--activity-end` and, on cursor pages,
+  `--activity-id`; global activity adds `--issue-query`. Native categories/cursors remain opaque.
+  Work-item filters include repeatable author/creator and date/created/updated bounds; `--start`
+  stays the offset and `--work-start` is the native temporal filter. Values stay literal strings.
+- Creation uses native required identities: project name/shortName/leader.id, board name/projects,
+  issue/project-issue summary, work-type/value name and user login/initial-password alias.
+  Bundle create has no locally invented mandatory name; value creation requires its native name.
+- Link direction labels preserve native `targetToSource:null`; calendar Int32 values/order/duplicates
+  have no invented positive/weekday limit. Version/build dates and owned-user descriptors preserve
+  documented nulls. Locale changes require `locale.id`; appearance/email use descriptor objects.
+- Project-field detach/global-field delete and relationship removal/global-object delete have
+  distinct selectors/scopes. No automatic cascade or rollback is synthesized. Optional DELETE
+  `--fields` follows the reference tables; omission stays query-free, without a live-version claim.
+
+Detailed native source dispositions and examples are retained in the
+[delivery history](docs/milestone-history.md). Current METHOD/path bindings, controls, permissions,
+all surfaces and tests for every operation are in [current coverage](docs/rest-api-coverage/current/README.md).
+
+### Auxiliary credentials
+
+A secure runner supplies `YOUTRACK_INITIAL_PASSWORD` or `YOUTRACK_LICENSE`. After configuring and
+signing in to the selected profile, deliberately enable Update to import/use/remove an alias:
+
+```sh
+youtrack-cli permissions grant Update --profile dev
+youtrack-cli user initial-password import initial-user --from-env --profile dev
+youtrack-cli user create --body '{"login":"new-user"}' --password-secret initial-user --profile dev
+youtrack-cli user initial-password delete initial-user --profile dev
+youtrack-cli server-settings license import server-key --from-env --profile dev
+youtrack-cli server-settings license update --license-secret server-key --profile dev
+youtrack-cli server-settings license delete server-key --profile dev
+```
+
+Import/delete use the selected profile's Core secret store, make no HTTP request for a configured,
+authenticated profile, and return only a scrubbed alias/acknowledgement. Namespaced aliases never
+replace the bearer token or another profile/family. Values retain exact bytes; absent/empty env
+input fails with no plaintext fallback. Writes read only the stored alias, with no env fallback.
+CLI raw password/license material is rejected, including nested root license writes. Native license
+null clearing/username metadata remain available through `--body` without an alias.
+
+Delete is idempotent: `{alias,deleted:true}` acknowledges removal, including an already absent
+alias; it does not claim a value previously existed. An import/use never erases an alias implicitly.
+Deleting a CLI profile removes its auth token, not auxiliary entries; delete each retained alias
+while that profile is configured/authenticated, or manage it through the platform store/SDK.
+There is no listing/export of secret values or automatic cleanup of user data.
+
+Cancellation checked after integration lookups and before calling the Core mutation prevents that
+call. Once Core delete() is dispatched, its internal lookup and persistence are not abort-aware:
+exit130 may coexist with a removed alias. No value-retention/rollback guarantee is made after
+dispatch. Import likewise makes no rollback promise once Core set() starts. Deletion failures
+report an unknown store outcome and retain useful redacted causes. Nothing is retried automatically. Password/license-bearing JSON
+body dispatches require the original HTTPS origin at every redirect hop. Same-origin redirects and
+redirects discarding the body retain normal behavior. Known input/native license values and their
+raw/JSON/URI/escaped-control copies are masked; unknown secrets are not universally detectable.
+
+### Installation administration
+
+`api-schema get` reads one native document; human output shows metadata, machine output retains
+its scrubbed native shape. It does not crawl or prove deployed conformance. Default telemetry
+avoids installation paths/online identities; root settings default to the root ID. System writes
+preserve native null/false/numeric types; changing remote baseUrl never rewrites a CLI profile.
+CORS origin strings retain their hosts, ports and paths. Appearance/locale/email use native objects;
+SSL keys are nullable StorageEntry references, not private-key uploads or invented SMTP passwords.
+
+Backup file get/list reads metadata, not archives. Settings/status reads do not start or poll a
+backup. A caller-supplied backupStatus action is sent only in an explicit Update settings request;
+request success does not prove completion. Native archiveFormat is TAR_GZ/ZIP; nullable location,
+Int32 filesToKeep and literal cronExpression are preserved. No restore workflow is provided.
+Server license keys and backup scheduling/retention differ from Cloud's managed single-backup
+export. No edition is guessed from hostnames or guaranteed from a schema version. See JetBrains'
+[optional API reference: backup use-case](https://www.jetbrains.com/help/youtrack/devportal/api-usecase-backup.html),
+[optional API reference: Cloud backups](https://www.jetbrains.com/help/youtrack/cloud/database.html),
+[optional API reference: Server backups](https://www.jetbrains.com/help/youtrack/server/back-up-the-database.html) and
+[optional API reference: Server license](https://www.jetbrains.com/help/youtrack/server/license-details.html).
+Unsupported rights/edition responses remain failures, not successful skips or automatic grants.
 
 ## URL and token input
 
@@ -285,31 +348,31 @@ as comment reads. An empty successful mutation response becomes JSON `null`. No
 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
+## Search, relationships and work items
 
 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 |
+| Family | Representative commands |
+|---|---|
+| Queries and commands | `commands assist/apply`, `search assist`, `issues count`, `saved-queries list/get` |
+| Project, users and fields | `project get`, `project field list/get`, `user list`, `issues fields list/get/set` |
+| Links and tags | `link-types list/get`, `tags list/get`, `issues links list/get/issues/add/remove`, `issues tags list/add/remove` |
+| Activity and context | `activities page`, `issues activity page`, `issues comments get/update`, `issues vcs-changes list/get`, `issues sprints list` |
+| Work time | `issues time-tracking get`, `issues work-items list/get/add/update`, `work-items list/get` |
+| Attachments | `issues attachments list/get/upload` |
 
 `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` uses the API's signed Int type; the server validates position semantics.
 `commands apply` requires comma-separated explicit issue IDs via
-`--issues`, never an implicit search expansion. It has no run-as or silent mode. Count returns the
+`--issues`, never an implicit search expansion. The explicit run-as/silent controls are described above. 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
+Activity cursor 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.
+Global and issue activity filters, plus offset item list/detail commands, are described in the command guide and delivery history.
 
 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
@@ -334,31 +397,28 @@ fields are `duration`, `date`, `author`, `type`, `text`, `created` and `updated`
 use integer Unix milliseconds; `author` and `type` use `{ "id": "..." }` or `null`. Text may be
 empty, multiline or null; `updated` may also be null. Updates preserve additional native fields and
 leave omitted fields to the server. 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
+writes accept `--fields`; only global `work-items list` supports `--query`. Native date/author filters are described in the command guide above. 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/empty/NUL 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.
+Only the basename becomes the multipart filename; errors never echo local paths. The separate binary download capability is documented below; metadata reads never follow links automatically.
 
-## Additional commands through operation 100
+## Catalogs, teams and knowledge base
 
-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.
+Two `--direct` switches each select between documented direct/aggregated membership endpoints.
+They do not add command aliases or change the offset-page contract.
 
-| 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 |
+| Family | Representative commands |
+|---|---|
+| Global fields and choices | `field list/get`, `field type list`, `bundle enum/state list/get`, `bundle enum/state value list/get` |
+| User directory and bundles | `user get`, `bundle user list/get`, `bundle user member list`, `bundle user group list/get`, `bundle user individual list/get` |
+| 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]` |
+| 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` |
+| Boards and sprints | `agile list/get`, `sprint list/get/create/update` |
+| Articles | `article list/get/create/update`, `article comment list/get/add/update`, `project article list` |
 
 Every new read supports `--fields`. Offset lists retain one-page `--page-size`/`--start` behavior;
 details and settings reads have no paging flags. Bundle defaults omit nested values and members:
@@ -385,16 +445,17 @@ preserves supplied native fields. Known fields include `name`, `goal`, `start`,
 Unix milliseconds or null; flags are booleans. Create additionally accepts
 `previousSprint: { "id": "..." }`, which explicitly moves unresolved issues from that sprint.
 It is never inferred; the server validates its applicability. `isDefault: true` affects where matching new
-board issues go. Additional native sprint properties are forwarded; separate agile mutations and deletion remain outside
-this block. Reads and writes support `--fields`; there is no carryover lookup or polling.
+board issues go. Additional native sprint properties are forwarded. `agile` and `sprint` create/update/delete use
+selected IDs and require Update; reads/writes support `--fields`, without carryover lookup or polling.
 
 Article create accepts a native project reference and nullable summary. Article and comment
 updates preserve additional native fields, including parent, visibility and pinning. Known text
 fields preserve multiline strings and documented null values; omission leaves API defaults in charge. Article and comment reads/writes
 support `--fields`; article lists have no query flag. Article attachment transfer and hierarchy
-reads are documented below. Native body properties are validated by the API; separate deletion remains outside this command tree.
+reads are documented below. Native body properties are validated by the API. `article delete
+<article>` and `article comment delete <article> <comment>` require Update and affect only selected IDs.
 
-## Remaining bundles, article hierarchy and attachment transfer
+## 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.
@@ -494,8 +555,6 @@ Deliberate differences:
 - a failed batch never deletes created issues to compensate.
 
 Not provided:
-- project, user, group and role administration;
-- deletion wrappers;
 - burndown and velocity reports;
 - interactive tables, themes, tutorials and aliases;
 - stdin input (JSON-RPC owns stdin).
@@ -533,5 +592,11 @@ Tests inject `AppArguments` rather than redirecting the user's data directories.
 
 ## Source development
 
-`npm ci`, `npm test`, and `npm run test:package` build and test this repository independently.
+Repository verification uses Node.js24+ (the installed CLI retains Node.js22+). `npm test` is the
+ordinary offline suite; `npm run test:coverage` builds/runs that suite once with tracing, traverses
+the real tree and regenerates the frozen mapping twice. Only the documented commit-lineage field
+may differ from tracked summary metadata. Drift fails with artifact context and retains ignored
+evidence for explicit reviewed regeneration; the checker never overwrites tracked files or fetches
+public/service schemas. Cake Verify uses this gate, installed-package and release-safety checks.
+`npm ci` and `npm run test:package` retain the registry-based build/distribution boundaries.
 See [release and Core adoption gates](docs/release.md) and [migration provenance](docs/migration.md).

package/dist/src/access-catalog-commands.d.ts

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

package/dist/src/access-catalog-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-catalog-commands.d.ts","sourceRoot":"","sources":["../../src/access-catalog-commands.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,yBAAyB,qDAiBrC,CAAC"}

package/dist/src/access-catalog-commands.js

@@ -0,0 +1,24 @@
+import { command } from "@eyeauras/cli-factory";
+import { pagedRead, projectedRead, projectedBodyUpdate, projectedDelete } from "./cli-support.js";
+import { createRole, updateRole, deleteRole, createRoleAssignment, deleteRoleAssignment, listRoleAssignments, getRoleAssignment, listPermissions, listRoles, getRole } from "./access-catalog.js";
+import { mutationWritten, namedTable, roleRecord, roleAssignmentRecord, roleAssignmentTable } from "./presentation.js";
+const queryOptions = [{ flags: "--query <query>", description: "Filter with a YouTrack access query" }];
+export const accessCatalogRootCommands = [
+    command("role-assignment", "Manage role assignments", [
+        projectedBodyUpdate("create", "Assign a role in the selected scope", createRoleAssignment, undefined, roleAssignmentRecord),
+        projectedDelete("delete <assignment>", "Revoke a role assignment", deleteRoleAssignment, mutationWritten("Revoked role assignment", "assignment")),
+        pagedRead("list", "List role assignments", listRoleAssignments, roleAssignmentTable, queryOptions),
+        projectedRead("get <assignment>", "Show a role assignment", getRoleAssignment, roleAssignmentRecord),
+    ]),
+    command("permission-catalog", "Inspect service permissions", [
+        pagedRead("list", "List YouTrack permissions", listPermissions, namedTable("PERMISSION", "No permissions.")),
+    ]),
+    command("role", "Inspect and manage service roles", [
+        projectedBodyUpdate("create", "Create a service role", createRole, undefined, mutationWritten("Created role")),
+        projectedBodyUpdate("update <role>", "Update a selected role", updateRole, undefined, mutationWritten("Updated role", "role")),
+        projectedDelete("delete <role>", "Delete a selected role", deleteRole, mutationWritten("Deleted role", "role")),
+        pagedRead("list", "List YouTrack roles", listRoles, namedTable("ROLE", "No roles."), queryOptions),
+        projectedRead("get <role>", "Show a role", getRole, roleRecord),
+    ]),
+];
+//# sourceMappingURL=access-catalog-commands.js.map

package/dist/src/access-catalog-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-catalog-commands.js","sourceRoot":"","sources":["../../src/access-catalog-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAClM,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEvH,MAAM,YAAY,GAAG,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC,CAAC;AAExG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO,CAAC,iBAAiB,EAAE,yBAAyB,EAAE;QACpD,mBAAmB,CAAC,QAAQ,EAAE,qCAAqC,EAAE,oBAAoB,EAAE,SAAS,EAAE,oBAAoB,CAAC;QAC3H,eAAe,CAAC,qBAAqB,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,eAAe,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;QAClJ,SAAS,CAAC,MAAM,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,CAAC;QAClG,aAAa,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;KACrG,CAAC;IACF,OAAO,CAAC,oBAAoB,EAAE,6BAA6B,EAAE;QAC3D,SAAS,CAAC,MAAM,EAAE,2BAA2B,EAAE,eAAe,EAAE,UAAU,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;KAC7G,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,kCAAkC,EAAE;QAClD,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;QAC9G,mBAAmB,CAAC,eAAe,EAAE,wBAAwB,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC9H,eAAe,CAAC,eAAe,EAAE,wBAAwB,EAAE,UAAU,EAAE,eAAe,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC/G,SAAS,CAAC,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,YAAY,CAAC;QAClG,aAAa,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,CAAC;KAChE,CAAC;CACH,CAAC"}

package/dist/src/access-catalog.d.ts

@@ -0,0 +1,12 @@
+import { type ProjectionOptions, type Connection, type IssueSearchOptions } from "./client.js";
+export declare function listRoleAssignments(connection: Connection, options?: IssueSearchOptions): Promise<import("./client.js").YouTrackPage<import("./client.js").YouTrackObject>>;
+export declare const getRoleAssignment: (connection: Connection, assignmentID: string, options?: ProjectionOptions | undefined) => Promise<import("./client.js").YouTrackObject>;
+export declare const listPermissions: (connection: Connection, options?: import("./client.js").PageOptions | undefined) => Promise<import("./client.js").YouTrackPage>;
+export declare function listRoles(connection: Connection, options?: IssueSearchOptions): Promise<import("./client.js").YouTrackPage<import("./client.js").YouTrackObject>>;
+export declare const getRole: (connection: Connection, roleID: string, options?: ProjectionOptions | undefined) => Promise<import("./client.js").YouTrackObject>;
+export declare function createRoleAssignment(connection: Connection, input: unknown, options?: ProjectionOptions): Promise<import("./client.js").YouTrackObject | null>;
+export declare function deleteRoleAssignment(connection: Connection, assignmentID: string, options?: ProjectionOptions): Promise<import("./client.js").YouTrackObject | null>;
+export declare function createRole(connection: Connection, input: unknown, options?: ProjectionOptions): Promise<import("./client.js").YouTrackObject | null>;
+export declare function updateRole(connection: Connection, roleID: string, input: unknown, options?: ProjectionOptions): Promise<import("./client.js").YouTrackObject | null>;
+export declare function deleteRole(connection: Connection, roleID: string, options?: ProjectionOptions): Promise<import("./client.js").YouTrackObject | null>;
+//# sourceMappingURL=access-catalog.d.ts.map

package/dist/src/access-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-catalog.d.ts","sourceRoot":"","sources":["../../src/access-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EACqE,KAAK,iBAAiB,EAChG,KAAK,UAAU,EAAE,KAAK,kBAAkB,EACzC,MAAM,aAAa,CAAC;AAMrB,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,qFAKjG;AACD,eAAO,MAAM,iBAAiB,0IAG7B,CAAC;AACF,eAAO,MAAM,eAAe,kIAAwD,CAAC;AACrF,wBAAsB,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,qFAKvF;AACD,eAAO,MAAM,OAAO,oIAEnB,CAAC;AAGF,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,wDASjH;AACD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,wDAEvH;AAGD,wBAAsB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,wDAEvG;AACD,wBAAsB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,wDAEvH;AACD,wBAAsB,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,wDAEvG"}

package/dist/src/access-catalog.js

@@ -0,0 +1,44 @@
+import { fields, mutate, deleteObject, mutationBody, namedMutationBody, narrative, encodedID, page, readPage, readCollectionAt, readObjectAt, requiredText, } from "./client.js";
+const assignmentFields = "id,role(id,name),holder(id,$type),scope(id,$type)";
+const roleFields = "id,name,description,immutable,permissions(id,name)";
+const permissionFields = "id,name,description,scope,operation,permissionEntityType";
+export async function listRoleAssignments(connection, options = {}) {
+    return readPage(connection, "api/assignedRoles", {
+        ...page(options, assignmentFields),
+        ...(options.query === undefined ? {} : { query: requiredText(options.query, "query") }),
+    });
+}
+export const getRoleAssignment = readObjectAt((assignmentID) => `api/assignedRoles/${encodedID(assignmentID, "role assignment ID")}`, assignmentFields);
+export const listPermissions = readCollectionAt("api/permissions", permissionFields);
+export async function listRoles(connection, options = {}) {
+    return readPage(connection, "api/roles", {
+        ...page(options, roleFields),
+        ...(options.query === undefined ? {} : { query: requiredText(options.query, "query") }),
+    });
+}
+export const getRole = readObjectAt((roleID) => `api/roles/${encodedID(roleID, "role ID")}`, roleFields);
+export async function createRoleAssignment(connection, input, options = {}) {
+    const body = mutationBody(input);
+    requiredText(narrative(mutationBody(body.role).id, "role ID"), "role ID");
+    requiredText(narrative(mutationBody(body.holder).id, "holder ID"), "holder ID");
+    const scope = mutationBody(body.scope);
+    requiredText(narrative(scope.$type, "scope type"), "scope type");
+    if (scope.$type === "ProjectScope")
+        requiredText(narrative(mutationBody(scope.project).id, "project ID"), "project ID");
+    if (scope.$type === "OrganizationScope")
+        requiredText(narrative(mutationBody(scope.organization).id, "organization ID"), "organization ID");
+    return mutate(connection, "api/assignedRoles", body, fields(options, assignmentFields));
+}
+export async function deleteRoleAssignment(connection, assignmentID, options = {}) {
+    return deleteObject(connection, `api/assignedRoles/${encodedID(assignmentID, "role assignment ID")}`, options);
+}
+export async function createRole(connection, input, options = {}) {
+    return mutate(connection, "api/roles", namedMutationBody(input, false), fields(options, roleFields));
+}
+export async function updateRole(connection, roleID, input, options = {}) {
+    return mutate(connection, `api/roles/${encodedID(roleID, "role ID")}`, namedMutationBody(input, false), fields(options, roleFields));
+}
+export async function deleteRole(connection, roleID, options = {}) {
+    return deleteObject(connection, `api/roles/${encodedID(roleID, "role ID")}`, options);
+}
+//# sourceMappingURL=access-catalog.js.map

package/dist/src/access-catalog.js.map

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

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

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

package/dist/src/agile-commands.js

@@ -1,16 +1,25 @@
 import { command } from "@eyeauras/cli-factory";
-import { pagedRead, projectedBodyUpdate, projectedRead } from "./cli-support.js";
-import { createSprint, getAgile, getSprint, listAgiles, listSprints, updateSprint } from "./agile.js";
-import { agileRecord, agileTable, sprintRecord, sprintTable, sprintWritten } from "./presentation.js";
+import { projectedDelete, pagedRead, projectedBodyUpdate, projectedRead, bodyOptions, projectionOptions, readOptions, updateCommand, notificationOptions } from "./cli-support.js";
+import { agileTemplate, deleteAgile, deleteSprint, createAgile, updateAgile, createSprint, getAgile, getSprint, listAgiles, listSprints, updateSprint } from "./agile.js";
+import { mutationWritten, rememberSubmittedIdentity, agileRecord, agileTable, agileWritten, withView, sprintRecord, sprintTable, sprintWritten } from "./presentation.js";
 export const agileRootCommands = [
-    command("agile", "Inspect agile boards", [
+    command("agile", "Inspect and manage agile boards", [
+        projectedDelete("delete <agile>", "Delete a selected board", deleteAgile, mutationWritten("Deleted board", "agile")),
+        withView(agileWritten("Created"), updateCommand("create", "Create an agile board", async (client, input) => {
+            const { options } = input;
+            const result = await createAgile(client, options.body, { ...readOptions(options), ...(typeof options.template === "string" ? { template: options.template } : {}) });
+            rememberSubmittedIdentity(input, client.token);
+            return result;
+        }, [...bodyOptions, ...projectionOptions, { flags: "--template <name>", description: "Use a board template", parse: agileTemplate }])),
+        projectedBodyUpdate("update <agile>", "Update an agile board", updateAgile, undefined, agileWritten("Updated")),
         pagedRead("list", "List agile boards", listAgiles, agileTable),
         projectedRead("get <agile>", "Show an agile board", getAgile, agileRecord),
     ]),
     command("sprint", "Inspect and manage sprints", [
+        projectedDelete("delete <agile> <sprint>", "Delete a selected sprint", deleteSprint, mutationWritten("Deleted sprint", "sprint", "agile")),
         pagedRead("list <agile>", "List a board's sprints", listSprints, sprintTable),
         projectedRead("get <agile> <sprint>", "Show a sprint (current for the current one)", getSprint, sprintRecord),
-        projectedBodyUpdate("create <agile>", "Create a sprint", createSprint, undefined, sprintWritten("Created")),
+        projectedBodyUpdate("create <agile>", "Create a sprint", createSprint, undefined, sprintWritten("Created"), notificationOptions),
         projectedBodyUpdate("update <agile> <sprint>", "Update a sprint", updateSprint, undefined, sprintWritten("Updated")),
     ]),
 ];

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

@@ -1 +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;AACtG,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,OAAO,EAAE,sBAAsB,EAAE;QACvC,SAAS,CAAC,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,CAAC;QAC9D,aAAa,CAAC,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,CAAC;KAC3E,CAAC;IACF,OAAO,CAAC,QAAQ,EAAE,4BAA4B,EAAE;QAC9C,SAAS,CAAC,cAAc,EAAE,wBAAwB,EAAE,WAAW,EAAE,WAAW,CAAC;QAC7E,aAAa,CAAC,sBAAsB,EAAE,6CAA6C,EAAE,SAAS,EAAE,YAAY,CAAC;QAC7G,mBAAmB,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAC3G,mBAAmB,CAAC,yBAAyB,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;KACrH,CAAC;CACH,CAAC"}
+{"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,eAAe,EAAE,SAAS,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACnL,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1K,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1K,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,OAAO,EAAE,iCAAiC,EAAE;QAClD,eAAe,CAAC,gBAAgB,EAAE,yBAAyB,EAAE,WAAW,EAAE,eAAe,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACpH,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,QAAQ,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;YACzG,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrK,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC,EACC,CAAC,GAAG,WAAW,EAAE,GAAG,iBAAiB,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,sBAAsB,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;QACrI,mBAAmB,CAAC,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QAC/G,SAAS,CAAC,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,CAAC;QAC9D,aAAa,CAAC,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,CAAC;KAC3E,CAAC;IACF,OAAO,CAAC,QAAQ,EAAE,4BAA4B,EAAE;QAC9C,eAAe,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,YAAY,EAAE,eAAe,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1I,SAAS,CAAC,cAAc,EAAE,wBAAwB,EAAE,WAAW,EAAE,WAAW,CAAC;QAC7E,aAAa,CAAC,sBAAsB,EAAE,6CAA6C,EAAE,SAAS,EAAE,YAAY,CAAC;QAC7G,mBAAmB,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;QAChI,mBAAmB,CAAC,yBAAyB,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;KACrH,CAAC;CACH,CAAC"}

package/dist/src/agile.d.ts

@@ -1,8 +1,17 @@
-import { type Connection, type ProjectionOptions, type YouTrackObject } from "./client.js";
+import { type Connection, type ProjectionOptions, type WriteOptions, type YouTrackObject } from "./client.js";
 export declare const listAgiles: (connection: Connection, options?: import("./client.js").PageOptions | undefined) => Promise<import("./client.js").YouTrackPage>;
 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<import("./client.js").YouTrackPage>;
 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 createSprint(connection: Connection, agile: string, input: unknown, options?: WriteOptions): Promise<YouTrackObject | null>;
 export declare function updateSprint(connection: Connection, agile: string, sprint: string, input: unknown, options?: ProjectionOptions): Promise<YouTrackObject | null>;
+/** Native board templates from the pinned primary reference. */
+export declare function agileTemplate(value: unknown): string;
+export interface AgileCreateOptions extends ProjectionOptions {
+    template?: string;
+}
+export declare function createAgile(connection: Connection, input: unknown, options?: AgileCreateOptions): Promise<YouTrackObject | null>;
+export declare function updateAgile(connection: Connection, agile: string, input: unknown, options?: ProjectionOptions): Promise<YouTrackObject | null>;
+export declare function deleteAgile(connection: Connection, agileID: string, options?: ProjectionOptions): Promise<YouTrackObject | null>;
+export declare function deleteSprint(connection: Connection, agileID: string, sprintID: string, options?: ProjectionOptions): Promise<YouTrackObject | null>;
 //# sourceMappingURL=agile.d.ts.map

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

@@ -1 +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,kIAA8C,CAAC;AACtE,eAAO,MAAM,QAAQ,6GAAuC,CAAC;AAC7D,eAAO,MAAM,WAAW,iJAGvB,CAAC;AACF,eAAO,MAAM,SAAS,6HAIrB,CAAC;AA4CF,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"}
+{"version":3,"file":"agile.d.ts","sourceRoot":"","sources":["../../src/agile.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AASrB,eAAO,MAAM,UAAU,kIAA8C,CAAC;AACtE,eAAO,MAAM,QAAQ,6GAAuC,CAAC;AAC7D,eAAO,MAAM,WAAW,iJAGvB,CAAC;AACF,eAAO,MAAM,SAAS,6HAIrB,CAAC;AA4CF,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,YAAiB,kCAS3B;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,iBAAsB,kCAQhC;AAGD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD;AACD,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;CAAE;AACpF,wBAAsB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,kCASzG;AACD,wBAAsB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,kCAEvH;AAGD,wBAAsB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,kCAEzG;AACD,wBAAsB,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,kCAE5H"}

package/dist/src/agile.js

@@ -1,4 +1,4 @@
-import { encodedID, fields, mutate, mutationBody, nullableText, readCollectionAt, readObjectAt, requiredText, } from "./client.js";
+import { deleteObject, encodedID, fields, mutate, mutationBody, narrative, namedMutationBody, 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) {
@@ -50,9 +50,36 @@ function sprintBody(input, creating) {
     return result;
 }
 export async function createSprint(connection, agile, input, options = {}) {
-    return mutate(connection, `${agilePath(agile)}/sprints`, sprintBody(input, true), fields(options, sprintFields));
+    return mutate(connection, `${agilePath(agile)}/sprints`, sprintBody(input, true), fields(options, sprintFields), options);
 }
 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));
 }
+/** Native board templates from the pinned primary reference. */
+export function agileTemplate(value) {
+    const template = narrative(value, "template");
+    if (!["kanban", "scrum", "version", "custom", "personal"].includes(template)) {
+        throw new Error("The board template must be kanban, scrum, version, custom or personal.");
+    }
+    return template;
+}
+export async function createAgile(connection, input, options = {}) {
+    const body = namedMutationBody(input, true);
+    if (!Array.isArray(body.projects))
+        throw new Error("A new board requires projects with explicit IDs.");
+    const projects = body.projects.map(value => {
+        const project = mutationBody(value);
+        return { ...project, id: requiredText(project.id, "project ID") };
+    });
+    return mutate(connection, "api/agiles", { ...body, projects }, agileFields, options, options.template === undefined ? {} : { template: agileTemplate(options.template) });
+}
+export async function updateAgile(connection, agile, input, options = {}) {
+    return mutate(connection, agilePath(agile), namedMutationBody(input, false), fields(options, agileFields));
+}
+export async function deleteAgile(connection, agileID, options = {}) {
+    return deleteObject(connection, agilePath(agileID), options);
+}
+export async function deleteSprint(connection, agileID, sprintID, options = {}) {
+    return deleteObject(connection, `${agilePath(agileID)}/sprints/${encodedID(sprintID, "sprint ID")}`, options);
+}
 //# sourceMappingURL=agile.js.map