@angelmsger/fx 0.10.1 → 0.11.0

package/dist/domain/workspace/commits.js

@@ -1,4 +1,7 @@
 // What a code host says about a repository's history, in the host-neutral
 // shape the release check reasons about.
-export {};
+// How a person names a commit: its first seven hexadecimal digits.
+export function shortSha(sha) {
+    return sha.slice(0, 7);
+}
 //# sourceMappingURL=commits.js.map

package/dist/domain/workspace/commits.js.map

@@ -1 +1 @@
-{"version":3,"file":"commits.js","sourceRoot":"","sources":["../../../src/domain/workspace/commits.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yCAAyC"}
+{"version":3,"file":"commits.js","sourceRoot":"","sources":["../../../src/domain/workspace/commits.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yCAAyC;AAuBzC,mEAAmE;AACnE,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzB,CAAC"}

package/dist/domain/workspace/go-work.js

@@ -0,0 +1,75 @@
+// The Go workspace file fx keeps at the root when the manifest asks for one: every
+// Go module checked out there, at the newest `go` version any of them requires, so
+// each module builds against its siblings' checkouts. The file announces itself on
+// its first line, so fx can tell its own go.work from a person's and never replace
+// the latter.
+export const GO_WORK = 'go.work';
+export const GO_WORK_SUM = 'go.work.sum';
+const PREFIX = '// fx:derived ';
+export const isDerivedGoWork = (text) => text.startsWith(PREFIX);
+export function goDirective(goMod) {
+    return /^[ \t]*go[ \t]+([^\s/]+)/m.exec(goMod)?.[1];
+}
+// Null when no module is checked out: an empty go.work would only break builds.
+export function renderGoWork(modules) {
+    if (modules.length === 0)
+        return null;
+    const go = modules.reduce((newest, module) => newer(newest, module.go), undefined);
+    const uses = modules.map((module) => `./${module.path}`).sort();
+    return [
+        `${PREFIX}from the checked-out Go modules; regenerated by fx sync, do not edit`,
+        ...(go === undefined ? [] : ['', `go ${go}`]),
+        '',
+        'use (',
+        ...uses.map((use) => `\t${goToken(use)}`),
+        ')',
+        '',
+    ].join('\n');
+}
+// Go reads a token that would split, start a comment or hold an unprintable
+// character only as a quoted string literal, and a JSON string is one.
+function goToken(text) {
+    const bare = !/["'`()[\]{},]|\/\/|\/\*|[^\p{L}\p{M}\p{N}\p{P}\p{S}]/u.test(text);
+    return bare ? text : JSON.stringify(text);
+}
+function newer(a, b) {
+    if (a === undefined)
+        return b;
+    if (b === undefined)
+        return a;
+    return compareGoVersions(a, b) < 0 ? b : a;
+}
+// Go's own order: the language version `1.21` sorts before its release candidate
+// `1.21rc1`, which sorts before the release `1.21.0`. Before 1.21 a missing patch
+// means `.0`. A malformed version sorts before every valid one.
+function compareGoVersions(a, b) {
+    const [x, y] = [parseGoVersion(a), parseGoVersion(b)];
+    for (const field of ['major', 'minor', 'patch']) {
+        const order = compareNumbers(x[field], y[field]);
+        if (order !== 0)
+            return order;
+    }
+    if (x.kind !== y.kind)
+        return x.kind < y.kind ? -1 : 1;
+    return compareNumbers(x.pre, y.pre);
+}
+function parseGoVersion(text) {
+    const number = '(0|[1-9]\\d*)';
+    const match = new RegExp(`^${number}(?:\\.${number}(?:\\.${number}|([a-z]+)${number}?)?)?$`).exec(text);
+    if (match === null)
+        return { major: '', minor: '', patch: '', kind: '', pre: '' };
+    const [, major = '', minor, patch, kind = '', pre = ''] = match;
+    if (minor === undefined)
+        return { major, minor: '0', patch: '0', kind, pre };
+    const defaultPatch = kind === '' && compareNumbers(minor, '21') < 0 ? '0' : '';
+    return { major, minor, patch: patch ?? defaultPatch, kind, pre };
+}
+// Decimal strings without leading zeros; the empty string sorts first.
+function compareNumbers(a, b) {
+    if (a.length !== b.length)
+        return a.length < b.length ? -1 : 1;
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=go-work.js.map

package/dist/domain/workspace/go-work.js.map

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

package/dist/domain/workspace/ref.js

@@ -28,6 +28,9 @@ export function repoUrl(host, owner, name) {
     return `${host.replace(/\/+$/, '')}/${owner}/${name}.git`;
 }
 function fileLocation(url) {
+    // A Windows path, as a local remote often is there, separates with either slash.
+    if (/^(?:[a-z]:[\\/]|\\\\)/i.test(url))
+        return url.replaceAll('\\', '/');
     if (!/^file:\/\//i.test(url))
         return url;
     try {

package/dist/domain/workspace/ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/domain/workspace/ref.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,iFAAiF;AACjF,8EAA8E;AAS9E,MAAM,UAAU,OAAO,CACrB,IAAyD;IAEzD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAA4C;IAC9D,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAC7F,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,QAAQ,GAAG,QAAQ;SACtB,OAAO,CAAC,2BAA2B,EAAE,KAAK,CAAC;SAC3C,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,KAAK,CAAC,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY;IAC/D,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QACnD,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"ref.js","sourceRoot":"","sources":["../../../src/domain/workspace/ref.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,iFAAiF;AACjF,8EAA8E;AAS9E,MAAM,UAAU,OAAO,CACrB,IAAyD;IAEzD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAA4C;IAC9D,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AAC7F,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,QAAQ,GAAG,QAAQ;SACtB,OAAO,CAAC,2BAA2B,EAAE,KAAK,CAAC;SAC3C,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,KAAK,CAAC,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY;IAC/D,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,iFAAiF;IACjF,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QACnD,OAAO,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angelmsger/fx",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Manifest-driven multi-repository workspaces for people and coding agents",
   "license": "Apache-2.0",
   "type": "module",
@@ -113,6 +113,9 @@
       },
       "workspace": {
         "description": "Workspace identities: discover, inspect, relocate, rebind and unregister"
+      },
+      "release": {
+        "description": "Release checklist: what each repository would release, and whether it is ready"
       }
     }
   },

package/skills/fx-workspace/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fx-workspace
-version: 0.10.1
+version: 0.11.0
 description: 'Use only when the user explicitly asks for the fx workspace CLI or manifest, or the current task is inside an fx-managed workspace or routed by its fx-derived AGENTS.md. Drive workspace init and sync, repository status and selection, manifest validation and editing, companion tools and login, doctor, agent Skills, repository ownership, environment coordinates and readiness through can/where, and release checks across dependencies, branches, builds and errors. Do not use for generic Sentry, OpenObserve, Jenkins, Kubernetes, logs, errors or builds outside an fx-managed workspace.'
 metadata:
   requires:

package/skills/fx-workspace/references/commands.md

@@ -1,34 +1,18 @@
 # Command reference
 
-The generated repository reference is `docs/cli/README.md`; installed commands
-expose the same flags through `fx <command> --help`. The table lists common flags;
-`--dry-run` belongs to write commands. `--details` is a global view option;
-fact queries already return full results.
-
-| Flag                           | Meaning                                                            |
-| ------------------------------ | ------------------------------------------------------------------ |
-| `--format json\|ndjson\|human` | output format; agents use `json`                                   |
-| `--details`                    | full workflow reports; fact queries are already complete           |
-| `--fields a,b.c`               | keep only these dot paths                                          |
-| `--workspace <name-or-root>`   | a registered name or root instead of the workspace containing cwd  |
-| `--no-input`                   | never prompt; a needed answer becomes a structured error           |
-| `--yes`                        | confirm prompts, including trust-on-first-use of manifest commands |
-| `--dry-run`                    | on write commands: print the plan, change nothing                  |
-| `--allow-writes`               | override read-only posture once                                    |
-| `--quiet`                      | drop notices and progress (errors stay)                            |
-
-Every `--help` ends with an `AGENT USAGE` block that restates the output
-and error contract.
-
-Use a registered name or root directory with `--workspace`; an unknown value
-never selects a different default. When a host truncates a large response, use
+`fx <command> --help` describes every flag the running executable accepts,
+including the global ones, and ends with an `AGENT USAGE` block that restates
+the output and error contract. This guide covers what the help cannot: how to
+read the results.
+
+An unknown `--workspace` value never selects a different default. When a host truncates a large response, use
 `--fields` on a read-only query to retrieve the required facts. If you capture full
 output, keep it within the task's authorized directory: shell redirection writes a
 file even when the fx command is read-only.
 
 ## Workflow report views
 
-The four workflow reports (`init`, `sync`, `doctor`, `release`) default to compact
+The four workflow reports (`init`, `sync`, `doctor`, `release check`) default to compact
 JSON. `output_mode: summary` and `omitted` describe the view; omitted counts are
 not pagination. All warning/failure rows and exact pending command vectors remain.
 `--details` returns the full application result; explicit `--fields` projects it.
@@ -173,9 +157,10 @@ same ambiguous setup. Doctor marks its missing verification as incomplete.
 `fx doctor` returns `preparation`, diagnostic `coverage` (`complete` or `incomplete`),
 `summary {ok, warn, fail}` and `findings[]`. The preparation verdict owns task completion;
 optional host activation can remain unverified. An incomplete verdict exits 12.
-`fx release` retains `ok`, `complete`, summary and findings and exits zero when its
+`fx release check` retains `ok`, `complete`, summary and findings and exits zero when its
 checklist was produced. Findings carry group, id, level, coverage, message, fix and
-handoff; full results also carry evidence. For `can`, inspect its capability status.
+handoff; full results also carry evidence. `repos[]` says what each release would ship,
+in summaries too. For `can`, inspect its capability status.
 
 Doctor groups are `repos`, `root`, `tools`, `login`, `agents`, `manifest`, `self`,
 `hooks`, `mcp` and `rules`. `root` lists entries at the workspace root that nothing
@@ -190,19 +175,36 @@ repair rows; use `--details` to inspect all attempts. Each attempt is
 structured recovery errors before post-repair findings are collected.
 `completed` means the repair ran, not that the subsequent check passed.
 
-`fx release [<repo>...] [--tag] [--only deps,merge,ci,errors] [--env] [--since]
-[--jobs]` covers repositories selected by manifest release policy. Its evidence
-is grouped by check:
+`fx release check [<repo>...] [--tag] [--only deps,merge,ci,errors] [--env] [--since]
+[--jobs]` covers repositories selected by manifest release policy; `fx release` is its
+compatibility name. It is read-only: it never merges, tags, publishes or deploys.
+
+Each `repos[]` entry is `{name, source, target, version_file, unmerged, note,
+unanswered}`. `source`
+and `target` are the branch heads `{branch, sha, date, message, version}`; `version` is
+what the repository's dependency file declares at that commit, null when it declares
+none. `target` is null for a repository releasing from one branch, and both are null
+when the code host was not asked or did not answer, which the findings explain.
+`unmerged` is `{commits, authors}`: how many people's commits the source has that the
+target lacks, and how many people wrote them; null when not compared. To read those
+commits, ask the code host's own CLI for the range from `target.sha` to `source.sha`;
+`fx repo show <repo>` gives where the repository lives on the host. `unanswered[]` lists
+each question to the code host that failed as `{field, reason}`, where `field` is the
+value left null (`version_file`, `source.commit`, `source.version`, `target.commit`,
+`target.version`, `unmerged`); a null without an entry means the repository declares
+none.
+
+Evidence is grouped by check:
 
 | Group    | Evidence                                                                                                                                  |
 | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
 | `merge`  | `source`, `target`, `ahead[]`, `behind[]`, `filtered`, `unknown[]` directions; commits have `sha`, `author {id, name}`, `date`, `message` |
 | `deps`   | `file`, `offending[] {name, version, section, runtime}`                                                                                   |
-| `ci`     | `builds[] {side, env, branch, path, number, status, started_at, url, current}`; null `path` means no declared job                         |
+| `ci`     | `builds[] {side, env, branch, path, number, status, started_at, url, head, current}`; null `path` means no declared job                   |
 | `errors` | `env`, `slug`, `since`, `capped`, `undated`, `issues[] {short_id, title, level, first_seen, last_seen, count, url}`                       |
 
-CI `current` compares build start time with branch-head time. This adapter result
-has no built-commit field, so it is a freshness heuristic, not revision verification.
+CI `current` compares build start time with the time of the branch head `head`. The CI
+result has no built-commit field, so it is a freshness heuristic, not revision verification.
 Use the companion's SCM/build details when the task requires an exact commit match.
 The full report's merge/dependency/issue evidence is available with `--details`.
 

package/skills/fx-workspace/references/workspace-tasks.md

@@ -23,7 +23,7 @@ covered by the [Skill reference](commands.md#standalone-companion-skill).
 
 ## Read a result before continuing
 
-- `init`, `sync`, `doctor`, `release` default to JSON summaries. `omitted` counts
+- `init`, `sync`, `doctor`, `release check` default to JSON summaries. `omitted` counts
   normal rows/evidence; exceptions and recovery remain. Start with the summary;
   use `--fields` for needed evidence or `--details` when all rows are necessary.
   Explicit `--fields` projects the full result in any format: JSON/NDJSON emit one
@@ -34,8 +34,9 @@ covered by the [Skill reference](commands.md#standalone-companion-skill).
   retains all blockers and exits 12. Follow `preparation.next`; `next_actions` are Agent work, while `resume` waits
   for changed prerequisites.
   Optional activation stays separate. Doctor's `coverage` describes diagnostics.
-- For `release`, inspect `ok`, coverage `complete` and warning/failure findings.
-  It can exit zero with failures and does not publish anything.
+- For `release check`, inspect `ok`, coverage `complete`, warning/failure findings and
+  `repos[]`, what each repository would ship. It can exit zero with failures and does
+  not publish anything.
 - For `login`, retain `summary`, `problems` and step recovery fields. `handoff`
   needs input; `blocked` has an unfinished prerequisite; `not_started` was not attempted.
 - Read partial stdout after a nonzero exit. It preserves completed effects and
@@ -120,7 +121,7 @@ stand in for `fx`; `self update` cannot repair an entry that cannot execute.
 | Inspect one repository and owners          | `fx repo show <repo>`; `fx member show <name>`                                           |
 | Find service diagnostics                   | `fx where <repo> --env <env>`                                                            |
 | Check tools/access                         | `fx can <capability-or-tool>`; `fx doctor --tool <tool>`                                 |
-| Inspect repository release criteria        | `fx release <repo> --only merge --details`                                               |
+| Inspect repository release criteria        | `fx release check <repo> --only merge --details`                                         |
 | Install/update a companion                 | `fx tool install <tool> --dry-run`; `fx tool update <tool> --dry-run`                    |
 | Review tool provenance                     | `fx tool history [tool]`; `fx tool inventory`                                            |
 | Inspect host resources                     | `fx agent skills`; `fx hook list`; `fx mcp list/show`                                    |
@@ -149,7 +150,7 @@ includes untracked files; `dirty` itself keeps its tracked-change meaning and
 Use `--format json` for results and `--help` for exact arguments. The table's
 `pick/unpick` notation means separate commands. Bare topics show their commands;
 help and completion prefer canonical names while preserving compatibility aliases.
-`release` evaluates a checklist; it does not publish packages or deploy services.
+`release check` evaluates a checklist; it does not publish packages or deploy services.
 
 ## What sync will and will not do
 

package/dist/cli/commands/release.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../src/cli/commands/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAc,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAS;IACnD,MAAM,CAAU,WAAW,GACzB,iGAAiG,CAAC;IACpG,MAAM,CAAU,QAAQ,GAAG;QACzB,yCAAyC;QACzC,wGAAwG;KACzG,CAAC;IACF,MAAM,CAAU,MAAM,GAAG,KAAK,CAAC;IAC/B,MAAM,CAAU,IAAI,GAAG;QACrB,IAAI,EAAE,QAAQ,CAAC,yDAAyD,CAAC;KAC1E,CAAC;IACF,MAAM,CAAU,KAAK,GAAG;QACtB,GAAG,EAAE,QAAQ,CAAC,uCAAuC,CAAC;QACtD,IAAI,EAAE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;QAC3C,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC;QAC1F,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;QAC/F,IAAI,EAAE,QAAQ;KACf,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC;YACrF,KAAK,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAiB;YACzD,IAAI,EAAE,KAAK,CAAC,GAAG;YACf,IAAI,EAAE,KAAK,CAAC,IAA2B;YACvC,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,4DAA4D;QAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,SAAS;YACpE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,WAAW,CAAC,MAAM,EAAE;gBAClB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG;gBAClC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,KAAK,IAAI;aAC7C,CAAC,CACH,CAAC;;YACC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,iCAAiC,CAAC,CAAC,CAAC,CAAC;IACjG,CAAC"}