dorfl 0.1.1 → 0.2.0

package/dist/apply-stuck-action.js.map

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

package/dist/brand.d.ts

@@ -48,8 +48,19 @@ export interface Brand {
     readonly base: string;
     /** The shared env-var prefix: `constantCase(base) + '_'` ⇒ `DORFL_`. */
     readonly envPrefix: string;
-    /** The per-repo config filename: `.{paramCase(base)}.json` ⇒ `.dorfl.json`. */
+    /**
+     * The per-repo config filename PREFERRED + written by default:
+     * `{paramCase(base)}.json` ⇒ `dorfl.json` (a plain, non-dotfile name, so it is
+     * visible in a normal `ls` and reads like other tool configs).
+     */
     readonly repoConfigFilename: string;
+    /**
+     * The LEGACY per-repo config filename still honoured on READ for backward
+     * compatibility: `.{paramCase(base)}.json` ⇒ `.dorfl.json` (the original
+     * dotfile form). Reads prefer {@link repoConfigFilename} and fall back to this;
+     * writes/`setup` use {@link repoConfigFilename}.
+     */
+    readonly repoConfigFilenameLegacy: string;
     /** The workspaces-dir name (a dotfile dir): `.{paramCase(base)}` ⇒ `.dorfl`. */
     readonly workdirName: string;
     /** The per-job record filename: `.{paramCase(base)}-job.json` ⇒ `.dorfl-job.json`. */

package/dist/brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;GAGG;AACH,eAAO,MAAM,IAAI,UAAU,CAAC;AAqB5B,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACrB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAW/C;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,KAAyB,CAAC"}
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;GAGG;AACH,eAAO,MAAM,IAAI,UAAU,CAAC;AAqB5B,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACrB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAY/C;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,EAAE,KAAyB,CAAC"}

package/dist/brand.js

@@ -68,7 +68,8 @@ export function deriveBrand(base) {
     return {
         base,
         envPrefix: constantCase(base) + '_',
-        repoConfigFilename: `.${param}.json`,
+        repoConfigFilename: `${param}.json`,
+        repoConfigFilenameLegacy: `.${param}.json`,
         workdirName: `.${param}`,
         jobRecordFilename: `.${param}-job.json`,
         configDirName: param,

package/dist/brand.js.map

@@ -1 +1 @@
-{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC;AAE5B,iFAAiF;AACjF,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,qBAAqB;AAErB,+DAA+D;AAC/D,SAAS,KAAK,CAAC,KAAa;IAC3B,OAAO,KAAK;SACV,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,kCAAkC;SACzE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,mCAAmC;SAC7D,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,KAAK,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAuBD,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACN,IAAI;QACJ,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,GAAG;QACnC,kBAAkB,EAAE,IAAI,KAAK,OAAO;QACpC,WAAW,EAAE,IAAI,KAAK,EAAE;QACxB,iBAAiB,EAAE,IAAI,KAAK,WAAW;QACvC,aAAa,EAAE,KAAK;QACpB,GAAG,EAAE,KAAK;KACV,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAU,WAAW,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC;AAE5B,iFAAiF;AACjF,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,qBAAqB;AAErB,+DAA+D;AAC/D,SAAS,KAAK,CAAC,KAAa;IAC3B,OAAO,KAAK;SACV,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,kCAAkC;SACzE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,mCAAmC;SAC7D,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,KAAK,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC;AAkCD,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACN,IAAI;QACJ,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,GAAG;QACnC,kBAAkB,EAAE,GAAG,KAAK,OAAO;QACnC,wBAAwB,EAAE,IAAI,KAAK,OAAO;QAC1C,WAAW,EAAE,IAAI,KAAK,EAAE;QACxB,iBAAiB,EAAE,IAAI,KAAK,WAAW;QACvC,aAAa,EAAE,KAAK;QACpB,GAAG,EAAE,KAAK;KACV,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAU,WAAW,CAAC,IAAI,CAAC,CAAC"}

package/dist/buildable-body.d.ts

@@ -1,7 +1,7 @@
 /**
- * The SINGLE owner of the buildable-task (and PRD-body) markdown SECTION SCHEMA
- * (prd `centralize-buildable-task-renderer-shared-by-intake-and-promotion`, US
- * #1/#4/#7). dorfl has TWO independent producers of a buildable task/PRD body —
+ * The SINGLE owner of the buildable-task (and SPEC-body) markdown SECTION SCHEMA
+ * (spec `centralize-buildable-task-renderer-shared-by-intake-and-promotion`, US
+ * #1/#4/#7). dorfl has TWO independent producers of a buildable task/SPEC body —
  * `intake.ts` (`renderBacklogTask`/`renderSpec`, a wrapper+fallback) and
  * `triage-persist.ts` (`buildPromotedBody`, a structured renderer) — and until
  * this module they each HAND-ROLLED the `## What to build` / `## Acceptance
@@ -28,14 +28,14 @@
  *     mechanism prose, and NO `## Acceptance criteria`. Reproduced by omitting
  *     `acceptanceCriteria` and passing the open-questions block + the seed prose.
  *
- * Symmetrically, {@link renderSpecBody} owns the FULL PRD section schema both PRD
- * producers need: intake's default PRD scaffold is `## Problem Statement` +
+ * Symmetrically, {@link renderSpecBody} owns the FULL SPEC section schema both SPEC
+ * producers need: intake's default SPEC scaffold is `## Problem Statement` +
  * `## Solution` + `## User Stories` (reproduced by passing all three), while
- * promotion's structured PRD body is `## Problem Statement` + optional
+ * promotion's structured SPEC body is `## Problem Statement` + optional
  * `## Open questions` (reproduced by omitting `solution`/`userStories`). Each
  * optional section is emitted only when its input is non-empty.
  *
- * `## Prompt` is TASK-ONLY: a PRD is not dispatched by `do`/`run`, so a PRD body
+ * `## Prompt` is TASK-ONLY: a SPEC is not dispatched by `do`/`run`, so a SPEC body
  * carries none (the symmetric reason the task body MUST carry one — the consumer
  * `extractPromptSection`/`resolveTask` in `prompt.ts` throws "has no '## Prompt'
  * section" at dispatch time without it). {@link renderTaskBody} always emits a
@@ -98,27 +98,27 @@ export interface RenderSpecBodyInput {
     problemStatement: string;
     /**
      * The `## Solution` prose (markdown). OMIT it (or pass empty) to drop the
-     * section — promotion's structured PRD body carries no Solution section, intake's
-     * default PRD scaffold does.
+     * section — promotion's structured SPEC body carries no Solution section, intake's
+     * default SPEC scaffold does.
      */
     solution?: string;
     /**
      * The `## User Stories` block (markdown, e.g. a numbered list). OMIT it (or pass
-     * empty) to drop the section — promotion's structured PRD body carries no User
-     * Stories section, intake's default PRD scaffold does.
+     * empty) to drop the section — promotion's structured SPEC body carries no User
+     * Stories section, intake's default SPEC scaffold does.
      */
     userStories?: string;
     /**
      * The `## Open questions` block (markdown). OMIT it (or pass empty) to drop the
-     * section. A PRD carries NO `## Prompt` (it is not dispatched).
+     * section. A SPEC carries NO `## Prompt` (it is not dispatched).
      */
     openQuestions?: string;
 }
 /**
- * Render a PRD body (the markdown AFTER the frontmatter fence). Emits, in the
+ * Render a SPEC body (the markdown AFTER the frontmatter fence). Emits, in the
  * canonical order, `## Problem Statement`, then `## Solution`, `## User Stories`,
  * and `## Open questions` (each only when its input is given), and NEVER a
- * `## Prompt` — a PRD is a north-star doc, not a dispatchable task. The symmetric twin of
+ * `## Prompt` — a SPEC is a north-star doc, not a dispatchable task. The symmetric twin of
  * {@link renderTaskBody}, owning the FULL SPEC section schema both producers need
  * (intake's default scaffold supplies Problem Statement + Solution + User Stories;
  * promotion's structured body supplies Problem Statement + optional Open

package/dist/buildable-body.js

@@ -1,7 +1,7 @@
 /**
- * The SINGLE owner of the buildable-task (and PRD-body) markdown SECTION SCHEMA
- * (prd `centralize-buildable-task-renderer-shared-by-intake-and-promotion`, US
- * #1/#4/#7). dorfl has TWO independent producers of a buildable task/PRD body —
+ * The SINGLE owner of the buildable-task (and SPEC-body) markdown SECTION SCHEMA
+ * (spec `centralize-buildable-task-renderer-shared-by-intake-and-promotion`, US
+ * #1/#4/#7). dorfl has TWO independent producers of a buildable task/SPEC body —
  * `intake.ts` (`renderBacklogTask`/`renderSpec`, a wrapper+fallback) and
  * `triage-persist.ts` (`buildPromotedBody`, a structured renderer) — and until
  * this module they each HAND-ROLLED the `## What to build` / `## Acceptance
@@ -28,14 +28,14 @@
  *     mechanism prose, and NO `## Acceptance criteria`. Reproduced by omitting
  *     `acceptanceCriteria` and passing the open-questions block + the seed prose.
  *
- * Symmetrically, {@link renderSpecBody} owns the FULL PRD section schema both PRD
- * producers need: intake's default PRD scaffold is `## Problem Statement` +
+ * Symmetrically, {@link renderSpecBody} owns the FULL SPEC section schema both SPEC
+ * producers need: intake's default SPEC scaffold is `## Problem Statement` +
  * `## Solution` + `## User Stories` (reproduced by passing all three), while
- * promotion's structured PRD body is `## Problem Statement` + optional
+ * promotion's structured SPEC body is `## Problem Statement` + optional
  * `## Open questions` (reproduced by omitting `solution`/`userStories`). Each
  * optional section is emitted only when its input is non-empty.
  *
- * `## Prompt` is TASK-ONLY: a PRD is not dispatched by `do`/`run`, so a PRD body
+ * `## Prompt` is TASK-ONLY: a SPEC is not dispatched by `do`/`run`, so a SPEC body
  * carries none (the symmetric reason the task body MUST carry one — the consumer
  * `extractPromptSection`/`resolveTask` in `prompt.ts` throws "has no '## Prompt'
  * section" at dispatch time without it). {@link renderTaskBody} always emits a
@@ -92,10 +92,10 @@ export function renderTaskBody(input) {
     return lines.join('\n');
 }
 /**
- * Render a PRD body (the markdown AFTER the frontmatter fence). Emits, in the
+ * Render a SPEC body (the markdown AFTER the frontmatter fence). Emits, in the
  * canonical order, `## Problem Statement`, then `## Solution`, `## User Stories`,
  * and `## Open questions` (each only when its input is given), and NEVER a
- * `## Prompt` — a PRD is a north-star doc, not a dispatchable task. The symmetric twin of
+ * `## Prompt` — a SPEC is a north-star doc, not a dispatchable task. The symmetric twin of
  * {@link renderTaskBody}, owning the FULL SPEC section schema both producers need
  * (intake's default scaffold supplies Problem Statement + Solution + User Stories;
  * promotion's structured body supplies Problem Statement + optional Open

package/dist/claim-cas.d.ts

@@ -3,7 +3,7 @@
  * `scripts/CLAIM-PROTOCOL.md`. This is the first-class `dorfl claim`
  * command (ADR §9: dorfl is the PRIMARY implementation of the claim
  * protocol; `scripts/claim.sh` is retained as the portable, zero-dependency
- * bootstrap / reference). The lock-substrate cut-over (prd
+ * bootstrap / reference). The lock-substrate cut-over (spec
  * `ledger-status-per-item-lock-refs`) has since diverged it from `claim.sh`'s
  * body-move semantics — see the lock note below — but the exit codes are the same.
  *
@@ -19,7 +19,7 @@
  *   3  (legacy) push contention — no longer reachable: the per-item lock never
  *      falsely contends, so there is no retry budget to exhaust
  *
- * UNIFIED PER-ITEM LOCK (prd `ledger-status-per-item-lock-refs` US #1/#15/#16,
+ * UNIFIED PER-ITEM LOCK (spec `ledger-status-per-item-lock-refs` US #1/#15/#16,
  * ADR `ledger-status-on-per-item-lock-refs`): a claim ACQUIRES the item's
  * per-item lock (`action: implement`) via the lock module and writes NOTHING to
  * `main` — the body STAYS at `work/backlog/<slug>.md`. The claimable predicate is
@@ -71,7 +71,7 @@ export interface ClaimCasOptions {
      */
     override?: boolean;
     /**
-     * `--allow-backlog` (prd
+     * `--allow-backlog` (spec
      * `do-allow-backlog-drive-staged-tasks-without-promotion`): WIDEN the claimable
      * predicate to ALSO accept a `tasks/backlog/`-resident body (staging), so a
      * human can drive a staged task in place WITHOUT promoting it to the pool. The

package/dist/claim-cas.js

@@ -174,7 +174,7 @@ async function runClaim(options, note) {
                 'claiming it. NO lock was acquired.');
         }
     }
-    // UNIFIED PER-ITEM LOCK — the WHOLE of the claim now (prd
+    // UNIFIED PER-ITEM LOCK — the WHOLE of the claim now (spec
     // `ledger-status-per-item-lock-refs` US #1/#15/#16; ADR
     // `ledger-status-on-per-item-lock-refs`). The interim dual-write is GONE: claim
     // acquires the item's per-item lock (`action: implement`) and writes NOTHING to

package/dist/claim-cas.js.map

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

package/dist/cli-spinner.d.ts

@@ -1,6 +1,6 @@
 /**
  * A small, isolated terminal-spinner helper for the standalone
- * `dorfl claim <slug>` CLI command (prd/task `claim-cas-spinner`).
+ * `dorfl claim <slug>` CLI command (spec/task `claim-cas-spinner`).
  *
  * The push the claim CAS performs can take a few seconds (network +
  * arbiter round-trip), so the terminal looked frozen. This helper wraps

package/dist/cli-spinner.js

@@ -1,6 +1,6 @@
 /**
  * A small, isolated terminal-spinner helper for the standalone
- * `dorfl claim <slug>` CLI command (prd/task `claim-cas-spinner`).
+ * `dorfl claim <slug>` CLI command (spec/task `claim-cas-spinner`).
  *
  * The push the claim CAS performs can take a few seconds (network +
  * arbiter round-trip), so the terminal looked frozen. This helper wraps

package/dist/cli.d.ts

@@ -1,6 +1,16 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { type InstallSkillsResult } from './install-skills.js';
 export declare function buildProgram(): Command;
+/**
+ * Human-readable report for `dorfl skills add`. Prints the SOURCE the skills
+ * were read from, each canonical install path (one per skill), and each
+ * non-universal harness placement (symlink | copy) with its absolute path.
+ * Universal harnesses read from the canonical dir directly and need no line.
+ * Output goes to stdout; the shape is stable enough for a human to audit "what
+ * landed where" but is NOT a machine contract (no JSON mode in this pass).
+ */
+export declare function formatSkillsAddReport(result: InstallSkillsResult, local: boolean): string;
 /**
  * Run the CLI: build the program and parse argv. Split from {@link buildProgram}
  * so tests can build + introspect/parse the program WITHOUT triggering a real

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAC,OAAO,EAAS,MAAM,WAAW,CAAC;AAqoC1C,wBAAgB,YAAY,IAAI,OAAO,CA8gGtC;AA+FD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAC,OAAO,EAAS,MAAM,WAAW,CAAC;AAyJ1C,OAAO,EAAgB,KAAK,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAw/B5E,wBAAgB,YAAY,IAAI,OAAO,CA4xGtC;AAaD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,OAAO,GACZ,MAAM,CAyBR;AA+FD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}