@credibledata/cred-cli 0.0.103 → 0.0.105

package/dist/setup-core/mcpconfig.spec.js.map

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

package/dist/setup-core/packagemanifest.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKAGE_MANIFEST_FILE = void 0;
+exports.ensurePackageManifest = ensurePackageManifest;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const writefile_1 = require("./writefile");
+/**
+ * `publisher.json` — the file that makes a directory a *package* rather than a
+ * folder that happens to contain `.malloy` files.
+ *
+ * Without it the server loads the environment, finds the mounted directory, and
+ * then fails the package with *"Package manifest for … does not exist"* — which
+ * it reports as a load error while still binding both ports. So adopting an
+ * existing checkout (plan §5.4 source B) needs this written, and the plan did
+ * not say so: it assumed a directory a user points at is already a package,
+ * which is true for a clone of a published package and false for the loose
+ * folder of models that "use this directory" is mostly aimed at.
+ *
+ * Written only when absent. A package that already has a manifest keeps its own
+ * name, version, and description — those are the author's, not ours.
+ */
+exports.PACKAGE_MANIFEST_FILE = "publisher.json";
+function ensurePackageManifest(directory, fallbackName) {
+    const filePath = path_1.default.join(directory, exports.PACKAGE_MANIFEST_FILE);
+    try {
+        const parsed = JSON.parse(fs_1.default.readFileSync(filePath, "utf-8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const existingName = typeof parsed.name === "string" && parsed.name
+                ? parsed.name
+                : fallbackName;
+            return {
+                filePath,
+                action: "kept",
+                name: existingName,
+                missingVersion: typeof parsed.version !== "string" || !parsed.version,
+            };
+        }
+        // Present but not an object: fall through and replace it, since the
+        // server cannot load it either way.
+    }
+    catch (_a) {
+        // Absent or unparseable — write one.
+    }
+    // `version` is not optional in practice: `cred publish` sends it as the
+    // version id, and a manifest without one reached the server as
+    // `version undefined` and came back as a 500. `0.0.1` is the conventional
+    // first version; the author bumps it from there.
+    (0, writefile_1.writeFileAtomic)(filePath, `${JSON.stringify({ name: fallbackName, version: "0.0.1", description: "" }, null, 3)}\n`);
+    return { filePath, action: "created", name: fallbackName };
+}
+//# sourceMappingURL=packagemanifest.js.map

package/dist/setup-core/packagemanifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packagemanifest.js","sourceRoot":"","sources":["../../src/setup-core/packagemanifest.ts"],"names":[],"mappings":";;;;;;AAkCA,sDAwCC;AA1ED,4CAAoB;AACpB,gDAAwB;AACxB,2CAA8C;AAE9C;;;;;;;;;;;;;;GAcG;AAEU,QAAA,qBAAqB,GAAG,gBAAgB,CAAC;AActD,SAAgB,qBAAqB,CAClC,SAAiB,EACjB,YAAoB;IAEpB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,6BAAqB,CAAC,CAAC;IAE7D,IAAI,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,MAAM,YAAY,GACf,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI;gBAC3C,CAAC,CAAC,MAAM,CAAC,IAAI;gBACb,CAAC,CAAC,YAAY,CAAC;YACrB,OAAO;gBACJ,QAAQ;gBACR,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,YAAY;gBAClB,cAAc,EACX,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO;aAC1D,CAAC;QACL,CAAC;QACD,oEAAoE;QACpE,oCAAoC;IACvC,CAAC;IAAC,WAAM,CAAC;QACN,qCAAqC;IACxC,CAAC;IAED,wEAAwE;IACxE,+DAA+D;IAC/D,0EAA0E;IAC1E,iDAAiD;IACjD,IAAA,2BAAe,EACZ,QAAQ,EACR,GAAG,IAAI,CAAC,SAAS,CACd,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,EACzD,IAAI,EACJ,CAAC,CACH,IAAI,CACP,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAC9D,CAAC"}

package/dist/setup-core/ports.js

@@ -0,0 +1,182 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DERIVED_RANGE = exports.MIN_UI_PORT = exports.MAX_UI_PORT = exports.MCP_OFFSET = exports.DEFAULT_MCP_PORT = exports.DEFAULT_UI_PORT = void 0;
+exports.isPortFree = isPortFree;
+exports.pairIsFree = pairIsFree;
+exports.pairForUiPort = pairForUiPort;
+exports.suggestFreePair = suggestFreePair;
+exports.derivePairForDirectory = derivePairForDirectory;
+exports.derivedCandidates = derivedCandidates;
+exports.allocatePortPair = allocatePortPair;
+const crypto_1 = __importDefault(require("crypto"));
+const net_1 = __importDefault(require("net"));
+/**
+ * Choosing the port pair a local Publisher session listens on.
+ *
+ * ## Why not just ask for an ephemeral port
+ *
+ * The server accepts `--port 0 --mcp_port 0` and reports what it bound, which
+ * looks like the easy answer to two sessions colliding. It is the wrong answer,
+ * and the server itself says so: with an ephemeral MCP port it refuses to write
+ * `.mcp.json` at all, because "the port changes from run to run and a saved
+ * config would be wrong next boot".
+ *
+ * That reasoning applies to us. `.mcp.json` is a file an agent reads tomorrow,
+ * not just for the length of this session. A port that moves every run turns it
+ * into a file that silently points at nothing — the failure shows up as an agent
+ * whose tools have quietly stopped working, which is far worse than a port
+ * conflict at startup.
+ *
+ * So ports must be *stable for a directory*: the same working directory gets the
+ * same pair every run, while two different directories get different pairs.
+ */
+/** The ports a user recognises, and what we try first. */
+exports.DEFAULT_UI_PORT = 4000;
+exports.DEFAULT_MCP_PORT = 4040;
+/**
+ * Where derived pairs are drawn from: the IANA dynamic/private range, above the
+ * registered range so we are not squatting on a service someone might install.
+ */
+const DERIVED_RANGE_START = 49152;
+const DERIVED_RANGE_END = 65500;
+/** MCP sits this far above the UI port, mirroring the 4000/4040 default. */
+exports.MCP_OFFSET = 40;
+/** Step between pairs, so consecutive derived pairs cannot interleave. */
+const DERIVED_STRIDE = exports.MCP_OFFSET * 2;
+/**
+ * How many pairs the range holds. Derived once and shared by the hash and the
+ * fallback search, so they cannot disagree about where the range ends.
+ */
+const DERIVED_SLOTS = Math.floor((DERIVED_RANGE_END - exports.MCP_OFFSET - DERIVED_RANGE_START) / DERIVED_STRIDE);
+/** Is `port` free to bind on `host`? */
+function isPortFree(port, host = "127.0.0.1") {
+    return new Promise((resolve) => {
+        const probe = net_1.default.createServer();
+        probe.once("error", () => resolve(false));
+        probe.once("listening", () => probe.close(() => resolve(true)));
+        // exclusive: do not share the port with another handle in this process,
+        // which would report free a port we cannot actually own.
+        probe.listen({ port, host, exclusive: true });
+    });
+}
+function pairIsFree(pair_1) {
+    return __awaiter(this, arguments, void 0, function* (pair, host = "127.0.0.1") {
+        // Sequential rather than concurrent: the two probes must not race each other
+        // for the same port when uiPort and mcpPort happen to be adjacent.
+        return ((yield isPortFree(pair.uiPort, host)) &&
+            (yield isPortFree(pair.mcpPort, host)));
+    });
+}
+/** The pair `--port` names: the UI port, and MCP the usual distance above it. */
+function pairForUiPort(uiPort) {
+    return { uiPort, mcpPort: uiPort + exports.MCP_OFFSET };
+}
+/** The highest UI port `--port` accepts, so the MCP port above it is valid. */
+exports.MAX_UI_PORT = 65535 - exports.MCP_OFFSET;
+/** The lowest UI port `--port` accepts: above the privileged range. */
+exports.MIN_UI_PORT = 1024;
+/**
+ * A free pair to offer in a port-conflict error, so the fix names a number
+ * rather than telling the reader to go find one. The directory's own derived
+ * pairs, the ones `cred` would have picked itself; undefined when none in the
+ * first few is free.
+ */
+function suggestFreePair(directory_1) {
+    return __awaiter(this, arguments, void 0, function* (directory, host = "127.0.0.1") {
+        for (const candidate of derivedCandidates(directory, 8)) {
+            if (yield pairIsFree(candidate, host))
+                return candidate;
+        }
+        return undefined;
+    });
+}
+/**
+ * The pair a given directory prefers, derived from its path.
+ *
+ * Deterministic so the same directory lands on the same pair every run, and
+ * spread out so two directories are unlikely to collide. Exported for tests and
+ * for the caller that wants to report the pair before binding it.
+ */
+function derivePairForDirectory(directory) {
+    const digest = crypto_1.default.createHash("sha256").update(directory).digest();
+    const slot = digest.readUInt32BE(0) % DERIVED_SLOTS;
+    return pairForUiPort(DERIVED_RANGE_START + slot * DERIVED_STRIDE);
+}
+/**
+ * The pairs to try for a directory, in order, starting at its derived pair.
+ *
+ * Separate from the probing loop because it is the part with the arithmetic in
+ * it, and the part worth asserting directly: the sequence wraps to the bottom of
+ * the range rather than stopping at the top, so every directory gets the whole
+ * budget. The previous loop walked forward and broke at the range end, which
+ * gave a directory whose hash landed near 65500 one or two probes and then said
+ * "after 32 attempts".
+ *
+ * Never longer than the range holds, so `attempts` cannot make it repeat a pair
+ * and then report having tried more than it did.
+ */
+function derivedCandidates(directory, attempts) {
+    const base = derivePairForDirectory(directory);
+    const baseSlot = (base.uiPort - DERIVED_RANGE_START) / DERIVED_STRIDE;
+    const budget = Math.max(0, Math.min(attempts, DERIVED_SLOTS));
+    const pairs = [];
+    for (let step = 0; step < budget; step++) {
+        pairs.push(pairForUiPort(DERIVED_RANGE_START +
+            ((baseSlot + step) % DERIVED_SLOTS) * DERIVED_STRIDE));
+    }
+    return pairs;
+}
+/** The top and bottom of the derived range, for tests that assert the wrap. */
+exports.DERIVED_RANGE = {
+    start: DERIVED_RANGE_START,
+    end: DERIVED_RANGE_END,
+    stride: DERIVED_STRIDE,
+    slots: DERIVED_SLOTS,
+};
+/**
+ * Pick the pair this session should bind.
+ *
+ * Precedence, so a returning user keeps the URL they bookmarked:
+ *   1. `preferred` — the pair this directory used last, from `.credible/config.json`.
+ *   2. 4000/4040, the memorable default.
+ *   3. The pair derived from the directory path, then successive strides from it.
+ *
+ * @throws SetupError-worthy Error when nothing in the search window is free,
+ *         which in practice means something is very wrong rather than busy.
+ */
+function allocatePortPair(directory_1) {
+    return __awaiter(this, arguments, void 0, function* (directory, options = {}) {
+        var _a, _b, _c;
+        const host = (_a = options.host) !== null && _a !== void 0 ? _a : "127.0.0.1";
+        const attempts = (_b = options.attempts) !== null && _b !== void 0 ? _b : 32;
+        if (options.preferred && (yield pairIsFree(options.preferred, host))) {
+            return Object.assign(Object.assign({}, options.preferred), { derived: options.preferred.uiPort !== exports.DEFAULT_UI_PORT ||
+                    options.preferred.mcpPort !== exports.DEFAULT_MCP_PORT });
+        }
+        const fallback = { uiPort: exports.DEFAULT_UI_PORT, mcpPort: exports.DEFAULT_MCP_PORT };
+        if (yield pairIsFree(fallback, host)) {
+            return Object.assign(Object.assign({}, fallback), { derived: false });
+        }
+        const candidates = derivedCandidates(directory, attempts);
+        for (const candidate of candidates) {
+            if (yield pairIsFree(candidate, host)) {
+                return Object.assign(Object.assign({}, candidate), { derived: true });
+            }
+        }
+        throw new Error(`Could not find a free port pair for ${directory} after ${candidates.length} attempts. ` +
+            `Fix: stop whatever is holding ports around ${(_c = candidates[0]) === null || _c === void 0 ? void 0 : _c.uiPort}, or free ${exports.DEFAULT_UI_PORT} and ${exports.DEFAULT_MCP_PORT}.`);
+    });
+}
+//# sourceMappingURL=ports.js.map

package/dist/setup-core/ports.js.map

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

package/dist/setup-core/ports.spec.js

@@ -0,0 +1,173 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const net_1 = __importDefault(require("net"));
+const ports_1 = require("./ports");
+/** Hold a port for the duration of one test. */
+function occupy(port) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const server = net_1.default.createServer();
+        yield new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen({ port, host: "127.0.0.1", exclusive: true }, () => resolve());
+        });
+        return () => new Promise((resolve) => server.close(() => resolve()));
+    });
+}
+describe("ports", () => {
+    describe("derivePairForDirectory", () => {
+        it("is deterministic — the same directory always gets the same pair", () => {
+            // This is the whole point. An ephemeral port would make `.mcp.json`
+            // wrong on the next boot, which is why the server refuses to write one.
+            const first = (0, ports_1.derivePairForDirectory)("/home/me/models");
+            const second = (0, ports_1.derivePairForDirectory)("/home/me/models");
+            (0, chai_1.expect)(first).to.eql(second);
+        });
+        it("gives different directories different pairs", () => {
+            (0, chai_1.expect)((0, ports_1.derivePairForDirectory)("/home/me/a")).to.not.eql((0, ports_1.derivePairForDirectory)("/home/me/b"));
+        });
+        it("keeps the MCP port 40 above the UI port, as the defaults do", () => {
+            const pair = (0, ports_1.derivePairForDirectory)("/home/me/models");
+            (0, chai_1.expect)(pair.mcpPort - pair.uiPort).to.equal(40);
+        });
+        it("stays inside the dynamic/private range", () => {
+            for (const dir of ["/a", "/b", "/c/d/e", "/very/long/path/indeed"]) {
+                const pair = (0, ports_1.derivePairForDirectory)(dir);
+                (0, chai_1.expect)(pair.uiPort).to.be.at.least(49152);
+                (0, chai_1.expect)(pair.mcpPort).to.be.at.most(65535);
+            }
+        });
+    });
+    describe("derivedCandidates", () => {
+        it("starts at the directory's own pair", () => {
+            (0, chai_1.expect)((0, ports_1.derivedCandidates)("/some/dir", 3)[0]).to.eql((0, ports_1.derivePairForDirectory)("/some/dir"));
+        });
+        it("gives every directory the whole budget, wrapping at the range end", () => {
+            // A directory whose hash lands near the top used to get one or two
+            // probes and then report "after 32 attempts": the search walked forward
+            // and broke as soon as a candidate would leave the range. Found by
+            // searching for the directory whose base IS the last slot, so the
+            // regression is exercised rather than described.
+            const lastSlotBase = ports_1.DERIVED_RANGE.start +
+                (ports_1.DERIVED_RANGE.slots - 1) * ports_1.DERIVED_RANGE.stride;
+            let atTop;
+            for (let i = 0; i < 200000 && !atTop; i++) {
+                if ((0, ports_1.derivePairForDirectory)(`/d${i}`).uiPort === lastSlotBase) {
+                    atTop = `/d${i}`;
+                }
+            }
+            (0, chai_1.expect)(atTop, "no directory hashes to the last slot").to.be.a("string");
+            const candidates = (0, ports_1.derivedCandidates)(atTop, 32);
+            (0, chai_1.expect)(candidates).to.have.lengthOf(32);
+            (0, chai_1.expect)(candidates[0].uiPort).to.equal(lastSlotBase);
+            // The one after the last slot is the first, not a port outside the
+            // range and not the end of the search.
+            (0, chai_1.expect)(candidates[1].uiPort).to.equal(ports_1.DERIVED_RANGE.start);
+            for (const pair of candidates) {
+                (0, chai_1.expect)(pair.uiPort).to.be.at.least(ports_1.DERIVED_RANGE.start);
+                (0, chai_1.expect)(pair.mcpPort).to.be.at.most(ports_1.DERIVED_RANGE.end);
+            }
+            (0, chai_1.expect)(new Set(candidates.map((p) => p.uiPort)).size).to.equal(32);
+        });
+        it("never repeats a pair, however large the budget", () => {
+            // The error message counts what was tried, so a sequence longer than
+            // the range holds would claim probes it did not make.
+            const candidates = (0, ports_1.derivedCandidates)("/some/dir", ports_1.DERIVED_RANGE.slots + 50);
+            (0, chai_1.expect)(candidates).to.have.lengthOf(ports_1.DERIVED_RANGE.slots);
+            (0, chai_1.expect)(new Set(candidates.map((p) => p.uiPort)).size).to.equal(ports_1.DERIVED_RANGE.slots);
+        });
+    });
+    describe("isPortFree", () => {
+        it("reports an occupied port as not free", () => __awaiter(void 0, void 0, void 0, function* () {
+            const pair = (0, ports_1.derivePairForDirectory)("/isPortFree/test");
+            const release = yield occupy(pair.uiPort);
+            try {
+                (0, chai_1.expect)(yield (0, ports_1.isPortFree)(pair.uiPort)).to.equal(false);
+            }
+            finally {
+                yield release();
+            }
+            (0, chai_1.expect)(yield (0, ports_1.isPortFree)(pair.uiPort)).to.equal(true);
+        }));
+    });
+    describe("allocatePortPair", () => {
+        it("prefers the pair this directory used last, so the URL stays stable", () => __awaiter(void 0, void 0, void 0, function* () {
+            const preferred = { uiPort: 51000, mcpPort: 51040 };
+            const allocation = yield (0, ports_1.allocatePortPair)("/some/dir", { preferred });
+            (0, chai_1.expect)(allocation).to.eql(Object.assign(Object.assign({}, preferred), { derived: true }));
+        }));
+        it("falls back to the memorable default when there is no stored pair", () => __awaiter(void 0, void 0, void 0, function* () {
+            // Skip rather than fail if something on this machine already holds 4000
+            // — a false failure here would be about the developer's laptop, not the
+            // code.
+            if (!(yield (0, ports_1.isPortFree)(ports_1.DEFAULT_UI_PORT)) ||
+                !(yield (0, ports_1.isPortFree)(ports_1.DEFAULT_MCP_PORT))) {
+                return;
+            }
+            const allocation = yield (0, ports_1.allocatePortPair)("/some/dir");
+            (0, chai_1.expect)(allocation).to.eql({
+                uiPort: ports_1.DEFAULT_UI_PORT,
+                mcpPort: ports_1.DEFAULT_MCP_PORT,
+                derived: false,
+            });
+        }));
+        it("derives a pair when the stored one is taken", () => __awaiter(void 0, void 0, void 0, function* () {
+            const preferred = { uiPort: 51100, mcpPort: 51140 };
+            const release = yield occupy(preferred.uiPort);
+            try {
+                const allocation = yield (0, ports_1.allocatePortPair)("/derive/me", {
+                    preferred,
+                });
+                (0, chai_1.expect)(allocation.uiPort).to.not.equal(preferred.uiPort);
+            }
+            finally {
+                yield release();
+            }
+        }));
+        it("never returns a pair whose MCP port is taken, even if the UI port is free", () => __awaiter(void 0, void 0, void 0, function* () {
+            // Both listeners come from one process; a half-free pair fails at boot
+            // with EADDRINUSE after setup has already claimed success.
+            const preferred = { uiPort: 51200, mcpPort: 51240 };
+            const release = yield occupy(preferred.mcpPort);
+            try {
+                const allocation = yield (0, ports_1.allocatePortPair)("/half/free", {
+                    preferred,
+                });
+                (0, chai_1.expect)(allocation.mcpPort).to.not.equal(preferred.mcpPort);
+            }
+            finally {
+                yield release();
+            }
+        }));
+        it("gives up with an actionable message rather than searching forever", () => __awaiter(void 0, void 0, void 0, function* () {
+            let thrown;
+            try {
+                yield (0, ports_1.allocatePortPair)("/nowhere/free", {
+                    preferred: { uiPort: 1, mcpPort: 2 },
+                    attempts: 0,
+                    // Port 4000/4040 may be free on this machine, so force the
+                    // fallback path by pointing the probe at an unusable host.
+                    host: "203.0.113.1",
+                });
+            }
+            catch (error) {
+                thrown = error;
+            }
+            (0, chai_1.expect)(thrown === null || thrown === void 0 ? void 0 : thrown.message).to.contain("Could not find a free port pair");
+            (0, chai_1.expect)(thrown === null || thrown === void 0 ? void 0 : thrown.message).to.contain("Fix:");
+        }));
+    });
+});
+//# sourceMappingURL=ports.spec.js.map

package/dist/setup-core/ports.spec.js.map

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