@orchestrator-claude/definitions 3.32.1 → 3.33.0

package/dist/http/ApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../../src/http/ApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,EAAE,gBAAgB;IAKrC;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IASjG;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC;QACtC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjE,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChE,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpE,EAAE,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9D,CAAC;YAIY,OAAO;CAqBtB"}
+{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../../src/http/ApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,EAAE,gBAAgB;IAKrC;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3D;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IASjG;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC;QACtC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjE,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChE,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnE,EAAE,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9D,CAAC;YAIY,OAAO;CAqBtB"}

package/dist/http/ApiClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiClient.js","sourceRoot":"","sources":["../../src/http/ApiClient.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,SAAS;IACH,OAAO,CAAS;IACzB,KAAK,CAAgB;IAE7B,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,QAAgB;QACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,oBAAoB,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAoB,EAAE,IAA0C;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,OAAO,QAAsB,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB;QAO1B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAQ,CAAC;IACtF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAiB;QACnD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACrD,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAI,IAAI,CAAC,OAA8C,EAAE;SACjF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"ApiClient.js","sourceRoot":"","sources":["../../src/http/ApiClient.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,SAAS;IACH,OAAO,CAAS;IACzB,KAAK,CAAgB;IAE7B,YAAY,OAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,QAAgB;QACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,oBAAoB,EAAE;YAChE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAoB,EAAE,IAA0C;QACzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE;YAC9D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,OAAO,QAAsB,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB;QAQ1B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAQ,CAAC;IACtF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAiB;QACnD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACrD,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAI,IAAI,CAAC,OAA8C,EAAE;SACjF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/install/DevCheckoutDetector.d.ts

@@ -0,0 +1,66 @@
+/**
+ * DevCheckoutDetector — read-only dual-condition heuristic (RF-002 / spec
+ * §5.1, ADR-004) for the "inverted precedence" risk between `.claude/agents`
+ * (project-scope) and `.claude/skills` (user-scope, per Claude Code's
+ * documentation): once the installer lands, `~/.claude/agents` resolves from
+ * the distributed package while `<repo>/.claude/agents` remains the authored
+ * source — they can diverge silently.
+ *
+ * Detection requires BOTH conditions (reduces false-positives, risk R-6):
+ *   (i)  walk-up from `cwd` to the nearest ancestor `package.json` whose
+ *        `name` matches the orchestrator monorepo root package
+ *        (`@orchestrator-cli/core` — confirmed via direct Read of
+ *        `/home/cmac/workOrch-Claude/orchestrator/package.json`, plan
+ *        §11 Verify-Before-Assert);
+ *   (ii) that same ancestor's `.claude/agents/*.md` contains REAL files
+ *        (never symlinks — `lstatSync(...).isSymbolicLink()`, distinguishing
+ *        authored files from the C6/TD-204 INTERIM per-file symlinks) whose
+ *        slug (basename without `.md`) collides with `manifestSlugs`.
+ *
+ * Never mutates anything — `detect()` only reads `package.json` and lists
+ * `.claude/agents/`. This module is purely read-only by design.
+ *
+ * ---
+ * MEASURED WARNING TEXT (TASK-036/AC-007 gate — CLOSED, S385):
+ * `DEV_CHECKOUT_WARNING_REASON` previously named the precedence risk
+ * WITHOUT asserting a verified direction ("provisional" — Universal
+ * Invariant 6 forbids hard-coding an unverified claim about third-party CLI
+ * behavior). `scripts/probes/ac007-precedence-probe.ts` (TASK-035) has since
+ * run the AC-007 gate for real (TASK-036): isolated `CLAUDE_CONFIG_DIR` probe
+ * (S382 method), 3/3 deterministic runs per axis, real-`~/.claude`
+ * hard-isolation-gate verified unchanged. **Verdict: CONFIRMS the documented
+ * claim** — agents resolve by PROJECT-scope, skills resolve by USER-scope.
+ * The precedence direction is NOT inverted. The text below now states this
+ * as measured fact and names the real practical risk it implies: the two
+ * scopes can still silently DRIFT APART over time (a project-scope skill
+ * edit has no effect on a live session until `orch-defs install` refreshes
+ * `~/.claude/skills`, unless the file happens to be an INTERIM symlink —
+ * C6/TD-204), independent of the (now-settled) precedence-direction
+ * question. Raw probe output: `tests/install/fixtures/
+ * ac007-precedence-probe-output.md`.
+ */
+import type { DetectionResult } from './types.js';
+export declare class DevCheckoutDetector {
+    private readonly manifestSlugs;
+    constructor(manifestSlugs: string[]);
+    /**
+     * Read-only detection. Never throws on a missing `.claude/agents`
+     * directory or a missing/unparseable ancestor `package.json` — those
+     * cases simply resolve to `'clean-install'`.
+     */
+    detect(cwd: string): DetectionResult;
+    /**
+     * Walks up from `cwd` looking for the nearest ancestor directory whose
+     * `package.json` has `name === MONOREPO_PACKAGE_NAME` (§5.1: "presença de
+     * package.json na raiz do cwd, ou ancestral via walk-up").
+     */
+    private findAncestorWithMatchingPackageName;
+    private hasMatchingName;
+    /**
+     * Real (non-symlink) `.claude/agents/*.md` files at `root` whose slug
+     * (basename without `.md`) collides with `manifestSlugs`.
+     */
+    private findMatchingRealAgentSlugs;
+    private cleanInstall;
+}
+//# sourceMappingURL=DevCheckoutDetector.d.ts.map

package/dist/install/DevCheckoutDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevCheckoutDetector.d.ts","sourceRoot":"","sources":["../../src/install/DevCheckoutDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA4BlD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM,EAAE;IAEpD;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAkBpC;;;;OAIG;IACH,OAAO,CAAC,mCAAmC;IAiB3C,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IA4BlC,OAAO,CAAC,YAAY;CAOrB"}

package/dist/install/DevCheckoutDetector.js

@@ -0,0 +1,150 @@
+/**
+ * DevCheckoutDetector — read-only dual-condition heuristic (RF-002 / spec
+ * §5.1, ADR-004) for the "inverted precedence" risk between `.claude/agents`
+ * (project-scope) and `.claude/skills` (user-scope, per Claude Code's
+ * documentation): once the installer lands, `~/.claude/agents` resolves from
+ * the distributed package while `<repo>/.claude/agents` remains the authored
+ * source — they can diverge silently.
+ *
+ * Detection requires BOTH conditions (reduces false-positives, risk R-6):
+ *   (i)  walk-up from `cwd` to the nearest ancestor `package.json` whose
+ *        `name` matches the orchestrator monorepo root package
+ *        (`@orchestrator-cli/core` — confirmed via direct Read of
+ *        `/home/cmac/workOrch-Claude/orchestrator/package.json`, plan
+ *        §11 Verify-Before-Assert);
+ *   (ii) that same ancestor's `.claude/agents/*.md` contains REAL files
+ *        (never symlinks — `lstatSync(...).isSymbolicLink()`, distinguishing
+ *        authored files from the C6/TD-204 INTERIM per-file symlinks) whose
+ *        slug (basename without `.md`) collides with `manifestSlugs`.
+ *
+ * Never mutates anything — `detect()` only reads `package.json` and lists
+ * `.claude/agents/`. This module is purely read-only by design.
+ *
+ * ---
+ * MEASURED WARNING TEXT (TASK-036/AC-007 gate — CLOSED, S385):
+ * `DEV_CHECKOUT_WARNING_REASON` previously named the precedence risk
+ * WITHOUT asserting a verified direction ("provisional" — Universal
+ * Invariant 6 forbids hard-coding an unverified claim about third-party CLI
+ * behavior). `scripts/probes/ac007-precedence-probe.ts` (TASK-035) has since
+ * run the AC-007 gate for real (TASK-036): isolated `CLAUDE_CONFIG_DIR` probe
+ * (S382 method), 3/3 deterministic runs per axis, real-`~/.claude`
+ * hard-isolation-gate verified unchanged. **Verdict: CONFIRMS the documented
+ * claim** — agents resolve by PROJECT-scope, skills resolve by USER-scope.
+ * The precedence direction is NOT inverted. The text below now states this
+ * as measured fact and names the real practical risk it implies: the two
+ * scopes can still silently DRIFT APART over time (a project-scope skill
+ * edit has no effect on a live session until `orch-defs install` refreshes
+ * `~/.claude/skills`, unless the file happens to be an INTERIM symlink —
+ * C6/TD-204), independent of the (now-settled) precedence-direction
+ * question. Raw probe output: `tests/install/fixtures/
+ * ac007-precedence-probe-output.md`.
+ */
+import { existsSync, lstatSync, readFileSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/** Root package name of the orchestrator monorepo (Verify-Before-Assert, plan §11). */
+const MONOREPO_PACKAGE_NAME = '@orchestrator-cli/core';
+/**
+ * DEFINITIVE (measured — see module JSDoc / TASK-036 gate, S385). Names the
+ * precedence direction as a settled, empirically-confirmed fact and the
+ * real practical risk it implies (silent drift), not a hypothetical.
+ */
+const DEV_CHECKOUT_WARNING_REASON = 'Dev-checkout detectado: este cwd pertence ao monorepo orchestrator e ' +
+    '`.claude/agents/` contém arquivos reais cujos slugs colidem com o ' +
+    'manifest do pacote. Precedência MEDIDA empiricamente (AC-007/TASK-036, ' +
+    'gate S385, 3/3 runs determinísticos por eixo, probe isolado): agents ' +
+    'resolvem por PROJECT-scope (edições locais neste repo têm efeito ' +
+    'imediato numa sessão live) e skills resolvem por USER-scope ' +
+    '(`~/.claude/skills`) — editar um skill aqui NÃO afeta uma sessão live ' +
+    'até rodar `orch-defs install` novamente, a menos que o arquivo esteja ' +
+    'symlinkado (INTERIM/C6-TD-204). Isso CONFIRMA a direção documentada ' +
+    'pelo Claude Code (não é uma precedência invertida) — o risco real é a ' +
+    'divergência SILENCIOSA entre as duas cópias ao longo do tempo, não a ' +
+    'direção da precedência em si.';
+export class DevCheckoutDetector {
+    manifestSlugs;
+    constructor(manifestSlugs) {
+        this.manifestSlugs = manifestSlugs;
+    }
+    /**
+     * Read-only detection. Never throws on a missing `.claude/agents`
+     * directory or a missing/unparseable ancestor `package.json` — those
+     * cases simply resolve to `'clean-install'`.
+     */
+    detect(cwd) {
+        const monorepoRoot = this.findAncestorWithMatchingPackageName(cwd);
+        if (!monorepoRoot) {
+            return this.cleanInstall();
+        }
+        const matchedSlugs = this.findMatchingRealAgentSlugs(monorepoRoot);
+        if (matchedSlugs.length === 0) {
+            return this.cleanInstall();
+        }
+        return {
+            mode: 'dev-checkout',
+            matchedSlugs,
+            reason: DEV_CHECKOUT_WARNING_REASON,
+        };
+    }
+    /**
+     * Walks up from `cwd` looking for the nearest ancestor directory whose
+     * `package.json` has `name === MONOREPO_PACKAGE_NAME` (§5.1: "presença de
+     * package.json na raiz do cwd, ou ancestral via walk-up").
+     */
+    findAncestorWithMatchingPackageName(cwd) {
+        let current = resolve(cwd);
+        while (true) {
+            const packageJsonPath = join(current, 'package.json');
+            if (existsSync(packageJsonPath) && this.hasMatchingName(packageJsonPath)) {
+                return current;
+            }
+            const parent = dirname(current);
+            if (parent === current) {
+                return null;
+            }
+            current = parent;
+        }
+    }
+    hasMatchingName(packageJsonPath) {
+        try {
+            const parsed = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            return parsed.name === MONOREPO_PACKAGE_NAME;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Real (non-symlink) `.claude/agents/*.md` files at `root` whose slug
+     * (basename without `.md`) collides with `manifestSlugs`.
+     */
+    findMatchingRealAgentSlugs(root) {
+        const agentsDir = join(root, '.claude', 'agents');
+        if (!existsSync(agentsDir)) {
+            return [];
+        }
+        const manifestSlugSet = new Set(this.manifestSlugs);
+        const matched = [];
+        for (const name of readdirSync(agentsDir)) {
+            if (!name.endsWith('.md')) {
+                continue;
+            }
+            const filePath = join(agentsDir, name);
+            if (lstatSync(filePath).isSymbolicLink()) {
+                continue;
+            }
+            const slug = name.slice(0, -'.md'.length);
+            if (manifestSlugSet.has(slug)) {
+                matched.push(slug);
+            }
+        }
+        return matched;
+    }
+    cleanInstall() {
+        return {
+            mode: 'clean-install',
+            matchedSlugs: [],
+            reason: 'Nenhuma condição de dev-checkout detectada (package.json não corresponde ao monorepo, ou nenhum agent real com slug colidente).',
+        };
+    }
+}
+//# sourceMappingURL=DevCheckoutDetector.js.map

package/dist/install/DevCheckoutDetector.js.map

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

package/dist/install/HooksWirer.d.ts

@@ -0,0 +1,29 @@
+import type { HooksTemplate } from './types.js';
+type HooksBlock = HooksTemplate['hooks'];
+export declare class HooksWirer {
+    private readonly template;
+    private readonly targetSettingsPath;
+    constructor(template: HooksTemplate, targetSettingsPath: string);
+    wire(): {
+        merged: boolean;
+        hooksBlock: HooksBlock;
+    };
+    private readExistingSettings;
+    /**
+     * Turns every relative `command` path in the template (e.g.
+     * `hooks/session-start.mjs`) into a runnable shell command anchored at
+     * `targetRoot` (`dirname(targetSettingsPath)`).
+     *
+     * TASK-043 (RFC-040 installer, hook bundling): the template now references
+     * pre-bundled, self-contained ESM `.mjs` files (esbuild, build-time —
+     * `bundle-hooks.ts`), so the command is a plain `node <path>` — no `npx
+     * tsx` (and no node_modules resolution) required at all on the install
+     * target. This is the fix for the AC-008 probe's `MODULE_NOT_FOUND`
+     * finding: a fresh install target has no node_modules for `tsx` to resolve
+     * a raw `.ts` hook's non-builtin imports against.
+     */
+    private resolveTemplateHooks;
+    private writeSettings;
+}
+export {};
+//# sourceMappingURL=HooksWirer.d.ts.map

package/dist/install/HooksWirer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HooksWirer.d.ts","sourceRoot":"","sources":["../../src/install/HooksWirer.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,KAAK,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AAOzC,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBADlB,QAAQ,EAAE,aAAa,EACvB,kBAAkB,EAAE,MAAM;IAG7C,IAAI,IAAI;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE;IAenD,OAAO,CAAC,oBAAoB;IAQ5B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,aAAa;CAItB"}

package/dist/install/HooksWirer.js

@@ -0,0 +1,80 @@
+/**
+ * HooksWirer - read-modify-write merge of the (pre-filtered, ADR-006) hooks
+ * template into a target `settings.json` (RF-005).
+ *
+ * Non-destructive at two levels (TASK-013):
+ *   1. Root of the JSON document — every non-`hooks` key already present
+ *      (`env`, `permissions`, ...) is preserved untouched.
+ *   2. Inside the `hooks` object — any event key NOT managed by this
+ *      template (e.g. a foreign plugin's event) is preserved untouched;
+ *      only the template's own event keys are (re)written, so re-running
+ *      `wire()` is idempotent for those keys (no duplication).
+ *
+ * `targetSettingsPath` is injected (ADR-004) — never resolved internally.
+ * `targetRoot` (the directory commands are prefixed with) is derived from
+ * `dirname(targetSettingsPath)`, since the template stores bare relative
+ * paths (e.g. `hooks/session-start.mjs`, a bundled artifact since TASK-043)
+ * that only become a runnable command once joined with the install target
+ * root.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export class HooksWirer {
+    template;
+    targetSettingsPath;
+    constructor(template, targetSettingsPath) {
+        this.template = template;
+        this.targetSettingsPath = targetSettingsPath;
+    }
+    wire() {
+        const existingSettings = this.readExistingSettings();
+        const resolvedTemplateHooks = this.resolveTemplateHooks();
+        const mergedHooks = {
+            ...(existingSettings.hooks ?? {}),
+            ...resolvedTemplateHooks,
+        };
+        const mergedSettings = { ...existingSettings, hooks: mergedHooks };
+        this.writeSettings(mergedSettings);
+        return { merged: true, hooksBlock: mergedHooks };
+    }
+    readExistingSettings() {
+        if (!existsSync(this.targetSettingsPath)) {
+            return {};
+        }
+        const raw = readFileSync(this.targetSettingsPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    /**
+     * Turns every relative `command` path in the template (e.g.
+     * `hooks/session-start.mjs`) into a runnable shell command anchored at
+     * `targetRoot` (`dirname(targetSettingsPath)`).
+     *
+     * TASK-043 (RFC-040 installer, hook bundling): the template now references
+     * pre-bundled, self-contained ESM `.mjs` files (esbuild, build-time —
+     * `bundle-hooks.ts`), so the command is a plain `node <path>` — no `npx
+     * tsx` (and no node_modules resolution) required at all on the install
+     * target. This is the fix for the AC-008 probe's `MODULE_NOT_FOUND`
+     * finding: a fresh install target has no node_modules for `tsx` to resolve
+     * a raw `.ts` hook's non-builtin imports against.
+     */
+    resolveTemplateHooks() {
+        const targetRoot = dirname(this.targetSettingsPath);
+        const resolved = {};
+        for (const [eventName, groups] of Object.entries(this.template.hooks)) {
+            resolved[eventName] = groups.map((group) => ({
+                matcher: group.matcher,
+                hooks: group.hooks.map((hook) => ({
+                    type: hook.type,
+                    command: `node ${join(targetRoot, hook.command)}`,
+                    timeout: hook.timeout,
+                })),
+            }));
+        }
+        return resolved;
+    }
+    writeSettings(settings) {
+        mkdirSync(dirname(this.targetSettingsPath), { recursive: true });
+        writeFileSync(this.targetSettingsPath, JSON.stringify(settings, null, 2));
+    }
+}
+//# sourceMappingURL=HooksWirer.js.map

package/dist/install/HooksWirer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HooksWirer.js","sourceRoot":"","sources":["../../src/install/HooksWirer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAU1C,MAAM,OAAO,UAAU;IAEF;IACA;IAFnB,YACmB,QAAuB,EACvB,kBAA0B;QAD1B,aAAQ,GAAR,QAAQ,CAAe;QACvB,uBAAkB,GAAlB,kBAAkB,CAAQ;IAC1C,CAAC;IAEJ,IAAI;QACF,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACrD,MAAM,qBAAqB,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE1D,MAAM,WAAW,GAAe;YAC9B,GAAG,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,GAAG,qBAAqB;SACzB,CAAC;QACF,MAAM,cAAc,GAAkB,EAAE,GAAG,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAElF,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAEnC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IACnD,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,oBAAoB;QAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAe,EAAE,CAAC;QAEhC,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,QAAQ,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC3C,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAChC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,QAAQ,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;oBACjD,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC,CAAC;aACJ,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,aAAa,CAAC,QAAuB;QAC3C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,aAAa,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/install/LocalDiffReporter.d.ts

@@ -0,0 +1,25 @@
+import type { ManifestLoader } from '../manifest/ManifestLoader.js';
+import type { DefinitionCategory } from '../manifest/types.js';
+export interface LocalDiffEntry {
+    slug: string;
+    category: DefinitionCategory;
+    file: string;
+    status: 'new' | 'updated' | 'unchanged';
+}
+export interface LocalDiffResult {
+    entries: LocalDiffEntry[];
+    hasChanges: boolean;
+}
+export declare class LocalDiffReporter {
+    private readonly loader;
+    private readonly targetRoot;
+    constructor(loader: ManifestLoader, targetRoot: string);
+    /**
+     * Pure read comparison — never mutates `stagingDir` nor `targetRoot`.
+     * Iterates exclusively via `loader.getAllEntries()` (same R-7 discipline
+     * as `Materializer`), never `package.json.files`.
+     */
+    report(stagingDir: string): LocalDiffResult;
+    private statusFor;
+}
+//# sourceMappingURL=LocalDiffReporter.d.ts.map

package/dist/install/LocalDiffReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDiffReporter.d.ts","sourceRoot":"","sources":["../../src/install/LocalDiffReporter.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM;IAGrC;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAc3C,OAAO,CAAC,SAAS;CAYlB"}

package/dist/install/LocalDiffReporter.js

@@ -0,0 +1,50 @@
+/**
+ * LocalDiffReporter - compares staged content (the output of
+ * `Materializer.stage()`) against what is CURRENTLY installed at
+ * `targetRoot`, for the `--dry-run` operations plan (RF-008, AC-011).
+ *
+ * ADR-005: reaproveita apenas o *shape* de `DiffEntry` (`category`/`slug`/
+ * `status`) de `DiffCommand`, NUNCA a classe em si — `DiffCommand` compara o
+ * manifest local contra uma API HTTP remota (`ApiClient.getDefinitionsMetadata()`);
+ * este módulo compara dois DIRETÓRIOS LOCAIS (staging vs. `targetRoot`), uma
+ * fonte de dados fundamentalmente diferente. Nenhuma dependência de
+ * `ApiClient` é introduzida aqui — puro filesystem, funciona mesmo offline.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export class LocalDiffReporter {
+    loader;
+    targetRoot;
+    constructor(loader, targetRoot) {
+        this.loader = loader;
+        this.targetRoot = targetRoot;
+    }
+    /**
+     * Pure read comparison — never mutates `stagingDir` nor `targetRoot`.
+     * Iterates exclusively via `loader.getAllEntries()` (same R-7 discipline
+     * as `Materializer`), never `package.json.files`.
+     */
+    report(stagingDir) {
+        const entries = this.loader.getAllEntries().map((entry) => ({
+            slug: entry.slug,
+            category: entry.category,
+            file: entry.file,
+            status: this.statusFor(entry.file, stagingDir),
+        }));
+        return {
+            entries,
+            hasChanges: entries.some((entry) => entry.status !== 'unchanged'),
+        };
+    }
+    statusFor(relativeFile, stagingDir) {
+        const targetPath = join(this.targetRoot, relativeFile);
+        if (!existsSync(targetPath)) {
+            return 'new';
+        }
+        const stagedPath = join(stagingDir, relativeFile);
+        const stagedContent = existsSync(stagedPath) ? readFileSync(stagedPath, 'utf-8') : '';
+        const targetContent = readFileSync(targetPath, 'utf-8');
+        return targetContent === stagedContent ? 'unchanged' : 'updated';
+    }
+}
+//# sourceMappingURL=LocalDiffReporter.js.map

package/dist/install/LocalDiffReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDiffReporter.js","sourceRoot":"","sources":["../../src/install/LocalDiffReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAgBjC,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,MAAsB,EACtB,UAAkB;QADlB,WAAM,GAAN,MAAM,CAAgB;QACtB,eAAU,GAAV,UAAU,CAAQ;IAClC,CAAC;IAEJ;;;;OAIG;IACH,MAAM,CAAC,UAAkB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;SAC/C,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO;YACP,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC;SAClE,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,YAAoB,EAAE,UAAkB;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAExD,OAAO,aAAa,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;CACF"}

package/dist/install/Materializer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Materializer - stage→verify→swap atomic materialization of manifest
+ * entries into the target filesystem root (RF-001, ADR-001/ADR-003/ADR-004).
+ *
+ * Never mutates `targetRoot` directly: `stage()` writes to an isolated
+ * sibling staging directory (the `~/.claude.install-tmp-<pid>/` pattern);
+ * only `swap()` touches `targetRoot`, via an atomic rename per category
+ * (falling back to copy+remove across filesystem boundaries, ADR-003).
+ */
+import type { ManifestLoader } from '../manifest/ManifestLoader.js';
+import type { DefinitionCategory, DefinitionEntry } from '../manifest/types.js';
+export declare class Materializer {
+    private readonly loader;
+    private readonly targetRoot;
+    constructor(loader: ManifestLoader, targetRoot: string);
+    /**
+     * Stages every manifested definition entry into an isolated sibling
+     * directory (never `targetRoot`). Iterates exclusively via
+     * `loader.getAllEntries()` — never `package.json.files` (R-7 regression,
+     * spec finding 2.4.1: the dead `workflows` entry).
+     */
+    stage(): Promise<{
+        stagingDir: string;
+        entries: Array<DefinitionEntry & {
+            category: DefinitionCategory;
+        }>;
+    }>;
+    /**
+     * Recomputes the SHA-256 checksum of every staged file against the
+     * manifest. Pure read-only comparison — never mutates `targetRoot`, so
+     * aborting after a failed `verify()` is always safe.
+     */
+    verify(stagingDir: string): {
+        valid: boolean;
+        mismatches: DefinitionEntry[];
+    };
+    /**
+     * Atomically renames each staged category directory into `targetRoot`
+     * (ADR-003). Removes an INTERIM symlink at the target category before
+     * writing (FA-002) — never writes through it. Cleans up the staging
+     * directory in a `finally`, whether swap succeeds or aborts partway
+     * (ADR-003 consequence).
+     */
+    swap(stagingDir: string): Promise<{
+        filesWritten: number;
+        filesUnchanged: number;
+    }>;
+    /**
+     * Recursively copies skill asset files that are NOT covered by any
+     * manifest entry (spec finding 2.4.2 / risk R-5) — e.g.
+     * `skills/<slug>/scripts/*.js`, never scanned by generate-manifest.ts,
+     * which only tracks a single `.md` level directly under each skill
+     * directory (no recursion into subdirectories).
+     */
+    copySkillAssets(stagingDir: string): Promise<string[]>;
+    private countChanges;
+    private stagingDirPath;
+    private swapCategory;
+    /**
+     * Removes whatever currently occupies `targetPath` before the atomic
+     * rename. An INTERIM symlink (dev-checkout, FA-002) is unlinked directly —
+     * never followed/recursed into — so its link target is left untouched.
+     */
+    private removeExistingTarget;
+    private walkRecursive;
+}
+//# sourceMappingURL=Materializer.d.ts.map

package/dist/install/Materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Materializer.d.ts","sourceRoot":"","sources":["../../src/install/Materializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMhF,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM;IAGrC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,KAAK,CAAC,eAAe,GAAG;YAAE,QAAQ,EAAE,kBAAkB,CAAA;SAAE,CAAC,CAAC;KACpE,CAAC;IAkBF;;;;OAIG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,eAAe,EAAE,CAAA;KAAE;IAoB7E;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBzF;;;;;;OAMG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoC5D,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,YAAY;IAsBpB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,aAAa;CAetB"}