@cleocode/core 2026.9.20 → 2026.9.21

package/dist/system/cleo-link.js

@@ -0,0 +1,246 @@
+/**
+ * `~/.cleo` link audit and repair — the keystone of global protocol delivery.
+ *
+ * The global hub `~/.agents/AGENTS.md` references
+ * `@~/.cleo/templates/CLEO-INJECTION.md`. That path is only real when
+ * `~/.cleo` links to the OS data directory (`getCleoHome()`): `~/.local/share/cleo`
+ * on Linux, `~/Library/Application Support/cleo` on macOS,
+ * `%LOCALAPPDATA%\cleo\Data` on Windows. A link carried between machines by
+ * dotfiles (a macOS `~/.cleo` pointing at `/home/<user>/.local/share/cleo`)
+ * dangles, and every harness loading the hub silently receives NO protocol —
+ * no error, just an unresolved reference (T12596).
+ *
+ * `existsSync` follows links, so a dangling link reads as ABSENT; creating a
+ * link over it then fails with `EEXIST`. Everything here classifies with
+ * `lstat` first for that reason.
+ *
+ * @task T12596
+ */
+import { randomUUID } from 'node:crypto';
+import { appendFileSync, existsSync, lstatSync, mkdirSync, readlinkSync, realpathSync, } from 'node:fs';
+import { rename, symlink, unlink } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, dirname, join, normalize, resolve, sep } from 'node:path';
+import { resolveLegacyCleoDir } from '@cleocode/paths';
+import { getCleoHome } from '../paths.js';
+/** The reference the global hub writes; identical on every OS. */
+export const CANONICAL_HUB_TEMPLATE_REF = '@~/.cleo/templates/CLEO-INJECTION.md';
+/** Thrown when creating the `~/.cleo` link fails; the previous entry has been restored. */
+export class CleoLinkRepairError extends Error {
+    receipt;
+    /** Stable error code. */
+    code = 'E_CLEO_LINK_REPAIR_FAILED';
+    /**
+     * @param message - What failed.
+     * @param receipt - The `rolled-back` receipt (also appended to the log).
+     */
+    constructor(message, receipt) {
+        super(message);
+        this.receipt = receipt;
+        this.name = 'CleoLinkRepairError';
+    }
+}
+/** Repair command printed in remedies and warnings. */
+export const CLEO_LINK_REPAIR_COMMAND = 'cleo doctor global-delivery --repair';
+function sameTarget(a, b) {
+    return normalize(a.replace(/^\\\\\?\\/, '')) === normalize(b);
+}
+/**
+ * True when mutating `linkPath` to point at `target` would bind a real,
+ * non-temporary `~/.cleo` to a temporary directory — the shape of a test run
+ * that overrides `CLEO_HOME` without overriding `HOME`. Refused so a test can
+ * never repoint the developer's own `~/.cleo` at a scratch directory.
+ */
+export function wouldBindRealHomeToTemp(linkPath, target) {
+    const roots = [...new Set([tmpdir(), '/tmp', '/private/tmp'].map(realPathOf))];
+    const inTmp = (p) => {
+        const real = realPathOf(p);
+        return roots.some((root) => real === root || real.startsWith(root + sep));
+    };
+    return inTmp(target) && !inTmp(linkPath);
+}
+/**
+ * `realpath` of `p`, or of its nearest existing ancestor with the missing tail
+ * re-appended. Paths being repaired often do not exist yet, and a prefix match
+ * on the unresolved form misses `/tmp` → `/private/tmp` and
+ * `os.tmpdir()` → `/private/var/folders/…` on macOS.
+ */
+function realPathOf(p) {
+    let current = resolve(p);
+    const tail = [];
+    for (;;) {
+        try {
+            return join(realpathSync(current), ...tail.reverse());
+        }
+        catch {
+            const parent = dirname(current);
+            if (parent === current)
+                return resolve(p);
+            tail.push(basename(current));
+            current = parent;
+        }
+    }
+}
+/**
+ * Classify `~/.cleo` without modifying anything.
+ *
+ * @param opts - Path overrides (tests).
+ * @returns The audit; `remedy` names the exact repair command when one applies.
+ * @task T12596
+ */
+export function auditCleoLink(opts = {}) {
+    const path = opts.path ?? resolveLegacyCleoDir();
+    const canonicalTarget = opts.canonicalTarget ?? getCleoHome();
+    const hubReferenceResolves = existsSync(join(path, 'templates', 'CLEO-INJECTION.md'));
+    const result = (state, target, repairable) => ({
+        path,
+        canonicalTarget,
+        state,
+        target,
+        hubReferenceResolves,
+        repairable,
+        remedy: state === 'canonical' || !repairable ? null : CLEO_LINK_REPAIR_COMMAND,
+    });
+    // CLEO_HOME set to ~/.cleo itself: the data dir IS the reference path.
+    if (sameTarget(path, canonicalTarget))
+        return result('canonical', null, false);
+    let stat;
+    try {
+        stat = lstatSync(path);
+    }
+    catch {
+        return result('absent', null, true);
+    }
+    if (stat.isSymbolicLink()) {
+        const target = readlinkSync(path);
+        const absolute = resolve(dirname(path), target);
+        if (sameTarget(target, canonicalTarget) || sameTarget(absolute, canonicalTarget)) {
+            return result('canonical', target, false);
+        }
+        return result(existsSync(absolute) ? 'foreign' : 'dangling', target, true);
+    }
+    if (stat.isDirectory())
+        return result('directory', null, true);
+    return result('other', null, false);
+}
+/**
+ * Bring `~/.cleo` to the canonical link and record a receipt.
+ *
+ * - `absent` → create the link.
+ * - `dangling` → replace the link (it reaches nothing, so nothing is lost;
+ *   the old target is kept in the receipt).
+ * - `foreign` / `directory` → move the entry to `~/.cleo.preserved-<ts>` (a
+ *   foreign link stays a link, keeping its target), then create the link.
+ * - `other`, or a real `~/.cleo` whose target would be a temp dir → refused.
+ *
+ * Receipts are appended to `<cleoHome>/audit/cleo-link-repairs.jsonl`.
+ *
+ * @param opts - `dryRun` reports the planned action without touching disk;
+ *   `states` limits which states may be repaired (bootstrap passes only the
+ *   lossless ones: `absent`, `dangling`).
+ * @returns The final audit plus the receipt.
+ * @task T12596
+ */
+export async function repairCleoLink(opts = {}) {
+    const before = auditCleoLink(opts);
+    const at = new Date().toISOString();
+    const receipt = {
+        receiptId: randomUUID(),
+        at,
+        action: 'none',
+        before: { state: before.state, target: before.target },
+        after: { state: before.state, target: before.target },
+        preservedAt: null,
+        reason: null,
+        receiptLog: null,
+        phase: 'planned',
+    };
+    const allowed = opts.states ?? ['absent', 'dangling', 'foreign', 'directory'];
+    if (before.state === 'canonical')
+        return { audit: before, receipt };
+    if (!before.repairable || !allowed.includes(before.state)) {
+        receipt.action = 'refused';
+        receipt.reason = before.repairable
+            ? `state "${before.state}" is not repaired automatically; run: ${CLEO_LINK_REPAIR_COMMAND}`
+            : `~/.cleo is a ${before.state} entry; move it aside manually`;
+        return { audit: before, receipt };
+    }
+    if (wouldBindRealHomeToTemp(before.path, before.canonicalTarget)) {
+        receipt.action = 'refused';
+        receipt.reason = `refusing to link ${before.path} to temporary directory ${before.canonicalTarget}`;
+        return { audit: before, receipt };
+    }
+    receipt.action = before.state === 'absent' ? 'created' : 'relinked';
+    if (before.state === 'foreign' || before.state === 'directory') {
+        receipt.preservedAt = `${before.path}.preserved-${at.replace(/[:.]/g, '-')}`;
+    }
+    if (opts.dryRun === true) {
+        receipt.after = { state: 'canonical', target: before.canonicalTarget };
+        return { audit: before, receipt };
+    }
+    mkdirSync(before.canonicalTarget, { recursive: true });
+    const logDir = join(before.canonicalTarget, 'audit');
+    mkdirSync(logDir, { recursive: true });
+    receipt.receiptLog = join(logDir, 'cleo-link-repairs.jsonl');
+    const log = (phase) => {
+        receipt.phase = phase;
+        appendFileSync(receipt.receiptLog, `${JSON.stringify(receipt)}\n`, 'utf8');
+    };
+    // Intent first: if anything below dies, the log still says where the old
+    // entry is (preservedAt) and what it pointed at (before.target).
+    log('intent');
+    let unlinkedDangling = false;
+    let preserved = false;
+    try {
+        if (before.state === 'dangling') {
+            await unlink(before.path);
+            unlinkedDangling = true;
+        }
+        if (receipt.preservedAt) {
+            await rename(before.path, receipt.preservedAt);
+            preserved = true;
+        }
+        const linkType = process.platform === 'win32' ? 'junction' : 'dir';
+        await symlink(before.canonicalTarget, before.path, linkType);
+    }
+    catch (err) {
+        // Roll back: put the previous entry exactly where it was.
+        if (preserved && receipt.preservedAt)
+            await rename(receipt.preservedAt, before.path);
+        if (unlinkedDangling && before.target !== null)
+            await symlink(before.target, before.path);
+        receipt.after = { state: before.state, target: before.target };
+        receipt.reason = err instanceof Error ? err.message : String(err);
+        log('rolled-back');
+        throw new CleoLinkRepairError(`Could not link ${before.path} → ${before.canonicalTarget}: ${receipt.reason}. ` +
+            'The previous entry was restored.', receipt);
+    }
+    const after = auditCleoLink(opts);
+    receipt.after = { state: after.state, target: after.target };
+    log('completed');
+    return { audit: after, receipt };
+}
+/**
+ * Content for the global hub's CAAMP block.
+ *
+ * Normally the one-line canonical reference. When `~/.cleo/templates` does not
+ * resolve (a link the bootstrap could not repair), a reference would deliver
+ * nothing — so the protocol text is embedded instead, with a marker naming
+ * the repair. Once the link is repaired the next bootstrap writes the
+ * reference again.
+ *
+ * @param templateContent - Installed `CLEO-INJECTION.md` text (embedded on fallback).
+ * @param opts - Path overrides (tests).
+ * @returns The block content and which mode was chosen.
+ * @task T12596
+ */
+export function resolveGlobalHubContent(templateContent, opts = {}) {
+    const audit = auditCleoLink(opts);
+    if (audit.hubReferenceResolves || templateContent === null) {
+        return { content: CANONICAL_HUB_TEMPLATE_REF, mode: 'reference', audit };
+    }
+    const note = `<!-- CLEO protocol embedded: ${CANONICAL_HUB_TEMPLATE_REF.slice(1)} does not resolve ` +
+        `(~/.cleo is ${audit.state}). Run \`${CLEO_LINK_REPAIR_COMMAND}\`. -->`;
+    return { content: `${note}\n${templateContent.trim()}`, mode: 'embedded', audit };
+}
+//# sourceMappingURL=cleo-link.js.map

package/dist/system/cleo-link.js.map

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

package/dist/system/dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/system/dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACf,MAAM,qBAAqB,CAAC;AA8X7B;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyClF;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA8BtE;AAGD,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/system/dependencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACf,MAAM,qBAAqB,CAAC;AA2X7B;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyClF;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA8BtE;AAGD,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC"}

package/dist/system/dependencies.js

@@ -17,8 +17,7 @@ import { execFileSync } from 'node:child_process';
 import { createRequire } from 'node:module';
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { evaluateNodeVersion } from '@cleocode/paths';
-import { PLATFORM } from '../platform.js';
+import { evaluateNodeVersion, findOnPath } from '@cleocode/paths';
 /** ESM-safe require function for loading native addons. */
 const _require = createRequire(import.meta.url);
 /** Directory of this compiled file (packages/core/dist/system/). */
@@ -49,12 +48,10 @@ function tryExec(cmd, args, timeoutMs = 3000) {
 /**
  * Resolve the absolute path of a command on PATH, or `null` if absent.
  *
- * Uses `which` on POSIX and `where` on Windows, matching `commandExists()`
- * in `platform.ts`.
+ * Delegates to the shared PATH/PATHEXT-aware {@link findOnPath} (T12605).
  */
 function which(cmd) {
-    const tool = PLATFORM === 'windows' ? 'where' : 'which';
-    return tryExec(tool, [cmd]);
+    return findOnPath(cmd);
 }
 // ============================================================================
 // Dependency registry — static specifications

package/dist/system/dependencies.js.map

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

package/dist/system/global-delivery.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Global delivery audit/repair — does every harness on this machine actually
+ * load CLEO? One surface for the three things that silently break it:
+ *
+ * 1. `~/.cleo` — must link to the platform data dir ({@link auditCleoLink}).
+ * 2. The global hub `~/.agents/AGENTS.md` — its reference must resolve, or it
+ *    must carry the protocol embedded.
+ * 3. Skill installs in every harness skills dir — each CLEO skill entry must
+ *    resolve. Links written through `~/.cleo/skills/<name>` (the pre-T12598
+ *    install target) break all at once when `~/.cleo` dangles: measured
+ *    2026-09-28 on macOS, 96 dangling `ct-*` links across six harness dirs.
+ *
+ * Repairs relink skill entries to the physical `<cleoHome>/skills/<name>`
+ * (symlink, verified; copy when a link cannot be made or does not resolve)
+ * and append one receipt per run to `<cleoHome>/audit/global-delivery.jsonl`.
+ *
+ * @task T12596
+ * @task T12598
+ */
+import * as path from 'node:path';
+import { type CleoLinkAudit, type CleoLinkOptions, type CleoLinkRepairReceipt } from './cleo-link.js';
+/** Repair command printed in remedies. */
+export declare const GLOBAL_DELIVERY_REPAIR_COMMAND = "cleo doctor global-delivery --repair";
+/**
+ * Skill dirs scanned in addition to the provider registry, relative to the
+ * home directory, so their stale links are reported and repaired rather than
+ * left dangling forever:
+ * - `.kimi-code/skills` — written by an older release; the registry no
+ *   longer lists it.
+ * - `.config/opencode/skills` — the registry resolves OpenCode's dir through
+ *   `XDG_CONFIG_HOME`, so when that is set elsewhere (or the registry entry
+ *   changes) the home-relative dir that older installs populated would be
+ *   missed. Measured on macOS 2026-09-28: 16 `ct-*` links there, all routed
+ *   through `~/.cleo`.
+ */
+export declare const LEGACY_HARNESS_SKILL_DIRS: readonly string[];
+/**
+ * State of one harness skill entry:
+ * - `ok` — resolves directly to the canonical skill (or is a real copy).
+ * - `dangling` — a link that resolves to nothing; repairable when the
+ *   canonical skill exists.
+ * - `legacy-route` — resolves today but only THROUGH `~/.cleo`, so it breaks
+ *   whenever that link does; relinked to the physical path on repair.
+ * - `orphan` — dangling, and no canonical skill of that name exists.
+ */
+export type SkillInstallState = 'ok' | 'dangling' | 'legacy-route' | 'orphan';
+/** One CLEO-managed entry in a harness skills directory. */
+export interface SkillInstallEntry {
+    /** Harness skills directory. */
+    dir: string;
+    /** Entry name (skill name). */
+    name: string;
+    /** Absolute entry path. */
+    path: string;
+    /** Link target as written, or null for a real directory. */
+    target: string | null;
+    /** Classified state. */
+    state: SkillInstallState;
+}
+/** Hub state. */
+export interface HubAudit {
+    /** `~/.agents/AGENTS.md` path. */
+    path: string;
+    /**
+     * - `reference` — carries the canonical reference and it resolves.
+     * - `embedded` — carries the protocol text inline (T12596 fallback).
+     * - `unresolved` — carries the reference but it resolves to nothing.
+     * - `missing` — no hub file, or no CLEO reference in it.
+     */
+    state: 'reference' | 'embedded' | 'unresolved' | 'missing';
+}
+/** Full audit. */
+export interface GlobalDeliveryAudit {
+    /** `~/.cleo` link state. */
+    link: CleoLinkAudit;
+    /** Hub state. */
+    hub: HubAudit;
+    /** Canonical skills root the entries should resolve to. */
+    skillsRoot: string;
+    /** Every CLEO-managed skill entry found. */
+    skills: SkillInstallEntry[];
+    /** Per-state counts over {@link GlobalDeliveryAudit.skills}. */
+    skillCounts: Record<SkillInstallState, number>;
+    /** True when the link, hub and every skill entry resolve. */
+    healthy: boolean;
+    /** Exact repair command, or null when healthy. */
+    remedy: string | null;
+}
+/** Per-entry repair outcome recorded in the receipt. */
+export interface SkillRepairOutcome {
+    /** Entry path. */
+    path: string;
+    /** State before. */
+    before: SkillInstallState;
+    /** Previous link target. */
+    previousTarget: string | null;
+    /** What was written: a verified symlink, a copy, or nothing. */
+    action: 'symlink' | 'copy' | 'skipped';
+    /** Why the entry was skipped, when it was. */
+    reason: string | null;
+}
+/** Receipt for one {@link repairGlobalDelivery} run. */
+export interface GlobalDeliveryReceipt {
+    /** Unique receipt id. */
+    receiptId: string;
+    /** ISO timestamp. */
+    at: string;
+    /** Dry run: nothing was written. */
+    dryRun: boolean;
+    /**
+     * `intent` is appended BEFORE the first skill entry changes (it carries
+     * {@link GlobalDeliveryReceipt.planned}); the run then appends `completed`
+     * or `failed`. `planned` receipts (dry run) are returned, never written.
+     */
+    phase: 'planned' | 'intent' | 'completed' | 'failed';
+    /** Every entry the run will change, with its previous link target. */
+    planned: Array<{
+        path: string;
+        previousTarget: string | null;
+        state: SkillInstallState;
+    }>;
+    /** The error that stopped the run, when `phase === 'failed'`. */
+    error: string | null;
+    /** The `~/.cleo` link repair receipt. */
+    link: CleoLinkRepairReceipt;
+    /** Skill entry outcomes. */
+    skills: SkillRepairOutcome[];
+    /** JSONL file the receipt was appended to, or null on a dry run. */
+    receiptLog: string | null;
+}
+/** Injection points (tests). */
+export interface GlobalDeliveryOptions extends CleoLinkOptions {
+    /** Home directory. Defaults to `homedir()`. */
+    home?: string;
+    /** Hub path. Defaults to `<agentsHome>/AGENTS.md`. */
+    hubPath?: string;
+    /** Canonical skills root. Defaults to {@link resolveSkillsRoot}. */
+    skillsRoot?: string;
+    /** Harness skill dirs. Defaults to every provider's global dirs + legacy dirs. */
+    skillDirs?: string[];
+    /** Receipt log dir. Defaults to `<cleoHome>/audit`. */
+    auditDir?: string;
+}
+/**
+ * Every harness skills directory the provider registry knows (global scope),
+ * plus {@link LEGACY_HARNESS_SKILL_DIRS}. Only directories that exist.
+ *
+ * @param home - Home directory.
+ * @returns Unique absolute directories.
+ */
+export declare function discoverHarnessSkillDirs(home?: string): Promise<string[]>;
+/** The subset of `node:path` the classifier needs (posix or win32). */
+export type PathApi = Pick<typeof path, 'resolve' | 'sep'>;
+/**
+ * True when a link target routes through `~/.cleo` — the pre-T12598 install
+ * target that breaks every link at once when `~/.cleo` dangles.
+ *
+ * Pure over `pathApi` so macOS, Linux and Windows path shapes can be checked
+ * on any host.
+ *
+ * @param target - Link target as written (relative or absolute).
+ * @param linkDir - Directory holding the link.
+ * @param cleoLink - Absolute `~/.cleo` path.
+ * @param pathApi - `path.posix` or `path.win32`; defaults to the host.
+ */
+export declare function routesThroughCleoLink(target: string, linkDir: string, cleoLink: string, pathApi?: PathApi): boolean;
+/**
+ * Classify every CLEO-managed entry in the given harness skill dirs.
+ *
+ * An entry is CLEO-managed when a canonical skill of the same name exists in
+ * `skillsRoot`, or when it is a link routed through `~/.cleo` or into
+ * `skillsRoot`. Links owned by other tools (e.g. `~/.claude/skills/x ->
+ * ../../.agents/skills/x`) are never reported or touched.
+ *
+ * @param dirs - Harness skills directories.
+ * @param skillsRoot - Canonical skills root.
+ * @param cleoLink - Absolute `~/.cleo` path.
+ * @returns Managed entries.
+ */
+export declare function auditSkillInstalls(dirs: readonly string[], skillsRoot: string, cleoLink: string): SkillInstallEntry[];
+/**
+ * Audit `~/.cleo`, the global hub and every harness skill install.
+ *
+ * @param opts - Injection points (tests).
+ * @returns The audit, with the exact remedy when unhealthy.
+ * @task T12598
+ */
+export declare function auditGlobalDelivery(opts?: GlobalDeliveryOptions): Promise<GlobalDeliveryAudit>;
+/**
+ * Repair everything {@link auditGlobalDelivery} reports: relink `~/.cleo`,
+ * then relink every `dangling` / `legacy-route` skill entry to the physical
+ * canonical path. `orphan` entries are reported, never deleted. The hub needs
+ * no rewrite once `~/.cleo` resolves; `cleo install-global` refreshes it.
+ *
+ * @param opts - `dryRun` plans without writing; plus injection points.
+ * @returns The post-repair audit and the receipt.
+ * @task T12598
+ */
+export declare function repairGlobalDelivery(opts?: GlobalDeliveryOptions & {
+    dryRun?: boolean;
+}): Promise<{
+    audit: GlobalDeliveryAudit;
+    receipt: GlobalDeliveryReceipt;
+}>;
+//# sourceMappingURL=global-delivery.d.ts.map

package/dist/system/global-delivery.d.ts.map

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