@floh-solutions/pharos-cli 0.24.0 → 0.26.0

package/README.md

@@ -116,16 +116,18 @@ capability that must be impossible has to be withheld at the token.
 task <id>                             the whole context, in one call
 wiki list | tree | read | write | delete
 comment list | add | edit | delete | react | unreact | reactors
+comment hide | unhide | pin | unpin    GitHub only
 issue adopt | link | say | trail | drift | backfill | close
                                       a GitHub issue and a work item, joined —
                                       and kept honest
 plan <file>                           an implementation plan becomes a work item tree
 ```
 
-`comment` takes either kind of target: a work item is its number (`210`), a wiki
-page is an **absolute path** (`/Plans/Foo`). The leading slash is required by
-the wiki API itself — it answers 404 without one — so the spelling that tells
-them apart is also the only spelling that works.
+`comment` takes any of three targets: a work item is its number (`210`), a wiki
+page is an **absolute path** (`/Plans/Foo`), a GitHub issue is
+`owner/name#45`. The leading slash is required by the wiki API itself — it
+answers 404 without one — so the spelling that tells them apart is also the only
+spelling that works, and the three grammars cannot collide.
 
 Long text does not belong on a command line:
 
@@ -134,6 +136,54 @@ pharos comment add 210 --file review.md
 pharos wiki write /Plans/Sprint-4 --stdin < plan.md
 ```
 
+### `comment` on a GitHub issue — the surface `gh` half has and half has not
+
+```bash
+pharos comment list   contoso/widgets#45          # ids, state, and what you MAY do
+pharos comment edit   contoso/widgets#45 900 --file fixed.md
+pharos comment delete contoso/widgets#45 900 --yes
+pharos comment react  contoso/widgets#45 900 thumbs-up
+pharos comment hide   contoso/widgets#45 900 off-topic
+pharos comment pin    contoso/widgets#45 900
+```
+
+This is the one place `pharos` reaches past the join, and it is two arguments
+rather than one. **Editing or deleting a comment can destroy the link record**,
+which nothing outside this repo knows to protect. And **hide and pin have no
+`gh` verb at all** — they are GraphQL mutations with no REST route, so they pass
+the same "nothing else can do this" test the `issue` verbs pass. Posting a *new*
+comment is still `gh issue comment` or `pharos issue say`, and `comment add` on
+a GitHub issue is refused with both of those named.
+
+**`list` is the load-bearing verb**, and it is not one the macOS app needed: the
+app has a window, an agent has this. Before it there was no way to learn a
+GitHub comment id from this CLI at all, so nothing else here was addressable. It
+prints both ids per comment — the REST number that edit, delete and reactions
+address, and the node id that hide and pin take, because neither is derivable
+from the other — plus a `may` object read from GitHub's own `viewerCan…` fields.
+For a window those grey out a menu item; for an agent they turn a write that
+would 403 into a fact known beforehand.
+
+**An edit cannot double or strip the `pharos:v1` trailer.** Send prose with no
+trailer and the existing one is restored, with `markerPreserved: true` saying
+so; send two, or one naming a different work item, or one on a comment that
+never had one, and the edit is refused with the reason and the repair. The rule
+lives in `gh-core`, not here, because it is a rule about the link record rather
+than about this command — and the macOS app edits through the same package.
+
+**Deleting the comment that carries the trailer is allowed and never silent.**
+The `--yes` refusal names the work item about to lose its GitHub end and hands
+over the `pharos issue link` that puts it back; `--dry-run` prints the same
+preview and exits 0. Both read the comment first, because a preview that could
+not say which of the two deletes this is would be a preview of the wrong thing.
+
+Reactions are **not one vocabulary across the two platforms**. Azure DevOps
+takes `like dislike heart hooray smile confused`; GitHub takes `thumbs-up
+thumbs-down laugh hooray confused heart rocket eyes`. Passing one platform's
+name to the other is refused rather than translated. The CLI spelling is words
+because GitHub's own names for the first two are `+1` and `-1`, and `-1` as a
+positional is read as a flag by every argument parser including this one.
+
 ### `issue` — the GitHub edge, and only the edge
 
 ```bash
@@ -144,6 +194,7 @@ pharos issue trail 4821            # …or trail contoso/widgets#45
 pharos issue drift                 # where the two platforms disagree
 pharos issue backfill contoso/widgets --limit 25 --yes
 pharos issue close 4821 --text "Shipped in 1.4.0."
+pharos issue edit contoso/widgets#45 --title "Crash on resize" --yes
 ```
 
 Azure DevOps already has a GitHub integration and **the link it makes carries
@@ -152,12 +203,38 @@ the transition only ever fires from a commit or a PR merge, never from closing
 an issue. That is the gap, and it is the whole pitch — not "there is no
 integration".
 
-**Seven verbs, because `gh` already exists.** Listing, viewing and commenting on
+**Eight verbs, because `gh` already exists.** Listing, viewing and commenting on
 an issue is `gh`'s job and it is better at it — closing one *end* is `gh issue
 close`, and closing the *pair* is `pharos issue close`; a second GitHub CLI
 would be the drifting duplicate this repo has been bitten by three times.
 Pharos owns what `gh` cannot see: the join.
 
+**`edit` is the one verb that overlaps `gh` head on, and it earns that by
+refusing.** `gh issue edit` writes the same fields and writes them well; what it
+cannot do is notice that somebody changed the thing you are overwriting. It is
+last-write-wins — if a colleague renamed the issue while you were composing,
+their rename is gone and neither of you is told. Fine for a human at a terminal,
+wrong for an agent that reads, thinks for a minute, and writes into a world that
+moved. Want an unguarded edit? `gh issue edit` is right there.
+
+The guard is a **value compare**, because GitHub offers nothing better:
+`PATCH /repos/{o}/{r}/issues/{n}` answers **400** to `If-Match` (measured), and
+`updated_at` and the ETag both move when somebody merely *comments*, so a
+timestamp guard would refuse a good edit for a change that touched nothing. So
+`edit` re-reads immediately before sending and refuses only if the text it is
+about to overwrite moved. Pass `--if-title` / `--if-body` / `--if-body-file` to
+guard against what **you** saw rather than against this command's own read; the
+output says which, as `fields.guard.window`. It narrows the race to one round
+trip and does not close it, and it says so.
+
+Two things GitHub does quietly, which `edit` reports:
+`POST …/labels` **creates** a repository label that does not exist (so an unknown
+one is refused with near misses — `--create-label` is how you mean it), and
+`POST …/assignees` **ignores** a login it will not assign while still answering
+201 (so read `assignees.ignored`). Labels and assignees go through their own
+add/remove endpoints, never the whole-issue PATCH, which carries them as whole
+arrays and would overwrite every label on every write.
+
 `adopt` creates the work item **and** writes both ends of the link:
 
 | | where | |
@@ -196,11 +273,12 @@ asks **this machine** — an adoption is written to `~/.config/pharos/half-links
 between the create and the comment, and removed when the comment lands — and
 then **the board**, narrowing on `[System.HyperLinkCount]` and matching the
 relation URLs client-side, which is the only way round Azure DevOps having no
-query over them. The first sees a work item created seconds ago that the query
-index has not caught up with yet; the second sees a half-link left on another
-machine. Every run reports `boardCheck`, because "the board says nobody has
-adopted this" and "the board could not be asked" are different facts and only
-one of them means the check happened.
+query over them. The board is the stronger of the two — it sees a half-link
+left on another machine — and the local record covers what it cannot: a board
+query that is refused, a half-link older than that scan's cap, and a refusal
+that costs no round trip. Every run reports `boardCheck`, because "the board
+says nobody has adopted this" and "the board could not be asked" are different
+facts and only one of them means the check happened.
 
 `trail` is read-only and answers from **either** end — the output shape does not
 depend on which you passed. Read `evidence`: `["hyperlink","marker"]` is a
@@ -430,6 +508,15 @@ name, so the wrong one answers **200** for a different repository. That is what
 — without it every `pharos issue` verb is refused by name with the reason, and
 the Azure DevOps verbs are untouched.
 
+**And it runs in the other direction too: a verb whose target is a GitHub issue
+needs no `ADO_PAT`.** `pharos comment list contoso/widgets#45` reads over `gh`'s
+credential and touches Azure DevOps at no point, so it works on a machine that
+has never had a PAT. The Azure DevOps configuration is resolved when something
+actually needs Azure DevOps, and not before — which means the `kind: "config"`
+error naming `ADO_PAT` now arrives only from a verb that would have used it.
+`pharos issue` is the exception and honestly so: it writes to both platforms in
+one invocation, so it needs both credentials.
+
 **`half-links.json` sits beside it, and it is the only thing this CLI remembers
 between runs.** An adoption is written there between the work item create and
 the GitHub comment and removed when the comment lands, so what survives is

package/dist/adopt-type.d.ts

@@ -0,0 +1,58 @@
+import type { GitHubIssue } from "@floh-solutions/gh-core";
+import { type CategorySource } from "./bridge.js";
+import type { Session } from "./session.js";
+/**
+ * Which work item type an adopted issue becomes — **resolved, never named**
+ * (#872).
+ *
+ * ## The bug this replaces
+ *
+ * `issue.ts` carried `const DEFAULT_WORK_ITEM_TYPE = "Issue"` and used it in two
+ * places. That is correct on *this* project by accident: Basic's requirement
+ * type happens to be called `Issue`. On **Agile** the word means an
+ * *impediment* — a blocker, tracked off the backlog — and the requirement type
+ * is `User Story`. So every GitHub issue adopted onto an Agile board was filed
+ * as a blocker, silently, and the CLI shipped that way in 0.25.0.
+ *
+ * A type name is a property of the project's **process template**. It can never
+ * be written down here.
+ *
+ * ## How it is decided
+ *
+ * 1. `--type` wins outright. Somebody naming a type has looked at their own
+ *    board, and this must not argue with them.
+ * 2. Otherwise the issue's **labels** choose a category — a saved mapping by
+ *    label id first, then the name defaults for a repository nobody has
+ *    configured. See `bridge.ts`.
+ * 3. The category is resolved against **this project's** own answer, from
+ *    `wit/workitemtypecategories`. The lookups are ordered because they
+ *    degrade: a feature request asks for `FeatureCategory` and settles for
+ *    `RequirementCategory`, which is all Basic has.
+ * 4. If none of that resolves — an unreachable board, a project with no
+ *    requirement category at all — it falls back to the old constant **and says
+ *    so**, because refusing to adopt over a naming question would be worse than
+ *    adopting into a type somebody can change.
+ *
+ * Every step is reported, because "this became a Bug because you mapped it" and
+ * "this became a Bug because nothing matched" are different facts and only one
+ * of them is a decision.
+ */
+export interface ResolvedType {
+    /** What to create. */
+    type: string;
+    /** How it was arrived at, for the report. */
+    source: CategorySource | "flag" | "fallback";
+    /** The category that was asked for, when one was. */
+    category?: string;
+    /** The label that decided it, when one did. */
+    label?: string;
+    /** Set when the project could not answer and the constant was used. */
+    note?: string;
+}
+/** The last-resort name. Basic's requirement type, and the historical default. */
+export declare const FALLBACK_WORK_ITEM_TYPE = "Issue";
+export declare function resolveWorkItemType(session: Session, issue: Pick<GitHubIssue, "repo" | "labels">, options?: {
+    type?: string | undefined;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ResolvedType>;
+//# sourceMappingURL=adopt-type.d.ts.map

package/dist/adopt-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt-type.d.ts","sourceRoot":"","sources":["../src/adopt-type.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,EAC3C,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACnE,OAAO,CAAC,YAAY,CAAC,CAkDvB"}

package/dist/adopt-type.js

@@ -0,0 +1,61 @@
+import { WorkItemTypesApi, typeForCategory } from "@floh-solutions/ado-core";
+import { categoryFor, defaultBridgePath, parseBridgeConfig, repoConfig, } from "./bridge.js";
+/** The last-resort name. Basic's requirement type, and the historical default. */
+export const FALLBACK_WORK_ITEM_TYPE = "Issue";
+export async function resolveWorkItemType(session, issue, options = {}) {
+    if (options.type !== undefined && options.type !== "") {
+        return { type: options.type, source: "flag" };
+    }
+    const env = options.env ?? process.env;
+    const organization = session.client.organization;
+    const project = session.client.project ?? "";
+    const config = await readBridge(env);
+    const repo = repoConfig(config, organization, project, issue.repo);
+    const choice = categoryFor(issue.labels.map((label) => ({ id: label.id ?? -1, name: label.name })), repo);
+    let catalog;
+    try {
+        catalog = await new WorkItemTypesApi(session.client.http).categories();
+    }
+    catch (error) {
+        // The board could not be asked. Adopting into the historical default is
+        // better than refusing, and naming the reason is what stops it reading as a
+        // deliberate choice.
+        return {
+            type: FALLBACK_WORK_ITEM_TYPE,
+            source: "fallback",
+            note: `the project's work item types could not be read (${error.message}), so the `
+                + `default "${FALLBACK_WORK_ITEM_TYPE}" was used — pass --type to be explicit`,
+        };
+    }
+    const resolved = typeForCategory(catalog, ...choice.categories);
+    if (resolved === undefined) {
+        return {
+            type: FALLBACK_WORK_ITEM_TYPE,
+            source: "fallback",
+            ...(choice.label === undefined ? {} : { label: choice.label }),
+            note: `this project has none of ${choice.categories.join(", ")}, so the default `
+                + `"${FALLBACK_WORK_ITEM_TYPE}" was used — pass --type to be explicit`,
+        };
+    }
+    return {
+        type: resolved,
+        source: choice.source,
+        ...(choice.categories[0] === undefined ? {} : { category: choice.categories[0] }),
+        ...(choice.label === undefined ? {} : { label: choice.label }),
+    };
+}
+/** The mapping, or an empty one. A missing or malformed file is not an error. */
+async function readBridge(env) {
+    const path = defaultBridgePath(env);
+    try {
+        const { readFile } = await import("node:fs/promises");
+        return parseBridgeConfig(await readFile(path, "utf8"), path);
+    }
+    catch {
+        // No file yet is the ordinary state, and a malformed one must not take down
+        // `adopt` — it degrades to the name defaults, which is what an
+        // unconfigured repository gets anyway.
+        return { version: 1, scopes: {} };
+    }
+}
+//# sourceMappingURL=adopt-type.js.map

package/dist/adopt-type.js.map

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

package/dist/bridge.d.ts

@@ -0,0 +1,156 @@
+/**
+ * `~/.config/pharos/bridge.json` — **what an issue becomes when somebody adopts
+ * it**, and the one file the CLI and the app both read (#861).
+ *
+ * ## Why it is a file rather than app state
+ *
+ * The same rule `pharos-convert` and `doctor` follow, and the one AGENTS.md
+ * keeps restating: if the app owns the mapping and the CLI guesses, then
+ * `pharos issue adopt` in a headless session files to a different work item type
+ * than the app does — and **the one that drifts is the one nobody is watching**.
+ * So the CLI owns the file, the CLI has verbs over it, and the app's settings
+ * page is a GUI over those verbs rather than a second implementation.
+ *
+ * ## Why it is keyed by scope on day one
+ *
+ * The UI only ever shows one organisation and project today. The key is there
+ * anyway because this is the single artefact multi-scope would otherwise force a
+ * rewrite of — see `docs/pharos-multi-scope-plan.md`. It costs one nesting level
+ * now and saves throwing the file away later.
+ *
+ * ## Why labels are keyed by ID
+ *
+ * **Probed on a live repository:** creating a label, renaming it and reading it
+ * back leaves `id` and `node_id` unchanged. So an id-keyed mapping survives a
+ * rename, which is the thing people actually do to labels.
+ *
+ * Two consequences worth stating rather than discovering:
+ *
+ * - **Ids are per repository.** `bug` is `11710323621` on one repo and
+ *   `1593484620` on another. A mapping is therefore per repo by construction,
+ *   not a global preference.
+ * - **Delete-and-recreate yields a NEW id**, so a mapping whose id no longer
+ *   resolves goes visibly *broken* rather than silently re-binding to a
+ *   different label that happens to share a name. That is the correct
+ *   behaviour: the old label is gone, and what replaced it is somebody else's
+ *   decision to confirm.
+ *
+ * `name` is stored beside the id for display and for diagnosis. It is never what
+ * a lookup matches on.
+ */
+export interface BridgeConfig {
+    version: 1;
+    scopes: Record<string, ScopeConfig>;
+}
+export interface ScopeConfig {
+    repos: Record<string, RepoBridgeConfig>;
+    digest: DigestPolicy;
+}
+export interface RepoBridgeConfig {
+    /** Label **id** (as a string key) → what adopting an issue with it produces. */
+    labels: Record<string, LabelMapping>;
+    /** Where an issue with no mapped label goes. */
+    defaultCategory: string;
+}
+export interface LabelMapping {
+    /** Display only, and deliberately not what anything matches on. */
+    name: string;
+    /** An Azure DevOps work item type CATEGORY, never a type name. */
+    category: string;
+}
+/**
+ * When a digest is written back to the work item.
+ *
+ * **Two events, not every comment.** Adopt and close are decisions; a comment is
+ * chatter. Mirroring chatter puts noise on a client's board and re-opens the
+ * echo problem the hub already paid for — while never writing turns the work
+ * item into a dead link, which is worse. See the wave spec.
+ */
+export interface DigestPolicy {
+    onAdopt: boolean;
+    onClose: boolean;
+}
+export declare const DEFAULT_DIGEST: DigestPolicy;
+/** Azure DevOps' category reference names, as used here. */
+export declare const CATEGORY: {
+    readonly bug: "Microsoft.BugCategory";
+    readonly requirement: "Microsoft.RequirementCategory";
+    readonly feature: "Microsoft.FeatureCategory";
+    readonly epic: "Microsoft.EpicCategory";
+    readonly task: "Microsoft.TaskCategory";
+};
+/**
+ * What a repository nobody has configured does.
+ *
+ * **Matched by NAME, and that is the one place a name is allowed to matter.** A
+ * repo you have never opened the settings for should still adopt sensibly, and
+ * the only thing available before somebody maps anything is what the labels are
+ * called. The moment a mapping is saved it pins to the id and renames stop
+ * mattering — *id for bindings you made, name for defaults you did not*.
+ *
+ * Ordered, because the lookups degrade: a feature request wants
+ * `FeatureCategory` and settles for `RequirementCategory`, which is all Basic
+ * has.
+ */
+export declare const NAME_DEFAULTS: readonly {
+    readonly match: readonly string[];
+    readonly categories: readonly string[];
+}[];
+/** Where the file lives. `PHAROS_BRIDGE_FILE` overrides it, for tests. */
+export declare function defaultBridgePath(env?: NodeJS.ProcessEnv): string;
+/** `org/project`, lowercased — the scope key. */
+export declare function scopeKey(org: string, project: string): string;
+export declare function emptyBridgeConfig(): BridgeConfig;
+/**
+ * Read a config, or refuse with a message naming the file.
+ *
+ * **A file it cannot parse is an answer, not a crash** — the same rule
+ * `doctor`'s repos.json handling follows. A malformed mapping means adoption
+ * falls back to the name defaults and says so, rather than taking the CLI down
+ * on an unrelated verb.
+ */
+export declare function parseBridgeConfig(text: string, source?: string): BridgeConfig;
+export declare function formatBridgeConfig(config: BridgeConfig): string;
+/** This repository's mapping in this scope, or the empty one. */
+export declare function repoConfig(config: BridgeConfig, org: string, project: string, repo: string): RepoBridgeConfig;
+export declare function digestPolicy(config: BridgeConfig, org: string, project: string): DigestPolicy;
+/** One label as GitHub reports it. */
+export interface IssueLabel {
+    id: number;
+    name: string;
+}
+/** How a category was arrived at — reported, because a silent default misleads. */
+export type CategorySource = "mapping" | "name-default" | "repo-default";
+export interface CategoryChoice {
+    /** Ordered: try each in turn, because a project may not have the first. */
+    categories: readonly string[];
+    source: CategorySource;
+    /** Which label decided it, when one did. */
+    label?: string;
+}
+/**
+ * Which category an issue's labels ask for.
+ *
+ * **Saved mappings win, by id.** Then the name defaults, for a repository nobody
+ * has configured. Then the repository's own default.
+ *
+ * The `source` comes back with it on purpose: "this went to a requirement
+ * because you mapped `bug`" and "this went to a requirement because nothing
+ * matched" are different facts, and a picker that showed the same preselection
+ * for both would be hiding the second one.
+ */
+export declare function categoryFor(labels: readonly IssueLabel[], repo: RepoBridgeConfig): CategoryChoice;
+/**
+ * A saved mapping whose label no longer exists in the repository.
+ *
+ * Reported rather than pruned. The mapping is a decision somebody made, and a
+ * label that has gone is usually a rename they did not realise breaks it — or a
+ * delete-and-recreate, which is a genuinely different label. Either way the
+ * answer is to show it, not to guess.
+ */
+export declare function brokenMappings(repo: RepoBridgeConfig, live: readonly IssueLabel[]): {
+    id: string;
+    name: string;
+    category: string;
+}[];
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,YAA+C,CAAC;AAE7E,4DAA4D;AAC5D,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAMjH,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAK9E;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAgB,GAAG,YAAY,CA+CpF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CACxB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,gBAAgB,CAQlB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAE7F;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,IAAI,EAAE,gBAAgB,GACrB,cAAc,CAiBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,SAAS,UAAU,EAAE,GAC1B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,CAKlD"}

package/dist/bridge.js

@@ -0,0 +1,157 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const DEFAULT_DIGEST = { onAdopt: true, onClose: true };
+/** Azure DevOps' category reference names, as used here. */
+export const CATEGORY = {
+    bug: "Microsoft.BugCategory",
+    requirement: "Microsoft.RequirementCategory",
+    feature: "Microsoft.FeatureCategory",
+    epic: "Microsoft.EpicCategory",
+    task: "Microsoft.TaskCategory",
+};
+/**
+ * What a repository nobody has configured does.
+ *
+ * **Matched by NAME, and that is the one place a name is allowed to matter.** A
+ * repo you have never opened the settings for should still adopt sensibly, and
+ * the only thing available before somebody maps anything is what the labels are
+ * called. The moment a mapping is saved it pins to the id and renames stop
+ * mattering — *id for bindings you made, name for defaults you did not*.
+ *
+ * Ordered, because the lookups degrade: a feature request wants
+ * `FeatureCategory` and settles for `RequirementCategory`, which is all Basic
+ * has.
+ */
+export const NAME_DEFAULTS = [
+    { match: ["bug", "defect", "regression"], categories: [CATEGORY.bug] },
+    {
+        match: ["enhancement", "feature", "feature request"],
+        categories: [CATEGORY.feature, CATEGORY.requirement],
+    },
+];
+/** Where the file lives. `PHAROS_BRIDGE_FILE` overrides it, for tests. */
+export function defaultBridgePath(env = process.env) {
+    const override = env.PHAROS_BRIDGE_FILE;
+    if (override !== undefined && override !== "")
+        return override;
+    const base = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(base, "pharos", "bridge.json");
+}
+/** `org/project`, lowercased — the scope key. */
+export function scopeKey(org, project) {
+    return `${org.trim().toLowerCase()}/${project.trim().toLowerCase()}`;
+}
+export function emptyBridgeConfig() {
+    return { version: 1, scopes: {} };
+}
+/**
+ * Read a config, or refuse with a message naming the file.
+ *
+ * **A file it cannot parse is an answer, not a crash** — the same rule
+ * `doctor`'s repos.json handling follows. A malformed mapping means adoption
+ * falls back to the name defaults and says so, rather than taking the CLI down
+ * on an unrelated verb.
+ */
+export function parseBridgeConfig(text, source = "bridge.json") {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`${source} is not valid JSON: ${error.message}`);
+    }
+    if (typeof raw !== "object" || raw === null)
+        throw new Error(`${source} is not an object.`);
+    const record = raw;
+    if (record.version !== 1) {
+        throw new Error(`${source} has version ${String(record.version)}; this build understands 1.`);
+    }
+    const scopes = {};
+    const rawScopes = (record.scopes ?? {});
+    for (const [key, value] of Object.entries(rawScopes)) {
+        const scope = (value ?? {});
+        const repos = {};
+        for (const [repo, rawRepo] of Object.entries((scope.repos ?? {}))) {
+            const entry = (rawRepo ?? {});
+            const labels = {};
+            for (const [id, rawLabel] of Object.entries((entry.labels ?? {}))) {
+                const label = (rawLabel ?? {});
+                if (typeof label.category !== "string")
+                    continue;
+                labels[id] = {
+                    name: typeof label.name === "string" ? label.name : "",
+                    category: label.category,
+                };
+            }
+            repos[repo.toLowerCase()] = {
+                labels,
+                defaultCategory: typeof entry.defaultCategory === "string" ? entry.defaultCategory : CATEGORY.requirement,
+            };
+        }
+        const digest = (scope.digest ?? {});
+        scopes[key.toLowerCase()] = {
+            repos,
+            digest: {
+                onAdopt: digest.onAdopt !== false,
+                onClose: digest.onClose !== false,
+            },
+        };
+    }
+    return { version: 1, scopes };
+}
+export function formatBridgeConfig(config) {
+    return `${JSON.stringify(config, null, 2)}\n`;
+}
+/** This repository's mapping in this scope, or the empty one. */
+export function repoConfig(config, org, project, repo) {
+    const scope = config.scopes[scopeKey(org, project)];
+    return (scope?.repos[repo.trim().toLowerCase()] ?? {
+        labels: {},
+        defaultCategory: CATEGORY.requirement,
+    });
+}
+export function digestPolicy(config, org, project) {
+    return config.scopes[scopeKey(org, project)]?.digest ?? DEFAULT_DIGEST;
+}
+/**
+ * Which category an issue's labels ask for.
+ *
+ * **Saved mappings win, by id.** Then the name defaults, for a repository nobody
+ * has configured. Then the repository's own default.
+ *
+ * The `source` comes back with it on purpose: "this went to a requirement
+ * because you mapped `bug`" and "this went to a requirement because nothing
+ * matched" are different facts, and a picker that showed the same preselection
+ * for both would be hiding the second one.
+ */
+export function categoryFor(labels, repo) {
+    for (const label of labels) {
+        const mapped = repo.labels[String(label.id)];
+        if (mapped !== undefined) {
+            return { categories: [mapped.category], source: "mapping", label: label.name };
+        }
+    }
+    for (const label of labels) {
+        const lowered = label.name.trim().toLowerCase();
+        const rule = NAME_DEFAULTS.find((candidate) => candidate.match.includes(lowered));
+        if (rule !== undefined) {
+            return { categories: rule.categories, source: "name-default", label: label.name };
+        }
+    }
+    return { categories: [repo.defaultCategory], source: "repo-default" };
+}
+/**
+ * A saved mapping whose label no longer exists in the repository.
+ *
+ * Reported rather than pruned. The mapping is a decision somebody made, and a
+ * label that has gone is usually a rename they did not realise breaks it — or a
+ * delete-and-recreate, which is a genuinely different label. Either way the
+ * answer is to show it, not to guess.
+ */
+export function brokenMappings(repo, live) {
+    const known = new Set(live.map((label) => String(label.id)));
+    return Object.entries(repo.labels)
+        .filter(([id]) => !known.has(id))
+        .map(([id, mapping]) => ({ id, name: mapping.name, category: mapping.category }));
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA+EjC,MAAM,CAAC,MAAM,cAAc,GAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAE7E,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,uBAAuB;IAC5B,WAAW,EAAE,+BAA+B;IAC5C,OAAO,EAAE,2BAA2B;IACpC,IAAI,EAAE,wBAAwB;IAC9B,IAAI,EAAE,wBAAwB;CACtB,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAA6F;IACrH,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;IACtE;QACE,KAAK,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,iBAAiB,CAAC;QACpD,UAAU,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC;KACrD;CACF,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,MAAM,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/D,MAAM,IAAI,GAAG,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,OAAe;IACnD,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAM,GAAG,aAAa;IACpE,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,uBAAwB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,oBAAoB,CAAC,CAAC;IAE5F,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,gBAAgB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;IACnE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;QACvD,MAAM,KAAK,GAAqC,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC,EAAE,CAAC;YAC7F,MAAM,KAAK,GAAG,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;YACzD,MAAM,MAAM,GAAiC,EAAE,CAAC;YAChD,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC,EAAE,CAAC;gBAC7F,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,EAAE,CAA4B,CAAC;gBAC1D,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;oBAAE,SAAS;gBACjD,MAAM,CAAC,EAAE,CAAC,GAAG;oBACX,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;oBACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG;gBAC1B,MAAM;gBACN,eAAe,EACb,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;aAC3F,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAA4B,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG;YAC1B,KAAK;YACL,MAAM,EAAE;gBACN,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK;gBACjC,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK;aAClC;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU,CACxB,MAAoB,EACpB,GAAW,EACX,OAAe,EACf,IAAY;IAEZ,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,CACL,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI;QACzC,MAAM,EAAE,EAAE;QACV,eAAe,EAAE,QAAQ,CAAC,WAAW;KACtC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE,GAAW,EAAE,OAAe;IAC7E,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,cAAc,CAAC;AACzE,CAAC;AAmBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,MAA6B,EAC7B,IAAsB;IAEtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACjF,CAAC;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAClF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACpF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAsB,EACtB,IAA2B;IAE3B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/cli.d.ts

@@ -12,7 +12,7 @@ import { type ExitCode } from "./output.js";
  * expensive kind of wrong. Anything added to the switch belongs here, and the
  * test below fails if it does not.
  */
-export declare const COMMANDS: readonly ["setup", "whoami", "query", "task", "types", "history", "iterations", "areas", "links", "fields", "create", "update", "link", "unlink", "delete", "restore", "deleted", "attach", "detach", "download", "image", "people", "wiki", "comment", "hooks", "plan", "doctor", "issue"];
+export declare const COMMANDS: readonly ["setup", "whoami", "query", "task", "types", "history", "iterations", "areas", "links", "fields", "create", "update", "link", "unlink", "delete", "restore", "deleted", "attach", "detach", "download", "image", "people", "wiki", "comment", "hooks", "plan", "doctor", "issue", "bridge"];
 export interface RunOptions {
     argv: string[];
     cwd: string;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AA8B5D,OAAO,EAKL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAyBrB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,6RAMX,CAAC;AA0cX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAChD,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOhE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AA+B5D,OAAO,EAKL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAyBrB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,uSAMX,CAAC;AA8gBX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAChD,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOhE"}